Процесс выпуска и обновления

После обновления npm-пакета

Следующая обычная команда Engram незаметно один раз согласует уже инициализированные корни workspace/global с новой версией. Это охватывает изменения схемы памяти от выпуска к выпуску, начиная с v0.0.8: при обнаружении устаревших метаданных обновляются сгенерированная справка, индексы памяти, графовые файлы и подходящие векторные sidecar-файлы.

Проверка при запуске намеренно дешёвая после первого раза: когда текущая версия уже записана, она читает лишь небольшие маркеры конфигурации. Она не запускается из npm postinstall, не создаёт новых корней памяти и не заменяет файлы, написанные человеком. Используйте --no-auto-upgrade или ENGRAM_NO_AUTO_UPGRADE=1, чтобы пропустить её для команды.

Явное обновление

engram upgrade
engram upgrade --plan
engram upgrade --latest

engram upgrade обновляет сгенерированную справку рабочего пространства, индексы памяти, графовые файлы, подходящие векторные sidecar-файлы, существующие файлы skillset рабочего пространства, сгенерированные Engram, и зарегистрированные глобальные skillset, сохраняя файлы, написанные человеком.

engram upgrade --latest действует сильнее: он перезаписывает текущие артефакты связанных агентов, управляемые Engram, для уже связанных агентов рабочего пространства и зарегистрированных глобальных установок, включая файлы инструкций, правила, конфигурацию MCP/плагинов и управляемые хуки, чтобы связанные хосты сразу получили новый результат пакета.

Используйте --force только тогда, когда вы намеренно заменяете сгенерированные адаптерные файлы Engram.

Согласование конфигурации с учётом владения

Инвентарь latest-обновления дедуплицирует зарегистрированные интеграции по физическому файлу. Если несколько хостов используют одно и то же руководство Engram, Engram рендерит и записывает этот файл один раз, а не позволяет строкам разных хостов перезаписывать друг друга.

Когда ручные правки делают известный артефакт Engram небезопасным для обычной замены, Entry может предложить Force upgrade только при доказуемом владении. Для помеченного блока Engram принуждение заменяет только этот блок и сохраняет окружающий текст пользователя. Для зарегистрированного/сгенерированного файла Engram принуждение может заменить весь сгенерированный файл. Неизвестное владение никогда не допускает принуждения, а пакетное подтверждение никогда не выполняет принудительных действий.

Успешное применение проверяется повторным сканированием после записи. Откатённые или неудачные транзакции и артефакты, которые должны были обновиться, но не пришли к current, сообщаются как ошибки; для таких случаев Entry не показывает уведомление об успешном обновлении.

Профили рендера skillset

Для хостов с поддержкой runtime Engram устанавливает небольшие начальные инструкции вместо полного протокола. Хуки предоставляют маршрутизированный контекст задачи, инструменты MCP — поведение загрузки/поиска/предложений, а одно сопутствующее руководство содержит подробный рабочий процесс; slash-адаптеры и Agent Skills служат короткими указателями на него. Резервные цели без надёжной инъекции контекста во время выполнения по-прежнему получают компактные ручные инструкции.

Резервный режим конфигурационной БД SQLite

Конфигурационная БД SQLite в Engram — это оптимизация для управления рабочими пространствами/профилями. Если БД не удаётся открыть или инициализировать, обычные команды чтения/записи переходят на JSON-снимки конфигурации. Команды, специфичные для БД, сообщают, что SQLite недоступна, а не блокируют обычное использование памяти.

Что меняется в выпуске host-native

После engram upgrade --latest (или engram link <host>) на существующей установке:

