@holoscript/framework 6.0.3

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 (329) hide show
  1. package/ALL-test-results.json +1 -0
  2. package/CHANGELOG.md +8 -0
  3. package/LICENSE +21 -0
  4. package/ROADMAP.md +175 -0
  5. package/dist/AgentManifest-CB4xM-Ma.d.cts +704 -0
  6. package/dist/AgentManifest-CB4xM-Ma.d.ts +704 -0
  7. package/dist/BehaviorTree-BrBFECv5.d.cts +103 -0
  8. package/dist/BehaviorTree-BrBFECv5.d.ts +103 -0
  9. package/dist/InvisibleWallet-BB6tFvRA.d.cts +1732 -0
  10. package/dist/InvisibleWallet-rtRrBOA8.d.ts +1732 -0
  11. package/dist/OrchestratorAgent-BvWgf9uw.d.cts +798 -0
  12. package/dist/OrchestratorAgent-Q_CbVTmO.d.ts +798 -0
  13. package/dist/agents/index.cjs +4790 -0
  14. package/dist/agents/index.d.cts +1788 -0
  15. package/dist/agents/index.d.ts +1788 -0
  16. package/dist/agents/index.js +4695 -0
  17. package/dist/ai/index.cjs +5347 -0
  18. package/dist/ai/index.d.cts +1753 -0
  19. package/dist/ai/index.d.ts +1753 -0
  20. package/dist/ai/index.js +5244 -0
  21. package/dist/behavior.cjs +449 -0
  22. package/dist/behavior.d.cts +130 -0
  23. package/dist/behavior.d.ts +130 -0
  24. package/dist/behavior.js +407 -0
  25. package/dist/economy/index.cjs +3659 -0
  26. package/dist/economy/index.d.cts +747 -0
  27. package/dist/economy/index.d.ts +747 -0
  28. package/dist/economy/index.js +3617 -0
  29. package/dist/implementations-D9T3un9D.d.cts +236 -0
  30. package/dist/implementations-D9T3un9D.d.ts +236 -0
  31. package/dist/index.cjs +24550 -0
  32. package/dist/index.d.cts +1729 -0
  33. package/dist/index.d.ts +1729 -0
  34. package/dist/index.js +24277 -0
  35. package/dist/learning/index.cjs +219 -0
  36. package/dist/learning/index.d.cts +104 -0
  37. package/dist/learning/index.d.ts +104 -0
  38. package/dist/learning/index.js +189 -0
  39. package/dist/negotiation/index.cjs +970 -0
  40. package/dist/negotiation/index.d.cts +610 -0
  41. package/dist/negotiation/index.d.ts +610 -0
  42. package/dist/negotiation/index.js +931 -0
  43. package/dist/skills/index.cjs +1118 -0
  44. package/dist/skills/index.d.cts +289 -0
  45. package/dist/skills/index.d.ts +289 -0
  46. package/dist/skills/index.js +1079 -0
  47. package/dist/swarm/index.cjs +5268 -0
  48. package/dist/swarm/index.d.cts +2433 -0
  49. package/dist/swarm/index.d.ts +2433 -0
  50. package/dist/swarm/index.js +5221 -0
  51. package/dist/training/index.cjs +2745 -0
  52. package/dist/training/index.d.cts +1734 -0
  53. package/dist/training/index.d.ts +1734 -0
  54. package/dist/training/index.js +2687 -0
  55. package/extract-failures.js +10 -0
  56. package/package.json +82 -0
  57. package/src/__tests__/bounty-marketplace.test.ts +374 -0
  58. package/src/__tests__/delegation.test.ts +144 -0
  59. package/src/__tests__/distributed-claimer.test.ts +147 -0
  60. package/src/__tests__/done-log-audit.test.ts +342 -0
  61. package/src/__tests__/framework.test.ts +865 -0
  62. package/src/__tests__/goal-synthesizer.test.ts +236 -0
  63. package/src/__tests__/presence.test.ts +223 -0
  64. package/src/__tests__/protocol-agent.test.ts +254 -0
  65. package/src/__tests__/revenue-splitter.test.ts +114 -0
  66. package/src/__tests__/scenario-driven-todo.test.ts +197 -0
  67. package/src/__tests__/self-improve.test.ts +349 -0
  68. package/src/__tests__/service-lifecycle.test.ts +237 -0
  69. package/src/__tests__/skill-router.test.ts +121 -0
  70. package/src/agents/AgentManifest.ts +493 -0
  71. package/src/agents/AgentRegistry.ts +475 -0
  72. package/src/agents/AgentTypes.ts +585 -0
  73. package/src/agents/AgentWalletRegistry.ts +83 -0
  74. package/src/agents/AuthenticatedCRDT.ts +388 -0
  75. package/src/agents/CapabilityMatcher.ts +453 -0
  76. package/src/agents/CrossRealityHandoff.ts +305 -0
  77. package/src/agents/CulturalMemory.ts +454 -0
  78. package/src/agents/FederatedRegistryAdapter.ts +429 -0
  79. package/src/agents/NormEngine.ts +450 -0
  80. package/src/agents/OrchestratorAgent.ts +414 -0
  81. package/src/agents/SkillWorkflowEngine.ts +472 -0
  82. package/src/agents/TaskDelegationService.ts +551 -0
  83. package/src/agents/__tests__/AgentManifest.prod.test.ts +134 -0
  84. package/src/agents/__tests__/AgentManifest.test.ts +182 -0
  85. package/src/agents/__tests__/AgentModule.test.ts +864 -0
  86. package/src/agents/__tests__/AgentRegistry.prod.test.ts +125 -0
  87. package/src/agents/__tests__/AgentRegistry.test.ts +148 -0
  88. package/src/agents/__tests__/AgentTypes.test.ts +534 -0
  89. package/src/agents/__tests__/AgentWalletRegistry.test.ts +152 -0
  90. package/src/agents/__tests__/AuthenticatedCRDT.test.ts +558 -0
  91. package/src/agents/__tests__/CapabilityMatcher.prod.test.ts +117 -0
  92. package/src/agents/__tests__/CapabilityMatcher.test.ts +178 -0
  93. package/src/agents/__tests__/CrossRealityHandoff.test.ts +402 -0
  94. package/src/agents/__tests__/CulturalMemory.test.ts +200 -0
  95. package/src/agents/__tests__/FederatedRegistryAdapter.test.ts +409 -0
  96. package/src/agents/__tests__/NormEngine.test.ts +276 -0
  97. package/src/agents/__tests__/OrchestratorAgent.test.ts +182 -0
  98. package/src/agents/__tests__/SkillWorkflowEngine.test.ts +357 -0
  99. package/src/agents/__tests__/TaskDelegationService.test.ts +446 -0
  100. package/src/agents/index.ts +107 -0
  101. package/src/agents/spatial-comms/Layer1RealTime.ts +621 -0
  102. package/src/agents/spatial-comms/Layer2A2A.ts +661 -0
  103. package/src/agents/spatial-comms/Layer3MCP.ts +651 -0
  104. package/src/agents/spatial-comms/ProtocolTypes.ts +543 -0
  105. package/src/agents/spatial-comms/SpatialCommClient.ts +483 -0
  106. package/src/agents/spatial-comms/__tests__/performance-benchmark.test.ts +465 -0
  107. package/src/agents/spatial-comms/examples/multi-agent-world-creation.ts +409 -0
  108. package/src/agents/spatial-comms/index.ts +66 -0
  109. package/src/ai/AIAdapter.ts +313 -0
  110. package/src/ai/AICopilot.ts +331 -0
  111. package/src/ai/AIOutputValidator.ts +203 -0
  112. package/src/ai/BTNodes.ts +239 -0
  113. package/src/ai/BehaviorSelector.ts +135 -0
  114. package/src/ai/BehaviorTree.ts +153 -0
  115. package/src/ai/Blackboard.ts +165 -0
  116. package/src/ai/GenerationAnalytics.ts +461 -0
  117. package/src/ai/GenerationCache.ts +265 -0
  118. package/src/ai/GoalPlanner.ts +165 -0
  119. package/src/ai/HoloScriptGenerator.ts +580 -0
  120. package/src/ai/InfluenceMap.ts +180 -0
  121. package/src/ai/NavMesh.ts +168 -0
  122. package/src/ai/PerceptionSystem.ts +178 -0
  123. package/src/ai/PromptTemplates.ts +453 -0
  124. package/src/ai/SemanticSearchService.ts +80 -0
  125. package/src/ai/StateMachine.ts +196 -0
  126. package/src/ai/SteeringBehavior.ts +150 -0
  127. package/src/ai/SteeringBehaviors.ts +244 -0
  128. package/src/ai/TrainingDataGenerator.ts +1082 -0
  129. package/src/ai/UtilityAI.ts +145 -0
  130. package/src/ai/__tests__/AIAdapter.prod.test.ts +259 -0
  131. package/src/ai/__tests__/AIAdapter.test.ts +109 -0
  132. package/src/ai/__tests__/AICopilot.prod.test.ts +341 -0
  133. package/src/ai/__tests__/AICopilot.test.ts +178 -0
  134. package/src/ai/__tests__/AIOutputValidator.prod.test.ts +226 -0
  135. package/src/ai/__tests__/AIOutputValidator.test.ts +138 -0
  136. package/src/ai/__tests__/BTNodes.prod.test.ts +391 -0
  137. package/src/ai/__tests__/BTNodes.test.ts +263 -0
  138. package/src/ai/__tests__/BehaviorSelector.prod.test.ts +129 -0
  139. package/src/ai/__tests__/BehaviorSelector.test.ts +132 -0
  140. package/src/ai/__tests__/BehaviorTree.prod.test.ts +266 -0
  141. package/src/ai/__tests__/BehaviorTree.test.ts +216 -0
  142. package/src/ai/__tests__/Blackboard.prod.test.ts +339 -0
  143. package/src/ai/__tests__/Blackboard.test.ts +183 -0
  144. package/src/ai/__tests__/GenerationAnalytics.prod.test.ts +141 -0
  145. package/src/ai/__tests__/GenerationAnalytics.test.ts +165 -0
  146. package/src/ai/__tests__/GenerationCache.prod.test.ts +144 -0
  147. package/src/ai/__tests__/GenerationCache.test.ts +171 -0
  148. package/src/ai/__tests__/GoalPlanner.prod.test.ts +189 -0
  149. package/src/ai/__tests__/GoalPlanner.test.ts +137 -0
  150. package/src/ai/__tests__/GoalPlannerDepth.prod.test.ts +217 -0
  151. package/src/ai/__tests__/HoloScriptGenerator.test.ts +125 -0
  152. package/src/ai/__tests__/InfluenceMap.prod.test.ts +146 -0
  153. package/src/ai/__tests__/InfluenceMap.test.ts +149 -0
  154. package/src/ai/__tests__/NavMesh.prod.test.ts +141 -0
  155. package/src/ai/__tests__/NavMesh.test.ts +159 -0
  156. package/src/ai/__tests__/PerceptionSystem.prod.test.ts +135 -0
  157. package/src/ai/__tests__/PerceptionSystem.test.ts +250 -0
  158. package/src/ai/__tests__/PromptTemplates.prod.test.ts +313 -0
  159. package/src/ai/__tests__/PromptTemplates.test.ts +146 -0
  160. package/src/ai/__tests__/SemanticSearch.test.ts +37 -0
  161. package/src/ai/__tests__/StateMachine.prod.test.ts +162 -0
  162. package/src/ai/__tests__/StateMachine.test.ts +163 -0
  163. package/src/ai/__tests__/SteeringBehavior.prod.test.ts +251 -0
  164. package/src/ai/__tests__/SteeringBehavior.test.ts +135 -0
  165. package/src/ai/__tests__/SteeringBehaviors.prod.test.ts +133 -0
  166. package/src/ai/__tests__/SteeringBehaviors.test.ts +151 -0
  167. package/src/ai/__tests__/TrainingDataGenerator.prod.test.ts +286 -0
  168. package/src/ai/__tests__/TrainingDataGenerator.test.ts +286 -0
  169. package/src/ai/__tests__/UtilityAI.prod.test.ts +207 -0
  170. package/src/ai/__tests__/UtilityAI.test.ts +155 -0
  171. package/src/ai/__tests__/adapters.prod.test.ts +263 -0
  172. package/src/ai/__tests__/adapters.test.ts +320 -0
  173. package/src/ai/adapters.ts +1585 -0
  174. package/src/ai/index.ts +130 -0
  175. package/src/behavior/BehaviorPresets.ts +140 -0
  176. package/src/behavior/BehaviorTree.ts +236 -0
  177. package/src/behavior/StateMachine.ts +176 -0
  178. package/src/behavior/StateTrait.ts +67 -0
  179. package/src/behavior/index.ts +8 -0
  180. package/src/behavior.ts +8 -0
  181. package/src/board/audit.ts +284 -0
  182. package/src/board/board-ops.ts +336 -0
  183. package/src/board/board-types.ts +302 -0
  184. package/src/board/index.ts +69 -0
  185. package/src/define-agent.ts +46 -0
  186. package/src/define-team.ts +33 -0
  187. package/src/delegation.ts +265 -0
  188. package/src/distributed-claimer.ts +228 -0
  189. package/src/economy/AgentBudgetEnforcer.ts +464 -0
  190. package/src/economy/BountyManager.ts +185 -0
  191. package/src/economy/CreatorRevenueAggregator.ts +460 -0
  192. package/src/economy/InvisibleWallet.ts +82 -0
  193. package/src/economy/KnowledgeMarketplace.ts +193 -0
  194. package/src/economy/PaymentWebhookService.ts +512 -0
  195. package/src/economy/RevenueSplitter.ts +156 -0
  196. package/src/economy/SubscriptionManager.ts +546 -0
  197. package/src/economy/UnifiedBudgetOptimizer.ts +635 -0
  198. package/src/economy/UsageMeter.ts +440 -0
  199. package/src/economy/_core-stubs.ts +219 -0
  200. package/src/economy/index.ts +100 -0
  201. package/src/economy/x402-facilitator.ts +1978 -0
  202. package/src/index.ts +348 -0
  203. package/src/knowledge/__tests__/knowledge-consolidator.test.ts +444 -0
  204. package/src/knowledge/__tests__/knowledge-store-vector.test.ts +291 -0
  205. package/src/knowledge/brain.ts +167 -0
  206. package/src/knowledge/consolidation.ts +581 -0
  207. package/src/knowledge/knowledge-consolidator.ts +510 -0
  208. package/src/knowledge/knowledge-store.ts +616 -0
  209. package/src/learning/MemoryConsolidator.ts +102 -0
  210. package/src/learning/MemoryScorer.ts +69 -0
  211. package/src/learning/ProceduralCompiler.ts +45 -0
  212. package/src/learning/SemanticClusterer.ts +66 -0
  213. package/src/learning/index.ts +8 -0
  214. package/src/llm/llm-adapter.ts +159 -0
  215. package/src/mesh/index.ts +309 -0
  216. package/src/negotiation/NegotiationProtocol.ts +694 -0
  217. package/src/negotiation/NegotiationTypes.ts +473 -0
  218. package/src/negotiation/VotingMechanisms.ts +691 -0
  219. package/src/negotiation/index.ts +49 -0
  220. package/src/protocol/goal-synthesizer.ts +317 -0
  221. package/src/protocol/implementations.ts +474 -0
  222. package/src/protocol/micro-phase-decomposer.ts +299 -0
  223. package/src/protocol/micro-step-decomposer.test.ts +306 -0
  224. package/src/protocol-agent.test.ts +353 -0
  225. package/src/protocol-agent.ts +670 -0
  226. package/src/self-improve/absorb-scanner.ts +252 -0
  227. package/src/self-improve/evolution-engine.ts +149 -0
  228. package/src/self-improve/framework-absorber.ts +214 -0
  229. package/src/self-improve/index.ts +50 -0
  230. package/src/self-improve/prompt-optimizer.ts +212 -0
  231. package/src/self-improve/test-generator.ts +175 -0
  232. package/src/skill-router.ts +186 -0
  233. package/src/skills/index.ts +5 -0
  234. package/src/skills/skill-md-bridge.ts +1699 -0
  235. package/src/swarm/ACOEngine.ts +261 -0
  236. package/src/swarm/CollectiveIntelligence.ts +383 -0
  237. package/src/swarm/ContributionSynthesizer.ts +481 -0
  238. package/src/swarm/LeaderElection.ts +393 -0
  239. package/src/swarm/PSOEngine.ts +206 -0
  240. package/src/swarm/QuorumPolicy.ts +173 -0
  241. package/src/swarm/SwarmCoordinator.ts +335 -0
  242. package/src/swarm/SwarmManager.ts +442 -0
  243. package/src/swarm/SwarmMembership.ts +456 -0
  244. package/src/swarm/VotingRound.ts +255 -0
  245. package/src/swarm/__tests__/ACOEngine.prod.test.ts +164 -0
  246. package/src/swarm/__tests__/ACOEngine.test.ts +117 -0
  247. package/src/swarm/__tests__/CollectiveIntelligence.prod.test.ts +296 -0
  248. package/src/swarm/__tests__/CollectiveIntelligence.test.ts +457 -0
  249. package/src/swarm/__tests__/ContributionSynthesizer.prod.test.ts +269 -0
  250. package/src/swarm/__tests__/ContributionSynthesizer.test.ts +254 -0
  251. package/src/swarm/__tests__/LeaderElection.prod.test.ts +196 -0
  252. package/src/swarm/__tests__/LeaderElection.test.ts +151 -0
  253. package/src/swarm/__tests__/PSOEngine.prod.test.ts +162 -0
  254. package/src/swarm/__tests__/PSOEngine.test.ts +106 -0
  255. package/src/swarm/__tests__/QuorumPolicy.prod.test.ts +216 -0
  256. package/src/swarm/__tests__/QuorumPolicy.test.ts +177 -0
  257. package/src/swarm/__tests__/SwarmCoordinator.prod.test.ts +186 -0
  258. package/src/swarm/__tests__/SwarmCoordinator.test.ts +167 -0
  259. package/src/swarm/__tests__/SwarmManager.prod.test.ts +308 -0
  260. package/src/swarm/__tests__/SwarmManager.test.ts +373 -0
  261. package/src/swarm/__tests__/SwarmMembership.prod.test.ts +273 -0
  262. package/src/swarm/__tests__/SwarmMembership.test.ts +264 -0
  263. package/src/swarm/__tests__/VotingRound.prod.test.ts +233 -0
  264. package/src/swarm/__tests__/VotingRound.test.ts +174 -0
  265. package/src/swarm/analytics/SwarmInspector.ts +476 -0
  266. package/src/swarm/analytics/SwarmMetrics.ts +449 -0
  267. package/src/swarm/analytics/__tests__/SwarmInspector.prod.test.ts +366 -0
  268. package/src/swarm/analytics/__tests__/SwarmInspector.test.ts +454 -0
  269. package/src/swarm/analytics/__tests__/SwarmMetrics.prod.test.ts +254 -0
  270. package/src/swarm/analytics/__tests__/SwarmMetrics.test.ts +370 -0
  271. package/src/swarm/analytics/index.ts +7 -0
  272. package/src/swarm/index.ts +69 -0
  273. package/src/swarm/messaging/BroadcastChannel.ts +509 -0
  274. package/src/swarm/messaging/GossipProtocol.ts +565 -0
  275. package/src/swarm/messaging/SwarmEventBus.ts +443 -0
  276. package/src/swarm/messaging/__tests__/BroadcastChannel.prod.test.ts +331 -0
  277. package/src/swarm/messaging/__tests__/BroadcastChannel.test.ts +333 -0
  278. package/src/swarm/messaging/__tests__/GossipProtocol.prod.test.ts +356 -0
  279. package/src/swarm/messaging/__tests__/GossipProtocol.test.ts +437 -0
  280. package/src/swarm/messaging/__tests__/SwarmEventBus.prod.test.ts +191 -0
  281. package/src/swarm/messaging/__tests__/SwarmEventBus.test.ts +247 -0
  282. package/src/swarm/messaging/index.ts +8 -0
  283. package/src/swarm/spatial/FlockingBehavior.ts +462 -0
  284. package/src/swarm/spatial/FormationController.ts +500 -0
  285. package/src/swarm/spatial/Vector3.ts +170 -0
  286. package/src/swarm/spatial/ZoneClaiming.ts +509 -0
  287. package/src/swarm/spatial/__tests__/FlockingBehavior.prod.test.ts +239 -0
  288. package/src/swarm/spatial/__tests__/FlockingBehavior.test.ts +298 -0
  289. package/src/swarm/spatial/__tests__/FormationController.prod.test.ts +240 -0
  290. package/src/swarm/spatial/__tests__/FormationController.test.ts +297 -0
  291. package/src/swarm/spatial/__tests__/Vector3.prod.test.ts +283 -0
  292. package/src/swarm/spatial/__tests__/Vector3.test.ts +224 -0
  293. package/src/swarm/spatial/__tests__/ZoneClaiming.prod.test.ts +246 -0
  294. package/src/swarm/spatial/__tests__/ZoneClaiming.test.ts +374 -0
  295. package/src/swarm/spatial/index.ts +28 -0
  296. package/src/team.ts +1245 -0
  297. package/src/training/LRScheduler.ts +377 -0
  298. package/src/training/QualityScoringPipeline.ts +139 -0
  299. package/src/training/SoftDedup.ts +461 -0
  300. package/src/training/SparsityMonitor.ts +685 -0
  301. package/src/training/SparsityMonitorTypes.ts +209 -0
  302. package/src/training/SpatialTrainingDataGenerator.ts +1526 -0
  303. package/src/training/SpatialTrainingDataTypes.ts +216 -0
  304. package/src/training/TrainingPipelineConfig.ts +215 -0
  305. package/src/training/constants.ts +94 -0
  306. package/src/training/index.ts +138 -0
  307. package/src/training/schema.ts +147 -0
  308. package/src/training/scripts/generate-novel-use-cases-dataset.ts +272 -0
  309. package/src/training/scripts/generate-spatial-dataset.ts +521 -0
  310. package/src/training/training/data/novel-use-cases.jsonl +153 -0
  311. package/src/training/training/data/spatial-reasoning-10k.jsonl +9354 -0
  312. package/src/training/trainingmonkey/TrainingMonkeyIntegration.ts +477 -0
  313. package/src/training/trainingmonkey/TrainingMonkeyTypes.ts +230 -0
  314. package/src/training/trainingmonkey/index.ts +26 -0
  315. package/src/training/trait-mappings.ts +157 -0
  316. package/src/types/core-stubs.d.ts +113 -0
  317. package/src/types.ts +304 -0
  318. package/test-output.txt +0 -0
  319. package/test-result.json +1 -0
  320. package/tsc-errors.txt +4 -0
  321. package/tsc_output.txt +0 -0
  322. package/tsconfig.json +14 -0
  323. package/tsup-learning-esm.config.ts +12 -0
  324. package/tsup.config.ts +21 -0
  325. package/typescript-errors-2.txt +0 -0
  326. package/typescript-errors.txt +22 -0
  327. package/vitest-log-utf8.txt +268 -0
  328. package/vitest-log.txt +0 -0
  329. package/vitest.config.ts +8 -0
@@ -0,0 +1,454 @@
1
+ /**
2
+ * SwarmInspector Tests
3
+ * HoloScript v3.2 - Autonomous Agent Swarms
4
+ */
5
+
6
+ import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
7
+ import { SwarmInspector, IAgentSnapshot, ISwarmSnapshot } from '../SwarmInspector';
8
+
9
+ describe('SwarmInspector', () => {
10
+ let inspector: SwarmInspector;
11
+
12
+ beforeEach(() => {
13
+ vi.useFakeTimers();
14
+ vi.setSystemTime(new Date('2025-01-01T00:00:00Z'));
15
+ inspector = new SwarmInspector();
16
+ });
17
+
18
+ afterEach(() => {
19
+ vi.useRealTimers();
20
+ });
21
+
22
+ describe('agent tracking', () => {
23
+ const createAgent = (id: string, overrides?: Partial<IAgentSnapshot>): IAgentSnapshot => ({
24
+ id,
25
+ state: 'active',
26
+ health: 1.0,
27
+ load: 0.5,
28
+ lastActive: Date.now(),
29
+ properties: {},
30
+ ...overrides,
31
+ });
32
+
33
+ it('should update agent snapshot', () => {
34
+ const agent = createAgent('agent-1');
35
+ inspector.updateAgent(agent);
36
+
37
+ expect(inspector.getAgent('agent-1')).toEqual(agent);
38
+ });
39
+
40
+ it('should remove agent snapshot', () => {
41
+ inspector.updateAgent(createAgent('agent-1'));
42
+ inspector.removeAgent('agent-1');
43
+
44
+ expect(inspector.getAgent('agent-1')).toBeUndefined();
45
+ });
46
+
47
+ it('should get all agents', () => {
48
+ inspector.updateAgent(createAgent('a1'));
49
+ inspector.updateAgent(createAgent('a2'));
50
+ inspector.updateAgent(createAgent('a3'));
51
+
52
+ expect(inspector.getAllAgents()).toHaveLength(3);
53
+ });
54
+
55
+ it('should get agents by swarm', () => {
56
+ inspector.updateAgent(createAgent('a1', { swarmId: 'swarm-1' }));
57
+ inspector.updateAgent(createAgent('a2', { swarmId: 'swarm-1' }));
58
+ inspector.updateAgent(createAgent('a3', { swarmId: 'swarm-2' }));
59
+
60
+ expect(inspector.getSwarmAgents('swarm-1')).toHaveLength(2);
61
+ expect(inspector.getSwarmAgents('swarm-2')).toHaveLength(1);
62
+ });
63
+
64
+ it('should remove relations when agent removed', () => {
65
+ inspector.updateAgent(createAgent('a1'));
66
+ inspector.updateAgent(createAgent('a2'));
67
+ inspector.addRelation({
68
+ sourceId: 'a1',
69
+ targetId: 'a2',
70
+ type: 'neighbor',
71
+ strength: 0.8,
72
+ });
73
+
74
+ inspector.removeAgent('a1');
75
+
76
+ expect(inspector.getAgentRelations('a2')).toHaveLength(0);
77
+ });
78
+ });
79
+
80
+ describe('swarm tracking', () => {
81
+ const createSwarm = (id: string, overrides?: Partial<ISwarmSnapshot>): ISwarmSnapshot => ({
82
+ id,
83
+ memberCount: 5,
84
+ state: 'active',
85
+ createdAt: Date.now(),
86
+ properties: {},
87
+ ...overrides,
88
+ });
89
+
90
+ it('should update swarm snapshot', () => {
91
+ const swarm = createSwarm('swarm-1');
92
+ inspector.updateSwarm(swarm);
93
+
94
+ expect(inspector.getSwarm('swarm-1')).toEqual(swarm);
95
+ });
96
+
97
+ it('should remove swarm snapshot', () => {
98
+ inspector.updateSwarm(createSwarm('swarm-1'));
99
+ inspector.removeSwarm('swarm-1');
100
+
101
+ expect(inspector.getSwarm('swarm-1')).toBeUndefined();
102
+ });
103
+
104
+ it('should get all swarms', () => {
105
+ inspector.updateSwarm(createSwarm('s1'));
106
+ inspector.updateSwarm(createSwarm('s2'));
107
+
108
+ expect(inspector.getAllSwarms()).toHaveLength(2);
109
+ });
110
+ });
111
+
112
+ describe('relations', () => {
113
+ it('should add relation between agents', () => {
114
+ inspector.addRelation({
115
+ sourceId: 'a1',
116
+ targetId: 'a2',
117
+ type: 'neighbor',
118
+ strength: 0.7,
119
+ });
120
+
121
+ const relations = inspector.getAllRelations();
122
+ expect(relations).toHaveLength(1);
123
+ expect(relations[0].strength).toBe(0.7);
124
+ });
125
+
126
+ it('should update existing relation', () => {
127
+ inspector.addRelation({ sourceId: 'a1', targetId: 'a2', type: 'neighbor', strength: 0.5 });
128
+ inspector.addRelation({ sourceId: 'a1', targetId: 'a2', type: 'neighbor', strength: 0.9 });
129
+
130
+ const relations = inspector.getAllRelations();
131
+ expect(relations).toHaveLength(1);
132
+ expect(relations[0].strength).toBe(0.9);
133
+ });
134
+
135
+ it('should allow different relation types', () => {
136
+ inspector.addRelation({ sourceId: 'a1', targetId: 'a2', type: 'neighbor', strength: 0.5 });
137
+ inspector.addRelation({
138
+ sourceId: 'a1',
139
+ targetId: 'a2',
140
+ type: 'communication',
141
+ strength: 0.8,
142
+ });
143
+
144
+ expect(inspector.getAllRelations()).toHaveLength(2);
145
+ });
146
+
147
+ it('should remove relation', () => {
148
+ inspector.addRelation({ sourceId: 'a1', targetId: 'a2', type: 'neighbor', strength: 0.5 });
149
+ inspector.removeRelation('a1', 'a2', 'neighbor');
150
+
151
+ expect(inspector.getAllRelations()).toHaveLength(0);
152
+ });
153
+
154
+ it('should get relations for agent', () => {
155
+ inspector.addRelation({ sourceId: 'a1', targetId: 'a2', type: 'neighbor', strength: 0.5 });
156
+ inspector.addRelation({ sourceId: 'a3', targetId: 'a1', type: 'neighbor', strength: 0.6 });
157
+ inspector.addRelation({ sourceId: 'a2', targetId: 'a3', type: 'neighbor', strength: 0.7 });
158
+
159
+ const a1Relations = inspector.getAgentRelations('a1');
160
+ expect(a1Relations).toHaveLength(2);
161
+ });
162
+ });
163
+
164
+ describe('health checks', () => {
165
+ it('should register health check', () => {
166
+ inspector.registerHealthCheck({
167
+ name: 'database',
168
+ status: 'healthy',
169
+ latency: 5,
170
+ lastCheck: Date.now(),
171
+ });
172
+
173
+ expect(inspector.getHealthCheck('database')?.status).toBe('healthy');
174
+ });
175
+
176
+ it('should get all health checks', () => {
177
+ inspector.registerHealthCheck({ name: 'db', status: 'healthy', lastCheck: Date.now() });
178
+ inspector.registerHealthCheck({ name: 'cache', status: 'degraded', lastCheck: Date.now() });
179
+
180
+ expect(inspector.getAllHealthChecks()).toHaveLength(2);
181
+ });
182
+
183
+ it('should return healthy when all checks pass', () => {
184
+ inspector.registerHealthCheck({ name: 'db', status: 'healthy', lastCheck: Date.now() });
185
+ inspector.registerHealthCheck({ name: 'cache', status: 'healthy', lastCheck: Date.now() });
186
+
187
+ expect(inspector.getOverallHealth()).toBe('healthy');
188
+ });
189
+
190
+ it('should return degraded when any check degraded', () => {
191
+ inspector.registerHealthCheck({ name: 'db', status: 'healthy', lastCheck: Date.now() });
192
+ inspector.registerHealthCheck({ name: 'cache', status: 'degraded', lastCheck: Date.now() });
193
+
194
+ expect(inspector.getOverallHealth()).toBe('degraded');
195
+ });
196
+
197
+ it('should return unhealthy when any check unhealthy', () => {
198
+ inspector.registerHealthCheck({ name: 'db', status: 'unhealthy', lastCheck: Date.now() });
199
+ inspector.registerHealthCheck({ name: 'cache', status: 'healthy', lastCheck: Date.now() });
200
+
201
+ expect(inspector.getOverallHealth()).toBe('unhealthy');
202
+ });
203
+ });
204
+
205
+ describe('debug events', () => {
206
+ it('should log events with different levels', () => {
207
+ inspector.trace('source1', 'trace message');
208
+ inspector.debug('source1', 'debug message');
209
+ inspector.info('source1', 'info message');
210
+ inspector.warn('source1', 'warn message');
211
+ inspector.error('source1', 'error message');
212
+
213
+ const log = inspector.getEventLog();
214
+ expect(log).toHaveLength(5);
215
+ expect(log.map((e) => e.level)).toEqual(['trace', 'debug', 'info', 'warn', 'error']);
216
+ });
217
+
218
+ it('should filter events by level', () => {
219
+ inspector.info('src', 'info');
220
+ inspector.error('src', 'error');
221
+
222
+ expect(inspector.getEventLog({ level: 'error' })).toHaveLength(1);
223
+ });
224
+
225
+ it('should filter events by source', () => {
226
+ inspector.info('source-a', 'msg1');
227
+ inspector.info('source-b', 'msg2');
228
+
229
+ expect(inspector.getEventLog({ source: 'source-a' })).toHaveLength(1);
230
+ });
231
+
232
+ it('should filter events by timestamp', () => {
233
+ inspector.info('src', 'old');
234
+ vi.advanceTimersByTime(5000);
235
+ const cutoff = Date.now();
236
+ vi.advanceTimersByTime(5000);
237
+ inspector.info('src', 'new');
238
+
239
+ expect(inspector.getEventLog({ since: cutoff })).toHaveLength(1);
240
+ });
241
+
242
+ it('should limit events returned', () => {
243
+ for (let i = 0; i < 10; i++) {
244
+ inspector.info('src', `msg ${i}`);
245
+ }
246
+
247
+ expect(inspector.getEventLog({ limit: 3 })).toHaveLength(3);
248
+ });
249
+
250
+ it('should support event listeners', () => {
251
+ const events: string[] = [];
252
+ const unsubscribe = inspector.addEventListener((e) => events.push(e.message));
253
+
254
+ inspector.info('src', 'message1');
255
+ inspector.info('src', 'message2');
256
+
257
+ expect(events).toEqual(['message1', 'message2']);
258
+
259
+ unsubscribe();
260
+ inspector.info('src', 'message3');
261
+
262
+ expect(events).toHaveLength(2);
263
+ });
264
+
265
+ it('should respect maxEvents limit', () => {
266
+ const limitedInspector = new SwarmInspector({ maxEvents: 5 });
267
+
268
+ for (let i = 0; i < 10; i++) {
269
+ limitedInspector.info('src', `msg ${i}`);
270
+ }
271
+
272
+ const log = limitedInspector.getEventLog();
273
+ expect(log).toHaveLength(5);
274
+ expect(log[0].message).toBe('msg 5');
275
+ });
276
+
277
+ it('should clear event log', () => {
278
+ inspector.info('src', 'message');
279
+ inspector.clearEventLog();
280
+
281
+ expect(inspector.getEventLog()).toHaveLength(0);
282
+ });
283
+ });
284
+
285
+ describe('inspect', () => {
286
+ it('should return full inspection result', () => {
287
+ inspector.updateSwarm({
288
+ id: 'swarm-1',
289
+ memberCount: 3,
290
+ state: 'active',
291
+ createdAt: Date.now(),
292
+ properties: {},
293
+ });
294
+
295
+ inspector.updateAgent({
296
+ id: 'a1',
297
+ swarmId: 'swarm-1',
298
+ state: 'active',
299
+ health: 1.0,
300
+ load: 0.3,
301
+ lastActive: Date.now(),
302
+ properties: {},
303
+ });
304
+
305
+ inspector.registerHealthCheck({
306
+ name: 'test',
307
+ status: 'healthy',
308
+ lastCheck: Date.now(),
309
+ });
310
+
311
+ const result = inspector.inspect();
312
+ expect(result.swarms).toHaveLength(1);
313
+ expect(result.agents).toHaveLength(1);
314
+ expect(result.health).toHaveLength(1);
315
+ expect(result.summary.totalSwarms).toBe(1);
316
+ expect(result.summary.totalAgents).toBe(1);
317
+ });
318
+
319
+ it('should detect low health agents', () => {
320
+ inspector.updateAgent({
321
+ id: 'a1',
322
+ state: 'active',
323
+ health: 0.2,
324
+ load: 0.5,
325
+ lastActive: Date.now(),
326
+ properties: {},
327
+ });
328
+
329
+ const result = inspector.inspect();
330
+ expect(result.summary.healthyAgents).toBe(0);
331
+ expect(result.summary.warnings).toContain('1 agents have low health');
332
+ });
333
+
334
+ it('should detect overloaded agents', () => {
335
+ inspector.updateAgent({
336
+ id: 'a1',
337
+ state: 'active',
338
+ health: 1.0,
339
+ load: 0.95,
340
+ lastActive: Date.now(),
341
+ properties: {},
342
+ });
343
+
344
+ const result = inspector.inspect();
345
+ expect(result.summary.warnings).toContain('1 agents are overloaded');
346
+ });
347
+
348
+ it('should detect stale agents', () => {
349
+ inspector.updateAgent({
350
+ id: 'a1',
351
+ state: 'active',
352
+ health: 1.0,
353
+ load: 0.5,
354
+ lastActive: Date.now() - 120000, // 2 min ago
355
+ properties: {},
356
+ });
357
+
358
+ const result = inspector.inspect();
359
+ expect(result.summary.warnings).toContain('1 agents are stale');
360
+ });
361
+
362
+ it('should calculate average load', () => {
363
+ inspector.updateAgent({
364
+ id: 'a1',
365
+ state: 'active',
366
+ health: 1.0,
367
+ load: 0.4,
368
+ lastActive: Date.now(),
369
+ properties: {},
370
+ });
371
+ inspector.updateAgent({
372
+ id: 'a2',
373
+ state: 'active',
374
+ health: 1.0,
375
+ load: 0.6,
376
+ lastActive: Date.now(),
377
+ properties: {},
378
+ });
379
+
380
+ const result = inspector.inspect();
381
+ expect(result.summary.averageLoad).toBe(0.5);
382
+ });
383
+ });
384
+
385
+ describe('toGraph', () => {
386
+ it('should generate graph with nodes and edges', () => {
387
+ inspector.updateSwarm({
388
+ id: 'swarm-1',
389
+ memberCount: 2,
390
+ state: 'active',
391
+ createdAt: Date.now(),
392
+ properties: {},
393
+ });
394
+
395
+ inspector.updateAgent({
396
+ id: 'a1',
397
+ swarmId: 'swarm-1',
398
+ state: 'active',
399
+ health: 1.0,
400
+ load: 0.5,
401
+ lastActive: Date.now(),
402
+ properties: {},
403
+ });
404
+
405
+ inspector.addRelation({
406
+ sourceId: 'a1',
407
+ targetId: 'a2',
408
+ type: 'neighbor',
409
+ strength: 0.7,
410
+ });
411
+
412
+ const graph = inspector.toGraph();
413
+
414
+ expect(graph.nodes.find((n) => n.id === 'swarm-1')).toBeDefined();
415
+ expect(graph.nodes.find((n) => n.id === 'a1')).toBeDefined();
416
+
417
+ // Edge for swarm membership
418
+ expect(graph.edges.find((e) => e.source === 'a1' && e.target === 'swarm-1')).toBeDefined();
419
+ // Edge for relation
420
+ expect(graph.edges.find((e) => e.source === 'a1' && e.target === 'a2')).toBeDefined();
421
+ });
422
+ });
423
+
424
+ describe('reset', () => {
425
+ it('should clear all state', () => {
426
+ inspector.updateSwarm({
427
+ id: 's1',
428
+ memberCount: 1,
429
+ state: 'active',
430
+ createdAt: Date.now(),
431
+ properties: {},
432
+ });
433
+ inspector.updateAgent({
434
+ id: 'a1',
435
+ state: 'active',
436
+ health: 1.0,
437
+ load: 0.5,
438
+ lastActive: Date.now(),
439
+ properties: {},
440
+ });
441
+ inspector.addRelation({ sourceId: 'a1', targetId: 'a2', type: 'neighbor', strength: 0.5 });
442
+ inspector.registerHealthCheck({ name: 'test', status: 'healthy', lastCheck: Date.now() });
443
+ inspector.info('src', 'message');
444
+
445
+ inspector.reset();
446
+
447
+ expect(inspector.getAllSwarms()).toHaveLength(0);
448
+ expect(inspector.getAllAgents()).toHaveLength(0);
449
+ expect(inspector.getAllRelations()).toHaveLength(0);
450
+ expect(inspector.getAllHealthChecks()).toHaveLength(0);
451
+ expect(inspector.getEventLog()).toHaveLength(0);
452
+ });
453
+ });
454
+ });
@@ -0,0 +1,254 @@
1
+ /**
2
+ * SwarmMetrics — Production Tests
3
+ */
4
+ import { describe, it, expect } from 'vitest';
5
+ import { SwarmMetrics } from '../SwarmMetrics';
6
+
7
+ function make(cfg = {}) {
8
+ return new SwarmMetrics(cfg);
9
+ }
10
+
11
+ describe('SwarmMetrics — construction', () => {
12
+ it('constructs without args', () => expect(() => make()).not.toThrow());
13
+ it('custom retentionPeriod', () => expect(() => make({ retentionPeriod: 60000 })).not.toThrow());
14
+ });
15
+
16
+ describe('SwarmMetrics — counter', () => {
17
+ it('registers counter at 0', () => {
18
+ const m = make();
19
+ m.register({ name: 'c', type: 'counter', description: 'test' });
20
+ expect(m.getCounter('c')).toBe(0);
21
+ });
22
+ it('increment by 1', () => {
23
+ const m = make();
24
+ m.register({ name: 'c', type: 'counter', description: 'test' });
25
+ m.increment('c');
26
+ expect(m.getCounter('c')).toBe(1);
27
+ });
28
+ it('increment by value', () => {
29
+ const m = make();
30
+ m.register({ name: 'c', type: 'counter', description: 'test' });
31
+ m.increment('c', 5);
32
+ expect(m.getCounter('c')).toBe(5);
33
+ });
34
+ it('accumulates multiple increments', () => {
35
+ const m = make();
36
+ m.register({ name: 'c', type: 'counter', description: 'test' });
37
+ m.increment('c', 3);
38
+ m.increment('c', 4);
39
+ expect(m.getCounter('c')).toBe(7);
40
+ });
41
+ it('unregistered counter returns 0', () => {
42
+ expect(make().getCounter('ghost')).toBe(0);
43
+ });
44
+ it('reset counter to 0', () => {
45
+ const m = make();
46
+ m.register({ name: 'c', type: 'counter', description: 'test' });
47
+ m.increment('c', 10);
48
+ m.reset('c');
49
+ expect(m.getCounter('c')).toBe(0);
50
+ });
51
+ it('getStats counter: min=max=avg=value', () => {
52
+ const m = make();
53
+ m.register({ name: 'c', type: 'counter', description: 'test' });
54
+ m.increment('c', 7);
55
+ const s = m.getStats('c')!;
56
+ expect(s.currentValue).toBe(7);
57
+ expect(s.min).toBe(7);
58
+ expect(s.max).toBe(7);
59
+ });
60
+ });
61
+
62
+ describe('SwarmMetrics — gauge', () => {
63
+ it('setGauge stores value', () => {
64
+ const m = make();
65
+ m.register({ name: 'g', type: 'gauge', description: 'test' });
66
+ m.setGauge('g', 42);
67
+ expect(m.getGauge('g')).toBe(42);
68
+ });
69
+ it('getGauge returns latest value', () => {
70
+ const m = make();
71
+ m.register({ name: 'g', type: 'gauge', description: 'test' });
72
+ m.setGauge('g', 10);
73
+ m.setGauge('g', 20);
74
+ expect(m.getGauge('g')).toBe(20);
75
+ });
76
+ it('getGauge undefined for no values', () => {
77
+ const m = make();
78
+ m.register({ name: 'g', type: 'gauge', description: 'test' });
79
+ expect(m.getGauge('g')).toBeUndefined();
80
+ });
81
+ it('getGaugeHistory returns all values', () => {
82
+ const m = make();
83
+ m.register({ name: 'g', type: 'gauge', description: 'test' });
84
+ m.setGauge('g', 1);
85
+ m.setGauge('g', 2);
86
+ m.setGauge('g', 3);
87
+ expect(m.getGaugeHistory('g')).toHaveLength(3);
88
+ });
89
+ it('getStats gauge: min/max/avg correct', () => {
90
+ const m = make();
91
+ m.register({ name: 'g', type: 'gauge', description: 'test' });
92
+ m.setGauge('g', 10);
93
+ m.setGauge('g', 20);
94
+ m.setGauge('g', 30);
95
+ const s = m.getStats('g')!;
96
+ expect(s.min).toBe(10);
97
+ expect(s.max).toBe(30);
98
+ expect(s.avg).toBe(20);
99
+ });
100
+ it('reset gauge clears values', () => {
101
+ const m = make();
102
+ m.register({ name: 'g', type: 'gauge', description: 'test' });
103
+ m.setGauge('g', 99);
104
+ m.reset('g');
105
+ expect(m.getGauge('g')).toBeUndefined();
106
+ });
107
+ });
108
+
109
+ describe('SwarmMetrics — histogram', () => {
110
+ it('observeHistogram adds to count', () => {
111
+ const m = make();
112
+ m.register({ name: 'h', type: 'histogram', description: 'test' });
113
+ m.observeHistogram('h', 5);
114
+ m.observeHistogram('h', 10);
115
+ expect(m.getHistogram('h')!.count).toBe(2);
116
+ });
117
+ it('sum accumulates correctly', () => {
118
+ const m = make();
119
+ m.register({ name: 'h', type: 'histogram', description: 'test' });
120
+ m.observeHistogram('h', 3);
121
+ m.observeHistogram('h', 7);
122
+ expect(m.getHistogram('h')!.sum).toBe(10);
123
+ });
124
+ it('setHistogramBoundaries updates buckets', () => {
125
+ const m = make();
126
+ m.register({ name: 'h', type: 'histogram', description: 'test' });
127
+ m.setHistogramBoundaries('h', [1, 5, 10]);
128
+ expect(m.getHistogram('h')!.boundaries).toHaveLength(3);
129
+ });
130
+ it('values bucketed correctly', () => {
131
+ const m = make();
132
+ m.register({ name: 'h', type: 'histogram', description: 'test' });
133
+ m.setHistogramBoundaries('h', [1, 5, 10]);
134
+ m.observeHistogram('h', 3); // in bucket [1,5]
135
+ const hist = m.getHistogram('h')!;
136
+ expect(hist.counts[1]).toBe(1); // boundary index 1 = le=5
137
+ });
138
+ it('getStats histogram: avg = sum/count', () => {
139
+ const m = make();
140
+ m.register({ name: 'h', type: 'histogram', description: 'test' });
141
+ m.observeHistogram('h', 4);
142
+ m.observeHistogram('h', 6);
143
+ expect(m.getStats('h')!.avg).toBe(5);
144
+ });
145
+ it('reset histogram clears', () => {
146
+ const m = make();
147
+ m.register({ name: 'h', type: 'histogram', description: 'test' });
148
+ m.observeHistogram('h', 5);
149
+ m.reset('h');
150
+ expect(m.getHistogram('h')!.count).toBe(0);
151
+ });
152
+ });
153
+
154
+ describe('SwarmMetrics — summary', () => {
155
+ it('observeSummary stores values', () => {
156
+ const m = make();
157
+ m.register({ name: 's', type: 'summary', description: 'test' });
158
+ m.observeSummary('s', 10);
159
+ m.observeSummary('s', 20);
160
+ expect(m.getSummary('s')!.count).toBe(2);
161
+ });
162
+ it('getSummary percentiles correct', () => {
163
+ const m = make();
164
+ m.register({ name: 's', type: 'summary', description: 'test' });
165
+ for (let i = 1; i <= 100; i++) m.observeSummary('s', i);
166
+ const p = m.getSummary('s')!;
167
+ expect(p.p50).toBeGreaterThanOrEqual(50);
168
+ expect(p.p99).toBeGreaterThanOrEqual(99);
169
+ });
170
+ it('getSummary undefined for no observations', () => {
171
+ const m = make();
172
+ m.register({ name: 's', type: 'summary', description: 'test' });
173
+ expect(m.getSummary('s')).toBeUndefined();
174
+ });
175
+ it('getStats summary: min/max/avg', () => {
176
+ const m = make();
177
+ m.register({ name: 's', type: 'summary', description: 'test' });
178
+ m.observeSummary('s', 2);
179
+ m.observeSummary('s', 4);
180
+ m.observeSummary('s', 6);
181
+ const s = m.getStats('s')!;
182
+ expect(s.min).toBe(2);
183
+ expect(s.max).toBe(6);
184
+ expect(s.avg).toBe(4);
185
+ });
186
+ it('maxSamples trims oldest', () => {
187
+ const m = make({ maxSamples: 3 });
188
+ m.register({ name: 's', type: 'summary', description: 'test' });
189
+ for (let i = 0; i < 5; i++) m.observeSummary('s', i);
190
+ expect(m.getSummary('s')!.count).toBe(3);
191
+ });
192
+ });
193
+
194
+ describe('SwarmMetrics — getRegistered / getAllStats / resetAll', () => {
195
+ it('getRegistered returns all defs', () => {
196
+ const m = make();
197
+ m.register({ name: 'c', type: 'counter', description: 'a' });
198
+ m.register({ name: 'g', type: 'gauge', description: 'b' });
199
+ expect(m.getRegistered()).toHaveLength(2);
200
+ });
201
+ it('getAllStats returns stats for all', () => {
202
+ const m = make();
203
+ m.register({ name: 'c', type: 'counter', description: 'test' });
204
+ m.register({ name: 'g', type: 'gauge', description: 'test' });
205
+ m.increment('c', 5);
206
+ m.setGauge('g', 3);
207
+ const all = m.getAllStats();
208
+ expect(all['c'].currentValue).toBe(5);
209
+ });
210
+ it('resetAll resets every metric', () => {
211
+ const m = make();
212
+ m.register({ name: 'c', type: 'counter', description: 'test' });
213
+ m.increment('c', 100);
214
+ m.resetAll();
215
+ expect(m.getCounter('c')).toBe(0);
216
+ });
217
+ it('getStats undefined for unregistered', () => {
218
+ expect(make().getStats('ghost')).toBeUndefined();
219
+ });
220
+ });
221
+
222
+ describe('SwarmMetrics — toPrometheus', () => {
223
+ it('counter exported', () => {
224
+ const m = make();
225
+ m.register({ name: 'req_total', type: 'counter', description: 'Requests' });
226
+ m.increment('req_total', 7);
227
+ const prom = m.toPrometheus();
228
+ expect(prom).toContain('req_total 7');
229
+ expect(prom).toContain('# HELP req_total Requests');
230
+ });
231
+ it('gauge exported', () => {
232
+ const m = make();
233
+ m.register({ name: 'mem_bytes', type: 'gauge', description: 'Memory' });
234
+ m.setGauge('mem_bytes', 512);
235
+ expect(m.toPrometheus()).toContain('mem_bytes 512');
236
+ });
237
+ it('histogram buckets exported', () => {
238
+ const m = make();
239
+ m.register({ name: 'latency', type: 'histogram', description: 'Latency' });
240
+ m.observeHistogram('latency', 0.3);
241
+ const prom = m.toPrometheus();
242
+ expect(prom).toContain('latency_bucket');
243
+ expect(prom).toContain('latency_sum');
244
+ expect(prom).toContain('latency_count');
245
+ });
246
+ it('summary quantiles exported', () => {
247
+ const m = make();
248
+ m.register({ name: 'resp', type: 'summary', description: 'Response' });
249
+ for (let i = 1; i <= 20; i++) m.observeSummary('resp', i);
250
+ const prom = m.toPrometheus();
251
+ expect(prom).toContain('quantile="0.5"');
252
+ expect(prom).toContain('quantile="0.99"');
253
+ });
254
+ });