@any-nav/scan 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## 0.2.0 — 2026-10-31
+
+- The walk engine is delegated to `@catheadowl/pathscope` (facade
+  transition): `walkScope` answers "which files are in scope" — the
+  gitignore cascade (now inherited above the scan root, git-native), the
+  mounted exclusion floor, the dot category, boundary stones — while every
+  Markdown-shaped concern (the tree, the maxFiles budget and its fact-safe
+  cut, pruning, description chains) stays here. Public API and behavior
+  stand; the delegation ends the package split's zero-dependency premise —
+  `@catheadowl/pathscope` (^0.1.1) is now the package's one runtime
+  dependency.
+- Accepted semantic increments with the delegation: the default floor now
+  also excludes `vendor/` and `coverage/` (engine presets; a `.gitignore`
+  negation naming the directory is the exit key), gitignore inheritance
+  reaches above the scan root, a subtree carrying its own `.git` is foreign
+  territory (truncated whole; `boundaryExempt` registers named subtrees
+  back in, below), and `unreadable-directory` diagnostics are gone
+  (unreadable directories are skipped engine-side). A narrowed terminal
+  floor keeps exact name semantics — nothing is force-mounted.
+- `boundaryExempt`: `[scan]` and `ScanConfig` gain the named-subtree
+  core-stone exemption key — gitignore-style patterns anchored at the scan
+  root (e.g. `deepseek-harness/`) naming subtrees whose own nested `.git`
+  no longer cuts them from the view, passed verbatim to the engine's
+  `boundaryStones.exempt` (git's submodule-registration face: the subtree
+  descends as a native subtree with its nested `.gitignore` rules honored,
+  deeper embedded repos inside it still cut, registration is not rescue).
+  `ResolvedScanOptions.boundaryExempt?` is an optional field —
+  pre-existing terminal callers compile unchanged, and the default
+  behavior is byte-identical (no exemptions).
+- The in-package gitignore engine (`gitignore.ts` and the
+  traversal-boundary family exports `GitignoreRule`,
+  `readInheritedGitignoreRules`, `readGitignoreRules`, `isGitignored`) is
+  removed outright, no deprecation window — breaking: after the delegation
+  it had zero importing consumers, and its fixture corpus has already been
+  absorbed into the shared engine's conformance suite. If a "read boundary
+  rules without a scan" consumption form ever materializes, the right home
+  is a public `@catheadowl/pathscope` API, not a private engine copy
+  inside a consumer.
+- Folder descriptions now read standardized carriers in descending order
+  of standardization: the directory's own `package.json` `description`
+  first, then its `manifest.yml` `metadata.description`, else its own
+  `README.md` as before. Per stage, present-but-empty or key-less falls
+  through to the next; an unreadable or invalid carrier fires the
+  maintainer diagnostic `description-carrier-unreadable` and falls
+  through the same way. The carriers are never Markdown, so they never
+  enter the tree or consume the maxFiles budget. Export face:
+  `DIR_SIDECAR_NAMES` / `isDirSidecarName` become
+  `DIR_DESCRIPTION_CARRIERS` / `isDirDescriptionCarrier` — breaking for
+  direct importers of the renamed exports.
+- `NavNode.markdown`: dir nodes, root included, carry the representative
+  README child's POSIX-relative path, present iff that README is in the
+  tree — consumers read a folder's front page without re-deriving which
+  child is the README.
+- `scan.ts` is split into its four identifiable responsibilities:
+  `engine-mapping.ts` (the options/preset mapping and the walkScope
+  bridge), `tree-replay.ts` (the name-sorted DFS replay with pruning and
+  the fact-safe-cut chain), `budget.ts` (the maxFiles state shape and cut
+  diagnostics), and `hydration.ts` (the bounded read pipeline and the
+  description-provider face), while `scan.ts` keeps the dual entry points
+  and their output faces. Pure internal move — the public API and the
+  byte-level replay promises are untouched.
+
 ## 0.1.0 — 2026-10-21
 
 First registry release: the zero-dependency scan engine, split out of

package/README.md

@@ -1,14 +1,17 @@
 # @any-nav/scan
 
