Phase 5 advanced retrieval

~500 memories, 150 labeled queries with lexical and graph subsets — designed to distinguish hybrid retrieval from dense-only. Two labelers, kappa >= 0.8.

Milestone 5.C.1 — Hybrid-Aware Gold Set v2

Status: Planned
Goal: Track C — Evaluation Harness Upgrade
Phase: 5 — Advanced Retrieval
Estimated effort: 4 days
Track: Track C — Evaluation Harness Upgrade


Why This Milestone Exists

Phase 3's gold set only covers dense vector search. Track A added BM25 fusion and reranking, Track B added graph traversal — neither has a regression gate without a purpose-built evaluation corpus. This is the proof that new retrieval modes earn their complexity.


Orientation (indicative)

Named paths, package layouts, libraries, schemas, env vars, and commands anywhere on this page are rough sketches for orientation — inspiration and a baseline, not a required change list.

During implementation, expect to:

  • open the live tree and follow existing patterns before inventing new ones
  • research current constraints (latency, tenancy, deploy shape, libraries) more deeply than this page can
  • advance the design beyond the sketch where measurement or code reality says so
  • land work in different filenames, merged packages, deferred docs, or new surfaces when the situation calls for it

Prefer outcomes over matching any particular file tree or command sequence.

Areas that may be involved (situational — not a checklist):

  • Evaluation / benchmarks
  • Hybrid retrieval

Success signals

Outcome-oriented signals that the milestone is in good shape. Exact filenames, package layouts, and commands may differ from any sketches above.

  • At least 30 queries in lexical_queries.jsonl where dense-only scores measurably worse than hybrid
  • At least 20 queries in graph_queries.jsonl requiring relationship traversal to answer correctly
  • Two independent human labelers; agreement rate ≥0.8 Cohen's kappa documented

Prerequisites

  • Milestone 5.A.2 (RRF operational for baseline comparison)
  • Milestone 5.B.1 (Graph traversal for graph queries)
Edit on GitHub

Last updated on

On this page

0%