@mandujs/cli 0.9.21 → 0.9.23

package/src/commands/dev.ts

@@ -4,19 +4,24 @@ import {
   registerPageLoader,
   registerPageHandler,
   registerLayoutLoader,
-  startDevBundler,
-  createHMRServer,
-  needsHydration,
-  loadEnv,
-  generateManifest,
-  watchFSRoutes,
-  clearDefaultRegistry,
-  createGuardWatcher,
-  getPreset,
-  type RoutesManifest,
-  type GuardConfig,
-  type GuardPreset,
-} from "@mandujs/core";
+  startDevBundler,
+  createHMRServer,
+  needsHydration,
+  loadEnv,
+  generateManifest,
+  watchFSRoutes,
+  clearDefaultRegistry,
+  createGuardWatcher,
+  checkDirectory,
+  printReport,
+  formatReportForAgent,
+  formatReportAsAgentJSON,
+  getPreset,
+  type RoutesManifest,
+  type GuardConfig,
+  type GuardPreset,
+  type Violation,
+} from "@mandujs/core";
 import { isDirectory, resolveFromCwd } from "../util/fs";
 import { resolveOutputFormat, type OutputFormat } from "../util/output";
 import path from "path";
@@ -35,10 +40,10 @@ export interface DevOptions {
   guardFormat?: OutputFormat;
 }
 
