viberails 0.3.2 → 0.3.3

package/dist/index.js

@@ -116,15 +116,21 @@ async function promptIntegrations(hookManager) {
         value: "claude",
         label: "Claude Code hook",
         hint: "checks files when Claude edits them"
+      },
+      {
+        value: "claudeMd",
+        label: "CLAUDE.md reference",
+        hint: "appends @.viberails/context.md so Claude loads rules automatically"
       }
     ],
-    initialValues: ["preCommit", "claude"],
+    initialValues: ["preCommit", "claude", "claudeMd"],
     required: false
   });
   assertNotCancelled(result);
   return {
     preCommitHook: result.includes("preCommit"),
-    claudeCodeHook: result.includes("claude")
+    claudeCodeHook: result.includes("claude"),
+    claudeMdRef: result.includes("claudeMd")
   };
 }
 
@@ -182,22 +188,21 @@ async function boundariesCommand(options, cwd) {
   displayRules(config);
 }
 function displayRules(config) {
-  if (!config.boundaries || config.boundaries.length === 0) {
+  if (!config.boundaries || Object.keys(config.boundaries.deny).length === 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);
+  const { deny } = config.boundaries;
+  const sources = Object.keys(deny).filter((k) => deny[k].length > 0);
+  const totalRules = sources.reduce((sum, k) => sum + deny[k].length, 0);
   console.log(`
-${chalk.bold(`Boundary rules (${config.boundaries.length} rules):`)}
+${chalk.bold(`Boundary rules (${totalRules} deny 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}`);
+  for (const source of sources) {
+    for (const target of deny[source]) {
+      console.log(`  ${chalk.red("\u2717")} ${source} \u2192 ${target}`);
+    }
   }
   console.log(
     `
@@ -214,24 +219,22 @@ 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 sources = Object.keys(inferred.deny).filter((k) => inferred.deny[k].length > 0);
+  const totalRules = sources.reduce((sum, k) => sum + inferred.deny[k].length, 0);
+  if (totalRules === 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);
   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 source of sources) {
+    for (const target of inferred.deny[source]) {
+      console.log(`  ${chalk.red("\u2717")} ${source} \u2192 ${target}`);
+    }
   }
   console.log(`
-  ${allow.length} allowed, ${deny.length} denied`);
+  ${totalRules} denied`);
   console.log("");
   const shouldSave = await confirm2("Save to viberails.config.json?");
   if (shouldSave) {
@@ -239,7 +242,7 @@ ${chalk.bold("Inferred boundary rules:")}
     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) {
@@ -598,7 +601,7 @@ 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) {
+  if (config.rules.enforceBoundaries && config.boundaries && Object.keys(config.boundaries.deny).length > 0 && !options.noBoundaries) {
     const startTime = Date.now();
     const { buildImportGraph, checkBoundaries } = await import("@viberails/graph");
     const packages = config.workspace ? resolveWorkspacePackages(projectRoot, config.workspace) : void 0;
@@ -614,7 +617,7 @@ async function checkCommand(options, cwd) {
       violations.push({
         file: relFile,
         rule: "boundary-violation",
-        message: `Imports "${bv.specifier}" violating boundary: ${bv.rule.from} \u2192 ${bv.rule.to}${bv.rule.reason ? ` (${bv.rule.reason})` : ""}`,
+        message: `Imports "${bv.specifier}" violating boundary: ${bv.rule.from} \u2192 ${bv.rule.to}`,
         severity
       });
     }
@@ -1009,9 +1012,14 @@ 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, ORM_NAMES, STYLING_NAMES as STYLING_NAMES2 } from "@viberails/types";
-import chalk6 from "chalk";
+// src/display-text.ts
+import {
+  CONVENTION_LABELS as CONVENTION_LABELS2,
+  FRAMEWORK_NAMES as FRAMEWORK_NAMES3,
+  LIBRARY_NAMES as LIBRARY_NAMES2,
+  ORM_NAMES as ORM_NAMES2,
+  STYLING_NAMES as STYLING_NAMES3
+} from "@viberails/types";
 
 // src/display-helpers.ts
 import { ROLE_DESCRIPTIONS } from "@viberails/types";
@@ -1062,6 +1070,16 @@ function formatRoleGroup(group) {
   return `${group.label} \u2014 ${dirs} (${files})`;
 }
 
+// src/display.ts
+import {
+  CONVENTION_LABELS,
+  FRAMEWORK_NAMES as FRAMEWORK_NAMES2,
+  LIBRARY_NAMES,
+  ORM_NAMES,
+  STYLING_NAMES as STYLING_NAMES2
+} from "@viberails/types";
+import chalk6 from "chalk";
+
 // src/display-monorepo.ts
 import { FRAMEWORK_NAMES, STYLING_NAMES } from "@viberails/types";
 import chalk5 from "chalk";
@@ -1171,12 +1189,6 @@ function formatMonorepoResultsText(scanResult, config) {
 }
 
 // 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;
@@ -1312,6 +1324,11 @@ function displayRulesPreview(config) {
   }
   console.log("");
 }
+
+// src/display-text.ts
+function getConventionStr2(cv) {
+  return typeof cv === "string" ? cv : cv.value;
+}
 function plainConfidenceLabel(convention) {
   const pct = Math.round(convention.consistency);
   if (convention.confidence === "high") {
@@ -1327,7 +1344,7 @@ function formatConventionsText(scanResult) {
   lines.push("Conventions:");
   for (const [key, convention] of conventionEntries) {
     if (convention.confidence === "low") continue;
-    const label = CONVENTION_LABELS[key] ?? key;
+    const label = CONVENTION_LABELS2[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);
@@ -1361,7 +1378,7 @@ function formatRulesText(config) {
     lines.push("  \u2022 Require test files: no");
   }
   if (config.rules.enforceNaming && config.conventions.fileNaming) {
-    lines.push(`  \u2022 Enforce file naming: ${getConventionStr(config.conventions.fileNaming)}`);
+    lines.push(`  \u2022 Enforce file naming: ${getConventionStr2(config.conventions.fileNaming)}`);
   } else {
     lines.push("  \u2022 Enforce file naming: no");
   }
@@ -1376,17 +1393,17 @@ function formatScanResultsText(scanResult, config) {
   const { stack } = scanResult;
   lines.push("Detected:");
   if (stack.framework) {
-    lines.push(`  \u2713 ${formatItem(stack.framework, FRAMEWORK_NAMES2)}`);
+    lines.push(`  \u2713 ${formatItem(stack.framework, FRAMEWORK_NAMES3)}`);
   }
   lines.push(`  \u2713 ${formatItem(stack.language)}`);
   if (stack.styling) {
-    lines.push(`  \u2713 ${formatItem(stack.styling, STYLING_NAMES2)}`);
+    lines.push(`  \u2713 ${formatItem(stack.styling, STYLING_NAMES3)}`);
   }
   if (stack.backend) {
-    lines.push(`  \u2713 ${formatItem(stack.backend, FRAMEWORK_NAMES2)}`);
+    lines.push(`  \u2713 ${formatItem(stack.backend, FRAMEWORK_NAMES3)}`);
   }
   if (stack.orm) {
-    lines.push(`  \u2713 ${formatItem(stack.orm, ORM_NAMES)}`);
+    lines.push(`  \u2713 ${formatItem(stack.orm, ORM_NAMES2)}`);
   }
   const secondaryParts = [];
   if (stack.packageManager) secondaryParts.push(formatItem(stack.packageManager));
@@ -1398,7 +1415,7 @@ function formatScanResultsText(scanResult, config) {
   }
   if (stack.libraries.length > 0) {
     for (const lib of stack.libraries) {
-      lines.push(`  \u2713 ${formatItem(lib, LIBRARY_NAMES)}`);
+      lines.push(`  \u2713 ${formatItem(lib, LIBRARY_NAMES2)}`);
     }
   }
   const groups = groupByRole(scanResult.structure.directories);
@@ -1550,7 +1567,17 @@ function setupClaudeCodeHook(projectRoot) {
   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`;
+  const checkAndReport = [
+    `FILE=$(${extractFile})`,
+    'if [ -z "$FILE" ]; then exit 0; fi',
+    'OUTPUT=$(npx viberails check --files "$FILE" --format json 2>&1)',
+    `if echo "$OUTPUT" | node -e "process.exit(JSON.parse(require('fs').readFileSync(0,'utf8')).violations?.length?0:1)" 2>/dev/null; then`,
+    '  echo "$OUTPUT" >&2',
+    "  exit 2",
+    "fi",
+    "exit 0"
+  ].join("\n");
+  const hookCommand = checkAndReport;
   hooks.PostToolUse = [
     ...existing,
     {
@@ -1568,6 +1595,18 @@ function setupClaudeCodeHook(projectRoot) {
 `);
   console.log(`  ${chalk7.green("\u2713")} .claude/settings.json \u2014 added viberails PostToolUse hook`);
 }
+function setupClaudeMdReference(projectRoot) {
+  const claudeMdPath = path12.join(projectRoot, "CLAUDE.md");
+  let content = "";
+  if (fs11.existsSync(claudeMdPath)) {
+    content = fs11.readFileSync(claudeMdPath, "utf-8");
+  }
+  if (content.includes("@.viberails/context.md")) return;
+  const ref = "\n@.viberails/context.md\n";
+  const prefix = content.length === 0 ? "" : content.trimEnd();
+  fs11.writeFileSync(claudeMdPath, prefix + ref);
+  console.log(`  ${chalk7.green("\u2713")} CLAUDE.md \u2014 added @.viberails/context.md reference`);
+}
 function writeHuskyPreCommit(huskyDir) {
   const hookPath = path12.join(huskyDir, "pre-commit");
   if (fs11.existsSync(hookPath)) {
@@ -1596,7 +1635,7 @@ function filterHighConfidence(conventions) {
   }
   return filtered;
 }
-function getConventionStr2(cv) {
+function getConventionStr3(cv) {
   if (!cv) return void 0;
   return typeof cv === "string" ? cv : cv.value;
 }
@@ -1613,10 +1652,10 @@ async function initCommand(options, cwd) {
     );
   }
   const configPath = path13.join(projectRoot, CONFIG_FILE4);
-  if (fs12.existsSync(configPath)) {
+  if (fs12.existsSync(configPath) && !options.force) {
     console.log(
       `${chalk8.yellow("!")} viberails is already initialized.
-  Run ${chalk8.cyan("viberails sync")} to update, or delete viberails.config.json to start fresh.`
+  Run ${chalk8.cyan("viberails sync")} to update, or ${chalk8.cyan("viberails init --force")} to start fresh.`
     );
     return;
   }
@@ -1636,16 +1675,18 @@ async function initCommand(options, cwd) {
         ignore: config2.ignore
       });
       const inferred = inferBoundaries(graph);
-      if (inferred.length > 0) {
+      const denyCount = Object.values(inferred.deny).reduce((sum, arr) => sum + arr.length, 0);
+      if (denyCount > 0) {
         config2.boundaries = inferred;
         config2.rules.enforceBoundaries = true;
-        console.log(`  Inferred ${inferred.length} boundary rules`);
+        console.log(`  Inferred ${denyCount} boundary rules`);
       }
     }
     fs12.writeFileSync(configPath, `${JSON.stringify(config2, null, 2)}
 `);
     writeGeneratedFiles(projectRoot, config2, scanResult2);
     updateGitignore(projectRoot);
+    setupClaudeMdReference(projectRoot);
     console.log(`
 Created:`);
     console.log(`  ${chalk8.green("\u2713")} ${CONFIG_FILE4}`);
@@ -1677,7 +1718,7 @@ Created:`);
       requireTests: config.rules.requireTests,
       enforceNaming: config.rules.enforceNaming,
       enforcement: config.enforcement,
-      fileNamingValue: getConventionStr2(config.conventions.fileNaming)
+      fileNamingValue: getConventionStr3(config.conventions.fileNaming)
     });
     config.rules.maxFileLines = overrides.maxFileLines;
     config.rules.requireTests = overrides.requireTests;
@@ -1706,10 +1747,11 @@ Created:`);
         ignore: config.ignore
       });
       const inferred = inferBoundaries(graph);
