@chemx/starter-kit 26.9.11-362 → 26.9.11-481

package/cli/audit/history.d.ts

@@ -40,6 +40,12 @@ export interface TransformationDelta {
   readonly totalDelta: number;
   readonly monolithDelta: number;
   readonly tokensDelta: number;
+  readonly costPassBefore?: number;
+  readonly costPassAfter?: number;
+  readonly costPassDelta?: number;
+  readonly monthlyTaxBefore?: number;
+  readonly monthlyTaxAfter?: number;
+  readonly monthlyTaxDelta?: number;
   readonly pillarDeltas: Record<string, PillarDelta>;
   readonly isImproved: boolean;
 }

package/cli/audit/history.js

@@ -88,7 +88,12 @@ export const createSnapshotFromReport = (report) => {
       estimatedTokens: contextAnalysis.estimatedTokens || 0,
       estimatedExcessTokens: contextAnalysis.estimatedExcessTokens || 0,
       potentialSavingsPct: contextAnalysis.potentialSavingsPct || 0,
-      riskLevel: contextAnalysis.riskLevel || 'LOW'
+      riskLevel: contextAnalysis.riskLevel || 'LOW',
+      pricingModel: contextAnalysis.pricingModel || 'Frontier Blended ($3.00/1M)',
+      costPerMillion: contextAnalysis.costPerMillion !== undefined ? contextAnalysis.costPerMillion : 3.0,
+      excessCostPerPass: contextAnalysis.excessCostPerPass !== undefined ? contextAnalysis.excessCostPerPass : 0,
+      weeklyWastePerDev: contextAnalysis.weeklyWastePerDev !== undefined ? contextAnalysis.weeklyWastePerDev : 0,
+      monthlyWastePerDev: contextAnalysis.monthlyWastePerDev !== undefined ? contextAnalysis.monthlyWastePerDev : 0
     },
     pillars: pillarSummaries
   };
