repopact 2.1.0__tar.gz → 2.2.0__tar.gz

{repopact-2.1.0 → repopact-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repopact
-Version: 2.1.0
+Version: 2.2.0
 Summary: A repository-native standard for durable agent work: binding invariants, evidence-gated work items, and drift audits.
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/ForgeWireLabs/repopact
@@ -22,8 +22,8 @@ cannot be silently weakened.
 > The repository is the pact: authority, intent, evidence, and history that survive every
 > session.
 
-`pip install repopact` · Apache-2.0 · current release **2.1.0**
-([changelog](decisions/0024-release-2.1.0-proposed-lifecycle.md)).
+`pip install repopact` · Apache-2.0 · current release **2.2.0**
+([changelog](decisions/0025-release-2.2.0-dashboard-integrity.md)).
 
 ## How it relates to `AGENTS.md`
 

{repopact-2.1.0 → repopact-2.2.0}/README.md

@@ -9,8 +9,8 @@ cannot be silently weakened.
 > The repository is the pact: authority, intent, evidence, and history that survive every
 > session.
 
-`pip install repopact` · Apache-2.0 · current release **2.1.0**
-([changelog](decisions/0024-release-2.1.0-proposed-lifecycle.md)).
+`pip install repopact` · Apache-2.0 · current release **2.2.0**
+([changelog](decisions/0025-release-2.2.0-dashboard-integrity.md)).
 
 ## How it relates to `AGENTS.md`
 

repopact-2.2.0/VERSION

@@ -0,0 +1 @@
+2.2.0

{repopact-2.1.0 → repopact-2.2.0}/scripts/adopt_repo.py

@@ -21,9 +21,10 @@ import re
 import subprocess
 import sys
 from datetime import date, datetime, timedelta
-from pathlib import Path
-
-import init_repo  # reuse _seed_dir, _json/_write semantics, LIFECYCLE
+from pathlib import Path
+
+import generate_dashboard
+import init_repo  # reuse _seed_dir, _json/_write semantics, LIFECYCLE
 
 
 # --- non-destructive primitives --------------------------------------------
@@ -330,16 +331,22 @@ def adopt(target: Path, today: date | None = None, dry_run: bool = False) -> Rep
               "from the repository scan rather than proven by a run. Attach real verification evidence and\n"
               "run `repopact doctor` to ratchet it to concrete, then complete it. " + summary + "\n", target)
 
-    rep.write(target / "decisions" / "0001-adopt-repopact.md",
+    rep.write(target / "decisions" / "0001-adopt-repopact.md",
               "---\nid: 0001\ntitle: Adopt RepoPact\nstatus: accepted\n"
               f"date: {today.isoformat()}\nsupersedes: []\n---\n\n# 0001: Adopt RepoPact\n\n## Context\n\n"
               "The project already had ad-hoc governance (CODEOWNERS, CI gates, AGENTS.md). RepoPact\n"
-              "makes those bindings explicit and machine-checkable.\n\n## Decision\n\n"
-              "Adopt RepoPact; existing workflows become binding gates (INV-2) and ownership becomes\n"
-              "scopes/roles. Existing files were preserved; RepoPact records were added around them.\n", target)
-
-    rep.gitignored = gitignored_records(target, rep.created)
-    return rep
+              "makes those bindings explicit and machine-checkable.\n\n## Decision\n\n"
+              "Adopt RepoPact; existing workflows become binding gates (INV-2) and ownership becomes\n"
+              "scopes/roles. Existing files were preserved; RepoPact records were added around them.\n", target)
+
+    # The dashboard is derived, but adoption remains non-destructive: create the
+    # canonical projection only when the reserved path is absent. An existing file
+    # is preserved and validation will identify it if it is not canonical.
+    dashboard_text = "" if dry_run else generate_dashboard.generate(target, today=today)
+    rep.write(target / "audits" / "reports" / "dashboard.md", dashboard_text, target)
+
+    rep.gitignored = gitignored_records(target, rep.created)
+    return rep
 
 
 def _print_report(rep: Report) -> None:

{repopact-2.1.0 → repopact-2.2.0}/scripts/doctor.py

@@ -20,10 +20,11 @@ import shutil
 import sys
 from dataclasses import dataclass
 from datetime import date, timedelta
-from pathlib import Path
-
-import adopt_repo
-import validate_repo
+from pathlib import Path
+
+import adopt_repo
+import generate_dashboard
+import validate_repo
 
 
 @dataclass
