obsidian-vault/concepts/Git-Backup-Recovery-Protocol.md
2026-11-04 04:30:02 +00:00

25 KiB
Raw Blame History

id pageType updatedAt sourceIds tags claims
concept-git-backup-recovery-protocol concept 2026-10-30T00:20:00+03:00
source.agents
source.memory
git-backup
recovery
state-git
config-git
obsidian-git
disaster-recovery
openclaw
text status confidence evidence updatedAt
Канонический операционный документ Git backup/recovery — /home/owner/.openclaw/workspace/OPENCLAW-GIT-BACKUP-RECOVERY.md: main-agent ОБЯЗАН читать его перед любой задачей backup/rollback/restore/recovery (Mandatory Reference Rule, §20.21) и НЕ воспроизводить процедуру из памяти supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.1 (lines 460–482), §20.21 (lines 1146–1174) 2026-09-26T11:54:39.969Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
Трёхслойная архитектура: State Git (/home/owner/openclaw-backup/state-repo, приватный Forgejo Sergey/openclaw-clawpi-state, native openclaw backup git с scope --all --include-secrets --push) + Config Git (/home/owner/openclaw-backup/repo, Sergey/openclaw-clawpi, отдельные credentials OPENCLAW_CONFIG_GIT_TOKEN + временный GIT_ASKPASS) + Obsidian Git (/home/owner/obsidian-vault, Sergey/obsidian-vault); три независимых репозитория с независимыми lifecycle/recovery-механизмами; НЕ объединяются в один backup repository; успешный backup одного слоя НЕ является успехом остальных; --include-secrets — политика только State Git; статус по §20.23 (2026-09-26): все слои ACTIVE supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.2 (lines 484–515), §20.3 (lines 517–561), §20.5 (lines 599–653), §20.7 (lines 683–734), §20.23 (lines 1226–1260) 2026-09-26T11:54:39.969Z
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, lines 52–58 (OpenClaw Git Backup / Recovery) 2026-09-26T11:56:18.417Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
24h автоматический State Git backup ACTIVE — production-механизм, отключать только по явному приказу пользователя; 'автоматизация включена' ≠ 'backup успешен': здоровье доказывают 'backup created + pushed=true' или валидный 'noChanges=true'; сбой расписания = degraded pipeline до диагностики и успешного прогона supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.4 (lines 563–597) 2026-09-26T11:54:39.969Z
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, lines 52–54 (OpenClaw Git Backup / Recovery, State Git) 2026-09-26T11:56:18.417Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
Obsidian Git (третий независимый слой): host cron */15 → /usr/local/bin/obsidian-docker-sync.sh → Docker obsidian-git-sync (commit+push только при изменениях, лог /home/owner/obsidian-sync.log); SSH Ed25519 Deploy Key /home/owner/.ssh/obsidian-vault-sync (Write Access) + dedicated known_hosts /home/owner/.ssh/obsidian-vault-known_hosts, IdentitiesOnly=yes, StrictHostKeyChecking=yes, BatchMode=yes; host ~/.git-credentials НЕ используется для аутентификации и НЕ монтируется в Docker-контейнер; concurrency protection — flock /tmp/obsidian-docker-sync.lock (конкурентный запуск завершается без изменений репозитория); НЕ часть native openclaw backup git; независимый lifecycle и recovery supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.7 (lines 683–734), §20.8 (lines 736–791), §20.9 (lines 793–833), §20.10 (lines 835–848) 2026-09-26T11:54:39.969Z
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, lines 56, 60, 62 (Obsidian Git) 2026-09-26T11:56:18.417Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
Рутинг интентов (§20.11–20.16): 'сделай backup/закоммить состояние' (default) → State Git backup (--all + push) через setup-agent + верификация evaluator-agent; явный 'Config backup' → Config Git; явный 'сохрани Obsidian' → Obsidian Git; 'проверь Obsidian backup' → cron → фактическое исполнение скрипта → результат синхронизации → local/remote HEAD (наличие cron-записи само по себе НЕ доказательство); 'полный backup' → все три слоя, каждый слой отчитывается отдельно (SUCCESS/NO CHANGES/FAILED; частичный результат ≠ полный успех); 'откати/восстанови' → destructive (exact revision, верификация снапшота, safety-backup live state, остановка Gateway перед заменой БД, staged restore, post-restore validation, health-check, новый backup); 'восстанови всю систему' → State + Config + Obsidian Git (последовательность ТОЛЬКО в каноническом документе); 'покажи предыдущий backup' — просмотр, НЕ rollback supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.11–20.16 (lines 851–1047) 2026-09-26T11:54:39.969Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
State Git safety rules (§20.17): никаких ordinary commits и non-backup-файлов, без git reset --hard как замены OpenClaw restore, без замены live-БД при работающем Gateway, без restore без верификации снапшота и без safety-copy live state, без автоудаления backup-истории/legacy-БД, без авторекреации репозитория, без публичного экспорта, без history rewrite без явного user approval; 'non-backup commits' → НЕ создавать новое репо автоматически, следовать канонической процедуре; Obsidian Git safety rules (§20.18): запрет авто-удаления репо/.git, git init, git reset --hard, git push --force, замены Forgejo-репозитория, перезаписи remote-истории; сбой синхронизации НЕ является причиной рекреации репозитория supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.17 (lines 1049–1075), §20.18 (lines 1077–1095) 2026-09-26T11:54:39.969Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
Separation of Responsibilities (§20.19): main-agent = оркестрация/рутинг/ approval/отчёты, setup-agent = инфраструктурное исполнение, evaluator-agent = вердикт корректности (authoritative); main-agent НЕ самоверифицирует инфраструктурные изменения; полная процедура НЕ копируется в AGENTS.md/MEMORY.md (context-minimization §20.20) — там только routing/authority/safety-правила и стабильные architectural facts supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.19–20.20 (lines 1097–1144) 2026-09-26T11:54:39.969Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
Integration test: /home/owner/openclaw-backup/integration-test-git-backups.sh — успех = PASS / FAIL=0; валидирует State Git и Config Git (authentication, backup, commit/no-change handling, push, local/remote synchronization, scheduled mechanisms); тест диагностический, НЕ должен менять инфраструктуру/credentials/remotes/automation/историю; integration-test-run2.log = evidence базового теста, не operational truth; Obsidian Git проверяется отдельно из-за независимого lifecycle и synchronization-механизма supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.22 (lines 1176–1224) 2026-09-26T11:54:39.969Z
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, line 64 (Integration test, Obsidian Git отдельно) 2026-09-26T11:56:18.417Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
Final state (2026-09-26, AGENTS.md §20.23 + MEMORY.md §3): все три слоя ACTIVE/operational, private Forgejo, независимы — State Git (24h, native openclaw backup git, --all --include-secrets --push), Config Git (24h, systemd --user timer, отдельные credentials), Obsidian Git (cron */15, Docker-синхронизация, SSH Deploy Key); integration test ранее прошёл PASS / FAIL=0 (State+Config); operational truth — Git-репозитории, результаты бэкапов, automation (timer/cron) supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.23 (lines 1226–1260) 2026-09-26T11:54:39.969Z
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, lines 52–66 (OpenClaw Git Backup / Recovery) 2026-09-26T11:56:18.417Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
РАЗРЕШЁННОЕ противоречие (было открытым на 2026-09-24): старый AGENTS.md §20.2 помечал Config Git как 'ARCHITECTURE DEFINED / CONFIGURATION NOT YET COMPLETED', при этом MEMORY.md и канонический документ указывали на реализованную 24h-автоматизацию; переписанный AGENTS.md (2026-09-26) разрешает противоречие: §20.5 помечает Config Git IMPLEMENTED / ACTIVE (backup/restore-скрипты, systemd user timer), §20.23 (2026-09-26) помечает все три слоя ACTIVE/operational supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.5 (lines 599–653, line 625 IMPLEMENTED / ACTIVE), §20.23 (lines 1238–1241) 2026-09-26T11:54:39.969Z
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, line 55 (Config Git, systemd --user timer) 2026-09-26T11:56:18.417Z
2026-09-26T16:15:48+03:00
text status confidence evidence updatedAt
Инцидент 2026-10-29 (Obsidian Git layer): Docker-образ obsidian-git-sync (третий слой, host cron */15 -> Docker) потерян ~вечером 2026-10-29 и восстановлен 2026-10-29 (MEMORY.md Sec.3, line 46); после восстановления pipeline синхронизации /home/owner/obsidian-vault -> git@git.datacloudport.ru:Sergey/obsidian-vault.git операционен; final state (2026-10-30): все три слоя backup ACTIVE/operational verified 0.95
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, line 46 (Obsidian Git, Docker obsidian-git-sync, restoration 2026-10-29) 2026-10-29T21:19:28.703Z
2026-10-30T00:20:00+03:00