@@ -196,6 +201,28 @@ export const calculateTransformationDelta = (beforeSnapshot, afterSnapshot) => {
   const tokensAfter = afterSnapshot.tokens.estimatedExcessTokens;
   const tokensDelta = tokensAfter - tokensBefore;
 
+  const costPerMillion = afterSnapshot.tokens?.costPerMillion || beforeSnapshot.tokens?.costPerMillion || 3.0;
+
+  const resolveCostPass = (tokensObj) => {
+    if (tokensObj?.excessCostPerPass !== undefined) return tokensObj.excessCostPerPass;
+    const excess = tokensObj?.estimatedExcessTokens || 0;
+    return Number(((excess / 1000000) * costPerMillion).toFixed(3));
+  };
+
+  const resolveMonthlyTax = (tokensObj) => {
+    if (tokensObj?.monthlyWastePerDev !== undefined) return tokensObj.monthlyWastePerDev;
+    const costPass = resolveCostPass(tokensObj);
+    return Number((costPass * 20 * 5 * 4).toFixed(2));
+  };
+
+  const costPassBefore = resolveCostPass(beforeSnapshot.tokens);
+  const costPassAfter = resolveCostPass(afterSnapshot.tokens);
+  const costPassDelta = Number((costPassAfter - costPassBefore).toFixed(3));
+
+  const monthlyTaxBefore = resolveMonthlyTax(beforeSnapshot.tokens);
+  const monthlyTaxAfter = resolveMonthlyTax(afterSnapshot.tokens);
+  const monthlyTaxDelta = Number((monthlyTaxAfter - monthlyTaxBefore).toFixed(2));
+
   const pillarDeltas = {};
   const allPillars = new Set([
     ...Object.keys(beforeSnapshot.pillars || {}),
@@ -220,6 +247,12 @@ export const calculateTransformationDelta = (beforeSnapshot, afterSnapshot) => {
     totalDelta,
     monolithDelta,
     tokensDelta,
+    costPassBefore,
+    costPassAfter,
+    costPassDelta,
+    monthlyTaxBefore,
+    monthlyTaxAfter,
+    monthlyTaxDelta,
     pillarDeltas,
     isImproved: scoreDelta > 0 || critDelta < 0 || totalDelta < 0
   };
@@ -237,6 +270,14 @@ export const formatTransformationTerminal = (beforeSnapshot, afterSnapshot) => {
     return `${color}${BOLD}${sign}${RESET}`;
   };
 
+  const formatDeltaCurrency = (val, perUnit = '') => {
+    if (val === 0) return `${DIM}0 (No change)${RESET}`;
+    const isGood = val < 0;
+    const sign = val > 0 ? `+$${val.toFixed(2)}` : `-$${Math.abs(val).toFixed(2)}`;
+    const color = isGood ? GREEN : RED;
+    return `${color}${BOLD}${sign}${perUnit}${RESET}`;
+  };
+
   lines.push('');
   lines.push(`${CYAN}======================================================================${RESET}`);
   lines.push(`${BOLD}${CYAN}   ARCHITECTURAL TRANSFORMATION : BEFORE & AFTER PROGRESSION${RESET}`);
@@ -252,31 +293,35 @@ export const formatTransformationTerminal = (beforeSnapshot, afterSnapshot) => {
   lines.push('');
 
   lines.push(`${BOLD}   METRIC COMPARISON TABLE${RESET}`);
-  lines.push(`   ------------------------------------------------------------------`);
-  lines.push(`   ${'Metric'.padEnd(26)} ${'Before'.padEnd(16)} ${'After'.padEnd(16)} Delta`);
-  lines.push(`   ------------------------------------------------------------------`);
+  lines.push(`   ----------------------------------------------------------------------------`);
+  lines.push(`   ${'Metric'.padEnd(40)} ${'Before'.padEnd(16)} ${'After'.padEnd(16)} Delta`);
+  lines.push(`   ----------------------------------------------------------------------------`);
 
   const scoreBeforeStr = `${beforeSnapshot.health.score} (${beforeSnapshot.health.grade})`;
   const scoreAfterStr = `${afterSnapshot.health.score} (${afterSnapshot.health.grade})`;
-  lines.push(`   ${'Molecular Health (MHI)'.padEnd(26)} ${scoreBeforeStr.padEnd(16)} ${scoreAfterStr.padEnd(16)} ${formatDeltaNumber(delta.scoreDelta)}`);
+  lines.push(`   ${'Molecular Health (MHI)'.padEnd(40)} ${scoreBeforeStr.padEnd(16)} ${scoreAfterStr.padEnd(16)} ${formatDeltaNumber(delta.scoreDelta)}`);
 
   const critBeforeStr = `${beforeSnapshot.violations.critical}`;
   const critAfterStr = `${afterSnapshot.violations.critical}`;
-  lines.push(`   ${'Critical Hazards'.padEnd(26)} ${critBeforeStr.padEnd(16)} ${critAfterStr.padEnd(16)} ${formatDeltaNumber(delta.critDelta, true)}`);
+  lines.push(`   ${'Critical Hazards'.padEnd(40)} ${critBeforeStr.padEnd(16)} ${critAfterStr.padEnd(16)} ${formatDeltaNumber(delta.critDelta, true)}`);
 
   const totalBeforeStr = `${beforeSnapshot.violations.total}`;
   const totalAfterStr = `${afterSnapshot.violations.total}`;
-  lines.push(`   ${'Total Violations'.padEnd(26)} ${totalBeforeStr.padEnd(16)} ${totalAfterStr.padEnd(16)} ${formatDeltaNumber(delta.totalDelta, true)}`);
+  lines.push(`   ${'Total Violations'.padEnd(40)} ${totalBeforeStr.padEnd(16)} ${totalAfterStr.padEnd(16)} ${formatDeltaNumber(delta.totalDelta, true)}`);
 
   const monoBeforeStr = `${beforeSnapshot.monoliths.total}`;
   const monoAfterStr = `${afterSnapshot.monoliths.total}`;
-  lines.push(`   ${'Monolith Files (>500 LOC)'.padEnd(26)} ${monoBeforeStr.padEnd(16)} ${monoAfterStr.padEnd(16)} ${formatDeltaNumber(delta.monolithDelta, true)}`);
+  lines.push(`   ${'Monolith Files (>500 lines of code)'.padEnd(40)} ${monoBeforeStr.padEnd(16)} ${monoAfterStr.padEnd(16)} ${formatDeltaNumber(delta.monolithDelta, true)}`);
 
   const excessBeforeStr = `${beforeSnapshot.tokens.estimatedExcessTokens.toLocaleString()} tok`;
   const excessAfterStr = `${afterSnapshot.tokens.estimatedExcessTokens.toLocaleString()} tok`;
-  lines.push(`   ${'Excess Token Burn'.padEnd(26)} ${excessBeforeStr.padEnd(16)} ${excessAfterStr.padEnd(16)} ${formatDeltaNumber(delta.tokensDelta, true)}`);
+  lines.push(`   ${'Excess Token Burn'.padEnd(40)} ${excessBeforeStr.padEnd(16)} ${excessAfterStr.padEnd(16)} ${formatDeltaNumber(delta.tokensDelta, true)}`);
+
+  const taxBeforeStr = `$${delta.monthlyTaxBefore.toFixed(2)}/mo`;
+  const taxAfterStr = `$${delta.monthlyTaxAfter.toFixed(2)}/mo`;
+  lines.push(`   ${'Dev Context Tax (Monthly)'.padEnd(40)} ${taxBeforeStr.padEnd(16)} ${taxAfterStr.padEnd(16)} ${formatDeltaCurrency(delta.monthlyTaxDelta, '/mo')}`);
 
-  lines.push(`   ------------------------------------------------------------------`);
+  lines.push(`   ----------------------------------------------------------------------------`);
   lines.push('');
 
   const resolvePillarDeltaArrow = (pDelta) => {
@@ -290,12 +335,12 @@ export const formatTransformationTerminal = (beforeSnapshot, afterSnapshot) => {
   };
 
   lines.push(`${BOLD}   7-PILLAR PROGRESSION${RESET}`);
-  lines.push(`   ------------------------------------------------------------------`);
+  lines.push(`   ----------------------------------------------------------------------------`);
   for (const [pillar, pDelta] of Object.entries(delta.pillarDeltas)) {
     const arrow = resolvePillarDeltaArrow(pDelta);
-    lines.push(`   ${pillar.padEnd(28)} ${pDelta.beforeStatus.padEnd(10)} -> ${pDelta.afterStatus.padEnd(10)} ${arrow}`);
+    lines.push(`   ${pillar.padEnd(40)} ${pDelta.beforeStatus.padEnd(8)} -> ${pDelta.afterStatus.padEnd(8)} ${arrow}`);
   }
-  lines.push(`   ------------------------------------------------------------------`);
+  lines.push(`   ----------------------------------------------------------------------------`);
   lines.push('');
 
   if (delta.isImproved) {
@@ -325,7 +370,7 @@ export const formatHistoryTimelineTerminal = (history) => {
   }
 
   lines.push(`   ${'#'.padEnd(4)} ${'Date/Time'.padEnd(22)} ${'Score'.padEnd(12)} ${'Grade'.padEnd(10)} ${'Monoliths'.padEnd(12)} Hazards`);
-  lines.push(`   ------------------------------------------------------------------`);
+  lines.push(`   ----------------------------------------------------------------------------`);
 
   const resolveScoreGradeColor = (score) => {
     if (score >= 90) return GREEN;
@@ -346,7 +391,7 @@ export const formatHistoryTimelineTerminal = (history) => {
 
   history.forEach(renderTimelineRow);
 
-  lines.push(`   ------------------------------------------------------------------`);
+  lines.push(`   ----------------------------------------------------------------------------`);
   lines.push('');
   return lines.join('\n');
 };

package/cli/audit/prompts.js

@@ -14,7 +14,7 @@ export const buildGradeFPrompt = (report) => {
   lines.push('Act as a Principal Systems Architect. Surgically refactor the following Grade F Critical Context Hazards in our codebase according to Chemical X Molecular Architecture Standards:\n');
 
   if (extremeMonoliths.length > 0) {
-    lines.push('### EXTREME MONOLITHS (>= 2,000 LOC) : MONOLITH DECOMPOSITION');
+    lines.push('### EXTREME MONOLITHS (>= 2,000 lines of code) : MONOLITH DECOMPOSITION');
     extremeMonoliths.forEach((h, i) => {
       lines.push(`${i + 1}. File: \`${h.filePath}\` (${h.lineCount} lines)`);
       lines.push('   Action: Decompose this monolith into crystalline single-responsibility capsules (< 100 lines per molecule). Convert top-level view into a declarative Table-of-Contents view.');
@@ -53,10 +53,10 @@ export const buildGradeDPrompt = (report) => {
   lines.push('Act as a Principal Systems Architect. Refactor the following Grade D High-Severity Architectural Debts according to Chemical X Molecular Architecture Standards:\n');
 
   if (severeMonoliths.length > 0) {
-    lines.push('### SEVERE MONOLITHS (1,000 - 1,999 LOC)');
+    lines.push('### SEVERE MONOLITHS (1,000 - 1,999 lines of code)');
     severeMonoliths.forEach((h, i) => {
       lines.push(`${i + 1}. File: \`${h.filePath}\` (${h.lineCount} lines)`);
-      lines.push('   Action: Extract sub-features into isolated molecule capsules (< 100 LOC) and domain composables.');
+      lines.push('   Action: Extract sub-features into isolated molecule capsules (< 100 lines of code) and domain composables.');
     });
     lines.push('');
   }
@@ -90,7 +90,7 @@ export const buildGradeCPrompt = (report) => {
   lines.push('Act as a Senior Frontend Engineer. Refactor the following Grade C Medium-Severity Technical Debts according to Chemical X Molecular Architecture Standards:\n');
 
   if (warningMonoliths.length > 0) {
-    lines.push('### WARNING MONOLITHS (500 - 999 LOC)');
+    lines.push('### WARNING MONOLITHS (500 - 999 lines of code)');
     warningMonoliths.forEach((h, i) => {
       lines.push(`${i + 1}. File: \`${h.filePath}\` (${h.lineCount} lines)`);
       lines.push('   Action: Bring file under 500 line budget by extracting helper functions, types, and child molecules.');
@@ -111,7 +111,7 @@ export const buildGradeCPrompt = (report) => {
   lines.push('### STRICT EXECUTION RULES:');
   lines.push('1. Zero raw inline styles: Replace style={{...}} with atom props, SCSS mixins (@include glass), or scoped BEM classes.');
   lines.push('2. Extract anonymous inline callbacks into named functions before passing as props.');
-  lines.push('3. Co-locate granular types (*.d.ts) inside feature capsules (< 100 LOC). Avoid type monoliths.');
+  lines.push('3. Co-locate granular types (*.d.ts) inside feature capsules (< 100 lines of code). Avoid type monoliths.');
 
   return lines.join('\n');
 };

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

@@ -0,0 +1,4 @@
+export declare const REPORT_CARD_ASCII: readonly string[];
+export declare function getReportCardAsciiLines(color?: string): readonly string[];
+export declare function getAsciiGradeLines(grade?: string, color?: string, withEquals?: boolean): readonly string[];
+export declare function formatAsciiGrade(grade?: string, color?: string, indent?: string, withEquals?: boolean): string;

package/cli/audit/reporter-ascii.js

@@ -0,0 +1,99 @@
+import { BOLD, RESET } from './reporter-utils.js';
+
+const EQUALS_GLYPH = [
+  '        ',
+  '███████╗',
+  '╚══════╝',
+  '███████╗',
+  '╚══════╝',
+  '        '
+];
+
+const LETTER_GLYPHS = {
+  A: [
+    ' █████╗ ',
+    '██╔══██╗',
+    '███████║',
+    '██╔══██║',
+    '██║  ██║',
+    '╚═╝  ╚═╝'
+  ],
+  B: [
+    '██████╗ ',
+    '██╔══██╗',
+    '██████╔╝',
+    '██╔══██╗',
+    '██████╔╝',
+    '╚═════╝ '
+  ],
+  C: [
+    ' ██████╗',
+    '██╔════╝',
+    '██║     ',
+    '██║     ',
+    '╚██████╗',
+    ' ╚═════╝'
+  ],
+  D: [
+    '██████╗ ',
+    '██╔══██╗',
+    '██║  ██║',
+    '██║  ██║',
+    '██████╔╝',
+    '╚═════╝ '
+  ],
+  F: [
+    '███████╗',
+    '██╔════╝',
+    '█████╗  ',
+    '██╔══╝  ',
+    '██║     ',
+    '╚═╝     '
+  ],
+  PLUS: [
+    '       ',
+    '  ██╗  ',
+    '██████╗',
+    '╚═██╔═╝',
+    '  ╚═╝  ',
+    '       '
+  ]
+};
+
+export const getAsciiGradeLines = (grade = 'A', color = '', withEquals = false) => {
+  const normGrade = String(grade || 'A').trim().toUpperCase();
+  const letter = normGrade.replace('+', '');
+  const hasPlus = normGrade.includes('+');
+  const glyph = LETTER_GLYPHS[letter] || LETTER_GLYPHS.A;
+
+  const lines = [];
+  for (let i = 0; i < 6; i++) {
+    let letterPart = glyph[i];
+    if (hasPlus) {
+      letterPart += ` ${LETTER_GLYPHS.PLUS[i]}`;
+    }
+    const coloredLetter = color ? `${color}${BOLD}${letterPart}${RESET}` : letterPart;
+
+    if (withEquals) {
+      const eqPart = `${BOLD}\x1b[37m${EQUALS_GLYPH[i]}${RESET}`;
+      lines.push(`${eqPart}  ${coloredLetter}`);
+    } else {
+      lines.push(coloredLetter);
+    }
+  }
+  return lines;
+};
+
+export const formatAsciiGrade = (grade = 'A', color = '', indent = '   ', withEquals = false) =>
+  getAsciiGradeLines(grade, color, withEquals).map((l) => `${indent}${l}`).join('\n');
+
+export const REPORT_CARD_ASCII = [
+  '▗▄▄▖ ▗▄▄▄▖▗▄▄▖  ▗▄▖ ▗▄▄▖▗▄▄▄▖     ▗▄▄▖ ▗▄▖ ▗▄▄▖ ▗▄▄▄ ',
+  '▐▌ ▐▌▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌ █      ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌  █',
+  '▐▛▀▚▖▐▛▀▀▘▐▛▀▘ ▐▌ ▐▌▐▛▀▚▖ █      ▐▌   ▐▛▀▜▌▐▛▀▚▖▐▌  █',
+  '▐▌ ▐▌▐▙▄▄▖▐▌   ▝▚▄▞▘▐▌ ▐▌ █      ▝▚▄▄▖▐▌ ▐▌▐▌ ▐▌▐▙▄▄▀'
+];
+
+export const getReportCardAsciiLines = (color = '') =>
+  REPORT_CARD_ASCII.map((row) => (color ? `${color}${BOLD}${row}${RESET}` : row));
+

package/cli/audit/reporter-grades.js

@@ -16,6 +16,7 @@ import {
   RESET,
   groupViolationsBySeverity
 } from './reporter-utils.js';
+import { getReportCardAsciiLines } from './reporter-ascii.js';
 
 export const formatGradeFSection = (report) => {
   const { violations, hotspots, pillars } = report;
@@ -25,9 +26,12 @@ export const formatGradeFSection = (report) => {
   const lines = [];
 
   lines.push('');
+  for (const rcLine of getReportCardAsciiLines(RED)) {
+    lines.push(`   ${rcLine}`);
+  }
   lines.push(`${RED}======================================================================${RESET}`);
   lines.push(`${BOLD}${RED}   GRADE F : CRITICAL ARCHITECTURAL HAZARDS & EXTREME MONOLITHS${RESET}`);
-  lines.push(`${DIM}   Immediate action required: >2,000 LOC monoliths, render hacks, mock data${RESET}`);
+  lines.push(`${DIM}   Immediate action required: >2,000 lines of code monoliths, render hacks, mock data${RESET}`);
   lines.push(`${RED}======================================================================${RESET}`);
   lines.push(`   Critical Violations:  ${critical.length > 0 ? `${RED}${BOLD}${critical.length}${RESET}` : `${GREEN}0${RESET}`}`);
   lines.push(`   Extreme Monoliths:    ${extremeMonoliths.length > 0 ? `${RED}${BOLD}${extremeMonoliths.length}${RESET}` : `${GREEN}0${RESET}`}`);
@@ -37,7 +41,7 @@ export const formatGradeFSection = (report) => {
   const totalGradeFItems = critical.length + extremeMonoliths.length + failedPillars.length;
   if (totalGradeFItems === 0) {
     lines.push(`\n   ${GREEN}✔ Outstanding! Zero Grade F hazards detected.${RESET}`);
-    lines.push(`   ${DIM}Codebase is free of extreme monoliths (>2k LOC) and critical violations.${RESET}`);
+    lines.push(`   ${DIM}Codebase is free of extreme monoliths (>2,000 lines of code) and critical violations.${RESET}`);
   } else {
     if (critical.length > 0) {
       lines.push(`\n   ${BOLD}${RED}🚨 CRITICAL AST VIOLATIONS (${critical.length}):${RESET}`);
@@ -83,9 +87,12 @@ export const formatGradeDSection = (report) => {
   const lines = [];
 
   lines.push('');
+  for (const rcLine of getReportCardAsciiLines(ORANGE)) {
+    lines.push(`   ${rcLine}`);
+  }
   lines.push(`${ORANGE}======================================================================${RESET}`);
   lines.push(`${BOLD}${ORANGE}   GRADE D : HIGH SEVERITY DEBTS & SEVERE MONOLITHS${RESET}`);
-  lines.push(`${DIM}   Refactoring priorities: 1,000 to 1,999 LOC files and hook saturation > 5${RESET}`);
+  lines.push(`${DIM}   Refactoring priorities: 1,000 to 1,999 lines of code files and hook saturation > 5${RESET}`);
   lines.push(`${ORANGE}======================================================================${RESET}`);
   lines.push(`   High Severity Debts:  ${high.length > 0 ? `${ORANGE}${BOLD}${high.length}${RESET}` : `${GREEN}0${RESET}`}`);
   lines.push(`   Severe Monoliths:     ${severeMonoliths.length > 0 ? `${ORANGE}${BOLD}${severeMonoliths.length}${RESET}` : `${GREEN}0${RESET}`}`);
@@ -95,7 +102,7 @@ export const formatGradeDSection = (report) => {
   const totalGradeDItems = high.length + severeMonoliths.length + warnPillars.length;
   if (totalGradeDItems === 0) {
     lines.push(`\n   ${GREEN}✔ Zero Grade D debts detected.${RESET}`);
-    lines.push(`   ${DIM}No severe monoliths (1k-2k LOC) or saturated hook anti-patterns.${RESET}`);
+    lines.push(`   ${DIM}No severe monoliths (1,000-1,999 lines of code) or saturated hook anti-patterns.${RESET}`);
   } else {
     if (high.length > 0) {
       lines.push(`\n   ${BOLD}${ORANGE}⚠️  HIGH SEVERITY VIOLATIONS (${high.length}):${RESET}`);
@@ -139,9 +146,12 @@ export const formatGradeCSection = (report) => {
   const lines = [];
 
   lines.push('');
+  for (const rcLine of getReportCardAsciiLines(CYAN)) {
+    lines.push(`   ${rcLine}`);
+  }
   lines.push(`${CYAN}======================================================================${RESET}`);
   lines.push(`${BOLD}${CYAN}   GRADE C : MEDIUM SEVERITY DEBTS & MONOLITHIC DRIFT${RESET}`);
-  lines.push(`${DIM}   Architecture debts: 500 to 999 LOC files and raw inline style attributes${RESET}`);
+  lines.push(`${DIM}   Architecture debts: 500 to 999 lines of code files and raw inline style attributes${RESET}`);
   lines.push(`${CYAN}======================================================================${RESET}`);
   lines.push(`   Medium Debts:         ${medium.length > 0 ? `${YELLOW}${BOLD}${medium.length}${RESET}` : `${GREEN}0${RESET}`}`);
   lines.push(`   Warning Monoliths:    ${warningMonoliths.length > 0 ? `${YELLOW}${BOLD}${warningMonoliths.length}${RESET}` : `${GREEN}0${RESET}`}`);
@@ -185,6 +195,9 @@ export const formatGradeBSection = (report) => {
   const lines = [];
 
   lines.push('');
+  for (const rcLine of getReportCardAsciiLines(YELLOW)) {
+    lines.push(`   ${rcLine}`);
+  }
   lines.push(`${YELLOW}======================================================================${RESET}`);
   lines.push(`${BOLD}${YELLOW}   GRADE B : LOW SEVERITY HYGIENE & MINOR CODE SMELLS${RESET}`);
   lines.push(`${DIM}   Hygiene & polish: Em dash typography leaks and unguarded console logging${RESET}`);
@@ -219,13 +232,16 @@ export const formatGradeASection = (report) => {
   const lines = [];
 
   lines.push('');
+  for (const rcLine of getReportCardAsciiLines(GREEN)) {
+    lines.push(`   ${rcLine}`);
+  }
   lines.push(`${GREEN}======================================================================${RESET}`);
   lines.push(`${BOLD}${GREEN}   GRADE A : COMPLIANT ARCHITECTURE & PASSING PILLARS${RESET}`);
   lines.push(`${DIM}   Molecular Architecture verified clean areas and crystalline modules${RESET}`);
   lines.push(`${GREEN}======================================================================${RESET}`);
   lines.push(`   Molecular Health Score:  ${BOLD}${GREEN}${health.score}/100${RESET} [Grade: ${BOLD}${GREEN}${health.grade}${RESET}]`);
   lines.push(`   Passing Pillars:       ${BOLD}${GREEN}${passedPillars.length} / 7 Pillars PASSED${RESET}`);
-  lines.push(`   Capsule Compliance:    ${BOLD}${GREEN}${metrics.moleculeCompliantPct}%${RESET} compliant (< 100 LOC)`);
+  lines.push(`   Capsule Compliance:    ${BOLD}${GREEN}${metrics.moleculeCompliantPct}%${RESET} compliant (< 100 lines of code)`);
   lines.push(`${GREEN}----------------------------------------------------------------------${RESET}`);
 
   lines.push(`\n   ${BOLD}${GREEN}✔ COMPLIANT PILLARS (${passedPillars.length} / 7):${RESET}`);
@@ -244,11 +260,11 @@ export const formatGradeASection = (report) => {
   }
   const hasExtremeMonolith = hotspots.some((h) => h.lineCount >= 2000);
   if (!hasExtremeMonolith) {
-    lines.push(`   ${GREEN}✔${RESET} Zero Extreme Monoliths (0 files >= 2,000 LOC)`);
+    lines.push(`   ${GREEN}✔${RESET} Zero Extreme Monoliths (0 files >= 2,000 lines of code)`);
   }
   const hasSevereMonolith = hotspots.some((h) => h.lineCount >= 1000);
   if (!hasSevereMonolith) {
-    lines.push(`   ${GREEN}✔${RESET} Zero Severe Monoliths (0 files >= 1,000 LOC)`);
+    lines.push(`   ${GREEN}✔${RESET} Zero Severe Monoliths (0 files >= 1,000 lines of code)`);
   }
   if (contextAnalysis.riskLevel === 'LOW') {
     lines.push(`   ${GREEN}✔${RESET} Low Context Hazard & Token Burn Risk`);

package/cli/audit/reporter-markdown.js

@@ -1,6 +1,7 @@
 import { buildMasterPrompt } from './prompts.js';
 import {
   groupViolationsBySeverity,
+  resolveHealthHearts,
   resolveMarkdownStatusIcon,
   resolveMarkdownMonolithText,
   PILLAR_EMOJIS,
@@ -14,17 +15,17 @@ export const generateMarkdownReport = (report) => {
 
   lines.push('# Chemical X Protocol: Architectural Audit Report');
   lines.push('');
-  lines.push(`**Generated**: ${new Date().toISOString()}`);
-  lines.push('');
-  lines.push('---');
+  lines.push('> *Comprehensive static analysis report enforcing Chemical X Molecular Architecture standards.*');
   lines.push('');
   lines.push('## 1. Executive Summary & Scorecard');
   lines.push('');
   lines.push('| Metric | Value | Status |');
   lines.push('| :--- | :--- | :--- |');
+  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}) |`);
   lines.push(`| **Scanned Files** | ${metrics.scannedFiles} source files | Verified |`);
-  lines.push(`| **Total Lines of Code** | ${metrics.totalLoc} LOC | Avg ${metrics.avgLoc} LOC/file |`);
+  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 |`);
   lines.push(`| **Context Token Overhead** | ~${contextAnalysis.estimatedTokens.toLocaleString()} tokens | Est. Bloat: ~${contextAnalysis.estimatedExcessTokens.toLocaleString()} tokens |`);
   lines.push(`| **Token Reduction Target** | **${contextAnalysis.potentialSavingsPct}%** | Risk Level: **${contextAnalysis.riskLevel}** |`);

package/cli/audit/reporter-utils.js

@@ -71,12 +71,30 @@ export const resolveRiskColor = (riskLevel) => {
 };
 
 export const resolveHotspotBadge = (lineCount) => {
-  if (lineCount >= 2000) return ` ${RED}[CRITICAL MONOLITH >= 2,000 LOC]${RESET}`;
-  if (lineCount >= 1000) return ` ${ORANGE}[SEVERE MONOLITH >= 1,000 LOC]${RESET}`;
-  if (lineCount > 500) return ` ${YELLOW}[MONOLITH WARNING > 500 LOC]${RESET}`;
+  if (lineCount >= 2000) return ` ${RED}[CRITICAL MONOLITH >= 2,000 lines of code]${RESET}`;
+  if (lineCount >= 1000) return ` ${ORANGE}[SEVERE MONOLITH >= 1,000 lines of code]${RESET}`;
+  if (lineCount > 500) return ` ${YELLOW}[MONOLITH WARNING > 500 lines of code]${RESET}`;
   return '';
 };
 
+export const resolveHealthHearts = (grade, score = 0, isAnsi = true) => {
+  const g = String(grade || '').toUpperCase();
+  let filled = 1;
+  if (g.startsWith('A') || score >= 90) filled = 5;
+  else if (g.startsWith('B') || score >= 80) filled = 4;
+  else if (g.startsWith('C') || score >= 70) filled = 3;
+  else if (g.startsWith('D') || score >= 60) filled = 2;
+  else filled = score === 0 ? 0 : 1;
+
+  const empty = 5 - filled;
+  if (!isAnsi) {
+    return '❤︎'.repeat(filled) + '♡'.repeat(empty);
+  }
+  const redHearts = `${RED}${BOLD}` + '❤︎'.repeat(filled) + RESET;
+  const dimHearts = `${DIM}` + '♡'.repeat(empty) + RESET;
+  return `${redHearts}${dimHearts}`;
+};
+
 export const PILLAR_EMOJIS = {
   'Line Budgets & Monolith Decomposition': '📏',
   'Control Flow & Boolean Logic': '🔀',
@@ -100,8 +118,8 @@ export const resolveMarkdownStatusIcon = (status) => {
 };
 
 export const resolveMarkdownMonolithText = (lineCount) => {
-  if (lineCount >= 2000) return '🔴 **CRITICAL (>= 2,000 LOC)**';
-  if (lineCount >= 1000) return '🟠 **SEVERE (>= 1,000 LOC)**';
-  if (lineCount > 500) return '🟡 **WARNING (> 500 LOC)**';
+  if (lineCount >= 2000) return '🔴 **CRITICAL (>= 2,000 lines of code)**';
+  if (lineCount >= 1000) return '🟠 **SEVERE (>= 1,000 lines of code)**';
+  if (lineCount > 500) return '🟡 **WARNING (> 500 lines of code)**';
   return '🟢 Compliant';
 };

package/cli/audit/reporter.js

@@ -15,6 +15,7 @@ import {
   groupViolationsBySeverity,
   getStatusBadge,
   resolveGradeColor,
+  resolveHealthHearts,
   resolveRiskColor,
   resolveHotspotBadge
 } from './reporter-utils.js';
@@ -24,6 +25,7 @@ export {
   getSeverityBadge,
   getStatusBadge,
   resolveGradeColor,
+  resolveHealthHearts,
   resolveRiskColor,
   resolveHotspotBadge,
   resolveMarkdownStatusIcon,
@@ -51,6 +53,15 @@ export {
   formatGradeASection
 } from './reporter-grades.js';
 
+export {
+  getAsciiGradeLines,
+  formatAsciiGrade,
+  getReportCardAsciiLines,
+  REPORT_CARD_ASCII
+} from './reporter-ascii.js';
+
+import { getAsciiGradeLines, getReportCardAsciiLines } from './reporter-ascii.js';
+
 export const resolveTopSectionColor = (report) => {
   const hasNoViolations = (report?.violations?.length ?? 0) === 0;
   const hasNoHotspots = (report?.hotspots?.length ?? 0) === 0;
@@ -62,18 +73,33 @@ export const resolveTopSectionColor = (report) => {
 export const formatScorecardSection = (report, themeColor = null) => {
   const { metrics, health } = report;
   const sectionColor = themeColor || resolveTopSectionColor(report);
-  const gradeColor = resolveGradeColor(health.score);
+  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}`);
-  lines.push(`   Health Score:        ${gradeColor}${BOLD}${health.score} / 100${RESET} (Grade: ${gradeColor}${BOLD}${health.grade}${RESET} - ${health.label})`);
+
+  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})`);
   lines.push(`   Files Scanned:       ${BOLD}${metrics.scannedFiles}${RESET} source files`);
-  lines.push(`   Total Lines of Code: ${BOLD}${metrics.totalLoc}${RESET} LOC (avg: ${metrics.avgLoc} lines/file)`);
+  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)`);
+  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`);
 
@@ -259,6 +285,11 @@ export const getChemicalXAsciiBanner = (gradeOrReport = null) => {
 
   lines.push('                     \x1b[1m\x1b[37mThe Secret Sauce to \x1b[38;2;98;201;255mVibe Coding\x1b[0m');
 
+  const gColor = grade ? resolveGradeColor(grade) : '';
+  const gradeLines = grade ? getAsciiGradeLines(grade, gColor, true) : [];
+  const termWidth = process.stdout.columns || 0;
+  const isSideBySide = Boolean(!termWidth || termWidth >= 105);
+
   for (let lineIdx = 0; lineIdx < art.length; lineIdx++) {
     const line = art[lineIdx];
     let out = '';
@@ -284,9 +315,8 @@ export const getChemicalXAsciiBanner = (gradeOrReport = null) => {
       out += `\x1b[38;2;${r};${g};${b}m\x1b[1m${ch}\x1b[0m`;
     }
 
-    if (grade && lineIdx === 2) {
-      const gColor = resolveGradeColor(grade);
-      out += `   \x1b[1m\x1b[37m=\x1b[0m ${gColor}\x1b[1mGrade ${grade}\x1b[0m`;
+    if (isSideBySide && gradeLines.length > lineIdx) {
+      out += `   ${gradeLines[lineIdx]}`;
     }
 
     lines.push(out);
@@ -295,6 +325,14 @@ export const getChemicalXAsciiBanner = (gradeOrReport = null) => {
   const subtitle = 'Architectural guardrails to eliminate token burn and AI hallucinations.';
   const pad = ' '.repeat(Math.max(0, Math.floor((maxLen - subtitle.length) / 2)));
   lines.push(`${pad}\x1b[2m${subtitle}\x1b[0m\n`);
+
+  if (!isSideBySide && gradeLines.length > 0) {
+    for (const gl of gradeLines) {
+      lines.push(`   ${gl}`);
+    }
+    lines.push('');
+  }
+
   return lines.join('\n');
 };
 
@@ -424,8 +462,8 @@ export const formatPassesSection = (report) => {
 
   lines.push(`   Molecular Health Score:    ${BOLD}${GREEN}${health.score}/100${RESET} [Grade: ${BOLD}${GREEN}${health.grade}${RESET}]`);
   lines.push(`   Passing Pillars:         ${BOLD}${GREEN}${passedPillars.length} / 7 Pillars PASSED${RESET}`);
-  lines.push(`   Capsule Compliance:      ${BOLD}${GREEN}${metrics.moleculeCompliantPct}%${RESET} molecules compliant (< 100 LOC)`);
-  lines.push(`   Total Files Scanned:     ${metrics.scannedFiles} source files (${metrics.totalLoc} total LOC)`);
+  lines.push(`   Capsule Compliance:      ${BOLD}${GREEN}${metrics.moleculeCompliantPct}%${RESET} molecules compliant (< 100 lines of code)`);
+  lines.push(`   Total Files Scanned:     ${metrics.scannedFiles} source files (${metrics.totalLoc} total lines of code)`);
   lines.push(`${GREEN}----------------------------------------------------------------------${RESET}`);
 
   lines.push(`\n   ${BOLD}${GREEN}✔ COMPLIANT ARCHITECTURAL PILLARS:${RESET}`);
@@ -444,11 +482,11 @@ export const formatPassesSection = (report) => {
   }
   const hasExtremeMonolith = hotspots.some((h) => h.lineCount >= 2000);
   if (!hasExtremeMonolith) {
-    lines.push(`   ${GREEN}✔${RESET} Zero Extreme Monoliths (0 files >= 2,000 LOC)`);
+    lines.push(`   ${GREEN}✔${RESET} Zero Extreme Monoliths (0 files >= 2,000 lines of code)`);
   }
   const hasSevereMonolith = hotspots.some((h) => h.lineCount >= 1000);
   if (!hasSevereMonolith) {
-    lines.push(`   ${GREEN}✔${RESET} Zero Severe Monoliths (0 files >= 1,000 LOC)`);
+    lines.push(`   ${GREEN}✔${RESET} Zero Severe Monoliths (0 files >= 1,000 lines of code)`);
   }
   if (contextAnalysis.riskLevel === 'LOW') {
     lines.push(`   ${GREEN}✔${RESET} Low Context Hazard & Token Burn Risk`);

package/cli/audit/social.d.ts

@@ -28,6 +28,9 @@ export declare function resolveBadgeColor(score: number): string;
 export declare function resolveHotspotTierText(lineCount: number): string;
 export declare function resolvePillarProgressionBadge(isImproved: boolean, beforeStatus: string, afterStatus: string): string;
 export declare function formatWebUrl(url: string): string;
+export declare function resolveExcessCostPerPass(tokensObj?: any, fallbackCostPerMillion?: number): number;
+export declare function resolveMonthlyWastePerDev(tokensObj?: any, fallbackCostPerMillion?: number): number;
+export declare function resolveWeeklyWastePerDev(tokensObj?: any, fallbackCostPerMillion?: number): number;
 export declare function generateDiscussionContent(report: AuditReport, username: string, projectName?: string, repoUrl?: string, liveUrl?: string): DiscussionContent;
 export declare function generateTransformationDiscussionContent(beforeSnapshot: AuditSnapshot, afterSnapshot: AuditSnapshot, username: string, projectName?: string, repoUrl?: string, liveUrl?: string): DiscussionContent;
 export declare function publishDiscussionViaGh(repo: string, title: string, body: string, category?: string): { success: boolean; url: string | null; error?: string | null };