Summary
- Validate the PATH Zig or explicit
CRAFT_ZIGagainst the exact root system dependency inpantry.lock, including the snapshot commit hash. - Fail before compilation with an actionable error; print the selected compiler path/version and retain
CRAFT_ALLOW_UNPINNED_ZIG=1for intentional compatibility tests. - Route root build, test, run, format and Zig commands through the wrapper without silently invoking Pantry's dependency-rewriting environment setup.
- Document the supported local workflow and run deterministic shadowed-PATH regressions in CI.
Closes #275.
Validation
- Before:
bun run zig versionsilently selected PATH0.17.0-dev.2163+89ff10d56despite the locked0.17.0-dev.1963+e00c6c439. - After: the same command fails early with both versions and remediation instructions.
- Four fixture tests pass, covering PATH shadowing, explicit pinned selection, deliberate unpinned opt-in, malformed/missing toolchains, argument/working-directory/version forwarding and compiler exit status.
- Root typecheck, focused Pickier, and pinned Zig format checks pass.