drydock-cli 3.0.127__tar.gz → 3.0.128__tar.gz

{drydock_cli-3.0.127/drydock_cli.egg-info → drydock_cli-3.0.128}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drydock-cli
-Version: 3.0.127
+Version: 3.0.128
 Summary: Drydock — a local, provider-agnostic terminal coding agent for local LLMs
 Author: Frank Bobe III
 License-Expression: Apache-2.0

{drydock_cli-3.0.127 → drydock_cli-3.0.128}/drydock/events.py

@@ -66,3 +66,54 @@ def default_event_log_path():
     import time
     from pathlib import Path
     return Path.home() / ".drydock" / "events" / f"session-{int(time.time())}.jsonl"
+
+
+def _events(events_or_path):
+    return events_or_path if isinstance(events_or_path, list) else EventLog.read(events_or_path)
+
+
+def reconstruct_task_state(events_or_path):
+    """Rebuild a TaskState (objective, acceptance criteria, phase) from an event
+    trace — the PRD "a task can be reconstructed from serialized state" / resume.
+    Returns a fresh TaskState (empty if the trace has no task_start)."""
+    from drydock.task_state import TaskState
+    ts = TaskState()
+    for e in _events(events_or_path):
+        t = e.get("type")
+        if t == "task_start":
+            ts.objective = e.get("objective", "") or ts.objective
+            ts.acceptance_criteria = list(e.get("acceptance_criteria", []) or ts.acceptance_criteria)
+        elif t in ("verify_gate", "verification", "done") and e.get("phase"):
+            ts.phase = e.get("phase", ts.phase)
+        elif t == "verify_gate":
+            ts.phase = "repair" if e.get("kind") == "failed" else "verify"
+        elif t == "done":
+            ts.phase = e.get("phase", ts.phase)
+    return ts
+
+
+def summarize(events_or_path) -> dict:
+    """A compact digest of a task's execution trace for inspection/diagnosis."""
+    evs = _events(events_or_path)
+    tools: dict[str, int] = {}
+    turns = in_tok = out_tok = verify_pass = verify_fail = 0
+    phase = "understand"
+    for e in evs:
+        t = e.get("type")
+        if t == "turn":
+            turns += 1; in_tok += e.get("in_tok", 0) or 0; out_tok += e.get("out_tok", 0) or 0
+        elif t == "tool":
+            tools[e.get("name", "?")] = tools.get(e.get("name", "?"), 0) + 1
+        elif t == "verification":
+            if e.get("status") == "pass": verify_pass += 1
+            elif e.get("status") == "fail": verify_fail += 1
+        elif t == "done":
+            phase = e.get("phase", phase)
+    ts = reconstruct_task_state(evs)
+    return {
+        "objective": ts.objective, "acceptance_criteria": ts.acceptance_criteria,
+        "final_phase": phase, "turns": turns, "tools": tools,
+        "in_tok": in_tok, "out_tok": out_tok,
+        "verifications": {"pass": verify_pass, "fail": verify_fail},
+        "event_count": len(evs),
+    }

{drydock_cli-3.0.127 → drydock_cli-3.0.128}/drydock/tui/app.py

@@ -531,6 +531,8 @@ class DrydockApp(App):
             self._cmd_context(arg)
         elif cmd == "/shell":
             self._cmd_shell()
+        elif cmd == "/events":
+            self._cmd_events()
         elif cmd == "/advisor":
             self._cmd_advisor(arg)
         elif cmd == "/ask":
@@ -837,6 +839,27 @@ class DrydockApp(App):
         else:
             self._begin(prompt)
 
