throughline 0.16.13 → 0.16.14

package/CHANGELOG.md

@@ -10,6 +10,28 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.14] — 2026-10-10
+
+### 修正
+
+- Codex Desktop（同梱のCodex 0.162.0-alpha.17.2）が、内部の文脈（ターンのIDが`auto-compact-N`）から`PreCompact(auto)`のhookを呼ぶ時、Throughlineが`handoff_hook_identity_invalid`の失敗として記録していた。macOSの実機で3回。圧縮は止まっていて、タスクにも影響は無かったが、起きていない失敗がhighで記録された。この形の呼び出しは、失敗にせず圧縮だけを止め、`~/.throughline/codex-auto-handoff/internal-compactions.jsonl`に1行残す（[ADR 0047](docs/adr/0047-codex-internal-compaction-is-stopped-without-error.md)）。
+  - 圧縮を止める動きは今までと同じ。引き継ぎは、文脈が上限に近づいた利用者のターンで今までどおり起きる。
+  - それ以外の不正なID（会話のIDがUUIDでない、記録の場所が無い、知らない形のターンのID）は、今までどおり失敗として記録する。
+
+### 対応の範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Codex（Desktop） | 直した。単体試験と、切り離した置き場での本物のhookの命令で確認（内部のIDは失敗0件・記録1行、不正なIDは失敗1件）。CIのmacOSも成功。**本物のCodex Desktopが内部の文脈からhookを呼ぶ場面は、狙って起こせないので未確認** | 直した。単体試験とCI。実機（同梱0.162.0-alpha.2）では、この呼び出しが起きていない | 直した。単体試験とCI。実機では、この失敗の記録が無い |
+| Claude Code | 対象外。Claude Codeの`PreCompact`は別の実装で、ターンのIDを検査しない | 同じ | 同じ |
+| Grok | 対象外。自動継続の機能が無く、`PreCompact`のhookを登録していない | 同じ | 同じ |
+| Cursor | 対象外。自動継続の機能が無く、`PreCompact`のhookを登録していない | 同じ | 同じ |
+
+### 確認していない範囲
+
+- 本物のCodex Desktopが内部の文脈からhookを呼ぶ場面での、新しい版の動き（次に起きた時に、失敗の記録が増えず、`internal-compactions.jsonl`に行が出る事で確かめる）。
+- 内部の文脈からの圧縮が、Codexのどの処理から始まるか（公開ソースでIDの形と渡り方だけを確かめた）。
+
 ## [0.16.13] — 2026-10-10
 
 ### 修正
@@ -2173,7 +2195,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.13...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.14...HEAD
+[0.16.14]: https://github.com/kitepon/Throughline/compare/v0.16.13...v0.16.14
 [0.16.13]: https://github.com/kitepon/Throughline/compare/v0.16.12...v0.16.13
 [0.16.12]: https://github.com/kitepon/Throughline/compare/v0.16.11...v0.16.12
 [0.16.11]: https://github.com/kitepon/Throughline/compare/v0.16.10...v0.16.11

package/docs/adr/0047-codex-internal-compaction-is-stopped-without-error.md

