@vfarcic/dot-ai 0.69.0 → 0.71.0

package/README.md

@@ -58,7 +58,7 @@ 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.
+**Get Started**: See the [Tools and Features Overview](./docs/mcp-tools-overview.md) for complete guide to all available tools including capability management, deployment recommendations, and workflow integration.
 
 ### Documentation Testing & Validation
 📖 **Automated Testing**: Validates documentation by executing commands and testing examples  
@@ -84,6 +84,12 @@ Result: Finds sqls.devopstoolkit.live as perfect match ✨
 
 **Setup Required**: See the [MCP Setup Guide](./docs/mcp-setup.md) for complete configuration instructions.
 
+## See It In Action
+
+[![DevOps AI Toolkit: AI-Powered Application Deployment](https://img.youtube.com/vi/8Yzn-9qQpQI/maxresdefault.jpg)](https://youtu.be/8Yzn-9qQpQI)
+
+This video explains the platform engineering problem and demonstrates the Kubernetes deployment recommendation workflow from intent to running applications.
+
 ## Quick Start
 
 ### Prerequisites
@@ -109,7 +115,7 @@ Result: Finds sqls.devopstoolkit.live as perfect match ✨
 
 **For organizational pattern management:**
 - **Vector DB service** (Qdrant) for pattern storage and semantic search
-- **OpenAI API key** (optional) for semantic pattern matching - falls back to keyword matching if not available
+- **OpenAI API key** (required) for semantic pattern matching and vector operations
 - See the [Pattern Management Guide](./docs/pattern-management-guide.md) for complete setup
 
 ### Installation
@@ -118,58 +124,60 @@ DevOps AI Toolkit is designed to be used through AI development tools via MCP (M
 
 ### Usage
 
-**AI Agent Integration (Claude Code Example)**
-Perfect for conversational AI-driven workflows:
+**🎯 Recommended: Docker Setup (Complete Stack)**
+Perfect for getting all features working immediately with minimal setup:
+
+1. **Download Docker Compose configuration:**
+```bash
+curl -o docker-compose-dot-ai.yaml https://raw.githubusercontent.com/vfarcic/dot-ai/main/docker-compose-dot-ai.yaml
+```
+
+2. **Set environment variables and create MCP configuration:**
+```bash
+# Set your API keys
+export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"
+export OPENAI_API_KEY="sk-proj-your-openai-key-here"
 
-1. **Create `.mcp.json` in your project:**
-<!-- dotai-ignore: MCP server binary (dot-ai-mcp) only works through MCP client connections -->
-```json
+# Create MCP configuration for Claude Code
+cat > .mcp.json << 'EOF'
 {
   "mcpServers": {
     "dot-ai": {
-      "command": "npx",
-      "args": ["-y", "--package=@vfarcic/dot-ai@latest", "dot-ai-mcp"],
-      "env": {
-        "ANTHROPIC_API_KEY": "your_key_here",
-        "DOT_AI_SESSION_DIR": "./tmp/sessions",
-        "KUBECONFIG": "~/.kube/config",
-        "QDRANT_URL": "https://your-cluster.qdrant.io",
-        "QDRANT_API_KEY": "your_qdrant_key",
-        "OPENAI_API_KEY": "sk-proj-your_openai_key"
-      }
+      "command": "docker",
+      "args": [
+        "compose", 
+        "-f",
+        "docker-compose-dot-ai.yaml",
+        "--env-file",
+        ".env",
+        "run", 
+        "--rm",
+        "--remove-orphans",
+        "dot-ai"
+      ]
     }
   }
 }
+EOF
 ```
 
-**Note**: Replace all placeholder values (like `your_key_here`, `your-cluster.qdrant.io`) with your actual API keys and service URLs.
+**What you get:**
+- ✅ **Complete Stack**: MCP server + Qdrant vector database included
+- ✅ **All Features Working**: Capability management, pattern storage, semantic search
+- ✅ **No External Dependencies**: Everything runs in containers
+- ✅ **Kubernetes Integration**: Direct kubectl access to your clusters
 
-**Environment Variable Setup**: You can set these variables either:
-- **In the `.mcp.json` file** (as shown above in the `env` section), OR  
-- **As shell environment variables** (e.g., `export ANTHROPIC_API_KEY=your_key_here`), OR
-- **A combination of both** (shell variables take precedence)
+**Alternative Methods**: See the [MCP Setup Guide](docs/mcp-setup.md) for NPX (Node.js) and Development setup options.
 
-**Environment Variables:**
-- `ANTHROPIC_API_KEY`: Required for AI analysis (Kubernetes deployments, documentation testing, pattern management). Not required for shared prompts library.
-- `DOT_AI_SESSION_DIR`: Required session directory (relative paths are relative to where the AI agent is started)
-- `KUBECONFIG`: Optional kubeconfig path for Kubernetes deployments (adjust to your actual kubeconfig location, defaults to `~/.kube/config`)
-- `QDRANT_URL`: Required for pattern management - Vector DB endpoint
-- `QDRANT_API_KEY`: Required for pattern management - Vector DB authentication  
-- `OPENAI_API_KEY`: Optional for semantic pattern matching - enables enhanced pattern search
-
-2. **Start Claude Code with MCP enabled:**
+3. **Start your MCP client:**
 ```bash
-# Create session directory (relative to the project)
-mkdir -p tmp/sessions
-
-claude
+claude  # or your preferred MCP-enabled AI tool
 
-# Verify MCP server connection by running `/mcp` command
-# Example: type `/mcp` in Claude Code to see server status
-# Expected output shows "dot-ai" server connected with available tools
+# Verify everything works by asking:
+"Show dot-ai status"
 ```
 
-3. **Use conversational workflows:**
+4. **Use conversational workflows:**
 
 **Example: Kubernetes Deployment**
 ```
@@ -271,10 +279,8 @@ Agent: I'm executing the PRD creation workflow. Please describe the feature you
 ## Documentation
 
 ### 🚀 Getting Started
-- **[MCP Setup Guide](docs/mcp-setup.md)** - AI tools integration (Claude Code, Cursor)
-- **[MCP Recommendation Guide](docs/mcp-recommendation-guide.md)** - Kubernetes deployment recommendations  
-- **[MCP Documentation Testing Guide](docs/mcp-documentation-testing-guide.md)** - Automated documentation validation
-- **[MCP Prompts Guide](docs/mcp-prompts-guide.md)** - Shared prompt library and slash commands
+- **[MCP Setup Guide](docs/mcp-setup.md)** - Complete configuration instructions for AI tools integration
+- **[Tools and Features Overview](docs/mcp-tools-overview.md)** - Comprehensive guide to all available tools and features
 
 ## Support
 

package/dist/tools/version.d.ts

@@ -6,7 +6,7 @@
  */
 import { Logger } from '../core/error-handling';
 export declare const VERSION_TOOL_NAME = "version";
-export declare const VERSION_TOOL_DESCRIPTION = "Get comprehensive system status including version information, Vector DB connection status, embedding service capabilities, Anthropic API connectivity, and pattern management health check";
+export declare const VERSION_TOOL_DESCRIPTION = "Get comprehensive system status including version information, Vector DB connection status, embedding service capabilities, Anthropic API connectivity, Kubernetes cluster connectivity, and pattern management health check";
 export declare const VERSION_TOOL_INPUT_SCHEMA: {};
 export interface VersionInfo {
     version: string;
@@ -35,6 +35,17 @@ export interface SystemStatus {
         keyConfigured: boolean;
         error?: string;
     };
+    kubernetes: {
+        connected: boolean;
+        clusterInfo?: {
+            endpoint?: string;
+            version?: string;
+            context?: string;
+        };
+        kubeconfig: string;
+        error?: string;
+        errorType?: string;
+    };
     capabilities: {
         systemReady: boolean;
         vectorDBHealthy: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/tools/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,wBAAwB,gMAAgM,CAAC;AACtO,eAAO,MAAM,yBAAyB,IAAK,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE;QACR,SAAS,EAAE,OAAO,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,SAAS,EAAE;QACT,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,EAAE;QACT,SAAS,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,YAAY,EAAE;QACZ,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;QACzB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AA+MD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAqB5C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAsEd"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/tools/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIhD,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,wBAAwB,iOAAiO,CAAC;AACvQ,eAAO,MAAM,yBAAyB,IAAK,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE;QACR,SAAS,EAAE,OAAO,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,SAAS,EAAE;QACT,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,EAAE;QACT,SAAS,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,OAAO,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE;QACV,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE;YACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,EAAE;QACZ,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;QACzB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AA2QD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAqB5C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CA2Ed"}

package/dist/tools/version.js

@@ -45,8 +45,9 @@ exports.handleVersionTool = handleVersionTool;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const index_1 = require("../core/index");
+const kubernetes_utils_1 = require("../core/kubernetes-utils");
 exports.VERSION_TOOL_NAME = 'version';
-exports.VERSION_TOOL_DESCRIPTION = 'Get comprehensive system status including version information, Vector DB connection status, embedding service capabilities, Anthropic API connectivity, and pattern management health check';
+exports.VERSION_TOOL_DESCRIPTION = 'Get comprehensive system status including version information, Vector DB connection status, embedding service capabilities, Anthropic API connectivity, Kubernetes cluster connectivity, and pattern management health check';
 exports.VERSION_TOOL_INPUT_SCHEMA = {};
 /**
  * Test Vector DB connectivity and get status
@@ -195,6 +196,61 @@ async function getCapabilityStatus() {
         };
     }
 }
+/**
+ * Test Kubernetes cluster connectivity
+ */
+async function getKubernetesStatus() {
+    const kubeconfig = process.env.KUBECONFIG || '~/.kube/config';
+    try {
+        // Test basic connectivity with cluster-info
+        const clusterInfo = await (0, kubernetes_utils_1.executeKubectl)(['cluster-info'], {
+            kubeconfig: kubeconfig,
+            timeout: 10000 // 10 second timeout
+        });
+        // Parse cluster info to extract endpoint
+        const endpointMatch = clusterInfo.match(/Kubernetes control plane is running at (https?:\/\/[^\s]+)/);
+        const endpoint = endpointMatch ? endpointMatch[1] : undefined;
+        // Get current context
+        let context;
+        try {
+            context = await (0, kubernetes_utils_1.executeKubectl)(['config', 'current-context'], { kubeconfig });
+        }
+        catch (error) {
+            // Context retrieval is optional
+            context = undefined;
+        }
+        // Get server version
+        let version;
+        try {
+            const versionInfo = await (0, kubernetes_utils_1.executeKubectl)(['version', '--short'], { kubeconfig, timeout: 5000 });
+            const serverMatch = versionInfo.match(/Server Version: (.+)/);
+            version = serverMatch ? serverMatch[1] : undefined;
+        }
+        catch (error) {
+            // Version retrieval is optional
+            version = undefined;
+        }
+        return {
+            connected: true,
+            clusterInfo: {
+                endpoint,
+                version,
+                context
+            },
+            kubeconfig
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const classified = kubernetes_utils_1.ErrorClassifier.classifyError(error);
+        return {
+            connected: false,
+            kubeconfig,
+            error: errorMessage,
+            errorType: classified.type
+        };
+    }
+}
 /**
  * Test Anthropic API connectivity
  */
@@ -260,10 +316,11 @@ async function handleVersionTool(args, logger, requestId) {
         const version = getVersionInfo();
         // Run all diagnostics in parallel for better performance
         logger.info('Running system diagnostics...', { requestId });
-        const [vectorDBStatus, embeddingStatus, anthropicStatus, capabilityStatus] = await Promise.all([
+        const [vectorDBStatus, embeddingStatus, anthropicStatus, kubernetesStatus, capabilityStatus] = await Promise.all([
             getVectorDBStatus(),
             getEmbeddingStatus(),
             getAnthropicStatus(),
+            getKubernetesStatus(),
             getCapabilityStatus()
         ]);
         const systemStatus = {
@@ -271,6 +328,7 @@ async function handleVersionTool(args, logger, requestId) {
             vectorDB: vectorDBStatus,
             embedding: embeddingStatus,
             anthropic: anthropicStatus,
+            kubernetes: kubernetesStatus,
             capabilities: capabilityStatus
         };
         // Log summary of system health
@@ -280,6 +338,7 @@ async function handleVersionTool(args, logger, requestId) {
             vectorDBConnected: vectorDBStatus.connected,
             embeddingAvailable: embeddingStatus.available,
             anthropicConnected: anthropicStatus.connected,
+            kubernetesConnected: kubernetesStatus.connected,
             capabilitySystemReady: capabilityStatus.systemReady
         });
         return {
@@ -289,14 +348,16 @@ async function handleVersionTool(args, logger, requestId) {
                         status: 'success',
                         system: systemStatus,
                         summary: {
-                            overall: vectorDBStatus.connected && anthropicStatus.connected && capabilityStatus.systemReady ? 'healthy' : 'degraded',
+                            overall: vectorDBStatus.connected && anthropicStatus.connected && kubernetesStatus.connected && capabilityStatus.systemReady ? 'healthy' : 'degraded',
                             patternSearch: embeddingStatus.available ? 'semantic+keyword' : 'keyword-only',
-                            capabilityScanning: capabilityStatus.systemReady ? 'ready' : 'not-ready',
+                            capabilityScanning: capabilityStatus.systemReady && kubernetesStatus.connected ? 'ready' : 'not-ready',
+                            kubernetesAccess: kubernetesStatus.connected ? 'connected' : 'disconnected',
                             capabilities: [
                                 vectorDBStatus.connected ? 'pattern-management' : null,
-                                capabilityStatus.systemReady ? 'capability-scanning' : null,
+                                capabilityStatus.systemReady && kubernetesStatus.connected ? 'capability-scanning' : null,
                                 embeddingStatus.available ? 'semantic-search' : null,
-                                anthropicStatus.connected ? 'ai-recommendations' : null
+                                anthropicStatus.connected ? 'ai-recommendations' : null,
+                                kubernetesStatus.connected ? 'kubernetes-integration' : null
                             ].filter(Boolean)
                         },
                         timestamp: new Date().toISOString()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.69.0",
+  "version": "0.71.0",
   "description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",