throughline 0.16.21 → 0.16.22

package/CHANGELOG.md

@@ -10,6 +10,31 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.22] — 2026-10-11
+
+### 変更
+
+- **Claude Codeの自動継続で、後継をClaude Desktopへ移す処理を、既定で無効にした**（[ADR 0051](docs/adr/0051-claude-successor-desktop-move-is-opt-in.md)）。後継は裏の会話のまま残り、リモートコントロール（claude.ai/codeとClaudeのアプリ）、`claude agents`、`claude attach <id>`で見られる。Claude Desktopの一覧には出ない。
+  - 今までは、Claude Desktopから始まった会話の後継がターンを終えるたびに、`claude stop`で止めて`claude --desktop --resume`で開き直していた。Windowsの実機で2026-10-11に2回（10:31、10:39）、オーナーがスマホから話している最中の会話が消えた。止めると、起動時に付けたリモートコントロールの接続が切れ、移った先のDesktopの会話ではリモートコントロールが有効になっていなかった。1回目は、会話が裏で走らせていた命令（`run_in_background`）も一緒に止まった。作業ツリーで作業していた会話は、開き直した後のcwdが元のrepositoryになった。
+  - 0.16.20（保留の文を持つ後継も移す）で、それまで移らなかった会話が移るようになり、この2回が起きた。保留の文が無い会話では、0.16.8（macOS）と0.16.9（Windows）から同じ事が起きていた。
+  - 環境変数`THROUGHLINE_AUTO_HANDOFF_OPEN`を`origin`にすると、今までの既定（Desktopから始まった会話の後継だけ移す）で動く。`desktop`は出どころに関係なく移す。未設定とそれ以外の値は移さない。
+  - 0.16.21までの版が「移す」と記録した引き継ぎの後継も、有効にしていなければ移さない。
+- 旧い会話を止めた理由の文を直した。移さない時は「後継の会話は裏で作業を続けます」と書き、リモートコントロール付きの時はその事も書く。
+
+### 対応の範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Claude Code | 止めた。単体試験と、実機（Claude Code 2.1.289）。試験用の場所の記録で、入っていた0.16.20は移すprocessを起こし、この版は未設定では起こさず（記録も変えない）、`origin`では起こす事 | 元から移す処理が動かない（Claude Codeの`--desktop`が無い）。単体試験と、実機（2.1.296）で、記録を探す処理が同じ結果になる事 | 止めた。単体試験と、実機（Claude Code 2.1.296）で同じ確認。今日消えた会話を移した本物の記録の写しでも、未設定では起こさない事 |
+| Codex | 変更なし（Desktopへ移す処理が無い。後継は最初からCodex Desktopのタスク） | 同じ | 同じ |
+| Grok | 変更なし（自動継続が無い） | 同じ | 同じ |
+| Cursor | 変更なし（自動継続が無い） | 同じ | 同じ |
+
+### 確かめていない事
+
+- この版での本物の引き継ぎ。後継がターンを終えても裏の会話のまま残り、スマホから見え続ける所。
+- 0.16.21までに移した会話（Desktopの会話になっている）へ、リモートコントロールを付け直す方法。
+
 ## [0.16.21] — 2026-10-11
 
 ### 修正
