content-grade 1.0.33 → 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.
 
-**[GitHub Discussions](https://github.com/Content-Grade/Content-Grade/discussions)** — ask questions, share setups, vote on what gets built next.
+| 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 |
 
-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
+**[All discussions →](https://github.com/StanislavBG/Content-Grade/discussions)**
+
+**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)
 
 ---
 
@@ -945,6 +973,8 @@ The web dashboard works the same way — every tool call goes through `claude -p
 
 ContentGrade is built in public. The community is the roadmap.
 
+**→ [COMMUNITY.md](COMMUNITY.md)** — how to report bugs, request features, and claim an Early Adopter seat.
+
 ### GitHub Discussions
 
 **[Join the conversation →](https://github.com/StanislavBG/Content-Grade/discussions)**
@@ -1007,7 +1037,7 @@ See [docs/social-proof/built-with-badge.md](docs/social-proof/built-with-badge.m
 
 ---
 
-## Community
+## Community & Feedback
 
 [![GitHub Stars](https://img.shields.io/github/stars/StanislavBG/Content-Grade?style=social)](https://github.com/StanislavBG/Content-Grade)
 
@@ -1017,7 +1047,9 @@ If Content-Grade saves you time, a ⭐ goes a long way. It helps more developers
 
 **Early adopter program:** The first 50 seats are still open — early adopters get permanent free Pro tier. [Claim your seat →](https://content-grade.github.io/Content-Grade/#early-adopter)
 
-**Found a bug? Have a use case?** [Open an issue](https://github.com/StanislavBG/Content-Grade/issues/new/choose) or [start a discussion](https://github.com/StanislavBG/Content-Grade/discussions/new) — every report shapes what gets built next.
+**Found a bug?** [Open an issue →](https://github.com/StanislavBG/Content-Grade/issues/new/choose) — every report shapes what gets built next.
+
+**[GitHub Discussions →](https://github.com/StanislavBG/Content-Grade/discussions)** — questions, ideas, and show & tell. Built something with content-grade? Open a Discussion — we want to see it.
 
 ---
 

package/bin/content-grade.js

@@ -156,6 +156,8 @@ function showFreeTierCTA(count) {
     console.log(`  ${WH}${count}/${limit} free analyses · ${remaining} left · Unlimited with Pro ($9/mo): ${CY}${UPGRADE_LINKS.free}${R}`);
   }
   hr();
+  console.log(`  ${D}⭐ Like ContentGrade? Star us: https://github.com/StanislavBG/Content-Grade${R}`);
+  maybeShowFeedbackCTA(count);
 }
 
 // ── Early Adopter program enrollment CTA ─────────────────────────────────────
@@ -190,6 +192,27 @@ function maybeShowEarlyAdopterCTA(count) {
   hr();
 }
 
+// ── Feedback CTA ──────────────────────────────────────────────────────────────
+
+function hasFeedbackCTAShown() {
+  return Boolean(loadConfig().feedbackCTAShown);
+}
+
+function markFeedbackCTAShown() {
+  const cfg = loadConfig();
+  cfg.feedbackCTAShown = true;
+  saveConfig(cfg);
+}
+
+// Show once, after the 3rd run, to seed the GitHub Issues feedback loop.
+function maybeShowFeedbackCTA(count) {
+  if (count !== 3) return;               // only after exactly the 3rd run
+  if (hasFeedbackCTAShown()) return;     // only once per install
+  markFeedbackCTAShown();
+  blank();
+  console.log(`  ${D}Found a bug or have a suggestion? Open an issue: ${CY}https://github.com/StanislavBG/Content-Grade/issues/new${R}`);
+}
+
 // Single-line usage counter appended after every command run.
 // count = total runs used today (after this run).
 function showUsageFooter(count) {
@@ -205,6 +228,8 @@ function showUsageFooter(count) {
     console.log(`  ${D}[ ${count}/${limit} free runs used · ${remaining} left. Unlimited: ${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.
@@ -230,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();
@@ -1059,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({
@@ -1519,6 +1547,8 @@ function cmdHelp() {
   blank();
   console.log(`    ${CY}check-updates${R}           Check if a newer version is available on npm`);
   blank();
+  console.log(`    ${CY}feedback${R}                Open GitHub Issues to report a bug or request a feature`);
+  blank();
   console.log(`    ${CY}help${R}                    Show this help`);
   blank();
   console.log(`  ${B}FLAGS${R}`);
@@ -1532,6 +1562,7 @@ function cmdHelp() {
   console.log(`    ${CY}--verbose${R}               Show debug info: model, timing, raw response length`);
   console.log(`    ${CY}--version${R}               Print version and exit`);
   console.log(`    ${CY}--no-telemetry${R}          Skip usage tracking for this invocation`);
+  console.log(`    ${CY}--feedback${R}              Open GitHub Issues in your browser`);
   blank();
 
   console.log(`  ${B}EXAMPLES${R}`);
@@ -1579,6 +1610,27 @@ function cmdHelp() {
   blank();
 }
 
+// ── Feedback command ─────────────────────────────────────────────────────────
+
+const FEEDBACK_URL = 'https://github.com/StanislavBG/Content-Grade/issues/new';
+
+function cmdFeedback() {
+  blank();
+  console.log(`  ${B}Report an issue or request a feature${R}`);
+  blank();
+  console.log(`  ${CY}${FEEDBACK_URL}${R}`);
+  blank();
+  const { platform } = process;
+  const opener = platform === 'darwin' ? 'open' : platform === 'win32' ? 'start' : 'xdg-open';
+  try {
+    spawn(opener, [FEEDBACK_URL], { stdio: 'ignore', shell: platform === 'win32', detached: true }).unref();
+    console.log(`  ${GN}✓${R} Opening in your browser…`);
+  } catch {
+    console.log(`  ${D}(Could not open browser — copy the URL above)${R}`);
+  }
+  blank();
+}
+
 // ── First-run detection ───────────────────────────────────────────────────────
 
 function isFirstRun() {
@@ -2063,8 +2115,9 @@ const _savePath = (_saveMode && _rawArgs[_saveIdx + 1] && !_rawArgs[_saveIdx + 1
   ? _rawArgs[_saveIdx + 1]
   : null;
 const _demoMode = _rawArgs.includes('--demo');
+const _feedbackMode = _rawArgs.includes('--feedback');
 const args = _rawArgs.filter((a, i) => {
-  if (['--no-telemetry', '--json', '--quiet', '--verbose', '--ci', '--save', '--demo'].includes(a)) return false;
+  if (['--no-telemetry', '--json', '--quiet', '--verbose', '--ci', '--save', '--demo', '--feedback'].includes(a)) return false;
   if (a === '--threshold') return false;
   if (i > 0 && _rawArgs[i - 1] === '--threshold') return false;
   if (_saveMode && i > 0 && _rawArgs[i - 1] === '--save' && !a.startsWith('-')) return false;
@@ -2078,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.
@@ -2235,7 +2293,9 @@ if (_rawArgs.includes('--help') || _rawArgs.includes('-h')) {
   }
 }
 
-if (_demoMode) {
+if (_feedbackMode) {
+  cmdFeedback();
+} else if (_demoMode) {
   recordEvent({ event: 'grade_run', is_pro: isProUser(), command:'demo' });
   cmdDemo().catch(err => {
     blank();
@@ -2335,6 +2395,12 @@ if (_demoMode) {
     });
     break;
 
+  case 'feedback':
+  case 'issue':
+  case 'report':
+    cmdFeedback();
+    break;
+
   case 'help':
   case '--help':
   case '-h':

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