slopbrick 0.42.0 → 0.43.0

package/dist/index.js

@@ -19,7 +19,7 @@ var VERSION;
 var init_header = __esm({
   "src/types/_header.ts"() {
     "use strict";
-    VERSION = "0.42.0";
+    VERSION = "0.43.0";
   }
 });
 
@@ -321,8 +321,16 @@ var init_defaults = __esm({
           // rule definitions are meta-code
           "**/snippet/**",
           // RULE_HINTS examples are intentional bad code
-          "**/tests/**"
+          "**/tests/**",
           // all test files (fixtures + unit + integration)
+          // v0.42.0 (post-self-scan cleanup): language visitors are
+          // intentional clones — see the §3 v0.42.0 release notes for
+          // the design rationale. `dup/identical-block` fires 100+
+          // times during self-scan because each visitor shares the
+          // same service-suffix arrays and import-walking preamble.
+          // Suppress these from the self-scan noise floor; they
+          // remain on for user codebases.
+          "**/src/engine/visitors/**"
         ]
       }
     };
@@ -25984,7 +25992,7 @@ var init_comment_ratio = __esm({
             message: `Comment-line ratio is ${direction} (${ratio.toFixed(2)} vs corpus mean ${mean3}). Reductive LLMs (GPT-3.5, Claude 3 Haiku) skip comments; expansive LLMs (Claude Haiku 4.5, GPT-OSS) over-comment when prompted for "well-commented code".`,
             line: 1,
             column: 1,
-            advice: direction === "low" ? "Add doc comments explaining intent (not just restating the next line) for non-obvious logic." : "Trim comments that just restate the next line. Keep comments that explain WHY, not WHAT."
+            advice: direction === "low" ? "Add doc comments explaining intent (not just restating the next line) for non-obvious logic." : "High comment ratio \u2014 consider whether the comments are intentional (api docs, type defs, tutorials). For functional code, trim comments that just restate the next line. Keep comments that explain WHY, not WHAT."
           }
         ];
         return issues;
