throughline 0.12.9 → 0.14.0

package/src/resume-context.test.mjs

@@ -4,6 +4,7 @@ import { DatabaseSync } from 'node:sqlite';
 import {
   buildResumeContext,
   buildBudgetedResumeContext,
+  buildAutoContinuationContext,
   INJECTION_BUDGET_CHARS,
 } from './resume-context.mjs';
 
@@ -905,3 +906,63 @@ test('budgeted: header and anchor always survive even under pressure', () => {
   assert.match(budgeted.text, /^## Throughline: 直前スレッドの継続応答用コンテキスト/);
   assert.ok(budgeted.text.includes('### 現在地 (直前のやりとり)'));
 });
+
+// --- 自動継続で立てた新しい会話への注入 (ADR 0033) ---
+
+test('buildAutoContinuationContext: 保存済みのターンが無くても、止めた時点の依頼だけで組み立てる', () => {
+  const db = makeDb();
+  const result = buildAutoContinuationContext(db, {
+    sessionId: 'S',
+    inFlight: { user: { content: '最初の依頼', timestamp: null }, last_fragment: null },
+  });
+  assert.match(result.text, /^## Throughline: 自動継続の文脈\n/);
+  assert.match(result.text, /### 現在地 \(作業の途中で止めたターン\)\n\*\*作業中のユーザー依頼\*\*: 最初の依頼\n/);
+  assert.doesNotMatch(result.text, /止める直前のあなたの発言/);
+  assert.doesNotMatch(result.text, /### 直前の対話/);
+  assert.equal(result.injectedL2Turns, 0);
+  assert.equal(buildAutoContinuationContext(db, { sessionId: 'S', inFlight: null }), null);
+});
+
+test('buildAutoContinuationContext: 現在地は止めた時点のターンで、保存済みのターンはL2に並び、宣言は求めない', () => {
+  const db = makeDb();
+  insertBody(db, { session: 'S', origin: 'P', turn: 1, role: 'user', text: '前の依頼', createdAt: 1_000 });
+  insertBody(db, { session: 'S', origin: 'P', turn: 1, role: 'assistant', text: '前の回答', createdAt: 2_000 });
+  const result = buildAutoContinuationContext(db, {
+    sessionId: 'S',
+    inFlight: {
+      user: { content: '今の依頼', timestamp: 3_000 },
+      last_fragment: { content: '途中2', timestamp: 5_000 },
+    },
+  });
+  const anchor = result.text.slice(result.text.indexOf('### 現在地'), result.text.indexOf('### さらに前の記憶'));
+  assert.match(anchor, /\*\*作業中のユーザー依頼\*\* \[\d\d:\d\d:\d\d\]: 今の依頼\n\*\*止める直前のあなたの発言\*\* \[\d\d:\d\d:\d\d\]: 途中2\n/);
+  assert.doesNotMatch(anchor, /前の依頼/);
+  assert.match(result.text, /### 直前の対話 \(L2 \/ active work thread, 古い順\)\n\[\d\d:\d\d:\d\d\] \[user\]: 前の依頼\n\[\d\d:\d\d:\d\d\] \[assistant\]: 前の回答/);
+  assert.doesNotMatch(result.text, /宣言|\/clear|圧縮の要約/);
+  assert.match(result.text, /止める直前に呼ぼうとした道具は実行されていません/);
+  assert.equal(result.injectedL2Turns, 1);
+});
+
+test('buildAutoContinuationContext: 長い依頼は先頭と末尾を残し、多数のターンでも予算内に収める', () => {
+  const db = makeDb();
+  for (let turn = 1; turn <= 12; turn++) {
+    insertBody(db, { session: 'S', origin: 'P', turn, role: 'user', text: `依頼${turn} ` + 'あ'.repeat(600), createdAt: turn * 1_000 });
+    insertBody(db, { session: 'S', origin: 'P', turn, role: 'assistant', text: `回答${turn} ` + 'い'.repeat(600), createdAt: turn * 1_000 + 500 });
+  }
+  const result = buildAutoContinuationContext(db, {
+    sessionId: 'S',
+    inFlight: {
+      user: { content: '先頭の指示' + 'ヰ'.repeat(6_000) + '末尾の指示', timestamp: 20_000 },
+      last_fragment: { content: 'ヱ'.repeat(3_000), timestamp: 21_000 },
+    },
+  });
+  assert.ok(result.totalChars <= INJECTION_BUDGET_CHARS, `${result.totalChars}`);
+  assert.match(result.text, /\*\*作業中のユーザー依頼\*\* \[\d\d:\d\d:\d\d\]: 先頭の指示ヰ+ …\(長いため中略 2010 字\)… ヰ+末尾の指示\n/);
+  assert.equal((result.text.match(/ヰ/g) ?? []).length, 3_990);
+  assert.equal((result.text.match(/ヱ/g) ?? []).length, 1_500);
+  assert.match(result.text, /ヱ …\(長いため中略 1500 字\)… ヱ/);
+  assert.ok(result.injectedL2Turns >= 1, '最新の保存済みターンは入る');
+  assert.match(result.text, /回答12/);
+  assert.equal(result.injectedL2Turns + result.remainingL2Turns, 12);
+  assert.match(result.text, /throughline recall --l2 --session S /);
+});

package/src/runtime-error-store.mjs

@@ -47,6 +47,17 @@ const DEFINITIONS = Object.freeze({
     severity: 'high',
     template: 'Throughline Claude Stop hook processing failed',
   }),
+  // 自動継続の hook が失敗した。圧縮も道具も止まらず、作業は続く（ADR 0033）。
+  HOOK_PRE_COMPACT_FAILED: Object.freeze({
+    component: 'claude_pre_compact_hook',
+    severity: 'warn',
+    template: 'Throughline Claude PreCompact hook processing failed',
+  }),
+  HOOK_PRE_TOOL_USE_FAILED: Object.freeze({
+    component: 'claude_pre_tool_use_hook',
+    severity: 'warn',
+    template: 'Throughline Claude PreToolUse hook processing failed',
+  }),
   HOOK_CODEX_FAILED: Object.freeze({
     component: 'codex_hook',
     severity: 'high',

package/src/session-start.mjs

@@ -21,6 +21,12 @@
  *
  *   バトンの消費・merge・注入は最初の UserPromptSubmit (= 実体の証明) で行う。
  *   幽霊はプロンプトを発火しないため記憶を奪えない。
+ *
+ * 【自動継続の後継】 ADR 0033
+ *
+ *   同じ project で後継の立ち上げ中の引き継ぎがある時だけ、この会話の受け口（inbox socket）を
+ *   控える。worker がそれを読んで、継続の指示を1通送る。記憶の注入は、その指示が届いた時の
+ *   UserPromptSubmit（上の二相ハンドオフの第二相）が行う。
  */
 
 import { getDb } from './db.mjs';
@@ -33,8 +39,9 @@ import { existsSync } from 'node:fs';
 import { pathToFileURL } from 'node:url';
 import { recordRuntimeErrorBestEffort } from './runtime-error-store.mjs';
 import { logHookFailure } from './hook-failure-log.mjs';
-import { hostAdapterForSessionId, NON_CLAUDE_SESSION_PREFIXES, parseHookPayload } from './hosts/index.mjs';
+import { CLAUDE_HOST, hostAdapterForSessionId, hostOfSessionId, NON_CLAUDE_SESSION_PREFIXES, parseHookPayload } from './hosts/index.mjs';
 import { executeFirstPromptHandoff } from './handoff-executor.mjs';
+import { recordClaudeSuccessorTarget } from './claude-auto-handoff.mjs';
 
 const ENV_DISABLE_AUTO_HANDOFF = 'THROUGHLINE_DISABLE_AUTO_HANDOFF';
 
@@ -163,6 +170,11 @@ export async function run() {
     pending_registered: true,
   });
 
+  // 自動継続の後継として立ち上がった会話なら、worker が指示を送れるように受け口を控える (ADR 0033)。
+  if (hostOfSessionId(session_id) === CLAUDE_HOST) {
+    recordClaudeSuccessorTarget({ payload, env: process.env, now });
+  }
+
   // Cursor は beforeSubmitPrompt が additional_context を持たない。
   // 新規 composer 会話の sessionStart が公式の注入口なので、ここで第二相を実行する。
   // Claude の幽霊 SessionStart 問題はこの host では sessionStart = 会話作成のため適用しない。

package/src/transcript-reader.mjs

@@ -10,7 +10,7 @@
 
 import { readFileSync, existsSync } from 'fs';
 import { DETAIL_KIND } from './constants.mjs';
-import { compactClaudeTaskNotification } from './hosts/claude.mjs';
+import { compactClaudePeerMessage, compactClaudeTaskNotification } from './hosts/claude.mjs';
 import { classifyTurnStart } from './turn-start.mjs';
 
 function entryKind(entry) {
@@ -25,6 +25,15 @@ function entryKind(entry) {
  * @param {unknown} content
  * @returns {string}
  */
+/**
+ * Claude Code が圧縮の直後に書く要約行か。type は user だが、人の発言ではない
+ * （`isCompactSummary: true`。ADR 0032）。ターンの始まりにも本文にもしない。
+ * @param {object} entry
+ */
+export function isCompactSummaryEntry(entry) {
+  return entry?.isCompactSummary === true;
+}
+
 function extractText(content) {
   if (typeof content === 'string') return content;
   if (Array.isArray(content)) {
@@ -48,6 +57,9 @@ export function readTranscript(transcriptPath) {
   const raw = readFileSync(transcriptPath, 'utf8');
 
   const turns = [];
+  // turn_number は transcript 内の本文行の通し番号。圧縮の要約行は返さないが番号は進める。
+  // 番号を詰めると、要約行を数えていた頃に保存した bodies の turn_number と食い違う。
+  let position = 0;
   for (const line of raw.split('\n')) {
     const trimmed = line.trim();
     if (!trimmed) continue;
@@ -74,21 +86,31 @@ export function readTranscript(transcriptPath) {
     if (!role || rawContent == null) continue;
 
     const extracted = extractText(rawContent);
-    // user 発言には端末の生出力 (貼り付け・Claude の task 通知) が入る。記憶には
-    // 制御文字を落とした本文だけを残す。
+    // user 発言には端末の生出力 (貼り付け・Claude の task 通知) や、別の会話から届いた発言の
+    // 定型の注意書きが入る。記憶には制御文字と定型文を落とした本文だけを残す。
     const text = role === 'user'
-      ? normalizeTerminalText(compactClaudeTaskNotification(extracted))
+      ? normalizeTerminalText(compactClaudePeerMessage(compactClaudeTaskNotification(extracted)))
       : extracted;
     if (!text) continue;
 
+    const turnNumber = position++;
+    // 圧縮の要約は host が書いた行。ターンは圧縮をまたいで続くので、ここで区切らない。
+    if (isCompactSummaryEntry(entry)) continue;
+
     const ts = typeof entry.timestamp === 'string' ? Date.parse(entry.timestamp) : NaN;
     // grok chat_history.jsonl は Claude の message 包みを持たず type/content 直置き。
     turns.push({
       role,
       content: text,
-      turn_number: turns.length,
+      turn_number: turnNumber,
       timestamp: Number.isNaN(ts) ? null : ts,
-      ...(role === 'user' ? { start: classifyTurnStart(entry, extracted) } : {}),
+      ...(role === 'user'
+        ? {
+            start: classifyTurnStart(entry, extracted),
+            // Claude Code が user 行に付ける prompt の id。hook payload の prompt_id と同じ値。
+            prompt_id: typeof entry.promptId === 'string' ? entry.promptId : null,
+          }
+        : {}),
     });
   }
 
@@ -160,6 +182,38 @@ export function getLogicalTurnGroups(transcriptPath) {
   return groups;
 }
 
+/**
+ * 最後の user 発言と、それに続く assistant 本文の断片を返す。
+ *
+ * getLogicalTurnGroups は完了したターンの回収用で、本文の断片が無い群を返さない。
+ * こちらは作業途中のターン（Stop 前。本文がまだ無いこともある）を読むために使う。
+ *
+ * @param {string} transcriptPath
+ * @returns {{
+ *   user: {content: string, timestamp: number|null, turn_number: number, start: 'prompt'|'self'|'unknown', prompt_id: string|null},
+ *   fragments: Array<{index: number, content: string, timestamp: number|null}>,
+ * }|null}
+ */
+export function readLatestUserGroup(transcriptPath) {
+  const turns = readTranscript(transcriptPath);
+  let userIndex = -1;
+  for (let index = turns.length - 1; index >= 0; index--) {
+    if (turns[index].role === 'user') {
+      userIndex = index;
+      break;
+    }
+  }
+  if (userIndex < 0) return null;
+  const { content, timestamp, turn_number, start, prompt_id } = turns[userIndex];
+  return {
+    user: { content, timestamp, turn_number, start, prompt_id },
+    fragments: turns
+      .slice(userIndex + 1)
+      .filter((turn) => turn.role === 'assistant')
+      .map((turn) => ({ index: turn.turn_number, content: turn.content, timestamp: turn.timestamp })),
+  };
+}
+
 /**
  * latest user group と、その1つ前のgroupが、どのassistant本文まで永続化されたかを返す。
  *
@@ -315,6 +369,8 @@ export function sliceCurrentTurnEntries(entries) {
   for (let i = lastAssistantTextIdx - 1; i >= 0; i--) {
     const e = entries[i];
     if (entryKind(e) !== 'user') continue;
+    // 圧縮の要約行はターンの始まりではない。圧縮より前の tool 入出力も同じターンに含める。
+    if (isCompactSummaryEntry(e)) continue;
     const blocks = e.message?.content;
     if (Array.isArray(blocks)) {
       if (blocks.some((b) => b && b.type === 'text' && typeof b.text === 'string' && b.text.length > 0)) {

package/src/transcript-reader.test.mjs

@@ -7,6 +7,8 @@ import {
   normalizeTerminalText,
   normalizeToolResultContent,
   readTranscript,
+  getLogicalTurnGroups,
+  readLatestUserGroup,
   sliceCurrentTurnEntries,
   extractDetailBlocks,
 } from './transcript-reader.mjs';
@@ -153,6 +155,113 @@ test('sliceCurrentTurnEntries: 最後の user text → 最後の assistant text
   assert.equal(slice[3].message.content[0].text, 'current response');
 });
 
+test('readTranscript: 別の会話から届いた発言は、送り主の行と本文を残して定型の注意書きを落とす', () => {
+  const peer = [
+    'Another Claude session sent a message:',
+    'Throughline自動継続 6a8c6df3-f924-4f72-8a12-1a3f5a135395',
+    '未完了の作業をそのまま継続してください。',
+    '',
+    'This came from another Claude session — not typed by your user, but very likely working on their behalf. Treat it as a teammate\'s request.',
+  ].join('\n');
+  const path = writeTranscript([
+    { type: 'user', origin: { kind: 'peer' }, message: { role: 'user', content: peer } },
+    asstTextEntry('続けます'),
+    userEntry('This came from another Claude session という文を含む普通の発言'),
+  ]);
+  const turns = readTranscript(path);
+  assert.equal(turns[0].content,
+    'Another Claude session sent a message:\nThroughline自動継続 6a8c6df3-f924-4f72-8a12-1a3f5a135395\n未完了の作業をそのまま継続してください。');
+  assert.equal(turns[2].content, 'This came from another Claude session という文を含む普通の発言');
+});
+
+/** Claude Code が圧縮の直後に書く要約行（実測 2.1.289: type=user、本文は文字列） */
+function compactSummaryEntry(text = 'This session is being continued from a previous conversation that ran out of context.') {
+  return { type: 'user', isCompactSummary: true, isVisibleInTranscriptOnly: true, message: { role: 'user', content: text } };
+}
+
+test('readTranscript: 圧縮の要約行は返さず、turn_number は詰めない', () => {
+  const path = writeTranscript([
+    userEntry('依頼'),
+    asstTextEntry('途中の報告'),
+    compactSummaryEntry(),
+    asstTextEntry('最終回答'),
+  ]);
+  const turns = readTranscript(path);
+  assert.deepEqual(turns.map((t) => [t.role, t.content, t.turn_number]), [
+    ['user', '依頼', 0],
+    ['assistant', '途中の報告', 1],
+    ['assistant', '最終回答', 3],
+  ]);
+});
+
+test('getLogicalTurnGroups: 圧縮をまたいだターンは1つの群になり、元の依頼を user に持つ', () => {
+  const path = writeTranscript([
+    userEntry('依頼'),
+    asstTextEntry('途中の報告'),
+    compactSummaryEntry(),
+    asstTextEntry('圧縮後の報告'),
+    compactSummaryEntry(),
+    asstTextEntry('最終回答'),
+    userEntry('次の依頼'),
+    asstTextEntry('次の回答'),
+  ]);
+  const groups = getLogicalTurnGroups(path);
+  assert.equal(groups.length, 2);
+  assert.equal(groups[0].user.content, '依頼');
+  assert.deepEqual(groups[0].fragments.map((f) => f.index), [1, 3, 5]);
+  assert.equal(groups[0].representative.content, '最終回答');
+  assert.equal(groups[1].user.content, '次の依頼');
+  assert.equal(groups[1].representative.index, 7);
+});
+
+test('readLatestUserGroup: 作業途中のターンを、本文がまだ無くても返す', () => {
+  const noAnswer = writeTranscript([
+    userEntry('前の依頼'),
+    asstTextEntry('前の回答'),
+    userEntry('今の依頼'),
+    asstToolUseEntry('toolu_1', 'Read', { file_path: '/a' }),
+    userToolResultEntry('toolu_1', 'contents'),
+    compactSummaryEntry(),
+  ]);
+  assert.deepEqual(readLatestUserGroup(noAnswer), {
+    user: { content: '今の依頼', timestamp: null, turn_number: 2, start: 'unknown', prompt_id: null },
+    fragments: [],
+  });
+  const withAnswer = writeTranscript([
+    userEntry('今の依頼'),
+    asstTextEntry('途中1'),
+    compactSummaryEntry(),
+    asstTextEntry('途中2'),
+  ]);
+  const latest = readLatestUserGroup(withAnswer);
+  assert.equal(latest.user.content, '今の依頼');
+  assert.deepEqual(latest.fragments.map((f) => [f.index, f.content]), [[1, '途中1'], [3, '途中2']]);
+  assert.equal(readLatestUserGroup(writeTranscript([asstTextEntry('user 行が無い')])), null);
+  const withPromptId = writeTranscript([{ ...userEntry('依頼'), promptId: 'prompt-1' }]);
+  assert.equal(readLatestUserGroup(withPromptId).user.prompt_id, 'prompt-1');
+});
+
+test('sliceCurrentTurnEntries: 圧縮の要約行で区切らず、圧縮より前の tool も同じターンに含める', () => {
+  const entries = [
+    userEntry('old prompt'),
+    asstTextEntry('old response'),
+    userEntry('current prompt'),
+    asstToolUseEntry('toolu_1', 'Read', { file_path: '/a' }),
+    userToolResultEntry('toolu_1', 'before compaction'),
+    { type: 'system', subtype: 'compact_boundary', compactMetadata: { trigger: 'auto' } },
+    compactSummaryEntry(),
+    asstToolUseEntry('toolu_2', 'Write', { file_path: '/b' }),
+    userToolResultEntry('toolu_2', 'after compaction'),
+    asstTextEntry('current response'),
+  ];
+  const slice = sliceCurrentTurnEntries(entries);
+  assert.equal(slice[0].message.content[0].text, 'current prompt');
+  assert.deepEqual(
+    extractDetailBlocks(slice).filter((d) => d.kind === DETAIL_KIND.TOOL_INPUT).map((d) => d.tool_name),
+    ['Read', 'Write'],
+  );
+});
+
 test('sliceCurrentTurnEntries: 空配列なら空を返す', () => {
   assert.deepEqual(sliceCurrentTurnEntries([]), []);
 });

package/src/turn-backfill.test.mjs

@@ -241,3 +241,39 @@ test('backfillBodies: user row keeps the turn start and assistant row leaves it
     },
   );
 });
+
+test('backfillBodies: 圧縮の要約行を数えていた頃に保存したターンは、重複させずにそのまま残す', () => {
+  const summary = { type: 'user', isCompactSummary: true, message: { role: 'user', content: 'This session is being continued' } };
+  withData(
+    [
+      entry('user', 'prompt', '2026-10-04T00:00:00Z'),
+      entry('assistant', 'before compaction', '2026-10-04T00:00:01Z'),
+      summary,
+      entry('assistant', 'after compaction', '2026-10-04T00:00:03Z'),
+      entry('user', 'next prompt', '2026-10-04T00:00:04Z'),
+      entry('assistant', 'next answer', '2026-10-04T00:00:05Z'),
+    ],
+    (path) => {
+      const db = makeDb();
+      // 旧版は要約行を user 発言として、圧縮後の断片 (index 3) と組で保存していた
+      const insert = db.prepare(
+        `INSERT INTO bodies (session_id, origin_session_id, turn_number, role, text, token_count, created_at)
+         VALUES ('S', 'S', 3, ?, ?, 1, 1)`,
+      );
+      insert.run('user', 'This session is being continued');
+      insert.run('assistant', 'after compaction');
+      const result = backfillBodies(db, { targetSessionId: 'S', originSessionId: 'S', transcriptPath: path, now: 1 });
+      assert.equal(result.skippedExisting, 1, '同じ断片を持つ群は入れ直さない');
+      assert.equal(result.insertedTurns, 1);
+      assert.deepEqual(
+        db.prepare('SELECT turn_number, role, text FROM bodies ORDER BY turn_number, role DESC').all().map((r) => [r.turn_number, r.role, r.text]),
+        [
+          [3, 'user', 'This session is being continued'],
+          [3, 'assistant', 'after compaction'],
+          [5, 'user', 'next prompt'],
+          [5, 'assistant', 'next answer'],
+        ],
+      );
+    },
+  );
+});

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 でラップ。