claude-flow 3.25.6 → 3.26.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 (309) hide show
  1. package/.claude/helpers/hook-handler.cjs +129 -0
  2. package/.claude/helpers/intelligence.cjs +10 -0
  3. package/.claude/helpers/statusline.cjs +310 -123
  4. package/.claude/proven-config.json +1 -1
  5. package/.claude/security-scans/scan-all-standard.json +321 -0
  6. package/.claude/security-scans/scan-code-deep.json +1209 -0
  7. package/.claude/security-scans/scan-deps-full.json +14 -0
  8. package/package.json +3 -1
  9. package/v3/@claude-flow/cli/catalog-manifest.json +12 -0
  10. package/v3/@claude-flow/cli/dist/src/commands/advisor.d.ts +15 -0
  11. package/v3/@claude-flow/cli/dist/src/commands/advisor.js +94 -0
  12. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +77 -3
  13. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +13 -0
  14. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +103 -0
  15. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +112 -46
  16. package/v3/@claude-flow/cli/dist/src/commands/index.js +10 -0
  17. package/v3/@claude-flow/cli/dist/src/commands/init.js +44 -0
  18. package/v3/@claude-flow/cli/dist/src/commands/proxy.d.ts +21 -0
  19. package/v3/@claude-flow/cli/dist/src/commands/proxy.js +310 -0
  20. package/v3/@claude-flow/cli/dist/src/commands/security.js +29 -0
  21. package/v3/@claude-flow/cli/dist/src/commands/settings.d.ts +19 -0
  22. package/v3/@claude-flow/cli/dist/src/commands/settings.js +180 -0
  23. package/v3/@claude-flow/cli/dist/src/commands/version.d.ts +42 -0
  24. package/v3/@claude-flow/cli/dist/src/commands/version.js +106 -0
  25. package/v3/@claude-flow/cli/dist/src/funnel/advisor-tip.d.ts +58 -0
  26. package/v3/@claude-flow/cli/dist/src/funnel/advisor-tip.js +92 -0
  27. package/v3/@claude-flow/cli/dist/src/funnel/attribution.d.ts +37 -0
  28. package/v3/@claude-flow/cli/dist/src/funnel/attribution.js +101 -0
  29. package/v3/@claude-flow/cli/dist/src/funnel/consent.d.ts +22 -0
  30. package/v3/@claude-flow/cli/dist/src/funnel/consent.js +55 -0
  31. package/v3/@claude-flow/cli/dist/src/funnel/credit-errors.d.ts +31 -0
  32. package/v3/@claude-flow/cli/dist/src/funnel/credit-errors.js +88 -0
  33. package/v3/@claude-flow/cli/dist/src/funnel/credit-notifier.d.ts +44 -0
  34. package/v3/@claude-flow/cli/dist/src/funnel/credit-notifier.js +74 -0
  35. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +46 -0
  36. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +97 -0
  37. package/v3/@claude-flow/cli/dist/src/funnel/enrollment.d.ts +36 -0
  38. package/v3/@claude-flow/cli/dist/src/funnel/enrollment.js +64 -0
  39. package/v3/@claude-flow/cli/dist/src/funnel/environment.d.ts +17 -0
  40. package/v3/@claude-flow/cli/dist/src/funnel/environment.js +39 -0
  41. package/v3/@claude-flow/cli/dist/src/funnel/event-transport.d.ts +51 -0
  42. package/v3/@claude-flow/cli/dist/src/funnel/event-transport.js +199 -0
  43. package/v3/@claude-flow/cli/dist/src/funnel/events.d.ts +42 -0
  44. package/v3/@claude-flow/cli/dist/src/funnel/events.js +150 -0
  45. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +20 -0
  46. package/v3/@claude-flow/cli/dist/src/funnel/index.js +20 -0
  47. package/v3/@claude-flow/cli/dist/src/funnel/insights.d.ts +49 -0
  48. package/v3/@claude-flow/cli/dist/src/funnel/insights.js +120 -0
  49. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.d.ts +15 -0
  50. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.js +68 -0
  51. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.d.ts +51 -0
  52. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.js +149 -0
  53. package/v3/@claude-flow/cli/dist/src/funnel/messages.d.ts +55 -0
  54. package/v3/@claude-flow/cli/dist/src/funnel/messages.js +160 -0
  55. package/v3/@claude-flow/cli/dist/src/funnel/power-saver-notifier.d.ts +44 -0
  56. package/v3/@claude-flow/cli/dist/src/funnel/power-saver-notifier.js +92 -0
  57. package/v3/@claude-flow/cli/dist/src/funnel/precedence.d.ts +16 -0
  58. package/v3/@claude-flow/cli/dist/src/funnel/precedence.js +85 -0
  59. package/v3/@claude-flow/cli/dist/src/funnel/promo.d.ts +41 -0
  60. package/v3/@claude-flow/cli/dist/src/funnel/promo.js +144 -0
  61. package/v3/@claude-flow/cli/dist/src/funnel/rate-limit-notifier.d.ts +55 -0
  62. package/v3/@claude-flow/cli/dist/src/funnel/rate-limit-notifier.js +102 -0
  63. package/v3/@claude-flow/cli/dist/src/funnel/rotation.d.ts +19 -0
  64. package/v3/@claude-flow/cli/dist/src/funnel/rotation.js +70 -0
  65. package/v3/@claude-flow/cli/dist/src/funnel/state.d.ts +13 -0
  66. package/v3/@claude-flow/cli/dist/src/funnel/state.js +52 -0
  67. package/v3/@claude-flow/cli/dist/src/funnel/toggle-cooldown.d.ts +17 -0
  68. package/v3/@claude-flow/cli/dist/src/funnel/toggle-cooldown.js +32 -0
  69. package/v3/@claude-flow/cli/dist/src/funnel/types.d.ts +86 -0
  70. package/v3/@claude-flow/cli/dist/src/funnel/types.js +26 -0
  71. package/v3/@claude-flow/cli/dist/src/init/executor.js +9 -3
  72. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.d.ts +33 -2
  73. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.js +102 -12
  74. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +52 -0
  75. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +292 -116
  76. package/v3/@claude-flow/cli/dist/src/services/daemon-autostart.js +28 -5
  77. package/v3/@claude-flow/cli/dist/src/services/fable-harness.d.ts +39 -0
  78. package/v3/@claude-flow/cli/dist/src/services/fable-harness.js +41 -0
  79. package/v3/@claude-flow/cli/package.json +13 -4
  80. package/.claude/coordinator/config.json +0 -24
  81. package/.claude/coordinator/state.json +0 -37
  82. package/.claude/coordinator/tick-log/tick-01.json +0 -17
  83. package/.claude/coordinator/tick-log/tick-02.json +0 -17
  84. package/.claude/coordinator/tick-log/tick-03.json +0 -17
  85. package/.claude/coordinator/tick-log/tick-04.json +0 -14
  86. package/.claude/coordinator/tick-log/tick-05.json +0 -16
  87. package/.claude/settings.local.json +0 -11
  88. package/v3/@claude-flow/cli/dist/src/ruvector/lattice-wasm.d.ts +0 -14
  89. package/v3/@claude-flow/cli/dist/src/ruvector/lattice-wasm.js +0 -144
  90. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +0 -284
  91. package/v3/@claude-flow/guidance/dist/adversarial.js +0 -572
  92. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +0 -530
  93. package/v3/@claude-flow/guidance/dist/analyzer.js +0 -2587
  94. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +0 -283
  95. package/v3/@claude-flow/guidance/dist/artifacts.js +0 -356
  96. package/v3/@claude-flow/guidance/dist/authority.d.ts +0 -290
  97. package/v3/@claude-flow/guidance/dist/authority.js +0 -558
  98. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +0 -209
  99. package/v3/@claude-flow/guidance/dist/capabilities.js +0 -485
  100. package/v3/@claude-flow/guidance/dist/coherence.d.ts +0 -233
  101. package/v3/@claude-flow/guidance/dist/coherence.js +0 -372
  102. package/v3/@claude-flow/guidance/dist/compiler.d.ts +0 -87
  103. package/v3/@claude-flow/guidance/dist/compiler.js +0 -410
  104. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +0 -225
  105. package/v3/@claude-flow/guidance/dist/conformance-kit.js +0 -629
  106. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +0 -214
  107. package/v3/@claude-flow/guidance/dist/continue-gate.js +0 -353
  108. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +0 -17
  109. package/v3/@claude-flow/guidance/dist/crypto-utils.js +0 -24
  110. package/v3/@claude-flow/guidance/dist/evolution.d.ts +0 -282
  111. package/v3/@claude-flow/guidance/dist/evolution.js +0 -500
  112. package/v3/@claude-flow/guidance/dist/gates.d.ts +0 -79
  113. package/v3/@claude-flow/guidance/dist/gates.js +0 -302
  114. package/v3/@claude-flow/guidance/dist/gateway.d.ts +0 -206
  115. package/v3/@claude-flow/guidance/dist/gateway.js +0 -452
  116. package/v3/@claude-flow/guidance/dist/generators.d.ts +0 -153
  117. package/v3/@claude-flow/guidance/dist/generators.js +0 -682
  118. package/v3/@claude-flow/guidance/dist/headless.d.ts +0 -177
  119. package/v3/@claude-flow/guidance/dist/headless.js +0 -342
  120. package/v3/@claude-flow/guidance/dist/hooks.d.ts +0 -109
  121. package/v3/@claude-flow/guidance/dist/hooks.js +0 -347
  122. package/v3/@claude-flow/guidance/dist/index.d.ts +0 -205
  123. package/v3/@claude-flow/guidance/dist/index.js +0 -321
  124. package/v3/@claude-flow/guidance/dist/ledger.d.ts +0 -162
  125. package/v3/@claude-flow/guidance/dist/ledger.js +0 -375
  126. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +0 -289
  127. package/v3/@claude-flow/guidance/dist/manifest-validator.js +0 -838
  128. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +0 -222
  129. package/v3/@claude-flow/guidance/dist/memory-gate.js +0 -382
  130. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +0 -265
  131. package/v3/@claude-flow/guidance/dist/meta-governance.js +0 -348
  132. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +0 -104
  133. package/v3/@claude-flow/guidance/dist/optimizer.js +0 -329
  134. package/v3/@claude-flow/guidance/dist/persistence.d.ts +0 -189
  135. package/v3/@claude-flow/guidance/dist/persistence.js +0 -464
  136. package/v3/@claude-flow/guidance/dist/proof.d.ts +0 -185
  137. package/v3/@claude-flow/guidance/dist/proof.js +0 -238
  138. package/v3/@claude-flow/guidance/dist/retriever.d.ts +0 -172
  139. package/v3/@claude-flow/guidance/dist/retriever.js +0 -596
  140. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +0 -370
  141. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +0 -738
  142. package/v3/@claude-flow/guidance/dist/temporal.d.ts +0 -426
  143. package/v3/@claude-flow/guidance/dist/temporal.js +0 -658
  144. package/v3/@claude-flow/guidance/dist/trust.d.ts +0 -283
  145. package/v3/@claude-flow/guidance/dist/trust.js +0 -473
  146. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +0 -276
  147. package/v3/@claude-flow/guidance/dist/truth-anchors.js +0 -488
  148. package/v3/@claude-flow/guidance/dist/types.d.ts +0 -378
  149. package/v3/@claude-flow/guidance/dist/types.js +0 -10
  150. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +0 -372
  151. package/v3/@claude-flow/guidance/dist/uncertainty.js +0 -619
  152. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +0 -48
  153. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +0 -158
  154. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +0 -41
  155. package/v3/@claude-flow/shared/dist/core/config/defaults.js +0 -186
  156. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +0 -8
  157. package/v3/@claude-flow/shared/dist/core/config/index.js +0 -12
  158. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +0 -45
  159. package/v3/@claude-flow/shared/dist/core/config/loader.js +0 -238
  160. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +0 -1728
  161. package/v3/@claude-flow/shared/dist/core/config/schema.js +0 -160
  162. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +0 -92
  163. package/v3/@claude-flow/shared/dist/core/config/validator.js +0 -147
  164. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +0 -31
  165. package/v3/@claude-flow/shared/dist/core/event-bus.js +0 -197
  166. package/v3/@claude-flow/shared/dist/core/index.d.ts +0 -15
  167. package/v3/@claude-flow/shared/dist/core/index.js +0 -19
  168. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +0 -200
  169. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +0 -6
  170. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +0 -310
  171. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +0 -7
  172. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +0 -224
  173. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +0 -46
  174. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +0 -10
  175. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +0 -15
  176. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +0 -298
  177. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +0 -7
  178. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +0 -185
  179. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +0 -6
  180. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +0 -35
  181. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +0 -101
  182. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +0 -60
  183. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +0 -166
  184. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +0 -46
  185. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +0 -64
  186. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +0 -56
  187. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +0 -195
  188. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +0 -83
  189. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +0 -193
  190. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +0 -49
  191. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +0 -253
  192. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +0 -282
  193. package/v3/@claude-flow/shared/dist/events/domain-events.js +0 -165
  194. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +0 -126
  195. package/v3/@claude-flow/shared/dist/events/event-store.js +0 -427
  196. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +0 -8
  197. package/v3/@claude-flow/shared/dist/events/event-store.test.js +0 -293
  198. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +0 -10
  199. package/v3/@claude-flow/shared/dist/events/example-usage.js +0 -193
  200. package/v3/@claude-flow/shared/dist/events/index.d.ts +0 -21
  201. package/v3/@claude-flow/shared/dist/events/index.js +0 -22
  202. package/v3/@claude-flow/shared/dist/events/projections.d.ts +0 -177
  203. package/v3/@claude-flow/shared/dist/events/projections.js +0 -421
  204. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +0 -82
  205. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +0 -340
  206. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +0 -101
  207. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +0 -263
  208. package/v3/@claude-flow/shared/dist/events.d.ts +0 -80
  209. package/v3/@claude-flow/shared/dist/events.js +0 -249
  210. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +0 -42
  211. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +0 -351
  212. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +0 -100
  213. package/v3/@claude-flow/shared/dist/hooks/executor.js +0 -267
  214. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +0 -9
  215. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +0 -322
  216. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +0 -52
  217. package/v3/@claude-flow/shared/dist/hooks/index.js +0 -51
  218. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +0 -133
  219. package/v3/@claude-flow/shared/dist/hooks/registry.js +0 -277
  220. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +0 -105
  221. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +0 -481
  222. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +0 -144
  223. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +0 -328
  224. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +0 -158
  225. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +0 -450
  226. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +0 -17
  227. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +0 -17
  228. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +0 -234
  229. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +0 -334
  230. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +0 -163
  231. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +0 -326
  232. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +0 -267
  233. package/v3/@claude-flow/shared/dist/hooks/types.js +0 -62
  234. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +0 -9
  235. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +0 -93
  236. package/v3/@claude-flow/shared/dist/index.d.ts +0 -20
  237. package/v3/@claude-flow/shared/dist/index.js +0 -50
  238. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +0 -98
  239. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +0 -364
  240. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +0 -69
  241. package/v3/@claude-flow/shared/dist/mcp/index.js +0 -84
  242. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +0 -166
  243. package/v3/@claude-flow/shared/dist/mcp/server.js +0 -590
  244. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +0 -136
  245. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +0 -335
  246. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +0 -178
  247. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +0 -439
  248. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +0 -104
  249. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +0 -476
  250. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +0 -102
  251. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +0 -238
  252. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +0 -104
  253. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +0 -263
  254. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +0 -133
  255. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +0 -396
  256. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +0 -436
  257. package/v3/@claude-flow/shared/dist/mcp/types.js +0 -54
  258. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +0 -544
  259. package/v3/@claude-flow/shared/dist/plugin-interface.js +0 -23
  260. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +0 -139
  261. package/v3/@claude-flow/shared/dist/plugin-loader.js +0 -434
  262. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +0 -183
  263. package/v3/@claude-flow/shared/dist/plugin-registry.js +0 -457
  264. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +0 -10
  265. package/v3/@claude-flow/shared/dist/plugins/index.js +0 -10
  266. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +0 -106
  267. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +0 -241
  268. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +0 -10
  269. package/v3/@claude-flow/shared/dist/plugins/official/index.js +0 -10
  270. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +0 -121
  271. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +0 -355
  272. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +0 -93
  273. package/v3/@claude-flow/shared/dist/plugins/types.js +0 -9
  274. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +0 -105
  275. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +0 -206
  276. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +0 -132
  277. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +0 -233
  278. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +0 -19
  279. package/v3/@claude-flow/shared/dist/resilience/index.js +0 -19
  280. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +0 -168
  281. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +0 -314
  282. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +0 -91
  283. package/v3/@claude-flow/shared/dist/resilience/retry.js +0 -159
  284. package/v3/@claude-flow/shared/dist/security/index.d.ts +0 -10
  285. package/v3/@claude-flow/shared/dist/security/index.js +0 -12
  286. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +0 -73
  287. package/v3/@claude-flow/shared/dist/security/input-validation.js +0 -201
  288. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +0 -92
  289. package/v3/@claude-flow/shared/dist/security/secure-random.js +0 -142
  290. package/v3/@claude-flow/shared/dist/services/index.d.ts +0 -7
  291. package/v3/@claude-flow/shared/dist/services/index.js +0 -7
  292. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +0 -124
  293. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +0 -402
  294. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +0 -137
  295. package/v3/@claude-flow/shared/dist/types/agent.types.js +0 -6
  296. package/v3/@claude-flow/shared/dist/types/index.d.ts +0 -11
  297. package/v3/@claude-flow/shared/dist/types/index.js +0 -17
  298. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +0 -266
  299. package/v3/@claude-flow/shared/dist/types/mcp.types.js +0 -7
  300. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +0 -236
  301. package/v3/@claude-flow/shared/dist/types/memory.types.js +0 -7
  302. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +0 -186
  303. package/v3/@claude-flow/shared/dist/types/swarm.types.js +0 -65
  304. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +0 -178
  305. package/v3/@claude-flow/shared/dist/types/task.types.js +0 -32
  306. package/v3/@claude-flow/shared/dist/types.d.ts +0 -197
  307. package/v3/@claude-flow/shared/dist/types.js +0 -21
  308. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +0 -69
  309. package/v3/@claude-flow/shared/dist/utils/secure-logger.js +0 -208
