@salesforce/b2c-tooling-sdk 1.5.0 → 1.6.0

package/dist/cjs/skills/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/skills/parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/skills/parser.ts"],"names":[],"mappings":"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"}

package/dist/cjs/skills/sources.d.ts

@@ -0,0 +1,4 @@
+import type { SkillSet, SkillSourceConfig } from './types.js';
+export declare const SKILL_SOURCES: Record<SkillSet, SkillSourceConfig>;
+export declare function getSkillSource(skillSet: SkillSet): SkillSourceConfig;
+export declare const ALL_SKILL_SETS: SkillSet[];

package/dist/cjs/skills/sources.js

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+function pluginsTag(version) {
+    const bare = version.replace(/^v/, '');
+    return `b2c-agent-plugins@${bare}`;
+}
+export const SKILL_SOURCES = {
+    b2c: {
+        id: 'b2c',
+        displayName: 'B2C Commerce development patterns',
+        type: 'release-artifact',
+        repo: 'SalesforceCommerceCloud/b2c-developer-tooling',
+        assetName: 'b2c-skills.zip',
+        tagPattern: pluginsTag,
+    },
+    'b2c-cli': {
+        id: 'b2c-cli',
+        displayName: 'B2C CLI commands and operations',
+        type: 'release-artifact',
+        repo: 'SalesforceCommerceCloud/b2c-developer-tooling',
+        assetName: 'b2c-cli-skills.zip',
+        tagPattern: pluginsTag,
+    },
+    'cap-dev': {
+        id: 'cap-dev',
+        displayName: 'Commerce Apps development skills',
+        type: 'repo-contents',
+        repo: 'SalesforceCommerceCloud/commerce-apps',
+        ref: 'main',
+        skillsPath: '.claude/skills',
+    },
+};
+export function getSkillSource(skillSet) {
+    const source = SKILL_SOURCES[skillSet];
+    if (!source) {
+        throw new Error(`Unknown skill set: ${skillSet}`);
+    }
+    return source;
+}
+export const ALL_SKILL_SETS = Object.keys(SKILL_SOURCES);
+//# sourceMappingURL=sources.js.map

package/dist/cjs/skills/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../../src/skills/sources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,qBAAqB,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAwC;IAChE,GAAG,EAAE;QACH,EAAE,EAAE,KAAK;QACT,WAAW,EAAE,mCAAmC;QAChD,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,+CAA+C;QACrD,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,UAAU;KACvB;IACD,SAAS,EAAE;QACT,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,iCAAiC;QAC9C,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,+CAA+C;QACrD,SAAS,EAAE,oBAAoB;QAC/B,UAAU,EAAE,UAAU;KACvB;IACD,SAAS,EAAE;QACT,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,kCAAkC;QAC/C,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,uCAAuC;QAC7C,GAAG,EAAE,MAAM;QACX,UAAU,EAAE,gBAAgB;KAC7B;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAe,MAAM,CAAC,IAAI,CAAC,aAAa,CAAe,CAAC"}

package/dist/cjs/skills/types.d.ts

@@ -5,7 +5,20 @@ export type IdeType = 'claude-code' | 'cursor' | 'windsurf' | 'vscode' | 'codex'
 /**
  * Skill set categories matching the plugins directory structure.
  */
-export type SkillSet = 'b2c' | 'b2c-cli';
+export type SkillSet = 'b2c' | 'b2c-cli' | 'cap-dev';
+/**
+ * Configuration for a skill source — defines how to fetch skills from a particular repository.
+ */
+export interface SkillSourceConfig {
+    id: SkillSet;
+    displayName: string;
+    type: 'release-artifact' | 'repo-contents';
+    repo: string;
+    assetName?: string;
+    tagPattern?: (version: string) => string;
+    ref?: string;
+    skillsPath?: string;
+}
 /**
  * IDE path configuration for skill installation.
  */
@@ -133,4 +146,6 @@ export interface CachedArtifact {
     path: string;
     /** ISO date string when artifact was downloaded */
     downloadedAt: string;
+    /** For repo-contents sources: the resolved commit SHA */
+    commitSha?: string;
 }

package/dist/esm/skills/github.d.ts

