@prom.codes/context-mcp 0.4.4 → 0.4.6

package/README.md

@@ -25,10 +25,15 @@ MCP hosts (Cursor, VS Code) use the same command/args in their own config.
   the MCP `roots` capability. Set it only to point at a different folder.
 - The index is a local SQLite DB at `~/.prometheus/<hash>.db` (one per project).
   Your code never leaves your machine — only embedding *text* transits to the proxy.
+- **Won't crawl your home folder.** If a fresh window opens with no project, the
+  workspace falls back to the host cwd (often home); the server **refuses to
+  auto-index the home directory or a filesystem root** and leaves the index empty
+  until you open a real project. Call `index_status` to see what's going on.
 
 Tools: `search_code`, `get_symbol`, `find_references`, `find_callers`,
 `find_callees`, `expand_context`, `get_file`, `list_changed_since`,
-`list_workspaces`, `framework_overview`.
+`list_workspaces`, `framework_overview`, `index_status` (health check:
+which folder, how much is indexed, does the key work?).
 
 ## Native modules
 

package/dist/bin.js

@@ -3369,7 +3369,7 @@ async function runEmbedPass(storage, embedder, options, driftRecovered) {
 
 // ../indexer/dist/watcher.js
 import chokidar from "chokidar";
-import { resolve, sep } from "node:path";
+import { resolve as resolve2, sep } from "node:path";
 import { EventEmitter } from "node:events";
 
 // ../shared/dist/types.js
@@ -3631,6 +3631,20 @@ function notify(log, name, current, latest) {
 `);
 }
 
+// ../shared/dist/workspace-root.js
+import { homedir as homedir2 } from "node:os";
+import { dirname, resolve } from "node:path";
+function isHomeOrFilesystemRoot(root) {
+  const abs = resolve(root);
+  if (abs === "")
+    return true;
+  if (abs === resolve(homedir2()))
+    return true;
+  if (dirname(abs) === abs)
+    return true;
+  return false;
+}
+
 // ../shared/dist/index.js
 var PROMETHEUS_VERSION = "0.1.0";
 
@@ -3695,7 +3709,7 @@ var WorkspaceWatcher = class extends EventEmitter {
   #pending = /* @__PURE__ */ new Map();
   constructor(options) {
     super();
-    this.#root = resolve(options.root);
+    this.#root = resolve2(options.root);
     this.#ignored = options.ignored ?? DEFAULT_IGNORED;
     this.#debounceMs = options.debounceMs ?? 50;
     const envPolling = process.env.CHOKIDAR_USEPOLLING === "true" || process.env.CHOKIDAR_USEPOLLING === "1";
@@ -3773,7 +3787,7 @@ var WorkspaceWatcher = class extends EventEmitter {
 
 // ../indexer/dist/workspace-indexer.js
 import { readFile as readFile3, readdir, stat } from "node:fs/promises";
-import { join as join2, resolve as resolve2, sep as sep2 } from "node:path";
+import { join as join2, resolve as resolve3, sep as sep2 } from "node:path";
 
 // ../indexer/dist/co-change.js
 import { spawn } from "node:child_process";
@@ -3978,7 +3992,7 @@ var WorkspaceIndexer = class {
   #watchTuning;
   #watcher = null;
   constructor(options) {
-    this.#root = resolve2(options.root);
+    this.#root = resolve3(options.root);
     this.#storage = options.storage;
     this.#indexer = options.indexer ?? new Indexer();
     this.#ownsIndexer = options.indexer === void 0;
@@ -4171,8 +4185,8 @@ var WorkspaceIndexer = class {
 // dist/composition.js
 import { createHash as createHash3 } from "node:crypto";
 import { mkdirSync } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { basename as basename5, dirname as dirname2, join as join4, resolve as resolve4 } from "node:path";
+import { homedir as homedir3 } from "node:os";
+import { basename as basename5, dirname as dirname3, join as join4, resolve as resolve5 } from "node:path";
 
 // ../storage-sqlite/dist/adapter.js
 import Database from "better-sqlite3";
@@ -4897,7 +4911,7 @@ var DEFAULT_VECTOR_DIMENSION = 1024;
 var DEFAULT_SCHEMA = "public";
 
 // ../storage-supabase/dist/migrations.js
-import { dirname, join as join3, resolve as resolve3 } from "node:path";
+import { dirname as dirname2, join as join3, resolve as resolve4 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // ../storage-supabase/dist/migrations-data.generated.js
@@ -4989,8 +5003,8 @@ COMMIT;
 };
 
 // ../storage-supabase/dist/migrations.js
-var HERE = dirname(fileURLToPath2(import.meta.url));
-var REPO_ROOT = resolve3(HERE, "..", "..", "..");
+var HERE = dirname2(fileURLToPath2(import.meta.url));
+var REPO_ROOT = resolve4(HERE, "..", "..", "..");
 var MIGRATIONS_DIR = join3(REPO_ROOT, "infra", "supabase", "migrations");
 var MIGRATIONS = Object.keys(EMBEDDED_MIGRATIONS).sort().map((filename, idx) => ({
   id: idx + 1,
@@ -6574,14 +6588,14 @@ function parseRetryAfterMs(value, now = Date.now()) {
   return delta > 0 ? delta : 0;
 }
 function sleep(ms, signal) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     if (signal?.aborted === true) {
       reject(new Error("aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve6();
+      resolve7();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -6809,14 +6823,14 @@ function taskTypeFor(inputType) {
   return inputType === "query" ? "RETRIEVAL_QUERY" : "RETRIEVAL_DOCUMENT";
 }
 function sleep2(ms, signal) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     if (signal?.aborted === true) {
       reject(new Error("aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve6();
+      resolve7();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -6946,14 +6960,14 @@ var DEFAULT_BATCH3 = 96;
 var DEFAULT_RETRIES3 = 4;
 var DEFAULT_BACKOFF3 = 250;
 function sleep3(ms, signal) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     if (signal?.aborted === true) {
       reject(new Error("aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve6();
+      resolve7();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -7096,14 +7110,14 @@ var DEFAULT_BATCH_CHARS = 4e5;
 var DEFAULT_RETRIES4 = 4;
 var DEFAULT_BACKOFF4 = 250;
 function sleep4(ms, signal) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     if (signal?.aborted === true) {
       reject(new Error("aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve6();
+      resolve7();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -7418,14 +7432,14 @@ function parseRetryAfterMs2(value, now = Date.now()) {
   return delta > 0 ? delta : 0;
 }
 function sleep5(ms, signal) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     if (signal?.aborted === true) {
       reject(new Error("aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve6();
+      resolve7();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -7590,14 +7604,14 @@ function parseRetryAfterMs3(value, now = Date.now()) {
   return delta > 0 ? delta : 0;
 }
 function sleep6(ms, signal) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     if (signal?.aborted === true) {
       reject(new Error("aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve6();
+      resolve7();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -7789,14 +7803,14 @@ function parseRetryAfterMs4(value, now = Date.now()) {
   return delta > 0 ? delta : 0;
 }
 function sleep7(ms, signal) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     if (signal?.aborted === true) {
       reject(new Error("aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve6();
+      resolve7();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -7960,14 +7974,14 @@ function parseRetryAfterMs5(value, now = Date.now()) {
   return delta > 0 ? delta : 0;
 }
 function sleep8(ms, signal) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     if (signal?.aborted === true) {
       reject(new Error("aborted"));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve6();
+      resolve7();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -8434,9 +8448,12 @@ function discoverQueryRewriter(env, fetchImpl) {
   throw new NoProviderError(`unknown PROMETHEUS_REWRITER_PROVIDER="${forced}" (expected "none", "gemini", or "mistral")`);
 }
 function getStableDbPath(workspaceRoot) {
-  const abs = resolve4(workspaceRoot);
+  const abs = resolve5(workspaceRoot);
   const hash = createHash3("sha256").update(abs).digest("hex").slice(0, 16);
-  return join4(homedir2(), ".prometheus", `${hash}.db`);
+  return join4(homedir3(), ".prometheus", `${hash}.db`);
+}
+function isAutoIndexableRoot(workspaceRoot) {
+  return !isHomeOrFilesystemRoot(workspaceRoot);
 }
 var StorageConfigError = class extends Error {
   constructor(reason) {
@@ -8476,7 +8493,7 @@ function discoverStorageBackend(env, regionMode, options = {}) {
     }
     const writable = options.writable === true;
     if (writable && dbPath !== ":memory:") {
-      mkdirSync(dirname2(dbPath), { recursive: true });
+      mkdirSync(dirname3(dbPath), { recursive: true });
     }
     return {
       id: "sqlite",
@@ -8526,6 +8543,7 @@ async function composeFromEnv(opts) {
   const rerankTopN = intEnv(env, "PROMETHEUS_RERANK_TOP_N", 100);
   const { id: queryRewriterId, provider: queryRewriter } = discoverQueryRewriter(env, opts.fetch);
   const managed = apiKeyPresent && storageBackend === "sqlite";
+  const autoIndexable = isAutoIndexableRoot(workspaceRoot);
   let closed = false;
   return {
     storage,
@@ -8538,6 +8556,7 @@ async function composeFromEnv(opts) {
     providerId,
     storageBackend,
     managed,
+    autoIndexable,
     dbPath,
     reranker,
     rerankId,
@@ -8588,7 +8607,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // dist/tools.js
 import { readFile as readFile4 } from "node:fs/promises";
-import { isAbsolute, join as join5, normalize, relative, resolve as resolve5, sep as sep3 } from "node:path";
+import { isAbsolute, join as join5, normalize, relative, resolve as resolve6, sep as sep3 } from "node:path";
 import { z } from "zod";
 
 // dist/frameworks.js
@@ -8847,7 +8866,7 @@ function resolveInWorkspace(workspaceRoot, input) {
     throw new Error(`path "${input}" must be relative to the workspace root.`);
   }
   const normalised = normalize(input);
-  const abs = resolve5(workspaceRoot, normalised);
+  const abs = resolve6(workspaceRoot, normalised);
   const rel = relative(workspaceRoot, abs);
   if (rel === "" || rel.startsWith("..") || sep3 !== "/" && rel.startsWith(`..${sep3}`)) {
     throw new Error(`path "${input}" escapes the workspace root.`);
@@ -8912,7 +8931,7 @@ var changedSinceInput = {
 };
 var emptyInput = {};
 function registerTools(server, deps) {
-  const { storage, retriever, workspaceRoot, workspaceId, workspaceName, regionMode, providerId, storageBackend, reranker, rerankTopN, queryRewriter } = deps;
+  const { storage, embedder, retriever, workspaceRoot, workspaceId, workspaceName, regionMode, providerId, storageBackend, managed, autoIndexable, dbPath, reranker, rerankTopN, queryRewriter } = deps;
   server.registerTool("search_code", {
     title: "Hybrid code search",
     description: (
@@ -9140,6 +9159,50 @@ ${hyp}`;
       languages
     });
   });
