8 KiB
| id | pageType | updatedAt | sourceIds | tags | claims | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| concept-change-logging | concept | 2026-10-18T12:12:00.000Z |
|
|
|
Concept: Change Logging & Wiki Ingestion (AGENTS.md §14–§16)
Summary
Обязательный workflow логирования изменений и event-driven синхронизации wiki: после любого инфраструктурного/конфигурационного изменения — запись в CHANGELOG.md, обновление MEMORY.md (final state) и ingest/compile wiki.
Description
§14 Change Logging
После любого infra/config изменения (делегированного setup-agent):
- CHANGELOG.md — запись: дата, что, почему, затронутые файлы
- MEMORY.md — обновление final-state (не история)
- Wiki — ingest/compile для структурированной синтеза
Main-agent не может пропускать логирование. CHANGELOG entry обязателен до отметки задачи complete. Setup-agent, coder-agent и все агенты с делегированными задачами тоже фиксируют изменения в CHANGELOG.md.
§14.2 Delegation Visibility Markers (2026-10-17, решение Сергея)
Каждая мутационная CHANGELOG-запись с префиксом [INFRA]/[CODE]/[OPS]/[CONFIG] обязана заканчиваться маркером:
- **delegation:** <agentId> label=<spawn-label> | evaluator: <verdict> (label=<audit label> или ссылка на [VERIFY])
delegation:— sub-agent + точный labelsessions_spawn; без делегирования — только с явного разрешения:main-agent (direct, user-approved <date>)evaluator:— вердикт независимого read-only аудита (PASS / PASS WITH LIMITATIONS / FAIL) + где он (label / [VERIFY]); по решению пользователя:skipped (user decision, <date>)- Нет маркера = нарушение §5 — отчёт в ответ + backfill-правка (фактические label, без ретрофита)
- Не требуется для [WIKI], [VERIFY], статусных/read-only записей; записи до 2026-10-18 не ретрописываются
§15 Wiki Policy
- memory-wiki работает в bridge mode (длительная память)
- Источники ingest: USER.md, MEMORY.md, AGENTS.md, SOUL.md, IDENTITY.md, TOOLS.md, EMBEDDING-TRADING.md
- Известный баг: bridge import синхронизирует 0 артефактов (GH #65698) → использовать
wiki ingestвручную - Wiki ingest/compile = инфраструктурная задача → делегируется setup-agent
- vaultMode меняется только с одобрения пользователя
§16 Wiki Ingestion Trigger (event-driven)
Триггер: любое изменение wiki-источников:
- 7 файлов-источников (USER.md, MEMORY.md, AGENTS.md, SOUL.md, IDENTITY.md, TOOLS.md, EMBEDDING-TRADING.md)
- Новые .md файлы в /home/owner/.openclaw/workspace/
- Вывод memory-core dreaming (daily notes, dream reports)
Механика:
- Перед каждым ответом main-agent проверяет изменения wiki-источников
- Изменены → spawn setup-agent subagent: ingest → apply entities/concepts/syntheses → compile → lint → update CHANGELOG
- Не изменены → skip (нулевая стоимость)
Особое исключение из §1: main-agent явно авторизован запускать sessions_spawn БЕЗ разрешения пользователя только для этой внутренней фоновой wiki-ingest задачи. Для любых других целей автоматический sessions_spawn запрещён. Cron не требуется — чисто event-driven.
Claims
- CHANGELOG entry обязателен до закрытия задачи с infra-изменениями
- MEMORY.md хранит final state, а не историю
- Wiki ingest запускается event-driven при изменении источников, без cron
- sessions_spawn без разрешения пользователя допустим только для фоновой wiki-ingest задачи
- vaultMode не меняется без одобрения пользователя
- Мутационные CHANGELOG-записи [INFRA]/[CODE]/[OPS]/[CONFIG] обязаны нести маркер delegation/evaluator (§14.2, c 2026-10-17); нет маркера = нарушение §5
Tags
- change-logging
- changelog
- wiki
- ingest
- event-driven