@takazudo/zudo-doc 2.4.1 → 2.5.0

package/dist/integrations/claude-resources/generate.js

@@ -97,11 +97,14 @@ function downgradeRepoRelativeLinks(content) {
 function findClaudeMdFiles(dir, excludeDirs) {
   const results = [];
   if (!fs.existsSync(dir)) return results;
+  const excludes = excludeDirs.map(
+    (d) => d.endsWith(path.sep) ? d.slice(0, -path.sep.length) : d
+  );
   for (const item of fs.readdirSync(dir)) {
     if (item === "node_modules") continue;
     if (item.startsWith(".")) continue;
     const itemPath = path.join(dir, item);
-    if (excludeDirs.some((d) => itemPath.startsWith(d))) continue;
+    if (excludes.some((d) => itemPath === d || itemPath.startsWith(d + path.sep))) continue;
     let stat;
     try {
       stat = fs.lstatSync(itemPath);
@@ -109,7 +112,7 @@ function findClaudeMdFiles(dir, excludeDirs) {
       continue;
     }
     if (stat.isDirectory()) {
-      results.push(...findClaudeMdFiles(itemPath, excludeDirs));
+      results.push(...findClaudeMdFiles(itemPath, excludes));
     } else if (stat.isFile() && item === "CLAUDE.md") {
       results.push(itemPath);
     }

package/dist/integrations/claude-resources/index.d.ts

@@ -12,10 +12,27 @@ export interface ClaudeResourcesPluginOptions {
      */
     claudeDir: string;
     /**
-     * Project root used both as the search root for `CLAUDE.md` discovery
-     * and to anchor relative paths. Defaults to `process.cwd()`.
+     * Anchor for resolving the relative `claudeDir`, `docsDir`, and `scanRoot`
+     * paths, and the default value of `scanRoot`. Defaults to `process.cwd()`.
+     *
+     * Note: this does NOT itself decide where `CLAUDE.md` discovery walks — that
+     * is `scanRoot` (which defaults to this). Set `scanRoot` to widen discovery
+     * (e.g. a subdirectory doc site scanning its repo root) without moving the
+     * output base, which stays anchored here.
      */
     projectRoot?: string;
+    /**
+     * Root for `CLAUDE.md` discovery and the base for the generated pages'
+     * relative-path titles/slugs. Defaults to `projectRoot`. Resolved against
+     * `projectRoot` when relative (absolute allowed).
+     *
+     * Scope: governs `CLAUDE.md` discovery ONLY. Commands, skills, and agents
+     * always come from `claudeDir` and are unaffected by `scanRoot`. Decoupling
+     * this from `projectRoot` lets a doc site in a repo subdirectory scan
+     * repo-wide `CLAUDE.md` files while still writing generated pages into its
+     * own content collection (see #2558).
+     */
+    scanRoot?: string;
     /**
      * Output directory for generated MDX pages, resolved against
      * `projectRoot` when relative. Defaults to `src/content/docs` to

package/dist/integrations/claude-resources/index.js

@@ -12,9 +12,10 @@ function claudeResourcesPlugin(options) {
 function runClaudeResourcesPreStep(options) {
   const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
   const claudeDir = path.isAbsolute(options.claudeDir) ? options.claudeDir : path.resolve(projectRoot, options.claudeDir);
+  const scanRoot = options.scanRoot === void 0 ? projectRoot : path.isAbsolute(options.scanRoot) ? options.scanRoot : path.resolve(projectRoot, options.scanRoot);
   const docsDirInput = options.docsDir ?? "src/content/docs";
   const docsDir = path.isAbsolute(docsDirInput) ? docsDirInput : path.resolve(projectRoot, docsDirInput);
-  return generateClaudeResourcesDocs({ claudeDir, projectRoot, docsDir });
+  return generateClaudeResourcesDocs({ claudeDir, projectRoot: scanRoot, docsDir });
 }
 export {
   CLAUDE_RESOURCES_PLUGIN_NAME,

package/dist/plugins/claude-resources.js

@@ -10,10 +10,12 @@ const plugin = {
       );
     }
     const projectRootOpt = ctx.options["projectRoot"];
+    const scanRootOpt = ctx.options["scanRoot"];
     const docsDirOpt = ctx.options["docsDir"];
     const result = await runClaudeResourcesPreStep({
       claudeDir,
       projectRoot: typeof projectRootOpt === "string" ? projectRootOpt : ctx.projectRoot,
+      scanRoot: typeof scanRootOpt === "string" ? scanRootOpt : void 0,
       docsDir: typeof docsDirOpt === "string" ? docsDirOpt : "src/content/docs"
     });
     ctx.logger.info(

package/dist/preset.d.ts

@@ -50,6 +50,11 @@ export interface PresetVersionConfig {
 export interface PresetClaudeResourcesConfig {
     claudeDir: string;
     projectRoot?: string;
+    /**
+     * Root for `CLAUDE.md` discovery; defaults to `projectRoot`. Decouples
+     * repo-wide scanning from the output base for subdirectory doc sites (#2558).
+     */
+    scanRoot?: string;
 }
 /**
  * The subset of `settings` the preset reads. Any concrete `typeof settings`

package/dist/preset.js

@@ -171,6 +171,7 @@ function buildPlugins(settings, routeContext) {
         options: {
           claudeDir: settings.claudeResources.claudeDir,
           projectRoot: settings.claudeResources.projectRoot,
+          scanRoot: settings.claudeResources.scanRoot,
           docsDir: settings.docsDir
         }
       }

package/dist/settings.d.ts

@@ -301,6 +301,7 @@ export interface Settings {
     claudeResources: {
         claudeDir: string;
         projectRoot?: string;
+        scanRoot?: string;
     } | false;
     defaultLocaleOnlyPrefixes: string[];
     footer: FooterConfig | false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "2.4.1",
+  "version": "2.5.0",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -586,7 +586,7 @@
     "zod": "^4.3.6",
     "@takazudo/zfb": "0.1.0-next.76",
     "@takazudo/zfb-runtime": "0.1.0-next.76",
-    "@takazudo/zudo-doc-history-server": "2.4.1"
+    "@takazudo/zudo-doc-history-server": "2.5.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json",