@mandujs/cli 0.12.2 → 0.13.1

package/src/commands/routes.ts

@@ -1,228 +1,228 @@
-/**
- * FS Routes CLI Commands
- *
- * 파일 시스템 기반 라우트 관리 명령어
- */
-
-import {
-  scanRoutes,
-  generateManifest,
-  formatRoutesForCLI,
-  watchFSRoutes,
-  validateAndReport,
-  type GenerateOptions,
-  type FSScannerConfig,
-} from "@mandujs/core";
-import { resolveFromCwd } from "../util/fs";
-
-// ═══════════════════════════════════════════════════════════════════════════
-// Types
-// ═══════════════════════════════════════════════════════════════════════════
-
-export interface RoutesGenerateOptions {
-  /** 출력 파일 경로 */
-  output?: string;
-  /** 상세 출력 */
-  verbose?: boolean;
-}
-
-export interface RoutesListOptions {
-  /** 상세 출력 */
-  verbose?: boolean;
-}
-
-export interface RoutesWatchOptions {
-  /** 출력 파일 경로 */
-  output?: string;
-  /** 상세 출력 */
-  verbose?: boolean;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════
-// Commands
-// ═══════════════════════════════════════════════════════════════════════════
-
-/**
- * routes generate - FS Routes 스캔 및 매니페스트 생성
- */
-export async function routesGenerate(options: RoutesGenerateOptions = {}): Promise<boolean> {
-  const rootDir = resolveFromCwd(".");
-  const config = await validateAndReport(rootDir);
-  if (!config) return false;
-
-  console.log("🥟 Mandu FS Routes Generate\n");
-
-  try {
-    const generateOptions: GenerateOptions = {
-      scanner: config.fsRoutes,
-      outputPath: options.output ?? ".mandu/routes.manifest.json",
-      skipLegacy: true, // 레거시 병합 비활성화
-    };
-
-    const result = await generateManifest(rootDir, generateOptions);
-
-    // 결과 출력
-    console.log(`✅ FS Routes 스캔 완료`);
-    console.log(`   📋 라우트: ${result.manifest.routes.length}개\n`);
-
-    // 경고 출력
-    if (result.warnings.length > 0) {
-      console.log("⚠️  경고:");
-      for (const warning of result.warnings) {
-        console.log(`   - ${warning}`);
-      }
-      console.log("");
-    }
-
-    // 라우트 목록 출력
-    if (options.verbose) {
-      console.log(formatRoutesForCLI(result.manifest));
-      console.log("");
-    }
-
-    // 출력 파일 경로
-    if (generateOptions.outputPath) {
-      console.log(`📁 매니페스트 저장: ${generateOptions.outputPath}`);
-    }
-
-    return true;
-  } catch (error) {
-    console.error("❌ FS Routes 생성 실패:", error instanceof Error ? error.message : error);
-    return false;
-  }
-}
-
-/**
- * routes list - 현재 라우트 목록 출력
- */
-export async function routesList(options: RoutesListOptions = {}): Promise<boolean> {
-  const rootDir = resolveFromCwd(".");
-  const config = await validateAndReport(rootDir);
-  if (!config) return false;
-
-  console.log("🥟 Mandu Routes List\n");
-
-  try {
-    const result = await scanRoutes(rootDir, config.fsRoutes);
-
-    if (result.errors.length > 0) {
-      console.log("⚠️  스캔 경고:");
-      for (const error of result.errors) {
-        console.log(`   - ${error.type}: ${error.message}`);
-      }
-      console.log("");
-    }
-
-    if (result.routes.length === 0) {
-      console.log("📭 라우트가 없습니다.");
-      console.log("");
-      console.log("💡 app/ 폴더에 page.tsx 또는 route.ts 파일을 생성하세요.");
-      console.log("");
-      console.log("예시:");
-      console.log("  app/page.tsx        → /");
-      console.log("  app/blog/page.tsx   → /blog");
-      console.log("  app/api/users/route.ts → /api/users");
-      return true;
-    }
-
-    // 라우트 목록 출력
-    console.log(`📋 라우트 (${result.routes.length}개)`);
-    console.log("─".repeat(70));
-
-    for (const route of result.routes) {
-      const icon = route.kind === "page" ? "📄" : "📡";
-      const hydration = route.clientModule ? " 🏝️" : "";
-      const pattern = route.pattern.padEnd(35);
-      const id = route.id;
-
-      console.log(`${icon} ${pattern} → ${id}${hydration}`);
-
-      if (options.verbose) {
-        console.log(`   📁 ${route.sourceFile}`);
-        if (route.clientModule) {
-          console.log(`   🏝️  ${route.clientModule}`);
-        }
-        if (route.layoutChain.length > 0) {
-          console.log(`   📐 layouts: ${route.layoutChain.join(" → ")}`);
-        }
-      }
-    }
-
-    console.log("");
-
-    // 통계
-    console.log("📊 통계");
-    console.log(`   페이지: ${result.stats.pageCount}개`);
-    console.log(`   API: ${result.stats.apiCount}개`);
-    console.log(`   레이아웃: ${result.stats.layoutCount}개`);
-    console.log(`   Island: ${result.stats.islandCount}개`);
-    console.log(`   스캔 시간: ${result.stats.scanTime}ms`);
-
-    return true;
-  } catch (error) {
-    console.error("❌ 라우트 목록 조회 실패:", error instanceof Error ? error.message : error);
-    return false;
-  }
-}
-
-/**
- * routes watch - 실시간 라우트 감시
- */
-export async function routesWatch(options: RoutesWatchOptions = {}): Promise<boolean> {
-  const rootDir = resolveFromCwd(".");
-  const config = await validateAndReport(rootDir);
-  if (!config) return false;
-
-  console.log("🥟 Mandu FS Routes Watch\n");
-  console.log("👀 라우트 변경 감시 중... (Ctrl+C로 종료)\n");
-
-  try {
-    // 초기 스캔
-    const initialResult = await generateManifest(rootDir, {
-      scanner: config.fsRoutes,
-      outputPath: options.output ?? ".mandu/routes.manifest.json",
-    });
-
-    console.log(`✅ 초기 스캔: ${initialResult.manifest.routes.length}개 라우트\n`);
-
-    // 감시 시작
-    const watcher = await watchFSRoutes(rootDir, {
-      scanner: config.fsRoutes,
-      outputPath: options.output ?? ".mandu/routes.manifest.json",
-      onChange: (result) => {
-        const timestamp = new Date().toLocaleTimeString();
-        console.log(`\n🔄 [${timestamp}] 라우트 변경 감지`);
-        console.log(`   📋 총 라우트: ${result.manifest.routes.length}개`);
-
-        if (result.warnings.length > 0) {
-          for (const warning of result.warnings) {
-            console.log(`   ⚠️  ${warning}`);
-          }
-        }
-
-        if (options.verbose) {
-          console.log("");
-          console.log(formatRoutesForCLI(result.manifest));
-        }
-      },
-    });
-
-    // 종료 시그널 처리
-    const cleanup = () => {
-      console.log("\n\n🛑 감시 종료");
-      watcher.close();
-      process.exit(0);
-    };
-
-    process.on("SIGINT", cleanup);
-    process.on("SIGTERM", cleanup);
-
-    // 무한 대기
-    await new Promise(() => {});
-
-    return true;
-  } catch (error) {
-    console.error("❌ 라우트 감시 실패:", error instanceof Error ? error.message : error);
-    return false;
-  }
-}
+/**
+ * FS Routes CLI Commands
+ *
+ * 파일 시스템 기반 라우트 관리 명령어
+ */
+
+import {
+  scanRoutes,
+  generateManifest,
+  formatRoutesForCLI,
+  watchFSRoutes,
+  validateAndReport,
+  type GenerateOptions,
+  type FSScannerConfig,
+} from "@mandujs/core";
+import { resolveFromCwd } from "../util/fs";
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Types
+// ═══════════════════════════════════════════════════════════════════════════
+
+export interface RoutesGenerateOptions {
+  /** 출력 파일 경로 */
+  output?: string;
+  /** 상세 출력 */
+  verbose?: boolean;
+}
+
+export interface RoutesListOptions {
+  /** 상세 출력 */
+  verbose?: boolean;
+}
+
+export interface RoutesWatchOptions {
+  /** 출력 파일 경로 */
+  output?: string;
+  /** 상세 출력 */
+  verbose?: boolean;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Commands
+// ═══════════════════════════════════════════════════════════════════════════
+
+/**
+ * routes generate - FS Routes 스캔 및 매니페스트 생성
+ */
+export async function routesGenerate(options: RoutesGenerateOptions = {}): Promise<boolean> {
+  const rootDir = resolveFromCwd(".");
+  const config = await validateAndReport(rootDir);
+  if (!config) return false;
+
+  console.log("🥟 Mandu FS Routes Generate\n");
+
+  try {
+    const generateOptions: GenerateOptions = {
+      scanner: config.fsRoutes,
+      outputPath: options.output ?? ".mandu/routes.manifest.json",
+      skipLegacy: true, // 레거시 병합 비활성화
+    };
+
+    const result = await generateManifest(rootDir, generateOptions);
+
+    // 결과 출력
+    console.log(`✅ FS Routes 스캔 완료`);
+    console.log(`   📋 라우트: ${result.manifest.routes.length}개\n`);
+
+    // 경고 출력
+    if (result.warnings.length > 0) {
+      console.log("⚠️  경고:");
+      for (const warning of result.warnings) {
+        console.log(`   - ${warning}`);
+      }
+      console.log("");
+    }
+
+    // 라우트 목록 출력
+    if (options.verbose) {
+      console.log(formatRoutesForCLI(result.manifest));
+      console.log("");
+    }
+
+    // 출력 파일 경로
+    if (generateOptions.outputPath) {
+      console.log(`📁 매니페스트 저장: ${generateOptions.outputPath}`);
+    }
+
+    return true;
+  } catch (error) {
+    console.error("❌ FS Routes 생성 실패:", error instanceof Error ? error.message : error);
+    return false;
+  }
+}
+
+/**
+ * routes list - 현재 라우트 목록 출력
+ */
+export async function routesList(options: RoutesListOptions = {}): Promise<boolean> {
+  const rootDir = resolveFromCwd(".");
+  const config = await validateAndReport(rootDir);
+  if (!config) return false;
+
+  console.log("🥟 Mandu Routes List\n");
+
+  try {
+    const result = await scanRoutes(rootDir, config.fsRoutes);
+
+    if (result.errors.length > 0) {
+      console.log("⚠️  스캔 경고:");
+      for (const error of result.errors) {
+        console.log(`   - ${error.type}: ${error.message}`);
+      }
+      console.log("");
+    }
+
+    if (result.routes.length === 0) {
+      console.log("📭 라우트가 없습니다.");
+      console.log("");
+      console.log("💡 app/ 폴더에 page.tsx 또는 route.ts 파일을 생성하세요.");
+      console.log("");
+      console.log("예시:");
+      console.log("  app/page.tsx        → /");
+      console.log("  app/blog/page.tsx   → /blog");
+      console.log("  app/api/users/route.ts → /api/users");
+      return true;
+    }
+
+    // 라우트 목록 출력
+    console.log(`📋 라우트 (${result.routes.length}개)`);
+    console.log("─".repeat(70));
+
+    for (const route of result.routes) {
+      const icon = route.kind === "page" ? "📄" : "📡";
+      const hydration = route.clientModule ? " 🏝️" : "";
+      const pattern = route.pattern.padEnd(35);
+      const id = route.id;
+
+      console.log(`${icon} ${pattern} → ${id}${hydration}`);
+
+      if (options.verbose) {
+        console.log(`   📁 ${route.sourceFile}`);
+        if (route.clientModule) {
+          console.log(`   🏝️  ${route.clientModule}`);
+        }
+        if (route.layoutChain.length > 0) {
+          console.log(`   📐 layouts: ${route.layoutChain.join(" → ")}`);
+        }
+      }
+    }
+
+    console.log("");
+
+    // 통계
+    console.log("📊 통계");
+    console.log(`   페이지: ${result.stats.pageCount}개`);
+    console.log(`   API: ${result.stats.apiCount}개`);
+    console.log(`   레이아웃: ${result.stats.layoutCount}개`);
+    console.log(`   Island: ${result.stats.islandCount}개`);
+    console.log(`   스캔 시간: ${result.stats.scanTime}ms`);
+
+    return true;
+  } catch (error) {
+    console.error("❌ 라우트 목록 조회 실패:", error instanceof Error ? error.message : error);
+    return false;
+  }
+}
+
+/**
+ * routes watch - 실시간 라우트 감시
+ */
+export async function routesWatch(options: RoutesWatchOptions = {}): Promise<boolean> {
+  const rootDir = resolveFromCwd(".");
+  const config = await validateAndReport(rootDir);
+  if (!config) return false;
+
+  console.log("🥟 Mandu FS Routes Watch\n");
+  console.log("👀 라우트 변경 감시 중... (Ctrl+C로 종료)\n");
+
+  try {
+    // 초기 스캔
+    const initialResult = await generateManifest(rootDir, {
+      scanner: config.fsRoutes,
+      outputPath: options.output ?? ".mandu/routes.manifest.json",
+    });
+
+    console.log(`✅ 초기 스캔: ${initialResult.manifest.routes.length}개 라우트\n`);
+
+    // 감시 시작
+    const watcher = await watchFSRoutes(rootDir, {
+      scanner: config.fsRoutes,
+      outputPath: options.output ?? ".mandu/routes.manifest.json",
+      onChange: (result) => {
+        const timestamp = new Date().toLocaleTimeString();
+        console.log(`\n🔄 [${timestamp}] 라우트 변경 감지`);
+        console.log(`   📋 총 라우트: ${result.manifest.routes.length}개`);
+
+        if (result.warnings.length > 0) {
+          for (const warning of result.warnings) {
+            console.log(`   ⚠️  ${warning}`);
+          }
+        }
+
+        if (options.verbose) {
+          console.log("");
+          console.log(formatRoutesForCLI(result.manifest));
+        }
+      },
+    });
+
+    // 종료 시그널 처리
+    const cleanup = () => {
+      console.log("\n\n🛑 감시 종료");
+      watcher.close();
+      process.exit(0);
+    };
+
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+
+    // 무한 대기
+    await new Promise(() => {});
+
+    return true;
+  } catch (error) {
+    console.error("❌ 라우트 감시 실패:", error instanceof Error ? error.message : error);
+    return false;
+  }
+}

package/src/commands/start.ts

@@ -0,0 +1,184 @@
+/**
+ * mandu start - 프로덕션 서버 실행
+ *
+ * dev.ts에서 개발 전용 기능(HMR, 파일 감시, Guard)을 제거한 프로덕션 버전.
+ * 반드시 mandu build 이후에 실행해야 합니다.
+ */
+import {
+  startServer,
+  loadEnv,
+  validateAndReport,
+  readLockfile,
+  readMcpConfig,
+  validateWithPolicy,
+  detectMode,
+  formatPolicyAction,
+  formatValidationResult,
+  type RoutesManifest,
+  type BundleManifest,
+} from "@mandujs/core";
+import { resolveFromCwd } from "../util/fs";
+import { CLI_ERROR_CODES, printCLIError } from "../errors";
+import { resolveManifest } from "../util/manifest";
+import { resolveAvailablePort } from "../util/port";
+import { registerManifestHandlers } from "../util/handlers";
+import path from "path";
+import fs from "fs";
+
+export interface StartOptions {
+  port?: number;
+}
+
+export async function start(options: StartOptions = {}): Promise<void> {
+  const rootDir = resolveFromCwd(".");
+  const config = await validateAndReport(rootDir);
+
+  if (!config) {
+    printCLIError(CLI_ERROR_CODES.CONFIG_VALIDATION_FAILED);
+    process.exit(1);
+  }
+
+  // 빌드 결과물 확인
+  const manifestJsonPath = path.join(rootDir, ".mandu/manifest.json");
+  if (!fs.existsSync(manifestJsonPath)) {
+    console.error("❌ 빌드 결과물이 없습니다. 먼저 'mandu build'를 실행하세요.");
+    process.exit(1);
+  }
+
+  // 번들 매니페스트 로드
+  let bundleManifest: BundleManifest | undefined;
+  try {
+    const raw = fs.readFileSync(manifestJsonPath, "utf-8");
+    bundleManifest = JSON.parse(raw);
+  } catch {
+    console.warn("⚠️  번들 매니페스트 파싱 실패. Island hydration이 비활성됩니다.");
+  }
+
+  // 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 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'으로 생성 권장`);
+  }
+
+  // .env 파일 로드 (production 모드)
+  const envResult = await loadEnv({
+    rootDir,
+    env: "production",
+  });
+
+  if (envResult.loaded.length > 0) {
+    console.log(`🔐 환경 변수 로드: ${envResult.loaded.join(", ")}`);
+  }
+
+  // 라우트 스캔
+  console.log(`📂 라우트 스캔 중...`);
+  let manifest: RoutesManifest;
+
+  try {
+    const resolved = await resolveManifest(rootDir, { fsRoutes: config.fsRoutes });
+    manifest = resolved.manifest;
+
+    if (manifest.routes.length === 0) {
+      printCLIError(CLI_ERROR_CODES.DEV_NO_ROUTES);
+      process.exit(1);
+    }
+
+    console.log(`✅ ${manifest.routes.length}개 라우트 발견\n`);
+  } catch (error) {
+    printCLIError(CLI_ERROR_CODES.DEV_MANIFEST_NOT_FOUND);
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+
+  // 핸들러 등록 (표준 import — 캐시 무효화 없음)
+  const registeredLayouts = new Set<string>();
+  const productionImport = async (modulePath: string) => {
+    const url = Bun.pathToFileURL(modulePath);
+    return import(url.href);
+  };
+
+  await registerManifestHandlers(manifest, rootDir, {
+    importFn: productionImport,
+    registeredLayouts,
+  });
+  console.log("");
+
+  // 포트 결정
+  const envPort = process.env.PORT ? Number(process.env.PORT) : undefined;
+  const desiredPort =
+    options.port ??
+    (envPort && Number.isFinite(envPort) ? envPort : undefined) ??
+    serverConfig.port ??
+    3333;
+
+  const { port } = await resolveAvailablePort(desiredPort, {
+    hostname: serverConfig.hostname,
+    offsets: [0],
+  });
+
+  if (port !== desiredPort) {
+    console.warn(`⚠️  Port ${desiredPort} is in use. Using ${port} instead.`);
+  }
+
+  // 메인 서버 시작 (프로덕션 모드)
+  const server = startServer(manifest, {
+    port,
+    hostname: serverConfig.hostname,
+    rootDir,
+    isDev: false,
+    bundleManifest,
+    cors: serverConfig.cors,
+    streaming: serverConfig.streaming,
+  });
+
+  const actualPort = server.server.port ?? port;
+  console.log(`\n🚀 Production server running on http://${serverConfig.hostname || "localhost"}:${actualPort}`);
+
+  // Graceful shutdown
+  const cleanup = () => {
+    console.log("\n🛑 서버 종료 중...");
+    server.stop();
+    process.exit(0);
+  };
+
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+}