@cleocode/caamp 2026.9.19 → 2026.9.21

package/dist/{chunk-CHPNPLOK.js → chunk-UIXTFV35.js}

@@ -6,15 +6,17 @@ import {
 } from "./chunk-HDZYZTR2.js";
 
 // src/core/instructions/injector.ts
-import { existsSync } from "fs";
+import { existsSync as existsSync2 } from "fs";
 import { readFile as readFile3, stat as stat3 } from "fs/promises";
 import { homedir as homedir2 } from "os";
 import { dirname as dirname4, isAbsolute, join as join2 } from "path";
-import { writeFileAtomic } from "@cleocode/core/tools/fs.js";
+import { writeFileAtomic as writeFileAtomic2 } from "@cleocode/core/tools/fs.js";
 
 // src/core/fs/atomic.ts
+import { existsSync } from "fs";
 import { mkdir, open, readFile, rm, stat, writeFile } from "fs/promises";
 import { dirname } from "path";
+import { writeFileAtomic } from "@cleocode/core/tools/fs.js";
 var DEFAULT_STALE_LOCK_MS = 3e4;
 var DEFAULT_LOCK_RETRIES = 400;
 var DEFAULT_LOCK_DELAY_MS = 25;
@@ -77,6 +79,50 @@ function assertNotTornRead(filePath, content, sizeOnDisk) {
     );
   }
 }
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var JsonConfigParseError = class extends Error {
+  /** Path of the file that failed to parse. */
+  filePath;
+  /**
+   * @param filePath - Path of the file that failed to parse
+   * @param reason - Parser message
+   */
+  constructor(filePath, reason) {
+    super(`Refusing to rewrite ${filePath}: it is not a valid JSON object (${reason}).`);
+    this.name = "JsonConfigParseError";
+    this.filePath = filePath;
+  }
+};
+async function updateJsonConfigFile(filePath, mutate) {
+  return withFileLock(filePath, async () => {
+    let config = {};
+    if (existsSync(filePath)) {
+      const raw = await readFile(filePath, "utf-8");
+      if (raw.length === 0) assertNotTornRead(filePath, raw, (await stat(filePath)).size);
+      if (raw.trim().length > 0) {
+        let parsed;
+        try {
+          parsed = JSON.parse(raw);
+        } catch (err) {
+          throw new JsonConfigParseError(
+            filePath,
+            err instanceof Error ? err.message : String(err)
+          );
+        }
+        if (!isJsonObject(parsed)) {
+          throw new JsonConfigParseError(filePath, "top-level value is not an object");
+        }
+        config = parsed;
+      }
+    }
+    if (!mutate(config)) return false;
+    await writeFileAtomic({ path: filePath, content: `${JSON.stringify(config, null, 2)}
+` });
+    return true;
+  });
+}
 
 // src/core/registry/providers.ts
 import { readFileSync } from "fs";
@@ -353,6 +399,130 @@ function providerSupportsById(idOrAlias, capabilityPath) {
   if (!provider) return false;
   return providerSupports(provider, capabilityPath);
 }
