Skip to content

Changelog

[0.7.0] — 2026-03-02

Added

  • tests/test_nengo_snn_wrapper.py — 14 mocked tests for the only untested module (389 LOC)
  • tests/test_e2e_compile_to_control.py — 5 E2E integration tests (compile → artifact → controller → step)
  • require_range validator in core/_validators.py
  • /// doc comments on 11 public Rust functions (mpi_domain.rs, vmec_interface.rs)
  • keywords and categories in all 5 Rust Cargo.toml files
  • Paper 27 Reviewer Integration page in mkdocs nav

Fixed

  • Public API typo: TokamakTopoloy → TokamakTopology (deprecated alias retained)
  • print() → logging in 13 control modules (58 call sites total)
  • Remaining Union[str, Path] → str | Path in 3 files (eqdsk.py, realtime_monitor.py, artifact.py)
  • CLI hardcoded module/test counts → dynamic Path.rglob computation
  • Magic number b0=5.3 → named constant ITER_B0_VACUUM_T with citation
  • Stale doc counts across README, architecture, pitch, use_cases, CONTRIBUTING (53 modules, 115 files, 1969 tests, 15 CI)
  • Dead grid_index() function removed from Rust gmres.rs

Changed

  • Coverage gate ratcheted: fail_under = 62 → 85
  • from __future__ import annotations added to core/__init__.py and scpn/__init__.py
  • 4 duplicate validators in halo_re_physics.py replaced with core._validators imports
  • ROADMAP.md rewritten: v0.6.0 moved to Shipped, unshipped items to v0.7.0+
  • 12 additional tests across 5 thin test files

[0.6.0] — 2026-03-02

Added

  • .editorconfig and .github/CODEOWNERS
  • Copyright headers on all 3 CI workflow files
  • repository field in all 5 Rust Cargo.toml files
  • tests/test_validators.py — 49 parametrized tests for core/_validators.py
  • tests/test_phase_properties_extended.py — 14 Hypothesis property tests (knm, upde, adaptive_knm)
  • Paper 27 citations on OMEGA_N_16 and build_knm_paper27 constants

Fixed

  • .zenodo.json license "MIT" → "MIT OR Apache-2.0" (matches pyproject.toml)
  • docs/api.md version stuck at "0.5.0" → "0.6.0"
  • print() → logger.info() in spi_mitigation.py (3 sites)
  • Anti-slop: renamed unused param proposed_action → _proposed_action, deleted 4 narration comments in cli.py
  • Flaky timing test: absolute 5s threshold → relative warmup baseline
  • Dead DEFAULT_GAIN constant removed from Rust optimal.rs

Changed

  • Typing modernization: from __future__ import annotations + Optional[X] → X | None in 21 files
  • Shared test fixtures extracted to conftest.py (3 controller test files deduplicated)
  • pyproject.toml keywords + author email added

[0.5.2] — 2026-03-02

Fixed

  • Codecov fail_ci_if_error: false → true (matches v0.5.0 CHANGELOG claim)
  • Stale doc counts: architecture.md (17→21 modules, 1243→~1900 tests), pitch.md, use_cases.md
  • Bug report template version placeholder 0.3.0 → 0.5.x
  • Development.md release example v0.2.1 → vX.Y.Z
  • Magic number citations: ITER Physics Basis for SHOT_DURATION, TARGET_R, TARGET_Z, u_max
  • Anti-slop: "leveraging" → "using" (nengo), narration → TMR median voter (hil), dead pass block (eqdsk)

Changed

  • docs/changelog.md synced with root CHANGELOG (was frozen at v0.3.3)
  • ROADMAP.md rewritten for v0.5.x shipped state
  • require_non_negative_float added to core/_validators.py; scaling_laws and spi_mitigation use shared validators
  • control/__init__.__all__ includes normalize_bounds
  • Legacy typing imports replaced in 7 files (phase/ + scpn/): Optional→|None, List→list, Dict→dict, Tuple→tuple

[0.5.1] — 2026-03-02

