content-grade 1.0.10 → 1.0.12

package/README.md

@@ -2,13 +2,14 @@
 
 > AI-powered content quality scoring for developers and content teams. Score any blog post, landing page, ad copy, or email — in under 30 seconds. No API keys. No accounts. Runs on your local Claude CLI.
 
+[![CI](https://github.com/StanislavBG/Content-Grade/actions/workflows/ci.yml/badge.svg)](https://github.com/StanislavBG/Content-Grade/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/content-grade.svg)](https://www.npmjs.com/package/content-grade)
 [![npm downloads/month](https://img.shields.io/npm/dm/content-grade.svg)](https://www.npmjs.com/package/content-grade)
 [![npm downloads/week](https://img.shields.io/npm/dw/content-grade.svg)](https://www.npmjs.com/package/content-grade)
 [![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 Discussions](https://img.shields.io/badge/GitHub-Discussions-blue?logo=github)](https://github.com/content-grade/Content-Grade/discussions)
+[![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)
 
 ---
@@ -171,7 +172,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: **50 analyses/day per tool**. Pro ($9/mo): **100 analyses/day** + all tools.
+Free tier: **50 analyses/day per tool**. Pro ($19/mo): **100 analyses/day** + all tools.
 
 ---
 
@@ -515,7 +516,7 @@ Stripe variables are entirely optional — all tools work without them; upgrade
 ## Self-hosting / Development
 
 ```bash
-git clone https://github.com/content-grade/Content-Grade
+git clone https://github.com/StanislavBG/Content-Grade
 cd Content-Grade
 npm install
 npm run dev     # hot reload: server at :4000, client at :3000
@@ -912,7 +913,7 @@ echo "$DATE,$HEADLINE,$SCORE" >> headline-scores.csv
 
 | | Free | Pro |
 |-|------|-----|
-| Price | Free forever | $9/month |
+| Price | Free forever | $19/month |
 | Analyses/day (CLI) | Unlimited | Unlimited |
 | Analyses/day (web dashboard, per tool) | 3 | 100 |
 | HeadlineGrader (single grade) | ✓ | ✓ |
@@ -945,25 +946,25 @@ ContentGrade is built in public. The community is the roadmap.
 
 ### GitHub Discussions
 
-**[Join the conversation →](https://github.com/content-grade/Content-Grade/discussions)**
+**[Join the conversation →](https://github.com/StanislavBG/Content-Grade/discussions)**
 
 | Category | What it's for |
 |----------|--------------|
-| [Q&A](https://github.com/content-grade/Content-Grade/discussions/new?category=q-a) | "Why is my score lower than expected?" — questions get answered here |
-| [Show & Tell](https://github.com/content-grade/Content-Grade/discussions/new?category=show-and-tell) | Share your workflow, integration, or results — early adopters post here |
-| [Ideas](https://github.com/content-grade/Content-Grade/discussions/new?category=ideas) | Feature requests and suggestions before they become issues |
+| [Q&A](https://github.com/StanislavBG/Content-Grade/discussions/new?category=q-a) | "Why is my score lower than expected?" — questions get answered here |
+| [Show & Tell](https://github.com/StanislavBG/Content-Grade/discussions/new?category=show-and-tell) | Share your workflow, integration, or results — early adopters post here |
+| [Ideas](https://github.com/StanislavBG/Content-Grade/discussions/new?category=ideas) | Feature requests and suggestions before they become issues |
 
 ### Early Adopter Program — 50 seats
 
 **[EARLY_ADOPTERS.md](EARLY_ADOPTERS.md)** — The first 50 users who install and share feedback get:
 
-- **Pro tier free for 12 months** ($9/mo value)
+- **Pro tier free for 12 months** ($19/mo value)
 - Direct feedback channel with the maintainer
 - Name in CONTRIBUTORS.md (permanent)
 - Roadmap preview + design input before features ship
 - 30-minute onboarding call (optional)
 
-One action to claim: run ContentGrade, then post in [Show & Tell](https://github.com/content-grade/Content-Grade/discussions/new?category=show-and-tell) with `[Early Adopter]` in the title.
+One action to claim: run ContentGrade, then post in [Show & Tell](https://github.com/StanislavBG/Content-Grade/discussions/new?category=show-and-tell) with `[Early Adopter]` in the title.
 
 ### Champions Program
 
@@ -975,16 +976,20 @@ See **[CONTRIBUTING.md](CONTRIBUTING.md)** for local dev setup, PR guidelines, a
 
 ### Roadmap
 
-**[ROADMAP.md](ROADMAP.md)** — what's built, what's next, what's planned, and what we're deliberately not doing. Open a [Discussion](https://github.com/content-grade/Content-Grade/discussions/new?category=ideas) to challenge or extend it.
+**[ROADMAP.md](ROADMAP.md)** — what's built, what's next, what's planned, and what we're deliberately not doing. Open a [Discussion](https://github.com/StanislavBG/Content-Grade/discussions/new?category=ideas) to challenge or extend it.
 
 ### Feedback Loop
 
-**[FEEDBACK_LOOP.md](FEEDBACK_LOOP.md)** — how feedback flows into product decisions. Monthly structured check-ins, 48h triage SLA, and roadmap sync. Use the [monthly feedback template](https://github.com/content-grade/Content-Grade/issues/new?template=monthly_feedback.yml) to share your experience.
+**[FEEDBACK_LOOP.md](FEEDBACK_LOOP.md)** — how feedback flows into product decisions. Monthly structured check-ins, 48h triage SLA, and roadmap sync. Use the [monthly feedback template](https://github.com/StanislavBG/Content-Grade/issues/new?template=monthly_feedback.yml) to share your experience.
 
 ### Contributors
 
 **[CONTRIBUTORS.md](CONTRIBUTORS.md)** — everyone who has improved ContentGrade. Code, bug reports, and real-world feedback all count. Early Adopters and Champions are listed here permanently.
 
+### How did you find ContentGrade?
+
+If you found this tool useful, we'd love to know where you came across it — a Reddit thread, a blog post, a colleague's recommendation? Drop a note in [GitHub Discussions → Q&A](https://github.com/Content-Grade/Content-Grade/discussions/new?category=q-a) with the subject "How I found ContentGrade". This is 100% optional and takes 30 seconds. It helps us understand which communities to focus on and which content resonates.
+
 ### Use ContentGrade in your project
 
 Add a badge to show your content meets the bar:
@@ -999,6 +1004,11 @@ See [docs/social-proof/built-with-badge.md](docs/social-proof/built-with-badge.m
 
 ---
 
+## Legal
+
+- [Privacy Policy](https://content-grade.github.io/Content-Grade/privacy.html)
+- [Terms of Service](https://content-grade.github.io/Content-Grade/terms.html)
+
 ## License
 
 MIT

package/bin/content-grade.js

@@ -388,8 +388,16 @@ async function cmdAnalyze(filePath) {
     result = parseJSON(raw);
     recordEvent({ event: 'analyze_result', score: result.total_score, content_type: result.content_type });
     // Machine-readable output modes (exit cleanly, skip styled output)
-    if (_jsonMode)  { process.stdout.write(JSON.stringify(result, null, 2) + '\n'); return; }
-    if (_quietMode) { process.stdout.write(`${result.total_score}\n`); return; }
+    if (_jsonMode)  {
+      process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+      if (_ciMode) process.exit(result.total_score >= _ciThreshold ? 0 : 1);
+      return;
+    }
+    if (_quietMode) {
+      process.stdout.write(`${result.total_score}\n`);
+      if (_ciMode) process.exit(result.total_score >= _ciThreshold ? 0 : 1);
+      return;
+    }
   } catch (err) {
     process.stdout.write(`\n`);
     blank();
@@ -498,6 +506,21 @@ async function cmdAnalyze(filePath) {
     blank();
     console.log(`  ${MG}Upgrade to Pro ($9/mo) for unlimited analyses →${R}  ${CY}https://content-grade.github.io/Content-Grade/${R}`);
   }
+
+  // CI exit code — shown after full output so user sees the score before exit
+  if (_ciMode) {
+    const passed = result.total_score >= _ciThreshold;
+    blank();
+    hr();
+    if (passed) {
+      ok(`CI PASS — score ${result.total_score} meets threshold ${_ciThreshold}`);
+    } else {
+      fail(`CI FAIL — score ${result.total_score} is below threshold ${_ciThreshold}`);
+    }
+    blank();
+    process.exit(passed ? 0 : 1);
+  }
+
   blank();
 }
 
@@ -1187,7 +1210,32 @@ async function cmdMetrics() {
   }
   blank();
 
-  // 2. Local telemetry summary
+  // 2. GitHub repository stats (public API, no auth)
+  console.log(`  ${B}GitHub${R}`);
+  const ghData = await new Promise((resolve) => {
+    const req = httpsGet(
+      'https://api.github.com/repos/StanislavBG/Content-Grade',
+      { headers: { 'User-Agent': `content-grade-cli/${_version}` }, timeout: 5000 },
+      (res) => {
+        let data = '';
+        res.on('data', (c) => data += c);
+        res.on('end', () => { try { resolve(JSON.parse(data)); } catch { resolve(null); } });
+      }
+    );
+    req.on('error', () => resolve(null));
+    req.on('timeout', () => { req.destroy(); resolve(null); });
+  });
+  if (ghData?.stargazers_count != null) {
+    console.log(`    ${D}Stars:        ${R}${B}${ghData.stargazers_count.toLocaleString()}${R}`);
+    console.log(`    ${D}Forks:        ${R}${B}${ghData.forks_count.toLocaleString()}${R}`);
+    console.log(`    ${D}Open issues:  ${R}${B}${ghData.open_issues_count.toLocaleString()}${R}`);
+    console.log(`    ${D}Watchers:     ${R}${B}${ghData.watchers_count.toLocaleString()}${R}`);
+  } else {
+    console.log(`    ${D}Unavailable (offline or rate limited)${R}`);
+  }
+  blank();
+
+  // 3. Local telemetry summary
   console.log(`  ${B}Local Usage${R}`);
   const eventsFile = join(homedir(), '.content-grade', 'events.jsonl');
   try {
@@ -1245,6 +1293,8 @@ function cmdHelp() {
   blank();
   console.log(`    ${CY}batch <directory>${R}       ${MG}[Pro]${R} Analyze all .md/.txt files in a directory`);
   blank();
+  console.log(`    ${CY}seo-audit <url>${R}         Fetch a live URL and analyze its content (SEO, readability, structure)`);
+  blank();
   console.log(`    ${CY}headline "<text>"${R}       Grade a single headline (4 copywriting frameworks)`);
   blank();
   console.log(`    ${CY}activate${R}                Enter license key to unlock Pro features`);
@@ -1266,6 +1316,8 @@ function cmdHelp() {
   blank();
   console.log(`    ${CY}--json${R}                  Output raw JSON (great for CI pipelines)`);
   console.log(`    ${CY}--quiet${R}                 Output score number only (for scripting)`);
+  console.log(`    ${CY}--ci${R}                    Exit 0 if score passes threshold, exit 1 if it fails`);
+  console.log(`    ${CY}--threshold <n>${R}         Score threshold for --ci mode (default: 60)`);
   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`);
@@ -1279,8 +1331,11 @@ function cmdHelp() {
   console.log(`    ${D}# Grade README.md (alias)${R}`);
   console.log(`    ${CY}content-grade grade README.md${R}`);
   blank();
-  console.log(`    ${D}# CI pipeline — exit 1 if score < threshold${R}`);
-  console.log(`    ${CY}content-grade analyze ./blog.md --json | jq '.total_score'${R}`);
+  console.log(`    ${D}# Audit a live URL${R}`);
+  console.log(`    ${CY}content-grade seo-audit https://yoursite.com/blog-post${R}`);
+  blank();
+  console.log(`    ${D}# CI pipeline — fail build if score is below 70${R}`);
+  console.log(`    ${CY}content-grade analyze ./blog.md --ci --threshold 70${R}`);
   blank();
   console.log(`    ${D}# Get score number only (for scripts)${R}`);
   console.log(`    ${CY}content-grade analyze ./post.md --quiet${R}`);
@@ -1470,7 +1525,8 @@ async function cmdDemo() {
 
     // Show telemetry notice after user has seen value (first run only)
     if (_showTelemNotice) {
-      console.log(`  ${D}Anonymous usage data is collected by default. Opt out: ${CY}content-grade telemetry off${R}`);
+      console.log(`  ${D}Help improve ContentGrade — enable anonymous usage analytics: ${CY}content-grade telemetry on${R}`);
+      console.log(`  ${D}No PII, no file contents. View what's collected: ${CY}content-grade telemetry${R}`);
       blank();
     }
 
@@ -1696,7 +1752,17 @@ const _rawArgs    = process.argv.slice(2);
 const _jsonMode   = _rawArgs.includes('--json');
 const _quietMode  = _rawArgs.includes('--quiet');
 const _verboseMode = _rawArgs.includes('--verbose') || _rawArgs.includes('-v') && !_rawArgs.includes('--version');
-const args = _rawArgs.filter(a => !['--no-telemetry', '--json', '--quiet', '--verbose'].includes(a));
+const _ciMode     = _rawArgs.includes('--ci');
+const _threshIdx  = _rawArgs.indexOf('--threshold');
+const _ciThreshold = (_threshIdx !== -1 && _rawArgs[_threshIdx + 1])
+  ? (parseInt(_rawArgs[_threshIdx + 1], 10) || 60)
+  : 60;
+const args = _rawArgs.filter((a, i) => {
+  if (['--no-telemetry', '--json', '--quiet', '--verbose', '--ci'].includes(a)) return false;
+  if (a === '--threshold') return false;
+  if (i > 0 && _rawArgs[i - 1] === '--threshold') return false;
+  return true;
+});
 const raw  = args[0];
 const cmd  = raw?.toLowerCase();
 
@@ -1775,6 +1841,26 @@ switch (cmd) {
     });
     break;
 
+  case 'seo-audit':
+  case 'seoaudit':
+    recordEvent({ event: 'command', command: 'seo-audit' });
+    if (!args[1]) {
+      blank();
+      fail(`No URL specified.`);
+      blank();
+      console.log(`  ${B}Usage:${R}   ${CY}content-grade seo-audit <url>${R}`);
+      console.log(`  ${B}Example:${R} ${CY}content-grade seo-audit https://yoursite.com/blog-post${R}`);
+      blank();
+      process.exit(2);
+    }
+    cmdAnalyzeUrl(args[1]).catch(err => {
+      blank();
+      fail(`Unexpected error: ${err.message}`);
+      blank();
+      process.exit(1);
+    });
+    break;
+
   case 'batch':
     recordEvent({ event: 'command', command: 'batch' });
     cmdBatch(args[1]).catch(err => {

package/bin/telemetry.js

@@ -72,18 +72,15 @@ export function initTelemetry() {
     return { installId: cfg.installId, isNew: false, optedOut: false };
   }
 
-  // First run — generate anonymous install ID
+  // First run — generate anonymous install ID, opt-IN by default (off until user enables)
   const installId = generateId();
   saveConfig({
     installId,
     installedAt: new Date().toISOString(),
-    telemetryEnabled: true,
+    telemetryEnabled: false,
   });
 
-  // Record install event
-  _write({ event: 'install', installId, platform: process.platform, nodeVersion: process.version });
-
-  return { installId, isNew: true, optedOut: false };
+  return { installId, isNew: true, optedOut: true };
 }
 
 /**

package/package.json

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