Concept: Git Backup & Recovery Protocol (AGENTS.md §20)

Summary

Трёхслойный Git-бэкап OpenClaw (State Git + Config Git + Obsidian Git) с жёстким разделением ролей: канонический операционный документ — OPENCLAW-GIT-BACKUP-RECOVERY.md; main-agent никогда не исполняет инфраструктурные команды и не самоверифицируется — исполнение делегировано setup-agent, вердикт корректности — evaluator-agent. Статус 2026-09-26 (§20.23): все три слоя ACTIVE/operational, private Forgejo, независимы.

Description

Архитектура (§20.2, 20.3, 20.5, 20.7)

Три независимых Git-слоя — три независимых репозитория и три независимых lifecycle/recovery-механизма. Слои MUST NOT объединяться в один backup repository; успешный backup одного слоя MUST NOT сообщаться как успех остальных слоёв.

  • State Git — внутреннее состояние OpenClaw (SQLite): /home/owner/openclaw-backup/state-repo → приватный Forgejo https://git.datacloudport.ru/Sergey/openclaw-clawpi-state.git. Статус: IMPLEMENTED / ACTIVE. Native openclaw backup git с scope --all --include-secrets --push; --include-secrets — политика ТОЛЬКО State Git, НЕ распространяется на Config/Obsidian Git. Репозиторий PRIVATE и содержит credential-bearing backup material.
  • Config Git — конфигурация, credentials, selected persistent-файлы: /home/owner/openclaw-backup/repo → https://git.datacloudport.ru/Sergey/openclaw-clawpi.git. Статус: IMPLEMENTED / ACTIVE (§20.5). Скрипты config-git-backup.sh / config-git-restore.sh; автоматизация — systemd user timer openclaw-config-backup.{service,timer}. Независим от State Git; отдельные credentials (§20.6: OPENCLAW_CONFIG_GIT_TOKEN в /home/owner/.openclaw/.env + временный GIT_ASKPASS, временное auth-состояние чистится после исполнения); НЕ заменяется native State Git backup.
  • Obsidian Git — knowledge vault / Markdown / документация: /home/owner/obsidian-vault → git@git.datacloudport.ru:Sergey/obsidian-vault.git. Статус: IMPLEMENTED / ACTIVE (§20.7). НЕ является частью State Git и Config Git; MUST NOT добавляться в native openclaw backup git pipeline.

