dsh-punky-swarm v0.5.1

dsh-punky-swarm v0.5.1

0.5.1 发布版：R-1（唯一发布阻塞）已解 —— 版本史与版本面结构性对齐；判据尺子固化为可重跑脚本；锚点类文档回补入库。

主要变更（v0.5.0..v0.5.1，2 commits）

发布面

• R-1 落版：package.json 早已是 0.5.0，而版本史顶部仍是「未发布（Unreleased）」、首版本标题停在 ## 0.4.4。本次真落——原「未发布」段体落版为 ## 0.5.0（2026-10-12）（段体一字未改），并在其上新建 ## 0.5.1（2026-10-14） 段；CHANGELOG 总行数 681 → 704；版本行 → 0.5.1。
• 锚点类文档入库（PA-1）：docs/ 54 件逐件 git add -f（禁通配）。根因 = .gitignore:50 忽略整个 docs/**，且 :49 记录 2026-10-10 已 rm --cached 49 件 ⇒ 属「在库 → 只在工作树」的退化（不是从未入库）。入库后三读数 37/37 符合预期（check-ignore 仍报 :50 = 规则未改）。

修复

• 注释断言的不变量为假（F-1）：lib/sig-fingerprint.js:35 原注「不进 GateErrorCode union（拒码面恒 29 保持不变）」已为假 —— 实测 union = 37（contracts.ts 与 contracts.d.ts 双口径一致）。⇒ 改为指向 lib/types/contracts.ts 的 union 为唯一真源、不写数字（规模随授权批演进，写死即漂移源）。改动面 = 恰 1 减 1 加、两行均注释行，node --check 双态 exit 0。
• 判据命令漏计（D-04）：原命令只覆盖双引号 ⇒ 26 ≠ 32。实测病根是两条叠加：
  • 引号：+4（全在 lib/tools/lane-tools.js 的单引号 name）；
  • 扫描面：+2（lib/watch/lane-heartbeat.js 的 2 件 defineTool —— 不在 lib/tools/*.js 内）。
    ⇒ 「只补引号」天花板为 30，要摸到 32 必须扩扫描面。已固化为 scripts/audit/tool-face-count.mjs（按块解析 + 四口径阶梯 + 三态退出码）。

新增技能

• skills/video-team/：三层 7 角色 team skill（plan coordinator·designer ／ exec producer·captioner·motion-designer·audio-engineer ／ audit supervisor）+ constitution.md（6 章 24 条）+ 模板 6 件 + scripts/check-video-team-density.mjs（S1–S7 机检，含可达反例）。

安装 / 升级

npm i dsh-punky-swarm@0.5.1

已知项（登记，不影响本次发布）

• requiredKeys 基线 63 在五个候选口径下均复现不出（实测 24）⇒ 判「基线需订正」，已在批次 gap-list 登记，未进发布面。
• EXCLUDE_DIRS 为精确名集合（非前缀匹配）⇒ 抓不住 .tmp-* 变体；其当前安全性来自「位置（不在任何 walk 根内）而非过滤器」⇒ 已登记为防御缺口。
• docs/ 面引用均为「字符串提及」（探针 59 命中行逐条判过），不构成 CI 读依赖。

dsh-punky-swarm v0.5.0

dsh-punky-swarm v0.5.0

0.5.0 定基线版：团队资产（team-asset）与 chain 声明面整体退役，装配改为「引擎基线 + 成员槽位 + 指引」；运行期 DAG 真源 = 批次 lanes[].deps + handoffs。

主要变更（v0.4.4..v0.5.0，218 commits）

引擎治理

• 成员回报唤醒修复：swarm_report 唤醒改为按 agent 亲缘（parentSession） 寻址；主路 subagent/end 唤醒改为按派发期登记的 ownerSessionId 寻址。修复前，后台批挂在命名黑板上时唤醒会落到非活跃会话而静默失败（后台批的成员永远叫不醒 Leader）。
• 完成类回报（completed）唤醒 Leader，与结算解耦；新增「可派发候选」提示。
• assign_check 在跑批期间不降档守卫（防止治理工具面被静默收窄）。
• auto-settle 配置开关（缺省保持兼容）。
• 建批期新增 consume × deps 对称性硬门。

指引与角色面

• 新增纪律 §0u「执行前经验检索（knowledge-first）」。
• role 注入面去路径化，新增 role_guide 取件口与 renderRoleGuide 单点渲染。
• 治理纪律口径入册为 27 条 / 9 组。

面板与性能

• 面板波 A / 波 B：主题令牌化、池化渲染、摘要与状态机口径。
• 性能三刀：watch tick 合并、governance 计数节流落盘、面板读放大并发化。

仓库面

• README 精简为项目介绍（中文 244 → 104 行 / 英文 242 → 102 行），不再承担文档跳转。
• docs/ 移出 git 索引（仍随 npm 包分发）；仅保留被测试读盘的 2 份集成文档。

兼容性

• 目标宿主线：@deepseek-ai/dsh 0.2.0-rc.1；0.1.7 仅历史兼容、不再验证（peerDependencies 范围不动，不主动拒装）。
• 测试基线：154 个测试文件 / 1656 个测试 / 7940 条断言，全绿（Node 24）。
• 许可：AGPL-3.0-only。

CI 状态

全绿。 本版发布时点（tag v0.5.0 → 3ecf4e8）CI 尚有两处红，均在发布后当日修复，main 现已全绿：

红灯	根因	修复
T15 目录/文件声明形态二分	测试夹具平台缺陷：夹具用带尾斜杠的路径落盘，POSIX 下 writeFileSync('…/weird/') 抛 EISDIR（Windows 容忍） ⇒ 测试在引擎跑之前崩	3a8dc00：落盘前去尾斜杠，语义不变
I-6(a) 对真实 home 零写入	CI 环境前置缺失：断言要求真实 home 下有技能/预设文件，干净 runner 没有 ⇒ files=0	3a8dc00：CI 增一步预置最小基线（使守卫在 CI 上非空转）
e2-1 基线自洽	上述测试文件改动致基线 lines 漂移	e7aff44：重算 baselines/test-baseline.json（tests/asserts 零变化）

tag v0.5.0 已前移至 e7aff44（含上述三个修复提交），与 main 同指一处 ⇒ 取 v0.5.0 与取 main 得到同一份全绿状态。前移前已核实 3ecf4e8..e7aff44 仅动 ci.yml / baselines/ / test/ 三个文件、lib/** 零改动，且两端 package.json 版本同为 0.5.0（发布内容无实质变化）。

dsh-punky-swarm v0.4.4

0.4.4（2026-09-08）

批次事件结局分型（恢复与回收记账）

• 恢复路径记 crashed：进程崩溃重启后，恢复流程将崩溃前处于运行/评审中的 lane 置回待派发（idle），恢复事件为该类 lane 逐一记结局 crashed，并保留原态与既有审计字段——重派前可经事件流查询哪些 lane 系因崩溃中断。
• 回收处置记 interrupted：running lane 具备停滞证据、被显式回收脱离在飞态（置回 idle 待重派）时，回收事件记结局 interrupted。
• 默认开启、只记不改：结局记账自动生效，不构成新的成员状态、不改变既有成员迁移/拦截/结算语义，也不介入重派决策（重派仍走既有待派发→运行通道）；未带结局的旧事件与旧批次读取零迁移兼容。

评审与验收结论结构化必填

• 评审（review）与验收（acceptance）产出的结论必须结构化携带三要素并置于报告头部：① 结论 approve / reject（显式二选一）；② 阻断项清单（reject 时必列，验收侧与既有对账衔接）；③ 跟进项清单（后续动作与遗留观察，可为空）。
• 空结论即评审未完成：缺失 approve / reject 结论、或以一句笼统表态（如「总体没问题」「建议合并」「验收通过」）替代三要素的，视为评审未完成，可打回补全（沿用既有驳回语义）。

批次级装配声明与规模批门禁

• wave_plan 建批新增可选顶层参数 assembly（批次级装配声明）：managerPlan（编排牵头形态：raise=拉起编排 Manager 代管调度 / leader-direct=任务负责人直管派发）与 auditLane（验收归属 lane）必填，coordinatorLane / roles 可选。
• 规模批强制：三层批且 exec 层任务（lane）数达 3 个及以上时装配声明必填——声明缺失、结构非法、或所引 lane 不存在/层错配将拒绝建批（无批次落盘，补齐声明后重试）；roles 词条格式异常仅告警、不阻断。
• 声明随批次持久化与回显：归一化声明写入批次数据顶层（可选字段、schema 不升；未声明不写键，既有批次零迁移），建批返回值附装配声明视图。

模式装配与纪律条文更新

• 难度路由扩档：模式预设难度路由在 A/B/C 之上新增规模批档 C+（三层批且 exec 层任务达 3 个及以上，与引擎装配门禁同一判定口径）；此类批次进入运行后须先拉起编排 Manager（首个 exec 任务派发前完成），任务负责人的兜底代行与豁免留痕仅限普通批次，边界条文同步更新。
• 装配履职条文：按需装配的细拆/架构复核角色须先经代码图谱建立与复核代码索引（细拆与架构复核依据可追溯）；评审/验收结构化结论条文见前节。
• 新增纪律条文：消费方契约摸底先行（实现消费宿主接口、外部 DSL 与框架扩展点前，先落契约摸底产物并作为实现前置契约）与宿主级自验证（产出完成判据须含真实宿主加载/启动冒烟，语法与局部级检查不作完成判据）。

发布整理

• 版本 0.4.3 → 0.4.4；变更记录整理与发布前内部口径清查。

dsh-punky-swarm 0.4.3

0.4.3（2026-09-07）

调用级护栏拒绝可见性

• 工具调用送入人工审批后被护栏拦截（含审批服务不可达、无可用 agent 等降级情形）时，Agent 收到的拒绝不再只是泛化提示，而携带护栏标注、命中规则、违规说明与查阅路径——可按违规说明修正参数后重发合规调用；非拦截场景行为保持不变。
• 拒绝文本末尾追加命中规则及预设归属，人工审批请求与直接拒绝路径均携带，批准/拒绝前即可核对所触发的具体规则。
• 行为说明随双语主题文档 guardrails-hook 同步更新。

护栏预设逐条审阅清单

• presets/hook-rules 新增逐条规则审阅清单：敏感数据防护 12 条与资源边界 6 条，按规则编号 / 预设归属 / 类别 / 生效原语 / 触发工具 / 匹配摘要 / 违规说明逐条成表，供用户与 Agent 主动审阅护栏规则全集；配套一致性断言守护清单与规则文件同步。

发布整理

• 版本 0.4.2 → 0.4.3；变更记录整理与发布前口径清查。

dsh-punky-swarm v0.4.2

治理配置面板：Lane 过期检测与重派探针

• 治理配置页新增 Lane 过期检测 与 长跑超时重派探针 两级开关：前者控制 running lane 的心跳过期扫描，后者控制长时间无 checkpoint / 活动进展 lane 的重派候选探测。开关随护栏共用同一保存通道写入运行配置，保存即热更生效，进程重启后按 runtime.json 自动对账，无需重复设置；出厂默认开（缺省即开、显式关闭才停），关闭仅停止扫描与候选探测，不改动已落盘批次 / 成员状态，重新开启后自基线恢复扫描。
• 长跑时间窗口面板化：超时窗口（默认 20 分钟）与无进展窗口（默认 5 分钟）可在表单以分钟输入，保存时自动换算毫秒生效，无需手工编辑配置文件。
• 「违规自动升级」说明文案优化：直接说明触发次数 / 窗口阈值的判定与升级暂停行为，去除括号提示与实现细节，降低配置理解成本。
• 配套新增回归测试：覆盖开关保存热更、进程重启对账与长跑无进展候选场景。

无 Manager 批次的长跑候选消费

• 未拉起编排 Manager 的批次运行期间，由任务负责人兜底承担长跑候选消费：读取候选广播、核对 lane 探针状态与 checkpoint / 活动进展，按半自动规则裁决继续观察或重新派发；已拉起 Manager 的批次仍由 Manager 完成调度。

注释与文档口径统一

• 「出厂默认开、显式关闭才停」口径统一：Lane 过期检测与长跑探针的默认开启说明跨代码注释、预设说明与双语文档对齐（纯注释与文档改动，零逻辑变更）。