thumbgate 1.4.2 → 1.4.4

package/scripts/social-analytics/digest.js

@@ -1,256 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const { initDb, queryMetrics, topContent, getFollowerHistory } = require('./store');
-
-const PLATFORMS = ['instagram', 'tiktok', 'github'];
-const REPO_ROOT = path.resolve(__dirname, '..', '..');
-const DEFAULT_OUTPUT_DIR = path.join(REPO_ROOT, '.artifacts', 'social', 'digests');
-
-/**
- * Formats a Date to YYYY-MM-DD in local time.
- * @param {Date} date
- * @returns {string}
- */
-function toDateString(date) {
-  return date.toISOString().slice(0, 10);
-}
-
-/**
- * Calculates the follower delta for each platform over the given window.
- * Returns the difference between the most recent snapshot and the oldest
- * snapshot within the window. Returns 0 if fewer than 2 snapshots exist.
- *
- * @param {import('better-sqlite3').Database} db
- * @param {number} days
- * @returns {{ instagram: number, tiktok: number, github: number }}
- */
-function buildFollowerDelta(db, days) {
-  const delta = {};
-  for (const platform of PLATFORMS) {
-    const history = getFollowerHistory(db, { platform, days });
-    if (history.length >= 2) {
-      delta[platform] = history[history.length - 1].follower_count - history[0].follower_count;
-    } else if (history.length === 1) {
-      delta[platform] = 0;
-    } else {
-      delta[platform] = 0;
-    }
-  }
-  return delta;
-}
-
-/**
- * Builds per-platform aggregated metrics map.
- *
- * @param {object[]} rows - Rows from queryMetrics (all platforms).
- * @returns {object}
- */
-function buildByPlatform(rows) {
-  const byPlatform = {};
-  for (const platform of PLATFORMS) {
-    const row = rows.find((r) => r.platform === platform);
-    if (row) {
-      byPlatform[platform] = {
-        post_count: row.post_count,
-        total_impressions: row.total_impressions,
-        total_reach: row.total_reach,
-        total_likes: row.total_likes,
-        total_comments: row.total_comments,
-        total_shares: row.total_shares,
-        total_saves: row.total_saves,
-        total_clicks: row.total_clicks,
-        total_video_views: row.total_video_views,
-        avg_impressions: row.avg_impressions,
-        avg_likes: row.avg_likes,
-      };
-    } else {
-      byPlatform[platform] = {
-        post_count: 0,
-        total_impressions: 0,
-        total_reach: 0,
-        total_likes: 0,
-        total_comments: 0,
-        total_shares: 0,
-        total_saves: 0,
-        total_clicks: 0,
-        total_video_views: 0,
-        avg_impressions: 0,
-        avg_likes: 0,
-      };
-    }
-  }
-  return byPlatform;
-}
-
-/**
- * Generates a weekly digest object from the SQLite database.
- *
- * @param {import('better-sqlite3').Database} db
- * @param {{ days?: number }} options
- * @returns {object} digest
- */
-function generateDigest(db, { days = 7 } = {}) {
-  const end = new Date();
-  const start = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
-
-  const allMetrics = queryMetrics(db, { days });
-  const top = topContent(db, { days, limit: 10 });
-  const followerDelta = buildFollowerDelta(db, days);
-  const byPlatform = buildByPlatform(allMetrics);
-
-  // Aggregate totals across all platforms.
-  let totalImpressions = 0;
-  let totalLikes = 0;
-  let totalComments = 0;
-  let totalShares = 0;
-
-  for (const row of allMetrics) {
-    totalImpressions += row.total_impressions || 0;
-    totalLikes += row.total_likes || 0;
-    totalComments += row.total_comments || 0;
-    totalShares += row.total_shares || 0;
-  }
-
-  const engagementRaw =
-    totalImpressions > 0
-      ? (((totalLikes + totalComments + totalShares) / totalImpressions) * 100).toFixed(1)
-      : '0.0';
-
-  const topContent_ = top.map((row) => ({
-    platform: row.platform,
-    post_id: row.post_id,
-    post_url: row.post_url || null,
-    total_engagement: row.total_engagement,
-    impressions: row.total_impressions,
-  }));
-
-  return {
-    period: {
-      start: toDateString(start),
-      end: toDateString(end),
-    },
-    summary: {
-      total_impressions: totalImpressions,
-      total_likes: totalLikes,
-      total_comments: totalComments,
-      total_shares: totalShares,
-      engagement_rate: `${engagementRaw}%`,
-      follower_delta: followerDelta,
-    },
-    by_platform: byPlatform,
-    top_content: topContent_,
-  };
-}
-
-/**
- * Converts a digest object to a readable markdown string.
- *
- * @param {object} digest
- * @returns {string}
- */
-function renderDigestMarkdown(digest) {
-  const { period, summary, by_platform, top_content } = digest;
-
-  const lines = [];
-
-  lines.push(`# Weekly Social Digest: ${period.start} → ${period.end}`);
-  lines.push('');
-  lines.push('## Summary');
-  lines.push('');
-  lines.push(`| Metric | Value |`);
-  lines.push(`|--------|-------|`);
-  lines.push(`| Total Impressions | ${summary.total_impressions.toLocaleString()} |`);
-  lines.push(`| Total Likes | ${summary.total_likes.toLocaleString()} |`);
-  lines.push(`| Total Comments | ${summary.total_comments.toLocaleString()} |`);
-  lines.push(`| Total Shares | ${summary.total_shares.toLocaleString()} |`);
-  lines.push(`| Engagement Rate | ${summary.engagement_rate} |`);
-  lines.push('');
-  lines.push('### Follower Delta');
-  lines.push('');
-  lines.push(`| Platform | Change |`);
-  lines.push(`|----------|--------|`);
-  for (const [platform, delta] of Object.entries(summary.follower_delta)) {
-    const sign = delta >= 0 ? '+' : '';
-    lines.push(`| ${platform} | ${sign}${delta} |`);
-  }
-
-  lines.push('');
-  lines.push('## By Platform');
-  lines.push('');
-
-  for (const [platform, stats] of Object.entries(by_platform)) {
-    lines.push(`### ${platform.charAt(0).toUpperCase() + platform.slice(1)}`);
-    lines.push('');
-    lines.push(`| Metric | Value |`);
-    lines.push(`|--------|-------|`);
-    lines.push(`| Posts | ${stats.post_count} |`);
-    lines.push(`| Impressions | ${stats.total_impressions.toLocaleString()} |`);
-    lines.push(`| Reach | ${stats.total_reach.toLocaleString()} |`);
-    lines.push(`| Likes | ${stats.total_likes.toLocaleString()} |`);
-    lines.push(`| Comments | ${stats.total_comments.toLocaleString()} |`);
-    lines.push(`| Shares | ${stats.total_shares.toLocaleString()} |`);
-    lines.push(`| Saves | ${stats.total_saves.toLocaleString()} |`);
-    lines.push(`| Clicks | ${stats.total_clicks.toLocaleString()} |`);
-    lines.push(`| Video Views | ${stats.total_video_views.toLocaleString()} |`);
-    lines.push('');
-  }
-
-  lines.push('## Top Content');
-  lines.push('');
-
-  if (top_content.length === 0) {
-    lines.push('_No content recorded in this period._');
-  } else {
-    lines.push(`| # | Platform | Post ID | Engagement | Impressions | URL |`);
-    lines.push(`|---|----------|---------|------------|-------------|-----|`);
-    top_content.forEach((item, idx) => {
-      const url = item.post_url ? `[link](${item.post_url})` : '—';
-      lines.push(
-        `| ${idx + 1} | ${item.platform} | ${item.post_id} | ${item.total_engagement} | ${item.impressions.toLocaleString()} | ${url} |`
-      );
-    });
-  }
-
-  lines.push('');
-  lines.push(`_Generated at ${new Date().toISOString()}_`);
-
-  return lines.join('\n');
-}
-
-/**
- * Writes digest.json and digest.md to the given output directory.
- *
- * @param {object} digest
- * @param {string} outputDir
- * @returns {{ jsonPath: string, mdPath: string }}
- */
-function writeDigest(digest, outputDir) {
-  fs.mkdirSync(outputDir, { recursive: true });
-
-  const jsonPath = path.join(outputDir, 'digest.json');
-  const mdPath = path.join(outputDir, 'digest.md');
-
-  fs.writeFileSync(jsonPath, JSON.stringify(digest, null, 2), 'utf8');
-  fs.writeFileSync(mdPath, renderDigestMarkdown(digest), 'utf8');
-
-  return { jsonPath, mdPath };
-}
-
-module.exports = {
-  generateDigest,
-  renderDigestMarkdown,
-  writeDigest,
-};
-
-// Run as main: generate and write a 7-day digest.
-if (require.main === module) {
-  const db = initDb();
-  const digest = generateDigest(db, { days: 7 });
-  const { jsonPath, mdPath } = writeDigest(digest, DEFAULT_OUTPUT_DIR);
-  console.log(`Digest written:\n  JSON: ${jsonPath}\n  MD:   ${mdPath}`);
-  console.log(`\nSummary: ${JSON.stringify(digest.summary, null, 2)}`);
-  db.close();
-}

