@cleocode/adapters 2026.5.49 → 2026.5.50

package/dist/providers/claude-code/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAajG;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAkCtB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,sBAAsB;CAmD/B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAkBjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAkCtB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,sBAAsB;CAmD/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.5.49",
+  "version": "2026.5.50",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -15,9 +15,9 @@
     "@ai-sdk/anthropic": "^3.0.69",
     "@ai-sdk/openai": "^2.0.53",
     "ai": "^6.0.168",
-    "@cleocode/contracts": "2026.5.49",
-    "@cleocode/paths": "2026.5.49",
-    "@cleocode/caamp": "2026.5.49"
+    "@cleocode/caamp": "2026.5.50",
+    "@cleocode/paths": "2026.5.50",
+    "@cleocode/contracts": "2026.5.50"
   },
   "license": "MIT",
   "engines": {
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@types/node": "^22.19.15",
     "vitest": "^4.1.4",
-    "@cleocode/playbooks": "2026.5.49"
+    "@cleocode/playbooks": "2026.5.50"
   },
   "repository": {
     "type": "git",

package/src/__tests__/cant-context.test.ts

@@ -70,7 +70,7 @@ describe('discoverCantFiles', () => {
 describe('resolveThreeTierPaths', () => {
   it('returns project tier pointing to .cleo/cant/', () => {
     const paths = resolveThreeTierPaths('/my/project');
-    expect(paths.project).toBe('/my/project/.cleo/cant');
+    expect(paths.project).toBe(join('/my/project', '.cleo', 'cant'));
   });
 
   it('respects XDG_DATA_HOME for global tier', () => {
@@ -78,7 +78,7 @@ describe('resolveThreeTierPaths', () => {
     process.env['XDG_DATA_HOME'] = '/custom/data';
     try {
       const paths = resolveThreeTierPaths('/my/project');
-      expect(paths.global).toBe('/custom/data/cleo/cant');
+      expect(paths.global).toBe(join('/custom/data', 'cleo', 'cant'));
     } finally {
       if (originalXdg) process.env['XDG_DATA_HOME'] = originalXdg;
       else delete process.env['XDG_DATA_HOME'];
@@ -90,7 +90,7 @@ describe('resolveThreeTierPaths', () => {
     process.env['XDG_CONFIG_HOME'] = '/custom/config';
     try {
       const paths = resolveThreeTierPaths('/my/project');
-      expect(paths.user).toBe('/custom/config/cleo/cant');
+      expect(paths.user).toBe(join('/custom/config', 'cleo', 'cant'));
     } finally {
       if (originalXdg) process.env['XDG_CONFIG_HOME'] = originalXdg;
       else delete process.env['XDG_CONFIG_HOME'];

package/src/providers/claude-code/__tests__/hooks-install.test.ts

@@ -26,15 +26,19 @@ import { ClaudeCodeInstallProvider } from '../install.js';
 describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
   let fakeHome: string;
   let realHome: string | undefined;
+  let realUserProfile: string | undefined;
+  let realClaudeHome: string | undefined;
   let projectDir: string;
 
   beforeEach(() => {
     realHome = process.env.HOME;
+    realUserProfile = process.env.USERPROFILE;
+    realClaudeHome = process.env.CLAUDE_HOME;
     fakeHome = mkdtempSync(join(tmpdir(), 'cleo-claude-install-'));
     projectDir = mkdtempSync(join(tmpdir(), 'cleo-claude-project-'));
     process.env.HOME = fakeHome;
-    // Suppress unused-var lint on Windows (USERPROFILE pathway not exercised here).
-    void fakeHome;
+    process.env.USERPROFILE = fakeHome;
+    process.env.CLAUDE_HOME = join(fakeHome, '.claude');
   });
 
   afterEach(() => {
@@ -43,6 +47,16 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
     } else {
       delete process.env.HOME;
     }
+    if (realUserProfile !== undefined) {
+      process.env.USERPROFILE = realUserProfile;
+    } else {
+      delete process.env.USERPROFILE;
+    }
+    if (realClaudeHome !== undefined) {
+      process.env.CLAUDE_HOME = realClaudeHome;
+    } else {
+      delete process.env.CLAUDE_HOME;
+    }
     rmSync(fakeHome, { recursive: true, force: true });
     rmSync(projectDir, { recursive: true, force: true });
   });

package/src/providers/claude-code/install.ts

@@ -28,6 +28,11 @@ import {
   installProviderHookTemplates,
 } from '../shared/hook-template-installer.js';
 
+/** Resolve Claude Code's config directory, honoring the documented CI override. */
+function getClaudeConfigDir(): string {
+  return process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude');
+}
+
 /** Resolve the commands directory bundled with this adapter. */
 function getAdapterCommandsDir(): string {
   // Works in both ESM (import.meta.url) and compiled output
@@ -110,7 +115,7 @@ export class ClaudeCodeInstallProvider implements AdapterInstallProvider {
    */
   async isInstalled(): Promise<boolean> {
     // Check ~/.claude/settings.json for plugin registration
-    const settingsPath = join(homedir(), '.claude', 'settings.json');
+    const settingsPath = join(getClaudeConfigDir(), 'settings.json');
     if (existsSync(settingsPath)) {
       try {
         const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
@@ -175,8 +180,8 @@ export class ClaudeCodeInstallProvider implements AdapterInstallProvider {
    * @returns Description of what was registered, or null if no change needed
    */
   private registerPlugin(): string | null {
-    const home = homedir();
-    const settingsPath = join(home, '.claude', 'settings.json');
+    const claudeDir = getClaudeConfigDir();
+    const settingsPath = join(claudeDir, 'settings.json');
 
     let settings: Record<string, unknown> = {};
     if (existsSync(settingsPath)) {
@@ -202,7 +207,7 @@ export class ClaudeCodeInstallProvider implements AdapterInstallProvider {
     enabledPlugins[pluginKey] = true;
     settings.enabledPlugins = enabledPlugins;
 
-    mkdirSync(join(home, '.claude'), { recursive: true });
+    mkdirSync(claudeDir, { recursive: true });
     writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
 
     return `Enabled ${pluginKey} in ~/.claude/settings.json`;
@@ -232,8 +237,8 @@ export class ClaudeCodeInstallProvider implements AdapterInstallProvider {
     templates: InstallHookTemplatesResult;
     settingsEntryAdded: boolean;
   } | null {
-    const home = homedir();
-    const hooksDir = join(home, '.claude', 'hooks');
+    const claudeDir = getClaudeConfigDir();
+    const hooksDir = join(claudeDir, 'hooks');
 
     // 1. Copy the bash templates next to each other so `source $SCRIPT_DIR/...` works.
     //    Template copy is best-effort so missing/locked filesystems (CI sandboxes,
@@ -275,8 +280,8 @@ export class ClaudeCodeInstallProvider implements AdapterInstallProvider {
    * @task T1013
    */
   private registerPreCompactHook(shimPath: string): boolean {
-    const home = homedir();
-    const settingsPath = join(home, '.claude', 'settings.json');
+    const claudeDir = getClaudeConfigDir();
+    const settingsPath = join(claudeDir, 'settings.json');
 
     let settings: Record<string, unknown> = {};
     if (existsSync(settingsPath)) {
@@ -321,7 +326,7 @@ export class ClaudeCodeInstallProvider implements AdapterInstallProvider {
     hooks.PreCompact = preCompactEntries;
     settings.hooks = hooks;
 
-    mkdirSync(join(home, '.claude'), { recursive: true });
+    mkdirSync(claudeDir, { recursive: true });
     writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
     return true;
   }