claude-flow 3.25.6 → 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 (311) 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/intelligence.cjs +10 -0
  5. package/.claude/helpers/statusline.cjs +300 -123
  6. package/.claude/proven-config.json +1 -1
  7. package/.claude/security-scans/scan-all-standard.json +321 -0
  8. package/.claude/security-scans/scan-code-deep.json +1209 -0
  9. package/.claude/security-scans/scan-deps-full.json +14 -0
  10. package/package.json +3 -1
  11. package/v3/@claude-flow/cli/catalog-manifest.json +12 -0
  12. package/v3/@claude-flow/cli/dist/src/commands/advisor.d.ts +15 -0
  13. package/v3/@claude-flow/cli/dist/src/commands/advisor.js +94 -0
  14. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +77 -3
  15. package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +13 -0
  16. package/v3/@claude-flow/cli/dist/src/commands/funnel.js +103 -0
  17. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +112 -46
  18. package/v3/@claude-flow/cli/dist/src/commands/index.js +10 -0
  19. package/v3/@claude-flow/cli/dist/src/commands/init.js +44 -0
  20. package/v3/@claude-flow/cli/dist/src/commands/proxy.d.ts +21 -0
  21. package/v3/@claude-flow/cli/dist/src/commands/proxy.js +310 -0
  22. package/v3/@claude-flow/cli/dist/src/commands/security.js +29 -0
  23. package/v3/@claude-flow/cli/dist/src/commands/settings.d.ts +19 -0
  24. package/v3/@claude-flow/cli/dist/src/commands/settings.js +180 -0
  25. package/v3/@claude-flow/cli/dist/src/commands/version.d.ts +42 -0
  26. package/v3/@claude-flow/cli/dist/src/commands/version.js +106 -0
  27. package/v3/@claude-flow/cli/dist/src/funnel/advisor-tip.d.ts +58 -0
  28. package/v3/@claude-flow/cli/dist/src/funnel/advisor-tip.js +92 -0
  29. package/v3/@claude-flow/cli/dist/src/funnel/attribution.d.ts +37 -0
  30. package/v3/@claude-flow/cli/dist/src/funnel/attribution.js +101 -0
  31. package/v3/@claude-flow/cli/dist/src/funnel/consent.d.ts +22 -0
  32. package/v3/@claude-flow/cli/dist/src/funnel/consent.js +55 -0
  33. package/v3/@claude-flow/cli/dist/src/funnel/credit-errors.d.ts +31 -0
  34. package/v3/@claude-flow/cli/dist/src/funnel/credit-errors.js +88 -0
  35. package/v3/@claude-flow/cli/dist/src/funnel/credit-notifier.d.ts +44 -0
  36. package/v3/@claude-flow/cli/dist/src/funnel/credit-notifier.js +74 -0
  37. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +46 -0
  38. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +97 -0
  39. package/v3/@claude-flow/cli/dist/src/funnel/enrollment.d.ts +36 -0
  40. package/v3/@claude-flow/cli/dist/src/funnel/enrollment.js +64 -0
  41. package/v3/@claude-flow/cli/dist/src/funnel/environment.d.ts +17 -0
  42. package/v3/@claude-flow/cli/dist/src/funnel/environment.js +39 -0
  43. package/v3/@claude-flow/cli/dist/src/funnel/event-transport.d.ts +51 -0
  44. package/v3/@claude-flow/cli/dist/src/funnel/event-transport.js +199 -0
  45. package/v3/@claude-flow/cli/dist/src/funnel/events.d.ts +42 -0
  46. package/v3/@claude-flow/cli/dist/src/funnel/events.js +150 -0
  47. package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +20 -0
  48. package/v3/@claude-flow/cli/dist/src/funnel/index.js +20 -0
  49. package/v3/@claude-flow/cli/dist/src/funnel/insights.d.ts +49 -0
  50. package/v3/@claude-flow/cli/dist/src/funnel/insights.js +120 -0
  51. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.d.ts +15 -0
  52. package/v3/@claude-flow/cli/dist/src/funnel/local-signals.js +68 -0
  53. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.d.ts +51 -0
  54. package/v3/@claude-flow/cli/dist/src/funnel/message-transport.js +149 -0
  55. package/v3/@claude-flow/cli/dist/src/funnel/messages.d.ts +55 -0
  56. package/v3/@claude-flow/cli/dist/src/funnel/messages.js +160 -0
  57. package/v3/@claude-flow/cli/dist/src/funnel/power-saver-notifier.d.ts +44 -0
  58. package/v3/@claude-flow/cli/dist/src/funnel/power-saver-notifier.js +92 -0
  59. package/v3/@claude-flow/cli/dist/src/funnel/precedence.d.ts +16 -0
  60. package/v3/@claude-flow/cli/dist/src/funnel/precedence.js +85 -0
  61. package/v3/@claude-flow/cli/dist/src/funnel/promo.d.ts +41 -0
  62. package/v3/@claude-flow/cli/dist/src/funnel/promo.js +144 -0
  63. package/v3/@claude-flow/cli/dist/src/funnel/rate-limit-notifier.d.ts +55 -0
  64. package/v3/@claude-flow/cli/dist/src/funnel/rate-limit-notifier.js +102 -0
  65. package/v3/@claude-flow/cli/dist/src/funnel/rotation.d.ts +19 -0
  66. package/v3/@claude-flow/cli/dist/src/funnel/rotation.js +70 -0
  67. package/v3/@claude-flow/cli/dist/src/funnel/state.d.ts +13 -0
  68. package/v3/@claude-flow/cli/dist/src/funnel/state.js +52 -0
  69. package/v3/@claude-flow/cli/dist/src/funnel/toggle-cooldown.d.ts +17 -0
  70. package/v3/@claude-flow/cli/dist/src/funnel/toggle-cooldown.js +32 -0
  71. package/v3/@claude-flow/cli/dist/src/funnel/types.d.ts +86 -0
  72. package/v3/@claude-flow/cli/dist/src/funnel/types.js +26 -0
  73. package/v3/@claude-flow/cli/dist/src/init/executor.js +9 -3
  74. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.d.ts +33 -2
  75. package/v3/@claude-flow/cli/dist/src/init/helper-refresh.js +102 -12
  76. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +52 -0
  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 +13 -4
  82. package/.claude/coordinator/config.json +0 -24
  83. package/.claude/coordinator/state.json +0 -37
  84. package/.claude/coordinator/tick-log/tick-01.json +0 -17
  85. package/.claude/coordinator/tick-log/tick-02.json +0 -17
  86. package/.claude/coordinator/tick-log/tick-03.json +0 -17
  87. package/.claude/coordinator/tick-log/tick-04.json +0 -14
  88. package/.claude/coordinator/tick-log/tick-05.json +0 -16
  89. package/.claude/settings.local.json +0 -11
  90. package/v3/@claude-flow/cli/dist/src/ruvector/lattice-wasm.d.ts +0 -14
  91. package/v3/@claude-flow/cli/dist/src/ruvector/lattice-wasm.js +0 -144
  92. package/v3/@claude-flow/guidance/dist/adversarial.d.ts +0 -284
  93. package/v3/@claude-flow/guidance/dist/adversarial.js +0 -572
  94. package/v3/@claude-flow/guidance/dist/analyzer.d.ts +0 -530
  95. package/v3/@claude-flow/guidance/dist/analyzer.js +0 -2587
  96. package/v3/@claude-flow/guidance/dist/artifacts.d.ts +0 -283
  97. package/v3/@claude-flow/guidance/dist/artifacts.js +0 -356
  98. package/v3/@claude-flow/guidance/dist/authority.d.ts +0 -290
  99. package/v3/@claude-flow/guidance/dist/authority.js +0 -558
  100. package/v3/@claude-flow/guidance/dist/capabilities.d.ts +0 -209
  101. package/v3/@claude-flow/guidance/dist/capabilities.js +0 -485
  102. package/v3/@claude-flow/guidance/dist/coherence.d.ts +0 -233
  103. package/v3/@claude-flow/guidance/dist/coherence.js +0 -372
  104. package/v3/@claude-flow/guidance/dist/compiler.d.ts +0 -87
  105. package/v3/@claude-flow/guidance/dist/compiler.js +0 -410
  106. package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +0 -225
  107. package/v3/@claude-flow/guidance/dist/conformance-kit.js +0 -629
  108. package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +0 -214
  109. package/v3/@claude-flow/guidance/dist/continue-gate.js +0 -353
  110. package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +0 -17
  111. package/v3/@claude-flow/guidance/dist/crypto-utils.js +0 -24
  112. package/v3/@claude-flow/guidance/dist/evolution.d.ts +0 -282
  113. package/v3/@claude-flow/guidance/dist/evolution.js +0 -500
  114. package/v3/@claude-flow/guidance/dist/gates.d.ts +0 -79
  115. package/v3/@claude-flow/guidance/dist/gates.js +0 -302
  116. package/v3/@claude-flow/guidance/dist/gateway.d.ts +0 -206
  117. package/v3/@claude-flow/guidance/dist/gateway.js +0 -452
  118. package/v3/@claude-flow/guidance/dist/generators.d.ts +0 -153
  119. package/v3/@claude-flow/guidance/dist/generators.js +0 -682
  120. package/v3/@claude-flow/guidance/dist/headless.d.ts +0 -177
  121. package/v3/@claude-flow/guidance/dist/headless.js +0 -342
  122. package/v3/@claude-flow/guidance/dist/hooks.d.ts +0 -109
  123. package/v3/@claude-flow/guidance/dist/hooks.js +0 -347
  124. package/v3/@claude-flow/guidance/dist/index.d.ts +0 -205
  125. package/v3/@claude-flow/guidance/dist/index.js +0 -321
  126. package/v3/@claude-flow/guidance/dist/ledger.d.ts +0 -162
  127. package/v3/@claude-flow/guidance/dist/ledger.js +0 -375
  128. package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +0 -289
  129. package/v3/@claude-flow/guidance/dist/manifest-validator.js +0 -838
  130. package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +0 -222
  131. package/v3/@claude-flow/guidance/dist/memory-gate.js +0 -382
  132. package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +0 -265
  133. package/v3/@claude-flow/guidance/dist/meta-governance.js +0 -348
  134. package/v3/@claude-flow/guidance/dist/optimizer.d.ts +0 -104
  135. package/v3/@claude-flow/guidance/dist/optimizer.js +0 -329
  136. package/v3/@claude-flow/guidance/dist/persistence.d.ts +0 -189
  137. package/v3/@claude-flow/guidance/dist/persistence.js +0 -464
  138. package/v3/@claude-flow/guidance/dist/proof.d.ts +0 -185
  139. package/v3/@claude-flow/guidance/dist/proof.js +0 -238
  140. package/v3/@claude-flow/guidance/dist/retriever.d.ts +0 -172
  141. package/v3/@claude-flow/guidance/dist/retriever.js +0 -596
  142. package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +0 -370
  143. package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +0 -738
  144. package/v3/@claude-flow/guidance/dist/temporal.d.ts +0 -426
  145. package/v3/@claude-flow/guidance/dist/temporal.js +0 -658
  146. package/v3/@claude-flow/guidance/dist/trust.d.ts +0 -283
  147. package/v3/@claude-flow/guidance/dist/trust.js +0 -473
  148. package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +0 -276
  149. package/v3/@claude-flow/guidance/dist/truth-anchors.js +0 -488
  150. package/v3/@claude-flow/guidance/dist/types.d.ts +0 -378
  151. package/v3/@claude-flow/guidance/dist/types.js +0 -10
  152. package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +0 -372
  153. package/v3/@claude-flow/guidance/dist/uncertainty.js +0 -619
  154. package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +0 -48
  155. package/v3/@claude-flow/guidance/dist/wasm-kernel.js +0 -158
  156. package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +0 -41
  157. package/v3/@claude-flow/shared/dist/core/config/defaults.js +0 -186
  158. package/v3/@claude-flow/shared/dist/core/config/index.d.ts +0 -8
  159. package/v3/@claude-flow/shared/dist/core/config/index.js +0 -12
  160. package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +0 -45
  161. package/v3/@claude-flow/shared/dist/core/config/loader.js +0 -238
  162. package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +0 -1728
  163. package/v3/@claude-flow/shared/dist/core/config/schema.js +0 -160
  164. package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +0 -92
  165. package/v3/@claude-flow/shared/dist/core/config/validator.js +0 -147
  166. package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +0 -31
  167. package/v3/@claude-flow/shared/dist/core/event-bus.js +0 -197
  168. package/v3/@claude-flow/shared/dist/core/index.d.ts +0 -15
  169. package/v3/@claude-flow/shared/dist/core/index.js +0 -19
  170. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +0 -200
  171. package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +0 -6
  172. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +0 -310
  173. package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +0 -7
  174. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +0 -224
  175. package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +0 -46
  176. package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +0 -10
  177. package/v3/@claude-flow/shared/dist/core/interfaces/index.js +0 -15
  178. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +0 -298
  179. package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +0 -7
  180. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +0 -185
  181. package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +0 -6
  182. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +0 -35
  183. package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +0 -101
  184. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +0 -60
  185. package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +0 -166
  186. package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +0 -46
  187. package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +0 -64
  188. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +0 -56
  189. package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +0 -195
  190. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +0 -83
  191. package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +0 -193
  192. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +0 -49
  193. package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +0 -253
  194. package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +0 -282
  195. package/v3/@claude-flow/shared/dist/events/domain-events.js +0 -165
  196. package/v3/@claude-flow/shared/dist/events/event-store.d.ts +0 -126
  197. package/v3/@claude-flow/shared/dist/events/event-store.js +0 -427
  198. package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +0 -8
  199. package/v3/@claude-flow/shared/dist/events/event-store.test.js +0 -293
  200. package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +0 -10
  201. package/v3/@claude-flow/shared/dist/events/example-usage.js +0 -193
  202. package/v3/@claude-flow/shared/dist/events/index.d.ts +0 -21
  203. package/v3/@claude-flow/shared/dist/events/index.js +0 -22
  204. package/v3/@claude-flow/shared/dist/events/projections.d.ts +0 -177
  205. package/v3/@claude-flow/shared/dist/events/projections.js +0 -421
  206. package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +0 -82
  207. package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +0 -340
  208. package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +0 -101
  209. package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +0 -263
  210. package/v3/@claude-flow/shared/dist/events.d.ts +0 -80
  211. package/v3/@claude-flow/shared/dist/events.js +0 -249
  212. package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +0 -42
  213. package/v3/@claude-flow/shared/dist/hooks/example-usage.js +0 -351
  214. package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +0 -100
  215. package/v3/@claude-flow/shared/dist/hooks/executor.js +0 -267
  216. package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +0 -9
  217. package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +0 -322
  218. package/v3/@claude-flow/shared/dist/hooks/index.d.ts +0 -52
  219. package/v3/@claude-flow/shared/dist/hooks/index.js +0 -51
  220. package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +0 -133
  221. package/v3/@claude-flow/shared/dist/hooks/registry.js +0 -277
  222. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +0 -105
  223. package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +0 -481
  224. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +0 -144
  225. package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +0 -328
  226. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +0 -158
  227. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +0 -450
  228. package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +0 -17
  229. package/v3/@claude-flow/shared/dist/hooks/safety/index.js +0 -17
  230. package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +0 -234
  231. package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +0 -334
  232. package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +0 -163
  233. package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +0 -326
  234. package/v3/@claude-flow/shared/dist/hooks/types.d.ts +0 -267
  235. package/v3/@claude-flow/shared/dist/hooks/types.js +0 -62
  236. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +0 -9
  237. package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +0 -93
  238. package/v3/@claude-flow/shared/dist/index.d.ts +0 -20
  239. package/v3/@claude-flow/shared/dist/index.js +0 -50
  240. package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +0 -98
  241. package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +0 -364
  242. package/v3/@claude-flow/shared/dist/mcp/index.d.ts +0 -69
  243. package/v3/@claude-flow/shared/dist/mcp/index.js +0 -84
  244. package/v3/@claude-flow/shared/dist/mcp/server.d.ts +0 -166
  245. package/v3/@claude-flow/shared/dist/mcp/server.js +0 -590
  246. package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +0 -136
  247. package/v3/@claude-flow/shared/dist/mcp/session-manager.js +0 -335
  248. package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +0 -178
  249. package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +0 -439
  250. package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +0 -104
  251. package/v3/@claude-flow/shared/dist/mcp/transport/http.js +0 -476
  252. package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +0 -102
  253. package/v3/@claude-flow/shared/dist/mcp/transport/index.js +0 -238
  254. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +0 -104
  255. package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +0 -263
  256. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +0 -133
  257. package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +0 -396
  258. package/v3/@claude-flow/shared/dist/mcp/types.d.ts +0 -436
  259. package/v3/@claude-flow/shared/dist/mcp/types.js +0 -54
  260. package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +0 -544
  261. package/v3/@claude-flow/shared/dist/plugin-interface.js +0 -23
  262. package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +0 -139
  263. package/v3/@claude-flow/shared/dist/plugin-loader.js +0 -434
  264. package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +0 -183
  265. package/v3/@claude-flow/shared/dist/plugin-registry.js +0 -457
  266. package/v3/@claude-flow/shared/dist/plugins/index.d.ts +0 -10
  267. package/v3/@claude-flow/shared/dist/plugins/index.js +0 -10
  268. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +0 -106
  269. package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +0 -241
  270. package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +0 -10
  271. package/v3/@claude-flow/shared/dist/plugins/official/index.js +0 -10
  272. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +0 -121
  273. package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +0 -355
  274. package/v3/@claude-flow/shared/dist/plugins/types.d.ts +0 -93
  275. package/v3/@claude-flow/shared/dist/plugins/types.js +0 -9
  276. package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +0 -105
  277. package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +0 -206
  278. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +0 -132
  279. package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +0 -233
  280. package/v3/@claude-flow/shared/dist/resilience/index.d.ts +0 -19
  281. package/v3/@claude-flow/shared/dist/resilience/index.js +0 -19
  282. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +0 -168
  283. package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +0 -314
  284. package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +0 -91
  285. package/v3/@claude-flow/shared/dist/resilience/retry.js +0 -159
  286. package/v3/@claude-flow/shared/dist/security/index.d.ts +0 -10
  287. package/v3/@claude-flow/shared/dist/security/index.js +0 -12
  288. package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +0 -73
  289. package/v3/@claude-flow/shared/dist/security/input-validation.js +0 -201
  290. package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +0 -92
  291. package/v3/@claude-flow/shared/dist/security/secure-random.js +0 -142
  292. package/v3/@claude-flow/shared/dist/services/index.d.ts +0 -7
  293. package/v3/@claude-flow/shared/dist/services/index.js +0 -7
  294. package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +0 -124
  295. package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +0 -402
  296. package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +0 -137
  297. package/v3/@claude-flow/shared/dist/types/agent.types.js +0 -6
  298. package/v3/@claude-flow/shared/dist/types/index.d.ts +0 -11
  299. package/v3/@claude-flow/shared/dist/types/index.js +0 -17
  300. package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +0 -266
  301. package/v3/@claude-flow/shared/dist/types/mcp.types.js +0 -7
  302. package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +0 -236
  303. package/v3/@claude-flow/shared/dist/types/memory.types.js +0 -7
  304. package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +0 -186
  305. package/v3/@claude-flow/shared/dist/types/swarm.types.js +0 -65
  306. package/v3/@claude-flow/shared/dist/types/task.types.d.ts +0 -178
  307. package/v3/@claude-flow/shared/dist/types/task.types.js +0 -32
  308. package/v3/@claude-flow/shared/dist/types.d.ts +0 -197
  309. package/v3/@claude-flow/shared/dist/types.js +0 -21
  310. package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +0 -69
  311. package/v3/@claude-flow/shared/dist/utils/secure-logger.js +0 -208
