moflo 4.8.16 → 4.8.17

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 (466) 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/hook-handler.cjs +83 -83
  119. package/bin/hooks.mjs +656 -656
  120. package/bin/index-guidance.mjs +892 -892
  121. package/bin/index-tests.mjs +709 -709
  122. package/bin/lib/process-manager.mjs +243 -243
  123. package/bin/lib/registry-cleanup.cjs +41 -41
  124. package/bin/prompt-hook.mjs +72 -72
  125. package/bin/semantic-search.mjs +472 -472
  126. package/bin/session-start-launcher.mjs +238 -226
  127. package/bin/setup-project.mjs +250 -250
  128. package/package.json +123 -121
  129. package/src/@claude-flow/cli/README.md +452 -452
  130. package/src/@claude-flow/cli/bin/cli.js +175 -175
  131. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  132. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  133. package/src/@claude-flow/cli/dist/src/commands/doctor.js +1091 -1091
  134. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  135. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  136. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  137. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  138. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  139. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  140. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +91 -91
  141. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  142. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -43
  143. package/src/@claude-flow/cli/dist/src/init/executor.js +485 -453
  144. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  145. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  146. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +839 -839
  147. package/src/@claude-flow/cli/dist/src/init/settings-generator.js +6 -2
  148. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +786 -786
  149. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  150. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  151. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  152. package/src/@claude-flow/cli/package.json +1 -1
  153. package/src/@claude-flow/guidance/README.md +1195 -1195
  154. package/src/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
  155. package/src/@claude-flow/guidance/dist/adversarial.js +572 -0
  156. package/src/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
  157. package/src/@claude-flow/guidance/dist/analyzer.js +2518 -0
  158. package/src/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
  159. package/src/@claude-flow/guidance/dist/artifacts.js +356 -0
  160. package/src/@claude-flow/guidance/dist/authority.d.ts +290 -0
  161. package/src/@claude-flow/guidance/dist/authority.js +558 -0
  162. package/src/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
  163. package/src/@claude-flow/guidance/dist/capabilities.js +485 -0
  164. package/src/@claude-flow/guidance/dist/coherence.d.ts +233 -0
  165. package/src/@claude-flow/guidance/dist/coherence.js +372 -0
  166. package/src/@claude-flow/guidance/dist/compiler.d.ts +87 -0
  167. package/src/@claude-flow/guidance/dist/compiler.js +419 -0
  168. package/src/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
  169. package/src/@claude-flow/guidance/dist/conformance-kit.js +629 -0
  170. package/src/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
  171. package/src/@claude-flow/guidance/dist/continue-gate.js +353 -0
  172. package/src/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
  173. package/src/@claude-flow/guidance/dist/crypto-utils.js +24 -0
  174. package/src/@claude-flow/guidance/dist/evolution.d.ts +282 -0
  175. package/src/@claude-flow/guidance/dist/evolution.js +500 -0
  176. package/src/@claude-flow/guidance/dist/gates.d.ts +79 -0
  177. package/src/@claude-flow/guidance/dist/gates.js +302 -0
  178. package/src/@claude-flow/guidance/dist/gateway.d.ts +206 -0
  179. package/src/@claude-flow/guidance/dist/gateway.js +452 -0
  180. package/src/@claude-flow/guidance/dist/generators.d.ts +153 -0
  181. package/src/@claude-flow/guidance/dist/generators.js +682 -0
  182. package/src/@claude-flow/guidance/dist/headless.d.ts +177 -0
  183. package/src/@claude-flow/guidance/dist/headless.js +342 -0
  184. package/src/@claude-flow/guidance/dist/hooks.d.ts +109 -0
  185. package/src/@claude-flow/guidance/dist/hooks.js +347 -0
  186. package/src/@claude-flow/guidance/dist/index.d.ts +205 -0
  187. package/src/@claude-flow/guidance/dist/index.js +321 -0
  188. package/src/@claude-flow/guidance/dist/ledger.d.ts +162 -0
  189. package/src/@claude-flow/guidance/dist/ledger.js +375 -0
  190. package/src/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
  191. package/src/@claude-flow/guidance/dist/manifest-validator.js +838 -0
  192. package/src/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
  193. package/src/@claude-flow/guidance/dist/memory-gate.js +382 -0
  194. package/src/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
  195. package/src/@claude-flow/guidance/dist/meta-governance.js +348 -0
  196. package/src/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
  197. package/src/@claude-flow/guidance/dist/optimizer.js +329 -0
  198. package/src/@claude-flow/guidance/dist/persistence.d.ts +189 -0
  199. package/src/@claude-flow/guidance/dist/persistence.js +464 -0
  200. package/src/@claude-flow/guidance/dist/proof.d.ts +185 -0
  201. package/src/@claude-flow/guidance/dist/proof.js +238 -0
  202. package/src/@claude-flow/guidance/dist/retriever.d.ts +116 -0
  203. package/src/@claude-flow/guidance/dist/retriever.js +394 -0
  204. package/src/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
  205. package/src/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
  206. package/src/@claude-flow/guidance/dist/temporal.d.ts +426 -0
  207. package/src/@claude-flow/guidance/dist/temporal.js +658 -0
  208. package/src/@claude-flow/guidance/dist/trust.d.ts +283 -0
  209. package/src/@claude-flow/guidance/dist/trust.js +473 -0
  210. package/src/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
  211. package/src/@claude-flow/guidance/dist/truth-anchors.js +488 -0
  212. package/src/@claude-flow/guidance/dist/types.d.ts +378 -0
  213. package/src/@claude-flow/guidance/dist/types.js +10 -0
  214. package/src/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
  215. package/src/@claude-flow/guidance/dist/uncertainty.js +619 -0
  216. package/src/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
  217. package/src/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
  218. package/src/@claude-flow/guidance/package.json +198 -198
  219. package/src/@claude-flow/memory/README.md +587 -587
  220. package/src/@claude-flow/memory/package.json +44 -44
  221. package/src/@claude-flow/shared/README.md +323 -323
  222. package/src/README.md +493 -493
  223. package/.claude/settings.local.json +0 -18
  224. package/.claude/workflow-state.json +0 -9
  225. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +0 -197
  226. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +0 -584
  227. package/src/@claude-flow/memory/dist/agent-memory-scope.d.ts +0 -131
  228. package/src/@claude-flow/memory/dist/agent-memory-scope.js +0 -223
  229. package/src/@claude-flow/memory/dist/agent-memory-scope.test.d.ts +0 -8
  230. package/src/@claude-flow/memory/dist/agent-memory-scope.test.js +0 -463
  231. package/src/@claude-flow/memory/dist/agentdb-adapter.d.ts +0 -165
  232. package/src/@claude-flow/memory/dist/agentdb-adapter.js +0 -806
  233. package/src/@claude-flow/memory/dist/agentdb-backend.d.ts +0 -214
  234. package/src/@claude-flow/memory/dist/agentdb-backend.js +0 -844
  235. package/src/@claude-flow/memory/dist/agentdb-backend.test.d.ts +0 -7
  236. package/src/@claude-flow/memory/dist/agentdb-backend.test.js +0 -258
  237. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.d.ts +0 -65
  238. package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.js +0 -129
  239. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.d.ts +0 -48
  240. package/src/@claude-flow/memory/dist/application/commands/store-memory.command.js +0 -72
  241. package/src/@claude-flow/memory/dist/application/index.d.ts +0 -12
  242. package/src/@claude-flow/memory/dist/application/index.js +0 -15
  243. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.d.ts +0 -72
  244. package/src/@claude-flow/memory/dist/application/queries/search-memory.query.js +0 -143
  245. package/src/@claude-flow/memory/dist/application/services/memory-application-service.d.ts +0 -121
  246. package/src/@claude-flow/memory/dist/application/services/memory-application-service.js +0 -190
  247. package/src/@claude-flow/memory/dist/auto-memory-bridge.d.ts +0 -226
  248. package/src/@claude-flow/memory/dist/auto-memory-bridge.js +0 -709
  249. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.d.ts +0 -8
  250. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +0 -754
  251. package/src/@claude-flow/memory/dist/benchmark.test.d.ts +0 -2
  252. package/src/@claude-flow/memory/dist/benchmark.test.js +0 -277
  253. package/src/@claude-flow/memory/dist/cache-manager.d.ts +0 -134
  254. package/src/@claude-flow/memory/dist/cache-manager.js +0 -407
  255. package/src/@claude-flow/memory/dist/controller-registry.d.ts +0 -216
  256. package/src/@claude-flow/memory/dist/controller-registry.js +0 -893
  257. package/src/@claude-flow/memory/dist/controller-registry.test.d.ts +0 -14
  258. package/src/@claude-flow/memory/dist/controller-registry.test.js +0 -636
  259. package/src/@claude-flow/memory/dist/database-provider.d.ts +0 -87
  260. package/src/@claude-flow/memory/dist/database-provider.js +0 -375
  261. package/src/@claude-flow/memory/dist/database-provider.test.d.ts +0 -7
  262. package/src/@claude-flow/memory/dist/database-provider.test.js +0 -285
  263. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.d.ts +0 -143
  264. package/src/@claude-flow/memory/dist/domain/entities/memory-entry.js +0 -226
  265. package/src/@claude-flow/memory/dist/domain/index.d.ts +0 -11
  266. package/src/@claude-flow/memory/dist/domain/index.js +0 -12
  267. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.d.ts +0 -102
  268. package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.js +0 -11
  269. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.d.ts +0 -105
  270. package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.js +0 -297
  271. package/src/@claude-flow/memory/dist/hnsw-index.d.ts +0 -111
  272. package/src/@claude-flow/memory/dist/hnsw-index.js +0 -781
  273. package/src/@claude-flow/memory/dist/hnsw-lite.d.ts +0 -23
  274. package/src/@claude-flow/memory/dist/hnsw-lite.js +0 -168
  275. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +0 -245
  276. package/src/@claude-flow/memory/dist/hybrid-backend.js +0 -569
  277. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +0 -8
  278. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +0 -320
  279. package/src/@claude-flow/memory/dist/index.d.ts +0 -207
  280. package/src/@claude-flow/memory/dist/index.js +0 -361
  281. package/src/@claude-flow/memory/dist/infrastructure/index.d.ts +0 -17
  282. package/src/@claude-flow/memory/dist/infrastructure/index.js +0 -16
  283. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.d.ts +0 -66
  284. package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.js +0 -409
  285. package/src/@claude-flow/memory/dist/learning-bridge.d.ts +0 -137
  286. package/src/@claude-flow/memory/dist/learning-bridge.js +0 -335
  287. package/src/@claude-flow/memory/dist/learning-bridge.test.d.ts +0 -8
  288. package/src/@claude-flow/memory/dist/learning-bridge.test.js +0 -578
  289. package/src/@claude-flow/memory/dist/memory-graph.d.ts +0 -100
  290. package/src/@claude-flow/memory/dist/memory-graph.js +0 -333
  291. package/src/@claude-flow/memory/dist/memory-graph.test.d.ts +0 -8
  292. package/src/@claude-flow/memory/dist/memory-graph.test.js +0 -609
  293. package/src/@claude-flow/memory/dist/migration.d.ts +0 -68
  294. package/src/@claude-flow/memory/dist/migration.js +0 -513
  295. package/src/@claude-flow/memory/dist/persistent-sona.d.ts +0 -144
  296. package/src/@claude-flow/memory/dist/persistent-sona.js +0 -332
  297. package/src/@claude-flow/memory/dist/query-builder.d.ts +0 -211
  298. package/src/@claude-flow/memory/dist/query-builder.js +0 -438
  299. package/src/@claude-flow/memory/dist/rvf-backend.d.ts +0 -51
  300. package/src/@claude-flow/memory/dist/rvf-backend.js +0 -481
  301. package/src/@claude-flow/memory/dist/rvf-learning-store.d.ts +0 -139
  302. package/src/@claude-flow/memory/dist/rvf-learning-store.js +0 -295
  303. package/src/@claude-flow/memory/dist/rvf-migration.d.ts +0 -45
  304. package/src/@claude-flow/memory/dist/rvf-migration.js +0 -234
  305. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +0 -121
  306. package/src/@claude-flow/memory/dist/sqlite-backend.js +0 -572
  307. package/src/@claude-flow/memory/dist/sqljs-backend.d.ts +0 -128
  308. package/src/@claude-flow/memory/dist/sqljs-backend.js +0 -601
  309. package/src/@claude-flow/memory/dist/types.d.ts +0 -484
  310. package/src/@claude-flow/memory/dist/types.js +0 -58
  311. package/src/@claude-flow/shared/dist/core/config/defaults.d.ts +0 -41
  312. package/src/@claude-flow/shared/dist/core/config/defaults.js +0 -186
  313. package/src/@claude-flow/shared/dist/core/config/index.d.ts +0 -8
  314. package/src/@claude-flow/shared/dist/core/config/index.js +0 -12
  315. package/src/@claude-flow/shared/dist/core/config/loader.d.ts +0 -45
  316. package/src/@claude-flow/shared/dist/core/config/loader.js +0 -222
  317. package/src/@claude-flow/shared/dist/core/config/schema.d.ts +0 -1134
  318. package/src/@claude-flow/shared/dist/core/config/schema.js +0 -158
  319. package/src/@claude-flow/shared/dist/core/config/validator.d.ts +0 -92
  320. package/src/@claude-flow/shared/dist/core/config/validator.js +0 -147
  321. package/src/@claude-flow/shared/dist/core/event-bus.d.ts +0 -31
  322. package/src/@claude-flow/shared/dist/core/event-bus.js +0 -197
  323. package/src/@claude-flow/shared/dist/core/index.d.ts +0 -15
  324. package/src/@claude-flow/shared/dist/core/index.js +0 -19
  325. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +0 -200
  326. package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.js +0 -6
  327. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +0 -310
  328. package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +0 -7
  329. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +0 -224
  330. package/src/@claude-flow/shared/dist/core/interfaces/event.interface.js +0 -46
  331. package/src/@claude-flow/shared/dist/core/interfaces/index.d.ts +0 -10
  332. package/src/@claude-flow/shared/dist/core/interfaces/index.js +0 -15
  333. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +0 -298
  334. package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.js +0 -7
  335. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +0 -185
  336. package/src/@claude-flow/shared/dist/core/interfaces/task.interface.js +0 -6
  337. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +0 -35
  338. package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +0 -101
  339. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +0 -60
  340. package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +0 -166
  341. package/src/@claude-flow/shared/dist/core/orchestrator/index.d.ts +0 -46
  342. package/src/@claude-flow/shared/dist/core/orchestrator/index.js +0 -64
  343. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +0 -56
  344. package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +0 -195
  345. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +0 -83
  346. package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.js +0 -193
  347. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +0 -49
  348. package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.js +0 -253
  349. package/src/@claude-flow/shared/dist/events/domain-events.d.ts +0 -282
  350. package/src/@claude-flow/shared/dist/events/domain-events.js +0 -165
  351. package/src/@claude-flow/shared/dist/events/event-store.d.ts +0 -126
  352. package/src/@claude-flow/shared/dist/events/event-store.js +0 -416
  353. package/src/@claude-flow/shared/dist/events/event-store.test.d.ts +0 -8
  354. package/src/@claude-flow/shared/dist/events/event-store.test.js +0 -293
  355. package/src/@claude-flow/shared/dist/events/example-usage.d.ts +0 -10
  356. package/src/@claude-flow/shared/dist/events/example-usage.js +0 -193
  357. package/src/@claude-flow/shared/dist/events/index.d.ts +0 -21
  358. package/src/@claude-flow/shared/dist/events/index.js +0 -22
  359. package/src/@claude-flow/shared/dist/events/projections.d.ts +0 -177
  360. package/src/@claude-flow/shared/dist/events/projections.js +0 -421
  361. package/src/@claude-flow/shared/dist/events/rvf-event-log.d.ts +0 -82
  362. package/src/@claude-flow/shared/dist/events/rvf-event-log.js +0 -340
  363. package/src/@claude-flow/shared/dist/events/state-reconstructor.d.ts +0 -101
  364. package/src/@claude-flow/shared/dist/events/state-reconstructor.js +0 -263
  365. package/src/@claude-flow/shared/dist/events.d.ts +0 -80
  366. package/src/@claude-flow/shared/dist/events.js +0 -249
  367. package/src/@claude-flow/shared/dist/hooks/example-usage.d.ts +0 -42
  368. package/src/@claude-flow/shared/dist/hooks/example-usage.js +0 -351
  369. package/src/@claude-flow/shared/dist/hooks/executor.d.ts +0 -100
  370. package/src/@claude-flow/shared/dist/hooks/executor.js +0 -264
  371. package/src/@claude-flow/shared/dist/hooks/hooks.test.d.ts +0 -9
  372. package/src/@claude-flow/shared/dist/hooks/hooks.test.js +0 -322
  373. package/src/@claude-flow/shared/dist/hooks/index.d.ts +0 -52
  374. package/src/@claude-flow/shared/dist/hooks/index.js +0 -51
  375. package/src/@claude-flow/shared/dist/hooks/registry.d.ts +0 -133
  376. package/src/@claude-flow/shared/dist/hooks/registry.js +0 -277
  377. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +0 -105
  378. package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.js +0 -481
  379. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +0 -144
  380. package/src/@claude-flow/shared/dist/hooks/safety/file-organization.js +0 -328
  381. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +0 -158
  382. package/src/@claude-flow/shared/dist/hooks/safety/git-commit.js +0 -450
  383. package/src/@claude-flow/shared/dist/hooks/safety/index.d.ts +0 -17
  384. package/src/@claude-flow/shared/dist/hooks/safety/index.js +0 -17
  385. package/src/@claude-flow/shared/dist/hooks/session-hooks.d.ts +0 -234
  386. package/src/@claude-flow/shared/dist/hooks/session-hooks.js +0 -334
  387. package/src/@claude-flow/shared/dist/hooks/task-hooks.d.ts +0 -163
  388. package/src/@claude-flow/shared/dist/hooks/task-hooks.js +0 -326
  389. package/src/@claude-flow/shared/dist/hooks/types.d.ts +0 -267
  390. package/src/@claude-flow/shared/dist/hooks/types.js +0 -62
  391. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +0 -9
  392. package/src/@claude-flow/shared/dist/hooks/verify-exports.test.js +0 -93
  393. package/src/@claude-flow/shared/dist/index.d.ts +0 -20
  394. package/src/@claude-flow/shared/dist/index.js +0 -50
  395. package/src/@claude-flow/shared/dist/mcp/connection-pool.d.ts +0 -98
  396. package/src/@claude-flow/shared/dist/mcp/connection-pool.js +0 -364
  397. package/src/@claude-flow/shared/dist/mcp/index.d.ts +0 -69
  398. package/src/@claude-flow/shared/dist/mcp/index.js +0 -84
  399. package/src/@claude-flow/shared/dist/mcp/server.d.ts +0 -166
  400. package/src/@claude-flow/shared/dist/mcp/server.js +0 -593
  401. package/src/@claude-flow/shared/dist/mcp/session-manager.d.ts +0 -136
  402. package/src/@claude-flow/shared/dist/mcp/session-manager.js +0 -335
  403. package/src/@claude-flow/shared/dist/mcp/tool-registry.d.ts +0 -178
  404. package/src/@claude-flow/shared/dist/mcp/tool-registry.js +0 -439
  405. package/src/@claude-flow/shared/dist/mcp/transport/http.d.ts +0 -104
  406. package/src/@claude-flow/shared/dist/mcp/transport/http.js +0 -476
  407. package/src/@claude-flow/shared/dist/mcp/transport/index.d.ts +0 -102
  408. package/src/@claude-flow/shared/dist/mcp/transport/index.js +0 -238
  409. package/src/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +0 -104
  410. package/src/@claude-flow/shared/dist/mcp/transport/stdio.js +0 -263
  411. package/src/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +0 -133
  412. package/src/@claude-flow/shared/dist/mcp/transport/websocket.js +0 -396
  413. package/src/@claude-flow/shared/dist/mcp/types.d.ts +0 -438
  414. package/src/@claude-flow/shared/dist/mcp/types.js +0 -54
  415. package/src/@claude-flow/shared/dist/plugin-interface.d.ts +0 -544
  416. package/src/@claude-flow/shared/dist/plugin-interface.js +0 -23
  417. package/src/@claude-flow/shared/dist/plugin-loader.d.ts +0 -139
  418. package/src/@claude-flow/shared/dist/plugin-loader.js +0 -434
  419. package/src/@claude-flow/shared/dist/plugin-registry.d.ts +0 -183
  420. package/src/@claude-flow/shared/dist/plugin-registry.js +0 -457
  421. package/src/@claude-flow/shared/dist/plugins/index.d.ts +0 -10
  422. package/src/@claude-flow/shared/dist/plugins/index.js +0 -10
  423. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +0 -106
  424. package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +0 -241
  425. package/src/@claude-flow/shared/dist/plugins/official/index.d.ts +0 -10
  426. package/src/@claude-flow/shared/dist/plugins/official/index.js +0 -10
  427. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +0 -121
  428. package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +0 -355
  429. package/src/@claude-flow/shared/dist/plugins/types.d.ts +0 -93
  430. package/src/@claude-flow/shared/dist/plugins/types.js +0 -9
  431. package/src/@claude-flow/shared/dist/resilience/bulkhead.d.ts +0 -105
  432. package/src/@claude-flow/shared/dist/resilience/bulkhead.js +0 -206
  433. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +0 -132
  434. package/src/@claude-flow/shared/dist/resilience/circuit-breaker.js +0 -233
  435. package/src/@claude-flow/shared/dist/resilience/index.d.ts +0 -19
  436. package/src/@claude-flow/shared/dist/resilience/index.js +0 -19
  437. package/src/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +0 -168
  438. package/src/@claude-flow/shared/dist/resilience/rate-limiter.js +0 -314
  439. package/src/@claude-flow/shared/dist/resilience/retry.d.ts +0 -91
  440. package/src/@claude-flow/shared/dist/resilience/retry.js +0 -159
  441. package/src/@claude-flow/shared/dist/security/index.d.ts +0 -10
  442. package/src/@claude-flow/shared/dist/security/index.js +0 -12
  443. package/src/@claude-flow/shared/dist/security/input-validation.d.ts +0 -73
  444. package/src/@claude-flow/shared/dist/security/input-validation.js +0 -201
  445. package/src/@claude-flow/shared/dist/security/secure-random.d.ts +0 -92
  446. package/src/@claude-flow/shared/dist/security/secure-random.js +0 -142
  447. package/src/@claude-flow/shared/dist/services/index.d.ts +0 -7
  448. package/src/@claude-flow/shared/dist/services/index.js +0 -7
  449. package/src/@claude-flow/shared/dist/services/v3-progress.service.d.ts +0 -124
  450. package/src/@claude-flow/shared/dist/services/v3-progress.service.js +0 -402
  451. package/src/@claude-flow/shared/dist/types/agent.types.d.ts +0 -137
  452. package/src/@claude-flow/shared/dist/types/agent.types.js +0 -6
  453. package/src/@claude-flow/shared/dist/types/index.d.ts +0 -11
  454. package/src/@claude-flow/shared/dist/types/index.js +0 -17
  455. package/src/@claude-flow/shared/dist/types/mcp.types.d.ts +0 -266
  456. package/src/@claude-flow/shared/dist/types/mcp.types.js +0 -7
  457. package/src/@claude-flow/shared/dist/types/memory.types.d.ts +0 -236
  458. package/src/@claude-flow/shared/dist/types/memory.types.js +0 -7
  459. package/src/@claude-flow/shared/dist/types/swarm.types.d.ts +0 -186
  460. package/src/@claude-flow/shared/dist/types/swarm.types.js +0 -65
  461. package/src/@claude-flow/shared/dist/types/task.types.d.ts +0 -178
  462. package/src/@claude-flow/shared/dist/types/task.types.js +0 -32
  463. package/src/@claude-flow/shared/dist/types.d.ts +0 -197
  464. package/src/@claude-flow/shared/dist/types.js +0 -21
  465. package/src/@claude-flow/shared/dist/utils/secure-logger.d.ts +0 -69
  466. package/src/@claude-flow/shared/dist/utils/secure-logger.js +0 -208
