Phase 7 unified query: four-tier router + fused ranker over the substrate
Path parameters
Spectron context id
Request body
Phase 11.5 — historical query timestamp (known time). When set the retrieval path walks the supersession chain to surface the row that was current as-of this instant.
Phase 11.5 — system-time query. Prepends VERSION d'…' to the underlying SELECT so SurrealDB MVCC returns the substrate state at the supplied instant.
Phase 7 — which families of result to include. Defaults to ["facts", "passages"] (both). Pass either alone to scope the response.
When false (the default), document chunks and memory turns flagged as near-duplicates of an older row are excluded from the fused ranker's recall so the same text does not occupy several ranks. Set true to include them (parity with the documents /query opt-in).
Max hits to return (default 10, max 50).
Label filter (design §4): key=value strings the result rows must all carry. Applied after the scope predicate — labels never widen access, only narrow the already-authorised result set. Empty = no label filter.
Retrieval mode hint. The default is Hybrid, which engages the full fused ranker. The other modes are kept as escape hatches so callers can debug a single signal in isolation.
Scope read breadth: strict (default) | merged | crossTeam. Only strict is enforced pre-launch; merged / crossTeam are accepted and behave as strict until their region logic ships (design §7.1).
Phase 7 — free-form source label. Recorded on the trace for audit replay; doesn't affect retrieval today.
Phase 11.5 — valid-time (world-time) lower bound. Filters rows whose valid_from is ≥ this timestamp.
Phase 11.5 — valid-time (world-time) upper bound. Filters rows whose valid_until is ≤ this timestamp.
Response
What kind of question the query represents. Drives tier selection.
Which tier resolved the query. Exposed on the response for the CLI's --tier flag (Phase 8) and so callers can tell when their query went all the way to tier 4.