docassert 0.12.1__tar.gz → 0.13.0__tar.gz

{docassert-0.12.1/docassert.egg-info → docassert-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.12.1
+Version: 0.13.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.12.1 → docassert-0.13.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.12.1"
+__version__ = "0.13.0"

{docassert-0.12.1 → docassert-0.13.0}/docassert/status/derive.py

@@ -5,6 +5,7 @@ lives in docassert.status.render.
 """
 from __future__ import annotations
 
+import re
 from pathlib import Path
 
 from .. import config as config_mod
@@ -63,6 +64,10 @@ def _coverage(graph, config, code=None):
     return out
 
 
+_RISK_FIELD_RE = re.compile(
+    r"\s*(?:Probability|Impact|Owner|Response)\s*:", re.IGNORECASE)
+
+
 def _risks(graph, code=None):
     risks = []
     for item in graph.by_type.get("RISK", []):
@@ -70,11 +75,21 @@ def _risks(graph, code=None):
             continue
         prob = (_field_value(item.text, "probability") or "").lower()
         impact = (_field_value(item.text, "impact") or "").lower()
+        # The description is the item text up to the first metadata field;
+        # the response runs from its label to the end (it may hold clauses
+        # that _field_value would truncate at a sentence break).
+        m = _RISK_FIELD_RE.search(item.text)
+        description = (item.text[:m.start()] if m else item.text).strip()
+        rm = re.search(r"Response\s*:\s*(.+)$", item.text,
+                       re.IGNORECASE | re.DOTALL)
         risks.append({
             "id": item.id,
+            "description": description,
+            "threatens": item.links.get("threatens", []),
             "probability": prob or "?",
             "impact": impact or "?",
             "owner": _field_value(item.text, "owner") or "?",
+            "response": rm.group(1).strip() if rm else "",
             "score": _SEVERITY.get(prob, 0) * _SEVERITY.get(impact, 0),
         })
     return sorted(risks, key=lambda r: -r["score"])

{docassert-0.12.1 → docassert-0.13.0}/docassert/status/render.py

@@ -143,9 +143,27 @@ def render_html(model) -> str:
         + (";background:var(--amber)" if cov["gaps"] else "") + '"></div></div></div>'
         for cov in model["coverage"])
 
-    risks = "".join(
-        f'<li><code>{esc(r["id"])}</code> — {esc(r["probability"])}/{esc(r["impact"])}'
-        f' · owner {esc(r["owner"])}</li>' for r in model["risks"]) or "<li>None open.</li>"
+    def sev(value):
+        color = {"critical": "var(--bad)", "high": "var(--bad)",
+                 "medium": "var(--amber)", "low": "var(--ok)"}.get(
+                     value, "var(--muted)")
+        return f'<td style="color:{color};font-weight:600;">{esc(value)}</td>'
+
+    if model["risks"]:
+        risk_rows = "".join(
+            f'<tr><td><code>{esc(r["id"])}</code></td>'
+            f'<td>{esc(r["description"])}</td>'
+            f'<td>{", ".join(f"<code>{esc(b)}</code>" for b in r["threatens"]) or "—"}</td>'
+            + sev(r["probability"]) + sev(r["impact"])
+            + f'<td>{esc(r["owner"])}</td>'
+            f'<td>{esc(r["response"]) or "—"}</td></tr>'
+            for r in model["risks"])
+        risks = ('<table><thead><tr><th>ID</th><th>Risk</th><th>Threatens</th>'
+                 '<th>Probability</th><th>Impact</th><th>Owner</th>'
+                 '<th>Response</th></tr></thead>'
+                 f'<tbody>{risk_rows}</tbody></table>')
+    else:
+        risks = "<p>None open.</p>"
 
     problems = ""
     if model["broken_references"]:
@@ -262,7 +280,7 @@ def render_html(model) -> str:
   {document_set}
   {execution_html}
   {problems}
-  <section><h2>Open risks ({len(model['risks'])})</h2><ul>{risks}</ul></section>
+  <section><h2>Open risks ({len(model['risks'])})</h2>{risks}</section>
   <section><h2>Latest status report</h2><p>{report}</p></section>
   <section><h2>Documents ({c['total']})</h2>
     <table><thead><tr><th>Kind</th><th>ID</th><th>Status</th><th>Audit</th></tr></thead>

{docassert-0.12.1 → docassert-0.13.0/docassert.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.12.1
+Version: 0.13.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.12.1 → docassert-0.13.0}/tests/test_status.py

@@ -129,3 +129,36 @@ def test_render_project_page_has_back_link_and_scoped_title():
     assert 'href="index.html"' in out          # back to the portfolio index
     assert "Atlas" in out and "AMBER" in out
     assert "http://" not in out and "https://" not in out
+
+
+# ── the risk model carries the full story ────────────────────────────────────
+def test_risks_carry_description_threatens_and_response():
+    _cd_root()
+    m = S.build_status(ROOT / "documents")
+    r = next(r for r in m["risks"] if r["id"] == "AUR-RISK-001")
+    assert r["description"] and "Probability" not in r["description"]
+    assert r["threatens"]                     # links to the BRs at stake
+    assert r["response"]                      # the full mitigation text
+    assert r["probability"] in {"low", "medium", "high", "critical", "?"}
+
+
+def test_risks_tolerate_missing_fields():
+    from docassert.graph import Graph
+    from docassert.models import Item
+    from docassert.status.derive import _risks
+    g = Graph()
+    g.add(Item("XX-RISK-001", "XX", "RISK", "Bare risk with no fields yet.",
+               {}, "d.md", "risk-register", "draft", "S"))
+    (r,) = _risks(g)
+    assert r["description"] == "Bare risk with no fields yet."
+    assert r["response"] == "" and r["probability"] == "?"
+
+
+def test_render_html_risk_table():
+    _cd_root()
+    out = S.render_html(S.build_status(ROOT / "documents"))
+    assert "<th>Risk</th>" in out and "<th>Response</th>" in out
+    assert "<th>Threatens</th>" in out and "<th>Owner</th>" in out
+    # severity cells are colored
+    assert 'style="color:var(--bad);font-weight:600;">high</td>' in out \
+        or 'style="color:var(--amber);font-weight:600;">medium</td>' in out