📝 Decide the v0.1.6 embedded vector recall phase: service-free candidate recall on Qdrant Edge with a truthful completeness verdict and a five-field record - #72

Draft

ebigunso wants to merge 44 commits into

mainfrom

plan/v0-1-6-embedded-vector-recall

Commits on Sep 3, 2026

📝 Carry the v0.1.6 embedded vector recall draft onto the planning branch

ebigunso
and
claude
committed
92856c3
📝 v0.1.6 embedded vector recall: decisions ADR-I-0023..0026, phase document rewrite, roadmap section, harness plan

ebigunso
and
claude
committed
9828e03
📝 Review fixes: ADR-I-0023 adds a mode and supersedes nothing; schema-version ruling in the plan; manifest wording; dated Record Shape; roadmap wording on the service default

ebigunso
and
claude
committed
f225b25
📝 Remove the untracked orchestrator handoff note that a broad add swept into the branch

ebigunso
and
claude
committed
6b0b32d
📝 Review fixes round 2: query normalised once before dot-product scoring with a non-unit parity fixture; vector-only baseline issues one singleton-scoped traced retrieval per kind

ebigunso
and
claude
committed
f72f527
📝 Review fixes round 3: not-requested verdict for a zero limit; zero-norm records rejected at indexing; schema version checked at reopen; per-kind baseline limit multiplied by surfaces per object w…

ebigunso
and
claude
committed
55ade14
📝 Review fixes round 4: zero-norm rejection owned by the read-contract task; exhaustive verdict only for issued searches

ebigunso
and
claude
committed
4557d9f
📝 Evaluation-harness work leaves the library records: plan drops the two eval-side tasks; phase doc and ADR-I-0026 state only the library-facing contract; tracking-split rule added

ebigunso
and
claude
committed
e7639ef
📝 Review fixes round 6: library-only scope and completion clauses; database cheat sheet and README owned by the read-contract task; rules freshness date

ebigunso
and
claude
committed
f72fab4
📝 Review fixes round 7: collection-name path-confinement contract; audit task owns the plan file; ADR-I-0001's graph URI clause partially superseded with reciprocal frontmatter

ebigunso
and
claude
committed
9a29b78
📝 Review fixes round 8: path-confinement and blocking-worker scan in the adapter task; ADR-I-0001 listed among the superseded records

ebigunso
and
claude
committed
bbde39e
📝 Review fixes round 9: portable lowercase collection-name allowlist with reserved-name rejection; path setting required in embedded mode; unsupported-schema reopen test; workflow glob

ebigunso
and
claude
committed
cd52fa0
📝 Technology ruling: the embedded vector store is Qdrant Edge; ADR-I-0023 rewritten and renamed, phase document, plan, and roadmap aligned; Decision Log entry

ebigunso
and
claude
committed
fdf375c
📝 Review fixes round 10: empty scope reports the not-requested verdict; service-adapter non-goal qualified by the shared contracts; toolchain prerequisite recorded as landed

ebigunso
and
claude
committed
8ecd1e6
📝 Review fixes round 11: cross-repository coordination gate for exhaustively converted vocabularies; fake retirement opens a temporary shard directory; ADR-I-0026 keeps only the library-facing cont…

ebigunso
and
claude
committed
4aeb63a
📝 Review fixes round 12: explicit shard close on a blocking worker; max surfaces per kind published as public policy; surface-enum consolidation ownership; schema-version exception in the record in…

ebigunso
and
claude
committed
9fd1cf3
📝 Review fixes round 13: empty-scope change named as intended wherever service-mode behavior is claimed unchanged; zero-norm query rule and shard close carried into acceptance and validation; polic…

ebigunso
and
claude
committed
61dd723
📝 Review fixes round 14: verdict enum wire shape recorded (internally tagged, snake_case); policy-value export named where public additions are summarised; roadmap row says five-field record with p…

ebigunso
and
claude
committed
ff92faf
📝 Review fixes round 15: keyword indexes on object id and object type (deletion stays index-backed at scale); lockfile and graph-schema note owned by their tasks; payload note's third design rule m…

ebigunso
and
claude
committed
8c847b7
📝 Review fixes round 16: dedicated blocking owner holds the shard and runs every engine call including writes and shutdown; facade drop reaches it without a new port or facade method; count-indepen…

