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

242 lines
15 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-09-24T21:02:00+03:00
sourceIds:
- source.agents
- source.memory
tags:
- git-backup
- recovery
- state-git
- config-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) и НЕ воспроизводить процедуру из памяти"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.1, §20.12 (lines 437–760)"
updatedAt: "2026-09-24T20:57:49.604Z"
updatedAt: 2026-09-24T21:02:00+03:00
- text: "Двухслойная архитектура: 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"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.2–20.3 (lines 459–508)"
updatedAt: "2026-09-24T20:57:49.604Z"
updatedAt: 2026-09-24T21:02:00+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 510–536)"
updatedAt: "2026-09-24T20:57:49.604Z"
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, line 30 (OpenClaw Git Backup / Recovery)"
updatedAt: "2026-09-24T20:58:10.382Z"
updatedAt: 2026-09-24T21:02:00+03:00
- text: "Рутинг интентов: 'сделай 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"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.5–20.8 (lines 538–659)"
updatedAt: "2026-09-24T20:57:49.604Z"
updatedAt: 2026-09-24T21:02:00+03:00
- text: "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' → не создавать новое репо автоматически"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.9 (lines 661–692)"
updatedAt: "2026-09-24T20:57:49.604Z"
updatedAt: 2026-09-24T21:02:00+03:00
- text: "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)"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.10–20.11 (lines 694–732)"
updatedAt: "2026-09-24T20:57:49.604Z"
updatedAt: 2026-09-24T21:02:00+03:00
- text: "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"
status: supported
confidence: 0.95
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.13 (lines 760–766)"
updatedAt: "2026-09-24T20:57:49.604Z"
updatedAt: 2026-09-24T21:02:00+03:00
- text: "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"
status: supported
confidence: 0.9
evidence:
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, line 30 (OpenClaw Git Backup / Recovery)"
updatedAt: "2026-09-24T20:58:10.382Z"
updatedAt: 2026-09-24T21:02:00+03:00
- text: "КОНТРАДИКЦИЯ (открытый вопрос): 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 в силе)"
status: disputed
confidence: 0.6
evidence:
- kind: source-file
sourceId: source.agents
path: sources/agents.md
lines: "AGENTS.md §20.2 (line 473)"
updatedAt: "2026-09-24T20:57:49.604Z"
- kind: source-file
sourceId: source.memory
path: sources/memory.md
lines: "MEMORY.md §3, line 30"
updatedAt: "2026-09-24T20:58:10.382Z"
updatedAt: 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
- [[AGENTS.md]]
- [[MEMORY.md]]
## Related
<!-- openclaw:wiki:related:start -->
<!-- openclaw:wiki:related:end -->