docassert 0.10.0__tar.gz → 0.10.1__tar.gz

{docassert-0.10.0/docassert.egg-info → docassert-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.10.0
+Version: 0.10.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.10.0 → docassert-0.10.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.10.0"
+__version__ = "0.10.1"

{docassert-0.10.0 → docassert-0.10.1}/docassert/bridge/plan.py

@@ -7,6 +7,7 @@ anywhere in the bridge, writes to documents/.
 """
 from __future__ import annotations
 
+import os
 from dataclasses import dataclass, field
 from pathlib import Path
 
@@ -54,6 +55,18 @@ class BridgePlan:
         return {f.id for f in self.features} | {s.id for s in self.stories}
 
 
+def _repo_rel(path: str, documents_dir: Path) -> str:
+    """Path relative to the docs repo root (the parent of documents_dir).
+
+    Issue bodies link Source as {docs_url}/{doc_path}, and docs_url points at
+    the docs repository. When CI checks that repository out into a
+    subdirectory, load paths carry the checkout prefix; stripping down to the
+    repo root keeps the links valid wherever the docs are checked out.
+    """
+    rel = os.path.relpath(path, documents_dir.parent)
+    return path if rel.startswith("..") else Path(rel).as_posix()
+
+
 def _title(item_text: str, limit: int = 64) -> str:
     """First sentence of the item text, trimmed for an issue title."""
     first = item_text.split(". ")[0].rstrip(".")
@@ -126,14 +139,17 @@ def build_bridge_plan(documents_dir: str | Path = "documents") -> BridgePlan:
                 feat = features.get(parent.id)
                 if feat is None:
                     feat = Feature(id=parent.id, text=parent.text,
-                                   doc_path=parent.doc_path, project=proj_id)
+                                   doc_path=_repo_rel(parent.doc_path,
+                                                      documents_dir),
+                                   project=proj_id)
                     feat.acceptance = [(a.id, a.text) for a in
                                        graph.children(parent.id, "verifies", "AC")]
                     for aid, _ in feat.acceptance:
                         feat.tests += [t.id for t in graph.children(aid, "tests", "TC")]
                     features[parent.id] = feat
-                feat.stories.append(Story(id=s.id, text=s.text,
-                                          feature_id=parent.id, doc_path=s.doc_path))
+                feat.stories.append(Story(
+                    id=s.id, text=s.text, feature_id=parent.id,
+                    doc_path=_repo_rel(s.doc_path, documents_dir)))
         if problems:
             plan.skipped.append({"id": proj_id,
                                  "reason": "; ".join(problems)})

{docassert-0.10.0 → docassert-0.10.1/docassert.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.10.0
+Version: 0.10.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.10.0 → docassert-0.10.1}/tests/test_bridge.py

@@ -113,6 +113,20 @@ def test_bodies_carry_marker_and_authority_note(tmp_path):
     assert f"<!-- docassert-bridge: {s.id} -->" in story_body(s, None)
 
 
+def test_doc_paths_relative_to_docs_repo_root(tmp_path):
+    """CI checks the docs repo out into a subdirectory; Source links must not
+    carry that checkout prefix (they resolve against the docs repo root)."""
+    docs = _tree(tmp_path / "pmo")
+    plan = build_bridge_plan(docs)
+    f = plan.features[0]
+    assert f.doc_path == "documents/PRJ-001-TST/prd.md"
+    assert f.stories[0].doc_path == "documents/PRJ-001-TST/user-story.md"
+    body = feature_body(f, "https://github.com/o/r/blob/main")
+    assert ("**Source:** https://github.com/o/r/blob/main/"
+            "documents/PRJ-001-TST/prd.md") in body
+    assert "/pmo/" not in body
+
+
 # ── ops against a fake runner ────────────────────────────────────────────────
 class FakeGh:
     """Records mutations; serves canned issue lists."""