docassert 0.18.0__tar.gz → 0.19.0__tar.gz

{docassert-0.18.0/docassert.egg-info → docassert-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.18.0
+Version: 0.19.0
 Summary: Unit testing for business documents — validate structured Markdown docs against a configurable audit standard.
 Author: C4G Enterprises Inc.
 License: Apache-2.0

{docassert-0.18.0 → docassert-0.19.0}/docassert/__init__.py

@@ -5,4 +5,4 @@ standard: deterministic structural checks that gate a merge, plus optional
 AI-graded semantic checks that advise.
 """
 
-__version__ = "0.18.0"
+__version__ = "0.19.0"

{docassert-0.18.0 → docassert-0.19.0}/docassert/_data/consistency.yaml

@@ -39,6 +39,12 @@ coverage:
 # (0 = no cap).
 alignment_limit: 25
 
+# Open risks move derived status to amber only at or above this
+# probability x impact score (low=1 medium=2 high/critical=3). 0 = any open
+# risk ambers (the strict pre-0.19 behavior). Exposure below the threshold
+# stays fully reported; it just doesn't flatten the headline.
+risk_amber_score: 6
+
 # Rules match in order; the first matching rule grades a link. Typed rules
 # (child_type/parent_type) come before the generic ones.
 alignment:

{docassert-0.18.0 → docassert-0.19.0}/docassert/status/derive.py

@@ -135,15 +135,29 @@ def _milestones(docs):
                 due = datetime.date.fromisoformat(m.group("date"))
             except ValueError:
                 continue
-            delta = (due - today).days
-            out.append({"label": m.group("label").strip(),
-                        "date": due.isoformat(),
-                        "days": delta,
-                        "when": ("today" if delta == 0 else
-                                 "elapsed" if delta < 0 else "upcoming")})
+            out.append(_ms_entry(m.group("label").strip(), due, today))
+    for d in docs:
+        if d.kind != "charter":
+            continue
+        target = (d.frontmatter.get("dates") or {}).get("target")
+        if target:
+            try:
+                due = (target if isinstance(target, datetime.date)
+                       else datetime.date.fromisoformat(str(target)))
+                if not any(x["date"] == due.isoformat() for x in out):
+                    out.append(_ms_entry("Charter target", due, today))
+            except (TypeError, ValueError):
+                pass
     return sorted(out, key=lambda x: x["date"])
 
 
+def _ms_entry(label, due, today):
+    delta = (due - today).days
+    return {"label": label, "date": due.isoformat(), "days": delta,
+            "when": ("today" if delta == 0 else
+                     "elapsed" if delta < 0 else "upcoming")}
+
+
 def _operations(docs):
     """Operations documents with their review state."""
     import datetime
@@ -234,6 +248,7 @@ def build_status(documents_dir=DOCUMENTS_DIR, project: str | None = None) -> dic
         "broken_references": _broken_references(graph, code),
         "latest_report": _latest_report(docs),
         "completeness": completeness,
+        "risk_amber_score": int(cfg.get("risk_amber_score", 6) or 0),
     }
     model["rag"] = derive_rag(model)
     return model
@@ -313,7 +328,10 @@ def derive_rag(model) -> str:
     reported = (model["latest_report"] or {}).get("rag")
     completeness_gap = bool(comp and (comp["missing_required"] or comp["incomplete_required"]
                                       or comp["recommended_gaps"] or comp.get("unknown")))
-    open_risks = [r for r in model["risks"] if r.get("disposition", "open") == "open"]
+    threshold = model.get("risk_amber_score", 6)
+    open_risks = [r for r in model["risks"]
+                  if r.get("disposition", "open") == "open"
+                  and (threshold == 0 or r.get("score", 0) >= threshold)]
     stale_ops = [o for o in model.get("operations", []) if not o["fresh"]]
     if (coverage_gap or open_risks or stale_ops
             or reported in {"amber", "red"} or completeness_gap):

{docassert-0.18.0 → docassert-0.19.0/docassert.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.18.0
+Version: 0.19.0
 Summary: Unit testing for business documents — validate structured Markdown docs against a configurable audit standard.
 Author: C4G Enterprises Inc.
 License: Apache-2.0

{docassert-0.18.0 → docassert-0.19.0}/tests/test_status.py

@@ -53,7 +53,9 @@ def test_rag_red_on_failing_approved_doc():
 
 
 def test_rag_amber_on_open_risk():
-    assert S.derive_rag(_model(risks=[{"id": "RISK-1", "score": 4}])) == "amber"
+    # at or above the appetite (default 6) ambers; below stays green
+    assert S.derive_rag(_model(risks=[{"id": "RISK-1", "score": 6}])) == "amber"
+    assert S.derive_rag(_model(risks=[{"id": "RISK-1", "score": 4}])) == "green"
 
 
 def test_rag_amber_on_coverage_gap():
@@ -189,8 +191,8 @@ def test_disposition_parsed_and_defaulted():
 def test_rag_green_when_all_risks_dispositioned():
     base = {"documents": [], "coverage": [], "broken_references": [],
             "latest_report": None, "completeness": None}
-    open_r = dict(base, risks=[{"id": "R", "score": 2, "disposition": "open"}])
-    done_r = dict(base, risks=[{"id": "R", "score": 2, "disposition": "accepted"}])
+    open_r = dict(base, risks=[{"id": "R", "score": 6, "disposition": "open"}])
+    done_r = dict(base, risks=[{"id": "R", "score": 6, "disposition": "accepted"}])
     assert S.derive_rag(open_r) == "amber"
     assert S.derive_rag(done_r) == "green"
 
@@ -275,3 +277,27 @@ def test_svc_and_freshness_checks(tmp_path):
     assert ok
     fresh_ok, detail = check_ops_review_fresh(doc, ctx)
     assert not fresh_ok and "overdue" in detail
+
+
+# ── risk appetite (spec 0.7.0) ───────────────────────────────────────────────
+def test_low_grade_open_risks_do_not_amber():
+    base = {"documents": [], "coverage": [], "broken_references": [],
+            "latest_report": None, "completeness": None, "operations": [],
+            "risk_amber_score": 6}
+    low = dict(base, risks=[{"id": "R", "score": 4, "disposition": "open"}])
+    hi = dict(base, risks=[{"id": "R", "score": 6, "disposition": "open"}])
+    strict = dict(low, risk_amber_score=0)
+    assert S.derive_rag(low) == "green"
+    assert S.derive_rag(hi) == "amber"
+    assert S.derive_rag(strict) == "amber"
+
+
+def test_charter_target_becomes_implicit_milestone():
+    _cd_root()
+    m = S.build_status(ROOT / "documents", project="PRJ-002-ATL")
+    dates = [x["label"] for x in m["milestones"]]
+    assert any("Charter target" in lbl or lbl for lbl in dates) or m["milestones"] == []
+    # Aurora has explicit dated milestones AND a target; no duplicates by date
+    m2 = S.build_status(ROOT / "documents", project="PRJ-001-AUR")
+    seen = [x["date"] for x in m2["milestones"]]
+    assert len(seen) == len(set(seen))