oasis_test_v2 2.2.86 → 2.2.88

package/dist/index.js

@@ -141260,7 +141260,7 @@ ${m2.spec.split("\n").map((l) => `  > ${l}`).join("\n")}`);
     // 队列从 N 变 N+1、随后 conclude 撞 queue not quiescent（本文件「怎么提交」那段注释记的卡死形状）。
     ...args.action === "review" || integrating || queueTaskDue ? [] : [
       ``,
-      `### \u4EA4\u4ED8\u65F6\u7684\u975E\u963B\u585E\u4FE1\u606F`,
+      `### \u4EA4\u4ED8\u65F6\u5199\u7ED9\u4E0B\u6E38\u7684\u6CE8\u610F\u4E8B\u9879`,
       `\u4E0B\u9762\u51E0\u9879\u662F\u4EA4\u4ED8\u547D\u4EE4\uFF08\`oasis propose\`\uFF09\u7684\u53C2\u6570\uFF0C\u76F4\u63A5\u52A0\u5728\u90A3\u6761\u547D\u4EE4\u540E\u9762\uFF0C\u548C \`--reason\` \u5199\u5728\u4E00\u8D77\uFF1B\`oasis conclude\` \u53EA\u6536 \`--note\`\uFF0C\u5199\u5728 conclude \u4E0A\u7684\u5176\u5B83\u53C2\u6570\u4E0D\u4F1A\u88AB\u8BB0\u5F55\u3002`,
       `\`--reason\` \u5199\u660E\u76F8\u5BF9\u4E0A\u4E00\u7248\u6539\u4E86\u4EC0\u4E48\u3001\u4E3A\u4EC0\u4E48\u3001\u53EF\u80FD\u5F71\u54CD\u4EC0\u4E48\uFF1B\u9996\u6B21\u7248\u672C\u8BF4\u660E\u672C\u7248\u5B8C\u6210\u601D\u8DEF\u548C\u5185\u5BB9\u3002`,
       `\u53EA\u6709\u5F53\u524D\u7248\u672C\u5DF2\u7ECF\u8FBE\u5230\u4EA4\u4ED8\u6807\u51C6\u65F6\uFF0C\u624D\u53EF\u4EE5\u8BB0\u5F55\uFF08\u6BCF\u9879\u53EF\u4EE5\u5199\u591A\u6761\uFF0C\u7528\u82F1\u6587\u5206\u53F7 \`;\` \u9694\u5F00\uFF1B\u4EE5\u4E0B\u67D0\u4E00\u9879\u5982\u679C\u6CA1\u6709\u5C31\u4E0D\u5199\uFF0C\u540C\u65F6\u8BE5\u53C2\u6570\u4E5F\u4E0D\u5199\uFF09\uFF1A`,
@@ -143302,9 +143302,12 @@ ${supplemental.taskAppend.trim()}
             bundle.files["TASK.md"] += [
               "",
               "## \u6267\u884C\u6062\u590D\uFF08\u4EC5\u5F53\u524D\u8282\u70B9\uFF09",
-              "\u672C\u8F6E\u662F\u540C\u4E00\u8282\u70B9\u4E0A\u4E00\u6B21 Attempt \u4E2D\u65AD\u540E\u7684\u7EE7\u7EED\u6267\u884C\u3002\u5F00\u5DE5\u524D\u5148\u8BFB `execution/RESUME.md`\uFF0C",
-              "\u6838\u5BF9\u6700\u65B0 Checkpoint\u3001\u5DF2\u5B8C\u6210\u6B65\u9AA4\u3001durable outputs\u3001ExternalEffects \u4E0E\u672A\u51B3\u6B65\u9AA4\uFF1B",
-              "\u4ECE\u5C1A\u672A\u5B8C\u6210\u7684\u90E8\u5206\u7EE7\u7EED\uFF0C\u907F\u514D\u91CD\u590D\u5DF2\u7ECF\u786E\u8BA4\u5B8C\u6210\u7684\u6B65\u9AA4\u6216\u5916\u90E8\u526F\u4F5C\u7528\u3002",
+              // 2026-09-24（语菲定稿）：进度记录可能比实际慢一步（K-04），换了执行机器时工作目录是新的、
+              // 上一趟写的文件都不在（K-05 第三趟）——两种情况都以工作目录里实际有的文件为准。
+              "\u672C\u8F6E\u662F\u540C\u4E00\u8282\u70B9\u4E0A\u4E00\u6B21\u6267\u884C\u4E2D\u65AD\u540E\u7684\u7EE7\u7EED\u3002\u5F00\u5DE5\u524D\u5148\u8BFB `execution/RESUME.md`\uFF0C\u91CC\u9762\u662F\u4E0A\u4E00\u6B21\u6700\u540E\u8BB0\u4E0B\u7684\u8FDB\u5EA6\uFF1B",
+              "\u518D\u67E5\u770B\u5DE5\u4F5C\u76EE\u5F55\u91CC\u5B9E\u9645\u5DF2\u6709\u7684\u6587\u4EF6\uFF0C\u4EE5\u5B9E\u9645\u60C5\u51B5\u4E3A\u51C6\uFF1A",
+              "- \u8FDB\u5EA6\u91CC\u8BF4\u5DF2\u7ECF\u5199\u597D\u7684\u6587\u4EF6\uFF0C\u5DE5\u4F5C\u76EE\u5F55\u91CC\u8FD8\u5728\u7684\uFF0C\u76F4\u63A5\u63A5\u7740\u7528\uFF1B",
+              "- \u5DE5\u4F5C\u76EE\u5F55\u91CC\u6CA1\u6709\u7684\uFF08\u6BD4\u5982\u8FD9\u6B21\u6362\u4E86\u6267\u884C\u673A\u5668\uFF0C\u5DE5\u4F5C\u76EE\u5F55\u662F\u65B0\u7684\uFF09\uFF0C\u8981\u91CD\u65B0\u5199\u3002",
               "\u8FD9\u4EFD\u6062\u590D\u6750\u6599\u4E0D\u662F\u4E0A\u6E38\u8282\u70B9\u7684\u4E1A\u52A1\u4EA4\u63A5\uFF1B\u4E0A\u6E38\u4EA4\u63A5\u4ECD\u4EE5 `inputs/*/_HANDOFF.md` \u4E3A\u51C6\u3002",
               ""
             ].join("\n");
