@vfarcic/dot-ai 0.40.0 → 0.41.0

package/README.md

@@ -6,7 +6,7 @@
 
 </div>
 
-DevOps AI Toolkit provides three powerful AI-driven capabilities: **Kubernetes deployment recommendations** that discover your cluster's capabilities and suggest optimal deployment approaches, **automated documentation testing** that validates documentation accuracy by executing commands and testing examples, and **shared prompts library** that enables centralized prompt sharing via native slash commands across development teams.
+DevOps AI Toolkit is an AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance.
 
 ## Who is this for?
 
@@ -86,7 +86,7 @@ DevOps AI Toolkit is designed to be used through AI development tools via MCP (M
 Perfect for conversational AI-driven workflows:
 
 1. **Create `.mcp.json` in your project:**
-<!-- dotai-ignore: MCP server binary (dot-ai-mcp) not testable as CLI - only works through MCP client connections -->
+<!-- dotai-ignore: MCP server binary (dot-ai-mcp) only works through MCP client connections -->
 ```json
 {
   "mcpServers": {
@@ -203,35 +203,17 @@ Agent: I'm executing the PRD creation workflow. Please describe the feature you
 - **[MCP Documentation Testing Guide](docs/mcp-documentation-testing-guide.md)** - Automated documentation validation
 - **[MCP Prompts Guide](docs/mcp-prompts-guide.md)** - Shared prompt library and slash commands
 
-### 👩‍💻 Development  
-- **[API Reference](docs/API.md)** - TypeScript interfaces and programmatic usage
-- **[Development Guide](docs/DEVELOPMENT.md)** - Contributing, setup, and testing
-
-### 🏗️ Architecture
-- **[Design Overview](docs/design.md)** - Technical design and principles  
-- **[Discovery Engine](docs/discovery-engine.md)** - Cluster resource discovery
-
-### 🤖 AI & Integration
-- **[Error Handling](docs/error-handling.md)** - Error management and debugging
-- **[Function Registration](docs/function-registration.md)** - Tool and function management
-
-**Quick Navigation:**
-- **New to DevOps AI Toolkit?** → Start with [MCP Setup Guide](docs/mcp-setup.md)
-- **Building integrations?** → See [API Reference](docs/API.md)
-- **Contributing code?** → Read [Development Guide](docs/DEVELOPMENT.md)
-- **Understanding architecture?** → Check [Design Overview](docs/design.md)
-
 ## Support
 
 - **Issues**: [GitHub Issues](https://github.com/vfarcic/dot-ai/issues)
 
 ## Contributing
 
-We welcome contributions! See the [Development Guide](docs/DEVELOPMENT.md) for details on:
-- Setting up the development environment
-- Running tests  
-- Code style and conventions
-- Submitting pull requests
+We welcome contributions! Please:
+- Fork the repository and create a feature branch
+- Run tests with `npm test` to ensure changes work correctly
+- Follow existing code style and conventions
+- Submit a pull request with a clear description of changes
 
 ## License
 
@@ -239,4 +221,4 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-**DevOps AI Toolkit** - Making Kubernetes deployment intelligent and accessible for everyone.
+**DevOps AI Toolkit** - AI-powered development productivity platform for enhanced software development workflows.

package/dist/index.d.ts

@@ -1,10 +1,9 @@
 /**
  * DevOps AI Toolkit Main Entry Point
  *
- * Universal Kubernetes application deployment agent with dual CLI/MCP interfaces
+ * Universal Kubernetes application deployment agent with MCP interface
  */
 export * from './core';
-export * from './interfaces/cli';
 export declare const version = "0.1.0";
 export declare const name = "dot-ai";
 declare const _default: {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AAGjC,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,IAAI,WAAW,CAAC;;;;;AAG7B,wBAGE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,QAAQ,CAAC;AAGvB,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,IAAI,WAAW,CAAC;;;;;AAG7B,wBAGE"}

package/dist/index.js

@@ -2,7 +2,7 @@
 /**
  * DevOps AI Toolkit Main Entry Point
  *
- * Universal Kubernetes application deployment agent with dual CLI/MCP interfaces
+ * Universal Kubernetes application deployment agent with MCP interface
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -21,7 +21,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.name = exports.version = void 0;
 __exportStar(require("./core"), exports);
-__exportStar(require("./interfaces/cli"), exports);
 // Version information
 exports.version = '0.1.0';
 exports.name = 'dot-ai';

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@vfarcic/dot-ai",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "Universal Kubernetes application deployment agent with CLI and MCP interfaces",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "dot-ai": "./dist/cli.js",
     "dot-ai-mcp": "./dist/mcp/server.js"
   },
   "exports": {
@@ -21,14 +20,12 @@
     "clean": "rm -rf dist",
     "prebuild": "npm run clean && npm run lint",
     "build": "tsc --sourceMap false",
-    "postbuild": "chmod +x dist/cli.js dist/mcp/server.js",
+    "postbuild": "chmod +x dist/mcp/server.js",
     "build:prod": "npm run clean && tsc --sourceMap false --removeComments true",
     "build:dev": "tsc --sourceMap true",
     "build:watch": "tsc --watch",
-    "build:cli": "npm run build && chmod +x dist/cli.js",
     "build:mcp": "npm run build && echo 'MCP server built successfully'",
     "dev": "ts-node src/index.ts",
-    "start:cli": "node dist/cli.js",
     "start:mcp": "node dist/mcp/server.js",
     "lint": "eslint src/ --ext .ts",
     "format": "prettier --write src/",
@@ -42,7 +39,6 @@
   "keywords": [
     "kubernetes",
     "deployment",
-    "cli",
     "mcp",
     "devops",
     "containers",

package/shared-prompts/prd-start.md

@@ -12,49 +12,28 @@ You are helping initiate active implementation work on a specific Product Requir
 
 ## Process Overview
 
-1. **Auto-Detect Target PRD** - Intelligently determine which PRD to start implementing
-2. **Validate PRD Readiness** - Ensure the PRD is ready for implementation
+1. **Select Target PRD** - Ask user which PRD they want to implement
+2. **Validate PRD Readiness** - Ensure the selected PRD is ready for implementation
 3. **Set Up Implementation Context** - Prepare the development environment
 4. **Identify Starting Point** - Determine the best first implementation task
 5. **Begin Implementation** - Launch into actual development work
 
-## Step 1: Smart PRD Detection
+## Step 1: PRD Selection
 
-**Auto-detect the target PRD using these context clues (in priority order):**
+**Ask the user which PRD they want to start implementing:**
 
-1. **Git Branch Analysis** - Check current branch name for PRD patterns:
-   - `feature/prd-12-*` → PRD 12
-   - `prd-13-*` → PRD 13
-   - `feature/prd-*` → Extract PRD number
-
-2. **Recent Git Commits** - Look at recent commit messages for PRD references:
-   - "feat: PRD 12 setup" → PRD 12
-   - "docs: update prd-13 requirements" → PRD 13
-
-3. **Git Status Analysis** - Check modified/staged files for PRD clues:
-   - Modified `prds/12-*.md` → PRD 12
-   - Changes in PRD-specific directories
+```markdown
+## Which PRD would you like to start implementing?
 
-4. **Available PRDs Discovery** - List all PRDs in `prds/` directory and identify those ready for implementation
+Please provide the PRD number (e.g., "12", "PRD 12", or "36").
 
-5. **Fallback to User Choice** - Only if context detection fails, ask user to specify
+**Not sure which PRD to work on?** 
+Execute `dot-ai:prds-get` prompt to see all available PRDs organized by priority and readiness.
 
-**PRD Detection Implementation:**
-```bash
-# Use these tools to gather context:
-# 1. Check git branch: gitStatus shows current branch
-# 2. Check git status: Look for modified PRD files  
-# 3. List PRDs: Use LS or Glob to find prds/*.md files
-# 4. Recent commits: Use Bash 'git log --oneline -n 5' for recent context
+**Your choice**: [Wait for user input]
 ```
 
-**Detection Output:**
-```markdown
-🚀 **Starting work on PRD [X]** ([Feature Name])
-- Branch: `feature/prd-[X]-[feature-name]` ✅
-- PRD file: `prds/[X]-[feature-name].md` ✅
-- Current status: Ready for implementation ✅
-```
+Once the user provides the PRD number, proceed to load and validate that specific PRD.
 
 ## Step 2: PRD Readiness Validation
 
@@ -104,6 +83,8 @@ git push -u origin feature/prd-[issue-id]-[feature-name]
 - **Mark PRD as "In Progress"**: Update PRD status section
 - **Create implementation log**: Add initial work log entry with start date
 - **Set up progress tracking**: Identify key milestones for progress updates
+- **✅ CRITICAL: Update milestone checkboxes**: As you complete each implementation milestone in the PRD, immediately mark the corresponding checkbox as [x] completed
+- **Commit milestone updates**: Include PRD milestone updates in your commits to maintain accurate progress tracking
 
 ## Step 4: Identify Implementation Starting Point
 
@@ -167,6 +148,12 @@ If confirmed, provide:
 - **Commit initial setup**: Make initial commit with branch and any setup changes
 - **Documentation updates**: Add PRD traceability comments to any docs being implemented
 
+### Ongoing PRD Maintenance During Implementation
+Throughout the implementation process:
+- **After completing any milestone**: Immediately update the corresponding checkbox in the PRD file from `[ ]` to `[x]`
+- **Update work log**: Add entries documenting what was accomplished
+- **Keep status current**: Update the PRD status section to reflect current implementation state
+
 ## Success Criteria
 
 This command should:

package/shared-prompts/prds-get.md

@@ -22,14 +22,25 @@ Fetch all open GitHub issues from this project that have the 'PRD' label.
    - Direct link to the issue
    - PRD file link (if available in issue description)
 
-3. **Priority Analysis**: If multiple PRDs exist, help identify:
-   - Which PRDs are most recently updated
-   - Which PRDs have active work in progress
-   - Which PRDs might be blocked or stalled
-
-4. **Next Steps Suggestion**: Based on the PRD list, suggest logical next actions:
-   - Which PRD to work on next
-   - PRDs that need attention or updates
-   - Opportunities for parallel work
+3. **Meaningful Categorization**: Group PRDs by their actual purpose and impact, not generic labels:
+   - **Architecture & Infrastructure**: Core system changes, API designs, major refactors
+   - **User Experience**: Features that directly impact how users interact with the system
+   - **Developer Experience**: Tools, workflows, testing, documentation that help developers
+   - **AI & Intelligence**: Machine learning, AI-powered features, recommendation engines
+   - **Operations & Monitoring**: Deployment, scaling, observability, performance
+   - **Integration & Extensibility**: Third-party integrations, plugin systems, APIs
+   
+   Each category should briefly explain what the PRDs in that group will accomplish for users or the system.
+
+4. **Priority Analysis**: If multiple PRDs exist, help identify:
+   - Which PRDs are most recently updated or have active discussion
+   - Which PRDs have dependencies on other PRDs
+   - Which PRDs are foundational vs. incremental improvements
+   - Which PRDs might be blocked or need clarification
+
+5. **Next Steps Suggestion**: Based on the PRD list, suggest logical next actions:
+   - Which PRD to work on next based on dependencies and impact
+   - PRDs that need attention, updates, or clarification
+   - Opportunities for parallel work on independent PRDs
 
 This provides a complete view of all active product requirements and helps with project planning and prioritization.

package/dist/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -1,51 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_js_1 = require("./core/index.js");
-const cli_js_1 = require("./interfaces/cli.js");
-function isHelpCommand(argv) {
-    return argv.includes('--help') || argv.includes('-h') ||
-        argv.includes('help') || argv.includes('--version') ||
-        argv.includes('-v') || argv.length <= 2;
-}
-async function main() {
-    try {
-        // Create CLI interface first (without cluster connection)
-        const cli = new cli_js_1.CliInterface();
-        // If it's a help or version command, run immediately without cluster
-        if (isHelpCommand(process.argv)) {
-            await cli.run(process.argv);
-            return;
-        }
-        // For other commands, initialize cluster connection
-        const kubeconfigIndex = process.argv.findIndex(arg => arg === '--kubeconfig');
-        const kubeconfigPath = kubeconfigIndex !== -1 && kubeconfigIndex + 1 < process.argv.length
-            ? process.argv[kubeconfigIndex + 1]
-            : undefined;
-        const dotAI = new index_js_1.DotAI({
-            kubernetesConfig: kubeconfigPath
-        });
-        await dotAI.initialize();
-        // Set the initialized agent and run the command
-        cli.setDotAI(dotAI);
-        await cli.run(process.argv);
-    }
-    catch (error) {
-        process.stderr.write(`Failed to start DevOps AI Toolkit CLI: ${error.message}\n`);
-        // Provide troubleshooting guidance for cluster connection issues
-        if (error.message.includes('No active cluster') ||
-            error.message.includes('connection refused') ||
-            error.message.includes('kubeconfig')) {
-            process.stderr.write(`\nTroubleshooting steps:\n`);
-            process.stderr.write(`- Run 'kubectl cluster-info' to verify cluster connectivity\n`);
-            process.stderr.write(`- Check your kubeconfig with 'kubectl config view'\n`);
-            process.stderr.write(`- Verify cluster endpoint accessibility\n`);
-        }
-        process.exit(1);
-    }
-}
-main().catch(error => {
-    // Use process.stderr.write instead of console.error to avoid ESLint warnings
-    process.stderr.write(`Unexpected error: ${error}\n`);
-    process.exit(1);
-});

package/dist/interfaces/cli.d.ts

@@ -1,75 +0,0 @@
-/**
- * CLI Interface Module
- *
- * Command-line interface for dot-ai
- */
-import { DotAI } from '../core';
-export interface CliResult {
-    success: boolean;
-    data?: any;
-    error?: string;
-    warnings?: string[];
-    _rawFormat?: boolean;
-}
-export interface ParsedArguments {
-    command: string;
-    options: Record<string, any>;
-}
-export interface CliConfig {
-    defaultOutput?: string;
-    verboseMode?: boolean;
-    outputFile?: string;
-    quietMode?: boolean;
-}
-export declare class CliInterface {
-    private dotAI?;
-    private program;
-    private config;
-    private logger;
-    constructor(dotAI?: DotAI, config?: CliConfig);
-    setDotAI(dotAI: DotAI): void;
-    private ensureDotAI;
-    private getPackageInfo;
-    private setupCommands;
-    getCommands(): string[];
-    getSubcommands(): string[];
-    getHelp(): Promise<string>;
-    getCommandHelp(commandName: string): Promise<string>;
-    parseArguments(args: string[]): Promise<ParsedArguments>;
-    private getValidOptionsForCommand;
-    executeCommand(command: string, options?: Record<string, any>): Promise<CliResult>;
-    private handleStatusCommand;
-    private handleLearnCommand;
-    private handleRecommendCommand;
-    private handleChooseSolutionCommand;
-    private handleAnswerQuestionCommand;
-    private handleGenerateManifestsCommand;
-    private handleDeployManifestsCommand;
-    private handleTestDocsCommand;
-    continueWorkflow(workflowId: string, input: {
-        responses: Record<string, any>;
-    }): Promise<CliResult>;
-    formatOutput(result: CliResult, format: string): string;
-    private formatAsTable;
-    private outputResult;
-    /**
-     * Process global options and update config
-     */
-    private processGlobalOptions;
-    private handleError;
-    /**
-     * Show progress message to user during long-running operations
-     */
-    private showProgress;
-    /**
-     * Clear progress indicators
-     */
-    private clearProgress;
-    /**
-     * Find best solutions with detailed progress feedback
-     */
-    private findBestSolutionsWithProgress;
-    run(args?: string[]): Promise<void>;
-}
-export default CliInterface;
-//# sourceMappingURL=cli.d.ts.map

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

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

@@ -1,844 +0,0 @@
-"use strict";
-/**
- * CLI Interface Module
- *
- * Command-line interface for dot-ai
- */
-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;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CliInterface = void 0;
-const commander_1 = require("commander");
-const yaml = __importStar(require("js-yaml"));
-const cli_table3_1 = __importDefault(require("cli-table3"));
-const recommend_1 = require("../tools/recommend");
-const choose_solution_1 = require("../tools/choose-solution");
-const answer_question_1 = require("../tools/answer-question");
-const generate_manifests_1 = require("../tools/generate-manifests");
-const deploy_manifests_1 = require("../tools/deploy-manifests");
-const error_handling_1 = require("../core/error-handling");
-const fs_1 = require("fs");
-const path_1 = require("path");
-class CliInterface {
-    dotAI;
-    program;
-    config;
-    logger;
-    constructor(dotAI, config = {}) {
-        this.dotAI = dotAI;
-        this.config = config;
-        this.program = new commander_1.Command();
-        this.logger = new error_handling_1.ConsoleLogger('CLI');
-        this.program.name('dot-ai').description('AI-powered Kubernetes deployment agent');
-        // Add global options that apply to all commands
-        this.program
-            .option('--kubeconfig <path>', 'Path to kubeconfig file (overrides KUBECONFIG env var and default location)')
-            .option('--verbose', 'Enable verbose output globally')
-            .option('--output-file <path>', 'Write clean formatted output to file (respects --output format)')
-            .option('--quiet', 'Suppress tool registration and info logs');
-        this.setupCommands();
-    }
-    setDotAI(dotAI) {
-        this.dotAI = dotAI;
-    }
-    ensureDotAI() {
-        if (!this.dotAI) {
-            throw new Error('Cluster connection required. Please ensure your kubeconfig is valid and cluster is accessible.');
-        }
-        return this.dotAI;
-    }
-    getPackageInfo() {
-        try {
-            const packagePath = (0, path_1.join)(__dirname, '../../package.json');
-            const packageJson = JSON.parse((0, fs_1.readFileSync)(packagePath, 'utf8'));
-            return { name: packageJson.name, version: packageJson.version };
-        }
-        catch (error) {
-            return { name: '@vfarcic/dot-ai', version: '0.1.0' }; // fallback
-        }
-    }
-    setupCommands() {
-        const { name, version } = this.getPackageInfo();
-        this.program
-            .name('dot-ai')
-            .description('Kubernetes application deployment agent with AI-powered orchestration')
-            .version(version, '-v, --version', 'output the version number');
-        // Add custom help with installation and usage examples
-        this.program.addHelpText('after', `
-
-Installation:
-  npm install -g ${name}        Install globally
-  npx ${name} <command>         Run without installing
-
-Examples:
-  npx ${name} recommend --intent "deploy my Node.js app"
-  npx ${name} status --deployment my-app
-  npx ${name} learn --pattern microservice
-  
-For more help on specific commands, use:
-  npx ${name} help <command>
-`);
-        // Status command
-        this.program
-            .command('status')
-            .description('Check deployment status')
-            .option('--deployment <id>', 'Deployment/workflow ID to check')
-            .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);
-            }
-            const result = await this.executeCommand('status', options);
-            this.outputResult(result, options.output || this.config.defaultOutput || 'json', this.config.outputFile);
-        });
-        // Learn command
-        this.program
-            .command('learn')
-            .description('Show learned deployment patterns and recommendations')
-            .option('--pattern <type>', 'Filter by pattern type')
-            .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);
-            }
-            const result = await this.executeCommand('learn', options);
-            this.outputResult(result, options.output || this.config.defaultOutput || 'json', this.config.outputFile);
-        });
-        // Recommend command
-        this.program
-            .command('recommend')
-            .description('Get AI-powered Kubernetes resource recommendations based on your intent')
-            .requiredOption('--intent <description>', 'Describe what you want to deploy or accomplish')
-            .option('--session-dir <path>', 'Directory to store solution files (defaults to DOT_AI_SESSION_DIR env var)')
-            .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);
-            }
-            const result = await this.executeCommand('recommend', options);
-            this.outputResult(result, options.output || this.config.defaultOutput || 'json', this.config.outputFile);
-        });
-        // Choose Solution command
-        this.program
-            .command('choose-solution')
-            .description('Select a solution by ID and return its questions for configuration')
-            .requiredOption('--solution-id <id>', 'Solution ID to choose (e.g., sol_2025-07-01T154349_1e1e242592ff)')
-            .requiredOption('--session-dir <path>', 'Directory containing solution files')
-            .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);
-            }
-            const result = await this.executeCommand('chooseSolution', options);
-            this.outputResult(result, options.output || this.config.defaultOutput || 'json', this.config.outputFile);
-        });
-        // Answer Question command
-        this.program
-            .command('answer-question')
-            .description('Process user answers and return remaining questions or completion status')
-            .requiredOption('--solution-id <id>', 'Solution ID to update (e.g., sol_2025-07-01T154349_1e1e242592ff)')
-            .requiredOption('--session-dir <path>', 'Directory containing solution files')
-            .requiredOption('--answers <json>', 'User answers as JSON object')
-            .requiredOption('--stage <stage>', 'Configuration stage (required, basic, advanced, open)')
-            .option('--done', 'Set when providing final open question answer', false)
-            .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);
-            // Parse answers JSON
-            try {
-                options.answers = JSON.parse(options.answers);
-            }
-            catch (error) {
-                console.error('Error: Invalid JSON in --answers parameter');
-                process.exit(1);
-            }
-            // 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);
-            }
-            const result = await this.executeCommand('answerQuestion', options);
-            this.outputResult(result, options.output || this.config.defaultOutput || 'json', this.config.outputFile);
-        });
-        // Generate Manifests command
-        this.program
-            .command('generate-manifests')
-            .description('Generate Kubernetes manifests from solution configuration using AI')
-            .requiredOption('--solution-id <id>', 'Solution ID to generate manifests for (e.g., sol_2025-07-01T154349_1e1e242592ff)')
-            .requiredOption('--session-dir <path>', 'Directory containing solution files')
-            .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);
-            }
-            const result = await this.executeCommand('generateManifests', options);
-            this.outputResult(result, options.output || this.config.defaultOutput || 'json', this.config.outputFile);
-        });
-        // Deploy Manifests command
-        this.program
-            .command('deploy-manifests')
-            .description('Deploy Kubernetes manifests from generated solution')
-            .requiredOption('--solution-id <id>', 'Solution ID to deploy')
-            .requiredOption('--session-dir <path>', 'Session directory path')
-            .option('--timeout <seconds>', 'Deployment timeout in seconds', '30')
-            .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);
-            }
-            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
-    }
-    getCommands() {
-        return ['dot-ai'];
-    }
-    getSubcommands() {
-        return this.program.commands.map(cmd => cmd.name());
-    }
-    async getHelp() {
-        const { name } = this.getPackageInfo();
-        const basicHelp = this.program.helpInformation();
-        const customHelp = `
-
-Installation:
-  npm install -g ${name}        Install globally
-  npx ${name} <command>         Run without installing
-
-Examples:
-  npx ${name} recommend --intent "deploy my Node.js app"
-  npx ${name} status --deployment my-app
-  npx ${name} learn --pattern microservice
-  
-For more help on specific commands, use:
-  npx ${name} help <command>
-`;
-        return basicHelp + customHelp;
-    }
-    async getCommandHelp(commandName) {
-        const command = this.program.commands.find(cmd => cmd.name() === commandName);
-        if (!command) {
-            throw new Error(`Unknown command: ${commandName}`);
-        }
-        return command.helpInformation();
-    }
-    async parseArguments(args) {
-        if (args.length === 0) {
-            throw new Error('No command provided');
-        }
-        const commandName = args[0];
-        const validCommands = this.getSubcommands();
-        if (!validCommands.includes(commandName)) {
-            throw new Error(`Unknown command: ${commandName}`);
-        }
-        // Validate options based on command
-        const options = {};
-        for (let i = 1; i < args.length; i += 2) {
-            const option = args[i];
-            const value = args[i + 1];
-            if (!option.startsWith('--')) {
-                throw new Error(`Invalid option format: ${option}`);
-            }
-            const optionName = option.substring(2);
-            // Validate known options for each command
-            const validOptions = this.getValidOptionsForCommand(commandName);
-            if (!validOptions.includes(optionName)) {
-                throw new Error(`Unknown option: ${option}`);
-            }
-            // Validate specific option values
-            if (optionName === 'output' && value && !['json', 'yaml', 'table'].includes(value)) {
-                throw new Error('Invalid output format. Supported: json, yaml, table');
-            }
-            options[optionName] = value || true;
-        }
-        // Check required options
-        // (no required option checks needed for current commands)
-        return {
-            command: commandName,
-            options
-        };
-    }
-    getValidOptionsForCommand(command) {
-        const commonOptions = ['output', 'verbose'];
-        switch (command) {
-            case 'discover':
-                return [...commonOptions, 'cluster', 'remember'];
-            case 'status':
-                return [...commonOptions, 'deployment'];
-            case 'learn':
-                return [...commonOptions, 'pattern'];
-            case 'recommend':
-                return [...commonOptions, 'intent', 'session-dir'];
-            case 'chooseSolution':
-                return [...commonOptions, 'solution-id', 'session-dir'];
-            case 'answerQuestion':
-                return [...commonOptions, 'solution-id', 'session-dir', 'stage', 'answers', 'done'];
-            case 'generateManifests':
-                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;
-        }
-    }
-    async executeCommand(command, options = {}) {
-        try {
-            // Only initialize DotAI for commands that need cluster access
-            if (command !== 'chooseSolution' && command !== 'answerQuestion' && command !== 'generateManifests' && command !== 'testDocs') {
-                await this.ensureDotAI().initialize();
-            }
-            switch (command) {
-                case 'status':
-                    return await this.handleStatusCommand(options);
-                case 'learn':
-                    return await this.handleLearnCommand(options);
-                case 'recommend':
-                    return await this.handleRecommendCommand(options);
-                case 'chooseSolution':
-                    return await this.handleChooseSolutionCommand(options);
-                case 'answerQuestion':
-                    return await this.handleAnswerQuestionCommand(options);
-                case 'generateManifests':
-                    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 {
-                        success: false,
-                        error: `Unknown command: ${command}`
-                    };
-            }
-        }
-        catch (error) {
-            return this.handleError(error, command);
-        }
-    }
-    async handleStatusCommand(options) {
-        try {
-            const phase = this.ensureDotAI().workflow.getCurrentPhase();
-            return {
-                success: true,
-                data: {
-                    workflowId: options.deployment,
-                    phase,
-                    status: 'active'
-                }
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: `Status check failed: ${error.message}`
-            };
-        }
-    }
-    async handleLearnCommand(options) {
-        try {
-            const recommendations = await this.ensureDotAI().memory.getRecommendations(options.pattern || 'deployment', {});
-            return {
-                success: true,
-                data: {
-                    recommendations,
-                    patternType: options.pattern || 'deployment'
-                }
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: `Learning retrieval failed: ${error.message}`
-            };
-        }
-    }
-    async handleRecommendCommand(options) {
-        try {
-            // Show progress for long-running AI operations
-            this.showProgress('🔍 Analyzing your intent and discovering cluster resources...');
-            // Prepare arguments for the recommend tool including session directory
-            const toolArgs = {
-                intent: options.intent,
-                sessionDir: options.sessionDir // This will be passed to our tool's getSessionDirectory function
-            };
-            this.showProgress('🤖 AI is analyzing resources and generating solutions...');
-            // Execute the recommend tool directly
-            const requestId = `cli_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-            const result = await (0, recommend_1.handleRecommendTool)(toolArgs, this.ensureDotAI(), this.logger, requestId);
-            this.clearProgress();
-            // Parse the tool result
-            const responseData = JSON.parse(result.content[0].text);
-            return {
-                success: true,
-                data: responseData
-            };
-        }
-        catch (error) {
-            // Give a moment for user to see progress before clearing
-            await new Promise(resolve => setTimeout(resolve, 1000));
-            this.clearProgress(); // Clear progress indicators on error
-            return {
-                success: false,
-                error: `AI-powered recommendations failed: ${error.message}`
-            };
-        }
-    }
-    async handleChooseSolutionCommand(options) {
-        try {
-            // Show progress for file operations
-            this.showProgress('📋 Loading solution and extracting questions...');
-            // Prepare arguments for the chooseSolution tool
-            const toolArgs = {
-                solutionId: options.solutionId,
-                sessionDir: options.sessionDir
-            };
-            // Execute the chooseSolution tool directly
-            const requestId = `cli_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-            const result = await (0, choose_solution_1.handleChooseSolutionTool)(toolArgs, 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) {
-            // Give a moment for user to see progress before clearing
-            await new Promise(resolve => setTimeout(resolve, 1000));
-            this.clearProgress(); // Clear progress indicators on error
-            return {
-                success: false,
-                error: `Choose solution failed: ${error.message}`
-            };
-        }
-    }
-    async handleAnswerQuestionCommand(options) {
-        try {
-            // Show progress for file operations
-            this.showProgress('📝 Processing answers and updating solution...');
-            // Prepare arguments for the answerQuestion tool
-            const toolArgs = {
-                solutionId: options.solutionId,
-                sessionDir: options.sessionDir,
-                stage: options.stage,
-                answers: options.answers,
-                done: options.done || false
-            };
-            // Execute the answerQuestion tool directly
-            const requestId = `cli_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-            const result = await (0, answer_question_1.handleAnswerQuestionTool)(toolArgs, 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) {
-            // Give a moment for user to see progress before clearing
-            await new Promise(resolve => setTimeout(resolve, 1000));
-            this.clearProgress(); // Clear progress indicators on error
-            return {
-                success: false,
-                error: `Answer question failed: ${error.message}`
-            };
-        }
-    }
-    async handleGenerateManifestsCommand(options) {
-        try {
-            // Show progress for manifest generation
-            this.showProgress('🤖 Generating Kubernetes manifests with AI...');
-            // Prepare arguments for the generateManifests tool
-            const toolArgs = {
-                solutionId: options.solutionId,
-                sessionDir: options.sessionDir
-            };
-            // Execute the generateManifests tool directly
-            const requestId = `cli_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-            const result = await (0, generate_manifests_1.handleGenerateManifestsTool)(toolArgs, this.dotAI, this.logger, requestId);
-            this.clearProgress();
-            // Parse the tool result
-            const responseData = JSON.parse(result.content[0].text);
-            return {
-                success: true,
-                data: responseData
-            };
-        }
-        catch (error) {
-            // Give a moment for user to see progress before clearing
-            await new Promise(resolve => setTimeout(resolve, 1000));
-            this.clearProgress(); // Clear progress indicators on error
-            return {
-                success: false,
-                error: `Manifest generation failed: ${error.message}`
-            };
-        }
-    }
-    async handleDeployManifestsCommand(options) {
-        try {
-            // Show progress for deployment
-            this.showProgress('🚀 Deploying Kubernetes manifests...');
-            // Prepare arguments for the deployManifests tool
-            const toolArgs = {
-                solutionId: options.solutionId,
-                timeout: parseInt(options.timeout) || 30
-            };
-            // Execute the deployManifests tool directly
-            const requestId = `cli_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-            const result = await (0, deploy_manifests_1.handleDeployManifestsTool)(toolArgs, this.ensureDotAI(), 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(); // Clear progress indicators on error
-            return {
-                success: false,
-                error: `Manifest deployment failed: ${error.message}`
-            };
-        }
-    }
-    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) {
-        try {
-            await this.ensureDotAI().workflow.transitionTo('Validation');
-            const claudeResponse = await this.ensureDotAI().claude.processUserInput(`Continue workflow ${workflowId} with responses: ${JSON.stringify(input.responses)}`);
-            return {
-                success: true,
-                data: claudeResponse
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: `Workflow continuation failed: ${error.message}`
-            };
-        }
-    }
-    formatOutput(result, format) {
-        // Handle raw format for commands that need it
-        const isRawFormat = result._rawFormat;
-        if (isRawFormat) {
-            switch (format) {
-                case 'json':
-                    return JSON.stringify(result.data, null, 2);
-                case 'yaml':
-                    return yaml.dump(result.data);
-                case 'table':
-                    return this.formatAsTable({ success: true, data: result.data });
-                default:
-                    return JSON.stringify(result.data, null, 2);
-            }
-        }
-        // Standard CLI format for other commands
-        switch (format) {
-            case 'json':
-                return JSON.stringify(result, null, 2);
-            case 'yaml':
-                return yaml.dump(result);
-            case 'table':
-                return this.formatAsTable(result);
-            default:
-                return JSON.stringify(result, null, 2);
-        }
-    }
-    formatAsTable(result) {
-        if (!result.success) {
-            const table = new cli_table3_1.default({
-                head: ['Status', 'Error'],
-                colWidths: [20, 60]
-            });
-            table.push(['Failed', result.error || 'Unknown error']);
-            return table.toString();
-        }
-        // Format data as table based on content
-        if (result.data && (result.data.resources || result.data.crds)) {
-            const table = new cli_table3_1.default({
-                head: ['Resource Type', 'Category'],
-                colWidths: [40, 20]
-            });
-            // Add discovered resources
-            if (result.data.resources && result.data.resources.resources) {
-                result.data.resources.resources.forEach((resource) => {
-                    const category = resource.group === '' ? 'Core' : resource.group;
-                    table.push([resource.kind, category]);
-                });
-            }
-            // Add custom resources (CRDs) - handle both string and object formats
-            if (result.data.crds && Array.isArray(result.data.crds)) {
-                result.data.crds.forEach((crd) => {
-                    const crdName = typeof crd === 'string' ? crd : crd.name;
-                    table.push([crdName, 'Custom']);
-                });
-            }
-            return table.toString();
-        }
-        // Generic table format
-        const table = new cli_table3_1.default({
-            head: ['Property', 'Value'],
-            colWidths: [30, 50]
-        });
-        if (result.data) {
-            Object.entries(result.data).forEach(([key, value]) => {
-                table.push([key, JSON.stringify(value)]);
-            });
-        }
-        return table.toString();
-    }
-    outputResult(result, format, outputFile) {
-        const output = this.formatOutput(result, format);
-        if (outputFile) {
-            // Write clean output to file
-            const fs = require('fs');
-            const path = require('path');
-            // Ensure directory exists
-            const dir = path.dirname(outputFile);
-            if (!fs.existsSync(dir)) {
-                fs.mkdirSync(dir, { recursive: true });
-            }
-            fs.writeFileSync(outputFile, output);
-        }
-        else {
-            // Write to stdout
-            process.stdout.write(`${output}\n`);
-        }
-        if (!result.success) {
-            process.exit(1);
-        }
-    }
-    /**
-     * Process global options and update config
-     */
-    processGlobalOptions(options) {
-        if (options.verbose !== undefined) {
-            this.config.verboseMode = options.verbose;
-        }
-        if (options.outputFile !== undefined) {
-            this.config.outputFile = options.outputFile;
-        }
-        if (options.quiet !== undefined) {
-            this.config.quietMode = options.quiet;
-        }
-    }
-    handleError(error, _command) {
-        this.clearProgress(); // Clear any progress indicators on error
-        let errorMessage = error.message;
-        // Provide helpful error messages for common issues
-        if (errorMessage.includes('ENOTFOUND') || errorMessage.includes('connection')) {
-            errorMessage = 'Cannot connect to Kubernetes cluster. Check your kubeconfig and cluster status.';
-        }
-        else if (errorMessage.includes('Connection failed')) {
-            errorMessage = `Failed to initialize DevOps AI Toolkit: ${errorMessage}`;
-        }
-        return {
-            success: false,
-            error: errorMessage
-        };
-    }
-    /**
-     * Show progress message to user during long-running operations
-     */
-    showProgress(message) {
-        // Only show progress if output is going to console (not when piped or in JSON mode)
-        if (process.stdout.isTTY) {
-            process.stderr.write(`\r\x1b[K${message}`);
-        }
-    }
-    /**
-     * Clear progress indicators
-     */
-    clearProgress() {
-        if (process.stdout.isTTY) {
-            process.stderr.write('\r\x1b[K');
-        }
-    }
-    /**
-     * Find best solutions with detailed progress feedback
-     */
-    async findBestSolutionsWithProgress(recommender, intent, discoverResourcesFn, explainResourceFn) {
-        this.showProgress('🤖 AI is analyzing your intent...');
-        // Start a timer to show elapsed time
-        const startTime = Date.now();
-        const progressInterval = setInterval(() => {
-            const elapsed = Math.floor((Date.now() - startTime) / 1000);
-            this.showProgress(`🤖 AI analysis in progress... (${elapsed}s)`);
-        }, 3000);
-        try {
-            // The ResourceRecommender handles the three phases internally:
-            // 1. Resource discovery and selection
-            // 2. Schema fetching and ranking  
-            // 3. Question generation
-            const solutions = await recommender.findBestSolutions(intent, discoverResourcesFn, explainResourceFn);
-            clearInterval(progressInterval);
-            return solutions;
-        }
-        catch (error) {
-            clearInterval(progressInterval);
-            throw error;
-        }
-    }
-    // CLI entry point
-    async run(args = process.argv) {
-        try {
-            await this.program.parseAsync(args);
-        }
-        catch (error) {
-            const result = this.handleError(error, 'general');
-            this.outputResult(result, 'json');
-            process.exit(1);
-        }
-    }
-}
-exports.CliInterface = CliInterface;
-// Export for CLI entry point
-exports.default = CliInterface;