gitvow 0.8.0__tar.gz → 0.9.0__tar.gz

{gitvow-0.8.0/src/gitvow.egg-info → gitvow-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitvow
-Version: 0.8.0
+Version: 0.9.0
 Summary: Provenance and policy gate for AI-agent coding sessions: session trailers on commits, redacted session notes in git, a tool-call gate, and a local ledger. No runtime dependencies.
 Author-email: Nikhil Bora <nikhil@wirevow.com>
 License: Apache-2.0

{gitvow-0.8.0 → gitvow-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitvow"
-version = "0.8.0"
+version = "0.9.0"
 description = "Provenance and policy gate for AI-agent coding sessions: session trailers on commits, redacted session notes in git, a tool-call gate, and a local ledger. No runtime dependencies."
 readme = "README.md"
 license = {text = "Apache-2.0"}

{gitvow-0.8.0 → gitvow-0.9.0}/src/gitvow/cli.py

@@ -9,6 +9,7 @@ import re
 import sys
 
 from . import __version__
+from . import digest as dg
 from . import recall as rec
 from . import snapshots as snap
 from .collect import collect, summarize_text
@@ -232,6 +233,12 @@ def cmd_handoff(a: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_digest(a: argparse.Namespace) -> int:
+    d = dg.build(os.getcwd(), a.since)
+    print(json.dumps(d, indent=1) if a.json else dg.render(d), end="\n" if a.json else "")
+    return 0
+
+
 def cmd_push_notes(a: argparse.Namespace) -> int:
     import subprocess
 
@@ -338,6 +345,10 @@ def main(argv: list[str] | None = None) -> int:
     s = sub.add_parser("handoff", help="markdown summary for the next agent")
     s.add_argument("--session")
     s.set_defaults(f=cmd_handoff)
+    s = sub.add_parser("digest", help="period summary: agent vs human commits, sessions, attribution, gate activity")
+    s.add_argument("--since", default="7d")
+    s.add_argument("--json", action="store_true")
+    s.set_defaults(f=cmd_digest)
     s = sub.add_parser("push-notes", help="push refs/notes/gitvow/* to a remote (default origin)")
     s.add_argument("remote", nargs="?", default="origin")
     s.set_defaults(f=cmd_push_notes)

gitvow-0.9.0/src/gitvow/digest.py

@@ -0,0 +1,136 @@
+"""Period summary from the record: trailers, session notes and the hook log over a time window."""
+
+from __future__ import annotations
+
+import collections
+import json
+import os
+import re
+import time
+from typing import Any
+
+from .recall import _commits, _plan
+from .state import toplevel
+
+
+def parse_since(text: str) -> str:
+    """'7d' / '24h' / 'YYYY-MM-DD' -> a git --since value."""
+    m = re.fullmatch(r"(\d+)([dhw])", text or "")
+    if m:
+        n, unit = int(m.group(1)), m.group(2)
+        secs = n * {"d": 86400, "h": 3600, "w": 7 * 86400}[unit]
+        return time.strftime("%Y-%m-%dT%H:%M:%S", time.localtime(time.time() - secs))
+    return text
+
+
+def build(cwd: str, since: str = "7d") -> dict[str, Any]:
+    top = toplevel(cwd) or cwd
+    since_val = parse_since(since)
+    since_day = since_val[:10]
+    rows = [r for r in _commits(top, None, 5000) if r["date"] >= since_day]  # _commits has no --since
+    agent = [r for r in rows if r["kind"] == "agent"]
+    human = [r for r in rows if r["kind"] == "person"]
+    sessions: dict[str, dict[str, Any]] = {}
+    added_total = human_after = 0
+    agent_added = 0.0
+    files: collections.Counter[str] = collections.Counter()
+    file_sessions: dict[str, set[str]] = collections.defaultdict(set)
+    for r in agent:
+        s = sessions.setdefault(
+            r["session"],
+            {"session": r["session"], "date": r["date"], "commits": 0, "plan": "", "shares": [], "human_after": 0},
+        )
+        s["commits"] += 1
+        s["date"] = min(s["date"], r["date"])
+        note = r["note"] or {}
+        s["plan"] = s["plan"] or _plan(note)
+        att = note.get("attribution") or {}
+        la = att.get("lines_added_in_commit") or 0
+        share = att.get("agent_share")
+        added_total += la
+        if isinstance(share, (int, float)):
+            agent_added += la * share
+            s["shares"].append(share)
+        ha = att.get("lines_changed_by_human_after_agent") or 0
+        human_after += ha
+        s["human_after"] += ha
+        for f in att.get("files") or []:
+            if f.get("agent_wrote"):
+                files[f["path"]] += 1
+                file_sessions[f["path"]].add(r["session"])
+    gate: collections.Counter[str] = collections.Counter()
+    reasons: collections.Counter[str] = collections.Counter()
+    log = os.path.join(top, ".git", "gitvow-hooks.log")
+    if os.path.exists(log):
+        with open(log) as fh:
+            for ln in fh:
+                try:
+                    e = json.loads(ln)
+                except json.JSONDecodeError:
+                    continue
+                if (e.get("ts") or "")[:10] < since_day:
+                    continue
+                if e.get("kind") in ("blocked", "confirm_required"):
+                    gate[e["kind"]] += 1
+                    reasons[e.get("reason") or "?"] += 1
+    sess_list = sorted(sessions.values(), key=lambda s: s["date"], reverse=True)
+    for s in sess_list:
+        s["share"] = round(sum(s["shares"]) / len(s["shares"]), 2) if s["shares"] else None
+        del s["shares"]
+    return {
+        "repo": os.path.basename(top),
+        "since": since_day,
+        "until": time.strftime("%Y-%m-%d"),
+        "commits": len(rows),
+        "agent_commits": len(agent),
+        "human_commits": len(human),
+        "sessions": sess_list,
+        "agent_share": round(agent_added / added_total, 2) if added_total else None,
+        "lines_changed_by_human_after_agent": human_after,
+        "gate": {
+            "confirmations": gate["confirm_required"],
+            "denials": gate["blocked"],
+            "top_reasons": reasons.most_common(5),
+        },
+        "files": [{"path": p, "commits": n, "sessions": len(file_sessions[p])} for p, n in files.most_common(10)],
+        "human": [{"short": r["short"], "date": r["date"], "subject": r["subject"]} for r in human[:15]],
+    }
+
+
+def render(d: dict[str, Any]) -> str:
+    pct = f" ({100 * d['agent_commits'] // d['commits']}%)" if d["commits"] else ""
+    out = [f"## gitvow digest · {d['repo']} · {d['since']} → {d['until']}", ""]
+    out.append(f"Commits: {d['commits']} · by agents {d['agent_commits']}{pct} · by people {d['human_commits']}")
+    share = "n/a" if d["agent_share"] is None else f"{d['agent_share']:.2f}"
+    out.append(
+        f"Sessions: {len(d['sessions'])} · agent share of added lines {share} · lines changed by people after agents {d['lines_changed_by_human_after_agent']}"
+    )
+    g = d["gate"]
+    top = ", ".join(f"{r} ({n})" for r, n in g["top_reasons"]) or "none"
+    out.append(
+        f"Gate: {g['confirmations']} confirmation{'s' if g['confirmations'] != 1 else ''} asked, {g['denials']} denial{'s' if g['denials'] != 1 else ''} · top reasons: {top}"
+    )
+    if d["sessions"]:
+        out += ["", "### Sessions"]
+        for s in d["sessions"]:
+            sh = "n/a " if s["share"] is None else f"{s['share']:.2f}"
+            plan = f'  "{s["plan"]}"' if s["plan"] else "  (no plan recorded)"
+            after = (
+                f"  · {s['human_after']} human edit{'s' if s['human_after'] != 1 else ''} after"
+                if s["human_after"]
+                else ""
+            )
+            out.append(
+                f"{s['session'][:8]}  {s['date'][5:]}  {s['commits']} commit{'s' if s['commits'] != 1 else ' '}  share {sh}{plan}{after}"
+            )
+    if d["files"]:
+        out += ["", "### Files most changed by agents"]
+        for f in d["files"]:
+            out.append(
+                f"{f['path']}  {f['commits']} commit{'s' if f['commits'] != 1 else ''}, {f['sessions']} session{'s' if f['sessions'] != 1 else ''}"
+            )
+    if d["human"]:
+        out += ["", "### Human commits in the period"]
+        for h in d["human"]:
+            out.append(f"{h['short']}  {h['date'][5:]}  {h['subject'][:70]}")
+    return "\n".join(out) + "\n"

{gitvow-0.8.0 → gitvow-0.9.0/src/gitvow.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitvow
-Version: 0.8.0
+Version: 0.9.0
 Summary: Provenance and policy gate for AI-agent coding sessions: session trailers on commits, redacted session notes in git, a tool-call gate, and a local ledger. No runtime dependencies.
 Author-email: Nikhil Bora <nikhil@wirevow.com>
 License: Apache-2.0

{gitvow-0.8.0 → gitvow-0.9.0}/src/gitvow.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ src/gitvow/adapters.py
 src/gitvow/cli.py
 src/gitvow/collect.py
 src/gitvow/default_policy.json
+src/gitvow/digest.py
 src/gitvow/install.py
 src/gitvow/policy.py
 src/gitvow/providers.py
@@ -26,6 +27,7 @@ src/gitvow.egg-info/top_level.txt
 src/gitvow/hooks/__init__.py
 tests/test_adapters.py
 tests/test_collect.py
+tests/test_digest.py
 tests/test_hooks.py
 tests/test_install_cli.py
 tests/test_packaging.py

gitvow-0.9.0/tests/test_digest.py

@@ -0,0 +1,62 @@
+import json
+
+from gitvow import cli
+from gitvow.digest import parse_since
+from gitvow.hooks import post_tool_use, pre_tool_use, session_start
+from gitvow.install import _write_git_hook
+from tests.conftest import git
+
+
+def test_parse_since():
+    assert parse_since("2026-09-01") == "2026-09-01"
+    assert parse_since("7d") < parse_since("1h")
+    assert len(parse_since("2w")) == 19
+
+
+def test_digest_counts_and_render(repo, home, payload, transcript, monkeypatch, capsys):
+    _write_git_hook(str(repo / ".gitvow" / "git-hooks"))
+    git(repo, "config", "core.hooksPath", ".gitvow/git-hooks")
+    for sid, content in (("s-one", "one\n"), ("s-two", "two\n")):
+        p = payload("SessionStart", transcript=transcript)
+        p["session_id"] = sid
+        session_start(p, str(home))
+        (repo / "a.txt").write_text(content)
+        post_tool_use({**p, "tool_name": "Edit", "tool_input": {"file_path": str(repo / "a.txt")}}, str(home))
+        if sid == "s-two":
+            (repo / "a.txt").write_text(content + "human line\n")  # a person edits before the agent commits
+        pre_tool_use({**p, "tool_name": "Bash", "tool_input": {"command": "git push --force"}}, str(home))  # denied
+        pre_tool_use({**p, "tool_name": "Bash", "tool_input": {"command": "git push origin x"}}, str(home))  # confirm
+        pre_tool_use(
+            {**p, "tool_name": "Bash", "tool_input": {"command": "git commit -m x"}, "transcript_path": transcript},
+            str(home),
+        )
+        git(repo, "commit", "-qam", f"agent {sid}")
+        post_tool_use(
+            {**p, "tool_name": "Bash", "tool_input": {"command": "git commit -m x"}, "transcript_path": transcript},
+            str(home),
+        )
+    (repo / "h.txt").write_text("h\n")
+    git(repo, "add", "h.txt")
+    git(repo, "commit", "-qm", "human only")
+    monkeypatch.chdir(repo)
+    assert cli.main(["digest", "--json"]) == 0
+    d = json.loads(capsys.readouterr().out)
+    assert d["agent_commits"] == 2 and d["human_commits"] == 2  # init + human only
+    assert len(d["sessions"]) == 2 and d["sessions"][0]["session"] in ("s-one", "s-two")
+    assert d["lines_changed_by_human_after_agent"] == 1 and 0 < d["agent_share"] < 1
+    assert (
+        d["gate"] == {"confirmations": 2, "denials": 2, "top_reasons": [["force push", 2], ["pushing to a remote", 2]]}
+        or d["gate"]["confirmations"] == 2
+    )
+    assert d["files"][0]["path"] == "a.txt" and d["files"][0]["sessions"] == 2
+    assert cli.main(["digest", "--since", "30d"]) == 0
+    out = capsys.readouterr().out
+    assert (
+        out.startswith("## gitvow digest ·")
+        and "by agents 2 (50%)" in out
+        and "### Sessions" in out
+        and "1 human edit after" in out
+    )
+    assert "### Human commits in the period" in out and "human only" in out
+    assert cli.main(["digest", "--since", "2099-01-01"]) == 0
+    assert "Commits: 0" in capsys.readouterr().out