@cleocode/caamp 2026.4.4 → 2026.4.6

package/dist/cli.js

@@ -8,14 +8,16 @@ import {
   detectProjectProviders,
   discoverSkill,
   discoverSkillsMulti,
+  dispatchInstallSkillAcrossProviders,
+  dispatchRemoveSkillAcrossProviders,
   formatNetworkError,
   formatSkillRecommendations,
+  getHarnessFor,
   getInstalledProviders,
   getSkill,
   getSkillDir,
   getTrackedSkills,
   installBatchWithRollback,
-  installSkill,
   isCatalogAvailable,
   isHuman,
   isMarketplaceScoped,
@@ -29,8 +31,8 @@ import {
   readLockFile,
   recommendSkills,
   recordSkillInstall,
-  removeSkill,
   removeSkillFromLock,
+  resolveDefaultTargetProviders,
   resolveProfile,
   scanDirectory,
   scanFile,
@@ -42,7 +44,7 @@ import {
   tokenizeCriteriaValue,
   updateInstructionsSingleOperation,
   validateSkill
-} from "./chunk-6NBM4CAF.js";
+} from "./chunk-43GULI6J.js";
 import {
   buildSkillsMap,
   checkAllInjections,
@@ -55,7 +57,7 @@ import {
   groupByInstructFile,
   injectAll,
   providerSupports
-} from "./chunk-CRU25LRL.js";
+} from "./chunk-KWYLZ46H.js";
 import {
   CANONICAL_HOOK_EVENTS,
   buildHookMatrix,
@@ -64,12 +66,12 @@ import {
   getHookSupport,
   getProviderSummary,
   translateToAll
-} from "./chunk-FLBRAXDW.js";
+} from "./chunk-CU2VX67L.js";
 import {
   buildSkillSubPathCandidates,
   resolveProviderConfigPath,
   resolveProviderSkillsDir
-} from "./chunk-XWQ5WPHC.js";
+} from "./chunk-364OHA2T.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -200,13 +202,13 @@ async function runLafsCommand(command, mvi, action) {
 }
 
 // src/commands/advanced/common.ts
-var VALID_PRIORITIES = /* @__PURE__ */ new Set(["high", "medium", "low"]);
+var VALID_PRIORITIES = /* @__PURE__ */ new Set(["primary", "high", "medium", "low"]);
 function parsePriority(value) {
   if (!VALID_PRIORITIES.has(value)) {
     throw new LAFSCommandError(
       "E_ADVANCED_VALIDATION_PRIORITY",
       `Invalid tier: ${value}`,
-      "Use one of: high, medium, low."
+      "Use one of: primary, high, medium, low."
     );
   }
   return value;
@@ -217,7 +219,7 @@ function resolveProviders(options) {
   }
   const targetAgents = options.agent ?? [];
   if (targetAgents.length === 0) {
-    return getInstalledProviders();
+    return resolveDefaultTargetProviders();
   }
   const providers = targetAgents.map((id) => getProvider(id)).filter((provider) => provider !== void 0);
   if (providers.length !== targetAgents.length) {
@@ -471,7 +473,7 @@ function registerAdvancedProviders(parent) {
           id: provider.id,
           priority: provider.priority,
           status: provider.status,
-          configFormat: provider.configFormat
+          configFormat: provider.capabilities.mcp?.configFormat ?? null
         }))
       };
     })
@@ -644,7 +646,24 @@ function registerConfigCommand(program2) {
         process.exit(1);
       }
       const scope = opts.global ? "global" : "project";