+    def _cmd_events(self) -> None:
+        """Show a digest of this session's durable execution trace (event log)."""
+        log = self.state.events
+        if log is None:
+            self._info("Event log is off (config event_log = false).")
+            return
+        from drydock.events import summarize
+        s = summarize(str(log.path))
+        tools = ", ".join(f"{k}×{v}" for k, v in sorted(s["tools"].items())) or "none"
+        v = s["verifications"]
+        lines = [
+            f"Task trace — {log.path}",
+            f"  objective    : {(s['objective'] or '(none yet)')[:80]}",
+            f"  criteria     : {len(s['acceptance_criteria'])}",
+            f"  phase        : {s['final_phase']}",
+            f"  turns        : {s['turns']}   tools: {tools}",
+            f"  verifications: {v['pass']} passed, {v['fail']} failed",
+            f"  tokens       : {s['in_tok']:,} in / {s['out_tok']:,} out   ({s['event_count']} events)",
+        ]
+        self._info("\n".join(lines))
+
     def _cmd_shell(self) -> None:
         """Show exactly which shell the Bash tool runs commands through, plus the
         platform signals — so a 'still using bash on Windows' report is instantly

{drydock_cli-3.0.127 → drydock_cli-3.0.128}/drydock/tui/widgets.py

@@ -153,7 +153,7 @@ class PromptHistory:
 # completes the prefix.
 SLASH_COMMANDS = [
     "/help", "/model", "/cwd", "/undo", "/back", "/stop", "/status",
-    "/compact", "/context", "/shell", "/advisor", "/ask", "/ask!", "/graphrag", "/skills",
+    "/compact", "/context", "/shell", "/events", "/advisor", "/ask", "/ask!", "/graphrag", "/skills",
     "/loop", "/mcp", "/rmf", "/stig",
     "/clear", "/quit",
 ]

{drydock_cli-3.0.127 → drydock_cli-3.0.128/drydock_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drydock-cli
-Version: 3.0.127
+Version: 3.0.128
 Summary: Drydock — a local, provider-agnostic terminal coding agent for local LLMs
 Author: Frank Bobe III
 License-Expression: Apache-2.0

{drydock_cli-3.0.127 → drydock_cli-3.0.128}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 # PyPI distribution name is drydock-cli (the established install name, continued
 # from the retired v2 fork); the import package + CLI command stay `drydock`.
 name = "drydock-cli"
-version = "3.0.127"
+version = "3.0.128"
 description = "Drydock — a local, provider-agnostic terminal coding agent for local LLMs"
 readme = "README.md"
 requires-python = ">=3.11"

{drydock_cli-3.0.127 → drydock_cli-3.0.128}/tests/test_events.py

@@ -56,3 +56,36 @@ def test_run_writes_full_trace():
 def test_disabled_no_events_attr():
     st = agent.AgentState()
     assert st.events is None  # off by default on a bare AgentState
+
+
+def test_reconstruct_task_state_from_trace():
+    from drydock.events import EventLog, reconstruct_task_state
+    p = os.path.join(tempfile.mkdtemp(), "r.jsonl")
+    log = EventLog(p)
+    log.emit("task_start", objective="Recover the password", acceptance_criteria=["23 chars", "write out.txt"])
+    log.emit("tool", name="Write")
+    log.emit("done", phase="complete")
+    ts = reconstruct_task_state(p)
+    assert ts.objective == "Recover the password"
+    assert ts.acceptance_criteria == ["23 chars", "write out.txt"]
+    assert ts.phase == "complete"
+
+
+def test_summarize_digest():
+    from drydock.events import EventLog, summarize
+    p = os.path.join(tempfile.mkdtemp(), "s.jsonl")
+    log = EventLog(p)
+    log.emit("task_start", objective="do X", acceptance_criteria=["a"])
+    log.emit("turn", in_tok=100, out_tok=50)
+    log.emit("tool", name="Bash"); log.emit("tool", name="Bash")
+    log.emit("verification", status="fail"); log.emit("verification", status="pass")
+    log.emit("done", phase="complete")
+    s = summarize(p)
+    assert s["turns"] == 1 and s["tools"] == {"Bash": 2}
+    assert s["verifications"] == {"pass": 1, "fail": 1} and s["final_phase"] == "complete"
+    assert s["in_tok"] == 100 and s["out_tok"] == 50
+
+
+def test_reconstruct_empty_trace():
+    from drydock.events import reconstruct_task_state
+    assert reconstruct_task_state([]).objective == ""