@@ -0,0 +1,40 @@
+# ADR 0047: Codex の内部の文脈からの自動圧縮は、失敗にせず止める
+
+日付: 2026-10-10
+
+## Context
+
+Codex Desktop の自動継続は、`PreCompact(auto)` の hook が受け取った会話の ID とターンの ID が UUID の形でない時、
+`handoff_hook_identity_invalid` の例外にしていた。例外になった hook は、失敗の記録（`HOOK_CODEX_FAILED`、high）を残し、
+`continue: false` を返して圧縮を止める。
+
+2026-10-10、macOS の実機（Codex Desktop 26.1007、同梱の Codex 0.162.0-alpha.17.2）で、この失敗が3回記録された。
+
+- 13:04:46: 引き継ぎのためにターンを止めた 2.5 秒後。
+- 13:24:01: 別のタスクのターンが始まった 3.3 秒後。
+- 13:25:25: そのタスクを引き継ぎのために止めた 4.7 秒後。
+
+Codex は、利用者のターンとは別に、自分で作る内部の文脈を持つ。その文脈のターンの ID は `auto-compact-N` の形になる
+（`codex-rs/core/src/session/mod.rs` の `next_internal_sub_id`）。`PreCompact` の hook へ渡るターンの ID は、その時の文脈の ID
+（`codex-rs/core/src/hook_runtime.rs` の `run_pre_compact_hooks`）なので、内部の文脈から圧縮が始まると、UUID でない ID が届く。
+同梱の Codex が 0.162.0-alpha.2 の端末（Linux）では、この呼び出しは起きていない。
+
+3回とも、hook は圧縮を止めていた。2つのタスクの rollout に圧縮の行は無く、使用量も減っていない。13:24:01 に止めた後、
+ターンはそのまま進み、80 秒後の `PreCompact`（利用者のターンの ID）で引き継いで `continued` になった。
+起きていた害は、起きていない失敗が high で記録された事だった。
+
+## Decision
+
+1. 会話の ID と記録の場所が正しく、ターンの ID が `auto-compact-<数字>` の形の `PreCompact(auto)` は、失敗にしない。
+   `continue: false` を返して圧縮を止める（今までと同じ結果）。失敗の記録は残さない。
+2. その時に引き継ぎは作らない。内部の文脈は利用者のターンではなく、止める所と続ける作業が決まらない。文脈を残しておけば、
+   文脈が上限に近づいた利用者のターンの `PreCompact` で、今までどおり引き継ぐ。
+3. 止めた事を `~/.throughline/codex-auto-handoff/internal-compactions.jsonl` に1行残す（時刻・会話の ID・ターンの ID）。
+4. それ以外の形（会話の ID が UUID でない、記録の場所が無い、ターンの ID が知らない形）は、今までどおり
+   `handoff_hook_identity_invalid` の失敗にする。
+
+## Consequences
+
+- 内部の文脈からの圧縮で、失敗の記録が増えなくなる。圧縮を止める動きは変わらない。
+- 内部の文脈からの圧縮が何度も起きるタスクでも、圧縮は通らない。利用者のターンの `PreCompact` が来るまで、文脈はそのまま残る。
+- Codex が内部の ID の形を変えると、また失敗として記録される。その時は記録の message で気づける。

package/package.json

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

package/src/codex-auto-handoff.mjs

@@ -103,6 +103,15 @@ function openSuccessor(operation) {
   return !result.error && result.status === 0;
 }
 
