cgraphx 1.1.0

package/dist/timeline/cli.js

@@ -0,0 +1,367 @@
+"use strict";
+/**
+ * CLI wiring for the Developer Timeline subsystem.
+ *
+ * Public subcommands (spec §5.1):
+ *   - cgraphx timeline query
+ *   - cgraphx timeline show <id>
+ *   - cgraphx timeline stats
+ *   - cgraphx timeline recent
+ *   - cgraphx timeline install
+ *   - cgraphx timeline uninstall
+ *
+ * Hidden hook entry points (spec §3.3):
+ *   - cgraphx timeline-user-prompt-hook
+ *   - cgraphx timeline-pre-tool-use-hook
+ *   - cgraphx timeline-post-tool-use-hook
+ *   - cgraphx timeline-stop-hook
+ *   - cgraphx timeline-git-commit-hook
+ *
+ * Exit codes (spec §5.5):
+ *   0  success (incl. "no matching events")
+ *   2  config error (project not initialized)
+ *   3  argument error
+ *   4  DB error (schema / query failure)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderEventsTable = renderEventsTable;
+exports.describeEvent = describeEvent;
+exports.renderStatsTable = renderStatsTable;
+exports.registerTimelineCommands = registerTimelineCommands;
+const node_path_1 = __importDefault(require("node:path"));
+const indexer_1 = require("./indexer");
+const installer_1 = require("./installer");
+const errors_1 = require("./errors");
+const payload_1 = require("./payload");
+const hooks_1 = require("./hooks");
+class ArgError extends Error {
+}
+function renderEventsTable(events) {
+    if (events.length === 0)
+        return '(no events)';
+    const rows = events.map(e => {
+        const summary = describeEvent(e);
+        const turn = e.turn_id ? e.turn_id.slice(0, 8) : '-';
+        return [
+            String(e.id),
+            e.ts,
+            e.event_type,
+            e.tool_name ?? '',
+            turn,
+            summary,
+        ];
+    });
+    const header = ['id', 'ts', 'event_type', 'tool_name', 'turn', 'summary'];
+    const all = [header, ...rows];
+    const widths = header.map((_, i) => Math.max(...all.map(r => String(r[i] ?? '').length)));
+    return all.map(r => r.map((c, i) => String(c).padEnd(widths[i])).join('  ')).join('\n');
+}
+function describeEvent(e) {
+    switch (e.event_type) {
+        case 'user_prompt':
+            return truncate(e.prompt_text ?? '', 120);
+        case 'pre_tool_use':
+        case 'post_tool_use':
+            return describeToolArgs(e.tool_name, e.tool_args);
+        case 'git_commit': {
+            const parts = [];
+            if (e.commit_hash)
+                parts.push(e.commit_hash.slice(0, 7));
+            if (e.commit_message)
+                parts.push(truncate(e.commit_message, 100));
+            if (e.commit_files.length > 0)
+                parts.push(`(${e.commit_files.length} files)`);
+            return parts.join(' ');
+        }
+        case 'stop':
+            return e.duration_ms !== null ? `session ended (${e.duration_ms}ms)` : 'session ended';
+    }
+}
+function describeToolArgs(toolName, args) {
+    if (!toolName || !args || typeof args !== 'object')
+        return '';
+    const r = args;
+    if (typeof r.file_path === 'string')
+        return r.file_path;
+    if (typeof r.path === 'string')
+        return r.path;
+    if (typeof r.command === 'string')
+        return truncate(r.command, 120);
+    if (typeof r.url === 'string')
+        return r.url;
+    if (typeof r.query === 'string')
+        return truncate(r.query, 120);
+    return '';
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max - 1) + '…';
+}
+function renderStats(s) {
+    return JSON.stringify(s, null, 2);
+}
+/**
+ * Human-readable stats summary (B-7).
+ *
+ * Lays out the high-signal fields a developer scans at a glance:
+ *   - totalEvents / window
+ *   - per-event-type counts
+ *   - top tools
+ *   - top files read / written (timeline-data-quality)
+ *   - commit insertions / deletions aggregated over the window's git_commit events
+ *
+ * The Commit Lines section sums commit_insertions / commit_deletions across
+ * all git_commit events in the window — passed in by the caller (cli.ts
+ * stats action) which fetches those events via queryEvents(type:'git_commit').
+ * Storing the sum in TimelineStats would require touching store.ts (out of
+ * B-7 scope); computing it here keeps the stats renderer self-contained.
+ */
+function renderStatsTable(s, commitLines = { insertions: 0, deletions: 0 }) {
+    const lines = [];
+    lines.push(`Total Events:           ${s.totalEvents}`);
+    lines.push(`Window:                 ${s.windowStart ?? '-'} → ${s.windowEnd ?? '-'}`);
+    lines.push('');
+    lines.push('By Event Type:');
+    for (const [t, n] of Object.entries(s.byType)) {
+        lines.push(`  ${t.padEnd(22)} ${n}`);
+    }
+    lines.push('');
+    if (s.byTool.length > 0) {
+        lines.push('Top Tools:');
+        for (const { tool, count } of s.byTool.slice(0, 10)) {
+            lines.push(`  ${tool.padEnd(22)} ${count}`);
+        }
+        lines.push('');
+    }
+    if (s.topFilesRead.length > 0) {
+        lines.push('Top Files Read:');
+        for (const { file, count } of s.topFilesRead.slice(0, 10)) {
+            lines.push(`  ${truncate(file, 60).padEnd(62)} ${count}`);
+        }
+        lines.push('');
+    }
+    if (s.topFilesWritten.length > 0) {
+        lines.push('Top Files Written:');
+        for (const { file, count } of s.topFilesWritten.slice(0, 10)) {
+            lines.push(`  ${truncate(file, 60).padEnd(62)} ${count}`);
+        }
+        lines.push('');
+    }
+    lines.push(`Commit Lines (INS/DEL): ${commitLines.insertions} / ${commitLines.deletions}`);
+    return lines.join('\n');
+}
+function exitCodeForError(err) {
+    if (err instanceof ArgError)
+        return 3;
+    if (err instanceof errors_1.TimelineSchemaError)
+        return 2;
+    if (err instanceof errors_1.StoreQueryError)
+        return 4;
+    return 1;
+}
+function renderError(err) {
+    if (err instanceof errors_1.TimelineSchemaError || err instanceof errors_1.StoreQueryError) {
+        process.stderr.write(`[timeline] ${err.message}\n`);
+    }
+    else if (err instanceof ArgError) {
+        process.stderr.write(`[timeline] ${err.message}\n`);
+    }
+    else {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[timeline] unexpected error: ${msg}\n`);
+    }
+}
+function registerTimelineCommands(program) {
+    const timeline = program
+        .command('timeline')
+        .description('Developer Timeline — record and query Claude Code development events');
+    timeline
+        .command('query')
+        .description('Query timeline events by time window, type, tool, file, or session')
+        .option('--since <date>', 'Start time (ISO 8601 or relative like 7d/12h/30m/now)')
+        .option('--until <date>', 'End time (ISO 8601 or relative)')
+        .option('--type <type>', 'Event type: user_prompt | pre_tool_use | post_tool_use | stop | git_commit')
+        .option('--tool <name>', 'Exact tool_name (Edit/Bash/Read/...)')
+        .option('--file <path>', 'Substring match on tool_args.file_path or commit_files')
+        .option('--session <id>', 'Exact session_id')
+        .option('--turn <id>', 'Exact turn_id (UUID) match')
+        .option('--limit <n>', 'Max results (1-10000; default 100)', v => parseInt(v, 10))
+        .option('--format <format>', 'json (default) | table', 'json')
+        .action(async (opts) => {
+        const projectRoot = process.cwd();
+        try {
+            const format = opts.format === 'table' ? 'table' : 'json';
+            const filter = {
+                since: opts.since,
+                until: opts.until,
+                type: parseType(opts.type),
+                tool: opts.tool,
+                file: opts.file,
+                session: opts.session,
+                turn: opts.turn,
+                limit: opts.limit,
+            };
+            const events = await (0, indexer_1.queryEvents)(projectRoot, filter);
+            if (format === 'table') {
+                process.stdout.write(renderEventsTable(events) + '\n');
+            }
+            else {
+                process.stdout.write(JSON.stringify(events, null, 2) + '\n');
+            }
+        }
+        catch (err) {
+            renderError(err);
+            process.exitCode = exitCodeForError(err);
+        }
+    });
+    timeline
+        .command('show <id>')
+        .description('Show full detail for one event by id')
+        .action(async (idArg) => {
+        const projectRoot = process.cwd();
+        try {
+            const id = parseInt(idArg, 10);
+            if (!Number.isFinite(id) || id <= 0)
+                throw new ArgError(`Invalid id: ${idArg}`);
+            const event = await (0, indexer_1.getEventById)(projectRoot, id);
+            if (!event) {
+                process.stderr.write(`[timeline] event ${id} not found\n`);
+                process.exitCode = 0;
+                return;
+            }
+            process.stdout.write(JSON.stringify(event, null, 2) + '\n');
+        }
+        catch (err) {
+            renderError(err);
+            process.exitCode = exitCodeForError(err);
+        }
+    });
+    timeline
+        .command('stats')
+        .description('Aggregate stats over a time window')
+        .option('--since <date>', 'Start time (default: 30d)')
+        .option('--until <date>', 'End time')
+        .option('--by <field>', 'Group by: day | event_type | tool_name (default: all)')
+        .option('--format <format>', 'json (default) | table', 'json')
+        .action(async (opts) => {
+        const projectRoot = process.cwd();
+        try {
+            const format = opts.format === 'table' ? 'table' : 'json';
+            const filter = {
+                since: opts.since ?? '30d',
+                until: opts.until,
+            };
+            const stats = await (0, indexer_1.getEventStats)(projectRoot, filter);
+            if (format === 'table') {
+                // Aggregate commit_insertions / commit_deletions across all
+                // git_commit events in the same window. Stored separately from
+                // TimelineStats (which would need store.ts changes — out of B-7
+                // scope), so the table renderer is fed the totals alongside stats.
+                const commitEvents = await (0, indexer_1.queryEvents)(projectRoot, {
+                    ...filter,
+                    type: 'git_commit',
+                    limit: 10000,
+                });
+                let insertions = 0;
+                let deletions = 0;
+                for (const e of commitEvents) {
+                    insertions += e.commit_insertions ?? 0;
+                    deletions += e.commit_deletions ?? 0;
+                }
+                process.stdout.write(renderStatsTable(stats, { insertions, deletions }) + '\n');
+            }
+            else {
+                process.stdout.write(renderStats(stats) + '\n');
+            }
+        }
+        catch (err) {
+            renderError(err);
+            process.exitCode = exitCodeForError(err);
+        }
+    });
+    timeline
+        .command('recent')
+        .description('Most recent N events (quick shortcut)')
+        .option('--limit <n>', 'Default 20', v => parseInt(v, 10))
+        .option('--format <format>', 'json (default) | table', 'json')
+        .action(async (opts) => {
+        const projectRoot = process.cwd();
+        try {
+            const format = opts.format === 'table' ? 'table' : 'json';
+            const events = await (0, indexer_1.queryEvents)(projectRoot, { limit: opts.limit ?? 20 });
+            if (format === 'table') {
+                process.stdout.write(renderEventsTable(events) + '\n');
+            }
+            else {
+                process.stdout.write(JSON.stringify(events, null, 2) + '\n');
+            }
+        }
+        catch (err) {
+            renderError(err);
+            process.exitCode = exitCodeForError(err);
+        }
+    });
+    timeline
+        .command('install')
+        .description('Install timeline hooks into this project\'s .claude/settings.json and .git/hooks/')
+        .option('--purge-first', 'Remove existing timeline hooks before installing (clean slate)')
+        .action(async (opts) => {
+        const projectRoot = process.cwd();
+        try {
+            const report = (0, installer_1.installTimelineHooks)(projectRoot, { purgeFirst: opts.purgeFirst === true });
+            process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+        }
+        catch (err) {
+            renderError(err);
+            process.exitCode = exitCodeForError(err);
+        }
+    });
+    timeline
+        .command('uninstall')
+        .description('Remove timeline hooks from this project')
+        .option('--purge', 'Also DROP all timeline_* tables (data loss)')
+        .action(async (opts) => {
+        const projectRoot = process.cwd();
+        try {
+            const report = (0, installer_1.uninstallTimelineHooks)(projectRoot, { purgeData: opts.purge === true });
+            process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+        }
+        catch (err) {
+            renderError(err);
+            process.exitCode = exitCodeForError(err);
+        }
+    });
+    // ─── Hidden hook entry points (spec §3) ────────────────────────────────
+    // All async — fire-and-forget on hook trigger; exit 0 when the work is done.
+    program
+        .command('timeline-user-prompt-hook', { hidden: true })
+        .action(async () => { await (0, hooks_1.userPromptHook)(); });
+    program
+        .command('timeline-pre-tool-use-hook', { hidden: true })
+        .action(async () => { await (0, hooks_1.preToolUseHook)(); });
+    program
+        .command('timeline-post-tool-use-hook', { hidden: true })
+        .action(async () => { await (0, hooks_1.postToolUseHook)(); });
+    program
+        .command('timeline-stop-hook', { hidden: true })
+        .action(async () => { await (0, hooks_1.stopHook)(); });
+    program
+        .command('timeline-git-commit-hook', { hidden: true })
+        .action(async () => { await (0, hooks_1.gitCommitHook)(); });
+}
+function parseType(s) {
+    if (!s)
+        return undefined;
+    const t = (0, payload_1.assertEventType)(s);
+    if (!t)
+        throw new ArgError(`Invalid --type: ${s}. Must be one of user_prompt, pre_tool_use, post_tool_use, stop, git_commit`);
+    return t;
+}
+// `path" is used by installer.ts (project-local paths); kept imported here so
+// the module compiles cleanly without an unused-imports linter firing.
+void node_path_1.default;
+//# sourceMappingURL=cli.js.map

package/dist/timeline/cli.js.map

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

package/dist/timeline/constants.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Constants for the Developer Timeline subsystem.
+ *
+ * Spec §2.3 — field size caps; §3.1 — kill-switch.
+ */
+/** Kill-switch env var: any non-empty value (except '0'/'false') disables timeline. */
+export declare const NO_TIMELINE_ENV = "CGRAPHX_NO_TIMELINE";
+/** Schema version (independent timeline_schema_versions table). */
+export declare const TIMELINE_SCHEMA_VERSION = 1;
+/** Field size caps (spec §2.3). */
+export declare const ARGS_MAX_BYTES: number;
+export declare const RESULT_SUMMARY_MAX_BYTES: number;
+export declare const PROMPT_MAX_BYTES: number;
+export declare const COMMIT_MESSAGE_MAX_BYTES: number;
+export declare const COMMIT_FILES_MAX = 1000;
+export declare const METADATA_MAX_BYTES: number;
+/** Default query limit; hard ceiling on rows returned. */
+export declare const DEFAULT_QUERY_LIMIT = 100;
+export declare const MAX_QUERY_LIMIT = 10000;
+/** Performance budget — single hook invocation total wall-clock. */
+export declare const PERF_BUDGET_MS = 50;
+export declare const PERF_WARN_MS = 50;
+/** Truncation marker appended to truncated string fields. */
+export declare const TRUNCATED_SUFFIX = "... [truncated]";
+/** Fixed response text when timeline is disabled via env. */
+export declare const DISABLED_RESPONSE_TEXT = "";
+/**
+ * Claude Code hook event name → cgraphx hidden subcommand name.
+ *
+ * Single source of truth — installer (writes settings.json) and cli.ts
+ * (registers the actual commands) both read from here, so a typo can't
+ * desync them.
+ */
+export declare const HOOK_EVENTS_TO_COMMANDS: ReadonlyArray<{
+    event: string;
+    subcommand: string;
+}>;
+export declare const GIT_COMMIT_SUBCOMMAND = "timeline-git-commit-hook";
+/**
+ * Tools that mutate state and are therefore worth recording as pre_tool_use
+ * (write-tools whitelist). Used by B-2 to decide which pre events to keep —
+ * read-only tool pre events are dropped to cut noise.
+ *
+ * Bash is included because it carries semantic signals (test/build/lint/git-write)
+ * even though it does not directly modify a single file.
+ */
+export declare const WRITE_TOOLS_WHITELIST: Set<string>;
+/**
+ * Task-management tools (B-3 extracts subject/status/taskId from these).
+ */
+export declare const TASK_TOOLS: Set<string>;
+/**
+ * File-reading tools (B-5 splits topFiles into read vs written).
+ */
+export declare const READ_FILE_TOOLS: Set<string>;
+/**
+ * File-writing tools (B-5). Note: distinct from WRITE_TOOLS_WHITELIST —
+ * Bash is in the whitelist (carries duration/semantic value) but does not
+ * directly modify a specific file, so it is excluded here.
+ */
+export declare const WRITE_FILE_TOOLS: Set<string>;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/timeline/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uFAAuF;AACvF,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,mCAAmC;AACnC,eAAO,MAAM,cAAc,QAAY,CAAC;AACxC,eAAO,MAAM,wBAAwB,QAAW,CAAC;AACjD,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAC1C,eAAO,MAAM,wBAAwB,QAAY,CAAC;AAClD,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,kBAAkB,QAAW,CAAC;AAE3C,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,oEAAoE;AACpE,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAElD,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAKxF,CAAC;AAEF,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAKhE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,aAEhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,aAErB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,aAAoC,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAA0D,CAAC"}

package/dist/timeline/constants.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Constants for the Developer Timeline subsystem.
+ *
+ * Spec §2.3 — field size caps; §3.1 — kill-switch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WRITE_FILE_TOOLS = exports.READ_FILE_TOOLS = exports.TASK_TOOLS = exports.WRITE_TOOLS_WHITELIST = exports.GIT_COMMIT_SUBCOMMAND = exports.HOOK_EVENTS_TO_COMMANDS = exports.DISABLED_RESPONSE_TEXT = exports.TRUNCATED_SUFFIX = exports.PERF_WARN_MS = exports.PERF_BUDGET_MS = exports.MAX_QUERY_LIMIT = exports.DEFAULT_QUERY_LIMIT = exports.METADATA_MAX_BYTES = exports.COMMIT_FILES_MAX = exports.COMMIT_MESSAGE_MAX_BYTES = exports.PROMPT_MAX_BYTES = exports.RESULT_SUMMARY_MAX_BYTES = exports.ARGS_MAX_BYTES = exports.TIMELINE_SCHEMA_VERSION = exports.NO_TIMELINE_ENV = void 0;
+/** Kill-switch env var: any non-empty value (except '0'/'false') disables timeline. */
+exports.NO_TIMELINE_ENV = 'CGRAPHX_NO_TIMELINE';
+/** Schema version (independent timeline_schema_versions table). */
+exports.TIMELINE_SCHEMA_VERSION = 1;
+/** Field size caps (spec §2.3). */
+exports.ARGS_MAX_BYTES = 64 * 1024;
+exports.RESULT_SUMMARY_MAX_BYTES = 4 * 1024;
+exports.PROMPT_MAX_BYTES = 64 * 1024;
+exports.COMMIT_MESSAGE_MAX_BYTES = 16 * 1024;
+exports.COMMIT_FILES_MAX = 1000;
+exports.METADATA_MAX_BYTES = 8 * 1024;
+/** Default query limit; hard ceiling on rows returned. */
+exports.DEFAULT_QUERY_LIMIT = 100;
+exports.MAX_QUERY_LIMIT = 10_000;
+/** Performance budget — single hook invocation total wall-clock. */
+exports.PERF_BUDGET_MS = 50;
+exports.PERF_WARN_MS = 50;
+/** Truncation marker appended to truncated string fields. */
+exports.TRUNCATED_SUFFIX = '... [truncated]';
+/** Fixed response text when timeline is disabled via env. */
+exports.DISABLED_RESPONSE_TEXT = '';
+/**
+ * Claude Code hook event name → cgraphx hidden subcommand name.
+ *
+ * Single source of truth — installer (writes settings.json) and cli.ts
+ * (registers the actual commands) both read from here, so a typo can't
+ * desync them.
+ */
+exports.HOOK_EVENTS_TO_COMMANDS = [
+    { event: 'UserPromptSubmit', subcommand: 'timeline-user-prompt-hook' },
+    { event: 'PreToolUse', subcommand: 'timeline-pre-tool-use-hook' },
+    { event: 'PostToolUse', subcommand: 'timeline-post-tool-use-hook' },
+    { event: 'Stop', subcommand: 'timeline-stop-hook' },
+];
+exports.GIT_COMMIT_SUBCOMMAND = 'timeline-git-commit-hook';
+// ─── Tool classification (timeline-data-quality feature) ───────────────────
+// Defined here so multiple B tasks (enricher hooks) share one source of truth.
+/**
+ * Tools that mutate state and are therefore worth recording as pre_tool_use
+ * (write-tools whitelist). Used by B-2 to decide which pre events to keep —
+ * read-only tool pre events are dropped to cut noise.
+ *
+ * Bash is included because it carries semantic signals (test/build/lint/git-write)
+ * even though it does not directly modify a single file.
+ */
+exports.WRITE_TOOLS_WHITELIST = new Set([
+    'Edit', 'Write', 'MultiEdit', 'NotebookEdit', 'Bash',
+]);
+/**
+ * Task-management tools (B-3 extracts subject/status/taskId from these).
+ */
+exports.TASK_TOOLS = new Set([
+    'TaskUpdate', 'TaskCreate', 'TaskGet',
+]);
+/**
+ * File-reading tools (B-5 splits topFiles into read vs written).
+ */
+exports.READ_FILE_TOOLS = new Set(['Read', 'Grep', 'Glob']);
+/**
+ * File-writing tools (B-5). Note: distinct from WRITE_TOOLS_WHITELIST —
+ * Bash is in the whitelist (carries duration/semantic value) but does not
+ * directly modify a specific file, so it is excluded here.
+ */
+exports.WRITE_FILE_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+//# sourceMappingURL=constants.js.map

package/dist/timeline/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/timeline/constants.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uFAAuF;AAC1E,QAAA,eAAe,GAAG,qBAAqB,CAAC;AAErD,mEAAmE;AACtD,QAAA,uBAAuB,GAAG,CAAC,CAAC;AAEzC,mCAAmC;AACtB,QAAA,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3B,QAAA,wBAAwB,GAAG,CAAC,GAAG,IAAI,CAAC;AACpC,QAAA,gBAAgB,GAAG,EAAE,GAAG,IAAI,CAAC;AAC7B,QAAA,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAC;AACrC,QAAA,gBAAgB,GAAG,IAAI,CAAC;AACxB,QAAA,kBAAkB,GAAG,CAAC,GAAG,IAAI,CAAC;AAE3C,0DAA0D;AAC7C,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAC1B,QAAA,eAAe,GAAG,MAAM,CAAC;AAEtC,oEAAoE;AACvD,QAAA,cAAc,GAAG,EAAE,CAAC;AACpB,QAAA,YAAY,GAAG,EAAE,CAAC;AAE/B,6DAA6D;AAChD,QAAA,gBAAgB,GAAG,iBAAiB,CAAC;AAElD,6DAA6D;AAChD,QAAA,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAyD;IAC3F,EAAE,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,2BAA2B,EAAE;IACtE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,4BAA4B,EAAE;IACjE,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,6BAA6B,EAAE;IACnE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,EAAE;CACpD,CAAC;AAEW,QAAA,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE,8EAA8E;AAC9E,+EAA+E;AAE/E;;;;;;;GAOG;AACU,QAAA,qBAAqB,GAAG,IAAI,GAAG,CAAC;IAC3C,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM;CACrD,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,UAAU,GAAG,IAAI,GAAG,CAAC;IAChC,YAAY,EAAE,YAAY,EAAE,SAAS;CACtC,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE;;;;GAIG;AACU,QAAA,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC"}

package/dist/timeline/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Error types for the Developer Timeline subsystem.
+ *
+ * Independent from cgraphx's main error types so the subsystem can be
+ * removed without touching the rest of the project. All errors are
+ * operational and the hook layer swallows them (writes stderr + exit 0)
+ * so they never block Claude.
+ */
+export type TimelineErrorCode = 'PAYLOAD_INVALID' | 'SCHEMA_ERROR' | 'STORE_INSERT_FAILED' | 'STORE_QUERY_FAILED';
+export declare class TimelineError extends Error {
+    readonly code: TimelineErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: TimelineErrorCode, details?: Record<string, unknown> | undefined);
+}
+export declare class HookPayloadError extends TimelineError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class TimelineSchemaError extends TimelineError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class StoreInsertError extends TimelineError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class StoreQueryError extends TimelineError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/timeline/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,iBAAiB,GACzB,iBAAiB,GACjB,cAAc,GACd,qBAAqB,GACrB,oBAAoB,CAAC;AAEzB,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,iBAAiB;aACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,iBAAiB,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D"}

package/dist/timeline/errors.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Error types for the Developer Timeline subsystem.
+ *
+ * Independent from cgraphx's main error types so the subsystem can be
+ * removed without touching the rest of the project. All errors are
+ * operational and the hook layer swallows them (writes stderr + exit 0)
+ * so they never block Claude.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreQueryError = exports.StoreInsertError = exports.TimelineSchemaError = exports.HookPayloadError = exports.TimelineError = void 0;
+class TimelineError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'TimelineError';
+    }
+}
+exports.TimelineError = TimelineError;
+class HookPayloadError extends TimelineError {
+    constructor(message, details) {
+        super(message, 'PAYLOAD_INVALID', details);
+        this.name = 'HookPayloadError';
+    }
+}
+exports.HookPayloadError = HookPayloadError;
+class TimelineSchemaError extends TimelineError {
+    constructor(message, details) {
+        super(message, 'SCHEMA_ERROR', details);
+        this.name = 'TimelineSchemaError';
+    }
+}
+exports.TimelineSchemaError = TimelineSchemaError;
+class StoreInsertError extends TimelineError {
+    constructor(message, details) {
+        super(message, 'STORE_INSERT_FAILED', details);
+        this.name = 'StoreInsertError';
+    }
+}
+exports.StoreInsertError = StoreInsertError;
+class StoreQueryError extends TimelineError {
+    constructor(message, details) {
+        super(message, 'STORE_QUERY_FAILED', details);
+        this.name = 'StoreQueryError';
+    }
+}
+exports.StoreQueryError = StoreQueryError;
+//# sourceMappingURL=errors.js.map

