cgraphx 1.1.0

package/dist/timeline/post-tool-summary.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * PostToolUse `tool_result_summary` algorithm (spec §4.2).
+ *
+ * PostToolUse payloads include `tool_response` which can be large (Read of a
+ * 5000-line file, Bash with 100KB stdout). We never store the full response —
+ * just a per-tool summary capped at RESULT_SUMMARY_MAX_BYTES.
+ *
+ * B-3 (timeline-data-quality) additions:
+ *   - TaskUpdate / TaskCreate / TaskGet cases — extract subject/status/taskId
+ *     so the post event carries usable content instead of an empty payload.
+ *   - Bash case — detect semantic category (test/build/lint/git_write) and
+ *     parse pass/fail counts from stdout; fall back to stdout_preview for
+ *     non-semantic commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeToolResponse = summarizeToolResponse;
+const constants_1 = require("./constants");
+const bash_semantics_1 = require("./bash-semantics");
+function looksLikeError(response) {
+    if (response === null || typeof response !== 'object')
+        return false;
+    const r = response;
+    if (r.error !== undefined && r.error !== null)
+        return true;
+    if (typeof r.stderr === 'string' && r.stderr.length > 0) {
+        // Bash responses include stderr on success too — only treat as error if
+        // there's also a non-zero exit_code or explicit error field.
+        if (typeof r.exit_code === 'number' && r.exit_code !== 0)
+            return true;
+    }
+    return false;
+}
+function truncate(s) {
+    if (s.length <= constants_1.RESULT_SUMMARY_MAX_BYTES)
+        return s;
+    return s.slice(0, constants_1.RESULT_SUMMARY_MAX_BYTES - constants_1.TRUNCATED_SUFFIX.length) + constants_1.TRUNCATED_SUFFIX;
+}
+/** Per-field cap for the task subject (B-3). */
+const SUBJECT_MAX_CHARS = 200;
+function truncateSubject(s) {
+    if (s.length <= SUBJECT_MAX_CHARS)
+        return s;
+    return s.slice(0, SUBJECT_MAX_CHARS - constants_1.TRUNCATED_SUFFIX.length) + constants_1.TRUNCATED_SUFFIX;
+}
+/**
+ * Try to pull a string field from a record at any of the given keys, returning
+ * the first string hit. Used when a field's path varies slightly across tool
+ * variants (taskId at root vs nested in task{}).
+ */
+function pickString(rec, keys) {
+    for (const k of keys) {
+        const v = rec[k];
+        if (typeof v === 'string' && v.length > 0)
+            return v;
+    }
+    return undefined;
+}
+/**
+ * Best-effort extract the Bash command string from the tool_args (preferred)
+ * or fall back to a command-shaped field on the tool_response itself.
+ *
+ * Claude Code's Bash tool_args carries the command at `command`. The tool_response
+ * carries stdout / stderr / exit_code but NOT the command, so we prefer toolArgs
+ * when the caller passes it; otherwise we scan tool_response for a command-like
+ * field (some tool variants echo it back) and return '' when nothing is found.
+ */
+function extractBashCommand(toolResponse, toolArgs) {
+    if (toolArgs && typeof toolArgs === 'object') {
+        const a = toolArgs;
+        if (typeof a.command === 'string')
+            return a.command;
+    }
+    // tool_response sometimes echoes the command (varies by Claude Code version).
+    if (typeof toolResponse.command === 'string')
+        return toolResponse.command;
+    return '';
+}
+/**
+ * Build a per-tool summary object, JSON-stringified by the store.
+ * Unknown tools get a generic shape with a small response_preview.
+ *
+ * @param toolName    Claude Code tool name (Read/Write/Bash/TaskUpdate/...)
+ * @param toolResponse  The `tool_response` payload from Claude Code.
+ * @param toolArgs    Optional `tool_input` payload — passed by callers that have
+ *   it (B-3 uses it to find the Bash command string). When omitted, Bash
+ *   semantic detection degrades gracefully (no command → null → stdout_preview
+ *   fallback), and Task* tools still work because taskId/subject/status are
+ *   mirrored onto tool_response by Claude Code. Backwards-compatible: the old
+ *   two-arg signature still works.
+ */
+function summarizeToolResponse(toolName, toolResponse, toolArgs) {
+    const summary = {
+        success: !looksLikeError(toolResponse),
+        payload: {},
+    };
+    if (toolResponse === null || typeof toolResponse !== 'object') {
+        if (typeof toolResponse === 'string') {
+            summary.payload.response_preview = truncate(toolResponse);
+        }
+        return JSON.stringify(summary);
+    }
+    const r = toolResponse;
+    switch (toolName) {
+        case 'Read':
+        case 'Write':
+        case 'Edit':
+        case 'MultiEdit':
+        case 'NotebookEdit':
+            summary.payload.file = typeof r.file_path === 'string' ? r.file_path : undefined;
+            summary.payload.lines_changed = typeof r.lines_changed === 'number' ? r.lines_changed : undefined;
+            break;
+        case 'TaskUpdate':
+        case 'TaskCreate':
+        case 'TaskGet': {
+            // Field paths verified against real Claude Code events (B-3):
+            //   TaskUpdate tool_response: { taskId, statusChange:{to}, updatedFields }
+            //   TaskCreate tool_response: { task:{ id, subject } }
+            //   TaskGet    tool_response: { task:{ id, subject, status } }
+            // taskId is at root for TaskUpdate; nested under task{} for Create/Get.
+            const nestedTask = r.task && typeof r.task === 'object'
+                ? r.task
+                : null;
+            const taskId = pickString(r, ['taskId', 'task_id', 'id'])
+                ?? (nestedTask ? pickString(nestedTask, ['id', 'taskId', 'task_id']) : undefined);
+            const subject = pickString(r, ['subject'])
+                ?? (nestedTask ? pickString(nestedTask, ['subject']) : undefined);
+            // status — TaskUpdate puts it under statusChange.to; TaskGet under task.status.
+            const statusChange = r.statusChange && typeof r.statusChange === 'object'
+                ? r.statusChange
+                : null;
+            const status = pickString(r, ['status'])
+                ?? (statusChange ? pickString(statusChange, ['to', 'status']) : undefined)
+                ?? (nestedTask ? pickString(nestedTask, ['status']) : undefined);
+            summary.payload.taskId = taskId;
+            summary.payload.subject = subject !== undefined ? truncateSubject(subject) : undefined;
+            summary.payload.status = status;
+            break;
+        }
+        case 'Bash': {
+            summary.payload.exit_code = typeof r.exit_code === 'number' ? r.exit_code : undefined;
+            const command = extractBashCommand(r, toolArgs);
+            const stdout = typeof r.stdout === 'string' ? r.stdout : '';
+            const semantics = (0, bash_semantics_1.detectBashSemantics)({
+                command,
+                stdout,
+                exit_code: typeof r.exit_code === 'number' ? r.exit_code : undefined,
+            });
+            if (semantics) {
+                summary.payload.category = semantics.category;
+                if (semantics.pass !== undefined)
+                    summary.payload.pass = semantics.pass;
+                if (semantics.fail !== undefined)
+                    summary.payload.fail = semantics.fail;
+                if (semantics.duration_ms !== undefined)
+                    summary.payload.duration_ms = semantics.duration_ms;
+            }
+            else {
+                // Non-semantic command — keep the stdout_preview the old code wrote,
+                // so non-test/build/lint/git Bash events don't regress.
+                if (typeof r.stdout === 'string')
+                    summary.payload.stdout_preview = truncate(r.stdout);
+            }
+            if (typeof r.stderr === 'string')
+                summary.payload.stderr_preview = truncate(r.stderr);
+            break;
+        }
+        case 'Task':
+        case 'Agent':
+            summary.payload.subagent_type = typeof r.subagent_type === 'string' ? r.subagent_type : undefined;
+            break;
+        case 'WebFetch':
+        case 'WebSearch':
+            summary.payload.url = typeof r.url === 'string' ? r.url : undefined;
+            summary.payload.status = typeof r.status === 'number' ? r.status : undefined;
+            break;
+        default:
+            // Unknown tool — store a small preview of the response if stringifiable.
+            try {
+                const json = JSON.stringify(r);
+                if (json)
+                    summary.payload.response_preview = truncate(json);
+            }
+            catch {
+                summary.payload.response_preview = '<unserializable>';
+            }
+    }
+    return JSON.stringify(summary);
+}
+//# sourceMappingURL=post-tool-summary.js.map

