lss4py 0.2.0__tar.gz → 0.2.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. {lss4py-0.2.0 → lss4py-0.2.2}/PKG-INFO +51 -18
  2. {lss4py-0.2.0 → lss4py-0.2.2}/README.md +46 -16
  3. {lss4py-0.2.0 → lss4py-0.2.2}/pyproject.toml +44 -43
  4. {lss4py-0.2.0 → lss4py-0.2.2}/pyproject.toml.orig +29 -34
  5. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/__init__.py +13 -0
  6. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_bundle_schema.py +296 -0
  7. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_data_quality.py +105 -97
  8. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_event_log.py +39 -44
  9. lss4py-0.2.2/src/lss4py/_frames.py +155 -0
  10. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/_calendar.py +4 -4
  11. lss4py-0.2.2/src/lss4py/_kernels/_contracts.py +37 -0
  12. lss4py-0.2.2/src/lss4py/_kernels/_distribution.py +64 -0
  13. lss4py-0.2.2/src/lss4py/_kernels/_helpers.py +134 -0
  14. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/capability.py +7 -6
  15. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/defect_yield.py +20 -10
  16. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/descriptive.py +23 -27
  17. lss4py-0.2.2/src/lss4py/_kernels/distribution.py +408 -0
  18. lss4py-0.2.2/src/lss4py/_kernels/inference.py +212 -0
  19. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/orders.py +8 -5
  20. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/reconstruction.py +11 -9
  21. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/timing.py +70 -41
  22. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/yield_.py +90 -41
  23. lss4py-0.2.2/src/lss4py/_pandera_validation.py +452 -0
  24. lss4py-0.2.2/src/lss4py/_polars_extract.py +135 -0
  25. lss4py-0.2.2/src/lss4py/_units.py +139 -0
  26. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_version.py +1 -1
  27. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/__init__.py +1 -2
  28. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/contracts.py +13 -20
  29. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/event_log.py +1 -1
  30. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/__init__.py +6 -0
  31. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/_result_io.py +36 -0
  32. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/data_quality.py +2 -3
  33. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/results.py +171 -0
  34. lss4py-0.2.2/src/lss4py/domain/units.py +30 -0
  35. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/integration/__init__.py +14 -1
  36. lss4py-0.2.2/src/lss4py/integration/_process_schema.py +281 -0
  37. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/integration/evidence.py +6 -3
  38. lss4py-0.2.2/src/lss4py/integration/policy.py +155 -0
  39. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/integration/process.py +79 -89
  40. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/observability/logging.py +2 -0
  41. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/observability/telemetry.py +2 -0
  42. lss4py-0.2.2/src/lss4py/reporting/__init__.py +20 -0
  43. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/reporting/bundles.py +1 -0
  44. lss4py-0.2.2/src/lss4py/reporting/visualization.py +177 -0
  45. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/bottleneck.py +1 -0
  46. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/comparison.py +1 -0
  47. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/simulation.py +1 -0
  48. lss4py-0.2.0/src/lss4py/_frames.py +0 -41
  49. lss4py-0.2.0/src/lss4py/_kernels/_contracts.py +0 -80
  50. lss4py-0.2.0/src/lss4py/_kernels/_helpers.py +0 -277
  51. lss4py-0.2.0/src/lss4py/reporting/__init__.py +0 -3
  52. lss4py-0.2.0/src/lss4py/reporting/visualization.py +0 -47
  53. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/__init__.py +0 -0
  54. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_kernels/data_quality.py +0 -0
  55. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/_numeric_log.py +0 -0
  56. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/numeric_log.py +0 -0
  57. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/adapters/tabular.py +0 -0
  58. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/cli.py +0 -0
  59. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/bundles.py +0 -0
  60. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/interval_event_log.py +0 -0
  61. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/models.py +0 -0
  62. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/numeric_log.py +0 -0
  63. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/order_summary.py +0 -0
  64. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/reconstruction.py +0 -0
  65. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/specification.py +0 -0
  66. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/domain/validation.py +0 -0
  67. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/errors.py +0 -0
  68. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/guidance/__init__.py +0 -0
  69. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/observability/__init__.py +0 -0
  70. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/__init__.py +0 -0
  71. {lss4py-0.2.0 → lss4py-0.2.2}/src/lss4py/workflows/process_map.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: lss4py
3
- Version: 0.2.0
3
+ Version: 0.2.2
4
4
  Summary: Python-first Lean Six Sigma analytics for telemetry-rich process improvement
5
5
  Author: shanewilkins
