throughline 0.16.14 → 0.16.15

package/CHANGELOG.md

@@ -10,6 +10,28 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.15] — 2026-10-10
+
+### 追加
+
+- `throughline auto-handoff successor --thread <Codexの会話のID> --json`。あるCodexのタスクの「今の続き」を返す、読むだけの入口。ほかの製品が、旧タスクあての連絡を今の続きへ渡す時に使う。`auto-handoff status --json`は新しい20件だけを返すので、古い引き継ぎの続きを引けなかった。
+  - 返す物: `handed_off`（残っている後継があるか）、`current_thread_id`（引き継ぎを先までたどった、残っている一番先の後継。無ければ渡したID自身）、`chain`（そこまでの引き継ぎ）、`pending`（今の続きのタスクで、後継へ指示を送る前の引き継ぎ。`in_flight`がtrueならworkerが動いている最中、falseなら止まっていて`error_code`と`resume_state`が入る）。
+  - 消された後継とアーカイブ済みの後継は、無い物として扱う（旧タスクへ入力が来た時に開く後継と同じ決め方）。
+  - 記録が無い端末では、引き継ぎが1つも無い時と同じ答えを返す。記録は読み取り専用で開く。
+
+### 対応の範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Codex（Desktop） | 追加した。実機の記録で確認（引き継ぎ済みのタスク2つから今の続きが返り、引き継ぎの無いタスクは自分自身が返った） | 追加した。実機の記録で確認（後継がアーカイブ済みの系列は、旧タスク自身が返った） | 追加した。実機の記録で確認（16本続いた系列の最初と途中から、同じ今の続きが返った。止まったタスクは`pending`に理由が出た） |
+| Claude Code | 対象外。Claude Codeの自動継続の記録は別の形で、`auto-handoff status --host claude --json`が全件を返す | 同じ | 同じ |
+| Grok | 対象外。自動継続の機能が無い | 同じ | 同じ |
+| Cursor | 対象外。自動継続の機能が無い | 同じ | 同じ |
+
+### 変わらない事
+
+- 引き継ぎの動き。`auto-handoff status --json`の出力。
+
 ## [0.16.14] — 2026-10-10
 
 ### 修正
