History

This section preserves the project's design and engineering history.

Sub-sections

• Design decisions — short ADRs (Architecture Decision Records) capturing the why of major architectural choices. Each ADR links back to its source engineering note.
• Implementation plans — still-open work tracked from engineering notes. Move to historical-notes/ when complete.
• Historical notes — original dated engineering notes, preserved verbatim.

Index of ADRs

• ADR-001 — Two-phase manifest publish
• ADR-002 — Categorical CEL routing
• ADR-003 — Run registry for deferred cleanup
• ADR-004 — Consistent writer retry
• ADR-005 — Sharded vector search
• ADR-006 — LanceDB as vector backend

Open implementation plans

• Reliable loser cleanup
• Test coverage gap closure

Reorganization

The docs were reorganized in 2026-04-21 from a concept-first layout into a use-case-driven layout. See reorg-notes.md for what moved where.