@vfarcic/dot-ai 0.49.0 → 0.50.0

package/README.md

@@ -12,7 +12,7 @@ DevOps AI Toolkit is an AI-powered development productivity platform that enhanc
 
 ### Kubernetes Deployment
 - **Developers**: Deploy applications without needing deep Kubernetes expertise
-- **Platform Engineers**: Create organizational deployment patterns that enhance AI recommendations with institutional knowledge and best practices
+- **Platform Engineers**: Create organizational deployment patterns that enhance AI recommendations with institutional knowledge and best practices, and scan cluster resources to enable semantic matching for dramatically improved recommendation accuracy
 
 ### Documentation Testing  
 - **Documentation Maintainers**: Automatically validate documentation accuracy and catch outdated content
@@ -31,10 +31,34 @@ DevOps AI Toolkit is an AI-powered development productivity platform that enhanc
 
 ### Kubernetes Deployment Intelligence
 🔍 **Smart Discovery**: Automatically finds all available resources and operators in your cluster  
-🤖 **AI Recommendations**: Get deployment suggestions tailored to your specific cluster setup  
+🧠 **Semantic Capability Management**: Discovers what each resource actually does for intelligent matching  
+🤖 **AI Recommendations**: Get deployment suggestions tailored to your specific cluster setup with enhanced semantic understanding  
 🔧 **Operator-Aware**: Leverages custom operators and CRDs when available  
 🚀 **Complete Workflow**: From discovery to deployment with automated Kubernetes integration
 
+#### Capability-Enhanced Recommendations
+Transform how AI understands your cluster by discovering semantic capabilities of each resource:
+
+**The Problem**: Traditional discovery sees `sqls.devopstoolkit.live` as a meaningless name among hundreds of resources.
+
+**The Solution**: Capability management teaches the system that `sqls.devopstoolkit.live` handles PostgreSQL databases with multi-cloud support.
+
+**Before Capability Management:**
+```
+User: "I need a PostgreSQL database"
+AI: Gets 400+ generic resource names → picks complex multi-resource solution
+Result: Misses optimal single-resource solutions
+```
+
+**After Capability Management:**
+```
+User: "I need a PostgreSQL database"  
+AI: Gets pre-filtered relevant resources with rich context
+Result: Finds sqls.devopstoolkit.live as perfect match ✨
+```
+
+**Get Started**: See the [Capability Management Guide](./docs/mcp-capability-management-guide.md) for complete workflows including cluster scanning, capability search, and recommendation enhancement.
+
 ### Documentation Testing & Validation
 📖 **Automated Testing**: Validates documentation by executing commands and testing examples  
 🔍 **Two-Phase Validation**: Tests both functionality (does it work?) and semantic accuracy (are descriptions truthful?)  
@@ -164,6 +188,29 @@ Agent: Perfect! Generating manifests and deploying now...
 Agent: ✅ Successfully deployed! Your application is running.
 ```
 
+**Example: Capability Management**
+```
+User: I want to scan my cluster for resource capabilities to improve recommendations
+
+Agent: I'll help you scan your cluster to discover semantic capabilities. This will dramatically improve recommendation accuracy.
+[Uses manageOrgData with capabilities scanning]
+
+Agent: Would you like to scan all cluster resources or specify a subset?
+Options: 1) All resources 2) Specific subset
+
+User: All resources in auto mode
+
+Agent: Starting comprehensive cluster capability scan...
+✅ Capability scan completed! Processed cluster resources successfully.
+
+User: Now I need a PostgreSQL database
+
+Agent: Let me get enhanced recommendations using your capability data.
+[Uses recommend tool with capability pre-filtering]
+
+Agent: Perfect! I found sqls.devopstoolkit.live as the top match - it's a managed database solution supporting PostgreSQL with multi-cloud capabilities and low complexity. Much better than the generic StatefulSet approach I would have suggested before!
+```
+
 **Example: Documentation Testing**
 ```
 User: I want to test my README.md file to make sure all the examples work

package/dist/core/base-vector-service.d.ts

