@mandujs/cli 0.9.45 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.9.45",
+  "version": "0.10.0",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",

package/src/commands/build.ts

@@ -44,7 +44,27 @@ export async function build(options: BuildOptions = {}): Promise<boolean> {
     return false;
   }
 
-  // 2. Hydration이 필요한 라우트 확인
+  // 2. Tailwind CSS 빌드 (Island 여부와 무관하게 먼저 실행)
+  const hasTailwind = await isTailwindProject(cwd);
+  const resolvedMinify = options.minify ?? buildConfig.minify ?? true;
+
+  if (hasTailwind) {
+    console.log(`\n🎨 Tailwind CSS v4 빌드 중...`);
+    const cssResult = await buildCSS({
+      rootDir: cwd,
+      minify: resolvedMinify,
+    });
+
+    if (!cssResult.success) {
+      console.error(`\n❌ CSS 빌드 실패: ${cssResult.error}`);
+      return false;
+    }
+
+    console.log(`   ✅ CSS 빌드 완료 (${cssResult.buildTime?.toFixed(0)}ms)`);
+    console.log(`   출력: ${cssResult.outputPath}`);
+  }
+
+  // 3. Hydration이 필요한 라우트 확인
   const hydratedRoutes = manifest.routes.filter(
     (route) =>
       route.kind === "page" &&
@@ -55,6 +75,12 @@ export async function build(options: BuildOptions = {}): Promise<boolean> {
   if (hydratedRoutes.length === 0) {
     console.log("\n📭 Hydration이 필요한 라우트가 없습니다.");
     console.log("   (clientModule이 없거나 hydration.strategy: none)");
+
+    // CSS만 빌드된 경우도 성공으로 처리
+    if (hasTailwind) {
+      console.log(`\n✅ CSS 빌드 완료`);
+      console.log(`   CSS: .mandu/client/globals.css`);
+    }
     return true;
   }
 
@@ -64,24 +90,6 @@ export async function build(options: BuildOptions = {}): Promise<boolean> {
     console.log(`   - ${route.id} (${hydration.strategy}, ${hydration.priority || "visible"})`);
   }
 
-  // 3. Tailwind CSS 빌드 (감지 시에만)
-  const hasTailwind = await isTailwindProject(cwd);
-  if (hasTailwind) {
-    console.log(`\n🎨 Tailwind CSS v4 빌드 중...`);
-    const cssResult = await buildCSS({
-      rootDir: cwd,
-      minify: options.minify ?? true,
-    });
-
-    if (!cssResult.success) {
-      console.error(`\n❌ CSS 빌드 실패: ${cssResult.error}`);
-      return false;
-    }
-
-    console.log(`   ✅ CSS 빌드 완료 (${cssResult.buildTime?.toFixed(0)}ms)`);
-    console.log(`   출력: ${cssResult.outputPath}`);
-  }
-
   // 4. 번들 빌드
   const startTime = performance.now();
   const resolvedBuildOptions: BuildOptions = {

package/src/commands/check.ts

@@ -1,238 +1,290 @@
-/**
- * mandu check - Workflow Check Command
- *
- * FS Routes + Architecture Guard + Legacy Guard 통합 검사
- */
-
-import {
-  generateManifest,
-  scanRoutes,
-  checkDirectory,
-  printReport,
-  getPreset,
-  validateAndReport,
-  loadManifest,
-  runGuardCheck,
-  buildGuardReport,
-  printReportSummary,
-  type GuardConfig,
-} from "@mandujs/core";
-import path from "path";
-import { resolveFromCwd, isDirectory, pathExists } from "../util/fs";
-import { resolveOutputFormat } from "../util/output";
-
-export async function check(): Promise<boolean> {
-  const rootDir = resolveFromCwd(".");
-  const config = await validateAndReport(rootDir);
-  if (!config) return false;
-
-  const guardConfigFromFile = config.guard ?? {};
-  const preset = guardConfigFromFile.preset ?? "mandu";
-  const format = resolveOutputFormat();
-  const quiet = false;
-  const strictWarnings = process.env.CI === "true";
-  const enableFsRoutes = await isDirectory(path.resolve(rootDir, "app"));
-  const specPath = resolveFromCwd("spec/routes.manifest.json");
-  const hasSpec = await pathExists(specPath);
-
-  let success = true;
-
-  const log = (message: string) => {
-    if (format === "console" && !quiet) {
-      console.log(message);
-    }
-  };
-
-  const print = (message: string) => {
-    if (format === "console") {
-      console.log(message);
-    }
-  };
-
-  if (format === "console") {
-    log("🥟 Mandu Check\n");
-  }
-
-  // 1) FS Routes 검사
-  let routesSummary: { enabled: boolean; count: number; warnings: string[] } = {
-    enabled: false,
-    count: 0,
-    warnings: [],
-  };
-
-  if (enableFsRoutes) {
-    routesSummary.enabled = true;
-
-    try {
-      if (format === "console") {
-        const result = await generateManifest(rootDir, {
-          scanner: config.fsRoutes,
-          outputPath: ".mandu/routes.manifest.json",
-          skipLegacy: true,
-        });
-        routesSummary.count = result.manifest.routes.length;
-        routesSummary.warnings = result.warnings;
-
-        if (quiet) {
-          print(`✅ FS Routes: ${routesSummary.count}개`);
-        } else {
-          log(`✅ FS Routes: ${routesSummary.count}개`);
-        }
-        if (routesSummary.warnings.length > 0) {
-          if (!quiet) {
-            log("⚠️  경고:");
-          }
-          for (const warning of routesSummary.warnings) {
-            if (!quiet) {
-              log(`   - ${warning}`);
-            }
-          }
-        }
-        if (!quiet) {
-          log("");
-        }
-      } else {
-        const scan = await scanRoutes(rootDir, config.fsRoutes);
-        routesSummary.count = scan.routes.length;
-        routesSummary.warnings = scan.errors.map((e) => `${e.type}: ${e.message}`);
-      }
-    } catch (error) {
-      success = false;
-      routesSummary.warnings.push(
-        error instanceof Error ? error.message : String(error)
-      );
-      if (format === "console") {
-        console.error("❌ FS Routes 검사 실패:", error);
-      }
-    }
-  } else {
-    if (quiet) {
-      print("ℹ️  app/ 폴더 없음 - FS Routes 검사 스킵");
-    } else {
-      log("ℹ️  app/ 폴더 없음 - FS Routes 검사 스킵\n");
-    }
-  }
-
-  // 2) Architecture Guard 검사
-  const guardConfig: GuardConfig = {
-    preset,
-    srcDir: guardConfigFromFile.srcDir ?? "src",
-    exclude: guardConfigFromFile.exclude,
-    fsRoutes: enableFsRoutes
-      ? {
-          noPageToPage: true,
-          pageCanImport: [
-            "client/pages",
-            "client/widgets",
-            "client/features",
-            "client/entities",
-            "client/shared",
-            "shared/contracts",
-            "shared/types",
-            "shared/utils/client",
-          ],
-          layoutCanImport: [
-            "client/app",
-            "client/widgets",
-            "client/shared",
-            "shared/contracts",
-            "shared/types",
-            "shared/utils/client",
-          ],
-          routeCanImport: [
-            "server/api",
-            "server/application",
-            "server/domain",
-            "server/infra",
-            "server/core",
-            "shared/contracts",
-            "shared/schema",
-            "shared/types",
-            "shared/utils/client",
-            "shared/utils/server",
-            "shared/env",
-          ],
-        }
-      : undefined,
-  };
-
-  const report = await checkDirectory(guardConfig, rootDir);
-  const hasArchErrors = report.bySeverity.error > 0;
-  const hasArchWarnings = report.bySeverity.warn > 0;
-  if (hasArchErrors || (strictWarnings && hasArchWarnings)) {
-    success = false;
-  }
-
-  if (format === "console") {
-    const presetDef = getPreset(preset);
-    if (quiet) {
-      print(`📊 Architecture: ${report.totalViolations}개 위반 (Errors: ${report.bySeverity.error})`);
-    } else {
-      printReport(report, presetDef.hierarchy);
-    }
-  }
-
-  // 3) Legacy Guard 검사 (spec 파일이 있을 때만)
-  let legacySummary: { enabled: boolean; passed: boolean; violations: number; errors?: string[] } = {
-    enabled: false,
-    passed: true,
-    violations: 0,
-  };
-
-  if (hasSpec) {
-    legacySummary.enabled = true;
-
-    const manifestResult = await loadManifest(specPath);
-    if (!manifestResult.success || !manifestResult.data) {
-      legacySummary.passed = false;
-      legacySummary.errors = manifestResult.errors ?? ["Spec 로드 실패"];
-      success = false;
-
-      if (format === "console") {
-        console.error("❌ Spec 로드 실패:");
-        manifestResult.errors?.forEach((e) => console.error(`  - ${e}`));
-      }
-    } else {
-      const checkResult = await runGuardCheck(manifestResult.data, rootDir);
-      legacySummary.passed = checkResult.passed;
-      legacySummary.violations = checkResult.violations.length;
-      if (strictWarnings && checkResult.violations.length > 0) {
-        success = false;
-      } else {
-        success = success && checkResult.passed;
-      }
-
-      if (format === "console") {
-        const legacyReport = buildGuardReport(checkResult);
-        if (quiet) {
-          print(`📊 Legacy Guard: ${legacySummary.violations}개 위반`);
-        } else {
-          printReportSummary(legacyReport);
-        }
-      }
-    }
-  } else {
-    if (quiet) {
-      print("ℹ️  spec/routes.manifest.json 없음 - 레거시 Guard 스킵");
-    } else {
-      log("ℹ️  spec/routes.manifest.json 없음 - 레거시 Guard 스킵");
-    }
-  }
-
-  if (format !== "console") {
-    const summary = {
-      ok: success,
-      routes: routesSummary,
-      architecture: {
-        totalViolations: report.totalViolations,
-        bySeverity: report.bySeverity,
-        byType: report.byType,
-        report,
-      },
-      legacy: legacySummary,
-    };
-    console.log(JSON.stringify(summary, null, 2));
-  }
-
-  return success;
-}
+/**
+ * mandu check - Workflow Check Command
+ *
+ * FS Routes + Architecture Guard + Legacy Guard 통합 검사
+ */
+
+import {
+  generateManifest,
+  scanRoutes,
+  checkDirectory,
+  printReport,
+  getPreset,
+  validateAndReport,
+  loadManifest,
+  runGuardCheck,
+  buildGuardReport,
+  printReportSummary,
+  guardConfig,
+  formatConfigGuardResult,
+  calculateHealthScore,
+  type GuardConfig,
+  type ConfigGuardResult,
+} from "@mandujs/core";
+import path from "path";
+import { resolveFromCwd, isDirectory, pathExists } from "../util/fs";
+import { resolveOutputFormat } from "../util/output";
+
+export async function check(): Promise<boolean> {
+  const rootDir = resolveFromCwd(".");
+  const config = await validateAndReport(rootDir);
+  if (!config) return false;
+
+  const guardConfigFromFile = config.guard ?? {};
+  const preset = guardConfigFromFile.preset ?? "mandu";
+  const format = resolveOutputFormat();
+  const quiet = false;
+  const strictWarnings = process.env.CI === "true";
+  const enableFsRoutes = await isDirectory(path.resolve(rootDir, "app"));
+  const specPath = resolveFromCwd("spec/routes.manifest.json");
+  const hasSpec = await pathExists(specPath);
+
+  let success = true;
+
+  const log = (message: string) => {
+    if (format === "console" && !quiet) {
+      console.log(message);
+    }
+  };
+
+  const print = (message: string) => {
+    if (format === "console") {
+      console.log(message);
+    }
+  };
+
+  if (format === "console") {
+    log("🥟 Mandu Check\n");
+  }
+
+  // 1) FS Routes 검사
+  let routesSummary: { enabled: boolean; count: number; warnings: string[] } = {
+    enabled: false,
+    count: 0,
+    warnings: [],
+  };
+
+  if (enableFsRoutes) {
+    routesSummary.enabled = true;
+
+    try {
+      if (format === "console") {
+        const result = await generateManifest(rootDir, {
+          scanner: config.fsRoutes,
+          outputPath: ".mandu/routes.manifest.json",
+          skipLegacy: true,
+        });
+        routesSummary.count = result.manifest.routes.length;
+        routesSummary.warnings = result.warnings;
+
+        if (quiet) {
+          print(`✅ FS Routes: ${routesSummary.count}개`);
+        } else {
+          log(`✅ FS Routes: ${routesSummary.count}개`);
+        }
+        if (routesSummary.warnings.length > 0) {
+          if (!quiet) {
+            log("⚠️  경고:");
+          }
+          for (const warning of routesSummary.warnings) {
+            if (!quiet) {
+              log(`   - ${warning}`);
+            }
+          }
+        }
+        if (!quiet) {
+          log("");
+        }
+      } else {
+        const scan = await scanRoutes(rootDir, config.fsRoutes);
+        routesSummary.count = scan.routes.length;
+        routesSummary.warnings = scan.errors.map((e) => `${e.type}: ${e.message}`);
+      }
+    } catch (error) {
+      success = false;
+      routesSummary.warnings.push(
+        error instanceof Error ? error.message : String(error)
+      );
+      if (format === "console") {
+        console.error("❌ FS Routes 검사 실패:", error);
+      }
+    }
+  } else {
+    if (quiet) {
+      print("ℹ️  app/ 폴더 없음 - FS Routes 검사 스킵");
+    } else {
+      log("ℹ️  app/ 폴더 없음 - FS Routes 검사 스킵\n");
+    }
+  }
+
+  // 2) Architecture Guard 검사
+  const archGuardConfig: GuardConfig = {
+    preset,
+    srcDir: guardConfigFromFile.srcDir ?? "src",
+    exclude: guardConfigFromFile.exclude,
+    fsRoutes: enableFsRoutes
+      ? {
+          noPageToPage: true,
+          pageCanImport: [
+            "client/pages",
+            "client/widgets",
+            "client/features",
+            "client/entities",
+            "client/shared",
+            "shared/contracts",
+            "shared/types",
+            "shared/utils/client",
+          ],
+          layoutCanImport: [
+            "client/app",
+            "client/widgets",
+            "client/shared",
+            "shared/contracts",
+            "shared/types",
+            "shared/utils/client",
+          ],
+          routeCanImport: [
+            "server/api",
+            "server/application",
+            "server/domain",
+            "server/infra",
+            "server/core",
+            "shared/contracts",
+            "shared/schema",
+            "shared/types",
+            "shared/utils/client",
+            "shared/utils/server",
+            "shared/env",
+          ],
+        }
+      : undefined,
+  };
+
+  const report = await checkDirectory(archGuardConfig, rootDir);
+  const hasArchErrors = report.bySeverity.error > 0;
+  const hasArchWarnings = report.bySeverity.warn > 0;
+  if (hasArchErrors || (strictWarnings && hasArchWarnings)) {
+    success = false;
+  }
+
+  if (format === "console") {
+    const presetDef = getPreset(preset);
+    if (quiet) {
+      print(`📊 Architecture: ${report.totalViolations}개 위반 (Errors: ${report.bySeverity.error})`);
+    } else {
+      printReport(report, presetDef.hierarchy);
+    }
+  }
+
+  // 3) Legacy Guard 검사 (spec 파일이 있을 때만)
+  let legacySummary: { enabled: boolean; passed: boolean; violations: number; errors?: string[] } = {
+    enabled: false,
+    passed: true,
+    violations: 0,
+  };
+
+  if (hasSpec) {
+    legacySummary.enabled = true;
+
+    const manifestResult = await loadManifest(specPath);
+    if (!manifestResult.success || !manifestResult.data) {
+      legacySummary.passed = false;
+      legacySummary.errors = manifestResult.errors ?? ["Spec 로드 실패"];
+      success = false;
+
+      if (format === "console") {
+        console.error("❌ Spec 로드 실패:");
+        manifestResult.errors?.forEach((e) => console.error(`  - ${e}`));
+      }
+    } else {
+      const checkResult = await runGuardCheck(manifestResult.data, rootDir);
+      legacySummary.passed = checkResult.passed;
+      legacySummary.violations = checkResult.violations.length;
+      if (strictWarnings && checkResult.violations.length > 0) {
+        success = false;
+      } else {
+        success = success && checkResult.passed;
+      }
+
+      if (format === "console") {
+        const legacyReport = buildGuardReport(checkResult);
+        if (quiet) {
+          print(`📊 Legacy Guard: ${legacySummary.violations}개 위반`);
+        } else {
+          printReportSummary(legacyReport);
+        }
+      }
+    }
+  } else {
+    if (quiet) {
+      print("ℹ️  spec/routes.manifest.json 없음 - 레거시 Guard 스킵");
+    } else {
+      log("ℹ️  spec/routes.manifest.json 없음 - 레거시 Guard 스킵");
+    }
+  }
+
+  // 4) Config Integrity 검사 (Lockfile)
+  const configGuardResult = await guardConfig(rootDir, config);
+
+  if (configGuardResult.action === "error" || configGuardResult.action === "block") {
+    success = false;
+  }
+
+  if (format === "console") {
+    if (!quiet) {
+      log("");
+    }
+    if (quiet) {
+      if (configGuardResult.lockfileValid) {
+        print(`✅ Config: 무결성 확인됨 (${configGuardResult.currentHash?.slice(0, 8) ?? "N/A"})`);
+      } else if (!configGuardResult.lockfileExists) {
+        print(`💡 Config: Lockfile 없음`);
+      } else {
+        print(`❌ Config: 무결성 실패`);
+      }
+    } else {
+      log(formatConfigGuardResult(configGuardResult));
+    }
+  }
+
+  // 5) 통합 헬스 점수
+  const healthScore = calculateHealthScore(
+    report.totalViolations,
+    report.bySeverity.error,
+    configGuardResult
+  );
+
+  if (format === "console" && !quiet) {
+    log("");
+    log("═══════════════════════════════════════");
+    log(`🏥 Health Score: ${healthScore}/100`);
+    log("═══════════════════════════════════════");
+  }
+
+  if (format !== "console") {
+    const summary = {
+      ok: success,
+      healthScore,
+      routes: routesSummary,
+      architecture: {
+        totalViolations: report.totalViolations,
+        bySeverity: report.bySeverity,
+        byType: report.byType,
+        report,
+      },
+      config: {
+        valid: configGuardResult.lockfileValid,
+        exists: configGuardResult.lockfileExists,
+        action: configGuardResult.action,
+        currentHash: configGuardResult.currentHash,
+        lockedHash: configGuardResult.lockedHash,
+        errors: configGuardResult.errors,
+        warnings: configGuardResult.warnings,
+      },
+      legacy: legacySummary,
+    };
+    console.log(JSON.stringify(summary, null, 2));
+  }
+
+  return success;
+}