@feng0531/dsh-execution-bus 0.2.5 → 0.2.6

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

package/dist/bus.js

@@ -68,7 +68,8 @@ export class ExecutionBus {
         retentionMs: 3600000,
     }) {
         this.options = options;
-        for (const v of Object.values(options))
+        this.options = Object.freeze({ ...options });
+        for (const v of Object.values(this.options))
             if (!Number.isSafeInteger(v) || v < 1)
                 throw Error("INVALID_OPTIONS");
     }
@@ -147,12 +148,13 @@ export class ExecutionBus {
             const previous = e.messages.get(m.messageId);
             if (previous && previous !== canonical(m))
                 throw Error("MESSAGE_CONFLICT");
-            if (!previous) {
-                if (e.messages.size >= 128)
-                    throw Error("MESSAGE_LIMIT");
+            if (!previous && e.messages.size >= 128)
+                throw Error("MESSAGE_LIMIT");
+            // Acquire the attachment before committing its message identity. Rejection is side-effect free.
+            const attached = this.attachment(e, onEvent, m.messageId);
+            if (!previous)
                 e.messages.set(m.messageId, canonical(m));
-            }
-            return this.attachment(e, onEvent, m.messageId);
+            return attached;
         }
         const handler = this.handlers.get(p.handler)?.handler;
         if (!handler)

package/docs/protocol.md

@@ -31,7 +31,7 @@ queued → cancelled。终态不可变；取消终态任务只返回原状态。
 
 ## 容量和清理
 
-默认并发 2，待分发队列 32，记录 256，单结果 JSON 64 KiB；所有请求先经上限检查，满则 BACKPRESSURE，不自动重试。Job 仍受宿主自己的每 owner 容量限制。队列不提供公平性 SLA，单会话可占满实例。
+默认并发 2，待分发队列 32，记录 256，单结果 JSON 64 KiB；所有请求先经上限检查，满则 BACKPRESSURE，不自动重试。Job 仍受宿主自己的每 owner 容量限制。队列不提供公平性 SLA，单会话可占满实例。core 构造时复制并冻结容量配置，之后修改调用方原对象不改变总线限制；没有动态配置更新接口。重复附着只有成功取得观察者名额后才提交新消息记账，WAITER_LIMIT 拒绝不占用消息 ID 或额度。
 
 终态自完成后保存一小时；新受理及控制消息查询时惰性清理，可通过 core.sweep 主动清理。无定时器常驻、无磁盘结果存储、无日志输出。插件关闭先停止受理，取消队列与运行任务，等待合作 Handler，清理内存；不合作的 Handler 会阻碍关闭，插件无法安全硬杀同进程代码。
 

package/docs/releases/0.2.6.md

@@ -0,0 +1,14 @@
+# 萧何 / Xiao He 0.2.6
+
+## BUG 修复
+
+- 重复附着在取得观察者名额后才提交消息记账，WAITER_LIMIT 拒绝不再占用消息编号或耗尽后续查询/结果重取额度。已有重复识别和取消保留槽语义不变。
+- 容量配置在构造时复制并冻结，不再保留调用方可变引用；外部修改原配置不改变队列、记录、并发或结果大小限制。
+
+## 验证
+
+新增两项回归在修复前均失败，覆盖 96 次拒绝附着后消息编号可用和结果可重取、外部配置修改不影响限制。全量回归、标签四矩阵 CI、包白名单和生产依赖隔离安装按既有门禁执行。
+
+## 边界
+
+只修复 core 接口边界，不新增业务执行能力或动态配置接口。DSH 0.2.0-rc.2；非商业源码公开许可。真实模型/GUI/PTC 完整链路未验收，不支持跨重启恢复。发布不自动安装或重启 DSH。

package/package.json

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