repopact 2.0.2__tar.gz → 2.2.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repopact
-Version: 2.0.2
+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.0.2**
-([changelog](decisions/0022-release-2.0.2-installed-seed-lookup.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`
 
@@ -71,7 +71,8 @@ intent -> scoped authority -> work item -> implementation -> evidence -> audit -
 pip install repopact                # the CLI + reference validator, from PyPI
 repopact init --target ../your-repo # seed a valid RepoPact in a new repo
 cd ../your-repo
-repopact new work-item "Title of the work"   # stamps records (incl. the preflight marker)
+repopact new work-item "Title of the work"   # stamps active work (incl. the preflight marker)
+repopact new work-item "Candidate idea" --status proposed
 repopact validate
 repopact dashboard
 ```
@@ -110,7 +111,7 @@ idempotent.
 
 ## 2.0: mandatory preflight + provenance-typed records
 
-Decision [`0021`](decisions/0022-release-2.0.2-installed-seed-lookup.md) (supersedes 0018):
+Decision [`0021`](decisions/0021-preflight-mandatory-and-provenance.md) (supersedes 0018):
 
 - **Mandatory preflight (default on).** No work begins until a work item exists and
   propagates through the pact; `repopact new` stamps the marker. Existing repos grandfather
@@ -123,9 +124,17 @@ Decision [`0021`](decisions/0022-release-2.0.2-installed-seed-lookup.md) (supers
 
 ## Status is a filesystem transition
 
-Work moves between `work/active`, `work/blocked`, `work/deferred`, and `work/completed`; its
-`work-item.json` status must match its directory. Moving a work item never deletes its
-reasoning, decisions, or evidence links.
+Work moves between lifecycle directories; its `work-item.json` status must match its
+directory. Moving a work item never deletes its reasoning, decisions, or evidence links.
+
+- `proposed`: captured candidate work that is not yet accepted or authorized for
+  implementation.
+- `active`: accepted work authorized for design or implementation.
+- `blocked`: accepted/current work that cannot proceed until a named condition changes.
+- `deferred`: accepted work intentionally postponed with rationale.
+- `completed`: delivered work whose acceptance criteria are evidence-closed.
+
+Active and completed work cannot depend on proposed work as if it were accepted.
 
 ## Derive over declare
 

{repopact-2.0.2 → 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.0.2**
-([changelog](decisions/0022-release-2.0.2-installed-seed-lookup.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`
 
@@ -58,7 +58,8 @@ intent -> scoped authority -> work item -> implementation -> evidence -> audit -
 pip install repopact                # the CLI + reference validator, from PyPI
 repopact init --target ../your-repo # seed a valid RepoPact in a new repo
 cd ../your-repo
-repopact new work-item "Title of the work"   # stamps records (incl. the preflight marker)
+repopact new work-item "Title of the work"   # stamps active work (incl. the preflight marker)
+repopact new work-item "Candidate idea" --status proposed
 repopact validate
 repopact dashboard
 ```
@@ -97,7 +98,7 @@ idempotent.
 
 ## 2.0: mandatory preflight + provenance-typed records
 
-Decision [`0021`](decisions/0022-release-2.0.2-installed-seed-lookup.md) (supersedes 0018):
+Decision [`0021`](decisions/0021-preflight-mandatory-and-provenance.md) (supersedes 0018):
 
 - **Mandatory preflight (default on).** No work begins until a work item exists and
   propagates through the pact; `repopact new` stamps the marker. Existing repos grandfather
@@ -110,9 +111,17 @@ Decision [`0021`](decisions/0022-release-2.0.2-installed-seed-lookup.md) (supers
 
 ## Status is a filesystem transition
 
-Work moves between `work/active`, `work/blocked`, `work/deferred`, and `work/completed`; its
-`work-item.json` status must match its directory. Moving a work item never deletes its
-reasoning, decisions, or evidence links.
+Work moves between lifecycle directories; its `work-item.json` status must match its
+directory. Moving a work item never deletes its reasoning, decisions, or evidence links.
+
+- `proposed`: captured candidate work that is not yet accepted or authorized for
+  implementation.
+- `active`: accepted work authorized for design or implementation.
+- `blocked`: accepted/current work that cannot proceed until a named condition changes.
+- `deferred`: accepted work intentionally postponed with rationale.
+- `completed`: delivered work whose acceptance criteria are evidence-closed.
+
+Active and completed work cannot depend on proposed work as if it were accepted.
 
 ## Derive over declare
 

repopact-2.2.0/VERSION

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

{repopact-2.0.2 → repopact-2.2.0}/schemas/work-item.schema.json

@@ -6,7 +6,7 @@
   "properties": {
     "id": {"type": "string", "pattern": "^[0-9]{3,}$"},
     "title": {"type": "string", "minLength": 1},
-    "status": {"enum": ["active", "blocked", "deferred", "completed"]},
+    "status": {"enum": ["proposed", "active", "blocked", "deferred", "completed"]},
     "owner_scope": {"type": "string", "minLength": 1},
     "affected_scopes": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
     "depends_on": {"type": "array", "items": {"type": "string", "pattern": "^[0-9]{3,}$"}, "uniqueItems": true},
@@ -39,4 +39,3 @@
     "updated": {"type": "string", "format": "date"}
   }
 }
-

{repopact-2.0.2 → 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.0.2 → 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.0.2 → 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.0.2 → repopact-2.2.0}/scripts/init_repo.py

@@ -16,9 +16,11 @@ 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 = ("active", "blocked", "deferred", "completed")
+LIFECYCLE = ("proposed", "active", "blocked", "deferred", "completed")
 MODULES = (
     "repo_model.py", "validate_repo.py", "generate_dashboard.py", "generate_spec.py",
     "init_repo.py", "new.py", "check_frozen_surface.py", "frontmatter.py", "repopact_cli.py",
@@ -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.0.2 → repopact-2.2.0}/scripts/new.py

@@ -16,6 +16,9 @@ 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]
 
 
@@ -32,11 +35,13 @@ def _next_numeric(paths: list[Path], width: int, start: int) -> str:
     return str(max(used + [start - 1]) + 1).zfill(width)
 
 
-def new_work_item(title: str, today: date, root: Path = ROOT) -> Path:
+def new_work_item(title: str, today: date, root: Path = ROOT, status: str = "active") -> Path:
+    if status not in STATUSES:
+        raise ValueError(f"unknown work-item status '{status}'")
     slug = slugify(title)
     existing = list((root / "work").glob("*/*/work-item.json"))
     item_id = _next_numeric([p.parent for p in existing], 3, 1)
-    directory = root / "work" / "active" / f"{item_id}-{slug}"
+    directory = root / "work" / status / f"{item_id}-{slug}"
     directory.mkdir(parents=True)
     # Mandatory preflight (decision 0021): creating the work item with `new` IS the
     # preflight act, so stamp the marker and concrete provenance up front. No work
@@ -44,7 +49,7 @@ def new_work_item(title: str, today: date, root: Path = ROOT) -> Path:
     created_at = datetime.combine(today, datetime.min.time()).isoformat() + "Z"
     manifest = {
         "$schema": "../../../schemas/work-item.schema.json",
-        "id": item_id, "title": title, "status": "active",
+        "id": item_id, "title": title, "status": status,
         "owner_scope": "governance", "affected_scopes": [], "depends_on": [],
         "provenance": "concrete",
         "preflight": {
@@ -60,6 +65,7 @@ def new_work_item(title: str, today: date, root: Path = ROOT) -> Path:
     (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
 
 
@@ -76,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
 
 
@@ -83,10 +90,12 @@ def main() -> int:
     parser = argparse.ArgumentParser(description="Stamp a new record from a template")
     parser.add_argument("kind", choices=["work-item", "decision", "policy"])
     parser.add_argument("title")
+    parser.add_argument("--status", choices=STATUSES, default="active",
+                        help="Lifecycle status for a new work item")
     args = parser.parse_args()
     today = date.today()
     if args.kind == "work-item":
-        path = new_work_item(args.title, today)
+        path = new_work_item(args.title, today, status=args.status)
     else:
         path = new_markdown(args.kind, args.title, today)
     print(f"Created {path.relative_to(ROOT)}")

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

@@ -11,7 +11,7 @@ Supported sources (extensible):
 
 * **Plan directories** — `todos/`, `todo/`, `tasks/`, `plan/`, `planning/`, `backlog/`
   with one subdirectory or markdown file per item, optionally grouped under
-  `completed/`, `deferred/`, `blocked/`, `active/` lifecycle folders.
+  `proposed/`, `completed/`, `deferred/`, `blocked/`, `active/` lifecycle folders.
 * **Checklist files** — `TODO.md`, `TODOS.md`, `ROADMAP.md`, `BACKLOG.md`, `PLAN.md`,
   `TASKS.md` at the root: each `- [ ]` / `- [x]` line becomes a work item.
 
@@ -30,19 +30,27 @@ 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")
-LIFECYCLE_DIRS = {"completed", "deferred", "blocked", "active"}
+LIFECYCLE_DIRS = {"proposed", "completed", "deferred", "blocked", "active"}
 
 # source lifecycle -> (work status, acceptance-criterion state)
 _STATUS = {
+    "proposed": ("proposed", "pending"),
     "completed": ("completed", "waived"),
     "deferred": ("deferred", "pending"),
     "blocked": ("blocked", "pending"),
     "active": ("active", "pending"),
 }
-_EMOJI = {"completed": "✅ Complete", "deferred": "⏸️ Deferred", "blocked": "⛔ Blocked", "active": "📋 Active"}
+_EMOJI = {
+    "proposed": "Proposed",
+    "completed": "✅ Complete",
+    "deferred": "⏸️ Deferred",
+    "blocked": "⛔ Blocked",
+    "active": "📋 Active",
+}
 
 _SKIP_DIRS = {".git", ".venv", "node_modules", "__pycache__"}
 # Index/template/readme files in a plan directory are scaffolding, not plan items.
@@ -55,7 +63,7 @@ def _is_scaffold(name: str) -> bool:
 
 @dataclass
 class PlanItem:
-    lifecycle: str          # completed | deferred | blocked | active
+    lifecycle: str          # proposed | completed | deferred | blocked | active
     slug: str               # RepoPact slug (no leading number)
     title: str
     narrative: str          # markdown body to preserve
@@ -352,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.0.2 → repopact-2.2.0}/scripts/repo_model.py

@@ -6,7 +6,7 @@ from pathlib import Path
 from typing import Any
 
 
-STATUSES = ("active", "blocked", "deferred", "completed")
+STATUSES = ("proposed", "active", "blocked", "deferred", "completed")
 
 # Directories that are not part of the governed tree: tooling caches and, notably,
 # test fixtures, which are self-contained sub-repositories validated on their own.
@@ -64,4 +64,3 @@ def discover_evidence_ids(root: Path) -> set[str]:
     for path in sorted((root / "evidence" / "runs").glob("*.json")):
         result.add(str(load_json(path).get("id", "")))
     return result
-

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repopact
-Version: 2.0.2
+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.0.2**
-([changelog](decisions/0022-release-2.0.2-installed-seed-lookup.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`
 
@@ -71,7 +71,8 @@ intent -> scoped authority -> work item -> implementation -> evidence -> audit -
 pip install repopact                # the CLI + reference validator, from PyPI
 repopact init --target ../your-repo # seed a valid RepoPact in a new repo
 cd ../your-repo
-repopact new work-item "Title of the work"   # stamps records (incl. the preflight marker)
+repopact new work-item "Title of the work"   # stamps active work (incl. the preflight marker)
+repopact new work-item "Candidate idea" --status proposed
 repopact validate
 repopact dashboard
 ```
@@ -110,7 +111,7 @@ idempotent.
 
 ## 2.0: mandatory preflight + provenance-typed records
 
-Decision [`0021`](decisions/0022-release-2.0.2-installed-seed-lookup.md) (supersedes 0018):
+Decision [`0021`](decisions/0021-preflight-mandatory-and-provenance.md) (supersedes 0018):
 
 - **Mandatory preflight (default on).** No work begins until a work item exists and
   propagates through the pact; `repopact new` stamps the marker. Existing repos grandfather
@@ -123,9 +124,17 @@ Decision [`0021`](decisions/0022-release-2.0.2-installed-seed-lookup.md) (supers
 
 ## Status is a filesystem transition
 
-Work moves between `work/active`, `work/blocked`, `work/deferred`, and `work/completed`; its
-`work-item.json` status must match its directory. Moving a work item never deletes its
-reasoning, decisions, or evidence links.
+Work moves between lifecycle directories; its `work-item.json` status must match its
+directory. Moving a work item never deletes its reasoning, decisions, or evidence links.
+
+- `proposed`: captured candidate work that is not yet accepted or authorized for
+  implementation.
+- `active`: accepted work authorized for design or implementation.
+- `blocked`: accepted/current work that cannot proceed until a named condition changes.
+- `deferred`: accepted work intentionally postponed with rationale.
+- `completed`: delivered work whose acceptance criteria are evidence-closed.
+
+Active and completed work cannot depend on proposed work as if it were accepted.
 
 ## Derive over declare
 

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

@@ -10,8 +10,10 @@ from __future__ import annotations
 
 import argparse
 import sys
-from datetime import date
-from pathlib import Path
+from datetime import date
+from pathlib import Path
+
+from repo_model import STATUSES
 
 
 def main(argv: list[str] | None = None) -> int:
@@ -50,10 +52,12 @@ def main(argv: list[str] | None = None) -> int:
     p_spec = sub.add_parser("spec", help="Regenerate SPEC.md derived blocks")
     p_spec.add_argument("--root", type=Path, default=Path.cwd())
 
-    p_new = sub.add_parser("new", help="Stamp a new record from a template")
-    p_new.add_argument("kind", choices=["work-item", "decision", "policy"])
-    p_new.add_argument("title")
-    p_new.add_argument("--root", type=Path, default=Path.cwd())
+    p_new = sub.add_parser("new", help="Stamp a new record from a template")
+    p_new.add_argument("kind", choices=["work-item", "decision", "policy"])
+    p_new.add_argument("title")
+    p_new.add_argument("--root", type=Path, default=Path.cwd())
+    p_new.add_argument("--status", choices=STATUSES, default="active",
+                       help="Lifecycle status for a new work item")
 
     p_frz = sub.add_parser("check-frozen", help="Report frozen-surface changes in a diff range")
     p_frz.add_argument("--root", type=Path, default=Path.cwd())
@@ -146,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
@@ -169,10 +172,10 @@ def main(argv: list[str] | None = None) -> int:
         print("Generated SPEC.md derived blocks")
         return 0
 
-    if args.command == "new":
-        import new
-        if args.kind == "work-item":
-            path = new.new_work_item(args.title, date.today(), root)
+    if args.command == "new":
+        import new
+        if args.kind == "work-item":
+            path = new.new_work_item(args.title, date.today(), root, status=args.status)
         else:
             path = new.new_markdown(args.kind, args.title, date.today(), root)
         print(f"Created {path.relative_to(root)}")

{repopact-2.0.2 → 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.0.2 → 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
@@ -197,7 +199,7 @@ def registry_scopes_inside(root: Path, d: Path) -> list[str]:
 # File types we scan for inbound references; everything else (binaries, build output) is skipped.
 _TEXT_EXTS = {".md", ".markdown", ".txt", ".rst", ".py", ".toml", ".yaml", ".yml",
               ".json", ".cfg", ".ini", ".sh", ".ps1"}
-_LIFECYCLE = {"completed", "deferred", "active", "blocked"}
+_LIFECYCLE = {"completed", "deferred", "active", "blocked", "proposed"}
 _MD_LINK = re.compile(r"(\]\()([^)\s]+)(\))")
 
 
@@ -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.0.2 → 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 = {
@@ -381,11 +382,18 @@ def validate_work(root: Path, owner_scopes: set[str], enforce_disjoint: bool, pr
         validate_work_preflight(item, manifest, preflight_cfg, problems)
         validate_provenance(item, ev_prov, manifest, problems)
 
-    all_ids = set(seen)
-    for item in items:
-        for dependency in item.data.get("depends_on", []):
-            if dependency not in all_ids:
-                problems.append(Problem(item.directory / "work-item.json", f"unknown dependency '{dependency}'"))
+    all_ids = set(seen)
+    status_by_id = {item.item_id: item.status for item in items}
+    for item in items:
+        for dependency in item.data.get("depends_on", []):
+            if dependency not in all_ids:
+                problems.append(Problem(item.directory / "work-item.json", f"unknown dependency '{dependency}'"))
+            elif item.status in ("active", "completed") and status_by_id.get(dependency) == "proposed":
+                problems.append(Problem(
+                    item.directory / "work-item.json",
+                    f"{item.status} work item depends on proposed work item '{dependency}'; "
+                    "proposed work is not accepted implementation authority",
+                ))
 
     detect_dependency_cycles(items, all_ids, problems)
     if enforce_disjoint:
@@ -466,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)
@@ -478,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, ...],
@@ -587,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.0.2 → 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.0.2 → 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
@@ -48,34 +50,63 @@ class RepositoryValidationTests(unittest.TestCase):
         mutate(data)
         path.write_text(json.dumps(data), encoding="utf-8")
 
-    def add_active_item(self, item_id: str, owner_scope: str = "work", preflight: bool = True) -> None:
-        directory = self.root / "work" / "active" / f"{item_id}-probe"
-        directory.mkdir(parents=True)
-        (directory / "README.md").write_text("# probe\n", encoding="utf-8")
-        data = {
-            "id": item_id,
-            "title": "probe",
-            "status": "active",
-            "owner_scope": owner_scope,
-            "affected_scopes": [],
-            "depends_on": [],
+    def add_work_item(
+        self,
+        item_id: str,
+        status: str = "active",
+        owner_scope: str = "work",
+        preflight: bool = True,
+    ) -> None:
+        directory = self.root / "work" / status / f"{item_id}-probe"
+        directory.mkdir(parents=True)
+        (directory / "README.md").write_text("# probe\n", encoding="utf-8")
+        data = {
+            "id": item_id,
+            "title": "probe",
+            "status": status,
+            "owner_scope": owner_scope,
+            "affected_scopes": [],
+            "depends_on": [],
             "provenance": "concrete",
             "acceptance_criteria": [{"id": "AC-1", "text": "x", "state": "pending", "evidence": []}],
             "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")
-
+            }
+        (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 -----------------------------------------------------
 
@@ -90,10 +121,27 @@ class RepositoryValidationTests(unittest.TestCase):
         self.write_json(path, lambda d: (d["acceptance_criteria"][0].update({"state": "satisfied", "evidence": []})))
         self.assertTrue(any("satisfied without evidence" in v for v in self.problems()))
 
-    def test_completed_item_cannot_have_pending_criteria(self) -> None:
-        path = self.manifest()
-        self.write_json(path, lambda d: (d["acceptance_criteria"][0].update({"state": "pending", "evidence": []})))
-        self.assertTrue(any("completed item has pending criterion" in v for v in self.problems()))
+    def test_completed_item_cannot_have_pending_criteria(self) -> None:
+        path = self.manifest()
+        self.write_json(path, lambda d: (d["acceptance_criteria"][0].update({"state": "pending", "evidence": []})))
+        self.assertTrue(any("completed item has pending criterion" in v for v in self.problems()))
+
+    def test_valid_proposed_work_item_validates(self) -> None:
+        self.add_work_item("900", status="proposed")
+        self.assertEqual([], self.problems())
+
+    def test_invalid_proposed_work_item_fails_structure_validation(self) -> None:
+        self.add_work_item("900", status="proposed")
+        path = self.root / "work" / "proposed" / "900-probe" / "work-item.json"
+        self.write_json(path, lambda d: d.pop("title"))
+        self.assertTrue(any("missing fields: title" in v for v in self.problems()))
+
+    def test_active_work_cannot_depend_on_proposed_work(self) -> None:
+        self.add_work_item("900", status="proposed")
+        self.add_active_item("901")
+        active = self.root / "work" / "active" / "901-probe" / "work-item.json"
+        self.write_json(active, lambda d: d.__setitem__("depends_on", ["900"]))
+        self.assertTrue(any("depends on proposed work item '900'" in v for v in self.problems()))
 
     def test_readme_checkbox_parity_flags_contradiction(self) -> None:
         path = self.manifest()
@@ -398,10 +446,11 @@ class RepositoryValidationTests(unittest.TestCase):
 
     # --- bootstrap (003 B1) -------------------------------------------------
 
-    def test_bootstrap_produces_valid_repo(self) -> None:
-        target = Path(self.temp.name) / "seeded"
-        init_repo.bootstrap(target)
-        self.assertEqual([], [p.message for p in validate(target)])
+    def test_bootstrap_produces_valid_repo(self) -> None:
+        target = Path(self.temp.name) / "seeded"
+        init_repo.bootstrap(target)
+        self.assertTrue((target / "work" / "proposed").is_dir())
+        self.assertEqual([], [p.message for p in validate(target)])
 
     # --- SPEC generator determinism (004) ----------------------------------
 
@@ -418,12 +467,21 @@ class RepositoryValidationTests(unittest.TestCase):
     def test_cli_validate_returns_zero_on_valid_repo(self) -> None:
         self.assertEqual(0, repopact_cli.main(["validate", "--root", str(self.root)]))
 
-    def test_cli_new_stamps_a_valid_record(self) -> None:
-        rc = repopact_cli.main(["new", "work-item", "Cli Probe", "--root", str(self.root)])
-        self.assertEqual(0, rc)
-        stamped = list((self.root / "work" / "active").glob("*-cli-probe/work-item.json"))
-        self.assertEqual(1, len(stamped))
-        self.assertEqual([], [p.message for p in validate(self.root)])
+    def test_cli_new_stamps_a_valid_record(self) -> None:
+        rc = repopact_cli.main(["new", "work-item", "Cli Probe", "--root", str(self.root)])
+        self.assertEqual(0, rc)
+        stamped = list((self.root / "work" / "active").glob("*-cli-probe/work-item.json"))
+        self.assertEqual(1, len(stamped))
+        self.assertEqual([], [p.message for p in validate(self.root)])
+
+    def test_cli_new_can_stamp_proposed_work_item(self) -> None:
+        rc = repopact_cli.main(["new", "work-item", "Cli Proposal", "--status", "proposed", "--root", str(self.root)])
+        self.assertEqual(0, rc)
+        stamped = list((self.root / "work" / "proposed").glob("*-cli-proposal/work-item.json"))
+        self.assertEqual(1, len(stamped))
+        data = json.loads(stamped[0].read_text(encoding="utf-8"))
+        self.assertEqual("proposed", data["status"])
+        self.assertEqual([], [p.message for p in validate(self.root)])
 
     # --- proving-ground hardening (007) -------------------------------------
 
@@ -668,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.0.2/VERSION

@@ -1 +0,0 @@
-2.0.2