content-grade 1.0.3 → 1.0.5

package/README.md

@@ -6,6 +6,8 @@
 [![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/StanislavBG/Content-Grade/discussions)
+[![Early Adopter seats open](https://img.shields.io/badge/Early%20Adopter-50%20seats%20open-success)](EARLY_ADOPTERS.md)
 
 ---
 
@@ -82,7 +84,7 @@ npx content-grade activate
   1. Why 90% of SaaS Startups Fail at Month 18 (and How to Be the 10%)
   2. The Month 18 Startup Trap: What Kills Growth-Stage Companies
 
-  Unlock team features at contentgrade.dev
+  Unlock team features at content-grade.github.io/Content-Grade
 ```
 
 ---
@@ -139,7 +141,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.
 
 ---
 
@@ -709,7 +711,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) | ✓ | ✓ |
@@ -736,6 +738,54 @@ The web dashboard works the same way — every tool call goes through `claude -p
 
 ---
 
+## Community
+
+ContentGrade is built in public. The community is the roadmap.
+
+### GitHub Discussions
+
+**[Join the conversation →](https://github.com/StanislavBG/Content-Grade/discussions)**
+
+| Category | What it's for |
+|----------|--------------|
+| [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** ($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/StanislavBG/Content-Grade/discussions/new?category=show-and-tell) with `[Early Adopter]` in the title.
+
+### Champions Program
+
+Power users who go beyond early adoption get early access to `@beta` releases, a private Champions discussion thread, and a SVG badge for their profile. See **[CHAMPIONS.md](CHAMPIONS.md)** for selection criteria and current members.
+
+### 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.
+
+### 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/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/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.
+
+---
+
 ## License
 
 MIT

package/bin/content-grade.js

@@ -713,34 +713,42 @@ async function cmdActivate() {
   console.log(`  ${D}Get a license: ${CY}contentgrade.dev${R}${D} → Pricing → Team${R}`);
   blank();
 
-  process.stdout.write(`  ${CY}License key:${R} `);
-
-  const key = await new Promise(res => {
-    let input = '';
-    const isRaw = process.stdin.isTTY;
-    if (isRaw) process.stdin.setRawMode(true);
-    process.stdin.resume();
-    process.stdin.setEncoding('utf8');
-    process.stdin.on('data', function onData(chunk) {
-      if (chunk === '\r' || chunk === '\n') {
-        if (isRaw) process.stdin.setRawMode(false);
-        process.stdin.pause();
-        process.stdin.removeListener('data', onData);
-        process.stdout.write('\n');
-        res(input.trim());
-      } else if (chunk === '\u0003') {
-        if (isRaw) process.stdin.setRawMode(false);
-        process.stdin.pause();
-        process.stdout.write('\n');
-        process.exit(0);
-      } else if (chunk === '\u007f') {
-        if (input.length > 0) { input = input.slice(0, -1); process.stdout.write('\b \b'); }
-      } else {
-        input += chunk;
-        process.stdout.write('*');
-      }
+  let key;
+  if (args[1] && args[1].length >= 8) {
+    key = args[1];
+    blank();
+    console.log(`  ${D}Using provided key: ${args[1].slice(0, 8)}...${R}`);
+    blank();
+  } else {
+    process.stdout.write(`  ${CY}License key:${R} `);
+
+    key = await new Promise(res => {
+      let input = '';
+      const isRaw = process.stdin.isTTY;
+      if (isRaw) process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.setEncoding('utf8');
+      process.stdin.on('data', function onData(chunk) {
+        if (chunk === '\r' || chunk === '\n') {
+          if (isRaw) process.stdin.setRawMode(false);
+          process.stdin.pause();
+          process.stdin.removeListener('data', onData);
+          process.stdout.write('\n');
+          res(input.trim());
+        } else if (chunk === '\u0003') {
+          if (isRaw) process.stdin.setRawMode(false);
+          process.stdin.pause();
+          process.stdout.write('\n');
+          process.exit(0);
+        } else if (chunk === '\u007f') {
+          if (input.length > 0) { input = input.slice(0, -1); process.stdout.write('\b \b'); }
+        } else {
+          input += chunk;
+          process.stdout.write('*');
+        }
+      });
     });
-  });
+  }
 
   if (!key || key.length < 8) {
     blank();
@@ -749,13 +757,45 @@ async function cmdActivate() {
     process.exit(2);
   }
 
+  // Validate key against server before storing
+  const serverUrl = process.env.CONTENT_GRADE_SERVER_URL || 'https://contentgrade.ai';
+  blank();
+  process.stdout.write(`  ${D}Validating key...${R}`);
+
+  let validated = false;
+  try {
+    const response = await fetch(`${serverUrl}/api/license/validate`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ key }),
+    });
+    const data = await response.json();
+    if (data.valid) {
+      validated = true;
+    } else {
+      process.stdout.write('\n');
+      blank();
+      fail(data.message || 'Invalid or expired license key. Visit contentgrade.ai to check your subscription.');
+      blank();
+      process.exit(2);
+    }
+  } catch {
+    // Server unreachable — allow offline activation with a warning
+    process.stdout.write('\n');
+    blank();
+    console.log(`  ${D}⚠ Could not reach server — storing key locally without verification.${R}`);
+    validated = true;
+  }
+
+  process.stdout.write(' done\n');
+
   const config = loadConfig();
   config.licenseKey = key;
   config.activatedAt = new Date().toISOString();
   saveConfig(config);
 
   blank();
-  ok(`License activated! Pro features unlocked.`);
+  ok(`Pro access activated! Your daily limit is now 100 analyses.`);
   blank();
   console.log(`  ${B}Try it:${R}`);
   console.log(`  ${CY}  content-grade batch ./posts/${R}   ${D}# analyze all files${R}`);
@@ -1094,19 +1134,19 @@ function cmdHelp() {
 
 // ── Demo command ──────────────────────────────────────────────────────────────
 
-const DEMO_CONTENT = `# Why Your Morning Routine Is Secretly Destroying Your Productivity
+const DEMO_CONTENT = `# How to Write Better Blog Posts
 
-Productivity is important. Many people struggle with it. In this post we will discuss some tips.
+Writing good blog posts is important for any content marketer. Many people struggle with this. In this post I will share some tips that can help you improve.
 
-First, wake up early. Successful people wake up early. This gives you more time. Studies show that early risers are more productive.
+First, you need to have a good headline. The headline is the first thing people see. A good headline will make people want to read more. Try to make it interesting.
 
-Second, make a to-do list. Write everything down. Then do the tasks one by one. This is a simple but effective strategy.
+Second, write good content. Your content should be useful and informative. People should learn something from reading your post. Make sure to cover the topic well.
 
-Third, avoid distractions. Put your phone away. Social media is bad for focus. You should minimize interruptions.
+Third, use a good structure. Break your content into sections. Use headings and bullet points. This makes it easier to read. People can scan and find what they need.
 
-Fourth, take breaks. Working too hard is not good. Make sure to rest sometimes. The Pomodoro technique can help with this.
+Finally, have a good conclusion. Summarize what you talked about. Tell people what to do next. A call to action is important.
 
-In conclusion, these productivity tips are very helpful. Try them today and you will see a big difference in your output. Productivity is the key to success in today's world.
+In conclusion, following these tips will help you write better blog posts. Good content is important for success online. Start applying these tips today.
 `;
 
 async function cmdDemo() {
@@ -1125,22 +1165,80 @@ async function cmdDemo() {
   const tmpFile = `/tmp/content-grade-demo-${process.pid}-${Date.now()}.md`;
 
   banner();
-  console.log(`  ${B}Demo Mode${R}  ${D}— running analysis on sample content${R}`);
+  console.log(`  ${B}Demo Mode${R}  ${D}— see ContentGrade in action${R}`);
   blank();
-  console.log(`  ${D}This is what ContentGrade does. Try it on your own content:${R}`);
-  console.log(`  ${CY}  content-grade analyze ./your-post.md${R}`);
-  blank();
-  console.log(`  ${D}Analyzing sample blog post...${R}`);
+  console.log(`  ${D}Analyzing a sample blog post with generic writing.${R}`);
+  console.log(`  ${D}Generic content scores low — that's the point. Watch what ContentGrade finds.${R}`);
   blank();
 
   writeFileSync(tmpFile, DEMO_CONTENT, 'utf8');
   try {
     await cmdAnalyze(tmpFile);
+
+    // Post-demo CTA — shown AFTER user has seen the analysis output
+    blank();
+    hr();
+    console.log(`  ${B}${CY}Now try it on your own content:${R}`);
+    blank();
+    console.log(`  ${CY}content-grade analyze ./your-post.md${R}         ${D}# any .md or .txt file${R}`);
+    console.log(`  ${CY}content-grade https://your-blog.com/post${R}      ${D}# analyze any URL${R}`);
+    console.log(`  ${CY}content-grade headline "Your headline here"${R}   ${D}# grade a headline${R}`);
+    blank();
+
     // 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}`);
       blank();
     }
+
+    // Interactive follow-up — strike while the iron is hot
+    if (process.stdin.isTTY) {
+      hr();
+      console.log(`  ${B}${CY}Try it on YOUR content right now:${R}`);
+      blank();
+      console.log(`  ${D}Paste a URL, type a headline, or a file path — then press Enter.${R}`);
+      console.log(`  ${D}(Press Enter to skip)${R}`);
+      blank();
+      process.stdout.write(`  ${CY}>${R} `);
+
+      const userInput = await new Promise(res => {
+        let line = '';
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        const onData = (chunk) => {
+          const str = chunk.toString();
+          if (str.includes('\n') || str.includes('\r')) {
+            process.stdin.pause();
+            process.stdin.removeListener('data', onData);
+            process.stdout.write('\n');
+            res(line.replace(/[\r\n]/g, '').trim());
+          } else if (str === '\u0003') {
+            process.stdin.pause();
+            process.stdin.removeListener('data', onData);
+            process.stdout.write('\n');
+            res('');
+          } else {
+            line += str;
+            process.stdout.write(str);
+          }
+        };
+        process.stdin.on('data', onData);
+      });
+
+      if (userInput) {
+        blank();
+        if (/^https?:\/\//i.test(userInput)) {
+          await cmdAnalyzeUrl(userInput);
+        } else if (looksLikePath(userInput)) {
+          await cmdAnalyze(userInput);
+        } else if (userInput.length >= 5) {
+          await cmdHeadline(userInput);
+        } else {
+          warn(`Couldn't parse that. Try a URL like https://... or a headline like "Your title here".`);
+          blank();
+        }
+      }
+    }
   } finally {
     try { unlinkSync(tmpFile); } catch {}
   }
@@ -1483,15 +1581,30 @@ switch (cmd) {
         process.exit(1);
       });
     } else {
-      blank();
-      fail(`Unknown command: ${B}${raw}${R}`);
-      blank();
-      console.log(`  Available commands:`);
-      console.log(`    ${CY}analyze <file>${R}   ${CY}headline "<text>"${R}   ${CY}demo${R}   ${CY}start${R}   ${CY}init${R}   ${CY}help${R}`);
-      blank();
-      console.log(`  ${D}Pass a file/directory directly: ${CY}content-grade ./my-post.md${R}`);
-      console.log(`  ${D}Run ${CY}content-grade help${R}${D} for full usage${R}`);
-      blank();
-      process.exit(1);
+      // Smart fallback: treat unrecognised input as a headline to grade.
+      // Covers: npx content-grade "Why most startups fail"
+      //         npx content-grade Why most startups fail
+      const allText = args.join(' ').trim();
+      if (allText && allText.length >= 5 && !allText.startsWith('-')) {
+        recordEvent({ event: 'command', command: 'headline_smart' });
+        cmdHeadline(allText).catch(err => {
+          blank();
+          fail(`Unexpected error: ${err.message}`);
+          blank();
+          process.exit(1);
+        });
+      } else {
+        blank();
+        fail(`Unknown command: ${B}${raw}${R}`);
+        blank();
+        console.log(`  Available commands:`);
+        console.log(`    ${CY}analyze <file>${R}   ${CY}headline "<text>"${R}   ${CY}demo${R}   ${CY}start${R}   ${CY}init${R}   ${CY}help${R}`);
+        blank();
+        console.log(`  ${D}Pass a file/directory directly: ${CY}content-grade ./my-post.md${R}`);
+        console.log(`  ${D}Grade a headline: ${CY}content-grade "Your headline text"${R}`);
+        console.log(`  ${D}Run ${CY}content-grade help${R}${D} for full usage${R}`);
+        blank();
+        process.exit(1);
+      }
     }
 }

package/bin/telemetry.js

@@ -17,8 +17,9 @@ const CONFIG_DIR   = join(homedir(), '.content-grade');
 const CONFIG_FILE  = join(CONFIG_DIR, 'config.json');
 const EVENTS_FILE  = join(CONFIG_DIR, 'events.jsonl');
 
-// Telemetry endpoint: set CONTENT_GRADE_TELEMETRY_URL to enable remote reporting
-const REMOTE_URL = process.env.CONTENT_GRADE_TELEMETRY_URL || null;
+// Telemetry endpoint: CLI events are forwarded here when telemetry is enabled.
+// Override with CONTENT_GRADE_TELEMETRY_URL env var (e.g. for self-hosted or staging).
+const REMOTE_URL = process.env.CONTENT_GRADE_TELEMETRY_URL || 'https://contentgrade.ai/api/telemetry';
 
 // ── Internal helpers ──────────────────────────────────────────────────────────