@cleocode/adapters 2026.5.37 → 2026.5.40

package/dist/providers/codex/install.d.ts

@@ -2,9 +2,10 @@
  * Codex CLI Install Provider
  *
  * Handles CLEO installation into Codex CLI environments:
- * - Ensures AGENTS.md has CLEO @-references
+ * - Ensures AGENTS.md has CLEO @-references via CAAMP
  *
  * @task T162
+ * @task T9019
  * @epic T134
  */
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
@@ -13,9 +14,10 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  *
  * Manages CLEO's integration with Codex CLI by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *    (delegated to CAAMP's canonical {@link ensureProviderInstructionFile}).
  *
  * @remarks
- * Installation is idempotent -- running install multiple times on the same
+ * Installation is idempotent — running install multiple times on the same
  * project produces the same result. Only AGENTS.md is managed; Codex CLI
  * does not have an MCP or plugin registration mechanism.
  *
@@ -41,25 +43,18 @@ export declare class CodexInstallProvider implements AdapterInstallProvider {
     /**
      * Check whether CLEO is installed in the Codex CLI environment.
      *
-     * Checks for CLEO references in AGENTS.md.
+     * Delegates to CAAMP's instruction-file check.
      * @task T162
      */
     isInstalled(): Promise<boolean>;
     /**
      * Ensure AGENTS.md contains @-references to CLEO instruction files.
      *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     * Delegates to CAAMP's canonical {@link ensureProviderInstructionFile}.
      *
      * @param projectDir - Project root directory
      * @task T162
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @param projectDir - Project root directory
-     * @returns true if the file was created or modified
-     */
-    private updateInstructionFile;
 }
 //# sourceMappingURL=install.d.ts.map

package/dist/providers/codex/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAajG;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}

package/dist/providers/gemini-cli/install.d.ts

@@ -2,21 +2,23 @@
  * Gemini CLI Install Provider
  *
  * Handles CLEO installation into Gemini CLI environments:
- * - Ensures AGENTS.md has CLEO @-references
+ * - Ensures GEMINI.md has CLEO @-references (via CAAMP registry)
  *
  * @task T161
  * @epic T134
+ * @task T9018
  */
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 /**
  * Install provider for Gemini CLI.
  *
  * Manages CLEO's integration with Gemini CLI by:
- * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ * 1. Ensuring GEMINI.md contains @-references to CLEO instruction files
+ *    (via CAAMP registry — single source of truth for instruction file name)
  *
  * @remarks
  * Installation is idempotent -- running install multiple times on the same
- * project produces the same result. Only AGENTS.md is managed; Gemini CLI
+ * project produces the same result. Only GEMINI.md is managed; Gemini CLI
  * does not have an MCP or plugin registration mechanism.
  *
  * @task T161
@@ -34,32 +36,25 @@ export declare class GeminiCliInstallProvider implements AdapterInstallProvider
     /**
      * Uninstall CLEO from the Gemini CLI environment.
      *
-     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     * Does not remove GEMINI.md references (they are harmless if CLEO is not present).
      * @task T161
      */
     uninstall(): Promise<void>;
     /**
      * Check whether CLEO is installed in the Gemini CLI environment.
      *
-     * Checks for CLEO references in AGENTS.md.
+     * Checks for CLEO references in GEMINI.md.
      * @task T161
      */
     isInstalled(): Promise<boolean>;
     /**
-     * Ensure AGENTS.md contains @-references to CLEO instruction files.
+     * Ensure GEMINI.md contains @-references to CLEO instruction files.
      *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     * Creates GEMINI.md if it does not exist. Appends any missing references.
      *
      * @param projectDir - Project root directory
      * @task T161
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @param projectDir - Project root directory
-     * @returns true if the file was created or modified
-     */
-    private updateInstructionFile;
 }
 //# sourceMappingURL=install.d.ts.map

package/dist/providers/gemini-cli/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}

package/dist/providers/kimi/install.d.ts

@@ -2,10 +2,11 @@
  * Kimi Install Provider
  *
  * Handles CLEO installation into Kimi environments:
- * - Ensures AGENTS.md has CLEO @-references
+ * - Ensures AGENTS.md has CLEO @-references (via CAAMP registry)
  *
  * @task T163
  * @epic T134
