throughline 0.13.0 → 0.14.1

package/CHANGELOG.md

@@ -10,6 +10,49 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.14.1] — 2026-10-05
+
+### 修正
+
+- Claude Codeの自動継続で、後継が完了済みの作業をやり直すことがあった不具合を直す。0.14.0は、止めたターンについて「止める直前の発言」1つしか後継へ渡していなかった。そのターンでそこまでにした発言と道具の呼び出しは、記憶に入っていなかった。macOSの実機（Haiku 4.5）で、後継2つが読み終えたファイルを最初から読み直した。
+- Codexの自動継続と同じく、後継を立てる前に、止めたターンをDBへ取り込む。発言は全部をつないで本文（L2）に、道具の入出力は止めた道具の呼び出しまで詳細（L3）に入れる。後継は`throughline detail HH:MM:SS`で、止めたターンの入出力を取り出せる。0.14.0では、止めたターンの入出力はどこにも残らなかった。
+- 後継へ渡す現在地に、次の2つを足す。
+  - **このターンでここまでにしたこと**: 発言と道具の呼び出しを古い順に並べる。作業フォルダの中のファイルは相対で書く。多い時は新しい側から2,400字まで載せ、残りは件数にする。
+  - **止める直前に呼ぼうとして、実行されなかった道具**: 圧縮を止めた後の応答が呼んだ道具。同じ応答に並んだ道具は全部ここに入る。
+- 止めたターンは現在地にだけ載せ、直前の対話（L2）の一覧に重ねない。依頼の上限は4,000字から3,500字にする。
+
+### 追加
+
+- `throughline auto-handoff status --host claude --json`の各引き継ぎに`in_flight_captured`を足す。止めたターンをDBへ取り込めた時に`true`。取り込めなくても引き継ぎは止めず、依頼とここまでにしたことは後継へ渡る。
+
+### 確認した範囲
+
+- macOS 27.0のClaude Code。端末の会話（2.1.289）と、Claude Desktopが同梱する本体（2.1.286）を端末から起動した会話の両方から始めた。直した版で、Haiku 4.5は4回、Opus 5.5は7回、連続で引き継いで作業を完了した。読み直しも読み飛ばしも無く、どの会話でも自動圧縮は走っていない。
+- Claude Desktopの画面から始めた会話、Windows、Fable、subagentが動いている最中の引き継ぎは確かめていない。
+
+## [0.14.0] — 2026-10-05
+
+### 変更
+
+- Claude Codeの自動継続を作り直す（[ADR 0033](docs/adr/0033-claude-auto-handoff-new-session.md)）。0.13.0の方式（自動圧縮を通し、圧縮の直後に同じ会話へ記憶を注入する）は取り下げた。Throughlineは自動圧縮を置き換えるもので、圧縮が走る前に旧い会話を止め、記憶を持った新しい会話で作業を続ける。Codexの自動継続と同じ並びにした。
+  1. 自動圧縮の直前に、`PreCompact`フックが圧縮を止め、`/tl`と同じ印を残す。
+  2. `PreToolUse`フックが、旧い会話の次の道具を実行させずに止める。旧い会話は空にしない。
+  3. 同じprojectに、`claude --bg`で指示を待つ新しい会話を立てる。モデル・推論強度・権限は旧い会話から引き継ぐ。
+  4. 新しい会話の受け口へ、配送ライブラリ（`aiterm-steer-delivery` 0.1.13の`sendClaudeInbox`）で継続の指示を1通送る。届いた時に、止めた時点の依頼と直近の会話の原文を注入する。
+- `throughline auto-handoff enable --host claude`が`PreCompact`と`PreToolUse`のフックを登録し、`disable`が外す。`throughline install`は登録しない。0.13.0の`install`が置いた`PreCompact`フックは、自動継続が無効な端末の`install`で外す。
+- 続きは裏の会話で動く。`claude agents`の一覧と`claude attach <id>`で見られる。Claude Desktopの画面には出ず、後継のターンが終わって入力待ちになった後に開ける。
+- 別の会話から届いた発言（`Another Claude session sent a message:`）は、Claude Codeが後ろに付ける定型の注意書きを落として保存する。
+- 依存の`aiterm-steer-delivery`を0.1.9から0.1.13に上げる。
+
+### 0.13.0から変わらないもの
+
+- 圧縮の要約行（`isCompactSummary`）をユーザー発言として保存しない修理は、そのまま有効。
+
+### 確認した範囲
+
+- LinuxのClaude Code 2.1.289。対話画面の会話から始めて後継へ3回連続で引き継ぎ、最後の後継が作業を完了した。4つの会話のどれにも圧縮の記録は無く、止めた道具は実行されていなかった。
+- macOS・Windows、Claude Desktopから始まる会話、subagentが動いている最中の引き継ぎは確かめていない。
+
 ## [0.13.0] — 2026-10-04
 
 ### 追加
