agdi 2.7.1 → 2.8.0

package/dist/index.js

@@ -7,7 +7,7 @@ import {
 
 // src/index.ts
 import { Command } from "commander";
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 import ora5 from "ora";
 
 // src/core/llm/index.ts
@@ -287,6 +287,167 @@ var ProjectManager = class {
 // src/core/io/index.ts
 import JSZip from "jszip";
 
+// src/utils/ui.ts
+import chalk from "chalk";
+import gradient from "gradient-string";
+import boxen from "boxen";
+import figlet from "figlet";
+import ora from "ora";
+var THEME = {
+  cyan: "#06b6d4",
+  // Cyan-500
+  purple: "#8b5cf6",
+  // Violet-500
+  red: "#ef4444",
+  // Red-500
+  yellow: "#eab308",
+  // Yellow-500
+  gray: "#71717a",
+  // Zinc-500
+  dim: "#52525b"
+  // Zinc-600
+};
+var brandGradient = gradient([THEME.cyan, THEME.purple]);
+var errorGradient = gradient([THEME.red, "#b91c1c"]);
+var goldGradient = gradient([THEME.yellow, "#fbbf24"]);
+async function renderBanner(version = "v2.6.0") {
+  console.clear();
+  const text = await new Promise((resolve5) => {
+    figlet("AGDI", { font: "Slant" }, (err, data) => {
+      resolve5(data || "AGDI");
+    });
+  });
+  console.log(brandGradient.multiline(text));
+  console.log(chalk.hex(THEME.dim)(`      ${version} [ARCHITECT ONLINE]
+`));
+}
+function renderBox(title, content, style = "info") {
+  let borderColor = THEME.cyan;
+  let titleColor = chalk.cyan;
+  if (style === "success") {
+    borderColor = THEME.cyan;
+  } else if (style === "warning") {
+    borderColor = THEME.yellow;
+    titleColor = chalk.yellow;
+  } else if (style === "error") {
+    borderColor = THEME.red;
+    titleColor = chalk.red;
+  }
+  const box = boxen(content, {
+    title: titleColor.bold(title),
+    padding: 1,
+    margin: 1,
+    borderStyle: "round",
+    borderColor,
+    dimBorder: false,
+    float: "left"
+  });
+  console.log(box);
+}
+function renderAlert(title, message) {
+  console.log("");
+  const box = boxen(chalk.white(message), {
+    title: chalk.red.bold(`\u{1F6E1}\uFE0F  ${title.toUpperCase()}  `),
+    padding: 1,
+    borderStyle: "double",
+    borderColor: "red",
+    textAlignment: "center"
+  });
+  console.log(box);
+  console.log("");
+}
+function printUserMessage(message) {
+  console.log("");
+  console.log(chalk.cyan.bold("\u{1F464} YOU \u203A ") + chalk.white(message));
+  console.log("");
+}
+function printAIMessage(message) {
+  console.log("");
+  console.log(brandGradient.multiline("\u26A1 AGDI \u203A "));
+  console.log(message.trim());
+  console.log("");
+}
+function createSpinner(text) {
+  return ora({
+    text: chalk.hex(THEME.gray)(text),
+    color: "cyan",
+    spinner: "dots",
+    discardStdin: false
+    // Important for allowing interruption if needed
+  });
+}
+function printIter() {
+  console.log(chalk.hex(THEME.dim)("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+}
+var activeReadlineInterface = null;
+function registerActivePrompt(rl) {
+  activeReadlineInterface = rl;
+}
+var flags = {
+  yes: false,
+  headless: false,
+  minimal: false,
+  dryRun: false
+};
+function setFlags(newFlags) {
+  Object.assign(flags, newFlags);
+}
+function safeExit(code = 0) {
+  if (activeReadlineInterface) {
+    try {
+      activeReadlineInterface.close?.();
+      activeReadlineInterface.destroy?.();
+    } catch {
+    }
+    activeReadlineInterface = null;
+  }
+  setImmediate(() => {
+    process.exit(code);
+  });
+  throw new Error("Process exiting");
+}
+async function smartConfirm(message, defaultValue = false) {
+  if (flags.yes || flags.headless || process.env.CI === "true" || process.env.CI === "1") {
+    console.log(chalk.gray(`  [Auto-approved: ${message}]`));
+    return true;
+  }
+  if (!process.stdout.isTTY) {
+    console.warn(chalk.yellow("\u26A0\uFE0F  Non-interactive session detected. Use --yes to approve actions."));
+    return false;
+  }
+  const { confirm: confirm4 } = await import("@inquirer/prompts");
+  return confirm4({ message, default: defaultValue });
+}
+async function smartSelect(message, choices, defaultValue) {
+  if (!process.stdout.isTTY || flags.headless) {
+    const result = defaultValue || choices[0]?.value;
+    if (result) {
+      console.log(chalk.gray(`  [Auto-selected: ${result}]`));
+    }
+    return result || null;
+  }
+  const { select: select5 } = await import("@inquirer/prompts");
+  return select5({ message, choices });
+}
+var ui = {
+  renderBanner,
+  renderBox,
+  renderAlert,
+  printUserMessage,
+  printAIMessage,
+  createSpinner,
+  printIter,
+  brandGradient,
+  THEME,
+  // Safety & Automation
+  safeExit,
+  smartConfirm,
+  smartSelect,
+  setFlags,
+  flags,
+  registerActivePrompt
+};
+
 // src/core/architect/index.ts
 var SYSTEM_PROMPT = `You are Agdi Architect, an expert software architect AI.
 Your job is to generate complete, production-ready React applications.
@@ -294,7 +455,7 @@ Always use TypeScript, Tailwind CSS, and Vite.
 Generate all necessary files including package.json, tsconfig.json, vite.config.ts.
 Make the UI beautiful with modern design patterns.`;
 async function generatePlan(prompt, llm) {
-  const planPrompt = `Create a detailed plan for: ${prompt}
+  let planPrompt = `Create a detailed plan for: ${prompt}
 
 Return a JSON object with:
 {
@@ -306,6 +467,25 @@ Return a JSON object with:
 }
 
 Return ONLY valid JSON, no markdown.`;
+  if (ui.flags.minimal) {
+    planPrompt = `Create a minimal plan for: ${prompt}
+
+CRITICAL: Minimal mode matches user request exactly.
+- If user asks for "hello.ts", generate ONLY "hello.ts".
+- Do NOT scaffold a full React app unless explicitly asked.
+- Do NOT add boilerplate headers/footers.
+
+Return a JSON object with:
+{
+  "name": "minimal-project",
+  "description": "Minimal generation",
+  "files": [{"path": "requested-file.ts", "description": "Requested logic"}],
+  "dependencies": [], 
+  "architecture": "Single file script"
+}
+
+Return ONLY valid JSON.`;
+  }
   const response = await llm.generate(planPrompt, SYSTEM_PROMPT);
   try {
     const jsonMatch = response.text.match(/\{[\s\S]*\}/);
@@ -356,50 +536,52 @@ async function generateApp(prompt, llm, onProgress) {
     const file = await generateFile(fileSpec.path, fileSpec.description, plan, llm);
     files.push(file);
   }
-  onProgress?.("Creating package.json...", "package.json");
-  files.push({
-    path: "package.json",
-    content: JSON.stringify({
-      name: plan.name,
-      version: "0.1.0",
-      type: "module",
-      scripts: {
-        dev: "vite",
-        build: "tsc -b && vite build",
-        preview: "vite preview"
-      },
-      dependencies: {
-        "react": "^18.3.1",
-        "react-dom": "^18.3.1",
-        ...plan.dependencies.reduce((acc, dep) => {
-          if (dep !== "react" && dep !== "react-dom") {
-            acc[dep] = "latest";
-          }
-          return acc;
-        }, {})
-      },
-      devDependencies: {
-        "@types/react": "^18.3.0",
-        "@types/react-dom": "^18.3.0",
-        "@vitejs/plugin-react": "^4.3.0",
-        "autoprefixer": "^10.4.20",
-        "postcss": "^8.4.45",
-        "tailwindcss": "^3.4.10",
-        "typescript": "~5.5.0",
-        "vite": "^5.4.0"
-      }
-    }, null, 2)
-  });
+  if (!ui.flags.minimal) {
+    onProgress?.("Creating package.json...", "package.json");
+    files.push({
+      path: "package.json",
+      content: JSON.stringify({
+        name: plan.name,
+        version: "0.1.0",
+        type: "module",
+        scripts: {
+          dev: "vite",
+          build: "tsc -b && vite build",
+          preview: "vite preview"
+        },
+        dependencies: {
+          "react": "^18.3.1",
+          "react-dom": "^18.3.1",
+          ...plan.dependencies.reduce((acc, dep) => {
+            if (dep !== "react" && dep !== "react-dom") {
+              acc[dep] = "latest";
+            }
+            return acc;
+          }, {})
+        },
+        devDependencies: {
+          "@types/react": "^18.3.0",
+          "@types/react-dom": "^18.3.0",
+          "@vitejs/plugin-react": "^4.3.0",
+          "autoprefixer": "^10.4.20",
+          "postcss": "^8.4.45",
+          "tailwindcss": "^3.4.10",
+          "typescript": "~5.5.0",
+          "vite": "^5.4.0"
+        }
+      }, null, 2)
+    });
+  }
   return { plan, files };
 }
 
 // src/utils/fs.ts
 import fs from "fs-extra";
 import path from "path";
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 
 // src/security/code-firewall.ts
-import chalk from "chalk";
+import chalk2 from "chalk";
 var MALICIOUS_PATTERNS = [
   // ==================== HARDCODED SECRETS ====================
   {
@@ -648,35 +830,35 @@ function shouldBlockCode(result) {
 }
 function displayScanResults(result, filename) {
   if (result.safe) {
-    console.log(chalk.green("\u2705 No malicious patterns detected"));
+    console.log(chalk2.green("\u2705 No malicious patterns detected"));
     return;
   }
-  console.log(chalk.red.bold("\n\u{1F6A8} SECURITY SCAN FAILED"));
+  console.log(chalk2.red.bold("\n\u{1F6A8} SECURITY SCAN FAILED"));
   if (filename) {
-    console.log(chalk.gray(`File: ${filename}`));
+    console.log(chalk2.gray(`File: ${filename}`));
   }
   console.log("");
   const criticals = result.matches.filter((m) => m.severity === "critical");
   const highs = result.matches.filter((m) => m.severity === "high");
   const others = result.matches.filter((m) => m.severity !== "critical" && m.severity !== "high");
   if (criticals.length > 0) {
-    console.log(chalk.red("\u{1F534} CRITICAL:"));
+    console.log(chalk2.red("\u{1F534} CRITICAL:"));
     for (const m of criticals) {
-      console.log(chalk.red(`   Line ${m.line}: ${m.description}`));
-      console.log(chalk.gray(`   Found: ${m.match}`));
+      console.log(chalk2.red(`   Line ${m.line}: ${m.description}`));
+      console.log(chalk2.gray(`   Found: ${m.match}`));
     }
   }
   if (highs.length > 0) {
-    console.log(chalk.yellow("\n\u{1F7E0} HIGH:"));
+    console.log(chalk2.yellow("\n\u{1F7E0} HIGH:"));
     for (const m of highs) {
-      console.log(chalk.yellow(`   Line ${m.line}: ${m.description}`));
-      console.log(chalk.gray(`   Found: ${m.match}`));
+      console.log(chalk2.yellow(`   Line ${m.line}: ${m.description}`));
+      console.log(chalk2.gray(`   Found: ${m.match}`));
     }
   }
   if (others.length > 0) {
-    console.log(chalk.cyan("\n\u{1F7E1} WARNINGS:"));
+    console.log(chalk2.cyan("\n\u{1F7E1} WARNINGS:"));
     for (const m of others) {
-      console.log(chalk.cyan(`   Line ${m.line}: ${m.description}`));
+      console.log(chalk2.cyan(`   Line ${m.line}: ${m.description}`));
     }
   }
   console.log("");
@@ -686,11 +868,11 @@ function validateCodeBeforeWrite(code, filename) {
   if (!result.safe) {
     displayScanResults(result, filename);
     if (shouldBlockCode(result)) {
-      console.log(chalk.red.bold("\u{1F6A8} BLOCKED: Code contains critical security issues"));
-      console.log(chalk.gray("The file will NOT be written to disk.\n"));
+      console.log(chalk2.red.bold("\u{1F6A8} BLOCKED: Code contains critical security issues"));
+      console.log(chalk2.gray("The file will NOT be written to disk.\n"));
       return false;
     } else {
-      console.log(chalk.yellow("\u26A0\uFE0F  Warning: Code contains potential issues but will be written.\n"));
+      console.log(chalk2.yellow("\u26A0\uFE0F  Warning: Code contains potential issues but will be written.\n"));
     }
   }
   return true;
@@ -706,7 +888,7 @@ async function writeProject(project, outputDir) {
     const isSafe = validateCodeBeforeWrite(file.content, file.path);
     if (!isSafe) {
       blockedCount++;
-      console.log(chalk2.red(`\u26D4 BLOCKED: ${file.path}`));
+      console.log(chalk3.red(`\u26D4 BLOCKED: ${file.path}`));
       continue;
     }
     await fs.ensureDir(path.dirname(filePath));
@@ -715,16 +897,16 @@ async function writeProject(project, outputDir) {
   }
   console.log("");
   if (blockedCount > 0) {
-    console.log(chalk2.yellow(`\u26A0\uFE0F  ${blockedCount} file(s) blocked by security scan`));
+    console.log(chalk3.yellow(`\u26A0\uFE0F  ${blockedCount} file(s) blocked by security scan`));
   }
-  console.log(chalk2.green(`\u2705 ${writtenCount} file(s) written successfully`));
+  console.log(chalk3.green(`\u2705 ${writtenCount} file(s) written successfully`));
 }
 
 // src/utils/config.ts
 import fs2 from "fs-extra";
 import path2 from "path";
 import os from "os";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 var CONFIG_DIR = path2.join(os.homedir(), ".agdi");
 var CONFIG_FILE = path2.join(CONFIG_DIR, "config.json");
 var SECURE_FILE_MODE = 384;
@@ -741,11 +923,11 @@ function checkPermissions() {
     }
     const isWorldReadable = (mode & 36) !== 0;
     if (isWorldReadable) {
-      console.log(chalk3.yellow("\n\u26A0\uFE0F  SECURITY WARNING"));
-      console.log(chalk3.gray("Your config file is readable by other users!"));
-      console.log(chalk3.gray(`File: ${CONFIG_FILE}`));
-      console.log(chalk3.gray("Run the following to fix:"));
-      console.log(chalk3.cyan(`  chmod 600 "${CONFIG_FILE}"
+      console.log(chalk4.yellow("\n\u26A0\uFE0F  SECURITY WARNING"));
+      console.log(chalk4.gray("Your config file is readable by other users!"));
+      console.log(chalk4.gray(`File: ${CONFIG_FILE}`));
+      console.log(chalk4.gray("Run the following to fix:"));
+      console.log(chalk4.cyan(`  chmod 600 "${CONFIG_FILE}"
 `));
       return false;
     }
@@ -781,16 +963,16 @@ function saveConfig(config) {
     fs2.writeJsonSync(CONFIG_FILE, config, { spaces: 2 });
     setSecurePermissions();
   } catch (error) {
-    console.error(chalk3.red("Failed to save config:"), error);
+    console.error(chalk4.red("Failed to save config:"), error);
   }
 }
 
 // src/commands/auth.ts
 import { input, select, password } from "@inquirer/prompts";
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 async function login() {
-  console.log(chalk4.cyan.bold("\n\u{1F510} Agdi Authentication\n"));
-  console.log(chalk4.gray("Configure your API key to use Agdi CLI.\n"));
+  console.log(chalk5.cyan.bold("\n\u{1F510} Agdi Authentication\n"));
+  console.log(chalk5.gray("Configure your API key to use Agdi CLI.\n"));
   try {
     const config = loadConfig();
     const provider = await select({
@@ -812,8 +994,8 @@ async function login() {
       config.ollamaUrl = ollamaUrl;
       config.defaultProvider = "ollama";
       saveConfig(config);
-      console.log(chalk4.green("\n\u2705 Ollama configured"));
-      console.log(chalk4.gray(`Server: ${ollamaUrl}
+      console.log(chalk5.green("\n\u2705 Ollama configured"));
+      console.log(chalk5.gray(`Server: ${ollamaUrl}
 `));
       return;
     }
@@ -840,12 +1022,12 @@ async function login() {
     }
     config.defaultProvider = provider;
     saveConfig(config);
-    console.log(chalk4.green(`
+    console.log(chalk5.green(`
 \u2705 ${provider} API key saved securely`));
-    console.log(chalk4.gray("Keys stored in ~/.agdi/config.json\n"));
+    console.log(chalk5.gray("Keys stored in ~/.agdi/config.json\n"));
   } catch (error) {
     if (error.name === "ExitPromptError") {
-      console.log(chalk4.gray("\n\n\u{1F44B} Cancelled.\n"));
+      console.log(chalk5.gray("\n\n\u{1F44B} Cancelled.\n"));
       process.exit(0);
     }
     throw error;
@@ -853,7 +1035,7 @@ async function login() {
 }
 async function showStatus() {
   const config = loadConfig();
-  console.log(chalk4.cyan.bold("\n\u{1F4CA} Authentication Status\n"));
+  console.log(chalk5.cyan.bold("\n\u{1F4CA} Authentication Status\n"));
   const providers = [
     { name: "Gemini", key: config.geminiApiKey },
     { name: "OpenRouter", key: config.openrouterApiKey },
@@ -862,19 +1044,19 @@ async function showStatus() {
     { name: "DeepSeek", key: config.deepseekApiKey }
   ];
   for (const p of providers) {
-    const status = p.key ? chalk4.green("\u2713 Configured") : chalk4.gray("\u2717 Not set");
+    const status = p.key ? chalk5.green("\u2713 Configured") : chalk5.gray("\u2717 Not set");
     console.log(`  ${p.name.padEnd(12)} ${status}`);
   }
-  console.log(chalk4.cyan(`
+  console.log(chalk5.cyan(`
   Default: ${config.defaultProvider || "gemini"}
 `));
-  console.log(chalk4.gray('\u{1F4A1} Tip: Use "agdi auth" to reconfigure\n'));
+  console.log(chalk5.gray('\u{1F4A1} Tip: Use "agdi auth" to reconfigure\n'));
 }
 
 // src/commands/chat.ts
 import { input as input2 } from "@inquirer/prompts";
-import chalk5 from "chalk";
-import ora from "ora";
+import chalk6 from "chalk";
+import ora2 from "ora";
 var SYSTEM_PROMPT2 = `You are Agdi, an elite full-stack software architect and senior engineer with deep expertise across the entire web development stack.
 
 # Core Expertise
@@ -1028,8 +1210,8 @@ When asked to build something:
 
 You build software that works, scales, and follows industry best practices. Every solution is complete, tested, and ready for production deployment.`;
 async function startChat() {
-  console.log(chalk5.cyan.bold("\n\u{1F4AC} Agdi Interactive Mode\n"));
-  console.log(chalk5.gray('Type your coding requests. Type "exit" to quit.\n'));
+  console.log(chalk6.cyan.bold("\n\u{1F4AC} Agdi Interactive Mode\n"));
+  console.log(chalk6.gray('Type your coding requests. Type "exit" to quit.\n'));
   const config = loadConfig();
   let provider;
   let apiKey = "";
@@ -1039,33 +1221,33 @@ async function startChat() {
   } else if (config.openrouterApiKey) {
     provider = "openrouter";
     apiKey = config.openrouterApiKey;
-    console.log(chalk5.gray("Using OpenRouter (100+ models available)\n"));
+    console.log(chalk6.gray("Using OpenRouter (100+ models available)\n"));
   } else if (config.defaultProvider === "puter") {
-    console.log(chalk5.yellow("\u26A0\uFE0F  Puter.com FREE mode requires browser authentication."));
-    console.log(chalk5.gray("For CLI usage, please configure an API key:\n"));
-    console.log(chalk5.cyan("  agdi auth"));
-    console.log(chalk5.gray("\nSupported providers: Gemini, OpenRouter, OpenAI, Anthropic, DeepSeek\n"));
+    console.log(chalk6.yellow("\u26A0\uFE0F  Puter.com FREE mode requires browser authentication."));
+    console.log(chalk6.gray("For CLI usage, please configure an API key:\n"));
+    console.log(chalk6.cyan("  agdi auth"));
+    console.log(chalk6.gray("\nSupported providers: Gemini, OpenRouter, OpenAI, Anthropic, DeepSeek\n"));
     return;
   } else {
-    console.log(chalk5.yellow("\u26A0\uFE0F  No API key configured."));
-    console.log(chalk5.gray('Run "agdi auth" to configure your API key.\n'));
+    console.log(chalk6.yellow("\u26A0\uFE0F  No API key configured."));
+    console.log(chalk6.gray('Run "agdi auth" to configure your API key.\n'));
     return;
   }
-  console.log(chalk5.gray(`Using provider: ${chalk5.cyan(provider)}`));
-  console.log(chalk5.gray("\u2500".repeat(50) + "\n"));
+  console.log(chalk6.gray(`Using provider: ${chalk6.cyan(provider)}`));
+  console.log(chalk6.gray("\u2500".repeat(50) + "\n"));
   const pm = new ProjectManager();
   while (true) {
     const userInput = await input2({
-      message: chalk5.cyan("You:")
+      message: chalk6.cyan("You:")
     });
     if (userInput.toLowerCase() === "exit" || userInput.toLowerCase() === "quit") {
-      console.log(chalk5.gray("\n\u{1F44B} Goodbye!\n"));
+      console.log(chalk6.gray("\n\u{1F44B} Goodbye!\n"));
       break;
     }
     if (!userInput.trim()) {
       continue;
     }
-    const spinner = ora("Thinking...").start();
+    const spinner = ora2("Thinking...").start();
     try {
       const llm = createLLMProvider(provider, { apiKey, model: config.defaultModel });
       if (userInput.toLowerCase().includes("create") || userInput.toLowerCase().includes("build") || userInput.toLowerCase().includes("make")) {
@@ -1076,9 +1258,9 @@ async function startChat() {
         });
         pm.updateFiles(files);
         spinner.succeed("Application generated!");
-        console.log(chalk5.green("\n\u{1F4C1} Files created:"));
+        console.log(chalk6.green("\n\u{1F4C1} Files created:"));
         for (const file of files) {
-          console.log(chalk5.gray(`   - ${file.path}`));
+          console.log(chalk6.gray(`   - ${file.path}`));
         }
         const shouldWrite = await input2({
           message: "Write files to disk? (y/n):",
@@ -1090,38 +1272,38 @@ async function startChat() {
             default: "./generated-app"
           });
           await writeProject(pm.get(), dir);
-          console.log(chalk5.green(`
+          console.log(chalk6.green(`
 \u2705 Files written to ${dir}
 `));
         }
       } else {
         const response = await llm.generate(userInput, SYSTEM_PROMPT2);
         spinner.stop();
-        console.log(chalk5.cyan("\nAgdi: ") + response.text + "\n");
+        console.log(chalk6.cyan("\nAgdi: ") + response.text + "\n");
       }
     } catch (error) {
       if (error.name === "ExitPromptError") {
-        console.log(chalk5.gray("\n\n\u{1F44B} Goodbye!\n"));
+        console.log(chalk6.gray("\n\n\u{1F44B} Goodbye!\n"));
         process.exit(0);
       }
       spinner.fail("Error");
       const errorMessage = error instanceof Error ? error.message : String(error);
       if (errorMessage.includes("429") || errorMessage.includes("quota") || errorMessage.includes("Resource exhausted") || errorMessage.includes("ResourceExhausted")) {
-        console.log(chalk5.yellow("\n\u26A0\uFE0F  API quota exceeded!"));
-        console.log(chalk5.gray("Your API key has run out of credits."));
-        console.log(chalk5.gray("Try: Use a different API key or wait for quota reset.\n"));
+        console.log(chalk6.yellow("\n\u26A0\uFE0F  API quota exceeded!"));
+        console.log(chalk6.gray("Your API key has run out of credits."));
+        console.log(chalk6.gray("Try: Use a different API key or wait for quota reset.\n"));
       } else if (errorMessage.includes("401") || errorMessage.includes("Unauthorized") || errorMessage.includes("Invalid API key")) {
-        console.log(chalk5.red("\n\u{1F511} Invalid API key"));
-        console.log(chalk5.gray("Please reconfigure your API key:"));
-        console.log(chalk5.cyan("  agdi auth\n"));
+        console.log(chalk6.red("\n\u{1F511} Invalid API key"));
+        console.log(chalk6.gray("Please reconfigure your API key:"));
+        console.log(chalk6.cyan("  agdi auth\n"));
       } else if (errorMessage.includes("403") || errorMessage.includes("Forbidden")) {
-        console.log(chalk5.red("\n\u{1F6AB} Access denied"));
-        console.log(chalk5.gray("Your API key doesn't have permission for this operation.\n"));
+        console.log(chalk6.red("\n\u{1F6AB} Access denied"));
+        console.log(chalk6.gray("Your API key doesn't have permission for this operation.\n"));
       } else if (errorMessage.includes("network") || errorMessage.includes("fetch") || errorMessage.includes("ENOTFOUND")) {
-        console.log(chalk5.red("\n\u{1F310} Network error"));
-        console.log(chalk5.gray("Please check your internet connection.\n"));
+        console.log(chalk6.red("\n\u{1F310} Network error"));
+        console.log(chalk6.gray("Please check your internet connection.\n"));
       } else {
-        console.log(chalk5.red("\n" + errorMessage + "\n"));
+        console.log(chalk6.red("\n" + errorMessage + "\n"));
       }
     }
   }
@@ -1129,23 +1311,23 @@ async function startChat() {
 
 // src/commands/run.ts
 import { spawn } from "child_process";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import fs3 from "fs-extra";
 import path3 from "path";
-import ora2 from "ora";
+import ora3 from "ora";
 async function runProject(targetDir) {
   const dir = targetDir || process.cwd();
   const absoluteDir = path3.resolve(dir);
-  console.log(chalk6.cyan.bold("\n\u{1F680} Agdi Run\n"));
+  console.log(chalk7.cyan.bold("\n\u{1F680} Agdi Run\n"));
   if (!fs3.existsSync(absoluteDir)) {
-    console.log(chalk6.red(`\u274C Directory not found: ${absoluteDir}`));
-    console.log(chalk6.gray("Create a project first with: agdi init"));
+    console.log(chalk7.red(`\u274C Directory not found: ${absoluteDir}`));
+    console.log(chalk7.gray("Create a project first with: agdi init"));
     return;
   }
   const packageJsonPath = path3.join(absoluteDir, "package.json");
   if (!fs3.existsSync(packageJsonPath)) {
-    console.log(chalk6.red(`\u274C No package.json found in: ${absoluteDir}`));
-    console.log(chalk6.gray("This doesn't appear to be a Node.js project."));
+    console.log(chalk7.red(`\u274C No package.json found in: ${absoluteDir}`));
+    console.log(chalk7.gray("This doesn't appear to be a Node.js project."));
     return;
   }
   const packageJson = fs3.readJsonSync(packageJsonPath);
@@ -1154,14 +1336,14 @@ async function runProject(targetDir) {
   if (!scripts.dev && scripts.start) {
     runScript = "start";
   } else if (!scripts.dev && !scripts.start) {
-    console.log(chalk6.red('\u274C No "dev" or "start" script found in package.json'));
-    console.log(chalk6.gray('Add a script like: "dev": "vite" or "start": "node index.js"'));
+    console.log(chalk7.red('\u274C No "dev" or "start" script found in package.json'));
+    console.log(chalk7.gray('Add a script like: "dev": "vite" or "start": "node index.js"'));
     return;
   }
   const nodeModulesPath = path3.join(absoluteDir, "node_modules");
   if (!fs3.existsSync(nodeModulesPath)) {
-    console.log(chalk6.yellow("\u{1F4E6} Installing dependencies...\n"));
-    const installSpinner = ora2("Running npm install...").start();
+    console.log(chalk7.yellow("\u{1F4E6} Installing dependencies...\n"));
+    const installSpinner = ora3("Running npm install...").start();
     await new Promise((resolve5, reject) => {
       const install = spawn("npm", ["install"], {
         cwd: absoluteDir,
@@ -1181,11 +1363,11 @@ async function runProject(targetDir) {
     });
     console.log("");
   }
-  console.log(chalk6.green(`\u25B6 Running: npm run ${runScript}`));
-  console.log(chalk6.gray(`  Directory: ${absoluteDir}
+  console.log(chalk7.green(`\u25B6 Running: npm run ${runScript}`));
+  console.log(chalk7.gray(`  Directory: ${absoluteDir}
 `));
-  console.log(chalk6.gray("\u2500".repeat(50)));
-  console.log(chalk6.gray("Press Ctrl+C to stop\n"));
+  console.log(chalk7.gray("\u2500".repeat(50)));
+  console.log(chalk7.gray("Press Ctrl+C to stop\n"));
   const child = spawn("npm", ["run", runScript], {
     cwd: absoluteDir,
     stdio: "inherit",
@@ -1193,12 +1375,12 @@ async function runProject(targetDir) {
   });
   process.on("SIGINT", () => {
     child.kill("SIGINT");
-    console.log(chalk6.gray("\n\n\u{1F44B} Server stopped."));
+    console.log(chalk7.gray("\n\n\u{1F44B} Server stopped."));
     process.exit(0);
   });
   child.on("close", (code) => {
     if (code !== 0) {
-      console.log(chalk6.red(`
+      console.log(chalk7.red(`
 \u274C Process exited with code ${code}`));
     }
     process.exit(code || 0);
@@ -1207,7 +1389,7 @@ async function runProject(targetDir) {
 
 // src/commands/onboarding.ts
 import { select as select2, password as password2 } from "@inquirer/prompts";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 var PROVIDER_MODELS = {
   gemini: [
     { name: "\u26A1 Gemini 2.5 Flash (Fast)", value: "gemini-2.5-flash" },
@@ -1284,10 +1466,10 @@ function getActiveProvider() {
   return null;
 }
 async function runOnboarding() {
-  console.log(chalk7.cyan.bold("\n\u{1F680} Welcome to Agdi!\n"));
-  console.log(chalk7.gray("Let's set up your AI provider in 3 quick steps.\n"));
+  console.log(chalk8.cyan.bold("\n\u{1F680} Welcome to Agdi!\n"));
+  console.log(chalk8.gray("Let's set up your AI provider in 3 quick steps.\n"));
   const config = loadConfig();
-  console.log(chalk7.white.bold("Step 1/3: Select your AI provider\n"));
+  console.log(chalk8.white.bold("Step 1/3: Select your AI provider\n"));
   const provider = await select2({
     message: "Which AI provider would you like to use?",
     choices: [
@@ -1298,7 +1480,7 @@ async function runOnboarding() {
       { name: "\u{1F30A} DeepSeek", value: "deepseek" }
     ]
   });
-  console.log(chalk7.white.bold("\nStep 2/3: Enter your API key\n"));
+  console.log(chalk8.white.bold("\nStep 2/3: Enter your API key\n"));
   const keyUrls = {
     gemini: "https://aistudio.google.com/apikey",
     openrouter: "https://openrouter.ai/keys",
@@ -1306,7 +1488,7 @@ async function runOnboarding() {
     anthropic: "https://console.anthropic.com/",
     deepseek: "https://platform.deepseek.com/"
   };
-  console.log(chalk7.gray(`Get your key at: ${chalk7.cyan(keyUrls[provider])}
+  console.log(chalk8.gray(`Get your key at: ${chalk8.cyan(keyUrls[provider])}
 `));
   const apiKey = await password2({
     message: `Enter your ${provider} API key:`,
@@ -1330,7 +1512,7 @@ async function runOnboarding() {
       break;
   }
   config.defaultProvider = provider;
-  console.log(chalk7.white.bold("\nStep 3/3: Choose your default model\n"));
+  console.log(chalk8.white.bold("\nStep 3/3: Choose your default model\n"));
   const models = PROVIDER_MODELS[provider] || PROVIDER_MODELS.gemini;
   const model = await select2({
     message: "Select your default model:",
@@ -1338,18 +1520,18 @@ async function runOnboarding() {
   });
   config.defaultModel = model;
   saveConfig(config);
-  console.log(chalk7.green("\n\u2705 Setup complete!"));
-  console.log(chalk7.gray(`Provider: ${chalk7.cyan(provider)}`));
-  console.log(chalk7.gray(`Model: ${chalk7.cyan(model)}
+  console.log(chalk8.green("\n\u2705 Setup complete!"));
+  console.log(chalk8.gray(`Provider: ${chalk8.cyan(provider)}`));
+  console.log(chalk8.gray(`Model: ${chalk8.cyan(model)}
 `));
   return { provider, apiKey, model };
 }
 async function selectModel() {
   const config = loadConfig();
   const provider = config.defaultProvider || "gemini";
-  console.log(chalk7.cyan.bold("\n\u{1F504} Change Model\n"));
-  console.log(chalk7.gray(`Current provider: ${chalk7.cyan(provider)}`));
-  console.log(chalk7.gray(`Current model: ${chalk7.cyan(config.defaultModel || "not set")}
+  console.log(chalk8.cyan.bold("\n\u{1F504} Change Model\n"));
+  console.log(chalk8.gray(`Current provider: ${chalk8.cyan(provider)}`));
+  console.log(chalk8.gray(`Current model: ${chalk8.cyan(config.defaultModel || "not set")}
 `));
   const changeProvider = await select2({
     message: "What would you like to do?",
@@ -1360,7 +1542,7 @@ async function selectModel() {
     ]
   });
   if (changeProvider === "cancel") {
-    console.log(chalk7.gray("\nCancelled.\n"));
+    console.log(chalk8.gray("\nCancelled.\n"));
     return;
   }
   let selectedProvider = provider;
@@ -1383,7 +1565,7 @@ async function selectModel() {
       deepseek: config.deepseekApiKey
     };
     if (!keyMap[selectedProvider]) {
-      console.log(chalk7.yellow(`
+      console.log(chalk8.yellow(`
 \u26A0\uFE0F  No API key configured for ${selectedProvider}
 `));
       const apiKey = await password2({
@@ -1417,9 +1599,9 @@ async function selectModel() {
   });
   config.defaultModel = model;
   saveConfig(config);
-  console.log(chalk7.green("\n\u2705 Model changed!"));
-  console.log(chalk7.gray(`Provider: ${chalk7.cyan(selectedProvider)}`));
-  console.log(chalk7.gray(`Model: ${chalk7.cyan(model)}
+  console.log(chalk8.green("\n\u2705 Model changed!"));
+  console.log(chalk8.gray(`Provider: ${chalk8.cyan(selectedProvider)}`));
+  console.log(chalk8.gray(`Model: ${chalk8.cyan(model)}
 `));
 }
 
@@ -1427,165 +1609,6 @@ async function selectModel() {
 import { input as input5, confirm as confirm3 } from "@inquirer/prompts";
 import chalk13 from "chalk";
 
-// src/utils/ui.ts
-import chalk8 from "chalk";
-import gradient from "gradient-string";
-import boxen from "boxen";
-import figlet from "figlet";
-import ora3 from "ora";
-var THEME = {
-  cyan: "#06b6d4",
-  // Cyan-500
-  purple: "#8b5cf6",
-  // Violet-500
-  red: "#ef4444",
-  // Red-500
-  yellow: "#eab308",
-  // Yellow-500
-  gray: "#71717a",
-  // Zinc-500
-  dim: "#52525b"
-  // Zinc-600
-};
-var brandGradient = gradient([THEME.cyan, THEME.purple]);
-var errorGradient = gradient([THEME.red, "#b91c1c"]);
-var goldGradient = gradient([THEME.yellow, "#fbbf24"]);
-async function renderBanner(version = "v2.6.0") {
-  console.clear();
-  const text = await new Promise((resolve5) => {
-    figlet("AGDI", { font: "Slant" }, (err, data) => {
-      resolve5(data || "AGDI");
-    });
-  });
-  console.log(brandGradient.multiline(text));
-  console.log(chalk8.hex(THEME.dim)(`      ${version} [ARCHITECT ONLINE]
-`));
-}
-function renderBox(title, content, style = "info") {
-  let borderColor = THEME.cyan;
-  let titleColor = chalk8.cyan;
-  if (style === "success") {
-    borderColor = THEME.cyan;
-  } else if (style === "warning") {
-    borderColor = THEME.yellow;
-    titleColor = chalk8.yellow;
-  } else if (style === "error") {
-    borderColor = THEME.red;
-    titleColor = chalk8.red;
-  }
-  const box = boxen(content, {
-    title: titleColor.bold(title),
-    padding: 1,
-    margin: 1,
-    borderStyle: "round",
-    borderColor,
-    dimBorder: false,
-    float: "left"
-  });
-  console.log(box);
-}
-function renderAlert(title, message) {
-  console.log("");
-  const box = boxen(chalk8.white(message), {
-    title: chalk8.red.bold(`\u{1F6E1}\uFE0F  ${title.toUpperCase()}  `),
-    padding: 1,
-    borderStyle: "double",
-    borderColor: "red",
-    textAlignment: "center"
-  });
-  console.log(box);
-  console.log("");
-}
-function printUserMessage(message) {
-  console.log("");
-  console.log(chalk8.cyan.bold("\u{1F464} YOU \u203A ") + chalk8.white(message));
-  console.log("");
-}
-function printAIMessage(message) {
-  console.log("");
-  console.log(brandGradient.multiline("\u26A1 AGDI \u203A "));
-  console.log(message.trim());
-  console.log("");
-}
-function createSpinner(text) {
-  return ora3({
-    text: chalk8.hex(THEME.gray)(text),
-    color: "cyan",
-    spinner: "dots",
-    discardStdin: false
-    // Important for allowing interruption if needed
-  });
-}
-function printIter() {
-  console.log(chalk8.hex(THEME.dim)("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
-}
-var activeReadlineInterface = null;
-function registerActivePrompt(rl) {
-  activeReadlineInterface = rl;
-}
-var flags = {
-  yes: false,
-  headless: false
-};
-function setFlags(newFlags) {
-  Object.assign(flags, newFlags);
-}
-function safeExit(code = 0) {
-  if (activeReadlineInterface) {
-    try {
-      activeReadlineInterface.close?.();
-      activeReadlineInterface.destroy?.();
-    } catch {
-    }
-    activeReadlineInterface = null;
-  }
-  setImmediate(() => {
-    process.exit(code);
-  });
-  throw new Error("Process exiting");
-}
-async function smartConfirm(message, defaultValue = false) {
-  if (flags.yes || flags.headless || process.env.CI === "true" || process.env.CI === "1") {
-    console.log(chalk8.gray(`  [Auto-approved: ${message}]`));
-    return true;
-  }
-  if (!process.stdout.isTTY) {
-    console.warn(chalk8.yellow("\u26A0\uFE0F  Non-interactive session detected. Use --yes to approve actions."));
-    return false;
-  }
-  const { confirm: confirm4 } = await import("@inquirer/prompts");
-  return confirm4({ message, default: defaultValue });
-}
-async function smartSelect(message, choices, defaultValue) {
-  if (!process.stdout.isTTY || flags.headless) {
-    const result = defaultValue || choices[0]?.value;
-    if (result) {
-      console.log(chalk8.gray(`  [Auto-selected: ${result}]`));
-    }
-    return result || null;
-  }
-  const { select: select5 } = await import("@inquirer/prompts");
-  return select5({ message, choices });
-}
-var ui = {
-  renderBanner,
-  renderBox,
-  renderAlert,
-  printUserMessage,
-  printAIMessage,
-  createSpinner,
-  printIter,
-  brandGradient,
-  THEME,
-  // Safety & Automation
-  safeExit,
-  smartConfirm,
-  smartSelect,
-  setFlags,
-  flags,
-  registerActivePrompt
-};
-
 // src/actions/plan-executor.ts
 import { select as select4, confirm } from "@inquirer/prompts";
 import chalk11 from "chalk";
@@ -3165,10 +3188,37 @@ Target: ${env.workspaceRoot}`
       console.log(chalk11.green("\u2713 Trusted for this session\n"));
     }
   }
-  const approved = await confirm({
-    message: `Execute ${plan.actions.length} actions?`,
-    default: true
+  const dangerousKeywords = ["rm", "rimraf", "del", "npm install", "pnpm install", "yarn install", "chmod", "chown"];
+  const dangerousActions = plan.actions.filter((a) => {
+    if (a.type !== "exec") return false;
+    const cmd = a.argv.join(" ");
+    return dangerousKeywords.some((k) => cmd.includes(k));
   });
+  if (dangerousActions.length > 0) {
+    ui.renderAlert(
+      "\u26A0\uFE0F DANGEROUS COMMANDS DETECTED",
+      dangerousActions.map((a) => `\u2022 ${a.argv.join(" ")}`).join("\n") + "\n\nThese commands can modify your system or delete files."
+    );
+    const allowDangerous = await confirm({
+      message: "Are you SURE you want to execute these dangerous commands?",
+      default: false
+    });
+    if (!allowDangerous) {
+      console.log(chalk11.yellow("\n\u{1F44B} Execution cancelled for safety.\n"));
+      return { success: false, results, filesCreated, commandsRun, errors: ["User cancelled dangerous commands"] };
+    }
+  }
+  let approved = false;
+  if (ui.flags.dryRun) {
+    console.log(chalk11.yellow("\n\u{1F6A7} DRY RUN MODE ENABLED"));
+    console.log(chalk11.gray("   No files will be written and no commands will be executed.\n"));
+    approved = true;
+  } else {
+    approved = await confirm({
+      message: `Execute ${plan.actions.length} actions?`,
+      default: true
+    });
+  }
   if (!approved) {
     console.log(chalk11.yellow("\n\u{1F44B} Plan cancelled.\n"));
     return { success: false, results, filesCreated, commandsRun, errors: ["User cancelled"] };
@@ -3185,6 +3235,11 @@ Target: ${env.workspaceRoot}`
   for (let i = 0; i < plan.actions.length; i++) {
     const action = plan.actions[i];
     displayActionProgress(action, i, plan.actions.length);
+    if (ui.flags.dryRun) {
+      console.log(chalk11.yellow(`   [DRY RUN] Would execute: ${action.type} ${action.path || action.argv?.join(" ")}`));
+      results.push({ action, success: true, output: "(dry run)" });
+      continue;
+    }
     const result = await executeAction(action);
     results.push(result);
     if (result.success) {
@@ -4040,8 +4095,8 @@ registerTool({
     { name: "path", type: "string", description: "Directory path", required: false, default: "." }
   ],
   execute: async (params) => {
-    const { readdirSync: readdirSync2, statSync: statSync2 } = await import("fs");
-    const { resolve: resolve5, join: join8 } = await import("path");
+    const { readdirSync: readdirSync2, statSync: statSync3 } = await import("fs");
+    const { resolve: resolve5, join: join9 } = await import("path");
     try {
       const dirPath = resolve5(process.cwd(), params.path || ".");
       const entries = readdirSync2(dirPath);
@@ -4049,7 +4104,7 @@ registerTool({
       const dirs = [];
       for (const entry of entries) {
         try {
-          const stat = statSync2(join8(dirPath, entry));
+          const stat = statSync3(join9(dirPath, entry));
           if (stat.isDirectory()) {
             dirs.push(entry + "/");
           } else {
@@ -4649,25 +4704,183 @@ function handleError(error) {
   }
 }
 
+// src/commands/doctor.ts
+import chalk14 from "chalk";
+import { existsSync as existsSync11, statSync as statSync2 } from "fs";
+import { homedir as homedir7, platform as platform2 } from "os";
+import { join as join8 } from "path";
+async function runDoctor() {
+  console.log("");
+  ui.renderBox("AGDI DOCTOR", "Running diagnostics...", "info");
+  console.log("");
+  const results = [];
+  const nodeVersion = process.version;
+  const majorVersion = parseInt(nodeVersion.slice(1).split(".")[0], 10);
+  if (majorVersion >= 18) {
+    results.push({
+      name: "Node.js Version",
+      status: "pass",
+      message: `${nodeVersion} (\u226518 required)`
+    });
+  } else {
+    results.push({
+      name: "Node.js Version",
+      status: "fail",
+      message: `${nodeVersion} - Node.js 18+ required!`
+    });
+  }
+  const configDir = join8(homedir7(), ".agdi");
+  const configPath = join8(configDir, "config.json");
+  if (existsSync11(configPath)) {
+    if (platform2() !== "win32") {
+      try {
+        const stats = statSync2(configPath);
+        const mode = (stats.mode & parseInt("777", 8)).toString(8);
+        if (mode === "600") {
+          results.push({
+            name: "Config Permissions",
+            status: "pass",
+            message: `${configPath} (mode: 600)`
+          });
+        } else {
+          results.push({
+            name: "Config Permissions",
+            status: "warn",
+            message: `${configPath} (mode: ${mode}) - Should be 600!`
+          });
+        }
+      } catch {
+        results.push({
+          name: "Config Permissions",
+          status: "warn",
+          message: "Could not check permissions"
+        });
+      }
+    } else {
+      results.push({
+        name: "Config File",
+        status: "pass",
+        message: `${configPath} exists`
+      });
+    }
+  } else {
+    results.push({
+      name: "Config File",
+      status: "warn",
+      message: "No config found. Run: agdi auth"
+    });
+  }
+  const activeConfig = getActiveProvider();
+  if (activeConfig) {
+    const keyPreview = activeConfig.apiKey.slice(0, 8) + "..." + activeConfig.apiKey.slice(-4);
+    results.push({
+      name: "API Key",
+      status: "pass",
+      message: `${activeConfig.provider} (${keyPreview})`
+    });
+    results.push({
+      name: "Active Model",
+      status: "pass",
+      message: activeConfig.model
+    });
+  } else {
+    results.push({
+      name: "API Key",
+      status: "fail",
+      message: "No API key configured. Run: agdi auth"
+    });
+  }
+  const auditPath = join8(configDir, "audit.jsonl");
+  if (existsSync11(auditPath)) {
+    results.push({
+      name: "Audit Log",
+      status: "pass",
+      message: `Logging to ${auditPath}`
+    });
+  } else {
+    results.push({
+      name: "Audit Log",
+      status: "warn",
+      message: "No audit log found (will be created on first action)"
+    });
+  }
+  const trustPath = join8(configDir, "trusted-workspaces.json");
+  if (existsSync11(trustPath)) {
+    results.push({
+      name: "Trust Store",
+      status: "pass",
+      message: "Workspace trust store found"
+    });
+  } else {
+    results.push({
+      name: "Trust Store",
+      status: "warn",
+      message: "No trusted workspaces yet"
+    });
+  }
+  console.log(chalk14.bold("Diagnostic Results:\n"));
+  for (const result of results) {
+    let icon;
+    let color;
+    switch (result.status) {
+      case "pass":
+        icon = "\u2705";
+        color = chalk14.green;
+        break;
+      case "warn":
+        icon = "\u26A0\uFE0F";
+        color = chalk14.yellow;
+        break;
+      case "fail":
+        icon = "\u274C";
+        color = chalk14.red;
+        break;
+    }
+    console.log(`  ${icon} ${chalk14.bold(result.name)}`);
+    console.log(`     ${color(result.message)}
+`);
+  }
+  const passed = results.filter((r) => r.status === "pass").length;
+  const warnings = results.filter((r) => r.status === "warn").length;
+  const failed = results.filter((r) => r.status === "fail").length;
+  console.log(chalk14.gray("\u2500".repeat(50)));
+  console.log(`
+  ${chalk14.bold("Summary:")} ${chalk14.green(passed + " passed")}, ${chalk14.yellow(warnings + " warnings")}, ${chalk14.red(failed + " failed")}
+`);
+  if (failed > 0) {
+    console.log(chalk14.red("  \u26A0\uFE0F There are critical issues that need attention.\n"));
+  } else if (warnings > 0) {
+    console.log(chalk14.yellow("  \u2139\uFE0F There are some warnings, but Agdi should work.\n"));
+  } else {
+    console.log(chalk14.green("  \u{1F389} All checks passed! Agdi is ready to use.\n"));
+  }
+}
+
 // src/index.ts
 var BANNER = `
-${chalk14.cyan(`    ___              __ _  `)}
-${chalk14.cyan(`   /   |  ____ _____/ /(_) `)}
-${chalk14.cyan(`  / /| | / __ \`/ __  // /  `)}
-${chalk14.cyan(` / ___ |/ /_/ / /_/ // /   `)}
-${chalk14.cyan(`/_/  |_|\\_, /\\__,_//_/    `)}
-${chalk14.cyan(`       /____/              `)}
+${chalk15.cyan(`    ___              __ _  `)}
+${chalk15.cyan(`   /   |  ____ _____/ /(_) `)}
+${chalk15.cyan(`  / /| | / __ \`/ __  // /  `)}
+${chalk15.cyan(` / ___ |/ /_/ / /_/ // /   `)}
+${chalk15.cyan(`/_/  |_|\\_, /\\__,_//_/    `)}
+${chalk15.cyan(`       /____/              `)}
 `;
 var program = new Command();
-program.name("agdi").description(chalk14.cyan("\u{1F680} AI-powered coding assistant")).version("2.7.0").option("-y, --yes", "Auto-approve all prompts (headless/CI mode)");
+program.name("agdi").description(chalk15.cyan("\u{1F680} AI-powered coding assistant")).version("2.8.0").option("-y, --yes", "Auto-approve all prompts (headless/CI mode)").option("-m, --minimal", "Generate only the requested file(s), not a full app").option("-d, --dry-run", "Show what would be created without writing files");
 program.hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.yes) {
     ui.setFlags({ yes: true, headless: true });
   }
+  if (opts.minimal) {
+    ui.setFlags({ minimal: true });
+  }
+  if (opts.dryRun) {
+    ui.setFlags({ dryRun: true });
+  }
 });
 program.addHelpText("beforeAll", () => {
-  return BANNER + "\n" + chalk14.gray("  The Open Source AI Architect") + "\n" + chalk14.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
+  return BANNER + "\n" + chalk15.gray("  The Open Source AI Architect") + "\n" + chalk15.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
 });
 program.action(async () => {
   try {
@@ -4678,7 +4891,7 @@ program.action(async () => {
     await startCodingMode();
   } catch (error) {
     if (error.name === "ExitPromptError") {
-      console.log(chalk14.gray("\n\n\u{1F44B} Goodbye!\n"));
+      console.log(chalk15.gray("\n\n\u{1F44B} Goodbye!\n"));
       ui.safeExit(0);
     }
     throw error;
@@ -4693,7 +4906,7 @@ program.command("auth").description("Configure API keys").option("--status", "Sh
     }
   } catch (error) {
     if (error.name === "ExitPromptError") {
-      console.log(chalk14.gray("\n\n\u{1F44B} Cancelled.\n"));
+      console.log(chalk15.gray("\n\n\u{1F44B} Cancelled.\n"));
       ui.safeExit(0);
     }
     throw error;
@@ -4704,7 +4917,7 @@ program.command("model").alias("models").description("Change AI model").action(a
     await selectModel();
   } catch (error) {
     if (error.name === "ExitPromptError") {
-      console.log(chalk14.gray("\n\n\u{1F44B} Cancelled.\n"));
+      console.log(chalk15.gray("\n\n\u{1F44B} Cancelled.\n"));
       ui.safeExit(0);
     }
     throw error;
@@ -4718,7 +4931,7 @@ program.command("chat").description("Start a chat session").action(async () => {
     await startChat();
   } catch (error) {
     if (error.name === "ExitPromptError") {
-      console.log(chalk14.gray("\n\n\u{1F44B} Goodbye!\n"));
+      console.log(chalk15.gray("\n\n\u{1F44B} Goodbye!\n"));
       ui.safeExit(0);
     }
     throw error;
@@ -4729,20 +4942,20 @@ program.command("run [directory]").description("Run a generated project").action
     await runProject(directory);
   } catch (error) {
     if (error.name === "ExitPromptError") {
-      console.log(chalk14.gray("\n\n\u{1F44B} Cancelled.\n"));
+      console.log(chalk15.gray("\n\n\u{1F44B} Cancelled.\n"));
       ui.safeExit(0);
     }
     throw error;
   }
 });
-program.command("build <prompt>").alias("b").description("Generate an app from a prompt").option("-o, --output <dir>", "Output directory", "./generated-app").action(async (prompt, options) => {
+program.command("build <prompt>").alias("b").description("Generate an app from a prompt").option("-o, --output <dir>", "Output directory", "./generated-app").option("-m, --minimal", "Generate only the requested file(s), not a full app").option("-d, --dry-run", "Show what would be created without writing files").action(async (prompt, options) => {
   try {
     if (needsOnboarding()) {
       await runOnboarding();
     }
     const activeConfig = getActiveProvider();
     if (!activeConfig) {
-      console.log(chalk14.red("\u274C No API key configured. Run: agdi auth"));
+      console.log(chalk15.red("\u274C No API key configured. Run: agdi auth"));
       return;
     }
     const spinner = ora5("Generating application...").start();
@@ -4754,30 +4967,42 @@ program.command("build <prompt>").alias("b").description("Generate an app from a
       const pm = new ProjectManager();
       pm.create(options.output.replace("./", ""), prompt);
       const { plan, files } = await generateApp(prompt, llm, (step, file) => {
-        spinner.text = file ? `${step} ${chalk14.gray(file)}` : step;
+        spinner.text = file ? `${step} ${chalk15.gray(file)}` : step;
       });
       pm.updateFiles(files);
       pm.updateDependencies(plan.dependencies);
+      if (options.dryRun || ui.flags.dryRun) {
+        spinner.stop();
+        console.log(chalk15.cyan.bold("\n\u{1F6A7} DRY RUN SUMMARY\n"));
+        console.log(chalk15.gray(`Project: ${plan.name}
+`));
+        console.log(chalk15.cyan("Files to be created:"));
+        files.forEach((f) => console.log(chalk15.gray(`  \u{1F4C4} ${f.path}`)));
+        console.log(chalk15.cyan("\nDependencies:"));
+        console.log(chalk15.gray(`  \u{1F4E6} ${plan.dependencies.join(", ")}`));
+        console.log(chalk15.green("\n\u2713 Dry run complete. No files written.\n"));
+        return;
+      }
       await writeProject(pm.get(), options.output);
-      spinner.succeed(chalk14.green("App generated!"));
-      console.log(chalk14.gray(`
-\u{1F4C1} Created ${files.length} files in ${chalk14.cyan(options.output)}`));
-      console.log(chalk14.gray("\nNext: cd " + options.output + " && npm install && npm run dev\n"));
+      spinner.succeed(chalk15.green("App generated!"));
+      console.log(chalk15.gray(`
+\u{1F4C1} Created ${files.length} files in ${chalk15.cyan(options.output)}`));
+      console.log(chalk15.gray("\nNext: cd " + options.output + " && npm install && npm run dev\n"));
     } catch (error) {
       spinner.fail("Generation failed");
       const msg = error instanceof Error ? error.message : String(error);
       if (msg.includes("429") || msg.includes("quota")) {
-        console.log(chalk14.yellow("\n\u26A0\uFE0F  Quota exceeded. Run: agdi model\n"));
+        console.log(chalk15.yellow("\n\u26A0\uFE0F  Quota exceeded. Run: agdi model\n"));
       } else if (msg.includes("401") || msg.includes("403")) {
-        console.log(chalk14.red("\n\u{1F511} Invalid API key. Run: agdi auth\n"));
+        console.log(chalk15.red("\n\u{1F511} Invalid API key. Run: agdi auth\n"));
       } else {
-        console.error(chalk14.red("\n" + msg + "\n"));
+        console.error(chalk15.red("\n" + msg + "\n"));
       }
       ui.safeExit(1);
     }
   } catch (error) {
     if (error.name === "ExitPromptError") {
-      console.log(chalk14.gray("\n\n\u{1F44B} Cancelled.\n"));
+      console.log(chalk15.gray("\n\n\u{1F44B} Cancelled.\n"));
       ui.safeExit(0);
     }
     throw error;
@@ -4786,11 +5011,11 @@ program.command("build <prompt>").alias("b").description("Generate an app from a
 program.command("config").description("Show configuration").action(async () => {
   const config = loadConfig();
   const active = getActiveProvider();
-  console.log(chalk14.cyan.bold("\n\u2699\uFE0F  Configuration\n"));
-  console.log(chalk14.gray("  Provider: ") + chalk14.cyan(config.defaultProvider || "not set"));
-  console.log(chalk14.gray("  Model:    ") + chalk14.cyan(config.defaultModel || "not set"));
-  console.log(chalk14.gray("  Config:   ") + chalk14.gray("~/.agdi/config.json"));
-  console.log(chalk14.cyan.bold("\n\u{1F510} API Keys\n"));
+  console.log(chalk15.cyan.bold("\n\u2699\uFE0F  Configuration\n"));
+  console.log(chalk15.gray("  Provider: ") + chalk15.cyan(config.defaultProvider || "not set"));
+  console.log(chalk15.gray("  Model:    ") + chalk15.cyan(config.defaultModel || "not set"));
+  console.log(chalk15.gray("  Config:   ") + chalk15.gray("~/.agdi/config.json"));
+  console.log(chalk15.cyan.bold("\n\u{1F510} API Keys\n"));
   const keys = [
     ["Gemini", config.geminiApiKey],
     ["OpenRouter", config.openrouterApiKey],
@@ -4799,9 +5024,18 @@ program.command("config").description("Show configuration").action(async () => {
     ["DeepSeek", config.deepseekApiKey]
   ];
   for (const [name, key] of keys) {
-    const status = key ? chalk14.green("\u2713") : chalk14.gray("\u2717");
+    const status = key ? chalk15.green("\u2713") : chalk15.gray("\u2717");
     console.log(`  ${status} ${name}`);
   }
   console.log("");
+  console.log("");
+});
+program.command("doctor").alias("doc").description("Run self-diagnosis checks").action(async () => {
+  try {
+    await runDoctor();
+  } catch (error) {
+    console.error(chalk15.red("Diagnostic failed: " + error));
+    ui.safeExit(1);
+  }
 });
 program.parse();