diff --git a/.claude/commands/orchestrate.md b/.claude/commands/orchestrate.md index fb9abe4b5..d9f1f56c3 100644 --- a/.claude/commands/orchestrate.md +++ b/.claude/commands/orchestrate.md @@ -354,9 +354,12 @@ verify: mutex: cpu.heavy success: requireWorkEvidence: true + requireCommit: true # コミット前の状態を合格にしない（#3430: ワーカーが途中でターンを閉じ、未コミットのまま exit 0 になった） requireScopeClean: true ``` +- **`requireCommit: true` を外さない**（#3430）。外すと未コミットの変更も作業証跡に数え、ワーカーがコミット前に + ターンを閉じたとき `wait --verify` が exit 0 を返す。契約の「1 つにコミットする」と裁定をそろえる。 - **契約は未コミットで配ってよい**。`work-evidence` / `scope` ゲートは変更集合から契約ファイル自身を 除外する（#1580）ので、契約を置いただけの worktree が「作業済み」に見えることはない。 - `scope.allow` は**Issueが触ると宣言した範囲**を書く。広すぎる allow は scope ゲートを無力化し、 @@ -604,6 +607,7 @@ verify: gates: [lint, typecheck] # テスト全体は PR の CI で見る（下の「検証ゲート」） success: requireWorkEvidence: true + requireCommit: true # 上の雛形と同じ（#3430: コミット前の状態を合格にしない） requireScopeClean: true ``` diff --git a/changelog.d/3430.md b/changelog.d/3430.md new file mode 100644 index 000000000..518caf84b --- /dev/null +++ b/changelog.d/3430.md @@ -0,0 +1,2 @@ + +- **fix(agent-health): Claude がバックグラウンドの作業を残してターンを閉じたとき wait が完了と読まないようにする** (#3430): Claude の Stop の時点で transcript に完了通知の届いていないバックグラウンドの作業（Bash の background 実行・Monitor・バックグラウンドのサブエージェント）があれば `self_resume_pending` を付け、Claude の source が `stopReportsSelfResume: true` を宣言する。`wait` はその Stop を #2614 と同じく最大 30 分保留し、作業の通知で開いた次のターンの Stop で完了とする。あわせて `/orchestrate` の契約の雛形に `requireCommit: true` を足し、コミット前の状態を合格にしない diff --git a/docs/module-reference.md b/docs/module-reference.md index cadea7f8a..7bc67dccc 100644 --- a/docs/module-reference.md +++ b/docs/module-reference.md @@ -272,7 +272,7 @@ const myState = getOrInitGlobal('__myState', () => new Map()); | `src/lib/db/task-events-db.ts` | task_events 行 I/O（Issue #1548、migration v51）。listTaskEvents(db,taskId,limit=200)（`created_at ASC, id ASC`。**同一 ms は日常茶飯事**で、拒否された遷移とその直後のリトライが逆順に読めると話が反転する）／insertTaskEvent（空 payload は `'{}'` ではなく NULL）。**insertTaskEvent と updateTaskStatus は `@/lib/db` バレルから re-export しない** — 状態機械の判断を経ていない行が混ざるとログの意味が消えるため、writer は applyTaskEvent 1 つに閉じる。バレルから取れるのは reader だけ。テストは fixture 都合で直接パスから import する | | `src/app/api/worktrees/[id]/tasks/` + `src/app/api/tasks/[taskId]/` | 実行契約 API（Issue #1545）。`POST /worktrees/:id/tasks`（body `{contractPath, cliToolId?, instanceId?}`）は契約を**サーバ側で**パースし（パスは worktree 相対で、完了条件はその worktree の verify.yaml から解決するため）201 で `{task(pending), message}` を返す。契約不正は 400＋`issues` 全件で **task 行は作らない**。`GET /worktrees/:id/tasks`（limit 既定20・1..100）、`GET /tasks/:taskId`→`{task, lastVerificationRun}`、`PATCH /tasks/:taskId` は **`running`/`failed`/`cancelled` のみ**受理する（`succeeded` は検証ランだけが与える判定で、クライアントの自己申告を受け入れると tasks 表の存在意義が消える）。終端 task の再オープンは 409 | | `src/app/api/hooks/agent-event/` + `src/lib/hooks/agent-event-service.ts` + `agent-event-types.ts` + `agent-event-intake.ts` | 構造化エージェントイベント受け口（Issue #1549、**#1722 で instance 相関とネイティブ payload 対応**）。**2 形式を受ける**: (a) CommandMate 形式 `{tool, event, cwd, sessionId?, worktreeId?, instanceId?, detail?}`、(b) Claude の生 payload `{hook_event_name, session_id, cwd, …}`（`type:"http"` はボディを加工できないため。`tool`/`worktreeId`/`instanceId` はクエリパラメータ）。語彙は stop / notification / session_start / **user_prompt_submit / session_end**（`agent-event-types.ts` に分離＝生成器と state が DB 依存なしに使える）。**相関の優先順は 明示 worktreeId > cwd 解決**、instanceId 明示があれば primary 固定を解除（#1722 が解消した route.ts:88）。**session_id は相関キーにしない** — `/clear` で変わる（#1721）。validateHookCwd は空/4096 超/NUL/相対/`..` セグメント（**percent-decode 後も検査**）を 400。`..` は正規化せず拒否する — resolve() で意味が変わる値を後段が使うのが traversal 検査の破られ方。**cwd は送られていれば常に検証する**が、worktreeId 明示時は必須ではない。resolveWorktreeByCwd は**両側 realpath**（macOS の /var↔/private/var、symlink された worktree ルート）で突合し、配下ディレクトリも一致、**入れ子は最長一致**。解決失敗も成功も **202 `{accepted:true}` で同一ボディ**（登録済みディレクトリの探索器にしないため）。stop の効果: active task に `agent_idle`（payload `{source:'hook'}`）→ 契約 `success.autoVerifyOnStop` が true なら startVerification(trigger='task')（**409 は正常な競合として握る**）→ lastStopEventAt 記録。**契約なし＝task 無しでは 3 番目だけ起き、既存運用への影響ゼロ**。stop 以外は受理・記録のみ。**同一 (worktree, tool, instance, event, 細目, sessionId) は 3 秒以内 1 回**（間にターンの境目が適用されていれば通す。`stop` は #3289、ターンの開始は #3301）（自動注入と手動 hook の二重配送対策）。認証は middleware 任せ（AUTH_EXCLUDED_PATHS 非掲載が access control の全部）。**Issue #1726 で `pre_tool_use` / `post_tool_use` を追加（7 語）。****Issue #1759: どの綴りがどの語かは route が持たず `getAgentEventSource(tool).normalizeEvent()` に委ねる** — Claude/codex/copilot は `Stop`、gemini は `AfterAgent`、opencode は `session.idle`、antigravity は**イベント名フィールドが無い**。`agent-event-types.ts` に残るのは 7 語だけで、綴りは `hooks/sources/hook-event-vocabulary.ts` へ移設した（S1/S2）。`pre_tool_use` の質問 payload も `source.parseQuestion()` 経由 Issue #2246: `applyAgentStopEvent` が `recordAgentStopEvent` の直後に `captureTranscriptTurnOnStop()` を await し、結果を `AgentStopOutcome.structuredHistoryCaptured` で返す。task 検索より前に置くのは契約の無いセッションでも必ず走らせるため。route ではなく service に置くのは `/api/hooks/agent-event` と互換の `/api/hooks/claude-done` の両方が stop の受け口だから Issue #2398: `applyAgentStopEvent` は転写リーダーを **1 回だけ await** する（#2246 のコメントにあった「ターンは既に終わっているので待っても誰も困らない」は claude では真、codex では偽 — codex は本 hook の終了を待って `task_complete` を書く）。`AgentStopOutcome` に `structuredHistoryOutcome: 'captured' \| 'deferred' \| 'unavailable'` を追加。`structuredHistoryCaptured` は「**応答前に**書けたか」に狭まり、遅延読みで後から書かれたターンでは false（route が同名でログしているため boolean のまま残した） **#2874**: codex の `user_prompt_submit` で、通知先インスタンス（`instanceId` 無指定は `codex`）の tmux セッションが無いとき `agent-event-instance-not-running` を warn。`isSessionRunning` を待たずに実行し、例外は握りつぶす（応答・記録は変えない、振り分け直しもしない）。 **Issue #3311**: `agent-event-duplicate-dropped` に instanceId・session（SHA-256 先頭 8 文字）・sinceLastMs・detail。 **Issue #3330**: `user_prompt_submit` は `source.promptJoinsOpenTurn(payload)` を `joinsOpenTurn` として記録へ渡す。 **#3376**: `POST` の段（本文の読み取り・検証 `readAgentEventRequest`、worktree 解決 `resolveAgentEventWorktree`、detail `readEventDetail`、重複の窓 `dropDuplicateAgentEvent`、状態への適用 `applyAgentEventToState`、codex の通知 `warnIfCodexInstanceNotRunning`、質問の記録 `recordQuestionIfAsked`）を `src/lib/hooks/agent-event-intake.ts` へ切り出した（順序・応答・ログ・`await` は不変。stop の適用と応答の組み立ては route に残る）。 `agent-event-unresolved-target` のログは `worktreeId`（あれば）と `cwdHash`（`cwd` の SHA-256 先頭 16 文字。`cwd` 自体は出さない、#3312）。 | -| `src/lib/hooks/sources/` | **`AgentEventSource` 抽象**（Issue #1759 / Epic #1720 Phase 4-1）。生成層・受信層のツール固有部分を 1 ツール 1 ファイルに閉じ込める。`types.ts`=I/F（`transport:'push'|'pull'`／`noDecision`／`NormalizedAgentEvent`／`PendingDecision`／`Verdict`／`VerdictEncoding`／`SourceLiveness`／`AgentSourceCapabilities`）、`event-mapper.ts`=**述語つきマッパ**＋未知イベント計数、`hook-event-vocabulary.ts`=CamelCase 綴り表と snake_case subtype 抽出（`agent-event-types.ts` から移設した S1/S2）、`define-source.ts`=`definePushHookSource`/`definePullEventSource`、`pending-decisions.ts`=裁定スロット＋`answerPendingDecision`、`abstain.ts`=`describeAbstain`、`registry.ts`=`CLIToolType`→実装、`legacy-relay.ts`=未対応ツール用の互換ソース、`claude/`=第一実装。**設計根拠は実測**（`docs/design/agent-hooks-phase4-live-verification.md` §8 / `opencode-server-live-verification.md` §9）: **`type:"http"` は Claude 専用**で他 4 ツールは中継スクリプト必須（codex は http を 1 つ書くと hooks.json 全体が死ぬ）／**7 語への写像は 1:1 でない**ので `Record` では opencode を写せない（`message.part.updated` が `part.state.status` で pre/post に割れる）／**fail 方向がソースごとに逆**（Claude/codex/copilot=fail-open、antigravity は空応答＝拒否、opencode は無限待ち＝10m19s 実測）ので `noDecision` を型として持ち `abstain` の意味を呼び出し側が読む／**未知 type で throw しない**（opencode の `server.heartbeat` は `/doc` に型が無く 10 秒ごとに来る）。ツール追加手順は `docs/design/agent-event-source-interface.md`。**Issue #1904: `copilot/hook-settings.ts` の machine-global 対策** — `~/.copilot/settings.json` はマシンに 1 本なので、相関キーに続き**ポート**も設定ファイルに焼けない。`CM_HOOK_PORT`（`launch-command.ts` の `HOOK_PORT_ENV_VAR`／一覧は `COMMANDMATE_HOOK_ENV_VARS`）。**Issue #1942: `COMMANDMATE_HOOK_ENV_VARS` の全要素は `CM_HOOK_` で始まること**が不変条件になった（`lib/security/env-sanitizer` はこの配列ではなく prefix で剥がすので、名前空間の外の名前を足すと宣言はされるのに子プロセスへ漏れる）。**この配列は「launch line に載る変数の全部」ではない** — codex は `CODEX_HOME` / `CM_AGENT_TOOL` / `CM_AGENT_WORKTREE_ID` / `CM_AGENT_INSTANCE_ID` / `CM_PERMISSION_HOOK_URL` も載せ、copilot は `CM_AGENT_WORKTREE_ID` / `CM_AGENT_INSTANCE_ID`、antigravity は `CM_PERMISSION_HOOK_URL` を載せる。これらは sanitizer の対象外で起動 env に載せ、生成 shell の冒頭で `case "$CM_HOOK_PORT" in ''|*[!0-9]*) … exit 0;; esac` の数値検証を通す。**scheme / host / relay の絶対パスは literal のまま**（宛先が定数であることが bearer 漏洩の防波堤／env の relay パスはコード実行の委譲）で、relay は `[ -x … ]` を発火時に見て inline `curl` へ落ちる。`${VAR:-既定}` の綴りは禁止（未設定なら発火しない）。`inspectCopilotConfigHooks()` は copilot が起動時に settings.json へ**移送・上書き**する `config.json` の `hooks` を検出し（実ファイルは `//` コメントつきなのでコメント除去後に解析）、あれば `CopilotConfigHooksShadowError` で注入を見送る。書き込みは temp + `rename` ＋ `.cmate.lock`（`O_EXCL`／10s で stale 奪取）＋ 1 世代バックアップ。`PreToolUse` の `curl` は `-fsS` で 4xx ボディを verdict にせず、失敗は理由コード 1 行を stderr に出す。根拠は `docs/design/multi-agent-state-architecture.md` §10.8 / §10.9 と `copilot-agent-hooks-injection.md` §7。**Issue #1783: `NormalizedAgentEvent.model`** を追加 — 抽出は `define-source.ts` の `buildNormalizedEvent` に一元化し、ツール差は spec の `modelFields?: readonly string[]`（フラットキー。claude/codex=`model`、antigravity=`modelName`）と `extractModel?: (payload)=>string|null`（フラットで届かない形。opencode の `properties.info.model.{modelID,id}`。**両方あれば関数が勝つ**）で宣言する。長さは `boundModel()` が `MAX_EVENT_DETAIL_LENGTH` で切る（値は UI のテキストノードまで行く）。gemini/copilot は payload に無いので常に null（gemini の `BeforeModel` は語彙に無く unknown-event として捨てられる）。**Issue #1846: #1759 が残した I/F 申し送り 5 件を裁定**（全裁定と理由は `docs/design/agent-event-source-interface.md` §3.3、テストは `tests/unit/hooks/sources/launch-contract-1846.test.ts`）。**採用 2 件**＝①`prepareLaunch` の引数を `AgentLaunchContext{target, executablePath, worktreePath}` に変更（`worktreePath` は**必須**。per-worktree 設定を持つ gemini が別 export `injectGeminiHookSettings()` を要らなくなり、設定書き出しが 6 ソースとも `prepareLaunch` 1 箇所に揃う。`AgentInstanceRef` は**キー**なので 3 フィールドのまま — パスを持つキーは worktree 移動で自分自身と等しくなくなる）②`AgentLaunchPlan.env: Record`（**必須**）＋ `launch-command.ts` の `renderAgentLaunchCommand`。codex/copilot/gemini/antigravity の**4 実装が独立に** `NAME=value ` を `command` へ前置していたのを剥がし、適用を 1 箇所に集約（出力バイト列は同一）。**不採用 3 件**＝③`NoDecisionBehavior` に `denies` を足す（前提が失効。agy は #1779 の実測で既に `proceeds`。`denies` はどのソースも出さないワイヤ値を記述し、エンコード修正の代わりに宣言する逃げ道になる）④`supportedEvents` の `emittable`/`delivered` 分割（**「届く語」である**と型 doc に明記。分割すると消費層がどちらを見るか選ばされ、copilot の `pre_tool_use`・gemini の `BeforeTool` でちょうど永久に待つ）⑤`definePullEventSource` への turn-gate 内蔵（状態機械は汎用だがフレーム語彙は完全に opencode 固有。§4 手順 6′ と §5 の**規約**にした） **Issue #1783: `NormalizedAgentEvent.model`** を追加 — 抽出は `define-source.ts` の `buildNormalizedEvent` に一元化し、ツール差は spec の `modelFields?: readonly string[]`（フラットキー。claude/codex=`model`、antigravity=`modelName`）と `extractModel?: (payload)=>string|null`（フラットで届かない形。opencode の `properties.info.model.{modelID,id}`。**両方あれば関数が勝つ**）で宣言する。長さは `boundModel()` が `MAX_EVENT_DETAIL_LENGTH` で切る（値は UI のテキストノードまで行く）。gemini/copilot は payload に無いので常に null（gemini の `BeforeModel` は語彙に無く unknown-event として捨てられる）。**Issue #1846: #1759 が残した I/F 申し送り 5 件を裁定**（全裁定と理由は `docs/design/agent-event-source-interface.md` §3.3、テストは `tests/unit/hooks/sources/launch-contract-1846.test.ts`）。**採用 2 件**＝①`prepareLaunch` の引数を `AgentLaunchContext{target, executablePath, worktreePath}` に変更（`worktreePath` は**必須**。per-worktree 設定を持つ gemini が別 export `injectGeminiHookSettings()` を要らなくなり、設定書き出しが 6 ソースとも `prepareLaunch` 1 箇所に揃う。`AgentInstanceRef` は**キー**なので 3 フィールドのまま — パスを持つキーは worktree 移動で自分自身と等しくなくなる）②`AgentLaunchPlan.env: Record`（**必須**）＋ `launch-command.ts` の `renderAgentLaunchCommand`。codex/copilot/gemini/antigravity の**4 実装が独立に** `NAME=value ` を `command` へ前置していたのを剥がし、適用を 1 箇所に集約（出力バイト列は同一）。**不採用 3 件**＝③`NoDecisionBehavior` に `denies` を足す（前提が失効。agy は #1779 の実測で既に `proceeds`。`denies` はどのソースも出さないワイヤ値を記述し、エンコード修正の代わりに宣言する逃げ道になる）④`supportedEvents` の `emittable`/`delivered` 分割（**「届く語」である**と型 doc に明記。分割すると消費層がどちらを見るか選ばされ、copilot の `pre_tool_use`・gemini の `BeforeTool` でちょうど永久に待つ）⑤`definePullEventSource` への turn-gate 内蔵（状態機械は汎用だがフレーム語彙は完全に opencode 固有。§4 手順 6′ と §5 の**規約**にした）。**Issue #1924: `AgentSourceCapabilities` に宣言値 5 項目を追加**（`permissionHookPredictsDialog` / `sessionStartMayArriveLate` / `permissionReplyReleasesPrompt` / `eventIdentity:'permission-id'|'tool-call-id'|'message-id'|null` / `resync:'none'|'session-status-poll'`）。**すべて JSON 直列化可能な宣言値で関数は置かない**（`capture --json` の `structuredEvents.source.capabilities` にそのまま載るため）。値は `docs/design/multi-agent-state-architecture.md` §4 D3 の 6×5 表が正で、`tests/unit/hooks/sources/capabilities.test.ts` が**件数ではなく値**を完全一致で pin する（grep 0 件は着手前から真＝空虚な緑、DR3-006）。claude 行が「未計測セルの既定値」で、departure は copilot の `sessionStartMayArriveLate:true`（#1903 実測）と opencode の `permissionReplyReleasesPrompt:true` / `eventIdentity:'permission-id'` / `resync:'session-status-poll'`（#1898-#1900 実測）だけ。**読み手（状態機械）は Phase 3/4**（#1927 / #1901 / #1903）で、Phase 1 は型と宣言値のみ。**Issue #1899: `eventIdentity` の抽出側 `AgentEventSource.eventIdentityOf(payload)`** を I/F に追加（spec の `extractEventIdentity?`、既定は `() => null`）。capability は「**どの** id を使うか」の宣言だけで、**どこに入っているかは source しか知らない** — opencode 1 ツールの中で `permission.asked`=`properties.id` / `permission.replied`=`properties.requestID`（同じ値・別綴り）/ tool part=`part.callID` / prompt=`info.id` / `session.idle`=**無し** の 5 通りある。`event-mapper.ts` の `readEventIdentity()` が長さ(`MAX_EVENT_IDENTITY_LENGTH`=128)と文字種 allowlist で検証し、**外れた値は切り詰めずに破棄**する（DR4-001。切り詰めると prefix が同じ別 id と衝突して無関係なフレームが重複に見える）。**capability を宣言して `extractEventIdentity` を配線し忘れると「id を宣言しているのに誰も読めない」状態**になり全フレームが無言で時間窓へ落ちるので、2 つは必ず同時に変える **Issue #1996: `launch-command.ts` に `AGENT_CORRELATION_ENV_VARS`(6 個) と `AGENT_LAUNCH_CONFIG_ENV_VARS`(`CODEX_HOME` の 1 個) を追加**し、「`COMMANDMATE_HOOK_ENV_VARS` は launch line に載る変数の全部ではない」という上記の但し書きを**宣言に格上げ**した。`tests/unit/lib/agent-launch-plan-secrets-1933.test.ts` が 7 ソースの `prepareLaunch` を実際に組み、`env` のキーが 2 つの宣言の和と**両方向で完全一致**することを見る（片方向だと「ソースが新しい変数を書き始めた」と「宣言した変数を書かなくなった」の一方を見逃す）。`AGENT_LAUNCH_CONFIG_ENV_VARS` を実測の 1 個に絞ったのは、allowlist を広く取るとそのソースがそれを書き始めた変化を素通しするため（#1933 のローカル allowlist に在った `COPILOT_HOME` / `XDG_CONFIG_HOME` は `process.env` からの読み出し専用で `plan.env` には入らない）。2 定数は `sources/index.ts`（scope 外）から re-export していないので、消費側は `@/lib/hooks/sources/launch-command` から直接 import する。 **Issue #2054**: `types.ts` に `AgentEventSourceKind`（`sse` / `hooks` / `scraper`）・`AgentEventSourceLiveness`・`AgentEventSourceStatus` を追加。`define-source.ts` に `AGENT_SOURCE_STALE_AFTER_MS`（30,000 ＝ opencode の実測 10 秒ハートビート 3 拍落ち。`OPENCODE_HEARTBEAT_TIMEOUT_MS` と同値であることをテストが assert。両モジュールは相互 import 不可）・`declaredAgentSourceKind()`（pull→`sse` / push かつ `supportedEvents` 空→`scraper` / それ以外→`hooks`。`createLegacyRelaySource` が空リストを「誰も計測していない」の意味で立てているのを根拠にしており、ツール名を書かない）・`describeAgentEventSource(source, liveness, now)` を追加。**後者が `structuredEvents.source.kind` と `CliToolSessionStatus.eventSource` を導出する唯一の場所**で、push ソースには `kind` しか publish しない（claude / codex の画面を #2054 以前と同一に保つのはこの非対称性）。`turn-body.ts`＝4 リーダー共通のターン本文レイアウト（Issue #2234）。`separateTurnBody(blocks)` が prose / `aside`(Thinking) / `tool` の 3 種別を受け、prose を先頭・ツール呼び出しを末尾のラベル付き blockquote（`> **Tool calls (N)**`）に分離する。実測 400 転写 586 turn 中 141 件が本文冒頭をツールログに占領されていた。`
` はカードが `rehypeRaw` を使わないためタグごと消える（実測）ので blockquote。ツール 0 件の turn は分離前とバイト同一で、保存済み行は書き換えない **Issue #2251: `registry.ts` の登録は 7 件になった**（claude / copilot / gemini / antigravity / codex / opencode / **command-code**。未登録は `vibe-local` のみ）。`index.ts` は `COMMAND_CODE_CLI_TOOL_ID` も re-export する。 **Issue #2272: `turn-body.ts` に 3 つめの節** — ブロック種別に `reasoning`（**生テキスト**。引用は節側が付ける）を追加し、`separateTurnBody()` は本文 → `> **${TURN_REASONING_LABEL} (N)**` 節 → `> **${TURN_TOOL_LOG_LABEL} (N)**` 節の順に並べる。`reasoning` の N ブロックは**見出し 1 つの下**に `>` 空行区切りで入り、`SeparatedTurnBody` に `reasoningLog` / `reasoningBlocks` が増える。既存の `aside`（リーダー側が自分で引用済みのテキスト）は**従来どおり本文の流れに残す**ので、`aside` を使う 4 リーダー（claude / codex / antigravity / command-code）の出力は 1 バイトも動かない。`TURN_REASONING_LABEL = 'Thinking'` はリーダー側の `*_THINKING_LABEL` と同値であることが前提（行は `chat_messages.content` に焼かれるので後から翻訳できない） **Issue #2403: `launch-command.ts` が起動行に起動サーバ自身の `CM_PORT` を pin する。** `renderAgentLaunchCommand()` は `plan.env` をそのまま描画するのをやめ、`resolveAgentLaunchEnv(plan)`（新 export。`plan.env` ＋ `SERVER_PORT_ENV_VAR`(=`'CM_PORT'`)）を描画する。値は **hook URL と同じ `getServerPort()`**（`src/lib/env.ts`）で、**無条件**・**末尾に append**・**プランが自分で `CM_PORT` を宣言していれば上書きしない**。7 ソースの `prepareLaunch` ではなくレンダラに置いたのは、「どのサーバが動いているか」が 7 ソース共通の事実で 7 箇所に写すと必ず 1 つ忘れるため、かつ **claude（相関キーは `--settings` ファイルの中）と opencode（ポートは argv）は `env: {}` を返す** — つまり不具合が実測された当の 2 ソースが、ソース側実装だと新たに env を生やす必要があるため。**直った現象**: 同一マシンの 2 サーバが同じ tmux サーバを共有すると `tmux show-environment -g` に先に起動したサーバの `CM_PORT` が載り、pane の `-zsh` がそれを継ぐ。`src/cli/utils/server-url.ts` の `loadClientEnv()` は `process.env` > `~/.commandmate/.env`（#1743 の仕様）なので、tmux 由来の `CM_PORT=3000` が `.env` の 60301 に勝ち、**hooks は 60301／CLI は 3000 で割れる**（`whoami` だけ tmux セッション名から導出するので正答し、`ask` は 3000 の DB から読んで exit 0 を返すため呼び出し側が気づけない）。`AGENT_LAUNCH_CONFIG_ENV_VARS` は `CODEX_HOME` ＋ `CM_PORT` の **2 個**になり、#1933 のドリフトガードの件数 pin は `7` → `8`（相関 6 ＋ 設定 2）。同ガードの測定対象も `plan.env` から `resolveAgentLaunchEnv(plan)` に移した（`plan.env` を読むと #2403 以降は「起動行」を読んでいないため）。**起動行のバイト固定 6 ファイル**（`tests/unit/hooks/sources/{launch-contract-1846,opencode,opencode-config-scope-2053,command-code-source,copilot-hook-settings}.test.ts` と `tests/unit/hooks/codex-hooks-config-1760.test.ts`）は `CM_PORT` を固定値に stub して期待値を更新した。**「env が空なら素のコマンド」という #1846 の不変条件は失効**し、代わりに「1 個だけ付く」を完全一致で pin する（余計な区切りはそこで出る）。 **Issue #2614**: 宣言 `stopReportsSelfResume`（`agent-event-types.ts` の宣言マージ。語 `SELF_RESUME_PENDING_DETAIL = 'self_resume_pending'` と同居）を追加し、antigravity だけ `true`（他 6 ソースと legacy-relay は `false`。claude は `Stop` の `background_tasks` が候補だが空配列しか採取していないため未対応）。agy の `Stop` hook は `buildAntigravityStopHookCommand()` になり、payload の `"fullyIdle":false`（agy 自身の契約で「バックグラウンドタスクがすべて終わったら true」）を空白除去後に `case` で検出して relay に `--detail self_resume_pending` を渡す（それ以外は従来と同じ relay 呼び出し。stdout には何も出さない）。source の `extractAntigravityEventDetail()` も生 payload の `fullyIdle === false` を同じ語に読む。 **Issue #3330**: `AgentEventSource.promptJoinsOpenTurn?(payload)`（任意。`PushHookSourceSpec.promptJoinsOpenTurn` から配線、未宣言は false）。claude だけが宣言（`claude/queued-notice.ts`）。 **Issue #3360**: claude の `prepareLaunch` は `CM_UAT_ISOLATION=1` で `--setting-sources project,local` を末尾に足す（settingsPath の判定は足す前のコマンドで行う）。 claude の `prepareLaunch` は own-home（#3312）で hook 設定の dir とファイル（`CM_AGENT_HOOKS_DIR`）を確認し、外なら・書けなければ起動を拒否。 | +| `src/lib/hooks/sources/` | **`AgentEventSource` 抽象**（Issue #1759 / Epic #1720 Phase 4-1）。生成層・受信層のツール固有部分を 1 ツール 1 ファイルに閉じ込める。`types.ts`=I/F（`transport:'push'|'pull'`／`noDecision`／`NormalizedAgentEvent`／`PendingDecision`／`Verdict`／`VerdictEncoding`／`SourceLiveness`／`AgentSourceCapabilities`）、`event-mapper.ts`=**述語つきマッパ**＋未知イベント計数、`hook-event-vocabulary.ts`=CamelCase 綴り表と snake_case subtype 抽出（`agent-event-types.ts` から移設した S1/S2）、`define-source.ts`=`definePushHookSource`/`definePullEventSource`、`pending-decisions.ts`=裁定スロット＋`answerPendingDecision`、`abstain.ts`=`describeAbstain`、`registry.ts`=`CLIToolType`→実装、`legacy-relay.ts`=未対応ツール用の互換ソース、`claude/`=第一実装。**設計根拠は実測**（`docs/design/agent-hooks-phase4-live-verification.md` §8 / `opencode-server-live-verification.md` §9）: **`type:"http"` は Claude 専用**で他 4 ツールは中継スクリプト必須（codex は http を 1 つ書くと hooks.json 全体が死ぬ）／**7 語への写像は 1:1 でない**ので `Record` では opencode を写せない（`message.part.updated` が `part.state.status` で pre/post に割れる）／**fail 方向がソースごとに逆**（Claude/codex/copilot=fail-open、antigravity は空応答＝拒否、opencode は無限待ち＝10m19s 実測）ので `noDecision` を型として持ち `abstain` の意味を呼び出し側が読む／**未知 type で throw しない**（opencode の `server.heartbeat` は `/doc` に型が無く 10 秒ごとに来る）。ツール追加手順は `docs/design/agent-event-source-interface.md`。**Issue #1904: `copilot/hook-settings.ts` の machine-global 対策** — `~/.copilot/settings.json` はマシンに 1 本なので、相関キーに続き**ポート**も設定ファイルに焼けない。`CM_HOOK_PORT`（`launch-command.ts` の `HOOK_PORT_ENV_VAR`／一覧は `COMMANDMATE_HOOK_ENV_VARS`）。**Issue #1942: `COMMANDMATE_HOOK_ENV_VARS` の全要素は `CM_HOOK_` で始まること**が不変条件になった（`lib/security/env-sanitizer` はこの配列ではなく prefix で剥がすので、名前空間の外の名前を足すと宣言はされるのに子プロセスへ漏れる）。**この配列は「launch line に載る変数の全部」ではない** — codex は `CODEX_HOME` / `CM_AGENT_TOOL` / `CM_AGENT_WORKTREE_ID` / `CM_AGENT_INSTANCE_ID` / `CM_PERMISSION_HOOK_URL` も載せ、copilot は `CM_AGENT_WORKTREE_ID` / `CM_AGENT_INSTANCE_ID`、antigravity は `CM_PERMISSION_HOOK_URL` を載せる。これらは sanitizer の対象外で起動 env に載せ、生成 shell の冒頭で `case "$CM_HOOK_PORT" in ''|*[!0-9]*) … exit 0;; esac` の数値検証を通す。**scheme / host / relay の絶対パスは literal のまま**（宛先が定数であることが bearer 漏洩の防波堤／env の relay パスはコード実行の委譲）で、relay は `[ -x … ]` を発火時に見て inline `curl` へ落ちる。`${VAR:-既定}` の綴りは禁止（未設定なら発火しない）。`inspectCopilotConfigHooks()` は copilot が起動時に settings.json へ**移送・上書き**する `config.json` の `hooks` を検出し（実ファイルは `//` コメントつきなのでコメント除去後に解析）、あれば `CopilotConfigHooksShadowError` で注入を見送る。書き込みは temp + `rename` ＋ `.cmate.lock`（`O_EXCL`／10s で stale 奪取）＋ 1 世代バックアップ。`PreToolUse` の `curl` は `-fsS` で 4xx ボディを verdict にせず、失敗は理由コード 1 行を stderr に出す。根拠は `docs/design/multi-agent-state-architecture.md` §10.8 / §10.9 と `copilot-agent-hooks-injection.md` §7。**Issue #1783: `NormalizedAgentEvent.model`** を追加 — 抽出は `define-source.ts` の `buildNormalizedEvent` に一元化し、ツール差は spec の `modelFields?: readonly string[]`（フラットキー。claude/codex=`model`、antigravity=`modelName`）と `extractModel?: (payload)=>string|null`（フラットで届かない形。opencode の `properties.info.model.{modelID,id}`。**両方あれば関数が勝つ**）で宣言する。長さは `boundModel()` が `MAX_EVENT_DETAIL_LENGTH` で切る（値は UI のテキストノードまで行く）。gemini/copilot は payload に無いので常に null（gemini の `BeforeModel` は語彙に無く unknown-event として捨てられる）。**Issue #1846: #1759 が残した I/F 申し送り 5 件を裁定**（全裁定と理由は `docs/design/agent-event-source-interface.md` §3.3、テストは `tests/unit/hooks/sources/launch-contract-1846.test.ts`）。**採用 2 件**＝①`prepareLaunch` の引数を `AgentLaunchContext{target, executablePath, worktreePath}` に変更（`worktreePath` は**必須**。per-worktree 設定を持つ gemini が別 export `injectGeminiHookSettings()` を要らなくなり、設定書き出しが 6 ソースとも `prepareLaunch` 1 箇所に揃う。`AgentInstanceRef` は**キー**なので 3 フィールドのまま — パスを持つキーは worktree 移動で自分自身と等しくなくなる）②`AgentLaunchPlan.env: Record`（**必須**）＋ `launch-command.ts` の `renderAgentLaunchCommand`。codex/copilot/gemini/antigravity の**4 実装が独立に** `NAME=value ` を `command` へ前置していたのを剥がし、適用を 1 箇所に集約（出力バイト列は同一）。**不採用 3 件**＝③`NoDecisionBehavior` に `denies` を足す（前提が失効。agy は #1779 の実測で既に `proceeds`。`denies` はどのソースも出さないワイヤ値を記述し、エンコード修正の代わりに宣言する逃げ道になる）④`supportedEvents` の `emittable`/`delivered` 分割（**「届く語」である**と型 doc に明記。分割すると消費層がどちらを見るか選ばされ、copilot の `pre_tool_use`・gemini の `BeforeTool` でちょうど永久に待つ）⑤`definePullEventSource` への turn-gate 内蔵（状態機械は汎用だがフレーム語彙は完全に opencode 固有。§4 手順 6′ と §5 の**規約**にした） **Issue #1783: `NormalizedAgentEvent.model`** を追加 — 抽出は `define-source.ts` の `buildNormalizedEvent` に一元化し、ツール差は spec の `modelFields?: readonly string[]`（フラットキー。claude/codex=`model`、antigravity=`modelName`）と `extractModel?: (payload)=>string|null`（フラットで届かない形。opencode の `properties.info.model.{modelID,id}`。**両方あれば関数が勝つ**）で宣言する。長さは `boundModel()` が `MAX_EVENT_DETAIL_LENGTH` で切る（値は UI のテキストノードまで行く）。gemini/copilot は payload に無いので常に null（gemini の `BeforeModel` は語彙に無く unknown-event として捨てられる）。**Issue #1846: #1759 が残した I/F 申し送り 5 件を裁定**（全裁定と理由は `docs/design/agent-event-source-interface.md` §3.3、テストは `tests/unit/hooks/sources/launch-contract-1846.test.ts`）。**採用 2 件**＝①`prepareLaunch` の引数を `AgentLaunchContext{target, executablePath, worktreePath}` に変更（`worktreePath` は**必須**。per-worktree 設定を持つ gemini が別 export `injectGeminiHookSettings()` を要らなくなり、設定書き出しが 6 ソースとも `prepareLaunch` 1 箇所に揃う。`AgentInstanceRef` は**キー**なので 3 フィールドのまま — パスを持つキーは worktree 移動で自分自身と等しくなくなる）②`AgentLaunchPlan.env: Record`（**必須**）＋ `launch-command.ts` の `renderAgentLaunchCommand`。codex/copilot/gemini/antigravity の**4 実装が独立に** `NAME=value ` を `command` へ前置していたのを剥がし、適用を 1 箇所に集約（出力バイト列は同一）。**不採用 3 件**＝③`NoDecisionBehavior` に `denies` を足す（前提が失効。agy は #1779 の実測で既に `proceeds`。`denies` はどのソースも出さないワイヤ値を記述し、エンコード修正の代わりに宣言する逃げ道になる）④`supportedEvents` の `emittable`/`delivered` 分割（**「届く語」である**と型 doc に明記。分割すると消費層がどちらを見るか選ばされ、copilot の `pre_tool_use`・gemini の `BeforeTool` でちょうど永久に待つ）⑤`definePullEventSource` への turn-gate 内蔵（状態機械は汎用だがフレーム語彙は完全に opencode 固有。§4 手順 6′ と §5 の**規約**にした）。**Issue #1924: `AgentSourceCapabilities` に宣言値 5 項目を追加**（`permissionHookPredictsDialog` / `sessionStartMayArriveLate` / `permissionReplyReleasesPrompt` / `eventIdentity:'permission-id'|'tool-call-id'|'message-id'|null` / `resync:'none'|'session-status-poll'`）。**すべて JSON 直列化可能な宣言値で関数は置かない**（`capture --json` の `structuredEvents.source.capabilities` にそのまま載るため）。値は `docs/design/multi-agent-state-architecture.md` §4 D3 の 6×5 表が正で、`tests/unit/hooks/sources/capabilities.test.ts` が**件数ではなく値**を完全一致で pin する（grep 0 件は着手前から真＝空虚な緑、DR3-006）。claude 行が「未計測セルの既定値」で、departure は copilot の `sessionStartMayArriveLate:true`（#1903 実測）と opencode の `permissionReplyReleasesPrompt:true` / `eventIdentity:'permission-id'` / `resync:'session-status-poll'`（#1898-#1900 実測）だけ。**読み手（状態機械）は Phase 3/4**（#1927 / #1901 / #1903）で、Phase 1 は型と宣言値のみ。**Issue #1899: `eventIdentity` の抽出側 `AgentEventSource.eventIdentityOf(payload)`** を I/F に追加（spec の `extractEventIdentity?`、既定は `() => null`）。capability は「**どの** id を使うか」の宣言だけで、**どこに入っているかは source しか知らない** — opencode 1 ツールの中で `permission.asked`=`properties.id` / `permission.replied`=`properties.requestID`（同じ値・別綴り）/ tool part=`part.callID` / prompt=`info.id` / `session.idle`=**無し** の 5 通りある。`event-mapper.ts` の `readEventIdentity()` が長さ(`MAX_EVENT_IDENTITY_LENGTH`=128)と文字種 allowlist で検証し、**外れた値は切り詰めずに破棄**する（DR4-001。切り詰めると prefix が同じ別 id と衝突して無関係なフレームが重複に見える）。**capability を宣言して `extractEventIdentity` を配線し忘れると「id を宣言しているのに誰も読めない」状態**になり全フレームが無言で時間窓へ落ちるので、2 つは必ず同時に変える **Issue #1996: `launch-command.ts` に `AGENT_CORRELATION_ENV_VARS`(6 個) と `AGENT_LAUNCH_CONFIG_ENV_VARS`(`CODEX_HOME` の 1 個) を追加**し、「`COMMANDMATE_HOOK_ENV_VARS` は launch line に載る変数の全部ではない」という上記の但し書きを**宣言に格上げ**した。`tests/unit/lib/agent-launch-plan-secrets-1933.test.ts` が 7 ソースの `prepareLaunch` を実際に組み、`env` のキーが 2 つの宣言の和と**両方向で完全一致**することを見る（片方向だと「ソースが新しい変数を書き始めた」と「宣言した変数を書かなくなった」の一方を見逃す）。`AGENT_LAUNCH_CONFIG_ENV_VARS` を実測の 1 個に絞ったのは、allowlist を広く取るとそのソースがそれを書き始めた変化を素通しするため（#1933 のローカル allowlist に在った `COPILOT_HOME` / `XDG_CONFIG_HOME` は `process.env` からの読み出し専用で `plan.env` には入らない）。2 定数は `sources/index.ts`（scope 外）から re-export していないので、消費側は `@/lib/hooks/sources/launch-command` から直接 import する。 **Issue #2054**: `types.ts` に `AgentEventSourceKind`（`sse` / `hooks` / `scraper`）・`AgentEventSourceLiveness`・`AgentEventSourceStatus` を追加。`define-source.ts` に `AGENT_SOURCE_STALE_AFTER_MS`（30,000 ＝ opencode の実測 10 秒ハートビート 3 拍落ち。`OPENCODE_HEARTBEAT_TIMEOUT_MS` と同値であることをテストが assert。両モジュールは相互 import 不可）・`declaredAgentSourceKind()`（pull→`sse` / push かつ `supportedEvents` 空→`scraper` / それ以外→`hooks`。`createLegacyRelaySource` が空リストを「誰も計測していない」の意味で立てているのを根拠にしており、ツール名を書かない）・`describeAgentEventSource(source, liveness, now)` を追加。**後者が `structuredEvents.source.kind` と `CliToolSessionStatus.eventSource` を導出する唯一の場所**で、push ソースには `kind` しか publish しない（claude / codex の画面を #2054 以前と同一に保つのはこの非対称性）。`turn-body.ts`＝4 リーダー共通のターン本文レイアウト（Issue #2234）。`separateTurnBody(blocks)` が prose / `aside`(Thinking) / `tool` の 3 種別を受け、prose を先頭・ツール呼び出しを末尾のラベル付き blockquote（`> **Tool calls (N)**`）に分離する。実測 400 転写 586 turn 中 141 件が本文冒頭をツールログに占領されていた。`
` はカードが `rehypeRaw` を使わないためタグごと消える（実測）ので blockquote。ツール 0 件の turn は分離前とバイト同一で、保存済み行は書き換えない **Issue #2251: `registry.ts` の登録は 7 件になった**（claude / copilot / gemini / antigravity / codex / opencode / **command-code**。未登録は `vibe-local` のみ）。`index.ts` は `COMMAND_CODE_CLI_TOOL_ID` も re-export する。 **Issue #2272: `turn-body.ts` に 3 つめの節** — ブロック種別に `reasoning`（**生テキスト**。引用は節側が付ける）を追加し、`separateTurnBody()` は本文 → `> **${TURN_REASONING_LABEL} (N)**` 節 → `> **${TURN_TOOL_LOG_LABEL} (N)**` 節の順に並べる。`reasoning` の N ブロックは**見出し 1 つの下**に `>` 空行区切りで入り、`SeparatedTurnBody` に `reasoningLog` / `reasoningBlocks` が増える。既存の `aside`（リーダー側が自分で引用済みのテキスト）は**従来どおり本文の流れに残す**ので、`aside` を使う 4 リーダー（claude / codex / antigravity / command-code）の出力は 1 バイトも動かない。`TURN_REASONING_LABEL = 'Thinking'` はリーダー側の `*_THINKING_LABEL` と同値であることが前提（行は `chat_messages.content` に焼かれるので後から翻訳できない） **Issue #2403: `launch-command.ts` が起動行に起動サーバ自身の `CM_PORT` を pin する。** `renderAgentLaunchCommand()` は `plan.env` をそのまま描画するのをやめ、`resolveAgentLaunchEnv(plan)`（新 export。`plan.env` ＋ `SERVER_PORT_ENV_VAR`(=`'CM_PORT'`)）を描画する。値は **hook URL と同じ `getServerPort()`**（`src/lib/env.ts`）で、**無条件**・**末尾に append**・**プランが自分で `CM_PORT` を宣言していれば上書きしない**。7 ソースの `prepareLaunch` ではなくレンダラに置いたのは、「どのサーバが動いているか」が 7 ソース共通の事実で 7 箇所に写すと必ず 1 つ忘れるため、かつ **claude（相関キーは `--settings` ファイルの中）と opencode（ポートは argv）は `env: {}` を返す** — つまり不具合が実測された当の 2 ソースが、ソース側実装だと新たに env を生やす必要があるため。**直った現象**: 同一マシンの 2 サーバが同じ tmux サーバを共有すると `tmux show-environment -g` に先に起動したサーバの `CM_PORT` が載り、pane の `-zsh` がそれを継ぐ。`src/cli/utils/server-url.ts` の `loadClientEnv()` は `process.env` > `~/.commandmate/.env`（#1743 の仕様）なので、tmux 由来の `CM_PORT=3000` が `.env` の 60301 に勝ち、**hooks は 60301／CLI は 3000 で割れる**（`whoami` だけ tmux セッション名から導出するので正答し、`ask` は 3000 の DB から読んで exit 0 を返すため呼び出し側が気づけない）。`AGENT_LAUNCH_CONFIG_ENV_VARS` は `CODEX_HOME` ＋ `CM_PORT` の **2 個**になり、#1933 のドリフトガードの件数 pin は `7` → `8`（相関 6 ＋ 設定 2）。同ガードの測定対象も `plan.env` から `resolveAgentLaunchEnv(plan)` に移した（`plan.env` を読むと #2403 以降は「起動行」を読んでいないため）。**起動行のバイト固定 6 ファイル**（`tests/unit/hooks/sources/{launch-contract-1846,opencode,opencode-config-scope-2053,command-code-source,copilot-hook-settings}.test.ts` と `tests/unit/hooks/codex-hooks-config-1760.test.ts`）は `CM_PORT` を固定値に stub して期待値を更新した。**「env が空なら素のコマンド」という #1846 の不変条件は失効**し、代わりに「1 個だけ付く」を完全一致で pin する（余計な区切りはそこで出る）。 **Issue #2614**: 宣言 `stopReportsSelfResume`（`agent-event-types.ts` の宣言マージ。語 `SELF_RESUME_PENDING_DETAIL = 'self_resume_pending'` と同居）を追加し、antigravity だけ `true`（他 6 ソースと legacy-relay は `false`。claude は `Stop` の `background_tasks` が候補だが空配列しか採取していないため未対応）。agy の `Stop` hook は `buildAntigravityStopHookCommand()` になり、payload の `"fullyIdle":false`（agy 自身の契約で「バックグラウンドタスクがすべて終わったら true」）を空白除去後に `case` で検出して relay に `--detail self_resume_pending` を渡す（それ以外は従来と同じ relay 呼び出し。stdout には何も出さない）。source の `extractAntigravityEventDetail()` も生 payload の `fullyIdle === false` を同じ語に読む。 **Issue #3330**: `AgentEventSource.promptJoinsOpenTurn?(payload)`（任意。`PushHookSourceSpec.promptJoinsOpenTurn` から配線、未宣言は false）。claude だけが宣言（`claude/queued-notice.ts`）。 **Issue #3360**: claude の `prepareLaunch` は `CM_UAT_ISOLATION=1` で `--setting-sources project,local` を末尾に足す（settingsPath の判定は足す前のコマンドで行う）。 claude の `prepareLaunch` は own-home（#3312）で hook 設定の dir とファイル（`CM_AGENT_HOOKS_DIR`）を確認し、外なら・書けなければ起動を拒否。 **Issue #3430**: claude も `stopReportsSelfResume: true`。`extractClaudeEventDetail`（`claude/source.ts`）が `stop` のとき `claude/self-resume` で transcript を読み、未通知のバックグラウンド作業があれば `SELF_RESUME_PENDING_DETAIL` を返す（他の event は従来の `extractSnakeCaseEventDetail`）。 | | `src/lib/hooks/sources/copilot/` | **copilot の `AgentEventSource`**（Issue #1761 / Phase 4-3）。`source.ts`＝綴りは Claude と同一（`hook-event-vocabulary` の共有表を再利用）・`parseCopilotPermissionRequest` は **`hook_event_name:"PreToolUse"`** を読む（copilot に `PermissionRequest` は無い）・`encodeCopilotVerdict` は **`hookSpecificOutput.permissionDecision`**（Claude の `decision.behavior` ではない。deny も表現できる＝Claude より広い）。`hook-settings.ts`＝設定生成と起動コマンド。**書き先は `~/.copilot/settings.json`**（`COPILOT_HOME` 尊重）で、doc の言う `config.json` に書くと**次回起動で消える**（#1757 P2）。**置換ではなくマージ** — マーカー `cmate-copilot-agent-hooks` を含む自分のエントリだけ差し替え、他キー・他ハンドラ（grouped/flat 両形）は保持。パース不能な設定には触らず素の起動コマンド（`cli-tools/copilot.ts` が解決した実行体）で起動する。**`configScope:'global-singleton'`＝マシン 1 本なので相関キーを URL に焼けない** → `AgentLaunchPlan.env` の `CM_AGENT_WORKTREE_ID` / `CM_AGENT_INSTANCE_ID` に載せ（#1846。それ以前は `command` への直接前置）、hook が fire 時に読む（hook がコマンドをシェル経由で実行し親 env を継承することを実測）。**全コマンドが `CM_AGENT_WORKTREE_ID` 未設定で無音終了する** — グローバル設定なので CommandMate 以外が起動した copilot でも発火し、cwd 解決で無関係な `wait` を返してしまうため。`PreToolUse` だけ permission receiver 宛（承認ゲートそのもの。stdout が裁定になる。往復実測 ≈110ms / 予算 ≈10s）で**イベントストアには入らない**ので `supportedEvents` から外してある。`notification` も**発火実績ゼロ**のため約束しない。`decisionTimeoutSeconds:10`（Claude は 600）。実測は `docs/design/copilot-agent-hooks-injection.md` **Issue #3391**: `CM_UAT_ISOLATION=1` では `writeCopilotHookSettings` が `~/.copilot/settings.json`・`.cmate-backup`・`.cmate.lock` を書かない。`inspectCopilotHookSettingsReadOnly` が「空のファイルに書く内容とバイト一致」のときだけ読むだけで使い、無い・違う・独自の hook/キー・`config.json` の `hooks`（または読めない）・`CM_AGENT_HOOKS_INJECT=0` は `UatIsolationLaunchRefusedError` で起動を拒否（`buildCopilotLaunchCommand` の bare への道もすべて拒否）。 own-home（#3312）では settings.json・バックアップ・ロック dir を確認後に書く。`config.json` の `hooks` は隔離中は素の起動ではなく拒否。 | | `src/lib/hooks/sources/gemini/` | **gemini の `AgentEventSource`**（Issue #1762 / Epic #1720 Phase 4-4）。`tool-id.ts`／`event-vocabulary.ts`=gemini 独自の綴り表（`BeforeAgent`→`user_prompt_submit`／`AfterAgent`→`stop`／`BeforeTool`・`AfterTool`。**共有 CamelCase 表には足さない**＝`docs/design/agent-event-source-interface.md` §5）＋ `notification_type:"ToolPermission"` → **`permission_prompt` へ翻訳**（消費層は Claude の subtype 文字列を直接比較するため、翻訳しないと gemini は永久に `waiting` にならない）／`settings-generator.ts`=`/.gemini/settings.json` への**マージ書き込み**（ユーザーの既存 hooks・全キーを保持。再書き込みは冪等で、自分の項目の識別は relay 名＋`--tool gemini`＋`--worktree-id ` の 3 点一致）＋`buildGeminiLaunchCommand`／`shared-config-tree.ts`=`~/.gemini` 共有ツリー用の非破壊 JSON read/write（**antigravity 側も import する**）／`source.ts`=本体。**注入は `SessionStart`/`BeforeAgent`/`AfterAgent`/`Notification`/`SessionEnd` の 5 件のみ**（`BeforeTool`/`AfterTool` は写像だけ持ち登録しない — hooks は同期実行でツール呼び出しごとに 2 往復ブロックする一方、`running` は `BeforeAgent` で既に立っている）。**`noDecision:'proceeds'` は実装読み**（v0.55.1 バンドルの `DefaultHookOutput.isBlockingDecision()` は `decision==='block'|'deny'`、`shouldStopExecution()` は `continue===false` ＝空応答は何も止められない。#1757 §5.3.6 は項目 6/7 未計測）。**`encodeVerdict` は常に `{}`** — gemini の hook は**承認できない**（scheduler は hook →`checkPolicy` の順で、`hookDecision==='ask'` のときだけ `ASK_USER` へ**エスカレーション**する分岐しかない）ので承認は Policy Engine（`--approval-mode`/`--policy`/`-y`）専任。**Issue #1846 で `injectGeminiHookSettings()` は廃止** — `prepareLaunch` が `AgentLaunchContext.worktreePath` を受け取るようになったので、設定書き出しは `prepareGeminiLaunch()` の中で行い `settingsPath` に**実際に書いたファイル**を返す（`cli-tools/gemini.ts` の 2 回呼びも解消）。`CM_HOOK_URL` は `command` への前置ではなく `AgentLaunchPlan.env` で宣言する | `src/lib/hooks/sources/antigravity/` | **antigravity(`agy`) の `AgentEventSource`**（Issue #1762）。`tool-id.ts`（**id は `antigravity`／バイナリは `agy`**）／`hooks-config.ts`=`~/.gemini/config/hooks.json`（**マシンに 1 本しか無い**。doc の `/.agents/hooks.json` は読まれない＝#1757 §5.4.2）へ `commandmate` という**名前つき hook 1 キーだけを占有**するマージ書き込み（ユーザーの他 hook は温存。agy 自身が名前つき hook を merge して順次実行する）／`source.ts`=本体。**観測 3 件（`SessionStart`/`PostToolUse`(matcher `*`)/`Stop`）は中継スクリプト宛、`PreToolUse` だけが専用の裁定コマンド宛**（Issue #1779。codex の `PermissionRequest` / copilot の `PreToolUse` と同じ形。中継は `curl … >/dev/null` で応答ボディを捨てるので裁定に使えない）。`mappers` は**空**（payload にイベント名が無く、フィールド有無からの推定は Pre/Post を取り違える）＝語は中継の `--event` から来る。`conversationIdFields:['conversationId']`（1 ツールだけ camelCase protojson）。`parsePermissionRequest` は `toolCall.name`/`toolCall.args` を読む（#1779。それまで `()=>null` で、hook を張った瞬間「Auto-Yes が黙って効かない」に化ける）。`encodeVerdict`: allowOnce→`{decision:'allow'}` ／ deny→`{decision:'deny',reason}` ／ **abstain とそれ以外→`{decision:'ask'}`**。**空オブジェクトは絶対に出さない**（`{}`＝拒否＝#1757 P10。1.1.12 で再実測: `⚠ Tool call denied by pre-tool hook:`）。`noDecision:{kind:'proceeds'}`（#1779 で `blocks` から変更。**`ask` と対で読むこと** — 「abstain が安全」なのは abstain を `ask` と綴っているからで、`{}` に戻すと宣言だけが嘘になる）。裁定コマンドは POSIX sh 一行で、**サーバ不達／タイムアウト（`curl -m 4` < handler `timeout` 5）／非 2xx（`curl -f`）／JSON でない or `decision` の無いボディ／`CM_PERMISSION_HOOK_URL` 未設定 の 5 経路すべてで `{"decision":"ask"}` を stdout に出す**（machine-global な設定ファイルなので `allow` フォールバックは「CommandMate を止めるとマシン上の全 agy が全ツールを無承認実行する」を意味する）。**相関は `CM_HOOK_URL` と `CM_PERMISSION_HOOK_URL` の 2 環境変数のみ**（#1846 以降は `AgentLaunchPlan.env` で宣言。`--model` は展開後の行に追記されるので env 代入は前に残る）（設定ファイルが machine-global なので worktree/instance を焼き込めない。payload に cwd も workspacePaths も無い）。後者の未設定が、CommandMate が起動していない agy セッションで hook を無害化する唯一の門番。`supportedEvents` に **`pre_tool_use` は入れない**（copilot と同じ理由 — permission receiver 宛なのでイベントストアに入らない）。**実測（1.1.12・隔離 HOME・対話 TUI）: `{"decision":"allow"}` は承認ダイアログを抑止しない**（`permissionOverrides:["command(*)"]` を添えても同じ）。`--print` では効く（#1757 §5.4.4）。したがって対話セッションの Auto-Yes は従来どおり TUI 応答経路（#988）が担う。**stdout が空（exit 0・無出力）は `{}` とは別物で fail-open**（#1762 の前提の訂正） Issue #2198 で転写リーダーを追加（go/no-go 実測の結論は **go**）。`transcript.ts` は `transcript_full.jsonl`（1 行 1 step の平文 JSONL）を turn に切って Markdown へ戻す純関数群（`parseAntigravityTranscript` / `buildAntigravityTurns` / `renderAntigravityTurn` / `extractAntigravityUserRequest`）。turn を開くのは `USER_EXPLICIT` / `USER_INPUT` で、**turn を閉じるレコードは存在しない**（codex の `task_complete` に相当が無いので claude と同じく最新 turn を書く）。本文に入れるのは `MODEL` / `PLANNER_RESPONSE` の `content` だけで、他の `MODEL` type と `SYSTEM` 5 種は**沈黙リストとして明示**し未知 type は数えて露出する。`history.ts` は hook payload の `conversationId` を latch し `~/.gemini/antigravity-cli/brain//.system_generated/logs/transcript_full.jsonl` を読む（`transcriptPath` がその絶対パス。走査も cwd スラッグも要らない）。同じ会話は `conversations/.db` にも SQLite + 非公開 protobuf で二重に書かれているが、**開くだけで `-wal` が生える**ので採らない。`source.ts` は `transcriptHistory: 'pull'` を宣言。実測は `docs/design/antigravity-transcript-reader.md`。Issue #2234: `renderAntigravityTurn` も `../turn-body` 経由。`PLANNER_RESPONSE` の `tool_calls` は末尾のセクションへ Issue #2246: `history.ts` の `captureAntigravityTranscriptTurn` が claude と同型の backfill になった（`selectUnwrittenAntigravityTurns()`、キーは conversationId と stepIndex の対）。`resolveAntigravityTranscriptPath()` を追加 **Issue #2264**: claude と同型の閉じ判定を追加。agy には turn を閉じるレコードが無い（codex の `task_complete` 相当が無い）ので `isAntigravityTurnClosingRecord()` は『最後の `MODEL` レコードが `PLANNER_RESPONSE` で、非空 `content` を持ち、`tool_calls` を持たない』こととする — agy は prose と直後の呼び出しを同じレコードに書く（コーパス 439 件中 39 件）ため『何か言った』だけでは終了の証拠にならない。`superseded` は claude と同じ。`writeAntigravityTurn` は書けないターンで `antigravity-transcript-turn-open` を出して false を返す。Issue #2438 で antigravity 側にも入った（下記） Issue #2437: `history.ts` の `captureAntigravityTranscriptTurn` が成功時に `advanceCapturedLineForTranscriptTurn(target)` を呼ぶ（`../claude/history` と同型。失敗時は呼ばない） Issue #2438: `history.ts` に `growAntigravityTurnRow()` / `refreshAntigravityTurnRows()` を追加（`../claude/history` の #2264 と同型）。agy は turn を閉じるレコードを持たないので `isAntigravityTurnClosingRecord` は「散文＋`tool_calls` 無し」を終了と読むしかなく、**中間報告がその形をしている**ため、agy が「返答待機中」と言った時点の本文で行が保存され、同じターンに結論が追記されても凍ったままだった（実測 16,959 → 21,581 文字）。`captureAntigravityTranscriptTurn` は `selectUnwrittenAntigravityTurns` の直後、**pending 0 の早期 return より前**に `built.turns.slice(0, built.turns.length - pending.turns.length).slice(-ANTIGRAVITY_TURN_RECHECK_LIMIT)`（3 件）を描き直し、`isAntigravityTurnWritable` が true で既存行がある候補についてだけ、`renderAntigravityTurn().body` が既存 `content` より**厳密に長い**ときに `updateMessageContent` で置換して `message_updated` を配信する（同長の別本文・短い描画・行の無い候補は触らず、新規 assistant 行も作らない。`id` / `request_id` / `timestamp` は不変）。`writeAntigravityTurn` の既存行検出分岐も同じ `growAntigravityTurnRow()` を通す。**戻り値と #2436 の `report.outcome` は不変**（更新は「このターンを今 History が持ったか」ではないので outcome に書かない）。回復は次の転写 capture の時点で起き、窓外・上限外・配送済みの内容は直らない。設計は `docs/design/antigravity-transcript-reader.md` §5 Issue #2443 で **「保存できた」と「終わった」を分離**。`transcript.ts` に純関数 `resolveAntigravityTurnCompletion(turn, stopAt)` を追加し、`isAntigravityTurnWritable`（＝行を書いてよいか）とは別に「この本文で agy が終わったと言えるか」を答える。確定条件は `writable` かつ turn 内に `created_at` を持つレコードがあり、かつ `getLastStopEventAt` の `Stop` が `max(最新レコード, turn 開始)` **以降**であること。`reason` は `stop-after-last-record` / `turn-open` / `no-timestamped-record` / `no-stop-event` / `stop-before-last-record`。**文言・固定 N 秒・`status: DONE`・`truncated_fields` はいずれも判定に使わない**（起票時の実測で早期候補と最終候補が分離できないため）。`Stop` に `continue` を返してループが再開した場合は再開後のレコードが `Stop` より新しくなり**確定が自動的に取り消される**ので、`continue` の検出は持たない。`history.ts` 側は暫定で書いた行を instance ごとに `step_index` で追跡し（`ANTIGRAVITY_UNSETTLED_TURN_LIMIT = 16`、`globalThis` 上、会話 id 不一致で破棄、窓外・行消失・確定で解除）、`ANTIGRAVITY_TURN_RECHECK_LIMIT = 3` の窓を**下限**として候補に足す（1 poll あたり最大 19 件・索引 1 回ずつ）。`report.completion` に `'settled' \| 'provisional'`、確定時のみ `completionKey = @<最新レコードの epoch ms>` と `completionReason` を載せる。**戻り値 boolean の意味と #2436 の `outcome`、#2437 のカーソル前進、#2438 の「厳密に長いときだけ置換」は変えていない**。設計は `docs/design/antigravity-turn-completion-2443.md` **Issue #3360**: `CM_UAT_ISOLATION=1` の `writeAntigravityHooksConfig()` は書かない。同じ内容が既にあればそのパス、違えば null（hook なし）。 own-home（#3312）では `~/.gemini/config/hooks.json` を確認後に書き、準備の失敗（null）は own-home でも起動の拒否。 @@ -284,6 +284,7 @@ const myState = getOrInitGlobal('__myState', () => new Map()); | `src/lib/hooks/sources/transcript-history.ts` | claude / codex / antigravity / command-code の `history.ts` が共有する転写の書き込み部品（`resolveAssistantTimestampMs` / `nextTurnOpensAt` / `selectUnwrittenTurns` / `resolveSessionIdFromEvents` / `acceptPathUnderRoot` / `growTurnRowTo` / `refreshTurnRowsTo` / `isReadableFile`）。4 つのファイルに同じ形で書かれていたものを移した（Issue #3221） | | `src/lib/hooks/sources/claude/model-switch.ts` | claude の `PostModelSwitch` hook を CommandMate の語彙に写す（Issue #2363）。`claudeModelSwitchMapper`（`PostModelSwitch` → `notification`、subtype は `modelSwitchDetail(to_model)` = `model_switch:`、`to_model` 無しなら素の `model_switch`）と `extractClaudeSwitchedModel`（`hook_event_name === 'PostModelSwitch'` のときだけ **`to_model`** を返し、それ以外は null → `modelFields: ['model']` の平坦読みへ落ちる）。`claude/source.ts` は `mappers: [...fromNameTable(CAMEL_CASE_HOOK_EVENT_NAMES), claudeModelSwitchMapper]` と `extractModel: extractClaudeSwitchedModel` で配線（`modelFields` は据え置き）。**`from_model` は絶対に読まない**（切替前の値。読むと latch が逆走する）。`requested_model` も読まない（`/model default` と `/fast` で `null`）。7 語に無い事象を `notification` に載せるのは、`agent-event-state` が未知の subtype の `notification` を「何の証拠にもならない」と扱い（turn / dialog / awaiting_instruction を動かさず `status-mapping` も null）、それでいて model latch は全イベント共通で走るから。subtype に `to_model` を含めるのは receiver の dedup キーが `(instance, event, detail, session_id)` × 3 秒のため — 固定語だと picker `s` 直後の `/fast` のような別モデルへの連続切替の 2 発目が落ちる（同じ切替の二重配送＝ユーザー自身の hook との連結は同じ `to_model` なので従来どおり畳まれる）。実測 payload（2.1.263）: `session_id` / `transcript_path` / `cwd` / `prompt_id` / `hook_event_name` / `from_model` / `to_model` / `requested_model` / `source`（`command` = `/model ` と `/fast`、`picker` = 対話リスト。schema 上は `sdk` / `auto` / `resume` も）/ `context_tokens` / `prompt_cache_warm` / `cache_ttl` / `estimated_cache_write_usd` / `pricing`。`model` キーは無い。`to_model` は `SessionStart.model` と同じ id 形で、`/fast` ON は Haiku から `claude-opus-5[1m]`（#2361 の綴りゆれ問題が消える）。発火しない操作: 同じモデルの再指定、picker の Esc、`/fast` ON が既に Opus 1M、`/fast` OFF（モデルは Opus のまま）、`/effort`、`/clear`。fixture は `tests/fixtures/hooks/claude-model-switch-2363/`（実 payload 7 枚 + README。`hooks/claude/` は全 fixture 登録済みの走査ガードがあるので、登録しない `PreModelSwitch` を含む本 Issue 分は別ディレクトリ） | | `src/lib/hooks/sources/claude/queued-notice.ts` | UserPromptSubmit がキューの通知（`prompt` が `` で始まる）かを判定する `isClaudeQueuedNoticePrompt`、`CLAUDE_TASK_NOTIFICATION_PREFIX`、`QUEUED_NOTICE_FIELD`（`queuedNotice`）（Issue #3330）。claude source の `promptJoinsOpenTurn` | +| `src/lib/hooks/sources/claude/self-resume.ts` | claude の `Stop` がバックグラウンドの作業を残しているか（Issue #3430、#2614 の claude 版）。`pendingClaudeBackgroundTasks(text)`（純関数。transcript JSONL から `toolUseResult.backgroundTaskId`／`taskId`+`persistent:false`（Monitor）／`agentId`+`isAsync:true` で開始を、`` の ``（user プロンプト・`queued_command` attachment。enqueue のみは未配達で数えない）と `TaskStop` の `task_id` で終了を数え、未通知の id を返す。`isSidechain:true` と壊れた行は無視）。`claudeStopLeavesBackgroundWork(payload, {homeDir?, tailBytes?})`（`transcript_path` を `~/.claude/projects` 配下・`.jsonl` に限って受け、末尾 `CLAUDE_SELF_RESUME_TAIL_BYTES`=4MiB を同期で読む。読めない・範囲外・パス無しは false）。fixture は `tests/fixtures/claude-self-resume-3430/` | | `src/lib/hooks/sources/opencode/history.ts` | opencode 転写の writer（Issue #2041）。`recordOpencodeTranscriptFrame()` が `message.updated`(assistant) で turn を開き `message.part.updated` でスロットを埋める（`message.part.delta` は読まない＝再送がスロット上書きになり冪等）、`flushOpencodeTurn()` が `session.idle` で `chat_messages` へ書き、`backfillOpencodeHistory()` が再接続後に取り直す。行 id は `opencodeTurnRequestId(parentID)`。throw しない／DB import は動的。**Issue #2199**: `message.part.updated` を積んだ直後に `publishOpencodeTurnProgress()` を fire-and-forget で呼び、**同じ accumulator を同じ `renderOpencodeTurn` に通した**本文を `emitChatTurnProgress()` で push する（別の軽い描画経路を作ると確定行と食い違い、turn 終了の瞬間に本文が書き換わって見える）。境界フレームの再送はスロット上書き→本文同一→共有ビルダーの無変化規則で落ちるので dedup セットは持たない Issue #2273: `flushOpencodeTurn(target, sessionId, closedAt = Date.now())` が`turn.startedAt` ではなく `max(turn.startedAt, closedAt)` で書く（`session.idle` はopencode 自身のターン終了フレームなので、それを処理している瞬間がターンの終わり。`closedAt` は時計を動かさずにテストするための引数）。`backfillOpencodeHistory` は`lastOpencodeCompletedAt(body)` が REST 文書の `info.time.completed`（無ければ`created`）を turn key = `parentID` ごとに `Math.max` で畳んだ値を使う — ツールを呼んだターンは assistant メッセージが 2 通あり（実測）、終わったのは後の方 | | `src/lib/hooks/sources/opencode/log-diagnosis.ts` | OpenCode 1.x 起動失敗の原因読み取り（Issue #2939 D2）。`findOpencodeSharedDataConflict(since, logPath?)` が `/opencode/log/opencode.log` の末尾 256 KiB から `timestamp=` が起動時刻（−1 秒）以降の行の `no such column` を返す。`buildOpencodeSharedDataConflictMessage()` | | `src/lib/hooks/sources/opencode-v2/` | OpenCode V2 の pull 型ソース（Issue #2934）。`source.ts`（`prepareOpencodeV2Launch`：ポートとパスワードファイルがあれば launch.sh、無ければ `--standalone`）、`subscription.ts`（`GET /api/event` を Basic 認証で購読、1 インスタンス = 1 サーバで振り分け）、`mappers.ts`（`session.execution.*` / `permission.*` / `form.*` の対応表）、`ingest.ts`、`ports.ts`（4300–4399、`~/.commandmate/opencode-v2/ports.json`）、`secrets.ts`（`<複合キー>.pw` 0600）、`runtime.ts`、`reattach.ts`（起動時の再購読と残骸掃除。`server.ts` の起動処理から v1 の reattach の隣で呼ぶ）、`client.ts`。 **#2939/#2952** `source.ts`: 解決した実行ファイルの絶対パスを launch.sh に `--executable` で渡す（名前が `opencode` の V2 もラッパーで起動）。`--standalone` はポート・パスワードファイル・ラッパーのどれかが無いときだけ（`opencode2-not-installed` は廃止） Issue #2940**: `history.ts`（`session.execution.succeeded`/`failed`/`interrupted` を受けて `GET /api/session/{id}/message` を読み、`user`→`assistant`（ステップごと）→`idle` でターンを組み直し、閉じたターンを `oc-turn:` で 1 行保存。本文は v1 の `renderOpencodeTurn`。instance ごとに直列化、失敗は 0 を返すだけ）。`subscription.ts` に `isOpencodeV2StructuredHistoryLive` / `recordOpencodeV2TurnEnd`、`client.ts` に `fetchOpencodeV2SessionMessagesPage`、`source.ts` の `transcriptHistory` を `'push'` に Issue #2945 で承認・質問に答えられるようにした。`payloads.ts`（`parseOpencodeV2PermissionRequest` / `toOpencodeV2PendingPermission` / `describeOpencodeV2Permission`（アクション＋対象＋ヘッダを除いた patch）/ `parseOpencodeV2Form`（`form.created` の `data.form` または `GET …/form` の Form.Info を AskUserQuestionSpec に。選択肢のある string・multiselect・boolean のみ）/ `buildOpencodeV2FormAnswer`（ラベル→`value`、`custom` のみ自由入力））、`client.ts` に `fetchOpencodeV2PendingPermissions` / `fetchOpencodeV2PendingForms` / `fetchOpencodeV2SessionForms` / `replyOpencodeV2Permission` / `replyOpencodeV2Form`、`source.ts` は `eventIdentity: 'permission-id'`・`listPending`（サーバーの一覧）・`decide`（`…/permission/{id}/reply` / `…/form/{id}/reply`）・`toOpencodeV2PermissionReply`、`ingest.ts` は承認を先に `adjudicatePendingPermission`（Auto-Yes）→ 差分つきで記録、質問は選択肢を `recordAskUserQuestion` し Web Push、`decision-labels.ts`（`OPENCODE_V2_DECISION_LABELS`：`Always allow`）。 `commands.ts`（Issue #2944: `GET /api/command` / `GET /api/skill` を Basic 認証で読み、v1 の `OpencodeLiveCommand` 形へ。Skill は `id` 名、`content` は捨てる。コマンド 0 件は `complete: false`＝未読込）。`secrets.ts` に `readOpencodeV2PasswordByKey()`（複合キーからパスワード） Issue #2951: `resync: 'pending-list'`（`SourceResync` に追加）。`subscription.ts` の `resyncOpencodeV2Pending()` が接続（再接続）ごとに `GET /api/permission/request`・`GET /api/form` を `permission.asked` / `form.created` として再生（上限 `OPENCODE_V2_MAX_RESYNCED_DECISIONS`=50）。Auto-Yes 有効化時は `recheckPendingDecisions` が同じ一覧を再判定。`payloads.ts` の `parseOpencodeV2Form` が `custom: true` を `AskUserQuestionEntry.custom` に載せる **Issue #2964**: `history.ts` の `readLatestOpencodeV2AssistantModel` が `/message` の直近 assistant の `model.id`（providerID なしの素の名前）を読み、ターン終了ごとの同期で `recordAgentReportedModel` に載せる。 **Issue #2981**: `usage.ts`＝`session.usage.updated` / ターン終了で `GET /api/session/{id}`・`/message`・`/api/model` を引き、`recordAgentSessionTelemetry`（セッション累計）と `recordAgentSessionContextUsage`（最新 assistant メッセージ＝コンテキスト、`limit.context` で %）に書く。インスタンスごとに 1 本＋1 本待ちへ合流。`subscription.ts` の close / 自然終了で `forgetAgentSessionTelemetry`。 | diff --git a/src/lib/hooks/agent-event-types.ts b/src/lib/hooks/agent-event-types.ts index 797fe32c2..40a9f4595 100644 --- a/src/lib/hooks/agent-event-types.ts +++ b/src/lib/hooks/agent-event-types.ts @@ -150,11 +150,12 @@ declare module './sources/types' { * that declares `true` is promising to write exactly that detail, and * `commandmate wait` holds a completion on it only when this says so. * `false` means "this tool's stop carries nothing CommandMate reads as - * such", not "this tool never resumes itself" — Claude Code does, and its - * `Stop` payload's `background_tasks` is the unmeasured candidate. + * such", not "this tool never resumes itself". * - * `true` for antigravity alone, whose `Stop` payload carries `fullyIdle` - * ("true if all background tasks are done", agy's own hook contract). + * `true` for antigravity, whose `Stop` payload carries `fullyIdle` + * ("true if all background tasks are done", agy's own hook contract), and + * for claude since Issue #3430, whose transcript shows the background tasks + * not yet notified (`./sources/claude/self-resume`). * Pinned by value for every source in * `tests/unit/hooks/sources/capabilities.test.ts`. */ diff --git a/src/lib/hooks/sources/claude/self-resume.ts b/src/lib/hooks/sources/claude/self-resume.ts new file mode 100644 index 000000000..9c3706ead --- /dev/null +++ b/src/lib/hooks/sources/claude/self-resume.ts @@ -0,0 +1,207 @@ +/** + * Whether a Claude Code `Stop` leaves background work behind that will wake the + * agent again (Issue #3430) — the Claude half of #2614. + * + * Claude Code ends a turn with work still running in two measured ways: a + * `Bash` call that outlived its timeout (or was started with + * `run_in_background`) and a `Monitor`. When that work finishes Claude queues a + * `` and, if the session is idle, opens a new turn on it by + * itself. Measured on 2026-10-08 (worktree commandmate-issue-3423): a worker + * ended its turn at 23:37:53 "waiting for the related-tests run to finish", + * `wait --verify` read that `Stop` as the end and verified an uncommitted + * worktree, and the notification opened the turn that committed at 23:38:32. + * + * ## What is read, and why not the `Stop` payload + * + * The payload carries `background_tasks`, but only its empty form has ever been + * captured (`tests/fixtures/hooks/claude/stop.json`), so its shape is a guess. + * The transcript names the same work in structured fields, measured on the + * transcripts under `~/.claude/projects` written in the four days to 2026-10-08: + * + * - a background `Bash`: `toolUseResult.backgroundTaskId` (1,008 results); + * - a `Monitor`: `toolUseResult.taskId` beside a boolean `persistent` + * (115 results); + * - a background subagent: `toolUseResult.isAsync: true` and `agentId` + * (30 results); + * - a `TaskStop`: `toolUseResult.task_id` (39 results). A stopped task is never + * notified, so this is what retires it. + * + * and each finished task is retired by the notification Claude delivers for it: + * a `type: "user"` prompt or a `queued_command` attachment whose text begins + * with `` and carries `…` — the id above. + * A notice that is only enqueued is not yet delivered, and the session will open + * a turn on it, so its task still counts as pending. + * + * ## Erring towards "finished" + * + * Every doubt answers "nothing pending", which is what every Claude `Stop` meant + * before this Issue: no transcript path, a path outside `~/.claude/projects`, a + * file that cannot be read, a line that does not parse. A persistent `Monitor` + * (a watch for the whole session, never notified on its own) is not counted + * either. A task that really is never notified — a process that died with its + * session — is bounded by `commandmate wait`'s `SELF_RESUME_HOLD_MS`. + * + * @module lib/hooks/sources/claude/self-resume + */ + +import { closeSync, fstatSync, openSync, readSync } from 'fs'; +import { homedir } from 'os'; +import { join } from 'path'; +import { acceptPathUnderRoot } from '../transcript-history'; +import { CLAUDE_TASK_NOTIFICATION_PREFIX } from './queued-notice'; +import { CLAUDE_PROJECTS_DIR_SEGMENTS } from './transcript'; + +/** The `Stop` payload field naming the session's transcript. */ +export const CLAUDE_TRANSCRIPT_PATH_FIELD = 'transcript_path'; + +/** + * How much of the transcript's tail is read on a `Stop`. + * + * A task is started before it is notified, so a window that holds the start + * holds the notification too; a start older than the window is simply not seen + * (the "finished" direction). 4 MiB is `CLAUDE_TRANSCRIPT_TAIL_BYTES`, the first + * read of `./history`, which holds 99% of turns whole (#2470). + */ +export const CLAUDE_SELF_RESUME_TAIL_BYTES = 4 * 1024 * 1024; + +const TASK_ID_PATTERN = /([^<]+)<\/task-id>/; + +function isRecord(value: unknown): value is Record { + return typeof value === 'object' && value !== null && !Array.isArray(value); +} + +function nonEmptyString(value: unknown): string | null { + return typeof value === 'string' && value.length > 0 ? value : null; +} + +/** The background task a tool result started, or null. */ +function startedTaskId(result: Record): string | null { + const bash = nonEmptyString(result.backgroundTaskId); + if (bash) return bash; + // Monitor. `persistent: true` watches for the life of the session and is not + // work the turn is waiting on. + const monitor = nonEmptyString(result.taskId); + if (monitor && result.persistent === false) return monitor; + const agent = nonEmptyString(result.agentId); + if (agent && result.isAsync === true) return agent; + return null; +} + +/** The task a `` text retires, or null. */ +function notifiedTaskId(text: unknown): string | null { + if (typeof text !== 'string') return null; + if (!text.trimStart().startsWith(CLAUDE_TASK_NOTIFICATION_PREFIX)) return null; + return TASK_ID_PATTERN.exec(text)?.[1] ?? null; +} + +/** Every text a delivered `type: "user"` record carries. */ +function userTexts(record: Record): unknown[] { + const message = record.message; + if (!isRecord(message)) return []; + const content = message.content; + if (typeof content === 'string') return [content]; + if (!Array.isArray(content)) return []; + return content.filter(isRecord).filter((b) => b.type === 'text').map((b) => b.text); +} + +/** + * The ids of background tasks started in `text` (transcript JSONL) and not yet + * delivered a notification or stopped, in the order they were started. + * + * Pure. Lines that do not parse are skipped, as is everything a subagent wrote + * into the parent's file (`isSidechain: true`). + */ +export function pendingClaudeBackgroundTasks(text: string): string[] { + const started: string[] = []; + const retired = new Set(); + for (const line of text.split('\n')) { + if (line.trim() === '') continue; + let record: unknown; + try { + record = JSON.parse(line); + } catch { + continue; + } + if (!isRecord(record) || record.isSidechain === true) continue; + + if (record.type === 'user') { + const result = record.toolUseResult; + if (isRecord(result)) { + const id = startedTaskId(result); + if (id) started.push(id); + const stopped = nonEmptyString(result.task_id); + if (stopped) retired.add(stopped); + } + for (const t of userTexts(record)) { + const id = notifiedTaskId(t); + if (id) retired.add(id); + } + } else if (record.type === 'attachment' && isRecord(record.attachment)) { + if (record.attachment.type !== 'queued_command') continue; + const id = notifiedTaskId(record.attachment.prompt); + if (id) retired.add(id); + } + } + return [...new Set(started)].filter((id) => !retired.has(id)); +} + +/** + * The last `maxBytes` of a file, starting at a line boundary; null when it + * cannot be read. + */ +function readTail(path: string, maxBytes: number): string | null { + let fd: number | null = null; + try { + fd = openSync(path, 'r'); + const size = fstatSync(fd).size; + const start = Math.max(0, size - maxBytes); + const buffer = Buffer.alloc(size - start); + let read = 0; + while (read < buffer.length) { + const n = readSync(fd, buffer, read, buffer.length - read, start + read); + if (n === 0) break; + read += n; + } + const text = buffer.subarray(0, read).toString('utf8'); + // A window opened mid-file starts mid-line; that line is dropped. + return start === 0 ? text : text.slice(text.indexOf('\n') + 1); + } catch { + return null; + } finally { + if (fd !== null) { + try { + closeSync(fd); + } catch { + // Nothing to do: the answer is already decided. + } + } + } +} + +/** What {@link claudeStopLeavesBackgroundWork} reads besides the payload. */ +export interface ClaudeSelfResumeOptions { + /** The home directory whose `.claude/projects` a transcript must be under. */ + homeDir?: string; + tailBytes?: number; +} + +/** + * Whether this `Stop` payload's session still has background work that has not + * been notified — i.e. whether Claude will open another turn by itself. + * + * Synchronous: it runs inside event normalization. `false` for every case it + * cannot vouch for (see the module comment). + */ +export function claudeStopLeavesBackgroundWork( + payload: Record, + options: ClaudeSelfResumeOptions = {} +): boolean { + const hint = nonEmptyString(payload[CLAUDE_TRANSCRIPT_PATH_FIELD]); + if (!hint) return false; + const root = join(options.homeDir ?? homedir(), ...CLAUDE_PROJECTS_DIR_SEGMENTS); + const path = acceptPathUnderRoot(root, '.jsonl', hint); + if (!path) return false; + const text = readTail(path, options.tailBytes ?? CLAUDE_SELF_RESUME_TAIL_BYTES); + if (text === null) return false; + return pendingClaudeBackgroundTasks(text).length > 0; +} diff --git a/src/lib/hooks/sources/claude/source.ts b/src/lib/hooks/sources/claude/source.ts index e13f50aee..fb18218cb 100644 --- a/src/lib/hooks/sources/claude/source.ts +++ b/src/lib/hooks/sources/claude/source.ts @@ -38,7 +38,11 @@ import { isUatIsolationEnabled, UatIsolationLaunchRefusedError, } from '@/config/uat-isolation'; -import { AGENT_EVENT_TYPES } from '@/lib/hooks/agent-event-types'; +import { + AGENT_EVENT_TYPES, + SELF_RESUME_PENDING_DETAIL, + type AgentEventType, +} from '@/lib/hooks/agent-event-types'; import { parseAskUserQuestionPayload } from '@/lib/hooks/ask-user-question-payload'; import { buildClaudeLaunchCommand, @@ -62,6 +66,7 @@ import { import type { AgentEventSource, AgentLaunchContext, AgentLaunchPlan, Verdict } from '../types'; import { claudeModelSwitchMapper, extractClaudeSwitchedModel } from './model-switch'; import { isClaudeQueuedNoticePrompt } from './queued-notice'; +import { claudeStopLeavesBackgroundWork } from './self-resume'; import { CLAUDE_CLI_TOOL_ID } from './tool-id'; /** @@ -105,6 +110,24 @@ export function encodeClaudeVerdict(verdict: Verdict): Record { }; } +/** + * The subtype of one Claude event. + * + * Every event but `stop` is the shared snake_case reading (S2). A `stop` is + * {@link SELF_RESUME_PENDING_DETAIL} when the session's transcript shows + * background work that has not been notified yet (Issue #3430), and has no + * subtype otherwise — which is what every Claude `stop` had before. + */ +export function extractClaudeEventDetail( + event: AgentEventType, + payload: Record +): string | null { + if (event === 'stop' && claudeStopLeavesBackgroundWork(payload)) { + return SELF_RESUME_PENDING_DETAIL; + } + return extractSnakeCaseEventDetail(event, payload); +} + /** * Claude Code as an event source. * @@ -149,11 +172,12 @@ export const claudeAgentEventSource: AgentEventSource = definePushHookSource({ // JSONL when the poller asks (#2121); the gate dispatches on this word // rather than on the tool id. transcriptHistory: 'pull', - // Issue #2614. Claude Code does resume itself (background tasks, session - // crons), and its `Stop` payload carries `background_tasks` / - // `session_crons` — but only the empty form has been captured, so nothing - // reads them yet and this stays false until a non-empty one is measured. - stopReportsSelfResume: false, + // Issue #3430 (#2614 for Claude). A `Stop` whose transcript shows a + // background `Bash` / `Monitor` / subagent not yet notified carries + // `SELF_RESUME_PENDING_DETAIL`: the notification opens the next turn by + // itself. The payload's `background_tasks` is still unread — only its empty + // form has been captured. See `./self-resume` and `extractDetail` below. + stopReportsSelfResume: true, }, // S1. A plain name table is enough *for this tool* — one native name, one @@ -190,8 +214,8 @@ export const claudeAgentEventSource: AgentEventSource = definePushHookSource({ // `UserPromptSubmit` too, and continues that turn rather than opening one. promptJoinsOpenTurn: isClaudeQueuedNoticePrompt, - // S2. - extractDetail: extractSnakeCaseEventDetail, + // S2, plus the `Stop` that leaves background work behind (Issue #3430). + extractDetail: extractClaudeEventDetail, // S7. Both parsers are strict and answer null for anything they cannot vouch // for; the callers turn null into "no structured data", which degrades to the diff --git a/tests/fixtures/claude-self-resume-3430/README.md b/tests/fixtures/claude-self-resume-3430/README.md new file mode 100644 index 000000000..8e3ae2e48 --- /dev/null +++ b/tests/fixtures/claude-self-resume-3430/README.md @@ -0,0 +1,21 @@ +# Claude Code transcript — バックグラウンド作業を残したままの Stop（Issue #3430） + +`transcript.jsonl` は 2026-10-08 の実 transcript（Claude Code 2.1.293、worktree `commandmate-issue-3423`、 +session `0a8e0d46-…`）から抜き出したもの。**手で書いた想定ではなく、届いた記録の形をそのまま残している。** + +## 何が起きたか + +1. 23:37:00 `Bash` が 120 秒で打ち切られてバックグラウンドへ（`toolUseResult.backgroundTaskId: "beszxbdym"`） +2. 23:37:06〜23:37:49 `Monitor` を 6 本起動（`toolUseResult.taskId` と `persistent: false`）。うち `b5svpm92a` はターン中に通知が届いた（`queue-operation` の `remove` と `queued_command` の attachment） +3. 23:37:53 **最初の Stop**（47 行目の `stop_hook_summary`）。未通知の作業が 6 本残っている +4. 23:38:14 `beszxbdym` の `` が `type: "user"` のプロンプトとして届き、新しいターンが開く → コミット +5. 以後、Monitor の通知のたびにターンが開いて閉じ、最後の Stop（84 行目）で未通知の作業が 0 本になる + +各 `stop_hook_summary` の直前までを読むと、未通知の作業は 6 → 5 → 4 → 3 → 2 → 1 → 0 本。 + +## 加工 + +- 載せたのは `user` / `assistant` / `queue-operation` / `queued_command` の attachment / `stop_hook_summary` だけ。他の type（`prompt_snapshot` など）は落とした +- 最初のプロンプト（契約本文）、バックグラウンドでないツール結果の本文、ツール入力のコマンドは伏せた（`(elided)` など） +- パスは `` / `` / `` に、session id は `00000000-0000-4000-8000-000000003430` に置換 +- 残した構造化フィールド: `toolUseResult` の `backgroundTaskId` / `taskId` / `persistent` / `timeoutMs` / `timedOutAfterMs` / `interrupted` diff --git a/tests/fixtures/claude-self-resume-3430/transcript.jsonl b/tests/fixtures/claude-self-resume-3430/transcript.jsonl new file mode 100644 index 000000000..1ccfca183 --- /dev/null +++ b/tests/fixtures/claude-self-resume-3430/transcript.jsonl @@ -0,0 +1,84 @@ +{"type": "user", "isSidechain": false, "uuid": "0829364c-124c-428f-a522-aff21ec297f7", "parentUuid": null, "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:32:53.619Z", "promptSource": "typed", "turnOrigin": "human", "origin": {"kind": "human"}, "message": {"role": "user", "content": "(the implementation contract for #3423, elided)"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "3c806cb3-4b71-4d0e-8a93-7640a4d6c842", "parentUuid": "941280e4-15c8-49d1-81cb-f31fad49c085", "timestamp": "2026-10-07T23:32:56.388Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_019DnFu9WkU9pd4gPJzMYTSg", "name": "Read", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "80c6a049-388b-470f-ade6-2f434bb11b3a", "parentUuid": "3c806cb3-4b71-4d0e-8a93-7640a4d6c842", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:32:56.651Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_019DnFu9WkU9pd4gPJzMYTSg", "content": "(elided)"}]}, "toolUseResult": {}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "2e750e2d-4321-451c-8beb-5e092a8942b3", "parentUuid": "69593d00-9130-4959-abd9-02e90fa6ca73", "timestamp": "2026-10-07T23:32:59.120Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01SuaKin9Y8u6UtavP2ATKUA", "name": "Bash", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "a0959316-5cbb-4578-9ab6-fffc5a98e8e6", "parentUuid": "2e750e2d-4321-451c-8beb-5e092a8942b3", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:33:01.352Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01SuaKin9Y8u6UtavP2ATKUA", "content": "(elided)", "is_error": false}]}, "toolUseResult": {"interrupted": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "b92095d4-3947-4b08-8d12-b1786876f177", "parentUuid": "a0959316-5cbb-4578-9ab6-fffc5a98e8e6", "timestamp": "2026-10-07T23:33:02.951Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "thinking", "thinking": ""}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "d4408f70-3dc7-4b40-811f-34e5e000cd26", "parentUuid": "b92095d4-3947-4b08-8d12-b1786876f177", "timestamp": "2026-10-07T23:33:04.266Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01VxJYwpPo4jcrxTzrqw6WDH", "name": "Bash", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "dfb8c7b7-5efc-4c09-a4e8-155fd40e0767", "parentUuid": "d4408f70-3dc7-4b40-811f-34e5e000cd26", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:33:05.889Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01VxJYwpPo4jcrxTzrqw6WDH", "content": "(elided)", "is_error": false}]}, "toolUseResult": {"interrupted": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "f396e728-7a35-4af7-86e8-d3b6f18012d6", "parentUuid": "dfb8c7b7-5efc-4c09-a4e8-155fd40e0767", "timestamp": "2026-10-07T23:33:41.782Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "thinking", "thinking": ""}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "300bec54-e258-4477-941a-970c9c8d7632", "parentUuid": "f396e728-7a35-4af7-86e8-d3b6f18012d6", "timestamp": "2026-10-07T23:34:48.827Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01HZcL8inoUbm4D9qepDU2Nf", "name": "Bash", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "49358e9e-b0e2-4e0e-8140-d33e9675dcfd", "parentUuid": "300bec54-e258-4477-941a-970c9c8d7632", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:34:49.340Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01HZcL8inoUbm4D9qepDU2Nf", "content": "(elided)", "is_error": false}]}, "toolUseResult": {"interrupted": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "71747273-7333-4ddd-8218-dca9d00464bc", "parentUuid": "49358e9e-b0e2-4e0e-8140-d33e9675dcfd", "timestamp": "2026-10-07T23:34:52.263Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "thinking", "thinking": ""}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "07e0f646-8b74-449a-aa69-1ebbfa581ef8", "parentUuid": "71747273-7333-4ddd-8218-dca9d00464bc", "timestamp": "2026-10-07T23:34:55.156Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01Mbr9bN5HrAad27vLM9XFFZ", "name": "Bash", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "ded498bf-5375-48bd-af58-173fcc5e76a3", "parentUuid": "07e0f646-8b74-449a-aa69-1ebbfa581ef8", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:34:55.701Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01Mbr9bN5HrAad27vLM9XFFZ", "content": "(elided)", "is_error": false}]}, "toolUseResult": {"interrupted": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "148fc45c-3035-4071-aab1-e4487285704b", "parentUuid": "ded498bf-5375-48bd-af58-173fcc5e76a3", "timestamp": "2026-10-07T23:34:56.990Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "text", "text": "Those are unrelated. Now the changelog fragment and verification."}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "6bb2039b-bbc3-49fb-9d93-f5f8070b95e7", "parentUuid": "148fc45c-3035-4071-aab1-e4487285704b", "timestamp": "2026-10-07T23:34:59.317Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01PRuuyjijj6ULArmeEBTpsG", "name": "Bash", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "68aa6b8c-1e4e-49f5-83ec-e0189a639a4a", "parentUuid": "6bb2039b-bbc3-49fb-9d93-f5f8070b95e7", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:37:00.029Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01PRuuyjijj6ULArmeEBTpsG", "content": "Command did not complete within its 120s timeout and was moved to the background (ID: beszxbdym). Output is being written to: /tasks/beszxbdym.output. You will be notified when it completes. To check interim output, use Read on that file path.", "is_error": false}]}, "toolUseResult": {"interrupted": false, "backgroundTaskId": "beszxbdym", "timedOutAfterMs": 120000}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "14026fbe-41ee-4981-a4ec-535bc972edd5", "parentUuid": "68aa6b8c-1e4e-49f5-83ec-e0189a639a4a", "timestamp": "2026-10-07T23:37:01.841Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "thinking", "thinking": ""}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "99a143c1-cb8d-43e7-8df0-5705cd3a3d20", "parentUuid": "14026fbe-41ee-4981-a4ec-535bc972edd5", "timestamp": "2026-10-07T23:37:02.810Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01RDYQq9eAAJy72ig7cBmVD3", "name": "Bash", "input": {"timeout": 130000}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "db7fe074-fb6a-4c0f-b11b-f8067db9f25a", "parentUuid": "99a143c1-cb8d-43e7-8df0-5705cd3a3d20", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:37:02.813Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01RDYQq9eAAJy72ig7cBmVD3", "content": "(elided)", "is_error": true}]}, "toolUseResult": "(elided)", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "f0ed6737-7138-4e88-bc95-bd0a73358283", "parentUuid": "db7fe074-fb6a-4c0f-b11b-f8067db9f25a", "timestamp": "2026-10-07T23:37:06.122Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01EvFoyYnUYPnwHStr7vyZZ8", "name": "Monitor", "input": {"description": "wait for verification", "timeout_ms": 600000, "persistent": "false"}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "1ea1b301-47dc-481c-8e46-391cbf8eb1ca", "parentUuid": "f0ed6737-7138-4e88-bc95-bd0a73358283", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:37:06.459Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01EvFoyYnUYPnwHStr7vyZZ8", "content": "Monitor started (task byg1hzzgl, expires in 10m unless the source ends first; you get one notice at expiry — re-arm if you still need the watch). You will be notified on each event. Keep working — do not poll or sleep. Events may arrive while you are waiting for the user — an event is not their reply."}]}, "toolUseResult": {"taskId": "byg1hzzgl", "timeoutMs": 600000, "persistent": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "81a0461c-b185-44a9-96b6-330192b40f9c", "parentUuid": "fdd1ecb8-0f84-49ac-8205-bcba4d024d35", "timestamp": "2026-10-07T23:37:08.674Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01U4t7rd1mo23BoqCU1FAoud", "name": "Read", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "7fcd1f71-f0f8-43a7-b240-dcd228586f8b", "parentUuid": "81a0461c-b185-44a9-96b6-330192b40f9c", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:37:08.704Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01U4t7rd1mo23BoqCU1FAoud", "content": "(elided)"}]}, "toolUseResult": {}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "42f20632-2452-4cbe-a400-24970c2f9b91", "parentUuid": "7fcd1f71-f0f8-43a7-b240-dcd228586f8b", "timestamp": "2026-10-07T23:37:10.374Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "thinking", "thinking": ""}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "8c88f07e-e8ff-4016-8edd-7de0bca092e9", "parentUuid": "42f20632-2452-4cbe-a400-24970c2f9b91", "timestamp": "2026-10-07T23:37:10.691Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01FVrkLpbH7AVMksH6Hm3aci", "name": "Monitor", "input": {"description": "wait related tests", "timeout_ms": 600000}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "80d3c887-1b00-4788-8d28-d358e4e2d6a1", "parentUuid": "8c88f07e-e8ff-4016-8edd-7de0bca092e9", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:37:11.019Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01FVrkLpbH7AVMksH6Hm3aci", "content": "Monitor started (task b0rshf75w, expires in 10m unless the source ends first; you get one notice at expiry — re-arm if you still need the watch). You will be notified on each event. Keep working — do not poll or sleep. Events may arrive while you are waiting for the user — an event is not their reply."}]}, "toolUseResult": {"taskId": "b0rshf75w", "timeoutMs": 600000, "persistent": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "287c6201-fd28-4c37-9070-8883ad5f9e0f", "parentUuid": "2d897a3f-e01b-41e1-bda6-937765490f3c", "timestamp": "2026-10-07T23:37:13.354Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01YEvEFR6uqjXw4iKPUQ5b5E", "name": "Monitor", "input": {"description": "noop", "timeout_ms": 5000}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "c3d7c367-fa50-4ee8-b02b-2c8962b4373b", "parentUuid": "287c6201-fd28-4c37-9070-8883ad5f9e0f", "promptId": "06996971-3c3f-426c-b438-9a49a4d98bd2", "timestamp": "2026-10-07T23:37:13.652Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01YEvEFR6uqjXw4iKPUQ5b5E", "content": "Monitor started (task b5svpm92a, expires in 5s unless the source ends first; you get one notice at expiry — re-arm if you still need the watch). You will be notified on each event. Keep working — do not poll or sleep. Events may arrive while you are waiting for the user — an event is not their reply."}]}, "toolUseResult": {"taskId": "b5svpm92a", "timeoutMs": 5000, "persistent": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "enqueue", "timestamp": "2026-10-07T23:37:14.681Z", "content": "\nb5svpm92a\ntoolu_01YEvEFR6uqjXw4iKPUQ5b5E\n/tasks/b5svpm92a.output\ncompleted\nMonitor \"noop\" stream ended\nx\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't need one.\n\nb5svpm92a\ntoolu_01YEvEFR6uqjXw4iKPUQ5b5E\n/tasks/b5svpm92a.output\ncompleted\nMonitor \"noop\" stream ended\nx\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't need one.\n\nb5svpm92a\ntoolu_01YEvEFR6uqjXw4iKPUQ5b5E\n/tasks/b5svpm92a.output\ncompleted\nMonitor \"noop\" stream ended\nx\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't need one.\n\nbeszxbdym\ntoolu_01PRuuyjijj6ULArmeEBTpsG\n/tasks/beszxbdym.output\ncompleted\nBackground command \"cat > changelog.d/3423.md <<'E'\n<!-- ### Changed -->\n- **chore(catalog): codex の /daybreak をスラッシュコマンドカタログに追加し attestation を 0.161.0 で採り直し** (#3423): 無人実行。codex の", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "dequeue", "timestamp": "2026-10-07T23:38:14.713Z", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "debfb4d6-296a-498e-be35-c45fcb9fd8f5", "parentUuid": "f8b3d7e2-1a5b-4be8-bc9d-f2f4e949ffbf", "promptId": "4d245588-2436-49eb-aa97-af94b3157063", "timestamp": "2026-10-07T23:38:14.721Z", "promptSource": "system", "turnOrigin": "task_notification", "origin": {"kind": "task-notification", "producer": "session-task", "runId": "0muyqw7f0-79d01e2b"}, "message": {"role": "user", "content": "\nbeszxbdym\ntoolu_01PRuuyjijj6ULArmeEBTpsG\n/tasks/beszxbdym.output\ncompleted\nBackground command \"cat > changelog.d/3423.md <<'E'\n<!-- ### Changed -->\n- **chore(catalog): codex の /daybreak をスラッシュコマンドカタログに追加し attestation を 0.161.0 で採り直し** (#3423): 無人実行。codex の"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "2d1b3aaa-b714-4757-8176-cf37eaa501d8", "parentUuid": "debfb4d6-296a-498e-be35-c45fcb9fd8f5", "timestamp": "2026-10-07T23:38:17.458Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01XFQuM3FUv33NeBYuHQrggF", "name": "Bash", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "2a2dd99a-a1da-438f-b157-c1686de4ad8d", "parentUuid": "2d1b3aaa-b714-4757-8176-cf37eaa501d8", "promptId": "4d245588-2436-49eb-aa97-af94b3157063", "timestamp": "2026-10-07T23:38:18.875Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01XFQuM3FUv33NeBYuHQrggF", "content": "(elided)", "is_error": false}]}, "toolUseResult": {"interrupted": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "a0139a2d-2441-482d-9e7c-fd93d02567f9", "parentUuid": "2a2dd99a-a1da-438f-b157-c1686de4ad8d", "timestamp": "2026-10-07T23:38:23.798Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_01NeBDs9GEAHb1tmyZEL7S4u", "name": "Bash", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "777ba18c-83de-4540-b722-6a4c922cc42d", "parentUuid": "a0139a2d-2441-482d-9e7c-fd93d02567f9", "promptId": "4d245588-2436-49eb-aa97-af94b3157063", "timestamp": "2026-10-07T23:38:25.243Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_01NeBDs9GEAHb1tmyZEL7S4u", "content": "(elided)", "is_error": false}]}, "toolUseResult": {"interrupted": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "c7e26304-f313-4f55-9742-7db1dff8503a", "parentUuid": "777ba18c-83de-4540-b722-6a4c922cc42d", "timestamp": "2026-10-07T23:38:26.989Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "thinking", "thinking": ""}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "a82ddedc-608d-4669-aa51-ca5106faeb2c", "parentUuid": "c7e26304-f313-4f55-9742-7db1dff8503a", "timestamp": "2026-10-07T23:38:32.004Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "tool_use", "id": "toolu_014eFXTpaR3kmxaejvZnqTvo", "name": "Bash", "input": {}}], "stop_reason": "tool_use"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "6c09833f-91dd-4872-8c55-2c5054c7032f", "parentUuid": "a82ddedc-608d-4669-aa51-ca5106faeb2c", "promptId": "4d245588-2436-49eb-aa97-af94b3157063", "timestamp": "2026-10-07T23:38:32.511Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_014eFXTpaR3kmxaejvZnqTvo", "content": "(elided)", "is_error": false}]}, "toolUseResult": {"interrupted": false}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "cb703fe4-d7cf-4e7c-88f7-29c9ccd0b39d", "parentUuid": "6c09833f-91dd-4872-8c55-2c5054c7032f", "timestamp": "2026-10-07T23:38:45.069Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "text", "text": "IMPL_COMPLETED"}], "stop_reason": "end_turn"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "system", "subtype": "stop_hook_summary", "isSidechain": false, "uuid": "1a86e6e1-ae2d-495f-b378-19109c233279", "timestamp": "2026-10-07T23:38:45.659Z", "hookCount": 1, "preventedContinuation": false, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "enqueue", "timestamp": "2026-10-07T23:40:12.767Z", "content": "\nb8f85vqi1\ntoolu_01KJd5rwKF2rTkUX2HdqQ9Cu\n/tasks/b8f85vqi1.output\ncompleted\nMonitor \"wait related tests end\" stream ended\nrelated-done\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't ", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "dequeue", "timestamp": "2026-10-07T23:40:12.770Z", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "c729f675-e019-4c62-b754-febb59b6aa60", "parentUuid": "237a3343-a677-41e9-a5d6-735ba326a88a", "promptId": "c789cf12-b4da-4f1a-9be1-1f62ba96b903", "timestamp": "2026-10-07T23:40:12.777Z", "promptSource": "system", "turnOrigin": "task_notification", "origin": {"kind": "task-notification", "producer": "session-task", "runId": "0muyqzdzf-fc2384bd"}, "message": {"role": "user", "content": "\nb8f85vqi1\ntoolu_01KJd5rwKF2rTkUX2HdqQ9Cu\n/tasks/b8f85vqi1.output\ncompleted\nMonitor \"wait related tests end\" stream ended\nrelated-done\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't "}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "50eb2467-621f-4a79-9eca-5ece157d4972", "parentUuid": "c729f675-e019-4c62-b754-febb59b6aa60", "timestamp": "2026-10-07T23:40:14.399Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "text", "text": "IMPL_COMPLETED"}], "stop_reason": "end_turn"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "system", "subtype": "stop_hook_summary", "isSidechain": false, "uuid": "971ddf94-7d1c-4daa-873d-e6992bc351ed", "timestamp": "2026-10-07T23:40:14.924Z", "hookCount": 1, "preventedContinuation": false, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "enqueue", "timestamp": "2026-10-07T23:43:47.692Z", "content": "\nbinvvq8o9\ntoolu_013ZW18se8WmB7b1qzicocPR\n/tasks/binvvq8o9.output\ncompleted\nMonitor \"wait for related tests tail\" stream ended\nTest Files 13 passed (13)\nTests 304 passed (304)\nStart at 08:35:01\nDuration 1.28s (transform 1.33s, setup 1.93s, import 1.23", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "dequeue", "timestamp": "2026-10-07T23:43:47.696Z", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "d773f22c-d5a2-4708-b39e-e52f1aafba33", "parentUuid": "56470902-150e-49bf-8602-5d5adf227526", "promptId": "707857f5-8da9-414c-9e25-652ee075fee7", "timestamp": "2026-10-07T23:43:47.706Z", "promptSource": "system", "turnOrigin": "task_notification", "origin": {"kind": "task-notification", "producer": "session-task", "runId": "0muyqz4pf-7a9d32e5"}, "message": {"role": "user", "content": "\nbinvvq8o9\ntoolu_013ZW18se8WmB7b1qzicocPR\n/tasks/binvvq8o9.output\ncompleted\nMonitor \"wait for related tests tail\" stream ended\nTest Files 13 passed (13)\nTests 304 passed (304)\nStart at 08:35:01\nDuration 1.28s (transform 1.33s, setup 1.93s, import 1.23"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "1e2f032a-c3c4-44e2-8b8d-7acfa281fc9c", "parentUuid": "d773f22c-d5a2-4708-b39e-e52f1aafba33", "timestamp": "2026-10-07T23:43:49.279Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "text", "text": "IMPL_COMPLETED"}], "stop_reason": "end_turn"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "system", "subtype": "stop_hook_summary", "isSidechain": false, "uuid": "edafb2a1-bfe9-4e9e-98c3-5a887c3dd695", "timestamp": "2026-10-07T23:43:49.816Z", "hookCount": 1, "preventedContinuation": false, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "enqueue", "timestamp": "2026-10-07T23:47:06.460Z", "content": "\nbyg1hzzgl\nMonitor event: \"wait for verification\"\n[Monitor expired after 10m with no events delivered. Re-arm it if you still need the watch — and widen the filter if silence was unexpected.]\n", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "dequeue", "timestamp": "2026-10-07T23:47:06.467Z", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "c0770e1b-a96d-4587-a591-71c3a8f2c04f", "parentUuid": "17dc52e9-6af9-4c7f-a6ee-5b80fae08089", "promptId": "2d054158-f8ee-4723-915b-9507217486ac", "timestamp": "2026-10-07T23:47:06.476Z", "promptSource": "system", "turnOrigin": "task_notification", "origin": {"kind": "task-notification", "producer": "session-task"}, "message": {"role": "user", "content": "\nbyg1hzzgl\nMonitor event: \"wait for verification\"\n[Monitor expired after 10m with no events delivered. Re-arm it if you still need the watch — and widen the filter if silence was unexpected.]\n"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "5873a62f-9c66-4283-a636-eb7f9964a5a4", "parentUuid": "c0770e1b-a96d-4587-a591-71c3a8f2c04f", "timestamp": "2026-10-07T23:47:07.981Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "text", "text": "IMPL_COMPLETED"}], "stop_reason": "end_turn"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "system", "subtype": "stop_hook_summary", "isSidechain": false, "uuid": "ec186897-5853-4741-9fe7-99877fcda4bc", "timestamp": "2026-10-07T23:47:08.508Z", "hookCount": 1, "preventedContinuation": false, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "enqueue", "timestamp": "2026-10-07T23:47:10.962Z", "content": "\nb0rshf75w\ntoolu_01FVrkLpbH7AVMksH6Hm3aci\n/tasks/b0rshf75w.output\ncompleted\nMonitor \"wait related tests\" stream ended\nfinished\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't need one", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "dequeue", "timestamp": "2026-10-07T23:47:10.965Z", "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "user", "isSidechain": false, "uuid": "280670ce-c52e-4c31-8bcf-50fd345ff563", "parentUuid": "17f6477a-3267-4726-8237-30fbd33613f9", "promptId": "4ecaec19-bc3b-4133-ab62-932212c6b253", "timestamp": "2026-10-07T23:47:10.969Z", "promptSource": "system", "turnOrigin": "task_notification", "origin": {"kind": "task-notification", "producer": "session-task", "runId": "0muyqyycq-ccbdba06"}, "message": {"role": "user", "content": "\nb0rshf75w\ntoolu_01FVrkLpbH7AVMksH6Hm3aci\n/tasks/b0rshf75w.output\ncompleted\nMonitor \"wait related tests\" stream ended\nfinished\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't need one"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "assistant", "isSidechain": false, "uuid": "62e746ad-af83-4714-ac2f-16b889f10496", "parentUuid": "280670ce-c52e-4c31-8bcf-50fd345ff563", "timestamp": "2026-10-07T23:47:12.558Z", "message": {"role": "assistant", "model": "claude-sonnet-5-5", "content": [{"type": "text", "text": "IMPL_COMPLETED"}], "stop_reason": "end_turn"}, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "system", "subtype": "stop_hook_summary", "isSidechain": false, "uuid": "ff594b7a-8a32-4071-be6c-198a17479a38", "timestamp": "2026-10-07T23:47:13.093Z", "hookCount": 1, "preventedContinuation": false, "sessionId": "00000000-0000-4000-8000-000000003430"} +{"type": "queue-operation", "operation": "enqueue", "timestamp": "2026-10-07T23:47:49.371Z", "content": "\nbe0fb96mf\ntoolu_01XsPQkLqfXEh9gFEPtZd9bp\n/tasks/be0fb96mf.output\ncompleted\nMonitor \"wait\" stream ended\nt\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't need one.\n\nbe0fb96mf\ntoolu_01XsPQkLqfXEh9gFEPtZd9bp\n/tasks/be0fb96mf.output\ncompleted\nMonitor \"wait\" stream ended\nt\nIf this event is something the user would act on now, send a PushNotification. Routine or benign output doesn't need one.\n {}) as never); +const mockConsoleLog = vi.spyOn(console, 'log').mockImplementation(() => {}); +const mockConsoleError = vi.spyOn(console, 'error').mockImplementation(() => {}); + +afterEach(() => { + restoreFetch(); + mockExit.mockClear(); + mockConsoleLog.mockClear(); + mockConsoleError.mockClear(); + mockConsoleError.mockImplementation(() => {}); + vi.useRealTimers(); +}); + +/** Epoch ms of a UTC time on the night of the incident. */ +const T = (hms: string): number => Date.parse(`2026-10-07T${hms}Z`); + +const FIXTURE_LINES = readFileSync( + join(process.cwd(), 'tests/fixtures/claude-self-resume-3430/transcript.jsonl'), + 'utf8' +) + .split('\n') + .filter((line) => line !== ''); + +/** The detail the source publishes on each `stop`, read off the transcript as of that stop. */ +const STOP_DETAILS: (string | null)[] = FIXTURE_LINES.flatMap((line, i) => + (JSON.parse(line) as { subtype?: string }).subtype === 'stop_hook_summary' + ? [pendingClaudeBackgroundTasks(FIXTURE_LINES.slice(0, i).join('\n')).length > 0 ? SELF_RESUME_PENDING_DETAIL : null] + : [] +); + +interface TimelineEvent { + at: number; + event: 'stop' | 'user_prompt_submit'; + detail: string | null; +} + +const PROMPT_SENT = T('23:32:53.638'); +const FIRST_STOP = T('23:37:53.377'); +const FINAL_STOP = T('23:47:51.432'); + +/** The wakes are the notifications' `UserPromptSubmit`s, opening a turn each. */ +const WAKES_AND_STOPS: [string, string][] = [ + ['23:38:14.727', '23:38:45.656'], + ['23:40:12.770', '23:40:14.924'], + ['23:43:47.696', '23:43:49.816'], + ['23:47:06.467', '23:47:08.508'], + ['23:47:10.965', '23:47:13.093'], + ['23:47:49.375', '23:47:51.432'], +]; + +const INCIDENT: TimelineEvent[] = [ + { at: PROMPT_SENT, event: 'user_prompt_submit', detail: null }, + // A Monitor's notice absorbed into the running turn (#3330): no new turn. + { at: T('23:37:16.023'), event: 'user_prompt_submit', detail: null }, + { at: FIRST_STOP, event: 'stop', detail: STOP_DETAILS[0] }, + ...WAKES_AND_STOPS.flatMap(([wake, stop], n): TimelineEvent[] => [ + { at: T(wake), event: 'user_prompt_submit', detail: null }, + { at: T(stop), event: 'stop', detail: STOP_DETAILS[n + 1] }, + ]), +]; + +/** What the server published that night: no detail on any Claude stop. */ +const INCIDENT_WITHOUT_DETAIL = INCIDENT.map((e) => ({ ...e, detail: null })); + +/** Claude's declaration, as its source publishes it. */ +const CLAUDE_CAPABILITIES = JSON.parse(JSON.stringify(claudeAgentEventSource.capabilities)) as Record< + string, + unknown +>; + +/** `current-output` at `now`. The turn rules of `wait-self-resume-2614.test.ts`. */ +function currentOutputAt(now: number, events: TimelineEvent[]) { + const seen = events.filter((e) => e.at <= now); + let turn: { turnId: string | null; openedAt: number | null; closedAt: number | null; closedBy: string | null } = { + turnId: null, + openedAt: null, + closedAt: null, + closedBy: null, + }; + let turns = 0; + let lastStopEventAt: number | null = null; + for (const e of seen) { + if (e.event === 'stop') { + lastStopEventAt = e.at; + turn = + turn.openedAt !== null && turn.closedAt === null + ? { ...turn, closedAt: e.at, closedBy: 'stop' } + : { turnId: `turn-${++turns}`, openedAt: null, closedAt: e.at, closedBy: 'stop' }; + } else if (turn.openedAt === null || turn.closedAt !== null) { + turn = { turnId: `turn-${++turns}`, openedAt: e.at, closedAt: null, closedBy: null }; + } + } + const last = seen.at(-1) ?? null; + const ready = last?.event === 'stop'; + return { + isRunning: true, + isPromptWaiting: false, + content: `frame-${seen.length}`, + fullOutput: `frame-${seen.length}`, + realtimeSnippet: `frame-${seen.length}`, + lineCount: 1, + lastCapturedLine: 1, + promptData: null, + autoYes: { enabled: false, expiresAt: null }, + thinking: false, + cliToolId: 'claude', + isSelectionListActive: false, + lastServerResponseTimestamp: null, + serverPollerActive: false, + sessionStatus: ready ? ('ready' as const) : ('running' as const), + sessionStatusReason: ready ? 'hook_stop' : 'hook_user_prompt_submit', + lastStopEventAt, + structuredEvents: { + lastEventType: last?.event ?? null, + lastEventAt: last?.at ?? null, + lastEventDetail: last?.detail ?? null, + promptWaitingSince: null, + promptWaitingSource: null, + source: { cliToolId: 'claude', capabilities: CLAUDE_CAPABILITIES }, + ...turn, + pendingDecisions: [], + dedupDropped: { + dedupDropped: { identity: 0, timeWindow: 0 }, + decisionEvicted: 0, + idsDiscarded: 0, + dialogTimedOut: 0, + decisionOverflow: 0, + }, + dialogPendingMaxMs: { predicted: 20_000, confirmed: 1_800_000 }, + }, + }; +} + +const json = (data: unknown, status = 200): Response => + ({ + ok: status >= 200 && status < 300, + status, + redirected: false, + headers: new Headers({ 'content-type': 'application/json' }), + json: () => Promise.resolve(data), + text: () => Promise.resolve(JSON.stringify(data)), + }) as unknown as Response; + +const userMessage = (at: number) => ({ + id: 'm1', + worktreeId: 'wt1', + role: 'user', + content: 'Implement #3423', + timestamp: new Date(at).toISOString(), + messageType: 'normal', + cliToolId: 'claude', + instanceId: 'claude', + archived: false, +}); + +/** @returns When (fake clock) `wait --verify` asked for a verification run, or null */ +function mockTimeline(events: TimelineEvent[]): () => number | null { + let verifyRequestedAt: number | null = null; + global.fetch = vi.fn((input: unknown, init?: { method?: string }) => { + const url = String(input); + if (url.includes('/verify/runs/')) { + return Promise.resolve(json({ run: { id: 1, status: 'passed', gates: [] } })); + } + if (url.endsWith('/verify') && init?.method === 'POST') { + verifyRequestedAt ??= Date.now(); + return Promise.resolve(json({ runId: 1 })); + } + if (url.includes('/tasks?')) { + return Promise.resolve(json({ tasks: [] })); + } + if (url.includes('/api/capabilities')) { + return Promise.resolve(json({ serverVersion: '0.0.0-test', capabilities: ['resolve-session-target'] })); + } + if (url.includes('/resolve-target')) { + return Promise.resolve(json({ cliToolId: 'claude', instanceId: 'claude', resolvedBy: 'roster', conflict: null })); + } + if (url.includes('/messages?')) { + return Promise.resolve(json([userMessage(PROMPT_SENT)])); + } + return Promise.resolve(json(currentOutputAt(Date.now(), events))); + }) as unknown as typeof fetch; + return () => verifyRequestedAt; +} + +const lines = () => mockConsoleError.mock.calls.map((c) => String(c[0])); + +function completedAtSpy(): () => number | null { + let at: number | null = null; + mockConsoleError.mockImplementation((message: unknown) => { + if (at === null && String(message).startsWith('Completed:')) at = Date.now(); + }); + return () => at; +} + +async function runWait(args: string[], startAt: number, runForMs: number): Promise { + vi.useFakeTimers(); + vi.setSystemTime(startAt); + const cmd = (await import('../../../../src/cli/commands/wait')).createWaitCommand(); + const pending = cmd.parseAsync(['node', 'wait', 'wt1', '--instance', 'claude', ...args]); + await vi.advanceTimersByTimeAsync(runForMs); + await pending; +} + +describe('the 2026-10-08 incident, replayed (Issue #3430)', () => { + it('reads six held stops and one final one off the transcript', () => { + expect(STOP_DETAILS).toEqual([...Array(6).fill(SELF_RESUME_PENDING_DETAIL), null]); + expect(CLAUDE_CAPABILITIES.stopReportsSelfResume).toBe(true); + }); + + it('lets wait --verify start its run only after the stop that really ends the work', async () => { + const verifyRequestedAt = mockTimeline(INCIDENT); + const completedAt = completedAtSpy(); + + await runWait(['--verify'], T('23:37:30.000'), 12 * 60_000); + + expect(mockExit).toHaveBeenCalledWith(WaitExitCode.SUCCESS); + expect(completedAt()!).toBeGreaterThanOrEqual(FINAL_STOP); + expect(completedAt()!).toBeLessThan(FINAL_STOP + 6_000); + // The commit landed at 23:38:32; the run that night started at 23:37:56. + expect(verifyRequestedAt()!).toBeGreaterThanOrEqual(FINAL_STOP); + expect(lines().find((l) => l.startsWith('Completed:'))).toMatch( + /^Completed: wt1 \(basis=hook_stop, heldForSelfResume=\d+s\)$/ + ); + }); + + it('completed on the first stop without the detail — the control case', async () => { + const verifyRequestedAt = mockTimeline(INCIDENT_WITHOUT_DETAIL); + const completedAt = completedAtSpy(); + + await runWait(['--verify'], T('23:37:30.000'), 2 * 60_000); + + expect(mockExit).toHaveBeenCalledWith(WaitExitCode.SUCCESS); + expect(completedAt()!).toBeGreaterThanOrEqual(FIRST_STOP); + expect(completedAt()!).toBeLessThan(FIRST_STOP + 6_000); + expect(verifyRequestedAt()!).toBeLessThan(T('23:38:32.000')); + }); +}); diff --git a/tests/unit/hooks/sources/capabilities.test.ts b/tests/unit/hooks/sources/capabilities.test.ts index 6bcc631d0..65c58668b 100644 --- a/tests/unit/hooks/sources/capabilities.test.ts +++ b/tests/unit/hooks/sources/capabilities.test.ts @@ -55,8 +55,11 @@ * - `stopReportsSelfResume` (Issue #2614) — read by `commandmate wait`, which * holds a completion on a `stop` whose detail says the agent will resume by * itself. Flipping antigravity to `false` lets `wait` report agy's - * `schedule` stops as the end of the work again (the 2026-09-17 incident); - * flipping any other source to `true` promises a detail nothing writes. + * `schedule` stops as the end of the work again (the 2026-09-17 incident), + * and claude to `false` does the same to its background `Bash` / `Monitor` + * stops (the 2026-10-08 incident, Issue #3430, reddened by + * `claude-self-resume-3430.test.ts`); flipping any other source to `true` + * promises a detail nothing writes. * Reddened by `tests/unit/hooks/sources/antigravity-self-resume-2614.test.ts` * as well as here. * @@ -132,7 +135,8 @@ const TABLE: Record = { eventIdentity: null, resync: 'none', transcriptHistory: 'pull', - stopReportsSelfResume: false, + // Issue #3430: a `Stop` whose transcript shows unnotified background work. + stopReportsSelfResume: true, }, codex: { permissionHookPredictsDialog: true, @@ -329,10 +333,10 @@ describe('[#1924] AgentSourceCapabilities — the table of §4 D3', () => { it('names exactly one source whose stop can say it will resume by itself (#2614)', () => { // agy is the one tool whose `Stop` payload is known to state it (`fullyIdle`) - // and whose hook passes it on. Claude Code resumes itself too, but only an - // empty `background_tasks` has been captured, so it stays false until a - // non-empty one is. + // and whose hook passes it on. Issue #3430 added claude, which reads it off + // its transcript rather than the payload (only an empty `background_tasks` + // has been captured) — so the title's "one" now reads "one per mechanism". const selfResuming = Object.keys(TABLE).filter((id) => TABLE[id].stopReportsSelfResume); - expect(selfResuming).toEqual(['antigravity']); + expect(selfResuming).toEqual(['claude', 'antigravity']); }); }); diff --git a/tests/unit/hooks/sources/claude-self-resume-3430.test.ts b/tests/unit/hooks/sources/claude-self-resume-3430.test.ts new file mode 100644 index 000000000..99997d83b --- /dev/null +++ b/tests/unit/hooks/sources/claude-self-resume-3430.test.ts @@ -0,0 +1,236 @@ +/** + * A Claude Code `Stop` that leaves background work behind says so + * (Issue #3430 — #2614 for Claude). + * + * Measured, not imagined: `tests/fixtures/claude-self-resume-3430/transcript.jsonl` + * is the transcript of the 2026-10-08 worker that ended its turn at 23:37:53 + * "waiting for the related-tests run to finish" and committed in the turn the + * notification opened. Each `stop_hook_summary` in it marks a `Stop`; what the + * hook could read at that moment is every line before it. + * + * @vitest-environment node + */ + +import { afterAll, afterEach, beforeAll, describe, expect, it, vi } from 'vitest'; +import { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'fs'; +import { tmpdir } from 'os'; +import { join } from 'path'; +import { removeTempDir } from '@tests/helpers/temp-dir'; +import { SELF_RESUME_PENDING_DETAIL } from '@/lib/hooks/agent-event-types'; +import { + claudeStopLeavesBackgroundWork, + CLAUDE_TRANSCRIPT_PATH_FIELD, + pendingClaudeBackgroundTasks, +} from '@/lib/hooks/sources/claude/self-resume'; +import { claudeAgentEventSource, extractClaudeEventDetail } from '@/lib/hooks/sources/claude/source'; +import { claudeProjectSlug } from '@/lib/hooks/sources/claude/transcript'; + +const FIXTURE_LINES = readFileSync( + join(process.cwd(), 'tests/fixtures/claude-self-resume-3430/transcript.jsonl'), + 'utf8' +) + .split('\n') + .filter((line) => line !== ''); + +/** Claude's captured `Stop` payload (2.1.223), `background_tasks: []`. */ +const STOP_PAYLOAD = JSON.parse( + readFileSync(join(process.cwd(), 'tests/fixtures/hooks/claude/stop.json'), 'utf8') +) as Record; + +/** 0-based indices of the `stop_hook_summary` records, in order. */ +const STOP_LINES = FIXTURE_LINES.flatMap((line, i) => + (JSON.parse(line) as { subtype?: string }).subtype === 'stop_hook_summary' ? [i] : [] +); + +/** The transcript as the hook of the `n`-th stop (0-based) could read it. */ +const atStop = (n: number): string => FIXTURE_LINES.slice(0, STOP_LINES[n]).join('\n') + '\n'; + +const FIRST_STOP_PENDING = ['beszxbdym', 'byg1hzzgl', 'b0rshf75w', 'binvvq8o9', 'b8f85vqi1', 'be0fb96mf']; + +const line = (record: Record): string => JSON.stringify(record); +const bgBash = (id: string) => line({ type: 'user', toolUseResult: { backgroundTaskId: id } }); +const notice = (id: string) => + line({ + type: 'user', + message: { role: 'user', content: `\n${id}\ncompleted` }, + }); + +describe('pendingClaudeBackgroundTasks — the 2026-10-08 transcript', () => { + it('has the seven stops the run made', () => { + expect(STOP_LINES).toHaveLength(7); + }); + + it('counts the six unnotified tasks at the first stop, the one wait read as the end', () => { + // The Bash moved to the background plus five Monitors; `b5svpm92a` was + // notified inside the turn (an absorbed `queued_command`) and is not pending. + expect(pendingClaudeBackgroundTasks(atStop(0))).toEqual(FIRST_STOP_PENDING); + }); + + it('retires one task per notification, down to none at the last stop', () => { + expect(STOP_LINES.map((_, n) => pendingClaudeBackgroundTasks(atStop(n)).length)).toEqual([ + 6, 5, 4, 3, 2, 1, 0, + ]); + }); + + it('retires the task an expired Monitor reports, which names no tool-use id', () => { + // byg1hzzgl's notice is `Monitor expired …` with a and nothing else. + expect(pendingClaudeBackgroundTasks(atStop(4))).not.toContain('byg1hzzgl'); + expect(pendingClaudeBackgroundTasks(atStop(3))).toContain('byg1hzzgl'); + }); + + it('counts nothing before any work was sent to the background', () => { + const firstBackground = FIXTURE_LINES.findIndex((l) => l.includes('"backgroundTaskId"')); + expect(firstBackground).toBeGreaterThan(0); + expect(pendingClaudeBackgroundTasks(FIXTURE_LINES.slice(0, firstBackground).join('\n'))).toEqual([]); + }); +}); + +describe('pendingClaudeBackgroundTasks — the shapes around it', () => { + it('keeps a task pending while its notice is only enqueued', () => { + // The session will open a turn on it: still work that resumes the agent. + const enqueued = line({ + type: 'queue-operation', + operation: 'enqueue', + content: '\nb1', + }); + expect(pendingClaudeBackgroundTasks([bgBash('b1'), enqueued].join('\n'))).toEqual(['b1']); + }); + + it('retires a task stopped with TaskStop, which is never notified', () => { + const stopped = line({ type: 'user', toolUseResult: { task_id: 'b1', task_type: 'local_bash' } }); + expect(pendingClaudeBackgroundTasks([bgBash('b1'), stopped].join('\n'))).toEqual([]); + }); + + it('counts a non-persistent Monitor and a background subagent, not a persistent Monitor', () => { + const text = [ + line({ type: 'user', toolUseResult: { taskId: 'm1', timeoutMs: 600000, persistent: false } }), + line({ type: 'user', toolUseResult: { taskId: 'm2', persistent: true } }), + line({ type: 'user', toolUseResult: { agentId: 'a1', isAsync: true, status: 'async_launched' } }), + line({ type: 'user', toolUseResult: { agentId: 'a2', status: 'completed' } }), + ].join('\n'); + expect(pendingClaudeBackgroundTasks(text)).toEqual(['m1', 'a1']); + }); + + it('retires on a notice delivered as a text block or a queued_command attachment', () => { + const textBlock = line({ + type: 'user', + message: { role: 'user', content: [{ type: 'text', text: '\nb1' }] }, + }); + const attachment = line({ + type: 'attachment', + attachment: { type: 'queued_command', prompt: '\nb2' }, + }); + expect(pendingClaudeBackgroundTasks([bgBash('b1'), bgBash('b2'), textBlock, attachment].join('\n'))).toEqual( + [] + ); + }); + + it('does not take a mention of the tag for a notice', () => { + const quoted = line({ type: 'user', message: { role: 'user', content: 'see b1' } }); + expect(pendingClaudeBackgroundTasks([bgBash('b1'), quoted].join('\n'))).toEqual(['b1']); + }); + + it('ignores what a subagent wrote and lines that do not parse', () => { + const sidechain = line({ type: 'user', isSidechain: true, toolUseResult: { backgroundTaskId: 'b9' } }); + expect(pendingClaudeBackgroundTasks([sidechain, '{"type":"user",', 'not json'].join('\n'))).toEqual([]); + }); +}); + +describe('the Claude source on a Stop (Issue #3430)', () => { + let home: string; + let transcriptDir: string; + + beforeAll(() => { + home = mkdtempSync(join(tmpdir(), 'cmate-claude-self-resume-3430-')); + transcriptDir = join(home, '.claude', 'projects', claudeProjectSlug('/work/commandmate-issue-3423')); + mkdirSync(transcriptDir, { recursive: true }); + }); + + afterAll(() => removeTempDir(home)); + + afterEach(() => vi.unstubAllEnvs()); + + /** Write `text` as a transcript under the sandbox home and answer its path. */ + function transcript(name: string, text: string): string { + const path = join(transcriptDir, `${name}.jsonl`); + writeFileSync(path, text); + return path; + } + + const stopWith = (transcriptPath: unknown): Record => ({ + ...STOP_PAYLOAD, + [CLAUDE_TRANSCRIPT_PATH_FIELD]: transcriptPath, + }); + + /** `normalizeEvent` reads the real home directory; HOME is what `os.homedir()` returns. */ + function normalizedDetail(payload: Record): string | null | undefined { + vi.stubEnv('HOME', home); + return claudeAgentEventSource.normalizeEvent({ payload })?.detail; + } + + it('declares that its stop can say so', () => { + expect(claudeAgentEventSource.capabilities.stopReportsSelfResume).toBe(true); + }); + + it('(a) marks the stop at which background work is still unnotified', () => { + const path = transcript('first-stop', atStop(0)); + expect(normalizedDetail(stopWith(path))).toBe(SELF_RESUME_PENDING_DETAIL); + expect(claudeStopLeavesBackgroundWork(stopWith(path), { homeDir: home })).toBe(true); + }); + + it('(b) does not mark the stop after every notification has arrived', () => { + const path = transcript('last-stop', atStop(STOP_LINES.length - 1)); + expect(normalizedDetail(stopWith(path))).toBeNull(); + }); + + it('(c) does not mark an ordinary stop with no background work', () => { + const firstBackground = FIXTURE_LINES.findIndex((l) => l.includes('"backgroundTaskId"')); + const path = transcript('ordinary', FIXTURE_LINES.slice(0, firstBackground).join('\n') + '\n'); + expect(normalizedDetail(stopWith(path))).toBeNull(); + }); + + it('(d) does not mark a stop whose transcript cannot be read', () => { + // The captured payload itself: `` is not under ~/.claude/projects. + expect(normalizedDetail(STOP_PAYLOAD)).toBeNull(); + // No field, a non-string, a file that is not there. + expect(normalizedDetail(stopWith(undefined))).toBeNull(); + expect(normalizedDetail(stopWith(42))).toBeNull(); + expect(normalizedDetail(stopWith(join(transcriptDir, 'missing.jsonl')))).toBeNull(); + // Outside the projects root, even with pending work in it — and climbing out with `..`. + const outside = join(home, 'elsewhere.jsonl'); + writeFileSync(outside, atStop(0)); + expect(normalizedDetail(stopWith(outside))).toBeNull(); + expect(normalizedDetail(stopWith(join(transcriptDir, '..', '..', '..', 'elsewhere.jsonl')))).toBeNull(); + // Not a transcript by name. + const notJsonl = join(transcriptDir, 'first-stop.txt'); + writeFileSync(notJsonl, atStop(0)); + expect(normalizedDetail(stopWith(notJsonl))).toBeNull(); + }); + + it('reads only the tail, dropping the line the window opens in', () => { + const filler = line({ type: 'assistant', message: { content: [{ type: 'text', text: 'x'.repeat(200) }] } }); + const path = transcript('tail', [bgBash('old'), filler].join('\n') + '\n'); + // Read whole, `old` is pending. + expect(claudeStopLeavesBackgroundWork(stopWith(path), { homeDir: home })).toBe(true); + // A window that opens 5 bytes into `old`'s line drops that line: a start older + // than the window is not seen — the "finished" direction. + const tailBytes = Buffer.byteLength(filler + '\n') + 5; + expect(claudeStopLeavesBackgroundWork(stopWith(path), { homeDir: home, tailBytes })).toBe(false); + // A start inside the window is still seen. + const recent = transcript('tail-recent', [filler, bgBash('new'), ''].join('\n')); + expect( + claudeStopLeavesBackgroundWork(stopWith(recent), { homeDir: home, tailBytes: Buffer.byteLength(bgBash('new')) + 10 }) + ).toBe(true); + // And its notice retires it. + const notified = transcript('tail-notified', [filler, bgBash('new'), notice('new'), ''].join('\n')); + expect(claudeStopLeavesBackgroundWork(stopWith(notified), { homeDir: home })).toBe(false); + }); + + it('leaves every other event to the shared reading', () => { + vi.stubEnv('HOME', home); + const path = transcript('other-events', atStop(0)); + expect(extractClaudeEventDetail('pre_tool_use', { tool_name: 'Bash', transcript_path: path })).toBe('Bash'); + expect(extractClaudeEventDetail('user_prompt_submit', { transcript_path: path })).toBeNull(); + expect(extractClaudeEventDetail('session_end', { reason: 'clear', transcript_path: path })).toBe('clear'); + }); +});