throughline 0.16.16 → 0.16.17

package/CHANGELOG.md

@@ -10,6 +10,30 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.17] — 2026-10-10
+
+### 修正
+
+- Windowsで、Claude Codeの自動継続の後、Windows Terminalの窓が約2秒おきに開いては消えた。後継をClaude Desktopへ移す処理は、後継が手すきになるまで`claude agents --json --all`を繰り返し呼ぶ。この処理はconsoleを持たない切り離したprocessで動き、子の`pwsh.exe`を窓を隠さずに起こしていたので、呼ぶたびに新しいconsole（既定のターミナルの窓）が出ていた。後継が手すきにならない間、最長2分、ターンが終わるたびに続いた。
+  - 子processを起こす共通の部品（`src/os/portable-spawn-sync.mjs`）が、窓を隠す指定（`windowsHide`）を既定で付ける。`claude agents`・`claude stop`・後継の起動・L1の要約（`claude -p`・`codex exec`）・更新の処理が対象。
+  - URLを開く`cmd.exe /c start`と、手動の引き継ぎのapp-serverの起動にも付けた。開く先のアプリの窓は隠れない。
+  - 端末が要る`claude --desktop --resume`は、今までどおり最小化した新しいconsoleの中で呼ぶ（1回だけ）。
+  - 手すきを待つ間隔を1秒から3秒へ広げた。
+
+### 対応の範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Claude Code | 窓の指定は効かないOS。手すきを待つ間隔だけ変わる（3秒）。単体試験とCI | 窓の指定は効かないOS。単体試験とCI。Desktopへ移す処理はLinuxでは動かない | 直した。実機の画面のあるsessionで、consoleを持たない切り離したprocessから`claude agents`を呼び、現れた窓を30msおきに数えた。0.16.16は3回の呼び出しでWindows Terminalの窓が3回、直した版は5回の呼び出しで0回。呼び出しの結果（一覧）は同じに読めた |
+| Codex | 同じ（効かないOS） | 同じ | 直した。URLを開く所は、実機で窓を隠した`cmd.exe`からアプリが開く事を確かめた（電卓のURLで代用）。自動継続のworkerが起こすL1の要約（`codex exec`）は同じ部品を通るが、個別には確かめていない |
+| Grok | 同じ（効かないOS） | 同じ | 直した。Stopのhookが起こすL1の要約が同じ部品を通る。個別には確かめていない |
+| Cursor | 同じ（効かないOS） | 同じ | 直した。Grokと同じ |
+
+### 確認していない範囲
+
+- 本物の引き継ぎの後に窓が出ない事（公開して端末へ入れた後に確かめる）。
+- 後継が手すきにならない理由（裏で動き続ける処理を持つ会話など）。その間、後継はClaude Desktopへ移らない。
+
 ## [0.16.16] — 2026-10-10
 
 ### 追加
@@ -2246,7 +2270,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.16...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.17...HEAD
+[0.16.17]: https://github.com/kitepon/Throughline/compare/v0.16.16...v0.16.17
 [0.16.16]: https://github.com/kitepon/Throughline/compare/v0.16.15...v0.16.16
 [0.16.15]: https://github.com/kitepon/Throughline/compare/v0.16.14...v0.16.15
 [0.16.14]: https://github.com/kitepon/Throughline/compare/v0.16.13...v0.16.14

package/package.json

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

package/src/claude-auto-handoff.mjs

