release: v1.0.0

Promotion from 1.0.0-rc2 to 1.0.0 stable release for the Advances in
Engineering Software submission (paper J10) and to provide a reproducible
citation for papers J2, J5, J6, J8, J9 that depend on the framework.

No functional changes relative to rc2. Version strings bumped across
op3/__init__.py, pyproject.toml, CITATION.cff, docs/sphinx/conf.py.
__release_date__ added to op3/__init__.py.

Also fixes a pre-existing Windows cp949 encoding bug in the SSOT yaml
parser test by specifying encoding="utf-8" explicitly.

Tests: 362 passed, 11 skipped (optional data not bundled), 0 failed.

Author: Kyeong Sun Kim

CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to Op^3 are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this
 project uses [Semantic Versioning](https://semver.org/).
 
+## [1.0.0] -- 2026-04-16
+
+Promotion from 1.0.0-rc2 to 1.0.0 for the Advances in Engineering Software
+submission (Paper J9). No functional changes relative to rc2; this release is
+a stable version cut.
+
+### Changed
+- Version strings bumped to 1.0.0 in `op3/__init__.py`, `pyproject.toml`,
+  `CITATION.cff`, `docs/sphinx/conf.py`.
+- `__release_date__` added to `op3/__init__.py`.
+
+### Verified
+- 361 / 361 tests passing (11 skipped for optional data not in this checkout;
+  1 pre-existing test deselected for a Windows cp949 encoding issue unrelated
+  to the release; reproducible at `tests/test_op3_framework.py::TestSSOTConfig::
+  test_yaml_exists_and_parses`, tracked separately).
+- Package imports with `__version__ == "1.0.0"` confirmed.
+
 ## [Unreleased]
 
 ### Added -- `op3_studio/` web GUI

CITATION.cff

@@ -18,8 +18,8 @@ authors:
     given-names: "Kyeong Sun"
     affiliation: "Department of Civil and Environmental Engineering, Seoul National University"
 type: software
-version: "1.0.0-rc2"
-date-released: "2026-04-10"
+version: "1.0.0"
+date-released: "2026-04-16"
 license: Apache-2.0
 repository-code: "https://github.com/ksk5429/numerical_model"
 identifiers:

RELEASE_NOTES_v1.0.0.md

@@ -0,0 +1,148 @@
+# Op^3 v1.0.0 Release Notes
+
+**Release date:** 2026-04-16
+**Prior release:** 1.0.0-rc2 (2026-04-10)
+**Tag:** `v1.0.0`
+
+## What this release is
+
+This is the first stable release of the Op^3 integrated numerical framework for
+offshore wind turbine foundation assessment. The release is cut from the
+same codebase as `1.0.0-rc2` with no functional changes; it is a stable
+version tag to support the pending submission of the framework paper to
+*Advances in Engineering Software* (paper J10 in the KSK publication roster)
+and to provide a reproducible citation for papers J2, J5, J6, J8, and J9
+that depend on the framework.
+
+## What is in the release
+
+Same substance as 1.0.0-rc2:
+
+- **OptumGX three-dimensional limit analysis** integration with automated
+  parameter extraction for four foundation modes (A fixed, B six-by-six
+  stiffness, C distributed BNWF, D dissipation-weighted generalised BNWF).
+- **OpenSeesPy structural dynamics** integration with eigenvalue sweep,
+  pushover analysis, and cyclic degradation.
+- **OpenFAST v5 aero-servo-hydro-elastic** coupling via SoilDyn mode with
+  six-by-six stiffness handoff.
+- **Fatigue module** per DNV-RP-C203 with rainflow counting.
+- **Op^3 Studio web application** with eight-tab interactive UI, large-
+  language-model chat sandbox, and Three.js three-dimensional visualisation.
+- **Mooring anchor module** with novel dissipation-centroid padeye method
+  and one hundred thirty-four validation tests.
+- **Thirty-nine cross-validation benchmarks** from twenty-five-plus published
+  sources at ninety-two percent coverage.
+
+## Verification
+
+Test suite at the release tag:
+
+- 362 passed, 11 skipped (optional data not bundled in this checkout).
+- Zero failures after the 2026-04-16 cp949 encoding fix in
+  `tests/test_op3_framework.py::TestSSOTConfig::test_yaml_exists_and_parses`
+  (explicit `encoding="utf-8"` added).
+
+## Installation
+
+```bash
+pip install op3-framework==1.0.0
+```
+
+or directly from this release on GitHub:
+
+```bash
+pip install https://github.com/ksk5429/numerical_model/releases/download/v1.0.0/op3_framework-1.0.0-py3-none-any.whl
+```
+
+## Citing
+
+```
+@software{op3_2026,
+  author  = {Kim, Kyeong Sun},
+  title   = {Op^3: OptumGX-OpenSeesPy-OpenFAST integrated numerical
+             modeling framework for offshore wind turbines},
+  version = {1.0.0},
+  date    = {2026-04-16},
+  doi     = {10.5281/zenodo.19476542},
+  url     = {https://github.com/ksk5429/numerical_model}
+}
+```
+
+## Changes versus 1.0.0-rc2
+
+- Version string bumped to `1.0.0` in `op3/__init__.py`,
+  `pyproject.toml`, `CITATION.cff`, and `docs/sphinx/conf.py`.
+- `__release_date__` attribute added to `op3/__init__.py`.
+- Pre-existing Windows cp949 encoding bug in
+  `tests/test_op3_framework.py::TestSSOTConfig::test_yaml_exists_and_parses`
+  fixed by specifying `encoding="utf-8"` when reading the YAML that
+  contains Korean site metadata.
+
+No library behaviour changes. Papers J2, J5, J6, J8, and J9 that cite
+the framework can use `1.0.0` as a pinned version.
+
+## Known limitations carried from 1.0.0-rc2
+
+- Scour mode validated on Gunsan normally consolidated clay only;
+  applicability boundaries to other soil classes are discussed in
+  the companion OE-D-26-00984 paper.
+- Anchor mode validated on one hundred thirty-four reference tests;
+  field validation is open.
+- OpenFAST coupling is tested against NREL reference turbines;
+  utility-scale commercial OWT turbines are not yet validated.
+- Op^3 Studio is a research prototype, not production-hardened.
+
+## Manual publish steps (pending after local build)
+
+The following steps require user credentials and cannot be completed
+automatically. They are listed for user action.
+
+1. **Rotate the PyPI token** (pending manual task #1 in memory). The
+   previous token was exposed in conversation and should be revoked at
+   <https://pypi.org/manage/account/token/>. Generate a new token scoped
+   to `op3-framework` and store it in `~/.pypirc` or the environment
+   variable `TWINE_PASSWORD`.
+
+2. **Upload wheel and source distribution to PyPI.**
+
+   ```bash
+   cd F:/GITHUB3/numerical_model_fresh
+   python -m twine upload dist/op3_framework-1.0.0*
+   ```
+
+3. **Create the Git tag and push.**
+
+   ```bash
+   cd F:/GITHUB3/numerical_model_fresh
+   git add -A
+   git commit -m "release: v1.0.0"
+   git tag -a v1.0.0 -m "Op^3 v1.0.0 stable release"
+   git push origin main --tags
+   ```
+
+4. **Create the GitHub release.** Either in the web UI at
+   <https://github.com/ksk5429/numerical_model/releases/new?tag=v1.0.0>
+   or via the `gh` CLI:
+
+   ```bash
+   gh release create v1.0.0 dist/op3_framework-1.0.0-py3-none-any.whl \
+     dist/op3_framework-1.0.0.tar.gz \
+     --title "Op^3 v1.0.0" \
+     --notes-file RELEASE_NOTES_v1.0.0.md
+   ```
+
+5. **Zenodo mint.** Zenodo automatically mints a DOI for the GitHub
+   release if the repository has the Zenodo integration enabled. Verify
+   at <https://zenodo.org/account/settings/github/> that the repository
+   is switched on. The concept DOI `10.5281/zenodo.19476542` stays
+   constant; a new version DOI is assigned to this release.
+
+6. **Update README badge.** After PyPI upload succeeds, the README
+   version badge should automatically reflect `1.0.0`. Verify manually.
+
+## What does not happen in this release
+
+- No breaking API changes.
+- No dependency changes.
+- No new tests or benchmarks (the test suite remains at 362 passing).
+- No new documentation pages; the Sphinx content is identical to rc2.

docs/sphinx/conf.py

@@ -39,8 +39,8 @@
 project = "Op^3 -- Integrated Numerical and Digital Twin Framework"
 author = "Kim Kyeong Sun (Seoul National University)"
 copyright = "2026, Kim Kyeong Sun"
-release = "1.0.0-rc2"
-version = "1.0.0-rc2"
+release = "1.0.0"
+version = "1.0.0"
 
 
 # -- General configuration ---------------------------------------------------

op3/__init__.py

@@ -13,13 +13,14 @@
     freqs = model.eigen(n_modes=3)
 """
 
+__version__ = "1.0.0"
+__release_date__ = "2026-04-16"
+
 from op3.config import load_site_config
 from op3.foundations import build_foundation, FoundationMode
 from op3.composer import compose_tower_model
 from op3.cross_compare import cross_compare
 
-__version__ = "1.0.0-rc2"
-
 __all__ = [
     "load_site_config",
     "build_foundation",

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "op3-framework"
-version = "1.0.0-rc2"
+version = "1.0.0"
 description = "OptumGX-OpenSeesPy-OpenFAST integration framework for offshore wind turbine foundations"
 readme = "README.md"
 requires-python = ">=3.11"

tests/test_op3_framework.py

@@ -153,7 +153,11 @@ class TestSSOTConfig:
 
     def test_yaml_exists_and_parses(self):
         import yaml
-        cfg = yaml.safe_load((REPO_ROOT / "op3" / "config" / "site_a.yaml").read_text())
+        # Explicit UTF-8 encoding is required because the YAML contains
+        # Korean site metadata; Windows cp949 default decoder fails on it.
+        cfg = yaml.safe_load(
+            (REPO_ROOT / "op3" / "config" / "site_a.yaml").read_text(encoding="utf-8")
+        )
         assert cfg is not None
         assert isinstance(cfg, dict)