@chemx/starter-kit 26.9.11-481 → 26.9.12-107

package/cli/audit/reporter-grouping.d.ts

@@ -0,0 +1,42 @@
+import type { HazardViolation, SeverityLevel, AuditReport } from './types';
+
+export interface DirectoryHazardSummary {
+  readonly directory: string;
+  readonly total: number;
+  readonly critical: number;
+  readonly high: number;
+  readonly medium: number;
+  readonly low: number;
+  readonly violations: readonly HazardViolation[];
+  readonly topRules: readonly { readonly rule: string; readonly count: number }[];
+}
+
+export interface RuleDirectoryOccurrence {
+  readonly directory: string;
+  readonly count: number;
+  readonly violations: readonly HazardViolation[];
+}
+
+export interface RuleHazardSummary {
+  readonly rule: string;
+  readonly severity: SeverityLevel;
+  readonly pillar: string;
+  readonly directive: string;
+  readonly hazard: string;
+  readonly isAiSlop: boolean;
+  readonly total: number;
+  readonly violations: readonly HazardViolation[];
+  readonly directories: readonly RuleDirectoryOccurrence[];
+}
+
+export declare function resolveDirectory(filePath?: string): string;
+export declare function groupViolationsByDirectory(violations?: readonly HazardViolation[]): readonly DirectoryHazardSummary[];
+export declare function groupViolationsByRule(violations?: readonly HazardViolation[]): readonly RuleHazardSummary[];
+export declare function formatCompactLocations(violations: readonly HazardViolation[], maxShown?: number): string;
+export declare function renderGroupedViolationsTerminal(violations: readonly HazardViolation[]): string;
+export declare function formatDirectoryDistributionSection(report: AuditReport, themeColor?: string | null): string;
+export declare function formatDirectoryRollupMarkdown(violations?: readonly HazardViolation[]): string;
+export declare function renderGroupedViolationsMarkdown(
+  violations?: readonly HazardViolation[],
+  options?: { readonly showSeverity?: boolean }
+): string;

package/cli/audit/reporter-grouping.js

