docassert 0.16.0__tar.gz → 0.18.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.16.0
+Version: 0.18.0
 Summary: Unit testing for business documents — validate structured Markdown docs against a configurable audit standard.
 Author: C4G Enterprises Inc.
 License: Apache-2.0
@@ -102,6 +102,8 @@ flagged as TODOs, never invented). The skill's source is
 | `docassert extract <file>` | Extract plain text from a source `.docx` / `.pdf` / `.md` / `.txt` (the first step of doc-to-pmo conversion). Needs the `convert` extra: `pip install "docassert[convert]"`. |
 
 Every document-reading command accepts `--documents-dir` (default `documents/`).
+The full flag-by-flag reference, and what 1.x does and does not promise to
+keep stable, live in [STABILITY.md](STABILITY.md).
 AI alignment grades at most `alignment_limit` links per run (default 25; set it
 in `consistency.yaml`, `0` = no cap) so API cost stays bounded on large graphs.
 

{docassert-0.16.0 → docassert-0.18.0}/README.md

@@ -62,6 +62,8 @@ flagged as TODOs, never invented). The skill's source is
 | `docassert extract <file>` | Extract plain text from a source `.docx` / `.pdf` / `.md` / `.txt` (the first step of doc-to-pmo conversion). Needs the `convert` extra: `pip install "docassert[convert]"`. |
 
 Every document-reading command accepts `--documents-dir` (default `documents/`).
+The full flag-by-flag reference, and what 1.x does and does not promise to
+keep stable, live in [STABILITY.md](STABILITY.md).
 AI alignment grades at most `alignment_limit` links per run (default 25; set it
 in `consistency.yaml`, `0` = no cap) so API cost stays bounded on large graphs.
 

{docassert-0.16.0 → docassert-0.18.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.16.0"
+__version__ = "0.18.0"

{docassert-0.16.0 → docassert-0.18.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.16.0 → docassert-0.18.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.16.0 → docassert-0.18.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.16.0 → docassert-0.18.0}/docassert/status/derive.py

@@ -113,6 +113,37 @@ 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
+            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")})
+    return sorted(out, key=lambda x: x["date"])
+
+
 def _operations(docs):
     """Operations documents with their review state."""
     import datetime
@@ -199,6 +230,7 @@ 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,
@@ -231,6 +263,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 +291,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"),
         })