@cleocode/caamp 1.5.1 → 1.6.0

package/dist/cli.js

@@ -7,6 +7,7 @@ import {
   buildCleoProfile,
   buildServerConfig,
   buildSkillSubPathCandidates,
+  buildSkillsMap,
   checkAllInjections,
   checkCommandReachability,
   checkSkillUpdate,
@@ -21,9 +22,11 @@ import {
   formatSkillRecommendations,
   generateInjectionContent,
   getAllProviders,
+  getCommonHookEvents,
   getInstalledProviders,
   getProvider,
   getProviderCount,
+  getProvidersByHookEvent,
   getProvidersByPriority,
   getRegistryVersion,
   getSkill,
@@ -47,6 +50,7 @@ import {
   normalizeCleoChannel,
   parseEnvAssignments,
   parseSource,
+  providerSupports,
   readConfig,
   readLockFile,
   recommendSkills,
@@ -74,7 +78,7 @@ import {
   tokenizeCriteriaValue,
   updateInstructionsSingleOperation,
   validateSkill
-} from "./chunk-ZEXRZTQX.js";
+} from "./chunk-N5E7BZM2.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -2873,6 +2877,241 @@ ${provider.toolName}`));
     console.log(`  Project skills:  ${provider.pathProjectSkills || "(none)"}`);
     console.log();
   });