6
6
  Author-email: shanewilkins <shane@wilkinsadvisors.com>
@@ -11,11 +11,14 @@ Requires-Dist: numpy>=2.2.0
11
11
  Requires-Dist: opentelemetry-api>=1.31.0
12
12
  Requires-Dist: opentelemetry-exporter-otlp>=1.31.0
13
13
  Requires-Dist: opentelemetry-sdk>=1.31.0
14
+ Requires-Dist: pandera[polars]>=0.35,<0.36
15
+ Requires-Dist: pint>=0.25,<1
14
16
  Requires-Dist: polars>=1.0.0
17
+ Requires-Dist: pydantic>=2.12,<3
15
18
  Requires-Dist: rich>=13.9.0
16
19
  Requires-Dist: scipy>=1.15.0
17
20
  Requires-Dist: structlog>=24.4.0
18
- Requires-Dist: flo-lang==0.4.2 ; extra == 'integration'
21
+ Requires-Dist: flo-lang==0.5.0 ; extra == 'integration'
19
22
  Requires-Dist: pulp>=2.9.0 ; extra == 'optimization'
20
23
  Requires-Dist: pyomo>=6.8.0 ; extra == 'optimization'
21
24
  Requires-Dist: pandas>=2.2.0 ; extra == 'pandas'
@@ -45,11 +48,12 @@ It is not yet a full SPC, capability, simulation, or deliverables platform.
45
48
 
46
49
  ## Release status
47
50
 
48
- The working tree prepares the unreleased **0.2.0 candidate**. The
49
- [v0.2 acceptance follow-through](docs/assessments/v02-release-readiness.md)
50
- records the completed local fixes and verification. Actual publication and
51
- verification of the official PyPI package remain pending. See the
52
- [release notes](docs/releases/v0.2.0.md) and [migration guide](docs/migration-v0.2.md).
51
+ The working tree prepares the unreleased **0.2.2 candidate**. Version 0.2.1 is
52
+ published and verified from PyPI; the new candidate adds the accepted canonical
53
+ Polars analytical boundary without changing governed results. See the
54
+ [draft 0.2.2 release notes](docs/releases/v0.2.2.md), [canonicalization
55
+ evidence](docs/assessments/v022-canonicalization-evidence.md), and
56
+ [migration guide](docs/migration-v0.2.md).
53
57
 
54
58
  ## Stable Today
55
59
 
@@ -66,6 +70,8 @@ It includes these public functions:
66
70
  - `rolled_yield`
67
71
  - `process_yield` (defect/rework counts, opportunity Yield/FTY/RTY, and DPMO)
68
72
  - `describe` (typed descriptive statistics, optionally grouped)
73
+ - `mean_confidence_interval` (mean estimate, t/z interval, and Shapiro-Wilk diagnostic)
74
+ - `distribution_profile` (histogram, ECDF, Q-Q, IQR, shape and optional KDE evidence)
69
75
  - `capability_indices` (Cp/Cpk/components/intervals and explicit specification Z)
70
76
  - `reconstruct_orders` (declared numeric activity-to-order accounting policy)
71
77
  - `validate_order_summary` (prepared numeric order contract and consistency checks)
@@ -77,8 +83,10 @@ supports explicit nearest-rank percentiles and measurement sums;
77
83
  `process_cycle_efficiency(aggregation="cohort")` returns a ratio of sums with
78
84
  cohort identities and denominator evidence.
79
85
 
80
- See the [descriptive statistics guide](docs/descriptive-statistics.md) for examples
81
- and the statistical conventions.
86
+ See the [descriptive statistics guide](docs/descriptive-statistics.md) and
87
+ [mean confidence interval guide](docs/mean-confidence-interval.md) for examples
88
+ and statistical conventions. The [distribution profile guide](docs/distribution-profile.md)
89
+ documents prepared diagnostic evidence and optional Matplotlib renderers.
82
90
 
83
91
  It also includes a process-model IR for integrating FLO-derived process structure with observed tabular data:
84
92
 
@@ -125,6 +133,11 @@ explicit `DataContract`. `normalize_data` prepares declared columns with auditab
125
133
  opt-in row exclusions. See the [data-quality guide](docs/data-quality.md) for
126
134
  schema, key, timestamp, unit, missingness and duplicate policies.
127
135
 
136
+ `convert_duration_columns` explicitly prepares seconds/minutes/hours using Pint,
137
+ preserving the native backend and recording conversion evidence on an unchanged
138
+ declared clock. See [duration units](docs/duration-units.md); normalization and
139
+ analytical methods retain their existing unit behavior.
140
+
128
141
  `AnalysisBundle.capture` saves typed analyses with source hashes, selections,
129
142
  software versions and linked specifications. Bundles restore without recalculation;
130
143
  a standalone standard-library validator supports reviewers without analytical
@@ -136,7 +149,10 @@ LSS4PY works from two inputs.
136
149
 
137
150
  The FLO side supplies a normalized process model IR.
138
151
 
139
- The observed-data side accepts supported eager dataframe inputs through Narwhals.
152
+ The observed-data side recognizes supported eager dataframe inputs through a
153
+ private Narwhals boundary and executes selected analytical columns on detached
154
+ canonical Polars frames under
155
+ [ADR-0028](docs/adr/0028-canonicalize-supported-eager-analytical-inputs-to-polars.md).
140
156
  Core file ingestion materializes validated Polars frames by default, as recorded in
141
157
  [ADR-0018](docs/adr/0018-use-polars-as-the-canonical-ingestion-backend.md). pandas
142
158
  remains an optional analytical-input backend rather than the package's canonical
@@ -376,13 +392,15 @@ tests use only the Python environment.
376
392
  The repository is currently validated with:
377
393
 
378
394
  - `uv lock --check`
379
- - `uv run --locked lint-imports`
380
- - `uv sync`
395
+ - `uv sync --locked --group dev --extra storage`
381
396
  - `uv run --locked ruff check .`
397
+ - `uv run --locked ruff format --check .`
398
+ - `uv run --locked pre-commit validate-config`
382
399
  - `uv run --locked ty check`
383
- - `uv run --locked xenon --max-absolute B --max-modules A --max-average A src/lss4py tests`
384
- - `uv run --locked pytest`
400
+ - `uv run --locked import-linter lint --config lint_imports_config.ini`
401
+ - `uv run --locked --extra storage pytest --require-pyarrow --cov=src/lss4py --cov-fail-under=90`
385
402
  - `uv run --locked vulture src tests --min-confidence 80`
403
+ - `uv run --locked pip-audit --desc`
386
404
 
387
405
  Install both local hook stages with:
388
406
 
@@ -390,19 +408,30 @@ Install both local hook stages with:
390
408
  uv run pre-commit install --install-hooks --hook-type pre-commit --hook-type pre-push
391
409
  ```
392
410
 
393
- The `pre-commit` stage runs Ruff on changed files and the locked test suite without coverage.
411
+ The `pre-commit` stage runs locked Ruff lint/format on changed files. It does not
412
+ run the test suite; full tests run at pre-push and in CI.
394
413
 
395
414
  The `pre-push` stage and CI run the full locked repository-wide gates.
396
-
397
- CI additionally enforces 90% coverage on the current supported slice and runs
415
+ Pre-push runs the suite once with coverage and requires the Arrow backend;
416
+ Ruff includes production-source security checks; CI and release builds additionally
417
+ require the dependency vulnerability audit.
418
+ Ruff and Vulture hooks use the project's locked tools rather than separate hook
419
+ environments. See [toolchain policy](docs/toolchain.md) for rule selection and
420
+ the distinct checks retained alongside Ruff.
421
+
422
+ CI enforces 90% statement coverage across the full package and runs
398
423
  [installed-wheel end-to-end studies](e2e/README.md) outside the source tree.
399
424
  These exercise CSV ingestion, timing/yield analyses, capability studies, JSON
400
425
  exports, and failure scenarios in base and pandas-extra installations. Run them
401
426
  locally with `uv run --locked python tools/check_wheel.py`.
402
427
  CI and the release build also require the
403
- [FLO ecosystem journey](docs/ecosystem-integration.md), using published FLO 0.4.2
428
+ [FLO ecosystem journey](docs/ecosystem-integration.md), using published FLO 0.5.0
404
429
  and the candidate LSS4PY wheel. Run it with
405
430
  `uv run --locked python tools/check_wheel.py --ecosystem`.
431
+ To verify an already built release artifact without rebuilding it, pass
432
+ `--wheel dist/lss4py-0.2.2-py3-none-any.whl`. Add `--artifacts-dir artifacts/ecosystem`
433
+ to retain per-installation JUnit reports, the tested wheel's SHA-256 and ecosystem
434
+ evidence. CI retains source JUnit/coverage XML and installed-wheel reports for 14 days.
406
435
 
407
436
  ## Roadmap
408
437
 
@@ -426,3 +455,7 @@ now reconstructs all 39 pinned orders through public numeric contracts, retainin
426
455
  load/pass/classification and correction evidence. See the
427
456
  [reconstruction guide](docs/order-reconstruction.md) and saved
428
457
  [audited bundle](examples/white_belt/reconstruction-bundle.json).
458
+
459
+ The [FLO-backed book workflow](docs/flo-book-workflow.md) runs the actual book
460
+ model and observed CSV through model-derived classifications, reconstruction,
461
+ metrics and saved audit evidence using installed packages.
@@ -8,11 +8,12 @@ It is not yet a full SPC, capability, simulation, or deliverables platform.
8
8
 
9
9
  ## Release status
10
10
 
11
- The working tree prepares the unreleased **0.2.0 candidate**. The
12
- [v0.2 acceptance follow-through](docs/assessments/v02-release-readiness.md)
13
- records the completed local fixes and verification. Actual publication and
14
- verification of the official PyPI package remain pending. See the
15
- [release notes](docs/releases/v0.2.0.md) and [migration guide](docs/migration-v0.2.md).
11
+ The working tree prepares the unreleased **0.2.2 candidate**. Version 0.2.1 is
12
+ published and verified from PyPI; the new candidate adds the accepted canonical
13
+ Polars analytical boundary without changing governed results. See the
14
+ [draft 0.2.2 release notes](docs/releases/v0.2.2.md), [canonicalization
15
+ evidence](docs/assessments/v022-canonicalization-evidence.md), and
16
+ [migration guide](docs/migration-v0.2.md).
16
17
 
17
18
  ## Stable Today
18
19
 
@@ -29,6 +30,8 @@ It includes these public functions:
29
30
  - `rolled_yield`
30
31
  - `process_yield` (defect/rework counts, opportunity Yield/FTY/RTY, and DPMO)
31
32
  - `describe` (typed descriptive statistics, optionally grouped)
33
+ - `mean_confidence_interval` (mean estimate, t/z interval, and Shapiro-Wilk diagnostic)
34
+ - `distribution_profile` (histogram, ECDF, Q-Q, IQR, shape and optional KDE evidence)
32
35
  - `capability_indices` (Cp/Cpk/components/intervals and explicit specification Z)
33
36
  - `reconstruct_orders` (declared numeric activity-to-order accounting policy)
34
37
  - `validate_order_summary` (prepared numeric order contract and consistency checks)
@@ -40,8 +43,10 @@ supports explicit nearest-rank percentiles and measurement sums;
40
43
  `process_cycle_efficiency(aggregation="cohort")` returns a ratio of sums with
41
44
  cohort identities and denominator evidence.
42
45
 
43
- See the [descriptive statistics guide](docs/descriptive-statistics.md) for examples
44
- and the statistical conventions.
46
+ See the [descriptive statistics guide](docs/descriptive-statistics.md) and
47
+ [mean confidence interval guide](docs/mean-confidence-interval.md) for examples
48
+ and statistical conventions. The [distribution profile guide](docs/distribution-profile.md)
49
+ documents prepared diagnostic evidence and optional Matplotlib renderers.
45
50
 
46
51
  It also includes a process-model IR for integrating FLO-derived process structure with observed tabular data:
47
52
 
@@ -88,6 +93,11 @@ explicit `DataContract`. `normalize_data` prepares declared columns with auditab
88
93
  opt-in row exclusions. See the [data-quality guide](docs/data-quality.md) for
89
94
  schema, key, timestamp, unit, missingness and duplicate policies.
90
95
 
96
+ `convert_duration_columns` explicitly prepares seconds/minutes/hours using Pint,
97
+ preserving the native backend and recording conversion evidence on an unchanged
98
+ declared clock. See [duration units](docs/duration-units.md); normalization and
99
+ analytical methods retain their existing unit behavior.
100
+
91
101
  `AnalysisBundle.capture` saves typed analyses with source hashes, selections,
92
102
  software versions and linked specifications. Bundles restore without recalculation;
93
103
  a standalone standard-library validator supports reviewers without analytical
@@ -99,7 +109,10 @@ LSS4PY works from two inputs.
99
109
 
100
110
  The FLO side supplies a normalized process model IR.
101
111
 
102
- The observed-data side accepts supported eager dataframe inputs through Narwhals.
112
+ The observed-data side recognizes supported eager dataframe inputs through a
113
+ private Narwhals boundary and executes selected analytical columns on detached
114
+ canonical Polars frames under
115
+ [ADR-0028](docs/adr/0028-canonicalize-supported-eager-analytical-inputs-to-polars.md).
103
116
  Core file ingestion materializes validated Polars frames by default, as recorded in
104
117
  [ADR-0018](docs/adr/0018-use-polars-as-the-canonical-ingestion-backend.md). pandas
105
118
  remains an optional analytical-input backend rather than the package's canonical
@@ -339,13 +352,15 @@ tests use only the Python environment.
339
352
  The repository is currently validated with:
340
353
 
341
354
  - `uv lock --check`
342
- - `uv run --locked lint-imports`
343
- - `uv sync`
355
+ - `uv sync --locked --group dev --extra storage`
344
356
  - `uv run --locked ruff check .`
357
+ - `uv run --locked ruff format --check .`
358
+ - `uv run --locked pre-commit validate-config`
345
359
  - `uv run --locked ty check`
346
- - `uv run --locked xenon --max-absolute B --max-modules A --max-average A src/lss4py tests`
347
- - `uv run --locked pytest`
360
+ - `uv run --locked import-linter lint --config lint_imports_config.ini`
361
+ - `uv run --locked --extra storage pytest --require-pyarrow --cov=src/lss4py --cov-fail-under=90`
348
362
  - `uv run --locked vulture src tests --min-confidence 80`
363
+ - `uv run --locked pip-audit --desc`
349
364
 
350
365
  Install both local hook stages with:
351
366
 
@@ -353,19 +368,30 @@ Install both local hook stages with:
353
368
  uv run pre-commit install --install-hooks --hook-type pre-commit --hook-type pre-push
354
369
  ```
355
370
 
356
- The `pre-commit` stage runs Ruff on changed files and the locked test suite without coverage.
371
+ The `pre-commit` stage runs locked Ruff lint/format on changed files. It does not
372
+ run the test suite; full tests run at pre-push and in CI.
357
373
 
358
374
  The `pre-push` stage and CI run the full locked repository-wide gates.
359
-
360
- CI additionally enforces 90% coverage on the current supported slice and runs
375
+ Pre-push runs the suite once with coverage and requires the Arrow backend;
376
+ Ruff includes production-source security checks; CI and release builds additionally
377
+ require the dependency vulnerability audit.
378
+ Ruff and Vulture hooks use the project's locked tools rather than separate hook
379
+ environments. See [toolchain policy](docs/toolchain.md) for rule selection and
380
+ the distinct checks retained alongside Ruff.
381
+
382
+ CI enforces 90% statement coverage across the full package and runs
361
383
  [installed-wheel end-to-end studies](e2e/README.md) outside the source tree.
362
384
  These exercise CSV ingestion, timing/yield analyses, capability studies, JSON
363
385
  exports, and failure scenarios in base and pandas-extra installations. Run them
364
386
  locally with `uv run --locked python tools/check_wheel.py`.
365
387
  CI and the release build also require the
366
- [FLO ecosystem journey](docs/ecosystem-integration.md), using published FLO 0.4.2
388
+ [FLO ecosystem journey](docs/ecosystem-integration.md), using published FLO 0.5.0
367
389
  and the candidate LSS4PY wheel. Run it with
368
390
  `uv run --locked python tools/check_wheel.py --ecosystem`.
391
+ To verify an already built release artifact without rebuilding it, pass
392
+ `--wheel dist/lss4py-0.2.2-py3-none-any.whl`. Add `--artifacts-dir artifacts/ecosystem`
393
+ to retain per-installation JUnit reports, the tested wheel's SHA-256 and ecosystem
394
+ evidence. CI retains source JUnit/coverage XML and installed-wheel reports for 14 days.
369
395
 
370
396
  ## Roadmap
371
397
 
@@ -389,3 +415,7 @@ now reconstructs all 39 pinned orders through public numeric contracts, retainin
389
415
  load/pass/classification and correction evidence. See the
390
416
  [reconstruction guide](docs/order-reconstruction.md) and saved
391
417
  [audited bundle](examples/white_belt/reconstruction-bundle.json).
