@mandujs/core 0.54.1 → 0.54.3

package/src/bundler/manifest-schema.ts

@@ -28,7 +28,8 @@
  *
  * URL safety model (applies to `shared.runtime`, `shared.vendor`,
  * `shared.router`, `shared.fastRefresh.glue`, `shared.fastRefresh.runtime`,
- * `bundles[].js`, `bundles[].css`, `islands[].js`, `importMap.imports[*]`):
+ * `bundles[].js`, `bundles[].css`, `islands[].js`, `partials[].js`,
+ * `importMap.imports[*]`):
  *
  *   ALLOW:  absolute paths rooted at `/.mandu/client/` ending in `.js` or `.css`.
  *           The bundler itself only ever emits this shape.
@@ -161,15 +162,20 @@ const BundleEntrySchema = z.object({
   priority: PrioritySchema,
 });
 
-const IslandEntrySchema = z.object({
-  js: safeManduUrl("islands[].js"),
-  route: z.string().min(1),
-  priority: PrioritySchema,
-});
-
-const FastRefreshSchema = z.object({
-  runtime: safeManduUrl("shared.fastRefresh.runtime"),
-  glue: safeManduUrl("shared.fastRefresh.glue"),
+const IslandEntrySchema = z.object({
+  js: safeManduUrl("islands[].js"),
+  route: z.string().min(1),
+  priority: PrioritySchema,
+});
+
+const PartialEntrySchema = z.object({
+  js: safeManduUrl("partials[].js"),
+  priority: PrioritySchema,
+});
+
+const FastRefreshSchema = z.object({
+  runtime: safeManduUrl("shared.fastRefresh.runtime"),
+  glue: safeManduUrl("shared.fastRefresh.glue"),
 });
 
 const SharedSchema = z.object({
@@ -219,10 +225,11 @@ export const BundleManifestSchema = z
   .object({
     version: z.number().int().min(1),
     buildTime: z.string().min(1),
-    env: z.enum(["development", "production"]),
-    bundles: z.record(z.string(), BundleEntrySchema),
-    islands: z.record(z.string(), IslandEntrySchema).optional(),
-    shared: SharedSchema,
+    env: z.enum(["development", "production"]),
+    bundles: z.record(z.string(), BundleEntrySchema),
+    islands: z.record(z.string(), IslandEntrySchema).optional(),
+    partials: z.record(z.string(), PartialEntrySchema).optional(),
+    shared: SharedSchema,
     importMap: ImportMapSchema.optional(),
   })
   .strict();

package/src/bundler/plugins/__tests__/block-generated-imports.test.ts

@@ -80,15 +80,19 @@ describe("defaultAllowImporter", () => {
 });
 
 describe("DEFAULT_BLOCK_FILTER", () => {
-  test("matches __generated__ specifiers", () => {
-    expect("./__generated__/foo").toMatch(DEFAULT_BLOCK_FILTER);
-    expect("../../src/__generated__/routes").toMatch(DEFAULT_BLOCK_FILTER);
-  });
-  test("does NOT match look-alikes without double underscores", () => {
-    expect("./generated/foo".match(DEFAULT_BLOCK_FILTER)).toBeNull();
-    expect("./src/generate/foo".match(DEFAULT_BLOCK_FILTER)).toBeNull();
-  });
-});
+  test("matches __generated__ specifiers", () => {
+    expect("./__generated__/foo").toMatch(DEFAULT_BLOCK_FILTER);
+    expect("../../src/__generated__/routes").toMatch(DEFAULT_BLOCK_FILTER);
+  });
+  test("matches direct .mandu/generated relative specifiers", () => {
+    expect("../.mandu/generated/routes").toMatch(DEFAULT_BLOCK_FILTER);
+    expect("../../../.mandu/generated/server/repos/party.repo").toMatch(DEFAULT_BLOCK_FILTER);
+  });
+  test("does NOT match look-alikes without double underscores", () => {
+    expect("./generated/foo".match(DEFAULT_BLOCK_FILTER)).toBeNull();
+    expect("./src/generate/foo".match(DEFAULT_BLOCK_FILTER)).toBeNull();
+  });
+});
 
 describe("defaultBundlerPlugins", () => {
   test("installs block-generated-imports by default", () => {

package/src/bundler/plugins/block-generated-imports.ts

@@ -1,5 +1,5 @@
 /**
- * Bun bundler plugin — hard-fail on direct `__generated__/` imports.
+ * Bun bundler plugin — hard-fail on direct generated-artifact imports.
  *
  * Background
  * ──────────
@@ -8,14 +8,15 @@
  * but it only runs when the user (or CI) invokes `mandu guard check`.
  * Autonomous coding agents routinely bypass that step. This plugin closes
  * the gap at the bundler level: every `mandu dev` / `mandu build` pass
- * installs it by default, and any import whose specifier contains
- * `__generated__` fails the build with a structured, actionable error.
+ * installs it by default, and any import whose specifier targets
+ * `__generated__` or `.mandu/generated` fails the build with a structured,
+ * actionable error.
  *
  * Design
  * ──────
- * - `onResolve({ filter: /__generated__/ })` — Bun hands us every import
- *   whose *specifier* matches the regex, along with the importer's path
- *   (`args.importer`). We never return a result; we always throw.
+ * - `onResolve({ filter: DEFAULT_BLOCK_FILTER })` — Bun hands us every
+ *   import whose *specifier* matches the regex, along with the importer's
+ *   path (`args.importer`). We never return a result; we always throw.
  * - The error is `ForbiddenGeneratedImportError`, a named subclass of
  *   `Error`. Tests can `instanceof`-check; Bun surfaces `error.message` in
  *   its `result.logs` output for CLI display.
@@ -90,8 +91,8 @@ export interface BlockGeneratedImportsOptions {
   allowImporter?: (importerPath: string) => boolean;
   /**
    * Custom filter regex applied to the import specifier. Defaults to
-   * `/__generated__/`. Mandu ships a single default — exposing this for
-   * test harnesses that want to narrow or broaden the filter.
+   * generated-artifact paths. Mandu ships a single default — exposing this
+   * for test harnesses that want to narrow or broaden the filter.
    */
   filter?: RegExp;
 }
@@ -114,7 +115,7 @@ export function defaultAllowImporter(importerPath: string): boolean {
 }
 
 /**
- * Build a `BunPlugin` that blocks direct `__generated__/` imports.
+ * Build a `BunPlugin` that blocks direct generated-artifact imports.
  *
  * Usage — call from `defaultBundlerPlugins(config)` (see `./index.ts`).
  * Every `safeBuild` / `Bun.build` invocation in Mandu funnels through
@@ -123,7 +124,7 @@ export function defaultAllowImporter(importerPath: string): boolean {
 export function blockGeneratedImports(
   options: BlockGeneratedImportsOptions = {},
 ): BunPlugin {
-  const filter = options.filter ?? /__generated__/;
+  const filter = options.filter ?? DEFAULT_BLOCK_FILTER;
   const allowImporter = options.allowImporter ?? defaultAllowImporter;
 
   return {
@@ -151,5 +152,5 @@ export function blockGeneratedImports(
   };
 }
 
-/** Exported for unit-test convenience — keep the filter text assertable. */
-export const DEFAULT_BLOCK_FILTER = /__generated__/;
+/** Exported for unit-test convenience — keep the filter text assertable. */
+export const DEFAULT_BLOCK_FILTER = /__generated__|(?:^|[\/\\])\.mandu[\/\\]generated(?:[\/\\]|$)/;

package/src/bundler/types.ts

@@ -55,18 +55,28 @@ export interface BundleManifest {
       priority: "immediate" | "visible" | "idle" | "interaction";
     }
   >;
-  /** Per-island bundles (code splitting: each island file gets its own JS bundle) */
-  islands?: Record<
-    string,
-    {
-      /** JavaScript bundle path */
+  /** Per-island bundles (code splitting: each island file gets its own JS bundle) */
+  islands?: Record<
+    string,
+    {
+      /** JavaScript bundle path */
       js: string;
       /** Route that owns this island */
       route: string;
       /** Hydration priority */
-      priority: "immediate" | "visible" | "idle" | "interaction";
-    }
-  >;
+      priority: "immediate" | "visible" | "idle" | "interaction";
+    }
+  >;
+  /** Inline partial bundles (from *.partial.tsx / *.partial.ts files) */
+  partials?: Record<
+    string,
+    {
+      /** JavaScript bundle path */
+      js: string;
+      /** Hydration priority */
+      priority: "immediate" | "visible" | "idle" | "interaction";
+    }
+  >;
   /** 공유 청크 */
   shared: {
     /** Hydration 런타임 */
@@ -113,12 +123,19 @@ export interface BundleStats {
 }
 
 /** Per-island code splitting entry (used by scanIslandFiles) */
-export interface IslandFileEntry {
-  name: string;
-  filePath: string;
-  routeId: string;
-  priority: "immediate" | "visible" | "idle" | "interaction";
-}
+export interface IslandFileEntry {
+  name: string;
+  filePath: string;
+  routeId: string;
+  priority: "immediate" | "visible" | "idle" | "interaction";
+}
+
+/** Inline partial bundle entry (used by scanPartialFiles) */
+export interface PartialFileEntry {
+  name: string;
+  filePath: string;
+  priority: "immediate" | "visible" | "idle" | "interaction";
+}
 
 /**
  * 번들러 옵션

package/src/client/island.ts

@@ -3,8 +3,9 @@
  * Hydration을 위한 클라이언트 사이드 컴포넌트 정의
  */
 
-import type { ReactNode } from "react";
-import { getServerData as getGlobalServerData } from "./window-state";
+import type { ReactNode } from "react";
+import { serializeProps } from "./serialize";
+import { getServerData as getGlobalServerData } from "./window-state";
 
 /**
  * Island 정의 타입
@@ -335,26 +336,45 @@ export interface PartialConfig {
 /**
  * Partial Island 정의 타입
  */
-export interface PartialDefinition<TProps> {
-  /** Partial 컴포넌트 */
-  component: React.ComponentType<TProps>;
-  /** 초기 props (SSR에서 전달) */
-  initialProps?: TProps;
-  /** 하이드레이션 우선순위 */
-  priority?: "immediate" | "visible" | "idle" | "interaction";
-}
+export interface PartialDefinition<TProps> {
+  /** Partial 고유 ID. 기본값은 component displayName/name 입니다. */
+  id?: string;
+  /** Partial 컴포넌트 */
+  component: React.ComponentType<TProps>;
+  /** 초기 props (SSR에서 전달) */
+  initialProps?: TProps;
+  /** 하이드레이션 우선순위 */
+  priority?: "immediate" | "visible" | "idle" | "interaction";
+  /** 명시적 번들 URL. 기본값은 `/.mandu/client/{id}.partial.js` 입니다. */
+  src?: string;
+  /** 에러 시 표시할 UI */
+  errorBoundary?: (error: Error, reset: () => void) => ReactNode;
+  /** 로딩 중 표시할 UI */
+  loading?: () => ReactNode;
+}
 
 /**
  * 컴파일된 Partial
  */
-export interface CompiledPartial<TProps> {
+export interface CompiledPartial<TProps> {
   /** Partial 정의 */
   definition: PartialDefinition<TProps>;
   /** Mandu Partial 마커 */
   __mandu_partial: true;
   /** Partial ID */
-  __mandu_partial_id?: string;
-}
+  __mandu_partial_id?: string;
+}
+
+function normalizePartialId(id: string): string {
+  return id
+    .trim()
+    .replace(/[^A-Za-z0-9_-]/g, "-")
+    .replace(/^-+|-+$/g, "") || "partial";
+}
+
+function priorityToHydrate(priority: NonNullable<PartialDefinition<unknown>["priority"]>): string {
+  return priority === "immediate" ? "load" : priority;
+}
 
 /**
  * Partial Island 생성
@@ -379,26 +399,56 @@ export interface CompiledPartial<TProps> {
  * }
  * ```
  */
-export function partial<TProps extends Record<string, unknown>>(
-  definition: PartialDefinition<TProps>
-): CompiledPartial<TProps> & {
-  Render: React.ComponentType<TProps>;
-} {
+export function partial<TProps extends Record<string, unknown>>(
+  definition: PartialDefinition<TProps>
+): CompiledPartial<TProps> & {
+  Render: React.ComponentType<TProps>;
+} {
   if (!definition.component) {
     throw new Error("[Mandu Partial] component is required");
   }
 
-  const compiled: CompiledPartial<TProps> = {
-    definition,
-    __mandu_partial: true,
-  };
-
-  // Render 컴포넌트 생성
-  const React = require("react");
-
-  const RenderComponent: React.FC<TProps> = (props) => {
-    return React.createElement(definition.component, props);
-  };
+  const partialId = normalizePartialId(
+    definition.id ||
+    definition.component.displayName ||
+    definition.component.name ||
+    "partial",
+  );
+  const normalizedDefinition: PartialDefinition<TProps> = {
+    ...definition,
+    id: partialId,
+  };
+
+  const compiled: CompiledPartial<TProps> = {
+    definition: normalizedDefinition,
+    __mandu_partial: true,
+    __mandu_partial_id: partialId,
+  };
+
+  // Render 컴포넌트 생성
+  const React = require("react");
+
+  const RenderComponent: React.FC<TProps> = (props) => {
+    const renderProps = Object.keys(props).length > 0
+      ? props
+      : (normalizedDefinition.initialProps ?? props);
+    const priority = normalizedDefinition.priority ?? "visible";
+    const bundleSrc = normalizedDefinition.src ?? `/.mandu/client/${partialId}.partial.js`;
+
+    return React.createElement(
+      "div",
+      {
+        "data-mandu-island": partialId,
+        "data-mandu-partial": partialId,
+        "data-mandu-src": bundleSrc,
+        "data-mandu-priority": priority,
+        "data-hydrate": priorityToHydrate(priority),
+        "data-props": serializeProps(renderProps),
+        style: { display: "contents" },
+      },
+      React.createElement(normalizedDefinition.component, renderProps),
+    );
+  };
 
   return Object.assign(compiled, { Render: RenderComponent });
 }

package/src/config/validate.ts

@@ -43,7 +43,7 @@ function _strictWithWarnings<T extends z.ZodRawShape>(
  */
 const ServerConfigSchema = z
   .object({
-    port: z.number().min(1).max(65535).default(3000),
+    port: z.number().min(1).max(65535).default(3333),
     // Default `"::"` (IPv6 wildcard, dual-stack): accepts both IPv4 and
     // IPv6 clients on one socket. Fixes Windows Node 17+ fetch failing
     // with `ECONNREFUSED ::1:PORT` because `localhost` resolves to `::1`

package/src/deploy/inference/context.ts

@@ -78,8 +78,8 @@ export async function buildDeployInferenceContext(
     // still gets the manifest metadata and falls back to defaults.
   }
 
-  const imports = extractImports(source);
-  const dependencyClasses = classifyImports(imports);
+  const imports = extractImports(source);
+  const dependencyClasses = classifySourceDependencies(source, imports);
   // Mandu's manifest patterns use `:param` / `*` (path-pattern style),
   // not bracket-form. Detect both shapes so the heuristic doesn't
   // misclassify dynamic routes as prerenderable. Examples:
@@ -139,18 +139,82 @@ export function extractImports(source: string): string[] {
 }
 
 /** Map import specifiers to coarse dependency classes. */
-export function classifyImports(imports: string[]): ReadonlySet<DependencyClass> {
-  const classes = new Set<DependencyClass>();
-  for (const spec of imports) {
+export function classifyImports(imports: string[]): ReadonlySet<DependencyClass> {
+  const classes = new Set<DependencyClass>();
+  for (const spec of imports) {
     const cls = classifyOne(spec);
     if (cls) classes.add(cls);
   }
   if (classes.size === 0) classes.add("fetch-only");
-  return classes;
-}
-
-function classifyOne(spec: string): DependencyClass | null {
-  const s = spec.toLowerCase();
+  return classes;
+}
+
+/**
+ * Classify dependency signals that do not always appear as bare imports.
+ *
+ * Dogfooding surfaced Mandu API routes importing project-local
+ * `src/server/infra/db` helpers and using `db` tagged templates. Those
+ * are server-only even when the bare imports look edge-safe.
+ */
+export function classifySourceDependencies(
+  source: string,
+  imports: string[] = extractImports(source),
+): ReadonlySet<DependencyClass> {
+  const classes = new Set<DependencyClass>(classifyImports(imports));
+  if (classes.size === 1 && classes.has("fetch-only")) {
+    classes.delete("fetch-only");
+  }
+
+  const allImports = extractAllImportSpecifiers(source);
+  if (allImports.some(isServerInfraImport)) {
+    classes.add("db");
+  }
+
+  if (/\bBun\.SQL\b|\bBun\.sqlite\b/i.test(source)) {
+    classes.add("bun-native");
+  }
+
+  if (
+    /(?:^|[^\w$])db\s*`/.test(source) ||
+    /\bctx\.deps\.db\b/.test(source) ||
+    /\bdb\.(?:query|execute|select|insert|update|delete)\b/.test(source)
+  ) {
+    classes.add("db");
+  }
+
+  if (classes.size === 0) {
+    classes.add("fetch-only");
+  }
+  return classes;
+}
+
+function extractAllImportSpecifiers(source: string): string[] {
+  const out = new Set<string>();
+  const staticImport = /^\s*import\b[^"']*?["']([^"']+)["']/gm;
+  const dynamicImport = /\bimport\(\s*["']([^"']+)["']\s*\)/g;
+  for (const re of [staticImport, dynamicImport]) {
+    let m: RegExpExecArray | null;
+    while ((m = re.exec(source)) !== null) {
+      out.add(m[1]!);
+    }
+  }
+  return [...out].sort();
+}
+
+function isServerInfraImport(specifier: string): boolean {
+  const s = specifier.replace(/\\/g, "/").toLowerCase();
+  return (
+    s === "@/server/infra" ||
+    s.startsWith("@/server/infra/") ||
+    s === "src/server/infra" ||
+    s.startsWith("src/server/infra/") ||
+    s.endsWith("/server/infra") ||
+    s.includes("/server/infra/")
+  );
+}
+
+function classifyOne(spec: string): DependencyClass | null {
+  const s = spec.toLowerCase();
   if (
     s === "bun:sqlite" ||
     s === "bun:ffi" ||
@@ -167,11 +231,14 @@ function classifyOne(spec: string): DependencyClass | null {
   if (s === "node:child_process" || s === "child_process" || s === "node:worker_threads" || s === "worker_threads") {
     return "node-child";
   }
-  if (
-    /^(postgres|pg|mysql2?|drizzle-orm(\/.*)?|@prisma\/client|prisma|mongodb|mongoose|@neondatabase\/.+|kysely|sqlite3|better-sqlite3|@planetscale\/.+)$/.test(s)
-  ) {
-    return "db";
-  }
+  if (
+    /^(postgres|pg|mysql2?|drizzle-orm(\/.*)?|@prisma\/client|prisma|mongodb|mongoose|@neondatabase\/.+|kysely|sqlite3|better-sqlite3|@planetscale\/.+)$/.test(s)
+  ) {
+    return "db";
+  }
+  if (s === "@mandujs/core/db" || s.startsWith("@mandujs/core/db/")) {
+    return "db";
+  }
   if (/^(@anthropic-ai\/sdk|openai|ai|@ai-sdk\/.+|@google\/generative-ai|cohere-ai)$/.test(s)) {
     return "ai-sdk";
   }

package/src/filling/context.ts

@@ -628,10 +628,23 @@ export class ManduContext {
     return this.withCookies(new Response(null, { status: 204 }));
   }
 
-  /** 400 Bad Request */
-  error(message: string, details?: unknown): Response {
-    return this.json({ status: "error", message, details }, 400);
-  }
+  /** 400 Bad Request, or custom 4xx/5xx error with ctx.error(status, message). */
+  error(message: string, details?: unknown): Response;
+  error(status: number, message: string, details?: unknown): Response;
+  error(
+    statusOrMessage: number | string,
+    messageOrDetails?: string | unknown,
+    maybeDetails?: unknown
+  ): Response {
+    if (typeof statusOrMessage === "number") {
+      const status = Number.isInteger(statusOrMessage) && statusOrMessage >= 400 && statusOrMessage <= 599
+        ? statusOrMessage
+        : 400;
+      const message = typeof messageOrDetails === "string" ? messageOrDetails : "Error";
+      return this.json({ status: "error", message, details: maybeDetails }, status);
+    }
+    return this.json({ status: "error", message: statusOrMessage, details: messageOrDetails }, 400);
+  }
 
   /** 401 Unauthorized */
   unauthorized(message: string = "Unauthorized"): Response {

package/src/guard/check.ts

@@ -30,21 +30,21 @@ export const GENERATED_IMPORT_DOCS_URL =
   "https://mandujs.com/docs/architect/generated-access";
 
 /**
- * Build the user-facing message for a detected direct `__generated__/`
- * import. `specifier` is the literal import string that tripped the
- * guard (not the resolved path).
+ * Build the user-facing message for a detected direct generated-artifact
+ * import. `specifier` is the literal import string that tripped the guard
+ * (not the resolved path).
  *
  * This helper is the single source of truth for the message text — both
  * the static Guard pass (`checkInvalidGeneratedImport`) and the bundler
  * plugin (`blockGeneratedImports`) call through it so the two paths
  * cannot drift.
  */
-export function buildForbiddenGeneratedImportMessage(specifier: string): string {
-  return (
-    `Direct __generated__/ imports are forbidden: ${specifier}. ` +
-    `Use the runtime registry: see ${GENERATED_IMPORT_DOCS_URL}`
-  );
-}
+export function buildForbiddenGeneratedImportMessage(specifier: string): string {
+  return (
+    `Direct generated artifact imports are forbidden: ${specifier}. ` +
+    `Use the runtime registry: see ${GENERATED_IMPORT_DOCS_URL}`
+  );
+}
 
 /**
  * Shared remediation hint. Points at `getGenerated()` from

package/src/guard/config-guard.ts

@@ -187,13 +187,19 @@ export function formatConfigGuardResult(result: ConfigGuardResult): string {
   } else if (!result.lockfileExists) {
     lines.push("💡 Lockfile 없음");
     lines.push("   'mandu lock'으로 생성 권장");
-  } else {
-    lines.push("❌ 설정 무결성 검증 실패");
-
-    for (const error of result.errors) {
-      lines.push(`   🔴 ${error.message}`);
-    }
-  }
+  } else {
+    lines.push("❌ 설정 무결성 검증 실패");
+
+    for (const error of result.errors) {
+      lines.push(`   🔴 ${error.message}`);
+    }
+
+    lines.push("");
+    lines.push("   다음 단계:");
+    lines.push("   ↳ 변경 확인: mandu lock --diff");
+    lines.push("   ↳ 의도한 변경이면: mandu lock");
+    lines.push("   ↳ 패키지 업데이트 직후라면 새 Mandu 기본값으로 lockfile을 갱신하세요.");
+  }
 
   if (result.warnings.length > 0 && result.lockfileExists) {
     lines.push("");

package/src/guard/fs-routes-policy.ts

@@ -0,0 +1,51 @@
+import type { FSRoutesGuardConfig } from "./types";
+
+export const DEFAULT_FS_ROUTES_GUARD_POLICY: FSRoutesGuardConfig = {
+  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",
+  ],
+};
+
+function clonePolicy(policy: FSRoutesGuardConfig): FSRoutesGuardConfig {
+  return {
+    noPageToPage: policy.noPageToPage,
+    pageCanImport: policy.pageCanImport ? [...policy.pageCanImport] : undefined,
+    layoutCanImport: policy.layoutCanImport ? [...policy.layoutCanImport] : undefined,
+    routeCanImport: policy.routeCanImport ? [...policy.routeCanImport] : undefined,
+  };
+}
+
+export function getDefaultFsRoutesGuardPolicy(
+  enabled: boolean
+): FSRoutesGuardConfig | undefined {
+  return enabled ? clonePolicy(DEFAULT_FS_ROUTES_GUARD_POLICY) : undefined;
+}

package/src/guard/index.ts

@@ -120,12 +120,17 @@ export {
 // Architecture Guard - Watcher
 // ═══════════════════════════════════════════════════════════════════════════
 
-export {
-  createGuardWatcher,
-  checkFile,
-  checkDirectory,
-  clearAnalysisCache,
-} from "./watcher";
+export {
+  createGuardWatcher,
+  checkFile,
+  checkDirectory,
+  clearAnalysisCache,
+} from "./watcher";
+
+export {
+  DEFAULT_FS_ROUTES_GUARD_POLICY,
+  getDefaultFsRoutesGuardPolicy,
+} from "./fs-routes-policy";
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Architecture Guard - Presets