diff --git a/concepts/Git-Backup-Recovery-Protocol.md b/concepts/Git-Backup-Recovery-Protocol.md new file mode 100644 index 0000000..24acd53 --- /dev/null +++ b/concepts/Git-Backup-Recovery-Protocol.md @@ -0,0 +1,242 @@ +--- +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 + + diff --git a/entities/Infrastructure.md b/entities/Infrastructure.md index 90d3d2c..1ec8591 100644 --- a/entities/Infrastructure.md +++ b/entities/Infrastructure.md @@ -327,6 +327,7 @@ claims: - Diagnostic Command Convention (§18, AGENTS.md 2026-08-22): read-only verification chains (grep, head, wc, ls, file-existence checks, diff-checks) MUST end with neutral exit (`; true` / `|| true`) so "no match" is valid result not Exec failed; exit codes of mutation/build/deploy/sync commands must NEVER be masked - Ingest self-loop root fix (2026-08-22, user decision): volatile wiki state (page/claim counts, lint counts, last-ingest timestamps, bridge artifact counts) НЕ пишется в MEMORY.md и source-файлы — источник: CHANGELOG.md + concepts/Bridge-Mode.md; правило закреплено: AGENTS.md §16 «Volatile-state ban» + constraint в payload cron wiki-ingest-event; причина: такие записи сами бампали mtime MEMORY.md → cron (30m) видел «изменение источника» → idempotent self-loop (2026-08-22: 6 циклов 00:32→08:09 при semantic delta=0) - north-mini-code-1.0 CANCELLED (2026-08-22, user decision): не устанавливать, не использовать; на Dell Precision 5560 (Ollama, 18 моделей) не установлен; решение закрыло 3-дневное ожидание установки (08-19→08-22) и план 3-модельного coding-теста +- OpenClaw Git backup/recovery (AGENTS.md §20, 2026-09-24): два слоя — State Git `/home/owner/openclaw-backup/state-repo` → приватный Forgejo `Sergey/openclaw-clawpi-state` (scope `--all --include-secrets`, 24h автоматический backup ACTIVE) + Config Git `/home/owner/openclaw-backup/repo` → `Sergey/openclaw-clawpi` (24h через `systemd --user` timer `openclaw-config-backup.timer`, live-active 2026-09-24); AGENTS.md §20.2 при этом помечает Config Git «NOT YET COMPLETED» — contradicts MEMORY.md/канон-дока, открытый вопрос; канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; интеграционный тест `integration-test-git-backups.sh` (успех = PASS/FAIL=0); full recovery = State + Config Git; детали — concepts/Git-Backup-Recovery-Protocol.md - Pi-hole (FTL v6) на clawpi (проверено 2026-08-24): контейнер pihole (docker на clawpi, healthy); Web UI http://192.168.1.20:8080/admin, DNS 192.168.1.20:53; версии Core v6.4.3, Web v6.6, FTL v6.7 (снимок 2026-08-24) - Pi-hole v6 аутентификация: пароль Web UI = env `FTLCONF_webserver_api_password` контейнера (значение НЕ фиксируется в wiki/CHANGELOG/MEMORY.md — файлы синкаются в Nextcloud); хеш `pwhash` (BALLOON-SHA256) в /etc/pihole/pihole.toml; `setupVars.conf` в v6 отсутствует (заменён pihole.toml) - Pi-hole API-логин: POST /api/auth JSON `{"password":"*** env FTLCONF_webserver_api_password>","totp":null}` → session.sid; дальнейшие запросы — с сессионным cookie; проверено 2026-08-24: логин через Web UI (браузер) и API (200 + SID) — работает. Внимание: локальная проверка BALLOON-SHA256 в чистом Python дала ложный NO MATCH (сломанный test-vector в реализации) — верификацию пароля делать только через живой API @@ -341,6 +342,7 @@ claims: - searxng - samba - pihole +- git-backup ## Sources - [[USER.md]]