throughline 0.16.27 → 0.16.29

package/CHANGELOG.md

@@ -10,6 +10,60 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.29] — 2026-10-14
+
+### 修正
+
+- **Claude Codeで、作業中に届いた入力が、会話の記録（L2）に残っていなかった**（[ADR 0060](docs/adr/0060-claude-mid-turn-input-and-host-meta-rows.md)）。Claude Codeは、ターンが動いている間に届いた入力を、user行ではなく`attachment`の`queued_command`で書く。この製品はその行を読んでいなかった。Linuxの実機の4日ぶんの記録で、人の入力のuser行1,402に対して、途中で届いた人の入力は833通あり、記録に入っていたのは3通だった。
+  - 直した後は、途中で届いた入力を、届いた先のターンの依頼へ、届いた順に足す。前に見出しの1行（`（作業の途中で届いた入力）`）を置く。人が打った文と、別の会話から届いた発言が当たる。裏の作業の完了通知は足さない。
+  - 引き継ぎの記憶と、自動継続で後継へ運ぶ依頼にも入る。
+- **Claude Codeがskillを読んだ時などに書く行を、利用者の発言として記録していた**（同じADR）。`isMeta: true`で`origin`の無いuser行。この行でターンを区切っていたので、その前に本文が無いと、元の依頼が記録から消え、skillの本文が利用者の発言として残った。道具の入出力（L3）も、その行より前の分が入らなかった。自動継続で止めたターンでは、後継へ運ぶ依頼がskillの本文になっていた。
+  - 直した後は、この行をターンの始まりにも本文にもしない。別の会話から届いた発言（`origin`を持つ）は、今までどおり。
+- **Claude Codeで、ターンの終わりに待ち入力が2通以上続けて届いた時、最後の1通だけが記録されていた**（同じADR）。同じ番へ続けて届いたuser行（`turnPosition.promptIndex`が同じ）を、1つの依頼にまとめる。
+
+### 変わる動き
+
+- Claude Codeの会話で、利用者の発言の行に、作業中に届いた入力が見出しつきで足される。見出しの1行は、この製品が足した文。
+- skillの本文は、利用者の発言として記録されなくなる。道具の入出力には残る。
+- 前の版が記録したターンは書き直さない。直しが効くのは、この版が取り込むターンから。行の番号は変わらないので、前の版の行と重なって増える事は無い。
+- Codex・Grok・Cursorの記録の読み方は変えていない。
+
+## [0.16.28] — 2026-10-14
+
+### 修正
+
+- **Codex Desktopで、ゴール（`/goal`）を持つタスクを引き継いだ後、旧タスクが止まらず、「タスク終了」の通知と後継への画面の切り替えが続いていた**（[ADR 0059](docs/adr/0059-codex-handoff-carries-thread-goal.md)）。Windowsの実機で2026-10-13に起きた。
+  - Codexは、タスクが手すきになるたびにゴールを読み、実行中なら自分で次のターンを起こす。旧タスクにゴールが実行中のまま残っていたので、止めるたびに次のターンが始まった。22:04から1〜2秒おきに2,067回。入力は全部Codex自身の続行の指示で、人の入力は無かった。Throughlineはそのたびにターンを止めて、後継を画面に開いていた。
+  - 後継にはゴールが運ばれていなかった。ゴールで動かしていた作業は、引き継ぎを境に、自分では続かなくなっていた。
+  - 直した後は、引き継ぎの最初に旧タスクのゴールを一時停止にし、後継が作業を続けたのを確かめた後で、ゴールを後継へ運ぶ。目標の文はそのまま、予算は使った分を引いた残りを渡す。動いていたゴールは後継でも動き、利用者が止めていたゴールは止めたまま移る。旧タスクのゴールは、一時停止のまま残す。
+  - 完了したゴールと、Codexが上限や行き詰まりで止めたゴールは運ばない。後継にもうゴールがあれば書き換えない。
+  - ゴールを読めない・書けない時も、引き継ぎは止めない。
+  - 引き継ぎが途中で止まった時は、旧タスクのゴールを実行中へ戻さない（戻すと、続行のターンと引き継ぎの失敗が繰り返される）。失敗の画面に、ゴールを止めてある事を書く。
+- **引き継ぎ済みの旧タスクへ、人の入力ではないターンが来た時にも、後継を画面に開いていた**（同じADR）。ターンの入力がCodex自身の文脈だけの時は、止めて後継を示すが、画面は切り替えない。
+- **0.16.27までの版が引き継いだ旧タスクに、ゴールが実行中のまま残っている時の片付け**（同じADR）。引き継ぎ済みの旧タスクへターンが来た時に、別のprocessで旧タスクのゴールを確かめる。実行中なら一時停止にし、今の後継にゴールが無ければ運ぶ。同じ旧タスクへは30秒に1回まで。片付けた事は`~/.throughline/codex-auto-handoff/goal-settles.jsonl`へ1行残す（時刻・ID・付けた状態。目標の文は書かない）。
+
+### 変わる動き
+
+- ゴールを持つタスクの引き継ぎで、旧タスクのゴールが「一時停止」になり、後継に同じゴールが付く。後継のゴールの使用量は0から数え直す。
+- 後から片付けたゴール（上の3つめ）は、後継が手すきの時は、その場では動き出さない。後継の次のターンが終わった時からCodexが続ける。
+- 旧タスクの画面のゴールの表示は、Codex Desktopがそのタスクを読み直すまで、古いまま見える事がある。
+
+### 対応の範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Codex | 直した。単体試験と、実機で、直した版の関数（止める・運ぶ・片付ける）をCodex Desktop同梱のCodex（0.162.0-alpha.17.2）へ通した（25項目）。止めなければCodexが次のターンを起こし続ける事、止めた後は起きない事、後継がゴールを続けて完了する事まで | 直した。同じ確認を、codex-cli 0.162.1（コンテナ）で。本物のCodex Desktop（同梱の0.162.0-alpha.2）で、ゴールを持つタスクを自動圧縮の手前まで進める通しも流した（入っている0.16.27へ、直した3ファイルを一時だけ重ねた）。8回続けて引き継ぎ、毎回、旧タスクのゴールは一時停止・後継のゴールは実行中になり、最後の後継が作業を終えてゴールを完了した。引き継いだ後の旧タスクへ来たターンは0回（引き継ぎの最中に、1秒以内に4〜5回） | 直した。起きた端末。旧タスクのゴールを一時停止にして、連続が止まるのを見た。同じ確認を、Codex Desktop同梱のCodex（0.162.0-alpha.17.2）で（25項目）。起きた旧タスクの本物の記録へ、直した版のhookの入口を読むだけで当てた（止める・後継を開かない・片付けを起こす、の答え） |
+| Claude Code | 変更なし（タスクごとのゴールが無い） | 同じ | 同じ |
+| Grok | 変更なし（自動継続が無い） | 同じ | 同じ |
+| Cursor | 変更なし（自動継続が無い） | 同じ | 同じ |
+
+### 確かめていない事
+
+- macOSとWindowsの本物のCodex Desktopの画面で、ゴールを持つタスクが自動圧縮の手前まで進んで引き継がれる通し。通したのはLinuxのCodex Desktopだけ。macOSとWindowsは、Desktop同梱のCodexへ関数を通す所までで、画面のタスクは使っていない。
+- 0.16.27までの版が引き継いだ旧タスクの片付け（別のprocessを起こす所）を、本物のhookから通す事。関数と、起こす引数と、起きた旧タスクの記録に対するhookの答えは確かめた。Windowsの起きた旧タスクは、手で一時停止にしてあるので、もうこの道を通らない。
+- Codex Desktopは、完了したゴールを自分で消す（Linuxの実機で、完了の直後に画面の側が`thread/goal/clear`を送った）。完了の前に画面の側がゴールを書き換える場面があるかは見ていない。
+- ゴールの続行の指示（Codex自身の文脈）は、記憶では今までどおり利用者の発言として残る。この版では変えていない。
+
 ## [0.16.27] — 2026-10-13
 
 ### 修正