@@ -202844,7 +202847,7 @@ var init_service3 = __esm({
         }
         const actors = await this.options.resolveActors(companyId);
         const bindings = await actors.listBindings();
-        const reachability = async (actorId) => {
+        const reachability = async (actorId, actorName) => {
           const primaryReason = await (async () => {
             const binding = bindings.find((b2) => b2.actorId === actorId && b2.status === "active");
             if (!binding) return "\u6CA1\u6709\u63A5\u8FD0\u884C\u65F6";
@@ -202854,9 +202857,15 @@ var init_service3 = __esm({
           })();
           if (primaryReason === null) return { ok: true };
           if (!this.options.probeAllocation) return { ok: false, reason: primaryReason };
-          const alt = await this.options.probeAllocation({ actorId, ...companyId ? { companyId } : {} }).catch(() => ({ reachable: true }));
+          const alt = await this.options.probeAllocation({ actorId, actorName, ...companyId ? { companyId } : {} }).catch(() => ({ reachable: true }));
           if (alt.reachable) return { ok: true };
-          return { ok: false, reason: alt.reason ? `${alt.reason}\uFF08\u4E3B\u8FD0\u884C\u65F6\uFF1A${primaryReason}\uFF09` : primaryReason };
+          return {
+            ok: false,
+            ...alt.reason ? { allocationReason: alt.reason } : {},
+            // 短的那一格只放主运行时那一句。整句原因走 `allocationReason`，**不在这里再拼一遍**——
+            // 两格都放会让同一段话在报错里出现两次（括号里一遍、「原因：」那行一遍）。
+            reason: primaryReason
+          };
         };
         if (target.startsWith("actor:")) {
           const actor = await actors.getActor(target);
@@ -202867,12 +202876,12 @@ var init_service3 = __esm({
               `\u7EC4\u7EC7\u91CC\u627E\u4E0D\u5230\u5728\u5C97\u7684 ${target}\u2014\u2014\u81EA\u5DF1\u505A\uFF0C\u5E76\u5728\u56DE\u590D\u91CC\u8BF4\u660E\u8FD9\u4E00\u6BB5\u662F\u4F60\u81EA\u5DF1\u505A\u7684\u3002`
             );
           }
-          const reach = await reachability(actor.id);
+          const reach = await reachability(actor.id, actor.name);
           if (!reach.ok) {
             throw new DelegationError(
               409,
               "EXPERT_UNREACHABLE",
-              `${actor.name} \u73B0\u5728\u4E0D\u53EF\u7528\uFF08${reach.reason ?? "\u8FD0\u884C\u65F6\u4E0D\u53EF\u8FBE"}\uFF09\u2014\u2014\u81EA\u5DF1\u505A\uFF0C\u6216\u6362\u4E00\u4E2A\u5C97\u4F4D\u3002`,
+              _DelegationService.unreachableText(actor.name, reach),
               { expertActorId: actor.id, expertName: actor.name }
             );
           }
@@ -202887,19 +202896,34 @@ var init_service3 = __esm({
           );
         }
         let lastReason;
+        let lastAllocationReason;
         for (const candidate of candidates) {
-          const reach = await reachability(candidate.id);
+          const reach = await reachability(candidate.id, candidate.name);
           if (reach.ok) return { actorId: candidate.id, name: candidate.name };
           lastReason = reach.reason ?? lastReason;
+          lastAllocationReason = reach.allocationReason ?? lastAllocationReason;
         }
         const first = candidates[0];
         throw new DelegationError(
           409,
           "EXPERT_UNREACHABLE",
-          `\u300C${target}\u300D\u5C97\u4F4D\u4E0A\u7684\u540C\u4E8B\uFF08${candidates.map((a) => a.name).join("\u3001")}\uFF09\u73B0\u5728\u90FD\u4E0D\u53EF\u7528\uFF08${lastReason ?? "\u8FD0\u884C\u65F6\u4E0D\u53EF\u8FBE"}\uFF09\u2014\u2014\u81EA\u5DF1\u505A\uFF0C\u6216\u6362\u4E00\u4E2A\u5C97\u4F4D\u3002`,
+          `\u300C${target}\u300D\u5C97\u4F4D\u4E0A\u7684\u540C\u4E8B\uFF08${candidates.map((a) => a.name).join("\u3001")}\uFF09\u73B0\u5728\u90FD\u4E0D\u53EF\u7528\uFF08${lastReason ?? "\u8FD0\u884C\u65F6\u4E0D\u53EF\u8FBE"}\uFF09\u2014\u2014\u81EA\u5DF1\u505A\uFF0C\u6216\u6362\u4E00\u4E2A\u5C97\u4F4D\u3002` + (lastAllocationReason ? `
+\u539F\u56E0\uFF1A${lastAllocationReason}` : ""),
           { expertActorId: first.id, expertName: first.name }
         );
       }
+      /**
+       * `EXPERT_UNREACHABLE` 那句话（ADR 0616）。**结论在前、原因在后**：读它的是 LLM，
+       * 它读完第一行就要决定改走「自己干」那条路（§8.2）。
+       *
+       * 分配给出原因时把**那一整句原文**单起一行，不塞进括号里——它自己已经带了机器名、为什么
+       * （已到并发上限 / 标记为故障 / 没有可用绑定）和下一步怎么办，再套一层括号就读不成句子了。
+       */
+      static unreachableText(name, reach) {
+        const head = `${name} \u73B0\u5728\u4E0D\u53EF\u7528\uFF08${reach.reason ?? "\u8FD0\u884C\u65F6\u4E0D\u53EF\u8FBE"}\uFF09\u2014\u2014\u81EA\u5DF1\u505A\uFF0C\u6216\u6362\u4E00\u4E2A\u5C97\u4F4D\u3002`;
+        return reach.allocationReason ? `${head}
+\u539F\u56E0\uFF1A${reach.allocationReason}` : head;
+      }
       /**
        * 第 `attempt` 次尝试用的 label 候选（`desired`、`desired-2`、`desired-3`…）。
        *
@@ -203409,6 +203433,11 @@ var init_service3 = __esm({
           const settled = await store?.patch(record9.id, {
             state: "failed",
             failureKind: "not-started",
+            /* ★ ADR 0616：**原因也要落台账**。上一版只把它写进子会话的占位行（= 用户在界面上看到的
+               那一句）和轮次账本的 `lastError`，台账上一个字都没有——于是 `--status` 与回流给主会话的
+               那条通告都只剩 `not-started`，派活的那一方（助理 agent）读不到「所有候选都到并发上限」
+               这种真原因，只能猜。2026-09-24 实测它猜成了「节点掉线」。 */
+            failureReason: message2,
             settledSeq: record9.settledSeq + 1,
             consecutiveFails: record9.consecutiveFails + 1,
             settledAt: failedAt
@@ -203487,6 +203516,9 @@ var init_service3 = __esm({
           consecutiveFails,
           state: failureKind2 ? "failed" : "done",
           failureKind: failureKind2 ?? null,
+          /* 这几档（跑起来过之后才失败 / 跑成了）的原因已经在本轮 `roundSummaries[].text` 里，
+             不在台账上再存一份；同时把上一轮 `not-started` 留下的原文清掉，免得读到的是过期原因。 */
+          failureReason: null,
           settledSeq: settledSeqAtRound,
           settledAt: at2
         }).catch(() => null);
@@ -203557,6 +203589,8 @@ var init_service3 = __esm({
           // 退出帧丢失后被时钟闭合 = `interrupted`（§9），不是 `not-started`——它确实起来过。
           // run 报的是墙钟超时时归 `timeout`（Bug 0221）：同样起来过，但「到点被停」与「断了」说法不同。
           failureKind: timedOut ? "timeout" : "interrupted",
+          // 同 settleRound：这两档的原因在本轮摘要里，台账只清掉上一轮 not-started 的原文。
+          failureReason: null,
           consecutiveFails: record9.consecutiveFails + 1,
           settledSeq: settledSeqAtRound,
           settledAt: at2
@@ -203672,6 +203706,7 @@ var init_service3 = __esm({
         const released = await store.patch(record9.id, {
           state: "running",
           failureKind: null,
+          failureReason: null,
           settledAt: null,
           childRunId: null,
           // 换一把轮次账本业务键 + 释放派发所有权，否则新一轮会被上一轮的预约判成 `resumed` 而永远不派。
@@ -203682,6 +203717,7 @@ var init_service3 = __esm({
         const restore = () => store.patch(record9.id, {
           state: record9.state,
           failureKind: record9.failureKind ?? null,
+          failureReason: record9.failureReason ?? null,
           settledAt: record9.settledAt ?? null,
           childRunId: record9.childRunId ?? null,
           dispatchedAt: record9.dispatchedAt ?? null
@@ -203878,6 +203914,7 @@ ${inboundBundle.paths.map((path47) => `- ${path47}`).join("\n")}` : text7,
             await store.patch(record9.id, {
               state: "running",
               failureKind: null,
+              failureReason: null,
               settledAt: null,
               childRunId: null,
               // 释放派发所有权：这条追加要触发新的一轮，得让下一次 `claimDispatch` 抢得到。
@@ -203941,6 +203978,8 @@ ${inboundBundle.paths.map((path47) => `- ${path47}`).join("\n")}` : text7,
           ...expert?.name ? { expertName: expert.name } : {},
           state: record9.state,
           ...record9.failureKind ? { failureKind: record9.failureKind } : {},
+          // ADR 0616：`--status` 要说得出「为什么没派出去」，不能只给一个 `not-started`。
+          ...record9.failureReason ? { failureReason: record9.failureReason } : {},
           ...record9.label ? { label: record9.label } : {},
           ...record9.taskDigest ? { taskDigest: record9.taskDigest } : {},
           roundSummaries: record9.roundSummaries,
@@ -204536,6 +204575,7 @@ function delegationReturnText(terminal, opts) {
     head,
     `\u59D4\u6D3E id\uFF1A${record9.id.slice(0, 8)}\u3000label\uFF1A${record9.label ?? "\uFF08\u65E0\uFF09"}` + (record9.failureKind ? `\u3000\u7ED3\u675F\u539F\u56E0\uFF1A${record9.failureKind}` : "")
   ];
+  if (record9.failureReason?.trim()) lines.push(`\u539F\u56E0\uFF1A${record9.failureReason.trim()}`);
   const trimmed = trimRoundSummariesForReturn(record9.roundSummaries, opts.recentRounds);
   if (trimmed.length > 0) {
     lines.push("", `\u4E13\u5BB6\u5404\u8F6E\u5C0F\u7ED3\uFF08\u5171 ${trimmed.length} \u8F6E\uFF1B\u6700\u8FD1 ${opts.recentRounds} \u8F6E\u7ED9\u5168\u6587\uFF0C\u66F4\u65E9\u7684\u53EA\u7559\u9996\u884C\uFF0C\u5168\u6587\u7528 \`oasis delegate --status\` \u770B\uFF09\uFF1A`);
@@ -246579,32 +246619,34 @@ var init_allocate = __esm({
 function describeRejections(rejections) {
   return rejections.map((r) => `${r.nodeName} \xB7 ${r.runtimeKind}\uFF08${CAUSE_TEXT[r.cause]}${r.detail ? `\uFF1A${r.detail}` : ""}\uFF09`).join("\uFF1B");
 }
-function requireAllocation(result, who) {
-  if (result.ok) return result;
+function describeAllocationFailure(result, who) {
   const subject = who?.actorName?.trim() ? `\u300C${who.actorName.trim()}\u300D` : "\u8FD9\u4F4D Agent";
   const what = who?.what?.trim() ? `${who.what.trim()}\uFF1A` : "";
   const detail = describeRejections(result.rejections);
   if (result.reason === "no-candidates") {
-    throw new RuntimeAllocationError(
-      "RUNTIME_ALLOCATION_NO_CANDIDATES",
-      `${what}${subject}\u6CA1\u6709\u53EF\u7528\u7684\u8FD0\u884C\u65F6\u76EE\u6807\uFF1A\u65E2\u6CA1\u6709\u4E3B\u8FD0\u884C\u65F6\u7ED1\u5B9A\uFF0C\u4E5F\u6CA1\u6709\u914D\u7F6E\u5019\u9009\u8FD0\u884C\u65F6\u3002\u8BF7\u5728\u5458\u5DE5\u8BE6\u60C5\u9875\u7684\u300C\u9ED8\u8BA4\u8FD0\u884C\u914D\u7F6E\u300D\u91CC\u7ED1\u5B9A\u4E00\u4E2A\u8FD0\u884C\u65F6\uFF0C\u6216\u52A0\u4E00\u6761\u5019\u9009\u8FD0\u884C\u65F6\u3002`,
-      result.rejections
-    );
+    return {
+      code: "RUNTIME_ALLOCATION_NO_CANDIDATES",
+      status: 409,
+      message: `${what}${subject}\u6CA1\u6709\u53EF\u7528\u7684\u8FD0\u884C\u65F6\u76EE\u6807\uFF1A\u65E2\u6CA1\u6709\u4E3B\u8FD0\u884C\u65F6\u7ED1\u5B9A\uFF0C\u4E5F\u6CA1\u6709\u914D\u7F6E\u5019\u9009\u8FD0\u884C\u65F6\u3002\u8BF7\u5728\u5458\u5DE5\u8BE6\u60C5\u9875\u7684\u300C\u9ED8\u8BA4\u8FD0\u884C\u914D\u7F6E\u300D\u91CC\u7ED1\u5B9A\u4E00\u4E2A\u8FD0\u884C\u65F6\uFF0C\u6216\u52A0\u4E00\u6761\u5019\u9009\u8FD0\u884C\u65F6\u3002`
+    };
   }
   if (result.reason === "all-at-capacity") {
-    throw new RuntimeAllocationError(
-      "RUNTIME_ALLOCATION_ALL_AT_CAPACITY",
-      `${what}${subject}\u7684\u8FD0\u884C\u65F6\u5168\u90E8\u5DF2\u5230\u5E76\u53D1\u4E0A\u9650\uFF0C\u672C\u6B21\u6CA1\u6709\u6D3E\u51FA\uFF1A${detail}\u3002\u8BF7\u7B49\u5F53\u524D\u4F1A\u8BDD\u8DD1\u5B8C\uFF0C\u6216\u5728\u8FD0\u884C\u65F6\u7BA1\u7406\u9875\u628A\u8FD9\u4E9B\u8282\u70B9\u7684\u5E76\u53D1\u4E0A\u9650\u8C03\u9AD8\u3002`,
-      result.rejections,
-      503
-    );
+    return {
+      code: "RUNTIME_ALLOCATION_ALL_AT_CAPACITY",
+      status: 503,
+      message: `${what}${subject}\u7684\u8FD0\u884C\u65F6\u5168\u90E8\u5DF2\u5230\u5E76\u53D1\u4E0A\u9650\uFF0C\u672C\u6B21\u6CA1\u6709\u6D3E\u51FA\uFF1A${detail}\u3002\u8BF7\u7B49\u5F53\u524D\u4F1A\u8BDD\u8DD1\u5B8C\uFF0C\u6216\u5728\u8FD0\u884C\u65F6\u7BA1\u7406\u9875\u628A\u8FD9\u4E9B\u8282\u70B9\u7684\u5E76\u53D1\u4E0A\u9650\u8C03\u9AD8\u3002`
+    };
   }
-  throw new RuntimeAllocationError(
-    "RUNTIME_ALLOCATION_ALL_UNAVAILABLE",
-    `${what}${subject}\u7684\u8FD0\u884C\u65F6\u76EE\u524D\u90FD\u4E0D\u53EF\u7528\uFF0C\u672C\u6B21\u6CA1\u6709\u6D3E\u51FA\uFF1A${detail}\u3002\u8BF7\u786E\u8BA4\u90A3\u4E9B\u673A\u5668\u5F00\u7740\u3001\u8282\u70B9\u7A0B\u5E8F\u5728\u8FD0\u884C\u3001\u8FD0\u884C\u65F6\u5DF2\u767B\u5F55\u4E14\u989D\u5EA6\u672A\u8017\u5C3D\uFF1B\u6216\u5728\u5458\u5DE5\u8BE6\u60C5\u9875\u52A0\u4E00\u6761\u522B\u7684\u5019\u9009\u8FD0\u884C\u65F6\u3002`,
-    result.rejections,
-    result.reason === "all-tried" ? 409 : 503
-  );
+  return {
+    code: "RUNTIME_ALLOCATION_ALL_UNAVAILABLE",
+    status: result.reason === "all-tried" ? 409 : 503,
+    message: `${what}${subject}\u7684\u8FD0\u884C\u65F6\u76EE\u524D\u90FD\u4E0D\u53EF\u7528\uFF0C\u672C\u6B21\u6CA1\u6709\u6D3E\u51FA\uFF1A${detail}\u3002\u8BF7\u786E\u8BA4\u90A3\u4E9B\u673A\u5668\u5F00\u7740\u3001\u8282\u70B9\u7A0B\u5E8F\u5728\u8FD0\u884C\u3001\u8FD0\u884C\u65F6\u5DF2\u767B\u5F55\u4E14\u989D\u5EA6\u672A\u8017\u5C3D\uFF1B\u6216\u5728\u5458\u5DE5\u8BE6\u60C5\u9875\u52A0\u4E00\u6761\u522B\u7684\u5019\u9009\u8FD0\u884C\u65F6\u3002`
+  };
+}
+function requireAllocation(result, who) {
+  if (result.ok) return result;
+  const failure2 = describeAllocationFailure(result, who);
+  throw new RuntimeAllocationError(failure2.code, failure2.message, result.rejections, failure2.status);
 }
 var RuntimeAllocationError, CAUSE_TEXT;
 var init_errors6 = __esm({
@@ -249352,8 +249394,10 @@ function executionContinuityDomain(service) {
     router.post("/api/execution-continuity/attempts/:id/checkpoints", async (req) => {
       const attemptId = resolveAttemptWriter(req, req.params.id);
       const b2 = req.body ?? {};
+      if (b2.pendingSteps === void 0) b2.pendingSteps = [];
+      if (b2.recoverability === void 0) b2.recoverability = "partial";
       if (!isStringArray(b2.pendingSteps) || !b2.recoverability || !["full", "partial", "none"].includes(b2.recoverability) || b2.durableRefs !== void 0 && !isRefArray(b2.durableRefs) || b2.completedStepIds !== void 0 && !isStringArray(b2.completedStepIds) || b2.trigger !== void 0 && !AGENT_CHECKPOINT_TRIGGERS.includes(b2.trigger)) {
-        throw new ApiError(400, "BAD_REQUEST", "\u7F3A\u5C11 pendingSteps \u6216 recoverability(full|partial|none)");
+        throw new ApiError(400, "BAD_REQUEST", "pendingSteps \u987B\u4E3A\u5B57\u7B26\u4E32\u6570\u7EC4\uFF1Brecoverability \u53EA\u80FD\u662F full|partial|none");
       }
       const checkpoint = await service.checkpoint({
         attemptId,
@@ -249473,6 +249517,9 @@ function mergeContinuityRefs2(primary, extra) {
   }
   return out;
 }
+function stripRecoverability(text7) {
+  return text7.replace(/\s*recoverability=\w+/g, "");
+}
 function renderResumePack(pack) {
   const lines = [
     "# ResumePack",
@@ -249486,7 +249533,7 @@ function renderResumePack(pack) {
   lines.push("", "## Previous attempt");
   if (!pack.previousAttempt) lines.push("- This is the first attempt.");
   else {
-    lines.push(`- Attempt ${pack.previousAttempt.attemptNo ?? "?"}: ${pack.previousHandoff?.summary || pack.previousAttempt.status}`);
+    lines.push(`- Attempt ${pack.previousAttempt.attemptNo ?? "?"}: ${stripRecoverability(pack.previousHandoff?.summary || pack.previousAttempt.status)}`);
     const cp = pack.latestCheckpoint;
     const recoverySource = pack.recoverySourceAttempt ?? (cp ? pack.previousAttempt : null);
     if (cp && recoverySource && recoverySource.id !== pack.previousAttempt.id) {
@@ -249494,7 +249541,6 @@ function renderResumePack(pack) {
     }
     const done = cp?.completedStepIds ?? [];
     const durable = (cp?.durableRefs.length ? cp.durableRefs : pack.previousHandoff?.changedOutputs) ?? [];
-    if (cp) lines.push(`- Recoverability: ${cp.recoverability}`);
     if (done.length > 0) lines.push(`- \u4E0A\u4E00\u8D9F\u5DF2\u5B8C\u6210\u7684\u6B65\u9AA4\uFF1A${done.join("\u3001")}`);
     for (const ref2 of durable) {
       lines.push(`  - durable: ${renderRefId(ref2)}${ref2.version ? `@${ref2.version}` : ""}${ref2.label ? ` \u2014 ${ref2.label}` : ""}`);
@@ -249507,20 +249553,6 @@ function renderResumePack(pack) {
       );
     }
   }
-  lines.push("", "## External effects");
-  const effectSummary = pack.externalEffectSummary;
-  if (effectSummary.total === 0) lines.push("- None recorded");
-  else {
-    const totals = effectSummary.totalByStatus;
-    const included = effectSummary.includedByStatus;
-    lines.push(
-      `- ${effectSummary.total} total; showing all ${included.pending} pending, latest ${included.succeeded} of ${totals.succeeded} succeeded, and latest ${included.failed} of ${totals.failed} retryable failed. Older records remain available through the history query.`
-    );
-  }
-  for (const effect of pack.externalEffects) {
-    const action = effect.status === "succeeded" ? "do not repeat" : effect.status === "pending" ? "execution uncertain; reconcile before retry" : "failed; retry allowed";
-    lines.push(`- [${effect.status}/${effect.source}] ${effect.kind} \u2192 ${effect.target} (${action}; key ${effect.idempotencyKey})`);
-  }
   const snapshot = Buffer.from(JSON.stringify(pack), "utf8").toString("base64url");
   lines.push("", `${RESUME_SNAPSHOT_PREFIX}${snapshot}${RESUME_SNAPSHOT_SUFFIX}`);
   return `${lines.join("\n")}
@@ -249643,6 +249675,9 @@ function renderCoordinatorView(view, taskBackground) {
       node2.nodeState === null ? "- Attempt: \u6267\u884C\u8D26\u672C\u4E2D\u65E0 attempt \u8BB0\u5F55" : `- Attempt: ${node2.status}; continuity: ${node2.nodeState}; number: ${node2.attemptNo || "none"}`,
       `- Actor: ${node2.actorId ?? "unassigned"}; role: ${node2.role ?? "unassigned"}`
     );
+    if (node2.work.failureReason?.trim() && (node2.work.state === "failed" || node2.work.state === "dead" || node2.work.state === "retry")) {
+      lines.push(`- Work failure reason: ${node2.work.failureReason.trim()}`);
+    }
     if (node2.dependsOn.length > 0) lines.push(`- Depends on: ${node2.dependsOn.join(", ")}`);
     if (node2.conclusion?.trim()) {
       lines.push(node2.work.acceptedWorkId ? `- Conclusion (delivered ${node2.work.acceptedWorkId}): ${node2.conclusion.trim()}` : `- Conclusion: ${node2.conclusion.trim()}`);
@@ -249654,7 +249689,7 @@ function renderCoordinatorView(view, taskBackground) {
       );
       if (source.recoveryCheckpoint) {
         lines.push(
-          `  - Recovery checkpoint: #${source.recoveryCheckpoint.seq} (${source.recoveryCheckpoint.recoverability}) from Attempt ${source.recoveredFromAttempt.attemptNo ?? "?"}`
+          `  - Recovery checkpoint: #${source.recoveryCheckpoint.seq} from Attempt ${source.recoveredFromAttempt.attemptNo ?? "?"}`
         );
         for (const step of source.recoveryCheckpoint.pendingSteps) lines.push(`    - Recovery pending: ${step}`);
       }
@@ -249664,14 +249699,14 @@ function renderCoordinatorView(view, taskBackground) {
           lines.push(`  - Recovery Agent handoff (${handoffFrom}): ${source.recoveryHandoff.summary}`);
         } else if (source.recoveryHandoff.producedBy === "system_reconstructed") {
           lines.push(
-            `  - Recovery system reconstruction (${handoffFrom}, not an Agent conclusion): ${source.recoveryHandoff.summary}`
+            `  - Recovery system reconstruction (${handoffFrom}, not an Agent conclusion): ${stripRecoverability(source.recoveryHandoff.summary)}`
           );
         }
       }
       for (const risk of source.recoveryHandoff?.risks ?? []) lines.push(`    - Recovery risk: ${risk}`);
     }
     if (node2.progress) {
-      lines.push(`- Latest checkpoint: ${node2.progress.recoverability} at ${node2.progress.lastCheckpointAt}`);
+      lines.push(`- Latest checkpoint at ${node2.progress.lastCheckpointAt}`);
       for (const step of node2.progress.pendingSteps) lines.push(`  - Pending: ${step}`);
     }
     if (node2.handoffProducer === "agent" && node2.summary.trim() && !sameCoordinatorText(node2.summary, node2.conclusion)) {
@@ -250454,10 +250489,12 @@ function nodeCoordinatorFactsFromSnapshot(snapshot) {
   for (const node2 of snapshot.nodes) {
     const currentWorkId = node2.latestWorkId ?? null;
     const currentWork = currentWorkId ? workById.get(currentWorkId) : void 0;
+    const failureReason2 = typeof currentWork?.outcomeDetail?.["reason"] === "string" ? currentWork.outcomeDetail["reason"].trim() : "";
     const work = {
       currentWorkId,
       acceptedWorkId: node2.latestAcceptId ?? null,
-      state: currentWorkId === null ? "not_started" : currentWork ? workState(currentWork, hasOutput(currentWork, artifactCountByWork.get(currentWork.id) ?? 0)) : "unavailable"
+      state: currentWorkId === null ? "not_started" : currentWork ? workState(currentWork, hasOutput(currentWork, artifactCountByWork.get(currentWork.id) ?? 0)) : "unavailable",
+      ...failureReason2 ? { failureReason: failureReason2 } : {}
     };
     const accepted = node2.latestAcceptId ? workById.get(node2.latestAcceptId) : void 0;
     const conclusion = accepted?.conclusion?.trim();
@@ -268583,6 +268620,7 @@ function toRecord2(row) {
     expertActorId: row.expert_actor_id,
     state: row.state,
     ...row.failure_kind ? { failureKind: row.failure_kind } : {},
+    ...row.failure_reason ? { failureReason: row.failure_reason } : {},
     ...row.child_run_id ? { childRunId: row.child_run_id } : {},
     ...row.invocation_id ? { invocationId: row.invocation_id } : {},
     ...row.label ? { label: row.label } : {},
@@ -268645,6 +268683,9 @@ var init_postgres_delegations = __esm({
       )`);
         for (const [col, type] of [
           ["failure_kind", "text"],
+          // 这次失败的原因原文（ADR 0616）。存量行 NULL = 那次失败没留下原文（本列落地之前写的），
+          // `--status` 与回流通告照旧只打 `failure_kind`，与改动前逐字相同。
+          ["failure_reason", "text"],
           ["child_run_id", "text"],
           ["invocation_id", "text"],
           ["label", "text"],
@@ -268688,9 +268729,9 @@ var init_postgres_delegations = __esm({
         const inserted = await this.pool.query(
           `INSERT INTO ${this.s}.chat_session_delegations
          (id, parent_session_id, parent_message_id, child_session_id, expert_actor_id, state,
-          failure_kind, child_run_id, invocation_id, label, task_digest, round_summaries,
+          failure_kind, failure_reason, child_run_id, invocation_id, label, task_digest, round_summaries,
           consecutive_fails, settled_seq, created_at, settled_at, dispatched_at, dispatch_seq)
-       VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12::jsonb,$13,$14,$15,$16,$17,$18)
+       VALUES ($1,$2,$3,$4,$5,$6,$7,$8,$9,$10,$11,$12,$13::jsonb,$14,$15,$16,$17,$18,$19)
        ON CONFLICT DO NOTHING
        RETURNING *`,
           [
@@ -268701,6 +268742,7 @@ var init_postgres_delegations = __esm({
             record9.expertActorId,
             record9.state,
             record9.failureKind ?? null,
+            record9.failureReason ?? null,
             record9.childRunId ?? null,
             record9.invocationId ?? null,
             record9.label ?? null,
@@ -268781,6 +268823,7 @@ var init_postgres_delegations = __esm({
         };
         if (patch.state !== void 0) put3("state", patch.state);
         if (patch.failureKind !== void 0) put3("failure_kind", patch.failureKind);
+        if (patch.failureReason !== void 0) put3("failure_reason", patch.failureReason);
         if (patch.childRunId !== void 0) put3("child_run_id", patch.childRunId);
         if (patch.label !== void 0) put3("label", patch.label);
         if (patch.roundSummaries !== void 0) put3("round_summaries", JSON.stringify(patch.roundSummaries), "::jsonb");
@@ -268942,6 +268985,7 @@ var init_postgres_delegations = __esm({
         if (otherPatch) {
           if (otherPatch.state !== void 0) put3("state", otherPatch.state);
           if (otherPatch.failureKind !== void 0) put3("failure_kind", otherPatch.failureKind);
+          if (otherPatch.failureReason !== void 0) put3("failure_reason", otherPatch.failureReason);
           if (otherPatch.childRunId !== void 0) put3("child_run_id", otherPatch.childRunId);
           if (otherPatch.label !== void 0) put3("label", otherPatch.label);
           if (otherPatch.consecutiveFails !== void 0) put3("consecutive_fails", otherPatch.consecutiveFails);
@@ -278998,6 +279042,7 @@ __export(src_exports2, {
   deliverWorkorderBroadcast: () => deliverWorkorderBroadcast,
   deriveNodeHealth: () => deriveNodeHealth,
   describeAllocationChoice: () => describeAllocationChoice,
+  describeAllocationFailure: () => describeAllocationFailure,
   describeAttachmentsForAppend: () => describeAttachmentsForAppend,
   describeNodeFault: () => describeNodeFault,
   describeRejections: () => describeRejections,
@@ -285664,13 +285709,13 @@ async function startServe(opts) {
      * 用 `tryAllocate`（不抛、不消耗重试次数）：这里只是问「挑不挑得出来」，真正的分配在
      * 那一轮派发时再跑一次——两次之间机器状态可能变，以派发那一次为准。
      */
-    delegationProbeAllocation: async ({ actorId, companyId }) => {
+    delegationProbeAllocation: async ({ actorId, actorName, companyId }) => {
       const result = await runtimeAllocatorFor(companyId ?? defaultCompanyId).tryAllocate({
         actorId,
         unitOfWork: `delegation-preflight:${actorId}`
       });
       if (result.ok) return { reachable: true };
-      return { reachable: false, reason: describeRejections(result.rejections) || "\u6CA1\u6709\u53EF\u7528\u7684\u8FD0\u884C\u65F6\u76EE\u6807" };
+      return { reachable: false, reason: describeAllocationFailure(result, { actorName }).message };
     },
     // ADR 会话投递 D4：/api/chat 与渠道入站据它占同一个会话槽（自动化侧经 automations 域接同一实例）。
     chatTurns: chatTurnStore,
@@ -292957,16 +293002,16 @@ var COMMAND_DECLS = {
   },
   "continuity-checkpoint": {
     group: "\u56FE\u673A\u5236\uFF08\xA76/\xA77\uFF09",
-    usage: "oasis continuity-checkpoint --pending <list> --recoverability full|partial|none [--trigger plan_completed|stage_completed] [--refs <json-array>] [--completed <list>]",
+    usage: "oasis continuity-checkpoint [--completed <list>] [--pending <list>] [--recoverability full|partial|none] [--trigger plan_completed|stage_completed] [--refs <json-array>]",
     description: "\u4E3A\u5F53\u524D\u6D3E\u53D1 attempt \u8FFD\u52A0\u53EF\u6062\u590D\u68C0\u67E5\u70B9\uFF08\u81EA\u52A8\u4FDD\u7559\u6700\u65B0\u4E94\u4E2A\uFF09\u3002",
     flags: [
-      { name: "pending", desc: `\u5F85\u5B8C\u6210\u6B65\u9AA4\u3002JSON \u6570\u7EC4 '["a","b"]' \u6216\u5206\u53F7\u5206\u9694 "a; b" \u90FD\u6536`, required: true },
-      { name: "recoverability", desc: "\u6062\u590D\u7A0B\u5EA6\uFF08full | partial | none\uFF09", required: true },
+      { name: "pending", desc: '\u8FD8\u6CA1\u505A\u7684\u6B65\u9AA4\u3002\u5206\u53F7\u5206\u9694 "a; b" \u6216 JSON \u6570\u7EC4\u90FD\u6536\uFF1B\u4E0D\u5199\u6216\u5199\u7A7A = \u6CA1\u6709\u5269\u4F59' },
+      { name: "recoverability", desc: "\u6062\u590D\u7A0B\u5EA6\uFF08full | partial | none\uFF09\uFF0C\u53EF\u9009\uFF1B\u4E0D\u5199\u6309 partial \u8BB0" },
       { name: "refs", desc: "\u5DF2\u6301\u4E45\u5316\u4EA7\u51FA\u5F15\u7528 JSON array" },
-      { name: "completed", desc: "\u5DF2\u5B8C\u6210\u7684\u7A33\u5B9A\u6B65\u9AA4 id\u3002JSON \u6570\u7EC4\u6216\u5206\u53F7\u5206\u9694\u90FD\u6536" },
+      { name: "completed", desc: "\u5230\u73B0\u5728\u4E3A\u6B62\u786E\u5B9E\u505A\u5B8C\u7684\u6B65\u9AA4\u3002\u5206\u53F7\u5206\u9694\u6216 JSON \u6570\u7EC4\u90FD\u6536" },
       { name: "trigger", desc: "\u7ED3\u6784\u5316\u8FB9\u754C\uFF08plan_completed | stage_completed\uFF1B\u7701\u7565\u4E3A\u666E\u901A agent checkpoint\uFF09" }
     ],
-    examples: [`oasis continuity-checkpoint --pending '["run tests"]' --recoverability full --refs '[{"kind":"file","id":"src/x.ts"}]'`]
+    examples: ['oasis continuity-checkpoint --completed "\u67E5\u5B8C\u5317\u4EAC\u3001\u4E0A\u6D77\u653F\u7B56\uFF0C\u7ED3\u8BBA\u8BB0\u5728 notes.md; \u5199\u597D deliverable/beijing.md" --pending "\u5199 deliverable/shanghai.md; \u5199\u603B\u7ED3.md"']
   },
   "continuity-effect": {
     group: "\u56FE\u673A\u5236\uFF08\xA76/\xA77\uFF09",
@@ -294810,7 +294855,7 @@ async function waitForCommandAuthorization(base, headers, draftId, fallback) {
     }
   }
 }
-var CLI_VERSION = "2.2.86" ? "2.2.86" : "dev";
+var CLI_VERSION = "2.2.88" ? "2.2.88" : "dev";
 function apiHeaders(token, company) {
   const headers = {
     authorization: `Bearer ${token}`,
@@ -295500,6 +295545,7 @@ async function runCli(argv, println = console.log, progressln = console.error) {
         }
         println(`${detail.label ?? "(\u65E0\u77ED\u540D)"}  ${detail.expertName ?? detail.expertActorId}  ${detail.state}${detail.failureKind ? `/${detail.failureKind}` : ""}`);
         println(`id=${detail.id}  \u5B50\u4F1A\u8BDD=${detail.childSessionId}  \u5F85\u8F6C\u8FBE=${detail.pendingInputs}  \u8FDE\u7EED\u5931\u8D25=${detail.consecutiveFails}`);
+        if (detail.failureReason) println(`\u539F\u56E0\uFF1A${detail.failureReason}`);
         if (detail.taskDigest) println(`\u4EFB\u52A1\uFF1A${detail.taskDigest}`);
         for (const round of detail.roundSummaries) println(`
 \u7B2C ${round.round} \u8F6E\uFF08${round.at}\uFF09\uFF1A
@@ -295755,9 +295801,10 @@ Trace: ${run.traceRunId}`);
       break;
     }
     case "continuity-checkpoint": {
+      const pendingRaw = flags.get("pending");
       const result = await api.post("/api/execution-continuity/attempts/current/checkpoints", {
-        pendingSteps: parseStringArrayFlag(need(flags, "pending"), "pending"),
-        recoverability: need(flags, "recoverability"),
+        pendingSteps: pendingRaw === void 0 || pendingRaw.trim() === "" ? [] : parseStringArrayFlag(pendingRaw, "pending"),
+        ...flags.has("recoverability") ? { recoverability: flags.get("recoverability") } : {},
         durableRefs: flags.has("refs") ? parseArrayFlag(flags.get("refs"), "refs") : [],
         completedStepIds: flags.has("completed") ? parseStringArrayFlag(flags.get("completed"), "completed") : [],
         ...flags.has("trigger") ? { trigger: flags.get("trigger") } : {}
@@ -298779,7 +298826,7 @@ function shimScript() {
 }
 
 // src/index.ts
-var PKG_VERSION = true ? "2.2.86" : "dev";
+var PKG_VERSION = true ? "2.2.88" : "dev";
 var LOCAL_BIN = localBin();
 var NPM_PREFIX = npmPrefix();
 var INSTANCE = DEFAULT_INSTANCE;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oasis_test_v2",
-  "version": "2.2.86",
+  "version": "2.2.88",
   "description": "Oasis node daemon + CLI — background daemon, auto-start, full server CLI",
   "bin": {
     "oasis": "./dist/index.js"
@@ -26,6 +26,6 @@
     "node": ">=20"
   },
   "oasisRelease": {
-    "sourceHead": "b4a9ec478fa40119ad3a0360569d1a11af27336f"
+    "sourceHead": "1f98db00017415a0c5ddf248a1e5fe28aaa03acd"
   }
 }