@halyard/cli 0.1.1 → 0.2.0

package/dist/lib/discovery.js

@@ -1,9 +1,22 @@
 import { homedir } from 'node:os';
-import { join, basename } from 'node:path';
-import { readdirSync, statSync, existsSync } from 'node:fs';
+import { join, basename, extname } from 'node:path';
+import { readdirSync, readFileSync, statSync, existsSync, openSync, readSync, closeSync, } from 'node:fs';
+import { buildCopilotBundle, listCopilotSessions } from './copilot-export.js';
+import { exportOpencodeSession, listOpencodeSessions } from './opencode-export.js';
+export const SESSION_PROVIDERS = [
+    'claude',
+    'codex',
+    'gemini',
+    'opencode',
+    'copilot',
+];
+/** How much of a session file to read when looking for the cwd record. */
+const HEAD_BYTES = 64 * 1024;
+/** How many head lines to scan for a Claude cwd record. */
+const MAX_HEAD_LINES = 50;
 /**
  * Discover Claude Code session log files.
- * Claude Code stores sessions in ~/.claude/projects/<project-hash>/sessions/
+ * Claude Code stores sessions in ~/.claude/projects/<project-hash>/
  * Session files are JSONL format.
  */
 export function discoverClaudeSessions() {
@@ -18,7 +31,7 @@ export function discoverClaudeSessions() {
             if (!statSync(projectPath).isDirectory())
                 continue;
             // Look for JSONL files directly in project dir and in sessions subdirs
-            walkForJsonl(projectPath, 'claude', sessions, 0);
+            walkForSessionFiles(projectPath, 'claude', ['.jsonl'], sessions, 0);
         }
     }
     catch {
@@ -35,24 +48,108 @@ export function discoverCodexSessions() {
     if (!existsSync(codexDir))
         return [];
     const sessions = [];
-    walkForJsonl(codexDir, 'codex', sessions, 0);
+    walkForSessionFiles(codexDir, 'codex', ['.jsonl'], sessions, 0);
     return sessions;
 }
+/**
+ * Discover Gemini CLI chat session files.
+ * Gemini CLI stores sessions in ~/.gemini/tmp/<project>/chats/session-*.jsonl
+ * (legacy sessions are single-JSON `.json` files; subagent sessions live in
+ * chats/<parent-session-id>/ subdirectories).
+ */
+export function discoverGeminiSessions() {
+    const geminiTmp = join(homedir(), '.gemini', 'tmp');
+    if (!existsSync(geminiTmp))
+        return [];
+    const sessions = [];
+    try {
+        for (const project of readdirSync(geminiTmp)) {
+            const chatsDir = join(geminiTmp, project, 'chats');
+            try {
+                if (!statSync(chatsDir).isDirectory())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            walkForSessionFiles(chatsDir, 'gemini', ['.jsonl', '.json'], sessions, 0);
+        }
+    }
+    catch {
+        // Permission errors - silently skip
+    }
+    return sessions;
+}
+/**
+ * Discover OpenCode sessions. OpenCode keeps everything in a SQLite
+ * database; sessions are listed via the `opencode` CLI itself and exported
+ * one at a time at upload time (see loadSessionContent).
+ */
+export function discoverOpencodeSessions() {
+    return listOpencodeSessions().map((s) => ({
+        provider: 'opencode',
+        filePath: `opencode://${s.id}`,
+        sessionId: s.id,
+        sizeBytes: 0,
+        freshness: `${s.id}:${s.timeUpdated}`,
+    }));
+}
+/**
+ * Discover GitHub Copilot CLI sessions. Copilot CLI keeps all sessions in
+ * one shared SQLite store (~/.copilot/session-store.db); each session is
+ * exported as a JSONL bundle at upload time (see loadSessionContent).
+ */
+export function discoverCopilotSessions() {
+    return listCopilotSessions().map((s) => ({
+        provider: 'copilot',
+        filePath: `copilot://${s.id}`,
+        sessionId: s.id,
+        sizeBytes: 0,
+        freshness: `${s.id}:${s.updatedAt}`,
+    }));
+}
+const DISCOVERERS = {
+    claude: discoverClaudeSessions,
+    codex: discoverCodexSessions,
+    gemini: discoverGeminiSessions,
+    opencode: discoverOpencodeSessions,
+    copilot: discoverCopilotSessions,
+};
 /**
  * Auto-detect which providers have session files available.
  */
 export function discoverAllSessions(providerFilter) {
     const sessions = [];
-    if (!providerFilter || providerFilter === 'claude') {
-        sessions.push(...discoverClaudeSessions());
-    }
-    if (!providerFilter || providerFilter === 'codex') {
-        sessions.push(...discoverCodexSessions());
+    for (const provider of SESSION_PROVIDERS) {
+        if (providerFilter && providerFilter !== provider)
+            continue;
+        sessions.push(...DISCOVERERS[provider]());
     }
     return sessions;
 }
-/** Recursively walk a directory for .jsonl files, with a max depth. */
-function walkForJsonl(dir, provider, results, depth) {
+/**
+ * Materialize the bytes to upload for a discovered session: the file itself
+ * for file-backed providers, or a synthesized export for store-backed ones.
+ */
+export async function loadSessionContent(session) {
+    if (session.provider === 'opencode') {
+        return exportOpencodeSession(session.sessionId);
+    }
+    if (session.provider === 'copilot') {
+        return buildCopilotBundle(session.sessionId);
+    }
+    return readFileSync(session.filePath);
+}
+/** The name the ingest endpoint stores for the uploaded blob. */
+export function uploadFileName(session) {
+    if (session.provider === 'opencode')
+        return `${session.sessionId}.json`;
+    if (session.provider === 'copilot')
+        return `${session.sessionId}.jsonl`;
+    return basename(session.filePath);
+}
+/** Recursively walk a directory for session files, with a max depth. */
+function walkForSessionFiles(dir, provider, extensions, results, depth) {
     if (depth > 3)
         return; // Don't recurse too deep
     try {
@@ -62,14 +159,15 @@ function walkForJsonl(dir, provider, results, depth) {
             try {
                 const stat = statSync(fullPath);
                 if (stat.isDirectory()) {
-                    walkForJsonl(fullPath, provider, results, depth + 1);
+                    walkForSessionFiles(fullPath, provider, extensions, results, depth + 1);
                 }
-                else if (entry.endsWith('.jsonl') && stat.size > 0) {
+                else if (extensions.includes(extname(entry)) && stat.size > 0) {
                     results.push({
                         provider,
                         filePath: fullPath,
-                        sessionId: basename(entry, '.jsonl'),
+                        sessionId: basename(entry, extname(entry)),
                         sizeBytes: stat.size,
+                        cwd: extractSessionCwd(fullPath, provider),
                     });
                 }
             }
@@ -82,4 +180,78 @@ function walkForJsonl(dir, provider, results, depth) {
         // Skip directories we can't read
     }
 }
+/**
+ * Extract the session's working directory from the head of a log file.
+ * Only claude and codex formats are known to carry it; other providers
+ * return undefined (their sessions count as unresolved in scoped sync).
+ */
+function extractSessionCwd(filePath, provider) {
+    if (provider !== 'claude' && provider !== 'codex')
+        return undefined;
+    const head = readFileHead(filePath);
+    if (head === null)
+        return undefined;
+    if (provider === 'codex') {
+        const firstLine = head.split('\n', 1)[0] ?? '';
+        return extractCodexCwd(firstLine);
+    }
+    return extractClaudeCwd(head);
+}
+/**
+ * Claude session logs: the first records are often non-cwd entries
+ * (type:"queue-operation", "last-prompt", ...); a record carrying a `cwd`
+ * string reliably appears within the first few lines. Scan up to
+ * MAX_HEAD_LINES JSON lines and take the first `cwd` found.
+ */
+export function extractClaudeCwd(head) {
+    const lines = head.split('\n', MAX_HEAD_LINES);
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        try {
+            const parsed = JSON.parse(line);
+            if (typeof parsed.cwd === 'string' && parsed.cwd.length > 0)
+                return parsed.cwd;
+        }
+        catch {
+            // Malformed (or truncated tail) line - keep scanning
+        }
+    }
+    return undefined;
+}
+/**
+ * Codex session logs: the first line is a session_meta record with the cwd at
+ * `payload.cwd` (older formats used a top-level `cwd`).
+ */
+export function extractCodexCwd(firstLine) {
+    try {
+        const parsed = JSON.parse(firstLine);
+        if (typeof parsed.payload?.cwd === 'string' && parsed.payload.cwd.length > 0) {
+            return parsed.payload.cwd;
+        }
+        if (typeof parsed.cwd === 'string' && parsed.cwd.length > 0)
+            return parsed.cwd;
+    }
+    catch {
+        // Malformed first line
+    }
+    return undefined;
+}
+/** Read up to HEAD_BYTES from the start of a file without loading the rest. */
+function readFileHead(filePath) {
+    try {
+        const fd = openSync(filePath, 'r');
+        try {
+            const buffer = Buffer.alloc(HEAD_BYTES);
+            const bytesRead = readSync(fd, buffer, 0, HEAD_BYTES, 0);
+            return buffer.toString('utf-8', 0, bytesRead);
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=discovery.js.map

package/dist/lib/discovery.js.map

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

package/dist/lib/hook-discovery.d.ts

@@ -0,0 +1,43 @@
+import { type HookClient, type HookEvent } from './hook-input.js';
+/**
+ * What `halyard hook` uploads for a client when the payload carries no
+ * transcript path. Claude and Codex logs record their cwd, so their sweeps go
+ * through the repo-scoped sync pipeline (`sync-runner`), which resolves each
+ * session's cwd to a repo identity. The clients below have no cwd in their
+ * transcripts, so they are matched by path or session id instead.
+ */
+export interface SweepTarget {
+    file: string;
+    provider: string;
+}
+export interface SweepContext {
+    homeDir: string;
+    projectRoot: string;
+    sessionId: string;
+    transcriptPath: string;
+    event: HookEvent;
+    env: NodeJS.ProcessEnv;
+}
+export type SweepPlan = {
+    kind: 'files';
+    targets: SweepTarget[];
+} | {
+    kind: 'sync';
+    provider: string;
+    /** Restrict to sessions whose cwd resolves to this repo (Claude, Codex). */
+    scoped: boolean;
+};
+/** Claude keeps subagent transcripts beside the main one:
+ *  <dir>/<session>.jsonl + <dir>/<session>/subagents/agent-*.jsonl */
+export declare function claudeSessionFiles(transcript: string): string[];
+/** Rollout files end in the thread id: rollout-<timestamp>-<id>.jsonl */
+export declare function findCodexRollout(homeDir: string, sessionId: string): string | null;
+/** ~/.cursor/projects/<path-slug>/agent-transcripts/<conversation>/<conversation>.jsonl */
+export declare function sweepCursor(ctx: SweepContext): SweepTarget[];
+/** Grok Build keeps sessions under ~/.grok/sessions; the payload carries only
+ *  the session id, so match on it. Layout is undocumented — best effort. */
+export declare function sweepGrok(ctx: SweepContext): SweepTarget[];
+/** Amp caches threads as T-<id>.json under ~/.local/share/amp (or AMP_DATA_DIR). */
+export declare function sweepAmp(ctx: SweepContext): SweepTarget[];
+export declare function sweepForClient(client: HookClient, ctx: SweepContext): SweepPlan;
+//# sourceMappingURL=hook-discovery.d.ts.map

package/dist/lib/hook-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-discovery.d.ts","sourceRoot":"","sources":["../../src/lib/hook-discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAA;AAExB;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,SAAS,CAAA;IAChB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CACvB;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,GACzC;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAuBL;sEACsE;AACtE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAW/D;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASlF;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,EAAE,CAO5D;AAED;4EAC4E;AAC5E,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,EAAE,CAQ1D;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,EAAE,CAQzD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,GAAG,SAAS,CAe/E"}

package/dist/lib/hook-discovery.js

@@ -0,0 +1,90 @@
+import { readdirSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { isDirectory, isNonEmptyFile, pathSlug, } from './hook-input.js';
+function listFiles(dir, depth, predicate, out = []) {
+    if (depth < 0 || !isDirectory(dir))
+        return out;
+    let entries = [];
+    try {
+        entries = readdirSync(dir).sort();
+    }
+    catch {
+        return out;
+    }
+    for (const name of entries) {
+        const full = join(dir, name);
+        if (isDirectory(full))
+            listFiles(full, depth - 1, predicate, out);
+        else if (predicate(name) && isNonEmptyFile(full))
+            out.push(full);
+    }
+    return out;
+}
+/** Claude keeps subagent transcripts beside the main one:
+ *  <dir>/<session>.jsonl + <dir>/<session>/subagents/agent-*.jsonl */
+export function claudeSessionFiles(transcript) {
+    const dir = dirname(transcript);
+    const sessionId = basename(transcript, '.jsonl');
+    const files = [transcript];
+    const subagents = join(dir, sessionId, 'subagents');
+    if (isDirectory(subagents)) {
+        for (const name of readdirSync(subagents).sort()) {
+            if (name.endsWith('.jsonl'))
+                files.push(join(subagents, name));
+        }
+    }
+    return files.filter(isNonEmptyFile);
+}
+/** Rollout files end in the thread id: rollout-<timestamp>-<id>.jsonl */
+export function findCodexRollout(homeDir, sessionId) {
+    if (!sessionId)
+        return null;
+    const suffix = `-${sessionId}.jsonl`;
+    const rollouts = listFiles(join(homeDir, '.codex', 'sessions'), 6, (name) => name.startsWith('rollout-') && name.endsWith(suffix));
+    return rollouts[0] ?? null;
+}
+/** ~/.cursor/projects/<path-slug>/agent-transcripts/<conversation>/<conversation>.jsonl */
+export function sweepCursor(ctx) {
+    const slug = pathSlug(ctx.projectRoot).replace(/^-/, '');
+    const dir = join(ctx.homeDir, '.cursor', 'projects', slug, 'agent-transcripts');
+    return listFiles(dir, 1, (name) => name.endsWith('.jsonl')).map((file) => ({
+        file,
+        provider: 'cursor',
+    }));
+}
+/** Grok Build keeps sessions under ~/.grok/sessions; the payload carries only
+ *  the session id, so match on it. Layout is undocumented — best effort. */
+export function sweepGrok(ctx) {
+    if (!ctx.sessionId)
+        return [];
+    const dir = join(ctx.homeDir, '.grok', 'sessions');
+    return listFiles(dir, 4, (name) => name.includes(ctx.sessionId) && (name.endsWith('.json') || name.endsWith('.jsonl'))).map((file) => ({ file, provider: 'other' }));
+}
+/** Amp caches threads as T-<id>.json under ~/.local/share/amp (or AMP_DATA_DIR). */
+export function sweepAmp(ctx) {
+    if (!ctx.sessionId)
+        return [];
+    const dir = ctx.env['AMP_DATA_DIR'] ?? join(ctx.homeDir, '.local', 'share', 'amp');
+    const wanted = `${ctx.sessionId}.json`;
+    return listFiles(dir, 6, (name) => name === wanted).map((file) => ({
+        file,
+        provider: 'other',
+    }));
+}
+export function sweepForClient(client, ctx) {
+    switch (client) {
+        case 'claude':
+        case 'codex':
+            return { kind: 'sync', provider: client, scoped: true };
+        case 'cursor':
+            return { kind: 'files', targets: sweepCursor(ctx) };
+        case 'grok':
+            return { kind: 'files', targets: sweepGrok(ctx) };
+        case 'amp':
+            return { kind: 'files', targets: sweepAmp(ctx) };
+        default:
+            // Gemini / OpenCode / Copilot logs carry no cwd: machine-wide sync.
+            return { kind: 'sync', provider: client, scoped: false };
+    }
+}
+//# sourceMappingURL=hook-discovery.js.map

package/dist/lib/hook-discovery.js.map

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

package/dist/lib/hook-input.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Parsing and normalisation for `halyard hook`: the JSON every client pipes to
+ * a lifecycle hook, the event names they use, and where the repo root is.
+ */
+export type HookClient = 'claude' | 'codex' | 'cursor' | 'gemini' | 'copilot' | 'opencode' | 'grok' | 'amp';
+/** `start` sweeps missed transcripts, `end` uploads the one that just finished. */
+export type HookEvent = 'start' | 'end' | 'sweep';
+export declare const HOOK_CLIENTS: readonly HookClient[];
+export declare function isHookClient(value: string): value is HookClient;
+export interface HookInput {
+    event: string;
+    sessionId: string;
+    transcriptPath: string;
+    cwd: string;
+}
+/**
+ * Field names differ per client (Claude/Codex/Gemini: snake_case, Copilot:
+ * camelCase, Cursor: conversation_id + workspace_roots[]), so pick from lists.
+ */
+export declare function parseHookInput(raw: string): HookInput;
+export declare function normalizeEvent(name: string): HookEvent | null;
+/** Transcript path first, then the host's environment. Cursor also exports
+ *  CLAUDE_PROJECT_DIR as a compatibility alias, so it is tested before Claude. */
+export declare function detectClient(transcriptPath: string, env: NodeJS.ProcessEnv): HookClient;
+/** Ingest provider for a client. Clients without a Halyard parser upload as
+ *  `other`: the raw log is kept and re-processed once a parser lands. */
+export declare function providerForClient(client: HookClient): string;
+export declare function isDirectory(path: string): boolean;
+export declare function isNonEmptyFile(path: string): boolean;
+/** First existing directory among the candidates, promoted to its git root. */
+export declare function resolveProjectRoot(candidates: ReadonlyArray<string | undefined>, fallback: string): string;
+/** Last `KEY=value` line of a dotenv file (quotes stripped), or ''. */
+export declare function readDotenvVar(file: string, key: string): string;
+/** Claude and Cursor name project dirs by the path with `/` and `.` → `-`. */
+export declare function pathSlug(path: string): string;
+//# sourceMappingURL=hook-input.d.ts.map

package/dist/lib/hook-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-input.d.ts","sourceRoot":"","sources":["../../src/lib/hook-input.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,GACN,KAAK,CAAA;AAET,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAA;AAEjD,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAS7C,CAAA;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,GAAG,EAAE,MAAM,CAAA;CACZ;AAgBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAqBrD;AAeD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAK7D;AAUD;kFACkF;AAClF,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAQvF;AAED;yEACyE;AACzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD;AAWD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,EAC7C,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AAUD,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/lib/hook-input.js

@@ -0,0 +1,161 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+export const HOOK_CLIENTS = [
+    'claude',
+    'codex',
+    'cursor',
+    'gemini',
+    'copilot',
+    'opencode',
+    'grok',
+    'amp',
+];
+export function isHookClient(value) {
+    return HOOK_CLIENTS.includes(value);
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function pickString(record, keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return '';
+}
+/**
+ * Field names differ per client (Claude/Codex/Gemini: snake_case, Copilot:
+ * camelCase, Cursor: conversation_id + workspace_roots[]), so pick from lists.
+ */
+export function parseHookInput(raw) {
+    let record = {};
+    try {
+        record = asRecord(JSON.parse(raw));
+    }
+    catch {
+        record = {};
+    }
+    const roots = Array.isArray(record['workspace_roots']) ? record['workspace_roots'] : [];
+    const firstRoot = typeof roots[0] === 'string' ? roots[0] : '';
+    return {
+        event: pickString(record, ['hook_event_name', 'hookEventName', 'event', 'type']),
+        sessionId: pickString(record, [
+            'session_id',
+            'sessionId',
+            'conversation_id',
+            'thread_id',
+            'threadId',
+        ]),
+        transcriptPath: pickString(record, ['transcript_path', 'transcriptPath']),
+        cwd: pickString(record, ['cwd', 'workspace_root', 'workspaceRoot', 'project_dir']) || firstRoot,
+    };
+}
+const START_EVENTS = new Set(['SessionStart', 'sessionStart', 'session_start', 'session.start']);
+const END_EVENTS = new Set([
+    'SessionEnd',
+    'sessionEnd',
+    'session_end',
+    'session.end',
+    'Stop',
+    'stop',
+    'session.idle',
+    'agent-turn-complete',
+    'agent.end',
+]);
+export function normalizeEvent(name) {
+    if (name === 'sweep')
+        return 'sweep';
+    if (START_EVENTS.has(name))
+        return 'start';
+    if (END_EVENTS.has(name))
+        return 'end';
+    return null;
+}
+const CLIENT_BY_PATH = [
+    ['/.claude/', 'claude'],
+    ['/.codex/', 'codex'],
+    ['/.cursor/', 'cursor'],
+    ['/.gemini/', 'gemini'],
+    ['/.copilot/', 'copilot'],
+];
+/** Transcript path first, then the host's environment. Cursor also exports
+ *  CLAUDE_PROJECT_DIR as a compatibility alias, so it is tested before Claude. */
+export function detectClient(transcriptPath, env) {
+    for (const [needle, client] of CLIENT_BY_PATH) {
+        if (transcriptPath.includes(needle))
+            return client;
+    }
+    if (env['CURSOR_PROJECT_DIR'] || env['CURSOR_VERSION'])
+        return 'cursor';
+    if (env['GEMINI_PROJECT_DIR'])
+        return 'gemini';
+    if (env['CODEX_CWD'] || env['CODEX_HOME'])
+        return 'codex';
+    return 'claude';
+}
+/** Ingest provider for a client. Clients without a Halyard parser upload as
+ *  `other`: the raw log is kept and re-processed once a parser lands. */
+export function providerForClient(client) {
+    return client === 'grok' || client === 'amp' ? 'other' : client;
+}
+export function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function isNonEmptyFile(path) {
+    try {
+        const stat = statSync(path);
+        return stat.isFile() && stat.size > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function gitToplevel(dir) {
+    const result = spawnSync('git', ['-C', dir, 'rev-parse', '--show-toplevel'], {
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    const out = result.status === 0 ? result.stdout.trim() : '';
+    return out.length > 0 ? out : null;
+}
+/** First existing directory among the candidates, promoted to its git root. */
+export function resolveProjectRoot(candidates, fallback) {
+    for (const candidate of candidates) {
+        if (!candidate || !isDirectory(candidate))
+            continue;
+        return gitToplevel(candidate) ?? candidate;
+    }
+    return fallback;
+}
+function unquote(value) {
+    const trimmed = value.trim();
+    const quoted = (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"));
+    return quoted && trimmed.length >= 2 ? trimmed.slice(1, -1) : trimmed;
+}
+/** Last `KEY=value` line of a dotenv file (quotes stripped), or ''. */
+export function readDotenvVar(file, key) {
+    if (!existsSync(file))
+        return '';
+    const pattern = new RegExp(`^\\s*(?:export\\s+)?${key}=(.*)$`);
+    let found = '';
+    for (const line of readFileSync(file, 'utf8').split('\n')) {
+        const match = pattern.exec(line.replace(/\r$/, ''));
+        if (match)
+            found = unquote(match[1] ?? '');
+    }
+    return found;
+}
+/** Claude and Cursor name project dirs by the path with `/` and `.` → `-`. */
+export function pathSlug(path) {
+    return path.replace(/[/.]/g, '-');
+}
+//# sourceMappingURL=hook-input.js.map

package/dist/lib/hook-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-input.js","sourceRoot":"","sources":["../../src/lib/hook-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAoB5D,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,MAAM;IACN,KAAK;CACN,CAAA;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAQ,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC5D,CAAC;AASD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAA;AACR,CAAC;AAED,SAAS,UAAU,CAAC,MAA+B,EAAE,IAAc;IACjE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;IACjE,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,MAAM,GAA4B,EAAE,CAAA;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,EAAE,CAAA;IACb,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACvF,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9D,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAChF,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE;YAC5B,YAAY;YACZ,WAAW;YACX,iBAAiB;YACjB,WAAW;YACX,UAAU;SACX,CAAC;QACF,cAAc,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QACzE,GAAG,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC,IAAI,SAAS;KAChG,CAAA;AACH,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC,CAAA;AAChG,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,aAAa;IACb,MAAM;IACN,MAAM;IACN,cAAc;IACd,qBAAqB;IACrB,WAAW;CACZ,CAAC,CAAA;AAEF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACpC,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAA;IAC1C,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,cAAc,GAAiD;IACnE,CAAC,WAAW,EAAE,QAAQ,CAAC;IACvB,CAAC,UAAU,EAAE,OAAO,CAAC;IACrB,CAAC,WAAW,EAAE,QAAQ,CAAC;IACvB,CAAC,WAAW,EAAE,QAAQ,CAAC;IACvB,CAAC,YAAY,EAAE,SAAS,CAAC;CAC1B,CAAA;AAED;kFACkF;AAClF,MAAM,UAAU,YAAY,CAAC,cAAsB,EAAE,GAAsB;IACzE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;QAC9C,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAA;IACpD,CAAC;IACD,IAAI,GAAG,CAAC,oBAAoB,CAAC,IAAI,GAAG,CAAC,gBAAgB,CAAC;QAAE,OAAO,QAAQ,CAAA;IACvE,IAAI,GAAG,CAAC,oBAAoB,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC9C,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,OAAO,CAAA;IACzD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;yEACyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,OAAO,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC3B,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE;QAC3E,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;KACpC,CAAC,CAAA;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3D,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AACpC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAChC,UAA6C,EAC7C,QAAgB;IAEhB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;YAAE,SAAQ;QACnD,OAAO,WAAW,CAAC,SAAS,CAAC,IAAI,SAAS,CAAA;IAC5C,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,MAAM,MAAM,GACV,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;IACpD,OAAO,MAAM,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;AACvE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,GAAW;IACrD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IAChC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,uBAAuB,GAAG,QAAQ,CAAC,CAAA;IAC9D,IAAI,KAAK,GAAG,EAAE,CAAA;IACd,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAA;QACnD,IAAI,KAAK;YAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;AACnC,CAAC"}