6e45066e37
Some checks failed
Concelier Attestation Tests / attestation-tests (push) Has been cancelled
Policy Simulation / policy-simulate (push) Has been cancelled
AOC Guard CI / aoc-guard (push) Has been cancelled
AOC Guard CI / aoc-verify (push) Has been cancelled
Signals CI & Image / signals-ci (push) Has been cancelled
Signals Reachability Scoring & Events / reachability-smoke (push) Has been cancelled
Signals Reachability Scoring & Events / sign-and-upload (push) Has been cancelled
Docs CI / lint-and-preview (push) Has been cancelled
Policy Lint & Smoke / policy-lint (push) Has been cancelled
Scanner Analyzers / Discover Analyzers (push) Has been cancelled
Scanner Analyzers / Build Analyzers (push) Has been cancelled
Scanner Analyzers / Test Language Analyzers (push) Has been cancelled
Scanner Analyzers / Validate Test Fixtures (push) Has been cancelled
Scanner Analyzers / Verify Deterministic Output (push) Has been cancelled
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# Reachability Evidence Samples
|
|
|
|
This directory contains sample payloads for reachability evidence chain documentation.
|
|
|
|
## Contents
|
|
|
|
| File | Description |
|
|
|------|-------------|
|
|
| `richgraph-v1-sample.json` | Sample richgraph-v1 callgraph with `code_id`, `symbol_id`, and `graph_hash` |
|
|
| `openvex-affected-sample.json` | OpenVEX statement with `stellaops:reachability` extension for affected status |
|
|
| `openvex-not-affected-sample.json` | OpenVEX statement with unreachability evidence for not_affected status |
|
|
| `replay-manifest-v2-sample.json` | Replay manifest v2 with BLAKE3 hashes and `code_id_coverage` |
|
|
| `runtime-facts-sample.ndjson` | Runtime observation events in NDJSON format |
|
|
|
|
## Usage
|
|
|
|
These samples demonstrate the function-level evidence chain described in:
|
|
- `docs/reachability/function-level-evidence.md`
|
|
- `docs/api/signals/reachability-contract.md`
|
|
- `docs/contracts/richgraph-v1.md`
|
|
|
|
## Verification
|
|
|
|
Validate a richgraph-v1 sample:
|
|
|
|
```bash
|
|
# Compute graph hash
|
|
stella graph verify --graph ./richgraph-v1-sample.json
|
|
|
|
# Verify against manifest
|
|
stella replay verify --manifest ./replay-manifest-v2-sample.json --verbose
|
|
```
|
|
|
|
## Schema References
|
|
|
|
- richgraph-v1: `docs/contracts/richgraph-v1.md`
|
|
- OpenVEX: https://openvex.dev/spec/v0.2.0
|
|
- Replay manifest: `docs/reachability/function-level-evidence.md#6-replay-manifest-v2`
|