yoi/.yoi/tickets/00001KXMK846H/item.md

title	state	created_at	updated_at	assignee
StagingからMemory化する審査・剪定フローを実装する	ready	2026-07-16T04:34:07Z	2026-07-16T04:38:21Z	null

背景

現状の staging は extract output の一時保存としては機能しているが、Memory 化前の審査キューとしての情報が弱い。consolidation が成功すると consumed staging は削除されるため、どの staging entry を Memory 化したか、何を捨てたか、なぜ捨てたか、何を Knowledge / Skill candidate に送るべきだったかが machine-readable に残りにくい。

関連:

• Objective 00001KVJSMQXZ
• .yoi/objectives/00001KVJSMQXZ/memory-architecture-overview.md
• .yoi/objectives/00001KVJSMQXZ/resources/pirolli-card-2005-sensemaking.md

実装要件

• staging entry ごとの resolution / disposition 記録を実装する。
  • 初期実装は append-only JSONL などの軽量な形式でよい。
  • consumed staging を削除する場合も、削除前に resolution を残す。
  • invalid staging / failed consolidation は既存挙動を壊さず、可能なら diagnostic resolution を残す。
• disposition action を machine-readable にする。
  • 最低限: discard / merge_memory / replace_memory / mark_memory_stale / delete_memory / defer / promote_to_knowledge_candidate / promote_to_skill_candidate / link_to_authority / create_ticket_or_doc_candidate。
  • 初期実装で全 action を実際に mutate できない場合も、resolution として記録できるようにする。
• consolidation prompt / input / output flow を更新し、staging entry ごとの disposition を要求する。
  • discard reason / defer reason / target record / consolidation run id / consumed_by を記録する。
  • record mutation がない場合でも、なぜ Memory 化しなかったかを resolution に残せるようにする。
• Memory 化条件を prompt と実装上の記録に反映する。
  • future usefulness reason。
  • scope / applicability。
  • source anchors。
  • staleness condition / invalidation condition。
  • なぜ Knowledge / Skill / Ticket / docs ではなく Memory なのか。
  • authoritative records の単なる mirror ではないこと。
• staging からの destination routing を resolution に記録する。
  • Memory。
  • Knowledge candidate。
  • Skill candidate。
  • Ticket/doc candidate。
  • authority link only。
  • discard / defer。
• consolidation / tidy を garden operation として強める。
  • append より merge / replace / mark stale / delete を優先する guidance を prompt に入れる。
  • stale / duplicate / no-scope / no-product-use / authority-duplicate / contradictory records を検出する tidy hints を追加できる範囲で実装する。
• Pirolli & Card の sensemaking flow を implementation note / prompt に反映する。
  • shoebox: Overview + Evidence index + selected candidate ranges。
  • evidence file: source anchors 付き staging entries。
  • schemas/hypotheses: Memory 化すべきか、Knowledge/Skill に送るべきか、stale かの判断。
  • product: Memory update / Knowledge candidate / Skill candidate / Ticket/doc update / discard resolution。

非目標

• staging を長期 Knowledge store にしない。
• staging entry を全て Memory 化しない。
• Memory を Ticket / docs / git / session log の mirror にしない。
• 初期 slice で完全な vector DB や大規模 search infrastructure を実装しない。

受け入れ条件

• consolidation 実行後、staging entry ごとの disposition / resolution が durable に残る。
• consumed staging を削除する前に resolution が記録される。
• discard / merge_memory / replace_memory / mark_memory_stale / delete_memory / defer / promote_to_knowledge_candidate / promote_to_skill_candidate / link_to_authority / create_ticket_or_doc_candidate の少なくとも記録表現がある。
• Memory 化には usefulness / scope / source / staleness / destination reason が求められる。
• Knowledge / Skill / Ticket / docs への routing と、Memory に入れない重要 material の扱いが resolution として表現できる。
• resolution log / archive は staging cleanup と競合せず、consolidation lock / consumed snapshot の既存安全性を壊さない。
• resolution write、consumed cleanup、discard/defer path、no-record-change path の tests が追加または更新されている。
• cargo test -p memory または該当 crate の同等テストが通る。
• code/prompt/resource 変更として nix build .#yoi が通る。