• Hooks: Claude и Codex получают SubagentStart, Gemini получает AfterTool, а новые записи хуков учитывают ограничение размера payload каждого хоста. Claude теряет управляемую запись PreToolUse и получает InstructionsLoaded плюс сгенерированные файлы правил .claude/rules/engram/; чтобы сохранить прежнее поведение, сначала выполните engram config set hooks.path_rules hook && engram link claude. Обычный engram upgrade не обновляет конфигурации хуков.
• Instructions: link claude записывает управляемый блок в AGENTS.md и больше не создаёт CLAUDE.md; существующий блок в CLAUDE.md сохраняется. Сгенерированные файлы SKILL.md теперь соответствуют спецификации Agent Skills.
• MCP: сервер поддерживает MCP 2026-07-28 и прежнее рукопожатие, а engram_commit требует подтверждения при каждом вызове в Claude Code и Codex (engram upgrade перезаписывает управляемый блок Codex).
• Memory files: новые воспоминания не содержат author_email (выполните engram author migrate-memories --strip-email --confirm, чтобы очистить старые), правила хранят только свой Content, а резервные копии миграции находятся в папке backups/, исключённой из Git (engram repair --move-backups переносит более старые).
• Config: vector.enabled по умолчанию равно false для новых конфигураций; конфигурация, где уже сохранено true, остаётся включённой. cursorrules — устаревший псевдоним формата экспорта cursor-rules на один выпуск.

Полный список и перечень того, что ещё не сделано, смотрите в разделе Unreleased журнала изменений.

Миграция устаревших воспоминаний на схему v3 (schema v3)

engram upgrade --latest также мигрирует активные файлы памяти v1/v2 в рабочем пространстве и настроенных глобальных корнях на схему v3. Engram в точности сохраняет каждое тело Markdown, записывает backups/schema-v3/<memory-file>.pre-v3.bak (папка, исключённая из Git; engram repair --move-backups переносит более старые резервные копии, оставшиеся рядом с воспоминаниями), заполняет только детерминированные метаданные, обновляет хеши целостности и перестраивает индекс, граф и подходящие векторные sidecar-файлы. Он никогда не придумывает evidence_refs; воспоминание без проверенных ссылок на следы помечается evidence_status: unverified. О некорректных воспоминаниях сообщается, и они пропускаются, архивные воспоминания не перезаписываются, а повторный запуск идемпотентен.

Просмотр всех изменений без записи:

engram upgrade --latest --plan

Запуск только миграции памяти без перезаписи артефактов связанных агентов:

engram upgrade --migrate-memories

Пропуск миграции памяти при latest-обновлении:

engram upgrade --latest --no-migrate-memories

Дальнейшие шаги

• Устранение неполадок
• CLI: inject / link / upgrade

Личность автора Git

Engram может хранить глобального автора и необязательное переопределение для рабочего пространства. Порядок разрешения: рабочее пространство, глобальный, затем резервный Git только для чтения. Настройки влияют только на будущие воспоминания; переопределение рабочего пространства никогда не меняет глобальную конфигурацию Git. Для синхронизации с глобальным Git или миграции устаревших воспоминаний используйте явный план и подтверждение.

engram author show
engram author set --name "Jane Doe" --email "jane@example.com"
engram author unset --scope workspace
engram author sync-git-global --plan
engram author sync-git-global --confirm
engram author migrate-memories --plan
engram author migrate-memories --confirm

Прочитайте полное руководство по настройкам автора Git.

Проверка конфликтов использует один и тот же общий план в CLI и Entry. Выполните engram upgrade --latest --review, чтобы принять последнее предложение с учётом типа, отредактировать его через $VISUAL/$EDITOR или подтвердить Keep current. Entry предоставляет представления Current, Proposed и Diff; Diff по умолчанию показывается как Inline и может переключаться на Parallel, при этом удалённое содержимое подсвечивается красным, а добавленное — зелёным. Итоговое применение блокируется, пока pendingReviewCount не равен нулю, а engram upgrade --latest --yes отказывается работать с неразрешёнными или устаревшими решениями. Каждое решение сверяется с хешем своего источника перед записью.

Инвентаризация обновлений конфигурации

После обновления пакета выполните engram upgrade --latest --plan перед engram upgrade --latest. Общий инвентарь сканирует воспоминания, инструкции, skillset, конфигурации, хуки и плагины рабочего пространства и глобальной области, управляемые Engram. Байты, написанные пользователем, сохраняются; неоднозначные смешанные файлы сообщаются как конфликты, требующие явной проверки перед применением. См. Обновления конфигурации.