claude-rpc 0.3.10 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-rpc",
-  "version": "0.3.10",
+  "version": "0.5.0",
   "description": "Discord Rich Presence for Claude Code — live model, project, tokens, and lifetime stats driven by Claude Code's hook system.",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,8 @@
     "build:exe": "node ./scripts/build-exe.js",
     "prep:dashboard": "node ./scripts/prep-dashboard.js",
     "dist:mac": "npm run build:exe && npm run prep:dashboard && npm --prefix dashboard run dist:mac",
-    "dist:win": "npm run build:exe && npm run prep:dashboard && npm --prefix dashboard run dist:win"
+    "dist:win": "npm run build:exe && npm run prep:dashboard && npm --prefix dashboard run dist:win",
+    "test": "node --test test/*.test.js"
   },
   "dependencies": {
     "@xhayper/discord-rpc": "^1.2.1"

package/src/badge.js

@@ -14,11 +14,26 @@ const COLORS = {
   files:  { left: '#555', right: '#aa6' },     // olive
 };
 
+// Resolve a range token to a count of days back from today.
+//   'all'                → entire history
+//   'year' / 'y'         → 365 days
+//   'month' / 'mo' / 'm' → 30 days
+//   'week' / 'w'         → 7 days
+//   numeric ('30d', '7') → that many days
+function rangeToDays(range) {
+  if (!range || range === 'all') return null;             // null = unbounded
+  if (/^(year|1y|y|365d?)$/i.test(range)) return 365;
+  if (/^(month|1mo|mo|m|30d?)$/i.test(range)) return 30;
+  if (/^(week|1w|w|7d?)$/i.test(range)) return 7;
+  if (/^(day|1d|d|24h|today)$/i.test(range)) return 1;
+  const n = parseInt(range, 10);
+  return Number.isFinite(n) && n > 0 ? n : null;
+}
+
 function pickWindow(byDay, range) {
   if (!byDay) return [];
-  if (range === 'all') return Object.entries(byDay);
-  const days = parseInt(range, 10);
-  if (!Number.isFinite(days) || days <= 0) return Object.entries(byDay);
+  const days = rangeToDays(range);
+  if (days === null) return Object.entries(byDay);          // 'all'
   const today = new Date(); today.setHours(0, 0, 0, 0);
   const out = [];
   for (let i = 0; i < days; i++) {
@@ -29,6 +44,20 @@ function pickWindow(byDay, range) {
   return out;
 }
 
+// Pretty label for a range — used as badge subtitle.
+//   'year' → 'year'   '30' → '30d'   'all' → 'all-time'
+function rangeLabel(range) {
+  if (!range || range === 'all') return 'all-time';
+  if (/^(year|1y|y|365d?)$/i.test(range)) return 'year';
+  if (/^(month|1mo|mo|m|30d?)$/i.test(range)) return 'month';
+  if (/^(week|1w|w|7d?)$/i.test(range)) return 'week';
+  if (/^(day|1d|d|24h|today)$/i.test(range)) return 'today';
+  const n = parseInt(range, 10);
+  return Number.isFinite(n) && n > 0 ? `${n}d` : range;
+}
+
+export { rangeToDays, rangeLabel, pickWindow };
+
 function fmtHoursLabel(ms) {
   if (!ms) return '0h';
   const h = ms / 3_600_000;
@@ -49,34 +78,33 @@ function fmtNum(n) {
 function valueFor(aggregate, metric, range) {
   const a = aggregate || {};
   const window = pickWindow(a.byDay, range);
-
-  const rangeLabel = range === 'all' ? 'all-time' : range;
+  const rl = rangeLabel(range);
 
   switch (metric) {
     case 'hours': {
       const ms = window.reduce((s, [, d]) => s + (d.activeMs || 0), 0);
-      return { label: `claude · ${rangeLabel}`, value: fmtHoursLabel(ms) };
+      return { label: `claude · ${rl}`, value: fmtHoursLabel(ms) };
     }
     case 'streak': {
       return { label: 'streak', value: `${a.streak || 0} days` };
     }
     case 'cost': {
       const cost = window.reduce((s, [, d]) => s + (d.cost || 0), 0);
-      return { label: `claude cost · ${rangeLabel}`, value: fmtCost(cost) };
+      return { label: `claude cost · ${rl}`, value: fmtCost(cost) };
     }
     case 'lines': {
       const lines = window.reduce((s, [, d]) => s + (d.linesAdded || 0), 0);
-      return { label: `lines · ${rangeLabel}`, value: fmtNum(lines) };
+      return { label: `lines · ${rl}`, value: fmtNum(lines) };
     }
     case 'prompts': {
       const p = window.reduce((s, [, d]) => s + (d.userMessages || 0), 0);
-      return { label: `prompts · ${rangeLabel}`, value: fmtNum(p) };
+      return { label: `prompts · ${rl}`, value: fmtNum(p) };
     }
     case 'tokens': {
       const t = window.reduce((s, [, d]) =>
         s + (d.inputTokens || 0) + (d.outputTokens || 0)
         + (d.cacheReadTokens || 0) + (d.cacheWriteTokens || 0), 0);
-      return { label: `tokens · ${rangeLabel}`, value: fmtNum(t) };
+      return { label: `tokens · ${rl}`, value: fmtNum(t) };
     }
     case 'files': {
       return { label: 'files touched', value: fmtNum(a.uniqueFiles || 0) };

package/src/card.js

@@ -0,0 +1,344 @@
+// Poster-style SVG card — designed to be screenshotted and shared.
+//
+// Renders an 880×540 magazine-style summary for a given range:
+//   year on claude  /  month on claude  /  week on claude  /  all-time
+//
+// Stats: total hours, prompts, tokens, lines added, cost, top language,
+// top file, longest streak, top weekday, peak hour. Visual style matches
+// the indie cream-paper landing page — same palette, same monospace +
+// display-font split.
+//
+// Output is SVG only (no PNG dep). Modern Discord / GitHub render the SVG
+// inline; for hard-copy sharing, screenshot or convert via any web tool.
+
+import { dayKey } from './scanner.js';
+import { fmtCost } from './pricing.js';
+import { rangeToDays, rangeLabel, pickWindow } from './badge.js';
+
+const W = 880;
+const H = 540;
+
+const PALETTE = {
+  paper: '#f4ede0',
+  paper2: '#ebe2d2',
+  paper3: '#e1d6c0',
+  paper4: '#d6c8ac',
+  ink:    '#1a1611',
+  inkSoft:'#2d2520',
+  inkMute:'#5c5147',
+  inkFaint:'#8a7c6d',
+  rust:   '#c2491e',
+  rust3:  '#f08a4a',
+  tape:   '#f2d76e',
+  grass:  '#4a9462',
+  blurple:'#5865f2',
+};
+
+const WEEKDAY = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+
+function escapeXml(s) {
+  return String(s == null ? '' : s)
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+function fmtNum(n) {
+  if (!n) return '0';
+  if (n < 1000) return String(Math.round(n));
+  if (n < 1_000_000) return `${(n / 1000).toFixed(1)}k`;
+  if (n < 1_000_000_000) return `${(n / 1_000_000).toFixed(2)}M`;
+  return `${(n / 1_000_000_000).toFixed(2)}B`;
+}
+
+function fmtHours(ms) {
+  if (!ms || ms < 0) return '0h';
+  const h = ms / 3_600_000;
+  if (h < 1) return `${Math.round(h * 60)}m`;
+  if (h < 10) return `${h.toFixed(1)}h`;
+  return `${Math.round(h)}h`;
+}
+
+function rangeTitle(range) {
+  const rl = rangeLabel(range);
+  if (rl === 'all-time') return 'on claude';
+  return `${rl} on claude`;
+}
+
+// Roll up a windowed metric across the active range.
+function rollup(aggregate, range) {
+  const window = pickWindow(aggregate?.byDay, range);
+  const out = {
+    activeMs: 0,
+    userMessages: 0,
+    toolCalls: 0,
+    tokens: 0,
+    linesAdded: 0,
+    linesRemoved: 0,
+    cost: 0,
+    sessions: 0,
+    days: 0,
+    daysActive: 0,
+  };
+  for (const [, d] of window) {
+    out.days += 1;
+    if ((d.activeMs || 0) > 0) out.daysActive += 1;
+    out.activeMs += d.activeMs || 0;
+    out.userMessages += d.userMessages || 0;
+    out.toolCalls += d.toolCalls || 0;
+    out.tokens += (d.inputTokens || 0) + (d.outputTokens || 0)
+                + (d.cacheReadTokens || 0) + (d.cacheWriteTokens || 0);
+    out.linesAdded += d.linesAdded || 0;
+    out.linesRemoved += d.linesRemoved || 0;
+    out.cost += d.cost || 0;
+    out.sessions += d.sessions || 0;
+  }
+  return out;
+}
+
+// Best weekday by active time, computed from byWeekday on the aggregate.
+function topWeekday(aggregate) {
+  const wd = aggregate?.byWeekday || {};
+  let best = null;
+  for (const [k, v] of Object.entries(wd)) {
+    if (!best || (v.activeMs || 0) > (best.ms || 0)) best = { day: Number(k), ms: v.activeMs || 0 };
+  }
+  return best;
+}
+
+// Top language by edits.
+function topLanguage(aggregate) {
+  const langs = aggregate?.languages || {};
+  let best = null;
+  for (const [name, v] of Object.entries(langs)) {
+    if (!best || (v.edits || 0) > (best.edits || 0)) best = { name, edits: v.edits || 0 };
+  }
+  return best;
+}
+
+// Top edited file (basename only — full path would overflow).
+function topFile(aggregate) {
+  const list = aggregate?.topEditedFiles || [];
+  if (!list.length) return null;
+  const top = list[0];
+  const p = String(top.path || '').replace(/\\/g, '/');
+  const name = p.split('/').pop() || p;
+  return { name, count: top.count };
+}
+
+// Compute peak hour-of-day (24h clock).
+function peakHourLabel(aggregate) {
+  const ph = aggregate?.peakHour;
+  if (!ph || ph.hour == null) return null;
+  const h = Number(ph.hour);
+  return `${String(h).padStart(2, '0')}:00`;
+}
+
+// ── SVG building blocks ─────────────────────────────────────────────────
+
+function paperDefs() {
+  return `
+  <defs>
+    <pattern id="dotgrid" width="22" height="22" patternUnits="userSpaceOnUse">
+      <circle cx="1" cy="1" r="1" fill="${PALETTE.ink}" opacity="0.07"/>
+    </pattern>
+    <filter id="noise" x="0" y="0" width="100%" height="100%">
+      <feTurbulence type="fractalNoise" baseFrequency="0.95" numOctaves="2" stitchTiles="stitch"/>
+      <feColorMatrix values="0 0 0 0 0  0 0 0 0 0  0 0 0 0 0  0 0 0 0.05 0"/>
+    </filter>
+  </defs>`;
+}
+
+function background() {
+  return `
+  <rect width="${W}" height="${H}" fill="${PALETTE.paper}"/>
+  <rect width="${W}" height="${H}" fill="url(#dotgrid)"/>
+  <rect width="${W}" height="${H}" filter="url(#noise)" opacity="0.6"/>`;
+}
+
+function tapeSticker(x, y, text, { rotate = -2, bg = PALETTE.tape, fg = PALETTE.ink } = {}) {
+  const pad = 12;
+  const fontSize = 14;
+  const w = text.length * 8.4 + pad * 2;
+  const h = fontSize + 12;
+  return `
+  <g transform="translate(${x} ${y}) rotate(${rotate})">
+    <rect x="0" y="0" width="${w}" height="${h}" fill="${bg}" stroke="${PALETTE.ink}" stroke-width="1.5"/>
+    <rect x="2" y="2" width="${w}" height="${h}" fill="none" stroke="${PALETTE.ink}" stroke-width="1.5" opacity="0.18"/>
+    <text x="${w / 2}" y="${h / 2 + 5}"
+          font-family="JetBrains Mono, ui-monospace, monospace"
+          font-size="${fontSize}" font-weight="700"
+          letter-spacing="1.5"
+          text-anchor="middle" fill="${fg}">${escapeXml(text.toUpperCase())}</text>
+  </g>`;
+}
+
+function statBox(x, y, w, h, { label, value, sub = '', accent = PALETTE.ink, tilt = 0 } = {}) {
+  // Drop-shadow style: a second rect offset by (2,2) under the main one.
+  return `
+  <g transform="translate(${x} ${y}) rotate(${tilt})">
+    <rect x="2" y="3" width="${w}" height="${h}" fill="${PALETTE.ink}"/>
+    <rect x="0" y="0" width="${w}" height="${h}" fill="${PALETTE.paper}" stroke="${PALETTE.ink}" stroke-width="1.5"/>
+    <text x="18" y="28"
+          font-family="JetBrains Mono, ui-monospace, monospace"
+          font-size="11" font-weight="700"
+          letter-spacing="2"
+          fill="${PALETTE.inkMute}">${escapeXml(label.toUpperCase())}</text>
+    <text x="18" y="${h - 24}"
+          font-family="Space Grotesk, Inter, system-ui, sans-serif"
+          font-size="34" font-weight="800"
+          fill="${accent}">${escapeXml(value)}</text>
+    ${sub ? `<text x="18" y="${h - 8}"
+          font-family="JetBrains Mono, ui-monospace, monospace"
+          font-size="11"
+          fill="${PALETTE.inkMute}">${escapeXml(sub)}</text>` : ''}
+  </g>`;
+}
+
+// Mini bar chart of daily active hours across the windowed range.
+// Used as a strip across the bottom of the card.
+function activityStrip(x, y, w, h, byDay, range) {
+  const window = pickWindow(byDay, range).reverse();   // oldest → newest
+  if (!window.length) return '';
+  const max = Math.max(1, ...window.map(([, d]) => d.activeMs || 0));
+  const N = window.length;
+  const colW = w / N;
+  const bw = Math.max(1, colW - 1.5);
+  let bars = '';
+  for (let i = 0; i < N; i++) {
+    const [, d] = window[i];
+    const ratio = (d.activeMs || 0) / max;
+    const bh = Math.max(0, ratio * h);
+    bars += `<rect x="${x + i * colW}" y="${y + (h - bh)}" width="${bw}" height="${bh}" fill="${PALETTE.rust}" opacity="${0.45 + ratio * 0.45}"/>`;
+  }
+  return `<g>${bars}</g>`;
+}
+
+// Heatmap-like dot row of the last N days.
+function dotRow(x, y, byDay, range) {
+  const window = pickWindow(byDay, range).reverse();
+  const sz = 9;
+  const gap = 2;
+  let svg = '';
+  for (let i = 0; i < window.length; i++) {
+    const [, d] = window[i];
+    const ms = d.activeMs || 0;
+    const intensity = ms === 0 ? 0 : Math.min(1, ms / (4 * 3_600_000)); // 4h = full
+    const fill = intensity === 0
+      ? PALETTE.paper3
+      : intensity < 0.34 ? '#f6dccb'
+      : intensity < 0.67 ? PALETTE.rust3
+      : PALETTE.rust;
+    svg += `<rect x="${x + i * (sz + gap)}" y="${y}" width="${sz}" height="${sz}" fill="${fill}" stroke="${PALETTE.ink}" stroke-width="0.5"/>`;
+  }
+  return svg;
+}
+
+// ── public entry point ─────────────────────────────────────────────────
+
+export function renderCard(aggregate, { range = 'year', generatedAt = new Date() } = {}) {
+  const r = rollup(aggregate, range);
+  const lang = topLanguage(aggregate);
+  const file = topFile(aggregate);
+  const wd = topWeekday(aggregate);
+  const peak = peakHourLabel(aggregate);
+  const streak = aggregate?.streak || 0;
+  const longestStreak = aggregate?.longestStreak || 0;
+  const linesNet = r.linesAdded - r.linesRemoved;
+  const allTimeHours = ((aggregate?.activeMs || 0) / 3_600_000).toFixed(1);
+
+  const subtitle = `${escapeXml(r.daysActive)} active days / ${escapeXml(rangeLabel(range))} ending ${escapeXml(generatedAt.toISOString().slice(0, 10))}`;
+
+  // Layout grid
+  //   Title block          80 →  W-80
+  //   Hero hours card     (60, 130) 380×170
+  //   Right-column stats  (470, 130) → 4 mini boxes
+  //   Activity strip       60, 332, W-120, 50
+  //   Footer credits       60, 480
+
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${W} ${H}" width="${W}" height="${H}">
+  ${paperDefs()}
+  ${background()}
+
+  <!-- ── title ── -->
+  <g transform="translate(60 60)">
+    <text x="0" y="0"
+          font-family="Space Grotesk, Inter, system-ui, sans-serif"
+          font-size="48" font-weight="800"
+          letter-spacing="-1.5"
+          fill="${PALETTE.ink}">${escapeXml(rangeTitle(range))}</text>
+    <text x="0" y="26"
+          font-family="JetBrains Mono, ui-monospace, monospace"
+          font-size="13"
+          fill="${PALETTE.inkMute}">${subtitle}</text>
+  </g>
+  ${tapeSticker(W - 220, 40, 'claude-rpc · v0.4', { rotate: 3 })}
+
+  <!-- ── hero hours card ── -->
+  <g transform="translate(60 130)">
+    <rect x="3" y="4" width="380" height="170" fill="${PALETTE.ink}"/>
+    <rect x="0" y="0" width="380" height="170" fill="${PALETTE.paper}" stroke="${PALETTE.ink}" stroke-width="2"/>
+    <text x="22" y="36"
+          font-family="JetBrains Mono, ui-monospace, monospace"
+          font-size="12" font-weight="700"
+          letter-spacing="2.5"
+          fill="${PALETTE.inkMute}">TIME WITH CLAUDE</text>
+    <text x="22" y="118"
+          font-family="Space Grotesk, Inter, system-ui, sans-serif"
+          font-size="82" font-weight="800"
+          letter-spacing="-3"
+          fill="${PALETTE.rust}">${escapeXml(fmtHours(r.activeMs))}</text>
+    <text x="22" y="148"
+          font-family="JetBrains Mono, ui-monospace, monospace"
+          font-size="13"
+          fill="${PALETTE.ink}">${escapeXml(r.daysActive)} days · ${escapeXml(fmtNum(r.sessions || 0))} sessions · streak ${escapeXml(streak)} (best ${escapeXml(longestStreak)})</text>
+  </g>
+
+  <!-- ── right-column stats (2x2 grid) ── -->
+  ${statBox(470, 130, 170, 82, { label: 'prompts',  value: fmtNum(r.userMessages), accent: PALETTE.ink, tilt: -0.8 })}
+  ${statBox(650, 130, 170, 82, { label: 'tokens',   value: fmtNum(r.tokens),       accent: PALETTE.ink, tilt: 0.6 })}
+  ${statBox(470, 218, 170, 82, { label: 'lines',    value: `${linesNet >= 0 ? '+' : '−'}${fmtNum(Math.abs(linesNet))}`, sub: `${fmtNum(r.linesAdded)} added`, accent: PALETTE.grass, tilt: 0.6 })}
+  ${statBox(650, 218, 170, 82, { label: 'cost',     value: fmtCost(r.cost),        sub: `≈ ${fmtCost(r.cost / Math.max(1, r.daysActive))}/day`, accent: PALETTE.blurple, tilt: -0.5 })}
+
+  <!-- ── activity strip ── -->
+  <g>
+    <text x="60" y="328"
+          font-family="JetBrains Mono, ui-monospace, monospace"
+          font-size="11" font-weight="700"
+          letter-spacing="2.5"
+          fill="${PALETTE.inkMute}">DAILY ACTIVITY</text>
+    <rect x="60" y="335" width="${W - 120}" height="62" fill="${PALETTE.paper2}" stroke="${PALETTE.ink}" stroke-width="1.5"/>
+    ${activityStrip(64, 337, W - 128, 58, aggregate?.byDay, range)}
+  </g>
+
+  <!-- ── footer stats row ── -->
+  <g transform="translate(60 420)">
+    <text x="0" y="0"
+          font-family="JetBrains Mono, ui-monospace, monospace"
+          font-size="11" font-weight="700"
+          letter-spacing="2.5"
+          fill="${PALETTE.inkMute}">HIGHLIGHTS</text>
+
+    <g transform="translate(0 16)">
+      <text font-family="JetBrains Mono, ui-monospace, monospace" font-size="13" fill="${PALETTE.ink}">
+        <tspan x="0"  dy="14" fill="${PALETTE.inkMute}">top language</tspan><tspan dx="10" font-weight="700">${escapeXml(lang ? lang.name : '—')}</tspan><tspan dx="6" fill="${PALETTE.inkFaint}">${escapeXml(lang ? `(${fmtNum(lang.edits)} edits)` : '')}</tspan>
+        <tspan x="0"  dy="20" fill="${PALETTE.inkMute}">hotspot file</tspan><tspan dx="14" font-weight="700">${escapeXml(file ? file.name : '—')}</tspan><tspan dx="6" fill="${PALETTE.inkFaint}">${escapeXml(file ? `(× ${fmtNum(file.count)})` : '')}</tspan>
+        <tspan x="0"  dy="20" fill="${PALETTE.inkMute}">peak day</tspan><tspan dx="36" font-weight="700">${escapeXml(wd && wd.day != null ? WEEKDAY[wd.day] : '—')}</tspan><tspan dx="6" fill="${PALETTE.inkFaint}">${escapeXml(wd ? `(${fmtHours(wd.ms)})` : '')}</tspan>
+        <tspan x="0"  dy="20" fill="${PALETTE.inkMute}">peak hour</tspan><tspan dx="30" font-weight="700">${escapeXml(peak || '—')}</tspan>
+      </text>
+    </g>
+  </g>
+
+  <!-- ── credits ── -->
+  <g transform="translate(${W - 60} ${H - 24})" text-anchor="end">
+    <text font-family="JetBrains Mono, ui-monospace, monospace" font-size="10"
+          fill="${PALETTE.inkFaint}">${escapeXml(allTimeHours)}h all-time · github.com/rar-file/claude-rpc</text>
+  </g>
+</svg>`;
+}
+
+// Top-level convenience matching badge.js shape.
+export function cardSvg({ aggregate, range = 'year' }) {
+  return renderCard(aggregate, { range });
+}

package/src/cli.js

@@ -20,6 +20,7 @@ import { startTui } from './tui.js';
 import { generateInsights } from './insights.js';
 import { badgeSvg } from './badge.js';
 import { fmtCost } from './pricing.js';
+import { addPrivateCwd, removePrivateCwd, listPrivateCwds, resolveVisibility } from './privacy.js';
 import { basename } from 'node:path';
 
 const cmd = process.argv[2];
@@ -579,9 +580,55 @@ function doScan(force = false) {
   });
   process.stdout.write('\n');
   console.log(`${c.green}✓${c.reset} Done in ${Date.now() - t0}ms — ${c.cyan}${result.scanned}${c.reset} parsed · ${result.skipped} cached · ${result.removed} removed (${result.total} total)`);
+  if (result.dirs && result.dirs.length > 1) {
+    console.log(`${c.dim}Scanned roots:${c.reset} ${result.dirs.join(', ')}`);
+  }
   console.log(`${c.dim}Aggregate written to ${AGGREGATE_PATH}${c.reset}`);
 }
 
+// Backfill from any folder that has .jsonl transcripts. Useful for:
+//   • restoring from a backup of ~/.claude
+//   • merging transcripts from another machine
+//   • importing data from an older Claude Code install with a non-default path
+//
+// Walks the given path recursively, adds every .jsonl to the existing cache,
+// and rebuilds the aggregate. Does NOT remove anything from the existing
+// aggregate — adds only.
+function doBackfill(argv) {
+  const path = argv[0];
+  if (!path) {
+    console.log(`${c.red}✗${c.reset} usage: claude-rpc backfill <path>`);
+    console.log(`${c.dim}  scans the given directory recursively for .jsonl transcripts and${c.reset}`);
+    console.log(`${c.dim}  merges them into your aggregate.${c.reset}`);
+    process.exit(1);
+  }
+  if (!existsSync(path)) {
+    console.log(`${c.red}✗${c.reset} path doesn't exist: ${path}`);
+    process.exit(1);
+  }
+  console.log(`${c.dim}Backfilling from${c.reset} ${c.cyan}${path}${c.reset}…`);
+  const t0 = Date.now();
+  let lastReport = 0;
+  // Pass `extraDirs` rather than `projectsDirs` — this way the default
+  // ~/.claude/projects (+ any auto-discovered alt paths) ALSO gets scanned
+  // and the user's existing cache for those isn't pruned.
+  const result = scan({
+    force: false,
+    extraDirs: [path],
+    onProgress: ({ scanned, total }) => {
+      if (Date.now() - lastReport > 500) {
+        process.stdout.write(`\r  parsed ${scanned}/${total}…`);
+        lastReport = Date.now();
+      }
+    },
+  });
+  process.stdout.write('\n');
+  console.log(`${c.green}✓${c.reset} Done in ${Date.now() - t0}ms — ${c.cyan}${result.scanned}${c.reset} new/changed · ${result.skipped} cached`);
+  console.log(`${c.dim}Scanned roots:${c.reset} ${result.dirs.join(', ')}`);
+  const hours = ((result.aggregate.activeMs || 0) / 3_600_000).toFixed(1);
+  console.log(`${c.dim}Aggregate now:${c.reset} ${result.aggregate.sessions} sessions · ${hours}h · ${result.aggregate.userMessages} prompts`);
+}
+
 function showInsights() {
   const aggregate = readAggregate();
   const insights = generateInsights(aggregate, { limit: 6 });
@@ -620,6 +667,89 @@ function doBadge(argv) {
   }
 }
 
+// Poster-style SVG card. Bigger sibling of `badge` — shareable summary
+// for a range (year / month / week / all-time). Output is SVG only;
+// screenshot or convert to PNG offline if needed.
+function parseCardArgs(argv) {
+  const out = { range: 'year', out: '' };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--range' || a === '-r') out.range = argv[++i];
+    else if (a === '--out' || a === '-o') out.out = argv[++i];
+  }
+  return out;
+}
+
+async function doCard(argv) {
+  const opts = parseCardArgs(argv);
+  const aggregate = readAggregate();
+  if (!aggregate) {
+    console.error(`${c.yellow}No aggregate yet. Run ${c.cyan}claude-rpc scan${c.reset} first.`);
+    process.exit(1);
+  }
+  const { renderCard } = await import('./card.js');
+  const svg = renderCard(aggregate, { range: opts.range });
+  if (opts.out) {
+    writeFileSync(opts.out, svg);
+    console.log(`${c.green}✓${c.reset} Wrote ${c.cyan}${opts.out}${c.reset} (${svg.length} bytes)`);
+    console.log(`${c.dim}Tip: open in a browser, right-click → Save as PNG. Or drop straight into a Discord message — it'll render inline.${c.reset}`);
+  } else {
+    process.stdout.write(svg);
+  }
+}
+
+// ── Privacy commands ─────────────────────────────────────────────────────
+//
+// `claude-rpc private`        → add current cwd to ~/.claude-rpc/private-list.json
+// `claude-rpc public`         → remove current cwd
+// `claude-rpc privacy`        → show resolved visibility for current cwd + listed paths
+//
+// Per-project overrides live in <project>/.claude-rpc.json and take priority
+// over the runtime list. See src/privacy.js for the full resolution chain.
+
+function loadConfigSafe() {
+  try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf8')); } catch { return {}; }
+}
+
+function doPrivate() {
+  const cwd = process.cwd();
+  const list = addPrivateCwd(cwd);
+  console.log(`${c.green}✓${c.reset} ${c.cyan}${cwd}${c.reset} marked private`);
+  console.log(`${c.dim}  ${list.length} ${list.length === 1 ? 'path' : 'paths'} in the private list. Daemon picks it up within ~5 min (cache TTL) or restart.${c.reset}`);
+}
+
+function doPublic() {
+  const cwd = process.cwd();
+  const before = listPrivateCwds().length;
+  const list = removePrivateCwd(cwd);
+  if (list.length === before) {
+    console.log(`${c.yellow}!${c.reset} ${c.cyan}${cwd}${c.reset} wasn't in the private list`);
+  } else {
+    console.log(`${c.green}✓${c.reset} ${c.cyan}${cwd}${c.reset} removed from the private list`);
+  }
+}
+
+function doPrivacy() {
+  const cwd = process.cwd();
+  const cfg = loadConfigSafe();
+  const { visibility, projectName, reason } = resolveVisibility(cwd, cfg);
+  const color = visibility === 'hidden' ? c.red : visibility === 'name-only' ? c.yellow : c.green;
+  console.log('');
+  console.log(`  ${c.bold}privacy${c.reset}  ${c.dim}for${c.reset} ${c.cyan}${cwd}${c.reset}`);
+  console.log(`    ${c.dim}visibility:${c.reset} ${color}${visibility}${c.reset}   ${c.dim}(${reason})${c.reset}`);
+  if (projectName) console.log(`    ${c.dim}alias:    ${c.reset} ${projectName}`);
+  const list = listPrivateCwds();
+  if (list.length) {
+    console.log('');
+    console.log(`  ${c.bold}private-list${c.reset}  ${c.dim}(${list.length} ${list.length === 1 ? 'path' : 'paths'})${c.reset}`);
+    for (const p of list) console.log(`    ${p === cwd ? c.cyan + '●' + c.reset : ' '} ${p}`);
+  }
+  console.log('');
+  console.log(`  ${c.dim}toggle:   claude-rpc private  /  claude-rpc public${c.reset}`);
+  console.log(`  ${c.dim}per-proj: drop a {"private": true} into .claude-rpc.json at the repo root${c.reset}`);
+  console.log('');
+}
+
 function tailLog() {
   if (!existsSync(LOG_PATH)) {
     console.log(`${c.yellow}No log yet at ${LOG_PATH}${c.reset}`);
@@ -659,8 +789,14 @@ function help() {
     ['preview',   'Show how each rotation frame renders right now'],
     ['scan',      'Incrementally scan ~/.claude/projects for all-time totals'],
     ['rescan',    'Force re-parse every transcript (ignores cache)'],
+    ['backfill',  'Import transcripts from any folder (e.g. a backup)'],
     ['insights',  'Auto-generated insights from your history'],
     ['badge',     'Render a Shields-style SVG (--metric --range --out)'],
+    ['card',      'Render a poster-style SVG summary (--range year|month|week|all)'],
+    ['private',   'Mark the current directory as private (hide from Discord)'],
+    ['public',    'Un-mark the current directory'],
+    ['privacy',   'Show resolved visibility for the current directory'],
+    ['doctor',    'Run a diagnostic checklist — common-failure triage'],
     ['tail',      'Tail the daemon log file'],
     ['daemon',    'Run daemon in foreground (debug)'],
   ];
@@ -706,13 +842,23 @@ const packagedDefault = IS_PACKAGED && !cmd;
     case 'dump':      showStatus(); break;
     case 'today':     showToday(); break;
     case 'week':      showWeek(); break;
-    case 'serve':     await import('./server.js'); break;
+    case 'serve':     await import('./server/index.js'); break;
     case 'preview':   showPreview(); break;
     case 'vars':      dumpVars(); break;
     case 'scan':      doScan(false); break;
     case 'rescan':    doScan(true); break;
+    case 'backfill':  doBackfill(process.argv.slice(3)); break;
     case 'insights':  showInsights(); break;
     case 'badge':     doBadge(process.argv.slice(3)); break;
+    case 'card':      await doCard(process.argv.slice(3)); break;
+    case 'private':   doPrivate(); break;
+    case 'public':    doPublic(); break;
+    case 'privacy':   doPrivacy(); break;
+    case 'doctor': {
+      const { runDoctor } = await import('./doctor.js');
+      process.exit(runDoctor());
+      break;
+    }
     case 'tail':
     case 'logs':
     case 'log':       tailLog(); break;