Browse documentation
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.