@chemx/starter-kit 26.9.9-786 → 26.9.11-362

package/cli/installer-templates.js

@@ -0,0 +1,80 @@
+export const buildPreCommitHookScript = (minGrade = 'B', minScore = 80) => `#!/bin/sh
+# Chemical X Protocol: Pre-Commit Line Budget & Architecture Gatekeeper
+# Free architectural guardrail preventing context bloat and monolith sprawl.
+
+MIN_GRADE="\${CHEMX_MIN_GRADE:-${minGrade}}"
+MIN_SCORE="\${CHEMX_MIN_SCORE:-${minScore}}"
+MAX_LINES="\${CHEMX_MAX_LINES:-500}"
+MAX_MOLECULE_LINES="\${CHEMX_MAX_MOLECULE_LINES:-100}"
+
+REPO_ROOT="\$(git rev-parse --show-toplevel 2>/dev/null)"
+[ -z "\$REPO_ROOT" ] && exit 0
+cd "\$REPO_ROOT" || exit 1
+
+STAGED_FILES=\$(git diff --cached --name-only --diff-filter=ACM | grep -E '\\.(jsx?|tsx?|vue|svelte)\$' | grep -vE '(\\.(d\\.ts|min\\.|test\\.|spec\\.))')
+[ -z "\$STAGED_FILES" ] && exit 0
+
+FAILED=0
+ERRORS=""
+for F in \$STAGED_FILES; do
+  [ ! -f "\$F" ] && continue
+  L=\$(wc -l < "\$F" | tr -d ' ')
+  case "\$F" in
+    *molecules*|*/m-*|*m-*)
+      [ "\$L" -gt "\$MAX_MOLECULE_LINES" ] && FAILED=1 && ERRORS="\${ERRORS}\\n  \\033[31m✕\\033[0m \$F (\$L LOC > \$MAX_MOLECULE_LINES molecule limit)" ;;
+    *)
+      [ "\$L" -gt "\$MAX_LINES" ] && FAILED=1 && ERRORS="\${ERRORS}\\n  \\033[31m✕\\033[0m \$F (\$L LOC > \$MAX_LINES file budget)" ;;
+  esac
+done
+
+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
+  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
+    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
+  fi
+fi
+
+[ "\$FAILED" -eq 1 ] && exit 1
+printf "\\033[32m✔ [Chemical X] Pre-commit architectural guardrails passed.\\033[0m\\n"
+exit 0
+`;
+
+export const buildGitHubWorkflowScript = (minGrade = 'B', minScore = 80) => `name: Chemical X Architectural Gatekeeper
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  molecular-audit:
+    name: Chemical X Architecture & Line Budget Audit
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - name: Run Chemical X Architectural Audit
+        run: npx chemx audit --min-grade=\${{ vars.CHEMX_MIN_GRADE || '${minGrade}' }} --min-score=\${{ vars.CHEMX_MIN_SCORE || ${minScore} }} --markdown --output=AUDIT_REPORT.md
+      - name: Upload Audit Scorecard Artifact
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: chemical-x-audit-report
+          path: AUDIT_REPORT.md
+`;

package/cli/installer.d.ts

@@ -0,0 +1,20 @@
+export interface InstallOptions {
+  minGrade?: string;
+  minScore?: number;
+  maxLines?: number;
+  maxMoleculeLines?: number;
+}
+
+export interface ProjectConfig {
+  minGrade: string;
+  minScore: number;
+  maxLineCount: number;
+  maxMoleculeLineCount: number;
+}
+
+export declare function buildPreCommitHookScript(minGrade?: string, minScore?: number): string;
+export declare function buildGitHubWorkflowScript(minGrade?: string, minScore?: number): string;
+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 runInstallWizard(targetDir?: string): Promise<void>;

package/cli/installer.js

