content-grade 1.0.0

package/bin/content-grade.js

@@ -0,0 +1,1033 @@
+#!/usr/bin/env node
+/**
+ * ContentGrade CLI
+ *
+ * Commands:
+ *   analyze <file>       Analyze content from a file (zero-config, just needs Claude)
+ *   headline "<text>"    Grade a single headline
+ *   start                Launch the full web dashboard
+ *   init                 Guided first-run setup
+ *   help                 Show this help
+ *
+ * Example:
+ *   npx content-grade analyze ./my-post.md
+ */
+
+import { execFileSync, execFile, spawn } from 'child_process';
+import { existsSync, readFileSync, mkdirSync, writeFileSync, unlinkSync, statSync } from 'fs';
+import { resolve, dirname, basename, extname } from 'path';
+import { fileURLToPath } from 'url';
+import { promisify } from 'util';
+import { initTelemetry, recordEvent, disableTelemetry, enableTelemetry, telemetryStatus, isOptedOut } from './telemetry.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = resolve(__dirname, '..');
+const execFileAsync = promisify(execFile);
+
+let _version = '1.0.0';
+try { _version = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8')).version ?? '1.0.0'; } catch {}
+
+// ── ANSI colours ──────────────────────────────────────────────────────────────
+const R  = '\x1b[0m';
+const B  = '\x1b[1m';
+const D  = '\x1b[2m';
+const GN = '\x1b[32m';
+const YL = '\x1b[33m';
+const RD = '\x1b[31m';
+const CY = '\x1b[36m';
+const MG = '\x1b[35m';
+const BL = '\x1b[34m';
+const WH = '\x1b[97m';
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function ok(msg)   { console.log(`  ${GN}✓${R} ${msg}`); }
+function warn(msg) { console.log(`  ${YL}⚠${R}  ${msg}`); }
+function fail(msg) { console.log(`  ${RD}✗${R} ${msg}`); }
+function info(msg) { console.log(`  ${D}${msg}${R}`); }
+function hr()      { console.log(`  ${D}${'─'.repeat(58)}${R}`); }
+function blank()   { console.log(''); }
+
+function banner() {
+  blank();
+  console.log(`${B}${CY}  ╔═══════════════════════════════════════╗${R}`);
+  console.log(`${B}${CY}  ║   ContentGrade  ·  Content Analysis   ║${R}`);
+  console.log(`${B}${CY}  ╚═══════════════════════════════════════╝${R}`);
+  blank();
+}
+
+function scoreBar(score, width = 30) {
+  const clamped = Math.max(0, Math.min(100, score || 0));
+  const filled = Math.round((clamped / 100) * width);
+  const empty  = width - filled;
+  const color  = score >= 70 ? GN : score >= 45 ? YL : RD;
+  return `${color}${'█'.repeat(filled)}${D}${'░'.repeat(empty)}${R}`;
+}
+
+function gradeLetter(score) {
+  if (score >= 90) return `${GN}${B}A+${R}`;
+  if (score >= 85) return `${GN}${B}A${R}`;
+  if (score >= 80) return `${GN}${B}A-${R}`;
+  if (score >= 75) return `${YL}${B}B+${R}`;
+  if (score >= 70) return `${YL}${B}B${R}`;
+  if (score >= 65) return `${YL}${B}B-${R}`;
+  if (score >= 60) return `${YL}${B}C+${R}`;
+  if (score >= 55) return `${YL}${B}C${R}`;
+  if (score >= 50) return `${YL}${B}C-${R}`;
+  if (score >= 40) return `${RD}${B}D${R}`;
+  return `${RD}${B}F${R}`;
+}
+
+// ── Claude wrapper ────────────────────────────────────────────────────────────
+
+function getClaudePath() {
+  return process.env.CLAUDE_PATH || 'claude';
+}
+
+function checkClaude() {
+  try {
+    execFileSync(getClaudePath(), ['--version'], { stdio: 'pipe', timeout: 5000 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function askClaude(prompt, systemPrompt, model = 'claude-haiku-4-5-20251001') {
+  const claudePath = getClaudePath();
+  const args = ['-p', '--no-session-persistence', '--model', model];
+  if (systemPrompt) args.push('--system-prompt', systemPrompt);
+  args.push(prompt);
+
+  const { stdout } = await execFileAsync(claudePath, args, {
+    timeout: 120000,
+    maxBuffer: 10 * 1024 * 1024,
+  });
+  return stdout.trim();
+}
+
+function parseJSON(raw) {
+  try { return JSON.parse(raw); } catch {}
+  const m = raw.match(/\{[\s\S]*\}/);
+  if (m) {
+    try { return JSON.parse(m[0]); } catch {}
+  }
+  throw new Error(`Could not parse response as JSON.\n\nRaw output:\n${raw.slice(0, 400)}`);
+}
+
+// ── Content type detection ────────────────────────────────────────────────────
+
+function detectContentType(text, filename) {
+  const lower = text.toLowerCase();
+  const name  = filename.toLowerCase();
+
+  if (name.includes('email') || lower.includes('subject:') || lower.includes('unsubscribe'))
+    return 'email';
+  // Use word-boundary check to avoid "thread" or "gradient" falsely matching "ad"
+  if (/\bad\b/.test(name) || lower.includes('cta') || lower.includes('click here') || lower.includes('buy now'))
+    return 'ad';
+  if (name.includes('thread') || lower.includes('@') || /(?:^|\s)#[a-z]/m.test(lower))
+    return 'social';
+  if (lower.includes('landing') || lower.includes('hero') || lower.includes('social proof'))
+    return 'landing';
+  return 'blog';
+}
+
+// ── Analyze command ───────────────────────────────────────────────────────────
+
+const ANALYZE_SYSTEM = `You are a world-class content strategist and conversion copywriter. You analyze written content and give actionable, specific feedback.
+
+Analyze the provided content and return ONLY valid JSON (no markdown, no explanation outside JSON):
+
+{
+  "content_type": "<blog_post|landing_page|email|social_thread|ad_copy>",
+  "total_score": <0-100>,
+  "grade": "<A+|A|A-|B+|B|B-|C+|C|C-|D|F>",
+  "headline": {
+    "text": "<the headline/title you found>",
+    "score": <0-100>,
+    "feedback": "<1-2 sentences>"
+  },
+  "dimensions": {
+    "clarity": { "score": <0-100>, "label": "Clarity", "feedback": "<1 sentence>" },
+    "engagement": { "score": <0-100>, "label": "Engagement", "feedback": "<1 sentence>" },
+    "structure": { "score": <0-100>, "label": "Structure", "feedback": "<1 sentence>" },
+    "value": { "score": <0-100>, "label": "Value Delivery", "feedback": "<1 sentence>" }
+  },
+  "strengths": ["<specific strength 1>", "<specific strength 2>"],
+  "improvements": [
+    { "priority": "high", "issue": "<specific issue>", "fix": "<specific actionable fix>" },
+    { "priority": "high", "issue": "<specific issue>", "fix": "<specific actionable fix>" },
+    { "priority": "medium", "issue": "<specific issue>", "fix": "<specific actionable fix>" }
+  ],
+  "headline_rewrites": [
+    "<rewritten headline 1 — more specific, benefit-driven>",
+    "<rewritten headline 2 — different angle>"
+  ],
+  "one_line_verdict": "<single punchy sentence summarising the content's biggest opportunity>"
+}
+
+SCORING CALIBRATION:
+- Use the full 0-100 range. Generic content scores <40. Good content scores 60-79. Exceptional content scores 80+.
+- Be specific in feedback — name the exact line, word, or element you're referring to.
+- Improvements must be actionable: "Add a statistic to support claim in paragraph 2" not "Add more proof".`;
+
+async function cmdAnalyze(filePath) {
+  if (!filePath) {
+    blank();
+    fail(`No file specified.`);
+    blank();
+    console.log(`  Usage:`);
+    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}`);
+    blank();
+    console.log(`  ${D}No file? Try the demo: ${CY}content-grade demo${R}`);
+    blank();
+    process.exit(1);
+  }
+
+  const absPath = resolve(process.cwd(), filePath);
+  if (!existsSync(absPath)) {
+    blank();
+    fail(`File not found: ${absPath}`);
+    blank();
+    console.log(`  ${YL}Check the path and try again.${R}`);
+    console.log(`  ${D}Tip: use a relative path like ./my-file.md or an absolute path.${R}`);
+    blank();
+    process.exit(1);
+  }
+
+  // Guard: reject directories
+  const fileStat = statSync(absPath);
+  if (!fileStat.isFile()) {
+    blank();
+    fail(`Path is not a file: ${absPath}`);
+    blank();
+    console.log(`  ${D}Pass a text file (.md, .txt) — not a directory.${R}`);
+    blank();
+    process.exit(1);
+  }
+
+  // Guard: reject files over 500 KB before reading into memory
+  const MAX_BYTES = 500 * 1024;
+  if (fileStat.size > MAX_BYTES) {
+    blank();
+    fail(`File is too large (${Math.round(fileStat.size / 1024)} KB). Maximum is 500 KB.`);
+    blank();
+    console.log(`  ${YL}Tip:${R} Copy the relevant section into a new file and analyze that.`);
+    blank();
+    process.exit(1);
+  }
+
+  const content = readFileSync(absPath, 'utf8');
+
+  // Guard: reject binary files (null bytes indicate non-text content)
+  if (content.includes('\x00')) {
+    blank();
+    fail(`File appears to be binary (not readable text): ${basename(absPath)}`);
+    blank();
+    console.log(`  ${YL}ContentGrade analyzes written content — blog posts, emails, ad copy, landing pages.${R}`);
+    console.log(`  ${D}Supported formats: .md, .txt, .mdx, or any plain-text file.${R}`);
+    blank();
+    process.exit(1);
+  }
+
+  if (content.trim().length < 20) {
+    blank();
+    fail(`File is too short to analyze (${content.trim().length} chars). Add some content and try again.`);
+    blank();
+    process.exit(1);
+  }
+
+  banner();
+  console.log(`  ${B}Analyzing:${R} ${CY}${basename(absPath)}${R}`);
+  console.log(`  ${D}${content.length.toLocaleString()} characters · detecting content type...${R}`);
+  blank();
+
+  // Check Claude
+  if (!checkClaude()) {
+    fail(`Claude CLI not found.`);
+    blank();
+    console.log(`  ContentGrade uses your local Claude CLI — no API keys needed.`);
+    blank();
+    console.log(`  ${B}To install Claude CLI:${R}`);
+    console.log(`    1. Visit ${CY}https://claude.ai/code${R}`);
+    console.log(`    2. Install and run: ${CY}claude login${R}`);
+    console.log(`    3. Verify: ${CY}claude -p "say hello"${R}`);
+    blank();
+    console.log(`  ${D}If Claude is installed but not on PATH, set:${R}`);
+    console.log(`  ${D}  export CLAUDE_PATH=/path/to/claude${R}`);
+    blank();
+    process.exit(1);
+  }
+
+  const filename    = basename(absPath, extname(absPath));
+  const hintedType  = detectContentType(content, filename);
+  const typeHint    = `This appears to be a ${hintedType.replace('_', ' ')}. Analyze accordingly.`;
+
+  const truncated = content.length > 6000 ? content.slice(0, 6000) + '\n\n[Content truncated for analysis]' : content;
+
+  process.stdout.write(`  ${D}Running analysis (this takes ~15 seconds)...${R}`);
+
+  let result;
+  try {
+    const raw = await askClaude(
+      `${typeHint}\n\nContent to analyze:\n---\n${truncated}\n---`,
+      ANALYZE_SYSTEM,
+      'claude-sonnet-4-6'
+    );
+    process.stdout.write(`\r  ${GN}✓${R} Analysis complete${' '.repeat(30)}\n`);
+    result = parseJSON(raw);
+    recordEvent({ event: 'analyze_result', score: result.total_score, content_type: result.content_type });
+  } catch (err) {
+    process.stdout.write(`\n`);
+    blank();
+    const isTimeout = err.killed || /timeout|ETIMEDOUT|timed out/i.test(err.message);
+    if (isTimeout) {
+      fail(`Analysis timed out (Claude took too long to respond).`);
+      blank();
+      console.log(`  ${YL}Try:${R}`);
+      console.log(`  ${D}· Wait a moment and retry — Claude may be under load${R}`);
+      console.log(`  ${D}· Verify Claude is working: ${CY}claude -p "say hi"${R}`);
+    } else {
+      fail(`Analysis failed: ${err.message}`);
+      blank();
+      console.log(`  ${YL}Possible causes:${R}`);
+      console.log(`  ${D}· Claude CLI rate limit — wait a moment and retry${R}`);
+      console.log(`  ${D}· Network or auth issue — run: ${CY}claude -p "say hi"${R}`);
+    }
+    blank();
+    process.exit(1);
+  }
+
+  blank();
+  hr();
+  // ── Score header
+  const scoreColor = result.total_score >= 70 ? GN : result.total_score >= 45 ? YL : RD;
+  console.log(`  ${B}OVERALL SCORE${R}   ${scoreColor}${B}${result.total_score}/100${R}  ${gradeLetter(result.total_score)}   ${D}${result.content_type?.replace('_', ' ') ?? 'content'}${R}`);
+  console.log(`  ${scoreBar(result.total_score, 40)}`);
+  blank();
+
+  // ── Headline
+  if (result.headline?.text) {
+    console.log(`  ${B}HEADLINE SCORE${R}   ${scoreBar(result.headline.score, 20)} ${result.headline.score}/100`);
+    console.log(`  ${D}"${result.headline.text}"${R}`);
+    console.log(`  ${D}↳ ${result.headline.feedback}${R}`);
+    blank();
+  }
+
+  // ── Dimension breakdown
+  hr();
+  console.log(`  ${B}DIMENSION BREAKDOWN${R}`);
+  blank();
+  for (const [, dim] of Object.entries(result.dimensions ?? {})) {
+    const bar = scoreBar(dim.score, 20);
+    console.log(`  ${WH}${(dim.label ?? '').padEnd(16)}${R} ${bar} ${dim.score}/100`);
+    console.log(`  ${D}  ↳ ${dim.feedback}${R}`);
+    blank();
+  }
+
+  // ── Verdict
+  if (result.one_line_verdict) {
+    hr();
+    console.log(`  ${B}VERDICT${R}`);
+    console.log(`  ${YL}${result.one_line_verdict}${R}`);
+    blank();
+  }
+
+  // ── Strengths
+  if (result.strengths?.length) {
+    hr();
+    console.log(`  ${B}STRENGTHS${R}`);
+    for (const s of result.strengths) {
+      console.log(`  ${GN}+${R} ${s}`);
+    }
+    blank();
+  }
+
+  // ── Improvements
+  if (result.improvements?.length) {
+    hr();
+    console.log(`  ${B}TOP IMPROVEMENTS${R}`);
+    blank();
+    for (const imp of result.improvements) {
+      const icon = imp.priority === 'high' ? `${RD}●${R}` : `${YL}●${R}`;
+      console.log(`  ${icon} ${B}${imp.issue}${R}`);
+      console.log(`    ${CY}Fix:${R} ${imp.fix}`);
+      blank();
+    }
+  }
+
+  // ── Headline rewrites
+  if (result.headline_rewrites?.length) {
+    hr();
+    console.log(`  ${B}HEADLINE REWRITES${R}`);
+    blank();
+    for (let i = 0; i < result.headline_rewrites.length; i++) {
+      console.log(`  ${D}${i + 1}.${R} ${result.headline_rewrites[i]}`);
+    }
+    blank();
+  }
+
+  // ── Pro teaser
+  hr();
+  console.log(`  ${D}Free analysis complete. ${MG}Pro unlocks:${R}`);
+  console.log(`  ${D}  · Competitor headline comparison${R}`);
+  console.log(`  ${D}  · Landing page URL audit (full CRO analysis)${R}`);
+  console.log(`  ${D}  · Ad copy scoring (Google, Meta, LinkedIn)${R}`);
+  console.log(`  ${D}  · Twitter thread grader with shareability score${R}`);
+  console.log(`  ${D}  · Email subject line optimizer${R}`);
+  console.log(`  ${D}  · 100 analyses/day vs 3 free${R}`);
+  blank();
+  console.log(`  ${D}Start the web dashboard:  ${CY}content-grade start${R}`);
+  console.log(`  ${D}Grade a headline:         ${CY}content-grade headline "Your text here"${R}`);
+  blank();
+}
+
+// ── Headline command ──────────────────────────────────────────────────────────
+
+const HEADLINE_SYSTEM = `You are a direct response copywriting expert. Grade the provided headline.
+
+Return ONLY valid JSON:
+{
+  "score": <0-100>,
+  "grade": "<letter>",
+  "verdict": "<1 punchy sentence>",
+  "scores": {
+    "rule_of_one": { "score": <0-30>, "max": 30, "note": "<1 sentence>" },
+    "value_equation": { "score": <0-30>, "max": 30, "note": "<1 sentence>" },
+    "readability": { "score": <0-20>, "max": 20, "note": "<1 sentence>" },
+    "proof_promise": { "score": <0-20>, "max": 20, "note": "<1 sentence>" }
+  },
+  "rewrites": [
+    "<stronger version 1>",
+    "<stronger version 2>"
+  ]
+}
+
+Use full range: generic = <35, good = 65-79, great = 80+.`;
+
+async function cmdHeadline(text) {
+  if (!text || text.trim().length < 3) {
+    blank();
+    fail(`No headline provided.`);
+    blank();
+    console.log(`  Usage:`);
+    console.log(`    ${CY}content-grade headline "Your headline text"${R}`);
+    blank();
+    console.log(`  Examples:`);
+    console.log(`    ${D}content-grade headline "The 5-Minute Fix That Doubles Landing Page Conversions"${R}`);
+    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(1);
+  }
+
+  banner();
+  console.log(`  ${B}Grading headline:${R}`);
+  console.log(`  ${D}"${text}"${R}`);
+  blank();
+
+  if (!checkClaude()) {
+    fail(`Claude CLI not found. Run: ${CY}content-grade init${R}`);
+    process.exit(1);
+  }
+
+  process.stdout.write(`  ${D}Analyzing...${R}`);
+
+  let result;
+  try {
+    const raw = await askClaude(`Grade this headline: "${text}"`, HEADLINE_SYSTEM, 'claude-haiku-4-5-20251001');
+    process.stdout.write(`\r  ${GN}✓${R} Done${' '.repeat(20)}\n`);
+    result = parseJSON(raw);
+    recordEvent({ event: 'headline_result', score: result.score });
+  } catch (err) {
+    process.stdout.write(`\n`);
+    blank();
+    const isTimeout = err.killed || /timeout|ETIMEDOUT|timed out/i.test(err.message);
+    if (isTimeout) {
+      fail(`Grading timed out (Claude took too long to respond).`);
+      blank();
+      console.log(`  ${YL}Try:${R}`);
+      console.log(`  ${D}· Wait a moment and retry — Claude may be under load${R}`);
+      console.log(`  ${D}· Verify Claude is working: ${CY}claude -p "say hi"${R}`);
+    } else {
+      fail(`Grading failed: ${err.message}`);
+      blank();
+      console.log(`  ${YL}Possible causes:${R}`);
+      console.log(`  ${D}· Claude CLI rate limit — wait a moment and retry${R}`);
+      console.log(`  ${D}· Network or auth issue — run: ${CY}claude -p "say hi"${R}`);
+    }
+    blank();
+    process.exit(1);
+  }
+
+  blank();
+  hr();
+  const sc = result.score ?? 0;
+  const scoreColor = sc >= 70 ? GN : sc >= 45 ? YL : RD;
+  console.log(`  ${B}SCORE${R}   ${scoreColor}${B}${sc}/100${R}  ${gradeLetter(sc)}`);
+  console.log(`  ${scoreBar(sc, 40)}`);
+  blank();
+  console.log(`  ${YL}${result.verdict}${R}`);
+  blank();
+
+  hr();
+  console.log(`  ${B}FRAMEWORK BREAKDOWN${R}`);
+  blank();
+  const dims = result.scores ?? {};
+  for (const [key, dim] of Object.entries(dims)) {
+    const label = key.replace(/_/g, ' ').replace(/\b\w/g, c => c.toUpperCase()).padEnd(18);
+    const pct   = dim.max > 0 ? Math.round((dim.score / dim.max) * 100) : 0;
+    console.log(`  ${WH}${label}${R} ${scoreBar(pct, 16)} ${dim.score}/${dim.max}`);
+    console.log(`  ${D}  ↳ ${dim.note}${R}`);
+    blank();
+  }
+
+  if (result.rewrites?.length) {
+    hr();
+    console.log(`  ${B}STRONGER VERSIONS${R}`);
+    blank();
+    for (let i = 0; i < result.rewrites.length; i++) {
+      console.log(`  ${D}${i + 1}.${R} ${result.rewrites[i]}`);
+    }
+    blank();
+  }
+
+  hr();
+  console.log(`  ${D}Compare two headlines:  ${CY}content-grade start${R}  → HeadlineGrader compare${R}`);
+  blank();
+}
+
+// ── Init command ──────────────────────────────────────────────────────────────
+
+async function cmdInit() {
+  banner();
+  console.log(`  ${B}Welcome to ContentGrade${R}`);
+  console.log(`  ${D}Let's get you set up in 60 seconds.${R}`);
+  blank();
+
+  // Step 1: Claude
+  console.log(`  ${B}Step 1/3:${R} Check Claude CLI`);
+  const claudeOk = checkClaude();
+  if (claudeOk) {
+    ok('Claude CLI found');
+  } else {
+    warn('Claude CLI not found');
+    blank();
+    console.log(`  ContentGrade uses your local Claude CLI (no API keys, your data stays local).`);
+    blank();
+    console.log(`  ${B}Install Claude CLI:${R}`);
+    console.log(`    1. Go to ${CY}https://claude.ai/code${R}`);
+    console.log(`    2. Download and install`);
+    console.log(`    3. Run: ${CY}claude login${R}`);
+    console.log(`    4. Verify: ${CY}claude -p "say hello"${R}`);
+    blank();
+    console.log(`  Then re-run: ${CY}npx content-grade init${R}`);
+    blank();
+    process.exit(0);
+  }
+
+  // Step 2: Quick smoke test
+  console.log(`  ${B}Step 2/3:${R} Quick smoke test`);
+  process.stdout.write(`  ${D}Testing claude -p...${R}`);
+  try {
+    const out = await askClaude('Respond with exactly: {"ok":true}', null, 'claude-haiku-4-5-20251001');
+    const j   = parseJSON(out);
+    if (j.ok) {
+      process.stdout.write(`\r  ${GN}✓${R} Claude is working${' '.repeat(20)}\n`);
+    } else {
+      throw new Error('unexpected response');
+    }
+  } catch {
+    process.stdout.write(`\n`);
+    warn('Claude responded but with unexpected output — may still work');
+  }
+
+  // Step 3: Dashboard build
+  console.log(`  ${B}Step 3/3:${R} Web dashboard`);
+  const distOk = existsSync(resolve(root, 'dist')) && existsSync(resolve(root, 'dist-server'));
+  if (distOk) {
+    ok('Production build found');
+  } else {
+    warn('No production build — web dashboard requires a build');
+    blank();
+    console.log(`  ${D}  The web dashboard is not available in this installation.${R}`);
+    console.log(`  ${D}  To build from source: ${CY}cd ${root} && npm run build${R}`);
+    blank();
+    console.log(`  ${D}  CLI commands (analyze, headline, demo) work without the build.${R}`);
+  }
+
+  blank();
+  hr();
+  console.log(`  ${B}${GN}You're ready!${R}`);
+  blank();
+  console.log(`  ${B}Try it now:${R}`);
+  blank();
+  console.log(`  ${CY}echo "# Why Most Startups Fail\\n\\nMost startups fail because..." > /tmp/test.md${R}`);
+  console.log(`  ${CY}content-grade analyze /tmp/test.md${R}`);
+  blank();
+  console.log(`  ${B}Or grade a headline:${R}`);
+  console.log(`  ${CY}content-grade headline "The 5-Minute Fix That Doubles Landing Page Conversions"${R}`);
+  blank();
+  if (distOk) {
+    console.log(`  ${B}Or launch the web dashboard:${R}`);
+    console.log(`  ${CY}content-grade start${R}`);
+    blank();
+  }
+  console.log(`  ${D}Pro tier ($9/mo): 100 analyses/day + competitor comparison + URL audits${R}`);
+  blank();
+}
+
+// ── Start command ─────────────────────────────────────────────────────────────
+
+function checkBuild() {
+  return existsSync(resolve(root, 'dist-server')) && existsSync(resolve(root, 'dist'));
+}
+
+function openBrowser(url) {
+  const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+  try { execFileSync(cmd, [url], { stdio: 'ignore' }); } catch {}
+}
+
+function cmdStart() {
+  banner();
+  console.log(`  ${B}Pre-flight checks${R}`);
+
+  const claudeOk = checkClaude();
+  if (claudeOk) {
+    ok(`Claude CLI found`);
+  } else {
+    fail(`Claude CLI not found`);
+    blank();
+    console.log(`  ${YL}Fix:${R} Install Claude CLI from ${CY}https://claude.ai/code${R} then run ${CY}claude login${R}`);
+    blank();
+    process.exit(1);
+  }
+
+  const buildOk = checkBuild();
+  if (buildOk) {
+    ok('Production build found');
+  } else {
+    warn('No production build found — web dashboard is unavailable');
+    blank();
+    console.log(`  ${YL}The web dashboard requires a production build.${R}`);
+    console.log(`  ${D}If you installed via npx or npm install, try reinstalling the package.${R}`);
+    console.log(`  ${D}If you cloned the repo, run:${R}`);
+    console.log(`    ${CY}cd ${root} && npm run build${R}`);
+    blank();
+    console.log(`  ${D}The CLI commands work without the dashboard:${R}`);
+    console.log(`    ${CY}content-grade analyze <file>${R}    ${D}# analyze a file${R}`);
+    console.log(`    ${CY}content-grade headline "<text>"${R}  ${D}# grade a headline${R}`);
+    console.log(`    ${CY}content-grade demo${R}              ${D}# instant demo${R}`);
+    blank();
+    process.exit(1);
+  }
+
+  const PORT = parseInt(process.env.PORT || '4000', 10);
+  const serverEntry = resolve(root, 'dist-server/server/index.js');
+
+  blank();
+  console.log(`  ${B}Starting server${R}`);
+
+  const server = spawn('node', [serverEntry], {
+    env: { ...process.env },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    cwd: root,
+  });
+
+  let started = false;
+
+  server.stdout.on('data', (data) => {
+    const text = data.toString();
+    if (text.includes('running on') && !started) {
+      started = true;
+      const url = `http://localhost:${PORT}`;
+      ok(`Server running at ${CY}${url}${R}`);
+      blank();
+      console.log(`  ${D}Tools:${R}`);
+      info(`  HeadlineGrader  — ${url}/headline`);
+      info(`  PageRoast       — ${url}/page-roast`);
+      info(`  AdScorer        — ${url}/ad-scorer`);
+      info(`  ThreadGrader    — ${url}/thread`);
+      info(`  EmailForge      — ${url}/email-forge`);
+      info(`  AudienceDecoder — ${url}/audience`);
+      blank();
+      info(`Free tier: 3 analyses/day. Upgrade at ${url}`);
+      info(`Press Ctrl+C to stop`);
+      blank();
+      openBrowser(url);
+    }
+  });
+
+  server.stderr.on('data', (data) => {
+    const text = data.toString().trim();
+    if (!text) return;
+
+    // Better-sqlite3 native binding error — common after fresh install
+    if (text.includes('better-sqlite3') || text.includes('bindings.js')) {
+      blank();
+      fail(`Database error: native SQLite bindings not compiled for this Node version.`);
+      blank();
+      console.log(`  ${YL}Fix (run in ${root}):${R}`);
+      console.log(`    ${CY}npm rebuild better-sqlite3${R}`);
+      blank();
+      console.log(`  Then retry: ${CY}content-grade start${R}`);
+    } else {
+      console.error(`  ${RD}Server error:${R} ${text}`);
+    }
+  });
+
+  server.on('exit', (code) => {
+    if (code !== 0 && code !== null) {
+      blank();
+      fail(`Server exited with code ${code}`);
+      blank();
+      console.log(`  ${D}Check the error above, or run:${R}`);
+      console.log(`    ${CY}content-grade init${R}  — diagnose setup`);
+      blank();
+    }
+  });
+
+  process.on('SIGINT', () => {
+    blank();
+    info('Shutting down...');
+    server.kill();
+    process.exit(0);
+  });
+}
+
+// ── Help ──────────────────────────────────────────────────────────────────────
+
+function cmdHelp() {
+  banner();
+  console.log(`  ${D}v${_version}  ·  ${CY}https://github.com/StanislavBG/Content-Grade${R}`);
+  blank();
+  console.log(`  ${B}USAGE${R}`);
+  blank();
+  console.log(`    ${CY}content-grade <command> [args]${R}`);
+  blank();
+
+  console.log(`  ${B}COMMANDS${R}`);
+  blank();
+  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}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}`);
+  blank();
+  console.log(`    ${CY}headline "<text>"${R}     Grade a single headline`);
+  console.log(`    ${D}                       Scores on 4 copywriting frameworks${R}`);
+  blank();
+  console.log(`    ${CY}start${R}                 Launch the full web dashboard`);
+  console.log(`    ${D}                       6 tools: headlines, pages, ads, threads...${R}`);
+  blank();
+  console.log(`    ${CY}init${R}                  First-run setup and diagnostics`);
+  blank();
+  console.log(`    ${CY}telemetry [on|off]${R}    View or toggle anonymous usage tracking`);
+  blank();
+  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`);
+  blank();
+
+  console.log(`  ${B}EXAMPLES${R}`);
+  blank();
+  console.log(`    ${D}# Analyze a blog post${R}`);
+  console.log(`    ${CY}content-grade analyze ./my-post.md${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}# Launch full dashboard${R}`);
+  console.log(`    ${CY}content-grade start${R}`);
+  blank();
+
+  console.log(`  ${B}REQUIREMENTS${R}`);
+  blank();
+  console.log(`    · Claude CLI   ${CY}https://claude.ai/code${R}`);
+  console.log(`    · Node.js 18+`);
+  blank();
+
+  console.log(`  ${B}PRO TIER${R}  ${MG}$9/month${R}`);
+  blank();
+  console.log(`    · 100 analyses/day (vs 3 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`);
+  blank();
+  console.log(`    ${CY}content-grade start${R}  then click Upgrade`);
+  blank();
+}
+
+// ── Demo command ──────────────────────────────────────────────────────────────
+
+const DEMO_CONTENT = `# Why Your Morning Routine Is Secretly Destroying Your Productivity
+
+Productivity is important. Many people struggle with it. In this post we will discuss some tips.
+
+First, wake up early. Successful people wake up early. This gives you more time. Studies show that early risers are more productive.
+
+Second, make a to-do list. Write everything down. Then do the tasks one by one. This is a simple but effective strategy.
+
+Third, avoid distractions. Put your phone away. Social media is bad for focus. You should minimize interruptions.
+
+Fourth, take breaks. Working too hard is not good. Make sure to rest sometimes. The Pomodoro technique can help with this.
+
+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.
+`;
+
+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}`);
+  blank();
+  console.log(`  ${D}Analyzing sample blog post...${R}`);
+  blank();
+
+  writeFileSync(tmpFile, DEMO_CONTENT, 'utf8');
+  try {
+    await cmdAnalyze(tmpFile);
+  } finally {
+    try { unlinkSync(tmpFile); } catch {}
+  }
+}
+
+// ── Directory scanner ─────────────────────────────────────────────────────────
+
+import { readdirSync } from 'fs';
+
+function findBestContentFile(dirPath) {
+  const abs = resolve(process.cwd(), dirPath);
+  if (!existsSync(abs)) return null;
+
+  const st = statSync(abs);
+  if (st.isFile()) return abs;
+  if (!st.isDirectory()) return null;
+
+  const candidates = [];
+  function scan(dir, depth) {
+    if (depth > 2) return;
+    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()) {
+        scan(full, depth + 1);
+      } else if (/\.(md|txt|mdx)$/i.test(entry)) {
+        candidates.push({ path: full, size: s.size, name: entry });
+      }
+    }
+  }
+  scan(abs, 0);
+
+  if (!candidates.length) return null;
+
+  // Prefer content files over READMEs; bigger = more content
+  const scored = candidates.map(f => {
+    let score = f.size;
+    const n = f.name.toLowerCase();
+    if (n === 'readme.md' || n === 'readme.txt') score -= 5000;
+    if (/post|article|blog|draft|copy|content/i.test(n)) score += 10000;
+    return { ...f, score };
+  });
+  scored.sort((a, b) => b.score - a.score);
+  return scored[0].path;
+}
+
+// ── Router ────────────────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2).filter(a => a !== '--no-telemetry');
+const raw  = args[0];
+const cmd  = raw?.toLowerCase();
+
+// ── Telemetry init ────────────────────────────────────────────────────────────
+const _telem = initTelemetry();
+if (_telem.isNew) {
+  // Show notice once, on first run
+  blank();
+  console.log(`  ${D}ContentGrade collects anonymous usage data (command name, score, duration).${R}`);
+  console.log(`  ${D}No file contents, no PII. To opt out: ${CY}content-grade telemetry off${R}${D} or pass ${CY}--no-telemetry${R}`);
+  blank();
+}
+
+// Smart path detection: first arg is a path if it starts with ., /, ~ or is an existing FS entry
+function looksLikePath(s) {
+  if (!s) return false;
+  if (s.startsWith('.') || s.startsWith('/') || s.startsWith('~')) return true;
+  if (/\.(md|txt|mdx)$/i.test(s)) return true;
+  try { statSync(resolve(process.cwd(), s)); return true; } catch { return false; }
+}
+
+switch (cmd) {
+  case 'analyze':
+  case 'analyse':
+  case 'check':
+    recordEvent({ event: 'command', command: 'analyze' });
+    cmdAnalyze(args[1]).catch(err => {
+      blank();
+      fail(`Unexpected error: ${err.message}`);
+      blank();
+      process.exit(1);
+    });
+    break;
+
+  case 'demo':
+    recordEvent({ event: 'command', command: 'demo' });
+    cmdDemo().catch(err => {
+      blank();
+      fail(`Demo error: ${err.message}`);
+      blank();
+      process.exit(1);
+    });
+    break;
+
+  case 'headline':
+  case 'grade':
+    recordEvent({ event: 'command', command: 'headline' });
+    cmdHeadline(args.slice(1).join(' ')).catch(err => {
+      blank();
+      fail(`Unexpected error: ${err.message}`);
+      blank();
+      process.exit(1);
+    });
+    break;
+
+  case 'start':
+  case 'serve':
+    recordEvent({ event: 'command', command: 'start' });
+    cmdStart();
+    break;
+
+  case 'init':
+  case 'setup':
+    recordEvent({ event: 'command', command: 'init' });
+    cmdInit().catch(err => {
+      blank();
+      fail(`Setup error: ${err.message}`);
+      blank();
+      process.exit(1);
+    });
+    break;
+
+  case 'help':
+  case '--help':
+  case '-h':
+    cmdHelp();
+    break;
+
+  case 'version':
+  case '--version':
+  case '-v':
+  case '-V':
+    console.log(`content-grade v${_version}`);
+    break;
+
+  case 'telemetry': {
+    const sub = args[1];
+    if (sub === 'off') {
+      disableTelemetry();
+      blank();
+      console.log(`  ${GN}✓${R} Telemetry disabled. No usage data will be collected.`);
+      console.log(`  ${D}Re-enable: ${CY}content-grade telemetry on${R}`);
+      blank();
+    } else if (sub === 'on') {
+      enableTelemetry();
+      blank();
+      console.log(`  ${GN}✓${R} Telemetry enabled. Anonymous usage data will be collected.`);
+      console.log(`  ${D}Opt out at any time: ${CY}content-grade telemetry off${R}`);
+      blank();
+    } else {
+      const s = telemetryStatus();
+      blank();
+      console.log(`  ${B}Telemetry status${R}`);
+      blank();
+      console.log(`  ${D}Enabled:     ${R}${s.enabled ? `${GN}yes${R}` : `${RD}no${R}`}`);
+      console.log(`  ${D}Install ID:  ${R}${s.installId ?? '(none)'}`);
+      console.log(`  ${D}Local log:   ${R}${s.eventsFile}`);
+      console.log(`  ${D}Remote URL:  ${R}${s.remoteUrl}`);
+      blank();
+      console.log(`  ${D}Commands:${R}`);
+      console.log(`    ${CY}content-grade telemetry off${R}   ${D}disable telemetry${R}`);
+      console.log(`    ${CY}content-grade telemetry on${R}    ${D}re-enable telemetry${R}`);
+      console.log(`  ${D}Or pass ${CY}--no-telemetry${R}${D} to any command for a one-time opt-out.${R}`);
+      blank();
+    }
+    break;
+  }
+
+  case undefined:
+    // No command — run demo immediately for instant value
+    recordEvent({ event: 'command', command: 'demo' });
+    cmdDemo().catch(err => {
+      blank();
+      fail(`Demo error: ${err.message}`);
+      blank();
+      process.exit(1);
+    });
+    break;
+
+  default:
+    if (looksLikePath(raw)) {
+      // Directory: find best content file inside it
+      let target;
+      try {
+        const st = statSync(resolve(process.cwd(), raw));
+        if (st.isDirectory()) {
+          target = findBestContentFile(raw);
+          if (!target) {
+            blank();
+            fail(`No content files found in: ${raw}`);
+            blank();
+            console.log(`  ${YL}ContentGrade looks for .md, .txt, and .mdx files.${R}`);
+            console.log(`  ${D}Create a markdown file there, or try:${R}`);
+            blank();
+            console.log(`  ${CY}content-grade demo${R}  — instant demo on built-in sample`);
+            blank();
+            process.exit(1);
+          }
+          const rel = target.startsWith(process.cwd()) ? target.slice(process.cwd().length + 1) : target;
+          blank();
+          console.log(`  ${D}Found: ${CY}${rel}${R}`);
+        } else {
+          target = raw;
+        }
+      } catch {
+        target = raw; // let cmdAnalyze handle the "not found" error
+      }
+      recordEvent({ event: 'command', command: 'analyze' });
+      cmdAnalyze(target).catch(err => {
+        blank();
+        fail(`Unexpected error: ${err.message}`);
+        blank();
+        process.exit(1);
+      });
+    } else {
+      blank();
+      fail(`Unknown command: ${B}${raw}${R}`);
+      blank();
+      console.log(`  Available commands:`);
+      console.log(`    ${CY}analyze <file>${R}   ${CY}headline "<text>"${R}   ${CY}demo${R}   ${CY}start${R}   ${CY}init${R}   ${CY}help${R}`);
+      blank();
+      console.log(`  ${D}Pass a file/directory directly: ${CY}content-grade ./my-post.md${R}`);
+      console.log(`  ${D}Run ${CY}content-grade help${R}${D} for full usage${R}`);
+      blank();
+      process.exit(1);
+    }
+}