@@ -0,0 +1,243 @@
+import path from 'node:path';
+import {
+  CYAN,
+  GREEN,
+  YELLOW,
+  RED,
+  ORANGE,
+  DIM,
+  BOLD,
+  RESET,
+  resolveTopSectionColor
+} from './reporter-utils.js';
+
+export const resolveDirectory = (filePath) => {
+  const hasFilePath = Boolean(filePath);
+  if (!hasFilePath) return './';
+  const normalized = filePath.replace(/\\/g, '/');
+  const lastSlash = normalized.lastIndexOf('/');
+  const isRoot = lastSlash === -1;
+  if (isRoot) return './';
+  return normalized.slice(0, lastSlash + 1);
+};
+
+export const groupViolationsByDirectory = (violations = []) => {
+  const dirMap = new Map();
+
+  for (const v of violations) {
+    const dir = resolveDirectory(v.filePath);
+    let group = dirMap.get(dir);
+    if (!group) {
+      group = {
+        directory: dir,
+        total: 0,
+        critical: 0,
+        high: 0,
+        medium: 0,
+        low: 0,
+        violations: [],
+        rulesMap: new Map()
+      };
+      dirMap.set(dir, group);
+    }
+
+    group.total += 1;
+    group.violations.push(v);
+    if (v.severity === 'CRITICAL') group.critical += 1;
+    else if (v.severity === 'HIGH') group.high += 1;
+    else if (v.severity === 'MEDIUM') group.medium += 1;
+    else group.low += 1;
+
+    const count = group.rulesMap.get(v.rule) || 0;
+    group.rulesMap.set(v.rule, count + 1);
+  }
+
+  const createDirectorySummary = (g) => {
+    const topRules = Array.from(g.rulesMap.entries())
+      .map(([rule, count]) => ({ rule, count }))
+      .sort((a, b) => b.count - a.count);
+
+    return {
+      directory: g.directory,
+      total: g.total,
+      critical: g.critical,
+      high: g.high,
+      medium: g.medium,
+      low: g.low,
+      violations: g.violations,
+      topRules
+    };
+  };
+
+  const result = Array.from(dirMap.values()).map(createDirectorySummary);
+
+  const calculateDirectoryWeight = (g) => g.critical * 1000 + g.high * 100 + g.medium * 10 + g.low;
+
+  const compareDirectoryRisk = (a, b) => {
+    const weightDiff = calculateDirectoryWeight(b) - calculateDirectoryWeight(a);
+    const hasWeightDiff = weightDiff !== 0;
+    if (hasWeightDiff) return weightDiff;
+    return b.total - a.total;
+  };
+
+  result.sort(compareDirectoryRisk);
+  return result;
+};
+
+export const groupViolationsByRule = (violations = []) => {
+  const ruleMap = new Map();
+
+  for (const v of violations) {
+    let group = ruleMap.get(v.rule);
+    if (!group) {
+      group = {
+        rule: v.rule,
+        severity: v.severity,
+        pillar: v.pillar,
+        directive: v.directive,
+        hazard: v.hazard,
+        isAiSlop: Boolean(v.isAiSlop),
+        total: 0,
+        violations: [],
+        dirsMap: new Map()
+      };
+      ruleMap.set(v.rule, group);
+    }
+
+    group.total += 1;
+    group.violations.push(v);
+
+    const dir = resolveDirectory(v.filePath);
+    let dirViolations = group.dirsMap.get(dir);
+    if (!dirViolations) {
+      dirViolations = [];
+      group.dirsMap.set(dir, dirViolations);
+    }
+    dirViolations.push(v);
+  }
+
+  const createRuleSummary = (g) => {
+    const directories = Array.from(g.dirsMap.entries()).map(([directory, list]) => ({
+      directory,
+      count: list.length,
+      violations: list
+    }));
+
+    return {
+      rule: g.rule,
+      severity: g.severity,
+      pillar: g.pillar,
+      directive: g.directive,
+      hazard: g.hazard,
+      isAiSlop: g.isAiSlop,
+      total: g.total,
+      violations: g.violations,
+      directories
+    };
+  };
+
+  const result = Array.from(ruleMap.values()).map(createRuleSummary);
+
+  const SEVERITY_RANKS = { CRITICAL: 4, HIGH: 3, MEDIUM: 2, LOW: 1 };
+  const compareRuleSeverity = (a, b) => {
+    const rankDiff = (SEVERITY_RANKS[b.severity] || 0) - (SEVERITY_RANKS[a.severity] || 0);
+    const hasRankDiff = rankDiff !== 0;
+    if (hasRankDiff) return rankDiff;
+    return b.total - a.total;
+  };
+
+  result.sort(compareRuleSeverity);
+  return result;
+};
+
+const resolveSeverityColor = (severity) => {
+  if (severity === 'CRITICAL') return RED;
+  if (severity === 'HIGH') return ORANGE;
+  if (severity === 'MEDIUM') return YELLOW;
+  return DIM;
+};
+
+export const formatCompactLocations = (violations, maxShown = 4) => {
+  const formatLocationItem = (v) => {
+    const base = path.basename(v.filePath);
+    return `${YELLOW}${base}:${v.line}:${v.column}${RESET}`;
+  };
+
+  const items = violations.slice(0, maxShown).map(formatLocationItem);
+  const remaining = violations.length - maxShown;
+  const hasRemaining = remaining > 0;
+  if (hasRemaining) {
+    items.push(`${DIM}(+${remaining} more)${RESET}`);
+  }
+  return items.join(', ');
+};
+
+export const renderGroupedViolationsTerminal = (violations) => {
+  const hasNoViolations = violations.length === 0;
+  if (hasNoViolations) return '';
+
+  const ruleGroups = groupViolationsByRule(violations);
+  const lines = [];
+
+  ruleGroups.forEach((rg, idx) => {
+    const sevColor = resolveSeverityColor(rg.severity);
+    const countLabel = rg.total === 1 ? '1 item' : `${rg.total} items`;
+    const isSingleOccurrence = rg.total === 1;
+
+    if (isSingleOccurrence) {
+      const v = rg.violations[0];
+      lines.push(`   ${sevColor}[#${idx + 1} ${rg.severity}]${RESET} [${rg.rule}] ${YELLOW}${v.filePath}:${v.line}:${v.column}${RESET}`);
+      lines.push(`      Hazard:    ${rg.hazard}`);
+      lines.push(`      Directive: ${CYAN}${rg.directive}${RESET}\n`);
+      return;
+    }
+
+    const dirCount = rg.directories.length;
+    const dirLabel = dirCount === 1 ? '1 directory' : `${dirCount} directories`;
+    lines.push(`   ${sevColor}[#${idx + 1} ${rg.severity}]${RESET} [${rg.rule}] ${BOLD}${countLabel}${RESET} ${DIM}across ${dirLabel}${RESET}`);
+    lines.push(`      Hazard:    ${rg.hazard}`);
+    lines.push(`      Directive: ${CYAN}${rg.directive}${RESET}`);
+    lines.push(`      Locations:`);
+
+    for (const d of rg.directories) {
+      const locs = formatCompactLocations(d.violations, 4);
+      lines.push(`        📁 ${d.directory} (${d.count}): ${locs}`);
+    }
+    lines.push('');
+  });
+
+  return lines.join('\n');
+};
+
+export const formatDirectoryDistributionSection = (report, themeColor = null) => {
+  const { violations = [] } = report;
+  const sectionColor = themeColor || resolveTopSectionColor(report);
+  const dirGroups = groupViolationsByDirectory(violations);
+  const lines = [];
+
+  lines.push('');
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`${BOLD}${sectionColor}   HAZARD DISTRIBUTION BY DIRECTORY${RESET}`);
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+
+  const hasNoViolations = dirGroups.length === 0;
+  if (hasNoViolations) {
+    lines.push(`   ${GREEN}✔ Zero violations detected across all project directories.${RESET}`);
+  } else {
+    lines.push(`   ${DIM}Directory                              Total  Crit  High   Med   Low${RESET}`);
+    lines.push(`   ${DIM}------------------------------------------------------------------${RESET}`);
+    for (const g of dirGroups) {
+      const isLongDir = g.directory.length > 36;
+      const padDir = isLongDir ? `${g.directory.slice(0, 33)}...` : g.directory.padEnd(36, ' ');
+      const totalStr = `${BOLD}${g.total}${RESET}`.padStart(6, ' ');
+      const critStr = (g.critical > 0 ? `${RED}${g.critical}${RESET}` : `${DIM}0${RESET}`).padStart(5, ' ');
+      const highStr = (g.high > 0 ? `${ORANGE}${g.high}${RESET}` : `${DIM}0${RESET}`).padStart(5, ' ');
+      const medStr = (g.medium > 0 ? `${YELLOW}${g.medium}${RESET}` : `${DIM}0${RESET}`).padStart(5, ' ');
+      const lowStr = (g.low > 0 ? `${DIM}${g.low}${RESET}` : `${DIM}0${RESET}`).padStart(5, ' ');
+      lines.push(`   ${padDir} ${totalStr} ${critStr} ${highStr} ${medStr} ${lowStr}`);
+    }
+  }
+  lines.push(`${sectionColor}======================================================================${RESET}\n`);
+
+  return lines.join('\n');
+};

