Skip to content

Record accepted-mesh provenance and enforce replay compatibility - #216

Merged
jc-macdonald merged 3 commits into
mainfrom
readiness/205-replay-provenance
Oct 14, 2026
Merged

jc-macdonald merged 3 commits into
mainfrom
readiness/205-replay-provenance

Conversation

@jc-macdonald

Copy link
Copy Markdown
Member

Accepted meshes previously identified only output times and step sizes, leaving producing method and model compatibility entirely to convention. Live schedules now carry lightweight static provenance for the resolved method, state layout, relevant operator/gamma/nonlinear-stage settings, optional structural model identity, and descriptive discovery controls/namespace/dtype/reference regime.

Replay rejects known structural mismatches before stepping. Dynamic parameter/initial-state values, backend and precision changes remain supported; labels and provenance never inspect fitted array values. Manual/legacy schedules retain mesh-only compatibility by default, with an opt-in requirement for verified provenance. The guide distinguishes these checks from accuracy and the provider's stronger artifact checks.

An executable generic two-pool/group example compares replay against an independent analytic solution and refreshes a compatible mesh after a parameter change. Tests cover all discovery paths, invalid mesh versus incompatible provenance, manual compatibility, NumPy-to-JAX reuse with traced state/tolerance arrays, nonlinear/gamma/axis changes, and source/installed execution of the published example.

Closes #205.

Validation: just format, just ci, just docs, just qualify (NumPy 40, JAX 48, Torch 65; zero selected skips), and just build-all passed. Existing higher-order/loop replay tests passed, as did 13 focused provenance/refresh tests. Installed-wheel validation caught an example import setup issue before submission; the test now loads the copied script without source-path injection. Provenance is not an accuracy certificate and does not infer callback semantics or arbitrary custom-solver internals.

@jc-macdonald
jc-macdonald merged commit 6d451b0 into main Oct 14, 2026
9 checks passed
@jc-macdonald
jc-macdonald deleted the readiness/205-replay-provenance branch October 14, 2026 16:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define accepted-mesh replay provenance, compatibility, and refresh policy

1 participant