@dynamik-dev/refdocs 0.1.1

package/dist/tests/config.test.js

@@ -0,0 +1,94 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { loadConfig, validateConfig } from "../src/config.js";
+describe("validateConfig", () => {
+    it("returns no errors for valid config", () => {
+        expect(validateConfig({
+            paths: ["docs"],
+            index: ".index.json",
+            chunkMaxTokens: 800,
+            chunkMinTokens: 100,
+            boostFields: { title: 2, headings: 1.5, body: 1 },
+        })).toEqual([]);
+    });
+    it("returns no errors for empty object (all optional)", () => {
+        expect(validateConfig({})).toEqual([]);
+    });
+    it("rejects non-object config", () => {
+        expect(validateConfig("string")).toEqual(["Config must be a JSON object"]);
+        expect(validateConfig(null)).toEqual(["Config must be a JSON object"]);
+        expect(validateConfig([])).toEqual(["Config must be a JSON object"]);
+    });
+    it("rejects invalid paths", () => {
+        const errors = validateConfig({ paths: "not-array" });
+        expect(errors).toContain('"paths" must be an array of strings');
+    });
+    it("rejects non-string items in paths", () => {
+        const errors = validateConfig({ paths: [123] });
+        expect(errors).toContain('"paths" must be an array of strings');
+    });
+    it("rejects non-string index", () => {
+        const errors = validateConfig({ index: 123 });
+        expect(errors).toContain('"index" must be a string');
+    });
+    it("rejects non-positive chunkMaxTokens", () => {
+        expect(validateConfig({ chunkMaxTokens: -1 })).toContain('"chunkMaxTokens" must be a positive number');
+        expect(validateConfig({ chunkMaxTokens: "abc" })).toContain('"chunkMaxTokens" must be a positive number');
+    });
+    it("rejects non-positive chunkMinTokens", () => {
+        expect(validateConfig({ chunkMinTokens: 0 })).toContain('"chunkMinTokens" must be a positive number');
+    });
+    it("rejects invalid boostFields", () => {
+        expect(validateConfig({ boostFields: "not-object" })).toContain('"boostFields" must be an object');
+    });
+    it("rejects non-number boost field values", () => {
+        const errors = validateConfig({ boostFields: { title: "high" } });
+        expect(errors).toContain('"boostFields.title" must be a number');
+    });
+});
+describe("loadConfig", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), "refdocs-test-"));
+    });
+    afterEach(() => {
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("returns defaults when no config file exists", () => {
+        const { config, configDir } = loadConfig(tmpDir);
+        expect(config.paths).toEqual(["ref-docs"]);
+        expect(config.index).toBe(".refdocs-index.json");
+        expect(config.chunkMaxTokens).toBe(800);
+        expect(config.chunkMinTokens).toBe(100);
+        expect(configDir).toBe(tmpDir);
+    });
+    it("loads config from given directory", () => {
+        writeFileSync(join(tmpDir, ".refdocs.json"), JSON.stringify({ paths: ["docs"], chunkMaxTokens: 500 }));
+        const { config } = loadConfig(tmpDir);
+        expect(config.paths).toEqual(["docs"]);
+        expect(config.chunkMaxTokens).toBe(500);
+        expect(config.chunkMinTokens).toBe(100); // default preserved
+    });
+    it("walks up directories to find config", () => {
+        writeFileSync(join(tmpDir, ".refdocs.json"), JSON.stringify({ paths: ["custom-docs"] }));
+        const subDir = join(tmpDir, "sub", "deep");
+        mkdirSync(subDir, { recursive: true });
+        const { config, configDir } = loadConfig(subDir);
+        expect(config.paths).toEqual(["custom-docs"]);
+        expect(configDir).toBe(tmpDir);
+    });
+    it("merges boostFields with defaults", () => {
+        writeFileSync(join(tmpDir, ".refdocs.json"), JSON.stringify({ boostFields: { title: 5 } }));
+        const { config } = loadConfig(tmpDir);
+        expect(config.boostFields.title).toBe(5);
+        expect(config.boostFields.headings).toBe(1.5);
+        expect(config.boostFields.body).toBe(1);
+    });
+    it("throws on invalid config", () => {
+        writeFileSync(join(tmpDir, ".refdocs.json"), JSON.stringify({ paths: "not-an-array" }));
+        expect(() => loadConfig(tmpDir)).toThrow("Invalid .refdocs.json");
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/tests/config.test.js.map

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

package/dist/tests/indexer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=indexer.test.d.ts.map

package/dist/tests/indexer.test.d.ts.map

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

package/dist/tests/indexer.test.js

@@ -0,0 +1,109 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, writeFileSync, mkdirSync, rmSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { findMarkdownFiles, buildIndex, loadPersistedIndex } from "../src/indexer.js";
+import { search } from "../src/search.js";
+const testConfig = {
+    paths: ["docs"],
+    index: ".refdocs-index.json",
+    chunkMaxTokens: 800,
+    chunkMinTokens: 100,
+    boostFields: { title: 2, headings: 1.5, body: 1 },
+};
+describe("findMarkdownFiles", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), "refdocs-idx-"));
+        mkdirSync(join(tmpDir, "docs"), { recursive: true });
+    });
+    afterEach(() => {
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("finds .md files in configured paths", () => {
+        writeFileSync(join(tmpDir, "docs", "readme.md"), "# Hello");
+        writeFileSync(join(tmpDir, "docs", "guide.md"), "# Guide");
+        const files = findMarkdownFiles(["docs"], tmpDir);
+        expect(files).toEqual(["docs/guide.md", "docs/readme.md"]);
+    });
+    it("finds files recursively", () => {
+        mkdirSync(join(tmpDir, "docs", "sub"), { recursive: true });
+        writeFileSync(join(tmpDir, "docs", "root.md"), "# Root");
+        writeFileSync(join(tmpDir, "docs", "sub", "nested.md"), "# Nested");
+        const files = findMarkdownFiles(["docs"], tmpDir);
+        expect(files).toContain("docs/root.md");
+        expect(files).toContain("docs/sub/nested.md");
+    });
+    it("ignores non-md files", () => {
+        writeFileSync(join(tmpDir, "docs", "readme.md"), "# Hello");
+        writeFileSync(join(tmpDir, "docs", "notes.txt"), "not markdown");
+        writeFileSync(join(tmpDir, "docs", "data.json"), "{}");
+        const files = findMarkdownFiles(["docs"], tmpDir);
+        expect(files).toEqual(["docs/readme.md"]);
+    });
+    it("returns empty array for missing directory", () => {
+        const files = findMarkdownFiles(["nonexistent"], tmpDir);
+        expect(files).toEqual([]);
+    });
+    it("returns sorted list", () => {
+        writeFileSync(join(tmpDir, "docs", "z-file.md"), "# Z");
+        writeFileSync(join(tmpDir, "docs", "a-file.md"), "# A");
+        writeFileSync(join(tmpDir, "docs", "m-file.md"), "# M");
+        const files = findMarkdownFiles(["docs"], tmpDir);
+        expect(files).toEqual(["docs/a-file.md", "docs/m-file.md", "docs/z-file.md"]);
+    });
+});
+describe("buildIndex", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), "refdocs-build-"));
+        mkdirSync(join(tmpDir, "docs"), { recursive: true });
+    });
+    afterEach(() => {
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("builds index and writes to disk", () => {
+        writeFileSync(join(tmpDir, "docs", "api.md"), "# API\n\n## Authentication\n\nUse JWT tokens for auth.\n\n## Rate Limiting\n\nDefault is 100 req/min.\n");
+        const summary = buildIndex(testConfig, tmpDir);
+        expect(summary.filesIndexed).toBe(1);
+        expect(summary.chunksCreated).toBeGreaterThanOrEqual(1);
+        expect(summary.indexSizeBytes).toBeGreaterThan(0);
+        expect(summary.elapsedMs).toBeGreaterThanOrEqual(0);
+        expect(existsSync(join(tmpDir, ".refdocs-index.json"))).toBe(true);
+    });
+    it("indexes multiple files", () => {
+        writeFileSync(join(tmpDir, "docs", "a.md"), "# File A\n\nContent A about authentication and tokens.\n");
+        writeFileSync(join(tmpDir, "docs", "b.md"), "# File B\n\nContent B about configuration and setup.\n");
+        const summary = buildIndex(testConfig, tmpDir);
+        expect(summary.filesIndexed).toBe(2);
+    });
+    it("produces searchable index", () => {
+        writeFileSync(join(tmpDir, "docs", "guide.md"), "# Setup Guide\n\n## Database\n\nConfigure PostgreSQL connection string in your .env file.\n\n## Cache\n\nRedis is used for caching session data.\n");
+        buildIndex(testConfig, tmpDir);
+        const { index } = loadPersistedIndex(join(tmpDir, ".refdocs-index.json"), testConfig);
+        const results = search(index, "PostgreSQL", { maxResults: 3 });
+        expect(results.length).toBeGreaterThan(0);
+        expect(results[0].body).toContain("PostgreSQL");
+    });
+});
+describe("loadPersistedIndex", () => {
+    it("throws with actionable error when index does not exist", () => {
+        expect(() => loadPersistedIndex("/nonexistent/path.json", testConfig)).toThrow("Index not found. Run `refdocs index` first.");
+    });
+    it("round-trips build + load successfully", () => {
+        const tmpDir = mkdtempSync(join(tmpdir(), "refdocs-rt-"));
+        try {
+            mkdirSync(join(tmpDir, "docs"), { recursive: true });
+            writeFileSync(join(tmpDir, "docs", "test.md"), "# Test Doc\n\nThis is test content about widgets and gadgets.\n");
+            buildIndex(testConfig, tmpDir);
+            const { index, chunks } = loadPersistedIndex(join(tmpDir, ".refdocs-index.json"), testConfig);
+            expect(chunks.length).toBeGreaterThan(0);
+            const results = search(index, "widgets", { maxResults: 3 });
+            expect(results.length).toBeGreaterThan(0);
+        }
+        finally {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=indexer.test.js.map

package/dist/tests/indexer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.test.js","sourceRoot":"","sources":["../../tests/indexer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,MAAM,UAAU,GAAkB;IAChC,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,KAAK,EAAE,qBAAqB;IAC5B,cAAc,EAAE,GAAG;IACnB,cAAc,EAAE,GAAG;IACnB,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE;CAClD,CAAC;AAEF,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QACrD,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5D,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzD,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5D,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC;QACjE,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;QACxD,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;QACxD,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACvD,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAC9B,yGAAyG,CAC1G,CAAC;QACF,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,0DAA0D,CAAC,CAAC;QACxG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wDAAwD,CAAC,CAAC;QACtG,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAChC,oJAAoJ,CACrJ,CAAC;QACF,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAAE,UAAU,CAAC,CAAC;QACtF,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAC5E,6CAA6C,CAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAC/B,iEAAiE,CAClE,CAAC;YACF,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC/B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAC1C,IAAI,CAAC,MAAM,EAAE,qBAAqB,CAAC,EACnC,UAAU,CACX,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5D,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search.test.d.ts.map

package/dist/tests/search.test.d.ts.map

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

package/dist/tests/search.test.js

@@ -0,0 +1,160 @@
+import { describe, it, expect } from "vitest";
+import { createSearchIndex, indexChunks, serializeIndex, loadIndex, search, } from "../src/search.js";
+const testConfig = {
+    paths: ["docs"],
+    index: ".refdocs-index.json",
+    chunkMaxTokens: 800,
+    chunkMinTokens: 100,
+    boostFields: { title: 2, headings: 1.5, body: 1 },
+};
+function makeChunk(overrides) {
+    return {
+        file: "test.md",
+        title: "Test",
+        headings: "Test",
+        body: "test body",
+        startLine: 1,
+        endLine: 10,
+        tokenEstimate: 10,
+        ...overrides,
+    };
+}
+const sampleChunks = [
+    makeChunk({
+        id: "api.md:0",
+        file: "api.md",
+        title: "Authentication",
+        headings: "API > Authentication",
+        body: "Use JWT tokens for authentication. Include the token in the Authorization header.",
+        startLine: 1,
+        endLine: 5,
+    }),
+    makeChunk({
+        id: "api.md:1",
+        file: "api.md",
+        title: "Rate Limiting",
+        headings: "API > Rate Limiting",
+        body: "Rate limits are applied per API key. Default limit is 100 requests per minute.",
+        startLine: 6,
+        endLine: 10,
+    }),
+    makeChunk({
+        id: "guide.md:0",
+        file: "guide.md",
+        title: "Getting Started",
+        headings: "Getting Started",
+        body: "Install the package and configure your environment. Run npm install to get started.",
+        startLine: 1,
+        endLine: 8,
+    }),
+    makeChunk({
+        id: "guide.md:1",
+        file: "guide.md",
+        title: "Configuration",
+        headings: "Getting Started > Configuration",
+        body: "Create a .env file with your database URL and API key for authentication.",
+        startLine: 9,
+        endLine: 15,
+    }),
+];
+describe("createSearchIndex and indexChunks", () => {
+    it("creates an index and adds chunks without error", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        expect(index.documentCount).toBe(sampleChunks.length);
+    });
+});
+describe("search", () => {
+    it("finds relevant results for a query", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const results = search(index, "authentication", { maxResults: 3 });
+        expect(results.length).toBeGreaterThan(0);
+        expect(results[0].file).toBe("api.md");
+        expect(results[0].body).toContain("JWT tokens");
+    });
+    it("respects maxResults", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const results = search(index, "api", { maxResults: 1 });
+        expect(results).toHaveLength(1);
+    });
+    it("returns empty array for no matches", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const results = search(index, "xyznonexistent", { maxResults: 3 });
+        expect(results).toHaveLength(0);
+    });
+    it("includes score, file, lines, headings, body in results", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const results = search(index, "rate limiting", { maxResults: 3 });
+        const result = results[0];
+        expect(result.score).toBeGreaterThan(0);
+        expect(result.file).toBe("api.md");
+        expect(result.lines).toEqual([6, 10]);
+        expect(result.headings).toEqual(["API", "Rate Limiting"]);
+        expect(result.body).toContain("100 requests per minute");
+    });
+    it("boosts title matches over body matches", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        // "Authentication" appears in title of api.md:0 and body of guide.md:1
+        const results = search(index, "authentication", { maxResults: 4 });
+        expect(results[0].file).toBe("api.md");
+        expect(results[0].headings).toContain("Authentication");
+    });
+    it("supports fuzzy matching", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        // Misspelling
+        const results = search(index, "authenication", { maxResults: 3 });
+        expect(results.length).toBeGreaterThan(0);
+    });
+    it("supports prefix matching", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const results = search(index, "auth", { maxResults: 3 });
+        expect(results.length).toBeGreaterThan(0);
+    });
+    it("filters by file glob", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const results = search(index, "authentication", {
+            maxResults: 10,
+            fileFilter: "guide.*",
+        });
+        for (const r of results) {
+            expect(r.file).toMatch(/^guide/);
+        }
+    });
+});
+describe("serialization", () => {
+    it("round-trips through serialize and load", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const json = serializeIndex(index, sampleChunks);
+        const { index: loaded, chunks } = loadIndex(json, testConfig);
+        expect(chunks).toEqual(sampleChunks);
+        const results = search(loaded, "authentication", { maxResults: 3 });
+        expect(results.length).toBeGreaterThan(0);
+        expect(results[0].body).toContain("JWT");
+    });
+    it("includes version and createdAt in serialized output", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const json = serializeIndex(index, sampleChunks);
+        const parsed = JSON.parse(json);
+        expect(parsed.version).toBe(1);
+        expect(parsed.createdAt).toBeDefined();
+    });
+    it("throws on version mismatch", () => {
+        const index = createSearchIndex(testConfig);
+        indexChunks(index, sampleChunks);
+        const json = serializeIndex(index, sampleChunks);
+        const parsed = JSON.parse(json);
+        parsed.version = 999;
+        expect(() => loadIndex(JSON.stringify(parsed), testConfig)).toThrow("Index version mismatch");
+    });
+});
+//# sourceMappingURL=search.test.js.map

package/dist/tests/search.test.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@dynamik-dev/refdocs",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Local CLI tool that indexes markdown documentation and exposes fast fuzzy search with intelligent chunking",
+  "main": "dist/src/index.js",
+  "bin": {
+    "refdocs": "dist/src/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "bun build --compile src/index.ts --outfile refdocs"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dynamik-dev/refdoc-cli.git"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "mdast-util-from-markdown": "^2.0.2",
+    "minisearch": "^7.1.1",
+    "picomatch": "^4.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/picomatch": "^3.0.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}