registrystack / registrystack/registry-stack

Prove bit-for-bit repeatable release builds

Open
#127 1 comment 0 reactions 0 assignees View on GitHub
area:platform criticality:p2 enhancement triage:roadmap
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.