@cleocode/caamp 2026.5.26 → 2026.5.28

package/dist/{chunk-UZSGHMYW.js → chunk-GDEIR34D.js}

@@ -1,6 +1,6 @@
 import {
   resolveRegistryTemplatePath
-} from "./chunk-B5WJ4RDT.js";
+} from "./chunk-OCQI7UDH.js";
 
 // src/core/hooks/normalizer.ts
 import { existsSync, readFileSync } from "fs";
@@ -291,4 +291,4 @@ export {
   resolveNativeEvent,
   getHookMappingsVersion
 };
-//# sourceMappingURL=chunk-UZSGHMYW.js.map
+//# sourceMappingURL=chunk-GDEIR34D.js.map

package/dist/{chunk-S3PLNL6K.js → chunk-HFC3WUME.js}

@@ -3,7 +3,7 @@ import {
   getPrimaryProvider,
   groupByInstructFile,
   injectAll
-} from "./chunk-QUVY4LG4.js";
+} from "./chunk-YXWL2IXL.js";
 import {
   __export,
   getAgentsConfigPath,
@@ -16,7 +16,7 @@ import {
   resolveProviderConfigPath,
   resolveProviderProjectPath,
   resolveProviderSkillsDirs
-} from "./chunk-B5WJ4RDT.js";
+} from "./chunk-OCQI7UDH.js";
 
 // src/core/logger.ts
 var verboseMode = false;
@@ -4722,4 +4722,4 @@ export {
   discoverSkillsMulti,
   validateSkill
 };
-//# sourceMappingURL=chunk-S3PLNL6K.js.map
+//# sourceMappingURL=chunk-HFC3WUME.js.map

package/dist/{chunk-B5WJ4RDT.js → chunk-OCQI7UDH.js}

@@ -5,107 +5,56 @@ var __export = (target, all) => {
 };
 
 // src/core/platform-paths.ts
-import { arch, homedir, hostname, platform, release } from "os";
-import { isAbsolute, join, resolve } from "path";
-import envPaths from "env-paths";
-function resolveHomeOverride(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);
-}
-function createPlatformPathsResolver(appName, homeEnvVar) {
-  let _paths = null;
-  let _sysInfo = null;
-  let _lastHomeValue;
-  function getPlatformPaths2() {
-    const currentHome = process.env[homeEnvVar];
-    if (_paths && currentHome !== _lastHomeValue) {
-      _paths = null;
-      _sysInfo = null;
-    }
-    if (_paths) return _paths;
-    const ep = envPaths(appName, { suffix: "" });
-    _lastHomeValue = currentHome;
-    _paths = {
-      data: resolveHomeOverride(currentHome) ?? ep.data,
-      config: ep.config,
-      cache: ep.cache,
-      log: ep.log,
-      temp: ep.temp
-    };
-    return _paths;
-  }
-  function getSystemInfo2() {
-    if (_sysInfo) return _sysInfo;
-    const paths = getPlatformPaths2();
-    _sysInfo = {
-      platform: platform(),
-      arch: arch(),
-      release: release(),
-      hostname: hostname(),
-      nodeVersion: process.version,
-      paths
-    };
-    return _sysInfo;
-  }
-  function resetCache() {
-    _paths = null;
-    _sysInfo = null;
-    _lastHomeValue = void 0;
-  }
-  return { getPlatformPaths: getPlatformPaths2, getSystemInfo: getSystemInfo2, resetCache };
-}
-var _agentsResolver = createPlatformPathsResolver("agents", "AGENTS_HOME");
+import {
+  createPlatformPathsResolver
+} from "@cleocode/paths";
+var agentsResolver = createPlatformPathsResolver("agents", "AGENTS_HOME");
 function getPlatformPaths() {
-  return _agentsResolver.getPlatformPaths();
+  return agentsResolver.getPlatformPaths();
 }
 function getSystemInfo() {
-  return _agentsResolver.getSystemInfo();
+  return agentsResolver.getSystemInfo();
 }
 function _resetPlatformPathsCache() {
-  _agentsResolver.resetCache();
+  agentsResolver.resetCache();
 }
 
 // src/core/paths/standard.ts
 import { existsSync } from "fs";
