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,609 +0,0 @@
1
- /**
2
- * Tests for MemoryGraph - Knowledge Graph Module
3
- *
4
- * TDD London School (mock-first) tests for graph construction,
5
- * PageRank computation, community detection, and graph-aware ranking.
6
- */
7
- import { describe, it, expect, beforeEach, vi } from 'vitest';
8
- import { MemoryGraph } from './memory-graph.js';
9
- import { createDefaultEntry } from './types.js';
10
- // ===== Test Helpers =====
11
- function makeEntry(id, refs = [], meta) {
12
- const entry = createDefaultEntry({
13
- key: id,
14
- content: `content-${id}`,
15
- references: refs,
16
- metadata: meta,
17
- });
18
- // Override the auto-generated id with a deterministic one for testing
19
- return { ...entry, id };
20
- }
21
- function createMockBackend(entries) {
22
- return {
23
- initialize: vi.fn().mockResolvedValue(undefined),
24
- shutdown: vi.fn().mockResolvedValue(undefined),
25
- store: vi.fn().mockResolvedValue(undefined),
26
- get: vi.fn().mockImplementation(async (id) => {
27
- return entries.find((e) => e.id === id) || null;
28
- }),
29
- getByKey: vi.fn().mockResolvedValue(null),
30
- update: vi.fn().mockImplementation(async (id, _update) => {
31
- return entries.find((e) => e.id === id) || null;
32
- }),
33
- delete: vi.fn().mockResolvedValue(true),
34
- query: vi.fn().mockResolvedValue(entries),
35
- search: vi.fn().mockResolvedValue([]),
36
- bulkInsert: vi.fn().mockResolvedValue(undefined),
37
- bulkDelete: vi.fn().mockResolvedValue(0),
38
- count: vi.fn().mockResolvedValue(entries.length),
39
- listNamespaces: vi.fn().mockResolvedValue(['default']),
40
- clearNamespace: vi.fn().mockResolvedValue(0),
41
- getStats: vi.fn().mockResolvedValue({
42
- totalEntries: entries.length,
43
- entriesByNamespace: {},
44
- entriesByType: {},
45
- memoryUsage: 0,
46
- avgQueryTime: 0,
47
- avgSearchTime: 0,
48
- }),
49
- healthCheck: vi.fn().mockResolvedValue({
50
- status: 'healthy',
51
- components: {
52
- storage: { status: 'healthy', latency: 0 },
53
- index: { status: 'healthy', latency: 0 },
54
- cache: { status: 'healthy', latency: 0 },
55
- },
56
- timestamp: Date.now(),
57
- issues: [],
58
- recommendations: [],
59
- }),
60
- };
61
- }
62
- // ===== Tests =====
63
- describe('MemoryGraph', () => {
64
- let graph;
65
- beforeEach(() => {
66
- graph = new MemoryGraph();
67
- });
68
- // ===== Constructor =====
69
- describe('constructor', () => {
70
- it('should create with default configuration', () => {
71
- const g = new MemoryGraph();
72
- const stats = g.getStats();
73
- expect(stats.nodeCount).toBe(0);
74
- expect(stats.edgeCount).toBe(0);
75
- });
76
- it('should accept custom configuration', () => {
77
- const config = {
78
- pageRankDamping: 0.9,
79
- maxNodes: 100,
80
- similarityThreshold: 0.5,
81
- };
82
- const g = new MemoryGraph(config);
83
- const stats = g.getStats();
84
- expect(stats.nodeCount).toBe(0);
85
- });
86
- });
87
- // ===== addNode / removeNode =====
88
- describe('addNode', () => {
89
- it('should add a node from a MemoryEntry', () => {
90
- const entry = makeEntry('node-1');
91
- graph.addNode(entry);
92
- expect(graph.getStats().nodeCount).toBe(1);
93
- });
94
- it('should extract category from metadata', () => {
95
- const entry = makeEntry('node-1', [], { category: 'security' });
96
- graph.addNode(entry);
97
- // Verify through getTopNodes after computing pagerank
98
- graph.computePageRank();
99
- const top = graph.getTopNodes(1);
100
- expect(top.length).toBe(1);
101
- expect(top[0].id).toBe('node-1');
102
- });
103
- it('should ignore when at maxNodes capacity', () => {
104
- const g = new MemoryGraph({ maxNodes: 2 });
105
- g.addNode(makeEntry('a'));
106
- g.addNode(makeEntry('b'));
107
- g.addNode(makeEntry('c'));
108
- expect(g.getStats().nodeCount).toBe(2);
109
- });
110
- it('should allow re-adding an existing node without counting toward capacity', () => {
111
- const g = new MemoryGraph({ maxNodes: 2 });
112
- g.addNode(makeEntry('a'));
113
- g.addNode(makeEntry('b'));
114
- // Re-add existing node should succeed
115
- g.addNode(makeEntry('a'));
116
- expect(g.getStats().nodeCount).toBe(2);
117
- });
118
- it('should mark graph as dirty', () => {
119
- graph.addNode(makeEntry('node-1'));
120
- expect(graph.getStats().pageRankComputed).toBe(false);
121
- });
122
- });
123
- describe('removeNode', () => {
124
- it('should remove a node and clean up edges', () => {
125
- const a = makeEntry('a');
126
- const b = makeEntry('b');
127
- graph.addNode(a);
128
- graph.addNode(b);
129
- graph.addEdge('a', 'b', 'reference');
130
- expect(graph.getStats().edgeCount).toBe(1);
131
- graph.removeNode('a');
132
- expect(graph.getStats().nodeCount).toBe(1);
133
- expect(graph.getStats().edgeCount).toBe(0);
134
- });
135
- it('should remove incoming edges to the deleted node', () => {
136
- graph.addNode(makeEntry('a'));
137
- graph.addNode(makeEntry('b'));
138
- graph.addNode(makeEntry('c'));
139
- graph.addEdge('a', 'b', 'reference');
140
- graph.addEdge('c', 'b', 'reference');
141
- expect(graph.getStats().edgeCount).toBe(2);
142
- graph.removeNode('b');
143
- expect(graph.getStats().edgeCount).toBe(0);
144
- });
145
- it('should handle removing a non-existent node gracefully', () => {
146
- expect(() => graph.removeNode('does-not-exist')).not.toThrow();
147
- });
148
- it('should clean up pageRank and community entries', () => {
149
- graph.addNode(makeEntry('a'));
150
- graph.computePageRank();
151
- graph.detectCommunities();
152
- graph.removeNode('a');
153
- const top = graph.getTopNodes(10);
154
- expect(top.length).toBe(0);
155
- });
156
- });
157
- // ===== addEdge =====
158
- describe('addEdge', () => {
159
- beforeEach(() => {
160
- graph.addNode(makeEntry('a'));
161
- graph.addNode(makeEntry('b'));
162
- graph.addNode(makeEntry('c'));
163
- });
164
- it('should add an edge between existing nodes', () => {
165
- graph.addEdge('a', 'b', 'reference');
166
- expect(graph.getStats().edgeCount).toBe(1);
167
- });
168
- it('should update weight to max when edge already exists', () => {
169
- graph.addEdge('a', 'b', 'reference', 0.5);
170
- graph.addEdge('a', 'b', 'reference', 0.8);
171
- expect(graph.getStats().edgeCount).toBe(1);
172
- // The weight should now be 0.8 (max of 0.5 and 0.8)
173
- });
174
- it('should not downgrade weight when adding with lower value', () => {
175
- graph.addEdge('a', 'b', 'reference', 0.9);
176
- graph.addEdge('a', 'b', 'reference', 0.3);
177
- // Edge count should remain 1 (updated, not duplicated)
178
- expect(graph.getStats().edgeCount).toBe(1);
179
- });
180
- it('should skip when source node is missing', () => {
181
- graph.addEdge('missing', 'b', 'reference');
182
- expect(graph.getStats().edgeCount).toBe(0);
183
- });
184
- it('should skip when target node is missing', () => {
185
- graph.addEdge('a', 'missing', 'reference');
186
- expect(graph.getStats().edgeCount).toBe(0);
187
- });
188
- it('should create reverse edge entry', () => {
189
- graph.addEdge('a', 'b', 'reference');
190
- // Verify via getNeighbors traversal (reverse edges are used internally)
191
- // If we remove 'a', 'b' should lose its incoming edge
192
- graph.removeNode('a');
193
- expect(graph.getStats().edgeCount).toBe(0);
194
- });
195
- it('should support multiple edge types', () => {
196
- graph.addEdge('a', 'b', 'reference');
197
- graph.addEdge('a', 'c', 'similar', 0.9);
198
- expect(graph.getStats().edgeCount).toBe(2);
199
- });
200
- });
201
- // ===== buildFromBackend =====
202
- describe('buildFromBackend', () => {
203
- it('should build graph from backend entries with references', async () => {
204
- const entries = [
205
- makeEntry('a', ['b', 'c']),
206
- makeEntry('b', ['c']),
207
- makeEntry('c', []),
208
- ];
209
- const backend = createMockBackend(entries);
210
- await graph.buildFromBackend(backend);
211
- expect(graph.getStats().nodeCount).toBe(3);
212
- // a->b, a->c, b->c = 3 edges
213
- expect(graph.getStats().edgeCount).toBe(3);
214
- });
215
- it('should handle an empty backend', async () => {
216
- const backend = createMockBackend([]);
217
- await graph.buildFromBackend(backend);
218
- expect(graph.getStats().nodeCount).toBe(0);
219
- expect(graph.getStats().edgeCount).toBe(0);
220
- });
221
- it('should respect maxNodes limit', async () => {
222
- const g = new MemoryGraph({ maxNodes: 2 });
223
- const entries = [makeEntry('a'), makeEntry('b'), makeEntry('c')];
224
- const backend = createMockBackend(entries);
225
- await g.buildFromBackend(backend);
226
- expect(g.getStats().nodeCount).toBe(2);
227
- });
228
- it('should skip reference edges to nodes not in graph', async () => {
229
- // 'a' references 'z' which is not in the entries
230
- const entries = [makeEntry('a', ['z']), makeEntry('b', [])];
231
- const backend = createMockBackend(entries);
232
- await graph.buildFromBackend(backend);
233
- expect(graph.getStats().nodeCount).toBe(2);
234
- // a->z should be skipped because 'z' is not a node
235
- expect(graph.getStats().edgeCount).toBe(0);
236
- });
237
- it('should emit graph:built event', async () => {
238
- const handler = vi.fn();
239
- graph.on('graph:built', handler);
240
- const backend = createMockBackend([makeEntry('a')]);
241
- await graph.buildFromBackend(backend);
242
- expect(handler).toHaveBeenCalledWith({ nodeCount: 1 });
243
- });
244
- });
245
- // ===== computePageRank =====
246
- describe('computePageRank', () => {
247
- it('should return empty map for empty graph', () => {
248
- const ranks = graph.computePageRank();
249
- expect(ranks.size).toBe(0);
250
- });
251
- it('should compute rank of 1.0 for a single node', () => {
252
- graph.addNode(makeEntry('a'));
253
- const ranks = graph.computePageRank();
254
- expect(ranks.size).toBe(1);
255
- expect(ranks.get('a')).toBeCloseTo(1.0, 5);
256
- });
257
- it('should converge for two connected nodes', () => {
258
- graph.addNode(makeEntry('a'));
259
- graph.addNode(makeEntry('b'));
260
- graph.addEdge('a', 'b', 'reference');
261
- const ranks = graph.computePageRank();
262
- expect(ranks.size).toBe(2);
263
- // Both should have positive values that sum close to 1
264
- const total = (ranks.get('a') || 0) + (ranks.get('b') || 0);
265
- expect(total).toBeCloseTo(1.0, 2);
266
- });
267
- it('should give higher rank to node with more incoming edges', () => {
268
- graph.addNode(makeEntry('a'));
269
- graph.addNode(makeEntry('b'));
270
- graph.addNode(makeEntry('c'));
271
- graph.addEdge('a', 'c', 'reference');
272
- graph.addEdge('b', 'c', 'reference');
273
- const ranks = graph.computePageRank();
274
- const rankC = ranks.get('c') || 0;
275
- const rankA = ranks.get('a') || 0;
276
- const rankB = ranks.get('b') || 0;
277
- expect(rankC).toBeGreaterThan(rankA);
278
- expect(rankC).toBeGreaterThan(rankB);
279
- });
280
- it('should respect damping factor', () => {
281
- const g = new MemoryGraph({ pageRankDamping: 0.5 });
282
- g.addNode(makeEntry('a'));
283
- g.addNode(makeEntry('b'));
284
- g.addEdge('a', 'b', 'reference');
285
- const ranks = g.computePageRank();
286
- // With damping 0.5, the influence of links is reduced
287
- expect(ranks.get('a')).toBeDefined();
288
- expect(ranks.get('b')).toBeDefined();
289
- });
290
- it('should converge within maxIterations', () => {
291
- const handler = vi.fn();
292
- graph.on('pagerank:computed', handler);
293
- graph.addNode(makeEntry('a'));
294
- graph.addNode(makeEntry('b'));
295
- graph.addEdge('a', 'b', 'reference');
296
- graph.computePageRank();
297
- expect(handler).toHaveBeenCalledTimes(1);
298
- const { iterations } = handler.mock.calls[0][0];
299
- expect(iterations).toBeLessThanOrEqual(50);
300
- expect(iterations).toBeGreaterThan(0);
301
- });
302
- it('should handle disconnected components', () => {
303
- graph.addNode(makeEntry('a'));
304
- graph.addNode(makeEntry('b'));
305
- graph.addNode(makeEntry('c'));
306
- graph.addNode(makeEntry('d'));
307
- graph.addEdge('a', 'b', 'reference');
308
- graph.addEdge('c', 'd', 'reference');
309
- const ranks = graph.computePageRank();
310
- expect(ranks.size).toBe(4);
311
- // Each component should have similar rank distribution
312
- const total = [...ranks.values()].reduce((s, v) => s + v, 0);
313
- expect(total).toBeCloseTo(1.0, 2);
314
- });
315
- it('should mark graph as not dirty after computation', () => {
316
- graph.addNode(makeEntry('a'));
317
- expect(graph.getStats().pageRankComputed).toBe(false);
318
- graph.computePageRank();
319
- expect(graph.getStats().pageRankComputed).toBe(true);
320
- });
321
- it('should emit pagerank:computed event', () => {
322
- const handler = vi.fn();
323
- graph.on('pagerank:computed', handler);
324
- graph.computePageRank();
325
- expect(handler).toHaveBeenCalledTimes(1);
326
- });
327
- });
328
- // ===== detectCommunities =====
329
- describe('detectCommunities', () => {
330
- it('should assign isolated nodes to individual communities', () => {
331
- graph.addNode(makeEntry('a'));
332
- graph.addNode(makeEntry('b'));
333
- graph.addNode(makeEntry('c'));
334
- const communities = graph.detectCommunities();
335
- const unique = new Set(communities.values());
336
- expect(unique.size).toBe(3);
337
- });
338
- it('should group connected nodes into the same community', () => {
339
- graph.addNode(makeEntry('a'));
340
- graph.addNode(makeEntry('b'));
341
- graph.addEdge('a', 'b', 'reference');
342
- graph.addEdge('b', 'a', 'reference');
343
- const communities = graph.detectCommunities();
344
- // With bidirectional edges, they should converge
345
- expect(communities.get('a')).toBe(communities.get('b'));
346
- });
347
- it('should detect two disconnected clusters', () => {
348
- // Cluster 1: a <-> b
349
- graph.addNode(makeEntry('a'));
350
- graph.addNode(makeEntry('b'));
351
- graph.addEdge('a', 'b', 'reference');
352
- graph.addEdge('b', 'a', 'reference');
353
- // Cluster 2: c <-> d
354
- graph.addNode(makeEntry('c'));
355
- graph.addNode(makeEntry('d'));
356
- graph.addEdge('c', 'd', 'reference');
357
- graph.addEdge('d', 'c', 'reference');
358
- const communities = graph.detectCommunities();
359
- expect(communities.get('a')).toBe(communities.get('b'));
360
- expect(communities.get('c')).toBe(communities.get('d'));
361
- expect(communities.get('a')).not.toBe(communities.get('c'));
362
- });
363
- it('should emit communities:detected event', () => {
364
- const handler = vi.fn();
365
- graph.on('communities:detected', handler);
366
- graph.addNode(makeEntry('a'));
367
- graph.detectCommunities();
368
- expect(handler).toHaveBeenCalledTimes(1);
369
- expect(handler.mock.calls[0][0].communityCount).toBe(1);
370
- });
371
- it('should handle empty graph', () => {
372
- const communities = graph.detectCommunities();
373
- expect(communities.size).toBe(0);
374
- });
375
- });
376
- // ===== rankWithGraph =====
377
- describe('rankWithGraph', () => {
378
- it('should blend vector score and pagerank', () => {
379
- graph.addNode(makeEntry('a'));
380
- graph.addNode(makeEntry('b'));
381
- graph.addNode(makeEntry('c'));
382
- graph.addEdge('a', 'c', 'reference');
383
- graph.addEdge('b', 'c', 'reference');
384
- const searchResults = [
385
- { entry: makeEntry('a'), score: 0.9, distance: 0.1 },
386
- { entry: makeEntry('c'), score: 0.7, distance: 0.3 },
387
- ];
388
- const ranked = graph.rankWithGraph(searchResults);
389
- expect(ranked.length).toBe(2);
390
- // Each result should have all fields
391
- expect(ranked[0].score).toBeDefined();
392
- expect(ranked[0].pageRank).toBeDefined();
393
- expect(ranked[0].combinedScore).toBeDefined();
394
- });
395
- it('should respect alpha parameter', () => {
396
- graph.addNode(makeEntry('a'));
397
- graph.addNode(makeEntry('b'));
398
- graph.addEdge('a', 'b', 'reference');
399
- const results = [
400
- { entry: makeEntry('a'), score: 0.5, distance: 0.5 },
401
- { entry: makeEntry('b'), score: 0.5, distance: 0.5 },
402
- ];
403
- // With alpha=1.0, only vector score matters
404
- const ranked1 = graph.rankWithGraph(results, 1.0);
405
- expect(ranked1[0].combinedScore).toBeCloseTo(0.5, 3);
406
- // With alpha=0.0, only pagerank matters
407
- const ranked0 = graph.rankWithGraph(results, 0.0);
408
- // Node b has an incoming edge so should rank higher
409
- expect(ranked0[0].entry.id).toBe('b');
410
- });
411
- it('should handle entries not in graph', () => {
412
- graph.addNode(makeEntry('a'));
413
- graph.computePageRank();
414
- const results = [
415
- { entry: makeEntry('a'), score: 0.8, distance: 0.2 },
416
- { entry: makeEntry('unknown'), score: 0.9, distance: 0.1 },
417
- ];
418
- const ranked = graph.rankWithGraph(results);
419
- expect(ranked.length).toBe(2);
420
- // Unknown entry should have pageRank of 0
421
- const unknownResult = ranked.find((r) => r.entry.id === 'unknown');
422
- expect(unknownResult?.pageRank).toBe(0);
423
- });
424
- it('should sort results by combinedScore descending', () => {
425
- graph.addNode(makeEntry('a'));
426
- graph.addNode(makeEntry('b'));
427
- graph.addNode(makeEntry('c'));
428
- graph.addEdge('a', 'c', 'reference');
429
- graph.addEdge('b', 'c', 'reference');
430
- const results = [
431
- { entry: makeEntry('a'), score: 0.5, distance: 0.5 },
432
- { entry: makeEntry('b'), score: 0.5, distance: 0.5 },
433
- { entry: makeEntry('c'), score: 0.5, distance: 0.5 },
434
- ];
435
- const ranked = graph.rankWithGraph(results, 0.5);
436
- for (let i = 0; i < ranked.length - 1; i++) {
437
- expect(ranked[i].combinedScore).toBeGreaterThanOrEqual(ranked[i + 1].combinedScore);
438
- }
439
- });
440
- it('should include community info when communities are detected', () => {
441
- graph.addNode(makeEntry('a'));
442
- graph.addNode(makeEntry('b'));
443
- graph.addEdge('a', 'b', 'reference');
444
- graph.detectCommunities();
445
- const results = [
446
- { entry: makeEntry('a'), score: 0.8, distance: 0.2 },
447
- ];
448
- const ranked = graph.rankWithGraph(results);
449
- expect(ranked[0].community).toBeDefined();
450
- });
451
- });
452
- // ===== getTopNodes =====
453
- describe('getTopNodes', () => {
454
- it('should return top N nodes by pageRank', () => {
455
- graph.addNode(makeEntry('a'));
456
- graph.addNode(makeEntry('b'));
457
- graph.addNode(makeEntry('c'));
458
- graph.addEdge('a', 'c', 'reference');
459
- graph.addEdge('b', 'c', 'reference');
460
- const top = graph.getTopNodes(1);
461
- expect(top.length).toBe(1);
462
- expect(top[0].id).toBe('c');
463
- });
464
- it('should handle requesting more nodes than available', () => {
465
- graph.addNode(makeEntry('a'));
466
- graph.addNode(makeEntry('b'));
467
- const top = graph.getTopNodes(10);
468
- expect(top.length).toBe(2);
469
- });
470
- it('should return empty array for empty graph', () => {
471
- const top = graph.getTopNodes(5);
472
- expect(top.length).toBe(0);
473
- });
474
- it('should include community label', () => {
475
- graph.addNode(makeEntry('a'));
476
- graph.detectCommunities();
477
- const top = graph.getTopNodes(1);
478
- expect(top[0].community).toBeDefined();
479
- });
480
- });
481
- // ===== getNeighbors =====
482
- describe('getNeighbors', () => {
483
- beforeEach(() => {
484
- graph.addNode(makeEntry('a'));
485
- graph.addNode(makeEntry('b'));
486
- graph.addNode(makeEntry('c'));
487
- graph.addNode(makeEntry('d'));
488
- graph.addEdge('a', 'b', 'reference');
489
- graph.addEdge('b', 'c', 'reference');
490
- graph.addEdge('c', 'd', 'reference');
491
- });
492
- it('should return direct neighbors at depth 1', () => {
493
- const neighbors = graph.getNeighbors('a', 1);
494
- expect(neighbors.size).toBe(1);
495
- expect(neighbors.has('b')).toBe(true);
496
- });
497
- it('should return extended neighbors at depth 2', () => {
498
- const neighbors = graph.getNeighbors('a', 2);
499
- expect(neighbors.size).toBe(2);
500
- expect(neighbors.has('b')).toBe(true);
501
- expect(neighbors.has('c')).toBe(true);
502
- });
503
- it('should return all reachable nodes at depth 3', () => {
504
- const neighbors = graph.getNeighbors('a', 3);
505
- expect(neighbors.size).toBe(3);
506
- expect(neighbors.has('b')).toBe(true);
507
- expect(neighbors.has('c')).toBe(true);
508
- expect(neighbors.has('d')).toBe(true);
509
- });
510
- it('should handle node with no neighbors', () => {
511
- const neighbors = graph.getNeighbors('d', 1);
512
- expect(neighbors.size).toBe(0);
513
- });
514
- it('should not include the start node in results', () => {
515
- const neighbors = graph.getNeighbors('a', 10);
516
- expect(neighbors.has('a')).toBe(false);
517
- });
518
- it('should default to depth 1', () => {
519
- const neighbors = graph.getNeighbors('a');
520
- expect(neighbors.size).toBe(1);
521
- expect(neighbors.has('b')).toBe(true);
522
- });
523
- });
524
- // ===== addSimilarityEdges =====
525
- describe('addSimilarityEdges', () => {
526
- it('should add edges for similar entries above threshold', async () => {
527
- const embedding = new Float32Array([1, 0, 0]);
528
- const entryA = { ...makeEntry('a'), embedding };
529
- const entryB = makeEntry('b');
530
- graph.addNode(entryA);
531
- graph.addNode(entryB);
532
- const searchResults = [
533
- { entry: entryB, score: 0.9, distance: 0.1 },
534
- ];
535
- const backend = createMockBackend([entryA, entryB]);
536
- backend.search.mockResolvedValue(searchResults);
537
- const added = await graph.addSimilarityEdges(backend, 'a');
538
- expect(added).toBe(1);
539
- expect(graph.getStats().edgeCount).toBe(1);
540
- });
541
- it('should return 0 if entry has no embedding', async () => {
542
- const entry = makeEntry('a');
543
- graph.addNode(entry);
544
- const backend = createMockBackend([entry]);
545
- const added = await graph.addSimilarityEdges(backend, 'a');
546
- expect(added).toBe(0);
547
- });
548
- it('should return 0 if entry does not exist', async () => {
549
- const backend = createMockBackend([]);
550
- const added = await graph.addSimilarityEdges(backend, 'missing');
551
- expect(added).toBe(0);
552
- });
553
- it('should skip self-references in search results', async () => {
554
- const embedding = new Float32Array([1, 0, 0]);
555
- const entryA = { ...makeEntry('a'), embedding };
556
- graph.addNode(entryA);
557
- const searchResults = [
558
- { entry: entryA, score: 1.0, distance: 0.0 },
559
- ];
560
- const backend = createMockBackend([entryA]);
561
- backend.search.mockResolvedValue(searchResults);
562
- const added = await graph.addSimilarityEdges(backend, 'a');
563
- expect(added).toBe(0);
564
- });
565
- });
566
- // ===== getStats =====
567
- describe('getStats', () => {
568
- it('should return correct initial stats', () => {
569
- const stats = graph.getStats();
570
- expect(stats.nodeCount).toBe(0);
571
- expect(stats.edgeCount).toBe(0);
572
- expect(stats.avgDegree).toBe(0);
573
- expect(stats.communityCount).toBe(0);
574
- expect(stats.pageRankComputed).toBe(false);
575
- expect(stats.maxPageRank).toBe(0);
576
- expect(stats.minPageRank).toBe(0);
577
- });
578
- it('should reflect graph state after adding nodes and edges', () => {
579
- graph.addNode(makeEntry('a'));
580
- graph.addNode(makeEntry('b'));
581
- graph.addNode(makeEntry('c'));
582
- graph.addEdge('a', 'b', 'reference');
583
- graph.addEdge('a', 'c', 'reference');
584
- const stats = graph.getStats();
585
- expect(stats.nodeCount).toBe(3);
586
- expect(stats.edgeCount).toBe(2);
587
- expect(stats.avgDegree).toBeCloseTo(2 / 3, 5);
588
- });
589
- it('should report pageRank min/max after computation', () => {
590
- graph.addNode(makeEntry('a'));
591
- graph.addNode(makeEntry('b'));
592
- graph.addEdge('a', 'b', 'reference');
593
- graph.computePageRank();
594
- const stats = graph.getStats();
595
- expect(stats.pageRankComputed).toBe(true);
596
- expect(stats.maxPageRank).toBeGreaterThan(0);
597
- expect(stats.minPageRank).toBeGreaterThan(0);
598
- expect(stats.maxPageRank).toBeGreaterThanOrEqual(stats.minPageRank);
599
- });
600
- it('should count communities after detection', () => {
601
- graph.addNode(makeEntry('a'));
602
- graph.addNode(makeEntry('b'));
603
- graph.detectCommunities();
604
- const stats = graph.getStats();
605
- expect(stats.communityCount).toBe(2);
606
- });
607
- });
608
- });
609
- //# sourceMappingURL=memory-graph.test.js.map
@@ -1,68 +0,0 @@
1
- /**
2
- * V3 Memory Migration Utility
3
- *
4
- * Migrates data from legacy memory systems (SQLite, Markdown, JSON, etc.)
5
- * to the unified AgentDB-backed memory system with HNSW indexing.
6
- *
7
- * @module v3/memory/migration
8
- */
9
- import { EventEmitter } from 'node:events';
10
- import { MigrationConfig, MigrationProgress, MigrationResult, MigrationSource, EmbeddingGenerator } from './types.js';
11
- import { AgentDBAdapter } from './agentdb-adapter.js';
12
- /**
13
- * Memory Migration Manager
14
- *
15
- * Handles migration from:
16
- * - SQLite backends (.db files)
17
- * - Markdown backends (.md files)
18
- * - JSON memory stores (.json files)
19
- * - MemoryManager instances
20
- * - SwarmMemory instances
21
- * - DistributedMemory instances
22
- */
23
- export declare class MemoryMigrator extends EventEmitter {
24
- private config;
25
- private target;
26
- private embeddingGenerator?;
27
- private progress;
28
- constructor(target: AgentDBAdapter, config: Partial<MigrationConfig>, embeddingGenerator?: EmbeddingGenerator);
29
- /**
30
- * Run the migration
31
- */
32
- migrate(): Promise<MigrationResult>;
33
- /**
34
- * Get current migration progress
35
- */
36
- getProgress(): MigrationProgress;
37
- private loadFromSource;
38
- private loadFromSQLite;
39
- private loadFromMarkdown;
40
- private loadFromJSON;
41
- private loadFromMemoryManager;
42
- private loadFromSwarmMemory;
43
- private loadFromDistributedMemory;
44
- private processBatch;
45
- private transformEntry;
46
- private initializeProgress;
47
- private validateEntry;
48
- private addError;
49
- private parseTimestamp;
50
- private isValidMemoryType;
51
- private estimateTimeRemaining;
52
- private generateSummary;
53
- private walkDirectory;
54
- private parseMarkdownEntry;
55
- }
56
- /**
57
- * Convenience function to create a migrator
58
- */
59
- export declare function createMigrator(target: AgentDBAdapter, source: MigrationSource, sourcePath: string, options?: Partial<MigrationConfig>, embeddingGenerator?: EmbeddingGenerator): MemoryMigrator;
60
- /**
61
- * Migrate from multiple sources
62
- */
63
- export declare function migrateMultipleSources(target: AgentDBAdapter, sources: Array<{
64
- source: MigrationSource;
65
- path: string;
66
- }>, options?: Partial<MigrationConfig>, embeddingGenerator?: EmbeddingGenerator): Promise<MigrationResult[]>;
67
- export default MemoryMigrator;
68
- //# sourceMappingURL=migration.d.ts.map