agdex 0.8.0 → 0.9.0

package/dist/{index-38fpcrpr.js → index-xbmyce2p.js}

@@ -1,7 +1,6 @@
 import {
-  __require,
-  __toESM
-} from "./url-scraper-fme0jdje.js";
+  __require
+} from "./index-pyanjjwn.js";
 
 // src/lib/lockfile.ts
 import fs from "fs";
@@ -68,6 +67,23 @@ function upsertIndexLockEntry(cwd, entry) {
   writeIndexLockfile(cwd, lockfile);
   return nextEntry;
 }
+function removeIndexLockEntries(cwd, criteria) {
+  const lockfile = readIndexLockfile(cwd);
+  const normalizedTarget = criteria.targetFile ? normalizeRelativePath(criteria.targetFile) : undefined;
+  const removed = [];
+  const kept = lockfile.indexes.filter((entry) => {
+    const matches = (criteria.kind === undefined || entry.kind === criteria.kind) && (criteria.marker === undefined || entry.marker === criteria.marker) && (normalizedTarget === undefined || entry.targetFile === normalizedTarget);
+    if (matches) {
+      removed.push(entry.id);
+      return false;
+    }
+    return true;
+  });
+  if (removed.length > 0) {
+    writeIndexLockfile(cwd, { schemaVersion: LOCKFILE_SCHEMA_VERSION, indexes: kept });
+  }
+  return removed;
+}
 
 // src/lib/agents-md.ts
 import { execSync } from "child_process";
@@ -77,6 +93,9 @@ import os from "os";
 var START_MARKER_PREFIX = "<!-- AGENTS-MD-EMBED-START";
 var END_MARKER_PREFIX = "<!-- AGENTS-MD-EMBED-END";
 var MARKER_SUFFIX = " -->";
+var DEFAULT_DOC_INDEX_FILE = "DOCINDEX.md";
+var DOC_SUMMARY_START_MARKER = "<!-- AGENTS-MD-DOCINDEX-SUMMARY-START -->";
+var DOC_SUMMARY_END_MARKER = "<!-- AGENTS-MD-DOCINDEX-SUMMARY-END -->";
 function getStartMarker(providerName) {
   return providerName ? `${START_MARKER_PREFIX}:${providerName}${MARKER_SUFFIX}` : `${START_MARKER_PREFIX}${MARKER_SUFFIX}`;
 }
