5.9 KiB
| id | pageType | updatedAt | sourceIds | tags | claims | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| concept-change-logging | concept | 2026-08-22T13:50:00+03:00 |
|
|
|
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.
§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 не меняется без одобрения пользователя
Tags
- change-logging
- changelog
- wiki
- ingest
- event-driven