throughline 0.4.11 → 0.5.0

package/src/resume-context.test.mjs

@@ -93,7 +93,9 @@ test('buildResumeContext: header is terse and announces the Bash invocation cont
   });
 
   assert.ok(text);
-  assert.match(text, /^## Throughline: 中断した作業の再開/);
+  // A 経路: 「直前スレッドの継続応答用コンテキスト」 framing (元の「中断した作業の再開」よりも
+  // 強い directive。モデルが /clear 後の短い prompt を新規依頼として扱うのを抑止する目的)
+  assert.match(text, /^## Throughline: 直前スレッドの継続応答用コンテキスト/);
 
   // 旧版の冗長な行は全部削除
   assert.ok(!text.includes('と報告してください'), 'meta-report instruction must be gone');
@@ -101,11 +103,152 @@ test('buildResumeContext: header is terse and announces the Bash invocation cont
   assert.ok(!text.includes('内訳の読み方'), 'glossary block must be gone');
   assert.ok(!text.includes('現在進行中の作業の active work context'), 'verbose framing must be gone');
 
-  // 残るのは 2 行: 自然な続き + Bash 呼び出し方法
-  assert.match(text, /直前の対話の自然な続きとして応答してください/);
+  // A 経路の必須シグナル: 「あなた自身が直前にユーザーと交わした会話」 + 「新規依頼ではなく続き」
+  // + 短い指示の扱い + 「新規会話ではない」明示
+  assert.match(text, /あなた自身が直前にユーザーと交わした会話/);
+  assert.match(text, /新規依頼ではなく、上記スレッドの \*\*続き\*\*/);
+  assert.match(text, /続きよろしく.*OK.*次は？/s);
+  assert.match(text, /新規会話ではない/);
+  // β 経路 (early-style explicit report-back instruction): モデルが冒頭で
+  // 「引き継いだ状態で続けます」と明示的に表明することで、user が体感する継続感を強める
+  assert.match(text, /応答の冒頭で必ず以下を 1 行宣言/);
+  assert.match(text, /Throughline で前のセッションから .* ターン分の記憶を引き継いだ状態で続けます/);
   assert.match(
     text,
-    /\*\*各ターンの詳細の取得方法\*\*: \*\*`Bash` ツールで `throughline detail HH:MM:SS` を実行\*\* \(該当ターンの本文＋詳細を stdout に返します\)/,
+    /\*\*各ターンの詳細\*\*: \*\*`Bash` ツールで `throughline detail HH:MM:SS` を実行\*\* \(該当ターンの本文＋詳細を stdout に返します\)/,
+  );
+
+  // v2.1: 古い番号リスト (1/2/3) を最新ユーザーが「2 をやれ」のように参照しても、
+  // 直前アシスタントで既に実行済みなら再実行ではなく結果確認に回るというガード。
+  // (このセッションで実際にハマった misread の再発防止)
+  assert.match(text, /古い番号リストの再実行禁止/);
+  assert.match(text, /既に直前アシスタントターンで実装\/実行済み/);
+  assert.match(text, /最新アシスタント発話の指示が、過去ターンのリストへの参照より上位/);
+});
+
+test('buildResumeContext: 現在地 anchor surfaces the latest user/assistant exchange above L1/L2', () => {
+  const db = makeDb();
+  // 25 turns to exercise an L2 window edge and ensure the anchor picks the newest.
+  for (let t = 1; t <= 25; t += 1) {
+    insertBody(db, {
+      session: 'new',
+      origin: 'old',
+      turn: t,
+      role: 'user',
+      text: `user turn ${t}`,
+      createdAt: 1000 + t * 10,
+    });
+    insertBody(db, {
+      session: 'new',
+      origin: 'old',
+      turn: t,
+      role: 'assistant',
+      text: `assistant turn ${t}`,
+      createdAt: 1000 + t * 10 + 1,
+    });
+  }
+
+  const text = buildResumeContext(db, {
+    sessionId: 'new',
+    isInheritance: true,
+  });
+
+  assert.ok(text);
+
+  const anchorIdx = text.indexOf('### 現在地 (直前のやりとり)');
+  const l2Idx = text.indexOf('### 直前の対話 (L2 / active work thread, 古い順)');
+  assert.ok(anchorIdx > 0, '現在地 anchor section should be present');
+  assert.ok(l2Idx > anchorIdx, '現在地 anchor must appear before the L2 section');
+
+  // The anchor must point to turn 25 (the latest), not any earlier turn.
+  assert.match(text, /\*\*最新ユーザー指示\*\* \[\d\d:\d\d:\d\d\]: user turn 25$/m);
+  assert.match(text, /\*\*直前のアシスタント\*\* \[\d\d:\d\d:\d\d\]: assistant turn 25$/m);
+});
+
+test('buildResumeContext: 現在地 anchor truncates long bodies but full body still appears in L2', () => {
+  const db = makeDb();
+  const longText = 'a'.repeat(1200);
+  insertBody(db, {
+    session: 'new',
+    origin: 'old',
+    turn: 1,
+    role: 'assistant',
+    text: longText,
+    createdAt: 1000,
+  });
+
+  const text = buildResumeContext(db, {
+    sessionId: 'new',
+    isInheritance: true,
+  });
+
+  assert.ok(text);
+
+  const anchorLine = text
+    .split('\n')
+    .find((l) => l.startsWith('**直前のアシスタント**'));
+  assert.ok(anchorLine, '直前のアシスタント anchor line should be present');
+  // Anchor must be truncated with ellipsis (originally 1200 chars > 600 cap).
+  assert.ok(anchorLine.endsWith(' …'), 'long anchor body must end with the ellipsis marker');
+  assert.ok(
+    anchorLine.length < longText.length,
+    'anchor line should be shorter than the original body',
+  );
+
+  // Full body must still appear in the L2 section below.
+  assert.match(text, new RegExp(`\\[assistant\\]: ${longText}`));
+});
+
+test('buildResumeContext: 現在地 anchor is omitted for non-inheritance sessions', () => {
+  const db = makeDb();
+  insertBody(db, {
+    session: 'new',
+    origin: 'old',
+    turn: 1,
+    role: 'assistant',
+    text: 'a body',
+    createdAt: 1000,
+  });
+
+  const text = buildResumeContext(db, {
+    sessionId: 'new',
+    isInheritance: false,
+  });
+
+  assert.ok(text);
+  assert.ok(
+    !text.includes('現在地'),
+    'normal sessions (isInheritance=false) must not include the 現在地 anchor',
+  );
+  assert.ok(
+    !text.includes('最新ユーザー指示'),
+    'normal sessions must not surface a latest-user pointer',
+  );
+});
+
+test('buildResumeContext: 現在地 anchor handles a single-role recent window', () => {
+  const db = makeDb();
+  // Only user rows (no assistant) — anchor should still render with just the user line.
+  insertBody(db, {
+    session: 'new',
+    origin: 'old',
+    turn: 1,
+    role: 'user',
+    text: 'lone user message',
+    createdAt: 1000,
+  });
+
+  const text = buildResumeContext(db, {
+    sessionId: 'new',
+    isInheritance: true,
+  });
+
+  assert.ok(text);
+  assert.ok(text.includes('### 現在地 (直前のやりとり)'));
+  assert.match(text, /\*\*最新ユーザー指示\*\* \[\d\d:\d\d:\d\d\]: lone user message/);
+  assert.ok(
+    !text.includes('**直前のアシスタント**'),
+    'no assistant body present → no 直前のアシスタント line',
   );
 });
 
@@ -239,9 +382,11 @@ test('buildResumeContext: L2 entries get inline (詳細：…) suffixes with too
 
   assert.ok(text);
 
+  // Look for the L2 body line specifically (not the 現在地 anchor line which also
+  // contains the latest assistant body).
   const turnWithToolsLine = text
     .split('\n')
-    .find((l) => l.includes('turn with tools'));
+    .find((l) => /^\[\d\d:\d\d:\d\d\] \[assistant\]: turn with tools/.test(l));
   assert.ok(turnWithToolsLine, 'L2 line for turn 5 should exist');
   // - tool_input + tool_output は tool 名で集約 (Bash ×2)
   // - hook 出力 (system) は suffix から除外
@@ -265,7 +410,9 @@ test('buildResumeContext: L2 entries get inline (詳細：…) suffixes with too
     'per-line should not repeat the throughline detail command (the header announces it)',
   );
 
-  const plainLine = text.split('\n').find((l) => l.includes('plain user message'));
+  const plainLine = text
+    .split('\n')
+    .find((l) => /^\[\d\d:\d\d:\d\d\] \[user\]: plain user message/.test(l));
   assert.ok(plainLine, 'L2 line for turn 6 should exist');
   assert.ok(
     !plainLine.includes('詳細：'),
@@ -341,9 +488,14 @@ test('buildResumeContext: (詳細：…) suffix appears only on the last role ro
 
   assert.ok(text);
 
-  const userTurn5 = text.split('\n').find((l) => l.includes('user side of turn 5'));
-  const assistantTurn5 = text.split('\n').find((l) => l.includes('assistant side of turn 5'));
-  const userTurn6 = text.split('\n').find((l) => l.includes('lone user turn'));
+  // Match L2 body lines specifically (`[HH:MM:SS] [role]: ...`) to avoid colliding
+  // with the 現在地 anchor lines (`**最新ユーザー指示** [HH:MM:SS]: ...`).
+  const lines = text.split('\n');
+  const userTurn5 = lines.find((l) => /^\[\d\d:\d\d:\d\d\] \[user\]: user side of turn 5/.test(l));
+  const assistantTurn5 = lines.find(
+    (l) => /^\[\d\d:\d\d:\d\d\] \[assistant\]: assistant side of turn 5/.test(l),
+  );
+  const userTurn6 = lines.find((l) => /^\[\d\d:\d\d:\d\d\] \[user\]: lone user turn/.test(l));
 
   assert.ok(userTurn5 && assistantTurn5 && userTurn6);
   // Turn 5: only assistant (last role of the turn) gets the suffix

package/src/session-start.mjs

@@ -30,11 +30,33 @@ import { consumeBaton } from './baton.mjs';
 import { mergeSpecificPredecessor, resolveMergeTarget } from './session-merger.mjs';
 import { buildResumeContext } from './resume-context.mjs';
 import { ensureMonitorTaskFile } from './vscode-task.mjs';
-import { appendFileSync, mkdirSync } from 'node:fs';
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { randomBytes } from 'node:crypto';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { pathToFileURL } from 'node:url';
 
+// SPIKE ONLY — Phase 0-2 / 0-4 検証用。marker file 削除で無効化される。
+// docs/THROUGHLINE_TRANSCRIPT_INJECTION_PLAN.md §3 Phase 0-2 参照。
+const SPIKE_MARKER_PATH = join(homedir(), '.throughline', 'spike-inject.flag');
+
+// Phase 0-6: initialUserMessage が interactive モードで効くか実機検証する experimental switch。
+// flag 存在時、SessionStart hook は plain stdout の代わりに JSON 出力に切り替わり、
+// hookSpecificOutput.initialUserMessage に tracer 入りメッセージを乗せる。
+// openclaude の OSS 実装では「headless 専用」と記載されているが、real CC の挙動は未確認。
+const INITIAL_USER_MESSAGE_TEST_FLAG = join(homedir(), '.throughline', 'initial-user-message-test.flag');
+
+function logInitialUserMessageTest(entry) {
+  const path = join(homedir(), '.throughline', 'logs', 'initial-user-message-test.log');
+  try {
+    mkdirSync(dirname(path), { recursive: true });
+    appendFileSync(path, JSON.stringify(entry) + '\n', 'utf8');
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : 'unknown';
+    process.stderr.write(`[session-start:initialUserMessage-test-log] ${msg}\n`);
+  }
+}
+
 const ENV_DISABLE_AUTO_HANDOFF = 'THROUGHLINE_DISABLE_AUTO_HANDOFF';
 
 function isAutoHandoffDisabled(env) {
@@ -88,7 +110,7 @@ export async function run() {
   });
 
   const payload = JSON.parse(raw);
-  const { session_id, cwd, source } = payload;
+  const { session_id, cwd, source, transcript_path } = payload;
 
   if (!session_id) throw new Error('Missing session_id in SessionStart payload');
 
@@ -146,11 +168,80 @@ export async function run() {
     mergeResult = { merged: false, skipReason: 'auto_handoff_disabled' };
   }
 
+  // 4. 合流成立なら curated memory を stdout 注入 (L1 + L2 + L3 refs)
+  //    順序厳守: stdout flush を先に完了させてから spike 分岐へ進む。
+  //    spike が throw しても stdout は既に attachment に保存されている。
+  //
+  //    Phase 0-6: initialUserMessage test flag 存在時は JSON 出力に切り替え、
+  //    initialUserMessage が interactive モードで messages[] に乗るか実機検証する。
+  if (mergeResult.merged) {
+    const text = buildResumeContext(db, {
+      sessionId: session_id,
+      isInheritance: true,
+    });
+    if (existsSync(INITIAL_USER_MESSAGE_TEST_FLAG)) {
+      // TEST MODE: emit JSON with initialUserMessage tracer. Plain stdout は出さない
+      // (= 通常 Throughline 案内文無し)。テスト 1 回限定。flag を削除すれば即復帰。
+      const tracer = randomBytes(4).toString('hex');
+      const initialMessage =
+        `[initial-user-tracer: ${tracer}]\n\n` +
+        `This text is being delivered via the SessionStart hook's ` +
+        `hookSpecificOutput.initialUserMessage field. If you can quote the 8-hex ` +
+        `tracer above when asked, it means initialUserMessage IS consumed in ` +
+        `interactive mode (not headless-only as openclaude documents).`;
+      const jsonOutput = JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: 'SessionStart',
+          initialUserMessage: initialMessage,
+        },
+      });
+      process.stdout.write(jsonOutput + '\n');
+      logInitialUserMessageTest({
+        ts: new Date(now).toISOString(),
+        session_id,
+        tracer,
+        mode: 'json-initial-user-message-only',
+        had_resume_context: Boolean(text),
+      });
+    } else if (text) {
+      process.stdout.write(text + '\n');
+    }
+  }
+
+  // 5. SPIKE: marker file あり + merge 成立 + transcript_path あり の 3 条件で
+  //    L2 を user/assistant role 付きで transcript_path にも append する。
+  //    本実装ではない (docs/THROUGHLINE_TRANSCRIPT_INJECTION_PLAN.md Phase 0-2)。
+  //
+  //    tracer: 末尾 assistant 行に stdout 注入には含まれない一意トークンを付与する。
+  //    次の /clear 後に Claude が tracer を再現できれば JSONL 経路はモデル可視。
+  let spikeResult = null;
+  const spikeMarkerExists = existsSync(SPIKE_MARKER_PATH);
+  if (spikeMarkerExists && mergeResult.merged && transcript_path) {
+    try {
+      const { spikeInject, generateSpikeTracer } = await import('./spike-transcript-writer.mjs');
+      const tracer = generateSpikeTracer();
+      spikeResult = spikeInject({
+        db,
+        targetJsonlPath: transcript_path,
+        newSessionId: session_id,
+        cwd: projectPath,
+        version: payload.version ?? '2.1.145',
+        gitBranch: payload.gitBranch ?? 'main',
+        tracer,
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : 'unknown';
+      process.stderr.write(`[spike-inject] ${msg}\n`);
+      spikeResult = { error: msg };
+    }
+  }
+
   logDecision({
     ts: new Date(now).toISOString(),
     source: source ?? null,
     session_id,
     project_path: projectPath,
+    transcript_path: transcript_path ?? null,
     triggered_path: triggeredPath,
     auto_handoff_disabled: autoDisabled,
     baton_session_id: baton.sessionId ?? null,
@@ -159,19 +250,10 @@ export async function run() {
     merged: mergeResult.merged,
     merge_skip_reason: mergeResult.skipReason ?? null,
     predecessor_id: mergeResult.predecessorId ?? null,
+    spike_marker_exists: spikeMarkerExists,
+    spike_result: spikeResult,
   });
 
-  // 4. 合流成立なら curated memory を stdout 注入 (L1 + L2 + L3 refs)
-  if (mergeResult.merged) {
-    const text = buildResumeContext(db, {
-      sessionId: session_id,
-      isInheritance: true,
-    });
-    if (text) {
-      process.stdout.write(text + '\n');
-    }
-  }
-
   process.exit(0);
 }
 

package/src/spike-transcript-writer.mjs

@@ -0,0 +1,196 @@
+/**
+ * SPIKE ONLY — Phase 0-2 / 0-4 検証用。本実装ではない。
+ *
+ * docs/THROUGHLINE_TRANSCRIPT_INJECTION_PLAN.md Phase 0-2 で
+ * 「`/clear` 直後の SessionStart hook 内で transcript_path に L2 を user/assistant
+ *  role 付きで append すると、Claude が次の short prompt の文脈として読むか」を実機検証する。
+ *
+ * 本実装ではない理由:
+ *   - text content のみ復元 (tool_use / tool_result / thinking は割愛)
+ *   - idempotency 簡易チェックのみ
+ *   - 本実装 (Phase 1-1) では src/transcript-writer.mjs を別途作る
+ *
+ * tracer 経路: 注入した JSONL 行が**モデルの message 履歴に乗ったか**を切り分けるため、
+ * 最終 assistant 行末尾に **stdout 注入には含まれない一意トークン** を付与する。
+ * 次の /clear 後にユーザーがその合言葉の再現を求め、Claude が答えられれば JSONL 経路は
+ * モデル可視。答えられなければ JSONL は保持されてもメッセージ履歴に乗らない (孤立 chain
+ * 等が原因)。
+ *
+ * marker file `~/.throughline/spike-inject.flag` 削除で spike は無効化される。
+ */
+
+import { readFileSync, existsSync, fsyncSync, openSync, closeSync, writeSync } from 'node:fs';
+import { randomUUID, randomBytes } from 'node:crypto';
+import { buildHandoffRecord } from './handoff-record.mjs';
+
+/**
+ * targetJsonl の末尾行の uuid を返す。chain 設計案 (b) の親決定用。
+ * file が無い / 空 / uuid 持ち行が無い場合は null を返す。
+ */
+function readLastUuid(path) {
+  if (!existsSync(path)) return null;
+  const text = readFileSync(path, 'utf8');
+  const lines = text.split('\n').filter((l) => l.trim());
+  for (let i = lines.length - 1; i >= 0; i -= 1) {
+    try {
+      const o = JSON.parse(lines[i]);
+      if (typeof o.uuid === 'string') return o.uuid;
+    } catch {
+      // skip non-json line
+    }
+  }
+  return null;
+}
+
+function buildUserLine({ b, parentUuid, newSessionId, cwd, version, gitBranch }) {
+  const uuid = randomUUID();
+  const ts = new Date(b.createdAt ?? Date.now()).toISOString();
+  const obj = {
+    parentUuid,
+    isSidechain: false,
+    promptId: randomUUID(),
+    type: 'user',
+    message: {
+      role: 'user',
+      content: [{ type: 'text', text: b.text ?? '' }],
+    },
+    uuid,
+    timestamp: ts,
+    permissionMode: 'auto',
+    userType: 'external',
+    entrypoint: 'claude-vscode',
+    cwd,
+    sessionId: newSessionId,
+    version,
+    gitBranch,
+  };
+  return { uuid, line: JSON.stringify(obj) };
+}
+
+function buildAssistantLine({ b, parentUuid, newSessionId, cwd, version, gitBranch, tracer, assistantModel }) {
+  const uuid = randomUUID();
+  const ts = new Date(b.createdAt ?? Date.now()).toISOString();
+  const baseText = b.text ?? '';
+  const text = tracer ? `${baseText}\n\n[spike-tracer: ${tracer}]` : baseText;
+  const obj = {
+    parentUuid,
+    isSidechain: false,
+    message: {
+      model: assistantModel,
+      id: `msg_spike_${uuid.slice(0, 8)}`,
+      type: 'message',
+      role: 'assistant',
+      content: [{ type: 'text', text }],
+      stop_reason: 'end_turn',
+      stop_sequence: null,
+      usage: { input_tokens: 0, output_tokens: 0 },
+    },
+    requestId: `req_spike_${uuid.slice(0, 8)}`,
+    type: 'assistant',
+    uuid,
+    timestamp: ts,
+    userType: 'external',
+    entrypoint: 'claude-vscode',
+    cwd,
+    sessionId: newSessionId,
+    version,
+    gitBranch,
+  };
+  return { uuid, line: JSON.stringify(obj) };
+}
+
+/**
+ * 末尾 assistant 行に埋める tracer を生成する。8 hex (32 bit)。
+ * stdout 注入には含まれない値である必要があるため、DB body text とは無相関に乱数生成する。
+ */
+export function generateSpikeTracer() {
+  return randomBytes(4).toString('hex');
+}
+
+/**
+ * spike append. fsync 付きで JSONL に user/assistant 行を append する。
+ *
+ * @param {object} opts
+ * @param {string|null} [opts.tracer] 末尾 assistant 行に付与する一意トークン。
+ *   未指定なら付与しない (back-compat: 既存呼び出し用)。
+ * @returns {{
+ *   appended: number,
+ *   parentUuidStart: string|null,
+ *   tracer: string|null,
+ *   tracerAppendedAt: number|null,
+ *   skipReason?: string
+ * }}
+ */
+// Phase 0-5 retry: 偽モデル名 ('claude-throughline-spike') では Claude Code が messages[]
+// 構築時にフィルタしている可能性があるため、デフォルトは実在 Claude モデル名にする。
+const DEFAULT_SPIKE_ASSISTANT_MODEL = 'claude-opus-4-7';
+
+export function spikeInject({
+  db,
+  targetJsonlPath,
+  newSessionId,
+  cwd,
+  version,
+  gitBranch,
+  tracer = null,
+  assistantModel = DEFAULT_SPIKE_ASSISTANT_MODEL,
+}) {
+  const record = buildHandoffRecord(db, { sessionId: newSessionId, isInheritance: true });
+  if (!record || !record.memory?.recentBodies?.length) {
+    return {
+      appended: 0,
+      parentUuidStart: null,
+      tracer: null,
+      tracerAppendedAt: null,
+      skipReason: 'no_record_or_empty_l2',
+    };
+  }
+  const bodies = record.memory.recentBodies; // 古い順
+
+  // 末尾 assistant 行を 1 件特定 (assistant が必ず末尾とは限らないため後ろから探す)。
+  let lastAssistantIdx = -1;
+  for (let i = bodies.length - 1; i >= 0; i -= 1) {
+    if (bodies[i].role === 'assistant') {
+      lastAssistantIdx = i;
+      break;
+    }
+  }
+
+  let parentUuid = readLastUuid(targetJsonlPath);
+  const parentUuidStart = parentUuid;
+  const lines = [];
+  let tracerAppendedAt = null;
+  for (let i = 0; i < bodies.length; i += 1) {
+    const b = bodies[i];
+    const isLastAssistant = Boolean(tracer) && i === lastAssistantIdx;
+    const built = b.role === 'user'
+      ? buildUserLine({ b, parentUuid, newSessionId, cwd, version, gitBranch })
+      : buildAssistantLine({
+          b,
+          parentUuid,
+          newSessionId,
+          cwd,
+          version,
+          gitBranch,
+          tracer: isLastAssistant ? tracer : null,
+          assistantModel,
+        });
+    if (isLastAssistant) tracerAppendedAt = i;
+    lines.push(built.line);
+    parentUuid = built.uuid;
+  }
+  // sync write + fsync で hook 終了前に確実に flush
+  const fd = openSync(targetJsonlPath, 'a');
+  try {
+    writeSync(fd, lines.join('\n') + '\n');
+    fsyncSync(fd);
+  } finally {
+    closeSync(fd);
+  }
+  return {
+    appended: lines.length,
+    parentUuidStart,
+    tracer: tracer ?? null,
+    tracerAppendedAt,
+  };
+}