+  providers.command("skills-map").description("Show skills path map for all providers").option("--json", "Output as JSON (default)").option("--human", "Output in human-readable format").option("--provider <id>", "Filter to a specific provider").action(async (opts) => {
+    const operation = "providers.skills-map";
+    const mvi = "standard";
+    let format;
+    try {
+      format = resolveOutputFormat2({
+        jsonFlag: opts.json ?? false,
+        humanFlag: (opts.human ?? false) || isHuman(),
+        projectDefault: "json"
+      }).format;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      emitJsonError2(operation, mvi, "E_FORMAT_CONFLICT", message, "VALIDATION");
+      process.exit(1);
+    }
+    let map = buildSkillsMap();
+    if (opts.provider) {
+      map = map.filter((entry) => entry.providerId === opts.provider);
+      if (map.length === 0) {
+        const message = `Provider not found: ${opts.provider}`;
+        if (format === "json") {
+          emitJsonError2(operation, mvi, "E_PROVIDER_NOT_FOUND", message, "NOT_FOUND", {
+            id: opts.provider
+          });
+        } else {
+          console.error(pc11.red(message));
+        }
+        process.exit(1);
+      }
+    }
+    if (format === "json") {
+      const envelope = buildEnvelope4(
+        operation,
+        mvi,
+        {
+          skillsMap: map,
+          count: map.length
+        },
+        null
+      );
+      console.log(JSON.stringify(envelope, null, 2));
+      return;
+    }
+    console.log(pc11.bold("\nProvider Skills Map\n"));
+    console.log(
+      `  ${pc11.bold("Provider".padEnd(22))} ${pc11.bold("Precedence".padEnd(30))} ${pc11.bold("Global Path".padEnd(40))} ${pc11.bold("Project Path")}`
+    );
+    console.log(`  ${"\u2500".repeat(22)} ${"\u2500".repeat(30)} ${"\u2500".repeat(40)} ${"\u2500".repeat(30)}`);
+    for (const entry of map) {
+      console.log(
+        `  ${entry.toolName.padEnd(22)} ${entry.precedence.padEnd(30)} ${(entry.paths.global ?? "-").padEnd(40)} ${entry.paths.project ?? "-"}`
+      );
+    }
+    console.log(pc11.dim(`
+  ${map.length} providers shown`));
+    console.log();
+  });
+  providers.command("hooks").description("Show provider hook event support").option("--json", "Output as JSON (default)").option("--human", "Output in human-readable format").option("--event <event>", "Filter to providers supporting a specific hook event").option("--common", "Show hook events common to all providers").action(async (opts) => {
+    const operation = "providers.hooks";
+    const mvi = "standard";
+    let format;
+    try {
+      format = resolveOutputFormat2({
+        jsonFlag: opts.json ?? false,
+        humanFlag: (opts.human ?? false) || isHuman(),
+        projectDefault: "json"
+      }).format;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      emitJsonError2(operation, mvi, "E_FORMAT_CONFLICT", message, "VALIDATION");
+      process.exit(1);
+    }
+    if (opts.event) {
+      const event = opts.event;
+      const matching = getProvidersByHookEvent(event);
+      if (format === "json") {
+        const envelope = buildEnvelope4(
+          operation,
+          mvi,
+          {
+            event,
+            providers: matching.map((p) => ({
+              id: p.id,
+              toolName: p.toolName,
+              supportedEvents: p.capabilities.hooks.supported
+            })),
+            count: matching.length
+          },
+          null
+        );
+        console.log(JSON.stringify(envelope, null, 2));
+        return;
+      }
+      console.log(pc11.bold(`
+Providers supporting ${pc11.green(event)}:
+`));
+      if (matching.length === 0) {
+        console.log(pc11.dim("  No providers support this event."));
+      } else {
+        for (const p of matching) {
+          console.log(`  ${pc11.bold(p.toolName.padEnd(22))} ${pc11.dim(p.id)}`);
+        }
+      }
+      console.log();
+      return;
+    }
+    if (opts.common) {
+      const common = getCommonHookEvents();
+      if (format === "json") {
+        const envelope = buildEnvelope4(
+          operation,
+          mvi,
+          {
+            commonEvents: common,
+            count: common.length
+          },
+          null
+        );
+        console.log(JSON.stringify(envelope, null, 2));
+        return;
+      }
+      console.log(pc11.bold("\nHook events common to all providers:\n"));
+      if (common.length === 0) {
+        console.log(pc11.dim("  No events are common to all providers."));
+      } else {
+        for (const event of common) {
+          console.log(`  ${pc11.green(event)}`);
+        }
+      }
+      console.log();
+      return;
+    }
+    const all = getAllProviders();
+    const withHooks = all.filter((p) => p.capabilities.hooks.supported.length > 0);
+    if (format === "json") {
+      const envelope = buildEnvelope4(
+        operation,
+        mvi,
+        {
+          providers: all.map((p) => ({
+            id: p.id,
+            toolName: p.toolName,
+            supportedEvents: p.capabilities.hooks.supported
+          })),
+          withHooksCount: withHooks.length,
+          totalCount: all.length
+        },
+        null
+      );
+      console.log(JSON.stringify(envelope, null, 2));
+      return;
+    }
+    console.log(pc11.bold(`
+Provider Hook Support
+`));
+    if (withHooks.length === 0) {
+      console.log(pc11.dim("  No providers have hook support."));
+    } else {
+      for (const p of withHooks) {
+        console.log(`  ${pc11.bold(p.toolName.padEnd(22))} ${pc11.dim(p.capabilities.hooks.supported.join(", "))}`);
+      }
+    }
+    const withoutHooks = all.length - withHooks.length;
+    if (withoutHooks > 0) {
+      console.log(pc11.dim(`
+  ${withoutHooks} providers without hook support`));
+    }
+    console.log();
+  });
+  providers.command("capabilities").description("Show provider capability matrix").option("--json", "Output as JSON (default)").option("--human", "Output in human-readable format").option("--filter <path>", "Filter to providers supporting a capability dot-path (e.g. spawn.supportsSubagents)").action(async (opts) => {
+    const operation = "providers.capabilities";
+    const mvi = "standard";
+    let format;
+    try {
+      format = resolveOutputFormat2({
+        jsonFlag: opts.json ?? false,
+        humanFlag: (opts.human ?? false) || isHuman(),
+        projectDefault: "json"
+      }).format;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      emitJsonError2(operation, mvi, "E_FORMAT_CONFLICT", message, "VALIDATION");
+      process.exit(1);
+    }
+    let all = getAllProviders();
+    if (opts.filter) {
+      all = all.filter((p) => providerSupports(p, opts.filter));
+    }
+    const matrix = all.map((p) => ({
+      id: p.id,
+      toolName: p.toolName,
+      skillsPrecedence: p.capabilities.skills.precedence,
+      hooksCount: p.capabilities.hooks.supported.length,
+      spawnMechanism: p.capabilities.spawn.spawnMechanism,
+      spawnFlags: {
+        supportsSubagents: p.capabilities.spawn.supportsSubagents,
+        supportsProgrammaticSpawn: p.capabilities.spawn.supportsProgrammaticSpawn,
+        supportsInterAgentComms: p.capabilities.spawn.supportsInterAgentComms,
+        supportsParallelSpawn: p.capabilities.spawn.supportsParallelSpawn
+      }
+    }));
+    if (format === "json") {
+      const envelope = buildEnvelope4(
+        operation,
+        mvi,
+        {
+          capabilities: matrix,
+          count: matrix.length,
+          filter: opts.filter || null
+        },
+        null
+      );
+      console.log(JSON.stringify(envelope, null, 2));
+      return;
+    }
+    console.log(pc11.bold("\nProvider Capability Matrix\n"));
+    if (opts.filter) {
+      console.log(pc11.dim(`  Filter: ${opts.filter}
+`));
+    }
+    console.log(
+      `  ${pc11.bold("Provider".padEnd(22))} ${pc11.bold("Skills Precedence".padEnd(20))} ${pc11.bold("Hooks".padEnd(8))} ${pc11.bold("Spawn")}`
+    );
+    console.log(`  ${"\u2500".repeat(22)} ${"\u2500".repeat(20)} ${"\u2500".repeat(8)} ${"\u2500".repeat(20)}`);
+    for (const row of matrix) {
+      const hooks = row.hooksCount > 0 ? String(row.hooksCount) : "-";
+      const spawn = row.spawnMechanism ?? "-";
+      console.log(
+        `  ${row.toolName.padEnd(22)} ${row.skillsPrecedence.padEnd(20)} ${hooks.padEnd(8)} ${spawn}`
+      );
+    }
+    console.log(pc11.dim(`
+  ${matrix.length} providers shown`));
+    console.log();
+  });
 }
 function buildEnvelope4(operation, mvi, result, error) {
   return {