-      if (inferred.length > 0) {
+      const denyCount = Object.values(inferred.deny).reduce((sum, arr) => sum + arr.length, 0);
+      if (denyCount > 0) {
         config.boundaries = inferred;
         config.rules.enforceBoundaries = true;
-        bs.stop(`Inferred ${inferred.length} boundary rules`);
+        bs.stop(`Inferred ${denyCount} boundary rules`);
       } else {
         bs.stop("No boundary rules inferred");
       }
@@ -1743,6 +1785,10 @@ Created:`);
     setupClaudeCodeHook(projectRoot);
     createdFiles.push(".claude/settings.json \u2014 added viberails hook");
   }
+  if (integrations.claudeMdRef) {
+    setupClaudeMdReference(projectRoot);
+    createdFiles.push("CLAUDE.md \u2014 added @.viberails/context.md reference");
+  }
   clack2.log.success(`Created:
 ${createdFiles.map((f) => `  ${f}`).join("\n")}`);
   clack2.outro("Done! Next: review viberails.config.json, then run viberails check");
@@ -1767,7 +1813,145 @@ import * as path14 from "path";
 import { loadConfig as loadConfig4, mergeConfig } from "@viberails/config";
 import { scan as scan2 } from "@viberails/scanner";
 import chalk9 from "chalk";
+
+// src/utils/diff-configs.ts
+import { CONVENTION_LABELS as CONVENTION_LABELS3, FRAMEWORK_NAMES as FRAMEWORK_NAMES4, ORM_NAMES as ORM_NAMES3, STYLING_NAMES as STYLING_NAMES4 } from "@viberails/types";
+function parseStackString(s) {
+  const atIdx = s.indexOf("@");
+  if (atIdx > 0) {
+    return { name: s.slice(0, atIdx), version: s.slice(atIdx + 1) };
+  }
+  return { name: s };
+}
+function displayStackName(s) {
+  const { name, version } = parseStackString(s);
+  const allMaps = {
+    ...FRAMEWORK_NAMES4,
+    ...STYLING_NAMES4,
+    ...ORM_NAMES3
+  };
+  const display = allMaps[name] ?? name;
+  return version ? `${display} ${version}` : display;
+}
+function conventionStr(cv) {
+  return typeof cv === "string" ? cv : cv.value;
+}
+function isDetected(cv) {
+  return typeof cv !== "string" && cv._detected === true;
+}
+var STACK_FIELDS = [
+  "framework",
+  "styling",
+  "backend",
+  "orm",
+  "linter",
+  "formatter",
+  "testRunner"
+];
+var CONVENTION_KEYS = [
+  "fileNaming",
+  "componentNaming",
+  "hookNaming",
+  "importAlias"
+];
+var STRUCTURE_FIELDS = [
+  { key: "srcDir", label: "source directory" },
+  { key: "pages", label: "pages directory" },
+  { key: "components", label: "components directory" },
+  { key: "hooks", label: "hooks directory" },
+  { key: "utils", label: "utilities directory" },
+  { key: "types", label: "types directory" },
+  { key: "tests", label: "tests directory" },
+  { key: "testPattern", label: "test pattern" }
+];
+function diffConfigs(existing, merged) {
+  const changes = [];
+  for (const field of STACK_FIELDS) {
+    const oldVal = existing.stack[field];
+    const newVal = merged.stack[field];
+    if (!oldVal && newVal) {
+      changes.push({ type: "added", description: `Stack: added ${displayStackName(newVal)}` });
+    } else if (oldVal && newVal && oldVal !== newVal) {
+      changes.push({
+        type: "changed",
+        description: `Stack: ${displayStackName(oldVal)} \u2192 ${displayStackName(newVal)}`
+      });
+    }
+  }
+  for (const key of CONVENTION_KEYS) {
+    const oldVal = existing.conventions[key];
+    const newVal = merged.conventions[key];
+    const label = CONVENTION_LABELS3[key] ?? key;
+    if (!oldVal && newVal) {
+      changes.push({
+        type: "added",
+        description: `New convention: ${label} (${conventionStr(newVal)})`
+      });
+    } else if (oldVal && newVal && isDetected(newVal)) {
+      changes.push({
+        type: "changed",
+        description: `Convention updated: ${label} (${conventionStr(newVal)})`
+      });
+    }
+  }
+  for (const { key, label } of STRUCTURE_FIELDS) {
+    const oldVal = existing.structure[key];
+    const newVal = merged.structure[key];
+    if (!oldVal && newVal) {
+      changes.push({ type: "added", description: `Structure: detected ${label} (${newVal})` });
+    }
+  }
+  const existingPaths = new Set((existing.packages ?? []).map((p) => p.path));
+  for (const pkg of merged.packages ?? []) {
+    if (!existingPaths.has(pkg.path)) {
+      changes.push({ type: "added", description: `New package: ${pkg.path}` });
+    }
+  }
+  const existingWsPkgs = new Set(existing.workspace?.packages ?? []);
+  const mergedWsPkgs = new Set(merged.workspace?.packages ?? []);
+  for (const pkg of mergedWsPkgs) {
+    if (!existingWsPkgs.has(pkg)) {
+      changes.push({ type: "added", description: `Workspace: added ${pkg}` });
+    }
+  }
+  for (const pkg of existingWsPkgs) {
+    if (!mergedWsPkgs.has(pkg)) {
+      changes.push({ type: "removed", description: `Workspace: removed ${pkg}` });
+    }
+  }
+  return changes;
+}
+function formatStatsDelta(oldStats, newStats) {
+  const fileDelta = newStats.totalFiles - oldStats.totalFiles;
+  const lineDelta = newStats.totalLines - oldStats.totalLines;
+  if (fileDelta === 0 && lineDelta === 0) return void 0;
+  const parts = [];
+  if (fileDelta !== 0) {
+    const sign = fileDelta > 0 ? "+" : "";
+    parts.push(`${sign}${fileDelta.toLocaleString()} files`);
+  }
+  if (lineDelta !== 0) {
+    const sign = lineDelta > 0 ? "+" : "";
+    parts.push(`${sign}${lineDelta.toLocaleString()} lines`);
+  }
+  return `${parts.join(", ")} since last sync`;
+}
+
+// src/commands/sync.ts
 var CONFIG_FILE5 = "viberails.config.json";
+var SCAN_RESULT_FILE2 = ".viberails/scan-result.json";
+function loadPreviousStats(projectRoot) {
+  const scanResultPath = path14.join(projectRoot, SCAN_RESULT_FILE2);
+  try {
+    const raw = fs13.readFileSync(scanResultPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed?.statistics?.totalFiles !== void 0) {
+      return parsed.statistics;
+    }
+  } catch {
+  }
+  return void 0;
+}
 async function syncCommand(cwd) {
   const startDir = cwd ?? process.cwd();
   const projectRoot = findProjectRoot(startDir);
@@ -1778,16 +1962,25 @@ async function syncCommand(cwd) {
   }
   const configPath = path14.join(projectRoot, CONFIG_FILE5);
   const existing = await loadConfig4(configPath);
+  const previousStats = loadPreviousStats(projectRoot);
   console.log(chalk9.dim("Scanning project..."));
   const scanResult = await scan2(projectRoot);
   const merged = mergeConfig(existing, scanResult);
   const existingJson = JSON.stringify(existing, null, 2);
   const mergedJson = JSON.stringify(merged, null, 2);
   const configChanged = existingJson !== mergedJson;
-  if (configChanged) {
-    console.log(
-      `  ${chalk9.yellow("!")} Config updated \u2014 review ${chalk9.cyan(CONFIG_FILE5)} for changes`
-    );
+  const changes = configChanged ? diffConfigs(existing, merged) : [];
+  const statsDelta = previousStats ? formatStatsDelta(previousStats, scanResult.statistics) : void 0;
+  if (changes.length > 0 || statsDelta) {
+    console.log(`
+${chalk9.bold("Changes:")}`);
+    for (const change of changes) {
+      const icon = change.type === "removed" ? chalk9.red("-") : chalk9.green("+");
+      console.log(`  ${icon} ${change.description}`);
+    }
+    if (statsDelta) {
+      console.log(`  ${chalk9.dim(statsDelta)}`);
+    }
   }
   fs13.writeFileSync(configPath, `${mergedJson}
 `);
@@ -1804,10 +1997,10 @@ ${chalk9.bold("Synced:")}`);
 }
 
 // src/index.ts
-var VERSION = "0.3.2";
+var VERSION = "0.3.3";
 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) => {
+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)").option("-f, --force", "Re-initialize, replacing existing config").action(async (options) => {
   try {
     await initCommand(options);
   } catch (err) {