docassert 0.19.0__tar.gz → 0.20.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.19.0
+Version: 0.20.1
 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.19.0 → docassert-0.20.1}/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.19.0"
+__version__ = "0.20.1"

{docassert-0.19.0 → docassert-0.20.1}/docassert/consistency.py

@@ -49,6 +49,37 @@ def check_unique_item_ids(graph) -> CheckResult:
                        f"Duplicate item IDs: {detail}")
 
 
+def check_sequence_acyclic(graph) -> CheckResult:
+    """The `after` digraph contains no cycle (a cycle is broken sequencing)."""
+    edges: dict[str, list[str]] = {}
+    for item in graph.all_items():
+        for target in item.links.get("after", []):
+            edges.setdefault(item.id, []).append(target)
+    state: dict[str, int] = {}  # 0 visiting, 1 done
+
+    def visit(node, path):
+        if state.get(node) == 1:
+            return None
+        if state.get(node) == 0:
+            return path[path.index(node):] + [node]
+        state[node] = 0
+        for nxt in edges.get(node, []):
+            cycle = visit(nxt, path + [node])
+            if cycle:
+                return cycle
+        state[node] = 1
+        return None
+
+    for start in list(edges):
+        cycle = visit(start, [])
+        if cycle:
+            return CheckResult("sequence-acyclic", False, True,
+                               "after-cycle: " + " → ".join(cycle))
+    n = sum(len(v) for v in edges.values())
+    return CheckResult("sequence-acyclic", True, True,
+                       f"{n} after link(s), no cycles.")
+
+
 def check_referential_integrity(graph) -> CheckResult:
     broken = []
     for item in graph.all_items():
@@ -208,6 +239,7 @@ def run_consistency(documents_dir: str | Path = "documents",
     results = [
         check_unique_item_ids(graph),
         check_referential_integrity(graph),
+        check_sequence_acyclic(graph),
         check_required_links(graph, cfg),
         check_coverage(graph, cfg),
         check_profile_completeness(documents_dir),

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

@@ -116,6 +116,49 @@ def _broken_references(graph, code=None):
 _MS_RE = re.compile(r"^(?P<label>.+?)[:\u2014\u2013-]\s*(?P<date>\d{4}-\d{2}-\d{2})\.?\s*$")
 
 
+_TSHIRT = [(1, "XS"), (2, "S"), (4, "M"), (7, "L")]
+
+
+def _tshirt(points: int) -> str:
+    for cap, label in _TSHIRT:
+        if points <= cap:
+            return label
+    return "XL"
+
+
+def _features(graph, code):
+    """Every product requirement as a chartable feature: scope points =
+    traced stories + verifying acceptance criteria (document arithmetic, no
+    estimation), plus `after` sequencing resolved into topological layers."""
+    prs = [i for i in graph.by_type.get("PR", []) if not code or i.project == code]
+    feats = {}
+    for pr in prs:
+        stories = graph.children(pr.id, "traces", "US")
+        acs = graph.children(pr.id, "verifies", "AC")
+        feats[pr.id] = {
+            "id": pr.id,
+            "text": pr.text.split(". ")[0][:80],
+            "stories": len(stories),
+            "acs": len(acs),
+            "points": len(stories) + len(acs),
+            "after": [t for t in pr.links.get("after", []) if any(
+                p.id == t for p in prs)],
+            "layer": 0,
+        }
+    # Kahn layering; a cycle (gated by sequence-acyclic) degrades to layer 0
+    for _ in range(len(feats)):
+        changed = False
+        for f in feats.values():
+            want = max((feats[d]["layer"] + 1 for d in f["after"]
+                        if d in feats), default=0)
+            if want > f["layer"]:
+                f["layer"] = want
+                changed = True
+        if not changed:
+            break
+    return sorted(feats.values(), key=lambda f: (f["layer"], -f["points"], f["id"]))
+
+
 def _milestones(docs):
     """Dated charter milestones as temporal facts (never completion claims)."""
     import datetime
@@ -245,6 +288,7 @@ def build_status(documents_dir=DOCUMENTS_DIR, project: str | None = None) -> dic
         "risks": _risks(graph, code),
         "operations": _operations(docs),
         "milestones": _milestones(docs),
+        "features": _features(graph, code),
         "broken_references": _broken_references(graph, code),
         "latest_report": _latest_report(docs),
         "completeness": completeness,

{docassert-0.19.0 → docassert-0.20.1}/docassert/status/render.py

@@ -142,6 +142,31 @@ def _today():
     return datetime.date.today()
 
 
+def _verdict_causes(model) -> list[str]:
+    """The raw cause strings behind the verdict (also the verdict tooltip)."""
+    causes = []
+    gaps = [c for c in model["coverage"] if c["gaps"]]
+    if gaps:
+        causes.append(f"{len(gaps)} coverage chain(s) with gaps")
+    failing = [d for d in model["documents"] if not d["passing"]]
+    if failing:
+        causes.append(f"{len(failing)} document(s) failing audit")
+    if model["broken_references"]:
+        causes.append(f"{len(model['broken_references'])} broken reference(s)")
+    comp = model.get("completeness")
+    if comp and comp.get("blocks"):
+        causes.append("required documents missing under an enforced profile")
+    thr = model.get("risk_amber_score", 6)
+    open_r = [r for r in model["risks"] if r.get("disposition", "open") == "open"
+              and (thr == 0 or r.get("score", 0) >= thr)]
+    if open_r:
+        causes.append(f"{len(open_r)} open risk(s) at or above the appetite (score ≥ {thr})")
+    stale = [o for o in model.get("operations", []) if not o["fresh"]]
+    if stale:
+        causes.append(f"operations review overdue since {stale[0]['review_by']}")
+    return causes
+
+
 def _verdict(model) -> str:
     """One decision-grade sentence composed only from recorded causes."""
     rag = model["rag"]
@@ -259,8 +284,16 @@ def render_html(model) -> str:
          (f"{esc(nxt[1])} · {nxt[2]}" if nxt else "no dated milestone")),
         ("DOC SET", docset_v, docset_c, docset_sub),
     ]
