margin 0.9.7__tar.gz → 0.9.8__tar.gz

{margin-0.9.7/margin.egg-info → margin-0.9.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: margin
-Version: 0.9.7
+Version: 0.9.8
 Summary: Typed health classification, uncertainty algebra, and correction auditing for any system that measures things and needs to explain what happened.
 Author: Cope Labs LLC
 License: MIT

{margin-0.9.7 → margin-0.9.8}/margin/policy/validate.py

@@ -82,6 +82,10 @@ def validate(
     5. Missing health coverage (no rule handles ABLATED, DEGRADED, etc.)
     6. Contract coverage (if a contract is provided, check that the
        policy has rules for every component the contract mentions)
+    7. Component coverage (if components list provided)
+    8. alpha_from_sigma without a constraint floor
+    9. min_confidence too high (Parser.parse() defaults to MODERATE, so
+       rules with min_confidence >= HIGH may silently never fire)
 
     Args:
         policy:     the policy to validate
@@ -146,6 +150,9 @@ def validate(
     # 8. alpha_from_sigma without a constraint floor
     _check_alpha_from_sigma(policy, issues)
 
+    # 9. min_confidence gate too high for default parse behaviour
+    _check_min_confidence(policy, issues)
+
     return ValidationResult(issues=issues)
 
 
@@ -256,3 +263,22 @@ def _check_component_coverage(
             issues.append(ValidationIssue(
                 "info", "policy",
                 f"component '{comp}' has no dedicated rule (no wildcard rules either)"))
+
+
+def _check_min_confidence(policy: Policy, issues: list[ValidationIssue]) -> None:
+    """
+    Warn when a rule's min_confidence gate is above MODERATE.
+
+    Parser.parse() assigns MODERATE confidence to every observation by
+    default (when no per-component confidences dict is passed). A rule
+    with min_confidence >= HIGH will therefore silently never fire unless
+    the caller explicitly passes HIGH or CERTAIN confidences on every step.
+    """
+    for rule in policy.rules:
+        if rule.min_confidence >= Confidence.HIGH:
+            issues.append(ValidationIssue(
+                "warning", rule.name,
+                f"min_confidence={rule.min_confidence.value} — Parser.parse() defaults "
+                "to MODERATE; this rule will never fire unless the caller explicitly "
+                "passes per-component confidences of HIGH or CERTAIN",
+            ))

{margin-0.9.7 → margin-0.9.8}/margin/streaming.py

@@ -392,6 +392,21 @@ class Monitor:
         anomaly_min_reference: int = 10,
         features: Optional[set] = None,
     ):
+        """
+        Args:
+            parser:               Parser configured with baselines and thresholds
+            window:               base window size for all trackers (overridden per-tracker)
+            drift_window:         DriftTracker window (overrides ``window``)
+            anomaly_window:       AnomalyTracker window (overrides ``window``)
+            correlation_window:   CorrelationTracker window (overrides ``window``)
+            window_config:        WindowConfig dataclass; overrides named window params
+            min_correlation:      minimum |r| to include a pair in correlations
+            anomaly_min_reference: minimum steps before AnomalyTracker classifies
+            features:             set of tracker names to enable — ``{"drift"``,
+                                  ``"anomaly"``, ``"correlation"}``; ``None`` (default)
+                                  enables all three; ``set()`` disables all.
+                                  ``"health"`` is always implied and need not be listed.
+        """
         self.parser = parser
         self.window = window
 

{margin-0.9.7 → margin-0.9.8/margin.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: margin
-Version: 0.9.7
+Version: 0.9.8
 Summary: Typed health classification, uncertainty algebra, and correction auditing for any system that measures things and needs to explain what happened.
 Author: Cope Labs LLC
 License: MIT

{margin-0.9.7 → margin-0.9.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "margin"
-version = "0.9.7"
+version = "0.9.8"
 description = "Typed health classification, uncertainty algebra, and correction auditing for any system that measures things and needs to explain what happened."
 readme = "README.md"
 license = {text = "MIT"}

{margin-0.9.7 → margin-0.9.8}/tests/test_policy_validate.py

@@ -151,6 +151,44 @@ class TestComponentCoverage:
         assert len(comp_issues) == 0
 
 
+class TestMinConfidenceCheck:
+    def test_high_confidence_gate_warns(self):
+        rule = PolicyRule(
+            "r", any_degraded(),
+            Action(target="*", op=Op.RESTORE, alpha=0.5),
+            min_confidence=Confidence.HIGH,
+        )
+        result = validate(Policy(name="p", rules=[rule]))
+        assert any("min_confidence" in i.message or "MODERATE" in i.message
+                   for i in result.warnings)
+
+    def test_certain_confidence_gate_warns(self):
+        rule = PolicyRule(
+            "r", any_degraded(),
+            Action(target="*", op=Op.RESTORE, alpha=0.5),
+            min_confidence=Confidence.CERTAIN,
+        )
+        result = validate(Policy(name="p", rules=[rule]))
+        assert any("min_confidence" in i.message or "MODERATE" in i.message
+                   for i in result.warnings)
+
+    def test_moderate_confidence_gate_no_warn(self):
+        rule = PolicyRule(
+            "r", any_degraded(),
+            Action(target="*", op=Op.RESTORE, alpha=0.5),
+            min_confidence=Confidence.MODERATE,
+        )
+        result = validate(Policy(name="p", rules=[rule]))
+        # No warning about min_confidence for MODERATE (default parse behaviour)
+        assert not any("MODERATE" in i.message and "min_confidence" in i.message
+                       for i in result.warnings)
+
+    def test_low_confidence_gate_no_warn(self):
+        rule = _make_rule("r", any_degraded())  # default min_confidence=LOW
+        result = validate(Policy(name="p", rules=[rule]))
+        assert not any("min_confidence" in i.message for i in result.warnings)
+
+
 class TestValidationResult:
     def test_valid_when_no_errors(self):
         r = ValidationResult(issues=[])