obsidian-vault/concepts/Git-Backup-Recovery-Protocol.md
2026-09-24 21:30:02 +00:00

15 KiB
Raw Blame History

id pageType updatedAt sourceIds tags claims
concept-git-backup-recovery-protocol concept 2026-09-24T21:02:00+03:00
source.agents
source.memory
git-backup
recovery
state-git
config-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) и НЕ воспроизводить процедуру из памяти supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.1, §20.12 (lines 437–760) 2026-09-24T20:57:49.604Z
2026-09-24T21:02:00+03:00
text status confidence evidence updatedAt
Двухслойная архитектура: State Git (/home/owner/openclaw-backup/state-repo, приватный Forgejo Sergey/openclaw-clawpi-state, scope --all --include-secrets) + Config Git (/home/owner/openclaw-backup/repo, Sergey/openclaw-clawpi); слои НЕ равнозначны и НЕ заменяют друг друга; full recovery требует обоих; --include-secrets — политика State Git, НЕ распространяется на Config Git supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.2–20.3 (lines 459–508) 2026-09-24T20:57:49.604Z
2026-09-24T21:02:00+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 510–536) 2026-09-24T20:57:49.604Z
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, line 30 (OpenClaw Git Backup / Recovery) 2026-09-24T20:58:10.382Z
2026-09-24T21:02:00+03:00
text status confidence evidence updatedAt
Рутинг интентов: 'сделай backup/закоммить состояние' → State Git backup (--all --push) через setup-agent + верификация evaluator-agent; 'покажи backup' → setup-agent; 'проверь backup' → setup-agent → evaluator-agent; 'откати/восстанови' → destructive (exact SHA, верификация снапшота, safety-backup live state, остановка Gateway перед заменой БД, staged restore, post-restore validation, health-check, новый backup после); 'восстанови всю систему' → Config Git + State Git; 'посмотри предыдущий backup' ≠ rollback supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.5–20.8 (lines 538–659) 2026-09-24T20:57:49.604Z
2026-09-24T21:02:00+03:00
text status confidence evidence updatedAt
State Git safety rules (§20.9): никаких ordinary commits и non-backup-файлов (README.md — исторический контент, не трогать), без git reset --hard как замены restore, без замены БД при работающем Gateway, без restore без верификации и safety-copy, без автоудаления истории/legacy-БД, без автореактивации репо, без публичного экспорта, без history rewrite без approval; 'non-backup commits' → не создавать новое репо автоматически supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.9 (lines 661–692) 2026-09-24T20:57:49.604Z
2026-09-24T21:02:00+03:00
text status confidence evidence updatedAt
Separation of Responsibilities (§20.10): main-agent = оркестрация/рутинг/ approval/отчёты, setup-agent = инфраструктурное исполнение, evaluator-agent = вердикт; main-agent НЕ самоверифицирует инфраструктурный recovery; full procedure НЕ копируется в AGENTS.md/MEMORY.md (context-minimization §20.11) supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.10–20.11 (lines 694–732) 2026-09-24T20:57:49.604Z
2026-09-24T21:02:00+03:00
text status confidence evidence updatedAt
Integration test: /home/owner/openclaw-backup/integration-test-git-backups.sh — успех = PASS / FAIL=0 (auth, backup, commit/no-change, push, sync, scheduled mechanisms для обоих слоёв); тест диагностический, НЕ должен менять инфраструктуру; integration-test-run2.log = evidence базового теста, не operational truth supported 0.95
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.13 (lines 760–766) 2026-09-24T20:57:49.604Z
2026-09-24T21:02:00+03:00
text status confidence evidence updatedAt
Final state (MEMORY.md 2026-09-24): 24h State Git backup active; 24h Config Git backup через systemd --user timer active; полный recovery = State Git + Config Git; интеграционный тест прошёл PASS / FAIL=0; operational truth — Git-репозитории, результаты бэкапов, Config Git timer, State Git automation supported 0.9
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, line 30 (OpenClaw Git Backup / Recovery) 2026-09-24T20:58:10.382Z
2026-09-24T21:02:00+03:00
text status confidence evidence updatedAt
КОНТРАДИКЦИЯ (открытый вопрос): AGENTS.md §20.2 помечает Config Git как 'ARCHITECTURE DEFINED / CONFIGURATION NOT YET COMPLETED', при этом MEMORY.md, канонический документ (timer IMPLEMENTED/ACTIVE) и live-проверка 2026-09-24 (openclaw-config-backup.timer active, config-git-backup.sh существует, последний trigger 2026-09-24 04:35 MSK) указывают на реализованную 24h-автоматизацию Config Git; до явного решения владельца Config Git НЕ считается операционным recovery-источником (правило §20.2 в силе) disputed 0.6
kind sourceId path lines updatedAt
source-file source.agents sources/agents.md AGENTS.md §20.2 (line 473) 2026-09-24T20:57:49.604Z
kind sourceId path lines updatedAt
source-file source.memory sources/memory.md MEMORY.md §3, line 30 2026-09-24T20:58:10.382Z
2026-09-24T21:02:00+03:00

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

