pyqicharts 2.0.0__tar.gz

pyqicharts-2.0.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,22 @@
+---
+name: Bug report
+about: Report a reproducible problem
+title: "[Bug]: "
+labels: bug
+---
+
+## What happened?
+
+## Minimal example
+
+## Expected behaviour
+
+## Environment
+
+- pyqicharts version:
+- Python version:
+- Operating system:
+
+## Validation impact
+
+Does this affect calculations, reporting, packaging or documentation?

pyqicharts-2.0.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: Feature request
+about: Suggest an improvement
+title: "[Feature]: "
+labels: enhancement
+---
+
+## Problem to solve
+
+## Proposed behaviour
+
+## Example usage
+
+## Validation or documentation needed

pyqicharts-2.0.0/.github/pull_request_template.md

@@ -0,0 +1,9 @@
+## Summary
+
+## Public API impact
+
+## Validation impact
+
+## Tests run
+
+## Documentation updated

pyqicharts-2.0.0/.github/workflows/tests.yml

@@ -0,0 +1,27 @@
+name: Tests
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    env:
+      MPLBACKEND: Agg
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .[dev]
+      - name: Test
+        run: pytest --cov=pyqicharts --cov-report=term-missing

pyqicharts-2.0.0/API_STABILITY.md

@@ -0,0 +1,75 @@
+# API Stability
+
+Status: v2.0.0.
+
+pyqicharts keeps the simple charting interface central and treats public APIs as additive from this stable production release onward.
+
+## Stable Core APIs
+
+- `qic(...)`
+- `qic_table(...)`
+- `pareto_chart(...)`
+- `pareto_table(...)`
+- `paretochart(...)` alias
+
+## Stable Reporting APIs
+
+- `export_png(...)`
+- `export_excel(...)`
+- `export_powerpoint(...)`
+- `create_report_bundle(...)`
+- `create_qi_report_pack(...)`
+- `create_report_pack_from_config(...)`
+- `load_chart_config(...)`
+- `run_chart_batch(...)`
+
+## Stable Dashboard And Table APIs
+
+- `powerbi_table(...)`
+- `spc_summary_table(...)`
+- `special_cause_summary_table(...)`
+- `signal_table(...)`
+- `kpi_table(...)`
+- `interpretation_table(...)`
+- `improvement_output_table(...)`
+- `improvement_warning_table(...)`
+- `phase_metadata_table(...)`
+- `intervention_metadata_table(...)`
+- `target_metadata_table(...)`
+
+## Stable Sample And Validation APIs
+
+- `sample_healthcare_qi_data()`
+- `sample_subgroup_measurements()`
+- `get_sample_data_path(filename)`
+- `validation_manifest()`
+- `validation_summary()`
+- `compare_to_expected(...)`
+
+## Optional Interactive APIs
+
+- `qic_plotly(...)`
+- `qic_altair(...)`
+- `qic_widget(...)`
+
+## Education And Exploratory APIs
+
+- `simulate_process(...)`
+- `teaching_dataset(...)`
+- `chart_selection_tutorial()`
+- `interpretation_mistakes()`
+- `autocorrelation_diagnostics(...)`
+- `seasonality_diagnostics(...)`
+- `overdispersion_test(...)`
+- `funnel_table(...)`
+- `rare_event_limits(...)`
+- `risk_adjusted_summary(...)`
+- `interactive_signal_review(...)`
+
+## Deprecations
+
+No public API is deprecated in v2.0.0. Future removals should be documented for at least one minor release before removal.
+
+## Schema Versioning
+
+Power and reporting table schemas are intended to be additive. New columns may be added; existing public columns should not be renamed without a deprecation period.

pyqicharts-2.0.0/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## 2.0.0 - 2026-07-04
+
+This stable production release rolls the package forward into a production-readiness phase focused on validation evidence, analyst workflows, governance and maintainability.
+
+### Added
+
+- Validation manifest APIs: `validation_manifest()`, `validation_summary()` and `compare_to_expected(...)`.
+- Batch reporting APIs: `load_chart_config(...)`, `run_chart_batch(...)` and `create_report_pack_from_config(...)`.
+- Command-line routes for configured report generation and CSV/config validation.
+- Advanced exploratory helpers for autocorrelation, seasonality, overdispersion, funnel tables, rare-event limits and risk-adjusted summaries.
+- Education helpers for teaching datasets, process simulation, chart selection and interpretation mistakes.
+- Optional notebook widget helper.
+- Plotly, Altair, batch-report and teaching examples.
+- Release governance files for contribution, citation, conduct, security, issues and pull requests.
+- Report metadata schema output for configured report packs.
+
+### Changed
+
+- Version metadata updated to `2.0.0`.
+- User-facing error messages now explain missing columns, non-numeric values, invalid denominators, missing expected values, unknown chart types and empty datasets more clearly.
+- Root markdown files have been reduced, with specialist reports moved under `docs/reports/`.
+- Package manifest now includes the new release governance files, examples and notebook assets.
+
+### Validation Notes
+
+The stable production release includes internal regression tests and reviewed deterministic examples. It does not claim independent external certification against live third-party outputs.
+
+## 1.7.0 - 2026-07-04
+
+- Added compatibility-audit reporting helpers and warning-table coverage.
+- Preserved neutral project naming and independent-project wording.

