agdex 0.8.1 → 0.9.0

package/README.md

@@ -11,10 +11,30 @@ AI coding agents rely on training data that becomes outdated. When agents don't
 1. Downloads version-matched documentation from GitHub
 2. Creates a compressed index (~8KB for Next.js)
 3. Stores the docs in local `.agdex/` cache
-4. Embeds an index in your local agent instruction file
-5. Agents can then retrieve specific docs on demand
+4. Writes the full index to a dedicated `DOCINDEX.md` file
+5. Adds a small **Document Indices** pointer section to your local agent instruction file (`AGENTS.md` / `CLAUDE.md`)
+6. Agents can then retrieve specific docs on demand
 
-The key instruction embedded tells agents to **prefer retrieval-led reasoning over pre-training-led reasoning**.
+The key instruction tells agents to **prefer retrieval-led reasoning over pre-training-led reasoning**.
+
+### Progressive disclosure
+
+To keep your `AGENTS.md` / `CLAUDE.md` lean, agdex uses a progressive disclosure
+strategy. The full (potentially large) per-provider indexes live in `DOCINDEX.md`,
+while your agent file only gets a compact pointer section that is regenerated
+every time an index is added or removed:
+
+```markdown
+## Document Indices
+
+IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any of the docs found in DOCINDEX.md .
+
+- NVIDIA TensorRT (`tensorrt`)
+- Bun (`bun`)
+```
+
+Agents read this list, then open `DOCINDEX.md` only when they need the detailed
+file index for a specific library.
 
 ## Installation
 
@@ -281,7 +301,7 @@ import {
   collectDocFiles,
   buildDocTree,
   generateIndex,
-  injectIndex
+  applyDocIndex
 } from 'agdex'
 
 // Collect doc files
@@ -300,8 +320,15 @@ const index = generateIndex({
   instruction: 'Use retrieval-led reasoning.'
 })
 
-// Inject into existing content
-const newContent = injectIndex(existingContent, index)
+// Progressive disclosure: write the full index to DOCINDEX.md and refresh
+// the "## Document Indices" summary section in the agent file.
+applyDocIndex({
+  cwd: process.cwd(),
+  agentFile: 'CLAUDE.md',
+  providerName: 'my-docs',
+  indexContent: index,
+  // docIndexFile defaults to DOCINDEX.md
+})
 ```
 
 ## Output Format
@@ -351,8 +378,9 @@ This format:
 2. **Download**: Uses git sparse-checkout to fetch only docs folder
 3. **Index**: Builds a tree of all doc files
 4. **Compress**: Generates pipe-delimited format
-5. **Inject**: Adds to AGENTS.md with markers for updates
-6. **Gitignore**: Adds docs directory to .gitignore
+5. **Write index**: Writes/updates the full index in `DOCINDEX.md` (one marked block per provider)
+6. **Summarize**: Refreshes the `## Document Indices` pointer section in `AGENTS.md` / `CLAUDE.md` with the current list of indices
+7. **Gitignore**: Adds docs directory to .gitignore
 
 ## Contributing
 

