content-grade 1.0.13 → 1.0.15

package/README.md

@@ -63,7 +63,7 @@ npx content-grade 'blog/**/*.md'
 
 **JSON output for CI integration:**
 ```bash
-npx content-grade README.md --format json
+npx content-grade README.md --json
 # Returns structured JSON with score, grade, dimensions, and improvements
 # Exit code 1 if score < 50 — useful for blocking low-quality merges
 ```
@@ -549,6 +549,7 @@ tests/
 
 **Documentation:**
 - [`docs/getting-started.md`](./docs/getting-started.md) — step-by-step first-run guide
+- [`docs/cli-reference.md`](./docs/cli-reference.md) — full CLI reference: all commands, flags, output schema, exit codes
 - [`docs/examples.md`](./docs/examples.md) — real-world examples for all 6 tools, CI/CD workflows, Node.js integration
 - [`docs/api.md`](./docs/api.md) — full REST API reference
 

package/bin/content-grade.js

@@ -46,6 +46,11 @@ function getLicenseKey() {
   return process.env.CONTENT_GRADE_KEY || loadConfig().licenseKey || null;
 }
 
+function getLicenseTier() {
+  const cfg = loadConfig();
+  return cfg.tier || 'free';  // free | starter | pro | team
+}
+
 function isProUser() { return Boolean(getLicenseKey()); }
 
 function getTodayKey() { return new Date().toISOString().slice(0, 10); }
@@ -66,13 +71,45 @@ function incrementUsage() {
   return u.count;
 }
 
-const FREE_DAILY_LIMIT = 50;
+// Usage tiers — daily limits per plan
+const TIER_LIMITS = {
+  free:    5,     // 5/day
+  starter: 20,   // ~600/mo ≈ 50/mo was too low for daily use
+  pro:     50,   // ~1500/mo
+  team:    100,   // hard cap even for top tier — no abuse
+};
+
+const UPGRADE_LINKS = {
+  free:    'https://buy.stripe.com/eVq6oJbjSdyd6jbaow8k805',  // Starter $9/mo
+  starter: 'https://buy.stripe.com/00w9AV87G65L7nf54c8k806',  // Pro $29/mo
+  pro:     'https://buy.stripe.com/4gM28t73C79P0YR7ck8k807',  // Team $79/mo
+};
+
+const TIER_NAMES = {
+  free:    'Free (5/day)',
+  starter: 'Starter — $9/mo (20/day)',
+  pro:     'Pro — $29/mo (50/day)',
+  team:    'Team — $79/mo (100/day)',
+};
+
+function getDailyLimit() {
+  const tier = getLicenseTier();
+  return TIER_LIMITS[tier] || TIER_LIMITS.free;
+}
 
 function checkDailyLimit() {
-  if (isProUser()) return { ok: true };
+  const limit = getDailyLimit();
   const u = getUsage();
-  if (u.count >= FREE_DAILY_LIMIT) return { ok: false, count: u.count, limit: FREE_DAILY_LIMIT };
-  return { ok: true, count: u.count, limit: FREE_DAILY_LIMIT };
+  if (u.count >= limit) return { ok: false, count: u.count, limit };
+  return { ok: true, count: u.count, limit };
+}
+
+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}`;
 }
 
 let _version = '1.0.0';
@@ -252,18 +289,23 @@ SCORING CALIBRATION:
 
 async function cmdAnalyze(filePath) {
   if (!filePath) {
+    if (_demoMode) {
+      return cmdDemo();
+    }
     blank();
     fail(`No file specified.`);
     blank();
-    console.log(`  Usage:`);
+    console.log(`  ${B}Usage:${R}`);
     console.log(`    ${CY}content-grade analyze <file>${R}    ${D}(or: check <file>)${R}`);
     blank();
-    console.log(`  Examples:`);
-    console.log(`    ${D}content-grade analyze ./blog-post.md${R}`);
-    console.log(`    ${D}content-grade check ./email-draft.txt${R}`);
-    console.log(`    ${D}content-grade analyze ~/landing-page-copy.md${R}`);
+    console.log(`  ${B}Examples:${R}`);
+    console.log(`    ${CY}content-grade analyze ./blog-post.md${R}`);
+    console.log(`    ${CY}content-grade check ./email-draft.txt${R}`);
+    console.log(`    ${CY}content-grade analyze ~/landing-page-copy.md${R}`);
     blank();
-    console.log(`  ${D}No file? Try the demo: ${CY}content-grade demo${R}`);
+    console.log(`  ${GN}Tip:${R} See it in action first — no file needed:`);
+    console.log(`    ${CY}content-grade --demo${R}              ${D}# live AI analysis on built-in sample${R}`);
+    console.log(`    ${CY}content-grade demo${R}                ${D}# same thing${R}`);
     blank();
     process.exit(1);
   }
