viberails 0.2.3 → 0.3.1

package/dist/index.cjs

@@ -34,14 +34,14 @@ __export(index_exports, {
   VERSION: () => VERSION
 });
 module.exports = __toCommonJS(index_exports);
-var import_chalk10 = __toESM(require("chalk"), 1);
+var import_chalk11 = __toESM(require("chalk"), 1);
 var import_commander = require("commander");
 
 // src/commands/boundaries.ts
 var fs3 = __toESM(require("fs"), 1);
 var path3 = __toESM(require("path"), 1);
 var import_config = require("@viberails/config");
-var import_chalk = __toESM(require("chalk"), 1);
+var import_chalk2 = __toESM(require("chalk"), 1);
 
 // src/utils/find-project-root.ts
 var fs = __toESM(require("fs"), 1);
@@ -62,6 +62,7 @@ function findProjectRoot(startDir) {
 
 // src/utils/prompt.ts
 var readline = __toESM(require("readline"), 1);
+var import_chalk = __toESM(require("chalk"), 1);
 async function confirm(message) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -75,6 +76,29 @@ async function confirm(message) {
     });
   });
 }
+async function selectIntegrations(hookManager) {
+  const result = { preCommitHook: true, claudeCodeHook: true };
+  const hookLabel = hookManager ? `Pre-commit hook (detected: ${hookManager})` : "Pre-commit hook (git hook)";
+  console.log("Set up integrations:");
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const askYn = (label, defaultYes) => new Promise((resolve4) => {
+    const hint = defaultYes ? "Y/n" : "y/N";
+    rl.question(`  ${label}? (${hint}) `, (answer) => {
+      const trimmed = answer.trim().toLowerCase();
+      if (trimmed === "") resolve4(defaultYes);
+      else resolve4(trimmed === "y" || trimmed === "yes");
+    });
+  });
+  console.log(`    ${import_chalk.default.dim("Runs viberails check automatically when you commit")}`);
+  result.preCommitHook = await askYn(hookLabel, true);
+  console.log(`    ${import_chalk.default.dim("Checks files against your rules when Claude edits them")}`);
+  result.claudeCodeHook = await askYn("Claude Code hook", true);
+  rl.close();
+  return result;
+}
 
 // src/utils/resolve-workspace-packages.ts
 var fs2 = __toESM(require("fs"), 1);
