dsh-punky-swarm 0.3.6 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/CHANGELOG.md +52 -3
  2. package/LICENSE +661 -661
  3. package/README.en.md +131 -281
  4. package/README.md +77 -227
  5. package/cordis.patch.yml +45 -0
  6. package/docs/acps-communication.en.md +85 -0
  7. package/docs/acps-communication.md +85 -0
  8. package/docs/aip-compliance.en.md +64 -0
  9. package/docs/aip-compliance.md +64 -0
  10. package/docs/governance-boundaries.en.md +46 -0
  11. package/docs/governance-boundaries.md +46 -0
  12. package/docs/governance-technical.en.md +184 -0
  13. package/docs/governance-technical.md +184 -0
  14. package/docs/guardrails-hook.en.md +188 -0
  15. package/docs/guardrails-hook.md +188 -0
  16. package/docs/single-machine-capabilities.en.md +44 -0
  17. package/docs/single-machine-capabilities.md +44 -0
  18. package/docs/webui-governance-config.en.md +61 -0
  19. package/docs/webui-governance-config.md +61 -0
  20. package/lib/acps/certs.js +310 -310
  21. package/lib/acps/discovery-client.js +283 -283
  22. package/lib/acps/registry-client.js +527 -527
  23. package/lib/acps/server.js +302 -302
  24. package/lib/aip/agent-descriptor.js +170 -170
  25. package/lib/aip/identity.js +469 -469
  26. package/lib/aip/tool-descriptor.js +93 -93
  27. package/lib/api.js +331 -266
  28. package/lib/assembly/audit-blind-review.js +170 -170
  29. package/lib/assembly/schema.js +253 -253
  30. package/lib/bridge/dispatch-register.js +132 -0
  31. package/lib/bridge/trajectory.js +205 -202
  32. package/lib/client.js +700 -2
  33. package/lib/comms/acps-bridge.js +219 -219
  34. package/lib/comms/aip-format.js +141 -141
  35. package/lib/comms/budget.js +124 -124
  36. package/lib/comms/topic.js +115 -115
  37. package/lib/discovery/filter.js +199 -199
  38. package/lib/discovery/service.js +251 -251
  39. package/lib/governance/classify.d.ts +15 -0
  40. package/lib/governance/classify.js +82 -0
  41. package/lib/governance/classify.ts +111 -0
  42. package/lib/governance/config.d.ts +46 -0
  43. package/lib/governance/config.js +308 -0
  44. package/lib/governance/config.ts +325 -0
  45. package/lib/governance/decisions.d.ts +12 -0
  46. package/lib/governance/decisions.js +48 -0
  47. package/lib/governance/decisions.ts +68 -0
  48. package/lib/governance/escalation.js +70 -0
  49. package/lib/governance/hash-utils.js +77 -0
  50. package/lib/governance/index.d.ts +7 -0
  51. package/lib/governance/index.js +26 -0
  52. package/lib/governance/index.ts +28 -0
  53. package/lib/governance/kernel.d.ts +16 -0
  54. package/lib/governance/kernel.js +205 -0
  55. package/lib/governance/kernel.ts +220 -0
  56. package/lib/governance/narrow.d.ts +17 -0
  57. package/lib/governance/narrow.js +112 -0
  58. package/lib/governance/narrow.ts +125 -0
  59. package/lib/governance/preset-loader.d.ts +16 -0
  60. package/lib/governance/preset-loader.js +86 -0
  61. package/lib/governance/preset-loader.ts +92 -0
  62. package/lib/governance/receipt-store.js +303 -0
  63. package/lib/governance/state-store.js +140 -0
  64. package/lib/governance/types.d.ts +89 -0
  65. package/lib/governance/types.js +17 -0
  66. package/lib/governance/types.ts +144 -0
  67. package/lib/governance/wiring.js +280 -0
  68. package/lib/hot/config-watch.js +5 -3
  69. package/lib/index.js +613 -433
  70. package/lib/panel/gov-config.js +637 -0
  71. package/lib/panel/locales.js +70 -2
  72. package/lib/panel/main.js +10 -0
  73. package/lib/state/archive.js +174 -174
  74. package/lib/state/corrupt-registry.js +103 -103
  75. package/lib/state/event-types.js +15 -0
  76. package/lib/state/machine.js +68 -68
  77. package/lib/state/resume.js +201 -201
  78. package/lib/state/store.js +687 -607
  79. package/lib/tools/core.js +323 -323
  80. package/lib/tools/lane-tools.js +460 -455
  81. package/lib/tools/log-tools.js +173 -173
  82. package/lib/tools/mailbox-tools.js +121 -121
  83. package/lib/tools/merge-agent.js +127 -127
  84. package/lib/tools/register.js +85 -85
  85. package/lib/types/contracts.d.ts +13 -0
  86. package/lib/types/contracts.ts +2 -0
  87. package/lib/verify/gate.js +161 -161
  88. package/lib/verify/mount.js +48 -48
  89. package/lib/watch/lane-heartbeat.js +572 -333
  90. package/lib/webui/config-trust.js +62 -0
  91. package/lib/webui/runtime-config.js +298 -0
  92. package/package.json +16 -2
  93. package/presets/hook-rules/README.md +63 -0
  94. package/presets/hook-rules/compose.json +209 -0
  95. package/presets/hook-rules/l1-sensitive.json +143 -0
  96. package/presets/hook-rules/l2-resource.json +82 -0
  97. package/presets/jiufeng/NOTICE +5 -5
  98. package/skills/jiufeng-team/SKILL.md +214 -214
  99. package/skills/jiufeng-team/references/constitution.md +62 -62
  100. package/skills/jiufeng-team/references/roles/coder.md +17 -17
  101. package/skills/jiufeng-team/references/roles/coordinator.md +13 -13
  102. package/skills/jiufeng-team/references/roles/designer.md +14 -14
  103. package/skills/jiufeng-team/references/roles/doc-manager.md +13 -13
  104. package/skills/jiufeng-team/references/roles/manager.md +22 -22
  105. package/skills/jiufeng-team/references/roles/reviewer.md +19 -19
  106. package/skills/jiufeng-team/references/roles/supervisor.md +13 -13
  107. package/skills/jiufeng-team/references/roles/tester.md +13 -13
  108. package/skills/jiufeng-team/references/templates/success-pattern-seeds.md +126 -126
  109. package/skills/jiufeng-team/references/workflow.md +98 -98