Автоматический backup (§20.4, 20.5, 20.8)

  • State Git: 24h OpenClaw scheduled backup — production-механизм, отключается только по явному приказу пользователя. Ключевое правило: активный scheduler entry — НИКОГДА не доказательство успешного бэкапа; доказательство = backup created + pushed=true или валидный noChanges=true. Сбой = pipeline degraded до диагностики + успешного прогона.
  • Config Git: 24h через systemd --user timer openclaw-config-backup.timer.
  • Obsidian Git: host cron */15 * * * * → /usr/local/bin/obsidian-docker-sync.sh → Docker obsidian-git-sync → при изменениях: commit + push (лог /home/owner/obsidian-sync.log); без изменений — commit не создаётся («Нет изменений.»). Concurrency protection: flock на /tmp/obsidian-docker-sync.lock; конкурентный запуск MUST завершиться без изменений репозитория (§20.10).

Безопасность Obsidian Git (§20.9)

Dedicated SSH Ed25519 key /home/owner/.ssh/obsidian-vault-sync (Forgejo Deploy Key с Write Access); dedicated known_hosts /home/owner/.ssh/obsidian-vault-known_hosts; IdentitiesOnly=yes, StrictHostKeyChecking=yes, BatchMode=yes; host ~/.git-credentials MUST NOT использоваться для аутентификации и MUST NOT монтироваться в Docker-контейнер; пароли/токены MUST NOT встроены в obsidian-docker-sync.sh.

Рутинг по интентам пользователя (§20.11–20.16)