pyqicharts-2.0.0/CITATION.cff

@@ -0,0 +1,14 @@
+cff-version: 1.2.0
+message: "If you use pyqicharts in published work, please cite the software release."
+title: "pyqicharts: Quality Improvement and Statistical Process Control charts for Python"
+version: "2.0.0"
+date-released: "2026-07-04"
+authors:
+  - name: "Assegai Studios Ltd"
+license: "MIT"
+repository-code: "https://github.com/AssegaiStudios/Quality-improvement-charts"
+keywords:
+  - quality improvement
+  - statistical process control
+  - run charts
+  - healthcare analytics

pyqicharts-2.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Code of Conduct
+
+pyqicharts aims to be a constructive, respectful project for analysts, developers, educators and quality-improvement teams.
+
+Participants are expected to:
+
+- Be respectful and patient.
+- Assume good intent while remaining open to correction.
+- Welcome contributors with different levels of technical or statistical experience.
+- Focus criticism on ideas, evidence and implementation details.
+- Avoid harassment, discriminatory language or personal attacks.
+
+Project maintainers may remove comments, issues or contributions that do not meet these expectations.

pyqicharts-2.0.0/CONTRIBUTING.md

@@ -0,0 +1,30 @@
+# Contributing
+
+Thank you for considering a contribution to pyqicharts.
+
+## Development Setup
+
+1. Create a fresh Python environment.
+2. Install the package in editable development mode with the development extras:
+
+```bash
+python -m pip install -e .[dev]
+```
+
+3. Run the tests:
+
+```bash
+python -m pytest --cov=pyqicharts
+```
+
+## Contribution Expectations
+
+- Keep public APIs backwards compatible unless a deprecation has already been documented.
+- Add or update tests for calculation, export, documentation or packaging changes.
+- Keep optional dependencies behind lazy imports or optional extras.
+- Do not add generated cache files, temporary files or local build artefacts.
+- Document validation scope clearly: distinguish internal tests, reviewed examples and external certification.
+
+## Pull Requests
+
+Please include a short description of the change, user impact, tests run and any validation evidence affected.

pyqicharts-2.0.0/DISCLAIMER.md

@@ -0,0 +1,15 @@
+# Disclaimer
+
+pyqicharts is an independent open-source Python package for Quality Improvement (QI) and Statistical Process Control (SPC) charting.
+
+The package is provided by Assegai Studios Ltd as a general analytical and educational tool. It is not produced, commissioned, approved, endorsed, certified or maintained by any government body, public healthcare organisation, health service, regulator, software vendor or standards authority.
+
+The methods implemented in pyqicharts draw on widely used QI and SPC principles, published statistical process-control methodology and common healthcare-improvement practice. Any resemblance to established public-sector reporting workflows, spreadsheet tools or dashboard conventions reflects shared statistical concepts and common improvement terminology, not ownership, sponsorship or formal affiliation.
+
+Users are responsible for checking that outputs are appropriate for their own data, governance requirements and local decision-making processes. pyqicharts should not be used as the sole basis for clinical, operational, financial, legal or safety-critical decisions without suitable professional review.
+
+The package is supplied without warranty. The maintainers do not guarantee that calculations, interpretations, examples, datasets, exports or reports are error-free or suitable for every use case. Validation evidence included with the project supports development and regression testing, but does not replace local assurance, statistical review or organisational approval.
+
+Sample and synthetic datasets are included for demonstration and testing. Public-data extracts, where present, are included for reproducible examples and retain their own source provenance. Inclusion of any public-data-derived example does not imply endorsement by the original publisher.
+
+Product names, organisation names and trademarks belong to their respective owners. References in documentation are descriptive only.

pyqicharts-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Assegai Studios Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyqicharts-2.0.0/MANIFEST.in