@@ -131,52 +155,52 @@ async function boundariesCommand(options, cwd) {
 }
 function displayRules(config) {
   if (!config.boundaries || config.boundaries.length === 0) {
-    console.log(import_chalk.default.yellow("No boundary rules configured."));
-    console.log(`Run ${import_chalk.default.cyan("viberails boundaries --infer")} to generate rules.`);
+    console.log(import_chalk2.default.yellow("No boundary rules configured."));
+    console.log(`Run ${import_chalk2.default.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(`
-${import_chalk.default.bold(`Boundary rules (${config.boundaries.length} rules):`)}
+${import_chalk2.default.bold(`Boundary rules (${config.boundaries.length} rules):`)}
 `);
   for (const r of allowRules) {
-    console.log(`  ${import_chalk.default.green("\u2713")} ${r.from} \u2192 ${r.to}`);
+    console.log(`  ${import_chalk2.default.green("\u2713")} ${r.from} \u2192 ${r.to}`);
   }
   for (const r of denyRules) {
-    const reason = r.reason ? import_chalk.default.dim(` (${r.reason})`) : "";
-    console.log(`  ${import_chalk.default.red("\u2717")} ${r.from} \u2192 ${r.to}${reason}`);
+    const reason = r.reason ? import_chalk2.default.dim(` (${r.reason})`) : "";
+    console.log(`  ${import_chalk2.default.red("\u2717")} ${r.from} \u2192 ${r.to}${reason}`);
   }
   console.log(
     `
-Enforcement: ${config.rules.enforceBoundaries ? import_chalk.default.green("on") : import_chalk.default.yellow("off")}`
+Enforcement: ${config.rules.enforceBoundaries ? import_chalk2.default.green("on") : import_chalk2.default.yellow("off")}`
   );
 }
 async function inferAndDisplay(projectRoot, config, configPath) {
-  console.log(import_chalk.default.dim("Analyzing imports..."));
+  console.log(import_chalk2.default.dim("Analyzing imports..."));
   const { buildImportGraph, inferBoundaries } = await import("@viberails/graph");
   const packages = config.workspace ? resolveWorkspacePackages(projectRoot, config.workspace) : void 0;
   const graph = await buildImportGraph(projectRoot, {
     packages,
     ignore: config.ignore
   });
-  console.log(import_chalk.default.dim(`${graph.nodes.length} files, ${graph.edges.length} edges`));
+  console.log(import_chalk2.default.dim(`${graph.nodes.length} files, ${graph.edges.length} edges`));
   const inferred = inferBoundaries(graph);
   if (inferred.length === 0) {
-    console.log(import_chalk.default.yellow("No boundary rules could be inferred."));
+    console.log(import_chalk2.default.yellow("No boundary rules could be inferred."));
     return;
   }
   const allow = inferred.filter((r) => r.allow);
   const deny = inferred.filter((r) => !r.allow);
   console.log(`
-${import_chalk.default.bold("Inferred boundary rules:")}
+${import_chalk2.default.bold("Inferred boundary rules:")}
 `);
   for (const r of allow) {
-    console.log(`  ${import_chalk.default.green("\u2713")} ${r.from} \u2192 ${r.to}`);
+    console.log(`  ${import_chalk2.default.green("\u2713")} ${r.from} \u2192 ${r.to}`);
   }
   for (const r of deny) {
-    const reason = r.reason ? import_chalk.default.dim(` (${r.reason})`) : "";
-    console.log(`  ${import_chalk.default.red("\u2717")} ${r.from} \u2192 ${r.to}${reason}`);
+    const reason = r.reason ? import_chalk2.default.dim(` (${r.reason})`) : "";
+    console.log(`  ${import_chalk2.default.red("\u2717")} ${r.from} \u2192 ${r.to}${reason}`);
   }
   console.log(`
   ${allow.length} allowed, ${deny.length} denied`);
@@ -186,11 +210,11 @@ ${import_chalk.default.bold("Inferred boundary rules:")}
     config.rules.enforceBoundaries = true;
     fs3.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
 `);
-    console.log(`${import_chalk.default.green("\u2713")} Saved ${inferred.length} rules`);
+    console.log(`${import_chalk2.default.green("\u2713")} Saved ${inferred.length} rules`);
   }
 }
 async function showGraph(projectRoot, config) {
-  console.log(import_chalk.default.dim("Building import graph..."));
+  console.log(import_chalk2.default.dim("Building import graph..."));
   const { buildImportGraph } = await import("@viberails/graph");
   const packages = config.workspace ? resolveWorkspacePackages(projectRoot, config.workspace) : void 0;
   const graph = await buildImportGraph(projectRoot, {
@@ -198,20 +222,20 @@ async function showGraph(projectRoot, config) {
     ignore: config.ignore
   });
   console.log(`
-${import_chalk.default.bold("Import dependency graph:")}
+${import_chalk2.default.bold("Import dependency graph:")}
 `);
   console.log(`  ${graph.nodes.length} files, ${graph.edges.length} imports
 `);
   if (graph.packages.length > 0) {
     for (const pkg of graph.packages) {
       const deps = pkg.internalDeps.length > 0 ? `
-${pkg.internalDeps.map((d) => `    \u2192 ${d}`).join("\n")}` : import_chalk.default.dim(" (no internal deps)");
+${pkg.internalDeps.map((d) => `    \u2192 ${d}`).join("\n")}` : import_chalk2.default.dim(" (no internal deps)");
       console.log(`  ${pkg.name}${deps}`);
     }
   }
   if (graph.cycles.length > 0) {
     console.log(`
-${import_chalk.default.yellow("Cycles detected:")}`);
+${import_chalk2.default.yellow("Cycles detected:")}`);
     for (const cycle of graph.cycles) {
       const paths = cycle.map((f) => path3.relative(projectRoot, f));
       console.log(`  ${paths.join(" \u2192 ")}`);
@@ -223,7 +247,7 @@ ${import_chalk.default.yellow("Cycles detected:")}`);
 var fs6 = __toESM(require("fs"), 1);
 var path6 = __toESM(require("path"), 1);
 var import_config2 = require("@viberails/config");
