@vfarcic/dot-ai 0.5.1 → 0.6.0

package/dist/core/schema.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Resource Schema Parser and Validator
+ *
+ * Implements comprehensive schema parsing and validation for Kubernetes resources
+ * Fetches structured OpenAPI schemas from Kubernetes API server and validates manifests
+ */
+import { ResourceExplanation } from './discovery';
+export interface FieldConstraints {
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    enum?: string[];
+    default?: any;
+    pattern?: string;
+}
+export interface SchemaField {
+    name: string;
+    type: string;
+    description: string;
+    required: boolean;
+    default?: any;
+    constraints?: FieldConstraints;
+    nested: Map<string, SchemaField>;
+}
+export interface ResourceSchema {
+    apiVersion: string;
+    kind: string;
+    group: string;
+    version?: string;
+    description: string;
+    properties: Map<string, SchemaField>;
+    required?: string[];
+    namespace?: boolean;
+    rawExplanation?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface ResourceMapping {
+    resourceKind: string;
+    apiVersion: string;
+    group?: string;
+    fieldPath: string;
+}
+export interface AnswerSet {
+    [questionId: string]: any;
+}
+export interface EnhancedSolution extends ResourceSolution {
+    answers: AnswerSet;
+    openAnswer: string;
+}
+export interface Question {
+    id: string;
+    question: string;
+    type: 'text' | 'select' | 'multiselect' | 'boolean' | 'number';
+    options?: string[];
+    placeholder?: string;
+    validation?: {
+        required?: boolean;
+        min?: number;
+        max?: number;
+        pattern?: string;
+        message?: string;
+    };
+    answer?: any;
+}
+export interface QuestionGroup {
+    required: Question[];
+    basic: Question[];
+    advanced: Question[];
+    open: {
+        question: string;
+        placeholder: string;
+        answer?: string;
+    };
+}
+export interface ResourceSolution {
+    type: 'single' | 'combination';
+    resources: ResourceSchema[];
+    score: number;
+    description: string;
+    reasons: string[];
+    analysis: string;
+    questions: QuestionGroup;
+}
+export interface AIRankingConfig {
+    claudeApiKey: string;
+}
+export interface DiscoveryFunctions {
+    discoverResources: () => Promise<any>;
+    explainResource: (resource: string) => Promise<any>;
+}
+export interface ClusterOptions {
+    namespaces: string[];
+    storageClasses: string[];
+    ingressClasses: string[];
+    nodeLabels: string[];
+    serviceAccounts?: {
+        [namespace: string]: string[];
+    };
+}
+/**
+ * SchemaParser converts kubectl explain output to structured ResourceSchema
+ */
+export declare class SchemaParser {
+    /**
+     * Parse ResourceExplanation from discovery engine into structured schema
+     */
+    parseResourceExplanation(explanation: ResourceExplanation): ResourceSchema;
+    /**
+     * Add nested field to the schema structure
+     */
+    private addNestedField;
+    /**
+     * Normalize field types from kubectl explain output
+     */
+    private normalizeType;
+    /**
+     * Parse field constraints from description text
+     */
+    parseFieldConstraints(type: string, description: string): FieldConstraints;
+}
+/**
+ * ManifestValidator validates Kubernetes manifests using kubectl dry-run
+ */
+export declare class ManifestValidator {
+    /**
+     * Validate a manifest using kubectl dry-run
+     * This uses the actual Kubernetes API server validation for accuracy
+     */
+    validateManifest(manifestPath: string, config?: {
+        kubeconfig?: string;
+        dryRunMode?: 'client' | 'server';
+    }): Promise<ValidationResult>;
+    /**
+     * Add best practice warnings
+     */
+    private addBestPracticeWarnings;
+}
+/**
+ * ResourceRecommender determines which resources best meet user needs using AI
+ */
+export declare class ResourceRecommender {
+    private claudeIntegration;
+    private config;
+    constructor(config: AIRankingConfig);
+    /**
+     * Find the best resource solution(s) for user intent using two-phase analysis
+     */
+    findBestSolutions(intent: string, discoverResources: () => Promise<any>, explainResource: (resource: string) => Promise<any>): Promise<ResourceSolution[]>;
+    /**
+     * Phase 1: AI selects promising resource candidates from lightweight list
+     */
+    private selectResourceCandidates;
+    /**
+     * Phase 2: Fetch detailed schemas for selected candidates
+     */
+    private fetchDetailedSchemas;
+    /**
+     * Phase 3: Rank resources with detailed schema information
+     */
+    private rankWithDetailedSchemas;
+    /**
+     * Load and format prompt template from file
+     */
+    private loadPromptTemplate;
+    /**
+     * Parse AI response into solution results
+     */
+    private parseAISolutionResponse;
+    /**
+     * Discover cluster options for dynamic question generation
+     */
+    private discoverClusterOptions;
+    /**
+     * Extract JSON object from AI response with robust parsing
+     */
+    private extractJsonFromAIResponse;
+    /**
+     * Generate contextual questions using AI based on user intent and solution resources
+     */
+    private generateQuestionsWithAI;
+}
+//# sourceMappingURL=schema.d.ts.map

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

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