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.
- package/.claude/agents/analysis/code-analyzer.md +3 -20
- package/.claude/agents/analysis/code-review/analyze-code-quality.md +1 -1
- package/.claude/agents/analyst.md +208 -550
- package/.claude/agents/architect.md +136 -469
- package/.claude/agents/architecture/system-architect.md +20 -1
- package/.claude/agents/architecture/system-design/arch-system-design.md +1 -1
- package/.claude/agents/base-template-generator.md +24 -1
- package/.claude/agents/coder.md +87 -303
- package/.claude/agents/consensus/byzantine-coordinator.md +4 -21
- package/.claude/agents/consensus/consensus-builder.md +3 -20
- package/.claude/agents/consensus/crdt-synchronizer.md +4 -21
- package/.claude/agents/consensus/gossip-coordinator.md +4 -21
- package/.claude/agents/consensus/performance-benchmarker.md +4 -21
- package/.claude/agents/consensus/quorum-manager.md +4 -21
- package/.claude/agents/consensus/raft-manager.md +4 -21
- package/.claude/agents/consensus/security-manager.md +4 -21
- package/.claude/agents/coordinator.md +22 -11
- package/.claude/agents/data/ml/data-ml-model.md +2 -2
- package/.claude/agents/development/backend/dev-backend-api.md +2 -2
- package/.claude/agents/devops/ci-cd/ops-cicd-github.md +2 -2
- package/.claude/agents/devops/devops-engineer.md +134 -402
- package/.claude/agents/documentation/api-docs/docs-api-openapi.md +2 -2
- package/.claude/agents/github/code-review-swarm.md +1 -1
- package/.claude/agents/github/github-specialist.md +856 -0
- package/.claude/agents/github/pr-manager.md +1 -1
- package/.claude/agents/github/release-manager.md +1 -1
- package/.claude/agents/neural/neural-pattern-agent.md +762 -0
- package/.claude/agents/optimization/benchmark-suite.md +1 -1
- package/.claude/agents/optimization/perf-analyzer.md +1 -1
- package/.claude/agents/optimization/performance-monitor.md +1 -1
- package/.claude/agents/planner.md +135 -0
- package/.claude/agents/researcher.md +22 -9
- package/.claude/agents/reviewer.md +291 -0
- package/.claude/agents/security/security-specialist.md +1 -1
- package/.claude/agents/sparc/architecture.md +1 -1
- package/.claude/agents/sparc/pseudocode.md +1 -1
- package/.claude/agents/sparc/refinement.md +1 -1
- package/.claude/agents/sparc/specification.md +1 -1
- package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +2 -2
- package/.claude/agents/tester.md +21 -11
- package/.claude/agents/testing/unit/tdd-london-swarm.md +1 -1
- package/.claude/agents/testing/validation/production-validator.md +1 -1
- package/.claude/commands/claude-soul.js +1 -1
- package/.claude/hooks.json +12 -15
- package/{.claude → .claude-flow-novice/.claude}/agents/MIGRATION_SUMMARY.md +1 -1
- package/.claude-flow-novice/.claude/agents/analysis/code-analyzer.md +192 -0
- package/.claude-flow-novice/.claude/agents/analysis/code-review/analyze-code-quality.md +180 -0
- package/.claude-flow-novice/.claude/agents/analyst.md +300 -0
- package/.claude-flow-novice/.claude/agents/architect.md +557 -0
- package/.claude-flow-novice/.claude/agents/architecture/system-architect.md +630 -0
- package/.claude-flow-novice/.claude/agents/architecture/system-design/arch-system-design.md +156 -0
- package/.claude-flow-novice/.claude/agents/base-template-generator.md +65 -0
- package/.claude-flow-novice/.claude/agents/coder.md +180 -0
- package/.claude-flow-novice/.claude/agents/consensus/byzantine-coordinator.md +46 -0
- package/.claude-flow-novice/.claude/agents/consensus/consensus-builder.md +225 -0
- package/.claude-flow-novice/.claude/agents/consensus/crdt-synchronizer.md +980 -0
- package/.claude-flow-novice/.claude/agents/consensus/gossip-coordinator.md +46 -0
- package/.claude-flow-novice/.claude/agents/consensus/performance-benchmarker.md +834 -0
- package/.claude-flow-novice/.claude/agents/consensus/quorum-manager.md +806 -0
- package/.claude-flow-novice/.claude/agents/consensus/raft-manager.md +46 -0
- package/.claude-flow-novice/.claude/agents/consensus/security-manager.md +605 -0
- package/.claude-flow-novice/.claude/agents/coordinator.md +842 -0
- package/.claude-flow-novice/.claude/agents/data/ml/data-ml-model.md +193 -0
- package/.claude-flow-novice/.claude/agents/development/backend/dev-backend-api.md +142 -0
- package/.claude-flow-novice/.claude/agents/devops/ci-cd/ops-cicd-github.md +164 -0
- package/.claude-flow-novice/.claude/agents/devops/devops-engineer.md +638 -0
- package/.claude-flow-novice/.claude/agents/documentation/api-docs/docs-api-openapi.md +174 -0
- package/.claude-flow-novice/.claude/agents/github/code-review-swarm.md +538 -0
- package/.claude-flow-novice/.claude/agents/github/github-modes.md +173 -0
- package/.claude-flow-novice/.claude/agents/github/github-specialist.md +856 -0
- package/.claude-flow-novice/.claude/agents/github/issue-tracker.md +319 -0
- package/.claude-flow-novice/.claude/agents/github/multi-repo-swarm.md +553 -0
- package/.claude-flow-novice/.claude/agents/github/pr-manager.md +191 -0
- package/.claude-flow-novice/.claude/agents/github/project-board-sync.md +509 -0
- package/.claude-flow-novice/.claude/agents/github/release-manager.md +367 -0
- package/.claude-flow-novice/.claude/agents/github/release-swarm.md +583 -0
- package/.claude-flow-novice/.claude/agents/github/repo-architect.md +398 -0
- package/.claude-flow-novice/.claude/agents/github/swarm-issue.md +573 -0
- package/.claude-flow-novice/.claude/agents/github/swarm-pr.md +428 -0
- package/.claude-flow-novice/.claude/agents/github/sync-coordinator.md +452 -0
- package/.claude-flow-novice/.claude/agents/github/workflow-automation.md +635 -0
- package/.claude-flow-novice/.claude/agents/goal/goal-planner.md +73 -0
- package/.claude-flow-novice/.claude/agents/neural/neural-pattern-agent.md +762 -0
- package/.claude-flow-novice/.claude/agents/neural/safla-neural.md +74 -0
- package/.claude-flow-novice/.claude/agents/optimization/benchmark-suite.md +665 -0
- package/.claude-flow-novice/.claude/agents/optimization/load-balancer.md +431 -0
- package/.claude-flow-novice/.claude/agents/optimization/perf-analyzer.md +725 -0
- package/.claude-flow-novice/.claude/agents/optimization/performance-monitor.md +672 -0
- package/.claude-flow-novice/.claude/agents/optimization/resource-allocator.md +674 -0
- package/.claude-flow-novice/.claude/agents/optimization/topology-optimizer.md +808 -0
- package/.claude-flow-novice/.claude/agents/planner.md +135 -0
- package/.claude-flow-novice/.claude/agents/researcher.md +185 -0
- package/.claude-flow-novice/.claude/agents/reviewer.md +291 -0
- package/.claude-flow-novice/.claude/agents/security/security-specialist.md +978 -0
- package/.claude-flow-novice/.claude/agents/sparc/architecture.md +472 -0
- package/.claude-flow-novice/.claude/agents/sparc/pseudocode.md +318 -0
- package/.claude-flow-novice/.claude/agents/sparc/refinement.md +525 -0
- package/.claude-flow-novice/.claude/agents/sparc/specification.md +276 -0
- package/.claude-flow-novice/.claude/agents/specialized/mobile/spec-mobile-react-native.md +226 -0
- package/.claude-flow-novice/.claude/agents/sublinear/consciousness-evolution-agent.md +499 -0
- package/.claude-flow-novice/.claude/agents/sublinear/matrix-solver-agent.md +113 -0
- package/.claude-flow-novice/.claude/agents/sublinear/nanosecond-scheduler-agent.md +644 -0
- package/.claude-flow-novice/.claude/agents/sublinear/pagerank-agent.md +699 -0
- package/.claude-flow-novice/.claude/agents/sublinear/phi-calculator-agent.md +749 -0
- package/.claude-flow-novice/.claude/agents/sublinear/psycho-symbolic-agent.md +543 -0
- package/.claude-flow-novice/.claude/agents/sublinear/sublinear.md +816 -0
- package/.claude-flow-novice/.claude/agents/sublinear/temporal-advantage-agent.md +360 -0
- package/.claude-flow-novice/.claude/agents/swarm/adaptive-coordinator-enhanced.md +746 -0
- package/.claude-flow-novice/.claude/agents/swarm/adaptive-coordinator.md +396 -0
- package/.claude-flow-novice/.claude/agents/swarm/hierarchical-coordinator.md +300 -0
- package/.claude-flow-novice/.claude/agents/swarm/mesh-coordinator.md +435 -0
- package/.claude-flow-novice/.claude/agents/templates/automation-smart-agent.md +205 -0
- package/.claude-flow-novice/.claude/agents/templates/coordinator-swarm-init.md +90 -0
- package/.claude-flow-novice/.claude/agents/templates/github-pr-manager.md +177 -0
- package/.claude-flow-novice/.claude/agents/templates/implementer-sparc-coder.md +259 -0
- package/.claude-flow-novice/.claude/agents/templates/memory-coordinator.md +187 -0
- package/.claude-flow-novice/.claude/agents/templates/migration-plan.md +746 -0
- package/.claude-flow-novice/.claude/agents/templates/orchestrator-task.md +139 -0
- package/.claude-flow-novice/.claude/agents/templates/performance-analyzer.md +199 -0
- package/.claude-flow-novice/.claude/agents/templates/sparc-coordinator.md +183 -0
- package/.claude-flow-novice/.claude/agents/tester.md +663 -0
- package/.claude-flow-novice/.claude/agents/testing/e2e/playwright-agent.md +249 -0
- package/.claude-flow-novice/.claude/agents/testing/unit/tdd-london-swarm.md +244 -0
- package/.claude-flow-novice/.claude/agents/testing/validation/production-validator.md +395 -0
- package/.claude-flow-novice/dist/index.js +12 -24
- package/.claude-flow-novice/dist/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/agents/agent-manager.js +123 -69
- package/.claude-flow-novice/dist/src/agents/agent-manager.js.map +1 -1
- package/.claude-flow-novice/dist/src/agents/github/utils/hook-integration.js +7 -7
- package/.claude-flow-novice/dist/src/agents/github/utils/hook-integration.js.map +1 -1
- package/.claude-flow-novice/dist/src/agents/stage3-integration-validator.js +485 -0
- package/.claude-flow-novice/dist/src/agents/stage3-integration-validator.js.map +1 -0
- package/.claude-flow-novice/dist/src/agents/unified-ultra-fast-agent-manager.js +630 -0
- package/.claude-flow-novice/dist/src/agents/unified-ultra-fast-agent-manager.js.map +1 -0
- package/.claude-flow-novice/dist/src/cli/commands/agent.js +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/agent.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/config-integration.js +6 -6
- package/.claude-flow-novice/dist/src/cli/commands/enterprise.js +18 -18
- package/.claude-flow-novice/dist/src/cli/commands/enterprise.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/goal-init.js +4 -4
- package/.claude-flow-novice/dist/src/cli/commands/help-new.js +23 -23
- package/.claude-flow-novice/dist/src/cli/commands/help-new.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/help.js +74 -74
- package/.claude-flow-novice/dist/src/cli/commands/help.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/hive-mind/pause.js +2 -2
- package/.claude-flow-novice/dist/src/cli/commands/hive-mind/pause.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/hive.js +4 -4
- package/.claude-flow-novice/dist/src/cli/commands/index.js +103 -132
- package/.claude-flow-novice/dist/src/cli/commands/index.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/mcp.js +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/migrate.js +4 -4
- package/.claude-flow-novice/dist/src/cli/commands/migrate.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/monitor.js +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/neural-init.js +4 -4
- package/.claude-flow-novice/dist/src/cli/commands/ruv-swarm.js +8 -8
- package/.claude-flow-novice/dist/src/cli/commands/sparc.js +12 -12
- package/.claude-flow-novice/dist/src/cli/commands/sparc.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/start/start-command.js +3 -3
- package/.claude-flow-novice/dist/src/cli/commands/status.js +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/swarm.js +7 -7
- package/.claude-flow-novice/dist/src/cli/commands/swarm.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/commands/verification.js +18 -18
- package/.claude-flow-novice/dist/src/cli/completion.js +54 -54
- package/.claude-flow-novice/dist/src/cli/completion.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/consolidated/ConsolidatedCLI.js +11 -11
- package/.claude-flow-novice/dist/src/cli/consolidated/ConsolidatedCLI.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/consolidated/core/CommandHandlers.js +31 -31
- package/.claude-flow-novice/dist/src/cli/consolidated/core/TierManager.js +39 -39
- package/.claude-flow-novice/dist/src/cli/consolidated/core/TierManager.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/consolidated/help/InteractiveHelp.js +25 -25
- package/.claude-flow-novice/dist/src/cli/consolidated/help/InteractiveHelp.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/consolidated/routing/CommandRouter.js +8 -8
- package/.claude-flow-novice/dist/src/cli/consolidated/routing/CommandRouter.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/consolidated/utils/IntelligentDefaults.js +6 -6
- package/.claude-flow-novice/dist/src/cli/consolidated/utils/IntelligentDefaults.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/consolidated/utils/PerformanceOptimizer.js +7 -7
- package/.claude-flow-novice/dist/src/cli/consolidated/utils/PerformanceOptimizer.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/index-remote.js +10 -10
- package/.claude-flow-novice/dist/src/cli/index.js +1 -1
- package/.claude-flow-novice/dist/src/cli/init/directory-structure.js +8 -8
- package/.claude-flow-novice/dist/src/cli/init/index.js +3 -3
- package/.claude-flow-novice/dist/src/cli/init/sparc-environment.js +67 -67
- package/.claude-flow-novice/dist/src/cli/init/swarm-commands.js +18 -18
- package/.claude-flow-novice/dist/src/cli/node-repl.js +2 -2
- package/.claude-flow-novice/dist/src/cli/repl.js +1 -1
- package/.claude-flow-novice/dist/src/cli/simple-cli.js +68 -68
- package/.claude-flow-novice/dist/src/cli/simple-cli.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/simple-commands/session-start-soul.js +271 -0
- package/.claude-flow-novice/dist/src/cli/simple-orchestrator.js +7 -7
- package/.claude-flow-novice/dist/src/cli/simple-orchestrator.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/ui/fallback-handler.js +7 -7
- package/.claude-flow-novice/dist/src/communication/enhanced-event-bus.js +816 -0
- package/.claude-flow-novice/dist/src/communication/enhanced-event-bus.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/failure-recovery-system.js +812 -0
- package/.claude-flow-novice/dist/src/communication/failure-recovery-system.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/optimized-serialization.js +369 -0
- package/.claude-flow-novice/dist/src/communication/optimized-serialization.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/performance-optimizations.js +526 -0
- package/.claude-flow-novice/dist/src/communication/performance-optimizations.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/performance-validator.js +532 -0
- package/.claude-flow-novice/dist/src/communication/performance-validator.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/priority-message-queue.js +525 -0
- package/.claude-flow-novice/dist/src/communication/priority-message-queue.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/shared-buffer-bus.js +218 -0
- package/.claude-flow-novice/dist/src/communication/shared-buffer-bus.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/ultra-fast-communication-bus.js +521 -0
- package/.claude-flow-novice/dist/src/communication/ultra-fast-communication-bus.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/ultra-fast-serialization.js +563 -0
- package/.claude-flow-novice/dist/src/communication/ultra-fast-serialization.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/websocket-cluster.js +344 -0
- package/.claude-flow-novice/dist/src/communication/websocket-cluster.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/zero-copy-structures.js +369 -0
- package/.claude-flow-novice/dist/src/communication/zero-copy-structures.js.map +1 -0
- package/.claude-flow-novice/dist/src/config/config-manager.js +1 -1
- package/.claude-flow-novice/dist/src/config/config-manager.js.map +1 -1
- package/.claude-flow-novice/dist/src/config/core/intelligent-configuration-manager.js +1 -1
- package/.claude-flow-novice/dist/src/config/integration/hooks-integration.js +6 -6
- package/.claude-flow-novice/dist/src/config/integration/hooks-integration.js.map +1 -1
- package/.claude-flow-novice/dist/src/config/migration/config-migration.js +1 -1
- package/.claude-flow-novice/dist/src/config/ruv-swarm-integration.js +1 -1
- package/.claude-flow-novice/dist/src/config/utils/zero-config-setup.js +1 -1
- package/.claude-flow-novice/dist/src/config/utils/zero-config-setup.js.map +1 -1
- package/.claude-flow-novice/dist/src/config/web-portal-config.js +0 -9
- package/.claude-flow-novice/dist/src/config/web-portal-config.js.map +1 -1
- package/.claude-flow-novice/dist/src/config/zero-config-setup.js +18 -18
- package/.claude-flow-novice/dist/src/config/zero-config-setup.js.map +1 -1
- package/.claude-flow-novice/dist/src/core/logger.js +33 -10
- package/.claude-flow-novice/dist/src/core/logger.js.map +1 -1
- package/.claude-flow-novice/dist/src/migration/index.js +1 -1
- package/.claude-flow-novice/dist/src/migration/index.js.map +1 -1
- package/.claude-flow-novice/dist/src/migration/migration-runner.js +4 -4
- package/.claude-flow-novice/dist/src/migration/migration-runner.js.map +1 -1
- package/.claude-flow-novice/dist/src/monitoring/agent-health-monitor.js +430 -0
- package/.claude-flow-novice/dist/src/monitoring/agent-health-monitor.js.map +1 -0
- package/.claude-flow-novice/dist/src/slash-commands/claude-soul.js +248 -365
- package/.claude-flow-novice/dist/src/slash-commands/register-all-commands.js +1 -1
- package/.claude-flow-novice/dist/src/swarm/claude-code-interface.js +1 -1
- package/.claude-flow-novice/dist/src/swarm/claude-flow-executor.js +1 -1
- package/.claude-flow-novice/dist/src/swarm/consensus-coordinator.js +471 -0
- package/.claude-flow-novice/dist/src/swarm/consensus-coordinator.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm/hive-mind-integration.js +1 -1
- package/.claude-flow-novice/dist/src/swarm/large-scale-coordinator.js +543 -0
- package/.claude-flow-novice/dist/src/swarm/large-scale-coordinator.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm/optimizations/connection-pool.js +1 -1
- package/.claude-flow-novice/dist/src/swarm/optimizations/optimized-executor.js +1 -1
- package/.claude-flow-novice/dist/src/swarm/types.js.map +1 -1
- package/.claude-flow-novice/dist/src/swarm-fullstack/integrations/communication-bridge.js +709 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/integrations/communication-bridge.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/testing/api-contract-validator.js +612 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/testing/api-contract-validator.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/testing/backend-test-orchestrator.js +679 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/testing/backend-test-orchestrator.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/testing/frontend-test-orchestrator.js +654 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/testing/frontend-test-orchestrator.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/testing/visual-regression.js +402 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/testing/visual-regression.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/convergence-detector.js +459 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/convergence-detector.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/fix-coordinator.js +513 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/fix-coordinator.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/index.js +19 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/iterative-build-test.js +568 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/iterative-build-test.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/regression-test-manager.js +418 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/regression-test-manager.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/test-result-analyzer.js +530 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/test-result-analyzer.js.map +1 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/workflow-metrics.js +250 -0
- package/.claude-flow-novice/dist/src/swarm-fullstack/workflows/workflow-metrics.js.map +1 -0
- package/.claude-flow-novice/dist/src/task/index.js +7 -7
- package/.claude-flow-novice/dist/src/validation/fullstack-integration-validator.js +420 -0
- package/.claude-flow-novice/dist/src/validation/fullstack-integration-validator.js.map +1 -0
- package/.claude-flow-novice/dist/src/validation/production-validator.js +1435 -0
- package/.claude-flow-novice/dist/src/validation/production-validator.js.map +1 -0
- package/.claude-flow-novice/dist/src/verification/cli-integration.js +3 -3
- package/.claude-flow-novice/dist/src/verification/hooks.js +1 -1
- package/CHANGELOG.md +13 -0
- package/CLAUDE.md +1029 -68
- package/README.md +0 -1
- package/config/build/babel.config.cjs +19 -11
- package/config/typescript/tsconfig.json +1 -1
- package/examples/claude-api-error-handling.ts +2 -2
- package/examples/frontend-testing-demo.ts +470 -0
- package/examples/litellm/config/config.yaml +1 -1
- package/package.json +13 -7
- package/scripts/build/unified-builder.sh +6 -6
- package/scripts/build/validate-agents.js +238 -0
- package/scripts/run-production-validation.ts +590 -0
- package/scripts/test/test-coordination-features.ts +2 -2
- package/scripts/validate-stage3-performance.ts +377 -0
- package/src/cli/simple-commands/hooks.js +1 -0
- package/src/cli/simple-commands/init/agent-copier.js +0 -2
- package/src/cli/simple-commands/init/index.js +5 -97
- package/src/cli/simple-commands/init/templates/CLAUDE.md +162 -1158
- package/src/cli/simple-commands/init/templates/claude-md.js +38 -157
- package/src/swarm-fullstack/integrations/communication-bridge.ts +931 -0
- package/src/swarm-fullstack/testing/api-contract-validator.ts +909 -0
- package/src/swarm-fullstack/testing/backend-test-orchestrator.ts +791 -0
- package/src/swarm-fullstack/testing/frontend-test-orchestrator.ts +853 -0
- package/src/swarm-fullstack/testing/visual-regression.ts +507 -0
- package/src/swarm-fullstack/workflows/convergence-detector.ts +736 -0
- package/src/swarm-fullstack/workflows/fix-coordinator.ts +677 -0
- package/src/swarm-fullstack/workflows/index.ts +75 -0
- package/src/swarm-fullstack/workflows/iterative-build-test.ts +829 -0
- package/src/swarm-fullstack/workflows/regression-test-manager.ts +590 -0
- package/src/swarm-fullstack/workflows/test-result-analyzer.ts +739 -0
- package/src/swarm-fullstack/workflows/workflow-metrics.ts +399 -0
- package/wiki/command-reference/README.md +1 -2
- package/wiki/command-reference/mcp-tools/README.md +1 -1
- package/wiki/getting-started/claude-code-mcp/README.md +1 -2
- package/wiki/getting-started/installation/README.md +2 -10
- package/.claude/commands/flow-nexus/app-store.md +0 -124
- package/.claude/commands/flow-nexus/challenges.md +0 -120
- package/.claude/commands/flow-nexus/login-registration.md +0 -65
- package/.claude/commands/flow-nexus/neural-network.md +0 -134
- package/.claude/commands/flow-nexus/payments.md +0 -116
- package/.claude/commands/flow-nexus/sandbox.md +0 -83
- package/.claude/commands/flow-nexus/swarm.md +0 -87
- package/.claude/commands/flow-nexus/user-tools.md +0 -152
- package/.claude/commands/flow-nexus/workflow.md +0 -115
- package/.claude-flow-novice/dist/cli/index.js +0 -45
- package/.claude-flow-novice/dist/core/index.js +0 -22
- package/.claude-flow-novice/dist/mcp/mcp-server-novice.js +0 -595
- package/.claude-flow-novice/dist/mcp/mcp-server-sdk.js +0 -649
- package/.claude-flow-novice/dist/mcp/mcp-server-with-slash-commands.js +0 -776
- package/.claude-flow-novice/dist/src/cli/simple-commands/init/templates/claude-md.js +0 -1101
- package/src/cli/simple-commands/init/templates/CLAUDE.md.optimized +0 -265
- /package/{.claude → .claude-flow-novice/.claude}/agents/README.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/backend-dev.json +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/code-analyzer.json +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/coder.json +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/consensus/README.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/core/coder.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/core/planner.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/core/researcher.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/core/reviewer.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/core/tester.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/optimization/README.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/planner.json +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/researcher.json +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/reviewer.json +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/swarm/README.md +0 -0
- /package/{.claude → .claude-flow-novice/.claude}/agents/system-architect.json +0 -0
- /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
|