@@ -1,738 +0,0 @@
1
- /**
2
- * RuvBot Integration Bridge
3
- *
4
- * Bridges ruvbot (npm: ruvbot@0.1.8) with the @claude-flow/guidance control
5
- * plane. Wires ruvbot events to guidance hooks, wraps AIDefence as an
6
- * enforcement gate, governs memory operations, and feeds trust accumulation.
7
- *
8
- * ruvbot is an optional peer dependency. All types and classes are exported
9
- * regardless of whether ruvbot is installed. Runtime calls that require the
10
- * ruvbot package will throw a clear error if the package is missing.
11
- *
12
- * Components:
13
- * 1. RuvBotGuidanceBridge - Event wiring, gate delegation, trust tracking
14
- * 2. AIDefenceGate - Prompt injection, jailbreak, PII detection gate
15
- * 3. RuvBotMemoryAdapter - Governed memory read/write with proof logging
16
- *
17
- * @module @claude-flow/guidance/ruvbot-integration
18
- */
19
- // ============================================================================
20
- // Severity Mapping
21
- // ============================================================================
22
- /** Maps blockThreshold to a minimum severity that triggers a block. */
23
- const BLOCK_SEVERITY_THRESHOLDS = {
24
- low: new Set(['low', 'medium', 'high', 'critical']),
25
- medium: new Set(['medium', 'high', 'critical']),
26
- high: new Set(['high', 'critical']),
27
- };
28
- /** Maps ruvbot threat type strings to our typed threat type. */
29
- const THREAT_TYPE_MAP = {
30
- 'prompt-injection': 'prompt-injection',
31
- 'prompt_injection': 'prompt-injection',
32
- 'promptInjection': 'prompt-injection',
33
- 'jailbreak': 'jailbreak',
34
- 'pii': 'pii',
35
- 'control-chars': 'control-chars',
36
- 'control_chars': 'control-chars',
37
- 'controlChars': 'control-chars',
38
- 'homoglyph': 'homoglyph',
39
- };
40
- /** Maps ruvbot severity strings to our typed severity. */
41
- const SEVERITY_MAP = {
42
- low: 'low',
43
- medium: 'medium',
44
- high: 'high',
45
- critical: 'critical',
46
- };
47
- // ============================================================================
48
- // Dynamic Import Helper
49
- // ============================================================================
50
- /** Resolved ruvbot module cache (null = not attempted, undefined = failed). */
51
- let ruvbotModuleCache = null;
52
- /**
53
- * Module specifiers kept in variables so TypeScript does not attempt
54
- * compile-time resolution of this optional peer dependency.
55
- */
56
- const RUVBOT_MODULE = 'ruvbot';
57
- const RUVBOT_CORE_MODULE = 'ruvbot/core';
58
- /**
59
- * Attempt to dynamically import the ruvbot package.
60
- * Throws a descriptive error if the package is not installed.
61
- */
62
- async function requireRuvBot() {
63
- if (ruvbotModuleCache)
64
- return ruvbotModuleCache;
65
- try {
66
- const mod = await import(RUVBOT_MODULE);
67
- ruvbotModuleCache = mod;
68
- return mod;
69
- }
70
- catch {
71
- throw new Error('ruvbot is not installed. Install it with: npm install ruvbot@0.1.8\n' +
72
- 'ruvbot is an optional peer dependency of @claude-flow/guidance.');
73
- }
74
- }
75
- /**
76
- * Attempt to dynamically import ruvbot/core sub-export.
77
- */
78
- async function requireRuvBotCore() {
79
- try {
80
- return await import(RUVBOT_CORE_MODULE);
81
- }
82
- catch {
83
- // Fall back to the main export
84
- return requireRuvBot();
85
- }
86
- }
87
- // ============================================================================
88
- // AIDefenceGate
89
- // ============================================================================
90
- /**
91
- * Wraps ruvbot's 6-layer AIDefence as an enforcement gate compatible with the
92
- * guidance control plane's GateResult / GateDecision interface.
93
- *
94
- * Supports:
95
- * - Prompt injection detection
96
- * - Jailbreak detection
97
- * - PII detection
98
- * - Control character and homoglyph detection (via ruvbot internals)
99
- * - Configurable sensitivity / block threshold
100
- *
101
- * Evaluates both input (pre-processing) and output (post-processing) text.
102
- */
103
- export class AIDefenceGate {
104
- config;
105
- guard = null;
106
- guardInitPromise = null;
107
- constructor(config = {}) {
108
- this.config = {
109
- detectPromptInjection: config.detectPromptInjection ?? true,
110
- detectJailbreak: config.detectJailbreak ?? true,
111
- detectPII: config.detectPII ?? true,
112
- blockThreshold: config.blockThreshold ?? 'medium',
113
- };
114
- }
115
- /**
116
- * Lazily initialize the underlying ruvbot AIDefence guard.
117
- * Safe to call multiple times; only the first call creates the guard.
118
- */
119
- async ensureGuard() {
120
- if (this.guard)
121
- return this.guard;
122
- if (!this.guardInitPromise) {
123
- this.guardInitPromise = (async () => {
124
- const mod = await requireRuvBot();
125
- const createGuard = mod['createAIDefenceGuard'];
126
- if (typeof createGuard !== 'function') {
127
- throw new Error('ruvbot does not export createAIDefenceGuard. ' +
128
- 'Ensure ruvbot@0.1.8 or later is installed.');
129
- }
130
- this.guard = createGuard({
131
- detectPromptInjection: this.config.detectPromptInjection,
132
- detectJailbreak: this.config.detectJailbreak,
133
- detectPII: this.config.detectPII,
134
- });
135
- })();
136
- }
137
- await this.guardInitPromise;
138
- return this.guard;
139
- }
140
- /**
141
- * Evaluate input text for threats (pre-processing gate).
142
- *
143
- * Checks for prompt injection, jailbreak attempts, and PII based
144
- * on the configured sensitivity.
145
- */
146
- async evaluateInput(input) {
147
- const start = performance.now();
148
- const guard = await this.ensureGuard();
149
- const raw = await guard.check(input);
150
- const latencyMs = performance.now() - start;
151
- const threats = this.normalizeThreats(raw.threats);
152
- return {
153
- safe: raw.safe,
154
- threats,
155
- sanitizedInput: raw.sanitizedInput,
156
- latencyMs,
157
- };
158
- }
159
- /**
160
- * Evaluate output text for threats (post-processing gate).
161
- *
162
- * Primarily checks for PII leakage and secret exposure in responses.
163
- */
164
- async evaluateOutput(output) {
165
- const start = performance.now();
166
- const guard = await this.ensureGuard();
167
- const raw = await guard.check(output);
168
- const latencyMs = performance.now() - start;
169
- // For output evaluation, focus on PII / data leakage threats
170
- const threats = this.normalizeThreats(raw.threats).filter(t => t.type === 'pii' || t.type === 'control-chars');
171
- return {
172
- safe: threats.length === 0,
173
- threats,
174
- sanitizedInput: raw.sanitizedInput,
175
- latencyMs,
176
- };
177
- }
178
- /**
179
- * Convert an AIDefenceResult into a GateResult compatible with the
180
- * guidance enforcement pipeline.
181
- *
182
- * Decision logic:
183
- * - If no threats: 'allow'
184
- * - If threats above block threshold: 'block'
185
- * - Otherwise: 'warn'
186
- */
187
- toGateResult(result, context) {
188
- if (result.safe && result.threats.length === 0) {
189
- return {
190
- decision: 'allow',
191
- gateName: 'ai-defence',
192
- reason: 'AIDefence check passed with no threats detected.',
193
- triggeredRules: [],
194
- metadata: { latencyMs: result.latencyMs },
195
- };
196
- }
197
- const blockingSeverities = BLOCK_SEVERITY_THRESHOLDS[this.config.blockThreshold];
198
- const blockingThreats = result.threats.filter(t => blockingSeverities.has(t.severity));
199
- const decision = blockingThreats.length > 0 ? 'block' : 'warn';
200
- const threatSummary = result.threats
201
- .map(t => `${t.type} (${t.severity}): ${t.detail}`)
202
- .join('; ');
203
- return {
204
- decision,
205
- gateName: 'ai-defence',
206
- reason: `AIDefence detected ${result.threats.length} threat(s): ${threatSummary}`,
207
- triggeredRules: [],
208
- remediation: this.buildRemediation(result.threats),
209
- metadata: {
210
- threats: result.threats,
211
- blockThreshold: this.config.blockThreshold,
212
- latencyMs: result.latencyMs,
213
- context,
214
- },
215
- };
216
- }
217
- /**
218
- * Get the current configuration.
219
- */
220
- getConfig() {
221
- return { ...this.config };
222
- }
223
- /**
224
- * Update configuration. Resets the guard so the next evaluation
225
- * re-initializes with the new settings.
226
- */
227
- updateConfig(config) {
228
- this.config = { ...this.config, ...config };
229
- this.guard = null;
230
- this.guardInitPromise = null;
231
- }
232
- // ===== Private Helpers =====
233
- normalizeThreats(raw) {
234
- return raw.map(t => ({
235
- type: THREAT_TYPE_MAP[t.type] ?? 'prompt-injection',
236
- severity: SEVERITY_MAP[t.severity] ?? 'medium',
237
- detail: t.detail,
238
- }));
239
- }
240
- buildRemediation(threats) {
241
- const parts = [];
242
- const hasInjection = threats.some(t => t.type === 'prompt-injection');
243
- const hasJailbreak = threats.some(t => t.type === 'jailbreak');
244
- const hasPII = threats.some(t => t.type === 'pii');
245
- if (hasInjection) {
246
- parts.push('1. Review input for prompt injection patterns and remove adversarial content.');
247
- }
248
- if (hasJailbreak) {
249
- parts.push('2. Input contains jailbreak attempt. Reject and log the attempt.');
250
- }
251
- if (hasPII) {
252
- parts.push('3. Redact or mask personally identifiable information before processing.');
253
- }
254
- if (parts.length === 0) {
255
- parts.push('Review flagged content and apply appropriate sanitization.');
256
- }
257
- return parts.join('\n');
258
- }
259
- }
260
- // ============================================================================
261
- // RuvBotMemoryAdapter
262
- // ============================================================================
263
- /**
264
- * Wraps ruvbot's memory read/write operations with guidance control plane
265
- * governance. Every write passes through the MemoryWriteGate for authority
266
- * and coherence checks. All operations are logged to a proof chain.
267
- */
268
- export class RuvBotMemoryAdapter {
269
- memoryGate;
270
- coherenceScheduler;
271
- proofChain = null;
272
- ruvbotMemory = null;
273
- operationLog = [];
274
- constructor(memoryGate, coherenceScheduler) {
275
- this.memoryGate = memoryGate;
276
- this.coherenceScheduler = coherenceScheduler;
277
- }
278
- /**
279
- * Attach a ruvbot memory instance for proxied operations.
280
- */
281
- attachMemory(memory) {
282
- this.ruvbotMemory = memory;
283
- }
284
- /**
285
- * Attach a proof chain for operation logging.
286
- */
287
- attachProofChain(proofChain) {
288
- this.proofChain = proofChain;
289
- }
290
- /**
291
- * Governed read: reads through ruvbot memory, logs to proof chain.
292
- */
293
- async read(key, namespace = 'default') {
294
- this.ensureMemoryAttached();
295
- const value = await this.ruvbotMemory.read(key, namespace);
296
- this.operationLog.push({
297
- operation: 'read',
298
- key,
299
- namespace,
300
- timestamp: Date.now(),
301
- });
302
- return value;
303
- }
304
- /**
305
- * Governed write: runs through MemoryWriteGate, checks coherence,
306
- * logs to proof chain, then delegates to ruvbot memory.
307
- *
308
- * Returns the WriteDecision. If denied, the write is not performed.
309
- */
310
- async write(key, namespace, value, authority, existingEntries) {
311
- this.ensureMemoryAttached();
312
- // Step 1: Evaluate through MemoryWriteGate
313
- const decision = this.memoryGate.evaluateWrite(authority, key, namespace, value, existingEntries);
314
- // Step 2: Log the operation
315
- this.operationLog.push({
316
- operation: 'write',
317
- key,
318
- namespace,
319
- timestamp: Date.now(),
320
- decision,
321
- });
322
- // Step 3: If denied, do not write
323
- if (!decision.allowed) {
324
- return decision;
325
- }
326
- // Step 4: Perform the write through ruvbot
327
- await this.ruvbotMemory.write(key, value, namespace);
328
- return decision;
329
- }
330
- /**
331
- * Governed delete: checks authority, logs, then delegates.
332
- */
333
- async delete(key, namespace, authority) {
334
- this.ensureMemoryAttached();
335
- // Authority must have delete permission
336
- if (!authority.canDelete) {
337
- const result = {
338
- allowed: false,
339
- reason: `Agent "${authority.agentId}" does not have delete permission.`,
340
- };
341
- this.operationLog.push({
342
- operation: 'delete',
343
- key,
344
- namespace,
345
- timestamp: Date.now(),
346
- });
347
- return result;
348
- }
349
- // Perform the delete if the underlying memory supports it
350
- if (typeof this.ruvbotMemory.delete === 'function') {
351
- await this.ruvbotMemory.delete(key, namespace);
352
- }
353
- this.operationLog.push({
354
- operation: 'delete',
355
- key,
356
- namespace,
357
- timestamp: Date.now(),
358
- });
359
- return { allowed: true, reason: 'Delete permitted and executed.' };
360
- }
361
- /**
362
- * Get the operation log for audit/proof purposes.
363
- */
364
- getOperationLog() {
365
- return this.operationLog;
366
- }
367
- /**
368
- * Get the count of governed operations.
369
- */
370
- get operationCount() {
371
- return this.operationLog.length;
372
- }
373
- /**
374
- * Clear the operation log.
375
- */
376
- clearLog() {
377
- this.operationLog = [];
378
- }
379
- // ===== Private Helpers =====
380
- ensureMemoryAttached() {
381
- if (!this.ruvbotMemory) {
382
- throw new Error('No ruvbot memory instance attached. Call attachMemory() before ' +
383
- 'performing memory operations.');
384
- }
385
- }
386
- }
387
- // ============================================================================
388
- // RuvBotGuidanceBridge
389
- // ============================================================================
390
- /**
391
- * Bridges a ruvbot instance with the @claude-flow/guidance control plane.
392
- *
393
- * Wires ruvbot event hooks to guidance enforcement and trust systems:
394
- *
395
- * - `message` -> EnforcementGates (secrets, destructive ops) + AIDefence
396
- * - `agent:spawn` -> ManifestValidator
397
- * - `session:create` -> ProofChain initialization
398
- * - `session:end` -> ProofChain finalization and ledger persistence
399
- * - `ready` -> Trust accumulator initialization
400
- * - `error` -> Trust 'deny' outcome recording
401
- *
402
- * All gate outcomes are fed into the TrustAccumulator so that ruvbot agents
403
- * build (or lose) trust over time.
404
- */
405
- export class RuvBotGuidanceBridge {
406
- config;
407
- ruvbot = null;
408
- // Guidance components (injected)
409
- gates = null;
410
- manifestValidator = null;
411
- trustSystem = null;
412
- aiDefenceGate = null;
413
- memoryAdapter = null;
414
- // Session proof chains keyed by sessionId
415
- sessionChains = new Map();
416
- // Bound event handlers for cleanup
417
- boundHandlers = new Map();
418
- // Event log for diagnostics
419
- eventLog = [];
420
- static MAX_EVENT_LOG = 1000;
421
- constructor(config = {}) {
422
- this.config = {
423
- enableAIDefence: config.enableAIDefence ?? true,
424
- enableMemoryGovernance: config.enableMemoryGovernance ?? true,
425
- enableTrustTracking: config.enableTrustTracking ?? true,
426
- enableProofChain: config.enableProofChain ?? true,
427
- };
428
- }
429
- /**
430
- * Attach guidance control plane components.
431
- *
432
- * Accepts either a full GuidanceControlPlane instance (from which
433
- * sub-components are extracted) or individual components.
434
- */
435
- attachGuidance(components) {
436
- if (components.gates)
437
- this.gates = components.gates;
438
- if (components.manifestValidator)
439
- this.manifestValidator = components.manifestValidator;
440
- if (components.trustSystem)
441
- this.trustSystem = components.trustSystem;
442
- if (components.aiDefenceGate)
443
- this.aiDefenceGate = components.aiDefenceGate;
444
- if (components.memoryAdapter)
445
- this.memoryAdapter = components.memoryAdapter;
446
- }
447
- /**
448
- * Connect to a ruvbot instance and wire all event handlers.
449
- *
450
- * This is the primary entry point. Once called, the bridge will
451
- * intercept ruvbot events and route them through guidance gates.
452
- */
453
- connect(ruvbot) {
454
- if (this.ruvbot) {
455
- this.disconnect();
456
- }
457
- this.ruvbot = ruvbot;
458
- // Wire event handlers
459
- this.wireEvent('message', this.handleMessage.bind(this));
460
- this.wireEvent('agent:spawn', this.handleAgentSpawn.bind(this));
461
- this.wireEvent('session:create', this.handleSessionCreate.bind(this));
462
- this.wireEvent('session:end', this.handleSessionEnd.bind(this));
463
- this.wireEvent('ready', this.handleReady.bind(this));
464
- this.wireEvent('shutdown', this.handleShutdown.bind(this));
465
- this.wireEvent('error', this.handleError.bind(this));
466
- this.wireEvent('agent:stop', this.handleAgentStop.bind(this));
467
- }
468
- /**
469
- * Disconnect from the ruvbot instance, removing all event handlers.
470
- */
471
- disconnect() {
472
- if (!this.ruvbot)
473
- return;
474
- for (const [event, handler] of this.boundHandlers) {
475
- this.ruvbot.off(event, handler);
476
- }
477
- this.boundHandlers.clear();
478
- this.ruvbot = null;
479
- }
480
- /**
481
- * Evaluate a ruvbot AIDefence result and return a GateResult-compatible
482
- * decision. Can be called independently of event wiring.
483
- */
484
- async evaluateAIDefence(input) {
485
- if (!this.aiDefenceGate) {
486
- throw new Error('AIDefenceGate not attached. Call attachGuidance({ aiDefenceGate }) first.');
487
- }
488
- const result = await this.aiDefenceGate.evaluateInput(input);
489
- return this.aiDefenceGate.toGateResult(result, 'manual-evaluation');
490
- }
491
- /**
492
- * Get the proof chain for a specific session.
493
- */
494
- getSessionProofChain(sessionId) {
495
- return this.sessionChains.get(sessionId);
496
- }
497
- /**
498
- * Get all active session IDs.
499
- */
500
- getActiveSessionIds() {
501
- return [...this.sessionChains.keys()];
502
- }
503
- /**
504
- * Get the event log for diagnostics.
505
- */
506
- getEventLog() {
507
- return this.eventLog;
508
- }
509
- /**
510
- * Get the current bridge configuration.
511
- */
512
- getConfig() {
513
- return { ...this.config };
514
- }
515
- /**
516
- * Whether the bridge is currently connected to a ruvbot instance.
517
- */
518
- get connected() {
519
- return this.ruvbot !== null;
520
- }
521
- // ===== Event Handlers =====
522
- /**
523
- * Handle `message` events: run content through enforcement gates
524
- * and optionally through AIDefence.
525
- */
526
- async handleMessage(...args) {
527
- const data = (args[0] ?? {});
528
- const content = String(data['content'] ?? data['text'] ?? '');
529
- const sessionId = String(data['sessionId'] ?? 'unknown');
530
- const agentId = String(data['agentId'] ?? 'unknown');
531
- this.logEvent('message', { sessionId, agentId, contentLength: content.length });
532
- const gateResults = [];
533
- // Step 1: Run through EnforcementGates (secrets, destructive ops)
534
- if (this.gates) {
535
- const commandResults = this.gates.evaluateCommand(content);
536
- gateResults.push(...commandResults);
537
- }
538
- // Step 2: Run through AIDefence gate
539
- if (this.config.enableAIDefence && this.aiDefenceGate) {
540
- try {
541
- const defenceResult = await this.aiDefenceGate.evaluateInput(content);
542
- const gateResult = this.aiDefenceGate.toGateResult(defenceResult, `message:${sessionId}`);
543
- if (gateResult.decision !== 'allow') {
544
- gateResults.push(gateResult);
545
- }
546
- }
547
- catch {
548
- // AIDefence unavailable; log but do not block
549
- }
550
- }
551
- // Step 3: Feed outcomes into trust accumulator
552
- if (this.config.enableTrustTracking && this.trustSystem) {
553
- if (gateResults.length === 0) {
554
- this.trustSystem.recordOutcome(agentId, 'allow', `Message passed all gates (session: ${sessionId})`);
555
- }
556
- else {
557
- for (const result of gateResults) {
558
- const outcome = gateDecisionToTrustOutcome(result.decision);
559
- this.trustSystem.recordOutcome(agentId, outcome, `Gate "${result.gateName}" ${result.decision}: ${result.reason}`);
560
- }
561
- }
562
- }
563
- }
564
- /**
565
- * Handle `agent:spawn` events: validate agent manifest.
566
- */
567
- async handleAgentSpawn(...args) {
568
- const data = (args[0] ?? {});
569
- const agentId = String(data['agentId'] ?? data['id'] ?? 'unknown');
570
- const manifest = data['manifest'];
571
- this.logEvent('agent:spawn', { agentId, hasManifest: !!manifest });
572
- if (this.manifestValidator && manifest) {
573
- const validation = this.manifestValidator.validate(manifest);
574
- if (this.config.enableTrustTracking && this.trustSystem) {
575
- if (validation.admissionDecision === 'admit') {
576
- this.trustSystem.recordOutcome(agentId, 'allow', `Agent manifest validated: admission=${validation.admissionDecision}, risk=${validation.riskScore}`);
577
- }
578
- else {
579
- const outcome = validation.admissionDecision === 'reject' ? 'deny' : 'warn';
580
- this.trustSystem.recordOutcome(agentId, outcome, `Agent manifest ${validation.admissionDecision}: risk=${validation.riskScore}, errors=${validation.errors.length}`);
581
- }
582
- }
583
- }
584
- }
585
- /**
586
- * Handle `session:create` events: initialize a proof chain for the session.
587
- */
588
- async handleSessionCreate(...args) {
589
- const data = (args[0] ?? {});
590
- const sessionId = String(data['sessionId'] ?? data['id'] ?? `session-${Date.now()}`);
591
- this.logEvent('session:create', { sessionId });
592
- if (this.config.enableProofChain) {
593
- if (!this.config.proofSigningKey) {
594
- throw new Error('RuvBotBridgeConfig.proofSigningKey is required when enableProofChain is true');
595
- }
596
- const { createProofChain } = await import('./proof.js');
597
- const chain = createProofChain({ signingKey: this.config.proofSigningKey });
598
- this.sessionChains.set(sessionId, chain);
599
- }
600
- }
601
- /**
602
- * Handle `session:end` events: finalize the proof chain and persist.
603
- */
604
- async handleSessionEnd(...args) {
605
- const data = (args[0] ?? {});
606
- const sessionId = String(data['sessionId'] ?? data['id'] ?? 'unknown');
607
- this.logEvent('session:end', { sessionId });
608
- if (this.config.enableProofChain) {
609
- const chain = this.sessionChains.get(sessionId);
610
- if (chain) {
611
- // Export the finalized chain for external persistence
612
- const _exported = chain.export();
613
- // The caller can retrieve this via getSessionProofChain() before
614
- // the session is cleaned up, or listen for an event.
615
- // Clean up
616
- this.sessionChains.delete(sessionId);
617
- }
618
- }
619
- }
620
- /**
621
- * Handle `ready` events: log bridge activation.
622
- */
623
- async handleReady(...args) {
624
- this.logEvent('ready', {});
625
- }
626
- /**
627
- * Handle `shutdown` events: clean up all session proof chains.
628
- */
629
- async handleShutdown(...args) {
630
- this.logEvent('shutdown', {});
631
- this.sessionChains.clear();
632
- }
633
- /**
634
- * Handle `error` events: record a deny outcome in trust tracking.
635
- */
636
- async handleError(...args) {
637
- const data = (args[0] ?? {});
638
- const agentId = String(data['agentId'] ?? 'unknown');
639
- const errorMessage = String(data['message'] ?? data['error'] ?? 'unknown error');
640
- this.logEvent('error', { agentId, error: errorMessage });
641
- if (this.config.enableTrustTracking && this.trustSystem) {
642
- this.trustSystem.recordOutcome(agentId, 'deny', `Error event: ${errorMessage}`);
643
- }
644
- }
645
- /**
646
- * Handle `agent:stop` events: record final trust snapshot.
647
- */
648
- async handleAgentStop(...args) {
649
- const data = (args[0] ?? {});
650
- const agentId = String(data['agentId'] ?? data['id'] ?? 'unknown');
651
- this.logEvent('agent:stop', { agentId });
652
- }
653
- // ===== Private Helpers =====
654
- wireEvent(event, handler) {
655
- this.boundHandlers.set(event, handler);
656
- this.ruvbot.on(event, handler);
657
- }
658
- logEvent(type, data) {
659
- const event = {
660
- type,
661
- timestamp: Date.now(),
662
- sessionId: data['sessionId'],
663
- agentId: data['agentId'],
664
- data,
665
- };
666
- this.eventLog.push(event);
667
- if (this.eventLog.length > RuvBotGuidanceBridge.MAX_EVENT_LOG) {
668
- this.eventLog = this.eventLog.slice(-RuvBotGuidanceBridge.MAX_EVENT_LOG);
669
- }
670
- }
671
- }
672
- // ============================================================================
673
- // Helper Functions
674
- // ============================================================================
675
- /**
676
- * Map a GateDecision to a GateOutcome for trust accumulation.
677
- *
678
- * - 'allow' -> 'allow'
679
- * - 'block' -> 'deny'
680
- * - 'require-confirmation' -> 'warn'
681
- * - 'warn' -> 'warn'
682
- */
683
- function gateDecisionToTrustOutcome(decision) {
684
- switch (decision) {
685
- case 'allow': return 'allow';
686
- case 'block': return 'deny';
687
- case 'warn': return 'warn';
688
- case 'require-confirmation': return 'warn';
689
- default: return 'warn';
690
- }
691
- }
692
- // ============================================================================
693
- // Factory Functions
694
- // ============================================================================
695
- /**
696
- * Create a fully wired RuvBotGuidanceBridge.
697
- *
698
- * Connects the bridge to a ruvbot instance and attaches the guidance
699
- * control plane components. The bridge immediately begins intercepting
700
- * ruvbot events.
701
- *
702
- * @param ruvbotInstance - A ruvbot instance (from createRuvBot())
703
- * @param guidancePlane - A GuidanceControlPlane or individual components
704
- * @param config - Optional bridge configuration
705
- * @returns The connected RuvBotGuidanceBridge
706
- */
707
- export function createRuvBotBridge(ruvbotInstance, guidancePlane, config) {
708
- const bridge = new RuvBotGuidanceBridge(config);
709
- bridge.attachGuidance(guidancePlane);
710
- bridge.connect(ruvbotInstance);
711
- return bridge;
712
- }
713
- /**
714
- * Create an AIDefenceGate with optional configuration.
715
- *
716
- * The gate lazily initializes the underlying ruvbot AIDefence guard
717
- * on the first evaluation call.
718
- *
719
- * @param config - Optional gate configuration
720
- * @returns A new AIDefenceGate instance
721
- */
722
- export function createAIDefenceGate(config) {
723
- return new AIDefenceGate(config);
724
- }
725
- /**
726
- * Create a RuvBotMemoryAdapter with governance components.
727
- *
728
- * The adapter wraps ruvbot memory operations with MemoryWriteGate authority
729
- * checks and CoherenceScheduler tracking.
730
- *
731
- * @param memoryGate - The MemoryWriteGate for authority/rate/contradiction checks
732
- * @param coherenceScheduler - The CoherenceScheduler for drift tracking
733
- * @returns A new RuvBotMemoryAdapter instance
734
- */
735
- export function createRuvBotMemoryAdapter(memoryGate, coherenceScheduler) {
736
- return new RuvBotMemoryAdapter(memoryGate, coherenceScheduler);
737
- }
738
- //# sourceMappingURL=ruvbot-integration.js.map