obsidian-vault/concepts/Change-Logging.md
2026-09-20 20:40:46 +03:00

5.9 KiB
Raw Blame History

id pageType updatedAt sourceIds tags claims
concept-change-logging concept 2026-08-22T13:50:00+03:00
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 status confidence evidence updatedAt
vaultMode не меняется без одобрения пользователя 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.

§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

Referenced By