thumbgate 1.14.1 → 1.16.0

package/scripts/creator-campaigns.js

@@ -1,239 +0,0 @@
-'use strict';
-
-const { resolveHostedBillingConfig } = require('./hosted-config');
-
-const DEFAULT_TEAM_SEAT_COUNT = 3;
-const DEFAULT_TOP_CREATORS = 5;
-const CREATOR_CHANNELS = [
-  'youtube',
-  'x',
-  'linkedin',
-  'instagram',
-  'threads',
-  'tiktok',
-];
-const CREATOR_CONTENT_SHAPES = [
-  'review',
-  'workflow_teardown',
-  'before_after_demo',
-];
-
-function normalizeText(value) {
-  if (value === undefined || value === null) return '';
-  return String(value).trim();
-}
-
-function normalizeCreatorHandle(value) {
-  return normalizeText(value)
-    .replace(/^@+/, '')
-    .toLowerCase();
-}
-
-function slugify(value) {
-  return normalizeText(value)
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '');
-}
-
-function buildCreatorOfferCode(handle, motion = 'pro') {
-  const creatorCode = slugify(handle).toUpperCase() || 'CREATOR';
-  const motionCode = slugify(motion).toUpperCase() || 'PRO';
-  return `${creatorCode}-${motionCode}`;
-}
-
-function applyAttributionParams(url, attribution = {}) {
-  const params = {
-    utm_source: attribution.source,
-    utm_medium: attribution.utmMedium,
-    utm_campaign: attribution.utmCampaign,
-    utm_content: attribution.utmContent,
-    creator: attribution.creator,
-    community: attribution.community,
-    post_id: attribution.postId,
-    comment_id: attribution.commentId,
-    campaign_variant: attribution.campaignVariant,
-    offer_code: attribution.offerCode,
-  };
-
-  for (const [key, value] of Object.entries(params)) {
-    const normalized = normalizeText(value);
-    if (normalized) {
-      url.searchParams.set(key, normalized);
-    }
-  }
-  return url;
-}
-
-function buildCreatorCampaignLinks(options = {}, runtimeConfig = resolveHostedBillingConfig({
-  requestOrigin: 'https://thumbgate-production.up.railway.app',
-})) {
-  const creator = normalizeCreatorHandle(options.creator || options.handle);
-  if (!creator) {
-    throw new Error('buildCreatorCampaignLinks requires creator');
-  }
-
-  const source = slugify(options.source || options.platform || 'youtube');
-  if (!source) {
-    throw new Error('buildCreatorCampaignLinks requires source');
-  }
-
-  const campaign = slugify(options.campaign || `creator-${creator}-launch`);
-  const contentShape = slugify(options.contentShape || options.variant || 'review');
-  const community = normalizeText(options.community);
-  const postId = normalizeText(options.postId);
-  const commentId = normalizeText(options.commentId);
-  const offerCode = normalizeText(options.offerCode) || buildCreatorOfferCode(creator, options.motion || 'pro');
-  const teamSeatCount = Math.max(Number.parseInt(String(options.seatCount || DEFAULT_TEAM_SEAT_COUNT), 10) || DEFAULT_TEAM_SEAT_COUNT, DEFAULT_TEAM_SEAT_COUNT);
-
-  const attribution = {
-    creator,
-    source,
-    utmMedium: normalizeText(options.utmMedium) || 'creator_partnership',
-    utmCampaign: campaign,
-    utmContent: contentShape,
-    community,
-    postId,
-    commentId,
-    campaignVariant: contentShape,
-    offerCode,
-  };
-
-  const landingUrl = applyAttributionParams(new URL('/', runtimeConfig.appOrigin), attribution).toString();
-
-  const proCheckoutUrl = applyAttributionParams(new URL('/checkout/pro', runtimeConfig.appOrigin), attribution);
-  proCheckoutUrl.searchParams.set('cta_id', 'pricing_pro');
-  proCheckoutUrl.searchParams.set('cta_placement', 'creator_partnership');
-  proCheckoutUrl.searchParams.set('plan_id', 'pro');
-
-  const teamCheckoutUrl = applyAttributionParams(new URL('/checkout/pro', runtimeConfig.appOrigin), attribution);
-  teamCheckoutUrl.searchParams.set('cta_id', 'pricing_team');
-  teamCheckoutUrl.searchParams.set('cta_placement', 'creator_partnership');
-  teamCheckoutUrl.searchParams.set('plan_id', 'team');
-  teamCheckoutUrl.searchParams.set('billing_cycle', 'monthly');
-  teamCheckoutUrl.searchParams.set('seat_count', String(teamSeatCount));
-
-  const sprintUrl = applyAttributionParams(new URL('/', runtimeConfig.appOrigin), attribution);
-  sprintUrl.hash = 'workflow-sprint-intake';
-
-  return {
-    creator,
-    attribution,
-    links: {
-      landingUrl,
-      proCheckoutUrl: proCheckoutUrl.toString(),
-      teamCheckoutUrl: teamCheckoutUrl.toString(),
-      sprintUrl: sprintUrl.toString(),
-    },
-  };
-}
-
-function getCounterValue(counter = {}, key) {
-  return Number(counter && counter[key]) || 0;
-}
-
-function summarizeCreatorPerformance(telemetry = null, billingSummary = null, options = {}) {
-  const topN = Math.max(Number.parseInt(String(options.topN || DEFAULT_TOP_CREATORS), 10) || DEFAULT_TOP_CREATORS, 1);
-  const creators = new Set();
-  const addKeys = (counter) => {
-    for (const key of Object.keys(counter || {})) {
-      const normalized = normalizeText(key);
-      if (normalized && normalized !== 'unknown') creators.add(normalized);
-    }
-  };
-
-  addKeys(telemetry && telemetry.visitors && telemetry.visitors.byCreator);
-  addKeys(telemetry && telemetry.ctas && telemetry.ctas.byCreator);
-  addKeys(telemetry && telemetry.ctas && telemetry.ctas.checkoutStartsByCreator);
-  addKeys(billingSummary && billingSummary.attribution && billingSummary.attribution.acquisitionByCreator);
-  addKeys(billingSummary && billingSummary.attribution && billingSummary.attribution.paidByCreator);
-  addKeys(billingSummary && billingSummary.attribution && billingSummary.attribution.bookedRevenueByCreatorCents);
-  addKeys(billingSummary && billingSummary.pipeline && billingSummary.pipeline.workflowSprintLeads && billingSummary.pipeline.workflowSprintLeads.byCreator);
-  addKeys(billingSummary && billingSummary.pipeline && billingSummary.pipeline.qualifiedWorkflowSprintLeads && billingSummary.pipeline.qualifiedWorkflowSprintLeads.byCreator);
-
-  return Array.from(creators)
-    .map((creator) => {
-      const visitors = getCounterValue(telemetry && telemetry.visitors && telemetry.visitors.byCreator, creator);
-      const ctaClicks = getCounterValue(telemetry && telemetry.ctas && telemetry.ctas.byCreator, creator);
-      const checkoutStarts = getCounterValue(telemetry && telemetry.ctas && telemetry.ctas.checkoutStartsByCreator, creator);
-      const acquisitions = getCounterValue(billingSummary && billingSummary.attribution && billingSummary.attribution.acquisitionByCreator, creator);
-      const paidOrders = getCounterValue(billingSummary && billingSummary.attribution && billingSummary.attribution.paidByCreator, creator);
-      const bookedRevenueCents = getCounterValue(billingSummary && billingSummary.attribution && billingSummary.attribution.bookedRevenueByCreatorCents, creator);
-      const sprintLeads = getCounterValue(
-        billingSummary && billingSummary.pipeline && billingSummary.pipeline.workflowSprintLeads && billingSummary.pipeline.workflowSprintLeads.byCreator,
-        creator
-      );
-      const qualifiedSprintLeads = getCounterValue(
-        billingSummary && billingSummary.pipeline && billingSummary.pipeline.qualifiedWorkflowSprintLeads && billingSummary.pipeline.qualifiedWorkflowSprintLeads.byCreator,
-        creator
-      );
-      return {
-        creator,
-        visitors,
-        ctaClicks,
-        checkoutStarts,
-        acquisitions,
-        paidOrders,
-        bookedRevenueCents,
-        sprintLeads,
-        qualifiedSprintLeads,
-      };
-    })
-    .sort((left, right) => (
-      right.bookedRevenueCents - left.bookedRevenueCents ||
-      right.paidOrders - left.paidOrders ||
-      right.qualifiedSprintLeads - left.qualifiedSprintLeads ||
-      right.checkoutStarts - left.checkoutStarts ||
-      right.visitors - left.visitors ||
-      left.creator.localeCompare(right.creator)
-    ))
-    .slice(0, topN);
-}
-
-function parseArgs(argv = []) {
-  const options = {};
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (!token.startsWith('--')) continue;
-    const [key, inlineValue] = token.slice(2).split('=');
-    if (inlineValue !== undefined) {
-      options[key] = inlineValue;
-      continue;
-    }
-    const next = argv[index + 1];
-    if (next && !next.startsWith('--')) {
-      options[key] = next;
-      index += 1;
-    } else {
-      options[key] = true;
-    }
-  }
-  return options;
-}
-
-function runCli(argv = process.argv.slice(2), io = {}) {
-  const log = io.log || console.log;
-  const error = io.error || console.error;
-  const exit = io.exit || process.exit;
-  try {
-    const options = parseArgs(argv);
-    const result = buildCreatorCampaignLinks(options);
-    log(JSON.stringify(result, null, 2));
-  } catch (err) {
-    error(err.message);
-    exit(1);
-  }
-}
-
-module.exports = {
-  CREATOR_CHANNELS,
-  CREATOR_CONTENT_SHAPES,
-  buildCreatorCampaignLinks,
-  buildCreatorOfferCode,
-  normalizeCreatorHandle,
-  summarizeCreatorPerformance,
-};
-
-if (require.main === module) {
-  runCli();
-}

