@compr/contextengine-mcp 1.9.44

package/dist/config.d.ts

@@ -0,0 +1,59 @@
+/**
+ * A knowledge source that ContextEngine indexes.
+ */
+export interface KnowledgeSource {
+    /** Human-readable label */
+    name: string;
+    /** Absolute path to the file */
+    path: string;
+    /** File type for parser selection */
+    type: "markdown" | "code";
+}
+/**
+ * A discovered project directory for operational data collection.
+ */
+export interface ProjectDirectory {
+    /** Human-readable project name (directory basename) */
+    name: string;
+    /** Absolute path to the project root */
+    path: string;
+}
+/**
+ * User configuration loaded from contextengine.json
+ */
+export interface ContextEngineConfig {
+    /** Explicit list of files to index */
+    sources?: Array<{
+        name: string;
+        path: string;
+    }>;
+    /** Directories to scan for knowledge files */
+    workspaces?: string[];
+    /** File patterns to auto-discover within workspaces */
+    patterns?: string[];
+    /** Directories to scan for code files (TS/JS/Python) — e.g. ["src/"] relative to project root */
+    codeDirs?: string[];
+    /** Enable operational data collection (git, deps, env, etc.) — default true */
+    collectOps?: boolean;
+    /** Enable system-wide operational data (docker, pm2, nginx, cron, shell history) — default true */
+    collectSystemOps?: boolean;
+}
+/**
+ * Load knowledge sources.
+ *
+ * Resolution order:
+ * 1. Config file (CONTEXTENGINE_CONFIG env, ./contextengine.json, ~/.contextengine.json)
+ * 2. CONTEXTENGINE_WORKSPACES env var (colon-separated paths)
+ * 3. Auto-discover from ~/Projects
+ */
+export declare function loadSources(): KnowledgeSource[];
+/**
+ * Discover project directories from workspaces.
+ * Returns one entry per top-level project found.
+ */
+export declare function loadProjectDirs(): ProjectDirectory[];
+/**
+ * Load the raw config (for checking flags like collectSystemOps).
+ */
+export declare function loadConfig(): ContextEngineConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAgGD;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,eAAe,EAAE,CAyD/C;AAYD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,EAAE,CAsDpD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,mBAAmB,CAMhD"}

package/dist/config.js

