moflo 4.8.16 → 4.8.19

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 (468) hide show
  1. package/.claude/agents/browser/browser-agent.yaml +182 -182
  2. package/.claude/agents/core/coder.md +265 -265
  3. package/.claude/agents/core/planner.md +167 -167
  4. package/.claude/agents/core/researcher.md +189 -189
  5. package/.claude/agents/core/reviewer.md +325 -325
  6. package/.claude/agents/core/tester.md +318 -318
  7. package/.claude/agents/database-specialist.yaml +21 -21
  8. package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
  9. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  10. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  11. package/.claude/agents/github/code-review-swarm.md +537 -537
  12. package/.claude/agents/github/github-modes.md +172 -172
  13. package/.claude/agents/github/issue-tracker.md +318 -318
  14. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  15. package/.claude/agents/github/pr-manager.md +190 -190
  16. package/.claude/agents/github/project-board-sync.md +508 -508
  17. package/.claude/agents/github/release-manager.md +366 -366
  18. package/.claude/agents/github/release-swarm.md +582 -582
  19. package/.claude/agents/github/repo-architect.md +397 -397
  20. package/.claude/agents/github/swarm-issue.md +572 -572
  21. package/.claude/agents/github/swarm-pr.md +427 -427
  22. package/.claude/agents/github/sync-coordinator.md +451 -451
  23. package/.claude/agents/github/workflow-automation.md +634 -634
  24. package/.claude/agents/goal/code-goal-planner.md +445 -445
  25. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  26. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  27. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  28. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  29. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  30. package/.claude/agents/index.yaml +17 -17
  31. package/.claude/agents/neural/safla-neural.md +73 -73
  32. package/.claude/agents/project-coordinator.yaml +15 -15
  33. package/.claude/agents/python-specialist.yaml +21 -21
  34. package/.claude/agents/reasoning/goal-planner.md +72 -72
  35. package/.claude/agents/security-auditor.yaml +20 -20
  36. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  37. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  38. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  39. package/.claude/agents/templates/migration-plan.md +745 -745
  40. package/.claude/agents/typescript-specialist.yaml +21 -21
  41. package/.claude/checkpoints/1767754460.json +8 -8
  42. package/.claude/commands/agents/agent-spawning.md +28 -28
  43. package/.claude/commands/github/github-modes.md +146 -146
  44. package/.claude/commands/github/github-swarm.md +121 -121
  45. package/.claude/commands/github/issue-tracker.md +291 -291
  46. package/.claude/commands/github/pr-manager.md +169 -169
  47. package/.claude/commands/github/release-manager.md +337 -337
  48. package/.claude/commands/github/repo-architect.md +366 -366
  49. package/.claude/commands/github/sync-coordinator.md +300 -300
  50. package/.claude/commands/memory/neural.md +47 -47
  51. package/.claude/commands/sparc/analyzer.md +51 -51
  52. package/.claude/commands/sparc/architect.md +53 -53
  53. package/.claude/commands/sparc/ask.md +97 -97
  54. package/.claude/commands/sparc/batch-executor.md +54 -54
  55. package/.claude/commands/sparc/code.md +89 -89
  56. package/.claude/commands/sparc/coder.md +54 -54
  57. package/.claude/commands/sparc/debug.md +83 -83
  58. package/.claude/commands/sparc/debugger.md +54 -54
  59. package/.claude/commands/sparc/designer.md +53 -53
  60. package/.claude/commands/sparc/devops.md +109 -109
  61. package/.claude/commands/sparc/docs-writer.md +80 -80
  62. package/.claude/commands/sparc/documenter.md +54 -54
  63. package/.claude/commands/sparc/innovator.md +54 -54
  64. package/.claude/commands/sparc/integration.md +83 -83
  65. package/.claude/commands/sparc/mcp.md +117 -117
  66. package/.claude/commands/sparc/memory-manager.md +54 -54
  67. package/.claude/commands/sparc/optimizer.md +54 -54
  68. package/.claude/commands/sparc/orchestrator.md +131 -131
  69. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  70. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  71. package/.claude/commands/sparc/researcher.md +54 -54
  72. package/.claude/commands/sparc/reviewer.md +54 -54
  73. package/.claude/commands/sparc/security-review.md +80 -80
  74. package/.claude/commands/sparc/sparc-modes.md +174 -174
  75. package/.claude/commands/sparc/sparc.md +111 -111
  76. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  77. package/.claude/commands/sparc/supabase-admin.md +348 -348
  78. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  79. package/.claude/commands/sparc/tdd.md +54 -54
  80. package/.claude/commands/sparc/tester.md +54 -54
  81. package/.claude/commands/sparc/tutorial.md +79 -79
  82. package/.claude/commands/sparc/workflow-manager.md +54 -54
  83. package/.claude/commands/sparc.md +166 -166
  84. package/.claude/commands/swarm/analysis.md +95 -95
  85. package/.claude/commands/swarm/development.md +96 -96
  86. package/.claude/commands/swarm/examples.md +168 -168
  87. package/.claude/commands/swarm/maintenance.md +102 -102
  88. package/.claude/commands/swarm/optimization.md +117 -117
  89. package/.claude/commands/swarm/research.md +136 -136
  90. package/.claude/commands/swarm/testing.md +131 -131
  91. package/.claude/commands/workflows/development.md +77 -77
  92. package/.claude/commands/workflows/research.md +62 -62
  93. package/.claude/guidance/moflo-bootstrap.md +126 -126
  94. package/.claude/guidance/shipped/agent-bootstrap.md +126 -126
  95. package/.claude/guidance/shipped/guidance-memory-strategy.md +262 -262
  96. package/.claude/guidance/shipped/memory-strategy.md +204 -204
  97. package/.claude/guidance/shipped/moflo.md +608 -608
  98. package/.claude/guidance/shipped/task-swarm-integration.md +441 -441
  99. package/.claude/helpers/intelligence.cjs +207 -207
  100. package/.claude/helpers/statusline.cjs +851 -851
  101. package/.claude/skills/fl/SKILL.md +583 -583
  102. package/.claude/skills/flo/SKILL.md +583 -583
  103. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  104. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  105. package/.claude/skills/github-project-management/SKILL.md +1277 -1277
  106. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  107. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  108. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  109. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  110. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  111. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  112. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  113. package/LICENSE +21 -21
  114. package/README.md +685 -685
  115. package/bin/cli.js +0 -0
  116. package/bin/gate-hook.mjs +50 -50
  117. package/bin/gate.cjs +138 -138
  118. package/bin/generate-code-map.mjs +91 -12
  119. package/bin/hook-handler.cjs +83 -83
  120. package/bin/hooks.mjs +656 -656
  121. package/bin/index-guidance.mjs +892 -892
  122. package/bin/index-tests.mjs +709 -709
  123. package/bin/lib/process-manager.mjs +243 -243
  124. package/bin/lib/registry-cleanup.cjs +41 -41
  125. package/bin/prompt-hook.mjs +72 -72
  126. package/bin/semantic-search.mjs +472 -472
  127. package/bin/session-start-launcher.mjs +238 -226
  128. package/bin/setup-project.mjs +250 -250
  129. package/package.json +123 -121
  130. package/src/@claude-flow/cli/README.md +452 -452
  131. package/src/@claude-flow/cli/bin/cli.js +180 -175
  132. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  133. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  134. package/src/@claude-flow/cli/dist/src/commands/doctor.js +1091 -1091
  135. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  136. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  137. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  138. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  139. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  140. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  141. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +91 -91
  142. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  143. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -43
  144. package/src/@claude-flow/cli/dist/src/init/executor.js +485 -453
  145. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  146. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  147. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +848 -839
  148. package/src/@claude-flow/cli/dist/src/init/settings-generator.js +6 -2
  149. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +786 -786
  150. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  151. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  152. package/src/@claude-flow/cli/dist/src/services/agentic-flow-bridge.js +6 -0
  153. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  154. package/src/@claude-flow/cli/package.json +1 -1
  155. package/src/@claude-flow/guidance/README.md +1195 -1195
  156. package/src/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  157. package/src/@claude-flow/guidance/dist/adversarial.js +572 -0
  158. package/src/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  159. package/src/@claude-flow/guidance/dist/analyzer.js +2518 -0
  160. package/src/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  161. package/src/@claude-flow/guidance/dist/artifacts.js +356 -0
  162. package/src/@claude-flow/guidance/dist/authority.d.ts +290 -0
  163. package/src/@claude-flow/guidance/dist/authority.js +558 -0
  164. package/src/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  165. package/src/@claude-flow/guidance/dist/capabilities.js +485 -0
  166. package/src/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  167. package/src/@claude-flow/guidance/dist/coherence.js +372 -0
  168. package/src/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  169. package/src/@claude-flow/guidance/dist/compiler.js +419 -0
  170. package/src/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  171. package/src/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  172. package/src/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  173. package/src/@claude-flow/guidance/dist/continue-gate.js +353 -0
  174. package/src/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  175. package/src/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  176. package/src/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  177. package/src/@claude-flow/guidance/dist/evolution.js +500 -0
  178. package/src/@claude-flow/guidance/dist/gates.d.ts +79 -0
  179. package/src/@claude-flow/guidance/dist/gates.js +302 -0
  180. package/src/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  181. package/src/@claude-flow/guidance/dist/gateway.js +452 -0
  182. package/src/@claude-flow/guidance/dist/generators.d.ts +153 -0
  183. package/src/@claude-flow/guidance/dist/generators.js +682 -0
  184. package/src/@claude-flow/guidance/dist/headless.d.ts +177 -0
  185. package/src/@claude-flow/guidance/dist/headless.js +342 -0
  186. package/src/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  187. package/src/@claude-flow/guidance/dist/hooks.js +347 -0
  188. package/src/@claude-flow/guidance/dist/index.d.ts +205 -0
  189. package/src/@claude-flow/guidance/dist/index.js +321 -0
  190. package/src/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  191. package/src/@claude-flow/guidance/dist/ledger.js +375 -0
  192. package/src/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  193. package/src/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  194. package/src/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  195. package/src/@claude-flow/guidance/dist/memory-gate.js +382 -0
  196. package/src/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  197. package/src/@claude-flow/guidance/dist/meta-governance.js +348 -0
  198. package/src/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  199. package/src/@claude-flow/guidance/dist/optimizer.js +329 -0
  200. package/src/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  201. package/src/@claude-flow/guidance/dist/persistence.js +464 -0
  202. package/src/@claude-flow/guidance/dist/proof.d.ts +185 -0
  203. package/src/@claude-flow/guidance/dist/proof.js +238 -0
  204. package/src/@claude-flow/guidance/dist/retriever.d.ts +116 -0
  205. package/src/@claude-flow/guidance/dist/retriever.js +394 -0
  206. package/src/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  207. package/src/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  208. package/src/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  209. package/src/@claude-flow/guidance/dist/temporal.js +658 -0
  210. package/src/@claude-flow/guidance/dist/trust.d.ts +283 -0
  211. package/src/@claude-flow/guidance/dist/trust.js +473 -0
  212. package/src/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  213. package/src/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  214. package/src/@claude-flow/guidance/dist/types.d.ts +378 -0
  215. package/src/@claude-flow/guidance/dist/types.js +10 -0
  216. package/src/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  217. package/src/@claude-flow/guidance/dist/uncertainty.js +619 -0
  218. package/src/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  219. package/src/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  220. package/src/@claude-flow/guidance/package.json +198 -198
  221. package/src/@claude-flow/memory/README.md +587 -587
  222. package/src/@claude-flow/memory/package.json +44 -44
  223. package/src/@claude-flow/shared/README.md +323 -323
  224. package/src/README.md +493 -493
  225. package/.claude/settings.local.json +0 -18
  226. package/.claude/workflow-state.json +0 -9
  227. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +0 -197
  228. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +0 -584
  229. package/src/@claude-flow/memory/dist/agent-memory-scope.d.ts +0 -131
  230. package/src/@claude-flow/memory/dist/agent-memory-scope.js +0 -223
  231. package/src/@claude-flow/memory/dist/agent-memory-scope.test.d.ts +0 -8
  232. package/src/@claude-flow/memory/dist/agent-memory-scope.test.js +0 -463
  233. package/src/@claude-flow/memory/dist/agentdb-adapter.d.ts +0 -165
  234. package/src/@claude-flow/memory/dist/agentdb-adapter.js +0 -806
  235. package/src/@claude-flow/memory/dist/agentdb-backend.d.ts +0 -214
  236. package/src/@claude-flow/memory/dist/agentdb-backend.js +0 -844
  237. package/src/@claude-flow/memory/dist/agentdb-backend.test.d.ts +0 -7
  238. package/src/@claude-flow/memory/dist/agentdb-backend.test.js +0 -258
  239. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.d.ts +0 -65
  240. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.js +0 -129
  241. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.d.ts +0 -48
  242. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.js +0 -72
  243. package/src/@claude-flow/memory/dist/application/index.d.ts +0 -12
  244. package/src/@claude-flow/memory/dist/application/index.js +0 -15
  245. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.d.ts +0 -72
  246. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.js +0 -143
  247. package/src/@claude-flow/memory/dist/application/services/memory-application-service.d.ts +0 -121
  248. package/src/@claude-flow/memory/dist/application/services/memory-application-service.js +0 -190
  249. package/src/@claude-flow/memory/dist/auto-memory-bridge.d.ts +0 -226
  250. package/src/@claude-flow/memory/dist/auto-memory-bridge.js +0 -709
  251. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.d.ts +0 -8
  252. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +0 -754
  253. package/src/@claude-flow/memory/dist/benchmark.test.d.ts +0 -2
  254. package/src/@claude-flow/memory/dist/benchmark.test.js +0 -277
  255. package/src/@claude-flow/memory/dist/cache-manager.d.ts +0 -134
  256. package/src/@claude-flow/memory/dist/cache-manager.js +0 -407
  257. package/src/@claude-flow/memory/dist/controller-registry.d.ts +0 -216
  258. package/src/@claude-flow/memory/dist/controller-registry.js +0 -893
  259. package/src/@claude-flow/memory/dist/controller-registry.test.d.ts +0 -14
  260. package/src/@claude-flow/memory/dist/controller-registry.test.js +0 -636
  261. package/src/@claude-flow/memory/dist/database-provider.d.ts +0 -87
  262. package/src/@claude-flow/memory/dist/database-provider.js +0 -375
  263. package/src/@claude-flow/memory/dist/database-provider.test.d.ts +0 -7
  264. package/src/@claude-flow/memory/dist/database-provider.test.js +0 -285
  265. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.d.ts +0 -143
  266. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.js +0 -226
  267. package/src/@claude-flow/memory/dist/domain/index.d.ts +0 -11
  268. package/src/@claude-flow/memory/dist/domain/index.js +0 -12
  269. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.d.ts +0 -102
  270. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.js +0 -11
  271. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.d.ts +0 -105
  272. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.js +0 -297
  273. package/src/@claude-flow/memory/dist/hnsw-index.d.ts +0 -111
  274. package/src/@claude-flow/memory/dist/hnsw-index.js +0 -781
  275. package/src/@claude-flow/memory/dist/hnsw-lite.d.ts +0 -23
  276. package/src/@claude-flow/memory/dist/hnsw-lite.js +0 -168
  277. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +0 -245
  278. package/src/@claude-flow/memory/dist/hybrid-backend.js +0 -569
  279. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +0 -8
  280. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +0 -320
  281. package/src/@claude-flow/memory/dist/index.d.ts +0 -207
  282. package/src/@claude-flow/memory/dist/index.js +0 -361
  283. package/src/@claude-flow/memory/dist/infrastructure/index.d.ts +0 -17
  284. package/src/@claude-flow/memory/dist/infrastructure/index.js +0 -16
  285. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.d.ts +0 -66
  286. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.js +0 -409
  287. package/src/@claude-flow/memory/dist/learning-bridge.d.ts +0 -137
  288. package/src/@claude-flow/memory/dist/learning-bridge.js +0 -335
  289. package/src/@claude-flow/memory/dist/learning-bridge.test.d.ts +0 -8
  290. package/src/@claude-flow/memory/dist/learning-bridge.test.js +0 -578
  291. package/src/@claude-flow/memory/dist/memory-graph.d.ts +0 -100
  292. package/src/@claude-flow/memory/dist/memory-graph.js +0 -333
  293. package/src/@claude-flow/memory/dist/memory-graph.test.d.ts +0 -8
  294. package/src/@claude-flow/memory/dist/memory-graph.test.js +0 -609
  295. package/src/@claude-flow/memory/dist/migration.d.ts +0 -68
  296. package/src/@claude-flow/memory/dist/migration.js +0 -513
  297. package/src/@claude-flow/memory/dist/persistent-sona.d.ts +0 -144
  298. package/src/@claude-flow/memory/dist/persistent-sona.js +0 -332
  299. package/src/@claude-flow/memory/dist/query-builder.d.ts +0 -211
  300. package/src/@claude-flow/memory/dist/query-builder.js +0 -438
  301. package/src/@claude-flow/memory/dist/rvf-backend.d.ts +0 -51
  302. package/src/@claude-flow/memory/dist/rvf-backend.js +0 -481
  303. package/src/@claude-flow/memory/dist/rvf-learning-store.d.ts +0 -139
  304. package/src/@claude-flow/memory/dist/rvf-learning-store.js +0 -295
  305. package/src/@claude-flow/memory/dist/rvf-migration.d.ts +0 -45
  306. package/src/@claude-flow/memory/dist/rvf-migration.js +0 -234
  307. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +0 -121
  308. package/src/@claude-flow/memory/dist/sqlite-backend.js +0 -572
  309. package/src/@claude-flow/memory/dist/sqljs-backend.d.ts +0 -128
  310. package/src/@claude-flow/memory/dist/sqljs-backend.js +0 -601
  311. package/src/@claude-flow/memory/dist/types.d.ts +0 -484
  312. package/src/@claude-flow/memory/dist/types.js +0 -58
  313. package/src/@claude-flow/shared/dist/core/config/defaults.d.ts +0 -41
  314. package/src/@claude-flow/shared/dist/core/config/defaults.js +0 -186
  315. package/src/@claude-flow/shared/dist/core/config/index.d.ts +0 -8
  316. package/src/@claude-flow/shared/dist/core/config/index.js +0 -12
  317. package/src/@claude-flow/shared/dist/core/config/loader.d.ts +0 -45
  318. package/src/@claude-flow/shared/dist/core/config/loader.js +0 -222
  319. package/src/@claude-flow/shared/dist/core/config/schema.d.ts +0 -1134
  320. package/src/@claude-flow/shared/dist/core/config/schema.js +0 -158
  321. package/src/@claude-flow/shared/dist/core/config/validator.d.ts +0 -92
  322. package/src/@claude-flow/shared/dist/core/config/validator.js +0 -147
  323. package/src/@claude-flow/shared/dist/core/event-bus.d.ts +0 -31
  324. package/src/@claude-flow/shared/dist/core/event-bus.js +0 -197
  325. package/src/@claude-flow/shared/dist/core/index.d.ts +0 -15
  326. package/src/@claude-flow/shared/dist/core/index.js +0 -19
  327. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +0 -200
  328. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.js +0 -6
  329. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +0 -310
  330. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +0 -7
  331. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +0 -224
  332. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.js +0 -46
  333. package/src/@claude-flow/shared/dist/core/interfaces/index.d.ts +0 -10
  334. package/src/@claude-flow/shared/dist/core/interfaces/index.js +0 -15
  335. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +0 -298
  336. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.js +0 -7
  337. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +0 -185
  338. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.js +0 -6
  339. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +0 -35
  340. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +0 -101
  341. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +0 -60
  342. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +0 -166
  343. package/src/@claude-flow/shared/dist/core/orchestrator/index.d.ts +0 -46
  344. package/src/@claude-flow/shared/dist/core/orchestrator/index.js +0 -64
  345. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +0 -56
  346. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +0 -195
  347. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +0 -83
  348. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.js +0 -193
  349. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +0 -49
  350. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.js +0 -253
  351. package/src/@claude-flow/shared/dist/events/domain-events.d.ts +0 -282
  352. package/src/@claude-flow/shared/dist/events/domain-events.js +0 -165
  353. package/src/@claude-flow/shared/dist/events/event-store.d.ts +0 -126
  354. package/src/@claude-flow/shared/dist/events/event-store.js +0 -416
  355. package/src/@claude-flow/shared/dist/events/event-store.test.d.ts +0 -8
  356. package/src/@claude-flow/shared/dist/events/event-store.test.js +0 -293
  357. package/src/@claude-flow/shared/dist/events/example-usage.d.ts +0 -10
  358. package/src/@claude-flow/shared/dist/events/example-usage.js +0 -193
  359. package/src/@claude-flow/shared/dist/events/index.d.ts +0 -21
  360. package/src/@claude-flow/shared/dist/events/index.js +0 -22
  361. package/src/@claude-flow/shared/dist/events/projections.d.ts +0 -177
  362. package/src/@claude-flow/shared/dist/events/projections.js +0 -421
  363. package/src/@claude-flow/shared/dist/events/rvf-event-log.d.ts +0 -82
  364. package/src/@claude-flow/shared/dist/events/rvf-event-log.js +0 -340
  365. package/src/@claude-flow/shared/dist/events/state-reconstructor.d.ts +0 -101
  366. package/src/@claude-flow/shared/dist/events/state-reconstructor.js +0 -263
  367. package/src/@claude-flow/shared/dist/events.d.ts +0 -80
  368. package/src/@claude-flow/shared/dist/events.js +0 -249
  369. package/src/@claude-flow/shared/dist/hooks/example-usage.d.ts +0 -42
  370. package/src/@claude-flow/shared/dist/hooks/example-usage.js +0 -351
  371. package/src/@claude-flow/shared/dist/hooks/executor.d.ts +0 -100
  372. package/src/@claude-flow/shared/dist/hooks/executor.js +0 -264
  373. package/src/@claude-flow/shared/dist/hooks/hooks.test.d.ts +0 -9
  374. package/src/@claude-flow/shared/dist/hooks/hooks.test.js +0 -322
  375. package/src/@claude-flow/shared/dist/hooks/index.d.ts +0 -52
  376. package/src/@claude-flow/shared/dist/hooks/index.js +0 -51
  377. package/src/@claude-flow/shared/dist/hooks/registry.d.ts +0 -133
  378. package/src/@claude-flow/shared/dist/hooks/registry.js +0 -277
  379. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +0 -105
  380. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.js +0 -481
  381. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +0 -144
  382. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.js +0 -328
  383. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +0 -158
  384. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.js +0 -450
  385. package/src/@claude-flow/shared/dist/hooks/safety/index.d.ts +0 -17
  386. package/src/@claude-flow/shared/dist/hooks/safety/index.js +0 -17
  387. package/src/@claude-flow/shared/dist/hooks/session-hooks.d.ts +0 -234
  388. package/src/@claude-flow/shared/dist/hooks/session-hooks.js +0 -334
  389. package/src/@claude-flow/shared/dist/hooks/task-hooks.d.ts +0 -163
  390. package/src/@claude-flow/shared/dist/hooks/task-hooks.js +0 -326
  391. package/src/@claude-flow/shared/dist/hooks/types.d.ts +0 -267
  392. package/src/@claude-flow/shared/dist/hooks/types.js +0 -62
  393. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +0 -9
  394. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.js +0 -93
  395. package/src/@claude-flow/shared/dist/index.d.ts +0 -20
  396. package/src/@claude-flow/shared/dist/index.js +0 -50
  397. package/src/@claude-flow/shared/dist/mcp/connection-pool.d.ts +0 -98
  398. package/src/@claude-flow/shared/dist/mcp/connection-pool.js +0 -364
  399. package/src/@claude-flow/shared/dist/mcp/index.d.ts +0 -69
  400. package/src/@claude-flow/shared/dist/mcp/index.js +0 -84
  401. package/src/@claude-flow/shared/dist/mcp/server.d.ts +0 -166
  402. package/src/@claude-flow/shared/dist/mcp/server.js +0 -593
  403. package/src/@claude-flow/shared/dist/mcp/session-manager.d.ts +0 -136
  404. package/src/@claude-flow/shared/dist/mcp/session-manager.js +0 -335
  405. package/src/@claude-flow/shared/dist/mcp/tool-registry.d.ts +0 -178
  406. package/src/@claude-flow/shared/dist/mcp/tool-registry.js +0 -439
  407. package/src/@claude-flow/shared/dist/mcp/transport/http.d.ts +0 -104
  408. package/src/@claude-flow/shared/dist/mcp/transport/http.js +0 -476
  409. package/src/@claude-flow/shared/dist/mcp/transport/index.d.ts +0 -102
  410. package/src/@claude-flow/shared/dist/mcp/transport/index.js +0 -238
  411. package/src/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +0 -104
  412. package/src/@claude-flow/shared/dist/mcp/transport/stdio.js +0 -263
  413. package/src/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +0 -133
  414. package/src/@claude-flow/shared/dist/mcp/transport/websocket.js +0 -396
  415. package/src/@claude-flow/shared/dist/mcp/types.d.ts +0 -438
  416. package/src/@claude-flow/shared/dist/mcp/types.js +0 -54
  417. package/src/@claude-flow/shared/dist/plugin-interface.d.ts +0 -544
  418. package/src/@claude-flow/shared/dist/plugin-interface.js +0 -23
  419. package/src/@claude-flow/shared/dist/plugin-loader.d.ts +0 -139
  420. package/src/@claude-flow/shared/dist/plugin-loader.js +0 -434
  421. package/src/@claude-flow/shared/dist/plugin-registry.d.ts +0 -183
  422. package/src/@claude-flow/shared/dist/plugin-registry.js +0 -457
  423. package/src/@claude-flow/shared/dist/plugins/index.d.ts +0 -10
  424. package/src/@claude-flow/shared/dist/plugins/index.js +0 -10
  425. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +0 -106
  426. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +0 -241
  427. package/src/@claude-flow/shared/dist/plugins/official/index.d.ts +0 -10
  428. package/src/@claude-flow/shared/dist/plugins/official/index.js +0 -10
  429. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +0 -121
  430. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +0 -355
  431. package/src/@claude-flow/shared/dist/plugins/types.d.ts +0 -93
  432. package/src/@claude-flow/shared/dist/plugins/types.js +0 -9
  433. package/src/@claude-flow/shared/dist/resilience/bulkhead.d.ts +0 -105
  434. package/src/@claude-flow/shared/dist/resilience/bulkhead.js +0 -206
  435. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +0 -132
  436. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.js +0 -233
  437. package/src/@claude-flow/shared/dist/resilience/index.d.ts +0 -19
  438. package/src/@claude-flow/shared/dist/resilience/index.js +0 -19
  439. package/src/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +0 -168
  440. package/src/@claude-flow/shared/dist/resilience/rate-limiter.js +0 -314
  441. package/src/@claude-flow/shared/dist/resilience/retry.d.ts +0 -91
  442. package/src/@claude-flow/shared/dist/resilience/retry.js +0 -159
  443. package/src/@claude-flow/shared/dist/security/index.d.ts +0 -10
  444. package/src/@claude-flow/shared/dist/security/index.js +0 -12
  445. package/src/@claude-flow/shared/dist/security/input-validation.d.ts +0 -73
  446. package/src/@claude-flow/shared/dist/security/input-validation.js +0 -201
  447. package/src/@claude-flow/shared/dist/security/secure-random.d.ts +0 -92
  448. package/src/@claude-flow/shared/dist/security/secure-random.js +0 -142
  449. package/src/@claude-flow/shared/dist/services/index.d.ts +0 -7
  450. package/src/@claude-flow/shared/dist/services/index.js +0 -7
  451. package/src/@claude-flow/shared/dist/services/v3-progress.service.d.ts +0 -124
  452. package/src/@claude-flow/shared/dist/services/v3-progress.service.js +0 -402
  453. package/src/@claude-flow/shared/dist/types/agent.types.d.ts +0 -137
  454. package/src/@claude-flow/shared/dist/types/agent.types.js +0 -6
  455. package/src/@claude-flow/shared/dist/types/index.d.ts +0 -11
  456. package/src/@claude-flow/shared/dist/types/index.js +0 -17
  457. package/src/@claude-flow/shared/dist/types/mcp.types.d.ts +0 -266
  458. package/src/@claude-flow/shared/dist/types/mcp.types.js +0 -7
  459. package/src/@claude-flow/shared/dist/types/memory.types.d.ts +0 -236
  460. package/src/@claude-flow/shared/dist/types/memory.types.js +0 -7
  461. package/src/@claude-flow/shared/dist/types/swarm.types.d.ts +0 -186
  462. package/src/@claude-flow/shared/dist/types/swarm.types.js +0 -65
  463. package/src/@claude-flow/shared/dist/types/task.types.d.ts +0 -178
  464. package/src/@claude-flow/shared/dist/types/task.types.js +0 -32
  465. package/src/@claude-flow/shared/dist/types.d.ts +0 -197
  466. package/src/@claude-flow/shared/dist/types.js +0 -21
  467. package/src/@claude-flow/shared/dist/utils/secure-logger.d.ts +0 -69
  468. package/src/@claude-flow/shared/dist/utils/secure-logger.js +0 -208
