Skip to content

ENH(functional): add support for adaptive mutation budget - #148

Open
mj-will wants to merge 11 commits into
mainfrom
functional-adaptation
Open

mj-will wants to merge 11 commits into
mainfrom
functional-adaptation

Conversation

@mj-will

@mj-will mj-will commented Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator

Add support for the adaptive mutation budget with DE via the functional API

Add explicit mutation budget carries and pure preparation/update
operations for fixed and acceptance policies. Share lifecycle and
numerical decisions across eager and functional APIs.

Use complete eager budget state and a new nested checkpoint payload.
Legacy optional-field checkpoints are unsupported. Acceptance policies
now use floating-point ceilings and cap max_steps at 2**24.

Keep dynamic-budget child mutation execution explicitly unsupported.
Cover iteration reuse, promotion, clipping, immutability, JIT/scan,
independent adapters, and save/resume behavior.

Validation: pre-commit; default suite (1381 passed, 426 skipped);
NumPy/JAX/PyTorch adaptation tests (127 passed, 19 CuPy skips).
Docs build succeeds with three unavailable intersphinx inventories.
@mj-will mj-will changed the title ENH(functiona;) ENH(functional): add support for adaptive mutation budget Nov 17, 2026
@mj-will mj-will added this to the v0.2.0 milestone Nov 17, 2026
Share DE block preparation and finalization while retaining separate eager and functional loops. Reuse with_metrics and acai.cond, validate effective child capacities through one public entry point, and retain direct-call argument checks.

Add regressions for effective capacity validation and unsupported dynamic children. The shared acceptance rounding, budget state, and checkpoint schema are unchanged.
Keep freeze, once-only update, advancement, and checkpoint rules in the focused eager and functional lifecycle test. Retain independent-run isolation coverage and use the compiled DE scan for mutation execution, zero-budget recovery, and RNG parity.

Validation before commit: pre-commit and the documentation build passed; the default suite passed with 1381 tests and 425 skips, and the all-backend suite passed with 1894 tests and 111 skips.
Avoid extracting metrics from the output after attaching the computed result. Add return-type overloads to MutationMetrics.result so non-None state produces a non-None result without a runtime assertion.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant