agentic-flow 2.0.3 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/test-neural.md +14 -0
- package/.claude/settings.json +9 -133
- package/README.md +624 -1776
- package/dist/.tsbuildinfo +1 -1
- package/dist/billing/mcp/tools.js +0 -1
- package/dist/billing/mcp/tools.js.map +1 -1
- package/dist/cli/commands/hooks.d.ts.map +1 -1
- package/dist/cli/commands/hooks.js +4 -79
- package/dist/cli/commands/hooks.js.map +1 -1
- package/dist/cli-proxy.js +1 -89
- package/dist/cli-proxy.js.map +1 -1
- package/dist/core/agentdb-fast.js +3 -3
- package/dist/core/agentdb-fast.js.map +1 -1
- package/dist/core/agentdb-wrapper-enhanced.d.ts.map +1 -1
- package/dist/core/agentdb-wrapper-enhanced.js +4 -20
- package/dist/core/agentdb-wrapper-enhanced.js.map +1 -1
- package/dist/core/agentdb-wrapper.d.ts +2 -3
- package/dist/core/agentdb-wrapper.d.ts.map +1 -1
- package/dist/core/agentdb-wrapper.js +1 -15
- package/dist/core/agentdb-wrapper.js.map +1 -1
- package/dist/core/attention-native.d.ts +0 -4
- package/dist/core/attention-native.d.ts.map +1 -1
- package/dist/core/attention-native.js +2 -14
- package/dist/core/attention-native.js.map +1 -1
- package/dist/federation/SecurityManager.d.ts +2 -11
- package/dist/federation/SecurityManager.d.ts.map +1 -1
- package/dist/federation/SecurityManager.js +17 -50
- package/dist/federation/SecurityManager.js.map +1 -1
- package/dist/federation/integrations/supabase-adapter-debug.js +3 -3
- package/dist/federation/integrations/supabase-adapter-debug.js.map +1 -1
- package/dist/hooks/swarm-learning-optimizer.js +5 -5
- package/dist/hooks/swarm-learning-optimizer.js.map +1 -1
- package/dist/intelligence/IntelligenceStore.d.ts +26 -35
- package/dist/intelligence/IntelligenceStore.d.ts.map +1 -1
- package/dist/intelligence/IntelligenceStore.js +123 -308
- package/dist/intelligence/IntelligenceStore.js.map +1 -1
- package/dist/intelligence/RuVectorIntelligence.d.ts +1 -26
- package/dist/intelligence/RuVectorIntelligence.d.ts.map +1 -1
- package/dist/intelligence/RuVectorIntelligence.js +10 -49
- package/dist/intelligence/RuVectorIntelligence.js.map +1 -1
- package/dist/intelligence/agent-booster-enhanced.d.ts +0 -1
- package/dist/intelligence/agent-booster-enhanced.d.ts.map +1 -1
- package/dist/intelligence/agent-booster-enhanced.js +3 -24
- package/dist/intelligence/agent-booster-enhanced.js.map +1 -1
- package/dist/intelligence/index.d.ts +3 -29
- package/dist/intelligence/index.d.ts.map +1 -1
- package/dist/intelligence/index.js +3 -13
- package/dist/intelligence/index.js.map +1 -1
- package/dist/mcp/claudeFlowSdkServer.d.ts.map +1 -1
- package/dist/mcp/claudeFlowSdkServer.js +3 -9
- package/dist/mcp/claudeFlowSdkServer.js.map +1 -1
- package/dist/mcp/fastmcp/tools/hooks/intelligence-bridge.js +5 -5
- package/dist/mcp/fastmcp/tools/hooks/intelligence-bridge.js.map +1 -1
- package/dist/mcp/fastmcp/tools/swarm/init.d.ts.map +1 -1
- package/dist/mcp/fastmcp/tools/swarm/init.js +7 -36
- package/dist/mcp/fastmcp/tools/swarm/init.js.map +1 -1
- package/dist/mcp/fastmcp/tools/swarm/spawn.d.ts.map +1 -1
- package/dist/mcp/fastmcp/tools/swarm/spawn.js +8 -47
- package/dist/mcp/fastmcp/tools/swarm/spawn.js.map +1 -1
- package/dist/mcp/tools/agent-booster-tools.d.ts +1 -1
- package/dist/mcp/tools/agent-booster-tools.d.ts.map +1 -1
- package/dist/mcp/tools/agent-booster-tools.js +4 -10
- package/dist/mcp/tools/agent-booster-tools.js.map +1 -1
- package/dist/mcp/tools/sona-tools.d.ts.map +1 -1
- package/dist/mcp/tools/sona-tools.js +0 -6
- package/dist/mcp/tools/sona-tools.js.map +1 -1
- package/dist/optimizations/agent-booster-migration.d.ts.map +1 -1
- package/dist/optimizations/agent-booster-migration.js +2 -5
- package/dist/optimizations/agent-booster-migration.js.map +1 -1
- package/dist/proxy/anthropic-to-openrouter.js.map +1 -1
- package/dist/proxy/anthropic-to-requesty.js.map +1 -1
- package/dist/proxy/quic-proxy.d.ts +1 -0
- package/dist/proxy/quic-proxy.d.ts.map +1 -1
- package/dist/proxy/quic-proxy.js +2 -2
- package/dist/proxy/quic-proxy.js.map +1 -1
- package/dist/reasoningbank/AdvancedMemory.js +1 -1
- package/dist/reasoningbank/AdvancedMemory.js.map +1 -1
- package/dist/reasoningbank/HybridBackend.d.ts.map +1 -1
- package/dist/reasoningbank/HybridBackend.js +5 -2
- package/dist/reasoningbank/HybridBackend.js.map +1 -1
- package/dist/reasoningbank/backend-selector.d.ts +1 -11
- package/dist/reasoningbank/backend-selector.d.ts.map +1 -1
- package/dist/reasoningbank/backend-selector.js +5 -45
- package/dist/reasoningbank/backend-selector.js.map +1 -1
- package/dist/reasoningbank/core/consolidate.d.ts.map +1 -1
- package/dist/reasoningbank/core/consolidate.js +45 -113
- package/dist/reasoningbank/core/consolidate.js.map +1 -1
- package/dist/reasoningbank/index-new.d.ts +6 -1
- package/dist/reasoningbank/index-new.d.ts.map +1 -1
- package/dist/reasoningbank/index-new.js +6 -1
- package/dist/reasoningbank/index-new.js.map +1 -1
- package/dist/reasoningbank/index.d.ts +6 -2
- package/dist/reasoningbank/index.d.ts.map +1 -1
- package/dist/reasoningbank/index.js +6 -2
- package/dist/reasoningbank/index.js.map +1 -1
- package/dist/reasoningbank/utils/embeddings.d.ts +0 -1
- package/dist/reasoningbank/utils/embeddings.d.ts.map +1 -1
- package/dist/reasoningbank/utils/embeddings.js +26 -53
- package/dist/reasoningbank/utils/embeddings.js.map +1 -1
- package/dist/router/index.d.ts +17 -0
- package/dist/router/index.d.ts.map +1 -0
- package/dist/router/index.js +19 -0
- package/dist/router/index.js.map +1 -0
- package/dist/router/providers/onnx-local-optimized.d.ts +0 -2
- package/dist/router/providers/onnx-local-optimized.d.ts.map +1 -1
- package/dist/router/providers/onnx-local-optimized.js +0 -10
- package/dist/router/providers/onnx-local-optimized.js.map +1 -1
- package/dist/router/providers/onnx-local.d.ts +0 -1
- package/dist/router/providers/onnx-local.d.ts.map +1 -1
- package/dist/router/providers/onnx-local.js +5 -22
- package/dist/router/providers/onnx-local.js.map +1 -1
- package/dist/services/embedding-service.js.map +1 -1
- package/dist/services/sona-agent-training.d.ts +0 -1
- package/dist/services/sona-agent-training.d.ts.map +1 -1
- package/dist/services/sona-agent-training.js.map +1 -1
- package/dist/services/sona-agentdb-integration.d.ts.map +1 -1
- package/dist/services/sona-agentdb-integration.js +6 -9
- package/dist/services/sona-agentdb-integration.js.map +1 -1
- package/dist/services/sona-service.d.ts.map +1 -1
- package/dist/services/sona-service.js +5 -6
- package/dist/services/sona-service.js.map +1 -1
- package/dist/utils/cli.d.ts +1 -1
- package/dist/utils/cli.d.ts.map +1 -1
- package/dist/utils/cli.js +0 -21
- package/dist/utils/cli.js.map +1 -1
- package/package.json +7 -19
- package/scripts/postinstall.js +4 -45
- package/.claude/agents/.claude-flow/metrics/agent-metrics.json +0 -1
- package/.claude/agents/.claude-flow/metrics/performance.json +0 -87
- package/.claude/agents/.claude-flow/metrics/task-metrics.json +0 -10
- package/.claude/skills/.claude-flow/metrics/agent-metrics.json +0 -1
- package/.claude/skills/.claude-flow/metrics/performance.json +0 -87
- package/.claude/skills/.claude-flow/metrics/task-metrics.json +0 -10
- package/.claude/skills/agentic-flow-quickstart/skill.md +0 -69
- package/.claude/skills/hooks-automation/skill.md +0 -155
- package/.claude/skills/memory-patterns/skill.md +0 -110
- package/.claude/skills/skill-builder/.claude-flow/metrics/agent-metrics.json +0 -1
- package/.claude/skills/skill-builder/.claude-flow/metrics/performance.json +0 -87
- package/.claude/skills/skill-builder/.claude-flow/metrics/task-metrics.json +0 -10
- package/.claude/skills/sparc-methodology/skill.md +0 -137
- package/.claude/skills/swarm-coordination/skill.md +0 -94
- package/.claude/skills/worker-benchmarks/skill.md +0 -135
- package/.claude/skills/worker-integration/skill.md +0 -154
- package/.claude/statusline.mjs +0 -109
- package/.claude/statusline.sh +0 -71
- package/dist/agentdb/benchmarks/comprehensive-benchmark.js +0 -664
- package/dist/agentdb/benchmarks/frontier-benchmark.js +0 -419
- package/dist/agentdb/benchmarks/reflexion-benchmark.js +0 -370
- package/dist/agentdb/cli/agentdb-cli.js +0 -717
- package/dist/agentdb/controllers/CausalMemoryGraph.js +0 -322
- package/dist/agentdb/controllers/CausalRecall.js +0 -281
- package/dist/agentdb/controllers/EmbeddingService.d.ts +0 -37
- package/dist/agentdb/controllers/EmbeddingService.d.ts.map +0 -1
- package/dist/agentdb/controllers/EmbeddingService.js +0 -119
- package/dist/agentdb/controllers/EmbeddingService.js.map +0 -1
- package/dist/agentdb/controllers/ExplainableRecall.js +0 -387
- package/dist/agentdb/controllers/NightlyLearner.js +0 -382
- package/dist/agentdb/controllers/ReflexionMemory.js +0 -239
- package/dist/agentdb/controllers/SkillLibrary.js +0 -276
- package/dist/agentdb/controllers/frontier-index.js +0 -9
- package/dist/agentdb/controllers/index.js +0 -8
- package/dist/agentdb/optimizations/BatchOperations.js +0 -198
- package/dist/agentdb/optimizations/QueryOptimizer.js +0 -225
- package/dist/agentdb/optimizations/index.js +0 -7
- package/dist/agentdb/tests/frontier-features.test.js +0 -665
- package/dist/benchmarks/embeddings-benchmark.d.ts +0 -38
- package/dist/benchmarks/embeddings-benchmark.d.ts.map +0 -1
- package/dist/benchmarks/embeddings-benchmark.js +0 -282
- package/dist/benchmarks/embeddings-benchmark.js.map +0 -1
- package/dist/cli/commands/embeddings.d.ts +0 -12
- package/dist/cli/commands/embeddings.d.ts.map +0 -1
- package/dist/cli/commands/embeddings.js +0 -386
- package/dist/cli/commands/embeddings.js.map +0 -1
- package/dist/cli/commands/init.d.ts +0 -8
- package/dist/cli/commands/init.d.ts.map +0 -1
- package/dist/cli/commands/init.js +0 -514
- package/dist/cli/commands/init.js.map +0 -1
- package/dist/cli/commands/workers.d.ts +0 -9
- package/dist/cli/commands/workers.d.ts.map +0 -1
- package/dist/cli/commands/workers.js +0 -991
- package/dist/cli/commands/workers.js.map +0 -1
- package/dist/cli/skills-manager.js +0 -1297
- package/dist/cli/update-message.js +0 -175
- package/dist/embeddings/index.d.ts +0 -17
- package/dist/embeddings/index.d.ts.map +0 -1
- package/dist/embeddings/index.js +0 -17
- package/dist/embeddings/index.js.map +0 -1
- package/dist/embeddings/neural-substrate.d.ts +0 -206
- package/dist/embeddings/neural-substrate.d.ts.map +0 -1
- package/dist/embeddings/neural-substrate.js +0 -629
- package/dist/embeddings/neural-substrate.js.map +0 -1
- package/dist/embeddings/optimized-embedder.d.ts +0 -103
- package/dist/embeddings/optimized-embedder.d.ts.map +0 -1
- package/dist/embeddings/optimized-embedder.js +0 -730
- package/dist/embeddings/optimized-embedder.js.map +0 -1
- package/dist/examples/embedding-geometry.d.ts +0 -105
- package/dist/examples/embedding-geometry.d.ts.map +0 -1
- package/dist/examples/embedding-geometry.js +0 -528
- package/dist/examples/embedding-geometry.js.map +0 -1
- package/dist/memory/SharedMemoryPool.d.ts +0 -129
- package/dist/memory/SharedMemoryPool.d.ts.map +0 -1
- package/dist/memory/SharedMemoryPool.js +0 -243
- package/dist/memory/SharedMemoryPool.js.map +0 -1
- package/dist/memory/index.d.ts +0 -8
- package/dist/memory/index.d.ts.map +0 -1
- package/dist/memory/index.js +0 -7
- package/dist/memory/index.js.map +0 -1
- package/dist/proxy/http3-proxy-old.js +0 -331
- package/dist/proxy/proxy/anthropic-to-gemini.js +0 -439
- package/dist/proxy/utils/logger.js +0 -59
- package/dist/reasoningbank/agentdb-adapter.js +0 -125
- package/dist/reasoningbank/core/database.js +0 -250
- package/dist/reasoningbank/core/memory-engine.js +0 -335
- package/dist/swarm/ipfs-swarm.d.ts +0 -265
- package/dist/swarm/ipfs-swarm.d.ts.map +0 -1
- package/dist/swarm/ipfs-swarm.js +0 -508
- package/dist/swarm/ipfs-swarm.js.map +0 -1
- package/dist/swarm/p2p-free-swarm.d.ts +0 -344
- package/dist/swarm/p2p-free-swarm.d.ts.map +0 -1
- package/dist/swarm/p2p-free-swarm.js +0 -603
- package/dist/swarm/p2p-free-swarm.js.map +0 -1
- package/dist/swarm/real-p2p-swarm.d.ts +0 -183
- package/dist/swarm/real-p2p-swarm.d.ts.map +0 -1
- package/dist/swarm/real-p2p-swarm.js +0 -469
- package/dist/swarm/real-p2p-swarm.js.map +0 -1
- package/dist/utils/adaptive-pool-sizing.js +0 -414
- package/dist/utils/agentdbCommands.js +0 -175
- package/dist/utils/circular-rate-limiter.js +0 -391
- package/dist/utils/dynamic-compression.js +0 -298
- package/dist/utils/http2-multiplexing.js +0 -319
- package/dist/utils/index.d.ts +0 -6
- package/dist/utils/index.d.ts.map +0 -1
- package/dist/utils/index.js +0 -6
- package/dist/utils/index.js.map +0 -1
- package/dist/utils/lazy-auth.js +0 -311
- package/dist/utils/model-cache.d.ts +0 -61
- package/dist/utils/model-cache.d.ts.map +0 -1
- package/dist/utils/model-cache.js +0 -176
- package/dist/utils/model-cache.js.map +0 -1
- package/dist/utils/server-push.js +0 -251
- package/dist/utils/suppress-warnings.d.ts +0 -19
- package/dist/utils/suppress-warnings.d.ts.map +0 -1
- package/dist/utils/suppress-warnings.js +0 -59
- package/dist/utils/suppress-warnings.js.map +0 -1
- package/dist/utils/zero-copy-buffer.js +0 -286
- package/dist/workers/consolidated-phases.d.ts +0 -40
- package/dist/workers/consolidated-phases.d.ts.map +0 -1
- package/dist/workers/consolidated-phases.js +0 -497
- package/dist/workers/consolidated-phases.js.map +0 -1
- package/dist/workers/custom-worker-config.d.ts +0 -133
- package/dist/workers/custom-worker-config.d.ts.map +0 -1
- package/dist/workers/custom-worker-config.js +0 -215
- package/dist/workers/custom-worker-config.js.map +0 -1
- package/dist/workers/custom-worker-factory.d.ts +0 -89
- package/dist/workers/custom-worker-factory.d.ts.map +0 -1
- package/dist/workers/custom-worker-factory.js +0 -404
- package/dist/workers/custom-worker-factory.js.map +0 -1
- package/dist/workers/dispatch-service.d.ts +0 -123
- package/dist/workers/dispatch-service.d.ts.map +0 -1
- package/dist/workers/dispatch-service.js +0 -1024
- package/dist/workers/dispatch-service.js.map +0 -1
- package/dist/workers/hooks-integration.d.ts +0 -79
- package/dist/workers/hooks-integration.d.ts.map +0 -1
- package/dist/workers/hooks-integration.js +0 -286
- package/dist/workers/hooks-integration.js.map +0 -1
- package/dist/workers/index.d.ts +0 -42
- package/dist/workers/index.d.ts.map +0 -1
- package/dist/workers/index.js +0 -52
- package/dist/workers/index.js.map +0 -1
- package/dist/workers/mcp-tools.d.ts +0 -56
- package/dist/workers/mcp-tools.d.ts.map +0 -1
- package/dist/workers/mcp-tools.js +0 -359
- package/dist/workers/mcp-tools.js.map +0 -1
- package/dist/workers/phase-executors.d.ts +0 -22
- package/dist/workers/phase-executors.d.ts.map +0 -1
- package/dist/workers/phase-executors.js +0 -445
- package/dist/workers/phase-executors.js.map +0 -1
- package/dist/workers/resource-governor.d.ts +0 -75
- package/dist/workers/resource-governor.d.ts.map +0 -1
- package/dist/workers/resource-governor.js +0 -187
- package/dist/workers/resource-governor.js.map +0 -1
- package/dist/workers/ruvector-integration.d.ts +0 -163
- package/dist/workers/ruvector-integration.d.ts.map +0 -1
- package/dist/workers/ruvector-integration.js +0 -543
- package/dist/workers/ruvector-integration.js.map +0 -1
- package/dist/workers/ruvector-native-integration.d.ts +0 -91
- package/dist/workers/ruvector-native-integration.d.ts.map +0 -1
- package/dist/workers/ruvector-native-integration.js +0 -254
- package/dist/workers/ruvector-native-integration.js.map +0 -1
- package/dist/workers/trigger-detector.d.ts +0 -68
- package/dist/workers/trigger-detector.d.ts.map +0 -1
- package/dist/workers/trigger-detector.js +0 -281
- package/dist/workers/trigger-detector.js.map +0 -1
- package/dist/workers/types.d.ts +0 -145
- package/dist/workers/types.d.ts.map +0 -1
- package/dist/workers/types.js +0 -6
- package/dist/workers/types.js.map +0 -1
- package/dist/workers/worker-agent-integration.d.ts +0 -140
- package/dist/workers/worker-agent-integration.d.ts.map +0 -1
- package/dist/workers/worker-agent-integration.js +0 -471
- package/dist/workers/worker-agent-integration.js.map +0 -1
- package/dist/workers/worker-benchmarks.d.ts +0 -88
- package/dist/workers/worker-benchmarks.d.ts.map +0 -1
- package/dist/workers/worker-benchmarks.js +0 -452
- package/dist/workers/worker-benchmarks.js.map +0 -1
- package/dist/workers/worker-registry.d.ts +0 -85
- package/dist/workers/worker-registry.d.ts.map +0 -1
- package/dist/workers/worker-registry.js +0 -547
- package/dist/workers/worker-registry.js.map +0 -1
- package/docs/.claude-flow/metrics/agent-metrics.json +0 -1
- package/docs/.claude-flow/metrics/performance.json +0 -87
- package/docs/.claude-flow/metrics/task-metrics.json +0 -10
- package/docs/embeddings/EMBEDDING_GEOMETRY.md +0 -935
- /package/.claude/agents/analysis/{analyze-code-quality.md → code-review/analyze-code-quality.md} +0 -0
- /package/.claude/agents/architecture/{arch-system-design.md → system-design/arch-system-design.md} +0 -0
- /package/.claude/agents/data/{data-ml-model.md → ml/data-ml-model.md} +0 -0
- /package/.claude/agents/development/{dev-backend-api.md → backend/dev-backend-api.md} +0 -0
- /package/.claude/agents/devops/{ops-cicd-github.md → ci-cd/ops-cicd-github.md} +0 -0
- /package/.claude/agents/documentation/{docs-api-openapi.md → api-docs/docs-api-openapi.md} +0 -0
- /package/.claude/agents/specialized/{spec-mobile-react-native.md → mobile/spec-mobile-react-native.md} +0 -0
- /package/.claude/agents/testing/{tdd-london-swarm.md → unit/tdd-london-swarm.md} +0 -0
- /package/.claude/agents/testing/{production-validator.md → validation/production-validator.md} +0 -0
|
@@ -1,514 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* CLI Init Command
|
|
4
|
-
* Creates .claude/ folder structure and configuration files for Claude Code integration
|
|
5
|
-
* Copies all agents, commands, skills, and helpers from the package
|
|
6
|
-
*/
|
|
7
|
-
import * as fs from 'fs';
|
|
8
|
-
import * as path from 'path';
|
|
9
|
-
import { fileURLToPath } from 'url';
|
|
10
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
11
|
-
const __dirname = path.dirname(__filename);
|
|
12
|
-
const CLAUDE_MD_TEMPLATE = `# Claude Code Configuration - Agentic Flow
|
|
13
|
-
|
|
14
|
-
## 🚨 CRITICAL: CONCURRENT EXECUTION & FILE MANAGEMENT
|
|
15
|
-
|
|
16
|
-
**ABSOLUTE RULES**:
|
|
17
|
-
1. ALL operations MUST be concurrent/parallel in a single message
|
|
18
|
-
2. **NEVER save working files, text/mds and tests to the root folder**
|
|
19
|
-
3. ALWAYS organize files in appropriate subdirectories
|
|
20
|
-
4. **USE CLAUDE CODE'S TASK TOOL** for spawning agents concurrently, not just MCP
|
|
21
|
-
|
|
22
|
-
### ⚡ GOLDEN RULE: "1 MESSAGE = ALL RELATED OPERATIONS"
|
|
23
|
-
|
|
24
|
-
**MANDATORY PATTERNS:**
|
|
25
|
-
- **TodoWrite**: ALWAYS batch ALL todos in ONE call (5-10+ todos minimum)
|
|
26
|
-
- **Task tool (Claude Code)**: ALWAYS spawn ALL agents in ONE message with full instructions
|
|
27
|
-
- **File operations**: ALWAYS batch ALL reads/writes/edits in ONE message
|
|
28
|
-
- **Bash commands**: ALWAYS batch ALL terminal operations in ONE message
|
|
29
|
-
- **Memory operations**: ALWAYS batch ALL memory store/retrieve in ONE message
|
|
30
|
-
|
|
31
|
-
### 🎯 CRITICAL: Claude Code Task Tool for Agent Execution
|
|
32
|
-
|
|
33
|
-
**Claude Code's Task tool is the PRIMARY way to spawn agents:**
|
|
34
|
-
\`\`\`javascript
|
|
35
|
-
// ✅ CORRECT: Use Claude Code's Task tool for parallel agent execution
|
|
36
|
-
[Single Message]:
|
|
37
|
-
Task("Research agent", "Analyze requirements and patterns...", "researcher")
|
|
38
|
-
Task("Coder agent", "Implement core features...", "coder")
|
|
39
|
-
Task("Tester agent", "Create comprehensive tests...", "tester")
|
|
40
|
-
Task("Reviewer agent", "Review code quality...", "reviewer")
|
|
41
|
-
Task("Architect agent", "Design system architecture...", "system-architect")
|
|
42
|
-
\`\`\`
|
|
43
|
-
|
|
44
|
-
**MCP tools are ONLY for coordination setup:**
|
|
45
|
-
- \`mcp__claude-flow__swarm_init\` - Initialize coordination topology
|
|
46
|
-
- \`mcp__claude-flow__agent_spawn\` - Define agent types for coordination
|
|
47
|
-
- \`mcp__claude-flow__task_orchestrate\` - Orchestrate high-level workflows
|
|
48
|
-
|
|
49
|
-
### 📁 File Organization Rules
|
|
50
|
-
|
|
51
|
-
**NEVER save to root folder. Use these directories:**
|
|
52
|
-
- \`/src\` - Source code files
|
|
53
|
-
- \`/tests\` - Test files
|
|
54
|
-
- \`/docs\` - Documentation and markdown files
|
|
55
|
-
- \`/config\` - Configuration files
|
|
56
|
-
- \`/scripts\` - Utility scripts
|
|
57
|
-
- \`/examples\` - Example code
|
|
58
|
-
|
|
59
|
-
## 🚀 Quick Start
|
|
60
|
-
|
|
61
|
-
\`\`\`bash
|
|
62
|
-
# Start MCP server for Claude Code integration
|
|
63
|
-
npx agentic-flow@alpha mcp start
|
|
64
|
-
|
|
65
|
-
# Run an agent directly
|
|
66
|
-
npx agentic-flow@alpha --agent coder --task "Your task here"
|
|
67
|
-
|
|
68
|
-
# List available agents
|
|
69
|
-
npx agentic-flow@alpha --list
|
|
70
|
-
\`\`\`
|
|
71
|
-
|
|
72
|
-
## 🚀 Available Agents (54 Total)
|
|
73
|
-
|
|
74
|
-
### Core Development
|
|
75
|
-
\`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
|
|
76
|
-
|
|
77
|
-
### Swarm Coordination
|
|
78
|
-
\`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`, \`collective-intelligence-coordinator\`, \`swarm-memory-manager\`
|
|
79
|
-
|
|
80
|
-
### Consensus & Distributed
|
|
81
|
-
\`byzantine-coordinator\`, \`raft-manager\`, \`gossip-coordinator\`, \`consensus-builder\`, \`crdt-synchronizer\`, \`quorum-manager\`, \`security-manager\`
|
|
82
|
-
|
|
83
|
-
### Performance & Optimization
|
|
84
|
-
\`perf-analyzer\`, \`performance-benchmarker\`, \`task-orchestrator\`, \`memory-coordinator\`, \`smart-agent\`
|
|
85
|
-
|
|
86
|
-
### GitHub & Repository
|
|
87
|
-
\`github-modes\`, \`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`, \`workflow-automation\`, \`project-board-sync\`, \`repo-architect\`, \`multi-repo-swarm\`
|
|
88
|
-
|
|
89
|
-
### SPARC Methodology
|
|
90
|
-
\`sparc-coord\`, \`sparc-coder\`, \`specification\`, \`pseudocode\`, \`architecture\`, \`refinement\`
|
|
91
|
-
|
|
92
|
-
### Specialized Development
|
|
93
|
-
\`backend-dev\`, \`mobile-dev\`, \`ml-developer\`, \`cicd-engineer\`, \`api-docs\`, \`system-architect\`, \`code-analyzer\`, \`base-template-generator\`
|
|
94
|
-
|
|
95
|
-
## 🎯 Claude Code vs MCP Tools
|
|
96
|
-
|
|
97
|
-
### Claude Code Handles ALL EXECUTION:
|
|
98
|
-
- **Task tool**: Spawn and run agents concurrently for actual work
|
|
99
|
-
- File operations (Read, Write, Edit, MultiEdit, Glob, Grep)
|
|
100
|
-
- Code generation and programming
|
|
101
|
-
- Bash commands and system operations
|
|
102
|
-
- Implementation work
|
|
103
|
-
- Project navigation and analysis
|
|
104
|
-
- TodoWrite and task management
|
|
105
|
-
- Git operations
|
|
106
|
-
- Package management
|
|
107
|
-
- Testing and debugging
|
|
108
|
-
|
|
109
|
-
### MCP Tools ONLY COORDINATE:
|
|
110
|
-
- Swarm initialization (topology setup)
|
|
111
|
-
- Agent type definitions (coordination patterns)
|
|
112
|
-
- Task orchestration (high-level planning)
|
|
113
|
-
- Memory management
|
|
114
|
-
- Neural features
|
|
115
|
-
- Performance tracking
|
|
116
|
-
- GitHub integration
|
|
117
|
-
|
|
118
|
-
**KEY**: MCP coordinates the strategy, Claude Code's Task tool executes with real agents.
|
|
119
|
-
|
|
120
|
-
## MCP Tool Categories
|
|
121
|
-
|
|
122
|
-
### Coordination
|
|
123
|
-
\`swarm_init\`, \`agent_spawn\`, \`task_orchestrate\`
|
|
124
|
-
|
|
125
|
-
### Monitoring
|
|
126
|
-
\`swarm_status\`, \`agent_list\`, \`agent_metrics\`, \`task_status\`, \`task_results\`
|
|
127
|
-
|
|
128
|
-
### Memory & Neural
|
|
129
|
-
\`memory_usage\`, \`neural_status\`, \`neural_train\`, \`neural_patterns\`
|
|
130
|
-
|
|
131
|
-
### GitHub Integration
|
|
132
|
-
\`github_swarm\`, \`repo_analyze\`, \`pr_enhance\`, \`issue_triage\`, \`code_review\`
|
|
133
|
-
|
|
134
|
-
## 🧠 Self-Learning Hooks System
|
|
135
|
-
|
|
136
|
-
### Available Hooks Commands:
|
|
137
|
-
\`\`\`bash
|
|
138
|
-
# Before editing - get context and agent suggestions
|
|
139
|
-
npx agentic-flow@alpha hooks pre-edit <filePath>
|
|
140
|
-
|
|
141
|
-
# After editing - record outcome for learning
|
|
142
|
-
npx agentic-flow@alpha hooks post-edit <filePath> --success true
|
|
143
|
-
|
|
144
|
-
# Before commands - assess risk
|
|
145
|
-
npx agentic-flow@alpha hooks pre-command "<command>"
|
|
146
|
-
|
|
147
|
-
# After commands - record outcome
|
|
148
|
-
npx agentic-flow@alpha hooks post-command "<command>" --success true
|
|
149
|
-
|
|
150
|
-
# Route task to optimal agent using learned patterns
|
|
151
|
-
npx agentic-flow@alpha hooks route "<task description>"
|
|
152
|
-
|
|
153
|
-
# Explain routing decision with transparency
|
|
154
|
-
npx agentic-flow@alpha hooks explain "<task description>"
|
|
155
|
-
|
|
156
|
-
# Bootstrap intelligence from repository
|
|
157
|
-
npx agentic-flow@alpha hooks pretrain
|
|
158
|
-
|
|
159
|
-
# Generate optimized agent configs from pretrain data
|
|
160
|
-
npx agentic-flow@alpha hooks build-agents
|
|
161
|
-
|
|
162
|
-
# View learning metrics dashboard
|
|
163
|
-
npx agentic-flow@alpha hooks metrics
|
|
164
|
-
|
|
165
|
-
# Transfer patterns from another project
|
|
166
|
-
npx agentic-flow@alpha hooks transfer <sourceProject>
|
|
167
|
-
|
|
168
|
-
# RuVector intelligence (SONA, MoE, HNSW 150x faster)
|
|
169
|
-
npx agentic-flow@alpha hooks intelligence
|
|
170
|
-
\`\`\`
|
|
171
|
-
|
|
172
|
-
### Pretraining System (4-Step Pipeline):
|
|
173
|
-
1. **RETRIEVE** - Top-k memory injection with MMR diversity
|
|
174
|
-
2. **JUDGE** - LLM-as-judge trajectory evaluation
|
|
175
|
-
3. **DISTILL** - Extract strategy memories from trajectories
|
|
176
|
-
4. **CONSOLIDATE** - Dedup, detect contradictions, prune old patterns
|
|
177
|
-
|
|
178
|
-
## Performance Benefits
|
|
179
|
-
|
|
180
|
-
- **84.8% SWE-Bench solve rate**
|
|
181
|
-
- **32.3% token reduction**
|
|
182
|
-
- **2.8-4.4x speed improvement**
|
|
183
|
-
- **27+ neural models**
|
|
184
|
-
|
|
185
|
-
## Advanced Features (v2.0.0)
|
|
186
|
-
|
|
187
|
-
- 🚀 Automatic Topology Selection
|
|
188
|
-
- ⚡ Parallel Execution (2.8-4.4x speed)
|
|
189
|
-
- 🧠 Neural Training
|
|
190
|
-
- 📊 Bottleneck Analysis
|
|
191
|
-
- 🤖 Smart Auto-Spawning
|
|
192
|
-
- 🛡️ Self-Healing Workflows
|
|
193
|
-
- 💾 Cross-Session Memory
|
|
194
|
-
- 🔗 GitHub Integration
|
|
195
|
-
|
|
196
|
-
## Code Style & Best Practices
|
|
197
|
-
|
|
198
|
-
- **Modular Design**: Files under 500 lines
|
|
199
|
-
- **Environment Safety**: Never hardcode secrets
|
|
200
|
-
- **Test-First**: Write tests before implementation
|
|
201
|
-
- **Clean Architecture**: Separate concerns
|
|
202
|
-
- **Documentation**: Keep updated
|
|
203
|
-
|
|
204
|
-
## Support
|
|
205
|
-
|
|
206
|
-
- Documentation: https://github.com/ruvnet/agentic-flow
|
|
207
|
-
- Issues: https://github.com/ruvnet/agentic-flow/issues
|
|
208
|
-
|
|
209
|
-
---
|
|
210
|
-
|
|
211
|
-
Remember: **Agentic Flow coordinates, Claude Code creates!**
|
|
212
|
-
|
|
213
|
-
# important-instruction-reminders
|
|
214
|
-
Do what has been asked; nothing more, nothing less.
|
|
215
|
-
NEVER create files unless they're absolutely necessary for achieving your goal.
|
|
216
|
-
ALWAYS prefer editing an existing file to creating a new one.
|
|
217
|
-
NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.
|
|
218
|
-
Never save working files, text/mds and tests to the root folder.
|
|
219
|
-
`;
|
|
220
|
-
const SETTINGS_TEMPLATE = {
|
|
221
|
-
model: "claude-sonnet-4-20250514",
|
|
222
|
-
customInstructions: "Follow the project's CLAUDE.md guidelines. Use concurrent execution for all operations.",
|
|
223
|
-
env: {
|
|
224
|
-
AGENTIC_FLOW_INTELLIGENCE: "true",
|
|
225
|
-
AGENTIC_FLOW_LEARNING_RATE: "0.1",
|
|
226
|
-
AGENTIC_FLOW_EPSILON: "0.1",
|
|
227
|
-
AGENTIC_FLOW_MEMORY_BACKEND: "agentdb"
|
|
228
|
-
},
|
|
229
|
-
permissions: {
|
|
230
|
-
allowedTools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "Task", "WebFetch", "WebSearch", "TodoWrite", "LSP", "NotebookEdit"],
|
|
231
|
-
deniedTools: [],
|
|
232
|
-
allow: [
|
|
233
|
-
"Bash(npx:*)",
|
|
234
|
-
"Bash(agentic-flow:*)",
|
|
235
|
-
"Bash(npm run:*)",
|
|
236
|
-
"mcp__agentic-flow",
|
|
237
|
-
"mcp__claude-flow",
|
|
238
|
-
"mcp__ruv-swarm"
|
|
239
|
-
]
|
|
240
|
-
},
|
|
241
|
-
hooks: {
|
|
242
|
-
PreToolUse: [
|
|
243
|
-
{
|
|
244
|
-
matcher: "Edit|Write|MultiEdit",
|
|
245
|
-
hooks: [{ type: "command", command: "npx agentic-flow@alpha hooks pre-edit \"$TOOL_INPUT_file_path\"" }]
|
|
246
|
-
},
|
|
247
|
-
{
|
|
248
|
-
matcher: "Bash",
|
|
249
|
-
hooks: [{ type: "command", command: "npx agentic-flow@alpha hooks pre-command \"$TOOL_INPUT_command\"" }]
|
|
250
|
-
}
|
|
251
|
-
],
|
|
252
|
-
PostToolUse: [
|
|
253
|
-
{
|
|
254
|
-
matcher: "Edit|Write|MultiEdit",
|
|
255
|
-
hooks: [{ type: "command", command: "npx agentic-flow@alpha hooks post-edit \"$TOOL_INPUT_file_path\" --success" }]
|
|
256
|
-
},
|
|
257
|
-
{
|
|
258
|
-
matcher: "Bash",
|
|
259
|
-
hooks: [{ type: "command", command: "npx agentic-flow@alpha hooks post-command \"$TOOL_INPUT_command\"" }]
|
|
260
|
-
}
|
|
261
|
-
],
|
|
262
|
-
PostToolUseFailure: [
|
|
263
|
-
{
|
|
264
|
-
matcher: "Edit|Write|MultiEdit",
|
|
265
|
-
hooks: [{ type: "command", command: "npx agentic-flow@alpha hooks post-edit \"$TOOL_INPUT_file_path\" --fail --error \"$ERROR_MESSAGE\"" }]
|
|
266
|
-
}
|
|
267
|
-
],
|
|
268
|
-
SessionStart: [
|
|
269
|
-
{
|
|
270
|
-
hooks: [{ type: "command", command: "npx agentic-flow@alpha hooks intelligence stats --json 2>/dev/null || true" }]
|
|
271
|
-
}
|
|
272
|
-
],
|
|
273
|
-
SessionEnd: [
|
|
274
|
-
{
|
|
275
|
-
hooks: [{ type: "command", command: "npx agentic-flow@alpha hooks metrics --session --json 2>/dev/null || true" }]
|
|
276
|
-
}
|
|
277
|
-
],
|
|
278
|
-
UserPromptSubmit: [
|
|
279
|
-
{
|
|
280
|
-
hooks: [
|
|
281
|
-
{ type: "command", timeout: 3000, command: "npx agentic-flow@alpha hooks route \"$USER_PROMPT\" --json 2>/dev/null || true" }
|
|
282
|
-
]
|
|
283
|
-
}
|
|
284
|
-
],
|
|
285
|
-
Stop: [
|
|
286
|
-
{
|
|
287
|
-
matcher: ".*",
|
|
288
|
-
hooks: [{ type: "command", command: "npx agentic-flow@alpha hooks metrics --session 2>/dev/null || true" }]
|
|
289
|
-
}
|
|
290
|
-
]
|
|
291
|
-
},
|
|
292
|
-
agents: {
|
|
293
|
-
source: ".claude/agents",
|
|
294
|
-
customAgents: []
|
|
295
|
-
},
|
|
296
|
-
skills: {
|
|
297
|
-
source: ".claude/commands",
|
|
298
|
-
enabled: true
|
|
299
|
-
},
|
|
300
|
-
statusLine: {
|
|
301
|
-
type: "command",
|
|
302
|
-
command: ".claude/statusline.sh"
|
|
303
|
-
},
|
|
304
|
-
mcpServers: {
|
|
305
|
-
"claude-flow": {
|
|
306
|
-
command: "npx",
|
|
307
|
-
args: ["agentic-flow@alpha", "mcp", "start"]
|
|
308
|
-
}
|
|
309
|
-
}
|
|
310
|
-
};
|
|
311
|
-
/**
|
|
312
|
-
* Recursively copy a directory
|
|
313
|
-
*/
|
|
314
|
-
function copyDirRecursive(src, dest, verbose = false) {
|
|
315
|
-
let fileCount = 0;
|
|
316
|
-
if (!fs.existsSync(src)) {
|
|
317
|
-
return fileCount;
|
|
318
|
-
}
|
|
319
|
-
if (!fs.existsSync(dest)) {
|
|
320
|
-
fs.mkdirSync(dest, { recursive: true });
|
|
321
|
-
}
|
|
322
|
-
const entries = fs.readdirSync(src, { withFileTypes: true });
|
|
323
|
-
for (const entry of entries) {
|
|
324
|
-
const srcPath = path.join(src, entry.name);
|
|
325
|
-
const destPath = path.join(dest, entry.name);
|
|
326
|
-
if (entry.isDirectory()) {
|
|
327
|
-
fileCount += copyDirRecursive(srcPath, destPath, verbose);
|
|
328
|
-
}
|
|
329
|
-
else {
|
|
330
|
-
fs.copyFileSync(srcPath, destPath);
|
|
331
|
-
fileCount++;
|
|
332
|
-
if (verbose) {
|
|
333
|
-
console.log(` 📄 ${path.relative(dest, destPath)}`);
|
|
334
|
-
}
|
|
335
|
-
}
|
|
336
|
-
}
|
|
337
|
-
return fileCount;
|
|
338
|
-
}
|
|
339
|
-
/**
|
|
340
|
-
* Find the package's .claude directory
|
|
341
|
-
*/
|
|
342
|
-
function findPackageClaudeDir() {
|
|
343
|
-
// Try multiple potential locations
|
|
344
|
-
const potentialPaths = [
|
|
345
|
-
// When running from dist/
|
|
346
|
-
path.resolve(__dirname, '..', '..', '..', '.claude'),
|
|
347
|
-
// When running from src/
|
|
348
|
-
path.resolve(__dirname, '..', '..', '.claude'),
|
|
349
|
-
// When installed as package
|
|
350
|
-
path.resolve(__dirname, '..', '.claude'),
|
|
351
|
-
// Fallback to package root
|
|
352
|
-
path.resolve(process.cwd(), 'node_modules', 'agentic-flow', '.claude'),
|
|
353
|
-
];
|
|
354
|
-
for (const p of potentialPaths) {
|
|
355
|
-
if (fs.existsSync(p) && fs.statSync(p).isDirectory()) {
|
|
356
|
-
return p;
|
|
357
|
-
}
|
|
358
|
-
}
|
|
359
|
-
return null;
|
|
360
|
-
}
|
|
361
|
-
export async function handleInitCommand(args) {
|
|
362
|
-
const options = {
|
|
363
|
-
force: args.includes('--force') || args.includes('-f'),
|
|
364
|
-
minimal: args.includes('--minimal') || args.includes('-m'),
|
|
365
|
-
verbose: args.includes('--verbose') || args.includes('-v')
|
|
366
|
-
};
|
|
367
|
-
if (args.includes('--help') || args.includes('-h')) {
|
|
368
|
-
printInitHelp();
|
|
369
|
-
return;
|
|
370
|
-
}
|
|
371
|
-
const cwd = process.cwd();
|
|
372
|
-
const claudeDir = path.join(cwd, '.claude');
|
|
373
|
-
const claudeMdFile = path.join(cwd, 'CLAUDE.md');
|
|
374
|
-
console.log(`
|
|
375
|
-
╔═══════════════════════════════════════════════════════╗
|
|
376
|
-
║ Agentic Flow - Project Initialization ║
|
|
377
|
-
╚═══════════════════════════════════════════════════════╝
|
|
378
|
-
`);
|
|
379
|
-
// Check if already initialized
|
|
380
|
-
if (fs.existsSync(claudeDir) && !options.force) {
|
|
381
|
-
console.log('⚠️ .claude/ directory already exists.');
|
|
382
|
-
console.log(' Use --force to overwrite existing configuration.\n');
|
|
383
|
-
return;
|
|
384
|
-
}
|
|
385
|
-
try {
|
|
386
|
-
// Find the package's .claude directory
|
|
387
|
-
const packageClaudeDir = findPackageClaudeDir();
|
|
388
|
-
if (packageClaudeDir && !options.minimal) {
|
|
389
|
-
console.log('📦 Copying full .claude/ structure from agentic-flow package...\n');
|
|
390
|
-
// Copy entire .claude directory structure
|
|
391
|
-
const directories = ['agents', 'commands', 'skills', 'helpers'];
|
|
392
|
-
let totalFiles = 0;
|
|
393
|
-
for (const dir of directories) {
|
|
394
|
-
const srcDir = path.join(packageClaudeDir, dir);
|
|
395
|
-
const destDir = path.join(claudeDir, dir);
|
|
396
|
-
if (fs.existsSync(srcDir)) {
|
|
397
|
-
const count = copyDirRecursive(srcDir, destDir, options.verbose);
|
|
398
|
-
totalFiles += count;
|
|
399
|
-
console.log(`✅ Copied .claude/${dir}/ (${count} files)`);
|
|
400
|
-
}
|
|
401
|
-
}
|
|
402
|
-
// Copy individual files (settings.json is generated fresh with our template)
|
|
403
|
-
const individualFiles = ['mcp.json', 'statusline.sh'];
|
|
404
|
-
for (const file of individualFiles) {
|
|
405
|
-
const srcFile = path.join(packageClaudeDir, file);
|
|
406
|
-
const destFile = path.join(claudeDir, file);
|
|
407
|
-
if (fs.existsSync(srcFile)) {
|
|
408
|
-
fs.copyFileSync(srcFile, destFile);
|
|
409
|
-
console.log(`✅ Copied .claude/${file}`);
|
|
410
|
-
totalFiles++;
|
|
411
|
-
}
|
|
412
|
-
}
|
|
413
|
-
console.log(`\n📊 Total: ${totalFiles} files copied`);
|
|
414
|
-
}
|
|
415
|
-
else {
|
|
416
|
-
// Minimal mode: create basic structure
|
|
417
|
-
console.log('📦 Creating minimal .claude/ structure...\n');
|
|
418
|
-
if (!fs.existsSync(claudeDir)) {
|
|
419
|
-
fs.mkdirSync(claudeDir, { recursive: true });
|
|
420
|
-
}
|
|
421
|
-
const dirs = ['agents', 'commands', 'skills', 'helpers'];
|
|
422
|
-
for (const dir of dirs) {
|
|
423
|
-
const dirPath = path.join(claudeDir, dir);
|
|
424
|
-
if (!fs.existsSync(dirPath)) {
|
|
425
|
-
fs.mkdirSync(dirPath, { recursive: true });
|
|
426
|
-
console.log(`✅ Created .claude/${dir}/`);
|
|
427
|
-
}
|
|
428
|
-
}
|
|
429
|
-
}
|
|
430
|
-
// Always generate fresh settings.json with our template
|
|
431
|
-
const settingsFile = path.join(claudeDir, 'settings.json');
|
|
432
|
-
if (!fs.existsSync(settingsFile) || options.force) {
|
|
433
|
-
fs.writeFileSync(settingsFile, JSON.stringify(SETTINGS_TEMPLATE, null, 2));
|
|
434
|
-
console.log('✅ Created .claude/settings.json (with hooks, agents, skills, statusline)');
|
|
435
|
-
}
|
|
436
|
-
// Create CLAUDE.md in project root (unless minimal mode)
|
|
437
|
-
if (!options.minimal) {
|
|
438
|
-
if (!fs.existsSync(claudeMdFile) || options.force) {
|
|
439
|
-
fs.writeFileSync(claudeMdFile, CLAUDE_MD_TEMPLATE);
|
|
440
|
-
console.log('✅ Created CLAUDE.md');
|
|
441
|
-
}
|
|
442
|
-
else {
|
|
443
|
-
console.log('ℹ️ CLAUDE.md already exists (skipped)');
|
|
444
|
-
}
|
|
445
|
-
}
|
|
446
|
-
console.log(`
|
|
447
|
-
╔═══════════════════════════════════════════════════════╗
|
|
448
|
-
║ Initialization Complete! ║
|
|
449
|
-
╚═══════════════════════════════════════════════════════╝
|
|
450
|
-
|
|
451
|
-
📁 Created structure:
|
|
452
|
-
.claude/
|
|
453
|
-
├── settings.json # Claude Code settings (hooks, agents, skills, statusline)
|
|
454
|
-
├── statusline.sh # Custom statusline (model, tokens, cost, swarm status)
|
|
455
|
-
├── agents/ # 80+ agent definitions (coder, tester, reviewer, etc.)
|
|
456
|
-
├── commands/ # 100+ slash commands (swarm, github, sparc, etc.)
|
|
457
|
-
├── skills/ # Custom skills and workflows
|
|
458
|
-
└── helpers/ # Helper utilities
|
|
459
|
-
CLAUDE.md # Project instructions
|
|
460
|
-
|
|
461
|
-
🚀 Next steps:
|
|
462
|
-
1. Start the MCP server:
|
|
463
|
-
npx agentic-flow@alpha mcp start
|
|
464
|
-
|
|
465
|
-
2. Run Claude Code:
|
|
466
|
-
claude
|
|
467
|
-
|
|
468
|
-
3. Or run agents directly:
|
|
469
|
-
npx agentic-flow@alpha --agent coder --task "Your task"
|
|
470
|
-
|
|
471
|
-
📖 Documentation:
|
|
472
|
-
https://github.com/ruvnet/agentic-flow
|
|
473
|
-
`);
|
|
474
|
-
}
|
|
475
|
-
catch (error) {
|
|
476
|
-
console.error('❌ Initialization failed:', error);
|
|
477
|
-
process.exit(1);
|
|
478
|
-
}
|
|
479
|
-
}
|
|
480
|
-
function printInitHelp() {
|
|
481
|
-
console.log(`
|
|
482
|
-
Agentic Flow - Project Initialization
|
|
483
|
-
|
|
484
|
-
USAGE:
|
|
485
|
-
npx agentic-flow@alpha init [OPTIONS]
|
|
486
|
-
|
|
487
|
-
OPTIONS:
|
|
488
|
-
--force, -f Overwrite existing configuration
|
|
489
|
-
--minimal, -m Create minimal setup (empty directories only)
|
|
490
|
-
--verbose, -v Show detailed file copy output
|
|
491
|
-
--help, -h Show this help
|
|
492
|
-
|
|
493
|
-
EXAMPLES:
|
|
494
|
-
npx agentic-flow@alpha init # Initialize with full agent/command library
|
|
495
|
-
npx agentic-flow@alpha init --force # Reinitialize (overwrite existing)
|
|
496
|
-
npx agentic-flow@alpha init --minimal # Minimal setup (empty directories)
|
|
497
|
-
npx agentic-flow@alpha init --verbose # Show all files being copied
|
|
498
|
-
|
|
499
|
-
CREATED FILES:
|
|
500
|
-
.claude/ Claude Code configuration directory
|
|
501
|
-
.claude/settings.json Settings with hooks, agents, skills, statusline, MCP servers
|
|
502
|
-
.claude/agents/ 80+ agent definitions (coder, tester, reviewer, sparc, etc.)
|
|
503
|
-
.claude/commands/ 100+ slash commands (swarm, github, sparc, etc.)
|
|
504
|
-
.claude/skills/ Custom skills and workflows
|
|
505
|
-
.claude/helpers/ Helper utilities
|
|
506
|
-
CLAUDE.md Project instructions for Claude
|
|
507
|
-
`);
|
|
508
|
-
}
|
|
509
|
-
// Run if executed directly
|
|
510
|
-
if (process.argv[1]?.endsWith('init.js') || process.argv[1]?.endsWith('init.ts')) {
|
|
511
|
-
const args = process.argv.slice(2);
|
|
512
|
-
handleInitCommand(args);
|
|
513
|
-
}
|
|
514
|
-
//# sourceMappingURL=init.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n/**\n * CLI Init Command\n * Creates .claude/ folder structure and configuration files for Claude Code integration\n * Copies all agents, commands, skills, and helpers from the package\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst CLAUDE_MD_TEMPLATE = `# Claude Code Configuration - Agentic Flow\n\n## 🚨 CRITICAL: CONCURRENT EXECUTION & FILE MANAGEMENT\n\n**ABSOLUTE RULES**:\n1. ALL operations MUST be concurrent/parallel in a single message\n2. **NEVER save working files, text/mds and tests to the root folder**\n3. ALWAYS organize files in appropriate subdirectories\n4. **USE CLAUDE CODE'S TASK TOOL** for spawning agents concurrently, not just MCP\n\n### ⚡ GOLDEN RULE: \"1 MESSAGE = ALL RELATED OPERATIONS\"\n\n**MANDATORY PATTERNS:**\n- **TodoWrite**: ALWAYS batch ALL todos in ONE call (5-10+ todos minimum)\n- **Task tool (Claude Code)**: ALWAYS spawn ALL agents in ONE message with full instructions\n- **File operations**: ALWAYS batch ALL reads/writes/edits in ONE message\n- **Bash commands**: ALWAYS batch ALL terminal operations in ONE message\n- **Memory operations**: ALWAYS batch ALL memory store/retrieve in ONE message\n\n### 🎯 CRITICAL: Claude Code Task Tool for Agent Execution\n\n**Claude Code's Task tool is the PRIMARY way to spawn agents:**\n\\`\\`\\`javascript\n// ✅ CORRECT: Use Claude Code's Task tool for parallel agent execution\n[Single Message]:\n Task(\"Research agent\", \"Analyze requirements and patterns...\", \"researcher\")\n Task(\"Coder agent\", \"Implement core features...\", \"coder\")\n Task(\"Tester agent\", \"Create comprehensive tests...\", \"tester\")\n Task(\"Reviewer agent\", \"Review code quality...\", \"reviewer\")\n Task(\"Architect agent\", \"Design system architecture...\", \"system-architect\")\n\\`\\`\\`\n\n**MCP tools are ONLY for coordination setup:**\n- \\`mcp__claude-flow__swarm_init\\` - Initialize coordination topology\n- \\`mcp__claude-flow__agent_spawn\\` - Define agent types for coordination\n- \\`mcp__claude-flow__task_orchestrate\\` - Orchestrate high-level workflows\n\n### 📁 File Organization Rules\n\n**NEVER save to root folder. Use these directories:**\n- \\`/src\\` - Source code files\n- \\`/tests\\` - Test files\n- \\`/docs\\` - Documentation and markdown files\n- \\`/config\\` - Configuration files\n- \\`/scripts\\` - Utility scripts\n- \\`/examples\\` - Example code\n\n## 🚀 Quick Start\n\n\\`\\`\\`bash\n# Start MCP server for Claude Code integration\nnpx agentic-flow@alpha mcp start\n\n# Run an agent directly\nnpx agentic-flow@alpha --agent coder --task \"Your task here\"\n\n# List available agents\nnpx agentic-flow@alpha --list\n\\`\\`\\`\n\n## 🚀 Available Agents (54 Total)\n\n### Core Development\n\\`coder\\`, \\`reviewer\\`, \\`tester\\`, \\`planner\\`, \\`researcher\\`\n\n### Swarm Coordination\n\\`hierarchical-coordinator\\`, \\`mesh-coordinator\\`, \\`adaptive-coordinator\\`, \\`collective-intelligence-coordinator\\`, \\`swarm-memory-manager\\`\n\n### Consensus & Distributed\n\\`byzantine-coordinator\\`, \\`raft-manager\\`, \\`gossip-coordinator\\`, \\`consensus-builder\\`, \\`crdt-synchronizer\\`, \\`quorum-manager\\`, \\`security-manager\\`\n\n### Performance & Optimization\n\\`perf-analyzer\\`, \\`performance-benchmarker\\`, \\`task-orchestrator\\`, \\`memory-coordinator\\`, \\`smart-agent\\`\n\n### GitHub & Repository\n\\`github-modes\\`, \\`pr-manager\\`, \\`code-review-swarm\\`, \\`issue-tracker\\`, \\`release-manager\\`, \\`workflow-automation\\`, \\`project-board-sync\\`, \\`repo-architect\\`, \\`multi-repo-swarm\\`\n\n### SPARC Methodology\n\\`sparc-coord\\`, \\`sparc-coder\\`, \\`specification\\`, \\`pseudocode\\`, \\`architecture\\`, \\`refinement\\`\n\n### Specialized Development\n\\`backend-dev\\`, \\`mobile-dev\\`, \\`ml-developer\\`, \\`cicd-engineer\\`, \\`api-docs\\`, \\`system-architect\\`, \\`code-analyzer\\`, \\`base-template-generator\\`\n\n## 🎯 Claude Code vs MCP Tools\n\n### Claude Code Handles ALL EXECUTION:\n- **Task tool**: Spawn and run agents concurrently for actual work\n- File operations (Read, Write, Edit, MultiEdit, Glob, Grep)\n- Code generation and programming\n- Bash commands and system operations\n- Implementation work\n- Project navigation and analysis\n- TodoWrite and task management\n- Git operations\n- Package management\n- Testing and debugging\n\n### MCP Tools ONLY COORDINATE:\n- Swarm initialization (topology setup)\n- Agent type definitions (coordination patterns)\n- Task orchestration (high-level planning)\n- Memory management\n- Neural features\n- Performance tracking\n- GitHub integration\n\n**KEY**: MCP coordinates the strategy, Claude Code's Task tool executes with real agents.\n\n## MCP Tool Categories\n\n### Coordination\n\\`swarm_init\\`, \\`agent_spawn\\`, \\`task_orchestrate\\`\n\n### Monitoring\n\\`swarm_status\\`, \\`agent_list\\`, \\`agent_metrics\\`, \\`task_status\\`, \\`task_results\\`\n\n### Memory & Neural\n\\`memory_usage\\`, \\`neural_status\\`, \\`neural_train\\`, \\`neural_patterns\\`\n\n### GitHub Integration\n\\`github_swarm\\`, \\`repo_analyze\\`, \\`pr_enhance\\`, \\`issue_triage\\`, \\`code_review\\`\n\n## 🧠 Self-Learning Hooks System\n\n### Available Hooks Commands:\n\\`\\`\\`bash\n# Before editing - get context and agent suggestions\nnpx agentic-flow@alpha hooks pre-edit <filePath>\n\n# After editing - record outcome for learning\nnpx agentic-flow@alpha hooks post-edit <filePath> --success true\n\n# Before commands - assess risk\nnpx agentic-flow@alpha hooks pre-command \"<command>\"\n\n# After commands - record outcome\nnpx agentic-flow@alpha hooks post-command \"<command>\" --success true\n\n# Route task to optimal agent using learned patterns\nnpx agentic-flow@alpha hooks route \"<task description>\"\n\n# Explain routing decision with transparency\nnpx agentic-flow@alpha hooks explain \"<task description>\"\n\n# Bootstrap intelligence from repository\nnpx agentic-flow@alpha hooks pretrain\n\n# Generate optimized agent configs from pretrain data\nnpx agentic-flow@alpha hooks build-agents\n\n# View learning metrics dashboard\nnpx agentic-flow@alpha hooks metrics\n\n# Transfer patterns from another project\nnpx agentic-flow@alpha hooks transfer <sourceProject>\n\n# RuVector intelligence (SONA, MoE, HNSW 150x faster)\nnpx agentic-flow@alpha hooks intelligence\n\\`\\`\\`\n\n### Pretraining System (4-Step Pipeline):\n1. **RETRIEVE** - Top-k memory injection with MMR diversity\n2. **JUDGE** - LLM-as-judge trajectory evaluation\n3. **DISTILL** - Extract strategy memories from trajectories\n4. **CONSOLIDATE** - Dedup, detect contradictions, prune old patterns\n\n## Performance Benefits\n\n- **84.8% SWE-Bench solve rate**\n- **32.3% token reduction**\n- **2.8-4.4x speed improvement**\n- **27+ neural models**\n\n## Advanced Features (v2.0.0)\n\n- 🚀 Automatic Topology Selection\n- ⚡ Parallel Execution (2.8-4.4x speed)\n- 🧠 Neural Training\n- 📊 Bottleneck Analysis\n- 🤖 Smart Auto-Spawning\n- 🛡️ Self-Healing Workflows\n- 💾 Cross-Session Memory\n- 🔗 GitHub Integration\n\n## Code Style & Best Practices\n\n- **Modular Design**: Files under 500 lines\n- **Environment Safety**: Never hardcode secrets\n- **Test-First**: Write tests before implementation\n- **Clean Architecture**: Separate concerns\n- **Documentation**: Keep updated\n\n## Support\n\n- Documentation: https://github.com/ruvnet/agentic-flow\n- Issues: https://github.com/ruvnet/agentic-flow/issues\n\n---\n\nRemember: **Agentic Flow coordinates, Claude Code creates!**\n\n# important-instruction-reminders\nDo what has been asked; nothing more, nothing less.\nNEVER create files unless they're absolutely necessary for achieving your goal.\nALWAYS prefer editing an existing file to creating a new one.\nNEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.\nNever save working files, text/mds and tests to the root folder.\n`;\n\nconst SETTINGS_TEMPLATE = {\n model: \"claude-sonnet-4-20250514\",\n customInstructions: \"Follow the project's CLAUDE.md guidelines. Use concurrent execution for all operations.\",\n env: {\n AGENTIC_FLOW_INTELLIGENCE: \"true\",\n AGENTIC_FLOW_LEARNING_RATE: \"0.1\",\n AGENTIC_FLOW_EPSILON: \"0.1\",\n AGENTIC_FLOW_MEMORY_BACKEND: \"agentdb\"\n },\n permissions: {\n allowedTools: [\"Read\", \"Write\", \"Edit\", \"Bash\", \"Glob\", \"Grep\", \"Task\", \"WebFetch\", \"WebSearch\", \"TodoWrite\", \"LSP\", \"NotebookEdit\"],\n deniedTools: [],\n allow: [\n \"Bash(npx:*)\",\n \"Bash(agentic-flow:*)\",\n \"Bash(npm run:*)\",\n \"mcp__agentic-flow\",\n \"mcp__claude-flow\",\n \"mcp__ruv-swarm\"\n ]\n },\n hooks: {\n PreToolUse: [\n {\n matcher: \"Edit|Write|MultiEdit\",\n hooks: [{ type: \"command\", command: \"npx agentic-flow@alpha hooks pre-edit \\\"$TOOL_INPUT_file_path\\\"\" }]\n },\n {\n matcher: \"Bash\",\n hooks: [{ type: \"command\", command: \"npx agentic-flow@alpha hooks pre-command \\\"$TOOL_INPUT_command\\\"\" }]\n }\n ],\n PostToolUse: [\n {\n matcher: \"Edit|Write|MultiEdit\",\n hooks: [{ type: \"command\", command: \"npx agentic-flow@alpha hooks post-edit \\\"$TOOL_INPUT_file_path\\\" --success\" }]\n },\n {\n matcher: \"Bash\",\n hooks: [{ type: \"command\", command: \"npx agentic-flow@alpha hooks post-command \\\"$TOOL_INPUT_command\\\"\" }]\n }\n ],\n PostToolUseFailure: [\n {\n matcher: \"Edit|Write|MultiEdit\",\n hooks: [{ type: \"command\", command: \"npx agentic-flow@alpha hooks post-edit \\\"$TOOL_INPUT_file_path\\\" --fail --error \\\"$ERROR_MESSAGE\\\"\" }]\n }\n ],\n SessionStart: [\n {\n hooks: [{ type: \"command\", command: \"npx agentic-flow@alpha hooks intelligence stats --json 2>/dev/null || true\" }]\n }\n ],\n SessionEnd: [\n {\n hooks: [{ type: \"command\", command: \"npx agentic-flow@alpha hooks metrics --session --json 2>/dev/null || true\" }]\n }\n ],\n UserPromptSubmit: [\n {\n hooks: [\n { type: \"command\", timeout: 3000, command: \"npx agentic-flow@alpha hooks route \\\"$USER_PROMPT\\\" --json 2>/dev/null || true\" }\n ]\n }\n ],\n Stop: [\n {\n matcher: \".*\",\n hooks: [{ type: \"command\", command: \"npx agentic-flow@alpha hooks metrics --session 2>/dev/null || true\" }]\n }\n ]\n },\n agents: {\n source: \".claude/agents\",\n customAgents: []\n },\n skills: {\n source: \".claude/commands\",\n enabled: true\n },\n statusLine: {\n type: \"command\",\n command: \".claude/statusline.sh\"\n },\n mcpServers: {\n \"claude-flow\": {\n command: \"npx\",\n args: [\"agentic-flow@alpha\", \"mcp\", \"start\"]\n }\n }\n};\n\ninterface InitOptions {\n force?: boolean;\n minimal?: boolean;\n verbose?: boolean;\n}\n\n/**\n * Recursively copy a directory\n */\nfunction copyDirRecursive(src: string, dest: string, verbose: boolean = false): number {\n let fileCount = 0;\n\n if (!fs.existsSync(src)) {\n return fileCount;\n }\n\n if (!fs.existsSync(dest)) {\n fs.mkdirSync(dest, { recursive: true });\n }\n\n const entries = fs.readdirSync(src, { withFileTypes: true });\n\n for (const entry of entries) {\n const srcPath = path.join(src, entry.name);\n const destPath = path.join(dest, entry.name);\n\n if (entry.isDirectory()) {\n fileCount += copyDirRecursive(srcPath, destPath, verbose);\n } else {\n fs.copyFileSync(srcPath, destPath);\n fileCount++;\n if (verbose) {\n console.log(` 📄 ${path.relative(dest, destPath)}`);\n }\n }\n }\n\n return fileCount;\n}\n\n/**\n * Find the package's .claude directory\n */\nfunction findPackageClaudeDir(): string | null {\n // Try multiple potential locations\n const potentialPaths = [\n // When running from dist/\n path.resolve(__dirname, '..', '..', '..', '.claude'),\n // When running from src/\n path.resolve(__dirname, '..', '..', '.claude'),\n // When installed as package\n path.resolve(__dirname, '..', '.claude'),\n // Fallback to package root\n path.resolve(process.cwd(), 'node_modules', 'agentic-flow', '.claude'),\n ];\n\n for (const p of potentialPaths) {\n if (fs.existsSync(p) && fs.statSync(p).isDirectory()) {\n return p;\n }\n }\n\n return null;\n}\n\nexport async function handleInitCommand(args: string[]): Promise<void> {\n const options: InitOptions = {\n force: args.includes('--force') || args.includes('-f'),\n minimal: args.includes('--minimal') || args.includes('-m'),\n verbose: args.includes('--verbose') || args.includes('-v')\n };\n\n if (args.includes('--help') || args.includes('-h')) {\n printInitHelp();\n return;\n }\n\n const cwd = process.cwd();\n const claudeDir = path.join(cwd, '.claude');\n const claudeMdFile = path.join(cwd, 'CLAUDE.md');\n\n console.log(`\n╔═══════════════════════════════════════════════════════╗\n║ Agentic Flow - Project Initialization ║\n╚═══════════════════════════════════════════════════════╝\n`);\n\n // Check if already initialized\n if (fs.existsSync(claudeDir) && !options.force) {\n console.log('⚠️ .claude/ directory already exists.');\n console.log(' Use --force to overwrite existing configuration.\\n');\n return;\n }\n\n try {\n // Find the package's .claude directory\n const packageClaudeDir = findPackageClaudeDir();\n\n if (packageClaudeDir && !options.minimal) {\n console.log('📦 Copying full .claude/ structure from agentic-flow package...\\n');\n\n // Copy entire .claude directory structure\n const directories = ['agents', 'commands', 'skills', 'helpers'];\n let totalFiles = 0;\n\n for (const dir of directories) {\n const srcDir = path.join(packageClaudeDir, dir);\n const destDir = path.join(claudeDir, dir);\n\n if (fs.existsSync(srcDir)) {\n const count = copyDirRecursive(srcDir, destDir, options.verbose);\n totalFiles += count;\n console.log(`✅ Copied .claude/${dir}/ (${count} files)`);\n }\n }\n\n // Copy individual files (settings.json is generated fresh with our template)\n const individualFiles = ['mcp.json', 'statusline.sh'];\n for (const file of individualFiles) {\n const srcFile = path.join(packageClaudeDir, file);\n const destFile = path.join(claudeDir, file);\n if (fs.existsSync(srcFile)) {\n fs.copyFileSync(srcFile, destFile);\n console.log(`✅ Copied .claude/${file}`);\n totalFiles++;\n }\n }\n\n console.log(`\\n📊 Total: ${totalFiles} files copied`);\n } else {\n // Minimal mode: create basic structure\n console.log('📦 Creating minimal .claude/ structure...\\n');\n\n if (!fs.existsSync(claudeDir)) {\n fs.mkdirSync(claudeDir, { recursive: true });\n }\n\n const dirs = ['agents', 'commands', 'skills', 'helpers'];\n for (const dir of dirs) {\n const dirPath = path.join(claudeDir, dir);\n if (!fs.existsSync(dirPath)) {\n fs.mkdirSync(dirPath, { recursive: true });\n console.log(`✅ Created .claude/${dir}/`);\n }\n }\n }\n\n // Always generate fresh settings.json with our template\n const settingsFile = path.join(claudeDir, 'settings.json');\n if (!fs.existsSync(settingsFile) || options.force) {\n fs.writeFileSync(settingsFile, JSON.stringify(SETTINGS_TEMPLATE, null, 2));\n console.log('✅ Created .claude/settings.json (with hooks, agents, skills, statusline)');\n }\n\n // Create CLAUDE.md in project root (unless minimal mode)\n if (!options.minimal) {\n if (!fs.existsSync(claudeMdFile) || options.force) {\n fs.writeFileSync(claudeMdFile, CLAUDE_MD_TEMPLATE);\n console.log('✅ Created CLAUDE.md');\n } else {\n console.log('ℹ️ CLAUDE.md already exists (skipped)');\n }\n }\n\n console.log(`\n╔═══════════════════════════════════════════════════════╗\n║ Initialization Complete! ║\n╚═══════════════════════════════════════════════════════╝\n\n📁 Created structure:\n .claude/\n ├── settings.json # Claude Code settings (hooks, agents, skills, statusline)\n ├── statusline.sh # Custom statusline (model, tokens, cost, swarm status)\n ├── agents/ # 80+ agent definitions (coder, tester, reviewer, etc.)\n ├── commands/ # 100+ slash commands (swarm, github, sparc, etc.)\n ├── skills/ # Custom skills and workflows\n └── helpers/ # Helper utilities\n CLAUDE.md # Project instructions\n\n🚀 Next steps:\n 1. Start the MCP server:\n npx agentic-flow@alpha mcp start\n\n 2. Run Claude Code:\n claude\n\n 3. Or run agents directly:\n npx agentic-flow@alpha --agent coder --task \"Your task\"\n\n📖 Documentation:\n https://github.com/ruvnet/agentic-flow\n`);\n\n } catch (error) {\n console.error('❌ Initialization failed:', error);\n process.exit(1);\n }\n}\n\nfunction printInitHelp(): void {\n console.log(`\nAgentic Flow - Project Initialization\n\nUSAGE:\n npx agentic-flow@alpha init [OPTIONS]\n\nOPTIONS:\n --force, -f Overwrite existing configuration\n --minimal, -m Create minimal setup (empty directories only)\n --verbose, -v Show detailed file copy output\n --help, -h Show this help\n\nEXAMPLES:\n npx agentic-flow@alpha init # Initialize with full agent/command library\n npx agentic-flow@alpha init --force # Reinitialize (overwrite existing)\n npx agentic-flow@alpha init --minimal # Minimal setup (empty directories)\n npx agentic-flow@alpha init --verbose # Show all files being copied\n\nCREATED FILES:\n .claude/ Claude Code configuration directory\n .claude/settings.json Settings with hooks, agents, skills, statusline, MCP servers\n .claude/agents/ 80+ agent definitions (coder, tester, reviewer, sparc, etc.)\n .claude/commands/ 100+ slash commands (swarm, github, sparc, etc.)\n .claude/skills/ Custom skills and workflows\n .claude/helpers/ Helper utilities\n CLAUDE.md Project instructions for Claude\n`);\n}\n\n// Run if executed directly\nif (process.argv[1]?.endsWith('init.js') || process.argv[1]?.endsWith('init.ts')) {\n const args = process.argv.slice(2);\n handleInitCommand(args);\n}\n"]}
|
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* CLI Commands for Background Workers
|
|
4
|
-
* Provides CLI interface for worker management
|
|
5
|
-
*/
|
|
6
|
-
import { Command } from 'commander';
|
|
7
|
-
export declare function createWorkersCommand(): Command;
|
|
8
|
-
export default createWorkersCommand;
|
|
9
|
-
//# sourceMappingURL=workers.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/workers.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,oBAAoB,IAAI,OAAO,CAs2B9C;AAsLD,eAAe,oBAAoB,CAAC"}
|