content-grade 1.0.35 → 1.0.37

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:** 3 analyses/day. No signup. `npx content-grade grade README.md` works immediately.
+**Free tier:** 5 analyses/day. No signup. `npx content-grade grade README.md` works immediately.
 
 **Install globally** (recommended — skips the `npx` download on every run):
 
@@ -51,11 +51,13 @@ content-grade activate                     # unlock Pro: batch mode, 100/day
 
 ## Upgrade to Pro
 
-**Free tier:** 3 analyses/day — enough to try it, not enough to rely on it.
+**The free tier is real.** 5 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 |
+| Analyses/day | 5 | Unlimited |
 | All 6 CLI commands | ✓ | ✓ |
 | Web dashboard (6 tools) | ✓ | ✓ |
 | Batch mode (`batch <dir>`) | — | ✓ |
@@ -64,11 +66,28 @@ content-grade activate                     # unlock Pro: batch mode, 100/day
 
 **[Upgrade to Pro → $9/mo](https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a)**
 
-After payment you'll receive a license key by email. Activate it in one command:
+**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
 ```
 
 ---
@@ -196,7 +215,7 @@ 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: **3 analyses/day**. [Pro ($9/mo)](https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a): **unlimited analyses** + batch mode.
+Free tier: **5 analyses/day**. [Pro ($9/mo)](https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a): **unlimited analyses** + batch mode.
 
 ---
 
@@ -293,15 +312,16 @@ content-grade analyze ./post.md --verbose
 
 ### Daily limit reached
 
-Free tier: 50 CLI analyses/day, resets at midnight UTC.
+Free tier: 5 analyses/day, resets at midnight UTC.
 
 ```
-✗ Daily limit reached (50/50 free checks used today).
+✗ Daily limit reached (5/5 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,32 +131,40 @@ 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}`);
   maybeShowFeedbackCTA(count);
 }
 
@@ -213,6 +221,17 @@ function maybeShowFeedbackCTA(count) {
   console.log(`  ${D}Found a bug or have a suggestion? Open an issue: ${CY}https://github.com/StanislavBG/Content-Grade/issues/new${R}`);
 }
 
+// Community nudge — shown after every run, ungated (free AND Pro).
+// One line, low noise. Converts CLI runs into visible community members.
+const GITHUB_URL = 'https://github.com/StanislavBG/Content-Grade';
+const DISCUSSIONS_URL = 'https://github.com/StanislavBG/Content-Grade/discussions';
+
+function showCommunityNudge() {
+  blank();
+  console.log(`  ${D}⭐ Found this useful? Star us on GitHub: ${CY}${GITHUB_URL}${R}`);
+  console.log(`  ${D}💬 Questions or feedback? Discussions: ${CY}${DISCUSSIONS_URL}${R}`);
+}
+
 // Single-line usage counter appended after every command run.
 // count = total runs used today (after this run).
 function showUsageFooter(count) {
@@ -221,15 +240,14 @@ 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);
-  console.log(`  ${D}⭐ Like ContentGrade? Star us: https://github.com/StanislavBG/Content-Grade${R}`);
 }
 
 // Returns { ok: boolean, count: number, limit: number } for tier-aware daily limit checks.
@@ -259,20 +277,17 @@ function checkFreeTierLimit() {
 
   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;
@@ -712,6 +727,7 @@ async function cmdAnalyze(filePath) {
   } else {
     showFreeTierCTA(usageCount);
   }
+  if (!_ciMode) showCommunityNudge();
 
   // CI exit code — shown after full output so user sees the score before exit
   if (_ciMode) {
@@ -873,6 +889,7 @@ async function cmdHeadline(text) {
     const usageCount = incrementUsage();
     showFreeTierCTA(usageCount);
   }
+  showCommunityNudge();
 }
 
 // ── Init command ──────────────────────────────────────────────────────────────
@@ -1250,6 +1267,7 @@ async function cmdBatch(dirPath) {
   if (_jsonMode) process.stdout.write(JSON.stringify(results, null, 2) + '\n');
 
   if (!isProUser() && results.length) showUsageFooter(getUsage().count);
+  if (results.length) showCommunityNudge();
 }
 
 // ── Start command ─────────────────────────────────────────────────────────────
@@ -1501,7 +1519,7 @@ async function cmdMetrics() {
 function cmdHelp() {
   banner();
   console.log(`  ${D}AI-powered content quality scoring — readability, SEO, structure analysis${R}`);
-  console.log(`  ${D}v${_version}  ·  ${CY}npmjs.com/package/content-grade${R}`);
+  console.log(`  ${D}v${_version}  ·  ${CY}npmjs.com/package/content-grade${R}  ·  ${CY}${GITHUB_URL}${R}`);
   blank();
   console.log(`  ${B}QUICK START${R}`);
   blank();
@@ -1608,6 +1626,13 @@ function cmdHelp() {
   console.log(`    Get Pro:  ${CY}${UPGRADE_LINKS.free}${R}   ${D}# direct checkout${R}`);
   console.log(`    Activate: ${CY}content-grade activate <your-license-key>${R}`);
   blank();
+
+  console.log(`  ${B}COMMUNITY${R}`);
+  blank();
+  console.log(`    ⭐ GitHub:       ${CY}${GITHUB_URL}${R}`);
+  console.log(`    💬 Discussions:  ${CY}${DISCUSSIONS_URL}${R}`);
+  console.log(`    🐛 Issues:       ${CY}${FEEDBACK_URL}${R}`);
+  blank();
 }
 
 // ── Feedback command ─────────────────────────────────────────────────────────

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

@@ -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.35",
+  "version": "1.0.37",
   "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": {