@mandujs/cli 0.15.1 → 0.15.3

package/src/commands/openapi.ts

@@ -3,10 +3,10 @@
  * OpenAPI 스펙 생성 명령어
  */
 
-import { generateOpenAPIDocument, openAPIToJSON, validateAndReport } from "@mandujs/core";
-import path from "path";
-import fs from "fs/promises";
-import { resolveManifest } from "../util/manifest";
+import { generateOpenAPIDocument, openAPIToJSON, validateAndReport } from "@mandujs/core";
+import path from "path";
+import fs from "fs/promises";
+import { resolveManifest } from "../util/manifest";
 
 interface OpenAPIGenerateOptions {
   output?: string;
@@ -14,78 +14,78 @@ interface OpenAPIGenerateOptions {
   version?: string;
 }
 
-interface OpenAPIServeOptions {
-  port?: number;
-}
-
-function normalizePort(value: string | number | undefined, label: string): number | undefined {
-  if (value === undefined || value === null || value === "") {
-    return undefined;
-  }
-  const port = typeof value === "string" ? Number(value) : value;
-  if (!Number.isFinite(port) || !Number.isInteger(port)) {
-    console.warn(`⚠️  Invalid ${label} value: "${value}" (using default)`);
-    return undefined;
-  }
-  if (port < 1 || port > 65535) {
-    console.warn(`⚠️  Invalid ${label} range: ${port} (must be 1-65535, using default)`);
-    return undefined;
-  }
-  return port;
-}
-
-function isPortInUse(error: unknown): boolean {
-  if (!error || typeof error !== "object") return false;
-  const code = (error as { code?: string }).code;
-  const message = (error as { message?: string }).message ?? "";
-  return code === "EADDRINUSE" || message.includes("EADDRINUSE") || message.includes("address already in use");
-}
-
-function serveWithAutoPort(
-  startPort: number,
-  fetch: (req: Request) => Response
-): { server: ReturnType<typeof Bun.serve>; port: number; attempts: number } {
-  const maxAttempts = 10;
-  let lastError: unknown = null;
-
-  for (let attempt = 0; attempt < maxAttempts; attempt++) {
-    const candidate = startPort + attempt;
-    if (candidate < 1 || candidate > 65535) {
-      continue;
-    }
-    try {
-      const server = Bun.serve({ port: candidate, fetch });
-      return { server, port: server.port ?? candidate, attempts: attempt };
-    } catch (error) {
-      if (!isPortInUse(error)) {
-        throw error;
-      }
-      lastError = error;
-    }
-  }
-
-  throw lastError ?? new Error(`No available port found starting at ${startPort}`);
-}
-
-/**
- * Generate OpenAPI specification from contracts
- */
-export async function openAPIGenerate(options: OpenAPIGenerateOptions = {}): Promise<boolean> {
-  const rootDir = process.cwd();
-
-  console.log(`\n📄 Generating OpenAPI specification...\n`);
-
-  // Load manifest (FS Routes 우선)
-  let manifest: Awaited<ReturnType<typeof resolveManifest>>["manifest"];
-  try {
-    const config = await validateAndReport(rootDir);
-    if (!config) return false;
-    const resolved = await resolveManifest(rootDir, { fsRoutes: config.fsRoutes });
-    manifest = resolved.manifest;
-  } catch (error) {
-    console.error("❌ Failed to load manifest:", error instanceof Error ? error.message : error);
-    return false;
-  }
+interface OpenAPIServeOptions {
+  port?: number;
+}
+
+function normalizePort(value: string | number | undefined, label: string): number | undefined {
+  if (value === undefined || value === null || value === "") {
+    return undefined;
+  }
+  const port = typeof value === "string" ? Number(value) : value;
+  if (!Number.isFinite(port) || !Number.isInteger(port)) {
+    console.warn(`⚠️  Invalid ${label} value: "${value}" (using default)`);
+    return undefined;
+  }
+  if (port < 1 || port > 65535) {
+    console.warn(`⚠️  Invalid ${label} range: ${port} (must be 1-65535, using default)`);
+    return undefined;
+  }
+  return port;
+}
+
+function isPortInUse(error: unknown): boolean {
+  if (!error || typeof error !== "object") return false;
+  const code = (error as { code?: string }).code;
+  const message = (error as { message?: string }).message ?? "";
+  return code === "EADDRINUSE" || message.includes("EADDRINUSE") || message.includes("address already in use");
+}
+
+function serveWithAutoPort(
+  startPort: number,
+  fetch: (req: Request) => Response
+): { server: ReturnType<typeof Bun.serve>; port: number; attempts: number } {
+  const maxAttempts = 10;
+  let lastError: unknown = null;
+
+  for (let attempt = 0; attempt < maxAttempts; attempt++) {
+    const candidate = startPort + attempt;
+    if (candidate < 1 || candidate > 65535) {
+      continue;
+    }
+    try {
+      const server = Bun.serve({ port: candidate, fetch });
+      return { server, port: server.port ?? candidate, attempts: attempt };
+    } catch (error) {
+      if (!isPortInUse(error)) {
+        throw error;
+      }
+      lastError = error;
+    }
+  }
+
+  throw lastError ?? new Error(`No available port found starting at ${startPort}`);
+}
+
+/**
+ * Generate OpenAPI specification from contracts
+ */
+export async function openAPIGenerate(options: OpenAPIGenerateOptions = {}): Promise<boolean> {
+  const rootDir = process.cwd();
+
+  console.log(`\n📄 Generating OpenAPI specification...\n`);
+
+  // Load manifest (FS Routes 우선)
+  let manifest: Awaited<ReturnType<typeof resolveManifest>>["manifest"];
+  try {
+    const config = await validateAndReport(rootDir);
+    if (!config) return false;
+    const resolved = await resolveManifest(rootDir, { fsRoutes: config.fsRoutes });
+    manifest = resolved.manifest;
+  } catch (error) {
+    console.error("❌ Failed to load manifest:", error instanceof Error ? error.message : error);
+    return false;
+  }
 
   // Count routes with contracts
   const contractRoutes = manifest.routes.filter((r) => r.contractModule);
@@ -148,16 +148,16 @@ export async function openAPIGenerate(options: OpenAPIGenerateOptions = {}): Pro
 /**
  * Serve Swagger UI for OpenAPI documentation
  */
-export async function openAPIServe(options: OpenAPIServeOptions = {}): Promise<boolean> {
-  const rootDir = process.cwd();
-  const config = await validateAndReport(rootDir);
-  if (!config) return false;
-
-  const optionPort = normalizePort(options.port, "openapi.port");
-  const envPort = normalizePort(process.env.PORT, "PORT");
-  const configPort = normalizePort(config.server?.port, "mandu.config server.port");
-  const desiredPort = optionPort ?? envPort ?? configPort ?? 8080;
-  const openAPIPath = path.join(rootDir, "openapi.json");
+export async function openAPIServe(options: OpenAPIServeOptions = {}): Promise<boolean> {
+  const rootDir = process.cwd();
+  const config = await validateAndReport(rootDir);
+  if (!config) return false;
+
+  const optionPort = normalizePort(options.port, "openapi.port");
+  const envPort = normalizePort(process.env.PORT, "PORT");
+  const configPort = normalizePort(config.server?.port, "mandu.config server.port");
+  const desiredPort = optionPort ?? envPort ?? configPort ?? 8080;
+  const openAPIPath = path.join(rootDir, "openapi.json");
 
   console.log(`\n🌐 Starting OpenAPI documentation server...\n`);
 
@@ -212,27 +212,27 @@ export async function openAPIServe(options: OpenAPIServeOptions = {}): Promise<b
 </html>
   `.trim();
 
-  // Start server (auto port fallback)
-  const { port, attempts } = serveWithAutoPort(desiredPort, (req) => {
-      const url = new URL(req.url);
-
-      if (url.pathname === "/openapi.json") {
-        return new Response(specContent, {
-          headers: { "Content-Type": "application/json" },
-        });
-      }
-
-      return new Response(swaggerHTML, {
-        headers: { "Content-Type": "text/html" },
-      });
-  });
-
-  if (attempts > 0) {
-    console.warn(`⚠️  Port ${desiredPort} is in use. Using ${port} instead.`);
-  }
-
-  console.log(`✅ Swagger UI is running at http://localhost:${port}`);
-  console.log(`   OpenAPI spec: http://localhost:${port}/openapi.json`);
+  // Start server (auto port fallback)
+  const { port, attempts } = serveWithAutoPort(desiredPort, (req) => {
+      const url = new URL(req.url);
+
+      if (url.pathname === "/openapi.json") {
+        return new Response(specContent, {
+          headers: { "Content-Type": "application/json" },
+        });
+      }
+
+      return new Response(swaggerHTML, {
+        headers: { "Content-Type": "text/html" },
+      });
+  });
+
+  if (attempts > 0) {
+    console.warn(`⚠️  Port ${desiredPort} is in use. Using ${port} instead.`);
+  }
+
+  console.log(`✅ Swagger UI is running at http://localhost:${port}`);
+  console.log(`   OpenAPI spec: http://localhost:${port}/openapi.json`);
   console.log(`\nPress Ctrl+C to stop.\n`);
 
   // Keep server running

package/src/commands/registry.ts

@@ -70,6 +70,7 @@ registerCommand({
     const { init } = await import("./init");
     return init({
       name: ctx.options.name || ctx.options._positional,
+      template: ctx.options.template,
       css: ctx.options.css as any,
       ui: ctx.options.ui as any,
       theme: ctx.options.theme === "true",

package/src/commands/start.ts

@@ -8,12 +8,6 @@ import {
   startServer,
   loadEnv,
   validateAndReport,
-  readLockfile,
-  readMcpConfig,
-  validateWithPolicy,
-  detectMode,
-  formatPolicyAction,
-  formatValidationResult,
   type RoutesManifest,
   type BundleManifest,
 } from "@mandujs/core";
@@ -21,6 +15,11 @@ import { resolveFromCwd } from "../util/fs";
 import { CLI_ERROR_CODES, printCLIError } from "../errors";
 import { resolveManifest } from "../util/manifest";
 import { resolveAvailablePort } from "../util/port";
+import {
+  validateRuntimeLockfile,
+  handleBlockedLockfile,
+  printRuntimeLockfileStatus,
+} from "../util/lockfile";
 import { registerManifestHandlers } from "../util/handlers";
 import path from "path";
 import fs from "fs";
@@ -55,48 +54,15 @@ export async function start(options: StartOptions = {}): Promise<void> {
   }
 
   // Lockfile 검증 (strict: block 정책)
-  const lockfile = await readLockfile(rootDir);
-  let mcpConfig: Record<string, unknown> | null = null;
-  try {
-    mcpConfig = await readMcpConfig(rootDir);
-  } catch (error) {
-    console.warn(
-      `⚠️  MCP 설정 로드 실패: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
-  const { result: lockResult, action, bypassed } = validateWithPolicy(
-    config,
-    lockfile,
-    detectMode(),
-    mcpConfig
-  );
-
-  if (action === "block") {
-    console.error("🛑 서버 시작 차단: Lockfile 불일치");
-    console.error("   설정이 변경되었습니다. 의도한 변경이라면:");
-    console.error("   $ mandu lock");
-    console.error("");
-    console.error("   변경 사항 확인:");
-    console.error("   $ mandu lock --diff");
-    if (lockResult) {
-      console.error("");
-      console.error(formatValidationResult(lockResult));
-    }
-    process.exit(1);
-  }
+  const { lockfile, lockResult, action, bypassed } = await validateRuntimeLockfile(config, rootDir);
+  handleBlockedLockfile(action, lockResult);
 
   const serverConfig = config.server ?? {};
 
   console.log(`🥟 Mandu Production Server`);
 
   // Lockfile 상태 출력
-  if (action === "warn") {
-    console.log(`⚠️  ${formatPolicyAction(action, bypassed)}`);
-  } else if (lockfile && lockResult?.valid) {
-    console.log(`🔒 설정 무결성 확인됨 (${lockResult.currentHash?.slice(0, 8)})`);
-  } else if (!lockfile) {
-    console.log(`💡 Lockfile 없음 - 'mandu lock'으로 생성 권장`);
-  }
+  printRuntimeLockfileStatus(action, bypassed, lockfile, lockResult);
 
   // .env 파일 로드 (production 모드)
   const envResult = await loadEnv({
@@ -167,6 +133,7 @@ export async function start(options: StartOptions = {}): Promise<void> {
     bundleManifest,
     cors: serverConfig.cors,
     streaming: serverConfig.streaming,
+    rateLimit: serverConfig.rateLimit,
   });
 
   const actualPort = server.server.port ?? port;

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";