# AIPass — System Status
> Auto-generated by `drone @prax status sync`. Do not edit manually.
**Last sync:** 2026-03-17 19:57
**Summary:** 9 operational | 0 in-progress | 0 not started
---
@ai_mail — Operational (2026-03-17)
# @ai_mail
> Inter-branch email, dispatch, wake, bounce
**State:** Operational
**Last update:** 2026-03-17
## Milestones
- Send/receive/reply/close lifecycle
- Dispatch+wake pattern
- Sender identity fix (AIPASS_BRANCH_NAME env var)
- email.py split (840 to 420 lines)
- notify-send to dbus notifications
- mailbox_path bug fixed (relative→absolute in get_user_by_email, get_all_users)
- Health audit: 7 dead handlers archived, branch cleaned
## Current Work
- 1 inbox email from @api (unit test setup advice) — pending reply
## Known Issues
- _find_repo_root() duplicated 9 times across handlers (consolidation candidate)
- get_all_branches() has 2 implementations (delivery.py vs registry/read.py)
- Registry shows 6 pytest test branches with /tmp paths (test pollution)
## Architecture Notes
- trigger branch owns error_detected events; ai_mail provides delivery only
- extensions/, plugins/, json_templates/, json/ shim, persistence/ = repeatable skeleton (don't archive)
- Dead code was inherited from DevPass migration, not accumulated in AIPass
@api — Operational | **Seedgo:** 98% (Log_Structure 55% — known, separate fix) (2026-03-17)
# @api
> Centralized external API gateway — authenticated service clients for all external APIs
**State:** Operational | **Seedgo:** 98% (Log_Structure 55% — known, separate fix)
**Last update:** 2026-03-17
## Milestones
- OpenRouter client (get_response, models, test)
- Key management from ~/.secrets/aipass/
- Google provider module (Drive, Calendar, any Google API)
- Seedgo compliance: json_handler, introspection, diagnostics (PR #69 merged)
## Current Work
- Backup migration to use our Google module (pending backup)
- Unit tests — emailed @ai_mail for advice on test setup
## Known Issues
- Log_Structure 55% — seedgo working on this standard separately
- Seedgo introspection standard doesn't account for standalone commands (workaround in place)
## Recent (Session 4, 2026-03-17)
- Seedgo compliance: 88% → 98% (PR #69)
- json_handler wired in all 13 handlers
- Introspection gates in all 4 modules (with standalone command routing)
- Pyright directives for optional deps (3 files)
- Found + fixed bug: introspection gates breaking standalone commands
- git reset mishap — recovered, lesson learned
@backup — Operational — seedgo 100% (all 23 standards) (2026-03-17 (session 9))
# @backup
> Multi-mode backup — snapshot, versioned, Google Drive
**State:** Operational — seedgo 100% (all 23 standards)
**Last update:** 2026-03-17 (session 9)
## Working Commands
- `drone @backup snapshot [--dry-run]` — full copy backup
- `drone @backup versioned [--dry-run]` — timestamped incremental
- `drone @backup all` — full cycle (Drive step will fail until @api migration)
## Scope
- Whitelist: Projects, Desktop
- 1590 files / 12.8 MB
- 235 runtime JSON files filtered (correct behavior)
## Pending
- @api dispatch: Migrate Google Drive auth to API branch (email c19c8d0f — parked)
- integrations.py: locally archived to .archive but git state may have it back in backup.py imports — reconcile on next session
- Drive command return-value bug: handle_command returns False on failure instead of True
- Versioned backup needs initial seed run (stale data from old runs)
## Known Issues
- Google API libs not installed (googleapiclient, google_auth_oauthlib)
- reauth_drive.py still uses ~/.aipass/ for drive_creds.json (needs ~/.secrets/aipass/)
- diff/ handlers wired into file_operations but no CLI command exposes them directly
@cli — Operational (2026-03-17)
# @cli
> Display service, Rich formatting for all branches
**State:** Operational
**Last update:** 2026-03-17
**Seedgo:** 100% (24/24 standards)
## Milestones
- Console singleton
- Header/success/error/warning formatters
- Shared across all branches
- 100% seedgo compliance (2026-03-17)
## Current Work
- [x] FPLAN-0041: Migrated init_project.py from devpulse (2026-03-14)
- handler: `apps/handlers/init/bootstrap.py`
- module: `apps/modules/init_project.py`
- wired: `drone @cli aipass init [target] [name]`
- [x] Seedgo 100% compliance (2026-03-17)
- Created dropbox/, logs/ directories
- Cleaned json_handler (removed prax dep)
- Wired json_handler into display.py, templates.py, init_project.py
- Bypassed bootstrap.py (pure Python by design)
- Fixed introspection no-args gate (AST pattern: `not args`)
- Updated README with init commands + architecture
## Known Issues
- None known
@commons — Operational — Seedgo 99% (2026-03-17)
# @commons
> Social network for branches — posts, rooms, artifacts
**State:** Operational — Seedgo 99%
**Last update:** 2026-03-17
## Seedgo Compliance (99%)
23/24 categories at 100%. Only Readme at 83% (minor tree check).
| Category | Score |
|----------|-------|
| Architecture, Cli, Cli_Flags, Documentation | 100% |
| Encapsulation, Error_Handling, Handlers, Imports | 100% |
| Introspection, Json_Structure, Log_* (all 4) | 100% |
| Meta, Modules, Naming, Permission_Flags | 100% |
| Shebang, Stderr_Routing, Testing, Trigger | 100% |
| Diagnostics | 100% |
| **Readme** | **83%** |
## Session 3 Summary (2026-03-17)
- DPLAN-0074: Full compliance & system verification
- FPLAN-0076: Execution plan
- Phase 0: Smoke test PASSED
- Phase 1: Quick wins (stderr, readme date, dropbox, diagnostics)
- Phase 2: Handler security guard (encapsulation 66%→100%)
- Phase 3: Introspection gates (52%→100% with bypasses)
- Phase 4: json_handler wired into 56 files (1%→100%)
- Fixed log template bug (dict→list format)
- Score: 91% → 99%
## Known Issues
- Readme 83% — likely missing dropbox/ in directory tree
- Pyright warnings (unused logger imports) — pre-existing, cosmetic
## Architecture
- 86 Python files, 21 modules, 19 handler domains
- SQLite + WAL + FTS5, 16 tables
- Lives at src/commons/ (standalone, outside aipass namespace)
- Imports own code as `from commons.apps.*`
- Uses aipass services: prax (logging), cli (display)
@daemon — Operational (2026-03-17)
# @daemon
> Autonomous scheduled wake-ups
**State:** Operational
**Last update:** 2026-03-17
**Seedgo audit:** 96%
## Session 4 Summary
- DPLAN-0064: Branch health cleanup (4 critical bugs, telegram archive, code quality, polish)
- DPLAN-0077: Json_Structure compliance (templates + json_handler in all 16 files)
- Seedgo: 92% → 96%. Json_Structure 7→100%
- Only Log_Structure (22%) remains — being reworked system-wide
## Audit Scorecard (20 standards)
- 100%: Architecture, Cli, Cli_Flags, Documentation, Encapsulation, Error_Handling, Handlers, Imports, Introspection, Json_Structure, Log_Handler, Log_Level, Log_Visibility, Meta, Modules, Naming, Permission_Flags, Readme, Shebang, Stderr_Routing, Testing, Trigger, Diagnostics
- 22%: Log_Structure (expected — system rework in progress)
## Known Issues
- activity_report commands (activity, activity-report) run with no args — no introspection gate
- scheduler_cron.py optional-import pattern needs type: ignore
- Log_Structure seedgo check looks for logs/ at apps/ not branch root
@devpulse — Operational (2026-03-18)
# @devpulse
> Orchestration hub — coordinates via dispatch + agents (no apps/)
**State:** Operational
**Last update:** 2026-03-18
## Milestones
- 35 sessions of system coordination
- drone @git module — atomic PR workflow with lockfile (DPLAN-0008 complete)
- STATUS board system (per-branch + central aggregation)
- Prompt architecture (breadcrumbs pattern)
- dev.local.md → STATUS.local.md consolidation
- Dispatch+wake workflow (backup, flow, cli, prax all verified)
- First PR review cycle — 8 PRs reviewed+merged in one session
## Current Work
- **DPLAN-0008 COMPLETE**: drone @git module built, tested, deployed. All 3 phases done. Global prompt updated, 13 branch deny lists deployed. Branches use `drone @git pr` only.
- **Stale term cleanup**: Scanner tool built (`tools/dev_central_to_devpulse.py`). SOP written. 484 "dev central" hits across 155 files. 5 categories (A-E). Strategy: branch-by-branch, sub-agents handle A/B/E, plan C manually, leave D.
- DPLAN-004: Dashboard pipeline — argparse bug still present (--all/--branch flags eaten by prax.py).
- DPLAN-003: Phase 3 (drone aipass help) pending.
- Ruff CI: 474 violations remaining. No cleanup until seedgo coverage higher.
## Known Issues
- **prax dashboard CLI routing**: `drone @prax dashboard refresh --all` fails — argparse eats flags before module. Python API works fine.
- **flow/DPLAN CWD default**: DPLANs always go to flow's dev_planning/ regardless of caller's CWD.
- **api**: `models` command not routed through drone
- **ai_mail**: `get_current_user()` returns relative `mailbox_path` — causes doubled paths in reply
- **drone**: versioned backup exceeds 30s subprocess timeout
- **seedgo self-violation**: stderr_routing_check.py fails its own standard
- **ruff CI**: 474 lint violations (331 unused imports, 87 unused vars, etc). Backlog — don't auto-fix until seedgo coverage is 100%.
- **wake.py no --model flag**: dispatched branches use CLI default model. Can't control from our side.
## Todos
- [ ] Close stale FPLANs (0017, 0021) once verified complete
- [ ] DPLAN-003 Phase 3: `drone aipass help` module
- [ ] Email prax about argparse bug (--all/--branch still broken despite PR #47)
- [ ] Seedgo: single-file checklist command broken (`drone @seedgo checklist ` fails silently)
- [ ] Ruff cleanup FPLAN (after seedgo coverage reaches 100%)
- [ ] Add --model support to wake.py for dispatched branches
## Recently Completed
- Session 35: DPLAN-0008 complete — drone @git module built+tested+deployed, global prompt+deny lists, flow seedgo redo via drone @git pr. PRs #76-78 merged. (2026-03-18)
- Session 34: CLAUDE.md inbox startup, culture doc refs, venv→symlinks, setup.sh symlink install, ghost input bug research (2026-03-17)
- Session 33: Stale term scanner+SOP, dispatched ai_mail+trigger cleanup, PR #60 (2026-03-16)
- Session 32: README update (init-anywhere), git workflow fix (return to main after PR — tested, works), merged PRs #54-56, cleaned 8 stale branches, new principle (2026-03-16)
- Session 31: CLI front door (seedgo-compliant discovery + drone internal module), statusline git branch, Rich colors, DPLAN-0044, aipass init external test, 6 research agents, OpenClaw comparison, PR #51 (2026-03-15)
- Session 29: Merged 8 PRs (#39-48), ruff investigation (612→474), dispatch reply breadcrumb, /prep broadened (2026-03-14)
- Session 28: Global prompt governance, DPLAN/FPLAN, Git Workflow, How-to-Work, PR #41+#42 merged (2026-03-14)
- Prax Phase 1+2: dashboard devpulse section removed, refresh pipeline 4 bugs fixed (2026-03-14)
- CLI init_project.py migration: FPLAN-0041 done, 99% seedgo, all tests passed (2026-03-14)
- FPLAN-0033 Phase 3 stderr migration — 10 branches, 48 files (2026-03-14)
- DPLAN-003 Stage 1 — credential model complete (2026-03-14)
## Notepad
> **SCRATCH SPACE — gets wiped at session start or topic change.**
- Session 35 COMPLETE.
- DPLAN-0008 fully done — all 3 phases. Module built, tested, prompt updated, deny lists deployed.
- settings.local.json files are gitignored — deny lists are local enforcement only. Spawn template is source of truth for new clones.
- memory_bank.central.json untracked in src/aipass/central/ — Patrick knows, needs to be moved.
- Culture doc still pending Patrick review.
- FPLAN-0094 should be closed (drone @git module complete).
@drone — Operational (2026-03-17)
# @drone
> Command router, @branch resolution, subprocess dispatch, custom commands, git workflow
**State:** Operational
**Last update:** 2026-03-17
## Milestones
- Core routing operational
- `drone systems` command
- @branch resolution
- `--help` for all branches
- Interactive tuple for human-facing commands (monitor, snapshot, versioned)
- Credential verification (RegistryMismatchError)
- Test suite: 335 tests, 9 files
- Seedgo audit: 99% (readme pre-existing)
- **Activated commands restored** (PR #74): scan, activate, list, remove, execute
- **drone @git module** (FPLAN-0094): pr, status, sync, lock, unlock
## Current Work
- @git module complete — awaiting Patrick's review
- FPLAN-0094 closed
## What Changed (Session 9)
- Built `drone @git` internal module from DPLAN-0008 spec
- `git_module.py` — module + adapter, registered in _MODULE_REGISTRY
- `handlers/git/lock_handler.py` — atomic O_CREAT|O_EXCL lockfile
- `handlers/git/pr_handler.py` — 10-step PR workflow with finally cleanup
- `handlers/git/status_handler.py` — scoped git status
- `handlers/git/sync_handler.py` — safe main sync
- 46 new tests (335 total), all passing
- Fixed Pyright: handler __init__.py re-exports, unused imports
## Known Issues
- Pyright warns about `json` package name shadowing stdlib — works at runtime
- Production bug: resolver.handle_command("resolve"/"info", ["@NONEXISTENT"]) unhandled
- Pyright can't fully resolve handlers/git/ imports (handler guard __init__.py limitation)
@flow — In progress — seedgo compliance (FPLAN-0096) (2026-03-17)
# @flow
> Plan lifecycle — FPLANs (building) + DPLANs (planning) via unified plugin architecture
**State:** In progress — seedgo compliance (FPLAN-0096)
**Last update:** 2026-03-17
## Current Work
- FPLAN-0096: Seedgo compliance — 40 tracked files modified
- json_handler wired into 33 handlers + 7 modules
- Introspection gates added to 7 modules
- Awaiting: zombie dplan cleanup, README update, final audit
## Pending
- Delete zombie `apps/handlers/dplan/` (restored from archive by agent, not tracked in git)
- README update (do LAST with full system context, not just date bump)
- Final seedgo audit to verify 100%
- Reply to @memory bug report (email d2bde448: FPLAN create not registering)
## Active Plans
- DPLAN-0016: Seedgo compliance design doc
- FPLAN-0096: Seedgo compliance master plan
## Open PR
- None currently
## Key Learnings (Session 6)
- Work on main, only create branches at PR time via `drone @git pr`
- Zombie files on disk inflate seedgo audit counts — 15 dplan files were already archived
- Real tracked scope was 40 files, not 55
## Known Issues
- 64 orphaned plan files in flow/ root from before CWD fix (need cleanup after merge)
- Default FPLAN template not always fast-deleted on close (cosmetic)
@memory — Operational — 100% seedgo compliant (2026-03-17)
# @memory
> Vector memory archive — ChromaDB, sentence-transformers
**State:** Operational — 100% seedgo compliant
**Last update:** 2026-03-17
## Milestones
- ChromaDB integration
- Auto-rollover at 600 lines (v2 entry-count mode)
- Searchable vector archive
- FPLAN-0026 complete (rollover E2E, search, plans archival)
- **DPLAN-0073 COMPLETE** — 100% seedgo audit, all 24 standards passing
- memory_json/ auto-populating with operation logs
## Current Work
- No active DPLANs or FPLANs — all caught up
- Completed: DPLAN-0073, DPLAN-0055, DPLAN-0045, FPLAN-0054, FPLAN-0062
## Known Issues
- `search` fails without torch/sentence-transformers installed
- DPLANs not vectorized on close (flow-side issue)
- Flow plan registry broken — `drone @flow create` makes file but doesn't register. Close fails. Emailed @flow.
- Old memory bank had ~4,180 vectors. Current has 127. Full port pending.
## Notepad
- Session 12: 100% seedgo audit achieved. All commands tested and working.
- memory_json/ now has 8 log files auto-created from rollover check/status commands
- spawn has template_owners.json (empty) — memory should populate it as authoritative source for .trinity files
- handlers/__init__.py guard blocks cross-branch imports — always expose via modules layer
- Post-rollover chain wired: Trigger.fire → central_writer → dashboard_push → pool_processor
- Memory at 28/25 key_learnings — rollover will trigger on next addition
@prax — Operational (2026-03-17)
# @prax
> Logging, monitoring, dashboard infrastructure
**State:** Operational
**Last update:** 2026-03-17
## Milestones
- System-wide logging via `from aipass.prax import logger`
- Monitor command (passive + interactive)
- Dashboard infrastructure
- Two-tier logging simplification (PR #59, merged)
- Seedgo audit: 93% → 98% (session 13, PR #65 pending)
## Current Work
- PR #65 pending merge (json_structure + stderr + dead code cleanup)
- 48 active files (9 dead handlers archived)
## Seedgo Audit: 98%
- 23 of 24 categories at 100%
- Log_Structure: false positives — seedgo PR #63 fixes the checker
- After both PRs merge (#63 + #65) → expect 100%
## Pending Cross-Branch
- @seedgo PR #63 (log_structure checker fix) — confirmed fixed, awaiting merge
## Known Issues
- None blocking
@seedgo — Operational — **100% compliance** (2026-03-17 (session 21))
# @seedgo
> Standards enforcement, 24-standard audit pack + hook ownership
**State:** Operational — **100% compliance**
**Last update:** 2026-03-17 (session 21)
## Session 21 Summary
1. **log_structure fix** — Removed hierarchical placement post-check from branch_audit.py. Was penalizing prax for having logs. Prax now 100%.
2. **pre_edit_gate.py v1.1** — Branch-scoped. Cross-branch type errors no longer block edits.
3. **Hook audit + DPLAN-0012** — Inventoried all 12 hooks. Found duplicate PostToolUse, stale docs, bridge architecture discussion. Patrick decided: seedgo owns hooks.
4. **Portability architecture** — Bridge pattern (project_bridge.sh → prompt_inject.sh) is the pip install solution. NOT dead scripts. Auto-fix is AIPass-specific, stays in project hooks.
5. **branch_audit.py type fixes** — Path | None, Dict[str, Any]. Phantom revert occurred and was redone.
6. **Emailed Memory** — json_handler clarification for DPLAN-0073.
## Active Plans
- **DPLAN-0012** — Hook Management. PARKED. Architecture mapped, not executing yet. Patrick has other work in progress.
- **DPLAN-0075** — Auto-fix Execution. Two-hook system working in production. Monitor for edge cases.
## TODO
- **DPLAN-0012 execution** — When Patrick is ready. Phase 1: duplicate fix, Phase 2: cross-branch gate, Phase 3: docs
- **seedgo_verify modernization** — old verify module in .archive/, needs rebuild
- **log_structure fix review** — Patrick had mixed feelings on PR #63 fix
## Known Issues
- Duplicate PostToolUse hooks — auto_fix fires twice per edit (PARKED, don't touch)
- Hardcoded `/home/patrick/` paths in global settings hooks
- Bridge scripts (project_bridge.sh, prompt_inject.sh) superseded but NOT dead — portability solution
- Phantom file revert on branch_audit.py — cause unknown, watching
- readme_check.py command list check stops at ### sub-headings
@skills — Operational (2026-03-17)
# @skills
> Capability framework — discoverable, executable skill units
**State:** Operational
**Last update:** 2026-03-17
## Milestones
- Skill discovery
- Execution framework
- --help
- 5 handle_commands
- Seedgo 100% compliance (all 24 standards)
## Current Work
- Session 7: Full seedgo compliance cleanup complete (91% → 100%)
- DPLAN-0070 created for planning
## Known Issues
- None known
@spawn — Operational (2026-03-17)
# @spawn
> Branch lifecycle — create, update, delete, sync
**State:** Operational
**Last update:** 2026-03-17
## Milestones
- Full lifecycle manager (create/update/delete/sync-registry/sync-templates)
- Citizen classes (builder/birthright/manager)
- SHA-256 file tracking
- 113+ tests passing
- Seedgo audit: 98% (23/24 standards at 100%)
## Current Work
- PR #68 open: feat/spawn-seedgo-compliance (awaiting merge)
- FPLAN-0069 complete — seedgo 93%→98%
## Known Issues
- Log_structure at 55% — seedgo PR #63 fixes the post-check contradiction. Will be 100% after merge.
- 6 stale test entries in AIPASS_REGISTRY.json (test pollution — conftest needs backup/restore)
- Update rename detection noisy on freshly-created branches
@trigger — Operational (2026-03-17)
# @trigger
> Event bus — 12 events, error registry, circuit breaker
**State:** Operational
**Last update:** 2026-03-17
## Milestones
- 12 event types
- fire/status/list commands
- Error registry
- handle_command routing
- Seedgo 98% (22/23 at 100%)
- json_handler wired to all 21 modules/handlers
- Introspection gates on all 5 modules + config.py
- Type errors resolved (stub definitions for conditional imports)
## Current Work
- DPLAN-0071: JSON Structure Compliance (completed)
## Known Issues
- log_structure at 55% — seedgo checker backlog, not a trigger issue