nexus-prime 3.10.0 → 3.11.0

package/README.md

@@ -338,6 +338,13 @@ nexus-prime setup status
 ---
 
 ## 📜 Changelog
+### v3.11.0 "Knowledge Fabric"
+- **New Knowledge Fabric layer now assembles bounded execution bundles across repo code, memory, session RAG collections, reusable patterns, and prior runtime traces**
+- **Session-first RAG collections and the pattern registry now feed orchestrated runs, runtime truth, and dashboard provenance instead of living outside the control plane**
+- **`CI & Publish` now mirrors the real release gate on pull requests with build, lint, full tests, and `npm pack --dry-run` before publish is allowed**
+- **RAG collection IDs are sanitized before filesystem access, and remote URL ingestion now times out instead of hanging indefinitely**
+- **TypeScript tests and public-surface checks now run through `tsx`, keeping local and GitHub Actions behavior aligned**
+
 ### v3.10.0 "Autonomous Bootstrap"
 - **New `nexus_session_bootstrap` entrypoint gives external clients one compact session-start tool with memory recall, stats, shortlist guidance, and token-optimization expectations**
 - **MCP now defaults to an `autonomous` tool profile, keeping `nexus_session_bootstrap` and `nexus_orchestrate` first while reserving the full expert surface for manual work**

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

@@ -34,8 +34,8 @@ export declare class MCPAdapter implements Adapter {
     private walk;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    send(_message: NetworkMessage): Promise<void>;
-    receive(_message: NetworkMessage): void;
+    send(message: NetworkMessage): Promise<void>;
+    receive(message: NetworkMessage): void;
 }
 export {};
 //# sourceMappingURL=mcp.d.ts.map

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":"AAYA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgE5C,KAAK,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAC5C,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;AAsKF,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;IAElC,OAAO,CAAC,GAAG;;IAmBX,OAAO,CAAC,gBAAgB;IA4BxB,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,uBAAuB;IAsB/B,cAAc,CAAC,OAAO,GAAE,cAAsC,GAAG,iBAAiB,EAAE;IAIpF,OAAO,CAAC,oBAAoB;IA2mB5B,OAAO,CAAC,iBAAiB;YAuCX,cAAc;IAm7C5B,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;IAkB3B,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IACnD,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;CAC1C"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/agents/adapters/mcp.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgE5C,KAAK,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC;AAC5C,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;AA+KF,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;IAElC,OAAO,CAAC,GAAG;;IAmBX,OAAO,CAAC,gBAAgB;IA4BxB,WAAW,CAAC,KAAK,EAAE,UAAU;IAI7B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,uBAAuB;IAsB/B,cAAc,CAAC,OAAO,GAAE,cAAsC,GAAG,iBAAiB,EAAE;IAIpF,OAAO,CAAC,oBAAoB;IAytB5B,OAAO,CAAC,iBAAiB;YAuCX,cAAc;IA6iD5B,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;IAkB3B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;CACzC"}

package/dist/agents/adapters/mcp.js

@@ -105,6 +105,15 @@ const MANUAL_OR_DIAGNOSTIC_TOOLS = new Set([
     'nexus_assemble_context',
     'nexus_execute_nxl',
     'nexus_publish_trace',
+    'nexus_rag_list_collections',
+    'nexus_rag_create_collection',
+    'nexus_rag_ingest_collection',
+    'nexus_rag_attach_collection',
+    'nexus_rag_detach_collection',
+    'nexus_rag_delete_collection',
+    'nexus_pattern_search',
+    'nexus_pattern_list',
+    'nexus_knowledge_provenance',
 ]);
 /** Session-level telemetry tracker */
 class SessionTelemetry {
@@ -780,6 +789,116 @@ export class MCPAdapter {
                     properties: {},
                 },
             },
