Files
ccs/tests/unit/targets/target-registry.test.ts
T
Tam Nhu Tran 7d7054e2c0 feat(targets): add multi-target CLI adapter system (Droid support)
Implement target adapter pattern enabling CCS CLI to support multiple backend targets
(Claude, Droid) via pluggable adapters. Core additions:

- TargetAdapter interface for pluggable target implementations
- ClaudeAdapter and DroidAdapter concrete implementations
- Target registry (singleton Map-based storage)
- Target resolver with precedence: --target flag > per-profile config > busybox detection
- Droid config manager with atomic writes and file locking to ~/.factory/settings.json
- Droid binary detector to validate runtime environment
- Adapter dispatch integrated into ccs.ts main execution flow
- ccsd busybox alias for seamless Droid invocation
- --target flag documentation in help
- Session tracking enriched with target metadata
- Dashboard target badge for visual identification

Testing:
- 43 unit tests covering resolver, registry, config manager, and adapters
- Full coverage of target detection logic and edge cases

Documentation:
- Refactored system-architecture.md into modular docs/system-architecture/ subdirectory
- Updated code-standards.md with target adapter guidelines
- Updated codebase-summary.md with architecture overview
- Updated maintainability baseline (33.8% → 35.2%)

This establishes extensible foundation for multi-target support without breaking
existing Claude workflows. Droid adapter is production-ready but defaults to Claude
for backward compatibility.
2026-02-16 10:49:09 +07:00

141 lines
4.1 KiB
TypeScript

/**
* Unit tests for target registry and adapters
*/
import { describe, it, expect, beforeEach } from 'bun:test';
import {
registerTarget,
getTarget,
getDefaultTarget,
hasTarget,
getRegisteredTargets,
ClaudeAdapter,
DroidAdapter,
} from '../../../src/targets';
describe('target-registry', () => {
beforeEach(() => {
// Re-register adapters (registry is module-scoped singleton)
registerTarget(new ClaudeAdapter());
registerTarget(new DroidAdapter());
});
it('should register and retrieve claude adapter', () => {
const adapter = getTarget('claude');
expect(adapter.type).toBe('claude');
expect(adapter.displayName).toBe('Claude Code');
});
it('should register and retrieve droid adapter', () => {
const adapter = getTarget('droid');
expect(adapter.type).toBe('droid');
expect(adapter.displayName).toBe('Factory Droid');
});
it('should return claude as default target', () => {
const adapter = getDefaultTarget();
expect(adapter.type).toBe('claude');
});
it('should throw for unknown target', () => {
expect(() => getTarget('unknown' as never)).toThrow(/Unknown target "unknown"/);
});
it('should check target existence', () => {
expect(hasTarget('claude')).toBe(true);
expect(hasTarget('droid')).toBe(true);
expect(hasTarget('unknown' as never)).toBe(false);
});
it('should list registered targets', () => {
const targets = getRegisteredTargets();
expect(targets).toContain('claude');
expect(targets).toContain('droid');
});
});
describe('ClaudeAdapter', () => {
const adapter = new ClaudeAdapter();
it('should have correct type and displayName', () => {
expect(adapter.type).toBe('claude');
expect(adapter.displayName).toBe('Claude Code');
});
it('should support all profile types', () => {
expect(adapter.supportsProfileType('account')).toBe(true);
expect(adapter.supportsProfileType('settings')).toBe(true);
expect(adapter.supportsProfileType('cliproxy')).toBe(true);
expect(adapter.supportsProfileType('default')).toBe(true);
expect(adapter.supportsProfileType('copilot')).toBe(true);
});
it('should build env with credentials', () => {
const env = adapter.buildEnv(
{
profile: 'gemini',
baseUrl: 'https://api.example.com',
apiKey: 'test-key',
model: 'claude-opus-4-6',
},
'settings'
);
expect(env['ANTHROPIC_BASE_URL']).toBe('https://api.example.com');
expect(env['ANTHROPIC_AUTH_TOKEN']).toBe('test-key');
expect(env['ANTHROPIC_MODEL']).toBe('claude-opus-4-6');
});
it('should pass through args unchanged', () => {
const args = adapter.buildArgs('gemini', ['-p', 'hello', '--verbose']);
expect(args).toEqual(['-p', 'hello', '--verbose']);
});
it('prepareCredentials should be no-op', async () => {
// Should not throw
await adapter.prepareCredentials({
profile: 'test',
baseUrl: 'x',
apiKey: 'y',
});
});
});
describe('DroidAdapter', () => {
const adapter = new DroidAdapter();
it('should have correct type and displayName', () => {
expect(adapter.type).toBe('droid');
expect(adapter.displayName).toBe('Factory Droid');
});
it('should NOT support account profile type', () => {
expect(adapter.supportsProfileType('account')).toBe(false);
});
it('should support non-account profile types', () => {
expect(adapter.supportsProfileType('settings')).toBe(true);
expect(adapter.supportsProfileType('cliproxy')).toBe(true);
expect(adapter.supportsProfileType('default')).toBe(true);
expect(adapter.supportsProfileType('copilot')).toBe(true);
});
it('should build args with -m custom:ccs- prefix', () => {
const args = adapter.buildArgs('gemini', ['--verbose']);
expect(args).toEqual(['-m', 'custom:ccs-gemini', '--verbose']);
});
it('should build minimal env (no ANTHROPIC_ vars)', () => {
const env = adapter.buildEnv(
{
baseUrl: 'http://localhost:8317',
apiKey: 'dummy',
},
'cliproxy'
);
// Droid uses config file, not env vars
expect(env['ANTHROPIC_BASE_URL']).toBeUndefined();
expect(env['ANTHROPIC_AUTH_TOKEN']).toBeUndefined();
});
});