@gkganesh12/codecraft-cli 1.0.1

package/README.md

@@ -0,0 +1,99 @@
+# CodeCraft CLI 🚀
+
+> **AI Governance & Assistant CLI for Developers**
+> Manage your project's architecture, planning, and code quality with an AI-powered CLI.
+
+CodeCraft is a next-generation CLI that brings LLM-powered reasoning to your terminal. It acts as a Project Manager, Architect, and QA Lead, helping you build software faster and with higher quality.
+
+## ✨ Features
+
+- **Interactive REPL**: A "Claude Code" style interactive shell with persistent context.
+- **Role-Based AI**: Switch between personas (PM, Architect, Backend/Frontend Developer, QA).
+- **Slash Commands**: Trigger workflows effortlessly (`/plan`, `/code`, `/verify`, `/doctor`).
+- **Scope Guard**: Prevents AI from modifying files outside the allowed scope.
+- **Rule Engine**: Enforces project-specific architectural rules.
+
+## 📦 Installation
+
+```bash
+npm install -g @gkganesh12/codecraft-cli
+```
+
+## 🚀 Quick Start
+
+1. **Initialize CodeCraft** in your project:
+   ```bash
+   codecraft init
+   ```
+
+2. **Start the Interactive Mode**:
+   ```bash
+   codecraft
+   ```
+   You will see the `CodeCraft >` prompt.
+
+3. **Try a Command**:
+   ```text
+   /plan "Create a user authentication API with JWT"
+   ```
+
+## 🛠️ Usage
+
+### Interactive Commands (REPL)
+
+| Command | Description |
+| :--- | :--- |
+| `/init` | Initialize CodeCraft in the current directory. |
+| `/plan <task>` | Create a detailed implementation plan using the **Project Manager** persona. |
+| `/architect` | Review the current plan against architecture rules using the **Architect** persona. |
+| `/code` | Generate code based on the approved plan using **Developer** personas. |
+| `/verify` | Analyze risks and suggest tests using the **QA** persona. |
+| `/feature <desc>` | Draft a comprehensive Feature Specification. |
+| `/adr <title>` | Create an Architecture Decision Record (ADR). |
+| `/test <file>` | Generate unit tests for a specific file. |
+| `/review <file>` | Perform an AI code review on a file. |
+| `/explain <file>` | Explain complex code in plain English. |
+| `/config` | Manage CLI settings (API keys, models, verbose mode). |
+| `/doctor` | Check environment health and dependencies. |
+| `/update` | Check for the latest version of CodeCraft. |
+
+### CLI Flags
+
+You can also run commands directly without entering the REPL:
+
+```bash
+# Run a specific command
+codecraft doctor
+
+# Run with verbose logging
+codecraft --verbose plan "Refactor the database schema"
+
+# Override the AI model for a session
+codecraft --model gpt-4o code
+```
+
+## ⚙️ Configuration
+
+CodeCraft stores its configuration in `~/.codecraft/config.json`. You can manage it via:
+
+```bash
+codecraft config
+```
+
+Supported settings:
+- **API Key**: Your OpenAI or supported LLM provider key.
+- **Model**: Default model to use (e.g., `gpt-4-turbo`, `gpt-4o`).
+- **Verbose**: Enable detailed debug logs.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please look at the `Docs/` folder for architectural guidelines.
+
+1. Fork the repository.
+2. Create a feature branch.
+3. Commit your changes.
+4. Open a Pull Request.
+
+## 📄 License
+
+MIT

package/dist/commands/adr.d.ts

@@ -0,0 +1,2 @@
+export declare function adrCommand(title: string): Promise<void>;
+//# sourceMappingURL=adr.d.ts.map

package/dist/commands/adr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.d.ts","sourceRoot":"","sources":["../../src/commands/adr.ts"],"names":[],"mappings":"AASA,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,iBAwC7C"}