package/cli/audit/reporter-markdown.js

@@ -7,9 +7,13 @@ import {
   PILLAR_EMOJIS,
   NUMBER_EMOJIS
 } from './reporter-utils.js';
+import {
+  formatDirectoryRollupMarkdown,
+  renderGroupedViolationsMarkdown
+} from './reporter-grouping-markdown.js';
 
 export const generateMarkdownReport = (report) => {
-  const { metrics, health, pillars, contextAnalysis, hotspots, violations } = report;
+  const { metrics, health, pillars, contextAnalysis, hotspots, violations, aiSlop } = report;
   const { critical, high, medium, low } = groupViolationsBySeverity(violations);
   const lines = [];
 
@@ -24,6 +28,10 @@ export const generateMarkdownReport = (report) => {
   const hearts = resolveHealthHearts(health?.grade, health?.score, false);
   lines.push(`| **Life / Health Meter** | ${hearts} (Grade **${health.grade}**) | ${health.score} / 100 (${health.label}) |`);
   lines.push(`| **Molecular Health Index** | **${health.score} / 100** | Grade: **${health.grade}** (${health.label}) |`);
+  const slopScore = aiSlop?.score ?? 100;
+  const slopGrade = aiSlop?.grade ?? 'A+';
+  const slopLabel = aiSlop?.label ?? 'Pure Artisanal';
+  lines.push(`| **AI Slop Index (ASI)** | **${slopScore} / 100** | Grade: **${slopGrade}** (${slopLabel}) |`);
   lines.push(`| **Scanned Files** | ${metrics.scannedFiles} source files | Verified |`);
   lines.push(`| **Total Lines of Code** | ${metrics.totalLoc} lines of code | Avg ${metrics.avgLoc} lines/file |`);
   lines.push(`| **Largest File** | \`${metrics.largestFile.filePath || 'None'}\` | ${metrics.largestFile.lineCount} lines |`);
@@ -69,61 +77,65 @@ export const generateMarkdownReport = (report) => {
   lines.push('');
   lines.push('---');
   lines.push('');
-  lines.push('## 4. Architectural Hazard Inventory (Grouped by Severity)');
+  lines.push('## 4. Architectural Hazard Inventory (Grouped by Directory & Severity)');
   lines.push('');
 
   if (violations.length === 0) {
     lines.push('Zero context hazard violations detected across all line budgets, hooks, and AST rules.');
   } else {
+    lines.push(formatDirectoryRollupMarkdown(violations));
+
     if (critical.length > 0) {
       lines.push('### Critical Hazards (Immediate Action Required)');
       lines.push('');
-      lines.push('| Location | Rule | Hazard Description | Directive |');
-      lines.push('| :--- | :--- | :--- | :--- |');
-      for (const v of critical) {
-        lines.push(`| \`${v.filePath}:${v.line}:${v.column}\` | \`${v.rule}\` | ${v.hazard} | ${v.directive} |`);
-      }
-      lines.push('');
+      lines.push(renderGroupedViolationsMarkdown(critical, { showSeverity: false }));
     }
 
     if (high.length > 0 || medium.length > 0) {
       lines.push('### High & Medium Hazards (Architecture Debts)');
       lines.push('');
-      lines.push('| Location | Severity | Rule | Hazard Description | Directive |');
-      lines.push('| :--- | :---: | :--- | :--- | :--- |');
-      for (const v of [...high, ...medium]) {
-        lines.push(`| \`${v.filePath}:${v.line}:${v.column}\` | ${v.severity} | \`${v.rule}\` | ${v.hazard} | ${v.directive} |`);
-      }
-      lines.push('');
+      lines.push(renderGroupedViolationsMarkdown([...high, ...medium], { showSeverity: true }));
     }
 
     if (low.length > 0) {
       lines.push('### Low & Hygiene Issues (Typography & Logging)');
       lines.push('');
-      lines.push('| Location | Rule | Hazard Description | Directive |');
-      lines.push('| :--- | :--- | :--- | :--- |');
-      for (const v of low) {
-        lines.push(`| \`${v.filePath}:${v.line}:${v.column}\` | \`${v.rule}\` | ${v.hazard} | ${v.directive} |`);
-      }
-      lines.push('');
+      lines.push(renderGroupedViolationsMarkdown(low, { showSeverity: false }));
     }
   }
 
+  const slopViolations = violations.filter((v) => v.isAiSlop);
+  lines.push('---');
+  lines.push('');
+  lines.push('## 5. AI Slop & Code Authenticity Audit');
+  lines.push('');
+  lines.push(`* **AI Slop Index (ASI)**: **${slopScore} / 100** (Grade: **${slopGrade}** - ${slopLabel})`);
+  lines.push(`* **Slop Hazards Flagged**: **${slopViolations.length}**`);
+  lines.push('');
+
+  if (slopViolations.length === 0) {
+    lines.push('🟢 Zero AI slop detected. Codebase demonstrates pure artisanal craftsmanship with no LLM conversational residue or echo comments.');
+  } else {
+    lines.push(renderGroupedViolationsMarkdown(slopViolations, { showSeverity: true }));
+  }
+  lines.push('');
+
   lines.push('---');
   lines.push('');
-  lines.push('## 5. Remediation Roadmap');
+  lines.push('## 6. Remediation Roadmap');
   lines.push('');
   lines.push('1. **Decompose Monoliths**: Break down any file exceeding 500 lines into single-responsibility capsules.');
   lines.push('2. **Cap Molecule Size**: Ensure all molecule components (`m-*`) remain strictly under 100 lines.');
   lines.push('3. **Two-Stage Boolean Logic**: Replace complex multi-clause expressions with atomic boolean variables.');
   lines.push('4. **Lifecycle-Safe Timers**: Migrate raw `setInterval` and `setTimeout` calls to self-cleaning composables.');
+  lines.push('5. **Purge AI Slop**: Remove conversational residue, eliminate echo comments, and inline single-use passthrough assignments.');
   lines.push('');
 
   const masterPrompt = buildMasterPrompt(report);
   if (masterPrompt) {
     lines.push('---');
     lines.push('');
-    lines.push('## 6. 🤖 Copy-Paste AI Agent Refactoring Directives');
+    lines.push('## 7. 🤖 Copy-Paste AI Agent Refactoring Directives');
     lines.push('');
     lines.push('Feed the prompt below directly into your AI coding agent (Cursor, Windsurf, Claude, Copilot, or Antigravity) to surgically refactor flagged hazards:');
     lines.push('');

package/cli/audit/reporter-sections.d.ts

@@ -0,0 +1,10 @@
+import type { AuditReport } from './types';
+
+export declare function formatScorecardSection(report: AuditReport, themeColor?: string | null): string;
+export declare function formatCriticalSection(report: AuditReport): string;
+export declare function formatHighMediumSection(report: AuditReport): string;
+export declare function formatLowSection(report: AuditReport): string;
+export declare function formatPillarsSection(report: AuditReport, themeColor?: string | null): string;
+export declare function formatHotspotsSection(report: AuditReport, themeColor?: string | null): string;
+export declare function formatContextAnalysisSection(report: AuditReport, themeColor?: string | null): string;
+export declare function formatAiSlopSection(report: AuditReport, themeColor?: string | null): string;

package/cli/audit/reporter-sections.js

@@ -0,0 +1,259 @@
+import {
+  CYAN,
+  GREEN,
+  YELLOW,
+  RED,
+  ORANGE,
+  DIM,
+  BOLD,
+  RESET,
+  groupViolationsBySeverity,
+  getStatusBadge,
+  resolveGradeColor,
+  resolveHealthHearts,
+  resolveRiskColor,
+  resolveHotspotBadge,
+  resolveTopSectionColor
+} from './reporter-utils.js';
+import { getAsciiGradeLines, getReportCardAsciiLines } from './reporter-ascii.js';
+import { renderGroupedViolationsTerminal } from './reporter-grouping.js';
+import {
+  buildAiSlopPrompt,
+  buildHotspotsPrompt,
+  formatPromptBox
+} from './prompts.js';
+
+const isSlopViolation = (v) => Boolean(v.isAiSlop);
+
+const formatHotspotItem = (h, idx) => {
+  const monolithBadge = resolveHotspotBadge(h.lineCount);
+  return `   [#${idx + 1}] ${YELLOW}${h.filePath}${RESET} (${h.lineCount} lines, ${h.violationCount} hazards)${monolithBadge}`;
+};
+
+export const formatScorecardSection = (report, themeColor = null) => {
+  const { metrics, health } = report;
+  const sectionColor = themeColor || resolveTopSectionColor(report);
+  const gradeColor = resolveGradeColor(health?.score ?? health?.grade ?? 'A');
+  const lines = [];
+
+  lines.push('');
+  for (const rcLine of getReportCardAsciiLines(sectionColor)) {
+    lines.push(`   ${rcLine}`);
+  }
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`${BOLD}${sectionColor}   MOLECULAR HEALTH INDEX & CODEBASE OVERVIEW${RESET}`);
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+
+  const asciiGradeLines = getAsciiGradeLines(health?.grade || 'A', gradeColor);
+  if (asciiGradeLines.length > 0) {
+    lines.push('');
+    for (const asciiLine of asciiGradeLines) {
+      lines.push(`   ${asciiLine}`);
+    }
+    lines.push('');
+    lines.push(`${sectionColor}----------------------------------------------------------------------${RESET}`);
+  }
+
+  const hearts = resolveHealthHearts(health?.grade, health?.score);
+  lines.push(`   Life / Health Meter: ${hearts} ${gradeColor}${BOLD}${health.score} / 100${RESET} (Grade: ${gradeColor}${BOLD}${health.grade}${RESET} - ${health.label})`);
+
+  if (report.aiSlop) {
+    const slopGradeColor = resolveGradeColor(report.aiSlop.grade);
+    const slopHearts = resolveHealthHearts(report.aiSlop.grade, report.aiSlop.score);
+    lines.push(`   AI Slop Index (ASI): ${slopHearts} ${slopGradeColor}${BOLD}${report.aiSlop.score} / 100${RESET} (Grade: ${slopGradeColor}${BOLD}${report.aiSlop.grade}${RESET} - ${report.aiSlop.label})`);
+  }
+  lines.push(`   Files Scanned:       ${BOLD}${metrics.scannedFiles}${RESET} source files`);
+  lines.push(`   Total Lines of Code: ${BOLD}${metrics.totalLoc}${RESET} lines of code (avg: ${metrics.avgLoc} lines/file)`);
+  lines.push(`   Largest File:        ${BOLD}${metrics.largestFile.filePath || 'None'}${RESET} (${metrics.largestFile.lineCount} lines)`);
+  lines.push(`   Molecule Capsules:   ${metrics.moleculeCount} found (${metrics.moleculeCompliantPct}% compliant < 100 lines of code)`);
+  lines.push(`   Custom Hooks:        ${metrics.hookCount} detected`);
+  lines.push(`${sectionColor}======================================================================${RESET}\n`);
+
+  return lines.join('\n');
+};
+
+export const formatCriticalSection = (report) => {
+  const { violations } = report;
+  const { critical } = groupViolationsBySeverity(violations);
+  const lines = [];
+
+  lines.push('');
+  lines.push(`${RED}======================================================================${RESET}`);
+  lines.push(`${BOLD}${RED}   CRITICAL HAZARDS (${critical.length} TOTAL) : IMMEDIATE ACTION REQUIRED${RESET}`);
+  lines.push(`${DIM}   Violations that break Molecular line budgets or introduce severe AST bugs${RESET}`);
+  lines.push(`${RED}======================================================================${RESET}`);
+
+  if (critical.length === 0) {
+    lines.push(`   ${GREEN}✔ Zero critical hazards detected. No monoliths or breaking AST patterns.${RESET}`);
+  } else {
+    lines.push(renderGroupedViolationsTerminal(critical));
+  }
+  lines.push(`${RED}======================================================================${RESET}\n`);
+
+  return lines.join('\n');
+};
+
+export const formatHighMediumSection = (report) => {
+  const { violations } = report;
+  const { high, medium } = groupViolationsBySeverity(violations);
+  const totalCount = high.length + medium.length;
+  const lines = [];
+
+  lines.push('');
+  lines.push(`${ORANGE}======================================================================${RESET}`);
+  lines.push(`${BOLD}${ORANGE}   HIGH & MEDIUM HAZARDS (${totalCount} TOTAL) : ARCHITECTURE DEBTS${RESET}`);
+  lines.push(`${DIM}   Saturation, complex control flow booleans, and raw inline styles${RESET}`);
+  lines.push(`${ORANGE}======================================================================${RESET}`);
+
+  if (totalCount === 0) {
+    lines.push(`   ${GREEN}✔ Zero high or medium architecture hazards detected.${RESET}`);
+  } else {
+    if (high.length > 0) {
+      lines.push(`\n   ${BOLD}--- High Severity (${high.length} items) ---${RESET}\n`);
+      lines.push(renderGroupedViolationsTerminal(high));
+    }
+
+    if (medium.length > 0) {
+      lines.push(`\n   ${BOLD}--- Medium Severity (${medium.length} items) ---${RESET}\n`);
+      lines.push(renderGroupedViolationsTerminal(medium));
+    }
+  }
+  lines.push(`${ORANGE}======================================================================${RESET}\n`);
+
+  return lines.join('\n');
+};
+
+export const formatLowSection = (report) => {
+  const { violations } = report;
+  const { low } = groupViolationsBySeverity(violations);
+  const lines = [];
+
+  lines.push('');
+  lines.push(`${YELLOW}======================================================================${RESET}`);
+  lines.push(`${BOLD}${YELLOW}   LOW & HYGIENE ISSUES (${low.length} TOTAL) : TYPOGRAPHY & LOGGING${RESET}`);
+  lines.push(`${DIM}   Em dash typography violations and unguarded console statements${RESET}`);
+  lines.push(`${YELLOW}======================================================================${RESET}`);
+
+  if (low.length === 0) {
+    lines.push(`   ${GREEN}✔ Zero typography or logging hygiene issues detected.${RESET}`);
+  } else {
+    lines.push(renderGroupedViolationsTerminal(low));
+  }
+  lines.push(`${YELLOW}======================================================================${RESET}\n`);
+
+  return lines.join('\n');
+};
+
+export const formatPillarsSection = (report, themeColor = null) => {
+  const { pillars } = report;
+  const sectionColor = themeColor || resolveTopSectionColor(report);
+  const lines = [];
+
+  lines.push('');
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`${BOLD}${sectionColor}   7-PILLAR ARCHITECTURAL COMPLIANCE MATRIX${RESET}`);
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`   ${DIM}Pillar Name                                   Status     Violations${RESET}`);
+  lines.push(`   ${DIM}------------------------------------------------------------------${RESET}`);
+  for (const [pillarName, data] of Object.entries(pillars)) {
+    const padName = pillarName.padEnd(45, ' ');
+    const badge = getStatusBadge(data.status).padEnd(16, ' ');
+    const countStr = data.violations === 0 ? `${GREEN}0${RESET}` : `${RED}${data.violations}${RESET}`;
+    lines.push(`   ${padName} ${badge} ${countStr}`);
+  }
+  lines.push(`${sectionColor}======================================================================${RESET}\n`);
+
+  return lines.join('\n');
+};
+
+export const formatHotspotsSection = (report, themeColor = null, options = {}) => {
+  const { includePrompt = true } = typeof options === 'boolean' ? { includePrompt: options } : options;
+  const { hotspots } = report;
+  const sectionColor = themeColor || resolveTopSectionColor(report);
+  const lines = [];
+
+  lines.push('');
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`${BOLD}${sectionColor}   TOP REFACTORING HOTSPOTS (PRIORITY RANKING)${RESET}`);
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+
+  if (hotspots.length === 0) {
+    lines.push(`   ${GREEN}✔ Zero hotspot files. All files stay within architectural budgets.${RESET}`);
+  } else {
+    for (let idx = 0; idx < hotspots.length; idx++) {
+      lines.push(formatHotspotItem(hotspots[idx], idx));
+    }
+  }
+
+  if (includePrompt) {
+    const promptHotspots = buildHotspotsPrompt(report);
+    if (promptHotspots) {
+      lines.push(formatPromptBox('🤖 AI AGENT REFACTORING PROMPT (MONOLITH DECOMPOSITION)', promptHotspots));
+    }
+  }
+
+  lines.push(`${sectionColor}======================================================================${RESET}\n`);
+
+  return lines.join('\n');
+};
+
+export const formatContextAnalysisSection = (report, themeColor = null) => {
+  const { contextAnalysis } = report;
+  const sectionColor = themeColor || resolveTopSectionColor(report);
+  const riskColor = resolveRiskColor(contextAnalysis.riskLevel);
+  const lines = [];
+
+  lines.push('');
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`${BOLD}${sectionColor}   CONTEXT ROT & TOKEN BURN ANALYTICS${RESET}`);
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`   Estimated Codebase Tokens:  ~${contextAnalysis.estimatedTokens.toLocaleString()} tokens`);
+  lines.push(`   Estimated Monolith Bloat:   ~${contextAnalysis.estimatedExcessTokens.toLocaleString()} tokens`);
+  lines.push(`   Target Architecture Cut:    ${BOLD}${contextAnalysis.potentialSavingsPct}%${RESET} token reduction potential`);
+  lines.push(`   Agent Hallucination Risk:   ${riskColor}${BOLD}${contextAnalysis.riskLevel}${RESET}`);
+  if (contextAnalysis.excessCostPerPass !== undefined) {
+    const costPass = contextAnalysis.excessCostPerPass.toFixed(3);
+    const costMonth = contextAnalysis.monthlyWastePerDev.toFixed(2);
+    const costWeek = contextAnalysis.weeklyWastePerDev.toFixed(2);
+    lines.push(`   Pricing Model Baseline:     ${contextAnalysis.pricingModel}`);
+    lines.push(`   Monolith Bloat per AI Turn: \x1b[38;5;208;1m$${costPass}\x1b[0m / prompt turn`);
+    lines.push(`   Projected Dev Context Tax:  \x1b[31;1m$${costMonth}/mo\x1b[0m per engineer ($${costWeek}/wk)`);
+  }
+  lines.push(`${sectionColor}======================================================================${RESET}\n`);
+
+  return lines.join('\n');
+};
+
+export const formatAiSlopSection = (report, themeColor = null, options = {}) => {
+  const { includePrompt = true } = typeof options === 'boolean' ? { includePrompt: options } : options;
+  const { aiSlop, violations = [] } = report;
+  const slopViolations = violations.filter(isSlopViolation);
+  const sectionColor = themeColor || resolveTopSectionColor(report);
+  const slopColor = resolveGradeColor(aiSlop?.grade || 'A+');
+  const lines = [];
+
+  lines.push('');
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`${BOLD}${sectionColor}   AI SLOP INDEX & CODE AUTHENTICITY AUDIT${RESET}`);
+  lines.push(`${DIM}   Deterministic detection of LLM conversational residue and echo comments${RESET}`);
+  lines.push(`${sectionColor}======================================================================${RESET}`);
+  lines.push(`   AI Slop Score:        ${slopColor}${BOLD}${aiSlop?.score ?? 100} / 100${RESET} (Grade: ${slopColor}${BOLD}${aiSlop?.grade ?? 'A+'}${RESET} - ${aiSlop?.label ?? 'Pure Artisanal'})`);
+  lines.push(`   Slop Hazards Flagged: ${slopViolations.length > 0 ? `${RED}${BOLD}${slopViolations.length}${RESET}` : `${GREEN}0 (Artisanal Clean)${RESET}`}`);
+  lines.push(`${sectionColor}----------------------------------------------------------------------${RESET}`);
+
+  if (slopViolations.length === 0) {
+    lines.push(`   ${GREEN}✔ Zero AI slop detected. Codebase is free of conversational residue and echo comments.${RESET}`);
+  } else {
+    lines.push(renderGroupedViolationsTerminal(slopViolations));
+  }
+
+  if (includePrompt) {
+    const promptSlop = buildAiSlopPrompt(report);
+    if (promptSlop) {
+      lines.push(formatPromptBox('🤖 AI AGENT REFACTORING PROMPT (AI SLOP & AUTHENTICITY)', promptSlop));
+    }
+  }
+
+  lines.push(`${sectionColor}======================================================================${RESET}\n`);
+  return lines.join('\n');
+};

package/cli/audit/reporter-summary.d.ts

@@ -0,0 +1,4 @@
+import type { AuditReport } from './types';
+
+export declare function formatFailuresSection(report: AuditReport): string;
+export declare function formatPassesSection(report: AuditReport): string;