@vfarcic/dot-ai 0.195.0 → 1.0.0

package/prompts/helm-generation.md

@@ -41,6 +41,12 @@ Generate a values.yaml file for Helm chart installation based on the user's conf
    - Strings: use quotes only when necessary (values with special chars)
    - Arrays/Lists: proper YAML list format
    - Nested objects: proper YAML indentation
+   - **Enum/constrained values**: Many charts define fields with limited valid values
+     * Look for comments like "# Valid values: 'soft', 'hard', ''" or "# Options: ClusterIP, NodePort, LoadBalancer"
+     * Look for fields with empty string defaults like `podAntiAffinity: ""` - these often have schema constraints
+     * Common constrained fields: `podAntiAffinity` (soft/hard/""), `service.type`, `pullPolicy`, `strategy.type`
+     * ONLY use values explicitly listed as valid in the chart's values.yaml or comments
+     * When in doubt, use the default value from the chart rather than inventing a value
 
 4. **Include Only Values That Differ From Defaults**:
    - Compare each user answer to the chart's default values above
@@ -62,6 +68,9 @@ If this is a retry (previous attempt and error details provided above):
   * Non-existent value path in the chart
   * Invalid YAML syntax
   * Template rendering errors from invalid combinations
+  * **Schema validation errors** - "value must be one of X, Y, Z" means you used an invalid enum value
+    - For schema errors, check the chart's values.yaml comments for valid options
+    - Use the exact valid value from the error message (e.g., if error says "must be one of '', 'soft', 'hard'", use one of those exact values)
 - Make targeted corrections to fix the identified issues
 
 ### Response Requirements:

package/dist/core/cluster-utils.d.ts

@@ -1,12 +0,0 @@
-/**
- * Cluster Connection Utilities
- *
- * Provides reusable functions for lazy cluster connectivity checking
- */
-import { Logger } from './error-handling';
-import { DotAI } from './index';
-/**
- * Ensures cluster connectivity and throws proper MCP-compatible errors
- */
-export declare function ensureClusterConnection(dotAI: DotAI, logger: Logger, requestId: string, component: string): Promise<void>;
-//# sourceMappingURL=cluster-utils.d.ts.map

package/dist/core/cluster-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cluster-utils.d.ts","sourceRoot":"","sources":["../../src/core/cluster-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA8C,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/core/cluster-utils.js

@@ -1,27 +0,0 @@
-"use strict";
-/**
- * Cluster Connection Utilities
- *
- * Provides reusable functions for lazy cluster connectivity checking
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureClusterConnection = ensureClusterConnection;
-const error_handling_1 = require("./error-handling");
-/**
- * Ensures cluster connectivity and throws proper MCP-compatible errors
- */
-async function ensureClusterConnection(dotAI, logger, requestId, component) {
-    logger.debug('Checking cluster connectivity', { requestId, component });
-    try {
-        await dotAI.discovery.connect();
-        logger.debug('Cluster connectivity verified', { requestId, component });
-    }
-    catch (clusterError) {
-        const errorMessage = clusterError instanceof Error ? clusterError.message : String(clusterError);
-        throw error_handling_1.ErrorHandler.createError(error_handling_1.ErrorCategory.KUBERNETES, error_handling_1.ErrorSeverity.HIGH, `Cluster connection failed: ${errorMessage}\n\nTroubleshooting:\n- Check KUBECONFIG environment variable\n- Verify cluster is running: kubectl cluster-info\n- Test kubectl connectivity: kubectl get nodes\n- Ensure cluster is accessible from this environment`, {
-            operation: 'cluster_connectivity_check',
-            component,
-            requestId
-        }, clusterError instanceof Error ? clusterError : new Error(String(clusterError)));
-    }
-}

package/dist/core/helm-utils.d.ts

