@vfarcic/dot-ai 1.23.1 → 1.24.0

package/dist/mcp/server.js

@@ -48,6 +48,7 @@ const index_js_1 = require("../core/index.js");
 const index_js_2 = require("../core/tracing/index.js");
 const index_js_3 = require("../core/telemetry/index.js");
 const plugin_registry_js_1 = require("../core/plugin-registry.js");
+const knowledge_migration_js_1 = require("../core/knowledge-migration.js");
 const mcp_client_registry_js_1 = require("../core/mcp-client-registry.js");
 const mcp_client_manager_js_1 = require("../core/mcp-client-manager.js");
 const fs_1 = require("fs");
@@ -156,6 +157,11 @@ async function main() {
                     process.stderr.write(`Background discovery: Plugin '${plugin.name}' now available with ${plugin.tools.length} tool(s)\n`);
                     // Note: Tools are automatically registered via pluginManager's internal maps
                     // The version tool will reflect the updated plugin status
+                    if (plugin.tools.some((tool) => tool.name === 'vector_store')) {
+                        (0, knowledge_migration_js_1.runKnowledgeMigration)(new error_handling_js_1.ConsoleLogger('KnowledgeMigration')).catch((err) => {
+                            process.stderr.write(`Knowledge migration (post-discovery) error: ${err instanceof Error ? err.message : String(err)}\n`);
+                        });
+                    }
                 });
                 pluginManager.startBackgroundDiscovery();
             }