@@ -296,10 +297,18 @@ def fix(root: Path, today: date | None = None) -> list[str]:
     # 6. ratchet provisional records whose evidence is now concrete (decision 0021)
     actions.extend(_ratchet_provisional(root))
 
-    # 7. migrate preflight on upgrade: grandfather pre-2.0 work items (decision 0021)
-    actions.extend(_migrate_preflight(root, today))
-
-    return actions
+    # 7. migrate preflight on upgrade: grandfather pre-2.0 work items (decision 0021)
+    actions.extend(_migrate_preflight(root, today))
+
+    # 8. derived output is safe to repair because it is fully reproducible.
+    dashboard = root / "audits" / "reports" / "dashboard.md"
+    expected = generate_dashboard.generate(root, today=today)
+    actual = dashboard.read_text(encoding="utf-8") if dashboard.is_file() else None
+    if actual != expected:
+        generate_dashboard.write_dashboard(root, today=today)
+        actions.append("regenerated audits/reports/dashboard.md")
+
+    return actions
 
 
 def main() -> int:

{repopact-2.1.0 → repopact-2.2.0}/scripts/generate_dashboard.py

@@ -46,8 +46,15 @@ def _overdue_scopes(root: Path, today: date) -> list[tuple[str, str]]:
     return overdue
 
 
-def generate(root: Path) -> str:
-    today = date.today()
+def generate(root: Path, today: date | None = None) -> str:
+    """Render the canonical dashboard projection for ``root``.
+
+    ``today`` is injectable so audit-cadence transitions can be tested. The
+    rendering deliberately does not include the wall-clock date: a generated
+    artifact should change only when a displayed source-derived value changes,
+    not merely because the command ran on another day.
+    """
+    today = today or date.today()
     items = discover_work_items(root)
     counts = Counter(item.status for item in items)
     contracts = iter_contracts(root)
@@ -60,12 +67,12 @@ def generate(root: Path) -> str:
     finding_count = _count_json_records(root / "audits" / "findings")
     overdue = _overdue_scopes(root, today)
 
