@revealui/cli 0.3.2 → 0.4.0

package/dist/cli.js

@@ -1,20 +1,231 @@
 // src/cli.ts
-import { createLogger as createLogger11 } from "@revealui/setup/utils";
+import { createLogger as createLogger12 } from "@revealui/setup/utils";
 import { Command } from "commander";
 
+// src/commands/agent.ts
+import { createInterface } from "readline";
+import { createLogger } from "@revealui/setup/utils";
+var logger = createLogger({ prefix: "agent" });
+async function runAgentStatusCommand() {
+  const { available, provider, model, projectRoot } = await detectProvider();
+  logger.info(`Provider:     ${provider}`);
+  logger.info(`Model:        ${model}`);
+  logger.info(`Project root: ${projectRoot}`);
+  logger.info(`Available:    ${available ? "yes" : "no"}`);
+  if (!available) {
+    logger.warn("No LLM provider detected. Start BitNet, Ollama, or set GROQ_API_KEY.");
+  }
+}
+async function runAgentHeadlessCommand(prompt) {
+  const deps = await loadProDeps();
+  if (!deps) return;
+  const { StreamingAgentRuntime, createLLMClientFromEnv, createCodingTools } = deps;
+  const projectRoot = process.cwd();
+  const tools = createCodingTools({ projectRoot });
+  const llmClient = createLLMClientFromEnv();
+  const agent = {
+    id: "revealui-coding-agent",
+    name: "RevealUI Coding Agent",
+    instructions: buildMinimalInstructions(),
+    tools,
+    config: {},
+    getContext: () => ({ projectRoot, workingDirectory: projectRoot })
+  };
+  const task = {
+    id: `task-${Date.now()}`,
+    type: "headless-prompt",
+    description: prompt
+  };
+  const runtime = new StreamingAgentRuntime({
+    maxIterations: 10,
+    timeout: 12e4
+  });
+  try {
+    for await (const chunk of runtime.streamTask(agent, task, llmClient)) {
+      switch (chunk.type) {
+        case "text":
+          if (chunk.content) process.stdout.write(chunk.content);
+          break;
+        case "tool_call_start":
+          if (chunk.toolCall) {
+            process.stderr.write(`
+[tool] ${chunk.toolCall.name}
+`);
+          }
+          break;
+        case "tool_call_result":
+          if (chunk.toolResult?.content) {
+            process.stderr.write(`  \u2192 ${chunk.toolResult.content}
+`);
+          }
+          break;
+        case "error":
+          process.stderr.write(`
+[error] ${chunk.error}
+`);
+          break;
+        case "done":
+          process.stdout.write("\n");
+          break;
+      }
+    }
+  } finally {
+    await runtime.cleanup();
+  }
+}
+async function runAgentReplCommand() {
+  const deps = await loadProDeps();
+  if (!deps) return;
+  const { StreamingAgentRuntime, createLLMClientFromEnv, createCodingTools } = deps;
+  const projectRoot = process.cwd();
+  const tools = createCodingTools({ projectRoot });
+  const llmClient = createLLMClientFromEnv();
+  const agent = {
+    id: "revealui-coding-agent",
+    name: "RevealUI Coding Agent",
+    instructions: buildMinimalInstructions(),
+    tools,
+    config: {},
+    getContext: () => ({ projectRoot, workingDirectory: projectRoot })
+  };
+  logger.info('RevealUI Agent (type "exit" or Ctrl+C to quit)');
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: "\n> "
+  });
+  rl.prompt();
+  rl.on("line", async (line) => {
+    const input = line.trim();
+    if (!input) {
+      rl.prompt();
+      return;
+    }
+    if (input === "exit" || input === "quit") {
+      rl.close();
+      return;
+    }
+    const task = {
+      id: `task-${Date.now()}`,
+      type: "repl-prompt",
+      description: input
+    };
+    const runtime = new StreamingAgentRuntime({
+      maxIterations: 10,
+      timeout: 12e4
+    });
+    try {
+      for await (const chunk of runtime.streamTask(agent, task, llmClient)) {
+        switch (chunk.type) {
+          case "text":
+            if (chunk.content) process.stdout.write(chunk.content);
+            break;
+          case "tool_call_start":
+            if (chunk.toolCall) {
+              process.stderr.write(`
+  [tool] ${chunk.toolCall.name}
+`);
+            }
+            break;
+          case "tool_call_result":
+            if (chunk.toolResult?.content) {
+              process.stderr.write(`    \u2192 ${chunk.toolResult.content}
+`);
+            }
+            break;
+          case "error":
+            process.stderr.write(`
+  [error] ${chunk.error}
+`);
+            break;
+          case "done":
+            break;
+        }
+      }
+    } catch (err) {
+      logger.error(err instanceof Error ? err.message : String(err));
+    } finally {
+      await runtime.cleanup();
+    }
+    rl.prompt();
+  });
+  rl.on("close", () => {
+    process.exit(0);
+  });
+}
+async function loadProDeps() {
+  const aiRuntimePath = "@revealui/ai/orchestration/streaming-runtime";
+  const aiClientPath = "@revealui/ai/llm/client";
+  const aiToolsPath = "@revealui/ai/tools/coding";
+  try {
+    const [runtimeMod, clientMod, toolsMod] = await Promise.all([
+      import(aiRuntimePath),
+      import(aiClientPath),
+      import(aiToolsPath)
+    ]);
+    return {
+      StreamingAgentRuntime: runtimeMod.StreamingAgentRuntime,
+      createLLMClientFromEnv: clientMod.createLLMClientFromEnv,
+      createCodingTools: toolsMod.createCodingTools
+    };
+  } catch {
+    logger.error(
+      "Pro packages not found. Install @revealui/ai to use the agent.\n  npm install @revealui/ai"
+    );
+    return null;
+  }
+}
+async function detectProvider() {
+  const projectRoot = process.cwd();
+  if (process.env.BITNET_BASE_URL) {
+    try {
+      const res = await fetch(`${process.env.BITNET_BASE_URL}/v1/models`, {
+        signal: AbortSignal.timeout(2e3)
+      });
+      if (res.ok) {
+        return { available: true, provider: "bitnet", model: "bitnet-b1.58-2B-4T", projectRoot };
+      }
+    } catch {
+    }
+  }
+  const ollamaUrl = process.env.OLLAMA_BASE_URL ?? "http://localhost:11434";
+  try {
+    const res = await fetch(`${ollamaUrl}/api/tags`, {
+      signal: AbortSignal.timeout(2e3)
+    });
+    if (res.ok) {
+      return { available: true, provider: "ollama", model: "llama3.2:3b", projectRoot };
+    }
+  } catch {
+  }
+  if (process.env.GROQ_API_KEY) {
+    return { available: true, provider: "groq", model: "llama-3.3-70b-versatile", projectRoot };
+  }
+  return { available: false, provider: "none", model: "none", projectRoot };
+}
+function buildMinimalInstructions() {
+  return [
+    "You are the RevealUI coding agent. You help with software development tasks in this project.",
+    "Use the available tools to read, write, edit, search, and execute commands.",
+    "Always read files before modifying them. Prefer surgical edits over full rewrites.",
+    "Follow project conventions discovered via the project_context tool.",
+    "Be concise and direct. Show your work through tool usage, not verbose explanations."
+  ].join("\n");
+}
+
 // src/commands/create-flow.ts
 import { readFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
-import { createLogger as createLogger6 } from "@revealui/setup/utils";
+import { createLogger as createLogger7 } from "@revealui/setup/utils";
 import { importSPKI, jwtVerify } from "jose";
 
 // src/prompts/database.ts
 import inquirer from "inquirer";
 
 // src/validators/credentials.ts
-import { createLogger } from "@revealui/setup/utils";
-var logger = createLogger({ prefix: "Validator" });
+import { createLogger as createLogger2 } from "@revealui/setup/utils";
+var logger2 = createLogger2({ prefix: "Validator" });
 async function validateStripeKey(key) {
   if (!(key.startsWith("sk_test_") || key.startsWith("sk_live_"))) {
     return {
@@ -54,7 +265,7 @@ async function validateSupabaseUrl(url) {
   try {
     const parsed = new URL(url);
     if (!parsed.hostname.includes("supabase")) {
-      logger.warn("URL does not appear to be a Supabase URL");
+      logger2.warn("URL does not appear to be a Supabase URL");
     }
     return { valid: true };
   } catch {
@@ -342,18 +553,18 @@ async function promptStorageConfig() {
 }
 
 // src/validators/node-version.ts
-import { createLogger as createLogger2 } from "@revealui/setup/utils";
-var logger2 = createLogger2({ prefix: "Setup" });
+import { createLogger as createLogger3 } from "@revealui/setup/utils";
+var logger3 = createLogger3({ prefix: "Setup" });
 var REQUIRED_NODE_VERSION = "24.13.0";
 function validateNodeVersion() {
   const currentVersion = process.version.slice(1);
   const [currentMajor, currentMinor] = currentVersion.split(".").map(Number);
   const [requiredMajor, requiredMinor] = REQUIRED_NODE_VERSION.split(".").map(Number);
   if (currentMajor < requiredMajor || currentMajor === requiredMajor && currentMinor < requiredMinor) {
-    logger2.error(
+    logger3.error(
       `Node.js ${REQUIRED_NODE_VERSION} or higher is required. You have ${currentVersion}.`
     );
-    logger2.info("Please upgrade Node.js: https://nodejs.org/");
+    logger3.info("Please upgrade Node.js: https://nodejs.org/");
     return false;
   }
   return true;
@@ -361,10 +572,11 @@ function validateNodeVersion() {
 
 // src/commands/create.ts
 import crypto from "crypto";
+import { existsSync } from "fs";
 import fs5 from "fs/promises";
 import path5 from "path";
 import { fileURLToPath } from "url";
-import { createLogger as createLogger5 } from "@revealui/setup/utils";
+import { createLogger as createLogger6 } from "@revealui/setup/utils";
 import ora2 from "ora";
 
 // src/generators/devbox.ts
@@ -562,70 +774,42 @@ Run the development server:
 pnpm dev
 \`\`\`
 
-Open [http://localhost:4000](http://localhost:4000) with your browser to access the CMS.
-
-The web application runs on [http://localhost:3000](http://localhost:3000).
+Open [http://localhost:4000](http://localhost:4000) with your browser.
 
-## Development Environments
+## Requirements
 
-### Standard Setup
-
-Requirements:
 - Node.js 24.13.0 or higher
-- pnpm 10.28.2 or higher
-- PostgreSQL 16
-
-### Dev Containers
-
-Open in VS Code and select "Reopen in Container", or use GitHub Codespaces.
-
-### Devbox
-
-Install Devbox:
-
-\`\`\`bash
-curl -fsSL https://get.jetpack.io/devbox | bash
-\`\`\`
-
-Then start the Devbox shell:
-
-\`\`\`bash
-devbox shell
-pnpm dev
-\`\`\`
+- pnpm 10 or higher
+- PostgreSQL 16 (or use a hosted provider like [Neon](https://neon.tech))
 
 ## Project Structure
 
 \`\`\`
 ${projectConfig.projectName}/
-\u251C\u2500\u2500 apps/
-\u2502   \u251C\u2500\u2500 cms/              # CMS application
-\u2502   \u2514\u2500\u2500 web/              # Frontend application
-\u251C\u2500\u2500 packages/
-\u2502   \u251C\u2500\u2500 auth/             # Authentication
-\u2502   \u251C\u2500\u2500 db/               # Database
-\u2502   \u2514\u2500\u2500 ...               # Other shared packages
-\u251C\u2500\u2500 .devcontainer/        # Dev Container configuration
-\u251C\u2500\u2500 devbox.json           # Devbox configuration
-\u2514\u2500\u2500 .env.development.local # Environment variables
+\u251C\u2500\u2500 src/
+\u2502   \u251C\u2500\u2500 app/              # Next.js App Router pages
+\u2502   \u251C\u2500\u2500 collections/      # RevealUI collection definitions
+\u2502   \u2514\u2500\u2500 seed.ts           # Database seed script
+\u251C\u2500\u2500 revealui.config.ts    # RevealUI configuration
+\u251C\u2500\u2500 next.config.mjs       # Next.js configuration
+\u2514\u2500\u2500 .env.local            # Environment variables (git-ignored)
 \`\`\`
 
 ## Available Scripts
 
-- \`pnpm dev\` - Start development servers
+- \`pnpm dev\` - Start the development server
 - \`pnpm build\` - Build for production
 - \`pnpm test\` - Run tests
-- \`pnpm lint\` - Run linters
+- \`pnpm lint\` - Lint with Biome
 - \`pnpm typecheck\` - Type check
-- \`pnpm db:init\` - Initialize database
+- \`pnpm db:init\` - Initialize the database
 - \`pnpm db:migrate\` - Run migrations
-- \`pnpm db:seed\` - Seed database
+- \`pnpm db:seed\` - Seed sample content
 
 ## Learn More
 
-- [RevealUI Documentation](https://github.com/your-org/RevealUI)
+- [RevealUI Documentation](https://docs.revealui.com)
 - [Next.js Documentation](https://nextjs.org/docs)
-- [Hono Documentation](https://hono.dev)
 
 ## Template
 
@@ -639,10 +823,10 @@ MIT
 }
 
 // src/installers/dependencies.ts
-import { createLogger as createLogger3 } from "@revealui/setup/utils";
+import { createLogger as createLogger4 } from "@revealui/setup/utils";
 import { execa } from "execa";
 import ora from "ora";
-var logger3 = createLogger3({ prefix: "Install" });
+var logger4 = createLogger4({ prefix: "Install" });
 async function installDependencies(projectPath) {
   const spinner = ora("Installing dependencies with pnpm...").start();
   try {
@@ -653,7 +837,7 @@ async function installDependencies(projectPath) {
     spinner.succeed("Dependencies installed successfully");
   } catch (error) {
     spinner.fail("Failed to install dependencies");
-    logger3.error('Please run "pnpm install" manually');
+    logger4.error('Please run "pnpm install" manually');
     throw error;
   }
 }
@@ -667,15 +851,15 @@ async function isPnpmInstalled() {
 }
 
 // src/utils/git.ts
-import { createLogger as createLogger4 } from "@revealui/setup/utils";
+import { createLogger as createLogger5 } from "@revealui/setup/utils";
 import { execa as execa2 } from "execa";
-var logger4 = createLogger4({ prefix: "Git" });
+var logger5 = createLogger5({ prefix: "Git" });
 async function initializeGitRepo(projectPath) {
   try {
     await execa2("git", ["init"], { cwd: projectPath });
-    logger4.success("Initialized git repository");
+    logger5.success("Initialized git repository");
   } catch (error) {
-    logger4.warn("Failed to initialize git repository");
+    logger5.warn("Failed to initialize git repository");
     throw error;
   }
 }
@@ -683,9 +867,9 @@ async function createInitialCommit(projectPath) {
   try {
     await execa2("git", ["add", "."], { cwd: projectPath });
     await execa2("git", ["commit", "-m", "Initial commit from @revealui/cli"], { cwd: projectPath });
-    logger4.success("Created initial commit");
+    logger5.success("Created initial commit");
   } catch (error) {
-    logger4.warn("Failed to create initial commit");
+    logger5.warn("Failed to create initial commit");
     throw error;
   }
 }
@@ -699,10 +883,10 @@ async function isGitInstalled() {
 }
 
 // src/commands/create.ts
-var logger5 = createLogger5({ prefix: "Create" });
+var logger6 = createLogger6({ prefix: "Create" });
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = path5.dirname(__filename2);
-var TEMPLATES_DIR = path5.resolve(__dirname2, "../templates");
+var TEMPLATES_DIR = existsSync(path5.resolve(__dirname2, "../../templates")) ? path5.resolve(__dirname2, "../../templates") : path5.resolve(__dirname2, "../templates");
 function buildEnvLocal(cfg) {
   const lines = [
     "# Generated by @revealui/cli \u2014 fill in the remaining placeholders before running `pnpm dev`",
@@ -787,6 +971,47 @@ function resolveTemplateName(template) {
   };
   return map[template] ?? "starter";
 }
+async function pullContentRules(projectPath) {
+  const baseUrl = process.env.REVEALUI_RULES_URL ?? "https://raw.githubusercontent.com/RevealUIStudio/editor-configs/main/harnesses";
+  const spinner = ora2("Pulling AI coding rules...").start();
+  try {
+    const manifestRes = await fetch(`${baseUrl}/manifest.json`, {
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!manifestRes.ok) {
+      spinner.info("AI rules not available \u2014 skipping");
+      return;
+    }
+    const manifest = await manifestRes.json();
+    const generatorId = "claude-code";
+    const ossDefs = manifest.definitions.filter((d) => d.tier === "oss");
+    let written = 0;
+    for (const def of ossDefs) {
+      const paths = def.generatorPaths[generatorId] ?? [];
+      for (const relPath of paths) {
+        try {
+          const fileRes = await fetch(`${baseUrl}/generators/${generatorId}/${relPath}`, {
+            signal: AbortSignal.timeout(5e3)
+          });
+          if (!fileRes.ok) continue;
+          const content = await fileRes.text();
+          const absolutePath = path5.join(projectPath, relPath);
+          await fs5.mkdir(path5.dirname(absolutePath), { recursive: true });
+          await fs5.writeFile(absolutePath, content, "utf-8");
+          written++;
+        } catch {
+        }
+      }
+    }
+    if (written > 0) {
+      spinner.succeed(`Pulled ${written} AI coding rules`);
+    } else {
+      spinner.info("No AI rules pulled");
+    }
+  } catch {
+    spinner.info("AI rules not available \u2014 skipping");
+  }
+}
 async function createProject(cfg) {
   const { project, skipGit = false, skipInstall = false } = cfg;
   const { projectPath, projectName, template } = project;
@@ -813,42 +1038,43 @@ async function createProject(cfg) {
     throw err;
   }
   await generateReadme(projectPath, project);
-  logger5.success("README.md generated");
+  logger6.success("README.md generated");
   if (cfg.devenv.createDevContainer) {
     await generateDevContainer(projectPath);
-    logger5.success(".devcontainer/ generated");
+    logger6.success(".devcontainer/ generated");
   }
   if (cfg.devenv.createDevbox) {
     await generateDevbox(projectPath);
-    logger5.success("devbox.json generated");
+    logger6.success("devbox.json generated");
   }
+  await pullContentRules(projectPath);
   if (!skipInstall) {
     const pnpmOk = await isPnpmInstalled();
     if (!pnpmOk) {
-      logger5.warn(
+      logger6.warn(
         "pnpm not found \u2014 skipping dependency installation. Run `pnpm install` manually."
       );
     } else {
       await installDependencies(projectPath);
     }
   } else {
-    logger5.info("Skipping dependency installation (--skip-install)");
+    logger6.info("Skipping dependency installation (--skip-install)");
   }
   if (!skipGit) {
     const gitOk = await isGitInstalled();
     if (!gitOk) {
-      logger5.warn("git not found \u2014 skipping repository initialisation.");
+      logger6.warn("git not found \u2014 skipping repository initialisation.");
     } else {
       await initializeGitRepo(projectPath);
       await createInitialCommit(projectPath);
     }
   } else {
-    logger5.info("Skipping git initialisation (--skip-git)");
+    logger6.info("Skipping git initialisation (--skip-git)");
   }
 }
 
 // src/commands/create-flow.ts
-var logger6 = createLogger6({ prefix: "@revealui/cli" });
+var logger7 = createLogger7({ prefix: "@revealui/cli" });
 var PRO_TEMPLATES = /* @__PURE__ */ new Set([]);
 async function checkProLicense() {
   let key = process.env.REVEALUI_LICENSE_KEY;
@@ -861,7 +1087,7 @@ async function checkProLicense() {
     }
   }
   if (!key) return false;
-  const publicKeyPem = process.env.REVEALUI_LICENSE_PUBLIC_KEY;
+  const publicKeyPem = process.env.REVEALUI_LICENSE_PUBLIC_KEY?.replace(/\\n/g, "\n");
   if (publicKeyPem) {
     try {
       const publicKey = await importSPKI(publicKeyPem, "RS256");
@@ -885,76 +1111,131 @@ async function checkProLicense() {
     return false;
   }
 }
-async function runCreateFlow(projectName, options) {
-  logger6.info("[1/8] Validating Node.js version...");
-  if (!validateNodeVersion()) {
-    process.exit(1);
-  }
-  logger6.success(`Node.js version: ${process.version}`);
-  logger6.info("[2/8] Configure your project");
-  const projectConfig = await promptProjectConfig(projectName, options.template, options.yes);
-  logger6.success(`Project: ${projectConfig.projectName}`);
-  logger6.success(`Template: ${projectConfig.template}`);
-  if (PRO_TEMPLATES.has(projectConfig.template)) {
-    if (!await checkProLicense()) {
-      logger6.error(`The "${projectConfig.template}" template requires a RevealUI Pro license.`);
-      logger6.info("Get Pro at https://revealui.com/pricing");
-      logger6.info("Set your license key: export REVEALUI_LICENSE_KEY=<your-key>");
-      process.exit(2);
-    }
-    logger6.success("Pro license verified");
-  }
-  const nonInteractive = options.yes === true;
-  logger6.info("[3/8] Configure database");
-  const databaseConfig = nonInteractive ? { provider: "skip" } : await promptDatabaseConfig();
-  if (databaseConfig.provider !== "skip") {
-    logger6.success(`Database: ${databaseConfig.provider}`);
+function printBanner() {
+  logger7.divider();
+  logger7.info("  RevealUI \u2014 B.O.S.S.");
+  logger7.info("  Build your business, not your boilerplate.");
+  logger7.divider();
+  logger7.info("");
+}
+function printPostCreateSummary(projectName) {
+  logger7.divider();
+  logger7.success("Your RevealUI project is ready!");
+  logger7.info("");
+  logger7.info("  Quick start:");
+  logger7.info(`    cd ${projectName}`);
+  logger7.info("    pnpm install");
+  logger7.info("    pnpm dev");
+  logger7.info("");
+  logger7.info("  What was created:");
+  logger7.info(`    ./${projectName}/          \u2014 project root`);
+  logger7.info(`    ./${projectName}/.env.local \u2014 environment variables (edit before pnpm dev)`);
+  logger7.info(`    ./${projectName}/README.md  \u2014 getting started guide`);
+  logger7.info("");
+  logger7.info("  Helpful links:");
+  logger7.info("    Docs:    https://docs.revealui.com");
+  logger7.info("    GitHub:  https://github.com/RevealUIStudio/revealui");
+  logger7.info("    Support: support@revealui.com");
+  logger7.divider();
+}
+function formatCreateError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const code = err instanceof Error && "code" in err ? err.code : void 0;
+  logger7.error("Project creation failed.");
+  logger7.info("");
+  if (code === "EACCES") {
+    logger7.info("  Permission denied. Try:");
+    logger7.info("    - Running from a directory you own");
+    logger7.info("    - Checking folder permissions with `ls -la`");
+  } else if (code === "ENOENT") {
+    logger7.info("  A required file or directory was not found.");
+    logger7.info("    - Check that you are in the correct directory");
+    logger7.info("    - Try running `revealui doctor` to diagnose your environment");
+  } else if (code === "ENOSPC") {
+    logger7.info("  Disk full. Free up space and try again.");
+  } else if (message.includes("fetch") || message.includes("ENOTFOUND") || message.includes("ETIMEDOUT")) {
+    logger7.info("  Network error. Check your internet connection and try again.");
   } else {
-    logger6.info("Database configuration skipped");
+    logger7.info(`  ${message}`);
   }
-  logger6.info("[4/8] Configure storage");
-  const storageConfig = nonInteractive ? { provider: "skip" } : await promptStorageConfig();
-  if (storageConfig.provider !== "skip") {
-    logger6.success(`Storage: ${storageConfig.provider}`);
-  } else {
-    logger6.info("Storage configuration skipped");
-  }
-  logger6.info("[5/8] Configure payments");
-  const paymentConfig = nonInteractive ? { enabled: false } : await promptPaymentConfig();
-  if (paymentConfig.enabled) {
-    logger6.success("Stripe configured");
-  } else {
-    logger6.info("Payments disabled");
+  logger7.info("");
+  logger7.info("  Troubleshooting:");
+  logger7.info("    revealui doctor       \u2014 diagnose your environment");
+  logger7.info("    https://docs.revealui.com/docs/TROUBLESHOOTING");
+  logger7.info("    support@revealui.com  \u2014 we are here to help");
+  logger7.divider();
+}
+async function runCreateFlow(projectName, options) {
+  printBanner();
+  try {
+    logger7.info("[1/8] Validating Node.js version...");
+    if (!validateNodeVersion()) {
+      process.exit(1);
+    }
+    logger7.success(`Node.js version: ${process.version}`);
+    logger7.info("[2/8] Configure your project");
+    const projectConfig = await promptProjectConfig(projectName, options.template, options.yes);
+    logger7.success(`Project: ${projectConfig.projectName}`);
+    logger7.success(`Template: ${projectConfig.template}`);
+    if (PRO_TEMPLATES.has(projectConfig.template)) {
+      if (!await checkProLicense()) {
+        logger7.error(`The "${projectConfig.template}" template requires a RevealUI Pro license.`);
+        logger7.info("Get Pro at https://revealui.com/pricing");
+        logger7.info("Set your license key: export REVEALUI_LICENSE_KEY=<your-key>");
+        process.exit(2);
+      }
+      logger7.success("Pro license verified");
+    }
+    const nonInteractive = options.yes === true;
+    logger7.info("[3/8] Configure database");
+    const databaseConfig = nonInteractive ? { provider: "skip" } : await promptDatabaseConfig();
+    if (databaseConfig.provider !== "skip") {
+      logger7.success(`Database: ${databaseConfig.provider}`);
+    } else {
+      logger7.info("Database configuration skipped");
+    }
+    logger7.info("[4/8] Configure storage");
+    const storageConfig = nonInteractive ? { provider: "skip" } : await promptStorageConfig();
+    if (storageConfig.provider !== "skip") {
+      logger7.success(`Storage: ${storageConfig.provider}`);
+    } else {
+      logger7.info("Storage configuration skipped");
+    }
+    logger7.info("[5/8] Configure payments");
+    const paymentConfig = nonInteractive ? { enabled: false } : await promptPaymentConfig();
+    if (paymentConfig.enabled) {
+      logger7.success("Stripe configured");
+    } else {
+      logger7.info("Payments disabled");
+    }
+    logger7.info("[6/8] Configure development environment");
+    const devEnvConfig = nonInteractive ? { createDevContainer: false, createDevbox: false } : await promptDevEnvConfig();
+    logger7.success(
+      `Dev Container: ${devEnvConfig.createDevContainer ? "Yes" : "No"}, Devbox: ${devEnvConfig.createDevbox ? "Yes" : "No"}`
+    );
+    logger7.info("[7/8] Creating project...");
+    await createProject({
+      project: projectConfig,
+      database: databaseConfig,
+      storage: storageConfig,
+      payment: paymentConfig,
+      devenv: devEnvConfig,
+      skipGit: options.skipGit,
+      skipInstall: options.skipInstall
+    });
+    logger7.success("Project created successfully");
+    logger7.info("[8/8] Done!");
+    printPostCreateSummary(projectConfig.projectName);
+  } catch (err) {
+    formatCreateError(err);
+    process.exit(1);
   }
-  logger6.info("[6/8] Configure development environment");
-  const devEnvConfig = nonInteractive ? { createDevContainer: false, createDevbox: false } : await promptDevEnvConfig();
-  logger6.success(
-    `Dev Container: ${devEnvConfig.createDevContainer ? "Yes" : "No"}, Devbox: ${devEnvConfig.createDevbox ? "Yes" : "No"}`
-  );
-  logger6.info("[7/8] Creating project...");
-  await createProject({
-    project: projectConfig,
-    database: databaseConfig,
-    storage: storageConfig,
-    payment: paymentConfig,
-    devenv: devEnvConfig,
-    skipGit: options.skipGit,
-    skipInstall: options.skipInstall
-  });
-  logger6.success("Project created successfully");
-  logger6.info("[8/8] Next steps");
-  logger6.divider();
-  logger6.info(`cd ${projectConfig.projectName}`);
-  logger6.info("pnpm install");
-  logger6.info("pnpm dev");
-  logger6.divider();
-  logger6.success(`Project ${projectConfig.projectName} created successfully`);
 }
 
 // src/commands/db.ts
 import fs8 from "fs/promises";
 import path8 from "path";
-import { createLogger as createLogger7 } from "@revealui/setup/utils";
+import { createLogger as createLogger8 } from "@revealui/setup/utils";
 import { execa as execa4 } from "execa";
 
 // src/utils/command.ts
@@ -1066,7 +1347,7 @@ function findWorkspaceRoot(startDir = process.cwd()) {
 }
 
 // src/commands/db.ts
-var logger7 = createLogger7({ prefix: "DB" });
+var logger8 = createLogger8({ prefix: "DB" });
 function isPgCtlNotRunningError(error) {
   return typeof error === "object" && error !== null && "exitCode" in error && error.exitCode === 3;
 }
@@ -1127,7 +1408,7 @@ async function runDbInitCommand(options = {}) {
     }
   );
   await writeLocalDbConfigs(pgdata);
-  logger7.success(`PostgreSQL initialized at ${pgdata}`);
+  logger8.success(`PostgreSQL initialized at ${pgdata}`);
 }
 async function runDbStartCommand() {
   const root = getWorkspaceRootOrThrow();
@@ -1166,7 +1447,7 @@ async function runDbStatusCommand() {
     });
   } catch (error) {
     if (isPgCtlNotRunningError(error)) {
-      logger7.warn(`PostgreSQL is not running (PGDATA: ${pgdata})`);
+      logger8.warn(`PostgreSQL is not running (PGDATA: ${pgdata})`);
       return;
     }
     throw error;
@@ -1210,7 +1491,7 @@ async function runDbCleanupCommand(options = {}) {
 }
 
 // src/commands/dev.ts
-import { createLogger as createLogger10 } from "@revealui/setup/utils";
+import { createLogger as createLogger11 } from "@revealui/setup/utils";
 import { execa as execa6 } from "execa";
 
 // src/runtime/doctor.ts
@@ -1346,8 +1627,8 @@ function writeDevConfig(config, startDir = process.cwd()) {
 }
 
 // src/commands/doctor.ts
-import { createLogger as createLogger8 } from "@revealui/setup/utils";
-var logger8 = createLogger8({ prefix: "Doctor" });
+import { createLogger as createLogger9 } from "@revealui/setup/utils";
+var logger9 = createLogger9({ prefix: "Doctor" });
 function getDoctorFixPlan(report) {
   const attempted = [];
   const skipped = [];
@@ -1405,7 +1686,7 @@ async function runDoctorCommand(options = {}) {
 `);
   if (options.fix) {
     if (fixPlan.attempted.length === 0) {
-      logger8.warn("No safe automatic fixes available");
+      logger9.warn("No safe automatic fixes available");
     } else {
       await applyDoctorFixes(report);
       report = await gatherDoctorReport();
@@ -1414,7 +1695,7 @@ async function runDoctorCommand(options = {}) {
     }
   }
   if (report.checks.some((check) => !check.ok)) {
-    logger8.warn("Some checks failed");
+    logger9.warn("Some checks failed");
     if (options.strict || options.json || process.env.CI) {
       process.exitCode = 1;
     }
@@ -1422,9 +1703,9 @@ async function runDoctorCommand(options = {}) {
 }
 
 // src/commands/shell.ts
-import { createLogger as createLogger9 } from "@revealui/setup/utils";
+import { createLogger as createLogger10 } from "@revealui/setup/utils";
 import { execa as execa5 } from "execa";
-var logger9 = createLogger9({ prefix: "Shell" });
+var logger10 = createLogger10({ prefix: "Shell" });
 async function runShellCommand(options = {}) {
   if (!(options.inside || process.env.IN_NIX_SHELL) && await commandExists("nix")) {
     const workspaceRoot = findWorkspaceRoot();
@@ -1469,12 +1750,12 @@ async function runShellCommand(options = {}) {
   }
   process.stdout.write(`${formatDoctorReport(freshReport)}
 `);
-  logger9.info("Use `revealui doctor --json` for machine-readable status.");
+  logger10.info("Use `revealui doctor --json` for machine-readable status.");
   return false;
 }
 
 // src/commands/dev.ts
-var logger10 = createLogger10({ prefix: "Dev" });
+var logger11 = createLogger11({ prefix: "Dev" });
 var DEV_PROFILES = {
   local: {},
   agent: {
@@ -1600,20 +1881,20 @@ async function runDevUpCommand(options = {}) {
   process.stdout.write(`${formatDevActions(plan)}
 `);
   if (plan.dryRun) {
-    logger10.info("Dry run only; no migrations or services were started.");
+    logger11.info("Dry run only; no migrations or services were started.");
     return;
   }
   if (options.fix) {
     await runDoctorCommand({ fix: true });
   }
   await runDbMigrateCommand();
-  logger10.success("Database migration complete");
+  logger11.success("Database migration complete");
   if (shouldIncludeMcp(resolved.include)) {
     const workspaceRoot = findWorkspaceRoot();
     if (!workspaceRoot) {
       throw new Error("RevealUI workspace root not found");
     }
-    logger10.info("Validating MCP setup");
+    logger11.info("Validating MCP setup");
     await execa6("pnpm", ["setup:mcp"], {
       cwd: workspaceRoot,
       stdio: "inherit"
@@ -1624,7 +1905,7 @@ async function runDevUpCommand(options = {}) {
     if (!workspaceRoot) {
       throw new Error("RevealUI workspace root not found");
     }
-    logger10.info(`Starting dev script: ${resolved.script}`);
+    logger11.info(`Starting dev script: ${resolved.script}`);
     await execa6("pnpm", [resolved.script], {
       cwd: workspaceRoot,
       stdio: "inherit"
@@ -1682,7 +1963,7 @@ async function runDevProfileSetCommand(profile) {
     );
   }
   const configPath = writeDevConfig({ defaultProfile: profile });
-  logger10.success(`Default dev profile set to "${profile}" in ${configPath}`);
+  logger11.success(`Default dev profile set to "${profile}" in ${configPath}`);
 }
 async function runDevProfileShowCommand(options = {}) {
   const configuredProfile = getConfiguredProfile() ?? null;
@@ -1696,10 +1977,10 @@ async function runDevProfileShowCommand(options = {}) {
 }
 
 // src/cli.ts
-var logger11 = createLogger11({ prefix: "CLI" });
+var logger12 = createLogger12({ prefix: "CLI" });
 function configureCreateCommand(command, legacyName) {
   command.description("Create a new RevealUI project").argument("[project-name]", "Name of the project").option("-t, --template <name>", "Template to use (basic-blog, e-commerce, portfolio)").option("--skip-git", "Skip git initialization", false).option("--skip-install", "Skip dependency installation", false).option("-y, --yes", "Skip all prompts and use defaults", false).action(async (projectName, options) => {
-    logger11.header(legacyName ? "Create RevealUI Project" : "RevealUI Create");
+    logger12.header(legacyName ? "Create RevealUI Project" : "RevealUI Create");
     await runCreateFlow(projectName, options);
   });
   return command;
@@ -1711,6 +1992,17 @@ function createCli() {
   program.command("doctor").description("Check RevealUI workspace and developer environment health").option("--json", "Output machine-readable JSON", false).option("--fix", "Apply safe automatic fixes when possible", false).option("--strict", "Exit nonzero when checks fail", false).action(async (options) => {
     await runDoctorCommand(options);
   });
+  const agent = program.command("agent").description("RevealUI coding agent (powered by local or cloud LLMs)");
+  agent.option("-p, --prompt <text>", "Run a single prompt in headless mode").action(async (options) => {
+    if (options.prompt) {
+      await runAgentHeadlessCommand(options.prompt);
+    } else {
+      await runAgentReplCommand();
+    }
+  });
+  agent.command("status").description("Show agent status: model, provider, project root").action(async () => {
+    await runAgentStatusCommand();
+  });
   const db = program.command("db").description("Manage the local RevealUI database");
   db.command("init").description("Initialize the local PostgreSQL data directory").option("--force", "Delete and recreate the local data directory", false).action(async (options) => {
     await runDbInitCommand(options);