@feng0531/dsh-execution-bus 0.2.9 → 0.2.11

package/README.md

@@ -4,7 +4,7 @@
 
 “萧何”是产品与模式显示名，执行总线是其技术功能；不新增人物 Agent，不进行角色扮演。仓库 dsh-execution-bus、npm 包名、execution_bus 工具名及 execution-bus-test 预设 ID 保持不变。历史版本发布说明保留当时名称。
 
-DSH 独立插件：`@feng0531/dsh-execution-bus` · 当前版本 **0.2.9**
+DSH 独立插件：`@feng0531/dsh-execution-bus` · 当前版本 **0.2.11**
 
 > 当前是早期可运行版本，不是完整生产验收版。已验证真实 DSH 组件和脚本模型驱动的内存会话；真实模型、桌面界面和 PTC 完整链路尚未验收。**不支持重启后恢复任务。**
 
@@ -102,7 +102,7 @@ flowchart TD
 2. 在你选定的隔离 DSH 配置依赖目录安装固定版本，不要在 DSH 程序安装目录执行：
 
    ```powershell
-   npm install --ignore-scripts @feng0531/dsh-execution-bus@0.2.9
+   npm install --ignore-scripts @feng0531/dsh-execution-bus@0.2.11
    ```
 
    这是 npm 目录示例。若目标配置使用 pnpm，应沿用其包管理器，不混用锁文件。遇到宿主 peer 版本冲突就停止，不用强制安装绕过。
@@ -231,7 +231,7 @@ npm run test:install    # 临时目录安装，不操作日常 DSH
 
 - [协议和投递语义](<docs/protocol.md>)：字段、状态、重复处理与取消规则。
 - [宿主兼容性与源码调用链](<docs/host-compatibility.md>)：为什么可以等待，为什么不能跨重启恢复。
-- [验证记录](<docs/validation.md>)、[0.2.9 发布说明](<docs/releases/0.2.9.md>)：已验证与未验证范围。
+- [验证记录](<docs/validation.md>)、[0.2.11 发布说明](<docs/releases/0.2.11.md>)：已验证与未验证范围。
 - [维护者发布流程](<docs/RELEASING.md>)：标签 CI、安装包校验与正式发布门禁。
 
 ## 许可

package/dist/plugin.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { setTimeout as pause } from "node:timers/promises";
 import { ExecutionBus, parse } from "./bus.js";
 import { testHandler, readHandler } from "./handlers.js";
 export const name = "execution-bus";
