@philau2512/fast-context-mcp 1.5.6 → 1.5.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@philau2512/fast-context-mcp",
-  "version": "1.5.6",
+  "version": "1.5.7",
   "description": "AI-driven semantic code search MCP server (Node.js) — Windsurf/Devin protocol",
   "type": "module",
   "main": "src/server.mjs",

package/src/project-path.mjs

@@ -1,61 +1,70 @@
 import { statSync } from "node:fs";
-import { isAbsolute, resolve } from "node:path";
+import { homedir } from "node:os";
+import { isAbsolute, normalize } from "node:path";
 import { z } from "zod";
 
 export const PROJECT_PATH_REQUIRED_MESSAGE =
-  "project_path is optional. Pass the absolute or relative path to the project root directory, or omit to use current working directory.";
+  "project_path is required. Pass the absolute path to the project root directory.";
 
 export const projectPathSchema = z
   .string()
   .trim()
-  .nullish()
-  .transform((val) => val ?? "")
-  .default("");
+  .min(1, PROJECT_PATH_REQUIRED_MESSAGE);
 
 /**
- * Resolve project path to an absolute path.
- * If empty, null, or ".", defaults to cwd (process.cwd()).
- * If relative, resolves against cwd.
- *
- * @param {string|null|undefined} projectPath
- * @param {string} [cwd]
- * @returns {string}
+ * Check if a path points to the user's home directory or system root.
+ * @param {string} p
+ * @returns {boolean}
  */
-export function resolveProjectPath(projectPath, cwd = process.cwd()) {
-  const trimmed = typeof projectPath === "string" ? projectPath.trim() : "";
-  if (!trimmed || trimmed === "." || trimmed === "./" || trimmed === ".\\") {
-    return cwd;
+export function isHomeOrRootDir(p) {
+  if (!p || typeof p !== "string") return false;
+  const trimmed = p.trim();
+  if (trimmed === "/" || trimmed === "\\" || /^[a-zA-Z]:[\\/]*$/.test(trimmed)) {
+    return true;
+  }
+  const norm = normalize(trimmed).replace(/[\\/]+$/, "");
+  const home = normalize(homedir()).replace(/[\\/]+$/, "");
+  if (norm.toLowerCase() === home.toLowerCase()) {
+    return true;
   }
-  if (isAbsolute(trimmed)) {
-    return trimmed;
+  if (/^[a-zA-Z]:$/.test(norm) || norm === "" || norm === "/" || norm === "\\") {
+    return true;
   }
-  return resolve(cwd, trimmed);
+  return false;
 }
 
 /**
  * Validate the project root path provided to fast_context_search.
- * Automatically resolves relative paths or empty/omitted paths against cwd.
  * Returns null when valid, otherwise an MCP-friendly error string.
  *
  * @param {string} projectPath
  * @param {(path: string) => import("node:fs").Stats} [statFn]
- * @param {string} [cwd]
  * @returns {string|null}
  */
-export function validateProjectPath(projectPath, statFn = statSync, cwd = process.cwd()) {
-  const resolved = resolveProjectPath(projectPath, cwd);
+export function validateProjectPath(projectPath, statFn = statSync) {
+  if (!projectPath) {
+    return `Error: ${PROJECT_PATH_REQUIRED_MESSAGE}`;
+  }
+
+  if (!isAbsolute(projectPath)) {
+    return `Error: project_path must be an absolute path, got: ${projectPath}`;
+  }
+
+  if (isHomeOrRootDir(projectPath)) {
+    return `Error: project_path cannot be the user home directory or system root: ${projectPath}. Please provide the specific workspace path (e.g. 'C:/PROJECTS/my-app').`;
+  }
 
   try {
-    const st = statFn(resolved);
+    const st = statFn(projectPath);
     if (!st.isDirectory()) {
-      return `Error: project_path is not a directory: ${resolved}`;
+      return `Error: project_path is not a directory: ${projectPath}`;
     }
   } catch (error) {
     if (error?.code === "ENOENT") {
-      return `Error: project_path does not exist: ${resolved}`;
+      return `Error: project_path does not exist: ${projectPath}`;
     }
     if (error?.code === "EACCES" || error?.code === "EPERM") {
-      return `Error: cannot access project_path (${error.code}): ${resolved}`;
+      return `Error: cannot access project_path (${error.code}): ${projectPath}`;
     }
     const reason = error?.message ? `${error.code || "UNKNOWN"}: ${error.message}` : String(error);
     return `Error: failed to validate project_path: ${reason}`;

package/src/server.mjs

@@ -22,11 +22,7 @@ import { fileURLToPath } from "node:url";
 import { z } from "zod";
 
 import { searchWithContent, extractKeyInfo } from "./core.mjs";
-import {
-  projectPathSchema,
-  resolveProjectPath,
-  validateProjectPath,
-} from "./project-path.mjs";
+import { projectPathSchema, validateProjectPath } from "./project-path.mjs";
 
 const PACKAGE_JSON = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 export const SERVER_VERSION = PACKAGE_JSON.version;
@@ -126,9 +122,8 @@ export function buildFastContextSearchTool({
       'Add local-language business terms only when needed.'
     ),
     project_path: projectPathSchema.describe(
-      "Optional path to project root directory (absolute or relative). " +
-      "Defaults to current workspace directory if omitted. " +
-      "Example: /Users/username/projects/myproject or C:/Users/username/projects/myproject or ."
+      "Absolute path to the project root directory (REQUIRED). " +
+      "Pass the active workspace directory from your session context (e.g. 'C:/PROJECTS/myproject' or '/Users/name/projects/myproject')."
     ),
     tree_depth: z
       .number()
@@ -196,7 +191,7 @@ export function buildFastContextSearchTool({
     exclude_paths,
     include_code_snippets,
   }) => {
-    const projectPath = resolveProjectPath(project_path);
+    const projectPath = project_path;
     const validationError = validatePath(projectPath);
     if (validationError) {
       return { content: [{ type: "text", text: validationError }] };