@@ -2,46 +2,30 @@ import type { CachedArtifact, DownloadSkillsOptions, ReleaseInfo, SkillSet } fro
 /**
  * Get the cache directory for skills.
  * Uses XDG_CACHE_HOME on Linux, ~/.cache otherwise.
- *
- * @returns Absolute path to cache directory
  */
 export declare function getCacheDir(): string;
 /**
  * Fetch release information from GitHub API.
- *
- * @param version - 'latest' or specific version (e.g., 'v0.1.0')
- * @returns Release information
- * @throws Error if release not found or API request fails
  */
 export declare function getRelease(version?: string): Promise<ReleaseInfo>;
 /**
  * List available releases with skills artifacts.
- *
- * @param limit - Maximum number of releases to return (default: 10)
- * @returns Array of release information
  */
 export declare function listReleases(limit?: number): Promise<ReleaseInfo[]>;
 /**
  * Get cached artifact metadata if available.
- *
- * @param version - Release version
- * @param skillSet - Skill set to check
- * @returns Cached artifact info or null if not cached
  */
 export declare function getCachedArtifact(version: string, skillSet: SkillSet): CachedArtifact | null;
 /**
  * Download and extract skills artifact.
- * Uses direct download URLs to avoid GitHub API rate limits.
+ * Dispatches to the appropriate download strategy based on the skill source type.
  *
- * @param skillSet - Which skill set to download ('b2c' or 'b2c-cli')
+ * @param skillSet - Which skill set to download
  * @param options - Download options
  * @returns Path to extracted skills directory
- * @throws Error if download fails or artifact not available
  */
 export declare function downloadSkillsArtifact(skillSet: SkillSet, options?: DownloadSkillsOptions): Promise<string>;
 /**
  * Clear the skills cache.
- *
- * @param version - Optional specific version to clear (default: all)
  */
 export declare function clearCache(version?: string): Promise<void>;

package/dist/esm/skills/github.js

@@ -3,46 +3,25 @@
  * SPDX-License-Identifier: Apache-2
  * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
  */
+import { execFile } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
+import { promisify } from 'node:util';
 import JSZip from 'jszip';
+import { getSkillSource } from './sources.js';
 import { getLogger } from '../logging/logger.js';
-const GITHUB_REPO = 'SalesforceCommerceCloud/b2c-developer-tooling';
+const execFileAsync = promisify(execFile);
 const GITHUB_API_BASE = 'https://api.github.com';
 const GITHUB_DOWNLOAD_BASE = 'https://github.com';
 const GITHUB_RAW_BASE = 'https://raw.githubusercontent.com';
 const LATEST_VERSION_CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