@@ -2522,7 +2576,9 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.27...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.29...HEAD
+[0.16.29]: https://github.com/kitepon/Throughline/compare/v0.16.28...v0.16.29
+[0.16.28]: https://github.com/kitepon/Throughline/compare/v0.16.27...v0.16.28
 [0.16.27]: https://github.com/kitepon/Throughline/compare/v0.16.26...v0.16.27
 [0.16.26]: https://github.com/kitepon/Throughline/compare/v0.16.25...v0.16.26
 [0.16.25]: https://github.com/kitepon/Throughline/compare/v0.16.24...v0.16.25

package/README.ja.md

@@ -29,7 +29,7 @@ throughline auto-handoff disable
 
 既定では無効です。`enable`は必要な`PreCompact(auto)`フックを登録し、そのフックの承認と有効状態を公式APIで確認します。`--project`を省略すると全projectを対象にします。macOS・Windows・LinuxのCodex Desktopで実機確認済みです（Windowsは0.16.6から、Linuxは0.16.7から）。Codex Desktopに同梱のCodexが0.162以上の時は、0.16.7以上が要ります。VS Code・CLIの自動継続は未検証です。
 
-自動圧縮の開始前に旧ターンを停止し、同じprojectの新しいタスクへ記憶を注入して表示します。新しいタスクには、前任のタスクの題から`<project名>｜<作業の概要>（自動引き継ぎ）`の名前を付けます。後継が作業を続けたのを確かめた後、旧タスクの名前の頭へ`【引き継ぎ済み】`を付けます（0.16.10から。それより前の版が引き継いだ分は`throughline auto-handoff mark-sources`で付け直せます。名前の無い後継にも名前が付きます。`--dry-run`で、付ける名前だけを先に見られます）。一覧で、印の無い1本が今の続きです。元のモデル・推論強度・権限・モードなどが表示後も一致することを確認してから、継続指示を一度だけ送ります。後継でその入力と作業の進捗を観測して完了とします。手動`/compact`は発火対象に含めません。
+自動圧縮の開始前に旧ターンを停止し、同じprojectの新しいタスクへ記憶を注入して表示します。新しいタスクには、前任のタスクの題から`<project名>｜<作業の概要>（自動引き継ぎ）`の名前を付けます。後継が作業を続けたのを確かめた後、旧タスクの名前の頭へ`【引き継ぎ済み】`を付けます（0.16.10から。それより前の版が引き継いだ分は`throughline auto-handoff mark-sources`で付け直せます。名前の無い後継にも名前が付きます。`--dry-run`で、付ける名前だけを先に見られます）。一覧で、印の無い1本が今の続きです。元のモデル・推論強度・権限・モードなどが表示後も一致することを確認してから、継続指示を一度だけ送ります。後継でその入力と作業の進捗を観測して完了とします。手動`/compact`は発火対象に含めません。旧タスクにCodexのゴール（`/goal`）があれば、引き継ぎの最初に一時停止にし、後継が作業を続けた後で後継へ運びます（0.16.28から。動いていたゴールは後継でも動き、止めていたゴールは止めたまま移ります）。
 
 記憶は引き継ぎ全体の直近20ターンをL2全文、それより古いターンをL1で渡します。元のユーザー依頼と中断地点を保持し、tool結果とThinkingは注入しません。本文内の`auto-handoff detail`コマンドで、凍結したL2/L3を引き継ぎID・origin・turnから取得できます。A→B→Cの連続引き継ぎでも祖先の詳細を取得できます。
 

