Roadmap: make Azazel credible for large Zig build graph replacement
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 1
- Forks
- 0
- Avg merge
- 8m
- Merged PRs (30d)
- 1
Description
Goal
Make Azazel a credible replacement layer for large real Zig build graphs, not just a declarative toy for small examples.
Current evidence
The huge corpus runner has real build proof for:
libxev: builds on Zig 0.16.0libvaxis: builds on Zig 0.16.0zig-gamedev: builds on Zig 0.15.2
The remaining corpus repos are blocked by concrete non-Azazel or missing-feature issues:
zls: supported Zig dev-toolchain windowriver: hostpkg-config/wayland-scannermach: custom Mach Zig toolchainmicrozig: dependency fetch/temp zip failurecapy: transitive package format drift
Roadmap
- Resolve exact/dev/custom Zig toolchains.
- Model package dependencies from
build.zig.zonwell enough to diagnose/fetch/replay them. - Model generated files and run-artifact outputs.
- Model nested workspaces and subproject build packages.
- Add executable parity commands for declared target slices.
- Produce artifact-level proof: built target exists, expected generated outputs exist, tests run when available.
Done when
- At least three corpus repos have an Azazel target slice that builds through Azazel, not only upstream
zig build. tools/huge_corpus.py --build --parityproduces machine-readable results with no false claims.- Documentation clearly distinguishes upstream-build proof from Azazel replacement parity.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with tools/huge_corpus.py and its --build --parity path, using the listed corpus results as the baseline. Review how build.zig.zon dependencies, generated files, run-artifact outputs, and nested workspaces are represented. Done means at least three corpus repositories build through Azazel and the parity command emits machine-readable results without false claims.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python, zig
- Domain
- build-system
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100