-> Walk any Markdown folder into a navigation tree. Zero npm dependencies.
+> Walk any Markdown folder into a navigation tree.
 
 `@any-nav/scan` is the lean scan engine behind Any-Nav: it reads a folder of
 Markdown files and produces a navigation tree — names, one-line descriptions,
 and file locators — ready for listings, indexes, and agent navigation
-surfaces. This package exists so embedders who only need the engine carry
-nothing else: no TOML parser, no search index, no SDK. The full SDK (config,
-budget guard, rendering, query) lives in `@any-nav/core`, which composes and
-re-exports this package's full face.
+surfaces. The walk's scope resolution — gitignore cascade, exclusion floors,
+the dot category, boundary stones — is delegated to
+[`@catheadowl/pathscope`](https://www.npmjs.com/package/@catheadowl/pathscope)
+(one runtime dependency); everything Markdown-shaped — the tree, the budget,
+pruning, description chains — lives here. The full SDK (config, budget guard,
+rendering, query) lives in `@any-nav/core`, which composes and re-exports
+this package's full face.
 
 ## Install
 
@@ -64,10 +67,20 @@ read, at a fraction of the bytes.
 
 - **Additive exclusions** — `excludeDirs` / `excludeFiles` append to an
   always-on built-in floor (e.g. `AGENTS.md`, `CLAUDE.md`, `node_modules`,
-  `dist`); stating one never drops the defaults. Dot entries are skipped by
-  default. Empty directories are pruned from the tree.
+  `dist`, and — with the engine delegation — `vendor` and `coverage`); stating
+  one never drops the defaults. Dot entries are skipped by default. Empty
+  directories are pruned from the tree.
 - **gitignore inheritance** — `respectGitignore` (default on): traversal
-  honors `.gitignore` rules from the scan root down.
+  honors the `.gitignore` cascade, nested files and the chain above the scan
+  root alike (git-native; the exit key for a floor entry is naming it in a
+  `.gitignore` negation, e.g. `!vendor/`).
+- **Registered subtrees** — `boundaryExempt`: gitignore-style patterns
+  anchored at the scan root (e.g. `deepseek-harness/`) naming subtrees whose
+  own nested `.git` no longer cuts them from this view — git's
+  submodule-registration face (an unregistered embedded repo is foreign
+  territory; a registered one participates). Registration is not rescue:
+  the subtree still passes every exclusion floor, and deeper embedded
+  repositories inside it still cut. Default: none.
 - **A loud budget** — `maxFiles` (default 2000) caps markdown entries per
   source walk; hitting the cap fires diagnostics, never a silent truncation:
   folders whose descent was cut carry floor counts (`countIncompletePaths`
@@ -81,19 +94,33 @@ read, at a fraction of the bytes.
   walks emit them per hydrated file, so a lazy view warns about the rows it
   renders).
 - **Folder descriptions** — a directory describes itself via its
-  `_category_.yml` / `.yaml` / `.json` sidecar's `description` key, else via
-  the same extraction over its own `README.md`.
+  standardized carriers in order: its `package.json` `description`, else
+  its `manifest.yml` `metadata.description`, else the same extraction over
+  its own `README.md`; an unreadable or invalid carrier fires a
+  `description-carrier-unreadable` diagnostic and falls through.
+- **Representative README locator** — dir nodes carry `markdown`, the
+  POSIX-relative path of the folder's representative `README.md`; present
+  iff that README is a node in the tree (file nodes never carry it).
 - **Read-only** — scanning never modifies source files. The map is not the
   territory.
 
 ## Boundaries this package keeps
 
-- Zero runtime dependencies beyond Node builtins — the install closure is
-  this package alone.
+- One runtime dependency by ruling — `@catheadowl/pathscope`, the shared
+  file-scope engine the walk delegates to; nothing else may join it.
 - `ResolvedScanOptions` is terminal: callers hand the scanner final values;
   `resolveScanOptions` is an additive default floor, not an obligation.
 - `DescriptionProvider` is a port — the built-in chain is the default; a
   custom provider (e.g. an LLM-backed one) plugs into the same interface.