+    stat_tips = {
+        "HEALTH": "Derived RAG. Red: failing approved docs, broken references, or enforced profile gaps. Amber: coverage gaps, open risks at or above the risk appetite, stale operations review, or an amber/red status report. Green: none of those.",
+        "DOCS APPROVED": "Documents with approved or baselined status, of all documents in this project. The sub-line counts documents passing every blocking structural check.",
+        "COVERAGE": "Traceability links present over links required, across every configured chain (BR→PR, PR→AC, AC→TC, and any others).",
+        "OPEN RISKS": "Risks with disposition open. Dispositioned risks (mitigated, accepted, closed) stay on the register as record but do not count here.",
+        "NEXT MILESTONE": "Days to the nearest upcoming dated marker: a dated charter milestone or the operations review. Temporal fact only.",
+        "DOC SET": "Profile completeness: required kinds complete (approved and passing audit) over required kinds expected.",
+    }
     stat_html = "".join(
-        f'<div style="padding:22px 20px;border-left:1px solid {_C["line"]};">'
+        f'<div title="{esc(stat_tips.get(k, ""))}" style="cursor:help;padding:22px 20px;border-left:1px solid {_C["line"]};">'
         f'<div class="chiplabel" style="margin-bottom:14px;">{k}</div>'
         f'<div style="font-family:Archivo,system-ui,sans-serif;font-weight:800;font-size:30px;letter-spacing:-.02em;'
         f'line-height:1;color:{col};font-variant-numeric:tabular-nums;">{esc(v)}</div>'
@@ -278,8 +311,11 @@ def render_html(model) -> str:
             f'{_C["green"] if i < filled else _C["line"]};"></span>'
             for i in range(cells))
         ratio_c = _C["green"] if covered == total else _C["amberT"]
