throughline 0.10.15 → 0.10.17

package/CHANGELOG.md

@@ -10,6 +10,23 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.10.17] — 2026-09-12
+
+### 修正
+
+- npm 12が単一要素配列で返す公開版情報を自己更新で受け入れるようにした。
+  正常にpackageを更新しても`version_verification_failed`で停止する問題を修正した。
+  旧文字列形式を維持し、複数版・空配列・不正な値は後続の設定・移行処理の前に拒否する。
+- 公開前の梱包文書検査も、npm 12がpackage名をキーにして返す梱包情報に対応した。
+
+## [0.10.16] — 2026-09-07
+
+### 修正
+
+- WindowsのDesktop引き継ぎで、稼働中のアプリが使うCodex実行ファイルを選ぶようにした。
+  PATH上の古いCodexがデスクトップ版の設定を読めず、新規タスクの作成に失敗する問題を修正した。
+- 引き継ぎ結果へCodex実行元を表示する。アプリの実体を特定できない場合は理由を出して停止する。
+
 ## [0.10.15] — 2026-09-06
 
 ### Fixed
@@ -1449,7 +1466,9 @@ 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.17...HEAD
+[0.10.17]: https://github.com/kitepon/Throughline/compare/v0.10.16...v0.10.17
+[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/docs/04_public_release_plan.md

@@ -44,6 +44,9 @@ Windows PowerShell 5.1へ切り替えない。更新前CLIを再利用せず、
 新CLI、公開PATHから起動したCLI、そのversion、`throughline.self_update.v1`成功結果がすべて
 一致した場合だけ完了とする。複数npm prefixが混在して公開PATHが旧実体を指す場合は失敗する。
 
+公開版の照合は、npmの旧文字列形式と[npm 12の単一結果配列](https://docs.npmjs.com/cli/v12/commands/npm-view/#output)を受け入れる。
+複数版・空配列・不正な版情報から一つを推測して選ばず、後続の設定・移行処理の前に失敗を返す。
+
 ## 明示的失敗の契約
 
 想定外の状態、外部入力違反、I/O失敗、依存不足を成功扱いにしない。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-    "version": "0.10.15",
+    "version": "0.10.17",
     "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/cli/self-update.mjs

@@ -77,7 +77,8 @@ function succeeded(result) {
 function parseRegistryVersion(result) {
   if (!succeeded(result)) return null;
   try {
-    const value = JSON.parse(result.stdout);
+    let value = JSON.parse(result.stdout);
+    if (Array.isArray(value) && value.length === 1) [value] = value;
     return typeof value === 'string' && VERSION_PATTERN.test(value) ? value : null;
   } catch {
     return null;

package/src/cli/self-update.test.mjs

@@ -181,6 +181,52 @@ test('new CLI completes install, migration, and diagnostics in order', () => {
   });
 });
 
+test('自己更新はnpmの単一版を文字列と単一要素配列から読み取る', () => {
+  for (const platform of ['darwin', 'linux', 'win32']) {
+    for (const registryVersion of ['0.10.16', ['0.10.16']]) {
+      const stdout = sink();
+      const calls = [];
+      const runner = (command, args) => {
+        calls.push([command, ...args]);
+        if (command === 'npm' || command === 'pwsh.exe') return ok(JSON.stringify(registryVersion));
+        if (args.at(-1) === 'install') return ok();
+        if (args.at(-2) === 'migrate') return ok(JSON.stringify(migration()));
+        if (args.at(-2) === 'factory-diagnostics') return ok(JSON.stringify(readyDiagnostics('0.10.16')));
+        throw new Error('想定外の更新工程');
+      };
+      assert.equal(run(['--json'], {
+        stdout, stderr: sink(), runner, platform, packageVersion: '0.10.16',
+        nodePath: '/node', cliPath: '/throughline.mjs',
+        env: {
+          THROUGHLINE_SELF_UPDATE_PHASE: 'post-install',
+          THROUGHLINE_SELF_UPDATE_BEFORE_VERSION: '0.10.15',
+          THROUGHLINE_SELF_UPDATE_EXPECTED_VERSION: '0.10.16',
+        },
+      }), 0, `${platform}: ${JSON.stringify(registryVersion)}`);
+      assert.equal(calls.length, 4);
+      assert.deepEqual(JSON.parse(stdout.values.join('')), updateSuccess('0.10.15', '0.10.16'));
+    }
+  }
+});
+
+test('自己更新は複数版・空配列・不正な版情報で後続工程を始めない', () => {
+  for (const value of [[], ['0.10.16', '0.10.17'], [['0.10.16']], [null], [{ version: '0.10.16' }], ['invalid']]) {
+    const stdout = sink();
+    let calls = 0;
+    assert.equal(run(['--json'], {
+      stdout, stderr: sink(), packageVersion: '0.10.16', platform: 'darwin',
+      runner: () => { calls += 1; return ok(JSON.stringify(value)); },
+      env: {
+        THROUGHLINE_SELF_UPDATE_PHASE: 'post-install',
+        THROUGHLINE_SELF_UPDATE_BEFORE_VERSION: '0.10.15',
+        THROUGHLINE_SELF_UPDATE_EXPECTED_VERSION: '0.10.16',
+      },
+    }), 1);
+    assert.equal(calls, 1);
+    assert.equal(JSON.parse(stdout.values.join('')).stage, 'version_verification_failed');
+  }
+});
+
 test('self-update fails closed without reflecting command output', () => {
   const stdout = sink();
   const stderr = sink();

package/src/docs-contract.test.mjs

@@ -6,9 +6,20 @@ import { fileURLToPath } from 'node:url';
 import {
   extractMarkdownTargets,
   findMissingPackedTargets,
+  packedFileSet,
 } from '../scripts/verify-pack-markdown-links.mjs';
 import { spawnPortableSync } from './os/portable-spawn-sync.mjs';
 
+test('梱包文書検査はnpmの旧配列形式とpackage名をキーにする形式を読む', () => {
+  const packed = { name: 'throughline', files: [{ path: 'README.md' }, { path: 'docs/00_overview.md' }] };
+  for (const report of [[packed], { throughline: packed }]) {
+    assert.deepEqual([...packedFileSet(report)], ['README.md', 'docs/00_overview.md']);
+  }
+  for (const report of [null, {}, [], [packed, packed], { throughline: { files: null } }]) {
+    assert.throws(() => packedFileSet(report), /npm pack dry-run JSON shape invalid/);
+  }
+});
+
 test('Markdown-only CI runs the product-owned documentation contract', () => {
   const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
   assert.equal(

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