package/dist/commands/adr.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adrCommand = adrCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const loader_1 = require("../config/loader");
+const client_1 = require("../core/llm/client");
+const roles_1 = require("../core/prompts/roles");
+const ora_1 = __importDefault(require("ora"));
+async function adrCommand(title) {
+    const spinner = (0, ora_1.default)('Drafting ADR...').start();
+    const configLoader = new loader_1.ConfigLoader();
+    const config = configLoader.load();
+    if (!config) {
+        spinner.fail('No config found.');
+        return;
+    }
+    const apiKey = process.env.CODECRAFT_API_KEY || process.env.OPENAI_API_KEY;
+    if (!apiKey) {
+        spinner.fail('API Key missing.');
+        return;
+    }
+    const ai = new client_1.OpenAIAdapter(apiKey);
+    const prompt = [
+        { role: 'system', content: roles_1.ADR_PROMPT },
+        { role: 'user', content: `ADR Title/Context: ${title}` }
+    ];
+    try {
+        const adr = await ai.complete(prompt);
+        // Save to docs/adr/
+        const adrDir = path_1.default.join(process.cwd(), 'docs', 'adr');
+        fs_extra_1.default.ensureDirSync(adrDir);
+        const count = fs_extra_1.default.readdirSync(adrDir).length + 1;
+        const filename = `ADR-${String(count).padStart(3, '0')}.md`;
+        const filePath = path_1.default.join(adrDir, filename);
+        fs_extra_1.default.writeFileSync(filePath, adr);
+        spinner.succeed(`ADR-${String(count).padStart(3, '0')} generated! 🏛️`);
+        console.log(chalk_1.default.dim(`Saved to ${filePath}`));
+    }
+    catch (err) {
+        spinner.fail(`ADR generation failed: ${err.message}`);
+    }
+}
+//# sourceMappingURL=adr.js.map

package/dist/commands/adr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.js","sourceRoot":"","sources":["../../src/commands/adr.ts"],"names":[],"mappings":";;;;;AASA,gCAwCC;AAhDD,kDAA0B;AAC1B,wDAA0B;AAC1B,gDAAwB;AACxB,6CAAgD;AAChD,+CAA8D;AAC9D,iDAAmD;AACnD,8CAAsB;AAEf,KAAK,UAAU,UAAU,CAAC,KAAa;IAC1C,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,CAAC;IAE/C,MAAM,YAAY,GAAG,IAAI,qBAAY,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjC,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjC,OAAO;IACX,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,sBAAa,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,MAAM,GAAgB;QACxB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAU,EAAE;QACvC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,KAAK,EAAE,EAAE;KAC3D,CAAC;IAEF,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,oBAAoB;QACpB,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACvD,kBAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEzB,MAAM,KAAK,GAAG,kBAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC;QAC5D,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE7C,kBAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAEhC,OAAO,CAAC,OAAO,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEnD,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,0BAA0B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;AACL,CAAC"}

package/dist/commands/architect.d.ts

@@ -0,0 +1,2 @@
+export declare function architectCommand(): Promise<void>;
+//# sourceMappingURL=architect.d.ts.map

package/dist/commands/architect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../src/commands/architect.ts"],"names":[],"mappings":"AAWA,wBAAsB,gBAAgB,kBA4ErC"}

