eb-optimization 0.2.4__tar.gz → 0.2.8__tar.gz

{eb_optimization-0.2.4 → eb_optimization-0.2.8}/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2025, Kyle Corrie
+Copyright (c) 2026, Kyle Corrie
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

{eb_optimization-0.2.4/src/eb_optimization.egg-info → eb_optimization-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eb-optimization
-Version: 0.2.4
+Version: 0.2.8
 Summary: Electric Barometer: Optimization and tuning utilities for EB objectives and policy parameters.
 Author-email: "Kyle Corrie (Economistician)" <kcorrie@economistician.com>
 License-Expression: BSD-3-Clause
@@ -9,21 +9,23 @@ Project-URL: Repository, https://github.com/Economistician/eb-optimization
 Project-URL: Issues, https://github.com/Economistician/eb-optimization/issues
 Project-URL: Documentation, https://github.com/Economistician/eb-docs
 Keywords: electric-barometer,optimization,tuning,grid-search,calibration,asymmetric-loss,forecasting,pandas
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: numpy>=1.24
 Requires-Dist: pandas>=2.0
+Requires-Dist: eb-metrics==0.2.9
+Requires-Dist: eb-evaluation==0.2.10
 Provides-Extra: eb
-Requires-Dist: eb-metrics<0.3,>=0.2; extra == "eb"
-Requires-Dist: eb-evaluation<0.3,>=0.2; extra == "eb"
+Requires-Dist: eb-metrics==0.2.9; extra == "eb"
+Requires-Dist: eb-evaluation==0.2.10; extra == "eb"
 Provides-Extra: opt
 Provides-Extra: test
 Requires-Dist: pytest>=8.0; extra == "test"
@@ -35,8 +37,8 @@ Requires-Dist: ruff>=0.0.1; extra == "dev"
 Requires-Dist: pyright>=1.1; extra == "dev"
 Requires-Dist: twine>=4.0; extra == "dev"
 Provides-Extra: all
-Requires-Dist: eb-metrics<0.3,>=0.2; extra == "all"
-Requires-Dist: eb-evaluation<0.3,>=0.2; extra == "all"
+Requires-Dist: eb-metrics==0.2.9; extra == "all"
+Requires-Dist: eb-evaluation==0.2.10; extra == "all"
 Requires-Dist: pytest>=8.0; extra == "all"
 Requires-Dist: scikit-learn>=1.3; extra == "all"
 Requires-Dist: pytest-cov>=5.0; extra == "all"
@@ -58,19 +60,7 @@ Decision and policy layer for the Electric Barometer ecosystem, responsible for
 
 ## Overview
 
-This repository contains the optimization, tuning, and policy governance layer of the Electric Barometer ecosystem. It defines how key evaluation parameters—such as cost ratios, tolerances, and readiness controls—are selected from data, validated under governance rules, and formalized into deterministic policies that can be reused across systems and environments.
-
-Rather than computing metrics or running evaluations, this repository focuses on decision logic: how parameters are calibrated, how tradeoffs are resolved, and how those decisions are frozen into auditable artifacts. It provides the bridge between metric theory and operational deployment, ensuring that forecast evaluation behavior is consistent, explainable, and governed by explicit intent rather than ad-hoc configuration.
-
----
-
-## Role in the Electric Barometer Ecosystem
-
-`eb-optimization` defines the parameter selection, calibration, and governance logic used throughout the Electric Barometer ecosystem. It is responsible for determining how key operational parameters—such as cost ratios, tolerance bands, and readiness controls—are selected from data in a disciplined, reproducible, and decision-aware manner.
-
-This repository focuses exclusively on optimization mechanics and policy formation. It does not define metric primitives, perform evaluation orchestration, manage model interfaces, or execute runtime decision logic. Those responsibilities are handled by adjacent layers in the ecosystem that compute metrics, evaluate forecasts, or apply frozen policies in production workflows.
-
-By separating parameter selection and governance from metric semantics and execution concerns, eb-optimization provides a stable optimization layer that enables consistent calibration, transparent decision rules, and auditable policy artifacts across heterogeneous forecasting and operational contexts.
+`eb-optimization` calibrates operational parameters (cost ratios, τ, readiness controls) and freezes them into auditable runtime policies. It does not compute metrics or run evaluation panels; those belong to `eb-metrics` and `eb-evaluation`.
 
 ---
 
@@ -131,4 +121,4 @@ print(R)
 ## License
 
 BSD 3-Clause License.
-© 2025 Kyle Corrie.
+© 2026 Kyle Corrie.

{eb_optimization-0.2.4 → eb_optimization-0.2.8}/README.md

@@ -11,19 +11,7 @@ Decision and policy layer for the Electric Barometer ecosystem, responsible for
 
 ## Overview
 
-This repository contains the optimization, tuning, and policy governance layer of the Electric Barometer ecosystem. It defines how key evaluation parameters—such as cost ratios, tolerances, and readiness controls—are selected from data, validated under governance rules, and formalized into deterministic policies that can be reused across systems and environments.
-
-Rather than computing metrics or running evaluations, this repository focuses on decision logic: how parameters are calibrated, how tradeoffs are resolved, and how those decisions are frozen into auditable artifacts. It provides the bridge between metric theory and operational deployment, ensuring that forecast evaluation behavior is consistent, explainable, and governed by explicit intent rather than ad-hoc configuration.
-
----
-
-## Role in the Electric Barometer Ecosystem
-
-`eb-optimization` defines the parameter selection, calibration, and governance logic used throughout the Electric Barometer ecosystem. It is responsible for determining how key operational parameters—such as cost ratios, tolerance bands, and readiness controls—are selected from data in a disciplined, reproducible, and decision-aware manner.
-
-This repository focuses exclusively on optimization mechanics and policy formation. It does not define metric primitives, perform evaluation orchestration, manage model interfaces, or execute runtime decision logic. Those responsibilities are handled by adjacent layers in the ecosystem that compute metrics, evaluate forecasts, or apply frozen policies in production workflows.
-
-By separating parameter selection and governance from metric semantics and execution concerns, eb-optimization provides a stable optimization layer that enables consistent calibration, transparent decision rules, and auditable policy artifacts across heterogeneous forecasting and operational contexts.
+`eb-optimization` calibrates operational parameters (cost ratios, τ, readiness controls) and freezes them into auditable runtime policies. It does not compute metrics or run evaluation panels; those belong to `eb-metrics` and `eb-evaluation`.
 
 ---
 
@@ -84,4 +72,4 @@ print(R)
 ## License
 
 BSD 3-Clause License.
-© 2025 Kyle Corrie.
+© 2026 Kyle Corrie.

{eb_optimization-0.2.4 → eb_optimization-0.2.8}/pyproject.toml

@@ -3,10 +3,10 @@
 ######################################
 [project]
 name = "eb-optimization"
-version = "0.2.4"
+version = "0.2.8"
 description = "Electric Barometer: Optimization and tuning utilities for EB objectives and policy parameters."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = "BSD-3-Clause"
 license-files = ["LICENSE*"]
 
@@ -26,9 +26,9 @@ keywords = [
 ]
 
 classifiers = [
+  "Development Status :: 5 - Production/Stable",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
@@ -38,11 +38,11 @@ classifiers = [
 ######################################
 # Core runtime dependencies
 ######################################
-# Keep this intentionally lean. eb-optimization should be installable even
-# without pulling the rest of the EB stack unless users opt-in via extras.
 dependencies = [
   "numpy>=1.24",
   "pandas>=2.0",
+  "eb-metrics==0.2.9",
+  "eb-evaluation==0.2.10",
 ]
 
 ######################################
@@ -59,11 +59,11 @@ Documentation = "https://github.com/Economistician/eb-docs"
 ######################################
 [project.optional-dependencies]
 
-# Pull in EB ecosystem deps when tuning objectives/policies that rely on them
+# EB ecosystem deps (metrics primitives, diagnostics contracts)
+# Use this when you want DQC diagnostics from eb-evaluation and HR@τ primitive from eb-metrics.
 eb = [
-  # Electric Barometer compatibility band (0.2.x)
-  "eb-metrics>=0.2,<0.3",
-  "eb-evaluation>=0.2,<0.3",
+  "eb-metrics==0.2.9",
+  "eb-evaluation==0.2.10",
 ]
 
 # Optional optimization backends (future-proofing)
@@ -88,8 +88,8 @@ dev = [
 # Aggregates EB ecosystem dependencies and test tooling.
 all = [
   # EB ecosystem deps
-  "eb-metrics>=0.2,<0.3",
-  "eb-evaluation>=0.2,<0.3",
+  "eb-metrics==0.2.9",
+  "eb-evaluation==0.2.10",
 
   # test deps
   "pytest>=8.0",
@@ -115,6 +115,9 @@ build-backend = "setuptools.build_meta"
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.package-data]
+eb_optimization = ["py.typed"]
+
 ######################################
 # Pytest configuration
 ######################################

{eb_optimization-0.2.4 → eb_optimization-0.2.8}/src/eb_optimization/__init__.py

@@ -15,12 +15,29 @@ from __future__ import annotations
 
 from importlib.metadata import PackageNotFoundError, version
 
+from .policies.cost_ratio_policy import (
+    DEFAULT_COST_RATIO_POLICY,
+    CostRatioPolicy,
+    apply_cost_ratio_policy,
+)
+from .policies.dqc_policy import (
+    DEFAULT_DQC_POLICY,
+    DQCPolicy,
+    DQCResultSummary,
+    compute_dqc,
+    enforce_snapping,
+)
 from .policies.ral_policy import (
     DEFAULT_RAL_POLICY,
+    RALBands,
+    RALBandThresholds,
     RALDeltas,
+    RALPolicyArtifact,
+    RALThresholdTwoBandPolicy,
     RALTwoBandPolicy,
     apply_ral_policy,
 )
+from .policies.tau_policy import DEFAULT_TAU_POLICY, TauPolicyArtifact, apply_tau_policy
 from .tuning.cost_ratio import EntityCostRatioEstimate
 
 
@@ -44,10 +61,25 @@ def _resolve_version() -> str:
 __version__ = _resolve_version()
 
 __all__ = [
+    "DEFAULT_COST_RATIO_POLICY",
+    "DEFAULT_DQC_POLICY",
     "DEFAULT_RAL_POLICY",
+    "DEFAULT_TAU_POLICY",
+    "CostRatioPolicy",
+    "DQCPolicy",
+    "DQCResultSummary",
     "EntityCostRatioEstimate",
+    "RALBandThresholds",
+    "RALBands",
     "RALDeltas",
+    "RALPolicyArtifact",
+    "RALThresholdTwoBandPolicy",
     "RALTwoBandPolicy",
+    "TauPolicyArtifact",
     "__version__",
+    "apply_cost_ratio_policy",
     "apply_ral_policy",
+    "apply_tau_policy",
+    "compute_dqc",
+    "enforce_snapping",
 ]

eb_optimization-0.2.8/src/eb_optimization/policies/__init__.py

@@ -0,0 +1,71 @@
+"""Frozen runtime policies (τ, cost ratio, RAL, DQC enforcement).
+
+Immutable configuration objects with no learning logic. Prefer
+``eb_evaluation.diagnostics.validate_dqc`` then ``enforce_snapping`` /
+``evaluate_with_dqc_hr``; ``compute_dqc`` remains for compatibility.
+"""
+
+from __future__ import annotations
+
+from .cost_ratio_policy import (
+    DEFAULT_COST_RATIO_POLICY,
+    CostRatioPolicy,
+    apply_cost_ratio_policy,
+    apply_entity_cost_ratio_policy,
+)
+from .dqc_policy import (
+    DEFAULT_DQC_POLICY,
+    DQCPolicy,
+    DQCResultSummary,
+    compute_dqc,
+    enforce_snapping,
+    hr_at_tau_grid_units,
+    snap_to_grid,
+)
+from .evaluation import DQCEvaluation, evaluate_with_dqc_hr
+from .ral_policy import (
+    DEFAULT_RAL_POLICY,
+    RALBands,
+    RALBandThresholds,
+    RALDeltas,
+    RALPolicyArtifact,
+    RALThresholdTwoBandPolicy,
+    RALTwoBandPolicy,
+    apply_ral_policy,
+)
+from .tau_policy import (
+    DEFAULT_TAU_POLICY,
+    TauPolicyArtifact,
+    apply_entity_tau_policy,
+    apply_tau_policy,
+    apply_tau_policy_hr,
+)
+
+__all__ = [
+    "DEFAULT_COST_RATIO_POLICY",
+    "DEFAULT_DQC_POLICY",
+    "DEFAULT_RAL_POLICY",
+    "DEFAULT_TAU_POLICY",
+    "CostRatioPolicy",
+    "DQCEvaluation",
+    "DQCPolicy",
+    "DQCResultSummary",
+    "RALBandThresholds",
+    "RALBands",
+    "RALDeltas",
+    "RALPolicyArtifact",
+    "RALThresholdTwoBandPolicy",
+    "RALTwoBandPolicy",
+    "TauPolicyArtifact",
+    "apply_cost_ratio_policy",
+    "apply_entity_cost_ratio_policy",
+    "apply_entity_tau_policy",
+    "apply_ral_policy",
+    "apply_tau_policy",
+    "apply_tau_policy_hr",
+    "compute_dqc",
+    "enforce_snapping",
+    "evaluate_with_dqc_hr",
+    "hr_at_tau_grid_units",
+    "snap_to_grid",
+]