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

package/cli/audit/social.js

@@ -38,9 +38,9 @@ export const resolveBadgeColor = (score) => {
 };
 
 export const resolveHotspotTierText = (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';
 };
 
@@ -62,6 +62,25 @@ export const formatWebUrl = (url) => {
   return `[${href}](${href})`;
 };
 
+export const resolveExcessCostPerPass = (tokensObj, fallbackCostPerMillion = 3.0) => {
+  if (tokensObj?.excessCostPerPass !== undefined) return tokensObj.excessCostPerPass;
+  const costPerMillion = tokensObj?.costPerMillion || fallbackCostPerMillion;
+  const excess = tokensObj?.estimatedExcessTokens || 0;
+  return Number(((excess / 1000000) * costPerMillion).toFixed(3));
+};
+
+export const resolveMonthlyWastePerDev = (tokensObj, fallbackCostPerMillion = 3.0) => {
+  if (tokensObj?.monthlyWastePerDev !== undefined) return tokensObj.monthlyWastePerDev;
+  const pass = resolveExcessCostPerPass(tokensObj, fallbackCostPerMillion);
+  return Number((pass * 20 * 5 * 4).toFixed(2));
+};
+
+export const resolveWeeklyWastePerDev = (tokensObj, fallbackCostPerMillion = 3.0) => {
+  if (tokensObj?.weeklyWastePerDev !== undefined) return tokensObj.weeklyWastePerDev;
+  const pass = resolveExcessCostPerPass(tokensObj, fallbackCostPerMillion);
+  return Number((pass * 20 * 5).toFixed(2));
+};
+
 export const generateDiscussionContent = (report, username, projectName = 'Codebase', repoUrl = '', liveUrl = '') => {
   const { health, metrics, pillars, hotspots, contextAnalysis, violations } = report;
   const isHighScoring = health.score >= 80;
@@ -90,8 +109,14 @@ export const generateDiscussionContent = (report, username, projectName = 'Codeb
     }
   }
   lines.push(`* **Molecular Health Index**: **${health.score} / 100** (Grade: **${health.grade}** - ${health.label})`);
-  lines.push(`* **Source Files Analyzed**: ${metrics.scannedFiles} files (${metrics.totalLoc} total LOC)`);
+  lines.push(`* **Source Files Analyzed**: ${metrics.scannedFiles} files (${metrics.totalLoc} total lines of code)`);
   lines.push(`* **Token Reduction Potential**: **${contextAnalysis.potentialSavingsPct}%** (Estimated ${contextAnalysis.estimatedTokens.toLocaleString()} tokens)`);
+  const costPass = resolveExcessCostPerPass(contextAnalysis);
+  const costMonth = resolveMonthlyWastePerDev(contextAnalysis);
+  const costWeek = resolveWeeklyWastePerDev(contextAnalysis);
+  const pricingModel = contextAnalysis?.pricingModel || 'Frontier Blended ($3.00/1M)';
+  lines.push(`* **Monolith Cost per Turn**: **$${costPass.toFixed(3)}** (${pricingModel})`);
+  lines.push(`* **Projected Dev Context Tax**: **$${costMonth.toFixed(2)} / mo** per engineer ($${costWeek.toFixed(2)} / wk)`);
   lines.push('');
   lines.push('---');
   lines.push('');