@@ -1,844 +0,0 @@
1
- /**
2
- * AgentDB Backend - Integration with agentdb@2.0.0-alpha.3.4
3
- *
4
- * Provides IMemoryBackend implementation using AgentDB with:
5
- * - HNSW vector search (150x-12,500x faster than brute-force)
6
- * - Native or WASM backend support with graceful fallback
7
- * - Optional dependency handling (works without hnswlib-node)
8
- * - Seamless integration with HybridBackend
9
- *
10
- * @module v3/memory/agentdb-backend
11
- */
12
- import { EventEmitter } from 'node:events';
13
- // ===== AgentDB Optional Import =====
14
- let AgentDB;
15
- let HNSWIndex;
16
- let isHnswlibAvailable;
17
- // Dynamically import agentdb (handled at runtime)
18
- let agentdbImportPromise;
19
- function ensureAgentDBImport() {
20
- if (!agentdbImportPromise) {
21
- agentdbImportPromise = (async () => {
22
- try {
23
- const agentdbModule = await import('agentdb');
24
- AgentDB = agentdbModule.AgentDB || agentdbModule.default;
25
- HNSWIndex = agentdbModule.HNSWIndex;
26
- isHnswlibAvailable = agentdbModule.isHnswlibAvailable;
27
- }
28
- catch (error) {
29
- // AgentDB not available - will use fallback
30
- }
31
- })();
32
- }
33
- return agentdbImportPromise;
34
- }
35
- /**
36
- * Default configuration
37
- */
38
- const DEFAULT_CONFIG = {
39
- namespace: 'default',
40
- forceWasm: false,
41
- vectorBackend: 'auto',
42
- vectorDimension: 1536,
43
- hnswM: 16,
44
- hnswEfConstruction: 200,
45
- hnswEfSearch: 100,
46
- cacheEnabled: true,
47
- maxEntries: 1000000,
48
- };
49
- // ===== AgentDB Backend Implementation =====
50
- /**
51
- * AgentDB Backend
52
- *
53
- * Integrates AgentDB for vector search with the V3 memory system.
54
- * Provides 150x-12,500x faster search compared to brute-force approaches.
55
- *
56
- * Features:
57
- * - HNSW indexing for fast approximate nearest neighbor search
58
- * - Automatic fallback: native hnswlib → ruvector → WASM
59
- * - Graceful handling of optional native dependencies
60
- * - Semantic search with filtering
61
- * - Compatible with HybridBackend for combined SQLite+AgentDB queries
62
- */
63
- export class AgentDBBackend extends EventEmitter {
64
- config;
65
- agentdb;
66
- initialized = false;
67
- available = false;
68
- // In-memory storage for compatibility
69
- entries = new Map();
70
- namespaceIndex = new Map();
71
- keyIndex = new Map();
72
- // O(1) reverse lookup for numeric ID -> string ID (fixes O(n) linear scan)
73
- numericToStringIdMap = new Map();
74
- // Performance tracking
75
- stats = {
76
- queryCount: 0,
77
- totalQueryTime: 0,
78
- searchCount: 0,
79
- totalSearchTime: 0,
80
- };
81
- constructor(config = {}) {
82
- super();
83
- this.config = { ...DEFAULT_CONFIG, ...config };
84
- this.available = false; // Will be set during initialization
85
- }
86
- /**
87
- * Initialize AgentDB
88
- */
89
- async initialize() {
90
- if (this.initialized)
91
- return;
92
- // Try to import AgentDB
93
- await ensureAgentDBImport();
94
- this.available = AgentDB !== undefined;
95
- if (!this.available) {
96
- console.warn('AgentDB not available, using fallback in-memory storage');
97
- this.initialized = true;
98
- return;
99
- }
100
- try {
101
- // Initialize AgentDB with config
102
- this.agentdb = new AgentDB({
103
- dbPath: this.config.dbPath || ':memory:',
104
- namespace: this.config.namespace,
105
- forceWasm: this.config.forceWasm,
106
- vectorBackend: this.config.vectorBackend,
107
- vectorDimension: this.config.vectorDimension,
108
- });
109
- // Suppress agentdb's noisy console.log during init
110
- // (EmbeddingService, AgentDB core emit info-level logs we don't need)
111
- const origLog = console.log;
112
- console.log = (...args) => {
113
- const msg = String(args[0] ?? '');
114
- if (msg.includes('Transformers.js loaded') ||
115
- msg.includes('Using better-sqlite3') ||
116
- msg.includes('better-sqlite3 unavailable') ||
117
- msg.includes('[AgentDB]'))
118
- return;
119
- origLog.apply(console, args);
120
- };
121
- try {
122
- await this.agentdb.initialize();
123
- }
124
- finally {
125
- console.log = origLog;
126
- }
127
- // Create memory_entries table if it doesn't exist
128
- await this.createSchema();
129
- this.initialized = true;
130
- this.emit('initialized', {
131
- backend: this.agentdb.vectorBackendName,
132
- isWasm: this.agentdb.isWasm,
133
- });
134
- }
135
- catch (error) {
136
- console.error('Failed to initialize AgentDB:', error);
137
- this.available = false;
138
- this.initialized = true;
139
- this.emit('initialization:failed', { error });
140
- }
141
- }
142
- /**
143
- * Shutdown AgentDB
144
- */
145
- async shutdown() {
146
- if (!this.initialized)
147
- return;
148
- if (this.agentdb) {
149
- await this.agentdb.close();
150
- }
151
- this.initialized = false;
152
- this.emit('shutdown');
153
- }
154
- /**
155
- * Store a memory entry
156
- */
157
- async store(entry) {
158
- // Generate embedding if needed
159
- if (entry.content && !entry.embedding && this.config.embeddingGenerator) {
160
- entry.embedding = await this.config.embeddingGenerator(entry.content);
161
- }
162
- // Store in-memory for quick access
163
- this.entries.set(entry.id, entry);
164
- // Register ID mapping for O(1) reverse lookup
165
- this.registerIdMapping(entry.id);
166
- // Update indexes
167
- this.updateIndexes(entry);
168
- // Store in AgentDB if available
169
- if (this.agentdb) {
170
- await this.storeInAgentDB(entry);
171
- }
172
- this.emit('entry:stored', { id: entry.id });
173
- }
174
- /**
175
- * Get entry by ID
176
- */
177
- async get(id) {
178
- // Check in-memory first
179
- const cached = this.entries.get(id);
180
- if (cached)
181
- return cached;
182
- // Query AgentDB if available
183
- if (this.agentdb) {
184
- return this.getFromAgentDB(id);
185
- }
186
- return null;
187
- }
188
- /**
189
- * Get entry by key
190
- */
191
- async getByKey(namespace, key) {
192
- const keyIndexKey = `${namespace}:${key}`;
193
- const id = this.keyIndex.get(keyIndexKey);
194
- if (!id)
195
- return null;
196
- return this.get(id);
197
- }
198
- /**
199
- * Update entry
200
- */
201
- async update(id, update) {
202
- const entry = this.entries.get(id);
203
- if (!entry)
204
- return null;
205
- // Apply updates
206
- if (update.content !== undefined) {
207
- entry.content = update.content;
208
- // Regenerate embedding if needed
209
- if (this.config.embeddingGenerator) {
210
- entry.embedding = await this.config.embeddingGenerator(entry.content);
211
- }
212
- }
213
- if (update.tags !== undefined) {
214
- entry.tags = update.tags;
215
- }
216
- if (update.metadata !== undefined) {
217
- entry.metadata = { ...entry.metadata, ...update.metadata };
218
- }
219
- if (update.accessLevel !== undefined) {
220
- entry.accessLevel = update.accessLevel;
221
- }
222
- if (update.expiresAt !== undefined) {
223
- entry.expiresAt = update.expiresAt;
224
- }
225
- if (update.references !== undefined) {
226
- entry.references = update.references;
227
- }
228
- entry.updatedAt = Date.now();
229
- entry.version++;
230
- // Update in AgentDB
231
- if (this.agentdb) {
232
- await this.updateInAgentDB(entry);
233
- }
234
- this.emit('entry:updated', { id });
235
- return entry;
236
- }
237
- /**
238
- * Delete entry
239
- */
240
- async delete(id) {
241
- const entry = this.entries.get(id);
242
- if (!entry)
243
- return false;
244
- // Remove from indexes
245
- this.entries.delete(id);
246
- this.unregisterIdMapping(id); // Clean up reverse lookup map
247
- this.namespaceIndex.get(entry.namespace)?.delete(id);
248
- const keyIndexKey = `${entry.namespace}:${entry.key}`;
249
- this.keyIndex.delete(keyIndexKey);
250
- // Delete from AgentDB
251
- if (this.agentdb) {
252
- await this.deleteFromAgentDB(id);
253
- }
254
- this.emit('entry:deleted', { id });
255
- return true;
256
- }
257
- /**
258
- * Query entries
259
- */
260
- async query(query) {
261
- const startTime = performance.now();
262
- let results = [];
263
- if (query.type === 'semantic' && (query.embedding || query.content)) {
264
- // Use semantic search
265
- const searchResults = await this.semanticSearch(query);
266
- results = searchResults.map((r) => r.entry);
267
- }
268
- else {
269
- // Fallback to in-memory filtering
270
- results = this.queryInMemory(query);
271
- }
272
- const duration = performance.now() - startTime;
273
- this.stats.queryCount++;
274
- this.stats.totalQueryTime += duration;
275
- return results;
276
- }
277
- /**
278
- * Semantic vector search
279
- */
280
- async search(embedding, options) {
281
- const startTime = performance.now();
282
- if (!this.agentdb) {
283
- // Fallback to brute-force search
284
- return this.bruteForceSearch(embedding, options);
285
- }
286
- try {
287
- // Use AgentDB HNSW search
288
- const results = await this.searchWithAgentDB(embedding, options);
289
- const duration = performance.now() - startTime;
290
- this.stats.searchCount++;
291
- this.stats.totalSearchTime += duration;
292
- return results;
293
- }
294
- catch (error) {
295
- console.error('AgentDB search failed, falling back to brute-force:', error);
296
- return this.bruteForceSearch(embedding, options);
297
- }
298
- }
299
- /**
300
- * Bulk insert
301
- */
302
- async bulkInsert(entries) {
303
- for (const entry of entries) {
304
- await this.store(entry);
305
- }
306
- }
307
- /**
308
- * Bulk delete
309
- */
310
- async bulkDelete(ids) {
311
- let deleted = 0;
312
- for (const id of ids) {
313
- if (await this.delete(id)) {
314
- deleted++;
315
- }
316
- }
317
- return deleted;
318
- }
319
- /**
320
- * Count entries
321
- */
322
- async count(namespace) {
323
- if (namespace) {
324
- return this.namespaceIndex.get(namespace)?.size || 0;
325
- }
326
- return this.entries.size;
327
- }
328
- /**
329
- * List namespaces
330
- */
331
- async listNamespaces() {
332
- return Array.from(this.namespaceIndex.keys());
333
- }
334
- /**
335
- * Clear namespace
336
- */
337
- async clearNamespace(namespace) {
338
- const ids = this.namespaceIndex.get(namespace);
339
- if (!ids)
340
- return 0;
341
- let deleted = 0;
342
- for (const id of ids) {
343
- if (await this.delete(id)) {
344
- deleted++;
345
- }
346
- }
347
- return deleted;
348
- }
349
- /**
350
- * Get statistics
351
- */
352
- async getStats() {
353
- const entriesByNamespace = {};
354
- for (const [namespace, ids] of this.namespaceIndex) {
355
- entriesByNamespace[namespace] = ids.size;
356
- }
357
- const entriesByType = {
358
- episodic: 0,
359
- semantic: 0,
360
- procedural: 0,
361
- working: 0,
362
- cache: 0,
363
- };
364
- for (const entry of this.entries.values()) {
365
- entriesByType[entry.type]++;
366
- }
367
- // Get HNSW stats if available
368
- let hnswStats;
369
- if (this.agentdb && HNSWIndex) {
370
- try {
371
- const hnsw = this.agentdb.getController('hnsw');
372
- if (hnsw) {
373
- const stats = hnsw.getStats();
374
- hnswStats = {
375
- vectorCount: stats.numElements || 0,
376
- memoryUsage: 0,
377
- avgSearchTime: stats.avgSearchTimeMs || 0,
378
- buildTime: stats.lastBuildTime || 0,
379
- compressionRatio: 1.0,
380
- };
381
- }
382
- }
383
- catch {
384
- // HNSW not available
385
- }
386
- }
387
- return {
388
- totalEntries: this.entries.size,
389
- entriesByNamespace,
390
- entriesByType,
391
- memoryUsage: this.estimateMemoryUsage(),
392
- hnswStats,
393
- avgQueryTime: this.stats.queryCount > 0
394
- ? this.stats.totalQueryTime / this.stats.queryCount
395
- : 0,
396
- avgSearchTime: this.stats.searchCount > 0
397
- ? this.stats.totalSearchTime / this.stats.searchCount
398
- : 0,
399
- };
400
- }
401
- /**
402
- * Health check
403
- */
404
- async healthCheck() {
405
- const issues = [];
406
- const recommendations = [];
407
- // Check AgentDB availability
408
- const storageHealth = this.agentdb
409
- ? { status: 'healthy', latency: 0 }
410
- : {
411
- status: 'degraded',
412
- latency: 0,
413
- message: 'AgentDB not available, using fallback',
414
- };
415
- // Check index health
416
- const indexHealth = { status: 'healthy', latency: 0 };
417
- if (!this.agentdb) {
418
- indexHealth.status = 'degraded';
419
- indexHealth.message = 'HNSW index not available';
420
- recommendations.push('Install agentdb for 150x-12,500x faster vector search');
421
- }
422
- // Check cache health
423
- const cacheHealth = { status: 'healthy', latency: 0 };
424
- const status = storageHealth.status === 'unhealthy' || indexHealth.status === 'unhealthy'
425
- ? 'unhealthy'
426
- : storageHealth.status === 'degraded' || indexHealth.status === 'degraded'
427
- ? 'degraded'
428
- : 'healthy';
429
- return {
430
- status,
431
- components: {
432
- storage: storageHealth,
433
- index: indexHealth,
434
- cache: cacheHealth,
435
- },
436
- timestamp: Date.now(),
437
- issues,
438
- recommendations,
439
- };
440
- }
441
- // ===== Private Methods =====
442
- /**
443
- * Create database schema
444
- */
445
- async createSchema() {
446
- if (!this.agentdb)
447
- return;
448
- const db = this.agentdb.database;
449
- if (!db || typeof db.run !== 'function') {
450
- // AgentDB doesn't expose raw database - using native API
451
- return;
452
- }
453
- try {
454
- // Create memory_entries table
455
- await db.run(`
456
- CREATE TABLE IF NOT EXISTS memory_entries (
457
- id TEXT PRIMARY KEY,
458
- key TEXT NOT NULL,
459
- content TEXT NOT NULL,
460
- embedding BLOB,
461
- type TEXT NOT NULL,
462
- namespace TEXT NOT NULL,
463
- tags TEXT,
464
- metadata TEXT,
465
- owner_id TEXT,
466
- access_level TEXT NOT NULL,
467
- created_at INTEGER NOT NULL,
468
- updated_at INTEGER NOT NULL,
469
- expires_at INTEGER,
470
- version INTEGER NOT NULL,
471
- references TEXT,
472
- access_count INTEGER DEFAULT 0,
473
- last_accessed_at INTEGER
474
- )
475
- `);
476
- // Create indexes
477
- await db.run('CREATE INDEX IF NOT EXISTS idx_namespace ON memory_entries(namespace)');
478
- await db.run('CREATE INDEX IF NOT EXISTS idx_key ON memory_entries(key)');
479
- await db.run('CREATE INDEX IF NOT EXISTS idx_type ON memory_entries(type)');
480
- }
481
- catch {
482
- // Schema creation failed - using in-memory only
483
- }
484
- }
485
- /**
486
- * Store entry in AgentDB
487
- */
488
- async storeInAgentDB(entry) {
489
- if (!this.agentdb)
490
- return;
491
- // Try to use agentdb's native store method if available
492
- try {
493
- if (typeof this.agentdb.store === 'function') {
494
- await this.agentdb.store(entry.id, {
495
- key: entry.key,
496
- content: entry.content,
497
- embedding: entry.embedding,
498
- type: entry.type,
499
- namespace: entry.namespace,
500
- tags: entry.tags,
501
- metadata: entry.metadata,
502
- });
503
- return;
504
- }
505
- // Fallback: use database directly if available
506
- const db = this.agentdb.database;
507
- if (!db || typeof db.run !== 'function') {
508
- // No compatible database interface - skip agentdb storage
509
- // Entry is already stored in-memory
510
- return;
511
- }
512
- await db.run(`
513
- INSERT OR REPLACE INTO memory_entries
514
- (id, key, content, embedding, type, namespace, tags, metadata, owner_id,
515
- access_level, created_at, updated_at, expires_at, version, references,
516
- access_count, last_accessed_at)
517
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
518
- `, [
519
- entry.id,
520
- entry.key,
521
- entry.content,
522
- entry.embedding ? Buffer.from(entry.embedding.buffer) : null,
523
- entry.type,
524
- entry.namespace,
525
- JSON.stringify(entry.tags),
526
- JSON.stringify(entry.metadata),
527
- entry.ownerId || null,
528
- entry.accessLevel,
529
- entry.createdAt,
530
- entry.updatedAt,
531
- entry.expiresAt || null,
532
- entry.version,
533
- JSON.stringify(entry.references),
534
- entry.accessCount,
535
- entry.lastAccessedAt,
536
- ]);
537
- }
538
- catch {
539
- // AgentDB storage failed - entry is already in-memory
540
- }
541
- // Add to vector index if HNSW is available
542
- if (entry.embedding && HNSWIndex) {
543
- try {
544
- const hnsw = this.agentdb.getController('hnsw');
545
- if (hnsw) {
546
- // Convert string ID to number for HNSW (use hash)
547
- const numericId = this.stringIdToNumeric(entry.id);
548
- hnsw.addVector(numericId, entry.embedding);
549
- }
550
- }
551
- catch {
552
- // HNSW not available
553
- }
554
- }
555
- }
556
- /**
557
- * Get entry from AgentDB
558
- */
559
- async getFromAgentDB(id) {
560
- if (!this.agentdb)
561
- return null;
562
- try {
563
- // Try native get method first
564
- if (typeof this.agentdb.get === 'function') {
565
- const data = await this.agentdb.get(id);
566
- if (data)
567
- return this.dataToEntry(id, data);
568
- }
569
- // Fallback to database
570
- const db = this.agentdb.database;
571
- if (!db || typeof db.get !== 'function')
572
- return null;
573
- const row = await db.get('SELECT * FROM memory_entries WHERE id = ?', [id]);
574
- if (!row)
575
- return null;
576
- return this.rowToEntry(row);
577
- }
578
- catch {
579
- return null;
580
- }
581
- }
582
- /**
583
- * Convert agentdb data to MemoryEntry
584
- */
585
- dataToEntry(id, data) {
586
- const now = Date.now();
587
- return {
588
- id,
589
- key: data.key || id,
590
- content: data.content || '',
591
- embedding: data.embedding,
592
- type: data.type || 'semantic',
593
- namespace: data.namespace || this.config.namespace,
594
- tags: data.tags || [],
595
- metadata: data.metadata || {},
596
- ownerId: data.ownerId,
597
- accessLevel: data.accessLevel || 'private',
598
- createdAt: data.createdAt || now,
599
- updatedAt: data.updatedAt || now,
600
- expiresAt: data.expiresAt,
601
- version: data.version || 1,
602
- references: data.references || [],
603
- accessCount: data.accessCount || 0,
604
- lastAccessedAt: data.lastAccessedAt || now,
605
- };
606
- }
607
- /**
608
- * Update entry in AgentDB
609
- */
610
- async updateInAgentDB(entry) {
611
- await this.storeInAgentDB(entry);
612
- }
613
- /**
614
- * Delete entry from AgentDB
615
- */
616
- async deleteFromAgentDB(id) {
617
- if (!this.agentdb)
618
- return;
619
- try {
620
- // Try native delete method first
621
- if (typeof this.agentdb.delete === 'function') {
622
- await this.agentdb.delete(id);
623
- return;
624
- }
625
- // Fallback to database
626
- const db = this.agentdb.database;
627
- if (!db || typeof db.run !== 'function')
628
- return;
629
- await db.run('DELETE FROM memory_entries WHERE id = ?', [id]);
630
- }
631
- catch {
632
- // Delete failed - entry removed from in-memory
633
- }
634
- }
635
- /**
636
- * Search with AgentDB HNSW
637
- */
638
- async searchWithAgentDB(embedding, options) {
639
- if (!this.agentdb || !HNSWIndex) {
640
- return [];
641
- }
642
- try {
643
- const hnsw = this.agentdb.getController('hnsw');
644
- if (!hnsw) {
645
- return this.bruteForceSearch(embedding, options);
646
- }
647
- const results = await hnsw.search(embedding, options.k, {
648
- threshold: options.threshold,
649
- });
650
- const searchResults = [];
651
- for (const result of results) {
652
- const id = this.numericIdToString(result.id);
653
- const entry = await this.get(id);
654
- if (!entry)
655
- continue;
656
- searchResults.push({
657
- entry,
658
- score: result.similarity,
659
- distance: result.distance,
660
- });
661
- }
662
- return searchResults;
663
- }
664
- catch (error) {
665
- console.error('HNSW search failed:', error);
666
- return this.bruteForceSearch(embedding, options);
667
- }
668
- }
669
- /**
670
- * Brute-force vector search fallback
671
- */
672
- bruteForceSearch(embedding, options) {
673
- const results = [];
674
- for (const entry of this.entries.values()) {
675
- if (!entry.embedding)
676
- continue;
677
- const score = this.cosineSimilarity(embedding, entry.embedding);
678
- const distance = 1 - score;
679
- if (options.threshold && score < options.threshold)
680
- continue;
681
- results.push({ entry, score, distance });
682
- }
683
- // Sort by score descending
684
- results.sort((a, b) => b.score - a.score);
685
- return results.slice(0, options.k);
686
- }
687
- /**
688
- * Semantic search helper
689
- */
690
- async semanticSearch(query) {
691
- let embedding = query.embedding;
692
- if (!embedding && query.content && this.config.embeddingGenerator) {
693
- embedding = await this.config.embeddingGenerator(query.content);
694
- }
695
- if (!embedding) {
696
- return [];
697
- }
698
- return this.search(embedding, {
699
- k: query.limit,
700
- threshold: query.threshold,
701
- filters: query,
702
- });
703
- }
704
- /**
705
- * In-memory query fallback
706
- */
707
- queryInMemory(query) {
708
- let results = Array.from(this.entries.values());
709
- // Apply filters
710
- if (query.namespace) {
711
- results = results.filter((e) => e.namespace === query.namespace);
712
- }
713
- if (query.key) {
714
- results = results.filter((e) => e.key === query.key);
715
- }
716
- if (query.keyPrefix) {
717
- results = results.filter((e) => e.key.startsWith(query.keyPrefix));
718
- }
719
- if (query.tags && query.tags.length > 0) {
720
- results = results.filter((e) => query.tags.every((tag) => e.tags.includes(tag)));
721
- }
722
- return results.slice(0, query.limit);
723
- }
724
- /**
725
- * Update in-memory indexes
726
- */
727
- updateIndexes(entry) {
728
- const namespace = entry.namespace;
729
- if (!this.namespaceIndex.has(namespace)) {
730
- this.namespaceIndex.set(namespace, new Set());
731
- }
732
- this.namespaceIndex.get(namespace).add(entry.id);
733
- const keyIndexKey = `${namespace}:${entry.key}`;
734
- this.keyIndex.set(keyIndexKey, entry.id);
735
- }
736
- /**
737
- * Convert DB row to MemoryEntry
738
- */
739
- rowToEntry(row) {
740
- return {
741
- id: row.id,
742
- key: row.key,
743
- content: row.content,
744
- embedding: row.embedding
745
- ? new Float32Array(new Uint8Array(row.embedding).buffer)
746
- : undefined,
747
- type: row.type,
748
- namespace: row.namespace,
749
- tags: JSON.parse(row.tags || '[]'),
750
- metadata: JSON.parse(row.metadata || '{}'),
751
- ownerId: row.owner_id,
752
- accessLevel: row.access_level,
753
- createdAt: row.created_at,
754
- updatedAt: row.updated_at,
755
- expiresAt: row.expires_at,
756
- version: row.version,
757
- references: JSON.parse(row.references || '[]'),
758
- accessCount: row.access_count || 0,
759
- lastAccessedAt: row.last_accessed_at || row.created_at,
760
- };
761
- }
762
- /**
763
- * Convert string ID to numeric for HNSW
764
- */
765
- stringIdToNumeric(id) {
766
- let hash = 0;
767
- for (let i = 0; i < id.length; i++) {
768
- hash = (hash << 5) - hash + id.charCodeAt(i);
769
- hash |= 0;
770
- }
771
- return Math.abs(hash);
772
- }
773
- /**
774
- * Convert numeric ID back to string using O(1) reverse lookup
775
- * PERFORMANCE FIX: Uses pre-built reverse map instead of O(n) linear scan
776
- */
777
- numericIdToString(numericId) {
778
- // Use O(1) reverse lookup map
779
- const stringId = this.numericToStringIdMap.get(numericId);
780
- if (stringId) {
781
- return stringId;
782
- }
783
- // Fallback for unmapped IDs
784
- return String(numericId);
785
- }
786
- /**
787
- * Register string ID in reverse lookup map
788
- * Called when storing entries to maintain bidirectional mapping
789
- */
790
- registerIdMapping(stringId) {
791
- const numericId = this.stringIdToNumeric(stringId);
792
- this.numericToStringIdMap.set(numericId, stringId);
793
- }
794
- /**
795
- * Unregister string ID from reverse lookup map
796
- * Called when deleting entries
797
- */
798
- unregisterIdMapping(stringId) {
799
- const numericId = this.stringIdToNumeric(stringId);
800
- this.numericToStringIdMap.delete(numericId);
801
- }
802
- /**
803
- * Cosine similarity (returns value in range [0, 1] where 1 = identical)
804
- */
805
- cosineSimilarity(a, b) {
806
- let dotProduct = 0;
807
- let normA = 0;
808
- let normB = 0;
809
- for (let i = 0; i < a.length; i++) {
810
- dotProduct += a[i] * b[i];
811
- normA += a[i] * a[i];
812
- normB += b[i] * b[i];
813
- }
814
- const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
815
- return magnitude === 0 ? 0 : dotProduct / magnitude;
816
- }
817
- /**
818
- * Estimate memory usage
819
- */
820
- estimateMemoryUsage() {
821
- let total = 0;
822
- for (const entry of this.entries.values()) {
823
- total += entry.content.length * 2;
824
- if (entry.embedding) {
825
- total += entry.embedding.length * 4;
826
- }
827
- }
828
- return total;
829
- }
830
- /**
831
- * Check if AgentDB is available
832
- */
833
- isAvailable() {
834
- return this.available;
835
- }
836
- /**
837
- * Get underlying AgentDB instance
838
- */
839
- getAgentDB() {
840
- return this.agentdb;
841
- }
842
- }
843
- export default AgentDBBackend;
844
- //# sourceMappingURL=agentdb-backend.js.map