@@ -0,0 +1,56 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { hasGum, gumChoose, gumInput, promptQuestion } from './terminal.js';
+import { buildPreCommitHookScript, buildGitHubWorkflowScript } from './installer-templates.js';
+
+export { buildPreCommitHookScript, buildGitHubWorkflowScript } from './installer-templates.js';
+
+export const installPreCommitHook = (targetDir = '.', options = {}) => {
+  const gitHooksDir = path.resolve(targetDir, '.git', 'hooks');
+  if (!fs.existsSync(gitHooksDir)) fs.mkdirSync(gitHooksDir, { recursive: true });
+  const hookPath = path.join(gitHooksDir, 'pre-commit');
+  fs.writeFileSync(hookPath, buildPreCommitHookScript(options.minGrade, options.minScore), { mode: 0o755 });
+  process.stdout.write(`  \x1b[32m✔\x1b[0m Installed git pre-commit hook: .git/hooks/pre-commit (chmod +x)\n`);
+  return true;
+};
+
+export const installGitHubWorkflow = (targetDir = '.', options = {}) => {
+  const wfDir = path.resolve(targetDir, '.github', 'workflows');
+  if (!fs.existsSync(wfDir)) fs.mkdirSync(wfDir, { recursive: true });
+  const wfPath = path.join(wfDir, 'chemx-audit.yml');
+  fs.writeFileSync(wfPath, buildGitHubWorkflowScript(options.minGrade, options.minScore), 'utf-8');
+  process.stdout.write(`  \x1b[32m✔\x1b[0m Installed GitHub Actions CI workflow: .github/workflows/chemx-audit.yml\n`);
+  return true;
+};
+
+export const saveProjectConfig = (targetDir = '.', config = {}) => {
+  const chemxDir = path.resolve(targetDir, '.chemx');
+  if (!fs.existsSync(chemxDir)) fs.mkdirSync(chemxDir, { recursive: true });
+  fs.writeFileSync(path.join(chemxDir, 'config.json'), JSON.stringify(config, null, 2), 'utf-8');
+  process.stdout.write(`  \x1b[32m✔\x1b[0m Saved project settings to: .chemx/config.json\n`);
+};
+
+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');
+  const targetChoice = hasGum()
+    ? gumChoose(['1. Install All Guardrails (Git Pre-Commit Hook + GitHub CI Workflow)', '2. Git Pre-Commit Hook only (.git/hooks/pre-commit)', '3. GitHub Actions CI Workflow only (.github/workflows/chemx-audit.yml)', '4. Cancel'])
+    : await promptQuestion('Select target: [1] All, [2] Hook, [3] CI, [4] Cancel (default: 1): ');
+  if (targetChoice?.includes('Cancel') || targetChoice === '4') return;
+
+  const minGrade = (hasGum() ? gumInput('Minimum required Grade [A+, A, B, C, D] (default: B):', 'B') : await promptQuestion('Minimum required Grade [default: B]: ')) || 'B';
+  const minScore = parseInt((hasGum() ? gumInput('Minimum required Score [0-100] (default: 80):', '80') : await promptQuestion('Minimum required Score [default: 80]: ')) || '80', 10);
+  const opts = { minGrade: minGrade.trim().toUpperCase(), minScore };
+
+  process.stdout.write('\n\x1b[1mInstalling guardrails...\x1b[0m\n');
+  const shouldHook = !targetChoice.includes('CI only') && targetChoice !== '3';
+  const shouldWf = !targetChoice.includes('Hook only') && targetChoice !== '2';
+
+  if (shouldHook) {
+    if (isGit) installPreCommitHook(targetDir, opts);
+    else process.stdout.write('  \x1b[33m⚠\x1b[0m Skipped .git/hooks (current directory is not a git repository root).\n');
+  }
+  if (shouldWf) installGitHubWorkflow(targetDir, opts);
+  saveProjectConfig(targetDir, { minGrade: opts.minGrade, minScore: opts.minScore, maxLineCount: 500, maxMoleculeLineCount: 100 });
+  process.stdout.write('\n\x1b[1m\x1b[32m✔ Chemical X guardrails installed successfully!\x1b[0m\n\n');
+};

package/cli/license.js

