Expand description
Signed, portable evidence per ticked task.
After a tick commit, the engine writes an in-toto Bundle as the commit’s
git note (refs/notes/speccoder): a test-result statement per test
phase that ran, one SLSA verification summary and speccoder’s
task-verification, each a DSSE envelope signed with the person’s git
signing key. accept and skip write a task-verification alone. The
model never sees, writes or signs any of it.
Modules§
- dsse
- DSSE envelopes and the in-toto Bundle that holds them.
- notes
- Attestations as git notes under
refs/notes/speccoder: git’s own place for per-commit metadata, outside the commit it describes. - policy
- The judge’s configuration as one hash: the policy a VSA names.
- sign
- Signing statements with the person’s git signing key, as git would:
ssh-keygen -Y signforgpg.format = ssh,gpg --detach-signfor OpenPGP;cosignfor opt-in Sigstore. The namespacein-totokeeps a statement signature from ever passing as a commit signature. - statement
- in-toto Statements v1 for a ticked task:
test-resultper test phase, a SLSA verification summary (vsa), and speccoder’stask-verification. - verify
speccoder attest verify: re-checks every task’s attestation against the commit it is about — signatures with the signer’s own tool, against the verifier’s trust, never the project’s.
Structs§
- Tick
- Everything a tick’s statements are made of besides the run report.
Functions§
- carry
- Moves
from’s statements toto, the commit that carries the same task’s work onto the feature branch (a parallel lane’s commit, cherry-picked):reissue, thenfromloses its note. - cites
- Whether a task title cites requirement
id, as a word of its own. - note_
state - What
object’s note says, signatures unchecked:signed <kind> <keyid>,unsignedormissing. - now_
rfc3339 - RFC 3339 UTC, to the second.
- outcome
- What a tick’s attestation came to, for the run report.
- phases
- The test phases a run report shows.
- record_
decision - Records a person’s decision on a task —
attested(accept) orskipped(skip) — as onetask-verification, no summary: a decision is not a verification. - record_
tick - Records a passed tick:
test-resultper phase,task-verification, then thevsanaming every other line. Never fails the tick. - reissue
- Re-issues
from’s statements forto, a commit with the same task’s work: the subject, tree and resource move toto, the summary names the new lines, and everything is signed afresh. What the evidence says is unchanged. - sign_
all - Signs every envelope that is not signed yet; the first failure’s reason when some stay unsigned.
- sign_at
speccoder attest sign: signs the unsigned speccoder statements of the selected task objects with the configured signer, payloads unchanged.