rbxstudio-mcp 2.3.2 → 2.4.0

package/dist/docs/cache.js

@@ -0,0 +1,123 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+const SCHEMA_VERSION = 1;
+/**
+ * Resolve the docs cache directory. Honors `RBXSTUDIO_DOCS_DIR` first,
+ * otherwise falls back to OS-conventional cache paths via `env-paths`.
+ *
+ *   Linux   → ~/.cache/rbxstudio-mcp-nodejs/docs
+ *   macOS   → ~/Library/Caches/rbxstudio-mcp-nodejs/docs
+ *   Windows → %LOCALAPPDATA%\rbxstudio-mcp-nodejs\Cache\docs
+ *
+ * Note: `env-paths` is pure ESM and Jest's CJS sandbox can't load it at
+ * the top level of a TS module that may be imported by tests. Loading
+ * it on first call sidesteps that without affecting production
+ * behavior — runs at most once per process thanks to the cache below.
+ */
+let cachedDir = null;
+export function resolveCacheDir() {
+    if (cachedDir)
+        return cachedDir;
+    const override = process.env.RBXSTUDIO_DOCS_DIR;
+    if (override && override.trim().length > 0) {
+        cachedDir = path.resolve(override);
+        return cachedDir;
+    }
+    // Inline the env-paths logic so we don't need a runtime ESM import
+    // (which would force the surrounding module into top-level await).
+    // env-paths v3 returns OS-conventional cache paths; we replicate them.
+    cachedDir = defaultCacheDir();
+    return cachedDir;
+}
+function defaultCacheDir() {
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? process.cwd();
+    const appName = 'rbxstudio-mcp-nodejs';
+    switch (process.platform) {
+        case 'darwin':
+            return path.join(home, 'Library', 'Caches', appName, 'docs');
+        case 'win32': {
+            const localAppData = process.env.LOCALAPPDATA ?? path.join(home, 'AppData', 'Local');
+            return path.join(localAppData, appName, 'Cache', 'docs');
+        }
+        default: {
+            // Linux / *nix: respect XDG_CACHE_HOME if set.
+            const xdg = process.env.XDG_CACHE_HOME;
+            const base = xdg && xdg.trim().length > 0 ? xdg : path.join(home, '.cache');
+            return path.join(base, appName, 'docs');
+        }
+    }
+}
+export function metaPath(cacheDir) {
+    return path.join(cacheDir, 'meta.json');
+}
+export function contentRoot(cacheDir) {
+    return path.join(cacheDir, 'content');
+}
+export async function readMeta(cacheDir) {
+    try {
+        const raw = await fs.readFile(metaPath(cacheDir), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed.schemaVersion !== SCHEMA_VERSION) {
+            // Old/incompatible cache — treat as empty so we re-download.
+            return null;
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT')
+            return null;
+        // Any other error (corrupt JSON, EACCES, …) → behave like no cache,
+        // upstream code will re-fetch.
+        return null;
+    }
+}
+export async function writeMeta(cacheDir, meta) {
+    await fs.mkdir(cacheDir, { recursive: true });
+    const full = { ...meta, schemaVersion: SCHEMA_VERSION };
+    await fs.writeFile(metaPath(cacheDir), JSON.stringify(full, null, 2), 'utf8');
+}
+export async function ensureCacheDir(cacheDir) {
+    await fs.mkdir(cacheDir, { recursive: true });
+}
+/**
+ * Wipe the extracted content tree (but keep the cacheDir itself, so users
+ * can `tail -F` it if they want to).
+ */
+export async function clearContent(cacheDir) {
+    const dir = contentRoot(cacheDir);
+    await fs.rm(dir, { recursive: true, force: true });
+}
+/**
+ * Best-effort byte-count of the content tree. Used for status reporting
+ * only; not safety-critical, so errors are swallowed.
+ */
+export async function approxSizeOnDisk(dir) {
+    let total = 0;
+    async function walk(d) {
+        let entries;
+        try {
+            entries = await fs.readdir(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const p = path.join(d, e.name);
+            if (e.isDirectory()) {
+                await walk(p);
+            }
+            else if (e.isFile()) {
+                try {
+                    const stat = await fs.stat(p);
+                    total += stat.size;
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+    }
+    await walk(dir);
+    return total;
+}
+//# sourceMappingURL=cache.js.map

package/dist/docs/cache.js.map

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

package/dist/docs/embeddings/chunker.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Chunker for the Roblox creator-docs mirror.
+ *
+ * Goal: turn the on-disk md/yaml files into bite-sized, semantically
+ * coherent passages suitable for sentence-embedding. We index the
+ * resulting chunks once (per docs SHA) and rerank keyword hits against
+ * them at query time.
+ *
+ * Strategy per file type:
+ *
+ *   .md   → split on top-level (`#`) and second-level (`##`) ATX
+ *           headings. Each chunk = heading + body until the next
+ *           heading of equal/higher level. Long chunks are further
+ *           split on `###` and then on paragraph boundaries until they
+ *           fit MAX_CHUNK_CHARS.
+ *
+ *   .yaml → the Roblox API schema is a single top-level document with
+ *           a `properties:` / `methods:` / `events:` list of members.
+ *           Each member is its own chunk (name + description + tags).
+ *           Top-level fields (summary, description, code_samples) get
+ *           one preamble chunk so a query like "Motor6D" — which
+ *           matches the class-level summary, not any specific member —
+ *           still has something to rank against.
+ *
+ * Each chunk records its source path and the line range it covers so
+ * downstream code can deep-link back to the original file (matches the
+ * shape `searchDocs` already returns: { path, line, ... }).
+ *
+ * Why ranges and not single lines? An embedding represents a passage,
+ * not a single line. When a chunk wins on cosine score we want to point
+ * the model at the whole passage, not just the heading.
+ */
+export interface Chunk {
+    /** Doc path relative to the content root. Same shape as SearchHit.path. */
+    path: string;
+    /** 1-indexed inclusive start line in the source file. */
+    startLine: number;
+    /** 1-indexed inclusive end line in the source file. */
+    endLine: number;
+    /**
+     * The text we feed to the embedder. Includes the heading / member
+     * name as a prefix so the model knows what the passage is about
+     * (sentence-transformers do better with explicit context).
+     */
+    text: string;
+    /**
+     * Short label for debugging / UI: the heading, member name, or
+     * "<preamble>" for the file-level chunk.
+     */
+    label: string;
+    /**
+     * Categorical hint used by the hybrid scorer to bias certain queries.
+     * Mirrors the reference categories in `reference.ts`.
+     */
+    kind: 'md-section' | 'yaml-preamble' | 'yaml-member' | 'yaml-misc';
+}
+/**
+ * Split markdown into heading-bounded sections.
+ *
+ * Edge cases handled:
+ *  - Code fences (```...```) — heading-looking lines inside fences
+ *    are ignored. (Without this we'd split on a `# comment` inside a
+ *    Lua snippet, which would be wrong.)
+ *  - Documents with no headings at all → one big chunk per
+ *    MAX_CHUNK_CHARS slice.
+ *  - Front-matter (`---\n...\n---` at the top) — treated as a
+ *    preamble chunk.
+ */
+declare function chunkMarkdown(relPath: string, raw: string): Chunk[];
+/**
+ * Split a too-long chunk along blank-line boundaries. Each output
+ * piece carries the line range from its slice of the original.
+ *
+ * Lines are recomputed: each piece's line range is computed by walking
+ * the text and counting newlines from the parent's startLine.
+ */
+declare function splitOversize(text: string, parentStart: number, parentEnd: number): {
+    text: string;
+    startLine: number;
+    endLine: number;
+}[];
+/**
+ * Lightweight YAML splitter for the Roblox creator-docs API schema.
+ *
+ * The schema is regular enough that we don't need a full YAML parser
+ * to chunk it sensibly. We look for top-level list keys
+ * (`properties:`, `methods:`, `events:`, `callbacks:`, `items:`) and
+ * split each list entry (a `- name: Foo` block) into its own chunk.
+ *
+ * Everything else at the top of the file (`name:`, `type:`, `summary:`,
+ * `description:`, `code_samples:`) becomes a single preamble chunk.
+ *
+ * If the YAML doesn't match the expected shape (e.g. a non-reference
+ * doc that happens to be yaml), we fall back to one giant
+ * chunk-per-MAX-chars slice.
+ */
+declare function chunkYaml(relPath: string, raw: string): Chunk[];
+/**
+ * Pull a top-level `key: value` out of a YAML block. Returns the bare
+ * value (quotes stripped) or null if not found. Only looks for keys
+ * at column 0 or one level of dash-indent — sufficient for our schema.
+ */
+declare function extractYamlField(block: string, key: string): string | null;
+/**
+ * Walk the docs content tree and yield chunks for every chunkable
+ * file. Walks lazily so we can stream chunks into the embedder
+ * without holding the full set in RAM (though at ~3k chunks × ~500
+ * chars ≈ 1.5MB, RAM isn't actually a problem).
+ */
+export declare function walkChunks(cacheDir: string): AsyncGenerator<Chunk>;
+/** Eager version of walkChunks — convenient for tests / index builds. */
+export declare function chunkAll(cacheDir: string): Promise<Chunk[]>;
+export declare const __test__: {
+    chunkMarkdown: typeof chunkMarkdown;
+    chunkYaml: typeof chunkYaml;
+    splitOversize: typeof splitOversize;
+    extractYamlField: typeof extractYamlField;
+};
+export {};
+//# sourceMappingURL=chunker.d.ts.map

package/dist/docs/embeddings/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../../src/docs/embeddings/chunker.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,MAAM,WAAW,KAAK;IACpB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,CAAC;CACpE;AAuBD;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CA4F5D;AAED;;;;;;GAMG;AACH,iBAAS,aAAa,CACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAoDxD;AAgBD;;;;;;;;;;;;;;GAcG;AACH,iBAAS,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CA8FxD;AAsBD;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAenE;AASD;;;;;GAKG;AACH,wBAAuB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CA+BzE;AAED,yEAAyE;AACzE,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAIjE;AAGD,eAAO,MAAM,QAAQ;;;;;CAAgE,CAAC"}

package/dist/docs/embeddings/chunker.js

@@ -0,0 +1,395 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { contentRoot } from '../cache.js';
+/**
+ * Hard cap on chunk size in characters. all-MiniLM-L6-v2 truncates at
+ * 256 wordpieces (~1000 chars of English). Going much higher just gets
+ * truncated and wastes embedding compute. We aim a bit under so the
+ * heading prefix + body fits cleanly.
+ *
+ * Lower bound — chunks smaller than MIN_CHUNK_CHARS get merged with
+ * the next one so we don't emit dozens of useless "## Examples" stubs.
+ */
+const MAX_CHUNK_CHARS = 900;
+const MIN_CHUNK_CHARS = 40;
+/**
+ * File extensions the chunker handles. Anything else is silently
+ * skipped (binaries, images, etc. shouldn't be in the filtered cache
+ * but we don't rely on that).
+ */
+const CHUNKABLE_EXTENSIONS = new Set(['.md', '.yaml', '.yml']);
+// ---------- Markdown ----------
+/**
+ * Split markdown into heading-bounded sections.
+ *
+ * Edge cases handled:
+ *  - Code fences (```...```) — heading-looking lines inside fences
+ *    are ignored. (Without this we'd split on a `# comment` inside a
+ *    Lua snippet, which would be wrong.)
+ *  - Documents with no headings at all → one big chunk per
+ *    MAX_CHUNK_CHARS slice.
+ *  - Front-matter (`---\n...\n---` at the top) — treated as a
+ *    preamble chunk.
+ */
+function chunkMarkdown(relPath, raw) {
+    const lines = raw.split(/\r?\n/);
+    const sections = [];
+    let inFence = false;
+    let lastHeadingIdx = -1;
+    let lastHeading = '';
+    let lastLevel = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Toggle on triple-backtick fences (and tilde, less common).
+        if (/^\s*(```|~~~)/.test(line)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        // ATX heading: 1–6 `#` chars at line start, then space, then text.
+        const m = /^(#{1,6})\s+(.+?)\s*#*\s*$/.exec(line);
+        if (!m)
+            continue;
+        if (lastHeadingIdx >= 0) {
+            sections.push({
+                start: lastHeadingIdx,
+                end: i - 1,
+                heading: lastHeading,
+                level: lastLevel,
+            });
+        }
+        else if (i > 0) {
+            // Content before any heading → preamble.
+            sections.push({
+                start: 0,
+                end: i - 1,
+                heading: '<preamble>',
+                level: 0,
+            });
+        }
+        lastHeadingIdx = i;
+        lastHeading = m[2];
+        lastLevel = m[1].length;
+    }
+    // Close out the trailing section (or whole file if no headings).
+    if (lastHeadingIdx >= 0) {
+        sections.push({
+            start: lastHeadingIdx,
+            end: lines.length - 1,
+            heading: lastHeading,
+            level: lastLevel,
+        });
+    }
+    else if (sections.length === 0) {
+        sections.push({
+            start: 0,
+            end: lines.length - 1,
+            heading: '<preamble>',
+            level: 0,
+        });
+    }
+    const chunks = [];
+    for (const sec of sections) {
+        const body = lines.slice(sec.start, sec.end + 1).join('\n').trim();
+        if (body.length === 0)
+            continue;
+        // Heading already lives in `body[0]` for non-preamble sections —
+        // don't double-add it. For preamble we prepend a label so the
+        // embedder has *some* context.
+        const text = sec.heading === '<preamble>'
+            ? `${pathToLabel(relPath)}\n${body}`
+            : body;
+        // Split oversize sections on blank lines until each piece fits.
+        const pieces = splitOversize(text, sec.start, sec.end);
+        for (const p of pieces) {
+            // Skip pure-stub chunks ("## Examples" with no body underneath).
+            if (p.text.replace(/^#+\s.*$/m, '').trim().length < MIN_CHUNK_CHARS) {
+                // ...unless the heading itself is informative enough to keep
+                // (rare; usually it's not, so we skip).
+                continue;
+            }
+            chunks.push({
+                path: relPath,
+                startLine: p.startLine,
+                endLine: p.endLine,
+                text: p.text,
+                label: sec.heading === '<preamble>' ? '<preamble>' : sec.heading,
+                kind: 'md-section',
+            });
+        }
+    }
+    return chunks;
+}
+/**
+ * Split a too-long chunk along blank-line boundaries. Each output
+ * piece carries the line range from its slice of the original.
+ *
+ * Lines are recomputed: each piece's line range is computed by walking
+ * the text and counting newlines from the parent's startLine.
+ */
+function splitOversize(text, parentStart, parentEnd) {
+    if (text.length <= MAX_CHUNK_CHARS) {
+        return [
+            { text, startLine: parentStart + 1, endLine: parentEnd + 1 },
+        ];
+    }
+    // Split on blank lines, then greedily merge into MAX_CHUNK_CHARS bins.
+    const paragraphs = text.split(/\n\s*\n/);
+    const out = [];
+    let buf = '';
+    let bufLines = 0;
+    let cursor = parentStart;
+    let bufStart = parentStart;
+    const flush = () => {
+        if (!buf.trim())
+            return;
+        out.push({
+            text: buf.trim(),
+            startLine: bufStart + 1,
+            endLine: bufStart + Math.max(1, bufLines),
+        });
+    };
+    for (const p of paragraphs) {
+        const plines = p.split(/\r?\n/).length;
+        // +2 for the blank line we just split on.
+        const need = (buf ? 2 : 0) + p.length;
+        if (buf && buf.length + need > MAX_CHUNK_CHARS) {
+            flush();
+            buf = p;
+            bufStart = cursor;
+            bufLines = plines;
+        }
+        else {
+            if (buf) {
+                buf += '\n\n' + p;
+                bufLines += plines + 1; // +1 for blank line
+            }
+            else {
+                buf = p;
+                bufStart = cursor;
+                bufLines = plines;
+            }
+        }
+        cursor += plines + 1; // +1 for blank line consumed by split
+    }
+    flush();
+    // Don't run past parentEnd (the blank-line accounting is approximate).
+    for (const piece of out) {
+        if (piece.endLine > parentEnd + 1)
+            piece.endLine = parentEnd + 1;
+        if (piece.startLine > parentEnd + 1)
+            piece.startLine = parentEnd + 1;
+    }
+    return out;
+}
+/**
+ * Best-effort filename → display label, used for the preamble chunk
+ * of an unheaded markdown file.
+ *   "en-us/animation/using.md" → "animation/using"
+ */
+function pathToLabel(relPath) {
+    return relPath
+        .replace(/^en-us\//, '')
+        .replace(/\.(md|ya?ml)$/i, '')
+        .replace(/\\/g, '/');
+}
+// ---------- YAML ----------
+/**
+ * Lightweight YAML splitter for the Roblox creator-docs API schema.
+ *
+ * The schema is regular enough that we don't need a full YAML parser
+ * to chunk it sensibly. We look for top-level list keys
+ * (`properties:`, `methods:`, `events:`, `callbacks:`, `items:`) and
+ * split each list entry (a `- name: Foo` block) into its own chunk.
+ *
+ * Everything else at the top of the file (`name:`, `type:`, `summary:`,
+ * `description:`, `code_samples:`) becomes a single preamble chunk.
+ *
+ * If the YAML doesn't match the expected shape (e.g. a non-reference
+ * doc that happens to be yaml), we fall back to one giant
+ * chunk-per-MAX-chars slice.
+ */
+function chunkYaml(relPath, raw) {
+    const lines = raw.split(/\r?\n/);
+    // Detect schema-like docs: must have at least one of the known
+    // top-level list keys at column 0.
+    const listKeyRe = /^(properties|methods|events|callbacks|items):\s*$/;
+    const hasSchema = lines.some((l) => listKeyRe.test(l));
+    if (!hasSchema) {
+        return chunkYamlFallback(relPath, raw);
+    }
+    const chunks = [];
+    // Preamble: everything from line 0 up to the first known list key.
+    let firstListLine = lines.length;
+    for (let i = 0; i < lines.length; i++) {
+        if (listKeyRe.test(lines[i])) {
+            firstListLine = i;
+            break;
+        }
+    }
+    const preamble = lines.slice(0, firstListLine).join('\n').trim();
+    if (preamble.length >= MIN_CHUNK_CHARS) {
+        const label = extractYamlField(preamble, 'name') ?? pathToLabel(relPath);
+        chunks.push({
+            path: relPath,
+            startLine: 1,
+            endLine: firstListLine,
+            text: trimTo(`${label}\n${preamble}`, MAX_CHUNK_CHARS),
+            label,
+            kind: 'yaml-preamble',
+        });
+    }
+    // Walk list bodies. State: we're "inside" a list when the current
+    // line is `properties:` etc. and continues until we hit another
+    // top-level key (`^\S`) or EOF.
+    let i = firstListLine;
+    while (i < lines.length) {
+        const listMatch = listKeyRe.exec(lines[i]);
+        if (!listMatch) {
+            i++;
+            continue;
+        }
+        const listKey = listMatch[1];
+        const listStart = i;
+        i++;
+        // Find end of this list section.
+        let listEnd = lines.length;
+        for (let j = i; j < lines.length; j++) {
+            if (/^\S/.test(lines[j]) && !/^\s*-/.test(lines[j])) {
+                listEnd = j;
+                break;
+            }
+        }
+        // Split into entries. Each entry starts with `  - name:` or
+        // `  - ` at the indent established by the first entry. We just
+        // detect `^\s*-\s` as the entry boundary.
+        const entryStarts = [];
+        for (let j = i; j < listEnd; j++) {
+            if (/^\s*-\s/.test(lines[j]))
+                entryStarts.push(j);
+        }
+        entryStarts.push(listEnd); // sentinel
+        for (let e = 0; e < entryStarts.length - 1; e++) {
+            const eStart = entryStarts[e];
+            const eEnd = entryStarts[e + 1] - 1;
+            const body = lines.slice(eStart, eEnd + 1).join('\n').trim();
+            if (body.length < MIN_CHUNK_CHARS)
+                continue;
+            const memberName = extractYamlField(body, 'name') ?? `${listKey}[${e}]`;
+            const preambleLabel = extractYamlField(preamble, 'name') ?? pathToLabel(relPath);
+            // Give the embedder both the parent name and the member name —
+            // "Motor6D · C0" rather than just "C0".
+            const text = trimTo(`${preambleLabel} · ${memberName} (${listKey})\n${body}`, MAX_CHUNK_CHARS);
+            chunks.push({
+                path: relPath,
+                startLine: eStart + 1,
+                endLine: eEnd + 1,
+                text,
+                label: `${preambleLabel}.${memberName}`,
+                kind: 'yaml-member',
+            });
+        }
+        i = listEnd;
+    }
+    return chunks;
+}
+/**
+ * Non-schema YAML: just slice the file into MAX-chars chunks on
+ * blank-line boundaries. Best-effort line accounting.
+ */
+function chunkYamlFallback(relPath, raw) {
+    const lines = raw.split(/\r?\n/);
+    const total = lines.length;
+    const piece = splitOversize(raw, 0, total - 1);
+    return piece
+        .filter((p) => p.text.length >= MIN_CHUNK_CHARS)
+        .map((p) => ({
+        path: relPath,
+        startLine: p.startLine,
+        endLine: p.endLine,
+        text: trimTo(`${pathToLabel(relPath)}\n${p.text}`, MAX_CHUNK_CHARS),
+        label: pathToLabel(relPath),
+        kind: 'yaml-misc',
+    }));
+}
+/**
+ * Pull a top-level `key: value` out of a YAML block. Returns the bare
+ * value (quotes stripped) or null if not found. Only looks for keys
+ * at column 0 or one level of dash-indent — sufficient for our schema.
+ */
+function extractYamlField(block, key) {
+    // Top-level: `name: value`
+    // Or first-line-of-entry: `- name: value`
+    const re = new RegExp(`^\\s*-?\\s*${key}:\\s*(.+?)\\s*$`, 'm');
+    const m = re.exec(block);
+    if (!m)
+        return null;
+    let v = m[1].trim();
+    // Strip surrounding quotes.
+    if ((v.startsWith('"') && v.endsWith('"')) ||
+        (v.startsWith("'") && v.endsWith("'"))) {
+        v = v.slice(1, -1);
+    }
+    return v.length > 0 ? v : null;
+}
+function trimTo(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + '…';
+}
+// ---------- Public API ----------
+/**
+ * Walk the docs content tree and yield chunks for every chunkable
+ * file. Walks lazily so we can stream chunks into the embedder
+ * without holding the full set in RAM (though at ~3k chunks × ~500
+ * chars ≈ 1.5MB, RAM isn't actually a problem).
+ */
+export async function* walkChunks(cacheDir) {
+    const root = contentRoot(cacheDir);
+    const stack = [root];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const p = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                stack.push(p);
+            }
+            else if (e.isFile()) {
+                const ext = path.extname(e.name).toLowerCase();
+                if (!CHUNKABLE_EXTENSIONS.has(ext))
+                    continue;
+                const rel = path.relative(root, p);
+                let raw;
+                try {
+                    raw = await fs.readFile(p, 'utf8');
+                }
+                catch {
+                    continue;
+                }
+                if (raw.indexOf('\0') !== -1)
+                    continue;
+                const chunks = ext === '.md' ? chunkMarkdown(rel, raw) : chunkYaml(rel, raw);
+                for (const c of chunks)
+                    yield c;
+            }
+        }
+    }
+}
+/** Eager version of walkChunks — convenient for tests / index builds. */
+export async function chunkAll(cacheDir) {
+    const out = [];
+    for await (const c of walkChunks(cacheDir))
+        out.push(c);
+    return out;
+}
+// Export internals for tests.
+export const __test__ = { chunkMarkdown, chunkYaml, splitOversize, extractYamlField };
+//# sourceMappingURL=chunker.js.map

package/dist/docs/embeddings/chunker.js.map

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