throughline 0.10.15 → 0.10.16

package/CHANGELOG.md

@@ -10,6 +10,14 @@ 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
@@ -1449,7 +1457,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.15...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

package/README.md

@@ -638,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

package/package.json

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

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/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/);
+  }
+});