dsh-punky-swarm 0.3.6 → 0.4.0

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 (94) hide show
  1. package/CHANGELOG.md +26 -3
  2. package/LICENSE +661 -661
  3. package/README.en.md +131 -281
  4. package/README.md +77 -227
  5. package/cordis.patch.yml +28 -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/lib/acps/certs.js +310 -310
  19. package/lib/acps/discovery-client.js +283 -283
  20. package/lib/acps/registry-client.js +527 -527
  21. package/lib/acps/server.js +302 -302
  22. package/lib/aip/agent-descriptor.js +170 -170
  23. package/lib/aip/identity.js +469 -469
  24. package/lib/aip/tool-descriptor.js +93 -93
  25. package/lib/api.js +266 -266
  26. package/lib/assembly/audit-blind-review.js +170 -170
  27. package/lib/assembly/schema.js +253 -253
  28. package/lib/bridge/dispatch-register.js +132 -0
  29. package/lib/bridge/trajectory.js +205 -202
  30. package/lib/comms/acps-bridge.js +219 -219
  31. package/lib/comms/aip-format.js +141 -141
  32. package/lib/comms/budget.js +124 -124
  33. package/lib/comms/topic.js +115 -115
  34. package/lib/discovery/filter.js +199 -199
  35. package/lib/discovery/service.js +251 -251
  36. package/lib/governance/classify.d.ts +15 -0
  37. package/lib/governance/classify.js +82 -0
  38. package/lib/governance/classify.ts +111 -0
  39. package/lib/governance/config.d.ts +36 -0
  40. package/lib/governance/config.js +105 -0
  41. package/lib/governance/config.ts +136 -0
  42. package/lib/governance/decisions.d.ts +12 -0
  43. package/lib/governance/decisions.js +48 -0
  44. package/lib/governance/decisions.ts +68 -0
  45. package/lib/governance/escalation.js +70 -0
  46. package/lib/governance/hash-utils.js +77 -0
  47. package/lib/governance/index.d.ts +6 -0
  48. package/lib/governance/index.js +24 -0
  49. package/lib/governance/index.ts +26 -0
  50. package/lib/governance/kernel.d.ts +16 -0
  51. package/lib/governance/kernel.js +205 -0
  52. package/lib/governance/kernel.ts +220 -0
  53. package/lib/governance/narrow.d.ts +17 -0
  54. package/lib/governance/narrow.js +112 -0
  55. package/lib/governance/narrow.ts +125 -0
  56. package/lib/governance/receipt-store.js +303 -0
  57. package/lib/governance/state-store.js +140 -0
  58. package/lib/governance/types.d.ts +89 -0
  59. package/lib/governance/types.js +17 -0
  60. package/lib/governance/types.ts +144 -0
  61. package/lib/governance/wiring.js +274 -0
  62. package/lib/hot/config-watch.js +5 -3
  63. package/lib/index.js +579 -433
  64. package/lib/state/archive.js +174 -174
  65. package/lib/state/corrupt-registry.js +103 -103
  66. package/lib/state/event-types.js +10 -0
  67. package/lib/state/machine.js +68 -68
  68. package/lib/state/resume.js +201 -201
  69. package/lib/state/store.js +687 -607
  70. package/lib/tools/core.js +323 -323
  71. package/lib/tools/lane-tools.js +455 -455
  72. package/lib/tools/log-tools.js +173 -173
  73. package/lib/tools/mailbox-tools.js +121 -121
  74. package/lib/tools/merge-agent.js +127 -127
  75. package/lib/tools/register.js +85 -85
  76. package/lib/types/contracts.d.ts +13 -0
  77. package/lib/types/contracts.ts +2 -0
  78. package/lib/verify/gate.js +161 -161
  79. package/lib/verify/mount.js +48 -48
  80. package/lib/watch/lane-heartbeat.js +333 -333
  81. package/package.json +14 -2
  82. package/presets/jiufeng/NOTICE +5 -5
  83. package/skills/jiufeng-team/SKILL.md +214 -214
  84. package/skills/jiufeng-team/references/constitution.md +62 -62
  85. package/skills/jiufeng-team/references/roles/coder.md +17 -17
  86. package/skills/jiufeng-team/references/roles/coordinator.md +13 -13
  87. package/skills/jiufeng-team/references/roles/designer.md +14 -14
  88. package/skills/jiufeng-team/references/roles/doc-manager.md +13 -13
  89. package/skills/jiufeng-team/references/roles/manager.md +22 -22
  90. package/skills/jiufeng-team/references/roles/reviewer.md +19 -19
  91. package/skills/jiufeng-team/references/roles/supervisor.md +13 -13
  92. package/skills/jiufeng-team/references/roles/tester.md +13 -13
  93. package/skills/jiufeng-team/references/templates/success-pattern-seeds.md +126 -126
  94. package/skills/jiufeng-team/references/workflow.md +98 -98
