242 lines
15 KiB
Markdown
242 lines
15 KiB
Markdown
---
|
||
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 -->
|