@@ -778,7 +778,8 @@ export async function runClaudeDesktopOpen(sourceSessionId, {
   spawn = spawnPortableSync,
   pty = runWithPty,
   idleTimeoutMs = 120_000,
-  pollMs = 1_000,
+  // 一覧を読むたびに `claude agents` を起こす（Windows では pwsh 経由）。手すきは急いで知る必要が無いので、間を空ける。
+  pollMs = 3_000,
 } = {}) {
   let record = readClaudeAutoHandoff(sourceSessionId, dir);
   if (!record) throw new ClaudeHandoffError('handoff_not_found');

package/src/cli/doctor.mjs

@@ -1014,7 +1014,7 @@ export async function run(argv = []) {
   await check('throughline コマンドが PATH で見つかるか', () => {
     try {
       const which = process.platform === 'win32' ? 'where throughline' : 'which throughline';
-      const result = execSync(which, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+      const result = execSync(which, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true }).trim();
       return result.split(/\r?\n/)[0];
     } catch {
       throw new Error('見つからない — npm install -g throughline を実行してください');

package/src/codex-app-server.mjs

@@ -1649,6 +1649,7 @@ function startAppServerClient({ command, args, cwd, timeoutMs, requestTimeoutMs
   const child = spawn(command, args, {
     cwd,
     stdio: ['pipe', 'pipe', 'pipe'],
+    windowsHide: true,
   });
   let stdoutBuffer = '';
   let stderr = '';

package/src/os/open-url.mjs

@@ -11,6 +11,7 @@ export function openUrlWithOsHandler(url, {
   spawnImpl = spawnSync,
 } = {}) {
   if (platform === 'darwin') return spawnImpl('open', [url], { encoding: 'utf8' });
-  if (platform === 'win32') return spawnImpl('cmd.exe', ['/c', 'start', '', url], { encoding: 'utf8' });
+  // cmd.exe 自身の窓は隠す（console を持たない worker から呼ぶと、窓が一瞬出る）。start が開く先の窓は、これでは隠れない。
+  if (platform === 'win32') return spawnImpl('cmd.exe', ['/c', 'start', '', url], { encoding: 'utf8', windowsHide: true });
   return spawnImpl('xdg-open', [url], { encoding: 'utf8' });
 }

package/src/os/open-url.test.mjs

@@ -0,0 +1,14 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { openUrlWithOsHandler } from './open-url.mjs';
+
+test('openUrlWithOsHandler: OS ごとの命令で開き、Windows では cmd.exe の窓を隠す', () => {
+  const calls = [];
+  const spawnImpl = (command, args, options) => { calls.push({ command, args, options }); return { status: 0 }; };
+  openUrlWithOsHandler('codex://threads/abc', { platform: 'win32', spawnImpl });
+  openUrlWithOsHandler('codex://threads/abc', { platform: 'darwin', spawnImpl });
+  openUrlWithOsHandler('codex://threads/abc', { platform: 'linux', spawnImpl });
+  assert.deepEqual(calls[0], { command: 'cmd.exe', args: ['/c', 'start', '', 'codex://threads/abc'], options: { encoding: 'utf8', windowsHide: true } });
+  assert.deepEqual([calls[1].command, calls[1].args], ['open', ['codex://threads/abc']]);
+  assert.deepEqual([calls[2].command, calls[2].args], ['xdg-open', ['codex://threads/abc']]);
+});

package/src/os/portable-spawn-sync.mjs

@@ -28,11 +28,15 @@ function resolveWindowsCommand(command, env) {
   return command;
 }
 
-function portableInvocation(command, args, options = {}) {
+export function portableInvocation(command, args, options = {}) {
   const platform = options.platform ?? process.platform;
   const spawnOptions = { ...options };
   delete spawnOptions.platform;
   spawnOptions.shell = false;
+  // Windows では、console を持たない process（切り離した worker など）が console の子を起こすと、新しい console が作られ、
+  // 既定のターミナル（Windows Terminal）の窓が一瞬出る。出力は pipe で受けるので、窓は要らない。
+  // 窓が要る呼び出し（端末が要る命令）は os/pty-run.mjs が別に持つ。ほかの OS では無視される。
+  spawnOptions.windowsHide ??= true;
 
   if (platform !== 'win32') return [command, args, spawnOptions];
 

package/src/os/portable-spawn-sync.test.mjs

@@ -3,7 +3,7 @@ import assert from 'node:assert/strict';
 import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { spawnPortable, spawnPortableSync } from './portable-spawn-sync.mjs';
+import { portableInvocation, spawnPortable, spawnPortableSync } from './portable-spawn-sync.mjs';
 import { createInterface } from 'node:readline';
 import { once } from 'node:events';
 
@@ -88,3 +88,24 @@ exit $LASTEXITCODE
     rmSync(dir, { recursive: true, force: true });
   }
 });
+
+test('portableInvocation: 窓を隠す指定を既定で付ける。呼び出し側が false を渡した時だけ外す', () => {
+  for (const platform of ['win32', 'linux', 'darwin']) {
+    const [, , hidden] = portableInvocation('claude', ['agents', '--json', '--all'], { platform, env: { PATH: '' }, encoding: 'utf8' });
+    assert.equal(hidden.windowsHide, true, platform);
+    assert.equal(hidden.shell, false); assert.equal(hidden.encoding, 'utf8'); assert.equal('platform' in hidden, false);
+    const [, , shown] = portableInvocation('claude', ['agents'], { platform, env: { PATH: '' }, windowsHide: false });
+    assert.equal(shown.windowsHide, false, platform);
+  }
+});
+
+test('portableInvocation: Windows の .ps1 shim は pwsh.exe 経由で、窓を隠して起こす', () => {
+  const dir = mkdtempSync(join(tmpdir(), 'tl-portable-hide-'));
+  try {
+    writeFileSync(join(dir, 'claude.ps1'), 'exit 0\n');
+    const [command, args, options] = portableInvocation('claude', ['stop', 'abcd1234'], { platform: 'win32', env: { PATH: dir } });
+    assert.equal(command, 'pwsh.exe');
+    assert.ok(args.at(-1).includes(join(dir, 'claude.ps1')) && args.at(-1).includes("'stop' 'abcd1234'"));
+    assert.equal(options.windowsHide, true);
+  } finally { rmSync(dir, { recursive: true, force: true }); }
+});