+ * @task T9018
  */
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 /**
@@ -13,6 +14,7 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  *
  * Manages CLEO's integration with Kimi by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *    (via CAAMP registry — single source of truth for instruction file name)
  *
  * @remarks
  * Installation is idempotent -- running install multiple times on the same
@@ -54,12 +56,5 @@ export declare class KimiInstallProvider implements AdapterInstallProvider {
      * @task T163
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @param projectDir - Project root directory
-     * @returns true if the file was created or modified
-     */
-    private updateInstructionFile;
 }
 //# sourceMappingURL=install.d.ts.map

package/dist/providers/kimi/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}

package/dist/providers/openai-sdk/install.d.ts

@@ -2,10 +2,11 @@
  * OpenAI SDK Install Provider.
  *
  * Handles CLEO installation into OpenAI SDK environments:
- * - Writes an AGENTS.md file with CLEO @-references
+ * - Writes an AGENTS.md file with CLEO @-references (via CAAMP registry)
  * - Creates a `.openai/` config stub if it does not exist
  *
  * @task T582
+ * @task T9018
  */
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 /**
@@ -13,6 +14,7 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  *
  * Manages CLEO's integration with OpenAI SDK projects by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *    (via CAAMP registry — single source of truth for instruction file name)
  * 2. Creating the `.openai/` config directory stub if absent
  *
  * @remarks
@@ -36,7 +38,7 @@ export declare class OpenAiSdkInstallProvider implements AdapterInstallProvider
     /**
      * Check whether CLEO is installed in the current OpenAI SDK environment.
      *
-     * Checks for `@~/.cleo/templates/CLEO-INJECTION.md` in AGENTS.md.
+     * Checks for `@~/.local/share/cleo/templates/CLEO-INJECTION.md` in AGENTS.md.
      */
     isInstalled(): Promise<boolean>;
     /**
@@ -45,12 +47,6 @@ export declare class OpenAiSdkInstallProvider implements AdapterInstallProvider
      * @param projectDir - Project root directory.
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @returns `true` if the file was created or modified.
-     */
-    private updateInstructionFile;
     /**
      * Create the `.openai/` config directory if it does not exist.
      *

package/dist/providers/openai-sdk/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;GAUG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAyB9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAMrC;;;;OAIG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAOxB"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjG;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAMrC;;;;OAIG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAOxB"}

package/dist/providers/opencode/install.d.ts

@@ -2,11 +2,12 @@
  * OpenCode Install Provider
  *
  * Handles CLEO installation into OpenCode environments:
- * - Ensures AGENTS.md has CLEO @-references
+ * - Ensures AGENTS.md has CLEO @-references via CAAMP
  * - Installs PreCompact hook shell shims + a JS plugin wrapper (T1013)
  *
  * @task T5240
  * @task T1013
+ * @task T9019
  */
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 /**
@@ -14,11 +15,12 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  *
  * Manages CLEO's integration with OpenCode by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *    (delegated to CAAMP's canonical {@link ensureProviderInstructionFile}).
  * 2. Installing PreCompact hook shell templates + generating the JS plugin
  *    wrapper that spawns the shim on `experimental.session.compacting` (T1013).
  *
  * @remarks
- * Installation is idempotent -- running install multiple times on the same
+ * Installation is idempotent — running install multiple times on the same
  * project produces the same result. OpenCode's plugin system is the native
  * hook surface (OpenCode has no config-file hook registry like Claude Code or
  * Cursor), so the installer writes a JS plugin that subscribes to the native
@@ -43,23 +45,17 @@ export declare class OpenCodeInstallProvider implements AdapterInstallProvider {
     /**
      * Check whether CLEO is installed in the current environment.
      *
-     * Checks for CLEO references in AGENTS.md.
+     * Delegates to CAAMP's instruction-file check.
      */
     isInstalled(): Promise<boolean>;
     /**
      * Ensure AGENTS.md contains @-references to CLEO instruction files.
      *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     * Delegates to CAAMP's canonical {@link ensureProviderInstructionFile}.
      *
      * @param projectDir - Project root directory
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @returns true if the file was created or modified
-     */
-    private updateInstructionFile;
     /**
      * Install the CLEO PreCompact hook templates for OpenCode (T1013).
      *

package/dist/providers/opencode/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiBjG;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA4B9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,qBAAqB;CA0C9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOjG;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,qBAAqB;CA0C9B"}

package/dist/providers/pi/install.d.ts

@@ -2,8 +2,7 @@
  * Pi Install Provider
  *
  * Handles CLEO installation into Pi coding agent environments:
- * - Ensures AGENTS.md has CLEO @-references (project and global scope)
- * - Manages Pi settings.json to register CLEO extension path
+ * - Ensures AGENTS.md has CLEO @-references via CAAMP (project and global scope)
  *
  * Pi uses AGENTS.md (not CLAUDE.md) as its instruction file. The global
  * instruction file lives at `~/.pi/agent/AGENTS.md`; the project-level
@@ -13,6 +12,7 @@
  * environment variables, or by presence of `~/.pi/agent/` directory.
  *
  * @task T553
+ * @task T9019
  */
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 /**
@@ -20,7 +20,8 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  *
  * Manages CLEO's integration with Pi by:
  * 1. Ensuring project AGENTS.md contains @-references to CLEO instruction files
- * 2. Ensuring global AGENTS.md (~/.pi/agent/AGENTS.md) contains @-references
+ *    (delegated to CAAMP's canonical {@link ensureProviderInstructionFile}).
+ * 2. Ensuring global AGENTS.md (~/.pi/agent/AGENTS.md) contains @-references.
  *
  * @remarks
  * Installation is idempotent — running install multiple times on the same
@@ -45,24 +46,16 @@ export declare class PiInstallProvider implements AdapterInstallProvider {
     /**
      * Check whether CLEO is installed in the current environment.
      *
-     * Checks for CLEO references in the project AGENTS.md.
+     * Delegates to CAAMP's instruction-file check for project and global scopes.
      */
     isInstalled(): Promise<boolean>;
     /**
      * Ensure AGENTS.md contains @-references to CLEO instruction files.
      *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     * Delegates to CAAMP's canonical {@link ensureProviderInstructionFile}.
      *
      * @param projectDir - Project root directory
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * Update an instruction file with CLEO @-references.
-     *
-     * @param dir - Directory containing the instruction file
-     * @param filename - Name of the instruction file (e.g. "AGENTS.md")
-     * @returns true if the file was created or modified
-     */
-    private updateInstructionFile;
 }
 //# sourceMappingURL=install.d.ts.map

