@cleocode/adapters 2026.3.37 → 2026.3.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.3.37",
+  "version": "2026.3.39",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -11,12 +11,8 @@
       "import": "./dist/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "build:check": "tsc --noEmit"
-  },
   "dependencies": {
-    "@cleocode/contracts": "workspace:*"
+    "@cleocode/contracts": "2026.3.39"
   },
   "license": "MIT",
   "engines": {
@@ -28,5 +24,14 @@
   ],
   "devDependencies": {
     "@types/node": "^22.19.15"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kryptobaseddev/cleo",
+    "directory": "packages/adapters"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:check": "tsc --noEmit"
   }
-}
+}

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

@@ -0,0 +1,10 @@
+/**
+ * Unit tests for @cleocode/adapter-claude-code
+ *
+ * Tests the ClaudeCodeAdapter, ClaudeCodeHookProvider,
+ * ClaudeCodeSpawnProvider, and ClaudeCodeInstallProvider.
+ *
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=claude-code-adapter.test.d.ts.map

package/src/__tests__/claude-code-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-adapter.test.d.ts","sourceRoot":"","sources":["claude-code-adapter.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

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

@@ -0,0 +1,192 @@
+/**
+ * Unit tests for @cleocode/adapter-claude-code
+ *
+ * Tests the ClaudeCodeAdapter, ClaudeCodeHookProvider,
+ * ClaudeCodeSpawnProvider, and ClaudeCodeInstallProvider.
+ *
+ * @task T5240
+ */
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ClaudeCodeAdapter, ClaudeCodeHookProvider, ClaudeCodeInstallProvider, ClaudeCodeSpawnProvider, createClaudeCodeAdapter as createAdapter, } from '@cleocode/adapters';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+describe('ClaudeCodeAdapter', () => {
+    let adapter;
+    beforeEach(() => {
+        adapter = new ClaudeCodeAdapter();
+    });
+    it('has correct identity fields', () => {
+        expect(adapter.id).toBe('claude-code');
+        expect(adapter.name).toBe('Claude Code');
+        expect(adapter.version).toBe('1.0.0');
+    });
+    it('has correct capabilities', () => {
+        expect(adapter.capabilities.supportsHooks).toBe(true);
+        expect(adapter.capabilities.supportsSpawn).toBe(true);
+        expect(adapter.capabilities.supportsInstall).toBe(true);
+        expect(adapter.capabilities.supportsMcp).toBe(true);
+        expect(adapter.capabilities.supportsInstructionFiles).toBe(true);
+        expect(adapter.capabilities.instructionFilePattern).toBe('CLAUDE.md');
+        expect(adapter.capabilities.supportedHookEvents).toContain('onSessionStart');
+        expect(adapter.capabilities.supportedHookEvents).toContain('onSessionEnd');
+        expect(adapter.capabilities.supportedHookEvents).toContain('onToolComplete');
+    });
+    it('exposes hooks, spawn, and install providers', () => {
+        expect(adapter.hooks).toBeInstanceOf(ClaudeCodeHookProvider);
+        expect(adapter.spawn).toBeInstanceOf(ClaudeCodeSpawnProvider);
+        expect(adapter.install).toBeInstanceOf(ClaudeCodeInstallProvider);
+    });
+    it('tracks initialization state', async () => {
+        expect(adapter.isInitialized()).toBe(false);
+        await adapter.initialize('/tmp/test-project');
+        expect(adapter.isInitialized()).toBe(true);
+        expect(adapter.getProjectDir()).toBe('/tmp/test-project');
+    });
+    it('clears state on dispose', async () => {
+        await adapter.initialize('/tmp/test-project');
+        await adapter.dispose();
+        expect(adapter.isInitialized()).toBe(false);
+        expect(adapter.getProjectDir()).toBeNull();
+    });
+    it('reports unhealthy when not initialized', async () => {
+        const health = await adapter.healthCheck();
+        expect(health.healthy).toBe(false);
+        expect(health.provider).toBe('claude-code');
+        expect(health.details?.error).toBe('Adapter not initialized');
+    });
+    it('reports health after initialization', async () => {
+        await adapter.initialize('/tmp/test-project');
+        const health = await adapter.healthCheck();
+        expect(health.provider).toBe('claude-code');
+        // healthy depends on whether `claude` CLI is available in the test env
+        expect(typeof health.healthy).toBe('boolean');
+    });
+});
+describe('ClaudeCodeHookProvider', () => {
+    let hooks;
+    beforeEach(() => {
+        hooks = new ClaudeCodeHookProvider();
+    });
+    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();
+    });
+    it('tracks registration state', async () => {
+        expect(hooks.isRegistered()).toBe(false);
+        await hooks.registerNativeHooks('/tmp/test');
+        expect(hooks.isRegistered()).toBe(true);
+        await hooks.unregisterNativeHooks();
+        expect(hooks.isRegistered()).toBe(false);
+    });
+    it('exposes event map for introspection', () => {
+        const map = hooks.getEventMap();
+        expect(map).toHaveProperty('SessionStart', 'onSessionStart');
+        expect(map).toHaveProperty('PostToolUse', 'onToolComplete');
+        expect(map).toHaveProperty('UserPromptSubmit', 'onPromptSubmit');
+        expect(map).toHaveProperty('Stop', 'onSessionEnd');
+        expect(Object.keys(map)).toHaveLength(4);
+    });
+});
+describe('ClaudeCodeSpawnProvider', () => {
+    let spawn;
+    beforeEach(() => {
+        spawn = new ClaudeCodeSpawnProvider();
+    });
+    it('canSpawn returns boolean', async () => {
+        const result = await spawn.canSpawn();
+        expect(typeof result).toBe('boolean');
+    });
+    it('listRunning returns empty array initially', async () => {
+        const running = await spawn.listRunning();
+        expect(running).toEqual([]);
+    });
+    it('terminate is no-op for unknown instance', async () => {
+        await expect(spawn.terminate('nonexistent')).resolves.toBeUndefined();
+    });
+});
+describe('ClaudeCodeInstallProvider', () => {
+    let install;
+    let testDir;
+    beforeEach(() => {
+        install = new ClaudeCodeInstallProvider();
+        testDir = join(tmpdir(), `cleo-adapter-test-${Date.now()}`);
+        mkdirSync(testDir, { recursive: true });
+    });
+    afterEach(() => {
+        try {
+            rmSync(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // cleanup best-effort
+        }
+    });
+    it('creates CLAUDE.md with @-references', async () => {
+        await install.ensureInstructionReferences(testDir);
+        const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
+        expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+        expect(content).toContain('@.cleo/memory-bridge.md');
+    });
+    it('appends missing references to existing CLAUDE.md', async () => {
+        const existing = '# Project\n@AGENTS.md\n';
+        writeFileSync(join(testDir, 'CLAUDE.md'), existing, 'utf-8');
+        await install.ensureInstructionReferences(testDir);
+        const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
+        expect(content).toContain('# Project');
+        expect(content).toContain('@AGENTS.md');
+        expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+        expect(content).toContain('@.cleo/memory-bridge.md');
+    });
+    it('does not duplicate existing references', async () => {
+        const existing = '@~/.cleo/templates/CLEO-INJECTION.md\n@.cleo/memory-bridge.md\n';
+        writeFileSync(join(testDir, 'CLAUDE.md'), existing, 'utf-8');
+        await install.ensureInstructionReferences(testDir);
+        const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
+        // Should not have duplicated lines
+        const injectionCount = content.split('@~/.cleo/templates/CLEO-INJECTION.md').length - 1;
+        expect(injectionCount).toBe(1);
+    });
+    it('registers MCP server in .mcp.json', async () => {
+        const result = await install.install({
+            projectDir: testDir,
+            mcpServerPath: '/path/to/cleo-mcp.js',
+        });
+        expect(result.success).toBe(true);
+        expect(result.mcpRegistered).toBe(true);
+        expect(result.instructionFileUpdated).toBe(true);
+        const mcpConfig = JSON.parse(readFileSync(join(testDir, '.mcp.json'), 'utf-8'));
+        expect(mcpConfig.mcpServers.cleo).toEqual({
+            command: 'node',
+            args: ['/path/to/cleo-mcp.js'],
+        });
+    });
+    it('uninstall removes MCP server from .mcp.json', async () => {
+        await install.install({
+            projectDir: testDir,
+            mcpServerPath: '/path/to/cleo-mcp.js',
+        });
+        await install.uninstall();
+        const mcpConfig = JSON.parse(readFileSync(join(testDir, '.mcp.json'), 'utf-8'));
+        expect(mcpConfig.mcpServers.cleo).toBeUndefined();
+    });
+});
+describe('createAdapter factory', () => {
+    it('returns a ClaudeCodeAdapter instance', () => {
+        const adapter = createAdapter();
+        expect(adapter).toBeInstanceOf(ClaudeCodeAdapter);
+        expect(adapter.id).toBe('claude-code');
+    });
+});
+//# sourceMappingURL=claude-code-adapter.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-adapter.test.js","sourceRoot":"","sources":["claude-code-adapter.test.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,235 @@
+/**
+ * Unit tests for @cleocode/adapter-claude-code
+ *
+ * Tests the ClaudeCodeAdapter, ClaudeCodeHookProvider,
+ * ClaudeCodeSpawnProvider, and ClaudeCodeInstallProvider.
+ *
+ * @task T5240
+ */
+
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import {
+  ClaudeCodeAdapter,
+  ClaudeCodeHookProvider,
+  ClaudeCodeInstallProvider,
+  ClaudeCodeSpawnProvider,
+  createClaudeCodeAdapter as createAdapter,
+} from '@cleocode/adapters';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+
+describe('ClaudeCodeAdapter', () => {
+  let adapter: ClaudeCodeAdapter;
+
+  beforeEach(() => {
+    adapter = new ClaudeCodeAdapter();
+  });
+
+  it('has correct identity fields', () => {
+    expect(adapter.id).toBe('claude-code');
+    expect(adapter.name).toBe('Claude Code');
+    expect(adapter.version).toBe('1.0.0');
+  });
+
+  it('has correct capabilities', () => {
+    expect(adapter.capabilities.supportsHooks).toBe(true);
+    expect(adapter.capabilities.supportsSpawn).toBe(true);
+    expect(adapter.capabilities.supportsInstall).toBe(true);
+    expect(adapter.capabilities.supportsMcp).toBe(true);
+    expect(adapter.capabilities.supportsInstructionFiles).toBe(true);
+    expect(adapter.capabilities.instructionFilePattern).toBe('CLAUDE.md');
+    expect(adapter.capabilities.supportedHookEvents).toContain('onSessionStart');
+    expect(adapter.capabilities.supportedHookEvents).toContain('onSessionEnd');
+    expect(adapter.capabilities.supportedHookEvents).toContain('onToolComplete');
+  });
+
+  it('exposes hooks, spawn, and install providers', () => {
+    expect(adapter.hooks).toBeInstanceOf(ClaudeCodeHookProvider);
+    expect(adapter.spawn).toBeInstanceOf(ClaudeCodeSpawnProvider);
+    expect(adapter.install).toBeInstanceOf(ClaudeCodeInstallProvider);
+  });
+
+  it('tracks initialization state', async () => {
+    expect(adapter.isInitialized()).toBe(false);
+    await adapter.initialize('/tmp/test-project');
+    expect(adapter.isInitialized()).toBe(true);
+    expect(adapter.getProjectDir()).toBe('/tmp/test-project');
+  });
+
+  it('clears state on dispose', async () => {
+    await adapter.initialize('/tmp/test-project');
+    await adapter.dispose();
+    expect(adapter.isInitialized()).toBe(false);
+    expect(adapter.getProjectDir()).toBeNull();
+  });
+
+  it('reports unhealthy when not initialized', async () => {
+    const health = await adapter.healthCheck();
+    expect(health.healthy).toBe(false);
+    expect(health.provider).toBe('claude-code');
+    expect(health.details?.error).toBe('Adapter not initialized');
+  });
+
+  it('reports health after initialization', async () => {
+    await adapter.initialize('/tmp/test-project');
+    const health = await adapter.healthCheck();
+    expect(health.provider).toBe('claude-code');
+    // healthy depends on whether `claude` CLI is available in the test env
+    expect(typeof health.healthy).toBe('boolean');
+  });
+});
+
+describe('ClaudeCodeHookProvider', () => {
+  let hooks: ClaudeCodeHookProvider;
+
+  beforeEach(() => {
+    hooks = new ClaudeCodeHookProvider();
+  });
+
+  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();
+  });
+
+  it('tracks registration state', async () => {
+    expect(hooks.isRegistered()).toBe(false);
+    await hooks.registerNativeHooks('/tmp/test');
+    expect(hooks.isRegistered()).toBe(true);
+    await hooks.unregisterNativeHooks();
+    expect(hooks.isRegistered()).toBe(false);
+  });
+
+  it('exposes event map for introspection', () => {
+    const map = hooks.getEventMap();
+    expect(map).toHaveProperty('SessionStart', 'onSessionStart');
+    expect(map).toHaveProperty('PostToolUse', 'onToolComplete');
+    expect(map).toHaveProperty('UserPromptSubmit', 'onPromptSubmit');
+    expect(map).toHaveProperty('Stop', 'onSessionEnd');
+    expect(Object.keys(map)).toHaveLength(4);
+  });
+});
+
+describe('ClaudeCodeSpawnProvider', () => {
+  let spawn: ClaudeCodeSpawnProvider;
+
+  beforeEach(() => {
+    spawn = new ClaudeCodeSpawnProvider();
+  });
+
+  it('canSpawn returns boolean', async () => {
+    const result = await spawn.canSpawn();
+    expect(typeof result).toBe('boolean');
+  });
+
+  it('listRunning returns empty array initially', async () => {
+    const running = await spawn.listRunning();
+    expect(running).toEqual([]);
+  });
+
+  it('terminate is no-op for unknown instance', async () => {
+    await expect(spawn.terminate('nonexistent')).resolves.toBeUndefined();
+  });
+});
+
+describe('ClaudeCodeInstallProvider', () => {
+  let install: ClaudeCodeInstallProvider;
+  let testDir: string;
+
+  beforeEach(() => {
+    install = new ClaudeCodeInstallProvider();
+    testDir = join(tmpdir(), `cleo-adapter-test-${Date.now()}`);
+    mkdirSync(testDir, { recursive: true });
+  });
+
+  afterEach(() => {
+    try {
+      rmSync(testDir, { recursive: true, force: true });
+    } catch {
+      // cleanup best-effort
+    }
+  });
+
+  it('creates CLAUDE.md with @-references', async () => {
+    await install.ensureInstructionReferences(testDir);
+    const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
+    expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+    expect(content).toContain('@.cleo/memory-bridge.md');
+  });
+
+  it('appends missing references to existing CLAUDE.md', async () => {
+    const existing = '# Project\n@AGENTS.md\n';
+    writeFileSync(join(testDir, 'CLAUDE.md'), existing, 'utf-8');
+
+    await install.ensureInstructionReferences(testDir);
+    const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
+    expect(content).toContain('# Project');
+    expect(content).toContain('@AGENTS.md');
+    expect(content).toContain('@~/.cleo/templates/CLEO-INJECTION.md');
+    expect(content).toContain('@.cleo/memory-bridge.md');
+  });
+
+  it('does not duplicate existing references', async () => {
+    const existing = '@~/.cleo/templates/CLEO-INJECTION.md\n@.cleo/memory-bridge.md\n';
+    writeFileSync(join(testDir, 'CLAUDE.md'), existing, 'utf-8');
+
+    await install.ensureInstructionReferences(testDir);
+    const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
+    // Should not have duplicated lines
+    const injectionCount = content.split('@~/.cleo/templates/CLEO-INJECTION.md').length - 1;
+    expect(injectionCount).toBe(1);
+  });
+
+  it('registers MCP server in .mcp.json', async () => {
+    const result = await install.install({
+      projectDir: testDir,
+      mcpServerPath: '/path/to/cleo-mcp.js',
+    });
+
+    expect(result.success).toBe(true);
+    expect(result.mcpRegistered).toBe(true);
+    expect(result.instructionFileUpdated).toBe(true);
+
+    const mcpConfig = JSON.parse(readFileSync(join(testDir, '.mcp.json'), 'utf-8'));
+    expect(mcpConfig.mcpServers.cleo).toEqual({
+      command: 'node',
+      args: ['/path/to/cleo-mcp.js'],
+    });
+  });
+
+  it('uninstall removes MCP server from .mcp.json', async () => {
+    await install.install({
+      projectDir: testDir,
+      mcpServerPath: '/path/to/cleo-mcp.js',
+    });
+
+    await install.uninstall();
+
+    const mcpConfig = JSON.parse(readFileSync(join(testDir, '.mcp.json'), 'utf-8'));
+    expect(mcpConfig.mcpServers.cleo).toBeUndefined();
+  });
+});
+
+describe('createAdapter factory', () => {
+  it('returns a ClaudeCodeAdapter instance', () => {
+    const adapter = createAdapter();
+    expect(adapter).toBeInstanceOf(ClaudeCodeAdapter);
+    expect(adapter.id).toBe('claude-code');
+  });
+});

package/src/__tests__/cursor-adapter.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unit tests for @cleocode/adapter-cursor
+ *
+ * Tests the CursorAdapter, CursorHookProvider, and CursorInstallProvider.
+ * Cursor has no spawn support, so no spawn provider tests.
+ *
+ * @task T5240
+ */
+export {};
+//# sourceMappingURL=cursor-adapter.test.d.ts.map

package/src/__tests__/cursor-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-adapter.test.d.ts","sourceRoot":"","sources":["cursor-adapter.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}