content-grade 1.0.45 → 1.0.46

package/CONTRIBUTING.md

@@ -31,8 +31,8 @@ cd Content-Grade
 npm install
 
 # Run in development
-node bin/content-grade.js demo         # smoke test — no API key needed
-node bin/content-grade.js analyze README.md  # requires ANTHROPIC_API_KEY
+node bin/content-grade.js demo         # smoke test — runs on built-in sample, no Claude needed
+node bin/content-grade.js analyze README.md  # requires Claude CLI logged in
 
 # Run all checks (must pass before opening a PR)
 npm test          # vitest — all tests green
@@ -40,16 +40,18 @@ npm run typecheck # zero TypeScript errors
 npm run build     # vite + tsc — must compile clean
 ```
 
+**Requirement:** Content-Grade uses [Claude CLI](https://claude.ai/code) for AI analysis — not an API key. Install it with `npm install -g @anthropic-ai/claude-code` and run `claude login`. The `demo` command and all tests run without Claude active.
+
 ### Environment variables
 
 Copy `.env.example` to `.env` if one exists, or set these:
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `ANTHROPIC_API_KEY` | For analysis tools | Your Anthropic API key |
-| `PORT` | No (default 3001) | Port for the web dashboard server |
+| `PORT` | No (default 4000) | Port for the web dashboard server |
+| `STRIPE_SECRET_KEY` | No | Stripe secret key for payment features |
 
-The `demo` command and all tests run without an API key — no credentials needed to contribute.
+No API keys are needed for the analysis tools. All tests and the `demo` command run without any environment variables.
 
 ## Submitting a pull request
 

package/README.md

@@ -9,6 +9,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js 18+](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 [![Requires Claude CLI](https://img.shields.io/badge/requires-Claude%20CLI-orange)](https://claude.ai/code)
+[![GitHub Issues](https://img.shields.io/github/issues/StanislavBG/Content-Grade)](https://github.com/StanislavBG/Content-Grade/issues)
 [![GitHub Discussions](https://img.shields.io/badge/GitHub-Discussions-blue?logo=github)](https://github.com/StanislavBG/Content-Grade/discussions)
 [![Early Adopter seats open](https://img.shields.io/badge/Early%20Adopter-50%20seats%20open-success)](EARLY_ADOPTERS.md)
 
@@ -47,6 +48,8 @@ content-grade analyze ./post.md --quiet    # score number only (for scripts)
 content-grade activate                     # unlock Pro: batch mode, 100/day
 ```
 
