@mandujs/cli 0.12.2 → 0.13.1

package/src/errors/codes.ts

@@ -1,35 +1,35 @@
-/**
- * CLI error codes
- */
-export const CLI_ERROR_CODES = {
-  // Init errors (E001-E009)
-  INIT_DIR_EXISTS: "CLI_E001",
-  INIT_BUN_NOT_FOUND: "CLI_E002",
-  INIT_TEMPLATE_NOT_FOUND: "CLI_E003",
-
-  // Dev errors (E010-E019)
-  DEV_PORT_IN_USE: "CLI_E010",
-  DEV_MANIFEST_NOT_FOUND: "CLI_E011",
-  DEV_NO_ROUTES: "CLI_E012",
-
-  // Guard errors (E020-E029)
-  GUARD_CONFIG_INVALID: "CLI_E020",
-  GUARD_PRESET_NOT_FOUND: "CLI_E021",
-  GUARD_VIOLATION_FOUND: "CLI_E022",
-
-  // Build errors (E030-E039)
-  BUILD_ENTRY_NOT_FOUND: "CLI_E030",
-  BUILD_BUNDLE_FAILED: "CLI_E031",
-  BUILD_OUTDIR_NOT_WRITABLE: "CLI_E032",
-
-  // Config errors (E040-E049)
-  CONFIG_PARSE_FAILED: "CLI_E040",
-  CONFIG_VALIDATION_FAILED: "CLI_E041",
-
-  // CLI usage errors (E100+)
-  UNKNOWN_COMMAND: "CLI_E100",
-  UNKNOWN_SUBCOMMAND: "CLI_E101",
-  MISSING_ARGUMENT: "CLI_E102",
-} as const;
-
-export type CLIErrorCode = typeof CLI_ERROR_CODES[keyof typeof CLI_ERROR_CODES];
+/**
+ * CLI error codes
+ */
+export const CLI_ERROR_CODES = {
+  // Init errors (E001-E009)
+  INIT_DIR_EXISTS: "CLI_E001",
+  INIT_BUN_NOT_FOUND: "CLI_E002",
+  INIT_TEMPLATE_NOT_FOUND: "CLI_E003",
+
+  // Dev errors (E010-E019)
+  DEV_PORT_IN_USE: "CLI_E010",
+  DEV_MANIFEST_NOT_FOUND: "CLI_E011",
+  DEV_NO_ROUTES: "CLI_E012",
+
+  // Guard errors (E020-E029)
+  GUARD_CONFIG_INVALID: "CLI_E020",
+  GUARD_PRESET_NOT_FOUND: "CLI_E021",
+  GUARD_VIOLATION_FOUND: "CLI_E022",
+
+  // Build errors (E030-E039)
+  BUILD_ENTRY_NOT_FOUND: "CLI_E030",
+  BUILD_BUNDLE_FAILED: "CLI_E031",
+  BUILD_OUTDIR_NOT_WRITABLE: "CLI_E032",
+
+  // Config errors (E040-E049)
+  CONFIG_PARSE_FAILED: "CLI_E040",
+  CONFIG_VALIDATION_FAILED: "CLI_E041",
+
+  // CLI usage errors (E100+)
+  UNKNOWN_COMMAND: "CLI_E100",
+  UNKNOWN_SUBCOMMAND: "CLI_E101",
+  MISSING_ARGUMENT: "CLI_E102",
+} as const;
+
+export type CLIErrorCode = typeof CLI_ERROR_CODES[keyof typeof CLI_ERROR_CODES];

package/src/errors/index.ts

@@ -1,2 +1,2 @@
-export { CLI_ERROR_CODES, type CLIErrorCode } from "./codes";
-export { CLIError, formatCLIError, handleCLIError, printCLIError } from "./messages";
+export { CLI_ERROR_CODES, type CLIErrorCode } from "./codes";
+export { CLIError, formatCLIError, handleCLIError, printCLIError } from "./messages";

package/src/errors/messages.ts

