content-grade 1.0.9 → 1.0.11

package/CONTRIBUTING.md

@@ -16,7 +16,7 @@ Thanks for wanting to contribute. ContentGrade is a CLI + web dashboard for AI-p
 ## Local development setup
 
 ```bash
-git clone https://github.com/StanislavBG/Content-Grade
+git clone https://github.com/Content-Grade/Content-Grade
 cd Content-Grade
 pnpm install
 pnpm dev

package/bin/content-grade.js

@@ -15,7 +15,7 @@
 
 import { execFileSync, execFile, spawn } from 'child_process';
 import { existsSync, readFileSync, mkdirSync, writeFileSync, unlinkSync, statSync } from 'fs';
-import { resolve, dirname, basename, extname } from 'path';
+import { resolve, dirname, basename, extname, join } from 'path';
 import { homedir } from 'os';
 import { fileURLToPath } from 'url';
 import { promisify } from 'util';
@@ -113,7 +113,7 @@ function blank()   { console.log(''); }
 function banner() {
   blank();
   console.log(`${B}${CY}  ╔═══════════════════════════════════════╗${R}`);
-  console.log(`${B}${CY}  ║   ContentGrade  ·  Content Analysis   ║${R}`);
+  console.log(`${B}${CY}  ║   ContentGrade  ·  AI content scoring ║${R}`);
   console.log(`${B}${CY}  ╚═══════════════════════════════════════╝${R}`);
   blank();
 }
@@ -1150,16 +1150,104 @@ async function cmdCheckUpdates() {
   blank();
 }
 
+// ── Metrics ───────────────────────────────────────────────────────────────────
+
+async function cmdMetrics() {
+  blank();
+  console.log(`  ${B}ContentGrade Metrics${R}`);
+  blank();
+
+  // 1. npm download stats (public API, no auth)
+  console.log(`  ${B}npm Downloads${R}`);
+  const fetchNpm = (period) => new Promise((resolve) => {
+    const url = `https://api.npmjs.org/downloads/point/${period}/content-grade`;
+    const mod = url.startsWith('https') ? httpsGet : httpGet;
+    const req = mod(url, { 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); });
+  });
+
+  const [week, month] = await Promise.all([
+    fetchNpm('last-week'),
+    fetchNpm('last-month'),
+  ]);
+  if (week?.downloads != null) {
+    console.log(`    ${D}Last 7 days:  ${R}${B}${week.downloads.toLocaleString()}${R} installs`);
+  } else {
+    console.log(`    ${D}Last 7 days:  ${R}${D}unavailable (offline?)${R}`);
+  }
+  if (month?.downloads != null) {
+    console.log(`    ${D}Last 30 days: ${R}${B}${month.downloads.toLocaleString()}${R} installs`);
+  }
+  blank();
+
+  // 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 {
+    const lines = readFileSync(eventsFile, 'utf8').trim().split('\n').filter(Boolean);
+    const events = lines.map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
+    const commands = events.filter(e => e.event === 'command');
+    const installs = events.filter(e => e.event === 'install');
+    const byCmd = {};
+    for (const e of commands) { byCmd[e.command] = (byCmd[e.command] || 0) + 1; }
+    console.log(`    ${D}Total runs:   ${R}${B}${commands.length}${R}`);
+    console.log(`    ${D}Installs:     ${R}${B}${installs.length}${R}`);
+    if (Object.keys(byCmd).length) {
+      const top = Object.entries(byCmd).sort((a, b) => b[1] - a[1]).slice(0, 5);
+      console.log(`    ${D}Top commands: ${R}${top.map(([k, v]) => `${CY}${k}${R}(${v})`).join('  ')}`);
+    }
+  } catch {
+    console.log(`    ${D}No local events yet${R}`);
+  }
+  blank();
+
+  console.log(`  ${D}Full install history: ${CY}https://npmjs.com/package/content-grade${R}`);
+  blank();
+}
+
 // ── Help ──────────────────────────────────────────────────────────────────────
 
 function cmdHelp() {
   banner();
+  console.log(`  ${D}AI-powered content quality scoring — readability, SEO, structure analysis${R}`);
   console.log(`  ${D}v${_version}  ·  ${CY}content-grade.github.io/Content-Grade${R}`);
   blank();
   console.log(`  ${B}QUICK START${R}`);
   blank();
-  console.log(`    ${CY}npx content-grade headline "Your title here"${R}  ${D}# grade a headline (fastest, ~5s)${R}`);
-  console.log(`    ${CY}npx content-grade analyze ./post.md${R}           ${D}# full AI content analysis (~20s)${R}`);
+  console.log(`    ${CY}npx content-grade headline "Your Headline Here"${R}  ${D}# grade a headline (fastest, ~5s)${R}`);
+  console.log(`    ${CY}npx content-grade analyze ./my-post.md${R}         ${D}# full AI content analysis (~20s)${R}`);
   console.log(`    ${CY}npx content-grade demo${R}                        ${D}# live demo on sample content${R}`);
   console.log(`    ${CY}npx content-grade start${R}                       ${D}# launch web dashboard (6 tools)${R}`);
   blank();
@@ -1191,6 +1279,8 @@ function cmdHelp() {
   blank();
   console.log(`    ${CY}init${R}                    Run if Claude CLI isn't detected or tools aren't working`);
   blank();
+  console.log(`    ${CY}metrics${R}                 Show npm download counts and local usage stats`);
+  blank();
   console.log(`    ${CY}telemetry [on|off]${R}      View or toggle anonymous usage tracking`);
   blank();
   console.log(`    ${CY}check-updates${R}           Check if a newer version is available on npm`);
@@ -1405,7 +1495,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();
     }
 
@@ -1745,6 +1836,10 @@ switch (cmd) {
     console.log(`content-grade v${_version}`);
     break;
 
+  case 'metrics':
+    cmdMetrics().catch(() => {});
+    break;
+
   case 'telemetry': {
     const sub = args[1];
     if (sub === 'off') {

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.9",
+  "version": "1.0.11",
   "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": {