package/README.md

@@ -28,7 +28,7 @@ throughline auto-handoff disable
 
 既定では無効です。`enable`は必要な`PreCompact(auto)`フックを登録し、そのフックの承認と有効状態を公式APIで確認します。`--project`を省略すると全projectを対象にします。macOS・Windows・LinuxのCodex Desktopで実機確認済みです（Windowsは0.16.6から、Linuxは0.16.7から）。Codex Desktopに同梱のCodexが0.162以上の時は、0.16.7以上が要ります。VS Code・CLIの自動継続は未検証です。
 
-自動圧縮の開始前に旧ターンを停止し、同じprojectの新しいタスクへ記憶を注入して表示します。新しいタスクには、前任のタスクの題から`<project名>｜<作業の概要>（自動引き継ぎ）`の名前を付けます。後継が作業を続けたのを確かめた後、旧タスクの名前の頭へ`【引き継ぎ済み】`を付けます（0.16.10から。それより前の版が引き継いだ分は`throughline auto-handoff mark-sources`で付け直せます。名前の無い後継にも名前が付きます。`--dry-run`で、付ける名前だけを先に見られます）。一覧で、印の無い1本が今の続きです。元のモデル・推論強度・権限・モードなどが表示後も一致することを確認してから、継続指示を一度だけ送ります。後継でその入力と作業の進捗を観測して完了とします。手動`/compact`は発火対象に含めません。
+自動圧縮の開始前に旧ターンを停止し、同じprojectの新しいタスクへ記憶を注入して表示します。新しいタスクには、前任のタスクの題から`<project名>｜<作業の概要>（自動引き継ぎ）`の名前を付けます。後継が作業を続けたのを確かめた後、旧タスクの名前の頭へ`【引き継ぎ済み】`を付けます（0.16.10から。それより前の版が引き継いだ分は`throughline auto-handoff mark-sources`で付け直せます。名前の無い後継にも名前が付きます。`--dry-run`で、付ける名前だけを先に見られます）。一覧で、印の無い1本が今の続きです。元のモデル・推論強度・権限・モードなどが表示後も一致することを確認してから、継続指示を一度だけ送ります。後継でその入力と作業の進捗を観測して完了とします。手動`/compact`は発火対象に含めません。旧タスクにCodexのゴール（`/goal`）があれば、引き継ぎの最初に一時停止にし、後継が作業を続けた後で後継へ運びます（0.16.28から。動いていたゴールは後継でも動き、止めていたゴールは止めたまま移ります）。
 
 記憶は引き継ぎ全体の直近20ターンをL2全文、それより古いターンをL1で渡します。元のユーザー依頼と中断地点を保持し、tool結果とThinkingは注入しません。本文内の`auto-handoff detail`コマンドで、凍結したL2/L3を引き継ぎID・origin・turnから取得できます。A→B→Cの連続引き継ぎでも祖先の詳細を取得できます。
 

package/docs/adr/0055-stop-flush-barrier-skips-queued-inputs.md

@@ -56,3 +56,9 @@ turn の間に入力が2通たまり、turn が終わった時に2通が続け
   本物の hook の命令（`process-turn`）へ、合成した transcript を通した（切り離した HOME）。
 - 確かめていない: 本物の Claude Code が、待っていた入力を2通続けて書く場面での、この版の動き。狙って起こすには、
   動いている turn の間に入力を2通ためる必要がある。次に起きた時は、失敗が記録されない事で分かる。
+
+## 追記（2026-10-14、ADR 0060）
+
+Context の「保存の欠けは無い」は、完了した turn の事だった。続けて届いた入力の1通目は、assistant 断片の無い group として
+保存されていなかった（コンテナの本物の transcript で 5 回）。ADR 0060 で、同じ `turnPosition.promptIndex` で続けて届いた
+user 行を1つの依頼にまとめる様にした。assistant 断片の無い group を飛ばす作りは、そのまま残している。

package/docs/adr/0059-codex-handoff-carries-thread-goal.md

