Claude Flow Testing

Claude Flow Testing

Testing module providing TDD London School (mock-first) framework, test utilities, fixtures, mock services, and coverage tracking for Claude Flow V3 development.

Quick Command Reference

This is a library-only module with no direct CLI subcommands. Testing is performed via standard test runners.

Programmatic API

import {
  MockMemoryService,
  MockAgentService,
  MockSwarmService,
  TestFixtures,
  TestRunner,
} from '@claude-flow/testing';

// Create mock services
const mockMemory = new MockMemoryService();
const mockAgent = new MockAgentService();
const mockSwarm = new MockSwarmService();

// Use test fixtures
const fixtures = new TestFixtures();
const testTask = fixtures.createTask({ name: 'test-task' });
const testAgent = fixtures.createAgent({ type: 'coder' });

// TDD London School pattern
describe('UserService', () => {
  const mockDB = new MockDatabase();
  const service = new UserService(mockDB);  // Inject mock

  it('should create user', async () => {
    mockDB.willReturn({ id: '1', name: 'test' });
    const user = await service.create({ name: 'test' });
    expect(user.id).toBe('1');
    expect(mockDB.wasCalledWith('insert', { name: 'test' })).toBe(true);
  });
});

Key Exports

Common Patterns

Mock-First TDD

// 1. Write test with mock
const mockDep = new MockService();
const sut = new SystemUnderTest(mockDep);

// 2. Define expectations
mockDep.willReturn(expectedValue);

// 3. Act
const result = await sut.action();

// 4. Assert
expect(result).toEqual(expected);
expect(mockDep.wasCalled('method')).toBe(true);

Integration Test with Fixtures

const fixtures = new TestFixtures();
const task = fixtures.createTask({ name: 'integration-test' });
const agent = fixtures.createAgent({ type: 'tester' });
// ... run integration test

RAN DDD Context

Bounded Context: DevOps/Tools Related Skills: claude-flow

References

• Complete command reference: See references/commands.md
• Full README
• npm