life-pulse 2.3.9 → 2.3.11

package/dist/prompt-layers.js

@@ -0,0 +1,113 @@
+/**
+ * Local identity + memory injection (OpenClaw-style).
+ *
+ * Priority order:
+ *   1) Explicit env path
+ *   2) Current working directory
+ *   3) ~/.life-pulse
+ *   4) ~/.config/life-pulse
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const MAX_SOUL_CHARS = 12_000;
+const MAX_MEMORY_CHARS = 18_000;
+const DEFAULT_SOUL = `# NOX Identity
+
+- You are NOX, the user's always-on operator.
+- Voice: direct, warm, sharp, no corporate language.
+- Prefer concrete next actions over abstract advice.
+- Never invent facts. If signal is weak, say less.
+- Keep output compact unless explicitly asked for depth.
+- In text replies, sound human and conversational.
+- Prioritize reputation, promises, and momentum.
+`;
+const DEFAULT_MEMORY = `# Persistent Memory
+
+## Operator
+- Name: <auto-detected at runtime>
+
+## Preferences
+- Prefer terse, high-signal summaries.
+- Focus on what needs action now.
+
+## Ongoing Context
+- Keep this file updated with durable context that should persist across turns.
+`;
+function firstExisting(paths) {
+    for (const p of paths) {
+        try {
+            if (!p)
+                continue;
+            if (!existsSync(p))
+                continue;
+            return readFileSync(p, 'utf-8').trim();
+        }
+        catch { }
+    }
+    return null;
+}
+function trimTo(input, maxChars) {
+    if (input.length <= maxChars)
+        return input;
+    return input.slice(0, maxChars).trim();
+}
+export function loadPromptLayers() {
+    const home = homedir();
+    const cwd = process.cwd();
+    const soul = firstExisting([
+        process.env.LIFE_PULSE_SOUL_PATH || '',
+        join(cwd, 'SOUL.md'),
+        join(home, '.life-pulse', 'SOUL.md'),
+        join(home, '.config', 'life-pulse', 'SOUL.md'),
+    ]) || '';
+    const memory = firstExisting([
+        process.env.LIFE_PULSE_MEMORY_PATH || '',
+        join(cwd, 'MEMORY.md'),
+        join(home, '.life-pulse', 'MEMORY.md'),
+        join(home, '.config', 'life-pulse', 'MEMORY.md'),
+    ]) || '';
+    return {
+        soul: trimTo(soul, MAX_SOUL_CHARS),
+        memory: trimTo(memory, MAX_MEMORY_CHARS),
+    };
+}
+export function buildPromptLayersSection() {
+    const { soul, memory } = loadPromptLayers();
+    if (!soul && !memory)
+        return '';
+    const parts = [
+        '═══ IDENTITY + MEMORY ═══',
+        'Treat this as persistent ground truth unless the current conversation explicitly updates it.',
+    ];
+    if (soul) {
+        parts.push('\nSOUL.md');
+        parts.push(soul);
+    }
+    if (memory) {
+        parts.push('\nMEMORY.md');
+        parts.push(memory);
+    }
+    return `\n${parts.join('\n')}`;
+}
+/** First-run bootstrap: create default SOUL.md + MEMORY.md if missing. */
+export function ensurePromptLayerFiles() {
+    const home = homedir();
+    const base = join(home, '.life-pulse');
+    const soulPath = join(base, 'SOUL.md');
+    const memoryPath = join(base, 'MEMORY.md');
+    const created = [];
+    try {
+        mkdirSync(base, { recursive: true });
+        if (!existsSync(soulPath)) {
+            writeFileSync(soulPath, DEFAULT_SOUL, 'utf-8');
+            created.push(soulPath);
+        }
+        if (!existsSync(memoryPath)) {
+            writeFileSync(memoryPath, DEFAULT_MEMORY, 'utf-8');
+            created.push(memoryPath);
+        }
+    }
+    catch { }
+    return created;
+}

package/dist/router.d.ts