-export async function dev(options: DevOptions = {}): Promise<void> {
-  const rootDir = resolveFromCwd(".");
-
-  console.log(`🥟 Mandu Dev Server (FS Routes)`);
+export async function dev(options: DevOptions = {}): Promise<void> {
+  const rootDir = resolveFromCwd(".");
+
+  console.log(`🥟 Mandu Dev Server (FS Routes)`);
 
   // .env 파일 로드
   const envResult = await loadEnv({
@@ -70,11 +75,75 @@ export async function dev(options: DevOptions = {}): Promise<void> {
     process.exit(1);
   }
 
-  let manifest = result.manifest;
-  console.log(`✅ ${manifest.routes.length}개 라우트 발견\n`);
-
-  // Layout 경로 추적 (중복 등록 방지)
-  const registeredLayouts = new Set<string>();
+  let manifest = result.manifest;
+  console.log(`✅ ${manifest.routes.length}개 라우트 발견\n`);
+
+  const enableFsRoutes = !options.legacy && await isDirectory(path.resolve(rootDir, "app"));
+  const guardPreset = options.guardPreset || "mandu";
+  const guardFormat = resolveOutputFormat(options.guardFormat);
+  const guardConfig: GuardConfig | null =
+    options.guard === false
+      ? null
+      : {
+          preset: guardPreset,
+          srcDir: "src",
+          realtime: true,
+          realtimeOutput: guardFormat,
+          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,
+        };
+
+  if (guardConfig) {
+    const preflightReport = await checkDirectory(guardConfig, rootDir);
+    if (preflightReport.bySeverity.error > 0) {
+      if (guardFormat === "json") {
+        console.log(formatReportAsAgentJSON(preflightReport, guardPreset));
+      } else if (guardFormat === "agent") {
+        console.log(formatReportForAgent(preflightReport, guardPreset));
+      } else {
+        printReport(preflightReport, getPreset(guardPreset).hierarchy);
+      }
+      console.error("\n❌ Architecture Guard failed. Fix errors before starting dev server.");
+      process.exit(1);
+    }
+  }
+
+  // Layout 경로 추적 (중복 등록 방지)
+  const registeredLayouts = new Set<string>();
 
   // 핸들러 등록 함수
   const registerHandlers = async (manifest: RoutesManifest, isReload = false) => {
@@ -145,9 +214,9 @@ export async function dev(options: DevOptions = {}): Promise<void> {
   let hmrServer: ReturnType<typeof createHMRServer> | null = null;
   let devBundler: Awaited<ReturnType<typeof startDevBundler>> | null = null;
 
-  const hasIslands = manifest.routes.some(
-    (r) => r.kind === "page" && r.clientModule && needsHydration(r)
-  );
+  const hasIslands = manifest.routes.some(
+    (r) => r.kind === "page" && r.clientModule && needsHydration(r)
+  );
 
   if (hasIslands && !options.noHmr) {
     // HMR 서버 시작
@@ -206,59 +275,10 @@ export async function dev(options: DevOptions = {}): Promise<void> {
     bundleManifest: devBundler?.initialBuild.manifest,
   });
 
-  // Architecture Guard 실시간 감시 (선택적)
-  let archGuardWatcher: ReturnType<typeof createGuardWatcher> | null = null;
-
-  if (options.guard !== false) {
-    const guardPreset = options.guardPreset || "mandu";
-    const guardFormat = resolveOutputFormat(options.guardFormat);
-    const enableFsRoutes = !options.legacy && await isDirectory(path.resolve(rootDir, "app"));
-    const guardConfig: GuardConfig = {
-      preset: guardPreset,
-      srcDir: "src",
-      realtime: true,
-      realtimeOutput: guardFormat,
-      fsRoutes: enableFsRoutes
-        ? {
-            noPageToPage: true,
-            pageCanImport: ["widgets", "features", "entities", "shared"],
-            layoutCanImport: ["widgets", "shared"],
-          }
-        : undefined,
-    };
-
-    console.log(`🛡️  Architecture Guard 활성화 (${guardPreset})`);
-
-    archGuardWatcher = createGuardWatcher({
-      config: guardConfig,
-      rootDir,
-      onViolation: (violation) => {
-        // 실시간 경고는 watcher 내부에서 처리
-      },
-      onFileAnalyzed: (analysis, violations) => {
-        if (violations.length > 0) {
-          // HMR 에러로 브로드캐스트
-          hmrServer?.broadcast({
-            type: "guard-violation",
-            data: {
-              file: analysis.filePath,
-              violations: violations.map((v) => ({
-                line: v.line,
-                message: `${v.fromLayer} → ${v.toLayer}: ${v.ruleDescription}`,
-              })),
-            },
-          });
-        }
-      },
-    });
-
-    archGuardWatcher.start();
-  }
-
-  // FS Routes 실시간 감시
-  const routesWatcher = await watchFSRoutes(rootDir, {
-    skipLegacy: true,
-    onChange: async (result) => {
+  // FS Routes 실시간 감시
+  const routesWatcher = await watchFSRoutes(rootDir, {
+    skipLegacy: true,
+    onChange: async (result) => {
       const timestamp = new Date().toLocaleTimeString();
       console.log(`\n🔄 [${timestamp}] 라우트 변경 감지`);
 
@@ -279,20 +299,60 @@ export async function dev(options: DevOptions = {}): Promise<void> {
           data: { timestamp: Date.now() },
         });
       }
-    },
-  });
-
-  // 정리 함수
-  const cleanup = () => {
-    console.log("\n🛑 서버 종료 중...");
-    server.stop();
-    devBundler?.close();
-    hmrServer?.close();
-    routesWatcher.close();
-    archGuardWatcher?.close();
-    process.exit(0);
-  };
-
-  process.on("SIGINT", cleanup);
-  process.on("SIGTERM", cleanup);
-}
+    },
+  });
+
+  // Architecture Guard 실시간 감시 (선택적)
+  let archGuardWatcher: ReturnType<typeof createGuardWatcher> | null = null;
+  let guardFailed = false;
+
+  // 정리 함수
+  const cleanup = () => {
+    console.log("\n🛑 서버 종료 중...");
+    server.stop();
+    devBundler?.close();
+    hmrServer?.close();
+    routesWatcher.close();
+    archGuardWatcher?.close();
+    process.exit(0);
+  };
+
+  const stopOnGuardError = (violation: Violation) => {
+    if (violation.severity !== "error" || guardFailed) {
+      return;
+    }
+    guardFailed = true;
+    console.error("\n❌ Architecture Guard violation detected. Stopping dev server.");
+    cleanup();
+  };
+
+  if (guardConfig) {
+    console.log(`🛡️  Architecture Guard 활성화 (${guardPreset})`);
+
+    archGuardWatcher = createGuardWatcher({
+      config: guardConfig,
+      rootDir,
+      onViolation: stopOnGuardError,
+      onFileAnalyzed: (analysis, violations) => {
+        if (violations.length > 0) {
+          // HMR 에러로 브로드캐스트
+          hmrServer?.broadcast({
+            type: "guard-violation",
+            data: {
+              file: analysis.filePath,
+              violations: violations.map((v) => ({
+                line: v.line,
+                message: `${v.fromLayer} → ${v.toLayer}: ${v.ruleDescription}`,
+              })),
+            },
+          });
+        }
+      },
+    });
+
+    archGuardWatcher.start();
+  }
+
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+}

package/src/commands/guard-arch.ts

@@ -109,8 +109,37 @@ export async function guardArch(options: GuardArchOptions = {}): Promise<boolean
     fsRoutes: enableFsRoutes
       ? {
           noPageToPage: true,
-          pageCanImport: ["widgets", "features", "entities", "shared"],
-          layoutCanImport: ["widgets", "shared"],
+          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,
   };
@@ -238,19 +267,20 @@ export async function guardArch(options: GuardArchOptions = {}): Promise<boolean
   }
 
   // CI 모드에서 에러가 있으면 실패
-  if (ci && report.bySeverity.error > 0) {
-    console.log("\n❌ Architecture check failed");
-    return false;
-  }
+  const hasErrors = report.bySeverity.error > 0;
+  const hasWarnings = report.bySeverity.warn > 0;
 
   if (report.totalViolations === 0) {
     console.log("\n✅ Architecture check passed");
     return true;
   }
 
-  if (report.bySeverity.error > 0) {
-    console.log(`\n⚠️  ${report.bySeverity.error} error(s) found - please fix before continuing`);
-    return !ci;
+  if (hasErrors || (ci && hasWarnings)) {
+    const reason = hasErrors
+      ? `${report.bySeverity.error} error(s)`
+      : `${report.bySeverity.warn} warning(s)`;
+    console.log(`\n❌ Architecture check failed: ${reason}`);
+    return false;
   }
 
   console.log(`\n⚠️  ${report.totalViolations} issue(s) found`);

package/src/commands/guard-check.ts

@@ -13,13 +13,13 @@ export interface GuardCheckOptions {
   autoCorrect?: boolean;
 }
 
-export async function guardCheck(options: GuardCheckOptions = {}): Promise<boolean> {
-  const { autoCorrect = true } = options;
+export async function guardCheck(options: GuardCheckOptions = {}): Promise<boolean> {
+  const { autoCorrect = true } = options;
 
   const specPath = resolveFromCwd("spec/routes.manifest.json");
   const rootDir = getRootDir();
 
-  console.log(`🥟 Mandu Guard`);
+  console.log(`🥟 Mandu Guard (Legacy Spec)`);
   console.log(`📄 Spec 파일: ${specPath}`);
   console.log(`🔧 Auto-correct: ${autoCorrect ? "ON" : "OFF"}\n`);