@mandujs/cli 0.10.0 → 0.12.0

package/src/main.ts

@@ -1,35 +1,23 @@
 #!/usr/bin/env bun
 
-import { specUpsert } from "./commands/spec-upsert";
-import { generateApply } from "./commands/generate-apply";
-import { guardCheck } from "./commands/guard-check";
-import { guardArch } from "./commands/guard-arch";
-import { check } from "./commands/check";
-import { dev } from "./commands/dev";
-import { init } from "./commands/init";
-import { build } from "./commands/build";
-import { contractCreate, contractValidate, contractBuild, contractDiff } from "./commands/contract";
-import { openAPIGenerate, openAPIServe } from "./commands/openapi";
-import {
-  changeBegin,
-  changeCommit,
-  changeRollback,
-  changeStatus,
-  changeList,
-  changePrune,
-} from "./commands/change";
-import { doctor } from "./commands/doctor";
-import { watch } from "./commands/watch";
-import { brainSetup, brainStatus } from "./commands/brain";
-import { routesGenerate, routesList, routesWatch } from "./commands/routes";
-import { monitor } from "./commands/monitor";
-import { runLockCommand, lockHelp } from "./commands/lock";
+/**
+ * Mandu CLI - Agent-Native Fullstack Framework
+ *
+ * DNA-010: Command Registry Pattern 적용
+ * - 선언적 명령어 등록
+ * - 레이지 로딩으로 시작 시간 최적화
+ */
+
+import { commandRegistry, getCommand, type CommandContext } from "./commands/registry";
 import { CLI_ERROR_CODES, handleCLIError, printCLIError } from "./errors";
+import { shouldShowBanner, renderHeroBanner, theme } from "./terminal";
+
+const VERSION = "0.10.0";
 
 const HELP_TEXT = `
-🥟 Mandu CLI - Agent-Native Fullstack Framework
+${theme.heading("🥟 Mandu CLI")} ${theme.muted(`v${VERSION}`)} - Agent-Native Fullstack Framework
 
-Usage: bunx mandu <command> [options]
+${theme.heading("Usage:")} ${theme.command("bunx mandu")} ${theme.option("<command>")} [options]
 
 Commands:
   init              새 프로젝트 생성 (Tailwind + shadcn/ui 기본 포함)
@@ -149,20 +137,42 @@ Brain (sLLM) Workflow:
   1. brain setup → 2. doctor (분석) → 3. watch (감시)
 `;
 
