@compr/contextengine-mcp 1.9.44

package/dist/ingest.js

@@ -0,0 +1,79 @@
+import { readFileSync, existsSync } from "fs";
+import { basename } from "path";
+/**
+ * Parse a markdown file into chunks, splitting on headings.
+ * Each chunk captures the heading hierarchy for context.
+ */
+function parseMarkdown(filePath, sourceName) {
+    const text = readFileSync(filePath, "utf-8");
+    const lines = text.split("\n");
+    const chunks = [];
+    // Track heading hierarchy
+    const headingStack = [];
+    let currentContent = [];
+    let chunkStartLine = 1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const headingMatch = line.match(/^(#{1,6})\s+(.+)/);
+        if (headingMatch) {
+            // Flush previous chunk
+            if (currentContent.length > 0) {
+                const content = currentContent.join("\n").trim();
+                if (content.length > 0) {
+                    chunks.push({
+                        source: sourceName,
+                        section: headingStack.join(" > ") || basename(filePath),
+                        content,
+                        lineStart: chunkStartLine,
+                        lineEnd: i, // line before this heading
+                    });
+                }
+            }
+            const level = headingMatch[1].length;
+            const title = headingMatch[2].trim();
+            // Pop headings at same or deeper level
+            while (headingStack.length >= level) {
+                headingStack.pop();
+            }
+            headingStack.push(`${"#".repeat(level)} ${title}`);
+            currentContent = [];
+            chunkStartLine = i + 1; // 1-based
+        }
+        else {
+            currentContent.push(line);
+        }
+    }
+    // Flush last chunk
+    if (currentContent.length > 0) {
+        const content = currentContent.join("\n").trim();
+        if (content.length > 0) {
+            chunks.push({
+                source: sourceName,
+                section: headingStack.join(" > ") || basename(filePath),
+                content,
+                lineStart: chunkStartLine,
+                lineEnd: lines.length,
+            });
+        }
+    }
+    return chunks;
+}
+/**
+ * Ingest all configured knowledge sources into chunks.
+ * Skips files that don't exist (with a warning to stderr).
+ */
+export function ingestSources(sources) {
+    const allChunks = [];
+    for (const source of sources) {
+        if (!existsSync(source.path)) {
+            console.error(`[ContextEngine] ⚠ Skipping missing: ${source.path}`);
+            continue;
+        }
+        const chunks = parseMarkdown(source.path, source.name);
+        allChunks.push(...chunks);
+        console.error(`[ContextEngine] ✅ Indexed: ${source.name} (${chunks.length} chunks)`);
+    }
+    console.error(`[ContextEngine] 📦 Total: ${allChunks.length} chunks from ${sources.length} sources`);
+    return allChunks;
+}
+//# sourceMappingURL=ingest.js.map

package/dist/ingest.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,11 @@
+import { Chunk } from "./ingest.js";
+export interface SearchResult {
+    chunk: Chunk;
+    score: number;
+}
+/**
+ * Search chunks by keyword relevance.
+ * Returns top-k results sorted by score descending.
+ */
+export declare function searchChunks(chunks: Chunk[], query: string, topK?: number): SearchResult[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAkDpC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAW,GAChB,YAAY,EAAE,CAehB"}

package/dist/search.js

@@ -0,0 +1,58 @@
+/**
+ * Simple TF-IDF-ish keyword search over chunks.
+ * Fast, zero-dependency — good enough for v1.
+ * Will be replaced by vector embeddings in step 3.
+ */
+/** Normalize and tokenize a string */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s_\-./]/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length > 1);
+}
+/** Score a chunk against a query using term overlap */
+function scoreChunk(chunk, queryTokens) {
+    const contentLower = (chunk.content + " " + chunk.section).toLowerCase();
+    let score = 0;
+    for (const token of queryTokens) {
+        // Exact word boundary match scores higher
+        const regex = new RegExp(`\\b${escapeRegex(token)}\\b`, "gi");
+        const matches = contentLower.match(regex);
+        if (matches) {
+            score += matches.length * 2;
+        }
+        // Partial/substring match
+        else if (contentLower.includes(token)) {
+            score += 1;
+        }
+    }
+    // Bonus for matching multiple distinct query terms
+    const distinctMatches = queryTokens.filter((t) => contentLower.includes(t)).length;
+    if (distinctMatches > 1) {
+        score += distinctMatches * 3;
+    }
+    return score;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Search chunks by keyword relevance.
+ * Returns top-k results sorted by score descending.
+ */
+export function searchChunks(chunks, query, topK = 10) {
+    const queryTokens = tokenize(query);
+    if (queryTokens.length === 0)
+        return [];
+    const scored = [];
+    for (const chunk of chunks) {
+        const score = scoreChunk(chunk, queryTokens);
+        if (score > 0) {
+            scored.push({ chunk, score });
+        }
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, topK);
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,sCAAsC;AACtC,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;SACjC,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,uDAAuD;AACvD,SAAS,UAAU,CAAC,KAAY,EAAE,WAAqB;IACrD,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IACzE,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,0CAA0C;QAC1C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,0BAA0B;aACrB,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/C,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CACzB,CAAC,MAAM,CAAC;IACT,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,IAAI,eAAe,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAe,EACf,KAAa,EACb,OAAe,EAAE;IAEjB,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC7C,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/sessions.d.ts

@@ -0,0 +1,46 @@
+export interface SessionEntry {
+    key: string;
+    value: string;
+    timestamp: string;
+}
+export interface Session {
+    name: string;
+    created: string;
+    updated: string;
+    entries: SessionEntry[];
+}
+/**
+ * Save or update a key-value pair in a named session.
+ */
+export declare function saveSession(name: string, key: string, value: string): Session;
+/**
+ * Load a session by name.
+ */
+export declare function loadSession(name: string): Session | null;
+/**
+ * List all saved sessions.
+ */
+export declare function listSessions(): Array<{
+    name: string;
+    entries: number;
+    created: string;
+    updated: string;
+}>;
+/**
+ * Delete a session.
+ */
+export declare function deleteSession(name: string): boolean;
+/**
+ * Format a session for display.
+ */
+export declare function formatSession(session: Session): string;
+/**
+ * Format session list for display.
+ */
+export declare function formatSessionList(sessions: Array<{
+    name: string;
+    entries: number;
+    created: string;
+    updated: string;
+}>): string;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAcD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAwB7E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CASxD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBzG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAiBtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAiB9H"}

package/dist/sessions.js

@@ -0,0 +1,143 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+/**
+ * Session Persistence — save/restore conversation context between sessions.
+ *
+ * Sessions are saved as JSON files in ~/.contextengine/sessions/.
+ * Each session has a name, timestamp, and key-value data store.
+ *
+ * Use cases:
+ * - AI agent saves decisions/context at end of session → picks up next time
+ * - Track what was discussed, changed, or planned across sessions
+ * - Store project-specific notes that persist between agent restarts
+ */
+const SESSIONS_DIR = join(homedir(), ".contextengine", "sessions");
+function ensureDir() {
+    if (!existsSync(SESSIONS_DIR)) {
+        mkdirSync(SESSIONS_DIR, { recursive: true });
+    }
+}
+function sessionPath(name) {
+    // Sanitize name for filesystem
+    const safe = name.replace(/[^a-zA-Z0-9_\-\.]/g, "_").substring(0, 100);
+    return join(SESSIONS_DIR, `${safe}.json`);
+}
+/**
+ * Save or update a key-value pair in a named session.
+ */
+export function saveSession(name, key, value) {
+    ensureDir();
+    const path = sessionPath(name);
+    const now = new Date().toISOString();
+    let session;
+    if (existsSync(path)) {
+        session = JSON.parse(readFileSync(path, "utf-8"));
+        session.updated = now;
+    }
+    else {
+        session = { name, created: now, updated: now, entries: [] };
+    }
+    // Update existing key or add new one
+    const existing = session.entries.find((e) => e.key === key);
+    if (existing) {
+        existing.value = value;
+        existing.timestamp = now;
+    }
+    else {
+        session.entries.push({ key, value, timestamp: now });
+    }
+    writeFileSync(path, JSON.stringify(session, null, 2));
+    return session;
+}
+/**
+ * Load a session by name.
+ */
+export function loadSession(name) {
+    const path = sessionPath(name);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all saved sessions.
+ */
+export function listSessions() {
+    ensureDir();
+    try {
+        return readdirSync(SESSIONS_DIR)
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => {
+            try {
+                const session = JSON.parse(readFileSync(join(SESSIONS_DIR, f), "utf-8"));
+                return {
+                    name: session.name,
+                    entries: session.entries.length,
+                    created: session.created,
+                    updated: session.updated,
+                };
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Delete a session.
+ */
+export function deleteSession(name) {
+    const path = sessionPath(name);
+    if (existsSync(path)) {
+        unlinkSync(path);
+        return true;
+    }
+    return false;
+}
+/**
+ * Format a session for display.
+ */
+export function formatSession(session) {
+    const lines = [];
+    lines.push(`# Session: ${session.name}`);
+    lines.push(`Created: ${session.created}`);
+    lines.push(`Updated: ${session.updated}`);
+    lines.push(`Entries: ${session.entries.length}`);
+    lines.push("");
+    for (const entry of session.entries) {
+        lines.push(`## ${entry.key}`);
+        lines.push(`_Updated: ${entry.timestamp}_`);
+        lines.push("");
+        lines.push(entry.value);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format session list for display.
+ */
+export function formatSessionList(sessions) {
+    if (sessions.length === 0) {
+        return "No saved sessions. Use `save_session` to create one.";
+    }
+    const lines = [];
+    lines.push("# 📋 Saved Sessions\n");
+    lines.push("| Session | Entries | Created | Last Updated |");
+    lines.push("|---------|---------|---------|-------------|");
+    for (const s of sessions) {
+        const created = s.created.split("T")[0];
+        const updated = s.updated.split("T")[0];
+        lines.push(`| ${s.name} | ${s.entries} | ${created} | ${updated} |`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

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

package/dist/test-sessions.d.ts

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

package/dist/test-sessions.d.ts.map

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

package/dist/test-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-sessions.js","sourceRoot":"","sources":["../src/test-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAExH,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC5B,WAAW,CAAC,cAAc,EAAE,SAAS,EAAE,qCAAqC,CAAC,CAAC;AAC9E,WAAW,CAAC,cAAc,EAAE,WAAW,EAAE,yDAAyD,CAAC,CAAC;AACpG,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,+BAA+B,CAAC,CAAC;AAC7E,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAE/B,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC9B,MAAM,CAAC,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AACtC,IAAI,CAAC;IAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAErC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC9B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AAE/C,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC7C,WAAW,CAAC,cAAc,EAAE,SAAS,EAAE,0DAA0D,CAAC,CAAC;AACnG,MAAM,EAAE,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AACvC,IAAI,EAAE,EAAE,CAAC;IACP,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAC1E,CAAC;AAED,WAAW,CAAC,eAAe,EAAE,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAEpE,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AAE/C,aAAa,CAAC,cAAc,CAAC,CAAC;AAC9B,aAAa,CAAC,eAAe,CAAC,CAAC;AAC/B,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACjC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC"}

package/dist/test.d.ts

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

package/dist/test.d.ts.map

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

package/dist/test.js

@@ -0,0 +1,52 @@
+import { loadSources } from "./config.js";
+import { ingestSources } from "./ingest.js";
+import { searchChunks } from "./search.js";
+import { initEmbeddings, embedChunks, vectorSearch, } from "./embeddings.js";
+async function test() {
+    // 1. Ingest
+    const sources = loadSources();
+    const chunks = ingestSources(sources);
+    // 2. Keyword search
+    console.log("\n=== KEYWORD SEARCH: 'Docker deployment PHP nginx' ===\n");
+    const kwResults = searchChunks(chunks, "Docker deployment PHP nginx", 3);
+    kwResults.forEach((r, i) => {
+        console.log(`--- Result ${i + 1} (score: ${r.score}) ---`);
+        console.log(`Source: ${r.chunk.source}`);
+        console.log(`Section: ${r.chunk.section}`);
+        console.log(`Lines: ${r.chunk.lineStart}-${r.chunk.lineEnd}`);
+        console.log(r.chunk.content.slice(0, 150));
+        console.log();
+    });
+    // 3. Embeddings
+    console.log("=== LOADING EMBEDDINGS ===\n");
+    const ready = await initEmbeddings();
+    if (!ready) {
+        console.log("Embeddings not available — done.");
+        return;
+    }
+    console.log(`Embedding ${chunks.length} chunks...`);
+    const embedded = await embedChunks(chunks);
+    console.log(`Embedded ${embedded.length} chunks\n`);
+    // 4. Semantic search
+    console.log("=== SEMANTIC SEARCH: 'how to deploy to production server' ===\n");
+    const semResults = await vectorSearch("how to deploy to production server", embedded, 3);
+    semResults.forEach((r, i) => {
+        console.log(`--- Result ${i + 1} (score: ${r.score.toFixed(4)}) ---`);
+        console.log(`Source: ${r.chunk.source}`);
+        console.log(`Section: ${r.chunk.section}`);
+        console.log(r.chunk.content.slice(0, 150));
+        console.log();
+    });
+    // 5. Second semantic test — different query
+    console.log("=== SEMANTIC SEARCH: 'email queue worker supervisor' ===\n");
+    const semResults2 = await vectorSearch("email queue worker supervisor", embedded, 3);
+    semResults2.forEach((r, i) => {
+        console.log(`--- Result ${i + 1} (score: ${r.score.toFixed(4)}) ---`);
+        console.log(`Source: ${r.chunk.source}`);
+        console.log(`Section: ${r.chunk.section}`);
+        console.log(r.chunk.content.slice(0, 150));
+        console.log();
+    });
+}
+test().catch(console.error);
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,GAEb,MAAM,iBAAiB,CAAC;AAEzB,KAAK,UAAU,IAAI;IACjB,YAAY;IACZ,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEtC,oBAAoB;IACpB,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,6BAA6B,EAAE,CAAC,CAAC,CAAC;IACzE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,YAAY,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;IAEpD,qBAAqB;IACrB,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,MAAM,YAAY,CACnC,oCAAoC,EACpC,QAAQ,EACR,CAAC,CACF,CAAC;IACF,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,MAAM,YAAY,CACpC,+BAA+B,EAC/B,QAAQ,EACR,CAAC,CACF,CAAC;IACF,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC3B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@compr/contextengine-mcp",
+  "version": "1.9.44",
+  "description": "MCP server that turns your project documentation into a queryable knowledge base for AI coding agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "contextengine-mcp": "dist/cli.js",
+    "contextengine": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "copilot",
+    "claude",
+    "cursor",
+    "ai",
+    "knowledge-base",
+    "documentation",
+    "context",
+    "rag",
+    "search",
+    "developer-tools"
+  ],
+  "author": "FASTPROD",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FASTPROD/ContextEngine.git"
+  },
+  "homepage": "https://github.com/FASTPROD/ContextEngine#readme",
+  "bugs": {
+    "url": "https://github.com/FASTPROD/ContextEngine/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@huggingface/transformers": "^3.8.1",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.9.3"
+  }
+}