Release KoopmanGraph 0.14.0 (remaining-limits close-out)

[tjkessler]

Summary

• Ship the 0.14.0 remaining-limits close-out: opt-in operator families (switched / mixture / Hodge / equivariant / graphon parameterizations), analysis extras (ResDMD, TDA, LMI, Granger), scale helpers (matrix-free, sparse backend, partition/remap), restricted export, federated averaging, and protocol-matched evaluation.
• Keep homogeneous scientific defaults and the linear latent operator contract (koopman=None still selects "pernode").
• Reorganize tests into package-aligned subdirectories and split version-named coverage dump files into module-named tests.
• Leave GitHub Release tag, PyPI publish, and Zenodo DOI refresh as post-merge maintainer steps.

Type of change

• New feature (non-breaking change that adds functionality)
• Refactor / tooling / CI

Checklist

• I ran pytest tests/ -v locally and all tests pass
• I ran ruff check src/ tests/ and ruff format --check src/ tests/ locally
• I added or updated tests for my changes (or explained why not applicable)
• I updated documentation only if this PR changes the public API (docstrings, README, Sphinx pages, tutorials)
• My changes follow the code style described in CONTRIBUTING.md

Test plan

• CI green on this PR (lint, Ubuntu matrix, macOS smoke, docs, notebook shards as path-filtered)
• Local ruff check / ruff format --check and full pytest tests/ -n auto --cov=koopman_graph --cov-fail-under=90 (97.25% package coverage)
• After merge: tag v0.14.0, confirm release.yml publishes to PyPI, then update Zenodo DOI in CITATION.cff / README / paper.md

Made with Cursor

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

[codecov]

Codecov Report

❌ Patch coverage is 92.19512% with 80 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/koopman_graph/model/factory.py	30.76%	11 Missing and 7 partials ⚠️
...pman_graph/operators/discrete_parameterizations.py	71.11%	8 Missing and 5 partials ⚠️
src/koopman_graph/operators/continuous_graph.py	47.36%	9 Missing and 1 partial ⚠️
src/koopman_graph/operators/hypergraph.py	40.00%	6 Missing and 3 partials ⚠️
src/koopman_graph/analysis/plotting.py	12.50%	7 Missing ⚠️
src/koopman_graph/operators/orbit_ties.py	65.00%	4 Missing and 3 partials ⚠️
src/koopman_graph/operators/matrix_free.py	73.91%	6 Missing ⚠️
src/koopman_graph/operators/discrete.py	86.95%	2 Missing and 1 partial ⚠️
src/koopman_graph/metrics.py	85.71%	1 Missing and 1 partial ⚠️
src/koopman_graph/nn/predicted_topology.py	94.44%	1 Missing and 1 partial ⚠️
... and 2 more

Files with missing lines	Coverage Δ
src/koopman_graph/__init__.py	100.00% <100.00%> (ø)
src/koopman_graph/analysis/__init__.py	100.00% <100.00%> (ø)
src/koopman_graph/analysis/causal.py	100.00% <100.00%> (ø)
src/koopman_graph/analysis/dispersion.py	100.00% <100.00%> (ø)
src/koopman_graph/analysis/explain.py	94.49% <ø> (-0.25%)	⬇️
src/koopman_graph/analysis/lmi.py	100.00% <100.00%> (ø)
src/koopman_graph/analysis/tda.py	100.00% <100.00%> (ø)
src/koopman_graph/baselines/gnn/__init__.py	100.00% <100.00%> (ø)
src/koopman_graph/baselines/gnn/attention.py	100.00% <100.00%> (ø)
src/koopman_graph/baselines/gnn/leaderboard.py	100.00% <100.00%> (ø)
... and 49 more

... and 10 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.