heyiam 0.1.7 → 0.1.8

package/dist/routes/sessions.js

@@ -0,0 +1,103 @@
+import { Router } from 'express';
+import { listSessions, parseSession } from '../parsers/index.js';
+import { bridgeToAnalyzer } from '../bridge.js';
+import { analyzeSession } from '../analyzer.js';
+import { getSessionRow } from '../db.js';
+import { ensureSessionIndexed } from '../sync.js';
+import { exportSessionContext } from '../context-export.js';
+import { buildTranscriptResponse } from '../transcript.js';
+import { displayNameFromDir } from './context.js';
+/**
+ * Find a session's file path and project name, checking the DB first,
+ * then falling back to live discovery (triggers indexing as a side effect).
+ */
+async function resolveSession(ctx, id) {
+    // Try DB first
+    const row = getSessionRow(ctx.db, id);
+    if (row?.file_path) {
+        return { filePath: row.file_path, projectName: displayNameFromDir(row.project_dir) };
+    }
+    // Fallback: discover live sessions and index the match
+    const allSessions = await listSessions(ctx.sessionsBasePath);
+    const meta = allSessions.find((s) => s.sessionId === id);
+    if (!meta)
+        return null;
+    const projectName = displayNameFromDir(meta.projectDir);
+    try {
+        await ensureSessionIndexed(ctx.db, meta, projectName);
+    }
+    catch { /* best effort */ }
+    return { filePath: meta.path, projectName };
+}
+export function createSessionsRouter(ctx) {
+    const router = Router();
+    // Session by ID (cross-project lookup)
+    router.get('/api/sessions/:id', async (req, res) => {
+        try {
+            const id = String(req.params.id);
+            const resolved = await resolveSession(ctx, id);
+            if (!resolved) {
+                res.status(404).json({ error: { code: 'SESSION_NOT_FOUND', message: 'Session not found' } });
+                return;
+            }
+            const session = await ctx.loadSession(resolved.filePath, resolved.projectName, id);
+            res.json({ session });
+        }
+        catch (err) {
+            res.status(500).json({ error: { code: 'LOAD_FAILED', message: err.message } });
+        }
+    });
+    // Session context export
+    router.get('/api/sessions/:id/context', async (req, res) => {
+        try {
+            const id = String(req.params.id);
+            const format = (String(req.query.format ?? 'summary'));
+            const resolved = await resolveSession(ctx, id);
+            if (!resolved) {
+                res.status(404).json({ error: { code: 'SESSION_NOT_FOUND', message: 'Session not found' } });
+                return;
+            }
+            const parsed = await parseSession(resolved.filePath);
+            const analyzerInput = bridgeToAnalyzer(parsed, { sessionId: id, projectName: resolved.projectName });
+            const session = analyzeSession(analyzerInput);
+            const turns = analyzerInput.turns;
+            const result = exportSessionContext(session, turns, { tier: format });
+            res.json({
+                content: result.content,
+                tokens: result.tokens,
+                format: result.tier,
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: { code: 'CONTEXT_EXPORT_FAILED', message: err.message } });
+        }
+    });
+    // Session transcript — full conversation for the viewer
+    router.get('/api/sessions/:id/transcript', async (req, res) => {
+        try {
+            const id = String(req.params.id);
+            const resolved = await resolveSession(ctx, id);
+            if (!resolved) {
+                res.status(404).json({ error: { code: 'SESSION_NOT_FOUND', message: 'Session not found' } });
+                return;
+            }
+            const parsed = await parseSession(resolved.filePath);
+            const transcript = buildTranscriptResponse(parsed.raw_entries, {
+                cwd: parsed.cwd,
+                activeMinutes: parsed.duration_ms > 0 ? Math.max(1, Math.round(parsed.duration_ms / 60_000)) : 0,
+                wallClockMinutes: parsed.wall_clock_ms > 0 ? Math.max(1, Math.round(parsed.wall_clock_ms / 60_000)) : 0,
+                tokenUsage: parsed.token_usage ? {
+                    input_tokens: parsed.token_usage.input_tokens,
+                    output_tokens: parsed.token_usage.output_tokens,
+                } : undefined,
+                modelsUsed: parsed.models_used,
+            });
+            res.json(transcript);
+        }
+        catch (err) {
+            res.status(500).json({ error: { code: 'TRANSCRIPT_FAILED', message: err.message } });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=sessions.js.map

package/dist/routes/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/routes/sessions.ts"],"names":[],"mappings":"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"}

package/dist/routes/settings.d.ts

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+import type { RouteContext } from './context.js';
+export declare function createSettingsRouter(_ctx: RouteContext): Router;

package/dist/routes/settings.js

@@ -0,0 +1,30 @@
+import { Router } from 'express';
+import { saveAnthropicApiKey, clearAnthropicApiKey, getAnthropicApiKey } from '../settings.js';
+import { getEnhanceMode } from '../llm/index.js';
+export function createSettingsRouter(_ctx) {
+    const router = Router();
+    // Save or clear the Anthropic API key
+    router.post('/api/settings/api-key', (req, res) => {
+        const { apiKey } = req.body;
+        if (apiKey && typeof apiKey === 'string' && apiKey.trim()) {
+            saveAnthropicApiKey(apiKey.trim());
+            console.log('[settings] API key saved');
+            res.json({ ok: true, mode: getEnhanceMode() });
+        }
+        else {
+            clearAnthropicApiKey();
+            console.log('[settings] API key cleared');
+            res.json({ ok: true, mode: getEnhanceMode() });
+        }
+    });
+    // Get current API key status (masked)
+    router.get('/api/settings/api-key', (_req, res) => {
+        const key = getAnthropicApiKey();
+        res.json({
+            hasKey: !!key,
+            maskedKey: key ? `${key.slice(0, 4)}...` : null,
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=settings.js.map

package/dist/routes/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,sCAAsC;IACtC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACnE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,IAA2B,CAAC;QACnD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1D,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACxC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,oBAAoB,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QACnE,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,CAAC,CAAC,GAAG;YACb,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;SAChD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/screenshot.d.ts

@@ -1,10 +1,13 @@
+export declare const SCREENSHOTS_DIR: string;
 /**
  * Find the first available Chrome binary on the system.
  * Returns the path or null if not found.
  */
 export declare function findChrome(): string | null;
 /**
- * Capture a screenshot of a URL using headless Chrome.
- * Returns the local file path on success, or null if Chrome is unavailable or capture fails.
+ * Capture a full-page screenshot using Chrome DevTools Protocol.
+ * Uses Page.getLayoutMetrics for exact content height, then
+ * Page.captureScreenshot with captureBeyondViewport for a full capture.
+ * Falls back to CLI --screenshot on Node < 22 (no built-in WebSocket).
  */
 export declare function captureScreenshot(url: string, slug: string): Promise<string | null>;

package/dist/screenshot.js

@@ -1,8 +1,9 @@
-import { execFile } from 'node:child_process';
-import { existsSync, mkdirSync } from 'node:fs';
+import { spawn, execFile } from 'node:child_process';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir, platform } from 'node:os';
-const SCREENSHOTS_DIR = join(homedir(), '.config', 'heyiam', 'screenshots');
+import { get as httpGet } from 'node:http';
+export const SCREENSHOTS_DIR = join(homedir(), '.config', 'heyiam', 'screenshots');
 /** Known Chrome binary paths by platform */
 const CHROME_PATHS = {
     darwin: [
@@ -35,15 +36,98 @@ export function findChrome() {
     return null;
 }
 /**
- * Capture a screenshot of a URL using headless Chrome.
- * Returns the local file path on success, or null if Chrome is unavailable or capture fails.
+ * Validate that a URL is safe for screenshot capture.
+ * Only allows http/https schemes and rejects private/internal IPs.
  */
-export async function captureScreenshot(url, slug) {
-    const chrome = findChrome();
-    if (!chrome)
-        return null;
-    mkdirSync(SCREENSHOTS_DIR, { recursive: true });
-    const outPath = join(SCREENSHOTS_DIR, `${slug}.png`);
+function isUrlSafe(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        return false;
+    }
+    // Only allow http(s)
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+        return false;
+    // Reject localhost and private IPs
+    const host = parsed.hostname.toLowerCase();
+    if (host === 'localhost' || host === '127.0.0.1' || host === '::1') {
+        // Allow our own preview server
+        const port = parsed.port || (parsed.protocol === 'https:' ? '443' : '80');
+        if (port !== '17845')
+            return false;
+    }
+    // Reject private IP ranges
+    if (/^(10\.|172\.(1[6-9]|2\d|3[01])\.|192\.168\.|169\.254\.|0\.)/.test(host))
+        return false;
+    if (host.endsWith('.local') || host.endsWith('.internal'))
+        return false;
+    return true;
+}
+/**
+ * Sanitize a slug for use as a filename — alphanumeric, hyphens, underscores only.
+ */
+function sanitizeSlug(slug) {
+    return slug.replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 200);
+}
+/** Send a CDP command over WebSocket and wait for the response */
+function cdpSend(ws, method, params = {}) {
+    const id = Math.floor(Math.random() * 1e9);
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error(`CDP timeout: ${method}`)), 15_000);
+        const handler = (event) => {
+            const msg = JSON.parse(String(event.data));
+            if (msg.id === id) {
+                ws.removeEventListener('message', handler);
+                clearTimeout(timeout);
+                if (msg.error)
+                    reject(new Error(msg.error.message));
+                else
+                    resolve(msg.result ?? {});
+            }
+        };
+        ws.addEventListener('message', handler);
+        ws.send(JSON.stringify({ id, method, params }));
+    });
+}
+/** Wait for a specific CDP event */
+function cdpWaitFor(ws, eventName, timeoutMs = 15_000) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error(`CDP event timeout: ${eventName}`)), timeoutMs);
+        const handler = (event) => {
+            const msg = JSON.parse(String(event.data));
+            if (msg.method === eventName) {
+                ws.removeEventListener('message', handler);
+                clearTimeout(timeout);
+                resolve();
+            }
+        };
+        ws.addEventListener('message', handler);
+    });
+}
+/** Fetch JSON from a local HTTP endpoint */
+function fetchJson(url) {
+    return new Promise((resolve, reject) => {
+        httpGet(url, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk.toString(); });
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch {
+                    reject(new Error('Invalid JSON'));
+                }
+            });
+        }).on('error', reject);
+    });
+}
+/**
+ * Fallback: capture using Chrome CLI --screenshot (viewport-only, not full page).
+ * Used when WebSocket is unavailable (Node < 22).
+ */
+async function captureScreenshotFallback(chrome, url, outPath) {
     try {
         await new Promise((resolve, reject) => {
             execFile(chrome, [
@@ -69,12 +153,102 @@ export async function captureScreenshot(url, slug) {
                     resolve();
             });
         });
-        if (existsSync(outPath))
-            return outPath;
+        return existsSync(outPath) ? outPath : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Capture a full-page screenshot using Chrome DevTools Protocol.
+ * Uses Page.getLayoutMetrics for exact content height, then
+ * Page.captureScreenshot with captureBeyondViewport for a full capture.
+ * Falls back to CLI --screenshot on Node < 22 (no built-in WebSocket).
+ */
+export async function captureScreenshot(url, slug) {
+    if (!isUrlSafe(url))
+        return null;
+    const chrome = findChrome();
+    if (!chrome)
         return null;
+    mkdirSync(SCREENSHOTS_DIR, { recursive: true });
+    const safeSlug = sanitizeSlug(slug);
+    const outPath = join(SCREENSHOTS_DIR, `${safeSlug}.png`);
+    // Fall back to CLI --screenshot if WebSocket is unavailable (Node < 22)
+    if (typeof globalThis.WebSocket === 'undefined') {
+        return captureScreenshotFallback(chrome, url, outPath);
+    }
+    // Launch Chrome with remote debugging on auto-assigned port
+    const proc = spawn(chrome, [
+        '--headless=new',
+        '--disable-gpu',
+        '--no-sandbox',
+        '--disable-software-rasterizer',
+        '--window-size=1280,800',
+        '--hide-scrollbars',
+        '--disable-extensions',
+        '--disable-background-networking',
+        '--disable-sync',
+        '--disable-translate',
+        '--disable-default-apps',
+        '--mute-audio',
+        '--no-first-run',
+        '--remote-debugging-port=0',
+        'about:blank',
+    ], { stdio: ['ignore', 'ignore', 'pipe'] });
+    try {
+        // Parse the debug port from Chrome's stderr
+        const port = await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => reject(new Error('Chrome startup timeout')), 10_000);
+            let stderr = '';
+            proc.stderr.on('data', (chunk) => {
+                stderr += chunk.toString();
+                const match = stderr.match(/DevTools listening on ws:\/\/127\.0\.0\.1:(\d+)\//);
+                if (match) {
+                    clearTimeout(timeout);
+                    resolve(parseInt(match[1], 10));
+                }
+            });
+            proc.on('exit', () => { clearTimeout(timeout); reject(new Error('Chrome exited early')); });
+        });
+        // Find the page target's WebSocket URL
+        const targets = await fetchJson(`http://127.0.0.1:${port}/json/list`);
+        const pageTarget = targets.find((t) => t.type === 'page');
+        if (!pageTarget)
+            throw new Error('No page target found');
+        // Connect via CDP
+        const ws = new WebSocket(pageTarget.webSocketDebuggerUrl);
+        await new Promise((resolve, reject) => {
+            ws.addEventListener('open', () => resolve());
+            ws.addEventListener('error', () => reject(new Error('WebSocket connection failed')));
+        });
+        // Enable Page events and navigate
+        await cdpSend(ws, 'Page.enable');
+        const loadPromise = cdpWaitFor(ws, 'Page.loadEventFired', 20_000);
+        await cdpSend(ws, 'Page.navigate', { url });
+        await loadPromise;
+        // Small delay for lazy-loaded content / animations
+        await new Promise((r) => setTimeout(r, 1500));
+        // Get the actual content dimensions
+        const metrics = await cdpSend(ws, 'Page.getLayoutMetrics');
+        const width = 1280;
+        const height = Math.min(Math.ceil(metrics.contentSize.height), 10_000); // cap at 10k px
+        // Capture full-page screenshot
+        const result = await cdpSend(ws, 'Page.captureScreenshot', {
+            format: 'png',
+            captureBeyondViewport: true,
+            clip: { x: 0, y: 0, width, height, scale: 1 },
+        });
+        // Write to disk
+        writeFileSync(outPath, Buffer.from(result.data, 'base64'));
+        ws.close();
+        return outPath;
     }
     catch {
         return null;
     }
+    finally {
+        proc.kill();
+    }
 }
 //# sourceMappingURL=screenshot.js.map

package/dist/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAE5E,4CAA4C;AAC5C,MAAM,YAAY,GAA6B;IAC7C,MAAM,EAAE;QACN,8DAA8D;QAC9D,oDAAoD;QACpD,4EAA4E;KAC7E;IACD,KAAK,EAAE;QACL,wBAAwB;QACxB,+BAA+B;QAC/B,mBAAmB;QACnB,2BAA2B;QAC3B,oBAAoB;KACrB;IACD,KAAK,EAAE;QACL,4DAA4D;QAC5D,kEAAkE;KACnE;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,IAAY;IAC/D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,QAAQ,CAAC,MAAM,EAAE;gBACf,gBAAgB;gBAChB,eAAe;gBACf,cAAc;gBACd,+BAA+B;gBAC/B,gBAAgB,OAAO,EAAE;gBACzB,wBAAwB;gBACxB,mBAAmB;gBACnB,sBAAsB;gBACtB,iCAAiC;gBACjC,gBAAgB;gBAChB,qBAAqB;gBACrB,wBAAwB;gBACxB,cAAc;gBACd,gBAAgB;gBAChB,GAAG;aACJ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC9B,IAAI,GAAG;oBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;oBAChB,OAAO,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"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"}

