claude-flow-novice 1.3.6 → 1.5.0

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 (345) hide show
  1. package/.claude/agents/analysis/code-analyzer.md +3 -20
  2. package/.claude/agents/analysis/code-review/analyze-code-quality.md +1 -1
  3. package/.claude/agents/analyst.md +208 -550
  4. package/.claude/agents/architect.md +136 -469
  5. package/.claude/agents/architecture/system-architect.md +20 -1
  6. package/.claude/agents/architecture/system-design/arch-system-design.md +1 -1
  7. package/.claude/agents/base-template-generator.md +24 -1
  8. package/.claude/agents/coder.md +87 -303
  9. package/.claude/agents/consensus/byzantine-coordinator.md +4 -21
  10. package/.claude/agents/consensus/consensus-builder.md +3 -20
  11. package/.claude/agents/consensus/crdt-synchronizer.md +4 -21
  12. package/.claude/agents/consensus/gossip-coordinator.md +4 -21
  13. package/.claude/agents/consensus/performance-benchmarker.md +4 -21
  14. package/.claude/agents/consensus/quorum-manager.md +4 -21
  15. package/.claude/agents/consensus/raft-manager.md +4 -21
  16. package/.claude/agents/consensus/security-manager.md +4 -21
  17. package/.claude/agents/coordinator.md +22 -11
  18. package/.claude/agents/data/ml/data-ml-model.md +2 -2
  19. package/.claude/agents/development/backend/dev-backend-api.md +2 -2
  20. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +2 -2
  21. package/.claude/agents/devops/devops-engineer.md +134 -402
  22. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +2 -2
  23. package/.claude/agents/github/code-review-swarm.md +1 -1
  24. package/.claude/agents/github/github-specialist.md +856 -0
  25. package/.claude/agents/github/pr-manager.md +1 -1
  26. package/.claude/agents/github/release-manager.md +1 -1
  27. package/.claude/agents/neural/neural-pattern-agent.md +762 -0
  28. package/.claude/agents/optimization/benchmark-suite.md +1 -1
  29. package/.claude/agents/optimization/perf-analyzer.md +1 -1
  30. package/.claude/agents/optimization/performance-monitor.md +1 -1
  31. package/.claude/agents/planner.md +135 -0
  32. package/.claude/agents/researcher.md +22 -9
  33. package/.claude/agents/reviewer.md +291 -0
  34. package/.claude/agents/security/security-specialist.md +1 -1
  35. package/.claude/agents/sparc/architecture.md +1 -1
  36. package/.claude/agents/sparc/pseudocode.md +1 -1
  37. package/.claude/agents/sparc/refinement.md +1 -1
  38. package/.claude/agents/sparc/specification.md +1 -1
  39. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +2 -2
  40. package/.claude/agents/tester.md +21 -11
  41. package/.claude/agents/testing/unit/tdd-london-swarm.md +1 -1
  42. package/.claude/agents/testing/validation/production-validator.md +1 -1
  43. package/.claude/commands/claude-soul.js +1 -1
  44. package/.claude/hooks.json +12 -15
  45. package/{.claude → .claude-flow-novice/.claude}/agents/MIGRATION_SUMMARY.md +1 -1
  46. package/.claude-flow-novice/.claude/agents/analysis/code-analyzer.md +192 -0
  47. package/.claude-flow-novice/.claude/agents/analysis/code-review/analyze-code-quality.md +180 -0
  48. package/.claude-flow-novice/.claude/agents/analyst.md +300 -0
  49. package/.claude-flow-novice/.claude/agents/architect.md +557 -0
  50. package/.claude-flow-novice/.claude/agents/architecture/system-architect.md +630 -0
  51. package/.claude-flow-novice/.claude/agents/architecture/system-design/arch-system-design.md +156 -0
  52. package/.claude-flow-novice/.claude/agents/base-template-generator.md +65 -0
  53. package/.claude-flow-novice/.claude/agents/coder.md +180 -0
  54. package/.claude-flow-novice/.claude/agents/consensus/byzantine-coordinator.md +46 -0
  55. package/.claude-flow-novice/.claude/agents/consensus/consensus-builder.md +225 -0
  56. package/.claude-flow-novice/.claude/agents/consensus/crdt-synchronizer.md +980 -0
  57. package/.claude-flow-novice/.claude/agents/consensus/gossip-coordinator.md +46 -0
  58. package/.claude-flow-novice/.claude/agents/consensus/performance-benchmarker.md +834 -0
  59. package/.claude-flow-novice/.claude/agents/consensus/quorum-manager.md +806 -0
  60. package/.claude-flow-novice/.claude/agents/consensus/raft-manager.md +46 -0
  61. package/.claude-flow-novice/.claude/agents/consensus/security-manager.md +605 -0
  62. package/.claude-flow-novice/.claude/agents/coordinator.md +842 -0
  63. package/.claude-flow-novice/.claude/agents/data/ml/data-ml-model.md +193 -0
  64. package/.claude-flow-novice/.claude/agents/development/backend/dev-backend-api.md +142 -0
  65. package/.claude-flow-novice/.claude/agents/devops/ci-cd/ops-cicd-github.md +164 -0
  66. package/.claude-flow-novice/.claude/agents/devops/devops-engineer.md +638 -0
  67. package/.claude-flow-novice/.claude/agents/documentation/api-docs/docs-api-openapi.md +174 -0
  68. package/.claude-flow-novice/.claude/agents/github/code-review-swarm.md +538 -0
  69. package/.claude-flow-novice/.claude/agents/github/github-modes.md +173 -0
  70. package/.claude-flow-novice/.claude/agents/github/github-specialist.md +856 -0
  71. package/.claude-flow-novice/.claude/agents/github/issue-tracker.md +319 -0
  72. package/.claude-flow-novice/.claude/agents/github/multi-repo-swarm.md +553 -0
  73. package/.claude-flow-novice/.claude/agents/github/pr-manager.md +191 -0
  74. package/.claude-flow-novice/.claude/agents/github/project-board-sync.md +509 -0
  75. package/.claude-flow-novice/.claude/agents/github/release-manager.md +367 -0
  76. package/.claude-flow-novice/.claude/agents/github/release-swarm.md +583 -0
  77. package/.claude-flow-novice/.claude/agents/github/repo-architect.md +398 -0
  78. package/.claude-flow-novice/.claude/agents/github/swarm-issue.md +573 -0
  79. package/.claude-flow-novice/.claude/agents/github/swarm-pr.md +428 -0
  80. package/.claude-flow-novice/.claude/agents/github/sync-coordinator.md +452 -0
  81. package/.claude-flow-novice/.claude/agents/github/workflow-automation.md +635 -0
  82. package/.claude-flow-novice/.claude/agents/goal/goal-planner.md +73 -0
  83. package/.claude-flow-novice/.claude/agents/neural/neural-pattern-agent.md +762 -0
  84. package/.claude-flow-novice/.claude/agents/neural/safla-neural.md +74 -0
  85. package/.claude-flow-novice/.claude/agents/optimization/benchmark-suite.md +665 -0
  86. package/.claude-flow-novice/.claude/agents/optimization/load-balancer.md +431 -0
  87. package/.claude-flow-novice/.claude/agents/optimization/perf-analyzer.md +725 -0
  88. package/.claude-flow-novice/.claude/agents/optimization/performance-monitor.md +672 -0
  89. package/.claude-flow-novice/.claude/agents/optimization/resource-allocator.md +674 -0
  90. package/.claude-flow-novice/.claude/agents/optimization/topology-optimizer.md +808 -0
  91. package/.claude-flow-novice/.claude/agents/planner.md +135 -0
  92. package/.claude-flow-novice/.claude/agents/researcher.md +185 -0
  93. package/.claude-flow-novice/.claude/agents/reviewer.md +291 -0
  94. package/.claude-flow-novice/.claude/agents/security/security-specialist.md +978 -0
  95. package/.claude-flow-novice/.claude/agents/sparc/architecture.md +472 -0
  96. package/.claude-flow-novice/.claude/agents/sparc/pseudocode.md +318 -0
  97. package/.claude-flow-novice/.claude/agents/sparc/refinement.md +525 -0
  98. package/.claude-flow-novice/.claude/agents/sparc/specification.md +276 -0
  99. package/.claude-flow-novice/.claude/agents/specialized/mobile/spec-mobile-react-native.md +226 -0
  100. package/.claude-flow-novice/.claude/agents/sublinear/consciousness-evolution-agent.md +499 -0
  101. package/.claude-flow-novice/.claude/agents/sublinear/matrix-solver-agent.md +113 -0
  102. package/.claude-flow-novice/.claude/agents/sublinear/nanosecond-scheduler-agent.md +644 -0
  103. package/.claude-flow-novice/.claude/agents/sublinear/pagerank-agent.md +699 -0
  104. package/.claude-flow-novice/.claude/agents/sublinear/phi-calculator-agent.md +749 -0
  105. package/.claude-flow-novice/.claude/agents/sublinear/psycho-symbolic-agent.md +543 -0
  106. package/.claude-flow-novice/.claude/agents/sublinear/sublinear.md +816 -0
  107. package/.claude-flow-novice/.claude/agents/sublinear/temporal-advantage-agent.md +360 -0
  108. package/.claude-flow-novice/.claude/agents/swarm/adaptive-coordinator-enhanced.md +746 -0
  109. package/.claude-flow-novice/.claude/agents/swarm/adaptive-coordinator.md +396 -0
  110. package/.claude-flow-novice/.claude/agents/swarm/hierarchical-coordinator.md +300 -0
  111. package/.claude-flow-novice/.claude/agents/swarm/mesh-coordinator.md +435 -0
  112. package/.claude-flow-novice/.claude/agents/templates/automation-smart-agent.md +205 -0
  113. package/.claude-flow-novice/.claude/agents/templates/coordinator-swarm-init.md +90 -0
  114. package/.claude-flow-novice/.claude/agents/templates/github-pr-manager.md +177 -0
  115. package/.claude-flow-novice/.claude/agents/templates/implementer-sparc-coder.md +259 -0
  116. package/.claude-flow-novice/.claude/agents/templates/memory-coordinator.md +187 -0
  117. package/.claude-flow-novice/.claude/agents/templates/migration-plan.md +746 -0
  118. package/.claude-flow-novice/.claude/agents/templates/orchestrator-task.md +139 -0
  119. package/.claude-flow-novice/.claude/agents/templates/performance-analyzer.md +199 -0
  120. package/.claude-flow-novice/.claude/agents/templates/sparc-coordinator.md +183 -0
  121. package/.claude-flow-novice/.claude/agents/tester.md +663 -0
  122. package/.claude-flow-novice/.claude/agents/testing/e2e/playwright-agent.md +249 -0
  123. package/.claude-flow-novice/.claude/agents/testing/unit/tdd-london-swarm.md +244 -0
  124. package/.claude-flow-novice/.claude/agents/testing/validation/production-validator.md +395 -0
  125. package/.claude-flow-novice/dist/index.js +12 -24
  126. package/.claude-flow-novice/dist/index.js.map +1 -0
  127. package/.claude-flow-novice/dist/src/agents/agent-manager.js +123 -69
  128. package/.claude-flow-novice/dist/src/agents/agent-manager.js.map +1 -1
  129. package/.claude-flow-novice/dist/src/agents/github/utils/hook-integration.js +7 -7
  130. package/.claude-flow-novice/dist/src/agents/github/utils/hook-integration.js.map +1 -1
  131. package/.claude-flow-novice/dist/src/agents/stage3-integration-validator.js +485 -0
  132. package/.claude-flow-novice/dist/src/agents/stage3-integration-validator.js.map +1 -0
  133. package/.claude-flow-novice/dist/src/agents/unified-ultra-fast-agent-manager.js +630 -0
  134. package/.claude-flow-novice/dist/src/agents/unified-ultra-fast-agent-manager.js.map +1 -0
  135. package/.claude-flow-novice/dist/src/cli/commands/agent.js +1 -1
  136. package/.claude-flow-novice/dist/src/cli/commands/agent.js.map +1 -1
  137. package/.claude-flow-novice/dist/src/cli/commands/config-integration.js +6 -6
  138. package/.claude-flow-novice/dist/src/cli/commands/enterprise.js +18 -18
  139. package/.claude-flow-novice/dist/src/cli/commands/enterprise.js.map +1 -1
  140. package/.claude-flow-novice/dist/src/cli/commands/goal-init.js +4 -4
  141. package/.claude-flow-novice/dist/src/cli/commands/help-new.js +23 -23
  142. package/.claude-flow-novice/dist/src/cli/commands/help-new.js.map +1 -1
  143. package/.claude-flow-novice/dist/src/cli/commands/help.js +74 -74
  144. package/.claude-flow-novice/dist/src/cli/commands/help.js.map +1 -1
  145. package/.claude-flow-novice/dist/src/cli/commands/hive-mind/pause.js +2 -2
  146. package/.claude-flow-novice/dist/src/cli/commands/hive-mind/pause.js.map +1 -1
  147. package/.claude-flow-novice/dist/src/cli/commands/hive.js +4 -4
  148. package/.claude-flow-novice/dist/src/cli/commands/index.js +103 -132
  149. package/.claude-flow-novice/dist/src/cli/commands/index.js.map +1 -1
  150. package/.claude-flow-novice/dist/src/cli/commands/mcp.js +1 -1
  151. package/.claude-flow-novice/dist/src/cli/commands/migrate.js +4 -4
  152. package/.claude-flow-novice/dist/src/cli/commands/migrate.js.map +1 -1
  153. package/.claude-flow-novice/dist/src/cli/commands/monitor.js +1 -1
  154. package/.claude-flow-novice/dist/src/cli/commands/neural-init.js +4 -4
  155. package/.claude-flow-novice/dist/src/cli/commands/ruv-swarm.js +8 -8
  156. package/.claude-flow-novice/dist/src/cli/commands/sparc.js +12 -12
  157. package/.claude-flow-novice/dist/src/cli/commands/sparc.js.map +1 -1
  158. package/.claude-flow-novice/dist/src/cli/commands/start/start-command.js +3 -3
  159. package/.claude-flow-novice/dist/src/cli/commands/status.js +1 -1
  160. package/.claude-flow-novice/dist/src/cli/commands/swarm.js +7 -7
  161. package/.claude-flow-novice/dist/src/cli/commands/swarm.js.map +1 -1
  162. package/.claude-flow-novice/dist/src/cli/commands/verification.js +18 -18
  163. package/.claude-flow-novice/dist/src/cli/completion.js +54 -54
  164. package/.claude-flow-novice/dist/src/cli/completion.js.map +1 -1
  165. package/.claude-flow-novice/dist/src/cli/consolidated/ConsolidatedCLI.js +11 -11
  166. package/.claude-flow-novice/dist/src/cli/consolidated/ConsolidatedCLI.js.map +1 -1
  167. package/.claude-flow-novice/dist/src/cli/consolidated/core/CommandHandlers.js +31 -31
  168. package/.claude-flow-novice/dist/src/cli/consolidated/core/TierManager.js +39 -39
  169. package/.claude-flow-novice/dist/src/cli/consolidated/core/TierManager.js.map +1 -1
  170. package/.claude-flow-novice/dist/src/cli/consolidated/help/InteractiveHelp.js +25 -25
  171. package/.claude-flow-novice/dist/src/cli/consolidated/help/InteractiveHelp.js.map +1 -1
  172. package/.claude-flow-novice/dist/src/cli/consolidated/routing/CommandRouter.js +8 -8
  173. package/.claude-flow-novice/dist/src/cli/consolidated/routing/CommandRouter.js.map +1 -1
  174. package/.claude-flow-novice/dist/src/cli/consolidated/utils/IntelligentDefaults.js +6 -6
  175. package/.claude-flow-novice/dist/src/cli/consolidated/utils/IntelligentDefaults.js.map +1 -1
  176. package/.claude-flow-novice/dist/src/cli/consolidated/utils/PerformanceOptimizer.js +7 -7
  177. package/.claude-flow-novice/dist/src/cli/consolidated/utils/PerformanceOptimizer.js.map +1 -1
  178. package/.claude-flow-novice/dist/src/cli/index-remote.js +10 -10
  179. package/.claude-flow-novice/dist/src/cli/index.js +1 -1
  180. package/.claude-flow-novice/dist/src/cli/init/directory-structure.js +8 -8
  181. package/.claude-flow-novice/dist/src/cli/init/index.js +3 -3
  182. package/.claude-flow-novice/dist/src/cli/init/sparc-environment.js +67 -67
  183. package/.claude-flow-novice/dist/src/cli/init/swarm-commands.js +18 -18
  184. package/.claude-flow-novice/dist/src/cli/node-repl.js +2 -2
  185. package/.claude-flow-novice/dist/src/cli/repl.js +1 -1
  186. package/.claude-flow-novice/dist/src/cli/simple-cli.js +68 -68
  187. package/.claude-flow-novice/dist/src/cli/simple-cli.js.map +1 -1
  188. package/.claude-flow-novice/dist/src/cli/simple-commands/session-start-soul.js +271 -0
  189. package/.claude-flow-novice/dist/src/cli/simple-orchestrator.js +7 -7
  190. package/.claude-flow-novice/dist/src/cli/simple-orchestrator.js.map +1 -1
  191. package/.claude-flow-novice/dist/src/cli/ui/fallback-handler.js +7 -7
  192. package/.claude-flow-novice/dist/src/communication/enhanced-event-bus.js +816 -0
  193. package/.claude-flow-novice/dist/src/communication/enhanced-event-bus.js.map +1 -0
  194. package/.claude-flow-novice/dist/src/communication/failure-recovery-system.js +812 -0
  195. package/.claude-flow-novice/dist/src/communication/failure-recovery-system.js.map +1 -0
  196. package/.claude-flow-novice/dist/src/communication/optimized-serialization.js +369 -0
  197. package/.claude-flow-novice/dist/src/communication/optimized-serialization.js.map +1 -0
  198. package/.claude-flow-novice/dist/src/communication/performance-optimizations.js +526 -0
  199. package/.claude-flow-novice/dist/src/communication/performance-optimizations.js.map +1 -0
  200. package/.claude-flow-novice/dist/src/communication/performance-validator.js +532 -0
  201. package/.claude-flow-novice/dist/src/communication/performance-validator.js.map +1 -0
  202. package/.claude-flow-novice/dist/src/communication/priority-message-queue.js +525 -0
  203. package/.claude-flow-novice/dist/src/communication/priority-message-queue.js.map +1 -0
  204. package/.claude-flow-novice/dist/src/communication/shared-buffer-bus.js +218 -0
  205. package/.claude-flow-novice/dist/src/communication/shared-buffer-bus.js.map +1 -0
  206. package/.claude-flow-novice/dist/src/communication/ultra-fast-communication-bus.js +521 -0
  207. package/.claude-flow-novice/dist/src/communication/ultra-fast-communication-bus.js.map +1 -0
  208. package/.claude-flow-novice/dist/src/communication/ultra-fast-serialization.js +563 -0
  209. package/.claude-flow-novice/dist/src/communication/ultra-fast-serialization.js.map +1 -0
  210. package/.claude-flow-novice/dist/src/communication/websocket-cluster.js +344 -0
  211. package/.claude-flow-novice/dist/src/communication/websocket-cluster.js.map +1 -0
  212. package/.claude-flow-novice/dist/src/communication/zero-copy-structures.js +369 -0
  213. package/.claude-flow-novice/dist/src/communication/zero-copy-structures.js.map +1 -0
  214. package/.claude-flow-novice/dist/src/config/config-manager.js +1 -1
  215. package/.claude-flow-novice/dist/src/config/config-manager.js.map +1 -1
  216. package/.claude-flow-novice/dist/src/config/core/intelligent-configuration-manager.js +1 -1
  217. package/.claude-flow-novice/dist/src/config/integration/hooks-integration.js +6 -6
  218. package/.claude-flow-novice/dist/src/config/integration/hooks-integration.js.map +1 -1
  219. package/.claude-flow-novice/dist/src/config/migration/config-migration.js +1 -1
  220. package/.claude-flow-novice/dist/src/config/ruv-swarm-integration.js +1 -1
  221. package/.claude-flow-novice/dist/src/config/utils/zero-config-setup.js +1 -1
  222. package/.claude-flow-novice/dist/src/config/utils/zero-config-setup.js.map +1 -1
  223. package/.claude-flow-novice/dist/src/config/web-portal-config.js +0 -9
  224. package/.claude-flow-novice/dist/src/config/web-portal-config.js.map +1 -1
  225. package/.claude-flow-novice/dist/src/config/zero-config-setup.js +18 -18
  226. package/.claude-flow-novice/dist/src/config/zero-config-setup.js.map +1 -1
  227. package/.claude-flow-novice/dist/src/core/logger.js +33 -10
  228. package/.claude-flow-novice/dist/src/core/logger.js.map +1 -1
  229. package/.claude-flow-novice/dist/src/migration/index.js +1 -1
  230. package/.claude-flow-novice/dist/src/migration/index.js.map +1 -1
  231. package/.claude-flow-novice/dist/src/migration/migration-runner.js +4 -4
  232. package/.claude-flow-novice/dist/src/migration/migration-runner.js.map +1 -1
  233. package/.claude-flow-novice/dist/src/monitoring/agent-health-monitor.js +430 -0
  234. package/.claude-flow-novice/dist/src/monitoring/agent-health-monitor.js.map +1 -0
  235. package/.claude-flow-novice/dist/src/slash-commands/claude-soul.js +248 -365
  236. package/.claude-flow-novice/dist/src/slash-commands/register-all-commands.js +1 -1
  237. package/.claude-flow-novice/dist/src/swarm/claude-code-interface.js +1 -1
  238. package/.claude-flow-novice/dist/src/swarm/claude-flow-executor.js +1 -1
  239. package/.claude-flow-novice/dist/src/swarm/consensus-coordinator.js +471 -0
  240. package/.claude-flow-novice/dist/src/swarm/consensus-coordinator.js.map +1 -0
  241. package/.claude-flow-novice/dist/src/swarm/hive-mind-integration.js +1 -1
  242. package/.claude-flow-novice/dist/src/swarm/large-scale-coordinator.js +543 -0
  243. package/.claude-flow-novice/dist/src/swarm/large-scale-coordinator.js.map +1 -0
  244. package/.claude-flow-novice/dist/src/swarm/optimizations/connection-pool.js +1 -1
  245. package/.claude-flow-novice/dist/src/swarm/optimizations/optimized-executor.js +1 -1
  246. package/.claude-flow-novice/dist/src/swarm/types.js.map +1 -1
  247. package/.claude-flow-novice/dist/src/swarm-fullstack/integrations/communication-bridge.js +709 -0
  248. package/.claude-flow-novice/dist/src/swarm-fullstack/integrations/communication-bridge.js.map +1 -0
  249. package/.claude-flow-novice/dist/src/swarm-fullstack/testing/api-contract-validator.js +612 -0
  250. package/.claude-flow-novice/dist/src/swarm-fullstack/testing/api-contract-validator.js.map +1 -0
  251. package/.claude-flow-novice/dist/src/swarm-fullstack/testing/backend-test-orchestrator.js +679 -0
  252. package/.claude-flow-novice/dist/src/swarm-fullstack/testing/backend-test-orchestrator.js.map +1 -0
  253. package/.claude-flow-novice/dist/src/swarm-fullstack/testing/frontend-test-orchestrator.js +654 -0
  254. package/.claude-flow-novice/dist/src/swarm-fullstack/testing/frontend-test-orchestrator.js.map +1 -0
  255. package/.claude-flow-novice/dist/src/swarm-fullstack/testing/visual-regression.js +402 -0
  256. package/.claude-flow-novice/dist/src/swarm-fullstack/testing/visual-regression.js.map +1 -0
  257. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/convergence-detector.js +459 -0
  258. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/convergence-detector.js.map +1 -0
  259. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/fix-coordinator.js +513 -0
  260. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/fix-coordinator.js.map +1 -0
  261. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/index.js +19 -0
  262. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/index.js.map +1 -0
  263. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/iterative-build-test.js +568 -0
  264. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/iterative-build-test.js.map +1 -0
  265. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/regression-test-manager.js +418 -0
  266. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/regression-test-manager.js.map +1 -0
  267. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/test-result-analyzer.js +530 -0
  268. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/test-result-analyzer.js.map +1 -0
  269. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/workflow-metrics.js +250 -0
  270. package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/workflow-metrics.js.map +1 -0
  271. package/.claude-flow-novice/dist/src/task/index.js +7 -7
  272. package/.claude-flow-novice/dist/src/validation/fullstack-integration-validator.js +420 -0
  273. package/.claude-flow-novice/dist/src/validation/fullstack-integration-validator.js.map +1 -0
  274. package/.claude-flow-novice/dist/src/validation/production-validator.js +1435 -0
  275. package/.claude-flow-novice/dist/src/validation/production-validator.js.map +1 -0
  276. package/.claude-flow-novice/dist/src/verification/cli-integration.js +3 -3
  277. package/.claude-flow-novice/dist/src/verification/hooks.js +1 -1
  278. package/CHANGELOG.md +13 -0
  279. package/CLAUDE.md +1029 -68
  280. package/README.md +0 -1
  281. package/config/build/babel.config.cjs +19 -11
  282. package/config/typescript/tsconfig.json +1 -1
  283. package/examples/claude-api-error-handling.ts +2 -2
  284. package/examples/frontend-testing-demo.ts +470 -0
  285. package/examples/litellm/config/config.yaml +1 -1
  286. package/package.json +13 -7
  287. package/scripts/build/unified-builder.sh +6 -6
  288. package/scripts/build/validate-agents.js +238 -0
  289. package/scripts/run-production-validation.ts +590 -0
  290. package/scripts/test/test-coordination-features.ts +2 -2
  291. package/scripts/validate-stage3-performance.ts +377 -0
  292. package/src/cli/simple-commands/hooks.js +1 -0
  293. package/src/cli/simple-commands/init/agent-copier.js +0 -2
  294. package/src/cli/simple-commands/init/index.js +5 -97
  295. package/src/cli/simple-commands/init/templates/CLAUDE.md +162 -1158
  296. package/src/cli/simple-commands/init/templates/claude-md.js +38 -157
  297. package/src/swarm-fullstack/integrations/communication-bridge.ts +931 -0
  298. package/src/swarm-fullstack/testing/api-contract-validator.ts +909 -0
  299. package/src/swarm-fullstack/testing/backend-test-orchestrator.ts +791 -0
  300. package/src/swarm-fullstack/testing/frontend-test-orchestrator.ts +853 -0
  301. package/src/swarm-fullstack/testing/visual-regression.ts +507 -0
  302. package/src/swarm-fullstack/workflows/convergence-detector.ts +736 -0
  303. package/src/swarm-fullstack/workflows/fix-coordinator.ts +677 -0
  304. package/src/swarm-fullstack/workflows/index.ts +75 -0
  305. package/src/swarm-fullstack/workflows/iterative-build-test.ts +829 -0
  306. package/src/swarm-fullstack/workflows/regression-test-manager.ts +590 -0
  307. package/src/swarm-fullstack/workflows/test-result-analyzer.ts +739 -0
  308. package/src/swarm-fullstack/workflows/workflow-metrics.ts +399 -0
  309. package/wiki/command-reference/README.md +1 -2
  310. package/wiki/command-reference/mcp-tools/README.md +1 -1
  311. package/wiki/getting-started/claude-code-mcp/README.md +1 -2
  312. package/wiki/getting-started/installation/README.md +2 -10
  313. package/.claude/commands/flow-nexus/app-store.md +0 -124
  314. package/.claude/commands/flow-nexus/challenges.md +0 -120
  315. package/.claude/commands/flow-nexus/login-registration.md +0 -65
  316. package/.claude/commands/flow-nexus/neural-network.md +0 -134
  317. package/.claude/commands/flow-nexus/payments.md +0 -116
  318. package/.claude/commands/flow-nexus/sandbox.md +0 -83
  319. package/.claude/commands/flow-nexus/swarm.md +0 -87
  320. package/.claude/commands/flow-nexus/user-tools.md +0 -152
  321. package/.claude/commands/flow-nexus/workflow.md +0 -115
  322. package/.claude-flow-novice/dist/cli/index.js +0 -45
  323. package/.claude-flow-novice/dist/core/index.js +0 -22
  324. package/.claude-flow-novice/dist/mcp/mcp-server-novice.js +0 -595
  325. package/.claude-flow-novice/dist/mcp/mcp-server-sdk.js +0 -649
  326. package/.claude-flow-novice/dist/mcp/mcp-server-with-slash-commands.js +0 -776
  327. package/.claude-flow-novice/dist/src/cli/simple-commands/init/templates/claude-md.js +0 -1101
  328. package/src/cli/simple-commands/init/templates/CLAUDE.md.optimized +0 -265
  329. /package/{.claude → .claude-flow-novice/.claude}/agents/README.md +0 -0
  330. /package/{.claude → .claude-flow-novice/.claude}/agents/backend-dev.json +0 -0
  331. /package/{.claude → .claude-flow-novice/.claude}/agents/code-analyzer.json +0 -0
  332. /package/{.claude → .claude-flow-novice/.claude}/agents/coder.json +0 -0
  333. /package/{.claude → .claude-flow-novice/.claude}/agents/consensus/README.md +0 -0
  334. /package/{.claude → .claude-flow-novice/.claude}/agents/core/coder.md +0 -0
  335. /package/{.claude → .claude-flow-novice/.claude}/agents/core/planner.md +0 -0
  336. /package/{.claude → .claude-flow-novice/.claude}/agents/core/researcher.md +0 -0
  337. /package/{.claude → .claude-flow-novice/.claude}/agents/core/reviewer.md +0 -0
  338. /package/{.claude → .claude-flow-novice/.claude}/agents/core/tester.md +0 -0
  339. /package/{.claude → .claude-flow-novice/.claude}/agents/optimization/README.md +0 -0
  340. /package/{.claude → .claude-flow-novice/.claude}/agents/planner.json +0 -0
  341. /package/{.claude → .claude-flow-novice/.claude}/agents/researcher.json +0 -0
  342. /package/{.claude → .claude-flow-novice/.claude}/agents/reviewer.json +0 -0
  343. /package/{.claude → .claude-flow-novice/.claude}/agents/swarm/README.md +0 -0
  344. /package/{.claude → .claude-flow-novice/.claude}/agents/system-architect.json +0 -0
  345. /package/{.claude → .claude-flow-novice/.claude}/agents/tester.json +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../src/swarm-fullstack/integrations/communication-bridge.ts"],"names":["EventEmitter","UltraFastCommunicationBus","CommunicationMemoryStore","loadCommunicationComponents","commModule","default","console","warn","memModule","CommunicationBridge","config","logger","communicationBus","memoryStore","communicationEnabled","orchestrator","messageRouter","swarmSubscriptions","Map","agentQueues","metrics","messagesRouted","memoryOperations","coordinationEvents","averageLatency","activeSwarms","activeAgents","enableUltraFastComm","enableMemorySharing","enableRealTimeProgress","messageBufferSize","maxSubscriptionsPerAgent","broadcastBatchSize","enableCrossLayerCoordination","enableDependencyTracking","enableIterativeBuilding","memoryNamespace","persistMemory","memoryTTL","enableMetrics","metricsInterval","initialize","info","initializeCommunicationBus","initializeMemoryStore","setupOrchestratorHandlers","setupMessageRouterHandlers","startMetricsCollection","componentsActive","emit","enableZeroCopy","enableOptimizedSerialization","maxBufferSize","error","enableCommunication","on","event","handleMemoryStoreEvent","update","handleMemoryRemoteUpdate","handleFeatureDevelopmentStarted","handlePhaseCompleted","handleSwarmTeamReady","handleFeatureDevelopmentCompleted","handleSwarmScaled","message","handleEnhancedMessage","state","handleSwarmStateUpdated","routeDirectMessage","routeBroadcastMessage","routeHierarchicalMessage","swarmId","request","featureName","name","broadcastCoordinationEvent","type","data","phase","feature","requirements","timestamp","Date","toISOString","priority","store","namespace","metadata","broadcast","team","agentCount","agents","length","agent","registerAgent","id","map","a","capabilities","agentId","agentType","queueId","subscribe","getAgentLayer","set","has","Set","get","add","startTime","performance","now","publish","topic","buildMessageTopic","payload","serializeMessage","getPriority","mapMessageTypeToCoordinationEvent","messageType","messageId","content","layer","latency","updateLatencyMetrics","completedAt","results","serializeCoordinationEvent","shouldStoreCoordinationEvent","shareMemory","coordination","key","value","dependencies","version","queryMemory","options","retrieve","queryRemote","found","complexity","teamComposition","messageCount","resourceUsage","targetAgent","coordinator","status","cleanupSwarm","newTeamSize","action","delete","targetAgents","priorityMap","typeMap","includes","json","JSON","stringify","encoder","TextEncoder","encode","buffer","importantTypes","alpha","setInterval","getMetrics","communicationBusMetrics","memoryStoreMetrics","shutdown","keys","close"],"mappings":"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"}
