@any-nav/core 0.1.0 → 0.2.0

package/dist/search-engine.js

@@ -1,18 +1,36 @@
 /**
- * Search engine seam + fast-bm25 adapter (TODO bm25-engine-port, ruling
- * architecture §12 #4). Ported from sparse-retrieve's bm25 layer
- * (src/bm25/engine.ts + fast-bm25-engine.ts + the search-text assembly
- * discipline of src/tools/tool_search.ts); interface adapted to NavItem,
- * semantics unchanged.
+ * Search face: engine seam + fast-bm25 adapter + index assembly. The engine
+ * seam (TODO bm25-engine-port, ruling architecture §12 #4) was ported from
+ * sparse-retrieve's bm25 layer (src/bm25/engine.ts + fast-bm25-engine.ts +
+ * the search-text assembly discipline of src/tools/tool_search.ts);
+ * interface adapted to NavItem, semantics unchanged.
  *
- * The seam keeps the ranking engine swappable: search() returns document
- * indexes scored for ordering only — mapping back to NavItems is the
- * consumer's (buildSearchIndex) job. v1 recall matches English metadata
- * only (init ruling 2026-10-02): the package tokenizer splits on whitespace
- * and punctuation, so unsegmented CJK runs do not match shorter queries —
- * Chinese metadata missing English-query hits is stance, not a gap.
+ * Load isolation (2026-10-23): fast-bm25 is loaded synchronously on first
+ * engine construction, never at module load — importing @any-nav/core (or
+ * any of its list/read faces) costs zero engine load; only the first search
+ * pays it. The sync hop rides require() over the package's CJS build
+ * (dual-format ship), so the sync signatures stay sync.
+ *
+ * v1 recall matches English metadata only (init ruling 2026-10-02): the
+ * package tokenizer splits on whitespace and punctuation, so unsegmented
+ * CJK runs do not match shorter queries — Chinese metadata missing
+ * English-query hits is stance, not a gap.
  */
-import { BM25 } from 'fast-bm25';
+import { createRequire } from 'node:module';
+// Lazy sync loader: module-load-time cost of fast-bm25 is deferred to the
+// first FastBm25Engine construction (the first search), keeping every
+// non-search entry — CLI list / list --json / dsh nav — off the engine.
+const requireCjs = createRequire(import.meta.url);
+let bm25Ctor;
+const loadBm25 = () => (bm25Ctor ??= requireCjs('fast-bm25').BM25);
+// Seam-level decisions (TODO bm25-engine-port): fast-bm25 requires an
+// explicit topK, so an unset limit defaults to 20; k1/b are passed
+// explicitly — package defaults stay out of our ranking contract — keeping
+// the in-service values the self-implemented engine used. Exported so
+// adapter-facing descriptions of `limit` stay in sync with the behavior.
+export const DEFAULT_SEARCH_LIMIT = 20;
+const BM25_K1 = 1.5;
+const BM25_B = 0.75;
 /**
  * fast-bm25 adapter over one pool of search texts; document id = array
  * index. An empty corpus degenerates to an always-empty engine — the
@@ -24,7 +42,7 @@ export class FastBm25Engine {
         this.bm25 =
             searchTexts.length === 0
                 ? null
-                : new BM25(searchTexts.map((content) => ({ content })), { stemming: true, ...options });
+                : new (loadBm25())(searchTexts.map((content) => ({ content })), { stemming: true, ...options });
     }
     search(query, limit) {
         return this.bm25 ? this.bm25.search(query, limit) : [];
@@ -51,4 +69,35 @@ export function navSearchText(item) {
     push(item.locator.path);
     return parts.join(' ');
 }
+/**
+ * One search pool over the scanned sources' file items (buildSearchIndex:
+ * engine assembly + hit mapping, moved here from query.ts 2026-10-23 so the
+ * non-search faces never load fast-bm25). The index is a snapshot; freshness
+ * is the caller's rebuild policy.
+ */
+export function buildSearchIndex(sources) {
+    const entries = [];
+    const visit = (nodes) => {
+        for (const node of nodes ?? []) {
+            if (node.kind === 'file' && node.item)
+                entries.push({ item: node.item });
+            else
+                visit(node.children);
+        }
+    };
+    for (const source of sources)
+        visit(source.tree.children);
+    // One pool over all sources (nav retirement: the config root is the
+    // single source; per-source scoping lost its selector).
+    const engine = new FastBm25Engine(entries.map((entry) => navSearchText(entry.item)), { k1: BM25_K1, b: BM25_B });
+    return {
+        search({ text, limit }) {
+            const top = Math.max(0, limit ?? DEFAULT_SEARCH_LIMIT);
+            return engine.search(text, top).map(({ index, score }) => {
+                const item = entries[index].item;
+                return { item, score, snippet: item.description.slice(0, 100) };
+            });
+        },
+    };
+}
 //# sourceMappingURL=search-engine.js.map