package/CHANGELOG.md CHANGED
@@ -1,3 +1,52 @@
1
+ ## 0.4.1(2026-09-05)
2
+
3
+ ### 治理预设规则包
4
+
5
+ - 出厂护栏规则预设随包发布(presets/hook-rules):l1-sensitive(L1 敏感数据防护 12 条)、l2-resource(L2 资源上限 6 条)、compose(L1+L2 全量 18 条),wrapper 结构(`_meta` 元数据 + `rules` 数组),规则字段与引擎 Rule 类型逐字段对齐、零扩展字段。
6
+ - preset 装载与引用:装载器剥离 `_meta` 取 rules 并做受控资产早失败校验;`governance.hook.preset` 支持注册 id / id 数组引用(如 `"preset": "compose"` 或 `["l1-sensitive","l2-resource"]`),跨 preset 规则 id 全局唯一性校验拒绝重复。
7
+
8
+ ### Web UI 治理配置页 + runtime.json 写通道
9
+
10
+ - 治理配置设置页(Web UI 设置区):护栏开关、规则预设、违规自动升级(触发次数 / 窗口)可视化配置;页面保存即时生效、无需重启。
11
+ - runtime.json 热写通道:保存请求经 config-trust 校验(顶层白名单 / 值域 / preset 与内联规则冲突守卫)后落盘 runtime.json,400 校验拒绝不回写;窗口秒输入后端毫秒归一化(windowSeconds → windowMs,线协议键不落盘)。
12
+ - 随包双语主题文档:docs/webui-governance-config(.en).md。
13
+
14
+ ### lane_longrun 超时无进展探针
15
+
16
+ - watch 长跑档(默认开启):running lane 运行超时且长期无 checkpoint / 活动进展 → 产候选并广播给 Manager(探针只产候选,不改成员状态),重派裁决归 Manager / Leader。
17
+ - 与心跳 stalled 档并列扫描;事件留痕可审计。
18
+
19
+ ### Web UI 修复
20
+
21
+ - 治理配置页 UI 修复:重命名、preset 多选、放大字号、移除全组合提示。
22
+
23
+ ### 发布整理
24
+
25
+ - 版本 0.4.0 → 0.4.1;根 README(GitHub 面)精简:170 → ≈100 行,中文 / 英文 1:1 同构重写,去除过期版本与测试数(实测刷新 816);删除 README.market.md(人话版内容并入精简后根 README 机制表与能力段)。
26
+
27
+ ## 0.4.0(2026-09-03)
28
+
29
+ ### 工具调用级治理护栏
30
+
31
+ - 引导层挂载 + 运行时接线:治理钩子随引导装配挂载(bootoverlay),运行期 wiring 接线,工具调用进入统一裁决链。
32
+ - 6 原语裁决内核:classify / config / decisions / escalate / narrow / proto 域分层裁决,处置原语含 ALLOW / DENY / REQUIRE_APPROVAL / DEFER / NARROW / PAUSE。
33
+ - 拒绝收据锚定 + 哈希链防篡改:违规判定与处置落盘拒绝收据(receipt-store),锚定 prevHash 级联哈希(hash-utils),链式校验可审计、篡改即断链。
34
+ - DEFER / PAUSE 状态机:延后/暂停以文件态会话状态落盘(state-store),命中写状态并回填收据元信息(deferMeta / pauseMeta)。
35
+ - REQUIRE_APPROVAL 审批通道:软违规置信达标或边界命中转人工审批(ask 通道),审批结果回填收据并级联重锚。
36
+
37
+ ### 护栏规则热更新
38
+
39
+ - 治理配置变更实时生效(config-watch),无需重启;规则与阈值热加载,配置窗口极小。
40
+
41
+ ### 双层状态联动(违规升级 → 批次暂停)
42
+
43
+ - 滚动窗口违规计数升级:窗口内拒绝计数达阈值自动升级并暂停批次(governance refusal 事件 + 窗口摘要)。
44
+ - dispatch 归属登记:工具调用按发起方登记,违规处置可回溯(receiptId / callId / sessionId)。
45
+
46
+ ### 产品化双语文档分层
47
+
48
+ - 文档分层:产品化双语发布文档与内部技术开发文档分流(包级 README / README.en 产品化)。
49
+ - 随包分发双语主题文档:governance-boundaries / governance-technical / guardrails-hook / single-machine-capabilities / aip-compliance / acps-communication 中英 12 文件(npm files 白名单)。
1
50
 