@@ -85,7 +104,7 @@ function getEndMarker(providerName) {
 }
 async function pullDocs(provider, options) {
   if (provider.urlConfig) {
-    const { pullDocsFromUrl } = await import("./url-scraper-fme0jdje.js");
+    const { pullDocsFromUrl } = await import("./url-scraper-9bqyj00r.js");
     const docsPath2 = options.docsDir ?? fs2.mkdtempSync(path2.join(os.tmpdir(), "agdex-"));
     return pullDocsFromUrl(provider.urlConfig, docsPath2, { onProgress: options.onProgress });
   }
@@ -368,6 +387,10 @@ function injectIndex(existingContent, indexContent, providerName) {
     const endIdx = existingContent.indexOf(endMarker) + endMarker.length;
     return existingContent.slice(0, startIdx) + wrappedContent + existingContent.slice(endIdx);
   }
+  if (existingContent.length === 0) {
+    return wrappedContent + `
+`;
+  }
   const separator = existingContent.endsWith(`
 `) ? `
 ` : `
@@ -376,6 +399,178 @@ function injectIndex(existingContent, indexContent, providerName) {
   return existingContent + separator + wrappedContent + `
 `;
 }
+function getDocIndexEntries(content) {
+  const entries = [];
+  const regex = /<!-- AGENTS-MD-EMBED-START:(\S+?) -->\r?\n([\s\S]*?)<!-- AGENTS-MD-EMBED-END:\1 -->/g;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    const name = match[1];
+    const block = match[2];
+    const headerMatch = block.match(/\[(.+?)\]/);
+    let displayName = name;
+    if (headerMatch) {
+      const parsed = headerMatch[1].replace(/\s*Docs Index$/, "").trim();
+      displayName = parsed || name;
+    }
+    entries.push({ name, displayName });
+  }
+  return entries;
+}
+function generateDocIndexSummary(entries, docIndexFile = DEFAULT_DOC_INDEX_FILE) {
+  const lines = [
+    "## Document Indices",
+    "",
+    `IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any of the docs found in ${docIndexFile} .`,
+    ""
+  ];
+  if (entries.length === 0) {
+    lines.push("_No documentation indices available yet._");
+  } else {
+    for (const entry of entries) {
+      lines.push(`- ${entry.displayName} (\`${entry.name}\`)`);
+    }
+  }
+  return lines.join(`
+`);
+}
+function hasDocIndexSummary(content) {
+  return content.includes(DOC_SUMMARY_START_MARKER);
+}
+function injectDocIndexSummary(existingContent, summaryContent) {
+  const wrappedContent = `${DOC_SUMMARY_START_MARKER}
+${summaryContent}
+${DOC_SUMMARY_END_MARKER}`;
+  if (hasDocIndexSummary(existingContent)) {
+    const startIdx = existingContent.indexOf(DOC_SUMMARY_START_MARKER);
+    const endIdx = existingContent.indexOf(DOC_SUMMARY_END_MARKER) + DOC_SUMMARY_END_MARKER.length;
+    return existingContent.slice(0, startIdx) + wrappedContent + existingContent.slice(endIdx);
+  }
+  if (existingContent.length === 0) {
+    return wrappedContent + `
+`;
+  }
+  const separator = existingContent.endsWith(`
+`) ? `
+` : `
+
+`;
+  return existingContent + separator + wrappedContent + `
+`;
+}
+function removeDocIndexSummary(content) {
+  if (!hasDocIndexSummary(content)) {
+    return content;
+  }
+  const startIdx = content.indexOf(DOC_SUMMARY_START_MARKER);
+  const endIdx = content.indexOf(DOC_SUMMARY_END_MARKER) + DOC_SUMMARY_END_MARKER.length;
+  let result = content.slice(0, startIdx) + content.slice(endIdx);
+  result = result.replace(/\n{3,}/g, `
+
+`);
+  result = result.trimEnd();
+  if (result.length > 0) {
+    result += `
+`;
+  }
+  return result;
+}
+function applyDocIndex(options) {
+  const { cwd, agentFile, providerName, indexContent } = options;
+  const docIndexFile = options.docIndexFile || DEFAULT_DOC_INDEX_FILE;
+  const docIndexPath = path2.join(cwd, docIndexFile);
+  const agentPath = path2.join(cwd, agentFile);
+  let docIndexContent = "";
+  let docIndexSizeBefore = 0;
+  if (fs2.existsSync(docIndexPath)) {
+    docIndexContent = fs2.readFileSync(docIndexPath, "utf-8");
+    docIndexSizeBefore = Buffer.byteLength(docIndexContent, "utf-8");
+  }
+  const newDocIndexContent = injectIndex(docIndexContent, indexContent, providerName);
+  fs2.writeFileSync(docIndexPath, newDocIndexContent, "utf-8");
+  const docIndexSizeAfter = Buffer.byteLength(newDocIndexContent, "utf-8");
+  let agentContent = "";
+  let agentSizeBefore = 0;
+  let isNewAgentFile = true;
+  if (fs2.existsSync(agentPath)) {
+    agentContent = fs2.readFileSync(agentPath, "utf-8");
+    agentSizeBefore = Buffer.byteLength(agentContent, "utf-8");
+    isNewAgentFile = false;
+  }
+  const entries = getDocIndexEntries(newDocIndexContent);
+  const summary = generateDocIndexSummary(entries, docIndexFile);
+  const newAgentContent = injectDocIndexSummary(agentContent, summary);
+  fs2.writeFileSync(agentPath, newAgentContent, "utf-8");
+  const agentSizeAfter = Buffer.byteLength(newAgentContent, "utf-8");
+  return {
+    docIndexFile,
+    docIndexPath,
+    agentFile,
+    agentPath,
+    isNewAgentFile,
+    agentSizeBefore,
+    agentSizeAfter,
+    docIndexSizeBefore,
+    docIndexSizeAfter,
+    entries
+  };
+}
+function removeDocIndexEntry(options) {
+  const { cwd, agentFile, providerName } = options;
+  const docIndexFile = options.docIndexFile || DEFAULT_DOC_INDEX_FILE;
+  const docIndexPath = path2.join(cwd, docIndexFile);
+  const agentPath = path2.join(cwd, agentFile);
+  const base = {
+    removed: false,
+    removedProviders: [],
+    docIndexFile,
+    docIndexDeleted: false,
+    agentFile,
+    agentSizeBefore: 0,
+    agentSizeAfter: 0,
+    docIndexSizeBefore: 0,
+    docIndexSizeAfter: 0
+  };
+  if (!fs2.existsSync(docIndexPath)) {
+    return base;
+  }
+  const docIndexContent = fs2.readFileSync(docIndexPath, "utf-8");
+  base.docIndexSizeBefore = Buffer.byteLength(docIndexContent, "utf-8");
+  if (!hasExistingIndex(docIndexContent, providerName)) {
+    base.docIndexSizeAfter = base.docIndexSizeBefore;
+    return base;
+  }
+  const before = getEmbeddedProviders(docIndexContent);
+  const newDocIndexContent = removeDocsIndex(docIndexContent, providerName);
+  const after = getEmbeddedProviders(newDocIndexContent);
+  base.removedProviders = before.filter((p) => !after.includes(p));
+  base.removed = true;
+  const remainingEntries = getDocIndexEntries(newDocIndexContent);
+  let agentContent = "";
+  if (fs2.existsSync(agentPath)) {
+    agentContent = fs2.readFileSync(agentPath, "utf-8");
+    base.agentSizeBefore = Buffer.byteLength(agentContent, "utf-8");
+  }
+  if (remainingEntries.length === 0) {
+    fs2.rmSync(docIndexPath);
+    base.docIndexDeleted = true;
+    base.docIndexSizeAfter = 0;
+    const newAgentContent = removeDocIndexSummary(agentContent);
+    if (fs2.existsSync(agentPath)) {
+      fs2.writeFileSync(agentPath, newAgentContent, "utf-8");
+    }
+    base.agentSizeAfter = Buffer.byteLength(newAgentContent, "utf-8");
+  } else {
+    fs2.writeFileSync(docIndexPath, newDocIndexContent, "utf-8");
+    base.docIndexSizeAfter = Buffer.byteLength(newDocIndexContent, "utf-8");
+    const summary = generateDocIndexSummary(remainingEntries, docIndexFile);
+    const newAgentContent = injectDocIndexSummary(agentContent, summary);
+    if (fs2.existsSync(agentPath) || newAgentContent.length > 0) {
+      fs2.writeFileSync(agentPath, newAgentContent, "utf-8");
+    }
+    base.agentSizeAfter = Buffer.byteLength(newAgentContent, "utf-8");
+  }
+  return base;
+}
 function ensureGitignoreEntry(cwd, docsDir) {
   const gitignorePath = path2.join(cwd, ".gitignore");
   const entry = docsDir.endsWith("/") ? docsDir : `${docsDir}/`;
@@ -413,7 +608,8 @@ async function embed(options) {
     output = "CLAUDE.local.md",
     docsDir: customDocsDir,
     globalCache = false,
-    description
+    description,
+    docIndexFile = DEFAULT_DOC_INDEX_FILE
   } = options;
   let docsPath;
   let docsLinkPath;
@@ -432,15 +628,6 @@ async function embed(options) {
     docsPath = path2.join(cwd, docsDir);
     docsLinkPath = `./${docsDir}`;
   }
-  const targetPath = path2.join(cwd, output);
-  let sizeBefore = 0;
-  let isNewFile = true;
-  let existingContent = "";
-  if (fs2.existsSync(targetPath)) {
-    existingContent = fs2.readFileSync(targetPath, "utf-8");
-    sizeBefore = Buffer.byteLength(existingContent, "utf-8");
-    isNewFile = false;
-  }
   const cacheHit = fs2.existsSync(docsPath) && fs2.readdirSync(docsPath).length > 0;
   let pullResult;
   if (cacheHit) {
@@ -483,9 +670,13 @@ async function embed(options) {
     description,
     regenerateCommand
   });
-  const newContent = injectIndex(existingContent, indexContent, provider.name);
-  fs2.writeFileSync(targetPath, newContent, "utf-8");
-  const sizeAfter = Buffer.byteLength(newContent, "utf-8");
+  const applied = applyDocIndex({
+    cwd,
+    agentFile: output,
+    providerName: provider.name,
+    indexContent,
+    docIndexFile
+  });
   let gitignoreUpdated = false;
   if (!globalCache && !customDocsDir) {
     const gitignoreResult = ensureGitignoreEntry(cwd, ".agdex");
@@ -517,11 +708,14 @@ async function embed(options) {
     targetFile: output,
     docsPath: globalCache ? docsPath : docsDir,
     version: pullResult.version,
-    sizeBefore,
-    sizeAfter,
-    isNewFile,
+    sizeBefore: applied.agentSizeBefore,
+    sizeAfter: applied.agentSizeAfter,
+    isNewFile: applied.isNewAgentFile,
     gitignoreUpdated,
-    cacheHit
+    cacheHit,
+    docIndexFile: applied.docIndexFile,
+    docIndexSizeBefore: applied.docIndexSizeBefore,
+    docIndexSizeAfter: applied.docIndexSizeAfter
   };
 }
 
@@ -1828,6 +2022,18 @@ function createLocalProvider(options) {
     instruction: options.instruction || `IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any ${options.displayName} tasks.`
   };
 }