-var import_chalk2 = __toESM(require("chalk"), 1);
+var import_chalk3 = __toESM(require("chalk"), 1);
 
 // src/commands/check-config.ts
 function resolveConfigForFile(relPath, config) {
@@ -256,6 +280,7 @@ function resolveIgnoreForFile(relPath, config) {
 var import_node_child_process = require("child_process");
 var fs4 = __toESM(require("fs"), 1);
 var path4 = __toESM(require("path"), 1);
+var import_picomatch = __toESM(require("picomatch"), 1);
 var ALWAYS_SKIP_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -291,25 +316,9 @@ var NAMING_PATTERNS = {
   snake_case: /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/
 };
 function isIgnored(relPath, ignorePatterns) {
-  for (const pattern of ignorePatterns) {
-    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 (startsGlob) {
-      const suffix = pattern.slice(3);
-      if (relPath.endsWith(suffix) || relPath === suffix) return true;
-    } else if (relPath === pattern || relPath.startsWith(`${pattern}/`)) {
-      return true;
-    }
-  }
-  return false;
+  if (ignorePatterns.length === 0) return false;
+  const isMatch = (0, import_picomatch.default)(ignorePatterns, { dot: true });
+  return isMatch(relPath);
 }
 function countFileLines(filePath) {
   try {
@@ -476,12 +485,12 @@ function printGroupedViolations(violations, limit) {
     const toShow = group.slice(0, remaining);
     const hidden = group.length - toShow.length;
     for (const v of toShow) {
-      const icon = v.severity === "error" ? import_chalk2.default.red("\u2717") : import_chalk2.default.yellow("!");
-      console.log(`${icon} ${import_chalk2.default.dim(v.rule)} ${v.file}: ${v.message}`);
+      const icon = v.severity === "error" ? import_chalk3.default.red("\u2717") : import_chalk3.default.yellow("!");
+      console.log(`${icon} ${import_chalk3.default.dim(v.rule)} ${v.file}: ${v.message}`);
     }
     totalShown += toShow.length;
     if (hidden > 0) {
-      console.log(import_chalk2.default.dim(`  ... and ${hidden} more ${rule} violations`));
+      console.log(import_chalk3.default.dim(`  ... and ${hidden} more ${rule} violations`));
     }
   }
 }
@@ -499,13 +508,13 @@ async function checkCommand(options, cwd) {
   const startDir = cwd ?? process.cwd();
   const projectRoot = findProjectRoot(startDir);
   if (!projectRoot) {
-    console.error(`${import_chalk2.default.red("Error:")} No package.json found. Are you in a JS/TS project?`);
+    console.error(`${import_chalk3.default.red("Error:")} No package.json found. Are you in a JS/TS project?`);
     return 1;
   }
   const configPath = path6.join(projectRoot, CONFIG_FILE2);
   if (!fs6.existsSync(configPath)) {
     console.error(
-      `${import_chalk2.default.red("Error:")} No viberails.config.json found. Run \`viberails init\` first.`
+      `${import_chalk3.default.red("Error:")} No viberails.config.json found. Run \`viberails init\` first.`
     );
     return 1;
   }
@@ -519,7 +528,7 @@ async function checkCommand(options, cwd) {
     filesToCheck = getAllSourceFiles(projectRoot, config);
   }
   if (filesToCheck.length === 0) {
-    console.log(`${import_chalk2.default.green("\u2713")} No files to check.`);
+    console.log(`${import_chalk3.default.green("\u2713")} No files to check.`);
     return 0;
   }
   const violations = [];
@@ -581,10 +590,20 @@ async function checkCommand(options, cwd) {
       });
     }
     const elapsed = Date.now() - startTime;
-    console.log(import_chalk2.default.dim(`  Boundary check: ${graph.nodes.length} files in ${elapsed}ms`));
+    console.log(import_chalk3.default.dim(`  Boundary check: ${graph.nodes.length} files in ${elapsed}ms`));
+  }
+  if (options.format === "json") {
+    console.log(
+      JSON.stringify({
+        violations,
+        checkedFiles: filesToCheck.length,
+        enforcement: config.enforcement
+      })
+    );
+    return config.enforcement === "enforce" && violations.length > 0 ? 1 : 0;
   }
   if (violations.length === 0) {
-    console.log(`${import_chalk2.default.green("\u2713")} ${filesToCheck.length} files checked \u2014 no violations`);
+    console.log(`${import_chalk3.default.green("\u2713")} ${filesToCheck.length} files checked \u2014 no violations`);
     return 0;
   }
   if (!options.quiet) {
@@ -592,7 +611,7 @@ async function checkCommand(options, cwd) {
   }
   printSummary(violations);
   if (config.enforcement === "enforce") {
-    console.log(import_chalk2.default.red("Fix violations before committing."));
+    console.log(import_chalk3.default.red("Fix violations before committing."));
     return 1;
   }
   return 0;
@@ -602,23 +621,23 @@ async function checkCommand(options, cwd) {
 var fs9 = __toESM(require("fs"), 1);
 var path10 = __toESM(require("path"), 1);
 var import_config3 = require("@viberails/config");
-var import_chalk4 = __toESM(require("chalk"), 1);
+var import_chalk5 = __toESM(require("chalk"), 1);
 
 // src/commands/fix-helpers.ts
 var import_node_child_process2 = require("child_process");
 var import_node_readline = require("readline");
-var import_chalk3 = __toESM(require("chalk"), 1);
+var import_chalk4 = __toESM(require("chalk"), 1);
 function printPlan(renames, stubs) {
   if (renames.length > 0) {
-    console.log(import_chalk3.default.bold("\nFile renames:"));
+    console.log(import_chalk4.default.bold("\nFile renames:"));
     for (const r of renames) {
-      console.log(`  ${import_chalk3.default.red(r.oldPath)} \u2192 ${import_chalk3.default.green(r.newPath)}`);
+      console.log(`  ${import_chalk4.default.red(r.oldPath)} \u2192 ${import_chalk4.default.green(r.newPath)}`);
     }
   }
   if (stubs.length > 0) {
-    console.log(import_chalk3.default.bold("\nTest stubs to create:"));
+    console.log(import_chalk4.default.bold("\nTest stubs to create:"));
     for (const s of stubs) {
-      console.log(`  ${import_chalk3.default.green("+")} ${s.path}`);
+      console.log(`  ${import_chalk4.default.green("+")} ${s.path}`);
     }
   }
 }
@@ -682,7 +701,8 @@ async function updateImportsAfterRenames(renames, projectRoot) {
   const extensions = ["", ".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx", "/index.js"];
   for (const sourceFile of project.getSourceFiles()) {
     const filePath = sourceFile.getFilePath();
-    if (filePath.includes("/node_modules/") || filePath.includes("/dist/")) continue;
+    const segments = filePath.split(path7.sep);
+    if (segments.includes("node_modules") || segments.includes("dist")) continue;
     const fileDir = path7.dirname(filePath);
     for (const decl of sourceFile.getImportDeclarations()) {
       const specifier = decl.getModuleSpecifierValue();
@@ -868,13 +888,13 @@ async function fixCommand(options, cwd) {
   const startDir = cwd ?? process.cwd();
   const projectRoot = findProjectRoot(startDir);
   if (!projectRoot) {
-    console.error(`${import_chalk4.default.red("Error:")} No package.json found. Are you in a JS/TS project?`);
+    console.error(`${import_chalk5.default.red("Error:")} No package.json found. Are you in a JS/TS project?`);
     return 1;
   }
   const configPath = path10.join(projectRoot, CONFIG_FILE3);
   if (!fs9.existsSync(configPath)) {
     console.error(
-      `${import_chalk4.default.red("Error:")} No viberails.config.json found. Run \`viberails init\` first.`
+      `${import_chalk5.default.red("Error:")} No viberails.config.json found. Run \`viberails init\` first.`
     );
     return 1;
   }
@@ -883,7 +903,7 @@ async function fixCommand(options, cwd) {
     const isDirty = checkGitDirty(projectRoot);
     if (isDirty) {
       console.log(
-        import_chalk4.default.yellow("Warning: You have uncommitted changes. Consider committing first.")
+        import_chalk5.default.yellow("Warning: You have uncommitted changes. Consider committing first.")
       );
     }
   }
@@ -913,12 +933,12 @@ async function fixCommand(options, cwd) {
     }
   }
   if (dedupedRenames.length === 0 && testStubs.length === 0) {
-    console.log(`${import_chalk4.default.green("\u2713")} No fixable violations found.`);
+    console.log(`${import_chalk5.default.green("\u2713")} No fixable violations found.`);
     return 0;
   }
   printPlan(dedupedRenames, testStubs);
   if (options.dryRun) {
-    console.log(import_chalk4.default.dim("\nDry run \u2014 no changes applied."));
+    console.log(import_chalk5.default.dim("\nDry run \u2014 no changes applied."));
     return 0;
   }
   if (!options.yes) {
@@ -949,15 +969,15 @@ async function fixCommand(options, cwd) {
   }
   console.log("");
   if (renameCount > 0) {
-    console.log(`${import_chalk4.default.green("\u2713")} Renamed ${renameCount} file${renameCount > 1 ? "s" : ""}`);
+    console.log(`${import_chalk5.default.green("\u2713")} Renamed ${renameCount} file${renameCount > 1 ? "s" : ""}`);
   }
   if (importUpdateCount > 0) {
     console.log(
-      `${import_chalk4.default.green("\u2713")} Updated ${importUpdateCount} import${importUpdateCount > 1 ? "s" : ""}`
+      `${import_chalk5.default.green("\u2713")} Updated ${importUpdateCount} import${importUpdateCount > 1 ? "s" : ""}`
     );
   }
   if (stubCount > 0) {
-    console.log(`${import_chalk4.default.green("\u2713")} Generated ${stubCount} test stub${stubCount > 1 ? "s" : ""}`);
+    console.log(`${import_chalk5.default.green("\u2713")} Generated ${stubCount} test stub${stubCount > 1 ? "s" : ""}`);
   }
   return 0;
 }
@@ -967,11 +987,11 @@ var fs12 = __toESM(require("fs"), 1);
 var path13 = __toESM(require("path"), 1);
 var import_config4 = require("@viberails/config");
 var import_scanner = require("@viberails/scanner");
-var import_chalk8 = __toESM(require("chalk"), 1);
+var import_chalk9 = __toESM(require("chalk"), 1);
 
 // src/display.ts
 var import_types3 = require("@viberails/types");
-var import_chalk6 = __toESM(require("chalk"), 1);
+var import_chalk7 = __toESM(require("chalk"), 1);
 
 // src/display-helpers.ts
 var import_types = require("@viberails/types");
@@ -1024,7 +1044,7 @@ function formatRoleGroup(group) {
 
 // src/display-monorepo.ts
 var import_types2 = require("@viberails/types");
-var import_chalk5 = __toESM(require("chalk"), 1);
+var import_chalk6 = __toESM(require("chalk"), 1);
 function formatPackageSummary(pkg) {
   const parts = [];
   if (pkg.stack.framework) {
@@ -1040,19 +1060,19 @@ function formatPackageSummary(pkg) {
 function displayMonorepoResults(scanResult) {
   const { stack, packages } = scanResult;
   console.log(`
-${import_chalk5.default.bold(`Detected: (monorepo, ${packages.length} packages)`)}`);
-  console.log(`  ${import_chalk5.default.green("\u2713")} ${formatItem(stack.language)}`);
+${import_chalk6.default.bold(`Detected: (monorepo, ${packages.length} packages)`)}`);
+  console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.language)}`);
   if (stack.packageManager) {
-    console.log(`  ${import_chalk5.default.green("\u2713")} ${formatItem(stack.packageManager)}`);
+    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.packageManager)}`);
   }
   if (stack.linter) {
-    console.log(`  ${import_chalk5.default.green("\u2713")} ${formatItem(stack.linter)}`);
+    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.linter)}`);
   }
   if (stack.formatter) {
-    console.log(`  ${import_chalk5.default.green("\u2713")} ${formatItem(stack.formatter)}`);
+    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.formatter)}`);
   }
   if (stack.testRunner) {
-    console.log(`  ${import_chalk5.default.green("\u2713")} ${formatItem(stack.testRunner)}`);
+    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.testRunner)}`);
   }
   console.log("");
   for (const pkg of packages) {
@@ -1063,13 +1083,13 @@ ${import_chalk5.default.bold(`Detected: (monorepo, ${packages.length} packages)`
   );
   if (packagesWithDirs.length > 0) {
     console.log(`
-${import_chalk5.default.bold("Structure:")}`);
+${import_chalk6.default.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(`    ${import_chalk5.default.green("\u2713")} ${formatRoleGroup(group)}`);
+        console.log(`    ${import_chalk6.default.green("\u2713")} ${formatRoleGroup(group)}`);
       }
     }
   }
@@ -1100,7 +1120,7 @@ function displayConventions(scanResult) {
   const conventionEntries = Object.entries(scanResult.conventions);
   if (conventionEntries.length === 0) return;
   console.log(`
-${import_chalk6.default.bold("Conventions:")}`);
+${import_chalk7.default.bold("Conventions:")}`);
   for (const [key, convention] of conventionEntries) {
     if (convention.confidence === "low") continue;
     const label = CONVENTION_LABELS[key] ?? key;
@@ -1108,19 +1128,19 @@ ${import_chalk6.default.bold("Conventions:")}`);
       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" ? import_chalk6.default.green("\u2713") : import_chalk6.default.yellow("~");
-        const detail = import_chalk6.default.dim(`(${confidenceLabel(convention)})`);
+        const ind = convention.confidence === "high" ? import_chalk7.default.green("\u2713") : import_chalk7.default.yellow("~");
+        const detail = import_chalk7.default.dim(`(${confidenceLabel(convention)})`);
         console.log(`  ${ind} ${label}: ${convention.value} ${detail}`);
       } else {
-        console.log(`  ${import_chalk6.default.yellow("~")} ${label}: varies by package`);
+        console.log(`  ${import_chalk7.default.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" ? import_chalk6.default.green("\u2713") : import_chalk6.default.yellow("~");
-      const detail = import_chalk6.default.dim(`(${confidenceLabel(convention)})`);
+      const ind = convention.confidence === "high" ? import_chalk7.default.green("\u2713") : import_chalk7.default.yellow("~");
+      const detail = import_chalk7.default.dim(`(${confidenceLabel(convention)})`);
       console.log(`  ${ind} ${label}: ${convention.value} ${detail}`);
     }
   }
@@ -1128,7 +1148,7 @@ ${import_chalk6.default.bold("Conventions:")}`);
 function displaySummarySection(scanResult) {
   const pkgCount = scanResult.packages.length > 1 ? scanResult.packages.length : void 0;
   console.log(`
-${import_chalk6.default.bold("Summary:")}`);
+${import_chalk7.default.bold("Summary:")}`);
   console.log(`  ${formatSummary(scanResult.statistics, pkgCount)}`);
   const ext = formatExtensions(scanResult.statistics.filesByExtension);
   if (ext) {
@@ -1142,46 +1162,84 @@ function displayScanResults(scanResult) {
   }
   const { stack } = scanResult;
   console.log(`
-${import_chalk6.default.bold("Detected:")}`);
+${import_chalk7.default.bold("Detected:")}`);
   if (stack.framework) {
-    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.framework, import_types3.FRAMEWORK_NAMES)}`);
+    console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.framework, import_types3.FRAMEWORK_NAMES)}`);
   }
-  console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.language)}`);
+  console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.language)}`);
   if (stack.styling) {
-    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.styling, import_types3.STYLING_NAMES)}`);
+    console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.styling, import_types3.STYLING_NAMES)}`);
   }
   if (stack.backend) {
-    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.backend, import_types3.FRAMEWORK_NAMES)}`);
+    console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.backend, import_types3.FRAMEWORK_NAMES)}`);
+  }
+  if (stack.orm) {
+    console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.orm, import_types3.ORM_NAMES)}`);
   }
   if (stack.linter) {
-    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.linter)}`);
+    console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.linter)}`);
   }
   if (stack.formatter) {
-    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.formatter)}`);
+    console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.formatter)}`);
   }
   if (stack.testRunner) {
-    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.testRunner)}`);
+    console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.testRunner)}`);
   }
   if (stack.packageManager) {
-    console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(stack.packageManager)}`);
+    console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(stack.packageManager)}`);
   }
   if (stack.libraries.length > 0) {
     for (const lib of stack.libraries) {
-      console.log(`  ${import_chalk6.default.green("\u2713")} ${formatItem(lib, import_types3.LIBRARY_NAMES)}`);
+      console.log(`  ${import_chalk7.default.green("\u2713")} ${formatItem(lib, import_types3.LIBRARY_NAMES)}`);
     }
   }
   const groups = groupByRole(scanResult.structure.directories);
   if (groups.length > 0) {
     console.log(`
