@vfarcic/dot-ai 0.151.0 → 0.153.0

package/README.md

@@ -57,7 +57,7 @@ DevOps AI Toolkit democratizes platform engineering and cloud native operations
 ## Key Features
 
 ### 🔍 Resource Provisioning Intelligence
-Automatically discovers cluster resources using semantic capability management. AI understands what each resource actually does, providing intelligent recommendations for provisioning resources across clouds using Kubernetes as a control plane.
+Automatically discovers cluster resources using semantic capability management. AI understands what each resource actually does, providing intelligent recommendations for provisioning resources across clouds using Kubernetes as a control plane. When no matching capability exists, automatically discovers and installs third-party tools (Prometheus, Argo CD, Crossplane, etc.) via Helm charts from ArtifactHub.
 📖 [Deployment Guide](./docs/mcp-recommendation-guide.md) | [Capability Management](./docs/mcp-capability-management-guide.md)
 
 ### 🛠️ Issue Remediation

package/dist/core/artifacthub.d.ts

@@ -0,0 +1,85 @@
+/**
+ * ArtifactHub API Client
+ *
+ * Handles searching and retrieving Helm chart information from ArtifactHub
+ * API Documentation: https://artifacthub.io/docs/api/
+ */
+/**
+ * Raw search result from ArtifactHub API
+ */
+export interface ArtifactHubSearchResult {
+    package_id: string;
+    name: string;
+    normalized_name: string;
+    logo_image_id?: string;
+    stars: number;
+    official: boolean;
+    verified_publisher: boolean;
+    repository: {
+        name: string;
+        url: string;
+        official: boolean;
+        verified_publisher: boolean;
+    };
+    version: string;
+    app_version?: string;
+    description: string;
+}
+/**
+ * Raw package details from ArtifactHub API
+ */
+export interface ArtifactHubPackageDetails {
+    package_id: string;
+    name: string;
+    normalized_name: string;
+    version: string;
+    app_version?: string;
+    description: string;
+    readme?: string;
+    values_schema?: Record<string, any>;
+    default_values?: string;
+    repository: {
+        name: string;
+        url: string;
+    };
+    maintainers?: Array<{
+        name: string;
+        email?: string;
+    }>;
+    links?: Array<{
+        name: string;
+        url: string;
+    }>;
+}
+/**
+ * ArtifactHub API client for Helm chart discovery
+ */
+export declare class ArtifactHubService {
+    private baseUrl;
+    private timeout;
+    private excludedRepos;
+    /**
+     * Search for Helm charts matching the query
+     *
+     * @param query - Search query (e.g., "argo cd", "prometheus")
+     * @param limit - Maximum number of results to return
+     * @returns Array of search results sorted by relevance (excludes Bitnami)
+     */
+    searchCharts(query: string, limit?: number): Promise<ArtifactHubSearchResult[]>;
+    /**
+     * Get detailed information about a specific chart
+     *
+     * @param repoName - Repository name (e.g., "argo")
+     * @param chartName - Chart name (e.g., "argo-cd")
+     * @returns Detailed chart information including README and values schema
+     */
+    getChartDetails(repoName: string, chartName: string): Promise<ArtifactHubPackageDetails>;
+    /**
+     * Format chart results for AI analysis prompt
+     *
+     * @param charts - Array of ArtifactHub search results
+     * @returns Formatted string for AI prompt
+     */
+    formatChartsForAI(charts: ArtifactHubSearchResult[]): string;
+}
+//# sourceMappingURL=artifacthub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifacthub.d.ts","sourceRoot":"","sources":["../../src/core/artifacthub.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,OAAO,CAAC;QAClB,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,OAAO,CAAS;IAIxB,OAAO,CAAC,aAAa,CAAe;IAEpC;;;;;;OAMG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAsCzF;;;;;;OAMG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA8B9F;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM;CAW7D"}

