@cleocode/adapters 2.0.0

package/src/providers/claude-code/__tests__/adapter.test.js

@@ -0,0 +1,249 @@
+/**
+ * Tests for the Claude Code adapter package.
+ *
+ * @task T5240
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { ClaudeCodeAdapter } from '../adapter.js';
+import { ClaudeCodeHookProvider } from '../hooks.js';
+import { ClaudeCodeSpawnProvider } from '../spawn.js';
+import { ClaudeCodeInstallProvider } from '../install.js';
+// Mock child_process for health check and spawn tests
+vi.mock('node:child_process', () => ({
+    exec: vi.fn(),
+    execFile: vi.fn(),
+    spawn: vi.fn(() => ({
+        pid: 12345,
+        unref: vi.fn(),
+        on: vi.fn(),
+    })),
+}));
+vi.mock('node:util', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        promisify: (fn) => {
+            // Return a mock for exec that simulates 'which claude' succeeding
+            return vi.fn().mockResolvedValue({ stdout: '/usr/local/bin/claude', stderr: '' });
+        },
+    };
+});
+vi.mock('node:fs', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        existsSync: vi.fn((path) => {
+            if (typeof path === 'string' && path.includes('.claude'))
+                return true;
+            if (typeof path === 'string' && path.includes('.mcp.json'))
+                return false;
+            if (typeof path === 'string' && path.includes('CLAUDE.md'))
+                return false;
+            return false;
+        }),
+        readFileSync: vi.fn(() => '{}'),
+        writeFileSync: vi.fn(),
+        mkdirSync: vi.fn(),
+    };
+});
+vi.mock('node:fs/promises', () => ({
+    writeFile: vi.fn().mockResolvedValue(undefined),
+    unlink: vi.fn().mockResolvedValue(undefined),
+}));
+describe('ClaudeCodeAdapter', () => {
+    let adapter;
+    beforeEach(() => {
+        adapter = new ClaudeCodeAdapter();
+    });
+    afterEach(async () => {
+        if (adapter.isInitialized()) {
+            await adapter.dispose();
+        }
+        vi.restoreAllMocks();
+    });
+    describe('identity', () => {
+        it('has correct id', () => {
+            expect(adapter.id).toBe('claude-code');
+        });
+        it('has correct name', () => {
+            expect(adapter.name).toBe('Claude Code');
+        });
+        it('has correct version', () => {
+            expect(adapter.version).toBe('1.0.0');
+        });
+    });
+    describe('capabilities', () => {
+        it('supports hooks', () => {
+            expect(adapter.capabilities.supportsHooks).toBe(true);
+        });
+        it('supports spawn', () => {
+            expect(adapter.capabilities.supportsSpawn).toBe(true);
+        });
+        it('supports install', () => {
+            expect(adapter.capabilities.supportsInstall).toBe(true);
+        });
+        it('supports MCP', () => {
+            expect(adapter.capabilities.supportsMcp).toBe(true);
+        });
+        it('supports instruction files with CLAUDE.md pattern', () => {
+            expect(adapter.capabilities.supportsInstructionFiles).toBe(true);
+            expect(adapter.capabilities.instructionFilePattern).toBe('CLAUDE.md');
+        });
+        it('declares expected hook events', () => {
+            expect(adapter.capabilities.supportedHookEvents).toContain('onSessionStart');
+            expect(adapter.capabilities.supportedHookEvents).toContain('onSessionEnd');
+            expect(adapter.capabilities.supportedHookEvents).toContain('onToolComplete');
+        });
+    });
+    describe('sub-providers', () => {
+        it('provides a hook provider', () => {
+            expect(adapter.hooks).toBeInstanceOf(ClaudeCodeHookProvider);
+        });
+        it('provides a spawn provider', () => {
+            expect(adapter.spawn).toBeInstanceOf(ClaudeCodeSpawnProvider);
+        });
+        it('provides an install provider', () => {
+            expect(adapter.install).toBeInstanceOf(ClaudeCodeInstallProvider);
+        });
+    });
+    describe('initialize', () => {
+        it('sets initialized state', async () => {
+            expect(adapter.isInitialized()).toBe(false);
+            await adapter.initialize('/tmp/test-project');
+            expect(adapter.isInitialized()).toBe(true);
+        });
+        it('stores project directory', async () => {
+            await adapter.initialize('/tmp/test-project');
+            expect(adapter.getProjectDir()).toBe('/tmp/test-project');
+        });
+    });
+    describe('dispose', () => {
+        it('resets initialized state', async () => {
+            await adapter.initialize('/tmp/test-project');
+            await adapter.dispose();
+            expect(adapter.isInitialized()).toBe(false);
+            expect(adapter.getProjectDir()).toBeNull();
+        });
+    });
+    describe('healthCheck', () => {
+        it('returns unhealthy when not initialized', async () => {
+            const status = await adapter.healthCheck();
+            expect(status.healthy).toBe(false);
+            expect(status.provider).toBe('claude-code');
+            expect(status.details?.error).toBe('Adapter not initialized');
+        });
+        it('returns health status with provider id', async () => {
+            await adapter.initialize('/tmp/test-project');
+            const status = await adapter.healthCheck();
+            expect(status.provider).toBe('claude-code');
+            expect(typeof status.healthy).toBe('boolean');
+        });
+    });
+});
+describe('ClaudeCodeHookProvider', () => {
+    let hooks;
+    beforeEach(() => {
+        hooks = new ClaudeCodeHookProvider();
+    });
+    describe('mapProviderEvent', () => {
+        it('maps SessionStart to onSessionStart', () => {
+            expect(hooks.mapProviderEvent('SessionStart')).toBe('onSessionStart');
+        });
+        it('maps PostToolUse to onToolComplete', () => {
+            expect(hooks.mapProviderEvent('PostToolUse')).toBe('onToolComplete');
+        });
+        it('maps UserPromptSubmit to onPromptSubmit', () => {
+            expect(hooks.mapProviderEvent('UserPromptSubmit')).toBe('onPromptSubmit');
+        });
+        it('maps Stop to onSessionEnd', () => {
+            expect(hooks.mapProviderEvent('Stop')).toBe('onSessionEnd');
+        });
+        it('returns null for unknown events', () => {
+            expect(hooks.mapProviderEvent('UnknownEvent')).toBeNull();
+            expect(hooks.mapProviderEvent('')).toBeNull();
+        });
+    });
+    describe('registerNativeHooks', () => {
+        it('marks hooks as registered', async () => {
+            expect(hooks.isRegistered()).toBe(false);
+            await hooks.registerNativeHooks('/tmp/project');
+            expect(hooks.isRegistered()).toBe(true);
+        });
+    });
+    describe('unregisterNativeHooks', () => {
+        it('marks hooks as unregistered', async () => {
+            await hooks.registerNativeHooks('/tmp/project');
+            await hooks.unregisterNativeHooks();
+            expect(hooks.isRegistered()).toBe(false);
+        });
+    });
+    describe('getEventMap', () => {
+        it('returns all mapped events', () => {
+            const map = hooks.getEventMap();
+            expect(Object.keys(map)).toHaveLength(4);
+            expect(map.SessionStart).toBe('onSessionStart');
+            expect(map.PostToolUse).toBe('onToolComplete');
+            expect(map.UserPromptSubmit).toBe('onPromptSubmit');
+            expect(map.Stop).toBe('onSessionEnd');
+        });
+    });
+});
+describe('ClaudeCodeSpawnProvider', () => {
+    let spawn;
+    beforeEach(() => {
+        spawn = new ClaudeCodeSpawnProvider();
+    });
+    describe('canSpawn', () => {
+        it('returns a boolean', async () => {
+            const result = await spawn.canSpawn();
+            expect(typeof result).toBe('boolean');
+        });
+    });
+    describe('listRunning', () => {
+        it('returns empty array when no processes spawned', async () => {
+            const running = await spawn.listRunning();
+            expect(running).toEqual([]);
+        });
+    });
+    describe('terminate', () => {
+        it('handles non-existent instance gracefully', async () => {
+            await expect(spawn.terminate('non-existent')).resolves.toBeUndefined();
+        });
+    });
+});
+describe('ClaudeCodeInstallProvider', () => {
+    let installProvider;
+    beforeEach(() => {
+        installProvider = new ClaudeCodeInstallProvider();
+    });
+    describe('isInstalled', () => {
+        it('returns a boolean', async () => {
+            const result = await installProvider.isInstalled();
+            expect(typeof result).toBe('boolean');
+        });
+    });
+    describe('install', () => {
+        it('returns a success result', async () => {
+            const result = await installProvider.install({
+                projectDir: '/tmp/test-project',
+            });
+            expect(result.success).toBe(true);
+            expect(result.installedAt).toBeTruthy();
+            expect(typeof result.instructionFileUpdated).toBe('boolean');
+            expect(typeof result.mcpRegistered).toBe('boolean');
+        });
+        it('registers MCP when mcpServerPath provided', async () => {
+            const result = await installProvider.install({
+                projectDir: '/tmp/test-project',
+                mcpServerPath: '/path/to/mcp-server.js',
+            });
+            expect(result.mcpRegistered).toBe(true);
+        });
+    });
+    describe('uninstall', () => {
+        it('handles uninstall when not installed', async () => {
+            await expect(installProvider.uninstall()).resolves.toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=adapter.test.js.map

package/src/providers/claude-code/__tests__/adapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.test.js","sourceRoot":"","sources":["adapter.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,sDAAsD;AACtD,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;IACjB,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAClB,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;KACZ,CAAC,CAAC;CACJ,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IAC5C,MAAM,MAAM,GAAG,MAAM,cAAc,EAA8B,CAAC;IAClE,OAAO;QACL,GAAG,MAAM;QACT,SAAS,EAAE,CAAC,EAAW,EAAE,EAAE;YACzB,kEAAkE;YAClE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IAC1C,MAAM,MAAM,GAAG,MAAM,cAAc,EAA4B,CAAC;IAChE,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE;YACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,IAAI,CAAC;YACtE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,OAAO,KAAK,CAAC;YACzE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,OAAO,KAAK,CAAC;YACzE,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QACF,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAC/B,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE;QACtB,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;KACnB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IAC/C,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;CAC7C,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,OAA0B,CAAC;IAE/B,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;YAC5B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;QACD,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;YACxB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;YACxB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;YACxB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC7E,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YAC3E,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACtC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC9C,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC9C,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC9C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,IAAI,KAA6B,CAAC;IAElC,UAAU,CAAC,GAAG,EAAE;QACd,KAAK,GAAG,IAAI,sBAAsB,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC1D,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;YACzC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzC,MAAM,KAAK,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,KAAK,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAC;YAChD,MAAM,KAAK,CAAC,qBAAqB,EAAE,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,KAA8B,CAAC;IAEnC,UAAU,CAAC,GAAG,EAAE;QACd,KAAK,GAAG,IAAI,uBAAuB,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;YACjC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,IAAI,eAA0C,CAAC;IAE/C,UAAU,CAAC,GAAG,EAAE;QACd,eAAe,GAAG,IAAI,yBAAyB,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;YACjC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,CAAC;YACnD,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC;gBAC3C,UAAU,EAAE,mBAAmB;aAChC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,CAAC,OAAO,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7D,MAAM,CAAC,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC;gBAC3C,UAAU,EAAE,mBAAmB;gBAC/B,aAAa,EAAE,wBAAwB;aACxC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/src/providers/claude-code/__tests__/adapter.test.ts

@@ -0,0 +1,291 @@
+/**
+ * Tests for the Claude Code adapter package.
+ *
+ * @task T5240
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { ClaudeCodeAdapter } from '../adapter.js';
+import { ClaudeCodeHookProvider } from '../hooks.js';
+import { ClaudeCodeSpawnProvider } from '../spawn.js';
+import { ClaudeCodeInstallProvider } from '../install.js';
+
+// Mock child_process for health check and spawn tests
+vi.mock('node:child_process', () => ({
+  exec: vi.fn(),
+  execFile: vi.fn(),
+  spawn: vi.fn(() => ({
+    pid: 12345,
+    unref: vi.fn(),
+    on: vi.fn(),
+  })),
+}));
+
+vi.mock('node:util', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('node:util')>();
+  return {
+    ...actual,
+    promisify: (fn: unknown) => {
+      // Return a mock for exec that simulates 'which claude' succeeding
+      return vi.fn().mockResolvedValue({ stdout: '/usr/local/bin/claude', stderr: '' });
+    },
+  };
+});
+
+vi.mock('node:fs', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('node:fs')>();
+  return {
+    ...actual,
+    existsSync: vi.fn((path: string) => {
+      if (typeof path === 'string' && path.includes('.claude')) return true;
+      if (typeof path === 'string' && path.includes('.mcp.json')) return false;
+      if (typeof path === 'string' && path.includes('CLAUDE.md')) return false;
+      return false;
+    }),
+    readFileSync: vi.fn(() => '{}'),
+    writeFileSync: vi.fn(),
+    mkdirSync: vi.fn(),
+  };
+});
+
+vi.mock('node:fs/promises', () => ({
+  writeFile: vi.fn().mockResolvedValue(undefined),
+  unlink: vi.fn().mockResolvedValue(undefined),
+}));
+
+describe('ClaudeCodeAdapter', () => {
+  let adapter: ClaudeCodeAdapter;
+
+  beforeEach(() => {
+    adapter = new ClaudeCodeAdapter();
+  });
+
+  afterEach(async () => {
+    if (adapter.isInitialized()) {
+      await adapter.dispose();
+    }
+    vi.restoreAllMocks();
+  });
+
+  describe('identity', () => {
+    it('has correct id', () => {
+      expect(adapter.id).toBe('claude-code');
+    });
+
+    it('has correct name', () => {
+      expect(adapter.name).toBe('Claude Code');
+    });
+
+    it('has correct version', () => {
+      expect(adapter.version).toBe('1.0.0');
+    });
+  });
+
+  describe('capabilities', () => {
+    it('supports hooks', () => {
+      expect(adapter.capabilities.supportsHooks).toBe(true);
+    });
+
+    it('supports spawn', () => {
+      expect(adapter.capabilities.supportsSpawn).toBe(true);
+    });
+
+    it('supports install', () => {
+      expect(adapter.capabilities.supportsInstall).toBe(true);
+    });
+
+    it('supports MCP', () => {
+      expect(adapter.capabilities.supportsMcp).toBe(true);
+    });
+
+    it('supports instruction files with CLAUDE.md pattern', () => {
+      expect(adapter.capabilities.supportsInstructionFiles).toBe(true);
+      expect(adapter.capabilities.instructionFilePattern).toBe('CLAUDE.md');
+    });
+
+    it('declares expected hook events', () => {
+      expect(adapter.capabilities.supportedHookEvents).toContain('onSessionStart');
+      expect(adapter.capabilities.supportedHookEvents).toContain('onSessionEnd');
+      expect(adapter.capabilities.supportedHookEvents).toContain('onToolComplete');
+    });
+  });
+
+  describe('sub-providers', () => {
+    it('provides a hook provider', () => {
+      expect(adapter.hooks).toBeInstanceOf(ClaudeCodeHookProvider);
+    });
+
+    it('provides a spawn provider', () => {
+      expect(adapter.spawn).toBeInstanceOf(ClaudeCodeSpawnProvider);
+    });
+
+    it('provides an install provider', () => {
+      expect(adapter.install).toBeInstanceOf(ClaudeCodeInstallProvider);
+    });
+  });
+
+  describe('initialize', () => {
+    it('sets initialized state', async () => {
+      expect(adapter.isInitialized()).toBe(false);
+      await adapter.initialize('/tmp/test-project');
+      expect(adapter.isInitialized()).toBe(true);
+    });
+
+    it('stores project directory', async () => {
+      await adapter.initialize('/tmp/test-project');
+      expect(adapter.getProjectDir()).toBe('/tmp/test-project');
+    });
+  });
+
+  describe('dispose', () => {
+    it('resets initialized state', async () => {
+      await adapter.initialize('/tmp/test-project');
+      await adapter.dispose();
+      expect(adapter.isInitialized()).toBe(false);
+      expect(adapter.getProjectDir()).toBeNull();
+    });
+  });
+
+  describe('healthCheck', () => {
+    it('returns unhealthy when not initialized', async () => {
+      const status = await adapter.healthCheck();
+      expect(status.healthy).toBe(false);
+      expect(status.provider).toBe('claude-code');
+      expect(status.details?.error).toBe('Adapter not initialized');
+    });
+
+    it('returns health status with provider id', async () => {
+      await adapter.initialize('/tmp/test-project');
+      const status = await adapter.healthCheck();
+      expect(status.provider).toBe('claude-code');
+      expect(typeof status.healthy).toBe('boolean');
+    });
+  });
+});
+
+describe('ClaudeCodeHookProvider', () => {
+  let hooks: ClaudeCodeHookProvider;
+
+  beforeEach(() => {
+    hooks = new ClaudeCodeHookProvider();
+  });
+
+  describe('mapProviderEvent', () => {
+    it('maps SessionStart to onSessionStart', () => {
+      expect(hooks.mapProviderEvent('SessionStart')).toBe('onSessionStart');
+    });
+
+    it('maps PostToolUse to onToolComplete', () => {
+      expect(hooks.mapProviderEvent('PostToolUse')).toBe('onToolComplete');
+    });
+
+    it('maps UserPromptSubmit to onPromptSubmit', () => {
+      expect(hooks.mapProviderEvent('UserPromptSubmit')).toBe('onPromptSubmit');
+    });
+
+    it('maps Stop to onSessionEnd', () => {
+      expect(hooks.mapProviderEvent('Stop')).toBe('onSessionEnd');
+    });
+
+    it('returns null for unknown events', () => {
+      expect(hooks.mapProviderEvent('UnknownEvent')).toBeNull();
+      expect(hooks.mapProviderEvent('')).toBeNull();
+    });
+  });
+
+  describe('registerNativeHooks', () => {
+    it('marks hooks as registered', async () => {
+      expect(hooks.isRegistered()).toBe(false);
+      await hooks.registerNativeHooks('/tmp/project');
+      expect(hooks.isRegistered()).toBe(true);
+    });
+  });
+
+  describe('unregisterNativeHooks', () => {
+    it('marks hooks as unregistered', async () => {
+      await hooks.registerNativeHooks('/tmp/project');
+      await hooks.unregisterNativeHooks();
+      expect(hooks.isRegistered()).toBe(false);
+    });
+  });
+
+  describe('getEventMap', () => {
+    it('returns all mapped events', () => {
+      const map = hooks.getEventMap();
+      expect(Object.keys(map)).toHaveLength(4);
+      expect(map.SessionStart).toBe('onSessionStart');
+      expect(map.PostToolUse).toBe('onToolComplete');
+      expect(map.UserPromptSubmit).toBe('onPromptSubmit');
+      expect(map.Stop).toBe('onSessionEnd');
+    });
+  });
+});
+
+describe('ClaudeCodeSpawnProvider', () => {
+  let spawn: ClaudeCodeSpawnProvider;
+
+  beforeEach(() => {
+    spawn = new ClaudeCodeSpawnProvider();
+  });
+
+  describe('canSpawn', () => {
+    it('returns a boolean', async () => {
+      const result = await spawn.canSpawn();
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('listRunning', () => {
+    it('returns empty array when no processes spawned', async () => {
+      const running = await spawn.listRunning();
+      expect(running).toEqual([]);
+    });
+  });
+
+  describe('terminate', () => {
+    it('handles non-existent instance gracefully', async () => {
+      await expect(spawn.terminate('non-existent')).resolves.toBeUndefined();
+    });
+  });
+});
+
+describe('ClaudeCodeInstallProvider', () => {
+  let installProvider: ClaudeCodeInstallProvider;
+
+  beforeEach(() => {
+    installProvider = new ClaudeCodeInstallProvider();
+  });
+
+  describe('isInstalled', () => {
+    it('returns a boolean', async () => {
+      const result = await installProvider.isInstalled();
+      expect(typeof result).toBe('boolean');
+    });
+  });
+
+  describe('install', () => {
+    it('returns a success result', async () => {
+      const result = await installProvider.install({
+        projectDir: '/tmp/test-project',
+      });
+      expect(result.success).toBe(true);
+      expect(result.installedAt).toBeTruthy();
+      expect(typeof result.instructionFileUpdated).toBe('boolean');
+      expect(typeof result.mcpRegistered).toBe('boolean');
+    });
+
+    it('registers MCP when mcpServerPath provided', async () => {
+      const result = await installProvider.install({
+        projectDir: '/tmp/test-project',
+        mcpServerPath: '/path/to/mcp-server.js',
+      });
+      expect(result.mcpRegistered).toBe(true);
+    });
+  });
+
+  describe('uninstall', () => {
+    it('handles uninstall when not installed', async () => {
+      await expect(installProvider.uninstall()).resolves.toBeUndefined();
+    });
+  });
+});

package/src/providers/claude-code/adapter.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Claude Code Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Anthropic's Claude Code CLI.
+ * Provides spawn, hooks, and install capabilities for CLEO integration.
+ *
+ * @task T5240
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
+import { ClaudeCodeHookProvider } from './hooks.js';
+import { ClaudeCodeInstallProvider } from './install.js';
+import { ClaudeCodePathProvider } from './paths.js';
+import { ClaudeCodeSpawnProvider } from './spawn.js';
+import { ClaudeCodeTaskSyncProvider } from './task-sync.js';
+import { ClaudeCodeTransportProvider } from './transport.js';
+/**
+ * CLEO provider adapter for Anthropic Claude Code CLI.
+ *
+ * Bridges CLEO's adapter system with Claude Code's native capabilities:
+ * - Hooks: Maps Claude Code events (SessionStart, PostToolUse, etc.) to CAAMP events
+ * - Spawn: Launches subagent processes via the `claude` CLI
+ * - Install: Registers MCP server, instruction files, and brain observation plugin
+ */
+export declare class ClaudeCodeAdapter implements CLEOProviderAdapter {
+    readonly id = "claude-code";
+    readonly name = "Claude Code";
+    readonly version = "1.0.0";
+    capabilities: AdapterCapabilities;
+    hooks: ClaudeCodeHookProvider;
+    spawn: ClaudeCodeSpawnProvider;
+    install: ClaudeCodeInstallProvider;
+    paths: ClaudeCodePathProvider;
+    contextMonitor: ClaudeCodeContextMonitorProvider;
+    transport: ClaudeCodeTransportProvider;
+    taskSync: ClaudeCodeTaskSyncProvider;
+    private projectDir;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * Validates the environment by checking for the Claude CLI
+     * and Claude Code configuration directory.
+     *
+     * @param projectDir - Root directory of the project
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Unregisters hooks and releases any tracked state.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Run a health check to verify Claude Code is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Claude CLI is available in PATH
+     * 3. ~/.claude/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+    /**
+     * Check whether the adapter has been initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project directory this adapter was initialized with.
+     */
+    getProjectDir(): string | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/src/providers/claude-code/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAmB/B;IAEF,KAAK,EAAE,sBAAsB,CAAC;IAC9B,KAAK,EAAE,uBAAuB,CAAC;IAC/B,OAAO,EAAE,yBAAyB,CAAC;IACnC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,cAAc,EAAE,gCAAgC,CAAC;IACjD,SAAS,EAAE,2BAA2B,CAAC;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IAErC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;OAOG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}