larkway 0.3.43 → 0.3.44

package/README.md

@@ -8,7 +8,7 @@
 
 You @ the bot in a Feishu thread. It runs on your machine — reading your real codebase, executing commands, opening MRs — and posts the result back. You define what the agent knows and what it can do. Larkway just carries the messages.
 
-**Current release: v0.3.43**
+**Current release: v0.3.44**
 
 ---
 

package/README.zh.md

@@ -8,7 +8,7 @@
 
 你在飞书话题里 @ bot，它在你的机器上运行——读真实代码库、执行命令、开 MR——把结果贴回飞书。你定义 agent 知道什么、能做什么。Larkway 只负责传递消息。
 
-**当前版本：v0.3.43**
+**当前版本：v0.3.44**
 
 ---
 

package/dist/cli/index.js

@@ -112530,6 +112530,11 @@ var init_messageLookupClient = __esm({
           const cached = this.#cache.get(messageId);
           if (cached) return cached;
         }
+        const first = await this.#getOnce(messageId);
+        if (first) return first;
+        return this.#getOnce(messageId);
+      }
+      async #getOnce(messageId) {
         try {
           const channel = this.#resolveChannel();
           if (!channel) return void 0;

package/dist/main.js

@@ -116684,6 +116684,11 @@ var ChannelMessageLookupClient = class {
       const cached = this.#cache.get(messageId);
       if (cached) return cached;
     }
+    const first = await this.#getOnce(messageId);
+    if (first) return first;
+    return this.#getOnce(messageId);
+  }
+  async #getOnce(messageId) {
     try {
       const channel = this.#resolveChannel();
       if (!channel) return void 0;
@@ -119225,12 +119230,18 @@ function renderTaskRootBlock(taskRoot) {
     `task_root_claimed: ${taskRoot.claimed ? "yes" : "no"}`
   ];
   if (taskRoot.claimed) {
-    lines.push(
-      "\u672C\u8BDD\u9898\u5DF2\u8BA4\u9886\u8FD9\u4E2A\u4EFB\u52A1\u3002\u7EF4\u62A4\u9762\u53EA\u6709\u4EFB\u52A1\u8BC4\u8BBA:\u4EC5\u5728\u4EA4\u4ED8/\u5931\u8D25/\u7B49\u62CD\u677F\u4E09\u7C7B\u91CC\u7A0B\u7891\u8282\u70B9\u53D1\u4EFB\u52A1\u8BC4\u8BBA(lark-cli task comments create);\u771F\u6B63\u4EA4\u4ED8\u7684\u90A3\u4E00\u8F6E\u5728 state.json \u7684 task_handle \u91CC\u58F0\u660E done: true,\u5E76\u53D1\u4E00\u6761\u300C\u5DF2\u4EA4\u4ED8,\u770B\u8FC7\u8BF7\u70B9\u5B8C\u6210\u300D\u8BC4\u8BBA\u3002\u4E0D\u8981\u4FEE\u6539\u4EFB\u52A1\u63CF\u8FF0\u3001\u4E0D\u8981\u52FE\u5B8C\u6210/reopen\u2014\u2014\u5B8C\u6210\u6C38\u8FDC\u7531\u4EBA\u5728\u4EFB\u52A1\u4E2D\u5FC3\u70B9\u3002"
-    );
+    if (taskRoot.justClaimed) {
+      lines.push(
+        `bridge \u5DF2\u81EA\u52A8\u8BA4\u9886\u8FD9\u4E2A\u4EFB\u52A1(\u673A\u68B0\u7ED1\u5B9A,\u4E0D\u9700\u8981\u4F60\u518D\u5199 state.json \u8BA4\u9886),\u4F46**\u8BA4\u9886\u8BC4\u8BBA\u8FD8\u6B20\u7740**\u3002\u672C\u8F6E\u8BF7:\u2460 \u5148\u8BFB\u4E00\u904D\u8BE5\u4EFB\u52A1\u7684\u73B0\u6709\u8BC4\u8BBA(lark-cli task comments list)\u2014\u2014\u5DF2\u6709**\u5176\u4ED6 agent** \u7684\u8BA4\u9886\u58F0\u660E\u8BF4\u660E\u5BF9\u65B9\u5DF2\u63A5\u624B,\u4E0D\u8981\u518D\u53D1\u8BA4\u9886\u8BC4\u8BBA(\u91CD\u590D\u8BC4\u8BBA=\u9A9A\u6270),\u914D\u5408\u5E72\u6D3B\u5373\u53EF;\u2461 \u8BC4\u8BBA\u533A\u6CA1\u6709\u522B\u4EBA\u8BA4\u9886 \u2192 \u53D1\u4E00\u6761**\u8BA4\u9886\u8BC4\u8BBA**(lark-cli task comments create):\u4E00\u53E5\u8BA4\u9886\u58F0\u660E${taskRoot.topicLink ? " + \u4E0A\u9762\u7684 topic_link(\u7528\u6237\u70B9\u5B83\u76F4\u8FBE\u672C\u8BDD\u9898\u2014\u2014\u4EFB\u52A1\u2192\u8BDD\u9898\u552F\u4E00\u56DE\u8DF3,\u522B\u7701\u7565)" : ""};\u2462 \u6B63\u5E38\u5E72\u6D3B(\u4EFB\u52A1\u6807\u9898/\u63CF\u8FF0\u5C31\u662F\u9700\u6C42)\u3002\u4E4B\u540E\u7EF4\u62A4\u9762\u53EA\u6709\u4EFB\u52A1\u8BC4\u8BBA(\u4EA4\u4ED8/\u5931\u8D25/\u7B49\u62CD\u677F\u624D\u53D1,\u8FC7\u7A0B\u788E\u788E\u5FF5\u4E0D\u53D1);\u771F\u6B63\u4EA4\u4ED8\u7684\u90A3\u4E00\u8F6E\u5728 state.json \u7684 task_handle \u91CC\u58F0\u660E done: true \u5E76\u53D1\u300C\u5DF2\u4EA4\u4ED8,\u770B\u8FC7\u8BF7\u70B9\u5B8C\u6210\u300D\u8BC4\u8BBA\u3002\u4E0D\u8981\u4FEE\u6539\u4EFB\u52A1\u63CF\u8FF0\u3001\u4E0D\u8981\u52FE\u5B8C\u6210/reopen\u2014\u2014\u5B8C\u6210\u6C38\u8FDC\u7531\u4EBA\u5728\u4EFB\u52A1\u4E2D\u5FC3\u70B9\u3002`
+      );
+    } else {
+      lines.push(
+        "\u672C\u8BDD\u9898\u5DF2\u8BA4\u9886\u8FD9\u4E2A\u4EFB\u52A1\u3002\u7EF4\u62A4\u9762\u53EA\u6709\u4EFB\u52A1\u8BC4\u8BBA:\u4EC5\u5728\u4EA4\u4ED8/\u5931\u8D25/\u7B49\u62CD\u677F\u4E09\u7C7B\u91CC\u7A0B\u7891\u8282\u70B9\u53D1\u4EFB\u52A1\u8BC4\u8BBA(lark-cli task comments create);\u771F\u6B63\u4EA4\u4ED8\u7684\u90A3\u4E00\u8F6E\u5728 state.json \u7684 task_handle \u91CC\u58F0\u660E done: true,\u5E76\u53D1\u4E00\u6761\u300C\u5DF2\u4EA4\u4ED8,\u770B\u8FC7\u8BF7\u70B9\u5B8C\u6210\u300D\u8BC4\u8BBA\u3002\u4E0D\u8981\u4FEE\u6539\u4EFB\u52A1\u63CF\u8FF0\u3001\u4E0D\u8981\u52FE\u5B8C\u6210/reopen\u2014\u2014\u5B8C\u6210\u6C38\u8FDC\u7531\u4EBA\u5728\u4EFB\u52A1\u4E2D\u5FC3\u70B9\u3002"
+      );
+    }
   } else {
     lines.push(
-      `\u672C\u8F6E\u8BF7\u987A\u5E26\u9759\u9ED8\u8BA4\u9886,\u5206\u4E24\u6B65:\u2460 \u5148\u8BFB\u4E00\u904D\u8BE5\u4EFB\u52A1\u7684\u73B0\u6709\u8BC4\u8BBA(lark-cli task comments list)\u2014\u2014\u5982\u679C\u5DF2\u6709**\u5176\u4ED6 agent** \u7684\u8BA4\u9886\u58F0\u660E,\u8BF4\u660E\u540C\u8BDD\u9898\u7684\u53E6\u4E00\u4E2A bot \u5DF2\u63A5\u624B,\u672C\u8F6E\u4E0D\u8BA4\u9886\u3001\u4E0D\u58F0\u5F20\u3001\u6B63\u5E38\u56DE\u7B54\u5373\u53EF(\u53CC @ \u7ADE\u6001\u62A4\u680F:\u91CD\u590D\u8BA4\u9886 = \u53CC\u4EFD\u7EF4\u62A4 + \u53CC\u4EFD\u5DE1\u68C0\u9A9A\u6270);\u2461 \u6CA1\u6709\u522B\u4EBA\u8BA4\u9886 \u2192 \u628A\u4E0A\u9762\u7684 task_guid \u5199\u5165 state.json \u7684 task_handle.guid,\u5E76\u53D1\u4E00\u6761\u8BA4\u9886\u8BC4\u8BBA(lark-cli task comments create),\u5185\u5BB9 = \u4E00\u53E5\u8BA4\u9886\u58F0\u660E${taskRoot.topicLink ? " + \u4E0A\u9762\u7684 topic_link(\u7528\u6237\u70B9\u5B83\u76F4\u8FBE\u672C\u8BDD\u9898)" : ""}\u3002\u4E4B\u540E\u7EF4\u62A4\u9762\u53EA\u6709\u4EFB\u52A1\u8BC4\u8BBA(\u4EA4\u4ED8/\u5931\u8D25/\u7B49\u62CD\u677F\u624D\u53D1,\u8FC7\u7A0B\u788E\u788E\u5FF5\u4E0D\u53D1);\u4E0D\u8981\u4FEE\u6539\u4EFB\u52A1\u63CF\u8FF0\u3001\u4E0D\u8981\u52FE\u5B8C\u6210\u2014\u2014\u5B8C\u6210\u6C38\u8FDC\u7531\u4EBA\u70B9\u3002`
+      `bridge \u672A\u80FD\u81EA\u52A8\u8BA4\u9886\u8FD9\u4E2A\u4EFB\u52A1\u2014\u2014\u6700\u5E38\u89C1\u7684\u539F\u56E0\u662F\u5B83\u5DF2\u88AB**\u53E6\u4E00\u4E2A\u8BDD\u9898\u6216\u53E6\u4E00\u4E2A agent** \u8BA4\u9886(\u673A\u68B0\u5B88\u536B\u62D2\u7EDD\u91CD\u590D\u8BA4\u9886),\u4E5F\u53EF\u80FD\u662F\u8BA4\u9886\u901A\u9053\u672A\u63A5\u5165\u3002\u672C\u8F6E\u8BF7:\u2460 \u5148\u8BFB\u4E00\u904D\u8BE5\u4EFB\u52A1\u7684\u73B0\u6709\u8BC4\u8BBA(lark-cli task comments list)\u2014\u2014\u5DF2\u6709\u5176\u4ED6 agent \u7684\u8BA4\u9886\u58F0\u660E \u2192 \u5BF9\u65B9\u5DF2\u63A5\u624B,\u4F60\u53EA\u662F\u88AB\u53EB\u6765\u534F\u4F5C:\u5E72\u597D\u88AB @ \u6765\u505A\u7684\u4E8B,\u4E0D\u8981\u8BA4\u9886\u3001\u4E0D\u8981\u91CD\u590D\u53D1\u8BA4\u9886\u8BC4\u8BBA;\u2461 \u8BC4\u8BBA\u533A\u6CA1\u6709\u4EFB\u4F55\u8BA4\u9886\u3001\u4E14\u4F60\u5224\u65AD\u8BE5\u7531\u4F60\u63A5\u624B \u2192 \u628A\u4E0A\u9762\u7684 task_guid \u5199\u5165 state.json \u7684 task_handle.guid,\u5E76\u53D1\u4E00\u6761\u8BA4\u9886\u8BC4\u8BBA(lark-cli task comments create),\u5185\u5BB9 = \u4E00\u53E5\u8BA4\u9886\u58F0\u660E${taskRoot.topicLink ? " + \u4E0A\u9762\u7684 topic_link(\u7528\u6237\u70B9\u5B83\u76F4\u8FBE\u672C\u8BDD\u9898)" : ""}\u3002\u4E4B\u540E\u7EF4\u62A4\u9762\u53EA\u6709\u4EFB\u52A1\u8BC4\u8BBA(\u4EA4\u4ED8/\u5931\u8D25/\u7B49\u62CD\u677F\u624D\u53D1,\u8FC7\u7A0B\u788E\u788E\u5FF5\u4E0D\u53D1);\u4E0D\u8981\u4FEE\u6539\u4EFB\u52A1\u63CF\u8FF0\u3001\u4E0D\u8981\u52FE\u5B8C\u6210\u2014\u2014\u5B8C\u6210\u6C38\u8FDC\u7531\u4EBA\u70B9\u3002`
     );
   }
   lines.push("</task-root>");
@@ -122447,6 +122458,15 @@ var BridgeHandler = class {
    * broken handoff and fire a spurious nudge. Read via getThreadReceivedAt().
    */
   threadReceivedAt = /* @__PURE__ */ new Map();
+  /**
+   * v4.2 (docs/task-handle.md §13 revision 5): per-thread OUTCOME of the most
+   * recent finished turn ("completed" | "failed"), recorded at finalize.
+   * StallDetector reads a PEER handler's map via getThreadLastOutcome to tell
+   * "the peer finished successfully" apart from "the peer crashed" — a failed
+   * finish must NOT resolve a handoff. In-memory like threadReceivedAt (empty
+   * after restart → detector falls back to its documented restart posture).
+   */
+  threadLastOutcome = /* @__PURE__ */ new Map();
   constructor(deps) {
     this.deps = deps;
   }
@@ -122459,6 +122479,10 @@ var BridgeHandler = class {
    * — callers must apply their own startup quiet-period before treating that
    * as evidence of a truly broken handoff.
    */
+  /** v4.2 — see threadLastOutcome's field doc. */
+  getThreadLastOutcome(threadId) {
+    return this.threadLastOutcome.get(threadId);
+  }
   getThreadReceivedAt(threadId) {
     return this.threadReceivedAt.get(threadId);
   }
@@ -122625,7 +122649,33 @@ var BridgeHandler = class {
       const eventStartedAt = Date.now();
       let taskRootInfo;
       let taskCardAnchorId;
+      let taskRootJustClaimed = false;
       let deferredTaskRootProbe;
+      const autoClaimTaskRoot = async (guid) => {
+        if (!this.deps.taskHandleClaim || !botId) return;
+        const alreadyThis = this.deps.taskHandleClaimGuidLookup?.(threadId) === guid;
+        if (alreadyThis) return;
+        if (this.deps.taskGuidClaimedByOtherBot?.(guid)) return;
+        try {
+          await this.deps.taskHandleClaim({
+            botId,
+            threadId,
+            chatId: parsed.chatId,
+            taskGuid: guid,
+            mode: "comment",
+            // Round-2 fix: the mechanical auto-claim must never REPLACE an
+            // existing different-guid claim on this thread (same charter as the
+            // v3 auto-bind guard) — only the agent's own re-declaration may.
+            onlyIfThreadUnclaimed: true,
+            // Round-2 fix: persist "claim comment still owed" so a first-turn
+            // crash after the claim doesn't lose the task→topic backlink.
+            claimCommentPending: true
+          });
+          taskRootJustClaimed = this.deps.taskHandleClaimGuidLookup ? this.deps.taskHandleClaimGuidLookup(threadId) === guid : true;
+        } catch (err) {
+          console.warn("[bridge.handler] task-root auto-claim failed (continuing):", err);
+        }
+      };
       {
         const realTopic = realTopicThreadId(parsed.raw.thread_id);
         const rootCandidate = (typeof parsed.raw.root_id === "string" && parsed.raw.root_id ? parsed.raw.root_id : void 0) ?? (typeof parsed.raw.parent_id === "string" && parsed.raw.parent_id ? parsed.raw.parent_id : void 0);
@@ -122646,6 +122696,7 @@ var BridgeHandler = class {
                 };
                 taskCardAnchorId = rootCandidate;
                 threadId = rootCandidate;
+                await autoClaimTaskRoot(todo.taskGuid);
               }
             }
           }
@@ -123185,6 +123236,7 @@ var BridgeHandler = class {
                   summary: todo.summaryText,
                   topicLink: rawThreadId ? buildTopicDeepLink(parsed.chatId, rawThreadId) : probeThreadId ? buildTopicDeepLink(parsed.chatId, probeThreadId) : void 0
                 };
+                await autoClaimTaskRoot(todo.taskGuid);
               }
             }
           }
