throughline 0.15.1 → 0.15.2

package/CHANGELOG.md

@@ -10,6 +10,25 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.15.2] — 2026-10-06
+
+### 修正
+
+- Claude Desktopで「フォルダなし」で始めて、後から作業フォルダへ移した会話では、自動継続（`auto-handoff enable --host claude`）を有効にしていても引き継ぎが始まらない不具合を直す。Desktopは会話を移した後も、hookへ渡す`CLAUDE_PROJECT_DIR`を移る前の場所のままにする。Throughlineはその値で対象のprojectかどうかを決めていたので、自動圧縮の前のhookが`auto_handoff_disabled`で見送り、圧縮がそのまま走っていた。
+- 会話が移った先は、Claude Codeがtranscriptへ書く`relocated`の行（`relocatedCwd`）から読む。移っている会話では、自動継続の有効判定と印（baton）のprojectを、移った先にする。
+- 同じ会話のターン終了では、完了ターンの控えを移った先のprojectへ書き、`sessions.project_path`を移った先へ付け替える。これまでは移る前の場所のまま残り、移った先のprojectの過去の会話（`handoff-context`、`throughline detail`）にも`observer-read`にも、その会話が出なかった。
+- 移っていない会話の扱いは変わらない。`relocated`の行が無ければ、これまでどおり`CLAUDE_PROJECT_DIR`、無ければhookの`cwd`を使う。
+
+### 確認した範囲
+
+- macOS（Claude Desktop同梱の2.1.286が書いた本物のtranscriptの写し、移った後に自動圧縮が2回走った会話）。切り離したHOMEでhookを手で呼び、0.14.2は`pre-compact`が終了コード0・`auto_handoff_disabled`、`sessions.project_path`と控えは移る前の場所。この版は`pre-compact`が終了コード2（圧縮を止める）・`requested`、`sessions.project_path`と控えは移った先、`observer-read`は移った先のprojectで`snapshot`を返す。
+- macOS、端末から始めた移っていない会話（Claude Code 2.1.289、Haiku 4.5）。この版で4回連続で引き継ぎ、14個を番号順に読み切って完了。自動圧縮は0回。
+
+### 確認していない範囲
+
+- Claude Desktopの画面で、この版が通しで引き継ぐこと（旧い会話を止める所と、後継を立てる所）。Desktopの画面からの送信が要るため、hookを手で呼ぶ確認までにとどまる。
+- Windows・Linuxで移した会話。`relocated`の行の読み取りは、Windowsの書き方の場所を単体の試験で確かめただけ。
+
 ## [0.15.1] — 2026-10-05
 
 ### 修正
@@ -1771,7 +1790,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.15.1...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.15.2...HEAD
+[0.15.2]: https://github.com/kitepon/Throughline/compare/v0.15.1...v0.15.2
 [0.15.1]: https://github.com/kitepon/Throughline/compare/v0.15.0...v0.15.1
 [0.15.0]: https://github.com/kitepon/Throughline/compare/v0.14.3...v0.15.0
 [0.14.3]: https://github.com/kitepon/Throughline/compare/v0.14.2...v0.14.3

package/docs/adr/0033-claude-auto-handoff-new-session.md

@@ -31,6 +31,8 @@ Claude Desktop の新しい会話は、画面を開いただけでは process
 1. **圧縮を止める**: `PreCompact` hook（`throughline pre-compact`、matcher 無し）が、`trigger: "auto"` で自動継続が
    有効な project の時だけ、`/tl` と同じ印（baton）と引き継ぎの記録を残し、exit code 2 で圧縮を止める。
    印の project は、会話を起動した場所（`CLAUDE_PROJECT_DIR`）を、その OS の書き方にそろえたもの（0.14.2）。
+   Claude Desktop で会話を別の project へ移している時は、transcript の `relocated` の行（`relocatedCwd`）が示す移った先を使う。
+   `CLAUDE_PROJECT_DIR` は移る前の場所のまま届くため（0.15.2）。
    hook の cwd は Bash の `cd` に追従するので使わない。後継は起動した場所で立ち、その cwd で印を探す。
    手動の `/compact`、無効な project、subagent の中の圧縮（payload に `agent_id`）、script から起動した会話
    （`CLAUDE_CODE_ENTRYPOINT` が `sdk-` で始まる）では止めない。

package/package.json

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

package/src/claude-auto-handoff.mjs

