nexus-prime 4.8.2 → 4.10.0

package/README.md

@@ -122,7 +122,7 @@ Use `nexus_plan_execution` only when you explicitly want the ledger before mutat
 
 ### 1. The re-reading loop → Session Bootstrap
 **Problem:** Without persistent context, agents re-read everything from scratch on every turn. 99%+ of tokens spent on orientation, not problem-solving.
-**How:** `nexus_session_bootstrap` recovers memory, catalog health, source mix, and recommended next step before any work begins. `nexus_orchestrate` owns decomposition, asset selection, execution, and verification.
+**How:** `nexus_session_bootstrap` recovers memory, repo identity, catalog health, source mix, and recommended next step before any work begins. `nexus_orchestrate` owns decomposition, asset selection, execution, and verification, while keeping candidate files and runtime truth clamped to the resolved repo root.
 **Proof:** Runtime ledgers, worker plans, and selection audits persisted into runtime truth.
 
 ### 2. Files read without question → Ghost Pass + Token Budgeting
@@ -132,7 +132,7 @@ Use `nexus_plan_execution` only when you explicitly want the ledger before mutat
 
 ### 3. Memory that grows but never learns → Memory Fabric
 **Problem:** Memory accumulates without decay. Old notes outrank recent updates. No mechanism for deciding what's ephemeral vs. durable.
-**How:** The memory control plane applies fact extraction, reconciliation, quarantine, and vault projection on top of SQLite + graph base. Memories are scored, contradictions detected, and stale facts fade. A compaction sentinel flushes working memory to durable storage before context window compaction. Background maintenance runs on a 5-minute cycle for entropy-based expiration and deduplication.
+**How:** The memory control plane applies fact extraction, reconciliation, quarantine, and vault projection on top of SQLite + graph base. Memories are scored, contradictions detected, and stale facts fade. A compaction sentinel flushes working memory to durable storage before context window compaction. Background maintenance now runs in bounded hygiene passes, exposes schema and purge backlog, and keeps quarantined noise from overwhelming the dashboard graph.
 **Proof:** Dashboard exposes memory health, scope, trace, and shared-worker context.
 
 ### 4. RAG as prompt stuffing → Session-First RAG Gate
@@ -304,13 +304,13 @@ Operator-facing entrypoints and expert control surfaces.
 
 | Name | Surface | Purpose | Notes |
 | --- | --- | --- | --- |
-| nexus_session_bootstrap | core MCP | Recover session context, memory stats, catalog health, and next-step guidance. | Default first call for non-trivial work. |
-| nexus_orchestrate | core MCP | Plan, select assets, execute through worktree-backed runtime, and persist truth. | Default raw-prompt execution path. |
+| nexus_session_bootstrap | core MCP | Recover session context, memory stats, repo identity, catalog health, and next-step guidance. | Default first call for non-trivial work. |
+| nexus_orchestrate | core MCP | Plan, select assets, execute through worktree-backed runtime, and persist truth. | Default raw-prompt execution path with repo-scoped candidate selection and compact runtime surfaces. |
 | nexus_plan_execution | planning MCP | Inspect the planner ledger before mutation. | Used when operators want a pre-run ledger. |
 | nexus_recall_memory / nexus_memory_stats / nexus_store_memory | memory MCP | Inspect and persist durable learnings. | Feeds the memory fabric and handoff flow. |
 | nexus_optimize_tokens | optimization MCP | Generate a token-saving reading plan before broad file inspection. | Mandatory before reading 3+ files from client-visible intent. |
 | nexus_mindkit_check / nexus_ghost_pass / nexus_spawn_workers | safety + runtime MCP | Run governance preflight, refactor pre-flight analysis, and explicit swarm control. | Mindkit and ghost-pass are required lifecycle checks for risky or multi-file mutation. |
-| nexus_memory_export / import / backup / maintain / trace | memory portability MCP | Export, restore, maintain, and inspect local-first memory bundles. | Supports backup/resume and OpenClaw-oriented bridge packs. |
+| nexus_memory_export / import / backup / maintain / trace | memory portability MCP | Export, restore, maintain, and inspect local-first memory bundles. | Supports backup/resume, explicit hygiene inspection, and OpenClaw-oriented bridge packs. |
 | nexus_list_skills / workflows / hooks / automations / specialists / crews | catalog MCP | Expose what the runtime can activate. | Used for explicit operator control and diagnostics. |
 | nexus_run_status / nexus_federation_status / nexus_session_dna | runtime truth MCP | Inspect persisted run state, federation status, and handoff DNA. | Session DNA generation is mandatory before ending a meaningful session. |
 
