From bbee8a3eb3fe3a1c0ec1803ec286abf4e2e1ed0c Mon Sep 17 00:00:00 2001
From: Fabro <noreply@fabro.sh>
Date: Thu, 19 Mar 2026 21:01:25 -0400
Subject: [PATCH] checkpoint
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

⚒️ Generated with [Fabro](https://fabro.sh)
---
 checkpoint.json                        | 52 ++++++++++++++++++++++++++
 nodes/start/status.json                |  6 +++
 nodes/toolchain/script_invocation.json |  5 +++
 nodes/toolchain/script_timing.json     |  5 +++
 nodes/toolchain/status.json            |  6 +++
 5 files changed, 74 insertions(+)
 create mode 100644 checkpoint.json
 create mode 100644 nodes/start/status.json
 create mode 100644 nodes/toolchain/script_invocation.json
 create mode 100644 nodes/toolchain/script_timing.json
 create mode 100644 nodes/toolchain/status.json

diff --git a/checkpoint.json b/checkpoint.json
new file mode 100644
index 000000000..5af01c6b1
--- /dev/null
+++ b/checkpoint.json
@@ -0,0 +1,52 @@
+{
+  "timestamp": "2026-03-20T01:01:25.071845Z",
+  "current_node": "toolchain",
+  "completed_nodes": [
+    "start",
+    "toolchain"
+  ],
+  "node_retries": {
+    "start": 1,
+    "toolchain": 1
+  },
+  "context_values": {
+    "internal.thread_id": "start",
+    "internal.node_visit_count": 1,
+    "outcome": "success",
+    "failure_signature": "",
+    "command.output": "cargo 1.94.0 (85eff7c80 2026-01-15)\n",
+    "internal.retry_count.start": 1,
+    "internal.run_id": "01KM4C5NR7A6KVFNK6DDE3FP4R",
+    "failure_class": "",
+    "graph.model_stylesheet": "\n            * { backend: api; model: claude-opus-4-6;}\n        ",
+    "current.preamble": "Goal: # Emit `StageStarted` on retry attempts\n\n## Context\n\nWhen a stage fails with a transient error and is retried, the CLI progress UI freezes because:\n\n1. `StageFailed` calls `finish_stage()`, removing the stage from `active_stages`\n2. The retry loop in the engine (`continue` at line 1198) re-enters handler execution **without emitting `StageStarted`**\n3. All subsequent agent events for the retry attempt silently drop (no matching entry in `active_stages`)\n\nThe `StageStarted` event already has `attempt` and `max_attempts` fields, so emitting it per-attempt is the intended design — it just wasn't wired up.\n\n## Changes\n\n### 1. Engine: emit `StageStarted` at the top of the retry loop\n\n**File:** `lib/crates/fabro-workflows/src/engine.rs`\n\nMove the `StageStarted` emission from before the loop (line 1852) to inside the loop, right after `for attempt in 1..=policy.max_attempts {` (line 1079). This way every attempt — including retries — emits the event with the correct `attempt` number.\n\nThe existing emission at line 1852 gets replaced, not duplicated. The `attempt` value comes directly from the loop variable (converted via `usize::try_from`).\n\n### 2. Engine: move StageStart hook inside the loop (or keep it outside)\n\nThe `StageStart` hook block (lines 1862-1895) currently runs once before the loop. It should stay outside — hooks shouldn't re-fire on retries. Only the `StageStarted` event emission moves inside.\n\n### 3. UI: no changes needed\n\n`on_stage_started` in `run_progress.rs` already handles being called for the same `node_id` — it inserts a fresh `ActiveStage` into the map, creating a new spinner. The `StageFailed` handler correctly finishes the old spinner. The natural event sequence becomes:\n\n```\nStageStarted  (attempt 1) → spinner created\nStageFailed   (will_retry) → spinner finished with ✗\nStageStarted  (attempt 2) → new spinner created\nAgent events  → attach to new spinner\nStageCompleted (attempt 2) → spinner finished with ✓\n```\n\n## Verification\n\n1. `cargo test -p fabro-workflows` — existing tests pass\n2. `cargo clippy --workspace -- -D warnings` — no warnings\n3. Manual: run a workflow that hits a transient LLM error (or mock one) and verify the CLI shows the retry spinner with tool calls\n\n",
+    "graph.goal": "# Emit `StageStarted` on retry attempts\n\n## Context\n\nWhen a stage fails with a transient error and is retried, the CLI progress UI freezes because:\n\n1. `StageFailed` calls `finish_stage()`, removing the stage from `active_stages`\n2. The retry loop in the engine (`continue` at line 1198) re-enters handler execution **without emitting `StageStarted`**\n3. All subsequent agent events for the retry attempt silently drop (no matching entry in `active_stages`)\n\nThe `StageStarted` event already has `attempt` and `max_attempts` fields, so emitting it per-attempt is the intended design — it just wasn't wired up.\n\n## Changes\n\n### 1. Engine: emit `StageStarted` at the top of the retry loop\n\n**File:** `lib/crates/fabro-workflows/src/engine.rs`\n\nMove the `StageStarted` emission from before the loop (line 1852) to inside the loop, right after `for attempt in 1..=policy.max_attempts {` (line 1079). This way every attempt — including retries — emits the event with the correct `attempt` number.\n\nThe existing emission at line 1852 gets replaced, not duplicated. The `attempt` value comes directly from the loop variable (converted via `usize::try_from`).\n\n### 2. Engine: move StageStart hook inside the loop (or keep it outside)\n\nThe `StageStart` hook block (lines 1862-1895) currently runs once before the loop. It should stay outside — hooks shouldn't re-fire on retries. Only the `StageStarted` event emission moves inside.\n\n### 3. UI: no changes needed\n\n`on_stage_started` in `run_progress.rs` already handles being called for the same `node_id` — it inserts a fresh `ActiveStage` into the map, creating a new spinner. The `StageFailed` handler correctly finishes the old spinner. The natural event sequence becomes:\n\n```\nStageStarted  (attempt 1) → spinner created\nStageFailed   (will_retry) → spinner finished with ✗\nStageStarted  (attempt 2) → new spinner created\nAgent events  → attach to new spinner\nStageCompleted (attempt 2) → spinner finished with ✓\n```\n\n## Verification\n\n1. `cargo test -p fabro-workflows` — existing tests pass\n2. `cargo clippy --workspace -- -D warnings` — no warnings\n3. Manual: run a workflow that hits a transient LLM error (or mock one) and verify the CLI shows the retry spinner with tool calls\n",
+    "internal.retry_count.toolchain": 1,
+    "command.stderr": "",
+    "thread.start.current_node": "toolchain",
+    "current_node": "toolchain",
+    "graph.rankdir": "LR",
+    "internal.fidelity": "compact"
+  },
+  "logs": [],
+  "node_outcomes": {
+    "start": {
+      "status": "success",
+      "duration_ms": 0
+    },
+    "toolchain": {
+      "status": "success",
+      "context_updates": {
+        "command.output": "cargo 1.94.0 (85eff7c80 2026-01-15)\n",
+        "command.stderr": ""
+      },
+      "notes": "Script completed: command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1",
+      "duration_ms": 147
+    }
+  },
+  "next_node_id": "preflight_compile",
+  "node_visits": {
+    "start": 1,
+    "toolchain": 1
+  }
+}
\ No newline at end of file
diff --git a/nodes/start/status.json b/nodes/start/status.json
new file mode 100644
index 000000000..26da00686
--- /dev/null
+++ b/nodes/start/status.json
@@ -0,0 +1,6 @@
+{
+  "status": "success",
+  "notes": null,
+  "failure_reason": null,
+  "timestamp": "2026-03-20T01:01:24.913644+00:00"
+}
\ No newline at end of file
diff --git a/nodes/toolchain/script_invocation.json b/nodes/toolchain/script_invocation.json
new file mode 100644
index 000000000..d68c414c4
--- /dev/null
+++ b/nodes/toolchain/script_invocation.json
@@ -0,0 +1,5 @@
+{
+  "command": "command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1",
+  "language": "shell",
+  "timeout_ms": null
+}
\ No newline at end of file
diff --git a/nodes/toolchain/script_timing.json b/nodes/toolchain/script_timing.json
new file mode 100644
index 000000000..d0143be41
--- /dev/null
+++ b/nodes/toolchain/script_timing.json
@@ -0,0 +1,5 @@
+{
+  "duration_ms": 146,
+  "exit_code": 0,
+  "timed_out": false
+}
\ No newline at end of file
diff --git a/nodes/toolchain/status.json b/nodes/toolchain/status.json
new file mode 100644
index 000000000..0d4d391c1
--- /dev/null
+++ b/nodes/toolchain/status.json
@@ -0,0 +1,6 @@
+{
+  "status": "success",
+  "notes": "Script completed: command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1",
+  "failure_reason": null,
+  "timestamp": "2026-03-20T01:01:25.071491+00:00"
+}
\ No newline at end of file