margin 0.8.1__tar.gz → 0.8.2__tar.gz

{margin-0.8.1/margin.egg-info → margin-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: margin
-Version: 0.8.1
+Version: 0.8.2
 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.8.1 → margin-0.8.2}/margin/causal.py

@@ -45,6 +45,10 @@ class CausalLink:
     strength:   0.0-1.0, how strong the relationship is (1.0 = deterministic)
     condition:  optional — this link only applies when source is in this health state
     evidence:   free text — why we believe this link exists
+    origin:     "asserted" (manually declared) or "discovered" (auto_causal_graph).
+                Asserted links are authoritative. Discovered links are correlational
+                heuristics — lag-based causal direction is plausible but not proven.
+                Never treat discovered links as ground truth in high-stakes domains.
     """
     source: str
     target: str
@@ -52,6 +56,15 @@ class CausalLink:
     strength: float = 1.0
     condition: Optional[Health] = None
     evidence: str = ""
+    origin: str = "asserted"   # "asserted" | "discovered"
+
+    @property
+    def is_asserted(self) -> bool:
+        return self.origin == "asserted"
+
+    @property
+    def is_discovered(self) -> bool:
+        return self.origin == "discovered"
 
     def to_dict(self) -> dict:
         d = {
@@ -59,6 +72,7 @@ class CausalLink:
             "cause_type": self.cause_type.value,
             "strength": round(self.strength, 4),
             "evidence": self.evidence,
+            "origin": self.origin,
         }
         if self.condition:
             d["condition"] = self.condition.value
@@ -72,11 +86,13 @@ class CausalLink:
             strength=d.get("strength", 1.0),
             condition=Health(d["condition"]) if "condition" in d else None,
             evidence=d.get("evidence", ""),
+            origin=d.get("origin", "asserted"),
         )
 
     def __repr__(self) -> str:
         cond = f" when {self.condition.value}" if self.condition else ""
-        return f"{self.source} --{self.cause_type.value}--> {self.target}{cond}"
+        tag = "[discovered]" if self.is_discovered else ""
+        return f"{self.source} --{self.cause_type.value}--> {self.target}{cond}{tag}"
 
 
 # -----------------------------------------------------------------------
@@ -124,6 +140,14 @@ class CausalGraph:
         """All links where `component` is the source (what it affects)."""
         return [l for l in self.links if l.source == component]
 
+    def asserted_links(self) -> list[CausalLink]:
+        """Links that were manually declared (authoritative)."""
+        return [l for l in self.links if l.is_asserted]
+
+    def discovered_links(self) -> list[CausalLink]:
+        """Links auto-discovered via correlation (heuristic, not proven)."""
+        return [l for l in self.links if l.is_discovered]
+
     def upstream(self, component: str, depth: int = 10) -> list[str]:
         """All components upstream of `component` (transitive causes)."""
         visited = set()

{margin-0.8.1 → margin-0.8.2}/margin/correlate.py

@@ -85,6 +85,7 @@ class Correlation:
             cause_type=cause_type,
             strength=self.strength,
             evidence=f"auto-correlated: r={self.coefficient:.3f}, lag={self.lag}, n={self.n_samples}",
+            origin="discovered",  # lag-based causal direction is a heuristic, not proven
         )
 
     def to_dict(self) -> dict:

{margin-0.8.1 → margin-0.8.2}/margin/ledger.py

@@ -109,12 +109,20 @@ class Ledger:
     """
     Accumulates Records across a session.
     Provides aggregate stats and renders the intervention history.
+
+    max_records: optional bound on records kept. When set, old records
+                 are dropped (oldest first) on each append. Use this for
+                 long-running production loops to prevent unbounded growth.
+                 None (default) = unbounded, suitable for batch/replay use.
     """
     label: str = ""
     records: list[Record] = field(default_factory=list)
+    max_records: Optional[int] = None
 
     def append(self, record: Record) -> None:
         self.records.append(record)
+        if self.max_records is not None and len(self.records) > self.max_records:
+            self.records.pop(0)
 
     def __len__(self) -> int:
         return len(self.records)

{margin-0.8.1 → margin-0.8.2/margin.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: margin
-Version: 0.8.1
+Version: 0.8.2
 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.8.1 → margin-0.8.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "margin"
-version = "0.8.1"
+version = "0.8.2"
 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"}