From d8d2c4f32d75af42ef9e2e9117d8c87351918d8e Mon Sep 17 00:00:00 2001 From: AIOSAI Date: Wed, 24 Jun 2026 07:00:36 -0700 Subject: [PATCH] docs(memory,flow): cross-ref shared .backup/ namespace + drop stale prax/.backupignore Completes the backup-docs sweep (td-218): - @memory README: note rollover writes rollover_backup_*.json to /.backup/ - @flow README: note closed plans archive to /.backup/processed_plans/ both cross-referencing @backup's canonical README. - Removed orphaned src/aipass/prax/.backupignore (prax is not a registered backup target; only the AIPass project root is). seedgo green across all three (@flow 100, @memory 100, @prax 99 = pre-existing Json_Handler, unrelated). Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01QEQZXCtgnF3NQtcttTErpq --- CHANGELOG.md | 2 ++ src/aipass/flow/README.md | 2 ++ src/aipass/memory/README.md | 2 ++ src/aipass/prax/.backupignore | 39 ----------------------------------- 4 files changed, 6 insertions(+), 39 deletions(-) delete mode 100644 src/aipass/prax/.backupignore diff --git a/CHANGELOG.md b/CHANGELOG.md index 5c75a389..697ece78 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -45,6 +45,8 @@ PyPI version — not the changelog header. were fixed. Root README lists @backup and documents `.backupignore`; the navmap was corrected. The shipped root `/.backupignore` was realigned to `BUILTIN_IGNORES` (dropped stale `.backup_system/` + over-broad `*logs`). + @memory and @flow READMEs now cross-reference their `.backup/` writes, and the + orphaned `prax/.backupignore` (a stale per-branch config) was removed. ## [2026-06-23] diff --git a/src/aipass/flow/README.md b/src/aipass/flow/README.md index 42413763..369fae7b 100644 --- a/src/aipass/flow/README.md +++ b/src/aipass/flow/README.md @@ -146,6 +146,8 @@ On `drone @flow close`: Vector verification displays in console: "Vectorized: N chunks in chroma" or "NOT vectorized". +Closed plans are archived to `/.backup/processed_plans/`, a shared runtime namespace managed by `@backup` (see `src/aipass/backup/README.md`) and consumed by `@memory` for vectorization. + --- ## Integration Points diff --git a/src/aipass/memory/README.md b/src/aipass/memory/README.md index 0bd04cbf..d00c5571 100644 --- a/src/aipass/memory/README.md +++ b/src/aipass/memory/README.md @@ -87,6 +87,8 @@ detector.check_all_branches() # scan AIPASS_REGISTRY.json + external regi → trim source file # write back with oldest removed ``` +Rollover writes safety copies (`rollover_backup_*.json`) into `/.backup/` — a shared runtime namespace (see `@backup`'s README for all writers). + ### Subprocess Isolation All ML operations (fastembed, chromadb) run via subprocess. The main process never imports these libraries. Python interpreter resolved via `_get_memory_python()` (env var `AIPASS_MEMORY_PYTHON` → `memory/.venv/bin/python` → `sys.executable`). diff --git a/src/aipass/prax/.backupignore b/src/aipass/prax/.backupignore deleted file mode 100644 index aef1a733..00000000 --- a/src/aipass/prax/.backupignore +++ /dev/null @@ -1,39 +0,0 @@ -# Backup System ignore patterns (gitignore-style) -# Lines starting with # are comments. Blank lines are ignored. - -# Backup system's own directory -.backup_system/ - -# Version control -.git/ -.svn/ -.hg/ - -# Python -__pycache__/ -*.pyc -*.pyo -*.egg-info/ -.venv/ -venv/ -.tox/ - -# Node -node_modules/ - -# IDE -.vscode/ -.idea/ -*.swp -*.swo - -# OS -.DS_Store -Thumbs.db - -# Build artifacts -build/ -dist/ - -# Logs -*.log