@@ -197,8 +197,10 @@ export function requestClaudeAutoHandoff({
   const path = recordPath(sessionId, dir);
   const existing = readClaudeAutoHandoff(sessionId, dir);
   // 有効判定は会話を起動した project で行う。hook の cwd は Bash の cd に追従する。
+  // 会話が別の project へ移っている時（Claude Desktop）は、移った先で行う。
   const projectPath = nativeProjectPath(
-    claudeHostAdapter.completionProjectPath({ cwd: payload.cwd ?? process.cwd(), env }), platform);
+    claudeHostAdapter.completionProjectPath({
+      cwd: payload.cwd ?? process.cwd(), env, transcriptPath: payload.transcript_path }), platform);
 
   if (payload.trigger !== 'auto') {
     // 人が /compact を選んだ。まだ止めていない記録は取り下げる。

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

@@ -63,6 +63,33 @@ function request(dir, overrides = {}) {
   return { result, db };
 }
 
+test('PreCompact: 会話が別の project へ移っている時は、移った先で有効かどうかを決める（Claude Desktop）', () => withDir(dir => {
+  // Desktop は「フォルダなし」で始めた会話を後から project へ移す。CLAUDE_PROJECT_DIR は移る前のまま届く。
+  const scratch = '/Users/kite/Library/Application Support/Claude/scratch-workspaces/a/b/scratch-2026-10-05-ac3fa8';
+  const moved = '/Users/kite/tl-claude-probe';
+  const transcriptPath = join(dir, 'moved.jsonl');
+  writeFileSync(transcriptPath, jsonl([user('読んで', '2026-10-05T22:38:17.050Z'), assistant('読みました', '2026-10-05T22:39:18.926Z'),
+    { type: 'relocated', sessionId: SESSION, relocatedCwd: moved }]));
+  const onlyMoved = { enabled: true, projects: [moved] };
+
+  const { result, db } = request(dir, { config: onlyMoved, transcriptPath, env: { CLAUDE_PROJECT_DIR: scratch }, payload: { cwd: moved } });
+  assert.equal(result.status, 'requested');
+  assert.equal(result.block, true);
+  assert.equal(result.projectPath, moved);
+  assert.equal(readClaudeAutoHandoff(SESSION, dir).project_path, moved);
+  assert.equal(db.prepare('SELECT session_id FROM handoff_batons WHERE project_path = ?').get(moved).session_id, SESSION);
+}));
+
+test('PreCompact: 移っていない会話は、これまでどおり起動した project で決める', () => withDir(dir => {
+  const transcriptPath = join(dir, 'plain.jsonl');
+  writeFileSync(transcriptPath, jsonl([user('読んで', '2026-10-05T22:38:17.050Z'), assistant('読みました', '2026-10-05T22:39:18.926Z')]));
+  const { result } = request(dir, { config: { enabled: true, projects: ['/work/app/sub'] }, transcriptPath,
+    env: { CLAUDE_PROJECT_DIR: '/work/app' }, payload: { cwd: '/work/app/sub' } });
+  assert.equal(result.status, 'skipped');
+  assert.equal(result.reason, 'auto_handoff_disabled');
+  assert.equal(result.projectPath, '/work/app');
+}));
+
 test('PreCompact: 自動圧縮で有効な時だけ、印と記録を残して圧縮を止める', () => withDir(dir => {
   const { result, db } = request(dir);
   assert.equal(result.status, 'requested');

package/src/hook-entrypoints.test.mjs

@@ -863,6 +863,57 @@ test('process-turn subprocess backfills all completed logical turns from a multi
   }
 });
 
+test('process-turn subprocess files a relocated Claude Desktop conversation under the project it moved to', () => {
+  // Desktop は「フォルダなし」で始めた会話を後から project へ移す。hook の CLAUDE_PROJECT_DIR は移る前のまま届く。
+  const home = makeTempHome();
+  const scratch = makeTempProject();
+  const moved = makeTempProject();
+  const transcriptPath = join(moved, 'transcript.jsonl');
+  const sessionId = '04bf5ab3-4b29-4b35-9b85-02a48eec51a1';
+  const entries = [
+    { type: 'user', message: { role: 'user', content: [{ type: 'text', text: 'first request' }] } },
+    { type: 'assistant', message: { role: 'assistant', content: [{ type: 'text', text: 'first answer' }] } },
+  ];
+  const stop = (lastAssistantMessage) => runNode([join(REPO_ROOT, 'src/turn-processor.mjs')], {
+    home,
+    cwd: moved,
+    env: { CLAUDE_PROJECT_DIR: scratch },
+    input: JSON.stringify({ session_id: sessionId, cwd: moved, transcript_path: transcriptPath, last_assistant_message: lastAssistantMessage }),
+  });
+  try {
+    // 移る前: SessionStart が移る前の場所で行を作り、最初の Stop も移る前の場所へ受領を書く。
+    const started = runNode([join(REPO_ROOT, 'src/session-start.mjs')], {
+      home, cwd: scratch, input: JSON.stringify({ session_id: sessionId, cwd: scratch, source: 'startup', transcript_path: transcriptPath }),
+    });
+    assert.equal(started.status, 0, started.stderr);
+    writeFileSync(transcriptPath, entries.map((entry) => JSON.stringify(entry)).join('\n') + '\n', 'utf8');
+    assert.equal(stop('first answer').status, 0);
+    let db = openDb(home);
+    assert.equal(db.prepare('SELECT project_path FROM sessions WHERE session_id = ?').get(sessionId).project_path, scratch);
+    db.close();
+    assert.equal(readCompletedTurnReceiptSnapshot({ projectPath: scratch, env: childEnv(home) }).receipts.length, 1);
+
+    // 移った後の Stop: sessions の project を付け替え、全ターンの受領を移った先へ出す。
+    appendFileSync(transcriptPath, [
+      { type: 'relocated', sessionId, relocatedCwd: moved },
+      { type: 'user', message: { role: 'user', content: [{ type: 'text', text: 'second request' }] } },
+      { type: 'assistant', message: { role: 'assistant', content: [{ type: 'text', text: 'second answer' }] } },
+    ].map((entry) => JSON.stringify(entry)).join('\n') + '\n', 'utf8');
+    const second = stop('second answer');
+    assert.equal(second.status, 0, second.stderr);
+    db = openDb(home);
+    assert.equal(db.prepare('SELECT project_path FROM sessions WHERE session_id = ?').get(sessionId).project_path, moved);
+    assert.equal(db.prepare('SELECT COUNT(*) AS n FROM bodies').get().n, 4);
+    db.close();
+    const receipts = readCompletedTurnReceiptSnapshot({ projectPath: moved, env: childEnv(home) });
+    assert.deepEqual(receipts.receipts.map((entry) => entry.sequence), [1, 2]);
+  } finally {
+    rmSync(scratch, { recursive: true, force: true });
+    rmSync(moved, { recursive: true, force: true });
+    rmSync(home, { recursive: true, force: true });
+  }
+});
+
 test('process-turn subprocess captures the completed turn when the next user entry lands right after Stop', () => {
   const home = makeTempHome();
   const project = makeTempProject();

package/src/hosts/claude.mjs

@@ -4,7 +4,8 @@
  * Claude は Throughline の基準 host。hook payload は snake_case のまま届き、
  * 引き継ぎ注入は UserPromptSubmit hook の stdout でモデルへ渡る。
  */
-import { isAbsolute } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { isAbsolute, posix, win32 } from 'node:path';
 import { CLAUDE_HOST, hostOfSessionId } from './identity.mjs';
 
 // Claude Code の背景 task 通知は user 発言として transcript に入る。識別子・出力 path・
@@ -36,6 +37,40 @@ export function compactClaudePeerMessage(text) {
   return note < 0 ? text : text.slice(0, note);
 }
 
+// Claude Desktop は「フォルダなし」で始めた会話を、後から実在の project へ移せる。移すと transcript に
+// `{"type":"relocated","relocatedCwd":"<移った先>"}` の行が入り、transcript 自体も移った先の project の
+// 置き場へ移る。hook へ渡る CLAUDE_PROJECT_DIR は、移る前の場所のまま残る（2.1.286 で実測）。
+const RELOCATED_MARKER = '"relocated"';
+
+/**
+ * 会話が最後に移った先。移っていない会話、transcript が読めない時は null。
+ * @param {string | null | undefined} transcriptPath
+ * @returns {string | null}
+ */
+export function readClaudeRelocatedCwd(transcriptPath) {
+  if (typeof transcriptPath !== 'string' || !transcriptPath) return null;
+  let raw;
+  try { raw = readFileSync(transcriptPath, 'utf8'); }
+  catch { return null; }
+  // 道具の出力が同じ文字列を含むことがある。行を JSON として読み、行そのものの type で確かめる。
+  for (let end = raw.length; end > 0;) {
+    const marker = raw.lastIndexOf(RELOCATED_MARKER, end - 1);
+    if (marker < 0) return null;
+    const lineStart = raw.lastIndexOf('\n', marker) + 1;
+    const newline = raw.indexOf('\n', marker);
+    const line = raw.slice(lineStart, newline < 0 ? raw.length : newline);
+    try {
+      const entry = JSON.parse(line);
+      const moved = entry?.type === 'relocated' ? entry.relocatedCwd : null;
+      if (typeof moved === 'string' && (posix.isAbsolute(moved) || win32.isAbsolute(moved))) return moved;
+    } catch {
+      // 書きかけの行。前の行を探す。
+    }
+    end = lineStart;
+  }
+  return null;
+}
+
 export const claudeHostAdapter = Object.freeze({
   host: CLAUDE_HOST,
   matchesSessionId: (sessionId) => hostOfSessionId(sessionId) === CLAUDE_HOST,
@@ -45,7 +80,10 @@ export const claudeHostAdapter = Object.freeze({
   // 完了受領はセッションを起動した project に書く。hook payload の cwd は Bash の cd に
   // 追従するため、作業中に下位ディレクトリへ移ると起動 project の feed から漏れる。
   // Claude Code は hook の環境変数 CLAUDE_PROJECT_DIR に起動 project を渡す。
-  completionProjectPath({ cwd, env }) {
+  // 会話が別の project へ移っている時は、移った先を使う（CLAUDE_PROJECT_DIR は移る前のまま）。
+  completionProjectPath({ cwd, env, transcriptPath }) {
+    const relocated = readClaudeRelocatedCwd(transcriptPath);
+    if (relocated) return relocated;
     const projectDir = env?.CLAUDE_PROJECT_DIR;
     return typeof projectDir === 'string' && isAbsolute(projectDir) ? projectDir : cwd;
   },

package/src/hosts/claude.test.mjs

@@ -1,6 +1,9 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
-import { claudeHostAdapter } from './claude.mjs';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { claudeHostAdapter, readClaudeRelocatedCwd } from './claude.mjs';
 import { codexHostAdapter } from './codex.mjs';
 import { cursorHostAdapter } from './cursor.mjs';
 import { grokHostAdapter } from './grok.mjs';
@@ -18,3 +21,57 @@ test('Codex, Grok, and Cursor completion receipts keep the hook cwd', () => {
     assert.equal(adapter.completionProjectPath({ cwd: '/work/bot', env: { CLAUDE_PROJECT_DIR: '/elsewhere' } }), '/work/bot');
   }
 });
+
+function withTranscript(lines, fn) {
+  const dir = mkdtempSync(join(tmpdir(), 'tl-claude-host-'));
+  const transcriptPath = join(dir, 'transcript.jsonl');
+  try {
+    writeFileSync(transcriptPath, lines.join('\n'), 'utf8');
+    return fn(transcriptPath);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+// Claude Desktop 2.1.286 が書く行の形（Mac で実測）。順序は2通りある。
+const relocatedLine = (cwd) => JSON.stringify({ type: 'relocated', sessionId: '04bf5ab3-4b29-4b35-9b85-02a48eec51a1', relocatedCwd: cwd });
+const userLine = (text) => JSON.stringify({ type: 'user', message: { role: 'user', content: text } });
+
+test('readClaudeRelocatedCwd: 移っていない会話と読めない transcript は null', () => {
+  assert.equal(readClaudeRelocatedCwd(null), null);
+  assert.equal(readClaudeRelocatedCwd(join(tmpdir(), 'tl-claude-host-missing', 'none.jsonl')), null);
+  withTranscript([userLine('hello'), ''], (path) => assert.equal(readClaudeRelocatedCwd(path), null));
+});
+
+test('readClaudeRelocatedCwd: 最後に移った先を返す', () => {
+  withTranscript([userLine('a'), relocatedLine('/Users/kite/first'), userLine('b'), relocatedLine('/Users/kite/tl-claude-probe'),
+    JSON.stringify({ type: 'agent-name', agentName: 'x' }), ''], (path) => {
+    assert.equal(readClaudeRelocatedCwd(path), '/Users/kite/tl-claude-probe');
+  });
+  withTranscript([relocatedLine('C:\\Users\\kite_\\proj')], (path) => {
+    assert.equal(readClaudeRelocatedCwd(path), 'C:\\Users\\kite_\\proj');
+  });
+});
+
+test('readClaudeRelocatedCwd: 道具の出力に同じ文字列があっても、行そのものの type だけを見る', () => {
+  const quoted = JSON.stringify({ type: 'user', message: { role: 'user', content: [
+    { type: 'tool_result', tool_use_id: 't1', content: relocatedLine('/quoted/in/output') }] } });
+  withTranscript([relocatedLine('/Users/kite/real'), quoted, '{"type":"relocated","relocatedCwd":"/partial'], (path) => {
+    assert.equal(readClaudeRelocatedCwd(path), '/Users/kite/real');
+  });
+  withTranscript([quoted, relocatedLine('relative/path'), JSON.stringify({ type: 'relocated' })], (path) => {
+    assert.equal(readClaudeRelocatedCwd(path), null);
+  });
+});
+
+test('Claude completion receipts follow the project the conversation moved to (Claude Desktop)', () => {
+  const scratch = '/Users/kite/Library/Application Support/Claude/scratch-workspaces/a/b/scratch-2026-10-05-ac3fa8';
+  withTranscript([userLine('a'), relocatedLine('/Users/kite/tl-claude-probe'), ''], (transcriptPath) => {
+    assert.equal(claudeHostAdapter.completionProjectPath({
+      cwd: '/Users/kite/tl-claude-probe/sub', env: { CLAUDE_PROJECT_DIR: scratch }, transcriptPath,
+    }), '/Users/kite/tl-claude-probe');
+  });
+  withTranscript([userLine('a'), ''], (transcriptPath) => {
+    assert.equal(claudeHostAdapter.completionProjectPath({ cwd: '/work/bot/sub', env: { CLAUDE_PROJECT_DIR: '/work/bot' }, transcriptPath }), '/work/bot');
+  });
+});

package/src/turn-processor.mjs

@@ -49,6 +49,8 @@ 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 { readClaudeRelocatedCwd } from './hosts/claude.mjs';
+import { CLAUDE_HOST } from './hosts/identity.mjs';
 import { completeClaudeTurnWithoutHandoff } from './claude-auto-handoff.mjs';
 
 /** 直近 N ターンは bodies を生で残し、それより古いものだけ L1 要約する。 */
@@ -316,6 +318,20 @@ async function processStop() {
     db.prepare('UPDATE sessions SET updated_at = ? WHERE session_id = ?').run(now, target);
   }
 
+  // 完了受領と sessions の project は、会話を起動した project に合わせる。会話が別の project へ
+  // 移っている時（Claude Desktop）は、移った先へ付け替える。付け替えないと、移った先の project の
+  // 過去の会話にも Observer feed にも、この会話が出ない。
+  const hostAdapter = hostAdapterForSessionId(session_id);
+  const relocatedProjectPath = hostAdapter.host === CLAUDE_HOST ? readClaudeRelocatedCwd(transcript_path) : null;
+  const completionProjectPath = relocatedProjectPath ?? hostAdapter.completionProjectPath({
+    cwd: cwd ?? process.cwd(),
+    env: process.env,
+  });
+  if (relocatedProjectPath) {
+    db.prepare('UPDATE sessions SET project_path = ? WHERE session_id IN (?, ?) AND project_path <> ?')
+      .run(relocatedProjectPath, session_id, target, relocatedProjectPath);
+  }
+
   // L2 = transcript 全体を論理ターン群で走査し、未捕捉の完了ターンを一括回収する。
   // 従来の「最後の 1 ペアのみ保存」は Stop の空振り・不発が永久穴になった (docs/12 B-1)。
   // user / assistant は「1 往復 = 1 ターン」として同じ turn_number（= 代表 assistant
@@ -349,10 +365,6 @@ async function processStop() {
   // 過去のStopでDBだけ回収済みだったpairもreceipt storeの冪等性で穴埋めする。
   // receipt failure は Stop hook の failure として上位へ伝播させる。L1/L3/usage は
   // receipt 後の派生処理なので、そこで失敗しても completed pair を取り消さない。
-  const completionProjectPath = hostAdapterForSessionId(session_id).completionProjectPath({
-    cwd: cwd ?? process.cwd(),
-    env: process.env,
-  });
   for (const completedTurnNumber of backfill.turnNumbers) {
     publishCapturedClaudeCompletionReceipt(db, {
       target,