content-grade 1.0.34 → 1.0.36

package/README.md

@@ -30,7 +30,7 @@ npx content-grade headline "Why Most Startups Fail at Month 18"
 
 **One requirement:** [Claude CLI](https://claude.ai/code) must be installed and logged in (`claude login`). No API keys, no accounts, your content never leaves your machine.
 
-**Free tier:** 50 analyses/day. No signup. `npx content-grade grade README.md` works immediately.
+**Free tier:** 3 analyses/day. No signup. `npx content-grade grade README.md` works immediately.
 
 **Install globally** (recommended — skips the `npx` download on every run):
 
@@ -49,6 +49,49 @@ content-grade activate                     # unlock Pro: batch mode, 100/day
 
 ---
 
+## Upgrade to Pro
+
+**The free tier is real.** 3 analyses/day lets you evaluate ContentGrade properly.
+
+Most developers hit the limit when they start trusting it enough to use it on every file — before publishing a post, on every PR, iterating until the score crosses 70. That's when Pro pays for itself.
+
+| | Free | Pro |
+|---|---|---|
+| Analyses/day | 3 | Unlimited |
+| All 6 CLI commands | ✓ | ✓ |
+| Web dashboard (6 tools) | ✓ | ✓ |
+| Batch mode (`batch <dir>`) | — | ✓ |
+| CI integration (`--json` exit codes) | ✓ | ✓ |
+| **Price** | **$0** | **$9/mo** |
+
+**[Upgrade to Pro → $9/mo](https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a)**
+
+**What Pro unlocks in practice:**
+
+```bash
+# Score your entire blog before the next publish run
+content-grade batch ./posts/
+
+# Gate low-quality content in CI (exits 1 if score < 50)
+content-grade analyze ./draft.md --quiet
+
+# Iterate on a piece without hitting the wall
+content-grade grade ./post.md   # run 10x, no limit
+```
+
+**After payment:**
+1. License key delivered to your email within 60 seconds
+2. Run `content-grade activate` and paste the key when prompted
+3. Limit lifts immediately — no restart, no reinstall
+
+```bash
+content-grade activate
+# Enter your license key when prompted
+# ✓ Pro activated — unlimited analyses unlocked
+```
+
+---
+
 ## Usage Examples
 
 **Grade a single file:**
@@ -172,20 +215,24 @@ Launch with `content-grade start` — opens at [http://localhost:4000](http://lo
 | **EmailForge** | `/email-forge` | Subject line + body copy for click-through optimization |
 | **AudienceDecoder** | `/audience` | Twitter handle → audience archetypes and content patterns |
 
-Free tier: **50 analyses/day per tool**. Pro ($19/mo): **100 analyses/day** + all tools.
+Free tier: **3 analyses/day**. [Pro ($9/mo)](https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a): **unlimited analyses** + batch mode.
 
 ---
 
-## Join the Discussion
+## Community
+
+**[COMMUNITY.md](COMMUNITY.md)** — how to report bugs, request features, join the Early Adopter program, and share your work.
+
+| Channel | Best for |
+|---------|----------|
+| [Q&A](https://github.com/StanislavBG/Content-Grade/discussions/new?category=q-a) | Questions, troubleshooting, "why is my score X?" |
+| [Show & Tell](https://github.com/StanislavBG/Content-Grade/discussions/new?category=show-and-tell) | Workflows, CI integrations, results — claim Early Adopter here |
+| [Ideas](https://github.com/StanislavBG/Content-Grade/discussions/new?category=ideas) | Feature requests before they become issues |
+| [Bug reports](https://github.com/StanislavBG/Content-Grade/issues/new?template=bug_report.yml) | Something broken? File it here |
 
-**[GitHub Discussions](https://github.com/Content-Grade/Content-Grade/discussions)** — ask questions, share setups, vote on what gets built next.
+**[All discussions →](https://github.com/StanislavBG/Content-Grade/discussions)**
 
-Active threads:
-- [What content quality checks matter most to you?](https://github.com/Content-Grade/Content-Grade/discussions/1) — General
-- [Show your ContentGrade setup — configs, workflows, CI integrations](https://github.com/Content-Grade/Content-Grade/discussions/2) — Show & Tell
-- [Feature requests & roadmap input](https://github.com/Content-Grade/Content-Grade/discussions/3) — Ideas
-- [Content scoring in CI — who is actually doing this?](https://github.com/Content-Grade/Content-Grade/discussions/4) — General
-- [What integrations would make ContentGrade essential to your workflow?](https://github.com/Content-Grade/Content-Grade/discussions/5) — Ideas
+**Early Adopter program:** 50 seats, 0 claimed. Install ContentGrade, post in Show & Tell with `[Early Adopter]`, get 12 months Pro free. Details: [EARLY_ADOPTERS.md](EARLY_ADOPTERS.md)
 
 ---
 
@@ -265,15 +312,16 @@ content-grade analyze ./post.md --verbose
 
 ### Daily limit reached
 
-Free tier: 50 CLI analyses/day, resets at midnight UTC.
+Free tier: 3 analyses/day, resets at midnight UTC.
 
 ```
-✗ Daily limit reached (50/50 free checks used today).
+✗ Daily limit reached (3/3 free checks used today).
+  Upgrade to Pro for unlimited analyses: https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a
 ```
 
 Options:
 - Wait until midnight UTC for the limit to reset
-- Unlock 100/day with Pro: `content-grade activate`
+- Upgrade to Pro for unlimited analyses: `content-grade activate`
 
 ---
 

package/bin/content-grade.js

@@ -119,9 +119,9 @@ const TIER_LIMITS = {
 
 function getUpgradeMessage() {
   const tier = getLicenseTier();
-  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}`;
+  if (tier === 'free')     return `No daily cap with Pro — unlimited analyses at $9/mo → ${UPGRADE_LINKS.free}`;
+  if (tier === 'pro')      return `Upgrade to Business — 100 analyses/day, priority support, $29/mo → ${UPGRADE_LINKS.pro}`;
+  if (tier === 'business') return `Upgrade to Team — 500 analyses/day, team seats, $79/mo → ${UPGRADE_LINKS.business}`;
   return '';
 }
 
@@ -131,29 +131,38 @@ function showFreeTierCTA(count) {
   const limit = TIER_LIMITS.free; // 5
   const remaining = Math.max(0, limit - count);
 
+  // Track that an upgrade prompt was shown after a run (post-run CTA, not a hard block)
+  const ctaStrength = remaining === 0 ? 'strong' : remaining === 1 ? 'warning' : 'nudge';
+  recordEvent({ event: 'upgrade_prompt_shown', run_count: count, cta_strength: ctaStrength, cta_context: 'post_run' });
+
   blank();
   hr();
 
   if (remaining === 0) {
-    // Last free run — strong CTA, no escape hatch
-    console.log(`  ${RD}${B}${count}/${limit} free analyses used — limit reached.${R}`);
+    // Limit reached — benefit-first wall + explicit post-purchase path
+    console.log(`  ${RD}${B}That's your ${limit} free analyses for today.${R}`);
     blank();
-    console.log(`  ${WH}Pro removes the cap. Analyze your entire content backlog,${R}`);
-    console.log(`  ${WH}run it in CI on every draft, batch-score a whole directory.${R}`);
+    console.log(`  ${WH}${B}Pro removes the cap — grade everything, every day.${R}`);
+    console.log(`  ${D}  Unlimited analyses · batch entire /posts/ dirs · CI exit codes · JSON/HTML output${R}`);
+    console.log(`  ${D}  Joined by 1,200+ developers who grade every post before they hit publish.${R}`);
     blank();
-    console.log(`  ${D}Used by 1,100+ developers. $9/mo, cancel anytime.${R}`);
+    console.log(`  ${MG}${B}→ Upgrade ($9/mo): ${CY}${UPGRADE_LINKS.free}${R}`);
     blank();
-    console.log(`  ${MG}${B}→ Get Pro: ${CY}${UPGRADE_LINKS.free}${R}`);
-    console.log(`  ${WH}   After purchase → get your key: ${CY}https://content-grade.onrender.com/my-license${R}`);
-    console.log(`  ${WH}   Have a key?  ${CY}content-grade activate <key>${R}`);
+    console.log(`  ${D}After checkout — 3 steps to unlock:${R}`);
+    console.log(`  ${D}  1. Get your key:   ${CY}https://content-grade.onrender.com/my-license${R}`);
+    console.log(`  ${D}  2. Activate:       ${CY}content-grade activate <your-key>${R}`);
+    console.log(`  ${D}  3. Run again — no cap, no counter.${R}`);
+    console.log(`  ${D}  Already have a key? Skip to step 2.${R}`);
   } else if (remaining === 1) {
-    // 1 run left — tease Pro features
-    console.log(`  ${YL}${B}${count}/${limit} free analyses used — 1 left.${R}`);
+    // 1 run left — loss aversion: name the thing they're about to lose
+    console.log(`  ${YL}${B}1 free analysis left today — your next run will be blocked.${R}`);
     blank();
-    console.log(`  ${MG}→ Pro: unlimited analyses + CI mode + bulk grading. $9/mo: ${CY}${UPGRADE_LINKS.free}${R}`);
+    console.log(`  ${WH}Don't get cut off mid-deadline. Upgrade now and it never interrupts you again. Pro is $9/mo.${R}`);
+    console.log(`  ${MG}→ ${CY}${UPGRADE_LINKS.free}${R}`);
   } else {
-    // Runs remaining — light nudge with value hook
-    console.log(`  ${WH}${count}/${limit} free analyses · ${remaining} left · Unlimited with Pro ($9/mo): ${CY}${UPGRADE_LINKS.free}${R}`);
+    // Runs available — benefit-first awareness, no pressure
+    console.log(`  ${D}${count}/${limit} free analyses today · ${remaining} left${R}`);
+    console.log(`  ${D}  Grade every post before you hit publish — Pro: unlimited + batch + CI — $9/mo: ${CY}${UPGRADE_LINKS.free}${R}`);
   }
   hr();
   console.log(`  ${D}⭐ Like ContentGrade? Star us: https://github.com/StanislavBG/Content-Grade${R}`);
@@ -221,11 +230,11 @@ function showUsageFooter(count) {
   const remaining = Math.max(0, limit - count);
   blank();
   if (remaining === 0) {
-    console.log(`  ${RD}[ ${count}/${limit} free runs used — limit reached. Unlimited runs: ${UPGRADE_LINKS.free} ]${R}`);
+    console.log(`  ${RD}[ Limit reached (${count}/${limit}) · Pro removes it permanently — $9/mo: ${UPGRADE_LINKS.free} ]${R}`);
   } else if (remaining === 1) {
-    console.log(`  ${YL}[ ${count}/${limit} free runs used · 1 left. Unlimited runs: ${UPGRADE_LINKS.free} ]${R}`);
+    console.log(`  ${YL}[ 1 free run left today — upgrade to avoid the block: ${UPGRADE_LINKS.free} ]${R}`);
   } else {
-    console.log(`  ${D}[ ${count}/${limit} free runs used · ${remaining} left. Unlimited: ${UPGRADE_LINKS.free} ]${R}`);
+    console.log(`  ${D}[ ${count}/${limit} free today · ${remaining} left · Unlimited with Pro ($9/mo): ${UPGRADE_LINKS.free} ]${R}`);
   }
   maybeShowEarlyAdopterCTA(count);
   maybeShowFeedbackCTA(count);
@@ -255,23 +264,21 @@ function checkFreeTierLimit() {
 
   // Track funnel event — user hit the limit and saw the upgrade prompt
   recordEvent({ event: 'free_limit_hit', version: _version });
+  recordEvent({ event: 'upgrade_prompt_shown', run_count: usage.count });
 
   blank();
   hr();
-  console.log(`  ${YL}${B}You've used ${usage.count}/${limit} free analyses today.${R}`);
-  blank();
-  console.log(`  ${WH}${B}Upgrade to Pro — unlimited analyses, $9/mo${R}`);
+  console.log(`  ${YL}${B}Daily limit reached — ${usage.count}/${limit} free analyses used today.${R}`);
   blank();
-  console.log(`  ${D}Pro removes the daily cap entirely:${R}`);
-  console.log(`  ${D}  · Unlimited analyses — run as many as you need, every day${R}`);
-  console.log(`  ${D}  · Batch mode         — score an entire /posts/ directory at once${R}`);
-  console.log(`  ${D}  · CI mode            — gate deploys on content quality${R}`);
-  console.log(`  ${D}  · JSON + HTML output — pipe results into your pipeline${R}`);
+  console.log(`  ${MG}${B}→ Upgrade to Pro ($9/mo): ${CY}${UPGRADE_LINKS.free}${R}`);
   blank();
-  console.log(`  ${MG}${B}→ Get Pro ($9/mo): ${CY}${UPGRADE_LINKS.free}${R}`);
+  console.log(`  ${D}After checkout — you're running again in 2 minutes:${R}`);
+  console.log(`  ${D}  1. Get your key:  ${CY}https://content-grade.onrender.com/my-license${R}`);
+  console.log(`  ${D}  2. Activate:      ${CY}content-grade activate <your-key>${R}`);
+  console.log(`  ${D}  3. Re-run your command — no cap, no counter.${R}`);
+  console.log(`  ${D}  Already have a key? Skip to step 2.${R}`);
   blank();
-  console.log(`  ${D}   After purchase → get your license key: ${CY}https://content-grade.onrender.com/my-license${R}`);
-  console.log(`  ${D}   Already have a key?  ${CY}content-grade activate <key>${R}`);
+  console.log(`  ${D}Pro unlocks: unlimited analyses · batch mode · CI integration · JSON/HTML output${R}`);
   hr();
   blank();
   return true;
@@ -1084,6 +1091,8 @@ async function cmdActivate() {
   config.activatedAt = new Date().toISOString();
   saveConfig(config);
 
+  recordEvent({ event: 'license_activated', tier: activatedTier });
+
   // Also write canonical license file to ~/.content-grade/license.json
   mkdirSync(LICENSE_DIR, { recursive: true });
   writeFileSync(LICENSE_FILE, JSON.stringify({
@@ -2128,6 +2137,11 @@ const _telem = initTelemetry();
 // Defer first-run telemetry notice so users see value first
 const _showTelemNotice = _telem.isNew;
 
+// Fire install event exactly once — on the very first run
+if (_telem.isNew) {
+  recordEvent({ event: 'install' });
+}
+
 // ── License key startup validation ───────────────────────────────────────────
 // Background check: re-validate stored license key against server every 7 days.
 // Non-blocking — never delays the CLI. Clears invalid/revoked keys silently.

package/bin/telemetry.js

@@ -10,8 +10,16 @@
 
 import { existsSync, readFileSync, writeFileSync, appendFileSync, mkdirSync } from 'fs';
 import { homedir } from 'os';
-import { join } from 'path';
+import { join, resolve, dirname } from 'path';
 import { createHash } from 'crypto';
+import { fileURLToPath } from 'url';
+
+// Package version — loaded once at module init
+const __telemetryDir = dirname(fileURLToPath(import.meta.url));
+let _pkgVersion = '1.0.0';
+try {
+  _pkgVersion = JSON.parse(readFileSync(resolve(__telemetryDir, '../package.json'), 'utf8')).version ?? '1.0.0';
+} catch {}
 
 const CONFIG_DIR   = join(homedir(), '.content-grade');
 const CONFIG_FILE  = join(CONFIG_DIR, 'config.json');
@@ -126,6 +134,11 @@ export function recordEvent(data) {
     package: 'content-grade',
     install_id: installId,
     run_count_bucket: data.run_count_bucket ?? getRunCountBucket(totalRuns),
+    // Auto-enrich with environment context if caller didn't provide
+    is_pro: data.is_pro ?? Boolean(cfg?.licenseKey),
+    version: data.version ?? _pkgVersion,
+    platform: data.platform ?? process.platform,
+    node_version: data.node_version ?? process.version,
     timestamp: new Date().toISOString(),
   };
 

package/dist-server/server/db.js

@@ -134,4 +134,12 @@ function migrate(db) {
         db.exec(`ALTER TABLE cli_telemetry ADD COLUMN run_count_bucket TEXT`);
     }
     catch { }
+    try {
+        db.exec(`ALTER TABLE cli_telemetry ADD COLUMN tier TEXT`);
+    }
+    catch { }
+    try {
+        db.exec(`ALTER TABLE cli_telemetry ADD COLUMN run_count INTEGER`);
+    }
+    catch { }
 }

package/dist-server/server/routes/analytics.js

@@ -43,9 +43,9 @@ export function registerAnalyticsRoutes(app) {
             const db = getDb();
             db.prepare(`
         INSERT INTO cli_telemetry
-          (install_id, event, command, is_pro, duration_ms, success, exit_code, score, content_type, version, platform, node_version, run_count_bucket)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(String(body.install_id).slice(0, 64), String(body.event ?? 'unknown').slice(0, 64), body.command ? String(body.command).slice(0, 64) : null, typeof body.is_pro === 'boolean' ? (body.is_pro ? 1 : 0) : null, typeof body.duration_ms === 'number' ? Math.round(body.duration_ms) : null, typeof body.success === 'boolean' ? (body.success ? 1 : 0) : null, typeof body.exit_code === 'number' ? body.exit_code : null, typeof body.score === 'number' ? body.score : null, body.content_type ? String(body.content_type).slice(0, 64) : null, body.version ? String(body.version).slice(0, 32) : null, body.platform ? String(body.platform).slice(0, 32) : null, body.nodeVersion ? String(body.nodeVersion).slice(0, 32) : null, body.run_count_bucket ? String(body.run_count_bucket).slice(0, 10) : null);
+          (install_id, event, command, is_pro, duration_ms, success, exit_code, score, content_type, version, platform, node_version, run_count_bucket, tier, run_count)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(String(body.install_id).slice(0, 64), String(body.event ?? 'unknown').slice(0, 64), body.command ? String(body.command).slice(0, 64) : null, typeof body.is_pro === 'boolean' ? (body.is_pro ? 1 : 0) : null, typeof body.duration_ms === 'number' ? Math.round(body.duration_ms) : null, typeof body.success === 'boolean' ? (body.success ? 1 : 0) : null, typeof body.exit_code === 'number' ? body.exit_code : null, typeof body.score === 'number' ? body.score : null, body.content_type ? String(body.content_type).slice(0, 64) : null, body.version ? String(body.version).slice(0, 32) : null, body.platform ? String(body.platform).slice(0, 32) : null, body.nodeVersion ? String(body.nodeVersion).slice(0, 32) : null, body.run_count_bucket ? String(body.run_count_bucket).slice(0, 10) : null, body.tier ? String(body.tier).slice(0, 32) : null, typeof body.run_count === 'number' ? body.run_count : null);
         }
         catch {
             // never fail — telemetry is non-critical
@@ -155,6 +155,27 @@ export function registerAnalyticsRoutes(app) {
         FROM email_captures
         WHERE date(created_at) >= ?
       `).get(since30);
+            // CLI conversion funnel — how many times each conversion event fired from the CLI
+            const cliConversionRows = db.prepare(`
+        SELECT event, COUNT(*) as count, COUNT(DISTINCT install_id) as unique_installs
+        FROM cli_telemetry
+        WHERE date(created_at) >= ?
+          AND event IN ('free_limit_hit', 'upgrade_prompt_shown')
+        GROUP BY event
+      `).all(since30);
+            const cliConversion = {};
+            for (const r of cliConversionRows) {
+                cliConversion[r.event] = { count: r.count, unique_installs: r.unique_installs };
+            }
+            // Daily CLI conversion trend (last 7d) — shows upgrade prompt impression volume
+            const cliConversionTrend = db.prepare(`
+        SELECT date(created_at) as date, event, COUNT(*) as count
+        FROM cli_telemetry
+        WHERE date(created_at) >= ?
+          AND event IN ('free_limit_hit', 'upgrade_prompt_shown')
+        GROUP BY date(created_at), event
+        ORDER BY date(created_at) DESC
+      `).all(sevenDaysAgo());
             return {
                 period: { from: since30, to: today },
                 funnel: {
@@ -172,6 +193,13 @@ export function registerAnalyticsRoutes(app) {
                         : 0,
                     avg_duration_ms: cliStats?.avg_duration_ms ? Math.round(cliStats.avg_duration_ms) : null,
                     command_breakdown: commandBreakdown,
+                    conversion: {
+                        free_limit_hits_30d: cliConversion['free_limit_hit']?.count ?? 0,
+                        free_limit_unique_installs_30d: cliConversion['free_limit_hit']?.unique_installs ?? 0,
+                        upgrade_prompts_shown_30d: cliConversion['upgrade_prompt_shown']?.count ?? 0,
+                        upgrade_prompt_unique_installs_30d: cliConversion['upgrade_prompt_shown']?.unique_installs ?? 0,
+                        trend_7d: cliConversionTrend,
+                    },
                 },
                 web: {
                     tool_usage_7d: toolUsage7d,

package/package.json

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