prodc 0.3.7__tar.gz → 0.3.8__tar.gz

{prodc-0.3.7 → prodc-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: prodc
-Version: 0.3.7
+Version: 0.3.8
 Summary: Product management as code: personas, flows, and features traced to evidence.
 Project-URL: Homepage, https://gitlab.com/jorgeecardona/prodc
 Project-URL: Repository, https://gitlab.com/jorgeecardona/prodc

{prodc-0.3.7 → prodc-0.3.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "prodc"
-version = "0.3.7"
+version = "0.3.8"
 description = "Product management as code: personas, flows, and features traced to evidence."
 readme = "README.md"
 requires-python = ">=3.12"

{prodc-0.3.7 → prodc-0.3.8}/src/prodc/cli.py

@@ -13,6 +13,7 @@ import shutil
 import sys
 from dataclasses import asdict, dataclass
 from pathlib import Path
+from typing import cast
 
 from . import __version__
 from .config import Config, ConfigError
@@ -380,6 +381,51 @@ def _cmd_portfolio(args: argparse.Namespace) -> int:
     return 2 if any(r.error is not None for r in rows) else 0
 
 
+def _cmd_diff(args: argparse.Namespace) -> int:
+    """Diff the current board against a prior `status --json` snapshot."""
+    loaded = _load_or_report(args)
+    if loaded is None:
+        return 2
+    cfg, needs = loaded
+    current = {r.need.id: r.state.value for r in resolve(needs, cfg.adapters, cfg.source_adapters)}
+
+    snap = Path(args.snapshot)
+    try:
+        payload: object = json.loads(snap.read_text(encoding="utf-8"))
+    except (OSError, ValueError) as exc:
+        print(f"prodc: cannot read snapshot {snap}: {exc}", file=sys.stderr)
+        return 2
+    raw_needs = cast("dict[str, object]", payload).get("needs") if isinstance(payload, dict) else None
+    old: dict[str, str] = {}
+    for n in cast("list[object]", raw_needs) if isinstance(raw_needs, list) else []:
+        if isinstance(n, dict):
+            entry = cast("dict[str, object]", n)
+            nid, st = entry.get("id"), entry.get("state")
+            if isinstance(nid, str) and isinstance(st, str):
+                old[nid] = st
+
+    new = {i: current[i] for i in sorted(current.keys() - old.keys())}
+    removed = sorted(old.keys() - current.keys())
+    changed = {
+        i: [old[i], current[i]] for i in sorted(old.keys() & current.keys()) if old[i] != current[i]
+    }
+    if args.json:
+        print(json.dumps({"new": new, "removed": removed, "changed": changed}, indent=2))
+        return 0
+    if not (new or removed or changed):
+        print("no changes since snapshot")
+        return 0
+    out: list[str] = []
+    for i, st in new.items():
+        out.append(f"  new      {i:<10} ({st})")
+    for i in removed:
+        out.append(f"  removed  {i}")
+    for i, (was, now) in changed.items():
+        out.append(f"  changed  {i:<10} {was} → {now}")
+    print("\n".join(out))
+    return 0
+
+
 def _git_rev(root: Path) -> str | None:
     head = root / ".git" / "HEAD"
     try:
@@ -437,6 +483,12 @@ def main(argv: list[str] | None = None) -> int:
     pf.add_argument("--json", action="store_true", help="machine-readable output")
     pf.set_defaults(func=_cmd_portfolio)
 
+    df = sub.add_parser("diff", help="diff the current board against a prior status --json snapshot")
+    df.add_argument("snapshot", help="path to a saved `prodc status --json` file")
+    df.add_argument("--config", default="prodc.toml", help="path to prodc.toml")
+    df.add_argument("--json", action="store_true", help="machine-readable output")
+    df.set_defaults(func=_cmd_diff)
+
     args = parser.parse_args(argv)
     return int(args.func(args))
 

{prodc-0.3.7 → prodc-0.3.8}/tests/test_cli.py

@@ -179,6 +179,30 @@ def test_portfolio_bad_config_exits_2(tmp_path: Path, capsys: pytest.CaptureFixt
     assert code == 2
 
 
+def test_diff_no_changes(tmp_path: Path, capsys: pytest.CaptureFixture[str]) -> None:
+    toml = str(_project(tmp_path))
+    main(["status", "--config", toml, "--json"])
+    snap = tmp_path / "snap.json"
+    snap.write_text(capsys.readouterr().out, encoding="utf-8")
+    main(["diff", str(snap), "--config", toml])
+    assert "no changes" in capsys.readouterr().out
+
+
+def test_diff_reports_new_need(tmp_path: Path, capsys: pytest.CaptureFixture[str]) -> None:
+    toml = str(_project(tmp_path))
+    main(["status", "--config", toml, "--json"])
+    snap = tmp_path / "snap.json"
+    snap.write_text(capsys.readouterr().out, encoding="utf-8")
+    # add a brand-new need, then diff against the snapshot
+    (tmp_path / "needs" / "a.yaml").write_text(
+        _NEEDS + "  - id: X-9\n    text: a newly added need\n", encoding="utf-8"
+    )
+    code = main(["diff", str(snap), "--config", toml])
+    out = capsys.readouterr().out
+    assert code == 0
+    assert "new" in out and "X-9" in out
+
+
 def test_proxy_source_kind_warrant(tmp_path: Path, capsys: pytest.CaptureFixture[str]) -> None:
     import json