throughline 0.13.0 → 0.14.1

package/src/turn-backfill.mjs

@@ -20,7 +20,14 @@
 import { appendFileSync, mkdirSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
-import { getLogicalTurnGroups } from './transcript-reader.mjs';
+import {
+  extractDetailBlocks,
+  getLogicalTurnGroups,
+  isJunkAssistantText,
+  readLatestUserGroup,
+  readRawEntries,
+  sliceInFlightTurnEntries,
+} from './transcript-reader.mjs';
 
 /**
  * バックフィル回収実績を ~/.throughline/logs/backfill.log に 1 行 JSON で記録する。
@@ -59,15 +66,10 @@ export function deriveTranscriptPath(projectPath, sessionId) {
  * @param {string} opts.originSessionId transcript を所有する origin session_id
  * @param {string|null|undefined} opts.transcriptPath
  * @param {number} opts.now timestamp 欠損時の fallback epoch ms
- * @param {number|null} [opts.beforeUserTurnNumber] 指定した時は、user 行の番号がこれより前の群だけを回収する。
- *   作業途中のターンがある時点（自動圧縮の直後。ADR 0032）で呼ぶ時に、その群を除くために使う。
- *   途中の断片を代表として保存すると、群レベル dedup で最終回答が二度と入らない。
  * @returns {{groups: number, insertedTurns: number, skippedExisting: number, lastTurnNumber: number|null, turnNumbers: number[]}}
  */
-export function backfillBodies(db, { targetSessionId, originSessionId, transcriptPath, now, beforeUserTurnNumber = null }) {
-  const groups = getLogicalTurnGroups(transcriptPath).filter(
-    (group) => beforeUserTurnNumber === null || group.user.turn_number < beforeUserTurnNumber,
-  );
+export function backfillBodies(db, { targetSessionId, originSessionId, transcriptPath, now }) {
+  const groups = getLogicalTurnGroups(transcriptPath);
   if (groups.length === 0) {
     return { groups: 0, insertedTurns: 0, skippedExisting: 0, lastTurnNumber: null, turnNumbers: [] };
   }
@@ -137,3 +139,75 @@ export function backfillBodies(db, { targetSessionId, originSessionId, transcrip
     turnNumbers: groups.map((group) => group.representative.index),
   };
 }
+
+/**
+ * 作業途中で止めたターンを bodies と details へ取り込む (ADR 0033)。
+ *
+ * hook で止めたターンでは Stop hook が走らない。止めた側（自動継続の worker）が、後継を立てる前に呼ぶ。
+ * Codex の自動継続が、止めたターンを取り込んでから記憶を作るのと同じ。
+ *
+ *   - 完了したターンは最後の本文（代表断片）だけを残すが、止めたターンには結論の発言が無い。
+ *     ここまでの発言を全部つないで assistant の本文にする。本文が1つも無ければ user の行だけを入れる。
+ *   - turn_number は最後の本文断片の index（無ければ user 行の index）。backfillBodies は断片の index が
+ *     bodies にある群を回収しないので、後継が前任を合流させる時に、代表断片の行が重ねて入らない。
+ *   - details は最後の user 本文の行から transcript の末尾まで。止めた道具の呼び出しも入る。
+ *     source_id の UNIQUE で、同じターンをもう一度取り込んでも増えない。
+ *
+ * @param {import('node:sqlite').DatabaseSync} db
+ * @param {object} opts
+ * @param {string} opts.targetSessionId 書き込み先 session_id（合流済みなら合流先）
+ * @param {string} opts.originSessionId transcript を持つ session_id
+ * @param {string|null|undefined} opts.transcriptPath
+ * @param {number} opts.now timestamp が無い時と details の created_at
+ * @returns {{turnNumber: number, userAt: number, assistantAt: number|null, insertedBodies: boolean, details: number}|null}
+ */
+export function captureInFlightTurn(db, { targetSessionId, originSessionId, transcriptPath, now }) {
+  const latest = readLatestUserGroup(transcriptPath);
+  if (!latest) return null;
+  const fragments = latest.fragments.filter((f) => !isJunkAssistantText(f.content));
+  const candidates = [latest.user.turn_number, ...latest.fragments.map((f) => f.index)];
+  const captured = db
+    .prepare(
+      `SELECT turn_number FROM bodies
+       WHERE origin_session_id = ? AND turn_number IN (${candidates.map(() => '?').join(',')})
+       ORDER BY turn_number DESC LIMIT 1`,
+    )
+    .get(originSessionId, ...candidates);
+  const turnNumber = captured?.turn_number ?? fragments.at(-1)?.index ?? latest.user.turn_number;
+  const userAt = latest.user.timestamp ?? now;
+  const assistantAt = fragments.length > 0 ? (fragments.at(-1).timestamp ?? now) : null;
+  const assistantText = fragments.map((f) => f.content.trim()).join('\n\n');
+  const detailBlocks = extractDetailBlocks(sliceInFlightTurnEntries(readRawEntries(transcriptPath)));
+
+  const insertBody = db.prepare(
+    `INSERT OR IGNORE INTO bodies
+       (session_id, origin_session_id, turn_number, role, text, token_count, created_at, turn_start)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+  );
+  const insertDetail = db.prepare(
+    `INSERT OR IGNORE INTO details
+       (session_id, origin_session_id, turn_number, tool_name, input_text, output_text,
+        token_count, created_at, kind, source_id)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+  );
+  db.exec('BEGIN');
+  try {
+    if (!captured) {
+      insertBody.run(targetSessionId, originSessionId, turnNumber, 'user', latest.user.content,
+        Math.round(latest.user.content.length / 4), userAt, latest.user.start);
+      if (assistantText) {
+        insertBody.run(targetSessionId, originSessionId, turnNumber, 'assistant', assistantText,
+          Math.round(assistantText.length / 4), assistantAt, null);
+      }
+    }
+    for (const d of detailBlocks) {
+      insertDetail.run(targetSessionId, originSessionId, turnNumber, d.tool_name, d.input_text, d.output_text,
+        Math.round(((d.input_text?.length ?? 0) + (d.output_text?.length ?? 0)) / 4), now, d.kind, d.source_id);
+    }
+    db.exec('COMMIT');
+  } catch (err) {
+    db.exec('ROLLBACK');
+    throw err;
+  }
+  return { turnNumber, userAt, assistantAt, insertedBodies: !captured, details: detailBlocks.length };
+}

package/src/turn-backfill.test.mjs

@@ -4,7 +4,7 @@ import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir, homedir } from 'node:os';
 import { join } from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
-import { backfillBodies, deriveTranscriptPath } from './turn-backfill.mjs';
+import { backfillBodies, captureInFlightTurn, deriveTranscriptPath } from './turn-backfill.mjs';
 
 function makeDb() {
   const db = new DatabaseSync(':memory:');
@@ -242,28 +242,6 @@ test('backfillBodies: user row keeps the turn start and assistant row leaves it
   );
 });
 
-test('backfillBodies: beforeUserTurnNumber は作業途中のターンを回収から外す', () => {
-  withData(
-    [
-      entry('user', 'done prompt', '2026-10-04T00:00:00Z'),
-      entry('assistant', 'done answer', '2026-10-04T00:00:01Z'),
-      entry('user', 'in-flight prompt', '2026-10-04T00:00:02Z'),
-      entry('assistant', 'interim remark', '2026-10-04T00:00:03Z'),
-    ],
-    (path) => {
-      const db = makeDb();
-      const partial = backfillBodies(db, { targetSessionId: 'S', originSessionId: 'S', transcriptPath: path, now: 1, beforeUserTurnNumber: 2 });
-      assert.equal(partial.insertedTurns, 1);
-      assert.deepEqual(partial.turnNumbers, [1]);
-      assert.deepEqual(db.prepare('SELECT text FROM bodies ORDER BY id').all().map((r) => r.text), ['done prompt', 'done answer']);
-      // Stop で改めて全体を回収すると、作業途中だったターンが最終回答つきで入る
-      const full = backfillBodies(db, { targetSessionId: 'S', originSessionId: 'S', transcriptPath: path, now: 1 });
-      assert.equal(full.insertedTurns, 1);
-      assert.equal(full.skippedExisting, 1);
-    },
-  );
-});
-
 test('backfillBodies: 圧縮の要約行を数えていた頃に保存したターンは、重複させずにそのまま残す', () => {
   const summary = { type: 'user', isCompactSummary: true, message: { role: 'user', content: 'This session is being continued' } };
   withData(
@@ -299,3 +277,77 @@ test('backfillBodies: 圧縮の要約行を数えていた頃に保存したタ
     },
   );
 });
+
+// --- 作業途中で止めたターンの取り込み (ADR 0033) ---
+
+function withDetails(db) {
+  db.exec(`
+    CREATE TABLE details (id INTEGER PRIMARY KEY AUTOINCREMENT, session_id TEXT NOT NULL, origin_session_id TEXT,
+      turn_number INTEGER, tool_name TEXT NOT NULL, input_text TEXT, output_text TEXT, token_count INTEGER NOT NULL DEFAULT 0,
+      created_at INTEGER NOT NULL, kind TEXT, source_id TEXT);
+    CREATE UNIQUE INDEX uq_details_source ON details(session_id, origin_session_id, source_id) WHERE source_id IS NOT NULL;
+  `);
+  return db;
+}
+
+const toolUse = (id, name, input) => ({ type: 'assistant', message: { role: 'assistant', content: [{ type: 'tool_use', id, name, input }] } });
+const toolResult = (id, content) => ({ type: 'user', message: { role: 'user', content: [{ type: 'tool_result', tool_use_id: id, content }] } });
+
+test('captureInFlightTurn: 止めたターンの発言を全部つないで本文にし、末尾の道具まで details に入れる。合流時の回収は重ねない', () => {
+  withData(
+    [
+      entry('user', '前の依頼', '2026-10-04T02:00:00Z'),
+      entry('assistant', '前の回答', '2026-10-04T02:00:05Z'),
+      entry('user', '3つ読んで', '2026-10-04T03:00:00Z'),
+      toolUse('t1', 'Read', { file_path: '/w/1' }),
+      toolResult('t1', 'one'),
+      entry('assistant', '1 を読みました。', '2026-10-04T03:00:02Z'),
+      toolUse('t2', 'Read', { file_path: '/w/2' }),
+      toolResult('t2', 'two'),
+      entry('assistant', '2 を読みました。', '2026-10-04T03:00:04Z'),
+      toolUse('t3', 'Read', { file_path: '/w/3' }),
+      toolResult('t3', 'PreToolUse:Read hook error'),
+    ],
+    (path) => {
+      const db = withDetails(makeDb());
+      const captured = captureInFlightTurn(db, { targetSessionId: 'S', originSessionId: 'S', transcriptPath: path, now: 9_000 });
+      assert.deepEqual(captured, { turnNumber: 4, userAt: Date.parse('2026-10-04T03:00:00Z'),
+        assistantAt: Date.parse('2026-10-04T03:00:04Z'), insertedBodies: true, details: 6 });
+      assert.deepEqual(db.prepare('SELECT turn_number, role, text, turn_start FROM bodies ORDER BY id').all().map((row) => ({ ...row })), [
+        { turn_number: 4, role: 'user', text: '3つ読んで', turn_start: 'unknown' },
+        { turn_number: 4, role: 'assistant', text: '1 を読みました。\n\n2 を読みました。', turn_start: null },
+      ]);
+      assert.deepEqual(db.prepare('SELECT source_id, turn_number FROM details ORDER BY id').all().map((row) => `${row.source_id}@${row.turn_number}`),
+        ['t1@4', 't1:result@4', 't2@4', 't2:result@4', 't3@4', 't3:result@4'], '最後の発言の後に呼んだ、止めた道具も入る');
+
+      // もう一度取り込んでも増えない
+      const again = captureInFlightTurn(db, { targetSessionId: 'S', originSessionId: 'S', transcriptPath: path, now: 9_500 });
+      assert.equal(again.turnNumber, 4);
+      assert.equal(again.insertedBodies, false);
+      assert.equal(db.prepare('SELECT COUNT(*) AS n FROM details').get().n, 6);
+
+      // 後継が前任を合流させる時の回収: 完了した前のターンだけを入れ、止めたターンへ代表断片を重ねない
+      const backfill = backfillBodies(db, { targetSessionId: 'S', originSessionId: 'S', transcriptPath: path, now: 9_900 });
+      assert.equal(backfill.insertedTurns, 1);
+      assert.equal(backfill.skippedExisting, 1);
+      assert.equal(db.prepare(`SELECT text FROM bodies WHERE turn_number = 4 AND role = 'assistant'`).get().text,
+        '1 を読みました。\n\n2 を読みました。');
+    },
+  );
+});
+
+test('captureInFlightTurn: 発言が1つも無いターンは、user の行と道具の入出力だけを入れる', () => {
+  withData(
+    [entry('user', '黙って読んで', '2026-10-04T03:00:00Z'), toolUse('t1', 'Read', { file_path: '/w/1' }), toolResult('t1', 'one'),
+      toolUse('t2', 'Read', { file_path: '/w/2' })],
+    (path) => {
+      const db = withDetails(makeDb());
+      const captured = captureInFlightTurn(db, { targetSessionId: 'S', originSessionId: 'S', transcriptPath: path, now: 9_000 });
+      assert.deepEqual(captured, { turnNumber: 0, userAt: Date.parse('2026-10-04T03:00:00Z'), assistantAt: null, insertedBodies: true, details: 3 });
+      assert.deepEqual(db.prepare('SELECT turn_number, role, text FROM bodies').all().map((row) => ({ ...row })),
+        [{ turn_number: 0, role: 'user', text: '黙って読んで' }]);
+      assert.equal(captureInFlightTurn(db, { targetSessionId: 'S', originSessionId: 'S', transcriptPath: join(path, 'none'), now: 1 }), null);
+    },
+  );
+});
+

package/src/turn-processor.mjs

@@ -49,6 +49,7 @@ import { recordRuntimeErrorBestEffort } from './runtime-error-store.mjs';
 import { logHookFailure } from './hook-failure-log.mjs';
 import { writeCompletedTurnReceipt } from './completed-turn-receipts.mjs';
 import { hostAdapterForSessionId, parseHookPayload } from './hosts/index.mjs';
+import { completeClaudeTurnWithoutHandoff } from './claude-auto-handoff.mjs';
 
 /** 直近 N ターンは bodies を生で残し、それより古いものだけ L1 要約する。 */
 export const L2_WINDOW = 20;
@@ -253,6 +254,9 @@ async function processStop() {
   if (!session_id) throw new Error('Missing session_id in Stop payload');
   failureContext = { session_id, transcript_path };
 
+  // 自動圧縮を止めた後、道具を呼ばずにターンが終わった。続ける作業が無いので、引き継ぎの記録を取り下げる (ADR 0033)。
+  completeClaudeTurnWithoutHandoff({ sessionId: session_id });
+
   // VSCode で開かれたプロジェクトに .vscode/tasks.json を自動プロビジョニングする。
   // 2 回目以降は冪等性チェックで即 return するので毎ターン走っても安全。
   // 失敗しても主処理は継続させるため try/catch でラップ。