/** * One `hook_run` event per PAL hook process: which hook, for which event and * session, its exit code, and the milliseconds since the process started. */ import { basename } from "node:path"; import { appendEvent, logQuietly } from "./events"; const run: { event: string | null; session: string | null } = { event: null, session: null, }; function firstString(payload: Record, names: string[]): string | null { const value = names.map((n) => payload[n]).find((v) => typeof v === "string" && v); return (value as string | undefined) ?? null; } export function noteHookPayload(payload: unknown): void { if (!payload || typeof payload !== "object") return; const fields = payload as Record; run.event = firstString(fields, ["hook_event_name", "hookEventName"]); run.session = firstString(fields, ["session_id", "conversation_id", "sessionId"]); } export function noteHookPayloadText(text: string): void { try { noteHookPayload(JSON.parse(text)); } catch { noteHookPayload(null); } } function hookName(entry: string): string { return basename(entry).replace(/\.[cm]?[jt]s$/, ""); } export function logHookRun( entry: string, exitCode: number, durationMs: number = performance.now() ): void { logQuietly("hook_run", () => appendEvent( "hook_run", { hook: hookName(entry), event: run.event, durationMs: Math.round(durationMs), exitCode, }, { session: run.session, project: null } ) ); } type OnExit = (listener: (exitCode: number) => void) => void; const onProcessExit: OnExit = (listener) => process.once("exit", listener); export function recordHookRunOnExit( entry: string = process.argv[1] ?? "unknown", onExit: OnExit = onProcessExit ): void { onExit((exitCode) => logHookRun(entry, exitCode)); }