fieldtheory 1.0.0

package/dist/bookmarks-viz.js

@@ -0,0 +1,531 @@
+import { openDb } from './db.js';
+import { twitterBookmarksIndexPath } from './paths.js';
+// ── ANSI helpers ─────────────────────────────────────────────────────────────
+const ESC = '\x1b[';
+const RESET = `${ESC}0m`;
+const BOLD = `${ESC}1m`;
+const DIM = `${ESC}2m`;
+const rgb = (r, g, b) => `${ESC}38;2;${r};${g};${b}m`;
+// Palette — muted, tasteful
+const C = {
+    title: rgb(199, 146, 234), // soft lavender
+    accent: rgb(130, 170, 255), // periwinkle
+    warm: rgb(255, 180, 120), // peach
+    green: rgb(120, 220, 170), // mint
+    dim: rgb(100, 100, 120), // muted gray
+    text: rgb(200, 200, 210), // light gray
+    hot: rgb(255, 120, 140), // coral
+    gold: rgb(240, 200, 100), // amber
+    cyan: rgb(100, 220, 230), // teal
+    violet: rgb(170, 130, 255), // violet
+};
+// ── Block characters for bar charts ──────────────────────────────────────────
+const BLOCKS = [' ', '▏', '▎', '▍', '▌', '▋', '▊', '▉', '█'];
+function bar(value, max, width, color) {
+    const ratio = max > 0 ? value / max : 0;
+    const filled = ratio * width;
+    const full = Math.floor(filled);
+    const partial = Math.round((filled - full) * 8);
+    return (color +
+        '█'.repeat(full) +
+        (partial > 0 ? BLOCKS[partial] : '') +
+        RESET +
+        ' '.repeat(Math.max(0, width - full - (partial > 0 ? 1 : 0))));
+}
+// ── Sparkline ────────────────────────────────────────────────────────────────
+const SPARKS = '▁▂▃▄▅▆▇█';
+function sparkline(data, color) {
+    const max = Math.max(...data, 1);
+    return (color +
+        data.map((v) => SPARKS[Math.round((v / max) * 7)] || SPARKS[0]).join('') +
+        RESET);
+}
+// ── Braille dot chart (2-wide × 4-tall per character) ────────────────────────
+const BRAILLE_BASE = 0x2800;
+const BRAILLE_DOTS = [
+    [0x01, 0x08],
+    [0x02, 0x10],
+    [0x04, 0x20],
+    [0x40, 0x80],
+];
+function brailleChart(data, width, color) {
+    const max = Math.max(...data, 1);
+    const heights = data.map((v) => Math.round((v / max) * 7));
+    const chars = new Array(Math.ceil(data.length / 2)).fill(BRAILLE_BASE);
+    for (let i = 0; i < heights.length; i++) {
+        const col = i % 2; // 0 = left, 1 = right
+        const charIdx = Math.floor(i / 2);
+        const h = heights[i];
+        for (let row = 0; row < 4; row++) {
+            if (7 - row * 2 <= h) {
+                chars[charIdx] |= BRAILLE_DOTS[row][col];
+            }
+        }
+    }
+    return color + chars.map((c) => String.fromCharCode(c)).join('') + RESET;
+}
+// ── Box drawing ──────────────────────────────────────────────────────────────
+function boxTop(width) {
+    return C.dim + '╭' + '─'.repeat(width - 2) + '╮' + RESET;
+}
+function boxBottom(width) {
+    return C.dim + '╰' + '─'.repeat(width - 2) + '╯' + RESET;
+}
+function boxRow(content, width) {
+    const stripped = content.replace(/\x1b\[[^m]*m/g, '');
+    const pad = Math.max(0, width - 4 - stripped.length);
+    return C.dim + '│ ' + RESET + content + ' '.repeat(pad) + C.dim + ' │' + RESET;
+}
+function boxDivider(width) {
+    return C.dim + '├' + '─'.repeat(width - 2) + '┤' + RESET;
+}
+// ── Gradient helpers ─────────────────────────────────────────────────────────
+function lerpColor(from, to, t) {
+    const r = Math.round(from[0] + (to[0] - from[0]) * t);
+    const g = Math.round(from[1] + (to[1] - from[1]) * t);
+    const b = Math.round(from[2] + (to[2] - from[2]) * t);
+    return rgb(r, g, b);
+}
+async function queryVizData() {
+    const db = await openDb(twitterBookmarksIndexPath());
+    try {
+        const total = db.exec('SELECT COUNT(*) FROM bookmarks')[0]?.values[0]?.[0];
+        const authors = db.exec('SELECT COUNT(DISTINCT author_handle) FROM bookmarks')[0]?.values[0]?.[0];
+        const range = db.exec('SELECT MIN(posted_at), MAX(posted_at) FROM bookmarks WHERE posted_at IS NOT NULL')[0]?.values[0];
+        const topAuthorsRows = db.exec(`SELECT author_handle, COUNT(*) as c FROM bookmarks
+       WHERE author_handle IS NOT NULL
+       GROUP BY author_handle ORDER BY c DESC LIMIT 20`);
+        // Twitter date format: "Sat Mar 28 18:55:23 +0000 2026"
+        // Year is at end (-4), month name at 5-7, hour at 12-13
+        // Build a synthetic YYYY-MonName from the twitter date parts
+        const monthlyRows = db.exec(`SELECT
+         substr(bookmarked_at, -4) || '-' || substr(bookmarked_at, 5, 3) as ym,
+         COUNT(*) as c
+       FROM bookmarks WHERE bookmarked_at IS NOT NULL
+       GROUP BY ym ORDER BY ym`);
+        // Day of week — first 3 chars
+        const dowRows = db.exec(`SELECT substr(bookmarked_at, 1, 3) as dow, COUNT(*) as c
+       FROM bookmarks WHERE bookmarked_at IS NOT NULL
+       GROUP BY dow ORDER BY c DESC`);
+        // Hour of day — chars 12-13
+        const hourRows = db.exec(`SELECT CAST(substr(bookmarked_at, 12, 2) AS INTEGER) as h, COUNT(*) as c
+       FROM bookmarks WHERE bookmarked_at IS NOT NULL AND length(bookmarked_at) > 13
+       GROUP BY h ORDER BY h`);
+        // Domains from links_json
+        const domainRows = db.exec(`SELECT links_json FROM bookmarks WHERE links_json IS NOT NULL AND links_json != '[]'`);
+        const domainCounts = new Map();
+        for (const row of domainRows[0]?.values ?? []) {
+            try {
+                const links = JSON.parse(row[0]);
+                for (const link of links) {
+                    const url = typeof link === 'string' ? link : link.expanded_url ?? link.url ?? '';
+                    try {
+                        const domain = new URL(url).hostname.replace(/^www\./, '');
+                        if (domain && domain !== 'x.com' && domain !== 't.co') {
+                            domainCounts.set(domain, (domainCounts.get(domain) ?? 0) + 1);
+                        }
+                    }
+                    catch { }
+                }
+            }
+            catch { }
+        }
+        const topDomains = [...domainCounts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 12)
+            .map(([domain, count]) => ({ domain, count }));
+        const mediaStats = {
+            withMedia: db.exec('SELECT COUNT(*) FROM bookmarks WHERE media_count > 0')[0]?.values[0]?.[0],
+            withLinks: db.exec('SELECT COUNT(*) FROM bookmarks WHERE link_count > 0')[0]?.values[0]?.[0],
+            total,
+        };
+        const langRows = db.exec(`SELECT language, COUNT(*) as c FROM bookmarks WHERE language IS NOT NULL
+       GROUP BY language ORDER BY c DESC LIMIT 8`);
+        const avgLen = db.exec('SELECT AVG(length(text)) FROM bookmarks')[0]?.values[0]?.[0];
+        // Recent 30 days top authors
+        const recentAuthorsRows = db.exec(`SELECT author_handle, COUNT(*) as c FROM bookmarks
+       WHERE author_handle IS NOT NULL
+       AND bookmarked_at >= (SELECT MAX(bookmarked_at) FROM bookmarks)
+       GROUP BY author_handle ORDER BY c DESC LIMIT 10`);
+        // Time capsules: oldest posts, one per year to spread the range
+        const capsuleRows = db.exec(`SELECT author_handle, text, tweet_id, posted_at, substr(posted_at, -4) as yr
+       FROM bookmarks
+       WHERE posted_at IS NOT NULL
+       AND CAST(substr(posted_at, -4) AS INTEGER) < 2023
+       GROUP BY substr(posted_at, -4)
+       ORDER BY posted_at ASC
+       LIMIT 8`);
+        const timeCapsules = (capsuleRows[0]?.values ?? []).map((r) => ({
+            author: r[0],
+            text: r[1],
+            tweetId: r[2],
+            postedAt: r[3],
+        }));
+        // Hidden gems: authors bookmarked exactly once, with long text (> 250 chars)
+        const gemRows = db.exec(`SELECT b.author_handle, b.text, b.tweet_id, b.posted_at
+       FROM bookmarks b
+       JOIN (
+         SELECT author_handle FROM bookmarks
+         WHERE author_handle IS NOT NULL
+         GROUP BY author_handle HAVING COUNT(*) = 1
+       ) singles ON b.author_handle = singles.author_handle
+       WHERE length(b.text) > 250
+       ORDER BY length(b.text) DESC
+       LIMIT 8`);
+        const hiddenGems = (gemRows[0]?.values ?? []).map((r) => ({
+            author: r[0],
+            text: r[1],
+            tweetId: r[2],
+            postedAt: r[3],
+        }));
+        // Rising voices: authors with 3+ bookmarks, all from the most recent month
+        const latestMonth = db.exec(`SELECT substr(bookmarked_at, -4) || '-' || substr(bookmarked_at, 5, 3)
+       FROM bookmarks WHERE bookmarked_at IS NOT NULL
+       ORDER BY bookmarked_at DESC LIMIT 1`)[0]?.values[0]?.[0];
+        let risingVoices = [];
+        if (latestMonth) {
+            const risingRows = db.exec(`SELECT author_handle, COUNT(*) as c FROM bookmarks
+         WHERE author_handle IS NOT NULL
+         GROUP BY author_handle
+         HAVING c >= 3
+         AND MIN(substr(bookmarked_at, -4) || '-' || substr(bookmarked_at, 5, 3)) = ?
+         ORDER BY c DESC LIMIT 8`, [latestMonth]);
+            risingVoices = (risingRows[0]?.values ?? []).map((r) => ({
+                handle: r[0],
+                count: r[1],
+            }));
+        }
+        // Convert "2026-Mar" to "2026-03" for proper sorting
+        const monthNumMap = {
+            Jan: '01', Feb: '02', Mar: '03', Apr: '04', May: '05', Jun: '06',
+            Jul: '07', Aug: '08', Sep: '09', Oct: '10', Nov: '11', Dec: '12',
+        };
+        const rawMonthly = (monthlyRows[0]?.values ?? []).map((r) => {
+            const raw = r[0]; // "2026-Mar"
+            const [year, monName] = raw.split('-');
+            const num = monthNumMap[monName] ?? '00';
+            return { month: `${year}-${num}`, label: `${monName} ${year}`, count: r[1] };
+        });
+        rawMonthly.sort((a, b) => a.month.localeCompare(b.month));
+        return {
+            total,
+            uniqueAuthors: authors,
+            dateRange: {
+                earliest: range?.[0] ?? '?',
+                latest: range?.[1] ?? '?',
+            },
+            topAuthors: (topAuthorsRows[0]?.values ?? []).map((r) => ({
+                handle: r[0],
+                count: r[1],
+            })),
+            monthlyActivity: rawMonthly.map((r) => ({
+                month: r.label,
+                count: r.count,
+            })),
+            dayOfWeekActivity: (dowRows[0]?.values ?? []).map((r) => ({
+                day: r[0],
+                count: r[1],
+            })),
+            hourActivity: (hourRows[0]?.values ?? []).map((r) => ({
+                hour: r[0],
+                count: r[1],
+            })),
+            topDomains,
+            mediaStats,
+            recentAuthors: (recentAuthorsRows[0]?.values ?? []).map((r) => ({
+                handle: r[0],
+                count: r[1],
+            })),
+            languages: (langRows[0]?.values ?? []).map((r) => ({
+                lang: r[0],
+                count: r[1],
+            })),
+            avgTextLength: avgLen,
+            timeCapsules,
+            hiddenGems,
+            risingVoices,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+// ── Render sections ──────────────────────────────────────────────────────────
+const W = 72; // box width
+function renderHeader(data) {
+    const lines = [];
+    lines.push('');
+    lines.push(boxTop(W));
+    lines.push(boxRow(`${C.title}${BOLD}  ✦  FIELD THEORY  ·  BOOKMARK OBSERVATORY  ✦  ${RESET}`, W));
+    lines.push(boxDivider(W));
+    lines.push(boxRow(`${C.text}${data.total.toLocaleString()} bookmarks${C.dim}  ·  ${C.text}${data.uniqueAuthors.toLocaleString()} voices${C.dim}  ·  ${C.text}${data.languages.length} languages`, W));
+    lines.push(boxRow(`${C.dim}${data.dateRange.earliest.slice(0, 16)} → ${data.dateRange.latest.slice(0, 16)}`, W));
+    lines.push(boxBottom(W));
+    return lines;
+}
+function renderTopAuthors(data) {
+    const lines = [];
+    const maxCount = data.topAuthors[0]?.count ?? 1;
+    const barWidth = 28;
+    lines.push('');
+    lines.push(`  ${C.accent}${BOLD}WHO YOU LISTEN TO${RESET}`);
+    lines.push(`  ${C.dim}top 20 most-bookmarked voices${RESET}`);
+    lines.push('');
+    for (const author of data.topAuthors) {
+        const t = author.count / maxCount;
+        const color = lerpColor([100, 160, 255], [255, 120, 180], t);
+        const handle = `@${author.handle}`.padEnd(20);
+        const count = String(author.count).padStart(4);
+        lines.push(`  ${C.text}${handle}${RESET} ${bar(author.count, maxCount, barWidth, color)} ${C.dim}${count}${RESET}`);
+    }
+    return lines;
+}
+function renderActivity(data) {
+    const lines = [];
+    const counts = data.monthlyActivity.map((m) => m.count);
+    const maxCount = Math.max(...counts, 1);
+    lines.push('');
+    lines.push(`  ${C.warm}${BOLD}RHYTHM${RESET}`);
+    lines.push(`  ${C.dim}monthly bookmarking cadence${RESET}`);
+    lines.push('');
+    // Sparkline overview
+    lines.push(`  ${sparkline(counts, C.warm)}`);
+    lines.push('');
+    // Monthly bars
+    for (const m of data.monthlyActivity) {
+        const label = m.month.padEnd(8);
+        const t = m.count / maxCount;
+        const color = lerpColor([255, 160, 100], [255, 100, 120], t);
+        const count = String(m.count).padStart(5);
+        lines.push(`  ${C.dim}${label}${RESET} ${bar(m.count, maxCount, 36, color)} ${C.dim}${count}${RESET}`);
+    }
+    return lines;
+}
+function renderDayOfWeek(data) {
+    const lines = [];
+    const dayOrder = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'];
+    const ordered = dayOrder
+        .map((d) => data.dayOfWeekActivity.find((r) => r.day === d))
+        .filter(Boolean);
+    if (ordered.length === 0)
+        return [];
+    const maxCount = Math.max(...ordered.map((d) => d.count), 1);
+    const counts = ordered.map((d) => d.count);
+    lines.push('');
+    lines.push(`  ${C.green}${BOLD}WEEKLY PULSE${RESET}`);
+    lines.push(`  ${C.dim}which days you bookmark${RESET}`);
+    lines.push('');
+    lines.push(`  ${brailleChart(counts, 14, C.green)}`);
+    lines.push('');
+    for (const d of ordered) {
+        const label = d.day.padEnd(5);
+        const t = d.count / maxCount;
+        const color = lerpColor([80, 200, 160], [120, 255, 200], t);
+        const count = String(d.count).padStart(5);
+        lines.push(`  ${C.text}${label}${RESET} ${bar(d.count, maxCount, 36, color)} ${C.dim}${count}${RESET}`);
+    }
+    return lines;
+}
+function renderHourOfDay(data) {
+    const lines = [];
+    if (data.hourActivity.length === 0)
+        return [];
+    // Fill in all 24 hours
+    const hourMap = new Map(data.hourActivity.map((h) => [h.hour, h.count]));
+    const allHours = Array.from({ length: 24 }, (_, i) => hourMap.get(i) ?? 0);
+    const maxCount = Math.max(...allHours, 1);
+    lines.push('');
+    lines.push(`  ${C.cyan}${BOLD}DAILY ARC${RESET}`);
+    lines.push(`  ${C.dim}when you reach for the bookmark button${RESET}`);
+    lines.push('');
+    // Vertical bar chart using blocks
+    const chartHeight = 8;
+    for (let row = chartHeight; row >= 1; row--) {
+        let line = '  ';
+        for (let h = 0; h < 24; h++) {
+            const t = allHours[h] / maxCount;
+            const barH = t * chartHeight;
+            if (barH >= row) {
+                const color = lerpColor([60, 180, 200], [100, 240, 255], t);
+                line += color + '██' + RESET;
+            }
+            else if (barH >= row - 1 && barH > 0) {
+                const frac = barH - Math.floor(barH);
+                const partials = [' ', '▁', '▂', '▃', '▄', '▅', '▆', '▇'];
+                const idx = Math.round(frac * 7);
+                const color = lerpColor([60, 180, 200], [100, 240, 255], t);
+                line += color + partials[idx] + partials[idx] + RESET;
+            }
+            else {
+                line += '  ';
+            }
+        }
+        lines.push(line);
+    }
+    // Hour labels
+    let labelLine = '  ';
+    for (let h = 0; h < 24; h++) {
+        if (h % 3 === 0) {
+            labelLine += C.dim + String(h).padStart(2, '0') + RESET;
+            if (h + 1 < 24)
+                labelLine += C.dim + RESET;
+        }
+        else {
+            labelLine += '  ';
+        }
+    }
+    lines.push(labelLine);
+    // Peak hours annotation
+    const peak = data.hourActivity.reduce((a, b) => (a.count > b.count ? a : b));
+    const quiet = data.hourActivity.reduce((a, b) => (a.count < b.count ? a : b));
+    lines.push('');
+    lines.push(`  ${C.cyan}peak${RESET} ${C.text}${peak.hour}:00${RESET}${C.dim}  ·  ${C.cyan}quiet${RESET} ${C.text}${quiet.hour}:00${RESET}`);
+    return lines;
+}
+function renderDomains(data) {
+    const lines = [];
+    if (data.topDomains.length === 0)
+        return [];
+    const maxCount = data.topDomains[0]?.count ?? 1;
+    lines.push('');
+    lines.push(`  ${C.violet}${BOLD}WHERE LINKS LEAD${RESET}`);
+    lines.push(`  ${C.dim}most-bookmarked external domains${RESET}`);
+    lines.push('');
+    for (const d of data.topDomains) {
+        const label = d.domain.padEnd(24);
+        const t = d.count / maxCount;
+        const color = lerpColor([140, 100, 230], [200, 150, 255], t);
+        const count = String(d.count).padStart(4);
+        lines.push(`  ${C.text}${label}${RESET} ${bar(d.count, maxCount, 22, color)} ${C.dim}${count}${RESET}`);
+    }
+    return lines;
+}
+function renderMediaBreakdown(data) {
+    const lines = [];
+    const { withMedia, withLinks, total } = data.mediaStats;
+    lines.push('');
+    lines.push(`  ${C.gold}${BOLD}COMPOSITION${RESET}`);
+    lines.push(`  ${C.dim}what your bookmarks contain${RESET}`);
+    lines.push('');
+    const barWidth = 50;
+    const mediaPct = (withMedia / total) * 100;
+    const linkPct = (withLinks / total) * 100;
+    const textPct = Math.max(0, 100 - mediaPct - linkPct);
+    const mediaW = Math.round((withMedia / total) * barWidth);
+    const linkW = Math.round((withLinks / total) * barWidth);
+    const textW = barWidth - mediaW - linkW;
+    // Stacked bar
+    const stackedBar = rgb(120, 220, 170) + '█'.repeat(mediaW) +
+        rgb(130, 170, 255) + '█'.repeat(linkW) +
+        rgb(100, 100, 120) + '█'.repeat(Math.max(0, textW)) +
+        RESET;
+    lines.push(`  ${stackedBar}`);
+    lines.push('');
+    lines.push(`  ${rgb(120, 220, 170)}██${RESET} ${C.text}media  ${withMedia.toLocaleString()} (${mediaPct.toFixed(0)}%)${RESET}    ${rgb(130, 170, 255)}██${RESET} ${C.text}links  ${withLinks.toLocaleString()} (${linkPct.toFixed(0)}%)${RESET}    ${rgb(100, 100, 120)}██${RESET} ${C.text}text  ${textPct.toFixed(0)}%${RESET}`);
+    return lines;
+}
+function renderFingerprint(data) {
+    const lines = [];
+    lines.push('');
+    lines.push(boxTop(W));
+    lines.push(boxRow(`${C.title}${BOLD}FINGERPRINT${RESET}`, W));
+    lines.push(boxDivider(W));
+    const mediaPct = ((data.mediaStats.withMedia / data.total) * 100).toFixed(0);
+    const longTailPct = data.uniqueAuthors > 0
+        ? (((data.uniqueAuthors - data.topAuthors.length) / data.uniqueAuthors) * 100).toFixed(0)
+        : '0';
+    lines.push(boxRow(`${C.dim}avg bookmark length${RESET}    ${C.text}${Math.round(data.avgTextLength)} chars${RESET}`, W));
+    lines.push(boxRow(`${C.dim}media-bearing${RESET}          ${C.text}${mediaPct}%${RESET}`, W));
+    lines.push(boxRow(`${C.dim}long-tail authors${RESET}      ${C.text}${longTailPct}% bookmarked ≤ once${RESET}`, W));
+    lines.push(boxRow(`${C.dim}top voice${RESET}              ${C.text}@${data.topAuthors[0]?.handle ?? '?'} (${data.topAuthors[0]?.count ?? 0})${RESET}`, W));
+    if (data.recentAuthors.length > 0) {
+        lines.push(boxDivider(W));
+        lines.push(boxRow(`${C.accent}${BOLD}LATEST SESSION${RESET}`, W));
+        for (const a of data.recentAuthors.slice(0, 5)) {
+            lines.push(boxRow(`  ${C.text}@${a.handle}${RESET} ${C.dim}×${a.count}${RESET}`, W));
+        }
+    }
+    lines.push(boxBottom(W));
+    return lines;
+}
+function truncateText(text, max) {
+    const clean = text.replace(/\n/g, ' ').replace(/\s+/g, ' ').trim();
+    if (clean.length <= max)
+        return clean;
+    return clean.slice(0, max - 1) + '…';
+}
+function twitterDateYear(date) {
+    return date.slice(-4);
+}
+function renderTimeCapsules(data) {
+    const lines = [];
+    if (data.timeCapsules.length === 0)
+        return [];
+    lines.push('');
+    lines.push(`  ${C.gold}${BOLD}TIME CAPSULES${RESET}`);
+    lines.push(`  ${C.dim}your oldest bookmarked posts — still saved after all these years${RESET}`);
+    lines.push('');
+    for (const b of data.timeCapsules) {
+        const year = twitterDateYear(b.postedAt);
+        const monthDay = b.postedAt.slice(4, 10); // " Mar 28"
+        const color = lerpColor([240, 200, 100], [200, 160, 80], 0.5);
+        const url = `x.com/${b.author}/status/${b.tweetId}`;
+        lines.push(`  ${color}${year}${RESET}${C.dim}${monthDay}${RESET}  ${C.text}@${b.author}${RESET}`);
+        lines.push(`  ${C.dim}${truncateText(b.text, 62)}${RESET}`);
+        lines.push(`  ${DIM}${url}${RESET}`);
+        lines.push('');
+    }
+    return lines;
+}
+function renderHiddenGems(data) {
+    const lines = [];
+    if (data.hiddenGems.length === 0)
+        return [];
+    lines.push('');
+    lines.push(`  ${C.hot}${BOLD}HIDDEN GEMS${RESET}`);
+    lines.push(`  ${C.dim}one-time voices you saved — long, substantive, easy to forget${RESET}`);
+    lines.push('');
+    for (const b of data.hiddenGems) {
+        const url = `x.com/${b.author}/status/${b.tweetId}`;
+        lines.push(`  ${C.hot}◆${RESET} ${C.text}@${b.author}${RESET}`);
+        lines.push(`  ${C.dim}${truncateText(b.text, 62)}${RESET}`);
+        lines.push(`  ${DIM}${url}${RESET}`);
+        lines.push('');
+    }
+    return lines;
+}
+function renderRisingVoices(data) {
+    const lines = [];
+    if (data.risingVoices.length === 0)
+        return [];
+    const maxCount = data.risingVoices[0]?.count ?? 1;
+    lines.push('');
+    lines.push(`  ${C.green}${BOLD}RISING${RESET}`);
+    lines.push(`  ${C.dim}new voices — all bookmarks from your most recent month${RESET}`);
+    lines.push('');
+    for (const v of data.risingVoices) {
+        const handle = `@${v.handle}`.padEnd(22);
+        const dots = C.green + '●'.repeat(v.count) + C.dim + '○'.repeat(Math.max(0, maxCount - v.count)) + RESET;
+        lines.push(`  ${C.text}${handle}${RESET} ${dots}  ${C.dim}${v.count}${RESET}`);
+    }
+    return lines;
+}
+// ── Main render ──────────────────────────────────────────────────────────────
+export async function renderViz() {
+    const data = await queryVizData();
+    const sections = [
+        ...renderHeader(data),
+        ...renderTopAuthors(data),
+        ...renderActivity(data),
+        ...renderDayOfWeek(data),
+        ...renderHourOfDay(data),
+        ...renderDomains(data),
+        ...renderMediaBreakdown(data),
+        ...renderTimeCapsules(data),
+        ...renderHiddenGems(data),
+        ...renderRisingVoices(data),
+        ...renderFingerprint(data),
+        '', // trailing newline
+    ];
+    return sections.join('\n');
+}