@cleocode/caamp 1.8.1 → 1.9.1

package/dist/cli.js

@@ -61,26 +61,35 @@ import {
   tokenizeCriteriaValue,
   updateInstructionsSingleOperation,
   validateSkill
-} from "./chunk-LDTYDQGR.js";
+} from "./chunk-ZF4W3K5H.js";
 import {
-  buildSkillSubPathCandidates,
   buildSkillsMap,
   checkAllInjections,
   generateInjectionContent,
   getAllProviders,
-  getCommonHookEvents,
   getProvider,
   getProviderCount,
-  getProvidersByHookEvent,
   getProvidersByPriority,
   getRegistryVersion,
   groupByInstructFile,
   injectAll,
-  providerSupports,
+  providerSupports
+} from "./chunk-O7IVK5JY.js";
+import {
+  CANONICAL_HOOK_EVENTS,
+  buildHookMatrix,
+  getCommonEvents,
+  getHookMappingsVersion,
+  getHookSupport,
+  getProviderSummary,
+  translateToAll
+} from "./chunk-J7UN457C.js";
+import {
+  buildSkillSubPathCandidates,
   resolvePreferredConfigScope,
   resolveProviderConfigPath,
   resolveProviderSkillsDir
-} from "./chunk-CPHF5IM4.js";
+} from "./chunk-TI6WOJDG.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -94,11 +103,17 @@ import {
   isRegisteredErrorCode
 } from "@cleocode/lafs-protocol";
 var LAFSCommandError = class extends Error {
+  /** LAFS error code identifying the failure type. */
   code;
+  /** LAFS error category inferred from the error code. */
   category;
+  /** Whether the operation can be retried after fixing the root cause. */
   recoverable;
+  /** Human-readable suggestion for resolving the error. */
   suggestion;
+  /** Optional delay in milliseconds before retrying, or null. */
   retryAfterMs;
+  /** Optional additional error details payload. */
   details;
   constructor(code, message, suggestion, recoverable = true, details) {
     super(message);
@@ -2936,8 +2951,69 @@ ${provider.toolName}`));
   ${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 hooks = providers.command("hooks").description("Show provider hook event support");
+  hooks.command("list", { isDefault: true }).description("Show all providers with their hook support summary").option("--json", "Output as JSON (default)").option("--human", "Output in human-readable format").action(async (opts) => {
+    const operation = "providers.hooks.list";
+    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);
+    }
+    const all = getAllProviders();
+    const summaries = all.map((p) => getProviderSummary(p.id)).filter((s) => s !== void 0);
+    if (format === "json") {
+      const envelope = buildEnvelope4(
+        operation,
+        mvi,
+        {
+          mappingsVersion: getHookMappingsVersion(),
+          canonicalEventCount: CANONICAL_HOOK_EVENTS.length,
+          providers: summaries
+        },
+        null
+      );
+      console.log(JSON.stringify(envelope, null, 2));
+      return;
+    }
+    console.log(pc11.bold(`
+CAMP Hook Support (mappings v${getHookMappingsVersion()})
+`));
+    console.log(pc11.dim(`  ${CANONICAL_HOOK_EVENTS.length} canonical events defined
+`));
+    console.log(
+      `  ${pc11.bold("Provider".padEnd(22))} ${pc11.bold("System".padEnd(10))} ${pc11.bold("Coverage".padEnd(12))} ${pc11.bold("Supported".padEnd(12))} ${pc11.bold("Provider-Only")}`
+    );
+    console.log(`  ${"\u2500".repeat(22)} ${"\u2500".repeat(10)} ${"\u2500".repeat(12)} ${"\u2500".repeat(12)} ${"\u2500".repeat(20)}`);
+    for (const s of summaries) {
+      if (!s) continue;
+      const system = s.hookSystem === "none" ? pc11.dim("none") : s.experimental ? pc11.yellow(s.hookSystem + "*") : pc11.green(s.hookSystem);
+      const coverage = s.coverage > 0 ? (s.coverage >= 75 ? pc11.green : s.coverage >= 40 ? pc11.yellow : pc11.dim)(`${s.coverage}%`) : pc11.dim("0%");
+      const supported = s.supportedCount > 0 ? `${s.supportedCount}/${s.totalCanonical}` : pc11.dim("0");
+      const provOnly = s.providerOnly.length > 0 ? String(s.providerOnly.length) : pc11.dim("-");
+      const provider = getProvider(s.providerId);
+      const name = provider?.toolName ?? s.providerId;
+      console.log(
+        `  ${name.padEnd(22)} ${system.padEnd(20)} ${coverage.padEnd(22)} ${supported.padEnd(22)} ${provOnly}`
+      );
+    }
+    const withHooks = summaries.filter((s) => s && s.supportedCount > 0);
+    console.log(pc11.dim(`
+  ${withHooks.length} providers with hook support, ${summaries.length - withHooks.length} without`));
+    if (summaries.some((s) => s?.experimental)) {
+      console.log(pc11.dim("  * = experimental hook system"));
+    }
+    console.log();
+  });
+  hooks.command("matrix").description("Show cross-provider hook support matrix").option("--json", "Output as JSON (default)").option("--human", "Output in human-readable format").option("--provider <ids>", "Comma-separated provider IDs to compare").action(async (opts) => {
+    const operation = "providers.hooks.matrix";
     const mvi = "standard";
     let format;
     try {
@@ -2951,102 +3027,144 @@ ${provider.toolName}`));
       emitJsonError2(operation, mvi, "E_FORMAT_CONFLICT", message, "VALIDATION");
       process.exit(1);
     }
