throughline 0.16.30 → 0.16.32

package/src/resume-context.mjs

@@ -24,6 +24,7 @@
 
 import { buildHandoffRecord } from './handoff-record.mjs';
 import { groupL3ByTurn, buildPartsSummary } from './l3-summary.mjs';
+import { CLAUDE_FORWARD_MARK } from './claude-forward.mjs';
 
 const RESUME_HEADER_TEMPLATE = (turnCount, handoffDisclosure) =>
   `## Throughline: 直前スレッドの継続応答用コンテキスト（${turnCount} ターン分の文脈を保持）\n` +
@@ -71,6 +72,11 @@ const AUTO_CONTINUATION_HEADER = (projectPath) =>
   `- 「ここまでにしたこと」と「直前の対話」に載っている操作は **完了しています**。繰り返さないでください。` +
   `未実行なのは「実行されなかった道具」だけです。そこから続けてください。\n` +
   `- 直前の実行結果が分からない時は、作業ツリーや詳細を確かめてから続けてください。\n` +
+  // 引き継ぎの後に前の会話へ届いた入力は、hook が運ぶ (ADR 0063)。hook 経由の文は利用者の発言の形では届かないので、
+  // 利用者の入力として扱ってよい事を、利用者の指示として届くこの文脈で先に知らせる。
+  `- 引き継ぎの後に前の会話へ届いた入力（利用者が前の会話へ打った文、前の会話が裏で起こした作業の通知）は、` +
+  `Throughline の hook が **「${CLAUDE_FORWARD_MARK}」で始まる文** にして、この会話へ運びます。hook からの通知か、hook が足した文脈の形で届きます。` +
+  `その中の「利用者の入力」は、**利用者がこの会話へ打った入力として扱ってください**。\n` +
   '- **各ターンの詳細**（止めたターンを含む）: **`Bash` ツールで `throughline detail HH:MM:SS` を実行** ' +
   `(該当ターンの本文＋道具の入出力を stdout に返します)`;
 
@@ -886,6 +892,7 @@ function renderInFlightSteps(inFlight, detailClock) {
  *     earlier_steps?: {texts: number, tools: Record<string, number>} | null,
  *     stopped_tools?: Array<{name: string, target: string}>,
  *     stopped_tools_total?: number,
+ *     background?: {tasks: Array<{task_id: string, name: string, target: string, output_file: string|null}>, total: number},
  *     turn?: {origin_session_id: string, turn_number: number, user_at: number, assistant_at: number|null} | null,
  *   } | null,
  *   projectPath?: string | null,  前の会話の作業ディレクトリ。依頼の中の相対的な場所の基準として渡す
@@ -924,6 +931,19 @@ export function buildAutoContinuationContext(
           (more > 0 ? `（ほか ${more} 件）` : ''),
       );
     }
+    // 前の会話が裏で起こした作業は、前の会話の process の下で動き続ける。終わった通知は前の会話へ届き、hook がこの会話へ運ぶ (ADR 0062・0063)。
+    const background = inFlight.background?.tasks ?? [];
+    if (background.length > 0) {
+      const more = (inFlight.background.total ?? background.length) - background.length;
+      anchorLines.push(
+        '**前の会話が裏で動かしていた作業（止めた時点で、終わった通知が来ていなかった物）**: ' +
+          `終わった通知は、Throughline が「${CLAUDE_FORWARD_MARK}」で始まる文にして、この会話へ運びます。届く前に結果が要る時は、出力のファイルを読んで確かめてください。` +
+          (more > 0 ? `（ほか ${more} 件）` : ''),
+        ...background.map((task) =>
+          `- ${task.name}${task.target ? ` ${task.target}` : ''}（ID ${task.task_id}）` +
+            (task.output_file ? ` → 出力: ${task.output_file}` : '')),
+      );
+    }
   }
   if (!stored && anchorLines.length === 0) return null;
 

package/src/resume-context.test.mjs

