Перейти к основному содержимому
Версия: Future

Путь записи и подтверждение

Поток записи — это граница доверия. Агенты предлагают, люди утверждают.

Поток записи​

  1. Агент предлагает одного или нескольких кандидатов. При save-session --query-level <n> агент может учитывать до n недавних доступных чатов человека с агентом, но только как контекст для предложения. Естественная форма /engram ss -f last 50 sessions — это та же область плюс явное принудительное подтверждение: engram save-session --query-level 50 --force.
  2. Engram разбирает тип кандидата и целевую область.
  3. Engram проверяет схему, секреты, шаблоны prompt-инъекций и безопасность путей.
  4. Человек видит предпросмотр. Каждый кандидат содержит одну детерминированную строку Verdict:: ADD, UPDATE <id>, SUPERSEDE <id> или NOOP duplicate of <id> (без вызова модели).
  5. Ответы в прямом CLI: A, A 1,3, B <note> или C.
  6. Ответы в чате ИИ-агента: yes, audit или cancel после точно показанных кандидатов.
  7. Записывается только утверждённая память. A и B пропускают кандидатов NOOP, а подтверждение SUPERSEDE помечает старое воспоминание как замещённое; --force и автосохранение никогда не применяют SUPERSEDE, они откладывают его для проверки.
  8. Индекс, граф, хеши и журнал изменений обновляются.

Слова подтверждения​

Слова подтверждения: yes, approve, confirm или save. Слова для доработки: audit, revise, correct или отредактированный заменяющий текст. Слова отмены: cancel, stop или отказ. Только подтверждение после точного показа кандидатов разрешает engram save-session --force для этих кандидатов.

Прямой терминальный CLI остаётся A/B/C. Инструменты предложений MCP по-прежнему не пишут.

Подсказки о связанных воспоминаниях​

Когда engram save находит связанные активные воспоминания, предпросмотр подтверждения сообщает о них с предлагаемой связью depends_on или предупреждением о возможном дубликате. Принятие сохраняет предпросмотр как есть; сначала отклоните, если хотите перестроить зависимости или заархивировать дубликаты перед сохранением.

Для save-session --force Engram приостанавливается перед записью, когда появляются такие подсказки о связанных воспоминаниях. Агент должен использовать ответ, чтобы продумать структурированный повторный запуск: добавить DEPENDS_ON: memory-id для зависимостей, LEVEL: advanced, когда воспоминание глубже своего предварительного условия, или UPDATE: memory-id, когда кандидата нужно слить с возможным дубликатом.

Память, подкреплённая доказательствами​

Для исходного материала, который нужно проверить, прежде чем он станет активной памятью:

engram observe --file session.md
engram save-session --file .agents/.engram/inbox/<observation>.md

Первая команда очищает источник и записывает неизменяемый след, определяемый trace_id, плюс редактируемую обёртку во входящих. Вторая команда сопоставляет обёртку с её следом, проверяет хеш и область и записывает только утверждённую человеком память схемы v3 (schema v3) с evidence_refs. Правка ## Raw Note не может заменить доказательство следа.

Проверки безопасности при сохранении​

  • Проверка схемы
  • Поиск секретов
  • Поиск prompt-инъекций
  • Безопасность путей
  • Целостность хешей

Почему это важно​

Без протокола память может превратиться в невидимое состояние. Невидимое состояние трудно проверять, трудно разделять, и агентам легко случайно отравить его.

Engram намеренно делает память скучной: файлы, диффы, хеши, шлюзы проверки и команды, которые человек может запустить повторно.

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