Основания и актуальность памяти

Решение может пережить код, который его обосновывал. Bee сохраняет состояние исходных файлов записи памяти и позже сравнивает его с checkout. Основания хранятся в отдельной коллекции memory_evidence с добавлением новых событий; существующие записи памяти и архивы сохраняются.

bee remember evidence add '<full-memory-id>' --root /path/to/repo --source src/Policy.cs --json
bee remember evidence list '<full-memory-id>' --json
bee remember audit '<full-memory-id>' --root /path/to/repo --json
bee remember audit --root /path/to/repo --limit 20 --json
bee remember context --with-evidence --json

Используйте полный ID памяти в области соответствующего репозитория. Для записи оснований требуется подтверждаемая каноническая идентичность Git remote. Повторяйте --source для нескольких файлов. Сохраняются хеши байтов и версия утверждения, а не исходный текст или абсолютные пути машины. Первые якоря работают на уровне файла; даже посторонняя правка в том же файле может потребовать проверки.

Статус	Значение
unchanged	Байты источника совпадают с сохранёнными
changed	Байты источника изменились
missing	Сохранённый исходный файл отсутствует
unknown	У этой версии утверждения нет оснований
inconclusive	Надёжно завершить сравнение не удалось

Неизменность не означает истинность. Возраст, повторные упоминания и повторная фиксация источника не подтверждают решение. Изменение источника — повод пересмотреть комментарий или память, а не доказательство ошибки. Bee не исправляет автоматически все комментарии на естественном языке, не загружает внешние политики и не подменяет старые инструкции мнением LLM без явного действия.

Явно заменить или отозвать решение

bee remember supersede '<old-id>' --with '<new-id>' --reason 'Policy changed after review' --json
bee remember retract '<memory-id>' --reason 'The recorded conclusion was incorrect' --json

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

Чтение без изменения оснований

Аудит и чтение не создают коллекций, индексов, временных меток или событий подтверждения. Команды из памяти не исполняются. Выход за пределы репозитория, символические ссылки, слишком большие файлы и переполнение лимита истории сообщаются явно. Допускается до 50 файлов размером до 1 MB каждый. Совпадение имени папки не заменяет подтверждённую идентичность репозитория при записи.

Обычный ответ context/search остаётся совместимым. --with-evidence включает оболочку с основаниями; старые записи не удаляются, не архивируются, не пересортировываются и не скрываются автоматически. Агент должен учитывать версию и состояние источника, решая, нужен ли пересмотр. См. Память.