@vfarcic/dot-ai 0.1.0

package/dist/core/deploy-operation.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Deploy Operation - Handles Kubernetes manifest deployment with readiness checking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeployOperation = void 0;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const error_handling_1 = require("./error-handling");
+const kubernetes_utils_1 = require("./kubernetes-utils");
+class DeployOperation {
+    kubectlConfig;
+    constructor(kubeconfig) {
+        this.kubectlConfig = {
+            kubeconfig: kubeconfig || process.env.KUBECONFIG
+        };
+    }
+    /**
+     * Deploy Kubernetes manifests from generated solution
+     */
+    async deploy(options) {
+        return error_handling_1.ErrorHandler.withErrorHandling(async () => {
+            const manifestPath = this.getManifestPath(options);
+            // Verify manifest file exists
+            await this.verifyManifestExists(manifestPath);
+            // Update kubeconfig if provided in options
+            const kubectlConfig = {
+                ...this.kubectlConfig,
+                kubeconfig: options.kubeconfig || this.kubectlConfig.kubeconfig
+            };
+            // Apply manifests with kubectl
+            const kubectlOutput = await this.applyManifests(manifestPath, options.timeout || 30, kubectlConfig);
+            return {
+                success: true,
+                solutionId: options.solutionId,
+                manifestPath,
+                readinessTimeout: false,
+                message: 'Deployment completed successfully',
+                kubectlOutput
+            };
+        }, {
+            operation: 'deploy',
+            component: 'deploy-operation'
+        });
+    }
+    /**
+     * Get the manifest file path for the solution
+     */
+    getManifestPath(options) {
+        const sessionDir = options.sessionDir || process.env.DOT_AI_SESSION_DIR;
+        if (!sessionDir) {
+            throw new Error('Session directory not configured. Set DOT_AI_SESSION_DIR environment variable or provide sessionDir parameter.');
+        }
+        return (0, path_1.join)(sessionDir, `${options.solutionId}.yaml`);
+    }
+    /**
+     * Verify that the manifest file exists
+     */
+    async verifyManifestExists(manifestPath) {
+        try {
+            await (0, promises_1.access)(manifestPath);
+        }
+        catch (error) {
+            throw new Error(`Manifest file not found: ${manifestPath}`);
+        }
+    }
+    /**
+     * Apply manifests using kubectl with readiness checking
+     */
+    async applyManifests(manifestPath, timeout, kubectlConfig) {
+        // First, apply the manifests
+        const applyResult = await (0, kubernetes_utils_1.executeKubectl)(['apply', '-f', `"${manifestPath}"`], kubectlConfig);
+        // Try to wait for deployments to be ready (ignore failures for other resource types)
+        let waitOutput = '';
+        try {
+            const waitResult = await (0, kubernetes_utils_1.executeKubectl)([
+                'wait',
+                '--for=condition=available',
+                'deployments',
+                '--all',
+                `--timeout=${timeout}s`,
+                '--all-namespaces'
+            ], {
+                ...kubectlConfig,
+                timeout: (timeout + 10) * 1000 // Add 10 seconds buffer for kubectl command itself
+            });
+            waitOutput = `\n\nWait output:\n${waitResult}`;
+        }
+        catch (waitError) {
+            // If no deployments found or wait fails, that's OK for ConfigMaps, Services, etc.
+            if (waitError.message && waitError.message.includes('no matching resources found')) {
+                waitOutput = '\n\nWait output: No deployments found to wait for (likely ConfigMaps, Services, etc.)';
+            }
+            else {
+                waitOutput = `\n\nWait output: Warning - ${waitError.message}`;
+            }
+        }
+        return `Apply output:\n${applyResult}${waitOutput}`;
+    }
+}
+exports.DeployOperation = DeployOperation;