package/dist/providers/pi/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiCjG;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,sBAAsB;IAC9D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CA+B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,YAAW,sBAAsB;IAC9D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA0C9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA0BrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}

package/package.json

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

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

@@ -219,17 +219,18 @@ describe('OpenCodeInstallProvider — integration', () => {
     expect(content).toContain('@.cleo/memory-bridge.md');
   });
 
-  it('does not duplicate existing references', async () => {
-    // Pre-seed with the dynamically-resolved reference so dedup logic fires
-    const { getCleoTemplatesTildePath } = await import('../providers/shared/paths.js');
-    const injectionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
-    const existing = `${injectionRef}\n@.cleo/memory-bridge.md\n`;
-    writeFileSync(join(testDir, 'AGENTS.md'), existing, 'utf-8');
+  it('does not duplicate CAAMP block on repeated calls', async () => {
+    // First call: creates AGENTS.md with a CAAMP block containing the references.
+    await install.ensureInstructionReferences(testDir);
+    const afterFirst = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
+    const blockCountFirst = (afterFirst.match(/<!-- CAAMP:START -->/g) ?? []).length;
+    expect(blockCountFirst).toBe(1);
 
+    // Second call: CAAMP detects the block is intact and does not duplicate it.
     await install.ensureInstructionReferences(testDir);
-    const content = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
-    const injectionCount = (content.match(/@~\/.+\/CLEO-INJECTION\.md/g) ?? []).length;
-    expect(injectionCount).toBe(1);
+    const afterSecond = readFileSync(join(testDir, 'AGENTS.md'), 'utf-8');
+    const blockCountSecond = (afterSecond.match(/<!-- CAAMP:START -->/g) ?? []).length;
+    expect(blockCountSecond).toBe(1);
   });
 
   it('install returns expected shape', async () => {

package/src/providers/codex/install.ts

@@ -2,35 +2,27 @@
  * Codex CLI Install Provider
  *
  * Handles CLEO installation into Codex CLI environments:
- * - Ensures AGENTS.md has CLEO @-references
+ * - Ensures AGENTS.md has CLEO @-references via CAAMP
  *
  * @task T162
+ * @task T9019
  * @epic T134
  */
 
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
-/**
- * Lines that should appear in AGENTS.md to reference CLEO.
- * The CLEO-INJECTION.md path is resolved dynamically to support non-default
- * XDG / OS installation locations (T916).
- */
-const INSTRUCTION_REFERENCES = [
-  `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-  '@.cleo/memory-bridge.md',
-];
-
 /**
  * Install provider for Codex CLI.
  *
  * Manages CLEO's integration with Codex CLI by:
  * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *    (delegated to CAAMP's canonical {@link ensureProviderInstructionFile}).
  *
  * @remarks
- * Installation is idempotent -- running install multiple times on the same
+ * Installation is idempotent — running install multiple times on the same
  * project produces the same result. Only AGENTS.md is managed; Codex CLI
  * does not have an MCP or plugin registration mechanism.
  *
@@ -48,13 +40,17 @@ export class CodexInstallProvider implements AdapterInstallProvider {
   async install(options: InstallOptions): Promise<InstallResult> {
     const { projectDir } = options;
     const installedAt = new Date().toISOString();
-    let instructionFileUpdated = false;
     const details: Record<string, unknown> = {};
 
-    // Step 1: Ensure AGENTS.md has @-references
-    instructionFileUpdated = this.updateInstructionFile(projectDir);
+    // Ensure AGENTS.md has CLEO @-references via CAAMP canonical API.
+    const result = await ensureProviderInstructionFile('codex', projectDir, {
+      scope: 'project',
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+    });
+
+    const instructionFileUpdated = result.action !== 'intact';
     if (instructionFileUpdated) {
-      details.instructionFile = join(projectDir, 'AGENTS.md');
+      details.instructionFile = join(projectDir, result.instructFile);
     }
 
     return {
@@ -78,69 +74,36 @@ export class CodexInstallProvider implements AdapterInstallProvider {
   /**
    * Check whether CLEO is installed in the Codex CLI environment.
    *
-   * Checks for CLEO references in AGENTS.md.
+   * Delegates to CAAMP's instruction-file check.
    * @task T162
    */
   async isInstalled(): Promise<boolean> {
-    const agentsMdPath = join(process.cwd(), 'AGENTS.md');
-    if (existsSync(agentsMdPath)) {
-      try {
-        const content = readFileSync(agentsMdPath, 'utf-8');
-        if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-          return true;
-        }
-      } catch {
-        // Fall through
-      }
+    try {
+      const result = await ensureProviderInstructionFile('codex', process.cwd(), {
+        scope: 'project',
+        references: [
+          `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+          '@.cleo/memory-bridge.md',
+        ],
+      });
+      return result.action === 'intact';
+    } catch {
+      return false;
     }
-
-    return false;
   }
 
   /**
    * Ensure AGENTS.md contains @-references to CLEO instruction files.
    *
-   * Creates AGENTS.md if it does not exist. Appends any missing references.
+   * Delegates to CAAMP's canonical {@link ensureProviderInstructionFile}.
    *
    * @param projectDir - Project root directory
    * @task T162
    */
   async ensureInstructionReferences(projectDir: string): Promise<void> {
-    this.updateInstructionFile(projectDir);
-  }
-
-  /**
-   * Update AGENTS.md with CLEO @-references.
-   *
-   * @param projectDir - Project root directory
-   * @returns true if the file was created or modified
-   */
-  private updateInstructionFile(projectDir: string): boolean {
-    const agentsMdPath = join(projectDir, 'AGENTS.md');
-    let content = '';
-    let existed = false;
-
-    if (existsSync(agentsMdPath)) {
-      content = readFileSync(agentsMdPath, 'utf-8');
-      existed = true;
-    }
-
-    const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-
-    if (missingRefs.length === 0) {
-      return false;
-    }
-
-    const refsBlock = missingRefs.join('\n');
-
-    if (existed) {
-      const separator = content.endsWith('\n') ? '' : '\n';
-      content = content + separator + refsBlock + '\n';
-    } else {
-      content = refsBlock + '\n';
-    }
-
-    writeFileSync(agentsMdPath, content, 'utf-8');
-    return true;
+    await ensureProviderInstructionFile('codex', projectDir, {
+      scope: 'project',
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, '@.cleo/memory-bridge.md'],
+    });
   }
 }