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

package/dist/archive/zip-reader.js.map

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

package/dist/archive.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @vibe-agent-toolkit/utils/archive
+ *
+ * The one archive primitive: read, list, extract and create. It is the only module in VAT that
+ * imports `tar` or `adm-zip` (`no-restricted-imports` holds every other file to that), so it is
+ * quarantined behind its own subpath — a command that touches no archive never loads either.
+ */
+export { extractArchive, listArchive, openArchive, readArchiveFile, zipOfArchive } from './archive/archive.js';
+export type { ArchiveExtractOptions, ArchiveReadOptions, ArchiveSource, OpenedArchive } from './archive/archive.js';
+export { ARCHIVE_ENTRY_UNREADABLE_CODE, ARCHIVE_REFUSED_CODE, ArchiveEntryReadError, archiveEntryRefusal, ArchiveRefusedError } from './archive/entries.js';
+export type { ArchiveEntry, ArchiveEntryKind, ArchiveFormat, ArchiveLimits, ArchiveRefusalReason, EntryRefusal } from './archive/entries.js';
+export { ARCHIVE_DOWNLOAD_MAX_BYTES, ARCHIVE_LIMITS } from './archive/limits.js';
+export { zipOfDirectory } from './archive/zip-reader.js';
+//# sourceMappingURL=archive.d.ts.map

package/dist/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../src/archive.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC/G,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC5J,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC7I,OAAO,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/archive.js

@@ -0,0 +1,12 @@
+/**
+ * @vibe-agent-toolkit/utils/archive
+ *
+ * The one archive primitive: read, list, extract and create. It is the only module in VAT that
+ * imports `tar` or `adm-zip` (`no-restricted-imports` holds every other file to that), so it is
+ * quarantined behind its own subpath — a command that touches no archive never loads either.
+ */
+export { extractArchive, listArchive, openArchive, readArchiveFile, zipOfArchive } from './archive/archive.js';
+export { ARCHIVE_ENTRY_UNREADABLE_CODE, ARCHIVE_REFUSED_CODE, ArchiveEntryReadError, archiveEntryRefusal, ArchiveRefusedError } from './archive/entries.js';
+export { ARCHIVE_DOWNLOAD_MAX_BYTES, ARCHIVE_LIMITS } from './archive/limits.js';
+export { zipOfDirectory } from './archive/zip-reader.js';
+//# sourceMappingURL=archive.js.map

package/dist/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../src/archive.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE/G,OAAO,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE5J,OAAO,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/asset-reference.d.ts

@@ -1,3 +1,17 @@
+/**
+ * A bare specifier Node could not resolve to a file: the package is not
+ * installed, its `exports` map does not expose the subpath, or the file it
+ * points at is not on disk. Always about the reference a user supplied, so a
+ * caller reports it against that input — never as VAT's defect.
+ */
+export declare const ASSET_REFERENCE_UNRESOLVED_CODE = "ASSET_REFERENCE_UNRESOLVED";
+/**
+ * A bare specifier whose package IS installed, but which Node could not read
+ * its way through: a malformed or unreadable `package.json`, or an `exports`
+ * map that is itself invalid. The reference names something; the package is
+ * broken — so a caller reports it as an unreadable input, never as "missing".
+ */
+export declare const ASSET_REFERENCE_UNREADABLE_CODE = "ASSET_REFERENCE_UNREADABLE";
 /**
  * Resolve a VAT "asset reference" to an absolute filesystem path.
  *
@@ -29,7 +43,9 @@
  * @param specifier - The asset reference (path or bare npm specifier)
  * @param baseDir - Absolute directory used as the resolution anchor
  * @returns Absolute filesystem path to the asset
- * @throws Error with actionable message and `cause` on resolution failure
+ * @throws {VatError} `ASSET_REFERENCE_UNRESOLVED`, with an actionable message and
+ *   Node's error as `cause`, when a bare specifier names nothing Node can reach;
+ *   `ASSET_REFERENCE_UNREADABLE` when the package is there and Node cannot read it
  */
 export declare function resolveAssetReference(specifier: string, baseDir: string): string;
 //# sourceMappingURL=asset-reference.d.ts.map