@@ -130,11 +155,11 @@ export const generateDiscussionContent = (report, username, projectName = 'Codeb
   lines.push('');
   lines.push('## 2. Monolith & Architectural Hazard Summary');
   lines.push('');
-  lines.push(`* **Monolith Files (> 500 LOC)**: **${totalMonoliths} files**`);
+  lines.push(`* **Monolith Files (> 500 lines of code)**: **${totalMonoliths} files**`);
   if (totalMonoliths > 0) {
-    lines.push(`  * Warning Tier (500 - 999 LOC): ${warningMonoliths} files`);
-    lines.push(`  * Severe Tier (1,000 - 1,999 LOC): ${severeMonoliths} files`);
-    lines.push(`  * Extreme Monoliths (2,000+ LOC): ${extremeMonoliths} files`);
+    lines.push(`  * Warning Tier (500 - 999 lines of code): ${warningMonoliths} files`);
+    lines.push(`  * Severe Tier (1,000 - 1,999 lines of code): ${severeMonoliths} files`);
+    lines.push(`  * Extreme Monoliths (2,000+ lines of code): ${extremeMonoliths} files`);
   }
   lines.push(`* **Hazard Breakdown**: Critical: **${critical.length}** | High/Med: **${high.length + medium.length}** | Low: **${low.length}**`);
   lines.push('');
@@ -146,7 +171,7 @@ export const generateDiscussionContent = (report, username, projectName = 'Codeb
     lines.push('This project follows Chemical X Molecular Architecture principles with isolated capsules and self-cleaning hooks.');
   } else {
     lines.push('### Seeking Refactoring Feedback');
-    lines.push('Looking for recommendations on breaking down flagged monolithic debts into crystalline molecule capsules (< 100 LOC). Any advice is welcome!');
+    lines.push('Looking for recommendations on breaking down flagged monolithic debts into crystalline molecule capsules (< 100 lines of code). Any advice is welcome!');
   }
   lines.push('');
   lines.push('*Audited using [Chemical X Protocol Starter Kit](https://github.com/Chemical-X-Protocol/awesome-secret-sauce).*');
@@ -187,6 +212,28 @@ export const generateTransformationDiscussionContent = (
     return isGood ? `🟢 **${sign}**` : `🔴 **${sign}**`;
   };
 
+  const costPassBefore = resolveExcessCostPerPass(beforeSnapshot.tokens);
+  const costPassAfter = resolveExcessCostPerPass(afterSnapshot.tokens);
+  const costPassDelta = Number((costPassAfter - costPassBefore).toFixed(3));
+
+  const monthlyTaxBefore = resolveMonthlyWastePerDev(beforeSnapshot.tokens);
+  const monthlyTaxAfter = resolveMonthlyWastePerDev(afterSnapshot.tokens);
+  const monthlyTaxDelta = Number((monthlyTaxAfter - monthlyTaxBefore).toFixed(2));
+
+  const formatCostPassDelta = (val) => {
+    if (val === 0) return '0 (No change)';
+    const isGood = val < 0;
+    const sign = val > 0 ? `+$${val.toFixed(3)}` : `-$${Math.abs(val).toFixed(3)}`;
+    return isGood ? `🟢 **${sign}**` : `🔴 **${sign}**`;
+  };
+
+  const formatMonthlyTaxDelta = (val) => {
+    if (val === 0) return '0 (No change)';
+    const isGood = val < 0;
+    const sign = val > 0 ? `+$${val.toFixed(2)}/mo` : `-$${Math.abs(val).toFixed(2)}/mo`;
+    return isGood ? `🟢 **${sign}**` : `🔴 **${sign}**`;
+  };
+
   const lines = [];
   lines.push(`# 🚀 Architectural Transformation: ${projectName}`);
   lines.push('');
@@ -214,8 +261,10 @@ export const generateTransformationDiscussionContent = (
   lines.push(`| **Molecular Health (MHI)** | ${scoreBefore} / 100 (${beforeSnapshot.health.grade}) | ${scoreAfter} / 100 (${afterSnapshot.health.grade}) | ${formatDelta(scoreDelta)} |`);
   lines.push(`| **Critical Hazards** | ${beforeSnapshot.violations.critical} | ${afterSnapshot.violations.critical} | ${formatDelta(critDelta, true)} |`);
   lines.push(`| **Total Violations** | ${beforeSnapshot.violations.total} | ${afterSnapshot.violations.total} | ${formatDelta(totalDelta, true)} |`);
-  lines.push(`| **Monolith Files (>500 LOC)** | ${beforeSnapshot.monoliths.total} | ${afterSnapshot.monoliths.total} | ${formatDelta(monoDelta, true)} |`);
+  lines.push(`| **Monolith Files (> 500 lines of code)** | ${beforeSnapshot.monoliths.total} | ${afterSnapshot.monoliths.total} | ${formatDelta(monoDelta, true)} |`);
   lines.push(`| **Excess Token Burn** | ${beforeSnapshot.tokens.estimatedExcessTokens.toLocaleString()} tok | ${afterSnapshot.tokens.estimatedExcessTokens.toLocaleString()} tok | ${formatDelta(tokensDelta, true)} |`);
+  lines.push(`| **Monolith Cost per Turn** | $${costPassBefore.toFixed(3)} | $${costPassAfter.toFixed(3)} | ${formatCostPassDelta(costPassDelta)} |`);
+  lines.push(`| **Dev Context Tax (Monthly)** | $${monthlyTaxBefore.toFixed(2)}/mo | $${monthlyTaxAfter.toFixed(2)}/mo | ${formatMonthlyTaxDelta(monthlyTaxDelta)} |`);
   lines.push('');
   lines.push('---');
   lines.push('');
@@ -241,7 +290,7 @@ export const generateTransformationDiscussionContent = (
   lines.push('---');
   lines.push('');
   lines.push('### Community Takeaway');
-  lines.push('Refactored using Chemical X Molecular Architecture standards. Monoliths decomposed into crystalline domain capsules (< 100 LOC) with self-cleaning hooks.');
+  lines.push('Refactored using Chemical X Molecular Architecture standards. Monoliths decomposed into crystalline domain capsules (< 100 lines of code) with self-cleaning hooks.');
   lines.push('');
   lines.push('*Transformation tracked via [Chemical X Protocol Starter Kit](https://github.com/Chemical-X-Protocol/awesome-secret-sauce).*');
 

package/cli/audit/types.d.ts

@@ -58,6 +58,11 @@ export interface ContextTokenAnalysis {
   readonly estimatedExcessTokens: number;
   readonly potentialSavingsPct: number;
   readonly riskLevel: RiskLevel;
+  readonly pricingModel?: string;
+  readonly costPerMillion?: number;
+  readonly excessCostPerPass?: number;
+  readonly weeklyWastePerDev?: number;
+  readonly monthlyWastePerDev?: number;
 }
 
 export interface HotspotFile {
@@ -117,6 +122,10 @@ export declare function formatGradeCSection(report: AuditReport): string;
 export declare function formatGradeBSection(report: AuditReport): string;
 export declare function formatGradeASection(report: AuditReport): string;
 export declare function getChemicalXAsciiBanner(gradeOrReport?: string | AuditReport | null): 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;
+export declare const REPORT_CARD_ASCII: readonly string[];
+export declare function getReportCardAsciiLines(color?: string): readonly string[];
 
 export * from './social';
 

package/cli/audit.js

@@ -27,7 +27,11 @@ import {
   formatGradeCSection,
   formatGradeBSection,
   formatGradeASection,
-  getChemicalXAsciiBanner
+  getChemicalXAsciiBanner,
+  getAsciiGradeLines,
+  formatAsciiGrade,
+  getReportCardAsciiLines,
+  REPORT_CARD_ASCII
 } from './audit/reporter.js';
 
 const IGNORED_DIRS = new Set([
@@ -207,7 +211,11 @@ export {
   formatGradeCSection,
   formatGradeBSection,
   formatGradeASection,
-  getChemicalXAsciiBanner
+  getChemicalXAsciiBanner,
+  getAsciiGradeLines,
+  formatAsciiGrade,
+  getReportCardAsciiLines,
+  REPORT_CARD_ASCII
 };
 
 export default {
@@ -233,6 +241,10 @@ export default {
   formatGradeBSection,
   formatGradeASection,
   getChemicalXAsciiBanner,
+  getAsciiGradeLines,
+  formatAsciiGrade,
+  getReportCardAsciiLines,
+  REPORT_CARD_ASCII,
   PILLARS,
   RULE_REGISTRY
 };

package/cli/help.js

@@ -25,7 +25,7 @@ export const printHelp = () => {
     '',
     `  ${CYAN}generate${RESET} <m-name>  ${DIM}(aliases: capsule, add)${RESET}`,
     `      Scaffold an isolated crystalline molecule capsule directory:`,
-    `        ${DIM}- ${RESET}<m-name>/<m-name>.tsx  ${DIM}(declarative component < 50 LOC)${RESET}`,
+    `        ${DIM}- ${RESET}<m-name>/<m-name>.tsx  ${DIM}(declarative component < 50 lines of code)${RESET}`,
     `        ${DIM}- ${RESET}<m-name>/types.d.ts     ${DIM}(props and emits interfaces)${RESET}`,
     `        ${DIM}- ${RESET}<m-name>/index.ts        ${DIM}(clean public barrel export)${RESET}`,
     `      Free evaluation mode supported with non-blocking license reminder.`,
@@ -35,12 +35,12 @@ export const printHelp = () => {
     `      ${YELLOW}[PAID]${RESET} Drop full Chemical X blueprints, core hooks (toResult,`,
     `      useAsyncData, useSelfCleaningTimer), and AGENTS.md directives into`,
     `      an existing codebase. Default destination: ${CYAN}src/chemical-x${RESET}.`,
-    `      Requires Single Dev ($27) or Team Power Puff 💯 ($47: 100 Seats) license.`,
+    `      Requires Single Dev ($27) or Team Power Puff ($97: Unlimited Lifetime) license.`,
     '',
     `  ${CYAN}create${RESET} [directory]  ${DIM}(or: npm create chemx [directory])${RESET}`,
     `      ${YELLOW}[PAID]${RESET} Scaffold a complete, clean-slate project wired with full`,
     `      Chemical X molecular standards, pre-commit line budget hooks, and rules.`,
-    `      Requires Single Dev ($27) or Team Power Puff 💯 ($47: 100 Seats) license.`,
+    `      Requires Single Dev ($27) or Team Power Puff ($97: Unlimited Lifetime) license.`,
     '',
     `  ${CYAN}install-hooks${RESET} [directory]  ${DIM}(aliases: hook, setup-ci)${RESET}`,
     `      ${GREEN}[FREE]${RESET} Install git pre-commit hook (.git/hooks/pre-commit) and`,
@@ -95,7 +95,7 @@ export const printHelp = () => {
     '',
     `  ${CYAN}--license=<key>${RESET}`,
     `      Pass Chemical X Sponsor or Team license key non-interactively via CLI.`,
-    `      Tiers: Single Dev ($27) | Team Power Puff 💯 ($47: 100 Device Seats / Honor System).`,
+    `      Tiers: Single Dev ($27) | Team Power Puff ($97: Unlimited Lifetime).`,
     '',
     `${BOLD}ENVIRONMENT VARIABLES${RESET}`,
     `  ${GREEN}CHEMX_MIN_GRADE${RESET}`,

package/cli/installer-templates.js

@@ -31,9 +31,20 @@ if [ "\$FAILED" -eq 1 ]; then
   printf "\\n\\033[1m\\033[31m[Chemical X] Commit Blocked: Staged files exceed architectural line budgets\\033[0m\\n\$ERRORS\\n\\n"
 fi
 
-if command -v npx >/dev/null 2>&1; then
+AUDIT_BIN=""
+if [ -f "./cli/index.js" ]; then
+  AUDIT_BIN="node ./cli/index.js"
+elif [ -x "./node_modules/.bin/chemx" ]; then
+  AUDIT_BIN="./node_modules/.bin/chemx"
+elif command -v chemx >/dev/null 2>&1; then
+  AUDIT_BIN="chemx"
+elif command -v npx >/dev/null 2>&1; then
+  AUDIT_BIN="npx chemx"
+fi
+
+if [ -n "\$AUDIT_BIN" ]; then
   printf "\\033[38;2;98;201;255m[Chemical X] Verifying architectural health (Min Grade: %s, Min Score: %s)...\\033[0m\\n" "\$MIN_GRADE" "\$MIN_SCORE"
-  if ! npx chemx audit --min-grade="\$MIN_GRADE" --min-score="\$MIN_SCORE" --prompt-on-fail; then
+  if ! \$AUDIT_BIN audit --min-grade="\$MIN_GRADE" --min-score="\$MIN_SCORE" --prompt-on-fail; then
     printf "\\n\\033[1m\\033[31m[Chemical X] Commit Blocked: Codebase falls below required Grade %s (Score %s)\\033[0m\\n" "\$MIN_GRADE" "\$MIN_SCORE"
     printf "\\033[36m💡 Tip: Want crystalline drop-in templates? Run 'npm create chemx' or sponsor at https://github.com/sponsors/Chemical-X-Protocol\\033[0m\\n\\n"
     exit 1

package/cli/installer.d.ts

@@ -17,4 +17,5 @@ export declare function buildGitHubWorkflowScript(minGrade?: string, minScore?:
 export declare function installPreCommitHook(targetDir?: string, options?: InstallOptions): boolean;
 export declare function installGitHubWorkflow(targetDir?: string, options?: InstallOptions): boolean;
 export declare function saveProjectConfig(targetDir?: string, config?: Partial<ProjectConfig>): void;
+export declare function areGuardrailsInstalled(targetDir?: string): boolean;
 export declare function runInstallWizard(targetDir?: string): Promise<void>;

package/cli/installer.js

@@ -30,6 +30,54 @@ export const saveProjectConfig = (targetDir = '.', config = {}) => {
   process.stdout.write(`  \x1b[32m✔\x1b[0m Saved project settings to: .chemx/config.json\n`);
 };
 
+export const areGuardrailsInstalled = (targetDir = '.') => {
+  const resolvedTarget = path.resolve(targetDir);
+  const wfPath = path.join(resolvedTarget, '.github', 'workflows', 'chemx-audit.yml');
+  const hasWf = fs.existsSync(wfPath);
+
+  const gitPath = path.join(resolvedTarget, '.git');
+  let hasGit = false;
+  let hooksDir = null;
+
+  if (fs.existsSync(gitPath)) {
+    try {
+      const stat = fs.statSync(gitPath);
+      if (stat.isDirectory()) {
+        hasGit = true;
+        hooksDir = path.join(gitPath, 'hooks');
+      } else if (stat.isFile()) {
+        hasGit = true;
+        const gitContent = fs.readFileSync(gitPath, 'utf-8');
+        const match = gitContent.match(/gitdir:\s*(.+)/);
+        if (match) {
+          hooksDir = path.resolve(resolvedTarget, match[1].trim(), 'hooks');
+        }
+      }
+    } catch {
+      hasGit = false;
+    }
+  }
+
+  if (!hasGit) {
+    return hasWf;
+  }
+
+  let hasHook = false;
+  if (hooksDir) {
+    const hookPath = path.join(hooksDir, 'pre-commit');
+    if (fs.existsSync(hookPath)) {
+      try {
+        const hookContent = fs.readFileSync(hookPath, 'utf-8');
+        hasHook = hookContent.includes('Chemical X') || hookContent.includes('chemx');
+      } catch {
+        hasHook = false;
+      }
+    }
+  }
+
+  return hasWf && hasHook;
+};
+
 export const runInstallWizard = async (targetDir = '.') => {
   const isGit = fs.existsSync(path.resolve(targetDir, '.git'));
   process.stdout.write('\n\x1b[1m\x1b[38;2;98;201;255mChemical X: Architecture Guardrail Installer\x1b[0m\n\n');

package/cli/license.js

@@ -83,7 +83,7 @@ export const obtainLicenseKey = async (rawArgs = [], onRunAudit = null) => {
       [
         '1. Visit chemicalx.xophz.com to learn more',
         '2. Buy Standard Vault: Single Dev License ($27) -> Launch Checkout',
-        '3. Buy Team Power Puff: 100 Devs / Seats ($47) -> Launch Checkout',
+        '3. Buy Team Power Puff: Unlimited Lifetime ($97) -> Launch Checkout',
         '4. Enter License Key (CX-XXXX-XXXX-XXXX)',
         '5. Run Free Public Audit (npx chemx audit)',
         '6. Exit'
@@ -106,7 +106,7 @@ export const obtainLicenseKey = async (rawArgs = [], onRunAudit = null) => {
     }
 
     if (choice.startsWith('3.')) {
-      process.stdout.write(`\x1b[36mOpening Team Power Puff checkout (100 Devs / 100 Seats) in default browser:\x1b[0m ${URL_MASTER}\n`);
+      process.stdout.write(`\x1b[36mOpening Team Power Puff checkout (Unlimited Lifetime) in default browser:\x1b[0m ${URL_MASTER}\n`);
       openBrowser(URL_MASTER);
       process.stdout.write('\nOnce completed, paste your Sponsor / VIP License Key below.\n');
       return gumInput('License Key (CX-XXXX-XXXX-XXXX):', 'CX-XXXX-XXXX-XXXX');
@@ -131,7 +131,7 @@ export const obtainLicenseKey = async (rawArgs = [], onRunAudit = null) => {
   process.stdout.write('\x1b[1mChemical X Scaffolding Requires a Paid License:\x1b[0m\n');
   process.stdout.write('  [1] Visit chemicalx.xophz.com to learn more\n');
   process.stdout.write('  [2] Buy Standard Vault: Single Dev License ($27) - Opens browser\n');
-  process.stdout.write('  [3] Buy Team Power Puff: 100 Devs / Seats ($47) - Opens browser\n');
+  process.stdout.write('  [3] Buy Team Power Puff: Unlimited Lifetime ($97) - Opens browser\n');
   process.stdout.write('  [4] Enter License Key\n');
   process.stdout.write('  [5] Run Free Public Audit (npx chemx audit)\n');
   process.stdout.write('  [6] Exit\n\n');
@@ -190,7 +190,7 @@ export const checkOrPromptEvaluation = async (actionLabel = 'generate capsule')
         '--bold',
         '⚡ Chemical X: Evaluation Mode (Unlicensed)\n' +
         'Support vibe coding standards: chemicalx.xophz.com\n' +
-        'Single Dev ($27) | Team Power Puff 💯 (100 Seats: $47)'
+        'Single Dev ($27) | Team Power Puff ($97: Unlimited Lifetime)'
       ],
       { stdio: 'inherit' }
     );
@@ -198,8 +198,8 @@ export const checkOrPromptEvaluation = async (actionLabel = 'generate capsule')
     const choice = gumChoose(
       [
         `1. ⚡ Continue in Evaluation Mode (Press Enter to ${actionLabel})`,
-        '2. 🔑 Enter License Key (Power Puff Team 💯 or Single Dev)',
-        '3. 💎 Buy License ($27 Solo / $47 Team Power Puff 100 Seats)',
+        '2. 🔑 Enter License Key (Team Power Puff or Single Dev)',
+        '3. 💎 Buy License ($27 Solo / $97 Team Power Puff Unlimited Lifetime)',
         '4. 🚪 Cancel'
       ],
       `Evaluation Mode: ${actionLabel}`
@@ -242,8 +242,8 @@ export const checkOrPromptEvaluation = async (actionLabel = 'generate capsule')
     '\n\x1b[38;5;208;1m⚡ Chemical X: Evaluation Mode (Unlicensed)\x1b[0m\n' +
     'Support vibe coding standards: chemicalx.xophz.com\n' +
     `  [1] Continue in Evaluation Mode (Press Enter to ${actionLabel})\n` +
-    '  [2] Enter License Key (Power Puff Team 💯 or Single Dev)\n' +
-    '  [3] Buy License ($27 Solo / $47 Team Power Puff 100 Seats)\n' +
+    '  [2] Enter License Key (Team Power Puff or Single Dev)\n' +
+    '  [3] Buy License ($27 Solo / $97 Team Power Puff Unlimited Lifetime)\n' +
     '  [4] Cancel\n\n'
   );
 

package/cli/navigator-actions.js

@@ -0,0 +1,274 @@
+import fs from "node:fs";
+import path from "node:path";
+import {
+  hasGum,
+  gumChoose,
+  gumInput,
+  promptQuestion
+} from "./terminal.js";
+import {
+  formatTerminalReport,
+  generateMarkdownReport,
+  groupViolationsBySeverity,
+  formatGradeFSection,
+  formatGradeDSection,
+  formatGradeCSection,
+  formatGradeBSection,
+  formatGradeASection,
+  getAuditHistory,
+  getAuditBaseline,
+  createSnapshotFromReport,
+  formatTransformationTerminal,
+  formatHistoryTimelineTerminal,
+  buildGradeFPrompt,
+  buildGradeDPrompt,
+  buildGradeCPrompt,
+  buildGradeBPrompt,
+  buildMasterPrompt,
+  copyToClipboard
+} from "./audit.js";
+import { resolveGradeBadge } from "./navigator-grades.js";
+import { showPagedContent } from "./navigator-paged.js";
+import { showConversionMenu } from "./navigator-conversion.js";
+import { handleShareToDiscussions } from "./navigator-share.js";
+import { runInstallWizard } from "./installer.js";
+import { formatButtonTag } from "./navigator-menu.js";
+
+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;
+
+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 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 gradeCCount = medium.length + warningMonoliths.length;
+  const gradeBCount = low.length;
+  const gradeACount = passedPillarsCount;
+
+  const handleGradeAAction = async () => {
+    await showPagedContent(formatGradeASection(report));
+  };
+  const handleGradeBAction = async () => {
+    await showPagedContent(formatGradeBSection(report), buildGradeBPrompt(report));
+  };
+  const handleGradeCAction = async () => {
+    await showPagedContent(formatGradeCSection(report), buildGradeCPrompt(report));
+  };
+  const handleGradeDAction = async () => {
+    await showPagedContent(formatGradeDSection(report), buildGradeDPrompt(report));
+  };
+  const handleGradeFAction = async () => {
+    await showPagedContent(formatGradeFSection(report), buildGradeFPrompt(report));
+  };
+
+  const gradeTiers = [
+    {
+      grade: "A",
+      count: gradeACount,
+      icon: "✅",
+      description: "Compliant Checks & Passing Pillars",
+      action: handleGradeAAction
+    },
+    {
+      grade: "B",
+      count: gradeBCount,
+      icon: "💣",
+      description: "Low Hygiene Issues & Minor Debts",
+      action: handleGradeBAction
+    },
+    {
+      grade: "C",
+      count: gradeCCount,
+      icon: "⚡",
+      description: "Medium Severity Debts & Monolith Drift",
+      action: handleGradeCAction
+    },
+    {
+      grade: "D",
+      count: gradeDCount,
+      icon: "🔥",
+      description: "High Severity Debts & Severe Monoliths",
+      action: handleGradeDAction
+    },
+    {
+      grade: "F",
+      count: gradeFCount,
+      icon: "💥",
+      description: "Critical Hazards & Extreme Monoliths",
+      action: handleGradeFAction
+    }
+  ];
+
+  const createActiveGradeItem = (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);
+};
+
+export const buildDashboardActionGroups = ({ report, onScaffold = null }) => {
+  const handleInstallAction = async () => {
+    await runInstallWizard(process.cwd());
+    if (hasGum()) {
+      gumChoose(["<-- Back to Audit Dashboard"]);
+    }
+  };
+
+  const handleUpgradeAction = async () => {
+    await showConversionMenu(onScaffold);
+  };
+
+  const handleReportAction = async () => {
+    await showPagedContent(formatTerminalReport(report), buildMasterPrompt(report));
+  };
+
+  const handleShareAction = async () => {
+    await handleShareToDiscussions(report);
+  };
+
+  const handleProgressAction = async () => {
+    const baseline = getAuditBaseline();
+    const history = getAuditHistory();
+    const currentSnapshot = createSnapshotFromReport(report);
+
+    let output = "";
+    if (baseline) {
+      output += formatTransformationTerminal(baseline, currentSnapshot);
+    } else {
+      output +=
+        "\n\x1b[33mNo baseline audit found. Current audit established as baseline.\x1b[0m\n";
+    }
+
+    if (history.length > 0) {
+      output += "\n\n" + formatHistoryTimelineTerminal(history);
+    }
+
+    await showPagedContent(output);
+  };
+
+  const handleExportAction = async () => {
+    const outName = hasGum()
+      ? gumInput("Export file path:", "AUDIT_REPORT.md") || "AUDIT_REPORT.md"
+      : (await promptQuestion("Export file path [AUDIT_REPORT.md]: ")) || "AUDIT_REPORT.md";
+    const md = generateMarkdownReport(report);
+    fs.writeFileSync(path.resolve(process.cwd(), outName), md, "utf-8");
+    process.stdout.write(`\x1b[32m✔ Exported markdown audit report to ${outName}\x1b[0m\n\n`);
+    if (hasGum()) {
+      gumChoose(["<-- Back to Audit Dashboard"]);
+    }
+  };
+
+  const handleCopyPromptAction = async () => {
+    const masterPrompt = buildMasterPrompt(report);
+    if (!masterPrompt) {
+      process.stdout.write("\n\x1b[32m✔ Codebase is pristine (Grade A+). No refactoring prompt needed!\x1b[0m\n\n");
+      if (hasGum()) {
+        gumChoose(["<-- Back to Audit Dashboard"]);
+      }
+      return;
+    }
+    const success = copyToClipboard(masterPrompt);
+    if (success) {
+      process.stdout.write(
+        "\n\x1b[1m\x1b[32m✔ AI Agent refactoring prompt copied to clipboard!\x1b[0m\n" +
+          "\x1b[36mPaste directly into Cursor, Claude, or Windsurf to resolve architectural hazards.\x1b[0m\n\n"
+      );
+    } else {
+      process.stdout.write("\n\x1b[33m⚠ Could not access system clipboard.\x1b[0m\n\n");
+    }
+    if (hasGum()) {
+      gumChoose(["<-- Back to Audit Dashboard"]);
+    }
+  };
+
+  const handleExitAction = async () => {};
+
+  const installAction = {
+    key: "install",
+    tag: formatButtonTag("Install", "\x1b[32m"),
+    label: "🪝 Install Pre-Commit Hook & GitHub CI Workflow",
+    action: handleInstallAction
+  };
+
+  const upgradeAction = {
+    key: "upgrade",
+    tag: formatButtonTag("Upgrade", "\x1b[33m"),
+    label: "💎 Unlock Full Molecular Rules & Scaffolding (Chemical X: Team Power Puff)",
+    action: handleUpgradeAction
+  };
+
+  const reportAction = {
+    key: "report",
+    tag: formatButtonTag("Full Report", "\x1b[36m"),
+    label: "📋 Show Full Report (All Sections at Once)",
+    action: handleReportAction
+  };
+
+  const shareAction = {
+    key: "share",
+    tag: formatButtonTag("Share", "\x1b[35m"),
+    label: "🕵  Plug your site and Post to GitHub Discussions (npx chemx audit)",
+    action: handleShareAction
+  };
+
+  const progressAction = {
+    key: "progress",
+    tag: formatButtonTag("Progress", "\x1b[32m"),
+    label: "📈 View Before & After Transformation Progress",
+    action: handleProgressAction
+  };
+
+  const exportAction = {
+    key: "export",
+    tag: formatButtonTag("Export", "\x1b[36m"),
+    label: "💾 Export Markdown Report to File",
+    action: handleExportAction
+  };
+
+  const copyPromptAction = {
+    key: "prompt",
+    tag: formatButtonTag("Prompt", "\x1b[38;2;98;201;255m"),
+    label: "📋 Copy AI Prompt Fix to Clipboard",
+    action: handleCopyPromptAction
+  };
+
+  const exitAction = {
+    key: "exit",
+    tag: formatButtonTag("Exit", "\x1b[90m"),
+    label: "🚪 Exit",
+    action: handleExitAction
+  };
+
+  const masterPrompt = buildMasterPrompt(report);
+  const isGradeAPlus = report?.health?.grade === "A+" || report?.metrics?.grade === "A+";
+  const hasPromptToCopy = Boolean(masterPrompt && masterPrompt.trim().length > 0);
+  const isCleanAPlus = isGradeAPlus && !hasPromptToCopy;
+  const shouldShowPromptAction = hasPromptToCopy && !isCleanAPlus;
+
+  return {
+    installAction,
+    upgradeAction,
+    reportAction,
+    shareAction,
+    progressAction,
+    exportAction,
+    copyPromptAction,
+    exitAction,
+    shouldShowPromptAction
+  };
+};