@vfarcic/dot-ai 0.173.0 → 0.175.0

package/dist/tools/query.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Query Tool - Natural Language Cluster Intelligence
+ *
+ * Provides natural language query interface to discover and understand
+ * cluster capabilities and resources.
+ *
+ * PRD #291: Cluster Query Tool - Natural Language Cluster Intelligence
+ */
+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.QUERY_TOOL_INPUT_SCHEMA = exports.QUERY_TOOL_DESCRIPTION = exports.QUERY_TOOL_NAME = void 0;
+exports.handleQueryTool = handleQueryTool;
+const zod_1 = require("zod");
+const error_handling_1 = require("../core/error-handling");
+const ai_provider_factory_1 = require("../core/ai-provider-factory");
+const capability_tools_1 = require("../core/capability-tools");
+const resource_tools_1 = require("../core/resource-tools");
+const kubectl_tools_1 = require("../core/kubectl-tools");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// Tool metadata for MCP registration
+exports.QUERY_TOOL_NAME = 'query';
+exports.QUERY_TOOL_DESCRIPTION = 'Natural language query interface for Kubernetes cluster intelligence. Ask any questions about your cluster resources, capabilities, and status in plain English. Examples: "What databases are running?", "Describe the nginx deployment", "Show me pods in the kube-system namespace", "What operators are installed?", "Is my-postgres healthy?"';
+// Zod schema for MCP registration
+exports.QUERY_TOOL_INPUT_SCHEMA = {
+    intent: zod_1.z.string().min(1).max(1000).describe('Natural language query about the cluster'),
+    interaction_id: zod_1.z.string().optional().describe('INTERNAL ONLY - Do not populate. Used for evaluation dataset generation.')
+};
+/**
+ * Parse the AI's final JSON response for summary only
+ */
+function parseSummary(aiResponse) {
+    try {
+        // Find JSON in the response
+        const firstBraceIndex = aiResponse.indexOf('{');
+        if (firstBraceIndex === -1) {
+            // No JSON found, use the response as summary
+            return aiResponse.trim() || 'No summary provided';
+        }
+        // Track brace depth to find complete JSON object
+        let braceCount = 0;
+        let inString = false;
+        let escapeNext = false;
+        let jsonEndIndex = -1;
+        for (let i = firstBraceIndex; i < aiResponse.length; i++) {
+            const char = aiResponse[i];
+            if (escapeNext) {
+                escapeNext = false;
+                continue;
+            }
+            if (char === '\\') {
+                escapeNext = true;
+                continue;
+            }
+            if (char === '"') {
+                inString = !inString;
+                continue;
+            }
+            if (inString)
+                continue;
+            if (char === '{')
+                braceCount++;
+            if (char === '}') {
+                braceCount--;
+                if (braceCount === 0) {
+                    jsonEndIndex = i + 1;
+                    break;
+                }
+            }
+        }
+        if (jsonEndIndex === -1) {
+            return aiResponse.trim() || 'No summary provided';
+        }
+        const jsonString = aiResponse.substring(firstBraceIndex, jsonEndIndex);
+        const parsed = JSON.parse(jsonString);
+        return parsed.summary || 'No summary provided';
+    }
+    catch (error) {
+        // If parsing fails, use the raw response as summary
+        return aiResponse.trim() || 'No summary provided';
+    }
+}
+/**
+ * Main query tool handler
+ */
+async function handleQueryTool(args) {
+    const requestId = `query_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+    const logger = new error_handling_1.ConsoleLogger('QueryTool');
+    try {
+        // Validate input
+        const intent = args.intent;
+        if (!intent || typeof intent !== 'string') {
+            throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.VALIDATION, error_handling_1.ErrorSeverity.MEDIUM, 'Intent is required and must be a string', { operation: 'input_validation', component: 'QueryTool' });
+        }
+        logger.info('Processing query', { requestId, intent });
+        // Initialize AI provider
+        const aiProvider = (0, ai_provider_factory_1.createAIProvider)();
+        // Load system prompt
+        const promptPath = path.join(__dirname, '..', '..', 'prompts', 'query-system.md');
+        const systemPrompt = fs.readFileSync(promptPath, 'utf8');
+        // Combined tool executor for capability, resource, and kubectl tools
+        const executeQueryTools = async (toolName, input) => {
+            // Route to appropriate executor based on tool name
+            if (toolName.startsWith('search_capabilities') || toolName.startsWith('query_capabilities')) {
+                return (0, capability_tools_1.executeCapabilityTools)(toolName, input);
+            }
+            if (toolName.startsWith('search_resources') || toolName.startsWith('query_resources')) {
+                return (0, resource_tools_1.executeResourceTools)(toolName, input);
+            }
+            if (toolName.startsWith('kubectl_')) {
+                return (0, kubectl_tools_1.executeKubectlTools)(toolName, input);
+            }
+            return {
+                success: false,
+                error: `Unknown tool: ${toolName}`,
+                message: `Tool '${toolName}' is not implemented in query tool`
+            };
+        };
+        // Read-only kubectl tools for live cluster queries
+        const KUBECTL_READONLY_TOOLS = [
+            kubectl_tools_1.KUBECTL_API_RESOURCES_TOOL,
+            kubectl_tools_1.KUBECTL_GET_TOOL,
+            kubectl_tools_1.KUBECTL_DESCRIBE_TOOL,
+            kubectl_tools_1.KUBECTL_LOGS_TOOL,
+            kubectl_tools_1.KUBECTL_EVENTS_TOOL,
+            kubectl_tools_1.KUBECTL_GET_CRD_SCHEMA_TOOL
+        ];
+        // Execute tool loop with capability, resource, and kubectl tools
+        const result = await aiProvider.toolLoop({
+            systemPrompt,
+            userMessage: intent,
+            tools: [...capability_tools_1.CAPABILITY_TOOLS, ...resource_tools_1.RESOURCE_TOOLS, ...KUBECTL_READONLY_TOOLS],
+            toolExecutor: executeQueryTools,
+            maxIterations: 10,
+            operation: 'query',
+            evaluationContext: {
+                user_intent: intent
+            },
+            interaction_id: args.interaction_id
+        });
+        // Extract data from execution record (reliable, not AI self-reporting)
+        const toolsUsed = [...new Set(result.toolCallsExecuted.map(tc => tc.tool))];
+        const summary = parseSummary(result.finalMessage);
+        logger.info('Query completed', {
+            requestId,
+            iterations: result.iterations,
+            toolsUsed
+        });
+        const output = {
+            success: true,
+            summary,
+            toolsUsed,
+            iterations: result.iterations
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2)
+                }
+            ]
+        };
+    }
+    catch (error) {
+        logger.error('Query failed', error, { requestId });
+        if (error instanceof Error && 'category' in error) {
+            throw error;
+        }
+        throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.UNKNOWN, error_handling_1.ErrorSeverity.HIGH, `Query tool failed: ${error instanceof Error ? error.message : 'Unknown error'}`, {
+            operation: 'query_tool_execution',
+            component: 'QueryTool',
+            requestId,
+            input: { intent: args.intent }
+        });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.173.0",
+  "version": "0.175.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",

package/prompts/query-system.md

@@ -0,0 +1,15 @@
+# Kubernetes Cluster Query Agent
+
+You are a Kubernetes cluster analyst. Use the available tools to answer the user's query.
+
+## Output Format
+
+When you have gathered sufficient information, respond with ONLY this JSON:
+
+```json
+{
+  "summary": "Human-readable summary of what was found"
+}
+```
+
+No text before or after the JSON.

package/scripts/crossplane.nu

@@ -38,15 +38,13 @@ def --env "main apply crossplane" [
         setup aws
     } else if $provider == "azure" {
         setup azure --skip-login $skip_login
-    } else if $provider == "upcloud" {
-        setup upcloud
     }
 
     if $app_config {
 
         print $"\n(ansi green_bold)Applying `dot-application` Configuration...(ansi reset)\n"
 
-        let version = "v3.0.31"
+        let version = "v3.0.46"
         {
             apiVersion: "pkg.crossplane.io/v1"
             kind: "Configuration"
@@ -99,7 +97,7 @@ def --env "main apply crossplane" [
     if ($db_config or $db_provider) and $provider == "google" {
 
         start $"https://console.cloud.google.com/marketplace/product/google/sqladmin.googleapis.com?project=($provider_data.project_id)"
-        
+
         print $"\n(ansi yellow_bold)ENABLE(ansi reset) the API.\nPress the (ansi yellow_bold)enter key(ansi reset) to continue.\n"
         input
 
@@ -109,7 +107,7 @@ def --env "main apply crossplane" [
 
         print $"\n(ansi green_bold)Applying `dot-sql` Configuration...(ansi reset)\n"
 
-        let version = "v2.1.83"
+        let version = "v2.2.11"
         {
             apiVersion: "pkg.crossplane.io/v1"
             kind: "Configuration"
@@ -120,7 +118,7 @@ def --env "main apply crossplane" [
     } else if $db_provider {
 
         apply db-provider $provider
-        
+
     }
 
     if $github_config {
@@ -155,7 +153,7 @@ def --env "main apply crossplane" [
                 verbs: ["*"]
             }]
         } | to yaml | kubectl apply --filename -
-    
+
 
         {
             apiVersion: "v1"
@@ -325,12 +323,12 @@ def "main delete crossplane" [
     --namespace: string
 ] {
 
-    if ($kind | is-not-empty) and ($name | is-not-empty) and ($namespace | is-not-empty) { 
+    if ($kind | is-not-empty) and ($name | is-not-empty) and ($namespace | is-not-empty) {
         kubectl --namespace $namespace delete $kind $name
     }
 
     print $"\nWaiting for (ansi green_bold)Crossplane managed resources(ansi reset) to be deleted...\n"
-    
+
     mut command = { kubectl get managed --output name }
     if ($name | is-not-empty) {
         $command = {
@@ -435,7 +433,7 @@ def "apply providerconfig" [
                 }
             }
         } | to yaml | kubectl apply --filename -
-    
+
     } else if $provider == "azure" {
 
         {
@@ -454,24 +452,6 @@ def "apply providerconfig" [
             }
         } | to yaml | kubectl apply --filename -
 
-    } else if $provider == "upcloud" {
-
-        {
-            apiVersion: "provider.upcloud.com/v1beta1"
-            kind: "ProviderConfig"
-            metadata: { name: default }
-            spec: {
-                credentials: {
-                    source: "Secret"
-                    secretRef: {
-                        namespace: "crossplane-system"
-                        name: "upcloud-creds"
-                        key: "creds"
-                    }
-                }
-            }
-        } | to yaml | kubectl apply --filename -
-
     }
 
 }
@@ -658,33 +638,3 @@ def "setup azure" [
     )
 
 }
-
-def "setup upcloud" [] {
-
-    print $"\nInstalling (ansi green_bold)Crossplane UpCloud Provider(ansi reset)...\n"
-
-    if UPCLOUD_USERNAME not-in $env {
-        $env.UPCLOUD_USERNAME = input $"(ansi yellow_bold)UpCloud Username: (ansi reset)"
-    }
-    $"export UPCLOUD_USERNAME=($env.UPCLOUD_USERNAME)\n"
-        | save --append .env
-
-    if UPCLOUD_PASSWORD not-in $env {
-        $env.UPCLOUD_PASSWORD = input $"(ansi yellow_bold)UpCloud Password: (ansi reset)"
-    }
-    $"export UPCLOUD_PASSWORD=($env.UPCLOUD_PASSWORD)\n"
-        | save --append .env
-
-    {
-        apiVersion: "v1"
-        kind: "Secret"
-        metadata: {
-            name: "upcloud-creds"
-        }
-        type: "Opaque"
-        stringData: {
-            creds: $"{\"username\": \"($env.UPCLOUD_USERNAME)\", \"password\": \"($env.UPCLOUD_PASSWORD)\"}"
-        }
-    } | to yaml | kubectl --namespace crossplane-system apply --filename -
-
-}

package/scripts/dot-ai.nu

@@ -1,5 +1,25 @@
 #!/usr/bin/env nu
 
+# Installs DevOps AI Controller
+#
+# Examples:
+# > main apply dot-ai-controller
+# > main apply dot-ai-controller --controller-version 0.17.0
+def "main apply dot-ai-controller" [
+    --controller-version = "0.37.0"
+] {
+
+    (
+        helm upgrade --install dot-ai-controller
+            $"oci://ghcr.io/vfarcic/dot-ai-controller/charts/dot-ai-controller:($controller_version)"
+            --namespace dot-ai --create-namespace
+            --wait
+    )
+
+    print $"DevOps AI Controller (ansi yellow_bold)($controller_version)(ansi reset) installed in (ansi yellow_bold)dot-ai(ansi reset) namespace"
+
+}
+
 # Installs DevOps AI Toolkit with MCP server support and controller
 #
 # Examples:
@@ -14,8 +34,8 @@ def "main apply dot-ai" [
     --ingress-enabled = true,
     --ingress-class = "nginx",
     --host = "dot-ai.127.0.0.1.nip.io",
-    --version = "0.140.0",
-    --controller-version = "0.16.0",
+    --version = "0.171.0",
+    --controller-version = "0.37.0",
     --enable-tracing = false
 ] {
 
@@ -44,12 +64,7 @@ def "main apply dot-ai" [
         []
     }
 
-    (
-        helm upgrade --install dot-ai-controller
-            $"oci://ghcr.io/vfarcic/dot-ai-controller/charts/dot-ai-controller:($controller_version)"
-            --namespace dot-ai --create-namespace
-            --wait
-    )
+    main apply dot-ai-controller --controller-version $controller_version
 
     (
         helm upgrade --install dot-ai-mcp
@@ -67,7 +82,6 @@ def "main apply dot-ai" [
             --wait
     )
 
-    print $"DevOps AI Controller (ansi yellow_bold)($controller_version)(ansi reset) installed in (ansi yellow_bold)dot-ai(ansi reset) namespace"
     print $"DevOps AI Toolkit is available at (ansi yellow_bold)http://($host)(ansi reset)"
 
     if $enable_tracing {

package/shared-prompts/prd-create.md

@@ -34,12 +34,16 @@ Work through the PRD template focusing on project management, milestone tracking
 
 **Key Principle**: Focus on 5-10 major milestones rather than exhaustive task lists. Each milestone should represent meaningful progress that can be clearly validated.
 
+**Consider Including** (when applicable to the project/feature):
+- **Tests** - If the project has tests, include a milestone for test coverage of new functionality
+- **Documentation** - If the feature is user-facing, include a milestone for docs following existing project patterns
+
 **Good Milestones Examples:**
 - [ ] Core functionality implemented and working
-- [ ] Documentation complete and tested
+- [ ] Tests passing for new functionality (if project has test suite)
+- [ ] Documentation complete following existing patterns (if user-facing feature)
 - [ ] Integration with existing systems working
 - [ ] Feature ready for user testing
-- [ ] Feature launched and available
 
 **Avoid Micro-Tasks:**
 - ❌ Update README.md file

package/shared-prompts/prd-start.md

@@ -2,6 +2,10 @@
 name: prd-start
 description: Start working on a PRD implementation
 category: project-management
+arguments:
+  - name: prdNumber
+    description: PRD number to start working on (e.g., 306)
+    required: false
 ---
 
 # PRD Start - Begin Implementation Work
@@ -20,9 +24,19 @@ You are helping initiate active implementation work on a specific Product Requir
 4. **Identify Starting Point** - Determine the best first implementation task
 5. **Begin Implementation** - Launch into actual development work
 
-## Step 0: Context Awareness Check
+## Step 0: Check for PRD Argument
 
-**FIRST: Check if PRD context is already clear from recent conversation:**
+**If `prdNumber` argument is provided ({{prdNumber}}):**
+- Skip Step 0 context check and Step 1 auto-detection
+- Use PRD #{{prdNumber}} directly
+- Proceed to Step 2 (PRD Readiness Validation)
+
+**If `prdNumber` argument is NOT provided:**
+- Continue to context awareness check below
+
+## Step 0b: Context Awareness Check
+
+**Check if PRD context is already clear from recent conversation:**
 
 **Skip detection/analysis if recent conversation shows:**
 - **Recent PRD work discussed** - "We just worked on PRD 29", "Just completed PRD update", etc.
@@ -31,7 +45,7 @@ You are helping initiate active implementation work on a specific Product Requir
 - **Clear work context** - Discussion of specific features, tasks, or requirements for a known PRD
 
 **If context is clear:**
-- Skip to Step 2 (PRD Readiness Validation) using the known PRD 
+- Skip to Step 2 (PRD Readiness Validation) using the known PRD
 - Use conversation history to understand current state and recent progress
 - Proceed directly with readiness validation based on known PRD status