throughline 0.10.2 → 0.10.5

package/docs/archive/02_clear_auto_handoff_plan.md

@@ -0,0 +1,350 @@
+# Throughline `/clear` 自動引継ぎ計画 (TODO 兼)
+
+> **履歴:** v0.4系の実装計画と当時の検証記録。現行契約は
+> [../02_clear_auto_handoff_plan.md](../02_clear_auto_handoff_plan.md) を参照する。
+
+`/clear` をトリガーにした **自動かつ軽量な引継ぎ** を実現する計画。
+2026-05-08 セッションの議論と実機検証、外部仕様調査に基づく。
+A 案 (= /clear で自動引継ぎ + /tl は逃げ道として残す + /tl-trim 廃止) **採択確定**。
+
+> 過去の経緯 (なぜ `/tl` バトンを採用したか) は [03_inheritance_on_clear_only.md](03_inheritance_on_clear_only.md) を参照。
+> 本書は **2026-05-08 時点の現状検証 + 新理想設計** を扱う。
+
+> **2026-05-09 (v0.4.1) update**: 2 経路の優先順位を **入れ替えた**。
+> baton path が **primary**、auto path は **fallback**。理由: typed `/clear`
+> は UserPromptSubmit に届くので baton 書き込みで確定的に当該セッションを
+> 指名できる。一方 VSCode 拡張のメニュー由来 `/clear` は UserPromptSubmit
+> に届かない (= `findLatestClaudePredecessor` heuristic が誤った前任を選ぶ
+> リスクあり) ため、auto path を残してフォールバック化した。typed `/clear`
+> も UserPromptSubmit hook で baton を書く ([src/prompt-submit.mjs](../../src/prompt-submit.mjs))。
+> `THROUGHLINE_DISABLE_AUTO_HANDOFF=1` は **fallback path のみに作用** する
+> ようになった (typed `/clear` / `/tl` には効かない)。
+
+> **2026-08-17 (ADR 0021 / v0.10.0)**: 本書は Claude `/clear`・`/tl` の現行仕様である。
+> Grok は UserPromptSubmit stdout をモデルへ渡さない。Grok `/tl` の記憶再開は
+> `throughline grok-continue` であり、本書の「次セッション初回プロンプトで注入」を
+> Grok に適用しない。正本は [ADR 0021](../adr/0021-grok-host-capture.md) と
+> [plan_grok-successor-launch.md](plan_grok-successor-launch.md)。
+
+> **2026-07-18 (ADR 0016) update**: 注入の中身を push/pull 二段に再設計した。
+> push (9,500 字) はヘッダ + 現在地アンカー + 案内セクション + **L2 をターン原子で
+> 入るだけ全文**（L1 は注入しない）。窓 20 ターンの残りは `throughline recall --l2`、
+> それより古い全ターンは `recall --l1`（要約 or 未要約明示）で pull する。範囲・境界
+> (ISO ms)・件数・session は注入時に案内コマンドへ焼き込み、recall 側は窓を再計算
+> しない。正典は [ADR 0016](../adr/0016-push-pull-recall-injection.md)。本書内の
+> 「L1 + L2 を注入する」旧記述はこの update で読み替えること。
+
+---
+
+## 1. 確定した事実 (実機検証済み)
+
+### 1.1 `/clear` 後の SessionStart `source` は 2.1.128 で reliable
+
+```
+inheritance-decision.log (2026-05-08 12:26 検証)
+  12:26:08.481Z  source="startup"   session=05735717  ← 新 chat 開始
+  12:26:52.257Z  source="clear"     session=b2addc4a  ← /clear 後
+```
+
+- Claude Code `2.1.128` (VSCode native extension, Linux/WSL2) で `/clear` 後の SessionStart は **確実に `source='clear'`** を payload に乗せる
+- 過去の [GitHub issue #49937](https://github.com/anthropics/claude-code/issues/49937) (= VSCode 拡張で /clear 後も `source='startup'` になっていたバグ) は **解決済み**
+- v2.1.105 (VSCode `/clear` not clearing conversation context fix) と v2.1.126 (Windows SessionStart hook env files apply) のリリースで段階的に修正された
+
+### 1.2 SessionStart `source` の 4 値 (公式 docs)
+
+| 値 | 意味 |
+|---|---|
+| `startup` | 新 chat / VSCode 再起動 / 別 project / cold start |
+| `resume` | `--resume` / `--continue` / `/resume` |
+| `clear` | `/clear` 直後 |
+| `compact` | 自動 / 手動 compaction 直後 |
+
+source: [code.claude.com/docs/en/hooks](https://code.claude.com/docs/en/hooks)
+
+### 1.3 `/clear` 等価の user-defined slash command は **作れない**
+
+調査結果 (claude-code-guide Agent + bundled `claude-code` 検査):
+
+- `.claude/commands/*.md` (skill markdown) は **prompt 拡張**であり、built-in `/clear` を programmatic に invoke できない
+- "subcommand" や "exec built-in" 構文は無い
+- `/clear` には built-in alias が存在しない
+- CLI flag `claude clear` も無い
+- cross-platform で「新ウィンドウ起動」する built-in も無い (`/branch` は full history copy で軽量化と矛盾、VSCode URL scheme は VSCode 専用)
+
+→ **「引継ぎたい /clear」と「reset したい /clear」を `source` 値で区別する手段は無い**
+
+### 1.4 `/rewind` は fork 動作 (caveat 記録済み)
+
+- `/rewind` Continue 確認画面に "A new forked conversation will be created after rewinding" と明示
+- 同 thread 内 rollback ではなく、新 fork session id を生成
+- 詳細は caveat `claude-code/claude-code-rewind-fork-conversation-rollback-primitive` を参照
+- 本計画では `/rewind` は **対象外**
+
+---
+
+## 2. 採用する理想設計
+
+### 2.1 引継ぎ発火条件 (2 経路 × 二相、ADR 0014 で二相化)
+
+| 経路 | 条件 | 起動 |
+|---|---|---|
+| **baton path (primary)** | `handoff_batons` テーブルに「セッション誕生時刻基準で TTL (1 時間) 内」の baton あり (= ユーザーが `/tl` または `/clear` を打った) | `source` 値関係なく確定的に引継ぎ |
+| **auto path (fallback)** | baton 不在 + `source='clear'` + env `THROUGHLINE_DISABLE_AUTO_HANDOFF` が `'1'` でない | SessionStart 時点で凍結した前任 (transcript 実在フィルタ付き heuristic) へ引継ぎ |
+
+**二相化の理由 (ADR 0014)**: Claude Code は同一 project に短時間で複数の SessionStart を
+発火させることがあり、一部は transcript を生成しない幽霊になる。SessionStart 時点では
+実体と幽霊を判別できない (本物の transcript も hook より数百 ms 遅れて作られる) ため、
+merge・注入は「実体の証明」= 最初の UserPromptSubmit まで遅延する。
+2026-07-17 に幽霊がバトンを先取りして実セッションが記憶ゼロで始まる incident が
+同日 2 回発生した (詳細・実測は [ADR 0014](../adr/0014-two-phase-handoff-ghost-baton.md))。
+
+判定ロジック (擬似コード):
+
+```
+on UserPromptSubmit(prompt, session_id, project_path):
+  // ---- 第二相: 初回プロンプト = 実体の証明 ----
+  pending = consumePendingHandoff(session_id)   // atomic、1 セッション 1 回
+  if pending:
+    baton = consumeBaton(project_path, bornAt = pending.created_at)
+      // age = bornAt - baton.created_at。0 ≤ age ≤ TTL のみ消費。
+      // age < 0 (自分の誕生後に書かれた baton) は本来の後継のため残置
+    if baton.sessionId:
+      merge + inject(budgeted_memory_from(baton.sessionId))   // baton path
+    elif pending.auto_predecessor_id:
+      merge + inject(budgeted_memory_from(pending.auto_predecessor_id))  // auto path
+  // ---- 従来のバトン書き込み (第二相の後) ----
+  if isBatonCommand(prompt) or isClearCommand(prompt):
+    writeBaton(project_path, session_id, now)
+
+on SessionStart(source, session_id, project_path):
+  // ---- 第一相: intent 登録のみ。merge も注入もしない ----
+  auto_predecessor = null
+  if source == 'clear' and env.THROUGHLINE_DISABLE_AUTO_HANDOFF != '1':
+    auto_predecessor = findLatestClaudePredecessor(project_path, session_id)
+      // transcript 実在フィルタ付き: 幽霊 twin (transcript 無し) を前任に選ばない
+  registerPendingHandoff(session_id, project_path, source, auto_predecessor)
+```
+
+baton 消費が auto 判定より先発なので「両方同時成立」は構造上発生しない。typed `/clear` も
+UserPromptSubmit hook で baton を書くため、通常はほぼ常に baton path が走る。auto path は
+VSCode 拡張のメニュー由来 `/clear` のように UserPromptSubmit に届かない経路のためのフォールバック。
+幽霊セッションはプロンプトを発火しないため第二相に到達できず、pending 行 (数百バイト) が
+無害に残るだけになる。TTL ベースの pending GC は置かない (長時間 idle 後の初回プロンプトから
+引継ぎを silent に奪う fallback になるため)。
+
+### 2.2 注入内容: 現在地アンカー + L1 + L2 + L3 refs (baton/auto どちらの経路でも同一)
+
+含める (順序):
+- ヘッダ + Reading Contract framing (= Codex 側 `renderCodexRolloutMemoryPreview` の写像)
+- **現在地アンカー** (v0.4.12+): 最新 user turn と最新 assistant turn の本文をヘッダ直下に再掲 (各 600 字で truncate)
+- **L1 summaries** (古い turn の一行要約)
+- **L2 bodies** (直近 20 turn の verbatim)
+- **L3 references** (= `throughline detail <時刻>` の取り出しコマンド一覧、各 L1/L2 行末尾の inline suffix として集約)
+- Continuation Instruction (= 「これは過去ログではなく現在進行中の作業」と明示)
+
+**注入予算 (ADR 0014)**: hook stdout は約 10,000 字超で `<persisted-output>`
+(ファイルパス + 先頭 2KB preview) に file 化され、モデル可視が先頭 2KB に劣化する
+(実測: 9,501 字 inline 通過 / 15,286 字 file 化。v2.1.195 以降の 10k 超注入 12/12 が劣化)。
+注入は `buildBudgetedResumeContext` (上限 9,500 字) で行い、ヘッダ + アンカーは常に全文、
+L1 → L2 の順に新しい側から予算まで詰める。省略行数は注入文内と decision log に明示する。
+
+含めない (= 削除):
+- 中断直前の in-flight memo (memo セクション)
+- 中断直前の thinking (extended thinking セクション)
+- 既存の Claude 向け footer の冗長な使い方説明
+
+理由:
+- L2 末尾アンカーだけだと、L2 が長いセッションで注意が前半 (= L2 内の最古ターン) に固着し、古い計画ターンを「現在の作業」と誤認するケースがあった (実観測あり)。最新ターンをヘッダ直下にも再掲して、最初に目に入る位置で文脈を固定する。
+- L2 全文があれば最後の assistant turn 自体に「次に何をしようとしていたか」が含まれている。memo / thinking は redundant。
+
+### 2.3 `/tl` の役割: **残すが簡素化**
+
+- `/tl` slash command 自体は **維持** (= 明示意思マーカー = baton path のトリガー)
+- 簡素化:
+  - memo 4 項目入力要求を **削除** ([.claude/commands/tl.md](../../.claude/commands/tl.md) を「baton 立てるだけ」の最小実装に)
+  - `save-inflight` CLI を **削除** (memo を baton.memo_text に保存する役目だった)
+  - `handoff_batons.memo_text` 列を **drop** (schema v8 migration)
+  - `src/baton.mjs` の `updateBatonMemo` 関数を **削除** (memo_text 列が drop されるため)
+- `prompt-submit.mjs` の baton 書き込み path は **維持** (`UserPromptSubmit` hook で `/tl` 検出 + writeBaton)
+- v0.4.1 で `/clear` も同じ hook で baton を書くように拡張 ([src/prompt-submit.mjs](../../src/prompt-submit.mjs) `isClearCommand`)
+
+ユーザーから見た `/tl` の使い方:
+- typed `/clear` (デフォルト): `/clear` を打った時点で baton が書かれ、次セッションが確定的に引継ぐ。`/tl` を打つ必要なし
+- VSCode メニュー `/clear` 経由: UserPromptSubmit に届かないので baton は書かれず、auto path (fallback) が `findLatestClaudePredecessor` で前任を選ぶ
+- 非 `/clear` 境界 (新規 chat / VSCode 再起動): `/tl` で baton を立ててから新セッションを開く
+- env で auto OFF: typed `/clear` / `/tl` は引き続き動く (env は fallback 専用)
+
+### 2.4 `/tl-trim` 廃止 (Codex 側を壊さない)
+
+- 元機能: memo 入力 + dry-run preview 表示
+- 新仕様で memo 廃止 + 軽量化方針 → 役割なし
+- 削除対象:
+  - `.claude/commands/tl-trim.md` (deleted slash command)
+  - [src/cli/trim.mjs](../../src/cli/trim.mjs) の **Claude path 部分のみ** 削除 (`describeTrimHost('claude')` ブランチ、Claude 用 memory preview 経路など)
+  - 関連 test
+- **維持** (Codex 側を壊さないため):
+  - [src/cli/trim.mjs](../../src/cli/trim.mjs) の Codex path (`--host codex`, `--codex-thread-id`, `--preflight`, `--execute`, etc.) はすべて維持
+  - [src/trim-model.mjs](../../src/trim-model.mjs) の `describeTrimHost('codex')` / `buildTrimPlan` の Codex 関連
+  - [src/codex-app-server.mjs](../../src/codex-app-server.mjs), [src/codex-rollout-memory.mjs](../../src/codex-rollout-memory.mjs), `codex-*` CLI 全般
+  - `bin/throughline.mjs` の `trim` dispatch (Codex 経路で必要)
+  - Codex skill ([codex/skills/throughline](../../codex/skills/throughline)) の trim 機能 (= 機能自体は無変更、SKILL.md 内の `/tl-trim` 言及があれば 4 TODO で update)
+
+### 2.5 `THROUGHLINE_DISABLE_AUTO_HANDOFF` env var
+
+- 値が `'1'` のとき auto path を skip
+- それ以外の値、または未設定 → auto path 有効 (= デフォルト ON)
+- 判定箇所: [src/session-start.mjs](../../src/session-start.mjs)
+- 設定方法: ユーザーが `.bashrc` / `.zshrc` / VSCode terminal env / `~/.claude/settings.json` の `env` セクションで設定
+
+### 2.6 トレードオフ (受容する)
+
+- ⚠️ 「reset したい /clear」も auto path で引継ぎ発火する → 受容 (= 不要なら env で OFF)
+- ⚠️ baton TTL は 1 時間 (= 既存仕様維持)
+
+---
+
+## 3. 確定した内部判断
+
+### 3.1 `/rewind` source 検証 — 不要
+
+A 採択により本計画は `/rewind` を扱わない。`/rewind` 後の `source` 値は将来要件で再検討。
+
+### 3.2 `handoff_batons` テーブル — 残す + memo_text 列だけ drop
+
+- table 自体は baton path で必要なので **維持**
+- `memo_text TEXT` 列を schema v8 migration で drop
+- 既存の memo データは廃棄 (受容)
+- **SQLite DROP COLUMN 互換確認必須**: `ALTER TABLE ... DROP COLUMN` は SQLite 3.35.0+ で利用可。Node.js v22.5+ 同梱の SQLite バージョンで動作するか実装時に検証
+
+### 3.3 旧 `/tl` ユーザー移行 — `/tl` 自体は continue、memo 関連だけ breaking
+
+- `/tl` slash command 自体は使い続けられる (簡素化されただけ)
+- 廃止される機能: memo 4 項目入力、`save-inflight` CLI、`/tl-trim`
+- breaking change として CHANGELOG に明示
+
+### 3.4 `source='compact'` 扱い — 引継ぎしない
+
+auto-compaction は Claude Code 内部の context 圧縮で、conversation 連続性は host 側が担保している。Throughline 側で別途引継ぎを発火する必要なし。
+
+### 3.5 ログファイルの扱い
+
+- `~/.throughline/logs/inflight-memo.log`: `save-inflight` CLI 削除で **新規書き込みなし**。既存ファイルは削除提案を README / CHANGELOG に書く (= 自動削除はしない、ユーザー手動)
+- `~/.throughline/logs/inheritance-decision.log` 内の `baton_has_memo` フィールド: memo 廃止で意味を失うため、`logDecision()` から **削除**
+- `~/.throughline/logs/baton-write.log`: 維持 (= `/tl` baton 書き込みログとして引き続き有用)
+
+---
+
+## 4. 実装 TODO (実装開始可)
+
+優先度順:
+
+- [ ] **schema v8 migration** ([src/db.mjs](../../src/db.mjs)): `ALTER TABLE handoff_batons DROP COLUMN memo_text`
+  - SQLite 3.35.0+ サポート確認 (Node.js v22.5+ 同梱版)
+  - 動かない場合は `CREATE TABLE` + `INSERT SELECT` + `DROP` の rebuild migration に切り替え
+- [ ] **`src/baton.mjs`**:
+  - `consumeBaton` 戻り値から `memoText` プロパティを削除
+  - `updateBatonMemo` 関数を **削除**
+  - `BATON_TTL_MS`, `writeBaton`, `consumeBaton` は維持
+- [x] **`src/handoff-record.mjs`**: **維持** (Codex 側 codex-handoff.mjs / codex-resume / codex-handoff-smoke 等が `memory.inflightMemo` / `memory.latestThinking` を参照しているため、削除すると Codex を壊す)。Claude 側で「使わない」のは resume-context.mjs 側で実現済み
+- [ ] **`src/resume-context.mjs`**: 注入テキストを新仕様に書き換え:
+  - memo セクション削除
+  - thinking セクション削除
+  - L3 references 一覧追加 (Codex `renderCodexRolloutMemoryPreview` 形式)
+  - footer 簡素化 (Continuation Instruction だけ残す)
+- [ ] **`src/session-start.mjs`** を 2.1 のロジックに改修:
+  - `consumeBaton` 先発 → `baton.sessionId` あれば inject
+  - 無ければ `source==='clear'` かつ env が `'1'` でない場合に inject
+  - それ以外は何もしない
+  - `logDecision()` から `baton_has_memo` フィールド削除
+- [ ] **`src/cli/save-inflight.mjs`** 削除
+- [ ] **`bin/throughline.mjs`** の `save-inflight` dispatch 削除 (`trim` dispatch は **維持**)
+- [ ] **`src/prompt-submit.mjs`**: 維持 (baton 書き込み + ensureMonitorTaskFile)
+- [ ] **[.claude/commands/tl.md](../../.claude/commands/tl.md)**: memo 4 項目入力要求を削除、純粋に「baton 立てるだけ」の最小実装に書き換え
+- [x] **`/tl-trim` 関連削除**:
+  - `.claude/commands/tl-trim.md` ファイル削除
+  - **`src/cli/trim.mjs` 自体は維持**: Codex 経路 (`--host codex`, `--preflight`, `--execute`, `--codex-app-server-bin` 等) と doctor `--trim --host claude` で使う `describeTrimHost('claude')` の dry-run 表示が依存しているため、コード削除はしない (= ユーザーが直接 `throughline trim --host claude --dry-run` を打つ余地は残す。実用は SessionStart 自動経路に置き換わる)
+- [ ] **[src/cli/install.mjs](../../src/cli/install.mjs)**: Throughline 管理 slash commands の copy 対象リストから `tl-trim.md` を除外。`tl.md` は維持。`src/cli/install.test.mjs` の関連 test も update
+- [ ] **[bin/throughline.mjs](../../bin/throughline.mjs) の `showHelp()` 文言 update**:
+  - `save-inflight` 関連 help 文言を削除
+  - `/tl-trim` / Claude trim 関連の help 文言を削除
+  - Codex trim 関連 (`trim --dry-run`, `--preflight`, `--execute --host codex` など) は **維持**
+  - `bin/throughline.mjs` の `save-inflight` dispatch case 削除 (上の TODO と重複するが help text だけ別作業)
+- [ ] **[codex/skills/throughline/SKILL.md](../../codex/skills/throughline/SKILL.md)**: `/tl-trim` への言及があれば削除し、`throughline trim --execute --host codex` 直接呼び出しに統一。Codex 側 trim 案内自体は維持
+- [ ] **[.codex-sidecar.yml](../../.codex-sidecar.yml)** 確認: `/tl-trim` / `save-inflight` 経路の参照があれば削除。無ければ no-op
+- [ ] **テスト全部更新**:
+  - `src/baton.test.mjs` → memo 関連 test 削除、`updateBatonMemo` test 削除
+  - `src/session-merger.test.mjs` → source='clear' 自動経路の test 追加
+  - `src/resume-context.test.mjs` → memo/thinking 削除を反映
+  - `src/handoff-record.test.mjs` → projection 簡素化
+  - `src/hook-entrypoints.test.mjs` → save-inflight subprocess test ケース削除 (= 独立ファイルではなく本ファイル内の test)
+  - `src/turn-processor.test.mjs` → 既存維持
+  - `src/trim-cli.test.mjs` / `src/trim-model.test.mjs` → Claude path 関連テストのみ削除、Codex 経路テストは維持
+  - 新規: env var 判定 test、source='clear' auto path test
+- [ ] **docs 更新**:
+  - [CLAUDE.md](https://github.com/kitepon/Throughline/blob/main/CLAUDE.md): 設計の核を書き換え (「`/tl` バトンのみ」→「`source='clear'` 自動 + `/tl` 逃げ道」)
+  - [README.md](../../README.md): 以下範囲を update:
+    - Quick Start: 「`/clear` で自動引継ぎ」中心に書き直し
+    - 「Explicit handoff via `/tl`」セクション: `save-inflight` / memo 4 項目要求の記述を削除、`/tl` は逃げ道として簡素な記述に
+    - Troubleshoot / How it compares 等の他セクション: `/tl-trim`, `save-inflight`, `inflight-memo.log` への言及をすべて削除
+    - `THROUGHLINE_DISABLE_AUTO_HANDOFF` env var 紹介を新規追加
+    - 既存 `inflight-memo.log` ファイルは新版で書き込み停止することを README で告知 (= 手動削除提案)
+  - [CHANGELOG.md](../../CHANGELOG.md): breaking change を明示 (memo 廃止、save-inflight 削除、/tl-trim 削除、`updateBatonMemo` 削除、baton_has_memo フィールド削除)
+  - [03_inheritance_on_clear_only.md](03_inheritance_on_clear_only.md): 「2026-04 段階の検証 → 2026-05 でバグ修正により案 A 成立、本書は履歴扱い」note 追加
+  - [04_public_release_plan.md](../04_public_release_plan.md): version bump + breaking change 反映
+- [ ] **package.json**: **0.4.0** に bump (semver minor、pre-1.0 の breaking)
+- [ ] **caveat 記録**: 「`/clear` SessionStart `source` は 2.1.128 で reliable、過去 #49937 は fix 済み」を public で記録
+
+---
+
+## 5. 削減できるコード規模 (見積もり)
+
+廃止対象:
+- `src/cli/save-inflight.mjs` (~80 行) → 削除
+- `src/cli/trim.mjs` の Claude path 部分 (~30 行) → 削除 (Codex path は維持)
+- `.claude/commands/tl-trim.md` (~40 行) → 削除
+- `src/baton.mjs` の `updateBatonMemo` 関数 (~10 行) → 削除
+- `handoff_batons.memo_text` 列 (schema migration、コードへの影響は consumeBaton 戻り値変更のみ)
+- `src/hook-entrypoints.test.mjs` 内 save-inflight test ケース (~30 行) → 削除
+- `resume-context.mjs` の memo/thinking セクション (~30 行) → 削除
+- `handoff-record.mjs` の memo/thinking projection (~50 行) → 削除
+- [.claude/commands/tl.md](../../.claude/commands/tl.md) の memo 4 項目要求 (~20 行) → 削除
+
+代わりに追加:
+- `session-start.mjs` の env / source 判定 (~15 行)
+- `resume-context.mjs` の L3 refs framing (~30 行)
+
+純減 ~245 行。
+
+---
+
+## 6. Codex 側との整合 (壊さない)
+
+Codex 側 v0.3.25 の以下は本計画で **完全に無変更**:
+
+- `codex-capture` / `codex-summarize` / `codex-resume` (Codex primary L1/L2/L3 path)
+- `codex-resume --format handoff` (新規 Codex thread 用 prompt)
+- `trim --execute --host codex` / `--preflight --host codex` (app-server `thread/rollback` + `thread/inject_items`)
+- Codex Stop hook 75% auto-refresh
+- restore-safety / host primitive audit diagnostics
+- Codex skill ([codex/skills/throughline](../../codex/skills/throughline)) の trim 機能 (= 機能自体は無変更、SKILL.md 内の `/tl-trim` 言及があれば 4 TODO で update)
+- [src/codex-app-server.mjs](../../src/codex-app-server.mjs), [src/codex-rollout-memory.mjs](../../src/codex-rollout-memory.mjs)
+- [src/trim-model.mjs](../../src/trim-model.mjs) の Codex 関連 (`describeTrimHost('codex')`, `buildTrimPlan` の Codex source path)
+
+`codex-resume --memo-stdin` は引き続きユーザーが stdin で memo を流す経路。Throughline DB の baton.memo_text には依存していない (= 列削除の影響なし)。
+
+`/tl-trim` 削除に伴って Codex 経由でも slash command としての `/tl-trim` は使えなくなる。Codex 用 trim は `throughline trim --execute --host codex` を **CLI 直接呼ぶ**運用に統一 (Codex skill SKILL.md がそれを案内する)。
+
+---
+
+## 7. 進め方
+
+1. **本計画 確定** (ユーザー A 採択済み、本書 update により方針固定)
+2. **実装** (上記 TODO 順)
+3. **テスト + 実機 smoke + commit**
+4. **publish** (npm 0.4.0 として release)
+
+実機 smoke 手順:
+- 自動引継ぎ ON (デフォルト): /clear → 新セッションで curated memory 注入を確認
+- 自動引継ぎ OFF: env を立てて /clear → 注入されないことを確認
+- baton path: `/tl` を打って新 chat タブで開く → baton 経由で注入を確認
+- Codex 側 regression: `npm test` で既存 Codex test がすべて pass することを確認、`throughline trim --execute --host codex` の CLI 動作も維持

package/docs/{03_inheritance_on_clear_only.md → archive/03_inheritance_on_clear_only.md}

@@ -13,7 +13,7 @@
 > メニュー由来 `/clear` のように UserPromptSubmit に届かない経路のための
 > fallback で、`THROUGHLINE_DISABLE_AUTO_HANDOFF=1` で OFF にできる (typed
 > `/clear` / `/tl` は env と無関係に引き続き発火する)。詳細は
-> [02_clear_auto_handoff_plan.md](02_clear_auto_handoff_plan.md)。
+> [02_clear_auto_handoff_plan.md](../02_clear_auto_handoff_plan.md)。
 >
 > 本書は当時のバトン採用判断を残す履歴ドキュメント。「結局 baton primary に
 > 戻った」という結末は皮肉だが、当時の判断は VSCode 拡張側 source バグへの
@@ -29,7 +29,7 @@
 - **案 C 不成立**: SessionStart 発火時点で transcript ファイルは未作成
 - **案 D（時間差ヒューリスティック）: 撤回**。誤爆の可能性を排除できず、ユーザー明示指名の方が決定論的で意図が明確
 - **採用: バトン方式（案 E）**: 旧セッションで `/tl` スラッシュコマンドを打つと UserPromptSubmit hook が `handoff_batons` テーブルに session_id を書き込み、次の新規セッションの SessionStart が TTL 1 時間以内のバトンを消費して merge する
-  - 実装: [src/baton.mjs](../src/baton.mjs), [src/prompt-submit.mjs](../src/prompt-submit.mjs), [src/session-start.mjs](../src/session-start.mjs), [src/session-merger.mjs](../src/session-merger.mjs) (`mergeSpecificPredecessor`), [.claude/commands/tl.md](../.claude/commands/tl.md)
+  - 実装: [src/baton.mjs](../../src/baton.mjs), [src/prompt-submit.mjs](../../src/prompt-submit.mjs), [src/session-start.mjs](../../src/session-start.mjs), [src/session-merger.mjs](../../src/session-merger.mjs) (`mergeSpecificPredecessor`), [.claude/commands/tl.md](../../.claude/commands/tl.md)
   - Bash tool サブプロセスには `$CLAUDE_SESSION_ID` 相当の env が無いため、session_id は UserPromptSubmit hook payload から取得する
 - **GitHub issue**: [anthropics/claude-code#49937](https://github.com/anthropics/claude-code/issues/49937) 提出済み。修正されれば source ベースに戻す余地は残る
 
@@ -44,17 +44,17 @@ Throughline の SessionStart フックは現在 **同一 project_path の未合
 
 ## Findings (2026-04-17 時点)
 
-### 現行実装 (根拠: [src/session-start.mjs](../src/session-start.mjs), [src/session-merger.mjs](../src/session-merger.mjs))
+### 現行実装 (根拠: [src/session-start.mjs](../../src/session-start.mjs), [src/session-merger.mjs](../../src/session-merger.mjs))
 
-- [src/session-start.mjs:33](../src/session-start.mjs#L33) で payload の `source` を **読み捨てている**
-- [src/session-start.mjs:48-51](../src/session-start.mjs#L48-L51) で無条件に `mergePredecessorInto` を呼ぶ
-- [src/session-merger.mjs:68-78](../src/session-merger.mjs#L68-L78) の前任選定は「同 project_path・未合流・自分より created_at が古い・最新 updated_at」のみで、source や時間窓は見ていない
+- [src/session-start.mjs:33](../../src/session-start.mjs#L33) で payload の `source` を **読み捨てている**
+- [src/session-start.mjs:48-51](../../src/session-start.mjs#L48-L51) で無条件に `mergePredecessorInto` を呼ぶ
+- [src/session-merger.mjs:68-78](../../src/session-merger.mjs#L68-L78) の前任選定は「同 project_path・未合流・自分より created_at が古い・最新 updated_at」のみで、source や時間窓は見ていない
 
 ### 過去ログは参考扱い
 
 - `C:\Users\kite_\.throughline\spike\session-start.log` の 93 件は Opus 4.6 以前の採取で、モデル更新（現 4.7）と Claude Code バージョン更新を跨いでいる
 - 「startup 76 / resume 16 / clear 1」の分布はあくまで参考値で、現行環境の挙動として採用しない
-- コメント [src/session-start.mjs:7-10](../src/session-start.mjs#L7-L10) の「/clear 後も source='startup'」も当時の観察で、現行環境で再検証する
+- コメント [src/session-start.mjs:7-10](../../src/session-start.mjs#L7-L10) の「/clear 後も source='startup'」も当時の観察で、現行環境で再検証する
 
 ### 確定したい前提
 
@@ -64,7 +64,7 @@ Throughline の SessionStart フックは現在 **同一 project_path の未合
 
 ### 案 A: `source === "clear"` のみ引き継ぐ（シンプル案）
 
-- [src/session-start.mjs](../src/session-start.mjs) で `source !== 'clear'` なら `mergePredecessorInto` を呼ばない
+- [src/session-start.mjs](../../src/session-start.mjs) で `source !== 'clear'` なら `mergePredecessorInto` を呼ばない
 - 取りこぼし（startup で来る /clear）は許容
 - ユーザー視点: 「手動新規・VSC 再起動・一部の /clear」で真に新規、それ以外は引き継ぐ
 
@@ -92,7 +92,7 @@ Throughline の SessionStart フックは現在 **同一 project_path の未合
 
 ### 手順
 
-1. **debug ロガーを [src/session-start.mjs](../src/session-start.mjs) に一時挿入**
+1. **debug ロガーを [src/session-start.mjs](../../src/session-start.mjs) に一時挿入**
    - payload を受け取った直後（L32 の JSON.parse 直後）に `{ ts, source, session_id, transcript_path, cwd }` を `C:\Users\kite_\.throughline\logs\sessionstart-probe.log` に追記
    - 既存のマージ処理には触れない（挙動を変えずに観測だけする）
    - 1 行 1 JSON (JSONL) 形式で append
@@ -107,29 +107,29 @@ Throughline の SessionStart フックは現在 **同一 project_path の未合
    - ケース 1 に `startup` が混じる / ケース 2 または 3 に `clear` が混じる → 案 B に切り替えて時間差閾値を設計
 
 4. **debug ロガー撤去**
-   - 判定後は [src/session-start.mjs](../src/session-start.mjs) から削除（commit 分離）
+   - 判定後は [src/session-start.mjs](../../src/session-start.mjs) から削除（commit 分離）
 
 ## 実装ステップ（案 A 前提・Phase 0 通過後に実施）
 
-1. **[src/session-start.mjs](../src/session-start.mjs) 修正**
+1. **[src/session-start.mjs](../../src/session-start.mjs) 修正**
    - L33: `const { session_id, source, cwd } = payload` に変更して `source` を取得
    - L7-10 のコメントを実機ログに合わせて更新（「source='clear' のときだけ引き継ぐ。startup で来る /clear は取りこぼす」仕様を明記）
    - L48 付近: `if (source === 'clear') { mergePredecessorInto(...) }` でガード
-   - 引き継がない場合も [src/session-start.mjs:41-45](../src/session-start.mjs#L41-L45) の sessions INSERT は従来通り実行（DB には残す）
+   - 引き継がない場合も [src/session-start.mjs:41-45](../../src/session-start.mjs#L41-L45) の sessions INSERT は従来通り実行（DB には残す）
 
-2. **[src/session-merger.test.mjs](../src/session-merger.test.mjs) にテスト追加**
+2. **[src/session-merger.test.mjs](../../src/session-merger.test.mjs) にテスト追加**
    - `resolveMergeTarget` / `mergePredecessorInto` は現状維持（判定は session-start 側に持たせる）
    - 代わりに session-start.mjs の条件分岐をユニット化する。テストは薄めの統合で:
      - source='clear' → `mergePredecessorInto` が呼ばれ合流する
      - source='startup' → 呼ばれず前任 sessions の merged_into が NULL のまま
      - source='resume' → 同上
-   - 既存 [src/session-merger.test.mjs:121-151](../src/session-merger.test.mjs#L121-L151) の時系列単調性テストは引き続きパスする前提
+   - 既存 [src/session-merger.test.mjs:121-151](../../src/session-merger.test.mjs#L121-L151) の時系列単調性テストは引き続きパスする前提
 
-3. **[src/resume-context.mjs](../src/resume-context.mjs) と注入ヘッダ**
+3. **[src/resume-context.mjs](../../src/resume-context.mjs) と注入ヘッダ**
    - 注入は session-start.mjs 側の `mergeResult.merged` 分岐で既に制御されているので修正不要
    - ただし「同一 session 継続（source='resume'）での注入」が必要か要検討。現状の resume フックは本計画のスコープ外として deferred（別タスクで検討）
 
-4. **[docs/01_l1_l2_l3_redesign.md](01_l1_l2_l3_redesign.md) / [CLAUDE.md](../CLAUDE.md) / [README.md](../README.md) の更新**
+4. **[docs/01_l1_l2_l3_redesign.md](../01_l1_l2_l3_redesign.md) / [CLAUDE.md](https://github.com/kitepon/Throughline/blob/main/CLAUDE.md) / [README.md](../../README.md) の更新**
    - 「記憶張り替えの発火条件は SessionStart source='clear' のみ」を明記
    - CLAUDE.md 冒頭「設計の核」の「`/clear` 後も SQLite はそのまま残る。`SessionStart` フックで前任セッションの全レコードを新 session_id に張り替える」の直後に引き継ぎ条件を追記
 
@@ -154,15 +154,15 @@ Throughline の SessionStart フックは現在 **同一 project_path の未合
 
 ## 重要ファイル一覧
 
-- [src/session-start.mjs](../src/session-start.mjs) — 主変更箇所
-- [src/session-merger.mjs](../src/session-merger.mjs) — 参照のみ（現状維持）
-- [src/session-merger.test.mjs](../src/session-merger.test.mjs) — テスト追加
-- [src/resume-context.mjs](../src/resume-context.mjs) — 参照のみ
-- [CLAUDE.md](../CLAUDE.md) / [docs/01_l1_l2_l3_redesign.md](01_l1_l2_l3_redesign.md) / [README.md](../README.md) — ドキュメント更新
+- [src/session-start.mjs](../../src/session-start.mjs) — 主変更箇所
+- [src/session-merger.mjs](../../src/session-merger.mjs) — 参照のみ（現状維持）
+- [src/session-merger.test.mjs](../../src/session-merger.test.mjs) — テスト追加
+- [src/resume-context.mjs](../../src/resume-context.mjs) — 参照のみ
+- [CLAUDE.md](https://github.com/kitepon/Throughline/blob/main/CLAUDE.md) / [docs/01_l1_l2_l3_redesign.md](../01_l1_l2_l3_redesign.md) / [README.md](../../README.md) — ドキュメント更新
 
 ## Non-Goals (本計画では扱わない)
 
 - VSC 拡張側の source 送信挙動の調査・修正（Claude Code 本体のスコープ）
-- 並行セッション X-1 問題の解決（[docs/archive/SESSION_LINKING_DESIGN.md:194](archive/SESSION_LINKING_DESIGN.md#L194) で受容済み）
+- 並行セッション X-1 問題の解決（[docs/archive/SESSION_LINKING_DESIGN.md:194](SESSION_LINKING_DESIGN.md#L194) で受容済み）
 - source='startup' で来る /clear の取りこぼし対策（案 B/C は fallback として deferred）
 - token-monitor / sc-detail 系 CLI への影響調査（本計画と独立）

package/docs/{07_codex_trim_implementation_plan.md → archive/07_codex_trim_implementation_plan.md}

@@ -5,20 +5,20 @@
 ## この文書の位置づけ
 
 この文書は **これまでの統合実装計画と実装履歴** です。
-2026-05-06 以降の次フェーズ実装順、TODO、進捗チェックは [05_codex_first_roadmap.md](05_codex_first_roadmap.md) を正として扱う。
+2026-05-06 以降の次フェーズ実装順、TODO、進捗チェックは [05_codex_first_roadmap.md](../05_codex_first_roadmap.md) を正として扱う。
 
 元文書:
 
-- [08_codex_dual_support.md](08_codex_dual_support.md)
-- [09_rollback_context_trim_insight.md](09_rollback_context_trim_insight.md)
+- [08_codex_dual_support.md](../08_codex_dual_support.md)
+- [09_rollback_context_trim_insight.md](../09_rollback_context_trim_insight.md)
 
 関係性:
 
 | 文書 | この計画での扱い |
 |---|---|
-| [05_codex_first_roadmap.md](05_codex_first_roadmap.md) | 2026-05-06 以降の次フェーズ計画。Codex primary 実用化を先行し、Codex Rewind 互換を完成させてから Claude 側を詰める |
-| [08_codex_dual_support.md](08_codex_dual_support.md) | Claude / Codex 両対応の architecture brief。主に Phase 1-5 に対応 |
-| [09_rollback_context_trim_insight.md](09_rollback_context_trim_insight.md) | rollback trim の design insight。主に Phase 6-8 に対応 |
+| [05_codex_first_roadmap.md](../05_codex_first_roadmap.md) | 2026-05-06 以降の次フェーズ計画。Codex primary 実用化を先行し、Codex Rewind 互換を完成させてから Claude 側を詰める |
+| [08_codex_dual_support.md](../08_codex_dual_support.md) | Claude / Codex 両対応の architecture brief。主に Phase 1-5 に対応 |
+| [09_rollback_context_trim_insight.md](../09_rollback_context_trim_insight.md) | rollback trim の design insight。主に Phase 6-8 に対応 |
 
 この計画は両者の合流点であり、Claude contract 固定を先行させる。rollback trim は実測 spike を通るまで本線実装にしない。
 
@@ -45,7 +45,7 @@ rollback trim は最終的な理想に近いが、host primitive の実測が必
 - Claude hooks、slash command、transcript parsing、handoff baton、SessionStart resume behavior を Codex 用に置き換えない。
 - Claude-facing field / command / DB semantics を rename しない。
 - Codex 対応は adapter / projection として足す。
-- `thread/rollback` / `thread/inject_items` は live host primitive として実測済み。2026-05-06 incident 後に Codex guarded execute / auto-refresh は一時停止したが、2026-05-08 の controlled rollback model-visible smoke が再現しなかったため、過剰 blocker は解除済み。現在は [06_codex_trim_rollback_fix_plan.md](06_codex_trim_rollback_fix_plan.md) を優先し、DB memory を必須にする。rollout/app-server turn-count mismatch は診断と app-server count 由来の rollback `numTurns` 補正に使う。Claude `/rewind` 自動化はまだ有効化しない。
+- `thread/rollback` / `thread/inject_items` は live host primitive として実測済み。2026-05-06 incident 後に Codex guarded execute / auto-refresh は一時停止したが、2026-05-08 の controlled rollback model-visible smoke が再現しなかったため、過剰 blocker は解除済み。現在は [06_codex_trim_rollback_fix_plan.md](../06_codex_trim_rollback_fix_plan.md) を優先し、DB memory を必須にする。rollout/app-server turn-count mismatch は診断と app-server count 由来の rollback `numTurns` 補正に使う。Claude `/rewind` 自動化はまだ有効化しない。
 - fallback や silent recovery で失敗を隠さない。互換モードは条件と理由を明示する。
 
 ## 運用ルール
@@ -370,7 +370,7 @@ Phase 6 result (2026-05-06):
 - `thread/rollback` は persisted thread を直接対象にすると `thread not found` を返す。`thread/resume` で loaded thread にしてから呼ぶ必要がある。
 - 検証 thread `019dfaba-f87e-7f41-a144-d5ca7c6dd7f9` で、1 turn を `thread/rollback { numTurns: 1 }` し、`thread/read includeTurns:true` が 0 turns を返すことを確認した。
 - `thread/inject_items` に raw Responses API item `{ type: "message", role: "developer", content: [{ type: "input_text", text: "..." }] }` を渡し、次の `turn/start` で injected memory が model-visible になることを確認した。marker `TL_PHASE6_INJECT_OK` を正しく返した。
-- その後の Codex primary 実装で、`codex-resume` が描画する active-work developer message も実 Codex host で model-visible になることを確認した。marker `TL_CODEX_VISIBLE_REAL_20260506_C` が `item/agentMessage/delta` に出た。詳細な実測値は [05_codex_first_roadmap.md](05_codex_first_roadmap.md) の Phase 3 result を正とする。
+- その後の Codex primary 実装で、`codex-resume` が描画する active-work developer message も実 Codex host で model-visible になることを確認した。marker `TL_CODEX_VISIBLE_REAL_20260506_C` が `item/agentMessage/delta` に出た。詳細な実測値は [05_codex_first_roadmap.md](../05_codex_first_roadmap.md) の Phase 3 result を正とする。
 - さらに `thread/inject_items` 後にもう一度 `thread/resume` してから `turn/start` を呼ぶ smoke も追加し、実 Codex host で marker `TL_CODEX_RESUME_AFTER_INJECT_REAL_20260506` が `item/agentMessage/delta` に出ることを確認した。
 - Codex host primitive は live app-server 上では実測済み。ただし restart-safe durability は未証明。現在は明示 `--codex-thread-id` または env thread identity と Throughline DB memory が live mutation の最低条件であり、rollout/app-server turn-count mismatch は診断と rollback `numTurns` 補正に使う。durable success は別分類で扱う。2026-05-06 incident 後はいったん Codex Stop hook 後の automatic refresh mutation を blocked としたが、2026-05-08 unblock 後は guarded rollback / inject を試行する。2026-05-09 以降は Codex native auto-compact より先に Throughline refresh を走らせるため、verified usage 75% 以上を既定閾値にする。
 - Claude `/rewind conversation only` は手動 UX として扱う。外部ツールからの自動化 surface は未確認。Claude host の automatic rollback / inject は `manual-only`。

package/docs/{10_transcript_injection_plan.md → archive/10_transcript_injection_plan.md}

@@ -81,10 +81,10 @@ Anthropic Messages API 公式 docs ([Working with Messages](https://platform.cla
 
 本計画の transcript inject は **Claude session** (= 非 `codex:*` の session_id) の `~/.claude/projects/<proj-slug>/<session-id>.jsonl` への append のみを扱う。Codex session (`codex:<thread_id>`) は対象外。理由:
 
-- Codex は SessionStart hook を持たない ([src/cli/install.mjs](../src/cli/install.mjs) の Codex hook 登録は `UserPromptSubmit` / `PostToolUse` / `Stop` のみ)。よって `/clear` 後の hook タイミングで append する経路自体が存在しない
+- Codex は SessionStart hook を持たない ([src/cli/install.mjs](../../src/cli/install.mjs) の Codex hook 登録は `UserPromptSubmit` / `PostToolUse` / `Stop` のみ)。よって `/clear` 後の hook タイミングで append する経路自体が存在しない
 - Codex rollout JSONL の format は Anthropic Messages API 互換ではなく `event_msg` / `function_call` 系の独自構造で、user/assistant role 復元の対象として扱えない
 - Codex の context refresh は既に `trim --execute --host codex` の rollback + memory inject 経路で別解決されている (現行 v0.4.x の仕組みを維持)
-- Claude predecessor lookup は元から `session_id NOT LIKE 'codex:%'` で Codex を除外しているため ([src/session-start.mjs:53-67](../src/session-start.mjs#L53-L67))、Claude session と Codex session が相互に merge されることはない
+- Claude predecessor lookup は元から `session_id NOT LIKE 'codex:%'` で Codex を除外しているため ([src/session-start.mjs:53-67](../../src/session-start.mjs#L53-L67))、Claude session と Codex session が相互に merge されることはない
 
 **ドキュメント反映**: Phase 3-1 で CHANGELOG / README に「v0.5.0 の transcript inject は Claude session 限定。Codex session の引き継ぎは v0.4.x と同じ rollout-based refresh を継続」を明示する。
 
@@ -114,7 +114,7 @@ Anthropic Messages API 公式 docs ([Working with Messages](https://platform.cla
 - [ ] Phase 0-2: `/clear` 直後 SessionStart hook タイミングでの append spike (本計画の根本条件)
   - [ ] 検証用の throwaway Throughline DB session 1 件を仕込む (user turn 1 件 + assistant turn 1 件)
   - [ ] Throughline session-start.mjs に spike モードの分岐を一時追加: 「stdout 注入の代わりに transcript_path へ user/assistant turn を append する」
-  - [ ] **spike モードの起動方法**: 環境変数は使わない (Claude Code が VSCode 拡張から起動された場合、ユーザーシェルの env が hook プロセスに伝播しない既知の問題 — [src/cli/install.mjs](../src/cli/install.mjs) で PATH 解決に苦労した経緯と同根)。代わりに marker file `~/.throughline/spike-inject.flag` の存在で判定する (cwd / parent process と独立)
+  - [ ] **spike モードの起動方法**: 環境変数は使わない (Claude Code が VSCode 拡張から起動された場合、ユーザーシェルの env が hook プロセスに伝播しない既知の問題 — [src/cli/install.mjs](../../src/cli/install.mjs) で PATH 解決に苦労した経緯と同根)。代わりに marker file `~/.throughline/spike-inject.flag` の存在で判定する (cwd / parent process と独立)
   - [ ] 実 Claude Code セッションで marker file を作成し、その状態で **`/clear` を実行**、新セッションの SessionStart hook が走るタイミングで append される状態を作る
   - [ ] 新セッション開始直後に「続きよろしく」など短い prompt を送り、Claude が **append した前回 turn を自分の過去発話として認識する** か確認
   - [ ] (補助) throwaway session で「append → 同 session 内 user prompt」も比較として実行し、`/clear` 経路と挙動が一致するか比較する。**判定の主軸は `/clear` 経路の方**
@@ -139,11 +139,11 @@ Anthropic Messages API 公式 docs ([Working with Messages](https://platform.cla
 Phase 0 が go の場合のみ着手。
 
 - [ ] Phase 1-0: `HandoffRecord` の拡張 (前提タスク、Phase 1-1 より先)
-  - [ ] 現行 [src/handoff-record.mjs](../src/handoff-record.mjs) の `references.l3` は `kind` / `toolName` / `sourceId` / `originSessionId` / `turnNumber` / `createdAt` / `detailCommand` のメタのみで、tool_use の `input` JSON / tool_result の出力テキスト / image base64 などの **payload 本体は含まれていない**
+  - [ ] 現行 [src/handoff-record.mjs](../../src/handoff-record.mjs) の `references.l3` は `kind` / `toolName` / `sourceId` / `originSessionId` / `turnNumber` / `createdAt` / `detailCommand` のメタのみで、tool_use の `input` JSON / tool_result の出力テキスト / image base64 などの **payload 本体は含まれていない**
   - [ ] L3 を transcript JSONL に復元するため、新フィールド `references.l3Payloads` (または `references.l3` 内に `inputText` / `outputText` を opt-in 追加) として projection を新設。`tool_use.id` ↔ `tool_result.tool_use_id` の対応関係 (= `source_id` の chain) も含める
   - [ ] `handoff-record.test.mjs` の既存テストを破壊しない範囲で拡張 (追加フィールドの opt-in)
   - [ ] payload を持つ projection は **transcript inject 経路でのみ使う**。Codex projection 等の他の利用先は既存 shape を維持する
-  - [ ] **既存利用先の test 追加**: [src/codex-handoff.mjs:130, 259, 352](../src/codex-handoff.mjs) は `record.references.l3` を `groupL3ByTurn` / `toDetailReference` に渡しているため、`src/l3-summary.mjs` の `groupL3ByTurn` が新フィールドを無視することを `codex-handoff.test.mjs` または `l3-summary` の専用 test で固定する
+  - [ ] **既存利用先の test 追加**: [src/codex-handoff.mjs:130, 259, 352](../../src/codex-handoff.mjs) は `record.references.l3` を `groupL3ByTurn` / `toDetailReference` に渡しているため、`src/l3-summary.mjs` の `groupL3ByTurn` が新フィールドを無視することを `codex-handoff.test.mjs` または `l3-summary` の専用 test で固定する
 - [ ] Phase 1-1: `src/transcript-writer.mjs` 新規作成
   - [ ] 引数: `targetJsonlPath`, `record: HandoffRecord`, `newSessionId`, `cwd`, `version`, `gitBranch`
   - [ ] `HandoffRecord` の L2 (`recentBodies`) を user/assistant の JSONL 行に変換
@@ -154,7 +154,7 @@ Phase 0 が go の場合のみ着手。
   - [ ] **idempotency**: 既に同 `origin_session_id` の turn が target JSONL に存在すれば no-op (重複 inject 防止)
 - [ ] Phase 1-2: `src/session-start.mjs` の改修 (Phase 0-4 結果が go の場合のみ着手、純機能追加)
   - [ ] **Phase 0-4 が go (= hook が書いた行が Claude Code 側で保持され、chain 設計が成立) でない限り、Phase 1-2 には着手しない**。NG なら §4 撤退条件を発動し本計画 v0.5 は終了する
-  - [ ] 現行 [src/session-start.mjs:91](../src/session-start.mjs) では `payload` から `transcript_path` を destructure していない。Phase 1-2 で取得を追加する
+  - [ ] 現行 [src/session-start.mjs:91](../../src/session-start.mjs) では `payload` から `transcript_path` を destructure していない。Phase 1-2 で取得を追加する
   - [ ] **実装順序の厳守** (現行 v0.4.12 体験を 100% 保証するため):
     1. 先に `process.stdout.write(text + '\n')` を**完全に**実行する (現行 v0.4.12 と完全同一の stdout 出力。L2 verbatim を含む全部)
     2. その**後**で `transcriptWriter.injectInto(transcript_path, record, session_id, ...)` を呼ぶ
@@ -215,12 +215,12 @@ Phase 0 が go の場合のみ着手。
 
 ## 5. 関連 docs
 
-- [docs/02_clear_auto_handoff_plan.md](02_clear_auto_handoff_plan.md) — v0.4 系の baton/auto path 現行仕様 (本計画で部分上書きされる)
-- [docs/01_l1_l2_l3_redesign.md](01_l1_l2_l3_redesign.md) — L1/L2/L3 記憶レイヤー設計 (本計画で SessionStart 注入の分担が変わる)
-- [docs/04_public_release_plan.md](04_public_release_plan.md) — §0 フォールバック禁止ルール、CLI 設計
-- [src/resume-context.mjs](../src/resume-context.mjs) — 現行の system 側注入 builder (**v0.5 で変更なし**)
-- [src/session-start.mjs](../src/session-start.mjs) — 注入の呼び出し元 (v0.5 で transcript writer 呼び出しを stdout 注入の直後に追加)
-- [src/handoff-record.mjs](../src/handoff-record.mjs) — 注入の中間表現 (v0.5 で L3 payload を opt-in 追加)
+- [docs/02_clear_auto_handoff_plan.md](../02_clear_auto_handoff_plan.md) — v0.4 系の baton/auto path 現行仕様 (本計画で部分上書きされる)
+- [docs/01_l1_l2_l3_redesign.md](../01_l1_l2_l3_redesign.md) — L1/L2/L3 記憶レイヤー設計 (本計画で SessionStart 注入の分担が変わる)
+- [docs/04_public_release_plan.md](../04_public_release_plan.md) — §0 フォールバック禁止ルール、CLI 設計
+- [src/resume-context.mjs](../../src/resume-context.mjs) — 現行の system 側注入 builder (**v0.5 で変更なし**)
+- [src/session-start.mjs](../../src/session-start.mjs) — 注入の呼び出し元 (v0.5 で transcript writer 呼び出しを stdout 注入の直後に追加)
+- [src/handoff-record.mjs](../../src/handoff-record.mjs) — 注入の中間表現 (v0.5 で L3 payload を opt-in 追加)
 
 ---