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

8 KiB
Raw Blame History

id pageType updatedAt sourceIds tags claims
concept-change-logging concept 2026-10-18T12:12:00.000Z
sources/agents-md.md
sources/agents.md
change-logging
changelog
wiki
ingest
event-driven
text status confidence evidence updatedAt
CHANGELOG entry обязателен до закрытия задачи с infra-изменениями supported 0.95
kind sourceId path updatedAt
source-file source.agents sources/agents.md 2026-08-22T09:11:33.363Z
2026-08-22T09:11:33.363Z
text status confidence evidence updatedAt
MEMORY.md хранит final state, а не историю supported 0.95
kind sourceId path updatedAt
source-file source.agents sources/agents.md 2026-08-22T09:11:33.363Z
2026-08-22T09:11:33.363Z
text status confidence evidence updatedAt
Wiki ingest запускается event-driven при изменении источников, без cron supported 0.95
kind sourceId path updatedAt
source-file source.agents sources/agents.md 2026-08-22T09:11:33.363Z
2026-08-22T09:11:33.363Z
text status confidence evidence updatedAt
sessions_spawn без разрешения пользователя допустим только для фоновой wiki-ingest задачи supported 0.95
kind sourceId path updatedAt
source-file source.agents sources/agents.md 2026-08-22T09:11:33.363Z
2026-08-22T09:11:33.363Z
text
vaultMode не меняется без одобрения пользователя
text status confidence evidence updatedAt status confidence evidence updatedAt
Мутационные 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 не ретрописываются verified 0.95
kind sourceId path updatedAt
source-file source.agents sources/agents.md 2026-10-18T12:07:47.578Z
2026-10-18T12:12:00.000Z supported 0.9
kind sourceId path updatedAt
source-file source.agents sources/agents.md 2026-08-22T09:11:33.363Z
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.

§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

Referenced By