dsh-punky-swarm 0.3.6

package/CHANGELOG.md

@@ -0,0 +1,120 @@
+
+## 0.3.6（2026-08-29）
+
+### 操作面板增强
+
+- 配置热更新：配置变更实时生效，无需重启（兼容 Windows 平台约束）。
+- 状态事件实时发布：状态变更经 topic 通道推送（swarm.<type>.<sid>.<bid> 命名）。
+- SSE 实时面板：新增 /stream 端点，EventSource 主通道 + 轮询降级 + 心跳恢复；客户端面板段逐字节同步。
+
+### 代码质量收敛
+
+- 事件常量单点化（发端/读端统一引用，消除字面量散落）。
+- git 工具函数单点下沉，消除双向依赖环。
+
+### 蟛蜞模式指引精简
+
+- 角色指引瘦身（Persona 精简、公共约束单一来源），配套密度校验脚本自动检查。
+
+### TypeScript 化（contract/gate 模块）
+
+- contract/gate 核心模块改为 TypeScript 源 + 编译产物双形态：`lib/schema`、`lib/state/gates`、`lib/state/machine-rules`、`lib/state/schema-v3`、`lib/wave-plan` 提供 `.ts` 源、`.d.ts` 类型声明与编译后 `.js`；新增 type-only 契约层 `lib/types/contracts`（运行时行为不变）。
+- 新增 `tsconfig.json` / `tsconfig.build.json` 与 `scripts/copy-ts-built.mjs` 构建链路（`npm run check` 类型检查 / `npm run build` 编译 + 产物归位）；devDependencies 引入 `typescript ^5.9.3`。
+
+## 0.3.4（2026-08-22）
+
+### dsh-tools 双版本兼容（compat-layer）
+
+- peer/devDependencies 的 `@deepseek-ai/dsh-tools` 改为 `^0.1.0-rc.6 || ^0.1.1-rc.2`，双版本兼容内核 0.1.0-rc.6 与 0.1.1-rc.2。
+
+## 0.3.3（2026-08-22）
+
+### 国标 AIP 兼容契约对齐（aip-gb-fix → aip-align-publish 合入主仓库）
+
+- **aip.enabled 默认开启**（readCapability 合并 `{enabled:true}`）；智能体描述改为 ACS 字段集（P4，根对象 20 键 必填 14/可选 6、AgentSkill 8 键，协议 02.01，旧 14+8 属性降级为 toLegacyDescriptor 兼容映射层）；消息映射对齐 ACPs AIP（P6，aip-format.js Message/TaskCommand/Session 三函数，mailbox/batch 附 ACPs 投影）；身份体系（P2/P3，默认关）：AIC 身份码（前缀 1.2.156.3088 + CRC-16/CCITT-FALSE + Base36）+ CAI 身份证书 + 可插拔签名（默认 ECDSA-P256/RSA-2048）；发现服务（P5/ADP，默认开）：`lib/discovery/` 新域 + `POST /api/dsh-punky-swarm/discover`（type 四类/filter 34 运算符/错误码 40000~40005/50001）+ `GET /.well-known/aip`；P7 工具 6 属性保持现状（待正式文本校准）。
+
+### ACPs 通讯方式（P1-P3，默认关）
+
+- **能力总开关默认关（U-D2）**：`acps.enabled` 与 `acps.endpoint.enabled` 均默认 `false`，关闭时零运行时路径；对外 mTLS 服务端点（P1）：独立 HTTPS 监听器（node:https/tls 原生、零新依赖），默认端口 9443/host 127.0.0.1、TLSv1.3 + 双向证书（CERT_REQUIRED）、端点 `POST /acps/rpc`（AIP JSON-RPC）+ `GET /.well-known/acs.json`（ACS 14 必填键 + mutualTLS + JSONRPC）+ `GET /health`，证书 CA 自签（CN=AIC/SAN=acps://AIC，默认 `<root>/acps/certs`）；内部桥接（P2，默认关）：`acps.bridge`（同进程双向，inbound 默认关 D14 需显式 `acps.bridge.inbound=true`；outbound = mailbox→ACPs 投影/投递；`/rpc→bridge 接线` DEF-V6-1，inbound=false 时协议级 rejected INBOUND_DISABLED）；registry 对接（P3/R1 半自动注册，默认关）：login→upsertAgent→submitAgent（人工工批不自动跳过）→requestEab→queryAcs，EAB macKey **AES-256-GCM 加密存证**（D13，与参考实现 SM4-CBC 标注差异）；discovery 对接（P3/DS1 ADP 客户端，默认关）：`POST {baseUrl}/discover` 查询外部 Agent（type 四类/34 运算符与本地共享协议常量），scope=local/external/both（默认 local）；能力注册表扩至 9 键（aip/identity/discovery/verify/watch/worktree/budget/trajectory/**acps**，acps 与 identity 为默认关能力）；未实现项如实标注（P4 工具调用待正式文本；SM2 签名无参考证据可插拔；DS3 mini-ADSP 仅预留签名；V2/V4 与参考实现真实互通待 demo 验证）。
+
+### 护栏根治 + 文档补建（aip-acps-cleanup）
+
+- T2.6 护栏 `\r?\n` 修复（merge-agent 护栏）；`README.en.md` 英文文档补建（22 KB，含中文互链）。
+
+## 0.3.2（2026-08-22）
+
+### 版本对齐推送
+- 版本更新至 0.3.2，对齐远程推送（GitHub punky971210/dsh-punky-swarm）
+- 许可合规（AGPL-3.0 唯一许可）与 npm 发布描述维护
+
+## 0.3.1（2026-08-21）
+
+### 许可合规修正 + npm 发布
+- 许可唯一化：全仓表述统一为 AGPL-3.0 唯一许可（AGPL-3.0-only），移除商业授权字段；其他授权一律「联系作者获得许可」（README.md / README.en.md / CHANGELOG 0.3.0 记载 / docs/OPENSOURCE.md）
+- 品牌残留清零：Swarm 集群品牌词全包改写为 dsh 语义历史沿革（README 中英 L22、SKILL.md L152/L195、CHANGELOG 历史记载）
+- npm 发布：dsh-punky-swarm@0.3.1 发布至 npm registry（`npm install -g dsh-punky-swarm`），README / docs/OPENSOURCE 安装章节同步更新
+- 本地库同步：D:\dsh\Punky-plugin 与发布包文本/版本号对齐（排除 backup/node_modules/backups）
+- 审计清理：docs/OPENSOURCE.md checklist LICENSE 项修正为 AGPL-3.0；本地库 package-lock.json root license 修正为 AGPL-3.0-only
+
+## 0.3.0（2026-08-21）
+
+### 0.3.0 发布：8 批次升级 + AGPL-3.0 唯一许可 + 治理能力默认全开
+- 8 批次能力升级：引擎修复（目录 consume 判定 / 产物根指引 / 难度门禁豁免）+ lib 四域解耦（43 文件，删 3 单体）+ 国标 AIP 兼容 + 7 能力域（资产/装配/桥接/通信/面板/状态/验证/监控）+ 生命周期 + 恢复机制
+- 测试 93 → 276 全绿（27 测试文件）
+- 许可切换：Apache-2.0 → AGPL-3.0 唯一许可（AGPL-3.0-only；其他授权一律联系作者获得许可，自 0.3.0 起）
+- 治理能力默认全开：wavePlan 三层 DAG + 引擎级门禁 + 状态机 + 锁/mailbox + 会话隔离
+
+## 0.2.2（2026-08-21）
+
+### 引擎修复 + README 边界修正
+- 修复：Windows 目录 consume 判定（fileExistsNonEmpty 目录 size 恒 0 误报 GATE_ENTRY_MISSING → 目录存在即视为产物存在，空文件仍拒）
+- 修复：产物根指引（任务包模板补「产物落盘」字段，worker 按引擎产物根落盘 / asset_claim 归位，双路径不一致根治）
+- 修复：子代理难度门禁豁免（guard 对 subagent 降级豁免 + session 解析对称，worker 执行型工具不再被难度门禁误拦）
+- README 边界修正：硬化=工程级门禁（dp1-dp4）确认已由 Tier3 实现，从「范围外」移除，Tier3 章节补 dp1-dp4 ↔ 门禁映射（README.md / README.en.md 1:1）
+
+## 0.2.1（2026-08-19）
+
+### Manager 代劳指挥协作架构 + role 残留清零
+- 新增 SKILL.md「Manager 角色派发模板」：Manager=代劳指挥（只指挥不执行、不派发子代理），指挥循环 5 步（batch_status 读黑板 → mailbox_send 建议派发 → mailbox_read 收通知 → member_status/settle 结算 → report 批次完成）；任务包模板补 worker 双通道回执约定（report→Leader 简短 + mailbox_send outbox→Manager 详细）
+- 新增 persona 纪律 0g Leader 唤醒协议：worker 由 Leader 派发（depth-1 直系）、Manager mailbox 建议、report→send_message 一行唤醒、Leader 不做调度决策（调度循环在 Manager 上下文）
+- manager.md 协作方式 5 要素更新：不派发子代理 / mailbox 建议派发 / 收 worker 通知 / member_settle 结算裁决 / worker 双通道回执
+- references/ 残留清零：constitution/workflow/call-chain-matrix-template/leader-decision-pack 4 文件 Swarm 集群运行时术语（HITL/HATL/Converge/任务包）改写为 dsh 语义（人审门禁/gap-list 对账/lane 任务）；role 8 文件重写（4 段骨架 dsh 工具面对齐）
+- 测试 93/93 全绿；安装链路验证（模块加载 + syncAssets 幂等）通过
+
+## 0.2.0（2026-08-19）
+
+### 任务难度值门禁（工程纪律落地）
+- 新增 assign_check 增强：scope（current/full，缺省 full）、输出 next/escalationHint/execToolCount/history；C 类 next=["wave_plan"]
+- 新增会话级治理状态 governance.json v2（read/write/bump/stale/hasActiveBatch，原子写，history 审计留痕）
+- 新增 guard 三重门禁（ctx.tools.guard）：门禁1 未评估/过期（execCallsSince>=20 或 >=30min）拒执行型工具；门禁2 判C未建批拒；门禁3 A类派 subagent 拒；非执行型豁免防死锁；计数与拦截分离；EXEC_TOOLS 可配置覆盖
+- 新增 asset_claim 工具（工具面 13->14）：Leader 直做产物归位为批次资产（防逃逸纵深 + asset.claimed 事件留痕）
+- config 贯通：apply 的 config 传入 createTools（config.escalation.execTools 覆盖名单，缺省回退）
+- persona 纪律 0 重写（难度路由门禁：每轮必评 A/B/C + default to C + scope=full + 惰性化）+ 新增 0e（Leader 不写实现）
+- jiufeng-team SKILL.md：移除"降级判定优先"判定策略（路由归蟛蜞模式），改造为 C 类触发后的执行机制 + 任务包最小结构模板（两副本同步）
+- 资产同步 syncAssets 幂等（预设/技能字节一致跳过，mtime 容差）
+- 单测 68->93（governance 15 + asset/config 5 + 扩 5）
+# Changelog
+
+本项目尚未发布；以下按时间线记录 0.1.0 未发布期间的主要变更。
+
+## 0.1.0（未发布）
+
+### 2026-08-17 · 引擎初版
+- 10 治理工具：wave_plan / batch_phase / batch_status / lane_claim / lane_release / member_status / member_settle / mailbox_send / mailbox_read / mailbox_ack；
+- 状态机（成员 pending→…→merged|failed|skipped|conflict；批次 planning→…→complete）+ 原子写 + 锁 + mailbox + 恢复语义；
+- 29 单测。
+
+### 2026-08-19 · Tier3 三层门禁回填
+- 新增 assign_check（委派形态判定 A/B/C）与 gate_status（门禁状态查询），工具面 10→12；
+- wavePlan 层契约：layer ∈ plan/exec/audit、有 exec 必有 audit、路径契约、跨层引用校验、防篡改；
+- 引擎级门禁：Entry（consume 齐备）/ L0（spec 必填章节）/ Exit（outputs/produce 存在）/ Complete（audit 全终态）；
+- assembly 可插拔装配（jiufeng 默认）+ 会话隔离 v2（sessions/<id> + legacy 迁移）；
+- 单测 29→68。
+
+### 2026-08-20 · 产物注册表与门禁可视 + 开源准备
+- 新增 artifact_types（产物类型注册表），工具面 12→13；
+- API lanesGate、client GateBadge / AttemptBadge；
+- 开源材料：LICENSE（Apache-2.0）、CI、CHANGELOG、CONTRIBUTING、三件套入包（presets/jiufeng + skills/jiufeng-team）；
+- 修复：test script（node --test test/ → node --test，兼容 Windows/Node24）、peerDependencies 补 @deepseek-ai/dsh-tools。
+
+