@@ -1653,7 +1696,9 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.13.0...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.14.1...HEAD
+[0.14.1]: https://github.com/kitepon/Throughline/compare/v0.14.0...v0.14.1
+[0.14.0]: https://github.com/kitepon/Throughline/compare/v0.13.0...v0.14.0
 [0.13.0]: https://github.com/kitepon/Throughline/compare/v0.12.9...v0.13.0
 [0.12.9]: https://github.com/kitepon/Throughline/compare/v0.12.8...v0.12.9
 [0.12.8]: https://github.com/kitepon/Throughline/compare/v0.12.7...v0.12.8

package/README.ja.md

@@ -52,17 +52,24 @@ throughline auto-handoff status --host claude --json
 throughline auto-handoff disable --host claude
 ```
 
-既定では無効です。`--project`を省略すると全projectを対象にします。Codexの設定とは別で、互いに影響しません。
+既定では無効です。`enable`は必要な`PreCompact`と`PreToolUse`のフックを登録し、`disable`が外します。`--project`を省略すると全projectを対象にします。Codexの設定とは別で、互いに影響しません。
 
-Claude Codeは、自動圧縮の前にhookから作業を止めることも、新しい会話へ指示を送ることもできません。自動圧縮の後は、同じ会話で作業をそのまま続けます。Throughlineは会話を切り替えず、圧縮の直後に、圧縮前の記録を同じ会話へ注入します（[ADR 0032](docs/adr/0032-claude-compact-continuation.md)）。
+自動圧縮を置き換えます。圧縮が走る前に旧い会話を止め、記憶を持った新しい会話で作業を続けます（[ADR 0033](docs/adr/0033-claude-auto-handoff-new-session.md)）。
 
-- `PreCompact`フックが、自動圧縮の時だけ印を残します。圧縮は止めません。
-- 圧縮直後の`SessionStart`（`source: "compact"`）フックが、作業途中のユーザー依頼と圧縮直前の発言、直近の会話の原文を注入します。上限は9,500字で、入り切らない古いターンは`throughline recall`の案内になります。
-- モデルは追加の入力なしで作業を続けます。圧縮の要約と記録が食い違う時は、記録を正とするよう指示します。
+1. 自動圧縮の直前に、圧縮を止めます。`/tl`と同じ印を残します。
+2. 旧い会話の次の道具を、実行させずに止めます。旧い会話は止めるだけで、空にしません。
+3. 同じprojectに、新しいClaudeの会話を裏で立てます（`claude --bg`）。モデル・推論強度・権限は旧い会話から引き継ぎます。
+4. 新しい会話へ継続の指示を1通送ります。届いた時に、止めた時点の依頼、そのターンでここまでにしたこと（発言と道具の呼び出し）、実行されなかった道具、直近の会話の原文を注入します（上限9,500字）。止めたターンの道具の入出力は、後継が`throughline detail`で取り出せます。
 
-手動`/compact`は対象に含めません。圧縮をまたいだターンは、元の依頼と最終回答の1ターンとして保存します（0.12.9以前は、圧縮の要約をユーザー発言として保存していました）。
+続きは裏の会話で動きます。`claude agents`の一覧と`claude attach <id>`で見られます。Claude Desktopの画面には出ず、後継のターンが終わって入力待ちになった後にDesktopで開けます。手動`/compact`、subagentの中の圧縮、`claude -p`などscriptから起動した会話は対象に含めません。
 
-LinuxのClaude Code 2.1.289（`claude -p`と対話画面）で実機確認済みです。macOS・Windows、VS Code拡張・Desktop、subagentの中の圧縮は未検証です。[実測と検証範囲](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-04-claude-compact-continuation.md)を参照してください。
+```bash
+throughline auto-handoff status --host claude --operation <handoff-id> --json
+```
+
+後継の立ち上げや配送に失敗した時は、固定の理由を記録して止まります。結果が不明な指示は再送しません。圧縮を止めた後にモデルが道具を呼ばずにターンを終えた時は、後継を立てません。印は残るので、1時間以内に開いた新しい会話が記憶を引き継ぎます。
+
+有効にした端末では、Claudeの道具の呼び出しのたびに`PreToolUse`フックが1回走ります。LinuxとmacOSのClaude Code（2.1.289、Claude Desktop同梱の2.1.286）で実機確認済みです。Windowsと、Claude Desktopの画面から始めた会話は未検証です。[実測と検証範囲](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-05-claude-auto-handoff.md)を参照してください。
 
 ## 所有境界
 

package/README.md

@@ -51,17 +51,24 @@ throughline auto-handoff status --host claude --json
 throughline auto-handoff disable --host claude
 ```
 
