throughline 0.10.14 → 0.10.16

package/CHANGELOG.md

@@ -10,6 +10,24 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.10.16] — 2026-09-07
+
+### 修正
+
+- WindowsのDesktop引き継ぎで、稼働中のアプリが使うCodex実行ファイルを選ぶようにした。
+  PATH上の古いCodexがデスクトップ版の設定を読めず、新規タスクの作成に失敗する問題を修正した。
+- 引き継ぎ結果へCodex実行元を表示する。アプリの実体を特定できない場合は理由を出して停止する。
+
+## [0.10.15] — 2026-09-06
+
+### Fixed
+
+- Windowsでnpmから導入したCodexをThroughlineの新規タスク引き継ぎと診断から起動できるようにした。
+  OS境界の起動処理を通し、PowerShell 7経由の標準入出力をUTF-8で受け渡す。
+- Windowsの起動試験を通常のテストと製品CIへ含め、日本語と接続中の要求・応答を検証する。
+- Windowsの起動条件、Codexフックの承認、既存ログの回収を文書化した。
+  自動refreshの古い案内を直し、公開版と開発中の版の参照先を分けた。
+
 ## [0.10.14] — 2026-09-02
 
 ### Added
@@ -1439,7 +1457,9 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.14...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.16...HEAD
+[0.10.16]: https://github.com/kitepon/Throughline/compare/v0.10.15...v0.10.16
+[0.10.15]: https://github.com/kitepon/Throughline/compare/v0.10.14...v0.10.15
 [0.10.14]: https://github.com/kitepon/Throughline/compare/v0.10.13...v0.10.14
 [0.10.13]: https://github.com/kitepon/Throughline/compare/v0.10.12...v0.10.13
 [0.10.12]: https://github.com/kitepon/Throughline/compare/v0.10.11...v0.10.12

package/README.ja.md

@@ -102,6 +102,11 @@ current-thread rollback
 診断が要る時だけ明示的に `trim --execute --host codex` を使う。既存の
 非 Throughline Codex hook は保持される。
 
