@vibe-agent-toolkit/utils 0.1.42 → 0.2.0-rc.10

package/dist/file-crawler.js

@@ -1,7 +1,13 @@
 import fs from 'node:fs';
 import picomatch from 'picomatch';
+import { directoryRefusalFor, listingFailure, } from './fs-utils.js';
 import { gitFindRoot, gitLsFiles } from './git-utils.js';
+import { requireUnreadablePolicy, settleRefusal } from './listing-refusal.js';
 import { toForwardSlash, safePath } from './path-utils.js';
+// The refusal vocabulary lives in `listing-refusal.ts` so `git-utils.ts` can
+// share it without importing this module (which imports that one). Re-exported
+// here because `./crawl` is where every caller of the walk already looks.
+export { DirectoryListingRefusedError, refusedListingMessage, settleRefusal, } from './listing-refusal.js';
 /**
  * Glob options shared by every pattern this module compiles.
  *
@@ -71,6 +77,35 @@ export const NEVER_CRAWL_GLOBS = [
  */
 export const BUILD_OUTPUT_GLOBS = ['**/dist/**'];
 const DEFAULT_EXCLUDE = [...NEVER_CRAWL_GLOBS, ...BUILD_OUTPUT_GLOBS];
+/**
+ * THE include/exclude decision, compiled once — "is this base-relative path a
+ * member of the crawl?"
+ *
+ * Extracted because it is asked from three places that must never drift: the
+ * `git ls-files` branch below, the manual walk below it, and — since the
+ * projection-backed lane landed — a population that arrives already enumerated
+ * and still has to be narrowed to what the caller's globs admit. A lane that
+ * approximated this with its own picomatch call would be measuring the corpus
+ * with a different matcher than the one that ships, which is how a "clean" A/B
+ * comes to compare two different questions.
+ *
+ * The `+ '/'` retry is the load-bearing subtlety, not a defensive extra: a
+ * directory-shaped exclude like `docs/legacy/**` does not match the bare path
+ * `docs/legacy`, so without it an excluded directory is admitted as a member
+ * whenever a caller enumerates directories as well as files.
+ *
+ * @param include - Include globs, base-relative, forward-slashed
+ * @param exclude - Exclude globs, same basis; an empty list excludes nothing
+ * @returns A predicate over base-relative, forward-slashed paths
+ */
+export function crawlPathFilter(include, exclude) {
+    const isIncluded = picomatch([...include], PICOMATCH_OPTIONS);
+    const isExcluded = exclude.length > 0 ? picomatch([...exclude], PICOMATCH_OPTIONS) : () => false;
+    return (relativePath) => {
+        const normalized = toForwardSlash(relativePath);
+        return isIncluded(normalized) && !isExcluded(normalized) && !isExcluded(`${normalized}/`);
+    };
+}
 /**
  * Crawl a directory tree and return matching files (async)
  *
@@ -90,6 +125,21 @@ const DEFAULT_EXCLUDE = [...NEVER_CRAWL_GLOBS, ...BUILD_OUTPUT_GLOBS];
 export async function crawlDirectory(options) {
     return crawlDirectorySync(options);
 }
+/**
+ * Refuse a symlink observer on the `git ls-files` route.
+ *
+ * That route admits links as members and declines none, so the observer would
+ * compile, be accepted, and never be called. Refused up front rather than only
+ * when a git root happens to be found, so the contract is static.
+ *
+ * @param observer - The caller's `onSymlinkNotFollowed`
+ * @param respectGitignore - Whether the git route may be taken
+ */
+function requireWalkForSymlinkObserver(observer, respectGitignore) {
+    if (observer !== undefined && respectGitignore) {
+        throw new TypeError('crawlDirectory: onSymlinkNotFollowed requires respectGitignore: false — the git ls-files route declines no link');
+    }
+}
 /**
  * Crawl a directory tree and return matching files (synchronous)
  *
@@ -107,17 +157,36 @@ export async function crawlDirectory(options) {
  * });
  */
 export function crawlDirectorySync(options) {
-    const { baseDir, include = ['**/*'], exclude = DEFAULT_EXCLUDE, followSymlinks = false, absolute = true, filesOnly = true, respectGitignore = true, includeUntracked = false, } = options;
+    const { baseDir, include = ['**/*'], exclude = DEFAULT_EXCLUDE, followSymlinks = false, absolute = true, filesOnly = true, respectGitignore = true, includeUntracked = false, unreadable, onSymlinkNotFollowed, } = options;
+    requireUnreadablePolicy(unreadable, 'crawlDirectory');
+    requireWalkForSymlinkObserver(onSymlinkNotFollowed, respectGitignore);
     const picoOptions = PICOMATCH_OPTIONS;
     // Resolve base directory to absolute path
     const resolvedBaseDir = safePath.resolve(baseDir);
+    // Compiled once, ahead of the route choice, because BOTH routes ask it: the
+    // walk before it lists a directory, the git route before it reports one git
+    // could not list. One matcher is what keeps "is this directory excluded?"
+    // answered the same way on both sides of the fork.
+    const isExcluded = exclude.length > 0 ? picomatch(exclude, picoOptions) : () => false;
+    /**
+     * Check if a path should be excluded based on patterns
+     */
+    function shouldExclude(normalizedPath) {
+        // Check explicit exclude patterns
+        return isExcluded(normalizedPath) || isExcluded(normalizedPath + '/');
+    }
+    /**
+     * A refused listing surfaces under the caller's policy — thrown, or handed
+     * over. Never a silent skip, on either route.
+     */
+    function raiseRefusal(refusal) {
+        settleRefusal(unreadable, refusal);
+    }
     // Ensure base directory exists
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- baseDir is from controlled config, not user input
     if (!fs.existsSync(resolvedBaseDir)) {
         throw new Error(`Base directory does not exist: ${resolvedBaseDir}`);
     }
     // Ensure base directory is actually a directory
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- resolved path validated above
     const baseStat = fs.statSync(resolvedBaseDir);
     if (!baseStat.isDirectory()) {
         throw new Error(`Base path is not a directory: ${resolvedBaseDir}`);
@@ -132,17 +201,51 @@ export function crawlDirectorySync(options) {
             const gitFiles = gitLsFiles({
                 cwd: resolvedBaseDir,
                 includeUntracked,
+                // The SAME decision the walk makes, in the same order: a directory
+                // outside this crawl's base or dropped by `exclude` is never listed by
+                // the walk, so a refusal on it is not this crawl's gap; anything else
+                // is, and goes where the walk's would go.
+                // `degrade` from git's side only: the refusal is filtered to this
+                // crawl's territory and then settled under the CALLER's policy, which
+                // may well be `refuse`.
+                unreadable: {
+                    degrade: (refusal) => {
+                        // Strictly beneath the base: a repository is often an ancestor of
+                        // the crawl, and git names every refusal in the whole worktree.
+                        if (!toForwardSlash(refusal.directory).startsWith(`${toForwardSlash(resolvedBaseDir)}/`))
+                            return;
+                        if (shouldExclude(toForwardSlash(safePath.relative(resolvedBaseDir, refusal.directory))))
+                            return;
+                        raiseRefusal(refusal);
+                    },
+                },
             });
             if (gitFiles !== null) {
+                // ⚠️ KNOWN DIVERGENCE: this branch ignores `followSymlinks`.
+                //
+                // `git ls-files` returns symlinks as mode-120000 entries like any other
+                // path, and nothing below filters them out — whereas the manual walk
+                // (see `processSymlink`) returns early unless `followSymlinks` is set.
+                // So the SAME tree with the SAME options has a different population
+                // depending only on whether a `.git` exists above it.
+                //
+                // A committed dangling `*.md` symlink returned from here no longer
+                // terminates the command: `ResourceRegistry.addResources` records the
+                // read failure and reports it as RESOURCE_UNREADABLE. The population
+                // divergence itself is still live.
+                //
+                // Pinned (as today's behaviour, deliberately) by
+                // packages/cli/test/integration/enumeration-symlink-divergence.integration.test.ts.
+                // Making the two routes agree changes enumeration on real corpora — in
+                // one of two opposite directions, since excluding symlinks here drops
+                // committed content while including them in the walk grows the off-git
+                // population — so it is a product decision with its own changelog
+                // entry, not a drive-by fix here.
+                //
                 // Git ls-files succeeded - filter using glob patterns
-                const isIncluded = picomatch(include, picoOptions);
-                const isExcluded = exclude.length > 0 ? picomatch(exclude, picoOptions) : () => false;
+                const isMember = crawlPathFilter(include, exclude);
                 return gitFiles
-                    .filter((relativePath) => {
-                    const normalizedPath = toForwardSlash(relativePath);
-                    // Check both include and exclude patterns
-                    return isIncluded(normalizedPath) && !isExcluded(normalizedPath) && !isExcluded(normalizedPath + '/');
-                })
+                    .filter((relativePath) => isMember(relativePath))
                     .map((relativePath) => {
                     // git ls-files returns paths relative to cwd
                     return absolute ? safePath.resolve(resolvedBaseDir, relativePath) : relativePath;
@@ -154,15 +257,24 @@ export function crawlDirectorySync(options) {
     // Fall back to manual directory crawling (not in git repo or git ls-files failed)
     // Compile glob patterns using picomatch
     const isIncluded = picomatch(include, picoOptions);
-    const isExcluded = exclude.length > 0 ? picomatch(exclude, picoOptions) : () => false;
     const results = [];
     /**
-     * Check if a path should be excluded based on patterns
+     * Real paths of directories already walked, maintained ONLY when following
+     * symlinks — it is what makes a directory symlink safe to traverse.
+     *
+     * A symlinked directory can be re-entered without limit (`a/loop -> a`) and
+     * can be reached under two names (`alias-one -> real`, `alias-two -> real`).
+     * Both enumerate one blob many times under distinct paths, so each row gets
+     * its own generated id and its own bundle entry. The loop terminated before
+     * this guard existed, but only because the kernel eventually refuses to
+     * resolve further symlinks — a limit that is 32 on macOS and 40 on Linux, so
+     * the POPULATION depended on the operating system, and the walk ended inside
+     * `processSymlink`'s catch for BROKEN links, which reported nothing.
+     *
+     * Left empty when `followSymlinks` is false: without symlink traversal a
+     * directory cannot be reached twice, so the default path pays no `realpath`.
      */
-    function shouldExclude(normalizedPath) {
-        // Check explicit exclude patterns
-        return isExcluded(normalizedPath) || isExcluded(normalizedPath + '/');
-    }
+    const visitedRealDirs = new Set();
     /**
      * Add a path to results if it matches include patterns
      */
@@ -171,21 +283,76 @@ export function crawlDirectorySync(options) {
             results.push(absolute ? fullPath : relativePath);
         }
     }
+    /**
+     * What a failed `readdirSync` / `statSync` means for the walk.
+     *
+     * Absence (`ENOENT` / `ENOTDIR`) is an entry that vanished between being
+     * enumerated by its parent and being asked about itself — not in the
+     * population, nothing to report. Anything else is a refusal, and a refusal
+     * is a GAP: handed to the caller if it asked, thrown otherwise. Never a
+     * silent `return` — that is the shorter list this walk used to hand back.
+     *
+     * @param error - What the filesystem threw
+     * @param target - The directory (or link) it was asked about
+     * @returns True when the entry is simply gone and the walk should move on
+     */
+    function reportOrSkip(error, target) {
+        const listing = listingFailure(error);
+        if (listing.outcome === 'absent')
+            return true;
+        if (listing.outcome === 'unreadable')
+            raiseRefusal(directoryRefusalFor(listing, target));
+        return false;
+    }
+    /**
+     * Record a directory as walked, reporting whether it had already been seen.
+     *
+     * Identity is `realpathSync.native`, not the traversal path: two names for
+     * one directory must collide here or the alias is enumerated twice. A
+     * directory whose real path cannot be read is not descended into — refusing
+     * to walk something we cannot identify is the safe side of a guard whose
+     * whole job is bounding traversal — but it is NOT silently "already walked":
+     * a directory that vanished is skipped like any other absence, and one the
+     * OS refused to canonicalise is a gap, surfaced under the caller's policy
+     * exactly as a refused listing is (see `reportOrSkip`).
+     *
+     * @param dir - Directory about to be walked
+     * @returns True when this directory must not be walked (seen before, gone, or refused)
+     */
+    function alreadyWalked(dir) {
+        let realPath;
+        try {
+            realPath = fs.realpathSync.native(dir);
+        }
+        catch (error) {
+            reportOrSkip(error, dir);
+            return true;
+        }
+        if (visitedRealDirs.has(realPath)) {
+            return true;
+        }
+        visitedRealDirs.add(realPath);
+        return false;
+    }
     /**
      * Process a symbolic link entry
      */
     function processSymlink(fullPath, normalizedPath, relativePath) {
         if (!followSymlinks) {
+            if (onSymlinkNotFollowed !== undefined && isIncluded(normalizedPath)) {
+                onSymlinkNotFollowed(absolute ? fullPath : relativePath);
+            }
             return;
         }
         // Resolve symlink and check if it's a directory or file
         let targetStat;
         try {
-            // eslint-disable-next-line security/detect-non-literal-fs-filename -- path constructed from validated baseDir + entries
             targetStat = fs.statSync(fullPath);
         }
-        catch {
-            // Skip broken symlinks
+        catch (error) {
+            // A broken symlink is absence and is skipped; a target the OS refused to
+            // stat is a gap, and goes the same way a refused listing does.
+            reportOrSkip(error, fullPath);
             return;
         }
         if (targetStat.isDirectory()) {
@@ -216,15 +383,32 @@ export function crawlDirectorySync(options) {
      * Recursively walk directory tree
      */
     function walkDirectory(currentDir) {
+        if (followSymlinks && alreadyWalked(currentDir)) {
+            return;
+        }
         let entries;
         try {
-            // eslint-disable-next-line security/detect-non-literal-fs-filename -- path constructed from validated baseDir, recursively walking
             entries = fs.readdirSync(currentDir, { withFileTypes: true });
         }
-        catch {
-            // Skip directories we don't have permission to read
+        catch (error) {
+            // 🚨 Not a silent skip. A directory that refused to be listed is a gap in
+            // the population this walk defines — see `reportOrSkip`.
+            reportOrSkip(error, currentDir);
             return;
         }
+        // Two passes, not one: `readdirSync` order is filesystem-defined (see
+        // the comment on `alreadyWalked`), and both a real directory and a
+        // symlink alias pointing at it go through the same `alreadyWalked` gate,
+        // keyed only on realpath. Whichever spelling is dispatched FIRST claims
+        // that realpath in `visitedRealDirs`, and the second is then skipped as
+        // "already walked" — so if the alias happened to sort first, the
+        // directory's contents would be recorded under the alias's name and the
+        // real directory would be skipped entirely. Walking every non-symlink
+        // entry to completion before any symlink entry guarantees a real
+        // directory always claims its own realpath first; an alias reaching the
+        // same realpath afterward is correctly skipped by `alreadyWalked`. Only
+        // the ORDER of dispatch changes here — per-entry logic is unchanged.
+        const symlinkEntries = [];
         for (const entry of entries) {
             const fullPath = safePath.join(currentDir, entry.name);
             const relativePath = safePath.relative(resolvedBaseDir, fullPath);
@@ -233,9 +417,9 @@ export function crawlDirectorySync(options) {
             if (shouldExclude(normalizedPath)) {
                 continue;
             }
-            // Dispatch to appropriate handler based on entry type
+            // Defer symlinks to the second pass; dispatch everything else now.
             if (entry.isSymbolicLink()) {
-                processSymlink(fullPath, normalizedPath, relativePath);
+                symlinkEntries.push(entry);
             }
             else if (entry.isDirectory()) {
                 processDirectory(fullPath, normalizedPath, relativePath);
@@ -244,6 +428,12 @@ export function crawlDirectorySync(options) {
                 processFile(normalizedPath, fullPath, relativePath);
             }
         }
+        for (const entry of symlinkEntries) {
+            const fullPath = safePath.join(currentDir, entry.name);
+            const relativePath = safePath.relative(resolvedBaseDir, fullPath);
+            const normalizedPath = toForwardSlash(relativePath);
+            processSymlink(fullPath, normalizedPath, relativePath);
+        }
     }
     // Start recursive walk from base directory
     walkDirectory(resolvedBaseDir);

package/dist/file-crawler.js.map

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

package/dist/fs/file-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-hash.d.ts","sourceRoot":"","sources":["../../src/fs/file-hash.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpD"}
+{"version":3,"file":"file-hash.d.ts","sourceRoot":"","sources":["../../src/fs/file-hash.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/fs/file-hash.js

@@ -16,7 +16,6 @@ import { readFileSync } from 'node:fs';
  * // '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
  */
 export function fileContentHash(path) {
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- path is caller-supplied; callers are responsible for path safety
     const bytes = readFileSync(path);
     return createHash('sha256').update(bytes).digest('hex');
 }

package/dist/fs/file-hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-hash.js","sourceRoot":"","sources":["../../src/fs/file-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,uIAAuI;IACvI,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"file-hash.js","sourceRoot":"","sources":["../../src/fs/file-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC"}