@@ -168,6 +174,12 @@ async function main() {
         if (pluginConfigs.length > 0) {
             (0, plugin_registry_js_1.initializePluginRegistry)(pluginManager);
         }
+        // PRD #375: Auto-migrate legacy patterns/policies into unified knowledge-base
+        if (pluginConfigs.length > 0) {
+            const migrationLogger = new error_handling_js_1.ConsoleLogger('KnowledgeMigration');
+            process.stderr.write('Checking for legacy knowledge collections to migrate...\n');
+            await (0, knowledge_migration_js_1.runKnowledgeMigration)(migrationLogger);
+        }
         // PRD #358: Initialize MCP client for connecting to external MCP servers
         const mcpClientLogger = new error_handling_js_1.ConsoleLogger('McpClientManager');
         const mcpClientManager = new mcp_client_manager_js_1.McpClientManager(mcpClientLogger);

package/dist/tools/manage-knowledge.d.ts

@@ -9,7 +9,6 @@
 import { z } from 'zod';
 import { Logger } from '../core/error-handling';
 import { DotAI } from '../core/index';
-import { KnowledgeSearchResultItem } from '../core/knowledge-types';
 export declare const MANAGE_KNOWLEDGE_TOOL_NAME = "manageKnowledge";
 export declare const MANAGE_KNOWLEDGE_TOOL_DESCRIPTION: string;
 export declare const MANAGE_KNOWLEDGE_TOOL_INPUT_SCHEMA: {
@@ -39,27 +38,6 @@ export interface ManageKnowledgeInput {
     uriFilter?: string;
     interaction_id?: string;
 }
-/**
- * Result type for the reusable search function
- */
-export interface SearchKnowledgeBaseResult {
-    success: boolean;
-    chunks: KnowledgeSearchResultItem[];
-    totalMatches: number;
-    error?: string;
-}
-/**
- * Reusable knowledge base search function.
- * Can be called from MCP tool handler or HTTP endpoints.
- *
- * @param params Search parameters
- * @returns Search results with chunks or error
- */
-export declare function searchKnowledgeBase(params: {
-    query: string;
-    limit?: number;
-    uriFilter?: string;
-}): Promise<SearchKnowledgeBaseResult>;
 /**
  * MCP response format with content array
  */

package/dist/tools/manage-knowledge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manage-knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/manage-knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAGtC,OAAO,EAIL,yBAAyB,EAE1B,MAAM,yBAAyB,CAAC;AAUjC,eAAO,MAAM,0BAA0B,oBAAoB,CAAC;AAC5D,eAAO,MAAM,iCAAiC,QAKgB,CAAC;AAG/D,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;CAkC9C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAiPD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA4HrC;AA2ND;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAgBD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,KAAK,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAiD1B"}
+{"version":3,"file":"manage-knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/manage-knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAuFtC,eAAO,MAAM,0BAA0B,oBAAoB,CAAC;AAC5D,eAAO,MAAM,iCAAiC,QAKgB,CAAC;AAG/D,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;CAkC9C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAwcD;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAgBD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,KAAK,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAiD1B"}

package/dist/tools/manage-knowledge.js

@@ -9,17 +9,67 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MANAGE_KNOWLEDGE_TOOL_INPUT_SCHEMA = exports.MANAGE_KNOWLEDGE_TOOL_DESCRIPTION = exports.MANAGE_KNOWLEDGE_TOOL_NAME = void 0;
-exports.searchKnowledgeBase = searchKnowledgeBase;
 exports.handleManageKnowledgeTool = handleManageKnowledgeTool;
 const zod_1 = require("zod");
 const plugin_registry_1 = require("../core/plugin-registry");
 const embedding_service_1 = require("../core/embedding-service");
 const request_context_1 = require("../interfaces/request-context");
 const rbac_1 = require("../core/rbac");
+const ai_provider_factory_1 = require("../core/ai-provider-factory");
+const shared_prompt_loader_1 = require("../core/shared-prompt-loader");
+const knowledge_service_1 = require("../core/knowledge-service");
 /**
- * Collection name for knowledge base chunks in Qdrant
+ * Valid classification tags for document content
+ * PRD #375: Unified Knowledge Base
  */
-const KNOWLEDGE_COLLECTION = 'knowledge-base';
+const VALID_CLASSIFICATION_TAGS = ['policy', 'pattern'];
+/**
+ * Classify a document using AI to determine its content type.
+ * Returns a list of applicable tags (["policy"], ["pattern"], ["policy","pattern"], or []).
+ *
+ * Classification is done on the full document before chunking for better context.
+ * The same tags are applied to all chunks from the same document.
+ *
+ * Fails gracefully: if AI is unavailable or returns unexpected format, returns [].
+ *
+ * PRD #375: Milestone 2 - AI Classification During Ingestion
+ */
+async function classifyDocument(content) {
+    // Skip classification for empty content
+    if (!content || content.trim().length === 0) {
+        return [];
+    }
+    try {
+        const aiProvider = (0, ai_provider_factory_1.createAIProvider)();
+        if (!aiProvider.isInitialized()) {
+            // AI not configured - gracefully skip classification
+            return [];
+        }
+        const prompt = (0, shared_prompt_loader_1.loadPrompt)('knowledge-classification', {
+            documentContent: content,
+        });
+        const response = await aiProvider.sendMessage(prompt, 'knowledge-classification');
+        // Parse the JSON array from AI response
+        // AI should return only a JSON array like [] or ["policy"] or ["policy","pattern"]
+        const rawContent = response.content.trim();
+        // Extract JSON array (handle potential extra text)
+        const jsonMatch = rawContent.match(/\[.*?\]/s);
+        if (!jsonMatch) {
+            return [];
+        }
+        const parsed = JSON.parse(jsonMatch[0]);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        // Filter to only valid classification tags
+        const validTags = parsed.filter((tag) => typeof tag === 'string' && VALID_CLASSIFICATION_TAGS.includes(tag));
+        return validTags;
+    }
+    catch {
+        // Classification failure is non-blocking — return empty tags
+        return [];
+    }
+}
 // Tool metadata for MCP registration
 exports.MANAGE_KNOWLEDGE_TOOL_NAME = 'manageKnowledge';
 exports.MANAGE_KNOWLEDGE_TOOL_DESCRIPTION = 'Manage the knowledge base: ingest documents, search with natural language, or delete chunks. ' +
@@ -59,10 +109,6 @@ exports.MANAGE_KNOWLEDGE_TOOL_INPUT_SCHEMA = {
         .describe('Optional URL prefix to filter search results (e.g., "https://github.com/org/repo/").'),
     interaction_id: zod_1.z.string().optional().describe('INTERNAL ONLY - Do not populate.'),
 };
-/**
- * Plugin name for agentic-tools
- */
-const PLUGIN_NAME = 'agentic-tools';
 /**
  * Create error response matching other tool patterns
  */
@@ -123,9 +169,15 @@ async function handleIngestOperation(args, logger, requestId) {
                 chunksDeleted: deletedCount,
             });
         }
