# Claude Code の会話ログを自動退避しても VSCode のタブを壊さない（state.vscdb で「まだ開いているセッション」を検出する） ## この指示書が解く問題 Claude Code のセッション一覧を自動で整理するために `~/.claude/projects//.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 ` の not_found。拡張はタブ・ブックマーク・UI でアーカイブしたセッションの ID を **VSCode の状態DB（SQLite）に平文で持ち続ける**ので、ファイルだけ動かすと「一覧には残るのに中身が無い」状態になる。 拡張自身の自動アーカイブ設定 `claudeCode.archiveInactiveSessions` は「開いている・実行中・入力待ち・未読のセッションは絶対に対象にしない」と明記している。 自作の退避スクリプトも同じ原則に揃えればよい。 ## 拡張がセッション ID を持っている場所（実測: 拡張 2.1.x） | ファイル | キー | 中身 | |---|---|---| | `/workspaceStorage//state.vscdb` | `memento/workbench.parts.editor` | 開いているエディタ（タブ）のシリアライズ。セッション ID を含む | | 同上 | `Anthropic.claude-code` | `panelTabSessions[].sessionId`（パネルのタブ）、`bookmarkedSessions[]` | | `/globalStorage/state.vscdb` | `Anthropic.claude-code` | `hiddenSessionIds[]`（UI でアーカイブ済み。「Archived sessions」から再開できる） | `` は 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） ```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":""` を含む Buffer を `state.vscdb` として置けばよい。 ```js 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. 退避先から元の場所へ戻す（ファイル名はそのまま。サイドカーのディレクトリ `/` があれば一緒に戻す）。 2. 戻した直後に次の退避パスで再び対象にならないよう、復元した ID を一定時間「稼働中」扱いにするか、上のガードを先に入れてから戻す。 3. VSCode 側はタブを一度 ✕ で閉じ、左のセッション一覧から開き直す。赤い帯が出た時に送った最後のメッセージは保存されていないので送り直す。 「退避済みなのに VSCode がまだ参照している ID」の一覧は、退避フォルダの `*.jsonl` の ID を state.vscdb 群に `bytes.find` するだけで作れる（Python 10 行）。 ## 副作用と割り切り - 開きっぱなしのタブは自動では一覧から消えなくなる。一覧の整理は拡張の `claudeCode.archiveInactiveSessions` に任せるのが筋（開いているものは触らず、再開可能なまま隠す）。 - `lastActivationSessionId` やターミナル履歴に残る ID も保護されるが、せいぜい数件で実害はない。保護側に倒す方が「再開不能」より安い。 ---