@bossmode/local

Wave 10's local-first BossMode brain scaffold.

What ships through BM-W10-11

• SQLite-backed core control-plane mirror for the local brain
• Versioned migration runner
• CRUD helpers for mirrored rows
• Local governance parity:
  • Guardian preflight
  • kill switch state
  • standing-order seeding + evaluation
  • approval bundle grouping
  • blast-radius budgeting
• Local intelligence parity:
  • signal normalization + scoring + reranking
  • memory CRUD + recall ranking
  • memory writeback builders
• Standalone exports:
  • initLocalBrain()
  • getLocalDb()
  • closeLocalBrain()
  • startSyncEngine() / stopSyncEngine() / getSyncStatus()
  • runSetupProtocol() / resumeSetupProtocol()
  • beginInduction() / answerInductionStep() / getInductionState()
  • createOpenClawFamilySpawner() / createClaudeCodeFamilySpawner()
  • getFamilySpawner() / getOrInitFamilyDb()
  • downloadKnowledgePack() / applyKnowledgePack() / rollbackKnowledgePack() / getAppliedKnowledgePack()
  • detectProvisioningServices() / upsertProvisioningService() / markProvisioningSkipped() / getProvisioningSnapshot()
  • generateLocalFamilyReport() / getLatestLocalFamilyReport() / syncLocalFamilyReport()
  • governance helpers from src/governance
  • intelligence helpers from src/intelligence

SQLite runtime

The package prefers Node's built-in node:sqlite driver when the runtime provides it. If node:sqlite is unavailable, it falls back to better-sqlite3 when that package is installed by the host runtime.

Status

BM-W10-01 through BM-W10-11 are now implemented in-repo. bossmode init --token ... --wizard now auto-registers the six-role local family for the default Claude Code runtime plus explicit --family-runtime openclaw and --family-runtime hermes runs. Runtime sends now classify external machine blockers explicitly (blocked_local_auth_required, blocked_local_permissions_required, blocked_target_selection_required, blocked_hermes_auth_required, etc.) instead of collapsing into generic runtime errors, and Hermes can reuse an existing local session as the consigliere. Use npm run proof:wave10-runtime from the repo root to rerun the live Claude + OpenClaw handoff proof on the current machine. The remaining Wave 10 work is per-machine execution proof only: healthy Claude local auth (and, if the local hook is enabled, writable hook/cache state), a concrete OpenClaw target, Hermes auth on the operator machine, and the still-user-owned Wave 9 real inbox smoke before calling the whole wave externally verified.

Consigliere chat provider support

Consigliere tool-use requires Anthropic or OpenAI. Gemini/Grok work in read-only advisory mode for this round: they stream text, but BossMode silently drops tool definitions before calling those providers. Chat context and receipts are read from the local SQLite brain; Convex chat-message sync is intentionally out of scope.

Local chat backend

Round 7 adds daemon-local Consigliere chat at POST /api/local/chat with SSE responses, /api/local/chat/confirm for guarded confirmations, and /api/local/chat/history for retained local transcripts. The transcript table is bm_chat_messages; retention defaults to 90 days and can be overridden with BOSSMODE_CHAT_RETENTION_DAYS.

The CLI surface is bossmode chat "status" for a one-shot turn and bossmode chat --interactive for a line-oriented REPL. --json prints raw SSE event JSON lines for tests and automations.