@@ -2195,7 +2217,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.14...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.15...HEAD
+[0.16.15]: https://github.com/kitepon/Throughline/compare/v0.16.14...v0.16.15
 [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

package/README.ja.md

@@ -40,6 +40,14 @@ throughline auto-handoff status --operation <handoff-id> --json
 throughline auto-handoff resume --operation <handoff-id> --json
 ```
 
+あるタスクの今の続きは、次の命令で引けます（読むだけ。ほかの道具が、旧タスクあての連絡を今の続きへ渡す時に使います）。
+
+```bash
+throughline auto-handoff successor --thread <codex-thread-id> --json
+```
+
+`current_thread_id`が今の続きです（後継が無ければ渡したID自身）。`pending.in_flight`がtrueの間は、引き継ぎの途中です。
+
 原因を解消した後の`resume`は同じ引き継ぎと既知の後継を再利用します。配送後の結果不明は実際の入力・開始を観測した場合だけ回復し、作成結果が不明な後継は再作成しません。従来の手動`$throughline`とcurrent-thread実験の設定は独立しています。
 
 [実測と検証範囲](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)、[Linuxの実測](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-08-linux-codex-auto-handoff.md)を参照してください。

package/README.md

@@ -39,6 +39,14 @@ throughline auto-handoff status --operation <handoff-id> --json
 throughline auto-handoff resume --operation <handoff-id> --json
 ```
 
+あるタスクの今の続きは、次の命令で引けます（読むだけ。ほかの道具が、旧タスクあての連絡を今の続きへ渡す時に使います）。
+
+```bash
+throughline auto-handoff successor --thread <codex-thread-id> --json
+```
+
+`current_thread_id`が今の続きです（後継が無ければ渡したID自身）。`pending.in_flight`がtrueの間は、引き継ぎの途中です。
+
 原因を解消した後の`resume`は同じ引き継ぎと既知の後継を再利用します。配送後の結果不明は実際の入力・開始を観測した場合だけ回復し、作成結果が不明な後継は再作成しません。従来の手動`$throughline`とcurrent-thread実験の設定は独立しています。
 
 [実測と検証範囲](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)、[Linuxの実測](https://github.com/kitepon/Throughline/blob/main/evidence/2026-10-08-linux-codex-auto-handoff.md)を参照してください。

package/bin/throughline.mjs

@@ -412,6 +412,8 @@ Usage:
                               引き継ぎの状態と固定理由を確認
   throughline auto-handoff resume --operation <id> --json
                               同じ引き継ぎを再開（結果不明は再送しない）
+  throughline auto-handoff successor --thread <codex-thread-id> --json
+                              あるCodexのタスクの今の続きを返す（読むだけ）
   throughline auto-handoff mark-sources [--dry-run] [--json]
                               今までの引き継ぎの名前を付け直す（旧タスクへ印、
                               名前の無い後継へ名前）

package/package.json

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

package/src/cli/auto-handoff.mjs

@@ -5,7 +5,7 @@ import { getDb, openReadOnlyDb, DB_PATH, CURRENT_VERSION } from '../db.mjs';
 import { listAutoHandoffs, getAutoHandoff } from '../codex-auto-handoff-store.mjs';
 import { renderFrozenDetail } from '../codex-auto-handoff-memory.mjs';
 import { readAutoHandoffConfig, writeAutoHandoffConfig } from '../codex-auto-handoff-config.mjs';
-import { autoHandoffDeliveryProfile, runAutoHandoffWorker, markAutoHandoffSources } from '../codex-auto-handoff.mjs';
+import { autoHandoffDeliveryProfile, runAutoHandoffWorker, markAutoHandoffSources, resolveAutoHandoffSuccessor } from '../codex-auto-handoff.mjs';
 import { installCodexAutoHandoffHook, installClaudeAutoHandoffHooks, removeClaudeAutoHandoffHooks,
   claudeAutoHandoffHooksRegistered } from './install.mjs';
 import { sameProjectPath } from '../project-path.mjs';
@@ -17,17 +17,17 @@ import { listClaudeAutoHandoffs, publicClaudeAutoHandoff, runClaudeAutoHandoffWo
 const CLAUDE_ACTIONS = ['enable', 'disable', 'status', 'worker', 'desktop-open'];
 
 export function parseAutoHandoffArgs(args) {
-  const out = { action: args[0] ?? 'status', host: 'codex', operation: null, project: null, origin: null, turn: null, database: null, json: false, dryRun: false };
-  if (!['enable', 'disable', 'status', 'resume', 'detail', 'worker', 'desktop-open', 'mark-sources'].includes(out.action)) throw Error('auto_handoff_action_invalid');
+  const out = { action: args[0] ?? 'status', host: 'codex', operation: null, project: null, origin: null, turn: null, database: null, thread: null, json: false, dryRun: false };
+  if (!['enable', 'disable', 'status', 'resume', 'detail', 'worker', 'desktop-open', 'mark-sources', 'successor'].includes(out.action)) throw Error('auto_handoff_action_invalid');
   const allowed = ['host', ...{ enable: ['project'], disable: [], status: ['project', 'operation'],
-    resume: ['operation'], worker: ['operation'], 'desktop-open': ['operation'], 'mark-sources': [], detail: ['operation', 'origin', 'turn', 'database'] }[out.action]];
+    resume: ['operation'], worker: ['operation'], 'desktop-open': ['operation'], 'mark-sources': [], successor: ['thread'], detail: ['operation', 'origin', 'turn', 'database'] }[out.action]];
   const seen = new Set();
   for (let i = 1; i < args.length; i++) {
     if (seen.has(args[i])) throw Error('auto_handoff_argument_invalid');
     seen.add(args[i]);
     if (args[i] === '--json') { out.json = true; continue; }
     if (args[i] === '--dry-run' && out.action === 'mark-sources') { out.dryRun = true; continue; }
-    const key = { '--host': 'host', '--operation': 'operation', '--project': 'project', '--origin': 'origin', '--turn': 'turn', '--database': 'database' }[args[i]];
+    const key = { '--host': 'host', '--operation': 'operation', '--project': 'project', '--origin': 'origin', '--turn': 'turn', '--database': 'database', '--thread': 'thread' }[args[i]];
     if (!key || !allowed.includes(key) || !args[i + 1] || args[i + 1].startsWith('--')) throw Error('auto_handoff_argument_invalid');
     out[key] = args[++i];
   }
@@ -36,6 +36,7 @@ export function parseAutoHandoffArgs(args) {
   if (out.project && !isAbsolute(out.project)) out.project = resolve(out.project);
   if (out.project && out.operation) throw Error('auto_handoff_argument_invalid');
   if (['worker', 'resume', 'detail', 'desktop-open'].includes(out.action) && !out.operation) throw Error('auto_handoff_operation_required');
+  if (out.action === 'successor' && !out.thread) throw Error('auto_handoff_thread_required');
   if (out.action === 'detail') {
     out.turn = Number(out.turn);
     if (!out.origin || !Number.isSafeInteger(out.turn) || out.turn < 1) throw Error('auto_handoff_detail_identity_required');
@@ -128,6 +129,14 @@ export async function run(args = []) {
       finally { db.close(); }
       process.stdout.write(parsed.json ? JSON.stringify({ status: 'ok', text }) + '\n' : text + '\n');
       return 0;
+    } else if (parsed.action === 'successor') {
+      // あるタスクの今の続きを返す。読むだけ。DB がまだ無い端末では、引き継ぎが1つも無いのと同じ答えにする。
+      const db = existsSync(DB_PATH) ? openReadOnlyDb() : null;
+      try {
+        if (db && db.prepare('PRAGMA user_version').get().user_version !== CURRENT_VERSION) throw Error('auto_handoff_schema_mismatch');
+        result = { schema: 'throughline.codex_auto_handoff_successor.v1', ...(db ? resolveAutoHandoffSuccessor(db, parsed.thread)
+          : { thread_id: parsed.thread, handed_off: false, current_thread_id: parsed.thread, chain: [], pending: null }) };
+      } finally { db?.close(); }
     } else if (parsed.action === 'mark-sources') {
       // 0.16.9 までの版が引き継いだ分の名前を付け直す（名前の無い後継へ名前、旧タスクへ引き継ぎ済みの印）。何度流しても同じ結果になる。
       const db = getDb();

package/src/codex-auto-handoff.mjs

@@ -301,6 +301,39 @@ export async function nameAutoHandoffTarget(request, targetId, name) {
   }
 }
 
+/**
+ * あるタスクの「今の続き」を引く（ほかの製品が、旧タスクあての連絡を今の続きへ渡すための入口）。読むだけ。
+ * 引き継ぎを先までたどり、残っている一番先の後継を返す。消された後継は無い物として扱う。
+ * @returns {{
+ *   thread_id: string, handed_off: boolean, current_thread_id: string,
+ *   chain: Array<{handoff_id: string, source_thread_id: string, target_thread_id: string, state: string, created_at: number, updated_at: number}>,
+ *   pending: null | {handoff_id: string, source_thread_id: string, state: string, error_code: string|null, resume_state: string|null,
+ *     in_flight: boolean, created_at: number, updated_at: number}
+ * }} current_thread_id は、後継が無ければ thread_id 自身。pending は、今の続きのタスクで、後継へ指示を送る前の引き継ぎ
+ *   （一番新しい1つ）。in_flight が true なら worker が動いている最中、false なら止まっている（error_code と resume_state を見る）。
+ */
+export function resolveAutoHandoffSuccessor(db, threadId, { findThread = findCodexThreadCandidate,
+  processes = readRuntimeProcesses, now = Date.now() } = {}) {
+  if (!CODEX_NATIVE_ID_PATTERN.test(threadId ?? '')) throw error('handoff_thread_id_invalid');
+  // 残っている一番先の後継（旧タスクへ入力が来た時に開く物と同じ）。そこから threadId まで、作った引き継ぎをさかのぼる。
+  const leaf = findLiveAutoHandoffSuccessor(db, threadId, { findThread });
+  const path = [];
+  for (let operation = leaf, depth = 0; operation && depth < 200; depth++) {
+    path.unshift(operation);
+    if (operation.source_thread_id === threadId) break;
+    operation = findAutoHandoffForTarget(db, operation.source_thread_id);
+  }
+  const chain = path.map(operation => ({ handoff_id: operation.handoff_id, source_thread_id: operation.source_thread_id,
+    target_thread_id: operation.target_thread_id, state: operation.state, created_at: operation.created_at, updated_at: operation.updated_at }));
+  const current = leaf ? leaf.target_thread_id : threadId;
+  const undelivered = listUndeliveredAutoHandoffsForSource(db, current)[0] ?? null;
+  const pending = undelivered ? { handoff_id: undelivered.handoff_id, source_thread_id: undelivered.source_thread_id,
+    state: undelivered.state, error_code: undelivered.error_code ?? null, resume_state: undelivered.resume_state ?? null,
+    in_flight: !HANDOFF_TERMINAL_STATES.has(undelivered.state) && workerActive(undelivered, processes, now),
+    created_at: undelivered.created_at, updated_at: undelivered.updated_at } : null;
+  return { thread_id: threadId, handed_off: chain.length > 0, current_thread_id: current, chain, pending };
+}
+
 /**
  * 引き継ぎが済んだ旧タスクの名前の頭へ、引き継ぎ済みの印を付ける。同じ名前の後継が一覧に並んでも、
  * 印の無い1本が今の続きだと分かるようにする。今の名前を読んでから付けるので、利用者が付け直した名前も残る。

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

@@ -15,7 +15,7 @@ import { readCodexHandoffState, settingsMatch, threadStartSettings, resolvePrepa
 import { runAutoHandoffWorker, requestCodexAutoHandoff, sourceBoundary,
   autoHandoffTargetName, nameAutoHandoffTarget, findLiveAutoHandoffSuccessor,
   markAutoHandoffSource, markAutoHandoffSources, autoHandoffSourceFallbackTitle, carryAutoHandoffQueue,
-  untrackedInheritedMemory } from './codex-auto-handoff.mjs';
+  untrackedInheritedMemory, resolveAutoHandoffSuccessor } from './codex-auto-handoff.mjs';
 import { parseAutoHandoffArgs } from './cli/auto-handoff.mjs';
 
 async function withDb(fn) {
@@ -287,6 +287,58 @@ test('PreCompactの重複ではworkerを増やさず、manualと別projectでは
   assert.equal((await requestCodexAutoHandoff({ ...args, config: { ...config, projects: ['/other'] } })).status, 'skipped');
 }));
 
+test('タスクの今の続きを引く。先までたどり、消えた後継は無い物として扱い、途中の引き継ぎと止まった引き継ぎを見分ける', async () => withDb(async db => {
+  const id = n => `${String(n).repeat(8)}-${String(n).repeat(4)}-${String(n).repeat(4)}-${String(n).repeat(4)}-${String(n).repeat(12)}`;
+  const [A, B, C, D, X, Y, Z] = [1, 2, 3, 4, 5, 6, 7].map(id);
+  const done = (source, target) => updateAutoHandoff(db, request(db, source).operation.handoff_id,
+    { state: 'continued', target_thread_id: target, queued_submission_id: `receipt-${target}` }).operation;
+  const gone = new Set();
+  const options = { findThread: ({ threadId }) => gone.has(threadId) ? null : { rolloutPath: `/r/${threadId}`, mtimeMs: 1 }, processes: () => [], now: 1_000_000 };
+  // 引き継ぎの無いタスクは、自分が今の続き
+  assert.deepEqual(resolveAutoHandoffSuccessor(db, X, options), { thread_id: X, handed_off: false, current_thread_id: X, chain: [], pending: null });
+
+  const ab = done(A, B); const bc = done(B, C);
+  const fromA = resolveAutoHandoffSuccessor(db, A, options);
+  assert.equal(fromA.handed_off, true); assert.equal(fromA.current_thread_id, C); assert.equal(fromA.pending, null);
+  assert.deepEqual(fromA.chain.map(item => [item.handoff_id, item.source_thread_id, item.target_thread_id, item.state]),
+    [[ab.handoff_id, A, B, 'continued'], [bc.handoff_id, B, C, 'continued']]);
+  assert.equal(resolveAutoHandoffSuccessor(db, B, options).current_thread_id, C);
+  assert.deepEqual(resolveAutoHandoffSuccessor(db, B, options).chain.map(item => item.handoff_id), [bc.handoff_id]);
+  assert.equal(resolveAutoHandoffSuccessor(db, C, options).handed_off, false);
+
+  // 今の続き C が、さらに引き継いでいる最中（worker が動いている）
+  const cd = updateAutoHandoff(db, request(db, C).operation.handoff_id, { state: 'memory_ready' }).operation;
+  db.prepare('UPDATE codex_handoffs SET worker_identity_json = ?, updated_at = ? WHERE handoff_id = ?').run(JSON.stringify({ pid: 4242, started_identity: 'w' }), 999_000, cd.handoff_id);
+  const running = resolveAutoHandoffSuccessor(db, A, { ...options, processes: () => [{ pid: 4242, started_identity: 'w' }] });
+  assert.equal(running.current_thread_id, C); assert.equal(running.pending.handoff_id, cd.handoff_id);
+  assert.equal(running.pending.in_flight, true); assert.equal(running.pending.state, 'memory_ready');
+  // worker が居なくなっていれば、途中で止まった物として返す
+  assert.equal(resolveAutoHandoffSuccessor(db, A, options).pending.in_flight, false);
+
+  // C の引き継ぎが失敗して止まった
+  updateAutoHandoff(db, cd.handoff_id, { state: 'failed', error_code: 'handoff_summarizer_backend_failed', resume_state: 'source_stopped' });
+  const stopped = resolveAutoHandoffSuccessor(db, A, options);
+  assert.equal(stopped.current_thread_id, C);
+  assert.deepEqual([stopped.pending.state, stopped.pending.error_code, stopped.pending.resume_state, stopped.pending.in_flight],
+    ['failed', 'handoff_summarizer_backend_failed', 'source_stopped', false]);
+
+  // やり直して D へ続いた。C が消されても、D が残っていれば D が今の続き
+  updateAutoHandoff(db, cd.handoff_id, { state: 'continued', error_code: null, resume_state: null, target_thread_id: D, queued_submission_id: 'receipt-D' });
+  gone.add(C);
+  const toD = resolveAutoHandoffSuccessor(db, A, options);
+  assert.equal(toD.current_thread_id, D); assert.equal(toD.chain.length, 3); assert.equal(toD.pending, null);
+  // 後継が全部消されたら、旧タスクが今の続きに戻る
+  gone.add(D); gone.add(B);
+  assert.deepEqual(resolveAutoHandoffSuccessor(db, A, options), { thread_id: A, handed_off: false, current_thread_id: A, chain: [], pending: null });
+
+  // 後継が出来る前に失敗したタスク（後継なし）
+  updateAutoHandoff(db, request(db, Y).operation.handoff_id, { state: 'failed', error_code: 'handoff_target_not_loaded', resume_state: 'memory_ready' });
+  const failed = resolveAutoHandoffSuccessor(db, Y, options);
+  assert.equal(failed.handed_off, false); assert.equal(failed.current_thread_id, Y); assert.equal(failed.pending.error_code, 'handoff_target_not_loaded');
+  assert.throws(() => resolveAutoHandoffSuccessor(db, 'not-a-thread', options), /handoff_thread_id_invalid/);
+  void Z;
+}));
+
 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, '');