Auto-sync 2026-09-24 21:15:02
This commit is contained in:
parent
fb4e3ab53a
commit
f70a93f7c8
2 changed files with 244 additions and 0 deletions
242
concepts/Git-Backup-Recovery-Protocol.md
Normal file
242
concepts/Git-Backup-Recovery-Protocol.md
Normal file
|
|
@ -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
|
||||||
|
<!-- openclaw:wiki:related:start -->
|
||||||
|
<!-- openclaw:wiki:related:end -->
|
||||||
|
|
@ -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
|
- 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)
|
- 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-теста
|
- 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 (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 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
|
- 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
|
- searxng
|
||||||
- samba
|
- samba
|
||||||
- pihole
|
- pihole
|
||||||
|
- git-backup
|
||||||
|
|
||||||
## Sources
|
## Sources
|
||||||
- [[USER.md]]
|
- [[USER.md]]
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue