claude-flow-novice 2.0.3 → 2.0.4

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 (272) hide show
  1. package/dist/src/cli/commands/guidance.js +487 -668
  2. package/dist/src/cli/commands/index-validate.js +18 -29
  3. package/dist/src/cli/commands/mcp-troubleshoot.js +230 -282
  4. package/dist/src/cli/commands/neural-goal-init.js +92 -125
  5. package/dist/src/cli/commands/swarm-exec.js +317 -393
  6. package/dist/src/cli/commands/swarm.js +1 -1
  7. package/dist/src/cli/commands/validate-framework.js +983 -1100
  8. package/dist/src/cli/commands/validate.js +144 -223
  9. package/dist/src/cli/simple-commands/__tests__/agent.test.js +265 -277
  10. package/dist/src/cli/simple-commands/__tests__/memory.test.js +6 -7
  11. package/dist/src/cli/simple-commands/__tests__/swarm.test.js +373 -356
  12. package/dist/src/cli/simple-commands/__tests__/task.test.js +6 -7
  13. package/dist/src/cli/simple-commands/agent.js +157 -193
  14. package/dist/src/cli/simple-commands/analysis.js +336 -446
  15. package/dist/src/cli/simple-commands/automation-executor.js +1095 -1339
  16. package/dist/src/cli/simple-commands/automation.js +481 -469
  17. package/dist/src/cli/simple-commands/batch-manager.js +261 -313
  18. package/dist/src/cli/simple-commands/claude-telemetry.js +241 -267
  19. package/dist/src/cli/simple-commands/claude-track.js +68 -90
  20. package/dist/src/cli/simple-commands/concurrent-display.js +266 -320
  21. package/dist/src/cli/simple-commands/config.js +245 -290
  22. package/dist/src/cli/simple-commands/coordination.js +182 -234
  23. package/dist/src/cli/simple-commands/enhanced-ui-views.js +812 -615
  24. package/dist/src/cli/simple-commands/enhanced-webui-complete.js +922 -981
  25. package/dist/src/cli/simple-commands/fix-hook-variables.js +274 -294
  26. package/dist/src/cli/simple-commands/github/gh-coordinator.js +378 -457
  27. package/dist/src/cli/simple-commands/github/github-api.js +535 -574
  28. package/dist/src/cli/simple-commands/github/init.js +276 -303
  29. package/dist/src/cli/simple-commands/github.js +222 -247
  30. package/dist/src/cli/simple-commands/goal.js +51 -63
  31. package/dist/src/cli/simple-commands/hive-mind/auto-save-middleware.js +208 -278
  32. package/dist/src/cli/simple-commands/hive-mind/communication.js +601 -696
  33. package/dist/src/cli/simple-commands/hive-mind/core.js +907 -979
  34. package/dist/src/cli/simple-commands/hive-mind/db-optimizer.js +406 -655
  35. package/dist/src/cli/simple-commands/hive-mind/mcp-wrapper.js +1125 -1245
  36. package/dist/src/cli/simple-commands/hive-mind/memory.js +854 -1090
  37. package/dist/src/cli/simple-commands/hive-mind/performance-optimizer.js +459 -574
  38. package/dist/src/cli/simple-commands/hive-mind/performance-test.js +263 -347
  39. package/dist/src/cli/simple-commands/hive-mind/queen.js +727 -768
  40. package/dist/src/cli/simple-commands/hive-mind/session-manager.js +745 -1049
  41. package/dist/src/cli/simple-commands/hive-mind-optimize.js +227 -283
  42. package/dist/src/cli/simple-commands/hive-mind-wizard.js +174 -217
  43. package/dist/src/cli/simple-commands/hive-mind.js +1842 -2283
  44. package/dist/src/cli/simple-commands/hive.js +90 -79
  45. package/dist/src/cli/simple-commands/hook-safety.js +431 -521
  46. package/dist/src/cli/simple-commands/hooks/session-start-soul.js +203 -254
  47. package/dist/src/cli/simple-commands/hooks.js +1064 -1204
  48. package/dist/src/cli/simple-commands/init/agent-copier.js +294 -319
  49. package/dist/src/cli/simple-commands/init/batch-init.js +496 -562
  50. package/dist/src/cli/simple-commands/init/claude-commands/claude-flow-commands.js +13 -19
  51. package/dist/src/cli/simple-commands/init/claude-commands/optimized-claude-flow-commands.js +13 -19
  52. package/dist/src/cli/simple-commands/init/claude-commands/optimized-slash-commands.js +61 -88
  53. package/dist/src/cli/simple-commands/init/claude-commands/optimized-sparc-commands.js +125 -150
  54. package/dist/src/cli/simple-commands/init/claude-commands/slash-commands.js +42 -49
  55. package/dist/src/cli/simple-commands/init/claude-commands/sparc-commands.js +43 -61
  56. package/dist/src/cli/simple-commands/init/copy-revised-templates.js +141 -147
  57. package/dist/src/cli/simple-commands/init/executable-wrapper.js +31 -44
  58. package/dist/src/cli/simple-commands/init/gitignore-updater.js +64 -90
  59. package/dist/src/cli/simple-commands/init/help.js +104 -107
  60. package/dist/src/cli/simple-commands/init/hive-mind-init.js +509 -528
  61. package/dist/src/cli/simple-commands/init/index.js +1510 -1759
  62. package/dist/src/cli/simple-commands/init/performance-monitor.js +234 -317
  63. package/dist/src/cli/simple-commands/init/rollback/backup-manager.js +441 -504
  64. package/dist/src/cli/simple-commands/init/rollback/index.js +289 -364
  65. package/dist/src/cli/simple-commands/init/rollback/recovery-manager.js +652 -728
  66. package/dist/src/cli/simple-commands/init/rollback/rollback-executor.js +416 -481
  67. package/dist/src/cli/simple-commands/init/rollback/state-tracker.js +369 -448
  68. package/dist/src/cli/simple-commands/init/sparc/roo-readme.js +1 -2
  69. package/dist/src/cli/simple-commands/init/sparc/roomodes-config.js +122 -99
  70. package/dist/src/cli/simple-commands/init/sparc/workflows.js +32 -37
  71. package/dist/src/cli/simple-commands/init/sparc-structure.js +55 -62
  72. package/dist/src/cli/simple-commands/init/template-copier.js +421 -533
  73. package/dist/src/cli/simple-commands/init/templates/coordination-md.js +3 -6
  74. package/dist/src/cli/simple-commands/init/templates/enhanced-templates.js +344 -318
  75. package/dist/src/cli/simple-commands/init/templates/github-safe-enhanced.js +173 -218
  76. package/dist/src/cli/simple-commands/init/templates/github-safe.js +65 -75
  77. package/dist/src/cli/simple-commands/init/templates/memory-bank-md.js +3 -6
  78. package/dist/src/cli/simple-commands/init/templates/readme-files.js +2 -4
  79. package/dist/src/cli/simple-commands/init/templates/safe-hook-patterns.js +187 -230
  80. package/dist/src/cli/simple-commands/init/templates/sparc-modes.js +53 -80
  81. package/dist/src/cli/simple-commands/init/templates/verification-claude-md.js +101 -85
  82. package/dist/src/cli/simple-commands/init/validation/config-validator.js +283 -330
  83. package/dist/src/cli/simple-commands/init/validation/health-checker.js +495 -561
  84. package/dist/src/cli/simple-commands/init/validation/index.js +302 -358
  85. package/dist/src/cli/simple-commands/init/validation/mode-validator.js +308 -359
  86. package/dist/src/cli/simple-commands/init/validation/post-init-validator.js +389 -366
  87. package/dist/src/cli/simple-commands/init/validation/pre-init-validator.js +270 -268
  88. package/dist/src/cli/simple-commands/init/validation/test-runner.js +427 -447
  89. package/dist/src/cli/simple-commands/init.js +1 -2
  90. package/dist/src/cli/simple-commands/mcp-health.js +131 -158
  91. package/dist/src/cli/simple-commands/mcp-integration-layer.js +533 -634
  92. package/dist/src/cli/simple-commands/mcp.js +345 -400
  93. package/dist/src/cli/simple-commands/memory-consolidation.js +426 -537
  94. package/dist/src/cli/simple-commands/memory.js +247 -311
  95. package/dist/src/cli/simple-commands/migrate-hooks.js +39 -46
  96. package/dist/src/cli/simple-commands/monitor.js +294 -363
  97. package/dist/src/cli/simple-commands/neural.js +51 -65
  98. package/dist/src/cli/simple-commands/pair-autofix-only.js +538 -662
  99. package/dist/src/cli/simple-commands/pair-basic.js +528 -656
  100. package/dist/src/cli/simple-commands/pair-old.js +430 -543
  101. package/dist/src/cli/simple-commands/pair-working.js +615 -751
  102. package/dist/src/cli/simple-commands/pair.js +615 -751
  103. package/dist/src/cli/simple-commands/performance-hooks.js +83 -111
  104. package/dist/src/cli/simple-commands/performance-metrics.js +348 -433
  105. package/dist/src/cli/simple-commands/process-ui-enhanced.js +708 -787
  106. package/dist/src/cli/simple-commands/process-ui.js +230 -254
  107. package/dist/src/cli/simple-commands/realtime-update-system.js +525 -611
  108. package/dist/src/cli/simple-commands/sparc/architecture.js +1704 -1530
  109. package/dist/src/cli/simple-commands/sparc/commands.js +438 -516
  110. package/dist/src/cli/simple-commands/sparc/completion.js +1224 -1481
  111. package/dist/src/cli/simple-commands/sparc/coordinator.js +913 -978
  112. package/dist/src/cli/simple-commands/sparc/index.js +241 -298
  113. package/dist/src/cli/simple-commands/sparc/phase-base.js +314 -390
  114. package/dist/src/cli/simple-commands/sparc/pseudocode.js +965 -869
  115. package/dist/src/cli/simple-commands/sparc/refinement.js +980 -1273
  116. package/dist/src/cli/simple-commands/sparc/specification.js +559 -645
  117. package/dist/src/cli/simple-commands/sparc-modes/architect.js +1 -1
  118. package/dist/src/cli/simple-commands/sparc-modes/ask.js +1 -1
  119. package/dist/src/cli/simple-commands/sparc-modes/code.js +1 -1
  120. package/dist/src/cli/simple-commands/sparc-modes/debug.js +1 -1
  121. package/dist/src/cli/simple-commands/sparc-modes/devops.js +1 -1
  122. package/dist/src/cli/simple-commands/sparc-modes/docs-writer.js +1 -1
  123. package/dist/src/cli/simple-commands/sparc-modes/generic.js +1 -1
  124. package/dist/src/cli/simple-commands/sparc-modes/index.js +47 -55
  125. package/dist/src/cli/simple-commands/sparc-modes/integration.js +1 -1
  126. package/dist/src/cli/simple-commands/sparc-modes/mcp.js +1 -1
  127. package/dist/src/cli/simple-commands/sparc-modes/monitoring.js +1 -1
  128. package/dist/src/cli/simple-commands/sparc-modes/optimization.js +1 -1
  129. package/dist/src/cli/simple-commands/sparc-modes/security-review.js +1 -1
  130. package/dist/src/cli/simple-commands/sparc-modes/sparc-orchestrator.js +1 -1
  131. package/dist/src/cli/simple-commands/sparc-modes/spec-pseudocode.js +1 -1
  132. package/dist/src/cli/simple-commands/sparc-modes/supabase-admin.js +1 -1
  133. package/dist/src/cli/simple-commands/sparc-modes/swarm.js +101 -87
  134. package/dist/src/cli/simple-commands/sparc-modes/tdd.js +1 -1
  135. package/dist/src/cli/simple-commands/sparc-modes/tutorial.js +1 -1
  136. package/dist/src/cli/simple-commands/sparc.js +465 -493
  137. package/dist/src/cli/simple-commands/start-ui.js +108 -132
  138. package/dist/src/cli/simple-commands/start-wrapper.js +240 -268
  139. package/dist/src/cli/simple-commands/start.js +1 -1
  140. package/dist/src/cli/simple-commands/status.js +254 -275
  141. package/dist/src/cli/simple-commands/stream-chain-clean.js +128 -171
  142. package/dist/src/cli/simple-commands/stream-chain-fixed.js +61 -82
  143. package/dist/src/cli/simple-commands/stream-chain-real.js +267 -331
  144. package/dist/src/cli/simple-commands/stream-chain-working.js +211 -263
  145. package/dist/src/cli/simple-commands/stream-chain.js +260 -318
  146. package/dist/src/cli/simple-commands/stream-processor.js +290 -315
  147. package/dist/src/cli/simple-commands/swarm-executor.js +189 -222
  148. package/dist/src/cli/simple-commands/swarm-metrics-integration.js +208 -300
  149. package/dist/src/cli/simple-commands/swarm-ui.js +623 -703
  150. package/dist/src/cli/simple-commands/swarm-webui-integration.js +258 -286
  151. package/dist/src/cli/simple-commands/swarm.js +887 -1082
  152. package/dist/src/cli/simple-commands/task.js +161 -206
  153. package/dist/src/cli/simple-commands/timestamp-fix.js +59 -89
  154. package/dist/src/cli/simple-commands/token-tracker.js +258 -316
  155. package/dist/src/cli/simple-commands/tool-execution-framework.js +433 -519
  156. package/dist/src/cli/simple-commands/train-and-stream.js +275 -331
  157. package/dist/src/cli/simple-commands/training-pipeline.js +619 -725
  158. package/dist/src/cli/simple-commands/training.js +170 -227
  159. package/dist/src/cli/simple-commands/verification-hooks.js +261 -284
  160. package/dist/src/cli/simple-commands/verification-integration.js +389 -417
  161. package/dist/src/cli/simple-commands/verification-training-integration.js +486 -606
  162. package/dist/src/cli/simple-commands/verification.js +493 -513
  163. package/dist/src/cli/simple-commands/web-server.js +766 -836
  164. package/dist/src/cli/simple-commands/webui-validator.js +106 -124
  165. package/dist/src/coordination/event-bus/demo-wasm-integration.js +212 -251
  166. package/dist/src/coordination/event-bus/qe-event-bus.js +608 -748
  167. package/dist/src/coordination/event-bus/qe-event-bus.test.js +379 -454
  168. package/dist/src/coordination/iteration-tracker.js +363 -454
  169. package/dist/src/enterprise/analytics-manager.js +1135 -0
  170. package/dist/src/enterprise/audit-manager.js +1115 -0
  171. package/dist/src/enterprise/cloud-manager.js +891 -0
  172. package/dist/src/enterprise/deployment-manager.js +966 -0
  173. package/dist/src/enterprise/index.js +6 -0
  174. package/dist/src/enterprise/project-manager.js +584 -0
  175. package/dist/src/enterprise/security-manager.js +991 -0
  176. package/dist/src/index.js +1 -1
  177. package/dist/src/mcp/DEPRECATED.js +46 -60
  178. package/dist/src/mcp/fixes/mcp-error-fixes.js +115 -134
  179. package/dist/src/mcp/implementations/agent-tracker.js +114 -128
  180. package/dist/src/mcp/implementations/daa-tools.js +292 -350
  181. package/dist/src/mcp/implementations/workflow-tools.js +329 -361
  182. package/dist/src/mcp/mcp-config-manager.js +1183 -1331
  183. package/dist/src/mcp/mcp-server-novice-simplified.js +11 -17
  184. package/dist/src/mcp/mcp-server-novice.js +11 -17
  185. package/dist/src/mcp/mcp-server-sdk.js +11 -17
  186. package/dist/src/mcp/mcp-server.js +1620 -1484
  187. package/dist/src/mcp/ruv-swarm-wrapper.js +209 -239
  188. package/dist/src/memory/advanced-serializer.js +609 -589
  189. package/dist/src/memory/enhanced-examples.js +220 -305
  190. package/dist/src/memory/enhanced-memory.js +295 -336
  191. package/dist/src/memory/enhanced-session-serializer.js +408 -492
  192. package/dist/src/memory/fallback-memory-system.js +900 -1021
  193. package/dist/src/memory/fallback-store.js +93 -131
  194. package/dist/src/memory/high-performance-serialization.js +592 -730
  195. package/dist/src/memory/in-memory-store.js +161 -213
  196. package/dist/src/memory/index.js +123 -157
  197. package/dist/src/memory/lock-free-structures.js +578 -764
  198. package/dist/src/memory/memory-mapped-persistence.js +585 -766
  199. package/dist/src/memory/memory-pressure-manager.js +569 -707
  200. package/dist/src/memory/migration.js +358 -445
  201. package/dist/src/memory/shared-memory.js +641 -768
  202. package/dist/src/memory/sqlite-store.js +245 -325
  203. package/dist/src/memory/sqlite-wrapper.js +122 -151
  204. package/dist/src/memory/swarm-memory.js +470 -603
  205. package/dist/src/memory/test-example.js +126 -134
  206. package/dist/src/memory/ultra-fast-memory-store.js +622 -821
  207. package/dist/src/memory/unified-memory-manager.js +356 -437
  208. package/dist/src/migration/index.js +92 -0
  209. package/dist/src/migration/logger.js +121 -0
  210. package/dist/src/migration/migration-analyzer.js +268 -0
  211. package/dist/src/migration/migration-runner.js +522 -0
  212. package/dist/src/migration/migration-validator.js +285 -0
  213. package/dist/src/migration/progress-reporter.js +150 -0
  214. package/dist/src/migration/rollback-manager.js +321 -0
  215. package/dist/src/migration/tests/migration-system.test.js +7 -0
  216. package/dist/src/migration/types.js +3 -0
  217. package/dist/src/swarm/CodeRefactoringSwarm.js +777 -952
  218. package/dist/src/swarm/__tests__/integration.test.js +227 -0
  219. package/dist/src/swarm/__tests__/prompt-copier.test.js +344 -0
  220. package/dist/src/swarm/advanced-orchestrator.js +1095 -0
  221. package/dist/src/swarm/claude-code-interface.js +961 -0
  222. package/dist/src/swarm/claude-flow-executor.js +229 -0
  223. package/dist/src/swarm/consensus-coordinator.js +475 -0
  224. package/dist/src/swarm/coordinator.js +2993 -0
  225. package/dist/src/swarm/direct-executor.js +1180 -0
  226. package/dist/src/swarm/error-recovery/advanced-error-detection.js +691 -0
  227. package/dist/src/swarm/error-recovery/automated-recovery-workflows.js +998 -0
  228. package/dist/src/swarm/error-recovery/error-recovery-coordinator.js +1197 -0
  229. package/dist/src/swarm/error-recovery/recovery-monitoring.js +772 -0
  230. package/dist/src/swarm/error-recovery/resilience-architecture.js +714 -0
  231. package/dist/src/swarm/error-recovery/self-healing-mechanisms.js +1319 -0
  232. package/dist/src/swarm/error-recovery/test-error-recovery-effectiveness.js +808 -0
  233. package/dist/src/swarm/executor-v2.js +322 -0
  234. package/dist/src/swarm/executor.js +815 -0
  235. package/dist/src/swarm/hive-mind-integration.js +703 -0
  236. package/dist/src/swarm/index.js +41 -0
  237. package/dist/src/swarm/json-output-aggregator.js +267 -0
  238. package/dist/src/swarm/large-scale-coordinator.js +542 -0
  239. package/dist/src/swarm/mcp-integration-wrapper.js +628 -0
  240. package/dist/src/swarm/memory.js +1117 -0
  241. package/dist/src/swarm/optimizations/__tests__/optimization.test.js +348 -0
  242. package/dist/src/swarm/optimizations/async-file-manager.js +285 -0
  243. package/dist/src/swarm/optimizations/circular-buffer.js +162 -0
  244. package/dist/src/swarm/optimizations/connection-pool.js +244 -0
  245. package/dist/src/swarm/optimizations/index.js +28 -0
  246. package/dist/src/swarm/optimizations/optimized-executor.js +320 -0
  247. package/dist/src/swarm/optimizations/ttl-map.js +234 -0
  248. package/dist/src/swarm/prompt-cli.js +200 -0
  249. package/dist/src/swarm/prompt-copier-enhanced.js +202 -0
  250. package/dist/src/swarm/prompt-copier.js +381 -0
  251. package/dist/src/swarm/prompt-manager.js +295 -0
  252. package/dist/src/swarm/prompt-utils.js +310 -0
  253. package/dist/src/swarm/result-aggregator.js +718 -0
  254. package/dist/src/swarm/sparc-executor.js +1568 -0
  255. package/dist/src/swarm/strategies/auto.js +758 -0
  256. package/dist/src/swarm/strategies/base.js +128 -0
  257. package/dist/src/swarm/strategies/research.js +914 -0
  258. package/dist/src/swarm/strategies/strategy-metrics-patch.js +2 -0
  259. package/dist/src/swarm/types.js +52 -0
  260. package/dist/src/swarm/workers/copy-worker.js +56 -0
  261. package/dist/src/utils/__tests__/github-cli-safety-wrapper.test.js +332 -400
  262. package/dist/src/utils/github-cli-safe.js +56 -64
  263. package/dist/src/utils/github-cli-safety-wrapper.js +451 -546
  264. package/dist/src/utils/npx-isolated-cache.js +104 -119
  265. package/dist/src/utils/preference-manager.js +622 -652
  266. package/dist/src/utils/timezone-utils.js +86 -105
  267. package/dist/src/validators/epic-config-schema.js +214 -0
  268. package/dist/src/validators/index.js +10 -0
  269. package/dist/src/validators/swarm-init-validator.js +259 -0
  270. package/dist/src/validators/todowrite-batching-validator.js +215 -0
  271. package/dist/src/validators/todowrite-integration.js +187 -0
  272. package/package.json +2 -2
@@ -1,604 +1,471 @@
1
+ function _define_property(obj, key, value) {
2
+ if (key in obj) {
3
+ Object.defineProperty(obj, key, {
4
+ value: value,
5
+ enumerable: true,
6
+ configurable: true,
7
+ writable: true
8
+ });
9
+ } else {
10
+ obj[key] = value;
11
+ }
12
+ return obj;
13
+ }
14
+ import { EventEmitter } from "node:events";
15
+ import { Logger } from "../core/logger.js";
16
+ import { MemoryManager } from "./manager.js";
17
+ import { EventBus } from "../core/event-bus.js";
18
+ import { generateId } from "../utils/helpers.js";
19
+ import * as fs from "node:fs/promises";
20
+ import * as path from "node:path";
21
+ export class SwarmMemoryManager extends EventEmitter {
22
+ async initialize() {
23
+ if (this.isInitialized) return;
24
+ this.logger.info('Initializing swarm memory manager...');
25
+ // Initialize base memory
26
+ await this.baseMemory.initialize();
27
+ // Create persistence directory
28
+ await fs.mkdir(this.config.persistencePath, {
29
+ recursive: true
30
+ });
31
+ // Load existing memory
32
+ await this.loadMemoryState();
33
+ // Start sync timer
34
+ if (this.config.syncInterval > 0) {
35
+ this.syncTimer = setInterval(()=>{
36
+ this.syncMemoryState();
37
+ }, this.config.syncInterval);
38
+ }
39
+ this.isInitialized = true;
40
+ this.emit('memory:initialized');
41
+ }
42
+ async shutdown() {
43
+ if (!this.isInitialized) return;
44
+ this.logger.info('Shutting down swarm memory manager...');
45
+ // Stop sync timer
46
+ if (this.syncTimer) {
47
+ clearInterval(this.syncTimer);
48
+ this.syncTimer = undefined;
49
+ }
50
+ // Save final state
51
+ await this.saveMemoryState();
52
+ this.isInitialized = false;
53
+ this.emit('memory:shutdown');
54
+ }
55
+ /**
56
+ * Close database connections and cleanup resources
57
+ * Alias for shutdown() to match test expectations
58
+ */ async close() {
59
+ await this.shutdown();
60
+ }
61
+ async remember(agentId, type, content, metadata = {}) {
62
+ const entryId = generateId('mem');
63
+ const entry = {
64
+ id: entryId,
65
+ agentId,
66
+ type,
67
+ content,
68
+ timestamp: new Date(),
69
+ metadata: {
70
+ shareLevel: 'team',
71
+ priority: 1,
72
+ ...metadata
73
+ }
74
+ };
75
+ this.entries.set(entryId, entry);
76
+ // Associate with agent
77
+ if (!this.agentMemories.has(agentId)) {
78
+ this.agentMemories.set(agentId, new Set());
79
+ }
80
+ this.agentMemories.get(agentId).add(entryId);
81
+ // Store in base memory for persistence
82
+ await this.baseMemory.store({
83
+ id: `entry:${entryId}`,
84
+ agentId,
85
+ sessionId: metadata.taskId || 'swarm-session',
86
+ type: 'artifact',
87
+ content: JSON.stringify(entry),
88
+ context: {
89
+ entryType: type,
90
+ shareLevel: entry.metadata.shareLevel
91
+ },
92
+ timestamp: entry.timestamp,
93
+ tags: metadata.tags || [],
94
+ version: 1
95
+ });
96
+ this.logger.debug(`Agent ${agentId} remembered: ${type} - ${entryId}`);
97
+ this.emit('memory:added', entry);
98
+ // Update knowledge base if applicable
99
+ if (type === 'knowledge' && this.config.enableKnowledgeBase) {
100
+ await this.updateKnowledgeBase(entry);
101
+ }
102
+ // Check for memory limits
103
+ await this.enforceMemoryLimits();
104
+ return entryId;
105
+ }
106
+ async recall(query) {
107
+ let results = Array.from(this.entries.values());
108
+ // Apply filters
109
+ if (query.agentId) {
110
+ results = results.filter((e)=>e.agentId === query.agentId);
111
+ }
112
+ if (query.type) {
113
+ results = results.filter((e)=>e.type === query.type);
114
+ }
115
+ if (query.taskId) {
116
+ results = results.filter((e)=>e.metadata.taskId === query.taskId);
117
+ }
118
+ if (query.objectiveId) {
119
+ results = results.filter((e)=>e.metadata.objectiveId === query.objectiveId);
120
+ }
121
+ if (query.tags && query.tags.length > 0) {
122
+ results = results.filter((e)=>e.metadata.tags && query.tags.some((tag)=>e.metadata.tags.includes(tag)));
123
+ }
124
+ if (query.since) {
125
+ results = results.filter((e)=>e.timestamp >= query.since);
126
+ }
127
+ if (query.before) {
128
+ results = results.filter((e)=>e.timestamp <= query.before);
129
+ }
130
+ if (query.shareLevel) {
131
+ results = results.filter((e)=>e.metadata.shareLevel === query.shareLevel);
132
+ }
133
+ // Sort by timestamp (newest first)
134
+ results.sort((a, b)=>b.timestamp.getTime() - a.timestamp.getTime());
135
+ // Apply limit
136
+ if (query.limit) {
137
+ results = results.slice(0, query.limit);
138
+ }
139
+ this.logger.debug(`Recalled ${results.length} memories for query`);
140
+ return results;
141
+ }
142
+ async shareMemory(entryId, targetAgentId) {
143
+ const entry = this.entries.get(entryId);
144
+ if (!entry) {
145
+ throw new Error('Memory entry not found');
146
+ }
147
+ if (!this.config.enableCrossAgentSharing) {
148
+ throw new Error('Cross-agent sharing is disabled');
149
+ }
150
+ // Check share level permissions
151
+ if (entry.metadata.shareLevel === 'private') {
152
+ throw new Error('Memory entry is private and cannot be shared');
153
+ }
154
+ // Create a shared copy for the target agent
155
+ const sharedEntry = {
156
+ ...entry,
157
+ id: generateId('mem'),
158
+ metadata: {
159
+ ...entry.metadata,
160
+ originalId: entryId,
161
+ sharedFrom: entry.agentId,
162
+ sharedTo: targetAgentId,
163
+ sharedAt: new Date()
164
+ }
165
+ };
166
+ this.entries.set(sharedEntry.id, sharedEntry);
167
+ // Associate with target agent
168
+ if (!this.agentMemories.has(targetAgentId)) {
169
+ this.agentMemories.set(targetAgentId, new Set());
170
+ }
171
+ this.agentMemories.get(targetAgentId).add(sharedEntry.id);
172
+ this.logger.info(`Shared memory ${entryId} from ${entry.agentId} to ${targetAgentId}`);
173
+ this.emit('memory:shared', {
174
+ original: entry,
175
+ shared: sharedEntry
176
+ });
177
+ }
178
+ async broadcastMemory(entryId, agentIds) {
179
+ const entry = this.entries.get(entryId);
180
+ if (!entry) {
181
+ throw new Error('Memory entry not found');
182
+ }
183
+ if (entry.metadata.shareLevel === 'private') {
184
+ throw new Error('Cannot broadcast private memory');
185
+ }
186
+ const targets = agentIds || Array.from(this.agentMemories.keys()).filter((id)=>id !== entry.agentId);
187
+ for (const targetId of targets){
188
+ try {
189
+ await this.shareMemory(entryId, targetId);
190
+ } catch (error) {
191
+ this.logger.warn(`Failed to share memory to ${targetId}:`, error);
192
+ }
193
+ }
194
+ this.logger.info(`Broadcasted memory ${entryId} to ${targets.length} agents`);
195
+ }
196
+ async createKnowledgeBase(name, description, domain, expertise) {
197
+ const kbId = generateId('kb');
198
+ const knowledgeBase = {
199
+ id: kbId,
200
+ name,
201
+ description,
202
+ entries: [],
203
+ metadata: {
204
+ domain,
205
+ expertise,
206
+ contributors: [],
207
+ lastUpdated: new Date()
208
+ }
209
+ };
210
+ this.knowledgeBases.set(kbId, knowledgeBase);
211
+ this.logger.info(`Created knowledge base: ${name} (${kbId})`);
212
+ this.emit('knowledgebase:created', knowledgeBase);
213
+ return kbId;
214
+ }
215
+ async updateKnowledgeBase(entry) {
216
+ if (!this.config.enableKnowledgeBase) return;
217
+ // Find relevant knowledge bases
218
+ const relevantKBs = Array.from(this.knowledgeBases.values()).filter((kb)=>{
219
+ // Simple matching based on tags and content
220
+ const tags = entry.metadata.tags || [];
221
+ return tags.some((tag)=>kb.metadata.expertise.some((exp)=>exp.toLowerCase().includes(tag.toLowerCase()) || tag.toLowerCase().includes(exp.toLowerCase())));
222
+ });
223
+ for (const kb of relevantKBs){
224
+ // Add entry to knowledge base
225
+ kb.entries.push(entry);
226
+ kb.metadata.lastUpdated = new Date();
227
+ // Add contributor
228
+ if (!kb.metadata.contributors.includes(entry.agentId)) {
229
+ kb.metadata.contributors.push(entry.agentId);
230
+ }
231
+ this.logger.debug(`Updated knowledge base ${kb.id} with entry ${entry.id}`);
232
+ }
233
+ }
234
+ async searchKnowledge(query, domain, expertise) {
235
+ const allEntries = [];
236
+ // Search in knowledge bases
237
+ for (const kb of this.knowledgeBases.values()){
238
+ if (domain && kb.metadata.domain !== domain) continue;
239
+ if (expertise && !expertise.some((exp)=>kb.metadata.expertise.includes(exp))) {
240
+ continue;
241
+ }
242
+ allEntries.push(...kb.entries);
243
+ }
244
+ // Simple text search (in real implementation, use better search)
245
+ const queryLower = query.toLowerCase();
246
+ const results = allEntries.filter((entry)=>{
247
+ const contentStr = JSON.stringify(entry.content).toLowerCase();
248
+ return contentStr.includes(queryLower);
249
+ });
250
+ return results.slice(0, 50); // Limit results
251
+ }
252
+ async getAgentMemorySnapshot(agentId) {
253
+ const agentEntryIds = this.agentMemories.get(agentId) || new Set();
254
+ const agentEntries = Array.from(agentEntryIds).map((id)=>this.entries.get(id)).filter(Boolean);
255
+ const recentEntries = agentEntries.sort((a, b)=>b.timestamp.getTime() - a.timestamp.getTime()).slice(0, 10);
256
+ const knowledgeContributions = agentEntries.filter((e)=>e.type === 'knowledge').length;
257
+ const sharedEntries = agentEntries.filter((e)=>e.metadata.shareLevel === 'public' || e.metadata.shareLevel === 'team').length;
258
+ return {
259
+ totalEntries: agentEntries.length,
260
+ recentEntries,
261
+ knowledgeContributions,
262
+ sharedEntries
263
+ };
264
+ }
265
+ async loadMemoryState() {
266
+ try {
267
+ // Load entries
268
+ const entriesFile = path.join(this.config.persistencePath, 'entries.json');
269
+ try {
270
+ const entriesData = await fs.readFile(entriesFile, 'utf-8');
271
+ const entriesArray = JSON.parse(entriesData);
272
+ for (const entry of entriesArray){
273
+ this.entries.set(entry.id, {
274
+ ...entry,
275
+ timestamp: new Date(entry.timestamp)
276
+ });
277
+ // Rebuild agent memory associations
278
+ if (!this.agentMemories.has(entry.agentId)) {
279
+ this.agentMemories.set(entry.agentId, new Set());
280
+ }
281
+ this.agentMemories.get(entry.agentId).add(entry.id);
282
+ }
283
+ this.logger.info(`Loaded ${entriesArray.length} memory entries`);
284
+ } catch (error) {
285
+ this.logger.warn('No existing memory entries found');
286
+ }
287
+ // Load knowledge bases
288
+ const kbFile = path.join(this.config.persistencePath, 'knowledge-bases.json');
289
+ try {
290
+ const kbData = await fs.readFile(kbFile, 'utf-8');
291
+ const kbArray = JSON.parse(kbData);
292
+ for (const kb of kbArray){
293
+ this.knowledgeBases.set(kb.id, {
294
+ ...kb,
295
+ metadata: {
296
+ ...kb.metadata,
297
+ lastUpdated: new Date(kb.metadata.lastUpdated)
298
+ },
299
+ entries: kb.entries.map((e)=>({
300
+ ...e,
301
+ timestamp: new Date(e.timestamp)
302
+ }))
303
+ });
304
+ }
305
+ this.logger.info(`Loaded ${kbArray.length} knowledge bases`);
306
+ } catch (error) {
307
+ this.logger.warn('No existing knowledge bases found');
308
+ }
309
+ } catch (error) {
310
+ this.logger.error('Error loading memory state:', error);
311
+ }
312
+ }
313
+ async saveMemoryState() {
314
+ try {
315
+ // Save entries
316
+ const entriesArray = Array.from(this.entries.values());
317
+ const entriesFile = path.join(this.config.persistencePath, 'entries.json');
318
+ await fs.writeFile(entriesFile, JSON.stringify(entriesArray, null, 2));
319
+ // Save knowledge bases
320
+ const kbArray = Array.from(this.knowledgeBases.values());
321
+ const kbFile = path.join(this.config.persistencePath, 'knowledge-bases.json');
322
+ await fs.writeFile(kbFile, JSON.stringify(kbArray, null, 2));
323
+ this.logger.debug('Saved memory state to disk');
324
+ } catch (error) {
325
+ this.logger.error('Error saving memory state:', error);
326
+ }
327
+ }
328
+ async syncMemoryState() {
329
+ try {
330
+ await this.saveMemoryState();
331
+ this.emit('memory:synced');
332
+ } catch (error) {
333
+ this.logger.error('Error syncing memory state:', error);
334
+ }
335
+ }
336
+ async enforceMemoryLimits() {
337
+ if (this.entries.size <= this.config.maxEntries) return;
338
+ this.logger.info('Enforcing memory limits...');
339
+ // Remove oldest entries that are not marked as important
340
+ const entries = Array.from(this.entries.values()).filter((e)=>(e.metadata.priority || 1) <= 1) // Only remove low priority
341
+ .sort((a, b)=>a.timestamp.getTime() - b.timestamp.getTime());
342
+ const toRemove = entries.slice(0, this.entries.size - this.config.maxEntries);
343
+ for (const entry of toRemove){
344
+ this.entries.delete(entry.id);
345
+ // Remove from agent memory
346
+ const agentEntries = this.agentMemories.get(entry.agentId);
347
+ if (agentEntries) {
348
+ agentEntries.delete(entry.id);
349
+ }
350
+ this.logger.debug(`Removed old memory entry: ${entry.id}`);
351
+ }
352
+ this.emit('memory:cleaned', toRemove.length);
353
+ }
354
+ // Public API methods
355
+ getMemoryStats() {
356
+ const entries = Array.from(this.entries.values());
357
+ const entriesByType = {};
358
+ const entriesByAgent = {};
359
+ for (const entry of entries){
360
+ entriesByType[entry.type] = (entriesByType[entry.type] || 0) + 1;
361
+ entriesByAgent[entry.agentId] = (entriesByAgent[entry.agentId] || 0) + 1;
362
+ }
363
+ // Rough memory usage calculation
364
+ const memoryUsage = JSON.stringify(entries).length;
365
+ return {
366
+ totalEntries: entries.length,
367
+ entriesByType,
368
+ entriesByAgent,
369
+ knowledgeBases: this.knowledgeBases.size,
370
+ memoryUsage
371
+ };
372
+ }
373
+ async exportMemory(agentId) {
374
+ const entries = agentId ? await this.recall({
375
+ agentId
376
+ }) : Array.from(this.entries.values());
377
+ return {
378
+ entries,
379
+ knowledgeBases: agentId ? Array.from(this.knowledgeBases.values()).filter((kb)=>kb.metadata.contributors.includes(agentId)) : Array.from(this.knowledgeBases.values()),
380
+ exportedAt: new Date(),
381
+ stats: this.getMemoryStats()
382
+ };
383
+ }
384
+ async clearMemory(agentId) {
385
+ if (agentId) {
386
+ // Clear specific agent's memory
387
+ const entryIds = this.agentMemories.get(agentId) || new Set();
388
+ for (const entryId of entryIds){
389
+ this.entries.delete(entryId);
390
+ }
391
+ this.agentMemories.delete(agentId);
392
+ this.logger.info(`Cleared memory for agent ${agentId}`);
393
+ } else {
394
+ // Clear all memory
395
+ this.entries.clear();
396
+ this.agentMemories.clear();
397
+ this.knowledgeBases.clear();
398
+ this.logger.info('Cleared all swarm memory');
399
+ }
400
+ this.emit('memory:cleared', {
401
+ agentId
402
+ });
403
+ }
404
+ // Compatibility methods for hive.ts
405
+ async store(key, value) {
406
+ // Extract namespace and actual key from the path
407
+ const parts = key.split('/');
408
+ const type = parts[0] || 'state';
409
+ const agentId = parts[1] || 'system';
410
+ await this.remember(agentId, type, value, {
411
+ tags: [
412
+ parts[0],
413
+ parts[1]
414
+ ].filter(Boolean),
415
+ shareLevel: 'team'
416
+ });
417
+ }
418
+ async search(pattern, limit = 10) {
419
+ // Simple pattern matching on stored keys/content
420
+ const results = [];
421
+ for (const entry of this.entries.values()){
422
+ const entryString = JSON.stringify(entry);
423
+ if (entryString.includes(pattern.replace('*', ''))) {
424
+ results.push(entry.content);
425
+ if (results.length >= limit) break;
426
+ }
427
+ }
428
+ return results;
429
+ }
430
+ constructor(config = {}){
431
+ super(), _define_property(this, "logger", void 0), _define_property(this, "config", void 0), _define_property(this, "baseMemory", void 0), _define_property(this, "entries", void 0), _define_property(this, "knowledgeBases", void 0), _define_property(this, "agentMemories", void 0 // agentId -> set of entry IDs
432
+ ), _define_property(this, "syncTimer", void 0), _define_property(this, "isInitialized", false);
433
+ this.logger = new Logger({
434
+ level: 'info',
435
+ format: 'json',
436
+ destination: 'console'
437
+ }, {
438
+ component: 'SwarmMemoryManager'
439
+ });
440
+ this.config = {
441
+ namespace: 'swarm',
442
+ enableDistribution: true,
443
+ enableReplication: true,
444
+ syncInterval: 10000,
445
+ maxEntries: 10000,
446
+ compressionThreshold: 1000,
447
+ enableKnowledgeBase: true,
448
+ enableCrossAgentSharing: true,
449
+ persistencePath: './swarm-memory',
450
+ ...config
451
+ };
452
+ this.entries = new Map();
453
+ this.knowledgeBases = new Map();
454
+ this.agentMemories = new Map();
455
+ const eventBus = EventBus.getInstance();
456
+ this.baseMemory = new MemoryManager({
457
+ backend: 'sqlite',
458
+ cacheSizeMB: 50,
459
+ syncInterval: 5000,
460
+ conflictResolution: 'last-write',
461
+ retentionDays: 30,
462
+ sqlitePath: './swarm-memory.db'
463
+ }, eventBus, this.logger);
464
+ }
465
+ }
1
466
  /**
2
- * SwarmMemory - MCP-specific memory persistence extending SharedMemory
3
- * Provides swarm-specific features like agent coordination, task tracking, and neural patterns
4
- *
5
- * @module swarm-memory
6
- */
7
-
8
- import { SharedMemory } from './shared-memory.js';
9
- import path from 'path';
10
-
11
- /**
12
- * Swarm-specific namespaces
13
- */
14
- const SWARM_NAMESPACES = {
15
- AGENTS: 'swarm:agents',
16
- TASKS: 'swarm:tasks',
17
- COMMUNICATIONS: 'swarm:communications',
18
- CONSENSUS: 'swarm:consensus',
19
- PATTERNS: 'swarm:patterns',
20
- METRICS: 'swarm:metrics',
21
- COORDINATION: 'swarm:coordination',
22
- };
23
-
24
- /**
25
- * SwarmMemory class - Extends SharedMemory with MCP features
26
- */
27
- export class SwarmMemory extends SharedMemory {
28
- constructor(options = {}) {
29
- // Default to .swarm directory for MCP
30
- super({
31
- directory: options.directory || '.swarm',
32
- filename: options.filename || 'swarm-memory.db',
33
- ...options,
34
- });
35
-
36
- this.swarmId = options.swarmId || 'default';
37
- this.mcpMode = options.mcpMode !== false;
38
-
39
- // Additional swarm-specific caches
40
- this.agentCache = new Map();
41
- this.taskCache = new Map();
42
- this.patternCache = new Map();
43
- }
44
-
45
- /**
46
- * Initialize with swarm-specific setup
47
- */
48
- async initialize() {
49
- await super.initialize();
50
-
51
- // Initialize swarm-specific namespaces
52
- await this._initializeSwarmNamespaces();
53
-
54
- // Load active agents and tasks into cache
55
- await this._loadSwarmState();
56
-
57
- this.emit('swarm:initialized', { swarmId: this.swarmId });
58
- }
59
-
60
- /**
61
- * Store agent information
62
- */
63
- async storeAgent(agentId, agentData) {
64
- const key = `agent:${agentId}`;
65
- const enrichedData = {
66
- ...agentData,
67
- swarmId: this.swarmId,
68
- lastUpdated: new Date().toISOString(),
69
- };
70
-
71
- await this.store(key, enrichedData, {
72
- namespace: SWARM_NAMESPACES.AGENTS,
73
- tags: ['agent', agentData.type, agentData.status],
74
- metadata: {
75
- swarmId: this.swarmId,
76
- agentType: agentData.type,
77
- },
78
- });
79
-
80
- // Update agent cache
81
- this.agentCache.set(agentId, enrichedData);
82
-
83
- this.emit('swarm:agentStored', { agentId, type: agentData.type });
84
-
85
- return { agentId, stored: true };
86
- }
87
-
88
- /**
89
- * Retrieve agent information
90
- */
91
- async getAgent(agentId) {
92
- // Check cache first
93
- if (this.agentCache.has(agentId)) {
94
- return this.agentCache.get(agentId);
95
- }
96
-
97
- const key = `agent:${agentId}`;
98
- const agent = await this.retrieve(key, SWARM_NAMESPACES.AGENTS);
99
-
100
- if (agent) {
101
- this.agentCache.set(agentId, agent);
102
- }
103
-
104
- return agent;
105
- }
106
-
107
- /**
108
- * List all agents in swarm
109
- */
110
- async listAgents(filter = {}) {
111
- const agents = await this.list(SWARM_NAMESPACES.AGENTS, {
112
- limit: filter.limit || 100,
113
- });
114
-
115
- return agents
116
- .map((entry) => entry.value)
117
- .filter((agent) => {
118
- if (filter.type && agent.type !== filter.type) return false;
119
- if (filter.status && agent.status !== filter.status) return false;
120
- if (filter.swarmId && agent.swarmId !== filter.swarmId) return false;
121
- return true;
122
- });
123
- }
124
-
125
- /**
126
- * Store task information
127
- */
128
- async storeTask(taskId, taskData) {
129
- const key = `task:${taskId}`;
130
- const enrichedData = {
131
- ...taskData,
132
- swarmId: this.swarmId,
133
- createdAt: taskData.createdAt || new Date().toISOString(),
134
- updatedAt: new Date().toISOString(),
135
- };
136
-
137
- await this.store(key, enrichedData, {
138
- namespace: SWARM_NAMESPACES.TASKS,
139
- tags: ['task', taskData.status, taskData.priority],
140
- metadata: {
141
- swarmId: this.swarmId,
142
- assignedAgents: taskData.assignedAgents || [],
143
- },
144
- });
145
-
146
- // Update task cache
147
- this.taskCache.set(taskId, enrichedData);
148
-
149
- this.emit('swarm:taskStored', { taskId, status: taskData.status });
150
-
151
- return { taskId, stored: true };
152
- }
153
-
154
- /**
155
- * Update task status
156
- */
157
- async updateTaskStatus(taskId, status, result = null) {
158
- const task = await this.getTask(taskId);
159
- if (!task) {
160
- throw new Error(`Task ${taskId} not found`);
161
- }
162
-
163
- task.status = status;
164
- task.updatedAt = new Date().toISOString();
165
-
166
- if (result) {
167
- task.result = result;
168
- }
169
-
170
- if (status === 'completed') {
171
- task.completedAt = new Date().toISOString();
172
- }
173
-
174
- await this.storeTask(taskId, task);
175
-
176
- this.emit('swarm:taskStatusUpdated', { taskId, status });
177
-
178
- return { taskId, status, updated: true };
179
- }
180
-
181
- /**
182
- * Get task information
183
- */
184
- async getTask(taskId) {
185
- // Check cache first
186
- if (this.taskCache.has(taskId)) {
187
- return this.taskCache.get(taskId);
188
- }
189
-
190
- const key = `task:${taskId}`;
191
- const task = await this.retrieve(key, SWARM_NAMESPACES.TASKS);
192
-
193
- if (task) {
194
- this.taskCache.set(taskId, task);
195
- }
196
-
197
- return task;
198
- }
199
-
200
- /**
201
- * Store inter-agent communication
202
- */
203
- async storeCommunication(fromAgent, toAgent, message) {
204
- const commId = `comm:${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
205
- const communication = {
206
- id: commId,
207
- fromAgent,
208
- toAgent,
209
- message,
210
- swarmId: this.swarmId,
211
- timestamp: new Date().toISOString(),
212
- };
213
-
214
- await this.store(commId, communication, {
215
- namespace: SWARM_NAMESPACES.COMMUNICATIONS,
216
- ttl: 86400, // 24 hours
217
- tags: ['communication', message.type],
218
- metadata: {
219
- fromAgent,
220
- toAgent,
221
- messageType: message.type,
222
- },
223
- });
224
-
225
- this.emit('swarm:communication', { fromAgent, toAgent, type: message.type });
226
-
227
- return { id: commId, stored: true };
228
- }
229
-
230
- /**
231
- * Store consensus decision
232
- */
233
- async storeConsensus(consensusId, decision) {
234
- const key = `consensus:${consensusId}`;
235
- const consensusData = {
236
- ...decision,
237
- swarmId: this.swarmId,
238
- timestamp: new Date().toISOString(),
239
- };
240
-
241
- await this.store(key, consensusData, {
242
- namespace: SWARM_NAMESPACES.CONSENSUS,
243
- tags: ['consensus', decision.status],
244
- metadata: {
245
- swarmId: this.swarmId,
246
- taskId: decision.taskId,
247
- threshold: decision.threshold,
248
- },
249
- });
250
-
251
- this.emit('swarm:consensus', { consensusId, status: decision.status });
252
-
253
- return { consensusId, stored: true };
254
- }
255
-
256
- /**
257
- * Store neural pattern
258
- */
259
- async storePattern(patternId, pattern) {
260
- const key = `pattern:${patternId}`;
261
- const patternData = {
262
- ...pattern,
263
- swarmId: this.swarmId,
264
- createdAt: new Date().toISOString(),
265
- usageCount: 0,
266
- successRate: 0,
267
- };
268
-
269
- await this.store(key, patternData, {
270
- namespace: SWARM_NAMESPACES.PATTERNS,
271
- tags: ['pattern', pattern.type],
272
- metadata: {
273
- swarmId: this.swarmId,
274
- patternType: pattern.type,
275
- confidence: pattern.confidence || 0,
276
- },
277
- });
278
-
279
- // Cache frequently used patterns
280
- if (pattern.type === 'coordination' || pattern.type === 'optimization') {
281
- this.patternCache.set(patternId, patternData);
282
- }
283
-
284
- this.emit('swarm:patternStored', { patternId, type: pattern.type });
285
-
286
- return { patternId, stored: true };
287
- }
288
-
289
- /**
290
- * Update pattern usage and success metrics
291
- */
292
- async updatePatternMetrics(patternId, success = true) {
293
- const pattern = await this.getPattern(patternId);
294
- if (!pattern) {
295
- throw new Error(`Pattern ${patternId} not found`);
296
- }
297
-
298
- pattern.usageCount++;
299
- pattern.lastUsedAt = new Date().toISOString();
300
-
301
- // Update success rate with exponential moving average
302
- const alpha = 0.1; // Smoothing factor
303
- const currentSuccess = success ? 1 : 0;
304
- pattern.successRate = alpha * currentSuccess + (1 - alpha) * (pattern.successRate || 0);
305
-
306
- await this.storePattern(patternId, pattern);
307
-
308
- return { patternId, usageCount: pattern.usageCount, successRate: pattern.successRate };
309
- }
310
-
311
- /**
312
- * Get pattern
313
- */
314
- async getPattern(patternId) {
315
- // Check cache first
316
- if (this.patternCache.has(patternId)) {
317
- return this.patternCache.get(patternId);
318
- }
319
-
320
- const key = `pattern:${patternId}`;
321
- return await this.retrieve(key, SWARM_NAMESPACES.PATTERNS);
322
- }
323
-
324
- /**
325
- * Find best patterns for a given context
326
- */
327
- async findBestPatterns(context, limit = 5) {
328
- const patterns = await this.search({
329
- namespace: SWARM_NAMESPACES.PATTERNS,
330
- tags: context.tags,
331
- limit: 100,
332
- });
333
-
334
- // Score patterns based on success rate and relevance
335
- const scored = patterns.map((entry) => {
336
- const pattern = entry.value;
337
- const score =
338
- pattern.successRate * 0.7 +
339
- (pattern.confidence || 0) * 0.2 +
340
- (pattern.usageCount > 0 ? 0.1 : 0);
341
-
342
- return { ...pattern, score };
343
- });
344
-
345
- // Sort by score and return top patterns
346
- return scored.sort((a, b) => b.score - a.score).slice(0, limit);
347
- }
348
-
349
- /**
350
- * Store coordination state
351
- */
352
- async storeCoordination(key, state) {
353
- await this.store(key, state, {
354
- namespace: SWARM_NAMESPACES.COORDINATION,
355
- ttl: 3600, // 1 hour
356
- metadata: {
357
- swarmId: this.swarmId,
358
- timestamp: new Date().toISOString(),
359
- },
360
- });
361
-
362
- return { key, stored: true };
363
- }
364
-
365
- /**
366
- * Get coordination state
367
- */
368
- async getCoordination(key) {
369
- return await this.retrieve(key, SWARM_NAMESPACES.COORDINATION);
370
- }
371
-
372
- /**
373
- * Store performance metrics
374
- */
375
- async storeMetrics(metricsId, metrics) {
376
- const key = `metrics:${metricsId}`;
377
- await this.store(key, metrics, {
378
- namespace: SWARM_NAMESPACES.METRICS,
379
- ttl: 86400 * 7, // 7 days
380
- tags: ['metrics', metrics.type],
381
- metadata: {
382
- swarmId: this.swarmId,
383
- agentId: metrics.agentId,
384
- timestamp: new Date().toISOString(),
385
- },
386
- });
387
-
388
- this.emit('swarm:metricsStored', { metricsId, type: metrics.type });
389
-
390
- return { metricsId, stored: true };
391
- }
392
-
393
- /**
394
- * Get swarm statistics
395
- */
396
- async getSwarmStats() {
397
- const baseStats = await this.getStats();
398
-
399
- // Add swarm-specific stats
400
- const agentCount = await this._countNamespace(SWARM_NAMESPACES.AGENTS);
401
- const taskCount = await this._countNamespace(SWARM_NAMESPACES.TASKS);
402
- const patternCount = await this._countNamespace(SWARM_NAMESPACES.PATTERNS);
403
-
404
- // Get active agents
405
- const activeAgents = Array.from(this.agentCache.values()).filter(
406
- (agent) => agent.status === 'active' || agent.status === 'busy',
407
- ).length;
408
-
409
- // Get task statistics
410
- const tasks = Array.from(this.taskCache.values());
411
- const taskStats = {
412
- total: tasks.length,
413
- pending: tasks.filter((t) => t.status === 'pending').length,
414
- inProgress: tasks.filter((t) => t.status === 'in_progress').length,
415
- completed: tasks.filter((t) => t.status === 'completed').length,
416
- failed: tasks.filter((t) => t.status === 'failed').length,
417
- };
418
-
419
- return {
420
- ...baseStats,
421
- swarm: {
422
- swarmId: this.swarmId,
423
- agents: {
424
- total: agentCount,
425
- active: activeAgents,
426
- cached: this.agentCache.size,
427
- },
428
- tasks: taskStats,
429
- patterns: {
430
- total: patternCount,
431
- cached: this.patternCache.size,
432
- },
433
- namespaces: Object.values(SWARM_NAMESPACES),
434
- },
435
- };
436
- }
437
-
438
- /**
439
- * Clean up old swarm data
440
- */
441
- async cleanupSwarmData(options = {}) {
442
- const {
443
- maxAge = 86400 * 7, // 7 days
444
- keepPatterns = true,
445
- keepConsensus = true,
446
- } = options;
447
-
448
- const cutoffTime = Date.now() - maxAge * 1000;
449
- let cleaned = 0;
450
-
451
- // Clean old communications
452
- const comms = await this.list(SWARM_NAMESPACES.COMMUNICATIONS);
453
- for (const comm of comms) {
454
- if (new Date(comm.value.timestamp).getTime() < cutoffTime) {
455
- await this.delete(comm.key, SWARM_NAMESPACES.COMMUNICATIONS);
456
- cleaned++;
457
- }
458
- }
459
-
460
- // Clean completed tasks
461
- const tasks = await this.list(SWARM_NAMESPACES.TASKS);
462
- for (const task of tasks) {
463
- if (
464
- task.value.status === 'completed' &&
465
- new Date(task.value.completedAt).getTime() < cutoffTime
466
- ) {
467
- await this.delete(task.key, SWARM_NAMESPACES.TASKS);
468
- this.taskCache.delete(task.value.id);
469
- cleaned++;
470
- }
471
- }
472
-
473
- // Clean old metrics
474
- const metrics = await this.list(SWARM_NAMESPACES.METRICS);
475
- for (const metric of metrics) {
476
- if (new Date(metric.createdAt).getTime() < cutoffTime) {
477
- await this.delete(metric.key, SWARM_NAMESPACES.METRICS);
478
- cleaned++;
479
- }
480
- }
481
-
482
- this.emit('swarm:cleanup', { cleaned, maxAge });
483
-
484
- return { cleaned };
485
- }
486
-
487
- /**
488
- * Export swarm state
489
- */
490
- async exportSwarmState() {
491
- const agents = await this.listAgents();
492
- const tasks = Array.from(this.taskCache.values());
493
- const patterns = await this.list(SWARM_NAMESPACES.PATTERNS);
494
-
495
- return {
496
- swarmId: this.swarmId,
497
- exportedAt: new Date().toISOString(),
498
- agents: agents,
499
- tasks: tasks,
500
- patterns: patterns.map((p) => p.value),
501
- statistics: await this.getSwarmStats(),
502
- };
503
- }
504
-
505
- /**
506
- * Import swarm state
507
- */
508
- async importSwarmState(state) {
509
- let imported = {
510
- agents: 0,
511
- tasks: 0,
512
- patterns: 0,
513
- };
514
-
515
- // Import agents
516
- if (state.agents) {
517
- for (const agent of state.agents) {
518
- await this.storeAgent(agent.id, agent);
519
- imported.agents++;
520
- }
521
- }
522
-
523
- // Import tasks
524
- if (state.tasks) {
525
- for (const task of state.tasks) {
526
- await this.storeTask(task.id, task);
527
- imported.tasks++;
528
- }
529
- }
530
-
531
- // Import patterns
532
- if (state.patterns) {
533
- for (const pattern of state.patterns) {
534
- await this.storePattern(pattern.id, pattern);
535
- imported.patterns++;
536
- }
537
- }
538
-
539
- this.emit('swarm:imported', imported);
540
-
541
- return imported;
542
- }
543
-
544
- /**
545
- * Private helper methods
546
- */
547
-
548
- async _initializeSwarmNamespaces() {
549
- // Create swarm metadata
550
- await this.store(
551
- 'swarm:metadata',
552
- {
553
- swarmId: this.swarmId,
554
- createdAt: new Date().toISOString(),
555
- version: '1.0.0',
556
- namespaces: Object.values(SWARM_NAMESPACES),
557
- },
558
- {
559
- namespace: 'swarm:system',
560
- },
561
- );
562
- }
563
-
564
- async _loadSwarmState() {
565
- // Load active agents
566
- const agents = await this.list(SWARM_NAMESPACES.AGENTS, { limit: 100 });
567
- for (const entry of agents) {
568
- if (entry.value.status === 'active' || entry.value.status === 'busy') {
569
- this.agentCache.set(entry.value.id, entry.value);
570
- }
571
- }
572
-
573
- // Load in-progress tasks
574
- const tasks = await this.search({
575
- namespace: SWARM_NAMESPACES.TASKS,
576
- tags: ['in_progress'],
577
- limit: 100,
578
- });
579
- for (const entry of tasks) {
580
- this.taskCache.set(entry.value.id, entry.value);
581
- }
582
-
583
- // Load high-confidence patterns
584
- const patterns = await this.list(SWARM_NAMESPACES.PATTERNS, { limit: 50 });
585
- for (const entry of patterns) {
586
- if (entry.value.confidence > 0.7 || entry.value.successRate > 0.8) {
587
- this.patternCache.set(entry.value.id, entry.value);
588
- }
589
- }
590
- }
591
-
592
- async _countNamespace(namespace) {
593
- const stats = await this.getStats();
594
- return stats.namespaces[namespace]?.count || 0;
595
- }
596
- }
597
-
598
- // Export factory function for easy creation
599
- export function createSwarmMemory(options = {}) {
600
- return new SwarmMemory(options);
601
- }
602
-
603
- // Export for backwards compatibility
604
- export default SwarmMemory;
467
+ * Factory function to create SwarmMemoryManager instance
468
+ * Provides backward compatibility with existing code that uses createSwarmMemory()
469
+ */ export function createSwarmMemory(options = {}) {
470
+ return new SwarmMemoryManager(options);
471
+ }