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,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