@@ -339,13 +381,13 @@ async function cmdAnalyze(filePath) {
   const limitCheck = checkDailyLimit();
   if (!limitCheck.ok) {
     blank();
-    fail(`Daily limit reached (${limitCheck.count}/${limitCheck.limit} free checks used today).`);
+    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}· Unlock 100 checks/day: ${CY}content-grade activate${R}`);
+    console.log(`  ${D}· Upgrade your plan: ${CY}content-grade activate${R}`);
     blank();
-    console.log(`  ${MG}Upgrade to Pro ($9/mo) for 100 analyses/day →${R}  ${CY}https://content-grade.github.io/Content-Grade/${R}`);
+    console.log(`  ${MG}${getUpgradeMessage()}${R}`);
     blank();
     process.exit(1);
   }
@@ -524,9 +566,9 @@ async function cmdAnalyze(filePath) {
     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} free checks left today.${R} Unlock 100/day: ${CY}content-grade activate${R}`);
+      console.log(`  ${YL}${remaining} runs left today (${TIER_NAMES[getLicenseTier()]}).${R} ${MG}${getUpgradeMessage()}${R}`);
     } else {
-      console.log(`  ${D}${remaining} free checks left today · Pro ($9/mo): ${CY}content-grade.github.io/Content-Grade${R}`);
+      console.log(`  ${D}${remaining} runs left today. ${getUpgradeMessage()}${R}`);
     }
   }
 
@@ -604,13 +646,13 @@ async function cmdHeadline(text) {
   const limitCheck = checkDailyLimit();
   if (!limitCheck.ok) {
     blank();
-    fail(`Daily limit reached (${limitCheck.count}/${limitCheck.limit} free checks used today).`);
+    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}· Unlock 100 checks/day: ${CY}content-grade activate${R}`);
+    console.log(`  ${D}· Upgrade your plan: ${CY}content-grade activate${R}`);
     blank();
-    console.log(`  ${MG}Upgrade to Pro ($9/mo) for 100 analyses/day →${R}  ${CY}https://content-grade.github.io/Content-Grade/${R}`);
+    console.log(`  ${MG}${getUpgradeMessage()}${R}`);
     blank();
     process.exit(1);
   }
@@ -700,7 +742,7 @@ async function cmdHeadline(text) {
   console.log(`  ${D}Compare two headlines:  ${CY}content-grade start${R}  → HeadlineGrader compare${R}`);
   blank();
   if (!isProUser()) {
-    console.log(`  ${MG}Upgrade to Pro ($9/mo) for 100 analyses/day →${R}  ${CY}https://content-grade.github.io/Content-Grade/${R}`);
+    console.log(`  ${MG}${getUpgradeMessage()}${R}`);
     blank();
   }
 }