@@ -26834,7 +26842,6 @@ function buildTrigramLM(samples, alpha = 1) {
     logProb(context, t) {
       const ctxKey = context.slice(-2).join("|");
       const triKey = `${ctxKey}|${t}`;
-      const biKey = context.slice(-1).join("|") + "|" + t;
       const triCount = tri.get(triKey) ?? 0;
       const biCount = bi.get(ctxKey) ?? 0;
       const V = uni.size;
@@ -28842,7 +28849,7 @@ var init_stale_function_reference = __esm({
     ]);
     SOURCE_EXTS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
     SOURCE_ROOTS = ["src", "lib", "app", "components"];
-    CAP = 200;
+    CAP = 4e3;
     staleFunctionReferenceRule = createRule({
       id: "docs/stale-function-reference",
       category: "docs",
@@ -28858,6 +28865,7 @@ var init_stale_function_reference = __esm({
         if (!source) return issues;
         for (const span of extractInlineCodeSpans(source)) {
           const text = span.text;
+          if (span.inBlockComment || span.inComment) continue;
           if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(text)) continue;
           if (text.length < 3) continue;
           if (RESERVED.has(text.toLowerCase())) continue;
@@ -29028,6 +29036,7 @@ var init_stale_package_reference = __esm({
         if (!source) return issues;
         const spans = extractInlineCodeSpans(source);
         for (const span of spans) {
+          if (span.inComment) continue;
           const lineStart = source.lastIndexOf("\n", span.index) + 1;
           const lineEnd = source.indexOf("\n", span.index);
           const line = source.slice(lineStart, lineEnd === -1 ? source.length : lineEnd);
@@ -29082,7 +29091,8 @@ __export(doc_freshness_exports, {
   extractExports: () => extractExports,
   extractFencedCodeBlocks: () => extractFencedCodeBlocks,
   extractInlineCodeSpans: () => extractInlineCodeSpans,
-  extractMarkdownLinks: () => extractMarkdownLinks
+  extractMarkdownLinks: () => extractMarkdownLinks,
+  findCommentLineRanges: () => findCommentLineRanges
 });
 import { readFileSync as readFileSync6, existsSync as existsSync5 } from "fs";
 import { join as join6, dirname as dirname2, relative } from "path";
@@ -29090,6 +29100,8 @@ import { globby } from "globby";
 function extractInlineCodeSpans(source) {
   const hits = [];
   const re = /`([^`\n]+?)`/g;
+  const blockRanges = findBlockCommentRanges(source);
+  const commentLines = findCommentLineRanges(source);
   let m;
   while ((m = re.exec(source)) !== null) {
     const text = m[1] ?? "";
@@ -29097,7 +29109,14 @@ function extractInlineCodeSpans(source) {
     const line = upTo.split("\n").length;
     const lastNl = upTo.lastIndexOf("\n");
     const column = lastNl === -1 ? m.index + 1 : m.index - lastNl;
-    hits.push({ text, line, column, index: m.index });
+    hits.push({
+      text,
+      line,
+      column,
+      index: m.index,
+      inBlockComment: isInBlockComment(blockRanges, m.index),
+      inComment: commentLines.has(line)
+    });
   }
   return hits;
 }
@@ -29136,6 +29155,8 @@ function extractFencedCodeBlocks(source) {
 function extractMarkdownLinks(source) {
   const hits = [];
   const re = /(?<!\!)\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g;
+  const blockRanges = findBlockCommentRanges(source);
+  const commentLines = findCommentLineRanges(source);
   let m;
   while ((m = re.exec(source)) !== null) {
     const target = m[2] ?? "";
@@ -29143,10 +29164,55 @@ function extractMarkdownLinks(source) {
     const line = upTo.split("\n").length;
     const lastNl = upTo.lastIndexOf("\n");
     const column = lastNl === -1 ? m.index + 1 : m.index - lastNl;
-    hits.push({ target, line, column });
+    hits.push({
+      target,
+      line,
+      column,
+      index: m.index,
+      inBlockComment: isInBlockComment(blockRanges, m.index),
+      inComment: commentLines.has(line)
+    });
   }
   return hits;
 }
+function findBlockCommentRanges(source) {
+  const ranges = [];
+  const stack = [];
+  let i = 0;
+  while (i < source.length) {
+    if (source[i] === "/" && source[i + 1] === "/") {
+      const eol = source.indexOf("\n", i);
+      i = eol === -1 ? source.length : eol + 1;
+      continue;
+    }
+    if (source[i] === "/" && source[i + 1] === "*") {
+      stack.push(i);
+      i += 2;
+      continue;
+    }
+    if (source[i] === "*" && source[i + 1] === "/" && stack.length > 0) {
+      const start = stack.pop();
+      ranges.push([start, i + 2]);
+      i += 2;
+      continue;
+    }
+    i += 1;
+  }
+  ranges.sort((a, b) => a[0] - b[0]);
+  return ranges;
+}
+function isInBlockComment(ranges, pos) {
+  let lo = 0;
+  let hi = ranges.length - 1;
+  while (lo <= hi) {
+    const mid = lo + hi >>> 1;
+    const [start, end] = ranges[mid];
+    if (pos < start) hi = mid - 1;
+    else if (pos >= end) lo = mid + 1;
+    else return true;
+  }
+  return false;
+}
 function declaredPackages(cwd) {
   const out = /* @__PURE__ */ new Set();
   const pkgPath = join6(cwd, "package.json");
@@ -29301,6 +29367,58 @@ function docDriftFromFreshness(score) {
   if (score >= DOC_FRESHNESS_THRESHOLDS.high) return "high";
   return "critical";
 }
+function findCommentLineRanges(source) {
+  const out = /* @__PURE__ */ new Set();
+  const stack = [];
+  let inLineComment = false;
+  const lines = source.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineNo = i + 1;
+    let j = 0;
+    while (j < line.length) {
+      const c = line[j];
+      const next = line[j + 1];
+      if (!stack.length && c === "/" && next === "/") {
+        inLineComment = true;
+        out.add(lineNo);
+        break;
+      }
+      if (c === "/" && next === "*") {
+        stack.push(lineNo);
+        out.add(lineNo);
+        j += 2;
+        continue;
+      }
+      if (c === "*" && next === "/" && stack.length > 0) {
+        stack.pop();
+        j += 2;
+        continue;
+      }
+      if (c === '"' || c === "'" || c === "`") {
+        const quote = c;
+        j += 1;
+        while (j < line.length) {
+          if (line[j] === "\\") {
+            j += 2;
+            continue;
+          }
+          if (line[j] === quote) {
+            j += 1;
+            break;
+          }
+          j += 1;
+        }
+        continue;
+      }
+      j += 1;
+    }
+    if (stack.length > 0) {
+      out.add(lineNo);
+    }
+  }
+  return out;
+}
 var DOC_RULE_WEIGHTS, DOC_FRESHNESS_THRESHOLDS;
 var init_doc_freshness = __esm({
   "src/engine/doc-freshness.ts"() {
@@ -29324,6 +29442,9 @@ var init_doc_freshness = __esm({
 // src/rules/docs/broken-link.ts
 import { existsSync as existsSync6 } from "fs";
 import { dirname as dirname3, join as join7, resolve as resolve4 } from "path";
+function looksLikeRegexSyntax(target) {
+  return /\[[^\]]*\]/.test(target) || /^\s*[?:=!]/.test(target) || /\\(?:s|d|w|S|D|W|t|n|r|[^\\])/.test(target) || /[{}|]/.test(target);
+}
 var brokenLinkRule;
 var init_broken_link = __esm({
   "src/rules/docs/broken-link.ts"() {
@@ -29352,6 +29473,8 @@ var init_broken_link = __esm({
           if (target.startsWith("#")) continue;
           if (target.startsWith("//")) continue;
           if (target.startsWith("/")) continue;
+          if (link.inBlockComment) continue;
+          if (looksLikeRegexSyntax(target)) continue;
           const filePart = target.split("#")[0] ?? target;
           if (filePart === "") continue;
           const resolved = join7(docDir, filePart);
@@ -38526,6 +38649,29 @@ var init_stringly_typed = __esm({
   }
 });
 
+// src/engine/parser-shared.ts
+function parseTreeSitterSource(parserResult, source) {
+  if (!parserResult.ok) return null;
+  if (!source || source.trim() === "") return null;
+  try {
+    const rawTree = parserResult.parser.parse(source);
+    if (!rawTree) return null;
+    const tree = rawTree;
+    if (!tree || !tree.rootNode) return null;
+    if (tree.rootNode.type === "ERROR" && tree.rootNode.childCount === 0) {
+      return null;
+    }
+    return tree;
+  } catch {
+    return null;
+  }
+}
+var init_parser_shared = __esm({
+  "src/engine/parser-shared.ts"() {
+    "use strict";
+  }
+});
+
 // src/engine/parser-rust.ts
 import Parser from "tree-sitter";
 import Rust from "tree-sitter-rust";
@@ -38551,21 +38697,7 @@ function effectiveParser() {
   return getRustParser();
 }
 function parseRust(source) {
-  const result = effectiveParser();
-  if (!result.ok) return null;
-  if (!source || source.trim() === "") return null;
-  try {
-    const rawTree = result.parser.parse(source);
-    if (!rawTree) return null;
-    const tree = rawTree;
-    if (!tree || !tree.rootNode) return null;
-    if (tree.rootNode.type === "ERROR" && tree.rootNode.childCount === 0) {
-      return null;
-    }
-    return tree;
-  } catch {
-    return null;
-  }
+  return parseTreeSitterSource(effectiveParser(), source);
 }
 function isRustParserAvailable() {
   const result = getRustParser();
@@ -38575,6 +38707,7 @@ var cachedParser, rustLanguage, loadError, forcedFailure;
 var init_parser_rust = __esm({
   "src/engine/parser-rust.ts"() {
     "use strict";
+    init_parser_shared();
     cachedParser = null;
     rustLanguage = null;
     loadError = null;
@@ -43682,8 +43815,6 @@ function mergeTemplateClassNames(filePath, source, facts, templateClassNames) {
 }
 function extractFacts(filePath, ast, source, supportsRsc = true, framework = "react", config) {
   const lineOffsets = buildLineOffsets2(source);
-  const isTypeScript = /\.tsx?$/i.test(filePath);
-  const NON_JSX_FRAMEWORKS = /* @__PURE__ */ new Set(["vue", "svelte", "astro"]);
   const facts = {
     filePath,
     components: [],
@@ -45622,7 +45753,7 @@ function formatDeltaSuffix(report) {
 }
 function formatVerdict(report) {
   const score = report.aiSlopScore;
-  const band = scoreBand(score);
+  const band = slopScoreBand(score);
   const ranked = rankByImpact(report.issues);
   const topRule = ranked[0];
   const topFile = report.topOffenders?.[0];
@@ -45705,7 +45836,8 @@ function formatNextStep(report) {
       `  \u2192 \`slopbrick scan --baseline\` to accept today's scores as the new floor`
     )
   );
-  if (report.aiSlopScore > 30) {
+  const meanSlop = report.thresholds?.meanSlop ?? 30;
+  if (report.aiSlopScore > meanSlop) {
     lines.push(
       chalk.dim(
         `  \u2192 \`slopbrick scan --why-failing\` for the top 5 issues dragging the score down`
@@ -45730,17 +45862,18 @@ function formatWhyFailing(report) {
     return chalk.green("Nothing is failing the threshold. Score is clean.");
   }
   const headline = report.aiSlopScore;
-  const status = headline <= 30 ? "PASS" : "FAIL";
-  const colorize = headline <= 30 ? chalk.green : chalk.red;
+  const meanSlop = report.thresholds?.meanSlop ?? 30;
+  const status = headline <= meanSlop ? "PASS" : "FAIL";
+  const colorize = headline <= meanSlop ? chalk.green : chalk.red;
+  const qualifier = headline <= meanSlop ? `below ${meanSlop}` : `above ${meanSlop}`;
   const lines = [];
-  lines.push(colorize.bold(`Headline score: ${headline.toFixed(0)}/100 (${status} \u2014 above 30)`));
+  lines.push(colorize.bold(`Headline score: ${headline.toFixed(0)}/100 (${status} \u2014 ${qualifier})`));
   lines.push("");
   lines.push(chalk.bold("Top 5 rules dragging the score down:"));
   for (let i = 0; i < ranked.length; i++) {
     const [ruleId, info] = ranked[i];
     const fileCount = info.files.size;
     const fileHint = fileCount > 0 ? ` across ${fileCount} file${fileCount === 1 ? "" : "s"}` : "";
-    const catShort = CATEGORY_GLOSSARY[info.count > 0 ? "" : ""]?.short;
     const sampleIssue = report.issues.find((i2) => i2.ruleId === ruleId);
     const cat = sampleIssue ? CATEGORY_GLOSSARY[sampleIssue.category]?.short : null;
     const catHint = cat ? chalk.dim(` [${cat}]`) : "";
@@ -45800,7 +45933,7 @@ function formatCompositeScore(report) {
     lines.push("");
     lines.push(
       chalk.dim(
-        `Repository Coherence: ${coherenceValue} / 100 [${cohBand.label.toUpperCase()}] \u2014 higher = better \xB7 measures internal consistency. This is a secondary view; the Slop Index above is the gate.`
+        `Repository Coherence: ${coherenceValue} / 100 [${cohBand.label.toUpperCase()}] \u2014 higher = better \xB7 measures internal consistency. This is a secondary view; the AI Slop Score above is the gate.`
       )
     );
   }
@@ -45930,13 +46063,12 @@ function formatDriftSection(report) {
   return lines.join("\n");
 }
 function formatThresholds(report) {
-  const limit = report.thresholds.meanSlop;
+  const meanSlop = report.thresholds?.meanSlop ?? 30;
   const headline = report.aiSlopScore;
-  const passed = headline >= 70;
-  const valueText = `${headline.toFixed(1)} \u2265 70`.padStart(12, " ");
+  const passed = headline <= meanSlop;
+  const valueText = `${headline.toFixed(1)} \u2264 ${meanSlop}`.padStart(12, " ");
   const status = passed ? chalk.green("pass") : chalk.red("fail");
   const result = ["Threshold (CI gate)", `  AI Slop Score  ${valueText}  ${status}`];
-  void limit;
   return result;
 }
 function formatTopComponents(components, topOffenders) {
@@ -46014,9 +46146,10 @@ function formatPretty(report) {
   }
   return sections.join("\n\n");
 }
-function formatScoringExplainer(_report) {
+function formatScoringExplainer(report) {
+  const meanSlop = report.thresholds?.meanSlop ?? 30;
   return chalk.dim(
-    "Four orthogonal scores (all 0-100, higher = better): AI Slop Score (AI-slop signatures; the CI gate, AI Slop Score >= 70), Engineering Hygiene (issues per category across arch/logic/layout/component/test), Security (AI-flagged security risks, inverted from risk level), Repository Health (composite: 0.4*AI Slop Score + 0.3*Engineering Hygiene + 0.2*Security + 0.1*Test Quality). Only AI Slop Score gates CI; the others are informational. Default-off rules (INVERTED/NOISY/DORMANT) are suppressed from the scores automatically."
+    `Four orthogonal scores (all 0-100, **lower AI Slop Score = cleaner**): AI Slop Score (AI-slop signatures; the CI gate, AI Slop Score \u2264 ${meanSlop} passes), Engineering Hygiene (issues per category across arch/logic/layout/component/test; higher = cleaner), Security (AI-flagged security risks, inverted from risk level; higher = cleaner), Repository Health (composite: 0.4*AI Slop Score + 0.3*Engineering Hygiene + 0.2*Security + 0.1*Test Quality). Only AI Slop Score gates CI; the others are informational. Default-off rules (INVERTED/NOISY/DORMANT) are suppressed from the scores automatically.`
   );
 }
 function formatWhyFailingReport(report) {
@@ -46034,7 +46167,7 @@ function formatBriefReport(report) {
   ];
   const deltaSuffix = formatDeltaSuffix(report);
   scoreLines.forEach(({ label, field, value }, idx) => {
-    const band = scoreBand(value);
+    const band = field === "aiSlopScore" ? slopScoreBand(value) : scoreBand(value);
     const paddedLabel = label.padEnd(20, " ");
     const valueStr = value.toFixed(0).padStart(3, " ");
     const delta = idx === 0 ? deltaSuffix : "";
@@ -46042,11 +46175,12 @@ function formatBriefReport(report) {
       `  ${paddedLabel} ${band.color(valueStr)}   ${chalk.dim(band.label)}  ${chalk.dim.italic(`(${field})`)}${delta}`
     );
   });
-  const passed = report.aiSlopScore <= 30;
+  const meanSlop = report.thresholds?.meanSlop ?? 30;
+  const passed = report.aiSlopScore <= meanSlop;
   lines.push("");
   lines.push(
     chalk.dim(
-      `  CI gate: AI Slop Score <= 30 -> ${passed ? chalk.green("pass") : chalk.red("fail")}`
+      `  CI gate: AI Slop Score <= ${meanSlop} -> ${passed ? chalk.green("pass") : chalk.red("fail")}`
     )
   );
   const suppressed = report.defaultOffSuppressedCount ?? 0;
@@ -46192,19 +46326,22 @@ function thresholdExceeded(report, config) {
   return categoryThresholdBreached(report, config.thresholds.categoryThresholds);
 }
 function failedThresholdCount(report, config) {
-  let count = 0;
-  if (report.aiSlopScore > config.thresholds.meanSlop) count += 1;
-  if (report.p90Score > config.thresholds.p90Slop) count += 1;
-  if (report.peakScore > config.thresholds.individualSlopThreshold) count += 1;
+  return failedThresholds(report, config).length;
+}
+function failedThresholds(report, config) {
+  const failed = [];
+  if (report.aiSlopScore > config.thresholds.meanSlop) failed.push("meanSlop");
+  if (report.p90Score > config.thresholds.p90Slop) failed.push("p90Slop");
+  if (report.peakScore > config.thresholds.individualSlopThreshold) failed.push("individualSlopThreshold");
   const cat = config.thresholds.categoryThresholds;
   if (cat) {
     for (const [category, limit] of Object.entries(cat)) {
       if (limit === void 0) continue;
       const score = report.categoryScores[category];
-      if (score !== void 0 && score > limit) count += 1;
+      if (score !== void 0 && score > limit) failed.push(`category:${category}`);
     }
   }
-  return count;
+  return failed;
 }
 function categoryThresholdBreached(report, categoryThresholds) {
   if (!categoryThresholds) return false;
@@ -50870,9 +51007,22 @@ function computeFlywheelOutput(runs, currentTopFiles, recentTopHashes, unmatched
     }
   }
   if (currentTopFiles.length > 0 && runs.length >= CONSECUTIVE_THRESHOLD) {
+    const latestRun = runs[runs.length - 1];
+    const isNoiseTier = (id) => {
+      const rule = ruleById.get(id);
+      if (!rule) return false;
+      if (rule.defaultOff === true) return true;
+      if (rule.aiSpecific && (rule.severity === "medium" || rule.severity === "low")) return true;
+      return false;
+    };
+    const onRulesInLatestTop = latestRun.topOffenseIds.filter(
+      (id) => !isNoiseTier(id)
+    );
+    const skipChronicOnDefaultOffNoise = onRulesInLatestTop.length === 0;
     for (const file of currentTopFiles) {
       const consecutive = countConsecutiveTopFileAppearances(file.hash, recentTopHashes);
       if (consecutive >= CONSECUTIVE_THRESHOLD) {
+        if (skipChronicOnDefaultOffNoise) continue;
         hotspotIssues.push({
           ruleId: "component/chronic-offender",
           category: "component",
@@ -50882,7 +51032,7 @@ function computeFlywheelOutput(runs, currentTopFiles, recentTopHashes, unmatched
           filePath: file.filePath,
           line: 1,
           column: 1,
-          advice: "Prioritize refactoring this file or add it to the baseline."
+          advice: "Run `slopbrick scan --baseline` to accept current scores as the new floor, or refactor the file to reduce its issue count."
         });
       }
     }
@@ -51570,14 +51720,14 @@ var init_tokens = __esm({
 
 // src/cli/memory-io.ts
 import { readFile as readFile3, writeFile as writeFile2, mkdir as mkdir2, access as access2 } from "fs/promises";
-import { dirname as dirname10 } from "path";
+import { dirname as dirname9 } from "path";
 var fsMemoryIO;
 var init_memory_io = __esm({
   "src/cli/memory-io.ts"() {
     "use strict";
     fsMemoryIO = {
       read: (path) => readFile3(path, "utf-8").catch(() => null),
-      write: (path, content) => mkdir2(dirname10(path), { recursive: true }).then(
+      write: (path, content) => mkdir2(dirname9(path), { recursive: true }).then(
         () => writeFile2(path, content, "utf-8")
       ),
       exists: (path) => access2(path).then(
@@ -53213,16 +53363,16 @@ function axisSlopIndex(slopIndex) {
   if (slopIndex === void 0 || Number.isNaN(slopIndex)) {
     return {
       axis: "slopIndex",
-      label: "Slop Index",
+      label: "AI Slop Score (raw)",
       health: 70,
       source: "default (not measured) \u2014 neutral 70"
     };
   }
   return {
     axis: "slopIndex",
-    label: "Slop Index",
+    label: "AI Slop Score (raw)",
     health: clamp100(100 - slopIndex),
-    source: `100 - slopIndex (${slopIndex.toFixed(1)}) \u2192 inverted`
+    source: `100 - aiSlopScore (${slopIndex.toFixed(1)}) \u2192 inverted to cleanliness`
   };
 }
 function axisArchitecture(architectureConsistency) {
@@ -54169,6 +54319,16 @@ function assembleScanReport(input) {
     enrichment
   } = input;
   const prSlopScore = computePrSlopScore(diffRef, allIssues);
+  const thresholdReport = {
+    aiSlopScore: aggregated.aiSlopScore,
+    p90Score: aggregated.p90Score,
+    peakScore: aggregated.peakScore,
+    categoryScores: aggregated.categoryScores
+  };
+  const failedThresholds_ = failedThresholds(
+    thresholdReport,
+    config
+  );
   return {
     version: VERSION,
     generatedAt,
@@ -54224,6 +54384,11 @@ function assembleScanReport(input) {
     parseErrors: parseErrors.length > 0 ? parseErrors : void 0,
     baseline: baselineMeta,
     thresholds: config.thresholds,
+    // v0.42.0 (user-review fix): expose which gates tripped so CI
+    // consumers can read the JSON output instead of grepping stderr.
+    // Optional field: absent when no thresholds tripped. Computed from
+    // the report's own scores so the JSON is self-describing.
+    failedThresholds: failedThresholds_,
     topOffenders: topOffenders.length > 0 ? topOffenders : void 0,
     coherence: enrichment.coherence,
     coherenceBreakdown: enrichment.coherenceBreakdown,
@@ -54240,6 +54405,7 @@ var PR_SLOP_WEIGHTS;
 var init_assembleScanReport = __esm({
   "src/cli/report/assembleScanReport.ts"() {
     "use strict";
+    init_threshold();
     init_types();
     PR_SLOP_WEIGHTS = { high: 10, medium: 5, low: 1 };
   }
@@ -54257,7 +54423,7 @@ import {
   statSync as statSync5
 } from "fs";
 import { createHash as createHash10 } from "crypto";
-import { dirname as dirname11, join as join17, relative as relative9 } from "path";
+import { dirname as dirname10, join as join17, relative as relative9 } from "path";
 function telemetryPath2(cwd) {
   return join17(cwd, TELEMETRY_DIR, TELEMETRY_FILE2);
 }
@@ -54334,7 +54500,7 @@ function rotateTelemetry(cwd) {
   if (stats.size < MAX_TELEMETRY_BYTES) {
     return;
   }
-  const dir = dirname11(path);
+  const dir = dirname10(path);
   const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   renameSync3(path, join17(dir, `scans-${timestamp}.jsonl`));
   const rotated = readdirSync5(dir).filter(isTelemetryFile).map((name) => ({ name, mtime: statSync5(join17(dir, name)).mtimeMs })).sort((a, b) => a.mtime - b.mtime);
@@ -54396,7 +54562,7 @@ function recordTelemetry(cwd, report, results, config, inventory) {
     ...inventory ? { inventory: buildInventorySummary(inventory) } : {}
   };
   const path = telemetryPath2(cwd);
-  const dir = dirname11(path);
+  const dir = dirname10(path);
   if (!existsSync15(dir)) {
     mkdirSync5(dir, { recursive: true });
   }
@@ -54424,7 +54590,7 @@ __export(structure_md_exports, {
   writeStructureMarkdown: () => writeStructureMarkdown
 });
 import { existsSync as existsSync16, mkdirSync as mkdirSync6, readFileSync as readFileSync20, writeFileSync as writeFileSync6 } from "fs";
-import { dirname as dirname12, join as join18 } from "path";
+import { dirname as dirname11, join as join18 } from "path";
 function formatDuration(ms) {
   if (!Number.isFinite(ms) || ms < 0) return "unknown";
   if (ms < 1e3) return `${Math.round(ms)}ms`;
@@ -54568,7 +54734,7 @@ async function writeStructureMarkdown(workspaceDir, md) {
   await new Promise((resolve43, reject) => {
     try {
       const path = join18(workspaceDir, STRUCTURE_MD_FILE);
-      mkdirSync6(dirname12(path), { recursive: true });
+      mkdirSync6(dirname11(path), { recursive: true });
       writeFileSync6(path, md, "utf-8");
       resolve43();
     } catch (err) {
@@ -55739,11 +55905,13 @@ function extractNamedScores(report) {
   };
 }
 function renderThresholds(report) {
-  const r = report;
-  const score = typeof r.repositoryHealth === "number" ? r.repositoryHealth : report.repositoryHealth;
-  const limit = 70;
-  const available = typeof score === "number";
-  const failed = available && score < limit;
+  const meanSlop = report.thresholds?.meanSlop ?? 30;
+  const aiAvailable = typeof report.aiSlopScore === "number";
+  const aiPassed = aiAvailable && report.aiSlopScore <= meanSlop;
+  const rh = report.repositoryHealth;
+  const rhAvailable = typeof rh === "number";
+  const rhLimit = 70;
+  const rhPassed = rhAvailable && rh >= rhLimit;
   return `
   <section class="thresholds-section">
     <h2>Thresholds</h2>
@@ -55757,9 +55925,14 @@ function renderThresholds(report) {
       </thead>
       <tbody>
         <tr>
-          <td>Repository Health (composite)</td>
-          <td>${available ? `${score.toFixed(1)} / ${limit}` : "\u2013"}</td>
-          <td><span class="status-badge ${thresholdStatusClass(failed)}">${available ? failed ? "fail" : "pass" : "n/a"}</span></td>
+          <td>AI Slop Score (CI gate)</td>
+          <td>${aiAvailable ? `${report.aiSlopScore.toFixed(1)} / ${meanSlop}` : "\u2013"}</td>
+          <td><span class="status-badge ${thresholdStatusClass(!aiPassed)}">${aiAvailable ? aiPassed ? "pass" : "fail" : "n/a"}</span></td>
+        </tr>
+        <tr>
+          <td>Repository Health (informational)</td>
+          <td>${rhAvailable ? `${rh.toFixed(1)} / ${rhLimit}` : "\u2013"}</td>
+          <td><span class="status-badge ${thresholdStatusClass(!rhPassed)}">${rhAvailable ? rhPassed ? "pass" : "fail" : "n/a"}</span></td>
         </tr>
       </tbody>
     </table>
@@ -57320,12 +57493,16 @@ async function runScan(options, explicitPaths) {
     files = intersectFiles(files, since, cwd);
   }
   let incrementalSummary;
+  let cachePath3;
+  let existingCache;
+  let unchanged = [];
   if (options.incremental) {
-    const cachePath3 = options.cachePath ?? ".slopbrick-cache.json";
-    const existing = loadCache(cachePath3);
-    const { toScan, unchanged } = partitionByCache(files, existing);
-    files = toScan;
-    incrementalSummary = { skipped: unchanged.length, rescanned: toScan.length };
+    cachePath3 = options.cachePath ?? ".slopbrick-cache.json";
+    existingCache = loadCache(cachePath3);
+    const partition = partitionByCache(files, existingCache);
+    files = partition.toScan;
+    unchanged = partition.unchanged;
+    incrementalSummary = { skipped: unchanged.length, rescanned: partition.toScan.length };
   }
   const machineReadableStdout = !!options.json || !!options.html || options.format === "json" || options.format === "sarif" || options.format === "html";
   if (files.length === 0 && !options.quiet && !machineReadableStdout) {
@@ -57345,6 +57522,9 @@ async function runScan(options, explicitPaths) {
       logger.warn(
         `No source files matched in ${cwd}. Adjust --include or check your config at ${projectRoot}.`
       );
+      logger.warn(
+        "Tip: run from a directory with source files, or pass --workspace <path> (monorepos usually want `--workspace packages/<name>`)."
+      );
     }
   }
   const configHash = hashConfig(config);
@@ -57494,6 +57674,38 @@ async function runScan(options, explicitPaths) {
     telemetryEnabled,
     machineReadableStdout
   });
+  if (options.incremental && cachePath3 !== void 0) {
+    const cachedFiles = {};
+    for (const r of results) {
+      try {
+        cachedFiles[r.filePath] = {
+          hash: computeFileHash(r.filePath),
+          issueCount: r.issues.length,
+          lastScannedAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      } catch {
+      }
+    }
+    for (const f of unchanged) {
+      const cached = existingCache?.files[f];
+      if (cached) {
+        cachedFiles[f] = {
+          hash: cached.hash,
+          issueCount: cached.issueCount,
+          lastScannedAt: cached.lastScannedAt
+        };
+      } else {
+      }
+    }
+    try {
+      saveCache(cachePath3, {
+        version: VERSION,
+        generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        files: cachedFiles
+      });
+    } catch {
+    }
+  }
   return {
     report,
     scores,
@@ -57646,13 +57858,15 @@ init_discover();
 init_git();
 init_cache();
 init_logger();
+init_types();
+import chalk2 from "chalk";
 import { writeFileSync as writeFileSync12, mkdirSync as mkdirSync9, rmSync as rmSync2 } from "fs";
-import { join as join23, dirname as dirname14 } from "path";
+import { join as join23, dirname as dirname13 } from "path";
 import { createInterface } from "readline";
 
 // src/rules/registry-loader.ts
 import { existsSync as existsSync21, mkdirSync as mkdirSync8, readFileSync as readFileSync25, writeFileSync as writeFileSync11 } from "fs";
-import { dirname as dirname13, join as join21 } from "path";
+import { dirname as dirname12, join as join21 } from "path";
 
 // src/data/shadcn-registry.json
 var shadcn_registry_default = {
@@ -57789,7 +58003,7 @@ function cachePath2(cwd) {
   return join21(cwd, ".slopbrick", "cache", "registry-snapshot.json");
 }
 function ensureCacheDir(cwd) {
-  const dir = dirname13(cachePath2(cwd));
+  const dir = dirname12(cachePath2(cwd));
   if (!existsSync21(dir)) {
     mkdirSync8(dir, { recursive: true });
   }
@@ -57823,7 +58037,12 @@ async function refreshRegistrySnapshot(cwd, _url = REGISTRY_URL, _timeoutMs = 5e
     snapshot: shadcn_registry_default,
     ok: true,
     fresh: false,
-    message: "Using bundled snapshot (upstream URL returns 404)."
+    // v0.42.0 (user-review fix): the previous message said
+    // "upstream URL returns 404" which is alarming without context —
+    // upstream has been dead since v0.39.0, and the bundled snapshot
+    // IS the snapshot in use. Replaced with a neutral message that
+    // doesn't suggest "something is wrong".
+    message: "Using bundled shadcn/ui snapshot (built-in; no network fetch)."
   };
 }
 function copyBundledSnapshotToCache(cwd) {
@@ -57994,16 +58213,23 @@ async function runDoctor(cwd) {
   lines.push("slopbrick doctor\n");
   lines.push("Checking your setup:\n");
   const nodeMajor = parseInt(process.versions.node.split(".")[0] ?? "0", 10);
-  if (nodeMajor >= 20) ok(`Node ${process.versions.node}`);
+  if (nodeMajor >= 20) ok(`Node ${process.versions.node}, slopbrick ${VERSION}`);
   else fail(`Node ${process.versions.node} \u2014 slopbrick needs Node 20 or newer. Run: nvm install 20`);
   lines.push(`
   Working in: ${cwd}`);
   try {
+    const configPath = resolveConfigPath(cwd);
     const config = await loadConfig(cwd);
-    lines.push(`
-  \u2713 Config loaded from: ${resolveConfigPath(cwd) ?? "(default)"}`);
-    const ruleCount = Object.keys(config.rules ?? {}).length;
-    lines.push(`    ${ruleCount} rules configured in your config file.`);
+    if (configPath) {
+      const ruleCount = Object.keys(config.rules ?? {}).length;
+      lines.push(`
+  \u2713 Config loaded from: ${configPath}`);
+      lines.push(`    ${ruleCount} rule${ruleCount === 1 ? "" : "s"} configured in your config file.`);
+    } else {
+      lines.push(`
+  \u2713 Config: using built-in defaults (no config file found).`);
+      lines.push(chalk2.dim(`    Run \`slopbrick init\` to create ${cwd.endsWith("/") ? cwd : cwd + "/"}slopbrick.config.mjs and tune rule severity/rules to your project.`));
+    }
   } catch (error) {
     fail(`Could not read your config: ${error.message}`);
     exitCode = 3;
@@ -58018,7 +58244,7 @@ async function runDoctor(cwd) {
   try {
     const { parseFile: tryParse } = await Promise.resolve().then(() => (init_dist2(), dist_exports2));
     const testFile = join23(cwd, ".slopbrick", ".doctor-test.ts");
-    mkdirSync9(dirname14(testFile), { recursive: true });
+    mkdirSync9(dirname13(testFile), { recursive: true });
     writeFileSync12(testFile, "export const x = 1;\n");
     await tryParse(testFile);
     rmSync2(testFile, { force: true });
@@ -58060,6 +58286,7 @@ async function runDoctor(cwd) {
       ok(`Found ${scannable.length} source files to scan.`);
     } else {
       warn("No source files (.ts/.tsx/.js/.jsx/.vue/.svelte/.astro/.mdx) found in this directory.");
+      lines.push(chalk2.dim("    Run from a directory with source files, or pass --workspace <path>. Monorepos usually want `--workspace packages/<name>`."));
     }
   } catch {
   }
@@ -58124,7 +58351,7 @@ function registerBadge(program) {
     const health = loadHealth2(cwd);
     if (health) {
       const synthetic = {
-        slopIndex: 100 - health.repositoryHealth
+        aiSlopScore: health.aiSlopScore ?? 0
       };
       logger.info(formatBadge(synthetic));
       process.exit(0);
@@ -58454,17 +58681,17 @@ function round3(n) {
 }
 
 // src/rules/composite-loader.ts
-import { existsSync as existsSync23, readFileSync as readFileSync27, mkdirSync as mkdirSync10, writeFileSync as writeFileSync13 } from "fs";
-import { dirname as dirname15, join as join24 } from "path";
+import { existsSync as existsSync22, readFileSync as readFileSync26, mkdirSync as mkdirSync10, writeFileSync as writeFileSync13 } from "fs";
+import { dirname as dirname14, join as join24 } from "path";
 var COMPOSITES_FILE = "composites.json";
 function compositesPath(cwd) {
   return join24(cwd, COMPOSITES_FILE);
 }
 function readComposites(cwd) {
   const path = compositesPath(cwd);
-  if (!existsSync23(path)) return [];
+  if (!existsSync22(path)) return [];
   try {
-    const raw = JSON.parse(readFileSync27(path, "utf-8"));
+    const raw = JSON.parse(readFileSync26(path, "utf-8"));
     if (!Array.isArray(raw)) return [];
     return raw.filter(isCompositeRuleEntry);
   } catch {
@@ -58478,7 +58705,7 @@ function isCompositeRuleEntry(value) {
 }
 function writeComposites(cwd, entries) {
   const path = compositesPath(cwd);
-  mkdirSync10(dirname15(path), { recursive: true });
+  mkdirSync10(dirname14(path), { recursive: true });
   const tmp = `${path}.tmp`;
   writeFileSync13(tmp, JSON.stringify(entries, null, 2), "utf-8");
   const fs = __require("fs");
@@ -58668,7 +58895,11 @@ init_logger();
 init_builtins();
 init_data();
 function registerExplain(program) {
-  program.command("explain <ruleId>").description("Print rationale, pattern, and remediation for a single rule").action((ruleId) => {
+  program.command("explain [ruleId]").description("Print rationale, pattern, and remediation for a single rule. With no ruleId, lists the rules.").action((ruleId) => {
+    if (!ruleId) {
+      logger.warn("Missing ruleId. Run `slopbrick rules` to see available rules, then `slopbrick explain <ruleId>`.");
+      process.exit(2);
+    }
     const result = explainRule(ruleId, builtinRules, RULE_HINTS);
     logger.info(formatExplain(result));
     if ("error" in result) process.exit(2);
@@ -58676,7 +58907,7 @@ function registerExplain(program) {
 }
 
 // src/cli/commands/calibration.ts
-import { dirname as dirname16 } from "path";
+import { dirname as dirname15 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/rules/signal-strength.json
@@ -62269,7 +62500,7 @@ var signal_strength_default2 = {
 };
 
 // src/cli/commands/calibration.ts
-var __dirname = dirname16(fileURLToPath2(import.meta.url));
+var __dirname = dirname15(fileURLToPath2(import.meta.url));
 function loadData() {
   return signal_strength_default2;
 }
@@ -62397,12 +62628,12 @@ import { resolve as resolve16 } from "path";
 // src/cli/installer.ts
 import {
   chmodSync,
-  existsSync as existsSync24,
+  existsSync as existsSync23,
   mkdirSync as mkdirSync11,
-  readFileSync as readFileSync28,
+  readFileSync as readFileSync27,
   writeFileSync as writeFileSync14
 } from "fs";
-import { dirname as dirname17, join as join26 } from "path";
+import { dirname as dirname16, join as join25 } from "path";
 var BEGIN_SENTINEL = "# slopbrick-hook-begin";
 var END_SENTINEL = "# slopbrick-hook-end";
 var SENTINEL_BLOCK = `${BEGIN_SENTINEL}
@@ -62410,14 +62641,14 @@ npx slopbrick --staged
 ${END_SENTINEL}
 `;
 function hookPath(gitRoot) {
-  const huskyDir = join26(gitRoot, ".husky");
-  if (existsSync24(huskyDir)) {
-    return join26(huskyDir, "pre-commit");
+  const huskyDir = join25(gitRoot, ".husky");
+  if (existsSync23(huskyDir)) {
+    return join25(huskyDir, "pre-commit");
   }
-  return join26(gitRoot, ".git", "hooks", "pre-commit");
+  return join25(gitRoot, ".git", "hooks", "pre-commit");
 }
 function readHookContent(path) {
-  return readFileSync28(path, "utf8");
+  return readFileSync27(path, "utf8");
 }
 function sentinelsPresent(content) {
   const lines = content.split(/\r?\n/);
@@ -62439,7 +62670,7 @@ function replaceSentinelBlock(content) {
 }
 function installHook(gitRoot) {
   const path = hookPath(gitRoot);
-  if (existsSync24(path)) {
+  if (existsSync23(path)) {
     const content = readHookContent(path);
     const { begin, end } = sentinelsPresent(content);
     if (begin && end) {
@@ -62479,7 +62710,7 @@ function installHook(gitRoot) {
       exitCode: 0
     };
   }
-  mkdirSync11(dirname17(path), { recursive: true });
+  mkdirSync11(dirname16(path), { recursive: true });
   writeFileSync14(path, SENTINEL_BLOCK, { mode: 493 });
   chmodSync(path, 493);
   return {
@@ -62490,7 +62721,7 @@ function installHook(gitRoot) {
 }
 function uninstallHook(gitRoot) {
   const path = hookPath(gitRoot);
-  if (!existsSync24(path)) {
+  if (!existsSync23(path)) {
     return {
       ok: true,
       message: "Hook not installed",
@@ -62588,12 +62819,12 @@ init_patterns();
 init_architecture_score();
 init_business_logic();
 init_structure_md();
-import { readFileSync as readFileSync29 } from "fs";
+import { readFileSync as readFileSync28 } from "fs";
 import { resolve as resolve18 } from "path";
 var TOOL_DEFINITIONS = [
   {
     name: "slop_scan_file",
-    description: "Scan a single TypeScript/JavaScript file for AI-generated frontend slop. Returns issues (ruleId, severity, line, column, message, advice) and the file-level Slop Index.",
+    description: 'Scan a single TypeScript/JavaScript file for AI-generated frontend slop. Returns issues (ruleId, category, severity, line, column, message, advice), a composite AI-likelihood score (probability + confidenceTier), and a componentCount. The composite score is the Bayesian log-likelihood ratio of all rules that fired, NOT a per-file "Slop Index" \u2014 for project-level scores use slop_suggest.',
     inputSchema: {
       type: "object",
       properties: {
@@ -62609,7 +62840,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "slop_explain_rule",
-    description: "Return metadata for a single rule (id, category, severity, aiSpecific) plus a rationale and the recommended fix. Use this before auto-applying --fix to understand what the rule catches.",
+    description: "Return metadata for a single rule: ruleId, category, severity, aiSpecific, a brief rationale string, and a whereToLook path into src/rules/. The actual fix-steps live in the rule source (whereToLook) rather than in this response \u2014 read that file to understand the rule before auto-applying --fix.",
     inputSchema: {
       type: "object",
       properties: {
@@ -62630,7 +62861,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "slop_suggest",
-    description: "**Primary entry point for AI agents.** Returns the project's existing patterns (modals, buttons, api clients, state libs, data-fetching libs), the do-not-create list (forbidden imports + canonical patterns not to duplicate), top issues by rule, hot files by issue count, and the composite Repository Health score. Call this BEFORE writing new code so the agent reuses existing patterns instead of duplicating them.",
+    description: "**Primary entry point for AI agents.** Returns the project's existing patterns (modals, buttons, api clients, state libs, data-fetching libs), the do-not-create list (forbidden imports + canonical patterns not to duplicate), the declared stack, and (when .slopbrick/health.json exists) a Bayesian composite AI-likelihood score. Call this BEFORE writing new code so the agent reuses existing patterns instead of duplicating them. For per-issue details or per-file hot-spots, use slop_scan_file on each candidate path.",
     inputSchema: {
       type: "object",
       properties: {
@@ -62662,7 +62893,7 @@ var TOOL_DEFINITIONS = [
     // call slop_suggest and read repositoryHealth /
     // architectureConsistency / businessLogicCoherence.
     name: "slop_check_constitution",
-    description: "Check a single file against the project's declared constitution (stateManagement, dataFetching, uiLibrary, forms, styling, routing, plus a forbidden deny-list in slopbrick.config.mjs). Returns a list of imports that violate declared values or hit the deny-list. Use this on a newly-written or modified file before suggesting a PR.",
+    description: "Check a single file against the project's declared constitution (stateManagement, dataFetching, uiLibrary, forms, styling, routing, plus a forbidden deny-list in slopbrick.config.mjs). Returns the file path, total import + violation counts, the parsed imports, the list of violations (each with import, category, and reason), and a conventionSource indicating whether the constitution was declared, detected, or absent. Use this on a newly-written or modified file before suggesting a PR.",
     inputSchema: {
       type: "object",
       properties: {
@@ -62679,7 +62910,7 @@ var TOOL_DEFINITIONS = [
     // (sha256 over sorted hooks ∪ props ∪ params) + Jaccard similarity
     // — no LLM, no embeddings, deterministic. Foundation for StackPick.
     name: "slop_find_similar",
-    description: "Find the most similar existing function/component implementations across the codebase, ranked by Jaccard similarity over the union of (hooks \u222A props \u222A params). Use this BEFORE writing new code so the agent reuses an existing pattern instead of inventing a new one. Returns top-k matches with name, file, line, fingerprint, and similarity score in [0, 1].",
+    description: "Find the most similar existing function/component implementations across the codebase, ranked by Jaccard similarity over the union of (hooks \u222A props \u222A params). Use this BEFORE writing new code so the agent reuses an existing pattern instead of inventing a new one. Returns up to `limit` matches (default 10) with name, file, line, fingerprint (sha256 over signature), hooks, props, params, and similarity in [0, 1].",
     inputSchema: {
       type: "object",
       properties: {
@@ -62833,7 +63064,7 @@ function runCheckConstitution(args, ctx) {
   const absPath = resolve18(ctx.cwd, path);
   let source;
   try {
-    source = readFileSync29(absPath, "utf-8");
+    source = readFileSync28(absPath, "utf-8");
   } catch (err) {
     return toolError(
       `Cannot read file ${absPath}: ${err instanceof Error ? err.message : String(err)}`
@@ -62910,13 +63141,6 @@ async function runFindSimilar(args, ctx) {
   }
 }
 async function handleToolCall(toolName, args, ctx) {
-  const deprecation = getDeprecation(toolName);
-  const deprecationNotice = deprecation ? {
-    tool: toolName,
-    replacedBy: deprecation.replacedBy,
-    removedIn: deprecation.removedIn ?? "next major",
-    reason: deprecation.reason
-  } : void 0;
   switch (toolName) {
     case "slop_scan_file":
       return runScanFile(args, ctx);
@@ -63124,7 +63348,7 @@ init_logger();
 init_dist();
 import { resolve as resolve21 } from "path";
 function registerCi(program, scanAction) {
-  program.command("ci").description("CI gate: run a scan and exit 1 on constitution violations, threshold breach, or new issues since the last run. Use this in GitHub Actions / GitLab CI.").option("--max-slop <n>", "exit 1 if slopIndex exceeds this number", parseCount).option("--max-new-issues <n>", "exit 1 if new issues (vs .slop-audit-cache.json) exceed this number", parseCount).option("--strict-constitution", "exit 1 on any constitution violation").option("--format <pretty|json>", "output format", "json").action(
+  program.command("ci").description("CI gate: run a scan and exit 1 on constitution violations, threshold breach, or new issues since the last run. Use this in GitHub Actions / GitLab CI.").option("--max-slop <n>", "exit 1 if aiSlopScore exceeds this number (lower = cleaner since v0.21)", parseCount).option("--max-new-issues <n>", "exit 1 if new issues (vs .slop-audit-cache.json) exceed this number", parseCount).option("--strict-constitution", "exit 1 on any constitution violation").option("--format <pretty|json>", "output format", "json").action(
     async (cmdOptions, command) => {
       const globals = command.optsWithGlobals();
       const options = {
@@ -63203,44 +63427,44 @@ import { resolve as resolve23 } from "path";
 
 // src/cli/migrate.ts
 init_logger();
-import { existsSync as existsSync25, readFileSync as readFileSync30, renameSync as renameSync4, writeFileSync as writeFileSync15 } from "fs";
-import { join as join27 } from "path";
+import { existsSync as existsSync24, readFileSync as readFileSync29, renameSync as renameSync4, writeFileSync as writeFileSync15 } from "fs";
+import { join as join26 } from "path";
 function planMigration(workspaceDir) {
   const moves = [];
   const rewrites = [];
   const gitignoreEdits = [];
-  const oldDir = join27(workspaceDir, ".slop-audit");
-  const newDir = join27(workspaceDir, ".slopbrick");
-  if (existsSync25(oldDir)) {
+  const oldDir = join26(workspaceDir, ".slop-audit");
+  const newDir = join26(workspaceDir, ".slopbrick");
+  if (existsSync24(oldDir)) {
     moves.push({ from: oldDir, to: newDir, kind: "dir" });
     rewrites.push({
-      path: join27(newDir, "inventory.json"),
+      path: join26(newDir, "inventory.json"),
       field: "version",
       from: '"1"',
       to: '"2"'
     });
     rewrites.push({
-      path: join27(newDir, "constitution.json"),
+      path: join26(newDir, "constitution.json"),
       field: "version",
       from: '"1"',
       to: '"2"'
     });
   }
-  const oldCache = join27(workspaceDir, ".slop-audit-cache.json");
-  const newCache = join27(workspaceDir, ".slopbrick-cache.json");
-  if (existsSync25(oldCache)) {
+  const oldCache = join26(workspaceDir, ".slop-audit-cache.json");
+  const newCache = join26(workspaceDir, ".slopbrick-cache.json");
+  if (existsSync24(oldCache)) {
     moves.push({ from: oldCache, to: newCache, kind: "file" });
   }
   for (const ext of ["mjs", "cjs", "js"]) {
-    const oldCfg = join27(workspaceDir, `slop-audit.config.${ext}`);
-    const newCfg = join27(workspaceDir, `slopbrick.config.${ext}`);
-    if (existsSync25(oldCfg)) {
+    const oldCfg = join26(workspaceDir, `slop-audit.config.${ext}`);
+    const newCfg = join26(workspaceDir, `slopbrick.config.${ext}`);
+    if (existsSync24(oldCfg)) {
       moves.push({ from: oldCfg, to: newCfg, kind: "config" });
     }
   }
-  const gi = join27(workspaceDir, ".gitignore");
-  if (existsSync25(gi)) {
-    const content = readFileSync30(gi, "utf-8");
+  const gi = join26(workspaceDir, ".gitignore");
+  if (existsSync24(gi)) {
+    const content = readFileSync29(gi, "utf-8");
     if (content.includes(".slop-audit/")) {
       gitignoreEdits.push({
         path: gi,
@@ -63259,7 +63483,7 @@ function planMigration(workspaceDir) {
   return { moves, rewrites, gitignoreEdits };
 }
 function isAlreadyMigrated(workspaceDir) {
-  return existsSync25(join27(workspaceDir, ".slopbrick")) && !existsSync25(join27(workspaceDir, ".slop-audit"));
+  return existsSync24(join26(workspaceDir, ".slopbrick")) && !existsSync24(join26(workspaceDir, ".slop-audit"));
 }
 function applyMigration(plan, options = {}) {
   if (options.dryRun) return;
@@ -63267,20 +63491,20 @@ function applyMigration(plan, options = {}) {
     renameSync4(m.from, m.to);
   }
   for (const r of plan.rewrites) {
-    if (!existsSync25(r.path)) continue;
-    const content = readFileSync30(r.path, "utf-8");
+    if (!existsSync24(r.path)) continue;
+    const content = readFileSync29(r.path, "utf-8");
     const next = content.replace(`"version": ${r.from}`, `"version": ${r.to}`);
     writeFileSync15(r.path, next);
   }
   for (const g of plan.gitignoreEdits) {
-    const content = readFileSync30(g.path, "utf-8");
+    const content = readFileSync29(g.path, "utf-8");
     const next = content.replaceAll(g.from, g.to);
     writeFileSync15(g.path, next);
   }
 }
 function runMigrate(options) {
   const { workspace, dryRun = false, force = false } = options;
-  if (!existsSync25(workspace)) {
+  if (!existsSync24(workspace)) {
     return {
       ok: false,
       alreadyMigrated: false,
@@ -63290,9 +63514,9 @@ function runMigrate(options) {
     };
   }
   const alreadyMigrated = isAlreadyMigrated(workspace);
-  const newDir = join27(workspace, ".slopbrick");
-  const oldDir = join27(workspace, ".slop-audit");
-  if (existsSync25(newDir) && existsSync25(oldDir) && !force) {
+  const newDir = join26(workspace, ".slopbrick");
+  const oldDir = join26(workspace, ".slop-audit");
+  if (existsSync24(newDir) && existsSync24(oldDir) && !force) {
     return {
       ok: false,
       alreadyMigrated: false,
@@ -63464,7 +63688,25 @@ function registerRules(program) {
         const sev = r.severity.padEnd(8);
         const tag = r.aiSpecific ? "[AI]" : "     ";
         lines.push(`  ${sev} ${tag} ${r.id}`);
-        if (r.description) lines.push(`           ${r.description}`);
+        if (r.description) {
+          const cols = process.stdout.isTTY ? process.stdout.columns ?? 100 : 100;
+          const indent = "           ";
+          const firstCol = indent.length + 1;
+          const maxWidth = Math.max(40, cols - firstCol);
+          const words = r.description.split(" ");
+          let line = "";
+          for (const word of words) {
+            if (line === "") {
+              line = word;
+            } else if ((line + " " + word).length > maxWidth) {
+              lines.push(indent + line);
+              line = word;
+            } else {
+              line = line + " " + word;
+            }
+          }
+          if (line) lines.push(indent + line);
+        }
       }
     }
     logger.info(lines.join("\n"));
@@ -63474,12 +63716,12 @@ function registerRules(program) {
 // src/cli/commands/validate-config.ts
 init_logger();
 init_validation();
-import { existsSync as existsSync26 } from "fs";
+import { existsSync as existsSync25 } from "fs";
 import { extname as extname8, resolve as resolve24 } from "path";
 function registerValidateConfig(program) {
   program.command("validate-config [path]").description("Statically validate a slopbrick.config.mjs without scanning").action(async (configPath) => {
     const path = configPath ? resolve24(configPath) : resolve24(process.cwd(), "slopbrick.config.mjs");
-    if (!existsSync26(path)) {
+    if (!existsSync25(path)) {
       logger.error(`Error: config file not found: ${path}`);
       process.exit(2);
     }
@@ -63706,7 +63948,7 @@ ${formatMarkdown(result.report)}`);
 // src/cli/commands/calibrate.ts
 init_logger();
 import { mkdirSync as mkdirSync14, writeFileSync as writeFileSync18 } from "fs";
-import { dirname as dirname19, resolve as resolve26 } from "path";
+import { dirname as dirname17, resolve as resolve26 } from "path";
 
 // src/research/providers/openai.ts
 var OpenAiProvider = class {
@@ -63762,7 +64004,7 @@ function createProvider(config) {
 
 // src/research/generator.ts
 import { mkdirSync as mkdirSync12, writeFileSync as writeFileSync16 } from "fs";
-import { join as join28 } from "path";
+import { join as join27 } from "path";
 
 // src/research/prompts.ts
 var DEFAULT_PROMPT_TEMPLATES = [
@@ -63825,13 +64067,13 @@ async function generateSamples(options) {
   }
   const samples = [];
   const ext = extForFramework(framework);
-  const dir = join28(outputDir, framework, componentType);
+  const dir = join27(outputDir, framework, componentType);
   mkdirSync12(dir, { recursive: true });
   for (let i = 1; i <= count; i += 1) {
     const raw = await provider.generateSample(renderPrompt(template), { temperature });
     const code = extractCodeFromMarkdown(raw);
     const fileName = `sample-${i}${ext}`;
-    const filePath = join28(dir, fileName);
+    const filePath = join27(dir, fileName);
     writeFileSync16(filePath, code, "utf8");
     const sample = {
       filePath,
@@ -63843,7 +64085,7 @@ async function generateSamples(options) {
     };
     samples.push(sample);
   }
-  const metadataPath = join28(dir, "metadata.json");
+  const metadataPath = join27(dir, "metadata.json");
   writeFileSync16(metadataPath, JSON.stringify(samples, null, 2), "utf8");
   return samples;
 }
@@ -64050,46 +64292,46 @@ function slugify(value) {
 
 // src/research/calibrator.ts
 import { execFileSync as execFileSync2 } from "child_process";
-import { existsSync as existsSync27, readFileSync as readFileSync31, writeFileSync as writeFileSync17, mkdirSync as mkdirSync13 } from "fs";
-import { join as join30, resolve as resolve25 } from "path";
+import { existsSync as existsSync26, readFileSync as readFileSync30, writeFileSync as writeFileSync17, mkdirSync as mkdirSync13 } from "fs";
+import { join as join29, resolve as resolve25 } from "path";
 
 // src/corpus-paths.ts
-import { join as join29 } from "path";
+import { join as join28 } from "path";
 var CORPUS_ROOT = process.env["SLOPBRICK_CORPUS_DIR"] ?? "/Users/cheng/corpus-expansion";
-var POSITIVE_DIR = join29(CORPUS_ROOT, "positive");
-var NEGATIVE_DIR = join29(CORPUS_ROOT, "negative");
-var FILELISTS_DIR = join29(CORPUS_ROOT, "filelists");
+var POSITIVE_DIR = join28(CORPUS_ROOT, "positive");
+var NEGATIVE_DIR = join28(CORPUS_ROOT, "negative");
+var FILELISTS_DIR = join28(CORPUS_ROOT, "filelists");
 
 // src/research/calibrator.ts
 var DEFAULT_POSITIVE = POSITIVE_DIR;
 var DEFAULT_NEGATIVE = NEGATIVE_DIR;
 function buildFileList(dir, extensions) {
-  const tmpList = join30("/tmp", `cal-build-${Date.now()}-${Math.random().toString(36).slice(2)}.txt`);
+  const tmpList = join29("/tmp", `cal-build-${Date.now()}-${Math.random().toString(36).slice(2)}.txt`);
   const expr = extensions.map((e) => `-name '*.${e}'`).join(" -o ");
   execFileSync2("bash", ["-c", `find ${dir} -maxdepth 8 -type f \\( ${expr} \\) -print0 | xargs -0 realpath > ${tmpList}`]);
-  const out = readFileSync31(tmpList, "utf8");
+  const out = readFileSync30(tmpList, "utf8");
   execFileSync2("rm", ["-f", tmpList]);
   return out.trim().split("\n").filter(Boolean);
 }
 function runScan2(fileListPath) {
-  const files = readFileSync31(fileListPath, "utf8").trim().split("\n").filter(Boolean);
+  const files = readFileSync30(fileListPath, "utf8").trim().split("\n").filter(Boolean);
   const CHUNK = 600;
   const ruleFires = /* @__PURE__ */ new Map();
   const uniqueFilesPerRule = /* @__PURE__ */ new Map();
   let fileCount = 0;
-  const tmpOut = join30("/tmp", `calibrate-${Date.now()}-${Math.random().toString(36).slice(2)}.json`);
+  const tmpOut = join29("/tmp", `calibrate-${Date.now()}-${Math.random().toString(36).slice(2)}.json`);
   for (let i = 0; i < files.length; i += CHUNK) {
     const chunk = files.slice(i, i + CHUNK);
     try {
       execFileSync2(
         "node",
-        [join30(process.cwd(), "bin", "slopbrick.js"), "scan", ...chunk, "--json", tmpOut, "--no-telemetry", "--quiet"],
+        [join29(process.cwd(), "bin", "slopbrick.js"), "scan", ...chunk, "--json", tmpOut, "--no-telemetry", "--quiet"],
         { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }
       );
     } catch {
     }
-    if (!existsSync27(tmpOut)) continue;
-    const report = JSON.parse(readFileSync31(tmpOut, "utf8"));
+    if (!existsSync26(tmpOut)) continue;
+    const report = JSON.parse(readFileSync30(tmpOut, "utf8"));
     fileCount += report.fileCount;
     for (const issue of report.issues) {
       ruleFires.set(issue.ruleId, (ruleFires.get(issue.ruleId) ?? 0) + 1);
@@ -64117,14 +64359,14 @@ function classify(posFiles, negFiles) {
 async function calibrate(cwd, options = {}) {
   const positiveDir = options.positiveDir ?? DEFAULT_POSITIVE;
   const negativeDir = options.negativeDir ?? DEFAULT_NEGATIVE;
-  if (!existsSync27(positiveDir)) throw new Error(`Positive corpus not found: ${positiveDir}`);
-  if (!existsSync27(negativeDir)) throw new Error(`Negative corpus not found: ${negativeDir}`);
+  if (!existsSync26(positiveDir)) throw new Error(`Positive corpus not found: ${positiveDir}`);
+  if (!existsSync26(negativeDir)) throw new Error(`Negative corpus not found: ${negativeDir}`);
   const positiveFiles = buildFileList(positiveDir, ["tsx", "ts", "jsx", "js"]);
   const negativeFiles = buildFileList(negativeDir, ["tsx", "ts"]);
   const posSample = options.positiveLimit ? positiveFiles.slice(0, options.positiveLimit) : positiveFiles;
   const negSample = options.negativeLimit ? negativeFiles.slice(0, options.negativeLimit) : negativeFiles;
-  const posListPath = join30("/tmp", `cal-pos-${Date.now()}.txt`);
-  const negListPath = join30("/tmp", `cal-neg-${Date.now()}.txt`);
+  const posListPath = join29("/tmp", `cal-pos-${Date.now()}.txt`);
+  const negListPath = join29("/tmp", `cal-neg-${Date.now()}.txt`);
   writeFileSync17(posListPath, posSample.join("\n"));
   writeFileSync17(negListPath, negSample.join("\n"));
   const builtins = await Promise.resolve().then(() => (init_builtins(), builtins_exports));
@@ -64241,7 +64483,7 @@ function registerCalibrate(program) {
         negativeLimit: cmdOptions.negativeLimit
       });
       const outputPath = cmdOptions.output ? resolve26(cwd, cmdOptions.output) : resolve26(cwd, "corpus", "calibration-empirical.md");
-      mkdirSync14(dirname19(outputPath), { recursive: true });
+      mkdirSync14(dirname17(outputPath), { recursive: true });
       writeFileSync18(outputPath, reportToMarkdown(report), "utf8");
       logger.info(
         "Calibrated " + report.rules.length + " rules across " + report.positiveFileCount + " positive + " + report.negativeFileCount + " negative files."
@@ -64309,19 +64551,20 @@ function trendToText(report) {
   }
   const slopValues = report.points.map((p) => p.slopIndex);
   const spark = sparkline(slopValues);
-  lines.push("Slop Index trend (last " + report.points.length + " scans, " + report.totalScans + " total):");
+  lines.push("AI Slop Score trend (last " + report.points.length + " scans, " + report.totalScans + " total; lower = cleaner since v0.21):");
   lines.push("");
   lines.push("  " + spark + "  " + slopValues[0].toFixed(1) + " -> " + slopValues[slopValues.length - 1].toFixed(1));
   lines.push("");
   if (report.first && report.latest) {
     const direction = report.delta < 0 ? "improved" : report.delta > 0 ? "regressed" : "unchanged";
     const arrow = report.delta < 0 ? "v" : report.delta > 0 ? "^" : "=";
-    lines.push("  " + arrow + " Slop Index " + direction + " by " + Math.abs(report.delta).toFixed(1) + " points");
+    lines.push("  " + arrow + " AI Slop Score " + direction + " by " + Math.abs(report.delta).toFixed(1) + " points (lower = cleaner since v0.21)");
     lines.push("    " + report.first.timestamp + "  ->  " + report.latest.timestamp);
   }
   lines.push("");
   lines.push("Recent scans:");
-  lines.push("  Timestamp                  Slop    Health  Framework  Issues");
+  lines.push("  Timestamp                  AI Slop   Health  Framework  Issues");
+  lines.push("                             (lower=cleaner)");
   lines.push("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500   \u2500\u2500\u2500\u2500   \u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500  \u2500\u2500\u2500\u2500\u2500\u2500");
   for (const p of report.points.slice(-10)) {
     const ts = p.timestamp.slice(0, 19).replace("T", " ");
@@ -64333,14 +64576,14 @@ function trendToText(report) {
 }
 function trendToMarkdown(report) {
   const lines = [];
-  lines.push("# Slop Index Trend");
+  lines.push("# AI Slop Score Trend (lower = cleaner since v0.21)");
   lines.push("");
   if (report.points.length === 0) {
     lines.push("No telemetry data yet. Run `slopbrick scan` to start tracking.");
     return lines.join("\n");
   }
   const slopValues = report.points.map((p) => p.slopIndex);
-  lines.push("Slop Index sparkline (last " + report.points.length + " scans):");
+  lines.push("AI Slop Score sparkline (last " + report.points.length + " scans; lower = cleaner since v0.21):");
   lines.push("");
   lines.push("```");
   lines.push(sparkline(slopValues));
@@ -64348,10 +64591,10 @@ function trendToMarkdown(report) {
   lines.push("");
   if (report.first && report.latest) {
     const direction = report.delta < 0 ? "improved" : report.delta > 0 ? "regressed" : "unchanged";
-    lines.push("Slop Index " + direction + " by **" + Math.abs(report.delta).toFixed(1) + " points** between first and latest scan.");
+    lines.push("AI Slop Score " + direction + " by **" + Math.abs(report.delta).toFixed(1) + " points** between first and latest scan (lower = cleaner since v0.21).");
   }
   lines.push("");
-  lines.push("| Timestamp | Slop Index | Health | Framework | Issues |");
+  lines.push("| Timestamp | AI Slop Score (lower = cleaner) | Health | Framework | Issues |");
   lines.push("|-----------|-----------:|-------:|-----------|-------:|");
   for (const p of report.points) {
     lines.push("| " + p.timestamp + " | " + p.slopIndex.toFixed(1) + " | " + p.assemblyHealth.toFixed(1) + " | " + p.framework + " | " + p.totalIssues + " |");
@@ -64361,7 +64604,7 @@ function trendToMarkdown(report) {
 
 // src/cli/commands/trend.ts
 function registerTrend(program) {
-  program.command("trend").description("Slop Index over time, from .slopbrick/flywheel/scans.jsonl").option("--max-points <n>", "how many recent scans to plot", parseCount, 30).option("--render <kind>", "output rendering: text | markdown", "text").action((cmdOptions) => {
+  program.command("trend").description("AI Slop Score over time, from .slopbrick/flywheel/scans.jsonl (lower = cleaner since v0.21)").option("--max-points <n>", "how many recent scans to plot", parseCount, 30).option("--render <kind>", "output rendering: text | markdown", "text").action((cmdOptions) => {
     try {
       const cwd = process.cwd();
       const report = buildTrend(cwd, cmdOptions.maxPoints);
@@ -64369,7 +64612,14 @@ function registerTrend(program) {
       logger.info(out);
       if (report.delta > 1) {
         logger.info("");
-        logger.info("Warning: Slop Index increased by " + report.delta.toFixed(1) + " points over this period.");
+        logger.info(
+          // v0.42.0: the legacy 'Slop Index increased' message implied higher
+          // = worse, which is the v0.15-v0.20.1 inverted reading. Since v0.21,
+          // AI Slop Score is lower-is-better; an INCREASE is worse, but
+          // the warning should say "AI Slop Score got worse" or just
+          // "delta went up" so users don't have to remember the direction.
+          `Warning: AI Slop Score got worse by ${report.delta.toFixed(1)} points over this period (lower = cleaner since v0.21).`
+        );
       }
     } catch (error) {
       logger.error(error instanceof Error ? error.message : String(error));
@@ -64387,7 +64637,7 @@ import { resolve as resolve27 } from "path";
 init_discover();
 init_patterns();
 init_telemetry();
-import { readFileSync as readFileSync32 } from "fs";
+import { readFileSync as readFileSync31 } from "fs";
 import { basename as basename4, relative as relative16 } from "path";
 async function runDrift(cwd, config, options = {}) {
   const maxFiles = options.maxFiles ?? 1e3;
@@ -64399,7 +64649,7 @@ async function runDrift(cwd, config, options = {}) {
   for (const absPath of limited) {
     let source;
     try {
-      source = readFileSync32(absPath, "utf-8");
+      source = readFileSync31(absPath, "utf-8");
     } catch {
       continue;
     }
@@ -64722,7 +64972,7 @@ init_worker();
 init_metrics();
 init_patterns();
 init_discover();
-import { readFileSync as readFileSync33 } from "fs";
+import { readFileSync as readFileSync32 } from "fs";
 import { extname as extname9, relative as relative17, resolve as resolve28 } from "path";
 import { execFile as execFileCb } from "child_process";
 import { promisify as promisify2 } from "util";
@@ -64795,7 +65045,7 @@ async function runPrScan(cwd, config, options = {}) {
   for (const absPath of candidates) {
     let source;
     try {
-      source = readFileSync33(absPath, "utf-8");
+      source = readFileSync32(absPath, "utf-8");
     } catch {
       continue;
     }
@@ -64987,13 +65237,13 @@ function parseUnifiedDiffPaths(diff) {
 async function runPrScanFromDiffFile(cwd, config, diffPath, options = {}) {
   const threshold = options.threshold ?? config.prScoreThreshold ?? 20;
   const maxFiles = options.maxFiles ?? 500;
-  const { existsSync: existsSync32, readFileSync: readFileSync42 } = await import("fs");
+  const { existsSync: existsSync31, readFileSync: readFileSync41 } = await import("fs");
   const { isAbsolute: isAbsolute4, resolve: resolvePath } = await import("path");
-  if (!existsSync32(diffPath)) {
+  if (!existsSync31(diffPath)) {
     throw new Error(`Diff file not found: ${diffPath}`);
   }
   const diffAbs = isAbsolute4(diffPath) ? diffPath : resolvePath(cwd, diffPath);
-  const diff = readFileSync42(diffAbs, "utf-8");
+  const diff = readFileSync41(diffAbs, "utf-8");
   const changedPaths = parseUnifiedDiffPaths(diff);
   if (changedPaths.length === 0) {
     return emptyPrResult(threshold);
@@ -65001,7 +65251,7 @@ async function runPrScanFromDiffFile(cwd, config, diffPath, options = {}) {
   return scoreChangedPaths(cwd, config, changedPaths, maxFiles, threshold);
 }
 async function scoreChangedPaths(cwd, config, paths, maxFiles, threshold) {
-  const { existsSync: existsSync32, statSync: statSync8 } = await import("fs");
+  const { existsSync: existsSync31, statSync: statSync8 } = await import("fs");
   const { resolve: resolvePath } = await import("path");
   const { readFile: readFile4 } = await import("fs/promises");
   const { scanFile: scanFile2 } = await Promise.resolve().then(() => (init_worker(), worker_exports));
@@ -65013,7 +65263,7 @@ async function scoreChangedPaths(cwd, config, paths, maxFiles, threshold) {
   let constitutionViolations = 0;
   for (const rel of limited) {
     const abs = resolvePath(cwd, rel);
-    if (!existsSync32(abs) || !statSync8(abs).isFile()) continue;
+    if (!existsSync31(abs) || !statSync8(abs).isFile()) continue;
     let source;
     try {
       source = await readFile4(abs, "utf-8");
@@ -65191,7 +65441,7 @@ var TEST_INCLUDE_GLOBS = [
   "**/__tests__/**/*.{ts,tsx,js,jsx}",
   "**/__fixtures__/**/*.{ts,tsx,js,jsx,json}"
 ];
-async function runTestScan(cwd, config, options = {}) {
+async function runTestScan(cwd, _config, options = {}) {
   const include = TEST_INCLUDE_GLOBS;
   const cliOptions = {
     include,
@@ -65329,7 +65579,7 @@ import { resolve as resolve34 } from "path";
 // src/cli/business-logic.ts
 init_discover();
 init_business_logic();
-import { readFileSync as readFileSync34 } from "fs";
+import { readFileSync as readFileSync33 } from "fs";
 import { relative as relative18 } from "path";
 async function runBusinessLogicScan(cwd, config, options = {}) {
   const maxFiles = options.maxFiles ?? 500;
@@ -65340,7 +65590,7 @@ async function runBusinessLogicScan(cwd, config, options = {}) {
   for (const absPath of limited) {
     let source;
     try {
-      source = readFileSync34(absPath, "utf-8");
+      source = readFileSync33(absPath, "utf-8");
     } catch {
       continue;
     }
@@ -65910,7 +66160,7 @@ import { resolve as resolve38 } from "path";
 // src/engine/patterns.ts
 init_patterns();
 init_discover();
-import { readFileSync as readFileSync35 } from "fs";
+import { readFileSync as readFileSync34 } from "fs";
 import { basename as basename5, relative as relative19 } from "path";
 var PATTERN_CATEGORIES = [
   "modal",
@@ -66013,7 +66263,7 @@ function detectFormsFromFiles(files) {
   for (const f of files) {
     let source;
     try {
-      source = readFileSync35(f, "utf-8");
+      source = readFileSync34(f, "utf-8");
     } catch {
       continue;
     }
@@ -66140,7 +66390,7 @@ function formatText2(report) {
     const label = CATEGORY_LABELS2[cat].padEnd(20);
     const count = String(stats.count).padStart(2);
     const baseline = String(stats.baseline).padStart(1);
-    const excess = stats.excess > 0 ? `\u26A0 +${stats.excess} over` : "\u2713 clean";
+    const excess = stats.excess > 0 ? `\u26A0 +${stats.excess} over` : stats.count === 0 ? "\u2713 none" : "\u2713 within baseline";
     lines.push(`  ${label} ${count} implementations  (baseline ${baseline})  ${excess}`);
   }
   if (report.doNotCreate.length > 0) {
@@ -66198,7 +66448,7 @@ function formatMarkdown3(report) {
   for (const cat of PATTERN_CATEGORIES) {
     const stats = report.byCategory[cat];
     const label = CATEGORY_LABELS2[cat];
-    const excess = stats.excess > 0 ? `+${stats.excess}` : "\u2014";
+    const excess = stats.excess > 0 ? `+${stats.excess}` : stats.count === 0 ? "\u2014" : "\xB7";
     lines.push(`| ${label} | ${stats.count} | ${stats.baseline} | ${excess} |`);
   }
   if (report.doNotCreate.length > 0) {
@@ -66253,8 +66503,8 @@ function registerPatterns(program) {
 // src/cli/commands/research.ts
 init_logger();
 init_config2();
-import { existsSync as existsSync28, mkdirSync as mkdirSync15, readFileSync as readFileSync36, writeFileSync as writeFileSync19 } from "fs";
-import { dirname as dirname20, resolve as resolve39 } from "path";
+import { existsSync as existsSync27, mkdirSync as mkdirSync15, readFileSync as readFileSync35, writeFileSync as writeFileSync19 } from "fs";
+import { dirname as dirname18, resolve as resolve39 } from "path";
 function registerResearch(program) {
   const research = program.command("research").description("research commands for the AI UI learning loop");
   research.command("generate").description("generate synthetic UI samples").requiredOption("--count <n>", "number of samples", parseCount).requiredOption("--framework <name>", "target framework").requiredOption("--component-type <type>", "component type").requiredOption("--provider <name>", "AI provider (openai)").option("--api-key <key>", "API key for provider").option("--model <name>", "model name").option("--temperature <n>", "sampling temperature", parseFloat, 0.7).option("--output-dir <path>", "output directory", ".slopbrick/corpus/generated").action(async (cmdOptions) => {
@@ -66277,15 +66527,15 @@ function registerResearch(program) {
   research.command("analyze").description("analyze generated samples and report coverage").requiredOption("--input-dir <path>", "directory with generated samples containing metadata.json").option("--output <path>", "analysis output path", ".slopbrick/flywheel/analysis.json").option("--config <path>", "slopbrick config path").option("--framework <name>", "framework multiplier to apply", "react").action(async (cmdOptions) => {
     try {
       const metadataPath = resolve39(cmdOptions.inputDir, "metadata.json");
-      if (!existsSync28(metadataPath)) {
+      if (!existsSync27(metadataPath)) {
         logger.error(`No metadata.json found in ${cmdOptions.inputDir}`);
         process.exit(2);
       }
-      const samples = JSON.parse(readFileSync36(metadataPath, "utf8"));
+      const samples = JSON.parse(readFileSync35(metadataPath, "utf8"));
       const config = cmdOptions.config ? await loadConfig(cmdOptions.config) : { ...DEFAULT_CONFIG, framework: cmdOptions.framework };
       const analysis = await analyzeSamples(samples, config);
       const outputPath = resolve39(cmdOptions.output);
-      mkdirSync15(dirname20(outputPath), { recursive: true });
+      mkdirSync15(dirname18(outputPath), { recursive: true });
       writeFileSync19(outputPath, JSON.stringify(analysis, null, 2), "utf8");
       logger.info(`Analyzed ${analysis.summary.total} samples; coverage: ${analysis.summary.coverage}%`);
       logger.info(`Wrote analysis to ${outputPath}`);
@@ -66297,11 +66547,11 @@ function registerResearch(program) {
   research.command("candidates").description("extract patterns from generated samples and emit candidate rules").requiredOption("--input-dir <path>", "directory with generated samples containing metadata.json").option("--output <path>", "output path", ".slopbrick/flywheel/rule-candidates.json").option("--config <path>", "slopbrick config path").option("--framework <name>", "framework multiplier to apply", "react").option("--min-frequency <n>", "minimum cluster frequency", parseCount, 2).option("--include-covered", "include samples already covered by AI-specific rules").action(async (cmdOptions) => {
     try {
       const metadataPath = resolve39(cmdOptions.inputDir, "metadata.json");
-      if (!existsSync28(metadataPath)) {
+      if (!existsSync27(metadataPath)) {
         logger.error(`No metadata.json found in ${cmdOptions.inputDir}`);
         process.exit(2);
       }
-      const samples = JSON.parse(readFileSync36(metadataPath, "utf8"));
+      const samples = JSON.parse(readFileSync35(metadataPath, "utf8"));
       const config = cmdOptions.config ? await loadConfig(cmdOptions.config) : { ...DEFAULT_CONFIG, framework: cmdOptions.framework };
       const analysis = await analyzeSamples(samples, config);
       const extraction = extractAndCluster(analysis.samples, {
@@ -66312,7 +66562,7 @@ function registerResearch(program) {
         minFrequency: cmdOptions.minFrequency
       });
       const outputPath = resolve39(cmdOptions.output);
-      mkdirSync15(dirname20(outputPath), { recursive: true });
+      mkdirSync15(dirname18(outputPath), { recursive: true });
       const payload = {
         generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
         sampleCount: analysis.summary.total,
@@ -66333,8 +66583,8 @@ function registerResearch(program) {
 // src/cli/commands/init.ts
 init_logger();
 init_builtins();
-import { existsSync as existsSync29, mkdirSync as mkdirSync16, readFileSync as readFileSync37, writeFileSync as writeFileSync20 } from "fs";
-import { dirname as dirname21, join as join32, resolve as resolve40 } from "path";
+import { existsSync as existsSync28, mkdirSync as mkdirSync16, readFileSync as readFileSync36, writeFileSync as writeFileSync20 } from "fs";
+import { dirname as dirname19, join as join31, resolve as resolve40 } from "path";
 init_scan2();
 init_config2();
 init_threshold();
@@ -66343,7 +66593,7 @@ init_cache();
 
 // src/snippet/targets.ts
 init_generators();
-import { join as join31 } from "path";
+import { join as join30 } from "path";
 var SNIPPET_TARGETS2 = [
   {
     flag: "cursor",
@@ -66437,7 +66687,7 @@ var SNIPPET_TARGETS2 = [
   }
 ];
 function resolveTargetPath(target) {
-  return target.isFolder ? join31(target.path, target.filename) : target.path;
+  return target.isFolder ? join30(target.path, target.filename) : target.path;
 }
 function renderMatrix() {
   const lines = [];
@@ -66460,12 +66710,12 @@ function registerInit(program) {
       process.exit(0);
     }
     const cwd = resolve40(options.workspace ?? process.cwd());
-    const configPath = join32(cwd, "slopbrick.config.mjs");
+    const configPath = join31(cwd, "slopbrick.config.mjs");
     const detected = detectStack(cwd);
     const fallbackConfig = { ...DEFAULT_CONFIG, ...detected };
     const proposed = serializeConfig(fallbackConfig);
-    if (existsSync29(configPath) && !cmdOptions.yes) {
-      const current = readFileSync37(configPath, "utf8");
+    if (existsSync28(configPath) && !cmdOptions.yes) {
+      const current = readFileSync36(configPath, "utf8");
       logger.error(`A config file already exists at ${configPath}.`);
       logger.error("To overwrite it with defaults, run `slopbrick init --yes`.");
       logger.error("");
@@ -66516,11 +66766,11 @@ function registerInit(program) {
       return Boolean(opts[t.flag]);
     });
     for (const target of targetsToWrite) {
-      const snippetPath = join32(cwd, resolveTargetPath(target));
-      mkdirSync16(dirname21(snippetPath), { recursive: true });
+      const snippetPath = join31(cwd, resolveTargetPath(target));
+      mkdirSync16(dirname19(snippetPath), { recursive: true });
       const generated = target.generator(builtinRules);
-      if (!target.isFolder && existsSync29(snippetPath)) {
-        const existing = readFileSync37(snippetPath, "utf8");
+      if (!target.isFolder && existsSync28(snippetPath)) {
+        const existing = readFileSync36(snippetPath, "utf8");
         if (existing.includes("<!-- slopbrick:begin -->")) {
           const updated = existing.replace(
             /<!-- slopbrick:begin -->[\s\S]*?<!-- slopbrick:end -->/,
@@ -66559,11 +66809,11 @@ function registerInit(program) {
 init_logger();
 init_telemetry();
 import { mkdirSync as mkdirSync17, writeFileSync as writeFileSync21 } from "fs";
-import { dirname as dirname22, resolve as resolve41 } from "path";
+import { dirname as dirname20, resolve as resolve41 } from "path";
 
 // src/report/flywheel.ts
-import { existsSync as existsSync30, readFileSync as readFileSync38 } from "fs";
-import { join as join33 } from "path";
+import { existsSync as existsSync29, readFileSync as readFileSync37 } from "fs";
+import { join as join32 } from "path";
 function average(values) {
   if (values.length === 0) return 0;
   return values.reduce((a, b) => a + b, 0) / values.length;
@@ -66623,8 +66873,9 @@ function formatFlywheel(summary, options = {}) {
   if (summary.firstRunAt && summary.latestRunAt) {
     lines.push(`  Window: ${summary.firstRunAt} \u2192 ${summary.latestRunAt}`);
   }
-  lines.push(`  Average slop index: ${summary.averageSlopIndex.toFixed(2)}`);
-  lines.push(`  Latest slop index: ${summary.latestSlopIndex.toFixed(2)}`);
+  const directionNote = "  (lower = cleaner since v0.21.0)";
+  lines.push(`  Average AI Slop Score: ${summary.averageSlopIndex.toFixed(2)}`);
+  lines.push(`  Latest AI Slop Score: ${summary.latestSlopIndex.toFixed(2)}${directionNote}`);
   lines.push(`  Average assembly health: ${summary.averageAssemblyHealth.toFixed(2)}`);
   lines.push(`  Latest assembly health: ${summary.latestAssemblyHealth.toFixed(2)}`);
   if (summary.topViolations.length > 0) {
@@ -66662,7 +66913,7 @@ function registerFlywheel(program) {
     const summary = summarizeTelemetry(payloads);
     if (cmdOptions.export) {
       const exportPath = resolve41(cmdOptions.export);
-      mkdirSync17(dirname22(exportPath), { recursive: true });
+      mkdirSync17(dirname20(exportPath), { recursive: true });
       writeFileSync21(exportPath, JSON.stringify(summary, null, 2), "utf-8");
       logger.info(`Wrote flywheel summary to ${exportPath}`);
       process.exit(0);
@@ -66690,8 +66941,8 @@ init_dist2();
 init_memory_io();
 
 // src/fix/focus-ring.ts
-import { existsSync as existsSync31 } from "fs";
-import { readFileSync as readFileSync39, writeFileSync as writeFileSync22 } from "fs";
+import { existsSync as existsSync30 } from "fs";
+import { readFileSync as readFileSync38, writeFileSync as writeFileSync22 } from "fs";
 var ANCHOR_START = "/* @slopbrick:v1.0.0:fix:focus-ring */";
 var CSS_BLOCK = `/* @slopbrick:v1.0.0:fix:focus-ring */
 :focus-visible {
@@ -66700,10 +66951,10 @@ var CSS_BLOCK = `/* @slopbrick:v1.0.0:fix:focus-ring */
 }
 /* @slopbrick:v1.0.0:fix:focus-ring-end */`;
 function applyFocusRingFix(targetFile) {
-  if (!existsSync31(targetFile)) {
+  if (!existsSync30(targetFile)) {
     return { applied: false, reason: "missing-global-css-target" };
   }
-  const content = readFileSync39(targetFile, "utf-8");
+  const content = readFileSync38(targetFile, "utf-8");
   if (content.includes(ANCHOR_START)) {
     return { applied: false, reason: "already-present" };
   }
@@ -66717,9 +66968,9 @@ function applyFocusRingFix(targetFile) {
 init_layout_token();
 
 // src/fix/use-client.ts
-import { readFileSync as readFileSync40, writeFileSync as writeFileSync23 } from "fs";
+import { readFileSync as readFileSync39, writeFileSync as writeFileSync23 } from "fs";
 function applyUseClientFix(filePath) {
-  const content = readFileSync40(filePath, "utf-8");
+  const content = readFileSync39(filePath, "utf-8");
   const trimmed = content.trimStart();
   if (trimmed.startsWith("'use client'") || trimmed.startsWith('"use client"')) {
     return { applied: false, reason: "already-present" };
@@ -66731,7 +66982,7 @@ ${content}`);
 }
 
 // src/fix/visual-codemod.ts
-import { readFileSync as readFileSync41, writeFileSync as writeFileSync24 } from "fs";
+import { readFileSync as readFileSync40, writeFileSync as writeFileSync24 } from "fs";
 
 // src/fix/visual-codemods/tailwind.ts
 var ARBITRARY_ESCAPE_RE = /\b(p|m|px|py|pt|pb|pl|pr|mx|my|mt|mb|ml|mr|gap|space-[xy]|w|h|min-w|max-w|min-h|max-h|text-\w+|leading-\w+|rounded|border)-?\[(-?\d+(?:\.\d+)?)(px|rem|em|%|vh|vw)?\]/g;
@@ -66940,7 +67191,7 @@ var ALL_CODEMODS = [
   { name: "aria-attr-typo", fn: applyAriaAttrTypoCodemod }
 ];
 function applyVisualCodemods(filePath) {
-  const original = readFileSync41(filePath, "utf-8");
+  const original = readFileSync40(filePath, "utf-8");
   let content = original;
   const reasons = [];
   const seen = /* @__PURE__ */ new Set();
@@ -66971,7 +67222,7 @@ function applyVisualCodemods(filePath) {
 function collectAllFixes2(issue) {
   return [...issue.fix ? [issue.fix] : [], ...issue.fixes ?? []];
 }
-async function applyFixes(report, config, scannedFiles) {
+async function applyFixes(report, _config, scannedFiles) {
   const byFile = /* @__PURE__ */ new Map();
   for (const issue of report.issues) {
     const fixes = collectAllFixes2(issue);
@@ -67032,7 +67283,6 @@ async function applyFixes(report, config, scannedFiles) {
         const result = applyLayoutTokenFix(filePath, group.replaces);
         const total = group.replaceApps.length;
         const appliedCount = Math.min(result.applied, total);
-        const skippedCount = total - appliedCount;
         applied.push(...group.replaceApps.slice(0, appliedCount));
         skipped.push(...group.replaceApps.slice(appliedCount));
       } catch (err) {
@@ -67227,6 +67477,40 @@ function formatGroupedHelp(cmd) {
     }
   }
   lines.push("");
+  lines.push(
+    "Commands (run `<command> --help` for per-command details):\n" + [
+      "  scan     score a workspace, with severity gating and report views",
+      "  pr       score a PR (or a unified-diff file via `--diff <file>`)",
+      "  drift    detect constitution / forbidden-package violations",
+      "  test     test quality sub-score (CI gate)",
+      "  docs     documentation freshness sub-score",
+      "  security AI security-risk sub-score",
+      "  rules    list all built-in rules with categories and severities",
+      "  explain  show rationale, pattern, and remediation for a single rule",
+      "  suggest  print per-issue remediation advice",
+      "  badge    print a shields.io slop-index badge",
+      "  doctor   check setup, config, and environment for common problems",
+      "  init     create a slopbrick config file and AGENTS.md/CLAUDE.md snippets",
+      "  flywheel  summarize aggregated scan telemetry",
+      "  composite empirical-composite rule discover / enable (Sprint 3 \xA73b)",
+      "  calibrate empirical precision/recall/F1 calibration from held-out corpora",
+      "  patterns  pattern-fragmentation sub-score",
+      "  business-logic  business-logic coherence sub-score",
+      "  maintenance-cost  AI maintenance-cost sub-score",
+      "  architecture architecture-consistency sub-score",
+      "  memory   show patterns detected for `slop_suggest`",
+      "  lock     install a git pre-commit hook (idempotent)",
+      "  migrate  v0.10.x slop-audit/ \u2192 v0.11.0+ .slopbrick/ migration",
+      "  validate-config  validate slopbrick.config.mjs",
+      "  tokens   merge a design-tokens.json layout values into the allowlist",
+      "  report   re-render a saved JSON report (from --json <path>)",
+      "  install / uninstall  manage the git pre-commit hook",
+      "  mcp       run the MCP server (JSON-RPC 2.0 over stdio)",
+      "  watch / --watch  re-run scan on file change",
+      "  trend     sparkline of the last n runs"
+    ].join("\n")
+  );
+  lines.push("");
   lines.push(
     "Use `--help-flat` for the standard un-grouped list. See `https://usebrick.dev/docs/scan-options` for full docs."
   );
@@ -67344,7 +67628,7 @@ process.on("uncaughtException", (err) => {
 });
 async function runCli({ start }) {
   try {
-    const program = new Command().name("slopbrick").description("Repository Coherence Scanner \u2014 surface AI-induced pattern drift, secret leaks, and design-token violations").version(VERSION).option("--framework <name>", "framework multiplier to apply").option("--include <glob>", "include pattern (repeatable)", collectGlob, []).option("--exclude <glob>", "exclude pattern (repeatable)", collectGlob, []).option("--ai-only", "only report AI-specific issues").option("--human-only", "only report human-facing issues").option("--ignore-wcag22", "ignore WCAG 2.2 related issues").option("--format <pretty|json|sarif|html>", "output format", "pretty").option("--threads <n>", "number of worker threads", parseThreads).option("--since <ref>", "only scan files changed since git ref").option("--diff <ref>", "alias for --since <ref>; also adds PR Slop Score to the report").option("--workspace <path>", "workspace/project path", process.cwd()).option("--tighten", "tighten baseline allowances").option("--fix", "apply auto-fixes").option("--dry-run", "with --fix: print what would change without writing").option("--show-fixes-diff", "print unified diff of proposed auto-fixes").option("--doctor", "run diagnostics").option("--watch", "watch files and re-run").option("--suggest", "print remediation advice").option("--why-failing", "print the top 5 rules dragging the score down").option("--brief", "terse output (verdict + headline + threshold + delta only)").option("--heatmap", "print migration ROI heatmap").option("--quiet", "suppress non-error output").option("--verbose", "enable debug logging (file paths, timings, rule-fire counts)").option("--strict", "exit 2 if any high-severity issue remains").option("--no-increase", "exit 2 if slop index increased since last run").option("--refresh-snippets", "rewrite the managed slopbrick block in AGENTS.md and CLAUDE.md after a scan").option("--baseline", "save a baseline after this scan").option("--trend [n]", "print a sparkline of the last n runs", parseTrend).option("--json [path]", "write JSON report to path or stdout").option("--html [path]", "write HTML report to path or stdout").option("--staged", "scan only changed files (staged and unstaged)").option("--changed", "scan working-tree changes (staged + unstaged + untracked)").option("--incremental", "skip unchanged files using the persisted hash cache").option("--cache-path <path>", "path to the incremental-scan cache (default: .slopbrick-cache.json)").option("--tokens <path>", "merge tokens.json layout values into the arbitrary-value allowlist").option("--cache", "cache parsed AST results locally").option("--no-color", "suppress ANSI color codes in output").option("--security-only", "run only the security/* rules").option("--full", "show the complete report (all issues, all categories)").option("--report-usage", "opt in to a one-shot usage ping to SLOPBRICK_TELEMETRY_ENDPOINT (no PII)");
+    const program = new Command().name("slopbrick").description("Repository Coherence Scanner \u2014 surface AI-induced pattern drift, secret leaks, and design-token violations").version(VERSION).option("--framework <name>", "framework multiplier to apply").option("--include <glob>", "include pattern (repeatable)", collectGlob, []).option("--exclude <glob>", "exclude pattern (repeatable)", collectGlob, []).option("--ai-only", "only report AI-specific issues").option("--human-only", "only report human-facing issues").option("--ignore-wcag22", "ignore WCAG 2.2 related issues").option("--format <pretty|json|sarif|html>", "output format", "pretty").option("--threads <n>", "number of worker threads", parseThreads).option("--since <ref>", "only scan files changed since git ref").option("--diff <ref>", "alias for --since <ref>; also adds PR Slop Score to the report").option("--workspace <path>", "workspace/project path", process.cwd()).option("--tighten", "tighten baseline allowances").option("--fix", "apply auto-fixes").option("--dry-run", "with --fix: print what would change without writing").option("--show-fixes-diff", "print unified diff of proposed auto-fixes").option("--doctor", "run diagnostics").option("--watch", "watch files and re-run").option("--suggest", "print remediation advice").option("--why-failing", "print the top 5 rules dragging the score down").option("--brief", "terse output (verdict + headline + threshold + delta only)").option("--heatmap", "print migration ROI heatmap").option("--quiet", "suppress non-error output").option("--verbose", "enable debug logging (file paths, timings, rule-fire counts)").option("--strict", "exit 2 if any high-severity issue remains").option("--no-increase", "exit 2 if AI Slop Score increased since last run (lower = cleaner since v0.21)").option("--refresh-snippets", "rewrite the managed slopbrick block in AGENTS.md and CLAUDE.md after a scan").option("--baseline", "save a baseline after this scan").option("--trend [n]", "print a sparkline of the last n runs", parseTrend).option("--json [path]", "write JSON report to path or stdout").option("--html [path]", "write HTML report to path or stdout").option("--staged", "scan only changed files (staged and unstaged)").option("--changed", "scan working-tree changes (staged + unstaged + untracked)").option("--incremental", "skip unchanged files using the persisted hash cache").option("--cache-path <path>", "path to the incremental-scan cache (default: .slopbrick-cache.json)").option("--tokens <path>", "merge tokens.json layout values into the arbitrary-value allowlist").option("--cache", "cache parsed AST results locally").option("--no-color", "suppress ANSI color codes in output").option("--security-only", "run only the security/* rules").option("--full", "show the complete report (all issues, all categories)").option("--report-usage", "opt in to a one-shot usage ping to SLOPBRICK_TELEMETRY_ENDPOINT (no PII)");
     program.helpInformation = () => formatGroupedHelp(program);
     setExitOverride(program);
     registerInit(program);
@@ -67425,20 +67709,20 @@ async function runCli({ start }) {
         const gitHead = await getGitHead(cwd2) ?? "unknown";
         const cache = buildBaselineCache(report, configHash, gitHead, cwd2);
         saveBaseline(cwd2, cache);
-        if (!options.quiet) {
+        if (!options.quiet && !machineReadableStdout) {
           logger.info(`Saved baseline to ${baselinePath(cwd2)}`);
         }
       }
       if (options.tighten && baseline) {
         saveBaseline(cwd, baseline);
-        if (!options.quiet) {
+        if (!options.quiet && !machineReadableStdout) {
           logger.info(`Tightened baseline saved (revision ${baseline.baseline_revision}).`);
         }
       }
-      if (options.doctor && !options.quiet) {
+      if (options.doctor && !options.quiet && !machineReadableStdout) {
         logger.info(`Doctor: bootstrap ${totalElapsed - scanElapsed}ms, scan ${scanElapsed}ms`);
       }
-      if (report.baseline && !options.quiet) {
+      if (report.baseline && !options.quiet && !machineReadableStdout) {
         logger.info(baselineStatusMessage(report.baseline));
       }
       if (options.fix) {
@@ -67452,7 +67736,7 @@ async function runCli({ start }) {
         }
         const scannedFiles = results.map((r) => r.filePath);
         const fixResults = await applyFixes(report, config, scannedFiles);
-        const { totalApplied, totalSkipped, hasErrors } = printFixSummary(fixResults, options.quiet ?? false);
+        const { hasErrors } = printFixSummary(fixResults, options.quiet ?? false);
         if (!options.showFixesDiff && !options.quiet) {
           logger.info("Tip: pass --show-fixes-diff to see the unified diff of proposed changes.");
         }
@@ -67492,8 +67776,18 @@ async function runCli({ start }) {
         if (options.staged && stagedGatingResult.reason) {
           logger.error(`Gating failure: ${stagedGatingResult.reason}`);
         } else {
-          const failed = failedThresholdCount(report, config);
-          logger.error(`${failed} threshold${failed === 1 ? "" : "s"} failed. See details above.`);
+          const failedNames = failedThresholds(report, config);
+          const detail = failedNames.map((name) => {
+            if (name === "meanSlop") return `meanSlop (score ${report.aiSlopScore} > ${config.thresholds.meanSlop})`;
+            if (name === "p90Slop") return `p90Slop (score ${report.p90Score} > ${config.thresholds.p90Slop})`;
+            if (name === "individualSlopThreshold") return `individualSlopThreshold (peak ${report.peakScore} > ${config.thresholds.individualSlopThreshold})`;
+            const cat = name.replace(/^category:/, "");
+            const limit = config.thresholds.categoryThresholds?.[cat];
+            const score = report.categoryScores[cat];
+            return `${name} (score ${score} > ${limit})`;
+          }).join(", ");
+          const failed = failedNames.length;
+          logger.error(`${failed} threshold${failed === 1 ? "" : "s"} failed: ${detail}`);
         }
       }
       if (!options.quiet && !machineReadableStdout) {
@@ -67590,6 +67884,7 @@ export {
   directoryScore,
   extractSignatures,
   failedThresholdCount,
+  failedThresholds,
   filterByDisabledDirectives,
   filterIssues,
   findSimilarFunctions,