package/dist/core/artifacthub.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * ArtifactHub API Client
+ *
+ * Handles searching and retrieving Helm chart information from ArtifactHub
+ * API Documentation: https://artifacthub.io/docs/api/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArtifactHubService = void 0;
+/**
+ * ArtifactHub API client for Helm chart discovery
+ */
+class ArtifactHubService {
+    baseUrl = 'https://artifacthub.io/api/v1';
+    timeout = 10000; // 10 seconds
+    // Repositories to exclude from search results
+    // Bitnami charts often have non-standard configurations
+    excludedRepos = ['bitnami'];
+    /**
+     * Search for Helm charts matching the query
+     *
+     * @param query - Search query (e.g., "argo cd", "prometheus")
+     * @param limit - Maximum number of results to return
+     * @returns Array of search results sorted by relevance (excludes Bitnami)
+     */
+    async searchCharts(query, limit = 10) {
+        const encodedQuery = encodeURIComponent(query);
+        // kind=0 filters for Helm charts only
+        const url = `${this.baseUrl}/packages/search?ts_query_web=${encodedQuery}&kind=0&limit=${limit}`;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Accept': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`ArtifactHub API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            // Filter out excluded repositories (e.g., Bitnami)
+            const packages = data.packages || [];
+            return packages.filter(pkg => !this.excludedRepos.includes(pkg.repository.name.toLowerCase()));
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`ArtifactHub API timeout after ${this.timeout}ms`);
+            }
+            throw new Error(`ArtifactHub search failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get detailed information about a specific chart
+     *
+     * @param repoName - Repository name (e.g., "argo")
+     * @param chartName - Chart name (e.g., "argo-cd")
+     * @returns Detailed chart information including README and values schema
+     */
+    async getChartDetails(repoName, chartName) {
+        const url = `${this.baseUrl}/packages/helm/${repoName}/${chartName}`;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Accept': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`ArtifactHub API error: ${response.status} ${response.statusText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`ArtifactHub API timeout after ${this.timeout}ms`);
+            }
+            throw new Error(`ArtifactHub chart details failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Format chart results for AI analysis prompt
+     *
+     * @param charts - Array of ArtifactHub search results
+     * @returns Formatted string for AI prompt
+     */
+    formatChartsForAI(charts) {
+        return charts.map((chart, index) => `
+Chart ${index + 1}: ${chart.name}
+  Repository: ${chart.repository.name} (${chart.repository.url})
+  Version: ${chart.version}${chart.app_version ? ` (App: ${chart.app_version})` : ''}
+  Description: ${chart.description || 'No description'}
+  Official: ${chart.official || chart.repository.official ? 'Yes' : 'No'}
+  Verified Publisher: ${chart.verified_publisher || chart.repository.verified_publisher ? 'Yes' : 'No'}
+  Stars: ${chart.stars}
+`).join('\n');
+    }
+}
+exports.ArtifactHubService = ArtifactHubService;

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

@@ -0,0 +1,39 @@
+/**
+ * Type definitions for Helm-based solutions and sessions
+ */
+/**
+ * Helm chart information from ArtifactHub
+ */
+export interface HelmChartInfo {
+    repository: string;
+    repositoryName: string;
+    chartName: string;
+    version?: string;
+    appVersion?: string;
+    official?: boolean;
+    verifiedPublisher?: boolean;
+}
+/**
+ * Solution data for Helm-based installations
+ * Stored in sol-* sessions alongside capability-based solutions
+ */
+export interface HelmSolutionData {
+    intent: string;
+    type: 'helm';
+    chart: HelmChartInfo;
+    score: number;
+    description: string;
+    reasons: string[];
+    questions?: {
+        required?: any[];
+        basic?: any[];
+        advanced?: any[];
+    };
+    answers: Record<string, any>;
+    generatedValues?: Record<string, any>;
+    helmCommand?: string;
+    namespace?: string;
+    releaseName?: string;
+    timestamp: string;
+}
+//# sourceMappingURL=helm-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helm-types.d.ts","sourceRoot":"","sources":["../../src/core/helm-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;QACd,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;KAClB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/core/helm-types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Type definitions for Helm-based solutions and sessions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,66 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,196 @@
+"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/index.d.ts

@@ -7,7 +7,8 @@ import { KubernetesDiscovery } from './discovery';
 import { MemorySystem } from './memory';
 import { WorkflowEngine } from './workflow';
 import { AIProvider } from './ai-provider.interface';
-import { SchemaParser, ManifestValidator, ResourceRecommender } from './schema';
+import { SchemaParser, ManifestValidator, ResourceRecommender, QuestionGroup } from './schema';
+import { HelmChartInfo } from './helm-types';
 export interface CoreConfig {
     kubernetesConfig?: string;
 }
@@ -24,6 +25,11 @@ export declare class DotAI {
         ranker: ResourceRecommender | null;
         parseResource: (resourceName: string) => Promise<any>;
         rankResources: (intent: string) => Promise<any>;
+        generateQuestionsForHelmChart: (intent: string, chart: HelmChartInfo, description: string, interaction_id?: string) => Promise<QuestionGroup>;
+        fetchHelmChartContent: (chart: HelmChartInfo) => Promise<{
+            valuesYaml: string;
+            readme: string;
+        }>;
     };
     constructor(config?: CoreConfig);
     initialize(): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAkB;IAErC,SAAgB,SAAS,EAAE,mBAAmB,CAAC;IAC/C,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,QAAQ,EAAE,cAAc,CAAC;IACzC,SAAgB,EAAE,EAAE,UAAU,CAAC;IAC/B,SAAgB,MAAM,EAAE;QACtB,MAAM,EAAE,YAAY,CAAC;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;QACnC,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QACtD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACjD,CAAC;gBAEU,MAAM,GAAE,UAAe;IA+D7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/C,aAAa,IAAI,OAAO;IAIxB,UAAU,IAAI,MAAM;CAGrB;AAGD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACpI,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE5G,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC3G,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACnH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACpH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGjI,eAAe,KAAK,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}

package/dist/core/index.js

@@ -69,6 +69,18 @@ class DotAI {
                 // Create discovery function with proper binding
                 const explainResourceFn = async (resource) => await this.discovery.explainResource(resource);
                 return await ranker.findBestSolutions(intent, explainResourceFn);
+            },
+            generateQuestionsForHelmChart: async (intent, chart, description, interaction_id) => {
+                if (!ranker) {
+                    throw new Error('ResourceRanker not available. AI provider API key is required for question generation.');
+                }
+                return await ranker.generateQuestionsForHelmChart(intent, chart, description, interaction_id);
+            },
+            fetchHelmChartContent: async (chart) => {
+                if (!ranker) {
+                    throw new Error('ResourceRanker not available for fetching Helm chart content.');
+                }
+                return await ranker.fetchHelmChartContent(chart);
             }
         };
     }

package/dist/core/schema.d.ts

@@ -6,6 +6,7 @@
  */
 import { ResourceExplanation } from './discovery';
 import { AIProvider } from './ai-provider.interface';
+import { HelmChartInfo } from './helm-types';
 export interface FieldConstraints {
     minimum?: number;
     maximum?: number;
@@ -87,14 +88,26 @@ export interface ResourceSolution {
     score: number;
     description: string;
     reasons: string[];
-    analysis: string;
     questions: QuestionGroup;
     appliedPatterns?: string[];
 }
+export interface HelmRecommendation {
+    reason: string;
+    suggestedTool: string;
+    searchQuery: string;
+}
+export interface SolutionResult {
+    solutions: ResourceSolution[];
+    helmRecommendation: HelmRecommendation | null;
+}
+export interface ClusterResourceInfo {
+    name: string;
+    isDefault: boolean;
+}
 export interface ClusterOptions {
     namespaces: string[];
-    storageClasses: string[];
-    ingressClasses: string[];
+    storageClasses: ClusterResourceInfo[];
+    ingressClasses: ClusterResourceInfo[];
     nodeLabels: string[];
     serviceAccounts?: {
         [namespace: string]: string[];
@@ -150,7 +163,7 @@ export declare class ResourceRecommender {
     /**
      * Find the best resource solution(s) for user intent using two-phase analysis
      */
-    findBestSolutions(intent: string, _explainResource: (resource: string) => Promise<any>, interaction_id?: string): Promise<ResourceSolution[]>;
+    findBestSolutions(intent: string, _explainResource: (resource: string) => Promise<any>, interaction_id?: string): Promise<SolutionResult>;
     /**
      * Phase 2: AI assembles and ranks complete solutions (replaces separate selection + ranking)
      */
@@ -192,9 +205,24 @@ export declare class ResourceRecommender {
      * Discover cluster options for dynamic question generation
      */
     private discoverClusterOptions;
+    /**
+     * Format cluster options for inclusion in prompts
+     */
+    private formatClusterOptionsText;
     /**
      * Generate contextual questions using AI based on user intent and solution resources
      */
     private generateQuestionsWithAI;
+    /**
+     * Generate contextual questions for Helm chart installation
+     */
+    generateQuestionsForHelmChart(intent: string, chart: HelmChartInfo, description: string, interaction_id?: string): Promise<QuestionGroup>;
+    /**
+     * Fetch Helm chart values.yaml and README
+     */
+    fetchHelmChartContent(chart: HelmChartInfo): Promise<{
+        valuesYaml: string;
+        readme: string;
+    }>;
 }
 //# sourceMappingURL=schema.d.ts.map