@@ -123232,7 +123284,8 @@ var BridgeHandler = class {
               // Exact-guid comparison (see taskHandleClaimGuidLookup's doc);
               // falls back to the boolean lookup only when the precise one
               // isn't wired (older embedding code).
-              claimed: this.deps.taskHandleClaimGuidLookup ? this.deps.taskHandleClaimGuidLookup(threadId) === taskRootInfo.guid : this.deps.taskHandleClaimedLookup?.(threadId) ?? false
+              claimed: this.deps.taskHandleClaimGuidLookup ? this.deps.taskHandleClaimGuidLookup(threadId) === taskRootInfo.guid : this.deps.taskHandleClaimedLookup?.(threadId) ?? false,
+              justClaimed: taskRootJustClaimed || this.deps.taskHandleClaimCommentPending?.(threadId) || void 0
             } : void 0,
             mtimeFacts
           });
@@ -123417,6 +123470,7 @@ var BridgeHandler = class {
                 reason: failureReason
               });
             }
+            this.threadLastOutcome.set(threadId, success ? "completed" : "failed");
             const stuckResetAfter = resolveStuckSessionResetAfter();
             const prevStuckCount = currentExisting?.consecutiveStuckCount ?? 0;
             const nextStuckCount = cardKitTimeoutFailure ? prevStuckCount + 1 : success ? 0 : prevStuckCount;
