docs-cache 0.5.3 → 0.5.4

package/dist/esm/git/fetch-source.mjs

@@ -177,35 +177,54 @@ const ensureCommitAvailable = async (repoPath, commit, options) => {
     logger: options?.logger
   });
 };
-const isSparseEligible = (include) => {
-  if (!include || include.length === 0) {
-    return false;
+const patternHasGlob = (pattern) => pattern.includes("*") || pattern.includes("?") || pattern.includes("[");
+const normalizeSparsePatterns = (include) => (include ?? []).map((pattern) => pattern.replace(/\\/g, "/")).filter(Boolean);
+const isDirectoryLiteral = (pattern) => pattern.endsWith("/");
+const toNoConePattern = (pattern) => {
+  if (!patternHasGlob(pattern) && isDirectoryLiteral(pattern)) {
+    return pattern.endsWith("/") ? pattern : `${pattern}/`;
+  }
+  return pattern;
+};
+const resolveSparseSpec = (include) => {
+  const normalized = normalizeSparsePatterns(include);
+  if (normalized.length === 0) {
+    return { enabled: false, mode: "cone", patterns: [] };
   }
-  for (const pattern of include) {
-    if (!pattern || pattern.includes("**")) {
-      return false;
+  const conePaths = [];
+  let coneEligible = true;
+  for (const pattern of normalized) {
+    if (pattern.includes("**")) {
+      coneEligible = false;
+      break;
     }
+    if (patternHasGlob(pattern)) {
+      coneEligible = false;
+      break;
+    }
+    if (isDirectoryLiteral(pattern)) {
+      conePaths.push(pattern.replace(/\/+$/, ""));
+      continue;
+    }
+    coneEligible = false;
+    break;
   }
-  return true;
-};
-const extractSparsePaths = (include) => {
-  if (!include) {
-    return [];
+  const uniquePaths = Array.from(new Set(conePaths.filter(Boolean)));
+  if (coneEligible && uniquePaths.length > 0) {
+    return { enabled: true, mode: "cone", patterns: uniquePaths };
   }
-  const paths = include.map((pattern) => {
-    const normalized = pattern.replace(/\\/g, "/");
-    const starIndex = normalized.indexOf("*");
-    const base = starIndex === -1 ? normalized : normalized.slice(0, starIndex);
-    return base.replace(/\/+$|\/$/, "");
-  });
-  return Array.from(new Set(paths.filter((value) => value.length > 0)));
+  return {
+    enabled: true,
+    mode: "no-cone",
+    patterns: normalized.map(toNoConePattern)
+  };
 };
 const cloneRepo = async (params, outDir) => {
   if (params.offline) {
     throw new Error(`Cannot clone ${params.repo} while offline.`);
   }
   const isCommitRef = /^[0-9a-f]{7,40}$/i.test(params.ref);
-  const useSparse = isSparseEligible(params.include);
+  const sparseSpec = resolveSparseSpec(params.include);
   const buildCloneArgs = () => {
     const cloneArgs2 = [
       "clone",
@@ -218,7 +237,7 @@ const cloneRepo = async (params, outDir) => {
     return cloneArgs2;
   };
   const cloneArgs = buildCloneArgs();
-  if (useSparse) {
+  if (sparseSpec.enabled) {
     cloneArgs.push("--sparse");
   }
   if (!isCommitRef) {
@@ -239,14 +258,16 @@ const cloneRepo = async (params, outDir) => {
     logger: params.logger,
     offline: params.offline
   });
-  if (useSparse) {
-    const sparsePaths = extractSparsePaths(params.include);
-    if (sparsePaths.length > 0) {
-      await git(["-C", outDir, "sparse-checkout", "set", ...sparsePaths], {
-        timeoutMs: params.timeoutMs,
-        logger: params.logger
-      });
+  if (sparseSpec.enabled) {
+    const sparseArgs = ["-C", outDir, "sparse-checkout", "set"];
+    if (sparseSpec.mode === "no-cone") {
+      sparseArgs.push("--no-cone");
     }
+    sparseArgs.push(...sparseSpec.patterns);
+    await git(sparseArgs, {
+      timeoutMs: params.timeoutMs,
+      logger: params.logger
+    });
   }
   await git(
     ["-C", outDir, "checkout", "--quiet", "--detach", params.resolvedCommit],
@@ -281,9 +302,14 @@ const addWorktreeFromCache = async (params, cachePath, outDir) => {
       allowFileProtocol: true
     }
   );
-  const sparsePaths = isSparseEligible(params.include) ? extractSparsePaths(params.include) : [];
-  if (sparsePaths.length > 0) {
-    await git(["-C", outDir, "sparse-checkout", "set", ...sparsePaths], {
+  const sparseSpec = resolveSparseSpec(params.include);
+  if (sparseSpec.enabled) {
+    const sparseArgs = ["-C", outDir, "sparse-checkout", "set"];
+    if (sparseSpec.mode === "no-cone") {
+      sparseArgs.push("--no-cone");
+    }
+    sparseArgs.push(...sparseSpec.patterns);
+    await git(sparseArgs, {
       timeoutMs: params.timeoutMs,
       logger: params.logger,
       allowFileProtocol: true
@@ -380,7 +406,7 @@ const cloneOrUpdateRepo = async (params, outDir) => {
   const cacheExists = await exists(cachePath);
   const cacheValid = cacheExists && await isValidGitRepo(cachePath);
   const isCommitRef = /^[0-9a-f]{7,40}$/i.test(params.ref);
-  const useSparse = isSparseEligible(params.include);
+  const sparseSpec = resolveSparseSpec(params.include);
   let usedCache = cacheValid;
   let worktreeUsed = false;
   const cacheRoot = resolveGitCacheDir();
@@ -410,7 +436,7 @@ const cloneOrUpdateRepo = async (params, outDir) => {
   if (await isPartialClone(cachePath)) {
     localCloneArgs.splice(2, 0, "--filter=blob:none");
   }
-  if (useSparse) {
+  if (sparseSpec.enabled) {
     localCloneArgs.push("--sparse");
   }
   if (!isCommitRef) {
@@ -428,15 +454,17 @@ const cloneOrUpdateRepo = async (params, outDir) => {
     progressLogger: params.progressLogger,
     forceProgress: Boolean(params.progressLogger)
   });
-  if (useSparse) {
-    const sparsePaths = extractSparsePaths(params.include);
-    if (sparsePaths.length > 0) {
-      await git(["-C", outDir, "sparse-checkout", "set", ...sparsePaths], {
-        timeoutMs: params.timeoutMs,
-        allowFileProtocol: true,
-        logger: params.logger
-      });
+  if (sparseSpec.enabled) {
+    const sparseArgs = ["-C", outDir, "sparse-checkout", "set"];
+    if (sparseSpec.mode === "no-cone") {
+      sparseArgs.push("--no-cone");
     }
+    sparseArgs.push(...sparseSpec.patterns);
+    await git(sparseArgs, {
+      timeoutMs: params.timeoutMs,
+      allowFileProtocol: true,
+      logger: params.logger
+    });
   }
   await ensureCommitAvailable(outDir, params.resolvedCommit, {
     timeoutMs: params.timeoutMs,

package/package.json

@@ -2,7 +2,7 @@
 	"name": "docs-cache",
 	"private": false,
 	"type": "module",
-	"version": "0.5.3",
+	"version": "0.5.4",
 	"packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748",
 	"description": "CLI for deterministic local caching of external documentation for agents and tools",
 	"author": "Frederik Bosch",