processbehavior 0.2.0__tar.gz → 0.2.1__tar.gz

{processbehavior-0.2.0 → processbehavior-0.2.1}/CHANGELOG.md

@@ -7,6 +7,63 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-09-09
+
+### Fixed
+- **A short series no longer returns an unqualified all-clear from
+  ``detect_signals``.** ``SignalConfig.min_observations`` (default 20) was
+  unreachable: ``SignalDetector`` read a hardcoded per-rule table and never
+  consulted the config, so ``SignalConfig(min_observations=30)`` changed nothing.
+  Separately, the detector already recorded which rules it skipped for length
+  (``rules_skipped``, added in 0.2.0) but ``SignalResult.summary`` ignored that and
+  printed ``✓ No signals detected`` regardless. On a four-point X chart six of the
+  eight rules cannot fire, and the one that can is weakened by any trend in the
+  data, so the checkmark described an examination that had mostly not happened.
+
+  Now: the per-rule table is the *structural* minimum (``RULE_MIN_OBSERVATIONS``,
+  a rule is skipped below it, as before) and ``min_observations`` is the *advisory*
+  minimum. Below it the detector emits a ``ProcessBehaviorWarning`` naming both
+  numbers (one per chart evaluated; silence it with
+  ``warnings.simplefilter('ignore', ProcessBehaviorWarning)`` once a pipeline has
+  accounted for it) and the result is marked partial even when every runnable
+  rule ran.
+  ``SignalResult`` gains ``rules_evaluated``, ``rules_applicable``,
+  ``n_observations``, ``min_observations``, ``below_min_observations`` and
+  ``evaluation_note``; ``is_partial`` / ``evaluation_status`` now also reflect the
+  advisory threshold. A partial evaluation prints
+  ``⚠ Partial evaluation in X: 2 of 8 rules applicable at n=4 (...). No signals
+  from the rules evaluated.`` and the checkmark line is reserved for a complete
+  evaluation. Which rules run, and what they flag, is unchanged. Excel export's
+  Summary sheet adds evaluation status. Reported privately (GHSA-hw63-2x95-fmpv)
+  and in #114.
+- ``SECURITY.md`` supported-versions table said 0.1.x while the prose said 0.2.x.
+  The table now matches the prose.
+
+### Removed
+- **Seven never-called utilities from ``datasets.synthetic``** — ``make_edge_cases``
+  (unseeded, non-deterministic), ``compare_sds_characteristics`` (its docstring
+  table was factually wrong), ``validate_sds_detection`` (vacuous: it compared
+  ``observed_sds`` to the very value it was handed, so it always returned True),
+  ``generate_test_suite``, ``get_sds_info`` + ``print_sds_summary`` (a second,
+  drifting copy of ``SDSRegistry`` metadata), and ``make_large_dataset``. Zero
+  callers existed anywhere in the package, tests, docs, or examples.
+- ``SDSRegistry.print_all_analysis_plans`` and ``SDSRegistry.get_capability_matrix``
+  (same finding: no callers).
+- Dead branches: the Excel exporter's ``_write_stratified_summary_tab`` (unreachable
+  since stratified charts moved to the single-entry ``strata`` payload) and its
+  Series/scalar effects arms; the plotter's legacy underscore-name stratification
+  arm and unused ``_get_data_legend_name``; the ``Study`` arm of the loss
+  function's ``_coerce_ads`` (``assess_loss`` takes an ``AnalysisDataSet``).
+
+### CI / Infrastructure
+- **The Bishop validation gate now bites.** ``validation/e2e_bishop_report.py``
+  exits nonzero when any of its 280 assertions diverge from the reference values
+  (previously it only rendered PASS/FAIL into the report), the publish workflow
+  runs the same gate before any release, the four reference artifacts are
+  SHA-256-pinned by ``tests/test_reference_integrity.py`` and check out
+  byte-exact on every platform, and CODEOWNERS routes any change to the gate's
+  inputs through the maintainer.
+
 ## [0.2.0] - 2026-08-31
 
 ### Removed
@@ -755,7 +812,8 @@ and may change between minor versions until 1.0.
 - `natsort >= 8.0`
 - `plotly >= 5.18, < 7`
 
-[Unreleased]: https://github.com/cnicholas/processbehavior/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/cnicholas/processbehavior/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/cnicholas/processbehavior/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/cnicholas/processbehavior/compare/v0.1.1...v0.2.0
 [0.1.1]: https://github.com/cnicholas/processbehavior/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/cnicholas/processbehavior/releases/tag/v0.1.0

{processbehavior-0.2.0 → processbehavior-0.2.1}/CONTRIBUTING.md

@@ -164,8 +164,12 @@ Releases are published to PyPI by the `Publish` workflow on tag push.
    in `CHANGELOG.md` and update the compare links at the bottom.
 3. Bump the version in `processbehavior/__init__.py` (`__version__`).
    `pyproject.toml` reads it via `[tool.hatch.version]`.
