slopbrick 0.20.0 → 0.21.0

package/dist/index.cjs

@@ -36,7 +36,7 @@ var VERSION;
 var init_header = __esm({
   "src/types/_header.ts"() {
     "use strict";
-    VERSION = "0.20.0";
+    VERSION = "0.21.0";
   }
 });
 
@@ -25938,8 +25938,8 @@ var init_comment_ratio = __esm({
     init_rule();
     init_corpus_baselines2();
     MIN_FILE_LINES = 20;
-    FALLBACK_LOW = 0.05;
-    FALLBACK_HIGH = 0.45;
+    FALLBACK_LOW = 0.02;
+    FALLBACK_HIGH = 0.55;
     LINE_COMMENT_RE = /^\s*(?:\/\/|#|--|;|%)/;
     BLOCK_COMMENT_OPEN_RE = /\/\*/;
     aiCommentRatioRule = createRule({
@@ -26082,9 +26082,9 @@ var init_compression_profile = __esm({
     init_rule();
     init_ncd_compression();
     MIN_BYTES = 2e3;
-    GZIP_RATIO_AI_THRESHOLD = 0.5;
-    MEAN_LINE_NCD_HUMAN_MAX = 0.3;
-    NCD_CV_AI_MAX = 0.5;
+    GZIP_RATIO_AI_THRESHOLD = 0.6;
+    MEAN_LINE_NCD_HUMAN_MAX = 0.25;
+    NCD_CV_AI_MAX = 0.4;
     aiCompressionProfileRule = createRule({
       id: "ai/compression-profile",
       category: "ai",
@@ -26253,6 +26253,13 @@ var init_default_react_stack = __esm({
       category: "ai",
       severity: "low",
       aiSpecific: true,
+      // v0.20.0 calibration: v8.5 verdict = USEFUL but recall 0.001
+      // (fires 1 time per 1,000 files). The "≥3 of default stack"
+      // threshold catches almost nothing on real codebases — the
+      // default stack is now ubiquitous, so the signal is near-zero.
+      // Disable until the threshold is lowered or the rule is split
+      // into per-library detectors.
+      defaultOff: true,
       description: "File uses \u22653 of the default React stack (Next.js + TanStack Query + Zustand + shadcn/ui) \u2014 Sascha 2025 + Nam et al. MSR 2026",
       create(context) {
         return context;
@@ -26526,6 +26533,10 @@ var init_library_reinvention = __esm({
       category: "ai",
       severity: "medium",
       aiSpecific: true,
+      // v0.20.0 calibration: v8.5 verdict = USEFUL but recall 0.000
+      // (fires never on the corpus). The "≥2 reinvented patterns"
+      // threshold is too strict. Disable until rewritten.
+      defaultOff: true,
       description: "File reinvents \u22652 common patterns (date picker, form validation, chart, modal, etc.) without importing the canonical library \u2014 GitClear 2025 + Cui et al. 2025",
       create(context) {
         return context;
@@ -26732,6 +26743,12 @@ var init_markdown_leakage = __esm({
       category: "ai",
       severity: "high",
       aiSpecific: true,
+      // v0.20.0 calibration: v8.5 verdict = INVERTED (lift 65,504× but
+      // recall 0.000 — fires never on the corpus, and when it does fire
+      // it's wrong). The rule was on by default, contributing false
+      // positives to the self-scan. Disable until the rule is rewritten
+      // or the v9 corpus shows it works.
+      defaultOff: true,
       description: "Stray Markdown fence or bare language name at top of file \u2014 AI tools leak the fenced-block format into code",
       create(context) {
         return context;
@@ -27206,6 +27223,11 @@ var init_text_like_ratio = __esm({
       category: "ai",
       severity: "low",
       aiSpecific: true,
+      // v0.20.0 calibration: v8.5 verdict = USEFUL but recall 0.000
+      // (fires never on the corpus). The rule is too specific to ever
+      // fire on real code — the prose-detection heuristic is too
+      // conservative. Disable until rewritten.
+      defaultOff: true,
       description: "High ratio of prose-like lines embedded in code \u2014 AI tools often leave natural-language explanations in source files (Yotkova 2026)",
       create(context) {
         return context;
@@ -28433,7 +28455,7 @@ function collectExports(cwd) {
       /\bexport\s+default\s+(?:function\s+|class\s+)?([A-Za-z_$][\w$]*)/g,
       // v0.18.6: also collect field names from `export interface` and
       // `export type` declarations. Without this, fields like
-      // `crossFileDrift`, `aiQuality`, `engineeringHygiene` are
+      // `crossFileDrift`, `aiSlopScore`, `engineeringHygiene` are
       // flagged as stale even though they're valid type fields.
       /^\s*(?:readonly\s+)?([A-Za-z_$][\w$]*)\s*[?:]/gm
     ]) {
@@ -30100,6 +30122,9 @@ var init_gap_monopoly = __esm({
     GAP_RE = /\bgap(?:-x|-y)?-(\d+)\b/g;
     gapMonopolyRule = createRule({
       id: "layout/gap-monopoly",
+      // v0.20.0 calibration: recall 0.000, fires never. Disable
+      // until rewritten.
+      defaultOff: true,
       category: "layout",
       severity: "medium",
       aiSpecific: false,
@@ -30212,6 +30237,9 @@ var init_math_grid_uniformity = __esm({
     GRID_COLS_RE = /\bgrid-cols-(\d+)\b/g;
     mathGridUniformityRule = createRule({
       id: "layout/math-grid-uniformity",
+      // v0.20.0 calibration: recall 0.000, fires never. Disable
+      // until rewritten.
+      defaultOff: true,
       category: "layout",
       severity: "high",
       aiSpecific: true,
@@ -30324,6 +30352,9 @@ var init_spacing_grid = __esm({
     ]);
     spacingGridRule = createRule({
       id: "layout/spacing-grid",
+      // v0.20.0 calibration: recall 0.000, fires never. Disable
+      // until rewritten.
+      defaultOff: true,
       category: "layout",
       severity: "medium",
       aiSpecific: false,
@@ -30447,15 +30478,9 @@ var init_boundary_violation = __esm({
         if (context.supportsRsc === false) return [];
         if (!facts.v2) return [];
         const issues = [];
-        const hookLines = /* @__PURE__ */ new Map();
-        for (const h of facts.v2.logic.hooks) {
-          const arr = hookLines.get(h.name) ?? [];
-          arr.push({ line: h.line, column: h.column });
-          hookLines.set(h.name, arr);
-        }
         for (const component of facts.v2.components) {
           if (!component.isServerComponent) continue;
-          for (const hook of facts.v2.logic.hooks) {
+          for (const hook of component.hookCalls) {
             if (!context.clientHooks.has(hook.name)) continue;
             issues.push({
               ruleId: "logic/boundary-violation",
@@ -30463,8 +30488,8 @@ var init_boundary_violation = __esm({
               severity: "high",
               aiSpecific: true,
               message: `'${hook.name}' only works in interactive client components. This component runs on the server.`,
-              line: component.line,
-              column: component.column,
+              line: hook.line,
+              column: hook.column,
               advice: "Add the 'use client' directive at the top of this file, or move the stateful part to a separate client component.",
               fix: {
                 kind: "insert",
@@ -34719,7 +34744,7 @@ function isHealthFile(value) {
   if (!isVersion3(value.version)) return false;
   if (typeof value.generatedAt !== "string") return false;
   if (typeof value.workspace !== "string") return false;
-  if (!isNumber(value.aiQuality)) return false;
+  if (!isNumber(value.aiSlopScore)) return false;
   if (!isNumber(value.engineeringHygiene)) return false;
   if (!isNumber(value.security)) return false;
   if (!isNumber(value.repositoryHealth)) return false;
@@ -34882,7 +34907,7 @@ var init_dist = __esm({
     import_fs = require("fs");
     import_path = require("path");
     init_zod();
-    STRUCTURE_SCHEMA_VERSION = "3";
+    STRUCTURE_SCHEMA_VERSION = "5";
     INVENTORY_FILENAME = "inventory.json";
     CONSTITUTION_FILENAME = "constitution.json";
     CACHE_FILENAME = "cache.json";
@@ -35340,11 +35365,11 @@ async function appendRun(cwd, report, version, io, thresholdExceeded2) {
   const run2 = {
     timestamp: report.generatedAt,
     version,
-    slopIndex: report.aiQuality,
+    slopIndex: report.aiSlopScore,
     // MemoryAuditRun keeps slopIndex as a historical legacy field
     categoryScores: { ...report.categoryScores },
     topOffenseIds: topOffenseIds(report),
-    thresholdExceeded: thresholdExceeded2 ?? report.aiQuality > 0
+    thresholdExceeded: thresholdExceeded2 ?? report.aiSlopScore > 0
   };
   runs.push(run2);
   if (runs.length > MAX_RUNS) {
@@ -35476,7 +35501,7 @@ function buildHealthFromReport(report, workspace, options = {}) {
     version: STRUCTURE_SCHEMA_VERSION,
     generatedAt: report.generatedAt,
     workspace,
-    aiQuality: Math.round(report.aiQuality),
+    aiSlopScore: Math.round(report.aiSlopScore),
     engineeringHygiene: Math.round(report.engineeringHygiene),
     security: Math.round(report.security),
     repositoryHealth: Math.round(report.repositoryHealth),
@@ -40373,7 +40398,12 @@ var init_weak_assertion = __esm({
       "toBeUndefined",
       "toBeTruthy",
       "toBeFalsy",
-      "toBeNull"
+      "toBeNull",
+      "toBeGreaterThan",
+      "toBeLessThan",
+      "toContain",
+      "toHaveLength",
+      "toBeInstanceOf"
     ]);
   }
 });
@@ -41340,6 +41370,10 @@ var init_math_color_cluster = __esm({
     HEX_COLOR_RE = /#([0-9a-fA-F]{6}|[0-9a-fA-F]{3})\b/g;
     mathColorClusterRule = createRule({
       id: "visual/math-color-cluster",
+      // v0.20.0 calibration: recall 0.000, fires never. The
+      // "math-color cluster" heuristic is too specific to ever fire
+      // on real code. Disable until rewritten.
+      defaultOff: true,
       category: "visual",
       severity: "high",
       aiSpecific: true,
@@ -41401,6 +41435,9 @@ var init_math_default_font = __esm({
     NEXT_FONT_IMPORT_RE = /import\s+.*from\s+['"]next\/font\/(?:google|local)['"]/;
     mathDefaultFontRule = createRule({
       id: "visual/math-default-font",
+      // v0.20.0 calibration: recall 0.001, fires 1 per 1,000 files.
+      // Too specific to be useful. Disable until rewritten.
+      defaultOff: true,
       category: "visual",
       severity: "high",
       aiSpecific: true,
@@ -41476,6 +41513,9 @@ var init_math_font_entropy = __esm({
     TEXT_SIZE_RE = /\btext-(?:xs|sm|base|lg|xl|2xl|3xl|4xl|5xl|6xl)\b/g;
     mathFontEntropyRule = createRule({
       id: "visual/math-font-entropy",
+      // v0.20.0 calibration: recall 0.004, fires 0 times on self-scan
+      // (verified). Disable until rewritten.
+      defaultOff: true,
       category: "visual",
       severity: "high",
       aiSpecific: true,
@@ -41616,6 +41656,10 @@ var init_math_rounded_entropy = __esm({
     ROUNDED_RE = /\brounded(?:-none|-sm|-md|-lg|-xl|-2xl|-3xl|-full)?\b/g;
     mathRoundedEntropyRule = createRule({
       id: "visual/math-rounded-entropy",
+      // v0.20.0 calibration: recall 0.004, fires 0 times on self-scan
+      // (verified). The entropy heuristic is too specific to ever fire
+      // on real code. Disable until rewritten.
+      defaultOff: true,
       category: "visual",
       severity: "high",
       aiSpecific: true,
@@ -41665,6 +41709,9 @@ var init_math_spacing_entropy = __esm({
     SPACING_PREFIX_RE2 = /\b(p|px|py|pt|pb|pl|pr|m|mx|my|mt|mb|ml|mr|gap|gap-x|gap-y)-(\d+)\b/g;
     mathSpacingEntropyRule = createRule({
       id: "visual/math-spacing-entropy",
+      // v0.20.0 calibration: recall 0.002, fires 0 times on self-scan
+      // (verified). Disable until rewritten.
+      defaultOff: true,
       category: "visual",
       severity: "medium",
       aiSpecific: true,
@@ -44510,7 +44557,7 @@ var init_naturalness_anomaly = __esm({
     init_dist2();
     init_visitor();
     MIN_LENGTH = 50;
-    DISTINCT_RATIO_FLOOR = 0.3;
+    DISTINCT_RATIO_FLOOR = 0.2;
     naturalnessAnomalyRule = createRule({
       id: "visual/naturalness-anomaly",
       category: "visual",
@@ -44586,6 +44633,9 @@ var init_radius_scale_violation = __esm({
     SCALE_TOLERANCE = 1e-3;
     radiusScaleViolationRule = createRule({
       id: "visual/radius-scale-violation",
+      // v0.20.0 calibration: recall 0.000, fires never. Disable
+      // until rewritten.
+      defaultOff: true,
       category: "visual",
       severity: "medium",
       aiSpecific: false,
@@ -44762,6 +44812,10 @@ var init_dragging_movements = __esm({
     ALT_ROLE_RE = /^(?:button|application|tab|menuitem)$/;
     draggingMovementsRule = createRule({
       id: "wcag/dragging-movements",
+      // v0.20.0 calibration: v8.5 = DORMANT but defaultOff: false
+      // was a bug — DORMANT rules should be off by default. The
+      // rule was contributing 0 useful fires. Disable.
+      defaultOff: true,
       category: "wcag",
       severity: "medium",
       aiSpecific: false,
@@ -44931,6 +44985,11 @@ var init_missing_alt = __esm({
     HAS_PRESENTATION_ROLE_RE = /\brole\s*=\s*["'](?:presentation|none)["']/i;
     missingAltRule = createRule({
       id: "wcag/missing-alt",
+      // v0.20.0 calibration: lift 1.0, recall 0.000. Lift of 1.0
+      // means the rule has zero discriminative power — it fires
+      // equally on positive and negative examples. Dead rule.
+      // Disable until rewritten.
+      defaultOff: true,
       category: "wcag",
       severity: "medium",
       aiSpecific: false,
@@ -46260,17 +46319,11 @@ function colorForSlop(slopIndex) {
   if (slopIndex >= SLOP_BADGE_YELLOW_THRESHOLD) return "yellow";
   return "green";
 }
-function colorForQuality(score) {
-  if (score >= SLOP_BADGE_RED_THRESHOLD) return "green";
-  if (score >= SLOP_BADGE_ORANGE_THRESHOLD) return "yellow";
-  if (score >= SLOP_BADGE_YELLOW_THRESHOLD) return "orange";
-  return "red";
-}
 function formatBadge(report) {
-  const score = report.aiQuality ?? 0;
+  const score = report.aiSlopScore ?? 0;
   const rounded = Math.round(score);
-  const color = colorForQuality(score);
-  return `[![Repository Health](https://img.shields.io/badge/repository--health-${rounded}-${color})](https://github.com/usebrick/platform)`;
+  const color = colorForSlop(score);
+  return `[![AI Slop](https://img.shields.io/badge/ai--slop-${rounded}-${color})](https://github.com/usebrick/platform)`;
 }
 function formatSparkline(values) {
   if (values.length === 0) return "";
@@ -46399,18 +46452,25 @@ function scoreBand(score) {
   if (score >= 40) return { label: "needs work", color: import_chalk.default.yellow };
   return { label: "concerning", color: import_chalk.default.red };
 }
+function slopScoreBand(score) {
+  if (score >= 70) return { label: "saturated", color: import_chalk.default.red };
+  if (score >= 50) return { label: "high", color: import_chalk.default.red };
+  if (score >= 30) return { label: "medium", color: import_chalk.default.yellow };
+  if (score >= 10) return { label: "low", color: import_chalk.default.green };
+  return { label: "no slop", color: import_chalk.default.green };
+}
 function formatDeltaSuffix(report) {
   if (typeof report.previousSlopIndex !== "number") return "";
-  const delta = report.aiQuality - report.previousSlopIndex;
+  const delta = report.aiSlopScore - report.previousSlopIndex;
   if (Math.abs(delta) < 0.5) return "";
   const arrow = delta < 0 ? "\u2193" : "\u2191";
   const absDelta = Math.abs(delta).toFixed(0);
-  const word = delta > 0 ? "cleaner" : "worse";
-  const color = delta > 0 ? import_chalk.default.green : import_chalk.default.red;
+  const word = delta < 0 ? "cleaner" : "worse";
+  const color = delta < 0 ? import_chalk.default.green : import_chalk.default.red;
   return color(`  ${arrow}${absDelta} (${word})`);
 }
 function formatVerdict(report) {
-  const score = report.aiQuality;
+  const score = report.aiSlopScore;
   const band = scoreBand(score);
   const ranked = rankByImpact(report.issues);
   const topRule = ranked[0];
@@ -46494,7 +46554,7 @@ function formatNextStep(report) {
       `  \u2192 \`slopbrick scan --baseline\` to accept today's scores as the new floor`
     )
   );
-  if (report.aiQuality < 70) {
+  if (report.aiSlopScore > 30) {
     lines.push(
       import_chalk.default.dim(
         `  \u2192 \`slopbrick scan --why-failing\` for the top 5 issues dragging the score down`
@@ -46518,11 +46578,11 @@ function formatWhyFailing(report) {
   if (ranked.length === 0) {
     return import_chalk.default.green("Nothing is failing the threshold. Score is clean.");
   }
-  const headline = report.aiQuality;
-  const status = headline >= 70 ? "PASS" : "FAIL";
-  const colorize = headline >= 70 ? import_chalk.default.green : import_chalk.default.red;
+  const headline = report.aiSlopScore;
+  const status = headline <= 30 ? "PASS" : "FAIL";
+  const colorize = headline <= 30 ? import_chalk.default.green : import_chalk.default.red;
   const lines = [];
-  lines.push(colorize.bold(`Headline score: ${headline.toFixed(0)}/100 (${status} \u2014 below 70)`));
+  lines.push(colorize.bold(`Headline score: ${headline.toFixed(0)}/100 (${status} \u2014 above 30)`));
   lines.push("");
   lines.push(import_chalk.default.bold("Top 5 rules dragging the score down:"));
   for (let i = 0; i < ranked.length; i++) {
@@ -46546,30 +46606,42 @@ function severityBadge(severity) {
   const label = severity.toUpperCase().padEnd(8, " ");
   return colorize(label);
 }
+function scoreToMessage(score, type) {
+  const tiers = SCORE_MESSAGES[type] ?? [];
+  for (const [threshold, message] of tiers) {
+    if (score >= threshold) return message;
+  }
+  const last = tiers[tiers.length - 1];
+  return last ? last[1] : "Score unavailable";
+}
 function formatCompositeScore(report) {
-  const slop = report.aiQuality;
+  const slop = report.aiSlopScore;
   const slopValue = slop.toFixed(0).padStart(3, " ");
-  const band = scoreBand(slop);
+  const band = slopScoreBand(slop);
   const status = import_chalk.default.bold(`[${band.label.toUpperCase()}]`);
   const lines = [];
   const deltaSuffix = formatDeltaSuffix(report);
   lines.push(
-    import_chalk.default.bold(`AI Quality: ${slopValue} / 100 ${band.color(status)}${deltaSuffix}`)
+    import_chalk.default.bold(`AI Slop Score: ${slopValue} / 100 ${band.color(status)}${deltaSuffix}`)
   );
+  lines.push(`  ${import_chalk.default.dim(scoreToMessage(slop, "slop"))}`);
   lines.push(
     import_chalk.default.dim(
-      "higher = better \xB7 measures AI-slop signatures. The same number in .slopbrick/health.json."
+      "lower = cleaner \xB7 measures AI-slop signatures (0 = no AI slop detected, 100 = max AI slop). The rules are calibrated to detect AI patterns, so this measures how much AI-style fingerprint the codebase has. Same number in .slopbrick/health.json."
     )
   );
   lines.push(
     `  \u251C\u2500 boundary: ${report.boundaryScore.toFixed(0).padStart(3, " ")}  (40%)  ${import_chalk.default.dim("\u2014 structural integrity")}`
   );
+  lines.push(`  \u2502           ${import_chalk.default.dim(scoreToMessage(report.boundaryScore, "boundary"))}`);
   lines.push(
     `  \u251C\u2500 context:  ${report.contextScore.toFixed(0).padStart(3, " ")}  (35%)  ${import_chalk.default.dim("\u2014 props / state / imports")}`
   );
+  lines.push(`  \u2502           ${import_chalk.default.dim(scoreToMessage(report.contextScore, "context"))}`);
   lines.push(
     `  \u2514\u2500 visual:   ${report.visualScore.toFixed(0).padStart(3, " ")}  (25%)  ${import_chalk.default.dim("\u2014 CSS / a11y / layout")}`
   );
+  lines.push(`              ${import_chalk.default.dim(scoreToMessage(report.visualScore, "visual"))}`);
   const coherence = report.coherence;
   if (typeof coherence === "number") {
     const coherenceValue = coherence.toFixed(0).padStart(3, " ");
@@ -46586,25 +46658,52 @@ function formatCompositeScore(report) {
 function formatCoherenceScores(report) {
   const lines = [];
   const domains = [
-    { key: "codeHygiene", label: "Code Hygiene" },
-    { key: "accessibility", label: "Accessibility" },
-    { key: "performance", label: "Performance" }
+    {
+      key: "codeHygiene",
+      label: "Code Hygiene",
+      measure: "issues per category across arch/logic/layout/component/test",
+      direction: "higher"
+    },
+    {
+      key: "accessibility",
+      label: "Accessibility",
+      measure: "WCAG violations, ARIA misuse, focus management",
+      direction: "higher"
+    },
+    {
+      key: "performance",
+      label: "Performance",
+      measure: "render-blocking, N+1 queries, bundle bloat",
+      direction: "higher"
+    }
   ];
-  for (const { key, label } of domains) {
+  for (const { key, label, measure, direction } of domains) {
     const value = report[key];
     if (typeof value === "number") {
       const padded = value.toString().padStart(3, " ");
-      lines.push(`${label.padEnd(20)} ${padded}/100`);
+      const arrow = direction === "higher" ? "\u2191" : "\u2193";
+      lines.push(
+        `${label.padEnd(20)} ${padded}/100  (${arrow} ${direction} = better \xB7 ${measure})`
+      );
+      const messageType = key === "codeHygiene" ? "hygiene" : key === "accessibility" ? "accessibility" : key === "performance" ? "performance" : "hygiene";
+      lines.push(`${"".padEnd(20)} ${import_chalk.default.dim(scoreToMessage(value, messageType))}`);
     }
   }
   const bl = report.businessLogicCoherence;
   if (typeof bl === "number") {
     const blValue = bl.toString().padStart(3, " ");
-    lines.push(`${"Business Logic".padEnd(20)} ${blValue}/100`);
+    lines.push(
+      `${"Business Logic".padEnd(20)} ${blValue}/100  (\u2191 higher = better \xB7 tangled dependencies, cyclic imports, god modules)`
+    );
   }
   if (report.aiSecurityRisk) {
-    const secValue = report.aiSecurityRisk.toUpperCase().padEnd(3, " ");
-    lines.push(`${"Security Risk".padEnd(20)} ${secValue}`);
+    const secLabel = report.aiSecurityRisk.toUpperCase();
+    lines.push(
+      `${"Security Risk".padEnd(20)} ${secLabel.padEnd(9)} (\u2191 higher = better \xB7 inverted from risk level \xB7 CRITICAL = worst)`
+    );
+    const secToScore = { low: 100, medium: 67, high: 33, critical: 0 };
+    const secNum = secToScore[report.aiSecurityRisk] ?? 0;
+    lines.push(`${"".padEnd(20)} ${import_chalk.default.dim(scoreToMessage(secNum, "security"))}`);
   }
   return lines;
 }
@@ -46672,11 +46771,11 @@ function formatDriftSection(report) {
 }
 function formatThresholds(report) {
   const limit = report.thresholds.meanSlop;
-  const headline = report.aiQuality;
+  const headline = report.aiSlopScore;
   const passed = headline >= 70;
   const valueText = `${headline.toFixed(1)} \u2265 70`.padStart(12, " ");
   const status = passed ? import_chalk.default.green("pass") : import_chalk.default.red("fail");
-  const result = ["Threshold (CI gate)", `  AI Quality  ${valueText}  ${status}`];
+  const result = ["Threshold (CI gate)", `  AI Slop Score  ${valueText}  ${status}`];
   void limit;
   return result;
 }
@@ -46757,7 +46856,7 @@ function formatPretty(report) {
 }
 function formatScoringExplainer(_report) {
   return import_chalk.default.dim(
-    "Four orthogonal scores (all 0-100, higher = better): AI Quality (AI-slop signatures; the CI gate, AI Quality >= 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 Quality + 0.3*Engineering Hygiene + 0.2*Security + 0.1*Test Quality). Only AI Quality gates CI; the others are informational. Default-off rules (INVERTED/NOISY/DORMANT) are suppressed from the scores automatically."
+    "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."
   );
 }
 function formatWhyFailingReport(report) {
@@ -46768,7 +46867,7 @@ function formatBriefReport(report) {
   lines.push(formatVerdict(report));
   lines.push("");
   const scoreLines = [
-    { label: "AI Quality", field: "aiQuality", value: report.aiQuality },
+    { label: "AI Slop Score", field: "aiSlopScore", value: report.aiSlopScore },
     { label: "Engineering Hygiene", field: "engineeringHygiene", value: report.engineeringHygiene },
     { label: "Security", field: "security", value: report.security },
     { label: "Repository Health", field: "repositoryHealth", value: report.repositoryHealth }
@@ -46783,11 +46882,11 @@ function formatBriefReport(report) {
       `  ${paddedLabel} ${band.color(valueStr)}   ${import_chalk.default.dim(band.label)}  ${import_chalk.default.dim.italic(`(${field})`)}${delta}`
     );
   });
-  const passed = report.aiQuality >= 70;
+  const passed = report.aiSlopScore <= 30;
   lines.push("");
   lines.push(
     import_chalk.default.dim(
-      `  CI gate: AI Quality >= 70 -> ${passed ? import_chalk.default.green("pass") : import_chalk.default.red("fail")}`
+      `  CI gate: AI Slop Score <= 30 -> ${passed ? import_chalk.default.green("pass") : import_chalk.default.red("fail")}`
     )
   );
   const suppressed = report.defaultOffSuppressedCount ?? 0;
@@ -46807,7 +46906,7 @@ function formatBriefReport(report) {
   );
   return lines.join("\n");
 }
-var import_chalk, CATEGORY_GLOSSARY;
+var import_chalk, CATEGORY_GLOSSARY, SCORE_MESSAGES;
 var init_pretty = __esm({
   "src/report/pretty.ts"() {
     "use strict";
@@ -46831,19 +46930,109 @@ var init_pretty = __esm({
       product: { short: "product", long: "feature flags, dead code, churn" },
       i18n: { short: "i18n", long: "translations, locale handling" }
     };
+    SCORE_MESSAGES = {
+      // AI Slop Score (v0.21.0: lower = cleaner; field stores the RAW
+      // amount of slop. 0 = no AI slop, 100 = max AI slop. The tier
+      // thresholds are flipped vs the v0.20.1 inverted reading.)
+      slop: [
+        [90, "Repo is saturated with AI slop"],
+        [70, "Repo has a high amount of AI slop"],
+        [50, "Repo has a medium amount of AI slop"],
+        [30, "Repo has a low amount of AI slop"],
+        [0, "Repo has no detectable AI slop"]
+      ],
+      // Engineering Hygiene (higher = better = fewer arch/logic/layout issues)
+      hygiene: [
+        [90, "Repo is clean"],
+        [70, "Repo has minor code quality issues"],
+        [50, "Repo has moderate code quality issues"],
+        [30, "Repo has significant code quality issues"],
+        [0, "Repo has serious code quality issues"]
+      ],
+      // Security (higher = better = inverted from risk level)
+      security: [
+        [90, "Repo has no security risks"],
+        [70, "Repo has low security risk"],
+        [50, "Repo has medium security risk"],
+        [30, "Repo has high security risk"],
+        [0, "Repo has critical security risk"]
+      ],
+      // Repository Health (higher = better = composite of 4 scores)
+      health: [
+        [90, "Repo is healthy"],
+        [70, "Repo has minor concerns"],
+        [50, "Repo has moderate concerns"],
+        [30, "Repo has significant concerns"],
+        [0, "Repo has serious concerns"]
+      ],
+      // Test Quality (higher = better = more test coverage, better assertions)
+      test: [
+        [90, "Tests are comprehensive"],
+        [70, "Good test coverage"],
+        [50, "Moderate test coverage"],
+        [30, "Weak test coverage"],
+        [0, "Tests are inadequate"]
+      ],
+      // Business Logic Coherence (higher = better = fewer cyclic imports, etc.)
+      logic: [
+        [90, "Logic is clean"],
+        [70, "Minor logic tangles"],
+        [50, "Moderate logic tangles"],
+        [30, "Significant logic tangles"],
+        [0, "Serious logic tangles"]
+      ],
+      // Accessibility (higher = better = fewer WCAG violations)
+      accessibility: [
+        [90, "No accessibility issues"],
+        [70, "Minor accessibility issues"],
+        [50, "Moderate accessibility issues"],
+        [30, "Significant accessibility issues"],
+        [0, "Critical accessibility issues"]
+      ],
+      // Performance (higher = better = fewer render-blocking, N+1, bloat)
+      performance: [
+        [90, "No performance issues"],
+        [70, "Minor performance issues"],
+        [50, "Moderate performance issues"],
+        [30, "Significant performance issues"],
+        [0, "Critical performance issues"]
+      ],
+      // Sub-score buckets (boundary/context/visual within AI Slop Score)
+      boundary: [
+        [90, "Boundary is clean"],
+        [70, "Minor boundary issues"],
+        [50, "Moderate boundary issues"],
+        [30, "Significant boundary issues"],
+        [0, "Boundary is broken"]
+      ],
+      context: [
+        [90, "Context is clean"],
+        [70, "Minor context issues"],
+        [50, "Moderate context issues"],
+        [30, "Significant context issues"],
+        [0, "Context is broken"]
+      ],
+      visual: [
+        [90, "Visual is clean"],
+        [70, "Minor visual issues"],
+        [50, "Moderate visual issues"],
+        [30, "Significant visual issues"],
+        [0, "Visual is broken"]
+      ]
+    };
   }
 });
 
 // src/cli/threshold.ts
 function thresholdExceeded(report, config) {
-  if ((report.aiQuality ?? 0) < config.thresholds.meanSlop) {
+  if ((report.aiSlopScore ?? 0) > config.thresholds.meanSlop) {
     return true;
   }
   return categoryThresholdBreached(report, config.thresholds.categoryThresholds);
 }
 function failedThresholdCount(report, config) {
   let count = 0;
-  if (report.aiQuality < config.thresholds.meanSlop) count += 1;
+  if (report.aiSlopScore > config.thresholds.meanSlop) count += 1;
   if (report.p90Score > config.thresholds.p90Slop) count += 1;
   if (report.peakScore > config.thresholds.individualSlopThreshold) count += 1;
   const cat = config.thresholds.categoryThresholds;
@@ -50162,14 +50351,21 @@ function aggregateReport(scores, issueGroups, config, compositeScores) {
     }
   }
   const denominator = componentCount || 1;
+  const slopAmount = {
+    boundary: Math.min(100, Math.log10(1 + bucketPoints.boundary / denominator) / Math.log10(11) * 100),
+    context: Math.min(100, Math.log10(1 + bucketPoints.context / denominator) / Math.log10(11) * 100),
+    visual: Math.min(100, Math.log10(1 + bucketPoints.visual / denominator) / Math.log10(11) * 100)
+  };
   const subscore = {
-    boundary: Math.min(100, bucketPoints.boundary / denominator * 100),
-    context: Math.min(100, bucketPoints.context / denominator * 100),
-    visual: Math.min(100, bucketPoints.visual / denominator * 100)
+    boundary: 100 - slopAmount.boundary,
+    context: 100 - slopAmount.context,
+    visual: 100 - slopAmount.visual
   };
   const compositeWeights = config.compositeWeights ?? COMPOSITE_WEIGHTS;
-  const slopIndex = compositeWeights.boundary * subscore.boundary + compositeWeights.context * subscore.context + compositeWeights.visual * subscore.visual;
-  const assemblyHealth = Math.max(0, 100 - slopIndex);
+  const aiSlopScoreRaw = compositeWeights.boundary * slopAmount.boundary + compositeWeights.context * slopAmount.context + compositeWeights.visual * slopAmount.visual;
+  const aiSlopScore = Math.max(0, Math.min(100, aiSlopScoreRaw));
+  const slopIndex = aiSlopScore;
+  const assemblyHealth = Math.max(0, 100 - aiSlopScore);
   const categoryPoints = {
     visual: 0,
     typo: 0,
@@ -50199,7 +50395,6 @@ function aggregateReport(scores, issueGroups, config, compositeScores) {
       categoryScores[category] = categoryScores[category] / componentCount * 100;
     }
   }
-  const aiQuality = Math.max(0, Math.min(100, 100 - slopIndex));
   const flatIssues = [];
   for (const group of issueGroups) {
     for (const issue of group.issues) {
@@ -50235,7 +50430,7 @@ function aggregateReport(scores, issueGroups, config, compositeScores) {
   const engineeringHygiene = Math.max(0, Math.min(100, 100 - engineeringRaw));
   const testQualityResult = buildTestQualityScore(flatIssues, componentCount);
   const testQuality = Math.max(0, Math.min(100, testQualityResult.score));
-  const repositoryHealthRaw = 0.4 * aiQuality + 0.3 * engineeringHygiene + 0.2 * security + 0.1 * testQuality;
+  const repositoryHealthRaw = 0.4 * (100 - aiSlopScore) + 0.3 * engineeringHygiene + 0.2 * security + 0.1 * testQuality;
   const repositoryHealth = Math.max(0, Math.min(100, repositoryHealthRaw));
   let compositeAggregate;
   if (compositeScores && compositeScores.length > 0) {
@@ -50256,7 +50451,7 @@ function aggregateReport(scores, issueGroups, config, compositeScores) {
     }
   }
   return {
-    aiQuality,
+    aiSlopScore,
     engineeringHygiene,
     security,
     repositoryHealth,
@@ -52417,8 +52612,8 @@ function computeAiMaintenanceCostFromReport(report, options = {}) {
   }
   const approxLoc = options.linesOfCode ?? (report.fileCount ?? 0) * 50;
   const axes = {
-    slopIndex: report.aiQuality,
-    // The axis is named slopIndex for historical naming; the value is now aiQuality (0-100, higher is better, but axisSlopIndex inverts it)
+    slopIndex: report.aiSlopScore,
+    // The axis is named slopIndex for historical naming; the value is now aiSlopScore (0-100, higher is better, but axisSlopIndex inverts it)
     architectureConsistency: report.architectureConsistency,
     aiSecurityRisk: report.aiSecurityRisk,
     constitutionViolations: options.constitutionViolations,
@@ -52690,10 +52885,10 @@ function aiDebtFromScore(score) {
 }
 function perAxis(inputs) {
   const out = [];
-  if (inputs.aiQuality !== void 0 && !Number.isNaN(inputs.aiQuality)) {
+  if (inputs.aiSlopScore !== void 0 && !Number.isNaN(inputs.aiSlopScore)) {
     out.push({
       axis: "slopIndex",
-      health: clamp1002(inputs.aiQuality),
+      health: clamp1002(inputs.aiSlopScore),
       weight: REPOSITORY_HEALTH_WEIGHTS.slopIndex
     });
   } else if (inputs.slopIndex !== void 0 && !Number.isNaN(inputs.slopIndex)) {
@@ -52805,10 +53000,10 @@ function buildRepositoryHealthFromReport(report, options = {}) {
   const totalDesignTokens = (options.spacingViolations ?? 0) + (options.radiusViolations ?? 0);
   const inputs = {
     // v0.15.0 U.4+: the v3 headline score. Passed as the
-    // `aiQuality` input (higher = better). The perAxis handler
+    // `aiSlopScore` input (higher = better). The perAxis handler
     // maps it to the "slopIndex" axis in the breakdown so
     // dashboards don't have to migrate.
-    aiQuality: report.aiQuality,
+    aiSlopScore: report.aiSlopScore,
     architectureConsistency: report.architectureConsistency,
     aiSecurityRisk: report.aiSecurityRisk,
     designTokenViolations: totalDesignTokens > 0 ? {
@@ -53096,7 +53291,7 @@ async function enrichReport(input) {
     const aiSignalCount = sortedIssues.filter((i) => i.aiSpecific === true).length;
     aiMaintenanceCost = computeAiMaintenanceCostFromReport2(
       {
-        aiQuality: aggregated.aiQuality ?? 0,
+        aiSlopScore: aggregated.aiSlopScore ?? 0,
         architectureConsistency,
         aiSecurityRisk,
         highSeverityIssueCount: sortedIssues.filter((i) => i.severity === "high").length,
@@ -53155,7 +53350,7 @@ async function enrichReport(input) {
     )?.count ?? 0;
     const composite = buildRepositoryHealthFromReport2(
       {
-        aiQuality: aggregated.aiQuality ?? 0,
+        aiSlopScore: aggregated.aiSlopScore ?? 0,
         engineeringHygiene: aggregated.engineeringHygiene ?? 0,
         security: aggregated.security ?? 0,
         repositoryHealth: aggregated.repositoryHealth ?? 0,
@@ -53302,7 +53497,7 @@ function assembleScanReport(input) {
     version: VERSION,
     generatedAt,
     configPath,
-    aiQuality: aggregated.aiQuality,
+    aiSlopScore: aggregated.aiSlopScore,
     engineeringHygiene: aggregated.engineeringHygiene,
     security: aggregated.security,
     // repositoryHealth is set later from `enrichment.repositoryHealth`
@@ -53341,7 +53536,7 @@ function assembleScanReport(input) {
     // v0.15.0 U.4+: the previous-run value is stored as
     // `previousSlopIndex` on ProjectReport for backward compat with
     // historical telemetry. The value itself is the previous run's
-    // aiQuality (higher = better).
+    // aiSlopScore (higher = better).
     previousSlopIndex: previousRun?.slopIndex,
     previousRunTimestamp: previousRun?.timestamp,
     p90Score: aggregated.p90Score,
@@ -53478,9 +53673,9 @@ function recordTelemetry(cwd, report, results, config) {
       componentCount: report.componentCount,
       // v0.15.0 U.4+: slopIndex is deprecated; the telemetry field is
       // still named slopIndex for backward compat with historical
-      // payloads, but the value is now aiQuality (0-100, higher is
+      // payloads, but the value is now aiSlopScore (0-100, higher is
       // better).
-      slopIndex: report.aiQuality,
+      slopIndex: report.aiSlopScore,
       assemblyHealth: report.assemblyHealth,
       categoryScores: { ...report.categoryScores },
       p90Score: report.p90Score,
@@ -53748,11 +53943,11 @@ async function persistRun(input) {
   } = input;
   const memoryReport = {
     generatedAt: report.generatedAt,
-    aiQuality: report.aiQuality ?? 0,
+    aiSlopScore: report.aiSlopScore ?? 0,
     engineeringHygiene: report.engineeringHygiene ?? 0,
     security: report.security ?? 0,
     repositoryHealth: report.repositoryHealth ?? 0,
-    slopIndex: report.slopIndex ?? report.aiQuality ?? 0,
+    slopIndex: report.slopIndex ?? report.aiSlopScore ?? 0,
     categoryScores: report.categoryScores,
     issues: report.issues ?? []
   };
@@ -53851,7 +54046,7 @@ async function persistRun(input) {
       if (!options.quiet && !machineReadableStdout) {
         const compositeSuffix = health.compositeScore ? ` composite=${health.compositeScore.tier}@${health.compositeScore.mean.toFixed(2)}` : "";
         logger.info(
-          `Memory persisted to .slopbrick/ (${inventory.patterns.length} patterns, ${inventory.components.length} components, ${md.length} bytes of structure.md, health.json: repo=${health.repositoryHealth} aiQ=${health.aiQuality} eng=${health.engineeringHygiene} sec=${health.security}${compositeSuffix}).`
+          `Memory persisted to .slopbrick/ (${inventory.patterns.length} patterns, ${inventory.components.length} components, ${md.length} bytes of structure.md, health.json: repo=${health.repositoryHealth} aiQ=${health.aiSlopScore} eng=${health.engineeringHygiene} sec=${health.security}${compositeSuffix}).`
         );
       }
     } catch (err) {
@@ -53930,7 +54125,7 @@ async function finalizeReport(input) {
     config,
     results,
     aggregated: {
-      aiQuality: aggregated.aiQuality,
+      aiSlopScore: aggregated.aiSlopScore,
       engineeringHygiene: aggregated.engineeringHygiene,
       security: aggregated.security,
       repositoryHealth: aggregated.repositoryHealth,
@@ -53962,11 +54157,11 @@ async function finalizeReport(input) {
     const previous = (await readRuns(cwd, fsMemoryIO)).at(-1);
     if (previous) {
       const previousBaseline = previous.slopIndex;
-      if ((report.aiQuality ?? 0) < previousBaseline) {
+      if ((report.aiSlopScore ?? 0) > previousBaseline) {
         noIncreaseFailure = true;
         if (!options.quiet) {
           logger.error(
-            `AI Quality went DOWN from ${previousBaseline.toFixed(1)} to ${(report.aiQuality ?? 0).toFixed(1)} \u2014 your code got sloppier. (Both values are 0-100, higher = better; the comparison is against the previous run's aiQuality, stored historically in the legacy slopIndex field.) See which files changed and fix the new issues.`
+            `AI Slop Score went UP from ${previousBaseline.toFixed(1)} to ${(report.aiSlopScore ?? 0).toFixed(1)} \u2014 your code got sloppier. (Both values are 0-100, lower = cleaner; the comparison is against the previous run's raw slop amount.) See which files changed and fix the new issues.`
           );
         }
       }
@@ -54399,8 +54594,8 @@ function renderHeader(report) {
         <span class="score-label">Repository Health (composite)</span>
       </div>
       <div class="score-card ai-quality">
-        <span class="score-value">${namedScores.aiQuality}</span>
-        <span class="score-label">AI Quality</span>
+        <span class="score-value">${namedScores.aiSlopScore}</span>
+        <span class="score-label">AI Slop Score</span>
       </div>
       <div class="score-card engineering-hygiene">
         <span class="score-value">${namedScores.engineeringHygiene}</span>
@@ -54430,7 +54625,7 @@ function extractNamedScores(report) {
   const score = (v) => typeof v === "number" && !Number.isNaN(v) ? Math.round(v).toString() : "\u2013";
   const r = report;
   return {
-    aiQuality: score(r.aiQuality),
+    aiSlopScore: score(r.aiSlopScore),
     engineeringHygiene: score(r.engineeringHygiene),
     security: score(r.security),
     repositoryHealth: score(r.repositoryHealth ?? report.repositoryHealth)
@@ -55780,7 +55975,7 @@ async function watchProject(options, cwd, paths) {
       generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
       configPath,
       // v0.15.0 U.4+: the 4-score model replaces the single slopIndex.
-      aiQuality: aggregated.aiQuality,
+      aiSlopScore: aggregated.aiSlopScore,
       engineeringHygiene: aggregated.engineeringHygiene,
       security: aggregated.security,
       repositoryHealth: aggregated.repositoryHealth,
@@ -58468,7 +58663,7 @@ function formatMarkdown(report) {
   const ext = report;
   lines.push(`## Repository Health`);
   lines.push("");
-  lines.push(`- **AI Quality** ${Math.round(ext.aiQuality ?? 0)}/100`);
+  lines.push(`- **AI Slop Score** ${Math.round(ext.aiSlopScore ?? 0)}/100`);
   lines.push(`- **Engineering Hygiene** ${Math.round(ext.engineeringHygiene ?? 0)}/100`);
   lines.push(`- **Security** ${Math.round(ext.security ?? 0)}/100`);
   lines.push(`- **Repository Health** ${Math.round(report.repositoryHealth ?? 0)}/100`);
@@ -60087,7 +60282,7 @@ async function runMaintenanceCostScan(cwd, config, options = {}) {
   const hasAiSignals = detectAiSignals(scan.report, config);
   const result = computeAiMaintenanceCostFromReport(
     {
-      aiQuality: scan.report.aiQuality,
+      aiSlopScore: scan.report.aiSlopScore,
       engineeringHygiene: scan.report.engineeringHygiene,
       security: scan.report.security,
       repositoryHealth: scan.report.repositoryHealth,