@chemx/starter-kit 26.9.12-93 → 26.9.13-272

package/cli/navigator-actions.js

@@ -29,6 +29,8 @@ import {
   buildAiSlopPrompt,
   buildHotspotsPrompt,
   buildMasterPrompt,
+  formatRoadmapSection,
+  buildSelfHealingRoadmapPrompt,
   copyToClipboard
 } from "./audit.js";
 import { resolveGradeBadge } from "./navigator-grades.js";
@@ -43,20 +45,23 @@ const isExtremeMonolith = (h) => h.lineCount >= 2000;
 const isSevereMonolith = (h) => h.lineCount >= 1000 && h.lineCount < 2000;
 const isWarningMonolith = (h) => h.lineCount >= 500 && h.lineCount < 1000;
 const isPassedPillar = (p) => p.status === "PASSED";
-const hasGradeItems = (g) => g.count > 0;
+const isFailedPillar = (p) => p.status === "FAILED";
+const isWarnPillar = (p) => p.status === "WARN";
 
 export const buildActiveGrades = (report) => {
   const { hotspots, violations, pillars } = report;
   const { critical, high, medium, low } = groupViolationsBySeverity(violations);
 
   const passedPillarsCount = Object.values(pillars || {}).filter(isPassedPillar).length;
+  const failedPillarsCount = Object.values(pillars || {}).filter(isFailedPillar).length;
+  const warnPillarsCount = Object.values(pillars || {}).filter(isWarnPillar).length;
 
   const extremeMonoliths = hotspots.filter(isExtremeMonolith);
   const severeMonoliths = hotspots.filter(isSevereMonolith);
   const warningMonoliths = hotspots.filter(isWarningMonolith);
 
-  const gradeFCount = critical.length + extremeMonoliths.length;
-  const gradeDCount = high.length + severeMonoliths.length;
+  const gradeFCount = critical.length + extremeMonoliths.length + failedPillarsCount;
+  const gradeDCount = high.length + severeMonoliths.length + warnPillarsCount;
   const gradeCCount = medium.length + warningMonoliths.length;
   const gradeBCount = low.length;
   const gradeACount = passedPillarsCount;
@@ -83,6 +88,7 @@ export const buildActiveGrades = (report) => {
 
   const gradeTiers = [
     {
+      key: "grade_a",
       grade: "A",
       count: gradeACount,
       icon: "✅",
@@ -90,6 +96,7 @@ export const buildActiveGrades = (report) => {
       action: handleGradeAAction
     },
     {
+      key: "grade_slop",
       grade: report.aiSlop?.grade || (slopViolations.length > 0 ? "D" : "A"),
       count: slopViolations.length,
       icon: "🤖",
@@ -97,6 +104,7 @@ export const buildActiveGrades = (report) => {
       action: handleSlopAction
     },
     {
+      key: "grade_b",
       grade: "B",
       count: gradeBCount,
       icon: "💣",
@@ -104,6 +112,7 @@ export const buildActiveGrades = (report) => {
       action: handleGradeBAction
     },
     {
+      key: "grade_c",
       grade: "C",
       count: gradeCCount,
       icon: "⚡",
@@ -111,6 +120,7 @@ export const buildActiveGrades = (report) => {
       action: handleGradeCAction
     },
     {
+      key: "grade_d",
       grade: "D",
       count: gradeDCount,
       icon: "🔥",
@@ -118,6 +128,7 @@ export const buildActiveGrades = (report) => {
       action: handleGradeDAction
     },
     {
+      key: "grade_f",
       grade: "F",
       count: gradeFCount,
       icon: "💥",
@@ -127,14 +138,14 @@ export const buildActiveGrades = (report) => {
   ];
 
   const createActiveGradeItem = (g) => ({
-    key: `grade_${g.grade.toLowerCase()}`,
+    key: g.key || `grade_${g.grade.toLowerCase()}`,
     grade: g.grade.toLowerCase(),
     tag: resolveGradeBadge(g.grade, 11),
     label: `${g.icon} Grade ${g.grade}: ${g.description} (${g.count} ${g.grade === "A" ? "clean" : "items"})`,
     action: g.action
   });
 
-  return gradeTiers.filter(hasGradeItems).map(createActiveGradeItem);
+  return gradeTiers.map(createActiveGradeItem);
 };
 
 export const buildDashboardActionGroups = ({ report, onScaffold = null, onRerun = null }) => {
@@ -149,6 +160,10 @@ export const buildDashboardActionGroups = ({ report, onScaffold = null, onRerun
     await showConversionMenu(onScaffold);
   };
 
+  const handleRoadmapAction = async () => {
+    await showPagedContent(formatRoadmapSection(report), buildSelfHealingRoadmapPrompt(report));
+  };
+
   const handleReportAction = async () => {
     await showPagedContent(formatTerminalReport(report), buildMasterPrompt(report));
   };
@@ -173,7 +188,12 @@ export const buildDashboardActionGroups = ({ report, onScaffold = null, onRerun
       output += formatTransformationTerminal(baseline, currentSnapshot);
     } else {
       output +=
-        "\n\x1b[33mNo baseline audit found. Current audit established as baseline.\x1b[0m\n";
+        "\n\x1b[33mNo baseline audit found. Current audit established as baseline floor.\x1b[0m\n";
+    }
+
+    const previousSnapshot = history.length > 1 ? history[history.length - 2] : null;
+    if (previousSnapshot && previousSnapshot.id !== baseline?.id) {
+      output += "\n\n" + formatTransformationTerminal(previousSnapshot, currentSnapshot, { isStepDelta: true });
     }
 
     if (history.length > 0) {
@@ -256,6 +276,13 @@ export const buildDashboardActionGroups = ({ report, onScaffold = null, onRerun
     action: handleUpgradeAction
   };
 
+  const roadmapAction = {
+    key: "roadmap",
+    tag: formatButtonTag("Roadmap", "\x1b[38;2;45;212;191m"),
+    label: "🌱 Self-Healing Fix Roadmap (Optimal Remediation Order & Pattern Harvesting)",
+    action: handleRoadmapAction
+  };
+
   const reportAction = {
     key: "report",
     tag: formatButtonTag("Full Report", "\x1b[36m"),
@@ -320,6 +347,7 @@ export const buildDashboardActionGroups = ({ report, onScaffold = null, onRerun
 
   return {
     installAction,
+    roadmapAction,
     upgradeAction,
     reportAction,
     rerunAction,

package/cli/navigator-banner.js

@@ -38,9 +38,11 @@ export const renderDashboardBanner = (
   highMediumCount,
   low,
   contextAnalysis = null,
-  aiSlop = null
+  aiSlop = null,
+  options = {}
 ) => {
-  if (process.stdout.isTTY) console.clear();
+  const shouldClear = options.clear ?? Boolean(options.interactive && process.stdout.isTTY);
+  if (shouldClear && process.stdout.isTTY) console.clear();
   process.stdout.write(getChemicalXAsciiBanner(health.grade));
 
   const gColor = resolveGradeColor(health.grade);

package/cli/navigator-menu.js

@@ -51,6 +51,12 @@ const isChoiceMatchingItem = (cleanChoice) => (item) => {
   ) {
     return true;
   }
+  if (
+    item.key === "roadmap" &&
+    (cleanChoice.includes("Roadmap") || cleanChoice.includes("Healing") || cleanChoice.includes("Self-Healing"))
+  ) {
+    return true;
+  }
   if (
     item.key === "rerun" &&
     (cleanChoice.includes("Re-Run") ||
@@ -99,6 +105,12 @@ const isChoiceMatchingItem = (cleanChoice) => (item) => {
   ) {
     return true;
   }
+  if (
+    item.key === "grade_slop" &&
+    (cleanChoice.includes("Slop") || cleanChoice.includes("Authenticity") || cleanChoice.includes("ASI"))
+  ) {
+    return true;
+  }
   if (
     item.grade &&
     (cleanChoice.toLowerCase().includes(`grade ${item.grade}`) ||
@@ -150,6 +162,12 @@ const isEffectiveMatchingItem = (effective, exitIndex) => (item) => {
   ) {
     return true;
   }
+  if (
+    item.key === "grade_slop" &&
+    (effective === "slop" || effective === "asi" || effective === "authenticity")
+  ) {
+    return true;
+  }
   if (item.key === effective) return true;
   if (item.grade && (effective === item.grade || effective === `grade ${item.grade}`)) {
     return true;

package/cli/navigator-share.js

@@ -107,7 +107,7 @@ export const handleShareToDiscussions = async (report) => {
   if (pubResult.success && pubResult.url) {
     if (pubResult.updated) {
       process.stdout.write(`\n\x1b[1m\x1b[32m✔ Successfully updated discussion topic #${pubResult.discussionNumber}!\x1b[0m\n`);
-      process.stdout.write('  \x1b[33mPrevious audit report was archived as a comment in the thread.\x1b[0m\n');
+      process.stdout.write('  \x1b[33mPrevious audit checkpoint was archived as a comment in the thread.\x1b[0m\n');
       process.stdout.write(`Discussion URL: \x1b[36m${pubResult.url}\x1b[0m\n\n`);
     } else {
       process.stdout.write(`\n\x1b[1m\x1b[32m✔ Successfully published discussion topic!\x1b[0m\nDiscussion URL: \x1b[36m${pubResult.url}\x1b[0m\n\n`);

package/cli/navigator.d.ts

@@ -31,6 +31,11 @@ export declare function extractPromptFromContent(content: string): string | null
 export declare function showPagedContent(content: string, promptText?: string | null): Promise<void>;
 export declare function showConversionMenu(onScaffold?: (() => Promise<void>) | null): Promise<void>;
 export declare function handleShareToDiscussions(report: AuditReport): Promise<void>;
+export interface DashboardBannerOptions {
+  readonly clear?: boolean;
+  readonly interactive?: boolean;
+}
+
 export declare function renderDashboardBanner(
   health: AuditReport['health'],
   metrics: AuditReport['metrics'],
@@ -38,7 +43,9 @@ export declare function renderDashboardBanner(
   critical: readonly unknown[],
   highMediumCount: number,
   low: readonly unknown[],
-  contextAnalysis?: AuditReport['contextAnalysis'] | null
+  contextAnalysis?: AuditReport['contextAnalysis'] | null,
+  aiSlop?: AuditReport['aiSlop'] | null,
+  options?: DashboardBannerOptions
 ): void;
 export declare function runInteractiveAuditNavigator(
   report: AuditReport,

package/cli/navigator.js

@@ -79,7 +79,7 @@ export const runInteractiveAuditNavigator = async (initialReport, onScaffold = n
   let activeGrades = buildActiveGrades(report);
   let actions = buildDashboardActionGroups({ report, onScaffold, onRerun: handleRerun });
 
-  renderDashboardBanner(health, metrics, violations, critical, highMediumCount, low, contextAnalysis, aiSlop);
+  renderDashboardBanner(health, metrics, violations, critical, highMediumCount, low, contextAnalysis, aiSlop, { interactive: true });
 
   const shouldPublish = await confirmAction(
     "Publish audit report and promote your project to our GitHub Discussions Audits Forum?",
@@ -93,14 +93,14 @@ export const runInteractiveAuditNavigator = async (initialReport, onScaffold = n
   }
 
   while (true) {
-    renderDashboardBanner(health, metrics, violations, critical, highMediumCount, low, contextAnalysis, aiSlop);
+    renderDashboardBanner(health, metrics, violations, critical, highMediumCount, low, contextAnalysis, aiSlop, { interactive: true, clear: true });
 
     const guardrailsInstalled = areGuardrailsInstalled(process.cwd());
     const topActions = [];
     if (!guardrailsInstalled) {
       topActions.push(actions.installAction);
     }
-    topActions.push(actions.upgradeAction, actions.reportAction, actions.rerunAction);
+    topActions.push(actions.roadmapAction, actions.upgradeAction, actions.reportAction, actions.rerunAction);
 
     const midActions = [];
     if (actions.hasHotspots) {

package/cli/terminal.js

@@ -1,5 +1,6 @@
 import readline from "node:readline";
 import { spawnSync } from "node:child_process";
+import { formatChemicalXGradient, ANSI } from "./theme.js";
 
 export const openBrowser = (url) => {
   const platform = process.platform;
@@ -70,18 +71,18 @@ export const renderBanner = (title = "Chemical X Protocol: Molecular Architectur
         "--border-foreground=45",
         "--foreground=81",
         "--bold",
-        `  ${title}\n  Zero-Context-Rot Scaffolding & Engineering Directives`
+        `  ${title}\n  The Secret Sauce to Vibe Coding | Zero-Context-Rot Directives`
       ],
       { stdio: "inherit" }
     );
   } else {
     process.stdout.write(
-      "\n\x1b[38;2;98;201;255m=====================================================\x1b[0m\n"
+      `\n${formatChemicalXGradient("=====================================================")}\n`
     );
-    process.stdout.write(`\x1b[1m\x1b[38;2;98;201;255m  ${title}\x1b[0m\n`);
-    process.stdout.write("  Zero-Context-Rot Scaffolding & Engineering Directives\n");
+    process.stdout.write(`  ${formatChemicalXGradient(title)}\n`);
+    process.stdout.write(`  ${ANSI.BOLD}${ANSI.GOLD}The Secret Sauce to Vibe Coding!${ANSI.RESET} ${ANSI.DIM}| Zero-Context-Rot Directives${ANSI.RESET}\n`);
     process.stdout.write(
-      "\x1b[38;2;98;201;255m=====================================================\x1b[0m\n\n"
+      `${formatChemicalXGradient("=====================================================")}\n\n`
     );
   }
 };

package/cli/theme.d.ts

@@ -0,0 +1,41 @@
+export interface ChemxGradientColor {
+  readonly r: number;
+  readonly g: number;
+  readonly b: number;
+  readonly ansi: string;
+}
+
+export declare const CHEMX_COLORS: {
+  readonly blossomPink: string;
+  readonly powerPurple: string;
+  readonly bubblesCyan: string;
+  readonly chemicalMint: string;
+  readonly buttercupLime: string;
+  readonly vibeGold: string;
+  readonly goldenRibbon: string;
+  readonly midnightViolet: string;
+  readonly obsidian: string;
+  readonly slateBorder: string;
+};
+
+export declare const CHEMX_RGB: {
+  readonly blossomPink: readonly [number, number, number];
+  readonly bubblesCyan: readonly [number, number, number];
+  readonly buttercupLime: readonly [number, number, number];
+  readonly vibeGold: readonly [number, number, number];
+};
+
+export declare const ANSI: {
+  readonly PINK: string;
+  readonly PURPLE: string;
+  readonly CYAN: string;
+  readonly MINT: string;
+  readonly LIME: string;
+  readonly GOLD: string;
+  readonly BOLD: string;
+  readonly DIM: string;
+  readonly RESET: string;
+};
+
+export declare function getChemicalXGradientColor(t: number): ChemxGradientColor;
+export declare function formatChemicalXGradient(text: string): string;

package/cli/theme.js

@@ -0,0 +1,84 @@
+/**
+ * Chemical X Protocol: Official Comic Book Color Palette
+ * Codified from Hall of the Gods Chemical X Vol. 1 Comic Book Edition
+ *
+ * Blossom Pink (#f43f85) -> Bubbles Cyan (#38bdf8) -> Buttercup Lime (#a3e635)
+ * Golden Ribbon: (#fbbf24) | Midnight Violet Armor: (#181126)
+ */
+
+export const CHEMX_COLORS = Object.freeze({
+  blossomPink: '#f43f85',
+  powerPurple: '#a855f7',
+  bubblesCyan: '#38bdf8',
+  chemicalMint: '#2dd4bf',
+  buttercupLime: '#a3e635',
+  vibeGold: '#fbbf24',
+  goldenRibbon: '#f59e0b',
+  midnightViolet: '#181126',
+  obsidian: '#090d16',
+  slateBorder: '#26354a'
+});
+
+export const CHEMX_RGB = Object.freeze({
+  blossomPink: [244, 63, 133],
+  bubblesCyan: [56, 189, 248],
+  buttercupLime: [163, 230, 53],
+  vibeGold: [251, 191, 36]
+});
+
+export const ANSI = Object.freeze({
+  PINK: '\x1b[38;2;244;63;133m',
+  PURPLE: '\x1b[38;2;168;85;247m',
+  CYAN: '\x1b[38;2;56;189;248m',
+  MINT: '\x1b[38;2;45;212;191m',
+  LIME: '\x1b[38;2;163;230;53m',
+  GOLD: '\x1b[38;2;251;191;36m',
+  BOLD: '\x1b[1m',
+  DIM: '\x1b[2m',
+  RESET: '\x1b[0m'
+});
+
+export const getChemicalXGradientColor = (t) => {
+  const clamped = Math.max(0, Math.min(1, t));
+  let r = 0;
+  let g = 0;
+  let b = 0;
+
+  if (clamped < 0.45) {
+    const factor = clamped / 0.45;
+    r = Math.round(244 * (1 - factor) + 56 * factor);
+    g = Math.round(63 * (1 - factor) + 189 * factor);
+    b = Math.round(133 * (1 - factor) + 248 * factor);
+  } else {
+    const factor = (clamped - 0.45) / 0.55;
+    r = Math.round(56 * (1 - factor) + 163 * factor);
+    g = Math.round(189 * (1 - factor) + 230 * factor);
+    b = Math.round(248 * (1 - factor) + 53 * factor);
+  }
+
+  return {
+    r,
+    g,
+    b,
+    ansi: `\x1b[38;2;${r};${g};${b}m`
+  };
+};
+
+export const formatChemicalXGradient = (text) => {
+  if (!text) return '';
+  const len = text.length;
+  if (len === 1) return `${ANSI.PINK}${ANSI.BOLD}${text}${ANSI.RESET}`;
+
+  let out = '';
+  for (let i = 0; i < len; i++) {
+    const ch = text[i];
+    if (ch === ' ') {
+      out += ' ';
+      continue;
+    }
+    const t = i / (len - 1);
+    const { ansi } = getChemicalXGradientColor(t);
+    out += `${ansi}${ANSI.BOLD}${ch}${ANSI.RESET}`;
+  }
+  return out;
+};

package/docs/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to the Chemical X Starter Kit repository will be documented
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [2026-09-12]
+
+### Added
+- Added Build Auditor wrapper command (`chemx build`, aliases `run`, `wrap`) with token-optimized silent execution (`cli/build.js`, `cli/build/`):
+  - Wraps arbitrary or auto-detected build scripts (`pnpm run build`, `yarn build`, `bun run build`, `npm run build`, `vite build`, `tsc --noEmit`).
+  - Automatically parses and catalogs TypeScript (`TS*`), Rollup/Vite resolution, Sass/PostCSS syntax, and bundle budget errors into structured diagnostic categories with 1-line remediation hints.
+  - Implemented `--json` output flag emitting structured machine-readable error envelopes for AI agents, and `--silent` flag for zero-noise terminal output on successful builds.
+- Added automated pull request comment step to Chemical X Gatekeeper workflows (`.github/workflows/chemx-audit.yml`, `blueprints/workflows/chemx-audit.yml`, `cli/installer-templates.js`) that renders the full audit report with an architectural discussion topic link, updating existing PR comments idempotently.
+
+### Fixed
+- Fixed GitHub Actions runner failure in `chemx-audit.yml` workflows by removing `cache: npm` when no package lockfile exists.
+- Upgraded runner `node-version` from deprecated 20 to 22 across CI workflows and installer templates (`.github/workflows/chemx-audit.yml`, `blueprints/workflows/chemx-audit.yml`, `cli/installer-templates.js`).
+- Standardized non-interactive CLI audit mode to output the clean Gamer HUD scorecard banner without interactive menu options.
+- Preserved clean stdout in workflows by writing markdown reports to `--output` files without dumping raw markdown to the terminal.
+- Replaced top-level synchronous config directory creation in `cli/license.js` with lazy `ensureConfigDir` and `toResultSync` Result Tuple pattern.
+
 ## [2026-09-08]
 
 ### Added
@@ -19,7 +35,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ## [2026-09-11]
 
 ### Added
+- Standardized the Chemical X color palette across the starter kit to match the official Hall of the Gods Chemical X Vol. 1 Comic Book cover:
+  - Created centralized palette module (`cli/theme.js`, `cli/theme.d.ts`) codifying Blossom Pink (`#f43f85`), Power Purple (`#a855f7`), Bubbles Cyan (`#38bdf8`), Chemical Mint (`#2dd4bf`), Buttercup Lime (`#a3e635`), Vibe Gold (`#fbbf24`), Golden Ribbon (`#f59e0b`), and Midnight Violet armor (`#181126`).
+  - Updated 24-bit TrueColor ASCII art banner (`getChemicalXAsciiBanner` in `cli/audit/reporter-banner.js`) with 3-phase gradient (Blossom Pink -> Bubbles Cyan -> Buttercup Lime) and golden ribbon motto styling (`The Secret Sauce to Vibe Coding!`).
+  - Upgraded terminal banner renderer (`renderBanner` in `cli/terminal.js`) with TrueColor gradient border and title formatting.
+  - Enhanced Verified Chemical X Footer Badge SVG asset generator (`generateSvgBadgeSnippet` in `cli/badge.js`) with embedded `<linearGradient id="chemx-comic">` border and updated HTML snippet.
+  - Aligned `m-chemx-badge` blueprint capsule styles (`_m-chemx-badge.scss`) with the official comic palette for hover glow and grade badges.
 - Expanded AST static analysis engine with Pillars 8 to 11 (`cli/audit/extended-visitors.js`): added automated rules and visitors for Accessibility & Semantic Integrity (`A11Y_CLICKABLE_NON_SEMANTIC`, `A11Y_IMAGE_MISSING_ALT`), Security & Content Safety (`SECURITY_RAW_HTML_INJECTION`, `SECURITY_HARDCODED_SECRET`), Testing Discipline (`TEST_FAKE_GREEN`, `TEST_MISSING_COLOCATED`), and Naming Conventions (`NAMING_BARE_BOOLEAN`, `NAMING_HANDLER_PREFIX`).
+- Implemented nested bullet tree path-chain formatter (`formatGroupedPromptViolations` in `cli/audit/prompts.js` and `renderGroupedViolationsTerminal` in `cli/audit/reporter-grouping.js`), clustering violations by rule and rendering folder hierarchy steps as indented bullet chains with `📁` folder emojis and ANSI severity colors (`📁 app/` -> `📁 components/` -> `📁 molecules/` -> leaf files with line hits) to eliminate boilerplate repetitions and slash AI prompt token consumption by up to 85%.
+- Consolidated monolith refactoring action directives across `buildHotspotsPrompt`, `buildGradeFPrompt`, `buildGradeDPrompt`, and `buildGradeCPrompt`, stating action requirements once per section.
+- Added `{ excludeAiSlop }` filter options to grade prompt builders to prevent duplicate slop violation listings in `buildMasterPrompt`.
+- Added `{ includePrompt: false }` flag to `formatHotspotsSection` and `formatAiSlopSection` when rendered within full terminal report (`cli/audit/reporter.js`), preventing mid-report prompt box duplication before the master prompt.
 - Added AI Agent refactoring prompt generator for AI Slop & Authenticity (`buildAiSlopPrompt` in `cli/audit/prompts.js`), generating surgical instructions to eliminate conversational residue, lazy placeholders, echo comments, shallow catch blocks, and reinvented utilities.
 - Added AI Agent refactoring prompt generator for Top Refactoring Hotspots (`buildHotspotsPrompt` in `cli/audit/prompts.js`), providing phased decomposition plans for files exceeding line budgets.
 - Integrated AI Slop and Hotspots prompt boxes into report sections (`formatAiSlopSection`, `formatHotspotsSection` in `cli/audit/reporter-sections.js`), composite master prompt (`buildMasterPrompt`), and interactive navigator inspection views (`cli/navigator-actions.js`, `cli/navigator.js`, `cli/navigator-menu.js`).
@@ -194,4 +220,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Excluded 3rd-party `vendor` and `build` directories, as well as minified bundles (`*.min.*`), from the AST context hazard audit to eliminate false positives on bundled external libraries.
 - Fixed argument ordering in `gumChoose` to pass `--header` and styling flags to the `choose` subcommand rather than prepending to the parent binary.
 
+## [2026-09-12]
 
+### Added
+- Pre-Split Pattern Discovery & Harmonization Protocol added to `AGENTS.md` (Section 1.F): mandates cross-file pattern discovery, design-system foundation mapping, and canonical extraction prior to code splitting monoliths.
+- Updated AST audit refactoring prompt generators (`buildGradeFPrompt` and `buildHotspotsPrompt` in `cli/audit/prompts.js`) to enforce Pre-Split Pattern Discovery in generated AI directives.
+- Structural Pattern Harmonization Detector module (`cli/audit/pattern-detector.js`): single-pass AST fingerprinting to detect cross-file clones (shared state machine unions, composite JSX layouts, multi-clause boolean predicates, parallel hook return signatures) without quadratic diffing overhead.
+- Self-Healing Remediation Roadmap engine (`cli/audit/roadmap.js`): calculates optimal 5-phase refactoring sequence (Pattern Harvesting -> Domain Foundations -> Monolith Slicing -> Component Hygiene -> Automated Gatekeeping) so early canonical extractions compound and self-sustain subsequent monolith slicing.
+- Integrated dedicated grade report card sections (`formatGradeASection`, `formatGradeBSection`, `formatGradeCSection`, `formatGradeDSection`, and `formatGradeFSection`) into the full terminal audit report (`formatTerminalReport` in `cli/audit/reporter.js`) with `{ includePrompt: false }` option.
+- Permanent grade accessibility in Audit Navigator menu (`cli/navigator-actions.js`): eliminated `hasGradeItems` filtering so all grade tiers (Grade A, AI Slop, Grade B, Grade C, Grade D, and Grade F) remain visible and navigable at all times, matching the full report.
+- Synchronized hazard counts in `buildActiveGrades` (`cli/navigator-actions.js`): included failed and warned pillars in Grade F and Grade D totals to match the grade report card totals.
+- Automatic baseline floor calculation in `cli/audit/history.js`: resolved audit baseline to the lowest historical MHI score in `history.json`, ensuring before and after deltas accurately measure total debt reduction.
+- Dual-delta progress display in `cli/navigator-actions.js` and `cli/audit/history.js`: `[ Progress ]` action shows cumulative transformation delta against baseline floor and incremental step delta against immediately preceding audit snapshot.
+- Discussion thread living showcase architecture in `cli/audit/social-publisher.js` and `cli/navigator-share.js`: primary topic stays as the living showcase dashboard while subsequent audits post as checkpoint comments in the thread.
+- 7-Pillar emoji reaction badges strip in terminal audit reports (`formatPillarReactionBadgesTerminal` in `cli/audit/reporter-utils.js` and `formatPillarsSection` in `cli/audit/reporter-sections.js`), prepending `[ <icon> ]` to matrix rows and rendering colored compact status reaction badges (`PASS`, `WARN`, `FAIL`).
+- Markdown compliance matrix and GitHub Discussions integration (`formatPillarReactionBadgesMarkdown` in `cli/audit/reporter-utils.js`, `generateMarkdownReport` in `cli/audit/reporter-markdown.js`, `generateDiscussionContent` and `generateTransformationDiscussionContent` in `cli/audit/social.js`), embedding formatted reaction badge strips above compliance and progression tables in exports and checkpoint comments.
+- Public API exports and typings for `formatPillarReactionBadgesTerminal` and `formatPillarReactionBadgesMarkdown` in `cli/audit/reporter.js`, `cli/audit/reporter.d.ts`, and `cli/audit.js`.
+- Git Branching & Pull Request Workflow added to self-healing remediation roadmap (`buildRemediationRoadmap` and `buildSelfHealingRoadmapPrompt` in `cli/audit/roadmap.js`), hotspots refactoring prompt execution rules (`cli/audit/prompts.js`), and `AGENTS.md` (Section 1.G): instructs developers and agents to change to a dedicated branch prefixed with `chem-x/NAMEOFIMPROVEMENT` before modifying code, commit changes atomically on the branch, and create a Pull Request to `main`.
+- Shields.io pillar and showcase badge strips across the top of audit reports:
+  - Added `formatPillarShieldBadges(pillars)` and `PILLAR_SHORT_NAMES` in `cli/audit/reporter-utils.js` to render Shields.io `style=for-the-badge` badges for all 11 pillars with emojis, compact short names, live status (`PASS`, `WARN <count>`, `FAIL <count>`), and signature Chemical X colors.
+  - Positioned prominent Shields.io showcase badges and the 11-pillar badge strip across the top of GitHub Discussions single audit showcase reports (`generateDiscussionContent` in `cli/audit/social.js`), Before vs. After transformation showcase reports (`generateTransformationDiscussionContent` in `cli/audit/social.js`), and Markdown audit exports (`generateMarkdownReport` in `cli/audit/reporter-markdown.js`).
+  - Added public exports and TypeScript declarations for `formatPillarShieldBadges`, `resolveBadgeColor`, and `PILLAR_SHORT_NAMES` in `cli/audit/reporter.js`, `cli/audit/reporter.d.ts`, and `cli/audit.js`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chemx/starter-kit",
-  "version": "26.9.12-93",
+  "version": "26.9.13-272",
   "description": "Chemical X Protocol: Private drop-in architecture starter kit and capsule generator",
   "type": "module",
   "bin": {
@@ -20,7 +20,8 @@
   ],
   "exports": {
     ".": "./cli/index.js",
-    "./audit": "./cli/audit.js"
+    "./audit": "./cli/audit.js",
+    "./build": "./cli/build.js"
   },
   "scripts": {
     "publish:both": "node scripts/publish-both.mjs",