package/dist/cli/index.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 import {
+  DEFAULT_DOC_INDEX_FILE,
+  applyDocIndex,
   basedpyrightProvider,
   buildDocTree,
   bunProvider,
@@ -20,11 +22,9 @@ import {
   generateSkillsIndex,
   getDefaultOutput,
   getDefaultSkillSources,
-  getEmbeddedProviders,
+  getDocIndexEntries,
   getProvider,
-  hasExistingIndex,
   hasExistingSkillsIndex,
-  injectIndex,
   injectSkillsIndex,
   isProviderAvailable,
   listProviders,
@@ -36,7 +36,8 @@ import {
   polarsProvider,
   rattlerBuildProvider,
   readIndexLockfile,
-  removeDocsIndex,
+  removeDocIndexEntry,
+  removeIndexLockEntries,
   removeSkillsIndex,
   ruffProvider,
   svelteProvider,
@@ -44,7 +45,7 @@ import {
   tauriProvider,
   tyProvider,
   upsertIndexLockEntry
-} from "../index-9k6cxm1y.js";
+} from "../index-xbmyce2p.js";
 import {
   __commonJS,
   __require,
@@ -2114,7 +2115,7 @@ var require_clear = __commonJS((exports, module) => {
         if (it)
           o = it;
         var i = 0;
-        var F = function F() {};
+        var F = function F2() {};
         return { s: F, n: function n() {
           if (i >= o.length)
             return { done: true };
@@ -4446,7 +4447,7 @@ var require_dist = __commonJS((exports, module) => {
         if (it)
           o = it;
         var i = 0;
-        var F = function F() {};
+        var F = function F2() {};
         return { s: F, n: function n() {
           if (i >= o.length)
             return { done: true };
@@ -4549,7 +4550,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           }
           return question2.format ? yield question2.format(answer2, answers) : answer2;
         });
-        return function getFormattedAnswer(_x, _x2) {
+        return function getFormattedAnswer2(_x, _x2) {
           return _ref.apply(this, arguments);
         };
       }();
@@ -7160,9 +7161,13 @@ Embedding ${import_picocolors2.default.cyan(provider.displayName)} ${import_pico
   } else {
     console.log(`${import_picocolors2.default.green("✓")} Downloaded docs to ${import_picocolors2.default.bold(result.docsPath)}`);
   }
+  if (result.docIndexFile) {
+    const docSizeInfo = result.docIndexSizeBefore === 0 ? formatSize(result.docIndexSizeAfter) : `${formatSize(result.docIndexSizeBefore)} → ${formatSize(result.docIndexSizeAfter)}`;
+    console.log(`${import_picocolors2.default.green("✓")} Wrote index to ${import_picocolors2.default.bold(result.docIndexFile)} (${docSizeInfo})`);
+  }
   const action = result.isNewFile ? "Created" : "Updated";
   const sizeInfo = result.isNewFile ? formatSize(result.sizeAfter) : `${formatSize(result.sizeBefore)} → ${formatSize(result.sizeAfter)}`;
-  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(result.targetFile)} (${sizeInfo})`);
+  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(result.targetFile)} summary (${sizeInfo})`);
   if (result.gitignoreUpdated) {
     console.log(`${import_picocolors2.default.green("✓")} Added ${import_picocolors2.default.bold(".agdex")} to .gitignore`);
   }
@@ -7555,15 +7560,6 @@ async function runLocal(docsPath, options) {
   const extensions = options.extensions?.split(",") || [".md", ".mdx"];
   console.log(`
 Building index from ${import_picocolors2.default.cyan(docsPath)}...`);
-  const targetPath = path.join(cwd, output);
-  let existingContent = "";
-  let sizeBefore = 0;
-  let isNewFile = true;
-  if (fs.existsSync(targetPath)) {
-    existingContent = fs.readFileSync(targetPath, "utf-8");
-    sizeBefore = Buffer.byteLength(existingContent, "utf-8");
-    isNewFile = false;
-  }
   const docFiles = collectDocFiles(absoluteDocsPath, { extensions });
   const sections = buildDocTree(docFiles);
   const indexContent = generateIndex({
@@ -7575,9 +7571,7 @@ Building index from ${import_picocolors2.default.cyan(docsPath)}...`);
     regenerateCommand: `npx agdex local ${docsPath} --name "${name}" --output ${output}`
   });
   const providerName = name.toLowerCase().replace(/\s+/g, "-");
-  const newContent = injectIndex(existingContent, indexContent, providerName);
-  fs.writeFileSync(targetPath, newContent, "utf-8");
-  const sizeAfter = Buffer.byteLength(newContent, "utf-8");
+  const applied = applyDocIndex({ cwd, agentFile: output, providerName, indexContent });
   upsertIndexLockEntry(cwd, {
     id: createIndexId("docs", providerName, output),
     kind: "docs",
@@ -7593,14 +7587,19 @@ Building index from ${import_picocolors2.default.cyan(docsPath)}...`);
     cachePath: absoluteDocsPath,
     command: `npx agdex local ${docsPath} --name "${name}" --output ${output}`
   });
-  const action = isNewFile ? "Created" : "Updated";
-  const sizeInfo = isNewFile ? formatSize(sizeAfter) : `${formatSize(sizeBefore)} → ${formatSize(sizeAfter)}`;
-  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(output)} (${sizeInfo})`);
+  printApplyResult(applied);
+}
+function printApplyResult(applied) {
+  const docSizeInfo = applied.docIndexSizeBefore === 0 ? formatSize(applied.docIndexSizeAfter) : `${formatSize(applied.docIndexSizeBefore)} → ${formatSize(applied.docIndexSizeAfter)}`;
+  console.log(`${import_picocolors2.default.green("✓")} Wrote index to ${import_picocolors2.default.bold(applied.docIndexFile)} (${docSizeInfo})`);
+  const action = applied.isNewAgentFile ? "Created" : "Updated";
+  const sizeInfo = applied.isNewAgentFile ? formatSize(applied.agentSizeAfter) : `${formatSize(applied.agentSizeBefore)} → ${formatSize(applied.agentSizeAfter)}`;
+  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(applied.agentFile)} summary (${sizeInfo})`);
   console.log("");
 }
 async function runUrl(url, options) {
   const cwd = process.cwd();
-  const { pullDocsFromUrl } = await import("../url-scraper-axfs3dz7.js");
+  const { pullDocsFromUrl } = await import("../url-scraper-9bqyj00r.js");
   const name = options.name || new URL(url).hostname.replace(/^docs\./, "").replace(/\.\w+$/, "");
   const providerName = name.toLowerCase().replace(/\s+/g, "-");
   const output = options.output || getDefaultOutput();
@@ -7634,15 +7633,6 @@ Failed: ${pullResult.error}`));
     console.log(`
 ${import_picocolors2.default.green("✓")} Downloaded docs to ${import_picocolors2.default.bold(docsPath)}`);
   }
-  const targetPath = path.join(cwd, output);
-  let existingContent = "";
-  let sizeBefore = 0;
-  let isNewFile = true;
-  if (fs.existsSync(targetPath)) {
-    existingContent = fs.readFileSync(targetPath, "utf-8");
-    sizeBefore = Buffer.byteLength(existingContent, "utf-8");
-    isNewFile = false;
-  }
   const docFiles = collectDocFiles(docsPath, { extensions: [".md"] });
   const sections = buildDocTree(docFiles);
   const indexContent = generateIndex({
@@ -7653,9 +7643,7 @@ ${import_picocolors2.default.green("✓")} Downloaded docs to ${import_picocolor
     instruction: `IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any ${name} tasks.`,
     regenerateCommand: `npx agdex url "${url}" --name "${name}" --output ${output}${globalCache ? " --global" : ""}`
   });
-  const newContent = injectIndex(existingContent, indexContent, providerName);
-  fs.writeFileSync(targetPath, newContent, "utf-8");
-  const sizeAfter = Buffer.byteLength(newContent, "utf-8");
+  const applied = applyDocIndex({ cwd, agentFile: output, providerName, indexContent });
   upsertIndexLockEntry(cwd, {
     id: createIndexId("docs", providerName, output),
     kind: "docs",
@@ -7672,16 +7660,13 @@ ${import_picocolors2.default.green("✓")} Downloaded docs to ${import_picocolor
     cachePath: docsPath,
     command: `npx agdex url "${url}" --name "${name}" --output ${output}${globalCache ? " --global" : ""}`
   });
-  const action = isNewFile ? "Created" : "Updated";
-  const sizeInfo = isNewFile ? formatSize(sizeAfter) : `${formatSize(sizeBefore)} → ${formatSize(sizeAfter)}`;
-  console.log(`${import_picocolors2.default.green("✓")} ${action} ${import_picocolors2.default.bold(output)} (${sizeInfo})`);
   if (!globalCache) {
     const gitignoreResult = ensureGitignoreEntry(cwd, ".agdex");
     if (gitignoreResult.updated) {
       console.log(`${import_picocolors2.default.green("✓")} Added ${import_picocolors2.default.bold(".agdex")} to .gitignore`);
     }
   }
-  console.log("");
+  printApplyResult(applied);
 }
 function runList() {
   console.log(import_picocolors2.default.cyan(`
@@ -7914,29 +7899,33 @@ agdex migrate
   console.log("");
 }
 program2.command("migrate").description("Create lockfile entries from existing embedded markers when safe").option("-o, --output <file>", "Migrate one agent instruction file").option("--json", "Print machine-readable JSON").action(runMigrate);
+function removeSkillsFromAgentFile(targetPath) {
+  const content = fs.existsSync(targetPath) ? fs.readFileSync(targetPath, "utf-8") : "";
+  if (!hasExistingSkillsIndex(content))
+    return false;
+  fs.writeFileSync(targetPath, removeSkillsIndex(content), "utf-8");
+  return true;
+}
 async function runRemove(options) {
   const cwd = process.cwd();
   const output = options.output || getDefaultOutput();
   const targetPath = path.join(cwd, output);
-  if (!fs.existsSync(targetPath)) {
-    console.error(import_picocolors2.default.red(`File not found: ${output}`));
-    process.exit(1);
-  }
-  let content = fs.readFileSync(targetPath, "utf-8");
-  const sizeBefore = Buffer.byteLength(content, "utf-8");
+  const docIndexPath = path.join(cwd, DEFAULT_DOC_INDEX_FILE);
+  const agentContent = fs.existsSync(targetPath) ? fs.readFileSync(targetPath, "utf-8") : "";
+  const docIndexContent = fs.existsSync(docIndexPath) ? fs.readFileSync(docIndexPath, "utf-8") : "";
   const hasExplicitFlags = options.docs || options.skills || options.provider;
   if (!hasExplicitFlags) {
-    const embeddedProviders = getEmbeddedProviders(content);
-    const hasSkills = hasExistingSkillsIndex(content);
-    if (embeddedProviders.length === 0 && !hasSkills) {
+    const docEntries = getDocIndexEntries(docIndexContent);
+    const hasSkills = hasExistingSkillsIndex(agentContent);
+    if (docEntries.length === 0 && !hasSkills) {
       console.log(import_picocolors2.default.yellow(`
 No indices found to remove.
 `));
       return;
     }
     const choices = [];
-    for (const provider of embeddedProviders) {
-      choices.push({ title: `docs: ${provider}`, value: `docs:${provider}` });
+    for (const entry of docEntries) {
+      choices.push({ title: `docs: ${entry.displayName} (${entry.name})`, value: `docs:${entry.name}` });
     }
     if (hasSkills) {
       choices.push({ title: "skills", value: "skills" });
@@ -7956,64 +7945,66 @@ No indices selected.
       return;
     }
     const selected = response.indices;
-    let docsRemoved2 = [];
+    const docsRemoved2 = [];
     let skillsRemoved2 = false;
     for (const item of selected) {
-      if (item === "skills") {
-        content = removeSkillsIndex(content);
-        skillsRemoved2 = true;
-      } else if (item.startsWith("docs:")) {
+      if (item.startsWith("docs:")) {
         const provider = item.slice(5);
-        content = removeDocsIndex(content, provider);
-        docsRemoved2.push(provider);
+        const res = removeDocIndexEntry({ cwd, agentFile: output, providerName: provider });
+        if (res.removed) {
+          docsRemoved2.push(...res.removedProviders);
+          for (const removedProvider of res.removedProviders) {
+            removeIndexLockEntries(cwd, { kind: "docs", marker: removedProvider });
+          }
+        }
       }
     }
-    fs.writeFileSync(targetPath, content, "utf-8");
-    const sizeAfter2 = Buffer.byteLength(content, "utf-8");
-    console.log("");
-    for (const provider of docsRemoved2) {
-      console.log(`${import_picocolors2.default.green("✓")} Removed docs index (${provider}) from ${import_picocolors2.default.bold(output)}`);
-    }
-    if (skillsRemoved2) {
-      console.log(`${import_picocolors2.default.green("✓")} Removed skills index from ${import_picocolors2.default.bold(output)}`);
+    if (selected.includes("skills")) {
+      skillsRemoved2 = removeSkillsFromAgentFile(targetPath);
+      if (skillsRemoved2)
+        removeIndexLockEntries(cwd, { kind: "skills", targetFile: output });
     }
-    console.log(import_picocolors2.default.gray(`  (${formatSize(sizeBefore)} → ${formatSize(sizeAfter2)})`));
-    console.log("");
+    printRemoveResult(docsRemoved2, skillsRemoved2, output);
     return;
   }
   const removeAll = !options.docs && !options.skills;
   const removeDocs = removeAll || options.docs;
   const removeSkillsIdx = removeAll || options.skills;
-  let docsRemoved = false;
+  const docsRemoved = [];
   let skillsRemoved = false;
-  if (removeDocs && hasExistingIndex(content, options.provider)) {
-    content = removeDocsIndex(content, options.provider);
-    docsRemoved = true;
+  if (removeDocs) {
+    const res = removeDocIndexEntry({ cwd, agentFile: output, providerName: options.provider });
+    if (res.removed) {
+      docsRemoved.push(...res.removedProviders);
+      for (const removedProvider of res.removedProviders) {
+        removeIndexLockEntries(cwd, { kind: "docs", marker: removedProvider });
+      }
+    }
   }
-  if (removeSkillsIdx && hasExistingSkillsIndex(content)) {
-    content = removeSkillsIndex(content);
-    skillsRemoved = true;
+  if (removeSkillsIdx) {
+    skillsRemoved = removeSkillsFromAgentFile(targetPath);
+    if (skillsRemoved)
+      removeIndexLockEntries(cwd, { kind: "skills", targetFile: output });
   }
-  if (!docsRemoved && !skillsRemoved) {
+  if (docsRemoved.length === 0 && !skillsRemoved) {
     console.log(import_picocolors2.default.yellow(`
 No indices found to remove.
 `));
     return;
   }
-  fs.writeFileSync(targetPath, content, "utf-8");
-  const sizeAfter = Buffer.byteLength(content, "utf-8");
+  printRemoveResult(docsRemoved, skillsRemoved, output);
+}
+function printRemoveResult(docsRemoved, skillsRemoved, output) {
   console.log("");
-  if (docsRemoved) {
-    const providerInfo = options.provider ? ` (${options.provider})` : " (all providers)";
-    console.log(`${import_picocolors2.default.green("✓")} Removed docs index${providerInfo} from ${import_picocolors2.default.bold(output)}`);
+  for (const provider of docsRemoved) {
+    console.log(`${import_picocolors2.default.green("✓")} Removed docs index (${provider}) from ${import_picocolors2.default.bold(DEFAULT_DOC_INDEX_FILE)}`);
   }
   if (skillsRemoved) {
     console.log(`${import_picocolors2.default.green("✓")} Removed skills index from ${import_picocolors2.default.bold(output)}`);
   }
-  console.log(import_picocolors2.default.gray(`  (${formatSize(sizeBefore)} → ${formatSize(sizeAfter)})`));
   console.log("");
 }
-program2.command("remove").description("Remove embedded indices from AGENTS.md/CLAUDE.md").option("-o, --output <file>", "Target file (default: from config or CLAUDE.local.md)").option("--docs", "Remove only docs index").option("--skills", "Remove only skills index").option("-p, --provider <name>", "Remove only a specific provider's docs index").action(runRemove);
+program2.command("remove").description("Remove docs indices from DOCINDEX.md (and skills indices from AGENTS.md/CLAUDE.md)").option("-o, --output <file>", "Target file (default: from config or CLAUDE.local.md)").option("--docs", "Remove only docs indices (from DOCINDEX.md)").option("--skills", "Remove only skills index").option("-p, --provider <name>", "Remove only a specific provider's docs index").action(runRemove);
 var skillsCommand = program2.command("skills").description("Manage Claude Code skills indexing");
 async function runSkillsEmbed(options) {
   const cwd = process.cwd();

package/dist/{url-scraper-axfs3dz7.js → index-az2g46dy.js}

@@ -10817,7 +10817,7 @@ var require_htmlelts = __commonJS((exports) => {
   var HTMLElement = exports.HTMLElement = define2({
     superclass: Element,
     name: "HTMLElement",
-    ctor: function HTMLElement(doc, localName, prefix) {
+    ctor: function HTMLElement2(doc, localName, prefix) {
       Element.call(this, doc, localName, utils.NAMESPACE.HTML, prefix);
     },
     props: {
@@ -10954,7 +10954,7 @@ var require_htmlelts = __commonJS((exports) => {
   });
   var HTMLUnknownElement = define2({
     name: "HTMLUnknownElement",
-    ctor: function HTMLUnknownElement(doc, localName, prefix) {
+    ctor: function HTMLUnknownElement2(doc, localName, prefix) {
       HTMLElement.call(this, doc, localName, prefix);
     }
   });
@@ -11169,7 +11169,7 @@ var require_htmlelts = __commonJS((exports) => {
   define2({
     tag: "form",
     name: "HTMLFormElement",
-    ctor: function HTMLFormElement(doc, localName, prefix) {
+    ctor: function HTMLFormElement2(doc, localName, prefix) {
       HTMLElement.call(this, doc, localName, prefix);
     },
     attributes: {
@@ -12226,7 +12226,7 @@ var require_svg = __commonJS((exports) => {
   var SVGElement = define2({
     superclass: Element,
     name: "SVGElement",
-    ctor: function SVGElement(doc, localName, prefix) {
+    ctor: function SVGElement2(doc, localName, prefix) {
       Element.call(this, doc, localName, utils.NAMESPACE.SVG, prefix);
     },
     props: {
@@ -12645,7 +12645,7 @@ var require_Document = __commonJS((exports, module) => {
     contentType: { get: function contentType() {
       return this._contentType;
     } },
-    URL: { get: function URL() {
+    URL: { get: function URL3() {
       return this._address;
     } },
     domain: { get: utils.nyi, set: utils.nyi },
@@ -16483,7 +16483,7 @@ var require_HTMLParser = __commonJS((exports, module) => {
       parser(EOF);
       doc.modclock = 1;
     }
-    var insertToken = htmlparser.insertToken = function insertToken(t, value, arg3, arg4) {
+    var insertToken = htmlparser.insertToken = function insertToken2(t, value, arg3, arg4) {
       flushText();
       var current = stack.top;
       if (!current || current.namespaceURI === NAMESPACE.HTML) {
@@ -22400,8 +22400,5 @@ async function pullDocsFromUrl(config, destDir, options) {
     };
   }
 }
-export {
-  pullDocsFromUrl
-};
 
 export { pullDocsFromUrl };

package/dist/{index-9k6cxm1y.js → index-xbmyce2p.js}

@@ -1,6 +1,5 @@
 import {
-  __require,
-  __toESM
+  __require
 } from "./index-pyanjjwn.js";
 
 // src/lib/lockfile.ts
@@ -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-axfs3dz7.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,68 @@ 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(`
+`) ? `
+` : `
+
+`;
+  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(`
 `) ? `
 ` : `
@@ -376,6 +457,120 @@ function injectIndex(existingContent, indexContent, providerName) {
   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
   };
 }
 
@@ -2456,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),
@@ -2486,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);
@@ -2510,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"),
@@ -2567,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, createUrlProvider, 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,
@@ -14,19 +16,23 @@ import {
   embed,
   embedSkills,
   ensureGitignoreEntry,
+  generateDocIndexSummary,
   generateIndex,
   generateSkillsIndex,
   getDefaultOutput,
   getDefaultSkillSources,
   getDefaultStatusTargets,
+  getDocIndexEntries,
   getEmbeddedProviders,
   getEnabledPluginSources,
   getGlobalCacheDir,
   getLocalCacheDir,
   getLockfilePath,
   getProvider,
+  hasDocIndexSummary,
   hasExistingIndex,
   hasExistingSkillsIndex,
+  injectDocIndexSummary,
   injectIndex,
   injectSkillsIndex,
   isProviderAvailable,
@@ -38,28 +44,36 @@ import {
   pullDocs,
   rattlerBuildProvider,
   reactProvider,
+  readDocIndexMarkers,
   readEmbeddedMarkers,
   readIndexLockfile,
+  removeDocIndexEntry,
+  removeDocIndexSummary,
   removeDocsIndex,
+  removeIndexLockEntries,
   removeSkillsIndex,
   tauriProvider,
   tensorrtProvider,
   upsertIndexLockEntry,
   writeIndexLockfile
-} from "./index-9k6cxm1y.js";
-import"./index-pyanjjwn.js";
+} from "./index-xbmyce2p.js";
 import {
   pullDocsFromUrl
-} from "./url-scraper-axfs3dz7.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,
@@ -72,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,
@@ -99,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

package/dist/lib/lockfile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../../src/lib/lockfile.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,IAAI,CAAA;AACxC,eAAO,MAAM,sBAAsB,QAAoC,CAAA;AAEvE,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,aAAa,GACb,YAAY,GACZ,UAAU,GACV,cAAc,GACd,WAAW,CAAA;AAEf,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAAA;CAC/D;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,MAAM,EAAE,eAAe,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErG;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAW5D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAQ7E;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,cAAc,CAkB1G"}
+{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../../src/lib/lockfile.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,IAAI,CAAA;AACxC,eAAO,MAAM,sBAAsB,QAAoC,CAAA;AAEvE,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,aAAa,GACb,YAAY,GACZ,UAAU,GACV,cAAc,GACd,WAAW,CAAA;AAEf,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAAA;CAC/D;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,MAAM,EAAE,eAAe,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErG;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAW5D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAQ7E;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,cAAc,CAkB1G;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E,MAAM,EAAE,CAsBV"}

package/dist/lib/types.d.ts

@@ -9,6 +9,16 @@ export interface DocSection {
     files: DocFile[];
     subsections: DocSection[];
 }
+/**
+ * A single documentation index present in DOCINDEX.md.
+ * Used to build the progressive-disclosure summary list in AGENTS.md/CLAUDE.md.
+ */
+export interface DocIndexEntry {
+    /** Marker/provider name (used by --provider and the embed markers) */
+    name: string;
+    /** Human-readable display name parsed from the index header */
+    displayName: string;
+}
 export interface VersionResult {
     version: string | null;
     error?: string;
@@ -107,6 +117,8 @@ export interface EmbedOptions {
     globalCache?: boolean;
     /** Additional user-provided description to include in the index */
     description?: string;
+    /** File the full docs index is written to (default: DOCINDEX.md) */
+    docIndexFile?: string;
 }
 export interface EmbedResult {
     success: boolean;
@@ -119,6 +131,12 @@ export interface EmbedResult {
     gitignoreUpdated?: boolean;
     cacheHit?: boolean;
     error?: string;
+    /** File the full docs index was written to (e.g. DOCINDEX.md) */
+    docIndexFile?: string;
+    /** Size of the doc index file before this embed */
+    docIndexSizeBefore?: number;
+    /** Size of the doc index file after this embed */
+    docIndexSizeAfter?: number;
 }
 export interface SkillFrontmatter {
     name: string;

package/dist/lib/types.d.ts.map

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

package/dist/url-scraper-9bqyj00r.js

@@ -0,0 +1,7 @@
+import {
+  pullDocsFromUrl
+} from "./index-az2g46dy.js";
+import"./index-pyanjjwn.js";
+export {
+  pullDocsFromUrl
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agdex",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Embed compressed documentation indexes into AGENTS.md/CLAUDE.md for AI coding agents",
   "module": "dist/index.js",
   "main": "dist/index.js",