Stable machine-readable --json sizing contract for CI/arbitrage consumption #25

New Issue

2026-07-11T10:59:45+03:00

admin commented

2026-07-11 10:59:45 +03:00

Why: builder-arbitrage will consume nix-estimator sizing output to right-size EphemeralBuilder nodes per job. Schema must be stable, versioned, carrying all fields needed for provisioner SKU selection.

Scope: Ensure nix-estimate --json emits stable, versioned schema carrying:

arch: target architecture (x86_64, aarch64, …)
nodes: recommended number of builder nodes
cores: cores per node (or total cores)
ram_gb: RAM budget for build
core_scaling (Amdahl factor from #4, if computed)
Any other fields decider needs for SKU selection

Acceptance:

Schema documented and versioned (e.g., v1.0 in JSON output)
Parser on builder-arbitrage side reliably consumes output
Accuracy improvements from #4 (core_scaling), #13/#15 (RAM budget) integrated into schema
JSON is canonical machine-readable format (no text parsing)

Links: Blocks oleks/builder-arbitrage estimate-consumer issues, oleks/builder-arbitrage#268, references oleks/nix-estimator#4, #13, #15

**Why**: builder-arbitrage will consume nix-estimator sizing output to right-size EphemeralBuilder nodes per job. Schema must be stable, versioned, carrying all fields needed for provisioner SKU selection. **Scope**: Ensure `nix-estimate --json` emits stable, versioned schema carrying: - arch: target architecture (x86_64, aarch64, …) - nodes: recommended number of builder nodes - cores: cores per node (or total cores) - ram_gb: RAM budget for build - core_scaling (Amdahl factor from #4, if computed) - Any other fields decider needs for SKU selection **Acceptance**: - [ ] Schema documented and versioned (e.g., v1.0 in JSON output) - [ ] Parser on builder-arbitrage side reliably consumes output - [ ] Accuracy improvements from #4 (core_scaling), #13/#15 (RAM budget) integrated into schema - [ ] JSON is canonical machine-readable format (no text parsing) **Links**: Blocks oleks/builder-arbitrage estimate-consumer issues, oleks/builder-arbitrage#268, references oleks/nix-estimator#4, #13, #15

admin added the p1 label 2026-07-11 10:59:45 +03:00

oleks referenced this issue from a commit

2026-07-12 22:11:21 +03:00

Add versioned --json sizing block and on-demand CI window to --provision (oleks/nix-estimator#25)

oleks referenced this issue from a commit

2026-07-12 22:11:31 +03:00

test(ci): estimator-driven on-demand CI chain proven with fakes (#268/#275, oleks/nix-estimator#25)

Sign in to join this conversation.