-4. Commit with subject `Release vX.Y.Z`, push to `main`.
-5. Tag and push:
+4. Run `python validation/e2e_bishop_report.py` and commit the regenerated
+   `docs/reference/validation.md`. Its header carries the version string, and
+   the publish workflow fails if the committed page has drifted from what the
+   validator writes.
+5. Commit with subject `Release vX.Y.Z`, push to `main`.
+6. Tag and push:
    ```bash
    git tag -s vX.Y.Z -m "Release vX.Y.Z"
    git push origin vX.Y.Z
@@ -173,7 +177,7 @@ Releases are published to PyPI by the `Publish` workflow on tag push.
    The tag push triggers `.github/workflows/publish.yml`, which builds,
    verifies with `twine check`, and uploads to PyPI via OIDC trusted
    publishing — no API tokens.
-6. Verify the release on https://pypi.org/project/processbehavior/ and run
+7. Verify the release on https://pypi.org/project/processbehavior/ and run
    `pip install processbehavior==X.Y.Z` in a fresh venv to confirm the
    README quickstart still runs end-to-end.
 

{processbehavior-0.2.0 → processbehavior-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: processbehavior
-Version: 0.2.0
+Version: 0.2.1
 Summary: Python-native Process Behavior & Control Charts (spec-driven SPC with tidy outputs)
 Project-URL: Homepage, https://github.com/cnicholas/processbehavior
 Project-URL: Repository, https://github.com/cnicholas/processbehavior
@@ -86,6 +86,7 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://img.shields.io/pypi/v/processbehavior.svg)](https://pypi.org/project/processbehavior/)
 [![Python versions](https://img.shields.io/pypi/pyversions/processbehavior.svg)](https://pypi.org/project/processbehavior/)
 [![CI](https://github.com/cnicholas/processbehavior/actions/workflows/ci.yml/badge.svg)](https://github.com/cnicholas/processbehavior/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/cnicholas/processbehavior/graph/badge.svg)](https://codecov.io/gh/cnicholas/processbehavior)
 [![License](https://img.shields.io/pypi/l/processbehavior.svg)](https://github.com/cnicholas/processbehavior/blob/main/LICENSE)
 
 A Python library for **Process Behavior Analysis** following Thomas A. Bishop's Variance Analysis System (VAS) methodology.

{processbehavior-0.2.0 → processbehavior-0.2.1}/README.md

@@ -3,6 +3,7 @@
 [![PyPI version](https://img.shields.io/pypi/v/processbehavior.svg)](https://pypi.org/project/processbehavior/)
 [![Python versions](https://img.shields.io/pypi/pyversions/processbehavior.svg)](https://pypi.org/project/processbehavior/)
 [![CI](https://github.com/cnicholas/processbehavior/actions/workflows/ci.yml/badge.svg)](https://github.com/cnicholas/processbehavior/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/cnicholas/processbehavior/graph/badge.svg)](https://codecov.io/gh/cnicholas/processbehavior)
 [![License](https://img.shields.io/pypi/l/processbehavior.svg)](https://github.com/cnicholas/processbehavior/blob/main/LICENSE)
 
 A Python library for **Process Behavior Analysis** following Thomas A. Bishop's Variance Analysis System (VAS) methodology.

{processbehavior-0.2.0 → processbehavior-0.2.1}/SECURITY.md

@@ -2,13 +2,13 @@
 
 ## Supported versions
 
-processbehavior is in **alpha** (0.1.x). Only the most recent 0.1.x release
-receives security fixes. 0.2.x is the supported line; 0.1.x is not patched.
+processbehavior is in **alpha**. Only the most recent 0.2.x release receives
+security fixes; 0.1.x is not patched.
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 0.1.x   | :white_check_mark: |
-| < 0.1   | :x:                |
+| 0.2.x   | :white_check_mark: |
+| < 0.2   | :x:                |
 
 ## Reporting a vulnerability
 

{processbehavior-0.2.0 → processbehavior-0.2.1}/processbehavior/__init__.py

@@ -47,7 +47,7 @@ its ``.sds`` field. Internally some modules still use the legacy "SDS"
 prefix (e.g. ``sds_detector.py``); the model itself is three-state.
 """
 
-__version__ = '0.2.0'
+__version__ = '0.2.1'
 
 # Result object
 from processbehavior.analysis_result import AnalysisResult

{processbehavior-0.2.0 → processbehavior-0.2.1}/processbehavior/analysis_result.py

@@ -1029,11 +1029,16 @@ class AnalysisResult:
         >>> from processbehavior.signals import SignalConfig
         >>> config = SignalConfig(
         ...     enabled_rules=['rule_1', 'rule_2'],
-        ...     min_observations=30,
+        ...     min_observations=30,   # below 30 points the result is marked partial
         ...     ignore_first_n=5
         ... )
         >>> signals = result.detect_signals(config=config)
 
+        A short series never returns an unqualified all-clear: when rules were
+        skipped for length, or the series is below ``min_observations``,
+        ``signals.is_partial`` is True and ``signals.summary`` says which rules
+        were evaluated.
+
         Access violations:
 
         >>> signals.by_rule['rule_2']  # Rule 2 violations

{processbehavior-0.2.0 → processbehavior-0.2.1}/processbehavior/datasets/__init__.py

@@ -6,18 +6,13 @@ from __future__ import annotations
 
 from .loaders import load_coffee_shop
 from .synthetic import (
-    compare_sds_characteristics,
-    generate_test_suite,
-    get_sds_info,
     make_design,
-    make_edge_cases,
     make_sds1,
     make_sds2,
     make_sds3,
     make_sds4,
     make_sds5,
     make_sds6,
-    print_sds_summary,
 )
 
 __all__ = [
@@ -28,10 +23,5 @@ __all__ = [
     'make_sds5',
     'make_sds6',
     'make_design',
-    'make_edge_cases',
     'load_coffee_shop',
-    'compare_sds_characteristics',
-    'generate_test_suite',
-    'get_sds_info',
-    'print_sds_summary',
 ]