+            {
+                name: 'nexus_rag_list_collections',
+                description: 'Expert surface: list session-first RAG collections managed by Nexus Prime.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'nexus_rag_create_collection',
+                description: 'Expert surface: create a session-first RAG collection outside the git repo.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'Collection name' },
+                        description: { type: 'string', description: 'Optional collection description' },
+                        tags: { type: 'array', items: { type: 'string' }, description: 'Collection tags' },
+                        scope: { type: 'string', enum: ['session', 'project'], description: 'Collection scope' },
+                    },
+                    required: ['name'],
+                },
+            },
+            {
+                name: 'nexus_rag_ingest_collection',
+                description: 'Expert surface: ingest local files, URLs, or raw text into a RAG collection.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        collectionId: { type: 'string', description: 'Collection id' },
+                        inputs: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    filePath: { type: 'string' },
+                                    url: { type: 'string' },
+                                    text: { type: 'string' },
+                                    label: { type: 'string' },
+                                    tags: { type: 'array', items: { type: 'string' } },
+                                },
+                            },
+                            description: 'Collection sources',
+                        },
+                    },
+                    required: ['collectionId', 'inputs'],
+                },
+            },
+            {
+                name: 'nexus_rag_attach_collection',
+                description: 'Expert surface: attach an existing RAG collection to the active runtime/session.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        collectionId: { type: 'string', description: 'Collection id' },
+                    },
+                    required: ['collectionId'],
+                },
+            },
+            {
+                name: 'nexus_rag_detach_collection',
+                description: 'Expert surface: detach a RAG collection from the active runtime/session.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        collectionId: { type: 'string', description: 'Collection id' },
+                    },
+                    required: ['collectionId'],
+                },
+            },
+            {
+                name: 'nexus_rag_delete_collection',
+                description: 'Expert surface: delete a RAG collection from Nexus state.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        collectionId: { type: 'string', description: 'Collection id' },
+                    },
+                    required: ['collectionId'],
+                },
+            },
+            {
+                name: 'nexus_pattern_search',
+                description: 'Expert surface: search bounded orchestration pattern cards that can shape a run.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: 'Pattern search query' },
+                        limit: { type: 'number', description: 'Optional result limit' },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'nexus_pattern_list',
+                description: 'Expert surface: list the top bounded orchestration pattern cards available to Nexus Prime.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        limit: { type: 'number', description: 'Optional result limit' },
+                    },
+                },
+            },
+            {
+                name: 'nexus_knowledge_provenance',
+                description: 'Expert surface: inspect the latest knowledge-fabric provenance trace for the active runtime.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
             {
                 name: 'nexus_run_status',
                 description: 'Return the current recorded state of a runtime execution run.',
@@ -1031,6 +1150,7 @@ export class MCPAdapter {
                                 shortlist: bootstrap.shortlist,
                                 tokenOptimization: bootstrap.tokenOptimization,
                                 reviewGates: bootstrap.reviewGates,
+                                knowledgeFabric: bootstrap.knowledgeFabric,
                                 mcpToolProfile: this.getToolProfile(),
                             }, null, 2),
                         }],
@@ -1912,6 +2032,82 @@ export class MCPAdapter {
                         }],
                 };
             }
+            case 'nexus_rag_list_collections': {
+                const collections = this.getOrchestrator().listRagCollections();
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                total: collections.length,
+                                collections,
+                            }, null, 2),
+                        }],
+                };
+            }
+            case 'nexus_rag_create_collection': {
+                const name = String(request.params.arguments?.name ?? '');
+                const description = request.params.arguments?.description ? String(request.params.arguments.description) : undefined;
+                const tags = Array.isArray(request.params.arguments?.tags)
+                    ? request.params.arguments.tags.map(String)
+                    : [];
+                const scope = String(request.params.arguments?.scope ?? 'session') === 'project' ? 'project' : 'session';
+                const collection = this.getOrchestrator().createRagCollection({ name, description, tags, scope });
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(collection, null, 2),
+                        }],
+                };
+            }
+            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 result = await this.getOrchestrator().ingestRagCollection(collectionId, inputs);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        }],
+                };
+            }
+            case 'nexus_rag_attach_collection': {
+                const collectionId = String(request.params.arguments?.collectionId ?? '');
+                const collection = this.getOrchestrator().attachRagCollection(collectionId);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(collection, null, 2),
+                        }],
+                };
+            }
+            case 'nexus_rag_detach_collection': {
+                const collectionId = String(request.params.arguments?.collectionId ?? '');
+                const collection = this.getOrchestrator().detachRagCollection(collectionId);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(collection, null, 2),
+                        }],
+                };
+            }
+            case 'nexus_rag_delete_collection': {
+                const collectionId = String(request.params.arguments?.collectionId ?? '');
+                const removed = this.getOrchestrator().deleteRagCollection(collectionId);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({ collectionId, removed }, null, 2),
+                        }],
+                };
+            }
             case 'nexus_list_workflows': {
                 const workflows = this.getRuntime().listWorkflows();
                 return {
@@ -1971,6 +2167,42 @@ export class MCPAdapter {
                         }],
                 };
             }
+            case 'nexus_pattern_search': {
+                const query = String(request.params.arguments?.query ?? '');
+                const limit = Number(request.params.arguments?.limit ?? 6);
+                const results = this.getOrchestrator().searchPatterns(query, limit);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                total: results.length,
+                                patterns: results,
+                            }, null, 2),
+                        }],
+                };
+            }
+            case 'nexus_pattern_list': {
+                const limit = Number(request.params.arguments?.limit ?? 8);
+                const results = this.getOrchestrator().listPatterns().slice(0, Math.max(1, limit));
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                total: results.length,
+                                patterns: results,
+                            }, null, 2),
+                        }],
+                };
+            }
+            case 'nexus_knowledge_provenance': {
+                const provenance = this.getOrchestrator().getKnowledgeFabricProvenance();
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify(provenance, null, 2),
+                        }],
+                };
+            }
             case 'nexus_run_status': {
                 const runId = String(request.params.arguments?.runId ?? '');
                 const run = this.getRuntime().getRun(runId);
@@ -2343,7 +2575,7 @@ export class MCPAdapter {
         this.connected = false;
         console.error('[MCP Adapter] Disconnected');
     }
-    async send(_message) { }
-    receive(_message) { }
+    async send(message) { void message; }
+    receive(message) { void message; }
 }
 //# sourceMappingURL=mcp.js.map