@@ -0,0 +1,320 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import {
+  hasGum,
+  gumChoose,
+  gumInput,
+  promptQuestion,
+  openBrowser
+} from './terminal.js';
+
+export const CONFIG_DIR = path.join(os.homedir(), '.chemical-x');
+export const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+export const DEVICE_FILE = path.join(CONFIG_DIR, 'device_id');
+
+export const API_BASE = process.env.CHEMICAL_X_API_URL || 'https://chemicalx.xophz.com';
+export const URL_LEARN = 'https://chemicalx.xophz.com';
+export const URL_SPONSOR = 'https://github.com/sponsors/Chemical-X-Protocol';
+export const URL_STANDARD = 'https://mycompassconsulting.com/buy/chemical-x/standard';
+export const URL_MASTER = 'https://mycompassconsulting.com/buy/chemical-x/master';
+
+if (!fs.existsSync(CONFIG_DIR)) {
+  try {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  } catch {}
+}
+
+export const getOrCreateDeviceId = () => {
+  if (fs.existsSync(DEVICE_FILE)) {
+    try {
+      const id = fs.readFileSync(DEVICE_FILE, 'utf-8').trim();
+      if (id) return id;
+    } catch {}
+  }
+  const newId = `cli_${Math.random().toString(36).substring(2, 12)}_${Date.now()}`;
+  try {
+    fs.writeFileSync(DEVICE_FILE, newId, 'utf-8');
+  } catch {}
+  return newId;
+};
+
+export const getCachedLicenseKey = () => {
+  if (!fs.existsSync(CONFIG_FILE)) {
+    return null;
+  }
+  try {
+    const data = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    return data.licenseKey || null;
+  } catch {
+    return null;
+  }
+};
+
+export const saveLicenseKey = (licenseKey) => {
+  try {
+    fs.writeFileSync(
+      CONFIG_FILE,
+      JSON.stringify({ licenseKey, updatedAt: new Date().toISOString() }, null, 2),
+      'utf-8'
+    );
+  } catch {}
+};
+
+const resolveFlagLicense = (args) => {
+  const cliFlagIdx = args.indexOf('--license');
+  const hasFlag = cliFlagIdx !== -1 && Boolean(args[cliFlagIdx + 1]);
+  if (!hasFlag) return null;
+  return args[cliFlagIdx + 1].trim();
+};
+
+export const obtainLicenseKey = async (rawArgs = [], onRunAudit = null) => {
+  const flagKey = resolveFlagLicense(rawArgs);
+  const effectiveKey = flagKey || getCachedLicenseKey();
+
+  if (effectiveKey) {
+    return effectiveKey;
+  }
+
+  const useGum = hasGum();
+
+  if (useGum) {
+    const choice = gumChoose(
+      [
+        '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',
+        '4. Enter License Key (CX-XXXX-XXXX-XXXX)',
+        '5. Run Free Public Audit (npx chemx audit)',
+        '6. Exit'
+      ],
+      'Chemical X Scaffolding Requires a Paid License:'
+    );
+
+    if (choice.startsWith('1.')) {
+      process.stdout.write(`\x1b[36mOpening Chemical X Portal in default browser:\x1b[0m ${URL_LEARN}\n`);
+      openBrowser(URL_LEARN);
+      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');
+    }
+
+    if (choice.startsWith('2.')) {
+      process.stdout.write(`\x1b[36mOpening Standard Vault checkout (Single Dev License) in default browser:\x1b[0m ${URL_STANDARD}\n`);
+      openBrowser(URL_STANDARD);
+      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');
+    }
+
+    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`);
+      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');
+    }
+
+    if (choice.startsWith('4.')) {
+      return gumInput('License Key (CX-XXXX-XXXX-XXXX):', 'CX-XXXX-XXXX-XXXX');
+    }
+
+    if (choice.startsWith('5.') && onRunAudit) {
+      await onRunAudit(null, true);
+    }
+
+    const isExitChoice = choice.startsWith('6.') || !choice;
+    if (isExitChoice) {
+      process.exit(0);
+    }
+
+    return gumInput('License Key (CX-XXXX-XXXX-XXXX):', 'CX-XXXX-XXXX-XXXX');
+  }
+
+  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('  [4] Enter License Key\n');
+  process.stdout.write('  [5] Run Free Public Audit (npx chemx audit)\n');
+  process.stdout.write('  [6] Exit\n\n');
+
+  const selection = await promptQuestion('Select option [1-6] (default: 1): ');
+  const effectiveChoice = selection.trim() || '1';
+
+  if (effectiveChoice === '1') {
+    process.stdout.write(`Opening: ${URL_LEARN}\n`);
+    openBrowser(URL_LEARN);
+    return promptQuestion('Enter License Key after review (or press Enter to exit): ');
+  }
+
+  if (effectiveChoice === '2') {
+    process.stdout.write(`Opening: ${URL_STANDARD}\n`);
+    openBrowser(URL_STANDARD);
+    return promptQuestion('Enter License Key after purchase: ');
+  }
+
+  if (effectiveChoice === '3') {
+    process.stdout.write(`Opening: ${URL_MASTER}\n`);
+    openBrowser(URL_MASTER);
+    return promptQuestion('Enter License Key after purchase: ');
+  }
+
+  if (effectiveChoice === '4') {
+    return promptQuestion('Enter License Key (CX-XXXX-XXXX-XXXX): ');
+  }
+
+  if (effectiveChoice === '5' && onRunAudit) {
+    await onRunAudit(null, true);
+  }
+
+  if (effectiveChoice === '6') {
+    process.exit(0);
+  }
+
+  return promptQuestion('Enter Chemical X Sponsor License Key (CX-XXXX-XXXX-XXXX): ');
+};
+
+export const checkOrPromptEvaluation = async (actionLabel = 'generate capsule') => {
+  const cachedKey = getCachedLicenseKey();
+  if (cachedKey) {
+    return { licensed: true, key: cachedKey };
+  }
+
+  const useGum = hasGum();
+  if (useGum) {
+    spawnSync(
+      'gum',
+      [
+        'style',
+        '--border=rounded',
+        '--border-foreground=81',
+        '--padding=0 1',
+        '--bold',
+        '⚡ Chemical X: Evaluation Mode (Unlicensed)\n' +
+        'Support vibe coding standards: chemicalx.xophz.com\n' +
+        'Single Dev ($27) | Team Power Puff 💯 (100 Seats: $47)'
+      ],
+      { stdio: 'inherit' }
+    );
+
+    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)',
+        '4. 🚪 Cancel'
+      ],
+      `Evaluation Mode: ${actionLabel}`
+    );
+
+    if (choice.startsWith('1.') || !choice) {
+      return { licensed: false, proceed: true };
+    }
+
+    if (choice.startsWith('2.')) {
+      const enteredKey = gumInput('License Key (CX-XXXX-XXXX-XXXX):', 'CX-XXXX-XXXX-XXXX');
+      if (enteredKey && enteredKey !== 'CX-XXXX-XXXX-XXXX') {
+        saveLicenseKey(enteredKey.trim().toUpperCase());
+        process.stdout.write('\x1b[32m✔ License saved to ~/.chemical-x/config.json!\x1b[0m\n\n');
+        return { licensed: true, key: enteredKey.trim().toUpperCase() };
+      }
+      return { licensed: false, proceed: true };
+    }
+
+    if (choice.startsWith('3.')) {
+      openBrowser(URL_MASTER);
+      process.stdout.write(`\x1b[36mOpened checkout in default browser:\x1b[0m ${URL_MASTER}\n`);
+      const keyAfterBuy = gumInput('Enter License Key once purchased (or press Enter to skip):');
+      if (keyAfterBuy) {
+        saveLicenseKey(keyAfterBuy.trim().toUpperCase());
+        process.stdout.write('\x1b[32m✔ License saved to ~/.chemical-x/config.json!\x1b[0m\n\n');
+        return { licensed: true, key: keyAfterBuy.trim().toUpperCase() };
+      }
+      return { licensed: false, proceed: true };
+    }
+
+    if (choice.startsWith('4.')) {
+      process.exit(0);
+    }
+
+    return { licensed: false, proceed: true };
+  }
+
+  process.stdout.write(
+    '\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' +
+    '  [4] Cancel\n\n'
+  );
+
+  const sel = await promptQuestion('Select option [1-4] (default: 1): ');
+  const choice = sel.trim() || '1';
+
+  if (choice === '1') {
+    return { licensed: false, proceed: true };
+  }
+
+  if (choice === '2') {
+    const entered = await promptQuestion('Enter License Key (CX-XXXX-XXXX-XXXX): ');
+    if (entered) {
+      saveLicenseKey(entered.trim().toUpperCase());
+      process.stdout.write('\x1b[32m✔ License saved to ~/.chemical-x/config.json!\x1b[0m\n\n');
+      return { licensed: true, key: entered.trim().toUpperCase() };
+    }
+    return { licensed: false, proceed: true };
+  }
+
+  if (choice === '3') {
+    openBrowser(URL_MASTER);
+    const entered = await promptQuestion('Enter License Key after purchase (or Enter to skip): ');
+    if (entered) {
+      saveLicenseKey(entered.trim().toUpperCase());
+      process.stdout.write('\x1b[32m✔ License saved to ~/.chemical-x/config.json!\x1b[0m\n\n');
+      return { licensed: true, key: entered.trim().toUpperCase() };
+    }
+    return { licensed: false, proceed: true };
+  }
+
+  if (choice === '4') {
+    process.exit(0);
+  }
+
+  return { licensed: false, proceed: true };
+};
+
+export const fetchStarterKitFiles = async (licenseKey) => {
+  const normalizedKey = licenseKey.trim().toUpperCase();
+  const deviceId = getOrCreateDeviceId();
+
+  process.stdout.write(`\nVerifying license via edge: ${API_BASE}...\n`);
+
+  try {
+    const res = await fetch(`${API_BASE}/api/starter-kit/download`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ licenseKey: normalizedKey, deviceId })
+    });
+
+    const responseData = await res.json();
+    const isSuccess = Boolean(res.ok && responseData.valid);
+
+    if (!isSuccess) {
+      process.stderr.write(
+        `\x1b[31m✕ License Verification Failed: ${responseData.error || 'Invalid key.'}\x1b[0m\n`
+      );
+      process.stderr.write(`Purchase key at: ${URL_STANDARD}\n\n`);
+      process.exit(1);
+    }
+
+    saveLicenseKey(normalizedKey);
+    process.stdout.write(
+      `\x1b[32m✔ Verified License for @${responseData.githubUser || 'sponsor'}\x1b[0m\n\n`
+    );
+    return responseData.files || {};
+  } catch (err) {
+    process.stderr.write(
+      `\x1b[31m✕ Network Error: Failed to reach edge server (${err.message}).\x1b[0m\n`
+    );
+    process.exit(1);
+  }
+};

package/cli/navigator-conversion.js

@@ -0,0 +1,100 @@
+import { spawnSync } from 'node:child_process';
+import {
+  hasGum,
+  gumChoose,
+  promptQuestion,
+  openBrowser
+} from './terminal.js';
+import {
+  URL_LEARN,
+  URL_SPONSOR,
+  URL_STANDARD,
+  URL_MASTER
+} from './license.js';
+
+export const showConversionMenu = async (onScaffold = null) => {
+  while (true) {
+    if (hasGum()) {
+      spawnSync('gum', [
+        'style', '--border=rounded', '--border-foreground=81', '--padding=0 1', '--bold',
+        'Chemical X: The Secret Sauce to Vibe Coding\nStop letting AI agents scour 2,000-line monoliths and hallucinate.\n25+ Years XP | Codified by Principal Systems Architect Xopher Pollard\nTarget File Budget: Max 500 lines/file (<100 lines/molecule) | 85% Token Burn Cut'
+      ], { stdio: 'inherit' });
+
+      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',
+        '4. Enter License Key to Scaffold (Sponsors & License Holders)',
+        '5. Visit chemicalx.xophz.com to learn more',
+        '6. Back to Navigator'
+      ], 'Unlock Chemical X: Team Power Puff & Scaffolding:');
+
+      if (choice.startsWith('1.')) {
+        process.stdout.write(`\n\x1b[36mOpening GitHub Sponsors in browser:\x1b[0m ${URL_SPONSOR}\n\n`);
+        openBrowser(URL_SPONSOR);
+        continue;
+      }
+      if (choice.startsWith('2.')) {
+        process.stdout.write(`\n\x1b[36mOpening Standard Vault checkout (Single Dev License):\x1b[0m ${URL_STANDARD}\n\n`);
+        openBrowser(URL_STANDARD);
+        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`);
+        openBrowser(URL_MASTER);
+        continue;
+      }
+      if (choice.startsWith('4.')) {
+        if (onScaffold) await onScaffold();
+        break;
+      }
+      if (choice.startsWith('5.')) {
+        process.stdout.write(`\n\x1b[36mOpening Chemical X Portal in browser:\x1b[0m ${URL_LEARN}\n\n`);
+        openBrowser(URL_LEARN);
+        continue;
+      }
+      break;
+    }
+
+    process.stdout.write(
+      '\n\x1b[1m\x1b[38;2;98;201;255mChemical X: The Secret Sauce to Vibe Coding\x1b[0m\n' +
+      'Stop letting AI agents scour 2,000-line monoliths and hallucinate breaking changes.\n' +
+      '25+ Years XP | Codified by Principal Systems Architect Xopher Pollard\n' +
+      'Target File Budget: Max 500 lines/file (<100 lines per molecule capsule).\n\n'
+    );
+    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('  [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');
+
+    const selection = await promptQuestion('Select option [1-6] (default: 6): ');
+    const effectiveSelection = selection.trim() || '6';
+    if (effectiveSelection === '1') {
+      process.stdout.write(`\nOpening: ${URL_SPONSOR}\n\n`);
+      openBrowser(URL_SPONSOR);
+      continue;
+    }
+    if (effectiveSelection === '2') {
+      process.stdout.write(`\nOpening: ${URL_STANDARD}\n\n`);
+      openBrowser(URL_STANDARD);
+      continue;
+    }
+    if (effectiveSelection === '3') {
+      process.stdout.write(`\nOpening: ${URL_MASTER}\n\n`);
+      openBrowser(URL_MASTER);
+      continue;
+    }
+    if (effectiveSelection === '4') {
+      if (onScaffold) await onScaffold();
+      break;
+    }
+    if (effectiveSelection === '5') {
+      process.stdout.write(`\nOpening: ${URL_LEARN}\n\n`);
+      openBrowser(URL_LEARN);
+      continue;
+    }
+    break;
+  }
+};

package/cli/navigator-grades.js

@@ -0,0 +1,70 @@
+export const resolveGradeColor = (grade) => {
+  if (grade === 'A+' || grade === 'A') return '\x1b[32;1m';
+  if (grade === 'B') return '\x1b[33;1m';
+  if (grade === 'C') return '\x1b[33;1m';
+  if (grade === 'D') return '\x1b[38;5;208;1m';
+  return '\x1b[31;1m';
+};
+
+export const resolveGradeBadge = (grade) => {
+  const color = resolveGradeColor(grade);
+  const padded = grade.length === 1 ? `${grade} ` : grade;
+  return `${color}[Grade: ${padded}]\x1b[0m`;
+};
+
+export const resolveCriticalGrade = (count) => {
+  if (count === 0) return 'A+';
+  if (count === 1) return 'D';
+  return 'F';
+};
+
+export const resolveHighMedGrade = (count) => {
+  if (count === 0) return 'A+';
+  if (count <= 3) return 'B';
+  if (count <= 8) return 'C';
+  if (count <= 15) return 'D';
+  return 'F';
+};
+
+export const resolveLowGrade = (count) => {
+  if (count === 0) return 'A+';
+  if (count <= 5) return 'B';
+  if (count <= 15) return 'C';
+  return 'D';
+};
+
+const isFailedPillar = (p) => p.status === 'FAILED';
+const isWarnPillar = (p) => p.status === 'WARN';
+
+export const resolvePillarGrade = (pillars) => {
+  const values = Object.values(pillars || {});
+  const failed = values.filter(isFailedPillar).length;
+  const warn = values.filter(isWarnPillar).length;
+  if (failed === 0 && warn === 0) return 'A+';
+  if (failed === 0) return 'B';
+  if (failed <= 2) return 'C';
+  if (failed <= 4) return 'D';
+  return 'F';
+};
+
+const isExtremeFile = (h) => h.lineCount >= 2000;
+const isSevereFile = (h) => h.lineCount >= 1000;
+const isWarningFile = (h) => h.lineCount > 500;
+
+export const resolveHotspotGrade = (hotspots) => {
+  if (!hotspots || hotspots.length === 0) return 'A+';
+  const hasExtreme = hotspots.some(isExtremeFile);
+  if (hasExtreme) return 'F';
+  const hasSevere = hotspots.some(isSevereFile);
+  if (hasSevere) return 'D';
+  const hasWarning = hotspots.some(isWarningFile);
+  if (hasWarning) return 'C';
+  return 'B';
+};
+
+export const resolveContextGrade = (riskTier) => {
+  if (riskTier === 'LOW') return 'A';
+  if (riskTier === 'MEDIUM') return 'B';
+  if (riskTier === 'HIGH') return 'D';
+  return 'F';
+};