@@ -0,0 +1,213 @@
+import { resolve, join } from "path";
+import { homedir } from "os";
+import { readFileSync, existsSync, readdirSync, statSync } from "fs";
+const DEFAULT_PATTERNS = [
+    // GitHub Copilot
+    ".github/copilot-instructions.md",
+    ".github/SKILLS.md",
+    // Claude Code
+    "CLAUDE.md",
+    // Cursor
+    ".cursorrules",
+    ".cursor/rules",
+    // Codex / multi-agent
+    "AGENTS.md",
+];
+/**
+ * Look for contextengine.json in standard locations.
+ * Priority: env var > CWD > home dir
+ */
+function findConfigFile() {
+    const candidates = [];
+    const envPath = process.env.CONTEXTENGINE_CONFIG;
+    if (envPath) {
+        candidates.push(resolve(envPath));
+    }
+    candidates.push(resolve(process.cwd(), "contextengine.json"), resolve(homedir(), ".contextengine.json"));
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+/**
+ * Auto-discover knowledge files by scanning directories for known patterns.
+ * Scans one level deep (each subdirectory = a project).
+ */
+function discoverSources(dirs, patterns) {
+    const sources = [];
+    for (const dir of dirs) {
+        const absDir = resolve(dir.replace(/^~/, homedir()));
+        if (!existsSync(absDir))
+            continue;
+        // Check patterns at this level
+        for (const pattern of patterns) {
+            const filePath = join(absDir, pattern);
+            if (existsSync(filePath)) {
+                const dirName = absDir.split("/").pop() || absDir;
+                const fileName = pattern.split("/").pop() || pattern;
+                sources.push({
+                    name: `${dirName} — ${fileName}`,
+                    path: filePath,
+                    type: "markdown",
+                });
+            }
+        }
+        // Scan one level deep (subdirectories = projects)
+        try {
+            for (const entry of readdirSync(absDir)) {
+                if (entry.startsWith(".") || entry === "node_modules")
+                    continue;
+                const subDir = join(absDir, entry);
+                try {
+                    if (!statSync(subDir).isDirectory())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                for (const pattern of patterns) {
+                    const filePath = join(subDir, pattern);
+                    if (existsSync(filePath)) {
+                        const fileName = pattern.split("/").pop() || pattern;
+                        sources.push({
+                            name: `${entry} — ${fileName}`,
+                            path: filePath,
+                            type: "markdown",
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Permission denied — skip
+        }
+    }
+    return sources;
+}
+/**
+ * Load knowledge sources.
+ *
+ * Resolution order:
+ * 1. Config file (CONTEXTENGINE_CONFIG env, ./contextengine.json, ~/.contextengine.json)
+ * 2. CONTEXTENGINE_WORKSPACES env var (colon-separated paths)
+ * 3. Auto-discover from ~/Projects
+ */
+export function loadSources() {
+    const configPath = findConfigFile();
+    if (configPath) {
+        console.error(`[ContextEngine] 📄 Config: ${configPath}`);
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        const sources = [];
+        // Explicit sources
+        if (config.sources) {
+            for (const s of config.sources) {
+                const absPath = resolve(configPath, "..", s.path.replace(/^~/, homedir()));
+                if (existsSync(absPath)) {
+                    sources.push({ name: s.name, path: absPath, type: "markdown" });
+                }
+                else {
+                    console.error(`[ContextEngine] ⚠ Not found: ${absPath}`);
+                }
+            }
+        }
+        // Workspace auto-discovery
+        if (config.workspaces) {
+            const patterns = config.patterns || DEFAULT_PATTERNS;
+            const resolved = config.workspaces.map((w) => resolve(configPath, "..", w.replace(/^~/, homedir())));
+            sources.push(...discoverSources(resolved, patterns));
+        }
+        return dedup(sources);
+    }
+    // Env var fallback
+    const envWorkspaces = process.env.CONTEXTENGINE_WORKSPACES;
+    if (envWorkspaces) {
+        console.error(`[ContextEngine] 🔍 Discovering from CONTEXTENGINE_WORKSPACES`);
+        const dirs = envWorkspaces.split(":").filter(Boolean);
+        return dedup(discoverSources(dirs, DEFAULT_PATTERNS));
+    }
+    // Auto-discover from ~/Projects
+    const projectsDir = resolve(homedir(), "Projects");
+    if (existsSync(projectsDir)) {
+        console.error(`[ContextEngine] 🔍 Auto-discovering from ~/Projects`);
+        return dedup(discoverSources([projectsDir], DEFAULT_PATTERNS));
+    }
+    console.error(`[ContextEngine] ⚠ No sources found. Create contextengine.json or set CONTEXTENGINE_WORKSPACES.`);
+    return [];
+}
+/** Remove duplicate paths */
+function dedup(sources) {
+    const seen = new Set();
+    return sources.filter((s) => {
+        if (seen.has(s.path))
+            return false;
+        seen.add(s.path);
+        return true;
+    });
+}
+/**
+ * Discover project directories from workspaces.
+ * Returns one entry per top-level project found.
+ */
+export function loadProjectDirs() {
+    const configPath = findConfigFile();
+    const dirs = [];
+    let workspaceDirs = [];
+    if (configPath) {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        if (config.collectOps === false)
+            return []; // opted out
+        if (config.workspaces) {
+            workspaceDirs = config.workspaces.map((w) => resolve(configPath, "..", w.replace(/^~/, homedir())));
+        }
+    }
+    // Env var fallback
+    if (workspaceDirs.length === 0) {
+        const envWorkspaces = process.env.CONTEXTENGINE_WORKSPACES;
+        if (envWorkspaces) {
+            workspaceDirs = envWorkspaces.split(":").filter(Boolean);
+        }
+    }
+    // Auto-discover fallback
+    if (workspaceDirs.length === 0) {
+        const projectsDir = resolve(homedir(), "Projects");
+        if (existsSync(projectsDir)) {
+            workspaceDirs = [projectsDir];
+        }
+    }
+    for (const wsDir of workspaceDirs) {
+        const absDir = resolve(wsDir.replace(/^~/, homedir()));
+        if (!existsSync(absDir))
+            continue;
+        try {
+            for (const entry of readdirSync(absDir)) {
+                if (entry.startsWith(".") || entry === "node_modules")
+                    continue;
+                const subDir = join(absDir, entry);
+                try {
+                    if (!statSync(subDir).isDirectory())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                dirs.push({ name: entry, path: subDir });
+            }
+        }
+        catch {
+            // Permission denied — skip
+        }
+    }
+    return dirs;
+}
+/**
+ * Load the raw config (for checking flags like collectSystemOps).
+ */
+export function loadConfig() {
+    const configPath = findConfigFile();
+    if (configPath) {
+        return JSON.parse(readFileSync(configPath, "utf-8"));
+    }
+    return {};
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/embeddings.d.ts

@@ -0,0 +1,31 @@
+import type { Chunk } from "./ingest.js";
+/**
+ * Initialize the embedding pipeline (downloads model on first run, ~22MB).
+ * Subsequent calls use cached model.
+ */
+export declare function initEmbeddings(): Promise<boolean>;
+/**
+ * An embedded chunk with its vector.
+ */
+export interface EmbeddedChunk {
+    chunk: Chunk;
+    vector: Float32Array;
+}
+/**
+ * Embed all chunks. Returns the chunks with their vectors.
+ * Shows progress on stderr.
+ */
+export declare function embedChunks(chunks: Chunk[]): Promise<EmbeddedChunk[]>;
+export interface VectorSearchResult {
+    chunk: Chunk;
+    score: number;
+}
+/**
+ * Semantic search: embed the query, then find most similar chunks.
+ */
+export declare function vectorSearch(query: string, embeddedChunks: EmbeddedChunk[], topK?: number): Promise<VectorSearchResult[]>;
+/**
+ * Check if embeddings are available.
+ */
+export declare function isEmbeddingsReady(): boolean;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAQzC;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAgBvD;AA2BD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAwB3E;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,aAAa,EAAE,EAC/B,IAAI,GAAE,MAAW,GAChB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAY/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/embeddings.js

@@ -0,0 +1,91 @@
+// We dynamically import @huggingface/transformers to keep startup fast
+// and handle the case where it fails gracefully.
+let embedPipeline = null;
+const MODEL_NAME = "Xenova/all-MiniLM-L6-v2";
+/**
+ * Initialize the embedding pipeline (downloads model on first run, ~22MB).
+ * Subsequent calls use cached model.
+ */
+export async function initEmbeddings() {
+    try {
+        console.error(`[ContextEngine] 🧠 Loading embedding model: ${MODEL_NAME}...`);
+        const { pipeline } = await import("@huggingface/transformers");
+        embedPipeline = await pipeline("feature-extraction", MODEL_NAME, {
+            dtype: "fp32",
+        });
+        console.error(`[ContextEngine] ✅ Embedding model loaded`);
+        return true;
+    }
+    catch (err) {
+        console.error(`[ContextEngine] ⚠ Embeddings unavailable (keyword search only):`, err.message);
+        return false;
+    }
+}
+/**
+ * Embed a single text string → float32 vector (384 dimensions).
+ */
+async function embedText(text) {
+    const output = await embedPipeline(text, {
+        pooling: "mean",
+        normalize: true,
+    });
+    // output.data is a flat typed array
+    return new Float32Array(output.data);
+}
+/**
+ * Cosine similarity between two vectors.
+ * Both must be normalized (which MiniLM + normalize:true guarantees),
+ * so dot product = cosine similarity.
+ */
+function cosineSimilarity(a, b) {
+    let dot = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+    }
+    return dot;
+}
+/**
+ * Embed all chunks. Returns the chunks with their vectors.
+ * Shows progress on stderr.
+ */
+export async function embedChunks(chunks) {
+    const results = [];
+    const total = chunks.length;
+    const batchSize = 10;
+    for (let i = 0; i < total; i += batchSize) {
+        const batch = chunks.slice(i, i + batchSize);
+        const batchResults = await Promise.all(batch.map(async (chunk) => {
+            // Embed section + content together for context
+            const text = `${chunk.section}\n${chunk.content}`.slice(0, 512);
+            const vector = await embedText(text);
+            return { chunk, vector };
+        }));
+        results.push(...batchResults);
+        const done = Math.min(i + batchSize, total);
+        if (done % 50 === 0 || done === total) {
+            console.error(`[ContextEngine] 📊 Embedded ${done}/${total} chunks`);
+        }
+    }
+    return results;
+}
+/**
+ * Semantic search: embed the query, then find most similar chunks.
+ */
+export async function vectorSearch(query, embeddedChunks, topK = 10) {
+    if (!embedPipeline || embeddedChunks.length === 0)
+        return [];
+    const queryVector = await embedText(query);
+    const scored = embeddedChunks.map((ec) => ({
+        chunk: ec.chunk,
+        score: cosineSimilarity(queryVector, ec.vector),
+    }));
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, topK);
+}
+/**
+ * Check if embeddings are available.
+ */
+export function isEmbeddingsReady() {
+    return embedPipeline !== null;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/embeddings.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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