otter-hed 0.2.1__tar.gz

otter_hed-0.2.1/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+This project follows [Semantic Versioning](https://semver.org/). Changes that
+have not yet been released are collected under “Unreleased”.
+
+## Unreleased
+
+## 0.2.1 - 2026-08-14
+
+### Added
+
+- Expanded ``otter_state_v3`` archives with electronic profiles, orbital
+  densities, response functions, QOZ interaction channels, pair potentials,
+  structure factors, and calculation metadata.
+- Added a Colab introduction and optional Libxc installation extra.
+
+### Changed
+
+- Added a Poetry lock file and one cross-platform `poetry install` path with
+  runtime, plotting, tests, documentation, and editable source installation.
+- Added package-install smoke tests on all three operating systems and on
+  supported CPython release lines.
+- Replaced the duplicated quick-start snippets with the canonical
+  ``examples/single_species_workflow.py`` example, which now exercises the
+  production defaults directly.
+- Kept the top-level examples focused on single-species and mixture workflows;
+  numerical diagnostics and model studies now live under ``tools``.
+- Stabilized mixture roots near pressure ionization and preserved validated
+  external-density tails through the final electronic solve.
+- Recomputed and promoted all accepted example and benchmark NPZ baselines
+  with field inventories and provenance metadata.
+- Simplified the software citation and refreshed the example and benchmark
+  documentation.
+
+## 0.2.0 - 2026-08-10
+
+### Added
+
+- Unified single-species and mixture AA → pseudoatom → QOZ/HNC workflow.
+- Orbital Kohn–Sham and finite-temperature Thomas–Fermi electronic backends.
+- Finite-temperature Chabrier (1990) jellium local-field correction.
+- Portable, pickle-free `q(k)`, `f(k)`, `g_ij(r)`, and `S_ij(k)` state files.
+- Cached, provenance-checked Starrett et al. mixture benchmark.
+- Experimental AA ↔ QOZ/HNC self-consistent feedback API.
+- Configurable exchange-correlation models, including dependency-free Dirac
+  exchange and optional Libxc-backed LDA/PBE functionals with recorded
+  software and functional provenance.
+- Self-contained capability and scientific-benchmark galleries with
+  results-first HTML pages and publication-ready PNG/PDF figures.
+
+### Changed
+
+- Physical Fermi–Dirac bound occupation is the production default.
+- Pseudoatom charge closure is enforced on the QOZ/DST lattice.
+- HNC production paths reject unconverged or projected nonphysical roots.
+- Experimental SC feedback and production state export now fail closed on
+  missing convergence status.
+- Continuum threshold, phase-shift resonance, weak-bound-state, and B3/Friedel
+  tail diagnostics were strengthened.
+- Scientific reference datasets now carry explicit source, checksum, rights,
+  and redistribution metadata separate from Otter's software license.
+
+## 0.1.0
+
+- Initial Otter project structure and documentation prototype.

otter_hed-0.2.1/CITATION.cff

@@ -0,0 +1,33 @@
+cff-version: 1.2.0
+message: >-
+  If you use Otter in a scientific publication, please cite this software.
+title: Otter
+type: software
+version: 0.2.1
+date-released: 2026-08-14
+authors:
+  - family-names: Qu
+    given-names: Chongbing
+  - family-names: Kraus
+    given-names: Dominik
+repository-code: https://github.com/otter-hed/otter
+license: BSD-3-Clause
+keywords:
+  - average atom
+  - dense plasma
+  - ionic structure
+  - pseudoatom
+  - QOZ
+  - HNC
+  - warm dense matter
+preferred-citation:
+  type: software
+  title: Otter
+  version: 0.2.1
+  date-released: 2026-08-14
+  authors:
+    - family-names: Qu
+      given-names: Chongbing
+    - family-names: Kraus
+      given-names: Dominik
+  repository-code: https://github.com/otter-hed/otter

otter_hed-0.2.1/CONTRIBUTING.md

@@ -0,0 +1,58 @@
+# Contributing to Otter
+
+Thank you for helping improve Otter. Numerical plasma models can produce
+smooth-looking but incorrect curves, so every change should be reviewable at
+three levels: implementation, numerical invariants, and physical validation.
+
+## Development setup
+
+Use Python 3.12 or newer and Poetry 2.1 or newer. Install the locked runtime,
+tests, and documentation tools:
+
+```bash
+poetry install
+```
+
+Run the fast regression suite and strict documentation build:
+
+```bash
+poetry run pytest -q
+poetry run make -C docs strict
+```
+
+On Windows without `make`, use
+`poetry run python -m sphinx -E -a -W --keep-going -b html docs/source docs/build/html`.
+
+## Change requirements
+
+- Keep model defaults conservative. Diagnostic approximations must be explicit
+  options and clearly labelled in result metadata.
+- Add focused tests for each numerical invariant or failure mode.
+- For physics changes, add or update a benchmark with a citable source,
+  immutable input data, units, provenance, and quantitative metrics.
+- Do not regenerate expensive AA calculations in ordinary tests or docs.
+  Commit small, pickle-free reference arrays and validate their hashes instead.
+- Do not hide failed common-chemical-potential, charge-closure, or HNC solves by
+  clipping or silently returning a best-effort result.
+- Add the primary literature citation near the implementation and to
+  `src/otter/literature.bib`.
+- Keep generated Sphinx pages, caches, plots, and local environments out of
+  version control.
+
+The validation policy and architecture notes are in `docs/source/benchmarks`
+and `docs/source/development`.
+
+## Pull requests
+
+Keep each pull request focused. In the description, state:
+
+1. the physical or engineering problem;
+2. the model equations or references affected;
+3. tests and benchmark states run;
+4. any changes to defaults, schemas, or numerical tolerances;
+5. known validity limits.
+
+Changes to public result schemas or model defaults require a changelog entry.
+Before creating any public artifact, run
+`python tools/check_public_release.py`; a nonzero result is a hard release
+blocker, not an informational warning.

otter_hed-0.2.1/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Chongbing Qu
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

otter_hed-0.2.1/MANIFEST.in

@@ -0,0 +1,14 @@
+include LICENSE
+include README.md
+include CITATION.cff
+include CHANGELOG.md
+include CONTRIBUTING.md
+include SECURITY.md
+include THIRD_PARTY_NOTICES.md
+
+prune tests
+
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.so
+global-exclude .DS_Store

otter_hed-0.2.1/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: otter-hed
+Version: 0.2.1
+Summary: Average-atom, pseudoatom, and ionic-structure calculations for dense plasmas.
+Author: Chongbing Qu, Dominik Kraus
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/otter-hed/otter
+Project-URL: Documentation, https://otter-hed.github.io/otter/
+Project-URL: Repository, https://github.com/otter-hed/otter
+Project-URL: Issues, https://github.com/otter-hed/otter/issues
+Keywords: average atom,dense plasma,ionic structure,pseudoatom,warm dense matter
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+Requires-Dist: numpy<3,>=2.0
+Requires-Dist: scipy<2,>=1.13
+Requires-Dist: numba<1,>=0.60
+Requires-Dist: matplotlib>=3.8
+Provides-Extra: libxc
+Requires-Dist: pylibxc7==7.0.0; extra == "libxc"
+Dynamic: license-file
+
+# Otter
+
+Otter calculates electronic and ionic structure in warm and hot dense matter.
+From composition, mass density, and temperature it can solve a quantum
+average-atom or Thomas–Fermi model, construct neutral
+pseudoatoms, build effective ion–ion potentials, and solve one- or
+multicomponent QOZ/HNC equations.
+
+Otter is based primarily on the pseudoatom model of
+[Starrett and Saumon (2014)](https://doi.org/10.1016/j.hedp.2013.12.001).
+
+## Capabilities
+
+- finite-temperature quantum(KS-DFT, QM) and Thomas–Fermi (TF) electronic structure; the
+  QM model provides orbital levels, occupations, and density components;
+- pseudoatom densities `n_pa(r)` and screening densities `n_scr(r)`, with form factors
+  `f(k)=n_ion(k)` and `q(k)=n_scr(k)`;
+- effective ion–ion potentials `V_ij(r)` and `V_ij(k)`;
+- one- and multicomponent QOZ/HNC results `g_ij(r)` and `S_ij(k)`.
+
+## Install
+
+Install the released package from PyPI:
+
+```bash
+python -m pip install otter-hed
+```
+
+The distribution name is `otter-hed`; the Python package is imported as
+`otter`.
+
+For a reproducible editable installation from source, Otter requires CPython
+3.12 or newer, Git, and Poetry 2.1.3.
+
+macOS, Linux, or WSL:
+
+```bash
+curl -sSL https://install.python-poetry.org | python3 - --version 2.1.3
+```
+
+Windows PowerShell:
+
+```powershell
+(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py - --version 2.1.3
+```
+
+Verify the installation:
+
+```console
+poetry --version
+```
+
+Clone and install:
+
+```bash
+git clone https://github.com/otter-hed/otter.git
+cd otter
+poetry install
+```
+
+Dependencies are locked by `poetry.lock`; Otter is installed in editable mode.
+
+Otter's built-in local-density Dirac exchange is the dependency-free default
+used by the validated warm- and hot-dense-matter workflows. Libxc is optional
+and is needed only for additional LDA correlation or GGA functionals such as
+`lda_pw`, `lda_pz`, `lda_vwn`, and `pbe`.
+
+To enable these additional functionals:
+
+```bash
+poetry install --extras libxc
+```
+
+PyPI distributes the Libxc Python bindings as source, so this optional step
+requires CMake and a C compiler. See the
+[XC installation guide](https://otter-hed.github.io/otter/user_guide/xc_functionals.html#installation).
+
+```console
+poetry run python -c "import otter; print(otter.__version__)"
+```
+
+An unlocked fallback is `python -m pip install -e .`. See the
+[installation guide](https://otter-hed.github.io/otter/installing.html).
+
+## Quick start
+
+Run an introductory calculation in Google Colab:
+
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/otter-hed/otter/blob/main/notebooks/00-otter_intro.ipynb)
+
+Run the complete [single-species workflow](examples/single_species_workflow.py)
+from the repository root:
+
+```bash
+poetry run python examples/single_species_workflow.py
+```
+
+The default state is Al at `rho=8.1 g/cm^3` and `Te=Ti=15 eV`. Edit the input
+block to change the state or output controls. The script plots the electronic
+density, effective potential, `g_ii(r)`, and `S_ii(k)`, and saves PNG, PDF, and
+NPZ files.
+
+For mixtures, run [mixture_workflow.py](examples/mixture_workflow.py).
+
+### Saved workflow state
+
+The versioned NPZ schema stores the native electronic profiles and bound
+levels, `q/f`, electron response and LFC, electron/ion interaction channels,
+and `g_ij/S_ij`, together with units and convergence metadata.  In particular:
+
+- `q_k == n_scr_k` and `f_k == n_ion_k`;
+- `g_ee_k`, `chi0_k`, `chi_ee_k`, `v_ie_k`, `c_ie_k`, `v_ee_k`, and `c_ee_k`;
+- `gij_r`, `sij_k`, `vij_r`, and `vij_k`.
+
+The default windows are `r < 20 Bohr` and `k < 20 Bohr^-1`. Archives load with
+`allow_pickle=False` and are written atomically. See the
+[state-export guide](docs/source/user_guide/state_exports.rst) for in-memory
+and NPZ access.
+
+Quantum continuum calculations can be slow near pressure ionization.
+`continue_plasma_workflow_from_electronic_result` reuses a validated
+electronic result for subsequent QOZ/HNC calculations.
+
+## Validation and documentation
+
+Build the documentation and cached benchmark gallery with:
+
+```bash
+poetry install
+poetry run make -C docs strict
+```
+
+Open `docs/build/html/index.html` after the build. Start with:
+
+- [documentation source](docs/source/index.rst);
+- [capability example gallery](docs/examples/README.rst);
+- [scientific benchmark gallery](docs/source/benchmarks/index.rst);
+- [validation policy](docs/source/benchmarks/validation_policy.rst);
+- [portable state schema](docs/source/user_guide/state_exports.rst);
+- [development roadmap](docs/source/development/roadmap.rst).
+
+Digitized publication curves and author-provided numerical data have separate
+provenance and rights manifests; they are not covered by Otter's BSD software
+license unless a dataset explicitly says otherwise.  The current bundled
+reference sets are published by maintainer decision with source attribution
+and license status `NOASSERTION`.  Read the
+[reference-data notice](benchmarks/reference_data/README.md) before reuse.
+The executable gate `python tools/check_public_release.py` rejects any future
+manifest that reintroduces an unresolved public-release action.
+
+## Development
+
+```bash
+poetry install
+poetry run pytest -q
+poetry run make -C docs strict
+poetry run python -m build
+poetry run python -m twine check dist/*
+```
+
+Anyone interested in Otter is welcome to contribute. See
+[CONTRIBUTING.md](CONTRIBUTING.md) for numerical and benchmark review
+requirements and [CHANGELOG.md](CHANGELOG.md) for user-visible changes.
+
+## Citation
+
+If you use Otter in a scientific publication, please cite:
+
+> Chongbing Qu and Dominik Kraus, *Otter*, version 0.2.1, computer software (2026),
+> [https://github.com/otter-hed/otter](https://github.com/otter-hed/otter).
+
+```bibtex
+@misc{QuKraus2026Otter,
+  author  = {Qu, Chongbing and Kraus, Dominik},
+  title   = {Otter},
+  year    = {2026},
+  note    = {Computer software, version 0.2.1},
+  url     = {https://github.com/otter-hed/otter}
+}
+```
+
+The same metadata are available in [CITATION.cff](CITATION.cff). Otter is
+also available through GitHub's **Cite this repository** menu. Runtime
+configuration objects provide
+`config.citation(style="plain"|"bibtex"|"cite")` and expose their canonical
+`citation_keys` as scientific provenance for selected physical models; these
+are not additional software-citation requirements. See
+[`CITATIONS.md`](CITATIONS.md).
+
+## Acknowledgements
+
+The authors thank Zachary A. Johnson and C. E. Starrett for helpful
+discussions.
+
+Chongbing Qu gratefully acknowledges financial support from HEDI and the China
+Scholarship Council (CSC).
+
+Otter is distributed under the [BSD 3-Clause License](LICENSE).

otter_hed-0.2.1/README.md

@@ -0,0 +1,198 @@
+# Otter
+
+Otter calculates electronic and ionic structure in warm and hot dense matter.
+From composition, mass density, and temperature it can solve a quantum
+average-atom or Thomas–Fermi model, construct neutral
+pseudoatoms, build effective ion–ion potentials, and solve one- or
+multicomponent QOZ/HNC equations.
+
+Otter is based primarily on the pseudoatom model of
+[Starrett and Saumon (2014)](https://doi.org/10.1016/j.hedp.2013.12.001).
+
+## Capabilities
+
+- finite-temperature quantum(KS-DFT, QM) and Thomas–Fermi (TF) electronic structure; the
+  QM model provides orbital levels, occupations, and density components;
+- pseudoatom densities `n_pa(r)` and screening densities `n_scr(r)`, with form factors
+  `f(k)=n_ion(k)` and `q(k)=n_scr(k)`;
+- effective ion–ion potentials `V_ij(r)` and `V_ij(k)`;
+- one- and multicomponent QOZ/HNC results `g_ij(r)` and `S_ij(k)`.
+
+## Install
+
+Install the released package from PyPI:
+
+```bash
+python -m pip install otter-hed
+```
+
+The distribution name is `otter-hed`; the Python package is imported as
+`otter`.
+
+For a reproducible editable installation from source, Otter requires CPython
+3.12 or newer, Git, and Poetry 2.1.3.
+
+macOS, Linux, or WSL:
+
+```bash
+curl -sSL https://install.python-poetry.org | python3 - --version 2.1.3
+```
+
+Windows PowerShell:
+
+```powershell
+(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py - --version 2.1.3
+```
+
+Verify the installation:
+
+```console
+poetry --version
+```
+
+Clone and install:
+
+```bash
+git clone https://github.com/otter-hed/otter.git
+cd otter
+poetry install
+```
+
+Dependencies are locked by `poetry.lock`; Otter is installed in editable mode.
+
+Otter's built-in local-density Dirac exchange is the dependency-free default
+used by the validated warm- and hot-dense-matter workflows. Libxc is optional
+and is needed only for additional LDA correlation or GGA functionals such as
+`lda_pw`, `lda_pz`, `lda_vwn`, and `pbe`.
+
+To enable these additional functionals:
+
+```bash
+poetry install --extras libxc
+```
+
+PyPI distributes the Libxc Python bindings as source, so this optional step
+requires CMake and a C compiler. See the
+[XC installation guide](https://otter-hed.github.io/otter/user_guide/xc_functionals.html#installation).
+
+```console
+poetry run python -c "import otter; print(otter.__version__)"
+```
+
+An unlocked fallback is `python -m pip install -e .`. See the
+[installation guide](https://otter-hed.github.io/otter/installing.html).
+
+## Quick start
+
+Run an introductory calculation in Google Colab:
+
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/otter-hed/otter/blob/main/notebooks/00-otter_intro.ipynb)
+
+Run the complete [single-species workflow](examples/single_species_workflow.py)
+from the repository root:
+
+```bash
+poetry run python examples/single_species_workflow.py
+```
+
+The default state is Al at `rho=8.1 g/cm^3` and `Te=Ti=15 eV`. Edit the input
+block to change the state or output controls. The script plots the electronic
+density, effective potential, `g_ii(r)`, and `S_ii(k)`, and saves PNG, PDF, and
+NPZ files.
+
+For mixtures, run [mixture_workflow.py](examples/mixture_workflow.py).
+
+### Saved workflow state
+
+The versioned NPZ schema stores the native electronic profiles and bound
+levels, `q/f`, electron response and LFC, electron/ion interaction channels,
+and `g_ij/S_ij`, together with units and convergence metadata.  In particular:
+
+- `q_k == n_scr_k` and `f_k == n_ion_k`;
+- `g_ee_k`, `chi0_k`, `chi_ee_k`, `v_ie_k`, `c_ie_k`, `v_ee_k`, and `c_ee_k`;
+- `gij_r`, `sij_k`, `vij_r`, and `vij_k`.
+
+The default windows are `r < 20 Bohr` and `k < 20 Bohr^-1`. Archives load with
+`allow_pickle=False` and are written atomically. See the
+[state-export guide](docs/source/user_guide/state_exports.rst) for in-memory
+and NPZ access.
+
+Quantum continuum calculations can be slow near pressure ionization.
+`continue_plasma_workflow_from_electronic_result` reuses a validated
+electronic result for subsequent QOZ/HNC calculations.
+
+## Validation and documentation
+
+Build the documentation and cached benchmark gallery with:
+
+```bash
+poetry install
+poetry run make -C docs strict
+```
+
+Open `docs/build/html/index.html` after the build. Start with:
+
+- [documentation source](docs/source/index.rst);
+- [capability example gallery](docs/examples/README.rst);
+- [scientific benchmark gallery](docs/source/benchmarks/index.rst);
+- [validation policy](docs/source/benchmarks/validation_policy.rst);
+- [portable state schema](docs/source/user_guide/state_exports.rst);
+- [development roadmap](docs/source/development/roadmap.rst).
+
+Digitized publication curves and author-provided numerical data have separate
+provenance and rights manifests; they are not covered by Otter's BSD software
+license unless a dataset explicitly says otherwise.  The current bundled
+reference sets are published by maintainer decision with source attribution
+and license status `NOASSERTION`.  Read the
+[reference-data notice](benchmarks/reference_data/README.md) before reuse.
+The executable gate `python tools/check_public_release.py` rejects any future
+manifest that reintroduces an unresolved public-release action.
+
+## Development
+
+```bash
+poetry install
+poetry run pytest -q
+poetry run make -C docs strict
+poetry run python -m build
+poetry run python -m twine check dist/*
+```
+
+Anyone interested in Otter is welcome to contribute. See
+[CONTRIBUTING.md](CONTRIBUTING.md) for numerical and benchmark review
+requirements and [CHANGELOG.md](CHANGELOG.md) for user-visible changes.
+
+## Citation
+
+If you use Otter in a scientific publication, please cite:
+
+> Chongbing Qu and Dominik Kraus, *Otter*, version 0.2.1, computer software (2026),
+> [https://github.com/otter-hed/otter](https://github.com/otter-hed/otter).
+
+```bibtex
+@misc{QuKraus2026Otter,
+  author  = {Qu, Chongbing and Kraus, Dominik},
+  title   = {Otter},
+  year    = {2026},
+  note    = {Computer software, version 0.2.1},
+  url     = {https://github.com/otter-hed/otter}
+}
+```
+
+The same metadata are available in [CITATION.cff](CITATION.cff). Otter is
+also available through GitHub's **Cite this repository** menu. Runtime
+configuration objects provide
+`config.citation(style="plain"|"bibtex"|"cite")` and expose their canonical
+`citation_keys` as scientific provenance for selected physical models; these
+are not additional software-citation requirements. See
+[`CITATIONS.md`](CITATIONS.md).
+
+## Acknowledgements
+
+The authors thank Zachary A. Johnson and C. E. Starrett for helpful
+discussions.
+
+Chongbing Qu gratefully acknowledges financial support from HEDI and the China
+Scholarship Council (CSC).
+
+Otter is distributed under the [BSD 3-Clause License](LICENSE).

otter_hed-0.2.1/SECURITY.md

@@ -0,0 +1,14 @@
+# Security policy
+
+Otter is scientific software and is not intended to enforce a security
+boundary. Nevertheless, dependency, archive-loading, code-execution, or data
+integrity vulnerabilities should be reported privately through the repository
+host’s security-advisory channel rather than through a public issue.
+
+Only the latest development release is supported while the project is below
+version 1.0. Please include a minimal reproducer, affected version or commit,
+and an assessment of whether untrusted input is required.
+
+Otter’s public NPZ state format is deliberately loadable with
+`allow_pickle=False`. New interchange formats must preserve that property
+unless a security review explicitly documents an alternative.