@cleocode/adapters 2026.5.37 → 2026.5.40

package/dist/index.js

@@ -28833,9 +28833,9 @@ var init_hooks2 = __esm({
 });
 
 // packages/adapters/src/providers/cursor/install.ts
-import { existsSync as existsSync12, mkdirSync as mkdirSync4, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import { join as join16 } from "node:path";
-import { ensureProviderInstructionFile as ensureProviderInstructionFile2 } from "@cleocode/caamp";
+import { ensureProviderInstructionFile as ensureProviderInstructionFile3 } from "@cleocode/caamp";
 var CursorInstallProvider;
 var init_install2 = __esm({
   "packages/adapters/src/providers/cursor/install.ts"() {
@@ -28854,7 +28854,7 @@ var init_install2 = __esm({
         const installedAt = (/* @__PURE__ */ new Date()).toISOString();
         let instructionFileUpdated = false;
         const details = {};
-        const instructionResult = await ensureProviderInstructionFile2("cursor", projectDir, {});
+        const instructionResult = await ensureProviderInstructionFile3("cursor", projectDir, {});
         const cursorFilesUpdated = this.updateInstructionFiles(projectDir);
         instructionFileUpdated = instructionResult.action !== "intact" || cursorFilesUpdated;
         if (instructionFileUpdated) {
@@ -28885,13 +28885,13 @@ var init_install2 = __esm({
        */
       async isInstalled() {
         const mdcPath = join16(process.cwd(), ".cursor", "rules", "cleo.mdc");
-        if (existsSync12(mdcPath)) {
+        if (existsSync11(mdcPath)) {
           return true;
         }
         const rulesPath = join16(process.cwd(), ".cursorrules");
-        if (existsSync12(rulesPath)) {
+        if (existsSync11(rulesPath)) {
           try {
-            const content = readFileSync8(rulesPath, "utf-8");
+            const content = readFileSync7(rulesPath, "utf-8");
             const injectionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
             if (content.includes(injectionRef) || content.includes("@.cleo/memory-bridge.md")) {
               return true;
@@ -28910,7 +28910,7 @@ var init_install2 = __esm({
        * @param projectDir - Project root directory
        */
       async ensureInstructionReferences(projectDir) {
-        await ensureProviderInstructionFile2("cursor", projectDir, {});
+        await ensureProviderInstructionFile3("cursor", projectDir, {});
         this.updateInstructionFiles(projectDir);
       }
       /**
@@ -28941,10 +28941,10 @@ var init_install2 = __esm({
        */
       updateLegacyRules(projectDir) {
         const rulesPath = join16(projectDir, ".cursorrules");
-        if (!existsSync12(rulesPath)) {
+        if (!existsSync11(rulesPath)) {
           return false;
         }
-        let content = readFileSync8(rulesPath, "utf-8");
+        let content = readFileSync7(rulesPath, "utf-8");
         const cursorRefs = [
           `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
           "@.cleo/memory-bridge.md"
@@ -28955,7 +28955,7 @@ var init_install2 = __esm({
         }
         const separator = content.endsWith("\n") ? "" : "\n";
         content = content + separator + missingRefs.join("\n") + "\n";
-        writeFileSync5(rulesPath, content, "utf-8");
+        writeFileSync4(rulesPath, content, "utf-8");
         return true;
       }
       /**
@@ -28984,14 +28984,14 @@ var init_install2 = __esm({
           ...cursorRefs,
           ""
         ].join("\n");
-        if (existsSync12(mdcPath)) {
-          const existing = readFileSync8(mdcPath, "utf-8");
+        if (existsSync11(mdcPath)) {
+          const existing = readFileSync7(mdcPath, "utf-8");
           if (existing === expectedContent) {
             return false;
           }
         }
         mkdirSync4(rulesDir, { recursive: true });
-        writeFileSync5(mdcPath, expectedContent, "utf-8");
+        writeFileSync4(mdcPath, expectedContent, "utf-8");
         return true;
       }
       /**
@@ -28999,7 +28999,7 @@ var init_install2 = __esm({
        */
       getUpdatedFileList(projectDir) {
         const files = [];
-        if (existsSync12(join16(projectDir, ".cursorrules"))) {
+        if (existsSync11(join16(projectDir, ".cursorrules"))) {
           files.push(join16(projectDir, ".cursorrules"));
         }
         files.push(join16(projectDir, ".cursor", "rules", "cleo.mdc"));
@@ -29059,9 +29059,9 @@ var init_install2 = __esm({
       registerPreCompactHook(projectDir, shimPath) {
         const hooksJsonPath = join16(projectDir, ".cursor", "hooks.json");
         let config2 = {};
-        if (existsSync12(hooksJsonPath)) {
+        if (existsSync11(hooksJsonPath)) {
           try {
-            config2 = JSON.parse(readFileSync8(hooksJsonPath, "utf-8"));
+            config2 = JSON.parse(readFileSync7(hooksJsonPath, "utf-8"));
           } catch {
           }
         }
@@ -29081,7 +29081,7 @@ var init_install2 = __esm({
         hooks.preCompact = entries;
         config2.hooks = hooks;
         mkdirSync4(join16(projectDir, ".cursor"), { recursive: true });
-        writeFileSync5(hooksJsonPath, JSON.stringify(config2, null, 2) + "\n", "utf-8");
+        writeFileSync4(hooksJsonPath, JSON.stringify(config2, null, 2) + "\n", "utf-8");
         return true;
       }
     };
@@ -29089,7 +29089,7 @@ var init_install2 = __esm({
 });
 
 // packages/adapters/src/providers/cursor/adapter.ts
-import { existsSync as existsSync13 } from "node:fs";
+import { existsSync as existsSync12 } from "node:fs";
 import { join as join17 } from "node:path";
 var CursorAdapter;
 var init_adapter2 = __esm({
@@ -29185,13 +29185,13 @@ var init_adapter2 = __esm({
         let configExists = false;
         if (this.projectDir) {
           const cursorConfigDir = join17(this.projectDir, ".cursor");
-          configExists = existsSync13(cursorConfigDir);
+          configExists = existsSync12(cursorConfigDir);
           details.configDirExists = configExists;
         }
         const editorEnvSet = process.env.CURSOR_EDITOR !== void 0;
         details.editorEnvSet = editorEnvSet;
         if (this.projectDir) {
-          const legacyRulesExist = existsSync13(join17(this.projectDir, ".cursorrules"));
+          const legacyRulesExist = existsSync12(join17(this.projectDir, ".cursorrules"));
           details.legacyRulesExist = legacyRulesExist;
         }
         const healthy = configExists || editorEnvSet;
@@ -29395,18 +29395,15 @@ var init_hooks3 = __esm({
 });
 
 // packages/adapters/src/providers/opencode/install.ts
-import { existsSync as existsSync18, mkdirSync as mkdirSync5, readFileSync as readFileSync11, writeFileSync as writeFileSync8 } from "node:fs";
+import { existsSync as existsSync17, mkdirSync as mkdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync5 } from "node:fs";
 import { join as join23 } from "node:path";
-var INSTRUCTION_REFERENCES4, OpenCodeInstallProvider;
+import { ensureProviderInstructionFile as ensureProviderInstructionFile6 } from "@cleocode/caamp";
+var OpenCodeInstallProvider;
 var init_install3 = __esm({
   "packages/adapters/src/providers/opencode/install.ts"() {
     "use strict";
     init_hook_template_installer();
     init_paths2();
-    INSTRUCTION_REFERENCES4 = [
-      `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-      "@.cleo/memory-bridge.md"
-    ];
     OpenCodeInstallProvider = class {
       /**
        * Install CLEO into an OpenCode project.
@@ -29417,11 +29414,14 @@ var init_install3 = __esm({
       async install(options) {
         const { projectDir } = options;
         const installedAt = (/* @__PURE__ */ new Date()).toISOString();
-        let instructionFileUpdated = false;
         const details = {};
-        instructionFileUpdated = this.updateInstructionFile(projectDir);
+        const instructResult = await ensureProviderInstructionFile6("opencode", projectDir, {
+          scope: "project",
+          references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"]
+        });
+        const instructionFileUpdated = instructResult.action !== "intact";
         if (instructionFileUpdated) {
-          details.instructionFile = join23(projectDir, "AGENTS.md");
+          details.instructionFile = join23(projectDir, instructResult.instructFile);
         }
         const hookResult = this.installHookTemplates(projectDir);
         if (hookResult) {
@@ -29444,57 +29444,34 @@ var init_install3 = __esm({
       /**
        * Check whether CLEO is installed in the current environment.
        *
-       * Checks for CLEO references in AGENTS.md.
+       * Delegates to CAAMP's instruction-file check.
        */
       async isInstalled() {
-        const agentsMdPath = join23(process.cwd(), "AGENTS.md");
-        if (existsSync18(agentsMdPath)) {
-          try {
-            const content = readFileSync11(agentsMdPath, "utf-8");
-            if (INSTRUCTION_REFERENCES4.some((ref) => content.includes(ref))) {
-              return true;
-            }
-          } catch {
-          }
+        try {
+          const result = await ensureProviderInstructionFile6("opencode", 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
        */
       async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir);
-      }
-      /**
-       * Update AGENTS.md with CLEO @-references.
-       *
-       * @returns true if the file was created or modified
-       */
-      updateInstructionFile(projectDir) {
-        const agentsMdPath = join23(projectDir, "AGENTS.md");
-        let content = "";
-        let existed = false;
-        if (existsSync18(agentsMdPath)) {
-          content = readFileSync11(agentsMdPath, "utf-8");
-          existed = true;
-        }
-        const missingRefs = INSTRUCTION_REFERENCES4.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";
-        }
-        writeFileSync8(agentsMdPath, content, "utf-8");
-        return true;
+        await ensureProviderInstructionFile6("opencode", projectDir, {
+          scope: "project",
+          references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"]
+        });
       }
       /**
        * Install the CLEO PreCompact hook templates for OpenCode (T1013).
@@ -29580,16 +29557,16 @@ var init_install3 = __esm({
           "}",
           ""
         ].join("\n");
-        if (existsSync18(pluginPath)) {
+        if (existsSync17(pluginPath)) {
           try {
-            if (readFileSync11(pluginPath, "utf-8") === generated) {
+            if (readFileSync10(pluginPath, "utf-8") === generated) {
               return false;
             }
           } catch {
           }
         }
         mkdirSync5(pluginsDir, { recursive: true });
-        writeFileSync8(pluginPath, generated, "utf-8");
+        writeFileSync5(pluginPath, generated, "utf-8");
         return true;
       }
     };
@@ -29790,7 +29767,7 @@ var init_spawn3 = __esm({
 
 // packages/adapters/src/providers/opencode/adapter.ts
 import { exec as exec10 } from "node:child_process";
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync18 } from "node:fs";
 import { join as join25 } from "node:path";
 import { promisify as promisify11 } from "node:util";
 var execAsync10, OpenCodeAdapter;
@@ -29904,7 +29881,7 @@ var init_adapter3 = __esm({
         }
         if (this.projectDir) {
           const openCodeConfigDir = join25(this.projectDir, ".opencode");
-          const configExists = existsSync19(openCodeConfigDir);
+          const configExists = existsSync18(openCodeConfigDir);
           details.configDirExists = configExists;
         }
         const versionEnvSet = process.env.OPENCODE_VERSION !== void 0;
@@ -30113,31 +30090,16 @@ var init_hooks4 = __esm({
 });
 
 // packages/adapters/src/providers/pi/install.ts
-import { existsSync as existsSync20, mkdirSync as mkdirSync6, readFileSync as readFileSync12, writeFileSync as writeFileSync9 } from "node:fs";
-import { homedir as homedir14 } from "node:os";
 import { join as join26 } from "node:path";
-function getPiAgentDir() {
-  const env = process.env["PI_CODING_AGENT_DIR"];
-  if (env !== void 0 && env.length > 0) {
-    if (env === "~") return homedir14();
-    if (env.startsWith("~/")) return join26(homedir14(), env.slice(2));
-    return env;
-  }
-  const piHome = process.env["PI_HOME"];
-  if (piHome !== void 0 && piHome.length > 0) {
-    return join26(piHome, "agent");
-  }
-  return join26(homedir14(), ".pi", "agent");
+import { ensureProviderInstructionFile as ensureProviderInstructionFile7 } from "@cleocode/caamp";
+function getCleoReferences() {
+  return [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"];
 }
-var INSTRUCTION_REFERENCES5, PiInstallProvider;
+var PiInstallProvider;
 var init_install4 = __esm({
   "packages/adapters/src/providers/pi/install.ts"() {
     "use strict";
     init_paths2();
-    INSTRUCTION_REFERENCES5 = [
-      `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-      "@.cleo/memory-bridge.md"
-    ];
     PiInstallProvider = class {
       /**
        * Install CLEO into a Pi coding agent project.
@@ -30149,16 +30111,23 @@ var init_install4 = __esm({
         const { projectDir } = options;
         const installedAt = (/* @__PURE__ */ new Date()).toISOString();
         const details = {};
-        const projectUpdated = this.updateInstructionFile(projectDir, "AGENTS.md");
+        const projectResult = await ensureProviderInstructionFile7("pi", projectDir, {
+          scope: "project",
+          references: getCleoReferences()
+        });
+        const projectUpdated = projectResult.action !== "intact";
         if (projectUpdated) {
-          details.instructionFile = join26(projectDir, "AGENTS.md");
+          details.instructionFile = join26(projectDir, projectResult.instructFile);
         }
         let globalUpdated = false;
         try {
-          const globalDir = getPiAgentDir();
-          globalUpdated = this.updateInstructionFile(globalDir, "AGENTS.md");
+          const globalResult = await ensureProviderInstructionFile7("pi", projectDir, {
+            scope: "global",
+            references: getCleoReferences()
+          });
+          globalUpdated = globalResult.action !== "intact";
           if (globalUpdated) {
-            details.globalInstructionFile = join26(globalDir, "AGENTS.md");
+            details.globalInstructionFile = globalResult.filePath;
           }
         } catch {
         }
@@ -30180,27 +30149,23 @@ var init_install4 = __esm({
       /**
        * 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.
        */
       async isInstalled() {
-        const agentsMdPath = join26(process.cwd(), "AGENTS.md");
-        if (existsSync20(agentsMdPath)) {
-          try {
-            const content = readFileSync12(agentsMdPath, "utf-8");
-            if (INSTRUCTION_REFERENCES5.some((ref) => content.includes(ref))) {
-              return true;
-            }
-          } catch {
-          }
+        try {
+          const result = await ensureProviderInstructionFile7("pi", process.cwd(), {
+            scope: "project",
+            references: getCleoReferences()
+          });
+          if (result.action === "intact") return true;
+        } catch {
         }
         try {
-          const globalPath = join26(getPiAgentDir(), "AGENTS.md");
-          if (existsSync20(globalPath)) {
-            const content = readFileSync12(globalPath, "utf-8");
-            if (INSTRUCTION_REFERENCES5.some((ref) => content.includes(ref))) {
-              return true;
-            }
-          }
+          const result = await ensureProviderInstructionFile7("pi", process.cwd(), {
+            scope: "global",
+            references: getCleoReferences()
+          });
+          if (result.action === "intact") return true;
         } catch {
         }
         return false;
@@ -30208,42 +30173,15 @@ var init_install4 = __esm({
       /**
        * 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
        */
       async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir, "AGENTS.md");
-      }
-      /**
-       * 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
-       */
-      updateInstructionFile(dir, filename) {
-        const filePath = join26(dir, filename);
-        let content = "";
-        let existed = false;
-        if (existsSync20(filePath)) {
-          content = readFileSync12(filePath, "utf-8");
-          existed = true;
-        }
-        const missingRefs = INSTRUCTION_REFERENCES5.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 {
-          mkdirSync6(dir, { recursive: true });
-          content = refsBlock + "\n";
-        }
-        writeFileSync9(filePath, content, "utf-8");
-        return true;
+        await ensureProviderInstructionFile7("pi", projectDir, {
+          scope: "project",
+          references: getCleoReferences()
+        });
       }
     };
   }
@@ -30402,22 +30340,22 @@ var init_spawn4 = __esm({
 
 // packages/adapters/src/providers/pi/adapter.ts
 import { exec as exec12 } from "node:child_process";
-import { existsSync as existsSync21 } from "node:fs";
-import { homedir as homedir15 } from "node:os";
+import { existsSync as existsSync19 } from "node:fs";
+import { homedir as homedir14 } from "node:os";
 import { join as join27 } from "node:path";
 import { promisify as promisify13 } from "node:util";
-function getPiAgentDir2() {
+function getPiAgentDir() {
   const env = process.env["PI_CODING_AGENT_DIR"];
   if (env !== void 0 && env.length > 0) {
-    if (env === "~") return homedir15();
-    if (env.startsWith("~/")) return join27(homedir15(), env.slice(2));
+    if (env === "~") return homedir14();
+    if (env.startsWith("~/")) return join27(homedir14(), env.slice(2));
     return env;
   }
   const piHome = process.env["PI_HOME"];
   if (piHome !== void 0 && piHome.length > 0) {
     return join27(piHome, "agent");
   }
-  return join27(homedir15(), ".pi", "agent");
+  return join27(homedir14(), ".pi", "agent");
 }
 var execAsync12, PiAdapter;
 var init_adapter4 = __esm({
@@ -30534,13 +30472,13 @@ var init_adapter4 = __esm({
         } catch {
           details.cliAvailable = false;
         }
-        const agentDir = getPiAgentDir2();
-        const agentDirExists = existsSync21(agentDir);
+        const agentDir = getPiAgentDir();
+        const agentDirExists = existsSync19(agentDir);
         details.agentDirExists = agentDirExists;
         details.agentDir = agentDir;
         if (this.projectDir) {
           const projectPiDir = join27(this.projectDir, ".pi");
-          details.projectPiDirExists = existsSync21(projectPiDir);
+          details.projectPiDirExists = existsSync19(projectPiDir);
         }
         details.piCodingAgentDirSet = process.env["PI_CODING_AGENT_DIR"] !== void 0;
         details.piHomeSet = process.env["PI_HOME"] !== void 0;
@@ -30752,7 +30690,7 @@ function createAdapter2() {
 
 // packages/adapters/src/providers/codex/adapter.ts
 import { exec as exec3 } from "node:child_process";
-import { existsSync as existsSync11 } from "node:fs";
+import { existsSync as existsSync10 } from "node:fs";
 import { homedir as homedir10 } from "node:os";
 import { join as join15 } from "node:path";
 import { promisify as promisify4 } from "node:util";
@@ -30884,12 +30822,8 @@ var CodexHookProvider = class {
 
 // packages/adapters/src/providers/codex/install.ts
 init_paths2();
-import { existsSync as existsSync10, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import { join as join14 } from "node:path";
-var INSTRUCTION_REFERENCES = [
-  `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-  "@.cleo/memory-bridge.md"
-];
+import { ensureProviderInstructionFile as ensureProviderInstructionFile2 } from "@cleocode/caamp";
 var CodexInstallProvider = class {
   /**
    * Install CLEO into a Codex CLI environment.
@@ -30901,11 +30835,14 @@ var CodexInstallProvider = class {
   async install(options) {
     const { projectDir } = options;
     const installedAt = (/* @__PURE__ */ new Date()).toISOString();
-    let instructionFileUpdated = false;
     const details = {};
-    instructionFileUpdated = this.updateInstructionFile(projectDir);
+    const result = await ensureProviderInstructionFile2("codex", projectDir, {
+      scope: "project",
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"]
+    });
+    const instructionFileUpdated = result.action !== "intact";
     if (instructionFileUpdated) {
-      details.instructionFile = join14(projectDir, "AGENTS.md");
+      details.instructionFile = join14(projectDir, result.instructFile);
     }
     return {
       success: true,
@@ -30925,60 +30862,36 @@ var CodexInstallProvider = class {
   /**
    * 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() {
-    const agentsMdPath = join14(process.cwd(), "AGENTS.md");
-    if (existsSync10(agentsMdPath)) {
-      try {
-        const content = readFileSync7(agentsMdPath, "utf-8");
-        if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-          return true;
-        }
-      } catch {
-      }
+    try {
+      const result = await ensureProviderInstructionFile2("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) {
-    this.updateInstructionFile(projectDir);
-  }
-  /**
-   * Update AGENTS.md with CLEO @-references.
-   *
-   * @param projectDir - Project root directory
-   * @returns true if the file was created or modified
-   */
-  updateInstructionFile(projectDir) {
-    const agentsMdPath = join14(projectDir, "AGENTS.md");
-    let content = "";
-    let existed = false;
-    if (existsSync10(agentsMdPath)) {
-      content = readFileSync7(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";
-    }
-    writeFileSync4(agentsMdPath, content, "utf-8");
-    return true;
+    await ensureProviderInstructionFile2("codex", projectDir, {
+      scope: "project",
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"]
+    });
   }
 };
 
@@ -31068,7 +30981,7 @@ var CodexAdapter = class {
       details.cliAvailable = false;
     }
     const codexConfigDir = join15(homedir10(), ".codex");
-    const configExists = existsSync11(codexConfigDir);
+    const configExists = existsSync10(codexConfigDir);
     details.configDirExists = configExists;
     const healthy = cliAvailable;
     details.cliAvailable = cliAvailable;
@@ -31110,7 +31023,7 @@ init_cursor();
 
 // packages/adapters/src/providers/gemini-cli/adapter.ts
 import { exec as exec5 } from "node:child_process";
-import { existsSync as existsSync15 } from "node:fs";
+import { existsSync as existsSync14 } from "node:fs";
 import { homedir as homedir12 } from "node:os";
 import { join as join20 } from "node:path";
 import { promisify as promisify6 } from "node:util";
@@ -31200,9 +31113,10 @@ var GeminiCliHookProvider = class {
 };
 
 // packages/adapters/src/providers/gemini-cli/install.ts
-import { existsSync as existsSync14, readFileSync as readFileSync9, writeFileSync as writeFileSync6 } from "node:fs";
+init_paths2();
+import { existsSync as existsSync13, readFileSync as readFileSync8 } from "node:fs";
 import { join as join19 } from "node:path";
-var INSTRUCTION_REFERENCES2 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
+import { ensureProviderInstructionFile as ensureProviderInstructionFile4 } from "@cleocode/caamp";
 var GeminiCliInstallProvider = class {
   /**
    * Install CLEO into a Gemini CLI environment.
@@ -31214,11 +31128,14 @@ var GeminiCliInstallProvider = class {
   async install(options) {
     const { projectDir } = options;
     const installedAt = (/* @__PURE__ */ new Date()).toISOString();
-    let instructionFileUpdated = false;
     const details = {};
-    instructionFileUpdated = this.updateInstructionFile(projectDir);
+    const result = await ensureProviderInstructionFile4("gemini-cli", projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"],
+      scope: "project"
+    });
+    const instructionFileUpdated = result.action !== "intact";
     if (instructionFileUpdated) {
-      details.instructionFile = join19(projectDir, "AGENTS.md");
+      details.instructionFile = result.filePath;
     }
     return {
       success: true,
@@ -31230,7 +31147,7 @@ var GeminiCliInstallProvider = class {
   /**
    * 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
    */
   async uninstall() {
@@ -31238,15 +31155,16 @@ var GeminiCliInstallProvider = class {
   /**
    * 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
    */
   async isInstalled() {
-    const agentsMdPath = join19(process.cwd(), "AGENTS.md");
-    if (existsSync14(agentsMdPath)) {
+    const instructionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
+    const geminiMdPath = join19(process.cwd(), "GEMINI.md");
+    if (existsSync13(geminiMdPath)) {
       try {
-        const content = readFileSync9(agentsMdPath, "utf-8");
-        if (INSTRUCTION_REFERENCES2.some((ref) => content.includes(ref))) {
+        const content = readFileSync8(geminiMdPath, "utf-8");
+        if (content.includes(instructionRef)) {
           return true;
         }
       } catch {
@@ -31255,43 +31173,18 @@ var GeminiCliInstallProvider = class {
     return false;
   }
   /**
-   * 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
    */
   async ensureInstructionReferences(projectDir) {
-    this.updateInstructionFile(projectDir);
-  }
-  /**
-   * Update AGENTS.md with CLEO @-references.
-   *
-   * @param projectDir - Project root directory
-   * @returns true if the file was created or modified
-   */
-  updateInstructionFile(projectDir) {
-    const agentsMdPath = join19(projectDir, "AGENTS.md");
-    let content = "";
-    let existed = false;
-    if (existsSync14(agentsMdPath)) {
-      content = readFileSync9(agentsMdPath, "utf-8");
-      existed = true;
-    }
-    const missingRefs = INSTRUCTION_REFERENCES2.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";
-    }
-    writeFileSync6(agentsMdPath, content, "utf-8");
-    return true;
+    await ensureProviderInstructionFile4("gemini-cli", projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"],
+      scope: "project"
+    });
   }
 };
 
@@ -31392,7 +31285,7 @@ var GeminiCliAdapter = class {
       details.cliAvailable = false;
     }
     const geminiConfigDir = join20(homedir12(), ".gemini");
-    const configExists = existsSync15(geminiConfigDir);
+    const configExists = existsSync14(geminiConfigDir);
     details.configDirExists = configExists;
     const healthy = cliAvailable;
     details.cliAvailable = cliAvailable;
@@ -31431,7 +31324,7 @@ function createAdapter5() {
 
 // packages/adapters/src/providers/kimi/adapter.ts
 import { exec as exec7 } from "node:child_process";
-import { existsSync as existsSync17 } from "node:fs";
+import { existsSync as existsSync16 } from "node:fs";
 import { homedir as homedir13 } from "node:os";
 import { join as join22 } from "node:path";
 import { promisify as promisify8 } from "node:util";
@@ -31492,9 +31385,10 @@ var KimiHookProvider = class {
 };
 
 // packages/adapters/src/providers/kimi/install.ts
-import { existsSync as existsSync16, readFileSync as readFileSync10, writeFileSync as writeFileSync7 } from "node:fs";
+init_paths2();
+import { existsSync as existsSync15, readFileSync as readFileSync9 } from "node:fs";
 import { join as join21 } from "node:path";
-var INSTRUCTION_REFERENCES3 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
+import { ensureProviderInstructionFile as ensureProviderInstructionFile5 } from "@cleocode/caamp";
 var KimiInstallProvider = class {
   /**
    * Install CLEO into a Kimi environment.
@@ -31506,11 +31400,14 @@ var KimiInstallProvider = class {
   async install(options) {
     const { projectDir } = options;
     const installedAt = (/* @__PURE__ */ new Date()).toISOString();
-    let instructionFileUpdated = false;
     const details = {};
-    instructionFileUpdated = this.updateInstructionFile(projectDir);
+    const result = await ensureProviderInstructionFile5("kimi", projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"],
+      scope: "project"
+    });
+    const instructionFileUpdated = result.action !== "intact";
     if (instructionFileUpdated) {
-      details.instructionFile = join21(projectDir, "AGENTS.md");
+      details.instructionFile = result.filePath;
     }
     return {
       success: true,
@@ -31534,11 +31431,12 @@ var KimiInstallProvider = class {
    * @task T163
    */
   async isInstalled() {
+    const instructionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
     const agentsMdPath = join21(process.cwd(), "AGENTS.md");
-    if (existsSync16(agentsMdPath)) {
+    if (existsSync15(agentsMdPath)) {
       try {
-        const content = readFileSync10(agentsMdPath, "utf-8");
-        if (INSTRUCTION_REFERENCES3.some((ref) => content.includes(ref))) {
+        const content = readFileSync9(agentsMdPath, "utf-8");
+        if (content.includes(instructionRef)) {
           return true;
         }
       } catch {
@@ -31555,35 +31453,10 @@ var KimiInstallProvider = class {
    * @task T163
    */
   async ensureInstructionReferences(projectDir) {
-    this.updateInstructionFile(projectDir);
-  }
-  /**
-   * Update AGENTS.md with CLEO @-references.
-   *
-   * @param projectDir - Project root directory
-   * @returns true if the file was created or modified
-   */
-  updateInstructionFile(projectDir) {
-    const agentsMdPath = join21(projectDir, "AGENTS.md");
-    let content = "";
-    let existed = false;
-    if (existsSync16(agentsMdPath)) {
-      content = readFileSync10(agentsMdPath, "utf-8");
-      existed = true;
-    }
-    const missingRefs = INSTRUCTION_REFERENCES3.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";
-    }
-    writeFileSync7(agentsMdPath, content, "utf-8");
-    return true;
+    await ensureProviderInstructionFile5("kimi", projectDir, {
+      references: [`@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`, "@.cleo/memory-bridge.md"],
+      scope: "project"
+    });
   }
 };
 
@@ -31671,7 +31544,7 @@ var KimiAdapter = class {
       details.cliAvailable = false;
     }
     const kimiConfigDir = join22(homedir13(), ".kimi");
-    const configExists = existsSync17(kimiConfigDir);
+    const configExists = existsSync16(kimiConfigDir);
     details.configDirExists = configExists;
     const healthy = cliAvailable;
     details.cliAvailable = cliAvailable;
@@ -31713,7 +31586,7 @@ init_opencode();
 init_hook_template_installer();
 
 // packages/adapters/src/registry.ts
-import { readFileSync as readFileSync13 } from "node:fs";
+import { readFileSync as readFileSync11 } from "node:fs";
 import { dirname as dirname4, join as join28, resolve as resolve2 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 var PROVIDER_IDS = ["claude-code", "opencode", "cursor", "pi"];
@@ -31723,7 +31596,7 @@ function getProviderManifests() {
   for (const providerId of PROVIDER_IDS) {
     try {
       const manifestPath = join28(baseDir, providerId, "manifest.json");
-      const raw = readFileSync13(manifestPath, "utf-8");
+      const raw = readFileSync11(manifestPath, "utf-8");
       manifests.push(JSON.parse(raw));
     } catch {
     }