@@ -355,11 +355,11 @@ Core architecture layers that shape execution, memory, and visibility.
 | Name | Surface | Purpose | Notes |
 | --- | --- | --- | --- |
 | Knowledge Fabric | runtime subsystem | Balances repo, memory, RAG, patterns, and runtime traces into one execution bundle. | Feeds planner, packet, and worker context. |
-| Memory Control Plane | runtime subsystem | Reconciles facts with add/update/merge/delete/quarantine semantics and vault projection. | Local-first memory remains inspectable and portable. |
+| Memory Control Plane | runtime subsystem | Reconciles facts with add/update/merge/delete/quarantine semantics and vault projection. | Local-first memory remains inspectable, portable, and bounded by hygiene/purge visibility. |
 | Worktree Doctor | runtime subsystem | Prunes stale git worktree metadata and records worktree health ahead of execution. | Protects nexus_orchestrate and verifier lanes from stale temp state. |
 | Source-Aware Token Budget | runtime subsystem | Allocates token budget across repo, memory, RAG, patterns, and runtime traces. | Persists selected and dropped context. |
 | Bootstrap Manifest Truth | runtime subsystem | Tracks configured client bootstrap artifacts independently from active heartbeats. | Supports installed vs active truth in the dashboard. |
-| Artifact Selection Audit | runtime subsystem | Explains why skills/workflows/crews/specialists were selected or rejected. | Persists auditable selection rationale. |
+| Artifact Selection Audit | runtime subsystem | Explains why skills/workflows/crews/specialists were selected or rejected. | Persists auditable selection rationale, selection policy, and blocked reasons. |
 | Bundled assets: 109 skills · 64 workflows · 9 hooks · 5 automations · 7 crews · 139 specialists | runtime subsystem | Summarizes the current bundled runtime inventory. | Detailed lists live in the runtime catalog section and dashboard catalog view. |
 
 </details>
@@ -630,15 +630,37 @@ Inventory Snapshot: 109 skills · 64 workflows · 9 hooks · 5 automations · 7
 ## 📜 Release History
 
 <details open>
-<summary><b>v4.8.0</b> · 2026-03-31 · Seamless Intelligence Upgrade — smarter runtime routing, durable memory controls, and governed work graphs</summary>
+<summary><b>v4.10.0</b> · 2026-04-01 · Control Plane Recovery — truthful catalogs, bounded memory repair, and fast MCP startup</summary>
 
-- **Bootstrap truth for Codex and MCP clients**: Managed docs and bootstrap detection now describe `nexus_session_bootstrap` and `nexus_orchestrate` as MCP tool invocations, not shell commands.
-- **Runtime intelligence surfaces**: Scheduled automations, execution presets, session search, and governed skill distribution/promotion now extend the operator control plane.
-- **Durable control-plane governance**: Work claims, scoped approvals, and scoped budgets now preserve ancestry and lease semantics across missions and operatives.
-- **Memory control upgrades**: Actor-scoped memory CRUD, history, feedback, and retention hints now complement the existing project-aware memory engine.
-- **Channel ingress contract**: Slack, Telegram, and Feishu/Lark mappings now have a normalized gateway surface for thread identity, artifacts, and status exchange.
+- **Truthful catalog health**: `.agents/*` is now canonical, `.agent/*` is treated as legacy fallback, and runtime health only degrades when selected assets actually fail to resolve.
+- **Bounded memory hygiene**: Automatic and manual hygiene now expose schema state, purge backlog, quarantine backlog, and bounded repair passes instead of silently accumulating stale noise.
+- **Fast MCP readiness**: `nexus-prime mcp` reaches stdio readiness before the heaviest bootstrap/orchestrator work finishes, while deferred startup continues in the background.
+- **Safer orchestration**: Repo identity, candidate-file selection, guardrail staging, and dashboard/runtime truth now stay repo-scoped and explicit about why assets were selected or blocked.
 
