ctx-purge

Context Mode の消去

このプロジェクトのセッションデータを完全に削除します。次の 2 つのスコープをサポートしています（issue #520）。

• プロジェクトスコープ（scope: "project"）：すべてを消去します。ナレッジベース、全セッションのすべてのセッション DB 行、イベントのマークダウン、統計情報が対象です。
• セッションスコープ（sessionId: "<id>" または scope: "session"）：該当するセッションの行と FTS5 チャンクのみを消去します。ほかのセッション、プロジェクト統計情報、FTS5 ストアファイルは保持されます。

手順

1. 最初にユーザーとスコープを決めます：
   • 「1 つのセッションだけを消去しますか？」→ sessionId を確認します。
   • 「プロジェクト全体を消去しますか？」→ scope:'project' を確認します（これは破壊的で、取り消せないデフォルトです）。
2. scope:'project' の影響についてユーザーに警告します。次のすべてが削除されます：
   • FTS5 ナレッジベース（ctx_index、ctx_fetch_and_index、ctx_batch_execute によってインデックス化されたすべてのコンテンツ）
   • プロジェクト内のすべてのセッションのセッションイベント DB（分析データ、メタデータ、再開用スナップショット）
   • セッションイベントのマークダウンファイル
   • メモリ内のセッション統計情報と永続化された統計ファイル
3. 選択したパラメーターで mcp__context-mode__ctx_purge MCP ツールを呼び出します：
   • スコープ指定：{ confirm: true, sessionId: "<id>" } — scope:'session' を意味します。
   • プロジェクト：{ confirm: true, scope: "project" } — 破壊的操作を明示する形式です。
   • { confirm: true } のみでも引き続き動作しますが、非推奨の警告が出ます。明示的な形式を推奨します。
4. 結果をユーザーに報告します。応答には、削除された項目の一覧と（スコープを指定した消去の場合は）ほかのセッションとプロジェクト統計情報が保持されたことが正確に示されます。

スキーマのルール

• confirm: true は常に必須です。
• sessionId と scope: "project" を同時に指定すると、曖昧なため拒否されます（sessionId はセッションスコープを意味し、プロジェクトスコープとの併用は意図に矛盾します）。
• sessionId なしで scope: "session" を指定するとエラーになります。sessionId は必須です。

使用する場面

• スコープ指定（セッション単位）：一時的な受け入れシナリオ、ドリルの再生、メインの作業セッションの統計情報を失わずに汚染されたセッションを切り分ける場合。
• プロジェクト：ナレッジベースに古い、または誤ったコンテンツが含まれていて検索結果に影響している場合、同じセッション内で無関係なプロジェクトを切り替える場合、完全に新しい状態から始める場合。

重要

• セッションデータを削除する方法は ctx_purge のみです。ほかに方法はありません。
• ctx_stats は読み取り専用で、統計情報のみを表示します。
• /clear と /compact は、context-mode のデータに影響しません。
• 元に戻すことはできません。再び必要な場合は、コンテンツを再インデックス化してください。