@cleocode/adapters 2026.10.3 → 2026.10.5-rc.ci.672

package/src/providers/kimi/install.ts

@@ -14,6 +14,7 @@ import { join } from 'node:path';
 import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 import { getCleoTemplatesTildePath } from '../shared/paths.js';
+import { ensureProjectInstructionFile } from '../shared/project-instruction-file.js';
 
 /**
  * Install provider for Kimi.
@@ -58,15 +59,16 @@ export class KimiInstallProvider implements AdapterInstallProvider {
     const installedAt = new Date().toISOString();
     const details: Record<string, unknown> = {};
 
-    const result = await ensureProviderInstructionFile('kimi', projectDir, {
+    const result = await ensureProjectInstructionFile('kimi', projectDir, {
       references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
       scope: 'project',
     });
 
-    const instructionFileUpdated = result.action !== 'intact';
+    const instructionFileUpdated = result !== null && result.action !== 'intact';
     if (instructionFileUpdated) {
       details.instructionFile = result.filePath;
     }
+    if (result === null) details.instructionFile = 'skipped'; // T13227: $HOME project
 
     return {
       success: true,

package/src/providers/openai-sdk/install.ts

@@ -14,6 +14,7 @@ import { join } from 'node:path';
 import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 import { getCleoTemplatesTildePath } from '../shared/paths.js';
+import { ensureProjectInstructionFile } from '../shared/project-instruction-file.js';
 
 /**
  * Install provider for the OpenAI SDK adapter (Vercel AI SDK).
@@ -40,15 +41,17 @@ export class OpenAiSdkInstallProvider implements AdapterInstallProvider {
     const details: Record<string, unknown> = {};
 
     // Step 1: Ensure AGENTS.md has @-references via CAAMP registry
-    const instructionResult = await ensureProviderInstructionFile('openai-sdk', projectDir, {
+    const instructionResult = await ensureProjectInstructionFile('openai-sdk', projectDir, {
       references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
       scope: 'project',
     });
 
-    const instructionFileUpdated = instructionResult.action !== 'intact';
+    const instructionFileUpdated =
+      instructionResult !== null && instructionResult.action !== 'intact';
     if (instructionFileUpdated) {
       details.instructionFile = instructionResult.filePath;
     }
+    if (instructionResult === null) details.instructionFile = 'skipped'; // T13227: $HOME project
 
     // Step 2: Create .openai config directory stub
     const configCreated = this.ensureConfigDir(projectDir);

package/src/providers/opencode/install.ts

@@ -25,6 +25,7 @@ import {
   installProviderHookTemplates,
 } from '../shared/hook-template-installer.js';
 import { getCleoTemplatesTildePath } from '../shared/paths.js';
+import { ensureProjectInstructionFile } from '../shared/project-instruction-file.js';
 
 /**
  * Install provider for OpenCode.
@@ -57,15 +58,16 @@ export class OpenCodeInstallProvider implements AdapterInstallProvider {
     const details: Record<string, unknown> = {};
 
     // Step 1: Ensure AGENTS.md has @-references via CAAMP canonical API.
-    const instructResult = await ensureProviderInstructionFile('opencode', projectDir, {
+    const instructResult = await ensureProjectInstructionFile('opencode', projectDir, {
       scope: 'project',
       references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
     });
 
-    const instructionFileUpdated = instructResult.action !== 'intact';
+    const instructionFileUpdated = instructResult !== null && instructResult.action !== 'intact';
     if (instructionFileUpdated) {
       details.instructionFile = join(projectDir, instructResult.instructFile);
     }
+    if (instructResult === null) details.instructionFile = 'skipped'; // T13227: $HOME project
 
     // Step 2 (T1013): Install PreCompact hook templates + generate the JS
     // plugin wrapper that spawns the bash shim on

package/src/providers/pi/install.ts

@@ -19,6 +19,7 @@ import { join } from 'node:path';
 import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 import { getCleoTemplatesTildePath } from '../shared/paths.js';
+import { ensureProjectInstructionFile } from '../shared/project-instruction-file.js';
 
 /**
  * CLEO @-references injected into Pi instruction files.
@@ -55,15 +56,16 @@ export class PiInstallProvider implements AdapterInstallProvider {
     const details: Record<string, unknown> = {};
 
     // Step 1: Ensure project AGENTS.md has @-references via CAAMP canonical API.
-    const projectResult = await ensureProviderInstructionFile('pi', projectDir, {
+    const projectResult = await ensureProjectInstructionFile('pi', projectDir, {
       scope: 'project',
       references: getCleoReferences(),
     });
 
-    const projectUpdated = projectResult.action !== 'intact';
+    const projectUpdated = projectResult !== null && projectResult.action !== 'intact';
     if (projectUpdated) {
       details.instructionFile = join(projectDir, projectResult.instructFile);
     }
+    if (projectResult === null) details.instructionFile = 'skipped'; // T13227: $HOME project
 
     // Step 2: Ensure global AGENTS.md has @-references (best-effort).
     // CAAMP resolves pathGlobal from the registry ($HOME/.pi/agent).