@vfarcic/dot-ai 1.23.1 → 1.24.0

package/dist/tools/organizational-data.d.ts

@@ -11,23 +11,19 @@ import { z } from 'zod';
 import { DotAI } from '../core/index';
 import { Logger } from '../core/error-handling';
 export declare const ORGANIZATIONAL_DATA_TOOL_NAME = "manageOrgData";
-export declare const ORGANIZATIONAL_DATA_TOOL_DESCRIPTION = "Unified tool for managing cluster data: organizational patterns, policy intents, and resource capabilities. For patterns and policies: supports create, list, get, delete, deleteAll, and search operations (patterns also support step-by-step creation workflow). For capabilities: supports scan, list, get, delete, deleteAll, and progress operations for cluster resource capability discovery and management. Use dataType parameter to specify what to manage: \"pattern\" for organizational patterns, \"policy\" for policy intents, \"capabilities\" for resource capabilities.";
+export declare const ORGANIZATIONAL_DATA_TOOL_DESCRIPTION = "Tool for managing cluster resource capabilities. Supports scan, list, get, search, delete, deleteAll, and progress operations for cluster resource capability discovery and management. Use dataType=\"capabilities\" to manage cluster capabilities. NOTE: Organizational patterns and policies are now managed via manageKnowledge tool (ingest documents, search, deleteByUri) with automatic AI classification.";
 export declare const ORGANIZATIONAL_DATA_TOOL_INPUT_SCHEMA: {
     dataType: z.ZodEnum<{
         capabilities: "capabilities";
-        pattern: "pattern";
-        policy: "policy";
     }>;
     operation: z.ZodEnum<{
         search: "search";
         get: "get";
         progress: "progress";
         list: "list";
-        create: "create";
         delete: "delete";
         deleteAll: "deleteAll";
         scan: "scan";
-        analyze: "analyze";
     }>;
     sessionId: z.ZodOptional<z.ZodString>;
     step: z.ZodOptional<z.ZodString>;
@@ -47,11 +43,12 @@ export declare const ORGANIZATIONAL_DATA_TOOL_INPUT_SCHEMA: {
     interaction_id: z.ZodOptional<z.ZodString>;
 };
 /**
- * Input type for organizational data tool
+ * Input type for organizational data tool.
+ * PRD #375: dataType is now capabilities-only (pattern/policy moved to manageKnowledge).
  */
 export interface OrganizationalDataInput {
-    dataType: 'pattern' | 'policy' | 'capabilities';
-    operation: 'create' | 'list' | 'get' | 'delete' | 'deleteAll' | 'scan' | 'analyze' | 'progress' | 'search';
+    dataType: 'capabilities';
+    operation: 'list' | 'get' | 'delete' | 'deleteAll' | 'scan' | 'progress' | 'search';
     sessionId?: string;
     step?: string;
     response?: string;

package/dist/tools/organizational-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"organizational-data.d.ts","sourceRoot":"","sources":["../../src/tools/organizational-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAiBhD,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAC7D,eAAO,MAAM,oCAAoC,+jBAAyjB,CAAC;AAG3mB,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;IAChD,SAAS,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAstBD;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,uBAAuB,EAC7B,MAAM,EAAE,KAAK,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAsJ7D"}
+{"version":3,"file":"organizational-data.d.ts","sourceRoot":"","sources":["../../src/tools/organizational-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAehD,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAC7D,eAAO,MAAM,oCAAoC,wZAAsZ,CAAC;AAGxc,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAgqBD;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,uBAAuB,EAC7B,MAAM,EAAE,KAAK,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA6I7D"}

package/dist/tools/organizational-data.js

@@ -46,13 +46,8 @@ exports.ORGANIZATIONAL_DATA_TOOL_INPUT_SCHEMA = exports.ORGANIZATIONAL_DATA_TOOL
 exports.handleOrganizationalDataTool = handleOrganizationalDataTool;
 const zod_1 = require("zod");
 const error_handling_1 = require("../core/error-handling");
-const constants_1 = require("../core/constants");
-// Import only what we need - other imports removed as they're no longer used with Vector DB
 const index_1 = require("../core/index");
 const session_utils_1 = require("../core/session-utils");
-const embedding_service_1 = require("../core/embedding-service");
-const policy_operations_1 = require("../core/policy-operations");
-const pattern_operations_1 = require("../core/pattern-operations");
 const capability_operations_1 = require("../core/capability-operations");
 const capability_scan_workflow_1 = require("../core/capability-scan-workflow");
 const crypto_1 = require("crypto");
@@ -61,18 +56,21 @@ const path = __importStar(require("path"));
 const request_context_1 = require("../interfaces/request-context");
 const rbac_1 = require("../core/rbac");
 // Tool metadata for MCP registration
+// PRD #375: Unified Knowledge Base — pattern and policy operations removed.
+// Organizational knowledge is now managed via manageKnowledge (ingest/search/deleteByUri).
+// This tool is now capabilities-only.
 exports.ORGANIZATIONAL_DATA_TOOL_NAME = 'manageOrgData';
-exports.ORGANIZATIONAL_DATA_TOOL_DESCRIPTION = 'Unified tool for managing cluster data: organizational patterns, policy intents, and resource capabilities. For patterns and policies: supports create, list, get, delete, deleteAll, and search operations (patterns also support step-by-step creation workflow). For capabilities: supports scan, list, get, delete, deleteAll, and progress operations for cluster resource capability discovery and management. Use dataType parameter to specify what to manage: "pattern" for organizational patterns, "policy" for policy intents, "capabilities" for resource capabilities.';
-// Extensible schema - supports patterns, policies, and capabilities
+exports.ORGANIZATIONAL_DATA_TOOL_DESCRIPTION = 'Tool for managing cluster resource capabilities. Supports scan, list, get, search, delete, deleteAll, and progress operations for cluster resource capability discovery and management. Use dataType="capabilities" to manage cluster capabilities. NOTE: Organizational patterns and policies are now managed via manageKnowledge tool (ingest documents, search, deleteByUri) with automatic AI classification.';
+// Schema - capabilities only (PRD #375: pattern/policy removed from this tool)
 exports.ORGANIZATIONAL_DATA_TOOL_INPUT_SCHEMA = {
-    dataType: zod_1.z.enum(['pattern', 'policy', 'capabilities']).describe('Type of cluster data to manage: "pattern" for organizational patterns, "policy" for policy intents, "capabilities" for resource capabilities'),
-    operation: zod_1.z.enum(['create', 'list', 'get', 'delete', 'deleteAll', 'scan', 'analyze', 'progress', 'search']).describe('Operation to perform on the cluster data'),
-    // Workflow fields for step-by-step pattern creation
+    dataType: zod_1.z.enum(['capabilities']).describe('Type of cluster data to manage: "capabilities" for resource capabilities. (Note: organizational knowledge/patterns/policies are managed via manageKnowledge tool)'),
+    operation: zod_1.z.enum(['list', 'get', 'delete', 'deleteAll', 'scan', 'progress', 'search']).describe('Operation to perform on the cluster data'),
+    // Workflow fields for step-by-step capability scanning
     sessionId: zod_1.z.string().optional().describe('Session ID (required for continuing workflow steps, optional for progress - uses latest session if omitted)'),
     step: zod_1.z.string().optional().describe('Current workflow step (required when sessionId is provided)'),
     response: zod_1.z.string().optional().describe('User response to previous workflow step question'),
     // Generic fields for get/delete/search operations
-    id: zod_1.z.string().optional().describe('Data item ID (required for get/delete operations) or search query (required for search operations)'),
+    id: zod_1.z.string().optional().describe('Capability ID (required for get/delete operations) or search query (required for search operations)'),
     // Generic fields for list operations
     limit: zod_1.z.number().optional().describe('Maximum number of items to return (default: 10)'),
     // Resource-specific fields (for capabilities operations)
@@ -89,46 +87,15 @@ exports.ORGANIZATIONAL_DATA_TOOL_INPUT_SCHEMA = {
     collection: zod_1.z.string().optional().describe('Collection name for capabilities operations (default: "capabilities", use "capabilities-policies" for pre-populated test data)'),
     interaction_id: zod_1.z.string().optional().describe('INTERNAL ONLY - Do not populate. Used for evaluation dataset generation.')
 };
-/**
- * Validate Vector DB connection and return helpful error if unavailable
- */
-async function validateVectorDBConnection(vectorService, logger, requestId) {
-    const isHealthy = await vectorService.healthCheck();
-    if (!isHealthy) {
-        logger.warn('Vector DB connection not available', { requestId });
-        return {
-            success: false,
-            error: {
-                message: 'Vector DB connection required for pattern management',
-                details: 'Pattern management requires a Qdrant Vector Database connection to store and search organizational patterns.',
-                setup: {
-                    selfHosted: {
-                        docker: 'docker run -d -p 6333:6333 --name qdrant qdrant/qdrant',
-                        environment: 'export QDRANT_URL=http://localhost:6333'
-                    },
-                    saas: {
-                        signup: 'Sign up at https://cloud.qdrant.io',
-                        environment: [
-                            'export QDRANT_URL=https://your-cluster.aws.cloud.qdrant.io:6333',
-                            'export QDRANT_API_KEY=your-api-key-from-dashboard'
-                        ]
-                    },
-                    docs: 'See documentation for detailed setup instructions'
-                },
-                currentConfig: {
-                    QDRANT_URL: process.env.QDRANT_URL || 'not set (defaults to http://localhost:6333)',
-                    QDRANT_API_KEY: process.env.QDRANT_API_KEY ? 'set' : 'not set (optional)'
-                }
-            }
-        };
-    }
-    return { success: true };
-}
+// PRD #375: validateVectorDBConnection and pattern/policy operations removed.
+// Pattern/policy operations moved to manageKnowledge tool.
+// Capabilities operations still use validateEmbeddingService below.
 /**
  * Validate embedding service configuration and fail if unavailable
  */
 async function validateEmbeddingService(logger, requestId) {
-    const embeddingService = new embedding_service_1.EmbeddingService();
+    const { EmbeddingService } = await Promise.resolve().then(() => __importStar(require('../core/index')));
+    const embeddingService = new EmbeddingService();
     const status = embeddingService.getStatus();
     if (!status.available) {
         logger.warn('Embedding service required but not available', {
@@ -138,31 +105,16 @@ async function validateEmbeddingService(logger, requestId) {
         return {
             success: false,
             error: {
-                message: constants_1.AI_SERVICE_ERROR_TEMPLATES.OPENAI_KEY_REQUIRED('pattern management'),
-                details: 'Pattern management requires OpenAI embeddings for semantic search and storage. The system cannot proceed without proper configuration.',
+                message: 'OpenAI API required for capability management',
+                details: 'Capability scanning requires OpenAI embeddings for semantic search and storage.',
                 reason: status.reason,
-                setup: {
-                    required: 'export OPENAI_API_KEY=your-openai-api-key',
-                    optional: [
-                        'export OPENAI_MODEL=text-embedding-3-small (default)',
-                        'export OPENAI_DIMENSIONS=1536 (default)'
-                    ],
-                    docs: 'Get API key from https://platform.openai.com/api-keys'
-                },
                 currentConfig: {
                     OPENAI_API_KEY: process.env.OPENAI_API_KEY ? 'set' : 'not set',
                     QDRANT_URL: process.env.QDRANT_URL || 'http://localhost:6333',
-                    status: constants_1.AI_SERVICE_ERROR_TEMPLATES.EMBEDDING_SERVICE_UNAVAILABLE
                 }
             }
         };
     }
-    logger.info('Embedding service available', {
-        requestId,
-        provider: status.provider,
-        model: status.model,
-        dimensions: status.dimensions
-    });
     return { success: true };
 }
 /**
@@ -696,25 +648,18 @@ async function handleOrganizationalDataTool(args, _dotAI, logger, requestId) {
             }
         }
         // Route to appropriate handler based on data type
+        // PRD #375: capabilities only — pattern/policy moved to manageKnowledge
         let result;
         switch (args.dataType) {
-            case 'pattern':
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Args and validation function type compatibility between modules
-                result = await (0, pattern_operations_1.handlePatternOperation)(args.operation, args, logger, requestId, validateVectorDBConnection, validateEmbeddingService);
-                break;
-            case 'policy':
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Args and validation function type compatibility between modules
-                result = await (0, policy_operations_1.handlePolicyOperation)(args.operation, args, logger, requestId, validateVectorDBConnection, validateEmbeddingService);
-                break;
             case 'capabilities':
                 result = await handleCapabilitiesOperation(args.operation, args, logger, requestId);
                 break;
             default:
-                throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.HIGH, `Unsupported data type: ${args.dataType}. Currently supported: pattern, policy, capabilities`, {
+                throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.HIGH, `Unsupported data type: ${args.dataType}. Supported: capabilities. NOTE: Organizational knowledge (patterns, policies) is managed via manageKnowledge tool.`, {
                     operation: 'data_type_validation',
                     component: 'OrganizationalDataTool',
                     requestId,
-                    input: { dataType: args.dataType, supportedTypes: ['pattern', 'policy', 'capabilities'] }
+                    input: { dataType: args.dataType, supportedTypes: ['capabilities'] }
                 });
         }
         logger.info('Organizational-data tool request completed successfully', {

package/dist/tools/query.d.ts

@@ -7,6 +7,8 @@
  * PRD #291: Cluster Query Tool - Natural Language Cluster Intelligence
  */
 import { z } from 'zod';
+import { Logger } from '../core/error-handling';
+import type { AgenticResult } from '../core/ai-provider.interface';
 import { PluginManager } from '../core/plugin-manager';
 import { CachedVisualization } from '../core/visualization';
 export declare const QUERY_TOOL_NAME = "query";
@@ -59,6 +61,21 @@ interface QueryToolArgs {
     intent?: string;
     interaction_id?: string;
 }
+/**
+ * Bounded retry for the read-only query tool loop. A non-success status is a
+ * transient, retryable AI failure (the caller flags it isRetryable), so re-run
+ * the loop up to `maxAttempts` times — with a short backoff to avoid re-hammering
+ * the provider on rate-limit/overload — before surfacing the final result.
+ *
+ * Exported for unit testing. `backoffMs` is injectable so tests run without real
+ * delays; production uses exponential backoff with jitter, capped at 2s.
+ */
+export declare function runQueryLoopWithRetry(run: () => Promise<AgenticResult>, options: {
+    maxAttempts: number;
+    logger: Logger;
+    requestId: string;
+    backoffMs?: (attempt: number) => number;
+}): Promise<AgenticResult>;
 export declare function handleQueryTool(args: QueryToolArgs, pluginManager?: PluginManager): Promise<QueryOutput | {
     content: Array<{
         type: string;

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

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAIL,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,sBAAsB,iWAAuV,CAAC;AAG3X,eAAO,MAAM,uBAAuB;;;CAGnC,CAAC;AAGF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IAEH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAGD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAgED;;;;;GAKG;AACH,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,EACnB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,WAAW,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAkO3E"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA6D,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAE3G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAIL,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAK/B,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,sBAAsB,iWAAuV,CAAC;AAG3X,eAAO,MAAM,uBAAuB;;;CAGnC,CAAC;AAGF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IAEH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAGD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAgED;;;;;GAKG;AACH,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,EACjC,OAAO,EAAE;IACP,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACzC,GACA,OAAO,CAAC,aAAa,CAAC,CAsBxB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,EACnB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,WAAW,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA6O3E"}

package/dist/tools/query.js

@@ -9,6 +9,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QUERY_TOOL_INPUT_SCHEMA = exports.QUERY_TOOL_DESCRIPTION = exports.QUERY_TOOL_NAME = void 0;
+exports.runQueryLoopWithRetry = runQueryLoopWithRetry;
 exports.handleQueryTool = handleQueryTool;
 const zod_1 = require("zod");
 const error_handling_1 = require("../core/error-handling");
@@ -82,6 +83,30 @@ function parseSummary(aiResponse) {
         return aiResponse.trim() || 'No summary provided';
     }
 }
+/**
+ * Bounded retry for the read-only query tool loop. A non-success status is a
+ * transient, retryable AI failure (the caller flags it isRetryable), so re-run
+ * the loop up to `maxAttempts` times — with a short backoff to avoid re-hammering
+ * the provider on rate-limit/overload — before surfacing the final result.
+ *
+ * Exported for unit testing. `backoffMs` is injectable so tests run without real
+ * delays; production uses exponential backoff with jitter, capped at 2s.
+ */
+async function runQueryLoopWithRetry(run, options) {
+    const { maxAttempts, logger, requestId, backoffMs } = options;
+    const delayFor = backoffMs
+        ?? ((attempt) => Math.min(2000, 250 * 2 ** (attempt - 1)) + Math.floor(Math.random() * 250));
+    let result = await run();
+    for (let attempt = 1; attempt < maxAttempts && result.status && result.status !== 'success'; attempt++) {
+        const delay = delayFor(attempt);
+        logger.warn(`Query tool loop returned status '${result.status}' — retrying in ${delay}ms (attempt ${attempt + 1}/${maxAttempts})`, { requestId, finalMessage: result.finalMessage });
+        if (delay > 0) {
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+        result = await run();
+    }
+    return result;
+}
 async function handleQueryTool(args, pluginManager) {
     const requestId = `query_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
     const logger = new error_handling_1.ConsoleLogger('QueryTool');
@@ -155,7 +180,12 @@ async function handleQueryTool(args, pluginManager) {
             ? [...capability_tools_1.CAPABILITY_TOOLS, ...resource_tools_1.RESOURCE_TOOLS, ...pluginKubectlTools, ...mcpTools, ...mermaid_tools_1.MERMAID_TOOLS]
             : [...capability_tools_1.CAPABILITY_TOOLS, ...resource_tools_1.RESOURCE_TOOLS, ...pluginKubectlTools, ...mcpTools];
         // Execute tool loop with capability, resource, kubectl, and MCP tools
-        const result = await aiProvider.toolLoop({
+        // The query tool loop uses only read-only tools (capability/resource search,
+        // kubectl get/describe/logs/events, mermaid), so a transient AI-loop failure is
+        // safe to retry. Smaller models occasionally fail the agentic loop; retry a
+        // bounded number of times before surfacing the (already isRetryable) error below.
+        const MAX_QUERY_ATTEMPTS = 3;
+        const runQueryLoop = () => aiProvider.toolLoop({
             systemPrompt,
             userMessage: intent,
             tools,
@@ -167,6 +197,11 @@ async function handleQueryTool(args, pluginManager) {
             },
             interaction_id: args.interaction_id
         });
+        const result = await runQueryLoopWithRetry(runQueryLoop, {
+            maxAttempts: MAX_QUERY_ATTEMPTS,
+            logger,
+            requestId,
+        });
         // Extract data from execution record (reliable, not AI self-reporting)
         const toolsUsed = [...new Set(result.toolCallsExecuted.map(tc => tc.tool))];
         logger.info('Query completed', {

package/dist/tools/version.d.ts

@@ -27,16 +27,6 @@ export interface SystemStatus {
         url: string;
         error?: string;
         collections: {
-            patterns: {
-                exists: boolean;
-                documentsCount?: number;
-                error?: string;
-            };
-            policies: {
-                exists: boolean;
-                documentsCount?: number;
-                error?: string;
-            };
             capabilities: {
                 exists: boolean;
                 documentsCount?: number;
@@ -132,10 +122,9 @@ export interface VersionSessionData extends BaseVisualizationData {
     system: SystemStatus;
     summary: {
         overall: 'healthy' | 'degraded';
-        patternSearch: string;
+        knowledgeSearch: string;
         capabilityScanning: string;
         kubernetesAccess: string;
-        policyIntentManagement: string;
         kyvernoPolicyGeneration: string;
         capabilities: string[];
     };

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

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

package/dist/tools/version.js

@@ -70,8 +70,6 @@ exports.VERSION_TOOL_INPUT_SCHEMA = {
  */
 function createErrorCollections(errorMessage) {
     return {
-        patterns: { exists: false, error: errorMessage },
-        policies: { exists: false, error: errorMessage },
         capabilities: { exists: false, error: errorMessage },
         resources: { exists: false, error: errorMessage },
         knowledgeBase: { exists: false, error: errorMessage },
@@ -101,16 +99,6 @@ async function getVectorDBStatus() {
         const url = toolResult?.data?.url || fallbackUrl;
         // Test each collection separately
         const embeddingService = new index_1.EmbeddingService();
-        // Test patterns collection
-        const patternsStatus = await testCollectionStatus('patterns', () => {
-            const patternService = new index_1.PatternVectorService('patterns', embeddingService);
-            return patternService.getPatternsCount();
-        });
-        // Test policies collection
-        const policiesStatus = await testCollectionStatus('policies', () => {
-            const policyService = new index_1.PolicyVectorService(embeddingService);
-            return policyService.getDataCount();
-        });
         // Test capabilities collection
         const capabilitiesStatus = await testCollectionStatus('capabilities', () => {
             const capabilityService = new index_1.CapabilityVectorService('capabilities', embeddingService);
@@ -124,8 +112,6 @@ async function getVectorDBStatus() {
             connected: true,
             url,
             collections: {
-                patterns: patternsStatus,
-                policies: policiesStatus,
                 capabilities: capabilitiesStatus,
                 resources: resourcesStatus,
                 knowledgeBase: knowledgeBaseStatus,
@@ -714,15 +700,20 @@ async function handleVersionTool(args, logger, requestId) {
         // Build summary object
         const summary = {
             overall: (vectorDBStatus.connected && aiProviderStatus.connected && kubernetesStatus.connected && capabilityStatus.systemReady ? 'healthy' : 'degraded'),
-            patternSearch: embeddingStatus.available ? 'semantic+keyword' : 'keyword-only',
+            // PRD #375: Unified knowledge base replaces separate pattern/policy search.
+            // Keep this on the same readiness rule as the `knowledge-base-search` capability
+            // below (both gate on vectorDBStatus.connected) so diagnostics never contradict.
+            knowledgeSearch: !vectorDBStatus.connected
+                ? 'unavailable'
+                : embeddingStatus.available
+                    ? 'semantic+keyword'
+                    : 'keyword-only',
             capabilityScanning: capabilityStatus.systemReady && kubernetesStatus.connected ? 'ready' : 'not-ready',
             kubernetesAccess: kubernetesStatus.connected ? 'connected' : 'disconnected',
-            policyIntentManagement: vectorDBStatus.connected && embeddingStatus.available ? 'ready' : 'not-ready',
             kyvernoPolicyGeneration: kyvernoStatus.policyGenerationReady ? 'ready' : 'not-ready',
             capabilities: [
-                vectorDBStatus.connected && vectorDBStatus.collections.patterns.exists ? 'pattern-management' : null,
-                // Policy intent management is available if Vector DB and embedding service are ready
-                vectorDBStatus.connected && embeddingStatus.available ? 'policy-intent-management' : null,
+                // PRD #375: knowledge-base-search replaces pattern-management and policy-intent-management
+                vectorDBStatus.connected ? 'knowledge-base-search' : null,
                 capabilityStatus.systemReady && kubernetesStatus.connected ? 'capability-scanning' : null,
                 embeddingStatus.available ? 'semantic-search' : null,
                 aiProviderStatus.connected ? 'ai-recommendations' : null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "1.23.1",
+  "version": "1.24.0",
   "description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
   "mcpName": "io.github.vfarcic/dot-ai",
   "main": "dist/index.js",
@@ -104,7 +104,6 @@
     "tsx": "^4.22.3",
     "typescript": "^5.0.0",
     "typescript-eslint": "^8.54.0",
-    "uuid": "^14.0.0",
     "vitest": "^4.0.0"
   },
   "dependencies": {
@@ -134,6 +133,7 @@
     "mermaid": "^11.15.0",
     "posthog-node": "^5.23.0",
     "simple-git": "^3.32.3",
+    "uuid": "^14.0.0",
     "yaml": "^2.8.0"
   },
   "overrides": {

package/prompts/knowledge-classification.md

@@ -0,0 +1,24 @@
+Classify this document by determining whether it contains policy content,
+pattern content, both, or neither.
+
+A **policy** is a rule, requirement, constraint, or guideline that should be enforced
+during infrastructure/application deployments. Examples:
+- "All databases must use PostgreSQL"
+- "Container images must come from approved registries"
+- "Services must have health checks defined"
+
+A **pattern** is a reusable deployment template or architectural approach. Examples:
+- "Public web applications use Deployment + Service + Ingress"
+- "Stateful workloads use StatefulSet + PVC + headless Service"
+- "Event-driven services use Knative Serving with autoscaling"
+
+Return ONLY a JSON array of applicable tags. Possible values: "policy", "pattern".
+- If the document contains policy content, include "policy"
+- If the document contains pattern content, include "pattern"
+- If it contains both, include both: ["policy", "pattern"]
+- If it contains neither, return an empty array: []
+
+Do not include any explanation, markdown formatting, or text outside the JSON array.
+
+Document:
+{{{documentContent}}}

package/prompts/operate-user.md

@@ -4,15 +4,14 @@
 
 ---
 
-# Organizational Patterns
+# Organizational Knowledge
 
-{{{patterns}}}
+The following organizational knowledge is relevant to this intent. Each entry is tagged with its type:
+- **[Policy]** = a rule or requirement that must be enforced
+- **[Pattern]** = a reusable architectural approach to follow
+- **[General]** = general guidance or context
 
----
-
-# Organizational Policies
-
-{{{policies}}}
+{{{knowledgeContext}}}
 
 ---
 
@@ -22,4 +21,4 @@
 
 ---
 
-Analyze this operational intent using the provided organizational context and cluster capabilities. Propose a validated operational solution following the workflow requirements specified in your system instructions.
+Analyze this operational intent using the provided organizational knowledge and cluster capabilities. Propose a validated operational solution following the workflow requirements specified in your system instructions.

package/dist/core/organizational-types.d.ts

@@ -1,43 +0,0 @@
-/**
- * Shared Organizational Entity Types
- *
- * Base interfaces and types for organizational entities (patterns and policies)
- * that enhance AI recommendations with institutional knowledge via RAG.
- */
-/**
- * Base interface for all organizational entities stored in Vector DB
- * Contains shared fields used by both patterns and policies
- */
-export interface BaseOrganizationalEntity {
-    id: string;
-    description: string;
-    triggers: string[];
-    rationale: string;
-    createdAt: string;
-    createdBy: string;
-}
-/**
- * Organizational Pattern - guides resource selection
- * Extends base entity with pattern-specific fields
- */
-export interface OrganizationalPattern extends BaseOrganizationalEntity {
-    suggestedResources: string[];
-}
-/**
- * Policy Intent - guides resource configuration
- * Extends base entity with policy-specific fields
- */
-export interface PolicyIntent extends BaseOrganizationalEntity {
-    deployedPolicies?: DeployedPolicyReference[];
-}
-/**
- * Reference to a deployed Kyverno policy
- * Stored in PolicyIntent to track lifecycle without duplicating YAML
- */
-export interface DeployedPolicyReference {
-    name: string;
-    appliedAt: string;
-}
-export type CreatePatternRequest = Omit<OrganizationalPattern, 'id' | 'createdAt'>;
-export type CreatePolicyIntentRequest = Omit<PolicyIntent, 'id' | 'createdAt' | 'deployedPolicies'>;
-//# sourceMappingURL=organizational-types.d.ts.map

package/dist/core/organizational-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"organizational-types.d.ts","sourceRoot":"","sources":["../../src/core/organizational-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACrE,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,wBAAwB;IAC5D,gBAAgB,CAAC,EAAE,uBAAuB,EAAE,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC;AAGnF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,GAAG,kBAAkB,CAAC,CAAC"}

package/dist/core/organizational-types.js

@@ -1,8 +0,0 @@
-"use strict";
-/**
- * Shared Organizational Entity Types
- *
- * Base interfaces and types for organizational entities (patterns and policies)
- * that enhance AI recommendations with institutional knowledge via RAG.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/pattern-operations.d.ts

@@ -1,50 +0,0 @@
-/**
- * Core Pattern Operations
- *
- * Complete operations for creating, validating, and managing organizational patterns
- * Handles workflow management, Vector DB operations, and MCP routing
- */
-import { OrganizationalPattern, CreatePatternRequest } from './pattern-types';
-import { Logger } from './error-handling';
-import { PatternVectorService } from './index';
-/**
- * Arguments for pattern operations
- */
-interface PatternOperationArgs {
-    sessionId?: string;
-    response?: string;
-    id?: string;
-    limit?: number;
-    step?: string;
-    [key: string]: unknown;
-}
-/**
- * Validation result structure
- */
-interface ValidationResult {
-    success: boolean;
-    error?: string;
-}
-/**
- * Pattern operation response
- */
-interface PatternOperationResponse {
-    success: boolean;
-    operation?: string;
-    dataType?: string;
-    error?: string;
-    message?: string;
-    [key: string]: unknown;
-}
-export declare function validatePattern(request: CreatePatternRequest): string[];
-export declare function createPattern(request: CreatePatternRequest): OrganizationalPattern;
-export declare function serializePattern(pattern: OrganizationalPattern): string;
-export declare function deserializePattern(json: string): OrganizationalPattern;
-/**
- * Handle pattern operations with workflow support
- * Shared validation functions are passed as parameters to avoid circular dependencies
- * PRD #359: Uses unified plugin registry for kubectl operations
- */
-export declare function handlePatternOperation(operation: string, args: PatternOperationArgs, logger: Logger, requestId: string, validateVectorDBConnection: (vectorService: PatternVectorService, logger: Logger, requestId: string) => Promise<ValidationResult>, validateEmbeddingService: (logger: Logger, requestId: string) => Promise<ValidationResult>): Promise<PatternOperationResponse>;
-export {};
-//# sourceMappingURL=pattern-operations.d.ts.map

package/dist/core/pattern-operations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pattern-operations.d.ts","sourceRoot":"","sources":["../../src/core/pattern-operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAA8C,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAQ/C;;GAEG;AACH,UAAU,oBAAoB;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,wBAAwB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,EAAE,CA2BvE;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,qBAAqB,CAwBlF;AAGD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAEvE;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAWtE;AAkBD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,0BAA0B,EAAE,CAAC,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,EACjI,wBAAwB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,GACzF,OAAO,CAAC,wBAAwB,CAAC,CAoYnC"}