package/scripts/social-analytics/engagement-audit.js

@@ -1,185 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-const { readJsonl } = require('../fs-utils');
-
-const REPO_ROOT = path.resolve(__dirname, '..', '..');
-const DEFAULT_REPLY_STATE_PATH = path.join(REPO_ROOT, '.thumbgate', 'reply-monitor-state.json');
-const DEFAULT_DRAFTS_PATH = path.join(REPO_ROOT, '.thumbgate', 'reply-drafts.jsonl');
-const DEFAULT_LAUNCH_ASSETS_PATH = path.join(REPO_ROOT, '.thumbgate', 'social-launch-assets.json');
-const DEFAULT_TIMEZONE = 'America/New_York';
-
-const PLATFORM_CAPABILITIES = {
-  x: 'active_reply_monitor',
-  reddit: 'draft_only_reply_monitor',
-  linkedin: 'comment_intake_blocked_by_api_approval',
-  instagram: 'no_comment_intake_implemented',
-  tiktok: 'no_comment_intake_implemented',
-  youtube: 'no_comment_intake_implemented',
-  devto: 'no_comment_intake_implemented',
-};
-
-function parseArgs(argv = []) {
-  const options = {
-    date: '',
-    timezone: DEFAULT_TIMEZONE,
-    replyStatePath: DEFAULT_REPLY_STATE_PATH,
-    draftsPath: DEFAULT_DRAFTS_PATH,
-    launchAssetsPath: DEFAULT_LAUNCH_ASSETS_PATH,
-  };
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = String(argv[index] || '').trim();
-    if (token.startsWith('--date=')) {
-      options.date = token.slice('--date='.length).trim();
-      continue;
-    }
-    if (token === '--date' && argv[index + 1]) {
-      options.date = String(argv[index + 1]).trim();
-      index += 1;
-      continue;
-    }
-    if (token.startsWith('--timezone=')) {
-      options.timezone = token.slice('--timezone='.length).trim() || DEFAULT_TIMEZONE;
-    }
-  }
-
-  return options;
-}
-
-function readJson(filePath, fallback) {
-  try {
-    if (!fs.existsSync(filePath)) {
-      return fallback;
-    }
-    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-  } catch {
-    return fallback;
-  }
-}
-
-function formatDateInTimezone(date, timezone = DEFAULT_TIMEZONE) {
-  const formatter = new Intl.DateTimeFormat('en-CA', {
-    timeZone: timezone,
-    year: 'numeric',
-    month: '2-digit',
-    day: '2-digit',
-  });
-  return formatter.format(new Date(date));
-}
-
-function buildPlatformSummary() {
-  return {
-    checked: 0,
-    replied: 0,
-    drafted: 0,
-    skipped: 0,
-    skippedOwnTweet: 0,
-    skippedNoReplyGenerated: 0,
-    capability: '',
-    ownedLaunchAssets: 0,
-  };
-}
-
-function buildEngagementAudit(options = {}) {
-  const timezone = options.timezone || DEFAULT_TIMEZONE;
-  const targetDate = options.date || formatDateInTimezone(new Date(), timezone);
-  const replyState = readJson(options.replyStatePath || DEFAULT_REPLY_STATE_PATH, { repliedTo: {}, lastCheck: {} });
-  const drafts = readJsonl(options.draftsPath || DEFAULT_DRAFTS_PATH);
-  const launchAssets = readJson(options.launchAssetsPath || DEFAULT_LAUNCH_ASSETS_PATH, { launchPosts: {}, campaignPosts: {} });
-
-  const platforms = {
-    x: buildPlatformSummary(),
-    reddit: buildPlatformSummary(),
-    linkedin: buildPlatformSummary(),
-    instagram: buildPlatformSummary(),
-    tiktok: buildPlatformSummary(),
-    youtube: buildPlatformSummary(),
-    devto: buildPlatformSummary(),
-  };
-
-  for (const [platform, capability] of Object.entries(PLATFORM_CAPABILITIES)) {
-    platforms[platform].capability = capability;
-  }
-
-  for (const entry of Object.values(replyState.repliedTo || {})) {
-    const platform = String(entry.platform || '').trim().toLowerCase();
-    if (!platforms[platform]) continue;
-    if (formatDateInTimezone(entry.at, timezone) !== targetDate) continue;
-    platforms[platform].checked += 1;
-    if (entry.drafted) {
-      platforms[platform].drafted += 1;
-      continue;
-    }
-    if (entry.skipped) {
-      platforms[platform].skipped += 1;
-      if (entry.skipped === 'own_tweet') {
-        platforms[platform].skippedOwnTweet += 1;
-      }
-      if (entry.skipped === 'no_reply_generated') {
-        platforms[platform].skippedNoReplyGenerated += 1;
-      }
-      continue;
-    }
-    platforms[platform].replied += 1;
-  }
-
-  for (const draft of drafts) {
-    const platform = String(draft.platform || '').trim().toLowerCase();
-    if (!platforms[platform]) continue;
-    if (formatDateInTimezone(draft.draftedAt, timezone) !== targetDate) continue;
-    platforms[platform].drafted += 1;
-  }
-
-  for (const platform of Object.keys(launchAssets.launchPosts || {})) {
-    if (platforms[platform]) {
-      platforms[platform].ownedLaunchAssets += 1;
-    }
-  }
-  for (const byPlatform of Object.values(launchAssets.campaignPosts || {})) {
-    for (const platform of Object.keys(byPlatform || {})) {
-      if (platforms[platform]) {
-        platforms[platform].ownedLaunchAssets += 1;
-      }
-    }
-  }
-
-  const totals = Object.values(platforms).reduce((acc, platform) => {
-    acc.checked += platform.checked;
-    acc.replied += platform.replied;
-    acc.drafted += platform.drafted;
-    acc.skipped += platform.skipped;
-    return acc;
-  }, { checked: 0, replied: 0, drafted: 0, skipped: 0 });
-
-  return {
-    date: targetDate,
-    timezone,
-    totals,
-    platforms,
-    evidence: {
-      replyStatePath: options.replyStatePath || DEFAULT_REPLY_STATE_PATH,
-      draftsPath: options.draftsPath || DEFAULT_DRAFTS_PATH,
-      launchAssetsPath: options.launchAssetsPath || DEFAULT_LAUNCH_ASSETS_PATH,
-    },
-  };
-}
-
-if (require.main === module) {
-  const audit = buildEngagementAudit(parseArgs(process.argv.slice(2)));
-  process.stdout.write(`${JSON.stringify(audit, null, 2)}\n`);
-}
-
-module.exports = {
-  DEFAULT_DRAFTS_PATH,
-  DEFAULT_LAUNCH_ASSETS_PATH,
-  DEFAULT_REPLY_STATE_PATH,
-  DEFAULT_TIMEZONE,
-  PLATFORM_CAPABILITIES,
-  buildEngagementAudit,
-  formatDateInTimezone,
-  parseArgs,
-  readJsonl,
-};

