@cleocode/adapters 2026.9.8 → 2026.9.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.9.8",
+  "version": "2026.9.9",
   "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.9.8",
-    "@cleocode/caamp": "2026.9.8",
-    "@cleocode/paths": "2026.9.8"
+    "@cleocode/paths": "2026.9.9",
+    "@cleocode/caamp": "2026.9.9",
+    "@cleocode/contracts": "2026.9.9"
   },
   "license": "MIT",
   "engines": {
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@types/node": "^24.3.0",
     "vitest": "^4.1.4",
-    "@cleocode/playbooks": "2026.9.8"
+    "@cleocode/playbooks": "2026.9.9"
   },
   "repository": {
     "type": "git",

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

@@ -17,7 +17,7 @@ import {
   ClaudeCodeSpawnProvider,
   createClaudeCodeAdapter as createAdapter,
 } from '@cleocode/adapters';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 describe('ClaudeCodeAdapter — integration', () => {
   let adapter: ClaudeCodeAdapter;
@@ -155,9 +155,19 @@ describe('ClaudeCodeInstallProvider — integration', () => {
     install = new ClaudeCodeInstallProvider();
     testDir = join(tmpdir(), `cleo-adapter-test-${Date.now()}`);
     mkdirSync(testDir, { recursive: true });
+    const fixtureHome = join(testDir, 'fixture-home');
+    vi.stubEnv('HOME', fixtureHome);
+    vi.stubEnv('USERPROFILE', fixtureHome);
+    vi.stubEnv('CLEO_HOME', join(fixtureHome, '.cleo'));
+    mkdirSync(join(fixtureHome, '.cleo', 'templates'), { recursive: true });
+    writeFileSync(
+      join(fixtureHome, '.cleo', 'templates', 'CLEO-INJECTION.md'),
+      'Fixture protocol: inspect authority and coverage.',
+    );
   });
 
   afterEach(() => {
+    vi.unstubAllEnvs();
     try {
       rmSync(testDir, { recursive: true, force: true });
     } catch {
@@ -165,15 +175,15 @@ describe('ClaudeCodeInstallProvider — integration', () => {
     }
   });
 
-  it('creates CLAUDE.md with @-references', async () => {
+  it('creates CLAUDE.md with embedded protocol', async () => {
     await install.ensureInstructionReferences(testDir);
     const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
-    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
-    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
-    expect(content).toContain('@.cleo/memory-bridge.md');
+    expect(content).toContain('Fixture protocol: inspect authority and coverage.');
+    expect(content).toContain('Project memory bridge unavailable.');
+    expect(content).not.toContain('@.cleo/memory-bridge.md');
   });
 
-  it('appends missing references to existing CLAUDE.md', async () => {
+  it('embeds protocol while preserving existing CLAUDE.md', async () => {
     const existing = '# Project\n@AGENTS.md\n';
     writeFileSync(join(testDir, 'CLAUDE.md'), existing, 'utf-8');
 
@@ -181,23 +191,24 @@ describe('ClaudeCodeInstallProvider — integration', () => {
     const content = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
     expect(content).toContain('# Project');
     expect(content).toContain('@AGENTS.md');
-    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
-    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
-    expect(content).toContain('@.cleo/memory-bridge.md');
+    expect(content).toContain('Fixture protocol: inspect authority and coverage.');
+    expect(content).toContain('Project memory bridge unavailable.');
+    expect(content).not.toContain('@.cleo/memory-bridge.md');
   });
 
   it('is idempotent — calling twice does not duplicate the CAAMP block', async () => {
     // First call creates the CAAMP-managed block
     await install.ensureInstructionReferences(testDir);
     const firstContent = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
-    const firstCount = (firstContent.match(/@~\/.+\/CLEO-INJECTION\.md/g) ?? []).length;
+    const firstCount = (firstContent.match(/<!-- CAAMP:START -->/g) ?? []).length;
     expect(firstCount).toBe(1);
 
     // Second call must be idempotent — CAAMP detects existing block and returns 'intact'
     await install.ensureInstructionReferences(testDir);
     const secondContent = readFileSync(join(testDir, 'CLAUDE.md'), 'utf-8');
-    const secondCount = (secondContent.match(/@~\/.+\/CLEO-INJECTION\.md/g) ?? []).length;
+    const secondCount = (secondContent.match(/<!-- CAAMP:START -->/g) ?? []).length;
     expect(secondCount).toBe(1);
+    expect(secondContent).toBe(firstContent);
   });
 
   it('install returns expected shape', async () => {

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

@@ -16,7 +16,7 @@ import {
   CursorInstallProvider,
   createCursorAdapter as createAdapter,
 } from '@cleocode/adapters';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 describe('CursorAdapter — integration', () => {
   let adapter: CursorAdapter;
@@ -138,9 +138,19 @@ describe('CursorInstallProvider — integration', () => {
     install = new CursorInstallProvider();
     testDir = join(tmpdir(), `cleo-cursor-test-${Date.now()}`);
     mkdirSync(testDir, { recursive: true });
+    const fixtureHome = join(testDir, 'fixture-home');
+    vi.stubEnv('HOME', fixtureHome);
+    vi.stubEnv('USERPROFILE', fixtureHome);
+    vi.stubEnv('CLEO_HOME', join(fixtureHome, '.cleo'));
+    mkdirSync(join(fixtureHome, '.cleo', 'templates'), { recursive: true });
+    writeFileSync(
+      join(fixtureHome, '.cleo', 'templates', 'CLEO-INJECTION.md'),
+      'Fixture protocol: inspect authority and coverage.',
+    );
   });
 
   afterEach(() => {
+    vi.unstubAllEnvs();
     try {
       rmSync(testDir, { recursive: true, force: true });
     } catch {

package/src/__tests__/opencode-adapter.test.ts

@@ -17,7 +17,7 @@ import {
   OpenCodeInstallProvider,
   OpenCodeSpawnProvider,
 } from '@cleocode/adapters';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
 describe('OpenCodeAdapter — integration', () => {
   let adapter: OpenCodeAdapter;
@@ -189,9 +189,19 @@ describe('OpenCodeInstallProvider — integration', () => {
     install = new OpenCodeInstallProvider();
     testDir = join(tmpdir(), `cleo-opencode-test-${Date.now()}`);
     mkdirSync(testDir, { recursive: true });
+    const fixtureHome = join(testDir, 'fixture-home');
+    vi.stubEnv('HOME', fixtureHome);
+    vi.stubEnv('USERPROFILE', fixtureHome);
+    vi.stubEnv('CLEO_HOME', join(fixtureHome, '.cleo'));
+    mkdirSync(join(fixtureHome, '.cleo', 'templates'), { recursive: true });
+    writeFileSync(
+      join(fixtureHome, '.cleo', 'templates', 'CLEO-INJECTION.md'),
+      'Fixture protocol: inspect authority and coverage.',
+    );
   });
 
   afterEach(() => {
+    vi.unstubAllEnvs();
     try {
       rmSync(testDir, { recursive: true, force: true });
     } catch {
@@ -199,24 +209,24 @@ describe('OpenCodeInstallProvider — integration', () => {
     }
   });
 
-  it('creates AGENTS.md with @-references', async () => {
+  it('creates AGENTS.md with embedded protocol', async () => {
     await install.ensureInstructionReferences(testDir);
     const content = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
-    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
-    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
-    expect(content).toContain('@.cleo/memory-bridge.md');
+    expect(content).toContain('Fixture protocol: inspect authority and coverage.');
+    expect(content).toContain('Project memory bridge unavailable.');
+    expect(content).not.toContain('@.cleo/memory-bridge.md');
   });
 
-  it('appends missing references to existing AGENTS.md', async () => {
+  it('embeds protocol while preserving existing AGENTS.md', async () => {
     const existing = '# Project Agents\n\nSome content.\n';
     writeFileSync(join(testDir, 'AGENTS.md'), existing, 'utf-8');
 
     await install.ensureInstructionReferences(testDir);
     const content = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
     expect(content).toContain('# Project Agents');
-    // Structure check: must be a non-empty @~/... path pointing to CLEO-INJECTION.md (OS-agnostic)
-    expect(content).toMatch(/@~\/.+\/CLEO-INJECTION\.md/);
-    expect(content).toContain('@.cleo/memory-bridge.md');
+    expect(content).toContain('Fixture protocol: inspect authority and coverage.');
+    expect(content).toContain('Project memory bridge unavailable.');
+    expect(content).not.toContain('@.cleo/memory-bridge.md');
   });
 
   it('does not duplicate CAAMP block on repeated calls', async () => {
@@ -231,6 +241,7 @@ describe('OpenCodeInstallProvider — integration', () => {
     const afterSecond = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
     const blockCountSecond = (afterSecond.match(/<!-- CAAMP:START -->/g) ?? []).length;
     expect(blockCountSecond).toBe(1);
+    expect(afterSecond).toBe(afterFirst);
   });
 
   it('install returns expected shape', async () => {

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

@@ -17,7 +17,7 @@
  * @epic T1000
  */
 
-import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
@@ -39,6 +39,11 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
     process.env.HOME = fakeHome;
     process.env.USERPROFILE = fakeHome;
     process.env.CLAUDE_HOME = join(fakeHome, '.claude');
+    mkdirSync(join(fakeHome, '.cleo', 'templates'), { recursive: true });
+    writeFileSync(
+      join(fakeHome, '.cleo', 'templates', 'CLEO-INJECTION.md'),
+      'Fixture protocol: inspect authority and coverage.',
+    );
   });
 
   afterEach(() => {

package/src/providers/cursor/__tests__/hooks-install.test.ts

@@ -15,10 +15,10 @@
  * @epic T1000
  */
 
-import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { CursorInstallProvider } from '../install.js';
 
 describe('CursorInstallProvider — PreCompact hook templates', () => {
@@ -26,9 +26,19 @@ describe('CursorInstallProvider — PreCompact hook templates', () => {
 
   beforeEach(() => {
     projectDir = mkdtempSync(join(tmpdir(), 'cleo-cursor-install-'));
+    const fixtureHome = join(projectDir, 'fixture-home');
+    vi.stubEnv('HOME', fixtureHome);
+    vi.stubEnv('USERPROFILE', fixtureHome);
+    vi.stubEnv('CLEO_HOME', join(fixtureHome, '.cleo'));
+    mkdirSync(join(fixtureHome, '.cleo', 'templates'), { recursive: true });
+    writeFileSync(
+      join(fixtureHome, '.cleo', 'templates', 'CLEO-INJECTION.md'),
+      'Fixture protocol: inspect authority and coverage.',
+    );
   });
 
   afterEach(() => {
+    vi.unstubAllEnvs();
     rmSync(projectDir, { recursive: true, force: true });
   });
 

package/src/providers/opencode/__tests__/hooks-install.test.ts

@@ -13,10 +13,10 @@
  * @epic T1000
  */
 
-import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { OpenCodeInstallProvider } from '../install.js';
 
 describe('OpenCodeInstallProvider — PreCompact hook templates', () => {
@@ -24,9 +24,19 @@ describe('OpenCodeInstallProvider — PreCompact hook templates', () => {
 
   beforeEach(() => {
     projectDir = mkdtempSync(join(tmpdir(), 'cleo-opencode-install-'));
+    const fixtureHome = join(projectDir, 'fixture-home');
+    vi.stubEnv('HOME', fixtureHome);
+    vi.stubEnv('USERPROFILE', fixtureHome);
+    vi.stubEnv('CLEO_HOME', join(fixtureHome, '.cleo'));
+    mkdirSync(join(fixtureHome, '.cleo', 'templates'), { recursive: true });
+    writeFileSync(
+      join(fixtureHome, '.cleo', 'templates', 'CLEO-INJECTION.md'),
+      'Fixture protocol: inspect authority and coverage.',
+    );
   });
 
   afterEach(() => {
+    vi.unstubAllEnvs();
     rmSync(projectDir, { recursive: true, force: true });
   });