-/**
- * Asset filename patterns for skill archives.
- */
-const ASSET_NAMES = {
-    b2c: 'b2c-skills.zip',
-    'b2c-cli': 'b2c-cli-skills.zip',
-};
-/**
- * Build a direct CDN download URL for a release asset.
- * Assumes a concrete tag — call `resolveLatestVersion()` first if you have 'latest'.
- */
-function buildDownloadUrl(tag, assetName) {
-    return `${GITHUB_DOWNLOAD_BASE}/${GITHUB_REPO}/releases/download/${tag}/${assetName}`;
-}
-/**
- * Tag name used for skill-only releases (matches publish.yml).
- */
-function pluginsTag(version) {
-    const bare = version.replace(/^v/, '');
-    return `b2c-agent-plugins@${bare}`;
+function buildDownloadUrl(repo, tag, assetName) {
+    return `${GITHUB_DOWNLOAD_BASE}/${repo}/releases/download/${tag}/${assetName}`;
 }
-/**
- * File path for the resolved-latest-version cache.
- */
 function getLatestVersionCachePath() {
     return path.join(getCacheDir(), '.latest-version.json');
 }
-/**
- * Read a cached "latest" version if still fresh (1-hour TTL).
- */
 function readLatestVersionCache() {
     try {
         const p = getLatestVersionCachePath();
@@ -68,9 +47,6 @@ function writeLatestVersionCache(version) {
         // Caching is best-effort
     }
 }
-/**
- * Detect whether a fetch response is an unauthenticated GitHub rate-limit.
- */
 function isRateLimited(response) {
     if (response.status !== 403 && response.status !== 429)
         return false;
@@ -78,27 +54,15 @@ function isRateLimited(response) {
     return remaining === '0' || response.status === 429;
 }
 /**
- * Resolve the version of the most recent skills release.
- *
- * Strategy:
- *   1. API primary — paginate /releases and return the first entry that has
- *      a skills asset attached.
- *   2. Rate-limit fallback — fetch skills/package.json from main via
- *      raw.githubusercontent.com. This is the version that will be tagged
- *      b2c-agent-plugins@<version> at release time.
- *
- * Caches the resolved version for 1 hour to avoid re-resolving on consecutive
- * calls within the same session. Always returns a bare version string like
- * "1.2.3" (no 'v' prefix, no tag format).
+ * Resolve the version of the most recent skills release from the b2c-developer-tooling repo.
  */
-async function resolveLatestVersion() {
+async function resolveLatestVersion(source) {
     const logger = getLogger();
     const cached = readLatestVersionCache();
     if (cached) {
         logger.debug({ version: cached }, 'Using cached latest version');
         return cached;
     }
-    // Primary — GitHub REST API with asset filtering
     try {
         const releases = await listReleases(30);
         if (releases.length > 0) {
@@ -117,8 +81,7 @@ async function resolveLatestVersion() {
             logger.warn({ err: err.message }, 'GitHub API unavailable; falling back to main branch for version resolution');
         }
     }
-    // Fallback — read skills/package.json from main via raw.githubusercontent.com
-    const rawUrl = `${GITHUB_RAW_BASE}/${GITHUB_REPO}/main/skills/package.json`;
+    const rawUrl = `${GITHUB_RAW_BASE}/${source.repo}/main/skills/package.json`;
     logger.debug({ url: rawUrl }, 'Fetching version from raw.githubusercontent.com');
     const response = await fetch(rawUrl, { headers: { 'User-Agent': 'b2c-cli' } });
     if (!response.ok) {
@@ -134,20 +97,17 @@ async function resolveLatestVersion() {
 /**
  * Get the cache directory for skills.
  * Uses XDG_CACHE_HOME on Linux, ~/.cache otherwise.
- *
- * @returns Absolute path to cache directory
  */
 export function getCacheDir() {
     const xdgCache = process.env.XDG_CACHE_HOME;
     const baseCache = xdgCache || path.join(os.homedir(), '.cache');
     return path.join(baseCache, 'b2c-cli', 'skills');
 }
-/**
- * Parse GitHub API release response into ReleaseInfo.
- */
 function parseRelease(release) {
-    const b2cAsset = release.assets.find((a) => a.name === ASSET_NAMES['b2c']);
-    const b2cCliAsset = release.assets.find((a) => a.name === ASSET_NAMES['b2c-cli']);
+    const b2cSource = getSkillSource('b2c');
+    const b2cCliSource = getSkillSource('b2c-cli');
+    const b2cAsset = release.assets.find((a) => a.name === b2cSource.assetName);
+    const b2cCliAsset = release.assets.find((a) => a.name === b2cCliSource.assetName);
     return {
         tagName: release.tag_name,
         version: release.tag_name.replace(/^v/, ''),
@@ -158,29 +118,22 @@ function parseRelease(release) {
 }
 /**
  * Fetch release information from GitHub API.
- *
- * @param version - 'latest' or specific version (e.g., 'v0.1.0')
- * @returns Release information
- * @throws Error if release not found or API request fails
  */
 export async function getRelease(version = 'latest') {
     const logger = getLogger();
-    // For 'latest', resolve to a concrete tag via the skills-aware resolver.
-    // This avoids GitHub's /releases/latest endpoint, which returns whichever
-    // release GitHub flags as latest regardless of whether it contains skills.
+    const source = getSkillSource('b2c');
     let tag;
     if (version === 'latest') {
-        const resolved = await resolveLatestVersion();
-        tag = pluginsTag(resolved);
+        const resolved = await resolveLatestVersion(source);
+        tag = source.tagPattern(resolved);
     }
     else if (/^b2c-agent-plugins@/.test(version) || version.includes('@')) {
-        // Caller passed an explicit tag (including other packages' tags, for tests/internal use).
         tag = version;
     }
     else {
-        tag = pluginsTag(version);
+        tag = source.tagPattern(version);
     }
-    const endpoint = `${GITHUB_API_BASE}/repos/${GITHUB_REPO}/releases/tags/${encodeURIComponent(tag)}`;
+    const endpoint = `${GITHUB_API_BASE}/repos/${source.repo}/releases/tags/${encodeURIComponent(tag)}`;
     logger.debug({ endpoint }, 'Fetching release info');
     const response = await fetch(endpoint, {
         headers: {
@@ -202,13 +155,11 @@ export async function getRelease(version = 'latest') {
 }
 /**
  * List available releases with skills artifacts.
- *
- * @param limit - Maximum number of releases to return (default: 10)
- * @returns Array of release information
  */
 export async function listReleases(limit = 10) {
     const logger = getLogger();
-    const endpoint = `${GITHUB_API_BASE}/repos/${GITHUB_REPO}/releases?per_page=${limit}`;
+    const source = getSkillSource('b2c');
+    const endpoint = `${GITHUB_API_BASE}/repos/${source.repo}/releases?per_page=${limit}`;
     logger.debug({ endpoint }, 'Listing releases');
     const response = await fetch(endpoint, {
         headers: {
@@ -220,15 +171,10 @@ export async function listReleases(limit = 10) {
         throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
     }
     const data = (await response.json());
-    // Only return releases that have at least one skills artifact
     return data.map(parseRelease).filter((r) => r.b2cSkillsAssetUrl || r.b2cCliSkillsAssetUrl);
 }
 /**
  * Get cached artifact metadata if available.
- *
- * @param version - Release version
- * @param skillSet - Skill set to check
- * @returns Cached artifact info or null if not cached
  */
 export function getCachedArtifact(version, skillSet) {
     const cacheDir = getCacheDir();
@@ -245,58 +191,40 @@ export function getCachedArtifact(version, skillSet) {
     }
 }
 /**
- * Download and extract skills artifact.
- * Uses direct download URLs to avoid GitHub API rate limits.
- *
- * @param skillSet - Which skill set to download ('b2c' or 'b2c-cli')
- * @param options - Download options
- * @returns Path to extracted skills directory
- * @throws Error if download fails or artifact not available
+ * Download and extract a release-artifact skill set (b2c or b2c-cli).
  */
-export async function downloadSkillsArtifact(skillSet, options = {}) {
+async function downloadReleaseArtifact(source, options = {}) {
     const logger = getLogger();
     const { version = 'latest', forceDownload = false } = options;
-    const assetName = ASSET_NAMES[skillSet];
-    // Resolve 'latest' to a concrete version before any download or cache lookup.
-    // This keeps the cache keyed to real version tags and avoids GitHub's opinionated
-    // /releases/latest endpoint, which may point at a release that has no skills zips.
-    const resolvedVersion = version === 'latest' ? await resolveLatestVersion() : version.replace(/^v/, '');
-    const tag = pluginsTag(resolvedVersion);
-    // Check cache for the resolved version
+    const resolvedVersion = version === 'latest' ? await resolveLatestVersion(source) : version.replace(/^v/, '');
+    const tag = source.tagPattern(resolvedVersion);
     if (!forceDownload) {
-        const cached = getCachedArtifact(resolvedVersion, skillSet);
+        const cached = getCachedArtifact(resolvedVersion, source.id);
         if (cached && fs.existsSync(cached.path)) {
-            logger.debug({ version: resolvedVersion, skillSet, path: cached.path }, 'Using cached skills');
+            logger.debug({ version: resolvedVersion, skillSet: source.id, path: cached.path }, 'Using cached skills');
             return cached.path;
         }
     }
-    // Download from the CDN — no API rate limit on this path.
-    const downloadUrl = buildDownloadUrl(tag, assetName);
-    logger.debug({ url: downloadUrl, skillSet }, 'Downloading skills artifact');
-    // Download artifact - GitHub will redirect to the actual file
+    const downloadUrl = buildDownloadUrl(source.repo, tag, source.assetName);
+    logger.debug({ url: downloadUrl, skillSet: source.id }, 'Downloading skills artifact');
     const response = await fetch(downloadUrl, {
-        headers: {
-            'User-Agent': 'b2c-cli',
-        },
+        headers: { 'User-Agent': 'b2c-cli' },
         redirect: 'follow',
     });
     if (!response.ok) {
         if (response.status === 404) {
-            throw new Error(`Skills artifact '${assetName}' not found for release ${tag}`);
+            throw new Error(`Skills artifact '${source.assetName}' not found for release ${tag}`);
         }
         throw new Error(`Failed to download skills: ${response.status} ${response.statusText}`);
     }
     const zipBuffer = Buffer.from(await response.arrayBuffer());
     logger.debug({ size: zipBuffer.length, version: resolvedVersion }, 'Downloaded skills archive');
-    // Extract to cache directory
     const cacheDir = options.cacheDir || getCacheDir();
-    const extractDir = path.join(cacheDir, resolvedVersion, skillSet);
-    // Clean existing extraction if present
+    const extractDir = path.join(cacheDir, resolvedVersion, source.id);
     if (fs.existsSync(extractDir)) {
         await fs.promises.rm(extractDir, { recursive: true });
     }
     await fs.promises.mkdir(extractDir, { recursive: true });
-    // Extract zip contents
     const zip = await JSZip.loadAsync(zipBuffer);
     let extractedCount = 0;
     for (const [relativePath, zipEntry] of Object.entries(zip.files)) {
@@ -306,15 +234,12 @@ export async function downloadSkillsArtifact(skillSet, options = {}) {
         }
         const targetPath = path.join(extractDir, relativePath);
         const targetDir = path.dirname(targetPath);
-        // Ensure parent directory exists
         await fs.promises.mkdir(targetDir, { recursive: true });
-        // Write file
         const content = await zipEntry.async('nodebuffer');
         await fs.promises.writeFile(targetPath, content);
         extractedCount++;
     }
     logger.debug({ extractDir, fileCount: extractedCount }, 'Extracted skills');
-    // Write cache manifest
     const manifest = {
         version: resolvedVersion,
         path: extractDir,
@@ -324,9 +249,171 @@ export async function downloadSkillsArtifact(skillSet, options = {}) {
     return extractDir;
 }
 /**
- * Clear the skills cache.
+ * Resolve a git ref to a commit SHA via the GitHub API.
+ */
+async function resolveCommitSha(repo, ref) {
+    const response = await fetch(`${GITHUB_API_BASE}/repos/${repo}/commits/${encodeURIComponent(ref)}`, {
+        headers: { 'User-Agent': 'b2c-cli', Accept: 'application/vnd.github.v3.sha' },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to resolve ref '${ref}' for ${repo}: ${response.status} ${response.statusText}`);
+    }
+    return (await response.text()).trim();
+}
+/**
+ * Recursively fetch directory contents from the GitHub Contents API and write to disk.
+ */
+async function fetchContentsRecursive(repo, repoPath, ref, destDir) {
+    const logger = getLogger();
+    const endpoint = `${GITHUB_API_BASE}/repos/${repo}/contents/${encodeURIComponent(repoPath)}?ref=${encodeURIComponent(ref)}`;
+    const response = await fetch(endpoint, {
+        headers: { Accept: 'application/vnd.github.v3+json', 'User-Agent': 'b2c-cli' },
+    });
+    if (!response.ok) {
+        if (isRateLimited(response)) {
+            throw Object.assign(new Error('GitHub API rate-limited'), { rateLimited: true });
+        }
+        throw new Error(`GitHub Contents API error for ${repoPath}: ${response.status} ${response.statusText}`);
+    }
+    const entries = (await response.json());
+    let fileCount = 0;
+    await fs.promises.mkdir(destDir, { recursive: true });
+    for (const entry of entries) {
+        const targetPath = path.join(destDir, entry.name);
+        if (entry.type === 'dir') {
+            fileCount += await fetchContentsRecursive(repo, entry.path, ref, targetPath);
+        }
+        else if (entry.type === 'file' && entry.download_url) {
+            const fileResponse = await fetch(entry.download_url, { headers: { 'User-Agent': 'b2c-cli' } });
+            if (!fileResponse.ok) {
+                logger.warn({ path: entry.path }, 'Failed to download file, skipping');
+                continue;
+            }
+            const content = Buffer.from(await fileResponse.arrayBuffer());
+            await fs.promises.writeFile(targetPath, content);
+            fileCount++;
+        }
+    }
+    return fileCount;
+}
+/**
+ * Recursively copy a directory tree.
+ */
+async function copyDirRecursive(src, dest) {
+    await fs.promises.mkdir(dest, { recursive: true });
+    const entries = await fs.promises.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirRecursive(srcPath, destPath);
+        }
+        else if (entry.isFile()) {
+            await fs.promises.copyFile(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Fallback: use sparse git checkout to fetch only the skills subtree.
+ */
+async function fetchViaSparseCheckout(repo, ref, skillsPath, destDir) {
+    const logger = getLogger();
+    const tmpDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'b2c-skills-'));
+    try {
+        const repoUrl = `${GITHUB_DOWNLOAD_BASE}/${repo}.git`;
+        logger.debug({ repoUrl, skillsPath }, 'Falling back to sparse git checkout');
+        await execFileAsync('git', [
+            'clone',
+            '--no-checkout',
+            '--depth',
+            '1',
+            '--filter=blob:none',
+            '--sparse',
+            repoUrl,
+            tmpDir,
+        ]);
+        await execFileAsync('git', ['-C', tmpDir, 'sparse-checkout', 'set', skillsPath]);
+        await execFileAsync('git', ['-C', tmpDir, 'checkout']);
+        const skillsSrc = path.join(tmpDir, skillsPath);
+        if (!fs.existsSync(skillsSrc)) {
+            throw new Error(`Skills path '${skillsPath}' not found in repo ${repo}`);
+        }
+        await copyDirRecursive(skillsSrc, destDir);
+    }
+    finally {
+        await fs.promises.rm(tmpDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Download skills from a repo-contents source (e.g., commerce-apps).
+ * Primary: GitHub Contents API. Fallback: sparse git checkout.
+ */
+async function downloadRepoContents(source, options = {}) {
+    const logger = getLogger();
+    const ref = options.version || source.ref || 'main';
+    const forceDownload = options.forceDownload ?? false;
+    const skillsPath = source.skillsPath || '.claude/skills';
+    const commitSha = await resolveCommitSha(source.repo, ref);
+    const cacheKey = `${ref}-${commitSha.slice(0, 8)}`;
+    if (!forceDownload) {
+        const cached = getCachedArtifact(cacheKey, source.id);
+        if (cached && fs.existsSync(cached.path)) {
+            logger.debug({ cacheKey, skillSet: source.id, path: cached.path }, 'Using cached skills');
+            return cached.path;
+        }
+    }
+    const cacheDir = options.cacheDir || getCacheDir();
+    const extractDir = path.join(cacheDir, cacheKey, source.id);
+    const skillsDestDir = path.join(extractDir, 'skills');
+    if (fs.existsSync(extractDir)) {
+        await fs.promises.rm(extractDir, { recursive: true });
+    }
+    await fs.promises.mkdir(skillsDestDir, { recursive: true });
+    try {
+        logger.debug({ repo: source.repo, skillsPath, ref }, 'Fetching skills via Contents API');
+        const fileCount = await fetchContentsRecursive(source.repo, skillsPath, ref, skillsDestDir);
+        logger.debug({ extractDir, fileCount }, 'Fetched skills via Contents API');
+    }
+    catch (err) {
+        const isRateLimit = err instanceof Error && 'rateLimited' in err;
+        if (isRateLimit) {
+            logger.warn('Contents API rate-limited; falling back to sparse git checkout');
+        }
+        else {
+            logger.warn({ err: err.message }, 'Contents API failed; falling back to sparse git checkout');
+        }
+        if (fs.existsSync(skillsDestDir)) {
+            await fs.promises.rm(skillsDestDir, { recursive: true });
+        }
+        await fs.promises.mkdir(skillsDestDir, { recursive: true });
+        await fetchViaSparseCheckout(source.repo, ref, skillsPath, skillsDestDir);
+    }
+    const manifest = {
+        version: cacheKey,
+        path: extractDir,
+        downloadedAt: new Date().toISOString(),
+        commitSha,
+    };
+    await fs.promises.writeFile(path.join(extractDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+    return extractDir;
+}
+/**
+ * Download and extract skills artifact.
+ * Dispatches to the appropriate download strategy based on the skill source type.
  *
- * @param version - Optional specific version to clear (default: all)
+ * @param skillSet - Which skill set to download
+ * @param options - Download options
+ * @returns Path to extracted skills directory
+ */
+export async function downloadSkillsArtifact(skillSet, options = {}) {
+    const source = getSkillSource(skillSet);
+    if (source.type === 'release-artifact') {
+        return downloadReleaseArtifact(source, options);
+    }
+    return downloadRepoContents(source, options);
+}
+/**
+ * Clear the skills cache.
  */
 export async function clearCache(version) {
     const cacheDir = getCacheDir();