agdex 0.4.1 → 0.5.0

package/dist/{index-pkx4s2ef.js → index-nn4xptha.js}

@@ -58,7 +58,13 @@ async function pullDocs(provider, options) {
     if (fs.existsSync(docsPath)) {
       fs.rmSync(docsPath, { recursive: true });
     }
-    const tag = provider.versionToTag ? provider.versionToTag(version) : `v${version}`;
+    const defaultVersionToTag = (v) => {
+      if (v.startsWith("v") || /^\d/.test(v)) {
+        return v.startsWith("v") ? v : `v${v}`;
+      }
+      return v;
+    };
+    const tag = provider.versionToTag ? provider.versionToTag(version) : defaultVersionToTag(version);
     await cloneDocsFolder(provider.repo, provider.docsPath, tag, docsPath);
     return {
       success: true,
@@ -345,7 +351,7 @@ async function embed(options) {
     version,
     output = "AGENTS.md",
     docsDir: customDocsDir,
-    globalCache = false,
+    globalCache = true,
     description
   } = options;
   let docsPath;
@@ -374,24 +380,39 @@ async function embed(options) {
     sizeBefore = Buffer.byteLength(existingContent, "utf-8");
     isNewFile = false;
   }
-  const pullResult = await pullDocs(provider, {
-    cwd,
-    version,
-    docsDir: docsPath
-  });
-  if (!pullResult.success) {
-    return {
-      success: false,
-      error: pullResult.error
+  const cacheHit = fs.existsSync(docsPath) && fs.readdirSync(docsPath).length > 0;
+  let pullResult;
+  if (cacheHit) {
+    let resolvedVersion = version;
+    if (!resolvedVersion && provider.detectVersion) {
+      const detected = provider.detectVersion(cwd);
+      resolvedVersion = detected.version || undefined;
+    }
+    pullResult = {
+      success: true,
+      docsPath,
+      version: resolvedVersion
     };
+  } else {
+    pullResult = await pullDocs(provider, {
+      cwd,
+      version,
+      docsDir: docsPath
+    });
+    if (!pullResult.success) {
+      return {
+        success: false,
+        error: pullResult.error
+      };
+    }
   }
   const docFiles = collectDocFiles(docsPath, {
     extensions: provider.extensions,
     excludePatterns: provider.excludePatterns
   });
   const sections = buildDocTree(docFiles);
-  const globalFlag = globalCache ? " --global" : "";
-  const regenerateCommand = `npx agdex --provider ${provider.name} --output ${output}${globalFlag}`;
+  const localFlag = !globalCache ? " --local" : "";
+  const regenerateCommand = `npx agdex --provider ${provider.name} --output ${output}${localFlag}`;
   const indexContent = generateIndex({
     docsPath: docsLinkPath,
     sections,
@@ -420,7 +441,8 @@ async function embed(options) {
     sizeBefore,
     sizeAfter,
     isNewFile,
-    gitignoreUpdated
+    gitignoreUpdated,
+    cacheHit
   };
 }
 
@@ -1601,7 +1623,12 @@ function createProvider(options) {
     docsPath,
     extensions = [".mdx", ".md"],
     packageName,
-    versionToTag = (v) => v.startsWith("v") ? v : `v${v}`,
+    versionToTag = (v) => {
+      if (v.startsWith("v") || /^\d/.test(v)) {
+        return v.startsWith("v") ? v : `v${v}`;
+      }
+      return v;
+    },
     excludePatterns = ["**/index.mdx", "**/index.md"],
     instruction
   } = options;