@@ -2353,7 +2378,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.21...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.22...HEAD
+[0.16.22]: https://github.com/kitepon/Throughline/compare/v0.16.21...v0.16.22
 [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

package/README.md

@@ -68,7 +68,7 @@ throughline auto-handoff disable --host claude
 3. 同じprojectに、継続の指示を最初の指示として付けた新しいClaudeの会話を裏で立てます（`claude --bg`）。会話の名前は、前任の会話の題から`<project名>｜<作業の概要>（自動引き継ぎ）`にします。モデル・推論強度・権限は旧い会話から引き継ぎます。
 4. 最初の指示を受け取った時に、止めた時点の依頼、そのターンでここまでにしたこと（発言と道具の呼び出し）、実行されなかった道具、直近の会話の原文を注入します（上限9,500字）。止めたターンの道具の入出力は、後継が`throughline detail`で取り出せます。
 
-続きは裏の会話で動きます。`claude agents`の一覧と`claude attach <id>`で見られます。Claude Desktopの画面から始まった会話の後継は、そのターンの作業を終えた時に、Claude Desktopへ移して開きます（macOSは0.16.8から、Windowsは0.16.9から。LinuxのClaude Codeには`--desktop`が無いので開きません。[ADR 0043](docs/adr/0043-claude-successor-opens-in-desktop.md)）。Claude Codeは裏で動いている会話をDesktopへ移さないので、作業の間はDesktopには出ません。続けて引き継いだ時は、最後に作業を終えた後継だけを開きます。ほかの会話から`SendMessage`で届いた文をClaude Codeが承認待ちで保留している後継も、ターンが終わっていれば開きます。その時に保留されている文は、会話へ届かずに消えます（0.16.20から。[ADR 0050](docs/adr/0050-claude-successor-with-held-peer-message-moves-to-desktop.md)）。端末から始めた会話の後継は開きません。手で開く時は、`claude stop <id>`で裏の実行を停止し、`claude --desktop --resume <session-id>`を実行します。`session-id`は`claude agents --json --all`の`sessionId`です。環境変数`THROUGHLINE_AUTO_HANDOFF_OPEN`を`desktop`にすると出どころに関係なく開き、`off`にすると開きません。手動`/compact`、subagentの中の圧縮、`claude -p`などscriptから起動した会話は対象に含めません。 Claude Desktopから始まった会話の後継は、リモートコントロール付きで立てるので、作業の最中もclaude.ai/codeとClaudeのアプリから見られます（0.16.16から。[ADR 0048](docs/adr/0048-claude-desktop-origin-successor-has-remote-control.md)）。
+続きは裏の会話で動きます。`claude agents`の一覧と`claude attach <id>`で見られます。後継をClaude Desktopへ移す処理は、0.16.22から既定で無効です（[ADR 0051](docs/adr/0051-claude-successor-desktop-move-is-opt-in.md)）。移す時は裏の会話を`claude stop`で止めて開き直すので、リモートコントロールの接続が切れ、裏で走らせていた命令も止まり、話している最中の会話が消えます。環境変数`THROUGHLINE_AUTO_HANDOFF_OPEN`を`origin`にすると、Claude Desktopの画面から始まった会話の後継だけ、そのターンの作業を終えた時にClaude Desktopへ移して開きます（macOSとWindows。LinuxのClaude Codeには`--desktop`が無いので開きません。[ADR 0043](docs/adr/0043-claude-successor-opens-in-desktop.md)）。`desktop`にすると出どころに関係なく開きます。移す処理が有効な時は、ほかの会話から`SendMessage`で届いた文をClaude Codeが承認待ちで保留している後継も、ターンが終わっていれば開き、保留されている文は会話へ届かずに消えます（[ADR 0050](docs/adr/0050-claude-successor-with-held-peer-message-moves-to-desktop.md)）。手で開く時は、`claude stop <id>`で裏の実行を停止し、`claude --desktop --resume <session-id>`を実行します。`session-id`は`claude agents --json --all`の`sessionId`です。手動`/compact`、subagentの中の圧縮、`claude -p`などscriptから起動した会話は対象に含めません。 Claude Desktopから始まった会話の後継は、リモートコントロール付きで立てるので、作業の最中もclaude.ai/codeとClaudeのアプリから見られます（0.16.16から。[ADR 0048](docs/adr/0048-claude-desktop-origin-successor-has-remote-control.md)）。
 
 ```bash
 throughline auto-handoff status --host claude --operation <handoff-id> --json

package/docs/adr/0051-claude-successor-desktop-move-is-opt-in.md

@@ -0,0 +1,47 @@
+# ADR 0051: Claude Code の後継を Claude Desktop へ移す処理は、既定で無効にする
+
+- Status: Accepted
+- Date: 2026-10-11
+- Supersedes: [ADR 0043](0043-claude-successor-opens-in-desktop.md) の既定（Desktop から始まった会話の後継を、ターンの後に移す）
+- Related: [ADR 0048](0048-claude-desktop-origin-successor-has-remote-control.md)、[ADR 0049](0049-claude-handoff-uses-registered-project.md)、[ADR 0050](0050-claude-successor-with-held-peer-message-moves-to-desktop.md)
+
+## Context
+
+Claude Code の自動継続は、後継を裏の会話（`claude --bg`）で立てる。Claude Desktop から始まった会話の後継は、
+リモートコントロール付きで立て（ADR 0048）、ターンを終えた時に `claude stop` で止めて `claude --desktop --resume` で
+Desktop へ開き直していた（ADR 0043）。
+
+2026-10-11、Windows の実機で、オーナーがスマホ（リモートコントロール）から後継と話している最中に、会話が続けて消えた。
+
+- 10:31:43 と 10:39:50 ごろの2回。どちらも、後継がターンを終えた（返事を返した）直後に、Throughline が止めて Desktop へ移した。
+- 止めると、Throughline が起動時に付けたリモートコントロールの接続が切れる。移った先の Desktop の会話は、
+  リモートコントロールが有効になっていなかった。スマホと claude.ai/code からは、会話が消えたままになる。
+- 1回目の会話は、裏で命令を走らせ（`run_in_background`）、その結果を待つ形でターンを終えていた。止めた時に、その命令も
+  止まった（`task-notification` の `status` は `stopped`）。移った後の会話は、その知らせを受けたまま手すきで止まった。
+- 1回目の会話は作業ツリーで作業していたが、Desktop で開き直した後の cwd は、会話を立てた元の repository だった。
+- ADR 0050（0.16.20、同じ日の 09:16 公開）で、保留の文を持つ会話も移すようにした。それまで移らずに済んでいた会話が
+  移るようになり、この2回が起きた。保留の文が無い会話では、0.16.8（macOS）と 0.16.9（Windows）から同じ事が起きていた。
+
+「ターンが終わった」は「作業が終わった」ではなかった。利用者が話している最中の会話も、裏の命令を待っている会話も、
+ターンは終わる。その会話を止めて別の場所へ開き直すと、利用者は会話を見失う。
+
+## Decision
+
+1. 後継を Claude Desktop へ移す処理は、既定で無効にする。後継は、裏の会話のまま残す。リモートコントロール（ADR 0048）、
+   `claude agents`、`claude attach <id>` で見られる。
+2. 環境変数 `THROUGHLINE_AUTO_HANDOFF_OPEN` が `origin` の時だけ、今までの既定（Desktop から始まった会話の後継を、
+   ターンの後に移す）で動く。`desktop` は、出どころに関係なく移す（今までと同じ）。それ以外の値と未設定は、移さない。
+3. 0.16.21 までの版が「移す」と記録した引き継ぎ（`desktop.wanted: true`、`desktop.state` が空）の後継も、
+   有効にしていなければ移さない。記録は書き換えない。
+4. リモートコントロール付きで立てる処理（ADR 0048）は変えない。
+
+## Consequences
+
+- 利用者が話している会話を、Throughline が止める事は無くなる。裏の命令も、保留の文も、リモートコントロールの接続も残る。
+- Claude Desktop の一覧には、後継が出ない。Desktop の画面だけを見ている利用者は、引き継ぎの後の会話を Desktop では
+  見つけられない。旧い会話の止めた理由に、後継の短い ID（`claude attach <id>`）とリモートコントロールで見られる事を書く。
+- Desktop へ移したい時は、今までどおり手で `claude stop <id>` と `claude --desktop --resume <session-id>` を使える。
+- 移す処理をもう一度既定にするかは、オーナーの裁定を待つ。その時は、少なくとも次を満たす。話している最中の会話を
+  止めない。裏の命令が走っている会話を止めない。移した先でリモートコントロールが続く。作業ツリーの会話は作業ツリーで開く。
+- ADR 0050 の「保留の文を持つ後継も移す」と、ADR 0049 の「受領を確かめられなかった後継も移す」は、移す処理を
+  有効にした時だけ働く。

package/package.json

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

package/src/claude-auto-handoff.mjs

@@ -60,7 +60,7 @@ const PER_SESSION_ENV = ['CLAUDECODE', 'CLAUDE_CODE_ENTRYPOINT', 'CLAUDE_CODE_ME
 
 // Claude Desktop の画面から始まった会話が transcript に持つ印。
 const DESKTOP_ENTRYPOINT = 'claude-desktop';
-// 後継を Desktop で開くかを、会話の出どころに関係なく決める（`desktop` で必ず開く、`off` で開かない）。
+// 後継を Desktop へ移すか。既定は移さない（ADR 0051）。`origin` は Desktop から始まった会話の後継だけ、`desktop` は出どころに関係なく移す。
 const OPEN_OVERRIDE_ENV = 'THROUGHLINE_AUTO_HANDOFF_OPEN';
 // 後継をリモートコントロール付きで立てるかの上書き。`on` は出どころに関係なく付け、`off` は付けない。
 const REMOTE_CONTROL_OVERRIDE_ENV = 'THROUGHLINE_AUTO_HANDOFF_REMOTE_CONTROL';
@@ -214,14 +214,26 @@ function readLatestEntrypoint(transcriptPath) {
 }
 
 /**
- * この会話の後継を、Claude Desktop で開くか。
- * Desktop の画面から始まった会話と、その後継がさらに引き継ぐ時だけ開く。端末から始めた会話の後継は
+ * 後継を Claude Desktop へ移す処理を、利用者が有効にしているか（ADR 0051）。既定は無効。
+ * 移す時は、裏の会話を `claude stop` で止めて Desktop で開き直す。止めると、その会話のリモートコントロールの接続が切れ
+ * （スマホと claude.ai/code から会話が消える）、裏で走らせていた命令も止まる。利用者が話している最中の会話でも起きる。
+ * `THROUGHLINE_AUTO_HANDOFF_OPEN` が `origin`（Desktop から始まった会話の後継だけ）か `desktop`（出どころに関係なく）の時だけ移す。
+ */
+function desktopOpenMode(env) {
+  const mode = env[OPEN_OVERRIDE_ENV];
+  return mode === 'origin' || mode === 'desktop' ? mode : 'off';
+}
+
+/**
+ * この会話の後継を、Claude Desktop で開くか。既定では開かない（ADR 0051）。
+ * `origin` の時は、Desktop の画面から始まった会話と、その後継がさらに引き継ぐ時だけ開く。端末から始めた会話の後継は
  * `claude agents` の一覧に出るので、Desktop へは移さない。Claude Code の `--desktop` があるのは macOS と Windows だけ
  * （Linux は `--desktop isn't available on this platform` で断る）。
  */
 function openInDesktopWanted({ sessionId, transcriptPath, env, dir, platform }) {
-  if (!['darwin', 'win32'].includes(platform) || env[OPEN_OVERRIDE_ENV] === 'off') return false;
-  if (env[OPEN_OVERRIDE_ENV] === 'desktop') return true;
+  const mode = desktopOpenMode(env);
+  if (!['darwin', 'win32'].includes(platform) || mode === 'off') return false;
+  if (mode === 'desktop') return true;
   if (env.CLAUDE_CODE_ENTRYPOINT === DESKTOP_ENTRYPOINT || readLatestEntrypoint(transcriptPath) === DESKTOP_ENTRYPOINT) return true;
   return listClaudeAutoHandoffs({ dir }).some(record => record.successor?.session_id === sessionId && record.desktop?.wanted);
 }
@@ -531,9 +543,9 @@ function stopOutput(record) {
     ? `この会話はThroughlineが新しい会話へ引き継ぎ済みです（引き継ぎID: ${record.handoff_id}）。続きは後継の会話で行ってください: claude attach ${record.successor.short_id}`
     : `Throughlineが、自動圧縮の代わりに新しい会話へ引き継ぎます（引き継ぎID: ${record.handoff_id}）。` +
       (record.desktop?.wanted
-        ? '後継の会話は裏で作業を続け、そのターンを終えた時にClaude Desktopへ開きます。途中の様子は `claude agents` の一覧で見られます。' +
-          (record.remote_control?.wanted ? '後継はリモートコントロール付きで立てるので、claude.ai/code とClaudeのアプリからも見られます。' : '')
-        : '後継の会話は `claude agents` の一覧に出ます。');
+        ? '後継の会話は裏で作業を続け、そのターンを終えた時にClaude Desktopへ開きます。途中の様子は `claude agents` の一覧で見られます。'
+        : '後継の会話は裏で作業を続けます。`claude agents` の一覧に出ます。') +
+      (record.remote_control?.wanted ? '後継はリモートコントロール付きで立てるので、claude.ai/code とClaudeのアプリからも見られます。' : '');
   return {
     continue: false,
     stopReason: reason,
@@ -821,13 +833,15 @@ export async function launchClaudeDesktopOpen(sessionId, { dir = claudeAutoHando
 
 /**
  * 後継の Stop hook から呼ぶ。Claude Desktop で開く引き継ぎの後継が、ターンを終えた。
- * その会話を Desktop へ移す process を起動する。対象でない会話には何もしない（null）。
+ * その会話を Desktop へ移す process を起動する。対象でない会話と、移す処理が無効（既定）の時は何もしない（null）。
  * `transcriptPath` は、その後継の transcript（Stop の payload の値）。移す process が、ターンが終わっているかを読む（ADR 0050）。
  *
  * @returns {Promise<string|null>} 起動した時は、その引き継ぎ ID
  */
-export async function requestClaudeDesktopOpen({ sessionId, transcriptPath = null, dir = claudeAutoHandoffDir(), launch = launchClaudeDesktopOpen }) {
+export async function requestClaudeDesktopOpen({ sessionId, transcriptPath = null, dir = claudeAutoHandoffDir(), launch = launchClaudeDesktopOpen, env = process.env }) {
   if (!validSessionId(sessionId)) return null;
+  // 既定では移さない。0.16.21 までの版が「移す」と記録した引き継ぎの後継も、利用者が有効にしていなければ移さない（ADR 0051）。
+  if (desktopOpenMode(env) === 'off') return null;
   // この会話自身が引き継ぎの途中なら、作業は次の後継が続ける。移すのは、最後に作業を終えた後継だけ。
   if (readJson(recordPath(sessionId, dir))) return null;
   const waiting = listClaudeAutoHandoffs({ dir }).filter(item => item.desktop?.wanted && !item.desktop.state);

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

@@ -26,6 +26,8 @@ const REPO_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const CLI = join(REPO_ROOT, 'bin', 'throughline.mjs');
 const SESSION = '0f3a6c1e-7b2d-4e5f-9a81-3c4d5e6f7a8b';
 const SUCCESSOR = 'a41a97ae-6b2a-421b-b2d5-1a0b07988d06';
+// Desktop へ移す処理は、利用者が有効にした時だけ動く（ADR 0051）。移す処理の試験は、Desktop から始まった会話の後継だけ移す設定で流す。
+const OPEN = { THROUGHLINE_AUTO_HANDOFF_OPEN: 'origin' };
 const ENABLED = { enabled: true, projects: [] };
 
 function withDir(fn) {
@@ -638,6 +640,11 @@ function writeRecord(dir, sourceId, fields) {
 
 test('PreCompact: Claude Desktop から始まった会話と、その後継の引き継ぎだけ、後継を Desktop で開く印を付ける（macOS）', () => withDir(dir => {
   const wanted = overrides => {
+    rmSync(join(dir, `${SESSION}.json`), { force: true });
+    request(dir, { ...overrides, env: { ...OPEN, ...overrides.env } });
+    return readClaudeAutoHandoff(SESSION, dir).desktop;
+  };
+  const byDefault = overrides => {
     rmSync(join(dir, `${SESSION}.json`), { force: true });
     request(dir, overrides);
     return readClaudeAutoHandoff(SESSION, dir).desktop;
@@ -648,6 +655,17 @@ test('PreCompact: Claude Desktop から始まった会話と、その後継の
   const cliTranscript = join(dir, 'cli.jsonl');
   writeFileSync(cliTranscript, jsonl([{ ...user('読んで', '2026-10-08T12:00:00.000Z'), entrypoint: 'cli' }]));
 
+  // 既定では、Desktop から始まった会話の後継も移さない（移すと、話している最中の会話がスマホから消える）
+  for (const platform of ['darwin', 'win32']) {
+    const payload = platform === 'win32' ? { cwd: 'C:\\work\\app' } : undefined;
+    assert.deepEqual(byDefault({ platform, payload, transcriptPath: desktopTranscript }), { wanted: false, state: null, error_code: null, opened_at: null }, platform);
+    assert.equal(byDefault({ platform, payload, env: { CLAUDE_CODE_ENTRYPOINT: 'claude-desktop' } }).wanted, false, platform);
+    assert.equal(byDefault({ platform, payload, transcriptPath: desktopTranscript, env: { THROUGHLINE_AUTO_HANDOFF_OPEN: 'on' } }).wanted, false, '知らない値では移さない');
+  }
+  writeRecord(dir, 'origin-desktop', { successor: { short_id: SESSION.slice(0, 8), session_id: SESSION } });
+  assert.equal(byDefault({ platform: 'darwin', transcriptPath: cliTranscript }).wanted, false, '0.16.21 までの版が「移す」と記録した引き継ぎの後継が、さらに引き継ぐ時も移さない');
+  rmSync(join(dir, 'origin-desktop.json'), { force: true });
+
   assert.deepEqual(wanted({ platform: 'darwin', transcriptPath: desktopTranscript }), { wanted: true, state: null, error_code: null, opened_at: null });
   assert.equal(wanted({ platform: 'darwin', env: { CLAUDE_CODE_ENTRYPOINT: 'claude-desktop' } }).wanted, true);
   assert.equal(wanted({ platform: 'darwin', transcriptPath: cliTranscript }).wanted, false, '端末から始めた会話の後継は、claude agents の一覧に出る');
@@ -669,7 +687,13 @@ test('PreCompact: Claude Desktop から始まった会話と、その後継の
 test('PreToolUse: Desktop で開く引き継ぎは、止めた理由に、後継がターンを終えた時に Desktop へ開く事を書く', () => withDir(async dir => {
   const desktopTranscript = join(dir, 'desktop.jsonl');
   writeFileSync(desktopTranscript, jsonl([{ ...user('読んで', '2026-10-08T12:00:00.000Z'), entrypoint: 'claude-desktop' }]));
+  // 既定では移さない。止めた理由には、裏で続ける事と、リモートコントロールで見られる事だけを書く
   request(dir, { platform: 'darwin', transcriptPath: desktopTranscript });
+  const kept = await stopClaudeTurnForHandoff({ payload: { session_id: SESSION, cwd: '/work/app', tool_use_id: 't1' }, dir, launchWorker: async () => 1 });
+  assert.match(kept.stopReason, /後継の会話は裏で作業を続けます。`claude agents` の一覧に出ます。後継はリモートコントロール付きで立てるので、claude\.ai\/code とClaudeのアプリからも見られます。/);
+  assert.doesNotMatch(kept.stopReason, /Claude Desktopへ開きます/);
+  rmSync(join(dir, `${SESSION}.json`), { force: true });
+  request(dir, { platform: 'darwin', transcriptPath: desktopTranscript, env: OPEN });
   const output = await stopClaudeTurnForHandoff({ payload: { session_id: SESSION, cwd: '/work/app', tool_use_id: 't1' }, dir, launchWorker: async () => 1 });
   assert.match(output.stopReason, /そのターンを終えた時にClaude Desktopへ開きます。途中の様子は `claude agents` の一覧で見られます。後継はリモートコントロール付きで立てるので、claude\.ai\/code とClaudeのアプリからも見られます。$/);
 }));
@@ -734,7 +758,7 @@ test('worker: リモートコントロールを付けると立てられない時
   writeFileSync(transcriptPath, jsonl([{ ...user('読んで', '2026-10-10T05:00:10Z'), entrypoint: 'claude-desktop' }, assistant('読みました。', '2026-10-10T05:00:12Z')]));
   const db = makeBatonDb();
   requestClaudeAutoHandoff({ payload: { session_id: sessionId, trigger: 'auto', cwd: '/work/app', transcript_path: transcriptPath },
-    env: {}, config: ENABLED, openDb: () => db, dir, platform: 'darwin' });
+    env: OPEN, config: ENABLED, openDb: () => db, dir, platform: 'darwin' });
   await stopClaudeTurnForHandoff({ payload: { session_id: sessionId, cwd: '/work/app', transcript_path: transcriptPath }, dir, launchWorker: async () => {} });
   const launches = [];
   const record = await runClaudeAutoHandoffWorker(sessionId, { dir, env: {}, pollMs: 10, acceptTimeoutMs: 300, transcriptTimeoutMs: 50,
@@ -754,29 +778,36 @@ test('Stop: Desktop で開く引き継ぎの後継がターンを終えたら、
   const launched = [];
   const launch = async (id) => { launched.push(id); };
   // 対象でない会話
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), null);
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch }), null);
+  // 移す処理は既定で無効。0.16.21 までの版が「移す」と記録した引き継ぎの後継がターンを終えても、止めない・移さない（ADR 0051）
+  writeRecord(dir, SESSION, {});
+  for (const env of [{}, { THROUGHLINE_AUTO_HANDOFF_OPEN: 'off' }, { THROUGHLINE_AUTO_HANDOFF_OPEN: 'on' }]) {
+    assert.equal(await requestClaudeDesktopOpen({ env, sessionId: SUCCESSOR, dir, launch }), null, JSON.stringify(env));
+  }
+  assert.deepEqual(launched, []);
+  assert.equal(readClaudeAutoHandoff(SESSION, dir).desktop.state, null, '記録も変えない');
   writeRecord(dir, SESSION, { desktop: { wanted: false, state: null } });
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), null, '端末から始めた会話の後継は移さない');
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch }), null, '端末から始めた会話の後継は移さない');
   writeRecord(dir, SESSION, { state: 'failed', error_code: 'handoff_successor_launch_failed', successor: null });
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), null, '後継が立たなかった引き継ぎでは動かない');
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch }), null, '後継が立たなかった引き継ぎでは動かない');
   // 対象の後継
   writeRecord(dir, SESSION, {});
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SESSION, dir, launch }), null, '旧い会話自身の Stop では動かない');
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), `h-${SESSION}`);
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SESSION, dir, launch }), null, '旧い会話自身の Stop では動かない');
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch }), `h-${SESSION}`);
   assert.deepEqual(launched, [SESSION]);
   assert.equal(readClaudeAutoHandoff(SESSION, dir).desktop.state, 'requested');
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), null, '2回目の Stop では起動しない');
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch }), null, '2回目の Stop では起動しない');
   assert.deepEqual(launched, [SESSION]);
 
   // 後継自身が引き継ぎの途中（作業は次の後継が続ける）なら、移さない
   writeRecord(dir, SESSION, {});
   writeRecord(dir, SUCCESSOR, { state: 'stopped', successor: null });
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), null);
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch }), null);
   assert.deepEqual(launched, [SESSION]);
 
   // 起動に失敗した時は理由を残す
   rmSync(join(dir, `${SUCCESSOR}.json`));
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch: async () => { throw new Error('spawn'); } }), null);
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch: async () => { throw new Error('spawn'); } }), null);
   assert.deepEqual([readClaudeAutoHandoff(SESSION, dir).desktop.state, readClaudeAutoHandoff(SESSION, dir).desktop.error_code], ['failed', 'desktop_open_start_failed']);
 }));
 