@@ -0,0 +1,612 @@
1
+ /**
2
+ * API Contract Validator - Validates API contracts and detects breaking changes
3
+ * Implements OpenAPI schema validation and contract testing
4
+ */ import { EventEmitter } from 'events';
5
+ export class APIContractValidator extends EventEmitter {
6
+ logger;
7
+ contracts = new Map();
8
+ validationHistory = [];
9
+ constructor(logger){
10
+ super(), this.logger = logger;
11
+ }
12
+ /**
13
+ * Register API contract
14
+ */ registerContract(name, contract) {
15
+ this.logger.info('Registering API contract', {
16
+ name,
17
+ version: contract.version
18
+ });
19
+ // Validate contract structure
20
+ this.validateContractStructure(contract);
21
+ this.contracts.set(name, contract);
22
+ this.emit('contract-registered', {
23
+ name,
24
+ contract
25
+ });
26
+ }
27
+ /**
28
+ * Validate API request/response against contract
29
+ */ async validateRequest(contractName, endpoint, method, request) {
30
+ this.logger.debug('Validating request', {
31
+ contractName,
32
+ endpoint,
33
+ method
34
+ });
35
+ const contract = this.contracts.get(contractName);
36
+ if (!contract) {
37
+ throw new Error(`Contract ${contractName} not found`);
38
+ }
39
+ const apiEndpoint = this.findEndpoint(contract, endpoint, method);
40
+ if (!apiEndpoint) {
41
+ return {
42
+ valid: false,
43
+ endpoint,
44
+ method,
45
+ errors: [
46
+ {
47
+ type: 'request',
48
+ severity: 'critical',
49
+ message: `Endpoint ${method} ${endpoint} not found in contract`,
50
+ path: endpoint
51
+ }
52
+ ],
53
+ warnings: [],
54
+ timestamp: new Date().toISOString()
55
+ };
56
+ }
57
+ const errors = [];
58
+ const warnings = [];
59
+ // Validate path parameters
60
+ if (request.params) {
61
+ const paramErrors = this.validateParameters(apiEndpoint.parameters.filter((p)=>p.in === 'path'), request.params, 'path');
62
+ errors.push(...paramErrors);
63
+ }
64
+ // Validate query parameters
65
+ if (request.query) {
66
+ const queryErrors = this.validateParameters(apiEndpoint.parameters.filter((p)=>p.in === 'query'), request.query, 'query');
67
+ errors.push(...queryErrors);
68
+ }
69
+ // Validate headers
70
+ if (request.headers) {
71
+ const headerErrors = this.validateParameters(apiEndpoint.parameters.filter((p)=>p.in === 'header'), request.headers, 'header');
72
+ errors.push(...headerErrors);
73
+ }
74
+ // Validate request body
75
+ if (request.body && apiEndpoint.requestBody) {
76
+ const bodyErrors = this.validateRequestBody(apiEndpoint.requestBody, request.body);
77
+ errors.push(...bodyErrors);
78
+ }
79
+ // Check for deprecated fields
80
+ warnings.push(...this.checkDeprecations(apiEndpoint, request));
81
+ const result = {
82
+ valid: errors.length === 0,
83
+ endpoint,
84
+ method,
85
+ errors,
86
+ warnings,
87
+ timestamp: new Date().toISOString()
88
+ };
89
+ this.validationHistory.push(result);
90
+ this.emit('request-validated', result);
91
+ return result;
92
+ }
93
+ /**
94
+ * Validate API response against contract
95
+ */ async validateResponse(contractName, endpoint, method, statusCode, response) {
96
+ this.logger.debug('Validating response', {
97
+ contractName,
98
+ endpoint,
99
+ method,
100
+ statusCode
101
+ });
102
+ const contract = this.contracts.get(contractName);
103
+ if (!contract) {
104
+ throw new Error(`Contract ${contractName} not found`);
105
+ }
106
+ const apiEndpoint = this.findEndpoint(contract, endpoint, method);
107
+ if (!apiEndpoint) {
108
+ return {
109
+ valid: false,
110
+ endpoint,
111
+ method,
112
+ errors: [
113
+ {
114
+ type: 'response',
115
+ severity: 'critical',
116
+ message: `Endpoint ${method} ${endpoint} not found in contract`,
117
+ path: endpoint
118
+ }
119
+ ],
120
+ warnings: [],
121
+ timestamp: new Date().toISOString()
122
+ };
123
+ }
124
+ const errors = [];
125
+ const warnings = [];
126
+ const expectedResponse = apiEndpoint.responses.get(statusCode);
127
+ if (!expectedResponse) {
128
+ errors.push({
129
+ type: 'response',
130
+ severity: 'high',
131
+ message: `Status code ${statusCode} not defined in contract`,
132
+ path: `${endpoint}.responses.${statusCode}`
133
+ });
134
+ } else {
135
+ // Validate response body
136
+ if (response.body && expectedResponse.content) {
137
+ const contentType = 'application/json'; // Assume JSON for simplicity
138
+ const mediaType = expectedResponse.content.get(contentType);
139
+ if (mediaType) {
140
+ const bodyErrors = this.validateAgainstSchema(response.body, mediaType.schema, `${endpoint}.response.body`);
141
+ errors.push(...bodyErrors);
142
+ }
143
+ }
144
+ // Validate response headers
145
+ if (response.headers && expectedResponse.headers) {
146
+ const headerErrors = this.validateResponseHeaders(expectedResponse.headers, response.headers);
147
+ errors.push(...headerErrors);
148
+ }
149
+ }
150
+ const result = {
151
+ valid: errors.length === 0,
152
+ endpoint,
153
+ method,
154
+ errors,
155
+ warnings,
156
+ timestamp: new Date().toISOString()
157
+ };
158
+ this.validationHistory.push(result);
159
+ this.emit('response-validated', result);
160
+ return result;
161
+ }
162
+ /**
163
+ * Compare two contracts to detect breaking changes
164
+ */ compareContracts(oldContract, newContract) {
165
+ this.logger.info('Comparing contracts', {
166
+ oldVersion: oldContract.version,
167
+ newVersion: newContract.version
168
+ });
169
+ const diff = {
170
+ breaking: [],
171
+ nonBreaking: [],
172
+ additions: [],
173
+ deprecations: []
174
+ };
175
+ // Compare endpoints
176
+ const oldEndpoints = new Map(oldContract.endpoints.map((e)=>[
177
+ `${e.method} ${e.path}`,
178
+ e
179
+ ]));
180
+ const newEndpoints = new Map(newContract.endpoints.map((e)=>[
181
+ `${e.method} ${e.path}`,
182
+ e
183
+ ]));
184
+ // Check for removed endpoints (breaking)
185
+ oldEndpoints.forEach((oldEndpoint, key)=>{
186
+ if (!newEndpoints.has(key)) {
187
+ diff.breaking.push({
188
+ type: 'removed-endpoint',
189
+ endpoint: key,
190
+ path: oldEndpoint.path,
191
+ oldValue: oldEndpoint,
192
+ newValue: null,
193
+ impact: 'high'
194
+ });
195
+ }
196
+ });
197
+ // Check for added endpoints (non-breaking)
198
+ newEndpoints.forEach((newEndpoint, key)=>{
199
+ if (!oldEndpoints.has(key)) {
200
+ diff.additions.push({
201
+ type: 'new-endpoint',
202
+ endpoint: key,
203
+ path: newEndpoint.path,
204
+ value: newEndpoint
205
+ });
206
+ }
207
+ });
208
+ // Compare existing endpoints
209
+ oldEndpoints.forEach((oldEndpoint, key)=>{
210
+ const newEndpoint = newEndpoints.get(key);
211
+ if (newEndpoint) {
212
+ const endpointDiff = this.compareEndpoints(oldEndpoint, newEndpoint);
213
+ diff.breaking.push(...endpointDiff.breaking);
214
+ diff.nonBreaking.push(...endpointDiff.nonBreaking);
215
+ diff.additions.push(...endpointDiff.additions);
216
+ }
217
+ });
218
+ this.emit('contracts-compared', {
219
+ diff
220
+ });
221
+ return diff;
222
+ }
223
+ /**
224
+ * Generate OpenAPI specification from contract
225
+ */ generateOpenAPISpec(contract) {
226
+ this.logger.info('Generating OpenAPI specification', {
227
+ version: contract.version
228
+ });
229
+ const spec = {
230
+ openapi: '3.0.3',
231
+ info: {
232
+ version: contract.version,
233
+ title: 'API Contract'
234
+ },
235
+ servers: [
236
+ {
237
+ url: contract.basePath
238
+ }
239
+ ],
240
+ paths: this.generatePaths(contract),
241
+ components: {
242
+ schemas: this.generateSchemas(contract.schemas),
243
+ securitySchemes: this.generateSecuritySchemes(contract.securitySchemes)
244
+ }
245
+ };
246
+ return spec;
247
+ }
248
+ /**
249
+ * Validate contract structure
250
+ */ validateContractStructure(contract) {
251
+ if (!contract.version) {
252
+ throw new Error('Contract must have a version');
253
+ }
254
+ if (!contract.basePath) {
255
+ throw new Error('Contract must have a basePath');
256
+ }
257
+ if (!contract.endpoints || contract.endpoints.length === 0) {
258
+ throw new Error('Contract must have at least one endpoint');
259
+ }
260
+ }
261
+ /**
262
+ * Find endpoint in contract
263
+ */ findEndpoint(contract, path, method) {
264
+ return contract.endpoints.find((e)=>e.path === path && e.method === method);
265
+ }
266
+ /**
267
+ * Validate parameters
268
+ */ validateParameters(parameters, values, location) {
269
+ const errors = [];
270
+ // Check required parameters
271
+ parameters.filter((p)=>p.required).forEach((param)=>{
272
+ if (values[param.name] === undefined) {
273
+ errors.push({
274
+ type: 'request',
275
+ severity: 'critical',
276
+ message: `Missing required ${location} parameter: ${param.name}`,
277
+ path: `${location}.${param.name}`
278
+ });
279
+ }
280
+ });
281
+ // Validate parameter values
282
+ Object.entries(values).forEach(([name, value])=>{
283
+ const param = parameters.find((p)=>p.name === name);
284
+ if (param) {
285
+ const schemaErrors = this.validateAgainstSchema(value, param.schema, `${location}.${name}`);
286
+ errors.push(...schemaErrors);
287
+ }
288
+ });
289
+ return errors;
290
+ }
291
+ /**
292
+ * Validate request body
293
+ */ validateRequestBody(requestBody, body) {
294
+ const errors = [];
295
+ if (requestBody.required && !body) {
296
+ errors.push({
297
+ type: 'request',
298
+ severity: 'critical',
299
+ message: 'Request body is required',
300
+ path: 'body'
301
+ });
302
+ return errors;
303
+ }
304
+ const contentType = 'application/json';
305
+ const mediaType = requestBody.content.get(contentType);
306
+ if (mediaType) {
307
+ const schemaErrors = this.validateAgainstSchema(body, mediaType.schema, 'body');
308
+ errors.push(...schemaErrors);
309
+ }
310
+ return errors;
311
+ }
312
+ /**
313
+ * Validate response headers
314
+ */ validateResponseHeaders(expectedHeaders, actualHeaders) {
315
+ const errors = [];
316
+ expectedHeaders.forEach((header, name)=>{
317
+ if (header.required && actualHeaders[name] === undefined) {
318
+ errors.push({
319
+ type: 'response',
320
+ severity: 'high',
321
+ message: `Missing required response header: ${name}`,
322
+ path: `headers.${name}`
323
+ });
324
+ }
325
+ if (actualHeaders[name] !== undefined) {
326
+ const schemaErrors = this.validateAgainstSchema(actualHeaders[name], header.schema, `headers.${name}`);
327
+ errors.push(...schemaErrors);
328
+ }
329
+ });
330
+ return errors;
331
+ }
332
+ /**
333
+ * Validate value against schema
334
+ */ validateAgainstSchema(value, schema, path) {
335
+ const errors = [];
336
+ // Type validation
337
+ const actualType = Array.isArray(value) ? 'array' : typeof value;
338
+ if (schema.type && actualType !== schema.type) {
339
+ errors.push({
340
+ type: 'schema',
341
+ severity: 'critical',
342
+ message: `Type mismatch at ${path}`,
343
+ path,
344
+ expected: schema.type,
345
+ actual: actualType
346
+ });
347
+ return errors;
348
+ }
349
+ // Format validation
350
+ if (schema.format && typeof value === 'string') {
351
+ // Add format validation logic
352
+ }
353
+ // Pattern validation
354
+ if (schema.pattern && typeof value === 'string') {
355
+ const regex = new RegExp(schema.pattern);
356
+ if (!regex.test(value)) {
357
+ errors.push({
358
+ type: 'schema',
359
+ severity: 'high',
360
+ message: `Value does not match pattern at ${path}`,
361
+ path,
362
+ expected: schema.pattern,
363
+ actual: value
364
+ });
365
+ }
366
+ }
367
+ // Range validation
368
+ if (typeof value === 'number') {
369
+ if (schema.minimum !== undefined && value < schema.minimum) {
370
+ errors.push({
371
+ type: 'schema',
372
+ severity: 'high',
373
+ message: `Value below minimum at ${path}`,
374
+ path,
375
+ expected: `>= ${schema.minimum}`,
376
+ actual: value
377
+ });
378
+ }
379
+ if (schema.maximum !== undefined && value > schema.maximum) {
380
+ errors.push({
381
+ type: 'schema',
382
+ severity: 'high',
383
+ message: `Value above maximum at ${path}`,
384
+ path,
385
+ expected: `<= ${schema.maximum}`,
386
+ actual: value
387
+ });
388
+ }
389
+ }
390
+ // Enum validation
391
+ if (schema.enum && !schema.enum.includes(value)) {
392
+ errors.push({
393
+ type: 'schema',
394
+ severity: 'high',
395
+ message: `Value not in enum at ${path}`,
396
+ path,
397
+ expected: schema.enum,
398
+ actual: value
399
+ });
400
+ }
401
+ // Object validation
402
+ if (schema.type === 'object' && schema.properties) {
403
+ // Check required properties
404
+ if (schema.required) {
405
+ schema.required.forEach((requiredProp)=>{
406
+ if (value[requiredProp] === undefined) {
407
+ errors.push({
408
+ type: 'schema',
409
+ severity: 'critical',
410
+ message: `Missing required property: ${requiredProp}`,
411
+ path: `${path}.${requiredProp}`
412
+ });
413
+ }
414
+ });
415
+ }
416
+ // Validate properties
417
+ schema.properties.forEach((propSchema, propName)=>{
418
+ if (value[propName] !== undefined) {
419
+ const propErrors = this.validateAgainstSchema(value[propName], propSchema, `${path}.${propName}`);
420
+ errors.push(...propErrors);
421
+ }
422
+ });
423
+ }
424
+ // Array validation
425
+ if (schema.type === 'array' && schema.items && Array.isArray(value)) {
426
+ value.forEach((item, index)=>{
427
+ const itemErrors = this.validateAgainstSchema(item, schema.items, `${path}[${index}]`);
428
+ errors.push(...itemErrors);
429
+ });
430
+ }
431
+ return errors;
432
+ }
433
+ /**
434
+ * Check for deprecated fields
435
+ */ checkDeprecations(endpoint, request) {
436
+ const warnings = [];
437
+ endpoint.parameters.filter((p)=>p.deprecated).forEach((param)=>{
438
+ if (request.params?.[param.name] || request.query?.[param.name]) {
439
+ warnings.push({
440
+ type: 'deprecation',
441
+ message: `Parameter ${param.name} is deprecated`,
442
+ recommendation: param.description
443
+ });
444
+ }
445
+ });
446
+ return warnings;
447
+ }
448
+ /**
449
+ * Compare two endpoints
450
+ */ compareEndpoints(oldEndpoint, newEndpoint) {
451
+ const diff = {
452
+ breaking: [],
453
+ nonBreaking: [],
454
+ additions: []
455
+ };
456
+ // Compare parameters
457
+ const oldParams = new Map(oldEndpoint.parameters.map((p)=>[
458
+ p.name,
459
+ p
460
+ ]));
461
+ const newParams = new Map(newEndpoint.parameters.map((p)=>[
462
+ p.name,
463
+ p
464
+ ]));
465
+ // Check for removed parameters (breaking)
466
+ oldParams.forEach((oldParam, name)=>{
467
+ if (!newParams.has(name) && oldParam.required) {
468
+ diff.breaking.push({
469
+ type: 'removed-field',
470
+ endpoint: `${oldEndpoint.method} ${oldEndpoint.path}`,
471
+ path: `parameters.${name}`,
472
+ oldValue: oldParam,
473
+ newValue: null,
474
+ impact: 'high'
475
+ });
476
+ }
477
+ });
478
+ // Check for new required parameters (breaking)
479
+ newParams.forEach((newParam, name)=>{
480
+ if (!oldParams.has(name) && newParam.required) {
481
+ diff.breaking.push({
482
+ type: 'required-added',
483
+ endpoint: `${newEndpoint.method} ${newEndpoint.path}`,
484
+ path: `parameters.${name}`,
485
+ oldValue: null,
486
+ newValue: newParam,
487
+ impact: 'medium'
488
+ });
489
+ }
490
+ });
491
+ return diff;
492
+ }
493
+ /**
494
+ * Generate OpenAPI paths
495
+ */ generatePaths(contract) {
496
+ const paths = {};
497
+ contract.endpoints.forEach((endpoint)=>{
498
+ if (!paths[endpoint.path]) {
499
+ paths[endpoint.path] = {};
500
+ }
501
+ paths[endpoint.path][endpoint.method.toLowerCase()] = {
502
+ operationId: endpoint.operationId,
503
+ summary: endpoint.summary,
504
+ description: endpoint.description,
505
+ parameters: this.generatePathParameters(endpoint.parameters),
506
+ requestBody: endpoint.requestBody ? this.generateRequestBody(endpoint.requestBody) : undefined,
507
+ responses: this.generateResponses(endpoint.responses),
508
+ security: endpoint.security,
509
+ tags: endpoint.tags
510
+ };
511
+ });
512
+ return paths;
513
+ }
514
+ generatePathParameters(parameters) {
515
+ return parameters.map((param)=>({
516
+ name: param.name,
517
+ in: param.in,
518
+ required: param.required,
519
+ description: param.description,
520
+ deprecated: param.deprecated,
521
+ schema: this.schemaToOpenAPI(param.schema)
522
+ }));
523
+ }
524
+ generateRequestBody(requestBody) {
525
+ const content = {};
526
+ requestBody.content.forEach((mediaType, contentType)=>{
527
+ content[contentType] = {
528
+ schema: this.schemaToOpenAPI(mediaType.schema),
529
+ examples: mediaType.examples
530
+ };
531
+ });
532
+ return {
533
+ required: requestBody.required,
534
+ description: requestBody.description,
535
+ content
536
+ };
537
+ }
538
+ generateResponses(responses) {
539
+ const openAPIResponses = {};
540
+ responses.forEach((response, statusCode)=>{
541
+ const content = {};
542
+ if (response.content) {
543
+ response.content.forEach((mediaType, contentType)=>{
544
+ content[contentType] = {
545
+ schema: this.schemaToOpenAPI(mediaType.schema),
546
+ examples: mediaType.examples
547
+ };
548
+ });
549
+ }
550
+ openAPIResponses[statusCode] = {
551
+ description: response.description,
552
+ content: Object.keys(content).length > 0 ? content : undefined
553
+ };
554
+ });
555
+ return openAPIResponses;
556
+ }
557
+ generateSchemas(schemas) {
558
+ const openAPISchemas = {};
559
+ schemas.forEach((schema, name)=>{
560
+ openAPISchemas[name] = this.schemaToOpenAPI(schema);
561
+ });
562
+ return openAPISchemas;
563
+ }
564
+ generateSecuritySchemes(securitySchemes) {
565
+ if (!securitySchemes) return undefined;
566
+ const schemes = {};
567
+ securitySchemes.forEach((scheme, index)=>{
568
+ schemes[`scheme${index}`] = scheme;
569
+ });
570
+ return schemes;
571
+ }
572
+ schemaToOpenAPI(schema) {
573
+ const openAPISchema = {
574
+ type: schema.type
575
+ };
576
+ if (schema.properties) {
577
+ openAPISchema.properties = {};
578
+ schema.properties.forEach((propSchema, propName)=>{
579
+ openAPISchema.properties[propName] = this.schemaToOpenAPI(propSchema);
580
+ });
581
+ }
582
+ if (schema.required) {
583
+ openAPISchema.required = schema.required;
584
+ }
585
+ if (schema.items) {
586
+ openAPISchema.items = this.schemaToOpenAPI(schema.items);
587
+ }
588
+ if (schema.format) openAPISchema.format = schema.format;
589
+ if (schema.pattern) openAPISchema.pattern = schema.pattern;
590
+ if (schema.minimum !== undefined) openAPISchema.minimum = schema.minimum;
591
+ if (schema.maximum !== undefined) openAPISchema.maximum = schema.maximum;
592
+ if (schema.enum) openAPISchema.enum = schema.enum;
593
+ if (schema.additionalProperties !== undefined) {
594
+ openAPISchema.additionalProperties = typeof schema.additionalProperties === 'boolean' ? schema.additionalProperties : this.schemaToOpenAPI(schema.additionalProperties);
595
+ }
596
+ return openAPISchema;
597
+ }
598
+ /**
599
+ * Get validation statistics
600
+ */ getValidationStats() {
601
+ const total = this.validationHistory.length;
602
+ const successful = this.validationHistory.filter((v)=>v.valid).length;
603
+ return {
604
+ totalValidations: total,
605
+ successfulValidations: successful,
606
+ failedValidations: total - successful,
607
+ successRate: total > 0 ? successful / total : 0
608
+ };
609
+ }
610
+ }
611
+
612
+ //# sourceMappingURL=api-contract-validator.js.map