@cleocode/caamp 1.8.1 → 1.9.0

package/dist/chunk-TRIXT4T7.js

@@ -0,0 +1,276 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/core/platform-paths.ts
+import envPaths from "env-paths";
+import { arch, homedir, hostname, platform, release } from "os";
+import { isAbsolute, join, resolve } from "path";
+var APP_NAME = "agents";
+function resolveAgentsHomeOverride(value) {
+  if (value === void 0) return void 0;
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return void 0;
+  if (trimmed === "~") return homedir();
+  if (trimmed.startsWith("~/")) return join(homedir(), trimmed.slice(2));
+  if (isAbsolute(trimmed)) return resolve(trimmed);
+  return resolve(homedir(), trimmed);
+}
+var _paths = null;
+var _sysInfo = null;
+var _lastAgentsHome = void 0;
+function getPlatformPaths() {
+  const currentAgentsHome = process.env["AGENTS_HOME"];
+  if (_paths && currentAgentsHome !== _lastAgentsHome) {
+    _paths = null;
+    _sysInfo = null;
+  }
+  if (_paths) return _paths;
+  const ep = envPaths(APP_NAME, { suffix: "" });
+  _lastAgentsHome = currentAgentsHome;
+  _paths = {
+    data: resolveAgentsHomeOverride(currentAgentsHome) ?? ep.data,
+    config: ep.config,
+    cache: ep.cache,
+    log: ep.log,
+    temp: ep.temp
+  };
+  return _paths;
+}
+function getSystemInfo() {
+  if (_sysInfo) return _sysInfo;
+  const paths = getPlatformPaths();
+  _sysInfo = {
+    platform: platform(),
+    arch: arch(),
+    release: release(),
+    hostname: hostname(),
+    nodeVersion: process.version,
+    paths
+  };
+  return _sysInfo;
+}
+function _resetPlatformPathsCache() {
+  _paths = null;
+  _sysInfo = null;
+  _lastAgentsHome = void 0;
+}
+
+// src/core/paths/standard.ts
+import { existsSync } from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname, join as join2 } from "path";
+function getPlatformLocations() {
+  const home = homedir2();
+  const platform2 = process.platform;
+  if (platform2 === "win32") {
+    const appData = process.env["APPDATA"] ?? join2(home, "AppData", "Roaming");
+    return {
+      home,
+      config: appData,
+      vscodeConfig: join2(appData, "Code", "User"),
+      zedConfig: join2(appData, "Zed"),
+      claudeDesktopConfig: join2(appData, "Claude"),
+      applications: []
+    };
+  }
+  if (platform2 === "darwin") {
+    const config2 = process.env["XDG_CONFIG_HOME"] ?? join2(home, ".config");
+    return {
+      home,
+      config: config2,
+      vscodeConfig: join2(home, "Library", "Application Support", "Code", "User"),
+      zedConfig: join2(home, "Library", "Application Support", "Zed"),
+      claudeDesktopConfig: join2(home, "Library", "Application Support", "Claude"),
+      applications: ["/Applications", join2(home, "Applications")]
+    };
+  }
+  const config = process.env["XDG_CONFIG_HOME"] ?? join2(home, ".config");
+  return {
+    home,
+    config,
+    vscodeConfig: join2(config, "Code", "User"),
+    zedConfig: join2(config, "zed"),
+    claudeDesktopConfig: join2(config, "Claude"),
+    applications: []
+  };
+}
+function getAgentsHome() {
+  return getPlatformPaths().data;
+}
+function getProjectAgentsDir(projectRoot = process.cwd()) {
+  return join2(projectRoot, ".agents");
+}
+function resolveProjectPath(relativePath, projectDir = process.cwd()) {
+  return join2(projectDir, relativePath);
+}
+function getCanonicalSkillsDir() {
+  return join2(getAgentsHome(), "skills");
+}
+function getLockFilePath() {
+  return join2(getAgentsHome(), ".caamp-lock.json");
+}
+function getAgentsMcpDir(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "mcp");
+  return join2(projectDir ?? process.cwd(), ".agents", "mcp");
+}
+function getAgentsMcpServersPath(scope = "global", projectDir) {
+  return join2(getAgentsMcpDir(scope, projectDir), "servers.json");
+}
+function getAgentsInstructFile(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "AGENTS.md");
+  return join2(projectDir ?? process.cwd(), ".agents", "AGENTS.md");
+}
+function getAgentsConfigPath(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "config.toml");
+  return join2(projectDir ?? process.cwd(), ".agents", "config.toml");
+}
+function getAgentsWikiDir(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "wiki");
+  return join2(projectDir ?? process.cwd(), ".agents", "wiki");
+}
+function getAgentsSpecDir(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "spec");
+  return join2(projectDir ?? process.cwd(), ".agents", "spec");
+}
+function getAgentsLinksDir(scope = "global", projectDir) {
+  if (scope === "global") return join2(getAgentsHome(), "links");
+  return join2(projectDir ?? process.cwd(), ".agents", "links");
+}
+function resolveRegistryTemplatePath(template) {
+  const locations = getPlatformLocations();
+  return template.replace(/\$HOME/g, locations.home).replace(/\$CONFIG/g, locations.config).replace(/\$VSCODE_CONFIG/g, locations.vscodeConfig).replace(/\$ZED_CONFIG/g, locations.zedConfig).replace(/\$CLAUDE_DESKTOP_CONFIG/g, locations.claudeDesktopConfig).replace(/\$AGENTS_HOME/g, getAgentsHome());
+}
+function resolveProviderConfigPath(provider, scope, projectDir = process.cwd()) {
+  if (scope === "global") {
+    return provider.configPathGlobal;
+  }
+  if (!provider.configPathProject) {
+    return null;
+  }
+  return resolveProjectPath(provider.configPathProject, projectDir);
+}
+function resolvePreferredConfigScope(provider, useGlobalFlag) {
+  if (useGlobalFlag) {
+    return "global";
+  }
+  return provider.configPathProject ? "project" : "global";
+}
+function resolveProviderSkillsDir(provider, scope, projectDir = process.cwd()) {
+  if (scope === "global") {
+    return provider.pathSkills;
+  }
+  return resolveProjectPath(provider.pathProjectSkills, projectDir);
+}
+function resolveProviderSkillsDirs(provider, scope, projectDir = process.cwd()) {
+  const vendorPath = resolveProviderSkillsDir(provider, scope, projectDir);
+  const precedence = provider.capabilities?.skills?.precedence ?? "vendor-only";
+  const resolveAgentsPath = () => {
+    if (scope === "global") {
+      return provider.capabilities?.skills?.agentsGlobalPath ?? null;
+    }
+    const projectRelative = provider.capabilities?.skills?.agentsProjectPath ?? null;
+    return projectRelative ? join2(projectDir, projectRelative) : null;
+  };
+  switch (precedence) {
+    case "vendor-only":
+      return [vendorPath];
+    case "agents-canonical": {
+      const agentsPath = resolveAgentsPath();
+      return agentsPath ? [agentsPath] : [vendorPath];
+    }
+    case "agents-first": {
+      const agentsPath = resolveAgentsPath();
+      return agentsPath ? [agentsPath, vendorPath] : [vendorPath];
+    }
+    case "agents-supported": {
+      const agentsPath = resolveAgentsPath();
+      return agentsPath ? [vendorPath, agentsPath] : [vendorPath];
+    }
+    case "vendor-global-agents-project": {
+      if (scope === "global") {
+        return [vendorPath];
+      }
+      const agentsPath = resolveAgentsPath();
+      return agentsPath ? [agentsPath, vendorPath] : [vendorPath];
+    }
+    default:
+      return [vendorPath];
+  }
+}
+function resolveProviderProjectPath(provider, projectDir = process.cwd()) {
+  return resolveProjectPath(provider.pathProject, projectDir);
+}
+function resolveProvidersRegistryPath(startDir) {
+  const candidates = [
+    join2(startDir, "..", "..", "..", "providers", "registry.json"),
+    join2(startDir, "..", "providers", "registry.json")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  let current = startDir;
+  for (let i = 0; i < 8; i += 1) {
+    const candidate = join2(current, "providers", "registry.json");
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+    current = dirname(current);
+  }
+  throw new Error(`Cannot find providers/registry.json (searched from ${startDir})`);
+}
+function normalizeSkillSubPath(path) {
+  if (!path) return void 0;
+  const normalized = path.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/SKILL\.md$/i, "").trim();
+  return normalized.length > 0 ? normalized : void 0;
+}
+function buildSkillSubPathCandidates(marketplacePath, parsedPath) {
+  const candidates = [];
+  const base = normalizeSkillSubPath(marketplacePath);
+  const parsed = normalizeSkillSubPath(parsedPath);
+  if (base) candidates.push(base);
+  if (parsed) candidates.push(parsed);
+  const knownPrefixes = [".agents", ".claude"];
+  for (const value of [base, parsed]) {
+    if (!value || !value.startsWith("skills/")) continue;
+    for (const prefix of knownPrefixes) {
+      candidates.push(`${prefix}/${value}`);
+    }
+  }
+  if (candidates.length === 0) {
+    candidates.push(void 0);
+  }
+  return Array.from(new Set(candidates));
+}
+
+export {
+  __export,
+  getPlatformPaths,
+  getSystemInfo,
+  _resetPlatformPathsCache,
+  getPlatformLocations,
+  getAgentsHome,
+  getProjectAgentsDir,
+  getCanonicalSkillsDir,
+  getLockFilePath,
+  getAgentsMcpDir,
+  getAgentsMcpServersPath,
+  getAgentsInstructFile,
+  getAgentsConfigPath,
+  getAgentsWikiDir,
+  getAgentsSpecDir,
+  getAgentsLinksDir,
+  resolveRegistryTemplatePath,
+  resolveProviderConfigPath,
+  resolvePreferredConfigScope,
+  resolveProviderSkillsDir,
+  resolveProviderSkillsDirs,
+  resolveProviderProjectPath,
+  resolveProvidersRegistryPath,
+  buildSkillSubPathCandidates
+};
+//# sourceMappingURL=chunk-TRIXT4T7.js.map