package/scripts/cross-encoder-reranker.js

@@ -1,235 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * Cross-Encoder Reranker for ThumbGate lesson retrieval.
- *
- * Two-stage retrieval:
- *   Stage 1: Fast candidate retrieval (existing bigram Jaccard + keyword matching)
- *   Stage 2: Cross-encoder reranking scores query-document pairs jointly
- *
- * The cross-encoder evaluates the query AND each lesson together (not independently),
- * catching false positives that keyword/vector search misses.
- *
- * Architecture reference: "Advanced RAG Retrieval: Cross-Encoders & Reranking"
- * (Towards Data Science, April 2026)
- *
- * When LLM is available (ANTHROPIC_API_KEY), uses Claude as the cross-encoder.
- * Falls back to enhanced heuristic scoring when LLM is unavailable.
- */
-
-const { retrieveRelevantLessons, scoreRelevance, buildActionSignature } = require('./lesson-retrieval');
-
-/**
- * Heuristic cross-encoder: scores a (query, document) pair jointly.
- * Unlike bi-encoder (independent embeddings), this examines the pair together
- * to find semantic relationships that keyword matching misses.
- */
-function heuristicCrossEncode(query, document) {
-  const queryLower = (query || '').toLowerCase();
-  const docLower = (document || '').toLowerCase();
-
-  let score = 0;
-
-  // 1. Exact substring containment (strongest signal)
-  if (queryLower.length > 3 && docLower.length > 3 &&
-      (docLower.includes(queryLower) || queryLower.includes(docLower))) {
-    score += 0.9;
-    return Math.min(score, 1);
-  }
-
-  // 2. Shared noun phrases (not just tokens — consecutive word pairs)
-  const queryPhrases = extractPhrases(queryLower);
-  const docPhrases = extractPhrases(docLower);
-  const phraseOverlap = queryPhrases.filter((p) => docPhrases.includes(p));
-  score += Math.min(phraseOverlap.length * 0.15, 0.5);
-
-  // 3. Semantic category matching
-  const categories = {
-    destructive: ['delete', 'remove', 'drop', 'destroy', 'wipe', 'truncate', 'rm -rf', 'force-push', 'reset --hard'],
-    git: ['git', 'push', 'pull', 'merge', 'rebase', 'branch', 'commit', 'checkout', 'stash'],
-    database: ['sql', 'query', 'table', 'migration', 'schema', 'database', 'insert', 'update', 'select'],
-    deploy: ['deploy', 'release', 'publish', 'railway', 'vercel', 'heroku', 'npm publish'],
-    security: ['secret', 'token', 'api key', 'password', 'credential', 'env', '.env', 'pem'],
-    file: ['edit', 'write', 'create', 'modify', 'config', 'package.json', 'readme'],
-  };
-
-  for (const [, terms] of Object.entries(categories)) {
-    const queryHit = terms.some((t) => queryLower.includes(t));
-    const docHit = terms.some((t) => docLower.includes(t));
-    if (queryHit && docHit) {
-      score += 0.25;
-      break; // Only count strongest category match
-    }
-  }
-
-  // 4. Action-target alignment (e.g., "git push" in query matches "push to main" in doc)
-  const queryVerbs = extractVerbs(queryLower);
-  const docVerbs = extractVerbs(docLower);
-  const verbOverlap = queryVerbs.filter((v) => docVerbs.includes(v));
-  score += Math.min(verbOverlap.length * 0.1, 0.3);
-
-  // 5. Negation alignment (both about what NOT to do)
-  const queryNegated = /\b(don'?t|never|avoid|block|prevent|stop)\b/.test(queryLower);
-  const docNegated = /\b(don'?t|never|avoid|block|prevent|stop)\b/.test(docLower);
-  if (queryNegated && docNegated) score += 0.1;
-
-  return Math.min(score, 1);
-}
-
-/**
- * LLM cross-encoder: uses Claude to score relevance of query-document pairs.
- * More accurate but requires API key and costs tokens.
- */
-async function llmCrossEncode(query, documents) {
-  const { isAvailable, callClaude, MODELS } = require('./llm-client');
-  if (!isAvailable()) return null;
-
-  const docList = documents
-    .map((d, i) => `[${i}] ${(d.title || '').slice(0, 100)} | ${(d.content || '').slice(0, 200)}`)
-    .join('\n');
-
-  const prompt = `You are a relevance scoring engine. Given a query and a list of documents, score each document's relevance to the query from 0.0 (irrelevant) to 1.0 (highly relevant).
-
-Query: "${query.slice(0, 300)}"
-
-Documents:
-${docList}
-
-Return ONLY a JSON array of scores, one per document. Example: [0.9, 0.2, 0.7, 0.1, 0.5]
-No other text.`;
-
-  try {
-    const raw = await callClaude({
-      systemPrompt: 'You are a relevance scoring engine. Return only JSON arrays of numbers.',
-      userPrompt: prompt,
-      model: MODELS.FAST,
-      maxTokens: 256,
-    });
-    const scores = JSON.parse(raw);
-    if (Array.isArray(scores) && scores.length === documents.length) {
-      return scores.map((s) => Math.max(0, Math.min(1, Number(s) || 0)));
-    }
-  } catch { /* fall back to heuristic */ }
-  return null;
-}
-
-/**
- * Two-stage retrieval with cross-encoder reranking.
- *
- * Stage 1: Retrieve top N candidates using existing keyword + bigram matching
- * Stage 2: Rerank candidates using cross-encoder (LLM or heuristic)
- * Return top K results by cross-encoder score
- */
-async function retrieveWithReranking(toolName, actionContext, options = {}) {
-  const {
-    candidateCount = 20,
-    maxResults = 5,
-    useLLM = false,
-    feedbackDir,
-  } = options;
-
-  // Stage 1: Fast candidate retrieval (existing system)
-  const candidates = retrieveRelevantLessons(toolName, actionContext, {
-    maxResults: candidateCount,
-    feedbackDir,
-  });
-
-  if (candidates.length === 0) return [];
-  if (candidates.length <= maxResults) return candidates;
-
-  const query = `${toolName || ''} ${actionContext || ''}`.trim();
-
-  // Stage 2: Cross-encoder reranking
-  let rerankedScores;
-
-  if (useLLM) {
-    rerankedScores = await llmCrossEncode(query, candidates);
-  }
-
-  // Fall back to heuristic cross-encoder if LLM unavailable or failed
-  if (!rerankedScores) {
-    rerankedScores = candidates.map((c) => {
-      const docText = `${c.title || ''} ${c.content || ''}`;
-      return heuristicCrossEncode(query, docText);
-    });
-  }
-
-  // Combine original relevance score with cross-encoder score
-  // Weight: 40% original, 60% cross-encoder (cross-encoder is more precise)
-  const reranked = candidates.map((c, i) => ({
-    ...c,
-    crossEncoderScore: rerankedScores[i],
-    combinedScore: c.relevanceScore * 0.4 + rerankedScores[i] * 0.6,
-  }));
-
-  return reranked
-    .sort((a, b) => b.combinedScore - a.combinedScore)
-    .slice(0, maxResults);
-}
-
-/**
- * Synchronous version for use in PreToolUse hooks (cannot be async).
- */
-function retrieveWithRerankingSync(toolName, actionContext, options = {}) {
-  const {
-    candidateCount = 20,
-    maxResults = 5,
-    feedbackDir,
-  } = options;
-
-  const candidates = retrieveRelevantLessons(toolName, actionContext, {
-    maxResults: candidateCount,
-    feedbackDir,
-  });
-
-  if (candidates.length === 0) return [];
-  if (candidates.length <= maxResults) return candidates;
-
-  const query = `${toolName || ''} ${actionContext || ''}`.trim();
-
-  const rerankedScores = candidates.map((c) => {
-    const docText = `${c.title || ''} ${c.content || ''}`;
-    return heuristicCrossEncode(query, docText);
-  });
-
-  const reranked = candidates.map((c, i) => ({
-    ...c,
-    crossEncoderScore: rerankedScores[i],
-    combinedScore: c.relevanceScore * 0.4 + rerankedScores[i] * 0.6,
-  }));
-
-  return reranked
-    .sort((a, b) => b.combinedScore - a.combinedScore)
-    .slice(0, maxResults);
-}
-
-// --- Utility functions ---
-
-function extractPhrases(text) {
-  const words = text.split(/\s+/).filter((w) => w.length > 2);
-  const phrases = [];
-  for (let i = 0; i < words.length - 1; i++) {
-    phrases.push(`${words[i]} ${words[i + 1]}`);
-  }
-  return phrases;
-}
-
-function extractVerbs(text) {
-  const verbPatterns = [
-    'push', 'pull', 'merge', 'delete', 'create', 'edit', 'write', 'read',
-    'deploy', 'install', 'remove', 'run', 'execute', 'build', 'test',
-    'commit', 'rebase', 'reset', 'drop', 'truncate', 'migrate', 'publish',
-    'block', 'allow', 'approve', 'deny', 'warn', 'log',
-  ];
-  return verbPatterns.filter((v) => text.includes(v));
-}
-
-module.exports = {
-  heuristicCrossEncode,
-  llmCrossEncode,
-  retrieveWithReranking,
-  retrieveWithRerankingSync,
-  extractPhrases,
-  extractVerbs,
-};

package/scripts/daemon-manager.js

@@ -1,108 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-const os = require('os');
-
-const LABEL = 'com.thumbgate.daemon';
-const PLIST_PATH = path.join(os.homedir(), 'Library', 'LaunchAgents', `${LABEL}.plist`);
-const NODE_PATH = process.execPath;
-const GATEWAY_BIN = path.join(__dirname, '..', 'bin', 'cli.js');
-const LOG_DIR = path.join(os.homedir(), '.thumbgate', 'logs');
-
-function generatePlist() {
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-    <key>Label</key>
-    <string>${LABEL}</string>
-    <key>ProgramArguments</key>
-    <array>
-        <string>${NODE_PATH}</string>
-        <string>${GATEWAY_BIN}</string>
-        <string>serve</string>
-    </array>
-    <key>RunAtLoad</key>
-    <true/>
-    <key>KeepAlive</key>
-    <dict>
-        <key>SuccessfulExit</key>
-        <false/>
-    </dict>
-    <key>StandardOutPath</key>
-    <string>${LOG_DIR}/daemon-stdout.log</string>
-    <key>StandardErrorPath</key>
-    <string>${LOG_DIR}/daemon-stderr.log</string>
-    <key>EnvironmentVariables</key>
-    <dict>
-        <key>PATH</key>
-        <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
-        <key>HOME</key>
-        <string>${os.homedir()}</string>
-    </dict>
-    <key>ThrottleInterval</key>
-    <integer>10</integer>
-</dict>
-</plist>`;
-}
-
-function manageDaemon(subCommand) {
-  switch (subCommand) {
-    case 'install': {
-      if (!fs.existsSync(LOG_DIR)) fs.mkdirSync(LOG_DIR, { recursive: true });
-      fs.writeFileSync(PLIST_PATH, generatePlist(), 'utf8');
-      try {
-        execSync(`launchctl unload "${PLIST_PATH}" 2>/dev/null`, { stdio: 'pipe' });
-      } catch { /* not loaded */ }
-      execSync(`launchctl load "${PLIST_PATH}"`, { stdio: 'inherit' });
-      console.log(`✅ Daemon installed and started: ${LABEL}`);
-      console.log(`   Plist: ${PLIST_PATH}`);
-      console.log(`   Logs:  ${LOG_DIR}/daemon-*.log`);
-      break;
-    }
-
-    case 'uninstall': {
-      try {
-        execSync(`launchctl unload "${PLIST_PATH}" 2>/dev/null`, { stdio: 'pipe' });
-      } catch { /* not loaded */ }
-      if (fs.existsSync(PLIST_PATH)) {
-        fs.unlinkSync(PLIST_PATH);
-        console.log(`✅ Daemon uninstalled: ${LABEL}`);
-      } else {
-        console.log('ℹ️  Daemon not installed');
-      }
-      break;
-    }
-
-    case 'restart': {
-      try {
-        execSync(`launchctl unload "${PLIST_PATH}" 2>/dev/null`, { stdio: 'pipe' });
-        execSync(`launchctl load "${PLIST_PATH}"`, { stdio: 'inherit' });
-        console.log(`✅ Daemon restarted: ${LABEL}`);
-      } catch (e) {
-        console.error(`❌ Restart failed: ${e.message}`);
-      }
-      break;
-    }
-
-    case 'status':
-    default: {
-      try {
-        const output = execSync(`launchctl list 2>/dev/null | grep "${LABEL}"`, { encoding: 'utf8' });
-        const parts = output.trim().split(/\s+/);
-        const pid = parts[0] === '-' ? 'idle' : `PID ${parts[0]}`;
-        const status = parts[1] === '0' ? 'OK' : `exit ${parts[1]}`;
-        console.log(`🔧 ThumbGate Daemon: ${pid} (${status})`);
-        console.log(`   Plist: ${PLIST_PATH}`);
-      } catch {
-        console.log('ℹ️  Daemon not installed. Run: thumbgate daemon install');
-      }
-      break;
-    }
-  }
-}
-
-module.exports = { manageDaemon, LABEL, PLIST_PATH };