package/dist/search-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-engine.js","sourceRoot":"","sources":["../src/search-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAyBjC;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACR,IAAI,CAAc;IAEnC,YAAY,WAAqB,EAAE,OAAO,GAAoB,EAAE;QAC9D,IAAI,CAAC,IAAI;YACP,WAAW,CAAC,MAAM,KAAK,CAAC;gBACtB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,IAAI,IAAI,CACN,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAC3C,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAC/B,CAAC;IACV,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,KAAa;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,IAAwB,EAAQ,EAAE;QAC9C,MAAM,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"search-engine.js","sourceRoot":"","sources":["../src/search-engine.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -15,9 +15,10 @@ export type { DiagnosticAudience, NavItem, NavLocator, NavLocatorKind, NavNode,
  * the SDK (routes ported + core additions): scan-root-not-found /
  * scan-root-is-file / scan-root-unsupported / unreadable-directory /
  * unreadable-file / file-limit-reached / count-truncated-at-limit (per-row
- * floor-count disclosure, ADR-0010 U12) / no-description (core placeholder) /
- * sidecar-unreadable (directory description sidecar) / route-rows-truncated
- * (view-level breadth guard, framework decision 9) / expand-path-missing
+ * floor-count disclosure) / no-description (core placeholder) /
+ * description-carrier-unreadable (folder description carrier — package.json /
+ * manifest.yml) / route-rows-truncated
+ * (view-level breadth guard) / expand-path-missing
  * (local list) / section-trimmed-to-budget (write-face guard: marker
  * branches collapsed first, then lines trimmed — budget-guard unit; carries
  * face: 'write', so it surfaces only where the write artifact is produced).
@@ -28,7 +29,7 @@ export type { DiagnosticAudience, NavItem, NavLocator, NavLocatorKind, NavNode,
  * count-truncated-at-limit / route-rows-truncated / fragment-over-budget /
  * scan-root-* / candidate-feed-*): travels in consumer payloads as the
  * single signal. 'maintainer' — corpus quality or config someone must fix