@@ -123661,6 +123715,7 @@ var BridgeHandler = class {
         }
       } catch (err) {
         console.error("[bridge.handler] handleOne failed for thread", threadId, err);
+        this.threadLastOutcome.set(threadId, "failed");
         cotTurnOutcome = "error";
         if (cotPublisher) {
           void cotPublisher.finalize("error", { message: String(err) }).catch(() => {
@@ -130482,7 +130537,7 @@ function isStallNudgeState(value) {
 function isTaskHandleRecord(value) {
   if (typeof value !== "object" || value === null) return false;
   const v = value;
-  return typeof v["threadId"] === "string" && typeof v["taskGuid"] === "string" && typeof v["chatId"] === "string" && typeof v["claimedTs"] === "number" && (v["lastSeenCommentId"] === void 0 || typeof v["lastSeenCommentId"] === "string") && (v["lastTurnOutcome"] === void 0 || v["lastTurnOutcome"] === "completed" || v["lastTurnOutcome"] === "failed") && (v["stallNudge"] === void 0 || isStallNudgeState(v["stallNudge"])) && (v["stallSuppressUntilActivityAfter"] === void 0 || typeof v["stallSuppressUntilActivityAfter"] === "number") && (v["lastTurnMentions"] === void 0 || Array.isArray(v["lastTurnMentions"]) && v["lastTurnMentions"].every((m) => typeof m === "string")) && (v["lastTurnMentionsAt"] === void 0 || typeof v["lastTurnMentionsAt"] === "number") && (v["mode"] === void 0 || v["mode"] === "comment") && (v["doneDeclared"] === void 0 || typeof v["doneDeclared"] === "boolean");
+  return typeof v["threadId"] === "string" && typeof v["taskGuid"] === "string" && typeof v["chatId"] === "string" && typeof v["claimedTs"] === "number" && (v["lastSeenCommentId"] === void 0 || typeof v["lastSeenCommentId"] === "string") && (v["lastTurnOutcome"] === void 0 || v["lastTurnOutcome"] === "completed" || v["lastTurnOutcome"] === "failed") && (v["stallNudge"] === void 0 || isStallNudgeState(v["stallNudge"])) && (v["stallSuppressUntilActivityAfter"] === void 0 || typeof v["stallSuppressUntilActivityAfter"] === "number") && (v["lastTurnMentions"] === void 0 || Array.isArray(v["lastTurnMentions"]) && v["lastTurnMentions"].every((m) => typeof m === "string")) && (v["lastTurnMentionsAt"] === void 0 || typeof v["lastTurnMentionsAt"] === "number") && (v["mode"] === void 0 || v["mode"] === "comment") && (v["doneDeclared"] === void 0 || typeof v["doneDeclared"] === "boolean") && (v["claimCommentPending"] === void 0 || typeof v["claimCommentPending"] === "boolean");
 }
 var TaskHandleStore = class _TaskHandleStore {
   #filePath;
@@ -130698,7 +130753,8 @@ var TaskHandleStore = class _TaskHandleStore {
         taskGuid: input.taskGuid,
         chatId: input.chatId,
         claimedTs: Date.now(),
-        ...input.mode ? { mode: input.mode } : {}
+        ...input.mode ? { mode: input.mode } : {},
+        ...input.claimCommentPending ? { claimCommentPending: true } : {}
       };
     });
     return { claimed, reason };
@@ -131178,7 +131234,11 @@ async function applyTaskHandleWriteback(patch, deps) {
               // Agent declared delivery — its own "已交付" comment is the
               // user-facing artifact; bridge just stops patrolling the
               // "delivered, human hasn't ticked complete yet" window.
-              ...patch.agentDeclaredDone === true ? { doneDeclared: true } : {}
+              ...patch.agentDeclaredDone === true ? { doneDeclared: true } : {},
+              // v4.2 round-2: a successfully completed turn ran under a
+              // <task-root> that instructed the claim comment — consider
+              // the backlink posted; only crashed turns keep it owed.
+              claimCommentPending: void 0
             } : current
           );
           break;
@@ -131827,10 +131887,11 @@ var CandidateAlertStore = class _CandidateAlertStore {
 // src/tasklist/stallDetector.ts
 var DEFAULT_INTERVAL_MS3 = 6e4;
 var DEFAULT_JITTER_MS3 = 1e4;
-var DEFAULT_STALL_THRESHOLD_MS = 24 * 60 * 6e4;
+var DEFAULT_STALL_THRESHOLD_MS = 60 * 6e4;
 var DEFAULT_STALL_FAST_THRESHOLD_MS = 30 * 6e4;
 var DEFAULT_STALL_HANDOFF_THRESHOLD_MS = 5 * 6e4;
-var DEFAULT_NUDGE_COOLDOWN_MS = 24 * 60 * 6e4;
+var DEFAULT_NUDGE_COOLDOWN_MS = 60 * 6e4;
+var DUE_NUDGE_COOLDOWN_FLOOR_MS = 24 * 60 * 6e4;
 var DEFAULT_ESCALATE_AFTER_NUDGES = 2;
 var DEFAULT_PENDING_CONFIRM_TIMEOUT_MS = 30 * 6e4;
 var DEFAULT_HANDOFF_STARTUP_QUIET_MS = 6 * 6e4;
@@ -132009,7 +132070,7 @@ var StallDetector = class {
     const { ms: threshold, reason } = this.#effectiveThreshold(record, threadId);
     if (!nudge || nudge.count === 0) {
       if (now - lastActiveTs < threshold) return;
-      if (reason === "due" && !justClearedPendingTimeout && nudge?.lastNudgeSentAt !== void 0 && now - nudge.lastNudgeSentAt < this.#nudgeCooldownMs) {
+      if (reason === "due" && !justClearedPendingTimeout && nudge?.lastNudgeSentAt !== void 0 && now - nudge.lastNudgeSentAt < this.#cooldownFor(reason)) {
         return;
       }
       await this.#sendNudge(threadId);
@@ -132034,7 +132095,7 @@ var StallDetector = class {
       });
       return;
     }
-    if (now - nudge.lastNudgeSentAt < this.#nudgeCooldownMs) return;
+    if (now - nudge.lastNudgeSentAt < this.#cooldownFor(reason)) return;
     if (nudge.count >= this.#escalateAfterNudges) {
       await this.#escalate(threadId);
     } else {
@@ -132073,6 +132134,10 @@ var StallDetector = class {
    * until gap-fill has had a chance to redeliver anything in flight across
    * a restart.
    */
+  /** Cooldown for a given tier — the due tier keeps a 24h floor (see DUE_NUDGE_COOLDOWN_FLOOR_MS). An explicit operator nudgeCooldownMs LONGER than the floor still wins. */
+  #cooldownFor(reason) {
+    return reason === "due" ? Math.max(this.#nudgeCooldownMs, DUE_NUDGE_COOLDOWN_FLOOR_MS) : this.#nudgeCooldownMs;
+  }
   #effectiveThreshold(record, threadId) {
     const base = record.lastTurnOutcome === "failed" ? { ms: this.#stallFastThresholdMs, reason: "failed" } : { ms: this.#stallThresholdMs, reason: "normal" };
     const dueMs = this.#deps.getTaskDueMs?.(record.taskGuid);
@@ -132086,6 +132151,14 @@ var StallDetector = class {
     const now = Date.now();
     let brokenFloorMs;
     for (const peerBotId of record.lastTurnMentions) {
+      {
+        const peerOutcome = this.#deps.getPeerLastTurnOutcome?.(peerBotId, threadId);
+        const peerEndedAt = this.#deps.getPeerLastActiveTs?.(peerBotId, threadId);
+        if (peerOutcome === "failed" && peerEndedAt !== void 0 && peerEndedAt > mentionAt) {
+          brokenFloorMs = this.#stallHandoffThresholdMs;
+          break;
+        }
+      }
       const receivedAt = this.#deps.getPeerReceivedAt(peerBotId, threadId);
       if (receivedAt === void 0 || receivedAt <= mentionAt) {
         const completedAt2 = this.#deps.getPeerLastActiveTs?.(peerBotId, threadId);
@@ -132369,6 +132442,7 @@ async function runV2Mode({
   const { basename } = path19;
   const instances = [];
   const handlersByBotId = /* @__PURE__ */ new Map();
+  const allTaskHandleStores = [];
   const tasklistPollersByGuid = /* @__PURE__ */ new Map();
   const tasklistGuidGroups = /* @__PURE__ */ new Map();
   for (const bot of healthyBots) {
@@ -132462,6 +132536,8 @@ async function runV2Mode({
     let taskHandleClaim;
     let taskHandleClaimedLookup;
     let taskHandleClaimGuidLookup;
+    let taskGuidClaimedByOtherBot;
+    let taskHandleClaimCommentPending;
     let taskHandleCandidatesLookup;
     let taskCommentPoller;
     let stallDetector;
@@ -132491,6 +132567,7 @@ async function runV2Mode({
           effectiveTaskHandleTasklistGuid = guid;
         }
         const taskHandleStore = await TaskHandleStore.load(resolveTaskHandlesPath(bot.id));
+        allTaskHandleStores.push({ botId: bot.id, store: taskHandleStore });
         taskHandleLifecycle = (patch) => applyTaskHandleWriteback(patch, { store: taskHandleStore, client: taskListClient });
         taskHandleClaim = async (patch) => {
           const result = await taskHandleStore.claim(patch);
@@ -132502,6 +132579,8 @@ async function runV2Mode({
         };
         taskHandleClaimedLookup = (threadId) => taskHandleStore.get(threadId) !== void 0;
         taskHandleClaimGuidLookup = (threadId) => taskHandleStore.get(threadId)?.taskGuid;
+        taskGuidClaimedByOtherBot = (guid2) => allTaskHandleStores.some((e) => e.botId !== bot.id && e.store.list().some((r) => r.taskGuid === guid2));
+        taskHandleClaimCommentPending = (threadId) => taskHandleStore.get(threadId)?.claimCommentPending === true;
         if (guid) {
           const group = tasklistGuidGroups.get(guid) ?? { client: taskListClient, clientOwnerBotId: bot.id, bots: [] };
           group.bots.push({ botId: bot.id, sessionStore, taskHandleStore });
@@ -132564,6 +132643,9 @@ async function runV2Mode({
               // window — "did their turn genuinely finish", not "did it start
               // or get queued". See stallDetector.ts's module doc revision 3.
               getPeerLastActiveTs: (peerBotId, threadId) => handlersByBotId.get(peerBotId)?.getThreadLastActiveTs(threadId),
+              // v4.2 revision 5: the peer's most recent finished-turn OUTCOME —
+              // a failed finish must not resolve a handoff (see stallDetector.ts).
+              getPeerLastTurnOutcome: (peerBotId, threadId) => handlersByBotId.get(peerBotId)?.getThreadLastOutcome(threadId),
               // v3.3 due-date stall detection (docs/task-handle.md §14): free
               // read of TasklistPoller's own per-guid `due` observation — same
               // "populated after, read lazily" closure trick as
@@ -132726,6 +132808,8 @@ async function runV2Mode({
       taskHandleClaim,
       taskHandleClaimedLookup,
       taskHandleClaimGuidLookup,
+      taskGuidClaimedByOtherBot,
+      taskHandleClaimCommentPending,
       taskHandleCandidatesLookup
     });
     handlersByBotId.set(bot.id, handler);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkway",
-  "version": "0.3.43",
+  "version": "0.3.44",
   "description": "Thin bridge: Feishu thread to local Claude Code CLI",
   "license": "MIT",
   "author": "Chuck Wu (chuckwu0)",