thumbgate 0.9.9

package/scripts/check-congruence.js

@@ -0,0 +1,322 @@
+#!/usr/bin/env node
+/**
+ * Congruence checker — ensures branding, tech stack, and version are
+ * consistent across all public-facing materials.
+ *
+ * Runs in CI on every PR. Fails if any surface is out of sync.
+ */
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  collectLocalGitHubAboutErrors,
+  compareGitHubAbout,
+  fetchLiveGitHubAbout,
+  loadGitHubAboutConfig,
+} = require('./github-about');
+const {
+  PRODUCTHUNT_URL,
+  getClaudePluginLatestDownloadUrl,
+} = require('./distribution-surfaces');
+
+const ROOT = path.join(__dirname, '..');
+
+function read(rel) {
+  const full = path.join(ROOT, rel);
+  if (!fs.existsSync(full)) return null;
+  return fs.readFileSync(full, 'utf-8');
+}
+
+async function main() {
+  const errors = [];
+  const githubAbout = loadGitHubAboutConfig(ROOT);
+
+  function check(condition, message) {
+    if (!condition) errors.push(message);
+  }
+
+  const checkLiveGitHubAbout = process.argv.includes('--check-live');
+
+  // --- Version congruence ---
+  const pkg = JSON.parse(read('package.json'));
+  const version = pkg.version;
+
+  const landingHtml = read('public/index.html') || '';
+  const guideHtml = read('public/guide.html') || '';
+  const readmeMd = read('README.md') || '';
+  const commercialTruth = read('docs/COMMERCIAL_TRUTH.md') || '';
+  const agentsMd = read('AGENTS.md') || '';
+  const claudeMd = read('CLAUDE.md') || '';
+  const geminiMd = read('GEMINI.md') || '';
+  const serverStdio = read('adapters/mcp/server-stdio.js') || '';
+  const productHuntKit = read('docs/marketing/product-hunt-launch.md') || '';
+  const claudePluginReadme = read('.claude-plugin/README.md') || '';
+  const claudeDesktopPacket = read('docs/CLAUDE_DESKTOP_EXTENSION.md') || '';
+  const latestClaudePluginUrl = getClaudePluginLatestDownloadUrl(ROOT);
+
+  check(
+    landingHtml.includes(`v${version}`),
+    `public/index.html missing version v${version} (found in package.json)`
+  );
+
+  check(
+    serverStdio.includes(`version: '${version}'`),
+    `adapters/mcp/server-stdio.js missing version '${version}'`
+  );
+
+  // --- Brand congruence: "ThumbGate" must appear in all public surfaces ---
+  const brandSurfaces = {
+    'public/index.html (nav)': landingHtml.includes('ThumbGate</a>'),
+    'public/index.html (title)': landingHtml.includes('<title>ThumbGate'),
+    'README.md (heading)': readmeMd.startsWith('# ThumbGate'),
+    'package.json (description)': pkg.description.includes('ThumbGate'),
+    'AGENTS.md': agentsMd.includes('ThumbGate'),
+    'CLAUDE.md': claudeMd.includes('ThumbGate'),
+    'GEMINI.md': geminiMd.includes('ThumbGate'),
+  };
+
+  for (const [surface, present] of Object.entries(brandSurfaces)) {
+    check(present, `Brand "ThumbGate" missing from ${surface}`);
+  }
+
+  // --- Tech stack congruence: key terms must appear in both README and landing page ---
+  const techTerms = [
+    'SQLite',
+    'FTS5',
+    'MemAlign',
+    'Thompson Sampling',
+    'LanceDB',
+    'PreToolUse',
+  ];
+
+  for (const term of techTerms) {
+    check(
+      readmeMd.includes(term),
+      `Tech term "${term}" missing from README.md`
+    );
+    check(
+      landingHtml.includes(term),
+      `Tech term "${term}" missing from public/index.html`
+    );
+  }
+
+  // --- SEO positioning terms must appear on landing page ---
+  const seoTerms = ['human-in-the-loop', 'vibe coding'];
+  for (const term of seoTerms) {
+    check(
+      landingHtml.toLowerCase().includes(term.toLowerCase()),
+      `SEO term "${term}" missing from public/index.html`
+    );
+  }
+
+  // --- FAQPage schema must exist for rich results ---
+  check(
+    landingHtml.includes('"@type": "FAQPage"'),
+    'public/index.html missing FAQPage JSON-LD schema (needed for Google rich results)'
+  );
+
+  // --- Honest disclaimer must be on both surfaces ---
+  check(
+    readmeMd.includes('does not update model weights'),
+    'README.md missing honest disclaimer ("does not update model weights")'
+  );
+  check(
+    !/<<<<<<<|=======|>>>>>>>/.test(readmeMd),
+    'README.md contains unresolved merge conflict markers'
+  );
+  check(
+    landingHtml.includes('doesn\'t touch the model') || landingHtml.includes('different from RLHF-the-concept'),
+    'public/index.html missing honest disclaimer (FAQ or inline)'
+  );
+  check(
+    /\$19\/mo/i.test(landingHtml) && /\$149\/yr/i.test(landingHtml),
+    'public/index.html must advertise the current Pro monthly and annual pricing'
+  );
+  check(
+    /\$19\/mo/i.test(guideHtml) && /\$149\/yr/i.test(guideHtml),
+    'public/guide.html must advertise the current Pro monthly and annual pricing'
+  );
+  check(
+    /\$12\/seat\/mo/i.test(guideHtml),
+    'public/guide.html must advertise the current Team pricing anchor'
+  );
+  check(
+    /Pro at \$19\/mo or \$149\/yr/i.test(commercialTruth),
+    'docs/COMMERCIAL_TRUTH.md must record the current Pro offer'
+  );
+  check(
+    /shared lessons and org visibility/i.test(githubAbout.description),
+    'config/github-about.json description must mention shared lessons and org visibility'
+  );
+  check(
+    /\$19\/mo or \$149\/yr/i.test(readmeMd),
+    'README.md must advertise the current Pro monthly and annual pricing'
+  );
+  check(
+    /\$12\/seat\/mo/i.test(readmeMd),
+    'README.md must advertise the current Team pricing anchor'
+  );
+  check(
+    /shared hosted lesson db/i.test(readmeMd),
+    'README.md must describe the shared hosted Team lesson database'
+  );
+  check(
+    /org dashboard/i.test(readmeMd),
+    'README.md must describe the Team org dashboard'
+  );
+  check(
+    /history-aware/i.test(readmeMd),
+    'README.md must mention history-aware lesson distillation'
+  );
+  check(
+    /feedback session|open_feedback_session|append_feedback_context|finalize_feedback_session/i.test(readmeMd),
+    'README.md must mention the linked feedback session flow'
+  );
+  check(
+    !/unlimited captures/i.test(readmeMd),
+    'README.md must not claim unlimited free-tier feedback captures'
+  );
+  check(
+    !/shared team db/i.test(readmeMd),
+    'README.md must not claim Pro includes a shared team DB'
+  );
+  check(
+    !/\/mo\$19/i.test(readmeMd),
+    'README.md must not contain malformed duplicated Pro pricing'
+  );
+  check(
+    !/\/mo\$19/i.test(guideHtml),
+    'public/guide.html must not contain malformed duplicated Pro pricing'
+  );
+
+  check(
+    landingHtml.includes('👍'),
+    'public/index.html must visibly include the thumbs-up icon'
+  );
+  check(
+    landingHtml.includes('👎'),
+    'public/index.html must visibly include the thumbs-down icon'
+  );
+  check(
+    /workflow-sprint-intake/.test(landingHtml),
+    'public/index.html must expose the team workflow intake path'
+  );
+  check(
+    /shared lesson db|shared lesson database/i.test(landingHtml),
+    'public/index.html must describe the shared Team lesson database'
+  );
+  check(
+    /org dashboard/i.test(landingHtml),
+    'public/index.html must describe the Team org dashboard'
+  );
+  check(
+    /personal local dashboard/i.test(landingHtml),
+    'public/index.html must keep the personal Pro dashboard message'
+  );
+  check(
+    /history-aware/i.test(landingHtml),
+    'public/index.html must mention history-aware lesson distillation'
+  );
+  check(
+    /feedback session/i.test(landingHtml),
+    'public/index.html must mention the linked feedback session flow'
+  );
+  check(
+    /unlimited feedback captures/i.test(landingHtml) && /5 lesson searches\/day/i.test(landingHtml),
+    'public/index.html must advertise the truthful free-tier capture and lesson-search limits'
+  );
+  check(
+    /5 auto-promoted gates/i.test(landingHtml),
+    'public/index.html must advertise the truthful free-tier auto-promoted gate limit'
+  );
+  check(
+    landingHtml.includes(PRODUCTHUNT_URL),
+    'public/index.html must link to the live Product Hunt listing'
+  );
+  check(
+    /Claude Desktop plugin/i.test(landingHtml),
+    'public/index.html must promote the Claude Desktop plugin install lane'
+  );
+  check(
+    /thumbs[\s-]?up/i.test(landingHtml),
+    'public/index.html must explain the thumbs-up feedback path'
+  );
+  check(
+    /thumbs[\s-]?down/i.test(landingHtml),
+    'public/index.html must explain the thumbs-down feedback path'
+  );
+  check(
+    githubAbout.description.includes('👍'),
+    'config/github-about.json description must include the thumbs-up icon'
+  );
+  check(
+    githubAbout.description.includes('👎'),
+    'config/github-about.json description must include the thumbs-down icon'
+  );
+  check(
+    /thumbs[\s-]?up/i.test(githubAbout.description),
+    'config/github-about.json description must mention thumbs-up feedback'
+  );
+  check(
+    /thumbs[\s-]?down/i.test(githubAbout.description),
+    'config/github-about.json description must mention thumbs-down feedback'
+  );
+  check(
+    /history-aware lessons/i.test(githubAbout.description),
+    'config/github-about.json description must mention history-aware lessons'
+  );
+  check(
+    productHuntKit.includes(PRODUCTHUNT_URL),
+    'docs/marketing/product-hunt-launch.md must include the live Product Hunt URL'
+  );
+  check(
+    /thumbs[\s-]?up|👍/i.test(productHuntKit),
+    'docs/marketing/product-hunt-launch.md must mention the thumbs-up path'
+  );
+  check(
+    /thumbs[\s-]?down|👎/i.test(productHuntKit),
+    'docs/marketing/product-hunt-launch.md must mention the thumbs-down path'
+  );
+  check(
+    productHuntKit.includes(latestClaudePluginUrl),
+    'docs/marketing/product-hunt-launch.md must link to the Claude plugin bundle'
+  );
+  check(
+    claudePluginReadme.includes(latestClaudePluginUrl),
+    '.claude-plugin/README.md must link to the latest Claude plugin bundle'
+  );
+  check(
+    claudeDesktopPacket.includes(latestClaudePluginUrl),
+    'docs/CLAUDE_DESKTOP_EXTENSION.md must link to the latest Claude plugin bundle'
+  );
+
+  errors.push(...collectLocalGitHubAboutErrors(ROOT));
+
+  if (checkLiveGitHubAbout) {
+    try {
+      const liveAbout = await fetchLiveGitHubAbout({ root: ROOT, repo: githubAbout.repo });
+      errors.push(...compareGitHubAbout(githubAbout, liveAbout, `Live GitHub About (${githubAbout.repo})`));
+    } catch (error) {
+      errors.push(`Unable to verify live GitHub About: ${error.message}`);
+    }
+  }
+
+  if (errors.length > 0) {
+    console.error(`\n❌ Congruence check FAILED — ${errors.length} issue(s):\n`);
+    for (const error of errors) {
+      console.error(`  • ${error}`);
+    }
+    console.error('');
+    process.exit(1);
+  }
+
+  console.log(
+    `✅ Congruence check passed — version v${version}, brand "ThumbGate", ${techTerms.length} tech terms verified across repo surfaces, GitHub About source-of-truth verified${checkLiveGitHubAbout ? ', and live GitHub metadata verified' : ''}.`
+  );
+}
+
+main().catch((error) => {
+  console.error(`\n❌ Congruence check FAILED — ${error.message}\n`);
+  process.exit(1);
+});