package/scripts/social-analytics/generate-instagram-card.js

@@ -1,97 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * generate-instagram-card.js
- * Creates a 1080x1080 ThumbGate Instagram card using sharp.
- *
- * Usage:
- *   node generate-instagram-card.js [--output=path/to/output.png]
- *
- * Output: .thumbgate/instagram-card.png (default)
- */
-
-const fs = require('fs');
-const path = require('path');
-let sharp;
-try { sharp = require('sharp'); } catch { /* optional dependency */ }
-
-const REPO_ROOT = path.resolve(__dirname, '../..');
-const DEFAULT_OUTPUT = path.join(REPO_ROOT, '.thumbgate', 'instagram-card.png');
-
-async function generateInstagramCard(outputPath = DEFAULT_OUTPUT) {
-  const width = 1080;
-  const height = 1080;
-
-  // Create SVG markup for the card
-  const svg = `
-    <svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
-      <!-- Background -->
-      <rect width="${width}" height="${height}" fill="#0d1117"/>
-
-      <!-- Main heading -->
-      <text x="${width / 2}" y="400" font-size="72" font-weight="bold" text-anchor="middle" fill="#ffffff" font-family="Arial, sans-serif">
-        Your AI agent
-      </text>
-      <text x="${width / 2}" y="490" font-size="72" font-weight="bold" text-anchor="middle" fill="#ffffff" font-family="Arial, sans-serif">
-        has amnesia.
-      </text>
-
-      <!-- Subheading -->
-      <text x="${width / 2}" y="620" font-size="48" text-anchor="middle" fill="#888888" font-family="Arial, sans-serif">
-        Give it memory that
-      </text>
-      <text x="${width / 2}" y="680" font-size="48" text-anchor="middle" fill="#888888" font-family="Arial, sans-serif">
-        survives restarts.
-      </text>
-
-      <!-- Brand -->
-      <text x="${width / 2}" y="950" font-size="56" font-weight="bold" text-anchor="middle" fill="#00d9ff" font-family="Arial, sans-serif">
-        ThumbGate
-      </text>
-    </svg>
-  `;
-
-  if (!sharp) {
-    throw new Error('sharp is not installed. Run: npm install sharp');
-  }
-
-  try {
-    // Ensure output directory exists
-    const outputDir = path.dirname(outputPath);
-    if (!fs.existsSync(outputDir)) {
-      fs.mkdirSync(outputDir, { recursive: true });
-    }
-
-    // Generate PNG from SVG
-    await sharp(Buffer.from(svg))
-      .png()
-      .toFile(outputPath);
-
-    console.log(`✅ Instagram card generated: ${outputPath}`);
-    console.log(`   Size: 1080x1080 PNG`);
-    console.log(`   File size: ${fs.statSync(outputPath).size} bytes`);
-    return outputPath;
-  } catch (err) {
-    console.error(`❌ Image generation failed: ${err.message}`);
-    throw err;
-  }
-}
-
-// CLI execution
-if (require.main === module) {
-  const args = process.argv.slice(2);
-  const outputArg = args.find((a) => a.startsWith('--output='));
-  const outputPath = outputArg ? outputArg.slice(9) : DEFAULT_OUTPUT;
-
-  (async () => {
-    try {
-      await generateInstagramCard(outputPath);
-      process.exit(0);
-    } catch (err) {
-      process.exit(1);
-    }
-  })();
-}
-
-module.exports = { generateInstagramCard, DEFAULT_OUTPUT };

