content-grade 1.0.13 → 1.0.14

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

@@ -66,7 +66,7 @@ function incrementUsage() {
   return u.count;
 }
 
-const FREE_DAILY_LIMIT = 50;
+const FREE_DAILY_LIMIT = 5;
 
 function checkDailyLimit() {
   if (isProUser()) return { ok: true };
@@ -252,18 +252,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);
   }
@@ -343,9 +348,9 @@ async function cmdAnalyze(filePath) {
     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}· Unlock unlimited: ${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}Upgrade to Pro ($9/mo) for unlimited analyses →${R}  ${CY}https://buy.stripe.com/5kQeVfew48dT7nf2W48k801${R}`);
     blank();
     process.exit(1);
   }
@@ -524,7 +529,7 @@ 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} free checks left today.${R} Unlock unlimited: ${CY}content-grade activate${R}`);
     } else {
       console.log(`  ${D}${remaining} free checks left today · Pro ($9/mo): ${CY}content-grade.github.io/Content-Grade${R}`);
     }
@@ -608,9 +613,9 @@ async function cmdHeadline(text) {
     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}· Unlock unlimited: ${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}Upgrade to Pro ($9/mo) for unlimited analyses →${R}  ${CY}https://buy.stripe.com/5kQeVfew48dT7nf2W48k801${R}`);
     blank();
     process.exit(1);
   }
@@ -700,7 +705,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}Upgrade to Pro ($9/mo) for unlimited analyses →${R}  ${CY}https://buy.stripe.com/5kQeVfew48dT7nf2W48k801${R}`);
     blank();
   }
 }
@@ -1123,7 +1128,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 +1307,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 +1353,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 +1499,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 +1875,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 +1895,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 +1936,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 +1944,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 +2023,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "content-grade",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "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": {