throughline 0.16.5 → 0.16.6

package/CHANGELOG.md

@@ -10,6 +10,29 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.6] — 2026-10-08
+
+### 修正
+
+- WindowsのCodex Desktopで、自動継続が1回も引き継げなかったのを直す。`PreCompact(auto)`のhookが、会話記録の場所を確かめる所で`EISDIR: illegal operation on a directory, lstat 'C:'`で落ち、旧ターンだけを止めて、引き継ぎを作らずに終わっていた。Desktopが起動したhookの中では、Node.jsのJS実装の`fs.realpathSync`がdriveの根を読めない。OSの`realpath`（`fs.realpathSync.native`）を使う。製品のほかの所は、すでにこちらを使っていた。
+  - Windowsの端末の実測（Codex Desktop 26.930、同梱CLI 0.160.1、Node.js 24.20.0）。同じhookの中で、JS実装は13回とも同じ理由で落ち、OSの`realpath`は13回とも通った。
+  - Windowsで自動継続を有効にしていた端末は、今まで無い（既定は無効。有効にする前の確認で見つけた）。
+- `throughline doctor --codex`が、Windowsで承認済みのhookを「0/3 trusted - accept hooks in Codex menu」と表示していたのを直す。Codexは、`\`を含むkey（Windowsのpath）を`config.toml`へTOMLのliteral string（`[hooks.state.'C:\Users\…']`）で書く。doctorは`"…"`の形しか読んでいなかった。hookの動きと、Codexの公式API（`hooks/list`）が返す承認状態は、今までも正しかった。
+
+### 確認した範囲
+
+- WindowsのCodex Desktopで、公式の`PreCompact(auto)`を実際に発火させ、A→B→Cの2回の引き継ぎを人の操作なしで通した（[実測](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-08-windows-codex-auto-handoff.md)）。2回とも`continued`。3つの工程の値は元の指示と一致し、3つ目のタスクが最初のタスクのL3を取得して完了した。圧縮の記録は0件。後継の名前は`<project名>｜<作業の概要>（自動引き継ぎ）`で付いた。
+
+### 変わらない事
+
+- macOSの自動継続の動き。schema（v12）。Claude Code・Grok・Cursor。
+
+### 確認していない範囲
+
+- Windowsで、Desktopの画面から人が始めたタスクを最初の旧タスクにした引き継ぎ。実測の最初のタスクは、製品が後継を作るのと同じ道（Desktop同梱CLIのapp-server）で作り、Desktopで開いて実行させた。
+- Windowsで、容量の既定の上限まで進んだ長い会話の引き継ぎ（実測は、試験用フォルダだけ上限を60,000 tokensへ下げた）。
+- Windowsの、失敗した時の説明ページの表示と、`resume`。
+
 ## [0.16.5] — 2026-10-08
 
 ### 修正
@@ -1982,7 +2005,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.5...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.6...HEAD
+[0.16.6]: https://github.com/kitepon/Throughline/compare/v0.16.5...v0.16.6
 [0.16.5]: https://github.com/kitepon/Throughline/compare/v0.16.4...v0.16.5
 [0.16.4]: https://github.com/kitepon/Throughline/compare/v0.16.3...v0.16.4
 [0.16.3]: https://github.com/kitepon/Throughline/compare/v0.16.2...v0.16.3

package/README.ja.md

@@ -27,7 +27,7 @@ throughline auto-handoff status --json
 throughline auto-handoff disable
 ```
 
-既定では無効です。`enable`は必要な`PreCompact(auto)`フックを登録し、そのフックの承認と有効状態を公式APIで確認します。`--project`を省略すると全projectを対象にします。macOSのCodex Desktopで実機確認済みです。VS Code・CLI・他OSの自動継続は未検証です。
+既定では無効です。`enable`は必要な`PreCompact(auto)`フックを登録し、そのフックの承認と有効状態を公式APIで確認します。`--project`を省略すると全projectを対象にします。macOSとWindowsのCodex Desktopで実機確認済みです（Windowsは0.16.6から）。VS Code・CLI・Linuxの自動継続は未検証です。
 
 自動圧縮の開始前に旧ターンを停止し、同じprojectの新しいタスクへ記憶を注入して表示します。新しいタスクには、前任のタスクの題から`<project名>｜<作業の概要>（自動引き継ぎ）`の名前を付けます。元のモデル・推論強度・権限・モードなどが表示後も一致することを確認してから、継続指示を一度だけ送ります。後継でその入力と作業の進捗を観測して完了とします。手動`/compact`は発火対象に含めません。
 
@@ -42,7 +42,7 @@ throughline auto-handoff resume --operation <handoff-id> --json
 
 原因を解消した後の`resume`は同じ引き継ぎと既知の後継を再利用します。配送後の結果不明は実際の入力・開始を観測した場合だけ回復し、作成結果が不明な後継は再作成しません。従来の手動`$throughline`とcurrent-thread実験の設定は独立しています。
 