-${import_chalk6.default.bold("Structure:")}`);
+${import_chalk7.default.bold("Structure:")}`);
     for (const group of groups) {
-      console.log(`  ${import_chalk6.default.green("\u2713")} ${formatRoleGroup(group)}`);
+      console.log(`  ${import_chalk7.default.green("\u2713")} ${formatRoleGroup(group)}`);
     }
   }
   displayConventions(scanResult);
   displaySummarySection(scanResult);
   console.log("");
 }
+function getConventionStr(cv) {
+  return typeof cv === "string" ? cv : cv.value;
+}
+function displayRulesPreview(config) {
+  console.log(`${import_chalk7.default.bold("Rules:")}`);
+  console.log(`  ${import_chalk7.default.dim("\u2022")} Max file size: ${config.rules.maxFileLines} lines`);
+  if (config.rules.requireTests && config.structure.testPattern) {
+    console.log(
+      `  ${import_chalk7.default.dim("\u2022")} Require test files: yes (${config.structure.testPattern})`
+    );
+  } else if (config.rules.requireTests) {
+    console.log(`  ${import_chalk7.default.dim("\u2022")} Require test files: yes`);
+  } else {
+    console.log(`  ${import_chalk7.default.dim("\u2022")} Require test files: no`);
+  }
+  if (config.rules.enforceNaming && config.conventions.fileNaming) {
+    console.log(
+      `  ${import_chalk7.default.dim("\u2022")} Enforce file naming: ${getConventionStr(config.conventions.fileNaming)}`
+    );
+  } else {
+    console.log(`  ${import_chalk7.default.dim("\u2022")} Enforce file naming: no`);
+  }
+  console.log(
+    `  ${import_chalk7.default.dim("\u2022")} Enforce boundaries: ${config.rules.enforceBoundaries ? "yes" : "no"}`
+  );
+  console.log("");
+  if (config.enforcement === "enforce") {
+    console.log(`${import_chalk7.default.bold("Enforcement mode:")} enforce (violations will block commits)`);
+  } else {
+    console.log(
+      `${import_chalk7.default.bold("Enforcement mode:")} warn (violations shown but won't block commits)`
+    );
+  }
+  console.log("");
+}
 
 // src/utils/write-generated-files.ts
 var fs10 = __toESM(require("fs"), 1);