@@ -0,0 +1,27 @@
+include README.md
+include CHANGELOG.md
+include PARITY_REPORT.md
+include VALIDATION_REPORT.md
+include API_STABILITY.md
+include DISCLAIMER.md
+include ROADMAP.md
+include CITATION.cff
+include CONTRIBUTING.md
+include CODE_OF_CONDUCT.md
+include SECURITY.md
+include LICENSE
+recursive-include docs *.md
+recursive-include datasets *.md *.csv *.xlsx
+recursive-include examples *.py *.xlsx *.json *.ipynb
+recursive-include office_addin *.md *.xml
+recursive-include tests *.py
+recursive-include validation *.md *.csv
+recursive-include validation_data *.md *.csv
+recursive-include sample_data *.csv
+recursive-include src/pyqicharts/sample_data *.csv
+recursive-include excel *.md *.xlsx *.xlsm
+recursive-include .github *.yml *.md
+prune dist
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude .pytest_cache

pyqicharts-2.0.0/PARITY_REPORT.md

@@ -0,0 +1,31 @@
+# Parity And Scope Report
+
+Release: v2.0.0 stable production release.
+
+pyqicharts is now a specification-complete, validation-enhanced parity implementation for practical QI/SPC work in Python.
+
+## Implemented Scope
+
+- Run charts and Anhøj-style run chart signals.
+- Individuals and moving range charts.
+- C, P and U attribute charts.
+- Xbar and S subgroup charts.
+- G and T rare-event charts.
+- P-prime and U-prime risk-adjusted charts.
+- Pareto charts.
+- Baselines, recalculation periods, phases, freeze points, break points, exclusions, targets and interventions.
+- Improvement, concern and neutral interpretation fields.
+- Warning and interpretation tables for reporting workflows.
+- Excel, PowerPoint, PNG, dashboard-friendly and batch-report outputs.
+- Optional Plotly, Altair and notebook widget helpers.
+- Sample data, synthetic datasets, teaching helpers and example gallery.
+
+## Validation Scope
+
+The package includes reviewed deterministic expected-output examples and automated regression tests. It does not claim external certification against any third-party software or workbook outputs.
+
+## Known Limitations
+
+- Optional interactive libraries are not installed with the core package.
+- Rare-event and risk-adjusted charts require local analyst review of assumptions before operational use.
+- External certification packs can be added later without changing the public API.

