yoi/.yoi/tickets/00001KXRM6G0G/item.md

title	state	created_at	updated_at	assignee	queued_by	queued_at
Flat candidate staging record schemaを実装する	closed	2026-07-17T18:07:40Z	2026-07-17T19:56:08Z	null	yoi ticket	2026-07-17T19:48:08Z

背景

旧 staging は extract run ごとの batch payload (decisions / discussions / attempts / requests) と entry-level source refs を前提にしていた。しかし、consolidation から見ると batch は session に紐づいた不必要な集団になり、record ごとの discard / merge / promote / defer が曖昧になる。

新方針では、extract は記憶化を検討すべき candidate を kind taxonomy に基づいて切り出し、candidate ごとに flat staging record を作る。

1 extract run = 0..N staging records
1 staging record = 1 candidate = 1 consolidation decision unit

旧 batch schema との互換性は不要。clear responsibility と flat records を優先する。

関連:

• Objective 00001KVJSMQXZ
• .yoi/objectives/00001KVJSMQXZ/memory-architecture-overview.md
• Ticket 00001KXMK7YMC — session-explore feature付きextract workerを実装する
• Ticket 00001KXMK846H — StagingからMemory化する審査・剪定フローを実装する

実装要件

• flat staging record schema を実装する。
• 1 file / record は 1 candidate のみを表す。
• candidate kind は次に限定する。
  • preference
  • working_assumption
  • constraint
  • decision
  • open_question
  • lesson
• record は少なくとも次を表現できる。
  • schema_version
  • id
  • extract_run_id
  • record-level source
  • kind
  • claim
  • why_useful
  • staleness / invalidation hint
  • bounded evidence[]
  • source_refs[]
• evidence は extract が選んだ bounded snippets のみを保持する。
  • raw session log 全体や Overview 全体は保存しない。
  • raw tool result 全文は保存しない。
• source_refs は evidence id / evidence kind / entry range など host-resolved anchor を保持する。
• extract run ごとの batch payload を staging record として保存しない。
• consolidation input は flat records を record ごとに列挙する。
• 旧 batch schema の読み込み互換は不要。

非目標

• session-explore feature / tools はこの Ticket では実装しない。
• stage_candidate / finish_extraction tool はこの Ticket では実装しない。
• staging resolution / disposition はこの Ticket では実装しない。
• Overview projection を staging に保存しない。

受け入れ条件

• flat candidate staging record を serialize / deserialize できる。
• 1 staging file が 1 candidate だけを表す。
• candidate kind が上記 taxonomy に制限されている。
• bounded evidence snippets と source refs を保持できる。
• raw session log / Overview 全体 / raw tool result 全文を schema が要求しない。
• consolidation input が flat records を candidate 単位で表示できる。
• relevant tests が追加または更新されている。
• cargo test -p memory または該当 crate の同等テストが通る。
• code 変更として nix build .#yoi が通る。