+var HITL_REQUEST_FALLBACK = {
+  operation: "hitl.request",
+  fields: ["question", "options", "recommended"],
+  optionFields: ["label", "description"]
+};
+var UNKNOWN_ASK_TOOL = {
+  status: "unknown",
+  toolName: null,
+  caveat: null,
+  source: "not verified (T12482): no doc or source located"
+};
+var PROVIDER_ASK_TOOLS = {
+  "claude-code": {
+    status: "native",
+    toolName: "AskUserQuestion",
+    caveat: "Main session only; subagents cannot call it",
+    source: "https://code.claude.com/docs/en/settings#tools-available-to-claude"
+  },
+  codex: {
+    status: "native",
+    toolName: "request_user_input",
+    caveat: "Plan mode by default; default mode needs [features] default_mode_request_user_input = true; unsupported in `codex exec`",
+    source: "codex-cli 0.157.1 binary (core/src/tools/handlers/request_user_input.rs); openai/codex#10384, #15293"
+  },
+  "gemini-cli": {
+    status: "native",
+    toolName: "ask_user",
+    caveat: null,
+    source: "https://geminicli.com/docs/tools/ask-user"
+  },
+  "copilot-cli": {
+    status: "native",
+    toolName: "ask_user",
+    caveat: "Disabled by --no-ask-user",
+    source: "https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference"
+  },
+  opencode: {
+    status: "native",
+    toolName: "question",
+    caveat: "Gated by permission.question",
+    source: "https://opencode.ai/docs/tools; opencode v2.0.15 binary (QuestionTool)"
+  },
+  kimi: {
+    status: "native",
+    toolName: "AskUserQuestion",
+    caveat: null,
+    source: 'kimi 2.1.1 binary (~/.kimi-code/bin/kimi: name: "AskUserQuestion")'
+  },
+  cursor: {
+    status: "native",
+    toolName: "AskQuestion",
+    caveat: "Plan mode only; not offered under `agent acp`",
+    source: "https://forum.cursor.com/t/allow-askquestion-tool-calls-in-agent-mode-or-any-mode/152517"
+  },
+  cline: {
+    status: "native",
+    toolName: "ask_followup_question",
+    caveat: null,
+    source: "Cline system prompt (ask_followup_question with options[])"
+  },
+  roo: {
+    status: "native",
+    toolName: "ask_followup_question",
+    caveat: null,
+    source: "https://docs.roocode.com/advanced-usage/available-tools/ask-followup-question"
+  },
+  "kilo-code": {
+    status: "native",
+    toolName: "ask_followup_question",
+    caveat: "Verified for the legacy IDE extension only",
+    source: "Kilo-Org/kilocode-legacy docs/legacy-ides/automate/tools/ask-followup-question.md"
+  },
+  pi: {
+    status: "none",
+    toolName: null,
+    caveat: "Optional `question` tool only via examples/extensions/question.ts",
+    source: "@mariozechner/pi-coding-agent 0.66.0 dist/core/tools (bash/edit/find/grep/ls/read/write)"
+  },
+  "openai-sdk": {
+    status: "none",
+    toolName: null,
+    caveat: "Library, not a harness: the host application defines every tool",
+    source: "providers/registry.json (spawnMechanism: sdk)"
+  },
+  windsurf: UNKNOWN_ASK_TOOL,
+  "github-copilot": UNKNOWN_ASK_TOOL,
+  vscode: UNKNOWN_ASK_TOOL,
+  zed: UNKNOWN_ASK_TOOL,
+  "claude-desktop": UNKNOWN_ASK_TOOL,
+  continue: UNKNOWN_ASK_TOOL,
+  goose: UNKNOWN_ASK_TOOL,
+  antigravity: UNKNOWN_ASK_TOOL,
+  "kiro-cli": UNKNOWN_ASK_TOOL,
+  amp: UNKNOWN_ASK_TOOL,
+  trae: UNKNOWN_ASK_TOOL,
+  aide: UNKNOWN_ASK_TOOL,
+  "pear-ai": UNKNOWN_ASK_TOOL,
+  "void-ai": UNKNOWN_ASK_TOOL,
+  cody: UNKNOWN_ASK_TOOL,
+  "qwen-code": UNKNOWN_ASK_TOOL,
+  openhands: UNKNOWN_ASK_TOOL,
+  codebuddy: UNKNOWN_ASK_TOOL,
+  codestory: UNKNOWN_ASK_TOOL,
+  aider: UNKNOWN_ASK_TOOL,
+  "amazon-q": UNKNOWN_ASK_TOOL,
+  tabnine: UNKNOWN_ASK_TOOL,
+  augment: UNKNOWN_ASK_TOOL,
+  devin: UNKNOWN_ASK_TOOL,
+  mentat: UNKNOWN_ASK_TOOL,
+  "blackbox-ai": UNKNOWN_ASK_TOOL,
+  sourcery: UNKNOWN_ASK_TOOL,
+  "replit-agent": UNKNOWN_ASK_TOOL,
+  "jetbrains-ai": UNKNOWN_ASK_TOOL,
+  codegen: UNKNOWN_ASK_TOOL,
+  double: UNKNOWN_ASK_TOOL,
+  "swe-agent": UNKNOWN_ASK_TOOL,
+  forge: UNKNOWN_ASK_TOOL,
+  "gemini-code-assist": UNKNOWN_ASK_TOOL
+};
+function getProviderAskTool(idOrAlias) {
+  const providerId = Object.hasOwn(PROVIDER_ASK_TOOLS, idOrAlias) ? idOrAlias : resolveAlias(idOrAlias);
+  const entry = PROVIDER_ASK_TOOLS[providerId] ?? UNKNOWN_ASK_TOOL;
+  return { ...entry, providerId, fallback: HITL_REQUEST_FALLBACK };
+}
 
 // src/core/instructions/markers.ts
 import {
@@ -675,7 +845,7 @@ function parseCaampBlocks(fileContent) {
   return parseBlocks(fileContent);
 }
 async function dedupeFile(filePath) {
-  if (!existsSync(filePath)) {
+  if (!existsSync2(filePath)) {
     return { filePath, removed: 0, kept: 0, modified: false, repaired: 0 };
   }
   return withFileLock(filePath, async () => {
@@ -685,7 +855,7 @@ async function dedupeFile(filePath) {
     const blocks = parseBlocks(healed);
     if (blocks.length === 0) {
       if (repaired > 0 && healed !== original) {
-        await writeFileAtomic({ path: filePath, content: healed });
+        await writeFileAtomic2({ path: filePath, content: healed });
         return { filePath, removed: 0, kept: 0, modified: true, repaired };
       }
       return { filePath, removed: 0, kept: 0, modified: false, repaired };
@@ -712,7 +882,7 @@ async function dedupeFile(filePath) {
     if (result === original) {
       return { filePath, removed: 0, kept: blocks.length, modified: false, repaired };
     }
-    await writeFileAtomic({ path: filePath, content: result });
+    await writeFileAtomic2({ path: filePath, content: result });
     return { filePath, removed, kept: keepSet.size, modified: true, repaired };
   });
 }
@@ -744,7 +914,7 @@ function scopedInstructionPath(provider, projectDir, scope) {
   return scope === "global" ? resolveGlobalInstructionPath(provider) : join2(projectDir, provider.instructFile);
 }
 async function repairInstructionFiles(projectDir, providers) {
-  const paths = instructionFileCascade(projectDir, providers).filter((p) => existsSync(p));
+  const paths = instructionFileCascade(projectDir, providers).filter((p) => existsSync2(p));
   const files = [];
   for (const filePath of paths) {
     files.push(
@@ -758,7 +928,7 @@ async function repairInstructionFiles(projectDir, providers) {
         if (content === original) {
           return { filePath, removed: 0, kept: blocksBefore, modified: false, repaired };
         }
-        await writeFileAtomic({ path: filePath, content });
+        await writeFileAtomic2({ path: filePath, content });
         return {
           filePath,
           removed,
@@ -777,7 +947,7 @@ async function repairInstructionFiles(projectDir, providers) {
   };
 }
 async function checkInjection(filePath, expectedContent) {
-  if (!existsSync(filePath)) return "missing";
+  if (!existsSync2(filePath)) return "missing";
   const raw = await readFile3(filePath, "utf-8");
   const { content, repaired } = normalizeMarkers(raw);
   const blocks = parseBlocks(content);
@@ -792,8 +962,8 @@ async function inject(filePath, content) {
   const body = content.trim();
   assertBalancedMarkers(buildBlock(body));
   return withFileLock(filePath, async () => {
-    if (!existsSync(filePath)) {
-      await writeFileAtomic({ path: filePath, content: `${buildBlock(body)}
+    if (!existsSync2(filePath)) {
+      await writeFileAtomic2({ path: filePath, content: `${buildBlock(body)}
 ` });
       return "created";
     }
@@ -803,7 +973,7 @@ async function inject(filePath, content) {
     }
     const { content: next, blocksBefore, repaired } = reconcile(existing, body);
     if (next === existing) return "intact";
-    await writeFileAtomic({ path: filePath, content: next });
+    await writeFileAtomic2({ path: filePath, content: next });
     if (blocksBefore === 0) return "added";
     if (repaired > 0) return "repaired";
     if (blocksBefore > 1) return "consolidated";
@@ -811,7 +981,7 @@ async function inject(filePath, content) {
   });
 }
 async function removeInjection(filePath) {
-  if (!existsSync(filePath)) return false;
+  if (!existsSync2(filePath)) return false;
   return withFileLock(filePath, async () => {
     const original = await readFile3(filePath, "utf-8");
     const { content } = normalizeMarkers(original);
@@ -822,7 +992,7 @@ async function removeInjection(filePath) {
       const { rm: rm2 } = await import("fs/promises");
       await rm2(filePath);
     } else {
-      await writeFileAtomic({ path: filePath, content: cleaned });
+      await writeFileAtomic2({ path: filePath, content: cleaned });
     }
     return true;
   });
@@ -844,7 +1014,7 @@ async function checkAllInjections(providers, projectDir, scope, expectedContent)
         reason: "Managed content differs from the expected version."
       });
     }
-    if (existsSync(filePath) && parseBlocks(await readFile3(filePath, "utf8")).length > 1) {
+    if (existsSync2(filePath) && parseBlocks(await readFile3(filePath, "utf8")).length > 1) {
       delivery.findings.push({
         kind: "duplicate",
         path: filePath,
@@ -858,7 +1028,7 @@ async function checkAllInjections(providers, projectDir, scope, expectedContent)
       file: filePath,
       provider: provider.id,
       status,
-      fileExists: existsSync(filePath)
+      fileExists: existsSync2(filePath)
     });
   }
   return results;
@@ -888,7 +1058,7 @@ async function ensureProviderInstructionFile(providerId, projectDir, options) {
   }
   let references = options.references ?? getProviderInstructionReferences(providerId);
   let content = options.content;
-  if (options.delivery !== "verified-references" && references.includes("@.cleo/memory-bridge.md") && !existsSync(join2(dirname4(filePath), ".cleo", "memory-bridge.md"))) {
+  if (options.delivery !== "verified-references" && references.includes("@.cleo/memory-bridge.md") && !existsSync2(join2(dirname4(filePath), ".cleo", "memory-bridge.md"))) {
     references = references.filter((reference) => reference !== "@.cleo/memory-bridge.md");
     content = [
       ...content ?? [],
@@ -918,6 +1088,57 @@ async function ensureProviderInstructionFile(providerId, projectDir, options) {
     providerId: provider.id
   };
 }
+function stripBareReferenceLines(content, references) {
+  const refs = new Set(references);
+  const kept = content.split("\n").filter((line) => !refs.has(line.trim()));
+  return kept.join("\n").replace(/\n{3,}/g, "\n\n");
+}
+async function ensureProviderRuleFile(providerId, projectDir, options) {
+  const provider = getProvider(providerId);
+  if (!provider) {
+    throw new Error(`Unknown provider: "${providerId}". Check CAAMP provider registry.`);
+  }
+  const filePath = join2(projectDir, options.relativePath);
+  if (options.onlyIfExists === true && !existsSync2(filePath)) return null;
+  const references = options.references ?? getProviderInstructionReferences(providerId);
+  const body = buildInjectionContent({ references }).trim();
+  const block = buildBlock(body);
+  assertBalancedMarkers(block);
+  const owned = options.preamble !== void 0 ? `${options.preamble}
+${block}
+` : null;
+  return withFileLock(filePath, async () => {
+    const result = (action) => ({
+      filePath,
+      action,
+      providerId: provider.id
+    });
+    if (!existsSync2(filePath)) {
+      if (options.onlyIfExists === true) return null;
+      await writeFileAtomic2({ path: filePath, content: owned ?? `${block}
+` });
+      return result("created");
+    }
+    const existing = await readFile3(filePath, "utf-8");
+    if (existing.length === 0) {
+      assertNotTornRead(filePath, existing, (await stat3(filePath)).size);
+    }
+    if (owned !== null) {
+      if (existing === owned) return result("intact");
+      await writeFileAtomic2({ path: filePath, content: owned });
+      return result("updated");
+    }
+    const hasBlock = parseBlocks(normalizeMarkers(existing).content).length > 0;
+    const base = hasBlock ? existing : stripBareReferenceLines(existing, references).trimEnd();
+    const { content: next, blocksBefore, repaired } = reconcile(base, body, "append");
+    if (next === existing) return result("intact");
+    await writeFileAtomic2({ path: filePath, content: next });
+    if (blocksBefore === 0) return result("added");
+    if (repaired > 0) return result("repaired");
+    if (blocksBefore > 1) return result("consolidated");
+    return result("updated");
+  });
+}
 async function ensureAllProviderInstructionFiles(providerIds, projectDir, options) {
   const results = [];
   const processed = /* @__PURE__ */ new Set();
@@ -988,7 +1209,7 @@ async function writeAgentFileToAllProviders(providerIds, options) {
       continue;
     }
     processed.add(filePath);
-    if (options.skipMissingFolders === true && !existsSync(folder)) {
+    if (options.skipMissingFolders === true && !existsSync2(folder)) {
       continue;
     }
     const action = await inject(filePath, options.content);
@@ -1000,6 +1221,8 @@ async function writeAgentFileToAllProviders(providerIds, options) {
 export {
   withFileLock,
   assertNotTornRead,
+  JsonConfigParseError,
+  updateJsonConfigFile,
   getAllProviders,
   getProvider,
   resolveAlias,
@@ -1022,6 +1245,9 @@ export {
   buildSkillsMap,
   getProviderCapabilities,
   providerSupportsById,
+  HITL_REQUEST_FALLBACK,
+  PROVIDER_ASK_TOOLS,
+  getProviderAskTool,
   EmbeddedDeliveryDowngradeError,
   isEmbeddedDelivery,
   blockPattern,
@@ -1049,8 +1275,9 @@ export {
   checkAllInjections,
   injectAll,
   ensureProviderInstructionFile,
+  ensureProviderRuleFile,
   ensureAllProviderInstructionFiles,
   getProviderAgentFolder,
   writeAgentFileToAllProviders
 };
-//# sourceMappingURL=chunk-CHPNPLOK.js.map
+//# sourceMappingURL=chunk-UIXTFV35.js.map