agent-board-runner 0.1.24 → 0.1.26

package/dist/cli.js

@@ -320,7 +320,7 @@ var BOX_DRAWING_PATTERN = /[─-╿]/g;
 var WORKING_PATTERN = /esc to interrupt/i;
 var BACKGROUND_SHELL_PATTERN = /\b[1-9]\d*\s+shells?\b/i;
 function isAgentHookMoment(value) {
-  return value === "implementing" || value === "tool_active" || value === "waiting_plan_approval" || value === "waiting_prototype_review" || value === "waiting_workflow_answer" || value === "commit_detected" || value === "turn_stopped" || value === "notification";
+  return value === "implementing" || value === "tool_active" || value === "waiting_plan_approval" || value === "waiting_prototype_review" || value === "waiting_workflow_answer" || value === "waiting_child_card" || value === "commit_detected" || value === "turn_stopped" || value === "notification";
 }
 var USAGE_LIMIT_PATTERN = /(usage limit reached|limit reached[^\n]{0,60}resets|reached your (?:usage|session) limit|out of (?:weekly|session) (?:usage|limit))/i;
 var PLAN_APPROVAL_PATTERN = /would you like to proceed\??/i;
@@ -374,6 +374,8 @@ var AgentActivityWatcher = class {
   prototypeReviewPending = false;
   /** Same shape as prototypeReviewPending, for ask_workflow_question (see docs/ai-knowledges/workflows-visuais-mecanismo.md). */
   workflowAnswerPending = false;
+  /** Same shape as workflowAnswerPending, for wait_for_card_completion (see docs/ai-knowledges/workflows-visuais-aja-orquestra-card.md) — only ever latched on a card-less workflow shell pty. */
+  childCardPending = false;
   toolCallPending = false;
   commitDetected = false;
   timer;
@@ -417,6 +419,7 @@ var AgentActivityWatcher = class {
         this.planApprovalPending = false;
         this.prototypeReviewPending = false;
         this.workflowAnswerPending = false;
+        this.childCardPending = false;
         this.commitDetected = false;
         this.setState("implementing");
         break;
@@ -436,6 +439,10 @@ var AgentActivityWatcher = class {
         this.workflowAnswerPending = true;
         this.setState("waiting_workflow_answer");
         break;
+      case "waiting_child_card":
+        this.childCardPending = true;
+        this.setState("waiting_child_card");
+        break;
       case "commit_detected":
         this.commitDetected = true;
         break;
@@ -443,6 +450,7 @@ var AgentActivityWatcher = class {
         if (this.usageLimited) break;
         if (this.prototypeReviewPending) break;
         if (this.workflowAnswerPending) break;
+        if (this.childCardPending) break;
         if (BACKGROUND_SHELL_PATTERN.test(this.recentOutput())) {
           this.setState("waiting_background");
           break;
@@ -1280,6 +1288,12 @@ function detectMoment(input) {
   // \u2014 see the workflowAnswerPending latch in agentActivity.ts's reportHookMoment.
   if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__ask_workflow_question") return "waiting_workflow_answer";
 
+  // Same shape as ask_workflow_question above, but for a workflow graph's "act" node (see
+  // wait_for_card_completion in boardTools.ts and
+  // docs/ai-knowledges/workflows-visuais-aja-orquestra-card.md) \u2014 see the childCardPending latch
+  // in agentActivity.ts's reportHookMoment.
+  if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__wait_for_card_completion") return "waiting_child_card";
+
   // A commit that actually succeeded, read off the Bash tool's own structured result instead
   // of guessing from scrollback text (exact, and immune to locale/color/format changes to
   // git's own banner). Any other Bash completion still reports "tool_active" below, same as
@@ -4413,14 +4427,22 @@ async function completeWorkflowExecution(supabase, executionId, status) {
     logger.runner.error("WORKFLOW_SHELL", `Failed to record ${status} status for workflow execution ${executionId}:`, error);
   }
 }
+var intentionallyStoppedExecutionIds = /* @__PURE__ */ new Set();
+async function finalizeWorkflowExecution(supabase, executionId, status) {
+  intentionallyStoppedExecutionIds.add(executionId);
+  await completeWorkflowExecution(supabase, executionId, status);
+  stopPtySession(executionId);
+}
 async function handleWorkflowShellExit(supabase, executionId, exitCode) {
   unregisterAgentActivityWatcher(executionId);
+  if (intentionallyStoppedExecutionIds.delete(executionId)) return;
   await completeWorkflowExecution(supabase, executionId, exitCode === 0 ? "done" : "failed");
+  stopPtySession(executionId);
 }
 function watchWorkflowShellActivity(supabase, executionId, pty) {
   const watcher = new AgentActivityWatcher((state) => {
     if (state === "done" || state === "waiting_user") {
-      void completeWorkflowExecution(supabase, executionId, "done");
+      void finalizeWorkflowExecution(supabase, executionId, "done");
     }
   });
   pty.onData((chunk) => watcher.push(chunk));
@@ -4428,7 +4450,7 @@ function watchWorkflowShellActivity(supabase, executionId, pty) {
   return watcher;
 }
 async function reconcileOrphanedWorkflowExecutions(supabase, config) {
-  const { data, error } = await supabase.from("workflow_executions").select("id, project_id, claude_session_id, shell_ticket").eq("runner_id", config.runnerId).in("status", ["running", "paused_on_question"]);
+  const { data, error } = await supabase.from("workflow_executions").select("id, project_id, claude_session_id, shell_ticket").eq("runner_id", config.runnerId).in("status", ["running", "paused_on_question", "waiting_child_card"]);
   if (error) {
     logger.runner.error("WORKFLOW_SHELL", "Failed to scan orphaned workflow executions:", error.message);
     return;
@@ -4436,23 +4458,68 @@ async function reconcileOrphanedWorkflowExecutions(supabase, config) {
   for (const execution of data ?? []) {
     const { id: executionId, project_id: projectId, claude_session_id: claudeSessionId, shell_ticket: shellTicket } = execution;
     if (getPtySession(executionId)) continue;
-    if (!claudeSessionId || !shellTicket) {
-      logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId} is missing claude_session_id/shell_ticket \u2014 cannot resume it.`);
-      continue;
-    }
-    const registered = config.registeredProjects.find((project) => project.id === projectId);
-    if (!registered) {
-      logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId}: project ${projectId} is not registered on this runner \u2014 skipping.`);
-      continue;
+    const pty = reattachWorkflowShellPty(supabase, config, executionId, projectId, claudeSessionId, shellTicket);
+    if (pty) logger.runner.info("WORKFLOW_SHELL", `Re-spawned orphaned workflow execution ${executionId} (runner restarted while it was still active).`);
+  }
+}
+function reattachWorkflowShellPty(supabase, config, executionId, projectId, claudeSessionId, shellTicket) {
+  if (!claudeSessionId || !shellTicket) {
+    logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId} is missing claude_session_id/shell_ticket \u2014 cannot resume it.`);
+    return null;
+  }
+  const registered = config.registeredProjects.find((project) => project.id === projectId);
+  if (!registered) {
+    logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId}: project ${projectId} is not registered on this runner \u2014 skipping.`);
+    return null;
+  }
+  const pty = resumeAgentPty(registered.repoPath, claudeSessionId, executionId, shellTicket);
+  registerPtySession(executionId, pty, shellTicket);
+  const activityWatcher = watchWorkflowShellActivity(supabase, executionId, pty);
+  pty.onExit(({ exitCode }) => {
+    activityWatcher.stop();
+    void handleWorkflowShellExit(supabase, executionId, exitCode);
+  });
+  return pty;
+}
+async function resumeWorkflowExecutionWaitingOnChildCard(supabase, config, card, { viaCancellation }) {
+  const { data, error } = await supabase.from("workflow_executions").select("id, project_id, claude_session_id, shell_ticket").eq("waiting_card_id", card.id).eq("status", "waiting_child_card").eq("runner_id", config.runnerId).maybeSingle();
+  if (error) {
+    logger.runner.error("WORKFLOW_SHELL", `Failed to look up a workflow execution waiting on card ${card.id}:`, error.message);
+    return;
+  }
+  const execution = data;
+  if (!execution) return;
+  const { data: lastComment } = await supabase.from("card_comments").select("body").eq("card_id", card.id).order("created_at", { ascending: false }).limit(1).maybeSingle();
+  const lastCommentBody = lastComment?.body ?? null;
+  const resumeText = viaCancellation ? `Card "${card.title}" (id: ${card.id}) foi CANCELADO/ARQUIVADO, n\xE3o conclu\xEDdo normalmente.
+
+Prossiga com o workflow a partir do passo seguinte, levando isso em conta.` : `Card "${card.title}" (id: ${card.id}) chegou em "deploy" \u2014 implementado, revisado e empacotado (o push final para "fim" \xE9 manual, fora do controle de qualquer agente).
+
+Resumo: "${lastCommentBody ?? "(nenhum coment\xE1rio encontrado no card)"}"
+
+Prossiga com o workflow a partir do passo seguinte.`;
+  let handle = getPtySession(execution.id);
+  if (!handle || handle.exited) {
+    const pty = reattachWorkflowShellPty(supabase, config, execution.id, execution.project_id, execution.claude_session_id, execution.shell_ticket);
+    if (!pty) {
+      logger.runner.error("WORKFLOW_SHELL", `Workflow execution ${execution.id} has no live pty and could not be reattached \u2014 cannot resume it with child card ${card.id}'s result.`);
+      return;
     }
-    const pty = resumeAgentPty(registered.repoPath, claudeSessionId, executionId, shellTicket);
-    registerPtySession(executionId, pty, shellTicket);
-    const activityWatcher = watchWorkflowShellActivity(supabase, executionId, pty);
-    pty.onExit(({ exitCode }) => {
-      activityWatcher.stop();
-      void handleWorkflowShellExit(supabase, executionId, exitCode);
-    });
-    logger.runner.info("WORKFLOW_SHELL", `Re-spawned orphaned workflow execution ${executionId} (runner restarted while it was still active).`);
+    handle = getPtySession(execution.id);
+  }
+  if (!handle) return;
+  const { error: resumeError } = await supabase.rpc("resume_workflow_execution_after_child_card", {
+    p_execution_id: execution.id,
+    p_child_card_id: card.id
+  });
+  if (resumeError) {
+    logger.runner.error("WORKFLOW_SHELL", `Failed to resume workflow execution ${execution.id} after child card ${card.id}:`, resumeError.message);
+    return;
+  }
+  try {
+    writePasteAndSubmit(handle.pty, execution.id, resumeText, "child card result", logger.runner);
+  } catch (err) {
+    logger.runner.error("WORKFLOW_SHELL", `Failed to send child card result to workflow execution ${execution.id}:`, err);
   }
 }
 
@@ -4622,8 +4689,12 @@ async function startRunner() {
       if (previousColumn === "revisao" && card.column_name !== "revisao") {
         releaseCard(card.id);
       }
+      if (previousColumn !== "deploy" && card.column_name === "deploy") {
+        void resumeWorkflowExecutionWaitingOnChildCard(supabase, config, card, { viaCancellation: false });
+      }
       if (card.column_name === "fim" && previousColumn !== "fim") {
         void handleCardReachedFim(supabase, config, card);
+        if (previousColumn !== "deploy") void resumeWorkflowExecutionWaitingOnChildCard(supabase, config, card, { viaCancellation: true });
       }
       const previousRequeueRequestedAt = lastKnownRequeueRequestedAt.get(card.id);
       lastKnownRequeueRequestedAt.set(card.id, card.requeue_requested_at);

package/dist/index.js

@@ -40,7 +40,7 @@ var BOX_DRAWING_PATTERN = /[─-╿]/g;
 var WORKING_PATTERN = /esc to interrupt/i;
 var BACKGROUND_SHELL_PATTERN = /\b[1-9]\d*\s+shells?\b/i;
 function isAgentHookMoment(value) {
-  return value === "implementing" || value === "tool_active" || value === "waiting_plan_approval" || value === "waiting_prototype_review" || value === "waiting_workflow_answer" || value === "commit_detected" || value === "turn_stopped" || value === "notification";
+  return value === "implementing" || value === "tool_active" || value === "waiting_plan_approval" || value === "waiting_prototype_review" || value === "waiting_workflow_answer" || value === "waiting_child_card" || value === "commit_detected" || value === "turn_stopped" || value === "notification";
 }
 var USAGE_LIMIT_PATTERN = /(usage limit reached|limit reached[^\n]{0,60}resets|reached your (?:usage|session) limit|out of (?:weekly|session) (?:usage|limit))/i;
 var PLAN_APPROVAL_PATTERN = /would you like to proceed\??/i;
@@ -94,6 +94,8 @@ var AgentActivityWatcher = class {
   prototypeReviewPending = false;
   /** Same shape as prototypeReviewPending, for ask_workflow_question (see docs/ai-knowledges/workflows-visuais-mecanismo.md). */
   workflowAnswerPending = false;
+  /** Same shape as workflowAnswerPending, for wait_for_card_completion (see docs/ai-knowledges/workflows-visuais-aja-orquestra-card.md) — only ever latched on a card-less workflow shell pty. */
+  childCardPending = false;
   toolCallPending = false;
   commitDetected = false;
   timer;
@@ -137,6 +139,7 @@ var AgentActivityWatcher = class {
         this.planApprovalPending = false;
         this.prototypeReviewPending = false;
         this.workflowAnswerPending = false;
+        this.childCardPending = false;
         this.commitDetected = false;
         this.setState("implementing");
         break;
@@ -156,6 +159,10 @@ var AgentActivityWatcher = class {
         this.workflowAnswerPending = true;
         this.setState("waiting_workflow_answer");
         break;
+      case "waiting_child_card":
+        this.childCardPending = true;
+        this.setState("waiting_child_card");
+        break;
       case "commit_detected":
         this.commitDetected = true;
         break;
@@ -163,6 +170,7 @@ var AgentActivityWatcher = class {
         if (this.usageLimited) break;
         if (this.prototypeReviewPending) break;
         if (this.workflowAnswerPending) break;
+        if (this.childCardPending) break;
         if (BACKGROUND_SHELL_PATTERN.test(this.recentOutput())) {
           this.setState("waiting_background");
           break;
@@ -1000,6 +1008,12 @@ function detectMoment(input) {
   // \u2014 see the workflowAnswerPending latch in agentActivity.ts's reportHookMoment.
   if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__ask_workflow_question") return "waiting_workflow_answer";
 
+  // Same shape as ask_workflow_question above, but for a workflow graph's "act" node (see
+  // wait_for_card_completion in boardTools.ts and
+  // docs/ai-knowledges/workflows-visuais-aja-orquestra-card.md) \u2014 see the childCardPending latch
+  // in agentActivity.ts's reportHookMoment.
+  if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__wait_for_card_completion") return "waiting_child_card";
+
   // A commit that actually succeeded, read off the Bash tool's own structured result instead
   // of guessing from scrollback text (exact, and immune to locale/color/format changes to
   // git's own banner). Any other Bash completion still reports "tool_active" below, same as
@@ -4301,14 +4315,22 @@ async function completeWorkflowExecution(supabase, executionId, status) {
     logger.runner.error("WORKFLOW_SHELL", `Failed to record ${status} status for workflow execution ${executionId}:`, error);
   }
 }
+var intentionallyStoppedExecutionIds = /* @__PURE__ */ new Set();
+async function finalizeWorkflowExecution(supabase, executionId, status) {
+  intentionallyStoppedExecutionIds.add(executionId);
+  await completeWorkflowExecution(supabase, executionId, status);
+  stopPtySession(executionId);
+}
 async function handleWorkflowShellExit(supabase, executionId, exitCode) {
   unregisterAgentActivityWatcher(executionId);
+  if (intentionallyStoppedExecutionIds.delete(executionId)) return;
   await completeWorkflowExecution(supabase, executionId, exitCode === 0 ? "done" : "failed");
+  stopPtySession(executionId);
 }
 function watchWorkflowShellActivity(supabase, executionId, pty) {
   const watcher = new AgentActivityWatcher((state) => {
     if (state === "done" || state === "waiting_user") {
-      void completeWorkflowExecution(supabase, executionId, "done");
+      void finalizeWorkflowExecution(supabase, executionId, "done");
     }
   });
   pty.onData((chunk) => watcher.push(chunk));
@@ -4316,7 +4338,7 @@ function watchWorkflowShellActivity(supabase, executionId, pty) {
   return watcher;
 }
 async function reconcileOrphanedWorkflowExecutions(supabase, config) {
-  const { data, error } = await supabase.from("workflow_executions").select("id, project_id, claude_session_id, shell_ticket").eq("runner_id", config.runnerId).in("status", ["running", "paused_on_question"]);
+  const { data, error } = await supabase.from("workflow_executions").select("id, project_id, claude_session_id, shell_ticket").eq("runner_id", config.runnerId).in("status", ["running", "paused_on_question", "waiting_child_card"]);
   if (error) {
     logger.runner.error("WORKFLOW_SHELL", "Failed to scan orphaned workflow executions:", error.message);
     return;
@@ -4324,23 +4346,68 @@ async function reconcileOrphanedWorkflowExecutions(supabase, config) {
   for (const execution of data ?? []) {
     const { id: executionId, project_id: projectId, claude_session_id: claudeSessionId, shell_ticket: shellTicket } = execution;
     if (getPtySession(executionId)) continue;
-    if (!claudeSessionId || !shellTicket) {
-      logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId} is missing claude_session_id/shell_ticket \u2014 cannot resume it.`);
-      continue;
-    }
-    const registered = config.registeredProjects.find((project) => project.id === projectId);
-    if (!registered) {
-      logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId}: project ${projectId} is not registered on this runner \u2014 skipping.`);
-      continue;
+    const pty = reattachWorkflowShellPty(supabase, config, executionId, projectId, claudeSessionId, shellTicket);
+    if (pty) logger.runner.info("WORKFLOW_SHELL", `Re-spawned orphaned workflow execution ${executionId} (runner restarted while it was still active).`);
+  }
+}
+function reattachWorkflowShellPty(supabase, config, executionId, projectId, claudeSessionId, shellTicket) {
+  if (!claudeSessionId || !shellTicket) {
+    logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId} is missing claude_session_id/shell_ticket \u2014 cannot resume it.`);
+    return null;
+  }
+  const registered = config.registeredProjects.find((project) => project.id === projectId);
+  if (!registered) {
+    logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId}: project ${projectId} is not registered on this runner \u2014 skipping.`);
+    return null;
+  }
+  const pty = resumeAgentPty(registered.repoPath, claudeSessionId, executionId, shellTicket);
+  registerPtySession(executionId, pty, shellTicket);
+  const activityWatcher = watchWorkflowShellActivity(supabase, executionId, pty);
+  pty.onExit(({ exitCode }) => {
+    activityWatcher.stop();
+    void handleWorkflowShellExit(supabase, executionId, exitCode);
+  });
+  return pty;
+}
+async function resumeWorkflowExecutionWaitingOnChildCard(supabase, config, card, { viaCancellation }) {
+  const { data, error } = await supabase.from("workflow_executions").select("id, project_id, claude_session_id, shell_ticket").eq("waiting_card_id", card.id).eq("status", "waiting_child_card").eq("runner_id", config.runnerId).maybeSingle();
+  if (error) {
+    logger.runner.error("WORKFLOW_SHELL", `Failed to look up a workflow execution waiting on card ${card.id}:`, error.message);
+    return;
+  }
+  const execution = data;
+  if (!execution) return;
+  const { data: lastComment } = await supabase.from("card_comments").select("body").eq("card_id", card.id).order("created_at", { ascending: false }).limit(1).maybeSingle();
+  const lastCommentBody = lastComment?.body ?? null;
+  const resumeText = viaCancellation ? `Card "${card.title}" (id: ${card.id}) foi CANCELADO/ARQUIVADO, n\xE3o conclu\xEDdo normalmente.
+
+Prossiga com o workflow a partir do passo seguinte, levando isso em conta.` : `Card "${card.title}" (id: ${card.id}) chegou em "deploy" \u2014 implementado, revisado e empacotado (o push final para "fim" \xE9 manual, fora do controle de qualquer agente).
+
+Resumo: "${lastCommentBody ?? "(nenhum coment\xE1rio encontrado no card)"}"
+
+Prossiga com o workflow a partir do passo seguinte.`;
+  let handle = getPtySession(execution.id);
+  if (!handle || handle.exited) {
+    const pty = reattachWorkflowShellPty(supabase, config, execution.id, execution.project_id, execution.claude_session_id, execution.shell_ticket);
+    if (!pty) {
+      logger.runner.error("WORKFLOW_SHELL", `Workflow execution ${execution.id} has no live pty and could not be reattached \u2014 cannot resume it with child card ${card.id}'s result.`);
+      return;
     }
-    const pty = resumeAgentPty(registered.repoPath, claudeSessionId, executionId, shellTicket);
-    registerPtySession(executionId, pty, shellTicket);
-    const activityWatcher = watchWorkflowShellActivity(supabase, executionId, pty);
-    pty.onExit(({ exitCode }) => {
-      activityWatcher.stop();
-      void handleWorkflowShellExit(supabase, executionId, exitCode);
-    });
-    logger.runner.info("WORKFLOW_SHELL", `Re-spawned orphaned workflow execution ${executionId} (runner restarted while it was still active).`);
+    handle = getPtySession(execution.id);
+  }
+  if (!handle) return;
+  const { error: resumeError } = await supabase.rpc("resume_workflow_execution_after_child_card", {
+    p_execution_id: execution.id,
+    p_child_card_id: card.id
+  });
+  if (resumeError) {
+    logger.runner.error("WORKFLOW_SHELL", `Failed to resume workflow execution ${execution.id} after child card ${card.id}:`, resumeError.message);
+    return;
+  }
+  try {
+    writePasteAndSubmit(handle.pty, execution.id, resumeText, "child card result", logger.runner);
+  } catch (err) {
+    logger.runner.error("WORKFLOW_SHELL", `Failed to send child card result to workflow execution ${execution.id}:`, err);
   }
 }
 
@@ -4510,8 +4577,12 @@ async function startRunner() {
       if (previousColumn === "revisao" && card.column_name !== "revisao") {
         releaseCard(card.id);
       }
+      if (previousColumn !== "deploy" && card.column_name === "deploy") {
+        void resumeWorkflowExecutionWaitingOnChildCard(supabase, config, card, { viaCancellation: false });
+      }
       if (card.column_name === "fim" && previousColumn !== "fim") {
         void handleCardReachedFim(supabase, config, card);
+        if (previousColumn !== "deploy") void resumeWorkflowExecutionWaitingOnChildCard(supabase, config, card, { viaCancellation: true });
       }
       const previousRequeueRequestedAt = lastKnownRequeueRequestedAt.get(card.id);
       lastKnownRequeueRequestedAt.set(card.id, card.requeue_requested_at);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-board-runner",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "Local runner for Agent Board — signs in with your own Supabase account (no shared secrets) and drives Claude Code against repos under your local repos root.",
   "type": "module",
   "bin": {