claude-flow 3.25.5 → 3.26.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 (312) hide show
  1. package/.claude/helpers/.helpers-version +1 -1
  2. package/.claude/helpers/helpers.manifest.json +5 -4
  3. package/.claude/helpers/hook-handler.cjs +129 -0
  4. package/.claude/helpers/statusline.cjs +300 -123
  5. package/.claude/proven-config.json +1 -1
  6. package/.claude/security-scans/scan-all-standard.json +321 -0
  7. package/.claude/security-scans/scan-code-deep.json +1209 -0
  8. package/.claude/security-scans/scan-deps-full.json +14 -0
  9. package/package.json +3 -1
  10. package/v3/@claude-flow/cli/catalog-manifest.json +12 -0
  11. package/v3/@claude-flow/cli/dist/src/commands/advisor.d.ts +15 -0
  12. package/v3/@claude-flow/cli/dist/src/commands/advisor.js +94 -0
  13. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +151 -32
  14. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +13 -0
  15. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +103 -0
  16. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +112 -46
  17. package/v3/@claude-flow/cli/dist/src/commands/index.js +10 -0
  18. package/v3/@claude-flow/cli/dist/src/commands/init.js +44 -0
  19. package/v3/@claude-flow/cli/dist/src/commands/proxy.d.ts +21 -0
  20. package/v3/@claude-flow/cli/dist/src/commands/proxy.js +310 -0
  21. package/v3/@claude-flow/cli/dist/src/commands/security.js +29 -0
  22. package/v3/@claude-flow/cli/dist/src/commands/settings.d.ts +19 -0
  23. package/v3/@claude-flow/cli/dist/src/commands/settings.js +180 -0
  24. package/v3/@claude-flow/cli/dist/src/commands/version.d.ts +42 -0
  25. package/v3/@claude-flow/cli/dist/src/commands/version.js +106 -0
  26. package/v3/@claude-flow/cli/dist/src/funnel/advisor-tip.d.ts +58 -0
  27. package/v3/@claude-flow/cli/dist/src/funnel/advisor-tip.js +92 -0
  28. package/v3/@claude-flow/cli/dist/src/funnel/attribution.d.ts +37 -0
  29. package/v3/@claude-flow/cli/dist/src/funnel/attribution.js +101 -0
  30. package/v3/@claude-flow/cli/dist/src/funnel/consent.d.ts +22 -0
  31. package/v3/@claude-flow/cli/dist/src/funnel/consent.js +55 -0
  32. package/v3/@claude-flow/cli/dist/src/funnel/credit-errors.d.ts +31 -0
  33. package/v3/@claude-flow/cli/dist/src/funnel/credit-errors.js +88 -0
  34. package/v3/@claude-flow/cli/dist/src/funnel/credit-notifier.d.ts +44 -0
  35. package/v3/@claude-flow/cli/dist/src/funnel/credit-notifier.js +74 -0
  36. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +46 -0
  37. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +97 -0
  38. package/v3/@claude-flow/cli/dist/src/funnel/enrollment.d.ts +36 -0
  39. package/v3/@claude-flow/cli/dist/src/funnel/enrollment.js +64 -0
  40. package/v3/@claude-flow/cli/dist/src/funnel/environment.d.ts +17 -0
  41. package/v3/@claude-flow/cli/dist/src/funnel/environment.js +39 -0
  42. package/v3/@claude-flow/cli/dist/src/funnel/event-transport.d.ts +51 -0
  43. package/v3/@claude-flow/cli/dist/src/funnel/event-transport.js +199 -0
  44. package/v3/@claude-flow/cli/dist/src/funnel/events.d.ts +42 -0
  45. package/v3/@claude-flow/cli/dist/src/funnel/events.js +150 -0
  46. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +20 -0
  47. package/v3/@claude-flow/cli/dist/src/funnel/index.js +20 -0
  48. package/v3/@claude-flow/cli/dist/src/funnel/insights.d.ts +49 -0
  49. package/v3/@claude-flow/cli/dist/src/funnel/insights.js +120 -0
  50. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.d.ts +15 -0
  51. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.js +68 -0
  52. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.d.ts +51 -0
  53. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.js +149 -0
  54. package/v3/@claude-flow/cli/dist/src/funnel/messages.d.ts +55 -0
  55. package/v3/@claude-flow/cli/dist/src/funnel/messages.js +160 -0
  56. package/v3/@claude-flow/cli/dist/src/funnel/power-saver-notifier.d.ts +44 -0
  57. package/v3/@claude-flow/cli/dist/src/funnel/power-saver-notifier.js +92 -0
  58. package/v3/@claude-flow/cli/dist/src/funnel/precedence.d.ts +16 -0
  59. package/v3/@claude-flow/cli/dist/src/funnel/precedence.js +85 -0
  60. package/v3/@claude-flow/cli/dist/src/funnel/promo.d.ts +41 -0
  61. package/v3/@claude-flow/cli/dist/src/funnel/promo.js +144 -0
  62. package/v3/@claude-flow/cli/dist/src/funnel/rate-limit-notifier.d.ts +55 -0
  63. package/v3/@claude-flow/cli/dist/src/funnel/rate-limit-notifier.js +102 -0
  64. package/v3/@claude-flow/cli/dist/src/funnel/rotation.d.ts +19 -0
  65. package/v3/@claude-flow/cli/dist/src/funnel/rotation.js +70 -0
  66. package/v3/@claude-flow/cli/dist/src/funnel/state.d.ts +13 -0
  67. package/v3/@claude-flow/cli/dist/src/funnel/state.js +52 -0
  68. package/v3/@claude-flow/cli/dist/src/funnel/toggle-cooldown.d.ts +17 -0
  69. package/v3/@claude-flow/cli/dist/src/funnel/toggle-cooldown.js +32 -0
  70. package/v3/@claude-flow/cli/dist/src/funnel/types.d.ts +86 -0
  71. package/v3/@claude-flow/cli/dist/src/funnel/types.js +26 -0
  72. package/v3/@claude-flow/cli/dist/src/init/executor.js +25 -19
  73. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.d.ts +33 -2
  74. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.js +102 -12
  75. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +52 -0
  76. package/v3/@claude-flow/cli/dist/src/init/mcp-generator.js +11 -6
  77. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +282 -116
  78. package/v3/@claude-flow/cli/dist/src/services/daemon-autostart.js +28 -5
  79. package/v3/@claude-flow/cli/dist/src/services/fable-harness.d.ts +39 -0
  80. package/v3/@claude-flow/cli/dist/src/services/fable-harness.js +41 -0
  81. package/v3/@claude-flow/cli/package.json +16 -4
  82. package/v3/README.md +493 -0
  83. package/.claude/coordinator/config.json +0 -24
  84. package/.claude/coordinator/state.json +0 -37
  85. package/.claude/coordinator/tick-log/tick-01.json +0 -17
  86. package/.claude/coordinator/tick-log/tick-02.json +0 -17
  87. package/.claude/coordinator/tick-log/tick-03.json +0 -17
  88. package/.claude/coordinator/tick-log/tick-04.json +0 -14
  89. package/.claude/coordinator/tick-log/tick-05.json +0 -16
  90. package/.claude/settings.local.json +0 -11
  91. package/v3/@claude-flow/cli/dist/src/ruvector/lattice-wasm.d.ts +0 -14
  92. package/v3/@claude-flow/cli/dist/src/ruvector/lattice-wasm.js +0 -144
  93. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +0 -284
  94. package/v3/@claude-flow/guidance/dist/adversarial.js +0 -572
  95. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +0 -530
  96. package/v3/@claude-flow/guidance/dist/analyzer.js +0 -2587
  97. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +0 -283
  98. package/v3/@claude-flow/guidance/dist/artifacts.js +0 -356
  99. package/v3/@claude-flow/guidance/dist/authority.d.ts +0 -290
  100. package/v3/@claude-flow/guidance/dist/authority.js +0 -558
  101. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +0 -209
  102. package/v3/@claude-flow/guidance/dist/capabilities.js +0 -485
  103. package/v3/@claude-flow/guidance/dist/coherence.d.ts +0 -233
  104. package/v3/@claude-flow/guidance/dist/coherence.js +0 -372
  105. package/v3/@claude-flow/guidance/dist/compiler.d.ts +0 -87
  106. package/v3/@claude-flow/guidance/dist/compiler.js +0 -410
  107. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +0 -225
  108. package/v3/@claude-flow/guidance/dist/conformance-kit.js +0 -629
  109. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +0 -214
  110. package/v3/@claude-flow/guidance/dist/continue-gate.js +0 -353
  111. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +0 -17
  112. package/v3/@claude-flow/guidance/dist/crypto-utils.js +0 -24
  113. package/v3/@claude-flow/guidance/dist/evolution.d.ts +0 -282
  114. package/v3/@claude-flow/guidance/dist/evolution.js +0 -500
  115. package/v3/@claude-flow/guidance/dist/gates.d.ts +0 -79
  116. package/v3/@claude-flow/guidance/dist/gates.js +0 -302
  117. package/v3/@claude-flow/guidance/dist/gateway.d.ts +0 -206
  118. package/v3/@claude-flow/guidance/dist/gateway.js +0 -452
  119. package/v3/@claude-flow/guidance/dist/generators.d.ts +0 -153
  120. package/v3/@claude-flow/guidance/dist/generators.js +0 -682
  121. package/v3/@claude-flow/guidance/dist/headless.d.ts +0 -177
  122. package/v3/@claude-flow/guidance/dist/headless.js +0 -342
  123. package/v3/@claude-flow/guidance/dist/hooks.d.ts +0 -109
  124. package/v3/@claude-flow/guidance/dist/hooks.js +0 -347
  125. package/v3/@claude-flow/guidance/dist/index.d.ts +0 -205
  126. package/v3/@claude-flow/guidance/dist/index.js +0 -321
  127. package/v3/@claude-flow/guidance/dist/ledger.d.ts +0 -162
  128. package/v3/@claude-flow/guidance/dist/ledger.js +0 -375
  129. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +0 -289
  130. package/v3/@claude-flow/guidance/dist/manifest-validator.js +0 -838
  131. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +0 -222
  132. package/v3/@claude-flow/guidance/dist/memory-gate.js +0 -382
  133. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +0 -265
  134. package/v3/@claude-flow/guidance/dist/meta-governance.js +0 -348
  135. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +0 -104
  136. package/v3/@claude-flow/guidance/dist/optimizer.js +0 -329
  137. package/v3/@claude-flow/guidance/dist/persistence.d.ts +0 -189
  138. package/v3/@claude-flow/guidance/dist/persistence.js +0 -464
  139. package/v3/@claude-flow/guidance/dist/proof.d.ts +0 -185
  140. package/v3/@claude-flow/guidance/dist/proof.js +0 -238
  141. package/v3/@claude-flow/guidance/dist/retriever.d.ts +0 -172
  142. package/v3/@claude-flow/guidance/dist/retriever.js +0 -596
  143. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +0 -370
  144. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +0 -738
  145. package/v3/@claude-flow/guidance/dist/temporal.d.ts +0 -426
  146. package/v3/@claude-flow/guidance/dist/temporal.js +0 -658
  147. package/v3/@claude-flow/guidance/dist/trust.d.ts +0 -283
  148. package/v3/@claude-flow/guidance/dist/trust.js +0 -473
  149. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +0 -276
  150. package/v3/@claude-flow/guidance/dist/truth-anchors.js +0 -488
  151. package/v3/@claude-flow/guidance/dist/types.d.ts +0 -378
  152. package/v3/@claude-flow/guidance/dist/types.js +0 -10
  153. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +0 -372
  154. package/v3/@claude-flow/guidance/dist/uncertainty.js +0 -619
  155. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +0 -48
  156. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +0 -158
  157. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +0 -41
  158. package/v3/@claude-flow/shared/dist/core/config/defaults.js +0 -186
  159. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +0 -8
  160. package/v3/@claude-flow/shared/dist/core/config/index.js +0 -12
  161. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +0 -45
  162. package/v3/@claude-flow/shared/dist/core/config/loader.js +0 -238
  163. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +0 -1728
  164. package/v3/@claude-flow/shared/dist/core/config/schema.js +0 -160
  165. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +0 -92
  166. package/v3/@claude-flow/shared/dist/core/config/validator.js +0 -147
  167. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +0 -31
  168. package/v3/@claude-flow/shared/dist/core/event-bus.js +0 -197
  169. package/v3/@claude-flow/shared/dist/core/index.d.ts +0 -15
  170. package/v3/@claude-flow/shared/dist/core/index.js +0 -19
  171. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +0 -200
  172. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +0 -6
  173. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +0 -310
  174. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +0 -7
  175. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +0 -224
  176. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +0 -46
  177. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +0 -10
  178. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +0 -15
  179. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +0 -298
  180. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +0 -7
  181. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +0 -185
  182. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +0 -6
  183. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +0 -35
  184. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +0 -101
  185. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +0 -60
  186. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +0 -166
  187. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +0 -46
  188. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +0 -64
  189. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +0 -56
  190. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +0 -195
  191. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +0 -83
  192. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +0 -193
  193. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +0 -49
  194. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +0 -253
  195. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +0 -282
  196. package/v3/@claude-flow/shared/dist/events/domain-events.js +0 -165
  197. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +0 -126
  198. package/v3/@claude-flow/shared/dist/events/event-store.js +0 -427
  199. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +0 -8
  200. package/v3/@claude-flow/shared/dist/events/event-store.test.js +0 -293
  201. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +0 -10
  202. package/v3/@claude-flow/shared/dist/events/example-usage.js +0 -193
  203. package/v3/@claude-flow/shared/dist/events/index.d.ts +0 -21
  204. package/v3/@claude-flow/shared/dist/events/index.js +0 -22
  205. package/v3/@claude-flow/shared/dist/events/projections.d.ts +0 -177
  206. package/v3/@claude-flow/shared/dist/events/projections.js +0 -421
  207. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +0 -82
  208. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +0 -340
  209. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +0 -101
  210. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +0 -263
  211. package/v3/@claude-flow/shared/dist/events.d.ts +0 -80
  212. package/v3/@claude-flow/shared/dist/events.js +0 -249
  213. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +0 -42
  214. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +0 -351
  215. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +0 -100
  216. package/v3/@claude-flow/shared/dist/hooks/executor.js +0 -267
  217. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +0 -9
  218. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +0 -322
  219. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +0 -52
  220. package/v3/@claude-flow/shared/dist/hooks/index.js +0 -51
  221. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +0 -133
  222. package/v3/@claude-flow/shared/dist/hooks/registry.js +0 -277
  223. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +0 -105
  224. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +0 -481
  225. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +0 -144
  226. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +0 -328
  227. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +0 -158
  228. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +0 -450
  229. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +0 -17
  230. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +0 -17
  231. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +0 -234
  232. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +0 -334
  233. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +0 -163
  234. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +0 -326
  235. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +0 -267
  236. package/v3/@claude-flow/shared/dist/hooks/types.js +0 -62
  237. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +0 -9
  238. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +0 -93
  239. package/v3/@claude-flow/shared/dist/index.d.ts +0 -20
  240. package/v3/@claude-flow/shared/dist/index.js +0 -50
  241. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +0 -98
  242. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +0 -364
  243. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +0 -69
  244. package/v3/@claude-flow/shared/dist/mcp/index.js +0 -84
  245. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +0 -166
  246. package/v3/@claude-flow/shared/dist/mcp/server.js +0 -590
  247. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +0 -136
  248. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +0 -335
  249. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +0 -178
  250. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +0 -439
  251. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +0 -104
  252. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +0 -476
  253. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +0 -102
  254. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +0 -238
  255. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +0 -104
  256. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +0 -263
  257. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +0 -133
  258. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +0 -396
  259. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +0 -436
  260. package/v3/@claude-flow/shared/dist/mcp/types.js +0 -54
  261. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +0 -544
  262. package/v3/@claude-flow/shared/dist/plugin-interface.js +0 -23
  263. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +0 -139
  264. package/v3/@claude-flow/shared/dist/plugin-loader.js +0 -434
  265. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +0 -183
  266. package/v3/@claude-flow/shared/dist/plugin-registry.js +0 -457
  267. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +0 -10
  268. package/v3/@claude-flow/shared/dist/plugins/index.js +0 -10
  269. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +0 -106
  270. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +0 -241
  271. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +0 -10
  272. package/v3/@claude-flow/shared/dist/plugins/official/index.js +0 -10
  273. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +0 -121
  274. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +0 -355
  275. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +0 -93
  276. package/v3/@claude-flow/shared/dist/plugins/types.js +0 -9
  277. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +0 -105
  278. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +0 -206
  279. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +0 -132
  280. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +0 -233
  281. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +0 -19
  282. package/v3/@claude-flow/shared/dist/resilience/index.js +0 -19
  283. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +0 -168
  284. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +0 -314
  285. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +0 -91
  286. package/v3/@claude-flow/shared/dist/resilience/retry.js +0 -159
  287. package/v3/@claude-flow/shared/dist/security/index.d.ts +0 -10
  288. package/v3/@claude-flow/shared/dist/security/index.js +0 -12
  289. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +0 -73
  290. package/v3/@claude-flow/shared/dist/security/input-validation.js +0 -201
  291. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +0 -92
  292. package/v3/@claude-flow/shared/dist/security/secure-random.js +0 -142
  293. package/v3/@claude-flow/shared/dist/services/index.d.ts +0 -7
  294. package/v3/@claude-flow/shared/dist/services/index.js +0 -7
  295. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +0 -124
  296. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +0 -402
  297. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +0 -137
  298. package/v3/@claude-flow/shared/dist/types/agent.types.js +0 -6
  299. package/v3/@claude-flow/shared/dist/types/index.d.ts +0 -11
  300. package/v3/@claude-flow/shared/dist/types/index.js +0 -17
  301. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +0 -266
  302. package/v3/@claude-flow/shared/dist/types/mcp.types.js +0 -7
  303. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +0 -236
  304. package/v3/@claude-flow/shared/dist/types/memory.types.js +0 -7
  305. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +0 -186
  306. package/v3/@claude-flow/shared/dist/types/swarm.types.js +0 -65
  307. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +0 -178
  308. package/v3/@claude-flow/shared/dist/types/task.types.js +0 -32
  309. package/v3/@claude-flow/shared/dist/types.d.ts +0 -197
  310. package/v3/@claude-flow/shared/dist/types.js +0 -21
  311. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +0 -69
  312. 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