-    if (opts.event) {
-      const event = opts.event;
-      const matching = getProvidersByHookEvent(event);
+    const ids = opts.provider?.split(",").map((s) => s.trim());
+    const matrix = buildHookMatrix(ids);
+    if (format === "json") {
+      const envelope = buildEnvelope4(operation, mvi, { matrix }, null);
+      console.log(JSON.stringify(envelope, null, 2));
+      return;
+    }
+    const providerNames = matrix.providers.map((id) => {
+      const p = getProvider(id);
+      return (p?.toolName ?? id).slice(0, 14);
+    });
+    console.log(pc11.bold("\nHook Support Matrix\n"));
+    const eventCol = "CAAMP Event".padEnd(22);
+    const provCols = providerNames.map((n) => pc11.bold(n.padEnd(16))).join("");
+    console.log(`  ${pc11.bold(eventCol)} ${provCols}`);
+    console.log(`  ${"\u2500".repeat(22)} ${providerNames.map(() => "\u2500".repeat(16)).join("")}`);
+    for (const event of matrix.events) {
+      const cells = matrix.providers.map((id) => {
+        const m = matrix.matrix[event][id];
+        if (!m?.supported) return pc11.dim("\xB7".padEnd(16));
+        return pc11.green((m.nativeName ?? "?").slice(0, 14).padEnd(16));
+      }).join("");
+      console.log(`  ${event.padEnd(22)} ${cells}`);
+    }
+    const commonEvents = getCommonEvents(matrix.providers);
+    console.log(pc11.dim(`
+  Common events: ${commonEvents.length > 0 ? commonEvents.join(", ") : "none"}`));
+    console.log();
+  });
+  hooks.command("translate").description("Translate a hook event name between CAAMP canonical and provider-native").argument("<event>", "Hook event name (canonical or native)").option("--to <provider>", "Target provider ID for canonical\u2192native translation").option("--from <provider>", "Source provider ID for native\u2192canonical translation").option("--json", "Output as JSON (default)").option("--human", "Output in human-readable format").action(async (event, opts) => {
+    const operation = "providers.hooks.translate";
+    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.to) {
+      const canonical2 = event;
+      if (!CANONICAL_HOOK_EVENTS.includes(canonical2)) {
+        const msg = `Unknown canonical event: ${event}. Valid: ${CANONICAL_HOOK_EVENTS.join(", ")}`;
+        if (format === "json") {
+          emitJsonError2(operation, mvi, "E_UNKNOWN_EVENT", msg, "VALIDATION");
+        } else {
+          console.error(pc11.red(msg));
+        }
+        process.exit(1);
+      }
+      const result = getHookSupport(canonical2, opts.to);
       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
-        );
+        const envelope = buildEnvelope4(operation, mvi, {
+          direction: "canonical-to-native",
+          providerId: opts.to,
+          ...result
+        }, 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)}`);
+        if (result.supported) {
+          console.log(`
+  ${pc11.green(event)} \u2192 ${pc11.bold(result.native)} (${opts.to})`);
+          if (result.notes) console.log(pc11.dim(`  Note: ${result.notes}`));
+        } else {
+          console.log(`
+  ${pc11.red(event)} \u2192 ${pc11.dim("not supported")} (${opts.to})`);
         }
+        console.log();
       }
-      console.log();
       return;
     }
-    if (opts.common) {
-      const common = getCommonHookEvents();
+    if (opts.from) {
+      const { toCanonical } = await import("./hooks-E2XQ7TQG.js");
+      const canonical2 = toCanonical(event, opts.from);
       if (format === "json") {
-        const envelope = buildEnvelope4(
-          operation,
-          mvi,
-          {
-            commonEvents: common,
-            count: common.length
-          },
-          null
-        );
+        const envelope = buildEnvelope4(operation, mvi, {
+          direction: "native-to-canonical",
+          native: event,
+          providerId: opts.from,
+          canonical: canonical2,
+          supported: canonical2 !== null
+        }, 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)}`);
+        if (canonical2) {
+          console.log(`
+  ${pc11.bold(event)} (${opts.from}) \u2192 ${pc11.green(canonical2)}`);
+        } else {
+          console.log(`
+  ${pc11.bold(event)} (${opts.from}) \u2192 ${pc11.dim("no canonical mapping (provider-only event)")}`);
         }