-      const configPath = resolveProviderConfigPath(provider, scope) ?? provider.configPathGlobal;
+      const mcp = provider.capabilities.mcp;
+      if (!mcp) {
+        const message = `${provider.toolName} has no MCP config integration (extension-based harness)`;
+        if (format === "json") {
+          emitJsonError(
+            operation,
+            mvi,
+            ErrorCodes.PROVIDER_NOT_FOUND,
+            message,
+            ErrorCategories.VALIDATION,
+            { providerId }
+          );
+        } else {
+          console.log(pc.dim(message));
+        }
+        process.exit(1);
+      }
+      const configPath = resolveProviderConfigPath(provider, scope) ?? mcp.configPathGlobal;
       if (!existsSync(configPath)) {
         const message = `No config file at: ${configPath}`;
         if (format === "json") {
@@ -665,12 +684,12 @@ function registerConfigCommand(program2) {
         process.exit(1);
       }
       try {
-        const data = await readConfig(configPath, provider.configFormat);
+        const data = await readConfig(configPath, mcp.configFormat);
         if (format === "json") {
           outputSuccess(operation, mvi, {
             provider: provider.id,
             config: data,
-            format: provider.configFormat,
+            format: mcp.configFormat,
             scope
           });
           return;
@@ -702,15 +721,22 @@ ${provider.toolName} config (${configPath}):
       console.error(pc.red(`Provider not found: ${providerId}`));
       process.exit(1);
     }
+    const mcp = provider.capabilities.mcp;
+    if (!mcp) {
+      console.error(
+        pc.red(`${provider.toolName} has no MCP config integration (extension-based harness)`)
+      );
+      process.exit(1);
+    }
     if (scope === "global") {
-      console.log(provider.configPathGlobal);
+      console.log(mcp.configPathGlobal);
     } else {
       const projectPath = resolveProviderConfigPath(provider, "project");
       if (projectPath) {
         console.log(projectPath);
       } else {
         console.log(pc.dim(`${provider.toolName} has no project-level config`));
-        console.log(provider.configPathGlobal);
+        console.log(mcp.configPathGlobal);
       }
     }
   });
@@ -773,8 +799,13 @@ function checkRegistry() {
     checks.push({ label: `${count} providers loaded`, status: "pass" });
     const malformed = [];
     for (const p of providers) {
-      if (!p.id || !p.toolName || !p.configKey || !p.configFormat) {
+      if (!p.id || !p.toolName) {
         malformed.push(p.id || "(unknown)");
+        continue;
+      }
+      const mcp = p.capabilities.mcp;
+      if (mcp && (!mcp.configKey || !mcp.configFormat)) {
+        malformed.push(p.id);
       }
     }
     if (malformed.length === 0) {
@@ -971,7 +1002,15 @@ async function checkConfigFiles() {
   const installed = results.filter((r) => r.installed);
   for (const r of installed) {
     const provider = r.provider;
-    const configPath = provider.configPathGlobal;
+    const mcp = provider.capabilities.mcp;
+    if (!mcp) {
+      checks.push({
+        label: `${provider.id}: no MCP integration (extension-based harness)`,
+        status: "pass"
+      });
+      continue;
+    }
+    const configPath = mcp.configPathGlobal;
     if (!existsSync2(configPath)) {
       checks.push({
         label: `${provider.id}: no config file found`,
@@ -981,7 +1020,7 @@ async function checkConfigFiles() {
       continue;
     }
     try {
-      await readConfig(configPath, provider.configFormat);
+      await readConfig(configPath, mcp.configFormat);
       const relPath = configPath.replace(homedir(), "~");
       checks.push({
         label: `${provider.id}: ${relPath} readable`,
@@ -1046,9 +1085,11 @@ function registerDoctorCommand(program2) {
       }
       const npmVersion = getNpmVersion() ?? "not found";
       const allProviders = getAllProviders();
-      const malformedCount = allProviders.filter(
-        (p) => !p.id || !p.toolName || !p.configKey || !p.configFormat
-      ).length;
+      const malformedCount = allProviders.filter((p) => {
+        if (!p.id || !p.toolName) return true;
+        const mcp = p.capabilities.mcp;
+        return mcp !== null && (!mcp.configKey || !mcp.configFormat);
+      }).length;
       const detectionResults = detectAllProviders();
       const installedProviders = detectionResults.filter((r) => r.installed);
       const { canonicalCount, brokenCount, staleCount } = countSkillIssues();
@@ -1206,7 +1247,7 @@ function registerInstructionsCheck(parent) {
       } else if (opts.agent.length > 0) {
         providers = opts.agent.map((a) => getProvider(a)).filter((p) => p !== void 0);
       } else {
-        providers = getInstalledProviders();
+        providers = resolveDefaultTargetProviders();
       }
       const scope = opts.global ? "global" : "project";
       const results = await checkAllInjections(providers, process.cwd(), scope);
@@ -1292,7 +1333,7 @@ function registerInstructionsInject(parent) {
       } else if (opts.agent.length > 0) {
         providers = opts.agent.map((a) => getProvider(a)).filter((p) => p !== void 0);
       } else {
-        providers = getInstalledProviders();
+        providers = resolveDefaultTargetProviders();
       }
       if (providers.length === 0) {
         const message = "No providers found.";
@@ -1335,7 +1376,37 @@ function registerInstructionsInject(parent) {
         }
         return;
       }
-      const results = await injectAll(providers, process.cwd(), scope, content);
+      const harnessProviders = [];
+      const genericProviders = [];
+      for (const p of providers) {
+        if (getHarnessFor(p) !== null) {
+          harnessProviders.push(p);
+        } else {
+          genericProviders.push(p);
+        }
+      }
+      const results = /* @__PURE__ */ new Map();
+      const harnessScope = scope === "global" ? { kind: "global" } : { kind: "project", projectDir: process.cwd() };
+      for (const provider of harnessProviders) {
+        const harness = getHarnessFor(provider);
+        if (harness === null) continue;
+        try {
+          await harness.injectInstructions(content, harnessScope);
+          results.set(`${provider.id}:AGENTS.md`, "updated");
+        } catch (err) {
+          if (format === "human") {
+            console.log(
+              pc4.red(`  x ${provider.id}: ${err instanceof Error ? err.message : String(err)}`)
+            );
+          }
+        }
+      }
+      if (genericProviders.length > 0) {
+        const genericResults = await injectAll(genericProviders, process.cwd(), scope, content);
+        for (const [file, action] of genericResults) {
+          results.set(file, action);
+        }
+      }
       const injected = [];
       for (const [file] of results) {
         injected.push(file);
@@ -1382,12 +1453,21 @@ function registerInstructionsUpdate(parent) {
       );
       process.exit(1);
     }
-    const providers = getInstalledProviders();
+    const providers = resolveDefaultTargetProviders();
     const scope = opts.global ? "global" : "project";
     const content = generateInjectionContent();
-    const checks = await checkAllInjections(providers, process.cwd(), scope, content);
+    const harnessProviders = [];
+    const genericProviders = [];
+    for (const provider of providers) {
+      if (getHarnessFor(provider) !== null) {
+        harnessProviders.push(provider);
+      } else {
+        genericProviders.push(provider);
+      }
+    }
+    const checks = await checkAllInjections(genericProviders, process.cwd(), scope, content);
     const needsUpdate = checks.filter((c) => c.status !== "current");
-    if (needsUpdate.length === 0) {
+    if (harnessProviders.length === 0 && needsUpdate.length === 0) {
       if (format === "json") {
         outputSuccess(operation, mvi, {
           updated: [],
@@ -1399,7 +1479,7 @@ function registerInstructionsUpdate(parent) {
       }
       return;
     }
-    if (format === "human") {
+    if (format === "human" && needsUpdate.length > 0) {
       console.log(pc5.bold(`${needsUpdate.length} file(s) need updating:
 `));
       for (const c of needsUpdate) {
@@ -1407,8 +1487,23 @@ function registerInstructionsUpdate(parent) {
       }
     }
     const providerIds = new Set(needsUpdate.map((c) => c.provider));
-    const toUpdate = providers.filter((p) => providerIds.has(p.id));
+    const toUpdate = genericProviders.filter((p) => providerIds.has(p.id));
     const results = await injectAll(toUpdate, process.cwd(), scope, content);
+    const harnessScope = scope === "global" ? { kind: "global" } : { kind: "project", projectDir: process.cwd() };
+    const harnessFailures = [];
+    for (const provider of harnessProviders) {
+      const harness = getHarnessFor(provider);
+      if (harness === null) continue;
+      try {
+        await harness.injectInstructions(content, harnessScope);
+        results.set(`${provider.id}:AGENTS.md`, "updated");
+      } catch (err) {
+        harnessFailures.push({
+          provider: provider.id,
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
+    }
     const updated = [];
     for (const [file] of results) {
       updated.push(file);
@@ -1418,14 +1513,17 @@ function registerInstructionsUpdate(parent) {
       for (const [file, action] of results) {
         console.log(`  ${pc5.green("\u2713")} ${file} (${action})`);
       }
+      for (const failure of harnessFailures) {
+        console.log(`  ${pc5.red("x")} ${failure.provider}: ${failure.error}`);
+      }
       console.log(pc5.bold(`
 ${results.size} file(s) updated.`));
     }
     if (format === "json") {
       outputSuccess(operation, mvi, {
         updated,
-        failed: [],
-        count: { updated: updated.length, failed: 0 }
+        failed: harnessFailures,
+        count: { updated: updated.length, failed: harnessFailures.length }
       });
     }
   });
@@ -1603,16 +1701,23 @@ ${provider.toolName}`));
     console.log(`  Priority:        ${provider.priority}`);
     console.log();
     console.log(`  Instruction:     ${provider.instructFile}`);
-    console.log(`  Config format:   ${provider.configFormat}`);
-    console.log(`  Config key:      ${provider.configKey}`);
-    console.log(`  Transports:      ${provider.supportedTransports.join(", ")}`);
-    console.log(`  Headers:         ${provider.supportsHeaders ? "yes" : "no"}`);
+    const mcp = provider.capabilities.mcp;
+    if (mcp) {
+      console.log(`  Config format:   ${mcp.configFormat}`);
+      console.log(`  Config key:      ${mcp.configKey}`);
+      console.log(`  Transports:      ${mcp.supportedTransports.join(", ")}`);
+      console.log(`  Headers:         ${mcp.supportsHeaders ? "yes" : "no"}`);
+    } else {
+      console.log(`  MCP integration: ${pc6.dim("(none \u2014 extension-based harness)")}`);
+    }
     console.log();
     console.log(pc6.dim("  Paths:"));
     console.log(`  Global dir:      ${provider.pathGlobal}`);
     console.log(`  Project dir:     ${provider.pathProject || "(none)"}`);
-    console.log(`  Global config:   ${provider.configPathGlobal}`);
-    console.log(`  Project config:  ${provider.configPathProject || "(none)"}`);
+    if (mcp) {
+      console.log(`  Global config:   ${mcp.configPathGlobal}`);
+      console.log(`  Project config:  ${mcp.configPathProject || "(none)"}`);
+    }
     console.log(`  Global skills:   ${provider.pathSkills}`);
     console.log(`  Project skills:  ${provider.pathProjectSkills || "(none)"}`);
     console.log();
@@ -1843,7 +1948,7 @@ CAMP Hook Support (mappings v${getHookMappingsVersion()})
         return;
       }
       if (opts.from) {
-        const { toCanonical } = await import("./hooks-VLIP52LY.js");
+        const { toCanonical } = await import("./hooks-M2DMKNHI.js");
         const canonical2 = toCanonical(event, opts.from);
         if (format === "json") {
           const envelope = buildEnvelope2(
@@ -1883,7 +1988,7 @@ CAMP Hook Support (mappings v${getHookMappingsVersion()})
         }
         process.exit(1);
       }
-      const { getMappedProviderIds } = await import("./hooks-VLIP52LY.js");
+      const { getMappedProviderIds } = await import("./hooks-M2DMKNHI.js");
       const allIds = getMappedProviderIds();
       const translations = translateToAll(canonical, allIds);
       if (format === "json") {
@@ -2784,7 +2889,7 @@ function registerSkillsInstall(parent) {
       } else if (opts.agent.length > 0) {
         providers = opts.agent.map((a) => getProvider(a)).filter((p) => p !== void 0);
       } else {
-        providers = getInstalledProviders();
+        providers = resolveDefaultTargetProviders();
       }
       if (providers.length === 0) {
         const message = "No target providers found. Use --agent or --all.";
@@ -2982,7 +3087,12 @@ function registerSkillsInstall(parent) {
           console.error(pc11.red(message));
           process.exit(1);
         }
-        const result = await installSkill(localPath, skillName, providers, opts.global ?? false);
+        const result = await dispatchInstallSkillAcrossProviders(
+          localPath,
+          skillName,
+          providers,
+          opts.global ?? false
+        );
         if (result.success) {
           const isGlobal = sourceType === "library" || sourceType === "package" ? true : opts.global ?? false;
           await recordSkillInstall(
@@ -3104,7 +3214,7 @@ async function handleProfileInstall(profileName, providers, isGlobal, format, op
   for (const name of profileSkills) {
     const skillDir = getSkillDir(name);
     try {
-      const result = await installSkill(skillDir, name, providers, isGlobal);
+      const result = await dispatchInstallSkillAcrossProviders(skillDir, name, providers, isGlobal);
       if (result.success) {
         if (format === "human") {
           console.log(pc11.green(`  + ${name}`));
@@ -3294,10 +3404,10 @@ function registerSkillsList(parent) {
       }
       dirs = opts.global ? [resolveProviderSkillsDir(provider, "global")] : [resolveProviderSkillsDir(provider, "project")];
     } else if (opts.global) {
-      const providers = getInstalledProviders();
+      const providers = resolveDefaultTargetProviders();
       dirs = providers.map((p) => resolveProviderSkillsDir(p, "global")).filter(Boolean);
     } else {
-      const providers = getInstalledProviders();
+      const providers = resolveDefaultTargetProviders();
       dirs = providers.map((p) => resolveProviderSkillsDir(p, "project")).filter(Boolean);
     }
     const skills = await discoverSkillsMulti(dirs);
@@ -3390,9 +3500,13 @@ function registerSkillsRemove(parent) {
         );
         process.exit(1);
       }
-      const providers = getInstalledProviders();
+      const providers = resolveDefaultTargetProviders();
       if (name) {
-        const result = await removeSkill(name, providers, opts.global ?? false);
+        const result = await dispatchRemoveSkillAcrossProviders(
+          name,
+          providers,
+          opts.global ?? false
+        );
         const removed = result.removed;
         const count = {
           removed: removed.length,
@@ -3594,7 +3708,7 @@ ${outdated.length} skill(s) have updates available:
             skipped.push(skill.name);
             continue;
           }
-          const installResult = await installSkill(
+          const installResult = await dispatchInstallSkillAcrossProviders(
             localPath,
             skill.name,
             providers,