Documentation
¶
Overview ¶
Command verifyrunnerprotocol holds runner.ProtocolVersion to the runner's source.
A plan and its approval bind the runner protocol version, not the runner image, so the version is the only thing that says the runner still enforces what it enforced when a person approved. The rule at the constant is that every change to the runner's side of the contract bumps it. This program makes forgetting that a refusal rather than a review finding: it digests the source the runner is built from and compares it with the record in support/runner-protocol.json. A digest that moved while the version did not is refused, unless the record declares why the change left the contract as it was.
The digest covers the non-test Go files, and the files they embed, of every package in this module that ./cmd/ptah-runner imports, directly or not, for the platform the runner ships on; and the go.sum lines of every other module those packages import. It does not cover the Go toolchain.