@@ -0,0 +1,96 @@
+# ADR 0059: Codex の旧タスクのゴールは、引き継ぎの初めに止めて、後継へ運ぶ
+
+日付: 2026-10-13
+
+## Context
+
+Codex には、タスクごとのゴール（`/goal`）がある。目標の文を決めておくと、タスクが手すきになるたびに Codex が自分で
+次のターンを起こし、目標が終わるまで続ける。
+
+2026-10-13、Windows の Codex Desktop（同梱の Codex 0.162.0-alpha.17.2、Throughline 0.16.27）で、自動継続が
+引き継いだ後の旧タスクが止まらなかった。
+
+- 22:04:09 に旧タスクを止めて引き継ぎを始め、22:05:44 に後継が作業を続けた（`continued`）。引き継ぎ自体は成功している。
+- 旧タスクには、20:10 に利用者が付けたゴールが「実行中」のまま残っていた。後継にはゴールが無かった。
+- 旧タスクでは、22:04:10 から 1〜2 秒おきに新しいターンが始まり続けた。23:43:35 までに 2,067 回。
+  どのターンも入力は Codex 自身の文脈（`<codex_internal_context source="goal">` で始まる続行の指示）だけで、人の入力は 0。
+- ターンが始まるたびに、文脈が上限を超えているので `PreCompact(auto)` が来る。Throughline は「引き継ぎ済みの旧タスクへ
+  新しい入力が来た」（ADR 0039）として、ターンを止め、後継を画面に開いた。
+- 利用者には、「タスク終了」の通知が続き、画面が後継へ切り替わり続ける様に見えた。旧タスクの記録（rollout）は
+  約34MB まで増えた。モデルは呼ばれていない（止めるのはモデルを呼ぶ前）。
+- 引き継ぎの最中（22:04:10〜22:05:44）にも同じターンが来ていた。こちらは「引き継ぎの最中の入力」（ADR 0040）として
+  止まっていた。
+
+原因は、Throughline がゴールを扱っていなかった事にある。
+
+- Codex は、タスクが手すきになるたびに DB のゴールを読み、`active` なら続行の指示でターンを始める
+  （`codex-rs/ext/goal/src/extension.rs` の `on_thread_idle` → `runtime.rs` の `continue_if_idle`）。
+  hook が止めたターン（`turn_aborted`、`interrupted`）の後も同じ。利用者が自分で中断した時だけの持ち越しの印は、hook の止めでは付かない。
+- 後継は新しいタスクなので、ゴールを持たない。後継は継続の指示の1ターンを終えると、そこで止まる。
+  ゴールで動かしていた作業が、引き継ぎを境に自分では続かなくなっていた。
+
+Codex の app-server には、ゴールを読む・変える・消す口がある（`thread/goal/get`・`thread/goal/set`・`thread/goal/clear`。
+experimental）。別の process から使える。確かめた事（Linux の Codex 0.162.1 と、Windows の実機）:
+
+- 別の process が `status: 'paused'` を書くと、タスクを開いている process は次の手すきで続行を起こさない
+  （Windows の実機で、連続が1ターンの内に止まった）。
+- ゴールの無いタスクへ、別の process が目標の文つきで `status: 'active'` を書ける。そのタスクがターンを動かしている間に
+  書くと、タスクを開いている process は、そのターンの後から続行を起こす。
+- 手すきのタスクへ `active` を書いても、その場では続行が起きない。次にそのタスクのターンが終わった時から起きる。
+- `status: 'paused'` と目標の文を一緒に渡して、止まった状態のゴールを新しく作れる。
+
+## Decision
+
+1. worker は、引き継ぎの最初に、旧タスクのゴールを読む。`active` なら `paused` にする（`pauseAutoHandoffSourceGoal`）。
+   ゴールは消さない。止めたかどうかを、引き継ぎの記録（`runtime_json.goalCarry.paused`）へ書く。目標の文は記録へ写さない。
+2. 後継が作業を続けたのを確かめた後（`continued` の直後、順番待ちを運ぶより先）に、旧タスクのゴールを後継へ運ぶ
+   （`carryAutoHandoffGoal`）。後継の最初のターン（継続の指示）が動いている間に付けるので、そのターンの後から Codex が続ける。
+   - 目標の文はそのまま写す。予算（`tokenBudget`）があれば、旧タスクで使った分を引いた残りを渡す。
+   - この製品が止めたゴールは、後継では `active` にする。利用者が止めていたゴール（`paused`）は、`paused` のまま運ぶ。
+   - 完了したゴール（`complete`）と、Codex が上限や行き詰まりで止めたゴール（`budgetLimited`・`usageLimited`・`blocked`）は運ばない。
+   - 後継にもうゴールがあれば、書き換えない。
+   - 運ぶ時に旧タスクのゴールが `active` なら（最初の一時停止が効かなかった）、先に `paused` にしてから運ぶ。
+3. 旧タスクのゴールは `paused` のまま残す。旧タスクは引き継ぎ済みなので、そのゴールは動かない。
+4. ゴールを読めない・書けない時も、引き継ぎは止めない（ゴールの口が無い版の Codex を含む）。理由は worker のログに残す。
+5. 途中で止まった引き継ぎ（`failed`・`unknown`）では、ゴールを後継へ運ばず、旧タスクのゴールも `active` へ戻さない。
+   戻すと、止まったままの旧タスクで、続行のターンと引き継ぎの失敗が繰り返される。失敗の画面に、ゴールを止めてある事と、
+   旧タスクで続ける時の戻し方を書く。やり直しで `continued` になった時に運ぶ。同じ旧タスクから新しい引き継ぎを作った時は、
+   前の引き継ぎが止めていた事を引き継ぐ（後継では `active` にする）。
+6. 引き継ぎ済みの旧タスクへターンが来た時（ADR 0039 の道）に、次の2つを足す。
+   - そのターンの入力が Codex 自身の文脈だけなら（`<codex_internal_context` で始まる物だけ）、後継を画面に開かない。
+     人が入力していないのに画面を切り替えない。ターンを止めて後継を示す事は変えない。
+   - 旧タスクにゴールが動いたまま残っていないかを、別の process で確かめる（`auto-handoff settle-goal`。hook は待たない）。
+     動いていれば `paused` にし、今の一番先の後継にゴールが無ければ `active` で運ぶ。同じ旧タスクへは30秒に1回まで。
+     0.16.27 までの版が引き継いだ旧タスクと、引き継いだ後で利用者が旧タスクのゴールを再開した時が当たる。
+     片付けた事は `~/.throughline/codex-auto-handoff/goal-settles.jsonl` へ1行残す（時刻・ID・付けた状態。目標の文は書かない）。
+
+## Consequences
+
+- ゴールで動かしていたタスクは、引き継いだ後も後継がゴールで続ける。旧タスクは止まる。
+- 引き継ぎの最中に来る続行のターンは、worker がゴールを止めるまでの数秒の分だけになる。
+- 後継のゴールの使用量（`tokensUsed`・`timeUsedSeconds`）は 0 から数え直しになる。予算は残りを渡すので、合計の上限は変わらない。
+- 6 の片付けで運んだゴールは、後継が手すきの時は、その場では動き出さない。後継の次のターンが終わった時から Codex が続ける。
+- 旧タスクの画面のゴールの表示は、別の process が書いた変更なので、Codex Desktop がそのタスクを読み直すまで古いまま見える事がある。
+- `continued` を記録した直後に worker が落ちると、ゴールは旧タスクで止まったまま、後継へは運ばれない。旧タスクは動かないので
+  連続は起きない。利用者が後継でゴールを付け直す必要がある。
+- `blocked` などで止まっているゴールは運ばない。旧タスクに残る。
+- 引き継ぎ1回につき、Codex の app-server への接続が2回増える（最初の読み書きと、運ぶ時）。
+- Claude Code の自動継続は変えない。Claude Code にはタスクごとのゴールが無い。
+
+## 確かめた範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Codex Desktop | 直した版の関数（止める・運ぶ・片付ける）を、Desktop 同梱の Codex（0.162.0-alpha.17.2）へ通した（25項目） | 同じ確認を codex-cli 0.162.1 で。本物の Codex Desktop（同梱の 0.162.0-alpha.2）で、ゴールを持つタスクの引き継ぎを8回続けて通した | 起きた端末。旧タスクのゴールを `paused` にして、連続が止まるのを見た。関数の確認（25項目）を Desktop 同梱の Codex（0.162.0-alpha.17.2）で。起きた旧タスクの本物の記録へ、直した版の hook の入口を読むだけで当てた |
+| Claude Code | 変更なし（ゴールが無い） | 同じ | 同じ |
+| Grok | 変更なし（自動継続が無い） | 同じ | 同じ |
+| Cursor | 変更なし（自動継続が無い） | 同じ | 同じ |
+
+Linux の通し（2026-10-14 00:05〜00:14 JST）で見た事:
+
+- タスクを Codex Desktop で開くと、実行中のゴールを持つタスクは、入力を待たずに続行のターンを始めた。
+- 引き継ぎのたびに、止めたターンの直後から続行のターンが 0.15 秒ほどの間隔で来た。worker がゴールを止めるまでの1秒以内に 4〜5 回で、
+  その後は来ていない。8回とも `goalCarry` は `{"paused":true,"carried":"active"}`。
+- 最後の後継が作業を終えるとゴールは完了になり、Codex Desktop の画面の側が `thread/goal/clear` を送ってゴールを消した。
+
+macOS と Windows の本物の Codex Desktop の画面で、ゴールを持つタスクが引き継がれる通しは、公開の時点では確かめていない。

