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

package/cli/navigator-banner.js

@@ -0,0 +1,98 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getChemicalXAsciiBanner } from "./audit.js";
+import { resolveGradeColor, resolveHealthHearts } from "./navigator-grades.js";
+
+const visualWidth = (s) => {
+  const stripped = s.replace(/\x1b\[[0-9;]*m/g, "");
+  let w = 0;
+  for (const seg of new Intl.Segmenter().segment(stripped)) {
+    const char = seg.segment;
+    const isDoubleWidth = char === "❤️" || char === "🖤" || char.codePointAt(0) > 0x1f000;
+    w += isDoubleWidth ? 2 : char.length;
+  }
+  return w;
+};
+
+const resolveProjectName = () => {
+  try {
+    const pkgPath = path.resolve(process.cwd(), "package.json");
+    if (fs.existsSync(pkgPath)) return JSON.parse(fs.readFileSync(pkgPath, "utf-8")).name || path.basename(process.cwd());
+  } catch {}
+  return path.basename(process.cwd()) || "Project";
+};
+
+const truncatePath = (p, maxLen) => (p.length <= maxLen ? p : `…${p.slice(p.length - maxLen + 1)}`);
+
+export const renderDashboardBanner = (
+  health,
+  metrics,
+  violations,
+  critical,
+  highMediumCount,
+  low,
+  contextAnalysis = null
+) => {
+  if (process.stdout.isTTY) console.clear();
+  process.stdout.write(getChemicalXAsciiBanner(health.grade));
+
+  const gColor = resolveGradeColor(health.grade);
+  const critColor = critical.length > 0 ? "\x1b[31;1m" : "\x1b[32m";
+  const highMedColor = highMediumCount > 0 ? "\x1b[38;5;208;1m" : "\x1b[32m";
+  const lowColor = low.length > 0 ? "\x1b[33;1m" : "\x1b[32m";
+
+  const hearts = resolveHealthHearts(health.grade, health.score);
+  const scoreBadge = `${health.score}/100 [Grade: ${health.grade}]`;
+  const labelStr = health.label ? ` (${health.label})` : "";
+  const healthStr = `${hearts}  ${gColor}${scoreBadge}\x1b[0m${gColor}${labelStr}\x1b[0m`;
+
+  const filesStr = `${metrics.scannedFiles} Files`;
+  const locStr = `${(metrics.totalLoc || 0).toLocaleString()}`;
+  const hazardsStr = `💥 ${critColor}${critical.length} Critical\x1b[0m | 🔥 ${highMedColor}${highMediumCount} High/Med\x1b[0m | 💣 ${lowColor}${low.length} Low\x1b[0m`;
+
+  const tokens = contextAnalysis?.estimatedTokens || 0;
+  const pct = contextAnalysis?.potentialSavingsPct || 0;
+  const costPass = contextAnalysis?.excessCostPerPass !== undefined
+    ? contextAnalysis.excessCostPerPass
+    : Number((((contextAnalysis?.estimatedExcessTokens || 0) / 1000000) * 3.0).toFixed(3));
+  const costMonth = contextAnalysis?.monthlyWastePerDev !== undefined
+    ? contextAnalysis.monthlyWastePerDev
+    : Number((costPass * 20 * 5 * 4).toFixed(2));
+
+  const tokensStr = `~${tokens.toLocaleString()} tokens` + (pct > 0 ? ` (${pct}% cut)` : "");
+  const costStr = costPass > 0
+    ? `\x1b[38;5;208;1m$${costPass.toFixed(3)}\x1b[0m\x1b[2m/turn\x1b[0m | \x1b[31;1m$${costMonth.toFixed(2)}\x1b[0m\x1b[2m/mo\x1b[0m`
+    : `\x1b[32;1m$0.000\x1b[0m\x1b[2m/turn\x1b[0m | \x1b[32;1m$0.00\x1b[0m\x1b[2m/mo\x1b[0m`;
+
+  const col1 = [
+    "\x1b[36;1m-FILES-\x1b[0m", `\x1b[36m${filesStr}\x1b[0m`,
+    "\x1b[36;1m-LINES OF CODE-\x1b[0m", `\x1b[36m${locStr}\x1b[0m`,
+    "\x1b[36;1m-TOKEN EST-\x1b[0m", `\x1b[36m${tokensStr}\x1b[0m`
+  ];
+  const col2 = [
+    "\x1b[31;1m-HEALTH-\x1b[0m", healthStr,
+    "\x1b[33;1m-HAZARDS-\x1b[0m", hazardsStr,
+    "\x1b[32;1m-CURRENCY-\x1b[0m", costStr
+  ];
+
+  const col1Pad = 32;
+  const rows = [];
+  let maxW = 0;
+  for (let i = 0; i < col1.length; i++) {
+    const pad = " ".repeat(Math.max(2, col1Pad - visualWidth(col1[i])));
+    const content = col1[i] + pad + col2[i];
+    const w = visualWidth(content);
+    if (w > maxW) maxW = w;
+    rows.push({ content, width: w });
+  }
+
+  const projectName = resolveProjectName();
+  const innerWidth = Math.max(maxW, visualWidth(projectName) + 4);
+  const bColor = "\x1b[1;38;5;81m";
+  const topBorder = `${bColor}╭── \x1b[1;37m${projectName}${bColor} ${"─".repeat(Math.max(2, innerWidth - visualWidth(projectName)))}╮\x1b[0m`;
+  const displayPwd = truncatePath(process.cwd(), Math.max(10, innerWidth - 4));
+  const botBorder = `${bColor}╰── \x1b[36m${displayPwd}${bColor} ${"─".repeat(Math.max(2, innerWidth - visualWidth(displayPwd)))}╯\x1b[0m`;
+  const bodyLines = rows.map((r) => `${bColor}│\x1b[0m  ${r.content}${" ".repeat(innerWidth - r.width)}  ${bColor}│\x1b[0m`);
+
+  process.stdout.write(`\n${[topBorder, ...bodyLines, botBorder].join("\n")}\n\n`);
+};

package/cli/navigator-conversion.js

@@ -23,7 +23,7 @@ export const showConversionMenu = async (onScaffold = null) => {
       const choice = gumChoose([
         '1. Sponsor on GitHub: $9/mo Solo / $49/mo Team Unlimited -> Launch Sponsors',
         '2. Buy Standard Vault: Single Dev License ($27) -> Launch Checkout',
-        '3. Buy Team Power Puff: 100 Devs / Team Honor System 💯 ($47) -> Launch Checkout',
+        '3. Buy Team Power Puff: Unlimited Lifetime ($97) -> Launch Checkout',
         '4. Enter License Key to Scaffold (Sponsors & License Holders)',
         '5. Visit chemicalx.xophz.com to learn more',
         '6. Back to Navigator'
@@ -40,7 +40,7 @@ export const showConversionMenu = async (onScaffold = null) => {
         continue;
       }
       if (choice.startsWith('3.')) {
-        process.stdout.write(`\n\x1b[36mOpening Team Power Puff checkout (100 Devs / Team Honor System 💯):\x1b[0m ${URL_MASTER}\n\n`);
+        process.stdout.write(`\n\x1b[36mOpening Team Power Puff checkout (Unlimited Lifetime):\x1b[0m ${URL_MASTER}\n\n`);
         openBrowser(URL_MASTER);
         continue;
       }
@@ -64,7 +64,7 @@ export const showConversionMenu = async (onScaffold = null) => {
     );
     process.stdout.write(`  [1] Sponsor on GitHub ($9/mo Solo / $49/mo Team Unlimited) - ${URL_SPONSOR}\n      Includes: Instant GitHub org access to private starter-kit, continuous model prompt updates\n`);
     process.stdout.write(`  [2] Buy Standard Vault: Single Dev License ($27) - ${URL_STANDARD}\n      Includes: Kindle/Print PDF eBook, 7 Molecular Architecture Chapters, Universal AGENTS.md\n`);
-    process.stdout.write(`  [3] Buy Team Power Puff: 100 Devs / Team Honor System 💯 ($47) - ${URL_MASTER}\n      Includes: 100 Team Seats (Honor System), Private Starter-Kit Repo, Pre-Commit Line Budget Hooks, VIP Discord\n`);
+    process.stdout.write(`  [3] Buy Team Power Puff: Unlimited Lifetime ($97) - ${URL_MASTER}\n      Includes: Unlimited Team Seats, Private Starter-Kit Repo, Pre-Commit Line Budget Hooks, VIP Discord\n`);
     process.stdout.write('  [4] Enter License Key to Scaffold (Sponsors & License Holders)\n');
     process.stdout.write(`  [5] Visit chemicalx.xophz.com to learn more - ${URL_LEARN}\n`);
     process.stdout.write('  [6] Back to Navigator\n\n');

package/cli/navigator-grades.js

@@ -6,10 +6,27 @@ export const resolveGradeColor = (grade) => {
   return '\x1b[31;1m';
 };
 
-export const resolveGradeBadge = (grade) => {
+export const resolveGradeBadge = (grade, width = 11) => {
   const color = resolveGradeColor(grade);
-  const padded = grade.length === 1 ? `${grade} ` : grade;
-  return `${color}[Grade: ${padded}]\x1b[0m`;
+  const text = `Grade: ${grade}`;
+  const totalPadding = Math.max(0, width - text.length);
+  const leftPad = Math.floor(totalPadding / 2);
+  const rightPad = totalPadding - leftPad;
+  const padded = `${' '.repeat(leftPad)}${text}${' '.repeat(rightPad)}`;
+  return `${color}[${padded}]\x1b[0m`;
+};
+
+export const resolveHealthHearts = (grade, score = 0) => {
+  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;
+  return '❤️'.repeat(filled) + '🖤'.repeat(empty);
 };
 
 export const resolveCriticalGrade = (count) => {

package/cli/navigator-menu.js

@@ -0,0 +1,127 @@
+export const formatButtonTag = (label, color = "", width = 11) => {
+  const totalPadding = Math.max(0, width - label.length);
+  const leftPad = Math.floor(totalPadding / 2);
+  const rightPad = totalPadding - leftPad;
+  const inner = `${" ".repeat(leftPad)}${label}${" ".repeat(rightPad)}`;
+  return color ? `${color}[${inner}]\x1b[0m` : `[${inner}]`;
+};
+
+const isNonEmptyGroup = (group) => group.length > 0;
+
+export const buildNavigatorMenu = (topActions, activeGrades, midActions, bottomActions) => {
+  const groups = [topActions, activeGrades, midActions, bottomActions].filter(isNonEmptyGroup);
+  const menuItems = groups.flat();
+  const menuOptions = [];
+  let currentIndex = 1;
+  const divider = "──────────────────────────────────────────────────────────────────────";
+
+  groups.forEach((group, idx) => {
+    for (const item of group) {
+      item.index = currentIndex;
+      const pad = String(currentIndex).padStart(2, " ");
+      menuOptions.push(` ${pad}. ${item.tag} ${item.label}`);
+      currentIndex++;
+    }
+    if (idx < groups.length - 1) {
+      menuOptions.push(divider);
+    }
+  });
+
+  return { menuItems, menuOptions };
+};
+
+const isChoiceMatchingItem = (cleanChoice) => (item) => {
+  const prefix = `${item.index}.`;
+  if (cleanChoice.startsWith(prefix) || cleanChoice === String(item.index)) return true;
+  if (
+    item.key === "exit" &&
+    (cleanChoice.includes("Exit") || cleanChoice.toLowerCase() === "exit")
+  ) {
+    return true;
+  }
+  if (
+    item.key === "prompt" &&
+    (cleanChoice.includes("Prompt") || cleanChoice.includes("Clipboard"))
+  ) {
+    return true;
+  }
+  if (
+    item.key === "report" &&
+    (cleanChoice.includes("Report") || cleanChoice.includes("Full Report"))
+  ) {
+    return true;
+  }
+  if (item.key === "progress" && cleanChoice.includes("Progress")) return true;
+  if (
+    item.key === "share" &&
+    (cleanChoice.includes("Share") ||
+      cleanChoice.includes("Discussions") ||
+      cleanChoice.includes("Plug your"))
+  ) {
+    return true;
+  }
+  if (item.key === "export" && cleanChoice.includes("Export")) return true;
+  if (
+    item.key === "install" &&
+    (cleanChoice.includes("Install") ||
+      cleanChoice.includes("Pre-Commit") ||
+      cleanChoice.includes("Workflow"))
+  ) {
+    return true;
+  }
+  if (
+    item.key === "upgrade" &&
+    (cleanChoice.includes("Upgrade") ||
+      cleanChoice.includes("Power Puff") ||
+      cleanChoice.includes("Team Power Puff") ||
+      cleanChoice.includes("Molecular Rules"))
+  ) {
+    return true;
+  }
+  if (
+    item.grade &&
+    (cleanChoice.toLowerCase().includes(`grade ${item.grade}`) ||
+      cleanChoice.toLowerCase().includes(`grade: ${item.grade}`))
+  ) {
+    return true;
+  }
+  return false;
+};
+
+export const matchGumChoice = (cleanChoice, menuItems) => {
+  const matcher = isChoiceMatchingItem(cleanChoice);
+  return menuItems.find(matcher);
+};
+
+const isEffectiveMatchingItem = (effective, exitIndex) => (item) => {
+  if (effective === String(item.index)) return true;
+  if (item.key === "exit" && (effective === "exit" || effective === String(exitIndex))) {
+    return true;
+  }
+  if (
+    item.key === "prompt" &&
+    (effective === "prompt" ||
+      effective === "copy" ||
+      effective === "c" ||
+      effective === "clipboard")
+  ) {
+    return true;
+  }
+  if (
+    item.key === "report" &&
+    (effective === "report" || effective === "full report" || effective === "full")
+  ) {
+    return true;
+  }
+  if (item.key === "share" && (effective === "share" || effective === "post")) return true;
+  if (item.key === effective) return true;
+  if (item.grade && (effective === item.grade || effective === `grade ${item.grade}`)) {
+    return true;
+  }
+  return false;
+};
+
+export const matchFallbackChoice = (effective, menuItems, exitIndex) => {
+  const matcher = isEffectiveMatchingItem(effective, exitIndex);
+  return menuItems.find(matcher);
+};

package/cli/navigator.d.ts

@@ -1,7 +1,8 @@
 import type { AuditReport } from './audit/types';
 
 export declare function resolveGradeColor(grade: string): string;
-export declare function resolveGradeBadge(grade: string): string;
+export declare function resolveGradeBadge(grade: string, width?: number): string;
+export declare function resolveHealthHearts(grade: string, score?: number, isAnsi?: boolean): string;
 export declare function resolveCriticalGrade(count: number): string;
 export declare function resolveHighMedGrade(count: number): string;
 export declare function resolveLowGrade(count: number): string;
@@ -9,6 +10,23 @@ export declare function resolvePillarGrade(pillars: Record<string, unknown>): st
 export declare function resolveHotspotGrade(hotspots: readonly { readonly lineCount: number }[]): string;
 export declare function resolveContextGrade(riskTier: string): string;
 
+export interface NavigatorMenuItem {
+  key?: string;
+  grade?: string;
+  tag: string;
+  label: string;
+  index?: number;
+  action: () => Promise<void>;
+}
+
+export declare function formatButtonTag(label: string, color?: string, width?: number): string;
+export declare function buildNavigatorMenu(
+  topActions: readonly NavigatorMenuItem[],
+  activeGrades: readonly NavigatorMenuItem[],
+  midActions: readonly NavigatorMenuItem[],
+  bottomActions: readonly NavigatorMenuItem[]
+): { menuItems: NavigatorMenuItem[]; menuOptions: string[] };
+
 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>;
@@ -19,6 +37,7 @@ export declare function renderDashboardBanner(
   violations: AuditReport['violations'],
   critical: readonly unknown[],
   highMediumCount: number,
-  low: readonly unknown[]
+  low: readonly unknown[],
+  contextAnalysis?: AuditReport['contextAnalysis'] | null
 ): void;
 export declare function runInteractiveAuditNavigator(report: AuditReport, onScaffold?: (() => Promise<void>) | null): Promise<void>;