claude-flow 3.28.0 → 3.29.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/MIGRATION_SUMMARY.md +221 -221
- package/.claude/agents/analysis/analyze-code-quality.md +57 -57
- package/.claude/agents/analysis/code-analyzer.md +188 -188
- package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
- package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
- package/.claude/agents/base-template-generator.md +41 -41
- package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
- package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
- package/.claude/agents/consensus/gossip-coordinator.md +42 -42
- package/.claude/agents/consensus/performance-benchmarker.md +830 -830
- package/.claude/agents/consensus/quorum-manager.md +802 -802
- package/.claude/agents/consensus/raft-manager.md +42 -42
- package/.claude/agents/consensus/security-manager.md +601 -601
- package/.claude/agents/core/coder.md +254 -254
- package/.claude/agents/core/planner.md +151 -151
- package/.claude/agents/core/researcher.md +173 -173
- package/.claude/agents/core/reviewer.md +308 -308
- package/.claude/agents/core/tester.md +299 -299
- package/.claude/agents/custom/test-long-runner.md +43 -43
- package/.claude/agents/data/ml/data-ml-model.md +75 -75
- package/.claude/agents/database-specialist.md +9 -9
- package/.claude/agents/development/backend/dev-backend-api.md +28 -28
- package/.claude/agents/development/dev-backend-api.md +177 -177
- package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
- package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
- package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
- package/.claude/agents/dual-mode/codex-worker.md +190 -190
- package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
- package/.claude/agents/flow-nexus/app-store.md +87 -87
- package/.claude/agents/flow-nexus/authentication.md +68 -68
- package/.claude/agents/flow-nexus/challenges.md +80 -80
- package/.claude/agents/flow-nexus/neural-network.md +87 -87
- package/.claude/agents/flow-nexus/payments.md +82 -82
- package/.claude/agents/flow-nexus/sandbox.md +75 -75
- package/.claude/agents/flow-nexus/swarm.md +75 -75
- package/.claude/agents/flow-nexus/user-tools.md +95 -95
- package/.claude/agents/flow-nexus/workflow.md +83 -83
- package/.claude/agents/github/code-review-swarm.md +520 -520
- package/.claude/agents/github/github-modes.md +153 -153
- package/.claude/agents/github/issue-tracker.md +298 -298
- package/.claude/agents/github/multi-repo-swarm.md +524 -524
- package/.claude/agents/github/pr-manager.md +162 -162
- package/.claude/agents/github/project-board-sync.md +477 -477
- package/.claude/agents/github/release-manager.md +337 -337
- package/.claude/agents/github/release-swarm.md +550 -550
- package/.claude/agents/github/repo-architect.md +364 -364
- package/.claude/agents/github/swarm-issue.md +550 -550
- package/.claude/agents/github/swarm-pr.md +401 -401
- package/.claude/agents/github/sync-coordinator.md +424 -424
- package/.claude/agents/github/workflow-automation.md +604 -604
- package/.claude/agents/goal/agent.md +816 -816
- package/.claude/agents/goal/code-goal-planner.md +444 -444
- package/.claude/agents/goal/goal-planner.md +167 -167
- package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
- package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
- package/.claude/agents/hive-mind/scout-explorer.md +240 -240
- package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
- package/.claude/agents/hive-mind/worker-specialist.md +215 -215
- package/.claude/agents/neural/safla-neural.md +73 -73
- package/.claude/agents/optimization/benchmark-suite.md +662 -662
- package/.claude/agents/optimization/load-balancer.md +428 -428
- package/.claude/agents/optimization/performance-monitor.md +669 -669
- package/.claude/agents/optimization/resource-allocator.md +671 -671
- package/.claude/agents/optimization/topology-optimizer.md +805 -805
- package/.claude/agents/payments/agentic-payments.md +126 -126
- package/.claude/agents/project-coordinator.md +8 -8
- package/.claude/agents/python-specialist.md +9 -9
- package/.claude/agents/reasoning/agent.md +816 -816
- package/.claude/agents/reasoning/goal-planner.md +72 -72
- package/.claude/agents/security-auditor.md +9 -9
- package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
- package/.claude/agents/sparc/architecture.md +452 -452
- package/.claude/agents/sparc/pseudocode.md +298 -298
- package/.claude/agents/sparc/refinement.md +503 -503
- package/.claude/agents/sparc/specification.md +257 -257
- package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
- package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
- package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
- package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
- package/.claude/agents/sublinear/performance-optimizer.md +367 -367
- package/.claude/agents/sublinear/trading-predictor.md +245 -245
- package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
- package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
- package/.claude/agents/swarm/mesh-coordinator.md +362 -362
- package/.claude/agents/templates/automation-smart-agent.md +184 -184
- package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
- package/.claude/agents/templates/github-pr-manager.md +154 -154
- package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
- package/.claude/agents/templates/memory-coordinator.md +162 -162
- package/.claude/agents/templates/migration-plan.md +723 -723
- package/.claude/agents/templates/orchestrator-task.md +119 -119
- package/.claude/agents/templates/performance-analyzer.md +178 -178
- package/.claude/agents/templates/sparc-coordinator.md +162 -162
- package/.claude/agents/testing/production-validator.md +372 -372
- package/.claude/agents/testing/tdd-london-swarm.md +221 -221
- package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
- package/.claude/agents/testing/validation/production-validator.md +372 -372
- package/.claude/agents/typescript-specialist.md +9 -9
- package/.claude/agents/v3/database-specialist.md +9 -9
- package/.claude/agents/v3/project-coordinator.md +8 -8
- package/.claude/agents/v3/python-specialist.md +9 -9
- package/.claude/agents/v3/test-architect.md +9 -9
- package/.claude/agents/v3/typescript-specialist.md +9 -9
- package/.claude/agents/v3/v3-integration-architect.md +311 -311
- package/.claude/agents/v3/v3-memory-specialist.md +280 -280
- package/.claude/agents/v3/v3-performance-engineer.md +362 -362
- package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
- package/.claude/agents/v3/v3-security-architect.md +139 -139
- package/.claude/checkpoints/1767754460.json +8 -8
- package/.claude/commands/agents/README.md +10 -10
- package/.claude/commands/agents/agent-capabilities.md +21 -21
- package/.claude/commands/agents/agent-coordination.md +28 -28
- package/.claude/commands/agents/agent-spawning.md +28 -28
- package/.claude/commands/agents/agent-types.md +26 -26
- package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
- package/.claude/commands/analysis/README.md +9 -9
- package/.claude/commands/analysis/bottleneck-detect.md +162 -162
- package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
- package/.claude/commands/analysis/performance-report.md +25 -25
- package/.claude/commands/analysis/token-efficiency.md +44 -44
- package/.claude/commands/analysis/token-usage.md +25 -25
- package/.claude/commands/automation/README.md +9 -9
- package/.claude/commands/automation/auto-agent.md +122 -122
- package/.claude/commands/automation/self-healing.md +105 -105
- package/.claude/commands/automation/session-memory.md +89 -89
- package/.claude/commands/automation/smart-agents.md +72 -72
- package/.claude/commands/automation/smart-spawn.md +25 -25
- package/.claude/commands/automation/workflow-select.md +25 -25
- package/.claude/commands/claude-flow-help.md +103 -103
- package/.claude/commands/claude-flow-memory.md +107 -107
- package/.claude/commands/claude-flow-swarm.md +205 -205
- package/.claude/commands/coordination/README.md +9 -9
- package/.claude/commands/coordination/agent-spawn.md +25 -25
- package/.claude/commands/coordination/init.md +44 -44
- package/.claude/commands/coordination/orchestrate.md +43 -43
- package/.claude/commands/coordination/spawn.md +45 -45
- package/.claude/commands/coordination/swarm-init.md +85 -85
- package/.claude/commands/coordination/task-orchestrate.md +25 -25
- package/.claude/commands/flow-nexus/app-store.md +123 -123
- package/.claude/commands/flow-nexus/challenges.md +119 -119
- package/.claude/commands/flow-nexus/login-registration.md +64 -64
- package/.claude/commands/flow-nexus/neural-network.md +133 -133
- package/.claude/commands/flow-nexus/payments.md +115 -115
- package/.claude/commands/flow-nexus/sandbox.md +82 -82
- package/.claude/commands/flow-nexus/swarm.md +86 -86
- package/.claude/commands/flow-nexus/user-tools.md +151 -151
- package/.claude/commands/flow-nexus/workflow.md +114 -114
- package/.claude/commands/github/README.md +11 -11
- package/.claude/commands/github/code-review-swarm.md +513 -513
- package/.claude/commands/github/code-review.md +25 -25
- package/.claude/commands/github/github-modes.md +146 -146
- package/.claude/commands/github/github-swarm.md +121 -121
- package/.claude/commands/github/issue-tracker.md +291 -291
- package/.claude/commands/github/issue-triage.md +25 -25
- package/.claude/commands/github/multi-repo-swarm.md +518 -518
- package/.claude/commands/github/pr-enhance.md +26 -26
- package/.claude/commands/github/pr-manager.md +169 -169
- package/.claude/commands/github/project-board-sync.md +470 -470
- package/.claude/commands/github/release-manager.md +337 -337
- package/.claude/commands/github/release-swarm.md +543 -543
- package/.claude/commands/github/repo-analyze.md +25 -25
- package/.claude/commands/github/repo-architect.md +366 -366
- package/.claude/commands/github/swarm-issue.md +481 -481
- package/.claude/commands/github/swarm-pr.md +284 -284
- package/.claude/commands/github/sync-coordinator.md +300 -300
- package/.claude/commands/github/workflow-automation.md +441 -441
- package/.claude/commands/hive-mind/README.md +17 -17
- package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
- package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
- package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
- package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
- package/.claude/commands/hive-mind/hive-mind.md +27 -27
- package/.claude/commands/hooks/README.md +11 -11
- package/.claude/commands/hooks/overview.md +57 -57
- package/.claude/commands/hooks/post-edit.md +117 -117
- package/.claude/commands/hooks/post-task.md +112 -112
- package/.claude/commands/hooks/pre-edit.md +113 -113
- package/.claude/commands/hooks/pre-task.md +111 -111
- package/.claude/commands/hooks/session-end.md +118 -118
- package/.claude/commands/hooks/setup.md +102 -102
- package/.claude/commands/memory/README.md +9 -9
- package/.claude/commands/memory/memory-persist.md +25 -25
- package/.claude/commands/memory/memory-search.md +25 -25
- package/.claude/commands/memory/memory-usage.md +25 -25
- package/.claude/commands/memory/neural.md +47 -47
- package/.claude/commands/monitoring/README.md +9 -9
- package/.claude/commands/monitoring/agent-metrics.md +25 -25
- package/.claude/commands/monitoring/agents.md +44 -44
- package/.claude/commands/monitoring/real-time-view.md +25 -25
- package/.claude/commands/monitoring/status.md +46 -46
- package/.claude/commands/monitoring/swarm-monitor.md +25 -25
- package/.claude/commands/optimization/README.md +9 -9
- package/.claude/commands/optimization/auto-topology.md +61 -61
- package/.claude/commands/optimization/cache-manage.md +25 -25
- package/.claude/commands/optimization/parallel-execute.md +25 -25
- package/.claude/commands/optimization/parallel-execution.md +49 -49
- package/.claude/commands/optimization/topology-optimize.md +25 -25
- package/.claude/commands/pair/README.md +260 -260
- package/.claude/commands/pair/commands.md +545 -545
- package/.claude/commands/pair/config.md +509 -509
- package/.claude/commands/pair/examples.md +511 -511
- package/.claude/commands/pair/modes.md +347 -347
- package/.claude/commands/pair/session.md +406 -406
- package/.claude/commands/pair/start.md +208 -208
- package/.claude/commands/sparc/analyzer.md +51 -51
- package/.claude/commands/sparc/architect.md +53 -53
- package/.claude/commands/sparc/ask.md +97 -97
- package/.claude/commands/sparc/batch-executor.md +54 -54
- package/.claude/commands/sparc/code.md +89 -89
- package/.claude/commands/sparc/coder.md +54 -54
- package/.claude/commands/sparc/debug.md +83 -83
- package/.claude/commands/sparc/debugger.md +54 -54
- package/.claude/commands/sparc/designer.md +53 -53
- package/.claude/commands/sparc/devops.md +109 -109
- package/.claude/commands/sparc/docs-writer.md +80 -80
- package/.claude/commands/sparc/documenter.md +54 -54
- package/.claude/commands/sparc/innovator.md +54 -54
- package/.claude/commands/sparc/integration.md +83 -83
- package/.claude/commands/sparc/mcp.md +117 -117
- package/.claude/commands/sparc/memory-manager.md +54 -54
- package/.claude/commands/sparc/optimizer.md +54 -54
- package/.claude/commands/sparc/orchestrator.md +131 -131
- package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
- package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
- package/.claude/commands/sparc/researcher.md +54 -54
- package/.claude/commands/sparc/reviewer.md +54 -54
- package/.claude/commands/sparc/security-review.md +80 -80
- package/.claude/commands/sparc/sparc-modes.md +174 -174
- package/.claude/commands/sparc/sparc.md +111 -111
- package/.claude/commands/sparc/spec-pseudocode.md +80 -80
- package/.claude/commands/sparc/supabase-admin.md +348 -348
- package/.claude/commands/sparc/swarm-coordinator.md +54 -54
- package/.claude/commands/sparc/tdd.md +54 -54
- package/.claude/commands/sparc/tester.md +54 -54
- package/.claude/commands/sparc/tutorial.md +79 -79
- package/.claude/commands/sparc/workflow-manager.md +54 -54
- package/.claude/commands/sparc.md +166 -166
- package/.claude/commands/stream-chain/pipeline.md +120 -120
- package/.claude/commands/stream-chain/run.md +69 -69
- package/.claude/commands/swarm/README.md +15 -15
- package/.claude/commands/swarm/analysis.md +95 -95
- package/.claude/commands/swarm/development.md +96 -96
- package/.claude/commands/swarm/examples.md +168 -168
- package/.claude/commands/swarm/maintenance.md +102 -102
- package/.claude/commands/swarm/optimization.md +117 -117
- package/.claude/commands/swarm/research.md +136 -136
- package/.claude/commands/swarm/swarm-analysis.md +8 -8
- package/.claude/commands/swarm/swarm-background.md +8 -8
- package/.claude/commands/swarm/swarm-init.md +19 -19
- package/.claude/commands/swarm/swarm-modes.md +8 -8
- package/.claude/commands/swarm/swarm-monitor.md +8 -8
- package/.claude/commands/swarm/swarm-spawn.md +19 -19
- package/.claude/commands/swarm/swarm-status.md +8 -8
- package/.claude/commands/swarm/swarm-strategies.md +8 -8
- package/.claude/commands/swarm/swarm.md +27 -27
- package/.claude/commands/swarm/testing.md +131 -131
- package/.claude/commands/training/README.md +9 -9
- package/.claude/commands/training/model-update.md +25 -25
- package/.claude/commands/training/neural-patterns.md +73 -73
- package/.claude/commands/training/neural-train.md +25 -25
- package/.claude/commands/training/pattern-learn.md +25 -25
- package/.claude/commands/training/specialization.md +62 -62
- package/.claude/commands/truth/start.md +142 -142
- package/.claude/commands/verify/check.md +49 -49
- package/.claude/commands/verify/start.md +127 -127
- package/.claude/commands/workflows/README.md +9 -9
- package/.claude/commands/workflows/development.md +77 -77
- package/.claude/commands/workflows/research.md +62 -62
- package/.claude/commands/workflows/workflow-create.md +25 -25
- package/.claude/commands/workflows/workflow-execute.md +25 -25
- package/.claude/commands/workflows/workflow-export.md +25 -25
- package/.claude/config/v3-dependency-optimization.json +265 -265
- package/.claude/config/v3-performance-targets.json +250 -250
- package/.claude/helpers/.helpers-version +1 -1
- package/.claude/helpers/README.md +96 -96
- package/.claude/helpers/adr-compliance.sh +186 -186
- package/.claude/helpers/aggressive-microcompact.mjs +36 -36
- package/.claude/helpers/auto-commit.sh +178 -178
- package/.claude/helpers/auto-memory-hook.mjs +430 -430
- package/.claude/helpers/checkpoint-manager.sh +251 -251
- package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
- package/.claude/helpers/daemon-manager.sh +252 -252
- package/.claude/helpers/ddd-tracker.sh +144 -144
- package/.claude/helpers/github-safe.js +156 -156
- package/.claude/helpers/github-setup.sh +45 -45
- package/.claude/helpers/guidance-hook.sh +13 -13
- package/.claude/helpers/guidance-hooks.sh +102 -102
- package/.claude/helpers/health-monitor.sh +108 -108
- package/.claude/helpers/helpers.manifest.json +6 -5
- package/.claude/helpers/hook-handler.cjs +460 -460
- package/.claude/helpers/intelligence.cjs +1058 -1058
- package/.claude/helpers/learning-hooks.sh +329 -329
- package/.claude/helpers/learning-optimizer.sh +127 -127
- package/.claude/helpers/learning-service.mjs +1144 -1144
- package/.claude/helpers/memory.cjs +84 -84
- package/.claude/helpers/metrics-db.mjs +503 -503
- package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
- package/.claude/helpers/pattern-consolidator.sh +86 -86
- package/.claude/helpers/perf-worker.sh +160 -160
- package/.claude/helpers/quick-start.sh +19 -19
- package/.claude/helpers/router.cjs +62 -62
- package/.claude/helpers/security-scanner.sh +127 -127
- package/.claude/helpers/session.cjs +125 -125
- package/.claude/helpers/setup-mcp.sh +18 -18
- package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
- package/.claude/helpers/statusline.cjs +925 -925
- package/.claude/helpers/swarm-comms.sh +353 -353
- package/.claude/helpers/swarm-hooks.sh +761 -761
- package/.claude/helpers/swarm-monitor.sh +210 -210
- package/.claude/helpers/sync-v3-metrics.sh +245 -245
- package/.claude/helpers/update-v3-progress.sh +165 -165
- package/.claude/helpers/v3-quick-status.sh +57 -57
- package/.claude/helpers/v3.sh +110 -110
- package/.claude/helpers/validate-v3-config.sh +215 -215
- package/.claude/helpers/worker-manager.sh +170 -170
- package/.claude/mcp.json +12 -12
- package/.claude/proven-config.json +1 -1
- package/.claude/settings.json +285 -285
- package/.claude/settings.json.bak +526 -526
- package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
- package/.claude/skills/agentdb-learning/SKILL.md +545 -545
- package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
- package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
- package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
- package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
- package/.claude/skills/browser/SKILL.md +204 -204
- package/.claude/skills/dual-mode/README.md +71 -71
- package/.claude/skills/dual-mode/dual-collect.md +103 -103
- package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
- package/.claude/skills/dual-mode/dual-spawn.md +81 -81
- package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
- package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
- package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
- package/.claude/skills/github-code-review/SKILL.md +1125 -1125
- package/.claude/skills/github-multi-repo/SKILL.md +862 -862
- package/.claude/skills/github-project-management/SKILL.md +1262 -1262
- package/.claude/skills/github-release-management/SKILL.md +1064 -1064
- package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
- package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
- package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
- package/.claude/skills/pair-programming/SKILL.md +1202 -1202
- package/.claude/skills/performance-analysis/SKILL.md +560 -560
- package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
- package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
- package/.claude/skills/skill-builder/SKILL.md +910 -910
- package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
- package/.claude/skills/stream-chain/SKILL.md +560 -560
- package/.claude/skills/swarm-advanced/SKILL.md +970 -970
- package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
- package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
- package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
- package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
- package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
- package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
- package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
- package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
- package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
- package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
- package/.claude/skills/verification-quality/SKILL.md +691 -691
- package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
- package/.claude/skills/worker-integration/SKILL.md +147 -147
- package/.claude/statusline-command.sh +176 -176
- package/.claude/statusline.mjs +109 -109
- package/.claude/statusline.sh +431 -431
- package/.claude/workflows/full-system-test.js +65 -65
- package/.claude/workflows/intelligence-system-hardening.js +120 -120
- package/.claude/workflows/plugin-contract-audit.js +91 -91
- package/.claude-plugin/README.md +720 -720
- package/.claude-plugin/docs/INSTALLATION.md +261 -261
- package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
- package/.claude-plugin/docs/QUICKSTART.md +361 -361
- package/.claude-plugin/docs/STRUCTURE.md +128 -128
- package/.claude-plugin/hooks/hooks.json +77 -77
- package/.claude-plugin/marketplace.json +185 -185
- package/.claude-plugin/plugin.json +71 -71
- package/.claude-plugin/scripts/install.sh +234 -234
- package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
- package/.claude-plugin/scripts/ruflo-hook.sh +37 -37
- package/.claude-plugin/scripts/uninstall.sh +36 -36
- package/.claude-plugin/scripts/verify.sh +108 -108
- package/LICENSE +21 -21
- package/README.md +419 -419
- package/bin/cli.js +11 -11
- package/bin/npx-repair.js +7 -7
- package/bin/npx-safe-launch.js +9 -9
- package/package.json +185 -185
- package/v3/@claude-flow/cli/README.md +419 -419
- package/v3/@claude-flow/cli/bin/cli.js +314 -314
- package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
- package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
- package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
- package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
- package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
- package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
- package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
- package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
- package/v3/@claude-flow/cli/dist/src/commands/funnel.d.ts +2 -0
- package/v3/@claude-flow/cli/dist/src/commands/funnel.js +110 -2
- package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
- package/v3/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
- package/v3/@claude-flow/cli/dist/src/commands/init.js +94 -38
- package/v3/@claude-flow/cli/dist/src/commands/memory.js +85 -1
- package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
- package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
- package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
- package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
- package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
- package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
- package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
- package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
- package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
- package/v3/@claude-flow/cli/dist/src/funnel/disclosure.d.ts +1 -0
- package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +12 -0
- package/v3/@claude-flow/cli/dist/src/funnel/index.d.ts +1 -1
- package/v3/@claude-flow/cli/dist/src/funnel/index.js +1 -1
- package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
- package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
- package/v3/@claude-flow/cli/dist/src/init/helper-signing.d.ts +8 -1
- package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +9 -2
- package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
- package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +949 -949
- package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
- package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
- package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
- package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +10 -0
- package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +139 -88
- package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +18 -0
- package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +539 -407
- package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
- package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
- package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.d.ts +195 -0
- package/v3/@claude-flow/cli/dist/src/ruvector/flash-attention.js +643 -0
- package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.d.ts +206 -0
- package/v3/@claude-flow/cli/dist/src/ruvector/moe-router.js +626 -0
- package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
- package/v3/@claude-flow/cli/dist/src/services/event-stream.d.ts +25 -0
- package/v3/@claude-flow/cli/dist/src/services/event-stream.js +27 -0
- package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
- package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.d.ts +16 -0
- package/v3/@claude-flow/cli/dist/src/services/loop-worker-runner.js +34 -0
- package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
- package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.d.ts +22 -0
- package/v3/@claude-flow/cli/dist/src/services/runtime-capabilities.js +45 -0
- package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
- package/v3/@claude-flow/cli/package.json +134 -133
- package/v3/@claude-flow/guidance/README.md +1195 -1195
- package/v3/@claude-flow/guidance/dist/adversarial.d.ts +284 -0
- package/v3/@claude-flow/guidance/dist/adversarial.js +572 -0
- package/v3/@claude-flow/guidance/dist/analyzer.d.ts +530 -0
- package/v3/@claude-flow/guidance/dist/analyzer.js +2587 -0
- package/v3/@claude-flow/guidance/dist/artifacts.d.ts +283 -0
- package/v3/@claude-flow/guidance/dist/artifacts.js +356 -0
- package/v3/@claude-flow/guidance/dist/authority.d.ts +290 -0
- package/v3/@claude-flow/guidance/dist/authority.js +558 -0
- package/v3/@claude-flow/guidance/dist/capabilities.d.ts +209 -0
- package/v3/@claude-flow/guidance/dist/capabilities.js +485 -0
- package/v3/@claude-flow/guidance/dist/coherence.d.ts +233 -0
- package/v3/@claude-flow/guidance/dist/coherence.js +372 -0
- package/v3/@claude-flow/guidance/dist/compiler.d.ts +87 -0
- package/v3/@claude-flow/guidance/dist/compiler.js +410 -0
- package/v3/@claude-flow/guidance/dist/conformance-kit.d.ts +225 -0
- package/v3/@claude-flow/guidance/dist/conformance-kit.js +629 -0
- package/v3/@claude-flow/guidance/dist/continue-gate.d.ts +214 -0
- package/v3/@claude-flow/guidance/dist/continue-gate.js +353 -0
- package/v3/@claude-flow/guidance/dist/crypto-utils.d.ts +17 -0
- package/v3/@claude-flow/guidance/dist/crypto-utils.js +24 -0
- package/v3/@claude-flow/guidance/dist/evolution.d.ts +282 -0
- package/v3/@claude-flow/guidance/dist/evolution.js +500 -0
- package/v3/@claude-flow/guidance/dist/gates.d.ts +79 -0
- package/v3/@claude-flow/guidance/dist/gates.js +302 -0
- package/v3/@claude-flow/guidance/dist/gateway.d.ts +206 -0
- package/v3/@claude-flow/guidance/dist/gateway.js +452 -0
- package/v3/@claude-flow/guidance/dist/generators.d.ts +153 -0
- package/v3/@claude-flow/guidance/dist/generators.js +682 -0
- package/v3/@claude-flow/guidance/dist/headless.d.ts +177 -0
- package/v3/@claude-flow/guidance/dist/headless.js +342 -0
- package/v3/@claude-flow/guidance/dist/hooks.d.ts +109 -0
- package/v3/@claude-flow/guidance/dist/hooks.js +347 -0
- package/v3/@claude-flow/guidance/dist/index.d.ts +205 -0
- package/v3/@claude-flow/guidance/dist/index.js +321 -0
- package/v3/@claude-flow/guidance/dist/ledger.d.ts +162 -0
- package/v3/@claude-flow/guidance/dist/ledger.js +375 -0
- package/v3/@claude-flow/guidance/dist/manifest-validator.d.ts +289 -0
- package/v3/@claude-flow/guidance/dist/manifest-validator.js +838 -0
- package/v3/@claude-flow/guidance/dist/memory-gate.d.ts +222 -0
- package/v3/@claude-flow/guidance/dist/memory-gate.js +382 -0
- package/v3/@claude-flow/guidance/dist/meta-governance.d.ts +265 -0
- package/v3/@claude-flow/guidance/dist/meta-governance.js +348 -0
- package/v3/@claude-flow/guidance/dist/optimizer.d.ts +104 -0
- package/v3/@claude-flow/guidance/dist/optimizer.js +329 -0
- package/v3/@claude-flow/guidance/dist/persistence.d.ts +189 -0
- package/v3/@claude-flow/guidance/dist/persistence.js +464 -0
- package/v3/@claude-flow/guidance/dist/proof.d.ts +185 -0
- package/v3/@claude-flow/guidance/dist/proof.js +238 -0
- package/v3/@claude-flow/guidance/dist/retriever.d.ts +172 -0
- package/v3/@claude-flow/guidance/dist/retriever.js +596 -0
- package/v3/@claude-flow/guidance/dist/ruvbot-integration.d.ts +370 -0
- package/v3/@claude-flow/guidance/dist/ruvbot-integration.js +738 -0
- package/v3/@claude-flow/guidance/dist/temporal.d.ts +426 -0
- package/v3/@claude-flow/guidance/dist/temporal.js +658 -0
- package/v3/@claude-flow/guidance/dist/trust.d.ts +283 -0
- package/v3/@claude-flow/guidance/dist/trust.js +473 -0
- package/v3/@claude-flow/guidance/dist/truth-anchors.d.ts +276 -0
- package/v3/@claude-flow/guidance/dist/truth-anchors.js +488 -0
- package/v3/@claude-flow/guidance/dist/types.d.ts +378 -0
- package/v3/@claude-flow/guidance/dist/types.js +10 -0
- package/v3/@claude-flow/guidance/dist/uncertainty.d.ts +372 -0
- package/v3/@claude-flow/guidance/dist/uncertainty.js +619 -0
- package/v3/@claude-flow/guidance/dist/wasm-kernel.d.ts +48 -0
- package/v3/@claude-flow/guidance/dist/wasm-kernel.js +158 -0
- package/v3/@claude-flow/guidance/package.json +198 -198
- package/v3/@claude-flow/shared/README.md +323 -323
- package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts +41 -0
- package/v3/@claude-flow/shared/dist/core/config/defaults.js +186 -0
- package/v3/@claude-flow/shared/dist/core/config/index.d.ts +8 -0
- package/v3/@claude-flow/shared/dist/core/config/index.js +12 -0
- package/v3/@claude-flow/shared/dist/core/config/loader.d.ts +45 -0
- package/v3/@claude-flow/shared/dist/core/config/loader.js +238 -0
- package/v3/@claude-flow/shared/dist/core/config/schema.d.ts +1728 -0
- package/v3/@claude-flow/shared/dist/core/config/schema.js +160 -0
- package/v3/@claude-flow/shared/dist/core/config/validator.d.ts +92 -0
- package/v3/@claude-flow/shared/dist/core/config/validator.js +147 -0
- package/v3/@claude-flow/shared/dist/core/event-bus.d.ts +31 -0
- package/v3/@claude-flow/shared/dist/core/event-bus.js +197 -0
- package/v3/@claude-flow/shared/dist/core/index.d.ts +15 -0
- package/v3/@claude-flow/shared/dist/core/index.js +19 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +200 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/agent.interface.js +6 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +310 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +7 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +224 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/event.interface.js +46 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/index.d.ts +10 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/index.js +15 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +298 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/memory.interface.js +7 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +185 -0
- package/v3/@claude-flow/shared/dist/core/interfaces/task.interface.js +6 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +35 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +101 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +60 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +166 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/index.d.ts +46 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/index.js +64 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +195 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +83 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/session-manager.js +193 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +49 -0
- package/v3/@claude-flow/shared/dist/core/orchestrator/task-manager.js +253 -0
- package/v3/@claude-flow/shared/dist/events/domain-events.d.ts +282 -0
- package/v3/@claude-flow/shared/dist/events/domain-events.js +165 -0
- package/v3/@claude-flow/shared/dist/events/event-store.d.ts +126 -0
- package/v3/@claude-flow/shared/dist/events/event-store.js +427 -0
- package/v3/@claude-flow/shared/dist/events/event-store.test.d.ts +8 -0
- package/v3/@claude-flow/shared/dist/events/event-store.test.js +293 -0
- package/v3/@claude-flow/shared/dist/events/example-usage.d.ts +10 -0
- package/v3/@claude-flow/shared/dist/events/example-usage.js +193 -0
- package/v3/@claude-flow/shared/dist/events/index.d.ts +21 -0
- package/v3/@claude-flow/shared/dist/events/index.js +22 -0
- package/v3/@claude-flow/shared/dist/events/projections.d.ts +177 -0
- package/v3/@claude-flow/shared/dist/events/projections.js +421 -0
- package/v3/@claude-flow/shared/dist/events/rvf-event-log.d.ts +82 -0
- package/v3/@claude-flow/shared/dist/events/rvf-event-log.js +340 -0
- package/v3/@claude-flow/shared/dist/events/state-reconstructor.d.ts +101 -0
- package/v3/@claude-flow/shared/dist/events/state-reconstructor.js +263 -0
- package/v3/@claude-flow/shared/dist/events.d.ts +80 -0
- package/v3/@claude-flow/shared/dist/events.js +249 -0
- package/v3/@claude-flow/shared/dist/hooks/example-usage.d.ts +42 -0
- package/v3/@claude-flow/shared/dist/hooks/example-usage.js +351 -0
- package/v3/@claude-flow/shared/dist/hooks/executor.d.ts +100 -0
- package/v3/@claude-flow/shared/dist/hooks/executor.js +267 -0
- package/v3/@claude-flow/shared/dist/hooks/hooks.test.d.ts +9 -0
- package/v3/@claude-flow/shared/dist/hooks/hooks.test.js +322 -0
- package/v3/@claude-flow/shared/dist/hooks/index.d.ts +52 -0
- package/v3/@claude-flow/shared/dist/hooks/index.js +51 -0
- package/v3/@claude-flow/shared/dist/hooks/registry.d.ts +133 -0
- package/v3/@claude-flow/shared/dist/hooks/registry.js +277 -0
- package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +105 -0
- package/v3/@claude-flow/shared/dist/hooks/safety/bash-safety.js +481 -0
- package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +144 -0
- package/v3/@claude-flow/shared/dist/hooks/safety/file-organization.js +328 -0
- package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +158 -0
- package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +450 -0
- package/v3/@claude-flow/shared/dist/hooks/safety/index.d.ts +17 -0
- package/v3/@claude-flow/shared/dist/hooks/safety/index.js +17 -0
- package/v3/@claude-flow/shared/dist/hooks/session-hooks.d.ts +234 -0
- package/v3/@claude-flow/shared/dist/hooks/session-hooks.js +334 -0
- package/v3/@claude-flow/shared/dist/hooks/task-hooks.d.ts +163 -0
- package/v3/@claude-flow/shared/dist/hooks/task-hooks.js +326 -0
- package/v3/@claude-flow/shared/dist/hooks/types.d.ts +267 -0
- package/v3/@claude-flow/shared/dist/hooks/types.js +62 -0
- package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +9 -0
- package/v3/@claude-flow/shared/dist/hooks/verify-exports.test.js +93 -0
- package/v3/@claude-flow/shared/dist/index.d.ts +20 -0
- package/v3/@claude-flow/shared/dist/index.js +50 -0
- package/v3/@claude-flow/shared/dist/mcp/connection-pool.d.ts +98 -0
- package/v3/@claude-flow/shared/dist/mcp/connection-pool.js +364 -0
- package/v3/@claude-flow/shared/dist/mcp/index.d.ts +69 -0
- package/v3/@claude-flow/shared/dist/mcp/index.js +84 -0
- package/v3/@claude-flow/shared/dist/mcp/server.d.ts +166 -0
- package/v3/@claude-flow/shared/dist/mcp/server.js +590 -0
- package/v3/@claude-flow/shared/dist/mcp/session-manager.d.ts +136 -0
- package/v3/@claude-flow/shared/dist/mcp/session-manager.js +335 -0
- package/v3/@claude-flow/shared/dist/mcp/tool-registry.d.ts +178 -0
- package/v3/@claude-flow/shared/dist/mcp/tool-registry.js +439 -0
- package/v3/@claude-flow/shared/dist/mcp/transport/http.d.ts +104 -0
- package/v3/@claude-flow/shared/dist/mcp/transport/http.js +476 -0
- package/v3/@claude-flow/shared/dist/mcp/transport/index.d.ts +102 -0
- package/v3/@claude-flow/shared/dist/mcp/transport/index.js +238 -0
- package/v3/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +104 -0
- package/v3/@claude-flow/shared/dist/mcp/transport/stdio.js +263 -0
- package/v3/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +133 -0
- package/v3/@claude-flow/shared/dist/mcp/transport/websocket.js +396 -0
- package/v3/@claude-flow/shared/dist/mcp/types.d.ts +436 -0
- package/v3/@claude-flow/shared/dist/mcp/types.js +54 -0
- package/v3/@claude-flow/shared/dist/plugin-interface.d.ts +544 -0
- package/v3/@claude-flow/shared/dist/plugin-interface.js +23 -0
- package/v3/@claude-flow/shared/dist/plugin-loader.d.ts +139 -0
- package/v3/@claude-flow/shared/dist/plugin-loader.js +434 -0
- package/v3/@claude-flow/shared/dist/plugin-registry.d.ts +183 -0
- package/v3/@claude-flow/shared/dist/plugin-registry.js +457 -0
- package/v3/@claude-flow/shared/dist/plugins/index.d.ts +10 -0
- package/v3/@claude-flow/shared/dist/plugins/index.js +10 -0
- package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
- package/v3/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +241 -0
- package/v3/@claude-flow/shared/dist/plugins/official/index.d.ts +10 -0
- package/v3/@claude-flow/shared/dist/plugins/official/index.js +10 -0
- package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +121 -0
- package/v3/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +355 -0
- package/v3/@claude-flow/shared/dist/plugins/types.d.ts +93 -0
- package/v3/@claude-flow/shared/dist/plugins/types.js +9 -0
- package/v3/@claude-flow/shared/dist/resilience/bulkhead.d.ts +105 -0
- package/v3/@claude-flow/shared/dist/resilience/bulkhead.js +206 -0
- package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +132 -0
- package/v3/@claude-flow/shared/dist/resilience/circuit-breaker.js +233 -0
- package/v3/@claude-flow/shared/dist/resilience/index.d.ts +19 -0
- package/v3/@claude-flow/shared/dist/resilience/index.js +19 -0
- package/v3/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +168 -0
- package/v3/@claude-flow/shared/dist/resilience/rate-limiter.js +314 -0
- package/v3/@claude-flow/shared/dist/resilience/retry.d.ts +91 -0
- package/v3/@claude-flow/shared/dist/resilience/retry.js +159 -0
- package/v3/@claude-flow/shared/dist/security/index.d.ts +10 -0
- package/v3/@claude-flow/shared/dist/security/index.js +12 -0
- package/v3/@claude-flow/shared/dist/security/input-validation.d.ts +73 -0
- package/v3/@claude-flow/shared/dist/security/input-validation.js +201 -0
- package/v3/@claude-flow/shared/dist/security/secure-random.d.ts +92 -0
- package/v3/@claude-flow/shared/dist/security/secure-random.js +142 -0
- package/v3/@claude-flow/shared/dist/services/index.d.ts +7 -0
- package/v3/@claude-flow/shared/dist/services/index.js +7 -0
- package/v3/@claude-flow/shared/dist/services/v3-progress.service.d.ts +124 -0
- package/v3/@claude-flow/shared/dist/services/v3-progress.service.js +402 -0
- package/v3/@claude-flow/shared/dist/types/agent.types.d.ts +137 -0
- package/v3/@claude-flow/shared/dist/types/agent.types.js +6 -0
- package/v3/@claude-flow/shared/dist/types/index.d.ts +11 -0
- package/v3/@claude-flow/shared/dist/types/index.js +17 -0
- package/v3/@claude-flow/shared/dist/types/mcp.types.d.ts +266 -0
- package/v3/@claude-flow/shared/dist/types/mcp.types.js +7 -0
- package/v3/@claude-flow/shared/dist/types/memory.types.d.ts +236 -0
- package/v3/@claude-flow/shared/dist/types/memory.types.js +7 -0
- package/v3/@claude-flow/shared/dist/types/swarm.types.d.ts +186 -0
- package/v3/@claude-flow/shared/dist/types/swarm.types.js +65 -0
- package/v3/@claude-flow/shared/dist/types/task.types.d.ts +178 -0
- package/v3/@claude-flow/shared/dist/types/task.types.js +32 -0
- package/v3/@claude-flow/shared/dist/types.d.ts +197 -0
- package/v3/@claude-flow/shared/dist/types.js +21 -0
- package/v3/@claude-flow/shared/dist/utils/secure-logger.d.ts +69 -0
- package/v3/@claude-flow/shared/dist/utils/secure-logger.js +208 -0
- package/v3/@claude-flow/shared/package.json +43 -43
- package/v3/README.md +493 -493
- package/.claude/security-scans/scan-all-standard.json +0 -321
- package/.claude/security-scans/scan-code-deep.json +0 -1209
- package/.claude/security-scans/scan-deps-full.json +0 -14
|
@@ -0,0 +1,267 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 Hooks System - Hook Executor
|
|
3
|
+
*
|
|
4
|
+
* Executes hooks in priority order with timeout handling and error recovery.
|
|
5
|
+
* Integrates with event bus for coordination and monitoring.
|
|
6
|
+
*
|
|
7
|
+
* @module v3/shared/hooks/executor
|
|
8
|
+
*/
|
|
9
|
+
/**
|
|
10
|
+
* Hook executor implementation
|
|
11
|
+
*/
|
|
12
|
+
export class HookExecutor {
|
|
13
|
+
registry;
|
|
14
|
+
eventBus;
|
|
15
|
+
constructor(registry, eventBus) {
|
|
16
|
+
this.registry = registry;
|
|
17
|
+
this.eventBus = eventBus;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Execute all hooks for an event
|
|
21
|
+
*
|
|
22
|
+
* @param event - Hook event type
|
|
23
|
+
* @param context - Hook context
|
|
24
|
+
* @param options - Execution options
|
|
25
|
+
* @returns Aggregated results
|
|
26
|
+
*/
|
|
27
|
+
async execute(event, context, options = {}) {
|
|
28
|
+
const startTime = Date.now();
|
|
29
|
+
const results = [];
|
|
30
|
+
let aborted = false;
|
|
31
|
+
let finalContext = {};
|
|
32
|
+
// Get enabled hooks for this event
|
|
33
|
+
const hooks = this.registry.getHandlers(event, false);
|
|
34
|
+
// Emit pre-execution event
|
|
35
|
+
this.eventBus?.emit('hooks:pre-execute', {
|
|
36
|
+
event,
|
|
37
|
+
hookCount: hooks.length,
|
|
38
|
+
context,
|
|
39
|
+
});
|
|
40
|
+
// Execute hooks in priority order
|
|
41
|
+
for (const hook of hooks) {
|
|
42
|
+
if (aborted) {
|
|
43
|
+
break;
|
|
44
|
+
}
|
|
45
|
+
try {
|
|
46
|
+
const result = await this.executeSingleHook(hook.handler, context, hook.timeout || options.timeout);
|
|
47
|
+
results.push(result);
|
|
48
|
+
// Record execution statistics
|
|
49
|
+
this.registry.recordExecution(result.success, result.executionTime || 0);
|
|
50
|
+
// Merge context modifications
|
|
51
|
+
if (result.data) {
|
|
52
|
+
finalContext = { ...finalContext, ...result.data };
|
|
53
|
+
// Update context for next hooks
|
|
54
|
+
Object.assign(context, result.data);
|
|
55
|
+
}
|
|
56
|
+
// Check if we should abort
|
|
57
|
+
if (result.abort) {
|
|
58
|
+
aborted = true;
|
|
59
|
+
break;
|
|
60
|
+
}
|
|
61
|
+
// Check if we should stop the chain
|
|
62
|
+
if (result.continueChain === false) {
|
|
63
|
+
break;
|
|
64
|
+
}
|
|
65
|
+
// Check if we should stop on error
|
|
66
|
+
if (!result.success && !options.continueOnError) {
|
|
67
|
+
aborted = true;
|
|
68
|
+
break;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
const errorResult = {
|
|
73
|
+
success: false,
|
|
74
|
+
error: error instanceof Error ? error : new Error(String(error)),
|
|
75
|
+
continueChain: options.continueOnError,
|
|
76
|
+
};
|
|
77
|
+
results.push(errorResult);
|
|
78
|
+
this.registry.recordExecution(false, 0);
|
|
79
|
+
// Emit error event
|
|
80
|
+
this.eventBus?.emit('hooks:error', {
|
|
81
|
+
event,
|
|
82
|
+
hookId: hook.id,
|
|
83
|
+
error,
|
|
84
|
+
});
|
|
85
|
+
if (!options.continueOnError) {
|
|
86
|
+
aborted = true;
|
|
87
|
+
break;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
const totalExecutionTime = Date.now() - startTime;
|
|
92
|
+
const hooksFailed = results.filter(r => !r.success).length;
|
|
93
|
+
// Build aggregated result
|
|
94
|
+
const aggregatedResult = {
|
|
95
|
+
success: hooksFailed === 0 && !aborted,
|
|
96
|
+
results: options.collectResults ? results : [],
|
|
97
|
+
totalExecutionTime,
|
|
98
|
+
hooksExecuted: results.length,
|
|
99
|
+
hooksFailed,
|
|
100
|
+
aborted,
|
|
101
|
+
finalContext,
|
|
102
|
+
};
|
|
103
|
+
// Emit post-execution event
|
|
104
|
+
this.eventBus?.emit('hooks:post-execute', {
|
|
105
|
+
event,
|
|
106
|
+
...aggregatedResult,
|
|
107
|
+
});
|
|
108
|
+
return aggregatedResult;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Execute hooks with timeout
|
|
112
|
+
*
|
|
113
|
+
* @param event - Hook event type
|
|
114
|
+
* @param context - Hook context
|
|
115
|
+
* @param timeout - Timeout in ms
|
|
116
|
+
* @returns Aggregated results
|
|
117
|
+
*/
|
|
118
|
+
async executeWithTimeout(event, context, timeout) {
|
|
119
|
+
return this.withTimeout(this.execute(event, context, { timeout }), timeout);
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* Execute a single hook with timeout and error handling
|
|
123
|
+
*
|
|
124
|
+
* @param handler - Hook handler function
|
|
125
|
+
* @param context - Hook context
|
|
126
|
+
* @param timeout - Optional timeout in ms
|
|
127
|
+
* @returns Hook result
|
|
128
|
+
*/
|
|
129
|
+
async executeSingleHook(handler, context, timeout) {
|
|
130
|
+
const startTime = Date.now();
|
|
131
|
+
try {
|
|
132
|
+
let resultPromise = Promise.resolve(handler(context));
|
|
133
|
+
// Apply timeout if specified
|
|
134
|
+
if (timeout && timeout > 0) {
|
|
135
|
+
resultPromise = this.withTimeout(resultPromise, timeout);
|
|
136
|
+
}
|
|
137
|
+
const result = await resultPromise;
|
|
138
|
+
const executionTime = Date.now() - startTime;
|
|
139
|
+
return {
|
|
140
|
+
...result,
|
|
141
|
+
executionTime,
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
catch (error) {
|
|
145
|
+
const executionTime = Date.now() - startTime;
|
|
146
|
+
return {
|
|
147
|
+
success: false,
|
|
148
|
+
error: error instanceof Error ? error : new Error(String(error)),
|
|
149
|
+
executionTime,
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
/**
|
|
154
|
+
* Execute multiple hooks in parallel
|
|
155
|
+
*
|
|
156
|
+
* @param events - Array of hook events
|
|
157
|
+
* @param contexts - Array of contexts (matched by index)
|
|
158
|
+
* @param options - Execution options
|
|
159
|
+
* @returns Array of aggregated results
|
|
160
|
+
*/
|
|
161
|
+
async executeParallel(events, contexts, options = {}) {
|
|
162
|
+
if (events.length !== contexts.length) {
|
|
163
|
+
throw new Error('Events and contexts arrays must have same length');
|
|
164
|
+
}
|
|
165
|
+
const maxParallel = options.maxParallel || events.length;
|
|
166
|
+
const results = [];
|
|
167
|
+
// Execute in batches
|
|
168
|
+
for (let i = 0; i < events.length; i += maxParallel) {
|
|
169
|
+
const batch = events.slice(i, i + maxParallel);
|
|
170
|
+
const batchContexts = contexts.slice(i, i + maxParallel);
|
|
171
|
+
const batchResults = await Promise.allSettled(batch.map((event, index) => this.execute(event, batchContexts[index], options)));
|
|
172
|
+
for (const result of batchResults) {
|
|
173
|
+
if (result.status === 'fulfilled') {
|
|
174
|
+
results.push(result.value);
|
|
175
|
+
}
|
|
176
|
+
else {
|
|
177
|
+
// Create error result for rejected promises
|
|
178
|
+
results.push({
|
|
179
|
+
success: false,
|
|
180
|
+
results: [{
|
|
181
|
+
success: false,
|
|
182
|
+
error: result.reason instanceof Error
|
|
183
|
+
? result.reason
|
|
184
|
+
: new Error(String(result.reason)),
|
|
185
|
+
}],
|
|
186
|
+
totalExecutionTime: 0,
|
|
187
|
+
hooksExecuted: 0,
|
|
188
|
+
hooksFailed: 1,
|
|
189
|
+
aborted: true,
|
|
190
|
+
});
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
return results;
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* Execute hooks sequentially with context chaining
|
|
198
|
+
*
|
|
199
|
+
* @param events - Array of hook events
|
|
200
|
+
* @param initialContext - Initial context
|
|
201
|
+
* @param options - Execution options
|
|
202
|
+
* @returns Final aggregated result with chained context
|
|
203
|
+
*/
|
|
204
|
+
async executeSequential(events, initialContext, options = {}) {
|
|
205
|
+
const results = [];
|
|
206
|
+
let currentContext = { ...initialContext };
|
|
207
|
+
let totalExecutionTime = 0;
|
|
208
|
+
let totalHooksExecuted = 0;
|
|
209
|
+
let totalHooksFailed = 0;
|
|
210
|
+
let aborted = false;
|
|
211
|
+
for (const event of events) {
|
|
212
|
+
if (aborted) {
|
|
213
|
+
break;
|
|
214
|
+
}
|
|
215
|
+
const result = await this.execute(event, currentContext, options);
|
|
216
|
+
results.push(...result.results);
|
|
217
|
+
totalExecutionTime += result.totalExecutionTime;
|
|
218
|
+
totalHooksExecuted += result.hooksExecuted;
|
|
219
|
+
totalHooksFailed += result.hooksFailed;
|
|
220
|
+
// Merge context for next event
|
|
221
|
+
if (result.finalContext) {
|
|
222
|
+
currentContext = { ...currentContext, ...result.finalContext };
|
|
223
|
+
}
|
|
224
|
+
if (result.aborted || !result.success) {
|
|
225
|
+
aborted = true;
|
|
226
|
+
break;
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
return {
|
|
230
|
+
success: totalHooksFailed === 0 && !aborted,
|
|
231
|
+
results: options.collectResults ? results : [],
|
|
232
|
+
totalExecutionTime,
|
|
233
|
+
hooksExecuted: totalHooksExecuted,
|
|
234
|
+
hooksFailed: totalHooksFailed,
|
|
235
|
+
aborted,
|
|
236
|
+
finalContext: currentContext,
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* Wrap a promise with timeout
|
|
241
|
+
*/
|
|
242
|
+
async withTimeout(promise, timeout) {
|
|
243
|
+
return Promise.race([
|
|
244
|
+
promise,
|
|
245
|
+
new Promise((_, reject) => setTimeout(() => reject(new Error(`Hook execution timeout after ${timeout}ms`)), timeout)),
|
|
246
|
+
]);
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* Set event bus for coordination
|
|
250
|
+
*/
|
|
251
|
+
setEventBus(eventBus) {
|
|
252
|
+
this.eventBus = eventBus;
|
|
253
|
+
}
|
|
254
|
+
/**
|
|
255
|
+
* Get hook registry
|
|
256
|
+
*/
|
|
257
|
+
getRegistry() {
|
|
258
|
+
return this.registry;
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
/**
|
|
262
|
+
* Create a new hook executor
|
|
263
|
+
*/
|
|
264
|
+
export function createHookExecutor(registry, eventBus) {
|
|
265
|
+
return new HookExecutor(registry, eventBus);
|
|
266
|
+
}
|
|
267
|
+
//# sourceMappingURL=executor.js.map
|
|
@@ -0,0 +1,322 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 Hooks System - Tests
|
|
3
|
+
*
|
|
4
|
+
* Comprehensive tests for hook registry and executor.
|
|
5
|
+
*
|
|
6
|
+
* @module v3/shared/hooks/hooks.test
|
|
7
|
+
*/
|
|
8
|
+
import { describe, it, expect, beforeEach, vi } from 'vitest';
|
|
9
|
+
import { createHookRegistry } from './registry.js';
|
|
10
|
+
import { createHookExecutor } from './executor.js';
|
|
11
|
+
import { HookEvent, HookPriority } from './types.js';
|
|
12
|
+
import { createEventBus } from '../core/event-bus.js';
|
|
13
|
+
describe('HookRegistry', () => {
|
|
14
|
+
let registry;
|
|
15
|
+
beforeEach(() => {
|
|
16
|
+
registry = createHookRegistry();
|
|
17
|
+
});
|
|
18
|
+
it('should register a hook', () => {
|
|
19
|
+
const handler = vi.fn();
|
|
20
|
+
const id = registry.register(HookEvent.PreToolUse, handler);
|
|
21
|
+
expect(id).toBeDefined();
|
|
22
|
+
expect(registry.has(id)).toBe(true);
|
|
23
|
+
expect(registry.count()).toBe(1);
|
|
24
|
+
});
|
|
25
|
+
it('should unregister a hook', () => {
|
|
26
|
+
const handler = vi.fn();
|
|
27
|
+
const id = registry.register(HookEvent.PreToolUse, handler);
|
|
28
|
+
const result = registry.unregister(id);
|
|
29
|
+
expect(result).toBe(true);
|
|
30
|
+
expect(registry.has(id)).toBe(false);
|
|
31
|
+
expect(registry.count()).toBe(0);
|
|
32
|
+
});
|
|
33
|
+
it('should return false when unregistering non-existent hook', () => {
|
|
34
|
+
const result = registry.unregister('non-existent');
|
|
35
|
+
expect(result).toBe(false);
|
|
36
|
+
});
|
|
37
|
+
it('should get handlers sorted by priority', () => {
|
|
38
|
+
const handler1 = vi.fn();
|
|
39
|
+
const handler2 = vi.fn();
|
|
40
|
+
const handler3 = vi.fn();
|
|
41
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.Normal);
|
|
42
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.High);
|
|
43
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
44
|
+
const handlers = registry.getHandlers(HookEvent.PreToolUse);
|
|
45
|
+
expect(handlers).toHaveLength(3);
|
|
46
|
+
expect(handlers[0].handler).toBe(handler2); // High priority first
|
|
47
|
+
expect(handlers[1].handler).toBe(handler1); // Normal priority second
|
|
48
|
+
expect(handlers[2].handler).toBe(handler3); // Low priority last
|
|
49
|
+
});
|
|
50
|
+
it('should filter disabled hooks', () => {
|
|
51
|
+
const handler = vi.fn();
|
|
52
|
+
const id = registry.register(HookEvent.PreToolUse, handler, HookPriority.Normal, {
|
|
53
|
+
enabled: false,
|
|
54
|
+
});
|
|
55
|
+
const handlers = registry.getHandlers(HookEvent.PreToolUse);
|
|
56
|
+
const allHandlers = registry.getHandlers(HookEvent.PreToolUse, true);
|
|
57
|
+
expect(handlers).toHaveLength(0);
|
|
58
|
+
expect(allHandlers).toHaveLength(1);
|
|
59
|
+
});
|
|
60
|
+
it('should enable and disable hooks', () => {
|
|
61
|
+
const handler = vi.fn();
|
|
62
|
+
const id = registry.register(HookEvent.PreToolUse, handler);
|
|
63
|
+
registry.disable(id);
|
|
64
|
+
expect(registry.getHandlers(HookEvent.PreToolUse)).toHaveLength(0);
|
|
65
|
+
registry.enable(id);
|
|
66
|
+
expect(registry.getHandlers(HookEvent.PreToolUse)).toHaveLength(1);
|
|
67
|
+
});
|
|
68
|
+
it('should list hooks with filters', () => {
|
|
69
|
+
registry.register(HookEvent.PreToolUse, vi.fn(), HookPriority.High);
|
|
70
|
+
registry.register(HookEvent.PostToolUse, vi.fn(), HookPriority.Normal);
|
|
71
|
+
registry.register(HookEvent.PreEdit, vi.fn(), HookPriority.Low);
|
|
72
|
+
const allHooks = registry.listHooks();
|
|
73
|
+
expect(allHooks).toHaveLength(3);
|
|
74
|
+
const preToolHooks = registry.listHooks({ event: HookEvent.PreToolUse });
|
|
75
|
+
expect(preToolHooks).toHaveLength(1);
|
|
76
|
+
const highPriorityHooks = registry.listHooks({ minPriority: HookPriority.Normal });
|
|
77
|
+
expect(highPriorityHooks).toHaveLength(2);
|
|
78
|
+
});
|
|
79
|
+
it('should get event types', () => {
|
|
80
|
+
registry.register(HookEvent.PreToolUse, vi.fn());
|
|
81
|
+
registry.register(HookEvent.PostToolUse, vi.fn());
|
|
82
|
+
registry.register(HookEvent.PreEdit, vi.fn());
|
|
83
|
+
const eventTypes = registry.getEventTypes();
|
|
84
|
+
expect(eventTypes).toContain(HookEvent.PreToolUse);
|
|
85
|
+
expect(eventTypes).toContain(HookEvent.PostToolUse);
|
|
86
|
+
expect(eventTypes).toContain(HookEvent.PreEdit);
|
|
87
|
+
});
|
|
88
|
+
it('should track statistics', () => {
|
|
89
|
+
registry.register(HookEvent.PreToolUse, vi.fn());
|
|
90
|
+
registry.register(HookEvent.PostToolUse, vi.fn());
|
|
91
|
+
registry.recordExecution(true, 10);
|
|
92
|
+
registry.recordExecution(true, 20);
|
|
93
|
+
registry.recordExecution(false, 5);
|
|
94
|
+
const stats = registry.getStats();
|
|
95
|
+
expect(stats.totalHooks).toBe(2);
|
|
96
|
+
expect(stats.totalExecutions).toBe(3);
|
|
97
|
+
expect(stats.totalFailures).toBe(1);
|
|
98
|
+
expect(stats.avgExecutionTime).toBe((10 + 20 + 5) / 3);
|
|
99
|
+
});
|
|
100
|
+
it('should reset statistics', () => {
|
|
101
|
+
registry.recordExecution(true, 10);
|
|
102
|
+
registry.resetStats();
|
|
103
|
+
const stats = registry.getStats();
|
|
104
|
+
expect(stats.totalExecutions).toBe(0);
|
|
105
|
+
expect(stats.totalFailures).toBe(0);
|
|
106
|
+
});
|
|
107
|
+
it('should clear all hooks', () => {
|
|
108
|
+
registry.register(HookEvent.PreToolUse, vi.fn());
|
|
109
|
+
registry.register(HookEvent.PostToolUse, vi.fn());
|
|
110
|
+
registry.clear();
|
|
111
|
+
expect(registry.count()).toBe(0);
|
|
112
|
+
expect(registry.getEventTypes()).toHaveLength(0);
|
|
113
|
+
});
|
|
114
|
+
});
|
|
115
|
+
describe('HookExecutor', () => {
|
|
116
|
+
let registry;
|
|
117
|
+
let executor;
|
|
118
|
+
let eventBus;
|
|
119
|
+
beforeEach(() => {
|
|
120
|
+
registry = createHookRegistry();
|
|
121
|
+
eventBus = createEventBus();
|
|
122
|
+
executor = createHookExecutor(registry, eventBus);
|
|
123
|
+
});
|
|
124
|
+
it('should execute single hook successfully', async () => {
|
|
125
|
+
const handler = vi.fn(async () => ({ success: true }));
|
|
126
|
+
registry.register(HookEvent.PreToolUse, handler);
|
|
127
|
+
const context = {
|
|
128
|
+
event: HookEvent.PreToolUse,
|
|
129
|
+
timestamp: new Date(),
|
|
130
|
+
tool: { name: 'Read', parameters: { path: 'file.ts' } },
|
|
131
|
+
};
|
|
132
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
133
|
+
expect(result.success).toBe(true);
|
|
134
|
+
expect(result.hooksExecuted).toBe(1);
|
|
135
|
+
expect(result.hooksFailed).toBe(0);
|
|
136
|
+
expect(handler).toHaveBeenCalledWith(context);
|
|
137
|
+
});
|
|
138
|
+
it('should execute multiple hooks in priority order', async () => {
|
|
139
|
+
const executionOrder = [];
|
|
140
|
+
const handler1 = vi.fn(async () => {
|
|
141
|
+
executionOrder.push(1);
|
|
142
|
+
return { success: true };
|
|
143
|
+
});
|
|
144
|
+
const handler2 = vi.fn(async () => {
|
|
145
|
+
executionOrder.push(2);
|
|
146
|
+
return { success: true };
|
|
147
|
+
});
|
|
148
|
+
const handler3 = vi.fn(async () => {
|
|
149
|
+
executionOrder.push(3);
|
|
150
|
+
return { success: true };
|
|
151
|
+
});
|
|
152
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.Normal);
|
|
153
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.High);
|
|
154
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
155
|
+
const context = {
|
|
156
|
+
event: HookEvent.PreToolUse,
|
|
157
|
+
timestamp: new Date(),
|
|
158
|
+
};
|
|
159
|
+
await executor.execute(HookEvent.PreToolUse, context);
|
|
160
|
+
expect(executionOrder).toEqual([2, 1, 3]); // High, Normal, Low
|
|
161
|
+
});
|
|
162
|
+
it('should handle hook errors gracefully', async () => {
|
|
163
|
+
const handler1 = vi.fn(async () => ({ success: true }));
|
|
164
|
+
const handler2 = vi.fn(async () => {
|
|
165
|
+
throw new Error('Hook failed');
|
|
166
|
+
});
|
|
167
|
+
const handler3 = vi.fn(async () => ({ success: true }));
|
|
168
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
|
|
169
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
|
|
170
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
171
|
+
const context = {
|
|
172
|
+
event: HookEvent.PreToolUse,
|
|
173
|
+
timestamp: new Date(),
|
|
174
|
+
};
|
|
175
|
+
const result = await executor.execute(HookEvent.PreToolUse, context, {
|
|
176
|
+
continueOnError: true,
|
|
177
|
+
});
|
|
178
|
+
expect(result.hooksExecuted).toBe(3);
|
|
179
|
+
expect(result.hooksFailed).toBe(1);
|
|
180
|
+
expect(handler3).toHaveBeenCalled(); // Should continue despite error
|
|
181
|
+
});
|
|
182
|
+
it('should abort on error when continueOnError is false', async () => {
|
|
183
|
+
const handler1 = vi.fn(async () => ({ success: true }));
|
|
184
|
+
const handler2 = vi.fn(async () => {
|
|
185
|
+
throw new Error('Hook failed');
|
|
186
|
+
});
|
|
187
|
+
const handler3 = vi.fn(async () => ({ success: true }));
|
|
188
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
|
|
189
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
|
|
190
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
191
|
+
const context = {
|
|
192
|
+
event: HookEvent.PreToolUse,
|
|
193
|
+
timestamp: new Date(),
|
|
194
|
+
};
|
|
195
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
196
|
+
expect(result.aborted).toBe(true);
|
|
197
|
+
expect(result.hooksExecuted).toBe(2);
|
|
198
|
+
expect(handler3).not.toHaveBeenCalled(); // Should not execute after error
|
|
199
|
+
});
|
|
200
|
+
it('should abort when hook returns abort flag', async () => {
|
|
201
|
+
const handler1 = vi.fn(async () => ({ success: true }));
|
|
202
|
+
const handler2 = vi.fn(async () => ({ success: true, abort: true }));
|
|
203
|
+
const handler3 = vi.fn(async () => ({ success: true }));
|
|
204
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
|
|
205
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
|
|
206
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
207
|
+
const context = {
|
|
208
|
+
event: HookEvent.PreToolUse,
|
|
209
|
+
timestamp: new Date(),
|
|
210
|
+
};
|
|
211
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
212
|
+
expect(result.aborted).toBe(true);
|
|
213
|
+
expect(result.hooksExecuted).toBe(2);
|
|
214
|
+
expect(handler3).not.toHaveBeenCalled();
|
|
215
|
+
});
|
|
216
|
+
it('should merge context modifications', async () => {
|
|
217
|
+
const handler1 = vi.fn(async () => ({
|
|
218
|
+
success: true,
|
|
219
|
+
data: { metadata: { modified: true } },
|
|
220
|
+
}));
|
|
221
|
+
const handler2 = vi.fn(async (context) => {
|
|
222
|
+
expect(context.metadata?.modified).toBe(true);
|
|
223
|
+
return { success: true };
|
|
224
|
+
});
|
|
225
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
|
|
226
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
|
|
227
|
+
const context = {
|
|
228
|
+
event: HookEvent.PreToolUse,
|
|
229
|
+
timestamp: new Date(),
|
|
230
|
+
};
|
|
231
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
232
|
+
expect(result.finalContext?.metadata).toEqual({ modified: true });
|
|
233
|
+
});
|
|
234
|
+
it('should handle timeout', async () => {
|
|
235
|
+
const handler = vi.fn(async () => {
|
|
236
|
+
await new Promise(resolve => setTimeout(resolve, 200));
|
|
237
|
+
return { success: true };
|
|
238
|
+
});
|
|
239
|
+
registry.register(HookEvent.PreToolUse, handler);
|
|
240
|
+
const context = {
|
|
241
|
+
event: HookEvent.PreToolUse,
|
|
242
|
+
timestamp: new Date(),
|
|
243
|
+
};
|
|
244
|
+
const result = await executor.executeWithTimeout(HookEvent.PreToolUse, context, 100);
|
|
245
|
+
expect(result.success).toBe(false);
|
|
246
|
+
expect(result.hooksFailed).toBe(1);
|
|
247
|
+
});
|
|
248
|
+
it('should execute hooks in parallel', async () => {
|
|
249
|
+
const handler1 = vi.fn(async () => ({ success: true }));
|
|
250
|
+
const handler2 = vi.fn(async () => ({ success: true }));
|
|
251
|
+
registry.register(HookEvent.PreToolUse, handler1);
|
|
252
|
+
registry.register(HookEvent.PostToolUse, handler2);
|
|
253
|
+
const contexts = [
|
|
254
|
+
{ event: HookEvent.PreToolUse, timestamp: new Date() },
|
|
255
|
+
{ event: HookEvent.PostToolUse, timestamp: new Date() },
|
|
256
|
+
];
|
|
257
|
+
const results = await executor.executeParallel([HookEvent.PreToolUse, HookEvent.PostToolUse], contexts);
|
|
258
|
+
expect(results).toHaveLength(2);
|
|
259
|
+
expect(results[0].success).toBe(true);
|
|
260
|
+
expect(results[1].success).toBe(true);
|
|
261
|
+
});
|
|
262
|
+
it('should execute hooks sequentially with context chaining', async () => {
|
|
263
|
+
const handler1 = vi.fn(async () => ({
|
|
264
|
+
success: true,
|
|
265
|
+
data: { metadata: { step: 1 } },
|
|
266
|
+
}));
|
|
267
|
+
const handler2 = vi.fn(async () => ({
|
|
268
|
+
success: true,
|
|
269
|
+
data: { metadata: { step: 2 } },
|
|
270
|
+
}));
|
|
271
|
+
registry.register(HookEvent.PreToolUse, handler1);
|
|
272
|
+
registry.register(HookEvent.PostToolUse, handler2);
|
|
273
|
+
const initialContext = {
|
|
274
|
+
event: HookEvent.PreToolUse,
|
|
275
|
+
timestamp: new Date(),
|
|
276
|
+
};
|
|
277
|
+
const result = await executor.executeSequential([HookEvent.PreToolUse, HookEvent.PostToolUse], initialContext);
|
|
278
|
+
expect(result.success).toBe(true);
|
|
279
|
+
expect(result.hooksExecuted).toBe(2);
|
|
280
|
+
});
|
|
281
|
+
it('should emit events to event bus', async () => {
|
|
282
|
+
const preExecuteHandler = vi.fn();
|
|
283
|
+
const postExecuteHandler = vi.fn();
|
|
284
|
+
eventBus.on('hooks:pre-execute', preExecuteHandler);
|
|
285
|
+
eventBus.on('hooks:post-execute', postExecuteHandler);
|
|
286
|
+
const handler = vi.fn(async () => ({ success: true }));
|
|
287
|
+
registry.register(HookEvent.PreToolUse, handler);
|
|
288
|
+
const context = {
|
|
289
|
+
event: HookEvent.PreToolUse,
|
|
290
|
+
timestamp: new Date(),
|
|
291
|
+
};
|
|
292
|
+
await executor.execute(HookEvent.PreToolUse, context);
|
|
293
|
+
expect(preExecuteHandler).toHaveBeenCalled();
|
|
294
|
+
expect(postExecuteHandler).toHaveBeenCalled();
|
|
295
|
+
});
|
|
296
|
+
it('should skip disabled hooks', async () => {
|
|
297
|
+
const handler = vi.fn(async () => ({ success: true }));
|
|
298
|
+
const id = registry.register(HookEvent.PreToolUse, handler, HookPriority.Normal, {
|
|
299
|
+
enabled: false,
|
|
300
|
+
});
|
|
301
|
+
const context = {
|
|
302
|
+
event: HookEvent.PreToolUse,
|
|
303
|
+
timestamp: new Date(),
|
|
304
|
+
};
|
|
305
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
306
|
+
expect(result.hooksExecuted).toBe(0);
|
|
307
|
+
expect(handler).not.toHaveBeenCalled();
|
|
308
|
+
});
|
|
309
|
+
it('should record execution statistics', async () => {
|
|
310
|
+
const handler = vi.fn(async () => ({ success: true }));
|
|
311
|
+
registry.register(HookEvent.PreToolUse, handler);
|
|
312
|
+
const context = {
|
|
313
|
+
event: HookEvent.PreToolUse,
|
|
314
|
+
timestamp: new Date(),
|
|
315
|
+
};
|
|
316
|
+
await executor.execute(HookEvent.PreToolUse, context);
|
|
317
|
+
const stats = registry.getStats();
|
|
318
|
+
expect(stats.totalExecutions).toBe(1);
|
|
319
|
+
expect(stats.totalFailures).toBe(0);
|
|
320
|
+
});
|
|
321
|
+
});
|
|
322
|
+
//# sourceMappingURL=hooks.test.js.map
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 Hooks System - Main Export
|
|
3
|
+
*
|
|
4
|
+
* Provides extensible hook points for tool execution, file operations,
|
|
5
|
+
* and session lifecycle events. Integrates with event bus for coordination.
|
|
6
|
+
*
|
|
7
|
+
* Example usage:
|
|
8
|
+
*
|
|
9
|
+
* ```typescript
|
|
10
|
+
* import { createHookRegistry, createHookExecutor, HookEvent, HookPriority } from '@claude-flow/shared/hooks';
|
|
11
|
+
*
|
|
12
|
+
* const registry = createHookRegistry();
|
|
13
|
+
* const executor = createHookExecutor(registry, eventBus);
|
|
14
|
+
*
|
|
15
|
+
* // Register a hook
|
|
16
|
+
* const hookId = registry.register(
|
|
17
|
+
* HookEvent.PreToolUse,
|
|
18
|
+
* async (context) => {
|
|
19
|
+
* console.log('Before tool use:', context.tool?.name);
|
|
20
|
+
* return { success: true };
|
|
21
|
+
* },
|
|
22
|
+
* HookPriority.High
|
|
23
|
+
* );
|
|
24
|
+
*
|
|
25
|
+
* // Execute hooks
|
|
26
|
+
* const result = await executor.execute(
|
|
27
|
+
* HookEvent.PreToolUse,
|
|
28
|
+
* {
|
|
29
|
+
* event: HookEvent.PreToolUse,
|
|
30
|
+
* timestamp: new Date(),
|
|
31
|
+
* tool: { name: 'Read', parameters: { path: 'file.ts' } }
|
|
32
|
+
* }
|
|
33
|
+
* );
|
|
34
|
+
*
|
|
35
|
+
* // Unregister hook
|
|
36
|
+
* registry.unregister(hookId);
|
|
37
|
+
* ```
|
|
38
|
+
*
|
|
39
|
+
* @module v3/shared/hooks
|
|
40
|
+
*/
|
|
41
|
+
export type { HookContext, HookResult, HookHandler, HookDefinition, HookStats, HookExecutionOptions, ToolInfo, CommandInfo, FileOperationInfo, SessionInfo, AgentInfo, TaskInfo, MemoryInfo, ErrorInfo, } from './types.js';
|
|
42
|
+
export { HookEvent, HookPriority, } from './types.js';
|
|
43
|
+
export { HookRegistry, createHookRegistry, } from './registry.js';
|
|
44
|
+
export type { AggregatedHookResult, } from './executor.js';
|
|
45
|
+
export { HookExecutor, createHookExecutor, } from './executor.js';
|
|
46
|
+
export { TaskHooksManager, createTaskHooksManager, } from './task-hooks.js';
|
|
47
|
+
export type { PreTaskHookResult, PostTaskHookResult, AgentSuggestion, TaskPattern, TaskOutcome, LearningUpdate, } from './task-hooks.js';
|
|
48
|
+
export { SessionHooksManager, createSessionHooksManager, InMemorySessionStorage, } from './session-hooks.js';
|
|
49
|
+
export type { SessionState, SessionEndHookResult, SessionRestoreHookResult, SessionSummary, SessionStorage, } from './session-hooks.js';
|
|
50
|
+
export { BashSafetyHook, createBashSafetyHook, FileOrganizationHook, createFileOrganizationHook, GitCommitHook, createGitCommitHook, } from './safety/index.js';
|
|
51
|
+
export type { BashSafetyResult, CommandRisk, FileOrganizationResult, FormatterRecommendation, LinterRecommendation, OrganizationIssue, GitCommitResult, CommitType, CommitValidationIssue, } from './safety/index.js';
|
|
52
|
+
//# sourceMappingURL=index.d.ts.map
|