Skip to content

chore(release): v0.15.1 — bug-fix: local promotion never causes a compile failure (#474) #477

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
avrabe merged 1 commit into from
Jun 24, 2026
Merged

chore(release): v0.15.1 — bug-fix: local promotion never causes a compile failure (#474) #477

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [0.15.1] - 2026-06-24

**Bug-fix: local promotion must never CAUSE a compile failure (#474).** v0.14.0
made i32 local promotion default-on; it pins eligible locals into callee-saved
r4-r8, which halves the operand-stack temp pool. On a dense function that tips
register allocation past what it can recover, turning a working compile into a hard
`register exhaustion` skip — a regression from v0.12.0.

The exhaustion-recovery ladder in `arm_backend.rs` is now parameterized on
promotion: it runs **with promotion first** — so every function that compiles today
is **bit-identical** (the frozen byte gate is unchanged: control_step `0x00210A55`,
flat+inlined flight_algo `0x07FDF307`, the div seam all preserved) — and, only if it
still ends in register exhaustion, falls back to the **promotion-off ladder**
automatically (the v0.12.0 frame-slot lowering, exactly what `SYNTH_NO_LOCAL_PROMOTE=1`
does by hand). Promotion is an optimization; it must never be the *reason* a
function fails to compile. The fallback keys on `register exhaustion` generally, so
it covers both the single-register and i64-spill-pool exhaustion classes promotion
can trigger.

Verified: a generic repro (`scripts/repro/promotion_exhaustion_fallback.wat`) fails
to compile without the fix and compiles with it, `.text` byte-identical to the
promotion-off build; new CI regression test `promotion_never_causes_compile_failure_474`.
Also adds an analysis-only map of the full register-exhaustion recovery ladder
(`scripts/repro/register_exhaustion_recovery_ladder.md`) — the patch surface the
VCR-RA verified allocator (#242) must subsume — and the optimized-path ABI-model note
(#470, by-design non-AAPCS self-contained path).

## [0.15.0] - 2026-06-24

**Immediate-shift folding is now DEFAULT-ON (VCR-RA, #390, epic #242).** The stack
Expand Down
34 changes: 17 additions & 17 deletions Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ resolver = "2"
# semver to publish, so the convention now catches up: workspace
# version follows the release tag, bumped pre-tag in the release
# checklist. See docs/release-process.md.
version = "0.15.0"
version = "0.15.1"
edition = "2024"
rust-version = "1.88"
authors = ["PulseEngine Team"]
Expand Down
2 changes: 1 addition & 1 deletion MODULE.bazel
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ module(
name = "synth",
# Kept in lockstep with [workspace.package] version in Cargo.toml.
# Both are bumped pre-tag — see docs/release-process.md.
version = "0.15.0",
version = "0.15.1",
)

# Bazel dependencies
Expand Down
2 changes: 1 addition & 1 deletion crates/synth-backend-awsm/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,6 @@ categories.workspace = true
description = "aWsm backend integration for the Synth compiler"

[dependencies]
synth-core = { path = "../synth-core", version = "0.15.0" }
synth-core = { path = "../synth-core", version = "0.15.1" }
anyhow.workspace = true
thiserror.workspace = true
4 changes: 2 additions & 2 deletions crates/synth-backend-riscv/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@ categories.workspace = true
description = "RISC-V encoder, ELF builder, PMP allocator, and bare-metal startup for synth"

[dependencies]
synth-core = { path = "../synth-core", version = "0.15.0" }
synth-synthesis = { path = "../synth-synthesis", version = "0.15.0" }
synth-core = { path = "../synth-core", version = "0.15.1" }
synth-synthesis = { path = "../synth-synthesis", version = "0.15.1" }
anyhow.workspace = true
thiserror.workspace = true
tracing.workspace = true
Expand Down
2 changes: 1 addition & 1 deletion crates/synth-backend-wasker/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,6 @@ categories.workspace = true
description = "Wasker backend integration for the Synth compiler"

[dependencies]
synth-core = { path = "../synth-core", version = "0.15.0" }
synth-core = { path = "../synth-core", version = "0.15.1" }
anyhow.workspace = true
thiserror.workspace = true
4 changes: 2 additions & 2 deletions crates/synth-backend/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ default = ["arm-cortex-m"]
arm-cortex-m = ["synth-synthesis"]

[dependencies]
synth-core = { path = "../synth-core", version = "0.15.0" }
synth-synthesis = { path = "../synth-synthesis", version = "0.15.0", optional = true }
synth-core = { path = "../synth-core", version = "0.15.1" }
synth-synthesis = { path = "../synth-synthesis", version = "0.15.1", optional = true }
anyhow.workspace = true
thiserror.workspace = true
16 changes: 8 additions & 8 deletions crates/synth-cli/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,18 +27,18 @@ verify = ["synth-verify"]
# Path deps carry `version` so `cargo publish` rewrites them to the
# crates.io coordinate. Bumping the workspace version requires
# updating these in lockstep — see docs/release-process.md.
synth-core = { path = "../synth-core", version = "0.15.0" }
synth-frontend = { path = "../synth-frontend", version = "0.15.0" }
synth-synthesis = { path = "../synth-synthesis", version = "0.15.0" }
synth-backend = { path = "../synth-backend", version = "0.15.0" }
synth-core = { path = "../synth-core", version = "0.15.1" }
synth-frontend = { path = "../synth-frontend", version = "0.15.1" }
synth-synthesis = { path = "../synth-synthesis", version = "0.15.1" }
synth-backend = { path = "../synth-backend", version = "0.15.1" }

# Optional external backends
synth-backend-awsm = { path = "../synth-backend-awsm", version = "0.15.0", optional = true }
synth-backend-wasker = { path = "../synth-backend-wasker", version = "0.15.0", optional = true }
synth-backend-riscv = { path = "../synth-backend-riscv", version = "0.15.0", optional = true }
synth-backend-awsm = { path = "../synth-backend-awsm", version = "0.15.1", optional = true }
synth-backend-wasker = { path = "../synth-backend-wasker", version = "0.15.1", optional = true }
synth-backend-riscv = { path = "../synth-backend-riscv", version = "0.15.1", optional = true }

# Optional verification (requires z3)
synth-verify = { path = "../synth-verify", version = "0.15.0", optional = true, features = ["z3-solver", "arm"] }
synth-verify = { path = "../synth-verify", version = "0.15.1", optional = true, features = ["z3-solver", "arm"] }

# Optional PulseEngine WASM optimizer
# Uncomment when loom crate is available:
Expand Down
2 changes: 1 addition & 1 deletion crates/synth-frontend/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ description = "WASM/WAT parser and module decoder frontend for the Synth compile
# Internal path deps carry an explicit version so `cargo publish`
# can rewrite to the crates.io coordinate. `path` is used for
# in-workspace builds; `version` is what crates.io sees.
synth-core = { path = "../synth-core", version = "0.15.0" }
synth-core = { path = "../synth-core", version = "0.15.1" }

wasmparser.workspace = true
wasm-encoder.workspace = true
Expand Down
2 changes: 1 addition & 1 deletion crates/synth-opt/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ categories.workspace = true
description = "Peephole optimization passes for the Synth compiler"

[dependencies]
synth-cfg = { path = "../synth-cfg", version = "0.15.0" }
synth-cfg = { path = "../synth-cfg", version = "0.15.1" }

[dev-dependencies]
criterion = { version = "0.8", features = ["html_reports"] }
Expand Down
6 changes: 3 additions & 3 deletions crates/synth-synthesis/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ categories.workspace = true
description = "WASM-to-ARM instruction selection and peephole optimizer"

[dependencies]
synth-core = { path = "../synth-core", version = "0.15.0" }
synth-cfg = { path = "../synth-cfg", version = "0.15.0" }
synth-opt = { path = "../synth-opt", version = "0.15.0" }
synth-core = { path = "../synth-core", version = "0.15.1" }
synth-cfg = { path = "../synth-cfg", version = "0.15.1" }
synth-opt = { path = "../synth-opt", version = "0.15.1" }
serde.workspace = true
anyhow.workspace = true
thiserror.workspace = true
Expand Down
8 changes: 4 additions & 4 deletions crates/synth-verify/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,12 +17,12 @@ arm = ["synth-synthesis"]

[dependencies]
# Core dependencies (always required)
synth-core = { path = "../synth-core", version = "0.15.0" }
synth-cfg = { path = "../synth-cfg", version = "0.15.0" }
synth-opt = { path = "../synth-opt", version = "0.15.0" }
synth-core = { path = "../synth-core", version = "0.15.1" }
synth-cfg = { path = "../synth-cfg", version = "0.15.1" }
synth-opt = { path = "../synth-opt", version = "0.15.1" }

# ARM synthesis (optional, behind 'arm' feature)
synth-synthesis = { path = "../synth-synthesis", version = "0.15.0", optional = true }
synth-synthesis = { path = "../synth-synthesis", version = "0.15.1", optional = true }

# SMT solver for formal verification
z3 = { version = "0.19", features = ["static-link-z3"], optional = true }
Expand Down
Loading