+        tip = ("all links traced" if not cov["gaps"] else
+               "gaps: " + ", ".join(cov["gaps"]))
         meters.append(
-            f'<div><div style="display:flex;justify-content:space-between;align-items:baseline;margin-bottom:11px;">'
+            f'<div title="{esc(tip)}" style="cursor:help;">'
+            f'<div style="display:flex;justify-content:space-between;align-items:baseline;margin-bottom:11px;">'
             f'<span style="font-size:12.5px;color:{_C["soft"]};">{esc(cov["label"])}</span>'
             f'<span style="font-family:Archivo,system-ui,sans-serif;font-weight:700;font-size:13px;color:{ratio_c};">'
             f'{covered}/{total}</span></div><div style="display:flex;gap:4px;">{cell_html}</div></div>')
@@ -342,8 +378,11 @@ def render_html(model) -> str:
             if m["when"] == "elapsed":
                 return f'color:{_C["muted"]};background:#14181b;'
             return f'color:{_C["muted"]};background:#14181b;'
+        ms_tip = ("Temporal fact only: elapsed means the date passed, "
+                  "not that the milestone completed (spec §13.2).")
         cols = "".join(
-            f'<div style="display:flex;flex-direction:column;align-items:flex-start;">'
+            f'<div title="{esc(m["label"])} · {esc(m["date"])} · {esc(ms_tip)}" '
+            f'style="cursor:help;display:flex;flex-direction:column;align-items:flex-start;">'
             f'<span style="display:block;width:14px;height:14px;border-radius:50%;'
             f'border:2px solid {_C["bg"]};{_dot(m)}"></span>'
             f'<div style="font-family:Archivo,system-ui,sans-serif;font-weight:700;font-size:13px;color:{_C["text"]};'
@@ -362,77 +401,67 @@ def render_html(model) -> str:
     ex = model.get("execution") or {}
     lanes_html = ""
     feats = ex.get("features", [])
-    dated = [f for f in feats if (f.get("facts") or {}).get("created_at")]
-    if dated:
-        starts = [f["facts"]["created_at"] for f in dated]
-        ends = [(f["facts"].get("closed_at") or today.isoformat()) for f in dated]
-        bounds = [datetime.date.fromisoformat(min(starts)),
-                  max(datetime.date.fromisoformat(max(ends)), today)]
-        for m in ms:
-            try:
-                bounds[1] = max(bounds[1], datetime.date.fromisoformat(m["date"]))
-            except ValueError:
-                pass
-        w0 = bounds[0]
-        span = max((bounds[1] - w0).days + 7, 14)
-        # month gridlines
-        months = []
-        cur = datetime.date(w0.year, w0.month, 1)
-        while cur <= bounds[1]:
-            if cur >= w0:
-                months.append(cur)
-            cur = datetime.date(cur.year + (cur.month == 12), (cur.month % 12) + 1, 1)
-        month_html = "".join(
-            f'<span style="position:absolute;left:{_pct(m.isoformat(), w0, span):.2f}%;top:0;'
-            f'font-size:9px;letter-spacing:.14em;color:{_C["dim"]};padding-left:7px;">'
-            f'{m.strftime("%b").upper()}</span>' for m in months)
-        grid = ", ".join(
-            f'transparent {_pct(m.isoformat(), w0, span):.2f}%, #191d21 {_pct(m.isoformat(), w0, span):.2f}%, '
-            f'#191d21 calc({_pct(m.isoformat(), w0, span):.2f}% + 1px), transparent calc({_pct(m.isoformat(), w0, span):.2f}% + 1px)'
-            for m in months) or "transparent 0%"
+    ex_state = {}
+    for f in feats:
+        facts = f.get("facts") or {}
+        ex_state[f["id"]] = ("blocked" if "blocked" in (facts.get("labels") or [])
+                             else "done" if f.get("closed") else "open")
+    chart = model.get("features") or []
+    if chart:
+        maxp = max(f["points"] for f in chart) or 1
+        maxlayer = max(f["layer"] for f in chart)
+        ncols = maxlayer + 1
+        colw = 100.0 / ncols
         fills = {"done": f'background:rgba(63,185,80,.78);color:{_C["bg"]};',
                  "open": f'background:rgba(255,178,36,.85);color:{_C["bg"]};',
-                 "blocked": f'background:rgba(240,78,78,.82);color:{_C["bg"]};'}
-        lane_rows = []
-        for f in dated:
-            facts = f["facts"]
-            state = ("blocked" if "blocked" in (facts.get("labels") or [])
-                     else "done" if f.get("closed") else "open")
-            left = _pct(facts["created_at"], w0, span)
-            right = _pct(facts.get("closed_at") or today.isoformat(), w0, span)
-            w = max(2.0, right - left)
-            label = esc(facts.get("title") or f["id"])
-            lane_rows.append(
-                f'<div style="display:grid;grid-template-columns:186px 1fr;align-items:center;'
+                 "blocked": f'background:rgba(240,78,78,.82);color:{_C["bg"]};',
+                 "scoped": 'background:rgba(255,255,255,.05);color:#9BA1A8;border:1px dashed #3a4046;'}
+        headers = "".join(
+            f'<span style="position:absolute;left:{i * colw:.2f}%;top:0;font-size:9px;'
+            f'letter-spacing:.14em;color:{_C["dim"]};padding-left:7px;">SEQ {i + 1}</span>'
+            for i in range(ncols))
+        gridlines = ", ".join(
+            f'transparent {i * colw:.2f}%, #191d21 {i * colw:.2f}%, '
+            f'#191d21 calc({i * colw:.2f}% + 1px), transparent calc({i * colw:.2f}% + 1px)'
+            for i in range(1, ncols)) or "transparent 0%"
+        rows_html = []
+        for f in chart:
+            state = ex_state.get(f["id"], "scoped")
+            size = _tshirt_label(f["points"])
+            width = max(6.0, (f["points"] / maxp) * (colw - 3))
+            left = f["layer"] * colw + 1
+            dep = f' · after {", ".join(esc(d) for d in f["after"])}' if f["after"] else ""
+            bar_tip = (f'{f["text"]} — {f["points"]} scope point(s) = '
+                       f'{f["stories"]} story(ies) + {f["acs"]} acceptance criteria. '
+                       + (f'Sequenced after {", ".join(f["after"])}. ' if f["after"] else "")
+                       + ("State from the bridge issue." if f["id"] in ex_state
+                          else "No execution data yet: scoped only."))
+            rows_html.append(
+                f'<div title="{esc(bar_tip)}" style="cursor:help;display:grid;grid-template-columns:186px 1fr;align-items:center;'
                 f'border-bottom:1px solid #14181b;">'
                 f'<div style="padding-right:14px;"><div style="font-size:12px;color:{_C["soft"]};'
-                f'line-height:1.3;">{label[:52]}</div>'
+                f'line-height:1.3;">{esc(f["text"])[:52]}</div>'
                 f'<div style="font-size:9.5px;color:{_C["dim"]};margin-top:3px;">{esc(f["id"])}'
-                f' · {f["stories_closed"]}/{f["stories_total"]}</div></div>'
-                f'<div style="position:relative;height:40px;background-image:linear-gradient(90deg, {grid});">'
-                f'<div style="position:absolute;top:9px;left:{left:.2f}%;width:{w:.2f}%;height:22px;'
-                f'border-radius:3px;display:flex;align-items:center;padding:0 8px;font-size:9.5px;'
-                f'letter-spacing:.02em;overflow:hidden;white-space:nowrap;{fills[state]}">{state}</div></div></div>')
-        today_line = (f'<div style="position:absolute;left:{_pct(today.isoformat(), w0, span):.2f}%;'
-                      f'top:0;bottom:0;width:1px;background:rgba(255,178,36,.45);"></div>')
-        review_marks = "".join(
-            f'<div style="position:absolute;left:{_pct(o["review_by"], w0, span):.2f}%;top:50%;'
-            f'width:10px;height:10px;background:{_C["amber"]};transform:translate(-50%,-50%) rotate(45deg);'
-            f'border:2px solid {_C["bg"]};"></div>'
-            for o in model.get("operations", []) if len(o.get("review_by", "")) == 10)
+                f' · {f["stories"]} st · {f["acs"]} ac{dep}</div></div>'
+                f'<div style="position:relative;height:40px;background-image:linear-gradient(90deg, {gridlines});">'
+                f'<div style="position:absolute;top:9px;left:{left:.2f}%;width:{width:.2f}%;height:22px;'
+                f'border-radius:3px;display:flex;align-items:center;gap:6px;padding:0 8px;font-size:9.5px;'
+                f'letter-spacing:.02em;overflow:hidden;white-space:nowrap;{fills[state]}">'
+                f'<b>{size}</b> {f["points"]}pt · {state}</div></div></div>')
         lanes_html = (
             f'<div style="margin:0 0 60px;">'
             f'<div style="display:grid;grid-template-columns:186px 1fr;"><span></span>'
-            f'<div style="position:relative;height:20px;">{month_html}</div></div>'
-            f'<div style="position:relative;border-top:1px solid {_C["line"]};">'
-            f'<div style="position:absolute;left:186px;right:0;top:0;bottom:0;pointer-events:none;">'
-            f'{today_line}{review_marks}</div>{"".join(lane_rows)}</div>'
+            f'<div style="position:relative;height:20px;">{headers}</div></div>'
+            f'<div style="position:relative;border-top:1px solid {_C["line"]};">{"".join(rows_html)}</div>'
             f'<div style="display:flex;gap:18px;margin-top:18px;font-size:10.5px;color:{_C["muted"]};flex-wrap:wrap;align-items:center;">'
-            f'<span style="display:flex;align-items:center;gap:7px;"><span style="width:11px;height:11px;background:rgba(255,178,36,.85);border-radius:2px;display:inline-block;"></span>open · real created→now span</span>'
-            f'<span style="display:flex;align-items:center;gap:7px;"><span style="width:11px;height:11px;background:rgba(63,185,80,.78);border-radius:2px;display:inline-block;"></span>done · created→closed</span>'
-            f'<span style="display:flex;align-items:center;gap:7px;"><span style="width:11px;height:11px;background:rgba(240,78,78,.82);border-radius:2px;display:inline-block;"></span>blocked label</span>'
-            f'<span style="margin-left:auto;display:flex;align-items:center;gap:8px;">'
-            f'<span style="width:9px;height:9px;background:{_C["amber"]};transform:rotate(45deg);display:inline-block;"></span>operations review</span></div></div>')
+            f'<span>position = dependency sequence (`after` layers)</span>'
+            f'<span>width = <b>scope points</b> = stories + acceptance criteria (no estimation, no time axis)</span>'
+            f'<span>XS=1 · S=2 · M=3–4 · L=5–7 · XL=8+</span>'
+            f'<span style="margin-left:auto;display:flex;gap:14px;">'
+            f'<span style="display:flex;align-items:center;gap:6px;"><span style="width:11px;height:11px;background:rgba(63,185,80,.78);border-radius:2px;display:inline-block;"></span>done</span>'
+            f'<span style="display:flex;align-items:center;gap:6px;"><span style="width:11px;height:11px;background:rgba(255,178,36,.85);border-radius:2px;display:inline-block;"></span>open</span>'
+            f'<span style="display:flex;align-items:center;gap:6px;"><span style="width:11px;height:11px;background:rgba(240,78,78,.82);border-radius:2px;display:inline-block;"></span>blocked</span>'
+            f'<span style="display:flex;align-items:center;gap:6px;"><span style="width:11px;height:11px;background:rgba(255,255,255,.05);border:1px dashed #3a4046;border-radius:2px;display:inline-block;"></span>scoped</span></span></div></div>')
 
     roadmap_html = ""
     if timeline_html or lanes_html:
@@ -505,6 +534,8 @@ def render_html(model) -> str:
     work_aside = (f"{ex.get('stories_closed', 0)}/{ex.get('stories_total', 0)} stories closed"
                   if ex else "bridge-managed issues")
     verdict = _verdict(model)
+    causes = _verdict_causes(model)
+    verdict_tip = ("Causes: " + "; ".join(causes)) if causes else "No amber or red causes recorded."
     payload = _json_embed({"risks": risks_data, "docs": docs_data, "work": work_data,
                            "C": _C})
 
@@ -539,7 +570,7 @@ def render_html(model) -> str:
 
   <div style="display:flex;gap:18px;margin:28px 0 44px;padding:20px 22px;background:rgba(255,178,36,.06);border-left:3px solid {rc};">
     <span style="font-family:Archivo,system-ui,sans-serif;font-weight:900;font-size:12px;letter-spacing:.16em;color:{rt};writing-mode:vertical-rl;transform:rotate(180deg);">VERDICT</span>
-    <p style="margin:0;font-family:Archivo,system-ui,sans-serif;font-weight:500;font-size:17.5px;line-height:1.5;color:#DDE1E5;max-width:88ch;">{esc(verdict)}</p>
+    <p title="{esc(verdict_tip)}" style="cursor:help;margin:0;font-family:Archivo,system-ui,sans-serif;font-weight:500;font-size:17.5px;line-height:1.5;color:#DDE1E5;max-width:88ch;">{esc(verdict)}</p>
   </div>
 
   <div style="display:grid;grid-template-columns:repeat(6,1fr);border-top:1px solid {_C['line']};border-bottom:1px solid {_C['line']};margin-bottom:56px;">{stat_html}</div>
