qql-protocol 0.5.0

Qdrant REST protocol surface for QQL: closed result IR, strict OpenAPI response parsing, schema and telemetry
Documentation
# qql-protocol

Qdrant REST protocol surface: the closed result IR plus the strict parsers
that turn backend envelopes into it.

## What lives here

- `response` — the closed `ExecData` family (`Hits`, `Groups`, `Count`,
  `Facet`, `Mutation`, `Collections`, `Collection`, `ShardKeys`, `Quotas`),
  scores, and the `ExecResponse` / `ExecutionReport` envelopes.
- `rest` — strict per-operation OpenAPI response parsing. A missing or
  mistyped field fails with `QQL-BACKEND-ENVELOPE`; there is no fallback and
  no raw-JSON passthrough.
- `schema` — collection metadata and the REST schema reader used by `USING`
  resolution.
- `telemetry` — server `time` / `usage` extraction and phase timings.
- `normalize` — pure typed-response → execution-response shaping shared by
  every host.

## Boundaries

No I/O, no networking, no transport clients: this crate only understands the
JSON shapes Qdrant REST emits. `qql-runtime` re-exports the surface so
`qql::executor::*` / `qql::backend::*` stay stable; `qql-wasm` depends on it
directly so browser and native hosts parse identical shapes.