obsidian-vault/concepts/Change-Logging.md
2026-10-18 12:30:01 +00:00

145 lines
8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: concept-change-logging
pageType: concept
updatedAt: 2026-10-18T12:12:00.000Z
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
- text: 'Мутационные CHANGELOG-записи [INFRA]/[CODE]/[OPS]/[CONFIG] обязаны заканчиваться маркером delegation/evaluator (формат: - **delegation:** <agentId> label=<label> | evaluator: <verdict>; AGENTS.md §14.2, c 2026-10-17); нет маркера = нарушение §5 (report + backfill); [WIKI]/[VERIFY]/статусные записи — без маркера; записи до 2026-10-18 не ретрописываются'
status: verified
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
updatedAt: 2026-10-18T12:07:47.578Z
updatedAt: 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):
1. **CHANGELOG.md** — запись: дата, что, почему, затронутые файлы
2. **MEMORY.md** — обновление final-state (не история)
3. **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 + точный label `sessions_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)
Механика:
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 не меняется без одобрения пользователя
- Мутационные CHANGELOG-записи [INFRA]/[CODE]/[OPS]/[CONFIG] обязаны нести маркер delegation/evaluator (§14.2, c 2026-10-17); нет маркера = нарушение §5
## Tags
- change-logging
- changelog
- wiki
- ingest
- event-driven
## Sources
- [[AGENTS.md]]
## Related
<!-- openclaw:wiki:related:start -->
### 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)
<!-- openclaw:wiki:related:end -->