+登録後は `throughline doctor --codex` で承認状態も確認する。未承認のフックは
+Codexのフック承認画面で利用者が承認する。Throughlineは承認状態を書き換えない。
+Windowsの起動条件と、記録が見つからない場合の確認手順は
+[Codexの診断と復旧](README.md#codex-windows)を参照。
+
 </details>
 
 ## 他の手段との比較
@@ -464,6 +469,7 @@ DB作成・migration・baton消費・session merge・
 - **Codex CLI ログイン**（既定の L1 要約 backend、`gpt-5.6-luna`）または
   **Claude Max サブスクリプション**（`claude -p` 経由の Haiku fallback）— どちらも API キー不要
 - 対応 OS: **Windows / macOS / Linux**
+- Windowsでnpm版Codexを起動する場合は **PowerShell 7**（`pwsh.exe`）がPATHに必要。
 
 ランタイム依存 **ゼロ**。npm パッケージは純 `.mjs` ファイルのみで構成されています。
 

package/README.md

@@ -72,6 +72,8 @@ DB handoff memory as a developer item, and opens that thread in the selected
 host; ask explicitly for current-thread rollback diagnostics when you want the
 guarded `trim --execute --host codex` surface.
 
+フック登録後の承認とWindowsでの起動条件は、[Codexの診断と復旧](#codex-windows)を参照。
+
 </details>
 
 <details>
@@ -636,6 +638,10 @@ opens the new task in Codex Desktop when invoked there, while preserving the
 existing VS Code and CLI routes. The result reports both the requested and
 resolved host. The installed `$throughline` skill passes the current Codex
 surface explicitly so a persistent shell or PTY cannot redirect the handoff.
+WindowsのDesktop引き継ぎは、稼働中のCodex Desktopが使う実行ファイルを選びます。
+PATH上の別バージョンによる設定読取りエラーを避け、選んだ実行元を結果へ表示します。
+Desktopを起動してから実行してください。実行ファイルが見つからない場合や、異なる実行ファイルの
+Desktopが複数稼働している場合は理由を出して停止します。明示した`--codex-app-server-bin`は優先します。
 The
 individual commands remain available: validate the fresh-thread handoff with
 `throughline codex-handoff-smoke --session codex:<thread-id>`, optionally audit
@@ -817,7 +823,7 @@ entry to the `tasks` array yourself:
 
 ## Commands
 
-**The current release is v0.10.14.** Throughline supports Claude Code, Codex,
+公開版は冒頭のnpmバッジ、開発中の版は `package.json`、版ごとの変更は [CHANGELOG.md](CHANGELOG.md) を参照。Throughline supports Claude Code, Codex,
 Grok, and Cursor as documented host adapters. The versioned, read-only
 `handoff-context` boundary opens only an existing database and leaves baton
 state, session ownership, and memory rows unchanged. Factory diagnostics,
@@ -1118,6 +1124,24 @@ See [`src/haiku-summarizer.mjs`](src/haiku-summarizer.mjs) for the implementatio
 
 ## Troubleshooting
 
+<a id="codex-windows"></a>
+
+### Codexの診断と復旧（Windowsを含む）
+
+Windowsでnpm版Codexを使う場合、`codex` とPowerShell 7の `pwsh.exe` がPATHに必要。
+Throughlineはnpmが生成したPowerShell起動ファイルを使い、引数と標準入出力を
+UTF-8で渡す。macOS/Linuxの起動方法は変わらない。
+
+引き継ぐ記録が見つからない場合は、対象プロジェクトで `throughline doctor --codex` を実行する。
+登録済みでも未承認のフックは動作しないため、Codexのフック承認画面で利用者が承認する。
+Throughlineのinstallや更新は、その承認を代行しない。
+
+旧版を使っている場合は、[更新手順](docs/04_public_release_plan.md#製品単独運用)で更新する。
+未承認期間の既存ログを回収する必要がある場合は、対象IDを確定して
+`throughline codex-capture --codex-thread-id <id> --json` を実行する。
+その後、通常のターン終了で記録が増えることを確認する。一度の手動回収を
+自動記録の復旧とは扱わない。現在のタスクへのrollbackや注入は復旧手順に含めない。
+
 ### Claude Code Desktop `/clear`
 
 Automatic inheritance (the auto path) does not fire for `/clear` in Claude Code Desktop: the client does not send `source="clear"` and also mislabels the SessionEnd `reason` as `"other"`. This is reported upstream in [anthropics/claude-code#76704](https://github.com/anthropics/claude-code/issues/76704). On Desktop, run `/tl` before `/clear` (the baton lasts one hour). The 0.6.0 backfill work means this `/tl` handoff carries complete L2 through the immediately preceding turn. The VS Code extension's `/clear` auto-handoff works normally.

package/docs/04_public_release_plan.md

@@ -6,7 +6,7 @@
 
 ## 現行状態
 
-- release candidateのpackage版は `0.10.14`。tagとnpmの公開確認はpublish後に行う。
+- 候補の版は `package.json`、公開版はnpm registryを正とする。tagとnpmの一致はpublish後に確認する。
 - Claude Code、Codex、Grok、Cursorをfirst-class hostとして扱う。
 - 現行DB schemaはv9。schemaの正本は [src/db.mjs](../src/db.mjs) の
   `CURRENT_VERSION`、二相handoffの判断は
@@ -58,7 +58,8 @@ Windows PowerShell 5.1へ切り替えない。更新前CLIを再利用せず、
 
 release候補は次の全条件を満たしたときだけ公開する。
 
-1. `package.json`、`CHANGELOG.md`、README、CLAUDE.mdの現行版・schema・host契約が一致する。
+1. `package.json` と `CHANGELOG.md` の候補版が一致し、READMEとCLAUDE.mdが版の正本を参照する。
+   schema・host契約も実装と一致し、`npm run verify:docs` が全Markdownと梱包内リンクを検査する。
 2. 変更に直結するfocused testがgreenで、その後に `npm test` を最終確認として1回通す。
 3. `npm run verify:release-commit` が、clean working treeかつHEADが`origin`既定ブランチの
    祖先であることを確認する。既定ブランチへ着地していないcommitからpublishしない。
@@ -76,6 +77,8 @@ publish済みでも、上の確認が終わるまではrelease完了としない
 - Claude Code: user/project hooksとslash command。PATH解決型CLIを使う。
 - Codex: UserPromptSubmit / PostToolUse / Stop hook、feature flags、`$throughline` skill。
   絶対Node + installed CLI pathを使う。
+  登録と利用者の承認は別であり、未承認は `doctor --codex` で確認する。
+  Windowsのnpm版Codex起動は `src/os/portable-spawn-sync.mjs` が所有し、PowerShell 7を使う。
 - Grok: `~/.grok/hooks/throughline.json`と`grok-continue`。絶対pathを使う。
   Grok予約環境変数でhostを確定し、camelCase／snake_caseの属性名を同じ境界で正規化する。
 - Cursor: `~/.cursor/hooks.json`へsessionStart / beforeSubmitPrompt / stopをupsertし、

package/docs/05_codex_first_roadmap.md

@@ -22,6 +22,11 @@
 
 ## 現状認識
 
+Windowsの通常の新規タスク引き継ぎは実機確認済み。
+起動条件とフック承認は [README](../README.md#codex-windows)、
+当時の検証と未完了事項は [実測記録](https://github.com/kitepon/Throughline/blob/main/evidence/2026-09-06-windows-codex-handoff.md) を参照する。
+この確認は同一タスクのrollbackや自動記録の承認を保証しない。
+
 - Throughline 本体は、ほとんどが hook から起動されるローカル Node.js コードベースで動く。
 - 現行 Claude path は、Claude hooks、slash command、handoff baton、DB、resume context、L1 / L2 / L3 persistence で成立している。
 - 外部モデル的に呼ぶ主要箇所は L2 -> L1 要約。

package/docs/08_codex_dual_support.md

@@ -21,7 +21,10 @@
 
 Throughline は agent-neutral な handoff / context compression infrastructure になるべきです。
 
-Claude Code transcript と handoff behavior は守りつつ、Codex primary bridge と `codex-sidecar` 経由の compact context も生成できるようにします。現行の `HandoffRecord` は安定した中間表現だが、保存元はまだ Claude transcript 由来であり、Codex capture を実装して初めて source adapter が Codex 由来になる。
+Claude Code transcript と handoff behavior を維持し、Codex対応はadapterとして追加する。
+Codexの保存元は実装済みの `src/codex-capture.mjs` が読むrolloutであり、
+`codex:<thread_id>` の記憶を保存する。通常の引き継ぎは新規タスクへdeveloper itemを注入する。
+フック承認とWindows起動条件は [README](../README.md#codex-windows) を正とする。
 
 目指す形:
 
@@ -33,7 +36,7 @@ Claude Code transcript と handoff behavior は守りつつ、Codex primary brid
 ## 優先順位
 
 1. Throughline を Codex primary で使えるようにする。Codex primary の L2 -> L1 backend は Codex CLI を本線にする。
-2. Codex で Claude Rewind 相当の context trim を完成させる。2026-05-09 時点では Codex current-thread trim execute / auto-refresh は再有効化済みで、DB memory を必須にし、turn-count mismatch は diagnostics と app-server count 由来の rollback `numTurns` 補正に使う。
+2. Codexの同一タスクのtrimは明示的な診断として維持する。自動refreshは無効であり、通常の `$throughline` は新規タスクへ引き継ぐ。同一タスクでの継続的な使用量削減は保証しない。
 3. そのあと Claude 側の `/rewind` UX / 自動化 surface を詰める。
 
 Claude transcript handling の置き換えから始めないでください。Codex 対応は adapter / bridge / Codex primary entrypoint として追加します。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-    "version": "0.10.14",
+    "version": "0.10.16",
     "type": "module",
     "description": "Persistent memory hooks for Claude Code, Codex, Grok, and Cursor (/clear-safe context compression)",
     "keywords": [
@@ -41,7 +41,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --import ./src/test-env.mjs --test scripts/verify-release-commit.test.mjs src/*.test.mjs src/cli/*.test.mjs src/hosts/*.test.mjs",
+    "test": "node --import ./src/test-env.mjs --test scripts/verify-release-commit.test.mjs src/*.test.mjs src/cli/*.test.mjs src/hosts/*.test.mjs src/os/*.test.mjs",
     "verify:docs": "node scripts/verify-docs.mjs && node scripts/verify-pack-markdown-links.mjs",
     "verify:release-commit": "node scripts/verify-release-commit.mjs",
     "prepublishOnly": "npm run verify:release-commit && npm test"

package/src/cli/codex-handoff-start.mjs

@@ -9,6 +9,7 @@ import { sameProjectPath } from '../project-path.mjs';
 import { shQuote } from '../os/shell.mjs';
 import { openUrlWithOsHandler } from '../os/open-url.mjs';
 import { runTerminalDoScript } from '../os/macos-terminal.mjs';
+import { resolveCodexRuntime } from '../os/codex-runtime.mjs';
 
 async function readStdin() {
   let raw = '';
@@ -242,6 +243,7 @@ function renderTextResult(result) {
   lines.push(`  execute:           ${result.execute ? 'yes' : 'no'}`);
   lines.push(`  open requested:    ${result.requestedOpenHost ?? result.openHost}`);
   lines.push(`  open resolved:     ${result.resolvedOpenHost ?? result.open?.host ?? result.openHost}`);
+  if (result.runtime) lines.push(`  Codex実行元:       ${result.runtime.command} (${result.runtime.source})`);
   lines.push(`  handoff smoke:     ${result.handoffSmoke.status}`);
   lines.push(`  prompt chars:      ${result.handoffSmoke.promptChars}/${result.handoffSmoke.maxPromptChars}`);
   lines.push(`  model prompt:      ${result.modelPromptChars}`);
@@ -452,11 +454,16 @@ export async function run(args) {
   }
 
   if (parsed.execute && result.status === 'ready') {
+    const runtime = resolveCodexRuntime({
+      host: result.resolvedOpenHost,
+      override: parsed.codexAppServerBin,
+    });
+    result.runtime = runtime;
     const startResult = await runCodexNewThreadHandoff({
       cwd: process.cwd(),
       prompt: handoffPrompt,
-      command: parsed.codexAppServerBin ?? 'codex',
-      commandArgs: parsed.codexAppServerBin ? [] : ['app-server', '--listen', 'stdio://'],
+      command: runtime.command,
+      commandArgs: runtime.commandArgs,
       timeoutMs: parsed.timeoutMs,
       requestTimeoutMs: parsed.requestTimeoutMs,
       waitForTurn: false,

package/src/cli/codex-handoff-start.test.mjs

@@ -310,6 +310,9 @@ test('codex-handoff-start execute creates a new app-server thread and can skip o
     assert.equal(payload.startThreadManually, false);
     assert.equal(payload.newThread.threadId, '019e2000-0000-7000-8000-000000000001');
     assert.equal(payload.newThread.delivery, 'developer-item');
+    assert.equal(payload.runtime.command, script);
+    assert.equal(payload.runtime.source, 'explicit');
+    assert.deepEqual(payload.runtime.commandArgs, []);
     assert.equal(payload.newThread.injectSent, true);
     assert.equal(payload.newThread.turnStatus, 'not-started');
     assert.equal(payload.open.status, 'skipped');

package/src/codex-app-server.mjs

@@ -1,4 +1,4 @@
-import { spawn } from 'node:child_process';
+import { spawnPortable as spawn } from './os/portable-spawn-sync.mjs';
 import { randomUUID } from 'node:crypto';
 
 export const CODEX_APP_SERVER_METHODS = Object.freeze({

package/src/codex-host-primitive-audit.mjs

@@ -1,4 +1,4 @@
-import { spawnSync } from 'node:child_process';
+import { spawnPortableSync as spawnSync } from './os/portable-spawn-sync.mjs';
 import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';

package/src/docs-contract.test.mjs

@@ -48,7 +48,7 @@ test('Markdown-only CI runs the product-owned documentation contract', () => {
   assert.match(result.stdout, /packed Markdown links:/);
 });
 
-test('release candidate version is synchronized across current product documents', () => {
+test('現行文書は版の正本を参照し、変更履歴は候補版と一致する', () => {
   const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
   const version = packageJson.version;
   const currentSources = [
@@ -56,7 +56,10 @@ test('release candidate version is synchronized across current product documents
     readFileSync(new URL('../CLAUDE.md', import.meta.url), 'utf8'),
     readFileSync(new URL('../docs/04_public_release_plan.md', import.meta.url), 'utf8'),
   ];
-  for (const source of currentSources) assert.match(source, new RegExp(`\\bv?${version.replaceAll('.', '\\.')}\\b`));
+  for (const source of currentSources) {
+    assert.match(source, /`package\.json`/);
+    assert.match(source, /公開版はnpm|公開版は冒頭のnpm/);
+  }
 
   const changelog = readFileSync(new URL('../CHANGELOG.md', import.meta.url), 'utf8');
   assert.match(changelog, new RegExp(`^## \\[${version.replaceAll('.', '\\.')}\\]`, 'm'));

package/src/os/codex-runtime.mjs

@@ -0,0 +1,36 @@
+import { spawnPortableSync } from './portable-spawn-sync.mjs';
+
+function discoverWindowsDesktopCodex() {
+  const result = spawnPortableSync('pwsh.exe', ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command', `
+$ErrorActionPreference = 'Stop'
+$processes = @(Get-CimInstance Win32_Process)
+$paths = @($processes | Where-Object { $_.Name -eq 'codex.exe' } | ForEach-Object {
+  $child = $_
+  $parent = $processes | Where-Object { $_.ProcessId -eq $child.ParentProcessId }
+  if ($parent.ExecutablePath -match '[\\\\/]OpenAI\\.Codex_[^\\\\/]+[\\\\/]app[\\\\/]ChatGPT\\.exe$' -and $child.ExecutablePath) {
+    $child.ExecutablePath
+  }
+})
+ConvertTo-Json -InputObject $paths -Compress
+`], { encoding: 'utf8', timeout: 15000 });
+  if (result.error || result.status !== 0) {
+    throw new Error(`Codex Desktopの実行ファイルを取得できません: ${result.error?.message ?? result.stderr.trim()}`);
+  }
+  return JSON.parse(result.stdout.trim());
+}
+
+export function resolveCodexRuntime({ host, override = null, platform = process.platform,
+  discover = discoverWindowsDesktopCodex } = {}) {
+  if (override) return { command: override, commandArgs: [], source: 'explicit' };
+  const commandArgs = ['app-server', '--listen', 'stdio://'];
+  if (platform !== 'win32' || host !== 'desktop') {
+    return { command: 'codex', commandArgs, source: 'path' };
+  }
+  const candidates = [...new Set(discover())];
+  if (candidates.length !== 1) {
+    throw new Error(candidates.length === 0
+      ? '稼働中のCodex Desktopの実行ファイルが見つかりません。アプリを起動してから再実行してください。'
+      : '複数のCodex Desktop実行ファイルが稼働しています。使用するアプリだけを残して再実行してください。');
+  }
+  return { command: candidates[0], commandArgs, source: 'desktop-process' };
+}

package/src/os/codex-runtime.test.mjs

@@ -0,0 +1,31 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { resolveCodexRuntime } from './codex-runtime.mjs';
+
+test('Windows Desktopは稼働中アプリのCodexを使う', () => {
+  const runtime = resolveCodexRuntime({ platform: 'win32', host: 'desktop',
+    discover: () => ['C:\\Codex\\codex.exe', 'C:\\Codex\\codex.exe'] });
+  assert.equal(runtime.command, 'C:\\Codex\\codex.exe');
+  assert.deepEqual(runtime.commandArgs, ['app-server', '--listen', 'stdio://']);
+  assert.equal(runtime.source, 'desktop-process');
+});
+
+test('明示したapp-serverはDesktopの探索より優先する', () => {
+  const runtime = resolveCodexRuntime({ platform: 'win32', host: 'desktop', override: 'fake.mjs',
+    discover: () => { throw new Error('探索してはいけない'); } });
+  assert.equal(runtime.command, 'fake.mjs');
+  assert.deepEqual(runtime.commandArgs, []);
+});
+
+test('対象外のOSとhostは従来のCodexを使う', () => {
+  for (const [platform, host] of [['darwin', 'desktop'], ['win32', 'cli'], ['win32', 'vscode']]) {
+    assert.equal(resolveCodexRuntime({ platform, host }).command, 'codex');
+  }
+});
+
+test('Desktopの実体がない場合や複数ある場合は古いCLIへ切り替えない', () => {
+  for (const candidates of [[], ['C:\\one\\codex.exe', 'C:\\two\\codex.exe']]) {
+    assert.throws(() => resolveCodexRuntime({ platform: 'win32', host: 'desktop',
+      discover: () => candidates }), /Codex Desktop/);
+  }
+});

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

@@ -1,4 +1,4 @@
-import { spawnSync } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { basename, delimiter, dirname, extname, isAbsolute, join } from 'node:path';
 
@@ -28,31 +28,42 @@ function resolveWindowsCommand(command, env) {
   return command;
 }
 
-export function spawnPortableSync(command, args, options = {}) {
+function portableInvocation(command, args, options = {}) {
   const platform = options.platform ?? process.platform;
   const spawnOptions = { ...options };
   delete spawnOptions.platform;
   spawnOptions.shell = false;
 
-  if (platform !== 'win32') return spawnSync(command, args, spawnOptions);
+  if (platform !== 'win32') return [command, args, spawnOptions];
 
   const env = spawnOptions.env ?? process.env;
   const resolved = resolveWindowsCommand(command, env);
   const extension = extname(resolved).toLowerCase();
   if (['.js', '.cjs', '.mjs'].includes(extension)) {
-    return spawnSync(process.execPath, [resolved, ...args], spawnOptions);
+    return [process.execPath, [resolved, ...args], spawnOptions];
   }
   if (extension === '.ps1') {
-    return spawnSync('pwsh.exe', [
+    const invocation = [resolved, ...args]
+      .map(value => `'${value.replaceAll("'", "''")}'`).join(' ');
+    return ['pwsh.exe', [
       '-NoLogo',
       '-NoProfile',
       '-NonInteractive',
       '-ExecutionPolicy',
       'Bypass',
-      '-File',
-      resolved,
-      ...args,
-    ], spawnOptions);
+      '-Command',
+      '[Console]::InputEncoding = [Console]::OutputEncoding = $OutputEncoding = ' +
+        '[System.Text.UTF8Encoding]::new($false); ' +
+        `& ${invocation}; exit $LASTEXITCODE`,
+    ], spawnOptions];
   }
-  return spawnSync(resolved, args, spawnOptions);
+  return [resolved, args, spawnOptions];
+}
+
+export function spawnPortableSync(command, args, options = {}) {
+  return spawnSync(...portableInvocation(command, args, options));
+}
+
+export function spawnPortable(command, args, options = {}) {
+  return spawn(...portableInvocation(command, args, options));
 }

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

@@ -3,7 +3,9 @@ import assert from 'node:assert/strict';
 import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { spawnPortableSync } from './portable-spawn-sync.mjs';
+import { spawnPortable, spawnPortableSync } from './portable-spawn-sync.mjs';
+import { createInterface } from 'node:readline';
+import { once } from 'node:events';
 
 test('spawnPortableSync: Windows cmd shim preserves argv boundaries and stdin', {
   skip: process.platform !== 'win32' ? 'Windows cmd shim contract' : undefined,
@@ -20,6 +22,7 @@ process.stdin.on('data', (chunk) => { input += chunk; });
 process.stdin.on('end', () => {
   process.stdout.write(JSON.stringify({ args: process.argv.slice(2), input }));
 });
+
 `);
     writeFileSync(command, `@echo off\r\n${JSON.stringify(process.execPath)} ${JSON.stringify(child)} %*\r\n`);
     writeFileSync(powerShellShim, `& ${JSON.stringify(process.execPath)} ${JSON.stringify(child)} @args\nexit $LASTEXITCODE\n`);
@@ -38,3 +41,50 @@ process.stdin.on('end', () => {
     rmSync(dir, { recursive: true, force: true });
   }
 });
+
+
+test('WindowsのPATHにあるnpm起動ファイルと標準入出力で往復できる', {
+  skip: process.platform !== 'win32',
+  timeout: 10_000,
+}, async () => {
+  const dir = mkdtempSync(join(tmpdir(), 'tl-npm-stream-'));
+  let child;
+  try {
+    const script = join(dir, 'rpc.mjs');
+    writeFileSync(script, `
+import { createInterface } from 'node:readline';
+createInterface({ input: process.stdin }).on('line', (line) => {
+  process.stdout.write(JSON.stringify({ line, args: process.argv.slice(2) }) + '\\n');
+});
+`);
+    // npmのPowerShell起動ファイルと同じ入力分岐で、EOF前の応答を確かめる。
+    writeFileSync(join(dir, 'tl-rpc.ps1'), `
+if ($MyInvocation.ExpectingInput) {
+  $input | & ${JSON.stringify(process.execPath)} ${JSON.stringify(script)} @args
+} else {
+  & ${JSON.stringify(process.execPath)} ${JSON.stringify(script)} @args
+}
+exit $LASTEXITCODE
+`);
+    const env = { ...process.env };
+    const pathKey = Object.keys(env).find(key => key.toLowerCase() === 'path');
+    env[pathKey] = `${dir};${env[pathKey]}`;
+    const args = ['空白 を含む', 'a&b', '100%'];
+    const sync = spawnPortableSync('tl-rpc', args, { env, encoding: 'utf8', input: '同期\n' });
+    assert.equal(sync.status, 0, sync.stderr || sync.error?.message);
+    assert.deepEqual(JSON.parse(sync.stdout), { line: '同期', args });
+    child = spawnPortable('tl-rpc', args, { env, stdio: ['pipe', 'pipe', 'pipe'] });
+    const lines = createInterface({ input: child.stdout });
+    for (const line of ['初期化', '次の要求']) {
+      const response = once(lines, 'line');
+      child.stdin.write(`${line}\n`);
+      assert.deepEqual(JSON.parse((await response)[0]), { line, args });
+    }
+    const closed = once(child, 'close');
+    child.stdin.end();
+    assert.equal((await closed)[0], 0);
+  } finally {
+    child?.kill();
+    rmSync(dir, { recursive: true, force: true });
+  }
+});