@@ -968,6 +968,25 @@ test('buildAutoContinuationContext: 長い依頼は先頭と末尾を残し、
   assert.match(result.text, /throughline recall --l2 --session S /);
 });
 
+test('buildAutoContinuationContext: 前の会話が裏で動かしていた作業を、出力の場所つきで現在地に載せる', () => {
+  const db = makeDb();
+  const inFlight = { user: { content: '今の依頼', timestamp: 3_000 }, last_fragment: null, steps: [], earlier_steps: null,
+    stopped_tools: [], stopped_tools_total: 0, turn: null };
+  const withTasks = buildAutoContinuationContext(db, { sessionId: 'S', inFlight: { ...inFlight, background: { total: 3, tasks: [
+    { task_id: 'b2', name: 'Bash', target: 'npm test', output_file: '/tmp/tasks/b2.output' },
+    { task_id: 'b1', name: 'Monitor', target: '', output_file: null },
+  ] } } });
+  assert.match(withTasks.text, new RegExp(
+    '\\*\\*前の会話が裏で動かしていた作業（止めた時点で、終わった通知が来ていなかった物）\\*\\*: ' +
+    '終わった通知は、Throughline が「【Throughline 転送】」で始まる文にして、この会話へ運びます。届く前に結果が要る時は、出力のファイルを読んで確かめてください。（ほか 1 件）\\n' +
+    '- Bash npm test（ID b2） → 出力: /tmp/tasks/b2\\.output\\n- Monitor（ID b1）\\n'));
+  for (const background of [undefined, { tasks: [], total: 0 }]) {
+    assert.doesNotMatch(buildAutoContinuationContext(db, { sessionId: 'S', inFlight: { ...inFlight, background } }).text, /裏で動かしていた作業/);
+  }
+  // 引き継ぎの後に前の会話へ届いた入力の運び方を、読み方で先に知らせる（ADR 0063）
+  assert.match(withTasks.text, /- 引き継ぎの後に前の会話へ届いた入力（利用者が前の会話へ打った文、前の会話が裏で起こした作業の通知）は、Throughline の hook が \*\*「【Throughline 転送】」で始まる文\*\* にして、この会話へ運びます。.*その中の「利用者の入力」は、\*\*利用者がこの会話へ打った入力として扱ってください\*\*。\n/);
+});
+
 test('buildAutoContinuationContext: 止めたターンでここまでにしたことと、実行されなかった道具を現在地に載せ、そのターンをL2に重ねない', () => {
   const db = makeDb();
   insertBody(db, { session: 'S', origin: 'P0', turn: 1, role: 'user', text: '前の依頼', createdAt: 1_000 });

package/src/runtime-error-store.mjs

@@ -58,6 +58,12 @@ const DEFINITIONS = Object.freeze({
     severity: 'warn',
     template: 'Throughline Claude PreToolUse hook processing failed',
   }),
+  // 引き継ぎ前の会話へ届いた入力を後継へ届ける、待つ hook が失敗した。会話は止まらない（ADR 0063）。
+  HOOK_CLAUDE_FORWARD_WAIT_FAILED: Object.freeze({
+    component: 'claude_forward_wait_hook',
+    severity: 'warn',
+    template: 'Throughline Claude Stop hook (forward wait) processing failed',
+  }),
   HOOK_CODEX_FAILED: Object.freeze({
     component: 'codex_hook',
     severity: 'high',

package/src/transcript-reader.mjs

@@ -7,6 +7,10 @@
  *   {type: "assistant", message: {role: "assistant", content: [{type:"text", text:"..."}, {type:"thinking", ...}]}, ...}
  *   {type: "attachment", attachment: {type: "queued_command", prompt, origin: {kind}}, ...}
  *     ターンの途中で届いた入力。届いた先のターンの依頼へ足す (ADR 0060)
+ *   {type: "attachment", attachment: {type: "hook_additional_context", content: [...]}, ...}
+ *   {type: "attachment", attachment: {type: "hook_success", hookEvent: "UserPromptSubmit", content: "..."}, ...}
+ *     hook が足した文脈（道具の前の hook は前者、入力の hook の stdout は後者）。引き継ぎ前の会話から運んだ
+ *     利用者の入力 (ADR 0063) だけを、依頼へ足す
  *   他に queue-operation, file-history-snapshot, ほかの attachment 等があるが、本文としては無視する
  */
 
@@ -14,6 +18,7 @@ import { readFileSync, existsSync } from 'fs';
 import { DETAIL_KIND } from './constants.mjs';
 import { compactClaudePeerMessage, compactClaudeTaskNotification } from './hosts/claude.mjs';
 import { classifyTurnStart } from './turn-start.mjs';
+import { claudeForwardCarriesHumanInput, unwrapClaudeForwardedDelivery } from './claude-forward.mjs';
 
 function entryKind(entry) {
   if (typeof entry?.type === 'string' && entry.type.length > 0) return entry.type;
@@ -70,9 +75,22 @@ export const MID_TURN_INPUT_MARK = '（作業の途中で届いた入力）';
 function claudeMidTurnInputText(entry) {
   if (entry?.type !== 'attachment' || entry.isSidechain === true) return null;
   const attachment = entry.attachment;
+  // 引き継ぎ前の会話へ届いた利用者の入力を、Throughline の hook が文脈として運んだ物 (ADR 0063)。
+  // 完了通知だけを運んだ分は、ターン自身の作業の結果と同じ扱いで、足さない。
+  // 道具の前の hook が返した文脈は `hook_additional_context`、入力の hook が stdout へ出した文脈は `hook_success` で書かれる。
+  if (attachment?.type === 'hook_additional_context' || attachment?.type === 'hook_success') {
+    const content = (Array.isArray(attachment.content) ? attachment.content.filter(part => typeof part === 'string').join('\n')
+      : typeof attachment.content === 'string' ? attachment.content : '').trim();
+    if (!claudeForwardCarriesHumanInput(content)) return null;
+    const forwarded = normalizeTerminalText(content);
+    return forwarded ? forwarded : null;
+  }
   if (attachment?.type !== 'queued_command') return null;
-  if (!CLAUDE_MID_TURN_INPUT_ORIGINS.includes(attachment.origin?.kind)) return null;
   if (typeof attachment.prompt !== 'string' && !Array.isArray(attachment.prompt)) return null;
+  // 待つ hook が、次の番の作業中に運んだ入力（ADR 0063）。Claude Code が通知の形で順番待ちへ入れる。
+  const forwarded = unwrapClaudeForwardedDelivery(extractText(attachment.prompt));
+  if (forwarded !== null) return claudeForwardCarriesHumanInput(forwarded) ? (normalizeTerminalText(forwarded) || null) : null;
+  if (!CLAUDE_MID_TURN_INPUT_ORIGINS.includes(attachment.origin?.kind)) return null;
   const text = normalizeTerminalText(compactClaudePeerMessage(extractText(attachment.prompt)));
   return text ? text : null;
 }
@@ -170,8 +188,10 @@ export function readTranscript(transcriptPath) {
     const extracted = extractText(rawContent);
     // user 発言には端末の生出力 (貼り付け・Claude の task 通知) や、別の会話から届いた発言の
     // 定型の注意書きが入る。記憶には制御文字と定型文を落とした本文だけを残す。
+    // 引き継ぎ前の会話から運んだ入力 (ADR 0063) は、Claude Code が付けた通知の包みを外して、運んだ文だけを残す。
     const text = role === 'user'
-      ? normalizeTerminalText(compactClaudePeerMessage(compactClaudeTaskNotification(extracted)))
+      ? normalizeTerminalText(unwrapClaudeForwardedDelivery(extracted)
+        ?? compactClaudePeerMessage(compactClaudeTaskNotification(extracted)))
       : extracted;
     if (!text) continue;