package/dist/commands/architect.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.architectCommand = architectCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const loader_1 = require("../config/loader");
+const scope_1 = require("../core/scope");
+const client_1 = require("../core/llm/client");
+const roles_1 = require("../core/prompts/roles");
+const inquirer_1 = __importDefault(require("inquirer"));
+async function architectCommand() {
+    console.log(chalk_1.default.blue('Architect Role: Validating Plan... 🏗️'));
+    // 1. Load Config
+    const configLoader = new loader_1.ConfigLoader();
+    const config = configLoader.load();
+    if (!config) {
+        console.error(chalk_1.default.red('No config found.'));
+        return;
+    }
+    // 2. Load Plan
+    const planPath = path_1.default.join(process.cwd(), 'plan.md');
+    if (!fs_extra_1.default.existsSync(planPath)) {
+        console.error(chalk_1.default.red('No plan.md found. Run "codecraft plan <task>" first.'));
+        return;
+    }
+    const planContent = fs_extra_1.default.readFileSync(planPath, 'utf-8');
+    // 3. Extract Files from Plan (Simple Regex for now, upgrade later)
+    // Match any backticked content that looks like a file path
+    const fileRegex = /`([\w./-]+)`/g;
+    const matches = [...planContent.matchAll(fileRegex)].map(m => m[1]).filter((f) => !!f);
+    const uniqueFiles = [...new Set(matches)]; // Dedup
+    console.log(chalk_1.default.dim(`Found ${uniqueFiles.length} files in plan.`));
+    // 4. Validate Scope
+    const scopeManager = new scope_1.ScopeManager(config);
+    const { allowed, blocked } = scopeManager.validateScope(uniqueFiles);
+    if (blocked.length > 0) {
+        console.log(chalk_1.default.red('\n🚫 Scope Violation: The plan modifies protected files!'));
+        blocked.forEach(f => console.log(chalk_1.default.red(`   - ${f}`)));
+        // Prompt Override
+        const confirm = await inquirer_1.default.prompt([{
+                type: 'confirm',
+                name: 'override',
+                message: 'Do you want to authorize these changes anyway??',
+                default: false
+            }]);
+        if (!confirm.override) {
+            console.log(chalk_1.default.red('Aborted by user.'));
+            return;
+        }
+    }
+    // 5. AI Architect Review
+    console.log(chalk_1.default.blue('🤖 AI Architect is reviewing the plan...'));
+    const apiKey = process.env.CODECRAFT_API_KEY || process.env.OPENAI_API_KEY;
+    if (apiKey) {
+        const ai = new client_1.OpenAIAdapter(apiKey);
+        const prompt = [
+            { role: 'system', content: roles_1.ARCHITECT_ROLE },
+            { role: 'user', content: `Review this implementation plan:\n\n${planContent}` }
+        ];
+        try {
+            const review = await ai.complete(prompt);
+            console.log(chalk_1.default.cyan('\n📋 Architect Review:\n'));
+            console.log(review);
+        }
+        catch (e) {
+            console.error(chalk_1.default.red('AI Review Failed.'));
+        }
+    }
+    else {
+        console.log(chalk_1.default.yellow('Skipping AI Review (No API Key).'));
+    }
+    // 6. Validate Rules
+    // ideally we check if the PLAN violates rules, but that requires semantic analysis of natural language.
+    // For MVP, we assume the Architect Step validates that the plan LOOKS okay.
+    // We can suggest running "codecraft verify" after code is generated.
+    console.log(chalk_1.default.green('\n✅ Architecture Check Passed.'));
+    console.log('You can now run "codecraft code" to execute this plan.');
+}
+//# sourceMappingURL=architect.js.map

package/dist/commands/architect.js.map

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

package/dist/commands/code.d.ts

@@ -0,0 +1,2 @@
+export declare function codeCommand(): Promise<void>;
+//# sourceMappingURL=code.d.ts.map

package/dist/commands/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AASA,wBAAsB,WAAW,kBA8GhC"}

