v1
latestOpenAPI 3.1.0BUSL-1.12026-07-1756132288.0 KBPhase 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), chunks flagged as near-duplicates of an older chunk are excluded from the fused ranker's chunk 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.