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,781 +0,0 @@
1
- /**
2
- * V3 HNSW Vector Index
3
- *
4
- * High-performance Hierarchical Navigable Small World (HNSW) index for
5
- * 150x-12,500x faster vector similarity search compared to brute force.
6
- *
7
- * OPTIMIZATIONS:
8
- * - BinaryMinHeap/BinaryMaxHeap for O(log n) operations (vs O(n log n) Array.sort)
9
- * - Pre-normalized vectors for O(1) cosine similarity (no sqrt needed)
10
- * - Bounded max-heap for efficient top-k tracking
11
- *
12
- * @module v3/memory/hnsw-index
13
- */
14
- import { EventEmitter } from 'node:events';
15
- /**
16
- * Binary Min Heap for O(log n) priority queue operations
17
- * Used for candidate selection in HNSW search
18
- */
19
- class BinaryMinHeap {
20
- heap = [];
21
- get size() {
22
- return this.heap.length;
23
- }
24
- insert(item, priority) {
25
- this.heap.push({ item, priority });
26
- this.bubbleUp(this.heap.length - 1);
27
- }
28
- extractMin() {
29
- if (this.heap.length === 0)
30
- return undefined;
31
- const min = this.heap[0].item;
32
- const last = this.heap.pop();
33
- if (this.heap.length > 0) {
34
- this.heap[0] = last;
35
- this.bubbleDown(0);
36
- }
37
- return min;
38
- }
39
- peek() {
40
- return this.heap[0]?.item;
41
- }
42
- peekPriority() {
43
- return this.heap[0]?.priority;
44
- }
45
- isEmpty() {
46
- return this.heap.length === 0;
47
- }
48
- toArray() {
49
- return this.heap
50
- .slice()
51
- .sort((a, b) => a.priority - b.priority)
52
- .map((entry) => entry.item);
53
- }
54
- bubbleUp(index) {
55
- while (index > 0) {
56
- const parent = Math.floor((index - 1) / 2);
57
- if (this.heap[parent].priority <= this.heap[index].priority)
58
- break;
59
- [this.heap[parent], this.heap[index]] = [this.heap[index], this.heap[parent]];
60
- index = parent;
61
- }
62
- }
63
- bubbleDown(index) {
64
- const length = this.heap.length;
65
- while (true) {
66
- let smallest = index;
67
- const left = 2 * index + 1;
68
- const right = 2 * index + 2;
69
- if (left < length && this.heap[left].priority < this.heap[smallest].priority) {
70
- smallest = left;
71
- }
72
- if (right < length && this.heap[right].priority < this.heap[smallest].priority) {
73
- smallest = right;
74
- }
75
- if (smallest === index)
76
- break;
77
- [this.heap[smallest], this.heap[index]] = [this.heap[index], this.heap[smallest]];
78
- index = smallest;
79
- }
80
- }
81
- }
82
- /**
83
- * Binary Max Heap for bounded top-k tracking
84
- * Keeps track of k smallest elements by evicting largest when full
85
- */
86
- class BinaryMaxHeap {
87
- heap = [];
88
- maxSize;
89
- constructor(maxSize = Infinity) {
90
- this.maxSize = maxSize;
91
- }
92
- get size() {
93
- return this.heap.length;
94
- }
95
- insert(item, priority) {
96
- // If at capacity and new item is worse than worst, reject
97
- if (this.heap.length >= this.maxSize && priority >= this.heap[0]?.priority) {
98
- return false;
99
- }
100
- if (this.heap.length >= this.maxSize) {
101
- // Replace max element
102
- this.heap[0] = { item, priority };
103
- this.bubbleDown(0);
104
- }
105
- else {
106
- this.heap.push({ item, priority });
107
- this.bubbleUp(this.heap.length - 1);
108
- }
109
- return true;
110
- }
111
- peekMax() {
112
- return this.heap[0]?.item;
113
- }
114
- peekMaxPriority() {
115
- return this.heap[0]?.priority ?? Infinity;
116
- }
117
- extractMax() {
118
- if (this.heap.length === 0)
119
- return undefined;
120
- const max = this.heap[0].item;
121
- const last = this.heap.pop();
122
- if (this.heap.length > 0) {
123
- this.heap[0] = last;
124
- this.bubbleDown(0);
125
- }
126
- return max;
127
- }
128
- isEmpty() {
129
- return this.heap.length === 0;
130
- }
131
- toSortedArray() {
132
- return this.heap.slice().sort((a, b) => a.priority - b.priority);
133
- }
134
- bubbleUp(index) {
135
- while (index > 0) {
136
- const parent = Math.floor((index - 1) / 2);
137
- if (this.heap[parent].priority >= this.heap[index].priority)
138
- break;
139
- [this.heap[parent], this.heap[index]] = [this.heap[index], this.heap[parent]];
140
- index = parent;
141
- }
142
- }
143
- bubbleDown(index) {
144
- const length = this.heap.length;
145
- while (true) {
146
- let largest = index;
147
- const left = 2 * index + 1;
148
- const right = 2 * index + 2;
149
- if (left < length && this.heap[left].priority > this.heap[largest].priority) {
150
- largest = left;
151
- }
152
- if (right < length && this.heap[right].priority > this.heap[largest].priority) {
153
- largest = right;
154
- }
155
- if (largest === index)
156
- break;
157
- [this.heap[largest], this.heap[index]] = [this.heap[index], this.heap[largest]];
158
- index = largest;
159
- }
160
- }
161
- }
162
- /**
163
- * HNSW Index implementation for ultra-fast vector similarity search
164
- *
165
- * Performance characteristics:
166
- * - Search: O(log n) approximate nearest neighbor
167
- * - Insert: O(log n) amortized
168
- * - Memory: O(n * M * L) where M is max connections, L is layers
169
- */
170
- export class HNSWIndex extends EventEmitter {
171
- config;
172
- nodes = new Map();
173
- entryPoint = null;
174
- maxLevel = 0;
175
- levelMult;
176
- // Performance tracking
177
- stats = {
178
- searchCount: 0,
179
- totalSearchTime: 0,
180
- insertCount: 0,
181
- totalInsertTime: 0,
182
- buildStartTime: 0,
183
- };
184
- // Quantization support
185
- quantizer = null;
186
- constructor(config = {}) {
187
- super();
188
- this.config = this.mergeConfig(config);
189
- this.levelMult = 1 / Math.log(this.config.M);
190
- if (this.config.quantization) {
191
- this.quantizer = new Quantizer(this.config.quantization, this.config.dimensions);
192
- }
193
- }
194
- /**
195
- * Add a vector to the index
196
- */
197
- async addPoint(id, vector) {
198
- const startTime = performance.now();
199
- if (vector.length !== this.config.dimensions) {
200
- throw new Error(`Vector dimension mismatch: expected ${this.config.dimensions}, got ${vector.length}`);
201
- }
202
- if (this.nodes.size >= this.config.maxElements) {
203
- throw new Error('Index is full, cannot add more elements');
204
- }
205
- // Quantize if enabled
206
- const storedVector = this.quantizer
207
- ? this.quantizer.encode(vector)
208
- : vector;
209
- // Pre-normalize vector for O(1) cosine similarity
210
- const normalizedVector = this.config.metric === 'cosine'
211
- ? this.normalizeVector(storedVector)
212
- : null;
213
- // Generate random level for new node
214
- const level = this.getRandomLevel();
215
- const node = {
216
- id,
217
- vector: storedVector,
218
- normalizedVector,
219
- connections: new Map(),
220
- level,
221
- };
222
- // Initialize connection sets for each layer
223
- for (let l = 0; l <= level; l++) {
224
- node.connections.set(l, new Set());
225
- }
226
- if (this.entryPoint === null) {
227
- // First node
228
- this.entryPoint = id;
229
- this.maxLevel = level;
230
- this.nodes.set(id, node);
231
- }
232
- else {
233
- // Insert new node into the graph
234
- await this.insertNode(node);
235
- }
236
- const duration = performance.now() - startTime;
237
- this.stats.insertCount++;
238
- this.stats.totalInsertTime += duration;
239
- this.emit('point:added', { id, level, duration });
240
- }
241
- /**
242
- * Search for k nearest neighbors
243
- */
244
- async search(query, k, ef) {
245
- const startTime = performance.now();
246
- if (query.length !== this.config.dimensions) {
247
- throw new Error(`Query dimension mismatch: expected ${this.config.dimensions}, got ${query.length}`);
248
- }
249
- if (this.entryPoint === null) {
250
- return [];
251
- }
252
- const searchEf = ef || Math.max(k, this.config.efConstruction);
253
- // Quantize query if needed
254
- const queryVector = this.quantizer
255
- ? this.quantizer.encode(query)
256
- : query;
257
- // Pre-normalize query for O(1) cosine similarity
258
- const normalizedQuery = this.config.metric === 'cosine'
259
- ? this.normalizeVector(queryVector)
260
- : null;
261
- // Start from entry point and search down the layers
262
- let currentNode = this.entryPoint;
263
- let currentDist = this.distanceOptimized(queryVector, normalizedQuery, this.nodes.get(currentNode));
264
- // Search through layers from top to 1
265
- for (let level = this.maxLevel; level > 0; level--) {
266
- const layerResult = this.searchLayerOptimized(queryVector, normalizedQuery, currentNode, 1, level);
267
- currentNode = layerResult[0]?.id || currentNode;
268
- currentDist = this.distanceOptimized(queryVector, normalizedQuery, this.nodes.get(currentNode));
269
- }
270
- // Search layer 0 with ef candidates using heap-based search
271
- const candidates = this.searchLayerOptimized(queryVector, normalizedQuery, currentNode, searchEf, 0);
272
- // Return top k results (already sorted by heap)
273
- const results = candidates.slice(0, k);
274
- const duration = performance.now() - startTime;
275
- this.stats.searchCount++;
276
- this.stats.totalSearchTime += duration;
277
- return results;
278
- }
279
- /**
280
- * Search with filters applied post-retrieval
281
- */
282
- async searchWithFilters(query, k, filter, ef) {
283
- // Over-fetch to account for filtered results
284
- const overFetchFactor = 3;
285
- const candidates = await this.search(query, k * overFetchFactor, ef);
286
- return candidates
287
- .filter((c) => filter(c.id))
288
- .slice(0, k);
289
- }
290
- /**
291
- * Remove a point from the index
292
- */
293
- async removePoint(id) {
294
- const node = this.nodes.get(id);
295
- if (!node) {
296
- return false;
297
- }
298
- // Remove all connections to this node
299
- for (let level = 0; level <= node.level; level++) {
300
- const connections = node.connections.get(level);
301
- if (connections) {
302
- for (const connectedId of connections) {
303
- const connectedNode = this.nodes.get(connectedId);
304
- if (connectedNode) {
305
- connectedNode.connections.get(level)?.delete(id);
306
- }
307
- }
308
- }
309
- }
310
- this.nodes.delete(id);
311
- // Update entry point if needed
312
- if (this.entryPoint === id) {
313
- if (this.nodes.size === 0) {
314
- this.entryPoint = null;
315
- this.maxLevel = 0;
316
- }
317
- else {
318
- // Find new entry point with highest level
319
- let newEntry = null;
320
- let newMaxLevel = 0;
321
- for (const [nodeId, n] of this.nodes) {
322
- if (newEntry === null || n.level > newMaxLevel) {
323
- newMaxLevel = n.level;
324
- newEntry = nodeId;
325
- }
326
- }
327
- this.entryPoint = newEntry;
328
- this.maxLevel = newMaxLevel;
329
- }
330
- }
331
- this.emit('point:removed', { id });
332
- return true;
333
- }
334
- /**
335
- * Rebuild the index from scratch
336
- */
337
- async rebuild(entries) {
338
- this.stats.buildStartTime = performance.now();
339
- this.nodes.clear();
340
- this.entryPoint = null;
341
- this.maxLevel = 0;
342
- for (const entry of entries) {
343
- await this.addPoint(entry.id, entry.vector);
344
- }
345
- const buildTime = performance.now() - this.stats.buildStartTime;
346
- this.emit('index:rebuilt', {
347
- vectorCount: this.nodes.size,
348
- buildTime,
349
- });
350
- }
351
- /**
352
- * Get index statistics
353
- */
354
- getStats() {
355
- const vectorCount = this.nodes.size;
356
- const avgSearchTime = this.stats.searchCount > 0
357
- ? this.stats.totalSearchTime / this.stats.searchCount
358
- : 0;
359
- // Estimate memory usage
360
- const bytesPerVector = this.config.dimensions * 4; // Float32 = 4 bytes
361
- const connectionOverhead = this.config.M * 8 * (this.maxLevel + 1); // Approximate
362
- const memoryUsage = vectorCount * (bytesPerVector + connectionOverhead);
363
- return {
364
- vectorCount,
365
- memoryUsage,
366
- avgSearchTime,
367
- buildTime: performance.now() - this.stats.buildStartTime,
368
- compressionRatio: this.quantizer?.getCompressionRatio() || 1.0,
369
- };
370
- }
371
- /**
372
- * Clear the index
373
- */
374
- clear() {
375
- this.nodes.clear();
376
- this.entryPoint = null;
377
- this.maxLevel = 0;
378
- this.stats = {
379
- searchCount: 0,
380
- totalSearchTime: 0,
381
- insertCount: 0,
382
- totalInsertTime: 0,
383
- buildStartTime: 0,
384
- };
385
- }
386
- /**
387
- * Check if an ID exists in the index
388
- */
389
- has(id) {
390
- return this.nodes.has(id);
391
- }
392
- /**
393
- * Get the number of vectors in the index
394
- */
395
- get size() {
396
- return this.nodes.size;
397
- }
398
- // ===== Private Methods =====
399
- mergeConfig(config) {
400
- return {
401
- dimensions: config.dimensions || 1536, // OpenAI embedding size
402
- M: config.M || 16,
403
- efConstruction: config.efConstruction || 200,
404
- maxElements: config.maxElements || 1000000,
405
- metric: config.metric || 'cosine',
406
- quantization: config.quantization,
407
- };
408
- }
409
- getRandomLevel() {
410
- let level = 0;
411
- while (Math.random() < 0.5 && level < 16) {
412
- level++;
413
- }
414
- return level;
415
- }
416
- async insertNode(node) {
417
- const query = node.vector;
418
- const normalizedQuery = node.normalizedVector;
419
- let currentNode = this.entryPoint;
420
- let currentDist = this.distanceOptimized(query, normalizedQuery, this.nodes.get(currentNode));
421
- // Find entry point for the node's level
422
- for (let level = this.maxLevel; level > node.level; level--) {
423
- const result = this.searchLayerOptimized(query, normalizedQuery, currentNode, 1, level);
424
- if (result.length > 0 && result[0].distance < currentDist) {
425
- currentNode = result[0].id;
426
- currentDist = result[0].distance;
427
- }
428
- }
429
- // Insert at each level from node.level down to 0
430
- for (let level = Math.min(node.level, this.maxLevel); level >= 0; level--) {
431
- const neighbors = this.searchLayerOptimized(query, normalizedQuery, currentNode, this.config.efConstruction, level);
432
- // Select M best neighbors
433
- const selectedNeighbors = this.selectNeighbors(node.id, query, neighbors, this.config.M);
434
- // Add connections
435
- for (const neighbor of selectedNeighbors) {
436
- node.connections.get(level).add(neighbor.id);
437
- this.nodes.get(neighbor.id)?.connections.get(level)?.add(node.id);
438
- // Prune connections if over limit
439
- const neighborNode = this.nodes.get(neighbor.id);
440
- if (neighborNode) {
441
- const neighborConns = neighborNode.connections.get(level);
442
- if (neighborConns.size > this.config.M * 2) {
443
- this.pruneConnections(neighborNode, level, this.config.M);
444
- }
445
- }
446
- }
447
- if (neighbors.length > 0) {
448
- currentNode = neighbors[0].id;
449
- }
450
- }
451
- this.nodes.set(node.id, node);
452
- // Update max level if needed
453
- if (node.level > this.maxLevel) {
454
- this.maxLevel = node.level;
455
- this.entryPoint = node.id;
456
- }
457
- }
458
- async searchLayer(query, entryPoint, ef, level) {
459
- const visited = new Set([entryPoint]);
460
- const candidates = [];
461
- const results = [];
462
- const entryDist = this.distance(query, this.nodes.get(entryPoint).vector);
463
- candidates.push({ id: entryPoint, distance: entryDist });
464
- results.push({ id: entryPoint, distance: entryDist });
465
- while (candidates.length > 0) {
466
- // Get closest candidate
467
- candidates.sort((a, b) => a.distance - b.distance);
468
- const current = candidates.shift();
469
- // Check termination condition
470
- const worstResult = results.length > 0
471
- ? Math.max(...results.map((r) => r.distance))
472
- : Infinity;
473
- if (current.distance > worstResult && results.length >= ef) {
474
- break;
475
- }
476
- // Explore neighbors
477
- const node = this.nodes.get(current.id);
478
- if (!node)
479
- continue;
480
- const connections = node.connections.get(level);
481
- if (!connections)
482
- continue;
483
- for (const neighborId of connections) {
484
- if (visited.has(neighborId))
485
- continue;
486
- visited.add(neighborId);
487
- const neighborNode = this.nodes.get(neighborId);
488
- if (!neighborNode)
489
- continue;
490
- const distance = this.distance(query, neighborNode.vector);
491
- if (results.length < ef || distance < worstResult) {
492
- candidates.push({ id: neighborId, distance });
493
- results.push({ id: neighborId, distance });
494
- // Keep results bounded
495
- if (results.length > ef) {
496
- results.sort((a, b) => a.distance - b.distance);
497
- results.pop();
498
- }
499
- }
500
- }
501
- }
502
- return results.sort((a, b) => a.distance - b.distance);
503
- }
504
- /**
505
- * OPTIMIZED searchLayer using heap-based priority queues
506
- * Performance: O(log n) per operation vs O(n log n) for Array.sort()
507
- * Expected speedup: 3-5x for large result sets
508
- */
509
- searchLayerOptimized(query, normalizedQuery, entryPoint, ef, level) {
510
- const visited = new Set([entryPoint]);
511
- // Min-heap for candidates (closest first for expansion)
512
- const candidates = new BinaryMinHeap();
513
- // Max-heap for results (bounded size, tracks worst distance efficiently)
514
- const results = new BinaryMaxHeap(ef);
515
- const entryNode = this.nodes.get(entryPoint);
516
- const entryDist = this.distanceOptimized(query, normalizedQuery, entryNode);
517
- candidates.insert(entryPoint, entryDist);
518
- results.insert(entryPoint, entryDist);
519
- while (!candidates.isEmpty()) {
520
- // Get closest candidate - O(log n)
521
- const currentDist = candidates.peekPriority();
522
- const currentId = candidates.extractMin();
523
- // Check termination: if closest candidate is worse than worst result, stop
524
- const worstResultDist = results.peekMaxPriority();
525
- if (currentDist > worstResultDist && results.size >= ef) {
526
- break;
527
- }
528
- // Explore neighbors
529
- const node = this.nodes.get(currentId);
530
- if (!node)
531
- continue;
532
- const connections = node.connections.get(level);
533
- if (!connections)
534
- continue;
535
- for (const neighborId of connections) {
536
- if (visited.has(neighborId))
537
- continue;
538
- visited.add(neighborId);
539
- const neighborNode = this.nodes.get(neighborId);
540
- if (!neighborNode)
541
- continue;
542
- const distance = this.distanceOptimized(query, normalizedQuery, neighborNode);
543
- // Only add if within threshold or results not full
544
- if (results.size < ef || distance < worstResultDist) {
545
- candidates.insert(neighborId, distance);
546
- // Max-heap handles size bounding automatically - O(log n)
547
- results.insert(neighborId, distance);
548
- }
549
- }
550
- }
551
- // Return sorted results
552
- return results.toSortedArray().map(({ item, priority }) => ({
553
- id: item,
554
- distance: priority,
555
- }));
556
- }
557
- selectNeighbors(nodeId, query, candidates, M) {
558
- // Simple selection: take M closest
559
- return candidates
560
- .filter((c) => c.id !== nodeId)
561
- .sort((a, b) => a.distance - b.distance)
562
- .slice(0, M);
563
- }
564
- pruneConnections(node, level, maxConnections) {
565
- const connections = node.connections.get(level);
566
- if (!connections || connections.size <= maxConnections)
567
- return;
568
- // Calculate distances to all connections
569
- const distances = [];
570
- for (const connId of connections) {
571
- const connNode = this.nodes.get(connId);
572
- if (connNode) {
573
- distances.push({
574
- id: connId,
575
- distance: this.distance(node.vector, connNode.vector),
576
- });
577
- }
578
- }
579
- // Keep only the closest ones
580
- distances.sort((a, b) => a.distance - b.distance);
581
- const toKeep = new Set(distances.slice(0, maxConnections).map((d) => d.id));
582
- // Remove excess connections
583
- for (const connId of connections) {
584
- if (!toKeep.has(connId)) {
585
- connections.delete(connId);
586
- this.nodes.get(connId)?.connections.get(level)?.delete(node.id);
587
- }
588
- }
589
- }
590
- distance(a, b) {
591
- switch (this.config.metric) {
592
- case 'cosine':
593
- return this.cosineDistance(a, b);
594
- case 'euclidean':
595
- return this.euclideanDistance(a, b);
596
- case 'dot':
597
- return this.dotProductDistance(a, b);
598
- case 'manhattan':
599
- return this.manhattanDistance(a, b);
600
- default:
601
- return this.cosineDistance(a, b);
602
- }
603
- }
604
- cosineDistance(a, b) {
605
- let dotProduct = 0;
606
- let normA = 0;
607
- let normB = 0;
608
- for (let i = 0; i < a.length; i++) {
609
- dotProduct += a[i] * b[i];
610
- normA += a[i] * a[i];
611
- normB += b[i] * b[i];
612
- }
613
- const similarity = dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
614
- return 1 - similarity; // Convert to distance
615
- }
616
- /**
617
- * OPTIMIZED: Cosine distance using pre-normalized vectors
618
- * Only requires dot product (no sqrt operations)
619
- * Performance: O(n) with ~2x speedup over standard cosine
620
- */
621
- cosineDistanceNormalized(a, b) {
622
- let dotProduct = 0;
623
- for (let i = 0; i < a.length; i++) {
624
- dotProduct += a[i] * b[i];
625
- }
626
- // For normalized vectors: cosine_similarity = dot_product
627
- // Return distance (1 - similarity)
628
- return 1 - dotProduct;
629
- }
630
- /**
631
- * Normalize a vector to unit length for O(1) cosine similarity
632
- */
633
- normalizeVector(vector) {
634
- let norm = 0;
635
- for (let i = 0; i < vector.length; i++) {
636
- norm += vector[i] * vector[i];
637
- }
638
- norm = Math.sqrt(norm);
639
- if (norm === 0) {
640
- return vector; // Return as-is if zero vector
641
- }
642
- const normalized = new Float32Array(vector.length);
643
- for (let i = 0; i < vector.length; i++) {
644
- normalized[i] = vector[i] / norm;
645
- }
646
- return normalized;
647
- }
648
- /**
649
- * OPTIMIZED distance calculation that uses pre-normalized vectors when available
650
- */
651
- distanceOptimized(query, normalizedQuery, node) {
652
- // Use optimized path for cosine with pre-normalized vectors
653
- if (this.config.metric === 'cosine' &&
654
- normalizedQuery !== null &&
655
- node.normalizedVector !== null) {
656
- return this.cosineDistanceNormalized(normalizedQuery, node.normalizedVector);
657
- }
658
- // Fall back to standard distance calculation
659
- return this.distance(query, node.vector);
660
- }
661
- euclideanDistance(a, b) {
662
- let sum = 0;
663
- for (let i = 0; i < a.length; i++) {
664
- const diff = a[i] - b[i];
665
- sum += diff * diff;
666
- }
667
- return Math.sqrt(sum);
668
- }
669
- dotProductDistance(a, b) {
670
- let dotProduct = 0;
671
- for (let i = 0; i < a.length; i++) {
672
- dotProduct += a[i] * b[i];
673
- }
674
- // Negative because higher dot product = more similar
675
- return -dotProduct;
676
- }
677
- manhattanDistance(a, b) {
678
- let sum = 0;
679
- for (let i = 0; i < a.length; i++) {
680
- sum += Math.abs(a[i] - b[i]);
681
- }
682
- return sum;
683
- }
684
- }
685
- /**
686
- * Quantizer for vector compression
687
- */
688
- class Quantizer {
689
- config;
690
- dimensions;
691
- constructor(config, dimensions) {
692
- this.config = config;
693
- this.dimensions = dimensions;
694
- }
695
- /**
696
- * Encode a vector using quantization
697
- */
698
- encode(vector) {
699
- switch (this.config.type) {
700
- case 'binary':
701
- return this.binaryQuantize(vector);
702
- case 'scalar':
703
- return this.scalarQuantize(vector);
704
- case 'product':
705
- return this.productQuantize(vector);
706
- default:
707
- return vector;
708
- }
709
- }
710
- /**
711
- * Get compression ratio
712
- */
713
- getCompressionRatio() {
714
- switch (this.config.type) {
715
- case 'binary':
716
- return 32; // 32x compression (32 bits -> 1 bit per dimension)
717
- case 'scalar':
718
- return 32 / (this.config.bits || 8);
719
- case 'product':
720
- return this.config.subquantizers || 8;
721
- default:
722
- return 1;
723
- }
724
- }
725
- binaryQuantize(vector) {
726
- // Simple binary quantization: > 0 becomes 1, <= 0 becomes 0
727
- // Stored in packed format in a smaller Float32Array
728
- const packedLength = Math.ceil(vector.length / 32);
729
- const packed = new Float32Array(packedLength);
730
- for (let i = 0; i < vector.length; i++) {
731
- const packedIndex = Math.floor(i / 32);
732
- const bitPosition = i % 32;
733
- if (vector[i] > 0) {
734
- packed[packedIndex] = (packed[packedIndex] || 0) | (1 << bitPosition);
735
- }
736
- }
737
- return packed;
738
- }
739
- scalarQuantize(vector) {
740
- // Find min/max for normalization
741
- let min = Infinity;
742
- let max = -Infinity;
743
- for (let i = 0; i < vector.length; i++) {
744
- if (vector[i] < min)
745
- min = vector[i];
746
- if (vector[i] > max)
747
- max = vector[i];
748
- }
749
- const range = max - min || 1;
750
- const bits = this.config.bits || 8;
751
- const levels = Math.pow(2, bits);
752
- // Quantize each value
753
- const quantized = new Float32Array(vector.length + 2); // +2 for min/range
754
- quantized[0] = min;
755
- quantized[1] = range;
756
- for (let i = 0; i < vector.length; i++) {
757
- const normalized = (vector[i] - min) / range;
758
- quantized[i + 2] = Math.round(normalized * (levels - 1));
759
- }
760
- return quantized;
761
- }
762
- productQuantize(vector) {
763
- // Simplified product quantization
764
- // In production, would use trained codebooks
765
- const subquantizers = this.config.subquantizers || 8;
766
- const subvectorSize = Math.ceil(vector.length / subquantizers);
767
- const quantized = new Float32Array(subquantizers);
768
- for (let i = 0; i < subquantizers; i++) {
769
- let sum = 0;
770
- const start = i * subvectorSize;
771
- const end = Math.min(start + subvectorSize, vector.length);
772
- for (let j = start; j < end; j++) {
773
- sum += vector[j];
774
- }
775
- quantized[i] = sum / (end - start);
776
- }
777
- return quantized;
778
- }
779
- }
780
- export default HNSWIndex;
781
- //# sourceMappingURL=hnsw-index.js.map