package/dist/search.d.ts

@@ -0,0 +1,30 @@
+import type Database from 'better-sqlite3';
+export interface SearchFilters {
+    project?: string;
+    source?: string;
+    after?: string;
+    before?: string;
+    skill?: string;
+    file?: string;
+    minDuration?: number;
+}
+export interface SearchResult {
+    sessionId: string;
+    title: string;
+    projectDir: string;
+    projectName: string;
+    source: string;
+    date: string;
+    durationMinutes: number;
+    turns: number;
+    linesOfCode: number;
+    skills: string[];
+    snippet: string;
+    score: number;
+}
+/**
+ * Decode projectDir to a human-readable project name.
+ * e.g. "-Users-test-Dev-myapp" → "Users/test/Dev/myapp"
+ */
+export declare function decodeProjectName(projectDir: string): string;
+export declare function searchSessions(db: Database.Database, query?: string, filters?: SearchFilters): SearchResult[];

package/dist/search.js

@@ -0,0 +1,153 @@
+// Search logic combining FTS5 content search with metadata filters
+import { searchFts } from './db.js';
+// ── Helpers ──────────────────────────────────────────────────
+/**
+ * Decode projectDir to a human-readable project name.
+ * e.g. "-Users-test-Dev-myapp" → "Users/test/Dev/myapp"
+ */
+export function decodeProjectName(projectDir) {
+    return projectDir.replace(/^-/, '').replace(/-/g, '/');
+}
+function rowToResult(row, snippet, score) {
+    const skills = row.skills ? JSON.parse(row.skills) : [];
+    return {
+        sessionId: row.id,
+        title: row.title ?? '',
+        projectDir: row.project_dir,
+        projectName: decodeProjectName(row.project_dir),
+        source: row.source,
+        date: row.start_time ?? '',
+        durationMinutes: row.duration_minutes ?? 0,
+        turns: row.turns ?? 0,
+        linesOfCode: (row.loc_added ?? 0) + (row.loc_removed ?? 0),
+        skills,
+        snippet,
+        score,
+    };
+}
+// ── Main Search Function ─────────────────────────────────────
+const MAX_RESULTS = 50;
+export function searchSessions(db, query, filters) {
+    if (query) {
+        return searchWithFts(db, query, filters);
+    }
+    return searchWithFilters(db, filters);
+}
+// ── FTS path: query provided ─────────────────────────────────
+function searchWithFts(db, query, filters) {
+    // FTS now returns deduplicated results (one per session, best rank)
+    const ftsResults = searchFts(db, query, MAX_RESULTS * 3);
+    if (ftsResults.length === 0)
+        return [];
+    const fileSessionIds = filters?.file ? getFileFilteredSessionIds(db, filters.file) : null;
+    // F10: Batch fetch all session rows in one query instead of N+1
+    const ftsIds = ftsResults.map((r) => r.sessionId);
+    const placeholders = ftsIds.map(() => '?').join(',');
+    const allRows = db.prepare(`SELECT * FROM sessions WHERE id IN (${placeholders})`).all(...ftsIds);
+    const rowMap = new Map();
+    for (const row of allRows)
+        rowMap.set(row.id, row);
+    // Apply metadata filters and build results in FTS rank order
+    const results = [];
+    for (const fts of ftsResults) {
+        if (fileSessionIds && !fileSessionIds.has(fts.sessionId))
+            continue;
+        const row = rowMap.get(fts.sessionId);
+        if (!row)
+            continue;
+        if (!matchesFilters(row, filters))
+            continue;
+        results.push(rowToResult(row, fts.snippet, fts.rank));
+        if (results.length >= MAX_RESULTS)
+            break;
+    }
+    return results;
+}
+// ── Filter-only path: no text query ──────────────────────────
+function searchWithFilters(db, filters) {
+    const conditions = [];
+    const params = [];
+    if (filters?.project) {
+        conditions.push('s.project_dir LIKE ?');
+        params.push(`%${filters.project}%`);
+    }
+    if (filters?.source) {
+        conditions.push('s.source = ?');
+        params.push(filters.source);
+    }
+    if (filters?.after) {
+        conditions.push('s.start_time >= ?');
+        params.push(filters.after);
+    }
+    if (filters?.before) {
+        conditions.push('s.start_time <= ?');
+        params.push(filters.before);
+    }
+    if (filters?.minDuration) {
+        conditions.push('s.duration_minutes >= ?');
+        params.push(filters.minDuration);
+    }
+    if (filters?.skill) {
+        // F25: Use json_each for proper JSON array searching instead of LIKE
+        conditions.push('EXISTS (SELECT 1 FROM json_each(s.skills) WHERE value = ?)');
+        params.push(filters.skill);
+    }
+    let sql;
+    if (filters?.file) {
+        sql = `
+      SELECT DISTINCT s.*
+      FROM sessions s
+      JOIN session_files sf ON sf.session_id = s.id
+      WHERE sf.file_path LIKE ?
+      ${conditions.length ? 'AND ' + conditions.join(' AND ') : ''}
+      ORDER BY s.start_time DESC
+      LIMIT ?
+    `;
+        params.unshift(`%${filters.file}%`);
+        params.push(MAX_RESULTS);
+    }
+    else {
+        sql = `
+      SELECT s.*
+      FROM sessions s
+      ${conditions.length ? 'WHERE ' + conditions.join(' AND ') : ''}
+      ORDER BY s.start_time DESC
+      LIMIT ?
+    `;
+        params.push(MAX_RESULTS);
+    }
+    const rows = db.prepare(sql).all(...params);
+    return rows.map((row, i) => rowToResult(row, '', i));
+}
+// ── Filter helpers ───────────────────────────────────────────
+function matchesFilters(row, filters) {
+    if (!filters)
+        return true;
+    if (filters.project && !row.project_dir.includes(filters.project)) {
+        return false;
+    }
+    if (filters.source && row.source !== filters.source) {
+        return false;
+    }
+    if (filters.after && (row.start_time ?? '') < filters.after) {
+        return false;
+    }
+    if (filters.before && (row.start_time ?? '') > filters.before) {
+        return false;
+    }
+    if (filters.minDuration && (row.duration_minutes ?? 0) < filters.minDuration) {
+        return false;
+    }
+    if (filters.skill) {
+        const skills = row.skills ? JSON.parse(row.skills) : [];
+        if (!skills.includes(filters.skill)) {
+            return false;
+        }
+    }
+    return true;
+}
+function getFileFilteredSessionIds(db, filePath) {
+    const rows = db.prepare('SELECT DISTINCT session_id FROM session_files WHERE file_path LIKE ?').all(`%${filePath}%`);
+    return new Set(rows.map((r) => r.session_id));
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -1,3 +1,3 @@
 import type { Server } from 'node:http';
-export declare function createApp(sessionsBasePath?: string): import("express-serve-static-core").Express;
+export declare function createApp(sessionsBasePath?: string, dbPath?: string): import("express-serve-static-core").Express;
 export declare function startServer(port?: number): Promise<Server>;