content-grade 1.0.2 → 1.0.4

package/README.md

@@ -15,20 +15,27 @@
 # 1. Verify Claude CLI is installed and logged in
 claude -p "say hi"
 
-# 2. Run an instant demo — no file needed
+# 2. Run instant demo — no file needed, see results in ~30 seconds
 npx content-grade
 
-# 3. Analyze your own content
-npx content-grade ./my-post.md
+# 3. Analyze your own content (grade is an alias for analyze)
+npx content-grade grade ./my-post.md
+npx content-grade analyze ./my-post.md
 
-# 4. Analyze a live URL directly
-npx content-grade https://yoursite.com/blog/post
+# 4. CI pipeline — get raw JSON or score-only output
+npx content-grade analyze ./post.md --json
+npx content-grade analyze ./post.md --quiet   # prints score number only
 
-# 5. Grade a single headline
+# 5. Grade a headline
 npx content-grade headline "Why Most Startups Fail at Month 18"
+
+# 6. Unlock Pro (batch mode, 100/day limit)
+npx content-grade activate
 ```
 
-**One requirement:** [Claude CLI](https://claude.ai/code) must be installed and logged in. That's it — no API keys, no accounts, no data leaves your machine.
+**One requirement:** [Claude CLI](https://claude.ai/code) must be installed and logged in. No API keys, no accounts, no data leaves your machine.
+
+**Free tier:** 50 analyses/day, no signup needed. `npx content-grade grade README.md` works immediately.
 
 ---
 
@@ -90,15 +97,25 @@ npx content-grade headline "Why Most Startups Fail at Month 18"
 | `.` or `<dir>` | Scan a directory, find and analyze the best content file |
 | `demo` | Same as no args |
 | `analyze <file>` | Full content audit: score, grade, dimensions, improvements |
+| `grade <file>` | Alias for `analyze` (e.g. `grade README.md`) |
 | `check <file>` | Alias for `analyze` |
-| `analyse <file>` | Alias for `analyze` (British spelling) |
+| `batch <dir>` | **[Pro]** Analyze all .md/.txt files in a directory |
 | `headline "<text>"` | Grade a headline on 4 copywriting frameworks |
-| `grade "<text>"` | Alias for `headline` |
+| `activate` | Enter license key to unlock Pro features (batch, 100/day) |
 | `init` | First-run setup: verify Claude CLI, run smoke test |
 | `start` | Launch the full web dashboard (6 tools) |
 | `telemetry [on\|off]` | View or toggle anonymous usage tracking |
 | `help` | Full usage and examples |
 
+**Flags:**
+
+| Flag | What it does |
+|------|-------------|
+| `--json` | Raw JSON output — pipe to `jq` for CI integration |
+| `--quiet` | Score number only — for shell scripts |
+| `--version` | Print version |
+| `--no-telemetry` | Skip usage tracking for this run |
+
 **Global flags:**
 
 | Flag | Description |

package/bin/content-grade.js

@@ -16,6 +16,7 @@
 import { execFileSync, execFile, spawn } from 'child_process';
 import { existsSync, readFileSync, mkdirSync, writeFileSync, unlinkSync, statSync } from 'fs';
 import { resolve, dirname, basename, extname } from 'path';
+import { homedir } from 'os';
 import { fileURLToPath } from 'url';
 import { promisify } from 'util';
 import { get as httpsGet } from 'https';
@@ -26,6 +27,54 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const root = resolve(__dirname, '..');
 const execFileAsync = promisify(execFile);
 
+// ── Config + license ──────────────────────────────────────────────────────────
+
+const CONFIG_DIR  = resolve(homedir(), '.config', 'content-grade');
+const CONFIG_FILE = resolve(CONFIG_DIR, 'config.json');
+const USAGE_FILE  = resolve(CONFIG_DIR, 'usage.json');
+
+function loadConfig() {
+  try { return JSON.parse(readFileSync(CONFIG_FILE, 'utf8')); } catch { return {}; }
+}
+
+function saveConfig(data) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2), 'utf8');
+}
+
+function getLicenseKey() {
+  return process.env.CONTENT_GRADE_KEY || loadConfig().licenseKey || null;
+}
+
+function isProUser() { return Boolean(getLicenseKey()); }
+
+function getTodayKey() { return new Date().toISOString().slice(0, 10); }
+
+function getUsage() {
+  try {
+    const d = JSON.parse(readFileSync(USAGE_FILE, 'utf8'));
+    if (d.date !== getTodayKey()) return { date: getTodayKey(), count: 0 };
+    return d;
+  } catch { return { date: getTodayKey(), count: 0 }; }
+}
+
+function incrementUsage() {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  const u = getUsage();
+  u.count = (u.count || 0) + 1;
+  writeFileSync(USAGE_FILE, JSON.stringify(u, null, 2), 'utf8');
+  return u.count;
+}
+
+const FREE_DAILY_LIMIT = 50;
+
+function checkDailyLimit() {
+  if (isProUser()) return { ok: true };
+  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 };
+}
+
 let _version = '1.0.0';
 try { _version = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8')).version ?? '1.0.0'; } catch {}
 
@@ -101,11 +150,27 @@ async function askClaude(prompt, systemPrompt, model = 'claude-haiku-4-5-2025100
   if (systemPrompt) args.push('--system-prompt', systemPrompt);
   args.push(prompt);
 
+  if (_verboseMode) {
+    blank();
+    console.log(`  ${D}[verbose] model: ${model}${R}`);
+    console.log(`  ${D}[verbose] claude: ${claudePath}${R}`);
+    console.log(`  ${D}[verbose] prompt length: ${prompt.length} chars${R}`);
+    blank();
+  }
+
+  const t0 = Date.now();
   const { stdout } = await execFileAsync(claudePath, args, {
     timeout: 120000,
     maxBuffer: 10 * 1024 * 1024,
   });
-  return stdout.trim();
+  const raw = stdout.trim();
+
+  if (_verboseMode) {
+    console.log(`  ${D}[verbose] response: ${raw.length} chars in ${Date.now() - t0}ms${R}`);
+    blank();
+  }
+
+  return raw;
 }
 
 function parseJSON(raw) {
@@ -245,6 +310,19 @@ async function cmdAnalyze(filePath) {
     process.exit(2);
   }
 
+  // Free tier daily limit
+  const limitCheck = checkDailyLimit();
+  if (!limitCheck.ok) {
+    blank();
+    fail(`Daily limit reached (${limitCheck.count}/${limitCheck.limit} free checks used today).`);
+    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}`);
+    blank();
+    process.exit(1);
+  }
+
   if (!_jsonMode && !_quietMode) {
     banner();
     console.log(`  ${B}Analyzing:${R} ${CY}${basename(absPath)}${R}`);
@@ -380,9 +458,22 @@ async function cmdAnalyze(filePath) {
     blank();
   }
 
-  // ── Subtle upsell
+  // Track usage
+  incrementUsage();
+
+  // Upsell — show Pro path after user has seen value
   blank();
-  console.log(`  ${D}Unlock team features at ${CY}contentgrade.dev${R}`);
+  if (isProUser()) {
+    console.log(`  ${D}Pro active · ${CY}contentgrade.dev${R}`);
+  } else {
+    const usage = getUsage();
+    const remaining = Math.max(0, FREE_DAILY_LIMIT - usage.count);
+    hr();
+    console.log(`  ${MG}${B}Unlock batch mode:${R}  ${CY}content-grade activate${R}`);
+    console.log(`  ${D}  · Analyze entire directories in one command${R}`);
+    console.log(`  ${D}  · 100 checks/day (${remaining} remaining today on free tier)${R}`);
+    console.log(`  ${D}  · Get a license at ${CY}contentgrade.dev${R}`);
+  }
   blank();
 }
 