@@ -1,66 +0,0 @@
-/**
- * Helm Utilities - Shared functions for Helm chart operations
- */
-import { HelmChartInfo } from './helm-types';
-/**
- * Sanitize input for safe shell command usage.
- * Validates that input contains only safe characters to prevent command injection.
- * @throws Error if input contains potentially dangerous characters
- */
-export declare function sanitizeShellArg(arg: string, fieldName?: string): string;
-/**
- * Validate and sanitize HelmChartInfo for safe shell command usage
- */
-export declare function sanitizeChartInfo(chart: HelmChartInfo): {
-    repositoryName: string;
-    repository: string;
-    chartName: string;
-    version?: string;
-};
-/**
- * Build the Helm command from chart info and deployment options
- */
-export declare function buildHelmCommand(chart: HelmChartInfo, releaseName: string, namespace: string, valuesPath?: string): string;
-/**
- * Ensure Helm repository is added and updated
- */
-export declare function ensureHelmRepo(chart: HelmChartInfo): Promise<void>;
-/**
- * Execute a Helm command with proper error handling
- */
-export declare function executeHelmCommand(command: string, options?: {
-    timeout?: number;
-    maxBuffer?: number;
-}): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-/**
- * Get the path for Helm values file
- */
-export declare function getHelmValuesPath(solutionId: string): string;
-/**
- * Check if Helm values file exists for a solution
- */
-export declare function helmValuesExist(solutionId: string): boolean;
-/**
- * Ensure tmp directory exists
- */
-export declare function ensureTmpDir(): string;
-/**
- * Result of Helm command execution
- */
-export interface HelmExecutionResult {
-    success: boolean;
-    output: string;
-    error?: string;
-}
-/**
- * Run Helm dry-run validation
- */
-export declare function validateHelmDryRun(chart: HelmChartInfo, releaseName: string, namespace: string, valuesPath: string): Promise<HelmExecutionResult>;
-/**
- * Deploy a Helm chart
- */
-export declare function deployHelmRelease(chart: HelmChartInfo, releaseName: string, namespace: string, valuesPath: string | undefined, timeout: number): Promise<HelmExecutionResult>;
-//# sourceMappingURL=helm-utils.d.ts.map

package/dist/core/helm-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"helm-utils.d.ts","sourceRoot":"","sources":["../../src/core/helm-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAmB,GAAG,MAAM,CAOpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAOA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAO7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CA6B9B"}

package/dist/core/helm-utils.js