-[実測と検証範囲](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-03-codex-auto-continuation.md)を参照してください。
+[実測と検証範囲](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-03-codex-auto-continuation.md)と、[Windowsの実測](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-08-windows-codex-auto-handoff.md)を参照してください。
 
 ## Claude Codeの自動継続
 

package/README.md

@@ -26,7 +26,7 @@ throughline auto-handoff status --json
 throughline auto-handoff disable
 ```
 
-既定では無効です。`enable`は必要な`PreCompact(auto)`フックを登録し、そのフックの承認と有効状態を公式APIで確認します。`--project`を省略すると全projectを対象にします。macOSのCodex Desktopで実機確認済みです。VS Code・CLI・他OSの自動継続は未検証です。
+既定では無効です。`enable`は必要な`PreCompact(auto)`フックを登録し、そのフックの承認と有効状態を公式APIで確認します。`--project`を省略すると全projectを対象にします。macOSとWindowsのCodex Desktopで実機確認済みです（Windowsは0.16.6から）。VS Code・CLI・Linuxの自動継続は未検証です。
 
 自動圧縮の開始前に旧ターンを停止し、同じprojectの新しいタスクへ記憶を注入して表示します。新しいタスクには、前任のタスクの題から`<project名>｜<作業の概要>（自動引き継ぎ）`の名前を付けます。元のモデル・推論強度・権限・モードなどが表示後も一致することを確認してから、継続指示を一度だけ送ります。後継でその入力と作業の進捗を観測して完了とします。手動`/compact`は発火対象に含めません。
 
@@ -41,7 +41,7 @@ throughline auto-handoff resume --operation <handoff-id> --json
 
 原因を解消した後の`resume`は同じ引き継ぎと既知の後継を再利用します。配送後の結果不明は実際の入力・開始を観測した場合だけ回復し、作成結果が不明な後継は再作成しません。従来の手動`$throughline`とcurrent-thread実験の設定は独立しています。
 
-[実測と検証範囲](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-03-codex-auto-continuation.md)を参照してください。
+[実測と検証範囲](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-03-codex-auto-continuation.md)と、[Windowsの実測](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-08-windows-codex-auto-handoff.md)を参照してください。
 
 ## Claude Codeの自動継続
 

package/package.json

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

package/src/cli/doctor.mjs

@@ -405,14 +405,15 @@ function parseCodexTrustedHookState(configText) {
   let currentTrusted = false;
 
   function flush() {
-    if (currentKey && currentTrusted) trustedKeys.add(currentKey);
+    if (currentKey && currentTrusted) for (const key of currentKey) trustedKeys.add(key);
   }
 
   for (const line of configText.split(/\r?\n/)) {
-    const section = line.match(/^\s*\[hooks\.state\."([^"]+)"\]\s*$/);
+    // Codexは、`\` を含むkey（Windowsのpath）をTOMLのliteral string（'…'）で書く。basic string（"…"）の時は `\\` を戻す。
+    const section = line.match(/^\s*\[hooks\.state\.(?:"((?:[^"\\]|\\.)+)"|'([^']+)')\]\s*$/);
     if (section) {
       flush();
-      currentKey = section[1];
+      currentKey = section[2] != null ? [section[2]] : [section[1], section[1].replace(/\\(["\\])/g, '$1')];
       currentTrusted = false;
       continue;
     }

package/src/cli/doctor.test.mjs

@@ -456,6 +456,30 @@ test('readCodexHookDiagnosis detects Codex prompt and Stop hooks', () => {
   }
 });
 
+test('readCodexHookDiagnosis: Windowsのpathのkey（TOMLのliteral string・escapeしたbasic string）の承認を読む', () => {
+  const codexHome = mkdtempSync(join(tmpdir(), 'throughline-doctor-codex-trust-'));
+  try {
+    const hook = (name, timeout) => [{ hooks: [{ type: 'command', command: `/usr/bin/node /pkg/bin/throughline.mjs codex-hook ${name}`, timeout, async: false }] }];
+    writeFileSync(join(codexHome, 'hooks.json'), JSON.stringify({ hooks: {
+      UserPromptSubmit: hook('user-prompt-submit', 30), PostToolUse: hook('post-tool-use', 30), Stop: hook('stop', 300) } }) + '\n');
+    // foxの実測（2026-10-08）: Codex 0.160 は `[hooks.state.'C:\Users\…\hooks.json:stop:0:0']` と書く。
+    const hooksPath = join(codexHome, 'hooks.json');
+    const hash = 'trusted_hash = "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"';
+    writeFileSync(join(codexHome, 'config.toml'), ['[features]', 'hooks = true', '',
+      `[hooks.state.'${hooksPath}:user_prompt_submit:0:0']`, hash, '',
+      `[hooks.state.${JSON.stringify(`${hooksPath}:post_tool_use:0:0`)}]`, hash, '',
+      `[hooks.state.'${hooksPath}:stop:0:0']`, 'enabled = true', ''].join('\n'));
+    const diagnosis = readCodexHookDiagnosis(codexHome);
+    assert.equal(diagnosis.managedPromptHooks[0].throughlineDoctorTrusted, true);
+    assert.equal(diagnosis.managedPostToolUseHooks[0].throughlineDoctorTrusted, true);
+    // trusted_hash の無い項目は、承認済みに数えない。
+    assert.equal(diagnosis.managedStopHooks[0].throughlineDoctorTrusted, false);
+    assert.equal(diagnosis.managedHookTrust.trustedCount, 2);
+  } finally {
+    rmSync(codexHome, { recursive: true, force: true });
+  }
+});
+
 // ─── formatAgo ──────────────────────────────────────────────────────
 
 test('formatAgo: 60 秒未満は秒表示', () => {

package/src/codex-auto-handoff.mjs

@@ -164,7 +164,8 @@ export async function requestCodexAutoHandoff({ payload, db = null,
       typeof payload.transcript_path !== 'string' || !isAbsolute(payload.transcript_path) || !isAbsolute(payload.cwd ?? '')) {
     throw error('handoff_hook_identity_invalid');
   }
-  const rolloutPath = realpathSync(payload.transcript_path);
+  // JS実装のrealpathは、WindowsのCodex Desktopが起動したhookの中で `EISDIR: lstat 'C:'` で落ちる。OSのrealpathを使う。
+  const rolloutPath = realpathSync.native(payload.transcript_path);
   const state = readCodexHandoffState(rolloutPath, { threadId, turnId });
   if (state.meta.originator !== 'Codex Desktop' || state.meta.source !== 'vscode') return { status: 'skipped', reason: 'handoff_host_unsupported' };
   if (!sameProjectPath(state.meta.cwd, payload.cwd) || state.latestTurnId !== turnId) throw error('handoff_hook_source_mismatch');

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

@@ -1,6 +1,8 @@
 import assert from 'node:assert/strict';
 import { test } from 'node:test';
 import { mkdtempSync, mkdirSync, rmSync, writeFileSync, existsSync } from 'node:fs';
+import fs from 'node:fs';
+import { syncBuiltinESMExports } from 'node:module';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { tmpdir } from 'node:os';
@@ -216,6 +218,26 @@ test('PreCompactの重複ではworkerを増やさず、manualと別projectでは
   assert.equal((await requestCodexAutoHandoff({ ...args, config: { ...config, projects: ['/other'] } })).status, 'skipped');
 }));
 
+test('PreCompactの入口は、JS実装のrealpathが使えない環境（WindowsのCodex Desktopのhook）でも引き継ぎを作る', async () => withDb(async (db, home) => {
+  const thread = '11111111-1111-1111-1111-111111111111', turn = '22222222-2222-2222-2222-222222222222';
+  const dir = join(home, 'codex', 'sessions'); mkdirSync(dir, { recursive: true });
+  const file = join(dir, 'rollout.jsonl');
+  writeFileSync(file, [{ type: 'session_meta', payload: { id: thread, originator: 'Codex Desktop', source: 'vscode', cwd: home } },
+    { type: 'event_msg', payload: { type: 'task_started', turn_id: turn } }].map(JSON.stringify).join('\n') + '\n');
+  // foxの実測（2026-10-08）: Desktopが起動したhookの中では、JS実装が drive の根を lstat できずに落ちた。
+  const original = fs.realpathSync;
+  const broken = () => { throw Object.assign(new Error("EISDIR: illegal operation on a directory, lstat 'C:'"), { code: 'EISDIR' }); };
+  broken.native = original.native;
+  fs.realpathSync = broken; syncBuiltinESMExports();
+  try {
+    let launched = 0;
+    const result = await requestCodexAutoHandoff({ db, config: { enabled: true, projects: [home], openHost: 'desktop' },
+      payload: { trigger: 'auto', cwd: home, session_id: thread, turn_id: turn, transcript_path: file },
+      launchWorker: async () => { launched++; } });
+    assert.equal(result.status, 'ok'); assert.equal(result.inserted, true); assert.equal(launched, 1);
+  } finally { fs.realpathSync = original; syncBuiltinESMExports(); }
+}));
+
 function desktopSource(home, thread, turn) {
   const dir = join(home, 'codex', 'sessions'); mkdirSync(dir, { recursive: true });
   const file = join(dir, `rollout-${thread}.jsonl`);