@feng0531/dsh-execution-bus 0.2.10 → 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.10**
+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.10
+   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.10 发布说明](<docs/releases/0.2.10.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";
@@ -107,12 +108,6 @@ export function apply(ctx) {
                         },
                     });
                     const ownerId = exec.agent.id;
-                    let hostCommitted;
-                    const hostSettlement = new Promise(resolve => { hostCommitted = resolve; });
-                    const stopSettlementObserver = ctx.jobs.events.subscribe({ owner: ownerId }, event => {
-                        if ((event.type === "settled" || event.type === "removed") && event.job.id === job && event.job.owner === ownerId)
-                            hostCommitted();
-                    });
                     // One registered host waiter suppresses extra completion messages for every attachment.
                     settled = (async () => {
                         try {
@@ -140,19 +135,30 @@ export function apply(ctx) {
                             // attached, drain both producer and host outcome, then attempt cleanup once.
                             await attached.done;
                             if (!alreadyRemoved) {
-                                await hostSettlement;
-                                try {
-                                    ctx.jobs.remove(job, ownerId);
-                                }
-                                catch {
-                                    /* Best effort cleanup must not replace the original service error. */
+                                // 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;
                             }
                         }
-                        finally {
-                            stopSettlementObserver();
-                        }
                     })();
                     sharedJobs.set(jobKey, settled);
                     void settled.then(() => sharedJobs.delete(jobKey), () => sharedJobs.delete(jobKey));

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.10",
+  "version": "0.2.11",
   "type": "module",
   "private": false,
   "license": "SEE LICENSE IN LICENSE",