@@ -1,196 +0,0 @@
-"use strict";
-/**
- * Helm Utilities - Shared functions for Helm chart operations
- */
-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.sanitizeShellArg = sanitizeShellArg;
-exports.sanitizeChartInfo = sanitizeChartInfo;
-exports.buildHelmCommand = buildHelmCommand;
-exports.ensureHelmRepo = ensureHelmRepo;
-exports.executeHelmCommand = executeHelmCommand;
-exports.getHelmValuesPath = getHelmValuesPath;
-exports.helmValuesExist = helmValuesExist;
-exports.ensureTmpDir = ensureTmpDir;
-exports.validateHelmDryRun = validateHelmDryRun;
-exports.deployHelmRelease = deployHelmRelease;
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs"));
-const platform_utils_1 = require("./platform-utils");
-/**
- * Sanitize input for safe shell command usage.
- * Validates that input contains only safe characters to prevent command injection.
- * @throws Error if input contains potentially dangerous characters
- */
-function sanitizeShellArg(arg, fieldName = 'argument') {
-    // Allow alphanumeric, dash, underscore, dot, forward slash, colon (for URLs), and @ (for versions)
-    // This covers valid Helm chart names, repo names, URLs, and version strings
-    if (!/^[a-zA-Z0-9\-_./:\\@]+$/.test(arg)) {
-        throw new Error(`Invalid characters in ${fieldName}: "${arg}". Only alphanumeric characters, dashes, underscores, dots, forward slashes, colons, and @ are allowed.`);
-    }
-    return arg;
-}
-/**
- * Validate and sanitize HelmChartInfo for safe shell command usage
- */
-function sanitizeChartInfo(chart) {
-    return {
-        repositoryName: sanitizeShellArg(chart.repositoryName, 'repository name'),
-        repository: sanitizeShellArg(chart.repository, 'repository URL'),
-        chartName: sanitizeShellArg(chart.chartName, 'chart name'),
-        version: chart.version ? sanitizeShellArg(chart.version, 'version') : undefined
-    };
-}
-/**
- * Build the Helm command from chart info and deployment options
- */
-function buildHelmCommand(chart, releaseName, namespace, valuesPath) {
-    // Sanitize all inputs to prevent command injection
-    const safeChart = sanitizeChartInfo(chart);
-    const safeReleaseName = sanitizeShellArg(releaseName, 'release name');
-    const safeNamespace = sanitizeShellArg(namespace, 'namespace');
-    const parts = [
-        'helm upgrade --install',
-        safeReleaseName,
-        `${safeChart.repositoryName}/${safeChart.chartName}`,
-        `--namespace ${safeNamespace}`,
-        '--create-namespace'
-    ];
-    if (safeChart.version) {
-        parts.push(`--version ${safeChart.version}`);
-    }
-    if (valuesPath) {
-        // Values path is internally generated, but sanitize anyway
-        parts.push(`-f ${sanitizeShellArg(valuesPath, 'values path')}`);
-    }
-    return parts.join(' ');
-}
-/**
- * Ensure Helm repository is added and updated
- */
-async function ensureHelmRepo(chart) {
-    // Sanitize chart info to prevent command injection
-    const safeChart = sanitizeChartInfo(chart);
-    await (0, platform_utils_1.execAsync)(`helm repo add ${safeChart.repositoryName} ${safeChart.repository} 2>/dev/null || true`);
-    await (0, platform_utils_1.execAsync)('helm repo update 2>/dev/null || true');
-}
-/**
- * Execute a Helm command with proper error handling
- */
-async function executeHelmCommand(command, options) {
-    const execOptions = {
-        maxBuffer: options?.maxBuffer || 10 * 1024 * 1024,
-        timeout: options?.timeout
-    };
-    return await (0, platform_utils_1.execAsync)(command, execOptions);
-}
-/**
- * Get the path for Helm values file
- */
-function getHelmValuesPath(solutionId) {
-    const tmpDir = path.join(process.cwd(), 'tmp');
-    return path.join(tmpDir, `${solutionId}-values.yaml`);
-}
-/**
- * Check if Helm values file exists for a solution
- */
-function helmValuesExist(solutionId) {
-    return fs.existsSync(getHelmValuesPath(solutionId));
-}
-/**
- * Ensure tmp directory exists
- */
-function ensureTmpDir() {
-    const tmpDir = path.join(process.cwd(), 'tmp');
-    if (!fs.existsSync(tmpDir)) {
-        fs.mkdirSync(tmpDir, { recursive: true });
-    }
-    return tmpDir;
-}
-/**
- * Run Helm dry-run validation
- */
-async function validateHelmDryRun(chart, releaseName, namespace, valuesPath) {
-    try {
-        await ensureHelmRepo(chart);
-        const dryRunCommand = buildHelmCommand(chart, releaseName, namespace, valuesPath) + ' --dry-run';
-        const { stdout, stderr } = await executeHelmCommand(dryRunCommand);
-        return {
-            success: true,
-            output: stdout + (stderr ? `\n${stderr}` : '')
-        };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        let cleanError = errorMessage;
-        if (error instanceof Error && 'stderr' in error) {
-            cleanError = error.stderr || errorMessage;
-        }
-        return {
-            success: false,
-            output: '',
-            error: cleanError
-        };
-    }
-}
-/**
- * Deploy a Helm chart
- */
-async function deployHelmRelease(chart, releaseName, namespace, valuesPath, timeout) {
-    try {
-        await ensureHelmRepo(chart);
-        const helmCommand = buildHelmCommand(chart, releaseName, namespace, valuesPath) +
-            ` --timeout ${timeout}s --wait`;
-        const { stdout, stderr } = await executeHelmCommand(helmCommand, {
-            timeout: (timeout + 30) * 1000 // Add buffer for command overhead
-        });
-        return {
-            success: true,
-            output: stdout + (stderr ? `\n\nStderr:\n${stderr}` : '')
-        };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        let cleanError = errorMessage;
-        if (error instanceof Error && 'stderr' in error) {
-            cleanError = error.stderr || errorMessage;
-        }
-        return {
-            success: false,
-            output: '',
-            error: cleanError
-        };
-    }
-}

