Build-Time Reduction Program
Build-Time Reduction Program
Section titled “Build-Time Reduction Program”Instruments
Section titled “Instruments”vox ci build-bench— runscontracts/ci/build-bench-scenarios.v1.json, writes a snapshot, and--compares againstcontracts/ci/build-bench-baseline.v1.jsonto emit a per-scenario delta. Cumulative report:graphify-out/build-bench/REPORT.md.vox ci dep-cycles— Tarjan SCC overcargo metadata. HARD-fails on normal-dependency cycles; inventories dev-dep back-edges tographify-out/DEP_CYCLES.md. (Fills the gap thatvox-arch-checkdoes only pairwise layer-ordering with no cycle detection.)scripts/crate-build-audit.vox— the dependency/blast-radius map (fan-in, LoC, self-time) →graphify-out/crate_audit.json+CRATE_BUILD_AUDIT.md.
Refreshing the baseline
Section titled “Refreshing the baseline”After an intentional, accepted change to build cost, regenerate:
cargo check --workspace # warm the cache firstvox ci build-bench --label baseline --write contracts/ci/build-bench-baseline.v1.json --repeat 3git add contracts/ci/build-bench-baseline.v1.jsongit commit -m "chore(ci): refresh build-bench baseline"Adding or removing a scenario means editing build-bench-scenarios.v1.json and regenerating the baseline in the same PR.
Selective CI + soundness backstop
Section titled “Selective CI + soundness backstop”PR-time selective CI (PR #348) builds only affected crates on PRs; the merge-queue gate and nightly run the full --workspace. No build-time optimization here weakens that backstop.
Historical log
Section titled “Historical log”See docs/src/architecture/build-time-log.md for the measured phase-by-phase deltas.