content-grade 1.0.35 → 1.0.36

package/README.md

@@ -51,7 +51,9 @@ 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.** 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 |
 |---|---|---|
@@ -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
 ```
 
 ---
@@ -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: 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);
@@ -259,20 +268,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;

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.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": {