418
+
419
+ The [FLO-backed book workflow](docs/flo-book-workflow.md) runs the actual book
420
+ model and observed CSV through model-derived classifications, reconstruction,
421
+ metrics and saved audit evidence using installed packages.
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "lss4py"
3
- version = "0.2.0"
3
+ version = "0.2.2"
4
4
  description = "Python-first Lean Six Sigma analytics for telemetry-rich process improvement"
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -12,7 +12,10 @@ dependencies = [
12
12
  "opentelemetry-api>=1.31.0",
13
13
  "opentelemetry-exporter-otlp>=1.31.0",
14
14
  "opentelemetry-sdk>=1.31.0",
15
+ "pandera[polars]>=0.35,<0.36",
16
+ "pint>=0.25,<1",
15
17
  "polars>=1.0.0",
18
+ "pydantic>=2.12,<3",
16
19
  "rich>=13.9.0",
17
20
  "scipy>=1.15.0",
18
21
  "structlog>=24.4.0",
@@ -23,7 +26,7 @@ name = "shanewilkins"
23
26
  email = "shane@wilkinsadvisors.com"
24
27
 
25
28
  [project.optional-dependencies]
26
- integration = ["flo-lang==0.4.2"]
29
+ integration = ["flo-lang==0.5.0"]
27
30
  pandas = ["pandas>=2.2.0"]
28
31
  process-mining = ["pm4py>=2.7.0"]
29
32
  simulation = ["simpy>=4.1.0"]
@@ -44,28 +47,24 @@ storage = [
44
47
  lss4py = "lss4py.cli:main"
45
48
 
46
49
  [build-system]
47
- requires = ["uv_build>=0.10.0,<0.13.0"]
50
+ requires = ["uv_build>=0.13.5,<0.14.0"]
48
51
  build-backend = "uv_build"
49
52
 
50
53
  [dependency-groups]
51
54
  dev = [
52
- "bandit>=1.8.0",
53
55
  "import-linter>=2.1",
54
56
  "matplotlib>=3.10.0",
55
- "interrogate>=1.5.0",
56
57
  "pandas>=2.2.0",
57
58
  "pip-audit>=2.6.0",
58
59
  "pre-commit>=4.1.0",
59
- "pydocstyle>=6.3.0",
60
60
  "pyarrow>=19.0.0",
61
61
  "pytest>=8.3.0",
62
62
  "pytest-cov>=6.0.0",
63
- "ruff>=0.9.0",
63
+ "ruff>=0.17.2",
64
64
  "seaborn>=0.13.0",
65
65
  "twine>=6.0.0",
66
66
  "ty>=0.0.77",
67
67
  "vulture>=2.13",
68
- "xenon>=0.9.3",
69
68
  ]
70
69
 
71
70
  [tool.ruff]
@@ -79,54 +78,56 @@ select = [
79
78
  "I",
80
79
  "UP",
81
80
  "B",
81
+ "C901",
82
+ "D",
83
+ "C4",
84
+ "PIE",
85
+ "RUF100",
86
+ "RUF043",
87
+ "PT012",
88
+ "SIM102",
89
+ "SIM114",
90
+ "S",
91
+ "PLE2502",
82
92
  ]
93
+ ignore = [
94
+ "D100",
95
+ "D101",
96
+ "D104",
97
+ "S101",
98
+ ]
99
+
100
+ [tool.ruff.lint.mccabe]
101
+ max-complexity = 10
102
+
103
+ [tool.ruff.lint.pydocstyle]
104
+ convention = "google"
105
+
106
+ [tool.ruff.lint.per-file-ignores]
107
+ "tests/**" = [
108
+ "D",
109
+ "S",
110
+ ]
111
+ "e2e/**" = [
112
+ "D",
113
+ "S",
114
+ ]
115
+ "tools/**" = ["S"]
116
+ "examples/**" = ["S"]
83
117
 
84
118
  [tool.pytest.ini_options]
85
119
  testpaths = ["tests"]
86
- addopts = "-q"
120
+ addopts = "-q --strict-config --strict-markers"
121
+ xfail_strict = true
87
122
 
88
123
  [tool.coverage.run]
89
124
  source = ["src/lss4py"]
90
- omit = [
91
- "src/lss4py/_event_log.py",
92
- "src/lss4py/adapters/*",
93
- "src/lss4py/cli.py",
94
- "src/lss4py/observability/*",
95
- "src/lss4py/reporting/*",
96
- "src/lss4py/workflows/bottleneck.py",
97
- "src/lss4py/workflows/comparison.py",
98
- "src/lss4py/workflows/simulation.py",
99
- ]
100
125
 
101
126
  [tool.coverage.report]
102
127
  fail_under = 90
103
128
  show_missing = true
104
129
  skip_covered = true
105
130
 
106
- [tool.pydocstyle]
107
- convention = "google"
108
- add-ignore = [
109
- "D100",
110
- "D101",
111
- "D104",
112
- ]
113
-
114
- [tool.interrogate]
115
- ignore-init-method = true
116
- ignore-init-module = true
117
- ignore-magic = true
118
- ignore-semiprivate = false
119
- ignore-private = false
120
- fail-under = 80
121
- verbose = 2
122
- exclude = [
123
- "src/lss4py/adapters",
124
- "src/lss4py/observability",
125
- "src/lss4py/reporting",
126
- "src/lss4py/workflows",
127
- "tests",
128
- ]
129
-
130
131
  [tool.vulture]
131
132
  paths = [
132
133
  "src",
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "lss4py"
3
- version = "0.2.0"
3
+ version = "0.2.2"
4
4
  description = "Python-first Lean Six Sigma analytics for telemetry-rich process improvement"
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -15,7 +15,10 @@ dependencies = [
15
15
  "opentelemetry-api>=1.31.0",
16
16
  "opentelemetry-exporter-otlp>=1.31.0",
17
17
  "opentelemetry-sdk>=1.31.0",
18
+ "pandera[polars]>=0.35,<0.36", # Private structural validation on canonical Polars only
19
+ "pint>=0.25,<1", # Explicit duration conversion; registry stays private
18
20
  "polars>=1.0.0",
21
+ "pydantic>=2.12,<3", # Portable exchange validation; FLO remains optional
19
22
  "rich>=13.9.0",
20
23
  "scipy>=1.15.0",
21
24
  "structlog>=24.4.0",
@@ -23,7 +26,7 @@ dependencies = [
23
26
 
24
27
  [project.optional-dependencies]
25
28
  integration = [
26
- "flo-lang==0.4.2",
29
+ "flo-lang==0.5.0",
27
30
  ]
28
31
  pandas = [
29
32
  "pandas>=2.2.0",
@@ -51,28 +54,24 @@ storage = [
51
54
  lss4py = "lss4py.cli:main"
52
55
 
53
56
  [build-system]
54
- requires = ["uv_build>=0.10.0,<0.13.0"]
57
+ requires = ["uv_build>=0.13.5,<0.14.0"]
55
58
  build-backend = "uv_build"
56
59
 
57
60
  [dependency-groups]
58
61
  dev = [
59
- "bandit>=1.8.0", # Security scanning
60
62
  "import-linter>=2.1",
61
63
  "matplotlib>=3.10.0", # Optional plotting contract development and typing
62
- "interrogate>=1.5.0", # Docstring coverage
63
64
  "pandas>=2.2.0", # Backend parity tests
64
65
  "pip-audit>=2.6.0", # Dependency vulnerabilities
65
66
  "pre-commit>=4.1.0",
66
- "pydocstyle>=6.3.0", # Docstring formatting
67
67
  "pyarrow>=19.0.0", # Type and contract checks for every supported backend
68
68
  "pytest>=8.3.0",
69
69
  "pytest-cov>=6.0.0",
70
- "ruff>=0.9.0",
70
+ "ruff>=0.17.2", # Lint, formatting, docstrings and function complexity
71
71
  "seaborn>=0.13.0", # Optional plotting contract development and typing
72
72
  "twine>=6.0.0", # Distribution metadata validation
73
73
  "ty>=0.0.77", # Astral type checker
74
74
  "vulture>=2.13",
75
- "xenon>=0.9.3",
76
75
  ]
77
76
 
78
77
  [tool.ruff]
@@ -80,44 +79,40 @@ line-length = 100
80
79
  target-version = "py314"
81
80
 
82
81
  [tool.ruff.lint]
83
- select = ["E", "F", "I", "UP", "B"]
82
+ select = [
83
+ "E", "F", "I", "UP", "B",
84
+ "C901", "D", "C4", "PIE",
85
+ "RUF100", "RUF043", "PT012", "SIM102", "SIM114",
86
+ "S", "PLE2502", # Security and bidirectional Unicode source checks
87
+ ]
88
+ ignore = ["D100", "D101", "D104", "S101"] # Preserve the former Bandit B101 exemption
89
+
90
+ [tool.ruff.lint.mccabe]
91
+ max-complexity = 10
92
+
93
+ [tool.ruff.lint.pydocstyle]
94
+ convention = "google"
95
+
96
+ [tool.ruff.lint.per-file-ignores]
97
+ "tests/**" = ["D", "S"]
98
+ "e2e/**" = ["D", "S"]
99
+ # Match the former security scan's production-source scope.
100
+ "tools/**" = ["S"]
101
+ "examples/**" = ["S"]
84
102
 
85
103
  [tool.pytest.ini_options]
86
104
  testpaths = ["tests"]
87
- addopts = "-q"
105
+ addopts = "-q --strict-config --strict-markers"
106
+ xfail_strict = true
88
107
 
89
108
  [tool.coverage.run]
90
109
  source = ["src/lss4py"]
91
- omit = [
92
- "src/lss4py/_event_log.py", # v0.3 refactor
93
- "src/lss4py/adapters/*",
94
- "src/lss4py/cli.py",
95
- "src/lss4py/observability/*",
96
- "src/lss4py/reporting/*",
97
- "src/lss4py/workflows/bottleneck.py",
98
- "src/lss4py/workflows/comparison.py",
99
- "src/lss4py/workflows/simulation.py",
100
- ]
101
110
 
102
111
  [tool.coverage.report]
103
112
  fail_under = 90
104
113
  show_missing = true
105
114
  skip_covered = true
106
115
 
107
- [tool.pydocstyle]
108
- convention = "google"
109
- add-ignore = ["D100", "D101", "D104"] # Ignore module, class, and package docstrings (will enforce later)
110
-
111
- [tool.interrogate]
112
- ignore-init-method = true
113
- ignore-init-module = true
114
- ignore-magic = true
115
- ignore-semiprivate = false
116
- ignore-private = false
117
- fail-under = 80
118
- verbose = 2
119
- exclude = ["src/lss4py/adapters", "src/lss4py/observability", "src/lss4py/reporting", "src/lss4py/workflows", "tests"]
120
-
121
116
  [tool.vulture]
122
117
  paths = ["src", "tests"]
123
118
  min_confidence = 80
@@ -2,6 +2,8 @@ from lss4py._kernels.capability import capability_indices
2
2
  from lss4py._kernels.data_quality import normalize_data, validate_data
3
3
  from lss4py._kernels.defect_yield import process_yield
4
4
  from lss4py._kernels.descriptive import describe
5
+ from lss4py._kernels.distribution import distribution_profile
6
+ from lss4py._kernels.inference import mean_confidence_interval
5
7
  from lss4py._kernels.orders import deadline_performance, validate_order_summary
6
8
  from lss4py._kernels.reconstruction import reconstruct_orders
7
9
  from lss4py._kernels.timing import (
@@ -15,6 +17,7 @@ from lss4py._kernels.yield_ import (
15
17
  created_to_booked_yield,
16
18
  rolled_yield,
17
19
  )
20
+ from lss4py._units import convert_duration_columns
18
21
  from lss4py._version import __version__
19
22
  from lss4py.adapters import AdapterSchema, EventLogCSVAdapter, load_event_log
20
23
  from lss4py.adapters.numeric_log import NumericEventLogCSVAdapter, load_numeric_event_log
@@ -30,12 +33,14 @@ from lss4py.domain import (
30
33
  DataValidationReport,
31
34
  DefectYieldResult,
32
35
  DescriptiveResult,
36
+ DistributionProfileResult,
33
37
  EventLog,
34
38
  EventLogBindingsIR,
35
39
  EventStream,
36
40
  InputReference,
37
41
  IntervalEventLog,
38
42
  LeadTimeBindingIR,
43
+ MeanCIResult,
39
44
  MetricBindingsIR,
40
45
  MetricSemanticsIR,
41
46
  NormalizedData,
@@ -54,6 +59,7 @@ from lss4py.domain import (
54
59
  )
55
60
  from lss4py.domain.reconstruction import OrderReconstructionPolicy
56
61
  from lss4py.domain.results import OrderReconstructionResult, ProcessMapResult
62
+ from lss4py.domain.units import DurationConversion
57
63
  from lss4py.errors import (
58
64
  AdapterError,
59
65
  LSS4PyError,
@@ -71,6 +77,8 @@ from lss4py.guidance import (
71
77
  from lss4py.workflows import map_process
72
78
 
73
79
  __all__ = [
80
+ "DurationConversion",
81
+ "convert_duration_columns",
74
82
  "UnsupportedInputError",
75
83
  "ProcessMapResult",
76
84
  "AnalysisSelection",
@@ -110,8 +118,12 @@ __all__ = [
110
118
  "CapabilityResult",
111
119
  "capability_indices",
112
120
  "DescriptiveResult",
121
+ "DistributionProfileResult",
122
+ "MeanCIResult",
113
123
  "DefectYieldResult",
114
124
  "describe",
125
+ "distribution_profile",
126
+ "mean_confidence_interval",
115
127
  "EventLogBindingsIR",
116
128
  "EventLog",
117
129
  "EventLogCSVAdapter",
@@ -144,4 +156,5 @@ __all__ = [
144
156
 
145
157
 
146
158
  def main() -> None:
159
+ """Print the package's lightweight readiness message."""
147
160
  print("lss4py scaffold ready")