-既定では無効です。`--project`を省略すると全projectを対象にします。Codexの設定とは別で、互いに影響しません。
+既定では無効です。`enable`は必要な`PreCompact`と`PreToolUse`のフックを登録し、`disable`が外します。`--project`を省略すると全projectを対象にします。Codexの設定とは別で、互いに影響しません。
 
-Claude Codeは、自動圧縮の前にhookから作業を止めることも、新しい会話へ指示を送ることもできません。自動圧縮の後は、同じ会話で作業をそのまま続けます。Throughlineは会話を切り替えず、圧縮の直後に、圧縮前の記録を同じ会話へ注入します（[ADR 0032](docs/adr/0032-claude-compact-continuation.md)）。
+自動圧縮を置き換えます。圧縮が走る前に旧い会話を止め、記憶を持った新しい会話で作業を続けます（[ADR 0033](docs/adr/0033-claude-auto-handoff-new-session.md)）。
 
-- `PreCompact`フックが、自動圧縮の時だけ印を残します。圧縮は止めません。
-- 圧縮直後の`SessionStart`（`source: "compact"`）フックが、作業途中のユーザー依頼と圧縮直前の発言、直近の会話の原文を注入します。上限は9,500字で、入り切らない古いターンは`throughline recall`の案内になります。
-- モデルは追加の入力なしで作業を続けます。圧縮の要約と記録が食い違う時は、記録を正とするよう指示します。
+1. 自動圧縮の直前に、圧縮を止めます。`/tl`と同じ印を残します。
+2. 旧い会話の次の道具を、実行させずに止めます。旧い会話は止めるだけで、空にしません。
+3. 同じprojectに、新しいClaudeの会話を裏で立てます（`claude --bg`）。モデル・推論強度・権限は旧い会話から引き継ぎます。
+4. 新しい会話へ継続の指示を1通送ります。届いた時に、止めた時点の依頼、そのターンでここまでにしたこと（発言と道具の呼び出し）、実行されなかった道具、直近の会話の原文を注入します（上限9,500字）。止めたターンの道具の入出力は、後継が`throughline detail`で取り出せます。
 
-手動`/compact`は対象に含めません。圧縮をまたいだターンは、元の依頼と最終回答の1ターンとして保存します（0.12.9以前は、圧縮の要約をユーザー発言として保存していました）。
+続きは裏の会話で動きます。`claude agents`の一覧と`claude attach <id>`で見られます。Claude Desktopの画面には出ず、後継のターンが終わって入力待ちになった後にDesktopで開けます。手動`/compact`、subagentの中の圧縮、`claude -p`などscriptから起動した会話は対象に含めません。
 
-LinuxのClaude Code 2.1.289（`claude -p`と対話画面）で実機確認済みです。macOS・Windows、VS Code拡張・Desktop、subagentの中の圧縮は未検証です。[実測と検証範囲](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-04-claude-compact-continuation.md)を参照してください。
+```bash
+throughline auto-handoff status --host claude --operation <handoff-id> --json
+```
+
+後継の立ち上げや配送に失敗した時は、固定の理由を記録して止まります。結果が不明な指示は再送しません。圧縮を止めた後にモデルが道具を呼ばずにターンを終えた時は、後継を立てません。印は残るので、1時間以内に開いた新しい会話が記憶を引き継ぎます。
+
+有効にした端末では、Claudeの道具の呼び出しのたびに`PreToolUse`フックが1回走ります。LinuxとmacOSのClaude Code（2.1.289、Claude Desktop同梱の2.1.286）で実機確認済みです。Windowsと、Claude Desktopの画面から始めた会話は未検証です。[実測と検証範囲](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-05-claude-auto-handoff.md)を参照してください。
 
 ## Ownership boundary
 

package/bin/throughline.mjs

@@ -8,7 +8,8 @@
  *   throughline uninstall     # hook を削除
  *   throughline process-turn  # Stop hook (Claude Code から呼ばれる)
  *   throughline session-start # SessionStart hook (Claude Code から呼ばれる)
- *   throughline pre-compact   # PreCompact hook (Claude Code から呼ばれる。自動継続の印)
+ *   throughline pre-compact   # PreCompact hook (Claude Code から呼ばれる。自動継続: 自動圧縮を止める)
+ *   throughline pre-tool-use  # PreToolUse hook (Claude Code から呼ばれる。自動継続: 旧い会話を止める)
  *   throughline detail <時刻> # L2+L3 詳細取得 (Claude が Bash 経由で呼ぶ想定)
  *   throughline recall --l2|--l1 # 注入案内から辿る pull 用 read-only 記憶取得
  *   throughline handoff-preview # Codex-facing throughline_handoff JSON preview