package/dist/timeline/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/timeline/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAQH,MAAa,aAAc,SAAQ,KAAK;IAGpB;IACA;IAHlB,YACE,OAAe,EACC,IAAuB,EACvB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAmB;QACvB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AATD,sCASC;AAED,MAAa,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED,MAAa,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,MAAa,gBAAiB,SAAQ,aAAa;IACjD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED,MAAa,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC"}

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

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ */
+import { type EventEnricher } from './recorder';
+import { extractHookPayload } from './payload';
+import type { TimelineEventInput } from './types';
+export interface HookRunResult {
+    payloadPresent: boolean;
+    recorded: boolean;
+    durationMs: number;
+    error?: string;
+}
+/** Options bag passed to runHook. */
+export interface RunHookOptions {
+    /**
+     * Optional enricher forwarded to recordEvent. Runs inside recordEvent
+     * before insert, with a live store handle so it can query prior events.
+     * Any exception is caught by runHook's try/catch — the hook never throws.
+     */
+    enricher?: EventEnricher;
+}
+/**
+ * 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.
+ */
+export declare function runHook(buildEvent: (payload: ReturnType<typeof extractHookPayload>) => Promise<TimelineEventInput | null> | TimelineEventInput | null, options?: RunHookOptions): Promise<void>;
+export declare function isKillSwitchOn(): boolean;
+//# sourceMappingURL=hook-runner.d.ts.map