package/dist/asset-reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-reference.d.ts","sourceRoot":"","sources":["../src/asset-reference.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBhF"}
+{"version":3,"file":"asset-reference.d.ts","sourceRoot":"","sources":["../src/asset-reference.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAW5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA4BhF"}

package/dist/asset-reference.js

@@ -1,7 +1,24 @@
 import { existsSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { pathToFileURL } from 'node:url';
+import { VatError } from './errors/vat-error.js';
 import { isAbsolutePath, safePath } from './path-utils.js';
+/**
+ * A bare specifier Node could not resolve to a file: the package is not
+ * installed, its `exports` map does not expose the subpath, or the file it
+ * points at is not on disk. Always about the reference a user supplied, so a
+ * caller reports it against that input — never as VAT's defect.
+ */
+export const ASSET_REFERENCE_UNRESOLVED_CODE = 'ASSET_REFERENCE_UNRESOLVED';
+/**
+ * A bare specifier whose package IS installed, but which Node could not read
+ * its way through: a malformed or unreadable `package.json`, or an `exports`
+ * map that is itself invalid. The reference names something; the package is
+ * broken — so a caller reports it as an unreadable input, never as "missing".
+ */
+export const ASSET_REFERENCE_UNREADABLE_CODE = 'ASSET_REFERENCE_UNREADABLE';
+/** Node's codes for "this specifier names nothing it can reach" — everything else is the package's fault. */
+const NAMES_NOTHING_CODES = new Set(['MODULE_NOT_FOUND', 'ERR_PACKAGE_PATH_NOT_EXPORTED']);
 // First segment must be a valid npm package name (scoped or unscoped),
 // followed by `/` and at least one subpath segment. Paths starting with
 // `.`, `/`, or a Windows drive letter are filesystem paths, never bare
@@ -38,7 +55,9 @@ const BARE_SPECIFIER_RE = /^(?:@[^/]+\/[^/]+|[a-z0-9][a-z0-9._-]*)\/.+/i;
  * @param specifier - The asset reference (path or bare npm specifier)
  * @param baseDir - Absolute directory used as the resolution anchor
  * @returns Absolute filesystem path to the asset
- * @throws Error with actionable message and `cause` on resolution failure
+ * @throws {VatError} `ASSET_REFERENCE_UNRESOLVED`, with an actionable message and
+ *   Node's error as `cause`, when a bare specifier names nothing Node can reach;
+ *   `ASSET_REFERENCE_UNREADABLE` when the package is there and Node cannot read it
  */
 export function resolveAssetReference(specifier, baseDir) {
     if (!isBareSpecifier(specifier)) {
@@ -56,7 +75,12 @@ export function resolveAssetReference(specifier, baseDir) {
         if (!specifier.startsWith('@') && isModuleNotFound(cause)) {
             return safePath.resolve(baseDir, specifier);
         }
-        throw new Error(formatActionableError(specifier, baseDir, cause), { cause: cause });
+        if (!NAMES_NOTHING_CODES.has(errorCodeOf(cause) ?? '')) {
+            throw new VatError(ASSET_REFERENCE_UNREADABLE_CODE, `Failed to resolve asset reference '${specifier}': its package is installed but Node cannot read it ` +
+                `(a malformed or unreadable package.json, or an invalid "exports" map) — fix or reinstall the package.\n` +
+                `Node error: ${formatResolutionError(cause)}`, { cause });
+        }
+        throw new VatError(ASSET_REFERENCE_UNRESOLVED_CODE, formatActionableError(specifier, baseDir, cause), { cause });
     }
 }
 /**
@@ -66,7 +90,7 @@ export function resolveAssetReference(specifier, baseDir) {
  */
 function formatActionableError(specifier, baseDir, cause) {
     const headline = formatResolutionError(cause);
-    const code = cause?.code;
+    const code = errorCodeOf(cause);
     const missingPath = extractMissingModulePath(cause);
     // Mode 1: Node walked the package's `exports` map, computed an absolute
     // target path, and that file is not on disk. This is the most confusing
@@ -112,11 +136,11 @@ function extractMissingModulePath(cause) {
 function isBareSpecifier(value) {
     return BARE_SPECIFIER_RE.test(value);
 }
+function errorCodeOf(err) {
+    return err?.code;
+}
 function isModuleNotFound(err) {
-    return (typeof err === 'object' &&
-        err !== null &&
-        'code' in err &&
-        err.code === 'MODULE_NOT_FOUND');
+    return errorCodeOf(err) === 'MODULE_NOT_FOUND';
 }
 function formatResolutionError(err) {
     if (err instanceof Error) {

package/dist/asset-reference.js.map

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

package/dist/dirent-kind.d.ts

@@ -15,16 +15,16 @@
  *   points at. For a walk that must NOT follow (a delete, a size count of
  *   what `rm -rf` will remove, a bundle that travels as a tarball).
  * - {@link direntKindFollowing} — stat semantics. A link is answered by its
- *   target: `'file'`, `'directory'`, or `'dangling'`. For a walk over a tree
- *   the caller trusts (its own build output, a dev-mode install, a fixture),
- *   where a link is simply how the entry got there.
+ *   target: `'file'`, `'directory'`, or `'dangling'`. The link's chain is read
+ *   by its text beneath the tree the walk is in (`within`) before the kernel
+ *   follows it (`link-following.ts`): a cycle is `'dangling'`, a link to a
+ *   network or device path a `LinkChainRefusedError`.
  *
  * Neither helper decides for the caller. A `'symlink'` or `'dangling'` that
  * the caller ignores is still ignored — but it is ignored in a `case` the
  * reader can see, which is the whole difference.
  */
 import type { Dirent } from 'node:fs';
-import { VatError } from './errors/vat-error.js';
 /** What the entry itself is. A link is a link. */
 export type DirentKind = 'file' | 'directory' | 'symlink' | 'other';
 /** What the entry resolves to. A link is answered by its target, or is `dangling`. */
@@ -37,47 +37,20 @@ export type FollowedKind = 'file' | 'directory' | 'dangling' | 'other';
  */
 export declare function direntKind(entry: Dirent): DirentKind;
 /**
- * Classify an entry by what it resolves to, following a link with one `stat`.
+ * Classify an entry by what it resolves to, following a link only once its
+ * chain is read beneath `within` (`link-following.ts`).
  *
- * A non-link entry costs no syscall. A link whose target is absent is
- * `'dangling'`; a link the OS refuses to resolve (`ELOOP`, `EACCES`) is a
- * refusal, not an absence, and stays loud.
+ * A non-link entry costs no syscall. A link that resolves to nothing — absent,
+ * a cycle — is `'dangling'`; a probe the OS refuses (`EACCES`) is a refusal, not
+ * an absence, and stays loud, raw, for the caller's classifier.
  *
  * @param dir - The directory `entry` was listed from
  * @param entry - A `Dirent` from a `withFileTypes` listing of `dir`
+ * @param within - The tree the walk is in: the operator's own input
  * @returns The target's kind, or `'dangling'`
+ * @throws LinkChainRefusedError for a link to a network or device path
  */
-export declare function direntKindFollowingSync(dir: string, entry: Dirent): FollowedKind;
+export declare function direntKindFollowingSync(dir: string, entry: Dirent, within: string): FollowedKind;
 /** The async counterpart of {@link direntKindFollowingSync}. */
-export declare function direntKindFollowing(dir: string, entry: Dirent): Promise<FollowedKind>;
-/** Thrown when a following walk is led back into a directory it has already entered. */
-export declare class DirectoryWalkRevisitedError extends VatError {
-    constructor(dir: string, enteredAs: string);
-}
-/**
- * The directories a FOLLOWING walk has entered, by realpath, so a link that
- * leads back into the walk is refused instead of recursed until
- * `ENAMETOOLONG`.
- *
- * A walk that follows links (`direntKindFollowing`) has no cycle guard by
- * construction: `scripts/loop -> .` makes a copy create `dest/loop/loop/…`,
- * writing every file at every level first, and a hashing walk do the same in
- * memory. Every following walk holds one of these and calls {@link enter}
- * on every directory it recurses into — the root included. A REVISIT is
- * refused, not just a cycle: two links to one directory make the walk's
- * output ambiguous (which spelling is the file's path?), and a refusal that
- * names both spellings is the answer the author can act on.
- */
-export declare class FollowedWalk {
-    #private;
-    /**
-     * Record that the walk is entering `dir`. Synchronous on purpose — one
-     * realpath per directory entered is nothing beside the listing itself, and
-     * the sync and async walkers then share one guard.
-     *
-     * @param dir - A directory the walk is about to list, in any spelling
-     * @throws {DirectoryWalkRevisitedError} When its realpath was entered before
-     */
-    enter(dir: string): void;
-}
+export declare function direntKindFollowing(dir: string, entry: Dirent, within: string): Promise<FollowedKind>;
 //# sourceMappingURL=dirent-kind.d.ts.map

package/dist/dirent-kind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dirent-kind.d.ts","sourceRoot":"","sources":["../src/dirent-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKtC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAKpD;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAQhF;AAED,gEAAgE;AAChE,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAQ3F;AAED,wFAAwF;AACxF,qBAAa,2BAA4B,SAAQ,QAAQ;gBAC3C,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAM3C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;;IAGvB;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAMzB"}
+{"version":3,"file":"dirent-kind.d.ts","sourceRoot":"","sources":["../src/dirent-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKtC,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAKpD;AAcD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAGhG;AAED,gEAAgE;AAChE,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAG3G"}

package/dist/dirent-kind.js

@@ -15,20 +15,17 @@
  *   points at. For a walk that must NOT follow (a delete, a size count of
  *   what `rm -rf` will remove, a bundle that travels as a tarball).
  * - {@link direntKindFollowing} — stat semantics. A link is answered by its
- *   target: `'file'`, `'directory'`, or `'dangling'`. For a walk over a tree
- *   the caller trusts (its own build output, a dev-mode install, a fixture),
- *   where a link is simply how the entry got there.
+ *   target: `'file'`, `'directory'`, or `'dangling'`. The link's chain is read
+ *   by its text beneath the tree the walk is in (`within`) before the kernel
+ *   follows it (`link-following.ts`): a cycle is `'dangling'`, a link to a
+ *   network or device path a `LinkChainRefusedError`.
  *
  * Neither helper decides for the caller. A `'symlink'` or `'dangling'` that
  * the caller ignores is still ignored — but it is ignored in a `case` the
  * reader can see, which is the whole difference.
  */
-import { statSync } from 'node:fs';
-import fs from 'node:fs/promises';
-import { isPathAbsentError } from './errors/errno.js';
-import { VatError } from './errors/vat-error.js';
-import { toForwardSlash } from './path-core.js';
-import { normalizePath, safePath } from './path-utils.js';
+import { followedKind, followedKindSync } from './link-following.js';
+import { safePath } from './path-core.js';
 /**
  * Classify an entry WITHOUT following it.
  *
@@ -52,78 +49,33 @@ function kindOfStats(stats) {
         return 'file';
     return 'other';
 }
+/** A followed kind, a link that resolves to nothing named `dangling`. */
+function followed(kind) {
+    return kind === 'absent' ? 'dangling' : kind;
+}
 /**
- * Classify an entry by what it resolves to, following a link with one `stat`.
+ * Classify an entry by what it resolves to, following a link only once its
+ * chain is read beneath `within` (`link-following.ts`).
  *
- * A non-link entry costs no syscall. A link whose target is absent is
- * `'dangling'`; a link the OS refuses to resolve (`ELOOP`, `EACCES`) is a
- * refusal, not an absence, and stays loud.
+ * A non-link entry costs no syscall. A link that resolves to nothing — absent,
+ * a cycle — is `'dangling'`; a probe the OS refuses (`EACCES`) is a refusal, not
+ * an absence, and stays loud, raw, for the caller's classifier.
  *
  * @param dir - The directory `entry` was listed from
  * @param entry - A `Dirent` from a `withFileTypes` listing of `dir`
+ * @param within - The tree the walk is in: the operator's own input
  * @returns The target's kind, or `'dangling'`
+ * @throws LinkChainRefusedError for a link to a network or device path
  */
-export function direntKindFollowingSync(dir, entry) {
+export function direntKindFollowingSync(dir, entry, within) {
     if (!entry.isSymbolicLink())
         return kindOfStats(entry);
-    try {
-        return kindOfStats(statSync(safePath.join(dir, entry.name)));
-    }
-    catch (error) {
-        if (isPathAbsentError(error))
-            return 'dangling';
-        throw error;
-    }
+    return followed(followedKindSync(safePath.join(dir, entry.name), within));
 }
 /** The async counterpart of {@link direntKindFollowingSync}. */
-export async function direntKindFollowing(dir, entry) {
+export async function direntKindFollowing(dir, entry, within) {
     if (!entry.isSymbolicLink())
         return kindOfStats(entry);
-    try {
-        return kindOfStats(await fs.stat(safePath.join(dir, entry.name)));
-    }
-    catch (error) {
-        if (isPathAbsentError(error))
-            return 'dangling';
-        throw error;
-    }
-}
-/** Thrown when a following walk is led back into a directory it has already entered. */
-export class DirectoryWalkRevisitedError extends VatError {
-    constructor(dir, enteredAs) {
-        super('DIRECTORY_WALK_REVISITED', `Refusing to enter ${dir}: it is the directory already walked as ${enteredAs} — a symlink leads the walk back into itself.`);
-    }
-}
-/**
- * The directories a FOLLOWING walk has entered, by realpath, so a link that
- * leads back into the walk is refused instead of recursed until
- * `ENAMETOOLONG`.
- *
- * A walk that follows links (`direntKindFollowing`) has no cycle guard by
- * construction: `scripts/loop -> .` makes a copy create `dest/loop/loop/…`,
- * writing every file at every level first, and a hashing walk do the same in
- * memory. Every following walk holds one of these and calls {@link enter}
- * on every directory it recurses into — the root included. A REVISIT is
- * refused, not just a cycle: two links to one directory make the walk's
- * output ambiguous (which spelling is the file's path?), and a refusal that
- * names both spellings is the answer the author can act on.
- */
-export class FollowedWalk {
-    #entered = new Map();
-    /**
-     * Record that the walk is entering `dir`. Synchronous on purpose — one
-     * realpath per directory entered is nothing beside the listing itself, and
-     * the sync and async walkers then share one guard.
-     *
-     * @param dir - A directory the walk is about to list, in any spelling
-     * @throws {DirectoryWalkRevisitedError} When its realpath was entered before
-     */
-    enter(dir) {
-        const real = toForwardSlash(normalizePath(dir));
-        const before = this.#entered.get(real);
-        if (before !== undefined)
-            throw new DirectoryWalkRevisitedError(dir, before);
-        this.#entered.set(real, dir);
-    }
+    return followed(await followedKind(safePath.join(dir, entry.name), within));
 }
 //# sourceMappingURL=dirent-kind.js.map

package/dist/dirent-kind.js.map

@@ -1 +1 @@
-{"version":3,"file":"dirent-kind.js","sourceRoot":"","sources":["../src/dirent-kind.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dirent-kind.js","sourceRoot":"","sources":["../src/dirent-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAyB,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAQ1C;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,CAAC,cAAc,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,KAAK,CAAC,WAAW,EAAE;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,KAAK,CAAC,MAAM,EAAE;QAAE,OAAO,MAAM,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,wCAAwC;AACxC,SAAS,WAAW,CAAC,KAAoD;IACvE,IAAI,KAAK,CAAC,WAAW,EAAE;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,KAAK,CAAC,MAAM,EAAE;QAAE,OAAO,MAAM,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yEAAyE;AACzE,SAAS,QAAQ,CAAC,IAAsB;IACtC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc;IAChF,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;QAAE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc;IAClF,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE;QAAE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,QAAQ,CAAC,MAAM,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/entrypoint.d.ts

@@ -11,8 +11,8 @@
  * Was this module invoked as the process entrypoint, rather than imported?
  *
  * ⛔ **Do not reach for `import.meta.main` here.** It shipped in Node 24.2 and
- * 22.18; this repo declares a floor of `>=22.13.0`, and on a real 22.13.0 the
- * property is `undefined`:
+ * 22.18; this repo declares a floor of `>=22.16.0`, and on a real 22.13.0 and
+ * 22.16.0 the property is `undefined`:
  *
  * ```
  * $ node-v22.13.0 --input-type=module -e "console.log(import.meta.main)"  -> undefined

package/dist/entrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAM,GAAG,SAA2B,GAC9C,OAAO,CAcT"}
+{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAM,GAAG,SAA2B,GAC9C,OAAO,CAeT"}

package/dist/entrypoint.js

@@ -14,8 +14,8 @@ import { normalizePath } from './path-utils.js';
  * Was this module invoked as the process entrypoint, rather than imported?
  *
  * ⛔ **Do not reach for `import.meta.main` here.** It shipped in Node 24.2 and
- * 22.18; this repo declares a floor of `>=22.13.0`, and on a real 22.13.0 the
- * property is `undefined`:
+ * 22.18; this repo declares a floor of `>=22.16.0`, and on a real 22.13.0 and
+ * 22.16.0 the property is `undefined`:
  *
  * ```
  * $ node-v22.13.0 --input-type=module -e "console.log(import.meta.main)"  -> undefined
@@ -66,6 +66,7 @@ export function isEntrypoint(importMetaUrl, entryPath = process.argv[1]) {
     // the path unchanged when it cannot — which is the right answer here, since
     // the string comparison above has already decided the two differ and an
     // unresolvable path carries no symlink information to compare.
-    return toForwardSlash(normalizePath(modulePath)) === toForwardSlash(normalizePath(invokedPath));
+    // Both are the process's own entry points, not a crawled path: each is its own edge.
+    return toForwardSlash(normalizePath(modulePath, modulePath)) === toForwardSlash(normalizePath(invokedPath, invokedPath));
 }
 //# sourceMappingURL=entrypoint.js.map

package/dist/entrypoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,YAAY,CAC1B,aAAqB,EACrB,YAAgC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/C,6EAA6E;IAC7E,2EAA2E;IAC3E,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAE9D,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAE5C,6EAA6E;IAC7E,4EAA4E;IAC5E,wEAAwE;IACxE,+DAA+D;IAC/D,OAAO,cAAc,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,KAAK,cAAc,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;AAClG,CAAC"}
+{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,YAAY,CAC1B,aAAqB,EACrB,YAAgC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/C,6EAA6E;IAC7E,2EAA2E;IAC3E,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAE9D,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAE5C,6EAA6E;IAC7E,4EAA4E;IAC5E,wEAAwE;IACxE,+DAA+D;IAC/D,qFAAqF;IACrF,OAAO,cAAc,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,KAAK,cAAc,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAC3H,CAAC"}

package/dist/env-flag.d.ts

@@ -20,21 +20,29 @@
  * needs it rather than speculatively. That second package arrived:
  * `packages/cli`'s `projectionStoreSelected()` reads the same `VAT_CACHE` the
  * `resources` parse cache does, and two independent readings of one variable is
- * the defect, not the fix. The four consumers today:
+ * the defect, not the fix. The consumers today:
  *
  * | Caller | Variable | Reads `undefined` as | Why |
  * |---|---|---|---|
- * | `link-auth/resolve-token.ts` | `VAT_LINKAUTH_ALLOW_COMMAND` | **deny** | gates a capability — fail closed |
+ * | `resources/link-auth/resolve-token.ts` | `VAT_LINKAUTH_ALLOW_COMMAND` | **deny** | gates a capability — fail closed |
  * | `resources/parse-cache.ts` | `VAT_CACHE` | cache stays on | gates a cache — an unreadable value must not silently change behaviour |
  * | `cli/utils/projection-store.ts` | `VAT_CACHE` | not a veto | same variable, same reading, one implementation |
  * | `cli/utils/projection-store.ts` | `VAT_PROJECTION_STORE` | not a veto | the projection store is ON by default; only an explicit off spelling (or an empty value, which that call site handles before asking) turns it off |
+ * | `lab/harness/population-expectation.ts` | `VAT_CACHE` | not a veto | mirrors the two readings above, so the lab expects a parse shard and a store exactly where vat writes them (pinned against the built cli and resources) |
+ * | `lab/harness/population-expectation.ts` | `VAT_PROJECTION_STORE` | not a veto | mirrors `projectionStoreSelected()`, empty handled before asking, as that call site does (pinned against the built cli) |
+ * | `resources/parse-dispatcher.ts` | `VAT_PARSE_POOL` | pool stays on | gates a measured speed-up — only an explicit off spelling disables it; a typo must not silently cost it |
  *
  * Same parser, different safe sides, each chosen at its own call site. That is
  * the contract; do not move a default in here.
  *
- * 🔑 The last two rows are the interesting pair: one variable defaults OFF and
- * the other defaults ON, and both are still read through this one function,
- * because what it answers is not "is this on" but "did the operator say no".
+ * 🔑 The two `projection-store.ts` rows are the interesting pair: one variable
+ * defaults OFF and the other defaults ON, and both are still read through this
+ * one function, because what it answers is not "is this on" but "did the
+ * operator say no".
+ *
+ * The table is asserted both ways, per (file, variable), against every
+ * `parseEnvBoolean` call (aliased imports included) in every package's `src` by
+ * `test/env-flag.test.ts`.
  */
 /**
  * Parse an env value as a boolean.

package/dist/env-flag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-flag.d.ts","sourceRoot":"","sources":["../src/env-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAKH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAM5E"}
+{"version":3,"file":"env-flag.d.ts","sourceRoot":"","sources":["../src/env-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAKH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAM5E"}

package/dist/env-flag.js

@@ -20,21 +20,29 @@
  * needs it rather than speculatively. That second package arrived:
  * `packages/cli`'s `projectionStoreSelected()` reads the same `VAT_CACHE` the
  * `resources` parse cache does, and two independent readings of one variable is
- * the defect, not the fix. The four consumers today:
+ * the defect, not the fix. The consumers today:
  *
  * | Caller | Variable | Reads `undefined` as | Why |
  * |---|---|---|---|
- * | `link-auth/resolve-token.ts` | `VAT_LINKAUTH_ALLOW_COMMAND` | **deny** | gates a capability — fail closed |
+ * | `resources/link-auth/resolve-token.ts` | `VAT_LINKAUTH_ALLOW_COMMAND` | **deny** | gates a capability — fail closed |
  * | `resources/parse-cache.ts` | `VAT_CACHE` | cache stays on | gates a cache — an unreadable value must not silently change behaviour |
  * | `cli/utils/projection-store.ts` | `VAT_CACHE` | not a veto | same variable, same reading, one implementation |
  * | `cli/utils/projection-store.ts` | `VAT_PROJECTION_STORE` | not a veto | the projection store is ON by default; only an explicit off spelling (or an empty value, which that call site handles before asking) turns it off |
+ * | `lab/harness/population-expectation.ts` | `VAT_CACHE` | not a veto | mirrors the two readings above, so the lab expects a parse shard and a store exactly where vat writes them (pinned against the built cli and resources) |
+ * | `lab/harness/population-expectation.ts` | `VAT_PROJECTION_STORE` | not a veto | mirrors `projectionStoreSelected()`, empty handled before asking, as that call site does (pinned against the built cli) |
+ * | `resources/parse-dispatcher.ts` | `VAT_PARSE_POOL` | pool stays on | gates a measured speed-up — only an explicit off spelling disables it; a typo must not silently cost it |
  *
  * Same parser, different safe sides, each chosen at its own call site. That is
  * the contract; do not move a default in here.
  *
- * 🔑 The last two rows are the interesting pair: one variable defaults OFF and
- * the other defaults ON, and both are still read through this one function,
- * because what it answers is not "is this on" but "did the operator say no".
+ * 🔑 The two `projection-store.ts` rows are the interesting pair: one variable
+ * defaults OFF and the other defaults ON, and both are still read through this
+ * one function, because what it answers is not "is this on" but "did the
+ * operator say no".
+ *
+ * The table is asserted both ways, per (file, variable), against every
+ * `parseEnvBoolean` call (aliased imports included) in every package's `src` by
+ * `test/env-flag.test.ts`.
  */
 const TRUE_SPELLINGS = new Set(['1', 'true', 'yes', 'y', 'on']);
 const FALSE_SPELLINGS = new Set(['0', 'false', 'no', 'n', 'off']);

package/dist/env-flag.js.map

@@ -1 +1 @@
-{"version":3,"file":"env-flag.js","sourceRoot":"","sources":["../src/env-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AACrF,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"env-flag.js","sourceRoot":"","sources":["../src/env-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AACrF,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/errors/confirmed-absent.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Believe "nothing there" only when the parent's listing agrees.
+ *
+ * A probe — a read, an `lstat` — that the OS answers with `ENOENT` or `ENOTDIR`
+ * means absent only if it is right. Read as absent on its own word, a refusal of a
+ * file that IS there turns a registry into an empty one and a destination into a
+ * free one, and the write after it drops what was there. The parent's listing is a
+ * second, independent witness: an entry it names is there, and the probe's answer
+ * was a fault — except a link under a probe that follows links (a read), which
+ * sees through it to a target that really is missing. An `lstat` sees the link
+ * itself, so for it a listed link is a fault like any entry.
+ */
+import { type FsFaultContext, type SideOfPath } from './fs-fault.js';
+/**
+ * The caller's action for a confirmation's fault, with no side of its own: the side is
+ * `sideOf(<the path refused>)` — the listed parent's for a refused listing, the entry's for a
+ * contradicted probe — never the side of the question the probe was answering.
+ */
+export type ConfirmationContext = Omit<FsFaultContext, 'side'> & {
+    readonly side?: never;
+};
+/** How the probe that said "absent" looked, and whose each path it may touch is. */
+export interface ConfirmationProbe {
+    /** Whether the probe followed a link (a read, a `stat`) or saw it (`lstat`). */
+    readonly follows: boolean;
+    /** The side of each path: the entry, and the parent whose listing is the second witness. */
+    readonly sideOf: SideOfPath;
+}
+/**
+ * Confirm that nothing is at `entry` after a probe of it said "absent".
+ *
+ * @param entry - The path the probe examined
+ * @param absent - What the probe threw (`ENOENT` / `ENOTDIR`)
+ * @param ctx - The caller's action, for the fault
+ * @param probe - How the probe looked, and the side of each path it may charge
+ * @throws the probe's own error classified on `sideOf(entry)` (naming `entry`) when the parent
+ *   lists it (a link only to a probe that does not follow); the listing's error classified on
+ *   `sideOf(parent)` when the parent is there but cannot be listed — absence was never shown
+ */
+export declare function requireConfirmedAbsent(entry: string, absent: unknown, ctx: ConfirmationContext, probe: ConfirmationProbe): void;
+//# sourceMappingURL=confirmed-absent.d.ts.map

package/dist/errors/confirmed-absent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmed-absent.d.ts","sourceRoot":"","sources":["../../src/errors/confirmed-absent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAmB,KAAK,cAAc,EAAiB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAErG;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE3F,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAW/H"}