viberails 0.2.2 → 0.3.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 import { Command } from "commander";
 
 // src/commands/boundaries.ts
@@ -66,7 +66,7 @@ function resolveWorkspacePackages(projectRoot, workspace) {
     ];
     packages.push({ name, path: absPath, relativePath, internalDeps: allDeps });
   }
-  const packageNames = new Set(packages.map((p) => p.name));
+  const packageNames = new Set(packages.map((p3) => p3.name));
   for (const pkg of packages) {
     pkg.internalDeps = pkg.internalDeps.filter((dep) => packageNames.has(dep));
   }
@@ -96,23 +96,37 @@ async function boundariesCommand(options, cwd) {
   }
   displayRules(config);
 }
+function countBoundaries(boundaries) {
+  if (!boundaries) return 0;
+  if (Array.isArray(boundaries)) return boundaries.length;
+  return Object.values(boundaries).reduce((sum, denied) => sum + denied.length, 0);
+}
 function displayRules(config) {
-  if (!config.boundaries || config.boundaries.length === 0) {
+  const total = countBoundaries(config.boundaries);
+  if (total === 0) {
     console.log(chalk.yellow("No boundary rules configured."));
     console.log(`Run ${chalk.cyan("viberails boundaries --infer")} to generate rules.`);
     return;
   }
-  const allowRules = config.boundaries.filter((r) => r.allow);
-  const denyRules = config.boundaries.filter((r) => !r.allow);
   console.log(`
-${chalk.bold(`Boundary rules (${config.boundaries.length} rules):`)}
+${chalk.bold(`Boundary rules (${total} rules):`)}
 `);
-  for (const r of allowRules) {
-    console.log(`  ${chalk.green("\u2713")} ${r.from} \u2192 ${r.to}`);
-  }
-  for (const r of denyRules) {
-    const reason = r.reason ? chalk.dim(` (${r.reason})`) : "";
-    console.log(`  ${chalk.red("\u2717")} ${r.from} \u2192 ${r.to}${reason}`);
+  if (Array.isArray(config.boundaries)) {
+    const allowRules = config.boundaries.filter((r) => r.allow);
+    const denyRules = config.boundaries.filter((r) => !r.allow);
+    for (const r of allowRules) {
+      console.log(`  ${chalk.green("\u2713")} ${r.from} \u2192 ${r.to}`);
+    }
+    for (const r of denyRules) {
+      const reason = r.reason ? chalk.dim(` (${r.reason})`) : "";
+      console.log(`  ${chalk.red("\u2717")} ${r.from} \u2192 ${r.to}${reason}`);
+    }
+  } else if (config.boundaries) {
+    for (const [from, denied] of Object.entries(config.boundaries)) {
+      for (const to of denied) {
+        console.log(`  ${chalk.red("\u2717")} ${from} \u2192 ${to}`);
+      }
+    }
   }
   console.log(
     `
@@ -129,31 +143,29 @@ async function inferAndDisplay(projectRoot, config, configPath) {
   });
   console.log(chalk.dim(`${graph.nodes.length} files, ${graph.edges.length} edges`));
   const inferred = inferBoundaries(graph);
-  if (inferred.length === 0) {
+  const entries = Object.entries(inferred);
+  if (entries.length === 0) {
     console.log(chalk.yellow("No boundary rules could be inferred."));
     return;
   }
-  const allow = inferred.filter((r) => r.allow);
-  const deny = inferred.filter((r) => !r.allow);
+  const totalRules = entries.reduce((sum, [, denied]) => sum + denied.length, 0);
   console.log(`
 ${chalk.bold("Inferred boundary rules:")}
 `);
-  for (const r of allow) {
-    console.log(`  ${chalk.green("\u2713")} ${r.from} \u2192 ${r.to}`);
-  }
-  for (const r of deny) {
-    const reason = r.reason ? chalk.dim(` (${r.reason})`) : "";
-    console.log(`  ${chalk.red("\u2717")} ${r.from} \u2192 ${r.to}${reason}`);
+  for (const [from, denied] of entries) {
+    for (const to of denied) {
+      console.log(`  ${chalk.red("\u2717")} ${from} \u2192 ${to}`);
+    }
   }
   console.log(`
-  ${allow.length} allowed, ${deny.length} denied`);
+  ${totalRules} deny rules`);
   const shouldSave = await confirm("\nSave to viberails.config.json?");
   if (shouldSave) {
     config.boundaries = inferred;
     config.rules.enforceBoundaries = true;
     fs3.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
 `);
-    console.log(`${chalk.green("\u2713")} Saved ${inferred.length} rules`);
+    console.log(`${chalk.green("\u2713")} Saved ${totalRules} rules`);
   }
 }
 async function showGraph(projectRoot, config) {
@@ -234,6 +246,10 @@ var ALWAYS_SKIP_DIRS = /* @__PURE__ */ new Set([
   ".svelte-kit",
   ".turbo",
   "coverage",
+  "public",
+  "vendor",
+  "__generated__",
+  "generated",
   ".viberails"
 ]);
 var SOURCE_EXTS = /* @__PURE__ */ new Set([
@@ -255,12 +271,19 @@ var NAMING_PATTERNS = {
 };
 function isIgnored(relPath, ignorePatterns) {
   for (const pattern of ignorePatterns) {
-    if (pattern.endsWith("/**")) {
+    const startsGlob = pattern.startsWith("**/");
+    const endsGlob = pattern.endsWith("/**");
+    if (startsGlob && endsGlob) {
+      const middle = pattern.slice(3, -3);
+      if (relPath.startsWith(`${middle}/`) || relPath.includes(`/${middle}/`) || relPath === middle) {
+        return true;
+      }
+    } else if (endsGlob) {
       const prefix = pattern.slice(0, -3);
       if (relPath.startsWith(`${prefix}/`) || relPath === prefix) return true;
-    } else if (pattern.startsWith("**/")) {
+    } else if (startsGlob) {
       const suffix = pattern.slice(3);
-      if (relPath.endsWith(suffix)) return true;
+      if (relPath.endsWith(suffix) || relPath === suffix) return true;
     } else if (relPath === pattern || relPath.startsWith(`${pattern}/`)) {
       return true;
     }
@@ -380,13 +403,13 @@ function checkMissingTests(projectRoot, config, severity) {
   const testSuffix = testPattern.replace("*", "");
   const sourceFiles = collectSourceFiles(srcPath, projectRoot);
   for (const relFile of sourceFiles) {
-    const basename6 = path5.basename(relFile);
-    if (basename6.includes(".test.") || basename6.includes(".spec.") || basename6.startsWith("index.") || basename6.endsWith(".d.ts")) {
+    const basename7 = path5.basename(relFile);
+    if (basename7.includes(".test.") || basename7.includes(".spec.") || basename7.startsWith("index.") || basename7.endsWith(".d.ts")) {
       continue;
     }
-    const ext = path5.extname(basename6);
+    const ext = path5.extname(basename7);
     if (!SOURCE_EXTS2.has(ext)) continue;
-    const stem = basename6.slice(0, basename6.indexOf("."));
+    const stem = basename7.slice(0, basename7.indexOf("."));
     const expectedTestFile = `${stem}${testSuffix}`;
     const dir = path5.dirname(path5.join(projectRoot, relFile));
     const colocatedTest = path5.join(dir, expectedTestFile);
@@ -407,6 +430,50 @@ function checkMissingTests(projectRoot, config, severity) {
 
 // src/commands/check.ts
 var CONFIG_FILE2 = "viberails.config.json";
+function isTestFile(relPath) {
+  const filename = path6.basename(relPath);
+  return filename.includes(".test.") || filename.includes(".spec.") || filename.startsWith("test.") || filename.startsWith("spec.") || relPath.includes("__tests__/") || relPath.includes("__test__/");
+}
+function printGroupedViolations(violations, limit) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const v of violations) {
+    const existing = groups.get(v.rule) ?? [];
+    existing.push(v);
+    groups.set(v.rule, existing);
+  }
+  const ruleOrder = ["file-size", "file-naming", "missing-test", "boundary-violation"];
+  const sortedKeys = [...groups.keys()].sort(
+    (a, b) => (ruleOrder.indexOf(a) === -1 ? 99 : ruleOrder.indexOf(a)) - (ruleOrder.indexOf(b) === -1 ? 99 : ruleOrder.indexOf(b))
+  );
+  let totalShown = 0;
+  const totalLimit = limit ?? Number.POSITIVE_INFINITY;
+  for (const rule of sortedKeys) {
+    const group = groups.get(rule);
+    if (!group) continue;
+    const remaining = totalLimit - totalShown;
+    if (remaining <= 0) break;
+    const toShow = group.slice(0, remaining);
+    const hidden = group.length - toShow.length;
+    for (const v of toShow) {
+      const icon = v.severity === "error" ? chalk2.red("\u2717") : chalk2.yellow("!");
+      console.log(`${icon} ${chalk2.dim(v.rule)} ${v.file}: ${v.message}`);
+    }
+    totalShown += toShow.length;
+    if (hidden > 0) {
+      console.log(chalk2.dim(`  ... and ${hidden} more ${rule} violations`));
+    }
+  }
+}
+function printSummary(violations) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const v of violations) {
+    counts.set(v.rule, (counts.get(v.rule) ?? 0) + 1);
+  }
+  const word = violations.length === 1 ? "violation" : "violations";
+  const parts = [...counts.entries()].map(([rule, count]) => `${count} ${rule}`);
+  console.log(`
+${violations.length} ${word} found (${parts.join(", ")}).`);
+}
 async function checkCommand(options, cwd) {
   const startDir = cwd ?? process.cwd();
   const projectRoot = findProjectRoot(startDir);
@@ -443,13 +510,15 @@ async function checkCommand(options, cwd) {
     if (isIgnored(relPath, effectiveIgnore)) continue;
     if (!fs6.existsSync(absPath)) continue;
     const resolved = resolveConfigForFile(relPath, config);
-    if (resolved.rules.maxFileLines > 0) {
+    const testFile = isTestFile(relPath);
+    const maxLines = testFile ? resolved.rules.maxTestFileLines : resolved.rules.maxFileLines;
+    if (maxLines > 0) {
       const lines = countFileLines(absPath);
-      if (lines !== null && lines > resolved.rules.maxFileLines) {
+      if (lines !== null && lines > maxLines) {
         violations.push({
           file: relPath,
           rule: "file-size",
-          message: `${lines} lines (max ${resolved.rules.maxFileLines}). Split into focused modules.`,
+          message: `${lines} lines (max ${maxLines}). Split into focused modules.`,
           severity
         });
       }
@@ -470,7 +539,8 @@ async function checkCommand(options, cwd) {
     const testViolations = checkMissingTests(projectRoot, config, severity);
     violations.push(...testViolations);
   }
-  if (config.rules.enforceBoundaries && config.boundaries && config.boundaries.length > 0 && !options.noBoundaries) {
+  const hasBoundaries = config.boundaries ? Array.isArray(config.boundaries) ? config.boundaries.length > 0 : Object.keys(config.boundaries).length > 0 : false;
+  if (config.rules.enforceBoundaries && hasBoundaries && !options.noBoundaries) {
     const startTime = Date.now();
     const { buildImportGraph, checkBoundaries } = await import("@viberails/graph");
     const packages = config.workspace ? resolveWorkspacePackages(projectRoot, config.workspace) : void 0;
@@ -497,13 +567,10 @@ async function checkCommand(options, cwd) {
     console.log(`${chalk2.green("\u2713")} ${filesToCheck.length} files checked \u2014 no violations`);
     return 0;
   }
-  for (const v of violations) {
-    const icon = v.severity === "error" ? chalk2.red("\u2717") : chalk2.yellow("!");
-    console.log(`${icon} ${chalk2.dim(v.rule)} ${v.file}: ${v.message}`);
+  if (!options.quiet) {
+    printGroupedViolations(violations, options.limit);
   }
-  const word = violations.length === 1 ? "violation" : "violations";
-  console.log(`
-${violations.length} ${word} found.`);
+  printSummary(violations);
   if (config.enforcement === "enforce") {
     console.log(chalk2.red("Fix violations before committing."));
     return 1;
@@ -751,8 +818,8 @@ import * as path9 from "path";
 function generateTestStub(sourceRelPath, config, projectRoot) {
   const { testPattern } = config.structure;
   if (!testPattern) return null;
-  const basename6 = path9.basename(sourceRelPath);
-  const stem = basename6.slice(0, basename6.indexOf("."));
+  const basename7 = path9.basename(sourceRelPath);
+  const stem = basename7.slice(0, basename7.indexOf("."));
   const testSuffix = testPattern.replace("*", "");
   const testFilename = `${stem}${testSuffix}`;
   const dir = path9.dirname(path9.join(projectRoot, sourceRelPath));
@@ -878,223 +945,10 @@ async function fixCommand(options, cwd) {
 // src/commands/init.ts
 import * as fs12 from "fs";
 import * as path13 from "path";
+import * as p2 from "@clack/prompts";
 import { generateConfig } from "@viberails/config";
 import { scan } from "@viberails/scanner";
-import chalk8 from "chalk";
-
-// src/display.ts
-import { FRAMEWORK_NAMES as FRAMEWORK_NAMES2, LIBRARY_NAMES, STYLING_NAMES as STYLING_NAMES2 } from "@viberails/types";
-import chalk6 from "chalk";
-
-// src/display-helpers.ts
-import { ROLE_DESCRIPTIONS } from "@viberails/types";
-function groupByRole(directories) {
-  const map = /* @__PURE__ */ new Map();
-  for (const dir of directories) {
-    if (dir.role === "unknown") continue;
-    const existing = map.get(dir.role);
-    if (existing) {
-      existing.dirs.push(dir);
-    } else {
-      map.set(dir.role, { dirs: [dir] });
-    }
-  }
-  const groups = [];
-  for (const [role, { dirs }] of map) {
-    const label = ROLE_DESCRIPTIONS[role] ?? role;
-    const totalFiles = dirs.reduce((sum, d) => sum + d.fileCount, 0);
-    groups.push({
-      role,
-      label,
-      dirCount: dirs.length,
-      totalFiles,
-      singlePath: dirs.length === 1 ? dirs[0].path : void 0
-    });
-  }
-  return groups;
-}
-function formatSummary(stats, packageCount) {
-  const parts = [];
-  if (packageCount && packageCount > 1) {
-    parts.push(`${packageCount} packages`);
-  }
-  parts.push(`${stats.totalFiles.toLocaleString()} source files`);
-  parts.push(`${stats.totalLines.toLocaleString()} lines`);
-  parts.push(`avg ${Math.round(stats.averageFileLines)} lines/file`);
-  return parts.join(" \xB7 ");
-}
-function formatExtensions(filesByExtension, maxEntries = 4) {
-  return Object.entries(filesByExtension).sort(([, a], [, b]) => b - a).slice(0, maxEntries).map(([ext, count]) => `${ext} ${count}`).join(" \xB7 ");
-}
-function formatRoleGroup(group) {
-  const files = group.totalFiles === 1 ? "1 file" : `${group.totalFiles} files`;
-  if (group.singlePath) {
-    return `${group.label} \u2014 ${group.singlePath} (${files})`;
-  }
-  const dirs = group.dirCount === 1 ? "1 dir" : `${group.dirCount} dirs`;
-  return `${group.label} \u2014 ${dirs} (${files})`;
-}
-
-// src/display-monorepo.ts
-import { FRAMEWORK_NAMES, STYLING_NAMES } from "@viberails/types";
-import chalk5 from "chalk";
-function formatPackageSummary(pkg) {
-  const parts = [];
-  if (pkg.stack.framework) {
-    parts.push(formatItem(pkg.stack.framework, FRAMEWORK_NAMES));
-  }
-  if (pkg.stack.styling) {
-    parts.push(formatItem(pkg.stack.styling, STYLING_NAMES));
-  }
-  const files = `${pkg.statistics.totalFiles} files`;
-  const detail = parts.length > 0 ? `${parts.join(", ")} (${files})` : `(${files})`;
-  return `  ${pkg.relativePath} \u2014 ${detail}`;
-}
-function displayMonorepoResults(scanResult) {
-  const { stack, packages } = scanResult;
-  console.log(`
-${chalk5.bold(`Detected: (monorepo, ${packages.length} packages)`)}`);
-  console.log(`  ${chalk5.green("\u2713")} ${formatItem(stack.language)}`);
-  if (stack.packageManager) {
-    console.log(`  ${chalk5.green("\u2713")} ${formatItem(stack.packageManager)}`);
-  }
-  if (stack.linter) {
-    console.log(`  ${chalk5.green("\u2713")} ${formatItem(stack.linter)}`);
-  }
-  if (stack.formatter) {
-    console.log(`  ${chalk5.green("\u2713")} ${formatItem(stack.formatter)}`);
-  }
-  if (stack.testRunner) {
-    console.log(`  ${chalk5.green("\u2713")} ${formatItem(stack.testRunner)}`);
-  }
-  console.log("");
-  for (const pkg of packages) {
-    console.log(formatPackageSummary(pkg));
-  }
-  const packagesWithDirs = packages.filter(
-    (pkg) => pkg.structure.directories.some((d) => d.role !== "unknown")
-  );
-  if (packagesWithDirs.length > 0) {
-    console.log(`
-${chalk5.bold("Structure:")}`);
-    for (const pkg of packagesWithDirs) {
-      const groups = groupByRole(pkg.structure.directories);
-      if (groups.length === 0) continue;
-      console.log(`  ${pkg.relativePath}:`);
-      for (const group of groups) {
-        console.log(`    ${chalk5.green("\u2713")} ${formatRoleGroup(group)}`);
-      }
-    }
-  }
-  displayConventions(scanResult);
-  displaySummarySection(scanResult);
-  console.log("");
-}
-
-// src/display.ts
-var CONVENTION_LABELS = {
-  fileNaming: "File naming",
-  componentNaming: "Component naming",
-  hookNaming: "Hook naming",
-  importAlias: "Import alias"
-};
-function formatItem(item, nameMap) {
-  const name = nameMap?.[item.name] ?? item.name;
-  return item.version ? `${name} ${item.version}` : name;
-}
-function confidenceLabel(convention) {
-  const pct = Math.round(convention.consistency);
-  if (convention.confidence === "high") {
-    return `${pct}% \u2014 high confidence, will enforce`;
-  }
-  return `${pct}% \u2014 medium confidence, suggested only`;
-}
-function displayConventions(scanResult) {
-  const conventionEntries = Object.entries(scanResult.conventions);
-  if (conventionEntries.length === 0) return;
-  console.log(`
-${chalk6.bold("Conventions:")}`);
-  for (const [key, convention] of conventionEntries) {
-    if (convention.confidence === "low") continue;
-    const label = CONVENTION_LABELS[key] ?? key;
-    if (scanResult.packages.length > 1) {
-      const pkgValues = scanResult.packages.filter((pkg) => pkg.conventions[key] && pkg.conventions[key].confidence !== "low").map((pkg) => ({ relativePath: pkg.relativePath, convention: pkg.conventions[key] }));
-      const allSame = pkgValues.every((pv) => pv.convention.value === convention.value);
-      if (allSame || pkgValues.length <= 1) {
-        const ind = convention.confidence === "high" ? chalk6.green("\u2713") : chalk6.yellow("~");
-        const detail = chalk6.dim(`(${confidenceLabel(convention)})`);
-        console.log(`  ${ind} ${label}: ${convention.value} ${detail}`);
-      } else {
-        console.log(`  ${chalk6.yellow("~")} ${label}: varies by package`);
-        for (const pv of pkgValues) {
-          const pct = Math.round(pv.convention.consistency);
-          console.log(`    ${pv.relativePath}: ${pv.convention.value} (${pct}%)`);
-        }
-      }
-    } else {
-      const ind = convention.confidence === "high" ? chalk6.green("\u2713") : chalk6.yellow("~");
-      const detail = chalk6.dim(`(${confidenceLabel(convention)})`);
-      console.log(`  ${ind} ${label}: ${convention.value} ${detail}`);
-    }
-  }
-}
-function displaySummarySection(scanResult) {
-  const pkgCount = scanResult.packages.length > 1 ? scanResult.packages.length : void 0;
-  console.log(`
-${chalk6.bold("Summary:")}`);
-  console.log(`  ${formatSummary(scanResult.statistics, pkgCount)}`);
-  const ext = formatExtensions(scanResult.statistics.filesByExtension);
-  if (ext) {
-    console.log(`  ${ext}`);
-  }
-}
-function displayScanResults(scanResult) {
-  if (scanResult.packages.length > 1) {
-    displayMonorepoResults(scanResult);
-    return;
-  }
-  const { stack } = scanResult;
-  console.log(`
-${chalk6.bold("Detected:")}`);
-  if (stack.framework) {
-    console.log(`  ${chalk6.green("\u2713")} ${formatItem(stack.framework, FRAMEWORK_NAMES2)}`);
-  }
-  console.log(`  ${chalk6.green("\u2713")} ${formatItem(stack.language)}`);
-  if (stack.styling) {
-    console.log(`  ${chalk6.green("\u2713")} ${formatItem(stack.styling, STYLING_NAMES2)}`);
-  }
-  if (stack.backend) {
-    console.log(`  ${chalk6.green("\u2713")} ${formatItem(stack.backend, FRAMEWORK_NAMES2)}`);
-  }
-  if (stack.linter) {
-    console.log(`  ${chalk6.green("\u2713")} ${formatItem(stack.linter)}`);
-  }
-  if (stack.formatter) {
-    console.log(`  ${chalk6.green("\u2713")} ${formatItem(stack.formatter)}`);
-  }
-  if (stack.testRunner) {
-    console.log(`  ${chalk6.green("\u2713")} ${formatItem(stack.testRunner)}`);
-  }
-  if (stack.packageManager) {
-    console.log(`  ${chalk6.green("\u2713")} ${formatItem(stack.packageManager)}`);
-  }
-  if (stack.libraries.length > 0) {
-    for (const lib of stack.libraries) {
-      console.log(`  ${chalk6.green("\u2713")} ${formatItem(lib, LIBRARY_NAMES)}`);
-    }
-  }
-  const groups = groupByRole(scanResult.structure.directories);
-  if (groups.length > 0) {
-    console.log(`
-${chalk6.bold("Structure:")}`);
-    for (const group of groups) {
-      console.log(`  ${chalk6.green("\u2713")} ${formatRoleGroup(group)}`);
-    }
-  }
-  displayConventions(scanResult);
-  displaySummarySection(scanResult);
-  console.log("");
-}
+import chalk9 from "chalk";
 
 // src/utils/write-generated-files.ts
 import * as fs10 from "fs";
@@ -1125,18 +979,60 @@ function writeGeneratedFiles(projectRoot, config, scanResult) {
 // src/commands/init-hooks.ts
 import * as fs11 from "fs";
 import * as path12 from "path";
-import chalk7 from "chalk";
+import chalk5 from "chalk";
+function setupClaudeCodeHook(projectRoot) {
+  const claudeDir = path12.join(projectRoot, ".claude");
+  if (!fs11.existsSync(claudeDir)) {
+    fs11.mkdirSync(claudeDir, { recursive: true });
+  }
+  const settingsPath = path12.join(claudeDir, "settings.json");
+  let settings = {};
+  if (fs11.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs11.readFileSync(settingsPath, "utf-8"));
+    } catch {
+    }
+  }
+  const hooks = settings.hooks ?? {};
+  const postToolUse = hooks.PostToolUse;
+  if (Array.isArray(postToolUse)) {
+    const hasViberails = postToolUse.some(
+      (entry) => typeof entry === "object" && entry !== null && Array.isArray(entry.hooks) && entry.hooks.some(
+        (h) => typeof h === "object" && h !== null && typeof h.command === "string" && h.command.includes("viberails")
+      )
+    );
+    if (hasViberails) return;
+  }
+  const viberailsHook = {
+    matcher: "Edit|Write",
+    hooks: [
+      {
+        type: "command",
+        command: "jq -r '.tool_input.file_path' | xargs npx viberails check --files"
+      }
+    ]
+  };
+  if (!hooks.PostToolUse) {
+    hooks.PostToolUse = [viberailsHook];
+  } else if (Array.isArray(hooks.PostToolUse)) {
+    hooks.PostToolUse.push(viberailsHook);
+  }
+  settings.hooks = hooks;
+  fs11.writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}
+`);
+  console.log(`  ${chalk5.green("\u2713")} .claude/settings.json \u2014 added viberails PostToolUse hook`);
+}
 function setupPreCommitHook(projectRoot) {
   const lefthookPath = path12.join(projectRoot, "lefthook.yml");
   if (fs11.existsSync(lefthookPath)) {
     addLefthookPreCommit(lefthookPath);
-    console.log(`  ${chalk7.green("\u2713")} lefthook.yml \u2014 added viberails pre-commit`);
+    console.log(`  ${chalk5.green("\u2713")} lefthook.yml \u2014 added viberails pre-commit`);
     return;
   }
   const huskyDir = path12.join(projectRoot, ".husky");
   if (fs11.existsSync(huskyDir)) {
     writeHuskyPreCommit(huskyDir);
-    console.log(`  ${chalk7.green("\u2713")} .husky/pre-commit \u2014 added viberails check`);
+    console.log(`  ${chalk5.green("\u2713")} .husky/pre-commit \u2014 added viberails check`);
     return;
   }
   const gitDir = path12.join(projectRoot, ".git");
@@ -1146,7 +1042,7 @@ function setupPreCommitHook(projectRoot) {
       fs11.mkdirSync(hooksDir, { recursive: true });
     }
     writeGitHookPreCommit(hooksDir);
-    console.log(`  ${chalk7.green("\u2713")} .git/hooks/pre-commit`);
+    console.log(`  ${chalk5.green("\u2713")} .git/hooks/pre-commit`);
   }
 }
 function writeGitHookPreCommit(hooksDir) {
@@ -1195,6 +1091,187 @@ npx viberails check --staged
   fs11.writeFileSync(hookPath, "#!/bin/sh\nnpx viberails check --staged\n", { mode: 493 });
 }
 
+// src/commands/init-wizard.ts
+import * as p from "@clack/prompts";
+import { FRAMEWORK_NAMES as FRAMEWORK_NAMES3, LIBRARY_NAMES as LIBRARY_NAMES2, STYLING_NAMES as STYLING_NAMES3 } from "@viberails/types";
+import chalk8 from "chalk";
+
+// src/display.ts
+import { FRAMEWORK_NAMES as FRAMEWORK_NAMES2, LIBRARY_NAMES, STYLING_NAMES as STYLING_NAMES2 } from "@viberails/types";
+import chalk7 from "chalk";
+
+// src/display-helpers.ts
+import { ROLE_DESCRIPTIONS } from "@viberails/types";
+function groupByRole(directories) {
+  const map = /* @__PURE__ */ new Map();
+  for (const dir of directories) {
+    if (dir.role === "unknown") continue;
+    const existing = map.get(dir.role);
+    if (existing) {
+      existing.dirs.push(dir);
+    } else {
+      map.set(dir.role, { dirs: [dir] });
+    }
+  }
+  const groups = [];
+  for (const [role, { dirs }] of map) {
+    const label = ROLE_DESCRIPTIONS[role] ?? role;
+    const totalFiles = dirs.reduce((sum, d) => sum + d.fileCount, 0);
+    groups.push({
+      role,
+      label,
+      dirCount: dirs.length,
+      totalFiles,
+      singlePath: dirs.length === 1 ? dirs[0].path : void 0
+    });
+  }
+  return groups;
+}
+function formatSummary(stats, packageCount) {
+  const parts = [];
+  if (packageCount && packageCount > 1) {
+    parts.push(`${packageCount} packages`);
+  }
+  parts.push(`${stats.totalFiles.toLocaleString()} source files`);
+  parts.push(`${stats.totalLines.toLocaleString()} lines`);
+  parts.push(`avg ${Math.round(stats.averageFileLines)} lines/file`);
+  return parts.join(" \xB7 ");
+}
+function formatRoleGroup(group) {
+  const files = group.totalFiles === 1 ? "1 file" : `${group.totalFiles} files`;
+  if (group.singlePath) {
+    return `${group.label} \u2014 ${group.singlePath} (${files})`;
+  }
+  const dirs = group.dirCount === 1 ? "1 dir" : `${group.dirCount} dirs`;
+  return `${group.label} \u2014 ${dirs} (${files})`;
+}
+
+// src/display-monorepo.ts
+import { FRAMEWORK_NAMES, STYLING_NAMES } from "@viberails/types";
+import chalk6 from "chalk";
+
+// src/display.ts
+function formatItem(item, nameMap) {
+  const name = nameMap?.[item.name] ?? item.name;
+  return item.version ? `${name} ${item.version}` : name;
+}
+
+// src/commands/init-wizard.ts
+var DEFAULT_WIZARD_RESULT = {
+  enforcement: "warn",
+  checks: {
+    fileSize: true,
+    naming: true,
+    tests: true,
+    boundaries: false
+  },
+  integration: ["pre-commit"]
+};
+async function runWizard(scanResult) {
+  const isMonorepo = scanResult.packages.length > 1;
+  displayScanSummary(scanResult);
+  const enforcement = await p.select({
+    message: "How strict should viberails be?",
+    initialValue: "warn",
+    options: [
+      { value: "warn", label: "Warn", hint: "show issues, never block commits" },
+      { value: "enforce", label: "Enforce", hint: "block commits with violations" }
+    ]
+  });
+  if (p.isCancel(enforcement)) {
+    p.cancel("Setup cancelled.");
+    return null;
+  }
+  const checkOptions = [
+    { value: "fileSize", label: "File size limit (300 lines)" },
+    { value: "naming", label: "File naming conventions" },
+    { value: "tests", label: "Missing test files" }
+  ];
+  if (isMonorepo) {
+    checkOptions.push({ value: "boundaries", label: "Import boundaries" });
+  }
+  const enabledChecks = await p.multiselect({
+    message: "Which checks should viberails run?",
+    options: checkOptions,
+    initialValues: ["fileSize", "naming", "tests"],
+    required: false
+  });
+  if (p.isCancel(enabledChecks)) {
+    p.cancel("Setup cancelled.");
+    return null;
+  }
+  const checks = {
+    fileSize: enabledChecks.includes("fileSize"),
+    naming: enabledChecks.includes("naming"),
+    tests: enabledChecks.includes("tests"),
+    boundaries: enabledChecks.includes("boundaries")
+  };
+  const integrationOptions = [
+    { value: "pre-commit", label: "Git pre-commit hook", hint: "runs on every commit" },
+    {
+      value: "claude-hook",
+      label: "Claude Code hook",
+      hint: "checks files as Claude edits them"
+    },
+    { value: "context-only", label: "Context files only", hint: "no hooks" }
+  ];
+  const integration = await p.multiselect({
+    message: "Where should checks run?",
+    options: integrationOptions,
+    initialValues: ["pre-commit"],
+    required: true
+  });
+  if (p.isCancel(integration)) {
+    p.cancel("Setup cancelled.");
+    return null;
+  }
+  const finalIntegration = integration.includes("context-only") ? ["context-only"] : integration;
+  return {
+    enforcement,
+    checks,
+    integration: finalIntegration
+  };
+}
+function displayScanSummary(scanResult) {
+  const { stack } = scanResult;
+  const parts = [];
+  if (stack.framework) parts.push(formatItem(stack.framework, FRAMEWORK_NAMES3));
+  parts.push(formatItem(stack.language));
+  if (stack.styling) parts.push(formatItem(stack.styling, STYLING_NAMES3));
+  if (stack.backend) parts.push(formatItem(stack.backend, FRAMEWORK_NAMES3));
+  p.log.info(`${chalk8.bold("Stack:")} ${parts.join(", ")}`);
+  if (stack.linter || stack.formatter || stack.testRunner || stack.packageManager) {
+    const tools = [];
+    if (stack.linter) tools.push(formatItem(stack.linter));
+    if (stack.formatter && stack.formatter !== stack.linter)
+      tools.push(formatItem(stack.formatter));
+    if (stack.testRunner) tools.push(formatItem(stack.testRunner));
+    if (stack.packageManager) tools.push(formatItem(stack.packageManager));
+    p.log.info(`${chalk8.bold("Tools:")} ${tools.join(", ")}`);
+  }
+  if (stack.libraries.length > 0) {
+    const libs = stack.libraries.map((lib) => formatItem(lib, LIBRARY_NAMES2)).join(", ");
+    p.log.info(`${chalk8.bold("Libraries:")} ${libs}`);
+  }
+  const groups = groupByRole(scanResult.structure.directories);
+  if (groups.length > 0) {
+    const structParts = groups.map((g) => formatRoleGroup(g));
+    p.log.info(`${chalk8.bold("Structure:")} ${structParts.join(", ")}`);
+  }
+  const conventionEntries = Object.entries(scanResult.conventions).filter(
+    ([, c]) => c.confidence !== "low"
+  );
+  if (conventionEntries.length > 0) {
+    const convParts = conventionEntries.map(([, c]) => {
+      const pct = Math.round(c.consistency);
+      return `${c.value} (${pct}%)`;
+    });
+    p.log.info(`${chalk8.bold("Conventions:")} ${convParts.join(", ")}`);
+  }
+  const pkgCount = scanResult.packages.length > 1 ? scanResult.packages.length : void 0;
+  p.log.info(`${chalk8.bold("Summary:")} ${formatSummary(scanResult.statistics, pkgCount)}`);
+}
+
 // src/commands/init.ts
 var CONFIG_FILE4 = "viberails.config.json";
 function filterHighConfidence(conventions) {
@@ -1209,6 +1286,13 @@ function filterHighConfidence(conventions) {
   }
   return filtered;
 }
+function applyWizardResult(config, wizard) {
+  config.enforcement = wizard.enforcement;
+  if (!wizard.checks.fileSize) config.rules.maxFileLines = 0;
+  config.rules.enforceNaming = wizard.checks.naming;
+  config.rules.requireTests = wizard.checks.tests;
+  config.rules.enforceBoundaries = wizard.checks.boundaries;
+}
 async function initCommand(options, cwd) {
   const startDir = cwd ?? process.cwd();
   const projectRoot = findProjectRoot(startDir);
@@ -1220,64 +1304,69 @@ async function initCommand(options, cwd) {
   const configPath = path13.join(projectRoot, CONFIG_FILE4);
   if (fs12.existsSync(configPath)) {
     console.log(
-      chalk8.yellow("!") + " viberails is already initialized in this project.\n  Run " + chalk8.cyan("viberails sync") + " to update the generated files."
+      chalk9.yellow("!") + " viberails is already initialized in this project.\n  Run " + chalk9.cyan("viberails sync") + " to update the generated files."
     );
     return;
   }
-  console.log(chalk8.dim("Scanning project..."));
+  p2.intro("viberails");
+  const s = p2.spinner();
+  s.start("Scanning project...");
   const scanResult = await scan(projectRoot);
-  displayScanResults(scanResult);
+  s.stop("Scan complete");
   if (scanResult.statistics.totalFiles === 0) {
-    console.log(
-      chalk8.yellow("!") + " No source files detected. viberails will generate context with minimal content.\n  Run " + chalk8.cyan("viberails sync") + " after adding source files.\n"
+    p2.log.warn(
+      `No source files detected. viberails will generate context with minimal content.
+Run ${chalk9.cyan("viberails sync")} after adding source files.`
     );
   }
-  if (!options.yes) {
-    const accepted = await confirm("Does this look right?");
-    if (!accepted) {
-      console.log("Aborted.");
-      return;
-    }
+  let wizard;
+  if (options.yes) {
+    wizard = { ...DEFAULT_WIZARD_RESULT };
+  } else {
+    const result = await runWizard(scanResult);
+    if (!result) return;
+    wizard = result;
   }
   const config = generateConfig(scanResult);
   if (options.yes) {
     config.conventions = filterHighConfidence(config.conventions);
   }
-  if (config.workspace && config.workspace.packages.length > 0) {
-    let shouldInfer = options.yes;
-    if (!options.yes) {
-      shouldInfer = await confirm("Infer boundary rules from import patterns?");
-    }
-    if (shouldInfer) {
-      console.log(chalk8.dim("Building import graph..."));
-      const { buildImportGraph, inferBoundaries } = await import("@viberails/graph");
-      const packages = resolveWorkspacePackages(projectRoot, config.workspace);
-      const graph = await buildImportGraph(projectRoot, { packages, ignore: config.ignore });
-      const inferred = inferBoundaries(graph);
-      if (inferred.length > 0) {
-        config.boundaries = inferred;
-        config.rules.enforceBoundaries = true;
-        console.log(`  ${chalk8.green("\u2713")} Inferred ${inferred.length} boundary rules`);
-      }
+  applyWizardResult(config, wizard);
+  if (wizard.checks.boundaries && config.workspace && config.workspace.packages.length > 0) {
+    s.start("Inferring boundary rules...");
+    const { buildImportGraph, inferBoundaries } = await import("@viberails/graph");
+    const packages = resolveWorkspacePackages(projectRoot, config.workspace);
+    const graph = await buildImportGraph(projectRoot, { packages, ignore: config.ignore });
+    const inferred = inferBoundaries(graph);
+    const ruleCount = Object.values(inferred).reduce((sum, denied) => sum + denied.length, 0);
+    if (ruleCount > 0) {
+      config.boundaries = inferred;
+      s.stop(`Inferred ${ruleCount} boundary rules`);
+    } else {
+      s.stop("No boundary rules could be inferred");
+      config.rules.enforceBoundaries = false;
     }
   }
   fs12.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
 `);
   writeGeneratedFiles(projectRoot, config, scanResult);
   updateGitignore(projectRoot);
-  setupPreCommitHook(projectRoot);
-  console.log(`
-${chalk8.bold("Created:")}`);
-  console.log(`  ${chalk8.green("\u2713")} ${CONFIG_FILE4}`);
-  console.log(`  ${chalk8.green("\u2713")} .viberails/context.md`);
-  console.log(`  ${chalk8.green("\u2713")} .viberails/scan-result.json`);
-  console.log(`
-${chalk8.bold("Next steps:")}`);
-  console.log(`  1. Review ${chalk8.cyan("viberails.config.json")} and adjust rules`);
-  console.log(
-    `  2. Commit ${chalk8.cyan("viberails.config.json")} and ${chalk8.cyan(".viberails/context.md")}`
+  if (wizard.integration.includes("pre-commit")) {
+    setupPreCommitHook(projectRoot);
+  }
+  if (wizard.integration.includes("claude-hook")) {
+    setupClaudeCodeHook(projectRoot);
+  }
+  p2.log.success(`${chalk9.bold("Created:")}`);
+  console.log(`  ${chalk9.green("\u2713")} ${CONFIG_FILE4}`);
+  console.log(`  ${chalk9.green("\u2713")} .viberails/context.md`);
+  console.log(`  ${chalk9.green("\u2713")} .viberails/scan-result.json`);
+  p2.outro(
+    `${chalk9.bold("Next steps:")}
+  1. Review ${chalk9.cyan("viberails.config.json")} and adjust rules
+  2. Commit ${chalk9.cyan("viberails.config.json")} and ${chalk9.cyan(".viberails/context.md")}
+  3. Run ${chalk9.cyan("viberails check")} to verify your project passes`
   );
-  console.log(`  3. Run ${chalk8.cyan("viberails check")} to verify your project passes`);
 }
 function updateGitignore(projectRoot) {
   const gitignorePath = path13.join(projectRoot, ".gitignore");
@@ -1297,7 +1386,7 @@ import * as fs13 from "fs";
 import * as path14 from "path";
 import { loadConfig as loadConfig4, mergeConfig } from "@viberails/config";
 import { scan as scan2 } from "@viberails/scanner";
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 var CONFIG_FILE5 = "viberails.config.json";
 async function syncCommand(cwd) {
   const startDir = cwd ?? process.cwd();
@@ -1309,21 +1398,21 @@ async function syncCommand(cwd) {
   }
   const configPath = path14.join(projectRoot, CONFIG_FILE5);
   const existing = await loadConfig4(configPath);
-  console.log(chalk9.dim("Scanning project..."));
+  console.log(chalk10.dim("Scanning project..."));
   const scanResult = await scan2(projectRoot);
   const merged = mergeConfig(existing, scanResult);
   fs13.writeFileSync(configPath, `${JSON.stringify(merged, null, 2)}
 `);
   writeGeneratedFiles(projectRoot, merged, scanResult);
   console.log(`
-${chalk9.bold("Synced:")}`);
-  console.log(`  ${chalk9.green("\u2713")} ${CONFIG_FILE5} \u2014 updated`);
-  console.log(`  ${chalk9.green("\u2713")} .viberails/context.md \u2014 regenerated`);
-  console.log(`  ${chalk9.green("\u2713")} .viberails/scan-result.json \u2014 updated`);
+${chalk10.bold("Synced:")}`);
+  console.log(`  ${chalk10.green("\u2713")} ${CONFIG_FILE5} \u2014 updated`);
+  console.log(`  ${chalk10.green("\u2713")} .viberails/context.md \u2014 regenerated`);
+  console.log(`  ${chalk10.green("\u2713")} .viberails/scan-result.json \u2014 updated`);
 }
 
 // src/index.ts
-var VERSION = "0.2.2";
+var VERSION = "0.3.0";
 var program = new Command();
 program.name("viberails").description("Guardrails for vibe coding").version(VERSION);
 program.command("init", { isDefault: true }).description("Scan your project and set up enforcement guardrails").option("-y, --yes", "Non-interactive mode (use defaults, high-confidence only)").action(async (options) => {
@@ -1331,7 +1420,7 @@ program.command("init", { isDefault: true }).description("Scan your project and
     await initCommand(options);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`${chalk10.red("Error:")} ${message}`);
+    console.error(`${chalk11.red("Error:")} ${message}`);
     process.exit(1);
   }
 });
@@ -1340,30 +1429,32 @@ program.command("sync").description("Re-scan and update generated files").action
     await syncCommand();
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`${chalk10.red("Error:")} ${message}`);
+    console.error(`${chalk11.red("Error:")} ${message}`);
     process.exit(1);
   }
 });
