Release 0.15

.dockerignore

@@ -58,7 +58,6 @@ htmlcov
 
 # Documentation builds
 docs/build
-docs/source/pythonapi/generated/
 docs
 
 # Container artifacts
@@ -135,7 +134,6 @@ htmlcov
 
 # Documentation builds
 docs/build
-docs/source/pythonapi/generated/
 docs
 
 # Container artifacts
@@ -161,4 +159,4 @@ source_particles.h5
 
 # Regression test data
 dummy_nuclide.h5
-source_particles.h5
+source_particles.h5

.github/pull_request_template.md

@@ -19,8 +19,8 @@
     Put an `x` in all boxes once completed.
 -->
 
-- [ ] I have read the [contributing guide](https://mcdc.readthedocs.io/en/latest/contribution/index.html).
-- [ ] My code follows the [code style](https://mcdc.readthedocs.io/en/latest/contribution/index.html#code-styling) of this project.
+- [ ] I have read the [contributing guide](https://mcdc.readthedocs.io/en/dev/contributing/index.html).
+- [ ] My code follows the [code style](https://mcdc.readthedocs.io/en/dev/contributing/index.html#code-styling) of this project.
 - [ ] I have updated the documentation as needed. <!-- Delete if not applicable -->
 - [ ] I have updated `CHANGELOG.md` as needed. <!-- Delete if not applicable -->
 - [ ] I have added or updated tests to cover my changes. <!-- Delete if not applicable -->

.github/workflows/docker.yml

@@ -120,14 +120,14 @@ jobs:
         run: |
           docker run --rm \
             -w /opt/mcdc/test/unit \
-            mcdc:${{ needs.build.outputs.image_tag }} python -m pytest .
+            mcdc:${{ needs.build.outputs.image_tag }} python -m pytest -v .
 
       - name: Run unit tests (with workspace mount)
         run: |
           docker run --rm \
             -v ${{ github.workspace }}:/opt/mcdc \
             -w /opt/mcdc/test/unit \
-            mcdc:${{ needs.build.outputs.image_tag }} python -m pytest .
+            mcdc:${{ needs.build.outputs.image_tag }} python -m pytest -v .
 
   # ---------------------------------------------------------------------------
   # Stage 2b: Regression — only on push, or on PRs touching docker-relevant files
@@ -145,18 +145,18 @@ jobs:
       matrix:
         include:
           - mode: Python-Serial
-            run_cmd: "python run.py"
+            run_cmd: "python -m pytest -v test/regression"
             timeout: 10
           - mode: Python-MPI
             run_cmd: |
-              python run.py --mpiexec=2
+              python -m pytest -v test/regression --mpiexec=2
             timeout: 20
           - mode: Numba-Serial
-            run_cmd: "python run.py --mode numba"
+            run_cmd: "python -m pytest -v test/regression --mode numba"
             timeout: 120
           - mode: Numba-MPI
             run_cmd: |
-              python run.py --mode numba --mpiexec=2
+              python -m pytest -v test/regression --mode numba --mpiexec=2
             timeout: 120
 
     steps:
@@ -183,7 +183,7 @@ jobs:
         run: |
           docker run --rm \
             -v ${{ github.workspace }}:/opt/mcdc \
-            -w /opt/mcdc/test/regression \
+            -w /opt/mcdc \
             mcdc:${{ needs.build.outputs.image_tag }} bash -lc '
               git config --global --add safe.directory /opt/mcdc
               git config --global --add safe.directory /opt/mcdc/test/regression/mcdc-regression_test_data

.github/workflows/docs_test.yml

@@ -5,6 +5,9 @@ on:
   pull_request:
   workflow_dispatch:
 
+env:
+  UCX_TLS: self,sm,tcp
+
 jobs:
   build-docs:
     runs-on: "ubuntu-latest"
@@ -31,12 +34,9 @@ jobs:
       - name: Install docs dependencies
         run: |
           python -m pip install --upgrade pip
-          # If you have extras for docs, use this:
           python -m pip install ".[docs]"
-          # Otherwise, something like:
-          # python -m pip install . sphinx sphinx-autodoc-typehints ...
           python -m pip list
 
       - name: Build the docs
         working-directory: docs
-        run: make html
+        run: make html

.github/workflows/publish-pypi.yml

@@ -27,7 +27,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      # Set up the Python version supported by this project.
+      # Set up the project's primary automatically tested Python version.
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
@@ -46,6 +46,11 @@ jobs:
       # and the wheel into the dist/ directory.
       - name: Build distributions
         run: python -m build
+      # Confirm that type checkers can detect MC/DC's inline annotations.
+      - name: Verify typing marker
+        run: |
+          unzip -l dist/*.whl | grep "mcdc/py.typed"
+          tar -tzf dist/*.tar.gz | grep "/mcdc/py.typed"
       # Hand the built distributions over to the publish job.
       - name: Upload distributions
         uses: actions/upload-artifact@v4

.github/workflows/python_compatibility.yml

@@ -0,0 +1,50 @@
+name: Python Compatibility Tests
+
+on:
+  workflow_dispatch:
+
+env:
+  UCX_TLS: self,sm,tcp
+
+jobs:
+  compatibility-test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.14"]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Set up MPI
+        uses: mpi4py/setup-mpi@v1
+
+      - name: Install mpi4py
+        run: |
+          pip install --upgrade pip
+          pip install --no-binary=mpi4py mpi4py
+
+      - name: Install MC/DC
+        id: install
+        run: pip install -e ".[dev]"
+
+      - name: Run unit tests
+        run: python -m pytest -v test/unit
+
+      - name: Run regression tests (Python)
+        if: always() && steps.install.outcome == 'success'
+        run: python -m pytest -v test/regression
+
+      - name: Run regression tests (Numba)
+        if: always() && steps.install.outcome == 'success'
+        run: python -m pytest -v test/regression --mode numba

.github/workflows/regression_test-gpu.yml

@@ -35,5 +35,4 @@ jobs:
       run: |
           pwd
           source ../ci_testing/bin/activate
-          cd test/regression
-          python run.py --mode=numba --target=gpu
+          python -m pytest -v test/regression --mode=numba --target=gpu

.github/workflows/regression_test.yml

@@ -34,24 +34,22 @@ jobs:
           # Python modes:
           - mode: Python-Serial
             python-version: '3.13'
-            run_cmd: "python run.py"
+            run_cmd: "python -m pytest -v test/regression"
             timeout: 10
           - mode: Python-MPI
             python-version: '3.13'
             run_cmd: |
-              python run.py --mpiexec=4
-              python run.py --mpiexec=16 --name=slab_reed_dd_3d
+              python -m pytest -v test/regression --mpiexec=4
             timeout: 30
           # Numba modes:
           - mode: Numba-Serial
             python-version: '3.13'
-            run_cmd: "python run.py --mode numba"
+            run_cmd: "python -m pytest -v test/regression --mode numba"
             timeout: 120
           - mode: Numba-MPI
             python-version: '3.13'
             run_cmd: |
-              python run.py --mode numba --mpiexec=4
-              python run.py --mode numba --mpiexec=16 --name=slab_reed_dd_3d
+              python -m pytest -v test/regression --mode numba --mpiexec=4
             timeout: 120
 
     steps:
@@ -79,5 +77,4 @@ jobs:
           python -c "import mpi4py; print(f'mpi4py {mpi4py.__version__} from {mpi4py.__file__}')"
 
       - name: Run regression tests (${{ matrix.mode }})
-        working-directory: test/regression
         run: ${{ matrix.run_cmd }}

.github/workflows/stale-issues.yml

@@ -0,0 +1,13 @@
+name: Mark stale issues
+
+on:
+  schedule:
+    - cron: "0 0 * * *"
+  workflow_dispatch:
+
+permissions:
+  issues: write
+
+jobs:
+  stale:
+    uses: mcdc-project/.github/.github/workflows/stale-issues.yml@main

.github/workflows/unit_test.yml

@@ -46,4 +46,7 @@ jobs:
 
       - name: Run unit tests
         run: |
-          python -m pytest test/unit
+          python -m pytest -v test/unit
+
+      - name: Run public API type checks
+        run: pyright

.gitignore

@@ -58,7 +58,7 @@ pytestdebug.log
 
 # Documentation builds
 docs/build
-docs/source/pythonapi/generated/
+docs/source/reference/python_api/generated/
 dist/
 mcdc/_version.py
 

.pre-commit-config.yaml

@@ -8,4 +8,4 @@ repos:
         # supported by your project here, or alternatively use
         # pre-commit's default_language_version, see
         # https://pre-commit.com/#top_level-default_language_version
-        language_version: python3.11
+        language_version: python3.13

.readthedocs.yaml

@@ -9,7 +9,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.11"
+    python: "3.13"
   apt_packages:
     - libopenmpi-dev
     - openmpi-bin

CHANGELOG.md

@@ -4,19 +4,29 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/2.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.15.0] - 2026-08-11
 
 ### Added
 
+- Add `NeutronMultigroupData` and hybrid neutron multigroup transport with material-local physical energy grids and energy-representation policies, together with the `Material.multigroup()` convenience interface, from [@ilhamv]
+- Add manually triggered unit and serial regression compatibility testing for Python 3.11, 3.12, and 3.14 while retaining Python 3.13 for automatic testing, from [@ilhamv]
+- Add PEP 561-compatible inline type information and strict Pyright checks for the public Python API, from [@ilhamv]
+
 ### Changed
 
-### Deprecated
+- **Breaking:** Unify native and neutron multigroup materials under one non-polymorphic `Material` and runtime layout, replacing `MaterialMG` and the separate native and multigroup material structures, from [@ilhamv]
+- Group transport techniques under `simulation.technique`, from [@ilhamv]
+- **Breaking:** Encapsulate MC/DC model building and execution within an explicit `mcdc.Simulation` instance, replacing the global simulation state and interface from [@ilhamv]
+- Modernize and reorganize the documentation around distinct user, API reference, theory, project, and developer paths; adopt the PyData Sphinx Theme; and expand the architecture and extension guidance from [@ilhamv]
+- Move model-specific finalization into simulation compilation and reserve runtime preparation for framework-level packing and execution setup from [@ilhamv]
+- Move regression tests from the custom `run.py` harness to pytest-based collection and reporting from [@massimolarsen]
+- **Breaking:** Require Python 3.11 or newer and designate Python 3.13 as the primary automatic test version, from [@ilhamv]
+- Run Black and Pyright with Python 3.14 while keeping Black output compatible with every supported Python version, from [@ilhamv]
+- Adopt a three-month seasonal cycle for minor releases while continuing to publish patch releases as needed, from [@ilhamv]
 
 ### Removed
 
-### Fixed
-
-### Security
+- Remove the legacy `install.sh` installation helper, from [@ilhamv]
 
 ## [0.14.2] - 2026-07-15
 
@@ -128,6 +138,7 @@ The pre-refactor implementation remains available in the `cement` branch as a re
 - Multi-table distribution table selection sampling from [@melekderman]
 
 [Unreleased]: https://github.com/mcdc-project/mcdc/tree/dev
+[0.15.0]: https://github.com/mcdc-project/mcdc/releases/tag/v0.15.0
 [0.14.2]: https://github.com/mcdc-project/mcdc/releases/tag/v0.14.2
 [0.14.1]: https://github.com/mcdc-project/mcdc/releases/tag/v0.14.1
 [0.14.0]: https://github.com/mcdc-project/mcdc/releases/tag/v0.14.0