thumbgate 1.3.0 → 1.4.0

package/scripts/skill-generator.js

@@ -4,6 +4,7 @@
 const fs = require('fs');
 const path = require('path');
 const { resolveFeedbackDir } = require('./feedback-paths');
+const { ensureDir } = require('./fs-utils');
 
 const NEG = new Set(['negative', 'negative_strong', 'down', 'thumbs_down']);
 const POS = new Set(['positive', 'positive_strong', 'up', 'thumbs_up']);
@@ -38,11 +39,6 @@ function discoverFeedbackDir() {
  * Ensure a directory exists, creating it recursively if needed.
  * @param {string} dirPath
  */
-function ensureDir(dirPath) {
-  if (!fs.existsSync(dirPath)) {
-    fs.mkdirSync(dirPath, { recursive: true });
-  }
-}
 
 /**
  * Append a JSON record as a single line to a JSONL file.

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

@@ -3,6 +3,7 @@
 
 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');
@@ -59,24 +60,6 @@ function readJson(filePath, fallback) {
   }
 }
 
-function readJsonl(filePath) {
-  if (!fs.existsSync(filePath)) {
-    return [];
-  }
-  return fs.readFileSync(filePath, 'utf8')
-    .split('\n')
-    .map((line) => line.trim())
-    .filter(Boolean)
-    .map((line) => {
-      try {
-        return JSON.parse(line);
-      } catch {
-        return null;
-      }
-    })
-    .filter(Boolean);
-}
-
 function formatDateInTimezone(date, timezone = DEFAULT_TIMEZONE) {
   const formatter = new Intl.DateTimeFormat('en-CA', {
     timeZone: timezone,

package/scripts/social-analytics/pollers/linkedin.js

@@ -22,7 +22,7 @@ const LI_V2_BASE = 'https://api.linkedin.com/v2';
 function buildRestHeaders(token) {
   return {
     Authorization: `Bearer ${token}`,
-    'LinkedIn-Version': '202401',
+    'LinkedIn-Version': '202601',
     'X-Restli-Protocol-Version': '2.0.0',
   };
 }
@@ -155,20 +155,22 @@ async function fetchPostAnalytics(token, postUrn) {
 async function fetchLinkedInProfile(token) {
   if (!token) throw new Error('fetchLinkedInProfile: token is required');
 
-  const url = `${LI_V2_BASE}/me`;
-
-  const res = await fetch(url, { headers: buildV2Headers(token) });
-  if (!res.ok) {
-    const body = await res.text().catch(() => '');
-    throw new Error(`fetchLinkedInProfile HTTP ${res.status}: ${body}`);
-  }
-
-  const json = await res.json();
-  if (json.serviceErrorCode) {
-    throw new Error(`fetchLinkedInProfile API error: ${JSON.stringify(json)}`);
+  // Try /v2/userinfo first (works with openid+profile scopes), fall back to /v2/me.
+  for (const url of [`${LI_V2_BASE}/userinfo`, `${LI_V2_BASE}/me`]) {
+    const res = await fetch(url, { headers: buildV2Headers(token) });
+    if (!res.ok) {
+      const body = await res.text().catch(() => '');
+      console.warn(`[linkedin] ${url} HTTP ${res.status}: ${body.slice(0, 120)}`);
+      continue;
+    }
+    const json = await res.json();
+    if (json.serviceErrorCode) {
+      console.warn(`[linkedin] ${url} API error: ${JSON.stringify(json).slice(0, 120)}`);
+      continue;
+    }
+    return json;
   }
-
-  return json;
+  throw new Error('fetchLinkedInProfile: all endpoints failed');
 }
 
 /**
@@ -237,8 +239,16 @@ async function pollLinkedIn(db) {
 
   console.log(`[linkedin] Starting poll for ${personUrn}`);
 
-  const posts = await fetchLinkedInPosts(token, personUrn);
-  console.log(`[linkedin] Got ${posts.length} posts`);
+  let posts = [];
+  try {
+    posts = await fetchLinkedInPosts(token, personUrn);
+    console.log(`[linkedin] Got ${posts.length} posts`);
+  } catch (err) {
+    // 403 = token lacks r_member_social scope; 426 = version expired.
+    // Either way, skip posts but still collect follower count.
+    console.warn(`[linkedin] Posts fetch failed (non-fatal): ${err.message}`);
+    console.warn('[linkedin] To read posts, re-authorize with r_member_social scope.');
+  }
 
   for (const post of posts) {
     // Post URN is at post.id for the Posts API (urn:li:share:... or urn:li:ugcPost:...).

package/scripts/social-analytics/publishers/linkedin.js

@@ -22,7 +22,7 @@ const LI_REST_BASE = 'https://api.linkedin.com/rest';
 function buildHeaders(token) {
   return {
     Authorization: `Bearer ${token}`,
-    'LinkedIn-Version': '202401',
+    'LinkedIn-Version': '202601',
     'X-Restli-Protocol-Version': '2.0.0',
     'Content-Type': 'application/json',
   };

package/scripts/social-analytics/publishers/zernio.js

@@ -80,6 +80,43 @@ function requireApiKey() {
   return key;
 }
 
+class ZernioQuotaError extends Error {
+  constructor(message, details = {}) {
+    super(message);
+    this.name = 'ZernioQuotaError';
+    this.code = 'ZERNIO_POST_LIMIT_REACHED';
+    this.billingPeriod = details.billingPeriod || null;
+    this.current = Number.isFinite(details.current) ? details.current : null;
+    this.endpoint = details.endpoint || null;
+    this.limit = Number.isFinite(details.limit) ? details.limit : null;
+    this.method = details.method || null;
+    this.planName = details.planName || null;
+    this.status = details.status || null;
+  }
+}
+
+function parseZernioErrorText(errorText) {
+  if (!errorText || typeof errorText !== 'string') return null;
+  try {
+    const parsed = JSON.parse(errorText);
+    return parsed && typeof parsed === 'object' ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function isZernioQuotaError(error) {
+  return Boolean(
+    error &&
+    (error instanceof ZernioQuotaError || error.code === 'ZERNIO_POST_LIMIT_REACHED')
+  );
+}
+
+function isZernioQuotaPayload(status, payload, errorText) {
+  const message = String(payload?.error || payload?.message || errorText || '');
+  return status === 403 && /post limit reached/i.test(message);
+}
+
 function resolveAccountId(account) {
   if (!account || typeof account !== 'object') {
     return '';
@@ -176,6 +213,18 @@ async function zernioFetch(method, endpoint, body = null) {
 
   if (!res.ok) {
     const errorText = await res.text().catch(() => '');
+    const payload = parseZernioErrorText(errorText);
+    if (isZernioQuotaPayload(res.status, payload, errorText)) {
+      throw new ZernioQuotaError(payload?.error || 'Zernio post limit reached', {
+        billingPeriod: payload?.billingPeriod,
+        current: Number(payload?.current),
+        endpoint,
+        limit: Number(payload?.limit),
+        method,
+        planName: payload?.planName,
+        status: res.status,
+      });
+    }
     throw new Error(`Zernio API ${res.status} for ${method} ${endpoint}: ${errorText}`);
   }
 
@@ -434,7 +483,9 @@ module.exports = {
   buildDedupKey,
   deletePost,
   isDuplicate,
+  isZernioQuotaError,
   listPosts,
+  ZernioQuotaError,
   publishPost,
   recordPost,
   schedulePost,

package/scripts/social-pipeline.js

@@ -8,6 +8,7 @@ const net = require('net');
 const os = require('os');
 const path = require('path');
 const { pathToFileURL } = require('url');
+const { ensureDir } = require('./fs-utils');
 
 const REPO_ROOT = path.resolve(__dirname, '..');
 const DEFAULT_ASSET_HTML = path.join(
@@ -77,9 +78,6 @@ function parseArgs(argv) {
   return args;
 }
 
-function ensureDir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true });
-}
 
 function readText(filePath) {
   return fs.readFileSync(filePath, 'utf8');

package/scripts/social-post-hourly.js

@@ -25,7 +25,11 @@
 require('dotenv').config();
 
 const { generateWeeklyStatsPost } = require('./daily-digest');
-const { publishPost, getConnectedAccounts } = require('./social-analytics/publishers/zernio');
+const {
+  getConnectedAccounts,
+  isZernioQuotaError,
+  publishPost,
+} = require('./social-analytics/publishers/zernio');
 
 // Platforms that support text-only posts.
 // Reddit EXCLUDED — engagement only via reply-monitor, not auto-posting.
@@ -179,7 +183,46 @@ async function main() {
   }
 }
 
-main().catch(err => {
+function isNonFatalPostFailure(err) {
+  return isZernioQuotaError(err);
+}
+
+function handlePostFailure(err) {
+  if (isNonFatalPostFailure(err)) {
+    console.warn(`[daily-post] Skipped: ${err.message}`);
+    console.warn('[daily-post] Zernio monthly post quota reached; treating as a controlled skip.');
+    return 0;
+  }
+
   console.error('[daily-post] Fatal:', err.message);
-  process.exit(1);
-});
+  return 1;
+}
+
+function runCli({ run = main, exit = process.exit } = {}) {
+  return run().catch(err => {
+    const exitCode = handlePostFailure(err);
+    if (exitCode !== 0) {
+      exit(exitCode);
+    }
+  });
+}
+
+function isCliEntrypoint(entryModule = require.main) {
+  return Boolean(entryModule && entryModule.filename === __filename);
+}
+
+if (isCliEntrypoint()) {
+  void runCli();
+}
+
+module.exports = {
+  DAILY_ANGLES,
+  TEXT_PLATFORMS,
+  generatePost,
+  getTodayAngle,
+  handlePostFailure,
+  isCliEntrypoint,
+  isNonFatalPostFailure,
+  main,
+  runCli,
+};

package/scripts/statusline-links.js

@@ -11,6 +11,7 @@ const { getHomeDir, getRuntimeDir, resolveProjectDir } = require('./feedback-pat
 const { resolveProKey } = require('./pro-local-dashboard');
 
 const DEFAULT_ORIGIN = 'http://localhost:3456';
+const PROD_ORIGIN = 'https://thumbgate-production.up.railway.app';
 const DEFAULT_TIMEOUT_MS = 150;
 const DEFAULT_BOOT_GRACE_MS = 5000;
 const PKG_ROOT = path.join(__dirname, '..');
@@ -153,8 +154,8 @@ function buildLinkState({
       lessonsLabel: 'Lessons…',
       upLabel: '👍',
       downLabel: '👎',
-      dashboardUrl: '',
-      lessonsUrl: '',
+      dashboardUrl: `${PROD_ORIGIN}/dashboard`,
+      lessonsUrl: `${PROD_ORIGIN}/lessons`,
       upUrl: '',
       downUrl: '',
     };
@@ -163,11 +164,11 @@ function buildLinkState({
   return {
     state: canBootstrap ? 'offline' : 'unavailable',
     dashboardLabel: canBootstrap ? 'Dash: thumbgate pro' : 'Dashboard',
-    lessonsLabel: 'Learn: thumbgate lessons',
+    lessonsLabel: 'Lessons',
     upLabel: '👍',
     downLabel: '👎',
-    dashboardUrl: '',
-    lessonsUrl: '',
+    dashboardUrl: `${PROD_ORIGIN}/dashboard`,
+    lessonsUrl: `${PROD_ORIGIN}/lessons`,
     upUrl: '',
     downUrl: '',
   };

package/scripts/statusline.sh

@@ -126,13 +126,15 @@ if [ -n "$_TOWER_JSON" ]; then
   ' 2>/dev/null)"
 fi
 
-# ── Latest lesson ──────────────────────────────────────────────────
-LESSON_TEXT=""; LESSON_ID=""
+# ── Latest lesson (data available for extensions; not rendered in statusbar) ──
+LESSON_TEXT=""; LESSON_ID=""; LESSON_LABEL=""; LESSON_LINK=""
 _LESSON_JSON=$(node "${SCRIPT_DIR}/statusline-lesson.js" 2>/dev/null)
 if [ -n "$_LESSON_JSON" ]; then
   eval "$(echo "$_LESSON_JSON" | jq -r '
     @sh "LESSON_TEXT=\(.text // "")",
-    @sh "LESSON_ID=\(.lessonId // "")"
+    @sh "LESSON_ID=\(.lessonId // "")",
+    @sh "LESSON_LABEL=\(.label // "")",
+    @sh "LESSON_LINK=\(.link // "")"
   ' 2>/dev/null)"
 fi
 
@@ -144,170 +146,44 @@ case "${TREND}" in
   improving) ARROW="↗" ;; degrading) ARROW="↘" ;; stable) ARROW="→" ;; *) ARROW="?" ;;
 esac
 
-osc8_link() {
+inline_link() {
   local url="$1"
   local label="$2"
   if [ -n "$url" ]; then
-    printf '\033]8;;%s\a%s\033]8;;\a' "$url" "$label"
+    printf '%s (%s)' "$label" "$url"
   else
     printf '%s' "$label"
   fi
 }
 
-UP_ICON="$(osc8_link "$UP_URL" "👍")"
-DOWN_ICON="$(osc8_link "$DOWN_URL" "👎")"
-DASHBOARD_LINK="$(osc8_link "$DASHBOARD_URL" "$DASHBOARD_LABEL")"
-LESSONS_LINK="$(osc8_link "$LESSONS_URL" "$LESSONS_LABEL")"
-
-is_numeric() {
-  case "$1" in
-    ''|*[!0-9]*) return 1 ;;
-    *) return 0 ;;
-  esac
-}
-
-# Keep ThumbGate within a conservative left-side budget so Claude's own
-# right-side notices do not visually collide with our line.
-STATUSLINE_DEFAULT_MAX_CHARS="${THUMBGATE_STATUSLINE_DEFAULT_MAX_CHARS:-96}"
-STATUSLINE_RIGHT_RESERVE="${THUMBGATE_STATUSLINE_RIGHT_RESERVE:-28}"
-if ! is_numeric "$STATUSLINE_DEFAULT_MAX_CHARS"; then STATUSLINE_DEFAULT_MAX_CHARS=96; fi
-if ! is_numeric "$STATUSLINE_RIGHT_RESERVE"; then STATUSLINE_RIGHT_RESERVE=28; fi
-
-if is_numeric "${THUMBGATE_STATUSLINE_MAX_CHARS:-}"; then
-  STATUSLINE_MAX_CHARS="$THUMBGATE_STATUSLINE_MAX_CHARS"
-else
-  STATUSLINE_MAX_CHARS="$STATUSLINE_DEFAULT_MAX_CHARS"
-  if is_numeric "${COLUMNS:-}"; then
-    _AVAILABLE_CHARS=$(( COLUMNS - STATUSLINE_RIGHT_RESERVE ))
-    if [ "$_AVAILABLE_CHARS" -gt 0 ] && [ "$_AVAILABLE_CHARS" -lt "$STATUSLINE_MAX_CHARS" ]; then
-      STATUSLINE_MAX_CHARS="$_AVAILABLE_CHARS"
-    fi
-  fi
-fi
-if [ "$STATUSLINE_MAX_CHARS" -lt 48 ]; then STATUSLINE_MAX_CHARS=48; fi
-
-PLAIN_SEGMENTS=()
-RENDERED_SEGMENTS=()
-
-current_plain_length() {
-  local total=0
-  local i
-  for ((i = 0; i < ${#PLAIN_SEGMENTS[@]}; i++)); do
-    if [ "$i" -gt 0 ]; then
-      total=$((total + 3))
-    fi
-    total=$((total + ${#PLAIN_SEGMENTS[$i]}))
-  done
-  printf '%s' "$total"
-}
-
-push_segment() {
-  PLAIN_SEGMENTS+=("$1")
-  RENDERED_SEGMENTS+=("$2")
-}
-
-add_segment_if_fit() {
-  local plain="$1"
-  local rendered="$2"
-  local current extra
-  current=$(current_plain_length)
-  extra=${#plain}
-  if [ "${#PLAIN_SEGMENTS[@]}" -gt 0 ]; then
-    extra=$((extra + 3))
-  fi
-  if [ $((current + extra)) -le "$STATUSLINE_MAX_CHARS" ]; then
-    push_segment "$plain" "$rendered"
-    return 0
-  fi
-  return 1
-}
-
-truncate_plain_text() {
-  local text="$1"
-  local max_chars="$2"
-  if [ "$max_chars" -le 0 ]; then
-    printf ''
-  elif [ "${#text}" -le "$max_chars" ]; then
-    printf '%s' "$text"
-  elif [ "$max_chars" -le 3 ]; then
-    printf '%.*s' "$max_chars" "$text"
+UP_ICON="👍"
+DOWN_ICON="👎"
+DASHBOARD_LINK="$DASHBOARD_LABEL"
+LESSONS_LINK="$LESSONS_LABEL"
+LATEST_LESSON_LINK=""
+if [ -n "$LESSON_LABEL" ]; then
+  if [ -n "$LESSON_TEXT" ]; then
+    LATEST_LESSON_LINK="$(inline_link "$LESSON_LINK" "${LESSON_LABEL}: ${LESSON_TEXT}")"
   else
-    printf '%s...' "${text:0:$((max_chars - 3))}"
-  fi
-}
-
-add_truncated_segment_if_fit() {
-  local plain="$1"
-  local color="$2"
-  local min_chars="${3:-14}"
-  local current sep remaining truncated
-  current=$(current_plain_length)
-  sep=0
-  if [ "${#PLAIN_SEGMENTS[@]}" -gt 0 ]; then
-    sep=3
-  fi
-  remaining=$((STATUSLINE_MAX_CHARS - current - sep))
-  if [ "$remaining" -lt "$min_chars" ]; then
-    return 1
+    LATEST_LESSON_LINK="$(inline_link "$LESSON_LINK" "$LESSON_LABEL")"
   fi
-  truncated=$(truncate_plain_text "$plain" "$remaining")
-  push_segment "$truncated" "${color}${truncated}${RST}"
-  return 0
-}
-
-render_segments() {
-  local line=''
-  local i
-  for ((i = 0; i < ${#RENDERED_SEGMENTS[@]}; i++)); do
-    if [ "$i" -gt 0 ]; then
-      line="${line} · "
-    fi
-    line="${line}${RENDERED_SEGMENTS[$i]}"
-  done
-  printf '%b\n' "$line"
-}
+fi
 
 # ── Output (single line) ─────────────────────────────────────────
+LINE="ThumbGate v${TG_VERSION} · ${TG_TIER}"
 if [ "$UP" = "0" ] && [ "$DOWN" = "0" ]; then
-  push_segment "ThumbGate v${TG_VERSION}" "${D}ThumbGate v${TG_VERSION}${RST}"
-  push_segment "${TG_TIER}" "${D}${TG_TIER}${RST}"
-  push_segment "no feedback yet" "${D}no feedback yet${RST}"
-  add_segment_if_fit "${DASHBOARD_LABEL}" "${C}${DASHBOARD_LINK}${RST}"
-  add_segment_if_fit "${LESSONS_LABEL}" "${M}${LESSONS_LINK}${RST}"
-  render_segments
+  LINE="${D}${LINE} · no feedback yet${RST} · ${C}${DASHBOARD_LINK}${RST} · ${M}${LESSONS_LINK}${RST}"
+  [ -n "$LATEST_LESSON_LINK" ] && LINE="${LINE} · ${D}${LATEST_LESSON_LINK}${RST}"
+  printf '%b\n' "$LINE"
 else
-  STATS_PLAIN="${UP}👍 ${DOWN}👎 ${ARROW}"
-  STATS_RENDERED="${G}${BD}${UP}${RST}${UP_ICON} ${R}${BD}${DOWN}${RST}${DOWN_ICON} ${ARROW}"
-  ALERTS_PLAIN=''
-  ALERTS_RENDERED=''
-
-  if [ "${SLO_V:-0}" -gt 0 ]; then
-    ALERTS_PLAIN="${ALERTS_PLAIN}${ALERTS_PLAIN:+ }${SLO_V} SLO"
-    ALERTS_RENDERED="${ALERTS_RENDERED}${ALERTS_RENDERED:+ }${R}${SLO_V} SLO${RST}"
-  fi
-  if [ "${AT_RISK:-0}" -gt 0 ]; then
-    ALERTS_PLAIN="${ALERTS_PLAIN}${ALERTS_PLAIN:+ }${AT_RISK}⚠"
-    ALERTS_RENDERED="${ALERTS_RENDERED}${ALERTS_RENDERED:+ }${R}${AT_RISK}⚠${RST}"
-  fi
-  if [ "${ANOMALIES:-0}" -gt 0 ]; then
-    ALERTS_PLAIN="${ALERTS_PLAIN}${ALERTS_PLAIN:+ }${ANOMALIES}☠"
-    ALERTS_RENDERED="${ALERTS_RENDERED}${ALERTS_RENDERED:+ }${R}${ANOMALIES}☠${RST}"
-  fi
+  LINE="${LINE} · ${G}${BD}${UP}${RST}${UP_ICON} ${R}${BD}${DOWN}${RST}${DOWN_ICON} ${ARROW}"
 
-  push_segment "ThumbGate v${TG_VERSION}" "ThumbGate v${TG_VERSION}"
-  push_segment "${TG_TIER}" "${TG_TIER}"
-  push_segment "${STATS_PLAIN}" "${STATS_RENDERED}"
-  add_segment_if_fit "${DASHBOARD_LABEL}" "${C}${DASHBOARD_LINK}${RST}"
-  add_segment_if_fit "${LESSONS_LABEL}" "${M}${LESSONS_LINK}${RST}"
-  if [ "${LESSONS:-0}" -gt 0 ]; then
-    add_segment_if_fit "${LESSONS} lessons" "${M}${BD}${LESSONS}${RST} lessons"
-  fi
-  if [ -n "${ALERTS_PLAIN}" ]; then
-    add_segment_if_fit "${ALERTS_PLAIN}" "${ALERTS_RENDERED}"
-  fi
-  if [ -n "${LESSON_TEXT}" ]; then
-    add_truncated_segment_if_fit "${LESSON_TEXT}" "${D}" 14
-  fi
+  # Control Tower alerts (if any)
+  [ "${SLO_V:-0}" -gt 0 ] && LINE="${LINE} ${R}${SLO_V} SLO${RST}"
+  [ "${AT_RISK:-0}" -gt 0 ] && LINE="${LINE} ${R}${AT_RISK}⚠${RST}"
+  [ "${ANOMALIES:-0}" -gt 0 ] && LINE="${LINE} ${R}${ANOMALIES}☠${RST}"
+  LINE="${LINE} · ${C}${DASHBOARD_LINK}${RST} · ${M}${LESSONS_LINK}${RST}"
+  [ -n "$LATEST_LESSON_LINK" ] && LINE="${LINE} · ${D}${LATEST_LESSON_LINK}${RST}"
 
-  render_segments
+  printf '%b\n' "$LINE"
 fi