content-grade 1.0.19 → 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,7 +52,14 @@ 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() {
@@ -75,9 +91,9 @@ function incrementUsage() {
 
 // Upgrade links — Free → Pro → Business → Team
 const UPGRADE_LINKS = {
-  free:     'https://content-grade.onrender.com/#pricing',  // Pro $9/mo
-  pro:      'https://content-grade.onrender.com/#pricing',  // Business $29/mo
-  business: 'https://content-grade.onrender.com/#pricing',  // 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 = {
@@ -89,16 +105,16 @@ const TIER_NAMES = {
 
 const TIER_LIMITS = {
   free:     3,
-  pro:      20,
+  pro:      Infinity,
   business: 100,
   team:     500,
 };
 
 function getUpgradeMessage() {
   const tier = getLicenseTier();
-  if (tier === 'free')     return `Upgrade to Pro (20/day) → ${UPGRADE_LINKS.free}`;
-  if (tier === 'pro')      return `Upgrade to Business (100/day) → ${UPGRADE_LINKS.pro}`;
-  if (tier === 'business') return `Upgrade to Team (500/day) → ${UPGRADE_LINKS.business}`;
+  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 '';
 }
 
@@ -113,22 +129,23 @@ function showFreeTierCTA(count) {
 
   if (remaining === 0) {
     // Last free run used — maximum urgency
-    console.log(`  ${RD}${B}Free tier limit reached${R}  ${D}(${count}/${limit} runs used today)${R}`);
+    console.log(`  ${RD}${B}Daily limit reached${R}  ${D}(${count}/${limit} free runs used today)${R}`);
     blank();
-    console.log(`  You've seen what ContentGrade can do. Don't stop here.`);
-    console.log(`  ${B}Pro${R} gives you ${B}20 analyses/day${R} + batch mode for whole directories.`);
+    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 for $9/mo${R}  ${CY}${UPGRADE_LINKS.free}${R}`);
+    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 today${R}  ${D}· 1 remaining${R}`);
+    console.log(`  ${YL}${B}${count}/${limit} free runs used${R}  ${D}· 1 remaining${R}`);
     blank();
-    console.log(`  One run left on the free tier. ${B}Pro unlocks 20/day${R} + batch analysis.`);
-    console.log(`  ${MG}→ Upgrade for $9/mo:${R}  ${CY}${UPGRADE_LINKS.free}${R}`);
+    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 continue:  ${CY}content-grade analyze ./another-post.md${R}`);
+    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}`);
@@ -139,12 +156,40 @@ function showFreeTierCTA(count) {
     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} ${D}analyze a whole directory at once${R}`);
-    console.log(`  ${D}  ${CY}content-grade activate${R}  ${D}→ enter your Pro license key ($9/mo)${R}`);
-    console.log(`  ${D}  Get one: ${CY}${UPGRADE_LINKS.free}${R}`);
+    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}`);
   }
 }
 
+// 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';
 try { _version = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8')).version ?? '1.0.0'; } catch {}
 
@@ -410,6 +455,8 @@ async function cmdAnalyze(filePath) {
     process.exit(1);
   }
 
+  if (checkFreeTierLimit()) { process.exit(1); }
+
   if (!_jsonMode && !_quietMode) {
     banner();
     console.log(`  ${B}Analyzing:${R} ${CY}${basename(absPath)}${R}`);
@@ -553,8 +600,8 @@ async function cmdAnalyze(filePath) {
     blank();
   }
 
-  // Track usage
-  const usageCount = incrementUsage();
+  // Track usage — skip entirely for licensed users
+  const usageCount = isProUser() ? 0 : incrementUsage();
 
   // Save to file if --save flag is set
   if (_saveMode && result) {
@@ -648,6 +695,8 @@ async function cmdHeadline(text) {
     process.exit(1);
   }
 
+  if (checkFreeTierLimit()) { process.exit(1); }
+
   if (!_jsonMode && !_quietMode) {
     banner();
     console.log(`  ${B}Grading headline:${R}`);
@@ -814,7 +863,7 @@ async function cmdInit() {
     console.log(`  ${CY}content-grade start${R}`);
     blank();
   }
-  console.log(`  ${D}Pro tier: 20 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();
 }
 
@@ -834,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}  20 analyses/day (vs 3 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}  · 20 analyses/day (vs 3 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();
@@ -890,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();
@@ -936,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.`);
@@ -1063,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`);
@@ -1438,7 +1503,7 @@ function cmdHelp() {
   console.log(`  ${B}PRICING${R}`);
   blank();
   console.log(`    Free       3/day    $0`);
-  console.log(`    Pro       20/day    $9/mo`);
+  console.log(`    Pro    Unlimited    $9/mo`);
   console.log(`    Business 100/day   $29/mo`);
   console.log(`    Team     500/day   $79/mo`);
   blank();
@@ -1611,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();
     }
 
@@ -2060,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}`);
@@ -2072,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}`);
@@ -2082,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}`);
@@ -2092,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}`);
@@ -2103,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}`);
@@ -2120,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}`);
@@ -2131,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.`);
@@ -2150,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}`);
@@ -2168,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}`);
@@ -2223,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}`);
@@ -2263,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}`);
@@ -2276,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}`);

package/bin/telemetry.js

@@ -20,7 +20,7 @@ const EVENTS_FILE  = join(CONFIG_DIR, 'events.jsonl');
 // Telemetry endpoint: CLI events are forwarded here when telemetry is enabled.
 // Set CONTENT_GRADE_TELEMETRY_URL to enable remote aggregation (e.g. self-hosted endpoint).
 // Default: local-only (events stored at ~/.content-grade/events.jsonl, no remote send).
-const REMOTE_URL = process.env.CONTENT_GRADE_TELEMETRY_URL || 'https://cg-telemetry.onrender.com/api/telemetry/events';
+const REMOTE_URL = process.env.CONTENT_GRADE_TELEMETRY_URL || 'https://content-grade.onrender.com/api/telemetry';
 
 // ── Internal helpers ──────────────────────────────────────────────────────────
 
@@ -72,13 +72,13 @@ export function initTelemetry() {
     return { installId: cfg.installId, isNew: false, optedOut: false };
   }
 
-  // First run — generate anonymous install ID, opt-out by default (privacy-first)
-  // Users can opt in: content-grade telemetry on
+  // First run — generate anonymous install ID, enabled by default (opt-out available)
+  // Users can opt out: content-grade telemetry off  OR  --no-telemetry flag
   const installId = generateId();
   saveConfig({
     installId,
     installedAt: new Date().toISOString(),
-    telemetryEnabled: false,
+    telemetryEnabled: true,
   });
 
   return { installId, isNew: true, optedOut: false };