@prom.codes/context-mcp 0.4.4 → 0.4.5

package/dist/bin.js

@@ -8438,6 +8438,16 @@ function getStableDbPath(workspaceRoot) {
   const hash = createHash3("sha256").update(abs).digest("hex").slice(0, 16);
   return join4(homedir2(), ".prometheus", `${hash}.db`);
 }
+function isAutoIndexableRoot(workspaceRoot) {
+  const abs = resolve4(workspaceRoot);
+  if (abs === "")
+    return false;
+  if (abs === resolve4(homedir2()))
+    return false;
+  if (dirname2(abs) === abs)
+    return false;
+  return true;
+}
 var StorageConfigError = class extends Error {
   constructor(reason) {
     super(`Storage configuration error: ${reason}`);
@@ -8526,6 +8536,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 +8549,7 @@ async function composeFromEnv(opts) {
     providerId,
     storageBackend,
     managed,
+    autoIndexable,
     dbPath,
     reranker,
     rerankId,
@@ -8912,7 +8924,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 +9152,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 +9281,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.5",
   "description": "prom.codes Context — local-first codebase indexing & retrieval as an MCP server.",
   "type": "module",
   "bin": {