package/dist/commands/code.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codeCommand = codeCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const loader_1 = require("../config/loader");
+const client_1 = require("../core/llm/client");
+const roles_1 = require("../core/prompts/roles");
+const ora_1 = __importDefault(require("ora"));
+async function codeCommand() {
+    const spinner = (0, ora_1.default)('Initializing Code Generator...').start();
+    // 1. Load Config & Plan
+    const configLoader = new loader_1.ConfigLoader();
+    const config = configLoader.load();
+    const planPath = path_1.default.join(process.cwd(), 'plan.md');
+    if (!config || !fs_extra_1.default.existsSync(planPath)) {
+        spinner.fail('Missing config or plan.md');
+        return;
+    }
+    const plan = fs_extra_1.default.readFileSync(planPath, 'utf-8');
+    // 2. Read Files Context (Only those in the plan)
+    // This is the "Scope Guard" in action - we only feed relevant files.
+    // Match any backticked content that looks like a file path
+    const fileRegex = /`([\w./-]+)`/g;
+    const matches = [...plan.matchAll(fileRegex)].map(m => m[1]).filter((f) => !!f);
+    const uniqueFiles = [...new Set(matches)];
+    let fileContext = '';
+    for (const file of uniqueFiles) {
+        if (file && fs_extra_1.default.existsSync(file)) {
+            fileContext += `\n--- ${file} ---\n${fs_extra_1.default.readFileSync(file, 'utf-8')}\n`;
+        }
+    }
+    // 3. AI Generation
+    const apiKey = process.env.CODECRAFT_API_KEY || process.env.OPENAI_API_KEY;
+    if (!apiKey) {
+        spinner.fail('API Key missing.');
+        return;
+    }
+    const ai = new client_1.OpenAIAdapter(apiKey);
+    // Determine Role based on file extensions
+    const frontendExts = ['.tsx', '.jsx', '.css', '.scss', '.html', '.svg'];
+    const backendExts = ['.ts', '.js', '.json', '.prisma', '.sql'];
+    let isFrontend = false;
+    let isBackend = false;
+    for (const file of uniqueFiles) {
+        if (frontendExts.some(ext => file.endsWith(ext)))
+            isFrontend = true;
+        if (backendExts.some(ext => file.endsWith(ext)) && !file.endsWith('.d.ts'))
+            isBackend = true;
+    }
+    // Default to Backend if uncertain, or Frontend if only UI
+    let selectedRole = roles_1.BACKEND_DEV_ROLE;
+    let roleName = 'Backend Developer';
+    if (isFrontend && !isBackend) {
+        selectedRole = roles_1.FRONTEND_DEV_ROLE;
+        roleName = 'Frontend Developer';
+    }
+    else if (isFrontend && isBackend) {
+        // Mixed context - could use a "Full Stack" role, but for now let's stick to the stricter Backend role 
+        // which usually handles the API/Data layer integration that is more critical.
+        // OR we can concat them? No, that confuses the LLM. 
+        // Let's use Backend as the "Lead" who knows APIs.
+        selectedRole = roles_1.BACKEND_DEV_ROLE;
+        roleName = 'Full Stack Developer (Backend Lead)';
+    }
+    console.log(chalk_1.default.blue(`🎭 Activating Persona: ${roleName}`));
+    const prompt = [
+        {
+            role: 'system',
+            content: selectedRole + '\n\nAdditional Instruction: You are executing the plan. Return code blocks as requested.'
+        },
+        {
+            role: 'user',
+            content: `PLAN:\n${plan}\n\nEXISTING CODE:\n${fileContext}`
+        }
+    ];
+    spinner.text = 'Writing code...';
+    try {
+        const response = await ai.complete(prompt);
+        // 4. Apply Changes
+        // Parse the response "### FILE: ..." syntax
+        const fileBlocks = response.split('### FILE: ');
+        for (const block of fileBlocks) {
+            if (!block.trim())
+                continue;
+            const lines = block.split('\n');
+            if (lines.length < 1)
+                continue;
+            const filenameLine = lines[0];
+            const codeParts = lines.slice(1);
+            const filename = filenameLine?.trim();
+            if (!filename)
+                continue;
+            const code = codeParts.join('\n').replace(/```\w+\n/, '').replace(/```$/, '').trim();
+            if (filename && code) {
+                fs_extra_1.default.outputFileSync(path_1.default.join(process.cwd(), filename), code);
+                console.log(chalk_1.default.green(`\nUpdated ${filename}`));
+            }
+        }
+        spinner.succeed('Code generation complete! 🚀');
+        console.log('Run "codecraft verify" to check the results.');
+    }
+    catch (err) {
+        spinner.fail(`Coding Failed: ${err.message}`);
+    }
+}
+//# sourceMappingURL=code.js.map