package/docs/adr/0060-claude-mid-turn-input-and-host-meta-rows.md

@@ -0,0 +1,123 @@
+# ADR 0060: Claude Code の、ターンの途中で届いた入力は依頼へ足し、host が書く meta の行ではターンを区切らない
+
+- Status: Accepted
+- Date: 2026-10-14
+
+## Context
+
+Claude Code の transcript から L2（`bodies`）を作る時、この製品は「本文を持つ user 行1つ + それに続く assistant の本文」を
+1つのターンとして読んでいた（`getLogicalTurnGroups`）。user 行なら何でもターンの始まりにし、`attachment` の行は L3 にだけ使っていた。
+
+2026-10-14、BellTeam のコンテナ（Linux、Claude Code 2.1.293・2.1.296、この製品は 0.16.27）の本物の transcript で、
+人の入力が L2 に入っていない形が3つ見つかった（本文は読んでいない。行の種類・印・長さ・時刻だけ）。
+
+### 1. ターンの途中で届いた入力
+
+Claude Code は、ターンが動いている間に届いた入力を、user 行ではなく `attachment` の行で書く。
+
+```text
+{"type":"attachment","attachment":{"type":"queued_command","prompt":…,"commandMode":"prompt","origin":{"kind":"human"},"humanTurn":true,…}}
+```
+
+`prompt` は文字列か、text と image の block の配列。裏の作業の完了通知も同じ形で届く（`commandMode: "task-notification"`、
+`origin.kind: "task-notification"`）。前後に `queue-operation` の `enqueue` と `remove` の行が並ぶ。ターンが終わるまで
+届けられなかった入力は、`dequeue` の後に普通の user 行になる（`promptSource: "queued"`）。
+
+10/10 からの 163 本で、人の入力の `queued_command` は 833 通あった（人の入力の user 行は 1,402）。L2 に入っていたのは 3 通
+（同じ文が別の行にもあった物）。作業中に打った文、ほかの席から差し込まれた文が、記憶に残っていなかった。
+
+### 2. host が書く meta の user 行
+
+Claude Code は、skill を読んだ時の本文や、端末で打った命令の注意書きを、`isMeta: true` の user 行で書く。`origin` は無い。
+skill の行は、直後に `attachment` の `command_permissions` が続く。
+
+この行をターンの始まりにしていたので、次の事が起きていた。
+
+- その行より前に assistant の本文が無いと、元の依頼は「本文の無い群」になって保存されない。meta の行の本文
+  （skill の手順）が、利用者の発言として保存される。
+- 本文があると、1つのターンが2つに割れる。
+- L3 は「最後の user 本文の行」から切り出すので、meta の行より前の道具の入出力が入らない。
+- 自動継続で止めたターンの依頼（`snapshotInFlight`）も「最後の user 本文」を読むので、後継へ運ぶ依頼が skill の本文になる。
+
+同じ 163 本で、`origin` の無い meta の行は 61 行（道具の後 27、人の入力の直後 11、meta の行の後 17、端末の命令の注意書き 6）。
+46 行が利用者の発言として L2 の群に入っていた。
+
+別の会話から届いた発言も `isMeta: true` だが、`origin.kind: "peer"` を持つ。届いた入力なので、今までどおりターンの始まりにする。
+
+### 3. ターンの終わりに続けて届いた待ち入力
+
+ターンの間に入力が2通以上たまると、ターンが終わった時に、2通が続けて user 行になる。2行とも `promptSource: "queued"` で、
+同じ `turnPosition.promptIndex` を持つ（同じ番へ届いた印）。
+
+1通目は「assistant の本文が無い群」になり、保存されなかった。ADR 0055 は、この形で Stop が失敗する事を直した時に
+「保存の欠けは無い」と書いたが、欠けていたのは完了したターンではなく、1通目の入力だった。同じ 163 本で 5 回。
+
+### ほかの host
+
+- Codex: ターンを host の開始と完了の印（`task_started`・`task_complete`）で区切り、その間の利用者の発言を全部持つ
+  （`codex-rollout-memory.mjs`）。同じ欠けは起きない作り。
+- Grok: `chat_history.jsonl` に、途中で届いた入力を表す別の行は見つからなかった（80 本）。人の入力の行が本文を挟まずに
+  続く形は 9 回あり、`prompt_index` は違っていた。止められたターンか、途中の入力かは分けていない。この ADR では扱わない。
+- Cursor: 10 本を見て、同じ形の行は無かった。
+
+## Decision
+
+1. **ターンの途中で届いた入力は、届いた先のターンの依頼へ、届いた順に足す。** `attachment` の `queued_command` で、
+   `origin.kind` が `human` か `peer` の物。直前に返した user の行の本文の後ろへ、空行・見出しの1行
+   （`（作業の途中で届いた入力）`）・本文の順で足す。本文は user 行と同じ正規化を通す（端末の制御の除去、別の会話の注意書きの除去）。
+   - `turn_number` は進めない。`attachment` は今までも本文行に数えていない。保存済みの番号とずれない。
+   - 完了通知（`origin.kind: "task-notification"`）は足さない。そのターン自身の裏の作業の結果で、L3 に残っている。
+   - `origin` の無い物、`isSidechain: true` の物、足す先の user 行がまだ無い物は足さない。
+   - ターンの始まり方（`start`）は変えない。完了通知で始まったターンへ人の入力が届いても、`self` のまま。
+2. **`isMeta: true` で `origin.kind` の無い user 行は、ターンの始まりにも本文にもしない**（`isClaudeHostWrittenMetaEntry`）。
+   圧縮の要約行（ADR 0032）と同じ扱い。`turn_number` は進める（その行を数えていた頃に保存した番号とずれない）。
+   L3 の切り出し（`sliceCurrentTurnEntries`・`sliceInFlightTurnEntries`）も、この行で区切らない。
+3. **同じ番へ続けて届いた user 行は、1つの依頼にまとめる。** 直前の user 行との間に assistant の本文が無く、両方が
+   `origin.kind` を持ち、`turnPosition.promptIndex` が同じ整数の時。空行でつなぐ。`turn_number`・時刻・`start`・`prompt_id` は
+   1通目の物。`turn_number` は2通目の分も進める。
+   - `promptIndex` が違う行、印の無い行、`origin` の無い行（端末で打った命令）は、まとめない。止められて本文を書かなかった
+     ターンの依頼は、今までどおり保存されない。
+4. 判定は、host が transcript に書いた印（`type`・`isMeta`・`origin.kind`・`turnPosition`）だけで行う。本文は読まない。
+5. 保存済みのターンは書き直さない。直しが効くのは、この版が取り込むターンから。
+
+## Consequences
+
+- 作業中に打った文と、ほかの席から差し込まれた文が、そのターンの利用者の発言として L2 に残る。引き継ぎの記憶と、
+  自動継続で後継へ運ぶ依頼（`in_flight.user`）にも入る。
+- 利用者の発言の行が長くなる。見出しの1行は、この製品が足した文で、利用者の文ではない。
+- skill の本文は L2 に入らなくなる（L3 には `Skill` の道具の入出力として残る）。
+- 前の版が取り込んだ会話では、meta の行で割れていた2つの群が1つにまとまる。`backfillBodies` は「群の断片の番号が1つでも
+  保存済みなら回収しない」ので、行は増えない。前の版が落とした依頼と途中の入力は、さかのぼっては入らない。
+- Stop の flush barrier（ADR 0026・0055）は `readTranscript` の上で動く。続けて届いた待ち入力は1つの群になるので、
+  「本文の無い群を飛ばす」場面が減る。飛ばす作りは残す（`promptIndex` の無い版の Claude Code、止められたターン）。
+- `auditor-context` と `caveat-context` の鮮度の照合は、transcript の最後の群の依頼と、保存済みの行の hash を比べる。
+  前の版が取り込んだ最後のターンに途中の入力や meta の行があると、版を上げた直後の1回だけ合わない（次のターンからは合う）。
+- 途中の入力がターンの最後の本文より後に書かれた時も、そのターンの依頼へ足す。Stop の取り込みがもう済んでいれば、
+  その入力は L2 に入らない（保存済みの行は書き直さない）。実物では見ていない。
+
+## 確かめた事・確かめていない事
+
+- 確かめた:
+  - 単体試験（途中の入力の文字列と配列、完了通知・sidechain・印なしを足さない、別の会話からの文、足す先が無い時、meta の行、
+    `origin` を持つ meta の行、続けて届いた待ち入力、まとめない3つの形、L3 の切り出し、前の版が保存した行と重ねない事、
+    止めたターンの取り込み）。直す前の版では、形を表す5本が落ちる。
+  - 本物の transcript へ、前の版と直した版の読み手を当てて比べた（DB は開かない。数だけ）。3つの OS とも、assistant の行の番号は
+    全部同じで、直した版の代表の番号に、前の版に無い物は 0。
+
+    | | 本数 | 群 | 人の入力の user 行が群の依頼にある数 | 途中の人の入力が群の依頼にある数 | 利用者の発言になっていた meta の行 |
+    |---|---|---|---|---|---|
+    | Linux（コンテナ） | 163 | 1,661 → 1,634 | 1,385 → 1,401（1,402 のうち） | 3 → 832（833 のうち） | 46 → 0 |
+    | macOS | 103 | 1,265 → 1,246 | 905 → 910（926 のうち） | 0 → 121（122 のうち） | 36 → 0 |
+    | Windows | 108 | 922 → 899 | 324 → 335（369 のうち） | 2 → 111（119 のうち） | 51 → 0 |
+
+    入らなかった途中の入力は、3つの OS とも全部「依頼へは足されたが、そのターンに assistant の本文が無い」物だった
+    （止められたターン。完了したターンの回収には出ない）。
+  - 別の会話からの文（`origin.kind: "peer"`）が、ターンの途中に `queued_command` で届く実物は、Windows に 187 通あった
+    （`commandMode: "prompt"`。頭は地の文か `<cross-session-message>`）。同じ扱いで依頼へ足される。
+  - 本物の Stop の入口（`process-turn`）へ、本物の transcript の写しを、使い捨ての HOME で通した。空の DB から（Linux 3 本、
+    macOS 4 本、Windows 2 本）: 途中の人の入力の数だけ見出しが入り、2回目の Stop は 0 行。前の版で取り込んだ後に直した版で
+    通す（Linux 3 本、macOS 4 本、Windows 1 本）: 行は増えない。
+- 確かめていない:
+  - 直した版を入れた端末で、本物の Claude Code が、途中の入力のあるターンを終えた時の L2。入れた後の追跡で読む。
+  - `turnPosition` を書かない版の Claude Code。その時は 3 が効かず、今までと同じ動きになる。`origin` を書かない版の
+    `queued_command`（macOS と Windows の古い行にある）は、足さない。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-  "version": "0.16.27",
+  "version": "0.16.29",
   "type": "module",
   "description": "Persistent memory hooks for Claude Code, Codex, Grok, and Cursor (/clear-safe context compression)",
   "keywords": [

package/src/cli/auto-handoff.mjs

@@ -5,7 +5,8 @@ import { getDb, openReadOnlyDb, DB_PATH, CURRENT_VERSION } from '../db.mjs';
 import { listAutoHandoffs, getAutoHandoff } from '../codex-auto-handoff-store.mjs';
 import { renderFrozenDetail } from '../codex-auto-handoff-memory.mjs';
 import { readAutoHandoffConfig, writeAutoHandoffConfig } from '../codex-auto-handoff-config.mjs';
-import { autoHandoffDeliveryProfile, runAutoHandoffWorker, markAutoHandoffSources, resolveAutoHandoffSuccessor } from '../codex-auto-handoff.mjs';
+import { autoHandoffDeliveryProfile, runAutoHandoffWorker, markAutoHandoffSources, resolveAutoHandoffSuccessor,
+  settleAutoHandoffSourceGoal } from '../codex-auto-handoff.mjs';
 import { installCodexAutoHandoffHook, installClaudeAutoHandoffHooks, removeClaudeAutoHandoffHooks,
   claudeAutoHandoffHooksRegistered } from './install.mjs';
 import { sameProjectPath } from '../project-path.mjs';
@@ -19,9 +20,9 @@ const CLAUDE_ACTIONS = ['enable', 'disable', 'status', 'worker', 'desktop-open',
 
 export function parseAutoHandoffArgs(args) {
   const out = { action: args[0] ?? 'status', host: 'codex', operation: null, project: null, origin: null, turn: null, database: null, thread: null, json: false, dryRun: false };
-  if (!['enable', 'disable', 'status', 'resume', 'detail', 'worker', 'desktop-open', 'mark-sources', 'successor'].includes(out.action)) throw Error('auto_handoff_action_invalid');
+  if (!['enable', 'disable', 'status', 'resume', 'detail', 'worker', 'desktop-open', 'mark-sources', 'successor', 'settle-goal'].includes(out.action)) throw Error('auto_handoff_action_invalid');
   const allowed = ['host', ...{ enable: ['project'], disable: [], status: ['project', 'operation'],
-    resume: ['operation'], worker: ['operation'], 'desktop-open': ['operation'], 'mark-sources': [], successor: ['thread'], detail: ['operation', 'origin', 'turn', 'database'] }[out.action]];
+    resume: ['operation'], worker: ['operation'], 'desktop-open': ['operation'], 'mark-sources': [], successor: ['thread'], 'settle-goal': ['operation', 'thread'], detail: ['operation', 'origin', 'turn', 'database'] }[out.action]];
   const seen = new Set();
   for (let i = 1; i < args.length; i++) {
     if (seen.has(args[i])) throw Error('auto_handoff_argument_invalid');
@@ -36,8 +37,8 @@ export function parseAutoHandoffArgs(args) {
   if (out.host === 'claude' ? !CLAUDE_ACTIONS.includes(out.action) : out.action === 'desktop-open') throw Error('auto_handoff_action_unsupported');
   if (out.project && !isAbsolute(out.project)) out.project = resolve(out.project);
   if (out.project && out.operation) throw Error('auto_handoff_argument_invalid');
-  if (['worker', 'resume', 'detail', 'desktop-open'].includes(out.action) && !out.operation) throw Error('auto_handoff_operation_required');
-  if (out.action === 'successor' && !out.thread) throw Error('auto_handoff_thread_required');
+  if (['worker', 'resume', 'detail', 'desktop-open', 'settle-goal'].includes(out.action) && !out.operation) throw Error('auto_handoff_operation_required');
+  if (['successor', 'settle-goal'].includes(out.action) && !out.thread) throw Error('auto_handoff_thread_required');
   if (out.action === 'detail') {
     out.turn = Number(out.turn);
     if (!out.origin || !Number.isSafeInteger(out.turn) || out.turn < 1) throw Error('auto_handoff_detail_identity_required');
@@ -146,6 +147,9 @@ export async function run(args = []) {
       // 0.16.9 までの版が引き継いだ分の名前を付け直す（名前の無い後継へ名前、旧タスクへ引き継ぎ済みの印）。何度流しても同じ結果になる。
       const db = getDb();
       result = { status: 'ok', dry_run: parsed.dryRun, ...await markAutoHandoffSources(db, { dryRun: parsed.dryRun }) };
+    } else if (parsed.action === 'settle-goal') {
+      // 引き継ぎ済みの旧タスクに動いたまま残ったゴールを止めて、今の後継へ運ぶ（hook が起こす。ADR 0059）。
+      result = await settleAutoHandoffSourceGoal(getDb(), { operationId: parsed.operation, threadId: parsed.thread });
     } else if (parsed.action === 'worker') {
       result = publicOperation(await runAutoHandoffWorker(parsed.operation));
     } else if (parsed.action === 'resume') {

package/src/cli/grok-continue.test.mjs

@@ -1,9 +1,9 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
 import { spawnSync } from 'node:child_process';
-import { readFileSync } from 'node:fs';
+import { readFileSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import {
@@ -141,7 +141,7 @@ test('missing grok binary does not spawn', () => {
   assert.equal(spawned.length, 0);
 });
 
-test('successful continue spawn uses source project cwd and waits', () => {
+test('successful continue spawn uses source project cwd and waits', (t) => {
   const io = capture();
   const spawned = [];
   const uuid = '22222222-2222-4222-8222-222222222222';
@@ -164,6 +164,7 @@ test('successful continue spawn uses source project cwd and waits', () => {
   assert.equal(spawned.length, 1);
   assert.equal(io.out, `grok:${uuid}\n`);
   const { grokArgv, launchFile, cwd } = spawned[0];
+  t.after(() => rmSync(dirname(launchFile), { recursive: true, force: true }));
   assert.equal(cwd, REPO_ROOT);
   assert.equal(grokArgv.includes('--rules'), false);
   assert.ok(grokArgv.at(-1).includes(CONTEXT));
@@ -232,7 +233,11 @@ test('bin usage error is exit 2 without spawning a real grok', () => {
   const result = spawnSync(process.execPath, [BIN_PATH, 'grok-continue'], {
     cwd: REPO_ROOT,
     encoding: 'utf8',
-    env: { ...process.env, HOME: join(tmpdir(), 'tl-grok-continue-missing-home') },
+    env: {
+      ...process.env,
+      HOME: join(tmpdir(), 'tl-grok-continue-missing-home'),
+      USERPROFILE: join(tmpdir(), 'tl-grok-continue-missing-home'),
+    },
   });
   assert.equal(result.status, 2);
   assert.match(result.stderr, /Usage: throughline grok-continue --session <id>/);

package/src/cli/runtime-errors.test.mjs

@@ -1,9 +1,8 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
 import { spawnSync } from 'node:child_process';
-import { mkdtempSync } from 'node:fs';
-import { tmpdir } from 'node:os';
 import { join } from 'node:path';
+import { testTempDir } from '../test-temp-dir.mjs';
 import { fileURLToPath } from 'node:url';
 
 import { parseArgs, run } from './runtime-errors.mjs';
@@ -43,7 +42,7 @@ test('runtime-errors CLI: internal failure is fixed and does not reflect excepti
 });
 
 test('runtime-errors CLI: snapshot and diagnostics are JSON-only and contain no state path', () => {
-  const root = mkdtempSync(join(tmpdir(), 'throughline-runtime-cli-'));
+  const root = testTempDir('throughline-runtime-cli-');
   const env = {
     ...process.env,
     HOME: root,