@neuledge/context 0.1.0

package/dist/search.js

@@ -0,0 +1,152 @@
+import { getMetaValue } from "./db.js";
+// TODO: Future enhancements for better search quality:
+// - Semantic search: Add local embeddings for meaning-based retrieval
+// - GraphRAG: Add relations table to traverse related docs (e.g., middleware → auth)
+//   Schema: relations(from_id, to_id, type: 'references'|'extends'|'example_of', weight)
+// - Smarter chunking: Improve section splitting with better context preservation
+// - Quality heuristics: Detect README-only repos, score documentation completeness
+const CONFIG = {
+    MAX_TOKENS: 2000,
+    RELEVANCE_DROP: 0.5,
+};
+/**
+ * Build an FTS5 query from user topic.
+ * - Cleans special characters (keeps alphanumeric, spaces, quotes)
+ * - Words are implicitly ANDed by FTS5
+ */
+function buildQuery(topic) {
+    return topic
+        .trim()
+        .replace(/[^\w\s"]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function searchFts(db, query) {
+    const ftsQuery = buildQuery(query);
+    if (!ftsQuery)
+        return [];
+    // BM25 weights: doc_title, section_title, content
+    // Higher weight = more important for ranking
+    const stmt = db.prepare(`
+    SELECT
+      c.id,
+      c.doc_path as docPath,
+      c.doc_title as docTitle,
+      c.section_title as sectionTitle,
+      c.content,
+      c.tokens,
+      (bm25(chunks_fts, 5.0, 10.0, 1.0) * -1) as score
+    FROM chunks_fts
+    JOIN chunks c ON chunks_fts.rowid = c.id
+    WHERE chunks_fts MATCH ?
+    ORDER BY score DESC
+    LIMIT 20
+  `);
+    return stmt.all(ftsQuery);
+}
+function filterByRelevance(matches) {
+    const first = matches[0];
+    if (!first)
+        return [];
+    const topScore = first.score;
+    // Keep matches that are within RELEVANCE_DROP of top score
+    const minScore = topScore * CONFIG.RELEVANCE_DROP;
+    return matches.filter((m) => m.score >= minScore);
+}
+function applyTokenBudget(matches) {
+    const result = [];
+    let totalTokens = 0;
+    for (const match of matches) {
+        if (totalTokens + match.tokens > CONFIG.MAX_TOKENS)
+            break;
+        result.push(match);
+        totalTokens += match.tokens;
+    }
+    return result;
+}
+function groupByDocument(matches) {
+    const byDoc = new Map();
+    for (const match of matches) {
+        const existing = byDoc.get(match.docPath);
+        if (existing) {
+            existing.push(match);
+        }
+        else {
+            byDoc.set(match.docPath, [match]);
+        }
+    }
+    // Sort chunks within each doc by ID (document order)
+    for (const chunks of byDoc.values()) {
+        chunks.sort((a, b) => a.id - b.id);
+    }
+    return byDoc;
+}
+function cloneChunk(chunk) {
+    return {
+        id: chunk.id,
+        docPath: chunk.docPath,
+        docTitle: chunk.docTitle,
+        sectionTitle: chunk.sectionTitle,
+        content: chunk.content,
+        tokens: chunk.tokens,
+        score: chunk.score,
+    };
+}
+function mergeAdjacentChunks(chunks) {
+    const first = chunks[0];
+    if (!first || chunks.length <= 1)
+        return chunks;
+    const merged = [];
+    let current = cloneChunk(first);
+    for (let i = 1; i < chunks.length; i++) {
+        const next = chunks[i];
+        if (!next)
+            continue;
+        // Merge if IDs are adjacent
+        if (next.id === current.id + 1) {
+            current.sectionTitle = `${current.sectionTitle} / ${next.sectionTitle}`;
+            current.content = `${current.content}\n\n${next.content}`;
+            current.tokens = current.tokens + next.tokens;
+        }
+        else {
+            merged.push(current);
+            current = cloneChunk(next);
+        }
+    }
+    merged.push(current);
+    return merged;
+}
+function assembleResults(matches) {
+    const byDoc = groupByDocument(matches);
+    const results = [];
+    // Maintain order: docs with highest-scoring chunk first
+    const docOrder = [...new Set(matches.map((m) => m.docPath))];
+    for (const docPath of docOrder) {
+        const chunks = byDoc.get(docPath);
+        if (!chunks)
+            continue;
+        const merged = mergeAdjacentChunks(chunks);
+        for (const chunk of merged) {
+            results.push({
+                title: `${chunk.docTitle} > ${chunk.sectionTitle}`,
+                content: chunk.content,
+                source: chunk.docPath,
+            });
+        }
+    }
+    return results;
+}
+export function search(db, topic) {
+    const name = getMetaValue(db, "name") ?? "unknown";
+    const version = getMetaValue(db, "version") ?? "unknown";
+    const matches = searchFts(db, topic);
+    const filtered = filterByRelevance(matches);
+    const budgeted = applyTokenBudget(filtered);
+    const results = assembleResults(budgeted);
+    return {
+        library: `${name}@${version}`,
+        version,
+        results,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PackageStore } from "./store.js";
+/**
+ * MCP server for documentation retrieval.
+ * Accepts a PackageStore to provide the get_docs tool.
+ */
+export declare class ContextServer {
+    private mcp;
+    private store;
+    constructor(store: PackageStore);
+    /**
+     * Start the server with stdio transport.
+     * Registers the get_docs tool if packages are available.
+     */
+    start(): Promise<void>;
+    /** Access the underlying McpServer for testing. */
+    get server(): McpServer;
+    private registerGetDocsTool;
+    private handleGetDocs;
+}

package/dist/server.js

@@ -0,0 +1,108 @@
+import { createRequire } from "node:module";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { search } from "./search.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+/**
+ * MCP server for documentation retrieval.
+ * Accepts a PackageStore to provide the get_docs tool.
+ */
+export class ContextServer {
+    mcp;
+    store;
+    constructor(store) {
+        this.store = store;
+        this.mcp = new McpServer({
+            name: "context",
+            version,
+        });
+    }
+    /**
+     * Start the server with stdio transport.
+     * Registers the get_docs tool if packages are available.
+     */
+    async start() {
+        const packages = this.store.list();
+        if (packages.length > 0) {
+            this.registerGetDocsTool(packages);
+        }
+        const transport = new StdioServerTransport();
+        await this.mcp.connect(transport);
+    }
+    /** Access the underlying McpServer for testing. */
+    get server() {
+        return this.mcp;
+    }
+    registerGetDocsTool(packages) {
+        const libraryEnum = packages.map(formatLibraryName);
+        this.mcp.registerTool("get_docs", {
+            description: "Retrieves up-to-date documentation for a library. Use this to get accurate, version-specific information about APIs, usage patterns, and best practices. Returns instantly from local cache - no network latency.",
+            inputSchema: {
+                library: z
+                    .enum(libraryEnum)
+                    .describe("The library to search (name@version)"),
+                topic: z
+                    .string()
+                    .describe("What you need help with (e.g., 'middleware authentication', 'server components')"),
+            },
+        }, async ({ library, topic }) => {
+            return this.handleGetDocs(packages, library, topic);
+        });
+    }
+    handleGetDocs(packages, library, topic) {
+        const pkg = packages.find((p) => formatLibraryName(p) === library);
+        if (!pkg) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: `Package not found: ${library}` }),
+                    },
+                ],
+            };
+        }
+        const db = this.store.openDb(pkg.name);
+        if (!db) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: `Failed to open package database: ${library}`,
+                        }),
+                    },
+                ],
+            };
+        }
+        try {
+            const result = search(db, topic);
+            return {
+                content: [{ type: "text", text: formatSearchResult(result) }],
+            };
+        }
+        finally {
+            db.close();
+        }
+    }
+}
+function formatLibraryName(pkg) {
+    return `${pkg.name}@${pkg.version}`;
+}
+function formatSearchResult(result) {
+    if (result.results.length === 0) {
+        return JSON.stringify({
+            library: result.library,
+            version: result.version,
+            results: [],
+            message: "No documentation found. Try different keywords.",
+        });
+    }
+    return JSON.stringify({
+        library: result.library,
+        version: result.version,
+        results: result.results,
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,31 @@
+import Database from "better-sqlite3";
+export interface PackageMeta {
+    name: string;
+    version: string;
+    description?: string;
+    sourceUrl?: string;
+}
+export interface PackageInfo extends PackageMeta {
+    path: string;
+    sizeBytes: number;
+    sectionCount: number;
+}
+/**
+ * Registry of documentation packages.
+ * Manages an in-memory list of packages without file system operations.
+ */
+export declare class PackageStore {
+    private packages;
+    /** Add a package to the registry. */
+    add(info: PackageInfo): void;
+    /** Remove a package from the registry by name. Returns true if removed. */
+    remove(name: string): boolean;
+    /** Get all registered packages. */
+    list(): PackageInfo[];
+    /** Get a package by name. */
+    get(name: string): PackageInfo | null;
+    /** Open a package database for searching. */
+    openDb(name: string): Database.Database | null;
+}
+/** Read package info from a database file. */
+export declare function readPackageInfo(packagePath: string): PackageInfo;

package/dist/store.js

@@ -0,0 +1,58 @@
+import { statSync } from "node:fs";
+import Database from "better-sqlite3";
+import { getMetaValue, getSectionCount, validatePackageSchema } from "./db.js";
+/**
+ * Registry of documentation packages.
+ * Manages an in-memory list of packages without file system operations.
+ */
+export class PackageStore {
+    packages = new Map();
+    /** Add a package to the registry. */
+    add(info) {
+        this.packages.set(info.name, info);
+    }
+    /** Remove a package from the registry by name. Returns true if removed. */
+    remove(name) {
+        return this.packages.delete(name);
+    }
+    /** Get all registered packages. */
+    list() {
+        return [...this.packages.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /** Get a package by name. */
+    get(name) {
+        return this.packages.get(name) ?? null;
+    }
+    /** Open a package database for searching. */
+    openDb(name) {
+        const pkg = this.packages.get(name);
+        if (!pkg)
+            return null;
+        return new Database(pkg.path, { readonly: true });
+    }
+}
+/** Read package info from a database file. */
+export function readPackageInfo(packagePath) {
+    const db = new Database(packagePath, { readonly: true });
+    try {
+        validatePackageSchema(db);
+        const name = getMetaValue(db, "name");
+        const version = getMetaValue(db, "version");
+        if (!name || !version) {
+            throw new Error("Invalid package: missing name or version in meta table");
+        }
+        return {
+            name,
+            version,
+            description: getMetaValue(db, "description"),
+            sourceUrl: getMetaValue(db, "source_url"),
+            path: packagePath,
+            sizeBytes: statSync(packagePath).size,
+            sectionCount: getSectionCount(db),
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAe/E;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAElD,qCAAqC;IACrC,GAAG,CAAC,IAAiB;QACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,mCAAmC;IACnC,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC/C,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7B,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,6CAA6C;IAC7C,MAAM,CAAC,IAAY;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAE1B,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAE5C,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO;YACL,IAAI;YACJ,OAAO;YACP,WAAW,EAAE,YAAY,CAAC,EAAE,EAAE,aAAa,CAAC;YAC5C,SAAS,EAAE,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC;YACzC,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI;YACrC,YAAY,EAAE,eAAe,CAAC,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/test-utils.d.ts

@@ -0,0 +1,17 @@
+import Database from "better-sqlite3";
+export interface TestPackageOptions {
+    name?: string;
+    version?: string;
+    description?: string;
+}
+export interface TestChunk {
+    docPath: string;
+    docTitle: string;
+    sectionTitle: string;
+    content: string;
+    tokens: number;
+    hasCode?: number;
+}
+export declare function createTestDb(path: string, options?: TestPackageOptions): Database.Database;
+export declare function insertChunk(db: Database.Database, chunk: TestChunk): void;
+export declare function rebuildFtsIndex(db: Database.Database): void;

package/dist/test-utils.js

@@ -0,0 +1,37 @@
+import Database from "better-sqlite3";
+export function createTestDb(path, options = {}) {
+    const db = new Database(path);
+    db.exec(`
+    CREATE TABLE meta (key TEXT PRIMARY KEY, value TEXT);
+    CREATE TABLE chunks (
+      id INTEGER PRIMARY KEY,
+      doc_path TEXT NOT NULL,
+      doc_title TEXT NOT NULL,
+      section_title TEXT NOT NULL,
+      content TEXT NOT NULL,
+      tokens INTEGER NOT NULL,
+      has_code INTEGER DEFAULT 0
+    );
+    CREATE VIRTUAL TABLE chunks_fts USING fts5(
+      doc_title, section_title, content,
+      content='chunks', content_rowid='id',
+      tokenize='porter unicode61'
+    );
+  `);
+    const insertMeta = db.prepare("INSERT INTO meta (key, value) VALUES (?, ?)");
+    insertMeta.run("name", options.name ?? "test-lib");
+    insertMeta.run("version", options.version ?? "1.0.0");
+    if (options.description)
+        insertMeta.run("description", options.description);
+    return db;
+}
+export function insertChunk(db, chunk) {
+    db.prepare(`
+    INSERT INTO chunks (doc_path, doc_title, section_title, content, tokens, has_code)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `).run(chunk.docPath, chunk.docTitle, chunk.sectionTitle, chunk.content, chunk.tokens, chunk.hasCode ?? 0);
+}
+export function rebuildFtsIndex(db) {
+    db.exec("INSERT INTO chunks_fts(chunks_fts) VALUES('rebuild')");
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAiBtC,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,UAA8B,EAAE;IAEhC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE9B,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;GAgBP,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC;IAC7E,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,WAAW;QAAE,UAAU,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5E,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAqB,EAAE,KAAgB;IACjE,EAAE,CAAC,OAAO,CAAC;;;GAGV,CAAC,CAAC,GAAG,CACJ,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,OAAO,IAAI,CAAC,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAqB;IACnD,EAAE,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;AAClE,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@neuledge/context",
+  "version": "0.1.0",
+  "description": "Context management for Neuledge packages",
+  "keywords": [],
+  "homepage": "https://neuledge.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neuledge/context.git"
+  },
+  "bugs": {
+    "url": "https://github.com/neuledge/context/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "context": "./dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Neuledge",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.4",
+    "better-sqlite3": "^11.9.1",
+    "commander": "^14.0.0",
+    "ignore": "^7.0.5",
+    "remark-frontmatter": "^5.0.0",
+    "remark-parse": "^11.0.0",
+    "unified": "^11.0.5",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@total-typescript/tsconfig": "^1.0.4",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^24.9.1",
+    "rimraf": "^6.0.1",
+    "tsconfig-paths": "^4.2.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^4.0.3"
+  },
+  "tsx": {
+    "require": [
+      "tsconfig-paths/register"
+    ]
+  },
+  "scripts": {
+    "build": "rimraf --glob dist/** && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "npx biome ci --error-on-warnings",
+    "fix": "npx biome check --write"
+  }
+}