Implement ActEval 1.0 roadmap

.github/workflows/ci.yml

@@ -16,7 +16,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v7
@@ -36,4 +36,4 @@ jobs:
       - run: >-
           python -c "import acteval as ae;
           assert ae.rmse([1, 2], [1, 2]) == 0;
-          assert ae.__version__ == '0.3.0'"
+          assert ae.__version__ == '1.0.0'"

.github/workflows/release.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v7
       - uses: actions/setup-python@v7
         with:
-          python-version: "3.13"
+          python-version: "3.14"
           cache: pip
       - run: python -m pip install --upgrade pip build
       - run: python -m build

CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 1.0.0 - 2026-08-12
+
+### Stable API and packaging
+
+- Declared the documented public API stable under Semantic Versioning.
+- Centralized package version metadata and moved to the Production/Stable
+  classifier.
+- Added a formal API stability policy and security reporting policy.
+- Reworked the README as a complete Python-library landing page.
+
+### v0.5 reporting and monitoring layer
+
+- Added portfolio-segment evaluation and aligned segment model comparison.
+- Added chronological evaluation with signed changes from a baseline period.
+- Added weighted reference-quantile prediction drift and PSI contributions.
+- Added dependency-light standalone HTML reports and CSV/JSON/HTML exports.
+- Added a supported helper for exporting Matplotlib figures.
+
+### v0.4 statistical inference layer
+
+- Added reproducible percentile-bootstrap intervals for evaluation metrics.
+- Added objective-aware paired bootstrap comparisons against named references.
+- Added fixed-bin stratified bootstrap intervals for calibration tables.
+- Added structured inference results and CSV export.
+
 ## 0.3.0 - 2026-08-12
 
 - Added generic benchmarked financial decision regret.

CITATION.cff

@@ -0,0 +1,13 @@
+cff-version: 1.2.0
+message: "If you use ActEval in research, please cite this software."
+title: "ActEval: model-agnostic evaluation of actuarial predictive models"
+type: software
+authors:
+  - family-names: Manai
+    given-names: Amine
+    email: amine.manai@esprit.tn
+repository-code: "https://github.com/aminemanai2003/acteval"
+url: "https://pypi.org/project/acteval-insurance/"
+license: Apache-2.0
+version: 1.0.0
+date-released: 2026-08-12

CONTRIBUTING.md

@@ -21,6 +21,11 @@ pytest
 python -m build
 ```
 
+CI must pass on every Python version listed in `pyproject.toml`. Public API
+changes must update the API guide, README, changelog, tests, and stability
+policy where relevant. Backward-incompatible changes require a major release
+unless they correct a security issue or materially invalid calculation.
+
 New metrics must document their definition, direction or target, supported
 tasks, domain assumptions, limitations, and references where applicable. Add
 basic, weighted, edge, invalid-input, and known-value tests. Do not introduce a