package/dist/core/kubectl-tools.d.ts

@@ -1,71 +0,0 @@
-/**
- * Kubectl Tools for AI-Powered Investigation
- *
- * Shared tool definitions and executor for kubectl operations.
- * Used by remediation, diagnostics, and other investigation workflows.
- *
- * PRD #143: Tool-Based Remediation with Observability Data Sources
- */
-import { AITool } from './ai-provider.interface';
-/**
- * Tool: kubectl_api_resources
- * Get list of all available Kubernetes API resources in the cluster
- */
-export declare const KUBECTL_API_RESOURCES_TOOL: AITool;
-/**
- * Tool: kubectl_get
- * Get Kubernetes resources with their current state
- */
-export declare const KUBECTL_GET_TOOL: AITool;
-/**
- * Tool: kubectl_describe
- * Get detailed information about Kubernetes resources
- */
-export declare const KUBECTL_DESCRIBE_TOOL: AITool;
-/**
- * Tool: kubectl_logs
- * Get container logs from pods
- */
-export declare const KUBECTL_LOGS_TOOL: AITool;
-/**
- * Tool: kubectl_events
- * Get Kubernetes events for troubleshooting
- */
-export declare const KUBECTL_EVENTS_TOOL: AITool;
-/**
- * Tool: kubectl_patch_dryrun
- * Validate patch commands with dry-run before execution
- */
-export declare const KUBECTL_PATCH_DRYRUN_TOOL: AITool;
-/**
- * Tool: kubectl_apply_dryrun
- * Validate apply commands with dry-run before execution
- */
-export declare const KUBECTL_APPLY_DRYRUN_TOOL: AITool;
-/**
- * Tool: kubectl_delete_dryrun
- * Validate delete commands with dry-run before execution
- */
-export declare const KUBECTL_DELETE_DRYRUN_TOOL: AITool;
-/**
- * Tool: kubectl_get_crd_schema
- * Get the OpenAPI v3 schema for a Custom Resource Definition
- */
-export declare const KUBECTL_GET_CRD_SCHEMA_TOOL: AITool;
-/**
- * Tool: kubectl_get_resource_json
- * Get a single Kubernetes resource as structured JSON
- */
-export declare const KUBECTL_GET_RESOURCE_JSON_TOOL: AITool;
-/**
- * Tool executor for kubectl-based tools
- * Handles execution and error handling for all kubectl tool calls
- */
-export declare function executeKubectlTools(toolName: string, input: any): Promise<any>;
-/**
- * All kubectl investigation tools (read-only operations + dry-run validation)
- * Used during investigation phase for gathering cluster state information and validating solutions
- * Convenient array for passing to toolLoop()
- */
-export declare const KUBECTL_INVESTIGATION_TOOLS: AITool[];
-//# sourceMappingURL=kubectl-tools.d.ts.map

package/dist/core/kubectl-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kubectl-tools.d.ts","sourceRoot":"","sources":["../../src/core/kubectl-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAIjD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAQxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAsB9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAiBnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAsB/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAkBjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAyBvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAiBvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAiBxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAazC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAqB5C,CAAC;AAEF;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CA0UpF;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAW/C,CAAC"}