+- API shell policy: the public surface exports what real
+  consumption forms need — someone importing today, a local fork being the
+  unwired equivalent — and never speculative breadth; each future export
+  passes a light ruling first. The former traversal-boundary family
+  (`GitignoreRule`, `readInheritedGitignoreRules`, `readGitignoreRules`,
+  `isGitignored`) was removed with the in-package engine it belonged to: it
+  had no importing consumer, and reading boundary rules without a scan is
+  engine territory — the right home is a future `@catheadowl/pathscope`
+  API, not this package.
 
 ## License
 

package/dist/budget.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Budget cut — the nav-denominated maxFiles replay layer: the budget's
+ * unit is a TREE ENTRY and its
+ * arithmetic stays synchronous inside the replay (that is what keeps the cut
+ * point identical to the serial walk), so this module owns the shared state
+ * shape and the diagnostic vocabulary of the fact-safe cut — a partial count
+ * must never present as the total.
+ */
+import type { ScanDiagnostic } from './types.ts';
+/**
+ * Shared mutable budget state (routes FileLimitState, ported): set when the
+ * maxFiles budget stops iteration while entries remain unexamined, so the
+ * caller reports the truncation loudly instead of silently dropping entries.
+ */
+export interface FileBudget {
+    files: number;
+    limitHit: boolean;
+}
+export declare function fileLimitDiagnostic(maxFiles: number): ScanDiagnostic;
+/**
+ * Per-row disclosure for one floor-count folder: the budget
+ * cut this folder's descent mid-way, so the count a view renders for it is
+ * a floor. Consumer audience — it is view fidelity, same class as
+ * file-limit-reached.
+ */
+export declare function countTruncatedDiagnostic(rel: string): ScanDiagnostic;

package/dist/budget.js

@@ -0,0 +1,25 @@
+export function fileLimitDiagnostic(maxFiles) {
+    return {
+        code: 'file-limit-reached',
+        severity: 'warning',
+        message: `Markdown file limit (${maxFiles}) reached while scanning; entries past the limit were not examined — folders whose descent was cut carry ≥ counts (a floor, not the total) and later folders are absent. Raise scan.maxFiles for the full tree.`,
+        path: '.',
+        audience: 'consumer',
+    };
+}
+/**
+ * Per-row disclosure for one floor-count folder: the budget
+ * cut this folder's descent mid-way, so the count a view renders for it is
+ * a floor. Consumer audience — it is view fidelity, same class as
+ * file-limit-reached.
+ */
+export function countTruncatedDiagnostic(rel) {
+    return {
+        code: 'count-truncated-at-limit',
+        severity: 'warning',
+        message: `The maxFiles budget cut this folder's descent short; its shown count is a floor (at least that many), and entries past the cut point are absent.`,
+        path: rel,
+        audience: 'consumer',
+    };
+}
+//# sourceMappingURL=budget.js.map

package/dist/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,wBAAwB,QAAQ,iNAAiN;QAC1P,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,UAAU;KACrB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,kJAAkJ;QAC3J,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,UAAU;KACrB,CAAC;AACJ,CAAC"}

package/dist/description.d.ts

@@ -1,8 +1,7 @@
 /**
- * One-line description extraction, ported verbatim from the routes module
- * (dsh-plugin-dev/extras/modules/routes/src/description.ts, ADR-0010:
- * absorption is porting — every boundary handling here is tuition already
- * paid on production corpora; do not "simplify" it).
+ * One-line description extraction, ported verbatim from the dsh-extras
+ * routes module (absorption is porting — every boundary handling here is
+ * tuition already paid on production corpora; do not "simplify" it).
  *
  * Priority: ① frontmatter `description:`, ② an explicit `description:` line
  * in the document head, ③ the first substantive body line as a fallback.
@@ -17,17 +16,29 @@ export declare const BODY_HEAD_LINE_LIMIT = 15;
  */
 export declare function extractDescription(content: string): string | null;
 /**
- * Directory sidecar read (2026-10-07): `_category_.yml/.yaml/.json` carry a
- * folder's description so release-face READMEs stay untouched. YAML reuses
- * the frontmatter ① key reader — the sidecar is frontmatter without the
- * document (an indented `link.description:` therefore reads too, covering
- * Docusaurus-shaped files for free); JSON parses properly and accepts the
- * top-level `description` or the Docusaurus `link.description` shape.
- * `{ description: null }` means the file carries no description key.
+ * Directory description carriers: the folder chain sources from standardized carriers in
+ * descending order of standardization — ① the directory's own npm
+ * `package.json` `description` (nearly always present by ecosystem
+ * discipline), ② its `manifest.yml` `metadata.description` (the
+ * manifest-authoring directory-contract gloss — optional by that contract,
+ * present-only). Present-but-empty or absent falls through to the next
+ * stage; neither fabricates a description. The README stage lives in
+ * tree-replay (the chain's tail, not a carrier).
  */