@@ -86,6 +87,14 @@ export function apply(ctx) {
             let settled = sharedJobs.get(jobKey);
             if (!settled) {
                 try {
+                    const outcome = attached.done.then((v) => ({
+                        status: v.state === "succeeded"
+                            ? "completed"
+                            : v.state === "cancelled"
+                                ? "killed"
+                                : "failed",
+                        detail: v.state,
+                    }));
                     const job = ctx.jobs.start({
                         kind: "execution-bus",
                         label: "萧何 / Xiao He",
@@ -93,14 +102,7 @@ export function apply(ctx) {
                         run(h) {
                             handle = h;
                             return {
-                                done: attached.done.then((v) => ({
-                                    status: v.state === "succeeded"
-                                        ? "completed"
-                                        : v.state === "cancelled"
-                                            ? "killed"
-                                            : "failed",
-                                    detail: v.state,
-                                })),
+                                done: outcome,
                                 cancel: abort,
                             };
                         },
@@ -119,12 +121,43 @@ export function apply(ctx) {
                         catch (error) {
                             // rc.2 has no typed not-found code. Match only this minted Job and
                             // confirm absence in the original owner scope; never swallow access/service errors.
-                            if (!(error instanceof Error) ||
-                                error.message !== `unknown job ${job}` ||
-                                ctx.jobs.list(ownerId).some((view) => view.id === job))
-                                throw error;
-                            // Record cleanup is not execution completion. Drain the original result.
+                            let alreadyRemoved = false;
+                            try {
+                                alreadyRemoved =
+                                    error instanceof Error &&
+                                        error.message === `unknown job ${job}` &&
+                                        !ctx.jobs.list(ownerId).some((view) => view.id === job);
+                            }
+                            catch {
+                                /* Preserve the original wait/cleanup error. */
+                            }
+                            // A broken wait channel does not terminate execution. Keep caller cancellation
+                            // attached, drain both producer and host outcome, then attempt cleanup once.
                             await attached.done;
+                            if (!alreadyRemoved) {
+                                // No scope-owned observer: teardown can remove it before settlement.
+                                // After producer drain, allow a bounded host commit window. This is
+                                // program-side cleanup only, never execution retry or model polling.
+                                for (let attempt = 0; attempt < 20; attempt++) {
+                                    try {
+                                        const view = ctx.jobs
+                                            .list(ownerId)
+                                            .find((view) => view.id === job && view.owner === ownerId);
+                                        if (!view)
+                                            break;
+                                        if (view.status !== "running" &&
+                                            view.status !== "stopping") {
+                                            ctx.jobs.remove(job, ownerId);
+                                            break;
+                                        }
+                                    }
+                                    catch {
+                                        break;
+                                    }
+                                    await pause(10);
+                                }
+                                throw error;
+                            }
                         }
                     })();
                     sharedJobs.set(jobKey, settled);

package/docs/releases/0.2.10.md

@@ -0,0 +1,13 @@
+# 萧何 / Xiao He 0.2.10
+
+## BUG 修复
+
+Job 等待通道或清理服务异常时，不再在执行仍运行中提前结束原工具调用。保留调用方取消监听，等待原执行和宿主 outcome 达到终态，再尽力清理并返回原服务错误。不会因通信失败自动重跑或误记执行失败。
+
+确切所属 Job 已被先行移除的幂等处理保持不变。其他异常仍明确失败；二次查询或清理失败不替换原错误。若清理服务持续不可用，记录仍可能保留至宿主所属生命周期清理，不声称保证删除。
+
+## 验证与边界
+
+新增两项真实宿主组件故障注入：等待立即失败时原调用返回前任务已达成功终态且 Job 已清理；等待与清理同时失败仍保留原始错误。用例修复前均失败。全量回归、标签四矩阵 CI 和发布包验证按既有门禁执行。
+
+不合作的 Handler 仍可能阻碍排空。真实模型、GUI 与 PTC 完整链路未验收，不支持跨重启恢复。兼容 DSH 0.2.0-rc.2，非商业源码公开许可；不自动安装或重启 DSH。

package/docs/releases/0.2.11.md

@@ -0,0 +1,13 @@
+# 萧何 / Xiao He 0.2.11
+
+## BUG 修复
+
+移除等待异常排空对作用域内 Job 终态观察者的依赖，修复等待服务先失败、随后 Agent/插件作用域卸载时，监听器先被解除导致原调用及卸载永久等待的问题。
+
+异常路径始终先等待原执行达到终态，保留原服务错误；之后按原 owner 查询确切 Job 的状态，最多进行 20 次、间隔 10 毫秒的程序侧清理检查。该有界窗口只等待宿主记录提交，不会放弃仍运行的 Handler、调用模型轮询或重试执行。服务持续不可用时保留原错误，记录可能延后由宿主生命周期清理。
+
+## 验证与边界
+
+新增真实 Cordis/ToolRuntime/LocalJobs 有界回归：等待失败后销毁作用域，原调用与卸载都能结束且 Job 清空。修复前该用例 4 秒超时。正常等待、先行移除、等待与清理故障继续回归。正式发布仍执行完整 CI 和同包门禁。
+
+兼容 DSH 0.2.0-rc.2，非商业源码公开许可。真实模型、GUI 和 PTC 完整链路未验收，不支持跨重启恢复；不安装或重启 DSH。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feng0531/dsh-execution-bus",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "type": "module",
   "private": false,
   "license": "SEE LICENSE IN LICENSE",