+----------------+--------+--------+---------+
| Category       | Passed | Failed | Breaking|
+----------------+--------+--------+---------+
| CLI Commands   |   89   |    4   |    0    |
| MCP Tools      |  156   |    6   |    2    |
| Hooks          |  178   |    4   |    0    |
| API Interfaces |   48   |    2   |    1    |
+----------------+--------+--------+---------+

// In your V3 configuration
const server = createMCPServer({
  transport: 'stdio',
  compatibility: {
    v2: true,
    paramTranslation: true,
    deprecationWarnings: true
  }
});

# V2 (deprecated but supported)
npx claude-flow hive-mind init
npx claude-flow hive-mind status

# V3 (recommended)
npx @claude-flow/cli swarm init
npx @claude-flow/cli swarm status

// V2 tool call
const agent = await mcp.callTool('dispatch_agent', {
  type: 'coder',
  name: 'my-agent',
  priority: 8
});

// V3 tool call (with compatibility layer)
const agent = await mcp.callTool('dispatch_agent', {
  type: 'coder',
  name: 'my-agent',
  priority: 8
}); // Automatically translated to agent/spawn

// V3 tool call (native)
const agent = await mcp.callTool('agent/spawn', {
  agentType: 'coder',
  id: 'my-agent',
  priority: 'high'
});

// V2 imports
import { HiveMind } from 'claude-flow/hive-mind';
import { MemoryManager } from 'claude-flow/memory';

// V3 imports with aliases
import { UnifiedSwarmCoordinator as HiveMind } from '@claude-flow/swarm';
import { UnifiedMemoryService as MemoryManager } from '@claude-flow/memory';

// Usage remains the same
const hive = new HiveMind();
await hive.initialize();
const agent = await hive.spawn('coder');

# Run the V3 migration tool
npx @claude-flow/cli migrate --from v2 --to v3

# Migrate configuration
npx @claude-flow/cli migrate config --input .claude-flow/config.yaml

# Migrate memory database
npx @claude-flow/cli migrate memory --input .claude-flow/memory.db

# V2 Configuration (.claude-flow/config.yaml)
orchestrator:
  maxAgents: 10
  defaultStrategy: balanced
memory:
  backend: sqlite
  path: ./.claude-flow/memory.db
coordination:
  topology: hierarchical

# V3 Configuration (.claude-flow/config.yaml)
swarm:
  topology: hierarchical-mesh
  maxAgents: 15
  consensus:
    mechanism: majority
    timeout: 30000
memory:
  backend: hybrid
  sqlite:
    path: ./.claude-flow/memory.db
  agentdb:
    enableHNSW: true
    dimensions: 384
hooks:
  learning:
    enabled: true