@vfarcic/dot-ai 0.35.0 → 0.37.0

package/dist/core/doc-testing-types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Documentation Testing Types
+ *
+ * Flexible TypeScript interfaces for the documentation testing system.
+ * Designed to let AI agents dynamically identify and categorize testable content.
+ */
+/**
+ * Main session object that tracks a documentation validation workflow
+ */
+export interface ValidationSession {
+    sessionId: string;
+    filePath: string;
+    startTime: string;
+    currentPhase: ValidationPhase;
+    status: SessionStatus;
+    metadata: SessionMetadata;
+    sections?: DocumentSection[];
+    sectionResults?: Record<string, SectionTestResult>;
+}
+/**
+ * Session metadata with counters and summary information
+ */
+export interface SessionMetadata {
+    totalSections: number;
+    completedSections: number;
+    sectionStatus: Record<string, SectionStatus>;
+    nextItemId: number;
+    sessionDir: string;
+    lastUpdated: string;
+}
+/**
+ * The five phases of documentation validation workflow
+ */
+export declare enum ValidationPhase {
+    SCAN = "scan",// Find all testable items in the documentation
+    TEST = "test",// Execute tests on the found items
+    ANALYZE = "analyze",// Analyze results and categorize issues
+    FIX = "fix",// Generate fixes for identified problems
+    DONE = "done"
+}
+/**
+ * Overall status of a validation session
+ */
+export declare enum SessionStatus {
+    ACTIVE = "active",// Session is currently being worked on
+    COMPLETED = "completed",// All phases completed successfully
+    FAILED = "failed",// Session failed due to errors
+    PAUSED = "paused"
+}
+/**
+ * Status of a document section during validation
+ */
+export declare enum SectionStatus {
+    PENDING = "pending",// Section not yet processed
+    SCANNING = "scanning",// Currently identifying testable items
+    TESTING = "testing",// Currently executing validation items  
+    ANALYZING = "analyzing",// Currently analyzing test results
+    FIXING = "fixing",// Currently generating fixes
+    COMPLETED = "completed",// Section validation completed successfully
+    FAILED = "failed"
+}
+/**
+ * Logical section of a document for validation
+ */
+export interface DocumentSection {
+    id: string;
+    title: string;
+}
+/**
+ * Individual issue or recommendation with tracking
+ */
+export interface FixableItem {
+    id: number;
+    text: string;
+    status: 'pending' | 'fixed' | 'deferred' | 'failed';
+    explanation?: string;
+}
+/**
+ * Structured test results for a section (JSON format from client agent)
+ */
+export interface SectionTestResult {
+    whatWasDone: string;
+    issues: FixableItem[];
+    recommendations: FixableItem[];
+}
+/**
+ * Workflow step returned by MCP interface to guide AI agents
+ */
+export interface WorkflowStep {
+    sessionId: string;
+    phase: ValidationPhase;
+    prompt: string;
+    nextPhase?: ValidationPhase;
+    nextAction?: string;
+    instruction?: string;
+    agentInstructions?: string;
+    workflow: {
+        completed: ValidationPhase[];
+        current: ValidationPhase;
+        remaining: ValidationPhase[];
+    };
+    data?: any;
+}
+/**
+ * Phase-specific result tracking
+ */
+export interface PhaseResult {
+    phase: ValidationPhase;
+    startTime: string;
+    endTime?: string;
+    status: PhaseStatus;
+    summary: string;
+    nextPhase?: ValidationPhase;
+    aiInsights?: string;
+}
+/**
+ * Status of a validation phase
+ */
+export declare enum PhaseStatus {
+    PENDING = "pending",
+    IN_PROGRESS = "in_progress",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+//# sourceMappingURL=doc-testing-types.d.ts.map

package/dist/core/doc-testing-types.d.ts.map

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

package/dist/core/doc-testing-types.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Documentation Testing Types
+ *
+ * Flexible TypeScript interfaces for the documentation testing system.
+ * Designed to let AI agents dynamically identify and categorize testable content.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhaseStatus = exports.SectionStatus = exports.SessionStatus = exports.ValidationPhase = void 0;
+/**
+ * The five phases of documentation validation workflow
+ */
+var ValidationPhase;
+(function (ValidationPhase) {
+    ValidationPhase["SCAN"] = "scan";
+    ValidationPhase["TEST"] = "test";
+    ValidationPhase["ANALYZE"] = "analyze";
+    ValidationPhase["FIX"] = "fix";
+    ValidationPhase["DONE"] = "done"; // Mark session as completed
+})(ValidationPhase || (exports.ValidationPhase = ValidationPhase = {}));
+/**
+ * Overall status of a validation session
+ */
+var SessionStatus;
+(function (SessionStatus) {
+    SessionStatus["ACTIVE"] = "active";
+    SessionStatus["COMPLETED"] = "completed";
+    SessionStatus["FAILED"] = "failed";
+    SessionStatus["PAUSED"] = "paused"; // Session temporarily paused
+})(SessionStatus || (exports.SessionStatus = SessionStatus = {}));
+/**
+ * Status of a document section during validation
+ */
+var SectionStatus;
+(function (SectionStatus) {
+    SectionStatus["PENDING"] = "pending";
+    SectionStatus["SCANNING"] = "scanning";
+    SectionStatus["TESTING"] = "testing";
+    SectionStatus["ANALYZING"] = "analyzing";
+    SectionStatus["FIXING"] = "fixing";
+    SectionStatus["COMPLETED"] = "completed";
+    SectionStatus["FAILED"] = "failed"; // Section validation failed
+})(SectionStatus || (exports.SectionStatus = SectionStatus = {}));
+/**
+ * Status of a validation phase
+ */
+var PhaseStatus;
+(function (PhaseStatus) {
+    PhaseStatus["PENDING"] = "pending";
+    PhaseStatus["IN_PROGRESS"] = "in_progress";
+    PhaseStatus["COMPLETED"] = "completed";
+    PhaseStatus["FAILED"] = "failed";
+})(PhaseStatus || (exports.PhaseStatus = PhaseStatus = {}));

package/dist/core/error-handling.d.ts

@@ -52,21 +52,21 @@ export interface ErrorContext {
     retryCount?: number;
 }
 /**
- * Structured error interface
+ * Structured error class that extends native Error
  */
-export interface AppError {
-    id: string;
-    code: string;
-    category: ErrorCategory;
-    severity: ErrorSeverity;
-    message: string;
-    userMessage?: string;
-    technicalDetails?: string;
-    context: ErrorContext;
-    timestamp: Date;
-    suggestedActions: string[];
-    isRetryable: boolean;
-    cause?: AppError;
+export declare class AppError extends Error {
+    readonly id: string;
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly userMessage?: string;
+    readonly technicalDetails?: string;
+    readonly context: ErrorContext;
+    readonly timestamp: Date;
+    readonly suggestedActions: string[];
+    readonly isRetryable: boolean;
+    readonly cause?: AppError;
+    constructor(id: string, code: string, category: ErrorCategory, severity: ErrorSeverity, message: string, context: ErrorContext, timestamp: Date, suggestedActions: string[], isRetryable: boolean, userMessage?: string, technicalDetails?: string, cause?: AppError);
 }
 /**
  * Log levels for structured logging

package/dist/core/error-handling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/core/error-handling.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error-handling.d.ts","sourceRoot":"","sources":["../../src/core/error-handling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAa,MAAM,oCAAoC,CAAC;AAEzE;;GAEG;AACH,oBAAY,aAAa;IAEvB,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAG/B,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IAGvB,UAAU,eAAe;IACzB,OAAO,YAAY;IAGnB,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAG/B,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,GAAG,QAAQ,CAAY,uCAAuC;IAC9D,MAAM,WAAW,CAAM,4BAA4B;IACnD,IAAI,SAAS,CAAU,yCAAyC;IAChE,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAE3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAGhB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAGjC,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAEjC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,QAAQ,EAAE,aAAa,CAAC;IACxC,SAAgB,QAAQ,EAAE,aAAa,CAAC;IAGxC,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrC,SAAgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1C,SAAgB,OAAO,EAAE,YAAY,CAAC;IAGtC,SAAgB,SAAS,EAAE,IAAI,CAAC;IAGhC,SAAgB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3C,SAAgB,WAAW,EAAE,OAAO,CAAC;IAGrC,SAAgB,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAG/B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,IAAI,EACf,gBAAgB,EAAE,MAAM,EAAE,EAC1B,WAAW,EAAE,OAAO,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,MAAM,EACzB,KAAK,CAAC,EAAE,QAAQ;CAgBnB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACnE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACpE;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAW;gBAEf,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAwB;IAKjE,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,aAAa;IAWrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAMvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAOlE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAOlE,OAAO,CAAC,cAAc;CAoBvB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAK;IACpC,OAAO,CAAC,MAAM,CAAC,MAAM,CAA6C;IAElE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,aAAa,CAAC,EAAE,KAAK,GACpB,QAAQ;IA4CX;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAO/C;;OAEG;IACH,MAAM,CAAC,WAAW,CAChB,KAAK,EAAE,KAAK,GAAG,QAAQ,EACvB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,OAAO,GAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KAChB,GACL,QAAQ,GAAG,QAAQ;IAoCtB;;OAEG;WACU,iBAAiB,CAAC,CAAC,EAC9B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,OAAO,CAAC;KACnB,GACL,OAAO,CAAC,CAAC,CAAC;IAkDb,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAQhC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAiBhC,OAAO,CAAC,MAAM,CAAC,eAAe;IAsB9B,OAAO,CAAC,MAAM,CAAC,cAAc;IAgB7B,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAerC,OAAO,CAAC,MAAM,CAAC,0BAA0B;IA6BzC,OAAO,CAAC,MAAM,CAAC,eAAe;CAkC/B"}

package/dist/core/error-handling.js

@@ -6,7 +6,7 @@
  * with support for MCP protocol, CLI operations, and core functionality.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorHandler = exports.ConsoleLogger = exports.LogLevel = exports.ErrorSeverity = exports.ErrorCategory = void 0;
+exports.ErrorHandler = exports.ConsoleLogger = exports.LogLevel = exports.AppError = exports.ErrorSeverity = exports.ErrorCategory = void 0;
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 /**
  * Error categories for systematic error classification
@@ -42,6 +42,44 @@ var ErrorSeverity;
     ErrorSeverity["HIGH"] = "high";
     ErrorSeverity["CRITICAL"] = "critical"; // System-threatening, immediate action required
 })(ErrorSeverity || (exports.ErrorSeverity = ErrorSeverity = {}));
+/**
+ * Structured error class that extends native Error
+ */
+class AppError extends Error {
+    // Core identification
+    id;
+    code;
+    category;
+    severity;
+    // User-facing information
+    userMessage;
+    technicalDetails;
+    // Context and debugging
+    context;
+    // Timing
+    timestamp;
+    // Recovery guidance
+    suggestedActions;
+    isRetryable;
+    // Chaining
+    cause;
+    constructor(id, code, category, severity, message, context, timestamp, suggestedActions, isRetryable, userMessage, technicalDetails, cause) {
+        super(message);
+        this.name = 'AppError';
+        this.id = id;
+        this.code = code;
+        this.category = category;
+        this.severity = severity;
+        this.context = context;
+        this.timestamp = timestamp;
+        this.suggestedActions = suggestedActions;
+        this.isRetryable = isRetryable;
+        this.userMessage = userMessage;
+        this.technicalDetails = technicalDetails;
+        this.cause = cause;
+    }
+}
+exports.AppError = AppError;
 /**
  * Log levels for structured logging
  */
@@ -161,21 +199,8 @@ class ErrorHandler {
             ...context
         };
         const suggestedActions = context.suggestedActions || this.getDefaultSuggestedActions(category);
-        const appError = {
-            id: errorId,
-            code: this.generateErrorCode(category, severity),
-            category,
-            severity,
-            message,
-            userMessage: this.getUserFriendlyMessage(category),
-            technicalDetails: originalError?.message,
-            context: fullContext,
-            timestamp,
-            suggestedActions,
-            isRetryable: fullContext.isRetryable || false,
-            // Don't wrap the original error to prevent circular references
-            cause: undefined
-        };
+        const appError = new AppError(errorId, this.generateErrorCode(category, severity), category, severity, message, fullContext, timestamp, suggestedActions, fullContext.isRetryable || false, this.getUserFriendlyMessage(category), originalError?.message, undefined // Don't wrap the original error to prevent circular references
+        );
         // Log the error
         this.logger.error(`Error created: ${message}`, appError, {
             category,
@@ -378,21 +403,8 @@ class ErrorHandler {
             isRetryable: false,
             retryCount: 0
         };
-        const appError = {
-            id: errorId,
-            code: this.generateErrorCode(category, severity),
-            category,
-            severity,
-            message: error.message,
-            userMessage: this.getUserFriendlyMessage(category),
-            technicalDetails: error.message,
-            context,
-            timestamp,
-            suggestedActions: this.getDefaultSuggestedActions(category),
-            isRetryable: false,
-            // No cause to prevent circular reference
-            cause: undefined
-        };
+        const appError = new AppError(errorId, this.generateErrorCode(category, severity), category, severity, error.message, context, timestamp, this.getDefaultSuggestedActions(category), false, this.getUserFriendlyMessage(category), error.message, undefined // No cause to prevent circular reference
+        );
         return appError;
     }
 }

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

@@ -13,9 +13,6 @@ export interface KubectlConfig {
  * Execute kubectl command with proper configuration
  */
 export declare function executeKubectl(args: string[], config?: KubectlConfig): Promise<string>;
-/**
- * Build kubectl command string with proper flags
- */
 export declare function buildKubectlCommand(args: string[], config?: KubectlConfig): string;
 export declare class ErrorClassifier {
     static classifyError(error: Error): {

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

@@ -1 +1 @@
-{"version":3,"file":"kubernetes-utils.d.ts","sourceRoot":"","sources":["../../src/core/kubernetes-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAiBlF;AAGD,qBAAa,eAAe;IAC1B,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IA0D7E,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAIpC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAIrC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAMhC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAI1C,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAYlC,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAgBzC,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAYxC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAQ1C,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAYrC,OAAO,CAAC,MAAM,CAAC,gCAAgC;CAGhD"}
+{"version":3,"file":"kubernetes-utils.d.ts","sourceRoot":"","sources":["../../src/core/kubernetes-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB5F;AAsBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAmBlF;AAGD,qBAAa,eAAe;IAC1B,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IA0D7E,OAAO,CAAC,MAAM,CAAC,cAAc;IAa7B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAYpC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAIrC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAMhC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAI1C,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAYlC,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAgBzC,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAYxC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAQ1C,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAYrC,OAAO,CAAC,MAAM,CAAC,gCAAgC;CAGhD"}

package/dist/core/kubernetes-utils.js

@@ -39,19 +39,34 @@ async function executeKubectl(args, config) {
 /**
  * Build kubectl command string with proper flags
  */
+/**
+ * Safely escape shell arguments to prevent command injection
+ */
+function escapeShellArg(arg) {
+    if (!arg || typeof arg !== 'string') {
+        return '""';
+    }
+    // If the argument contains only safe characters, return as-is
+    if (/^[a-zA-Z0-9._/-]+$/.test(arg)) {
+        return arg;
+    }
+    // Otherwise, quote and escape
+    return `"${arg.replace(/["\\]/g, '\\$&')}"`;
+}
 function buildKubectlCommand(args, config) {
-    let command = 'kubectl';
+    const cmdParts = ['kubectl'];
     if (config?.kubeconfig) {
-        command += ` --kubeconfig=${config.kubeconfig}`;
+        cmdParts.push('--kubeconfig', escapeShellArg(config.kubeconfig));
     }
     if (config?.context) {
-        command += ` --context=${config.context}`;
+        cmdParts.push('--context', escapeShellArg(config.context));
     }
     if (config?.namespace) {
-        command += ` --namespace=${config.namespace}`;
+        cmdParts.push('--namespace', escapeShellArg(config.namespace));
     }
-    command += ` ${args.join(' ')}`;
-    return command;
+    // Safely add all arguments
+    args.forEach(arg => cmdParts.push(escapeShellArg(arg)));
+    return cmdParts.join(' ');
 }
 // Enhanced Error Classification System
 class ErrorClassifier {
@@ -106,10 +121,27 @@ class ErrorClassifier {
         };
     }
     static isNetworkError(message) {
-        return /getaddrinfo ENOTFOUND|timeout|ECONNREFUSED|ENOTFOUND|network|unreachable/i.test(message);
+        // Fixed: Avoid catastrophic backtracking by using non-overlapping alternation
+        const networkPatterns = [
+            'getaddrinfo ENOTFOUND',
+            'timeout',
+            'ECONNREFUSED',
+            'ENOTFOUND',
+            'network',
+            'unreachable'
+        ];
+        return networkPatterns.some(pattern => message.toLowerCase().includes(pattern.toLowerCase()));
     }
     static isAuthenticationError(message) {
-        return /unauthorized|invalid bearer token|certificate|auth|authentication/i.test(message);
+        // Fixed: Avoid catastrophic backtracking by using non-overlapping alternation
+        const authPatterns = [
+            'unauthorized',
+            'invalid bearer token',
+            'certificate',
+            'auth',
+            'authentication'
+        ];
+        return authPatterns.some(pattern => message.toLowerCase().includes(pattern.toLowerCase()));
     }
     static isAuthorizationError(message) {
         return /forbidden|cannot list|cannot get|cannot create|RBAC|permission denied/i.test(message);

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAOlD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,SAAS;IACxB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC;CAC3B;AAGD,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE;QACX,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,GAAG,CAAC;CAEd;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,GAAG,aAAa,CAAC;IAC/B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;CACrD;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,wBAAwB,CAAC,WAAW,EAAE,mBAAmB,GAAG,cAAc;IAgD1E;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB;CAyD3E;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;;OAGG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+C3I;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAWhC;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAKnC;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,EACrC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,GAClD,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAmB9B;;OAEG;YACW,wBAAwB;IAoFtC;;OAEG;YACW,oBAAoB;IAgDlC;;OAEG;YACW,uBAAuB;IAarC;;OAEG;YACW,kBAAkB;IA2BhC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwE/B;;OAEG;YACW,sBAAsB;IAiEpC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAgCjC;;OAEG;YACW,uBAAuB;CA6EtC"}

package/dist/core/schema.js

@@ -145,19 +145,25 @@ class SchemaParser {
         if (maxMatch) {
             constraints.maximum = parseInt(maxMatch[1]);
         }
-        // Extract enum values
-        const enumMatch = description.match(/(?:possible values|valid values|values)\s*(?:are)?:\s*([^.]+)/i);
+        // Extract enum values - Fixed: Avoid catastrophic backtracking
+        const enumMatch = description.match(/(possible values|valid values|values)\s*(?:are)?:\s*([^.]+)/i);
         if (enumMatch) {
-            const values = enumMatch[1]
+            const values = enumMatch[2]
                 .split(/,|\s+and\s+/)
                 .map(v => v.trim())
                 .filter(v => v.length > 0);
             constraints.enum = values;
         }
-        // Extract default values - handle multiple patterns: "(default: value)", "defaults to value", ". Default: value"
-        const defaultMatch = description.match(/(?:\(default:\s*([^)]+)\)|(?:defaults?\s+to\s+(\w+))|(?:\.\s+default:\s*(\w+)))/i);
+        // Extract default values - Fixed: Use simpler non-catastrophic patterns
+        let defaultMatch = description.match(/\(default:\s*([^)]+)\)/i);
+        if (!defaultMatch) {
+            defaultMatch = description.match(/defaults?\s+to\s+(\w+)/i);
+        }
+        if (!defaultMatch) {
+            defaultMatch = description.match(/\.\s+default:\s*(\w+)/i);
+        }
         if (defaultMatch) {
-            const defaultValue = (defaultMatch[1] || defaultMatch[2] || defaultMatch[3]).trim();
+            const defaultValue = defaultMatch[1].trim();
             if (type === 'integer') {
                 const parsed = parseInt(defaultValue);
                 if (!isNaN(parsed)) {

package/dist/interfaces/cli.d.ts

@@ -45,6 +45,7 @@ export declare class CliInterface {
     private handleAnswerQuestionCommand;
     private handleGenerateManifestsCommand;
     private handleDeployManifestsCommand;
+    private handleTestDocsCommand;
     continueWorkflow(workflowId: string, input: {
         responses: Record<string, any>;
     }): Promise<CliResult>;

package/dist/interfaces/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/interfaces/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAahC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAS;gBAEX,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,GAAE,SAAc;IAiBjD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;IA2LrB,WAAW,IAAI,MAAM,EAAE;IAIvB,cAAc,IAAI,MAAM,EAAE;IAIpB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAoB1B,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAgD9D,OAAO,CAAC,yBAAyB;IA0B3B,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,SAAS,CAAC;YAoC9E,mBAAmB;YAoBnB,kBAAkB;YAsBlB,sBAAsB;YAsCtB,2BAA2B;YAoC3B,2BAA2B;YAuC3B,8BAA8B;YAoC9B,4BAA4B;IAoCpC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBzG,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAgCvD,OAAO,CAAC,aAAa;IAmDrB,OAAO,CAAC,YAAY;IAyBpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;YACW,6BAA6B;IA+BrC,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CASxD;AAGD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/interfaces/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAahC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAS;gBAEX,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,GAAE,SAAc;IAiBjD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;IA4NrB,WAAW,IAAI,MAAM,EAAE;IAIvB,cAAc,IAAI,MAAM,EAAE;IAIpB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAoB1B,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAgD9D,OAAO,CAAC,yBAAyB;IA4B3B,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,SAAS,CAAC;YAsC9E,mBAAmB;YAoBnB,kBAAkB;YAsBlB,sBAAsB;YAsCtB,2BAA2B;YAoC3B,2BAA2B;YAuC3B,8BAA8B;YAoC9B,4BAA4B;YAiC5B,qBAAqB;IAmD7B,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBzG,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAgCvD,OAAO,CAAC,aAAa;IAmDrB,OAAO,CAAC,YAAY;IAyBpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;YACW,6BAA6B;IA+BrC,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CASxD;AAGD,eAAe,YAAY,CAAC"}

package/dist/interfaces/cli.js

@@ -255,6 +255,35 @@ For more help on specific commands, use:
             const result = await this.executeCommand('deployManifests', options);
             this.outputResult(result, options.output || this.config.defaultOutput || 'json', this.config.outputFile);
         });
+        // Test Docs command
+        this.program
+            .command('test-docs')
+            .description('Test documentation for accuracy and functionality')
+            .option('--file <path>', 'Path to documentation file to test (optional - if not provided, will discover available files)')
+            .option('--file-pattern <pattern>', 'File pattern for discovery (e.g., "**/*.md", "*.rst") - defaults to DOT_AI_DOC_PATTERN env var or "**/*.md"')
+            .option('--session-id <id>', 'Existing session ID to continue')
+            .option('--session-dir <path>', 'Directory to store session files (defaults to DOT_AI_SESSION_DIR env var)')
+            .option('--phase <phase>', 'Specific phase to run (scan, test, analyze, fix, done)', 'scan')
+            .option('--section-id <id>', 'Section ID when submitting test results')
+            .option('--results <text>', 'Test results to store (for client agent reporting back)')
+            .option('--output <format>', 'Output format (json|yaml|table)', 'json')
+            .action(async (options, command) => {
+            // Get global options from parent command
+            const globalOptions = command.parent?.opts() || {};
+            this.processGlobalOptions(globalOptions);
+            // Validate output format
+            if (options.output && !['json', 'yaml', 'table'].includes(options.output)) {
+                console.error('Error: Invalid output format. Supported: json, yaml, table');
+                process.exit(1);
+            }
+            // Validate phase
+            if (options.phase && !['scan', 'test', 'analyze', 'fix', 'done'].includes(options.phase)) {
+                console.error('Error: Invalid phase. Supported: scan, test, analyze, fix, done');
+                process.exit(1);
+            }
+            const result = await this.executeCommand('testDocs', options);
+            this.outputResult(result, options.output || this.config.defaultOutput || 'json', this.config.outputFile);
+        });
         // REMOVED: enhance command - moved to legacy reference
         // See src/legacy/tools/enhance-solution.ts for reference implementation
     }
@@ -345,6 +374,8 @@ For more help on specific commands, use:
                 return [...commonOptions, 'solution-id', 'session-dir'];
             case 'deployManifests':
                 return [...commonOptions, 'solution-id', 'session-dir', 'timeout'];
+            case 'testDocs':
+                return [...commonOptions, 'file', 'file-pattern', 'session-id', 'session-dir', 'phase', 'section-id', 'results'];
             // REMOVED: enhance command, deploy command
             default:
                 return commonOptions;
@@ -353,7 +384,7 @@ For more help on specific commands, use:
     async executeCommand(command, options = {}) {
         try {
             // Only initialize DotAI for commands that need cluster access
-            if (command !== 'chooseSolution' && command !== 'answerQuestion' && command !== 'generateManifests') {
+            if (command !== 'chooseSolution' && command !== 'answerQuestion' && command !== 'generateManifests' && command !== 'testDocs') {
                 await this.ensureDotAI().initialize();
             }
             switch (command) {
@@ -371,6 +402,8 @@ For more help on specific commands, use:
                     return await this.handleGenerateManifestsCommand(options);
                 case 'deployManifests':
                     return await this.handleDeployManifestsCommand(options);
+                case 'testDocs':
+                    return await this.handleTestDocsCommand(options);
                 // REMOVED: enhance command, deploy command
                 default:
                     return {
@@ -572,6 +605,48 @@ For more help on specific commands, use:
             };
         }
     }
+    async handleTestDocsCommand(options) {
+        try {
+            // Show progress for documentation testing
+            this.showProgress('📄 Analyzing documentation for testable items...');
+            // Validate file exists if provided
+            const fs = require('fs');
+            if (options.file && !fs.existsSync(options.file)) {
+                return {
+                    success: false,
+                    error: `Documentation file not found: ${options.file}`
+                };
+            }
+            // Prepare arguments for the testDocs tool
+            const toolArgs = {
+                filePath: options.file,
+                sessionId: options.sessionId,
+                phase: options.phase,
+                filePattern: options.filePattern,
+                sessionDir: options.sessionDir,
+                sectionId: options.sectionId,
+                results: options.results
+            };
+            // Execute the testDocs tool directly
+            const { handleTestDocsTool } = await Promise.resolve().then(() => __importStar(require('../tools/test-docs')));
+            const requestId = `cli_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+            const result = await handleTestDocsTool(toolArgs, this.dotAI || null, this.logger, requestId);
+            this.clearProgress();
+            // Parse the tool result
+            const responseData = JSON.parse(result.content[0].text);
+            return {
+                success: true,
+                data: responseData
+            };
+        }
+        catch (error) {
+            this.clearProgress();
+            return {
+                success: false,
+                error: `Documentation testing failed: ${error.message}`
+            };
+        }
+    }
     // REMOVED: handleEnhanceCommand method - moved to legacy reference
     // See src/legacy/tools/enhance-solution.ts for reference implementation
     async continueWorkflow(workflowId, input) {

package/dist/interfaces/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AA0CtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IA2BjD;;OAEG;IACH,OAAO,CAAC,aAAa;IAsFrB,OAAO,CAAC,iBAAiB;IAKnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,IAAI,OAAO;CAGnB"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAgDtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IA2BjD;;OAEG;IACH,OAAO,CAAC,aAAa;IAmGrB,OAAO,CAAC,iBAAiB;IAKnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,IAAI,OAAO;CAGnB"}