nexus-prime 5.1.1 → 5.1.2

package/README.md

@@ -629,6 +629,16 @@ 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>
 

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;IAikF5B,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' },
                     },
@@ -2256,11 +2266,13 @@ export class MCPAdapter {
                 }
                 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).
                 // Debug calls always bypass the fast-path so callers get the full structured payload.
-                if (this.telemetry.bootstrapCallCount > 0 && normalizeDetailLevel(request.params.arguments?.detailLevel) !== 'debug') {
+                if (this.telemetry.bootstrapCallCount > 0 && bootstrapDepth !== 'deep') {
                     const hasFreshReceipt = (() => {
                         try {
                             const ws = resolveWorkspaceContext();
@@ -2292,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();
@@ -2305,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(),
@@ -2339,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,
@@ -2363,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,
@@ -2392,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,
@@ -2410,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'}`,
@@ -2421,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