Browse documentation

Reference

Test evidence

Outcome, applicability and execution origin in graph receipts.

graph test --evidence records an invocation. code evidence --receipt compares it with current inputs without executing cases.

Scope

graph-evidence/v1 covers scripted in-memory tests: supplied inputs, effect answers, messages, restarts and expected results, state or traces. It excludes UI, live-service, native-driver and deployment behaviour. A receipt grants no runtime authority.

Outcome

Value Meaning
pass The case met its expectation
fail The case did not meet its expectation
error Execution produced no usable case result

Applicability

Value Meaning
applicable Relevant known inputs match the recorded test result, which must not be an execution error
stale A relevant known component changed; the response identifies it
unknown Required provenance/key is unavailable, or execution errored
missing A current case has no recorded result
historical A recorded case is absent from the current suite

An applicable failure remains a failure. An unrelated edit can preserve applicability. A selected-case receipt cannot validate unselected or new cases.

Origin and identity

fresh records execution by the invocation. reused records a historical feedback result. Reuse is not execution against the current bundle.

If the cache did not retain the original bundle or environment, executed_bundle and executed_environment are null. Applicability remains unknown; a fresh run supplies current evidence.

The header identifies the current comparison target. Case execution fields describe what ran, when known. Captured source, case inputs and toolchain identities refer to consumed inputs, not files reread afterward.

Integrity and files

The digest detects accidental alteration. It is not an authenticated attestation or protection against intentional forgery.

Use a new filename for each receipt. Existing files are not overwritten; malformed or corrupted receipts are rejected. Failed results remain failures.

See the tutorial for commands and reviewing a change for their use.

Search concepts, guides and reference.