- * (no-description / unreadable-* / sidecar-unreadable /
+ * (no-description / unreadable-* / description-carrier-unreadable /
  * expand-path-missing): maintainer side-channel only (CLI stderr); agent
  * faces stay silent. New codes must pick an audience — the envelope
  * burden account (specs/surface.md adapter obligations).
@@ -49,7 +50,7 @@ export interface FragmentNode {
     description?: string;
     /** Folder only: recursive .md count under it (what expansion would list). */
     below?: number;
-    /** Folder only: present when the maxFiles budget cut the descent — `below` is a floor (renders ≥N, U12). */
+    /** Folder only: present when the maxFiles budget cut the descent — `below` is a floor (renders ≥N). */
     countIncomplete?: true;
     /** Folder only: curated children — present iff the folder is a local member. */
     children?: FragmentNode[];
@@ -102,7 +103,7 @@ export interface SearchHit {
     snippet?: string;
 }
 /**
- * Candidate-feed row (ADR-0012): one nav node as a word-picker candidate,
+ * Candidate-feed row: one nav node as a word-picker candidate,
  * paths re-rooted onto the query's baseDir. Pure data by contract — the
  * feed crosses plugin seams as a structural mirror, never shared type
  * instances (no classes, functions, Date, Map).
@@ -114,7 +115,7 @@ export interface NavCandidate {
     /** Present when a real description exists; placeholders are omitted. */
     description?: string;
 }
-/** Candidate feed (ADR-0012): the whole curated tree, flattened for matchers. */
+/** Candidate feed: the whole curated tree, flattened for matchers. */
 export interface NavCandidateFeed {
     /** Provenance header: source config path + resolved absolute root, config order. */
     sources: {
@@ -145,18 +146,18 @@ export interface NavSource {
     root: string;
     tree: NavNode;
     itemCount: number;
-    /** Non-fatal scan warnings (structured; vocabulary per ADR-0010). */
+    /** Non-fatal scan warnings (structured). */
     diagnostics: ScanDiagnostic[];
     /**
-     * Dir paths whose descent the maxFiles budget cut short (scan-walk fact,
-     * ADR-0010 U12): folder rows under these paths render floor (≥) counts —
+     * Dir paths whose descent the maxFiles budget cut short (scan-walk
+     * fact): folder rows under these paths render floor (≥) counts —
      * a lens fact on the source envelope, never on the scan-domain NavNode
      * (decision 2). Absent when no cut happened.
      */
     countIncompletePaths?: readonly string[];
 }
 /**
- * Routing-view node (ADR-0010: the view projection superset — truncated
+ * Routing-view node (the view projection superset — truncated
  * markers live here, never on the scan-domain NavNode). A node is
  * structural-only when it carries children but no markdown/kind/description:
  * the path leading to real entries; flat output skips it (the index face's
@@ -176,15 +177,15 @@ export interface RouteViewNode {
      * consumers may rely on it as negative evidence: expansion lists exactly
      * N entries, and content the policy excludes never counts.
      *
-     * The commitment holds for completed walks only: present (U12,
-     * count-truncated-at-limit) when the scan.maxFiles budget cut this
+     * The commitment holds for completed walks only: present
+     * (count-truncated-at-limit) when the scan.maxFiles budget cut this
      * folder's descent — the count is then a floor (rows render ≥N, at least
      * N, possibly more).
      */
     omittedMarkdownCount?: number;
     /**
      * Present iff this truncated folder sits on the maxFiles cut chain: its
-     * omittedMarkdownCount is a floor, not the total (U12 fact-safe cut).
+     * omittedMarkdownCount is a floor, not the total (fact-safe cut).
      * Rides the JSON face verbatim (additive, presence-only).
      */
     countIncomplete?: true;

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@any-nav/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Any-Nav SDK: read-only core that scans Markdown folders into navigation, decides exposure within a context budget, renders injection fragments, and answers list/search/read. Adapters own all writes, processes, and protocols.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CatheadOwl/any-nav.git"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,7 +15,8 @@
     "CHANGELOG.md"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": false
   },
   "keywords": [
     "agent",
@@ -20,7 +25,7 @@
     "context"
   ],
   "dependencies": {
-    "@any-nav/scan": "0.1.0",
+    "@any-nav/scan": "0.2.0",
     "fast-bm25": "^0.0.6",
     "smol-toml": "^1.9.0"
   },

package/dist/bindings.d.ts

@@ -1,10 +0,0 @@
-/**
- * Bindings: passive-push declarations (mode ④).
- *
- * Interface only — the harness extracts paths from prompts and tool
- * calls and calls resolve(); core never triggers. Glob support is a
- * small in-house matcher (** across separators, * and ? within one).
- */
-import type { NavSource, PushResolution } from './types.ts';
-export declare function globToRegExp(pattern: string): RegExp;
-export declare function resolvePush(sources: NavSource[], path: string): PushResolution;

package/dist/bindings.js

@@ -1,51 +0,0 @@
-export function globToRegExp(pattern) {
-    const segments = pattern.replace(/\\/g, '/').split('/');
-    let source = '';
-    for (let i = 0; i < segments.length; i++) {
-        const segment = segments[i];
-        const isLast = i === segments.length - 1;
-        if (segment === '**') {
-            // Trailing ** matches any tail; mid-pattern ** matches whole directories.
-            source += isLast ? '.*' : '(?:.*/)?';
-            continue;
-        }
-        source += segment
-            .split('')
-            .map((ch) => (ch === '*' ? '[^/]*' : ch === '?' ? '[^/]' : escapeRegExp(ch)))
-            .join('');
-        if (!isLast)
-            source += '/';
-    }
-    return new RegExp(`^${source}$`);
-}
-export function resolvePush(sources, path) {
-    const normalized = path.replace(/\\/g, '/').replace(/^\.\//, '').replace(/^\/+/, '');
-    const items = [];
-    for (const source of sources) {
-        for (const binding of source.config.bind ?? []) {
-            if (!globToRegExp(binding.match).test(normalized))
-                continue;
-            for (const itemPath of binding.items) {
-                const item = findItem(source.tree, itemPath.replace(/\\/g, '/').replace(/^\.\//, ''));
-                if (item !== null)
-                    items.push(item);
-            }
-        }
-    }
-    return { matched: items.length > 0, items };
-}
-function findItem(tree, relPath) {
-    const segments = relPath.split('/').filter((s) => s !== '');
-    let node = tree;
-    for (const segment of segments) {
-        const next = node.children?.find((c) => c.name === segment || (c.kind === 'file' && `${c.name}.md` === segment.toLowerCase()));
-        if (!next)
-            return null;
-        node = next;
-    }
-    return node.kind === 'file' ? node.item ?? null : null;
-}
-function escapeRegExp(ch) {
-    return /[.*+?^${}()|[\]\\]/.test(ch) ? `\\${ch}` : ch;
-}
-//# sourceMappingURL=bindings.js.map

package/dist/bindings.js.map

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

package/dist/description.d.ts

@@ -1,31 +0,0 @@
-/**
- * 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).
- *
- * Priority: ① frontmatter `description:`, ② an explicit `description:` line
- * in the document head, ③ the first substantive body line as a fallback.
- * Returns null when none match.
- */
-/**
- * Extracts a one-line route description from Markdown, in priority order:
- * ① frontmatter `description:`, ② an explicit `description:` line in the document
- * head, ③ the first substantive body line as a fallback. Returns `null` when none match.
- */
-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.
- */
-export type SidecarRead = {
-    description: string | null;
-} | {
-    error: string;
-};
-export declare function extractSidecarDescription(fileName: string, content: string): SidecarRead;

package/dist/description.js

@@ -1,273 +0,0 @@
-/**
- * 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).
- *
- * Priority: ① frontmatter `description:`, ② an explicit `description:` line
- * in the document head, ③ the first substantive body line as a fallback.
- * Returns null when none match.
- */
-/** Body-line description lookup only trusts the document head, so a `description:` inside a code block or deep in the prose cannot hijack the route. */
-const BODY_HEAD_LINE_LIMIT = 15;
-/** Minimum code-point length for a body line to count as a substantive first sentence (fallback ③). Word count is avoided because CJK text has no space tokenization. */
-const MIN_SUBSTANTIVE_LENGTH = 20;
-/** Approximate cap (code points) for a fallback description; longer lines are cut at the last sentence boundary inside the cap. */
-const MAX_DESCRIPTION_CHARS = 120;
-const SENTENCE_ENDERS = ['.', '。', '!', '！', '?', '？', ';', '；'];
-/** Link or image, tolerating one level of nesting so a badge (`[![alt](img)](href)`) counts as a single token. */
-const LINK_OR_IMAGE = /!?\[(?:[^[\]]|\[[^\]]*\])*\]\([^)]*\)/gu;
-/**
- * Extracts a one-line route description from Markdown, in priority order:
- * ① frontmatter `description:`, ② an explicit `description:` line in the document
- * head, ③ the first substantive body line as a fallback. Returns `null` when none match.
- */
-export function extractDescription(content) {
-    const frontmatter = parseYamlLikeFrontmatter(content);
-    const frontmatterDescription = frontmatter
-        ? readDescriptionKey(frontmatter.split(/\r?\n/u))
-        : null;
-    if (frontmatterDescription)
-        return frontmatterDescription;
-    const body = frontmatter ? contentAfterFrontmatter(content) : content;
-    const openBodyLines = stripHtmlComments(stripCodeFences(body.split(/\r?\n/u))).slice(0, BODY_HEAD_LINE_LIMIT);
-    const bodyDescription = readDescriptionKey(openBodyLines);
-    if (bodyDescription)
-        return bodyDescription;
-    return firstSubstantiveLine(openBodyLines);
-}
-/** Fallback ③: the first body line that is prose (not Markdown structure) and long enough, cleaned of inline Markdown and capped. */
-function firstSubstantiveLine(lines) {
-    for (let index = 0; index < lines.length; index++) {
-        const line = lines[index];
-        if (isStructuralLine(line) || isSetextTitle(lines, index))
-            continue;
-        const cleaned = cleanInlineMarkdown(line);
-        if (codePointLength(cleaned) < MIN_SUBSTANTIVE_LENGTH)
-            continue;
-        return truncateDescription(cleaned);
-    }
-    return null;
-}
-/** A setext heading's title line sits directly above its `===`/`---` underline; skip the title, not just the underline. */
-function isSetextTitle(lines, index) {
-    if (index + 1 >= lines.length)
-        return false;
-    const trimmed = lines[index + 1].trim();
-    return trimmed.length > 0 && /^(={3,}|-{3,})\s*$/u.test(trimmed);
-}
-/** Structural Markdown lines never carry a description; they are skipped before the length test. */
-function isStructuralLine(line) {
-    const text = line.trim();
-    if (text.length === 0)
-        return true;
-    if (/^#{1,6}(\s|$)/u.test(text))
-        return true; // ATX heading
-    if (/^(={3,}|-{3,}|\*{3,}|_{3,})$/u.test(text))
-        return true; // setext underline / horizontal rule
-    if (/^>/u.test(text))
-        return true;
-    if (/^[-+*](\s|$)/u.test(text))
-        return true; // unordered list
-    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)
-    const outsideCodeSpans = text.replace(/`[^`]*`/gu, '');
-    if (outsideCodeSpans.startsWith('|') || /\s\|\s/u.test(outsideCodeSpans))
-        return true;
-    if (/^</u.test(text))
-        return true;
-    if (isLinkOnlyLine(text))
-        return true; // badge row / nav chrome
-    return false;
-}
-/** A line whose visible text is only links/images (badges, nav) carries no prose description. */
-function isLinkOnlyLine(text) {
-    return text.length > 0 && text.replace(LINK_OR_IMAGE, '').trim().length === 0;
-}
-/** Light inline-Markdown cleanup so a fallback line reads as plain prose. */
-function cleanInlineMarkdown(line) {
-    return line
-        .trim()
-        .replace(/!\[([^\]]*)\]\([^)]*\)/gu, '$1')
-        .replace(/\[([^\]]*)\]\([^)]*\)/gu, '$1')
-        .replace(/`([^`]*)`/gu, '$1')
-        .replace(/\*\*([^*]+)\*\*/gu, '$1')
-        .replace(/__([^_]+)__/gu, '$1')
-        .replace(/\s+/g, ' ')
-        .replace(/[：:]\s*$/u, '')
-        .trim();
-}
-/** Cut long fallback text at the last sentence boundary inside the cap; hard-cut (with a trailing `...`) when no boundary is deep enough. */
-function truncateDescription(text) {
-    if (codePointLength(text) <= MAX_DESCRIPTION_CHARS)
-        return text;
-    const head = [...text].slice(0, MAX_DESCRIPTION_CHARS).join('');
-    const boundary = lastSentenceBoundary(head);
-    if (boundary >= 0) {
-        const cut = head.slice(0, boundary + 1).trimEnd();
-        if (codePointLength(cut) >= MIN_SUBSTANTIVE_LENGTH)
-            return cut;
-    }
-    return head.trimEnd() + '...';
-}
-/** Last sentence ender inside `text`, skipping abbreviation dots (`ctx.`, `e.g.`). */
-function lastSentenceBoundary(text) {
-    for (let index = text.length - 1; index >= 0; index--) {
-        const char = text[index];
-        if (char === '.') {
-            if (isAbbreviationDot(text, index))
-                continue;
-            return index;
-        }
-        if (SENTENCE_ENDERS.includes(char))
-            return index;
-    }
-    return -1;
-}
-function isAbbreviationDot(text, index) {
-    let letters = 0;
-    for (let prev = index - 1; prev >= 0 && prev >= index - 3; prev--) {
-        if (/[a-z]/u.test(text[prev]))
-            letters++;
-        else
-            break;
-    }
-    if (letters === 0)
-        return false;
-    const next = index + 1 < text.length ? text[index + 1] : '';
-    return /[a-z,;):]/u.test(next);
-}
-function codePointLength(text) {
-    return [...text].length;
-}
-/** Drops fenced code blocks (```…``` and ~~~…~~~) so tool/program examples cannot leak `description:` matches. */
-function stripCodeFences(lines) {
-    const openLines = [];
-    let insideFence = false;
-    for (const line of lines) {
-        if (isFenceLine(line)) {
-            insideFence = !insideFence;
-            continue;
-        }
-        if (!insideFence)
-            openLines.push(line);
-    }
-    return openLines;
-}
-function isFenceLine(line) {
-    return /^\s*(`{3,}|~{3,})/u.test(line);
-}
-/** Drops HTML comments (`<!--`…`-->`, possibly multi-line) so generated/boilerplate comment text cannot become the description. */
-function stripHtmlComments(lines) {
-    const openLines = [];
-    let insideComment = false;
-    for (const line of lines) {
-        let rest = line;
-        let openPart = '';
-        while (rest.length > 0) {
-            if (!insideComment) {
-                const start = rest.indexOf('<!--');
-                if (start === -1) {
-                    openPart += rest;
-                    break;
-                }
-                openPart += rest.slice(0, start);
-                rest = rest.slice(start + 4);
-                insideComment = true;
-            }
-            else {
-                const end = rest.indexOf('-->');
-                if (end === -1) {
-                    rest = '';
-                    break;
-                }
-                rest = rest.slice(end + 3);
-                insideComment = false;
-            }
-        }
-        openLines.push(openPart);
-    }
-    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' };
-        }
-        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 };
-    }
-    return { description: readDescriptionKey(content.split(/\r?\n/u)) };
-}
-function parseYamlLikeFrontmatter(content) {
-    const lines = content.split(/\r?\n/u);
-    if (lines[0]?.trim() !== '---')
-        return null;
-    const endIndex = lines.findIndex((line, index) => index > 0 && line.trim() === '---');
-    if (endIndex === -1)
-        return null;
-    return lines.slice(1, endIndex).join('\n');
-}
-function contentAfterFrontmatter(content) {
-    const lines = content.split(/\r?\n/u);
-    const endIndex = lines.findIndex((line, index) => index > 0 && line.trim() === '---');
-    return endIndex === -1 ? content : lines.slice(endIndex + 1).join('\n');
-}
-function readDescriptionKey(lines) {
-    for (let index = 0; index < lines.length; index++) {
-        const line = lines[index];
-        const match = line.match(/^\s*(description|decription)\s*:\s*(.*)$/iu);
-        if (!match)
-            continue;
-        const inline = stripYamlString(match[2].trim());
-        if (inline)
-            return inline;
-        const block = readIndentedBlock(lines, index + 1);
-        if (block)
-            return block;
-    }
-    return null;
-}
-function readIndentedBlock(lines, start) {
-    const collected = [];
-    for (let index = start; index < lines.length; index++) {
-        const line = lines[index];
-        if (line.trim().length === 0) {
-            if (collected.length > 0)
-                break;
-            continue;
-        }
-        if (!/^\s+/.test(line))
-            break;
-        collected.push(line.trim());
-    }
-    return collected.length > 0 ? collected.join(' ') : null;
-}
-function stripYamlString(value) {
-    const stripped = value
-        .replace(/^\|[+-]?$/u, '')
-        .replace(/^>[+-]?$/u, '')
-        .trim();
-    if (!stripped)
-        return null;
-    const quoted = stripped.match(/^(['"])(.*)\1$/u);
-    return (quoted ? quoted[2] : stripped).trim() || null;
-}
-//# sourceMappingURL=description.js.map

package/dist/description.js.map

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

package/dist/gitignore.d.ts

@@ -1,9 +0,0 @@
-export interface GitignoreRule {
-    baseDir: string;
-    pattern: string;
-    negated: boolean;
-    directoryOnly: boolean;
-}
-export declare function readInheritedGitignoreRules(root: string, scanRoot: string): Promise<GitignoreRule[]>;
-export declare function readGitignoreRules(dir: string): Promise<GitignoreRule[]>;
-export declare function isGitignored(filePath: string, isDirectory: boolean, rules: readonly GitignoreRule[]): boolean;