package/CHANGELOG.md CHANGED
@@ -1,3 +1,26 @@
1
+ ## 0.4.0（2026-09-03）
2
+
3
+ ### 工具调用级治理护栏
4
+
5
+ - 引导层挂载 + 运行时接线：治理钩子随引导装配挂载（bootoverlay），运行期 wiring 接线，工具调用进入统一裁决链。
6
+ - 6 原语裁决内核：classify / config / decisions / escalate / narrow / proto 域分层裁决，处置原语含 ALLOW / DENY / REQUIRE_APPROVAL / DEFER / NARROW / PAUSE。
7
+ - 拒绝收据锚定 + 哈希链防篡改：违规判定与处置落盘拒绝收据（receipt-store），锚定 prevHash 级联哈希（hash-utils），链式校验可审计、篡改即断链。
8
+ - DEFER / PAUSE 状态机：延后/暂停以文件态会话状态落盘（state-store），命中写状态并回填收据元信息（deferMeta / pauseMeta）。
9
+ - REQUIRE_APPROVAL 审批通道：软违规置信达标或边界命中转人工审批（ask 通道），审批结果回填收据并级联重锚。
10
+
11
+ ### 护栏规则热更新
12
+
13
+ - 治理配置变更实时生效（config-watch），无需重启；规则与阈值热加载，配置窗口极小。
14
+
15
+ ### 双层状态联动（违规升级 → 批次暂停）
16
+
17
+ - 滚动窗口违规计数升级：窗口内拒绝计数达阈值自动升级并暂停批次（governance refusal 事件 + 窗口摘要）。
18
+ - dispatch 归属登记：工具调用按发起方登记，违规处置可回溯（receiptId / callId / sessionId）。
19
+
20
+ ### 产品化双语文档分层
21
+
22
+ - 文档分层：产品化双语发布文档与内部技术开发文档分流（包级 README / README.en 产品化）。
23
+ - 随包分发双语主题文档：governance-boundaries / governance-technical / guardrails-hook / single-machine-capabilities / aip-compliance / acps-communication 中英 12 文件（npm files 白名单）。
1
24
 
2
25
  ## 0.3.6（2026-08-29）
3
26
 
@@ -12,7 +35,7 @@
12
35
  - 事件常量单点化（发端/读端统一引用，消除字面量散落）。
13
36
  - git 工具函数单点下沉，消除双向依赖环。
14
37
 
15
- ### 蟛蜞模式指引精简
38
+ ### Punky Swarm 模式指引精简
16
39
 
17
40
  - 角色指引瘦身（Persona 精简、公共约束单一来源），配套密度校验脚本自动检查。
18
41
 
@@ -90,7 +113,7 @@
90
113
  - 新增 asset_claim 工具（工具面 13->14）：Leader 直做产物归位为批次资产（防逃逸纵深 + asset.claimed 事件留痕）
91
114
  - config 贯通：apply 的 config 传入 createTools（config.escalation.execTools 覆盖名单，缺省回退）
92
115
  - persona 纪律 0 重写（难度路由门禁：每轮必评 A/B/C + default to C + scope=full + 惰性化）+ 新增 0e（Leader 不写实现）
93
- - jiufeng-team SKILL.md：移除"降级判定优先"判定策略（路由归蟛蜞模式），改造为 C 类触发后的执行机制 + 任务包最小结构模板（两副本同步）
116
+ - jiufeng-team SKILL.md：移除"降级判定优先"判定策略（路由归 Punky Swarm 模式），改造为 C 类触发后的执行机制 + 任务包最小结构模板（两副本同步）
94
117
  - 资产同步 syncAssets 幂等（预设/技能字节一致跳过，mtime 容差）
95
118
  - 单测 68->93（governance 15 + asset/config 5 + 扩 5）
96
119
  # Changelog
@@ -108,7 +131,7 @@
108
131
  - 新增 assign_check（委派形态判定 A/B/C）与 gate_status（门禁状态查询），工具面 10→12；
109
132
  - wavePlan 层契约：layer ∈ plan/exec/audit、有 exec 必有 audit、路径契约、跨层引用校验、防篡改；
110
133
  - 引擎级门禁：Entry（consume 齐备）/ L0（spec 必填章节）/ Exit（outputs/produce 存在）/ Complete（audit 全终态）；
111
- - assembly 可插拔装配（jiufeng 默认）+ 会话隔离 v2（sessions/<id> + legacy 迁移）；
134
+ - assembly 可插拔装配（默认装配）+ 会话隔离 v2（sessions/<id> + legacy 迁移）；
112
135
  - 单测 29→68。
113
136
 
114
137
  ### 2026-08-20 · 产物注册表与门禁可视 + 开源准备