package/dist/chunk-TRIXT4T7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/platform-paths.ts","../src/core/paths/standard.ts"],"sourcesContent":["/**\n * Central OS platform path resolution using env-paths.\n *\n * Provides OS-appropriate paths for CAAMP's global directories using\n * XDG conventions on Linux, standard conventions on macOS/Windows.\n * Results are cached for the process lifetime. Env vars take precedence.\n *\n * Platform path defaults:\n *   data:   ~/.local/share/agents  | ~/Library/Application Support/agents | %LOCALAPPDATA%\\agents\\Data\n *   config: ~/.config/agents       | ~/Library/Preferences/agents          | %APPDATA%\\agents\\Config\n *   cache:  ~/.cache/agents        | ~/Library/Caches/agents               | %LOCALAPPDATA%\\agents\\Cache\n *   log:    ~/.local/state/agents  | ~/Library/Logs/agents                 | %LOCALAPPDATA%\\agents\\Log\n *   temp:   /tmp/<user>/agents     | /var/folders/.../agents               | %TEMP%\\agents\n *\n * AGENTS_HOME env var overrides the data path for backward compatibility\n * with existing ~/.agents installations.\n */\n\nimport envPaths from 'env-paths';\nimport { arch, homedir, hostname, platform, release } from 'node:os';\nimport { isAbsolute, join, resolve } from 'node:path';\n\nconst APP_NAME = 'agents';\n\n/**\n * Normalize an AGENTS_HOME env var value to an absolute path.\n * Returns undefined when the value is absent, empty, or whitespace-only\n * (callers should fall back to the OS default in that case).\n */\nfunction resolveAgentsHomeOverride(value: string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  const trimmed = value.trim();\n  if (trimmed.length === 0) return undefined;\n  if (trimmed === '~') return homedir();\n  if (trimmed.startsWith('~/')) return join(homedir(), trimmed.slice(2));\n  if (isAbsolute(trimmed)) return resolve(trimmed);\n  return resolve(homedir(), trimmed);\n}\n\nexport interface PlatformPaths {\n  /** User data dir. Override with AGENTS_HOME env var. */\n  data: string;\n  /** OS config dir (XDG_CONFIG_HOME / Library/Preferences / %APPDATA%). */\n  config: string;\n  /** OS cache dir. */\n  cache: string;\n  /** OS log dir. */\n  log: string;\n  /** OS temp dir. */\n  temp: string;\n}\n\nexport interface SystemInfo {\n  platform: NodeJS.Platform;\n  arch: string;\n  release: string;\n  hostname: string;\n  nodeVersion: string;\n  paths: PlatformPaths;\n}\n\nlet _paths: PlatformPaths | null = null;\nlet _sysInfo: SystemInfo | null = null;\nlet _lastAgentsHome: string | undefined = undefined;\n\n/**\n * Get OS-appropriate paths for CAAMP's global directories.\n * Cached after first call. AGENTS_HOME env var overrides the data path.\n * Cache auto-invalidates when AGENTS_HOME changes (supports test isolation).\n */\nexport function getPlatformPaths(): PlatformPaths {\n  const currentAgentsHome = process.env['AGENTS_HOME'];\n\n  // Invalidate if AGENTS_HOME changed since last cache build\n  if (_paths && currentAgentsHome !== _lastAgentsHome) {\n    _paths = null;\n    _sysInfo = null;\n  }\n\n  if (_paths) return _paths;\n\n  const ep = envPaths(APP_NAME, { suffix: '' });\n  _lastAgentsHome = currentAgentsHome;\n\n  _paths = {\n    data: resolveAgentsHomeOverride(currentAgentsHome) ?? ep.data,\n    config: ep.config,\n    cache: ep.cache,\n    log: ep.log,\n    temp: ep.temp,\n  };\n\n  return _paths;\n}\n\n/**\n * Get a cached system information snapshot.\n * Captured once and reused for the process lifetime.\n */\nexport function getSystemInfo(): SystemInfo {\n  if (_sysInfo) return _sysInfo;\n\n  const paths = getPlatformPaths();\n\n  _sysInfo = {\n    platform: platform(),\n    arch: arch(),\n    release: release(),\n    hostname: hostname(),\n    nodeVersion: process.version,\n    paths,\n  };\n\n  return _sysInfo;\n}\n\n/**\n * Invalidate the path and system info caches.\n * Use in tests after mutating AGENTS_HOME env var.\n * @internal\n */\nexport function _resetPlatformPathsCache(): void {\n  _paths = null;\n  _sysInfo = null;\n  _lastAgentsHome = undefined;\n}\n","import { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport type { Provider } from \"../../types.js\";\nimport { getPlatformPaths } from \"../platform-paths.js\";\n\nexport type PathScope = \"project\" | \"global\";\n\nexport interface PlatformLocations {\n  home: string;\n  config: string;\n  vscodeConfig: string;\n  zedConfig: string;\n  claudeDesktopConfig: string;\n  applications: string[];\n}\n\nexport function getPlatformLocations(): PlatformLocations {\n  const home = homedir();\n  const platform = process.platform;\n\n  if (platform === \"win32\") {\n    const appData = process.env[\"APPDATA\"] ?? join(home, \"AppData\", \"Roaming\");\n    return {\n      home,\n      config: appData,\n      vscodeConfig: join(appData, \"Code\", \"User\"),\n      zedConfig: join(appData, \"Zed\"),\n      claudeDesktopConfig: join(appData, \"Claude\"),\n      applications: [],\n    };\n  }\n\n  if (platform === \"darwin\") {\n    const config = process.env[\"XDG_CONFIG_HOME\"] ?? join(home, \".config\");\n    return {\n      home,\n      config,\n      vscodeConfig: join(home, \"Library\", \"Application Support\", \"Code\", \"User\"),\n      zedConfig: join(home, \"Library\", \"Application Support\", \"Zed\"),\n      claudeDesktopConfig: join(home, \"Library\", \"Application Support\", \"Claude\"),\n      applications: [\"/Applications\", join(home, \"Applications\")],\n    };\n  }\n\n  const config = process.env[\"XDG_CONFIG_HOME\"] ?? join(home, \".config\");\n  return {\n    home,\n    config,\n    vscodeConfig: join(config, \"Code\", \"User\"),\n    zedConfig: join(config, \"zed\"),\n    claudeDesktopConfig: join(config, \"Claude\"),\n    applications: [],\n  };\n}\n\nexport function getAgentsHome(): string {\n  return getPlatformPaths().data;\n}\n\nexport function getProjectAgentsDir(projectRoot = process.cwd()): string {\n  return join(projectRoot, \".agents\");\n}\n\nexport function resolveProjectPath(relativePath: string, projectDir = process.cwd()): string {\n  return join(projectDir, relativePath);\n}\n\nexport function getCanonicalSkillsDir(): string {\n  return join(getAgentsHome(), \"skills\");\n}\n\nexport function getLockFilePath(): string {\n  return join(getAgentsHome(), \".caamp-lock.json\");\n}\n\n// ── .agents/ Standard Directory Structure ────────────────────────────\n\n/**\n * Get the MCP directory within `.agents/`.\n *\n * @param scope - `\"global\"` for `~/.agents/mcp/`, `\"project\"` for `<project>/.agents/mcp/`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n */\nexport function getAgentsMcpDir(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"mcp\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"mcp\");\n}\n\n/**\n * Get the MCP servers.json path within `.agents/`.\n *\n * Per the `.agents/` standard (Section 9), this is the canonical MCP\n * server registry that should be checked before legacy per-provider configs.\n *\n * @param scope - `\"global\"` for `~/.agents/mcp/servers.json`, `\"project\"` for `<project>/.agents/mcp/servers.json`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n */\nexport function getAgentsMcpServersPath(scope: PathScope = \"global\", projectDir?: string): string {\n  return join(getAgentsMcpDir(scope, projectDir), \"servers.json\");\n}\n\n/**\n * Get the primary AGENTS.md instruction file path within `.agents/`.\n *\n * @param scope - `\"global\"` for `~/.agents/AGENTS.md`, `\"project\"` for `<project>/.agents/AGENTS.md`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n */\nexport function getAgentsInstructFile(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"AGENTS.md\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"AGENTS.md\");\n}\n\n/**\n * Get the config.toml path within `.agents/`.\n *\n * @param scope - `\"global\"` for `~/.agents/config.toml`, `\"project\"` for `<project>/.agents/config.toml`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n */\nexport function getAgentsConfigPath(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"config.toml\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"config.toml\");\n}\n\n/**\n * Get the wiki directory within `.agents/`.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n */\nexport function getAgentsWikiDir(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"wiki\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"wiki\");\n}\n\n/**\n * Get the spec directory within `.agents/`.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n */\nexport function getAgentsSpecDir(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"spec\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"spec\");\n}\n\n/**\n * Get the links directory within `.agents/`.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n */\nexport function getAgentsLinksDir(scope: PathScope = \"global\", projectDir?: string): string {\n  if (scope === \"global\") return join(getAgentsHome(), \"links\");\n  return join(projectDir ?? process.cwd(), \".agents\", \"links\");\n}\n\nexport function resolveRegistryTemplatePath(template: string): string {\n  const locations = getPlatformLocations();\n  return template\n    .replace(/\\$HOME/g, locations.home)\n    .replace(/\\$CONFIG/g, locations.config)\n    .replace(/\\$VSCODE_CONFIG/g, locations.vscodeConfig)\n    .replace(/\\$ZED_CONFIG/g, locations.zedConfig)\n    .replace(/\\$CLAUDE_DESKTOP_CONFIG/g, locations.claudeDesktopConfig)\n    .replace(/\\$AGENTS_HOME/g, getAgentsHome());\n}\n\nexport function resolveProviderConfigPath(\n  provider: Provider,\n  scope: PathScope,\n  projectDir = process.cwd(),\n): string | null {\n  if (scope === \"global\") {\n    return provider.configPathGlobal;\n  }\n  if (!provider.configPathProject) {\n    return null;\n  }\n  return resolveProjectPath(provider.configPathProject, projectDir);\n}\n\nexport function resolvePreferredConfigScope(provider: Provider, useGlobalFlag?: boolean): PathScope {\n  if (useGlobalFlag) {\n    return \"global\";\n  }\n  return provider.configPathProject ? \"project\" : \"global\";\n}\n\nexport function resolveProviderSkillsDir(\n  provider: Provider,\n  scope: PathScope,\n  projectDir = process.cwd(),\n): string {\n  if (scope === \"global\") {\n    return provider.pathSkills;\n  }\n  return resolveProjectPath(provider.pathProjectSkills, projectDir);\n}\n\n/**\n * Get ALL target directories for skill installation based on the provider's\n * skills precedence setting.\n *\n * @param provider - Provider to resolve paths for\n * @param scope - Whether to resolve global or project paths\n * @param projectDir - Project directory for project-scope resolution\n * @returns Array of target directories for symlink creation\n */\nexport function resolveProviderSkillsDirs(\n  provider: Provider,\n  scope: PathScope,\n  projectDir = process.cwd(),\n): string[] {\n  const vendorPath = resolveProviderSkillsDir(provider, scope, projectDir);\n  const precedence = provider.capabilities?.skills?.precedence ?? \"vendor-only\";\n\n  const resolveAgentsPath = (): string | null => {\n    if (scope === \"global\") {\n      return provider.capabilities?.skills?.agentsGlobalPath ?? null;\n    }\n    const projectRelative = provider.capabilities?.skills?.agentsProjectPath ?? null;\n    return projectRelative ? join(projectDir, projectRelative) : null;\n  };\n\n  switch (precedence) {\n    case \"vendor-only\":\n      return [vendorPath];\n\n    case \"agents-canonical\": {\n      const agentsPath = resolveAgentsPath();\n      return agentsPath ? [agentsPath] : [vendorPath];\n    }\n\n    case \"agents-first\": {\n      const agentsPath = resolveAgentsPath();\n      return agentsPath ? [agentsPath, vendorPath] : [vendorPath];\n    }\n\n    case \"agents-supported\": {\n      const agentsPath = resolveAgentsPath();\n      return agentsPath ? [vendorPath, agentsPath] : [vendorPath];\n    }\n\n    case \"vendor-global-agents-project\": {\n      if (scope === \"global\") {\n        return [vendorPath];\n      }\n      const agentsPath = resolveAgentsPath();\n      return agentsPath ? [agentsPath, vendorPath] : [vendorPath];\n    }\n\n    default:\n      return [vendorPath];\n  }\n}\n\nexport function resolveProviderProjectPath(provider: Provider, projectDir = process.cwd()): string {\n  return resolveProjectPath(provider.pathProject, projectDir);\n}\n\nexport function resolveProvidersRegistryPath(startDir: string): string {\n  const candidates = [\n    join(startDir, \"..\", \"..\", \"..\", \"providers\", \"registry.json\"),\n    join(startDir, \"..\", \"providers\", \"registry.json\"),\n  ];\n\n  for (const candidate of candidates) {\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  let current = startDir;\n  for (let i = 0; i < 8; i += 1) {\n    const candidate = join(current, \"providers\", \"registry.json\");\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n    current = dirname(current);\n  }\n\n  throw new Error(`Cannot find providers/registry.json (searched from ${startDir})`);\n}\n\nexport function normalizeSkillSubPath(path: string | undefined): string | undefined {\n  if (!path) return undefined;\n  const normalized = path.replace(/\\\\/g, \"/\").replace(/^\\/+/, \"\").replace(/\\/SKILL\\.md$/i, \"\").trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nexport function buildSkillSubPathCandidates(\n  marketplacePath: string | undefined,\n  parsedPath: string | undefined,\n): (string | undefined)[] {\n  const candidates: (string | undefined)[] = [];\n  const base = normalizeSkillSubPath(marketplacePath);\n  const parsed = normalizeSkillSubPath(parsedPath);\n\n  if (base) candidates.push(base);\n  if (parsed) candidates.push(parsed);\n\n  const knownPrefixes = [\".agents\", \".claude\"];\n  for (const value of [base, parsed]) {\n    if (!value || !value.startsWith(\"skills/\")) continue;\n    for (const prefix of knownPrefixes) {\n      candidates.push(`${prefix}/${value}`);\n    }\n  }\n\n  if (candidates.length === 0) {\n    candidates.push(undefined);\n  }\n\n  return Array.from(new Set(candidates));\n}\n"],"mappings":"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","names":["homedir","join","homedir","platform","join","config"]}

package/dist/cli.js

@@ -61,26 +61,35 @@ import {
   tokenizeCriteriaValue,
   updateInstructionsSingleOperation,
   validateSkill
-} from "./chunk-LDTYDQGR.js";
+} from "./chunk-OLJZ23W3.js";
 import {
-  buildSkillSubPathCandidates,
   buildSkillsMap,
   checkAllInjections,
   generateInjectionContent,
   getAllProviders,
-  getCommonHookEvents,
   getProvider,
   getProviderCount,
-  getProvidersByHookEvent,
   getProvidersByPriority,
   getRegistryVersion,
   groupByInstructFile,
   injectAll,
-  providerSupports,
+  providerSupports
+} from "./chunk-MFWBR2NY.js";
+import {
+  CANONICAL_HOOK_EVENTS,
+  buildHookMatrix,
+  getCommonEvents,
+  getHookMappingsVersion,
+  getHookSupport,
+  getProviderSummary,
+  translateToAll
+} from "./chunk-ER3FIOTM.js";
+import {
+  buildSkillSubPathCandidates,
   resolvePreferredConfigScope,
   resolveProviderConfigPath,
   resolveProviderSkillsDir
-} from "./chunk-CPHF5IM4.js";
+} from "./chunk-TRIXT4T7.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -2936,8 +2945,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 +3021,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-LV6VU7QJ.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-LV6VU7QJ.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 +3216,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(`