@cleocode/adapters 2026.5.28 → 2026.5.33

package/dist/index.js

@@ -873,6 +873,13 @@ var init_facade = __esm({
   }
 });
 
+// packages/contracts/src/graph.ts
+var init_graph = __esm({
+  "packages/contracts/src/graph.ts"() {
+    "use strict";
+  }
+});
+
 // packages/contracts/src/lafs.ts
 var init_lafs = __esm({
   "packages/contracts/src/lafs.ts"() {
@@ -1268,6 +1275,7 @@ var init_src = __esm({
     init_evidence_record_schema();
     init_exit_codes();
     init_facade();
+    init_graph();
     init_lafs();
     init_operations();
     init_params();
@@ -27879,14 +27887,6 @@ var init_hook_template_installer = __esm({
   }
 });
 
-// packages/adapters/src/providers/shared/paths.ts
-import { getCleoTemplatesTildePath } from "@cleocode/paths";
-var init_paths2 = __esm({
-  "packages/adapters/src/providers/shared/paths.ts"() {
-    "use strict";
-  }
-});
-
 // packages/adapters/src/providers/claude-code/install.ts
 import {
   copyFileSync as copyFileSync2,
@@ -27899,20 +27899,16 @@ import {
 import { homedir as homedir6 } from "node:os";
 import { dirname as dirname3, join as join7 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { ensureProviderInstructionFile } from "@cleocode/caamp";
 function getAdapterCommandsDir() {
   const thisDir = dirname3(fileURLToPath2(import.meta.url));
   return join7(thisDir, "commands");
 }
-var INSTRUCTION_REFERENCES, ClaudeCodeInstallProvider;
+var ClaudeCodeInstallProvider;
 var init_install = __esm({
   "packages/adapters/src/providers/claude-code/install.ts"() {
     "use strict";
     init_hook_template_installer();
-    init_paths2();
-    INSTRUCTION_REFERENCES = [
-      `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-      "@.cleo/memory-bridge.md"
-    ];
     ClaudeCodeInstallProvider = class {
       /**
        * Install CLEO into a Claude Code project.
@@ -27925,9 +27921,10 @@ var init_install = __esm({
         const installedAt = (/* @__PURE__ */ new Date()).toISOString();
         let instructionFileUpdated = false;
         const details = {};
-        instructionFileUpdated = this.updateInstructionFile(projectDir);
+        const instructionResult = await ensureProviderInstructionFile("claude-code", projectDir, {});
+        instructionFileUpdated = instructionResult.action !== "intact";
         if (instructionFileUpdated) {
-          details.instructionFile = join7(projectDir, "CLAUDE.md");
+          details.instructionFile = instructionResult.filePath;
         }
         const commandsInstalled = this.installCommands(projectDir);
         if (commandsInstalled.length > 0) {
@@ -27977,39 +27974,13 @@ var init_install = __esm({
       /**
        * Ensure CLAUDE.md contains @-references to CLEO instruction files.
        *
-       * Creates CLAUDE.md if it does not exist. Appends any missing references.
+       * Delegates to CAAMP's canonical API which reads the instruction file name
+       * and default references from the provider registry (T1919).
        *
        * @param projectDir - Project root directory
        */
       async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir);
-      }
-      /**
-       * Update CLAUDE.md with CLEO @-references.
-       *
-       * @returns true if the file was created or modified
-       */
-      updateInstructionFile(projectDir) {
-        const claudeMdPath = join7(projectDir, "CLAUDE.md");
-        let content = "";
-        let existed = false;
-        if (existsSync6(claudeMdPath)) {
-          content = readFileSync5(claudeMdPath, "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";
-        }
-        writeFileSync3(claudeMdPath, content, "utf-8");
-        return true;
+        await ensureProviderInstructionFile("claude-code", projectDir, {});
       }
       /**
        * Install Claude Code-specific commands to .claude/commands/ in the project.
@@ -28700,6 +28671,14 @@ var init_claude_code = __esm({
   }
 });
 
+// packages/adapters/src/providers/shared/paths.ts
+import { getCleoTemplatesTildePath } from "@cleocode/paths";
+var init_paths2 = __esm({
+  "packages/adapters/src/providers/shared/paths.ts"() {
+    "use strict";
+  }
+});
+
 // packages/adapters/src/providers/cursor/hooks.ts
 var PROVIDER_ID2, CURSOR_EVENT_MAP, CursorHookProvider;
 var init_hooks2 = __esm({
@@ -28856,16 +28835,13 @@ 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 { join as join16 } from "node:path";
-var INSTRUCTION_REFERENCES3, CursorInstallProvider;
+import { ensureProviderInstructionFile as ensureProviderInstructionFile2 } from "@cleocode/caamp";
+var CursorInstallProvider;
 var init_install2 = __esm({
   "packages/adapters/src/providers/cursor/install.ts"() {
     "use strict";
     init_hook_template_installer();
     init_paths2();
-    INSTRUCTION_REFERENCES3 = [
-      `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-      "@.cleo/memory-bridge.md"
-    ];
     CursorInstallProvider = class {
       /**
        * Install CLEO into a Cursor project.
@@ -28878,7 +28854,9 @@ var init_install2 = __esm({
         const installedAt = (/* @__PURE__ */ new Date()).toISOString();
         let instructionFileUpdated = false;
         const details = {};
-        instructionFileUpdated = this.updateInstructionFiles(projectDir);
+        const instructionResult = await ensureProviderInstructionFile2("cursor", projectDir, {});
+        const cursorFilesUpdated = this.updateInstructionFiles(projectDir);
+        instructionFileUpdated = instructionResult.action !== "intact" || cursorFilesUpdated;
         if (instructionFileUpdated) {
           details.instructionFiles = this.getUpdatedFileList(projectDir);
         }
@@ -28914,7 +28892,8 @@ var init_install2 = __esm({
         if (existsSync12(rulesPath)) {
           try {
             const content = readFileSync8(rulesPath, "utf-8");
-            if (INSTRUCTION_REFERENCES3.some((ref) => content.includes(ref))) {
+            const injectionRef = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
+            if (content.includes(injectionRef) || content.includes("@.cleo/memory-bridge.md")) {
               return true;
             }
           } catch {
@@ -28925,11 +28904,13 @@ var init_install2 = __esm({
       /**
        * Ensure instruction files contain @-references to CLEO.
        *
-       * Updates .cursorrules (legacy) and creates .cursor/rules/cleo.mdc (modern).
+       * Delegates the primary AGENTS.md write to CAAMP's canonical API (T1919) and
+       * also updates cursor-specific MDC + legacy .cursorrules formats.
        *
        * @param projectDir - Project root directory
        */
       async ensureInstructionReferences(projectDir) {
+        await ensureProviderInstructionFile2("cursor", projectDir, {});
         this.updateInstructionFiles(projectDir);
       }
       /**
@@ -28951,6 +28932,9 @@ var init_install2 = __esm({
       }
       /**
        * Update legacy .cursorrules file with @-references.
+       *
+       * References are sourced from the CAAMP provider registry (T1919) rather than
+       * a local constant, keeping this adapter in sync with the single source of truth.
        * Only modifies the file if it already exists (does not create it).
        *
        * @returns true if the file was modified
@@ -28961,7 +28945,11 @@ var init_install2 = __esm({
           return false;
         }
         let content = readFileSync8(rulesPath, "utf-8");
-        const missingRefs = INSTRUCTION_REFERENCES3.filter((ref) => !content.includes(ref));
+        const cursorRefs = [
+          `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+          "@.cleo/memory-bridge.md"
+        ];
+        const missingRefs = cursorRefs.filter((ref) => !content.includes(ref));
         if (missingRefs.length === 0) {
           return false;
         }
@@ -28975,12 +28963,17 @@ var init_install2 = __esm({
        *
        * MDC (Markdown Component) format is Cursor's modern rule file format.
        * Each .mdc file in .cursor/rules/ is loaded as a rule set.
+       * References are sourced from the CAAMP provider registry (T1919).
        *
        * @returns true if the file was created or modified
        */
       updateModernRules(projectDir) {
         const rulesDir = join16(projectDir, ".cursor", "rules");
         const mdcPath = join16(rulesDir, "cleo.mdc");
+        const cursorRefs = [
+          `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
+          "@.cleo/memory-bridge.md"
+        ];
         const expectedContent = [
           "---",
           "description: CLEO task management protocol references",
@@ -28988,7 +28981,7 @@ var init_install2 = __esm({
           "alwaysApply: true",
           "---",
           "",
-          ...INSTRUCTION_REFERENCES3,
+          ...cursorRefs,
           ""
         ].join("\n");
         if (existsSync12(mdcPath)) {
@@ -29404,13 +29397,13 @@ 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 { join as join23 } from "node:path";
-var INSTRUCTION_REFERENCES6, OpenCodeInstallProvider;
+var INSTRUCTION_REFERENCES4, OpenCodeInstallProvider;
 var init_install3 = __esm({
   "packages/adapters/src/providers/opencode/install.ts"() {
     "use strict";
     init_hook_template_installer();
     init_paths2();
-    INSTRUCTION_REFERENCES6 = [
+    INSTRUCTION_REFERENCES4 = [
       `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
       "@.cleo/memory-bridge.md"
     ];
@@ -29458,7 +29451,7 @@ var init_install3 = __esm({
         if (existsSync18(agentsMdPath)) {
           try {
             const content = readFileSync11(agentsMdPath, "utf-8");
-            if (INSTRUCTION_REFERENCES6.some((ref) => content.includes(ref))) {
+            if (INSTRUCTION_REFERENCES4.some((ref) => content.includes(ref))) {
               return true;
             }
           } catch {
@@ -29489,7 +29482,7 @@ var init_install3 = __esm({
           content = readFileSync11(agentsMdPath, "utf-8");
           existed = true;
         }
-        const missingRefs = INSTRUCTION_REFERENCES6.filter((ref) => !content.includes(ref));
+        const missingRefs = INSTRUCTION_REFERENCES4.filter((ref) => !content.includes(ref));
         if (missingRefs.length === 0) {
           return false;
         }
@@ -30136,12 +30129,12 @@ function getPiAgentDir() {
   }
   return join26(homedir14(), ".pi", "agent");
 }
-var INSTRUCTION_REFERENCES7, PiInstallProvider;
+var INSTRUCTION_REFERENCES5, PiInstallProvider;
 var init_install4 = __esm({
   "packages/adapters/src/providers/pi/install.ts"() {
     "use strict";
     init_paths2();
-    INSTRUCTION_REFERENCES7 = [
+    INSTRUCTION_REFERENCES5 = [
       `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
       "@.cleo/memory-bridge.md"
     ];
@@ -30194,7 +30187,7 @@ var init_install4 = __esm({
         if (existsSync20(agentsMdPath)) {
           try {
             const content = readFileSync12(agentsMdPath, "utf-8");
-            if (INSTRUCTION_REFERENCES7.some((ref) => content.includes(ref))) {
+            if (INSTRUCTION_REFERENCES5.some((ref) => content.includes(ref))) {
               return true;
             }
           } catch {
@@ -30204,7 +30197,7 @@ var init_install4 = __esm({
           const globalPath = join26(getPiAgentDir(), "AGENTS.md");
           if (existsSync20(globalPath)) {
             const content = readFileSync12(globalPath, "utf-8");
-            if (INSTRUCTION_REFERENCES7.some((ref) => content.includes(ref))) {
+            if (INSTRUCTION_REFERENCES5.some((ref) => content.includes(ref))) {
               return true;
             }
           }
@@ -30237,7 +30230,7 @@ var init_install4 = __esm({
           content = readFileSync12(filePath, "utf-8");
           existed = true;
         }
-        const missingRefs = INSTRUCTION_REFERENCES7.filter((ref) => !content.includes(ref));
+        const missingRefs = INSTRUCTION_REFERENCES5.filter((ref) => !content.includes(ref));
         if (missingRefs.length === 0) {
           return false;
         }
@@ -30893,7 +30886,7 @@ var CodexHookProvider = class {
 init_paths2();
 import { existsSync as existsSync10, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
 import { join as join14 } from "node:path";
-var INSTRUCTION_REFERENCES2 = [
+var INSTRUCTION_REFERENCES = [
   `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
   "@.cleo/memory-bridge.md"
 ];
@@ -30940,7 +30933,7 @@ var CodexInstallProvider = class {
     if (existsSync10(agentsMdPath)) {
       try {
         const content = readFileSync7(agentsMdPath, "utf-8");
-        if (INSTRUCTION_REFERENCES2.some((ref) => content.includes(ref))) {
+        if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
           return true;
         }
       } catch {
@@ -30973,7 +30966,7 @@ var CodexInstallProvider = class {
       content = readFileSync7(agentsMdPath, "utf-8");
       existed = true;
     }
-    const missingRefs = INSTRUCTION_REFERENCES2.filter((ref) => !content.includes(ref));
+    const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
     if (missingRefs.length === 0) {
       return false;
     }
@@ -31209,7 +31202,7 @@ var GeminiCliHookProvider = class {
 // packages/adapters/src/providers/gemini-cli/install.ts
 import { existsSync as existsSync14, readFileSync as readFileSync9, writeFileSync as writeFileSync6 } from "node:fs";
 import { join as join19 } from "node:path";
-var INSTRUCTION_REFERENCES4 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
+var INSTRUCTION_REFERENCES2 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
 var GeminiCliInstallProvider = class {
   /**
    * Install CLEO into a Gemini CLI environment.
@@ -31253,7 +31246,7 @@ var GeminiCliInstallProvider = class {
     if (existsSync14(agentsMdPath)) {
       try {
         const content = readFileSync9(agentsMdPath, "utf-8");
-        if (INSTRUCTION_REFERENCES4.some((ref) => content.includes(ref))) {
+        if (INSTRUCTION_REFERENCES2.some((ref) => content.includes(ref))) {
           return true;
         }
       } catch {
@@ -31286,7 +31279,7 @@ var GeminiCliInstallProvider = class {
       content = readFileSync9(agentsMdPath, "utf-8");
       existed = true;
     }
-    const missingRefs = INSTRUCTION_REFERENCES4.filter((ref) => !content.includes(ref));
+    const missingRefs = INSTRUCTION_REFERENCES2.filter((ref) => !content.includes(ref));
     if (missingRefs.length === 0) {
       return false;
     }
@@ -31501,7 +31494,7 @@ var KimiHookProvider = class {
 // packages/adapters/src/providers/kimi/install.ts
 import { existsSync as existsSync16, readFileSync as readFileSync10, writeFileSync as writeFileSync7 } from "node:fs";
 import { join as join21 } from "node:path";
-var INSTRUCTION_REFERENCES5 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
+var INSTRUCTION_REFERENCES3 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
 var KimiInstallProvider = class {
   /**
    * Install CLEO into a Kimi environment.
@@ -31545,7 +31538,7 @@ var KimiInstallProvider = class {
     if (existsSync16(agentsMdPath)) {
       try {
         const content = readFileSync10(agentsMdPath, "utf-8");
-        if (INSTRUCTION_REFERENCES5.some((ref) => content.includes(ref))) {
+        if (INSTRUCTION_REFERENCES3.some((ref) => content.includes(ref))) {
           return true;
         }
       } catch {
@@ -31578,7 +31571,7 @@ var KimiInstallProvider = class {
       content = readFileSync10(agentsMdPath, "utf-8");
       existed = true;
     }
-    const missingRefs = INSTRUCTION_REFERENCES5.filter((ref) => !content.includes(ref));
+    const missingRefs = INSTRUCTION_REFERENCES3.filter((ref) => !content.includes(ref));
     if (missingRefs.length === 0) {
       return false;
     }