nexus-prime 5.1.3 → 6.0.0-rc.2

package/README.md

@@ -1,986 +1,187 @@
 <div align="center">
-  <img src="./docs/assets/nexus-prime-logo.svg" alt="Nexus Prime" width="80" height="80">
+  <img src="https://raw.githubusercontent.com/sir-ad/nexus-prime-web/main/public/assets/nexus-prime-logo.svg" alt="Nexus Prime" width="80" height="80">
   <h1>Nexus Prime</h1>
   <p><strong>Local-first MCP control plane for coding agents</strong></p>
 
   [![npm version](https://img.shields.io/npm/v/nexus-prime?style=for-the-badge&color=00ff88)](https://www.npmjs.com/package/nexus-prime)
   [![npm downloads](https://img.shields.io/npm/d18m/nexus-prime?style=for-the-badge&color=00d4ff)](https://www.npmjs.com/package/nexus-prime)
-  [![License: MIT](https://img.shields.io/badge/License-MIT-00d4ff?style=for-the-badge)](LICENSE)
-  [![Build Status](https://img.shields.io/badge/build-passing-success?style=for-the-badge)](https://github.com/sir-ad/nexus-prime/actions)
   [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-339933?style=for-the-badge&logo=node.js)](https://nodejs.org)
-
-  [![GitHub Stars](https://img.shields.io/github/stars/sir-ad/nexus-prime?style=for-the-badge&logo=github&color=gold)](https://github.com/sir-ad/nexus-prime/stargazers)
-  [![GitHub Forks](https://img.shields.io/github/forks/sir-ad/nexus-prime?style=for-the-badge&logo=github&color=silver)](https://github.com/sir-ad/nexus-prime/network/members)
-  [![GitHub Issues](https://img.shields.io/github/issues/sir-ad/nexus-prime?style=for-the-badge&color=orange)](https://github.com/sir-ad/nexus-prime/issues)
-  [![GitHub Last Commit](https://img.shields.io/github/last-commit/sir-ad/nexus-prime?style=for-the-badge&color=00ff88)](https://github.com/sir-ad/nexus-prime/commits)
-  [![PRs Welcome](https://img.shields.io/badge/PRs-Welcome-brightgreen?style=for-the-badge)](https://github.com/sir-ad/nexus-prime/pulls)
-
-  <!-- AI / Agentic Widgets -->
-  [![AI Framework](https://img.shields.io/badge/AI-Framework-FF9900?style=for-the-badge)](https://github.com/topics/ai)
-  [![LLM Ready](https://img.shields.io/badge/LLM-Ready-00A67E?style=for-the-badge)](https://github.com/topics/llm)
   [![MCP Protocol](https://img.shields.io/badge/Protocol-MCP-4285F4?style=for-the-badge)](https://modelcontextprotocol.io/)
-  [![Agentic OS](https://img.shields.io/badge/Ecosystem-Agentic_OS-8b5cf6?style=for-the-badge)](https://github.com/topics/agentic-os)
   [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-  [![Open Source](https://img.shields.io/badge/Open_Source-%E2%9D%A4-red?style=for-the-badge)](https://opensource.org/)
 
-  <!-- Community -->
-  [![Reddit #1 Post](https://img.shields.io/badge/r%2FLLMDevs-%231_Post_of_the_Day-FF4500?style=for-the-badge&logo=reddit&logoColor=white)](https://www.reddit.com/r/LLMDevs/)
   [![Reddit Community](https://img.shields.io/badge/Reddit-r%2FNexus__Prime-FF4500?style=for-the-badge&logo=reddit&logoColor=white)](https://www.reddit.com/r/Nexus_Prime/)
-  [![Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/zCPEjPZj)
+  [![Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/tByGZgk5gS)
 
   <p><i>Bootstrap. Orchestrate. Verify. Learn.</i></p>
-  <a href="https://www.producthunt.com/products/nexus-prime?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-nexus-prime" target="_blank" rel="noopener noreferrer"><img alt="Nexus-Prime - Semantic memory and parallel execution for AI coding agents | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1096831&amp;theme=dark&amp;t=1773345508816"></a>
-
+  <a href="https://www.producthunt.com/products/nexus-prime?embed=true&utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-nexus-prime" target="_blank" rel="noopener noreferrer"><img alt="Nexus-Prime - Semantic memory and parallel execution for AI coding agents | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1096831&theme=dark&t=1773345508816"></a>
 </div>
 
 ---
 
-## The problem with coding agents today
-
-Every coding agent eventually hits the same ceiling. Not model quality — infrastructure.
-
-**The re-reading loop.** Agents have no persistent memory. Every action requires re-reading all relevant context from scratch. One developer tracked 100M tokens across a Claude Code session: 99.4% were input. For every 1 token written, 166 were read. The agent was not building understanding — it was paying full orientation cost on every single turn.
+## The problem in one sentence
 
-**The memory accumulation trap.** Agents form memory, but nobody decides what should stick. A note from six months ago with a strong semantic match can outrank yesterday's update on the same topic — unless you explicitly configure decay. Memory becomes a growing archive of noise, and the next session starts heavier, not smarter.
+Every coding agent re-reads your entire repo from scratch, every turn — because it has no persistent memory, no token budget, and no way to know what already happened.
 
-**The portability gap.** Token expires. You switch from Claude Code to Codex. The repo transfers. What doesn't: which files actually mattered, what was already tried, what decisions were made at 2am that you built on top of.
+One tracked Claude Code session: **100M tokens. 99.4% input.** For every token written, 166 were read. The agent wasn't building understanding. It was paying full orientation cost on every single turn.
 
-**RAG as prompt stuffing.** Collections get injected wholesale into context. Research consistently shows irrelevant context doesn't just waste tokens — it makes the model behave as if it were a worse model. More context, worse performance.
+## What Nexus Prime gives you
 
-**Skill selection stays manual.** Hundreds of skills exist. Nobody auto-selects. You tell the agent what to use, which defeats the purpose of orchestration.
+Nexus Prime sits between your IDE agent and your repo as an MCP server. It handles the infrastructure layer that no agent ships with:
 
-## Why existing solutions don't solve this
+| Without Nexus Prime | With Nexus Prime |
+| :--- | :--- |
+| Agent re-reads everything from scratch | Session bootstrap recovers memory, repo identity, and prior work |
+| You pick files manually, hope the context fits | Ghost pass + token budgeting selects and budgets before reading |
+| Memory grows but never learns | Memory fabric with fact extraction, decay, and reconciliation |
+| RAG dumps collections wholesale into context | RAG gate: retrieved only when relevant, traced through provenance |
+| Multi-file edits cause partial states | Isolated git worktrees per task, ghost-pass review before merge |
+| One agent, one session, no handoff | Session DNA: structured handoff across agents and sessions |
 
-| Problem | Common workaround | Why it fails | Nexus Prime |
-| :--- | :--- | :--- | :--- |
-| Re-reading loop | CLAUDE.md, AGENTS.md | Static files, manually updated, still re-read every turn | Session bootstrap with source-aware token budgeting — tracks what was selected and what was dropped |
-| Memory accumulation | Flat markdown files (OpenClaw) | No decay logic, no prominence scoring, no reconciliation | Memory fabric with fact extraction, conflict detection, quarantine, and configurable decay |
-| Memory portability | Mem0, MemoryPlugin | Built for conversation continuity, not coding workflow state — architecture decisions and file maps don't transfer | Session DNA for cross-agent context transfer |
-| RAG stuffing | Paste collections into context | Irrelevant context actively degrades model performance | RAG gate — collections attached, retrieved only when relevant, traced through packet and provenance |
-| Skill selection | Manual — you pick the skill | Doesn't scale, brittle, defeats orchestration purpose | `nexus_orchestrate` decomposes task and auto-selects skills, workflows, crews, specialists |
-| Token overflow | Start fresh with new agent | All learned context lost, repo transfers but workflow state doesn't | Ghost pass decides what files even need reading before reading them |
-
-## What Nexus Prime is
-
-**Nexus Prime** is a local-first MCP control plane for coding agents. It gives clients a default path that starts with bootstrap context, flows through orchestrated execution, and ends with persisted runtime truth instead of ad-hoc tool chaining.
-
-**Website:** [nexus-prime.cfd](https://nexus-prime.cfd/)<br>
-**Documentation:** [Catalog](https://nexus-prime.cfd/catalog.html) · [Comparison](https://nexus-prime.cfd/comparison.html) · [Knowledge Base](https://nexus-prime.cfd/knowledge-base.html) · [Integrations](https://nexus-prime.cfd/integrations.html) · [Architecture Diagrams](https://nexus-prime.cfd/architecture-diagrams.html)
-
-## ⚡ Quick Install
+## Install in 30 seconds
 
 ```bash
-# Global installation (recommended)
-npm i -g nexus-prime
+npm install -g nexus-prime
 
-# Start the MCP server
-npx nexus-prime mcp
-```
+# Cursor
+nexus-prime setup cursor
 
-Home-scoped bootstrap now runs automatically on install or first binary start, and the first Nexus run inside a repo writes the workspace-scoped client files it needs. `nexus-prime setup <client>` and `nexus-prime setup all` remain the explicit refresh/fix path when you want to force regeneration.
+# Claude Code
+nexus-prime setup claude
 
-### Docker
+# Codex
+nexus-prime setup codex
 
-```bash
-docker compose up                              # Nexus Prime only
-docker compose --profile with-ollama up        # Nexus Prime + local Ollama
+# All supported clients
+nexus-prime setup all
 ```
 
-### Embedding backends
-
-Nexus Prime supports multiple embedding backends with automatic fallback:
-
-| Backend | Config | Default model |
-|---------|--------|---------------|
-| **Local TF-IDF** | `NEXUS_EMBED_MODE=local` (default) | Built-in 128-dim |
-| **Ollama** | `NEXUS_EMBED_MODE=ollama` | `nomic-embed-text` |
-| **HuggingFace** | `NEXUS_EMBED_MODE=huggingface` | `sentence-transformers/all-MiniLM-L6-v2` |
-| **OpenAI** | `NEXUS_EMBED_MODE=api` | `text-embedding-3-small` |
+Or via curl:
 
 ```bash
-# Ollama (requires ollama running locally)
-NEXUS_EMBED_MODE=ollama NEXUS_OLLAMA_ENDPOINT=http://localhost:11434 npx nexus-prime mcp
-
-# HuggingFace Inference API
-NEXUS_EMBED_MODE=huggingface NEXUS_HF_API_KEY=hf_... npx nexus-prime mcp
+curl -fsSL https://nexus-prime.cfd/install.sh | bash
 ```
 
-Fallback chain: Ollama → HuggingFace → OpenAI → Local TF-IDF. If the preferred backend is unavailable, Nexus falls through automatically.
-
-## Default bootstrap-orchestrate path
+## Default flow
 
-```txt
+```
 nexus_session_bootstrap(goal="<task>", files=[...])
-nexus_orchestrate(prompt="<raw user request>")
+nexus_orchestrate(prompt="<raw request>")
 ```
 
-These are Nexus Prime MCP tool invocations, not shell commands.
-
-Use `nexus_plan_execution` only when you explicitly want the ledger before mutation. Let Nexus choose crews, specialists, skills, workflows, hooks, automations, worker count, and token strategy unless you need hard constraints.
-
-## Core Capabilities
-
-### 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, 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
-**Problem:** Agents read 25 files to answer a question that needed 3. No pre-read analysis. No decision about whether a file should even be read.
-**How:** `nexus_ghost_pass` runs a pre-read analysis pass. Source-aware token budgeting then allocates budget across repo, memory, RAG, patterns, and runtime traces — recording what was selected and what was dropped. Tiered context loading (L0/L1/L2) progressively deepens reads based on relevance instead of loading everything at full depth. Background context compaction strips low-signal content while retaining structural elements.
-**Proof:** Lifetime token analytics with per-session breakdowns, compression ratios, and USD savings — persisted in SQLite, surviving restarts.
+These are MCP tool invocations your agent calls automatically. Auto-bootstrap runs on first non-bootstrap call — no manual trigger required.
 
-### 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 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.
+## Daemon mode (v6)
 
-### 4. RAG as prompt stuffing → Session-First RAG Gate
-**Problem:** Collections get injected wholesale. Irrelevant context doesn't just waste tokens — it degrades model performance.
-**How:** Collections are attached to the runtime, retrieved only when relevant, and traced into planner, packet, and provenance. Nothing gets dumped into prompts wholesale.
-**Proof:** Knowledge view records attached, retrieved, selected, and dropped context.
-
-### 5. Multi-file work pollutes the checkout → Worktree-Backed Swarms
-**Problem:** Multi-file changes in a single checkout create merge conflicts, partial states, and untestable intermediate commits.
-**How:** Coder and verifier lanes execute in isolated worktrees with explicit worktree-health pass before creation.
-**Proof:** Runtime records worktree health, degraded fallback, verifier status, and merge/apply outcomes.
-
-### 6. Runtime state lives in the host process → Persisted Runtime Truth
-**Problem:** When the process dies, the truth dies. Operators can't inspect what happened after the fact.
-**How:** Packets, ledgers, token summaries, client bootstrap truth, worktree health, and run snapshots all come from persisted runtime state.
-**Proof:** Dashboard shows graph-first context, execution history, governance, and catalog truth from the same runtime ledger.
-
-### 7. Manual bootstrap per client → Client Bootstrap and MCP Profiles
-**Problem:** Users manually copy config files for every coding agent. One wrong path and the agent silently ignores the MCP server.
-**How:** Install/start establishes home-scoped surfaces, first repo run writes workspace-scoped surfaces, and `setup all` remains the explicit repair path.
-**Proof:** 9 agents configured automatically: Codex, Cursor, Claude Code, Opencode, Windsurf, Antigravity/OpenClaw, Aider, Continue.dev, Cline.
+```bash
+nexus-prime start          # spawn background daemon, shared across all MCP clients
+nexus-prime stop           # graceful shutdown with memory flush
+nexus-prime mcp            # auto-detects daemon, falls back to standalone
+```
 
-### 8. Ship path disconnected from product story → Release and Governance Surfaces
-**Problem:** Feature registry, public docs, and release notes drift from actual runtime state.
-**How:** Feature registry generation, public-surface scans, release smoke, dependency audit, and runtime smoke all sit in the release gate.
-**Proof:** README, docs, dashboard catalog, and release notes all consume the same generated inventory.
+One NexusPrime instance, one SQLite database, shared across Cursor + Claude Code + Codex simultaneously.
 
-## Proof Screens
+## What it looks like
 
 <div align="center">
-  <img src="./docs/assets/screenshots/dashboard_cockpit_hero.png" alt="Nexus Prime dashboard showing a graph-centered cockpit with memory topology, token telemetry, and runtime controls" width="1024" height="586">
+  <img src="https://raw.githubusercontent.com/sir-ad/nexus-prime-web/main/public/assets/screenshots/dashboard_cockpit_hero.png" alt="Nexus Prime dashboard — graph-centered cockpit with memory topology, token telemetry, and runtime controls" width="1024" height="586">
   <br>
-  <i>Graph-centered cockpit view: the dashboard keeps memory context, runtime truth, and operator controls in one place instead of hiding them behind separate tools.</i>
+  <i>Dashboard at <code>localhost:3377</code> — memory graph, token telemetry, and runtime controls in one place.</i>
 </div>
 
 <div align="center">
-  <img src="./docs/assets/screenshots/dashboard_knowledge_trace.png" alt="Nexus Prime dashboard showing session-first RAG collections, source mix, provenance, and by-source token allocation" width="1600" height="1280">
+  <img src="https://raw.githubusercontent.com/sir-ad/nexus-prime-web/main/public/assets/screenshots/dashboard_knowledge_trace.png" alt="Nexus Prime knowledge trace — RAG collections, source mix, provenance, and token allocation" width="1600" height="1280">
   <br>
-  <i>Knowledge and token trace view: Nexus shows what attached collections contributed, what token budgeting kept, and what the runtime dropped.</i>
+  <i>Knowledge trace — what attached collections contributed, what the budget kept, and what was dropped.</i>
 </div>
 
-- [Catalog](https://nexus-prime.cfd/catalog.html): generated registry for MCP surfaces, client targets, dashboard capabilities, runtime subsystems, and release gates.
-- [Comparison](https://nexus-prime.cfd/comparison.html): tiered market map for direct developer orchestrators, broader multi-agent frameworks, and adjacent specialist stacks.
-- [Knowledge Base](https://nexus-prime.cfd/knowledge-base.html): runtime contract, packets, ledgers, memory, token telemetry, and guardrails.
-- [Integrations](https://nexus-prime.cfd/integrations.html): verified setup for Codex, Cursor, Claude Code, Opencode, Windsurf, and Antigravity/OpenClaw.
-- [Architecture Diagrams](https://nexus-prime.cfd/architecture-diagrams.html): shipped diagrams for the control plane, worktree lifecycle, memory fabric, RAG gate, token budget, runtime truth, and release pipeline.
-
-<details>
-<summary><b>📐 Diagram: bootstrap → orchestrate → runtime → truth</b></summary>
-
-```mermaid
-flowchart LR
-    Client["Client"] --> Bootstrap["nexus_session_bootstrap"]
-    Bootstrap --> Plan["nexus_plan_execution (optional)"]
-    Bootstrap --> Orchestrate["nexus_orchestrate"]
-    Plan --> Orchestrate
-    Orchestrate --> Runtime["Worktree-backed runtime"]
-    Runtime --> Dashboard["Dashboard + API truth"]
-    Runtime --> Memory["Memory fabric + session DNA"]
-    Runtime --> Client
-```
-
-</details>
-
-<details>
-<summary><b>🧠 Diagram: memory + RAG + token-budget flow</b></summary>
-
-```mermaid
-flowchart TD
-    Repo["Repo files"] --> Fabric["Knowledge Fabric"]
-    Memory["Memory recall + stats"] --> Fabric
-    Rag["Attached RAG collections"] --> Fabric
-    Patterns["Patterns + runtime traces"] --> Fabric
-    Fabric --> Budget["Source-aware token budget"]
-    Budget --> Packet["Instruction packet"]
-    Budget --> Runtime["Runtime execution"]
-    Runtime --> Truth["Provenance + runtime truth"]
-```
-
-</details>
-
-## Client Setup and Runtime Contract
+## Plans
 
-### Supported MCP Clients
-Nexus Prime provides automated setup for **12 coding agents**:
-- 🔴 **Codex**
-- 🔵 **Cursor**
-- 🍊 **Claude Code** (CLI + Desktop + VS Code extension)
-- 🟢 **Opencode**
-- 🌊 **Windsurf**
-- 🛡️ **Antigravity / OpenClaw**
-- 🔧 **Aider**
-- 🔗 **Continue.dev**
-- ⚙️ **Cline**
+Free tier installs with every `npm install`. Soft caps — your data is never blocked, just nudged.
 
-All agent configurations are written automatically on `npm install` with XDG-aware path resolution. The first Nexus run inside a repo writes workspace-scoped client files. `nexus-prime setup <client>` and `nexus-prime setup all` remain the explicit refresh/fix path. Run `nexus-prime setup diagnose` for a dry-run validation of all client paths.
+| Plan | Projects | Memory entries | Operatives | Darwin |
+|------|----------|----------------|------------|--------|
+| **Free** | 2 | 1,000 | 1 | off |
+| **Pro** | 10 | 10,000 | 5 | solo |
+| **Team** | ∞ | 100,000 | ∞ | team |
+| **Enterprise** | ∞ | ∞ | ∞ | fleet |
 
-### Automated Integration
 ```bash
-nexus-prime setup codex
-nexus-prime setup cursor
-nexus-prime setup claude
-nexus-prime setup windsurf
-nexus-prime setup antigravity
-nexus-prime setup aider
-nexus-prime setup continue
-nexus-prime setup cline
-nexus-prime setup all
-nexus-prime setup status
+nexus-prime license status          # check current plan
+nexus-prime license activate <key>  # activate Pro / Team / Enterprise
 ```
 
-### Runtime contract
-
-```txt
-1. nexus_session_bootstrap(goal, files?)
-2. nexus_orchestrate(prompt)
-3. Persist packet, ledger, token telemetry, provenance, and session DNA
-4. Inspect runtime truth in the dashboard or via MCP
-```
+Upgrade: [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing)
 
-### Operator-facing proof
+## Supported clients
 
-```txt
-Called Nexus Session Bootstrap tool from Nexus Prime MCP
+Nexus Prime auto-configures MCP for **9 coding agents**:
 
-Session bootstrap ready.
-- Client: Codex (primaryActive)
-- Recommended next step: nexus_orchestrate
-- Token optimization: required
-- Knowledge fabric: repo
-```
+| Client | Command |
+|--------|---------|
+| Cursor | `nexus-prime setup cursor` |
+| Claude Code | `nexus-prime setup claude` |
+| Codex | `nexus-prime setup codex` |
+| Opencode | `nexus-prime setup opencode` |
+| Windsurf | `nexus-prime setup windsurf` |
+| Antigravity / OpenClaw | `nexus-prime setup antigravity` |
+| Aider | `nexus-prime setup aider` |
+| Continue.dev | `nexus-prime setup continue` |
+| Cline | `nexus-prime setup cline` |
 
-```txt
-Called Nexus Memory Stats tool from Nexus Prime MCP
+## Architecture
 
-Memory inventory ready.
-- Prefrontal: working set
-- Hippocampus: recent session buffer
-- Cortex: durable long-term store
-- Zettelkasten links: persisted graph relationships
+```
+nexus_session_bootstrap
+       ↓
+  Knowledge Fabric          ← repo + memory + RAG + patterns + runtime traces
+       ↓
+  Token Budget              ← allocates context across sources, records drops
+       ↓
+  nexus_orchestrate
+       ↓
+  Worktree Runtime          ← isolated git worktrees, ghost-pass review, merge oracle
+       ↓
+  Runtime Truth             ← packets, ledger, session DNA persisted in SQLite
+       ↓
+  Dashboard (port 3377)     ← live memory graph, execution history, catalog
 ```
 
-## Competitive Landscape
-
-Mem0 ($24M Series A, AWS Agent SDK exclusive) solves conversation memory — user preferences, chat continuity, multi-session recall. It was not built for coding workflow state: architecture decisions, file relevance maps, what was tried and failed.
-
-OpenClaw's memory system stores flat markdown files with optional temporal decay. It is siloed per agent and does not transfer between coding tools.
-
-The entire category treats memory as a local storage problem rather than a knowledge architecture problem.
-
-Nexus Prime is not a memory layer. It is the control plane that sits between the client and the repo — owning bootstrap, orchestration, worktree execution, and persisted runtime truth. Memory is one subsystem within it, not the product.
-
-Read the full tiered market map: [Comparison](https://nexus-prime.cfd/comparison.html)
-
-<!-- feature-registry:start -->
-<details>
-<summary><b>🧭 Platform Feature Registry</b></summary>
-
-Generated from shared feature metadata at 2026-03-21T02:48:13.064Z.
-
-Inventory Snapshot: 109 skills · 64 workflows · 9 hooks · 5 automations · 7 crews · 139 specialists
-
-Control Plane Snapshot: 9 MCP surfaces · 6 client targets · 5 dashboard capabilities · 6 runtime subsystems · 5 release gates
-
-<details>
-<summary><b>MCP Surfaces</b> (9)</summary>
-
-Operator-facing entrypoints and expert control surfaces.
-
-| Name | Surface | Purpose | Notes |
-| --- | --- | --- | --- |
-| 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, 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. |
-
-</details>
-
-<details>
-<summary><b>Client Bootstrap Targets</b> (6)</summary>
-
-Client-native installation and bootstrap surfaces managed by Nexus Prime.
-
-| Name | Surface | Purpose | Notes |
-| --- | --- | --- | --- |
-| Codex | bootstrap target | Writes native MCP registration into `~/.codex/config.toml` and keeps the repo-local `AGENTS.md` block as supplementary context. | Home + workspace bootstrap. |
-| Cursor | bootstrap target | Installs MCP config plus project-local .cursor/rules/nexus-prime.mdc. | Home + workspace surfaces. |
-| Claude Code | bootstrap target | Installs MCP config plus generated markdown bootstrap note. | Project note under .agent/client-bootstrap. |
-| Opencode | bootstrap target | Installs config plus generated markdown bootstrap note. | Project note under .agent/client-bootstrap. |
-| Windsurf | bootstrap target | Installs MCP config plus .windsurfrules. | Workspace-scoped rule surface. |
-| Antigravity / OpenClaw | bootstrap target | Installs MCP config plus split SKILL.md bundles sized to client limits. | Home-scoped skill bundle. |
-
-</details>
-
-<details>
-<summary><b>Dashboard Capabilities</b> (5)</summary>
-
-What the topology console exposes from persisted runtime truth.
-
-| Name | Surface | Purpose | Notes |
-| --- | --- | --- | --- |
-| Overview | dashboard | Runtime truth, lifetime token telemetry, graph-centered memory view, and system signals. | Default operator cockpit. |
-| Knowledge | dashboard | Session-first RAG workflow, provenance, source mix, and bootstrap manifest truth. | Shows attached, retrieved, selected, and dropped context. |
-| Runs | dashboard | Execution topology, verifier traces, and event stream. | Centered on persisted runtime snapshots. |
-| Catalog | dashboard | Loaded assets, feature registry, and runtime-vs-available inventory. | Separates what exists from what was used. |
-| Governance | dashboard | Guardrails, quarantine, federation health, and client bootstrap drift. | Operator-facing trust layer. |
-
-</details>
-
-<details>
-<summary><b>Runtime Subsystems</b> (7)</summary>
-
-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, 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, 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>
-
-<details>
-<summary><b>Release Gates</b> (5)</summary>
-
-Quality and security checks required before release.
-
-| Name | Surface | Purpose | Notes |
-| --- | --- | --- | --- |
-| Build + lint + tests | release gate | Compile, lint, and validate runtime/docs/public surfaces. | Canonical quality matrix. |
-| Package smoke | release gate | Verify npm packaging via dry-run before publish. | Catches release surface drift. |
-| Dependency audit + SBOM | release gate | Track shipping dependency risk and document exceptions. | Security hardening gate. |
-| Workflow lint | release gate | Validate workflow syntax and release automation contracts. | Protects CI/CD drift. |
-| Runtime smoke | release gate | Exercise MCP startup, setup-all bootstrap, and dashboard boot. | Final operator-facing release check. |
-
-</details>
-
-</details>
-<!-- feature-registry:end -->
----
-<!-- runtime-catalog:start -->
-<details>
-<summary><b>🗂 Runtime Catalog</b></summary>
-
-Generated from bundled runtime catalogs plus repo-local overrides via `npm run generate:readme-catalog`.
-
-Inventory Snapshot: 109 skills · 64 workflows · 9 hooks · 5 automations · 7 crews
-
-<details>
-<summary><b>Skills</b> (109)</summary>
-
-| Name | Type/Scope | Purpose | Trigger / When used |
-| --- | --- | --- | --- |
-| Agent Orchestrator | read · base | 🛰️ Agent Orchestrator | orchestration work or explicit selection |
-| AI Lead | read · base | 🤖 AI Lead | ai work or explicit selection |
-| ai-builder | mutate · base | Operate as the ai builder with bounded mutations and verifier discipline. | ai work or explicit selection |
-| ai-playbook | orchestrate · base | Operate as the ai specialist for this run. | ai work or explicit selection |
-| ai-reviewer | read · base | Review ai outputs for accuracy, credibility, and completeness. | ai work or explicit selection |
-| api-builder | orchestrate · base | Operate as the api builder with bounded mutations and verifier discipline. | api work or explicit selection |
-| api-playbook | orchestrate · base | Operate as the api specialist for this run. | api work or explicit selection |
-| api-reviewer | read · base | Review api outputs for accuracy, credibility, and completeness. | api work or explicit selection |
-| Backend Inspector | read · base | ⚙️ Backend Inspector | backend work or explicit selection |
-| backend-builder | mutate · base | Operate as the backend builder with bounded mutations and verifier discipline. | backend work or explicit selection |
-| backend-playbook | orchestrate · base | Operate as the backend specialist for this run. | backend work or explicit selection |
-| backend-reviewer | read · base | Review backend outputs for accuracy, credibility, and completeness. | backend work or explicit selection |
-| Business Analyst | read · base | 📊 Business Analyst | runtime selection or explicit skill selection |
-| CLI/Node Reviewer | read · base | 📟 CLI/Node Reviewer | node work or explicit selection |
-| Code Review Agent | read · base | 🔍 Code Review Agent | orchestration work or explicit selection |
-| Context Manager | read · base | 📦 Context Manager | runtime selection or explicit skill selection |
-| CTO/CEO Strategy | read · base | 👔 CTO/CEO Strategy | strategy work or explicit selection |
-| data-builder | orchestrate · base | Operate as the data builder with bounded mutations and verifier discipline. | data work or explicit selection |
-| data-playbook | orchestrate · base | Operate as the data specialist for this run. | data work or explicit selection |
-| data-reviewer | read · base | Review data outputs for accuracy, credibility, and completeness. | data work or explicit selection |
-| deep-tech-builder | orchestrate · base | Operate as the deep-tech builder with bounded mutations and verifier discipline. | deep-tech work or explicit selection |
-| deep-tech-playbook | orchestrate · base | Operate as the deep-tech specialist for this run. | deep-tech work or explicit selection |
-| deep-tech-reviewer | read · base | Review deep-tech outputs for accuracy, credibility, and completeness. | deep-tech work or explicit selection |
-| design-builder | orchestrate · base | Operate as the design builder with bounded mutations and verifier discipline. | design work or explicit selection |
-| design-playbook | orchestrate · base | Operate as the design specialist for this run. | design work or explicit selection |
-| design-reviewer | read · base | Review design outputs for accuracy, credibility, and completeness. | design work or explicit selection |
-| DevOps Auditor | read · base | 🚀 DevOps Auditor | runtime selection or explicit skill selection |
-| django-builder | mutate · base | Operate as the django builder with bounded mutations and verifier discipline. | django work or explicit selection |
-| django-playbook | orchestrate · base | Operate as the django specialist for this run. | django work or explicit selection |
-| django-reviewer | read · base | Review django outputs for accuracy, credibility, and completeness. | django work or explicit selection |
-| economics-builder | orchestrate · base | Operate as the economics builder with bounded mutations and verifier discipline. | economics work or explicit selection |
-| economics-playbook | orchestrate · base | Operate as the economics specialist for this run. | economics work or explicit selection |
-| economics-reviewer | read · base | Review economics outputs for accuracy, credibility, and completeness. | economics work or explicit selection |
-| finance-builder | orchestrate · base | Operate as the finance builder with bounded mutations and verifier discipline. | finance work or explicit selection |
-| finance-playbook | orchestrate · base | Operate as the finance specialist for this run. | finance work or explicit selection |
-| finance-reviewer | read · base | Review finance outputs for accuracy, credibility, and completeness. | finance work or explicit selection |
-| Frontend Auditor | read · base | 🖥️ Frontend Auditor | frontend work or explicit selection |
-| frontend-builder | mutate · base | Operate as the frontend builder with bounded mutations and verifier discipline. | frontend work or explicit selection |
-| frontend-playbook | orchestrate · base | Operate as the frontend specialist for this run. | frontend work or explicit selection |
-| frontend-reviewer | read · base | Review frontend outputs for accuracy, credibility, and completeness. | frontend work or explicit selection |
-| game-development-builder | mutate · base | Operate as the game-development builder with bounded mutations and verifier discipline. | game-development work or explicit selection |
-| game-development-playbook | orchestrate · base | Operate as the game-development specialist for this run. | game-development work or explicit selection |
-| game-development-reviewer | read · base | Review game-development outputs for accuracy, credibility, and completeness. | game-development work or explicit selection |
-| gtm-builder | orchestrate · base | Operate as the gtm builder with bounded mutations and verifier discipline. | gtm work or explicit selection |
-| gtm-playbook | orchestrate · base | Operate as the gtm specialist for this run. | gtm work or explicit selection |
-| gtm-reviewer | read · base | Review gtm outputs for accuracy, credibility, and completeness. | gtm work or explicit selection |
-| integrations-builder | orchestrate · base | Operate as the integrations builder with bounded mutations and verifier discipline. | integrations work or explicit selection |
-| integrations-playbook | orchestrate · base | Operate as the integrations specialist for this run. | integrations work or explicit selection |
-| integrations-reviewer | read · base | Review integrations outputs for accuracy, credibility, and completeness. | integrations work or explicit selection |
-| marketing-builder | orchestrate · base | Operate as the marketing builder with bounded mutations and verifier discipline. | marketing work or explicit selection |
-| marketing-playbook | orchestrate · base | Operate as the marketing specialist for this run. | marketing work or explicit selection |
-| marketing-reviewer | read · base | Review marketing outputs for accuracy, credibility, and completeness. | marketing work or explicit selection |
-| Memory Architect | read · base | 🏗️ Memory Architect | runtime selection or explicit skill selection |
-| node-builder | mutate · base | Operate as the node builder with bounded mutations and verifier discipline. | node work or explicit selection |
-| node-playbook | orchestrate · base | Operate as the node specialist for this run. | node work or explicit selection |
-| node-reviewer | read · base | Review node outputs for accuracy, credibility, and completeness. | node work or explicit selection |
-| orchestration-builder | orchestrate · base | Operate as the orchestration builder with bounded mutations and verifier discipline. | orchestration work or explicit selection |
-| orchestration-playbook | orchestrate · base | Operate as the orchestration specialist for this run. | orchestration work or explicit selection |
-| orchestration-reviewer | read · base | Review orchestration outputs for accuracy, credibility, and completeness. | orchestration work or explicit selection |
-| paid-media-builder | orchestrate · base | Operate as the paid-media builder with bounded mutations and verifier discipline. | paid-media work or explicit selection |
-| paid-media-playbook | orchestrate · base | Operate as the paid-media specialist for this run. | paid-media work or explicit selection |
-| paid-media-reviewer | read · base | Review paid-media outputs for accuracy, credibility, and completeness. | paid-media work or explicit selection |
-| pdlc-builder | orchestrate · base | Operate as the pdlc builder with bounded mutations and verifier discipline. | pdlc work or explicit selection |
-| pdlc-playbook | orchestrate · base | Operate as the pdlc specialist for this run. | pdlc work or explicit selection |
-| pdlc-reviewer | read · base | Review pdlc outputs for accuracy, credibility, and completeness. | pdlc work or explicit selection |
-| PM Agent | read · base | 📋 PM Agent | orchestration work or explicit selection |
-| product-builder | orchestrate · base | Operate as the product builder with bounded mutations and verifier discipline. | product work or explicit selection |
-| product-playbook | orchestrate · base | Operate as the product specialist for this run. | product work or explicit selection |
-| product-reviewer | read · base | Review product outputs for accuracy, credibility, and completeness. | product work or explicit selection |
-| python-builder | mutate · base | Operate as the python builder with bounded mutations and verifier discipline. | python work or explicit selection |
-| python-playbook | orchestrate · base | Operate as the python specialist for this run. | python work or explicit selection |
-| python-reviewer | read · base | Review python outputs for accuracy, credibility, and completeness. | python work or explicit selection |
-| QA/Testing Agent | read · base | 🧪 QA/Testing Agent | testing work or explicit selection |
-| react-builder | mutate · base | Operate as the react builder with bounded mutations and verifier discipline. | react work or explicit selection |
-| react-playbook | orchestrate · base | Operate as the react specialist for this run. | react work or explicit selection |
-| react-reviewer | read · base | Review react outputs for accuracy, credibility, and completeness. | react work or explicit selection |
-| Rule Sanitizer | read · base | 🧹 Rule Sanitizer | runtime selection or explicit skill selection |
-| sales-builder | orchestrate · base | Operate as the sales builder with bounded mutations and verifier discipline. | sales work or explicit selection |
-| sales-playbook | orchestrate · base | Operate as the sales specialist for this run. | sales work or explicit selection |
-| sales-reviewer | read · base | Review sales outputs for accuracy, credibility, and completeness. | sales work or explicit selection |
-| security-builder | orchestrate · base | Operate as the security builder with bounded mutations and verifier discipline. | security work or explicit selection |
-| security-playbook | orchestrate · base | Operate as the security specialist for this run. | security work or explicit selection |
-| security-reviewer | read · base | Review security outputs for accuracy, credibility, and completeness. | security work or explicit selection |
-| Skill Registry | read · base | 📋 Skill Registry | runtime selection or explicit skill selection |
-| spatial-computing-builder | mutate · base | Operate as the spatial-computing builder with bounded mutations and verifier discipline. | spatial-computing work or explicit selection |
-| spatial-computing-playbook | orchestrate · base | Operate as the spatial-computing specialist for this run. | spatial-computing work or explicit selection |
-| spatial-computing-reviewer | read · base | Review spatial-computing outputs for accuracy, credibility, and completeness. | spatial-computing work or explicit selection |
-| strategy-builder | orchestrate · base | Operate as the strategy builder with bounded mutations and verifier discipline. | strategy work or explicit selection |
-| strategy-playbook | orchestrate · base | Operate as the strategy specialist for this run. | strategy work or explicit selection |
-| strategy-reviewer | read · base | Review strategy outputs for accuracy, credibility, and completeness. | strategy work or explicit selection |
-| support-builder | orchestrate · base | Operate as the support builder with bounded mutations and verifier discipline. | support work or explicit selection |
-| support-playbook | orchestrate · base | Operate as the support specialist for this run. | support work or explicit selection |
-| support-reviewer | read · base | Review support outputs for accuracy, credibility, and completeness. | support work or explicit selection |
-| Tech Lead | read · base | 🏛️ Tech Lead | runtime selection or explicit skill selection |
-| testing-builder | orchestrate · base | Operate as the testing builder with bounded mutations and verifier discipline. | testing work or explicit selection |
-| testing-playbook | orchestrate · base | Operate as the testing specialist for this run. | testing work or explicit selection |
-| testing-reviewer | read · base | Review testing outputs for accuracy, credibility, and completeness. | testing work or explicit selection |
-| Token Guardian | read · base | 🪙 Token Guardian | runtime selection or explicit skill selection |
-| Topic Indexer | read · base | 🏷️ Topic Indexer | runtime selection or explicit skill selection |
-| typescript-builder | mutate · base | Operate as the typescript builder with bounded mutations and verifier discipline. | typescript work or explicit selection |
-| typescript-playbook | orchestrate · base | Operate as the typescript specialist for this run. | typescript work or explicit selection |
-| typescript-reviewer | read · base | Review typescript outputs for accuracy, credibility, and completeness. | typescript work or explicit selection |
-| UX Researcher | read · base | 🎨 UX Researcher | deep-tech work or explicit selection |
-| workflows-builder | orchestrate · base | Operate as the workflows builder with bounded mutations and verifier discipline. | workflows work or explicit selection |
-| workflows-playbook | orchestrate · base | Operate as the workflows specialist for this run. | workflows work or explicit selection |
-| workflows-reviewer | read · base | Review workflows outputs for accuracy, credibility, and completeness. | workflows work or explicit selection |
-| writing-builder | orchestrate · base | Operate as the writing builder with bounded mutations and verifier discipline. | writing work or explicit selection |
-| writing-playbook | orchestrate · base | Operate as the writing specialist for this run. | writing work or explicit selection |
-| writing-reviewer | read · base | Review writing outputs for accuracy, credibility, and completeness. | writing work or explicit selection |
-
-</details>
-
-<details>
-<summary><b>Workflows</b> (64)</summary>
-
-| Name | Type/Scope | Purpose | Trigger / When used |
-| --- | --- | --- | --- |
-| ai-approval-loop | workflow · base | Bundled ai approval loop with review, verification, and promotion control. | ai approval requested; ai promotion under review |
-| ai-execution-loop | workflow · base | Bundled ai workflow with planning, execution, and verification checkpoints. | goal mentions ai; ai pack selected |
-| api-approval-loop | workflow · base | Bundled api approval loop with review, verification, and promotion control. | api approval requested; api promotion under review |
-| api-execution-loop | workflow · base | Bundled api workflow with planning, execution, and verification checkpoints. | goal mentions api; api pack selected |
-| backend-approval-loop | workflow · base | Bundled backend approval loop with review, verification, and promotion control. | backend approval requested; backend promotion under review |
-| backend-execution-loop | workflow · base | Bundled backend workflow with planning, execution, and verification checkpoints. | goal mentions backend; backend pack selected |
-| data-approval-loop | workflow · base | Bundled data approval loop with review, verification, and promotion control. | data approval requested; data promotion under review |
-| data-execution-loop | workflow · base | Bundled data workflow with planning, execution, and verification checkpoints. | goal mentions data; data pack selected |
-| deep-tech-approval-loop | workflow · base | Bundled deep-tech approval loop with review, verification, and promotion control. | deep-tech approval requested; deep-tech promotion under review |
-| deep-tech-execution-loop | workflow · base | Bundled deep-tech workflow with planning, execution, and verification checkpoints. | goal mentions deep-tech; deep-tech pack selected |
-| deploy-prep | workflow · base | Pre-deployment review — verify everything is ready to ship | workflows execution or approval path |
-| design-approval-loop | workflow · base | Bundled design approval loop with review, verification, and promotion control. | design approval requested; design promotion under review |
-| design-execution-loop | workflow · base | Bundled design workflow with planning, execution, and verification checkpoints. | goal mentions design; design pack selected |
-| django-approval-loop | workflow · base | Bundled django approval loop with review, verification, and promotion control. | django approval requested; django promotion under review |
-| django-execution-loop | workflow · base | Bundled django workflow with planning, execution, and verification checkpoints. | goal mentions django; django pack selected |
-| economics-approval-loop | workflow · base | Bundled economics approval loop with review, verification, and promotion control. | economics approval requested; economics promotion under review |
-| economics-execution-loop | workflow · base | Bundled economics workflow with planning, execution, and verification checkpoints. | goal mentions economics; economics pack selected |
-| finance-approval-loop | workflow · base | Bundled finance approval loop with review, verification, and promotion control. | finance approval requested; finance promotion under review |
-| finance-execution-loop | workflow · base | Bundled finance workflow with planning, execution, and verification checkpoints. | goal mentions finance; finance pack selected |
-| frontend-approval-loop | workflow · base | Bundled frontend approval loop with review, verification, and promotion control. | frontend approval requested; frontend promotion under review |
-| frontend-execution-loop | workflow · base | Bundled frontend workflow with planning, execution, and verification checkpoints. | goal mentions frontend; frontend pack selected |
-| full-audit | workflow · base | Run all agents end-to-end for a comprehensive project audit | workflows execution or approval path |
-| game-development-approval-loop | workflow · base | Bundled game-development approval loop with review, verification, and promotion control. | game-development approval requested; game-development promotion under review |
-| game-development-execution-loop | workflow · base | Bundled game-development workflow with planning, execution, and verification checkpoints. | goal mentions game-development; game-development pack selected |
-| gtm-approval-loop | workflow · base | Bundled gtm approval loop with review, verification, and promotion control. | gtm approval requested; gtm promotion under review |
-| gtm-execution-loop | workflow · base | Bundled gtm workflow with planning, execution, and verification checkpoints. | goal mentions gtm; gtm pack selected |
-| integrations-approval-loop | workflow · base | Bundled integrations approval loop with review, verification, and promotion control. | integrations approval requested; integrations promotion under review |
-| integrations-execution-loop | workflow · base | Bundled integrations workflow with planning, execution, and verification checkpoints. | goal mentions integrations; integrations pack selected |
-| marketing-approval-loop | workflow · base | Bundled marketing approval loop with review, verification, and promotion control. | marketing approval requested; marketing promotion under review |
-| marketing-execution-loop | workflow · base | Bundled marketing workflow with planning, execution, and verification checkpoints. | goal mentions marketing; marketing pack selected |
-| node-approval-loop | workflow · base | Bundled node approval loop with review, verification, and promotion control. | node approval requested; node promotion under review |
-| node-execution-loop | workflow · base | Bundled node workflow with planning, execution, and verification checkpoints. | goal mentions node; node pack selected |
-| orchestration-approval-loop | workflow · base | Bundled orchestration approval loop with review, verification, and promotion control. | orchestration approval requested; orchestration promotion under review |
-| orchestration-execution-loop | workflow · base | Bundled orchestration workflow with planning, execution, and verification checkpoints. | goal mentions orchestration; orchestration pack selected |
-| paid-media-approval-loop | workflow · base | Bundled paid-media approval loop with review, verification, and promotion control. | paid-media approval requested; paid-media promotion under review |
-| paid-media-execution-loop | workflow · base | Bundled paid-media workflow with planning, execution, and verification checkpoints. | goal mentions paid-media; paid-media pack selected |
-| pdlc-approval-loop | workflow · base | Bundled pdlc approval loop with review, verification, and promotion control. | pdlc approval requested; pdlc promotion under review |
-| pdlc-execution-loop | workflow · base | Bundled pdlc workflow with planning, execution, and verification checkpoints. | goal mentions pdlc; pdlc pack selected |
-| product-approval-loop | workflow · base | Bundled product approval loop with review, verification, and promotion control. | product approval requested; product promotion under review |
-| product-execution-loop | workflow · base | Bundled product workflow with planning, execution, and verification checkpoints. | goal mentions product; product pack selected |
-| python-approval-loop | workflow · base | Bundled python approval loop with review, verification, and promotion control. | python approval requested; python promotion under review |
-| python-execution-loop | workflow · base | Bundled python workflow with planning, execution, and verification checkpoints. | goal mentions python; python pack selected |
-| quick-check | workflow · base | Fast health check — build, tests, and critical issues only | frontend execution or approval path |
-| react-approval-loop | workflow · base | Bundled react approval loop with review, verification, and promotion control. | react approval requested; react promotion under review |
-| react-execution-loop | workflow · base | Bundled react workflow with planning, execution, and verification checkpoints. | goal mentions react; react pack selected |
-| sales-approval-loop | workflow · base | Bundled sales approval loop with review, verification, and promotion control. | sales approval requested; sales promotion under review |
-| sales-execution-loop | workflow · base | Bundled sales workflow with planning, execution, and verification checkpoints. | goal mentions sales; sales pack selected |
-| security-approval-loop | workflow · base | Bundled security approval loop with review, verification, and promotion control. | security approval requested; security promotion under review |
-| security-execution-loop | workflow · base | Bundled security workflow with planning, execution, and verification checkpoints. | goal mentions security; security pack selected |
-| session-close | workflow · base | End-of-session memory flush — persist all learnings | workflows execution or approval path |
-| spatial-computing-approval-loop | workflow · base | Bundled spatial-computing approval loop with review, verification, and promotion control. | spatial-computing approval requested; spatial-computing promotion under review |
-| spatial-computing-execution-loop | workflow · base | Bundled spatial-computing workflow with planning, execution, and verification checkpoints. | goal mentions spatial-computing; spatial-computing pack selected |
-| strategy-approval-loop | workflow · base | Bundled strategy approval loop with review, verification, and promotion control. | strategy approval requested; strategy promotion under review |
-| strategy-execution-loop | workflow · base | Bundled strategy workflow with planning, execution, and verification checkpoints. | goal mentions strategy; strategy pack selected |
-| support-approval-loop | workflow · base | Bundled support approval loop with review, verification, and promotion control. | support approval requested; support promotion under review |
-| support-execution-loop | workflow · base | Bundled support workflow with planning, execution, and verification checkpoints. | goal mentions support; support pack selected |
-| testing-approval-loop | workflow · base | Bundled testing approval loop with review, verification, and promotion control. | testing approval requested; testing promotion under review |
-| testing-execution-loop | workflow · base | Bundled testing workflow with planning, execution, and verification checkpoints. | goal mentions testing; testing pack selected |
-| typescript-approval-loop | workflow · base | Bundled typescript approval loop with review, verification, and promotion control. | typescript approval requested; typescript promotion under review |
-| typescript-execution-loop | workflow · base | Bundled typescript workflow with planning, execution, and verification checkpoints. | goal mentions typescript; typescript pack selected |
-| workflows-approval-loop | workflow · base | Bundled workflows approval loop with review, verification, and promotion control. | workflows approval requested; workflows promotion under review |
-| workflows-execution-loop | workflow · base | Bundled workflows workflow with planning, execution, and verification checkpoints. | goal mentions workflows; workflows pack selected |
-| writing-approval-loop | workflow · base | Bundled writing approval loop with review, verification, and promotion control. | writing approval requested; writing promotion under review |
-| writing-execution-loop | workflow · base | Bundled writing workflow with planning, execution, and verification checkpoints. | goal mentions writing; writing pack selected |
-
-</details>
-
-<details>
-<summary><b>Hooks</b> (9)</summary>
-
-| Name | Type/Scope | Purpose | Trigger / When used |
-| --- | --- | --- | --- |
-| before-compaction-flush | read · base | Flush memory prefrontal to SQLite before context compaction. | before-compaction · context budget nearing limit |
-| before-mutate-guard | read · base | Local checkpoint before bounded file mutation. | before-mutate |
-| before-verify-approval | orchestrate · base | Attach approval-loop workflows before verification for domain work. | before-verify · verification checkpoint |
-| failure-summary | read · base | Local failure checkpoint for recovery notes and retry scope. | run.failed |
-| memory-shield-escalation | read · base | Flag stored memories for shield review when policy risk is detected. | memory.stored · high priority memory stored |
-| memory-stored-review | read · base | Local review hook for important stored memories. | memory.stored |
-| promotion-audit | read · base | Require a security-oriented audit note on promotion approval. | promotion.approved · promotion approved |
-| retry-narrow-scope | orchestrate · base | Focus retries on the failing surface after an error cluster. | retry · retry requested |
-| run-created-brief | read · base | Attach planning context and default orchestration on run creation. | run.created · run created |
-
-</details>
-
-<details>
-<summary><b>Automations</b> (5)</summary>
-
-| Name | Type/Scope | Purpose | Trigger / When used |
-| --- | --- | --- | --- |
-| failure-followup | event · base | Queue a bounded retry follow-up after a failed run. | event:run.failed |
-| failure-recovery-automation | event · base | Queue retry and review workflows after a failed run. | event:run.failed |
-| memory-governance-automation | event · base | Attach memory and security review after memory storage events. | event:memory.stored |
-| session-close-followup | event · base | Queue a bounded approval follow-up after a verified run. | event:run.verified |
-| verified-followup-automation | event · base | Queue a bounded approval workflow after a verified run. | event:run.verified |
-
-</details>
-
-<details>
-<summary><b>Crews</b> (7)</summary>
-
-| Name | Type/Scope | Purpose | Trigger / When used |
-| --- | --- | --- | --- |
-| Content Crew | crew template | Writing, storytelling, and distribution specialists for content and docs surfaces. | domains: writing, marketing · gates: pm, cto, marketer-docs |
-| Finance Crew | crew template | Finance, analytics, and strategic review specialists for business and economics tasks. | domains: finance, economics, data · gates: pm, cto |
-| GTM Crew | crew template | Launch, growth, messaging, and content specialists working from shipped capability. | domains: gtm, marketing, sales, writing · gates: pm, architecture, cto, marketer-docs |
-| Implementation Crew | crew template | Execution-focused engineering crew with verifier and release safety. | domains: backend, frontend, typescript, node, python, django, react · gates: architecture, code-review, cto, devops |
-| PDLC Crew | crew template | Sequential planning, implementation, QA, and shipping for product delivery. | domains: pdlc, product, backend, frontend · gates: pm, architecture, code-review, cto, devops, marketer-docs |
-| Research Crew | crew template | Research, architecture, analysis, and evidence collection for uncertain tasks. | domains: deep-tech, research, ai · gates: pm, architecture, cto |
-| Security Crew | crew template | Threat, trust, identity, and secure release specialists. | domains: security, trust, identity · gates: architecture, code-review, cto, devops |
-
-</details>
-
-</details>
-<!-- runtime-catalog:end -->
-
-## 📜 Release History
-
-<details open>
-<summary><b>v5.1.3</b> · 2026-04-09 · Runtime Latency Refinements</summary>
-
-- **Shallow orchestrate latency**: caches workspace identity, tracked files, and selector projections to reduce preparation before the first useful response.
-- **Deep-context staging on demand**: Knowledge Fabric compose and broader selector work now stay off the simple path until task complexity actually requires them.
-- **Performance branch landed**: packages the branch's bootstrap, dashboard, and orchestrate response-path reductions into `main` without changing behavior.
-
-Full notes: [releases/v5.1.3.md](./releases/v5.1.3.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details open>
-<summary><b>v5.1.2</b> · 2026-04-09 · Memory Layers & Lifecycle Hooks</summary>
-
-- **Explicit memory layer contract**: working, session, project, and pattern layers are now exposed in runtime summaries with auditable contract metadata.
-- **Deterministic lifecycle touchpoints**: memory review, failure summary, and session close surfaces now dispatch in stable catalog-priority order while keeping repo-local `.agents` canonical.
-- **Compatibility preserved**: legacy `.agent` hooks and automations remain loaded as fallback inputs while `.agents` continues to win on duplicate local names.
-
-Full notes: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details open>
-<summary><b>v5.1.1</b> · 2026-04-08 · CI Finalization</summary>
-
-- **Repo-local skill registration**: small repo-local skill catalogs now register into the graph catalog for deterministic discovery.
-- **Docs release markers**: README + docs homepage now reflect the current package version.
-- **Patched overrides**: dependency overrides updated with regenerated lockfile.
-
-Full notes: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details open>
-<summary><b>v5.1.0</b> · 2026-04-08 · Recovery & Selector Performance</summary>
-
-- **Startup recovery**: resolves bootstrap/orchestrate deadlocks that could stall sessions on launch.
-- **Deferred governance init**: Synapse and Architects now initialize lazily to prevent premature automation ticks.
-- **Search correctness**: fixes ngram search edge cases so content queries return results on fresh indexes.
-- **Selection hot-path performance**: caches selector arrays and keyword sets inside `resolveSelections`.
-
-Full notes: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details open>
-<summary><b>v5.0.0</b> · 2026-04-04 · Phantom Sovereignty — proof-carrying execution, governance boundaries, machine efficiency, and dashboard revamp</summary>
-
-- **Proof-carrying execution**: 5 proof types (Selection, Worker, Verification, MemoryPromotion, Apply) with tri-state run model and bounded simulation sandbox.
-- **Phantom modularization**: Runtime decomposed into 6 focused service modules — ExecutionCoordinator, MutationEngine, VerificationEngine, WorkerTopologyPlanner, RuntimeContextAssembler, and RunProjector.
-- **Governance boundary enforcement**: Central `assertGovernanceBoundary()` blocks Synapse and Architects from file/worktree/git mutations. MutationEngine is sole mutation authority.
-- **Machine Efficiency Governor**: Pressure-aware degradation (nominal/elevated/critical) with hard caps on worktrees, dashboard listeners, and cache sizes.
-- **Memory class hierarchy**: 4-tier classification with strict promotion rules, prior system, and learning compiler.
-- **Dashboard revamp**: Backend split into routes/selectors/serializers/DTOs, SSE broker, machine pressure badge, and governor panel on trust surface.
-- **Staged bootstrap**: 3-phase bootstrap with durable receipt persistence, orchestrator self-heal, and ASCII sci-fi install experience.
-
-Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.10.2</b> · 2026-04-02 · Company Control Plane — runtime-scoped hiring, repo-truth MCP, and dashboard alignment</summary>
-
-- **Real employee control plane**: Synapse now supports direct and approval-backed hires, operative lifecycle updates, and heartbeat triggers instead of keeping hiring behind internal-only mandate plumbing.
-- **Repo-truth MCP fallback**: MCP fallback runtimes, token planning, search, and telemetry now stay scoped to the active workspace state key instead of leaking package-root identity.
-- **Aligned dashboard surfaces**: Summary, trust, Synapse, and Architects views now carry selected-runtime repo identity, operative lineage, and the relevant worklist by default.
-- **Shared operational memory**: Synapse control-plane events now persist operative, team, worklist, and work-item lineage into shared memory for later coordination and inspection.
-
-Full notes: [releases/v4.10.2.md](./releases/v4.10.2.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.10.1</b> · 2026-04-02 · Workspace Truth — repo-first binding, real skill selection, and grounded knowledge state</summary>
-
-- **Repo-first workspace binding**: Nexus now prefers the active repo over stale installed-package hints, which stops Codex and MCP sessions from snapping to Homebrew-style package roots.
-- **Real skill handoff**: Repo-local skills are registered per workspace state root, runtime selection participates in packet assembly, and id-based selections no longer disappear before execution.
-- **Grounded knowledge state**: First-run workspace profile seeding and dashboard RAG hydration now reflect the selected runtime instead of generic bootstrap noise or stale usage state.
-- **Cleaner inactive mode**: Synapse and Architects stay initialized but explicitly inactive until configured, without telling normal operators to set operative IDs.
-
-Full notes: [releases/v4.10.1.md](./releases/v4.10.1.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.10.0</b> · 2026-04-01 · Control Plane Recovery — truthful catalogs, bounded memory repair, and fast MCP startup</summary>
-
-- **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.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>
-<summary><b>v4.7.2</b> · 2026-03-31 · Runtime Efficiency — CPU optimization, middleware hardening, and skill sharing</summary>
-
-- **~80% idle CPU reduction**: Polling intervals across 6 subsystems reduced from aggressive (2-60s) to relaxed (30-300s). Memory maintenance, event bus, and pod network no longer burn cycles when idle.
-- **Built-in middleware classes**: TokenBudget, Telemetry, Memory, Guardrails, and Cost middleware ship pre-registered via `createDefaultPipeline()`.
-- **Gist-based skill sharing**: Skill learner auto-shares high-confidence patterns as GitHub gists through the zero-config bridge.
-- **Branding cleanup**: Dev instructions and docs now reference nexus-prime directly.
-
-Full notes: [releases/v4.7.2.md](./releases/v4.7.2.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.7.1</b> · 2026-03-31 · Operator Intelligence release rearm — fresh publish trigger for npm</summary>
-
-- **Fresh GitHub release trigger**: Cut a patch release on top of the already-green `v4.7.0` tree so `CI & Publish` receives a new `release: published` event and can execute the npm publish job.
-- **No product drift**: This does not change the `Operator Intelligence` surface. It reissues the release corridor so installers get the same shipped hardening through a publishable tag.
-- **Release docs updated**: README, changelog, website release history, and standalone release notes now point at the new patch version.
-
-Full notes: [releases/v4.7.1.md](./releases/v4.7.1.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.7.0</b> · 2026-03-30 · Operator Intelligence — PR-first autonomy, pseudonymous telemetry, and cleaner runtime seams</summary>
-
-- **PR-first self-evolution**: Darwin cycles now track autonomy events, attempt GitHub PR promotion through an explicit bridge when auth exists, and persist a ready local artifact when promotion is blocked.
-- **Pseudonymous investor telemetry**: Opt-in Supabase telemetry now tracks installs, sessions, savings, memory activity, and autonomy outcomes without sending code, prompts, file paths, repo names, or secrets.
-- **Cleaner control-plane seams**: MCP `CallTool` now runs through a middleware pipeline for token, telemetry, memory, guardrail, and cost coordination, while `nexus_store_memory` keeps high-priority memories local by default instead of silently relaying them.
-- **Project memory continuity**: Memory writes now stamp stable project tags at write time, and bootstrap surfaces both prior session summaries and prior project memories before broad reading begins.
-- **Operator dashboard expansion**: The main banner and token telemetry area now surface remote installations, active installs, and creator-facing aggregate telemetry when Supabase creator keys are configured.
-
-Full notes: [releases/v4.7.0.md](./releases/v4.7.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.6.1</b> · 2026-03-29 · Release corridor stabilization — audited publish path and npm release recovery</summary>
-
-- **Publish path repaired**: Patched the vulnerable `path-to-regexp` dependency edges through targeted overrides so `CI & Publish` can clear `npm run audit:prod` and proceed to npm publication.
-- **Lockfile normalized for release**: Refreshed the production lockfile so GitHub Actions, local installs, and release packaging all resolve the same audited dependency graph.
-- **No feature drift from v4.6.0**: This is a release-stability patch on top of Context Ascension, not a new product surface or protocol change.
-
-Full notes: [releases/v4.6.1.md](./releases/v4.6.1.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.6.0</b> · 2026-03-29 · Context Ascension — always-on compression, native search, and operator telemetry</summary>
-
-- **Always-on token optimization**: Bootstrap now auto-applies token optimization whenever candidate files are available, and bootstrap/orchestrate responses surface token and USD savings directly instead of hiding the win in diagnostics.
-- **Project-scoped session summaries**: Session close and `nexus_session_dna` now persist reusable project summaries, and the next bootstrap surfaces whether prior context was recovered before any broad file reading begins.
-- **Dynamic context discovery**: MCP `ListTools` now keeps core lifecycle tools expanded while summarizing non-core tools by default, with `nexus_describe_tool` available for on-demand full contracts.
-- **Native search**: Added sparse n-gram backed `nexus_search` for fast codebase retrieval with token-savings tracking on the MCP surface.
-- **Opt-in telemetry and dashboard signals**: Remote telemetry remains disabled until consent, clears queued events when turned off, and the dashboard now shows savings, search activity, and telemetry status in the main operator banner.
-
-Full notes: [releases/v4.6.0.md](./releases/v4.6.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.5.0</b> · 2026-03-27 · Neural Ascension — Auto-optimization, memory injection, and sci-fi command center</summary>
-
-- **Auto token optimization**: Bootstrap auto-applies token planning when 5+ candidate files detected. Quality floor (0.7) ensures task-referenced and recently modified files never get skipped. Zero manual `nexus_optimize_tokens` calls needed.
-- **Seamless memory injection**: Every MCP tool response auto-recalls top 3 relevant memories (30s rate limit, 0.4 score floor, SHA1-cached). Recursion-safe — skips memory tools.
-- **Auto ghost-pass**: Refactoring tasks with 3+ files or 3+ phases auto-detect risk areas before execution begins.
-- **MCP category visuals**: 5 distinct sci-fi themes (memory/orchestration/execution/intelligence/system) with per-category ANSI borders, colors, and thematic labels.
-- **Dashboard noise reduction**: Server-side rate limiting for 5 event types (2-10s windows), noise suppression for auto/empty signals, System filter button, client-side type+summary dedup.
-- **Cross-project memory**: New APIs for cross-project browsing and project index. Dashboard project selector, tag-based search with fuzzy toggle, cross-project memory lane.
-- **Animated installation**: 10-frame braille spinner, compact logo for narrow terminals, progress bars, phase headers, build metadata in success message.
-- **Lifecycle policy substrate**: Feature flags with env overrides for all new auto-behaviors. Fail-open defaults with decision metrics.
-
-Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.4.0</b> · 2026-03-27 · Lifecycle policy automation, cross-project memory APIs, and signal-aware dashboard UX</summary>
-
-- **Lifecycle policy substrate**: Added policy-gated auto behaviors with fail-open decisions, feature kill switches, and decision metrics for bootstrap token planning, memory-context injection, MCP visuals, and ghost-pass automation.
-- **Memory platform expansion**: Added `/api/memory/cross-project` and `/api/memory/projects`, shared-only governance defaults, and tag+content+fuzzy cross-project query support.
-- **Dashboard signal quality**: Added server-side event throttles/noise suppression, explicit `mcp` + `system` taxonomy alignment, a `System` event filter chip, and dual-key dedup (`id` + `type/summary` in 2s, severity bypass).
-- **CLI/install visual layer**: Expanded ASCII toolkit (compact logo, richer loaders, phase/sub-brand helpers), added TTY-aware install spinner, and surfaced phase/sub-brand rendering in CLI summaries/help.
-
-Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.3.4</b> · 2026-03-26 · Semantic retrieval hardening, truthful worker budgets, and canonical promoted assets</summary>
-
-- **Semantic retrieval and matching**: RAG chunks now carry embeddings with semantic-first retrieval, Context Assembler relevance uses Embedder-backed scoring, and Synapse asset matching blends semantic and lexical signals instead of pure Jaccard hot paths.
-- **Truthful worker telemetry**: Phantom workers now report real or diff-estimated token usage, mark budget overruns explicitly, and stop treating wall-clock time as token consumption.
-- **Durable source-of-truth promotion**: Generated skills and workflows promoted by runtime now persist canonical repo-local copies under `.agent/.../generated`, while NexusPrime active agent memory routes through the SQLite `MemoryEngine` instead of the legacy in-memory path.
-
-Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.3.2</b> · 2026-03-25 · Dashboard stabilization, peer sync, and test regression fixes</summary>
-
-- **MCP Transport Stabilization**: Replaced stubbed transmission methods with functional JSON-RPC notification transport logic.
-- **Peer Connectivity**: Implemented logical peer integration conduits (`connectToPeer` and `syncWithPeer`) for orchestrator data exchange.
-- **Dashboard UX & Observability Refinements**: Applied minimalist UI improvements, exposed CAS token compression metrics, and bound swarm metrics (crew selection, plannerState confidence) to the operator plane.
-- **Test Suite Regression Fixes**: Remedied `dashboard.test.ts` `EADDRINUSE` port collision and event-bus mock path resolution faults.
-
-Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.3.0</b> · 2026-03-24 · Sparse n-gram index engine and reactor core stabilization</summary>
-
-- **Sparse n-gram index engine**: Forged a sparse n-gram index engine using trigram decomposition with probabilistic masks and CRC32-weighted variable-length n-gram extraction.
-- **Six core engines routed via lattice**: Queries are now channeled through the lattice before full scoring for memory recall, graph traversal, skill resolution, pattern search, hybrid retrieval, and knowledge fabric operations.
-- **Reactor Core Stabilization**: Client bootstrap now scans for present vessels, session locks via PID tracking purge stale phantom sessions, dashboard telemetry separation, and hook dispatch containment fields.
-- **Dormant Operative Signals & New CLI**: Synapse and Architects modules are dormant until operative signal received, plus new `cleanup` and `doctor` commands.
-
-Full notes: [releases/v4.3.0.md](./releases/v4.3.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.2.0</b> · 2026-03-24 · Orchestration reliability, scoped memory, and investor-ready runtime truth</summary>
-
-- **Task-aware orchestration**: Review gates now apply per run and per gate, low-confidence cross-domain artifact picks are rejected, and bounded worker parallelism stays visible instead of hiding behind one blocked verification state.
-- **Scoped memory lanes**: Durable memory now preserves repo/workspace/project provenance, separates profile/workspace/shared/inbox lanes, and keeps low-signal chatter out of the primary working set.
-- **Operator-facing trust signals**: The dashboard now surfaces token optimization, gate reasoning, memory container counts, interpretation issues, selection audits, and pre-compaction backup status as first-class runtime truth.
-- **Investor-ready public release path**: README, changelog, landing-page changelog, and canonical release notes now describe the same reliability release without drifting between surfaces.
-
-</details>
-
-<details>
-<summary><b>v4.1.0</b> · 2026-03-23 · Control-plane hardening, dashboard truth, and coordinated execution</summary>
-
-- **Dashboard responsiveness and truth**: Hot endpoints now use bounded caching, the client avoids broad refresh fan-out while SSE is healthy, catalog refresh stays canonical to runtime assets, and degraded states surface as explicit partial/stale conditions instead of silent fallback.
-- **Engineering-first routing**: Broad dashboard/control-plane reviews now stay on engineering lanes with meaningful frontend/review secondary intent instead of drifting into blocked PM, marketing, or data routes.
-- **Explicit Synapse ↔ Architects coordination**: Work-item claim/complete handoffs are now bootstrapped through a typed bridge with shared correlation IDs across missions, sorties, field reports, dashboard entities, and POD telemetry.
-- **Bootstrap-path regression coverage**: Added end-to-end mandate → worklist → sortie → convergence coverage plus dashboard and routing regressions to keep control-plane behavior release-safe.
-
-Full notes: [releases/v4.1.0.md](./releases/v4.1.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v4.0.0</b> · 2026-03-22 · Engine stabilization, release hardening, and roster light-loading</summary>
-
-- **Memory vault hardening**: SQLite pragmas, access-count parameterization, entropy clamping, graph failure telemetry, debounced vault writes, and recursive-CTE lineage now stabilize memory behavior under real runtime load.
-- **Lifecycle cleanup**: `OrchestratorEngine.dispose()` is synchronous, shutdown ownership stays in entrypoints, compaction sentinel cleanup uses stored unsubscribe closures, and circuit/dedupe telemetry is persisted through typed events.
-- **Persistent vocabulary scoring**: TF-IDF vocabulary state now rebuilds from `vocabulary_stats` + `vocabulary_meta.doc_count` instead of drifting toward only the latest document batch.
-- **Roster cold-start reduction**: Specialist planning/listing stays synchronous while heavyweight specialist markdown and sections load lazily from detail payloads.
-
-Full notes: [releases/v4.0.0.md](./releases/v4.0.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v3.17.0</b> · 2026-03-20 · Agent adoption hardening, memory readability, atlas code intelligence peer</summary>
-
-- **Hard bootstrap enforcement**: Non-bootstrap MCP tool calls return a structured `blocked` response with next-step guidance instead of a soft warning agents ignored. Read-only tools remain exempt.
-- **Atlas code intelligence peer**: Auto-detects Atlas (AST parsing, semantic search, impact analysis) and writes MCP config for all clients when available.
-- **Memory readability**: Fixed text overflow on memory cards/timeline, default-filtered phantom and quarantine noise from dashboard, added phantom toggle.
-- **Imperative tool descriptions**: Rewrote MCP tool descriptions from "Preferred" to "REQUIRED" and planning nudges from "consider" to "Next: call".
-- **Streamlined CLAUDE.md**: 134-line protocol manual → 16-line imperative instruction set. Full protocol moved to `docs/nexus-protocol.md`.
-
-Full notes: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v3.16.0</b> · 2026-03-20 · Compaction sentinel, tiered context, token analytics, peer federation, installation hardening</summary>
-
-- **Compaction Sentinel + Tiered Context**: Pre-compaction memory flush and L0/L1/L2 progressive file loading.
-- **Token Analytics**: Lifetime optimization reporting with per-session breakdowns, persisted in SQLite.
-- **Self-Learning Skills + Repo Tree**: Automatic skill derivation and cached repo tree visualization.
-- **Peer Connectors**: Auto-detect and sync with OpenClaw, Hermes, PicoClaw peers.
-- **Installation Hardening**: XDG-aware config, path validation, install logging, `nexus-prime setup diagnose`, 12 client targets.
-- **Multi-Intent Classification**: Orchestrator scores all intents, surfaces secondary when within 80% of primary.
-
-Full notes: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v3.14.0</b> · 2026-03-16 · Ollama/HuggingFace embeddings, autonomous memory, agent ecosystem expansion</summary>
-
-- **Embedding backend chain**: Added Ollama and HuggingFace Inference API as embedding backends with automatic fallback (Ollama → HuggingFace → OpenAI → Local TF-IDF).
-- **Agent ecosystem expansion**: Added first-class setup for Aider, Continue.dev, and Cline alongside existing Codex, Cursor, Claude Code, Opencode, Windsurf, and OpenClaw adapters (9 agents total).
-- **OpenClaw memory bridge**: Bidirectional memory sync between Nexus Prime and OpenClaw instances via `nexus_openclaw_memory_sync`.
-- **Autonomous memory management**: Configurable decay rates, access-frequency retention (frequently recalled memories decay slower), and a maintenance cycle that expires stale low-value memories.
-- **Learning-to-skill promotion**: Recurring agent learnings are automatically promoted to reusable skills when access patterns indicate reliability.
-- **Fuzzy skill matching**: Skill resolution now uses Jaccard similarity scoring instead of exact name matching, so approximate goal text finds relevant skills.
-- **Adaptive token optimization**: Reading plan thresholds adjust dynamically based on file count and budget constraints.
-- **Docker one-click install**: `docker compose up` starts Nexus Prime; `--profile with-ollama` adds local Ollama for fully offline operation.
-- **Hardened graph containment**: Memory Explorer graph nodes now stay strictly inside the graph viewport via `contain: paint`, SVG overflow clipping, viewBox-aware position clamping, and tighter ring radii — fully eliminates the overlap with Memory Health/Scope text below.
-- **Stronger orchestrator adoption**: Instruction gateway and project rules now use imperative MUST/NEVER phrasing so coding agents proactively route through `nexus_session_bootstrap` and `nexus_orchestrate` instead of falling back to manual file exploration.
-- **Fixed**: Claude Code MCP config path corrected to `~/.claude/mcp.json`. Agent auto-config now writes workspace configs during `npm install`.
-
-Full notes: [CHANGELOG.md](./CHANGELOG.md)
-</details>
-
-<details>
-<summary><b>v3.13.0</b> · 2026-03-15 · Workspace surfaces, dashboard layout fixes, and community presence</summary>
+Three pillars — all local-first, all SQLite-backed, single process:
 
-- Dashboard workspaces now drive their own graph visibility, library tabs, titles, and subtitles per surface mode (overview, knowledge, runs, catalog, governance).
-- Fixed memory graph overlapping text in non-graph surfaces by collapsing focusable-shell gap when the graph widget is hidden and removing conflicting inline margin.
-- Added graph-note text overflow handling and responsive min-height for hidden-graph surfaces.
-- Library tabs are now rendered dynamically per workspace instead of a single hardcoded rail.
-- Knowledge workspace auto-opens the create form when no collections exist.
-- Plan and execute actions now switch to the runs workspace automatically.
-- Added community badges (Reddit, Discord), engagement badges (stars, forks, issues, PRs), and the r/LLMDevs #1 Post of the Day recognition.
+- **Brain** — orchestrator, memory fabric, token supremacy, knowledge graph, phantom execution
+- **Workforce** — Synapse (Paperclip-style operative hiring) + Architects (Gastown-style work management)
+- **Eyes** — real-time dashboard with memory topology, token telemetry, and execution history
 
-Full notes: [CHANGELOG.md](./CHANGELOG.md)
-</details>
+## Embedding backends
 
-<details>
-<summary><b>v3.12.1</b> · 2026-03-14 · Dashboard focus mode, graph recall wiring, and bootstrap recovery</summary>
+| Backend | Config | Default model |
+|---------|--------|---------------|
+| **Local TF-IDF** | `NEXUS_EMBED_MODE=local` (default) | Built-in 128-dim |
+| **Ollama** | `NEXUS_EMBED_MODE=ollama` | `nomic-embed-text` |
+| **HuggingFace** | `NEXUS_EMBED_MODE=huggingface` | `sentence-transformers/all-MiniLM-L6-v2` |
+| **OpenAI** | `NEXUS_EMBED_MODE=api` | `text-embedding-3-small` |
 
-- Added dashboard maximize/restore focus mode across the main operational panels so graph, memory snapshots, runtime events, and operator actions are usable without the cramped default layout.
-- Wired graph memory into the main recall path, auto-seeded first-run RAG collections from bounded project context, and rehydrated dashboard event history from persisted logs.
-- Tightened the cockpit density, clarified the RAG injection path, rotated persisted events, and seeded visible local hook/automation starters for fresh workspaces.
+Fallback chain: Ollama → HuggingFace → OpenAI → Local TF-IDF.
 
-Full notes: [releases/v3.12.1.md](./releases/v3.12.1.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
+## Competitive position
 
-<details>
-<summary><b>v3.12.0</b> · 2026-03-14 · Public surface, proof screenshots, and release visibility</summary>
+Mem0 ($24M Series A) solves conversation memory — chat continuity, user preferences, multi-session recall. It was not built for coding workflow state.
 
-- Rebuilt the README hierarchy around what Nexus Prime is, why it is different, the bootstrap-orchestrate path, and proof-backed capabilities.
-- Replaced repeated landing-page imagery with a graph-first hero, a distinct runtime-sequence proof image, and clearer knowledge-trace placement.
-- Expanded the generated inventory surfaces so README, docs, and dashboard all show counts for skills, workflows, hooks, automations, crews, specialists, MCP surfaces, client targets, dashboard capabilities, runtime subsystems, and release gates.
-- Converted the changelog to version-level toggle history and prepared the `v3.12.0` release draft for GitHub release publication and npm publish.
+OpenClaw stores flat markdown files with optional decay. Siloed per agent, no cross-tool transfer.
 
-Full notes: [releases/v3.12.0.md](./releases/v3.12.0.md) · Full history: [CHANGELOG.md](./CHANGELOG.md)
-</details>
+**Nexus Prime is not a memory layer. It is the control plane** — owning bootstrap, orchestration, worktree execution, and persisted runtime truth. Memory is one subsystem within it, not the product.
 
-<details>
-<summary><b>📈 Star History</b></summary>
+→ [Full comparison](https://nexus-prime.cfd/comparison.html)
 
-<div align="center">
-  <a href="https://star-history.com/#sir-ad/nexus-prime&Timeline">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=sir-ad/nexus-prime&type=Timeline&theme=dark" />
-      <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=sir-ad/nexus-prime&type=Timeline" />
-      <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=sir-ad/nexus-prime&type=Timeline" />
-    </picture>
-  </a>
-</div>
+## Docs
 
-</details>
+- [nexus-prime.cfd](https://nexus-prime.cfd) — product site + quick start
+- [nexus-prime.cfd/pricing](https://nexus-prime.cfd/pricing) — plan comparison
+- [Catalog](https://nexus-prime.cfd/catalog.html) — MCP surfaces, clients, runtime subsystems
+- [Knowledge Base](https://nexus-prime.cfd/knowledge-base.html) — runtime contract, packets, memory, token telemetry
+- [Architecture Diagrams](https://nexus-prime.cfd/architecture-diagrams.html) — control plane, memory fabric, RAG gate, token budget
+- [Integrations](https://nexus-prime.cfd/integrations.html) — verified setup per client
 
-<br>
+## Feedback
 
-<div align="center">
-  <strong>License:</strong> MIT <br>
-  <strong>Maintainer:</strong> <a href="https://github.com/sir-ad">Adarsh Agrahari (sir-ad)</a>
-</div>
+[nexus-prime.cfd](https://nexus-prime.cfd) · [Discord](https://discord.gg/tByGZgk5gS) · [Reddit](https://www.reddit.com/r/Nexus_Prime/) · [hello@nexus-prime.cfd](mailto:hello@nexus-prime.cfd)