nexus-prime 4.10.2 → 5.0.0

package/README.md

@@ -65,7 +65,7 @@ Every coding agent eventually hits the same ceiling. Not model quality — infra
 **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://sir-ad.github.io/nexus-prime/catalog.html) · [Comparison](https://sir-ad.github.io/nexus-prime/comparison.html) · [Knowledge Base](https://sir-ad.github.io/nexus-prime/knowledge-base.html) · [Integrations](https://sir-ad.github.io/nexus-prime/integrations.html) · [Architecture Diagrams](https://sir-ad.github.io/nexus-prime/architecture-diagrams.html)
+**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
 
@@ -174,11 +174,11 @@ Use `nexus_plan_execution` only when you explicitly want the ledger before mutat
   <i>Knowledge and token trace view: Nexus shows what attached collections contributed, what token budgeting kept, and what the runtime dropped.</i>
 </div>
 
-- [Catalog](https://sir-ad.github.io/nexus-prime/catalog.html): generated registry for MCP surfaces, client targets, dashboard capabilities, runtime subsystems, and release gates.
-- [Comparison](https://sir-ad.github.io/nexus-prime/comparison.html): tiered market map for direct developer orchestrators, broader multi-agent frameworks, and adjacent specialist stacks.
-- [Knowledge Base](https://sir-ad.github.io/nexus-prime/knowledge-base.html): runtime contract, packets, ledgers, memory, token telemetry, and guardrails.
-- [Integrations](https://sir-ad.github.io/nexus-prime/integrations.html): verified setup for Codex, Cursor, Claude Code, Opencode, Windsurf, and Antigravity/OpenClaw.
-- [Architecture Diagrams](https://sir-ad.github.io/nexus-prime/architecture-diagrams.html): shipped diagrams for the control plane, worktree lifecycle, memory fabric, RAG gate, token budget, runtime truth, and release pipeline.
+- [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>
@@ -285,7 +285,7 @@ The entire category treats memory as a local storage problem rather than a knowl
 
 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://sir-ad.github.io/nexus-prime/comparison.html)
+Read the full tiered market map: [Comparison](https://nexus-prime.cfd/comparison.html)
 
 <!-- feature-registry:start -->
 <details>
@@ -630,6 +630,20 @@ Inventory Snapshot: 109 skills · 64 workflows · 9 hooks · 5 automations · 7
 ## 📜 Release History
 
 <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.

package/dist/agents/adapters/ide-compat.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Nexus Prime — IDE Compatibility Utilities
+ * Provides MCP config templates and detection logic for all supported IDEs.
+ *
+ * Supported: VS Code (Claude Code ext), JetBrains, Cursor, Windsurf, Zed, Continue.dev, Aider, Cline, Codex
+ */
+export type IDEId = 'claude-code' | 'cursor' | 'windsurf' | 'continue' | 'cline' | 'zed' | 'codex';
+export interface McpConfigOutput {
+    /** Absolute path where the config should be written */
+    configPath: string | null;
+    /** JSON string content to write */
+    content: string;
+    /** If true, attempt to merge into existing file rather than overwrite */
+    merge: boolean;
+}
+/** Detect which IDEs are present in the workspace or home directory. */
+export declare function detectInstalledIDEs(workspaceRoot: string): IDEId[];
+/** Get the MCP config content and target path for a given IDE. */
+export declare function getMcpConfigForIDE(ide: IDEId, workspaceRoot: string): McpConfigOutput;
+/**
+ * Normalise MCP tool response content for cross-client compatibility.
+ * Some clients have subtle differences in how they render multi-part content.
+ */
+export declare function normalizeMcpContent(content: Array<{
+    type: string;
+    text?: string;
+}>): Array<{
+    type: string;
+    text: string;
+}>;
+//# sourceMappingURL=ide-compat.d.ts.map

package/dist/agents/adapters/ide-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide-compat.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/ide-compat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,KAAK,GACb,aAAa,GACb,QAAQ,GACR,UAAU,GACV,UAAU,GACV,OAAO,GACP,KAAK,GACL,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;CAChB;AAWD,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,EAAE,CAoDlE;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,CA2FrF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAIvC"}

package/dist/agents/adapters/ide-compat.js

@@ -0,0 +1,150 @@
+/**
+ * Nexus Prime — IDE Compatibility Utilities
+ * Provides MCP config templates and detection logic for all supported IDEs.
+ *
+ * Supported: VS Code (Claude Code ext), JetBrains, Cursor, Windsurf, Zed, Continue.dev, Aider, Cline, Codex
+ */
+import { existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+/** Nexus Prime MCP server entry (stdio transport). */
+function nexusMcpServerEntry(workspaceRoot) {
+    return {
+        command: 'node',
+        args: [join(workspaceRoot, 'node_modules', 'nexus-prime', 'dist', 'cli.js'), 'mcp'],
+        env: {},
+    };
+}
+/** Detect which IDEs are present in the workspace or home directory. */
+export function detectInstalledIDEs(workspaceRoot) {
+    const detected = [];
+    const home = homedir();
+    // Claude Code: reads from ~/.claude/settings.json or project .claude/settings.json
+    if (existsSync(join(home, '.claude')) ||
+        existsSync(join(workspaceRoot, '.claude'))) {
+        detected.push('claude-code');
+    }
+    // Cursor: .cursor/ directory in workspace or home
+    if (existsSync(join(workspaceRoot, '.cursor')) ||
+        existsSync(join(home, '.cursor'))) {
+        detected.push('cursor');
+    }
+    // Windsurf: .windsurf/ directory
+    if (existsSync(join(workspaceRoot, '.windsurf')) ||
+        existsSync(join(home, '.windsurf'))) {
+        detected.push('windsurf');
+    }
+    // Continue.dev: .continue/ directory
+    if (existsSync(join(workspaceRoot, '.continue')) ||
+        existsSync(join(home, '.continue'))) {
+        detected.push('continue');
+    }
+    // Cline: VS Code extension — detected via .vscode/cline.json or cline settings
+    if (existsSync(join(workspaceRoot, '.vscode', 'cline.json'))) {
+        detected.push('cline');
+    }
+    // Zed: ~/.config/zed/
+    if (existsSync(join(home, '.config', 'zed'))) {
+        detected.push('zed');
+    }
+    // Codex: CODEX_HOME env or ~/.codex/
+    if (process.env.CODEX_HOME || existsSync(join(home, '.codex'))) {
+        detected.push('codex');
+    }
+    return detected;
+}
+/** Get the MCP config content and target path for a given IDE. */
+export function getMcpConfigForIDE(ide, workspaceRoot) {
+    const home = homedir();
+    const entry = nexusMcpServerEntry(workspaceRoot);
+    switch (ide) {
+        case 'claude-code': {
+            // Claude Code reads mcpServers from project .claude/settings.json
+            const configPath = join(workspaceRoot, '.claude', 'settings.json');
+            const content = JSON.stringify({
+                mcpServers: {
+                    'nexus-prime': entry,
+                },
+            }, null, 2);
+            return { configPath, content, merge: true };
+        }
+        case 'cursor': {
+            // Cursor uses .cursor/mcp.json in the workspace
+            const configPath = join(workspaceRoot, '.cursor', 'mcp.json');
+            const content = JSON.stringify({
+                mcpServers: {
+                    'nexus-prime': entry,
+                },
+            }, null, 2);
+            return { configPath, content, merge: true };
+        }
+        case 'windsurf': {
+            // Windsurf uses ~/.windsurf/mcp.json (global) or workspace .windsurf/mcp.json
+            const configPath = existsSync(join(workspaceRoot, '.windsurf'))
+                ? join(workspaceRoot, '.windsurf', 'mcp.json')
+                : join(home, '.windsurf', 'mcp.json');
+            const content = JSON.stringify({
+                mcpServers: {
+                    'nexus-prime': entry,
+                },
+            }, null, 2);
+            return { configPath, content, merge: true };
+        }
+        case 'continue': {
+            // Continue.dev uses ~/.continue/config.json
+            const configPath = join(home, '.continue', 'config.json');
+            const content = JSON.stringify({
+                mcpServers: {
+                    'nexus-prime': entry,
+                },
+            }, null, 2);
+            return { configPath, content, merge: true };
+        }
+        case 'cline': {
+            // Cline: .vscode/cline.json or global VS Code settings
+            const configPath = join(workspaceRoot, '.vscode', 'cline.json');
+            const content = JSON.stringify({
+                mcpServers: {
+                    'nexus-prime': entry,
+                },
+            }, null, 2);
+            return { configPath, content, merge: true };
+        }
+        case 'zed': {
+            // Zed: ~/.config/zed/settings.json
+            const configPath = join(home, '.config', 'zed', 'settings.json');
+            const content = JSON.stringify({
+                context_servers: {
+                    'nexus-prime': {
+                        command: entry.command,
+                        args: entry.args,
+                    },
+                },
+            }, null, 2);
+            return { configPath, content, merge: true };
+        }
+        case 'codex': {
+            // Codex: ~/.codex/config.json or CODEX_HOME
+            const codexHome = process.env.CODEX_HOME ?? join(home, '.codex');
+            const configPath = join(codexHome, 'config.json');
+            const content = JSON.stringify({
+                mcpServers: {
+                    'nexus-prime': entry,
+                },
+            }, null, 2);
+            return { configPath, content, merge: true };
+        }
+        default:
+            return { configPath: null, content: '{}', merge: false };
+    }
+}
+/**
+ * Normalise MCP tool response content for cross-client compatibility.
+ * Some clients have subtle differences in how they render multi-part content.
+ */
+export function normalizeMcpContent(content) {
+    return content
+        .filter((c) => c.type === 'text' && c.text != null)
+        .map((c) => ({ type: 'text', text: String(c.text ?? '') }));
+}
+//# sourceMappingURL=ide-compat.js.map

package/dist/agents/adapters/ide-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide-compat.js","sourceRoot":"","sources":["../../../src/agents/adapters/ide-compat.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAkG5C,KAAK,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAK5C,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAkYF,qBAAa,UAAW,YAAW,OAAO;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,UAAS;IAClB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAkB;IAClC,OAAO,CAAC,uBAAuB,CAAC,CAAS;IACzC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,oBAAoB,CAAgG;IAC5H,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,eAAe;IAqEvB,OAAO,CAAC,GAAG;;IAqBX,OAAO,CAAC,gBAAgB;IA4BxB,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,4BAA4B;IAepC,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,yBAAyB;IAqFjC,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,4BAA4B;IAWpC,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,yBAAyB;IA2CjC,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,YAAY;YAON,mBAAmB;IA0DjC,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,2BAA2B;IAqBnC,OAAO,CAAC,uBAAuB;IAkC/B,cAAc,CAAC,OAAO,GAAE,cAAsC,GAAG,iBAAiB,EAAE;IAIpF,OAAO,CAAC,oBAAoB;IAg/B5B,OAAO,CAAC,iBAAiB;YAuGX,cAAc;IAo/E5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,OAAO,CAAC,IAAI;IAmBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;CAOzC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmG5C,KAAK,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAK5C,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AA8ZF,qBAAa,UAAW,YAAW,OAAO;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAG,KAAK,CAAU;IACtB,SAAS,UAAS;IAClB,MAAM,EAAE,MAAM,EAAE,CAAM;IAEtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAkB;IAClC,OAAO,CAAC,uBAAuB,CAAC,CAAS;IACzC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,oBAAoB,CAAgG;IAC5H,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,eAAe;IAqEvB,OAAO,CAAC,GAAG;;IAqBX,OAAO,CAAC,gBAAgB;IA4BxB,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,4BAA4B;IAepC,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,yBAAyB;IAqFjC,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,4BAA4B;IAWpC,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,yBAAyB;IA2CjC,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,YAAY;YAON,mBAAmB;IA0DjC,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,2BAA2B;IAqBnC,OAAO,CAAC,uBAAuB;IAkC/B,cAAc,CAAC,OAAO,GAAE,cAAsC,GAAG,iBAAiB,EAAE;IAIpF,OAAO,CAAC,oBAAoB;IAg/B5B,OAAO,CAAC,iBAAiB;YAmHX,cAAc;IA8gF5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,OAAO,CAAC,IAAI;IAmBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;CAOzC"}

package/dist/agents/adapters/mcp.js

@@ -5,7 +5,7 @@ import { statSync, readdirSync } from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import { execSync } from 'child_process';
-import { createHash } from 'crypto';
+import { createHash, randomUUID } from 'crypto';
 import { TokenSupremacyEngine, formatReadingPlan } from '../../engines/token-supremacy.js';
 import { GhostPass, createSubAgentRuntime, summarizeExecution, } from '../../phantom/index.js';
 import { GuardrailEngine } from '../../engines/guardrails-bridge.js';
@@ -32,6 +32,7 @@ import { MiddlewarePipeline } from '../../engines/middleware-pipeline.js';
 import { applyExecutionPreset, listExecutionPresets, resolveExecutionPreset } from '../../engines/execution-presets.js';
 import { ensureBootstrap } from '../../engines/client-bootstrap.js';
 import { resolveWorkspaceContext, resolveWorkspaceStateRoot } from '../../engines/workspace-resolver.js';
+import { hasValidBootstrapReceipt } from '../../engines/bootstrap/index.js';
 import { synapseToolDefinitions, handleSynapseToolCall } from '../../synapse/index.js';
 import { architectsToolDefinitions, handleArchitectsToolCall } from '../../architects/index.js';
 const tokenEngine = new TokenSupremacyEngine();
@@ -448,6 +449,46 @@ function buildResultPreview(result) {
         textPreview: truncateText(text, 900),
     };
 }
+/**
+ * Recursively collect files under `folderAbs`, optionally filtered by extension.
+ * Only descends into directories within the same workspace root (caller must pre-validate root).
+ * Skips hidden directories and node_modules to stay bounded.
+ */
+function collectFolderFiles(folderAbs, folderGlob) {
+    const extFilter = folderGlob ? folderGlob.replace(/^\*/, '') : null; // "*.ts" → ".ts"
+    const results = [];
+    const walk = (dir, depth) => {
+        if (depth > 12)
+            return; // hard depth cap
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.startsWith('.') || entry === 'node_modules' || entry === 'dist')
+                continue;
+            const full = path.join(dir, entry);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                walk(full, depth + 1);
+            }
+            else if (!extFilter || full.endsWith(extFilter)) {
+                results.push(full);
+            }
+        }
+    };
+    walk(folderAbs, 0);
+    return results;
+}
 export class MCPAdapter {
     name;
     type = 'mcp';
@@ -589,7 +630,7 @@ export class MCPAdapter {
     constructor() {
         this.name = this.detectCallerName();
         this.server = new Server({ name: 'nexus-prime-mcp', version: '0.4.0' }, { capabilities: { tools: {} } });
-        this.sessionDNA = new SessionDNAManager(crypto.randomUUID?.() ?? `session-${Date.now()}`);
+        this.sessionDNA = new SessionDNAManager(randomUUID());
         this.middlewarePipeline = new MiddlewarePipeline();
         this.registerBuiltInMiddleware();
         this.setupToolHandlers();
@@ -2046,7 +2087,22 @@ export class MCPAdapter {
                 this.telemetry.bootstrapped = true;
             }
             const args = request.params.arguments ?? (request.params.arguments = {});
-            // Gate: block non-bootstrap tools BEFORE executing them to avoid wasted work and side effects
+            // Gate: block non-bootstrap tools BEFORE executing them to avoid wasted work and side effects.
+            // Check both the in-memory flag AND the durable bootstrap receipt (survives restarts).
+            const hasDurableReceipt = (() => {
+                try {
+                    const ws = resolveWorkspaceContext();
+                    const stateRoot = resolveWorkspaceStateRoot(ws.workspaceRoot);
+                    return hasValidBootstrapReceipt(stateRoot);
+                }
+                catch {
+                    return false;
+                }
+            })();
+            if (hasDurableReceipt && !this.telemetry.bootstrapped) {
+                // Restore in-memory flag from durable receipt
+                this.telemetry.bootstrapped = true;
+            }
             if (!this.telemetry.bootstrapped &&
                 !PRE_BOOTSTRAP_ALLOWED_TOOLS.has(toolName) &&
                 !toolName.startsWith('nexus_list_')) {
@@ -2283,7 +2339,7 @@ export class MCPAdapter {
                         summary: {
                             clientBootstrapClients: bootstrap.clientBootstrapStatus?.clients?.length ?? 0,
                             taskGraphPhases: bootstrap.taskGraphPreview?.phases?.length ?? 0,
-                            workerLanes: bootstrap.workerPlanPreview?.totalWorkers ?? 0,
+                            totalWorkers: bootstrap.workerPlanPreview?.totalWorkers ?? 0,
                             selectedArtifacts: bootstrap.artifactSelectionAudit?.selected?.length ?? 0,
                         },
                     };
@@ -2305,7 +2361,7 @@ export class MCPAdapter {
                                     `Knowledge fabric: ${bootstrap.sourceMixRecommendation?.dominantSource || bootstrap.knowledgeFabric?.dominantSource || 'awaiting source mix'}`,
                                     `RAG: ${bootstrap.ragCandidateStatus?.attachedCollections || 0} attached · ${bootstrap.ragCandidateStatus?.retrievedChunks || 0} retrieved`,
                                     `Task graph: ${bootstrap.taskGraphPreview?.phases?.length || 0} phases · ${bootstrap.taskGraphPreview?.independentBranches || 0} branches`,
-                                    `Worker plan: ${bootstrap.workerPlanPreview?.totalWorkers || 0} lanes planned`,
+                                    `Worker plan: ${bootstrap.workerPlanPreview?.totalWorkers || 0} workers planned`,
                                     `Payload ref: ${workspace.stateKey} · ${detailLevel}`,
                                     `Session summary: ${bootstrap.sessionSummaryBootstrap?.savedTokens ? `reused ${Number(bootstrap.sessionSummaryBootstrap.savedTokens || 0).toLocaleString()} tokens from the previous visit` : 'none available yet'}`,
                                     bootstrap.projectMemoryBootstrap?.count
@@ -2491,7 +2547,7 @@ export class MCPAdapter {
                                         `Crew: ${execution.plannerState?.selectedCrew?.name || 'baseline path'}`,
                                         `Specialists: ${execution.plannerState?.selectedSpecialists.map((specialist) => specialist.name).slice(0, 4).join(', ') || 'none selected'}`,
                                         `Assets: ${(execution.activeSkills || []).length} skills · ${(execution.activeWorkflows || []).length} workflows · ${(runtimeUsage.artifactSelectionAudit?.selected?.length || 0)} audited selections`,
-                                        `Task graph: ${runtimeUsage.taskGraph?.phases?.length || execution.taskGraph?.phases?.length || 0} phases · ${runtimeUsage.workerPlan?.totalWorkers || execution.workerPlan?.totalWorkers || 0} worker lanes`,
+                                        `Task graph: ${runtimeUsage.taskGraph?.phases?.length || execution.taskGraph?.phases?.length || 0} phases · ${runtimeUsage.workerPlan?.totalWorkers || execution.workerPlan?.totalWorkers || 0} workers`,
                                         `Catalog health: ${runtimeUsage.catalogHealth?.overall || 'unknown'}`,
                                         preset ? `Preset: ${preset.name} (${preset.id})` : null,
                                         `Verification: ${verifiedWorkers}/${execution.workerResults.length} worker(s) verified`,
@@ -3986,15 +4042,42 @@ export class MCPAdapter {
             }
             case 'nexus_rag_ingest_collection': {
                 const collectionId = String(request.params.arguments?.collectionId ?? '');
-                const inputs = Array.isArray(request.params.arguments?.inputs)
-                    ? request.params.arguments.inputs.map((entry) => ({
-                        filePath: entry?.filePath ? String(entry.filePath) : undefined,
-                        url: entry?.url ? String(entry.url) : undefined,
-                        text: entry?.text ? String(entry.text) : undefined,
-                        label: entry?.label ? String(entry.label) : undefined,
-                        tags: Array.isArray(entry?.tags) ? entry.tags.map(String) : [],
-                    }))
+                const rawInputs = Array.isArray(request.params.arguments?.inputs)
+                    ? request.params.arguments.inputs
                     : [];
+                const inputs = [];
+                for (const entry of rawInputs) {
+                    if (entry?.folderPath) {
+                        // Expand folder into individual file entries (bounded to workspace root)
+                        const folderAbs = path.resolve(String(entry.folderPath));
+                        if (!this.isPackageLikeWorkspace(folderAbs)) {
+                            inputs.push({
+                                text: `[skipped] folder path outside workspace root: ${folderAbs}`,
+                                label: 'security-skip',
+                                tags: ['skipped'],
+                            });
+                            continue;
+                        }
+                        const folderGlob = entry?.folderGlob ? String(entry.folderGlob) : undefined;
+                        const files = collectFolderFiles(folderAbs, folderGlob);
+                        for (const f of files) {
+                            inputs.push({
+                                filePath: f,
+                                label: entry?.label ? String(entry.label) : undefined,
+                                tags: Array.isArray(entry?.tags) ? entry.tags.map(String) : [],
+                            });
+                        }
+                    }
+                    else {
+                        inputs.push({
+                            filePath: entry?.filePath ? String(entry.filePath) : undefined,
+                            url: entry?.url ? String(entry.url) : undefined,
+                            text: entry?.text ? String(entry.text) : undefined,
+                            label: entry?.label ? String(entry.label) : undefined,
+                            tags: Array.isArray(entry?.tags) ? entry.tags.map(String) : [],
+                        });
+                    }
+                }
                 const result = await this.getOrchestrator().ingestRagCollection(collectionId, inputs);
                 return {
                     content: [{