-export type SidecarRead = {
+export type CarrierRead = {
     description: string | null;
 } | {
     error: string;
 };
-export declare function extractSidecarDescription(fileName: string, content: string): SidecarRead;
+/** Carrier ①: proper JSON parse; a non-object payload is as broken as invalid JSON (npm itself cannot read it — maintainer-visible). */
+export declare function extractPackageJsonDescription(content: string): CarrierRead;
+/**
+ * Carrier ②: the `metadata.description` gloss under the `metadata:` block —
+ * the only description key the closed manifest v1 schema defines, so the
+ * scan is anchored to that parent (a stray top-level or sibling-block
+ * `description:` is not read). YAML reuses the frontmatter ① key reader over
+ * the block (its `decription` typo tolerance rides along; manifest faces
+ * have their own validator). Lenient by nature — never errors, a shape
+ * without the key reads as `{ description: null }`.
+ */
+export declare function extractManifestDescription(content: string): CarrierRead;

package/dist/description.js

@@ -1,8 +1,7 @@
 /**
- * One-line description extraction, ported verbatim from the routes module
- * (dsh-plugin-dev/extras/modules/routes/src/description.ts, ADR-0010:
- * absorption is porting — every boundary handling here is tuition already
- * paid on production corpora; do not "simplify" it).
+ * One-line description extraction, ported verbatim from the dsh-extras
+ * routes module (absorption is porting — every boundary handling here is
+ * tuition already paid on production corpora; do not "simplify" it).
  *
  * Priority: ① frontmatter `description:`, ② an explicit `description:` line
  * in the document head, ③ the first substantive body line as a fallback.
@@ -72,7 +71,7 @@ function isStructuralLine(line) {
     if (/^\d{1,3}\.\s/u.test(text))
         return true; // ordered list
     // table row / language-switch ("English | [中文]"); inline code spans are
-    // masked first — marked-up code is never table structure (ADR-0010 U8)
+    // masked first — marked-up code is never table structure
     const outsideCodeSpans = text.replace(/`[^`]*`/gu, '');
     if (outsideCodeSpans.startsWith('|') || /\s\|\s/u.test(outsideCodeSpans))
         return true;
@@ -191,30 +190,50 @@ function stripHtmlComments(lines) {
     }
     return openLines;
 }
-export function extractSidecarDescription(fileName, content) {
-    if (fileName.toLowerCase().endsWith('.json')) {
-        let parsed;
-        try {
-            parsed = JSON.parse(content);
-        }
-        catch (err) {
-            return { error: `invalid JSON: ${err.message}` };
-        }
-        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
-            return { error: 'sidecar JSON must be an object' };
+/** Carrier ①: proper JSON parse; a non-object payload is as broken as invalid JSON (npm itself cannot read it — maintainer-visible). */
+export function extractPackageJsonDescription(content) {
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (err) {
+        return { error: `invalid JSON: ${err.message}` };
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        return { error: 'package.json must be a JSON object' };
+    }
+    const description = parsed.description;
+    return {
+        description: typeof description === 'string' && description.trim() !== '' ? description.trim() : null,
+    };
+}
+/**
+ * Carrier ②: the `metadata.description` gloss under the `metadata:` block —
+ * the only description key the closed manifest v1 schema defines, so the
+ * scan is anchored to that parent (a stray top-level or sibling-block
+ * `description:` is not read). YAML reuses the frontmatter ① key reader over
+ * the block (its `decription` typo tolerance rides along; manifest faces
+ * have their own validator). Lenient by nature — never errors, a shape
+ * without the key reads as `{ description: null }`.
+ */
+export function extractManifestDescription(content) {
+    const lines = content.split(/\r?\n/u);
+    const metadataIndex = lines.findIndex((line) => /^metadata:\s*$/u.test(line));
+    if (metadataIndex === -1)
+        return { description: null };
+    const block = [];
+    for (let index = metadataIndex + 1; index < lines.length; index++) {
+        const line = lines[index];
+        if (line.trim().length === 0) {
+            if (block.length > 0)
+                break;
+            continue;
         }
-        const obj = parsed;
-        const fromKey = (value) => typeof value === 'string' && value.trim() !== '' ? value.trim() : null;
-        const top = fromKey(obj.description);
-        if (top !== null)
-            return { description: top };
-        const link = typeof obj.link === 'object' && obj.link !== null && !Array.isArray(obj.link)
-            ? obj.link
-            : undefined;
-        const nested = link === undefined ? null : fromKey(link.description);
-        return { description: nested };
+        if (!/^\s+/u.test(line))
+            break; // dedent — the metadata block ended
+        block.push(line);
     }
-    return { description: readDescriptionKey(content.split(/\r?\n/u)) };
+    return { description: block.length > 0 ? readDescriptionKey(block) : null };
 }
 function parseYamlLikeFrontmatter(content) {
     const lines = content.split(/\r?\n/u);

package/dist/description.js.map

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

package/dist/engine-mapping.d.ts

@@ -0,0 +1,48 @@
+import type { ScanConfig } from './types.ts';
+/**
+ * Agent-instruction files harnesses load on their own; they carry no
+ * navigation value (the agent already has them) so they never appear in
+ * navigation (routes DEFAULT_EXCLUDE_FILES, ported).
+ */
+export declare const DEFAULT_EXCLUDE_FILES: readonly string[];
+/** routes DEFAULT_EXCLUDE_DIRS, ported verbatim. Always on (the safety
+ * floor); user excludeDirs entries append to it, never replace it — a
+ * generate-era 'any-nav' entry was retired with `list --write` (the
+ * materialization target is now any file the caller names). */
+export declare const DEFAULT_EXCLUDE_DIRS: readonly string[];
+export interface ResolvedScanOptions {
+    excludeDirs: readonly string[];
+    excludeFiles: readonly string[];
+    excludeDotEntries: boolean;
+    respectGitignore: boolean;
+    /**
+     * Named-subtree core-stone exemptions, passed verbatim to the
+     * engine's `boundaryStones.exempt`: gitignore-style patterns anchored at
+     * the scan root. Optional — absent means no exemptions (every embedded
+     * repo stays foreign territory, exactly as before the key existed); the
+     * field stays optional so pre-existing terminal callers keep compiling.
+     */
+    boundaryExempt?: readonly string[];
+    maxFiles: number;
+}
+export declare function resolveScanOptions(config?: ScanConfig): ResolvedScanOptions;
+/** One trie level over the engine's in-scope set: files sit at their direct
+ * parent, directory segments carry the levels beneath them. Only levels with
+ * in-scope content exist — an empty directory (or one whose content is all
+ * out of scope) never enters the trie, which is the empty-directory pruning
+ * the old walk computed by hand. */
+export interface ScopeLevel {
+    files: Set<string>;
+    dirs: Map<string, ScopeLevel>;
+}
+/**
+ * The one engine query — "which files are in scope". Unbounded on purpose: the
+ * budget's unit is a TREE ENTRY (a Markdown file surviving the consumer
+ * filters), so the engine's raw-file budget never fires here and the
+ * replay below owns the fact-safe cut, its ordering, and its diagnostics.
+ * (Engine diagnostics beyond the budget do not exist in 0.1.0.)
+ * boundaryExempt rides boundaryStones.exempt verbatim: naming a
+ * subtree registers its participation — its own .git no longer cuts it,
+ * while deeper embedded repos inside it and un-named siblings keep the cut.
+ */
+export declare function scopeLevels(root: string, opts: ResolvedScanOptions): Promise<ScopeLevel>;

package/dist/engine-mapping.js

@@ -0,0 +1,127 @@
+/**
+ * Engine mapping face — everything crossing the boundary into
+ * @catheadowl/pathscope (the facade face): the
+ * resolved-options face (the additive default floor), the preset mounts, the
+ * policy-channel patterns, the walkScope query itself, and the scope trie the
+ * replay descends. "Which files are in scope" is the engine's question; the
+ * Markdown layer that turns the scope into a tree lives in tree-replay.ts.
+ */
+import { walkScope } from '@catheadowl/pathscope';
+/**
+ * Agent-instruction files harnesses load on their own; they carry no
+ * navigation value (the agent already has them) so they never appear in
+ * navigation (routes DEFAULT_EXCLUDE_FILES, ported).
+ */
+export const DEFAULT_EXCLUDE_FILES = ['AGENTS.md', 'CLAUDE.md'];
+/** routes DEFAULT_EXCLUDE_DIRS, ported verbatim. Always on (the safety
+ * floor); user excludeDirs entries append to it, never replace it — a
+ * generate-era 'any-nav' entry was retired with `list --write` (the
+ * materialization target is now any file the caller names). */
+export const DEFAULT_EXCLUDE_DIRS = [
+    '.git',
+    '.hg',
+    '.svn',
+    'node_modules',
+    '.pnpm',
+    'dist',
+    'build',
+    'lib',
+    'out',
+];
+export function resolveScanOptions(config) {
+    // Additive ruling: the built-in tables are the
+    // always-on floor, user entries append — "the file states only exceptions"
+    // must not mean restating the defaults to add one. Duplicates are harmless
+    // (membership checks only), so a plain concat stays honest. boundaryExempt
+    // has no floor to append to — an absent key means no exemptions.
+    return {
+        excludeDirs: [...DEFAULT_EXCLUDE_DIRS, ...(config?.excludeDirs ?? [])],
+        excludeFiles: [...DEFAULT_EXCLUDE_FILES, ...(config?.excludeFiles ?? [])],
+        excludeDotEntries: config?.excludeDotEntries ?? true,
+        respectGitignore: config?.respectGitignore ?? true,
+        boundaryExempt: config?.boundaryExempt ?? [],
+        maxFiles: config?.maxFiles ?? 2000,
+    };
+}
+/**
+ * The engine-mounted exclusion floor: when the caller resolved
+ * the built-in floor (resolveScanOptions output, or an equivalent terminal
+ * list), its dir table rides the engine's preset form — vcs/deps/build carry
+ * the old nine-entry DEFAULT_EXCLUDE_DIRS table plus vendor/ and coverage/
+ * (the accepted preset increment) — and agentDocs carries the built-in
+ * AGENTS.md/CLAUDE.md file exclusion. A terminal caller that narrowed the
+ * floor (BASE_SCAN-style excludeDirs: []) keeps exact name semantics via
+ * the policy channel and the replay's literal check: nothing is
+ * force-mounted. (The preset increment is negatable by a repo's .gitignore
+ * — engine front-seat semantics; the floor names on the policy channel are
+ * not, exactly as before.)
+ */
+function engineMounts(opts) {
+    const mounts = [];
+    if (DEFAULT_EXCLUDE_DIRS.every((name) => opts.excludeDirs.includes(name))) {
+        mounts.push('vcs', 'deps', 'build');
+    }
+    if (DEFAULT_EXCLUDE_FILES.every((name) => opts.excludeFiles.includes(name))) {
+        mounts.push('agentDocs');
+    }
+    return mounts;
+}
+/**
+ * The resolved excludeDirs ride the engine's policy channel as dir-only
+ * patterns at the rear seat of the rule table — exactly the old floor's
+ * independence from gitignore (a repo's `!node_modules/` cannot resurrect a
+ * floor entry). Entries that are not plain names (separators, globs, a
+ * leading '!') stay out of the channel: the old engine compared directory
+ * names by literal equality, and those entries keep that semantics in the
+ * replay instead of acquiring pattern meaning.
+ */
+function excludeChannelPatterns(excludeDirs) {
+    return excludeDirs
+        .filter((name) => /^[^/\\!*?[\]!#]+$/u.test(name))
+        .map((name) => `${name}/`);
+}
+function buildScopeLevel(paths) {
+    const root = { files: new Set(), dirs: new Map() };
+    for (const path of paths) {
+        const segments = path.split('/');
+        let level = root;
+        for (let index = 0; index < segments.length - 1; index += 1) {
+            const segment = segments[index];
+            if (segment === undefined)
+                continue;
+            let child = level.dirs.get(segment);
+            if (child === undefined) {
+                child = { files: new Set(), dirs: new Map() };
+                level.dirs.set(segment, child);
+            }
+            level = child;
+        }
+        const file = segments[segments.length - 1];
+        if (file !== undefined && file !== '')
+            level.files.add(file);
+    }
+    return root;
+}
+/**
+ * The one engine query — "which files are in scope". Unbounded on purpose: the
+ * budget's unit is a TREE ENTRY (a Markdown file surviving the consumer
+ * filters), so the engine's raw-file budget never fires here and the
+ * replay below owns the fact-safe cut, its ordering, and its diagnostics.
+ * (Engine diagnostics beyond the budget do not exist in 0.1.0.)
+ * boundaryExempt rides boundaryStones.exempt verbatim: naming a
+ * subtree registers its participation — its own .git no longer cuts it,
+ * while deeper embedded repos inside it and un-named siblings keep the cut.
+ */
+export async function scopeLevels(root, opts) {
+    const boundaryExempt = opts.boundaryExempt ?? [];
+    const scope = await walkScope(root, {
+        mountPresets: engineMounts(opts),
+        exclude: excludeChannelPatterns(opts.excludeDirs),
+        excludeDotEntries: opts.excludeDotEntries,
+        respectGitignore: opts.respectGitignore,
+        ...(boundaryExempt.length > 0 ? { boundaryStones: { exempt: [...boundaryExempt] } } : {}),
+        maxFiles: Number.MAX_SAFE_INTEGER,
+    });
+    return buildScopeLevel(scope.files);
+}
+//# sourceMappingURL=engine-mapping.js.map

package/dist/engine-mapping.js.map

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

package/dist/hydration.d.ts

@@ -0,0 +1,49 @@
+import type { NavItem, NavNode, ScanDiagnostic } from './types.ts';
+export interface ScannedFile {
+    path: string;
+    content: string;
+}
+/** Port: built-in chain is the ported routes extraction; LLM providers arrive in v1.x. */
+export interface DescriptionProvider {
+    extract(file: ScannedFile): Promise<string | null>;
+}
+export declare const builtinDescriptionProvider: DescriptionProvider;
+/** One started read awaiting its settle: item attaches blank at kick-off,
+ * the description lands at the settle. */
+export interface PendingRead {
+    rel: string;
+    content: Promise<string | null>;
+    item: NavItem;
+}
+/** Walk-order diagnostic events: directory diagnostics record where they
+ * fired; file events settle at the drain — the flattened order equals the
+ * serial walk's emission order. Structure walks emit diag events only. */
+export type DiagnosticEvent = {
+    kind: 'diag';
+    diagnostic: ScanDiagnostic;
+} | {
+    kind: 'file';
+    read: PendingRead;
+};
+/** Structure-walk file record: the node exists without an item; describe()
+ * attaches the item after extraction. */
+export interface FileRecord {
+    rel: string;
+    abs: string;
+    node: NavNode;
+}
+/** Bounded in-flight read window: kicks never reject (read errors resolve
+ * null — the unreadable-file path), and the gate waits for the next settle
+ * before kicking past the ceiling. gate() then start() keeps the started
+ * promise unwrapped for fire-and-continue callers. */
+export declare class BoundedReads {
+    private readonly pending;
+    /** Wait for a window slot (no-op while under the ceiling). */
+    gate(): Promise<void>;
+    /** Start one read and return its still-running promise. */
+    start(abs: string): Promise<string | null>;
+}
+/** Settle one started read: the description lands on the item and any
+ * per-file diagnostic (unreadable-file / no-description placeholder) goes
+ * to the sink at the caller's position. */
+export declare function settleDescription(read: PendingRead, provider: DescriptionProvider, sink: ScanDiagnostic[]): Promise<void>;