@mandujs/core 0.9.16 → 0.9.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.9.16",
+  "version": "0.9.17",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",

package/src/guard/check.ts

@@ -291,6 +291,47 @@ async function scanTsFiles(dir: string): Promise<string[]> {
   return files;
 }
 
+// Rule: spec/ directory naming convention scan
+export async function checkSpecDirNaming(
+  rootDir: string
+): Promise<GuardViolation[]> {
+  const violations: GuardViolation[] = [];
+
+  // Check spec/slots/ — only .slot.ts allowed
+  const slotsDir = path.join(rootDir, "spec/slots");
+  try {
+    const files = await fs.readdir(slotsDir);
+    for (const file of files) {
+      if (file.endsWith(".ts") && !file.endsWith(".slot.ts")) {
+        violations.push({
+          ruleId: GUARD_RULES.SLOT_DIR_INVALID_FILE.id,
+          file: `spec/slots/${file}`,
+          message: `spec/slots/에 .slot.ts가 아닌 파일: ${file}`,
+          suggestion: `.slot.ts로 이름을 바꾸거나, 이 파일이 client slot이면 apps/web/components/로 이동하세요`,
+        });
+      }
+    }
+  } catch {}
+
+  // Check spec/contracts/ — only .contract.ts allowed
+  const contractsDir = path.join(rootDir, "spec/contracts");
+  try {
+    const files = await fs.readdir(contractsDir);
+    for (const file of files) {
+      if (file.endsWith(".ts") && !file.endsWith(".contract.ts")) {
+        violations.push({
+          ruleId: GUARD_RULES.CONTRACT_DIR_INVALID_FILE.id,
+          file: `spec/contracts/${file}`,
+          message: `spec/contracts/에 .contract.ts가 아닌 파일: ${file}`,
+          suggestion: `.contract.ts로 이름을 바꾸세요`,
+        });
+      }
+    }
+  } catch {}
+
+  return violations;
+}
+
 export async function runGuardCheck(
   manifest: RoutesManifest,
   rootDir: string
@@ -347,6 +388,10 @@ export async function runGuardCheck(
   const islandViolations = await checkIslandFirstIntegrity(manifest, rootDir);
   violations.push(...islandViolations);
 
+  // Rule: spec/ directory naming convention
+  const specDirViolations = await checkSpecDirNaming(rootDir);
+  violations.push(...specDirViolations);
+
   return {
     passed: violations.length === 0,
     violations,

package/src/guard/rules.ts

@@ -108,6 +108,18 @@ export const GUARD_RULES: Record<string, GuardRule> = {
     description: "spec에 명시된 clientModule 파일을 찾을 수 없습니다",
     severity: "error",
   },
+  SLOT_DIR_INVALID_FILE: {
+    id: "SLOT_DIR_INVALID_FILE",
+    name: "Invalid File in Slots Directory",
+    description: "spec/slots/ 디렉토리에 .slot.ts가 아닌 파일이 있습니다",
+    severity: "error",
+  },
+  CONTRACT_DIR_INVALID_FILE: {
+    id: "CONTRACT_DIR_INVALID_FILE",
+    name: "Invalid File in Contracts Directory",
+    description: "spec/contracts/ 디렉토리에 .contract.ts가 아닌 파일이 있습니다",
+    severity: "error",
+  },
 };
 
 export const FORBIDDEN_IMPORTS = ["fs", "child_process", "cluster", "worker_threads"];