@@ -1,143 +1,143 @@
-import { CLI_ERROR_CODES, type CLIErrorCode } from "./codes";
-
-interface ErrorInfo {
-  message: string;
-  suggestion?: string;
-  docLink?: string;
-}
-
-export const ERROR_MESSAGES: Record<CLIErrorCode, ErrorInfo> = {
-  [CLI_ERROR_CODES.INIT_DIR_EXISTS]: {
-    message: "Directory already exists: {path}",
-    suggestion: "Choose a different project name or remove the existing directory.",
-  },
-  [CLI_ERROR_CODES.INIT_BUN_NOT_FOUND]: {
-    message: "Bun runtime not found.",
-    suggestion: "Install Bun and ensure it is available in your PATH.",
-  },
-  [CLI_ERROR_CODES.INIT_TEMPLATE_NOT_FOUND]: {
-    message: "Template not found: {template}",
-    suggestion: "Use a valid template name (default).",
-  },
-  [CLI_ERROR_CODES.DEV_PORT_IN_USE]: {
-    message: "Port {port} is already in use.",
-    suggestion: "Set PORT or mandu.config server.port to pick a different port, or stop the process using this port.",
-  },
-  [CLI_ERROR_CODES.DEV_MANIFEST_NOT_FOUND]: {
-    message: "Routes manifest not found.",
-    suggestion: "Run `mandu routes generate` or create app/ routes before dev.",
-  },
-  [CLI_ERROR_CODES.DEV_NO_ROUTES]: {
-    message: "No routes were found in app/.",
-    suggestion: "Create app/page.tsx or app/api/*/route.ts to get started.",
-  },
-  [CLI_ERROR_CODES.GUARD_CONFIG_INVALID]: {
-    message: "Invalid guard configuration.",
-    suggestion: "Check your mandu.config and guard settings.",
-  },
-  [CLI_ERROR_CODES.GUARD_PRESET_NOT_FOUND]: {
-    message: "Unknown architecture preset: {preset}",
-    suggestion: "Available presets: mandu, fsd, clean, hexagonal, atomic.",
-  },
-  [CLI_ERROR_CODES.GUARD_VIOLATION_FOUND]: {
-    message: "{count} architecture violation(s) found.",
-    suggestion: "Fix violations above or set MANDU_OUTPUT=agent for AI-friendly output.",
-  },
-  [CLI_ERROR_CODES.BUILD_ENTRY_NOT_FOUND]: {
-    message: "Build entry not found: {entry}",
-    suggestion: "Check your routes manifest or build inputs.",
-  },
-  [CLI_ERROR_CODES.BUILD_BUNDLE_FAILED]: {
-    message: "Bundle build failed for '{target}'.",
-    suggestion: "Review build errors above for missing deps or syntax errors.",
-  },
-  [CLI_ERROR_CODES.BUILD_OUTDIR_NOT_WRITABLE]: {
-    message: "Output directory is not writable: {path}",
-    suggestion: "Ensure the directory exists and you have write permissions.",
-  },
-  [CLI_ERROR_CODES.CONFIG_PARSE_FAILED]: {
-    message: "Failed to parse mandu.config.",
-    suggestion: "Fix syntax errors in the config file.",
-  },
-  [CLI_ERROR_CODES.CONFIG_VALIDATION_FAILED]: {
-    message: "Configuration validation failed.",
-    suggestion: "Review validation errors above and fix your config.",
-  },
-  [CLI_ERROR_CODES.UNKNOWN_COMMAND]: {
-    message: "Unknown command: {command}",
-    suggestion: "Run with --help to see available commands.",
-  },
-  [CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND]: {
-    message: "Unknown subcommand '{subcommand}' for {command}.",
-    suggestion: "Run the command with --help to see available subcommands.",
-  },
-  [CLI_ERROR_CODES.MISSING_ARGUMENT]: {
-    message: "Missing required argument: {argument}",
-    suggestion: "Provide the required argument and try again.",
-  },
-};
-
-function interpolate(text: string, context?: Record<string, string | number>): string {
-  if (!context) return text;
-  let result = text;
-  for (const [key, value] of Object.entries(context)) {
-    result = result.replace(new RegExp(`\\{${key}\\}`, "g"), String(value));
-  }
-  return result;
-}
-
-export function formatCLIError(
-  code: CLIErrorCode,
-  context?: Record<string, string | number>
-): string {
-  const info = ERROR_MESSAGES[code];
-  const message = interpolate(info?.message ?? "Unknown error", context);
-  const suggestion = info?.suggestion ? interpolate(info.suggestion, context) : undefined;
-
-  const lines = ["", `❌ Error [${code}]`, `   ${message}`];
-  if (suggestion) {
-    lines.push("", `💡 ${suggestion}`);
-  }
-  if (info?.docLink) {
-    lines.push(`📖 ${info.docLink}`);
-  }
-  lines.push("");
-  return lines.join("\n");
-}
-
-export class CLIError extends Error {
-  readonly code: CLIErrorCode;
-  readonly context?: Record<string, string | number>;
-
-  constructor(code: CLIErrorCode, context?: Record<string, string | number>) {
-    super(formatCLIError(code, context));
-    this.code = code;
-    this.context = context;
-    this.name = "CLIError";
-  }
-}
-
-export function printCLIError(
-  code: CLIErrorCode,
-  context?: Record<string, string | number>
-): void {
-  console.error(formatCLIError(code, context));
-}
-
-export function handleCLIError(error: unknown): never {
-  if (error instanceof CLIError) {
-    console.error(error.message);
-    process.exit(1);
-  }
-
-  if (error instanceof Error) {
-    console.error(`\n❌ Unexpected error: ${error.message}\n`);
-    if (process.env.DEBUG) {
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-
-  console.error("\n❌ Unknown error occurred\n");
-  process.exit(1);
-}
+import { CLI_ERROR_CODES, type CLIErrorCode } from "./codes";
+
+interface ErrorInfo {
+  message: string;
+  suggestion?: string;
+  docLink?: string;
+}
+
+export const ERROR_MESSAGES: Record<CLIErrorCode, ErrorInfo> = {
+  [CLI_ERROR_CODES.INIT_DIR_EXISTS]: {
+    message: "Directory already exists: {path}",
+    suggestion: "Choose a different project name or remove the existing directory.",
+  },
+  [CLI_ERROR_CODES.INIT_BUN_NOT_FOUND]: {
+    message: "Bun runtime not found.",
+    suggestion: "Install Bun and ensure it is available in your PATH.",
+  },
+  [CLI_ERROR_CODES.INIT_TEMPLATE_NOT_FOUND]: {
+    message: "Template not found: {template}",
+    suggestion: "Use a valid template name (default).",
+  },
+  [CLI_ERROR_CODES.DEV_PORT_IN_USE]: {
+    message: "Port {port} is already in use.",
+    suggestion: "Set PORT or mandu.config server.port to pick a different port, or stop the process using this port.",
+  },
+  [CLI_ERROR_CODES.DEV_MANIFEST_NOT_FOUND]: {
+    message: "Routes manifest not found.",
+    suggestion: "Run `mandu routes generate` or create app/ routes before dev.",
+  },
+  [CLI_ERROR_CODES.DEV_NO_ROUTES]: {
+    message: "No routes were found in app/.",
+    suggestion: "Create app/page.tsx or app/api/*/route.ts to get started.",
+  },
+  [CLI_ERROR_CODES.GUARD_CONFIG_INVALID]: {
+    message: "Invalid guard configuration.",
+    suggestion: "Check your mandu.config and guard settings.",
+  },
+  [CLI_ERROR_CODES.GUARD_PRESET_NOT_FOUND]: {
+    message: "Unknown architecture preset: {preset}",
+    suggestion: "Available presets: mandu, fsd, clean, hexagonal, atomic.",
+  },
+  [CLI_ERROR_CODES.GUARD_VIOLATION_FOUND]: {
+    message: "{count} architecture violation(s) found.",
+    suggestion: "Fix violations above or set MANDU_OUTPUT=agent for AI-friendly output.",
+  },
+  [CLI_ERROR_CODES.BUILD_ENTRY_NOT_FOUND]: {
+    message: "Build entry not found: {entry}",
+    suggestion: "Check your routes manifest or build inputs.",
+  },
+  [CLI_ERROR_CODES.BUILD_BUNDLE_FAILED]: {
+    message: "Bundle build failed for '{target}'.",
+    suggestion: "Review build errors above for missing deps or syntax errors.",
+  },
+  [CLI_ERROR_CODES.BUILD_OUTDIR_NOT_WRITABLE]: {
+    message: "Output directory is not writable: {path}",
+    suggestion: "Ensure the directory exists and you have write permissions.",
+  },
+  [CLI_ERROR_CODES.CONFIG_PARSE_FAILED]: {
+    message: "Failed to parse mandu.config.",
+    suggestion: "Fix syntax errors in the config file.",
+  },
+  [CLI_ERROR_CODES.CONFIG_VALIDATION_FAILED]: {
+    message: "Configuration validation failed.",
+    suggestion: "Review validation errors above and fix your config.",
+  },
+  [CLI_ERROR_CODES.UNKNOWN_COMMAND]: {
+    message: "Unknown command: {command}",
+    suggestion: "Run with --help to see available commands.",
+  },
+  [CLI_ERROR_CODES.UNKNOWN_SUBCOMMAND]: {
+    message: "Unknown subcommand '{subcommand}' for {command}.",
+    suggestion: "Run the command with --help to see available subcommands.",
+  },
+  [CLI_ERROR_CODES.MISSING_ARGUMENT]: {
+    message: "Missing required argument: {argument}",
+    suggestion: "Provide the required argument and try again.",
+  },
+};
+
+function interpolate(text: string, context?: Record<string, string | number>): string {
+  if (!context) return text;
+  let result = text;
+  for (const [key, value] of Object.entries(context)) {
+    result = result.replace(new RegExp(`\\{${key}\\}`, "g"), String(value));
+  }
+  return result;
+}
+
+export function formatCLIError(
+  code: CLIErrorCode,
+  context?: Record<string, string | number>
+): string {
+  const info = ERROR_MESSAGES[code];
+  const message = interpolate(info?.message ?? "Unknown error", context);
+  const suggestion = info?.suggestion ? interpolate(info.suggestion, context) : undefined;
+
+  const lines = ["", `❌ Error [${code}]`, `   ${message}`];
+  if (suggestion) {
+    lines.push("", `💡 ${suggestion}`);
+  }
+  if (info?.docLink) {
+    lines.push(`📖 ${info.docLink}`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+
+export class CLIError extends Error {
+  readonly code: CLIErrorCode;
+  readonly context?: Record<string, string | number>;
+
+  constructor(code: CLIErrorCode, context?: Record<string, string | number>) {
+    super(formatCLIError(code, context));
+    this.code = code;
+    this.context = context;
+    this.name = "CLIError";
+  }
+}
+
+export function printCLIError(
+  code: CLIErrorCode,
+  context?: Record<string, string | number>
+): void {
+  console.error(formatCLIError(code, context));
+}
+
+export function handleCLIError(error: unknown): never {
+  if (error instanceof CLIError) {
+    console.error(error.message);
+    process.exit(1);
+  }
+
+  if (error instanceof Error) {
+    console.error(`\n❌ Unexpected error: ${error.message}\n`);
+    if (process.env.DEBUG) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+
+  console.error("\n❌ Unknown error occurred\n");
+  process.exit(1);
+}

package/src/hooks/index.ts

@@ -1,17 +1,17 @@
-/**
- * DNA-016: CLI Hooks
- *
- * 명령어 라이프사이클 훅
- */
-
-export {
-  preActionRegistry,
-  runPreAction,
-  registerPreActionHook,
-  registerDefaultHooks,
-  setVerbose,
-  isVerbose,
-  setProcessTitle,
-  type PreActionContext,
-  type PreActionHook,
-} from "./preaction.js";
+/**
+ * DNA-016: CLI Hooks
+ *
+ * 명령어 라이프사이클 훅
+ */
+
+export {
+  preActionRegistry,
+  runPreAction,
+  registerPreActionHook,
+  registerDefaultHooks,
+  setVerbose,
+  isVerbose,
+  setProcessTitle,
+  type PreActionContext,
+  type PreActionHook,
+} from "./preaction.js";