-Full notes: [releases/v4.8.0.md](./releases/v4.8.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
+Full notes: [releases/v4.10.0.md](./releases/v4.10.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
+</details>
+
+<details>
+<summary><b>v4.9.0</b> · 2026-04-01 · Release QA Hardening — repo-root upgrade safety, truthful degraded startup, and deterministic ship gates</summary>
+
+- **Repo-root upgrade safety**: Synapse and Architects now follow the resolved runtime storage plan, migrate stale schemas in place when possible, and quarantine broken local DBs into workspace-scoped fallback storage instead of crashing startup.
+- **Truthful degraded diagnostics**: `nexus_runtime_health`, `nexus_doctor`, `nexus_autofix`, `nexus-prime status`, and the terminal cockpit now surface requested vs active engine roots, fallback state, and quarantine paths consistently.
+- **Bounded operator reads**: Runtime run artifacts are workspace-scoped, so `status`, `doctor`, and dashboard health no longer inherit slow global temp history from unrelated runs.
+- **Deterministic release QA**: Release smoke now covers stale-schema repo boots, broken-engine degraded doctor paths, corrupt vocabulary repair, and dashboard startup after fallback using isolated fixtures.
+
+Full notes: [releases/v4.9.0.md](./releases/v4.9.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
+</details>
+
+<details>
+<summary><b>v4.8.2</b> · 2026-04-01 · Runtime Truth Stabilization — unified health, safer bootstrap state, and operator repair flows</summary>
+
+- **Unified runtime truth**: Dashboard health, MCP diagnostics, and the terminal cockpit now read from the same runtime envelope instead of maintaining split compatibility logic.
+- **Workspace-safe bootstrap state**: Bootstrap manifests, instruction packets, and engine fallback paths now resolve from the workspace context instead of drifting to ambient cwd or first-run `/tmp` state.
+- **Operator repair surfaces**: `nexus_runtime_health`, `nexus_doctor`, `nexus_autofix`, `nexus_memory_hygiene`, plus matching CLI commands now expose safer diagnostics and self-healing flows.
+- **Dashboard contract hardening**: Creator-only investor telemetry stays permission-gated, unknown routes stay JSON-safe, compatible listeners reuse correctly, and idle Architects worklists render explicitly.
+- **Control-plane resilience**: Synapse ledger storage now follows the same fallback root as the DB, and code-review gates no longer fail a good run just because one verifier worktree went stale.
+
+Full notes: [releases/v4.8.2.md](./releases/v4.8.2.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
 </details>
 
 <details>

package/dist/agents/adapters/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAuF5C,KAAK,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAE5C,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AA2TF,qBAAa,UAAW,YAAW,OAAO;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,UAAS;IAClB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAkB;IAClC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,oBAAoB,CAAgG;IAC5H,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,eAAe;IAqEvB,OAAO,CAAC,GAAG;;IAqBX,OAAO,CAAC,gBAAgB;IA4BxB,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,yBAAyB;IAqFjC,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,4BAA4B;IAWpC,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,yBAAyB;IA2CjC,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,YAAY;YAON,mBAAmB;IA0DjC,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,2BAA2B;IAqBnC,OAAO,CAAC,uBAAuB;IAkC/B,cAAc,CAAC,OAAO,GAAE,cAAsC,GAAG,iBAAiB,EAAE;IAIpF,OAAO,CAAC,oBAAoB;IAu8B5B,OAAO,CAAC,iBAAiB;YAyGX,cAAc;IAsuE5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,OAAO,CAAC,IAAI;IAmBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;CAOzC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA+F5C,KAAK,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAK5C,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAkYF,qBAAa,UAAW,YAAW,OAAO;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,UAAS;IAClB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAkB;IAClC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,oBAAoB,CAAgG;IAC5H,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,eAAe;IAqEvB,OAAO,CAAC,GAAG;;IAqBX,OAAO,CAAC,gBAAgB;IA4BxB,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,yBAAyB;IAqFjC,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,4BAA4B;IAWpC,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,yBAAyB;IA2CjC,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,YAAY;YAON,mBAAmB;IA0DjC,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,2BAA2B;IAqBnC,OAAO,CAAC,uBAAuB;IAkC/B,cAAc,CAAC,OAAO,GAAE,cAAsC,GAAG,iBAAiB,EAAE;IAIpF,OAAO,CAAC,oBAAoB;IAg/B5B,OAAO,CAAC,iBAAiB;YAuGX,cAAc;IAq/E5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,OAAO,CAAC,IAAI;IAmBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;CAOzC"}