Fixed

  • CITATION.cff DOI description said v0.4.0 (now v0.5.0)
  • docs/api.md version string stuck at 0.3.3 (now 0.5.0)
  • CONTRIBUTING.md stale test count (1243→~1900), coverage (50→62%), CI jobs (17→16)
  • docs/development.md stale coverage (55→62%) and release process (no longer uses __init__.py)
  • Two "Approximate" comments cleaned per anti-slop rule #4

Changed

  • require_int deduplicated: canonical core/_validators.py replaces 3 copies
  • deny.toml wildcards: "allow" → "deny"
  • Pre-commit: added check-merge-conflict, detect-private-key hooks
  • Paper 27 phase dynamics page added to mkdocs nav

Added

  • SECURITY.md responsible disclosure policy
  • CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
  • U-007 in UNDERDEVELOPED_REGISTER (np.isfinite boilerplate)
  • GitHub issues gh-13, gh-14, gh-15 for U-003/004/005 Rust fallback gaps

[0.5.0] — 2026-03-02

Fixed

  • __version__ now derived from package metadata (PEP 621), was stuck at 0.3.3
  • Rust H-inf update_discretization TODO tracked as gh-10, param renamed _dt → dt
  • README test/CI job counts updated to actual values

Added

  • 27 new tests: 9 Rust (h_infinity, xpoint, bfield, chebyshev) + 18 Python (rust_compat_wrapper)
  • cargo-deny supply-chain policy (deny.toml) + CI Job 15
  • ruff format --check CI gate + pre-commit hook
  • UNDERDEVELOPED_REGISTER.md tracking 6 known gaps
  • Python 3.13 in CI matrix

Changed

  • Coverage gate: 55% → 62% (actual: 93%)
  • Codecov fail_ci_if_error: true
  • Pre-commit: Rust hooks no longer gated to stages: [manual]
  • Removed unused proptest dev-dependency from 3 Cargo.toml files

[0.4.0] — 2026-03-01

Added

  • Real-time adaptive Knm engine driven by tokamak diagnostics (AdaptiveKnmEngine, DiagnosticSnapshot, AdaptiveKnmConfig)
  • Five adaptation channels: beta scaling, MHD risk amplification, coherence PI control, per-element rate limiting, Lyapunov guard veto
  • K_override parameter on UPDESystem.step(), .run(), .run_lyapunov()
  • RealtimeMonitor.from_plasma() constructor with adaptive engine support
  • Diagnostic kwargs (beta_n, q95, disruption_risk, mirnov_rms) on tick()
  • 46 new tests (1888 total)

Changed

  • .zenodo.json: complete Zenodo metadata (related identifiers, communities, notes)
  • CITATION.cff: version bump, date update

[0.3.3] — 2026-02-27

Changed

  • License: AGPL-3.0 → MIT OR Apache-2.0 dual (137 files, zero AGPL remaining)
  • README: pip install -e "." → pip install scpn-control (PyPI install path)
  • CONTRIBUTING: CI job count 14 → 17

[0.3.2] — 2026-02-27

Added

  • VectorizedSCLayer + Rust backend path in SNN compiler (512× real-time)
  • Two-tier import: v3.8.0+ preferred → legacy bit-ops → numpy float fallback
  • Test for v3.8 detection and VectorizedSCLayer forward-path benchmark
  • sc-neurocore listed first in optional deps table (crown jewel)

Changed

  • README: engine callout and dep table updated for sc-neurocore

[0.3.0] — 2026-02-27

Added

  • Ruff linter (E/F/W/I/B rules) — CI job + pyproject.toml config
  • Property-based tests for phase/ module (Hypothesis, 11 properties)
  • Gymnasium-compatible TokamakEnv (control/gym_tokamak_env.py, 10 tests)
  • IMAS/OMAS equilibrium adapter (core/imas_adapter.py)
  • CLI scpn-control info command (version, Rust status, weights, Python/NumPy)
  • Weight provenance manifest (reproduction commands, hardware, training config)
  • Paper 27 + H-infinity notebooks in CI smoke tests