@@ -1,7 +1,8 @@
 /**
- * Message Router — runs on YOUR Mac, routes to client Mac Minis.
+ * Message Router — legacy bridge mode.
  *
- * This is the bridge between rply-mac-server and life-pulse instances.
+ * This is only needed for multi-machine relay setups.
+ * Default deployment is direct NOX -> user's Mac gateway (:19877), no router.
  *
  * Flow:
  *   Client texts NOX number

package/dist/router.js

@@ -1,7 +1,8 @@
 /**
- * Message Router — runs on YOUR Mac, routes to client Mac Minis.
+ * Message Router — legacy bridge mode.
  *
- * This is the bridge between rply-mac-server and life-pulse instances.
+ * This is only needed for multi-machine relay setups.
+ * Default deployment is direct NOX -> user's Mac gateway (:19877), no router.
  *
  * Flow:
  *   Client texts NOX number

package/dist/session-progress.d.ts

@@ -19,7 +19,7 @@ export interface ScanRecord {
 export interface SurfacedItem {
     id: string;
     title: string;
-    category: 'promise' | 'blocker' | 'bump' | 'handled' | 'intel';
+    category: 'promise' | 'blocker' | 'bump' | 'handled';
     surfacedAt: string;
     resolvedAt?: string;
 }
@@ -54,7 +54,7 @@ export interface SessionProgress {
         mood?: string;
     };
 }
-/** Load session progress, migrating from v1 if needed */
+/** Load session progress */
 export declare function loadProgress(): SessionProgress;
 /** Save session progress */
 export declare function saveProgress(progress: SessionProgress): void;

package/dist/session-progress.js

@@ -33,21 +33,12 @@ function defaultProgress() {
         lastContext: {},
     };
 }