@@ -1123,7 +1165,7 @@ function cmdStart() {
       info(`  EmailForge      — ${url}/email-forge`);
       info(`  AudienceDecoder — ${url}/audience`);
       blank();
-      info(`Free tier: 50 analyses/day. Upgrade at ${url}`);
+      info(`Free tier: 5 analyses/day. Upgrade at ${url}`);
       info(`Press Ctrl+C to stop`);
       blank();
       openBrowser(url);
@@ -1302,10 +1344,10 @@ function cmdHelp() {
   blank();
   console.log(`  ${B}QUICK START${R}`);
   blank();
+  console.log(`    ${CY}npx content-grade --demo${R}                            ${D}# live AI demo — no file needed, see it first${R}`);
   console.log(`    ${CY}npx content-grade headline "Your Headline Here"${R}     ${D}# grade a headline (fastest, ~5s)${R}`);
   console.log(`    ${CY}npx content-grade analyze ./my-post.md${R}              ${D}# full AI analysis of a file (~20s)${R}`);
   console.log(`    ${CY}npx content-grade analyze https://example.com${R}       ${D}# audit any live URL (~20s)${R}`);
-  console.log(`    ${CY}npx content-grade demo${R}                             ${D}# live demo on sample content${R}`);
   console.log(`    ${CY}npx content-grade start${R}                            ${D}# launch web dashboard (6 tools)${R}`);
   blank();
 
@@ -1348,6 +1390,7 @@ function cmdHelp() {
   blank();
   console.log(`  ${B}FLAGS${R}`);
   blank();
+  console.log(`    ${CY}--demo${R}                  Run the live AI demo on built-in sample content`);
   console.log(`    ${CY}--json${R}                  Output raw JSON (great for CI pipelines)`);
   console.log(`    ${CY}--quiet${R}                 Output score number only (for scripting)`);
   console.log(`    ${CY}--save [file]${R}           Save analysis to a markdown file (default: <input>.content-grade.md)`);
@@ -1493,20 +1536,25 @@ function cmdQuickDemo() {
   blank();
   hr();
   if (isFirstRun()) {
-    console.log(`  ${B}${CY}Your next step:${R}`);
+    console.log(`  ${B}${CY}Try it on real content — 3 ways to start:${R}`);
+    blank();
+    console.log(`  ${B}1.${R} Grade a headline ${D}(~5 seconds, works right now)${R}`);
+    console.log(`     ${CY}npx content-grade headline "Your headline here"${R}`);
     blank();
-    console.log(`  ${CY}npx content-grade headline "Your headline here"${R}`);
-    console.log(`  ${D}  Grade any headline in ~5 seconds — no file needed, works right now.${R}`);
+    console.log(`  ${B}2.${R} Run the live AI demo ${D}(full analysis on sample content)${R}`);
+    console.log(`     ${CY}npx content-grade --demo${R}`);
     blank();
-    console.log(`  ${D}Then analyze a full post:  ${CY}npx content-grade analyze ./your-post.md${R}`);
+    console.log(`  ${B}3.${R} Analyze your own file`);
+    console.log(`     ${CY}npx content-grade analyze ./your-post.md${R}`);
     blank();
-    console.log(`  ${D}Requires Claude CLI (free): ${CY}claude.ai/code${R}${D} → install → ${CY}claude login${R}`);
-    console.log(`  ${D}Setup check:               ${CY}npx content-grade init${R}`);
+    console.log(`  ${D}All three require Claude CLI (free): ${CY}claude.ai/code${R}${D} → install → ${CY}claude login${R}`);
+    console.log(`  ${D}First time? Run: ${CY}npx content-grade init${R}${D} to verify setup.${R}`);
   } else {
-    console.log(`  ${B}${CY}Grade a headline right now:${R}`);
+    console.log(`  ${B}${CY}Grade your own content:${R}`);
     blank();
+    console.log(`  ${CY}npx content-grade --demo${R}                       ${D}# live AI demo${R}`);
     console.log(`  ${CY}npx content-grade headline "Your headline here"${R}  ${D}# ~5 seconds${R}`);
-    console.log(`  ${CY}npx content-grade analyze ./your-post.md${R}         ${D}# full AI analysis${R}`);
+    console.log(`  ${CY}npx content-grade analyze ./your-post.md${R}         ${D}# full analysis${R}`);
   }
   blank();
 }
@@ -1864,7 +1912,7 @@ function analysisToMarkdown(result, sourceName, analyzedAt) {
   }
 
   lines.push(`---`);
-  lines.push(`Generated by [ContentGrade](https://content-grade.github.io/Content-Grade/) v${_version}`);
+  lines.push(`Generated by [ContentGrade](https://buy.stripe.com/5kQeVfew48dT7nf2W48k801) v${_version}`);
   return lines.join('\n');
 }
 
@@ -1884,8 +1932,9 @@ const _saveMode = _saveIdx !== -1;
 const _savePath = (_saveMode && _rawArgs[_saveIdx + 1] && !_rawArgs[_saveIdx + 1].startsWith('-'))
   ? _rawArgs[_saveIdx + 1]
   : null;
+const _demoMode = _rawArgs.includes('--demo');
 const args = _rawArgs.filter((a, i) => {
-  if (['--no-telemetry', '--json', '--quiet', '--verbose', '--ci', '--save'].includes(a)) return false;
+  if (['--no-telemetry', '--json', '--quiet', '--verbose', '--ci', '--save', '--demo'].includes(a)) return false;
   if (a === '--threshold') return false;
   if (i > 0 && _rawArgs[i - 1] === '--threshold') return false;
   if (_saveMode && i > 0 && _rawArgs[i - 1] === '--save' && !a.startsWith('-')) return false;
@@ -1924,6 +1973,7 @@ if (_rawArgs.includes('--help') || _rawArgs.includes('-h')) {
       console.log(`    ${CY}<file>${R}              Path to a .md, .txt, or .mdx file`);
       blank();
       console.log(`  ${B}Flags:${R}`);
+      console.log(`    ${CY}--demo${R}             Run on built-in sample content (no file needed)`);
       console.log(`    ${CY}--json${R}             Output raw JSON (great for CI pipelines)`);
       console.log(`    ${CY}--quiet${R}            Output score number only (for scripting)`);
       console.log(`    ${CY}--ci${R}               Exit 0 if score passes, 1 if it fails`);
@@ -1931,6 +1981,7 @@ if (_rawArgs.includes('--help') || _rawArgs.includes('-h')) {
       console.log(`    ${CY}--verbose${R}          Show debug info: model, timing, response length`);
       blank();
       console.log(`  ${B}Examples:${R}`);
+      console.log(`    ${CY}content-grade analyze --demo${R}                   ${D}# live demo on sample content${R}`);
       console.log(`    ${CY}content-grade analyze ./blog-post.md${R}`);
       console.log(`    ${CY}content-grade analyze ./readme.md --json${R}`);
       console.log(`    ${CY}content-grade analyze ./copy.md --ci --threshold 70${R}`);
@@ -2009,7 +2060,15 @@ if (_rawArgs.includes('--help') || _rawArgs.includes('-h')) {
   }
 }
 
-switch (cmd) {
+if (_demoMode) {
+  recordEvent({ event: 'command', command: 'demo' });
+  cmdDemo().catch(err => {
+    blank();
+    fail(`Demo error: ${err.message}`);
+    blank();
+    process.exit(1);
+  });
+} else switch (cmd) {
   case 'analyze':
   case 'analyse':
   case 'check':

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 || '';
+const REMOTE_URL = process.env.CONTENT_GRADE_TELEMETRY_URL || 'https://cg-telemetry.onrender.com/api/telemetry/events';
 
 // ── Internal helpers ──────────────────────────────────────────────────────────
 
@@ -72,15 +72,16 @@ export function initTelemetry() {
     return { installId: cfg.installId, isNew: false, optedOut: false };
   }
 
-  // First run — generate anonymous install ID, opt-IN by default (off until user enables)
+  // First run — generate anonymous install ID, opt-in by default (like Next.js, Astro)
+  // Users can opt out: content-grade telemetry off, --no-telemetry, or CONTENT_GRADE_NO_TELEMETRY=1
   const installId = generateId();
   saveConfig({
     installId,
     installedAt: new Date().toISOString(),
-    telemetryEnabled: false,
+    telemetryEnabled: true,
   });
 
-  return { installId, isNew: true, optedOut: true };
+  return { installId, isNew: true, optedOut: false };
 }
 
 /**
@@ -106,6 +107,7 @@ export function recordEvent(data) {
 
   const event = {
     ...data,
+    package: 'content-grade',
     installId,
     timestamp: new Date().toISOString(),
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "content-grade",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "AI-powered content analysis CLI. Score any blog post, landing page, or ad copy in under 30 seconds — runs on Claude CLI, no API key needed.",
   "type": "module",
   "bin": {