+// Codex が内部の文脈へ付けるターンの ID（`codex-rs/core/src/session/mod.rs` の `next_internal_sub_id`）。
+const INTERNAL_COMPACTION_TURN_ID_PATTERN = /^auto-compact-\d+$/;
+
+/** ターンの外の自動圧縮を止めた記録。引き継ぎの行は増えないので、起きた事をここに残す。会話の本文は書かない。 */
+function recordInternalCompactionStop(entry) {
+  mkdirSync(stateRoot(), { recursive: true, mode: 0o700 });
+  appendFileSync(join(stateRoot(), 'internal-compactions.jsonl'), JSON.stringify(entry) + '\n', { mode: 0o600 });
+}
+
 /** 引き継ぎ済みの旧タスクを止めた記録。引き継ぎの行は増えないので、起きた事をここに残す。会話の本文は書かない。 */
 function recordAutoHandoffRedirect(entry) {
   mkdirSync(stateRoot(), { recursive: true, mode: 0o700 });
@@ -157,13 +166,20 @@ function settleUndeliveredAutoHandoff(db, threadId, { rolloutPath, processes, re
 export async function requestCodexAutoHandoff({ payload, db = null,
   config = readAutoHandoffConfig(), launchWorker = launchAutoHandoffWorker,
   findThread = findCodexThreadCandidate, openThread = openSuccessor, recordRedirect = recordAutoHandoffRedirect,
+  recordInternalCompaction = recordInternalCompactionStop,
   processes = readRuntimeProcesses, readTarget = targetState, now = Date.now() } = {}) {
   if (payload.trigger !== 'auto' || !autoHandoffEnabledFor(config, payload.cwd)) return { status: 'skipped' };
   const threadId = payload.session_id, turnId = payload.turn_id;
-  if (!CODEX_NATIVE_ID_PATTERN.test(threadId ?? '') || !CODEX_NATIVE_ID_PATTERN.test(turnId ?? '') ||
-      typeof payload.transcript_path !== 'string' || !isAbsolute(payload.transcript_path) || !isAbsolute(payload.cwd ?? '')) {
-    throw error('handoff_hook_identity_invalid');
+  const located = CODEX_NATIVE_ID_PATTERN.test(threadId ?? '') &&
+    typeof payload.transcript_path === 'string' && isAbsolute(payload.transcript_path) && isAbsolute(payload.cwd ?? '');
+  // Codex が自分で作った内部の文脈（ターンの ID が `auto-compact-N`）からの圧縮。利用者のターンではないので、
+  // 引き継ぎの起点にできない。例外にせず圧縮だけを止める（文脈を残せば、次の利用者のターンの圧縮の合図で引き継げる）。
+  if (located && INTERNAL_COMPACTION_TURN_ID_PATTERN.test(turnId ?? '')) {
+    recordInternalCompaction({ at: new Date(now).toISOString(), thread_id: threadId, turn_id: turnId });
+    return { status: 'ok', inserted: false, internalCompaction: true, continue: false,
+      stopReason: 'Throughlineが、ターンの外の自動圧縮を止めました。文脈が上限に近づいたターンで、新しいタスクへ引き継ぎます。' };
   }
+  if (!located || !CODEX_NATIVE_ID_PATTERN.test(turnId ?? '')) throw error('handoff_hook_identity_invalid');
   // JS実装のrealpathは、WindowsのCodex Desktopが起動したhookの中で `EISDIR: lstat 'C:'` で落ちる。OSのrealpathを使う。
   const rolloutPath = realpathSync.native(payload.transcript_path);
   const state = readCodexHandoffState(rolloutPath, { threadId, turnId });

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

@@ -287,6 +287,33 @@ test('PreCompactの重複ではworkerを増やさず、manualと別projectでは
   assert.equal((await requestCodexAutoHandoff({ ...args, config: { ...config, projects: ['/other'] } })).status, 'skipped');
 }));
 
+test('Codexの内部の文脈（auto-compact-N）からの圧縮は、例外にせず止めて記録する。引き継ぎは作らない', async () => withDb(async (db, home) => {
+  const thread = '11111111-1111-1111-1111-111111111111';
+  const file = join(home, 'rollout.jsonl'); writeFileSync(file, '');
+  const payload = { trigger: 'auto', cwd: home, session_id: thread, turn_id: 'auto-compact-3', transcript_path: file };
+  const config = { enabled: true, projects: [home], openHost: 'desktop' };
+  let launched = 0; const recorded = [];
+  const args = { db, config, payload, launchWorker: async () => { launched++; }, recordInternalCompaction: entry => recorded.push(entry), now: Date.parse('2026-10-10T04:24:01.175Z') };
+  const result = await requestCodexAutoHandoff(args);
+  assert.equal(result.status, 'ok'); assert.equal(result.continue, false); assert.equal(result.internalCompaction, true);
+  assert.match(result.stopReason, /ターンの外の自動圧縮を止めました/);
+  assert.equal(launched, 0);
+  assert.equal(db.prepare('SELECT COUNT(*) n FROM codex_handoffs').get().n, 0, '引き継ぎの行は作らない');
+  assert.deepEqual(recorded, [{ at: '2026-10-10T04:24:01.175Z', thread_id: thread, turn_id: 'auto-compact-3' }]);
+
+  // 無効な project と手動の圧縮は、今までどおり何もしない
+  assert.equal((await requestCodexAutoHandoff({ ...args, config: { ...config, projects: ['/other'] } })).status, 'skipped');
+  assert.equal((await requestCodexAutoHandoff({ ...args, payload: { ...payload, trigger: 'manual' } })).status, 'skipped');
+  assert.equal(recorded.length, 1);
+
+  // 形の決まっていない ID と、場所の分からない呼び出しは、今までどおり失敗として扱う
+  for (const broken of [{ turn_id: 'something-else' }, { turn_id: undefined }, { turn_id: 'auto-compact-' }, { session_id: 'not-a-uuid' },
+    { transcript_path: null }, { transcript_path: 'relative/rollout.jsonl' }]) {
+    await assert.rejects(requestCodexAutoHandoff({ ...args, payload: { ...payload, ...broken } }), /handoff_hook_identity_invalid/);
+  }
+  assert.equal(recorded.length, 1);
+}));
+
 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 });