@dynamik-dev/refdocs 0.1.1

package/README.md

@@ -0,0 +1,109 @@
+# refdocs
+
+Index your markdown docs. Search them fast. Get back only what matters.
+
+Built for LLM coding agents that need token-conscious access to project documentation — no network calls, no API keys, no MCP servers. Just a single binary and a JSON index file.
+
+```bash
+$ refdocs search "database connections"
+
+# [1] config/database.md:12-34
+# Configuration > Database > Connections
+
+Connection pooling is configured via the `pool` key in your
+database config. Each connection type supports `min`, `max`,
+and `idle_timeout` options...
+
+---
+
+# [2] guides/troubleshooting.md:88-104
+# Troubleshooting > Database > Connection Refused
+
+If you see "ECONNREFUSED", check that your database server
+is running and the host/port in your config matches...
+```
+
+refdocs chunks markdown at heading boundaries into 100-800 token pieces, indexes them with fuzzy search, and returns only the relevant chunks — not entire files.
+
+## Install
+
+```bash
+npm install -g @dynamik-dev/refdocs
+```
+
+Or build from source:
+
+```bash
+bun install && bun run build
+```
+
+Produces a standalone `./refdocs` binary. Or run directly:
+
+```bash
+bun src/index.ts <command>
+```
+
+## Usage
+
+```bash
+# Point at your docs directory
+echo '{ "paths": ["docs"] }' > .refdocs.json
+
+# Build the index
+refdocs index
+# Indexed 42 files -> 156 chunks (45.2 KB, 320ms)
+
+# Search
+refdocs search "authentication"
+refdocs search "config" -n 5              # top 5 results
+refdocs search "api" -f "api/**/*.md"     # filter by file glob
+refdocs search "hooks" --json             # structured output
+refdocs search "auth" --raw               # body only, for piping
+
+# Inspect the index
+refdocs list                              # files and chunk counts
+refdocs info "api/auth.md"               # chunks in a specific file
+```
+
+## How it works
+
+1. **Index** — parses each `.md` file into an AST, splits at h1/h2/h3 boundaries, merges small sections, splits large ones at paragraph breaks. Each chunk keeps its full heading breadcrumb (`Config > Database > Connections`).
+
+2. **Search** — fuzzy matching (20% edit tolerance) with prefix search and field boosting. Titles weighted 2x, headings 1.5x, body 1x. Results ranked by TF-IDF. File-level glob filtering via `-f`.
+
+3. **Output** — human-readable by default, `--json` for structured consumption, `--raw` for piping. Each result includes source file, line range, and heading trail.
+
+## Configuration
+
+`.refdocs.json` at project root:
+
+```json
+{
+  "paths": ["docs"],
+  "index": ".refdocs-index.json",
+  "chunkMaxTokens": 800,
+  "chunkMinTokens": 100,
+  "boostFields": { "title": 2, "headings": 1.5, "body": 1 }
+}
+```
+
+All fields optional. See [Configuration](docs/configuration.md) for details.
+
+## Documentation
+
+- [Getting Started](docs/getting-started.md) — installation, quick start, and overview
+- [CLI Reference](docs/cli-reference.md) — commands, flags, output formats, and exit codes
+- [Configuration](docs/configuration.md) — `.refdocs.json` options with defaults and examples
+- [Chunking](docs/chunking.md) — the 3-pass splitting algorithm and chunk structure
+- [Search](docs/search.md) — fuzzy matching, boosting, scoring, and index persistence
+
+## Tech
+
+| Dependency | Role |
+|------------|------|
+| [MiniSearch](https://github.com/lucaong/minisearch) | Full-text fuzzy search (~7kb, pure JS) |
+| [Commander](https://github.com/tj/commander.js) | CLI framework |
+| [mdast-util-from-markdown](https://github.com/syntax-tree/mdast-util-from-markdown) | Markdown AST parsing |
+| [picomatch](https://github.com/micromatch/picomatch) | Glob pattern matching |
+
+Zero external services. Works offline, in containers, on planes.

package/dist/src/chunker.d.ts

@@ -0,0 +1,9 @@
+import type { Chunk } from "./types.js";
+interface ChunkOptions {
+    maxTokens: number;
+    minTokens: number;
+}
+export declare function estimateTokens(text: string): number;
+export declare function chunkMarkdown(content: string, filePath: string, options: ChunkOptions): Chunk[];
+export {};
+//# sourceMappingURL=chunker.d.ts.map

package/dist/src/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/chunker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAYD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,GACpB,KAAK,EAAE,CA6CT"}

package/dist/src/chunker.js

@@ -0,0 +1,205 @@
+import { fromMarkdown } from "mdast-util-from-markdown";
+const FRONTMATTER_RE = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/;
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export function chunkMarkdown(content, filePath, options) {
+    if (!content.trim())
+        return [];
+    // Strip YAML front matter before parsing
+    const stripped = content.replace(FRONTMATTER_RE, "");
+    if (!stripped.trim())
+        return [];
+    const lines = content.split("\n");
+    const strippedLines = stripped.split("\n");
+    const lineOffset = lines.length - strippedLines.length;
+    const tree = fromMarkdown(stripped);
+    // Pass 1: Extract sections at heading boundaries
+    const sections = extractSections(tree.children, strippedLines, lineOffset);
+    if (sections.length === 0) {
+        // No headings found — treat entire content as a single chunk
+        const body = stripped.trim();
+        if (!body)
+            return [];
+        return [
+            makeChunk(filePath, fileTitle(filePath), [fileTitle(filePath)], body, lineOffset + 1, lines.length, 0),
+        ];
+    }
+    // Pass 2: Merge small sections
+    const merged = mergeSections(sections, options.minTokens);
+    // Pass 3: Split oversized sections
+    const final = splitSections(merged, options.maxTokens);
+    // Filter out sections with empty bodies
+    const nonEmpty = final.filter((s) => s.body.trim().length > 0);
+    return nonEmpty.map((section, i) => makeChunk(filePath, section.headings[section.headings.length - 1] || fileTitle(filePath), section.headings, section.body, section.startLine, section.endLine, i));
+}
+function extractSections(children, lines, lineOffset) {
+    const sections = [];
+    const headingStack = [];
+    let currentStart = null;
+    let currentBody = "";
+    function pushCurrentSection(endLine) {
+        if (currentStart !== null) {
+            const body = currentBody.trim();
+            sections.push({
+                headings: headingStack.map((h) => h.text),
+                depth: headingStack.length > 0 ? headingStack[headingStack.length - 1].depth : 0,
+                body,
+                startLine: currentStart + lineOffset,
+                endLine: endLine + lineOffset,
+            });
+        }
+    }
+    // Check if there's content before the first heading
+    const firstHeading = children.find((n) => n.type === "heading" && n.depth <= 3);
+    if (firstHeading && firstHeading.position) {
+        const firstHeadingLine = firstHeading.position.start.line;
+        if (firstHeadingLine > 1) {
+            const preambleLines = lines.slice(0, firstHeadingLine - 1);
+            const preambleBody = preambleLines.join("\n").trim();
+            if (preambleBody) {
+                sections.push({
+                    headings: [fileTitle( /* deferred — caller knows filePath */)],
+                    depth: 0,
+                    body: preambleBody,
+                    startLine: 1 + lineOffset,
+                    endLine: firstHeadingLine - 1 + lineOffset,
+                });
+            }
+        }
+    }
+    for (const node of children) {
+        if (node.type === "heading" && node.depth <= 3 && node.position) {
+            const headingLine = node.position.start.line;
+            // Flush previous section
+            if (currentStart !== null) {
+                pushCurrentSection(headingLine - 1);
+                currentBody = "";
+            }
+            const headingText = extractText(node);
+            const depth = node.depth;
+            // Update heading stack: pop to depth < current, then push
+            while (headingStack.length > 0 && headingStack[headingStack.length - 1].depth >= depth) {
+                headingStack.pop();
+            }
+            headingStack.push({ text: headingText, depth });
+            currentStart = headingLine;
+            currentBody = "";
+        }
+        else if (node.position) {
+            // Accumulate body content (including h4-h6)
+            const nodeStart = node.position.start.line - 1;
+            const nodeEnd = node.position.end.line;
+            const text = lines.slice(nodeStart, nodeEnd).join("\n");
+            if (currentBody)
+                currentBody += "\n\n";
+            currentBody += text;
+        }
+    }
+    // Flush last section
+    if (currentStart !== null) {
+        pushCurrentSection(lines.length);
+    }
+    return sections;
+}
+function mergeSections(sections, minTokens) {
+    if (sections.length <= 1)
+        return sections;
+    const result = [sections[0]];
+    for (let i = 1; i < sections.length; i++) {
+        const current = sections[i];
+        const prev = result[result.length - 1];
+        const tokens = estimateTokens(current.body);
+        // Only merge siblings (same depth) when the current section is small
+        if (tokens < minTokens && prev.depth === current.depth) {
+            const heading = formatHeadingLine(current);
+            const addition = heading ? heading + "\n\n" + current.body : current.body;
+            prev.body = prev.body ? prev.body + "\n\n" + addition : addition;
+            prev.endLine = current.endLine;
+        }
+        else {
+            result.push({ ...current });
+        }
+    }
+    return result;
+}
+function formatHeadingLine(section) {
+    if (section.headings.length === 0)
+        return "";
+    const last = section.headings[section.headings.length - 1];
+    const hashes = "#".repeat(section.depth || 1);
+    return `${hashes} ${last}`;
+}
+function splitSections(sections, maxTokens) {
+    const result = [];
+    for (const section of sections) {
+        const tokens = estimateTokens(section.body);
+        if (tokens <= maxTokens) {
+            result.push(section);
+            continue;
+        }
+        // Split at paragraph boundaries
+        const paragraphs = section.body.split(/\n\n+/);
+        let accumBody = "";
+        let subStart = section.startLine;
+        const totalLines = section.endLine - section.startLine + 1;
+        let linesConsumed = 0;
+        for (let i = 0; i < paragraphs.length; i++) {
+            const para = paragraphs[i];
+            const candidate = accumBody ? accumBody + "\n\n" + para : para;
+            if (estimateTokens(candidate) > maxTokens && accumBody) {
+                // Flush accumulated
+                const bodyLines = accumBody.split("\n").length;
+                result.push({
+                    ...section,
+                    body: accumBody,
+                    startLine: subStart,
+                    endLine: subStart + bodyLines - 1,
+                });
+                linesConsumed += bodyLines + 1; // +1 for paragraph gap
+                subStart = section.startLine + linesConsumed;
+                accumBody = para;
+            }
+            else {
+                accumBody = candidate;
+            }
+        }
+        // Flush remainder
+        if (accumBody.trim()) {
+            result.push({
+                ...section,
+                body: accumBody,
+                startLine: subStart,
+                endLine: section.endLine,
+            });
+        }
+    }
+    return result;
+}
+function extractText(node) {
+    if ("value" in node && typeof node.value === "string")
+        return node.value;
+    if ("children" in node) {
+        return node.children.map(extractText).join("");
+    }
+    return "";
+}
+function fileTitle(filePath) {
+    if (!filePath)
+        return "Untitled";
+    const name = filePath.split("/").pop() || filePath;
+    return name.replace(/\.md$/i, "");
+}
+function makeChunk(file, title, headings, body, startLine, endLine, index) {
+    return {
+        id: `${file}:${index}`,
+        file,
+        title,
+        headings: headings.join(" > "),
+        body,
+        startLine,
+        endLine,
+        tokenEstimate: estimateTokens(body),
+    };
+}
+//# sourceMappingURL=chunker.js.map

package/dist/src/chunker.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,8 @@
+import type { RefdocsConfig } from "./types.js";
+export interface ConfigResult {
+    config: RefdocsConfig;
+    configDir: string;
+}
+export declare function loadConfig(cwd?: string): ConfigResult;
+export declare function validateConfig(raw: unknown): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgBhD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CAyBrD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CA4CrD"}

package/dist/src/config.js

@@ -0,0 +1,77 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+const CONFIG_FILENAME = ".refdocs.json";
+const DEFAULT_CONFIG = {
+    paths: ["ref-docs"],
+    index: ".refdocs-index.json",
+    chunkMaxTokens: 800,
+    chunkMinTokens: 100,
+    boostFields: {
+        title: 2,
+        headings: 1.5,
+        body: 1,
+    },
+};
+export function loadConfig(cwd) {
+    const startDir = resolve(cwd ?? process.cwd());
+    let dir = startDir;
+    while (true) {
+        const configPath = join(dir, CONFIG_FILENAME);
+        if (existsSync(configPath)) {
+            const raw = JSON.parse(readFileSync(configPath, "utf-8"));
+            const errors = validateConfig(raw);
+            if (errors.length > 0) {
+                throw new Error(`Invalid ${CONFIG_FILENAME}: ${errors.join("; ")}`);
+            }
+            return {
+                config: { ...DEFAULT_CONFIG, ...raw, boostFields: { ...DEFAULT_CONFIG.boostFields, ...raw.boostFields } },
+                configDir: dir,
+            };
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return { config: DEFAULT_CONFIG, configDir: startDir };
+}
+export function validateConfig(raw) {
+    const errors = [];
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        return ["Config must be a JSON object"];
+    }
+    const obj = raw;
+    if (obj.paths !== undefined) {
+        if (!Array.isArray(obj.paths) || !obj.paths.every((p) => typeof p === "string")) {
+            errors.push('"paths" must be an array of strings');
+        }
+    }
+    if (obj.index !== undefined && typeof obj.index !== "string") {
+        errors.push('"index" must be a string');
+    }
+    if (obj.chunkMaxTokens !== undefined) {
+        if (typeof obj.chunkMaxTokens !== "number" || obj.chunkMaxTokens <= 0) {
+            errors.push('"chunkMaxTokens" must be a positive number');
+        }
+    }
+    if (obj.chunkMinTokens !== undefined) {
+        if (typeof obj.chunkMinTokens !== "number" || obj.chunkMinTokens <= 0) {
+            errors.push('"chunkMinTokens" must be a positive number');
+        }
+    }
+    if (obj.boostFields !== undefined) {
+        if (typeof obj.boostFields !== "object" || obj.boostFields === null || Array.isArray(obj.boostFields)) {
+            errors.push('"boostFields" must be an object');
+        }
+        else {
+            const bf = obj.boostFields;
+            for (const key of ["title", "headings", "body"]) {
+                if (bf[key] !== undefined && typeof bf[key] !== "number") {
+                    errors.push(`"boostFields.${key}" must be a number`);
+                }
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/src/index.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { join } from "node:path";
+import { loadConfig } from "./config.js";
+import { buildIndex, loadPersistedIndex } from "./indexer.js";
+import { search } from "./search.js";
+const program = new Command();
+program
+    .name("refdocs")
+    .description("Local CLI tool for indexing and searching markdown documentation")
+    .version("0.1.0");
+program
+    .command("index")
+    .description("Index all markdown files in configured paths")
+    .action(() => {
+    try {
+        const { config, configDir } = loadConfig();
+        const summary = buildIndex(config, configDir);
+        console.log(`Indexed ${summary.filesIndexed} files → ${summary.chunksCreated} chunks`);
+        console.log(`Index size: ${(summary.indexSizeBytes / 1024).toFixed(1)} KB`);
+        console.log(`Done in ${summary.elapsedMs}ms`);
+    }
+    catch (err) {
+        console.error(err.message);
+        process.exit(1);
+    }
+});
+program
+    .command("search <query>")
+    .description("Fuzzy search the index and return top chunks")
+    .option("-n, --results <count>", "number of results", "3")
+    .option("-f, --file <pattern>", "filter results to files matching glob")
+    .option("--json", "output as JSON")
+    .option("--raw", "output chunk body only, no metadata")
+    .action((query, opts) => {
+    try {
+        const { config, configDir } = loadConfig();
+        const indexPath = join(configDir, config.index);
+        const { index } = loadPersistedIndex(indexPath, config);
+        const maxResults = Math.min(Math.max(1, parseInt(opts.results, 10) || 3), 10);
+        const results = search(index, query, {
+            maxResults,
+            fileFilter: opts.file,
+        });
+        if (results.length === 0) {
+            console.log("No results found.");
+            return;
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(results, null, 2));
+        }
+        else if (opts.raw) {
+            for (const r of results) {
+                console.log(r.body);
+                console.log("");
+            }
+        }
+        else {
+            formatResults(results);
+        }
+    }
+    catch (err) {
+        console.error(err.message);
+        process.exit(1);
+    }
+});
+program
+    .command("list")
+    .description("List all indexed files and their chunk counts")
+    .action(() => {
+    try {
+        const { config, configDir } = loadConfig();
+        const indexPath = join(configDir, config.index);
+        const { chunks } = loadPersistedIndex(indexPath, config);
+        const byFile = new Map();
+        for (const chunk of chunks) {
+            byFile.set(chunk.file, (byFile.get(chunk.file) || 0) + 1);
+        }
+        for (const [file, count] of [...byFile.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+            console.log(`${file} (${count} chunk${count !== 1 ? "s" : ""})`);
+        }
+        console.log(`\n${byFile.size} files, ${chunks.length} chunks total`);
+    }
+    catch (err) {
+        console.error(err.message);
+        process.exit(1);
+    }
+});
+program
+    .command("info <file>")
+    .description("Show all chunks for a specific file")
+    .action((file) => {
+    try {
+        const { config, configDir } = loadConfig();
+        const indexPath = join(configDir, config.index);
+        const { chunks } = loadPersistedIndex(indexPath, config);
+        const fileChunks = chunks.filter((c) => c.file === file);
+        if (fileChunks.length === 0) {
+            console.error(`No chunks found for "${file}". Run \`refdocs list\` to see indexed files.`);
+            process.exit(1);
+        }
+        console.log(`${file}: ${fileChunks.length} chunk${fileChunks.length !== 1 ? "s" : ""}\n`);
+        for (const chunk of fileChunks) {
+            console.log(`  [${chunk.startLine}-${chunk.endLine}] ${chunk.headings} (~${chunk.tokenEstimate} tokens)`);
+        }
+    }
+    catch (err) {
+        console.error(err.message);
+        process.exit(1);
+    }
+});
+function formatResults(results) {
+    results.forEach((r, i) => {
+        console.log(`# [${i + 1}] ${r.file}:${r.lines[0]}-${r.lines[1]}`);
+        console.log(`# ${r.headings.join(" > ")}`);
+        console.log("");
+        console.log(r.body);
+        if (i < results.length - 1) {
+            console.log("\n---\n");
+        }
+    });
+}
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/indexer.d.ts

@@ -0,0 +1,9 @@
+import type { Chunk, RefdocsConfig, IndexSummary } from "./types.js";
+import type MiniSearch from "minisearch";
+export declare function findMarkdownFiles(dirs: string[], baseDir: string): string[];
+export declare function buildIndex(config: RefdocsConfig, configDir: string): IndexSummary;
+export declare function loadPersistedIndex(indexPath: string, config: RefdocsConfig): {
+    index: MiniSearch<Chunk>;
+    chunks: Chunk[];
+};
+//# sourceMappingURL=indexer.d.ts.map

package/dist/src/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/indexer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AAEzC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB3E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CA4BjF;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB;IAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,CAM/C"}

package/dist/src/indexer.js

@@ -0,0 +1,58 @@
+import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { chunkMarkdown } from "./chunker.js";
+import { createSearchIndex, indexChunks, serializeIndex, loadIndex as loadSearchIndex } from "./search.js";
+export function findMarkdownFiles(dirs, baseDir) {
+    const files = [];
+    function walk(dir) {
+        if (!existsSync(dir))
+            return;
+        const entries = readdirSync(dir);
+        for (const entry of entries) {
+            const fullPath = join(dir, entry);
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (entry.endsWith(".md")) {
+                files.push(relative(baseDir, fullPath));
+            }
+        }
+    }
+    for (const dir of dirs) {
+        walk(join(baseDir, dir));
+    }
+    return files.sort();
+}
+export function buildIndex(config, configDir) {
+    const start = Date.now();
+    const files = findMarkdownFiles(config.paths, configDir);
+    const allChunks = [];
+    for (const file of files) {
+        const content = readFileSync(join(configDir, file), "utf-8");
+        const chunks = chunkMarkdown(content, file, {
+            maxTokens: config.chunkMaxTokens,
+            minTokens: config.chunkMinTokens,
+        });
+        allChunks.push(...chunks);
+    }
+    const index = createSearchIndex(config);
+    indexChunks(index, allChunks);
+    const serialized = serializeIndex(index, allChunks);
+    const indexPath = join(configDir, config.index);
+    writeFileSync(indexPath, serialized, "utf-8");
+    return {
+        filesIndexed: files.length,
+        chunksCreated: allChunks.length,
+        indexSizeBytes: Buffer.byteLength(serialized, "utf-8"),
+        elapsedMs: Date.now() - start,
+    };
+}
+export function loadPersistedIndex(indexPath, config) {
+    if (!existsSync(indexPath)) {
+        throw new Error("Index not found. Run `refdocs index` first.");
+    }
+    const json = readFileSync(indexPath, "utf-8");
+    return loadSearchIndex(json, config);
+}
+//# sourceMappingURL=indexer.js.map