@feng0531/dsh-execution-bus 0.2.8 → 0.2.10

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

package/dist/plugin.js

@@ -86,6 +86,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,27 +101,58 @@ 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,
                             };
                         },
                     });
                     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 () => {
-                        for (;;) {
-                            const view = await ctx.jobs.wait(job, 60000, ownerId);
-                            if (view.status !== "running" && view.status !== "stopping")
-                                break;
+                        try {
+                            for (;;) {
+                                const view = await ctx.jobs.wait(job, 60000, ownerId);
+                                if (view.status !== "running" && view.status !== "stopping")
+                                    break;
+                            }
+                            ctx.jobs.remove(job, ownerId);
+                        }
+                        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.
+                            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) {
+                                await hostSettlement;
+                                try {
+                                    ctx.jobs.remove(job, ownerId);
+                                }
+                                catch {
+                                    /* Best effort cleanup must not replace the original service error. */
+                                }
+                                throw error;
+                            }
+                        }
+                        finally {
+                            stopSettlementObserver();
                         }
-                        ctx.jobs.remove(job, ownerId);
                     })();
                     sharedJobs.set(jobKey, settled);
                     void settled.then(() => sharedJobs.delete(jobKey), () => sharedJobs.delete(jobKey));

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.9.md

@@ -0,0 +1,13 @@
+# 萧何 / Xiao He 0.2.9
+
+## BUG 修复
+
+修复终态 Job 被其他合法订阅者先行移除时，原工具调用错误返回 unknown job、无法交付已有执行结果的问题。等待及清理路径仅对当前调用创建的确切 Job 未找到错误、且同一 owner 查询确认已不存在时做幂等处理；继续等待原执行结果，不把记录移除当作成功。权限及其他服务异常仍明确失败，不一概吞掉。
+
+宿主 0.2.0-rc.2 未提供类型化 not-found 错误码，因此此兼容处理限定精确错误消息与已创建 Job 身份，不能推广为所有宿主版本的错误协议。
+
+## 验证与边界
+
+新增真实 Cordis/ToolRuntime/LocalJobs 回归，覆盖先行清理不覆盖成功及失败结果、交付标记更新、清理服务异常仍报错。缺陷用例修复前失败。全量与标签四矩阵 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.8",
+  "version": "0.2.10",
   "type": "module",
   "private": false,
   "license": "SEE LICENSE IN LICENSE",