-function parseArgs(args: string[]): { command: string; options: Record<string, string> } {
-  const command = args[0] || "";
-  const options: Record<string, string> = {};
-
-  for (let i = 1; i < args.length; i++) {
-    const arg = args[i];
-    if (arg.startsWith("--")) {
-      const key = arg.slice(2);
-      const value = args[i + 1] && !args[i + 1].startsWith("--") ? args[++i] : "true";
-      options[key] = value;
-    } else if (arg === "-h") {
-      options["help"] = "true";
-    } else if (!options._positional) {
-      // First non-flag argument after command is positional (e.g., project name)
+/**
+ * 인자 파싱
+ */
+function parseArgs(args: string[]): { command: string; options: Record<string, string> } {
+  const options: Record<string, string> = {};
+  let command = "";
+  const shortFlags: Record<string, string> = {
+    h: "help",
+    q: "quiet",
+    v: "verify",
+    d: "diff",
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    // 플래그 처리
+    if (arg.startsWith("--")) {
+      const key = arg.slice(2);
+      const value = args[i + 1] && !args[i + 1].startsWith("--") ? args[++i] : "true";
+      options[key] = value;
+    } else if (arg.startsWith("-") && arg.length > 1) {
+      const flags = arg.slice(1).split("");
+      for (const flag of flags) {
+        const mapped = shortFlags[flag];
+        if (mapped) {
+          options[mapped] = "true";
+        } else {
+          options[flag] = "true";
+        }
+      }
+    } else if (!command) {
+      // 첫 번째 비플래그 인자가 명령어
+      command = arg;
+    } else if (!options._positional) {
+      // 두 번째 비플래그 인자가 positional
       options._positional = arg;
     }
   }
@@ -170,274 +180,56 @@ function parseArgs(args: string[]): { command: string; options: Record<string, s
   return { command, options };
 }
 
+/**
+ * 메인 함수
+ */
 async function main(): Promise<void> {
   const args = process.argv.slice(2);
   const { command, options } = parseArgs(args);
 
+  // 도움말 처리
   if (options.help || command === "help" || !command) {
     console.log(HELP_TEXT);
     process.exit(0);
   }
 
-  let success = true;
-
-  switch (command) {
-    case "init":
-      success = await init({
-        name: options.name || options._positional,
-        css: options.css as any,
-        ui: options.ui as any,
-        theme: options.theme === "true",
-        minimal: options.minimal === "true",
-      });
-      break;
-
-    case "spec-upsert":
-      success = await specUpsert({ file: options.file });
-      break;
-
-    case "generate":
-      success = await generateApply();
-      break;
-
-    case "check":
-      success = await check();
-      break;
-
-    case "guard": {
-      const subCommand = args[1];
-      const hasSubCommand = subCommand && !subCommand.startsWith("--");
-      const guardArchOptions = {
-        watch: options.watch === "true",
-        output: options.output,
-      };
-      switch (subCommand) {
-        case "arch":
-          success = await guardArch(guardArchOptions);
-          break;
-        case "legacy":
-        case "spec":
-          success = await guardCheck();
-          break;
-        default:
-          if (hasSubCommand) {
-            printCLIError(CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND, {
-              command: "guard",
-              subcommand,
-            });
-            console.log("\nUsage: bunx mandu guard <arch|legacy>");
-            process.exit(1);
-          }
-          // 기본값: architecture guard
-          success = await guardArch(guardArchOptions);
-      }
-      break;
-    }
-
-    case "build":
-      success = await build({
-        watch: options.watch === "true",
-      });
-      break;
-
-    case "dev":
-      await dev();
-      break;
-
-    case "routes": {
-      const subCommand = args[1];
-      switch (subCommand) {
-        case "generate":
-          success = await routesGenerate({
-            output: options.output,
-            verbose: options.verbose === "true",
-          });
-          break;
-        case "list":
-          success = await routesList({
-            verbose: options.verbose === "true",
-          });
-          break;
-        case "watch":
-          success = await routesWatch({
-            output: options.output,
-            verbose: options.verbose === "true",
-          });
-          break;
-        default:
-          // 기본값: list
-          if (!subCommand) {
-            success = await routesList({
-              verbose: options.verbose === "true",
-            });
-          } else {
-            printCLIError(CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND, {
-              command: "routes",
-              subcommand,
-            });
-            console.log("\nUsage: bunx mandu routes <generate|list|watch>");
-            process.exit(1);
-          }
-      }
-      break;
-    }
+  // 히어로 배너 표시
+  if (shouldShowBanner(args)) {
+    await renderHeroBanner(VERSION);
+  }
 
-    case "contract": {
-      const subCommand = args[1];
-      switch (subCommand) {
-        case "create": {
-          const routeId = args[2] || options._positional;
-          if (!routeId) {
-            printCLIError(CLI_ERROR_CODES.MISSING_ARGUMENT, { argument: "routeId" });
-            console.log("\nUsage: bunx mandu contract create <routeId>");
-            process.exit(1);
-          }
-          success = await contractCreate({ routeId });
-          break;
-        }
-        case "validate":
-          success = await contractValidate({ verbose: options.verbose === "true" });
-          break;
-        case "build":
-          success = await contractBuild({ output: options.output });
-          break;
-        case "diff":
-          success = await contractDiff({
-            from: options.from,
-            to: options.to,
-            output: options.output,
-            json: options.json === "true",
-          });
-          break;
-        default:
-          printCLIError(CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND, {
-            command: "contract",
-            subcommand,
-          });
-          console.log("\nUsage: bunx mandu contract <create|validate|build|diff>");
-          process.exit(1);
-      }
-      break;
-    }
+  // DNA-010: 레지스트리에서 명령어 조회
+  const registration = getCommand(command);
 
-    case "openapi": {
-      const subCommand = args[1];
-      switch (subCommand) {
-        case "generate":
-          success = await openAPIGenerate({
-            output: options.output,
-            title: options.title,
-            version: options.version,
-          });
-          break;
-        case "serve":
-          success = await openAPIServe();
-          break;
-        default:
-          printCLIError(CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND, {
-            command: "openapi",
-            subcommand,
-          });
-          console.log("\nUsage: bunx mandu openapi <generate|serve>");
-          process.exit(1);
-      }
-      break;
-    }
+  if (!registration) {
+    printCLIError(CLI_ERROR_CODES.UNKNOWN_COMMAND, { command });
+    console.log(HELP_TEXT);
+    process.exit(1);
+  }
 
-    case "change": {
-      const subCommand = args[1];
-      switch (subCommand) {
-        case "begin":
-          success = await changeBegin({ message: options.message });
-          break;
-        case "commit":
-          success = await changeCommit();
-          break;
-        case "rollback":
-          success = await changeRollback({ id: options.id });
-          break;
-        case "status":
-          success = await changeStatus();
-          break;
-        case "list":
-          success = await changeList();
-          break;
-        case "prune":
-          success = await changePrune({
-            keep: options.keep ? Number(options.keep) : undefined,
-          });
-          break;
-        default:
-          printCLIError(CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND, {
-            command: "change",
-            subcommand,
-          });
-          console.log(`\nUsage: bunx mandu change <begin|commit|rollback|status|list|prune>`);
-          process.exit(1);
-      }
-      break;
-    }
+  // 명령어 실행 컨텍스트
+  const ctx: CommandContext = { args, options };
 
-    case "doctor":
-      success = await doctor({
-        useLLM: options["no-llm"] !== "true",
-        output: options.output,
-      });
-      break;
+  // 명령어 실행
+  const success = await registration.run(ctx);
 
-    case "watch":
-      success = await watch({
-        status: options.status === "true",
-        debounce: options.debounce ? Number(options.debounce) : undefined,
+  // 서브커맨드 에러 처리
+  if (!success) {
+    const subCommand = args[1];
+    if (registration.subcommands && subCommand && !subCommand.startsWith("--")) {
+      // 알 수 없는 서브커맨드
+      printCLIError(CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND, {
+        command,
+        subcommand: subCommand,
       });
-      break;
-
-    case "monitor":
-      success = await monitor({
-        summary: options.summary === "true",
-        since: options.since,
-        follow: options.follow === "false" ? false : true,
-        file: options.file,
+      console.log(`\nUsage: bunx mandu ${command} <${registration.subcommands.join("|")}>`);
+    } else if (registration.subcommands) {
+      // 서브커맨드 필요
+      printCLIError(CLI_ERROR_CODES.MISSING_ARGUMENT, {
+        argument: "subcommand",
       });
-      break;
-
-    case "brain": {
-      const subCommand = args[1];
-      switch (subCommand) {
-        case "setup":
-          success = await brainSetup({
-            model: options.model,
-            url: options.url,
-            skipCheck: options["skip-check"] === "true",
-          });
-          break;
-        case "status":
-          success = await brainStatus({
-            verbose: options.verbose === "true",
-          });
-          break;
-        default:
-          printCLIError(CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND, {
-            command: "brain",
-            subcommand,
-          });
-          console.log("\nUsage: bunx mandu brain <setup|status>");
-          process.exit(1);
-      }
-      break;
+      console.log(`\nUsage: bunx mandu ${command} <${registration.subcommands.join("|")}>`);
     }
-
-    case "lock":
-      success = await runLockCommand(args.slice(1));
-      break;
-
-    default:
-      printCLIError(CLI_ERROR_CODES.UNKNOWN_COMMAND, { command });
-      console.log(HELP_TEXT);
-      process.exit(1);
-  }
-
-  if (!success) {
     process.exit(1);
   }
 }

package/src/terminal/banner.ts

@@ -0,0 +1,166 @@
+/**
+ * DNA-017: Hero Banner with cfonts + gradient
+ *
+ * Sexy ASCII art banner for CLI startup
+ * Inspired by Claude Code, Vite, Astro CLI screens
+ *
+ * @see https://github.com/dominikwilkowski/cfonts
+ */
+
+import { theme, isRich, stripAnsi } from "./theme.js";
+import { MANDU_PALETTE } from "./palette.js";
+
+/**
+ * Check if banner should be displayed
+ */
+export function shouldShowBanner(argv: string[]): boolean {
+  // Environment-based skip
+  if (process.env.MANDU_NO_BANNER) return false;
+  if (process.env.CI) return false;
+  if (process.env.CLAUDE_CODE) return false;
+  if (process.env.CODEX_AGENT) return false;
+  if (process.env.MANDU_AGENT) return false;
+
+  // TTY check
+  if (!process.stdout.isTTY) return false;
+
+  // Flag-based skip
+  const hasJsonFlag = argv.includes("--json");
+  const hasQuietFlag = argv.includes("--quiet") || argv.includes("-q");
+  const hasHelpFlag = argv.includes("--help") || argv.includes("-h");
+
+  if (hasJsonFlag || hasQuietFlag || hasHelpFlag) return false;
+
+  return true;
+}
+
+/**
+ * Fallback ASCII art banner (no dependencies)
+ */
+const MANDU_ASCII_SMALL = `
+  ╔╦╗╔═╗╔╗╔╔╦╗╦ ╦
+  ║║║╠═╣║║║ ║║║ ║
+  ╩ ╩╩ ╩╝╚╝═╩╝╚═╝
+`;
+
+const MANDU_ASCII_LARGE = `
+  ███╗   ███╗ █████╗ ███╗   ██╗██████╗ ██╗   ██╗
+  ████╗ ████║██╔══██╗████╗  ██║██╔══██╗██║   ██║
+  ██╔████╔██║███████║██╔██╗ ██║██║  ██║██║   ██║
+  ██║╚██╔╝██║██╔══██║██║╚██╗██║██║  ██║██║   ██║
+  ██║ ╚═╝ ██║██║  ██║██║ ╚████║██████╔╝╚██████╔╝
+  ╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═════╝  ╚═════╝
+`;
+
+/**
+ * Apply gradient effect to text (simple version)
+ */
+function applyGradient(text: string): string {
+  if (!isRich()) return text;
+
+  const lines = text.split("\n");
+  const colorFns = [
+    theme.accentDim,
+    theme.accent,
+    theme.accentBright,
+    theme.accent,
+    theme.accentDim,
+  ];
+
+  return lines
+    .map((line, i) => {
+      const colorIndex = Math.min(i, colorFns.length - 1);
+      const colorFn = colorFns[colorIndex];
+      return colorFn(line);
+    })
+    .join("\n");
+}
+
+/**
+ * Render hero banner with cfonts (if available) or fallback
+ */
+export async function renderHeroBanner(version: string): Promise<void> {
+  const cols = process.stdout.columns ?? 80;
+
+  // Very narrow terminal: minimal output
+  if (cols < 40) {
+    console.log(`\n  🥟 Mandu v${version}\n`);
+    return;
+  }
+
+  // Try cfonts first
+  try {
+    const cfonts = await import("cfonts");
+
+    cfonts.say("MANDU", {
+      font: "block",
+      gradient: [MANDU_PALETTE.accent, MANDU_PALETTE.accentBright],
+      transitionGradient: true,
+      align: "center",
+      space: true,
+      maxLength: Math.min(cols - 4, 80),
+    });
+  } catch {
+    // cfonts not available, use fallback
+    const ascii = cols >= 60 ? MANDU_ASCII_LARGE : MANDU_ASCII_SMALL;
+    console.log(applyGradient(ascii));
+  }
+
+  // Tagline
+  const tagline = `🥟 Agent-Native Web Framework v${version}`;
+  const taglineWidth = stripAnsi(tagline).length;
+  const padding = Math.max(0, Math.floor((cols - taglineWidth) / 2));
+
+  console.log(" ".repeat(padding) + theme.muted(tagline));
+  console.log();
+}
+
+/**
+ * Render minimal banner (for narrow terminals or quick commands)
+ */
+export function renderMiniBanner(version: string): void {
+  if (!isRich()) {
+    console.log(`\nMandu v${version}\n`);
+    return;
+  }
+
+  console.log();
+  console.log(`  ${theme.heading("🥟 Mandu")} ${theme.muted(`v${version}`)}`);
+  console.log(`  ${theme.muted("Agent-Native Web Framework")}`);
+  console.log();
+}
+
+/**
+ * Render box banner (alternative style)
+ */
+export function renderBoxBanner(version: string): void {
+  if (!isRich()) {
+    console.log(`\nMandu v${version}\n`);
+    return;
+  }
+
+  const width = 30;
+  const top = theme.accent("  ╭" + "─".repeat(width) + "╮");
+  const mid1 =
+    theme.accent("  │") +
+    "  " +
+    theme.heading("🥟 Mandu") +
+    " " +
+    theme.muted(`v${version}`) +
+    " ".repeat(width - 18 - version.length) +
+    theme.accent("│");
+  const mid2 =
+    theme.accent("  │") +
+    "  " +
+    theme.muted("Agent-Native Framework") +
+    " ".repeat(width - 24) +
+    theme.accent("│");
+  const bottom = theme.accent("  ╰" + "─".repeat(width) + "╯");
+
+  console.log();
+  console.log(top);
+  console.log(mid1);
+  console.log(mid2);
+  console.log(bottom);
+  console.log();
+}