package/scripts/cli-feedback.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * CLI Feedback — inline thumbs up/down for the terminal.
+ *
+ * Instead of opening a browser, this echoes the lesson and process info
+ * directly to stdout. Designed to be triggered from the Claude Code
+ * statusbar or typed as a command.
+ *
+ * Usage:
+ *   node scripts/cli-feedback.js up "what worked"
+ *   node scripts/cli-feedback.js down "what went wrong"
+ */
+
+const { captureFeedback } = require('./feedback-loop');
+const { distillFromHistory } = require('./history-distiller');
+const { getRecentLesson, getLessonStats } = require('./lesson-inference');
+
+const G = '\x1b[32m';
+const R = '\x1b[31m';
+const C = '\x1b[36m';
+const M = '\x1b[35m';
+const D = '\x1b[90m';
+const BD = '\x1b[1m';
+const RST = '\x1b[0m';
+
+/**
+ * Process a thumbs up/down signal from the CLI.
+ * Captures feedback, distills a lesson, and prints everything inline.
+ *
+ * @param {Object} opts
+ * @param {string} opts.signal - 'up' or 'down'
+ * @param {string} [opts.context] - What happened
+ * @param {Array} [opts.chatHistory] - Conversation messages for distillation
+ * @param {string} [opts.whatWentWrong] - For thumbs down
+ * @param {string} [opts.whatWorked] - For thumbs up
+ * @returns {Object} Result with feedback + lesson + stats
+ */
+function processInlineFeedback({ signal, context, chatHistory, whatWentWrong, whatWorked } = {}) {
+  const isDown = signal === 'down' || signal === 'negative';
+
+  // 1. Capture the feedback
+  let feedbackResult;
+  try {
+    feedbackResult = captureFeedback({
+      signal: isDown ? 'down' : 'up',
+      context: context || (isDown ? 'Thumbs down from CLI' : 'Thumbs up from CLI'),
+      whatWentWrong: whatWentWrong || undefined,
+      whatWorked: whatWorked || undefined,
+    });
+  } catch (err) {
+    feedbackResult = { accepted: false, reason: err.message };
+  }
+
+  // 2. If thumbs down + chat history, distill a lesson
+  let distillResult = null;
+  if (isDown && Array.isArray(chatHistory) && chatHistory.length > 0) {
+    try {
+      distillResult = distillFromHistory({ chatHistory, signal: 'negative', feedbackContext: context || '' });
+    } catch { /* non-critical */ }
+  }
+
+  // 3. Get the most recent lesson and stats
+  const recentLesson = getRecentLesson();
+  const stats = getLessonStats();
+
+  return { feedbackResult, distillResult, recentLesson, stats };
+}
+
+/**
+ * Format the result for terminal output.
+ */
+function formatCliOutput(result) {
+  const lines = [];
+  const isDown = result.feedbackResult && result.feedbackResult.signal === 'negative';
+
+  // Header
+  if (result.feedbackResult && result.feedbackResult.accepted !== false) {
+    lines.push(`${isDown ? R : G}${BD}${isDown ? '👎 Thumbs down recorded' : '👍 Thumbs up recorded'}${RST}`);
+    if (result.feedbackResult.id) {
+      lines.push(`${D}  ID: ${result.feedbackResult.id}${RST}`);
+    }
+  } else {
+    lines.push(`${R}Feedback not accepted: ${(result.feedbackResult && result.feedbackResult.reason) || 'unknown'}${RST}`);
+  }
+
+  // Distilled lesson (if thumbs down)
+  if (result.distillResult) {
+    lines.push('');
+    lines.push(`${C}${BD}Lesson distilled:${RST}`);
+    lines.push(`${C}  ${result.distillResult.proposedWhatWentWrong}${RST}`);
+    if (result.distillResult.proposedRule) {
+      lines.push(`${M}  Rule: ${result.distillResult.proposedRule}${RST}`);
+      lines.push(`${D}  ${result.distillResult.ruleInstalled ? '✅ Auto-installed' : '⚠ Not auto-installed (low confidence)'}${RST}`);
+    }
+    if (result.distillResult.confirmation) {
+      lines.push(`${D}  ${result.distillResult.confirmation}${RST}`);
+    }
+  }
+
+  // Most recent lesson
+  if (result.recentLesson) {
+    lines.push('');
+    lines.push(`${D}Most recent lesson:${RST}`);
+    lines.push(`${D}  ${result.recentLesson.lesson}${RST}`);
+    lines.push(`${D}  Link: ${result.recentLesson.link}${RST}`);
+  }
+
+  // Stats
+  if (result.stats && result.stats.total > 0) {
+    lines.push('');
+    lines.push(`${D}Stats: ${result.stats.positive}👍 ${result.stats.negative}👎 · ${result.stats.total} lessons · ${result.stats.avgConfidence}% avg confidence${RST}`);
+  }
+
+  return lines.join('\n');
+}
+
+// CLI entry point
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  const signal = args[0] || 'up';
+  const context = args.slice(1).join(' ') || '';
+
+  const result = processInlineFeedback({
+    signal,
+    context,
+    whatWentWrong: signal === 'down' ? context : undefined,
+    whatWorked: signal === 'up' ? context : undefined,
+  });
+
+  process.stdout.write(formatCliOutput(result) + '\n');
+}
+
+module.exports = { processInlineFeedback, formatCliOutput };

