145 lines
8 KiB
Markdown
145 lines
8 KiB
Markdown
---
|
||
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 -->
|