@@ -1,295 +0,0 @@
1
- /**
2
- * RvfLearningStore - Persistent storage for SONA learning artifacts
3
- *
4
- * Stores patterns, LoRA adapters, EWC state, and trajectories in a
5
- * binary-header JSON-lines file format for fast append and rebuild.
6
- *
7
- * File format:
8
- * 4-byte magic "RVLS" + newline
9
- * One JSON record per line: {"type":"pattern"|"lora"|"ewc"|"trajectory","data":{...}}
10
- *
11
- * @module @claude-flow/memory/rvf-learning-store
12
- */
13
- import * as fs from 'node:fs';
14
- import * as path from 'node:path';
15
- // ===== Constants =====
16
- const MAGIC_HEADER = 'RVLS';
17
- const DEFAULT_DIMENSIONS = 64;
18
- const DEFAULT_AUTO_PERSIST_MS = 30_000;
19
- // ===== Helpers =====
20
- function ensureDirectory(filePath) {
21
- const dir = path.dirname(filePath);
22
- if (!fs.existsSync(dir)) {
23
- fs.mkdirSync(dir, { recursive: true });
24
- }
25
- }
26
- // ===== RvfLearningStore =====
27
- /**
28
- * Persistent store for SONA learning artifacts.
29
- *
30
- * Maintains in-memory maps for fast reads and flushes to a JSON-lines
31
- * file with a binary header on persist(). On initialize(), the file is
32
- * read line-by-line to rebuild state.
33
- *
34
- * @example
35
- * ```typescript
36
- * const store = new RvfLearningStore({ storePath: './data/learning.rvls' });
37
- * await store.initialize();
38
- *
39
- * await store.savePatterns([{ id: 'p1', type: 'query_response', ... }]);
40
- * await store.persist();
41
- * await store.close();
42
- * ```
43
- */
44
- export class RvfLearningStore {
45
- config;
46
- patterns = new Map();
47
- loraAdapters = new Map();
48
- ewcState = null;
49
- trajectories = [];
50
- dirty = false;
51
- initialized = false;
52
- autoPersistTimer = null;
53
- constructor(config) {
54
- this.config = {
55
- storePath: config.storePath,
56
- dimensions: config.dimensions ?? DEFAULT_DIMENSIONS,
57
- autoPersistInterval: config.autoPersistInterval ?? DEFAULT_AUTO_PERSIST_MS,
58
- verbose: config.verbose ?? false,
59
- };
60
- }
61
- /**
62
- * Initialize the store by loading any existing data from disk.
63
- * Creates the parent directory if it does not exist.
64
- */
65
- async initialize() {
66
- if (this.initialized)
67
- return;
68
- ensureDirectory(this.config.storePath);
69
- if (fs.existsSync(this.config.storePath)) {
70
- await this.loadFromDisk();
71
- }
72
- if (this.config.autoPersistInterval > 0) {
73
- this.autoPersistTimer = setInterval(() => void this.persist().catch(() => { }), this.config.autoPersistInterval);
74
- // Allow the process to exit even if the timer is active
75
- if (this.autoPersistTimer.unref) {
76
- this.autoPersistTimer.unref();
77
- }
78
- }
79
- this.initialized = true;
80
- this.log('Store initialized');
81
- }
82
- // ===== Pattern operations =====
83
- /**
84
- * Save or update patterns. Existing patterns with matching IDs are
85
- * overwritten; new patterns are added.
86
- *
87
- * @returns The number of patterns stored
88
- */
89
- async savePatterns(patterns) {
90
- this.ensureInitialized();
91
- let count = 0;
92
- for (const pattern of patterns) {
93
- this.patterns.set(pattern.id, { ...pattern });
94
- count++;
95
- }
96
- this.dirty = true;
97
- return count;
98
- }
99
- /** Load all patterns currently held in memory */
100
- async loadPatterns() {
101
- this.ensureInitialized();
102
- return Array.from(this.patterns.values());
103
- }
104
- /** Return the number of stored patterns */
105
- async getPatternCount() {
106
- this.ensureInitialized();
107
- return this.patterns.size;
108
- }
109
- // ===== LoRA operations =====
110
- /** Save or update a LoRA adapter record */
111
- async saveLoraAdapter(record) {
112
- this.ensureInitialized();
113
- this.loraAdapters.set(record.id, { ...record });
114
- this.dirty = true;
115
- }
116
- /** Load all LoRA adapter records */
117
- async loadLoraAdapters() {
118
- this.ensureInitialized();
119
- return Array.from(this.loraAdapters.values());
120
- }
121
- /** Delete a LoRA adapter by ID */
122
- async deleteLoraAdapter(id) {
123
- this.ensureInitialized();
124
- const existed = this.loraAdapters.delete(id);
125
- if (existed)
126
- this.dirty = true;
127
- return existed;
128
- }
129
- // ===== EWC operations =====
130
- /** Save EWC state (replaces any existing state) */
131
- async saveEwcState(record) {
132
- this.ensureInitialized();
133
- this.ewcState = { ...record };
134
- this.dirty = true;
135
- }
136
- /** Load the EWC state, or null if none has been stored */
137
- async loadEwcState() {
138
- this.ensureInitialized();
139
- return this.ewcState ? { ...this.ewcState } : null;
140
- }
141
- // ===== Trajectory operations =====
142
- /** Append a trajectory record (append-only, never overwritten) */
143
- async appendTrajectory(record) {
144
- this.ensureInitialized();
145
- this.trajectories.push({ ...record });
146
- this.dirty = true;
147
- }
148
- /**
149
- * Return stored trajectories, newest first.
150
- * @param limit Maximum number to return (default: all)
151
- */
152
- async getTrajectories(limit) {
153
- this.ensureInitialized();
154
- const sorted = [...this.trajectories].reverse();
155
- return limit !== undefined ? sorted.slice(0, limit) : sorted;
156
- }
157
- /** Return the number of stored trajectories */
158
- async getTrajectoryCount() {
159
- this.ensureInitialized();
160
- return this.trajectories.length;
161
- }
162
- // ===== Lifecycle =====
163
- /**
164
- * Flush all in-memory state to disk. The entire file is rewritten
165
- * to ensure consistency (patterns may have been updated in-place).
166
- */
167
- async persist() {
168
- if (!this.dirty)
169
- return;
170
- ensureDirectory(this.config.storePath);
171
- const lines = [MAGIC_HEADER];
172
- // Patterns
173
- for (const pattern of this.patterns.values()) {
174
- lines.push(JSON.stringify({ type: 'pattern', data: pattern }));
175
- }
176
- // LoRA adapters
177
- for (const lora of this.loraAdapters.values()) {
178
- lines.push(JSON.stringify({ type: 'lora', data: lora }));
179
- }
180
- // EWC state
181
- if (this.ewcState) {
182
- lines.push(JSON.stringify({ type: 'ewc', data: this.ewcState }));
183
- }
184
- // Trajectories
185
- for (const traj of this.trajectories) {
186
- lines.push(JSON.stringify({ type: 'trajectory', data: traj }));
187
- }
188
- const content = lines.join('\n') + '\n';
189
- const tmpPath = this.config.storePath + '.tmp';
190
- await fs.promises.writeFile(tmpPath, content, 'utf-8');
191
- await fs.promises.rename(tmpPath, this.config.storePath);
192
- this.dirty = false;
193
- this.log(`Persisted: ${this.patterns.size} patterns, ${this.loraAdapters.size} LoRA, ${this.trajectories.length} trajectories`);
194
- }
195
- /** Persist and release resources */
196
- async close() {
197
- if (this.autoPersistTimer) {
198
- clearInterval(this.autoPersistTimer);
199
- this.autoPersistTimer = null;
200
- }
201
- if (this.dirty) {
202
- await this.persist();
203
- }
204
- this.initialized = false;
205
- this.log('Store closed');
206
- }
207
- // ===== Stats =====
208
- /** Return summary statistics about the store */
209
- async getStats() {
210
- this.ensureInitialized();
211
- let fileSizeBytes = 0;
212
- try {
213
- const stat = await fs.promises.stat(this.config.storePath);
214
- fileSizeBytes = stat.size;
215
- }
216
- catch {
217
- // File may not exist yet if nothing has been persisted
218
- }
219
- return {
220
- patterns: this.patterns.size,
221
- loraAdapters: this.loraAdapters.size,
222
- trajectories: this.trajectories.length,
223
- hasEwcState: this.ewcState !== null,
224
- fileSizeBytes,
225
- };
226
- }
227
- // ===== Private =====
228
- async loadFromDisk() {
229
- let content;
230
- try {
231
- content = await fs.promises.readFile(this.config.storePath, 'utf-8');
232
- }
233
- catch {
234
- return;
235
- }
236
- const lines = content.split('\n').filter((l) => l.trim().length > 0);
237
- if (lines.length === 0)
238
- return;
239
- // Verify magic header
240
- if (lines[0] !== MAGIC_HEADER) {
241
- this.log(`Warning: invalid magic header "${lines[0]}", expected "${MAGIC_HEADER}"`);
242
- return;
243
- }
244
- let parsed = 0;
245
- let errors = 0;
246
- for (let i = 1; i < lines.length; i++) {
247
- try {
248
- const record = JSON.parse(lines[i]);
249
- this.applyRecord(record);
250
- parsed++;
251
- }
252
- catch {
253
- errors++;
254
- this.log(`Warning: failed to parse line ${i + 1}`);
255
- }
256
- }
257
- this.log(`Loaded from disk: ${parsed} records, ${errors} errors`);
258
- }
259
- applyRecord(record) {
260
- switch (record.type) {
261
- case 'pattern': {
262
- const p = record.data;
263
- this.patterns.set(p.id, p);
264
- break;
265
- }
266
- case 'lora': {
267
- const l = record.data;
268
- this.loraAdapters.set(l.id, l);
269
- break;
270
- }
271
- case 'ewc': {
272
- this.ewcState = record.data;
273
- break;
274
- }
275
- case 'trajectory': {
276
- this.trajectories.push(record.data);
277
- break;
278
- }
279
- default:
280
- this.log(`Warning: unknown record type "${record.type}"`);
281
- }
282
- }
283
- ensureInitialized() {
284
- if (!this.initialized) {
285
- throw new Error('RvfLearningStore has not been initialized. Call initialize() first.');
286
- }
287
- }
288
- log(message) {
289
- if (this.config.verbose) {
290
- // eslint-disable-next-line no-console
291
- console.log(`[RvfLearningStore] ${message}`);
292
- }
293
- }
294
- }
295
- //# sourceMappingURL=rvf-learning-store.js.map
@@ -1,45 +0,0 @@
1
- /** Options for controlling the migration process. */
2
- export interface RvfMigrationOptions {
3
- verbose?: boolean;
4
- /** Entries per batch (default 500). */
5
- batchSize?: number;
6
- /** Embedding dimensions for target RVF file (default 1536). */
7
- dimensions?: number;
8
- onProgress?: (progress: {
9
- current: number;
10
- total: number;
11
- phase: string;
12
- }) => void;
13
- }
14
- /** Result returned after a migration completes. */
15
- export interface RvfMigrationResult {
16
- success: boolean;
17
- entriesMigrated: number;
18
- sourceFormat: string;
19
- targetFormat: string;
20
- durationMs: number;
21
- errors: string[];
22
- }
23
- /**
24
- * Bidirectional migration utility between RVF and legacy memory formats.
25
- *
26
- * All methods are static — no instantiation required.
27
- */
28
- export declare class RvfMigrator {
29
- /** Migrate a JSON memory file to RVF format. */
30
- static fromJsonFile(jsonPath: string, rvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
31
- /** Migrate a SQLite (better-sqlite3 / sql.js) database to RVF. */
32
- static fromSqlite(dbPath: string, rvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
33
- /** Export an RVF file back to a JSON array (backward compatibility). */
34
- static toJsonFile(rvfPath: string, jsonPath: string): Promise<RvfMigrationResult>;
35
- /**
36
- * Detect file format by magic bytes.
37
- * - RVF\0 (0x52 0x56 0x46 0x00) -> 'rvf'
38
- * - SQLi (0x53 0x51 0x4C 0x69) -> 'sqlite'
39
- * - Leading [ or { -> 'json'
40
- */
41
- static detectFormat(filePath: string): Promise<'rvf' | 'json' | 'sqlite' | 'unknown'>;
42
- /** Auto-detect source format and migrate to RVF. */
43
- static autoMigrate(sourcePath: string, targetRvfPath: string, options?: RvfMigrationOptions): Promise<RvfMigrationResult>;
44
- }
45
- //# sourceMappingURL=rvf-migration.d.ts.map
@@ -1,234 +0,0 @@
1
- /**
2
- * RVF Migration Utility — bidirectional migration between RVF and legacy
3
- * formats (JSON files, sql.js / better-sqlite3 databases).
4
- * @module @claude-flow/memory/rvf-migration
5
- */
6
- import { readFile, writeFile, rename, mkdir } from 'node:fs/promises';
7
- import { existsSync } from 'node:fs';
8
- import { dirname, resolve } from 'node:path';
9
- import { RvfBackend } from './rvf-backend.js';
10
- import { generateMemoryId } from './types.js';
11
- // -- Internal helpers -------------------------------------------------------
12
- function fillDefaults(raw) {
13
- const now = Date.now();
14
- return {
15
- id: raw.id ?? generateMemoryId(),
16
- key: raw.key ?? '',
17
- content: raw.content ?? '',
18
- type: raw.type ?? 'semantic',
19
- namespace: raw.namespace ?? 'default',
20
- tags: raw.tags ?? [],
21
- metadata: raw.metadata ?? {},
22
- ownerId: raw.ownerId,
23
- accessLevel: raw.accessLevel ?? 'private',
24
- createdAt: raw.createdAt ?? now,
25
- updatedAt: raw.updatedAt ?? now,
26
- expiresAt: raw.expiresAt,
27
- version: raw.version ?? 1,
28
- references: raw.references ?? [],
29
- accessCount: raw.accessCount ?? 0,
30
- lastAccessedAt: raw.lastAccessedAt ?? now,
31
- embedding: deserializeEmbedding(raw.embedding),
32
- };
33
- }
34
- function deserializeEmbedding(value) {
35
- if (!value)
36
- return undefined;
37
- if (value instanceof Float32Array)
38
- return value;
39
- if (value instanceof Buffer || value instanceof Uint8Array) {
40
- if (value.byteLength === 0)
41
- return undefined;
42
- const out = new Float32Array(value.byteLength / 4);
43
- const view = new DataView(value.buffer, value.byteOffset, value.byteLength);
44
- for (let i = 0; i < out.length; i++)
45
- out[i] = view.getFloat32(i * 4, true);
46
- return out;
47
- }
48
- if (Array.isArray(value))
49
- return new Float32Array(value);
50
- return undefined;
51
- }
52
- function serializeForJson(entry) {
53
- return { ...entry, embedding: entry.embedding ? Array.from(entry.embedding) : undefined };
54
- }
55
- function validateMigrationPath(p) {
56
- if (!p || typeof p !== 'string')
57
- throw new Error('Path must be a non-empty string');
58
- if (p.includes('\0'))
59
- throw new Error('Path contains null bytes');
60
- }
61
- async function ensureDir(filePath) {
62
- validateMigrationPath(filePath);
63
- const dir = dirname(resolve(filePath));
64
- if (!existsSync(dir))
65
- await mkdir(dir, { recursive: true });
66
- }
67
- async function atomicWrite(targetPath, data) {
68
- validateMigrationPath(targetPath);
69
- const abs = resolve(targetPath);
70
- const tmp = abs + '.tmp.' + Date.now();
71
- await ensureDir(abs);
72
- await writeFile(tmp, data, typeof data === 'string' ? 'utf-8' : undefined);
73
- await rename(tmp, abs);
74
- }
75
- function mkResult(success, entriesMigrated, sourceFormat, targetFormat, startMs, errors) {
76
- return { success, entriesMigrated, sourceFormat, targetFormat, durationMs: Date.now() - startMs, errors };
77
- }
78
- function normalizeSqliteRow(row) {
79
- const out = { ...row };
80
- for (const col of ['tags', 'metadata', 'references']) {
81
- if (typeof out[col] === 'string') {
82
- try {
83
- out[col] = JSON.parse(out[col]);
84
- }
85
- catch {
86
- out[col] = col === 'metadata' ? {} : [];
87
- }
88
- }
89
- }
90
- return out;
91
- }
92
- async function readSqliteRows(dbPath) {
93
- // Use sql.js (WASM) for SQLite reading
94
- try {
95
- const initSqlJs = (await import('sql.js')).default;
96
- const SQL = await initSqlJs();
97
- const fs = await import('node:fs');
98
- const buf = fs.readFileSync(dbPath);
99
- const db = new SQL.Database(buf);
100
- return { exec: (sql) => db.exec(sql), close: () => db.close() };
101
- }
102
- catch {
103
- throw new Error('Cannot read SQLite: install sql.js');
104
- }
105
- }
106
- // -- Batch migration helper -------------------------------------------------
107
- async function migrateBatches(items, rvfPath, options, normalize) {
108
- const batchSize = options.batchSize ?? 500;
109
- const dimensions = options.dimensions ?? 1536;
110
- const backend = new RvfBackend({ databasePath: rvfPath, dimensions, verbose: options.verbose });
111
- await backend.initialize();
112
- let migrated = 0;
113
- const errors = [];
114
- try {
115
- for (let i = 0; i < items.length; i += batchSize) {
116
- const batch = items.slice(i, i + batchSize);
117
- const entries = [];
118
- for (const item of batch) {
119
- try {
120
- entries.push(fillDefaults(normalize ? normalize(item) : item));
121
- }
122
- catch (e) {
123
- errors.push(`Entry ${item.id ?? i}: ${e.message}`);
124
- }
125
- }
126
- if (entries.length > 0) {
127
- await backend.bulkInsert(entries);
128
- migrated += entries.length;
129
- }
130
- options.onProgress?.({ current: Math.min(i + batchSize, items.length), total: items.length, phase: 'migrating' });
131
- }
132
- }
133
- finally {
134
- await backend.shutdown();
135
- }
136
- return { migrated, errors };
137
- }
138
- /**
139
- * Bidirectional migration utility between RVF and legacy memory formats.
140
- *
141
- * All methods are static — no instantiation required.
142
- */
143
- export class RvfMigrator {
144
- /** Migrate a JSON memory file to RVF format. */
145
- static async fromJsonFile(jsonPath, rvfPath, options = {}) {
146
- const start = Date.now();
147
- const raw = await readFile(jsonPath, 'utf-8');
148
- let parsed;
149
- try {
150
- parsed = JSON.parse(raw);
151
- }
152
- catch (e) {
153
- return mkResult(false, 0, 'json', 'rvf', start, [`Invalid JSON: ${e.message}`]);
154
- }
155
- const items = Array.isArray(parsed) ? parsed : [parsed];
156
- const { migrated, errors } = await migrateBatches(items, rvfPath, options);
157
- if (options.verbose)
158
- console.log(`[RvfMigrator] Migrated ${migrated} entries from JSON to RVF`);
159
- return mkResult(errors.length === 0, migrated, 'json', 'rvf', start, errors);
160
- }
161
- /** Migrate a SQLite (better-sqlite3 / sql.js) database to RVF. */
162
- static async fromSqlite(dbPath, rvfPath, options = {}) {
163
- const start = Date.now();
164
- let rows;
165
- try {
166
- rows = await readSqliteRows(dbPath);
167
- }
168
- catch (e) {
169
- return mkResult(false, 0, 'sqlite', 'rvf', start, [e.message]);
170
- }
171
- options.onProgress?.({ current: 0, total: rows.length, phase: 'reading' });
172
- const { migrated, errors } = await migrateBatches(rows, rvfPath, options, normalizeSqliteRow);
173
- if (options.verbose)
174
- console.log(`[RvfMigrator] Migrated ${migrated} entries from SQLite to RVF`);
175
- return mkResult(errors.length === 0, migrated, 'sqlite', 'rvf', start, errors);
176
- }
177
- /** Export an RVF file back to a JSON array (backward compatibility). */
178
- static async toJsonFile(rvfPath, jsonPath) {
179
- const start = Date.now();
180
- const backend = new RvfBackend({ databasePath: rvfPath });
181
- await backend.initialize();
182
- let entries;
183
- try {
184
- entries = await backend.query({ type: 'hybrid', limit: Number.MAX_SAFE_INTEGER });
185
- }
186
- finally {
187
- await backend.shutdown();
188
- }
189
- const warnings = [];
190
- if (entries.length === 0)
191
- warnings.push('Source RVF file contained no entries');
192
- await atomicWrite(jsonPath, JSON.stringify(entries.map(serializeForJson), null, 2));
193
- return mkResult(true, entries.length, 'rvf', 'json', start, warnings);
194
- }
195
- /**
196
- * Detect file format by magic bytes.
197
- * - RVF\0 (0x52 0x56 0x46 0x00) -> 'rvf'
198
- * - SQLi (0x53 0x51 0x4C 0x69) -> 'sqlite'
199
- * - Leading [ or { -> 'json'
200
- */
201
- static async detectFormat(filePath) {
202
- if (!existsSync(filePath))
203
- return 'unknown';
204
- const fd = await import('node:fs').then(m => m.promises.open(filePath, 'r'));
205
- try {
206
- const buf = Buffer.alloc(16);
207
- await fd.read(buf, 0, 16, 0);
208
- if (buf[0] === 0x52 && buf[1] === 0x56 && buf[2] === 0x46 && buf[3] === 0x00)
209
- return 'rvf';
210
- if (buf[0] === 0x53 && buf[1] === 0x51 && buf[2] === 0x4C && buf[3] === 0x69)
211
- return 'sqlite';
212
- const head = buf.toString('utf-8').trimStart();
213
- if (head.startsWith('[') || head.startsWith('{'))
214
- return 'json';
215
- return 'unknown';
216
- }
217
- finally {
218
- await fd.close();
219
- }
220
- }
221
- /** Auto-detect source format and migrate to RVF. */
222
- static async autoMigrate(sourcePath, targetRvfPath, options = {}) {
223
- const format = await RvfMigrator.detectFormat(sourcePath);
224
- if (options.verbose)
225
- console.log(`[RvfMigrator] Detected source format: ${format}`);
226
- switch (format) {
227
- case 'json': return RvfMigrator.fromJsonFile(sourcePath, targetRvfPath, options);
228
- case 'sqlite': return RvfMigrator.fromSqlite(sourcePath, targetRvfPath, options);
229
- case 'rvf': return { success: true, entriesMigrated: 0, sourceFormat: 'rvf', targetFormat: 'rvf', durationMs: 0, errors: [] };
230
- default: return { success: false, entriesMigrated: 0, sourceFormat: 'unknown', targetFormat: 'rvf', durationMs: 0, errors: [`Unrecognized format: ${sourcePath}`] };
231
- }
232
- }
233
- }
234
- //# sourceMappingURL=rvf-migration.js.map
@@ -1,121 +0,0 @@
1
- /**
2
- * SQLite Memory Backend
3
- *
4
- * Provides structured storage for memory entries using SQLite.
5
- * Optimized for ACID transactions, exact matches, and complex queries.
6
- * Part of ADR-009: Hybrid Memory Backend (SQLite + AgentDB)
7
- *
8
- * @module v3/memory/sqlite-backend
9
- */
10
- import { EventEmitter } from 'node:events';
11
- import { IMemoryBackend, MemoryEntry, MemoryEntryUpdate, MemoryQuery, SearchOptions, SearchResult, BackendStats, HealthCheckResult, EmbeddingGenerator } from './types.js';
12
- /**
13
- * Configuration for SQLite Backend
14
- */
15
- export interface SQLiteBackendConfig {
16
- /** Path to SQLite database file (:memory: for in-memory) */
17
- databasePath: string;
18
- /** Enable WAL mode for better concurrency */
19
- walMode: boolean;
20
- /** Enable query optimization */
21
- optimize: boolean;
22
- /** Default namespace */
23
- defaultNamespace: string;
24
- /** Embedding generator (for compatibility with hybrid mode) */
25
- embeddingGenerator?: EmbeddingGenerator;
26
- /** Maximum entries before auto-cleanup */
27
- maxEntries: number;
28
- /** Enable verbose logging */
29
- verbose: boolean;
30
- }
31
- /**
32
- * SQLite Backend for Structured Memory Storage
33
- *
34
- * Provides:
35
- * - ACID transactions for data consistency
36
- * - Efficient indexing for exact matches and prefix queries
37
- * - Full-text search capabilities
38
- * - Complex SQL queries with joins and aggregations
39
- * - Persistent storage with WAL mode
40
- */
41
- export declare class SQLiteBackend extends EventEmitter implements IMemoryBackend {
42
- private config;
43
- private db;
44
- private initialized;
45
- private stats;
46
- constructor(config?: Partial<SQLiteBackendConfig>);
47
- /**
48
- * Initialize the SQLite backend
49
- */
50
- initialize(): Promise<void>;
51
- /**
52
- * Shutdown the backend
53
- */
54
- shutdown(): Promise<void>;
55
- /**
56
- * Store a memory entry
57
- */
58
- store(entry: MemoryEntry): Promise<void>;
59
- /**
60
- * Get a memory entry by ID
61
- */
62
- get(id: string): Promise<MemoryEntry | null>;
63
- /**
64
- * Get a memory entry by key within a namespace
65
- */
66
- getByKey(namespace: string, key: string): Promise<MemoryEntry | null>;
67
- /**
68
- * Update a memory entry
69
- */
70
- update(id: string, update: MemoryEntryUpdate): Promise<MemoryEntry | null>;
71
- /**
72
- * Delete a memory entry
73
- */
74
- delete(id: string): Promise<boolean>;
75
- /**
76
- * Query memory entries with filters
77
- */
78
- query(query: MemoryQuery): Promise<MemoryEntry[]>;
79
- /**
80
- * Semantic vector search (not optimized for SQLite, returns empty)
81
- * Use HybridBackend for semantic search with AgentDB
82
- */
83
- search(embedding: Float32Array, options: SearchOptions): Promise<SearchResult[]>;
84
- /**
85
- * Bulk insert entries
86
- */
87
- bulkInsert(entries: MemoryEntry[]): Promise<void>;
88
- /**
89
- * Bulk delete entries
90
- */
91
- bulkDelete(ids: string[]): Promise<number>;
92
- /**
93
- * Get entry count
94
- */
95
- count(namespace?: string): Promise<number>;
96
- /**
97
- * List all namespaces
98
- */
99
- listNamespaces(): Promise<string[]>;
100
- /**
101
- * Clear all entries in a namespace
102
- */
103
- clearNamespace(namespace: string): Promise<number>;
104
- /**
105
- * Get backend statistics
106
- */
107
- getStats(): Promise<BackendStats>;
108
- /**
109
- * Perform health check
110
- */
111
- healthCheck(): Promise<HealthCheckResult>;
112
- private ensureInitialized;
113
- private createSchema;
114
- private rowToEntry;
115
- /**
116
- * Synchronous store for use in transactions
117
- */
118
- private storeSync;
119
- }
120
- export default SQLiteBackend;
121
- //# sourceMappingURL=sqlite-backend.d.ts.map