content-grade 1.0.18 → 1.0.20

package/CONTRIBUTING.md

@@ -1,33 +1,73 @@
 # Contributing to Content-Grade
 
+Thanks for your interest in contributing. Content-Grade is a CLI and web tool for grading content with Claude — bugs, feature ideas, and code contributions are all welcome.
+
+## Quick links
+
+- [Report a bug](https://github.com/StanislavBG/Content-Grade/issues/new?template=bug_report.yml)
+- [Request a feature](https://github.com/StanislavBG/Content-Grade/issues/new?template=feature_request.yml)
+- [Ask a question](https://github.com/StanislavBG/Content-Grade/discussions/categories/q-a)
+- [Share what you built](https://github.com/StanislavBG/Content-Grade/discussions/categories/show-and-tell)
+- [Roadmap](ROADMAP.md)
+
 ## Reporting bugs
 
 Open an issue using the **Bug report** template. Include:
 - Your Node.js version (`node --version`)
 - The exact command you ran
-- Output of `npx content-grade init` if it's a setup issue
+- Output of `npx content-grade@latest init` if it's a setup issue
 - Expected vs. actual behavior
 
-## Suggesting features
+## Requesting features
+
+Open an issue using **Feature request**, or post in [Discussions → Ideas](https://github.com/StanislavBG/Content-Grade/discussions/categories/ideas). Describe the problem you're trying to solve, not just the solution you have in mind.
+
+## Development setup
+
+```bash
+# Clone and install
+git clone https://github.com/StanislavBG/Content-Grade.git
+cd Content-Grade
+npm install
+
+# Run in development
+node bin/content-grade.js demo         # smoke test — no API key needed
+node bin/content-grade.js analyze README.md  # requires ANTHROPIC_API_KEY
+
+# Run all checks (must pass before opening a PR)
+npm test          # vitest — all tests green
+npm run typecheck # zero TypeScript errors
+npm run build     # vite + tsc — must compile clean
+```
+
+### Environment variables
+
+Copy `.env.example` to `.env` if one exists, or set these:
 
-Open an issue using **Feature request**, or post in [GitHub Discussions → Ideas](https://github.com/StanislavBG/Content-Grade/discussions/categories/ideas). Describe the use case, not just the feature.
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ANTHROPIC_API_KEY` | For analysis tools | Your Anthropic API key |
+| `PORT` | No (default 3001) | Port for the web dashboard server |
+
+The `demo` command and all tests run without an API key — no credentials needed to contribute.
 
 ## Submitting a pull request
 
 1. Fork the repo, create a branch from `main`
-2. Make changes — see code style notes below
-3. Run the full check before opening a PR:
+2. Make your change
+3. Run the full check:
 
 ```bash
-npm test          # all tests must pass
-npm run typecheck # zero TypeScript errors
+npm test
+npm run typecheck
+npm run build
 ```
 
 4. Open a PR with a clear description of what changed and why
 
-## Code style
+The PR template has a checklist — fill it out. Small, focused PRs review faster.
 
-Scripts from `package.json` tell you what tools are in play:
+## Code style
 
 | Script | What it does |
 |--------|-------------|
@@ -37,11 +77,21 @@ Scripts from `package.json` tell you what tools are in play:
 | `npm run typecheck` | `tsc --noEmit` — types must be clean |
 | `npm run build` | vite + tsc server build — must pass before release |
 
+Rules:
 - TypeScript throughout — no `any` without a comment explaining why
 - CLI errors use `fail()` helper, never raw `console.error` + `process.exit`
 - New Claude prompts must include the scoring calibration note (see existing prompts)
 - No hardcoded API keys or credentials anywhere
 
-## Questions
+## What gets merged
+
+- Bug fixes with a test that reproduces the bug
+- Features that have a clear use case described in an issue first
+- Documentation improvements — always welcome
+- Performance improvements with benchmarks
+
+If you're unsure whether a PR will be accepted, open an issue or Discussion first.
+
+## Code of conduct
 
-Post in [GitHub Discussions → Q&A](https://github.com/StanislavBG/Content-Grade/discussions/categories/q-a).
+This project follows the [Contributor Covenant](CODE_OF_CONDUCT.md). Be kind, be constructive.

package/README.md

@@ -1007,6 +1007,20 @@ See [docs/social-proof/built-with-badge.md](docs/social-proof/built-with-badge.m
 
 ---
 
+## Community
+
+[![GitHub Stars](https://img.shields.io/github/stars/StanislavBG/Content-Grade?style=social)](https://github.com/StanislavBG/Content-Grade)
+
+**1,159 developers have installed Content-Grade — join the community.**
+
+If Content-Grade saves you time, a ⭐ goes a long way. It helps more developers find the tool and keeps the project active.
+
+**Early adopter program:** The first 50 seats are still open — early adopters get permanent free Pro tier. [Claim your seat →](https://content-grade.github.io/Content-Grade/#early-adopter)
+
+**Found a bug? Have a use case?** [Open an issue](https://github.com/StanislavBG/Content-Grade/issues/new/choose) or [start a discussion](https://github.com/StanislavBG/Content-Grade/discussions/new) — every report shapes what gets built next.
+
+---
+
 ## Legal
 
 - [Privacy Policy](https://content-grade.github.io/Content-Grade/privacy.html)

package/bin/content-grade.js

@@ -33,6 +33,15 @@ const CONFIG_DIR  = resolve(homedir(), '.config', 'content-grade');
 const CONFIG_FILE = resolve(CONFIG_DIR, 'config.json');
 const USAGE_FILE  = resolve(CONFIG_DIR, 'usage.json');
 
+// License file — canonical store for activated license keys
+const LICENSE_DIR  = resolve(homedir(), '.content-grade');
+const LICENSE_FILE = resolve(LICENSE_DIR, 'license.json');
+
+// Valid format: CG-XXXX-XXXX-XXXX-XXXX (16 hex chars in 4 groups of 4)
+function isValidKeyFormat(key) {
+  return typeof key === 'string' && /^CG-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}$/i.test(key.trim());
+}
+
 function loadConfig() {
   try { return JSON.parse(readFileSync(CONFIG_FILE, 'utf8')); } catch { return {}; }
 }
@@ -43,12 +52,21 @@ function saveConfig(data) {
 }
 
 function getLicenseKey() {
-  return process.env.CONTENT_GRADE_KEY || loadConfig().licenseKey || null;
+  if (process.env.CONTENT_GRADE_KEY) return process.env.CONTENT_GRADE_KEY;
+  const configKey = loadConfig().licenseKey;
+  if (configKey) return configKey;
+  // Also check canonical license file
+  try {
+    const lic = JSON.parse(readFileSync(LICENSE_FILE, 'utf8'));
+    return lic.key || null;
+  } catch { return null; }
 }
 
 function getLicenseTier() {
   const cfg = loadConfig();
-  return cfg.tier || 'free';  // free | starter | pro | team
+  const tier = cfg.tier || 'free';
+  // Collapse legacy 'starter' tier to 'pro' — Starter was removed
+  return tier === 'starter' ? 'pro' : tier;
 }
 
 function isProUser() { return Boolean(getLicenseKey()); }
@@ -71,45 +89,105 @@ function incrementUsage() {
   return u.count;
 }
 
-// Usage tiers — daily limits per plan (properly scaled: higher tiers = better $/run)
-const TIER_LIMITS = {
-  free:    5,     // 5/day — try it out
-  starter: 10,   // 10/day — $0.030/run
-  pro:     50,   // 50/day — $0.019/run (best value per run)
-  team:    200,   // 200/day — $0.013/run (bulk)
-};
-
+// Upgrade links — Free → Pro → Business → Team
 const UPGRADE_LINKS = {
-  free:    'https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a',  // Starter $9/mo
-  starter: 'https://buy.stripe.com/bJefZjafO2Tz36Z2W48k80b',  // Pro $29/mo
-  pro:     'https://buy.stripe.com/cNiaEZfA8cu9bDv4088k80c',  // Team $79/mo
+  free:     'https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a',  // Pro $9/mo — direct checkout
+  pro:      'https://buy.stripe.com/bJefZjafO2Tz36Z2W48k80b',  // Business $29/mo
+  business: 'https://buy.stripe.com/cNiaEZfA8cu9bDv4088k80c',  // Team $79/mo
 };
 
 const TIER_NAMES = {
-  free:    'Free (5/day)',
-  starter: 'Starter — $9/mo (10/day)',
-  pro:     'Pro — $29/mo (50/day)',
-  team:    'Team — $79/mo (200/day)',
+  free:     'Free',
+  pro:      'Pro',
+  business: 'Business',
+  team:     'Team',
+};
+
+const TIER_LIMITS = {
+  free:     3,
+  pro:      Infinity,
+  business: 100,
+  team:     500,
 };
 
-function getDailyLimit() {
+function getUpgradeMessage() {
   const tier = getLicenseTier();
-  return TIER_LIMITS[tier] || TIER_LIMITS.free;
+  if (tier === 'free')     return `Upgrade to Pro — unlimited analyses for $9/mo → ${UPGRADE_LINKS.free}`;
+  if (tier === 'pro')      return `Upgrade to Business — 100 analyses/day for $29/mo → ${UPGRADE_LINKS.pro}`;
+  if (tier === 'business') return `Upgrade to Team — 500 analyses/day for $79/mo → ${UPGRADE_LINKS.business}`;
+  return '';
 }
 
-function checkDailyLimit() {
-  const limit = getDailyLimit();
-  const u = getUsage();
-  if (u.count >= limit) return { ok: false, count: u.count, limit };
-  return { ok: true, count: u.count, limit };
+// Show usage-aware upgrade CTA after each free run.
+// count = today's usage AFTER this run (1 = first run, 3 = last free run).
+function showFreeTierCTA(count) {
+  const limit = TIER_LIMITS.free; // 3
+  const remaining = Math.max(0, limit - count);
+
+  blank();
+  hr();
+
+  if (remaining === 0) {
+    // Last free run used — maximum urgency
+    console.log(`  ${RD}${B}Daily limit reached${R}  ${D}(${count}/${limit} free runs used today)${R}`);
+    blank();
+    console.log(`  That's ${count} analyses today. Pro is ${B}$9/mo${R} — run as many as you need.`);
+    console.log(`  ${B}Unlimited + batch mode${R} — grade an entire directory in one command.`);
+    blank();
+    console.log(`  ${MG}${B}→ Upgrade to Pro — $9/mo${R}`);
+    console.log(`  ${CY}  ${UPGRADE_LINKS.free}${R}`);
+    blank();
+    console.log(`  ${D}Already have a key?  ${CY}content-grade activate${R}`);
+  } else if (remaining === 1) {
+    // 1 run left — build urgency
+    console.log(`  ${YL}${B}${count}/${limit} free runs used${R}  ${D}· 1 remaining${R}`);
+    blank();
+    console.log(`  Last free run of the day. Pro is ${B}$9/mo${R} — unlimited + batch mode.`);
+    console.log(`  ${MG}${B}→ Upgrade now:${R}  ${CY}${UPGRADE_LINKS.free}${R}`);
+    blank();
+    console.log(`  ${D}Or use your last run:  ${CY}content-grade analyze ./another-post.md${R}`);
+  } else {
+    // 1+ runs left — light, value-focused nudge
+    console.log(`  ${D}Free tier: ${count}/${limit} runs used today · ${remaining} remaining${R}`);
+    blank();
+    console.log(`  ${B}What to do next:${R}`);
+    blank();
+    console.log(`  ${CY}content-grade headline "Your title here"${R}      ${D}# grade a headline in ~5s${R}`);
+    console.log(`  ${CY}content-grade analyze ./another-post.md${R}       ${D}# analyze another file${R}`);
+    console.log(`  ${CY}content-grade analyze https://yoursite.com/post${R}  ${D}# audit any live URL${R}`);
+    blank();
+    console.log(`  ${MG}Unlock batch mode:${R} grade a whole directory at once`);
+    console.log(`  ${D}  Have a key?  ${CY}content-grade activate${R}`);
+    console.log(`  Get Pro — $9/mo: ${CY}${UPGRADE_LINKS.free}${R}`);
+  }
 }
 
-function getUpgradeMessage() {
-  const tier = getLicenseTier();
-  const link = UPGRADE_LINKS[tier];
-  if (!link) return '';  // team tier — no upgrade available
-  const nextTier = tier === 'free' ? 'Starter ($9/mo, 20/day)' : tier === 'starter' ? 'Pro ($29/mo, 50/day)' : 'Team ($79/mo, 100/day)';
-  return `Upgrade to ${nextTier} → ${link}`;
+// Block a run before it starts if the free tier is exhausted.
+// Returns true (blocked) and prints a visually distinct upgrade prompt.
+// Returns false if the user may proceed.
+function checkFreeTierLimit() {
+  if (isProUser()) return false;
+  const usage = getUsage();
+  const limit = TIER_LIMITS.free;
+  if (usage.count < limit) return false;
+
+  blank();
+  hr();
+  console.log(`  ${RD}${B}Daily limit reached${R}  ${D}(${usage.count}/${limit} free runs used today)${R}`);
+  blank();
+  console.log(`  ${B}Upgrade to Pro — $9/mo${R} to keep going:`);
+  blank();
+  console.log(`  ${GN}✓${R}  ${B}Unlimited analyses${R}  no daily cap`);
+  console.log(`  ${GN}✓${R}  ${B}Batch mode${R}          grade an entire directory at once`);
+  console.log(`  ${GN}✓${R}  ${B}URL analysis${R}        audit any live page`);
+  blank();
+  console.log(`  ${MG}${B}→ Upgrade to Pro — $9/mo${R}`);
+  console.log(`  ${CY}  ${UPGRADE_LINKS.free}${R}`);
+  blank();
+  console.log(`  ${D}Already have a key?  ${CY}content-grade activate${R}`);
+  hr();
+  blank();
+  return true;
 }
 
 let _version = '1.0.0';
@@ -377,20 +455,7 @@ async function cmdAnalyze(filePath) {
     process.exit(1);
   }
 
-  // Free tier daily limit
-  const limitCheck = checkDailyLimit();
-  if (!limitCheck.ok) {
-    blank();
-    fail(`Daily limit reached (${limitCheck.count}/${limitCheck.limit} runs used today on ${TIER_NAMES[getLicenseTier()]} plan).`);
-    blank();
-    console.log(`  ${B}Options:${R}`);
-    console.log(`  ${D}· Wait until tomorrow (limit resets at midnight)${R}`);
-    console.log(`  ${D}· Upgrade your plan: ${CY}content-grade activate${R}`);
-    blank();
-    console.log(`  ${MG}${getUpgradeMessage()}${R}`);
-    blank();
-    process.exit(1);
-  }
+  if (checkFreeTierLimit()) { process.exit(1); }
 
   if (!_jsonMode && !_quietMode) {
     banner();
@@ -535,8 +600,8 @@ async function cmdAnalyze(filePath) {
     blank();
   }
 
-  // Track usage
-  incrementUsage();
+  // Track usage — skip entirely for licensed users
+  const usageCount = isProUser() ? 0 : incrementUsage();
 
   // Save to file if --save flag is set
   if (_saveMode && result) {
@@ -551,25 +616,13 @@ async function cmdAnalyze(filePath) {
     }
   }
 
-  // Next step — graduated CTA after user has seen value
-  blank();
-  hr();
+  // Next step — usage-aware CTA after user has seen value
   if (isProUser()) {
+    blank();
+    hr();
     console.log(`  ${D}Pro active · Next: ${CY}content-grade batch ./posts/${R}${D} to analyze a whole directory${R}`);
   } else {
-    const usage = getUsage();
-    const remaining = Math.max(0, FREE_DAILY_LIMIT - usage.count);
-    console.log(`  ${B}What to do next:${R}`);
-    blank();
-    console.log(`  ${CY}content-grade headline "Your title here"${R}      ${D}# grade a headline in ~5s${R}`);
-    console.log(`  ${CY}content-grade analyze ./another-post.md${R}       ${D}# analyze another file${R}`);
-    console.log(`  ${CY}content-grade analyze https://yoursite.com/post${R}  ${D}# audit any live URL${R}`);
-    blank();
-    if (remaining <= 10) {
-      console.log(`  ${YL}${remaining} runs left today (${TIER_NAMES[getLicenseTier()]}).${R} ${MG}${getUpgradeMessage()}${R}`);
-    } else {
-      console.log(`  ${D}${remaining} runs left today. ${getUpgradeMessage()}${R}`);
-    }
+    showFreeTierCTA(usageCount);
   }
 
   // CI exit code — shown after full output so user sees the score before exit
@@ -642,20 +695,7 @@ async function cmdHeadline(text) {
     process.exit(1);
   }
 
-  // Free tier daily limit
-  const limitCheck = checkDailyLimit();
-  if (!limitCheck.ok) {
-    blank();
-    fail(`Daily limit reached (${limitCheck.count}/${limitCheck.limit} runs used today on ${TIER_NAMES[getLicenseTier()]} plan).`);
-    blank();
-    console.log(`  ${B}Options:${R}`);
-    console.log(`  ${D}· Wait until tomorrow (limit resets at midnight)${R}`);
-    console.log(`  ${D}· Upgrade your plan: ${CY}content-grade activate${R}`);
-    blank();
-    console.log(`  ${MG}${getUpgradeMessage()}${R}`);
-    blank();
-    process.exit(1);
-  }
+  if (checkFreeTierLimit()) { process.exit(1); }
 
   if (!_jsonMode && !_quietMode) {
     banner();
@@ -742,8 +782,8 @@ async function cmdHeadline(text) {
   console.log(`  ${D}Compare two headlines:  ${CY}content-grade start${R}  → HeadlineGrader compare${R}`);
   blank();
   if (!isProUser()) {
-    console.log(`  ${MG}${getUpgradeMessage()}${R}`);
-    blank();
+    const usageCount = incrementUsage();
+    showFreeTierCTA(usageCount);
   }
 }
 
@@ -823,7 +863,7 @@ async function cmdInit() {
     console.log(`  ${CY}content-grade start${R}`);
     blank();
   }
-  console.log(`  ${D}Pro tier: 100 analyses/day + batch mode — ${CY}content-grade.onrender.com${R}`);
+  console.log(`  ${D}Pro tier: unlimited analyses/day + batch mode — ${CY}content-grade.onrender.com${R}`);
   blank();
 }
 
@@ -843,14 +883,14 @@ async function cmdActivate() {
     blank();
     console.log(`  ${B}Pro features:${R}`);
     console.log(`  ${D}  content-grade batch ./posts/   ${R}${D}# analyze all files in a directory${R}`);
-    console.log(`  ${D}  100 checks/day (vs 50 free)${R}`);
+    console.log(`  ${D}  Unlimited analyses/day (vs 3 free)${R}`);
     blank();
     return;
   }
 
   console.log(`  ${D}Pro tier unlocks:${R}`);
   console.log(`  ${D}  · ${CY}content-grade batch <dir>${R}${D} — analyze entire directories${R}`);
-  console.log(`  ${D}  · 100 checks/day (vs 50 free)${R}`);
+  console.log(`  ${D}  · Unlimited analyses/day (vs 3 free)${R}`);
   blank();
   console.log(`  ${D}Get a license: ${CY}content-grade.onrender.com${R}${D} → Pricing${R}`);
   blank();
@@ -899,6 +939,14 @@ async function cmdActivate() {
     process.exit(1);
   }
 
+  // Validate key format: CG-XXXX-XXXX-XXXX-XXXX
+  if (!isValidKeyFormat(key)) {
+    blank();
+    fail(`Invalid key format. Expected: CG-XXXX-XXXX-XXXX-XXXX (e.g. CG-A1B2-C3D4-E5F6-A7B8)`);
+    blank();
+    process.exit(1);
+  }
+
   // Validate key against server before storing
   const serverUrl = process.env.CONTENT_GRADE_SERVER_URL || 'https://content-grade.onrender.com';
   blank();
@@ -945,6 +993,14 @@ async function cmdActivate() {
   config.activatedAt = new Date().toISOString();
   saveConfig(config);
 
+  // Also write canonical license file to ~/.content-grade/license.json
+  mkdirSync(LICENSE_DIR, { recursive: true });
+  writeFileSync(LICENSE_FILE, JSON.stringify({
+    key,
+    tier: activatedTier,
+    activatedAt: config.activatedAt,
+  }, null, 2), 'utf8');
+
   const tierLimit = TIER_LIMITS[activatedTier] || TIER_LIMITS.free;
   blank();
   ok(`${(TIER_NAMES[activatedTier] || activatedTier).split(' —')[0]} activated! Your daily limit is now ${tierLimit} analyses.`);
@@ -1072,7 +1128,7 @@ async function cmdBatch(dirPath) {
         'claude-haiku-4-5-20251001'
       );
       const r = parseJSON(raw);
-      incrementUsage();
+      if (!isProUser()) incrementUsage();
       const sc = r.total_score;
       const scoreColor = sc >= 70 ? GN : sc >= 45 ? YL : RD;
       process.stdout.write(`\r  ${scoreColor}${String(sc).padStart(3)}/100${R}  ${gradeLetter(sc)}  ${rel}${' '.repeat(10)}\n`);
@@ -1444,14 +1500,12 @@ function cmdHelp() {
   console.log(`    · Node.js 18+`);
   blank();
 
-  console.log(`  ${B}PRO TIER${R}  ${MG}$9/mo${R}`);
+  console.log(`  ${B}PRICING${R}`);
   blank();
-  console.log(`    · 100 analyses/day (vs 50 free)`);
-  console.log(`    · Competitor headline A/B comparison`);
-  console.log(`    · Landing page URL audit`);
-  console.log(`    · Ad copy scoring (Google, Meta, LinkedIn)`);
-  console.log(`    · Email subject line optimizer`);
-  console.log(`    · Audience archetype decoder`);
+  console.log(`    Free       3/day    $0`);
+  console.log(`    Pro    Unlimited    $9/mo`);
+  console.log(`    Business 100/day   $29/mo`);
+  console.log(`    Team     500/day   $79/mo`);
   blank();
   console.log(`    Purchase at: ${CY}content-grade.onrender.com${R}`);
   console.log(`    Then unlock: ${CY}content-grade activate <your-license-key>${R}`);
@@ -1622,10 +1676,9 @@ async function cmdDemo() {
     console.log(`  ${CY}npx content-grade headline "Your title here"${R}   ${D}# grade a single headline${R}`);
     blank();
 
-    // Show telemetry notice after user has seen value (first run only)
+    // Show telemetry notice on first run (opt-out model)
     if (_showTelemNotice) {
-      console.log(`  ${D}Help improve ContentGrade — enable anonymous usage analytics: ${CY}content-grade telemetry on${R}`);
-      console.log(`  ${D}No PII, no file contents. View what's collected: ${CY}content-grade telemetry${R}`);
+      console.log(`  ${D}Anonymous usage analytics enabled — no PII, no file contents. Opt out: ${CY}content-grade telemetry off${R}`);
       blank();
     }
 
@@ -1922,7 +1975,7 @@ function analysisToMarkdown(result, sourceName, analyzedAt) {
   }
 
   lines.push(`---`);
-  lines.push(`Generated by [ContentGrade](https://buy.stripe.com/5kQeVfew48dT7nf2W48k801) v${_version}`);
+  lines.push(`Generated by [ContentGrade](https://content-grade.onrender.com) v${_version}`);
   return lines.join('\n');
 }
 
@@ -2071,7 +2124,7 @@ if (_rawArgs.includes('--help') || _rawArgs.includes('-h')) {
 }
 
 if (_demoMode) {
-  recordEvent({ event: 'command', command: 'demo' });
+  recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'demo' });
   cmdDemo().catch(err => {
     blank();
     fail(`Demo error: ${err.message}`);
@@ -2083,7 +2136,7 @@ if (_demoMode) {
   case 'analyse':
   case 'check':
   case 'grade':
-    recordEvent({ event: 'command', command: 'analyze' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'analyze' });
     cmdAnalyze(args[1]).catch(err => {
       blank();
       fail(`Unexpected error: ${err.message}`);
@@ -2093,7 +2146,7 @@ if (_demoMode) {
     break;
 
   case 'demo':
-    recordEvent({ event: 'command', command: 'demo' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'demo' });
     cmdDemo().catch(err => {
       blank();
       fail(`Demo error: ${err.message}`);
@@ -2103,7 +2156,7 @@ if (_demoMode) {
     break;
 
   case 'headline':
-    recordEvent({ event: 'command', command: 'headline' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'headline' });
     cmdHeadline(args.slice(1).join(' ')).catch(err => {
       blank();
       fail(`Unexpected error: ${err.message}`);
@@ -2114,13 +2167,13 @@ if (_demoMode) {
 
   case 'start':
   case 'serve':
-    recordEvent({ event: 'command', command: 'start' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'start' });
     cmdStart();
     break;
 
   case 'init':
   case 'setup':
-    recordEvent({ event: 'command', command: 'init' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'init' });
     cmdInit().catch(err => {
       blank();
       fail(`Setup error: ${err.message}`);
@@ -2131,7 +2184,7 @@ if (_demoMode) {
 
   case 'activate':
   case 'license':
-    recordEvent({ event: 'command', command: 'activate' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'activate' });
     cmdActivate().catch(err => {
       blank();
       fail(`Activation error: ${err.message}`);
@@ -2142,7 +2195,7 @@ if (_demoMode) {
 
   case 'seo-audit':
   case 'seoaudit':
-    recordEvent({ event: 'command', command: 'seo-audit' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'seo-audit' });
     if (!args[1]) {
       blank();
       fail(`No URL specified.`);
@@ -2161,7 +2214,7 @@ if (_demoMode) {
     break;
 
   case 'batch':
-    recordEvent({ event: 'command', command: 'batch' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'batch' });
     cmdBatch(args[1]).catch(err => {
       blank();
       fail(`Batch error: ${err.message}`);
@@ -2179,7 +2232,7 @@ if (_demoMode) {
   case 'check-updates':
   case 'update':
   case 'upgrade-check':
-    recordEvent({ event: 'command', command: 'check-updates' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'check-updates' });
     cmdCheckUpdates().catch(err => {
       blank();
       fail(`Update check error: ${err.message}`);
@@ -2234,13 +2287,13 @@ if (_demoMode) {
 
   case undefined:
     // No command — show instant static demo (no Claude required, zero wait)
-    recordEvent({ event: 'command', command: 'quick_demo' });
+    recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'quick_demo' });
     cmdQuickDemo();
     break;
 
   default:
     if (/^https?:\/\//i.test(raw)) {
-      recordEvent({ event: 'command', command: 'analyze_url' });
+      recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'analyze_url' });
       cmdAnalyzeUrl(raw).catch(err => {
         blank();
         fail(`Unexpected error: ${err.message}`);
@@ -2274,7 +2327,7 @@ if (_demoMode) {
       } catch {
         target = raw; // let cmdAnalyze handle the "not found" error
       }
-      recordEvent({ event: 'command', command: 'analyze' });
+      recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'analyze' });
       cmdAnalyze(target).catch(err => {
         blank();
         fail(`Unexpected error: ${err.message}`);
@@ -2287,7 +2340,7 @@ if (_demoMode) {
       //         npx content-grade Why most startups fail
       const allText = args.join(' ').trim();
       if (allText && allText.length >= 5 && !allText.startsWith('-')) {
-        recordEvent({ event: 'command', command: 'headline_smart' });
+        recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'headline_smart' });
         cmdHeadline(allText).catch(err => {
           blank();
           fail(`Unexpected error: ${err.message}`);