@@ -787,22 +818,22 @@ test('Stop: 受領を確かめられなかった引き継ぎ（unknown）でも
   const unconfirmed = { state: 'unknown', error_code: 'handoff_delivery_unconfirmed', accepted_at: null,
     successor: { short_id: SUCCESSOR.slice(0, 8), session_id: null } };
   writeRecord(dir, SESSION, unconfirmed);
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: 'bbbbbbbb-0000-4000-8000-000000000002', dir, launch }), null, '別の会話の Stop では動かない');
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), `h-${SESSION}`);
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: 'bbbbbbbb-0000-4000-8000-000000000002', dir, launch }), null, '別の会話の Stop では動かない');
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch }), `h-${SESSION}`);
   assert.deepEqual(launched, [SESSION]);
   const record = readClaudeAutoHandoff(SESSION, dir);
   assert.deepEqual(record.successor, { short_id: SUCCESSOR.slice(0, 8), session_id: SUCCESSOR }, '移す process が使う後継の ID を記録へ入れる');
   assert.deepEqual([record.state, record.error_code, record.desktop.state], ['unknown', 'handoff_delivery_unconfirmed', 'requested'],
     '受領を確かめられなかった事は、記録に残したままにする');
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, dir, launch }), null, '2回目の Stop では起動しない');
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, 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.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: `${SUCCESSOR.slice(0, 8)}-0000-4000-8000-000000000009`, dir, launch }), null, '短い ID が同じでも、別の会話の Stop では動かない');
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, dir, launch }), `h-${SESSION}`, '戻った後の Stop でやり直す');
   assert.deepEqual(launched, [SESSION, SESSION]);
   assert.equal(readClaudeAutoHandoff(SESSION, dir).desktop.state, 'requested');
 
@@ -916,7 +947,7 @@ test('transcript: 終わったターンで止まっている時だけ、印（tr
 test('Stop: 後継の transcript の場所を、移す process のために記録へ残す', () => withDir(async dir => {
   writeRecord(dir, SESSION, {});
   const launch = async () => {};
-  assert.equal(await requestClaudeDesktopOpen({ sessionId: SUCCESSOR, transcriptPath: '/home/u/.claude/projects/-work-app/successor.jsonl', dir, launch }), `h-${SESSION}`);
+  assert.equal(await requestClaudeDesktopOpen({ env: OPEN, sessionId: SUCCESSOR, transcriptPath: '/home/u/.claude/projects/-work-app/successor.jsonl', dir, launch }), `h-${SESSION}`);
   assert.deepEqual(readClaudeAutoHandoff(SESSION, dir).successor,
     { short_id: SUCCESSOR.slice(0, 8), session_id: SUCCESSOR, transcript_path: '/home/u/.claude/projects/-work-app/successor.jsonl' });
   assert.equal(JSON.stringify(publicClaudeAutoHandoff(readClaudeAutoHandoff(SESSION, dir))).includes('successor.jsonl'), false, '公開の表示には場所を出さない');