ToolOutput.referenced_files: ツールが参照したファイルの追跡

背景

Compact 実行時、「タスク続行に必要なファイル」を compact worker に提示するためのデフォルトリファレンス（過去に読み書きされたファイル一覧）が必要。 builtin-tools は実装済みだが、Pod 側でファイル操作を追跡する口がない。

ツール名ベースのヒューリスティック検出（"read" / "edit" / "write" の名前で判別）は脆弱でユーザー定義ツールに対応できない。各ツールが自己申告する形にする。

方針

ToolOutput に optional な referenced_files: Vec<PathBuf> を追加し、ツール自身が「この実行で触ったファイル」を申告する。Pod の HookInterceptor::post_tool_call で観察し、Pod 内の LRU 的な履歴に積む。Compact 時はその履歴から先頭 N 件を compact worker のデフォルトリファレンスとして渡す。

実装

llm-worker: ToolOutput 拡張

pub struct ToolOutput {
    pub summary: String,
    pub content: Option<String>,
    pub referenced_files: Vec<PathBuf>,  // NEW. 空なら未申告
}

From<String> 実装では空の Vec を入れる
既存のツール実装は変更不要（デフォルトで空）
ToolResultInfo （post_tool_call Hook が受ける型）にも伝播させて Pod から見えるようにする

builtin-tools: 各ツールで埋める

既に実装済みの以下のツールに referenced_files を埋める変更を入れる:

ツール	申告するファイル
Read	読んだファイルパス
Write	書いたファイルパス
Edit	編集したファイルパス
Glob	（積極的には埋めない — マッチしたファイル全部は多すぎる）
Grep	（同上）
Bash	（不可能。空のまま）

Glob/Grep は「発見」しかしていないので referenced とは扱わない。

Pod: 追跡と取り出し

Pod 内に履歴バッファ:

referenced_files: VecDeque<PathBuf>,  // 最新 N 件, 重複排除

HookInterceptor::post_tool_call で ToolResultInfo.referenced_files を受け取り、既存エントリを先頭に移動 or 新規追加（LRU 的な挙動）
容量上限（例: 20）を超えたら末尾を落とす
Compact 開始時に先頭 5 件を取り出して compact worker に渡す

設計ポイント

ツールが自己申告: 外部から名前で判別しない。拡張性のため
Vec なので 0〜複数件: 複数ファイルに触るツール (例: 大量置換) にも対応
空 Vec 許容: Bash や Glob のような「追跡不能 or 不適切」なツールはそのまま空
Pod が LRU バッファを持つ: Compact 時の抽出を O(1) に近づける。Worker 層は関知しない

依存

builtin-tools が実装済み前提（チケット: builtin-tools.md 完了後）

ブロックする後続

compact-improvements.md — デフォルトリファレンスの抽出がこのフィールドに依存

3.2 KiB Raw Blame History Unescape Escape