@prom.codes/context-mcp 0.4.5 → 0.4.7

package/README.md

@@ -25,10 +25,23 @@ 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?).
+
+## Awareness
+
+The server advertises MCP `instructions` that tell the agent to PREFER
+`search_code` + the graph tools over a manual grep→read loop. Context tools are
+reactive (the agent reaches for them when it needs code), so — unlike memory —
+no rule file is installed; the instructions + assertive tool descriptions are
+enough to win over plain grep on a large or unfamiliar repo.
 
 ## 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,19 +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) {
-  const abs = resolve4(workspaceRoot);
-  if (abs === "")
-    return false;
-  if (abs === resolve4(homedir2()))
-    return false;
-  if (dirname2(abs) === abs)
-    return false;
-  return true;
+  return !isHomeOrFilesystemRoot(workspaceRoot);
 }
 var StorageConfigError = class extends Error {
   constructor(reason) {
@@ -8486,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",
@@ -8600,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
@@ -8859,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.`);
@@ -9204,6 +9211,7 @@ var SERVER_IDENTITY = {
   version: PROMETHEUS_VERSION,
   title: "prom.codes Context"
 };
+var SERVER_INSTRUCTIONS = "This workspace is indexed by the prom.codes context engine. PREFER these tools over a manual grep/read loop when navigating code: search_code (hybrid semantic + lexical + symbol-graph \u2014 your FIRST move for any 'where/how is X' question, returns the code inline), get_symbol, find_references, find_callers, find_callees, expand_context, get_file. They are faster and more precise than scanning files by hand, especially on a large or unfamiliar repo. If search_code returns nothing or looks degraded, call index_status to check the index and the embedding key.";
 
 // dist/bin.js
 function errMessage(err) {
@@ -9251,7 +9259,10 @@ async function main() {
   const eagerVia = explicitRoot !== "" ? "PROMETHEUS_WORKSPACE_ROOT" : claudeRoot !== "" ? "CLAUDE_PROJECT_DIR" : null;
   void maybeNotifyUpdate(import.meta.url, env);
   const transport = new StdioServerTransport();
-  const server = new McpServer2(SERVER_IDENTITY, { capabilities: { tools: {} } });
+  const server = new McpServer2(SERVER_IDENTITY, {
+    capabilities: { tools: {} },
+    instructions: SERVER_INSTRUCTIONS
+  });
   let composed = null;
   let managedIndexer = null;
   const shutdown = async (signal) => {

package/package.json

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