+function createUrlProvider(options) {
+  return {
+    name: options.name,
+    displayName: options.displayName,
+    repo: "",
+    docsPath: "",
+    extensions: options.extensions || [".md"],
+    excludePatterns: options.excludePatterns || [],
+    instruction: options.instruction || `IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any ${options.displayName} tasks.`,
+    urlConfig: options.urlConfig
+  };
+}
 // src/lib/providers/sveltekit.ts
 import fs21 from "fs";
 import path21 from "path";
@@ -2444,6 +2650,20 @@ import fs25 from "fs";
 import path25 from "path";
 var DOCS_MARKER_REGEX = /<!-- AGENTS-MD-EMBED-START:(\S+?) -->/g;
 var SKILLS_START_MARKER2 = "<!-- AGENTS-MD-SKILLS-START -->";
+var DOC_INDEX_FILE = "DOCINDEX.md";
+function readDocIndexMarkers(cwd) {
+  const docIndexPath = path25.join(cwd, DOC_INDEX_FILE);
+  const names = new Set;
+  if (!fs25.existsSync(docIndexPath))
+    return names;
+  const content = fs25.readFileSync(docIndexPath, "utf-8");
+  const regex = new RegExp(DOCS_MARKER_REGEX.source, "g");
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    names.add(match[1]);
+  }
+  return names;
+}
 function getDefaultStatusTargets(cwd) {
   const targets = [
     getDefaultOutput(cwd),
@@ -2474,16 +2694,21 @@ function createStatusReport(options) {
   const lockfile = readIndexLockfile(cwd);
   const scannedFiles = options.targetFile ? [options.targetFile] : getScannedFiles(cwd, lockfile);
   const markers = scannedFiles.flatMap((targetFile) => readEmbeddedMarkers(cwd, targetFile));
+  const docIndexMarkers = readDocIndexMarkers(cwd);
   const indexes = [];
   const seenMarkers = new Set;
+  const trackedDocsMarkers = new Set;
   for (const entry of lockfile.indexes) {
     if (options.targetFile && entry.targetFile !== options.targetFile)
       continue;
     const markerKey = getMarkerKey(entry.kind, entry.marker, entry.targetFile);
-    const marker = markers.find((candidate) => candidate.kind === entry.kind && candidate.marker === entry.marker && candidate.targetFile === entry.targetFile);
-    if (marker)
+    const markerInFile = markers.find((candidate) => candidate.kind === entry.kind && candidate.marker === entry.marker && candidate.targetFile === entry.targetFile);
+    const hasMarker = entry.kind === "docs" ? Boolean(markerInFile) || docIndexMarkers.has(entry.marker) : Boolean(markerInFile);
+    if (markerInFile)
       seenMarkers.add(markerKey);
-    indexes.push(analyzeLockfileEntry(cwd, entry, Boolean(marker)));
+    if (entry.kind === "docs")
+      trackedDocsMarkers.add(entry.marker);
+    indexes.push(analyzeLockfileEntry(cwd, entry, hasMarker));
   }
   for (const marker of markers) {
     const markerKey = getMarkerKey(marker.kind, marker.marker, marker.targetFile);
@@ -2498,6 +2723,18 @@ function createStatusReport(options) {
       suggestedAction: "Run `agdex migrate` or rerun the embed command to create a lockfile entry."
     });
   }
+  for (const name of docIndexMarkers) {
+    if (trackedDocsMarkers.has(name))
+      continue;
+    indexes.push({
+      id: `untracked:docs:${name}:${DOC_INDEX_FILE}`,
+      kind: "docs",
+      health: "untracked-marker",
+      targetFile: DOC_INDEX_FILE,
+      marker: name,
+      suggestedAction: "Run `agdex migrate` or rerun the embed command to create a lockfile entry."
+    });
+  }
   return {
     cwd,
     lockfilePath: path25.join(cwd, ".agdex", "agdex.lock"),
@@ -2555,4 +2792,4 @@ function getMarkerKey(kind, marker, targetFile) {
   return `${kind}:${marker}:${targetFile}`;
 }
 
-export { getLockfilePath, createIndexId, readIndexLockfile, writeIndexLockfile, upsertIndexLockEntry, pullDocs, collectDocFiles, buildDocTree, generateIndex, hasExistingIndex, getEmbeddedProviders, removeDocsIndex, injectIndex, ensureGitignoreEntry, getGlobalCacheDir, getLocalCacheDir, embed, nextjsProvider, reactProvider, pixiProvider, rattlerBuildProvider, tauriProvider, condaForgeProvider, bunProvider, svelteProvider, tailwindProvider, ruffProvider, tyProvider, basedpyrightProvider, convexProvider, polarsProvider, deltaRsProvider, obsidianProvider, obsidianExcalidrawProvider, ffmpegProvider, manimProvider, tensorrtProvider, createProvider, createLocalProvider, getProvider, listProviders, isProviderAvailable, fetchSkillsShSearch, getEnabledPluginSources, parseSkillFrontmatter, discoverPluginSkills, discoverFlatSkills, discoverSkillsShRepo, collectAllSkills, generateSkillsIndex, hasExistingSkillsIndex, removeSkillsIndex, injectSkillsIndex, getDefaultSkillSources, embedSkills, loadConfig, getDefaultOutput, getDefaultStatusTargets, readEmbeddedMarkers, createStatusReport };
+export { getLockfilePath, createIndexId, readIndexLockfile, writeIndexLockfile, upsertIndexLockEntry, removeIndexLockEntries, DEFAULT_DOC_INDEX_FILE, pullDocs, collectDocFiles, buildDocTree, generateIndex, hasExistingIndex, getEmbeddedProviders, removeDocsIndex, injectIndex, getDocIndexEntries, generateDocIndexSummary, hasDocIndexSummary, injectDocIndexSummary, removeDocIndexSummary, applyDocIndex, removeDocIndexEntry, ensureGitignoreEntry, getGlobalCacheDir, getLocalCacheDir, embed, nextjsProvider, reactProvider, pixiProvider, rattlerBuildProvider, tauriProvider, condaForgeProvider, bunProvider, svelteProvider, tailwindProvider, ruffProvider, tyProvider, basedpyrightProvider, convexProvider, polarsProvider, deltaRsProvider, obsidianProvider, obsidianExcalidrawProvider, ffmpegProvider, manimProvider, tensorrtProvider, createProvider, createLocalProvider, createUrlProvider, getProvider, listProviders, isProviderAvailable, fetchSkillsShSearch, getEnabledPluginSources, parseSkillFrontmatter, discoverPluginSkills, discoverFlatSkills, discoverSkillsShRepo, collectAllSkills, generateSkillsIndex, hasExistingSkillsIndex, removeSkillsIndex, injectSkillsIndex, getDefaultSkillSources, embedSkills, loadConfig, getDefaultOutput, readDocIndexMarkers, getDefaultStatusTargets, readEmbeddedMarkers, createStatusReport };

package/dist/index.d.ts

@@ -35,16 +35,16 @@
  * })
  * ```
  */
-export { embed, pullDocs, collectDocFiles, buildDocTree, generateIndex, injectIndex, hasExistingIndex, removeDocsIndex, getEmbeddedProviders, ensureGitignoreEntry, getGlobalCacheDir, getLocalCacheDir, } from './lib/agents-md';
+export { embed, pullDocs, collectDocFiles, buildDocTree, generateIndex, injectIndex, hasExistingIndex, removeDocsIndex, getEmbeddedProviders, ensureGitignoreEntry, getGlobalCacheDir, getLocalCacheDir, DEFAULT_DOC_INDEX_FILE, getDocIndexEntries, generateDocIndexSummary, hasDocIndexSummary, injectDocIndexSummary, removeDocIndexSummary, applyDocIndex, removeDocIndexEntry, } from './lib/agents-md';
 export { nextjsProvider, reactProvider, pixiProvider, rattlerBuildProvider, tauriProvider, condaForgeProvider, bunProvider, tensorrtProvider, createProvider, createLocalProvider, createUrlProvider, getProvider, listProviders, isProviderAvailable, } from './lib/providers';
 export { pullDocsFromUrl } from './lib/url-scraper';
 export { embedSkills, collectAllSkills, parseSkillFrontmatter, discoverPluginSkills, discoverFlatSkills, generateSkillsIndex, injectSkillsIndex, hasExistingSkillsIndex, removeSkillsIndex, getDefaultSkillSources, getEnabledPluginSources, } from './lib/skills';
 export { loadConfig, getDefaultOutput } from './lib/config';
 export type { AgdexConfig } from './lib/config';
-export { createIndexId, getLockfilePath, readIndexLockfile, writeIndexLockfile, upsertIndexLockEntry, } from './lib/lockfile';
-export { createStatusReport, getDefaultStatusTargets, readEmbeddedMarkers, } from './lib/index-maintenance';
+export { createIndexId, getLockfilePath, readIndexLockfile, writeIndexLockfile, upsertIndexLockEntry, removeIndexLockEntries, } from './lib/lockfile';
+export { createStatusReport, getDefaultStatusTargets, readEmbeddedMarkers, readDocIndexMarkers, } from './lib/index-maintenance';
 export type { IndexLockEntry, IndexLockSource, IndexLockfile, IndexSourceType, } from './lib/lockfile';
 export type { EmbeddedMarker, IndexHealth, IndexStatus, StatusOptions, StatusReport, } from './lib/index-maintenance';
-export type { DocProvider, DocFile, DocSection, VersionResult, PullResult, GitignoreStatus, IndexOptions, EmbedOptions, EmbedResult, ProviderPreset, UrlDocConfig, SkillFrontmatter, SkillEntry, SkillSource, SkillSourceConfig, SkillsEmbedOptions, SkillsEmbedResult, } from './lib/types';
+export type { DocProvider, DocFile, DocSection, DocIndexEntry, VersionResult, PullResult, GitignoreStatus, IndexOptions, EmbedOptions, EmbedResult, ProviderPreset, UrlDocConfig, SkillFrontmatter, SkillEntry, SkillSource, SkillSourceConfig, SkillsEmbedOptions, SkillsEmbedResult, } from './lib/types';
 export type { GenericProviderOptions } from './lib/providers/generic';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,EACL,KAAK,EACL,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGnD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/C,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,yBAAyB,CAAA;AAGhC,YAAY,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,aAAa,EACb,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAGH,OAAO,EACL,KAAK,EACL,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAEhB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGnD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/C,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,yBAAyB,CAAA;AAGhC,YAAY,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -1,4 +1,6 @@
 import {
+  DEFAULT_DOC_INDEX_FILE,
+  applyDocIndex,
   buildDocTree,
   bunProvider,
   collectAllSkills,
@@ -8,24 +10,29 @@ import {
   createLocalProvider,
   createProvider,
   createStatusReport,
+  createUrlProvider,
   discoverFlatSkills,
   discoverPluginSkills,
   embed,
   embedSkills,
   ensureGitignoreEntry,
+  generateDocIndexSummary,
   generateIndex,
   generateSkillsIndex,
   getDefaultOutput,
   getDefaultSkillSources,
   getDefaultStatusTargets,
+  getDocIndexEntries,
   getEmbeddedProviders,
   getEnabledPluginSources,
   getGlobalCacheDir,
   getLocalCacheDir,
   getLockfilePath,
   getProvider,
+  hasDocIndexSummary,
   hasExistingIndex,
   hasExistingSkillsIndex,
+  injectDocIndexSummary,
   injectIndex,
   injectSkillsIndex,
   isProviderAvailable,
@@ -37,28 +44,36 @@ import {
   pullDocs,
   rattlerBuildProvider,
   reactProvider,
+  readDocIndexMarkers,
   readEmbeddedMarkers,
   readIndexLockfile,
+  removeDocIndexEntry,
+  removeDocIndexSummary,
   removeDocsIndex,
+  removeIndexLockEntries,
   removeSkillsIndex,
   tauriProvider,
   tensorrtProvider,
   upsertIndexLockEntry,
   writeIndexLockfile
-} from "./index-38fpcrpr.js";
+} from "./index-xbmyce2p.js";
 import {
-  createUrlProvider,
   pullDocsFromUrl
-} from "./url-scraper-fme0jdje.js";
+} from "./index-az2g46dy.js";
+import"./index-pyanjjwn.js";
 export {
   writeIndexLockfile,
   upsertIndexLockEntry,
   tensorrtProvider,
   tauriProvider,
   removeSkillsIndex,
+  removeIndexLockEntries,
   removeDocsIndex,
+  removeDocIndexSummary,
+  removeDocIndexEntry,
   readIndexLockfile,
   readEmbeddedMarkers,
+  readDocIndexMarkers,
   reactProvider,
   rattlerBuildProvider,
   pullDocsFromUrl,
@@ -71,19 +86,23 @@ export {
   isProviderAvailable,
   injectSkillsIndex,
   injectIndex,
+  injectDocIndexSummary,
   hasExistingSkillsIndex,
   hasExistingIndex,
+  hasDocIndexSummary,
   getProvider,
   getLockfilePath,
   getLocalCacheDir,
   getGlobalCacheDir,
   getEnabledPluginSources,
   getEmbeddedProviders,
+  getDocIndexEntries,
   getDefaultStatusTargets,
   getDefaultSkillSources,
   getDefaultOutput,
   generateSkillsIndex,
   generateIndex,
+  generateDocIndexSummary,
   ensureGitignoreEntry,
   embedSkills,
   embed,
@@ -98,5 +117,7 @@ export {
   collectDocFiles,
   collectAllSkills,
   bunProvider,
-  buildDocTree
+  buildDocTree,
+  applyDocIndex,
+  DEFAULT_DOC_INDEX_FILE
 };

package/dist/lib/agents-md.d.ts

@@ -1,4 +1,6 @@
-import type { DocProvider, DocFile, DocSection, PullResult, GitignoreStatus, IndexOptions, EmbedOptions, EmbedResult } from './types';
+import type { DocProvider, DocFile, DocSection, DocIndexEntry, PullResult, GitignoreStatus, IndexOptions, EmbedOptions, EmbedResult } from './types';
+/** Default file the full docs index is written to (progressive disclosure). */
+export declare const DEFAULT_DOC_INDEX_FILE = "DOCINDEX.md";
 /**
  * Pull documentation from a GitHub repository or URL
  */
@@ -45,6 +47,79 @@ export declare function removeDocsIndex(content: string, providerName?: string):
  * If providerName specified, only replaces that provider's index (or appends if not present)
  */
 export declare function injectIndex(existingContent: string, indexContent: string, providerName?: string): string;
+/**
+ * Parse the documentation indices present in a DOCINDEX.md file.
+ *
+ * Each index is wrapped in AGENTS-MD-EMBED-START/END markers and begins with a
+ * `[<displayName> Docs Index]` header. Returns the marker name plus a readable
+ * display name for each index, in document order.
+ */
+export declare function getDocIndexEntries(content: string): DocIndexEntry[];
+/**
+ * Generate the progressive-disclosure summary section that lives in
+ * AGENTS.md/CLAUDE.md. It points agents at the full index file and lists the
+ * documentation indices currently available there.
+ */
+export declare function generateDocIndexSummary(entries: DocIndexEntry[], docIndexFile?: string): string;
+/**
+ * Check whether content already contains the Document Indices summary section
+ */
+export declare function hasDocIndexSummary(content: string): boolean;
+/**
+ * Inject (or replace) the Document Indices summary section in AGENTS.md/CLAUDE.md
+ */
+export declare function injectDocIndexSummary(existingContent: string, summaryContent: string): string;
+/**
+ * Remove the Document Indices summary section from content
+ */
+export declare function removeDocIndexSummary(content: string): string;
+export interface ApplyDocIndexResult {
+    docIndexFile: string;
+    docIndexPath: string;
+    agentFile: string;
+    agentPath: string;
+    isNewAgentFile: boolean;
+    agentSizeBefore: number;
+    agentSizeAfter: number;
+    docIndexSizeBefore: number;
+    docIndexSizeAfter: number;
+    entries: DocIndexEntry[];
+}
+/**
+ * Apply a generated index using the progressive-disclosure strategy:
+ *   1. Write/replace the full index block in DOCINDEX.md (keyed by providerName)
+ *   2. Refresh the "## Document Indices" summary section in the agent file
+ *      (AGENTS.md/CLAUDE.md) so it lists every index currently in DOCINDEX.md.
+ */
+export declare function applyDocIndex(options: {
+    cwd: string;
+    agentFile: string;
+    providerName: string;
+    indexContent: string;
+    docIndexFile?: string;
+}): ApplyDocIndexResult;
+export interface RemoveDocIndexResult {
+    removed: boolean;
+    removedProviders: string[];
+    docIndexFile: string;
+    docIndexDeleted: boolean;
+    agentFile: string;
+    agentSizeBefore: number;
+    agentSizeAfter: number;
+    docIndexSizeBefore: number;
+    docIndexSizeAfter: number;
+}
+/**
+ * Remove one (or all) documentation indices from DOCINDEX.md and refresh the
+ * summary section in the agent file. If no indices remain, DOCINDEX.md is
+ * deleted and the summary section is removed from the agent file.
+ */
+export declare function removeDocIndexEntry(options: {
+    cwd: string;
+    agentFile: string;
+    providerName?: string;
+    docIndexFile?: string;
+}): RemoveDocIndexResult;
 /**
  * Ensure .gitignore has entry for docs directory
  */
@@ -61,5 +136,5 @@ export declare function getLocalCacheDir(cwd: string): string;
  * High-level function to embed documentation into an agent instruction file.
  */
 export declare function embed(options: EmbedOptions): Promise<EmbedResult>;
-export type { DocProvider, DocFile, DocSection, PullResult, GitignoreStatus, IndexOptions, EmbedOptions, EmbedResult, } from './types';
+export type { DocProvider, DocFile, DocSection, DocIndexEntry, PullResult, GitignoreStatus, IndexOptions, EmbedOptions, EmbedResult, } from './types';
 //# sourceMappingURL=agents-md.d.ts.map

package/dist/lib/agents-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/lib/agents-md.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAA;AAmBhB;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAChI,OAAO,CAAC,UAAU,CAAC,CA0DrB;AAiDD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9D,OAAO,EAAE,CA4CX;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CA8E3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAkC3D;AAkCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAMhF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAkD9E;AAWD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBxG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAuBlF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAyJvE;AAGD,YAAY,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA"}
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/lib/agents-md.ts"],"names":[],"mappings":"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"}

package/dist/lib/index-maintenance.d.ts

@@ -1,4 +1,10 @@
 import { type IndexLockEntry } from './lockfile';
+/**
+ * Read the docs marker names present in DOCINDEX.md. Under progressive
+ * disclosure the full per-provider index blocks live here rather than inline
+ * in the agent instruction file.
+ */
+export declare function readDocIndexMarkers(cwd: string): Set<string>;
 export type IndexHealth = 'ok' | 'missing-target' | 'missing-marker' | 'missing-cache' | 'stale-lockfile-entry' | 'untracked-marker' | 'needs-migration';
 export interface EmbeddedMarker {
     kind: 'docs' | 'skills';

package/dist/lib/index-maintenance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-maintenance.d.ts","sourceRoot":"","sources":["../../src/lib/index-maintenance.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,YAAY,CAAA;AAKnB,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,sBAAsB,GACtB,kBAAkB,GAClB,iBAAiB,CAAA;AAErB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,MAAM,EAAE,WAAW,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,cAAc,CAAA;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAU7D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CAiBrF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CA8CvE"}
+{"version":3,"file":"index-maintenance.d.ts","sourceRoot":"","sources":["../../src/lib/index-maintenance.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,YAAY,CAAA;AAWnB;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAY5D;AAED,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,sBAAsB,GACtB,kBAAkB,GAClB,iBAAiB,CAAA;AAErB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,MAAM,EAAE,WAAW,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,cAAc,CAAA;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,EAAE,WAAW,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAU7D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CAiBrF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAuEvE"}

package/dist/lib/lockfile.d.ts

@@ -33,4 +33,13 @@ export declare function resolveStoredPath(cwd: string, storedPath: string): stri
 export declare function readIndexLockfile(cwd: string): IndexLockfile;
 export declare function writeIndexLockfile(cwd: string, lockfile: IndexLockfile): void;
 export declare function upsertIndexLockEntry(cwd: string, entry: Omit<IndexLockEntry, 'updatedAt'>): IndexLockEntry;
+/**
+ * Remove lockfile entries matching the given criteria. Returns the ids removed.
+ * Omitting a field treats it as a wildcard for that field.
+ */
+export declare function removeIndexLockEntries(cwd: string, criteria: {
+    kind?: 'docs' | 'skills';
+    marker?: string;
+    targetFile?: string;
+}): string[];
 //# sourceMappingURL=lockfile.d.ts.map