Skip to content

Interpreting Retrieval Evidence

A retrieval result is meaningful only with the contract, artifact, backend, budget, approximation boundary, and provenance that produced it. A plausible neighbor list without those records cannot establish exactness, replayability, or even that the requested policy was honored.

flowchart LR
    request["request + artifact identity"]
    plan["immutable execution plan"]
    capability["backend capability"]
    execution["scores + budgets + diagnostics"]
    provenance["artifact + provenance"]
    verdict["bounded retrieval claim"]

    request --> plan --> capability --> execution --> provenance --> verdict

Read One Retrieval Verdict

Review question Evidence to inspect Unsafe shortcut
Which corpus and vectors were searched? artifact identity, vector contract, corpus and embedding fingerprints relying on a backend collection name
Which behavior was requested? execution request, determinism class, metric, top_k, filters, budgets inferring policy from returned fields
Why was this backend eligible? capability registry entry and resolved plan treating successful connection as conformance
Was the result exact? exact execution path, stable tie ordering, matching plan and artifact fingerprints assuming deterministic because a seed exists
Was approximation bounded? exact baseline, ANN parameters, randomness record, witness, recall or loss bound reporting latency without quality loss
Is the run complete? result record followed by the complete lifecycle marker accepting an individually valid JSON file
Can it be replayed? retained request, artifact, backend fingerprint, environment and replay policy reconstructing from current backend state

Bounded Retrieval Vocabulary

Claim Required evidence Bound on the claim
deterministic exact retrieval exact-capable backend, stable plan, metric, tie order, and matching fingerprints applies to the recorded artifact and environment
bounded ANN retrieval exact baseline, approximation report, runner parameters, randomness, and budget permits only declared loss and variance
replayable execution retained baseline, artifact identity, backend fingerprint, request, and replay policy must refuse when required identity is unavailable
backend conformance shared CRUD, query, transaction, isolation, and provenance cases does not promise identical rankings across implementations
portable artifact canonical version, migration path, fingerprints, and load test excludes unbundled remote databases and native ANN files
complete run finalized lifecycle with consistent ledger, artifacts, and result individual atomic writes are not a distributed transaction
enforced budget visible refusal or partial classification for measured counters is not an operating-system time or memory limit

Compare Results Without Hiding Drift

A performance or quality comparison binds dataset, vector model, metric, backend and version, construction and query parameters, seed or randomness boundary, dependency versions, hardware, recall or loss measure, and latency measure. If one changes, the comparison describes another execution context.

Score values are meaningful only within their metric and implementation. Cross-backend conformance does not require identical floating-point results or rank order. A faster approximate result with lower recall is a different tradeoff, not an unqualified improvement.

Separate Provenance From Relevance

Provenance establishes how the engine admitted and produced a candidate. It does not establish that upstream vectors represent the domain, the corpus is complete, or the candidate supports a downstream claim. That decision belongs to the evidence and reasoning boundary using the retained candidate identity.

Continue with invariants for enforced execution laws, known limitations for backend and deployment bounds, and the risk register for failure signals and controls.