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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drydock-cli
-Version: 3.0.127
+Version: 3.0.129
 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.129}/drydock/agent.py

@@ -389,6 +389,8 @@ def run(
         for tc in assistant_turn.tool_calls:
             tool_call_count += 1
             if tc["name"] in ("Edit", "Write"):
+                if not session_has_edited and state.task.phase in ("understand", "discover", "plan"):
+                    state.task.phase = "implement"  # first change → building
                 session_has_edited = True
 
             # STOP pressed: don't run the remaining tools, but still record a

{drydock_cli-3.0.127 → drydock_cli-3.0.129}/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.129}/drydock/tui/app.py

@@ -362,8 +362,11 @@ class DrydockApp(App):
         flag = "⚓ working" if self._busy else "⚓ ready"
         # Busy → show the interrupt keys; idle → the quit hint.
         keys = "Esc/Ctrl+C stop" if self._busy else "Ctrl+C×2 quit"
+        # Show the task phase once it's past the default (understand).
+        ph = getattr(self.state, "task", None)
+        phase = f"  ·  {ph.phase}" if (ph and ph.is_set() and ph.phase != "understand") else ""
         return (
-            f"{flag}  ·  {model}  ·  {keys} · PgUp/PgDn scroll · "
+            f"{flag}  ·  {model}{phase}  ·  {keys} · PgUp/PgDn scroll · "
             f"Ctrl+O details  ·  {ctx}"
         )
 
@@ -531,6 +534,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 +842,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.129}/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.129/drydock_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drydock-cli
-Version: 3.0.127
+Version: 3.0.129
 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.129}/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.129"
 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.129}/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 == ""

{drydock_cli-3.0.127 → drydock_cli-3.0.129}/tests/test_task_state.py

@@ -67,3 +67,25 @@ def test_disabled_when_task_anchor_false():
     cfg = {"model": "gemma4", "max_tokens": 8192, "context_limit": 65536, "task_anchor": False}
     sysp, _ = _run_capture(cfg, "Do the thing.\n1. a criterion")
     assert "TASK" not in sysp
+
+
+def test_phase_transitions_understand_implement_complete():
+    from drydock.providers import AssistantTurn
+    cfg = {"model": "gemma4", "max_tokens": 8192, "context_limit": 65536}
+    turns = [
+        AssistantTurn("", [{"id": "1", "name": "Write",
+                            "input": {"file_path": "/tmp/dd_ph.txt", "content": "x"}}], 5, 5),
+        AssistantTurn("", [{"id": "2", "name": "Bash", "input": {"command": "python -c 'print(1)'"}}], 5, 5),
+        AssistantTurn("done, verified", [], 5, 5),
+    ]
+    i = {"n": 0}
+    def fake(model, system, messages, tool_schemas, config):
+        t = turns[min(i["n"], len(turns) - 1)]; i["n"] += 1; yield t
+    st = agent.AgentState()
+    assert st.task.phase == "understand"
+    orig = agent.stream; agent.stream = fake
+    try:
+        list(agent.run("Fix it and verify.\n1. tests pass", st, cfg, "SYS"))
+    finally:
+        agent.stream = orig
+    assert st.task.phase == "complete"   # understand -> implement -> verify -> complete