registrystack / registrystack/registry-stack
Prove bit-for-bit repeatable release builds
- Dominant language
- Rust
- Stars
- 2
- Forks
- 0
- Avg merge
- 2h 55m
- Merged PRs (30d)
- 130
Description
## Context
OpenSSF Best Practices silver criterion `build_repeatable` requires being able to regenerate information from source files and get exactly the same bit-for-bit result.
`origin/main` documents a repeatable-build policy and the release workflow pins source refs, a builder image, and locked dependencies, but the project does not yet publish evidence that an independent rebuild of release outputs produces byte-identical artifacts.
## Scope
- Define which release outputs are in scope for bit-for-bit rebuild verification.
- Add or document a rebuild procedure that starts from the release tag and lockfiles.
- Compare rebuilt outputs against published release artifacts or recorded SHA256 manifests.
- Capture public evidence that the process succeeds, or document any remaining non-determinism.
- Update the Best Practices submission and public docs once the proof exists.
## Done when
- A release can be rebuilt from source and produce byte-identical outputs for the agreed scope.
- The verification procedure is public and repeatable by an external reviewer.
- Any exclusions are documented clearly.
## Non-goals
- Do not claim full reproducibility based only on pinned dependencies or release workflow policy.
Contributor guide
Research direction
Start with the release workflow, release tags, and lockfiles to determine the release outputs currently produced. Define the agreed verification scope, then compare an independent rebuild with published artifacts or recorded SHA256 manifests. Done means the public procedure can reproduce byte-identical outputs or clearly documents exclusions and remaining non-determinism.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- build-system, documentation, release
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100