-program.command("check").description("Check files against enforced rules").option("--staged", "Check only staged files (for pre-commit hooks)").option("--files <files...>", "Check specific files").option("--no-boundaries", "Skip boundary checking").action(async (options) => {
-  try {
-    const exitCode = await checkCommand({
-      ...options,
-      noBoundaries: options.boundaries === false
-    });
-    process.exit(exitCode);
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`${chalk10.red("Error:")} ${message}`);
-    process.exit(1);
+program.command("check").description("Check files against enforced rules").option("--staged", "Check only staged files (for pre-commit hooks)").option("--files <files...>", "Check specific files").option("--no-boundaries", "Skip boundary checking").option("--quiet", "Show only summary counts, not individual violations").option("--limit <n>", "Maximum number of violations to display", Number.parseInt).action(
+  async (options) => {
+    try {
+      const exitCode = await checkCommand({
+        ...options,
+        noBoundaries: options.boundaries === false
+      });
+      process.exit(exitCode);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      console.error(`${chalk11.red("Error:")} ${message}`);
+      process.exit(1);
+    }
   }
-});
+);
 program.command("fix").description("Auto-fix file naming violations and generate missing test stubs").option("--dry-run", "Show planned fixes without applying them").option("--rule <rules...>", "Fix only specific rules (file-naming, missing-test)").option("-y, --yes", "Skip confirmation prompt").action(async (options) => {
   try {
     const exitCode = await fixCommand(options);
     process.exit(exitCode);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`${chalk10.red("Error:")} ${message}`);
+    console.error(`${chalk11.red("Error:")} ${message}`);
     process.exit(1);
   }
 });
@@ -1372,7 +1463,7 @@ program.command("boundaries").description("Display, infer, or inspect import bou
     await boundariesCommand(options);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`${chalk10.red("Error:")} ${message}`);
+    console.error(`${chalk11.red("Error:")} ${message}`);
     process.exit(1);
   }
 });