package/dist/timeline/post-tool-summary.js.map

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

package/dist/timeline/recorder.d.ts

@@ -0,0 +1,36 @@
+/**
+ * recordEvent — open the timeline DB and insert one event.
+ *
+ * This is the function hooks call; it owns the connection lifecycle.
+ * On any failure (project not initialized, schema error, DB error) it
+ * throws — the hook runner catches and writes stderr + exit 0.
+ *
+ * B-2 (timeline-data-quality): added an optional `enricher` callback.
+ * The enricher runs inside recordEvent, after the store is opened but
+ * BEFORE the event is inserted. It receives the live store instance so
+ * it can query prior events (e.g. look up the most-recent pre_tool_use
+ * to compute duration_ms for a post_tool_use event). The enricher may
+ * return a new event object, mutate the event in place, or return void /
+ * undefined — in the latter two cases recordEvent falls back to the
+ * original event.
+ *
+ * The enricher is a generic extension point: future enrich-side needs
+ * (B-6's stop-event session aggregation, etc.) reuse this same parameter
+ * without re-signing recordEvent. Enricher exceptions are NOT caught
+ * here — the caller (hook-runner's try/catch) is responsible, so a
+ * broken enricher degrades gracefully to "post event still recorded,
+ * enriched field null" rather than blocking the hook.
+ */
+import { TimelineStore } from './store';
+import type { TimelineEventInput } from './types';
+/**
+ * Enrichment callback invoked inside recordEvent before insert.
+ *
+ * @param store   Live TimelineStore backed by the just-opened connection.
+ * @param event   The original event the caller passed. May be mutated in
+ *                place; if a new object is returned, it replaces the event.
+ * @returns       The enriched event, OR undefined/void to keep the original.
+ */
+export type EventEnricher = (store: TimelineStore, event: TimelineEventInput) => TimelineEventInput | void;
+export declare function recordEvent(projectRoot: string, event: TimelineEventInput, enricher?: EventEnricher): Promise<number>;
+//# sourceMappingURL=recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/timeline/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,kBAAkB,KACtB,kBAAkB,GAAG,IAAI,CAAC;AAE/B,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/timeline/recorder.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * recordEvent — open the timeline DB and insert one event.
+ *
+ * This is the function hooks call; it owns the connection lifecycle.
+ * On any failure (project not initialized, schema error, DB error) it
+ * throws — the hook runner catches and writes stderr + exit 0.
+ *
+ * B-2 (timeline-data-quality): added an optional `enricher` callback.
+ * The enricher runs inside recordEvent, after the store is opened but
+ * BEFORE the event is inserted. It receives the live store instance so
+ * it can query prior events (e.g. look up the most-recent pre_tool_use
+ * to compute duration_ms for a post_tool_use event). The enricher may
+ * return a new event object, mutate the event in place, or return void /
+ * undefined — in the latter two cases recordEvent falls back to the
+ * original event.
+ *
+ * The enricher is a generic extension point: future enrich-side needs
+ * (B-6's stop-event session aggregation, etc.) reuse this same parameter
+ * without re-signing recordEvent. Enricher exceptions are NOT caught
+ * here — the caller (hook-runner's try/catch) is responsible, so a
+ * broken enricher degrades gracefully to "post event still recorded,
+ * enriched field null" rather than blocking the hook.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordEvent = recordEvent;
+const schema_bootstrap_1 = require("./schema-bootstrap");
+const store_1 = require("./store");
+async function recordEvent(projectRoot, event, enricher) {
+    const connection = (0, schema_bootstrap_1.openTimelineDb)(projectRoot);
+    try {
+        const store = new store_1.TimelineStore(connection.getDb());
+        // Apply enricher if present. `enricher(...) ?? event` covers both
+        // "returned undefined" and "returned void" — fall back to the original.
+        const enriched = enricher ? (enricher(store, event) ?? event) : event;
+        return store.insert(enriched);
+    }
+    finally {
+        connection.close();
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/timeline/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/timeline/recorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;AAmBH,kCAeC;AAhCD,yDAAoD;AACpD,mCAAwC;AAgBjC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,KAAyB,EACzB,QAAwB;IAExB,MAAM,UAAU,GAAG,IAAA,iCAAc,EAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,qBAAa,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,kEAAkE;QAClE,wEAAwE;QACxE,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACtE,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/timeline/schema-bootstrap.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Timeline subsystem schema bootstrap.
+ *
+ * Pattern mirrors src/markdown/schema-bootstrap.ts:
+ *   1. Read `schema.sql` shipped alongside the compiled JS.
+ *   2. Apply it (idempotent — every statement uses IF NOT EXISTS).
+ *   3. Track applied version in `timeline_schema_versions`.
+ *
+ * The shared `.cgraphx/cgraphx.db` file is reused (no separate DB file),
+ * but tables are strictly isolated by the `timeline_` prefix and never read
+ * or written by codegraph's main code-graph layer.
+ */
+import { DatabaseConnection, type SqliteDatabase } from '../db';
+import { TIMELINE_SCHEMA_VERSION } from './constants';
+/** Read the recorded timeline schema version from the DB, or 0 if none. */
+export declare function getCurrentTimelineSchemaVersion(db: SqliteDatabase): number;
+/**
+ * Apply the timeline schema to an open DB handle.
+ *
+ * Idempotent: safe to call on every hook trigger. The SQL is composed entirely
+ * of `CREATE ... IF NOT EXISTS` + a single version-row `INSERT OR IGNORE`.
+ *
+ * @throws TimelineSchemaError if a recorded version is *newer* than what this
+ *   build supports (would happen when a newer cgraphx wrote the schema and
+ *   an older one tried to read it).
+ */
+export declare function ensureTimelineSchema(db: SqliteDatabase): void;
+/**
+ * Open the shared cgraphx DB for timeline-subsystem use and ensure the
+ * timeline schema is applied.
+ *
+ * Re-uses `DatabaseConnection.open` so WAL / busy_timeout from the main DB
+ * layer apply. The returned connection is the caller's responsibility — close
+ * it when done with `connection.close()`.
+ *
+ * @throws TimelineSchemaError if `<projectRoot>/.cgraphx/cgraphx.db` does
+ *   not exist (project not initialized) — the caller (hook layer) catches
+ *   and exits 0 so Claude is never blocked.
+ */
+export declare function openTimelineDb(projectRoot: string): DatabaseConnection;
+export { TIMELINE_SCHEMA_VERSION };
+//# sourceMappingURL=schema-bootstrap.d.ts.map

package/dist/timeline/schema-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-bootstrap.d.ts","sourceRoot":"","sources":["../../src/timeline/schema-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EACL,kBAAkB,EAElB,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAOtD,2EAA2E;AAC3E,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAO1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAa7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CActE;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/timeline/schema-bootstrap.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Timeline subsystem schema bootstrap.
+ *
+ * Pattern mirrors src/markdown/schema-bootstrap.ts:
+ *   1. Read `schema.sql` shipped alongside the compiled JS.
+ *   2. Apply it (idempotent — every statement uses IF NOT EXISTS).
+ *   3. Track applied version in `timeline_schema_versions`.
+ *
+ * The shared `.cgraphx/cgraphx.db` file is reused (no separate DB file),
+ * but tables are strictly isolated by the `timeline_` prefix and never read
+ * or written by codegraph's main code-graph layer.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIMELINE_SCHEMA_VERSION = void 0;
+exports.getCurrentTimelineSchemaVersion = getCurrentTimelineSchemaVersion;
+exports.ensureTimelineSchema = ensureTimelineSchema;
+exports.openTimelineDb = openTimelineDb;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const db_1 = require("../db");
+const errors_1 = require("./errors");
+const constants_1 = require("./constants");
+Object.defineProperty(exports, "TIMELINE_SCHEMA_VERSION", { enumerable: true, get: function () { return constants_1.TIMELINE_SCHEMA_VERSION; } });
+/** Resolve schema.sql path — works in both dist/ and src/ layouts. */
+function resolveSchemaPath() {
+    return node_path_1.default.join(__dirname, 'schema.sql');
+}
+/** Read the recorded timeline schema version from the DB, or 0 if none. */
+function getCurrentTimelineSchemaVersion(db) {
+    const row = db
+        .prepare('SELECT version FROM timeline_schema_versions ORDER BY version DESC LIMIT 1')
+        .get();
+    return row?.version ?? 0;
+}
+/**
+ * Apply the timeline schema to an open DB handle.
+ *
+ * Idempotent: safe to call on every hook trigger. The SQL is composed entirely
+ * of `CREATE ... IF NOT EXISTS` + a single version-row `INSERT OR IGNORE`.
+ *
+ * @throws TimelineSchemaError if a recorded version is *newer* than what this
+ *   build supports (would happen when a newer cgraphx wrote the schema and
+ *   an older one tried to read it).
+ */
+function ensureTimelineSchema(db) {
+    const schemaPath = resolveSchemaPath();
+    const sql = node_fs_1.default.readFileSync(schemaPath, 'utf-8');
+    db.exec(sql);
+    const current = getCurrentTimelineSchemaVersion(db);
+    if (current > constants_1.TIMELINE_SCHEMA_VERSION) {
+        throw new errors_1.TimelineSchemaError(`Timeline schema version ${current} is newer than this build supports ` +
+            `(${constants_1.TIMELINE_SCHEMA_VERSION}). Upgrade cgraphx.`, { current, supported: constants_1.TIMELINE_SCHEMA_VERSION });
+    }
+}
+/**
+ * Open the shared cgraphx DB for timeline-subsystem use and ensure the
+ * timeline schema is applied.
+ *
+ * Re-uses `DatabaseConnection.open` so WAL / busy_timeout from the main DB
+ * layer apply. The returned connection is the caller's responsibility — close
+ * it when done with `connection.close()`.
+ *
+ * @throws TimelineSchemaError if `<projectRoot>/.cgraphx/cgraphx.db` does
+ *   not exist (project not initialized) — the caller (hook layer) catches
+ *   and exits 0 so Claude is never blocked.
+ */
+function openTimelineDb(projectRoot) {
+    const resolved = node_path_1.default.resolve(projectRoot);
+    const dbPath = (0, db_1.getDatabasePath)(resolved);
+    if (!node_fs_1.default.existsSync(dbPath)) {
+        throw new errors_1.TimelineSchemaError(`Cgraphx not initialized at ${resolved} — run \`cgraphx init\` first.`, { projectRoot: resolved });
+    }
+    const connection = db_1.DatabaseConnection.open(dbPath);
+    ensureTimelineSchema(connection.getDb());
+    return connection;
+}
+//# sourceMappingURL=schema-bootstrap.js.map

package/dist/timeline/schema-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-bootstrap.js","sourceRoot":"","sources":["../../src/timeline/schema-bootstrap.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;AAmBH,0EAOC;AAYD,oDAaC;AAcD,wCAcC;AA7ED,sDAAyB;AACzB,0DAA6B;AAE7B,8BAIe;AACf,qCAA+C;AAC/C,2CAAsD;AAsE7C,wGAtEA,mCAAuB,OAsEA;AApEhC,sEAAsE;AACtE,SAAS,iBAAiB;IACxB,OAAO,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,2EAA2E;AAC3E,SAAgB,+BAA+B,CAAC,EAAkB;IAChE,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN,4EAA4E,CAC7E;SACA,GAAG,EAAqC,CAAC;IAC5C,OAAO,GAAG,EAAE,OAAO,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAAC,EAAkB;IACrD,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,iBAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,OAAO,GAAG,+BAA+B,CAAC,EAAE,CAAC,CAAC;IACpD,IAAI,OAAO,GAAG,mCAAuB,EAAE,CAAC;QACtC,MAAM,IAAI,4BAAmB,CAC3B,2BAA2B,OAAO,qCAAqC;YACrE,IAAI,mCAAuB,qBAAqB,EAClD,EAAE,OAAO,EAAE,SAAS,EAAE,mCAAuB,EAAE,CAChD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,cAAc,CAAC,WAAmB;IAChD,MAAM,QAAQ,GAAG,mBAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAA,oBAAe,EAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,4BAAmB,CAC3B,8BAA8B,QAAQ,gCAAgC,EACtE,EAAE,WAAW,EAAE,QAAQ,EAAE,CAC1B,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,uBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,oBAAoB,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/timeline/schema.sql

@@ -0,0 +1,37 @@
+-- Developer Timeline schema (independent of cgraphx main schema_versions).
+-- Spec §2.1.
+
+CREATE TABLE IF NOT EXISTS timeline_schema_versions (
+  version INTEGER PRIMARY KEY,
+  applied_at INTEGER NOT NULL,
+  description TEXT
+);
+
+INSERT OR IGNORE INTO timeline_schema_versions (version, applied_at, description)
+VALUES (1, strftime('%s', 'now') * 1000, 'Initial timeline schema');
+
+CREATE TABLE IF NOT EXISTS timeline_events (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  ts TEXT NOT NULL,
+  session_id TEXT,
+  event_type TEXT NOT NULL,
+  tool_name TEXT,
+  tool_args TEXT,
+  tool_result_summary TEXT,
+  prompt_text TEXT,
+  duration_ms INTEGER,
+  commit_hash TEXT,
+  commit_message TEXT,
+  commit_files TEXT,
+  cwd TEXT NOT NULL,
+  metadata TEXT,
+  turn_id TEXT,
+  commit_insertions INTEGER,
+  commit_deletions INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS timeline_events_ts_idx ON timeline_events(ts);
+CREATE INDEX IF NOT EXISTS timeline_events_type_idx ON timeline_events(event_type);
+CREATE INDEX IF NOT EXISTS timeline_events_tool_name_idx ON timeline_events(tool_name);
+CREATE INDEX IF NOT EXISTS timeline_events_session_idx ON timeline_events(session_id);
+CREATE INDEX IF NOT EXISTS idx_timeline_turn_id ON timeline_events(turn_id);

package/dist/timeline/store.d.ts

@@ -0,0 +1,69 @@
+/**
+ * TimelineStore — low-level persistence for the timeline subsystem.
+ *
+ * Spec §2 (data model) + §3 (event recording) + §5 (query).
+ *
+ * Wraps a single SqliteDatabase (the shared .cgraphx/cgraphx.db) and
+ * touches only `timeline_*` tables. The DB handle is owned by the caller
+ * (hook entry or CLI) and closed when the caller is done.
+ *
+ * Field-size caps (spec §2.3) are applied here so callers can pass arbitrary
+ * payloads without worrying about DB bloat.
+ */
+import type { SqliteDatabase } from '../db';
+import { type TimelineEvent, type TimelineEventInput, type TimelineQueryFilter, type TimelineStats } from './types';
+/**
+ * Resolve a relative-or-absolute time string to an ISO 8601 UTC timestamp.
+ *
+ * Inputs:
+ *   - ISO 8601 absolute: '2026-06-01' / '2026-06-01T00:00:00Z'
+ *   - Relative: '7d' / '12h' / '30m' / 'now'
+ *
+ * Returns null if input is empty/invalid (caller treats null as "no filter").
+ */
+export declare function resolveTimeBound(input: string | undefined, defaultToNow?: boolean): string | null;
+export declare class TimelineStore {
+    private readonly db;
+    constructor(db: SqliteDatabase);
+    insert(input: TimelineEventInput): number;
+    query(filter: TimelineQueryFilter): TimelineEvent[];
+    getById(id: number): TimelineEvent | null;
+    /**
+     * Find the most recent pre_tool_use event matching the given filter.
+     *
+     * Used by B-2's duration_ms enricher to compute post.ts - pre.ts for
+     * write-tool post events within a turn. Filters on turn_id + tool_name +
+     * session_id; session_id null is matched via `IS NULL` (the schema allows
+     * NULL session_id for events Claude Code couldn't attribute to a session).
+     *
+     * Uses idx_timeline_turn_id (turn_id index) plus the ORDER BY ts DESC
+     * LIMIT 1 pattern to keep the lookup sub-millisecond at scale.
+     *
+     * @returns the matching event, or null if none exists.
+     */
+    getMostRecentPre(filter: {
+        turn_id: string;
+        tool_name: string;
+        session_id: string | null;
+    }): TimelineEvent | null;
+    /**
+     * Aggregate stats for a single session (B-6).
+     *
+     * Used by the stop-hook enricher to summarize the session at its end:
+     * total event count, first event ts, last user_prompt text preview, and
+     * the duration from the first event to the last user_prompt. Two SELECTs
+     * (one aggregate, one for the prompt text) keep this sub-millisecond on
+     * the stop hook's 50ms budget.
+     *
+     * @returns counts and timestamps; null fields when the session has no
+     *   events or no user_prompt events.
+     */
+    getSessionStats(session_id: string): {
+        event_count: number;
+        first_ts: string | null;
+        last_user_prompt: string | null;
+        duration_ms: number | null;
+    };
+    stats(filter: TimelineQueryFilter): TimelineStats;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/timeline/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAa5C,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AA6BjB;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,UAAQ,GAAG,MAAM,GAAG,IAAI,CAqB/F;AAuDD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAE/C,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM;IAoEzC,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,EAAE;IAmCnD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAazC;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GAAG,aAAa,GAAG,IAAI;IAqBxB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;QACnC,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B;IAiCD,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa;CA0HlD"}