package/dist/commands/code.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,11 @@
+interface CodeCraftConfig {
+    model?: string;
+    apiKey?: string;
+    systemPrompt?: string;
+    verbose?: boolean;
+}
+export declare function loadGlobalConfig(): CodeCraftConfig;
+export declare function saveGlobalConfig(config: CodeCraftConfig): void;
+export declare function configCommand(args: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAWA,UAAU,eAAe;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,gBAAgB,IAAI,eAAe,CASlD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,QAGvD;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,iBAqEjD"}

package/dist/commands/config.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadGlobalConfig = loadGlobalConfig;
+exports.saveGlobalConfig = saveGlobalConfig;
+exports.configCommand = configCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const inquirer_1 = __importDefault(require("inquirer"));
+// Config path: ~/.codecraft/config.json
+const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.codecraft');
+const CONFIG_PATH = path_1.default.join(CONFIG_DIR, 'config.json');
+function loadGlobalConfig() {
+    if (fs_extra_1.default.existsSync(CONFIG_PATH)) {
+        try {
+            return fs_extra_1.default.readJsonSync(CONFIG_PATH);
+        }
+        catch (e) {
+            return {};
+        }
+    }
+    return {};
+}
+function saveGlobalConfig(config) {
+    fs_extra_1.default.ensureDirSync(CONFIG_DIR);
+    fs_extra_1.default.writeJsonSync(CONFIG_PATH, config, { spaces: 2 });
+}
+async function configCommand(args) {
+    // Usage: config --set key=value or config --get key or config --list
+    const config = loadGlobalConfig();
+    if (args.length === 0) {
+        // Interactive mode
+        console.log(chalk_1.default.bold('Current Configuration:'));
+        console.log(JSON.stringify(config, null, 2));
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'What would you like to do?',
+                choices: ['Edit Configuration', 'Exit']
+            }
+        ]);
+        if (answers.action === 'Edit Configuration') {
+            const editAnswers = await inquirer_1.default.prompt([
+                {
+                    type: 'input',
+                    name: 'apiKey',
+                    message: 'API Key (leave blank to keep current):',
+                    default: config.apiKey
+                },
+                {
+                    type: 'list',
+                    name: 'model',
+                    message: 'Default Model:',
+                    choices: ['gpt-4-turbo', 'gpt-4o', 'claude-3-opus', 'claude-3-sonnet'],
+                    default: config.model || 'gpt-4-turbo'
+                },
+                {
+                    type: 'confirm',
+                    name: 'verbose',
+                    message: 'Enable Verbose Logging?',
+                    default: config.verbose || false
+                }
+            ]);
+            if (editAnswers.apiKey)
+                config.apiKey = editAnswers.apiKey;
+            config.model = editAnswers.model;
+            config.verbose = editAnswers.verbose;
+            saveGlobalConfig(config);
+            console.log(chalk_1.default.green('Configuration saved!'));
+        }
+        return;
+    }
+    // CLI Argument mode (basic implementation)
+    const action = args[0];
+    if (action === '--list') {
+        console.log(JSON.stringify(config, null, 2));
+    }
+    else if (action === '--get' && args[1]) {
+        console.log(config[args[1]] || '(not set)');
+    }
+    else if (action === '--set' && args[1]) {
+        const [key, value] = args[1].split('=');
+        if (key && value) {
+            config[key] = value;
+            saveGlobalConfig(config);
+            console.log(chalk_1.default.green(`${key} set to ${value}`));
+        }
+        else {
+            console.log(chalk_1.default.red('Usage: config --set key=value'));
+        }
+    }
+    else {
+        console.log(chalk_1.default.red('Usage: config [--list | --get <key> | --set <key>=<value>]'));
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function doctorCommand(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAMA,wBAAsB,aAAa,kBA2BlC"}

package/dist/commands/doctor.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorCommand = doctorCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("./config");
+const os_1 = __importDefault(require("os"));
+async function doctorCommand() {
+    console.log(chalk_1.default.bold('🚑 CodeCraft Doctor\n'));
+    const steps = [
+        { name: 'Node.js Version', check: () => process.version, required: '>= v18.0.0' },
+        { name: 'OS Platform', check: () => os_1.default.platform(), required: 'Any' },
+        {
+            name: 'Configuration', check: async () => {
+                const config = (0, config_1.loadGlobalConfig)();
+                return config.apiKey ? 'API Key Configured ✅' : 'API Key Missing ❌';
+            }, required: 'Required for AI features'
+        }
+    ];
+    for (const step of steps) {
+        process.stdout.write(`Compiling ${step.name}... `);
+        try {
+            const result = await Promise.resolve(step.check());
+            console.log(chalk_1.default.green('OK'));
+            console.log(chalk_1.default.dim(`  Value: ${result}`));
+        }
+        catch (e) {
+            console.log(chalk_1.default.red('FAILED'));
+        }
+        await new Promise(r => setTimeout(r, 200)); // Visual pause
+    }
+    console.log(chalk_1.default.blue('\nDiagnostics complete.'));
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":";;;;;AAMA,sCA2BC;AAhCD,kDAA0B;AAE1B,qCAA4C;AAC5C,4CAAoB;AAEb,KAAK,UAAU,aAAa;IAC/B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAG;QACV,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE;QACjF,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,YAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;QACpE;YACI,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;gBACrC,MAAM,MAAM,GAAG,IAAA,yBAAgB,GAAE,CAAC;gBAClC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,mBAAmB,CAAC;YACxE,CAAC,EAAE,QAAQ,EAAE,0BAA0B;SAC1C;KACJ,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe;IAC/D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/commands/explain.d.ts

@@ -0,0 +1,2 @@
+export declare function explainCommand(file: string): Promise<void>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/commands/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AAQA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,iBA+BhD"}

package/dist/commands/explain.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainCommand = explainCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const client_1 = require("../core/llm/client");
+const roles_1 = require("../core/prompts/roles");
+const ora_1 = __importDefault(require("ora"));
+async function explainCommand(file) {
+    const spinner = (0, ora_1.default)('Analyzing code...').start();
+    const filePath = path_1.default.resolve(file);
+    if (!fs_extra_1.default.existsSync(filePath)) {
+        spinner.fail(`File not found: ${file}`);
+        return;
+    }
+    const apiKey = process.env.CODECRAFT_API_KEY || process.env.OPENAI_API_KEY;
+    if (!apiKey) {
+        spinner.fail('API Key missing.');
+        return;
+    }
+    const content = fs_extra_1.default.readFileSync(filePath, 'utf-8');
+    const ai = new client_1.OpenAIAdapter(apiKey);
+    const prompt = [
+        { role: 'system', content: roles_1.EXPLAIN_PROMPT },
+        { role: 'user', content: `Explain this code:\n\n${content}` }
+    ];
+    try {
+        const explanation = await ai.complete(prompt);
+        spinner.stop();
+        console.log(chalk_1.default.bold.hex('#3B82F6')('\n💡 Code Explanation\n'));
+        console.log(explanation);
+    }
+    catch (err) {
+        spinner.fail(`Explanation failed: ${err.message}`);
+    }
+}
+//# sourceMappingURL=explain.js.map

package/dist/commands/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":";;;;;AAQA,wCA+BC;AAtCD,kDAA0B;AAC1B,wDAA0B;AAC1B,gDAAwB;AACxB,+CAA8D;AAC9D,iDAAuD;AACvD,8CAAsB;AAEf,KAAK,UAAU,cAAc,CAAC,IAAY;IAC7C,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC;IAEjD,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,kBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QACxC,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjC,OAAO;IACX,CAAC;IAED,MAAM,OAAO,GAAG,kBAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,IAAI,sBAAa,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,MAAM,GAAgB;QACxB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAc,EAAE;QAC3C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,OAAO,EAAE,EAAE;KAChE,CAAC;IAEF,IAAI,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE7B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;AACL,CAAC"}

package/dist/commands/feature.d.ts

@@ -0,0 +1,2 @@
+export declare function featureCommand(description: string): Promise<void>;
+//# sourceMappingURL=feature.d.ts.map

package/dist/commands/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../src/commands/feature.ts"],"names":[],"mappings":"AASA,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,iBAyCvD"}