--- title: 'session-explore feature付きextract workerを実装する' state: 'planning' created_at: '2026-07-16T04:34:01Z' updated_at: '2026-07-17T18:10:00Z' assignee: null --- ## 背景 Overview-first extract では、extract worker が開始時点の会話 snapshot と filtered Overview projection を参照し、必要な evidence だけを探索して staging candidate を出す。main Worker の tool surface は増やさず、extract worker だけに session exploration 用の read-only tools と staging output tools を与える。 新方針では、extract run ごとの batch payload は使わない。extract worker は candidate ごとに `stage_candidate` を呼び、flat staging record を 1 件ずつ作る。出すべき candidate がない場合は `finish_extraction` で NOP reason を残す。 この Ticket は worker 実装を扱う。先に Ticket `00001KXRM6G0G` で flat candidate staging record schema を実装する。 関連: - Objective `00001KVJSMQXZ` - `.yoi/objectives/00001KVJSMQXZ/memory-architecture-overview.md` - Ticket `00001KXMEZNYC` — ターン中のProgress messageを残す指示を追加する - Ticket `00001KXRM6G0G` — Flat candidate staging record schemaを実装する ## 実装意図 この Ticket の目的は、extract worker に「何が起きたか」を flat log から推測させるのではなく、開始時点の immutable reference environment を探索させることである。 Reference environment: ```text Conversation snapshot at extract start - extract 対象 history / segment range の immutable copy - message entries - tool call summaries - tool result summaries / bounded excerpts - evidence id -> source anchor table Filtered Overview projection - User messages - Assistant text outputs, including Progress messages and final responses - committed task context - evidence ids への bounded index ``` Extract worker: ```text Overview を読む -> important candidate を見つける -> session-explore tools で evidence を確認する -> stage_candidate(kind, claim, why_useful, staleness, evidence_ids) を候補ごとに呼ぶ -> 最後に finish_extraction(staged_count, reason) を呼ぶ ``` この変更で目指す改善は recall をむやみに増やすことではない。断片的な activity log を減らし、Consolidation が単体で解決できる最小 candidate record を staging に出す precision 改善を優先する。 ## 対象領域 主な対象: - `crates/worker/src/feature.rs` - `builtin:session-explore` feature descriptor / contribution registration の追加候補。 - `crates/memory/src/extract/input.rs` - Overview-first / Evidence-index-second rendering。 - Conversation snapshot / filtered Overview projection の入力作成。 - `crates/memory/src/extract/tool.rs` または隣接 module - `search_evidence` / `read_evidence` / `stage_candidate` / `finish_extraction` を実装。 - `crates/memory/src/extract/payload.rs` - Ticket `00001KXRM6G0G` の flat staging record schema を利用。 - `crates/memory/src/extract/staging.rs` - candidate ごとの staging write。 - `crates/worker/src/worker.rs` - `run_extract_once` / extract worker 起動。 - extract worker 用 ToolRegistry / enabled feature set の構築。 - `resources/prompts/internal/memory_extract_system.md` - candidate taxonomy / evidence-confirmation / `stage_candidate` / `finish_extraction` 前提へ更新。 ## 実装方針 ### 1. Reference environment を extract 開始時点で固定する extract worker は live Worker state を自由に読むのではなく、extract 開始時点で host が作った immutable reference environment に接続する。 含めるもの: - source range / segment id。 - Overview projection。 - Evidence index。 - evidence id -> anchor / summary / bounded excerpt table。 含めないもの: - raw reasoning / chain-of-thought。 - unbounded raw tool result content。 - history に commit されていない hidden context injection。 - mutable live Worker state への直接 access。 ### 2. `session-explore` feature を作る `session-explore` は extract worker 専用の built-in feature とする。 Feature の tool surface: - `search_evidence` - query / optional kind / optional limit で Evidence index を検索する。 - output は evidence ids、entry ranges、short summaries、source anchors。 - `read_evidence` - evidence id または entry range を読む。 - output は bounded message/tool summary/excerpt と source anchor。 - `stage_candidate` - 1 candidate を flat staging record として保存する。 - input は `kind`, `claim`, `why_useful`, optional `staleness`, `evidence_ids`。 - host が evidence ids を source anchors / bounded snippets に解決する。 - `finish_extraction` - staged count と completion reason / NOP reason を記録する。 制約: - evidence access は read-only。 - `stage_candidate` は staging write だけであり、Memory / Knowledge / Skill / Ticket / docs を mutate しない。 - main Worker の通常 tool surface には出さない。 - extract worker の enabled feature set は `session-explore` のみにする。 ### 3. Extract worker は専用 Worker / Engine として起動する 既存の memory extract sub-engine 起動を、`session-explore` feature のみ有効な worker-like environment に寄せる。 要件: - foreground Worker history を汚染しない。 - extract prompt / harness messages は canonical foreground history に混ざらない。 - output は `stage_candidate` / `finish_extraction` 経由で host context に戻す。 - empty / NOP は正常結果。 - worker が evidence tools と staging output tools 以外の通常 workspace tools を見ないことを test する。 ### 4. Trigger は現行 post-run threshold を維持する 初期実装では既存の post-run trigger を維持する。Worker run cycle が完了してから threshold を判定し、超えていれば extract を発火する。LLM call ごと、または Run 中の途中では発火しない。 この Ticket の中心は scheduler ではなく、extract worker の参照環境、tool surface、flat staging output である。mid-run trigger や Overview accumulation trigger は別 Ticket に分ける。 ## 実装要件 - extract 開始時点の conversation snapshot と filtered Overview projection を保持する reference environment を実装する。 - `builtin:session-explore` feature を追加する。 - extract worker は `session-explore` feature のみ有効な Worker / ToolRegistry として起動する。 - `session-explore` feature に bounded read-only evidence tools を実装する。 - `stage_candidate` と `finish_extraction` を output tools として実装する。 - `stage_candidate` は 1 call = 1 flat staging record を書く。 - `finish_extraction` は 0 件 NOP を正常終了として表現できる。 - `build_extract_input` 相当の入力を Overview-first / Evidence-index-second に変更する。 - extract worker は Ticket `00001KXRM6G0G` の flat staging record schema を使って staging records を出す。 - extract worker は Memory / Knowledge / Skill / Ticket / docs を直接変更しない。 - main Worker の model-visible tool surface は増やさない。 - raw tool result content 全文を無制限に extract prompt / tool output / staging record へ流さない。 - `memory_extract_system.md` を candidate taxonomy / session-explore / evidence-confirmation / `stage_candidate` 前提に更新する。 ## 非目標 - flat staging record schema の実装はこの Ticket では行わない。Ticket `00001KXRM6G0G` が先行する。 - staging -> Memory disposition / resolution flow はこの Ticket では実装しない。Ticket `00001KXMK846H` の対象。 - 専用 Progress Tool を main Worker に追加しない。 - Knowledge / Skill / docs を extract worker が直接 rewrite しない。 - 大規模な mid-run extraction scheduler はこの Ticket では作らない。 - 旧 batch staging schema との互換性維持を目的にしない。 ## 受け入れ条件 - extract 開始時点の immutable reference environment が作られる。 - filtered Overview projection が User messages / Assistant text outputs / committed task context から作られる。 - `builtin:session-explore` feature が存在し、extract worker にだけ有効化される。 - extract worker が `session-explore` の read-only evidence tools と `stage_candidate` / `finish_extraction` だけを使える。 - `stage_candidate` 1 call が 1 flat staging record を作る。 - candidate がない場合、`finish_extraction` で staged_count=0 / NOP reason を記録できる。 - main Worker の model-visible tool surface が増えていない。 - extract output は staging にだけ書かれ、Memory / Knowledge / Skill への direct write がない。 - empty / no-candidate path が正常終了として扱われる。 - Overview rendering、reference environment immutability、feature-gated tool registry、evidence tool bounds、stage_candidate output の tests が追加または更新されている。 - `cargo test -p memory` と関連 worker tests、または該当 crate の同等テストが通る。 - prompt/resource/code 変更として `nix build .#yoi` が通る。