@@ -53,6 +53,10 @@ export declare abstract class BaseVectorService<T> {
      * Delete data by ID
      */
     deleteData(id: string): Promise<void>;
+    /**
+     * Delete all data (recreate collection)
+     */
+    deleteAllData(): Promise<void>;
     /**
      * Get all data (limited)
      */
@@ -74,10 +78,6 @@ export declare abstract class BaseVectorService<T> {
      * Hybrid search combining semantic and keyword matching
      */
     private hybridSearch;
-    /**
-     * Keyword-only search (fallback when embeddings not available)
-     */
-    private keywordOnlySearch;
     /**
      * Combine semantic and keyword results with hybrid ranking
      */

package/dist/core/base-vector-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-vector-service.d.ts","sourceRoot":"","sources":["../../src/core/base-vector-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC9C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,8BAAsB,iBAAiB,CAAC,CAAC;IACvC,SAAS,CAAC,QAAQ,EAAE,eAAe,CAAC;IACpC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC7C,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;gBAErB,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAAE,gBAAgB;IAMnG;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BvC;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAyBjC;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAW5C;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAS9C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAWrC;;OAEG;IACH,aAAa,IAAI,UAAU;IAU3B,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM;IACpD,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM;IAC7C,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;IAGjE,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAIlD;;OAEG;YACW,YAAY;IAkC1B;;OAEG;YACW,iBAAiB;IAsB/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA2C7B"}
+{"version":3,"file":"base-vector-service.d.ts","sourceRoot":"","sources":["../../src/core/base-vector-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC9C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,8BAAsB,iBAAiB,CAAC,CAAC;IACvC,SAAS,CAAC,QAAQ,EAAE,eAAe,CAAC;IACpC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC7C,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;gBAErB,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAAE,gBAAgB;IAMnG;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvC;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAyBjC;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAW5C;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;OAEG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAS9C;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAWrC;;OAEG;IACH,aAAa,IAAI,UAAU;IAU3B,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM;IACpD,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM;IAC7C,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;IAGjE,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAIlD;;OAEG;YACW,YAAY;IAkC1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA2C7B"}

package/dist/core/base-vector-service.js

@@ -43,25 +43,29 @@ class BaseVectorService {
     async storeData(data) {
         const searchText = this.createSearchText(data);
         const id = this.extractId(data);
-        // Try to generate embedding if service is available
-        let embedding = null;
+        // Generate embedding - required for vector storage
+        let embedding;
         if (this.embeddingService.isAvailable()) {
             try {
                 embedding = await this.embeddingService.generateEmbedding(searchText);
             }
             catch (error) {
-                // Log but don't fail - fall back to keyword-only storage
-                console.warn(`Failed to generate embedding for ${this.collectionName}, using keyword-only storage:`, error);
+                // Fail immediately with clear error about embedding generation
+                throw new Error(`Embedding generation failed: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
+        else {
+            // Embedding service not available - fail with clear error
+            throw new Error('Embedding service not available - cannot store data in vector collection');
+        }
         const document = {
             id,
             payload: {
                 ...this.createPayload(data),
                 searchText: searchText,
-                hasEmbedding: embedding !== null
+                hasEmbedding: true
             },
-            vector: embedding || undefined
+            vector: embedding
         };
         await this.vectorDB.upsertDocument(document);
     }
@@ -69,25 +73,25 @@ class BaseVectorService {
      * Search for data using hybrid semantic + keyword matching
      */
     async searchData(query, options = {}) {
+        // Fail immediately if embedding service not available - no graceful fallback
+        if (!this.embeddingService.isAvailable()) {
+            throw new Error('Embedding service not available - cannot perform semantic search');
+        }
         // Extract keywords for keyword search
         const queryKeywords = this.extractKeywords(query);
         if (queryKeywords.length === 0) {
             return [];
         }
         const limit = options.limit || 10;
-        const scoreThreshold = options.scoreThreshold || 0.1;
-        // Try semantic search first if embeddings available
-        if (this.embeddingService.isAvailable()) {
-            try {
-                return await this.hybridSearch(query, queryKeywords, { limit, scoreThreshold });
-            }
-            catch (error) {
-                // Fall back to keyword-only search if semantic search fails
-                console.warn('Semantic search failed, falling back to keyword search:', error);
-            }
+        const scoreThreshold = options.scoreThreshold || 0.01;
+        // Perform hybrid search (semantic + keyword)
+        try {
+            return await this.hybridSearch(query, queryKeywords, { limit, scoreThreshold });
+        }
+        catch (error) {
+            // Fail immediately - no fallback to keyword-only search
+            throw new Error(`Semantic search failed: ${error instanceof Error ? error.message : String(error)}`);
         }
-        // Keyword-only search (fallback or when embeddings not available)
-        return await this.keywordOnlySearch(queryKeywords, { limit, scoreThreshold });
     }
     /**
      * Get data by ID
@@ -108,6 +112,12 @@ class BaseVectorService {
     async deleteData(id) {
         await this.vectorDB.deleteDocument(id);
     }
+    /**
+     * Delete all data (recreate collection)
+     */
+    async deleteAllData() {
+        await this.vectorDB.deleteAllDocuments();
+    }
     /**
      * Get all data (limited)
      */
@@ -152,16 +162,15 @@ class BaseVectorService {
      * Hybrid search combining semantic and keyword matching
      */
     async hybridSearch(query, queryKeywords, options) {
-        // Generate query embedding
+        // Generate query embedding - required for semantic search
         const queryEmbedding = await this.embeddingService.generateEmbedding(query);
         if (!queryEmbedding) {
-            // Fall back to keyword search
-            return await this.keywordOnlySearch(queryKeywords, options);
+            throw new Error('Failed to generate query embedding for semantic search');
         }
         // Semantic search using vector similarity
         const semanticResults = await this.vectorDB.searchSimilar(queryEmbedding, {
             limit: options.limit * 2, // Get more candidates for hybrid ranking
-            scoreThreshold: 0.5 // Lower threshold for semantic similarity
+            scoreThreshold: 0.1 // Very permissive threshold for single-word queries
         });
         // Keyword search
         const keywordResults = await this.vectorDB.searchByKeywords(queryKeywords, {
@@ -171,23 +180,6 @@ class BaseVectorService {
         // Combine and rank results
         return this.combineHybridResults(semanticResults, keywordResults, queryKeywords, options);
     }
-    /**
-     * Keyword-only search (fallback when embeddings not available)
-     */
-    async keywordOnlySearch(queryKeywords, options) {
-        const keywordResults = await this.vectorDB.searchByKeywords(queryKeywords, options);
-        return keywordResults
-            .map(result => {
-            const data = this.payloadToData(result.payload);
-            data.id = result.id;
-            return {
-                data,
-                score: result.score,
-                matchType: 'keyword'
-            };
-        })
-            .filter(result => result.score >= options.scoreThreshold); // Apply score filtering
-    }
     /**
      * Combine semantic and keyword results with hybrid ranking
      */

package/dist/core/capabilities.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Resource Capability Discovery & Inference Engine
+ *
+ * PRD #48: Resource Capabilities Discovery & Integration
+ *
+ * This module provides capability inference for Kubernetes resources through
+ * AI-powered analysis of schemas and metadata.
+ */
+import { Logger } from './error-handling';
+import { ClaudeIntegration } from './claude';
+/**
+ * Complete resource capability data structure for Vector DB storage
+ */
+export interface ResourceCapability {
+    resourceName: string;
+    capabilities: string[];
+    providers: string[];
+    abstractions: string[];
+    complexity: 'low' | 'medium' | 'high';
+    description: string;
+    useCase: string;
+    embedding?: number[];
+    analyzedAt: string;
+    confidence: number;
+}
+/**
+ * Generic Capability Inference Engine
+ *
+ * Analyzes any Kubernetes CRD using AI to extract semantic capabilities
+ * for improved AI recommendations and resource matching.
+ */
+export declare class CapabilityInferenceEngine {
+    private logger;
+    private claudeIntegration;
+    constructor(claudeIntegration: ClaudeIntegration, logger: Logger);
+    /**
+     * Main entry point: analyze resource to infer complete capabilities
+     *
+     * @param resourceName - Full resource name (e.g., "resourcegroups.azure.upbound.io")
+     * @throws Error if capability inference fails for any reason
+     */
+    inferCapabilities(resourceName: string, schema?: string, metadata?: any): Promise<ResourceCapability>;
+    /**
+     * Use AI to infer capabilities from all available resource context
+     *
+     * @throws Error if AI inference fails
+     */
+    private inferWithAI;
+    /**
+     * Build AI inference prompt using standard prompt loading pattern
+     *
+     * @throws Error if prompt template cannot be loaded
+     */
+    private buildInferencePrompt;
+    /**
+     * Parse AI response into structured capability data
+     *
+     * @throws Error if AI response cannot be parsed or is invalid
+     */
+    private parseCapabilitiesFromAI;
+    /**
+     * Build final ResourceCapability from AI analysis result
+     */
+    private buildResourceCapability;
+    /**
+     * Generate Vector DB ID for capability storage
+     * Creates deterministic UUID from resource name for Qdrant compatibility
+     */
+    static generateCapabilityId(resourceName: string): string;
+}
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/core/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/core/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAK7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,YAAY,EAAE,MAAM,CAAC;IAGrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAGtC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAGrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM;IAKhE;;;;;OAKG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,GAAG,GACb,OAAO,CAAC,kBAAkB,CAAC;IA4B9B;;;;OAIG;YACW,WAAW;IA2BzB;;;;OAIG;YACW,oBAAoB;IAkClC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAwD/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAQ1D"}

package/dist/core/capabilities.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * Resource Capability Discovery & Inference Engine
+ *
+ * PRD #48: Resource Capabilities Discovery & Integration
+ *
+ * This module provides capability inference for Kubernetes resources through
+ * AI-powered analysis of schemas and metadata.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapabilityInferenceEngine = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Generic Capability Inference Engine
+ *
+ * Analyzes any Kubernetes CRD using AI to extract semantic capabilities
+ * for improved AI recommendations and resource matching.
+ */
+class CapabilityInferenceEngine {
+    logger;
+    claudeIntegration;
+    constructor(claudeIntegration, logger) {
+        this.claudeIntegration = claudeIntegration;
+        this.logger = logger;
+    }
+    /**
+     * Main entry point: analyze resource to infer complete capabilities
+     *
+     * @param resourceName - Full resource name (e.g., "resourcegroups.azure.upbound.io")
+     * @throws Error if capability inference fails for any reason
+     */
+    async inferCapabilities(resourceName, schema, metadata) {
+        const requestId = `capability-inference-${Date.now()}`;
+        this.logger.info('Starting capability inference', {
+            requestId,
+            resource: resourceName,
+            hasSchema: !!schema,
+            hasMetadata: !!metadata
+        });
+        // Use AI to analyze all available information
+        const aiResult = await this.inferWithAI(resourceName, schema, metadata, requestId);
+        // Convert AI result to final capability structure
+        const finalCapability = this.buildResourceCapability(resourceName, aiResult);
+        this.logger.info('Capability inference completed', {
+            requestId,
+            resource: resourceName,
+            capabilitiesFound: finalCapability.capabilities.length,
+            providersFound: finalCapability.providers.length,
+            complexity: finalCapability.complexity,
+            confidence: finalCapability.confidence
+        });
+        return finalCapability;
+    }
+    /**
+     * Use AI to infer capabilities from all available resource context
+     *
+     * @throws Error if AI inference fails
+     */
+    async inferWithAI(resourceName, schema, metadata, requestId) {
+        try {
+            const prompt = await this.buildInferencePrompt(resourceName, schema, metadata);
+            const response = await this.claudeIntegration.sendMessage(prompt);
+            return this.parseCapabilitiesFromAI(response.content);
+        }
+        catch (error) {
+            this.logger.error('AI capability inference failed', error, {
+                requestId,
+                resource: resourceName
+            });
+            throw error; // Re-throw to maintain fail-fast behavior
+        }
+    }
+    /**
+     * Build AI inference prompt using standard prompt loading pattern
+     *
+     * @throws Error if prompt template cannot be loaded
+     */
+    async buildInferencePrompt(resourceName, schema, metadata) {
+        // Load prompt template using standard pattern from existing codebase
+        const promptPath = path.join(__dirname, '..', '..', 'prompts', 'capability-inference.md');
+        if (!fs.existsSync(promptPath)) {
+            throw new Error(`Capability inference prompt template not found: ${promptPath}`);
+        }
+        let template;
+        try {
+            template = fs.readFileSync(promptPath, 'utf8');
+        }
+        catch (error) {
+            throw new Error(`Failed to read capability inference prompt: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // Replace template variables using standard pattern
+        const analysisContext = schema && metadata ?
+            'Schema and metadata available' :
+            schema ? 'Schema only' :
+                metadata ? 'Metadata only' : 'Limited context';
+        const finalPrompt = template
+            .replace(/\{resourceName\}/g, resourceName)
+            .replace(/\{analysisContext\}/g, analysisContext)
+            .replace(/\{schema\}/g, schema || 'No schema provided')
+            .replace(/\{metadata\}/g, metadata ? JSON.stringify(metadata, null, 2) : 'No metadata provided');
+        return finalPrompt;
+    }
+    /**
+     * Parse AI response into structured capability data
+     *
+     * @throws Error if AI response cannot be parsed or is invalid
+     */
+    parseCapabilitiesFromAI(response) {
+        // Look for JSON in the response using standard pattern
+        const jsonMatch = response.match(/\{[\s\S]*\}/);
+        if (!jsonMatch) {
+            throw new Error(`No JSON found in AI response. Response: ${response.substring(0, 200)}...`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(jsonMatch[0]);
+        }
+        catch (parseError) {
+            throw new Error(`Invalid JSON in AI response: ${parseError instanceof Error ? parseError.message : String(parseError)}. JSON: ${jsonMatch[0].substring(0, 200)}...`);
+        }
+        // Validate required fields with detailed error messages
+        if (!Array.isArray(parsed.capabilities)) {
+            throw new Error(`AI response missing or invalid capabilities array. Got: ${typeof parsed.capabilities}`);
+        }
+        if (!Array.isArray(parsed.providers)) {
+            throw new Error(`AI response missing or invalid providers array. Got: ${typeof parsed.providers}`);
+        }
+        if (!Array.isArray(parsed.abstractions)) {
+            throw new Error(`AI response missing or invalid abstractions array. Got: ${typeof parsed.abstractions}`);
+        }
+        if (!['low', 'medium', 'high'].includes(parsed.complexity)) {
+            throw new Error(`AI response invalid complexity: ${parsed.complexity}. Must be low, medium, or high`);
+        }
+        if (typeof parsed.description !== 'string' || parsed.description.trim() === '') {
+            throw new Error(`AI response missing or invalid description. Got: ${typeof parsed.description}`);
+        }
+        if (typeof parsed.useCase !== 'string' || parsed.useCase.trim() === '') {
+            throw new Error(`AI response missing or invalid useCase. Got: ${typeof parsed.useCase}`);
+        }
+        if (typeof parsed.confidence !== 'number' || parsed.confidence < 0 || parsed.confidence > 1) {
+            throw new Error(`AI response invalid confidence score: ${parsed.confidence}. Must be number between 0-1`);
+        }
+        return {
+            capabilities: parsed.capabilities,
+            providers: parsed.providers,
+            abstractions: parsed.abstractions,
+            complexity: parsed.complexity,
+            description: parsed.description.trim(),
+            useCase: parsed.useCase.trim(),
+            confidence: parsed.confidence
+        };
+    }
+    /**
+     * Build final ResourceCapability from AI analysis result
+     */
+    buildResourceCapability(resourceName, aiResult) {
+        return {
+            resourceName,
+            capabilities: aiResult.capabilities,
+            providers: aiResult.providers,
+            abstractions: aiResult.abstractions,
+            complexity: aiResult.complexity,
+            description: aiResult.description,
+            useCase: aiResult.useCase,
+            confidence: aiResult.confidence,
+            analyzedAt: new Date().toISOString()
+        };
+    }
+    /**
+     * Generate Vector DB ID for capability storage
+     * Creates deterministic UUID from resource name for Qdrant compatibility
+     */
+    static generateCapabilityId(resourceName) {
+        // Create deterministic UUID from resource name hash
+        const crypto = require('crypto');
+        const hash = crypto.createHash('sha256').update(`capability-${resourceName}`).digest('hex');
+        // Convert to UUID format: 8-4-4-4-12
+        return `${hash.substring(0, 8)}-${hash.substring(8, 12)}-${hash.substring(12, 16)}-${hash.substring(16, 20)}-${hash.substring(20, 32)}`;
+    }
+}
+exports.CapabilityInferenceEngine = CapabilityInferenceEngine;

package/dist/core/capability-vector-service.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Capability Vector Service
+ *
+ * Vector-based storage and retrieval for resource capabilities
+ * Extends BaseVectorService to provide capability-specific operations
+ */
+import { BaseVectorService, BaseSearchOptions, BaseSearchResult } from './base-vector-service';
+import { VectorDBService } from './vector-db-service';
+import { EmbeddingService } from './embedding-service';
+export interface ResourceCapability {
+    resourceName: string;
+    capabilities: string[];
+    providers: string[];
+    abstractions: string[];
+    complexity: 'low' | 'medium' | 'high';
+    description: string;
+    useCase: string;
+    confidence: number;
+    analyzedAt: string;
+}
+export interface CapabilitySearchOptions extends BaseSearchOptions {
+    complexityFilter?: 'low' | 'medium' | 'high';
+    providerFilter?: string[];
+}
+/**
+ * Vector service for storing and searching resource capabilities
+ */
+export declare class CapabilityVectorService extends BaseVectorService<ResourceCapability> {
+    constructor(vectorDB?: VectorDBService, embeddingService?: EmbeddingService);
+    /**
+     * Create searchable text from capability data for embedding generation
+     */
+    protected createSearchText(capability: ResourceCapability): string;
+    /**
+     * Extract unique ID from capability data
+     */
+    protected extractId(capability: ResourceCapability): string;
+    /**
+     * Convert capability to storage payload format
+     */
+    protected createPayload(capability: ResourceCapability): Record<string, any>;
+    /**
+     * Convert storage payload back to capability object
+     */
+    protected payloadToData(payload: Record<string, any>): ResourceCapability;
+    /**
+     * Store a capability in the vector database
+     */
+    storeCapability(capability: ResourceCapability): Promise<void>;
+    /**
+     * Search capabilities by user intent with optional filters
+     */
+    searchCapabilities(intent: string, options?: CapabilitySearchOptions): Promise<BaseSearchResult<ResourceCapability>[]>;
+    /**
+     * Get capability by ID or resource name
+     * Handles both Vector DB IDs (from list operations) and resource names
+     */
+    getCapability(idOrResourceName: string): Promise<ResourceCapability | null>;
+    /**
+     * Delete capability by resource name
+     */
+    deleteCapability(resourceName: string): Promise<void>;
+    /**
+     * Delete capability by ID (for MCP tool interface)
+     */
+    deleteCapabilityById(id: string): Promise<void>;
+    /**
+     * Delete all capabilities efficiently by recreating collection
+     */
+    deleteAllCapabilities(): Promise<void>;
+    /**
+     * List all capabilities with optional pagination
+     */
+    getAllCapabilities(limit?: number): Promise<ResourceCapability[]>;
+    /**
+     * Get count of stored capabilities
+     */
+    getCapabilitiesCount(): Promise<number>;
+}
+//# sourceMappingURL=capability-vector-service.d.ts.map

package/dist/core/capability-vector-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-vector-service.d.ts","sourceRoot":"","sources":["../../src/core/capability-vector-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,iBAAiB,CAAC,kBAAkB,CAAC;gBAEpE,QAAQ,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,EAAE,gBAAgB;IAI3E;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM;IAYlE;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM;IAI3D;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAc5E;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,kBAAkB;IAczE;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,CAAC;IAoBlD;;;OAGG;IACG,aAAa,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAgBjF;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D;;OAEG;IACG,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIvE;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;CAK9C"}