На долгой дистанции

Передача дел — что произошло

bee handover --session      # что сделал ЭТОТ запуск
bee handover --since 12h    # или временное окно
bee handover --json

Сначала решения, потом исправления, потом остальное — в том порядке, в котором это нужно тому, кто подхватывает работу.

--session читает идентификатор, который среда уже экспортирует — CLAUDE_CODE_SESSION_ID, CODEX_SESSION_ID — так что «этот запуск» это точная граница, а не догадка о ней. BEE_SESSION переопределяет её для всего, чему bee не обучен.

Он отказывается, а не догадывается

Если в окружении нет идентификатора сессии, --session завершается с ошибкой, а не откатывается молча к временному окну. Окно захватит параллельную работу коллеги и упустит всё, что старше догадки — оно ответило бы на другой вопрос, выглядя при этом как ответ на этот.

Бюджет — во что обходится управление

bee budget
bee budget --json

         session start (once)
┌───────────┬───────┬───────┬─────────┐
│ component │ items │ chars │ ~tokens │
├───────────┼───────┼───────┼─────────┤
│ memory    │ 1     │ 108   │ 27      │
│ chrome    │       │ 48    │ 12      │
│ total     │       │ 156   │ 39      │
└───────────┴───────┴───────┴─────────┘

По компонентам, для начала сессии и для примерного запроса. Так вы узнаёте, что набор правил незаметно стал дорогим.

Уплотнение — что мешает вспоминать

bee compact                 # только отчёт
bee compact --archive       # действовать
bee compact --archived      # что сейчас выведено из выдачи
bee compact --restore <id>  # вернуть одну запись

Со временем в хранилище накапливаются записи, которые затрудняют поиск: почти-дубликаты, устаревшие решения, разовые заметки, которые больше никогда не понадобятся. bee compact показывает их; ничего не двигается, пока вы не попросите.

Удаления нет

--archive копирует в отдельную коллекцию перед выводом из выдачи, записывает причину, а --restore возвращает обратно. Вопрос «должно ли уплотнение удалять, резюмировать или архивировать?» был решён удалением первого варианта: запись, которую нельзя вернуть, — это запись, в отбрасывании которой нельзя было ошибиться.

Фоновый рабочий процесс

bee worker              # остаётся запущенным
bee worker --once       # выполнить каждую задачу один раз и отчитаться
bee worker --once --json

Работа, растущая с размером хранилища, не должна стоять на пути запроса. Рабочий процесс строит индекс релевантности и проверяет состояние эмбеддингов.

{"ok":true,"jobs":[{"job":"embedding-health"},
 {"job":"search-index","message":"built the relevance index — search now reaches
  the whole store, not just the recent end of it"}],"failures":[]}

Задачи разрешаются через внедрение зависимостей, поэтому добавить новую — значит её зарегистрировать.