Claude Code の会話ログを自動退避しても VSCode のタブを壊さない（state.vscdb で「まだ開いているセッション」を検出する）

この指示書が解く問題

Claude Code のセッション一覧を自動で整理するために ~/.claude/projects/<project>/<sessionId>.jsonl を別フォルダへ移動する仕組みを入れると、 VSCode 拡張（Claude Code for VS Code）で開いたままのタブを次に触った瞬間に次の赤い帯が出て、会話を続けられなくなる。

Couldn't load this conversation's saved history, so it can't be continued.
Start a new conversation · View output logs · Troubleshooting resources

症状の正体は --resume <sessionId> の not_found。拡張はタブ・ブックマーク・UI でアーカイブしたセッションの ID を VSCode の状態DB（SQLite）に平文で持ち続けるので、ファイルだけ動かすと「一覧には残るのに中身が無い」状態になる。

拡張自身の自動アーカイブ設定 claudeCode.archiveInactiveSessions は「開いている・実行中・入力待ち・未読のセッションは絶対に対象にしない」と明記している。 自作の退避スクリプトも同じ原則に揃えればよい。

拡張がセッション ID を持っている場所（実測: 拡張 2.1.x）

<User> は win32 %APPDATA%\Code\User、macOS ~/Library/Application Support/Code/User、Linux ~/.config/Code/User（Insiders は Code - Insiders）。

ID は UTF-8 の平文で入っているので、SQLite を解釈せずバイト列の部分一致で判定できる。読むだけで、書き込みは絶対にしない（VSCode が開いている DB を書き換えると壊れる）。

退避スクリプトに入れるガード（Node.js）

import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';

function entries(dir) { try { return fs.readdirSync(dir, { withFileTypes: true }); } catch (e) { if (e.code === 'ENOENT') return []; throw e; } }

// VSCode の状態DBのパス一覧。ORGIAST_VSCODE_USER_DIRS はテスト用の上書き（path.delimiter 区切り）。
function vscodeStateFiles() {
  const override = process.env.VSCODE_USER_DIRS;
  const dirs = override !== undefined ? override.split(path.delimiter).filter(Boolean)
    : ['Code', 'Code - Insiders'].map(product => {
      if (process.platform === 'win32') return path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), product, 'User');
      if (process.platform === 'darwin') return path.join(os.homedir(), 'Library', 'Application Support', product, 'User');
      return path.join(process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config'), product, 'User');
    });
  const files = [];
  for (const dir of dirs) {
    files.push(path.join(dir, 'globalStorage', 'state.vscdb'));
    for (const entry of entries(path.join(dir, 'workspaceStorage'))) {
      if (entry.isDirectory()) files.push(path.join(dir, 'workspaceStorage', entry.name, 'state.vscdb'));
    }
  }
  return files;
}

// 1 パスで 1 回だけ読む。読めない DB があれば「全件見送り」に倒す（フェイルセーフ）。
function vscodeReferences() {
  const buffers = []; let unreadable = false, files;
  try { files = vscodeStateFiles(); } catch { return { buffers, unreadable: true }; }
  for (const file of files) {
    try { buffers.push(fs.readFileSync(file)); }
    catch (error) { if (error.code !== 'ENOENT') unreadable = true; }
  }
  return { buffers, unreadable };
}

// 退避ループの中（transcript を読む前）で:
//   const refs = vscodeRefs ??= vscodeReferences();
//   if (refs.unreadable) { result.vscodeState = 'unreadable'; continue; }
//   if (refs.buffers.some(b => b.includes(sessionId))) { result.protected++; continue; }

ポイント:

• 判定は 退避理由を問わず（明示クローズも含めて）かける。ユーザーがタブを ✕ で閉じれば DB から ID が消え、次のパスで通常どおり退避される。
• hiddenSessionIds も保護対象にする。UI でアーカイブ済みのセッションは「Archived sessions」から再開できるので、ファイルを動かすとそこでも同じ赤い帯が出る。
• 判定を transcript の読み込みより前に置くと、走査予算も節約できる。

テストの書き方（node:test）

本物の SQLite を作る必要はない。バイト列の部分一致だけが判定なので、ヘッダ風のバイト + "sessionId":"<id>" を含む Buffer を state.vscdb として置けばよい。

fs.writeFileSync(db, Buffer.concat([
  Buffer.from('SQLite format 3\0', 'utf8'), Buffer.alloc(48, 7),
  Buffer.from('"sessionId":"tab-open"', 'utf8'),
]));

• 参照ありの tab-* は全理由で残り、参照なしの free-* は退避される、を --dry-run と実走の両方で assert する。
• globalStorage/state.vscdb をディレクトリとして作ると readFileSync が EISDIR になるので、「読めない DB → 全件見送り」の分岐もテストできる。
• テストの環境変数で DB の探索先を一時ディレクトリに向けること（向けないと実機の DB を読んで flaky になる）。

既に壊れたタブの復旧

1. 退避先から元の場所へ戻す（ファイル名はそのまま。サイドカーのディレクトリ <sessionId>/ があれば一緒に戻す）。
2. 戻した直後に次の退避パスで再び対象にならないよう、復元した ID を一定時間「稼働中」扱いにするか、上のガードを先に入れてから戻す。
3. VSCode 側はタブを一度 ✕ で閉じ、左のセッション一覧から開き直す。赤い帯が出た時に送った最後のメッセージは保存されていないので送り直す。

「退避済みなのに VSCode がまだ参照している ID」の一覧は、退避フォルダの *.jsonl の ID を state.vscdb 群に bytes.find するだけで作れる（Python 10 行）。

副作用と割り切り

• 開きっぱなしのタブは自動では一覧から消えなくなる。一覧の整理は拡張の claudeCode.archiveInactiveSessions に任せるのが筋（開いているものは触らず、再開可能なまま隠す）。
• lastActivationSessionId やターミナル履歴に残る ID も保護されるが、せいぜい数件で実害はない。保護側に倒す方が「再開不能」より安い。