+  server.registerTool("index_status", {
+    title: "Index status / health check",
+    description: "Health check for this workspace's code index. Reports the resolved workspace root, the on-disk index path, whether auto-indexing is enabled AND allowed for this root (it is refused for the home directory / filesystem root), how much is indexed (files / symbols / references + per-language counts), the embedding provider, and \u2014 best-effort, zero-cost \u2014 whether embeddings are reachable with the configured key. CALL THIS FIRST when `search_code` returns nothing, when you're unsure whether the right folder is indexed, or to confirm the API key works.",
+    inputSchema: emptyInput
+  }, async () => {
+    const [stats, languages] = await Promise.all([
+      storage.stats(),
+      languageDistribution(storage)
+    ]);
+    const indexed = stats.fileCount > 0;
+    let embeddingsReachable = null;
+    let embeddingsError = null;
+    const resolveIdentity = embedder.resolveIdentity;
+    if (typeof resolveIdentity === "function") {
+      try {
+        await resolveIdentity.call(embedder);
+        embeddingsReachable = true;
+      } catch (err) {
+        embeddingsReachable = false;
+        embeddingsError = err instanceof Error ? err.message : String(err);
+      }
+    }
+    const autoIndexReason = !managed ? "disabled \u2014 no PROMETHEUS_API_KEY (keyword + symbol-graph only)" : autoIndexable ? "enabled \u2014 indexing this workspace" : "SKIPPED \u2014 workspace is your home directory or a filesystem root; open a project folder or set PROMETHEUS_WORKSPACE_ROOT, then restart";
+    const summary = indexed ? `Indexed ${stats.fileCount} files / ${stats.symbolCount} symbols at ${workspaceRoot}.` : managed && !autoIndexable ? `Empty index: auto-indexing was refused because the workspace resolved to ${workspaceRoot} (home/root). Open your project folder and restart.` : managed ? `Empty index: indexing may still be running, or this folder has no supported source files. Workspace: ${workspaceRoot}.` : `Empty index: no API key, so nothing was embedded/indexed. Semantic search is off; lexical + structural tools still work. Workspace: ${workspaceRoot}.`;
+    return textResult({
+      installed: true,
+      workspace: { id: workspaceId, name: workspaceName, root: workspaceRoot },
+      storage: { backend: storageBackend, dbPath, regionMode },
+      autoIndex: { managed, allowedForThisRoot: autoIndexable, reason: autoIndexReason },
+      index: {
+        indexed,
+        files: stats.fileCount,
+        symbols: stats.symbolCount,
+        references: stats.referenceCount,
+        languages
+      },
+      embeddings: {
+        provider: providerId,
+        reachable: embeddingsReachable,
+        ...embeddingsError !== null ? { error: embeddingsError } : {}
+      },
+      summary
+    });
+  });
 }
 
 // dist/server.js
@@ -9225,8 +9288,12 @@ async function main() {
     process.stderr.write(`prometheus-context-mcp: storage=${composed.storageBackend} provider=${composed.providerId} region-mode=${composed.regionMode} managed=${composed.managed} workspace=${composed.workspaceRoot} (via ${via})${composed.dbPath !== null ? ` db=${composed.dbPath}` : ""}
 `);
     registerTools(server, composed);
-    if (composed.managed)
+    if (composed.managed && composed.autoIndexable) {
       managedIndexer = startManagedIndexing(composed);
+    } else if (composed.managed && !composed.autoIndexable) {
+      process.stderr.write(`prometheus-context-mcp: workspace resolved to ${composed.workspaceRoot} (your home directory or a filesystem root) \u2014 NOT auto-indexing it. Open a project folder (Claude Code passes it via CLAUDE_PROJECT_DIR) or set PROMETHEUS_WORKSPACE_ROOT to your repo, then restart. Call index_status for details.
+`);
+    }
   };
   if (eagerVia !== null) {
     await boot(void 0, eagerVia);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prom.codes/context-mcp",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "prom.codes Context — local-first codebase indexing & retrieval as an MCP server.",
   "type": "module",
   "bin": {