--- id: concept-change-logging pageType: concept updatedAt: 2026-08-22T13:50:00+03:00 sourceIds: - sources/agents-md.md - sources/agents.md tags: - change-logging - changelog - wiki - ingest - event-driven claims: - text: CHANGELOG entry обязателен до закрытия задачи с infra-изменениями status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md updatedAt: 2026-08-22T09:11:33.363Z updatedAt: 2026-08-22T09:11:33.363Z - text: MEMORY.md хранит final state, а не историю status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md updatedAt: 2026-08-22T09:11:33.363Z updatedAt: 2026-08-22T09:11:33.363Z - text: Wiki ingest запускается event-driven при изменении источников, без cron status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md updatedAt: 2026-08-22T09:11:33.363Z updatedAt: 2026-08-22T09:11:33.363Z - text: sessions_spawn без разрешения пользователя допустим только для фоновой wiki-ingest задачи status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md updatedAt: 2026-08-22T09:11:33.363Z updatedAt: 2026-08-22T09:11:33.363Z - text: vaultMode не меняется без одобрения пользователя status: supported confidence: 0.9 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md updatedAt: 2026-08-22T09:11:33.363Z updatedAt: 2026-08-22T09:11:33.363Z --- # 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): 1. **CHANGELOG.md** — запись: дата, что, почему, затронутые файлы 2. **MEMORY.md** — обновление final-state (не история) 3. **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) Механика: 1. Перед каждым ответом main-agent проверяет изменения wiki-источников 2. Изменены → spawn setup-agent subagent: ingest → apply entities/concepts/syntheses → compile → lint → update CHANGELOG 3. Не изменены → 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 ## Sources - [[AGENTS.md]] ## Related ### Referenced By - [Idempotent-Wiki-Ingest-Pipeline](../syntheses/idempotent-wiki-ingest-pipeline.md) ### Related Pages - [Concept: Routing](Routing.md) - [Entity: OpenClaw](../entities/OpenClaw.md) - [Hermes Restructure (2026-09-07): Source of Truth → INFRASTRUCTURE.md](../syntheses/hermes-restructure-2026-09-07-source-of-truth-infrastructure-md.md) - [Infrastructure Overview](../syntheses/infrastructure-overview.md) - [Synthesis: Agent Architecture](../syntheses/Agent-Architecture.md) - [Synthesis: Work Automation Rule (§17)](../syntheses/Work-Automation.md)