+⭐ **If the quickstart saved you 10 minutes, [star the repo](https://github.com/StanislavBG/Content-Grade) — it helps other developers find it.**
+
 ---
 
 ## Upgrade to Pro
@@ -66,6 +69,8 @@ Most developers hit the limit when they start trusting it enough to use it on ev
 
 **[Upgrade to Pro → $9/mo](https://buy.stripe.com/4gM14p87GeCh9vn9ks8k80a)**
 
+> **Early Adopter?** The first 50 users who share their results in [Show & Tell](https://github.com/StanislavBG/Content-Grade/discussions/new?category=show-and-tell) get **12 months Pro free**. [Details →](#early-adopter-program--12-months-pro-free)
+
 **What Pro unlocks in practice:**
 
 ```bash
@@ -233,19 +238,62 @@ Free tier: **5 analyses/day**. [Pro ($9/mo)](https://buy.stripe.com/4gM14p87GeCh
 
 **[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)
+### Early Adopter Program — 12 months Pro free
+
+Over 1,000 developers have installed ContentGrade. **Zero have claimed an Early Adopter seat yet.** That means you're actually first — and there are only 50.
+
+The first 50 users who run ContentGrade on real content and share it get **12 months Pro free** ($108 value) plus direct input on what gets built next.
+
+**How to claim your seat:**
+1. Run ContentGrade on a real file: `npx content-grade analyze ./your-post.md`
+2. Post in [Show & Tell](https://github.com/StanislavBG/Content-Grade/discussions/new?category=show-and-tell) with `[Early Adopter]` in the title — include your use case, one thing you'd change, and your score
+3. Maintainer responds within 48 hours with Pro access
+
+**Short on time?** Just [open an issue](https://github.com/StanislavBG/Content-Grade/issues/new?title=%5BEarly+Adopter%5D+Quick+claim&labels=early-adopter&body=Use+case%3A+%0AScore+I+got%3A+%0AOne+thing+I%27d+change%3A+) with `[Early Adopter]` in the title — same deal, lower friction.
+
+Full benefits: [EARLY_ADOPTERS.md](EARLY_ADOPTERS.md)
 
 ---
 
-## Built with Content-Grade?
+## Contributing
+
+Already using ContentGrade? That makes you the most valuable contributor. You know what's missing.
+
+**Three ways to help (pick what fits your time):**
+
+| Effort | Action |
+|--------|--------|
+| 2 min | [Open a discussion](https://github.com/StanislavBG/Content-Grade/discussions/new?category=ideas) — describe a workflow gap or missing feature |
+| 20 min | [File a bug report](https://github.com/StanislavBG/Content-Grade/issues/new?template=bug_report.yml) with `--verbose` output |
+| 2 hours | Pick a [`good first issue`](https://github.com/StanislavBG/Content-Grade/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) — scoped tasks with acceptance criteria and a pointer to the right file |
 
-Using ContentGrade in a real workflow? [Open an issue](https://github.com/StanislavBG/Content-Grade/issues/new?title=Built+with+Content-Grade%3A+&labels=use-case) or post in [Show & Tell](https://github.com/StanislavBG/Content-Grade/discussions/new?category=show-and-tell) and tell us:
+**Quick dev setup:**
+```bash
+git clone https://github.com/StanislavBG/Content-Grade.git
+cd Content-Grade
+npm install
+node bin/content-grade.js demo  # smoke test — no Claude needed
+npm test                        # all tests green
+```
 
-- What are you grading? (blog posts, landing pages, ad copy, emails?)
-- Are you running it in CI? What score threshold do you use?
-- Any workflow, config, or integration worth sharing?
+Requires [Claude CLI](https://claude.ai/code) for the analysis commands (`claude login` once). No API keys. See [CONTRIBUTING.md](CONTRIBUTING.md) for PR guidelines, code style, and what gets merged.
 
-Use cases that get shared here get featured in this README. Posting also qualifies you for the [Early Adopter program](EARLY_ADOPTERS.md) — 12 months Pro free.
+Contributors who file a useful bug report or land a PR automatically qualify for the [Early Adopter program](#early-adopter-program--12-months-pro-free).
+
+---
+
+## Show Us Your Results
+
+Over 1,000 developers have run ContentGrade. We'd love to hear what you're scoring — blog posts, landing pages, ad copy, emails, documentation.
+
+**[→ Post in Show & Tell](https://github.com/StanislavBG/Content-Grade/discussions/new?category=show-and-tell)** (also counts as an Early Adopter claim — 12 months Pro free)
+
+Tell us:
+- What content type? What score did you get?
+- Running it in CI? What threshold are you using?
+- Something that surprised you — good or bad?
+
+Use cases shared here get featured in this README. We'll credit you by username. And yes — every Show & Tell post qualifies for the [Early Adopter program](EARLY_ADOPTERS.md).
 
 ---
 
@@ -1036,9 +1084,32 @@ Power users who go beyond early adoption get early access to `@beta` releases, a
 
 ### Contributing
 
-See **[CONTRIBUTING.md](CONTRIBUTING.md)** for local dev setup, PR guidelines, and how to write good bug reports. The short version: clone → `pnpm install` → `pnpm dev` → file a PR. All contributions get a review within 48 hours.
+All contributions get a review within 48 hours.
+
+**First contribution in ~15 minutes:**
+
+```bash
+git clone https://github.com/StanislavBG/Content-Grade.git
+cd Content-Grade
+pnpm install
+pnpm dev         # type-check + test suite
+```
+
+Open a PR against `main`. Branch name format: `fix/short-description` or `feat/short-description`.
+
+**What's most needed right now:**
+
+| Area | Examples |
+|------|---------|
+| Scoring rules | Catch passive voice, jargon density, weak CTAs — add a new rule to the prompt |
+| CLI output | Better rendering in narrow terminals, CI-friendly formatting |
+| Bug fixes | Start with a [`good first issue`](https://github.com/StanislavBG/Content-Grade/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) — each has acceptance criteria and the exact file to touch |
+| Documentation | Fix unclear copy, add real-world examples, document edge cases |
+| Integrations | GitHub Actions workflows, pre-commit hook improvements, VS Code tasks |
+
+**Not sure where to start?** Browse **[`good first issue` →](https://github.com/StanislavBG/Content-Grade/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)** — scoped, completable in a few hours, no prior codebase knowledge required.
 
-Looking for a starting point? Browse **[`good first issue`](https://github.com/StanislavBG/Content-Grade/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)** — scoped tasks completable in a few hours with no prior codebase knowledge required. Each one has acceptance criteria and a pointer to exactly which file to touch.
+See **[CONTRIBUTING.md](CONTRIBUTING.md)** for full code style, test guidelines, and PR checklist.
 
 ### Roadmap
 
@@ -1070,22 +1141,6 @@ See [docs/social-proof/built-with-badge.md](docs/social-proof/built-with-badge.m
 
 ---
 
-## Community & Feedback
-
-[![GitHub Stars](https://img.shields.io/github/stars/StanislavBG/Content-Grade?style=social)](https://github.com/StanislavBG/Content-Grade)
-
-**1,159 developers have installed Content-Grade — join the community.**
-
-If Content-Grade saves you time, a ⭐ goes a long way. It helps more developers find the tool and keeps the project active.
-
-**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?** [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.
-
----
-
 ## Legal
 
 - [Privacy Policy](https://content-grade.github.io/Content-Grade/privacy.html)

package/bin/content-grade.js

@@ -141,10 +141,10 @@ function showFreeTierCTA(count) {
     // Limit reached — that run just worked; now close the sale
     console.log(`  ${RD}${B}That was your last free analysis (${limit}/${limit} used).${R}`);
     blank();
-    console.log(`  ${WH}${B}Pro: grade every piece you publish — no cap, no resets, ever.${R}`);
-    console.log(`  ${WH}  · No limit — run as many analyses as you need${R}`);
-    console.log(`  ${WH}  · Batch mode: grade your entire /posts/ directory in one shot${R}`);
-    console.log(`  ${WH}  · CI integration: exit codes + JSON/HTML output${R}`);
+    console.log(`  ${WH}${B}Pro unlocks:${R}`);
+    console.log(`  ${WH}  · Unlimited runs — no cap, no monthly resets${R}`);
+    console.log(`  ${WH}  · Priority support — get answers within 24h${R}`);
+    console.log(`  ${WH}  · Team sharing — share analyses across your team${R}`);
     blank();
     console.log(`  ${MG}${B}→ Get Pro ($9/mo, cancel anytime): ${CY}${UPGRADE_LINKS.free}${R}`);
     blank();
@@ -153,20 +153,20 @@ function showFreeTierCTA(count) {
     console.log(`  ${D}  2. Run:            ${CY}content-grade activate <your-key>${R}`);
     console.log(`  ${D}  Already have a key? Run step 2 now.${R}`);
   } else if (remaining <= 2) {
-    // 1-2 runs left — loss aversion + specific Pro value
-    console.log(`  ${YL}${B}${count}/${limit} runs used · ${remaining} free analysis${remaining === 1 ? '' : 'es'} left${R}`);
+    // 1-2 runs left — loss aversion + concrete Pro value
+    console.log(`  ${YL}${B}${remaining} free analysis${remaining === 1 ? '' : 'es'} remaining (${count}/${limit} used)${R}`);
     blank();
-    console.log(`  ${WH}${B}Pro: no cap, no resets — grade every piece you publish${R}`);
-    console.log(`  ${WH}  · Batch /posts/ directories · CI exit codes · JSON output${R}`);
+    console.log(`  ${WH}${B}Pro: unlimited runs · priority support · team sharing${R}`);
+    console.log(`  ${WH}  · No cap, no resets — grade every piece you publish${R}`);
     console.log(`  ${MG}${B}→ Get Pro before you run out ($9/mo): ${CY}${UPGRADE_LINKS.free}${R}`);
   } else {
     // Runs available — rotate benefit angle each run to avoid banner blindness
     const nudgeBenefits = [
-      `Pro: no cap — grade every piece you publish, no resets`,
-      `Pro: batch entire directories at once · no limits, ever`,
-      `Pro: CI integration · exit codes + JSON output · unlimited runs`,
+      `Pro: unlimited runs · no cap, no resets`,
+      `Pro: priority support · 24h response time`,
+      `Pro: team sharing · analyze together, no limits`,
     ];
-    console.log(`  ${WH}${count}/${limit} runs used · ${remaining} remaining${R}`);
+    console.log(`  ${WH}${remaining} free analysis${remaining === 1 ? '' : 'es'} remaining (${count}/${limit} used)${R}`);
     console.log(`  ${WH}  ${nudgeBenefits[count % 3]}${R}`);
     console.log(`  ${MG}→ Get Pro ($9/mo): ${CY}${UPGRADE_LINKS.free}${R}`);
   }
@@ -285,10 +285,10 @@ function checkFreeTierLimit() {
   hr();
   console.log(`  ${RD}${B}You've used all ${limit} free analyses.${R}`);
   blank();
-  console.log(`  ${WH}${B}Pro: grade every piece you publish — no cap, no resets, ever.${R}`);
-  console.log(`  ${WH}  · No limit — run as many analyses as you need${R}`);
-  console.log(`  ${WH}  · Batch mode: grade your entire /posts/ directory in one shot${R}`);
-  console.log(`  ${WH}  · CI integration: exit codes + JSON/HTML output${R}`);
+  console.log(`  ${WH}${B}Pro unlocks:${R}`);
+  console.log(`  ${WH}  · Unlimited runs — no cap, no monthly resets${R}`);
+  console.log(`  ${WH}  · Priority support — get answers within 24h${R}`);
+  console.log(`  ${WH}  · Team sharing — share analyses across your team${R}`);
   blank();
   console.log(`  ${MG}${B}→ Get Pro ($9/mo, cancel anytime): ${CY}${UPGRADE_LINKS.free}${R}`);
   blank();

package/dist-server/server/db.js

@@ -142,4 +142,9 @@ function migrate(db) {
         db.exec(`ALTER TABLE cli_telemetry ADD COLUMN run_count INTEGER`);
     }
     catch { }
+    // Preflight Suite: identify which tool sent the ping
+    try {
+        db.exec(`ALTER TABLE cli_telemetry ADD COLUMN package TEXT`);
+    }
+    catch { }
 }

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

@@ -54,6 +54,27 @@ export function registerAnalyticsRoutes(app) {
         }
         return { ok: true };
     });
