@backburner/cli 0.1.8 → 0.1.9

package/README.md

@@ -4,6 +4,37 @@ Backburner turns GitHub issues into reviewable pull requests using coding agents
 
 Open an issue from your phone, get back to your day, and manage the work through GitHub comments, labels, and PR reviews. Your computer does the planning, coding, testing, committing, and pushing through the agent CLIs and credentials you already use. GitHub is the control plane; your computer is the worker.
 
+## From phone to pull request
+
+Follow work from the GitHub mobile app while Backburner runs the agent workflow on your machine:
+
+<table>
+  <tr>
+    <td align="center" width="50%">
+      <strong>1. Open an issue from your phone</strong>
+      <br />
+      <img src="docs/images/workflow-story/01-issue.jpg" alt="A GitHub issue describing OAuth support for hosted MCP" />
+    </td>
+    <td align="center" width="50%">
+      <strong>2. Review the product direction</strong>
+      <br />
+      <img src="docs/images/workflow-story/02-product-discovery.jpg" alt="An agent posts product discovery analysis on the GitHub issue" />
+    </td>
+  </tr>
+  <tr>
+    <td align="center" width="50%">
+      <strong>3. Approve the implementation plan</strong>
+      <br />
+      <img src="docs/images/workflow-story/03-plan-pr.jpg" alt="Backburner creates a planning pull request with product spec and plan documents" />
+    </td>
+    <td align="center" width="50%">
+      <strong>4. Review the completed work</strong>
+      <br />
+      <img src="docs/images/workflow-story/04-reviewed-change.jpg" alt="The implemented change is reviewed and ready for a human merge" />
+    </td>
+  </tr>
+</table>
+
 ## How it works
 
 1. You open an issue in a repository managed by Backburner.

package/dist/src/cli/commands/run.js

@@ -746,6 +746,9 @@ export async function runCli(argv, options = {}) {
             if (retrospectiveDerivation.tasks.length > 0 || finalSkipContextHydration.changed) {
                 await stateStore.writeTaskState(finalTasksToDispatch);
             }
+            // Workspace recovery already ran before the initial dispatch. Deferring
+            // further recovery until the next outer run preserves completed task
+            // handoffs produced earlier in this run.
             dispatchResult = await runDispatchWithMergePrepLifecycle({
                 tasks: finalTasksToDispatch,
                 worktrees: projectionAwareTriageWorktrees,
@@ -779,6 +782,7 @@ export async function runCli(argv, options = {}) {
                 commandRunner,
                 gitGateway,
                 workspaceRecoveryService,
+                skipWorkspaceRecovery: true,
                 agentPool
             });
             // Journal new executions (dedup via executionIdsBeforeCycle)

package/dist/src/cli/runtime/dispatch-lifecycle.js

@@ -298,7 +298,10 @@ export async function runDispatchWithMergePrepLifecycle(input) {
         await stateStore.writeTaskState(hydratedInputTasks);
     }
     // ── Phase 0: Recover workspaces of failed workspace-write tasks ─────────────
+    // This phase is intentionally skipped for follow-up dispatches in the same
+    // outer run so a failed sibling cannot erase a completed task's handoff.
     const seenRecoveryPaths = new Set();
+    const recoveryResultByPath = new Map();
     const existingRecoveryRecords = await stateStore.loadWorkspaceRecoveryState();
     const recoveryRecords = [...existingRecoveryRecords];
     let recoveryStateChanged = false;
@@ -311,11 +314,20 @@ export async function runDispatchWithMergePrepLifecycle(input) {
     };
     const recoveryResultByTaskId = new Map();
     for (const task of hydratedInputTasks) {
-        if (!workspaceRecoveryService.isRecoveryNeeded(task)) {
+        if (input.skipWorkspaceRecovery || !workspaceRecoveryService.isRecoveryNeeded(task)) {
             continue;
         }
         const localPath = workspaceRecoveryService.resolveTaskWorkspacePath(task);
         if (localPath && seenRecoveryPaths.has(localPath)) {
+            const sharedRecoveryResult = recoveryResultByPath.get(localPath);
+            if (sharedRecoveryResult) {
+                recoveryResultByTaskId.set(task.id, sharedRecoveryResult);
+                if (sharedRecoveryResult.outcome === "recovered" ||
+                    sharedRecoveryResult.outcome === "skipped") {
+                    task.context.recoveryNeeded = false;
+                    taskStateChangedByRecovery = true;
+                }
+            }
             continue;
         }
         if (localPath) {
@@ -329,6 +341,9 @@ export async function runDispatchWithMergePrepLifecycle(input) {
         counts[recoveryResult.outcome]++;
         recoveryRecords.push(recoveryResult);
         recoveryResultByTaskId.set(task.id, recoveryResult);
+        if (localPath) {
+            recoveryResultByPath.set(localPath, recoveryResult);
+        }
         recoveryStateChanged = true;
         if (recoveryResult.outcome === "recovered" || recoveryResult.outcome === "skipped") {
             task.context.recoveryNeeded = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backburner/cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "type": "module",
   "description": "Local GitHub-based agent orchestration CLI",
   "license": "MIT",