throughline 0.16.20 → 0.16.21

package/CHANGELOG.md

@@ -10,6 +10,28 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.21] — 2026-10-11
+
+### 修正
+
+- Claude Codeの自動継続で、受領を確かめられなかった引き継ぎ（`unknown`）の後継をClaude Desktopへ移す処理が、1回しか起きなかった（0.16.19で入れた処理の漏れ。[ADR 0049](docs/adr/0049-claude-handoff-uses-registered-project.md)）。1回目のStopで後継のsession idを記録へ入れるが、次のStopで記録を探す条件は「session idがまだ無い」だった。1回目に後継が手すきにならずに戻ると、その後のターンの終わりでは何も起きず、後継は裏の会話のまま残った。Windowsの実機で1回起きた（2026-10-10 23:43の引き継ぎ。1回目は10-11 02:51で、後継は保留の文で`waiting`だった。その後の09:10と10:03のターンの終わりでは、移す処理が起きなかった）。
+  - session idが記録にある時は、そのidが同じ会話のStopで、同じ記録からやり直す。短いIDの先頭一致で探すのは、session idがまだ無い時だけ。
+  - 受領が残った引き継ぎ（`sent`）の後継は、今までもやり直していた。変えていない。
+
+### 対応の範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Claude Code | 直した。単体試験と、実機（Claude Code 2.1.289）。試験用の場所の記録と本物の`claude agents`で、0.16.20は戻った後のStopで何もせず、直した版は移すprocessをもう1回起こす事 | 記録を探す処理は同じ物なので直っている。単体試験と、実機（Claude Code 2.1.296）で同じ確認。ただしClaude Desktopへ移す処理は、Linuxでは起動しない（Claude Codeの`--desktop`が無い） | 直した。単体試験と、実機（Claude Code 2.1.296）で同じ確認。この失敗が起きた本物の記録を試験用の場所へ写した物でも、0.16.20は何もせず、直した版は移すprocessを起こす事 |
+| Codex | 変更なし（引き継ぎの部品が別。Desktopへ移す処理が無い） | 同じ | 同じ |
+| Grok | 変更なし（自動継続が無い） | 同じ | 同じ |
+| Cursor | 変更なし（自動継続が無い） | 同じ | 同じ |
+
+### 確かめていない事
+
+- 本物の引き継ぎで、受領を確かめられなかった後継が、2回目より後のStopでClaude Desktopへ移る所。0.16.19より後、受領を確かめられない引き継ぎは起きていない（狙って起こせない）。
+- この失敗が起きた会話（2026-10-10 23:43の後継）は、直す前に次の後継へ引き継いだ。作業は次の後継が続けていて、この会話はDesktopへ移さない。
+
 ## [0.16.20] — 2026-10-11
 
 ### 修正
@@ -2331,7 +2353,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.20...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.21...HEAD
+[0.16.21]: https://github.com/kitepon/Throughline/compare/v0.16.20...v0.16.21
 [0.16.20]: https://github.com/kitepon/Throughline/compare/v0.16.19...v0.16.20
 [0.16.19]: https://github.com/kitepon/Throughline/compare/v0.16.18...v0.16.19
 [0.16.18]: https://github.com/kitepon/Throughline/compare/v0.16.17...v0.16.18

package/docs/adr/0049-claude-handoff-uses-registered-project.md

@@ -33,6 +33,9 @@ Claude Code の自動継続は、PreCompact の hook で、後継を立てる pr
 3. 受領を確かめられなかった引き継ぎ（`unknown`、後継の短い ID だけが記録にある）でも、その後継がターンを終えたら、
    Desktop へ移す。継続の指示は起動時の引数で渡してあるので、ターンを終えた後継は指示を受けている。
    後継の session id を記録へ入れる。`state` と `error_code` は変えない（記憶が合流しなかった事は、記録に残す）。
+   移す process が後継の手すきを待ち切れずに戻った時は、次の Stop で同じ記録からやり直す。この時は、記録に入れた
+   session id が同じ会話だけを対象にする（0.16.21。0.16.19 と 0.16.20 は、session id が無い記録だけを探していて、
+   2回目より後の Stop では何も起きなかった。Windows の実機で 2026-10-11 に1回起きた）。
 4. 後継が立たなかった引き継ぎ（`failed`）は、今までどおり何もしない。
 
 ## Consequences

package/package.json

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

package/src/claude-auto-handoff.mjs

@@ -833,9 +833,10 @@ export async function requestClaudeDesktopOpen({ sessionId, transcriptPath = nul
   const waiting = listClaudeAutoHandoffs({ dir }).filter(item => item.desktop?.wanted && !item.desktop.state);
   // 受領を確かめられなかった引き継ぎ（unknown）は、後継の session id が記録に無い。その後継がターンを終えたなら、
   // 後継は動いている。裏の会話のまま残さず、同じように Desktop へ移す（ADR 0049）。
+  // 1回目の Stop で session id を記録へ入れるので、移せずに戻った後の Stop は、その id で同じ記録を見つける。
   const record = waiting.find(item => item.state === 'sent' && item.successor?.session_id === sessionId) ??
-    waiting.find(item => item.state === 'unknown' && !item.successor?.session_id &&
-      typeof item.successor?.short_id === 'string' && sessionId.startsWith(item.successor.short_id));
+    waiting.find(item => item.state === 'unknown' && typeof item.successor?.short_id === 'string' &&
+      (item.successor.session_id ? item.successor.session_id === sessionId : sessionId.startsWith(item.successor.short_id)));
   if (!record) return null;
   const successor = { ...record.successor, session_id: sessionId };
   if (typeof transcriptPath === 'string' && transcriptPath) successor.transcript_path = transcriptPath;

package/src/claude-auto-handoff.test.mjs

@@ -796,6 +796,16 @@ test('Stop: 受領を確かめられなかった引き継ぎ（unknown）でも
     '受領を確かめられなかった事は、記録に残したままにする');
   assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), null, '2回目の Stop では起動しない');
 
+  // 移す process が、手すきを待ち切れずに戻った（fox の実物、2026-10-11 02:51）。記録には後継の session id が入っている。
+  // 次の Stop で、同じ記録からやり直す
+  const busy = await runClaudeDesktopOpen(SESSION, { dir, env: {}, pollMs: 10, idleTimeoutMs: 40, pty: () => { throw new Error('must not open'); },
+    spawn: (command, args) => { assert.equal(args[0], 'agents'); return { status: 0, stdout: JSON.stringify([{ id: SUCCESSOR.slice(0, 8), kind: 'background', status: 'busy' }]) }; } });
+  assert.deepEqual([busy.state, busy.desktop.state, busy.successor.session_id], ['unknown', null, SUCCESSOR]);
+  assert.equal(await requestClaudeDesktopOpen({ sessionId: `${SUCCESSOR.slice(0, 8)}-0000-4000-8000-000000000009`, dir, launch }), null, '短い ID が同じでも、別の会話の Stop では動かない');
+  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), `h-${SESSION}`, '戻った後の Stop でやり直す');
+  assert.deepEqual(launched, [SESSION, SESSION]);
+  assert.equal(readClaudeAutoHandoff(SESSION, dir).desktop.state, 'requested');
+
   // 移す process は、その記録で後継を止めて Desktop で開く
   const calls = [];
   const opened = await runClaudeDesktopOpen(SESSION, { dir, env: {}, pollMs: 10, idleTimeoutMs: 500,