obsidian-vault/concepts/Change-Logging.md
2026-11-17 18:00:01 +00:00

145 lines
8.9 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-11-17T17:14:13.076Z
sourceIds:
- sources/agents-md.md
- sources/agents.md
tags:
- change-logging
- changelog
- wiki
- ingest
- event-driven
claims:
- text: 'После persistent infra/config мутации обязательна CHANGELOG-запись (user-managed, 2026-11-17): агенты НЕ пишут в CHANGELOG.md — передают ready-to-paste текст в отчёт, запись фиксируется до отметки задачи complete'
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
updatedAt: 2026-11-17T17:14:13.076Z
updatedAt: 2026-11-17T17:14:13.076Z
- 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-запись (CHANGELOG.md user-managed с 2026-11-17: агенты передают ready-to-paste текст в отчёт), обновление MEMORY.md (final state) и ingest/compile wiki.
## Description
### §14 Change Logging
После любого infra/config изменения (делегированного setup-agent):
1. **CHANGELOG-запись** — дата, что, почему, затронутые файлы, верификация + маркер §14.2. CHANGELOG.md — user-managed (решение Сергея 2026-11-17): агенты (main и subagents) НЕ пишут в него — в финальном отчёте передаётся ready-to-paste текст записи, пользователь решает, вставлять ли его
2. **MEMORY.md** — обновление final-state (не история)
3. **Wiki** — ingest/compile для структурированной синтеза
Main-agent не может пропускать логирование. CHANGELOG-запись (ready-to-paste текст в отчёте) обязательна до отметки задачи complete. Setup-agent, coder-agent и все агенты с делегированными задачами тоже передают ready-to-paste текст записи (сами в 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 → ready-to-paste CHANGELOG entry text в completion report (агенты НЕ пишут CHANGELOG.md — user-managed, §14)
3. Не изменены → skip (нулевая стоимость)
Особое исключение из §1: main-agent явно авторизован запускать sessions_spawn БЕЗ разрешения пользователя только для этой внутренней фоновой wiki-ingest задачи. Для любых других целей автоматический sessions_spawn запрещён. Cron не требуется — чисто event-driven.
## Claims
- CHANGELOG-запись обязательна до закрытия задачи с infra-изменениями (CHANGELOG.md user-managed, 2026-11-17: агенты передают ready-to-paste текст в отчёт)
- 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 -->