+        console.log();
       }
-      console.log();
       return;
     }
-    const all = getAllProviders();
-    const withHooks = all.filter((p) => p.capabilities.hooks.supported.length > 0);
+    const canonical = event;
+    if (!CANONICAL_HOOK_EVENTS.includes(canonical)) {
+      const msg = `Unknown canonical event: ${event}. Use --from <provider> for native names, or valid canonical: ${CANONICAL_HOOK_EVENTS.join(", ")}`;
+      if (format === "json") {
+        emitJsonError2(operation, mvi, "E_UNKNOWN_EVENT", msg, "VALIDATION");
+      } else {
+        console.error(pc11.red(msg));
+      }
+      process.exit(1);
+    }
+    const { getMappedProviderIds } = await import("./hooks-E2XQ7TQG.js");
+    const allIds = getMappedProviderIds();
+    const translations = translateToAll(canonical, allIds);
     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
-      );
+      const envelope = buildEnvelope4(operation, mvi, {
+        direction: "canonical-to-all",
+        canonical: event,
+        translations,
+        supportedCount: Object.keys(translations).length,
+        totalProviders: allIds.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(", "))}`);
+      console.log(pc11.bold(`
+  ${event} across providers:
+`));
+      for (const id of allIds) {
+        const native = translations[id];
+        const provider = getProvider(id);
+        const name = (provider?.toolName ?? id).padEnd(22);
+        if (native) {
+          console.log(`  ${pc11.green("\u2713")} ${name} ${pc11.bold(native)}`);
+        } else {
+          console.log(`  ${pc11.dim("\xB7")} ${name} ${pc11.dim("not supported")}`);
+        }
       }
+      console.log();
     }
-    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";
@@ -3104,10 +3222,10 @@ Provider Hook Support
     );
     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 hooks2 = row.hooksCount > 0 ? String(row.hooksCount) : "-";
       const spawn = row.spawnMechanism ?? "-";
       console.log(
-        `  ${row.toolName.padEnd(22)} ${row.skillsPrecedence.padEnd(20)} ${hooks.padEnd(8)} ${spawn}`
+        `  ${row.toolName.padEnd(22)} ${row.skillsPrecedence.padEnd(20)} ${hooks2.padEnd(8)} ${spawn}`
       );
     }
     console.log(pc11.dim(`