Fixed

  • API docs: wrong snapshot keys (R→R_global, V→V_global, lambda→lambda_exp)
  • API docs: wrong UPDESystem constructor and LyapunovGuard API examples
  • README/CHANGELOG: "14 CI jobs" → actual count, test counts updated
  • _rust_compat.py: calculate_thermodynamics/vacuum_field now delegate to Python
  • 163 ruff auto-fixes (whitespace, import sorting, unused imports)
  • 26 manual ruff fixes (raise-from, unused variables, one-liners, E402)
  • Bandit now fails on medium+ severity (was --exit-zero)
  • TeX build artifacts (.aux/.log/.out/.toc) excluded from repo

Changed

  • Coverage threshold raised from 50% → 55% (actual: 61%)
  • CI: 12 → 13 jobs (added python-lint)
  • Test suite: 680 → 701 tests (50 test files)

[0.2.0] — 2026-02-26

Added

  • Paper 27 phase dynamics engine (src/scpn_control/phase/, 7 modules)
  • Kuramoto-Sakaguchi step with global field driver (kuramoto.py)
  • 16x16 Knm coupling matrix builder with calibration anchors (knm.py)
  • UPDE multi-layer solver with PAC gating (upde.py)
  • LyapunovGuard sliding-window stability monitor (lyapunov_guard.py)
  • RealtimeMonitor tick-by-tick UPDE + trajectory recorder (realtime_monitor.py)
  • PhaseStreamServer async WebSocket live stream (ws_phase_stream.py)
  • CLI scpn-control live command for real-time WS phase sync server
  • Streamlit WS client (examples/streamlit_ws_client.py)
  • Streamlit Cloud deployment (streamlit_app.py, .streamlit/config.toml)
  • Mock DIII-D shot generator (tests/mock_diiid.py)
  • E2E phase sync with shot data tests (tests/test_e2e_phase_diiid.py)
  • Phase sync convergence video (MP4 + GIF) and generator script
  • PyPI publish script (tools/publish.py)
  • Rust upde_tick() in control-math + PyRealtimeMonitor PyO3 binding

Changed

  • CI expanded from 6 to 12 jobs
  • Test suite expanded from 482 to 680 tests (680 passing, 94 skipped)
  • README updated with <video> MP4 embed, Streamlit Cloud badge
  • .gitignore updated to allow docs GIF/PNG and Streamlit config

[0.1.0] — 2026-02-19

Added

  • Initial extraction from scpn-fusion-core v3.4.0
  • 41 Python source files (minimal control transitive closure)
  • 5 Rust crates (control-types, control-math, control-core, control-control, control-python)
  • Slim PyO3 bindings (~474 LOC, control-only)
  • Clean __init__.py files (no matplotlib/GPU/ML import bombs)
  • Click CLI with 4 commands (demo, benchmark, validate, hil-test)
  • Streamlit dashboard (optional, [dashboard] extra)
  • CI workflow (6 jobs: python-tests, rmse-gate, rust-tests, rust-python-interop, rust-benchmarks, rust-audit)
  • 37 test files (482 passing, 122 skipped, 0 failures)
  • 16 disruption shot reference data files
  • 8 SPARC EFIT equilibria
  • 3 pretrained weight files
  • Validation scripts and tools
  • Stochastic Petri Net logic map header (docs/scpn_control_header.png)

Changed (vs scpn-fusion-core)

  • Required deps: numpy, scipy, click ONLY (was: numpy, scipy, matplotlib, streamlit)
  • matplotlib, streamlit, torch, nengo moved to optional extras
  • All imports renamed: scpn_fusion -> scpn_control, scpn_fusion_rs -> scpn_control_rs
  • Rust workspace reduced from 11 crates to 5
  • CI reduced from 13 jobs to 6
  • hpc_bridge.py relocated from hpc/ to core/ subpackage
  • Import guards added for excluded modules (stability_analyzer, global_design_scanner, imas_connector, diagnostics.forward, fusion_ignition_sim)