2
51
  ## 0.3.6(2026-08-29)
3
52
 
@@ -12,7 +61,7 @@
12
61
  - 事件常量单点化(发端/读端统一引用,消除字面量散落)。
13
62
  - git 工具函数单点下沉,消除双向依赖环。
14
63
 
15
- ### 蟛蜞模式指引精简
64
+ ### Punky Swarm 模式指引精简
16
65
 
17
66
  - 角色指引瘦身(Persona 精简、公共约束单一来源),配套密度校验脚本自动检查。
18
67
 
@@ -90,7 +139,7 @@
90
139
  - 新增 asset_claim 工具(工具面 13->14):Leader 直做产物归位为批次资产(防逃逸纵深 + asset.claimed 事件留痕)
91
140
  - config 贯通:apply 的 config 传入 createTools(config.escalation.execTools 覆盖名单,缺省回退)
92
141
  - persona 纪律 0 重写(难度路由门禁:每轮必评 A/B/C + default to C + scope=full + 惰性化)+ 新增 0e(Leader 不写实现)
93
- - jiufeng-team SKILL.md:移除"降级判定优先"判定策略(路由归蟛蜞模式),改造为 C 类触发后的执行机制 + 任务包最小结构模板(两副本同步)
142
+ - jiufeng-team SKILL.md:移除"降级判定优先"判定策略(路由归 Punky Swarm 模式),改造为 C 类触发后的执行机制 + 任务包最小结构模板(两副本同步)
94
143
  - 资产同步 syncAssets 幂等(预设/技能字节一致跳过,mtime 容差)
95
144
  - 单测 68->93(governance 15 + asset/config 5 + 扩 5)
96
145
  # Changelog
@@ -108,7 +157,7 @@
108
157
  - 新增 assign_check(委派形态判定 A/B/C)与 gate_status(门禁状态查询),工具面 10→12;
109
158
  - wavePlan 层契约:layer ∈ plan/exec/audit、有 exec 必有 audit、路径契约、跨层引用校验、防篡改;
110
159
  - 引擎级门禁:Entry(consume 齐备)/ L0(spec 必填章节)/ Exit(outputs/produce 存在)/ Complete(audit 全终态);
111
- - assembly 可插拔装配(jiufeng 默认)+ 会话隔离 v2(sessions/<id> + legacy 迁移);
160
+ - assembly 可插拔装配(默认装配)+ 会话隔离 v2(sessions/<id> + legacy 迁移);
112
161
  - 单测 29→68。
113
162
 
114
163
  ### 2026-08-20 · 产物注册表与门禁可视 + 开源准备