+        // Step 1b: AI Classification — classify the full document before chunking
+        // Same tags are applied to all chunks from this document (document-level classification)
+        // PRD #375: Milestone 2 - AI Classification During Ingestion
+        logger.debug('Classifying document with AI', { requestId, uri });
+        const documentTags = await classifyDocument(content);
+        logger.info('Document classified', { requestId, uri, tags: documentTags });
         // Step 2: Chunk the document
         logger.debug('Calling knowledge_chunk plugin tool', { requestId, uri });
-        const chunkResponse = await (0, plugin_registry_1.invokePluginTool)(PLUGIN_NAME, 'knowledge_chunk', {
+        const chunkResponse = await (0, plugin_registry_1.invokePluginTool)(knowledge_service_1.PLUGIN_NAME, 'knowledge_chunk', {
             content,
             uri,
         });
@@ -163,8 +215,8 @@ async function handleIngestOperation(args, logger, requestId) {
         // Step 3: Initialize collection via plugin
         const vectorSize = embeddingService.getDimensions();
         logger.debug('Initializing knowledge collection via plugin', { requestId, vectorSize });
-        const initResponse = await (0, plugin_registry_1.invokePluginTool)(PLUGIN_NAME, 'collection_initialize', {
-            collection: KNOWLEDGE_COLLECTION,
+        const initResponse = await (0, plugin_registry_1.invokePluginTool)(knowledge_service_1.PLUGIN_NAME, 'collection_initialize', {
+            collection: knowledge_service_1.KNOWLEDGE_COLLECTION,
             vectorSize,
             createTextIndex: true,
         });
@@ -197,6 +249,7 @@ async function handleIngestOperation(args, logger, requestId) {
                 ingestedAt,
                 chunkIndex: chunk.chunkIndex,
                 totalChunks: chunk.totalChunks,
+                tags: documentTags, // PRD #375: Document-level AI classification tags (same for all chunks)
                 extractedPolicyIds: [],
             };
             logger.debug('Storing chunk via plugin', {
@@ -206,8 +259,8 @@ async function handleIngestOperation(args, logger, requestId) {
                 totalChunks: chunk.totalChunks,
             });
             // Store via plugin
-            const storeResponse = await (0, plugin_registry_1.invokePluginTool)(PLUGIN_NAME, 'vector_store', {
-                collection: KNOWLEDGE_COLLECTION,
+            const storeResponse = await (0, plugin_registry_1.invokePluginTool)(knowledge_service_1.PLUGIN_NAME, 'vector_store', {
+                collection: knowledge_service_1.KNOWLEDGE_COLLECTION,
                 id: chunk.id,
                 embedding,
                 payload,
@@ -251,124 +304,11 @@ async function handleIngestOperation(args, logger, requestId) {
         });
     }
 }
-/**
- * Default limit for search results
- */
-const DEFAULT_SEARCH_LIMIT = 20;
-/**
- * Reusable knowledge base search function.
- * Can be called from MCP tool handler or HTTP endpoints.
- *
- * @param params Search parameters
- * @returns Search results with chunks or error
- */
-async function searchKnowledgeBase(params) {
-    const { query, limit = DEFAULT_SEARCH_LIMIT, uriFilter } = params;
-    // Check plugin availability
-    if (!(0, plugin_registry_1.isPluginInitialized)()) {
-        return {
-            success: false,
-            chunks: [],
-            totalMatches: 0,
-            error: 'Plugin system not available',
-        };
-    }
-    // Check embedding service availability
-    const embeddingService = new embedding_service_1.EmbeddingService();
-    if (!embeddingService.isAvailable()) {
-        const status = embeddingService.getStatus();
-        return {
-            success: false,
-            chunks: [],
-            totalMatches: 0,
-            error: `Embedding service not available: ${status.reason}`,
-        };
-    }
-    // Generate embedding for the search query
-    const queryEmbedding = await embeddingService.generateEmbedding(query);
-    // Build filter if uriFilter is provided
-    let filter;
-    if (uriFilter) {
-        filter = {
-            must: [
-                {
-                    key: 'uri',
-                    match: {
-                        value: uriFilter,
-                    },
-                },
-            ],
-        };
-    }
-    // Call vector_search plugin tool
-    const searchResponse = await (0, plugin_registry_1.invokePluginTool)(PLUGIN_NAME, 'vector_search', {
-        collection: KNOWLEDGE_COLLECTION,
-        embedding: queryEmbedding,
-        limit,
-        filter,
-        scoreThreshold: 0, // Return all results up to limit, let consumer filter by score
-    });
-    if (!searchResponse.success) {
-        const error = searchResponse.error;
-        const errorMessage = error?.message || error?.error || 'Search failed';
-        // If collection doesn't exist (Not Found), return empty result (not error)
-        if (errorMessage.includes('Not Found') || errorMessage.includes('not found')) {
-            return {
-                success: true,
-                chunks: [],
-                totalMatches: 0,
-            };
-        }
-        return {
-            success: false,
-            chunks: [],
-            totalMatches: 0,
-            error: errorMessage,
-        };
-    }
-    // Extract results from plugin response
-    const searchResult = searchResponse.result;
-    if (!searchResult.success) {
-        const errorMessage = searchResult.error || searchResult.message;
-        // If collection doesn't exist, return empty result (not error)
-        if (errorMessage.includes('Not Found') || errorMessage.includes('not found')) {
-            return {
-                success: true,
-                chunks: [],
-                totalMatches: 0,
-            };
-        }
-        return {
-            success: false,
-            chunks: [],
-            totalMatches: 0,
-            error: errorMessage,
-        };
-    }
-    // Transform results to KnowledgeSearchResultItem format
-    const results = searchResult.data || [];
-    const chunks = results.map((result) => ({
-        id: result.id,
-        content: result.payload.content,
-        score: result.score,
-        matchType: 'semantic', // Dense vector search only (BM25 deferred)
-        uri: result.payload.uri,
-        metadata: result.payload.metadata || {},
-        chunkIndex: result.payload.chunkIndex,
-        totalChunks: result.payload.totalChunks,
-        extractedPolicies: undefined, // Populated by PRD #357
-    }));
-    return {
-        success: true,
-        chunks,
-        totalMatches: chunks.length,
-    };
-}
 /**
  * Handle the search operation (MCP tool handler)
  */
 async function handleSearchOperation(args, logger, requestId) {
-    const { query, limit = DEFAULT_SEARCH_LIMIT, uriFilter } = args;
+    const { query, limit = knowledge_service_1.DEFAULT_SEARCH_LIMIT, uriFilter } = args;
     // Validate required parameters
     if (!query) {
         return createErrorResponse('Missing required parameter: query', {
@@ -384,7 +324,7 @@ async function handleSearchOperation(args, logger, requestId) {
     });
     try {
         // Use the reusable search function
-        const searchResult = await searchKnowledgeBase({ query, limit, uriFilter });
+        const searchResult = await (0, knowledge_service_1.searchKnowledgeBase)({ query, limit, uriFilter });
         if (!searchResult.success) {
             logger.error('Knowledge base search failed', new Error(searchResult.error), { requestId });
             return createErrorResponse('Search failed', {
@@ -433,8 +373,8 @@ async function handleSearchOperation(args, logger, requestId) {
  */
 async function deleteChunksByUri(uri, logger, requestId) {
     // Query all chunks matching the URI
-    const queryResponse = await (0, plugin_registry_1.invokePluginTool)(PLUGIN_NAME, 'vector_query', {
-        collection: KNOWLEDGE_COLLECTION,
+    const queryResponse = await (0, plugin_registry_1.invokePluginTool)(knowledge_service_1.PLUGIN_NAME, 'vector_query', {
+        collection: knowledge_service_1.KNOWLEDGE_COLLECTION,
         filter: {
             must: [{ key: 'uri', match: { value: uri } }],
         },
@@ -471,8 +411,8 @@ async function deleteChunksByUri(uri, logger, requestId) {
     let deletedCount = 0;
     for (const chunk of chunksToDelete) {
         logger.debug('Deleting chunk', { requestId, chunkId: chunk.id });
-        const deleteResponse = await (0, plugin_registry_1.invokePluginTool)(PLUGIN_NAME, 'vector_delete', {
-            collection: KNOWLEDGE_COLLECTION,
+        const deleteResponse = await (0, plugin_registry_1.invokePluginTool)(knowledge_service_1.PLUGIN_NAME, 'vector_delete', {
+            collection: knowledge_service_1.KNOWLEDGE_COLLECTION,
             id: chunk.id,
         });
         if (!deleteResponse.success) {

package/dist/tools/operate-analysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operate-analysis.d.ts","sourceRoot":"","sources":["../../src/tools/operate-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIhD,OAAO,EAEL,kBAAkB,EAElB,eAAe,EAKhB,MAAM,WAAW,CAAC;AAwBnB;;GAEG;AACH,UAAU,qBAAqB;IAC7B,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,gBAAgB,EAAE;YAChB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;YAC7B,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,EAAE;YACL,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;YACjC,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,EACzD,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA2DhC"}
+{"version":3,"file":"operate-analysis.d.ts","sourceRoot":"","sources":["../../src/tools/operate-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIhD,OAAO,EAEL,kBAAkB,EAElB,eAAe,EAIhB,MAAM,WAAW,CAAC;AAwBnB;;GAEG;AACH,UAAU,qBAAqB;IAC7B,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,gBAAgB,EAAE;YAChB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;YAC7B,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,EAAE;YACL,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;YACjC,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,EACzD,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA2DhC"}

package/dist/tools/operate-analysis.js

@@ -65,19 +65,20 @@ function loadSystemPrompt() {
     return (0, shared_prompt_loader_1.loadPrompt)('operate-system');
 }
 /**
- * Builds dynamic user message with intent and embedded context
- * Uses template from prompts/operate-user.md and formatting functions from operate.ts
+ * Builds dynamic user message with intent and embedded context.
+ * Uses template from prompts/operate-user.md and formatting functions from operate.ts.
+ *
+ * PRD #375: Unified Knowledge Base — uses single knowledgeContext instead of
+ * separate patterns/policies sections.
  */
 function buildUserMessage(intent, context) {
     // Format context sections using shared formatting functions
-    const patternsText = (0, operate_1.formatPatterns)(context.patterns);
-    const policiesText = (0, operate_1.formatPolicies)(context.policies);
+    const knowledgeContextText = (0, operate_1.formatKnowledgeContext)(context.knowledgeChunks);
     const capabilitiesText = (0, operate_1.formatCapabilities)(context.capabilities);
     // Use loadPrompt with Handlebars template variables
     return (0, shared_prompt_loader_1.loadPrompt)('operate-user', {
         intent,
-        patterns: patternsText,
-        policies: policiesText,
+        knowledgeContext: knowledgeContextText,
         capabilities: capabilitiesText,
     });
 }

package/dist/tools/operate.d.ts

@@ -4,7 +4,7 @@
 import { z } from 'zod';
 import { Logger } from '../core/error-handling';
 import { PluginManager } from '../core/plugin-manager';
-import { OrganizationalPattern, PolicyIntent } from '../core/organizational-types';
+import { KnowledgeSearchResultItem } from '../core/knowledge-types';
 import { ResourceCapability } from '../core/capabilities';
 import { BaseVisualizationData } from '../core/visualization';
 export declare const OPERATE_TOOL_NAME = "operate";
@@ -51,9 +51,15 @@ export type OperateSession = {
     updatedAt: string;
     data: OperateSessionData;
 };
+/**
+ * Embedded context for operate analysis.
+ * PRD #375: Unified Knowledge Base — patterns and policies are now unified
+ * in the knowledge-base collection. knowledgeChunks replaces separate
+ * patterns[] and policies[] fields. Chunks include tags for type identification.
+ */
 export interface EmbeddedContext {
-    patterns: OrganizationalPattern[];
-    policies: PolicyIntent[];
+    /** Knowledge chunks from unified knowledge base (includes policy, pattern, and general content) */
+    knowledgeChunks: KnowledgeSearchResultItem[];
     capabilities: ResourceCapability[];
 }
 export interface ProposedChanges {
@@ -106,20 +112,26 @@ export interface OperateOutput {
     agentInstructions?: string;
 }
 /**
- * Embed context (patterns, policies, capabilities) for AI analysis
+ * Embed context (knowledge, capabilities) for AI analysis.
+ *
+ * PRD #375: Unified Knowledge Base — searches single knowledge-base collection
+ * instead of separate pattern/policy collections. Results include tags so the
+ * AI can distinguish policy, pattern, and general knowledge content.
+ *
  * @param intent User's operational intent
- * @returns Embedded context with patterns, policies, and capabilities
+ * @param logger Logger instance
+ * @returns Embedded context with knowledge chunks and capabilities
  * @throws Error if capabilities are not available (mandatory)
  */
 export declare function embedContext(intent: string, logger: Logger): Promise<EmbeddedContext>;
 /**
- * Format patterns for template placeholder
- */
-export declare function formatPatterns(patterns: OrganizationalPattern[]): string;
-/**
- * Format policies for template placeholder
+ * Format knowledge chunks for template placeholder.
+ *
+ * PRD #375: Unified Knowledge Base — replaces separate formatPatterns/formatPolicies.
+ * Chunks include tags so the AI can interpret what type each result represents.
+ * Tags: "policy" = enforcement rule, "pattern" = reusable architecture, [] = general content.
  */
-export declare function formatPolicies(policies: PolicyIntent[]): string;
+export declare function formatKnowledgeContext(chunks: KnowledgeSearchResultItem[]): string;
 /**
  * Format capabilities for template placeholder
  * Capabilities are already ordered by relevance from vector search

package/dist/tools/operate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operate.d.ts","sourceRoot":"","sources":["../../src/tools/operate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operate.d.ts","sourceRoot":"","sources":["../../src/tools/operate.ts"],"names":[],"mappings":"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"}

package/dist/tools/operate.js

@@ -38,8 +38,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OPERATE_TOOL_INPUT_SCHEMA = exports.OPERATE_TOOL_DESCRIPTION = exports.OPERATE_TOOL_NAME = void 0;
 exports.embedContext = embedContext;
-exports.formatPatterns = formatPatterns;
-exports.formatPolicies = formatPolicies;
+exports.formatKnowledgeContext = formatKnowledgeContext;
 exports.formatCapabilities = formatCapabilities;
 exports.operate = operate;
 exports.handleOperateTool = handleOperateTool;
@@ -48,9 +47,8 @@ const error_handling_1 = require("../core/error-handling");
 const generic_session_manager_1 = require("../core/generic-session-manager");
 const request_context_1 = require("../interfaces/request-context");
 const rbac_1 = require("../core/rbac");
-const pattern_vector_service_1 = require("../core/pattern-vector-service");
-const policy_vector_service_1 = require("../core/policy-vector-service");
 const capability_vector_service_1 = require("../core/capability-vector-service");
+const knowledge_service_1 = require("../core/knowledge-service");
 const index_1 = require("../core/index");
 // Tool metadata for direct MCP registration
 exports.OPERATE_TOOL_NAME = 'operate';
@@ -89,43 +87,41 @@ const sessionManager = new generic_session_manager_1.GenericSessionManager('opr'
 // Initialize logger
 const logger = new error_handling_1.ConsoleLogger('OperateTool');
 /**
- * Embed context (patterns, policies, capabilities) for AI analysis
+ * Embed context (knowledge, capabilities) for AI analysis.
+ *
+ * PRD #375: Unified Knowledge Base — searches single knowledge-base collection
+ * instead of separate pattern/policy collections. Results include tags so the
+ * AI can distinguish policy, pattern, and general knowledge content.
+ *
  * @param intent User's operational intent
- * @returns Embedded context with patterns, policies, and capabilities
+ * @param logger Logger instance
+ * @returns Embedded context with knowledge chunks and capabilities
  * @throws Error if capabilities are not available (mandatory)
  */
 async function embedContext(intent, logger) {
     const context = {
-        patterns: [],
-        policies: [],
+        knowledgeChunks: [],
         capabilities: [],
     };
-    // Search for relevant patterns (optional - non-blocking)
+    // Search unified knowledge base (optional - non-blocking)
+    // Results include tags so AI can see which are policies, patterns, or general content
     try {
-        const patternService = new pattern_vector_service_1.PatternVectorService();
-        const patternResults = await patternService.searchPatterns(intent, {
-            limit: 5,
-        });
-        context.patterns = patternResults.map(result => result.data);
-        logger.info(`Found ${context.patterns.length} relevant organizational patterns`);
+        const knowledgeResult = await (0, knowledge_service_1.searchKnowledgeBase)({ query: intent, limit: 20 });
+        if (knowledgeResult.success) {
+            context.knowledgeChunks = knowledgeResult.chunks;
+            logger.info(`Found ${context.knowledgeChunks.length} relevant knowledge chunks (unified knowledge base)`);
+        }
+        else {
+            logger.warn('Knowledge base search failed, continuing without organizational context', {
+                error: knowledgeResult.error,
+            });
+        }
     }
     catch (error) {
-        logger.warn('Pattern search failed, continuing without patterns', {
+        logger.warn('Knowledge base search failed, continuing without organizational context', {
             error,
         });
     }
-    // Search for relevant policies (optional - non-blocking)
-    try {
-        const policyService = new policy_vector_service_1.PolicyVectorService();
-        const policyResults = await policyService.searchPolicyIntents(intent, {
-            limit: 5,
-        });
-        context.policies = policyResults.map(result => result.data);
-        logger.info(`Found ${context.policies.length} relevant organizational policies`);
-    }
-    catch (error) {
-        logger.warn('Policy search failed, continuing without policies', { error });
-    }
     // Search for relevant cluster capabilities (MANDATORY)
     try {
         // Use QDRANT_CAPABILITIES_COLLECTION env var for collection name
@@ -157,39 +153,25 @@ async function embedContext(intent, logger) {
     return context;
 }
 /**
- * Format patterns for template placeholder
- */
-function formatPatterns(patterns) {
-    if (patterns.length === 0) {
-        return 'No organizational patterns found matching this intent.';
-    }
-    let formatted = '';
-    patterns.forEach((pattern, index) => {
-        formatted += `### Pattern ${index + 1}: ${pattern.description}\n\n`;
-        formatted += `**Triggers:** ${pattern.triggers.join(', ')}\n\n`;
-        formatted += `**Suggested Resources:** ${pattern.suggestedResources.join(', ')}\n\n`;
-        formatted += `**Rationale:** ${pattern.rationale}\n\n`;
-        if (index < patterns.length - 1) {
-            formatted += '---\n\n';
-        }
-    });
-    return formatted;
-}
-/**
- * Format policies for template placeholder
+ * Format knowledge chunks for template placeholder.
+ *
+ * PRD #375: Unified Knowledge Base — replaces separate formatPatterns/formatPolicies.
+ * Chunks include tags so the AI can interpret what type each result represents.
+ * Tags: "policy" = enforcement rule, "pattern" = reusable architecture, [] = general content.
  */
-function formatPolicies(policies) {
-    if (policies.length === 0) {
-        return 'No organizational policies found matching this intent.';
+function formatKnowledgeContext(chunks) {
+    if (chunks.length === 0) {
+        return 'No relevant organizational knowledge found matching this intent.';
     }
     let formatted = '';
-    policies.forEach((policy, index) => {
-        formatted += `### Policy ${index + 1}: ${policy.description}\n\n`;
-        if (policy.triggers && policy.triggers.length > 0) {
-            formatted += `**Applies to:** ${policy.triggers.join(', ')}\n\n`;
-        }
-        formatted += `**Rationale:** ${policy.rationale}\n\n`;
-        if (index < policies.length - 1) {
+    chunks.forEach((chunk, index) => {
+        const typeLabel = chunk.tags.length > 0
+            ? chunk.tags.map(t => t.charAt(0).toUpperCase() + t.slice(1)).join(' + ')
+            : 'General';
+        formatted += `### Knowledge ${index + 1} [${typeLabel}]\n\n`;
+        formatted += `**Source:** ${chunk.uri}\n\n`;
+        formatted += (chunk.content.length > 300 ? chunk.content.substring(0, 300) + '...' : chunk.content) + '\n\n';
+        if (index < chunks.length - 1) {
             formatted += '---\n\n';
         }
     });