pyqicharts-2.0.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: pyqicharts
+Version: 2.0.0
+Summary: Quality Improvement and Statistical Process Control charts for Python
+Author: Assegai Studios Ltd
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AssegaiStudios/Quality-improvement-charts
+Project-URL: Repository, https://github.com/AssegaiStudios/Quality-improvement-charts
+Project-URL: Issues, https://github.com/AssegaiStudios/Quality-improvement-charts/issues
+Keywords: quality improvement,statistical process control,spc,run charts,control charts,healthcare analytics,power bi,excel
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.22
+Requires-Dist: pandas>=1.5
+Requires-Dist: matplotlib>=3.5
+Provides-Extra: reporting
+Requires-Dist: openpyxl>=3.1; extra == "reporting"
+Requires-Dist: python-pptx>=0.6.23; extra == "reporting"
+Provides-Extra: excel
+Requires-Dist: xlwings>=0.30; extra == "excel"
+Requires-Dist: openpyxl>=3.1; extra == "excel"
+Requires-Dist: python-pptx>=0.6.23; extra == "excel"
+Provides-Extra: interactive
+Requires-Dist: plotly>=5; extra == "interactive"
+Requires-Dist: altair>=5; extra == "interactive"
+Requires-Dist: ipywidgets>=8; extra == "interactive"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Requires-Dist: check-manifest>=0.50; extra == "dev"
+Requires-Dist: openpyxl>=3.1; extra == "dev"
+Requires-Dist: python-pptx>=0.6.23; extra == "dev"
+Requires-Dist: xlwings>=0.30; extra == "dev"
+Requires-Dist: plotly>=5; extra == "dev"
+Requires-Dist: altair>=5; extra == "dev"
+Requires-Dist: ipywidgets>=8; extra == "dev"
+Dynamic: license-file
+
+# pyqicharts
+
+**2.0.0 stable production release**
+
+pyqicharts is a Python package for Quality Improvement and Statistical Process Control charting. It is designed for analysts who need practical run charts, control charts, validation examples, sample data, reporting exports and education material.
+
+The package is an independent open-source project by Assegai Studios Ltd. It is influenced by widely used quality-improvement and SPC methods, but it is not an official publication or endorsed implementation of any public body, vendor or external software project.
+
+## Install
+
+```bash
+python -m pip install pyqicharts
+```
+
+For reporting exports:
+
+```bash
+python -m pip install pyqicharts[reporting]
+```
+
+For interactive notebook outputs:
+
+```bash
+python -m pip install pyqicharts[interactive]
+```
+
+For development and test work:
+
+```bash
+python -m pip install -e .[dev]
+python -m pytest --cov=pyqicharts
+```
+
+## Quick Start
+
+```python
+from pyqicharts import qic, sample_healthcare_qi_data
+
+sample = sample_healthcare_qi_data()
+chart = qic(sample, x="month", y="wait_time", chart="i")
+chart.save_png("waiting_times.png")
+```
+
+## Sample Data
+
+```python
+from pyqicharts import sample_healthcare_qi_data, sample_subgroup_measurements, get_sample_data_path
+
+healthcare = sample_healthcare_qi_data()
+subgroups = sample_subgroup_measurements()
+path = get_sample_data_path("sample_healthcare_qi_data.csv")
+```
+
+## Main Public APIs
+
+- `qic(...)` creates a matplotlib chart and returns a `QicResult`.
+- `qic_table(...)` returns the calculation table as a pandas DataFrame.
+- `pareto_chart(...)` and `pareto_table(...)` support Pareto workflows.
+- `export_png(...)`, `export_excel(...)`, `export_powerpoint(...)` and `create_report_bundle(...)` support reporting.
+- `create_report_pack_from_config(...)`, `load_chart_config(...)` and `run_chart_batch(...)` support batch report workflows.
+- `powerbi_table(...)`, `spc_summary_table(...)`, `signal_table(...)` and related helpers support dashboard imports.
+- `validation_manifest(...)`, `validation_summary(...)` and `compare_to_expected(...)` support reviewed validation workflows.
+- `qic_plotly(...)`, `qic_altair(...)` and `qic_widget(...)` provide optional interactive outputs.
+
+## Command Line
+
+```bash
+pyqicharts chart data.csv --x week --y value --chart i --output chart.png
+pyqicharts report config.yml --output report
+pyqicharts validate data.csv --config chart.yml
+```
+
+## Validation Scope
+
+The v2 stable production release distinguishes three kinds of evidence:
+
+1. Internal regression tests: automated tests that guard package behaviour.
+2. Reviewed examples: deterministic fixtures and expected-output tables reviewed for methodology consistency.
+3. External certification: independently certified reference outputs. These are not bundled in this stable production release.
+
+See `VALIDATION_REPORT.md`, `PARITY_REPORT.md` and `docs/reports/statistical_review.md` for details.
+
+## Governance
+
+For high-stakes use, validate local workflows with local subject-matter experts, maintain a record of data definitions, review chart choice, and document any operational decisions made from chart outputs.

pyqicharts-2.0.0/README.md

@@ -0,0 +1,85 @@
+# pyqicharts
+
+**2.0.0 stable production release**
+
+pyqicharts is a Python package for Quality Improvement and Statistical Process Control charting. It is designed for analysts who need practical run charts, control charts, validation examples, sample data, reporting exports and education material.
+
+The package is an independent open-source project by Assegai Studios Ltd. It is influenced by widely used quality-improvement and SPC methods, but it is not an official publication or endorsed implementation of any public body, vendor or external software project.
+
+## Install
+
+```bash
+python -m pip install pyqicharts
+```
+
+For reporting exports:
+
+```bash
+python -m pip install pyqicharts[reporting]
+```
+
+For interactive notebook outputs:
+
+```bash
+python -m pip install pyqicharts[interactive]
+```
+
+For development and test work:
+
+```bash
+python -m pip install -e .[dev]
+python -m pytest --cov=pyqicharts
+```
+
+## Quick Start
+
+```python
+from pyqicharts import qic, sample_healthcare_qi_data
+
+sample = sample_healthcare_qi_data()
+chart = qic(sample, x="month", y="wait_time", chart="i")
+chart.save_png("waiting_times.png")
+```
+
+## Sample Data
+
+```python
+from pyqicharts import sample_healthcare_qi_data, sample_subgroup_measurements, get_sample_data_path
+
+healthcare = sample_healthcare_qi_data()
+subgroups = sample_subgroup_measurements()
+path = get_sample_data_path("sample_healthcare_qi_data.csv")
+```
+
+## Main Public APIs
+
+- `qic(...)` creates a matplotlib chart and returns a `QicResult`.
+- `qic_table(...)` returns the calculation table as a pandas DataFrame.
+- `pareto_chart(...)` and `pareto_table(...)` support Pareto workflows.
+- `export_png(...)`, `export_excel(...)`, `export_powerpoint(...)` and `create_report_bundle(...)` support reporting.
+- `create_report_pack_from_config(...)`, `load_chart_config(...)` and `run_chart_batch(...)` support batch report workflows.
+- `powerbi_table(...)`, `spc_summary_table(...)`, `signal_table(...)` and related helpers support dashboard imports.
+- `validation_manifest(...)`, `validation_summary(...)` and `compare_to_expected(...)` support reviewed validation workflows.
+- `qic_plotly(...)`, `qic_altair(...)` and `qic_widget(...)` provide optional interactive outputs.
+
+## Command Line
+
+```bash
+pyqicharts chart data.csv --x week --y value --chart i --output chart.png
+pyqicharts report config.yml --output report
+pyqicharts validate data.csv --config chart.yml
+```
+
+## Validation Scope
+
+The v2 stable production release distinguishes three kinds of evidence:
+
+1. Internal regression tests: automated tests that guard package behaviour.
+2. Reviewed examples: deterministic fixtures and expected-output tables reviewed for methodology consistency.
+3. External certification: independently certified reference outputs. These are not bundled in this stable production release.
+
+See `VALIDATION_REPORT.md`, `PARITY_REPORT.md` and `docs/reports/statistical_review.md` for details.
+
+## Governance
+
+For high-stakes use, validate local workflows with local subject-matter experts, maintain a record of data definitions, review chart choice, and document any operational decisions made from chart outputs.