-import { homedir as homedir2 } from "os";
-import { dirname, join as join2 } from "path";
+import { homedir } from "os";
+import { dirname, join } from "path";
 function getPlatformLocations() {
-  const home = homedir2();
-  const platform2 = process.platform;
-  if (platform2 === "win32") {
-    const appData = process.env["APPDATA"] ?? join2(home, "AppData", "Roaming");
+  const home = homedir();
+  const platform = process.platform;
+  if (platform === "win32") {
+    const appData = process.env["APPDATA"] ?? join(home, "AppData", "Roaming");
     return {
       home,
       config: appData,
-      vscodeConfig: join2(appData, "Code", "User"),
-      zedConfig: join2(appData, "Zed"),
-      claudeDesktopConfig: join2(appData, "Claude"),
+      vscodeConfig: join(appData, "Code", "User"),
+      zedConfig: join(appData, "Zed"),
+      claudeDesktopConfig: join(appData, "Claude"),
       applications: []
     };
   }
-  if (platform2 === "darwin") {
-    const config2 = process.env["XDG_CONFIG_HOME"] ?? join2(home, ".config");
+  if (platform === "darwin") {
+    const config2 = process.env["XDG_CONFIG_HOME"] ?? join(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")]
+      vscodeConfig: join(home, "Library", "Application Support", "Code", "User"),
+      zedConfig: join(home, "Library", "Application Support", "Zed"),
+      claudeDesktopConfig: join(home, "Library", "Application Support", "Claude"),
+      applications: ["/Applications", join(home, "Applications")]
     };
   }
-  const config = process.env["XDG_CONFIG_HOME"] ?? join2(home, ".config");
+  const config = process.env["XDG_CONFIG_HOME"] ?? join(home, ".config");
   return {
     home,
     config,
-    vscodeConfig: join2(config, "Code", "User"),
-    zedConfig: join2(config, "zed"),
-    claudeDesktopConfig: join2(config, "Claude"),
+    vscodeConfig: join(config, "Code", "User"),
+    zedConfig: join(config, "zed"),
+    claudeDesktopConfig: join(config, "Claude"),
     applications: []
   };
 }
@@ -113,43 +62,43 @@ function getAgentsHome() {
   return getPlatformPaths().data;
 }
 function getProjectAgentsDir(projectRoot = process.cwd()) {
-  return join2(projectRoot, ".agents");
+  return join(projectRoot, ".agents");
 }
 function resolveProjectPath(relativePath, projectDir = process.cwd()) {
-  return join2(projectDir, relativePath);
+  return join(projectDir, relativePath);
 }
 function getCanonicalSkillsDir() {
-  return join2(getAgentsHome(), "skills");
+  return join(getAgentsHome(), "skills");
 }
 function getLockFilePath() {
-  return join2(getAgentsHome(), ".caamp-lock.json");
+  return join(getAgentsHome(), ".caamp-lock.json");
 }
 function getAgentsMcpDir(scope = "global", projectDir) {
-  if (scope === "global") return join2(getAgentsHome(), "mcp");
-  return join2(projectDir ?? process.cwd(), ".agents", "mcp");
+  if (scope === "global") return join(getAgentsHome(), "mcp");
+  return join(projectDir ?? process.cwd(), ".agents", "mcp");
 }
 function getAgentsMcpServersPath(scope = "global", projectDir) {
-  return join2(getAgentsMcpDir(scope, projectDir), "servers.json");
+  return join(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");
+  if (scope === "global") return join(getAgentsHome(), "AGENTS.md");
+  return join(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");
+  if (scope === "global") return join(getAgentsHome(), "config.toml");
+  return join(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");
+  if (scope === "global") return join(getAgentsHome(), "wiki");
+  return join(projectDir ?? process.cwd(), ".agents", "wiki");
 }
 function getAgentsSpecDir(scope = "global", projectDir) {
-  if (scope === "global") return join2(getAgentsHome(), "spec");
-  return join2(projectDir ?? process.cwd(), ".agents", "spec");
+  if (scope === "global") return join(getAgentsHome(), "spec");
+  return join(projectDir ?? process.cwd(), ".agents", "spec");
 }
 function getAgentsLinksDir(scope = "global", projectDir) {
-  if (scope === "global") return join2(getAgentsHome(), "links");
-  return join2(projectDir ?? process.cwd(), ".agents", "links");
+  if (scope === "global") return join(getAgentsHome(), "links");
+  return join(projectDir ?? process.cwd(), ".agents", "links");
 }
 function getCleoHomeForTemplate() {
   const envOverride = process.env["CLEO_HOME"];
@@ -158,14 +107,14 @@ function getCleoHomeForTemplate() {
   }
   const home = getPlatformLocations().home;
   if (process.platform === "win32") {
-    const localAppData = process.env["LOCALAPPDATA"] ?? join2(home, "AppData", "Local");
-    return join2(localAppData, "cleo", "Data");
+    const localAppData = process.env["LOCALAPPDATA"] ?? join(home, "AppData", "Local");
+    return join(localAppData, "cleo", "Data");
   }
   if (process.platform === "darwin") {
-    return join2(home, "Library", "Application Support", "cleo");
+    return join(home, "Library", "Application Support", "cleo");
   }
-  const xdgData = process.env["XDG_DATA_HOME"] ?? join2(home, ".local", "share");
-  return join2(xdgData, "cleo");
+  const xdgData = process.env["XDG_DATA_HOME"] ?? join(home, ".local", "share");
+  return join(xdgData, "cleo");
 }
 function resolveRegistryTemplatePath(template) {
   const locations = getPlatformLocations();
@@ -198,7 +147,7 @@ function resolveProviderSkillsDirs(provider, scope, projectDir = process.cwd())
       return provider.capabilities?.skills?.agentsGlobalPath ?? null;
     }
     const projectRelative = provider.capabilities?.skills?.agentsProjectPath ?? null;
-    return projectRelative ? join2(projectDir, projectRelative) : null;
+    return projectRelative ? join(projectDir, projectRelative) : null;
   };
   switch (precedence) {
     case "vendor-only":
@@ -231,8 +180,8 @@ function resolveProviderProjectPath(provider, projectDir = process.cwd()) {
 }
 function resolveProvidersRegistryPath(startDir) {
   const candidates = [
-    join2(startDir, "..", "..", "..", "providers", "registry.json"),
-    join2(startDir, "..", "providers", "registry.json")
+    join(startDir, "..", "..", "..", "providers", "registry.json"),
+    join(startDir, "..", "providers", "registry.json")
   ];
   for (const candidate of candidates) {
     if (existsSync(candidate)) {
@@ -241,7 +190,7 @@ function resolveProvidersRegistryPath(startDir) {
   }
   let current = startDir;
   for (let i = 0; i < 8; i += 1) {
-    const candidate = join2(current, "providers", "registry.json");
+    const candidate = join(current, "providers", "registry.json");
     if (existsSync(candidate)) {
       return candidate;
     }
@@ -298,4 +247,4 @@ export {
   resolveProvidersRegistryPath,
   buildSkillSubPathCandidates
 };
-//# sourceMappingURL=chunk-B5WJ4RDT.js.map
+//# sourceMappingURL=chunk-OCQI7UDH.js.map

package/dist/chunk-OCQI7UDH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/platform-paths.ts","../src/core/paths/standard.ts"],"sourcesContent":["/**\n * CAAMP platform-path façade — bound to `(appName='agents', envVar='AGENTS_HOME')`.\n *\n * The shared platform-paths factory now lives in `@cleocode/paths` (the\n * XDG / env-paths SSoT for the CLEO ecosystem). This module re-exposes the\n * factory + types and pre-binds an `agents`-scoped resolver so existing CAAMP\n * consumers keep working unchanged.\n *\n * Platform path defaults (no `AGENTS_HOME` set):\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 (with tilde expansion).\n *\n * @task T1887\n */\n\nimport {\n  createPlatformPathsResolver,\n  type PlatformPaths,\n  type PlatformPathsResolver,\n  type SystemInfo,\n} from '@cleocode/paths';\n\nexport type { PlatformPaths, PlatformPathsResolver, SystemInfo };\nexport { createPlatformPathsResolver };\n\nconst agentsResolver = createPlatformPathsResolver('agents', 'AGENTS_HOME');\n\n/**\n * Get OS-appropriate paths for CAAMP's global directories.\n *\n * Reads fresh on every call (env-paths is microsecond-fast). The\n * `AGENTS_HOME` env var overrides the data path with tilde expansion.\n *\n * @public\n */\nexport function getPlatformPaths(): PlatformPaths {\n  return agentsResolver.getPlatformPaths();\n}\n\n/**\n * Get a cached system information snapshot.\n *\n * Captured once and reused for the process lifetime. Includes platform,\n * architecture, hostname, Node version, and resolved paths.\n *\n * @public\n */\nexport function getSystemInfo(): SystemInfo {\n  return agentsResolver.getSystemInfo();\n}\n\n/**\n * Invalidate the cached system info snapshot. Use in tests after\n * mutating `AGENTS_HOME`.\n *\n * @internal\n */\nexport function _resetPlatformPathsCache(): void {\n  agentsResolver.resetCache();\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\n/**\n * Scope for path resolution, either global (user home) or project-local.\n *\n * @remarks\n * Global scope resolves paths under the user's home directory (e.g., `~/.agents/`).\n * Project scope resolves paths relative to the project root (e.g., `<project>/.agents/`).\n *\n * @public\n */\nexport type PathScope = 'project' | 'global';\n\n/**\n * Platform-specific directory locations for agent configuration.\n *\n * @remarks\n * Provides resolved paths for the current operating system, accounting for\n * platform differences in config directory locations (XDG on Linux, Library on macOS,\n * AppData on Windows).\n *\n * @public\n */\nexport interface PlatformLocations {\n  /** The user's home directory path. */\n  home: string;\n  /** The platform-specific configuration directory. */\n  config: string;\n  /** The VS Code user settings directory. */\n  vscodeConfig: string;\n  /** The Zed editor configuration directory. */\n  zedConfig: string;\n  /** The Claude Desktop application configuration directory. */\n  claudeDesktopConfig: string;\n  /** List of application directories (macOS only). */\n  applications: string[];\n}\n\n/**\n * Resolves platform-specific directory locations for the current OS.\n *\n * @remarks\n * Detects the current platform and returns appropriate paths for configuration,\n * editor settings, and application directories. Uses `XDG_CONFIG_HOME` on Linux\n * and macOS when available, falls back to conventional defaults. On Windows,\n * uses `APPDATA` or defaults to `~/AppData/Roaming`.\n *\n * @returns Platform-specific directory locations\n *\n * @example\n * ```typescript\n * const locations = getPlatformLocations();\n * console.log(locations.config); // e.g., \"/home/user/.config\"\n * ```\n *\n * @public\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\n/**\n * Returns the global agents home directory path.\n *\n * @remarks\n * Delegates to the platform paths module to resolve the data directory\n * for the current operating system. This is the root for global agent\n * configuration such as canonical skills and lock files.\n *\n * @returns The absolute path to the global agents home directory\n *\n * @example\n * ```typescript\n * const home = getAgentsHome();\n * // e.g., \"/home/user/.local/share/caamp\"\n * ```\n *\n * @public\n */\nexport function getAgentsHome(): string {\n  return getPlatformPaths().data;\n}\n\n/**\n * Returns the project-local `.agents` directory path.\n *\n * @remarks\n * Joins the project root with `.agents` to produce the conventional\n * project-scoped agent configuration directory.\n *\n * @param projectRoot - The project root directory, defaults to `process.cwd()`\n * @returns The absolute path to the project's `.agents` directory\n *\n * @example\n * ```typescript\n * const dir = getProjectAgentsDir(\"/home/user/my-project\");\n * // returns \"/home/user/my-project/.agents\"\n * ```\n *\n * @public\n */\nexport function getProjectAgentsDir(projectRoot = process.cwd()): string {\n  return join(projectRoot, '.agents');\n}\n\n/**\n * Resolves a relative path against a project directory.\n *\n * @remarks\n * A simple path join utility that combines the project directory with\n * the given relative path to produce an absolute path.\n *\n * @param relativePath - The relative path to resolve\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved absolute path\n *\n * @example\n * ```typescript\n * const path = resolveProjectPath(\".agents/config.toml\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/config.toml\"\n * ```\n *\n * @public\n */\nexport function resolveProjectPath(relativePath: string, projectDir = process.cwd()): string {\n  return join(projectDir, relativePath);\n}\n\n/**\n * Returns the canonical skills storage directory path.\n *\n * @remarks\n * Skills are stored once in this canonical directory and symlinked into\n * provider-specific locations. This is the single source of truth for\n * installed skill files.\n *\n * @returns The absolute path to the canonical skills directory\n *\n * @example\n * ```typescript\n * const dir = getCanonicalSkillsDir();\n * // e.g., \"/home/user/.local/share/caamp/skills\"\n * ```\n *\n * @public\n */\nexport function getCanonicalSkillsDir(): string {\n  return join(getAgentsHome(), 'skills');\n}\n\n/**\n * Returns the path to the CAAMP lock file.\n *\n * @remarks\n * The lock file tracks installed skills and their versions to enable\n * deterministic reinstallation and conflict detection.\n *\n * @returns The absolute path to the `.caamp-lock.json` file\n *\n * @example\n * ```typescript\n * const lockPath = getLockFilePath();\n * // e.g., \"/home/user/.local/share/caamp/.caamp-lock.json\"\n * ```\n *\n * @public\n */\nexport function getLockFilePath(): string {\n  return join(getAgentsHome(), '.caamp-lock.json');\n}\n\n// ── .agents/ Standard Directory Structure ────────────────────────────\n\n/**\n * Gets the MCP directory within the `.agents/` standard structure.\n *\n * @remarks\n * Resolves the MCP configuration directory based on scope. Global scope\n * points to `~/.agents/mcp/`, while project scope points to\n * `<project>/.agents/mcp/`.\n *\n * @param scope - `\"global\"` for `~/.agents/mcp/`, `\"project\"` for `<project>/.agents/mcp/`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the MCP directory\n *\n * @example\n * ```typescript\n * const globalMcp = getAgentsMcpDir(\"global\");\n * const projectMcp = getAgentsMcpDir(\"project\", \"/home/user/project\");\n * ```\n *\n * @public\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 * Gets the MCP servers.json path within the `.agents/` standard structure.\n *\n * @remarks\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 * @returns The absolute path to the `servers.json` file\n *\n * @example\n * ```typescript\n * const serversPath = getAgentsMcpServersPath(\"global\");\n * // e.g., \"/home/user/.agents/mcp/servers.json\"\n * ```\n *\n * @public\n */\nexport function getAgentsMcpServersPath(scope: PathScope = 'global', projectDir?: string): string {\n  return join(getAgentsMcpDir(scope, projectDir), 'servers.json');\n}\n\n/**\n * Gets the primary AGENTS.md instruction file path within `.agents/`.\n *\n * @remarks\n * Returns the path to the AGENTS.md file for the given scope. This is the\n * standard instruction file that agents read for project or global guidance.\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 * @returns The absolute path to the AGENTS.md file\n *\n * @example\n * ```typescript\n * const agentsFile = getAgentsInstructFile(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/AGENTS.md\"\n * ```\n *\n * @public\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 * Gets the config.toml path within the `.agents/` standard structure.\n *\n * @remarks\n * Returns the path to the TOML configuration file for agent settings.\n * Global scope points to `~/.agents/config.toml`, project scope points\n * to `<project>/.agents/config.toml`.\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 * @returns The absolute path to the config.toml file\n *\n * @example\n * ```typescript\n * const configPath = getAgentsConfigPath(\"global\");\n * // e.g., \"/home/user/.agents/config.toml\"\n * ```\n *\n * @public\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 * Gets the wiki directory within the `.agents/` standard structure.\n *\n * @remarks\n * The wiki directory stores markdown documentation files that agents\n * can reference for project or global knowledge.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the wiki directory\n *\n * @example\n * ```typescript\n * const wikiDir = getAgentsWikiDir(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/wiki\"\n * ```\n *\n * @public\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 * Gets the spec directory within the `.agents/` standard structure.\n *\n * @remarks\n * The spec directory stores specification files used by agents for\n * project architecture and design reference.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the spec directory\n *\n * @example\n * ```typescript\n * const specDir = getAgentsSpecDir(\"global\");\n * // e.g., \"/home/user/.agents/spec\"\n * ```\n *\n * @public\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 * Gets the links directory within the `.agents/` standard structure.\n *\n * @remarks\n * The links directory stores symlinks or references to external resources\n * that agents can follow for additional context.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the links directory\n *\n * @example\n * ```typescript\n * const linksDir = getAgentsLinksDir(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/links\"\n * ```\n *\n * @public\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\n/**\n * Resolve the CLEO home directory for template path expansion.\n *\n * @remarks\n * Honors the `CLEO_HOME` environment variable when set. Otherwise falls\n * back to a platform-appropriate data directory for the `cleo` app name\n * (e.g. `~/.local/share/cleo` on Linux, `~/Library/Application Support/cleo`\n * on macOS, `%LOCALAPPDATA%\\cleo\\Data` on Windows). This mirrors the\n * resolution strategy used by the `@cleocode/core` package's `getCleoHome`\n * helper but is duplicated here to avoid a cross-package runtime dependency.\n *\n * @internal\n */\nfunction getCleoHomeForTemplate(): string {\n  const envOverride = process.env['CLEO_HOME'];\n  if (envOverride && envOverride.trim().length > 0) {\n    return envOverride.trim();\n  }\n  const home = getPlatformLocations().home;\n  if (process.platform === 'win32') {\n    const localAppData = process.env['LOCALAPPDATA'] ?? join(home, 'AppData', 'Local');\n    return join(localAppData, 'cleo', 'Data');\n  }\n  if (process.platform === 'darwin') {\n    return join(home, 'Library', 'Application Support', 'cleo');\n  }\n  const xdgData = process.env['XDG_DATA_HOME'] ?? join(home, '.local', 'share');\n  return join(xdgData, 'cleo');\n}\n\n/**\n * Resolves a registry template path by substituting platform variables.\n *\n * @remarks\n * Replaces template variables like `$HOME`, `$CONFIG`, `$VSCODE_CONFIG`,\n * `$ZED_CONFIG`, `$CLAUDE_DESKTOP_CONFIG`, `$AGENTS_HOME`, and `$CLEO_HOME`\n * with their actual platform-specific values. Used to resolve paths from\n * the provider registry JSON.\n *\n * @param template - The template string containing `$VARIABLE` placeholders\n * @returns The resolved absolute path with all variables expanded\n *\n * @example\n * ```typescript\n * const path = resolveRegistryTemplatePath(\"$HOME/.config/claude/settings.json\");\n * // e.g., \"/home/user/.config/claude/settings.json\"\n * ```\n *\n * @public\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    .replace(/\\$CLEO_HOME/g, getCleoHomeForTemplate());\n}\n\n/**\n * Resolves the configuration file path for a provider at the given scope.\n *\n * @remarks\n * For global scope, returns the provider's `configPathGlobal` directly.\n * For project scope, joins the project directory with the provider's\n * `configPathProject`. Returns null if the provider has no project-scoped\n * config path defined.\n *\n * @param provider - The provider whose config path to resolve\n * @param scope - Whether to resolve global or project config path\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved config file path, or null if unavailable for the given scope\n *\n * @example\n * ```typescript\n * const configPath = resolveProviderConfigPath(provider, \"project\", \"/home/user/project\");\n * if (configPath) {\n *   console.log(\"Config at:\", configPath);\n * }\n * ```\n *\n * @public\n */\nexport function resolveProviderConfigPath(\n  provider: Provider,\n  scope: PathScope,\n  projectDir = process.cwd(),\n): string | null {\n  const mcp = provider.capabilities.mcp;\n  if (!mcp) {\n    return null;\n  }\n  if (scope === 'global') {\n    return mcp.configPathGlobal;\n  }\n  if (!mcp.configPathProject) {\n    return null;\n  }\n  return resolveProjectPath(mcp.configPathProject, projectDir);\n}\n\n/**\n * Determines the preferred configuration scope for a provider.\n *\n * @remarks\n * If the global flag is explicitly set, always returns `\"global\"`. Otherwise,\n * returns `\"project\"` if the provider supports project-scoped configuration,\n * or `\"global\"` as a fallback.\n *\n * @param provider - The provider to determine scope for\n * @param useGlobalFlag - Optional flag to force global scope\n * @returns The preferred path scope for configuration\n *\n * @example\n * ```typescript\n * const scope = resolvePreferredConfigScope(provider, false);\n * // returns \"project\" if provider has configPathProject, otherwise \"global\"\n * ```\n *\n * @public\n */\nexport function resolvePreferredConfigScope(\n  provider: Provider,\n  useGlobalFlag?: boolean,\n): PathScope {\n  if (useGlobalFlag) {\n    return 'global';\n  }\n  return provider.capabilities.mcp?.configPathProject ? 'project' : 'global';\n}\n\n/**\n * Resolves the skills directory path for a provider at the given scope.\n *\n * @remarks\n * For global scope, returns the provider's `pathSkills` directly.\n * For project scope, joins the project directory with the provider's\n * `pathProjectSkills` relative path.\n *\n * @param provider - The provider whose skills directory to resolve\n * @param scope - Whether to resolve global or project skills path\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved skills directory path\n *\n * @example\n * ```typescript\n * const skillsDir = resolveProviderSkillsDir(provider, \"global\");\n * // e.g., \"/home/user/.claude/skills\"\n * ```\n *\n * @public\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 * Gets all target directories for skill installation based on provider precedence.\n *\n * @remarks\n * Resolves one or more skill directories based on the provider's skills\n * precedence setting. The precedence determines whether vendor-only, agents-canonical,\n * agents-first, agents-supported, or vendor-global-agents-project strategies are used.\n * Falls back to the vendor path when the agents path is not configured.\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 *\n * @example\n * ```typescript\n * const dirs = resolveProviderSkillsDirs(provider, \"project\", \"/home/user/project\");\n * for (const dir of dirs) {\n *   console.log(\"Install skill to:\", dir);\n * }\n * ```\n *\n * @public\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\n/**\n * Resolves a provider's project-level path against a project directory.\n *\n * @remarks\n * Joins the project directory with the provider's `pathProject` relative path\n * to produce an absolute path for project-scoped provider configuration.\n *\n * @param provider - The provider whose project path to resolve\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved absolute path for the provider's project directory\n *\n * @example\n * ```typescript\n * const projectPath = resolveProviderProjectPath(provider, \"/home/user/project\");\n * // e.g., \"/home/user/project/.claude\"\n * ```\n *\n * @public\n */\nexport function resolveProviderProjectPath(provider: Provider, projectDir = process.cwd()): string {\n  return resolveProjectPath(provider.pathProject, projectDir);\n}\n\n/**\n * Locates the providers registry.json file by searching up from a start directory.\n *\n * @remarks\n * First checks common relative locations (3 levels up and 1 level up),\n * then walks up to 8 parent directories looking for `providers/registry.json`.\n * Throws if the registry file cannot be found.\n *\n * @param startDir - The directory to start searching from\n * @returns The absolute path to the found `providers/registry.json` file\n * @throws Error if `providers/registry.json` cannot be found within 8 parent levels\n *\n * @example\n * ```typescript\n * const registryPath = resolveProvidersRegistryPath(__dirname);\n * // e.g., \"/home/user/caamp/providers/registry.json\"\n * ```\n *\n * @public\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\n/**\n * Normalizes a skill sub-path by cleaning separators and removing SKILL.md suffix.\n *\n * @remarks\n * Converts backslashes to forward slashes, strips leading slashes and\n * trailing `/SKILL.md`, and trims whitespace. Returns undefined for\n * empty or falsy inputs.\n *\n * @param path - The raw skill sub-path to normalize\n * @returns The normalized path, or undefined if the input is empty or falsy\n *\n * @example\n * ```typescript\n * const normalized = normalizeSkillSubPath(\"skills/my-skill/SKILL.md\");\n * // returns \"skills/my-skill\"\n * ```\n *\n * @public\n */\nexport function normalizeSkillSubPath(path: string | undefined): string | undefined {\n  if (!path) return undefined;\n  const normalized = path\n    .replace(/\\\\/g, '/')\n    .replace(/^\\/+/, '')\n    .replace(/\\/SKILL\\.md$/i, '')\n    .trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\n/**\n * Builds a list of candidate sub-paths for skill file resolution.\n *\n * @remarks\n * Normalizes both the marketplace and parsed paths, then generates additional\n * candidates by prepending known prefixes (`.agents`, `.claude`) to paths\n * starting with `skills/`. Returns a deduplicated list of candidates, with\n * an undefined entry as fallback if no candidates are found.\n *\n * @param marketplacePath - The sub-path from the marketplace listing\n * @param parsedPath - The sub-path parsed from the source URL\n * @returns A deduplicated array of candidate sub-paths\n *\n * @example\n * ```typescript\n * const candidates = buildSkillSubPathCandidates(\"skills/my-skill\", undefined);\n * // returns [\"skills/my-skill\", \".agents/skills/my-skill\", \".claude/skills/my-skill\"]\n * ```\n *\n * @public\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?.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":["config"]}

package/dist/{chunk-QUVY4LG4.js → chunk-YXWL2IXL.js}

@@ -2,7 +2,7 @@ import {
   resolveProviderSkillsDir,
   resolveProvidersRegistryPath,
   resolveRegistryTemplatePath
-} from "./chunk-B5WJ4RDT.js";
+} from "./chunk-OCQI7UDH.js";
 
 // src/core/instructions/injector.ts
 import { existsSync } from "fs";
@@ -582,4 +582,4 @@ export {
   getProviderAgentFolder,
   writeAgentFileToAllProviders
 };
-//# sourceMappingURL=chunk-QUVY4LG4.js.map
+//# sourceMappingURL=chunk-YXWL2IXL.js.map

package/dist/cli.js

@@ -52,7 +52,7 @@ import {
   tokenizeCriteriaValue,
   updateInstructionsSingleOperation,
   validateSkill
-} from "./chunk-S3PLNL6K.js";
+} from "./chunk-HFC3WUME.js";
 import {
   buildSkillsMap,
   checkAllInjections,
@@ -65,7 +65,7 @@ import {
   groupByInstructFile,
   injectAll,
   providerSupports
-} from "./chunk-QUVY4LG4.js";
+} from "./chunk-YXWL2IXL.js";
 import {
   CANONICAL_HOOK_EVENTS,
   buildHookMatrix,
@@ -74,12 +74,12 @@ import {
   getHookSupport,
   getProviderSummary,
   translateToAll
-} from "./chunk-UZSGHMYW.js";
+} from "./chunk-GDEIR34D.js";
 import {
   buildSkillSubPathCandidates,
   resolveProviderConfigPath,
   resolveProviderSkillsDir
-} from "./chunk-B5WJ4RDT.js";
+} from "./chunk-OCQI7UDH.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -3349,7 +3349,7 @@ CAMP Hook Support (mappings v${getHookMappingsVersion()})
         return;
       }
       if (opts.from) {
-        const { toCanonical } = await import("./hooks-4MLYUJJL.js");
+        const { toCanonical } = await import("./hooks-WZ3MTLQF.js");
         const canonical2 = toCanonical(event, opts.from);
         if (format === "json") {
           const envelope = buildEnvelope2(
@@ -3389,7 +3389,7 @@ CAMP Hook Support (mappings v${getHookMappingsVersion()})
         }
         process.exit(1);
       }
-      const { getMappedProviderIds } = await import("./hooks-4MLYUJJL.js");
+      const { getMappedProviderIds } = await import("./hooks-WZ3MTLQF.js");
       const allIds = getMappedProviderIds();
       const translations = translateToAll(canonical, allIds);
       if (format === "json") {

package/dist/{hooks-4MLYUJJL.js → hooks-WZ3MTLQF.js}

@@ -24,8 +24,8 @@ import {
   toNative,
   toNativeBatch,
   translateToAll
-} from "./chunk-UZSGHMYW.js";
-import "./chunk-B5WJ4RDT.js";
+} from "./chunk-GDEIR34D.js";
+import "./chunk-OCQI7UDH.js";
 export {
   CANONICAL_HOOK_EVENTS,
   HOOK_CATEGORIES,
@@ -53,4 +53,4 @@ export {
   toNativeBatch,
   translateToAll
 };
-//# sourceMappingURL=hooks-4MLYUJJL.js.map
+//# sourceMappingURL=hooks-WZ3MTLQF.js.map

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { WorktreeHandle } from '@cleocode/cant';
+import { PlatformPaths, SystemInfo } from '@cleocode/paths';
+export { PlatformPaths, SystemInfo } from '@cleocode/paths';
 
 /**
  * Priority tier identifier stored in registry.json.
@@ -5742,84 +5744,30 @@ declare function resolveRegistryTemplatePath(template: string): string;
 declare function resolveProviderSkillsDirs(provider: Provider, scope: PathScope, projectDir?: string): string[];
 
 /**
- * Central OS platform path resolution using env-paths.
+ * CAAMP platform-path façade — bound to `(appName='agents', envVar='AGENTS_HOME')`.
  *
- * Provides OS-appropriate paths for CAAMP's global directories using
- * XDG conventions on Linux, standard conventions on macOS/Windows.
- * Results are cached for the process lifetime. Env vars take precedence.
+ * The shared platform-paths factory now lives in `@cleocode/paths` (the
+ * XDG / env-paths SSoT for the CLEO ecosystem). This module re-exposes the
+ * factory + types and pre-binds an `agents`-scoped resolver so existing CAAMP
+ * consumers keep working unchanged.
  *
- * Platform path defaults:
+ * Platform path defaults (no `AGENTS_HOME` set):
  *   data:   ~/.local/share/agents  | ~/Library/Application Support/agents | %LOCALAPPDATA%\agents\Data
  *   config: ~/.config/agents       | ~/Library/Preferences/agents          | %APPDATA%\agents\Config
  *   cache:  ~/.cache/agents        | ~/Library/Caches/agents               | %LOCALAPPDATA%\agents\Cache
  *   log:    ~/.local/state/agents  | ~/Library/Logs/agents                 | %LOCALAPPDATA%\agents\Log
  *   temp:   /tmp/<user>/agents     | /var/folders/.../agents               | %TEMP%\agents
  *
- * AGENTS_HOME env var overrides the data path for backward compatibility
- * with existing ~/.agents installations.
+ * `AGENTS_HOME` env var overrides the data path (with tilde expansion).
  *
- * @remarks
- * Dependency note: `@cleocode/core` depends on `@cleocode/caamp`, so this
- * module intentionally does NOT import from `@cleocode/core` to avoid a
- * circular dependency. The shared env-paths wrapper pattern is factored into
- * {@link createPlatformPathsResolver} below, which can be reused by callers
- * that need a different app name / home env-var without duplicating logic.
- */
-/**
- * OS-appropriate directory paths for a global agent tool.
- *
- * @public
- */
-interface PlatformPaths {
-    /** User data dir. Override with the configured home env var. */
-    data: string;
-    /** OS config dir (XDG_CONFIG_HOME / Library/Preferences / %APPDATA%). */
-    config: string;
-    /** OS cache dir. */
-    cache: string;
-    /** OS log dir. */
-    log: string;
-    /** OS temp dir. */
-    temp: string;
-}
-/**
- * Snapshot of the current system environment and resolved platform paths.
- *
- * @public
+ * @task T1887
  */
-interface SystemInfo {
-    /** Operating system platform identifier. */
-    platform: NodeJS.Platform;
-    /** CPU architecture (e.g. `"x64"`, `"arm64"`). */
-    arch: string;
-    /** OS kernel release version string. */
-    release: string;
-    /** Machine hostname. */
-    hostname: string;
-    /** Node.js version string (e.g. `"v20.11.0"`). */
-    nodeVersion: string;
-    /** Resolved platform directory paths. */
-    paths: PlatformPaths;
-}
+
 /**
  * Get OS-appropriate paths for CAAMP's global directories.
  *
- * @remarks
- * Cached after first call. The `AGENTS_HOME` env var overrides the data path
- * for backward compatibility with existing `~/.agents` installations. The
- * cache auto-invalidates when `AGENTS_HOME` changes (supports test isolation).
- *
- * Delegates to an internal {@link PlatformPathsResolver} created by
- * {@link createPlatformPathsResolver}. To resolve paths for a different app
- * use that factory directly.
- *
- * @returns Resolved platform paths
- *
- * @example
- * ```typescript
- * const paths = getPlatformPaths();
- * console.log(paths.data); // e.g. "/home/user/.local/share/agents"
- * ```
+ * Reads fresh on every call (env-paths is microsecond-fast). The
+ * `AGENTS_HOME` env var overrides the data path with tilde expansion.
  *
  * @public
  */
@@ -5827,24 +5775,16 @@ declare function getPlatformPaths(): PlatformPaths;
 /**
  * Get a cached system information snapshot.
  *
- * @remarks
  * Captured once and reused for the process lifetime. Includes platform,
  * architecture, hostname, Node version, and resolved paths.
  *
- * @returns Cached system info object
- *
- * @example
- * ```typescript
- * const info = getSystemInfo();
- * console.log(`Running on ${info.platform}/${info.arch}`);
- * ```
- *
  * @public
  */
 declare function getSystemInfo(): SystemInfo;
 /**
- * Invalidate the path and system info caches.
- * Use in tests after mutating AGENTS_HOME env var.
+ * Invalidate the cached system info snapshot. Use in tests after
+ * mutating `AGENTS_HOME`.
+ *
  * @internal
  */
 declare function _resetPlatformPathsCache(): void;
@@ -8249,4 +8189,4 @@ declare function parseSource(input: string): ParsedSource;
  */
 declare function isMarketplaceScoped(input: string): boolean;
 
-export { type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, CANONICAL_HOOK_EVENTS, type CaampLockFile, type CanonicalEventDefinition, type CanonicalHookEvent, type CantProfileCounts, type CantProfileEntry, type CantValidationDiagnostic, type ConfigFormat, type CrossProviderMatrix, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, DEFAULT_EXCLUSIVITY_MODE, type DetectionCacheOptions, type DetectionResult, EXCLUSIVITY_MODE_ENV_VAR, type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult, type ExclusivityMode, type GlobalOptions, HOOK_CATEGORIES, type Harness, type HarnessScope, type HookCategory, type HookEvent, type HookHandlerType, type HookMapping, type HookSupportResult, type HookSystemType, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallMcpServerOptions, type InstallMcpServerResult, type InstructionUpdateSummary, type KnownProviderAgentFolderId, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpConfigFormat, type McpDetectionEntry, type McpScope, type McpServerConfig, type McpServerEntriesByProvider, type McpServerEntry, type McpTransportType, type NormalizedHookEvent, type NormalizedRecommendationCriteria, type ParsedSource, PiHarness, PiRequiredError, type PlatformPaths, type Provider, type ProviderCapabilities, type ProviderHarnessCapability, type ProviderHookProfile, type ProviderHookSummary, type ProviderHooksCapability, type ProviderMcpCapability, type ProviderPriority, type ProviderSkillsCapability, type ProviderSpawnCapability, type ProviderStatus, RECOMMENDATION_ERROR_CODES, type RankedSkillRecommendation, type RecommendSkillsResult, type RecommendationCriteriaInput, type RecommendationErrorCode, type RecommendationOptions, type RecommendationReason, type RecommendationReasonCode, type RecommendationScoreBreakdown, type RecommendationValidationIssue, type RecommendationValidationResult, type RecommendationWeights, type RegistryHarnessKind, type RegistryHookCatalog, type RegistryHookFormat, type RemoveMcpServerOptions, type RemoveMcpServerResult, type ResolveDefaultTargetProvidersOptions, type SkillBatchOperation, type SkillEntry, type SkillInstallResult, type SkillIntegrityResult, type SkillIntegrityStatus, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SubagentHandle, type SubagentResult, type SubagentTask, type SystemInfo, type TransportType, type ValidateCantProfileResult, type ValidationIssue, type ValidationResult, type WriteAgentFileOptions, type WriteAgentFileResult, _resetPlatformPathsCache, buildHookMatrix, buildInjectionContent, buildLibraryFromFiles, buildSkillsMap, catalog, checkAllInjections, checkAllSkillIntegrity, checkAllSkillUpdates, checkInjection, checkSkillIntegrity, checkSkillUpdate, clearRegisteredLibrary, deepMerge, detectAllProviders, detectMcpInstallations, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureAllProviderInstructionFiles, ensureDir, ensureProviderInstructionFile, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllCanonicalEvents, getAllHarnesses, getAllProviders, getCanonicalEvent, getCanonicalEventsByCategory, getCanonicalSkillsDir, getCommonEvents, getCommonHookEvents, getEffectiveSkillsPaths, getExclusivityMode, getHarnessFor, getHookConfigPath, getHookMappingsVersion, getHookSupport, getHookSystemType, getInstalledProviders, getInstructionFiles, getLockFilePath, getMappedProviderIds, getNestedValue, getPlatformLocations, getPlatformPaths, getPrimaryHarness, getPrimaryProvider, getProjectAgentsDir, getProvider, getProviderAgentFolder, getProviderCapabilities, getProviderCount, getProviderHookProfile, getProviderOnlyEvents, getProviderSummary, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getProvidersForEvent, getRegistryVersion, getSpawnCapableProviders, getSupportedEvents, getSystemInfo, getTrackedSkills, getUnsupportedEvents, groupByInstructFile, inject, injectAll, installBatchWithRollback, installMcpServer, installSkill, isCaampOwnedSkill, isExclusivityMode, isMarketplaceScoped, isQuiet, isVerbose, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeRecommendationCriteria, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, recommendSkills, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpServer, removeMcpServerFromAll, removeSkill, removeSkillFromLock, resetDetectionCache, resetExclusivityModeOverride, resolveAlias, resolveDefaultTargetProviders, resolveMcpConfigPath, resolveNativeEvent, resolveProviderSkillsDirs, resolveRegistryTemplatePath, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setExclusivityMode, setQuiet, setVerbose, shouldOverrideSkill, supportsHook, toCanonical, toNative, toNativeBatch, toSarif, tokenizeCriteriaValue, translateToAll, updateInstructionsSingleOperation, validateInstructionIntegrity, validateRecommendationCriteria, validateSkill, writeAgentFileToAllProviders, writeConfig };
+export { type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, CANONICAL_HOOK_EVENTS, type CaampLockFile, type CanonicalEventDefinition, type CanonicalHookEvent, type CantProfileCounts, type CantProfileEntry, type CantValidationDiagnostic, type ConfigFormat, type CrossProviderMatrix, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, DEFAULT_EXCLUSIVITY_MODE, type DetectionCacheOptions, type DetectionResult, EXCLUSIVITY_MODE_ENV_VAR, type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult, type ExclusivityMode, type GlobalOptions, HOOK_CATEGORIES, type Harness, type HarnessScope, type HookCategory, type HookEvent, type HookHandlerType, type HookMapping, type HookSupportResult, type HookSystemType, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallMcpServerOptions, type InstallMcpServerResult, type InstructionUpdateSummary, type KnownProviderAgentFolderId, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpConfigFormat, type McpDetectionEntry, type McpScope, type McpServerConfig, type McpServerEntriesByProvider, type McpServerEntry, type McpTransportType, type NormalizedHookEvent, type NormalizedRecommendationCriteria, type ParsedSource, PiHarness, PiRequiredError, type Provider, type ProviderCapabilities, type ProviderHarnessCapability, type ProviderHookProfile, type ProviderHookSummary, type ProviderHooksCapability, type ProviderMcpCapability, type ProviderPriority, type ProviderSkillsCapability, type ProviderSpawnCapability, type ProviderStatus, RECOMMENDATION_ERROR_CODES, type RankedSkillRecommendation, type RecommendSkillsResult, type RecommendationCriteriaInput, type RecommendationErrorCode, type RecommendationOptions, type RecommendationReason, type RecommendationReasonCode, type RecommendationScoreBreakdown, type RecommendationValidationIssue, type RecommendationValidationResult, type RecommendationWeights, type RegistryHarnessKind, type RegistryHookCatalog, type RegistryHookFormat, type RemoveMcpServerOptions, type RemoveMcpServerResult, type ResolveDefaultTargetProvidersOptions, type SkillBatchOperation, type SkillEntry, type SkillInstallResult, type SkillIntegrityResult, type SkillIntegrityStatus, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SubagentHandle, type SubagentResult, type SubagentTask, type TransportType, type ValidateCantProfileResult, type ValidationIssue, type ValidationResult, type WriteAgentFileOptions, type WriteAgentFileResult, _resetPlatformPathsCache, buildHookMatrix, buildInjectionContent, buildLibraryFromFiles, buildSkillsMap, catalog, checkAllInjections, checkAllSkillIntegrity, checkAllSkillUpdates, checkInjection, checkSkillIntegrity, checkSkillUpdate, clearRegisteredLibrary, deepMerge, detectAllProviders, detectMcpInstallations, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureAllProviderInstructionFiles, ensureDir, ensureProviderInstructionFile, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllCanonicalEvents, getAllHarnesses, getAllProviders, getCanonicalEvent, getCanonicalEventsByCategory, getCanonicalSkillsDir, getCommonEvents, getCommonHookEvents, getEffectiveSkillsPaths, getExclusivityMode, getHarnessFor, getHookConfigPath, getHookMappingsVersion, getHookSupport, getHookSystemType, getInstalledProviders, getInstructionFiles, getLockFilePath, getMappedProviderIds, getNestedValue, getPlatformLocations, getPlatformPaths, getPrimaryHarness, getPrimaryProvider, getProjectAgentsDir, getProvider, getProviderAgentFolder, getProviderCapabilities, getProviderCount, getProviderHookProfile, getProviderOnlyEvents, getProviderSummary, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getProvidersForEvent, getRegistryVersion, getSpawnCapableProviders, getSupportedEvents, getSystemInfo, getTrackedSkills, getUnsupportedEvents, groupByInstructFile, inject, injectAll, installBatchWithRollback, installMcpServer, installSkill, isCaampOwnedSkill, isExclusivityMode, isMarketplaceScoped, isQuiet, isVerbose, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeRecommendationCriteria, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, recommendSkills, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpServer, removeMcpServerFromAll, removeSkill, removeSkillFromLock, resetDetectionCache, resetExclusivityModeOverride, resolveAlias, resolveDefaultTargetProviders, resolveMcpConfigPath, resolveNativeEvent, resolveProviderSkillsDirs, resolveRegistryTemplatePath, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setExclusivityMode, setQuiet, setVerbose, shouldOverrideSkill, supportsHook, toCanonical, toNative, toNativeBatch, toSarif, tokenizeCriteriaValue, translateToAll, updateInstructionsSingleOperation, validateInstructionIntegrity, validateRecommendationCriteria, validateSkill, writeAgentFileToAllProviders, writeConfig };

package/dist/index.js

@@ -70,7 +70,7 @@ import {
   validateRecommendationCriteria,
   validateSkill,
   writeConfig
-} from "./chunk-S3PLNL6K.js";
+} from "./chunk-HFC3WUME.js";
 import {
   buildInjectionContent,
   buildSkillsMap,
@@ -106,7 +106,7 @@ import {
   removeInjection,
   resolveAlias,
   writeAgentFileToAllProviders
-} from "./chunk-QUVY4LG4.js";
+} from "./chunk-YXWL2IXL.js";
 import {
   CANONICAL_HOOK_EVENTS,
   HOOK_CATEGORIES,
@@ -132,7 +132,7 @@ import {
   toNative,
   toNativeBatch,
   translateToAll
-} from "./chunk-UZSGHMYW.js";
+} from "./chunk-GDEIR34D.js";
 import {
   _resetPlatformPathsCache,
   getAgentsConfigPath,
@@ -151,7 +151,7 @@ import {
   getSystemInfo,
   resolveProviderSkillsDirs,
   resolveRegistryTemplatePath
-} from "./chunk-B5WJ4RDT.js";
+} from "./chunk-OCQI7UDH.js";
 
 // src/core/skills/integrity.ts
 import { existsSync, lstatSync, readlinkSync } from "fs";
@@ -269,7 +269,7 @@ function shouldOverrideSkill(skillName, incomingSource, existingEntry) {
   return true;
 }
 async function validateInstructionIntegrity(providers, projectDir, scope, expectedContent) {
-  const { checkAllInjections: checkAllInjections2 } = await import("./injector-SMCEHZBY.js");
+  const { checkAllInjections: checkAllInjections2 } = await import("./injector-J2C4VCJJ.js");
   const results = await checkAllInjections2(providers, projectDir, scope, expectedContent);
   const issues = [];
   for (const result of results) {

package/dist/{injector-SMCEHZBY.js → injector-J2C4VCJJ.js}

@@ -8,8 +8,8 @@ import {
   injectAll,
   removeInjection,
   writeAgentFileToAllProviders
-} from "./chunk-QUVY4LG4.js";
-import "./chunk-B5WJ4RDT.js";
+} from "./chunk-YXWL2IXL.js";
+import "./chunk-OCQI7UDH.js";
 export {
   checkAllInjections,
   checkInjection,
@@ -21,4 +21,4 @@ export {
   removeInjection,
   writeAgentFileToAllProviders
 };
-//# sourceMappingURL=injector-SMCEHZBY.js.map
+//# sourceMappingURL=injector-J2C4VCJJ.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/caamp",
-  "version": "2026.5.26",
+  "version": "2026.5.28",
   "description": "Central AI Agent Managed Packages - unified provider registry and package manager for AI coding agents",
   "type": "module",
   "bin": {
@@ -45,15 +45,15 @@
   "dependencies": {
     "@iarna/toml": "^2.2.5",
     "commander": "^14.0.0",
-    "env-paths": "^4.0.0",
     "gray-matter": "^4.0.3",
     "js-yaml": "^4.1.0",
     "jsonc-parser": "^3.3.1",
     "picocolors": "^1.1.1",
     "simple-git": "3.33.0",
-    "@cleocode/cant": "2026.5.26",
-    "@cleocode/lafs": "2026.5.26",
-    "@cleocode/contracts": "2026.5.26"
+    "@cleocode/contracts": "2026.5.28",
+    "@cleocode/lafs": "2026.5.28",
+    "@cleocode/paths": "2026.5.28",
+    "@cleocode/cant": "2026.5.28"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.11",
@@ -61,6 +61,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "25.5.0",
     "@vitest/coverage-v8": "^4.1.4",
+    "env-paths": "^4.0.0",
     "tsup": "^8.5.0",
     "tsx": "^4.21.0",
     "typedoc": "0.28.17",

package/dist/chunk-B5WJ4RDT.js.map

@@ -1 +0,0 @@
-{"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 * @remarks\n * Dependency note: `@cleocode/core` depends on `@cleocode/caamp`, so this\n * module intentionally does NOT import from `@cleocode/core` to avoid a\n * circular dependency. The shared env-paths wrapper pattern is factored into\n * {@link createPlatformPathsResolver} below, which can be reused by callers\n * that need a different app name / home env-var without duplicating logic.\n */\n\nimport { arch, homedir, hostname, platform, release } from 'node:os';\nimport { isAbsolute, join, resolve } from 'node:path';\nimport envPaths from 'env-paths';\n\n/**\n * OS-appropriate directory paths for a global agent tool.\n *\n * @public\n */\nexport interface PlatformPaths {\n  /** User data dir. Override with the configured 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\n/**\n * Snapshot of the current system environment and resolved platform paths.\n *\n * @public\n */\nexport interface SystemInfo {\n  /** Operating system platform identifier. */\n  platform: NodeJS.Platform;\n  /** CPU architecture (e.g. `\"x64\"`, `\"arm64\"`). */\n  arch: string;\n  /** OS kernel release version string. */\n  release: string;\n  /** Machine hostname. */\n  hostname: string;\n  /** Node.js version string (e.g. `\"v20.11.0\"`). */\n  nodeVersion: string;\n  /** Resolved platform directory paths. */\n  paths: PlatformPaths;\n}\n\n/**\n * A bound platform-paths resolver for one app name + home env var.\n *\n * @remarks\n * Created by {@link createPlatformPathsResolver}. Holds its own cache state\n * so different resolvers (e.g. `agents` and `cleo`) are fully isolated.\n *\n * @public\n */\nexport interface PlatformPathsResolver {\n  /**\n   * Get OS-appropriate paths for the resolver's app directories.\n   *\n   * @remarks\n   * Cached after first call. The home env var overrides the data path for\n   * backward compatibility. The cache auto-invalidates when the env var\n   * changes (supports test isolation).\n   *\n   * @returns Resolved platform paths\n   *\n   * @example\n   * ```typescript\n   * const resolver = createPlatformPathsResolver('agents', 'AGENTS_HOME');\n   * const paths = resolver.getPlatformPaths();\n   * console.log(paths.data); // e.g. \"/home/user/.local/share/agents\"\n   * ```\n   */\n  getPlatformPaths(): PlatformPaths;\n\n  /**\n   * Get a cached system information snapshot.\n   *\n   * @remarks\n   * Captured once and reused for the process lifetime. Includes platform,\n   * architecture, hostname, Node version, and resolved paths.\n   *\n   * @returns Cached system info object\n   */\n  getSystemInfo(): SystemInfo;\n\n  /**\n   * Invalidate the path and system info caches.\n   * Use in tests after mutating the home env var.\n   * @internal\n   */\n  resetCache(): void;\n}\n\n/**\n * Normalize a home override env var value to an absolute path.\n *\n * @remarks\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 *\n * @param value - The raw env var value to normalize\n * @returns An absolute path string, or `undefined` if the value is blank\n *\n * @internal\n */\nfunction resolveHomeOverride(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\n/**\n * Create a platform-paths resolver bound to a specific app name and home env var.\n *\n * @remarks\n * Encapsulates the `env-paths` wrapper pattern so callers can declare their\n * own app-specific resolver without duplicating the caching and tilde-expansion\n * logic. Each call to `createPlatformPathsResolver` returns an independent\n * resolver with its own internal cache — different apps (e.g. `agents` vs\n * `cleo`) remain fully isolated.\n *\n * Dependency constraint: `@cleocode/core` depends on `@cleocode/caamp`, so\n * this factory lives here rather than in core. Packages that cannot import\n * from core (e.g. install-time scripts) should use this factory directly with\n * `env-paths` as a peer dependency.\n *\n * @param appName - The application name passed to `env-paths` (e.g. `\"agents\"`)\n * @param homeEnvVar - The env var name that overrides the data directory\n *   (e.g. `\"AGENTS_HOME\"`). The override supports `~`, `~/…`, absolute, and\n *   relative paths.\n * @returns A {@link PlatformPathsResolver} with `getPlatformPaths`,\n *   `getSystemInfo`, and `resetCache` methods\n *\n * @example\n * ```typescript\n * const resolver = createPlatformPathsResolver('agents', 'AGENTS_HOME');\n * const paths = resolver.getPlatformPaths();\n * console.log(paths.data); // e.g. \"/home/user/.local/share/agents\"\n * ```\n *\n * @public\n */\nexport function createPlatformPathsResolver(\n  appName: string,\n  homeEnvVar: string,\n): PlatformPathsResolver {\n  let _paths: PlatformPaths | null = null;\n  let _sysInfo: SystemInfo | null = null;\n  let _lastHomeValue: string | undefined;\n\n  function getPlatformPaths(): PlatformPaths {\n    const currentHome = process.env[homeEnvVar];\n\n    // Invalidate if the home env var changed since last cache build\n    if (_paths && currentHome !== _lastHomeValue) {\n      _paths = null;\n      _sysInfo = null;\n    }\n\n    if (_paths) return _paths;\n\n    const ep = envPaths(appName, { suffix: '' });\n    _lastHomeValue = currentHome;\n\n    _paths = {\n      data: resolveHomeOverride(currentHome) ?? 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  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  function resetCache(): void {\n    _paths = null;\n    _sysInfo = null;\n    _lastHomeValue = undefined;\n  }\n\n  return { getPlatformPaths, getSystemInfo, resetCache };\n}\n\n// ---------------------------------------------------------------------------\n// CAAMP's bound resolver — app name \"agents\", home override \"AGENTS_HOME\"\n// ---------------------------------------------------------------------------\n\nconst _agentsResolver = createPlatformPathsResolver('agents', 'AGENTS_HOME');\n\n/**\n * Get OS-appropriate paths for CAAMP's global directories.\n *\n * @remarks\n * Cached after first call. The `AGENTS_HOME` env var overrides the data path\n * for backward compatibility with existing `~/.agents` installations. The\n * cache auto-invalidates when `AGENTS_HOME` changes (supports test isolation).\n *\n * Delegates to an internal {@link PlatformPathsResolver} created by\n * {@link createPlatformPathsResolver}. To resolve paths for a different app\n * use that factory directly.\n *\n * @returns Resolved platform paths\n *\n * @example\n * ```typescript\n * const paths = getPlatformPaths();\n * console.log(paths.data); // e.g. \"/home/user/.local/share/agents\"\n * ```\n *\n * @public\n */\nexport function getPlatformPaths(): PlatformPaths {\n  return _agentsResolver.getPlatformPaths();\n}\n\n/**\n * Get a cached system information snapshot.\n *\n * @remarks\n * Captured once and reused for the process lifetime. Includes platform,\n * architecture, hostname, Node version, and resolved paths.\n *\n * @returns Cached system info object\n *\n * @example\n * ```typescript\n * const info = getSystemInfo();\n * console.log(`Running on ${info.platform}/${info.arch}`);\n * ```\n *\n * @public\n */\nexport function getSystemInfo(): SystemInfo {\n  return _agentsResolver.getSystemInfo();\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  _agentsResolver.resetCache();\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\n/**\n * Scope for path resolution, either global (user home) or project-local.\n *\n * @remarks\n * Global scope resolves paths under the user's home directory (e.g., `~/.agents/`).\n * Project scope resolves paths relative to the project root (e.g., `<project>/.agents/`).\n *\n * @public\n */\nexport type PathScope = 'project' | 'global';\n\n/**\n * Platform-specific directory locations for agent configuration.\n *\n * @remarks\n * Provides resolved paths for the current operating system, accounting for\n * platform differences in config directory locations (XDG on Linux, Library on macOS,\n * AppData on Windows).\n *\n * @public\n */\nexport interface PlatformLocations {\n  /** The user's home directory path. */\n  home: string;\n  /** The platform-specific configuration directory. */\n  config: string;\n  /** The VS Code user settings directory. */\n  vscodeConfig: string;\n  /** The Zed editor configuration directory. */\n  zedConfig: string;\n  /** The Claude Desktop application configuration directory. */\n  claudeDesktopConfig: string;\n  /** List of application directories (macOS only). */\n  applications: string[];\n}\n\n/**\n * Resolves platform-specific directory locations for the current OS.\n *\n * @remarks\n * Detects the current platform and returns appropriate paths for configuration,\n * editor settings, and application directories. Uses `XDG_CONFIG_HOME` on Linux\n * and macOS when available, falls back to conventional defaults. On Windows,\n * uses `APPDATA` or defaults to `~/AppData/Roaming`.\n *\n * @returns Platform-specific directory locations\n *\n * @example\n * ```typescript\n * const locations = getPlatformLocations();\n * console.log(locations.config); // e.g., \"/home/user/.config\"\n * ```\n *\n * @public\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\n/**\n * Returns the global agents home directory path.\n *\n * @remarks\n * Delegates to the platform paths module to resolve the data directory\n * for the current operating system. This is the root for global agent\n * configuration such as canonical skills and lock files.\n *\n * @returns The absolute path to the global agents home directory\n *\n * @example\n * ```typescript\n * const home = getAgentsHome();\n * // e.g., \"/home/user/.local/share/caamp\"\n * ```\n *\n * @public\n */\nexport function getAgentsHome(): string {\n  return getPlatformPaths().data;\n}\n\n/**\n * Returns the project-local `.agents` directory path.\n *\n * @remarks\n * Joins the project root with `.agents` to produce the conventional\n * project-scoped agent configuration directory.\n *\n * @param projectRoot - The project root directory, defaults to `process.cwd()`\n * @returns The absolute path to the project's `.agents` directory\n *\n * @example\n * ```typescript\n * const dir = getProjectAgentsDir(\"/home/user/my-project\");\n * // returns \"/home/user/my-project/.agents\"\n * ```\n *\n * @public\n */\nexport function getProjectAgentsDir(projectRoot = process.cwd()): string {\n  return join(projectRoot, '.agents');\n}\n\n/**\n * Resolves a relative path against a project directory.\n *\n * @remarks\n * A simple path join utility that combines the project directory with\n * the given relative path to produce an absolute path.\n *\n * @param relativePath - The relative path to resolve\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved absolute path\n *\n * @example\n * ```typescript\n * const path = resolveProjectPath(\".agents/config.toml\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/config.toml\"\n * ```\n *\n * @public\n */\nexport function resolveProjectPath(relativePath: string, projectDir = process.cwd()): string {\n  return join(projectDir, relativePath);\n}\n\n/**\n * Returns the canonical skills storage directory path.\n *\n * @remarks\n * Skills are stored once in this canonical directory and symlinked into\n * provider-specific locations. This is the single source of truth for\n * installed skill files.\n *\n * @returns The absolute path to the canonical skills directory\n *\n * @example\n * ```typescript\n * const dir = getCanonicalSkillsDir();\n * // e.g., \"/home/user/.local/share/caamp/skills\"\n * ```\n *\n * @public\n */\nexport function getCanonicalSkillsDir(): string {\n  return join(getAgentsHome(), 'skills');\n}\n\n/**\n * Returns the path to the CAAMP lock file.\n *\n * @remarks\n * The lock file tracks installed skills and their versions to enable\n * deterministic reinstallation and conflict detection.\n *\n * @returns The absolute path to the `.caamp-lock.json` file\n *\n * @example\n * ```typescript\n * const lockPath = getLockFilePath();\n * // e.g., \"/home/user/.local/share/caamp/.caamp-lock.json\"\n * ```\n *\n * @public\n */\nexport function getLockFilePath(): string {\n  return join(getAgentsHome(), '.caamp-lock.json');\n}\n\n// ── .agents/ Standard Directory Structure ────────────────────────────\n\n/**\n * Gets the MCP directory within the `.agents/` standard structure.\n *\n * @remarks\n * Resolves the MCP configuration directory based on scope. Global scope\n * points to `~/.agents/mcp/`, while project scope points to\n * `<project>/.agents/mcp/`.\n *\n * @param scope - `\"global\"` for `~/.agents/mcp/`, `\"project\"` for `<project>/.agents/mcp/`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the MCP directory\n *\n * @example\n * ```typescript\n * const globalMcp = getAgentsMcpDir(\"global\");\n * const projectMcp = getAgentsMcpDir(\"project\", \"/home/user/project\");\n * ```\n *\n * @public\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 * Gets the MCP servers.json path within the `.agents/` standard structure.\n *\n * @remarks\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 * @returns The absolute path to the `servers.json` file\n *\n * @example\n * ```typescript\n * const serversPath = getAgentsMcpServersPath(\"global\");\n * // e.g., \"/home/user/.agents/mcp/servers.json\"\n * ```\n *\n * @public\n */\nexport function getAgentsMcpServersPath(scope: PathScope = 'global', projectDir?: string): string {\n  return join(getAgentsMcpDir(scope, projectDir), 'servers.json');\n}\n\n/**\n * Gets the primary AGENTS.md instruction file path within `.agents/`.\n *\n * @remarks\n * Returns the path to the AGENTS.md file for the given scope. This is the\n * standard instruction file that agents read for project or global guidance.\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 * @returns The absolute path to the AGENTS.md file\n *\n * @example\n * ```typescript\n * const agentsFile = getAgentsInstructFile(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/AGENTS.md\"\n * ```\n *\n * @public\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 * Gets the config.toml path within the `.agents/` standard structure.\n *\n * @remarks\n * Returns the path to the TOML configuration file for agent settings.\n * Global scope points to `~/.agents/config.toml`, project scope points\n * to `<project>/.agents/config.toml`.\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 * @returns The absolute path to the config.toml file\n *\n * @example\n * ```typescript\n * const configPath = getAgentsConfigPath(\"global\");\n * // e.g., \"/home/user/.agents/config.toml\"\n * ```\n *\n * @public\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 * Gets the wiki directory within the `.agents/` standard structure.\n *\n * @remarks\n * The wiki directory stores markdown documentation files that agents\n * can reference for project or global knowledge.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the wiki directory\n *\n * @example\n * ```typescript\n * const wikiDir = getAgentsWikiDir(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/wiki\"\n * ```\n *\n * @public\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 * Gets the spec directory within the `.agents/` standard structure.\n *\n * @remarks\n * The spec directory stores specification files used by agents for\n * project architecture and design reference.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the spec directory\n *\n * @example\n * ```typescript\n * const specDir = getAgentsSpecDir(\"global\");\n * // e.g., \"/home/user/.agents/spec\"\n * ```\n *\n * @public\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 * Gets the links directory within the `.agents/` standard structure.\n *\n * @remarks\n * The links directory stores symlinks or references to external resources\n * that agents can follow for additional context.\n *\n * @param scope - `\"global\"` or `\"project\"`\n * @param projectDir - Project root (defaults to `process.cwd()`)\n * @returns The absolute path to the links directory\n *\n * @example\n * ```typescript\n * const linksDir = getAgentsLinksDir(\"project\", \"/home/user/project\");\n * // returns \"/home/user/project/.agents/links\"\n * ```\n *\n * @public\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\n/**\n * Resolve the CLEO home directory for template path expansion.\n *\n * @remarks\n * Honors the `CLEO_HOME` environment variable when set. Otherwise falls\n * back to a platform-appropriate data directory for the `cleo` app name\n * (e.g. `~/.local/share/cleo` on Linux, `~/Library/Application Support/cleo`\n * on macOS, `%LOCALAPPDATA%\\cleo\\Data` on Windows). This mirrors the\n * resolution strategy used by the `@cleocode/core` package's `getCleoHome`\n * helper but is duplicated here to avoid a cross-package runtime dependency.\n *\n * @internal\n */\nfunction getCleoHomeForTemplate(): string {\n  const envOverride = process.env['CLEO_HOME'];\n  if (envOverride && envOverride.trim().length > 0) {\n    return envOverride.trim();\n  }\n  const home = getPlatformLocations().home;\n  if (process.platform === 'win32') {\n    const localAppData = process.env['LOCALAPPDATA'] ?? join(home, 'AppData', 'Local');\n    return join(localAppData, 'cleo', 'Data');\n  }\n  if (process.platform === 'darwin') {\n    return join(home, 'Library', 'Application Support', 'cleo');\n  }\n  const xdgData = process.env['XDG_DATA_HOME'] ?? join(home, '.local', 'share');\n  return join(xdgData, 'cleo');\n}\n\n/**\n * Resolves a registry template path by substituting platform variables.\n *\n * @remarks\n * Replaces template variables like `$HOME`, `$CONFIG`, `$VSCODE_CONFIG`,\n * `$ZED_CONFIG`, `$CLAUDE_DESKTOP_CONFIG`, `$AGENTS_HOME`, and `$CLEO_HOME`\n * with their actual platform-specific values. Used to resolve paths from\n * the provider registry JSON.\n *\n * @param template - The template string containing `$VARIABLE` placeholders\n * @returns The resolved absolute path with all variables expanded\n *\n * @example\n * ```typescript\n * const path = resolveRegistryTemplatePath(\"$HOME/.config/claude/settings.json\");\n * // e.g., \"/home/user/.config/claude/settings.json\"\n * ```\n *\n * @public\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    .replace(/\\$CLEO_HOME/g, getCleoHomeForTemplate());\n}\n\n/**\n * Resolves the configuration file path for a provider at the given scope.\n *\n * @remarks\n * For global scope, returns the provider's `configPathGlobal` directly.\n * For project scope, joins the project directory with the provider's\n * `configPathProject`. Returns null if the provider has no project-scoped\n * config path defined.\n *\n * @param provider - The provider whose config path to resolve\n * @param scope - Whether to resolve global or project config path\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved config file path, or null if unavailable for the given scope\n *\n * @example\n * ```typescript\n * const configPath = resolveProviderConfigPath(provider, \"project\", \"/home/user/project\");\n * if (configPath) {\n *   console.log(\"Config at:\", configPath);\n * }\n * ```\n *\n * @public\n */\nexport function resolveProviderConfigPath(\n  provider: Provider,\n  scope: PathScope,\n  projectDir = process.cwd(),\n): string | null {\n  const mcp = provider.capabilities.mcp;\n  if (!mcp) {\n    return null;\n  }\n  if (scope === 'global') {\n    return mcp.configPathGlobal;\n  }\n  if (!mcp.configPathProject) {\n    return null;\n  }\n  return resolveProjectPath(mcp.configPathProject, projectDir);\n}\n\n/**\n * Determines the preferred configuration scope for a provider.\n *\n * @remarks\n * If the global flag is explicitly set, always returns `\"global\"`. Otherwise,\n * returns `\"project\"` if the provider supports project-scoped configuration,\n * or `\"global\"` as a fallback.\n *\n * @param provider - The provider to determine scope for\n * @param useGlobalFlag - Optional flag to force global scope\n * @returns The preferred path scope for configuration\n *\n * @example\n * ```typescript\n * const scope = resolvePreferredConfigScope(provider, false);\n * // returns \"project\" if provider has configPathProject, otherwise \"global\"\n * ```\n *\n * @public\n */\nexport function resolvePreferredConfigScope(\n  provider: Provider,\n  useGlobalFlag?: boolean,\n): PathScope {\n  if (useGlobalFlag) {\n    return 'global';\n  }\n  return provider.capabilities.mcp?.configPathProject ? 'project' : 'global';\n}\n\n/**\n * Resolves the skills directory path for a provider at the given scope.\n *\n * @remarks\n * For global scope, returns the provider's `pathSkills` directly.\n * For project scope, joins the project directory with the provider's\n * `pathProjectSkills` relative path.\n *\n * @param provider - The provider whose skills directory to resolve\n * @param scope - Whether to resolve global or project skills path\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved skills directory path\n *\n * @example\n * ```typescript\n * const skillsDir = resolveProviderSkillsDir(provider, \"global\");\n * // e.g., \"/home/user/.claude/skills\"\n * ```\n *\n * @public\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 * Gets all target directories for skill installation based on provider precedence.\n *\n * @remarks\n * Resolves one or more skill directories based on the provider's skills\n * precedence setting. The precedence determines whether vendor-only, agents-canonical,\n * agents-first, agents-supported, or vendor-global-agents-project strategies are used.\n * Falls back to the vendor path when the agents path is not configured.\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 *\n * @example\n * ```typescript\n * const dirs = resolveProviderSkillsDirs(provider, \"project\", \"/home/user/project\");\n * for (const dir of dirs) {\n *   console.log(\"Install skill to:\", dir);\n * }\n * ```\n *\n * @public\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\n/**\n * Resolves a provider's project-level path against a project directory.\n *\n * @remarks\n * Joins the project directory with the provider's `pathProject` relative path\n * to produce an absolute path for project-scoped provider configuration.\n *\n * @param provider - The provider whose project path to resolve\n * @param projectDir - The project root directory, defaults to `process.cwd()`\n * @returns The resolved absolute path for the provider's project directory\n *\n * @example\n * ```typescript\n * const projectPath = resolveProviderProjectPath(provider, \"/home/user/project\");\n * // e.g., \"/home/user/project/.claude\"\n * ```\n *\n * @public\n */\nexport function resolveProviderProjectPath(provider: Provider, projectDir = process.cwd()): string {\n  return resolveProjectPath(provider.pathProject, projectDir);\n}\n\n/**\n * Locates the providers registry.json file by searching up from a start directory.\n *\n * @remarks\n * First checks common relative locations (3 levels up and 1 level up),\n * then walks up to 8 parent directories looking for `providers/registry.json`.\n * Throws if the registry file cannot be found.\n *\n * @param startDir - The directory to start searching from\n * @returns The absolute path to the found `providers/registry.json` file\n * @throws Error if `providers/registry.json` cannot be found within 8 parent levels\n *\n * @example\n * ```typescript\n * const registryPath = resolveProvidersRegistryPath(__dirname);\n * // e.g., \"/home/user/caamp/providers/registry.json\"\n * ```\n *\n * @public\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\n/**\n * Normalizes a skill sub-path by cleaning separators and removing SKILL.md suffix.\n *\n * @remarks\n * Converts backslashes to forward slashes, strips leading slashes and\n * trailing `/SKILL.md`, and trims whitespace. Returns undefined for\n * empty or falsy inputs.\n *\n * @param path - The raw skill sub-path to normalize\n * @returns The normalized path, or undefined if the input is empty or falsy\n *\n * @example\n * ```typescript\n * const normalized = normalizeSkillSubPath(\"skills/my-skill/SKILL.md\");\n * // returns \"skills/my-skill\"\n * ```\n *\n * @public\n */\nexport function normalizeSkillSubPath(path: string | undefined): string | undefined {\n  if (!path) return undefined;\n  const normalized = path\n    .replace(/\\\\/g, '/')\n    .replace(/^\\/+/, '')\n    .replace(/\\/SKILL\\.md$/i, '')\n    .trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\n/**\n * Builds a list of candidate sub-paths for skill file resolution.\n *\n * @remarks\n * Normalizes both the marketplace and parsed paths, then generates additional\n * candidates by prepending known prefixes (`.agents`, `.claude`) to paths\n * starting with `skills/`. Returns a deduplicated list of candidates, with\n * an undefined entry as fallback if no candidates are found.\n *\n * @param marketplacePath - The sub-path from the marketplace listing\n * @param parsedPath - The sub-path parsed from the source URL\n * @returns A deduplicated array of candidate sub-paths\n *\n * @example\n * ```typescript\n * const candidates = buildSkillSubPathCandidates(\"skills/my-skill\", undefined);\n * // returns [\"skills/my-skill\", \".agents/skills/my-skill\", \".claude/skills/my-skill\"]\n * ```\n *\n * @public\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?.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":["getPlatformPaths","getSystemInfo","homedir","join","homedir","platform","join","config","join"]}