preflight-dev 3.1.0

package/dist/lib/session-parser.js

@@ -0,0 +1,267 @@
+/**
+ * session-parser.ts — Parse Claude Code session JSONL files into timeline events.
+ */
+import { readFileSync, readdirSync, statSync, existsSync, createReadStream } from "fs";
+import { join, basename } from "path";
+import { homedir } from "os";
+import { randomUUID } from "crypto";
+import { createInterface } from "readline";
+// ── Constants ──────────────────────────────────────────────────────────────
+const CLAUDE_PROJECTS_DIR = join(homedir(), ".claude", "projects");
+const LARGE_FILE_THRESHOLD = 10 * 1024 * 1024; // 10 MB
+const CORRECTION_PATTERNS = [
+    /\bno\b/i, /\bwrong\b/i, /\bnot that\b/i, /\bi meant\b/i,
+    /\bactually\b/i, /\binstead\b/i, /\bundo\b/i,
+];
+// ── Helpers ────────────────────────────────────────────────────────────────
+function extractText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((b) => b.type === "text" && typeof b.text === "string")
+            .map((b) => b.text)
+            .join("\n");
+    }
+    return "";
+}
+function extractToolUseBlocks(content) {
+    if (!Array.isArray(content))
+        return [];
+    return content.filter((b) => b.type === "tool_use");
+}
+function normalizeTimestamp(ts, fallback) {
+    if (!ts)
+        return fallback;
+    if (typeof ts === "string") {
+        const d = new Date(ts);
+        return isNaN(d.getTime()) ? fallback : d.toISOString();
+    }
+    if (typeof ts === "number") {
+        // epoch seconds or ms
+        const d = new Date(ts < 1e12 ? ts * 1000 : ts);
+        return isNaN(d.getTime()) ? fallback : d.toISOString();
+    }
+    return fallback;
+}
+function preview(text, max = 120) {
+    const line = text.split("\n")[0] ?? "";
+    return line.length > max ? line.slice(0, max) + "…" : line;
+}
+function isCorrection(text) {
+    return CORRECTION_PATTERNS.some((p) => p.test(text));
+}
+function makeEvent(partial) {
+    return {
+        id: randomUUID(),
+        content_preview: partial.content_preview ?? preview(partial.content),
+        ...partial,
+    };
+}
+// ── Public API ─────────────────────────────────────────────────────────────
+/**
+ * Discover all Claude project session directories.
+ */
+export function findSessionDirs() {
+    if (!existsSync(CLAUDE_PROJECTS_DIR))
+        return [];
+    const results = [];
+    for (const entry of readdirSync(CLAUDE_PROJECTS_DIR, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const sessionDir = join(CLAUDE_PROJECTS_DIR, entry.name);
+        // Decode project path: leading `-` → `/`, internal `-` are ambiguous
+        // but the last path segment is a reasonable "name"
+        const decoded = entry.name.replace(/^-/, "/").replace(/-/g, "/");
+        const projectName = decoded.split("/").filter(Boolean).pop() ?? entry.name;
+        results.push({ project: decoded, projectName, sessionDir });
+    }
+    return results;
+}
+/**
+ * List JSONL session files in a project directory (including subagent files).
+ */
+export function findSessionFiles(projectDir) {
+    if (!existsSync(projectDir))
+        return [];
+    const results = [];
+    for (const entry of readdirSync(projectDir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+            const p = join(projectDir, entry.name);
+            results.push({
+                sessionId: basename(entry.name, ".jsonl"),
+                path: p,
+                mtime: statSync(p).mtime,
+            });
+        }
+        // Check for subagent dirs: <uuid>/subagents/<sub-uuid>.jsonl
+        if (entry.isDirectory()) {
+            const subDir = join(projectDir, entry.name, "subagents");
+            if (existsSync(subDir)) {
+                for (const sub of readdirSync(subDir)) {
+                    if (sub.endsWith(".jsonl")) {
+                        const p = join(subDir, sub);
+                        results.push({
+                            sessionId: basename(sub, ".jsonl"),
+                            path: p,
+                            mtime: statSync(p).mtime,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Parse a single JSONL session file into timeline events.
+ * For files >10MB, streams line-by-line.
+ */
+export function parseSession(filePath, project, projectName) {
+    const stat = statSync(filePath);
+    const fallbackTs = stat.mtime.toISOString();
+    if (stat.size > LARGE_FILE_THRESHOLD) {
+        // Return empty — caller should use parseSessionAsync for large files
+        // But for sync API compat, read anyway with a buffer
+    }
+    const lines = readFileSync(filePath, "utf-8").split("\n");
+    return parseLinesSync(lines, filePath, project, projectName, fallbackTs);
+}
+/**
+ * Async streaming parser for large files.
+ */
+export async function parseSessionAsync(filePath, project, projectName) {
+    const stat = statSync(filePath);
+    const fallbackTs = stat.mtime.toISOString();
+    const events = [];
+    let branch = "";
+    let sessionId = basename(filePath, ".jsonl");
+    let lastType = "";
+    let lineNum = 0;
+    const rl = createInterface({ input: createReadStream(filePath, "utf-8"), crlfDelay: Infinity });
+    for await (const line of rl) {
+        lineNum++;
+        if (!line.trim())
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            process.stderr.write(`[session-parser] malformed line ${lineNum} in ${filePath}\n`);
+            continue;
+        }
+        const evts = processRecord(obj, filePath, project, projectName, branch, sessionId, fallbackTs, lineNum, lastType);
+        if (obj.type === "summary") {
+            branch = obj.gitBranch ?? "";
+            if (obj.sessionId)
+                sessionId = obj.sessionId;
+        }
+        if (obj.type === "user" || obj.type === "assistant")
+            lastType = obj.type;
+        events.push(...evts);
+    }
+    return events;
+}
+// ── Internal ───────────────────────────────────────────────────────────────
+function parseLinesSync(lines, filePath, project, projectName, fallbackTs) {
+    const events = [];
+    let branch = "";
+    let sessionId = basename(filePath, ".jsonl");
+    let lastType = "";
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            process.stderr.write(`[session-parser] malformed line ${i + 1} in ${filePath}\n`);
+            continue;
+        }
+        if (obj.type === "summary") {
+            branch = obj.gitBranch ?? "";
+            if (obj.sessionId)
+                sessionId = obj.sessionId;
+            continue;
+        }
+        const evts = processRecord(obj, filePath, project, projectName, branch, sessionId, fallbackTs, i + 1, lastType);
+        if (obj.type === "user" || obj.type === "assistant")
+            lastType = obj.type;
+        events.push(...evts);
+    }
+    return events;
+}
+function processRecord(obj, filePath, project, projectName, branch, sessionId, fallbackTs, lineNum, lastType) {
+    const ts = normalizeTimestamp(obj.timestamp, fallbackTs);
+    const base = { project, project_name: projectName, branch, session_id: sessionId, source_file: filePath, source_line: lineNum };
+    const events = [];
+    if (obj.type === "user") {
+        const text = extractText(obj.message?.content);
+        if (!text)
+            return events;
+        const isCorr = lastType === "assistant" && isCorrection(text);
+        events.push(makeEvent({ ...base, timestamp: ts, type: isCorr ? "correction" : "prompt", content: text, metadata: "{}" }));
+    }
+    else if (obj.type === "assistant") {
+        const content = obj.message?.content;
+        const text = extractText(content);
+        if (text) {
+            events.push(makeEvent({ ...base, timestamp: ts, type: "assistant", content: text, metadata: JSON.stringify({ model: obj.model ?? "" }) }));
+        }
+        for (const tool of extractToolUseBlocks(content)) {
+            const name = tool.name ?? "unknown";
+            const argsStr = typeof tool.input === "string" ? tool.input : JSON.stringify(tool.input ?? {});
+            const isSub = name === "Task" || name === "dispatch_agent";
+            events.push(makeEvent({
+                ...base,
+                timestamp: ts,
+                type: isSub ? "sub_agent_spawn" : "tool_call",
+                content: `${name}: ${argsStr.slice(0, 100)}`,
+                metadata: JSON.stringify({ tool: name }),
+            }));
+        }
+    }
+    else if (obj.type === "tool_result") {
+        const isErr = obj.is_error === true || (typeof obj.content === "string" && /stderr/i.test(obj.content));
+        if (isErr) {
+            const text = extractText(obj.content) || JSON.stringify(obj.content ?? "").slice(0, 200);
+            events.push(makeEvent({ ...base, timestamp: ts, type: "error", content: text, metadata: JSON.stringify({ tool_use_id: obj.tool_use_id ?? "" }) }));
+        }
+    }
+    else if (obj.type === "system") {
+        const text = extractText(obj.message?.content ?? obj.content ?? "");
+        if (/compact/i.test(text) || obj.subtype === "compaction") {
+            events.push(makeEvent({ ...base, timestamp: ts, type: "compaction", content: text || "context compacted", metadata: "{}" }));
+        }
+    }
+    return events;
+}
+/**
+ * Parse all sessions for a project directory, optionally filtering by mtime.
+ */
+export function parseAllSessions(projectDir, opts) {
+    const files = findSessionFiles(projectDir);
+    const { project, projectName } = inferProject(projectDir);
+    const events = [];
+    for (const f of files) {
+        if (opts?.since && f.mtime < opts.since)
+            continue;
+        try {
+            events.push(...parseSession(f.path, project, projectName));
+        }
+        catch (err) {
+            process.stderr.write(`[session-parser] failed to parse ${f.path}: ${err}\n`);
+        }
+    }
+    return events.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+}
+function inferProject(projectDir) {
+    const dir = basename(projectDir);
+    const decoded = dir.replace(/^-/, "/").replace(/-/g, "/");
+    const projectName = decoded.split("/").filter(Boolean).pop() ?? dir;
+    return { project: decoded, projectName };
+}
+//# sourceMappingURL=session-parser.js.map

package/dist/lib/session-parser.js.map

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

package/dist/lib/state.d.ts

@@ -0,0 +1,21 @@
+export declare const STATE_DIR: string;
+/**
+ * Load a JSON state file by name (without extension).
+ * Returns empty object if missing or corrupt.
+ */
+export declare function loadState(name: string): Record<string, any>;
+/**
+ * Save a JSON state file by name (without extension).
+ */
+export declare function saveState(name: string, data: Record<string, any>): void;
+/**
+ * Append a JSONL entry to a log file. Rotates if file exceeds MAX_LOG_SIZE.
+ */
+export declare function appendLog(filename: string, entry: Record<string, any>): void;
+/**
+ * Read a JSONL log file. Pass `lastN` to only return the last N entries
+ * (still reads the file, but avoids allocating all parsed objects).
+ */
+export declare function readLog(filename: string, lastN?: number): Record<string, any>[];
+/** ISO timestamp for the current moment. */
+export declare function now(): string;

package/dist/lib/state.js

@@ -0,0 +1,86 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync, statSync, renameSync } from "fs";
+import { join } from "path";
+import { PROJECT_DIR } from "./files.js";
+export const STATE_DIR = join(PROJECT_DIR, ".claude", "preflight-state");
+/** Max log file size in bytes (5 MB). Triggers rotation. */
+const MAX_LOG_SIZE = 5 * 1024 * 1024;
+/** Lazily ensures the state directory exists. Called before any write. */
+function ensureStateDir() {
+    if (!existsSync(STATE_DIR)) {
+        mkdirSync(STATE_DIR, { recursive: true });
+    }
+}
+/**
+ * Load a JSON state file by name (without extension).
+ * Returns empty object if missing or corrupt.
+ */
+export function loadState(name) {
+    const p = join(STATE_DIR, `${name}.json`);
+    if (!existsSync(p))
+        return {};
+    try {
+        return JSON.parse(readFileSync(p, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save a JSON state file by name (without extension).
+ */
+export function saveState(name, data) {
+    ensureStateDir();
+    writeFileSync(join(STATE_DIR, `${name}.json`), JSON.stringify(data, null, 2));
+}
+/**
+ * Append a JSONL entry to a log file. Rotates if file exceeds MAX_LOG_SIZE.
+ */
+export function appendLog(filename, entry) {
+    ensureStateDir();
+    const logFile = join(STATE_DIR, filename);
+    // Rotate if too large
+    if (existsSync(logFile)) {
+        try {
+            const size = statSync(logFile).size;
+            if (size > MAX_LOG_SIZE) {
+                const backup = logFile + ".old";
+                // Keep only one backup; overwrite previous
+                renameSync(logFile, backup);
+            }
+        }
+        catch { /* stat/rename failure is non-fatal */ }
+    }
+    appendFileSync(logFile, JSON.stringify(entry) + "\n");
+}
+/**
+ * Read a JSONL log file. Pass `lastN` to only return the last N entries
+ * (still reads the file, but avoids allocating all parsed objects).
+ */
+export function readLog(filename, lastN) {
+    const logFile = join(STATE_DIR, filename);
+    if (!existsSync(logFile))
+        return [];
+    try {
+        const raw = readFileSync(logFile, "utf-8").trim();
+        if (!raw)
+            return [];
+        const lines = raw.split("\n");
+        const subset = lastN != null && lastN > 0 ? lines.slice(-lastN) : lines;
+        const results = [];
+        for (const line of subset) {
+            try {
+                results.push(JSON.parse(line));
+            }
+            catch { /* skip corrupt line */ }
+        }
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+/** ISO timestamp for the current moment. */
+export function now() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=state.js.map

package/dist/lib/state.js.map

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

package/dist/lib/timeline-db.d.ts

@@ -0,0 +1,67 @@
+import * as lancedb from "@lancedb/lancedb";
+import type { ProjectMeta, ProjectRegistry } from "../types.js";
+export declare const EVENT_TYPES: readonly ["prompt", "assistant", "correction", "commit", "tool_call", "compaction", "sub_agent_spawn", "error"];
+export type EventType = (typeof EVENT_TYPES)[number];
+export interface TimelineEvent {
+    id?: string;
+    timestamp: string;
+    type: EventType;
+    project: string;
+    project_name?: string;
+    branch: string;
+    session_id: string;
+    source_file: string;
+    source_line: number;
+    content: string;
+    content_preview?: string;
+    vector?: number[];
+    metadata?: string;
+}
+export interface TimelineRecord extends Required<TimelineEvent> {
+}
+export interface SearchOptions {
+    project_dirs?: string[];
+    project?: string;
+    branch?: string;
+    type?: EventType;
+    since?: string;
+    until?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ProjectInfo {
+    project: string;
+    project_name: string;
+    hash: string;
+    event_count: number;
+    last_session_index?: string;
+    last_git_index?: string;
+}
+export interface TimelineConfig {
+    embedding_provider: "local" | "openai";
+    embedding_model: string;
+    openai_api_key?: string;
+    indexed_projects: Record<string, {
+        last_session_index: string;
+        last_git_index: string;
+        event_count: number;
+    }>;
+}
+export declare function loadConfig(): Promise<TimelineConfig>;
+export declare function saveConfig(config: TimelineConfig): Promise<void>;
+export declare function loadProjectRegistry(): Promise<ProjectRegistry>;
+export declare function saveProjectRegistry(registry: ProjectRegistry): Promise<void>;
+export declare function registerProject(projectDir: string): Promise<void>;
+export declare function loadProjectMeta(projectDir: string): Promise<ProjectMeta | null>;
+export declare function saveProjectMeta(projectDir: string, meta: ProjectMeta): Promise<void>;
+export declare function getDb(projectDir: string): Promise<lancedb.Connection>;
+export declare function getEventsTable(projectDir: string): Promise<lancedb.Table>;
+export declare function insertEvents(events: TimelineEvent[], projectDir?: string): Promise<void>;
+/** Search across multiple projects and merge results by score */
+export declare function searchSemantic(query: string, opts?: SearchOptions): Promise<TimelineRecord[]>;
+export declare function searchExact(query: string, opts?: SearchOptions): Promise<TimelineRecord[]>;
+export declare function getTimeline(opts?: SearchOptions): Promise<TimelineRecord[]>;
+export declare function listIndexedProjects(): Promise<ProjectInfo[]>;
+export declare function getIndexedProjects(): Promise<ProjectInfo[]>;
+export declare function getLastIndexedTimestamp(project: string, source: "session" | "git"): Promise<string | null>;
+export declare function updateLastIndexedTimestamp(project: string, source: "session" | "git", timestamp: string): Promise<void>;