@gethmy/agent 1.7.3 → 1.8.1

package/dist/index.js

@@ -1162,6 +1162,7 @@ class MergeMonitor {
   running = false;
   provider;
   cwd;
+  onCardCompleted = null;
   constructor(client, projectId, config, intervalMs = 60000) {
     this.client = client;
     this.projectId = projectId;
@@ -1282,6 +1283,13 @@ class MergeMonitor {
         log.info(TAG7, `Deleted local branch ${branchName}`);
       } catch {}
     }
+    if (this.onCardCompleted) {
+      try {
+        await this.onCardCompleted(card);
+      } catch (err) {
+        log.warn(TAG7, `successor promotion failed for #${card.short_id}: ${err instanceof Error ? err.message : err}`);
+      }
+    }
     log.info(TAG7, `#${card.short_id} completed (merged)`);
   }
 }
@@ -2028,7 +2036,7 @@ function buildTokenPayload(stats) {
     modelName: stats.cost.modelName
   };
 }
-async function runCompletion(client, card, branchName, worktreePath, config, workerId, sessionStats, workspaceId, agentSessionId, stateStore) {
+async function runCompletion(client, card, branchName, worktreePath, config, workerId, sessionStats, workspaceId, agentSessionId, stateStore, onMovedToCompletion) {
   let verificationResult = {
     passed: true,
     buildErrors: [],
@@ -2137,6 +2145,13 @@ async function runCompletion(client, card, branchName, worktreePath, config, wor
   }
   if (config.completion.moveToColumn) {
     await moveCardToColumn(client, card, config.completion.moveToColumn);
+    if (onMovedToCompletion) {
+      try {
+        await onMovedToCompletion(card);
+      } catch (err) {
+        log.warn(TAG12, `successor promotion failed for #${card.short_id}: ${err instanceof Error ? err.message : err}`);
+      }
+    }
   }
   if (config.completion.postSummary) {
     await postSummary(client, card, branchName, worktreePath, prUrl, config.worktree.baseBranch, sessionStats);
@@ -3739,6 +3754,7 @@ class ReviewWorker {
   progressTracker = null;
   lastSessionStats = null;
   aborted = false;
+  timedOut = false;
   runId = null;
   lastRunLogPath = null;
   sessionId = null;
@@ -3794,6 +3810,7 @@ class ReviewWorker {
   }
   async run(card, column, labels, subtasks) {
     this.aborted = false;
+    this.timedOut = false;
     this.cardId = card.id;
     this.startedAt = Date.now();
     this.runId = newRunId();
@@ -3931,6 +3948,7 @@ class ReviewWorker {
       });
       this.timeoutTimer = setTimeout(() => {
         log.warn(this.tag, `Review timeout reached (${this.config.review.maxTimeout}ms), cancelling`);
+        this.timedOut = true;
         this.cancel();
       }, this.config.review.maxTimeout);
       this.progressTracker = new ProgressTracker(this.client, card.id, this.id, subtasks);
@@ -3997,7 +4015,7 @@ class ReviewWorker {
         try {
           const run = this.stateStore.getRun(this.runId);
           if (run && run.endedAt === null) {
-            const status = this.state === "error" || this.aborted ? "paused" : "completed";
+            const status = this.timedOut ? "failed" : this.state === "error" || this.aborted ? "paused" : "completed";
             await this.stateStore.endRun(this.runId, status);
           }
         } catch {}
@@ -4035,6 +4053,7 @@ class ReviewWorker {
     signalGroup(this.process, "SIGCONT");
     this.timeoutTimer = setTimeout(() => {
       log.warn(this.tag, `Timeout reached (${this.config.review.maxTimeout}ms), cancelling`);
+      this.timedOut = true;
       this.cancel();
     }, this.config.review.maxTimeout);
     if (this.cardId) {
@@ -4070,7 +4089,11 @@ class ReviewWorker {
     if (this.cardId) {
       try {
         await this.client.endAgentSession(this.cardId, {
-          status: "paused",
+          status: this.timedOut ? "failed" : "paused",
+          ...this.timedOut ? {
+            failureReason: "timeout",
+            failureSummary: `Review exceeded the ${Math.round(this.config.review.maxTimeout / 60000)} min timeout`
+          } : {},
           ...buildTokenPayload(snapshotStats)
         });
       } catch {}
@@ -4248,9 +4271,127 @@ var init_review_worker = __esm(() => {
   init_worktree();
 });
 
+// src/sleep-guard.ts
+import { spawn as spawn3 } from "node:child_process";
+
+class SleepGuard {
+  platform;
+  child = null;
+  holds = 0;
+  constructor(platform = process.platform) {
+    this.platform = platform;
+  }
+  get active() {
+    return this.child !== null;
+  }
+  acquire() {
+    this.holds++;
+    if (this.holds === 1)
+      this.start();
+  }
+  release() {
+    this.holds = Math.max(0, this.holds - 1);
+    if (this.holds === 0)
+      this.stop();
+  }
+  stop() {
+    this.holds = 0;
+    if (this.child) {
+      if (!this.child.killed)
+        this.child.kill("SIGTERM");
+      this.child = null;
+      log.info(TAG20, "sleep assertion released");
+    }
+  }
+  start() {
+    if (this.platform !== "darwin" || this.child)
+      return;
+    try {
+      const child = spawn3("caffeinate", ["-i", "-w", String(process.pid)], {
+        stdio: "ignore"
+      });
+      child.on("error", (err) => {
+        log.warn(TAG20, `caffeinate unavailable: ${err.message}`);
+        if (this.child === child)
+          this.child = null;
+      });
+      child.on("exit", () => {
+        if (this.child === child)
+          this.child = null;
+      });
+      child.unref();
+      this.child = child;
+      log.info(TAG20, "sleep assertion acquired (caffeinate -i)");
+    } catch (err) {
+      log.warn(TAG20, `failed to spawn caffeinate: ${err instanceof Error ? err.message : err}`);
+    }
+  }
+}
+var TAG20 = "sleep-guard";
+var init_sleep_guard = __esm(() => {
+  init_log();
+});
+
+// src/unblock.ts
+async function fetchBlocksLinks(client, cardId) {
+  try {
+    const { links } = await client.getCardLinks(cardId);
+    return links.filter((l) => l.link_type === "blocks");
+  } catch (err) {
+    log.warn(TAG21, `link fetch failed for ${cardId}: ${err instanceof Error ? err.message : err}`);
+    return null;
+  }
+}
+function isBlockerResolved(blocker, columns) {
+  if (blocker.done)
+    return true;
+  const blockerColumn = columns.find((c) => c.id === blocker.column_id);
+  return blockerColumn?.mark_cards_done === true;
+}
+async function getUnresolvedBlockers(client, card, projectId) {
+  const links = await fetchBlocksLinks(client, card.id);
+  if (!links)
+    return null;
+  const incoming = links.filter((l) => l.direction === "incoming");
+  if (incoming.length === 0)
+    return [];
+  const board = await client.getBoard(projectId, { summary: true });
+  const columns = board.columns ?? [];
+  return incoming.filter((l) => !isBlockerResolved(l.target_card, columns)).map((l) => ({
+    cardId: l.target_card.id,
+    shortId: l.target_card.short_id,
+    title: l.target_card.title
+  }));
+}
+async function promoteUnblockedSuccessors(completedCard, deps) {
+  const links = await fetchBlocksLinks(deps.client, completedCard.id);
+  if (!links)
+    return;
+  const successors = links.filter((l) => l.direction === "outgoing" && !l.target_card.done);
+  if (successors.length === 0)
+    return;
+  log.info(TAG21, `#${completedCard.short_id} completed — checking ${successors.length} chained successor(s)`);
+  for (const link of successors) {
+    const successorId = link.target_card.id;
+    try {
+      const { card } = await deps.client.getCard(successorId);
+      if (card.assignee_id !== deps.agentUserId) {
+        log.debug(TAG21, `successor #${card.short_id} not assigned to agent — skipping promotion`);
+        continue;
+      }
+      await deps.enqueue(successorId);
+    } catch (err) {
+      log.warn(TAG21, `promotion failed for successor ${successorId}: ${err instanceof Error ? err.message : err}`);
+    }
+  }
+}
+var TAG21 = "unblock";
+var init_unblock = __esm(() => {
+  init_log();
+});
+
 // ../harmony-shared/dist/cardLinks.js
 var init_cardLinks = () => {};
-
 // ../harmony-shared/dist/commentSerializer.js
 function sanitizeHeaderField(value) {
   return value.replace(/[\]\r\n|<>]/g, " ").trim() || "—";
@@ -4388,11 +4529,11 @@ async function buildPrompt(enriched, branchName, worktreePath, client, workspace
 Do NOT push to main. All your work stays on \`${branchName}\`.
 When finished, call harmony_end_agent_session with status="completed".`
     });
-    log.info(TAG20, `Generated prompt for #${card.short_id} — ${result.contextSummary.memoryCount} memories, ${result.tokenEstimate} tokens`);
+    log.info(TAG22, `Generated prompt for #${card.short_id} — ${result.contextSummary.memoryCount} memories, ${result.tokenEstimate} tokens`);
     return result.prompt + pastEpisodesSection;
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    log.warn(TAG20, `Failed to generate prompt via API, using fallback: ${msg}`);
+    log.warn(TAG22, `Failed to generate prompt via API, using fallback: ${msg}`);
     const commentsSection = await renderCommentsSection(client, card.id);
     return buildFallbackPrompt(enriched, branchName, worktreePath) + commentsSection + pastEpisodesSection;
   }
@@ -4410,7 +4551,7 @@ async function renderCommentsSection(client, cardId) {
 
 ${section}` : "";
   } catch (err) {
-    log.warn(TAG20, "comment-thread fetch failed", {
+    log.warn(TAG22, "comment-thread fetch failed", {
       event: "comment_fetch_failed",
       error: err instanceof Error ? err.message : String(err)
     });
@@ -4460,7 +4601,7 @@ ${description}`.trim();
 ## Similar past tasks
 ${bullets}`;
   } catch (err) {
-    log.warn(TAG20, "past-episodes recall failed", {
+    log.warn(TAG22, "past-episodes recall failed", {
       event: "episode_recall_failed",
       error: err instanceof Error ? err.message : String(err)
     });
@@ -4501,7 +4642,7 @@ ${subtaskStr}
 You are working in a git worktree at \`${worktreePath}\` on branch \`${branchName}\`.
 Do NOT push to main. All your work stays on \`${branchName}\`.`;
 }
-var TAG20 = "prompt";
+var TAG22 = "prompt";
 var init_prompt = __esm(() => {
   init_dist();
   init_log();
@@ -4515,6 +4656,7 @@ class Worker {
   workspaceId;
   projectId;
   stateStore;
+  onCardCompleted;
   id;
   state = "idle";
   cardId = null;
@@ -4527,16 +4669,18 @@ class Worker {
   progressTracker = null;
   lastSessionStats;
   aborted = false;
+  timedOut = false;
   verificationFailed = false;
   sessionId = null;
   runId = null;
-  constructor(id, config, client, _userEmail, onDone, workspaceId, projectId, stateStore) {
+  constructor(id, config, client, _userEmail, onDone, workspaceId, projectId, stateStore, onCardCompleted) {
     this.config = config;
     this.client = client;
     this.onDone = onDone;
     this.workspaceId = workspaceId;
     this.projectId = projectId;
     this.stateStore = stateStore;
+    this.onCardCompleted = onCardCompleted;
     this.id = id;
   }
   startHeartbeat() {
@@ -4571,7 +4715,7 @@ class Worker {
     }
   }
   get tag() {
-    return `${TAG21}:${this.id}`;
+    return `${TAG23}:${this.id}`;
   }
   get isIdle() {
     return this.state === "idle";
@@ -4581,6 +4725,7 @@ class Worker {
   }
   async run(card, column, labels, subtasks) {
     this.aborted = false;
+    this.timedOut = false;
     this.verificationFailed = false;
     this.cardId = card.id;
     this.startedAt = Date.now();
@@ -4617,7 +4762,7 @@ class Worker {
       });
       const sid = session && typeof session === "object" && "id" in session ? session.id : null;
       if (!sid) {
-        log.warn(TAG21, "startAgentSession returned no session id");
+        log.warn(TAG23, "startAgentSession returned no session id");
       }
       this.sessionId = sid;
       await this.recordPhase("preparing");
@@ -4649,6 +4794,7 @@ class Worker {
       });
       this.timeoutTimer = setTimeout(() => {
         log.warn(this.tag, `Timeout reached (${this.config.maxTimeout}ms), cancelling`);
+        this.timedOut = true;
         this.cancel();
       }, this.config.maxTimeout);
       await this.spawnClaude(prompt, card, subtasks);
@@ -4666,7 +4812,7 @@ class Worker {
       });
       this.state = "completing";
       await this.recordPhase("completing");
-      const completed = await runCompletion(this.client, card, this.branchName, this.worktreePath, this.config, this.id, this.lastSessionStats, this.workspaceId, this.sessionId, this.stateStore);
+      const completed = await runCompletion(this.client, card, this.branchName, this.worktreePath, this.config, this.id, this.lastSessionStats, this.workspaceId, this.sessionId, this.stateStore, this.onCardCompleted);
       this.verificationFailed = !completed;
     } catch (err) {
       this.state = "error";
@@ -4695,6 +4841,24 @@ class Worker {
           await this.stateStore.endRun(this.runId, "completed");
         } catch {}
         await this.recordOutcome(card.id, "success");
+      } else if (this.runId && this.timedOut) {
+        try {
+          await runTransition(this.client, card, {
+            move: { columnName: this.config.pickupColumns[0] ?? "To Do" },
+            endSession: {
+              status: "failed",
+              failureReason: "timeout",
+              failureSummary: `Run exceeded the ${Math.round(this.config.maxTimeout / 60000)} min timeout`,
+              ...buildTokenPayload(this.lastSessionStats)
+            }
+          });
+        } catch (tErr) {
+          log.error(this.tag, `timeout transition failed on #${card.short_id}: ${tErr instanceof TransitionError ? tErr.detail : tErr}`);
+        }
+        try {
+          await this.stateStore.endRun(this.runId, "failed", "timeout");
+        } catch {}
+        await this.recordOutcome(card.id, "failure");
       } else if (this.runId && this.aborted) {
         try {
           await this.stateStore.endRun(this.runId, "paused", "cancelled");
@@ -4765,6 +4929,7 @@ class Worker {
     signalGroup(this.process, "SIGCONT");
     this.timeoutTimer = setTimeout(() => {
       log.warn(this.tag, `Timeout reached (${this.config.maxTimeout}ms), cancelling`);
+      this.timedOut = true;
       this.cancel();
     }, this.config.maxTimeout);
     if (this.cardId) {
@@ -4791,7 +4956,7 @@ class Worker {
         sigtermTimeoutMs: CANCEL_SIGTERM_TIMEOUT2
       });
     }
-    if (this.cardId) {
+    if (this.cardId && !this.timedOut) {
       try {
         const stats = this.lastSessionStats ?? this.progressTracker?.stats;
         await this.client.endAgentSession(this.cardId, {
@@ -4895,7 +5060,7 @@ class Worker {
       clearTimeout(this.timeoutTimer);
       this.timeoutTimer = null;
     }
-    if (this.worktreePath && this.state === "error") {
+    if (this.worktreePath && (this.state === "error" || this.timedOut)) {
       try {
         cleanupWorktree(this.worktreePath, this.branchName ?? undefined);
       } catch {
@@ -4911,7 +5076,7 @@ class Worker {
     this.sessionId = null;
   }
 }
-var TAG21 = "worker", CANCEL_SIGINT_TIMEOUT2 = 30000, CANCEL_SIGTERM_TIMEOUT2 = 1e4;
+var TAG23 = "worker", CANCEL_SIGINT_TIMEOUT2 = 30000, CANCEL_SIGTERM_TIMEOUT2 = 1e4;
 var init_worker = __esm(() => {
   init_board_helpers();
   init_completion();
@@ -4930,14 +5095,18 @@ var init_worker = __esm(() => {
 // src/pool.ts
 class Pool {
   client;
+  projectId;
   stateStore;
   implWorkers = [];
   reviewWorkers = [];
   implQueue;
   reviewQueue;
   budget;
+  sleepGuard = new SleepGuard;
+  onCardCompleted = null;
   constructor(config, client, userEmail, workspaceId, projectId, stateStore) {
     this.client = client;
+    this.projectId = projectId;
     this.stateStore = stateStore;
     this.implQueue = new PriorityQueue(config);
     this.reviewQueue = new PriorityQueue(config);
@@ -4945,33 +5114,48 @@ class Pool {
     for (let i = 0;i < config.poolSize; i++) {
       this.implWorkers.push(new Worker(i, config, client, userEmail, () => {
         this.tryDispatchFor(this.implWorkers, this.implQueue, "impl");
-      }, workspaceId, projectId, stateStore));
+        this.sleepGuard.release();
+      }, workspaceId, projectId, stateStore, async (completedCard) => {
+        await this.onCardCompleted?.(completedCard);
+      }));
     }
     if (config.review.enabled) {
       for (let i = 0;i < config.review.poolSize; i++) {
         const reviewWorkerId = config.poolSize + i;
         this.reviewWorkers.push(new ReviewWorker(reviewWorkerId, config, client, userEmail, () => {
           this.tryDispatchFor(this.reviewWorkers, this.reviewQueue, "review");
+          this.sleepGuard.release();
         }, stateStore, workspaceId, projectId));
       }
     }
   }
   async enqueue(card, column, labels, subtasks, mode = "implement") {
     if (this.implQueue.has(card.id) || this.reviewQueue.has(card.id) || this.isCardActive(card.id)) {
-      log.debug(TAG22, `Card ${card.id} already queued or active, skipping`);
+      log.debug(TAG24, `Card ${card.id} already queued or active, skipping`);
       return;
     }
     if (mode === "implement") {
       const decision = this.budget.check(card.id);
       if (!decision.allow) {
         if (decision.reason === "daily_budget") {
-          log.warn(TAG22, `#${card.short_id} skipped (daily_budget): ${decision.detail}`);
+          log.warn(TAG24, `#${card.short_id} skipped (daily_budget): ${decision.detail}`);
           await this.emitWaiting(card.id, `Daily budget reached — waiting for reset (${decision.detail})`);
         } else {
-          log.debug(TAG22, `#${card.short_id} gave up: ${decision.detail}`);
+          log.debug(TAG24, `#${card.short_id} gave up: ${decision.detail}`);
         }
         return;
       }
+      const blockers = await getUnresolvedBlockers(this.client, card, this.projectId);
+      if (blockers === null) {
+        log.warn(TAG24, `#${card.short_id} blocker check failed — deferring to next tick`);
+        return;
+      }
+      if (blockers.length > 0) {
+        const list = blockers.map((b) => `#${b.shortId}`).join(", ");
+        log.info(TAG24, `#${card.short_id} blocked by ${list} — waiting`);
+        await this.emitWaiting(card.id, `Blocked by ${list} — waiting for chain`);
+        return;
+      }
     }
     const queue = mode === "review" ? this.reviewQueue : this.implQueue;
     queue.enqueue(card, column, labels, mode);
@@ -4984,7 +5168,10 @@ class Pool {
       await this.emitWaiting(card.id, position > 0 ? `Queued (${position}/${total}) — waiting for ${mode} worker` : `Queued — waiting for ${mode} worker`);
     }
   }
+  lastWaitingEmit = new Map;
   async emitWaiting(cardId, currentTask) {
+    if (this.lastWaitingEmit.get(cardId) === currentTask)
+      return;
     try {
       await this.client.updateAgentProgress(cardId, {
         agentIdentifier: agentIdentifier(0),
@@ -4992,23 +5179,25 @@ class Pool {
         status: "waiting",
         currentTask
       });
+      this.lastWaitingEmit.set(cardId, currentTask);
     } catch (err) {
-      log.debug(TAG22, `waiting emit failed for ${cardId}: ${err instanceof Error ? err.message : err}`);
+      log.debug(TAG24, `waiting emit failed for ${cardId}: ${err instanceof Error ? err.message : err}`);
     }
   }
   async removeCard(cardId) {
     await this.stateStore.resetAttempts(cardId);
+    this.lastWaitingEmit.delete(cardId);
     for (const queue of [this.implQueue, this.reviewQueue]) {
       const removed = queue.remove(cardId);
       if (removed) {
         this.cardDataCache.delete(cardId);
-        log.info(TAG22, `Removed #${removed.shortId} from ${removed.mode} queue`);
+        log.info(TAG24, `Removed #${removed.shortId} from ${removed.mode} queue`);
         return;
       }
     }
     const worker = this.implWorkers.find((w) => w.cardId === cardId) ?? this.reviewWorkers.find((w) => w.cardId === cardId);
     if (worker) {
-      log.info(TAG22, `Cancelling worker ${worker.id} for card ${cardId}`);
+      log.info(TAG24, `Cancelling worker ${worker.id} for card ${cardId}`);
       await worker.cancel();
     }
   }
@@ -5036,10 +5225,10 @@ class Pool {
   async handleAgentCommand(cardId, command) {
     const worker = this.implWorkers.find((w) => w.cardId === cardId && w.isActive) ?? this.reviewWorkers.find((w) => w.cardId === cardId && w.isActive);
     if (!worker) {
-      log.debug(TAG22, `No active worker for card ${cardId}, ignoring ${command}`);
+      log.debug(TAG24, `No active worker for card ${cardId}, ignoring ${command}`);
       return;
     }
-    log.info(TAG22, `Agent command: ${command} → worker ${worker.id} (card ${cardId})`);
+    log.info(TAG24, `Agent command: ${command} → worker ${worker.id} (card ${cardId})`);
     switch (command) {
       case "pause":
         await worker.pause();
@@ -5085,19 +5274,20 @@ class Pool {
     };
   }
   async shutdown() {
-    log.info(TAG22, "Shutting down pool...");
+    log.info(TAG24, "Shutting down pool...");
     const active = [
       ...this.implWorkers.filter((w) => w.isActive),
       ...this.reviewWorkers.filter((w) => w.isActive)
     ];
     await Promise.all(active.map((w) => w.cancel()));
-    log.info(TAG22, "Pool shutdown complete");
+    this.sleepGuard.stop();
+    log.info(TAG24, "Pool shutdown complete");
   }
   cardDataCache = new Map;
   tryDispatchFor(workers, queue, label) {
     const idle = workers.find((w) => w.isIdle);
     if (!idle) {
-      log.debug(TAG22, `No idle ${label} workers (queue: ${queue.length})`);
+      log.debug(TAG24, `No idle ${label} workers (queue: ${queue.length})`);
       return false;
     }
     const next = queue.dequeue();
@@ -5105,21 +5295,25 @@ class Pool {
       return false;
     const data = this.cardDataCache.get(next.cardId);
     if (!data) {
-      log.warn(TAG22, `No cached data for card ${next.cardId}, skipping`);
+      log.warn(TAG24, `No cached data for card ${next.cardId}, skipping`);
       return false;
     }
     this.cardDataCache.delete(next.cardId);
-    log.info(TAG22, `Dispatching #${next.shortId} to ${label} worker ${idle.id}`);
+    this.lastWaitingEmit.delete(next.cardId);
+    log.info(TAG24, `Dispatching #${next.shortId} to ${label} worker ${idle.id}`);
+    this.sleepGuard.acquire();
     idle.run(data.card, data.column, data.labels, data.subtasks);
     return true;
   }
 }
-var TAG22 = "pool";
+var TAG24 = "pool";
 var init_pool = __esm(() => {
   init_log();
   init_queue();
   init_review_worker();
+  init_sleep_guard();
   init_types();
+  init_unblock();
   init_worker();
 });
 
@@ -5139,7 +5333,7 @@ async function fetchCardSafely(client, cardId) {
     const { card } = await client.getCard(cardId);
     return card;
   } catch (err) {
-    log.warn(TAG23, `cannot fetch card ${cardId}: ${err instanceof Error ? err.message : err}`);
+    log.warn(TAG25, `cannot fetch card ${cardId}: ${err instanceof Error ? err.message : err}`);
     return null;
   }
 }
@@ -5149,7 +5343,7 @@ async function recoverOrphans(store, client, config) {
     return [];
   }
   const outcomes = [];
-  log.info(TAG23, `recovering ${active.length} orphan run(s) from prior daemon`);
+  log.info(TAG25, `recovering ${active.length} orphan run(s) from prior daemon`);
   for (const run of active) {
     const outcome = {
       runId: run.runId,
@@ -5161,11 +5355,11 @@ async function recoverOrphans(store, client, config) {
     };
     outcomes.push(outcome);
     if (isProcessAlive(run.daemonPid, process.pid)) {
-      log.warn(TAG23, `run ${run.runId} claims live daemon pid ${run.daemonPid} — skipping`);
+      log.warn(TAG25, `run ${run.runId} claims live daemon pid ${run.daemonPid} — skipping`);
       outcome.actions.push("skipped: daemon pid still alive");
       continue;
     }
-    log.info(TAG23, `recovering ${run.pipeline} run ${run.runId} for card #${run.cardShortId}`);
+    log.info(TAG25, `recovering ${run.pipeline} run ${run.runId} for card #${run.cardShortId}`);
     await recoverRun(run, store, client, config, outcome);
   }
   return outcomes;
@@ -5183,7 +5377,7 @@ async function recoverRun(run, store, client, config, outcome) {
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     outcome.errors.push(`endAgentSession: ${msg}`);
-    log.warn(TAG23, `endAgentSession failed for ${run.cardId}: ${msg}`);
+    log.warn(TAG25, `endAgentSession failed for ${run.cardId}: ${msg}`);
   }
   const card = await fetchCardSafely(client, run.cardId);
   if (card) {
@@ -5224,9 +5418,9 @@ async function recoverRun(run, store, client, config, outcome) {
     const msg = err instanceof Error ? err.message : String(err);
     outcome.errors.push(`endRun: ${msg}`);
   }
-  log.info(TAG23, `recovered run ${run.runId} (card #${run.cardShortId}): ${outcome.actions.join(", ")}${outcome.errors.length ? ` | errors: ${outcome.errors.join("; ")}` : ""}`);
+  log.info(TAG25, `recovered run ${run.runId} (card #${run.cardShortId}): ${outcome.actions.join(", ")}${outcome.errors.length ? ` | errors: ${outcome.errors.join("; ")}` : ""}`);
 }
-var TAG23 = "recovery", RECOVERED_LABEL = "agent-recovered", RECOVERED_LABEL_COLOR = "#f59e0b";
+var TAG25 = "recovery", RECOVERED_LABEL = "agent-recovered", RECOVERED_LABEL_COLOR = "#f59e0b";
 var init_recovery = __esm(() => {
   init_board_helpers();
   init_log();
@@ -5274,7 +5468,7 @@ class Reconciler {
       clearInterval(this.timer);
       this.timer = null;
     }
-    log.info(TAG24, "Heartbeat stopped");
+    log.info(TAG26, "Heartbeat stopped");
   }
   async recoverStaleRuns() {
     if (!this.stateStore || !this.agentConfig)
@@ -5291,7 +5485,7 @@ class Reconciler {
       if (!daemonDead && !(heartbeatStale && ourZombie))
         continue;
       const reason = daemonDead ? `foreign daemon ${run.daemonPid} is dead` : `our worker lost card ${run.cardId} with ${Math.round((now - run.lastHeartbeatAt) / 1000)}s stale heartbeat`;
-      log.warn(TAG24, `zombie run ${run.runId} (#${run.cardShortId}): ${reason} — recovering`);
+      log.warn(TAG26, `zombie run ${run.runId} (#${run.cardShortId}): ${reason} — recovering`);
       await recoverRun(run, this.stateStore, this.client, this.agentConfig, {
         runId: run.runId,
         cardId: run.cardId,
@@ -5327,18 +5521,18 @@ class Reconciler {
           const subtasks = card.subtasks ?? [];
           const mode = reviewColumnIds.has(card.column_id) ? "review" : "implement";
           if (mode === "review" && this.approvedLabel && hasLabel(cardLabels, this.approvedLabel)) {
-            log.debug(TAG24, `Skipping #${card.short_id} — already has "${this.approvedLabel}" label`);
+            log.debug(TAG26, `Skipping #${card.short_id} — already has "${this.approvedLabel}" label`);
             continue;
           }
           if (mode === "review" && hasLabel(cardLabels, NEED_REVIEW_LABEL)) {
-            log.debug(TAG24, `Skipping #${card.short_id} — has "${NEED_REVIEW_LABEL}" label (needs human)`);
+            log.debug(TAG26, `Skipping #${card.short_id} — has "${NEED_REVIEW_LABEL}" label (needs human)`);
             continue;
           }
           if (mode === "review" && !extractBranchFromDescription(card.description)) {
-            log.debug(TAG24, `Skipping #${card.short_id} — no branch reference (not qualified for auto-review)`);
+            log.debug(TAG26, `Skipping #${card.short_id} — no branch reference (not qualified for auto-review)`);
             continue;
           }
-          log.info(TAG24, `Missed assignment: #${card.short_id} "${card.title}" (${mode}) — enqueueing`);
+          log.info(TAG26, `Missed assignment: #${card.short_id} "${card.title}" (${mode}) — enqueueing`);
           await this.pool.enqueue(card, column, cardLabels, subtasks, mode);
         }
       }
@@ -5347,17 +5541,17 @@ class Reconciler {
       }
       for (const knownId of knownCardIds) {
         if (!allAgentCardIds.has(knownId)) {
-          log.info(TAG24, `Missed unassign: ${knownId} — removing`);
+          log.info(TAG26, `Missed unassign: ${knownId} — removing`);
           await this.pool.removeCard(knownId);
         }
       }
-      log.debug(TAG24, `Reconciled: ${assignedCards.length} assigned, ${knownCardIds.size} known`);
+      log.debug(TAG26, `Reconciled: ${assignedCards.length} assigned, ${knownCardIds.size} known`);
     } catch (err) {
-      log.error(TAG24, `Heartbeat failed: ${err instanceof Error ? err.message : err}`);
+      log.error(TAG26, `Heartbeat failed: ${err instanceof Error ? err.message : err}`);
     }
   }
 }
-var TAG24 = "reconcile";
+var TAG26 = "reconcile";
 var init_reconcile = __esm(() => {
   init_board_helpers();
   init_log();
@@ -5391,7 +5585,7 @@ function prettyBanner(config, version) {
       checks.push({ kind: "ok", message });
     },
     warn(message) {
-      log.warn(TAG25, message);
+      log.warn(TAG27, message);
       checks.push({ kind: "warn", message: message.split(`
 `, 1)[0] });
     },
@@ -5415,22 +5609,22 @@ function prettyBanner(config, version) {
   };
 }
 function jsonBanner(config, version) {
-  log.info(TAG25, `Harmony Agent Daemon v${version} starting...`);
-  log.info(TAG25, `Project: ${config.projectId} | Pool: ${config.agent.poolSize} | Model: ${config.agent.claude.model} | Pickup: ${config.agent.pickupColumns.join(", ")}`);
+  log.info(TAG27, `Harmony Agent Daemon v${version} starting...`);
+  log.info(TAG27, `Project: ${config.projectId} | Pool: ${config.agent.poolSize} | Model: ${config.agent.claude.model} | Pickup: ${config.agent.pickupColumns.join(", ")}`);
   if (config.agent.review.enabled) {
-    log.info(TAG25, `Review: enabled | Columns: ${config.agent.review.pickupColumns.join(", ")} | → ${config.agent.review.moveToColumn} / ${config.agent.review.failColumn}`);
+    log.info(TAG27, `Review: enabled | Columns: ${config.agent.review.pickupColumns.join(", ")} | → ${config.agent.review.moveToColumn} / ${config.agent.review.failColumn}`);
   }
   let failed = false;
   return {
     setProjectName(_name) {},
     setGitProvider(provider) {
-      log.info(TAG25, `Git provider: ${provider}`);
+      log.info(TAG27, `Git provider: ${provider}`);
     },
     check(message) {
-      log.info(TAG25, message);
+      log.info(TAG27, message);
     },
     warn(message) {
-      log.warn(TAG25, message);
+      log.warn(TAG27, message);
     },
     fail() {
       failed = true;
@@ -5438,7 +5632,7 @@ function jsonBanner(config, version) {
     async ready(message) {
       if (failed)
         return;
-      log.info(TAG25, message);
+      log.info(TAG27, message);
     }
   };
 }
@@ -5505,7 +5699,7 @@ function cyan(s) {
 function yellow(s) {
   return `${ANSI.yellow}${s}${ANSI.reset}`;
 }
-var TAG25 = "daemon", RULE_WIDTH = 70, ANSI;
+var TAG27 = "daemon", RULE_WIDTH = 70, ANSI;
 var init_startup_banner = __esm(() => {
   init_log();
   ANSI = {
@@ -5652,18 +5846,18 @@ class Watcher {
   }
   async start() {
     if (!isPretty()) {
-      log.info(TAG26, "Connecting to Supabase realtime (broadcast)...");
+      log.info(TAG28, "Connecting to Supabase realtime (broadcast)...");
     }
     this.supabase = createClient(this.credentials.supabaseUrl, this.credentials.supabaseAnonKey);
     const presenceChannel = this.supabase.channel(`board-presence-${this.projectId}`);
     const channel = this.supabase.channel(`board-${this.projectId}`).on("broadcast", { event: "card_update" }, (msg) => {
-      log.debug(TAG26, `Broadcast: card_update ${JSON.stringify(msg.payload)}`);
+      log.debug(TAG28, `Broadcast: card_update ${JSON.stringify(msg.payload)}`);
       this.onCardBroadcast({
         event: "card_update",
         payload: msg.payload ?? {}
       });
     }).on("broadcast", { event: "card_created" }, (msg) => {
-      log.debug(TAG26, `Broadcast: card_created ${JSON.stringify(msg.payload)}`);
+      log.debug(TAG28, `Broadcast: card_created ${JSON.stringify(msg.payload)}`);
       this.onCardBroadcast({
         event: "card_created",
         payload: msg.payload ?? {}
@@ -5673,29 +5867,29 @@ class Watcher {
       const cardId = payload.card_id;
       const command = payload.command;
       if (cardId && command) {
-        log.info(TAG26, `Broadcast: agent_command ${command} for ${cardId}`);
+        log.info(TAG28, `Broadcast: agent_command ${command} for ${cardId}`);
         this.onAgentCommand?.({ cardId, command });
       }
     }).subscribe((status) => {
       if (status === "SUBSCRIBED") {
         this.connected = true;
         if (!isPretty() || !this.suppressStartupLogs) {
-          log.info(TAG26, "Broadcast subscription active");
+          log.info(TAG28, "Broadcast subscription active");
         }
         this.maybeResolveReady();
       } else if (status === "CHANNEL_ERROR") {
         this.connected = false;
-        log.error(TAG26, "Broadcast channel error — will rely on reconciliation");
+        log.error(TAG28, "Broadcast channel error — will rely on reconciliation");
       } else if (status === "TIMED_OUT") {
         this.connected = false;
-        log.warn(TAG26, "Broadcast subscription timed out — retrying...");
+        log.warn(TAG28, "Broadcast subscription timed out — retrying...");
       } else if (status === "CLOSED") {
         this.connected = false;
       }
     });
     this.channel = channel;
     presenceChannel.on("presence", { event: "sync" }, () => {
-      log.debug(TAG26, "Presence sync");
+      log.debug(TAG28, "Presence sync");
     }).subscribe(async (status) => {
       if (status === "SUBSCRIBED") {
         await presenceChannel.track({
@@ -5707,7 +5901,7 @@ class Watcher {
           agentName: this.identity.agentName
         });
         if (!isPretty() || !this.suppressStartupLogs) {
-          log.info(TAG26, "Presence tracked on board-presence channel");
+          log.info(TAG28, "Presence tracked on board-presence channel");
         }
         this.presenceTracked = true;
         this.maybeResolveReady();
@@ -5729,10 +5923,10 @@ class Watcher {
       this.supabase = null;
     }
     this.connected = false;
-    log.info(TAG26, "Broadcast subscription stopped");
+    log.info(TAG28, "Broadcast subscription stopped");
   }
 }
-var TAG26 = "watcher";
+var TAG28 = "watcher";
 var init_watcher = __esm(() => {
   init_log();
 });
@@ -5807,10 +6001,10 @@ function runWorktreeGc(basePath, store, opts = {}) {
     });
   } catch {}
   if (result.removed.length > 0) {
-    log.info(TAG27, `GC removed ${result.removed.length} orphan worktree(s): ${result.removed.map((p) => p.split("/").pop()).join(", ")}`);
+    log.info(TAG29, `GC removed ${result.removed.length} orphan worktree(s): ${result.removed.map((p) => p.split("/").pop()).join(", ")}`);
   }
   if (result.errors.length > 0) {
-    log.warn(TAG27, `GC had ${result.errors.length} error(s): ${result.errors.map((e) => `${e.path}: ${e.error}`).join("; ")}`);
+    log.warn(TAG29, `GC had ${result.errors.length} error(s): ${result.errors.map((e) => `${e.path}: ${e.error}`).join("; ")}`);
   }
   return result;
 }
@@ -5887,10 +6081,10 @@ function pruneFailedRemoteBranches(opts) {
     }
   }
   if (result.removed.length > 0) {
-    log.info(TAG27, `Pruned ${result.removed.length} stale remote branch(es) under ${opts.prefix}: ${result.removed.join(", ")}`);
+    log.info(TAG29, `Pruned ${result.removed.length} stale remote branch(es) under ${opts.prefix}: ${result.removed.join(", ")}`);
   }
   if (result.errors.length > 0) {
-    log.warn(TAG27, `Remote branch GC had ${result.errors.length} error(s): ${result.errors.map((e) => `${e.ref}: ${e.error}`).join("; ")}`);
+    log.warn(TAG29, `Remote branch GC had ${result.errors.length} error(s): ${result.errors.map((e) => `${e.ref}: ${e.error}`).join("; ")}`);
   }
   return result;
 }
@@ -5921,13 +6115,13 @@ class WorktreeGc {
     try {
       runWorktreeGc(this.basePath, this.store);
     } catch (err) {
-      log.warn(TAG27, `GC tick failed: ${err instanceof Error ? err.message : err}`);
+      log.warn(TAG29, `GC tick failed: ${err instanceof Error ? err.message : err}`);
     }
     if (this.remoteOpts) {
       try {
         pruneFailedRemoteBranches(this.remoteOpts);
       } catch (err) {
-        log.warn(TAG27, `Remote GC tick failed: ${err instanceof Error ? err.message : err}`);
+        log.warn(TAG29, `Remote GC tick failed: ${err instanceof Error ? err.message : err}`);
       }
     }
   }
@@ -5941,7 +6135,7 @@ function getRepoRoot2() {
     return null;
   }
 }
-var TAG27 = "worktree-gc";
+var TAG29 = "worktree-gc";
 var init_worktree_gc = __esm(() => {
   init_log();
   init_worktree();
@@ -6023,7 +6217,7 @@ async function main() {
   } catch (err) {
     if (err instanceof ConfigValidationError) {
       banner.fail();
-      log.error(TAG28, err.message);
+      log.error(TAG30, err.message);
       process.exit(1);
     }
     throw err;
@@ -6041,12 +6235,21 @@ async function main() {
   const realtimeCreds = await fetchRealtimeCredentials(client);
   banner.check("Realtime credentials");
   const pool = new Pool(config.agent, client, config.userEmail, config.workspaceId, config.projectId, stateStore);
+  const promoteSuccessors = async (completedCard) => {
+    await promoteUnblockedSuccessors(completedCard, {
+      client,
+      agentUserId,
+      enqueue: (cardId) => tryEnqueueCard(cardId, client, pool, config)
+    });
+  };
+  pool.onCardCompleted = promoteSuccessors;
   const reviewColumns = config.agent.review.enabled ? config.agent.review.pickupColumns : [];
   const approvedLabel = config.agent.review.enabled ? config.agent.review.approvedLabel : "";
   const reconciler = new Reconciler(client, pool, config.projectId, agentUserId, config.agent.pickupColumns, reviewColumns, approvedLabel, config.agent.timing.reconcileIntervalMs, stateStore, config.agent);
   let mergeMonitor = null;
   if (config.agent.review.enabled && config.agent.review.mergeMonitor) {
     mergeMonitor = new MergeMonitor(client, config.projectId, config.agent);
+    mergeMonitor.onCardCompleted = promoteSuccessors;
   }
   const worktreeGc = new WorktreeGc(config.agent.worktree.basePath, stateStore, config.agent.timing.worktreeGcIntervalMs, config.agent.worktree.failedAttemptRetentionDays > 0 ? {
     prefix: config.agent.worktree.failedBranchPrefix,
@@ -6115,25 +6318,25 @@ async function main() {
     if (shuttingDown)
       return;
     shuttingDown = true;
-    log.info(TAG28, `Received ${signal}, shutting down gracefully...`);
+    log.info(TAG30, `Received ${signal}, shutting down gracefully...`);
     reconciler.stop();
     mergeMonitor?.stop();
     worktreeGc.stop();
     await httpServer?.stop();
     await watcher.stop();
     await pool.shutdown();
-    log.info(TAG28, "Daemon stopped.");
+    log.info(TAG30, "Daemon stopped.");
     process.exit(exitCode);
   };
   process.on("SIGINT", () => shutdown("SIGINT"));
   process.on("SIGTERM", () => shutdown("SIGTERM"));
   process.on("uncaughtException", (err) => {
-    log.error(TAG28, `Uncaught exception: ${err.message}`);
+    log.error(TAG30, `Uncaught exception: ${err.message}`);
     exitCode = 1;
     shutdown("uncaughtException");
   });
   process.on("unhandledRejection", (reason) => {
-    log.error(TAG28, `Unhandled rejection: ${reason instanceof Error ? reason.message : String(reason)}`);
+    log.error(TAG30, `Unhandled rejection: ${reason instanceof Error ? reason.message : String(reason)}`);
     exitCode = 1;
     shutdown("unhandledRejection");
   });
@@ -6180,14 +6383,14 @@ async function handleBroadcast(event, client, pool, config, agentUserId) {
   if (assigneeId === undefined)
     return;
   if (assigneeId === agentUserId) {
-    log.info(TAG28, `Broadcast: card ${cardId} assigned to agent`);
+    log.info(TAG30, `Broadcast: card ${cardId} assigned to agent`);
     try {
       await tryEnqueueCard(cardId, client, pool, config);
     } catch (err) {
-      log.error(TAG28, `Failed to process assignment: ${err instanceof Error ? err.message : err}`);
+      log.error(TAG30, `Failed to process assignment: ${err instanceof Error ? err.message : err}`);
     }
   } else if (pool.isCardKnown(cardId)) {
-    log.info(TAG28, `Broadcast: card ${cardId} unassigned from agent`);
+    log.info(TAG30, `Broadcast: card ${cardId} unassigned from agent`);
     await pool.removeCard(cardId);
   }
 }
@@ -6197,13 +6400,13 @@ async function tryEnqueueCard(cardId, client, pool, config) {
   const columns = board.columns;
   const column = columns.find((c) => c.id === card.column_id);
   if (!column) {
-    log.warn(TAG28, `Column not found for card ${cardId}`);
+    log.warn(TAG30, `Column not found for card ${cardId}`);
     return;
   }
   const isPickupColumn = config.agent.pickupColumns.some((name) => name.toLowerCase() === column.name.toLowerCase());
   const isReviewColumn = config.agent.review.enabled && config.agent.review.pickupColumns.some((name) => name.toLowerCase() === column.name.toLowerCase());
   if (!isPickupColumn && !isReviewColumn) {
-    log.info(TAG28, `Card #${card.short_id} is in "${column.name}", not a pickup/review column — skipping`);
+    log.info(TAG30, `Card #${card.short_id} is in "${column.name}", not a pickup/review column — skipping`);
     return;
   }
   const mode = isReviewColumn ? "review" : "implement";
@@ -6211,16 +6414,16 @@ async function tryEnqueueCard(cardId, client, pool, config) {
   const cardLabels = resolveCardLabels(card, labelMap);
   const subtasks = card.subtasks ?? [];
   if (mode === "review" && config.agent.review.approvedLabel && hasLabel(cardLabels, config.agent.review.approvedLabel)) {
-    log.debug(TAG28, `Card #${card.short_id} already has "${config.agent.review.approvedLabel}" — skipping review`);
+    log.debug(TAG30, `Card #${card.short_id} already has "${config.agent.review.approvedLabel}" — skipping review`);
     return;
   }
   if (mode === "review" && !extractBranchFromDescription(card.description)) {
-    log.info(TAG28, `Card #${card.short_id} has no branch reference — skipping auto-review`);
+    log.info(TAG30, `Card #${card.short_id} has no branch reference — skipping auto-review`);
     return;
   }
   await pool.enqueue(card, column, cardLabels, subtasks, mode);
 }
-var TAG28 = "daemon", PKG_VERSION;
+var TAG30 = "daemon", PKG_VERSION;
 var init_src = __esm(() => {
   init_board_helpers();
   init_config();
@@ -6237,6 +6440,7 @@ var init_src = __esm(() => {
   init_state_store();
   init_stream_parser_selftest();
   init_types();
+  init_unblock();
   init_watcher();
   init_worktree_gc();
   ({ version: PKG_VERSION } = createRequire2(import.meta.url)("../package.json"));