127 lines
5.9 KiB
Markdown
127 lines
5.9 KiB
Markdown
---
|
||
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
|
||
<!-- 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 -->
|