@@ -591,6 +622,13 @@ def render_html(model) -> str:
 """
 
 
+def _tshirt_label(points: int) -> str:
+    for cap, label in ((1, "XS"), (2, "S"), (4, "M"), (7, "L")):
+        if points <= cap:
+            return label
+    return "XL"
+
+
 def _section(num, name, aside) -> str:
     return (f'<div class="sect"><span class="num">{num}</span>'
             f'<span class="name">{name}</span><span class="rule"></span>'
@@ -617,7 +655,7 @@ function matrix(){
     probs.forEach(pr => {
       const inCell = DATA.risks.filter(r => r.disposition==='open' && r.prob===pr && (r.impact===im || (r.impact==='critical' && im==='high')));
       const z = zone(PV[pr]*PV[im]); const occ = inCell.length>0;
-      const chips = inCell.map(r => `<span style="font-size:11px;font-weight:600;padding:2px 6px;border-radius:3px;border:1px solid ${z.b};color:${S.sel===r.id?C.bg:z.t};background:${S.sel===r.id?z.t:'transparent'};">${esc(r.short)}</span>`).join('');
+      const chips = inCell.map(r => `<span title="${esc(r.id)}: ${esc(r.desc)}" style="cursor:help;font-size:11px;font-weight:600;padding:2px 6px;border-radius:3px;border:1px solid ${z.b};color:${S.sel===r.id?C.bg:z.t};background:${S.sel===r.id?z.t:'transparent'};">${esc(r.short)}</span>`).join('');
       h += `<div data-risk="${occ?inCell[0].id:''}" style="min-height:56px;border:1px solid ${occ?z.b:'#191d21'};background:${occ?z.s:z.f};border-radius:3px;display:flex;gap:4px;align-items:center;justify-content:center;flex-wrap:wrap;cursor:${occ?'pointer':'default'};">${chips}</div>`;
     });
   });
@@ -682,7 +720,7 @@ function docs(){
     <span style="font-size:12.5px;color:${C.text};">${esc(d.kind)}</span>
     <span class="mono-tag" style="justify-self:start;">${esc(d.id)}</span>
     <span style="font-size:12px;color:${d.status==='active'?C.amberT:C.muted};">${esc(d.status)}</span>
-    <span style="text-align:right;color:${d.passing?C.green:C.red};font-size:14px;">${d.passing?'✓':'✗'}</span></div>`).join('');
+    <span title="${d.passing?'passes every blocking structural check':'failing one or more blocking checks'}" style="cursor:help;text-align:right;color:${d.passing?C.green:C.red};font-size:14px;">${d.passing?'✓':'✗'}</span></div>`).join('');
 }
 
 function work(){
@@ -708,7 +746,7 @@ function work(){
     <div><div style="font-size:13px;color:${C.text};line-height:1.45;">${w.url?`<a style="text-decoration:none;" href="${esc(w.url)}">${esc(w.title)}</a>`:esc(w.title)}</div>
       <div style="font-size:10.5px;color:${C.dim};margin-top:6px;">linked ${esc(w.link)}</div></div>
     <span style="font-size:11.5px;color:${C.muted};">${esc(w.assignee)}</span>
-    <span style="text-align:right;font-size:11.5px;color:${stC(w.state)};">${w.state==='done'?'done ✓':esc(w.state)}</span></div>`).join('');
+    <span title="state read from the bridge-managed issue; presentation never alters the derived RAG" style="cursor:help;text-align:right;font-size:11.5px;color:${stC(w.state)};">${w.state==='done'?'done ✓':esc(w.state)}</span></div>`).join('');
 }
 
 function render(){ matrix(); riskCtl(); riskTable(); docs(); work(); }
@@ -730,12 +768,12 @@ def _index_row(p) -> str:
             f'<div><div style="font-family:Archivo,system-ui,sans-serif;font-weight:700;font-size:15px;color:#F1F3F5;line-height:1.2;">{esc(p["name"])}</div>'
             f'<div style="font-size:10.5px;color:{_C["dim"]};margin-top:5px;display:flex;gap:10px;">'
             f'<span>{esc(p["id"])}</span><span>·</span><span>{esc(p["sponsor"])}</span></div></div>'
-            f'<div style="text-align:center;"><div style="font-size:12.5px;color:{covc};">{cov}%</div>'
+            f'<div title="traceability links traced over required, all chains" style="cursor:help;text-align:center;"><div style="font-size:12.5px;color:{covc};">{cov}%</div>'
             f'<div style="height:4px;background:#16191c;margin-top:7px;border-radius:2px;overflow:hidden;">'
             f'<span style="display:block;height:100%;width:{cov}%;background:{covc};"></span></div></div>'
             f'<span style="text-align:center;font-size:12.5px;color:{_C["soft"]};">{esc(p["docs"])}</span>'
             f'<span style="text-align:center;font-size:12px;color:{_C["amberT"] if p["risks"] else _C["faint"]};">{risks}</span>'
-            f'<span style="text-align:right;font-size:11.5px;color:{_C["muted"]};">{esc(p["next"])}</span></a>')
+            f'<span title="nearest upcoming dated marker (milestone or operations review)" style="cursor:help;text-align:right;font-size:11.5px;color:{_C["muted"]};">{esc(p["next"])}</span></a>')
 
 
 def render_index_html(index) -> str:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.19.0
+Version: 0.20.1
 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.19.0 → docassert-0.20.1}/tests/test_status.py

@@ -301,3 +301,81 @@ def test_charter_target_becomes_implicit_milestone():
     m2 = S.build_status(ROOT / "documents", project="PRJ-001-AUR")
     seen = [x["date"] for x in m2["milestones"]]
     assert len(seen) == len(set(seen))
+
+
+# ── sequence-and-size charts (sponsor direction, spec 0.8.0) ─────────────────
+def _seq_tree(tmp_path, cyclic=False):
+    d = tmp_path / "documents" / "PRJ-001-SQ"
+    d.mkdir(parents=True)
+    (d / "project.md").write_text(
+        "---\nkind: project\nid: PRJ-001-SQ\ncode: SQ\nname: Seq Fixture\n"
+        "sponsor: sp.owner\nstatus: active\n---\n\n## Overview\nx\n\n## Scope\nx\n",
+        encoding="utf-8")
+    first_after = "; after: SQ-PR-003" if cyclic else ""
+    (d / "prd.md").write_text(
+        "---\nkind: prd\nid: SQ-prd\nproject: PRJ-001-SQ\ntitle: T\n"
+        "owner: ow.ner\nstatus: approved\n---\n\n## Overview\nx\n\n"
+        "## Product Requirements\n\n"
+        f"- **SQ-PR-001** (traces: SQ-BR-001{first_after}): First thing.\n"
+        "- **SQ-PR-002** (traces: SQ-BR-001; after: SQ-PR-001): Second thing.\n"
+        "- **SQ-PR-003** (traces: SQ-BR-001; after: SQ-PR-002): Third thing.\n\n"
+        "## Acceptance Criteria\n\n"
+        "- **SQ-AC-001** (verifies: SQ-PR-001): Given a, when b, then c.\n"
+        "- **SQ-AC-002** (verifies: SQ-PR-001): Given d, when e, then f.\n"
+        "- **SQ-AC-003** (verifies: SQ-PR-002): Given g, when h, then i.\n",
+        encoding="utf-8")
+    (d / "brd.md").write_text(
+        "---\nkind: brd\nid: SQ-brd\nproject: PRJ-001-SQ\ntitle: T\n"
+        "owner: ow.ner\nstatus: approved\n---\n\n## Purpose\nx\n\n"
+        "## Business Requirements\n\n"
+        "- **SQ-BR-001**: The business shall reach 100% of the metric by 2026-12-31.\n\n"
+        "## Out of Scope\nx\n", encoding="utf-8")
+    (d / "user-story.md").write_text(
+        "---\nkind: user-story\nid: SQ-user-story\nproject: PRJ-001-SQ\ntitle: T\n"
+        "owner: ow.ner\nstatus: approved\n---\n\n## Overview\nx\n\n"
+        "## User Stories\n\n"
+        "- **SQ-US-001** (traces: SQ-PR-001): As a user, I want one so that value.\n"
+        "- **SQ-US-002** (traces: SQ-PR-003): As a user, I want three so that value.\n",
+        encoding="utf-8")
+    return tmp_path / "documents"
+
+
+def test_features_points_layers_and_tshirt(tmp_path):
+    _cd_root()
+    m = S.build_status(_seq_tree(tmp_path), project="PRJ-001-SQ")
+    by = {f["id"]: f for f in m["features"]}
+    assert by["SQ-PR-001"]["points"] == 3 and by["SQ-PR-001"]["layer"] == 0
+    assert by["SQ-PR-002"]["points"] == 1 and by["SQ-PR-002"]["layer"] == 1
+    assert by["SQ-PR-003"]["points"] == 1 and by["SQ-PR-003"]["layer"] == 2
+    from docassert.status.derive import _tshirt
+    assert [_tshirt(n) for n in (1, 2, 3, 5, 9)] == ["XS", "S", "M", "L", "XL"]
+
+
+def test_sequence_chart_renders_without_time_axis(tmp_path):
+    _cd_root()
+    m = S.build_status(_seq_tree(tmp_path), project="PRJ-001-SQ")
+    out = S.render_html(m)
+    assert "SEQ 1" in out and "scope points" in out
+    assert "XS=1" in out and "scoped" in out
+    assert "created→closed" not in out and "JUL" not in out
+
+
+def test_after_cycle_blocks(tmp_path):
+    from docassert.consistency import check_sequence_acyclic
+    from docassert.graph import build_graph
+    _cd_root()
+    g = build_graph(_seq_tree(tmp_path, cyclic=True))
+    r = check_sequence_acyclic(g)
+    assert not r.passed and r.blocking and "after-cycle" in r.detail
+
+
+def test_report_tooltips_present(tmp_path):
+    _cd_root()
+    m = S.build_status(_seq_tree(tmp_path), project="PRJ-001-SQ")
+    out = S.render_html(m)
+    assert 'title="Derived RAG.' in out            # stat derivation
+    assert "not that the milestone completed" in out or "Temporal fact" in out
+    assert "scope point(s) = " in out              # bar breakdown tooltip
+    assert 'title="Causes:' in out or "No amber or red causes" in out
+    idx = S.render_index_html(S.build_index(ROOT / "documents"))
+    assert "nearest upcoming dated marker" in idx