heyiam 0.1.7 → 0.1.8

package/dist/db.js

@@ -0,0 +1,444 @@
+// SQLite search index for session archive
+// Replaces stats-cache.json with a proper database layer
+import Database from 'better-sqlite3';
+import { mkdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+// ── Constants ────────────────────────────────────────────────
+const CONFIG_DIR = join(homedir(), '.config', 'heyiam');
+export const DB_PATH = join(CONFIG_DIR, 'sessions.db');
+const CURRENT_SCHEMA_VERSION = 2;
+// ── Singleton ────────────────────────────────────────────────
+let _db = null;
+export function getDatabase(dbPath = DB_PATH) {
+    if (_db)
+        return _db;
+    _db = openDatabase(dbPath);
+    return _db;
+}
+export function closeDatabase() {
+    if (_db) {
+        _db.close();
+        _db = null;
+    }
+}
+// ── Open / Migrate ───────────────────────────────────────────
+export function openDatabase(dbPath = DB_PATH) {
+    mkdirSync(join(dbPath, '..'), { recursive: true });
+    const db = new Database(dbPath);
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    runMigrations(db);
+    return db;
+}
+function runMigrations(db) {
+    // Create schema_version table if it doesn't exist
+    db.exec(`CREATE TABLE IF NOT EXISTS schema_version (version INTEGER)`);
+    const row = db.prepare('SELECT version FROM schema_version LIMIT 1').get();
+    const currentVersion = row?.version ?? 0;
+    if (currentVersion < 2) {
+        migrateToV2(db);
+    }
+}
+function migrateToV2(db) {
+    // Drop old tables if upgrading from v1
+    db.exec('DROP TABLE IF EXISTS session_files');
+    db.exec('DROP TABLE IF EXISTS sessions_fts');
+    db.exec('DROP TABLE IF EXISTS sessions');
+    const tx = db.transaction(() => {
+        // F1: session_files gets composite PK
+        // F2: ON DELETE CASCADE on all foreign keys
+        // F5: NOT NULL DEFAULT on numeric columns
+        // F7: role UNINDEXED in FTS5
+        // F21: file_mtime as INTEGER not REAL
+        db.exec(`
+      CREATE TABLE sessions (
+        id TEXT PRIMARY KEY,
+        project_dir TEXT NOT NULL,
+        source TEXT NOT NULL,
+        title TEXT,
+        start_time TEXT,
+        end_time TEXT,
+        duration_minutes REAL NOT NULL DEFAULT 0,
+        wall_clock_minutes REAL NOT NULL DEFAULT 0,
+        turns INTEGER NOT NULL DEFAULT 0,
+        loc_added INTEGER NOT NULL DEFAULT 0,
+        loc_removed INTEGER NOT NULL DEFAULT 0,
+        loc_net INTEGER NOT NULL DEFAULT 0,
+        files_changed INTEGER NOT NULL DEFAULT 0,
+        tool_calls INTEGER NOT NULL DEFAULT 0,
+        skills TEXT,
+        files_touched TEXT,
+        models_used TEXT,
+        cwd TEXT,
+        parent_session_id TEXT,
+        agent_role TEXT,
+        is_subagent INTEGER NOT NULL DEFAULT 0,
+        file_path TEXT,
+        file_mtime INTEGER,
+        file_size INTEGER,
+        indexed_at TEXT,
+        context_summary TEXT,
+        FOREIGN KEY (parent_session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      )
+    `);
+        db.exec('CREATE INDEX idx_sessions_project ON sessions(project_dir)');
+        db.exec('CREATE INDEX idx_sessions_source ON sessions(source)');
+        db.exec('CREATE INDEX idx_sessions_start ON sessions(start_time)');
+        db.exec('CREATE INDEX idx_sessions_parent ON sessions(parent_session_id)');
+        db.exec(`
+      CREATE VIRTUAL TABLE sessions_fts USING fts5(
+        session_id UNINDEXED,
+        role UNINDEXED,
+        content,
+        tokenize='porter unicode61'
+      )
+    `);
+        db.exec(`
+      CREATE TABLE session_files (
+        session_id TEXT NOT NULL,
+        file_path TEXT NOT NULL,
+        additions INTEGER NOT NULL DEFAULT 0,
+        deletions INTEGER NOT NULL DEFAULT 0,
+        PRIMARY KEY (session_id, file_path),
+        FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      )
+    `);
+        db.exec('CREATE INDEX idx_session_files_path ON session_files(file_path)');
+        // Upsert schema version
+        const existing = db.prepare('SELECT version FROM schema_version LIMIT 1').get();
+        if (existing) {
+            db.prepare('UPDATE schema_version SET version = ?').run(CURRENT_SCHEMA_VERSION);
+        }
+        else {
+            db.prepare('INSERT INTO schema_version (version) VALUES (?)').run(CURRENT_SCHEMA_VERSION);
+        }
+    });
+    tx();
+}
+// ── Staleness Check ──────────────────────────────────────────
+export function isSessionStale(db, sessionId, filePath) {
+    const row = db.prepare('SELECT file_mtime, file_size FROM sessions WHERE id = ?').get(sessionId);
+    if (!row)
+        return true; // Not in DB — needs indexing
+    // Skip stat for non-filesystem paths (e.g. cursor:// URLs) — F23 fix
+    if (filePath.includes('://'))
+        return true;
+    try {
+        const stat = statSync(filePath);
+        // F21: Use Math.floor to avoid floating-point comparison issues
+        const mtime = Math.floor(stat.mtimeMs);
+        const size = stat.size;
+        return mtime !== row.file_mtime || size !== row.file_size;
+    }
+    catch {
+        return true; // Can't stat — re-index to be safe
+    }
+}
+export function upsertSession(db, input) {
+    const { meta, analysis, session, fileMtime, fileSize } = input;
+    const stmt = db.prepare(`
+    INSERT INTO sessions (
+      id, project_dir, source, title, start_time, end_time,
+      duration_minutes, wall_clock_minutes, turns, loc_added, loc_removed, loc_net,
+      files_changed, tool_calls, skills, files_touched, models_used,
+      cwd, parent_session_id, agent_role, is_subagent,
+      file_path, file_mtime, file_size, indexed_at, context_summary
+    ) VALUES (
+      ?, ?, ?, ?, ?, ?,
+      ?, ?, ?, ?, ?, ?,
+      ?, ?, ?, ?, ?,
+      ?, ?, ?, ?,
+      ?, ?, ?, ?, ?
+    )
+    ON CONFLICT(id) DO UPDATE SET
+      project_dir = excluded.project_dir,
+      source = excluded.source,
+      title = excluded.title,
+      start_time = excluded.start_time,
+      end_time = excluded.end_time,
+      duration_minutes = excluded.duration_minutes,
+      wall_clock_minutes = excluded.wall_clock_minutes,
+      turns = excluded.turns,
+      loc_added = excluded.loc_added,
+      loc_removed = excluded.loc_removed,
+      loc_net = excluded.loc_net,
+      files_changed = excluded.files_changed,
+      tool_calls = excluded.tool_calls,
+      skills = excluded.skills,
+      files_touched = excluded.files_touched,
+      models_used = excluded.models_used,
+      cwd = excluded.cwd,
+      parent_session_id = excluded.parent_session_id,
+      agent_role = excluded.agent_role,
+      is_subagent = excluded.is_subagent,
+      file_path = excluded.file_path,
+      file_mtime = excluded.file_mtime,
+      file_size = excluded.file_size,
+      indexed_at = excluded.indexed_at,
+      context_summary = excluded.context_summary
+  `);
+    stmt.run(meta.sessionId, meta.projectDir, analysis.source, session.title ?? null, analysis.start_time ?? null, analysis.end_time ?? null, session.durationMinutes, session.wallClockMinutes ?? 0, session.turns, analysis.loc_stats.loc_added, analysis.loc_stats.loc_removed, analysis.loc_stats.loc_net, session.filesChanged.length, session.toolCalls, JSON.stringify(session.skills), JSON.stringify(analysis.files_touched), JSON.stringify(analysis.models_used ?? []), analysis.cwd ?? null, meta.parentSessionId ?? null, meta.agentRole ?? null, meta.isSubagent ? 1 : 0, meta.path, Math.floor(fileMtime), fileSize, new Date().toISOString(), input.contextSummary ?? null);
+}
+// ── Index Session Content (FTS5) ─────────────────────────────
+export function indexSessionContent(db, sessionId, turns) {
+    // Clear existing FTS entries for this session
+    db.prepare('DELETE FROM sessions_fts WHERE session_id = ?').run(sessionId);
+    const insert = db.prepare('INSERT INTO sessions_fts (session_id, role, content) VALUES (?, ?, ?)');
+    // F8: Truncate content per turn to prevent FTS index bloat.
+    // Tool outputs (file reads, command output) can be 50KB+ but are low-value for search.
+    const MAX_CONTENT_CHARS = 10_000;
+    for (const turn of turns) {
+        const role = turn.type === 'prompt' ? 'user' : turn.type === 'tool' ? 'tool' : 'assistant';
+        const content = turn.content;
+        if (content && content.length > 0) {
+            const truncated = content.length > MAX_CONTENT_CHARS
+                ? content.slice(0, MAX_CONTENT_CHARS)
+                : content;
+            insert.run(sessionId, role, truncated);
+        }
+    }
+}
+// ── Index Session Files ──────────────────────────────────────
+export function indexSessionFiles(db, sessionId, files) {
+    db.prepare('DELETE FROM session_files WHERE session_id = ?').run(sessionId);
+    const insert = db.prepare('INSERT OR REPLACE INTO session_files (session_id, file_path, additions, deletions) VALUES (?, ?, ?, ?)');
+    for (const file of files) {
+        insert.run(sessionId, file.path, file.additions, file.deletions);
+    }
+}
+// ── Full Index Pipeline (transactional) ──────────────────────
+export function indexSession(db, input, turns) {
+    const tx = db.transaction(() => {
+        upsertSession(db, input);
+        indexSessionContent(db, input.meta.sessionId, turns);
+        indexSessionFiles(db, input.meta.sessionId, input.session.filesChanged);
+    });
+    tx();
+}
+// ── Read: Get Session Stats ──────────────────────────────────
+export function getSessionStats(db, sessionId) {
+    const row = db.prepare(`
+    SELECT
+      id, start_time, end_time, duration_minutes, turns,
+      loc_added, loc_removed, files_changed, skills
+    FROM sessions WHERE id = ?
+  `).get(sessionId);
+    if (!row)
+        return null;
+    const loc = (row.loc_added ?? 0) + (row.loc_removed ?? 0);
+    const skills = row.skills ? JSON.parse(row.skills) : [];
+    return {
+        loc,
+        duration: row.duration_minutes ?? 0,
+        files: row.files_changed ?? 0,
+        turns: row.turns ?? 0,
+        skills,
+        date: row.start_time ?? '',
+        endTime: row.end_time ?? undefined,
+    };
+}
+// ── Read: Get All Project Stats ──────────────────────────────
+export function getAllProjectStats(db) {
+    // F9: Single query — no N+1. Fetch aggregates and skills in one pass.
+    const rows = db.prepare(`
+    SELECT
+      project_dir,
+      COUNT(*) as session_count,
+      COALESCE(SUM(loc_added + loc_removed), 0) as total_loc,
+      COALESCE(SUM(duration_minutes), 0) as total_duration,
+      COALESCE(SUM(turns), 0) as total_turns,
+      MAX(start_time) as latest_date,
+      GROUP_CONCAT(DISTINCT source) as sources
+    FROM sessions
+    WHERE is_subagent = 0
+    GROUP BY project_dir
+    ORDER BY latest_date DESC
+  `).all();
+    // Collect all skills in a single query, grouped by project
+    const skillRows = db.prepare('SELECT project_dir, skills FROM sessions WHERE skills IS NOT NULL AND is_subagent = 0').all();
+    const skillsByProject = new Map();
+    for (const sr of skillRows) {
+        const parsed = JSON.parse(sr.skills);
+        if (!skillsByProject.has(sr.project_dir)) {
+            skillsByProject.set(sr.project_dir, new Set());
+        }
+        const set = skillsByProject.get(sr.project_dir);
+        for (const s of parsed)
+            set.add(s);
+    }
+    return rows.map((row) => {
+        const projectSkills = skillsByProject.get(row.project_dir);
+        const projectName = row.project_dir.replace(/^-/, '').split('-').pop() ?? row.project_dir;
+        return {
+            projectDir: row.project_dir,
+            projectName,
+            sessionCount: row.session_count,
+            totalLoc: row.total_loc,
+            totalDuration: row.total_duration,
+            totalTurns: row.total_turns,
+            skills: projectSkills ? [...projectSkills].sort() : [],
+            sources: row.sources ? row.sources.split(',') : [],
+            latestDate: row.latest_date ?? '',
+        };
+    });
+}
+// ── Read: Get Session Row ────────────────────────────────────
+export function getSessionRow(db, sessionId) {
+    return db.prepare('SELECT * FROM sessions WHERE id = ?').get(sessionId) ?? null;
+}
+// ── Read: Get Context Summary ─────────────────────────────────
+export function getContextSummary(db, sessionId) {
+    const row = db.prepare('SELECT context_summary FROM sessions WHERE id = ?').get(sessionId);
+    return row?.context_summary ?? null;
+}
+// ── Read: List sessions by project ───────────────────────────
+export function getSessionsByProject(db, projectDir) {
+    return db.prepare('SELECT * FROM sessions WHERE project_dir = ? ORDER BY start_time DESC').all(projectDir);
+}
+// ── Delete ───────────────────────────────────────────────────
+export function deleteSession(db, sessionId) {
+    const tx = db.transaction(() => {
+        db.prepare('DELETE FROM sessions_fts WHERE session_id = ?').run(sessionId);
+        db.prepare('DELETE FROM session_files WHERE session_id = ?').run(sessionId);
+        db.prepare('DELETE FROM sessions WHERE id = ?').run(sessionId);
+    });
+    tx();
+}
+// ── Rebuild Index ────────────────────────────────────────────
+export function rebuildIndex(db, onProgress) {
+    const tx = db.transaction(() => {
+        db.exec('DELETE FROM sessions_fts');
+        db.exec('DELETE FROM session_files');
+        db.exec('DELETE FROM sessions');
+    });
+    tx();
+    onProgress?.(0, 0);
+}
+/** F17: Merge FTS5 segments for better query performance. Call after bulk indexing. */
+export function optimizeFtsIndex(db) {
+    db.exec("INSERT INTO sessions_fts(sessions_fts) VALUES('optimize')");
+}
+// ── Cleanup ──────────────────────────────────────────────────
+//
+// IMPORTANT: We do NOT delete sessions from the DB when the source file
+// is gone. The DB IS the archive — if Claude Code deleted the original
+// after 30 days, the DB row is the preserved copy. That's the whole
+// point of the product.
+//
+// The only valid cleanup is removing sessions that the USER explicitly
+// chose to delete, which would go through deleteSession() directly.
+/** Count sessions whose source file no longer exists (preserved in DB). */
+export function countPreservedSessions(db) {
+    const rows = db.prepare("SELECT file_path FROM sessions WHERE file_path IS NOT NULL AND file_path NOT LIKE 'cursor://%'").all();
+    let preserved = 0;
+    for (const row of rows) {
+        try {
+            statSync(row.file_path);
+        }
+        catch {
+            preserved++;
+        }
+    }
+    return preserved;
+}
+/**
+ * Escape a user query for FTS5. Wraps each term in double quotes
+ * to prevent FTS5 syntax injection (*, OR, NOT, NEAR, etc.).
+ */
+function escapeFtsQuery(raw) {
+    // Split on whitespace, quote each non-empty term
+    const terms = raw.trim().split(/\s+/).filter(Boolean);
+    if (terms.length === 0)
+        return '""';
+    return terms.map((t) => `"${t.replace(/"/g, '""')}"`).join(' ');
+}
+export function searchFts(db, query, limit = 50) {
+    const safeQuery = escapeFtsQuery(query);
+    // Fetch a larger window of raw FTS matches, then deduplicate in JS.
+    // We fetch limit*10 rows to ensure we get enough distinct sessions,
+    // since a single session can have dozens of matching turns.
+    const rawRows = db.prepare(`
+    SELECT
+      session_id,
+      snippet(sessions_fts, 2, '<mark>', '</mark>', '...', 40) as snippet,
+      rank
+    FROM sessions_fts
+    WHERE sessions_fts MATCH ?
+    ORDER BY rank
+    LIMIT ?
+  `).all(safeQuery, limit * 10);
+    // Deduplicate: keep best-ranking entry per session
+    const bySession = new Map();
+    for (const r of rawRows) {
+        const existing = bySession.get(r.session_id);
+        if (!existing || r.rank < existing.rank) {
+            bySession.set(r.session_id, r);
+        }
+    }
+    // Sort by rank and limit
+    const rows = [...bySession.values()]
+        .sort((a, b) => a.rank - b.rank)
+        .slice(0, limit);
+    return rows.map((r) => ({
+        sessionId: r.session_id,
+        snippet: r.snippet,
+        rank: r.rank,
+    }));
+}
+// ── File Search ──────────────────────────────────────────────
+export function searchByFile(db, filePath) {
+    // Escape LIKE wildcards in user input
+    const escaped = filePath.replace(/[%_]/g, (c) => `\\${c}`);
+    return db.prepare(`
+    SELECT session_id as sessionId, additions, deletions
+    FROM session_files
+    WHERE file_path LIKE ? ESCAPE '\\'
+  `).all(`%${escaped}%`);
+}
+export function getAllSessionMetas(db) {
+    const rows = db.prepare(`
+    SELECT id, file_path, source, project_dir, is_subagent, parent_session_id, agent_role
+    FROM sessions
+    ORDER BY project_dir, start_time
+  `).all();
+    return rows.map((r) => ({
+        path: r.file_path ?? '',
+        source: r.source,
+        sessionId: r.id,
+        projectDir: r.project_dir,
+        isSubagent: r.is_subagent === 1,
+        parentSessionId: r.parent_session_id ?? undefined,
+        agentRole: r.agent_role ?? undefined,
+    }));
+}
+// ── Session Count ────────────────────────────────────────────
+export function getSessionCount(db) {
+    const row = db.prepare('SELECT COUNT(*) as count FROM sessions').get();
+    return row.count;
+}
+export function getDashboardStats(db) {
+    const agg = db.prepare(`
+    SELECT
+      COUNT(*) as session_count,
+      COUNT(DISTINCT project_dir) as project_count,
+      COUNT(DISTINCT source) as source_count
+    FROM sessions WHERE is_subagent = 0
+  `).get();
+    const projects = getAllProjectStats(db);
+    return {
+        sessionCount: agg.session_count,
+        projectCount: agg.project_count,
+        sourceCount: agg.source_count,
+        projects: projects.map((p) => ({
+            projectDir: p.projectDir,
+            projectName: p.projectName,
+            sessionCount: p.sessionCount,
+            totalLoc: p.totalLoc,
+            totalDuration: p.totalDuration,
+            skills: p.skills,
+            latestDate: p.latestDate,
+        })),
+    };
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/export.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Export module — produces Markdown and HTML exports of refined projects.
+ *
+ * Both functions write self-contained, offline-viewable output.
+ * HTML export uses the same render pipeline as publish (ReactDOMServer),
+ * producing JS-free static HTML safe for script-src 'self' CSP.
+ */
+import type { ProjectEnhanceCache } from './settings.js';
+import type { Session } from './analyzer.js';
+export interface ExportResult {
+    files: string[];
+    totalBytes: number;
+    outputPath: string;
+}
+export declare function exportMarkdown(dirName: string, cache: ProjectEnhanceCache, sessions: Session[], outputPath: string): Promise<ExportResult>;
+export declare function exportHtml(dirName: string, cache: ProjectEnhanceCache, sessions: Session[], outputPath: string, username?: string): Promise<ExportResult>;
+export interface HtmlFile {
+    path: string;
+    content: string;
+}
+/**
+ * Generate HTML files in memory (no disk writes).
+ * Returns an array of {path, content} for zipping.
+ */
+export declare function generateHtmlFiles(dirName: string, cache: ProjectEnhanceCache, sessions: Session[], username?: string): HtmlFile[];
+/**
+ * Create a ZIP file buffer from an array of {path, content} entries.
+ * Uses DEFLATE compression via Node's built-in zlib.
+ */
+export declare function createZipBuffer(entries: HtmlFile[]): Buffer;