+    // ── Preflight Suite telemetry — fire-and-forget ping per CLI run ─────────
+    // Accepts: { event, package, command, version, node_version, platform, anonymous_id }
+    // No PII. Never stores IP addresses. Always returns 200.
+    app.post('/telemetry', async (req) => {
+        try {
+            const body = req.body;
+            const anonymousId = body?.anonymous_id ? String(body.anonymous_id).slice(0, 64) : null;
+            if (!anonymousId)
+                return { ok: true };
+            const db = getDb();
+            db.prepare(`
+        INSERT INTO cli_telemetry
+          (install_id, package, event, command, version, platform, node_version, created_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, CURRENT_TIMESTAMP)
+      `).run(anonymousId, body?.package ? String(body.package).slice(0, 64) : null, body?.event ? String(body.event).slice(0, 64) : 'command_run', body?.command ? String(body.command).slice(0, 64) : null, body?.version ? String(body.version).slice(0, 32) : null, body?.platform ? String(body.platform).slice(0, 32) : null, body?.node_version ? String(body.node_version).slice(0, 32) : null);
+        }
+        catch {
+            // never fail — telemetry is non-critical
+        }
+        return { ok: true };
+    });
     // ── CLI telemetry receiver ────────────────────────────────────────────────
     // Receives events from CLI users who have opted in to telemetry.
     // Always returns 200 — never interrupt a CLI session for analytics.

package/package.json

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