@@ -422,6 +513,19 @@ async function cmdHeadline(text) {
     console.log(`    ${D}content-grade headline "How We Grew From 0 to 10k Users Without Ads"${R}`);
     console.log(`    ${D}content-grade headline "Stop Doing This One Thing in Your Email Subject Lines"${R}`);
     blank();
+    process.exit(2);
+  }
+
+  // Free tier daily limit
+  const limitCheck = checkDailyLimit();
+  if (!limitCheck.ok) {
+    blank();
+    fail(`Daily limit reached (${limitCheck.count}/${limitCheck.limit} free checks used today).`);
+    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}`);
+    blank();
     process.exit(1);
   }
 
@@ -581,6 +685,207 @@ async function cmdInit() {
   blank();
 }
 
+// ── Activate command ──────────────────────────────────────────────────────────
+
+async function cmdActivate() {
+  banner();
+  console.log(`  ${B}Activate ContentGrade Pro${R}`);
+  blank();
+
+  const existing = getLicenseKey();
+  if (existing) {
+    ok(`Pro license already activated`);
+    blank();
+    console.log(`  ${D}Key: ${existing.slice(0, 8)}...${R}`);
+    console.log(`  ${D}Config: ${CONFIG_FILE}${R}`);
+    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}`);
+    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}`);
+  blank();
+  console.log(`  ${D}Get a license: ${CY}contentgrade.dev${R}${D} → Pricing → Team${R}`);
+  blank();
+
+  process.stdout.write(`  ${CY}License key:${R} `);
+
+  const key = await new Promise(res => {
+    let input = '';
+    const isRaw = process.stdin.isTTY;
+    if (isRaw) process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', function onData(chunk) {
+      if (chunk === '\r' || chunk === '\n') {
+        if (isRaw) process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.removeListener('data', onData);
+        process.stdout.write('\n');
+        res(input.trim());
+      } else if (chunk === '\u0003') {
+        if (isRaw) process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write('\n');
+        process.exit(0);
+      } else if (chunk === '\u007f') {
+        if (input.length > 0) { input = input.slice(0, -1); process.stdout.write('\b \b'); }
+      } else {
+        input += chunk;
+        process.stdout.write('*');
+      }
+    });
+  });
+
+  if (!key || key.length < 8) {
+    blank();
+    fail(`Invalid key — must be at least 8 characters.`);
+    blank();
+    process.exit(2);
+  }
+
+  const config = loadConfig();
+  config.licenseKey = key;
+  config.activatedAt = new Date().toISOString();
+  saveConfig(config);
+
+  blank();
+  ok(`License activated! Pro features unlocked.`);
+  blank();
+  console.log(`  ${B}Try it:${R}`);
+  console.log(`  ${CY}  content-grade batch ./posts/${R}   ${D}# analyze all files${R}`);
+  blank();
+}
+
+// ── Batch command (Pro) ───────────────────────────────────────────────────────
+
+async function cmdBatch(dirPath) {
+  if (!isProUser()) {
+    blank();
+    console.log(`  ${B}${MG}Batch Analysis — Pro Feature${R}`);
+    blank();
+    console.log(`  ${D}Batch mode requires a Pro license.${R}`);
+    blank();
+    console.log(`  ${D}Free tier: analyze files one at a time.${R}`);
+    console.log(`    ${CY}content-grade analyze ./post.md${R}`);
+    blank();
+    console.log(`  ${B}Unlock batch mode:${R}`);
+    console.log(`    ${CY}content-grade activate${R}   ${D}(enter your license key)${R}`);
+    blank();
+    console.log(`  ${D}Get a license: ${CY}contentgrade.dev${R}`);
+    blank();
+    process.exit(1);
+  }
+
+  if (!dirPath) {
+    blank();
+    fail(`No directory specified.`);
+    blank();
+    console.log(`  Usage: ${CY}content-grade batch <directory>${R}`);
+    console.log(`  Example: ${CY}content-grade batch ./posts${R}`);
+    blank();
+    process.exit(2);
+  }
+
+  const absDir = resolve(process.cwd(), dirPath);
+  if (!existsSync(absDir)) {
+    blank();
+    fail(`Directory not found: ${absDir}`);
+    blank();
+    process.exit(2);
+  }
+
+  const st = statSync(absDir);
+  if (!st.isDirectory()) {
+    blank();
+    fail(`${dirPath} is not a directory. Use ${CY}content-grade analyze${R} for single files.`);
+    blank();
+    process.exit(2);
+  }
+
+  const files = [];
+  function collectFiles(dir) {
+    let entries;
+    try { entries = readdirSync(dir); } catch { return; }
+    for (const entry of entries) {
+      if (entry.startsWith('.') || entry === 'node_modules' || entry === 'dist') continue;
+      const full = resolve(dir, entry);
+      let s;
+      try { s = statSync(full); } catch { continue; }
+      if (s.isDirectory()) collectFiles(full);
+      else if (/\.(md|txt|mdx)$/i.test(entry)) files.push(full);
+    }
+  }
+  collectFiles(absDir);
+
+  if (!files.length) {
+    blank();
+    fail(`No .md, .txt, or .mdx files found in ${dirPath}`);
+    blank();
+    process.exit(1);
+  }
+
+  if (!checkClaude()) {
+    fail(`Claude CLI not found. Run: ${CY}content-grade init${R}`);
+    process.exit(1);
+  }
+
+  banner();
+  console.log(`  ${B}Batch Analysis${R}  ${D}${files.length} files in ${dirPath}${R}`);
+  blank();
+
+  const results = [];
+  for (let i = 0; i < files.length; i++) {
+    const f = files[i];
+    const rel = f.startsWith(process.cwd()) ? f.slice(process.cwd().length + 1) : f;
+    process.stdout.write(`  ${D}[${i + 1}/${files.length}]${R} ${rel}...`);
+
+    let content;
+    try { content = readFileSync(f, 'utf8'); } catch { process.stdout.write(` ${RD}unreadable${R}\n`); continue; }
+    if (content.trim().length < 20 || content.includes('\x00')) { process.stdout.write(` ${YL}skipped${R}\n`); continue; }
+
+    try {
+      const truncated = content.length > 6000 ? content.slice(0, 6000) + '\n\n[truncated]' : content;
+      const raw = await askClaude(
+        `Analyze this content:\n---\n${truncated}\n---`,
+        ANALYZE_SYSTEM,
+        'claude-haiku-4-5-20251001'
+      );
+      const r = parseJSON(raw);
+      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`);
+      results.push({ file: rel, score: sc, grade: r.grade });
+    } catch { process.stdout.write(`\r  ${RD}failed${R}  ${rel}\n`); }
+  }
+
+  blank();
+  hr();
+  console.log(`  ${B}BATCH SUMMARY${R}  ${D}${results.length}/${files.length} analyzed${R}`);
+  blank();
+
+  results.sort((a, b) => b.score - a.score);
+  for (const r of results) {
+    const scoreColor = r.score >= 70 ? GN : r.score >= 45 ? YL : RD;
+    console.log(`  ${scoreColor}${String(r.score).padStart(3)}${R}  ${gradeLetter(r.score)}  ${r.file}`);
+  }
+
+  if (results.length) {
+    const avg = Math.round(results.reduce((sum, r) => sum + r.score, 0) / results.length);
+    blank();
+    console.log(`  ${D}Average score: ${avg}/100${R}`);
+  }
+  blank();
+
+  if (_jsonMode) process.stdout.write(JSON.stringify(results, null, 2) + '\n');
+}
+
 // ── Start command ─────────────────────────────────────────────────────────────
 
 function checkBuild() {
@@ -712,28 +1017,36 @@ function cmdHelp() {
 
   console.log(`  ${B}COMMANDS${R}`);
   blank();
-  console.log(`    ${CY}demo${R}                  Run on sample content — instant result, no file needed`);
+  console.log(`    ${CY}demo${R}                    Run on sample content — instant result, no file needed`);
+  blank();
+  console.log(`    ${CY}analyze <file>${R}          Analyze content from a file`);
+  console.log(`    ${CY}grade <file>${R}            Same as analyze (alias)`);
+  console.log(`    ${CY}check <file>${R}            Same as analyze (alias)`);
+  console.log(`    ${D}                         Accepts .md, .txt, .mdx or any plain-text file${R}`);
+  console.log(`    ${D}                         Zero config — just needs Claude CLI${R}`);
+  blank();
+  console.log(`    ${CY}batch <directory>${R}       ${MG}[Pro]${R} Analyze all .md/.txt files in a directory`);
   blank();
-  console.log(`    ${CY}analyze <file>${R}        Analyze content from a file`);
-  console.log(`    ${CY}check <file>${R}          Same as analyze`);
-  console.log(`    ${D}                       Works on .md, .txt, or any text file${R}`);
-  console.log(`    ${D}                       Zero config — just needs Claude CLI${R}`);
+  console.log(`    ${CY}headline "<text>"${R}       Grade a single headline (4 copywriting frameworks)`);
   blank();
-  console.log(`    ${CY}headline "<text>"${R}     Grade a single headline`);
-  console.log(`    ${D}                       Scores on 4 copywriting frameworks${R}`);
+  console.log(`    ${CY}activate${R}                Enter license key to unlock Pro features`);
   blank();
-  console.log(`    ${CY}start${R}                 Launch the full web dashboard`);
-  console.log(`    ${D}                       6 tools: headlines, pages, ads, threads...${R}`);
+  console.log(`    ${CY}start${R}                   Launch the full web dashboard`);
+  console.log(`    ${D}                         6 tools: headlines, pages, ads, threads, emails, audiences${R}`);
   blank();
-  console.log(`    ${CY}init${R}                  First-run setup and diagnostics`);
+  console.log(`    ${CY}init${R}                    First-run setup and diagnostics`);
   blank();
-  console.log(`    ${CY}telemetry [on|off]${R}    View or toggle anonymous usage tracking`);
+  console.log(`    ${CY}telemetry [on|off]${R}      View or toggle anonymous usage tracking`);
   blank();
-  console.log(`    ${CY}help${R}                  Show this help`);
+  console.log(`    ${CY}help${R}                    Show this help`);
   blank();
   console.log(`  ${B}FLAGS${R}`);
   blank();
-  console.log(`    ${CY}--no-telemetry${R}        Skip usage tracking for this invocation`);
+  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}--verbose${R}               Show debug info: model, timing, raw response length`);
+  console.log(`    ${CY}--version${R}               Print version and exit`);
+  console.log(`    ${CY}--no-telemetry${R}          Skip usage tracking for this invocation`);
   blank();
 
   console.log(`  ${B}EXAMPLES${R}`);
@@ -741,9 +1054,21 @@ function cmdHelp() {
   console.log(`    ${D}# Analyze a blog post${R}`);
   console.log(`    ${CY}content-grade analyze ./my-post.md${R}`);
   blank();
+  console.log(`    ${D}# Grade README.md (alias)${R}`);
+  console.log(`    ${CY}content-grade grade README.md${R}`);
+  blank();
+  console.log(`    ${D}# CI pipeline — exit 1 if score < threshold${R}`);
+  console.log(`    ${CY}content-grade analyze ./blog.md --json | jq '.total_score'${R}`);
+  blank();
+  console.log(`    ${D}# Get score number only (for scripts)${R}`);
+  console.log(`    ${CY}content-grade analyze ./post.md --quiet${R}`);
+  blank();
   console.log(`    ${D}# Grade a headline${R}`);
   console.log(`    ${CY}content-grade headline "How I 10x'd My Conversion Rate in 30 Days"${R}`);
   blank();
+  console.log(`    ${D}# Batch analyze a content directory (Pro)${R}`);
+  console.log(`    ${CY}content-grade batch ./posts${R}`);
+  blank();
   console.log(`    ${D}# Launch full dashboard${R}`);
   console.log(`    ${CY}content-grade start${R}`);
   blank();
@@ -769,19 +1094,19 @@ function cmdHelp() {
 
 // ── Demo command ──────────────────────────────────────────────────────────────
 
-const DEMO_CONTENT = `# Why Your Morning Routine Is Secretly Destroying Your Productivity
+const DEMO_CONTENT = `# How to Write Better Blog Posts
 
-Productivity is important. Many people struggle with it. In this post we will discuss some tips.
+Writing good blog posts is important for any content marketer. Many people struggle with this. In this post I will share some tips that can help you improve.
 
-First, wake up early. Successful people wake up early. This gives you more time. Studies show that early risers are more productive.
+First, you need to have a good headline. The headline is the first thing people see. A good headline will make people want to read more. Try to make it interesting.
 
-Second, make a to-do list. Write everything down. Then do the tasks one by one. This is a simple but effective strategy.
+Second, write good content. Your content should be useful and informative. People should learn something from reading your post. Make sure to cover the topic well.
 
-Third, avoid distractions. Put your phone away. Social media is bad for focus. You should minimize interruptions.
+Third, use a good structure. Break your content into sections. Use headings and bullet points. This makes it easier to read. People can scan and find what they need.
 
-Fourth, take breaks. Working too hard is not good. Make sure to rest sometimes. The Pomodoro technique can help with this.
+Finally, have a good conclusion. Summarize what you talked about. Tell people what to do next. A call to action is important.
 
-In conclusion, these productivity tips are very helpful. Try them today and you will see a big difference in your output. Productivity is the key to success in today's world.
+In conclusion, following these tips will help you write better blog posts. Good content is important for success online. Start applying these tips today.
 `;
 
 async function cmdDemo() {
@@ -800,17 +1125,26 @@ async function cmdDemo() {
   const tmpFile = `/tmp/content-grade-demo-${process.pid}-${Date.now()}.md`;
 
   banner();
-  console.log(`  ${B}Demo Mode${R}  ${D}— running analysis on sample content${R}`);
-  blank();
-  console.log(`  ${D}This is what ContentGrade does. Try it on your own content:${R}`);
-  console.log(`  ${CY}  content-grade analyze ./your-post.md${R}`);
+  console.log(`  ${B}Demo Mode${R}  ${D}— see ContentGrade in action${R}`);
   blank();
-  console.log(`  ${D}Analyzing sample blog post...${R}`);
+  console.log(`  ${D}Analyzing a sample blog post with generic writing.${R}`);
+  console.log(`  ${D}Generic content scores low — that's the point. Watch what ContentGrade finds.${R}`);
   blank();
 
   writeFileSync(tmpFile, DEMO_CONTENT, 'utf8');
   try {
     await cmdAnalyze(tmpFile);
+
+    // Post-demo CTA — shown AFTER user has seen the analysis output
+    blank();
+    hr();
+    console.log(`  ${B}${CY}Now try it on your own content:${R}`);
+    blank();
+    console.log(`  ${CY}content-grade analyze ./your-post.md${R}         ${D}# any .md or .txt file${R}`);
+    console.log(`  ${CY}content-grade https://your-blog.com/post${R}      ${D}# analyze any URL${R}`);
+    console.log(`  ${CY}content-grade headline "Your headline here"${R}   ${D}# grade a headline${R}`);
+    blank();
+
     // Show telemetry notice after user has seen value (first run only)
     if (_showTelemNotice) {
       console.log(`  ${D}Anonymous usage data is collected by default. Opt out: ${CY}content-grade telemetry off${R}`);
@@ -964,10 +1298,11 @@ function findBestContentFile(dirPath) {
 
 // ── Router ────────────────────────────────────────────────────────────────────
 
-const _rawArgs   = process.argv.slice(2);
-const _jsonMode  = _rawArgs.includes('--json');
-const _quietMode = _rawArgs.includes('--quiet');
-const args = _rawArgs.filter(a => a !== '--no-telemetry' && a !== '--json' && a !== '--quiet');
+const _rawArgs    = process.argv.slice(2);
+const _jsonMode   = _rawArgs.includes('--json');
+const _quietMode  = _rawArgs.includes('--quiet');
+const _verboseMode = _rawArgs.includes('--verbose') || _rawArgs.includes('-v') && !_rawArgs.includes('--version');
+const args = _rawArgs.filter(a => !['--no-telemetry', '--json', '--quiet', '--verbose'].includes(a));
 const raw  = args[0];
 const cmd  = raw?.toLowerCase();
 
@@ -988,6 +1323,7 @@ switch (cmd) {
   case 'analyze':
   case 'analyse':
   case 'check':
+  case 'grade':
     recordEvent({ event: 'command', command: 'analyze' });
     cmdAnalyze(args[1]).catch(err => {
       blank();
@@ -1008,7 +1344,6 @@ switch (cmd) {
     break;
 
   case 'headline':
-  case 'grade':
     recordEvent({ event: 'command', command: 'headline' });
     cmdHeadline(args.slice(1).join(' ')).catch(err => {
       blank();
@@ -1035,6 +1370,27 @@ switch (cmd) {
     });
     break;
 
+  case 'activate':
+  case 'license':
+    recordEvent({ event: 'command', command: 'activate' });
+    cmdActivate().catch(err => {
+      blank();
+      fail(`Activation error: ${err.message}`);
+      blank();
+      process.exit(1);
+    });
+    break;
+
+  case 'batch':
+    recordEvent({ event: 'command', command: 'batch' });
+    cmdBatch(args[1]).catch(err => {
+      blank();
+      fail(`Batch error: ${err.message}`);
+      blank();
+      process.exit(1);
+    });
+    break;
+
   case 'help':
   case '--help':
   case '-h':

package/bin/telemetry.js

@@ -201,6 +201,40 @@ export function telemetryStatus() {
   };
 }
 
+// ── Rate limiting ─────────────────────────────────────────────────────────────
+
+const FREE_DAILY_LIMIT = 50;
+
+/**
+ * Check whether the user is within the free daily limit for a given command type.
+ * Type: 'analyze' | 'headline'
+ * Returns { ok: boolean, used: number, remaining: number, isPro: boolean }
+ */
+export function checkDailyLimit(type = 'analyze') {
+  const cfg = loadConfig();
+  if (cfg?.licenseKey) return { ok: true, used: 0, remaining: Infinity, isPro: true };
+
+  const today = new Date().toISOString().slice(0, 10);
+  const used = (cfg?.dailyUsage?.date === today ? cfg.dailyUsage[type] ?? 0 : 0);
+  const remaining = FREE_DAILY_LIMIT - used;
+  return { ok: remaining > 0, used, remaining: Math.max(0, remaining), isPro: false };
+}
+
+/**
+ * Increment the daily usage counter for a command type after a successful run.
+ * Returns the new usage count.
+ */
+export function incrementDailyUsage(type = 'analyze') {
+  const cfg = loadConfig() || {};
+  const today = new Date().toISOString().slice(0, 10);
+  if (!cfg.dailyUsage || cfg.dailyUsage.date !== today) {
+    cfg.dailyUsage = { date: today, analyze: 0, headline: 0 };
+  }
+  cfg.dailyUsage[type] = (cfg.dailyUsage[type] ?? 0) + 1;
+  saveConfig(cfg);
+  return cfg.dailyUsage[type];
+}
+
 // ── Internal ──────────────────────────────────────────────────────────────────
 
 function _write(event) {

package/package.json

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