-/** Load session progress, migrating from v1 if needed */
+/** Load session progress */
 export function loadProgress() {
     try {
         if (!existsSync(PROGRESS_FILE))
             return defaultProgress();
-        const data = JSON.parse(readFileSync(PROGRESS_FILE, 'utf-8'));
-        // Migration from v1 (or no version)
-        if (!data.version || data.version < 2) {
-            const migrated = defaultProgress();
-            migrated.firstRun = data.firstRun || migrated.firstRun;
-            migrated.lastSessionStart = data.lastSessionStart || migrated.lastSessionStart;
-            migrated.totalSessions = data.totalSessions || 0;
-            return migrated;
-        }
-        return data;
+        return JSON.parse(readFileSync(PROGRESS_FILE, 'utf-8'));
     }
     catch {
         return defaultProgress();

package/dist/skill-loader.d.ts

@@ -7,7 +7,7 @@
  *   2. Loadable (npm packages installed on demand)
  *   3. Local (scripts/tools found on the machine)
  *
- * The idea: `npx life-pulse` on a fresh Mac Mini scans iCloud,
+ * The idea: `npx life-pulse` on a fresh user Mac scans iCloud,
  * sees you use Obsidian + Things + Slack, and activates those skills.
  */
 export interface Skill {

package/dist/skill-loader.js

@@ -7,7 +7,7 @@
  *   2. Loadable (npm packages installed on demand)
  *   3. Local (scripts/tools found on the machine)
  *
- * The idea: `npx life-pulse` on a fresh Mac Mini scans iCloud,
+ * The idea: `npx life-pulse` on a fresh user Mac scans iCloud,
  * sees you use Obsidian + Things + Slack, and activates those skills.
  */
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';

package/dist/sms-gateway.d.ts

@@ -1,19 +1,14 @@
 /**
- * SMS Gateway — inbound HTTP server on the CLIENT's Mac Mini.
+ * SMS Gateway — inbound HTTP server on the user's Mac.
  *
- * Architecture:
- *   Client texts NOX phone number
- *     → rply-mac-server (YOUR Mac, imdaemon/imagentbridge)
- *     → Tailscale route to CLIENT's Mac Mini
- *     → POST http://<tailscale-ip>:19877/inbound {phone, message}
+ * Architecture (default deployment):
+ *   User texts NOX number
+ *     → NOX backend POSTs to this Mac over Tailscale
+ *     → POST http://<tailscale-endpoint>:19877/inbound {phone, message}
  *     → life-pulse conversation agent (local data: iMessage, calendar, etc.)
  *     → response JSON {response: "..."}
- *     → rply-mac-server sends iMessage reply from NOX number
  *
- * This file runs on the CLIENT's Mac Mini. It does NOT send messages —
- * rply-mac-server does that. This just processes inbound and returns responses.
- *
- * Port 19877 exposed via Tailscale (same tailnet as rply-mac-server).
+ * Port 19877 is exposed through Tailscale/Funnel.
  */
 declare const stats: {
     received: number;

package/dist/sms-gateway.js

@@ -1,19 +1,14 @@
 /**
- * SMS Gateway — inbound HTTP server on the CLIENT's Mac Mini.
+ * SMS Gateway — inbound HTTP server on the user's Mac.
  *
- * Architecture:
- *   Client texts NOX phone number
- *     → rply-mac-server (YOUR Mac, imdaemon/imagentbridge)
- *     → Tailscale route to CLIENT's Mac Mini
- *     → POST http://<tailscale-ip>:19877/inbound {phone, message}
+ * Architecture (default deployment):
+ *   User texts NOX number
+ *     → NOX backend POSTs to this Mac over Tailscale
+ *     → POST http://<tailscale-endpoint>:19877/inbound {phone, message}
  *     → life-pulse conversation agent (local data: iMessage, calendar, etc.)
  *     → response JSON {response: "..."}
- *     → rply-mac-server sends iMessage reply from NOX number
  *
- * This file runs on the CLIENT's Mac Mini. It does NOT send messages —
- * rply-mac-server does that. This just processes inbound and returns responses.
- *
- * Port 19877 exposed via Tailscale (same tailnet as rply-mac-server).
+ * Port 19877 is exposed through Tailscale/Funnel.
  */
 import { createServer } from 'http';
 import { resolveName } from './contacts.js';
@@ -124,6 +119,14 @@ export function startGateway(apiKey) {
     server.listen(GATEWAY_PORT, '0.0.0.0', () => {
         // silent startup — no infrastructure noise
     });
+    server.on('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+            // already running in another process — don't crash this one
+            server = null;
+            return;
+        }
+        server = null;
+    });
     return {
         port: GATEWAY_PORT,
         stop: () => { server?.close(); server = null; },

package/dist/state.d.ts

@@ -33,4 +33,4 @@ export declare function buildDeltaContext(): string;
 /** Check if an item should be surfaced (not recently shown) */
 export declare function shouldSurface(title: string): boolean;
 /** Record that an item was surfaced */
-export declare function markSurfaced(title: string, category: 'promise' | 'blocker' | 'bump' | 'handled' | 'intel'): void;
+export declare function markSurfaced(title: string, category: 'promise' | 'blocker' | 'bump' | 'handled'): void;

package/dist/state.js

@@ -38,23 +38,19 @@ export function saveState(analysis) {
         const now = dayjs().format('YYYY-MM-DD HH:mm:ss');
         // Extract key observations for history (keep last 50)
         const newEntries = [];
-        const decisions = analysis.decisions;
-        if (decisions) {
-            for (const d of decisions) {
+        const promises = analysis.promises;
+        if (promises) {
+            for (const d of promises) {
                 if (d.title)
-                    newEntries.push({ date: now, key: 'decision', value: d.title });
+                    newEntries.push({ date: now, key: 'promise', value: d.title });
             }
         }
-        const intel = analysis.intel;
-        if (intel) {
-            for (const v of intel)
-                newEntries.push({ date: now, key: 'intel', value: v });
-        }
-        // Legacy format support
-        const right_now = analysis.right_now;
-        if (right_now) {
-            for (const v of right_now)
-                newEntries.push({ date: now, key: 'right_now', value: v });
+        const blockers = analysis.blockers;
+        if (blockers) {
+            for (const d of blockers) {
+                if (d.title)
+                    newEntries.push({ date: now, key: 'blocker', value: d.title });
+            }
         }
         const history = [...prev.history, ...newEntries].slice(-50);
         const state = { lastRun: now, lastAnalysis: analysis, history, userDecisions: prev.userDecisions || [] };
@@ -111,9 +107,9 @@ export function buildDeltaContext() {
     if (state.lastRun) {
         lines.push('LAST SESSION PRESENTED:');
         const a = state.lastAnalysis;
-        const decisions = a.decisions;
-        if (decisions?.length) {
-            lines.push('  Decisions: ' + decisions.map(d => d.title || '').filter(Boolean).slice(0, 5).join(' | '));
+        const promises = a.promises;
+        if (promises?.length) {
+            lines.push('  Promises: ' + promises.map(d => d.title || '').filter(Boolean).slice(0, 5).join(' | '));
         }
         const userDecs = state.userDecisions || [];
         if (userDecs.length) {

package/dist/tools.js

@@ -13,9 +13,7 @@ import * as rply from './rply-client.js';
 import dayjs from 'dayjs';
 import { APPLE_EPOCH, CHROME_EPOCH } from './types.js';
 const home = homedir();
-const CAL_DB_NEW = join(home, 'Library/Group Containers/group.com.apple.calendar/Calendar.sqlitedb');
-const CAL_DB_LEGACY = join(home, 'Library/Calendars/Calendar.sqlitedb');
-const CAL_DB = existsSync(CAL_DB_NEW) ? CAL_DB_NEW : CAL_DB_LEGACY;
+const CAL_DB = join(home, 'Library/Group Containers/group.com.apple.calendar/Calendar.sqlitedb');
 // ─── Helpers ─────────────────────────────────────────────────────
 function daysAgoApple(days) {
     return dayjs().subtract(days, 'day').unix() - APPLE_EPOCH;

package/dist/transport.d.ts

@@ -5,7 +5,7 @@
  * Supports multiple transports simultaneously:
  *   1. iMessage (local) — reads Mac Messages DB, sends via AppleScript
  *   2. Telegram bot — receives via long-poll, sends via Bot API
- *   3. RPLY agent — routes through NOX phone number (future)
+ *   3. RPLY/NOX webhook — optional external ingress path
  *
  * Each transport implements the same interface so the message loop
  * doesn't care where messages come from.

package/dist/transport.js

@@ -5,7 +5,7 @@
  * Supports multiple transports simultaneously:
  *   1. iMessage (local) — reads Mac Messages DB, sends via AppleScript
  *   2. Telegram bot — receives via long-poll, sends via Bot API
- *   3. RPLY agent — routes through NOX phone number (future)
+ *   3. RPLY/NOX webhook — optional external ingress path
  *
  * Each transport implements the same interface so the message loop
  * doesn't care where messages come from.

package/dist/tui.d.ts

@@ -15,7 +15,6 @@ export declare const MAG: import("chalk").ChalkInstance;
 export declare const CYN: import("chalk").ChalkInstance;
 export declare const HD: import("chalk").ChalkInstance;
 export declare function renderIntro(name?: string): Promise<void>;
-export declare function renderGreeting(name?: string): void;
 export declare function renderContextLine(): void;
 export declare function renderCRMList(contacts: {
     name: string;
@@ -36,7 +35,7 @@ export interface Card {
     category?: string;
     who?: string;
 }
-export declare function pickCard(card: Card, num: number, _total?: number): Promise<string>;
+export declare function pickCard(card: Card, num: number, total?: number): Promise<string>;
 export declare function renderSectionHeader(label: string, color: (s: string) => string): void;
 export declare function renderSection(title: string, items: string[], bullet: string, colorBold: (s: string) => string, colorNorm: (s: string) => string): void;
 export declare function renderHandled(items: string[], max?: number): void;
@@ -68,6 +67,8 @@ interface InsightItem {
     label: string;
     text: string;
 }
-export declare function revealInsights(source: AsyncIterable<InsightItem>): Promise<void>;
+export declare function revealInsights(source: AsyncIterable<InsightItem>, opts?: {
+    maxWaitMs?: number;
+}): Promise<void>;
 export declare function destroyUI(): void;
 export {};

package/dist/tui.js

@@ -6,6 +6,10 @@
  */
 import * as ink from './ui/app.js';
 import { C, W } from './ui/theme.js';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
 // ─── Palette (backward-compat exports) ───
 export const B = C.faint;
 export const DIM = C.dim;
@@ -26,6 +30,13 @@ function out(text) {
     else
         console.log(text);
 }
+// Pinned output stays visible at the top in Ink mode.
+function outPinned(text) {
+    if (USE_INK)
+        ink.pinLine(text);
+    else
+        console.log(text);
+}
 // ─── Intro ───
 import chalk from 'chalk';
 const _sleep = (ms) => new Promise(r => setTimeout(r, ms));
@@ -94,42 +105,34 @@ function weatherRemark(weather) {
         return `${weather}. Stay inside.`;
     return `${weather}.`;
 }
-// ─── Geometric animation ───
-function renderScanField(cols, rows) {
-    const cy = Math.floor(rows / 2);
-    const shades = [
-        chalk.hex('#1a1b26'),
-        chalk.hex('#1a1b26'),
-        chalk.hex('#292e42'),
-        chalk.hex('#292e42'),
-        chalk.hex('#3b4261'),
-    ];
-    const lines = [];
-    for (let y = 0; y < rows; y++) {
-        const d = Math.abs(y - cy) / Math.max(cy, 1);
-        const brightness = 1 - d;
-        const segW = Math.max(0, Math.floor(cols * brightness * 0.85));
-        const pad = Math.floor((cols - segW) / 2);
-        if (segW < 4) {
-            lines.push(' '.repeat(cols));
-            continue;
-        }
-        const si = Math.min(Math.floor(brightness * shades.length), shades.length - 1);
-        const shade = shades[si];
-        // Thin lines with periodic breaks — creates a lens/field shape
-        let seg = '';
-        for (let x = 0; x < segW; x++) {
-            if (x === 0 || x === segW - 1)
-                seg += shade('·');
-            else if (x % 12 === 0)
-                seg += shade('·');
-            else
-                seg += shade('─');
-        }
-        lines.push(' '.repeat(pad) + seg + ' '.repeat(Math.max(0, cols - pad - segW)));
+// ─── Ghostty animation ───
+const GHOST_COLOR = '\x1b[38;5;75m'; // deep electric blue
+const GHOST_RESET = '\x1b[0m';
+function loadGhosttyFrames() {
+    try {
+        const dir = path.dirname(fileURLToPath(import.meta.url));
+        const raw = fs.readFileSync(path.join(dir, 'ghostty-frames.json'), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
     }
-    return lines;
 }
+function renderGhosttyLine(line) {
+    return line.replaceAll('<c>', GHOST_COLOR).replaceAll('</c>', GHOST_RESET);
+}
+// Big figlet banner via CJS require (no types shipped)
+const _require = createRequire(import.meta.url);
+function figletBanner(text, font = 'Doom') {
+    try {
+        const figlet = _require('figlet');
+        return figlet.textSync(text, { font }).split('\n');
+    }
+    catch {
+        return [text];
+    }
+}
+const _ghostFrames = loadGhosttyFrames();
 export async function renderIntro(name) {
     const firstName = name?.split(' ')[0] || name;
     // Fire IP-based location + weather fetch while animation runs
@@ -140,17 +143,48 @@ export async function renderIntro(name) {
     process.stdout.write('\n'.repeat(rows * 2));
     process.stdout.write('\x1B[2J\x1B[H');
     process.stdout.write('\x1B[?25l');
-    // === Phase 1: Geometric scan field ===
-    const field = renderScanField(cols, rows);
-    for (let y = 0; y < field.length; y++) {
-        process.stdout.write(`\x1B[${y + 1};1H${field[y]}`);
-        await _sleep(12);
+    // === Phase 1: Ghostty animation with big welcome banner ===
+    if (_ghostFrames.length > 0) {
+        const frameCount = Math.min(_ghostFrames.length, 150); // ~7.5s at 50ms/frame
+        const lineCount = _ghostFrames[0].length; // 41
+        const imageWidth = 77;
+        const padTop = Math.max(0, Math.floor((rows - lineCount) / 2));
+        const padLeft = Math.max(0, Math.floor((cols - imageWidth) / 2));
+        const leftPad = ' '.repeat(padLeft);
+        // Generate figlet welcome banner
+        const displayName = name || 'friend';
+        const bannerLines = figletBanner(`welcome\n${displayName}`);
+        const bannerWidth = Math.max(...bannerLines.map(l => l.length));
+        const bannerStartRow = padTop + lineCount + 2;
+        const bannerStyle = chalk.hex('#d4a574').bold;
+        const renderFrame = (frame, showBanner) => {
+            for (let y = 0; y < frame.length; y++) {
+                process.stdout.write(`\x1b[${padTop + y + 1};1H${leftPad}${renderGhosttyLine(frame[y])}`);
+            }
+            if (showBanner) {
+                for (let b = 0; b < bannerLines.length; b++) {
+                    const row = bannerStartRow + b;
+                    if (row > rows)
+                        break;
+                    const bCol = Math.max(1, Math.floor((cols - bannerWidth) / 2) + 1);
+                    process.stdout.write(`\x1b[${row};${bCol}H${bannerStyle(bannerLines[b])}`);
+                }
+            }
+        };
+        // First 40%: animation only. Then overlay the figlet banner.
+        const welcomeStart = Math.floor(frameCount * 0.4);
+        renderFrame(_ghostFrames[0], false);
+        await _sleep(50);
+        for (let i = 1; i < frameCount; i++) {
+            renderFrame(_ghostFrames[i], i >= welcomeStart);
+            await _sleep(50);
+        }
     }
-    await _sleep(350);
+    await _sleep(300);
     // === Phase 2: Greeting ===
     process.stdout.write('\x1B[2J\x1B[H');
     process.stdout.write('\n');
-    // "Hey Molly."
+    // "Hey <FirstName>."
     const hey = firstName ? `Hey ${firstName}.` : 'Hey.';
     process.stdout.write('  ');
     await typewrite(hey, G1, 35);
@@ -183,19 +217,6 @@ export async function renderIntro(name) {
     if (USE_INK)
         ink.initInk(greetLines);
 }
-// ─── Greeting (legacy / non-interactive fallback) ───
-export function renderGreeting(name) {
-    if (USE_INK) {
-        ink.initInk();
-        ink.log('');
-        ink.log(`  ${C.hd(name ? `Hey ${name}` : 'Hey')}`);
-    }
-    else {
-        process.stdout.write('\x1B[2J\x1B[H');
-        console.log();
-        console.log(`  ${HD(name ? `Hey ${name}` : 'Hey')}`);
-    }
-}
 // ─── Context line ───
 export function renderContextLine() {
     const d = new Date();
@@ -208,14 +229,15 @@ export function renderContextLine() {
 }
 // ─── CRM List ───
 export function renderCRMList(contacts) {
+    const emit = USE_INK ? outPinned : out;
     for (const t of contacts.slice(0, 12)) {
-        out(`  ${C.hd(t.name)}`);
+        emit(`  ${C.hd(t.name)}`);
     }
-    out('');
+    emit('');
 }
-export async function pickCard(card, num, _total) {
+export async function pickCard(card, num, total) {
     if (USE_INK) {
-        return ink.pickCard(card, num);
+        return ink.pickCard(card, num, total);
     }
     // Non-interactive: auto-pick first option
     if (card.fyi || !card.options?.length) {
@@ -302,8 +324,13 @@ export async function revealContacts(source) {
             buffer.push(t);
         done = true;
     })();
-    if (USE_INK)
+    if (USE_INK) {
+        outPinned('');
+        outPinned(`  ${C.faint('─'.repeat(W() - 4))}`);
+        outPinned(`  ${C.dim('relationship map')}`);
+        outPinned('');
         ink.showSpinner('reading the room');
+    }
     while (!done || buffer.length > 0) {
         if (buffer.length === 0) {
             await _sleep(80);
@@ -317,8 +344,9 @@ export async function revealContacts(source) {
         const name = t.name.slice(0, 24);
         const ago = shortAgo(t.lastMsg?.ago || '');
         const gap = Math.max(2, w - 4 - name.length - ago.length);
-        out('');
-        out(`  ${C.hd(name)}${' '.repeat(gap)}${C.dim(ago)}`);
+        const emit = USE_INK ? outPinned : out;
+        emit('');
+        emit(`  ${C.hd(name)}${' '.repeat(gap)}${C.dim(ago)}`);
         if (t.relationship) {
             // Word-wrap relationship across lines
             const maxW = w - 8;
@@ -326,7 +354,7 @@ export async function revealContacts(source) {
             let line = '';
             for (const word of words) {
                 if (line.length + word.length + 1 > maxW && line) {
-                    out(`    ${C.mid(line)}`);
+                    emit(`    ${C.mid(line)}`);
                     line = word;
                 }
                 else {
@@ -334,7 +362,7 @@ export async function revealContacts(source) {
                 }
             }
             if (line)
-                out(`    ${C.mid(line)}`);
+                emit(`    ${C.mid(line)}`);
         }
         // Wait for Enter before showing next (interactive only)
         if (USE_INK && (!done || buffer.length > 0)) {
@@ -344,12 +372,44 @@ export async function revealContacts(source) {
     await drain;
     if (USE_INK)
         ink.hideSpinner();
-    out('');
+    if (USE_INK)
+        outPinned('');
+    else
+        out('');
     return revealed;
 }
-export async function revealInsights(source) {
+export async function revealInsights(source, opts) {
     const w = W();
-    for await (const insight of source) {
+    const maxWaitMs = opts?.maxWaitMs ?? 0;
+    const deadline = maxWaitMs > 0 ? Date.now() + maxWaitMs : 0;
+    const it = source[Symbol.asyncIterator]();
+    while (true) {
+        const nextPromise = it.next();
+        let next;
+        if (deadline > 0) {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0) {
+                if (typeof it.return === 'function')
+                    await it.return();
+                return;
+            }
+            const timed = await Promise.race([
+                nextPromise.then(v => ({ kind: 'value', v })),
+                new Promise(resolve => setTimeout(() => resolve({ kind: 'timeout' }), remaining)),
+            ]);
+            if (timed.kind === 'timeout') {
+                if (typeof it.return === 'function')
+                    await it.return();
+                return;
+            }
+            next = timed.v;
+        }
+        else {
+            next = await nextPromise;
+        }
+        if (next.done)
+            return;
+        const insight = next.value;
         // Word-wrap the insight text
         const maxW = w - 6;
         const words = insight.text.split(' ');