content-grade 1.0.34 → 1.0.35

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,30 @@ 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.
+
+| | 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)**
+
+After payment you'll receive a license key by email. Activate it in one command:
+
+```bash
+content-grade activate
+# Enter your license key when prompted
+```
+
+---
+
 ## Usage Examples
 
 **Grade a single file:**
@@ -172,20 +196,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)
 
 ---
 

package/bin/content-grade.js

@@ -255,6 +255,7 @@ 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();
@@ -1084,6 +1085,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 +2131,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

package/package.json

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