obsidian-vault/concepts/Git-Backup-Recovery-Protocol.md
2026-10-31 23:30:02 +00:00

380 lines
24 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: concept-git-backup-recovery-protocol
pageType: concept
updatedAt: 2026-10-30T00:20:00+03:00
sourceIds:
- source.agents
- source.memory
tags:
- git-backup
- recovery
- state-git
- config-git
- obsidian-git
- disaster-recovery
- openclaw
claims:
- text: "Канонический операционный документ Git backup/recovery —
/home/owner/.openclaw/workspace/OPENCLAW-GIT-BACKUP-RECOVERY.md:
main-agent ОБЯЗАН читать его перед любой задачей backup/rollback/restore/recovery
(Mandatory Reference Rule, §20.21) и НЕ воспроизводить процедуру из памяти"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.1 (lines 460–482), §20.21 (lines 1146–1174)"
updatedAt: "2026-09-26T11:54:39.969Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "Трёхслойная архитектура: 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"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "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)"
updatedAt: "2026-09-26T11:54:39.969Z"
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, lines 52–58 (OpenClaw Git Backup / Recovery)"
updatedAt: "2026-09-26T11:56:18.417Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "24h автоматический State Git backup ACTIVE — production-механизм,
отключать только по явному приказу пользователя; 'автоматизация включена' ≠
'backup успешен': здоровье доказывают 'backup created + pushed=true'
или валидный 'noChanges=true'; сбой расписания = degraded pipeline
до диагностики и успешного прогона"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.4 (lines 563–597)"
updatedAt: "2026-09-26T11:54:39.969Z"
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, lines 52–54 (OpenClaw Git Backup / Recovery, State Git)"
updatedAt: "2026-09-26T11:56:18.417Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "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"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.7 (lines 683–734), §20.8 (lines 736–791), §20.9 (lines 793–833), §20.10 (lines 835–848)"
updatedAt: "2026-09-26T11:54:39.969Z"
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, lines 56, 60, 62 (Obsidian Git)"
updatedAt: "2026-09-26T11:56:18.417Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "Рутинг интентов (§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"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.11–20.16 (lines 851–1047)"
updatedAt: "2026-09-26T11:54:39.969Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "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-истории;
сбой синхронизации НЕ является причиной рекреации репозитория"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.17 (lines 1049–1075), §20.18 (lines 1077–1095)"
updatedAt: "2026-09-26T11:54:39.969Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "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"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.19–20.20 (lines 1097–1144)"
updatedAt: "2026-09-26T11:54:39.969Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "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-механизма"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.22 (lines 1176–1224)"
updatedAt: "2026-09-26T11:54:39.969Z"
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, line 64 (Integration test, Obsidian Git отдельно)"
updatedAt: "2026-09-26T11:56:18.417Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "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)"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.23 (lines 1226–1260)"
updatedAt: "2026-09-26T11:54:39.969Z"
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, lines 52–66 (OpenClaw Git Backup / Recovery)"
updatedAt: "2026-09-26T11:56:18.417Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "РАЗРЕШЁННОЕ противоречие (было открытым на 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"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.5 (lines 599–653, line 625 IMPLEMENTED / ACTIVE), §20.23 (lines 1238–1241)"
updatedAt: "2026-09-26T11:54:39.969Z"
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, line 55 (Config Git, systemd --user timer)"
updatedAt: "2026-09-26T11:56:18.417Z"
updatedAt: 2026-09-26T16:15:48+03:00
- text: "Инцидент 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"
status: verified
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, line 46 (Obsidian Git, Docker obsidian-git-sync, restoration 2026-10-29)"
updatedAt: "2026-10-29T21:19:28.703Z"
updatedAt: 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
- [[AGENTS.md]]
- [[MEMORY.md]]
## Related
<!-- openclaw:wiki:related:start -->
### Sources
- [AGENTS](../sources/agents.md)
- [MEMORY](../sources/memory.md)
### Related Pages
- [Concept: Eurostela SEO Endpoint (MCP SEO Endpoint)](Eurostela-SEO-Endpoint.md)
- [Entity: Eurostela (евростела.ru)](../entities/eurostela.md)
- [Entity: Infrastructure](../entities/Infrastructure.md)
- [Pg-Boss Queue & AI Inference Worker](../syntheses/pg-boss-queue-ai-inference-worker.md)
- [Travel Automation (Mail Scan Pipeline)](../syntheses/travel-automation-mail-scan-pipeline.md)
<!-- openclaw:wiki:related:end -->