nexus-prime 5.0.2 → 5.1.1

package/README.md

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

package/dist/agents/adapters/mcp.js

@@ -174,6 +174,13 @@ const PRE_BOOTSTRAP_ALLOWED_TOOLS = new Set([
     'nexus_describe_tool',
     'nexus_federation_status',
     'nexus_status',
+    // Specific list tools allowed pre-bootstrap for catalog discovery only:
+    'nexus_list_skills',
+    'nexus_list_workflows',
+    'nexus_list_hooks',
+    'nexus_list_automations',
+    'nexus_list_specialists',
+    'nexus_list_crews',
 ]);
 /** Session-level telemetry tracker */
 class SessionTelemetry {
@@ -193,6 +200,7 @@ class SessionTelemetry {
     tokenAutoApplied = false;
     stickyTokenOptimization = false;
     bootstrapped = false;
+    bootstrapCallCount = 0;
     recordCall() {
         this.callCount++;
         if (this.isPostOrchestratePhase()) {
@@ -2104,8 +2112,7 @@ export class MCPAdapter {
                 this.telemetry.bootstrapped = true;
             }
             if (!this.telemetry.bootstrapped &&
-                !PRE_BOOTSTRAP_ALLOWED_TOOLS.has(toolName) &&
-                !toolName.startsWith('nexus_list_')) {
+                !PRE_BOOTSTRAP_ALLOWED_TOOLS.has(toolName)) {
                 return {
                     content: [{
                             type: 'text',
@@ -2227,8 +2234,60 @@ 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 ?? '');
+                // 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') {
+                    const hasFreshReceipt = (() => {
+                        try {
+                            const ws = resolveWorkspaceContext();
+                            const stateRoot = resolveWorkspaceStateRoot(ws.workspaceRoot);
+                            return hasValidBootstrapReceipt(stateRoot);
+                        }
+                        catch {
+                            return false;
+                        }
+                    })();
+                    if (hasFreshReceipt) {
+                        this.telemetry.bootstrapCallCount++;
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: [
+                                        'Session already bootstrapped (fast-path — receipt is fresh).',
+                                        'Skipping full re-bootstrap to avoid loop overhead.',
+                                        `Goal: ${bootstrapGoal || '(same as prior call)'}`,
+                                        'Recommended next step: nexus_orchestrate',
+                                        this.formatProtocolChecklist(),
+                                    ].join('\n\n'),
+                                }],
+                        };
+                    }
+                }
+                this.telemetry.bootstrapCallCount++;
                 this.currentTask = bootstrapGoal;
                 const files = Array.isArray(request.params.arguments?.files)
                     ? request.params.arguments.files.map(String)