Summary

Двухслойный Git-бэкап OpenClaw (State Git + Config Git) с жёстким разделением ролей: канонический операционный документ — OPENCLAW-GIT-BACKUP-RECOVERY.md; main-agent никогда не исполняет инфраструктурные команды и не самоверифицируется — исполнение делегировано setup-agent, вердикт корректности — evaluator-agent.

Description

Архитектура (§20.2–20.3)

  • State Git — бэкап внутреннего состояния OpenClaw (SQLite): /home/owner/openclaw-backup/state-repo → приватный Forgejo https://git.datacloudport.ru/Sergey/openclaw-clawpi-state.git. Статус по AGENTS.md: IMPLEMENTED / ACTIVE. Scope: --all --include-secrets (политика специфична для State Git; на Config Git распространять нельзя). Репозиторий PRIVATE и содержит credential-bearing backup material.
  • Config Git — конфигурация, credentials, persistent workspace-файлы: /home/owner/openclaw-backup/repo → https://git.datacloudport.ru/Sergey/openclaw-clawpi.git. Статус по AGENTS.md §20.2: ARCHITECTURE DEFINED / CONFIGURATION NOT YET COMPLETED — противоречит MEMORY.md и каноническому документу, где 24h timer openclaw-config-backup.timer отмечен IMPLEMENTED/ACTIVE; live-проверка 2026-09-24: timer active (next trigger 2026-09-25 04:31 MSK), config-git-backup.sh (600) существует. До явной верификации Config Git НЕ является операционным recovery-источником.
  • Слой ≠ слой: State Git alone НЕ является полным бэкапом машины/системы.

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

24h State Git backup ACTIVE. Ключевое правило: активный scheduler entry — НИКОГДА не доказательство успешного бэкапа; доказательство = backup created + pushed=true или валидный noChanges=true. Сбой = pipeline degraded до диагностики + успешного прогона.

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

Интент Маршрут Ключевые требования
«сделай backup» / «закоммить состояние» main → setup-agent → evaluator-agent canonical doc → --all --push → верификация → отчёт commit/noChanges/pushed
«покажи backup» main → setup-agent история по каноническому документу
«проверь backup» main → setup-agent → evaluator-agent commit ≠ валидность; внешний успех = push; restore-eligibility = прохождение верификации снапшота
«откати» / «восстанови из backup» main → setup-agent → evaluator-agent destructive: явный запрос, exact SHA, верификация снапшота, safety-backup live state, остановка Gateway, staged restore, post-restore validation, health-check, новый backup
«восстанови всю систему» main → setup-agent → evaluator-agent Config Git + State Git; последовательность ТОЛЬКО в каноническом документе

«Посмотри предыдущий backup» — просмотр, НЕ rollback; эти действия не тождественны.

Safety rules State Git (§20.9)

Никаких ordinary commits/non-backup-файлов (наследственный README.md — исторический контент, не изменять/не удалять); без git reset --hard как замены OpenClaw restore; без деструктивной замены БД при работающем Gateway; без restore без верификации и без safety-copy live state; без автоудаления backup-истории и legacy-БД; без автореактивации репозитория; без публичного экспорта; без history rewrite без явного approval. Отчёт «repository history contains non-backup commits» → НЕ создавать новое репо автоматически, следовать канонической процедуре.

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

  • main-agent = оркестрация/рутинг/user approval/отчётность
  • setup-agent = инфраструктурное исполнение (backup/restore/репозиторий)
  • evaluator-agent = вердикт корректности (authoritative, без самоверификации main)
  • Полная процедура НЕ копируется в AGENTS.md / MEMORY.md; там только routing/authority/safety-правила и стабильные final-state-факты.
  • Mandatory Reference: любой интент backup/snapshot/restore/rollback/recovery → сначала читать OPENCLAW-GIT-BACKUP-RECOVERY.md.

Integration test (§20.13)

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

Final state (MEMORY.md, 2026-09-24)

State Git: 24h автоматический backup — active. Config Git: 24h автоматический backup через systemd --user timer — active (live-подтверждено 2026-09-24). Полный recovery использует оба слоя. Интеграционный тест: PASS / FAIL=0. Operational truth — Git-репозитории, результаты бэкапов OpenClaw, Config Git timer, State Git automation.

Tags

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

Sources

Sources