V0.16 Release Readiness#

  • package version: 0.16.0

  • git tag: v0.16.0

  • package-index publication: deferred until v1.0 or later

v0.16.0 is a Git-tag-only release. Do not run TestPyPI or PyPI publishing for v0.16.

Summary#

v0.16 closes as the external symmetry-candidate validation release.

Stable claim:

canonical scalar 1D periodic FieldBatch + external candidate payload + residual evaluator -> empirical configured validation report

The public addition is:

  • pdelie.symmetry.validate_symmetry_candidate(...)

The helper accepts:

  • GeneratorFamily

  • canonical GeneratorFamily payload mappings

  • InvariantMapSpec

  • canonical InvariantMapSpec payload mappings

validated means configured empirical validation under supplied inputs and thresholds. It is not a mathematical proof of symmetry.

M0-M6 Outcome#

  • M0: froze scope as detector interop through validation reports

  • M1: froze API signature, accepted candidate kinds, strict payload policy, thresholds, conclusion labels, and failure behavior

  • M2: implemented GeneratorFamily candidate validation

  • M3: implemented InvariantMapSpec candidate validation

  • M4: added JSON-only symmetry-candidate validation example

  • M5: audited public surface and non-goals

  • M6: aligned metadata, docs, CI, release gate, and readiness notes

Public API Notes#

New submodule-only API:

  • pdelie.symmetry.validate_symmetry_candidate

No root export is added.

The API returns JSON-compatible runtime reports. It does not return a canonical object and does not mutate inputs.

Explicit Deferrals#

v0.16 does not add:

  • callable transform descriptors

  • arbitrary external executable candidate objects

  • neural symmetry-detector training

  • learned-generator classes

  • formula-backed or non-polynomial generator families

  • train/test policy

  • split management

  • heldout-leakage detection

  • sparse-discovery branch policy

  • time-translation APIs

  • new PDE support

  • stable KS runtime support

  • weak KS

  • broad adapters

  • PDEBench or The Well support

  • multidimensional, multivariable, or nonuniform-grid expansion

  • operator-facing APIs

  • root runtime exports

CI Expectations#

Required CI checks before tagging:

  • v0_16-release-gate

  • editable-tests

  • package-smoke

Historical release-gate test files remain in the repository and are covered by the full editable test suite.

Local Validation Checklist#

Before tagging v0.16.0, run:

python -m pytest
python -m build --sdist --wheel
python -m pdelie.examples.heat_vertical_slice
python -m pdelie.examples.kdv_vertical_slice
python -m pdelie.examples.orbit_coverage_diagnostics
python -m pdelie.examples.invariant_workflow_summary
python -m pdelie.examples.translation_orbit_batch
python -m pdelie.examples.symmetry_candidate_validation
git diff --check

Clean wheel smoke should verify:

  • stable root imports

  • pdelie.symmetry.validate_symmetry_candidate imports from the submodule

  • root pdelie.validate_symmetry_candidate remains absent

  • one valid GeneratorFamily candidate validates

  • one valid InvariantMapSpec payload validates

  • one wrong-span generator returns conclusion = "failed"

  • weak Heat report smoke remains green

  • KdV strong-path residual smoke remains green

  • order-4 derivative smoke remains green

Direct Tag Checklist#

  • create and merge the release PR

  • wait for required CI checks to pass

  • tag the merged main commit as v0.16.0

  • do not publish to TestPyPI

  • do not publish to PyPI

  • record package-index publishing as deferred until v1.0 or later