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

package/cli/installer-templates.js

@@ -0,0 +1,91 @@
+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
+
+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 ! \$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
+  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,21 @@
+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 areGuardrailsInstalled(targetDir?: string): boolean;
+export declare function runInstallWizard(targetDir?: string): Promise<void>;

package/cli/installer.js

@@ -0,0 +1,104 @@
+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 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');
+  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: Unlimited Lifetime ($97) -> 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 (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');
+    }
+
+    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: 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');
+
+  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 ($97: Unlimited Lifetime)'
+      ],
+      { stdio: 'inherit' }
+    );
+
+    const choice = gumChoose(
+      [
+        `1. ⚡ Continue in Evaluation Mode (Press Enter to ${actionLabel})`,
+        '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}`
+    );
+
+    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 (Team Power Puff or Single Dev)\n' +
+    '  [3] Buy License ($27 Solo / $97 Team Power Puff Unlimited Lifetime)\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);
+  }
+};