ebigunso
and
claude
committed
8b45659
📝 Review fixes round 17: non-blocking drop made safe by write-ahead durability and a lock-aware constructor, proven by close-then-reopen; parity criterion bounded by indexing thresholds; evaluation…

ebigunso
and
claude
committed
8e7f3e0
📝 Review fixes round 18: exhaustive verdict means full scoring and a determinate top-K, never a full return; package version bump owned by closeout; library plan keeps only a notification duty towa…

ebigunso
and
claude
committed
e838bdd
📝 Review fixes round 19: boundary verdicts describe the index's returned prefix, not global recall; only the exhaustive verdict asserts population-level determinacy; no exact-search requirement on …

ebigunso
and
claude
committed
5e7dee8
📝 Review fixes round 20: evaluation-facing wording distinguishes exhaustive determinacy from prefix closure; valid clippy invocation in Task_3; roadmap non-goal scoped to non-empty scopes

ebigunso
and
claude
committed
6dc7b65
📝 Review fixes round 21: exhaustive verdict requires an unindexed shard plus a closed cutoff cohort with scanned taken from a filtered scope count, so every exact scan is classified truthfully

ebigunso
and
claude
committed
9fac10e
📝 Review fixes round 22: the embedded adapter flushes after every write and acknowledges only then, because the pinned engine persists only on flush and does not replay its log on load (measured: w…

ebigunso
and
claude
committed
ee2d48f
📝 Review fixes round 23: shard open/load with lock backoff, payload index creation, and the filtered scope count also run on the blocking owner, which opens the shard itself; construction and reope…

ebigunso
and
claude
committed
ac81ce1
📝 Decide the embedded default in ADR-I-0023, split engine discipline into ADR-I-0027, and narrow ADR-I-0024 to the completeness verdict and the prefilter rule

ebigunso
and
claude
committed
d756c5d
📝 Review fixes round 24: Task_2 extracts the tie-closure loop into a shared crate-visible module it owns, so Task_4 reuses it without crossing ownership

ebigunso
and
claude
committed
12497f7
📝 Review fixes round 25: plan metadata date, ADR-I-0003 relationship stated exactly, and the match-or-unknown failure described truthfully in ADR-I-0024

ebigunso
and
claude
committed
83bd885
📝 Make the five v0.1.6 decision records read the same at any time: change-relative and phase-relative wording replaced by standing statements

ebigunso
and
claude
committed
df11e00
📝 Decision log: the phase merges as one change; waves land against the planning branch

ebigunso
and
claude
committed
22d5a5a
📝 Review fixes round 26: canary pins pre-flush non-persistence in the plan and phase document, documentation ownership corrected to Task_4, and ADR-I-0024 requires a fully populated column before a…

ebigunso
and
claude
committed
514bea5
📝 Review fixes round 27: zero-norm rules restored to ADR-I-0024 and carved out of the service-mode non-goal; directory lock pinned throughout ADR-I-0027

ebigunso
and
claude
committed
013a6d9
📝 Plan approved for implementation; wave PRs target the planning branch

ebigunso
and
claude
committed
7b5d9ed
📝 Decision records: authoring rules ruled during the v0.1.6 review

ebigunso
and
claude
committed
586374b
📝 Rule: PR titles state the outcome, contents go in the body

ebigunso
and
claude
committed
677dd74
📝 Rule: wave PRs are registered as a GitHub stack on the planning PR

ebigunso
and
claude
committed
af5c89f
📝 Progress log: wave 1 approved and stacked; wave 2 dispatched

ebigunso
and
claude
committed
e1a8a7d
📝 Lesson: reconcile the companion pin before filing cross-repository breakage

ebigunso
and
claude
committed
6ac2bef
📝 Progress log: wave 2 approved and stacked

ebigunso
and
claude
committed
55dca32
📝 Lesson: PR watchers must not depend on tools absent from the monitor shell

ebigunso
and
claude
committed
c398739
📝 Merge shape: the whole stack merges in one go at phase end

ebigunso
and
claude
committed
67aef4e
📝 Lessons: absolute worktree paths; broad suites only after the live window is granted

ebigunso
and
claude
committed
106b3c0