agent-board-runner 0.1.17 → 0.1.19

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 === "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 === "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;
@@ -372,6 +372,8 @@ var AgentActivityWatcher = class {
    * "waiting_user" — see the guard in reportHookMoment's "turn_stopped" case.
    */
   prototypeReviewPending = false;
+  /** Same shape as prototypeReviewPending, for ask_workflow_question (see docs/ai-knowledges/workflows-visuais-mecanismo.md). */
+  workflowAnswerPending = false;
   toolCallPending = false;
   commitDetected = false;
   timer;
@@ -414,6 +416,7 @@ var AgentActivityWatcher = class {
         this.usageLimited = false;
         this.planApprovalPending = false;
         this.prototypeReviewPending = false;
+        this.workflowAnswerPending = false;
         this.commitDetected = false;
         this.setState("implementing");
         break;
@@ -429,12 +432,17 @@ var AgentActivityWatcher = class {
         this.prototypeReviewPending = true;
         this.setState("waiting_prototype_review");
         break;
+      case "waiting_workflow_answer":
+        this.workflowAnswerPending = true;
+        this.setState("waiting_workflow_answer");
+        break;
       case "commit_detected":
         this.commitDetected = true;
         break;
       case "turn_stopped":
         if (this.usageLimited) break;
         if (this.prototypeReviewPending) break;
+        if (this.workflowAnswerPending) break;
         if (BACKGROUND_SHELL_PATTERN.test(this.recentOutput())) {
           this.setState("waiting_background");
           break;
@@ -1255,6 +1263,11 @@ function detectMoment(input) {
   // prototypeReviewPending latch in agentActivity.ts's reportHookMoment.
   if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__publish_prototype") return "waiting_prototype_review";
 
+  // Same shape as publish_prototype above, but for a workflow graph's "ask" node (see
+  // ask_workflow_question in boardTools.ts and docs/ai-knowledges/workflows-visuais-mecanismo.md)
+  // \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";
+
   // 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
@@ -2103,7 +2116,22 @@ function parseGitDiffNameStatus(output) {
     const columns = line.split("	");
     const status = columns[0].slice(0, 1);
     const path = columns[columns.length - 1];
-    return { path, status };
+    return { path, status, additions: null, deletions: null, binary: false };
+  });
+}
+function parseGitDiffNumstat(output) {
+  return output.split("\n").filter((line) => line.length > 0).map((line) => {
+    const [added, deleted, path] = line.split("	");
+    const binary = added === "-" && deleted === "-";
+    return { path, additions: binary ? null : Number(added), deletions: binary ? null : Number(deleted), binary };
+  });
+}
+function mergeNumstat(files, numstat) {
+  const byPath = new Map(numstat.map((entry) => [entry.path, entry]));
+  return files.map((file) => {
+    const stat = byPath.get(file.path);
+    if (!stat) return file;
+    return { ...file, additions: stat.additions, deletions: stat.deletions, binary: stat.binary };
   });
 }
 async function getRepoDiffForTarget(label, cwd) {
@@ -2137,14 +2165,84 @@ async function getRepoDiffForTarget(label, cwd) {
     files = parseGitDiffNameStatus(stdout);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    return { label, files: [], diff: "", error: message };
+    return { label, files: [], diff: "", branch, error: message };
+  }
+  if (files.length === 0) return { label, files, diff: "", branch };
+  try {
+    const { stdout: numstatOut } = await execFileAsync2("git", ["diff", "--numstat", remoteRef, "HEAD"], { ...DIFF_EXEC_OPTIONS, cwd });
+    files = mergeNumstat(files, parseGitDiffNumstat(numstatOut));
+  } catch {
   }
-  if (files.length === 0) return { label, files, diff: "" };
   try {
     const { stdout } = await execFileAsync2("git", ["diff", remoteRef, "HEAD"], { ...DIFF_EXEC_OPTIONS, cwd });
-    return { label, files, diff: stdout };
+    return { label, files, diff: stdout, branch };
   } catch {
-    return { label, files, diff: "" };
+    return { label, files, diff: "", branch };
+  }
+}
+async function resolveDiffTargetCwd(entry, projectId, label) {
+  if (!label) return entry.repoRoot;
+  if (!statuslineSupabase) throw new HttpError(400, "Reposit\xF3rio filho n\xE3o dispon\xEDvel.");
+  const children = await getProjectRepos(statuslineSupabase, projectId);
+  const child2 = children.find((candidate) => candidate.subpath === label);
+  if (!child2) throw new HttpError(400, "Reposit\xF3rio filho desconhecido.");
+  return join9(entry.repoRoot, child2.subpath);
+}
+async function readFileAtRevision(cwd, ref, relPath) {
+  try {
+    const { stdout } = await execFileAsync2("git", ["show", `${ref}:${relPath}`], {
+      cwd,
+      maxBuffer: DIFF_EXEC_OPTIONS.maxBuffer,
+      encoding: "buffer"
+    });
+    return stdout;
+  } catch {
+    return null;
+  }
+}
+function toFileRevisionJson(buffer, imageContentType) {
+  if (buffer === null) return { exists: false, content: null, binary: false };
+  if (looksBinary(buffer)) {
+    return {
+      exists: true,
+      content: null,
+      binary: true,
+      ...imageContentType ? { imageBase64: buffer.toString("base64"), imageContentType } : {}
+    };
+  }
+  return { exists: true, content: buffer.toString("utf8"), binary: false };
+}
+async function handleDiffFileRequest(entry, res, projectId, relPath, label) {
+  if (!relPath) {
+    sendJson(res, 400, { error: "Par\xE2metro path \xE9 obrigat\xF3rio." });
+    return;
+  }
+  try {
+    const cwd = await resolveDiffTargetCwd(entry, projectId, label);
+    resolveWithinRepo(cwd, relPath);
+    const { stdout: branchOut } = await execFileAsync2("git", ["branch", "--show-current"], { cwd });
+    const branch = branchOut.trim();
+    if (!branch) {
+      sendJson(res, 400, { error: "HEAD destacado: sem branch local para comparar com a origin." });
+      return;
+    }
+    const [originalBuffer, modifiedBuffer] = await Promise.all([
+      readFileAtRevision(cwd, `origin/${branch}`, relPath),
+      readFileAtRevision(cwd, "HEAD", relPath)
+    ]);
+    const ext = relPath.split(".").pop()?.toLowerCase() ?? "";
+    const imageContentType = MIME_TYPES_BY_EXT[ext];
+    sendJson(res, 200, {
+      original: toFileRevisionJson(originalBuffer, imageContentType),
+      modified: toFileRevisionJson(modifiedBuffer, imageContentType)
+    });
+  } catch (err) {
+    if (err instanceof HttpError) {
+      sendJson(res, err.status, { error: err.message });
+      return;
+    }
+    logger.runner.error("FILES", "Unexpected error handling a diff-file request:", err);
+    sendJson(res, 500, { error: "Erro interno do runner." });
   }
 }
 async function handleDiffRequest(entry, res, projectId) {
@@ -2329,6 +2427,12 @@ function handleRequest(req, res) {
     void handleDiffRequest(entry, res, projectId);
     return;
   }
+  if (pathname === "/diff-file") {
+    const projectId = typeof query.projectId === "string" ? query.projectId : "";
+    const label = typeof query.label === "string" ? query.label : null;
+    void handleDiffFileRequest(entry, res, projectId, relPath, label);
+    return;
+  }
   try {
     if (pathname === "/tree") {
       sendJson(res, 200, { entries: listDirectory(entry.repoRoot, relPath) });
@@ -2577,13 +2681,49 @@ function toSessionName(title) {
 // src/agentSession.ts
 var TUI_IDLE_MS = 1500;
 var TUI_READY_TIMEOUT_MS = 6e4;
-var SUBMIT_DELAY_MS = 150;
+var PASTE_SETTLE_MS = 200;
+var PASTE_SETTLE_TIMEOUT_MS = 5e3;
 var PASTE_START = "\x1B[200~";
 var PASTE_END = "\x1B[201~";
 var SHIFT_TAB = "\x1B[Z";
 var SHIFT_TAB_PRESSES_TO_PLAN_MODE = 4;
 var SHIFT_TAB_DELAY_MS = 400;
 var PLAN_MODE_INDICATOR = /plan mode on/i;
+function writePasteAndSubmit(pty, cardId, message, context) {
+  pty.write(`${PASTE_START}${message}${PASTE_END}`);
+  let settleTimer;
+  let ceilingTimer;
+  let dataSubscription;
+  let exitSubscription;
+  let submitted = false;
+  const submit = () => {
+    if (submitted) return;
+    submitted = true;
+    clearTimeout(settleTimer);
+    clearTimeout(ceilingTimer);
+    dataSubscription?.dispose();
+    exitSubscription?.dispose();
+    try {
+      pty.write("\r");
+    } catch (err) {
+      logger.card.error(cardId, `Failed to submit ${context} to the agent:`, err);
+    }
+  };
+  const cancel = () => {
+    submitted = true;
+    clearTimeout(settleTimer);
+    clearTimeout(ceilingTimer);
+    dataSubscription?.dispose();
+    exitSubscription?.dispose();
+  };
+  dataSubscription = pty.onData(() => {
+    clearTimeout(settleTimer);
+    settleTimer = setTimeout(submit, PASTE_SETTLE_MS);
+  });
+  settleTimer = setTimeout(submit, PASTE_SETTLE_MS);
+  ceilingTimer = setTimeout(submit, PASTE_SETTLE_TIMEOUT_MS);
+  exitSubscription = pty.onExit(cancel);
+}
 function spawnAgentPty(repoPath, cardId, cardTitle, instructions, sessionId, ticket, planFirst) {
   ensureDirTrusted(repoPath);
   ensureMcpServersTrusted(repoPath);
@@ -2627,14 +2767,7 @@ function sendMessageWhenIdle(pty, cardId, message, planFirst) {
     if (!stopWaiting()) return;
     if (planFirst) await enterPlanMode(pty, cardId);
     try {
-      pty.write(`${PASTE_START}${message}${PASTE_END}`);
-      setTimeout(() => {
-        try {
-          pty.write("\r");
-        } catch (err) {
-          logger.card.error(cardId, "Failed to submit the card instructions to the agent:", err);
-        }
-      }, SUBMIT_DELAY_MS);
+      writePasteAndSubmit(pty, cardId, message, "the card instructions");
     } catch (err) {
       logger.card.error(cardId, "Failed to send the card instructions to the agent:", err);
     }
@@ -2670,14 +2803,7 @@ async function enterPlanMode(pty, cardId) {
 }
 function sendMessageToIdleSession(pty, cardId, message) {
   try {
-    pty.write(`${PASTE_START}${message}${PASTE_END}`);
-    setTimeout(() => {
-      try {
-        pty.write("\r");
-      } catch (err) {
-        logger.card.error(cardId, "Failed to submit a message to the idle session:", err);
-      }
-    }, SUBMIT_DELAY_MS);
+    writePasteAndSubmit(pty, cardId, message, "a message");
   } catch (err) {
     logger.card.error(cardId, "Failed to send a message to the idle session:", err);
   }
@@ -3116,7 +3242,7 @@ async function dispatchRunnerQueue(supabase, config) {
     for (const project of config.registeredProjects) {
       const running = await getRunningSessionForProject(supabase, project.id, config.runnerId);
       if (!running) continue;
-      if ((running.agentState === "done" || running.agentState === "waiting_prototype_review") && queuedProjectIds.has(project.id)) {
+      if ((running.agentState === "done" || running.agentState === "waiting_prototype_review" || running.agentState === "waiting_workflow_answer") && queuedProjectIds.has(project.id)) {
         await pauseFinishedSession(supabase, config, project.id, running.cardId, running.id);
         continue;
       }
@@ -3181,6 +3307,14 @@ async function publishQueueSnapshots(supabase, config, queued, promotedCardIds)
 function buildPrototypeReviewFollowUp(prototypeApproved, prototypeUrl) {
   return prototypeApproved ? "O prot\xF3tipo foi revisado e aprovado \u2014 prossiga para a implementa\xE7\xE3o real, usando-o como refer\xEAncia." : `O prot\xF3tipo ainda n\xE3o foi aprovado${prototypeUrl ? ` (${prototypeUrl})` : ""} \u2014 confira os coment\xE1rios deixados nele (e, se for um prot\xF3tipo de marca\xE7\xE3o de pontos, os pontos salvos) e ajuste, publicando a nova vers\xE3o com publish_prototype. Depois, pare o turno de novo: a sess\xE3o ser\xE1 retomada quando houver outra revis\xE3o.`;
 }
+async function buildWorkflowAnswerFollowUp(supabase, cardId) {
+  const { data } = await supabase.from("card_workflow_questions").select("question, answer").eq("card_id", cardId).eq("status", "answered").order("answered_at", { ascending: false }).limit(1).maybeSingle();
+  if (!data) return "A pergunta foi respondida \u2014 confira os coment\xE1rios do card e prossiga.";
+  return `Pergunta: "${data.question}"
+Resposta do humano: "${data.answer}"
+
+Prossiga com o workflow a partir daqui.`;
+}
 async function promoteQueuedSession(supabase, config, entry) {
   const existingHandle = getPtySession(entry.id);
   if (existingHandle) {
@@ -3200,6 +3334,9 @@ async function promoteQueuedSession(supabase, config, entry) {
         buildPrototypeReviewFollowUp(entry.cards.prototype_approved, entry.cards.prototype_url)
       );
     }
+    if (entry.agent_state === "waiting_workflow_answer" && !existingHandle.exited) {
+      sendMessageToIdleSession(existingHandle.pty, entry.card_id, await buildWorkflowAnswerFollowUp(supabase, entry.card_id));
+    }
     return;
   }
   const spawned = await spawnSessionPty(supabase, config, entry);
@@ -3318,7 +3455,7 @@ function watchAgentActivity(supabase, config, projectId, cardId, sessionId, pty)
     } else {
       cancelUsageResume(sessionId);
     }
-    if (state === "done" || state === "waiting_prototype_review") void dispatchRunnerQueue(supabase, config);
+    if (state === "done" || state === "waiting_prototype_review" || state === "waiting_workflow_answer") void dispatchRunnerQueue(supabase, config);
   });
   pty.onData((chunk) => watcher.push(chunk));
   registerAgentActivityWatcher(sessionId, watcher);
@@ -3353,6 +3490,14 @@ async function requeuePausedCard(supabase, config, card) {
       logger.card.info(card.id, `Session ${active.id} was never paused (alone in its project) \u2014 sent the prototype review follow-up directly.`);
     }
   }
+  if (active.status === "running" && active.agentState === "waiting_workflow_answer") {
+    const handle = getPtySession(active.id);
+    await updateCard(supabase, card.id, { requeueRequestedAt: null });
+    if (handle && !handle.exited) {
+      sendMessageToIdleSession(handle.pty, card.id, await buildWorkflowAnswerFollowUp(supabase, card.id));
+      logger.card.info(card.id, `Session ${active.id} was never paused (alone in its project) \u2014 sent the workflow answer follow-up directly.`);
+    }
+  }
 }
 async function reconcileOrphanedSessions(supabase, config) {
   for (const project of config.registeredProjects) {

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 === "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 === "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;
@@ -92,6 +92,8 @@ var AgentActivityWatcher = class {
    * "waiting_user" — see the guard in reportHookMoment's "turn_stopped" case.
    */
   prototypeReviewPending = false;
+  /** Same shape as prototypeReviewPending, for ask_workflow_question (see docs/ai-knowledges/workflows-visuais-mecanismo.md). */
+  workflowAnswerPending = false;
   toolCallPending = false;
   commitDetected = false;
   timer;
@@ -134,6 +136,7 @@ var AgentActivityWatcher = class {
         this.usageLimited = false;
         this.planApprovalPending = false;
         this.prototypeReviewPending = false;
+        this.workflowAnswerPending = false;
         this.commitDetected = false;
         this.setState("implementing");
         break;
@@ -149,12 +152,17 @@ var AgentActivityWatcher = class {
         this.prototypeReviewPending = true;
         this.setState("waiting_prototype_review");
         break;
+      case "waiting_workflow_answer":
+        this.workflowAnswerPending = true;
+        this.setState("waiting_workflow_answer");
+        break;
       case "commit_detected":
         this.commitDetected = true;
         break;
       case "turn_stopped":
         if (this.usageLimited) break;
         if (this.prototypeReviewPending) break;
+        if (this.workflowAnswerPending) break;
         if (BACKGROUND_SHELL_PATTERN.test(this.recentOutput())) {
           this.setState("waiting_background");
           break;
@@ -975,6 +983,11 @@ function detectMoment(input) {
   // prototypeReviewPending latch in agentActivity.ts's reportHookMoment.
   if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__publish_prototype") return "waiting_prototype_review";
 
+  // Same shape as publish_prototype above, but for a workflow graph's "ask" node (see
+  // ask_workflow_question in boardTools.ts and docs/ai-knowledges/workflows-visuais-mecanismo.md)
+  // \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";
+
   // 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
@@ -1823,7 +1836,22 @@ function parseGitDiffNameStatus(output) {
     const columns = line.split("	");
     const status = columns[0].slice(0, 1);
     const path = columns[columns.length - 1];
-    return { path, status };
+    return { path, status, additions: null, deletions: null, binary: false };
+  });
+}
+function parseGitDiffNumstat(output) {
+  return output.split("\n").filter((line) => line.length > 0).map((line) => {
+    const [added, deleted, path] = line.split("	");
+    const binary = added === "-" && deleted === "-";
+    return { path, additions: binary ? null : Number(added), deletions: binary ? null : Number(deleted), binary };
+  });
+}
+function mergeNumstat(files, numstat) {
+  const byPath = new Map(numstat.map((entry) => [entry.path, entry]));
+  return files.map((file) => {
+    const stat = byPath.get(file.path);
+    if (!stat) return file;
+    return { ...file, additions: stat.additions, deletions: stat.deletions, binary: stat.binary };
   });
 }
 async function getRepoDiffForTarget(label, cwd) {
@@ -1857,14 +1885,84 @@ async function getRepoDiffForTarget(label, cwd) {
     files = parseGitDiffNameStatus(stdout);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
-    return { label, files: [], diff: "", error: message };
+    return { label, files: [], diff: "", branch, error: message };
+  }
+  if (files.length === 0) return { label, files, diff: "", branch };
+  try {
+    const { stdout: numstatOut } = await execFileAsync2("git", ["diff", "--numstat", remoteRef, "HEAD"], { ...DIFF_EXEC_OPTIONS, cwd });
+    files = mergeNumstat(files, parseGitDiffNumstat(numstatOut));
+  } catch {
   }
-  if (files.length === 0) return { label, files, diff: "" };
   try {
     const { stdout } = await execFileAsync2("git", ["diff", remoteRef, "HEAD"], { ...DIFF_EXEC_OPTIONS, cwd });
-    return { label, files, diff: stdout };
+    return { label, files, diff: stdout, branch };
   } catch {
-    return { label, files, diff: "" };
+    return { label, files, diff: "", branch };
+  }
+}
+async function resolveDiffTargetCwd(entry, projectId, label) {
+  if (!label) return entry.repoRoot;
+  if (!statuslineSupabase) throw new HttpError(400, "Reposit\xF3rio filho n\xE3o dispon\xEDvel.");
+  const children = await getProjectRepos(statuslineSupabase, projectId);
+  const child2 = children.find((candidate) => candidate.subpath === label);
+  if (!child2) throw new HttpError(400, "Reposit\xF3rio filho desconhecido.");
+  return join7(entry.repoRoot, child2.subpath);
+}
+async function readFileAtRevision(cwd, ref, relPath) {
+  try {
+    const { stdout } = await execFileAsync2("git", ["show", `${ref}:${relPath}`], {
+      cwd,
+      maxBuffer: DIFF_EXEC_OPTIONS.maxBuffer,
+      encoding: "buffer"
+    });
+    return stdout;
+  } catch {
+    return null;
+  }
+}
+function toFileRevisionJson(buffer, imageContentType) {
+  if (buffer === null) return { exists: false, content: null, binary: false };
+  if (looksBinary(buffer)) {
+    return {
+      exists: true,
+      content: null,
+      binary: true,
+      ...imageContentType ? { imageBase64: buffer.toString("base64"), imageContentType } : {}
+    };
+  }
+  return { exists: true, content: buffer.toString("utf8"), binary: false };
+}
+async function handleDiffFileRequest(entry, res, projectId, relPath, label) {
+  if (!relPath) {
+    sendJson(res, 400, { error: "Par\xE2metro path \xE9 obrigat\xF3rio." });
+    return;
+  }
+  try {
+    const cwd = await resolveDiffTargetCwd(entry, projectId, label);
+    resolveWithinRepo(cwd, relPath);
+    const { stdout: branchOut } = await execFileAsync2("git", ["branch", "--show-current"], { cwd });
+    const branch = branchOut.trim();
+    if (!branch) {
+      sendJson(res, 400, { error: "HEAD destacado: sem branch local para comparar com a origin." });
+      return;
+    }
+    const [originalBuffer, modifiedBuffer] = await Promise.all([
+      readFileAtRevision(cwd, `origin/${branch}`, relPath),
+      readFileAtRevision(cwd, "HEAD", relPath)
+    ]);
+    const ext = relPath.split(".").pop()?.toLowerCase() ?? "";
+    const imageContentType = MIME_TYPES_BY_EXT[ext];
+    sendJson(res, 200, {
+      original: toFileRevisionJson(originalBuffer, imageContentType),
+      modified: toFileRevisionJson(modifiedBuffer, imageContentType)
+    });
+  } catch (err) {
+    if (err instanceof HttpError) {
+      sendJson(res, err.status, { error: err.message });
+      return;
+    }
+    logger.runner.error("FILES", "Unexpected error handling a diff-file request:", err);
+    sendJson(res, 500, { error: "Erro interno do runner." });
   }
 }
 async function handleDiffRequest(entry, res, projectId) {
@@ -2049,6 +2147,12 @@ function handleRequest(req, res) {
     void handleDiffRequest(entry, res, projectId);
     return;
   }
+  if (pathname === "/diff-file") {
+    const projectId = typeof query.projectId === "string" ? query.projectId : "";
+    const label = typeof query.label === "string" ? query.label : null;
+    void handleDiffFileRequest(entry, res, projectId, relPath, label);
+    return;
+  }
   try {
     if (pathname === "/tree") {
       sendJson(res, 200, { entries: listDirectory(entry.repoRoot, relPath) });
@@ -2465,13 +2569,49 @@ function toSessionName(title) {
 // src/agentSession.ts
 var TUI_IDLE_MS = 1500;
 var TUI_READY_TIMEOUT_MS = 6e4;
-var SUBMIT_DELAY_MS = 150;
+var PASTE_SETTLE_MS = 200;
+var PASTE_SETTLE_TIMEOUT_MS = 5e3;
 var PASTE_START = "\x1B[200~";
 var PASTE_END = "\x1B[201~";
 var SHIFT_TAB = "\x1B[Z";
 var SHIFT_TAB_PRESSES_TO_PLAN_MODE = 4;
 var SHIFT_TAB_DELAY_MS = 400;
 var PLAN_MODE_INDICATOR = /plan mode on/i;
+function writePasteAndSubmit(pty, cardId, message, context) {
+  pty.write(`${PASTE_START}${message}${PASTE_END}`);
+  let settleTimer;
+  let ceilingTimer;
+  let dataSubscription;
+  let exitSubscription;
+  let submitted = false;
+  const submit = () => {
+    if (submitted) return;
+    submitted = true;
+    clearTimeout(settleTimer);
+    clearTimeout(ceilingTimer);
+    dataSubscription?.dispose();
+    exitSubscription?.dispose();
+    try {
+      pty.write("\r");
+    } catch (err) {
+      logger.card.error(cardId, `Failed to submit ${context} to the agent:`, err);
+    }
+  };
+  const cancel = () => {
+    submitted = true;
+    clearTimeout(settleTimer);
+    clearTimeout(ceilingTimer);
+    dataSubscription?.dispose();
+    exitSubscription?.dispose();
+  };
+  dataSubscription = pty.onData(() => {
+    clearTimeout(settleTimer);
+    settleTimer = setTimeout(submit, PASTE_SETTLE_MS);
+  });
+  settleTimer = setTimeout(submit, PASTE_SETTLE_MS);
+  ceilingTimer = setTimeout(submit, PASTE_SETTLE_TIMEOUT_MS);
+  exitSubscription = pty.onExit(cancel);
+}
 function spawnAgentPty(repoPath, cardId, cardTitle, instructions, sessionId, ticket, planFirst) {
   ensureDirTrusted(repoPath);
   ensureMcpServersTrusted(repoPath);
@@ -2515,14 +2655,7 @@ function sendMessageWhenIdle(pty, cardId, message, planFirst) {
     if (!stopWaiting()) return;
     if (planFirst) await enterPlanMode(pty, cardId);
     try {
-      pty.write(`${PASTE_START}${message}${PASTE_END}`);
-      setTimeout(() => {
-        try {
-          pty.write("\r");
-        } catch (err) {
-          logger.card.error(cardId, "Failed to submit the card instructions to the agent:", err);
-        }
-      }, SUBMIT_DELAY_MS);
+      writePasteAndSubmit(pty, cardId, message, "the card instructions");
     } catch (err) {
       logger.card.error(cardId, "Failed to send the card instructions to the agent:", err);
     }
@@ -2558,14 +2691,7 @@ async function enterPlanMode(pty, cardId) {
 }
 function sendMessageToIdleSession(pty, cardId, message) {
   try {
-    pty.write(`${PASTE_START}${message}${PASTE_END}`);
-    setTimeout(() => {
-      try {
-        pty.write("\r");
-      } catch (err) {
-        logger.card.error(cardId, "Failed to submit a message to the idle session:", err);
-      }
-    }, SUBMIT_DELAY_MS);
+    writePasteAndSubmit(pty, cardId, message, "a message");
   } catch (err) {
     logger.card.error(cardId, "Failed to send a message to the idle session:", err);
   }
@@ -3004,7 +3130,7 @@ async function dispatchRunnerQueue(supabase, config) {
     for (const project of config.registeredProjects) {
       const running = await getRunningSessionForProject(supabase, project.id, config.runnerId);
       if (!running) continue;
-      if ((running.agentState === "done" || running.agentState === "waiting_prototype_review") && queuedProjectIds.has(project.id)) {
+      if ((running.agentState === "done" || running.agentState === "waiting_prototype_review" || running.agentState === "waiting_workflow_answer") && queuedProjectIds.has(project.id)) {
         await pauseFinishedSession(supabase, config, project.id, running.cardId, running.id);
         continue;
       }
@@ -3069,6 +3195,14 @@ async function publishQueueSnapshots(supabase, config, queued, promotedCardIds)
 function buildPrototypeReviewFollowUp(prototypeApproved, prototypeUrl) {
   return prototypeApproved ? "O prot\xF3tipo foi revisado e aprovado \u2014 prossiga para a implementa\xE7\xE3o real, usando-o como refer\xEAncia." : `O prot\xF3tipo ainda n\xE3o foi aprovado${prototypeUrl ? ` (${prototypeUrl})` : ""} \u2014 confira os coment\xE1rios deixados nele (e, se for um prot\xF3tipo de marca\xE7\xE3o de pontos, os pontos salvos) e ajuste, publicando a nova vers\xE3o com publish_prototype. Depois, pare o turno de novo: a sess\xE3o ser\xE1 retomada quando houver outra revis\xE3o.`;
 }
+async function buildWorkflowAnswerFollowUp(supabase, cardId) {
+  const { data } = await supabase.from("card_workflow_questions").select("question, answer").eq("card_id", cardId).eq("status", "answered").order("answered_at", { ascending: false }).limit(1).maybeSingle();
+  if (!data) return "A pergunta foi respondida \u2014 confira os coment\xE1rios do card e prossiga.";
+  return `Pergunta: "${data.question}"
+Resposta do humano: "${data.answer}"
+
+Prossiga com o workflow a partir daqui.`;
+}
 async function promoteQueuedSession(supabase, config, entry) {
   const existingHandle = getPtySession(entry.id);
   if (existingHandle) {
@@ -3088,6 +3222,9 @@ async function promoteQueuedSession(supabase, config, entry) {
         buildPrototypeReviewFollowUp(entry.cards.prototype_approved, entry.cards.prototype_url)
       );
     }
+    if (entry.agent_state === "waiting_workflow_answer" && !existingHandle.exited) {
+      sendMessageToIdleSession(existingHandle.pty, entry.card_id, await buildWorkflowAnswerFollowUp(supabase, entry.card_id));
+    }
     return;
   }
   const spawned = await spawnSessionPty(supabase, config, entry);
@@ -3206,7 +3343,7 @@ function watchAgentActivity(supabase, config, projectId, cardId, sessionId, pty)
     } else {
       cancelUsageResume(sessionId);
     }
-    if (state === "done" || state === "waiting_prototype_review") void dispatchRunnerQueue(supabase, config);
+    if (state === "done" || state === "waiting_prototype_review" || state === "waiting_workflow_answer") void dispatchRunnerQueue(supabase, config);
   });
   pty.onData((chunk) => watcher.push(chunk));
   registerAgentActivityWatcher(sessionId, watcher);
@@ -3241,6 +3378,14 @@ async function requeuePausedCard(supabase, config, card) {
       logger.card.info(card.id, `Session ${active.id} was never paused (alone in its project) \u2014 sent the prototype review follow-up directly.`);
     }
   }
+  if (active.status === "running" && active.agentState === "waiting_workflow_answer") {
+    const handle = getPtySession(active.id);
+    await updateCard(supabase, card.id, { requeueRequestedAt: null });
+    if (handle && !handle.exited) {
+      sendMessageToIdleSession(handle.pty, card.id, await buildWorkflowAnswerFollowUp(supabase, card.id));
+      logger.card.info(card.id, `Session ${active.id} was never paused (alone in its project) \u2014 sent the workflow answer follow-up directly.`);
+    }
+  }
 }
 async function reconcileOrphanedSessions(supabase, config) {
   for (const project of config.registeredProjects) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-board-runner",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "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": {