cgraphx 1.1.0

package/dist/timeline/hook-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-runner.d.ts","sourceRoot":"","sources":["../../src/timeline/hook-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAiB,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAC3B,UAAU,EAAE,CACV,OAAO,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,KAC3C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,kBAAkB,GAAG,IAAI,EACnE,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED,wBAAgB,cAAc,IAAI,OAAO,CAKxC"}

package/dist/timeline/hook-runner.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Hook entry-point runner — shared logic for all 5 hook CLI subcommands.
+ *
+ * Spec §3.1 / §4.5: ALWAYS exit 0, ALWAYS empty stdout. Failures go to stderr
+ * only. This is the "never block Claude" contract.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHook = runHook;
+exports.isKillSwitchOn = isKillSwitchOn;
+const constants_1 = require("./constants");
+const recorder_1 = require("./recorder");
+const payload_1 = require("./payload");
+/**
+ * Run a hook handler. Reads Claude Code payload from stdin, records a single
+ * event, exits 0 regardless of outcome.
+ *
+ * @param buildEvent  Maps the parsed payload to a TimelineEventInput. Return
+ *   `null` to skip recording (e.g. kill-switch, missing payload). May be
+ *   async — e.g. postToolUseHook's turn-id lookup may read from disk.
+ * @param options     Optional enricher forwarded to recordEvent.
+ */
+async function runHook(buildEvent, options) {
+    const start = Date.now();
+    // Kill-switch — never read stdin, never touch DB.
+    if (isKillSwitchOn()) {
+        return;
+    }
+    const raw = await (0, payload_1.readStdinJson)();
+    if (!raw) {
+        // No payload (manual invocation or stdin EOF) — silent exit.
+        return;
+    }
+    const payload = (0, payload_1.extractHookPayload)(raw);
+    const projectRoot = payload.cwd ?? process.cwd();
+    const event = await buildEvent(payload);
+    if (!event)
+        return;
+    try {
+        await (0, recorder_1.recordEvent)(projectRoot, event, options?.enricher);
+    }
+    catch (err) {
+        // Log to stderr only — never block Claude. Also catches enricher
+        // exceptions — a broken enricher degrades to "post still recorded,
+        // duration_ms null" instead of aborting the hook.
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[timeline] record failed: ${msg}\n`);
+    }
+    const durationMs = Date.now() - start;
+    if (durationMs > constants_1.PERF_WARN_MS) {
+        process.stderr.write(`[timeline] hook took ${durationMs}ms (>${constants_1.PERF_WARN_MS} budget)\n`);
+    }
+}
+function isKillSwitchOn() {
+    const v = process.env[constants_1.NO_TIMELINE_ENV];
+    if (!v)
+        return false;
+    const trimmed = v.trim().toLowerCase();
+    return trimmed !== '' && trimmed !== '0' && trimmed !== 'false';
+}
+//# sourceMappingURL=hook-runner.js.map

package/dist/timeline/hook-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-runner.js","sourceRoot":"","sources":["../../src/timeline/hook-runner.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiCH,0BAuCC;AAED,wCAKC;AA7ED,2CAA4D;AAC5D,yCAA6D;AAC7D,uCAA8D;AAoB9D;;;;;;;;GAQG;AACI,KAAK,UAAU,OAAO,CAC3B,UAEmE,EACnE,OAAwB;IAExB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,kDAAkD;IAClD,IAAI,cAAc,EAAE,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,IAAA,uBAAa,GAAE,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,6DAA6D;QAC7D,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,4BAAkB,EAAC,GAAG,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEjD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,IAAI,CAAC;QACH,MAAM,IAAA,sBAAW,EAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iEAAiE;QACjE,mEAAmE;QACnE,kDAAkD;QAClD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,GAAG,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IACtC,IAAI,UAAU,GAAG,wBAAY,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,UAAU,QAAQ,wBAAY,YAAY,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,2BAAe,CAAC,CAAC;IACvC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,OAAO,CAAC;AAClE,CAAC"}

package/dist/timeline/hooks.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Five hook handlers (spec §3).
+ *
+ * Each is a thin function that maps a Claude Code payload to a TimelineEventInput
+ * and calls runHook. They're called by the hidden CLI subcommands in cli.ts
+ * (e.g. `cgraphx timeline-pre-tool-use-hook`).
+ *
+ * These are async + await recordEvent — never fire-and-forget. Per spec §4.4,
+ * hook processes are short-lived: open DB, INSERT, exit. ~5ms typical.
+ */
+import { extractHookPayload } from './payload';
+export declare function userPromptHook(): Promise<void>;
+export declare function preToolUseHook(): Promise<void>;
+export declare function postToolUseHook(): Promise<void>;
+export declare function stopHook(): Promise<void>;
+/**
+ * Git post-commit hook — reads no stdin; pulls commit info from `git` CLI.
+ *
+ * Spec §3.3. Invoked from a `.git/hooks/post-commit` script that backgrounds
+ * us (`&`), so we're allowed to take longer than the Claude Code hooks.
+ */
+export declare function gitCommitHook(): Promise<void>;
+export interface GitCommitInfo {
+    hash: string;
+    message: string;
+    files: string[];
+    cwd: string;
+    insertions: number;
+    deletions: number;
+}
+/**
+ * Read HEAD commit info + aggregated insertions/deletions.
+ *
+ * numstat parsing: `git show --numstat --format= HEAD` emits one line per
+ * changed file as `<ins>\t<del>\t<path>`. Binary files show literal `-` in
+ * the ins/del columns — we skip those (no numeric contribution). The result
+ * is aggregated across ALL files in the commit.
+ *
+ * If numstat fails (rare: shallow clone, broken repo, git too old), we still
+ * return the rest of the info with insertions/deletions = 0 — numstat is an
+ * enhancement, not a gate.
+ */
+export declare function readGitCommitInfo(): GitCommitInfo | null;
+export { extractHookPayload };
+//# sourceMappingURL=hooks.d.ts.map

package/dist/timeline/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/timeline/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAwF/C,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBpD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBpD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA+CrD;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CA6C9C;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBnD;AAUD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,CAuCxD;AAGD,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/timeline/hooks.js

@@ -0,0 +1,364 @@
+"use strict";
+/**
+ * Five hook handlers (spec §3).
+ *
+ * Each is a thin function that maps a Claude Code payload to a TimelineEventInput
+ * and calls runHook. They're called by the hidden CLI subcommands in cli.ts
+ * (e.g. `cgraphx timeline-pre-tool-use-hook`).
+ *
+ * These are async + await recordEvent — never fire-and-forget. Per spec §4.4,
+ * hook processes are short-lived: open DB, INSERT, exit. ~5ms typical.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractHookPayload = void 0;
+exports.userPromptHook = userPromptHook;
+exports.preToolUseHook = preToolUseHook;
+exports.postToolUseHook = postToolUseHook;
+exports.stopHook = stopHook;
+exports.gitCommitHook = gitCommitHook;
+exports.readGitCommitInfo = readGitCommitInfo;
+const hook_runner_1 = require("./hook-runner");
+const payload_1 = require("./payload");
+Object.defineProperty(exports, "extractHookPayload", { enumerable: true, get: function () { return payload_1.extractHookPayload; } });
+const post_tool_summary_1 = require("./post-tool-summary");
+const constants_1 = require("./constants");
+const node_crypto_1 = require("node:crypto");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * Per-turn state file used to hand the current turn_id from the user_prompt
+ * hook (which generates it) to the pre/post/stop hooks in the SAME turn.
+ *
+ * Each Claude Code hook is a separate short-lived process — there's no shared
+ * memory — so we use a single JSON file under `.cgraphx/`. Write is a single
+ * `fs.writeFileSync(..., {flag:'w'})` (atomic-ish: a small complete overwrite,
+ * no locks needed). Reads tolerate a missing / corrupt file (return null,
+ * which makes the duration_ms enricher a no-op — graceful degradation, never
+ * blocks the hook).
+ */
+const TURN_STATE_FILENAME = 'timeline-current-turn.json';
+function turnStateFilePath(projectRoot) {
+    return path.join(projectRoot, '.cgraphx', TURN_STATE_FILENAME);
+}
+/**
+ * Read the current turn_id for a given session from the per-turn state file.
+ *
+ * Returns null if the file is absent, the JSON is corrupt, or the stored
+ * session_id does not match `session_id` (cross-session isolation — two
+ * parallel Claude Code sessions on the same project must not share a turn id).
+ *
+ * `projectRoot` defaults to process.cwd() (Claude Code launches hooks with
+ * cwd = project root); callers may pass an explicit root (e.g. payload.cwd)
+ * to be precise.
+ */
+async function readCurrentTurnId(session_id, projectRoot = process.cwd()) {
+    try {
+        const content = await fs.promises.readFile(turnStateFilePath(projectRoot), 'utf8');
+        const data = JSON.parse(content);
+        // Cross-session isolation: if the caller pins a session and the file's
+        // session differs, the stored turn belongs to a different conversation —
+        // do not propagate it. A null session_id caller accepts any stored turn.
+        if (session_id !== null && data.session_id !== session_id)
+            return null;
+        return data.turn_id ?? null;
+    }
+    catch {
+        // File missing / unreadable / JSON.parse threw — silent null. The
+        // duration_ms enricher no-ops on null turn_id, so this degrades cleanly.
+        return null;
+    }
+}
+/**
+ * Persist the current turn_id to the per-turn state file (B-1).
+ *
+ * Writes the whole file each call ({flag:'w'} truncates). Failures are
+ * swallowed and reported to stderr — a missing turn file only disables
+ * duration_ms computation, it must never block the hook (spec §4.5).
+ */
+function writeCurrentTurn(projectRoot, turn) {
+    const payload = {
+        turn_id: turn.turn_id,
+        session_id: turn.session_id,
+        ts: turn.ts ?? new Date().toISOString(),
+    };
+    try {
+        const filePath = turnStateFilePath(projectRoot);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, JSON.stringify(payload), { flag: 'w' });
+    }
+    catch (err) {
+        // Never throw — recording the user_prompt still matters more than the
+        // turn file. Subsequent pre/post hooks will read null (no duration_ms),
+        // which is a tolerable degradation.
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[timeline] turn-state write failed: ${msg}\n`);
+    }
+}
+async function userPromptHook() {
+    await (0, hook_runner_1.runHook)((payload) => {
+        if (payload.prompt === undefined)
+            return null;
+        // B-1: generate a per-turn id. Honor a host-supplied turn_id if present
+        // (forward-compat — a future Claude Code may send one); otherwise mint a
+        // fresh UUID v4. Either way, persist it to the per-turn state file so the
+        // downstream pre/post/stop hooks in this turn can read it back.
+        const turn_id = payload.turn_id ?? (0, node_crypto_1.randomUUID)();
+        const projectRoot = payload.cwd ?? process.cwd();
+        writeCurrentTurn(projectRoot, {
+            turn_id,
+            session_id: payload.session_id ?? null,
+        });
+        return {
+            event_type: 'user_prompt',
+            session_id: payload.session_id ?? null,
+            prompt_text: payload.prompt,
+            turn_id,
+            cwd: payload.cwd,
+        };
+    });
+}
+async function preToolUseHook() {
+    await (0, hook_runner_1.runHook)(async (payload) => {
+        if (!payload.tool_name)
+            return null;
+        // B-2 pre-event reduction: only write-tools (Edit/Write/MultiEdit/
+        // NotebookEdit/Bash) record pre_tool_use. Read-only tool pre events
+        // (Read/Grep/TaskUpdate/etc.) carry no signal — their post event is
+        // sufficient — and dropping them cuts ~30% of event volume.
+        if (!constants_1.WRITE_TOOLS_WHITELIST.has(payload.tool_name))
+            return null;
+        const turn_id = await readCurrentTurnId(payload.session_id ?? null, payload.cwd ?? process.cwd());
+        return {
+            event_type: 'pre_tool_use',
+            session_id: payload.session_id ?? null,
+            tool_name: payload.tool_name,
+            tool_args: payload.tool_input,
+            turn_id,
+            cwd: payload.cwd,
+        };
+    });
+}
+async function postToolUseHook() {
+    await (0, hook_runner_1.runHook)(async (payload) => {
+        if (!payload.tool_name)
+            return null;
+        const summary = (0, post_tool_summary_1.summarizeToolResponse)(payload.tool_name, payload.tool_response, payload.tool_input);
+        const turn_id = await readCurrentTurnId(payload.session_id ?? null, payload.cwd ?? process.cwd());
+        return {
+            event_type: 'post_tool_use',
+            session_id: payload.session_id ?? null,
+            tool_name: payload.tool_name,
+            tool_args: payload.tool_input,
+            tool_result_summary: summary,
+            turn_id,
+            cwd: payload.cwd,
+        };
+    }, {
+        // Enricher runs inside recordEvent before insert. Computes duration_ms
+        // = post.ts - pre.ts for write-tool post events by looking up the
+        // most-recent pre_tool_use with matching (turn_id, tool_name, session_id).
+        // No-op (returns void) for read tools or when turn_id is null — post
+        // event still records, duration_ms stays null/undefined.
+        //
+        // Inner try/catch is belt-and-suspenders: a faulty lookup degrades to
+        // "post still recorded, duration_ms null" rather than blocking the hook
+        // or losing the event. Same pattern as stopHook's enricher below.
+        enricher: (store, event) => {
+            const toolName = event.tool_name;
+            if (!toolName)
+                return;
+            if (!constants_1.WRITE_TOOLS_WHITELIST.has(toolName))
+                return;
+            if (!event.turn_id)
+                return;
+            try {
+                const recentPre = store.getMostRecentPre({
+                    turn_id: event.turn_id,
+                    tool_name: toolName,
+                    session_id: event.session_id ?? null,
+                });
+                if (!recentPre)
+                    return;
+                const postTs = new Date(event.ts ?? new Date().toISOString()).getTime();
+                const preTs = new Date(recentPre.ts).getTime();
+                const delta = postTs - preTs;
+                // Math.max guards against clock-skew / bad ts ordering producing
+                // negative durations; we'd rather record 0 than a misleading negative.
+                event.duration_ms = Math.max(0, delta);
+            }
+            catch (err) {
+                process.stderr.write(`[timeline] duration enrich failed: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        },
+    });
+}
+async function stopHook() {
+    await (0, hook_runner_1.runHook)(async (payload) => {
+        const turn_id = await readCurrentTurnId(payload.session_id ?? null, payload.cwd ?? process.cwd());
+        return {
+            event_type: 'stop',
+            session_id: payload.session_id ?? null,
+            turn_id,
+            cwd: payload.cwd,
+            // If Claude Code surfaces token usage in the payload later, capture it here.
+            metadata: payload.stop_hook_active !== undefined
+                ? { stop_hook_active: payload.stop_hook_active }
+                : undefined,
+        };
+    }, {
+        // B-6: enrich the stop event with a session summary — total event count,
+        // duration (first event → last user_prompt), and a 200-char preview of the
+        // last user_prompt. This is the "session recap" surfaced at stop time.
+        //
+        // No-op when session_id is null (we can't attribute events to a session)
+        // — the stop event still records with whatever metadata it already had.
+        // The inner try/catch is belt-and-suspenders: runHook also catches, so a
+        // thrown getSessionStats degrades to "stop recorded, summary fields
+        // absent" rather than blocking the hook.
+        enricher: (store, event) => {
+            if (event.event_type !== 'stop' || !event.session_id)
+                return;
+            try {
+                const stats = store.getSessionStats(event.session_id);
+                event.metadata = {
+                    ...(event.metadata ?? {}),
+                    // +1 to count the stop event itself — the enricher runs BEFORE
+                    // store.insert, so getSessionStats's COUNT(*) doesn't see this stop
+                    // row yet. The surfaced count is "events in the session including
+                    // this stop", which is what a reader of the stop event expects.
+                    session_event_count: stats.event_count + 1,
+                    session_duration_ms: stats.duration_ms,
+                    session_last_prompt_preview: stats.last_user_prompt?.slice(0, 200) ?? null,
+                };
+            }
+            catch (err) {
+                process.stderr.write(`[timeline] stop enrich failed: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        },
+    });
+}
+/**
+ * Git post-commit hook — reads no stdin; pulls commit info from `git` CLI.
+ *
+ * Spec §3.3. Invoked from a `.git/hooks/post-commit` script that backgrounds
+ * us (`&`), so we're allowed to take longer than the Claude Code hooks.
+ */
+async function gitCommitHook() {
+    if ((0, hook_runner_2.isKillSwitchOn)())
+        return;
+    const info = readGitCommitInfo();
+    if (!info)
+        return;
+    try {
+        const { recordEvent } = await Promise.resolve().then(() => __importStar(require('./recorder')));
+        await recordEvent(info.cwd, {
+            event_type: 'git_commit',
+            commit_hash: info.hash,
+            commit_message: info.message,
+            commit_files: info.files,
+            commit_insertions: info.insertions,
+            commit_deletions: info.deletions,
+            cwd: info.cwd,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[timeline] git-commit record failed: ${msg}\n`);
+    }
+}
+// Imported here (not at module top) to avoid a circular import: hook-runner
+// imports recorder which imports store which imports nothing — fine, but
+// keeping the import inline matches the lazy pattern used for git.
+const hook_runner_2 = require("./hook-runner");
+const node_child_process_1 = require("node:child_process");
+/**
+ * Read HEAD commit info + aggregated insertions/deletions.
+ *
+ * numstat parsing: `git show --numstat --format= HEAD` emits one line per
+ * changed file as `<ins>\t<del>\t<path>`. Binary files show literal `-` in
+ * the ins/del columns — we skip those (no numeric contribution). The result
+ * is aggregated across ALL files in the commit.
+ *
+ * If numstat fails (rare: shallow clone, broken repo, git too old), we still
+ * return the rest of the info with insertions/deletions = 0 — numstat is an
+ * enhancement, not a gate.
+ */
+function readGitCommitInfo() {
+    try {
+        const cwd = (0, node_child_process_1.execSync)('git rev-parse --show-toplevel', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
+        const hash = (0, node_child_process_1.execSync)('git rev-parse HEAD', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
+        const message = (0, node_child_process_1.execSync)('git log -1 --pretty=%B HEAD', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
+        const filesOut = (0, node_child_process_1.execSync)('git diff-tree --no-commit-id --name-only -r HEAD', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] });
+        const files = filesOut.split('\n').map(s => s.trim()).filter(Boolean);
+        // Aggregate insertions/deletions from numstat. Run with cwd=parsed repo
+        // root so the command works even when the hook is launched from elsewhere.
+        let insertions = 0;
+        let deletions = 0;
+        try {
+            const numstatOut = (0, node_child_process_1.execSync)('git show --numstat --format= HEAD', {
+                encoding: 'utf8',
+                stdio: ['pipe', 'pipe', 'ignore'],
+                cwd,
+            });
+            for (const line of numstatOut.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                const parts = trimmed.split('\t');
+                if (parts.length < 3)
+                    continue;
+                const [ins, del] = parts;
+                // Binary file: git emits literal "-" — skip, contributes no count.
+                if (ins === '-' || del === '-')
+                    continue;
+                const insNum = parseInt(ins, 10);
+                const delNum = parseInt(del, 10);
+                if (!Number.isNaN(insNum))
+                    insertions += insNum;
+                if (!Number.isNaN(delNum))
+                    deletions += delNum;
+            }
+        }
+        catch {
+            // numstat unavailable — keep 0/0, don't block the rest of the record.
+        }
+        return { hash, message, files, cwd, insertions, deletions };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/timeline/hooks.js.map

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

package/dist/timeline/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public facade for the timeline subsystem.
+ *
+ * External callers (CLI) use this module — never reach into store/hooks
+ * internals. Spec §1.2.
+ */
+export { recordEvent, type EventEnricher } from './recorder';
+export { queryEvents, getEventById, getEventStats, getMostRecentPre, getSessionStats, resolveTimeBound } from './indexer';
+export { installTimelineHooks, uninstallTimelineHooks } from './installer';
+export type { EventType, TimelineEvent, TimelineEventInput, TimelineQueryFilter, TimelineStats, StatsGroupBy, } from './types';
+export { TimelineError, HookPayloadError, TimelineSchemaError, StoreInsertError, StoreQueryError, } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/timeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/timeline/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC1H,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EACV,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/timeline/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Public facade for the timeline subsystem.
+ *
+ * External callers (CLI) use this module — never reach into store/hooks
+ * internals. Spec §1.2.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreQueryError = exports.StoreInsertError = exports.TimelineSchemaError = exports.HookPayloadError = exports.TimelineError = exports.uninstallTimelineHooks = exports.installTimelineHooks = exports.resolveTimeBound = exports.getSessionStats = exports.getMostRecentPre = exports.getEventStats = exports.getEventById = exports.queryEvents = exports.recordEvent = void 0;
+var recorder_1 = require("./recorder");
+Object.defineProperty(exports, "recordEvent", { enumerable: true, get: function () { return recorder_1.recordEvent; } });
+var indexer_1 = require("./indexer");
+Object.defineProperty(exports, "queryEvents", { enumerable: true, get: function () { return indexer_1.queryEvents; } });
+Object.defineProperty(exports, "getEventById", { enumerable: true, get: function () { return indexer_1.getEventById; } });
+Object.defineProperty(exports, "getEventStats", { enumerable: true, get: function () { return indexer_1.getEventStats; } });
+Object.defineProperty(exports, "getMostRecentPre", { enumerable: true, get: function () { return indexer_1.getMostRecentPre; } });
+Object.defineProperty(exports, "getSessionStats", { enumerable: true, get: function () { return indexer_1.getSessionStats; } });
+Object.defineProperty(exports, "resolveTimeBound", { enumerable: true, get: function () { return indexer_1.resolveTimeBound; } });
+var installer_1 = require("./installer");
+Object.defineProperty(exports, "installTimelineHooks", { enumerable: true, get: function () { return installer_1.installTimelineHooks; } });
+Object.defineProperty(exports, "uninstallTimelineHooks", { enumerable: true, get: function () { return installer_1.uninstallTimelineHooks; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "TimelineError", { enumerable: true, get: function () { return errors_1.TimelineError; } });
+Object.defineProperty(exports, "HookPayloadError", { enumerable: true, get: function () { return errors_1.HookPayloadError; } });
+Object.defineProperty(exports, "TimelineSchemaError", { enumerable: true, get: function () { return errors_1.TimelineSchemaError; } });
+Object.defineProperty(exports, "StoreInsertError", { enumerable: true, get: function () { return errors_1.StoreInsertError; } });
+Object.defineProperty(exports, "StoreQueryError", { enumerable: true, get: function () { return errors_1.StoreQueryError; } });
+//# sourceMappingURL=index.js.map

package/dist/timeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/timeline/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uCAA6D;AAApD,uGAAA,WAAW,OAAA;AACpB,qCAA0H;AAAjH,sGAAA,WAAW,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AACtG,yCAA2E;AAAlE,iHAAA,oBAAoB,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AASrD,mCAMkB;AALhB,uGAAA,aAAa,OAAA;AACb,0GAAA,gBAAgB,OAAA;AAChB,6GAAA,mBAAmB,OAAA;AACnB,0GAAA,gBAAgB,OAAA;AAChB,yGAAA,eAAe,OAAA"}

package/dist/timeline/indexer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * High-level query + stats + getEventById — wraps the store with connection
+ * lifecycle (open + close). These are the functions exported via index.ts.
+ */
+import { resolveTimeBound } from './store';
+import type { TimelineEvent, TimelineQueryFilter, TimelineStats } from './types';
+export declare function queryEvents(projectRoot: string, filter: TimelineQueryFilter): Promise<TimelineEvent[]>;
+export declare function getEventById(projectRoot: string, id: number): Promise<TimelineEvent | null>;
+export declare function getEventStats(projectRoot: string, filter: TimelineQueryFilter): Promise<TimelineStats>;
+/**
+ * Public wrapper around TimelineStore.getMostRecentPre (B-2).
+ *
+ * Finds the most recent pre_tool_use matching (turn_id, tool_name, session_id).
+ * Used by the post-tool-use enricher to compute duration_ms; exposed publicly
+ * so CLI / programmatic callers can do the same lookup.
+ */
+export declare function getMostRecentPre(projectRoot: string, filter: {
+    turn_id: string;
+    tool_name: string;
+    session_id: string | null;
+}): Promise<TimelineEvent | null>;
+/**
+ * Public wrapper around TimelineStore.getSessionStats (B-6).
+ *
+ * Aggregates the per-session stats the stop-hook enricher attaches to the
+ * stop event: total event count, first event ts, last user_prompt text, and
+ * the duration from the first event to the last user_prompt. Exposed publicly
+ * so CLI / programmatic callers can fetch the same summary on demand.
+ */
+export declare function getSessionStats(projectRoot: string, session_id: string): Promise<{
+    event_count: number;
+    first_ts: string | null;
+    last_user_prompt: string | null;
+    duration_ms: number | null;
+}>;
+export { resolveTimeBound };
+//# sourceMappingURL=indexer.d.ts.map

package/dist/timeline/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/timeline/indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAiB,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEjF,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAO5G;AAED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAOjG;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAO5G;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAO/B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC,CAOD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}