CI Reproducibility Contract

Short reproducibility contract for local CI gates. Canonical source: this runbook in angarabook/src/operations/.

Goal

Make CI gates reproducible in a clean local environment to reduce bus factor.

Pinned entrypoint:

• tools/ci_pr.sh

Must

• The script explicitly reports required tools.
• Runs are deterministic where possible.
• Artifacts are saved to stable paths under artifacts/.
• All key gates are available through a single entrypoint.

Should

• Have a container/dev-env run option.
• Add an advisory/license gate (cargo-deny and analogs) when network policy allows it.

Non-goals

• Hard binding to a specific CI provider.
• Identical perf metrics across different machines.

Dogfooding linkage (pilot)

Practical cycle: deploy -> smoke -> workload -> observe -> backup/restore rehearsal -> triage.

Pinned evidence paths (legacy surface):

• docs/planning/evidence/archive/legacy-root-20260417/pilot/latest.md
• docs/planning/evidence/archive/legacy-root-20260417/pilot/report_v0.md

Next

• Testing and validation baseline — which scenarios must be reproducible under this contract.
• Golden dataset management — how fixture versions are pinned for reproducibility.