nexus-prime 5.0.3 → 5.1.2

package/README.md

@@ -629,6 +629,37 @@ Inventory Snapshot: 109 skills · 64 workflows · 9 hooks · 5 automations · 7
 
 ## 📜 Release History
 
+<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>
 

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;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;AAsaF,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;YAkHX,cAAc;IA2iF5B,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;AA6aF,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;IAk/B5B,OAAO,CAAC,iBAAiB;YAkHX,cAAc;IAslF5B,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

@@ -419,6 +419,14 @@ function normalizeDetailLevel(value) {
         return normalized;
     return 'compact';
 }
+function normalizeBootstrapDepth(value, detailLevel) {
+    const normalized = String(value ?? '').toLowerCase();
+    if (normalized === 'deep')
+        return 'deep';
+    if (normalized === 'fast')
+        return 'fast';
+    return detailLevel === 'debug' ? 'deep' : 'fast';
+}
 function normalizeResponseIntent(value) {
     const normalized = String(value ?? 'inspect').toLowerCase();
     if (normalized === 'plan' || normalized === 'mutate')
@@ -1266,13 +1274,15 @@ export class MCPAdapter {
             },
             {
                 name: 'nexus_session_bootstrap',
-                description: 'Read-only session-start summary. Returns current client identity, memory recall summary, memory stats, recommended next step, recommended execution mode, shortlist recommendations, and whether token optimization will be required.',
+                description: 'Read-only session-start summary. Defaults to fast readiness mode and returns current client identity, memory recall summary, memory stats, recommended next step, recommended execution mode, shortlist recommendations, and whether deeper preparation is still needed.',
                 inputSchema: {
                     type: 'object',
                     properties: {
                         goal: { type: 'string', description: 'Raw goal or task description for this session' },
                         files: { type: 'array', items: { type: 'string' }, description: 'Optional candidate file constraints' },
                         detailLevel: { type: 'string', enum: ['compact', 'standard', 'debug'], description: 'Response verbosity; defaults to compact for MCP callers' },
+                        depth: { type: 'string', enum: ['fast', 'deep'], description: 'Optional bootstrap depth override; defaults to fast unless debug mode is requested' },
+                        include: { type: 'array', items: { type: 'string' }, description: 'Optional rich payload sections to include for advanced clients' },
                         intent: { type: 'string', enum: ['inspect', 'plan', 'mutate'], description: 'Requested orchestration stance for the bootstrap summary' },
                         topology: { type: 'string', enum: ['auto', 'manager-tools', 'handoff', 'dag-pool', 'worktree-swarm'], description: 'Requested orchestration topology hint' },
                     },
@@ -2234,12 +2244,35 @@ export class MCPAdapter {
         }
         switch (request.params.name) {
             case 'nexus_session_bootstrap': {
+                // Wait for deferred engine startup before attempting bootstrap.
+                // If MCP receives this call during the setImmediate window before
+                // finishEngineStartup completes, we wait here rather than crashing
+                // into a stub runtime (which lacks planExecution and would loop).
+                if (this.nexusRef) {
+                    try {
+                        await Promise.race([
+                            this.nexusRef.awaitReady(),
+                            new Promise((_, reject) => setTimeout(() => reject(new Error('nexus_startup_timeout')), 8000)),
+                        ]);
+                    }
+                    catch {
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: 'Nexus Prime is still initializing. Please retry nexus_session_bootstrap in a moment.',
+                                }],
+                        };
+                    }
+                }
                 const callStartedAt = Date.now();
                 const bootstrapGoal = String(request.params.arguments?.goal ?? request.params.arguments?.prompt ?? '');
+                const detailLevel = normalizeDetailLevel(request.params.arguments?.detailLevel);
+                const bootstrapDepth = normalizeBootstrapDepth(request.params.arguments?.depth, detailLevel);
                 // Fast-path: if already bootstrapped in this MCP session and receipt is still fresh,
                 // return a lightweight ack instead of re-running the full expensive bootstrap.
                 // This makes bootstrap idempotent for loop-based callers (e.g. /loop skill, Antigravity).
-                if (this.telemetry.bootstrapCallCount > 0) {
+                // Debug calls always bypass the fast-path so callers get the full structured payload.
+                if (this.telemetry.bootstrapCallCount > 0 && bootstrapDepth !== 'deep') {
                     const hasFreshReceipt = (() => {
                         try {
                             const ws = resolveWorkspaceContext();
@@ -2271,10 +2304,16 @@ export class MCPAdapter {
                 const files = Array.isArray(request.params.arguments?.files)
                     ? request.params.arguments.files.map(String)
                     : undefined;
-                const detailLevel = normalizeDetailLevel(request.params.arguments?.detailLevel);
+                const include = Array.isArray(request.params.arguments?.include)
+                    ? request.params.arguments.include.map(String)
+                    : undefined;
                 const requestedIntent = normalizeResponseIntent(request.params.arguments?.intent);
                 const requestedTopology = normalizeResponseTopology(request.params.arguments?.topology);
-                const bootstrap = await this.getOrchestrator().bootstrapSession(bootstrapGoal, { files });
+                const bootstrap = await this.getOrchestrator().bootstrapSession(bootstrapGoal, {
+                    files,
+                    depth: bootstrapDepth,
+                    include,
+                });
                 const autoTokenApplied = Boolean(bootstrap.tokenOptimization?.autoApplied);
                 if (autoTokenApplied) {
                     this.telemetry.markTokenAutoApplied();
@@ -2284,7 +2323,7 @@ export class MCPAdapter {
                 }
                 this.getRuntime().recordClientToolCall('nexus_session_bootstrap', {
                     bootstrapCalled: true,
-                    plannerCalled: true,
+                    plannerCalled: bootstrap.depth === 'deep',
                     tokenOptimizationApplied: autoTokenApplied,
                     tokenAutoApplied: autoTokenApplied,
                     toolProfile: this.getToolProfile(),
@@ -2318,10 +2357,14 @@ export class MCPAdapter {
                 };
                 const payload = detailLevel === 'debug'
                     ? {
+                        depth: bootstrap.depth,
                         workspace,
                         client: bootstrap.client,
                         memoryRecall: bootstrap.memoryRecall,
                         memoryStats: bootstrap.memoryStats,
+                        memoryHealth: bootstrap.memoryHealth,
+                        needsDeepBootstrap: bootstrap.needsDeepBootstrap,
+                        changedSinceLastSession: bootstrap.changedSinceLastSession,
                         recommendedNextStep: bootstrap.recommendedNextStep,
                         recommendedExecutionMode: bootstrap.recommendedExecutionMode,
                         shortlist: bootstrap.shortlist,
@@ -2342,16 +2385,21 @@ export class MCPAdapter {
                         payloadRef: {
                             workspaceStateKey: workspace.stateKey,
                             detailLevel,
+                            depth: bootstrapDepth,
                             intent: requestedIntent,
                             topology: requestedTopology,
                         },
                         mcpToolProfile: this.getToolProfile(),
                     }
                     : {
+                        depth: bootstrap.depth,
                         workspace,
                         client: bootstrap.client,
                         memoryRecall: bootstrap.memoryRecall,
                         memoryStats: bootstrap.memoryStats,
+                        memoryHealth: bootstrap.memoryHealth,
+                        needsDeepBootstrap: bootstrap.needsDeepBootstrap,
+                        changedSinceLastSession: bootstrap.changedSinceLastSession,
                         recommendedNextStep: bootstrap.recommendedNextStep,
                         recommendedExecutionMode: bootstrap.recommendedExecutionMode,
                         shortlist: bootstrap.shortlist,
@@ -2371,10 +2419,12 @@ export class MCPAdapter {
                         payloadRef: {
                             workspaceStateKey: workspace.stateKey,
                             detailLevel,
+                            depth: bootstrapDepth,
                             intent: requestedIntent,
                             topology: requestedTopology,
                         },
                         summary: {
+                            bootstrapDepth: bootstrap.depth ?? bootstrapDepth,
                             clientBootstrapClients: bootstrap.clientBootstrapStatus?.clients?.length ?? 0,
                             taskGraphPhases: bootstrap.taskGraphPreview?.phases?.length ?? 0,
                             totalWorkers: bootstrap.workerPlanPreview?.totalWorkers ?? 0,
@@ -2389,6 +2439,7 @@ export class MCPAdapter {
                                 formatBullets([
                                     `Workspace: ${workspace.repoName} (${workspace.workspaceSource})`,
                                     `Client: ${bootstrap.client?.displayName || bootstrap.client?.clientId || 'unknown'} (${bootstrap.client?.state || 'unknown'})`,
+                                    `Bootstrap depth: ${bootstrap.depth || bootstrapDepth}`,
                                     `Memory recall: ${bootstrap.memoryRecall?.count ?? 0} result(s)`,
                                     `Memory stats: prefrontal ${bootstrap.memoryStats?.prefrontal ?? 0} · hippocampus ${bootstrap.memoryStats?.hippocampus ?? 0} · cortex ${bootstrap.memoryStats?.cortex ?? 0}`,
                                     `Recommended next step: ${bootstrap.recommendedNextStep || 'nexus_orchestrate'}`,
@@ -2400,6 +2451,7 @@ export class MCPAdapter {
                                     `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} workers planned`,
+                                    bootstrap.needsDeepBootstrap ? 'Deep preparation: still recommended before risky or cross-file work' : 'Deep preparation: not currently required',
                                     `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