docassert 0.17.0__tar.gz → 0.19.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.17.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.17.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.17.0"
+__version__ = "0.19.0"

{docassert-0.17.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.17.0 → docassert-0.19.0}/docassert/_data/criteria/charter.criteria.yaml

@@ -21,6 +21,11 @@ required_sections:
   - Approval
 
 checks:
+  - id: milestones-dated
+    type: structural
+    blocking: false
+    description: "At least one Milestones bullet ends with an ISO date (- <label>: YYYY-MM-DD) so timelines can draw it. Advisory only."
+
   - id: frontmatter-schema
     type: structural
     blocking: true

{docassert-0.17.0 → docassert-0.19.0}/docassert/bridge/ops.py

@@ -222,6 +222,19 @@ def status(plan: BridgePlan, gh: G.GhRunner, repo: str) -> dict:
                              "doc": key})
     out: dict = {"repo": repo, "projects": [],
                  "scope": {"unverified": unverified, "orphaned": orphaned}}
+    def facts(key):
+        """Real, presentational issue facts (never fed back into derivation)."""
+        issue = by_key.get(key) or {}
+        return {
+            "title": issue.get("title"),
+            "state": issue.get("state"),
+            "created_at": (issue.get("created_at") or "")[:10] or None,
+            "closed_at": (issue.get("closed_at") or "")[:10] or None,
+            "url": issue.get("html_url"),
+            "assignee": (issue.get("assignee") or {}).get("login"),
+            "labels": [lb.get("name") for lb in issue.get("labels") or []],
+        }
+
     for p in plan.projects:
         feats = []
         for f in p["features"]:
@@ -229,6 +242,10 @@ def status(plan: BridgePlan, gh: G.GhRunner, repo: str) -> dict:
             feats.append({
                 "id": f.id,
                 "issue": (by_key.get(f.id) or {}).get("number"),
+                "facts": facts(f.id),
+                "stories": [{"id": s.id,
+                             "issue": (by_key.get(s.id) or {}).get("number"),
+                             "facts": facts(s.id)} for s in f.stories],
                 "stories_total": len(f.stories),
                 "stories_closed": sum(1 for s in states if s == "closed"),
                 "closed": (by_key.get(f.id) or {}).get("state") == "closed",

{docassert-0.17.0 → docassert-0.19.0}/docassert/cli.py

@@ -240,9 +240,29 @@ def cmd_pages(args: argparse.Namespace) -> int:
             execution[proj["id"]] = {**proj, "scope": data.get("scope"),
                                      "repo": proj.get("repo") or data.get("repo")}
 
+    def _activity(project_id: str) -> list[dict]:
+        """Recent documents/ commits for one project (best-effort, git only)."""
+        import subprocess
+        try:
+            out = subprocess.run(
+                ["git", "log", "-n", "6", "--date=short",
+                 "--pretty=%ad\x1f%s", "--", f"{docs_dir}/{project_id}"],
+                capture_output=True, text=True, timeout=10)
+            if out.returncode != 0:
+                return []
+            rows = []
+            for line in out.stdout.strip().splitlines():
+                when, _, text = line.partition("\x1f")
+                if text:
+                    rows.append({"when": when, "text": text})
+            return rows
+        except Exception:
+            return []
+
     plist = projects_mod.load_projects(docs_dir)
     for p in plist:
         model = status_mod.build_status(docs_dir, project=p["id"])
+        model["activity"] = _activity(p["id"])
         if p["id"] in execution:
             model["execution"] = execution[p["id"]]
         (out / f"{p['id']}.html").write_text(status_mod.render_html(model))

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

@@ -113,6 +113,51 @@ def _broken_references(graph, code=None):
     return broken
 
 
+_MS_RE = re.compile(r"^(?P<label>.+?)[:\u2014\u2013-]\s*(?P<date>\d{4}-\d{2}-\d{2})\.?\s*$")
+
+
+def _milestones(docs):
+    """Dated charter milestones as temporal facts (never completion claims)."""
+    import datetime
+    today = datetime.date.today()
+    out = []
+    for d in docs:
+        if d.kind != "charter":
+            continue
+        section = d.section("Milestones")
+        if section is None:
+            continue
+        for bullet in section.list_items:
+            m = _MS_RE.match(bullet.strip())
+            if not m:
+                continue
+            try:
+                due = datetime.date.fromisoformat(m.group("date"))
+            except ValueError:
+                continue
+            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
@@ -199,9 +244,11 @@ def build_status(documents_dir=DOCUMENTS_DIR, project: str | None = None) -> dic
         "coverage": _coverage(graph, cfg, code),
         "risks": _risks(graph, code),
         "operations": _operations(docs),
+        "milestones": _milestones(docs),
         "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
@@ -231,6 +278,19 @@ def completeness_report(documents_dir=DOCUMENTS_DIR) -> list[dict]:
     return out
 
 
+def _next_dated(m) -> str | None:
+    """The nearest upcoming dated marker (milestone or operations review)."""
+    import datetime
+    cands = [x["date"] for x in m.get("milestones", []) if x["days"] >= 0]
+    for o in m.get("operations", []):
+        try:
+            if datetime.date.fromisoformat(o["review_by"]) >= datetime.date.today():
+                cands.append(o["review_by"])
+        except ValueError:
+            pass
+    return min(cands) if cands else None
+
+
 def build_index(documents_dir=DOCUMENTS_DIR) -> dict:
     """The multi-project view: each project's derived RAG + headline signals,
     plus the whole-repo rollup."""
@@ -246,6 +306,10 @@ def build_index(documents_dir=DOCUMENTS_DIR) -> dict:
             "failing": m["counts"]["failing"],
             "risks": len([r for r in m["risks"] if r.get("disposition", "open") == "open"]),
             "coverage_gaps": sum(len(c["gaps"]) for c in m["coverage"]),
+            "coverage_pct": (round(100 * sum(c["covered"] for c in m["coverage"])
+                                   / max(1, sum(c["total"] for c in m["coverage"])))
+                             if any(c["total"] for c in m["coverage"]) else 100),
+            "next": _next_dated(m),
             "broken": len(m["broken_references"]),
             "completeness": m.get("completeness"),
         })
@@ -264,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):