Интент Маршрут Ключевые требования
«сделай backup» / «закоммить состояние» (default) main → setup-agent → evaluator-agent canonical doc → State Git --all + push → верификация → отчёт
«Config backup» (явно) main → setup-agent → evaluator-agent Config Git по каноническому документу
«сохрани Obsidian» / «сделай backup Obsidian» (явно) main → setup-agent → evaluator-agent Obsidian Git
«проверь Obsidian backup» main → setup-agent → evaluator-agent cron → фактическое исполнение скрипта → результат синхронизации → local HEAD → remote HEAD; наличие cron-записи ≠ успех
«полный backup» main → setup-agent → evaluator-agent все три слоя (State + Config + Obsidian); каждый слой отчитывается отдельно (SUCCESS / NO CHANGES / FAILED); частичный результат ≠ «полный backup успешен»
«откати» / «восстанови из backup» main → setup-agent → evaluator-agent destructive: явный запрос, exact revision, canonical doc, верификация снапшота, safety-copy live state, остановка Gateway, staged restore, post-restore validation, health-check, новый backup
«восстанови всю систему» main → setup-agent → evaluator-agent Full System Recovery = State + Config + Obsidian Git (§20.16); последовательность ТОЛЬКО в каноническом документе
«покажи/посмотри предыдущий backup» main → setup-agent только просмотр; НЕ интерпретировать как rollback

Backup Verification (§20.14): активный scheduler — недостаточное доказательство; верификация только по фактическому execution evidence: State Git — backup result / pushed=true / noChanges=true; Config Git — исполнение скрипта, commit/no-change, push, local/remote sync; Obsidian Git — исполнение cron, результат скрипта, local/remote HEAD. При проблемах синхронизации авторитетно состояние remote-репозитория.

Safety rules (State §20.17, Obsidian §20.18)

  • State Git: никаких ordinary commits и non-backup-файлов; без git reset --hard как замены OpenClaw restore; без замены live-БД при работающем Gateway; без restore без верификации снапшота и без safety-copy live state; без автоудаления backup-истории и legacy-БД; без авторекреации репозитория; без публичного экспорта; без history rewrite без явного user approval. Отчёт «repository history contains non-backup commits» → НЕ создавать новое репо автоматически, следовать канонической процедуре.
  • Obsidian Git: MUST NOT автоматически — удалять репозиторий/.git, git init, git reset --hard, git push --force, заменять Forgejo-репозиторий, переписывать remote-историю. Сбой синхронизации НЕ является причиной рекреации репозитория: сохранить локальное репо и сначала определить точный сбой.

Ответственность и минимизация контекста (§20.19–20.20)

  • main-agent = оркестрация/рутинг/user approval/отчётность (НЕ самоверификация инфраструктурных мутаций)
  • setup-agent = инфраструктурное исполнение (backup/restore/репозиторий)
  • evaluator-agent = вердикт корректности (authoritative)
  • Полная процедура НЕ копируется в AGENTS.md / MEMORY.md; там только routing/authority/safety-правила и стабильные architectural facts.

Mandatory Reference Rule (§20.21)

Любой интент backup/snapshot/commit state/restore/rollback/recovery/disaster recovery/recover OpenClaw|database|configuration|Obsidian → сначала читать OPENCLAW-GIT-BACKUP-RECOVERY.md.

Integration test (§20.22)

/home/owner/openclaw-backup/integration-test-git-backups.sh: успех = PASS / FAIL=0. Валидирует State Git и Config Git (аутентификация, backup, commit/no-change handling, push, local/remote synchronization, scheduled mechanisms). Тест диагностический: НЕ модифицирует инфраструктуру, credentials, remotes, automation, историю. Детальный вывод integration-test-run2.log — evidence успешного базового теста, НЕ operational source of truth. Obsidian Git проверяется отдельно — независимый lifecycle и synchronization-механизм.

Final state (§20.23, 2026-09-26)

Все три слоя ACTIVE/operational, private Forgejo, независимы:

  • State Git: ACTIVE, каждые 24h (native OpenClaw backup).
  • Config Git: ACTIVE, systemd user timer.
  • Obsidian Git: ACTIVE, cron */15, Docker-синхронизация, SSH Deploy Key.

Противоречие 2026-09-24 про Config Git («NOT YET COMPLETED») разрешено: переписанный AGENTS.md §20.5 помечает Config Git IMPLEMENTED / ACTIVE, §20.23 (2026-09-26) — все слои ACTIVE. Operational truth — Git-репозитории, результаты бэкапов, automation (timer/cron).

Tags

  • git-backup
  • recovery
  • state-git
  • config-git
  • obsidian-git
  • disaster-recovery
  • openclaw

Sources

Sources