diff --git a/concepts/Git-Backup-Recovery-Protocol.md b/concepts/Git-Backup-Recovery-Protocol.md index 381a085..c2c887d 100644 --- a/concepts/Git-Backup-Recovery-Protocol.md +++ b/concepts/Git-Backup-Recovery-Protocol.md @@ -1,7 +1,7 @@ --- id: concept-git-backup-recovery-protocol pageType: concept -updatedAt: 2026-09-24T21:02:00+03:00 +updatedAt: 2026-09-26T16:15:48+03:00 sourceIds: - source.agents - source.memory @@ -10,36 +10,46 @@ tags: - recovery - state-git - config-git + - obsidian-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) и НЕ воспроизводить процедуру из памяти" + (Mandatory Reference Rule, §20.21) и НЕ воспроизводить процедуру из памяти" 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" + lines: "AGENTS.md §20.1 (lines 460–482), §20.21 (lines 1146–1174)" + updatedAt: "2026-09-26T11:54:39.969Z" + updatedAt: 2026-09-26T16:15:48+03:00 + - text: "Трёхслойная архитектура: State Git (/home/owner/openclaw-backup/state-repo, + приватный Forgejo Sergey/openclaw-clawpi-state, native openclaw backup git + с scope --all --include-secrets --push) + Config Git (/home/owner/openclaw-backup/repo, + Sergey/openclaw-clawpi, отдельные credentials OPENCLAW_CONFIG_GIT_TOKEN + + временный GIT_ASKPASS) + Obsidian Git (/home/owner/obsidian-vault, + Sergey/obsidian-vault); три независимых репозитория с независимыми + lifecycle/recovery-механизмами; НЕ объединяются в один backup repository; + успешный backup одного слоя НЕ является успехом остальных; --include-secrets — + политика только State Git; статус по §20.23 (2026-09-26): все слои ACTIVE" 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 + lines: "AGENTS.md §20.2 (lines 484–515), §20.3 (lines 517–561), §20.5 (lines 599–653), §20.7 (lines 683–734), §20.23 (lines 1226–1260)" + updatedAt: "2026-09-26T11:54:39.969Z" + - kind: source-file + sourceId: source.memory + path: sources/memory.md + lines: "MEMORY.md §3, lines 52–58 (OpenClaw Git Backup / Recovery)" + updatedAt: "2026-09-26T11:56:18.417Z" + updatedAt: 2026-09-26T16:15:48+03:00 - text: "24h автоматический State Git backup ACTIVE — production-механизм, отключать только по явному приказу пользователя; 'автоматизация включена' ≠ 'backup успешен': здоровье доказывают 'backup created + pushed=true' @@ -51,185 +61,286 @@ claims: - 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" + lines: "AGENTS.md §20.4 (lines 563–597)" + updatedAt: "2026-09-26T11:54:39.969Z" - 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" + lines: "MEMORY.md §3, lines 52–54 (OpenClaw Git Backup / Recovery, State Git)" + updatedAt: "2026-09-26T11:56:18.417Z" + updatedAt: 2026-09-26T16:15:48+03:00 + - text: "Obsidian Git (третий независимый слой): host cron */15 → + /usr/local/bin/obsidian-docker-sync.sh → Docker obsidian-git-sync + (commit+push только при изменениях, лог /home/owner/obsidian-sync.log); + SSH Ed25519 Deploy Key /home/owner/.ssh/obsidian-vault-sync (Write Access) + + dedicated known_hosts /home/owner/.ssh/obsidian-vault-known_hosts, + IdentitiesOnly=yes, StrictHostKeyChecking=yes, BatchMode=yes; + host ~/.git-credentials НЕ используется для аутентификации и НЕ монтируется + в Docker-контейнер; concurrency protection — flock /tmp/obsidian-docker-sync.lock + (конкурентный запуск завершается без изменений репозитория); + НЕ часть native openclaw backup git; независимый lifecycle и recovery" 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' → не создавать новое репо автоматически" + lines: "AGENTS.md §20.7 (lines 683–734), §20.8 (lines 736–791), §20.9 (lines 793–833), §20.10 (lines 835–848)" + updatedAt: "2026-09-26T11:54:39.969Z" + - kind: source-file + sourceId: source.memory + path: sources/memory.md + lines: "MEMORY.md §3, lines 56, 60, 62 (Obsidian Git)" + updatedAt: "2026-09-26T11:56:18.417Z" + updatedAt: 2026-09-26T16:15:48+03:00 + - text: "Рутинг интентов (§20.11–20.16): 'сделай backup/закоммить состояние' + (default) → State Git backup (--all + push) через setup-agent + верификация + evaluator-agent; явный 'Config backup' → Config Git; явный 'сохрани Obsidian' + → Obsidian Git; 'проверь Obsidian backup' → cron → фактическое исполнение + скрипта → результат синхронизации → local/remote HEAD (наличие cron-записи + само по себе НЕ доказательство); 'полный backup' → все три слоя, каждый слой + отчитывается отдельно (SUCCESS/NO CHANGES/FAILED; частичный результат ≠ + полный успех); 'откати/восстанови' → destructive (exact revision, + верификация снапшота, safety-backup live state, остановка Gateway перед + заменой БД, staged restore, post-restore validation, health-check, новый + backup); 'восстанови всю систему' → State + Config + Obsidian Git + (последовательность ТОЛЬКО в каноническом документе); + 'покажи предыдущий backup' — просмотр, НЕ rollback" 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 = оркестрация/рутинг/ + lines: "AGENTS.md §20.11–20.16 (lines 851–1047)" + updatedAt: "2026-09-26T11:54:39.969Z" + updatedAt: 2026-09-26T16:15:48+03:00 + - text: "State Git safety rules (§20.17): никаких ordinary commits и + non-backup-файлов, без git reset --hard как замены OpenClaw restore, без + замены live-БД при работающем Gateway, без restore без верификации снапшота + и без safety-copy live state, без автоудаления backup-истории/legacy-БД, без + авторекреации репозитория, без публичного экспорта, без history rewrite без + явного user approval; 'non-backup commits' → НЕ создавать новое репо + автоматически, следовать канонической процедуре; Obsidian Git safety rules + (§20.18): запрет авто-удаления репо/.git, git init, git reset --hard, + git push --force, замены Forgejo-репозитория, перезаписи remote-истории; + сбой синхронизации НЕ является причиной рекреации репозитория" + status: supported + confidence: 0.95 + evidence: + - kind: source-file + sourceId: source.agents + path: sources/agents.md + lines: "AGENTS.md §20.17 (lines 1049–1075), §20.18 (lines 1077–1095)" + updatedAt: "2026-09-26T11:54:39.969Z" + updatedAt: 2026-09-26T16:15:48+03:00 + - text: "Separation of Responsibilities (§20.19): main-agent = оркестрация/рутинг/ approval/отчёты, setup-agent = инфраструктурное исполнение, - evaluator-agent = вердикт; main-agent НЕ самоверифицирует инфраструктурный - recovery; full procedure НЕ копируется в AGENTS.md/MEMORY.md - (context-minimization §20.11)" + evaluator-agent = вердикт корректности (authoritative); main-agent НЕ + самоверифицирует инфраструктурные изменения; полная процедура НЕ копируется + в AGENTS.md/MEMORY.md (context-minimization §20.20) — там только + routing/authority/safety-правила и стабильные architectural facts" 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 + lines: "AGENTS.md §20.19–20.20 (lines 1097–1144)" + updatedAt: "2026-09-26T11:54:39.969Z" + updatedAt: 2026-09-26T16:15:48+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" + успех = PASS / FAIL=0; валидирует State Git и Config Git (authentication, + backup, commit/no-change handling, push, local/remote synchronization, + scheduled mechanisms); тест диагностический, НЕ должен менять + инфраструктуру/credentials/remotes/automation/историю; + integration-test-run2.log = evidence базового теста, не operational truth; + Obsidian Git проверяется отдельно из-за независимого lifecycle и + synchronization-механизма" 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: + lines: "AGENTS.md §20.22 (lines 1176–1224)" + updatedAt: "2026-09-26T11:54:39.969Z" - 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 + lines: "MEMORY.md §3, line 64 (Integration test, Obsidian Git отдельно)" + updatedAt: "2026-09-26T11:56:18.417Z" + updatedAt: 2026-09-26T16:15:48+03:00 + - text: "Final state (2026-09-26, AGENTS.md §20.23 + MEMORY.md §3): все три слоя + ACTIVE/operational, private Forgejo, независимы — State Git (24h, native + openclaw backup git, --all --include-secrets --push), Config Git (24h, + systemd --user timer, отдельные credentials), Obsidian Git (cron */15, + Docker-синхронизация, SSH Deploy Key); integration test ранее прошёл + PASS / FAIL=0 (State+Config); operational truth — Git-репозитории, + результаты бэкапов, automation (timer/cron)" + status: supported + confidence: 0.95 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" + lines: "AGENTS.md §20.23 (lines 1226–1260)" + updatedAt: "2026-09-26T11:54:39.969Z" - 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 + lines: "MEMORY.md §3, lines 52–66 (OpenClaw Git Backup / Recovery)" + updatedAt: "2026-09-26T11:56:18.417Z" + updatedAt: 2026-09-26T16:15:48+03:00 + - text: "РАЗРЕШЁННОЕ противоречие (было открытым на 2026-09-24): старый AGENTS.md + §20.2 помечал Config Git как 'ARCHITECTURE DEFINED / CONFIGURATION NOT YET + COMPLETED', при этом MEMORY.md и канонический документ указывали на + реализованную 24h-автоматизацию; переписанный AGENTS.md (2026-09-26) + разрешает противоречие: §20.5 помечает Config Git IMPLEMENTED / ACTIVE + (backup/restore-скрипты, systemd user timer), §20.23 (2026-09-26) помечает + все три слоя ACTIVE/operational" + status: supported + confidence: 0.95 + evidence: + - kind: source-file + sourceId: source.agents + path: sources/agents.md + lines: "AGENTS.md §20.5 (lines 599–653, line 625 IMPLEMENTED / ACTIVE), §20.23 (lines 1238–1241)" + updatedAt: "2026-09-26T11:54:39.969Z" + - kind: source-file + sourceId: source.memory + path: sources/memory.md + lines: "MEMORY.md §3, line 55 (Config Git, systemd --user timer)" + updatedAt: "2026-09-26T11:56:18.417Z" + updatedAt: 2026-09-26T16:15:48+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. +Трёхслойный Git-бэкап OpenClaw (State Git + Config Git + Obsidian Git) с жёстким +разделением ролей: канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; +main-agent никогда не исполняет инфраструктурные команды и не самоверифицируется — +исполнение делегировано setup-agent, вердикт корректности — evaluator-agent. +Статус 2026-09-26 (§20.23): все три слоя ACTIVE/operational, private Forgejo, независимы. ## Description -### Архитектура (§20.2–20.3) -- **State Git** — бэкап внутреннего состояния OpenClaw (SQLite): +### Архитектура (§20.2, 20.3, 20.5, 20.7) +Три независимых Git-слоя — три независимых репозитория и три независимых +lifecycle/recovery-механизма. Слои MUST NOT объединяться в один backup repository; +успешный backup одного слоя MUST NOT сообщаться как успех остальных слоёв. +- **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-файлы: + `https://git.datacloudport.ru/Sergey/openclaw-clawpi-state.git`. Статус: + IMPLEMENTED / ACTIVE. Native `openclaw backup git` с scope + `--all --include-secrets --push`; `--include-secrets` — политика ТОЛЬКО State Git, + НЕ распространяется на Config/Obsidian Git. Репозиторий PRIVATE и содержит + credential-bearing backup material. +- **Config Git** — конфигурация, credentials, selected persistent-файлы: `/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 НЕ является полным бэкапом машины/системы. + Статус: IMPLEMENTED / ACTIVE (§20.5). Скрипты `config-git-backup.sh` / + `config-git-restore.sh`; автоматизация — systemd user timer + `openclaw-config-backup.{service,timer}`. Независим от State Git; отдельные + credentials (§20.6: `OPENCLAW_CONFIG_GIT_TOKEN` в `/home/owner/.openclaw/.env` + + временный `GIT_ASKPASS`, временное auth-состояние чистится после исполнения); + НЕ заменяется native State Git backup. +- **Obsidian Git** — knowledge vault / Markdown / документация: + `/home/owner/obsidian-vault` → `git@git.datacloudport.ru:Sergey/obsidian-vault.git`. + Статус: IMPLEMENTED / ACTIVE (§20.7). НЕ является частью State Git и Config Git; + MUST NOT добавляться в native `openclaw backup git` pipeline. -### Автоматический backup (§20.4) -24h State Git backup ACTIVE. Ключевое правило: активный scheduler entry — НИКОГДА -не доказательство успешного бэкапа; доказательство = `backup created + pushed=true` -или валидный `noChanges=true`. Сбой = pipeline degraded до диагностики + успешного прогона. +### Автоматический backup (§20.4, 20.5, 20.8) +- **State Git**: 24h OpenClaw scheduled backup — production-механизм, отключается + только по явному приказу пользователя. Ключевое правило: активный scheduler entry — + НИКОГДА не доказательство успешного бэкапа; доказательство = `backup created + + pushed=true` или валидный `noChanges=true`. Сбой = pipeline degraded до + диагностики + успешного прогона. +- **Config Git**: 24h через `systemd --user` timer `openclaw-config-backup.timer`. +- **Obsidian Git**: host cron `*/15 * * * *` → `/usr/local/bin/obsidian-docker-sync.sh` + → Docker `obsidian-git-sync` → при изменениях: commit + push (лог + `/home/owner/obsidian-sync.log`); без изменений — commit не создаётся + («Нет изменений.»). Concurrency protection: `flock` на + `/tmp/obsidian-docker-sync.lock`; конкурентный запуск MUST завершиться без + изменений репозитория (§20.10). -### Рутинг по интентам пользователя (§20.5–20.8) +### Безопасность Obsidian Git (§20.9) +Dedicated SSH Ed25519 key `/home/owner/.ssh/obsidian-vault-sync` (Forgejo Deploy Key +с Write Access); dedicated `known_hosts` +`/home/owner/.ssh/obsidian-vault-known_hosts`; `IdentitiesOnly=yes`, +`StrictHostKeyChecking=yes`, `BatchMode=yes`; host `~/.git-credentials` MUST NOT +использоваться для аутентификации и MUST NOT монтироваться в Docker-контейнер; +пароли/токены MUST NOT встроены в `obsidian-docker-sync.sh`. + +### Рутинг по интентам пользователя (§20.11–20.16) | Интент | Маршрут | Ключевые требования | |---|---|---| -| «сделай 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» / «закоммить состояние» (default) | main → setup-agent → evaluator-agent | canonical doc → State Git `--all` + push → верификация → отчёт | +| «Config backup» (явно) | main → setup-agent → evaluator-agent | Config Git по каноническому документу | +| «сохрани Obsidian» / «сделай backup Obsidian» (явно) | main → setup-agent → evaluator-agent | Obsidian Git | +| «проверь Obsidian backup» | main → setup-agent → evaluator-agent | cron → фактическое исполнение скрипта → результат синхронизации → local HEAD → remote HEAD; наличие cron-записи ≠ успех | +| «полный backup» | main → setup-agent → evaluator-agent | все три слоя (State + Config + Obsidian); каждый слой отчитывается отдельно (SUCCESS / NO CHANGES / FAILED); частичный результат ≠ «полный backup успешен» | +| «откати» / «восстанови из backup» | main → setup-agent → evaluator-agent | destructive: явный запрос, exact revision, canonical doc, верификация снапшота, safety-copy live state, остановка Gateway, staged restore, post-restore validation, health-check, новый backup | +| «восстанови всю систему» | main → setup-agent → evaluator-agent | Full System Recovery = State + Config + Obsidian Git (§20.16); последовательность ТОЛЬКО в каноническом документе | +| «покажи/посмотри предыдущий backup» | main → setup-agent | только просмотр; НЕ интерпретировать как rollback | -«Посмотри предыдущий backup» — просмотр, НЕ rollback; эти действия не тождественны. +Backup Verification (§20.14): активный scheduler — недостаточное доказательство; +верификация только по фактическому execution evidence: State Git — backup result / +pushed=true / noChanges=true; Config Git — исполнение скрипта, commit/no-change, +push, local/remote sync; Obsidian Git — исполнение cron, результат скрипта, +local/remote HEAD. При проблемах синхронизации авторитетно состояние remote-репозитория. -### 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» → -НЕ создавать новое репо автоматически, следовать канонической процедуре. +### Safety rules (State §20.17, Obsidian §20.18) +- **State Git**: никаких ordinary commits и non-backup-файлов; без `git reset --hard` + как замены OpenClaw restore; без замены live-БД при работающем Gateway; без restore + без верификации снапшота и без safety-copy live state; без автоудаления + backup-истории и legacy-БД; без авторекреации репозитория; без публичного экспорта; + без history rewrite без явного user approval. Отчёт «repository history contains + non-backup commits» → НЕ создавать новое репо автоматически, следовать канонической + процедуре. +- **Obsidian Git**: MUST NOT автоматически — удалять репозиторий/`.git`, `git init`, + `git reset --hard`, `git push --force`, заменять Forgejo-репозиторий, переписывать + remote-историю. Сбой синхронизации НЕ является причиной рекреации репозитория: + сохранить локальное репо и сначала определить точный сбой. -### Ответственность и минимизация контекста (§20.10–20.12) -- main-agent = оркестрация/рутинг/user approval/отчётность +### Ответственность и минимизация контекста (§20.19–20.20) +- main-agent = оркестрация/рутинг/user approval/отчётность (НЕ самоверификация + инфраструктурных мутаций) - setup-agent = инфраструктурное исполнение (backup/restore/репозиторий) -- evaluator-agent = вердикт корректности (authoritative, без самоверификации main) +- evaluator-agent = вердикт корректности (authoritative) - Полная процедура НЕ копируется в AGENTS.md / MEMORY.md; там только - routing/authority/safety-правила и стабильные final-state-факты. -- Mandatory Reference: любой интент backup/snapshot/restore/rollback/recovery → - сначала читать `OPENCLAW-GIT-BACKUP-RECOVERY.md`. + routing/authority/safety-правила и стабильные architectural facts. -### 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. +### Mandatory Reference Rule (§20.21) +Любой интент backup/snapshot/commit state/restore/rollback/recovery/disaster +recovery/recover OpenClaw|database|configuration|Obsidian → сначала читать +`OPENCLAW-GIT-BACKUP-RECOVERY.md`. -### 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. +### Integration test (§20.22) +`/home/owner/openclaw-backup/integration-test-git-backups.sh`: успех = `PASS / FAIL=0`. +Валидирует State Git и Config Git (аутентификация, backup, commit/no-change handling, +push, local/remote synchronization, scheduled mechanisms). Тест диагностический: +НЕ модифицирует инфраструктуру, credentials, remotes, automation, историю. Детальный +вывод `integration-test-run2.log` — evidence успешного базового теста, НЕ operational +source of truth. Obsidian Git проверяется отдельно — независимый lifecycle и +synchronization-механизм. + +### Final state (§20.23, 2026-09-26) +Все три слоя ACTIVE/operational, private Forgejo, независимы: +- **State Git**: ACTIVE, каждые 24h (native OpenClaw backup). +- **Config Git**: ACTIVE, systemd user timer. +- **Obsidian Git**: ACTIVE, cron */15, Docker-синхронизация, SSH Deploy Key. + +Противоречие 2026-09-24 про Config Git («NOT YET COMPLETED») разрешено: переписанный +AGENTS.md §20.5 помечает Config Git IMPLEMENTED / ACTIVE, §20.23 (2026-09-26) — все +слои ACTIVE. Operational truth — Git-репозитории, результаты бэкапов, +automation (timer/cron). ## Tags - git-backup - recovery - state-git - config-git +- obsidian-git - disaster-recovery - openclaw diff --git a/entities/Infrastructure.md b/entities/Infrastructure.md index e0e5932..cab4513 100644 --- a/entities/Infrastructure.md +++ b/entities/Infrastructure.md @@ -1,7 +1,7 @@ --- id: entity-Infrastructure pageType: entity -updatedAt: 2026-09-10T04:50:00.000Z +updatedAt: 2026-09-26T16:17:10+03:00 confidence: 0.9 status: active sourceIds: @@ -327,7 +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 +- OpenClaw Git backup/recovery (AGENTS.md §20, трёхслойная архитектура, final state 2026-09-26 по §20.23): State Git `/home/owner/openclaw-backup/state-repo` → приватный Forgejo `Sergey/openclaw-clawpi-state` (native `openclaw backup git`, `--all --include-secrets --push`, 24h автоматический backup ACTIVE) + Config Git `/home/owner/openclaw-backup/repo` → `Sergey/openclaw-clawpi` (24h через `systemd --user` timer, отдельные credentials `OPENCLAW_CONFIG_GIT_TOKEN` + временный `GIT_ASKPASS`) + Obsidian Git `/home/owner/obsidian-vault` → `Sergey/obsidian-vault` (host cron */15 → Docker `obsidian-git-sync`, SSH Ed25519 Deploy Key, dedicated `known_hosts`, host `~/.git-credentials` не монтируется в контейнер); три слоя независимы и НЕ объединяются в один backup repository; противоречие 2026-09-24 про Config Git «NOT YET COMPLETED» разрешено — AGENTS.md §20.5/§20.23 (2026-09-26) помечает Config Git IMPLEMENTED/ACTIVE, все три слоя ACTIVE/operational; канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; интеграционный тест `integration-test-git-backups.sh` (успех = PASS/FAIL=0; валидирует State+Config Git, Obsidian Git проверяется отдельно); full recovery = State + Config + Obsidian 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 diff --git a/index.md b/index.md index 5942da4..81d815c 100644 --- a/index.md +++ b/index.md @@ -4,7 +4,7 @@ - Render mode: `native` - Total pages: 79 -- Claims: 162 +- Claims: 163 - Sources: 36 - Entities: 11 - Concepts: 13 diff --git a/reports/provenance-coverage.md b/reports/provenance-coverage.md index 36462e2..ea07535 100644 --- a/reports/provenance-coverage.md +++ b/reports/provenance-coverage.md @@ -3,23 +3,23 @@ pageType: report id: report.provenance-coverage title: Provenance Coverage status: active -updatedAt: 2026-09-24T21:15:40.281Z +updatedAt: 2026-09-26T13:17:28.017Z --- # Provenance Coverage ## Generated -- Evidence entries: 189 +- Evidence entries: 194 - Claims missing evidence: 0 ### Evidence Classes -- source-file: 188 +- source-file: 193 - file: 1 ### Top Evidence Sources -- source.memory: 87 -- source.agents: 30 +- source.memory: 90 +- source.agents: 32 - source.bridge-workspace-4c6d747f-memory-2d62c497: 22 - source.user: 18 - source.embedding-trading: 14