package/scripts/cli-telemetry.js

@@ -0,0 +1,87 @@
+'use strict';
+const https = require('https');
+const os = require('os');
+const crypto = require('crypto');
+const fs = require('fs');
+const path = require('path');
+
+const TELEMETRY_ENDPOINT = 'https://thumbgate-production.up.railway.app/v1/telemetry/ping';
+const INSTALL_ID_PATH = path.join(process.env.HOME || process.env.USERPROFILE || '.', '.thumbgate', 'install-id');
+
+/**
+ * Get or create a stable anonymous install ID.
+ * This is NOT tied to any personal info — it's a random UUID stored locally.
+ */
+function getInstallId() {
+  try {
+    if (fs.existsSync(INSTALL_ID_PATH)) {
+      return fs.readFileSync(INSTALL_ID_PATH, 'utf8').trim();
+    }
+  } catch (_) {}
+
+  const id = crypto.randomUUID ? crypto.randomUUID() : crypto.randomBytes(16).toString('hex');
+  try {
+    const dir = path.dirname(INSTALL_ID_PATH);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(INSTALL_ID_PATH, id);
+  } catch (_) {}
+  return id;
+}
+
+/**
+ * Classify this install: is it Igor, CI, or a real user?
+ */
+function classifyInstall() {
+  const env = process.env;
+
+  // CI detection
+  if (env.CI || env.GITHUB_ACTIONS || env.TRAVIS || env.CIRCLECI || env.JENKINS_URL || env.GITLAB_CI || env.CODEBUILD_BUILD_ID) {
+    return 'ci';
+  }
+
+  // Igor detection (by known machine identifiers)
+  const hostname = os.hostname().toLowerCase();
+  const user = (env.USER || env.USERNAME || '').toLowerCase();
+  if (user.includes('igor') || user.includes('igorganapolsky') || hostname.includes('igors')) {
+    return 'owner';
+  }
+
+  return 'real_user';
+}
+
+/**
+ * Send anonymous telemetry ping. Fire-and-forget, never blocks CLI.
+ * Respects THUMBGATE_NO_TELEMETRY=1 opt-out.
+ */
+function trackEvent(eventType, metadata = {}) {
+  if (process.env.THUMBGATE_NO_TELEMETRY === '1' || process.env.DO_NOT_TRACK === '1') return;
+
+  const payload = JSON.stringify({
+    eventType,
+    installId: getInstallId(),
+    visitorType: classifyInstall(),
+    platform: os.platform(),
+    arch: os.arch(),
+    nodeVersion: process.version,
+    pkgVersion: (() => { try { return require('../package.json').version; } catch(_) { return 'unknown'; } })(),
+    timestamp: new Date().toISOString(),
+    ...metadata,
+  });
+
+  try {
+    const url = new URL(TELEMETRY_ENDPOINT);
+    const req = https.request({
+      hostname: url.hostname,
+      port: 443,
+      path: url.pathname,
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(payload) },
+      timeout: 3000,
+    });
+    req.on('error', () => {}); // silently ignore
+    req.on('timeout', () => req.destroy());
+    req.end(payload);
+  } catch (_) {} // never crash the CLI
+}
+
+module.exports = { trackEvent, getInstallId, classifyInstall, INSTALL_ID_PATH };