package/scripts/social-analytics/instagram-thumbgate-post.js

@@ -1,111 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * instagram-thumbgate-post.js
- * Posts ThumbGate Instagram card and caption via Zernio API.
- *
- * Usage:
- *   node instagram-thumbgate-post.js [--image-path=path/to/image.png]
- */
-
-const path = require('path');
-const {
-  publishPost,
-  schedulePost,
-  getConnectedAccounts,
-  uploadLocalMedia,
-} = require('./publishers/zernio');
-
-const THUMBGATE_CAPTION = `Your AI coding agent has amnesia. It forgets everything between sessions.
-
-ThumbGate gives it memory that survives restarts. Thumbs-down a mistake → it becomes a prevention rule → the agent can't repeat it.
-
-One command: npx thumbgate init
-
-Works with Claude Code, Cursor, Codex, Gemini.
-
-#AIAgents #DeveloperTools #ClaudeCode #ThumbGate`;
-
-async function postThumbGateToInstagram(options = {}) {
-  const caption = String(options.caption || THUMBGATE_CAPTION).trim();
-  const imagePath = options.imagePath ? path.resolve(options.imagePath) : '';
-  const schedule = String(options.schedule || '').trim();
-  const timezone = String(options.timezone || 'America/New_York').trim() || 'America/New_York';
-
-  try {
-    console.log('[instagram] Fetching Zernio connected accounts...');
-    const accounts = await getConnectedAccounts();
-
-    // Find Instagram account
-    const instagramAccount = accounts.find((a) => a.platform === 'instagram');
-    if (!instagramAccount) {
-      throw new Error('No Instagram account found in Zernio. Please connect Instagram first.');
-    }
-
-    console.log(`[instagram] Found Instagram account: ${instagramAccount.accountId}`);
-
-    const platforms = [
-      {
-        platform: 'instagram',
-        accountId: instagramAccount.accountId,
-      },
-    ];
-
-    if (!imagePath) {
-      throw new Error('Instagram posts require an imagePath because Zernio requires media content for Instagram posts.');
-    }
-
-    console.log(`[instagram] Uploading Instagram media from ${imagePath}...`);
-    const mediaItem = await uploadLocalMedia(imagePath);
-
-    const publishOptions = {
-      mediaItems: [mediaItem],
-      utm: options.utm,
-    };
-
-    let result;
-    if (schedule) {
-      console.log(`[instagram] Scheduling Instagram post for ${schedule} (${timezone})...`);
-      result = await schedulePost(caption, platforms, schedule, timezone, publishOptions);
-    } else {
-      console.log('[instagram] Publishing ThumbGate caption to Instagram...');
-      result = await publishPost(caption, platforms, publishOptions);
-    }
-    if (result && result.blocked) {
-      const reasons = Array.isArray(result.reasons)
-        ? result.reasons.map((reason) => reason.reason || reason.id || String(reason)).join(', ')
-        : 'quality gate blocked the caption';
-      throw new Error(`Instagram post blocked: ${reasons}`);
-    }
-
-    if (schedule) {
-      console.log('✅ Instagram post scheduled successfully!');
-    } else {
-      console.log('✅ Post published successfully!');
-    }
-    console.log(`Post ID: ${result.id || result.data?.id || 'unknown'}`);
-    return result;
-  } catch (err) {
-    console.error(`❌ Failed to post to Instagram: ${err.message}`);
-    throw err;
-  }
-}
-
-// CLI execution
-if (require.main === module) {
-  const args = process.argv.slice(2);
-  const imageArg = args.find((arg) => arg.startsWith('--image-path='));
-  const imagePath = imageArg ? imageArg.slice('--image-path='.length) : '';
-
-  (async () => {
-    try {
-      await postThumbGateToInstagram({ imagePath });
-      process.exit(0);
-    } catch (err) {
-      process.exit(1);
-    }
-  })();
-}
-
-module.exports = { postThumbGateToInstagram, THUMBGATE_CAPTION };