package/dist/core/discovery.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Kubernetes Discovery Module
+ *
+ * Handles cluster connection, resource discovery, and capability detection
+ */
+import { KubectlConfig } from './kubernetes-utils';
+export interface ClusterInfo {
+    type: string;
+    version: string;
+    capabilities: string[];
+}
+export interface ResourceMap {
+    resources: EnhancedResource[];
+    custom: EnhancedCRD[];
+}
+export interface CRD {
+    name: string;
+    group: string;
+    version: string;
+    schema: any;
+}
+export interface EnhancedCRD {
+    name: string;
+    group: string;
+    version: string;
+    kind: string;
+    scope: 'Namespaced' | 'Cluster';
+    versions: Array<{
+        name: string;
+        served: boolean;
+        storage: boolean;
+        schema?: any;
+    }>;
+    schema?: any;
+}
+export interface EnhancedResource {
+    name: string;
+    namespaced: boolean;
+    kind: string;
+    shortNames: string[];
+    apiVersion: string;
+    group: string;
+}
+export interface ResourceExplanation {
+    kind: string;
+    version: string;
+    group: string;
+    description: string;
+    fields: Array<{
+        name: string;
+        type: string;
+        description: string;
+        required: boolean;
+    }>;
+}
+export interface ClusterFingerprint {
+    version: string;
+    platform: string;
+    nodeCount: number;
+    namespaceCount: number;
+    crdCount: number;
+    capabilities: string[];
+    features: {
+        deployments: number;
+        services: number;
+        pods: number;
+        configMaps: number;
+        secrets: number;
+    };
+    networking: {
+        cni: string;
+        serviceSubnet: string;
+        podSubnet: string;
+        dnsProvider: string;
+    };
+    security: {
+        rbacEnabled: boolean;
+        podSecurityPolicy: boolean;
+        networkPolicies: boolean;
+        admissionControllers: string[];
+    };
+    storage: {
+        storageClasses: string[];
+        persistentVolumes: number;
+        csiDrivers: string[];
+    };
+}
+export interface KubernetesDiscoveryConfig {
+    kubeconfigPath?: string;
+}
+export declare class KubernetesDiscovery {
+    private kc;
+    private k8sApi;
+    private connected;
+    private kubeconfigPath;
+    constructor(config?: KubernetesDiscoveryConfig);
+    /**
+     * Resolves kubeconfig path following priority order:
+     * 1. Custom path provided in constructor
+     * 2. KUBECONFIG environment variable (first path if multiple)
+     * 3. Default ~/.kube/config
+     */
+    private resolveKubeconfigPath;
+    /**
+     * Get the current kubeconfig path being used
+     */
+    getKubeconfigPath(): string;
+    /**
+     * Set a new kubeconfig path (will require reconnection)
+     */
+    setKubeconfigPath(newPath: string): void;
+    connect(): Promise<void>;
+    isConnected(): boolean;
+    getClusterInfo(): Promise<ClusterInfo>;
+    private detectClusterType;
+    private detectCapabilities;
+    discoverResources(): Promise<ResourceMap>;
+    /**
+     * Execute kubectl command with proper configuration
+     */
+    /**
+     * Execute kubectl command with proper configuration
+     * Delegates to shared utility function
+     */
+    executeKubectl(args: string[], config?: KubectlConfig): Promise<string>;
+    discoverCRDs(options?: {
+        group?: string;
+    }): Promise<EnhancedCRD[]>;
+    discoverCRDDetails(): Promise<CRD[]>;
+    getAPIResources(options?: {
+        group?: string;
+    }): Promise<EnhancedResource[]>;
+    explainResource(resource: string, options?: {
+        field?: string;
+    }): Promise<string>;
+    fingerprintCluster(): Promise<ClusterFingerprint>;
+    private getResourceCounts;
+    private getNetworkingInfo;
+    private getSecurityInfo;
+    private getStorageInfo;
+    private extractSubnet;
+    getResourceSchema(_kind: string, _apiVersion: string): Promise<any>;
+    getNamespaces(): Promise<string[]>;
+    namespaceExists(namespace: string): Promise<boolean>;
+    /**
+     * Discover what capabilities a CRD provides by analyzing related resources
+     */
+    private discoverCRDCapabilities;
+    /**
+     * Find Compositions associated with this CRD
+     */
+    private discoverAssociatedCompositions;
+    /**
+     * Analyze what resources a Composition creates
+     */
+    private analyzeCompositionCapabilities;
+    /**
+     * Build an enhanced description that includes discovered capabilities
+     */
+    private buildEnhancedDescription;
+}
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"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"}