pyqicharts-2.0.0/ROADMAP.md

@@ -0,0 +1,27 @@
+# v2 Release Roadmap
+
+## v2.0.0 - Stable Production Release
+
+Focus: polish, validation evidence, governance, documentation, examples, packaging and long-term maintainability.
+
+Included:
+
+- Validation manifest APIs.
+- Batch report configuration APIs and CLI routes.
+- Expanded example gallery.
+- Optional interactive outputs.
+- Education and training helpers.
+- Governance and contribution files.
+- Cleaner root documentation structure.
+- Improved user-facing errors.
+- Packaging and release checks.
+
+## v2.x Future Work
+
+- Add independently certified external validation packs when reviewed outputs are available.
+- Expand workbook templates based on user feedback.
+- Add richer dashboard and notebook workflows.
+- Extend rare-event and risk-adjusted method options.
+- Explore funnel plots and overdispersion workflows further.
+- Add more domain-specific examples while keeping the core API stable.
+- Maintain compatibility with supported Python, pandas and matplotlib versions.

pyqicharts-2.0.0/SECURITY.md

@@ -0,0 +1,18 @@
+# Security Policy
+
+pyqicharts is a local Python package for charting, validation examples and reporting outputs.
+
+## Reporting Security Issues
+
+Please report suspected security issues privately to the project owner rather than opening a public issue first.
+
+Include:
+
+- The affected version.
+- The operating system and Python version.
+- A minimal example of the issue.
+- Any relevant files or configuration, with sensitive data removed.
+
+## Data Handling
+
+pyqicharts does not require users to upload data to an external service. Users remain responsible for data governance, de-identification and local access controls when using sensitive operational data.

pyqicharts-2.0.0/VALIDATION_REPORT.md

@@ -0,0 +1,44 @@
+# Validation Report
+
+Release: v2.0.0 stable production release.
+
+## Evidence Types
+
+pyqicharts separates validation evidence into three categories:
+
+1. Internal regression tests: automated tests that protect package behaviour.
+2. Reviewed examples: deterministic fixture inputs and expected-output tables reviewed against documented calculations.
+3. External certification: independently certified reference outputs produced outside this project.
+
+The v2 stable production release includes the first two categories. It does not bundle independent external certification outputs.
+
+## Validation Manifest
+
+Use:
+
+```python
+from pyqicharts import validation_manifest, validation_summary
+
+manifest = validation_manifest()
+summary = validation_summary(manifest)
+```
+
+The manifest records source, purpose, chart type, expected fields and review status. It covers run, I, MR, C, P, U, Xbar, S, G, T, P-prime, U-prime and Pareto examples.
+
+## Expected Output Comparison
+
+Use `compare_to_expected(actual, expected, columns=None, precision=6)` to compare a calculated table with reviewed expected-output fields. The function returns only mismatches, so an empty table means the selected fields match.
+
+## Governance Checklist
+
+- Confirm the data definition and numerator/denominator logic.
+- Confirm the chosen chart type matches the data-generating process.
+- Confirm any baseline, freeze, exclusion or recalculation decisions are documented before interpretation.
+- Review special-cause signals with operational context.
+- Keep a record of package version, configuration and outputs used for decisions.
+
+## Current Release Gate
+
+The v2.0.0 verification run completed with 208 tests passing and 95.40 percent coverage. Packaging checks should confirm the source distribution, wheel, sample data and console entry points before publication.
+
+