-    lines = [
-        "# Repository Dashboard",
-        "",
-        "> Generated from source records. Do not edit manually.",
-        f"> Generated: {today.isoformat()}",
-        f"> RepoPact spec version: {_spec_version(root)}",
+    lines = [
+        "# Repository Dashboard",
+        "",
+        "> Canonically generated from source records. Do not edit manually.",
+        "> Validation fails when this file differs from `repopact dashboard` output.",
+        f"> RepoPact spec version: {_spec_version(root)}",
         "",
         "## Health",
         "",
@@ -101,14 +108,21 @@ def generate(root: Path) -> str:
         lines.append("No active or blocked work.")
     else:
         lines.extend(f"- {item.item_id}: {item.data['title']} ({item.status})" for item in active)
-    return "\n".join(lines) + "\n"
-
-
-def main() -> None:
-    root = Path(__file__).resolve().parents[1]
-    output = root / "audits" / "reports" / "dashboard.md"
-    output.write_text(generate(root), encoding="utf-8")
-    print(f"Generated {output.relative_to(root)}")
+    return "\n".join(lines) + "\n"
+
+
+def write_dashboard(root: Path, today: date | None = None) -> Path:
+    """Write the one dashboard derived artifact and return its path."""
+    output = root / "audits" / "reports" / "dashboard.md"
+    output.parent.mkdir(parents=True, exist_ok=True)
+    output.write_text(generate(root, today=today), encoding="utf-8")
+    return output
+
+
+def main() -> None:
+    root = Path(__file__).resolve().parents[1]
+    output = write_dashboard(root)
+    print(f"Generated {output.relative_to(root)}")
 
 
 if __name__ == "__main__":

{repopact-2.1.0 → repopact-2.2.0}/scripts/init_repo.py

@@ -16,6 +16,8 @@ import sys
 from datetime import date, timedelta
 from pathlib import Path
 
+import generate_dashboard
+
 HERE = Path(__file__).resolve().parent          # directory holding the tooling modules
 CHECKOUT = HERE.parent                          # repo root when running from a checkout
 LIFECYCLE = ("proposed", "active", "blocked", "deferred", "completed")
@@ -126,6 +128,7 @@ def bootstrap(target: Path, today: date | None = None) -> Path:
     _write(target / "README.md",
            "# Repository\n\nBootstrapped with RepoPact. Run `repopact validate` "
            "(or `python scripts/validate_repo.py`).\n")
+    generate_dashboard.write_dashboard(target, today=today)
     return target
 
 

{repopact-2.1.0 → repopact-2.2.0}/scripts/new.py

@@ -16,6 +16,7 @@ import sys
 from datetime import date, datetime
 from pathlib import Path
 
+import generate_dashboard
 from repo_model import STATUSES
 
 ROOT = Path(__file__).resolve().parents[1]
@@ -64,6 +65,7 @@ def new_work_item(title: str, today: date, root: Path = ROOT, status: str = "act
     (directory / "README.md").write_text(
         (root / "templates" / "work-item.README.md").read_text(encoding="utf-8")
         .replace("NNN", item_id).replace("Title Of The Work", title), encoding="utf-8")
+    generate_dashboard.write_dashboard(root, today=today)
     return manifest_path
 
 
@@ -80,6 +82,7 @@ def new_markdown(kind: str, title: str, today: date, root: Path = ROOT) -> Path:
     text = text.replace("Decision Title", title).replace("Policy Title", title)
     path = directory / f"{record_id}-{slug}.md"
     path.write_text(text, encoding="utf-8")
+    generate_dashboard.write_dashboard(root, today=today)
     return path
 
 

{repopact-2.1.0 → repopact-2.2.0}/scripts/plan_import.py

@@ -30,6 +30,7 @@ from datetime import date
 from pathlib import Path
 
 import adopt_repo  # reuse Report and _slug
+import generate_dashboard
 
 PLAN_DIR_NAMES = ("todos", "todo", "tasks", "plan", "planning", "backlog")
 CHECKLIST_FILES = ("TODO.md", "TODOS.md", "ROADMAP.md", "BACKLOG.md", "PLAN.md", "TASKS.md")
@@ -359,6 +360,8 @@ def import_plan(root: Path, today: date | None = None, dry_run: bool = False,
     # A `tracking/` governance system maps to decisions/, findings, and work items.
     import track_import
     track_import.import_tracking(root, rep, today)
+    if not dry_run:
+        generate_dashboard.write_dashboard(root, today=today)
     return rep
 
 

{repopact-2.1.0 → repopact-2.2.0}/scripts/repopact.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repopact
-Version: 2.1.0
+Version: 2.2.0
 Summary: A repository-native standard for durable agent work: binding invariants, evidence-gated work items, and drift audits.
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/ForgeWireLabs/repopact
@@ -22,8 +22,8 @@ cannot be silently weakened.
 > The repository is the pact: authority, intent, evidence, and history that survive every
 > session.
 
-`pip install repopact` · Apache-2.0 · current release **2.1.0**
-([changelog](decisions/0024-release-2.1.0-proposed-lifecycle.md)).
+`pip install repopact` · Apache-2.0 · current release **2.2.0**
+([changelog](decisions/0025-release-2.2.0-dashboard-integrity.md)).
 
 ## How it relates to `AGENTS.md`
 

{repopact-2.1.0 → repopact-2.2.0}/scripts/repopact_cli.py

@@ -150,12 +150,11 @@ def main(argv: list[str] | None = None) -> int:
               else f"\nValidation failed with {len(problems)} error(s).")
         return 1 if problems else 0
 
-    if args.command == "dashboard":
-        import generate_dashboard
-        out = root / "audits" / "reports" / "dashboard.md"
-        out.write_text(generate_dashboard.generate(root), encoding="utf-8")
-        print(f"Generated {out.relative_to(root)}")
-        return 0
+    if args.command == "dashboard":
+        import generate_dashboard
+        out = generate_dashboard.write_dashboard(root)
+        print(f"Generated {out.relative_to(root)}")
+        return 0
 
     if args.command == "spec":
         import generate_spec

{repopact-2.1.0 → repopact-2.2.0}/scripts/run_conformance.py

@@ -16,6 +16,8 @@ import tempfile
 from dataclasses import dataclass
 from pathlib import Path
 
+import generate_dashboard
+
 
 ROOT = Path(__file__).resolve().parents[1]
 MANIFEST = ROOT / "conformance" / "manifest.json"
@@ -54,6 +56,10 @@ def materialize_case(root: Path, fixtures_root: Path, case: dict) -> Path:
     else:
         shutil.copytree(fixtures_root / str(case["path"]), repo)
     shutil.copytree(ROOT / "schemas", repo / "schemas")
+    # Overlays intentionally mutate source records. Materialize their canonical
+    # derived projection so each case tests its declared rule rather than failing
+    # secondarily on dashboard drift.
+    generate_dashboard.write_dashboard(repo)
     return repo
 
 

{repopact-2.1.0 → repopact-2.2.0}/scripts/takeover.py

@@ -35,6 +35,8 @@ import sys
 from datetime import date
 from pathlib import Path
 
+import generate_dashboard
+
 import adopt_repo
 import plan_import
 import validate_repo
@@ -362,6 +364,7 @@ def takeover(root: Path, delete: bool = False, dry_run: bool = False) -> dict:
             report["review"].append(hint)
 
     if not dry_run and report["retired"]:
+        generate_dashboard.write_dashboard(root)
         report["post_validate_ok"] = not validate_repo.validate(root)
     return report
 

{repopact-2.1.0 → repopact-2.2.0}/scripts/validate_repo.py

@@ -8,10 +8,11 @@ from dataclasses import dataclass
 from datetime import date, datetime
 from pathlib import Path
 
-import jsonschema
-
-from frontmatter import FrontMatterError, parse_file
-from repo_model import STATUSES, discover_evidence_ids, discover_work_items, iter_contracts, load_json
+import jsonschema
+
+from frontmatter import FrontMatterError, parse_file
+import generate_dashboard
+from repo_model import STATUSES, discover_evidence_ids, discover_work_items, iter_contracts, load_json
 
 
 REQUIRED_WORK_FIELDS = {
@@ -473,7 +474,7 @@ def validate_evidence(root: Path, work_ids: set[str], problems: list[Problem]) -
             problems.append(Problem(path, f"unknown work_item '{data['work_item']}'"))
 
 
-def validate_audit_registry(root: Path, problems: list[Problem]) -> None:
+def validate_audit_registry(root: Path, problems: list[Problem]) -> None:
     path = root / "audits" / "registry.json"
     try:
         data = load_json(path)
@@ -485,7 +486,33 @@ def validate_audit_registry(root: Path, problems: list[Problem]) -> None:
         if not scope_path.exists():
             problems.append(Problem(path, f"audit scope does not exist: {entry.get('path')}"))
         validate_dates(entry.get("last_reviewed"), "last_reviewed", path, problems)
-        validate_dates(entry.get("next_review"), "next_review", path, problems)
+        validate_dates(entry.get("next_review"), "next_review", path, problems)
+
+
+def validate_dashboard(root: Path, problems: list[Problem]) -> None:
+    """Reject a missing or stale committed dashboard projection.
+
+    Source-record validation remains authoritative. If malformed sources prevent
+    generation, their existing validators report the primary error and this
+    secondary comparison stays silent instead of crashing validation.
+    """
+    path = root / "audits" / "reports" / "dashboard.md"
+    if not path.is_file():
+        problems.append(Problem(
+            path,
+            "missing generated dashboard; run `repopact dashboard --root .`",
+        ))
+        return
+    try:
+        expected = generate_dashboard.generate(root)
+        actual = path.read_text(encoding="utf-8")
+    except (OSError, ValueError, KeyError, TypeError, json.JSONDecodeError):
+        return
+    if actual != expected:
+        problems.append(Problem(
+            path,
+            "generated dashboard is stale; run `repopact dashboard --root .` and commit the result",
+        ))
 
 
 def _validate_records(root: Path, directory: Path, pattern: str, statuses: tuple[str, ...],
@@ -594,10 +621,11 @@ def validate(root: Path) -> list[Problem]:
     validate_findings(root, owner_scopes, problems)
     work_ids = validate_work(root, owner_scopes, enforce_disjoint, problems)
     validate_orphan_work_dirs(root, problems)
-    validate_evidence(root, work_ids, problems)
-    validate_audit_registry(root, problems)
-    validate_decisions(root, problems)
-    validate_policies(root, problems)
+    validate_evidence(root, work_ids, problems)
+    validate_audit_registry(root, problems)
+    validate_decisions(root, problems)
+    validate_policies(root, problems)
+    validate_dashboard(root, problems)
     return sorted(problems, key=lambda problem: (str(problem.path), problem.message))
 
 

{repopact-2.1.0 → repopact-2.2.0}/tests/test_conformance.py

@@ -21,6 +21,7 @@ ROOT = Path(__file__).resolve().parents[1]
 sys.path.insert(0, str(ROOT / "scripts"))
 
 from validate_repo import validate  # noqa: E402
+import generate_dashboard  # noqa: E402
 
 import run_conformance  # noqa: E402
 
@@ -33,6 +34,7 @@ INVALID = FIXTURES / "invalid"
 def build_repo(dst: Path, overlay: Path | None = None) -> Path:
     shutil.copytree(VALID, dst)
     shutil.copytree(ROOT / "schemas", dst / "schemas")
+    generate_dashboard.write_dashboard(dst)
     if overlay is not None:
         for src in overlay.rglob("*"):
             if src.is_dir() or src.name == "meta.json":

{repopact-2.1.0 → repopact-2.2.0}/tests/test_validate_repo.py

@@ -3,9 +3,10 @@ from __future__ import annotations
 import json
 import shutil
 import sys
-import tempfile
-import unittest
-from pathlib import Path
+import tempfile
+import unittest
+from datetime import date
+from pathlib import Path
 
 
 ROOT = Path(__file__).resolve().parents[1]
@@ -15,8 +16,9 @@ import adopt_repo  # noqa: E402
 import plan_import  # noqa: E402
 import takeover  # noqa: E402
 import doctor  # noqa: E402
-import check_frozen_surface  # noqa: E402
-import generate_spec  # noqa: E402
+import check_frozen_surface  # noqa: E402
+import generate_dashboard  # noqa: E402
+import generate_spec  # noqa: E402
 import init_repo  # noqa: E402
 import repopact_cli  # noqa: E402
 from validate_repo import validate  # noqa: E402
@@ -70,21 +72,41 @@ class RepositoryValidationTests(unittest.TestCase):
             "created": "2026-06-15",
             "updated": "2026-06-15",
         }
-        if preflight:
+        if preflight:
             data["preflight"] = {
                 "created_before_work_started": True,
                 "created_at": "2026-06-15T00:00:00Z",
                 "note": "probe",
             }
         (directory / "work-item.json").write_text(json.dumps(data), encoding="utf-8")
+        generate_dashboard.write_dashboard(self.root)
 
     def add_active_item(self, item_id: str, owner_scope: str = "work", preflight: bool = True) -> None:
         self.add_work_item(item_id, "active", owner_scope, preflight)
 
     # --- baseline -----------------------------------------------------------
 
-    def test_repository_is_valid(self) -> None:
-        self.assertEqual([], self.problems())
+    def test_repository_is_valid(self) -> None:
+        self.assertEqual([], self.problems())
+
+    def test_missing_dashboard_is_rejected(self) -> None:
+        (self.root / "audits" / "reports" / "dashboard.md").unlink()
+        self.assertTrue(any("missing generated dashboard" in value for value in self.problems()))
+
+    def test_stale_dashboard_is_rejected_and_doctor_repairs_it(self) -> None:
+        dashboard = self.root / "audits" / "reports" / "dashboard.md"
+        dashboard.write_text("# obsolete dashboard\n", encoding="utf-8")
+        self.assertTrue(any("generated dashboard is stale" in value for value in self.problems()))
+
+        actions = doctor.fix(self.root, today=date(2026, 7, 18))
+        self.assertIn("regenerated audits/reports/dashboard.md", actions)
+        self.assertEqual([], self.problems())
+
+    def test_dashboard_generation_is_stable_between_audit_transitions(self) -> None:
+        first = generate_dashboard.generate(self.root, today=date(2026, 7, 18))
+        later = generate_dashboard.generate(self.root, today=date(2026, 7, 19))
+        self.assertEqual(first, later)
+        self.assertNotIn("> Generated:", first)
 
     # --- work lifecycle -----------------------------------------------------
 
@@ -704,8 +726,9 @@ class RepositoryValidationTests(unittest.TestCase):
             "contract": "todos/12-search/AGENTS.md", "last_reviewed": "2026-06-15",
             "next_review": "2026-09-13", "alignment": "current", "notes": "nested",
         })
-        (repo / "audits" / "registry.json").write_text(json.dumps(reg, indent=2) + "\n", encoding="utf-8")
-        report = takeover.takeover(repo, delete=True)
+        (repo / "audits" / "registry.json").write_text(json.dumps(reg, indent=2) + "\n", encoding="utf-8")
+        generate_dashboard.write_dashboard(repo)
+        report = takeover.takeover(repo, delete=True)
         self.assertEqual([], report["retired"])               # not retired
         self.assertTrue((repo / "todos").exists())
         self.assertTrue(any(b["dir"] == "todos" for b in report["blocked"]))

repopact-2.1.0/VERSION

@@ -1 +0,0 @@
-2.1.0