@@ -84,6 +85,9 @@ switch (cmd) {
   case 'pre-compact':
     await (await import('../src/claude-pre-compact.mjs')).run();
     break;
+  case 'pre-tool-use':
+    await (await import('../src/claude-pre-tool-use.mjs')).run();
+    break;
   case 'monitor':
     (await import('../src/token-monitor.mjs')).main();
     break;
@@ -238,6 +242,7 @@ switch (cmd) {
     'prompt-submit': 'HOOK_PROMPT_SUBMIT_FAILED',
     'process-turn': 'HOOK_PROCESS_TURN_FAILED',
     'pre-compact': 'HOOK_PRE_COMPACT_FAILED',
+    'pre-tool-use': 'HOOK_PRE_TOOL_USE_FAILED',
   }[cmd];
   if (code) {
     const { recordRuntimeErrorBestEffort } = await import('../src/runtime-error-store.mjs');
@@ -407,8 +412,8 @@ Usage:
   throughline auto-handoff detail --operation <id> --origin <session> --turn <n>
                               凍結したL2/L3を取得
   throughline auto-handoff enable|disable|status --host claude [--project <path>] [--json]
-                              Claude Codeの自動継続（自動圧縮の直後に、同じ会話へ
-                              圧縮前の記録を注入）を有効化・無効化・確認
+                              Claude Codeの自動継続（自動圧縮を止め、記憶を持った
+                              新しい会話で続ける）を有効化・無効化・確認
   throughline doctor            Check environment
   throughline doctor --trim     Show trim host boundary diagnostics
   throughline doctor --codex    Show Codex primary diagnostics
@@ -419,7 +424,8 @@ Hook subcommands (called by Claude Code / Codex):
   throughline session-start   SessionStart hook
   throughline process-turn    Stop hook
   throughline prompt-submit   UserPromptSubmit hook (/tl & /clear baton writer)
-  throughline pre-compact     PreCompact hook (Claude自動圧縮の印。圧縮後に記憶を注入)
+  throughline pre-compact     PreCompact hook (Claude自動継続: 自動圧縮を止めて印を残す)
+  throughline pre-tool-use    PreToolUse hook (Claude自動継続: 旧い会話を止めて後継を立てる)
   throughline codex-hook user-prompt-submit Codex current-session refresh prompt hook
   throughline codex-hook post-tool-use Codex current-session refresh tool-loop hook
   throughline codex-hook stop Codex Stop hook

package/docs/02_clear_auto_handoff_plan.md

@@ -11,7 +11,7 @@
 | `/tl` | `UserPromptSubmit` が現在の session id を baton として保存する。次の実セッションがその前任を確定的に引き継ぐ |
 | VS Code の `/clear` | 組み込みコマンドは `UserPromptSubmit` に届かない。`SessionStart source='clear'` を使う auto path が、同じ project の直近前任を凍結して引き継ぐ |
 | Claude Desktop の `/clear` | `UserPromptSubmit` に届かず、`SessionStart source='clear'` も来ないため自動継承しない。続ける場合は `/clear` の前に `/tl` を実行する |
-| Claude Code の自動圧縮 | 会話は切り替わらない。`auto-handoff enable --host claude` で有効にした時だけ、`PreCompact`（`trigger: auto`）が印を残し、圧縮直後の `SessionStart source='compact'` が作業途中のターンと直近の会話を同じ会話へ注入する。既定は無効。手動 `/compact` は対象外。正本は [ADR 0032](adr/0032-claude-compact-continuation.md) |
+| Claude Code の自動圧縮 | `auto-handoff enable --host claude` で有効にした時だけ、`PreCompact`（`trigger: auto`）が圧縮を止めて `/tl` と同じ印を残し、`PreToolUse` が旧い会話を止める。Throughline が `claude --bg` で新しい会話を立て、継続の指示を1通送る。その指示の `UserPromptSubmit` が印を消費して記憶を注入する。既定は無効。手動 `/compact` は対象外。正本は [ADR 0033](adr/0033-claude-auto-handoff-new-session.md) |
 
 `/clear` が `UserPromptSubmit` に届かないことは、VS Code と Desktop の対照実測で
 確定している。`prompt-submit` に残る `/clear` 分岐は host が将来その文字列を渡した場合の
@@ -44,7 +44,7 @@ baton path と auto path は同じ `buildBudgetedResumeContext` を使う。注
 
 ## host 別境界
 
-- Claude Code: VS Code `/clear` は auto path、Desktop `/clear` は `/tl` 併用。自動圧縮は、有効にした時だけ同じ会話へ注入する（ADR 0032）。
+- Claude Code: VS Code `/clear` は auto path、Desktop `/clear` は `/tl` 併用。自動圧縮は、有効にした時だけ、圧縮を止めて新しい会話へ引き継ぐ（ADR 0033）。
 - Grok: `/tl` の baton 成功後に `throughline grok-continue --session <id>` で後継席を
   起動する。`/clear` では起動しない。正本は [ADR 0021](adr/0021-grok-host-capture.md)。
 - Cursor: `/tl` は baton を残すが後継会話を自動起動しない。次の会話が baton を消費する。

package/docs/05_codex_first_roadmap.md

@@ -28,8 +28,9 @@
 最初の成立検証はCodex Desktopで行う。OSごとの仕組みと受入条件は共通にし、
 差分は既存の `src/os/` と配送ライブラリの環境適合へ閉じ込める。
 VS Code・CLIとClaude/Grok/Cursorの対応はhostごとに同じ条件で検証する。
-Claude Codeは圧縮前の停止と新しい会話への配送がhookからできないため、自動圧縮の直後に同じ会話へ記憶を注入する
-（[ADR 0032](adr/0032-claude-compact-continuation.md)）。この節の処理順と進行状態はCodexだけに適用する。
+Claude Codeは同じ並び（圧縮を止める、旧い会話を止める、新しい会話を立てる、継続の指示を1通送る）を、
+Claude Codeの入口（hook、`claude --bg`、会話ごとの受け口）で行う（[ADR 0033](adr/0033-claude-auto-handoff-new-session.md)）。
+この節の処理順と進行状態の細目はCodexだけに適用する。
 一つのhostの成功で他のhostも対応済みとはしない。
 
 ### 根拠と検証範囲

package/docs/adr/0032-claude-compact-continuation.md

@@ -2,6 +2,8 @@
 
 日付: 2026-10-04
 
+状態: **決定1〜4・6〜8（同じ会話への注入）は [ADR 0033](0033-claude-auto-handoff-new-session.md) で置き換えた。** オーナーが却下した（自動圧縮が走った時点で負け）。決定5（圧縮の要約行の扱い）は有効。以下は 0.13.0 の時点の記録として残す。
+
 ## Context
 
 Codex Desktop の自動継続（0.11.0）は、自動圧縮の前に旧タスクを止め、記憶を注入した新しいタスクで

package/docs/adr/0033-claude-auto-handoff-new-session.md

@@ -0,0 +1,104 @@
+# ADR 0033: Claude Code の自動継続は、自動圧縮を止めて新しい会話へ引き継ぐ
+
+日付: 2026-10-05
+
+## Context
+
+ADR 0032（0.13.0）は、Claude Code の自動圧縮を通し、圧縮の直後に同じ会話へ記憶を注入した。
+オーナーはこの方式を却下した（2026-10-04）。Throughline は自動圧縮を置き換えるもので、
+自動圧縮が走った時点で負けである。Codex の自動継続（圧縮の前に止めて、新しいタスクへ引き継ぐ）と
+同じ並びを、Claude Code でも実現する。
+
+Codex 版の各段に当たるものを、Claude Code 2.1.289 の公式文書と実機で1段ずつ確かめた。
+
+| Codex 版の段 | Claude Code で当たるもの | 確認 |
+|---|---|---|
+| 圧縮の前に旧タスクを止める | `PreCompact` の exit code 2 で圧縮を止める。`PreToolUse` が `permissionDecision: "deny"` と `continue: false` を返すと、その道具は実行されずにターンが止まる | 実機 |
+| 新しいタスクを作る | `claude --bg`。指示を付けずに起動すると、指示を待つ会話が立つ（`idle — send a prompt to start`） | 実機 |
+| 止めたターンを取り込んでから記憶を作る | hook で止めたターンでは Stop hook が走らない。worker が、後継を立てる前に transcript から取り込む | 実機（0.14.1） |
+| 記憶を入れる | 最初の指示の `UserPromptSubmit` hook の出力。`/tl` の印（baton）の引き継ぎと同じ | 実機 |
+| 「続けて」を送る | 会話ごとの受け口（inbox socket）。配送ライブラリ `aiterm-steer-delivery` 0.1.13 の `sendClaudeInbox` | 実機 |
+
+`PreCompact` の `continue` は捨てられるので、圧縮を止める hook と作業を止める hook は別になる。
+`PreToolUse` が `continue: false` だけを返すと、その道具は実行されてから止まる。`deny` を一緒に返すと実行されない。
+
+Claude Desktop の新しい会話は、画面を開いただけでは process が起動しない（最初の指示が送られた時に起動する）。
+`claude://code/new` の `q` は入力欄への事前入力で、送信しない。受け口が無いので、Desktop の下書きへは配送できない
+（配送ライブラリの持ち主も確認）。後継は Throughline が起動する会話にする（オーナーの判断、2026-10-04）。
+
+## Decision
+
+1. **圧縮を止める**: `PreCompact` hook（`throughline pre-compact`、matcher 無し）が、`trigger: "auto"` で自動継続が
+   有効な project の時だけ、`/tl` と同じ印（baton）と引き継ぎの記録を残し、exit code 2 で圧縮を止める。
+   手動の `/compact`、無効な project、subagent の中の圧縮（payload に `agent_id`）、script から起動した会話
+   （`CLAUDE_CODE_ENTRYPOINT` が `sdk-` で始まる）では止めない。
+2. **旧い会話を止める**: `PreToolUse` hook（`throughline pre-tool-use`、全ての道具）が、記録のある会話の次の道具を、
+   実行させずに止める。旧い会話は止めるだけで、空にしない。同じ応答に並んだ道具も全て止め、後継の立ち上げは1回だけ行う。
+   記録が無い会話では、記録のファイルの有無だけを見て終わる。subagent の中の道具は止めない。
+3. **新しい会話を立てる**: 切り離した worker が、止めた時点の依頼・モデル・推論強度・権限を記録へ写し、
+   同じ project で `claude --bg` を指示なしで起動する。起動時に `--model`・`--effort`・`--permission-mode` を渡し、
+   `--settings '{"worktree":{"bgIsolation":"none"}}'` で同じ作業ツリーを編集させる。
+   依頼と直前の発言は、止めた道具の呼び出しが transcript に書かれるのを待ってから読む（hook の時点では直前の発言が
+   まだ書かれていないことがある）。
+   後継を立てる前に、**止めたターンを DB へ取り込む**（0.14.1。Codex の自動継続と同じ）。発言は全部をつないで
+   bodies の本文にし、道具の入出力は transcript の末尾（止めた道具の呼び出し）まで details に入れる。
+   完了したターンは最後の本文だけを残すが、止めたターンには結論の発言が無いので、全部を残す。
+   取り込めなくても引き継ぎは止めない。理由は worker のログに残り、状態の `in_flight_captured` が `false` になる。
+4. **継続の指示を1通送る**: 後継の `SessionStart` hook が、同じ project に立ち上げ中の引き継ぎがある時だけ、
+   自分の受け口（`CLAUDE_CODE_MESSAGING_SOCKET` と token）を控える。worker はそれを読んで消し、
+   `sendClaudeInbox` で継続の指示を1通送る。配送は公開 API だけを使い、Throughline の中に送信の実装を持たない。
+   届いた時の `UserPromptSubmit` が baton を消費して前任を合流させ、記憶を注入する。
+   注入は ADR 0016 と同じ予算（9,500 字）で、ヘッダに作業ディレクトリ、現在地、案内、直近の L2 の順に載せる。
+   宣言文は求めない。現在地は止めたターンで、次の順に載せる（0.14.1）。
+   - 止めた時点の依頼（3,500 字まで）。
+   - このターンでここまでにしたこと。発言と道具の呼び出し（名前と対象。失敗は印を付ける）を古い順に並べる。
+     新しい側から 2,400 字まで載せ、載せなかった古い側は件数にする。記録には直近 80 件までを持つ。
+   - 止める直前の発言（1,500 字まで）。一覧に同じ文がそのまま載っている時は重ねない。
+   - 止める直前に呼ぼうとして、実行されなかった道具。圧縮を止めた後の応答が呼んだ道具は、どれも実行されていない。
+     hook は並んで走るので、同じ応答（`message.id`）の道具をまとめて扱う。
+   止めたターンは現在地にだけ載せ、L2 の一覧には重ねない。そのターンの道具の入出力は `throughline detail` で取り出せる。
+5. **受領**: 継続の指示は引き継ぎ ID を含む。後継の最初の指示がその ID を含む時だけ、受領を記録する。
+   `sendClaudeInbox` の結果が `accepted` なら `sent`、`not_sent` なら `failed`、`unknown` なら `unknown` にする。
+   結果が不明な時は再送しない。後継が作業を進めたことまでは確かめない（オーナーの判断: 不要）。
+6. **連続の引き継ぎ**: 後継も同じ hook で止まり、次の後継へ引き継ぐ。後継の最後の user 発言は前の引き継ぎの
+   継続の指示なので、現在地には前の引き継ぎが運んだ元の依頼を引き続き載せる。
+7. **道具を呼ばずに終わったターン**: 圧縮を止めた後、モデルが道具を呼ばずにターンを終えたら、Stop hook が記録を取り下げる。
+   印は残るので、1時間以内に開いた新しい会話が記憶を引き継ぐ。
+8. **引き継ぎ済みの会話**: 後継を立てた会話は、その後も圧縮と道具を止め、後継を案内する。同じ会話から2つ目の後継は立てない。
+   立ち上げに失敗した記録（`failed`）は、次の道具でもう一度立ち上げる。
+9. **有効化**: 既定は無効。`throughline auto-handoff enable --host claude [--project <path>]` が設定を書き、
+   `PreCompact` と `PreToolUse` の hook を登録する。`disable` が2つの hook を外す。`install` は登録しない
+   （`PreToolUse` は道具の呼び出しのたびに走るので、使わない端末に置かない）。有効な端末の `install` は2つの hook を保ち、
+   無効な端末の `install` は 0.13.0 が置いた `PreCompact` を外す。
+10. **状態**: `~/.throughline/claude-auto-handoff/` のファイルに持つ。schema は変えない（v12）。記録は旧い会話の
+    session id を鍵にし、24時間を過ぎたものは次の引き継ぎの時に掃除する。token は記録に残さない。
+11. **失敗**: hook 自身の失敗では圧縮も道具も止めない（exit code 1）。`HOOK_PRE_COMPACT_FAILED`・`HOOK_PRE_TOOL_USE_FAILED`
+    （どちらも `warn`）を記録する。worker の失敗は記録の `error_code` に固定の理由で残す。
+12. ADR 0032 の決定のうち、圧縮の要約行（`isCompactSummary`）の扱い（決定5）は有効。同じ会話への注入（決定1〜4、6〜8）は
+    この ADR で置き換える。
+
+## Consequences
+
+- 有効な project では、Claude Code の自動圧縮は走らない。旧い会話は、止めた道具の hook の文を出して止まる。
+- 続きは裏の会話（agent view）で動く。`claude agents` の一覧と `claude attach <id>` で見られる。Claude Desktop の画面には
+  出ず、後継のターンが終わって入力待ちになった後に Desktop で開ける。
+- `PreToolUse` hook は、有効な端末の全ての Claude の会話で、道具の呼び出しのたびに1回走る。
+- 止めたターンは Stop hook を通らない。worker が取り込む（0.14.1）。発言が1つも無いまま止めたターンは、
+  user の行と道具の入出力だけが入る。完了の受領（Stop が出すもの）は、止めたターンには出さない。
+- 0.14.0 は、止めたターンについて直前の発言1つだけを後継へ渡し、道具の入出力をどこにも残さなかった。
+  macOS の実機で、Haiku の後継が読み終えたファイルを最初から読み直した。Codex 版は止めたターンを取り込んでから
+  記憶を作っており、その段を写していなかった。
+- 圧縮が「文脈上限の error から回復するため」に起きた時は、止めると元の error でその要求が失敗する（公式文書）。
+  この場合の後継の立ち上げは、次の道具の呼び出しまで起きない。
+- 別の会話から届いた発言（`Another Claude session sent a message:`）は、Claude Code が後ろに付ける定型の注意書きを
+  落として保存する。
+- 依存の `aiterm-steer-delivery` を 0.1.9 から 0.1.13 に上げる。Codex の配送の入口は変わらない。
+
+## 確認した範囲
+
+- Linux の Claude Code 2.1.289。対話画面の会話から始めて、Haiku 4.5 で3回、Opus 5.5 で6回、連続で引き継ぎ、
+  最後の後継が作業を完了した（0.14.0）。0.14.1 でも Haiku 4.5 で確認した。
+- macOS 27.0。端末の会話（2.1.289）と、Claude Desktop が同梱する本体（2.1.286）を端末から起動した会話から始めた。
+  0.14.1 で、Haiku 4.5 は4回、Opus 5.5 は7回、連続で引き継いで完了した。読み直しも読み飛ばしも無い。
+- どの会話にも圧縮の記録は無く、止めた道具は実行されていなかった。
+- Claude Desktop の画面から始めた会話、Windows、Fable、subagent が動いている最中の引き継ぎは確かめていない。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "type": "module",
   "description": "Persistent memory hooks for Claude Code, Codex, Grok, and Cursor (/clear-safe context compression)",
   "keywords": [
@@ -55,6 +55,6 @@
     "unified": "^11.0.5"
   },
   "dependencies": {
-    "aiterm-steer-delivery": "0.1.9"
+    "aiterm-steer-delivery": "0.1.13"
   }
 }

package/rag/01-hooks/raw/claude-compact-hooks-extract.md

@@ -1,7 +1,7 @@
 # Claude Code: 圧縮まわりの hook（一次ソース抜粋）
 
 取得: 2026-10-04、`https://code.claude.com/docs/en/hooks.md`・`context-window.md`・`deep-links.md`・`agent-view.md`・`env-vars.md`。
-実機は Claude Code 2.1.289。設計は [ADR 0032](../../../docs/adr/0032-claude-compact-continuation.md)。
+実機は Claude Code 2.1.289。設計は [ADR 0033](../../../docs/adr/0033-claude-auto-handoff-new-session.md)（0.13.0 の時点は ADR 0032）。
 
 ## PreCompact
 
@@ -33,14 +33,39 @@
 
 > | `agent_id` | Unique identifier for the subagent. Present only when the hook fires inside a subagent call. Use this to distinguish subagent hook calls from main-thread calls. |
 
+## 作業を止める（PreToolUse）
+
+- `PreCompact` の `continue` は捨てられるので、圧縮を止めた後の作業は別の hook で止める。
+- 実機: `PreToolUse` が `{"continue": false, "stopReason": "…"}` だけを返すと、その道具は実行されてからターンが止まる
+  （transcript に `hook_stopped_continuation`）。`hookSpecificOutput.permissionDecision: "deny"` を一緒に返すと、
+  道具は実行されずに止まる。同じ応答に並んだ道具には、それぞれ hook が走る。
+- hook で止めたターンでは `Stop` hook は走らない。
+
 ## 新しい会話を始める口
 
 > A deep link never executes anything on its own. The link only chooses a directory and fills the prompt box.
 
 > When you dispatch a background session from agent view or start one with `claude --bg`, the session starts in your working directory. Before editing files, Claude moves the session into an isolated git worktree under `.claude/worktrees/`
 
-- `claude-cli://open?q=…` は入力欄へ下書きを入れるだけ。`claude --bg "<prompt>"` は別の background session。
-- → 対話中の会話を、記憶を入れた新しい会話へ入れ替えて続けさせる公開の口は無い。
+- `claude-cli://open?q=…` と Claude Desktop の `claude://code/new?q=…&folder=…` は、入力欄へ下書きを入れるだけ。
+  Desktop の新しい会話は、最初の指示が送られるまで process が起動しない（実機: hook も受け口も現れない）。
+- `claude --bg "<prompt>"` は別の background session を立てて、すぐ戻る。指示を付けずに起動すると
+  `backgrounded · <id> · <name> (idle — send a prompt to start)` と出て、指示を待つ会話が立つ（実機。SessionStart は走る）。
+  `--model`・`--effort`・`--permission-mode`・`--name`・`--settings` を受ける。`--session-id` は無視される
+  （短い ID は session id の先頭8桁）。別の background session の中から起動すると、出力の ID に色の制御文字が付く。
+- 動いている background session は Desktop へ移せない（`claude --desktop --resume`）。ターンが終わった後は開ける。
+
+## 既存の会話へ外から送る口（inbox socket）
+
+> Read this section when a session you expect isn't in the agent list, when you want a script or hook to post into a session, or when a sandboxed command can't reach the socket.
+
+- 会話ごとに Unix domain socket（Windows は named pipe）。path は hook と Bash へ `CLAUDE_CODE_MESSAGING_SOCKET`、
+  会話ごとの token は `CLAUDE_CODE_MESSAGING_TOKEN`。起動時に `--messaging-socket-path` でも指定できる。
+- 送る形は Claude Code 本体の中の例: 1行の JSON `{"type":"user","message":{"role":"user","content":"…"}}`。
+  先頭に `{"type":"auth","token":"…"}`（macOS・Linux は任意、Windows は必須）。
+- 実機: 入力待ちの会話へ送るとターンが始まり、`UserPromptSubmit` hook が `prompt` にその文を持って走る。
+  transcript では `origin: {kind: "peer"}`、本文の前後に Claude Code が送り主の行と定型の注意書きを付ける。
+- 製品の配送は `aiterm-steer-delivery` 0.1.13 の `sendClaudeInbox` を使う（受領の確認は呼び出し側の観測）。
 
 ## 自動圧縮の窓
 

package/rag/INDEX.md

@@ -29,7 +29,7 @@ rag/
 
 ## Claude自動継続の根拠
 
-- [圧縮まわりのhookの一次ソース抜粋](01-hooks/raw/claude-compact-hooks-extract.md) — `PreCompact`は圧縮を止められるが作業は止められない。`SessionStart(source=compact)`の出力は圧縮後の文脈へ足される。新しい会話へ指示を送る公開の口は無い。[実測](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-04-claude-compact-continuation.md)で、自動圧縮の直後に注入が届き、入力なしで作業が続いた。Finding 6・第三仮説（PreCompactでの再投影）に対する現行の答えは[ADR 0032](../docs/adr/0032-claude-compact-continuation.md)。
+- [圧縮・会話の起動・受け口の一次ソース抜粋](01-hooks/raw/claude-compact-hooks-extract.md) — `PreCompact`は圧縮を止められる（exit code 2）が`continue`は捨てられる。`PreToolUse`の`deny`+`continue:false`で道具を実行させずにターンを止められる。`claude --bg`は指示なしで起動すると指示待ちの会話が立つ。会話ごとの受け口（inbox socket）へ外から1通送ると、入力待ちの会話でターンが始まる。[実測](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-05-claude-auto-handoff.md)で、対話の会話から後継へ3回連続で引き継ぎ、圧縮は1回も走らなかった。Finding 6・第三仮説（PreCompactでの再投影）に対する現行の答えは[ADR 0033](../docs/adr/0033-claude-auto-handoff-new-session.md)。
 
 ## Question this RAG was built to answer