Hare/yoi
1
1
Fork 0
Code Actions Packages Releases Activity
444e6bee42
yoi/.yoi/tickets/00001KXMK7YMC/item.md

9.2 KiB
Raw Blame History

title state created_at updated_at assignee
session-explore feature付きextract workerを実装する planning 2026-07-16T04:34:01Z 2026-07-17T18:10:00Z 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:

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:

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 が通る。