## This repository: Crafter.Graphics

- A claim that a tree passes the test suite, builds for a target, links
  `Win32Link`, builds an example or passes `node --check` traces to the
  Gate 0 log among the evidence paths INPUTS names: each command with its
  exit code and the sha it ran at. A test the log shows as skipped, by
  exit 77 or a missing tool, is not a pass. A claim of a run anywhere else
  (the aarch64 phone target, the Win32 tests under Wine, a named GPU or
  driver version, a browser, Deno's WebGPU, an example run by hand, a
  frame judged by eye) traces to a capture of that run that names the
  commit, or is unverifiable.
- A validation claim ("clean under the validation layer", "no validation
  errors") holds only for a run in which the layer loaded. Read
  `Device::Initialize` at HEAD for what a run with
  `CRAFTER_GRAPHICS_VALIDATION` set does when `VK_LAYER_KHRONOS_validation`
  is not installed: where it creates the instance without the layer and
  says nothing, every validation check passes with nothing seen, and since
  crafter-build prints only the name and time of a passing test, the Gate
  0 log alone does not show that the layer ran.
- A test a message names exists as a `LibraryTest("<Name>")` in
  `project.cpp` and a `tests/<Name>/main.cpp` whose checks pin what the
  message says.
- `AGENTS.md` is generated from `AGENTS.template.md` and the dependencies'
  `AGENTS.consumer.md` and is not in the tree: a claim about it is checked
  against those sources. `AGENTS.consumer.md` reaches consumers' agents on
  their next build: every sentence in it is a claim about the code at the
  commit that writes it.
- A statement of where a driver stands (the NVIDIA notes in `README.md`,
  `examples/VulkanTriangle/README.md`, `examples/Sponza/README.md` and the
  guide's gotchas) names the driver version and traces to a run of the
  probe on it (`HeapASRead --no-workaround`, `HeapDynamicIndexHit`), or is
  unverifiable.
- A size or layout claim about a struct the GPU reads is checked against
  the `static_assert` beside the C++ struct, the `std430` block in
  `shaders/ui-shared.glsl` and the WGSL in `additional/dom-webgpu.js`.