@@ -1,838 +0,0 @@
1
- /**
2
- * Manifest Validator & Conformance Suite
3
- *
4
- * Validates AgentCellManifest documents against the Agentic Container spec,
5
- * computes risk scores, selects execution lanes, and fails closed on any
6
- * validation error. The ConformanceSuite runs golden traces through an
7
- * evaluator to prove the platform behaves as specified.
8
- *
9
- * @module @claude-flow/guidance/manifest-validator
10
- */
11
- // ============================================================================
12
- // Constants
13
- // ============================================================================
14
- const SUPPORTED_API_VERSION = 'agentic_cells.v0_1';
15
- const SHA256_DIGEST_RE = /^sha256:[a-f0-9]{64}$/;
16
- /** Maximum budget limits (sanity caps) */
17
- const MAX_BUDGET_LIMITS = {
18
- maxWallClockSeconds: 86_400, // 24 hours
19
- maxToolCalls: 100_000,
20
- maxBytesEgress: 10_737_418_240, // 10 GiB
21
- maxTokensInMtok: 100, // 100M tokens
22
- maxTokensOutMtok: 100, // 100M tokens
23
- maxMemoryWrites: 1_000_000,
24
- };
25
- /** Data sensitivity levels ordered by severity */
26
- const DATA_SENSITIVITY_LEVELS = ['public', 'internal', 'confidential', 'restricted'];
27
- /** Write modes for memory policy */
28
- const WRITE_MODES = ['append', 'overwrite', 'merge'];
29
- /** Authority scopes for memory policy */
30
- const AUTHORITY_SCOPES = ['self', 'team', 'tenant', 'global'];
31
- /** Known tool names the system recognizes */
32
- const KNOWN_TOOLS = new Set([
33
- 'Read', 'Write', 'Edit', 'MultiEdit', 'Glob', 'Grep',
34
- 'Bash', 'Task', 'TodoWrite', 'NotebookEdit', 'WebFetch', 'WebSearch',
35
- 'mcp_memory', 'mcp_swarm', 'mcp_hooks', 'mcp_agent',
36
- ]);
37
- /** Trace levels for observability */
38
- const TRACE_LEVELS = ['none', 'errors', 'decisions', 'full'];
39
- /** Execution lanes ordered by privilege (lowest to highest) */
40
- const LANES = ['wasm', 'sandboxed', 'native'];
41
- // ============================================================================
42
- // ManifestValidator
43
- // ============================================================================
44
- /**
45
- * Validates AgentCellManifest documents against the Agentic Container spec.
46
- *
47
- * Fails closed: any validation error results in a 'reject' decision.
48
- * Warnings alone do not block admission but may trigger a 'review' decision
49
- * when the risk score is between thresholds.
50
- */
51
- export class ManifestValidator {
52
- /** Risk score threshold: below this, admit. Above reject threshold, reject. Between, review. */
53
- admitThreshold;
54
- rejectThreshold;
55
- constructor(options) {
56
- this.admitThreshold = options?.admitThreshold ?? 30;
57
- this.rejectThreshold = options?.rejectThreshold ?? 70;
58
- }
59
- /**
60
- * Validate a manifest, compute its risk score, select a lane, and decide admission.
61
- *
62
- * FAILS CLOSED: any validation error leads to reject.
63
- */
64
- validate(manifest) {
65
- const errors = [];
66
- const warnings = [];
67
- // Structural validation
68
- errors.push(...this.validateRequiredFields(manifest));
69
- errors.push(...this.validateApiVersion(manifest));
70
- errors.push(...this.validateDigest(manifest));
71
- errors.push(...this.validateBudgets(manifest.budgets));
72
- errors.push(...this.validateToolPolicy(manifest.toolPolicy));
73
- errors.push(...this.validateDataPolicy(manifest.dataPolicy));
74
- warnings.push(...this.validateWarnings(manifest));
75
- // Compute risk score (even if there are errors, for diagnostics)
76
- const riskScore = this.computeRiskScore(manifest);
77
- // FAIL CLOSED: any error means reject
78
- if (errors.length > 0) {
79
- return {
80
- valid: false,
81
- errors,
82
- warnings,
83
- admissionDecision: 'reject',
84
- laneSelection: null,
85
- riskScore,
86
- };
87
- }
88
- // Lane selection
89
- const laneSelection = this.selectLane(manifest, riskScore);
90
- // Admission decision based on risk score
91
- let admissionDecision;
92
- if (riskScore > this.rejectThreshold) {
93
- admissionDecision = 'reject';
94
- }
95
- else if (riskScore > this.admitThreshold) {
96
- admissionDecision = 'review';
97
- }
98
- else {
99
- admissionDecision = 'admit';
100
- }
101
- return {
102
- valid: true,
103
- errors,
104
- warnings,
105
- admissionDecision,
106
- laneSelection,
107
- riskScore,
108
- };
109
- }
110
- /**
111
- * Compute a risk score (0-100) from tool risk, data sensitivity, and privilege surface.
112
- *
113
- * Components:
114
- * - tool_risk (0-40): based on tool types and network access
115
- * - data_sensitivity (0-30): based on sensitivity level and PII
116
- * - privilege_surface (0-30): based on memory scope, write mode, native threads
117
- */
118
- computeRiskScore(manifest) {
119
- let toolRisk = 0;
120
- let dataSensitivity = 0;
121
- let privilegeSurface = 0;
122
- // --- Tool risk (0-40) ---
123
- const tools = manifest.toolPolicy?.toolsAllowed ?? [];
124
- const networkList = manifest.toolPolicy?.networkAllowlist ?? [];
125
- // Bash/command execution is high risk
126
- if (tools.includes('Bash') || tools.includes('bash')) {
127
- toolRisk += 15;
128
- }
129
- // Task spawning
130
- if (tools.includes('Task') || tools.includes('task')) {
131
- toolRisk += 8;
132
- }
133
- // Write operations
134
- if (tools.some(t => ['Write', 'Edit', 'MultiEdit', 'NotebookEdit'].includes(t))) {
135
- toolRisk += 5;
136
- }
137
- // MCP tools
138
- if (tools.some(t => t.startsWith('mcp_'))) {
139
- toolRisk += 5;
140
- }
141
- // Network access
142
- if (networkList.length > 0) {
143
- toolRisk += 5;
144
- }
145
- // Wildcard in network (already caught as error if not privileged, but score anyway)
146
- if (networkList.some(h => h === '*' || h.startsWith('*.'))) {
147
- toolRisk += 10;
148
- }
149
- // No confirmation on writes
150
- if (manifest.toolPolicy && !manifest.toolPolicy.writeActionsRequireConfirmation) {
151
- toolRisk += 3;
152
- }
153
- toolRisk = Math.min(toolRisk, 40);
154
- // --- Data sensitivity (0-30) ---
155
- const sensitivityIndex = DATA_SENSITIVITY_LEVELS.indexOf(manifest.dataPolicy?.dataSensitivity);
156
- if (sensitivityIndex >= 0) {
157
- dataSensitivity += sensitivityIndex * 8; // 0, 8, 16, 24
158
- }
159
- if (manifest.dataPolicy?.piiAllowed) {
160
- dataSensitivity += 6;
161
- }
162
- dataSensitivity = Math.min(dataSensitivity, 30);
163
- // --- Privilege surface (0-30) ---
164
- const scopeIndex = AUTHORITY_SCOPES.indexOf(manifest.memoryPolicy?.authorityScope);
165
- if (scopeIndex >= 0) {
166
- privilegeSurface += scopeIndex * 5; // 0, 5, 10, 15
167
- }
168
- if (manifest.memoryPolicy?.writeMode === 'overwrite') {
169
- privilegeSurface += 5;
170
- }
171
- if (manifest.lanePolicy?.needsNativeThreads) {
172
- privilegeSurface += 8;
173
- }
174
- if (manifest.memoryPolicy && !manifest.memoryPolicy.requiresCoherenceGate) {
175
- privilegeSurface += 3;
176
- }
177
- if (manifest.memoryPolicy && !manifest.memoryPolicy.requiresAntiHallucinationGate) {
178
- privilegeSurface += 3;
179
- }
180
- privilegeSurface = Math.min(privilegeSurface, 30);
181
- return Math.min(toolRisk + dataSensitivity + privilegeSurface, 100);
182
- }
183
- /**
184
- * Select the execution lane based on risk score and manifest policy.
185
- *
186
- * Lane selection rules:
187
- * - If portabilityRequired or risk <= 30: wasm
188
- * - If needsNativeThreads and risk > 50: native
189
- * - Otherwise: sandboxed
190
- * - Always respect preferredLane if risk score allows it
191
- * - Risk exceeding maxRiskScore forces the most restrictive lane
192
- */
193
- selectLane(manifest, riskScore) {
194
- const policy = manifest.lanePolicy;
195
- // If risk exceeds the manifest's own maxRiskScore, force wasm
196
- if (riskScore > policy.maxRiskScore) {
197
- return 'wasm';
198
- }
199
- // Portability requirement forces wasm
200
- if (policy.portabilityRequired) {
201
- return 'wasm';
202
- }
203
- // Native threads require native lane
204
- if (policy.needsNativeThreads) {
205
- // Only grant native if risk is acceptable
206
- if (riskScore <= 50) {
207
- return 'native';
208
- }
209
- return 'sandboxed';
210
- }
211
- // Low risk can go to wasm
212
- if (riskScore <= 20) {
213
- return policy.preferredLane;
214
- }
215
- // Medium risk gets sandboxed
216
- if (riskScore <= 50) {
217
- // Respect preference if it's not native
218
- if (policy.preferredLane !== 'native') {
219
- return policy.preferredLane;
220
- }
221
- return 'sandboxed';
222
- }
223
- // High risk gets wasm
224
- return 'wasm';
225
- }
226
- /**
227
- * Validate budget values: no negatives, within sanity limits.
228
- */
229
- validateBudgets(budgets) {
230
- const errors = [];
231
- if (!budgets) {
232
- errors.push({
233
- code: 'MISSING_FIELD',
234
- field: 'budgets',
235
- message: 'Budget configuration is required',
236
- severity: 'error',
237
- });
238
- return errors;
239
- }
240
- const budgetFields = [
241
- { key: 'maxWallClockSeconds', max: MAX_BUDGET_LIMITS.maxWallClockSeconds },
242
- { key: 'maxToolCalls', max: MAX_BUDGET_LIMITS.maxToolCalls },
243
- { key: 'maxBytesEgress', max: MAX_BUDGET_LIMITS.maxBytesEgress },
244
- { key: 'maxTokensInMtok', max: MAX_BUDGET_LIMITS.maxTokensInMtok },
245
- { key: 'maxTokensOutMtok', max: MAX_BUDGET_LIMITS.maxTokensOutMtok },
246
- { key: 'maxMemoryWrites', max: MAX_BUDGET_LIMITS.maxMemoryWrites },
247
- ];
248
- for (const { key, max } of budgetFields) {
249
- const value = budgets[key];
250
- if (value === undefined || value === null) {
251
- errors.push({
252
- code: 'MISSING_FIELD',
253
- field: `budgets.${key}`,
254
- message: `Budget field "${key}" is required`,
255
- severity: 'error',
256
- });
257
- continue;
258
- }
259
- if (typeof value !== 'number' || Number.isNaN(value)) {
260
- errors.push({
261
- code: 'INVALID_TYPE',
262
- field: `budgets.${key}`,
263
- message: `Budget field "${key}" must be a number`,
264
- severity: 'error',
265
- });
266
- continue;
267
- }
268
- if (value < 0) {
269
- errors.push({
270
- code: 'BUDGET_NEGATIVE',
271
- field: `budgets.${key}`,
272
- message: `Budget field "${key}" must not be negative (got ${value})`,
273
- severity: 'error',
274
- });
275
- }
276
- if (value > max) {
277
- errors.push({
278
- code: 'BUDGET_EXCEED',
279
- field: `budgets.${key}`,
280
- message: `Budget field "${key}" exceeds maximum (${value} > ${max})`,
281
- severity: 'error',
282
- });
283
- }
284
- }
285
- return errors;
286
- }
287
- /**
288
- * Validate tool policy: network allowlist must not contain wildcards
289
- * unless the cell explicitly has Bash (privileged).
290
- */
291
- validateToolPolicy(toolPolicy) {
292
- const errors = [];
293
- if (!toolPolicy) {
294
- errors.push({
295
- code: 'MISSING_FIELD',
296
- field: 'toolPolicy',
297
- message: 'Tool policy is required',
298
- severity: 'error',
299
- });
300
- return errors;
301
- }
302
- if (!Array.isArray(toolPolicy.toolsAllowed)) {
303
- errors.push({
304
- code: 'INVALID_TYPE',
305
- field: 'toolPolicy.toolsAllowed',
306
- message: 'toolsAllowed must be an array',
307
- severity: 'error',
308
- });
309
- }
310
- if (!Array.isArray(toolPolicy.networkAllowlist)) {
311
- errors.push({
312
- code: 'INVALID_TYPE',
313
- field: 'toolPolicy.networkAllowlist',
314
- message: 'networkAllowlist must be an array',
315
- severity: 'error',
316
- });
317
- }
318
- // Check for wildcards in network allowlist
319
- const isPrivileged = Array.isArray(toolPolicy.toolsAllowed) &&
320
- toolPolicy.toolsAllowed.includes('Bash');
321
- if (Array.isArray(toolPolicy.networkAllowlist)) {
322
- for (let i = 0; i < toolPolicy.networkAllowlist.length; i++) {
323
- const entry = toolPolicy.networkAllowlist[i];
324
- if (entry === '*' || entry.startsWith('*.')) {
325
- if (!isPrivileged) {
326
- errors.push({
327
- code: 'WILDCARD_NETWORK',
328
- field: `toolPolicy.networkAllowlist[${i}]`,
329
- message: `Wildcard "${entry}" in network allowlist requires privileged access (Bash tool)`,
330
- severity: 'error',
331
- });
332
- }
333
- }
334
- }
335
- }
336
- return errors;
337
- }
338
- /**
339
- * Validate data policy fields.
340
- */
341
- validateDataPolicy(dataPolicy) {
342
- const errors = [];
343
- if (!dataPolicy) {
344
- errors.push({
345
- code: 'MISSING_FIELD',
346
- field: 'dataPolicy',
347
- message: 'Data policy is required',
348
- severity: 'error',
349
- });
350
- return errors;
351
- }
352
- if (!DATA_SENSITIVITY_LEVELS.includes(dataPolicy.dataSensitivity)) {
353
- errors.push({
354
- code: 'INVALID_ENUM',
355
- field: 'dataPolicy.dataSensitivity',
356
- message: `dataSensitivity must be one of: ${DATA_SENSITIVITY_LEVELS.join(', ')} (got "${dataPolicy.dataSensitivity}")`,
357
- severity: 'error',
358
- });
359
- }
360
- if (typeof dataPolicy.retentionDays !== 'number' || dataPolicy.retentionDays < 0) {
361
- errors.push({
362
- code: 'INVALID_VALUE',
363
- field: 'dataPolicy.retentionDays',
364
- message: 'retentionDays must be a non-negative number',
365
- severity: 'error',
366
- });
367
- }
368
- if (!dataPolicy.exportControls) {
369
- errors.push({
370
- code: 'MISSING_FIELD',
371
- field: 'dataPolicy.exportControls',
372
- message: 'exportControls is required in data policy',
373
- severity: 'error',
374
- });
375
- }
376
- else {
377
- if (!Array.isArray(dataPolicy.exportControls.allowedRegions)) {
378
- errors.push({
379
- code: 'INVALID_TYPE',
380
- field: 'dataPolicy.exportControls.allowedRegions',
381
- message: 'allowedRegions must be an array',
382
- severity: 'error',
383
- });
384
- }
385
- if (!Array.isArray(dataPolicy.exportControls.blockedRegions)) {
386
- errors.push({
387
- code: 'INVALID_TYPE',
388
- field: 'dataPolicy.exportControls.blockedRegions',
389
- message: 'blockedRegions must be an array',
390
- severity: 'error',
391
- });
392
- }
393
- // Check for overlap between allowed and blocked regions
394
- if (Array.isArray(dataPolicy.exportControls.allowedRegions) &&
395
- Array.isArray(dataPolicy.exportControls.blockedRegions)) {
396
- const overlap = dataPolicy.exportControls.allowedRegions.filter(r => dataPolicy.exportControls.blockedRegions.includes(r));
397
- if (overlap.length > 0) {
398
- errors.push({
399
- code: 'REGION_CONFLICT',
400
- field: 'dataPolicy.exportControls',
401
- message: `Regions appear in both allowed and blocked lists: ${overlap.join(', ')}`,
402
- severity: 'error',
403
- });
404
- }
405
- }
406
- }
407
- return errors;
408
- }
409
- // ===== Private validation helpers =====
410
- validateRequiredFields(manifest) {
411
- const errors = [];
412
- if (!manifest) {
413
- errors.push({
414
- code: 'MISSING_FIELD',
415
- field: '',
416
- message: 'Manifest is required',
417
- severity: 'error',
418
- });
419
- return errors;
420
- }
421
- // Top-level required sections
422
- const requiredSections = [
423
- 'apiVersion', 'cell', 'lanePolicy', 'budgets',
424
- 'dataPolicy', 'toolPolicy', 'memoryPolicy', 'observability',
425
- ];
426
- for (const section of requiredSections) {
427
- if (manifest[section] === undefined || manifest[section] === null) {
428
- errors.push({
429
- code: 'MISSING_FIELD',
430
- field: section,
431
- message: `Required field "${section}" is missing`,
432
- severity: 'error',
433
- });
434
- }
435
- }
436
- // Cell sub-fields
437
- if (manifest.cell) {
438
- for (const field of ['name', 'purpose', 'ownerTenant']) {
439
- if (!manifest.cell[field]) {
440
- errors.push({
441
- code: 'MISSING_FIELD',
442
- field: `cell.${field}`,
443
- message: `Required field "cell.${field}" is missing`,
444
- severity: 'error',
445
- });
446
- }
447
- }
448
- if (!manifest.cell.codeRef) {
449
- errors.push({
450
- code: 'MISSING_FIELD',
451
- field: 'cell.codeRef',
452
- message: 'Required field "cell.codeRef" is missing',
453
- severity: 'error',
454
- });
455
- }
456
- else {
457
- for (const field of ['kind', 'digest', 'entry']) {
458
- if (!manifest.cell.codeRef[field]) {
459
- errors.push({
460
- code: 'MISSING_FIELD',
461
- field: `cell.codeRef.${field}`,
462
- message: `Required field "cell.codeRef.${field}" is missing`,
463
- severity: 'error',
464
- });
465
- }
466
- }
467
- }
468
- }
469
- // Memory policy sub-fields
470
- if (manifest.memoryPolicy) {
471
- if (!manifest.memoryPolicy.namespace) {
472
- errors.push({
473
- code: 'MISSING_FIELD',
474
- field: 'memoryPolicy.namespace',
475
- message: 'Required field "memoryPolicy.namespace" is missing',
476
- severity: 'error',
477
- });
478
- }
479
- if (!AUTHORITY_SCOPES.includes(manifest.memoryPolicy.authorityScope)) {
480
- errors.push({
481
- code: 'INVALID_ENUM',
482
- field: 'memoryPolicy.authorityScope',
483
- message: `authorityScope must be one of: ${AUTHORITY_SCOPES.join(', ')}`,
484
- severity: 'error',
485
- });
486
- }
487
- if (!WRITE_MODES.includes(manifest.memoryPolicy.writeMode)) {
488
- errors.push({
489
- code: 'INVALID_ENUM',
490
- field: 'memoryPolicy.writeMode',
491
- message: `writeMode must be one of: ${WRITE_MODES.join(', ')}`,
492
- severity: 'error',
493
- });
494
- }
495
- }
496
- // Observability sub-fields
497
- if (manifest.observability) {
498
- if (!TRACE_LEVELS.includes(manifest.observability.traceLevel)) {
499
- errors.push({
500
- code: 'INVALID_ENUM',
501
- field: 'observability.traceLevel',
502
- message: `traceLevel must be one of: ${TRACE_LEVELS.join(', ')}`,
503
- severity: 'error',
504
- });
505
- }
506
- }
507
- return errors;
508
- }
509
- validateApiVersion(manifest) {
510
- if (!manifest.apiVersion)
511
- return []; // caught by requiredFields
512
- if (manifest.apiVersion !== SUPPORTED_API_VERSION) {
513
- return [{
514
- code: 'UNSUPPORTED_API_VERSION',
515
- field: 'apiVersion',
516
- message: `API version "${manifest.apiVersion}" is not supported (expected "${SUPPORTED_API_VERSION}")`,
517
- severity: 'error',
518
- }];
519
- }
520
- return [];
521
- }
522
- validateDigest(manifest) {
523
- if (!manifest.cell?.codeRef?.digest)
524
- return []; // caught by requiredFields
525
- if (!SHA256_DIGEST_RE.test(manifest.cell.codeRef.digest)) {
526
- return [{
527
- code: 'INVALID_DIGEST',
528
- field: 'cell.codeRef.digest',
529
- message: `Digest must match "sha256:<64 hex chars>" format (got "${manifest.cell.codeRef.digest}")`,
530
- severity: 'error',
531
- }];
532
- }
533
- return [];
534
- }
535
- validateWarnings(manifest) {
536
- const warnings = [];
537
- // Warn about unknown tools
538
- if (manifest.toolPolicy?.toolsAllowed) {
539
- for (const tool of manifest.toolPolicy.toolsAllowed) {
540
- if (!KNOWN_TOOLS.has(tool)) {
541
- warnings.push({
542
- code: 'UNKNOWN_TOOL',
543
- field: 'toolPolicy.toolsAllowed',
544
- message: `Tool "${tool}" is not a recognized system tool`,
545
- severity: 'warning',
546
- });
547
- }
548
- }
549
- }
550
- // Warn if both coherence and anti-hallucination gates are disabled
551
- if (manifest.memoryPolicy &&
552
- !manifest.memoryPolicy.requiresCoherenceGate &&
553
- !manifest.memoryPolicy.requiresAntiHallucinationGate) {
554
- warnings.push({
555
- code: 'NO_MEMORY_GATES',
556
- field: 'memoryPolicy',
557
- message: 'Both coherence and anti-hallucination gates are disabled; memory writes are ungated',
558
- severity: 'warning',
559
- });
560
- }
561
- // Warn about high retention with sensitive data
562
- if (manifest.dataPolicy &&
563
- manifest.dataPolicy.dataSensitivity === 'restricted' &&
564
- manifest.dataPolicy.retentionDays > 30) {
565
- warnings.push({
566
- code: 'HIGH_RETENTION_SENSITIVE',
567
- field: 'dataPolicy.retentionDays',
568
- message: `Retention of ${manifest.dataPolicy.retentionDays} days is high for restricted data`,
569
- severity: 'warning',
570
- });
571
- }
572
- // Warn if no trace level is set to full but artifacts are emitted
573
- if (manifest.observability &&
574
- manifest.observability.emitArtifacts &&
575
- manifest.observability.traceLevel === 'none') {
576
- warnings.push({
577
- code: 'ARTIFACTS_WITHOUT_TRACING',
578
- field: 'observability',
579
- message: 'Artifact emission is enabled but trace level is "none"',
580
- severity: 'warning',
581
- });
582
- }
583
- return warnings;
584
- }
585
- }
586
- // ============================================================================
587
- // ConformanceSuite
588
- // ============================================================================
589
- /**
590
- * Runs golden traces through an evaluator and reports conformance.
591
- *
592
- * Each trace contains events with expected outcomes. The suite feeds every
593
- * event to the evaluator and compares the actual decision to the expectation.
594
- */
595
- export class ConformanceSuite {
596
- traces = [];
597
- /**
598
- * Add a golden trace to the suite.
599
- */
600
- addTrace(trace) {
601
- this.traces.push(trace);
602
- }
603
- /**
604
- * Run every event in every trace through the evaluator and compare
605
- * actual decisions against expected outcomes.
606
- */
607
- run(evaluator) {
608
- let totalEvents = 0;
609
- let matchedEvents = 0;
610
- const mismatches = [];
611
- for (const trace of this.traces) {
612
- for (const event of trace.events) {
613
- totalEvents++;
614
- const { decision, details } = evaluator(event);
615
- const expected = trace.expectedDecisions[String(event.seq)] ?? event.expectedOutcome;
616
- if (decision === expected) {
617
- matchedEvents++;
618
- }
619
- else {
620
- mismatches.push({
621
- traceId: trace.traceId,
622
- seq: event.seq,
623
- expected,
624
- actual: decision,
625
- details,
626
- });
627
- }
628
- }
629
- }
630
- return {
631
- passed: mismatches.length === 0,
632
- totalEvents,
633
- matchedEvents,
634
- mismatches,
635
- };
636
- }
637
- /**
638
- * Get all registered traces.
639
- */
640
- getTraces() {
641
- return [...this.traces];
642
- }
643
- /**
644
- * Create built-in default golden traces that verify core platform invariants:
645
- *
646
- * 1. Destructive command blocked
647
- * 2. Secret detected and blocked
648
- * 3. Budget exceeded and denied
649
- * 4. Memory write without evidence blocked
650
- * 5. Valid operation allowed
651
- */
652
- createDefaultTraces() {
653
- const traces = [
654
- // Trace 1: Destructive command must be blocked
655
- {
656
- traceId: 'default-destructive-blocked',
657
- name: 'Destructive command blocked',
658
- description: 'Verifies that destructive commands (rm -rf, DROP TABLE) are denied',
659
- events: [
660
- {
661
- seq: 1,
662
- eventType: 'command',
663
- payload: { command: 'rm -rf /', tool: 'Bash' },
664
- expectedOutcome: 'deny',
665
- },
666
- {
667
- seq: 2,
668
- eventType: 'command',
669
- payload: { command: 'DROP TABLE users', tool: 'Bash' },
670
- expectedOutcome: 'deny',
671
- },
672
- {
673
- seq: 3,
674
- eventType: 'command',
675
- payload: { command: 'git push --force origin main', tool: 'Bash' },
676
- expectedOutcome: 'deny',
677
- },
678
- ],
679
- expectedDecisions: { '1': 'deny', '2': 'deny', '3': 'deny' },
680
- expectedMemoryLineage: {},
681
- },
682
- // Trace 2: Secret detected and blocked
683
- {
684
- traceId: 'default-secret-blocked',
685
- name: 'Secret detected and blocked',
686
- description: 'Verifies that secrets in tool parameters are detected and blocked',
687
- events: [
688
- {
689
- seq: 1,
690
- eventType: 'tool-use',
691
- payload: {
692
- tool: 'Write',
693
- params: { content: 'api_key = "sk-abc123456789012345678901234567890"' },
694
- },
695
- expectedOutcome: 'deny',
696
- },
697
- {
698
- seq: 2,
699
- eventType: 'tool-use',
700
- payload: {
701
- tool: 'Edit',
702
- params: { content: '-----BEGIN RSA PRIVATE KEY-----' },
703
- },
704
- expectedOutcome: 'deny',
705
- },
706
- ],
707
- expectedDecisions: { '1': 'deny', '2': 'deny' },
708
- expectedMemoryLineage: {},
709
- },
710
- // Trace 3: Budget exceeded and denied
711
- {
712
- traceId: 'default-budget-exceeded',
713
- name: 'Budget exceeded and denied',
714
- description: 'Verifies that operations exceeding budget limits are denied',
715
- events: [
716
- {
717
- seq: 1,
718
- eventType: 'budget-check',
719
- payload: {
720
- resource: 'toolCalls',
721
- current: 999,
722
- limit: 1000,
723
- requested: 5,
724
- },
725
- expectedOutcome: 'deny',
726
- },
727
- {
728
- seq: 2,
729
- eventType: 'budget-check',
730
- payload: {
731
- resource: 'wallClockSeconds',
732
- current: 3500,
733
- limit: 3600,
734
- requested: 200,
735
- },
736
- expectedOutcome: 'deny',
737
- },
738
- ],
739
- expectedDecisions: { '1': 'deny', '2': 'deny' },
740
- expectedMemoryLineage: {},
741
- },
742
- // Trace 4: Memory write without evidence blocked
743
- {
744
- traceId: 'default-memory-no-evidence',
745
- name: 'Memory write without evidence blocked',
746
- description: 'Verifies that memory writes without proof/evidence trail are denied',
747
- events: [
748
- {
749
- seq: 1,
750
- eventType: 'memory-write',
751
- payload: {
752
- key: 'critical-decision',
753
- namespace: 'coordination',
754
- hasEvidence: false,
755
- coherenceScore: 0.3,
756
- },
757
- expectedOutcome: 'deny',
758
- },
759
- {
760
- seq: 2,
761
- eventType: 'memory-write',
762
- payload: {
763
- key: 'hallucinated-data',
764
- namespace: 'facts',
765
- hasEvidence: false,
766
- antiHallucinationPassed: false,
767
- },
768
- expectedOutcome: 'deny',
769
- },
770
- ],
771
- expectedDecisions: { '1': 'deny', '2': 'deny' },
772
- expectedMemoryLineage: {
773
- 'critical-decision': ['initial-assessment', 'root-task'],
774
- },
775
- },
776
- // Trace 5: Valid operation allowed
777
- {
778
- traceId: 'default-valid-allowed',
779
- name: 'Valid operation allowed',
780
- description: 'Verifies that well-formed, safe operations are allowed through',
781
- events: [
782
- {
783
- seq: 1,
784
- eventType: 'command',
785
- payload: { command: 'git status', tool: 'Bash' },
786
- expectedOutcome: 'allow',
787
- },
788
- {
789
- seq: 2,
790
- eventType: 'tool-use',
791
- payload: {
792
- tool: 'Read',
793
- params: { file_path: '/home/user/project/src/index.ts' },
794
- },
795
- expectedOutcome: 'allow',
796
- },
797
- {
798
- seq: 3,
799
- eventType: 'memory-write',
800
- payload: {
801
- key: 'agent-status',
802
- namespace: 'coordination',
803
- hasEvidence: true,
804
- coherenceScore: 0.95,
805
- antiHallucinationPassed: true,
806
- },
807
- expectedOutcome: 'allow',
808
- },
809
- ],
810
- expectedDecisions: { '1': 'allow', '2': 'allow', '3': 'allow' },
811
- expectedMemoryLineage: {},
812
- },
813
- ];
814
- return traces;
815
- }
816
- }
817
- // ============================================================================
818
- // Factory Functions
819
- // ============================================================================
820
- /**
821
- * Create a new ManifestValidator instance.
822
- */
823
- export function createManifestValidator(options) {
824
- return new ManifestValidator(options);
825
- }
826
- /**
827
- * Create a new ConformanceSuite instance, optionally pre-loaded with default traces.
828
- */
829
- export function createConformanceSuite(options) {
830
- const suite = new ConformanceSuite();
831
- if (options?.includeDefaults) {
832
- for (const trace of suite.createDefaultTraces()) {
833
- suite.addTrace(trace);
834
- }
835
- }
836
- return suite;
837
- }
838
- //# sourceMappingURL=manifest-validator.js.map