@@ -1212,18 +1270,18 @@ function writeGeneratedFiles(projectRoot, config, scanResult) {
 // src/commands/init-hooks.ts
 var fs11 = __toESM(require("fs"), 1);
 var path12 = __toESM(require("path"), 1);
-var import_chalk7 = __toESM(require("chalk"), 1);
+var import_chalk8 = __toESM(require("chalk"), 1);
 function setupPreCommitHook(projectRoot) {
   const lefthookPath = path12.join(projectRoot, "lefthook.yml");
   if (fs11.existsSync(lefthookPath)) {
     addLefthookPreCommit(lefthookPath);
-    console.log(`  ${import_chalk7.default.green("\u2713")} lefthook.yml \u2014 added viberails pre-commit`);
+    console.log(`  ${import_chalk8.default.green("\u2713")} lefthook.yml \u2014 added viberails pre-commit`);
     return;
   }
   const huskyDir = path12.join(projectRoot, ".husky");
   if (fs11.existsSync(huskyDir)) {
     writeHuskyPreCommit(huskyDir);
-    console.log(`  ${import_chalk7.default.green("\u2713")} .husky/pre-commit \u2014 added viberails check`);
+    console.log(`  ${import_chalk8.default.green("\u2713")} .husky/pre-commit \u2014 added viberails check`);
     return;
   }
   const gitDir = path12.join(projectRoot, ".git");
@@ -1233,7 +1291,7 @@ function setupPreCommitHook(projectRoot) {
       fs11.mkdirSync(hooksDir, { recursive: true });
     }
     writeGitHookPreCommit(hooksDir);
-    console.log(`  ${import_chalk7.default.green("\u2713")} .git/hooks/pre-commit`);
+    console.log(`  ${import_chalk8.default.green("\u2713")} .git/hooks/pre-commit`);
   }
 }
 function writeGitHookPreCommit(hooksDir) {
@@ -1263,10 +1321,72 @@ npx viberails check --staged
 function addLefthookPreCommit(lefthookPath) {
   const content = fs11.readFileSync(lefthookPath, "utf-8");
   if (content.includes("viberails")) return;
-  const addition = ["", "  viberails:", "    run: npx viberails check --staged"].join("\n");
-  fs11.writeFileSync(lefthookPath, `${content.trimEnd()}
-${addition}
+  const hasPreCommit = /^pre-commit:/m.test(content);
+  if (hasPreCommit) {
+    const commandBlock = ["", "    viberails:", "      run: npx viberails check --staged"].join(
+      "\n"
+    );
+    const updated = `${content.trimEnd()}
+${commandBlock}
+`;
+    fs11.writeFileSync(lefthookPath, updated);
+  } else {
+    const section = [
+      "",
+      "pre-commit:",
+      "  commands:",
+      "    viberails:",
+      "      run: npx viberails check --staged"
+    ].join("\n");
+    fs11.writeFileSync(lefthookPath, `${content.trimEnd()}
+${section}
 `);
+  }
+}
+function detectHookManager(projectRoot) {
+  if (fs11.existsSync(path12.join(projectRoot, "lefthook.yml"))) return "Lefthook";
+  if (fs11.existsSync(path12.join(projectRoot, ".husky"))) return "Husky";
+  if (fs11.existsSync(path12.join(projectRoot, ".git"))) return "git hook";
+  return void 0;
+}
+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 {
+      console.warn(
+        `  ${import_chalk8.default.yellow("!")} .claude/settings.json contains invalid JSON \u2014 resetting to add hook`
+      );
+      settings = {};
+    }
+  }
+  const hooks = settings.hooks ?? {};
+  const existing = hooks.PostToolUse ?? [];
+  if (existing.some((h) => JSON.stringify(h).includes("viberails"))) return;
+  const extractFile = `node -e "try{process.stdout.write(JSON.parse(require('fs').readFileSync(0,'utf8')).tool_input?.file_path??'')}catch{}"`;
+  const hookCommand = `FILE=$(${extractFile}) && [ -n "$FILE" ] && npx viberails check --files "$FILE" --format json; exit 0`;
+  hooks.PostToolUse = [
+    ...existing,
+    {
+      matcher: "Edit|Write",
+      hooks: [
+        {
+          type: "command",
+          command: hookCommand
+        }
+      ]
+    }
+  ];
+  settings.hooks = hooks;
+  fs11.writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}
+`);
+  console.log(`  ${import_chalk8.default.green("\u2713")} .claude/settings.json \u2014 added viberails PostToolUse hook`);
 }
 function writeHuskyPreCommit(huskyDir) {
   const hookPath = path12.join(huskyDir, "pre-commit");
@@ -1307,36 +1427,38 @@ async function initCommand(options, cwd) {
   const configPath = path13.join(projectRoot, CONFIG_FILE4);
   if (fs12.existsSync(configPath)) {
     console.log(
-      import_chalk8.default.yellow("!") + " viberails is already initialized in this project.\n  Run " + import_chalk8.default.cyan("viberails sync") + " to update the generated files."
+      import_chalk9.default.yellow("!") + " viberails is already initialized in this project.\n  Run " + import_chalk9.default.cyan("viberails sync") + " to update the generated files."
     );
     return;
   }
-  console.log(import_chalk8.default.dim("Scanning project..."));
+  console.log(import_chalk9.default.dim("Scanning project..."));
   const scanResult = await (0, import_scanner.scan)(projectRoot);
+  const config = (0, import_config4.generateConfig)(scanResult);
+  if (options.yes) {
+    config.conventions = filterHighConfidence(config.conventions);
+  }
   displayScanResults(scanResult);
   if (scanResult.statistics.totalFiles === 0) {
     console.log(
-      import_chalk8.default.yellow("!") + " No source files detected. viberails will generate context with minimal content.\n  Run " + import_chalk8.default.cyan("viberails sync") + " after adding source files.\n"
+      import_chalk9.default.yellow("!") + " No source files detected. viberails will generate context with minimal content.\n  Run " + import_chalk9.default.cyan("viberails sync") + " after adding source files.\n"
     );
   }
+  displayRulesPreview(config);
   if (!options.yes) {
-    const accepted = await confirm("Does this look right?");
+    const accepted = await confirm("Proceed with these settings?");
     if (!accepted) {
       console.log("Aborted.");
       return;
     }
   }
-  const config = (0, import_config4.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) {
+      console.log(import_chalk9.default.dim("  Scans imports between packages to suggest dependency rules"));
       shouldInfer = await confirm("Infer boundary rules from import patterns?");
     }
     if (shouldInfer) {
-      console.log(import_chalk8.default.dim("Building import graph..."));
+      console.log(import_chalk9.default.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 });
@@ -1344,27 +1466,43 @@ async function initCommand(options, cwd) {
       if (inferred.length > 0) {
         config.boundaries = inferred;
         config.rules.enforceBoundaries = true;
-        console.log(`  ${import_chalk8.default.green("\u2713")} Inferred ${inferred.length} boundary rules`);
+        console.log(`  ${import_chalk9.default.green("\u2713")} Inferred ${inferred.length} boundary rules`);
       }
     }
   }
+  const hookManager = detectHookManager(projectRoot);
+  let integrations = { preCommitHook: true, claudeCodeHook: true };
+  if (!options.yes) {
+    console.log("");
+    integrations = await selectIntegrations(hookManager);
+  }
   fs12.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
 `);
   writeGeneratedFiles(projectRoot, config, scanResult);
   updateGitignore(projectRoot);
-  setupPreCommitHook(projectRoot);
   console.log(`
-${import_chalk8.default.bold("Created:")}`);
-  console.log(`  ${import_chalk8.default.green("\u2713")} ${CONFIG_FILE4}`);
-  console.log(`  ${import_chalk8.default.green("\u2713")} .viberails/context.md`);
-  console.log(`  ${import_chalk8.default.green("\u2713")} .viberails/scan-result.json`);
+${import_chalk9.default.bold("Created:")}`);
+  console.log(`  ${import_chalk9.default.green("\u2713")} ${CONFIG_FILE4}`);
+  console.log(`  ${import_chalk9.default.green("\u2713")} .viberails/context.md`);
+  console.log(`  ${import_chalk9.default.green("\u2713")} .viberails/scan-result.json`);
+  if (integrations.preCommitHook) {
+    setupPreCommitHook(projectRoot);
+  }
+  if (integrations.claudeCodeHook) {
+    setupClaudeCodeHook(projectRoot);
+  }
+  const filesToCommit = [
+    `${import_chalk9.default.cyan("viberails.config.json")}`,
+    import_chalk9.default.cyan(".viberails/context.md")
+  ];
+  if (integrations.claudeCodeHook) {
+    filesToCommit.push(import_chalk9.default.cyan(".claude/settings.json"));
+  }
   console.log(`
-${import_chalk8.default.bold("Next steps:")}`);
-  console.log(`  1. Review ${import_chalk8.default.cyan("viberails.config.json")} and adjust rules`);
-  console.log(
-    `  2. Commit ${import_chalk8.default.cyan("viberails.config.json")} and ${import_chalk8.default.cyan(".viberails/context.md")}`
-  );
-  console.log(`  3. Run ${import_chalk8.default.cyan("viberails check")} to verify your project passes`);
+${import_chalk9.default.bold("Next steps:")}`);
+  console.log(`  1. Review ${import_chalk9.default.cyan("viberails.config.json")} and adjust rules`);
+  console.log(`  2. Commit ${filesToCommit.join(", ")}`);
+  console.log(`  3. Run ${import_chalk9.default.cyan("viberails check")} to verify your project passes`);
 }
 function updateGitignore(projectRoot) {
   const gitignorePath = path13.join(projectRoot, ".gitignore");
@@ -1374,8 +1512,9 @@ function updateGitignore(projectRoot) {
   }
   if (!content.includes(".viberails/scan-result.json")) {
     const block = "\n# viberails\n.viberails/scan-result.json\n";
-    fs12.writeFileSync(gitignorePath, `${content.trimEnd()}
-${block}`);
+    const prefix = content.length === 0 ? "" : `${content.trimEnd()}
+`;
+    fs12.writeFileSync(gitignorePath, `${prefix}${block}`);
   }
 }
 
@@ -1384,7 +1523,7 @@ var fs13 = __toESM(require("fs"), 1);
 var path14 = __toESM(require("path"), 1);
 var import_config5 = require("@viberails/config");
 var import_scanner2 = require("@viberails/scanner");
-var import_chalk9 = __toESM(require("chalk"), 1);
+var import_chalk10 = __toESM(require("chalk"), 1);
 var CONFIG_FILE5 = "viberails.config.json";
 async function syncCommand(cwd) {
   const startDir = cwd ?? process.cwd();
@@ -1396,21 +1535,33 @@ async function syncCommand(cwd) {
   }
   const configPath = path14.join(projectRoot, CONFIG_FILE5);
   const existing = await (0, import_config5.loadConfig)(configPath);
-  console.log(import_chalk9.default.dim("Scanning project..."));
+  console.log(import_chalk10.default.dim("Scanning project..."));
   const scanResult = await (0, import_scanner2.scan)(projectRoot);
   const merged = (0, import_config5.mergeConfig)(existing, scanResult);
-  fs13.writeFileSync(configPath, `${JSON.stringify(merged, null, 2)}
+  const existingJson = JSON.stringify(existing, null, 2);
+  const mergedJson = JSON.stringify(merged, null, 2);
+  const configChanged = existingJson !== mergedJson;
+  if (configChanged) {
+    console.log(
+      `  ${import_chalk10.default.yellow("!")} Config updated \u2014 review ${import_chalk10.default.cyan(CONFIG_FILE5)} for changes`
+    );
+  }
+  fs13.writeFileSync(configPath, `${mergedJson}
 `);
   writeGeneratedFiles(projectRoot, merged, scanResult);
   console.log(`
-${import_chalk9.default.bold("Synced:")}`);
-  console.log(`  ${import_chalk9.default.green("\u2713")} ${CONFIG_FILE5} \u2014 updated`);
-  console.log(`  ${import_chalk9.default.green("\u2713")} .viberails/context.md \u2014 regenerated`);
-  console.log(`  ${import_chalk9.default.green("\u2713")} .viberails/scan-result.json \u2014 updated`);
+${import_chalk10.default.bold("Synced:")}`);
+  if (configChanged) {
+    console.log(`  ${import_chalk10.default.yellow("!")} ${CONFIG_FILE5} \u2014 updated (review changes)`);
+  } else {
+    console.log(`  ${import_chalk10.default.green("\u2713")} ${CONFIG_FILE5} \u2014 unchanged`);
+  }
+  console.log(`  ${import_chalk10.default.green("\u2713")} .viberails/context.md \u2014 regenerated`);
+  console.log(`  ${import_chalk10.default.green("\u2713")} .viberails/scan-result.json \u2014 updated`);
 }
 
 // src/index.ts
-var VERSION = "0.2.3";
+var VERSION = "0.3.1";
 var program = new import_commander.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) => {
@@ -1418,7 +1569,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(`${import_chalk10.default.red("Error:")} ${message}`);
+    console.error(`${import_chalk11.default.red("Error:")} ${message}`);
     process.exit(1);
   }
 });
@@ -1427,21 +1578,22 @@ 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(`${import_chalk10.default.red("Error:")} ${message}`);
+    console.error(`${import_chalk11.default.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(
+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).option("--format <format>", "Output format: text (default) or json").action(
   async (options) => {
     try {
       const exitCode = await checkCommand({
         ...options,
-        noBoundaries: options.boundaries === false
+        noBoundaries: options.boundaries === false,
+        format: options.format === "json" ? "json" : "text"
       });
       process.exit(exitCode);
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      console.error(`${import_chalk10.default.red("Error:")} ${message}`);
+      console.error(`${import_chalk11.default.red("Error:")} ${message}`);
       process.exit(1);
     }
   }
@@ -1452,7 +1604,7 @@ program.command("fix").description("Auto-fix file naming violations and generate
     process.exit(exitCode);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    console.error(`${import_chalk10.default.red("Error:")} ${message}`);
+    console.error(`${import_chalk11.default.red("Error:")} ${message}`);
     process.exit(1);
   }
 });
@@ -1461,7 +1613,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(`${import_chalk10.default.red("Error:")} ${message}`);
+    console.error(`${import_chalk11.default.red("Error:")} ${message}`);
     process.exit(1);
   }
 });