codesearch-mcp 0.2.1-alpha → 0.2.3-alpha

package/dist/src/tools/format-helpers.js

@@ -1,11 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PATH_EXAMPLE = void 0;
 exports.textResponse = textResponse;
 exports.errorResponse = errorResponse;
 exports.formatChunk = formatChunk;
 exports.formatGraphContext = formatGraphContext;
 exports.formatDependencies = formatDependencies;
 exports.formatDependents = formatDependents;
+exports.pathArgDescription = pathArgDescription;
+exports.pathErrorText = pathErrorText;
+exports.pathErrorResponse = pathErrorResponse;
 function textResponse(text) {
     return { content: [{ type: 'text', text }] };
 }
@@ -56,3 +60,63 @@ function formatDependents(filePath, rows, transitive) {
     }
     return lines.join('\n');
 }
+exports.PATH_EXAMPLE = { file: 'my-app/src/index.ts', directory: 'my-app/src' };
+/** Description of a path argument; `kind` names what the path points at. */
+function pathArgDescription(kind = 'file') {
+    const root = kind === 'directory' ? ', "." for the workspace root' : '';
+    const noun = kind === 'directory' ? 'directory' : 'path';
+    return `Workspace-relative ${noun}, as printed by search_codebase (e.g. ${exports.PATH_EXAMPLE[kind]})${root}`;
+}
+function acceptedForm(example) {
+    return `Paths are workspace-relative, as printed by search_codebase — e.g. ${example}.`;
+}
+function notIndexedExplanation(e) {
+    const excluded = (why) => `This file is not indexed (${why}), so the graph has no data for it. Use read_file or Grep instead.`;
+    switch (e.kind) {
+        case 'no_project': return excluded('it is outside every project');
+        case 'type': return excluded('files of this type are not indexed');
+        case 'ignored_dir': return excluded(`${e.segment}/ is an ignored directory`);
+        case 'ragignore': return excluded('it matches .ragignore');
+        case 'project_not_indexed': return `Project ${e.project} is not in the index. If it is not selected, select it with rag-index --select; then run rag-index.`;
+        case 'unknown':
+            return 'The file exists on disk but the index has no data for it: either it was added after the last index run ' +
+                '(run rag-index), or it has no indexable content (empty, comments only, or imports of external packages only).';
+    }
+}
+/**
+ * Text of a path error. `input` is the raw argument (echoed by refusals);
+ * `relPath` its canonical form, printed by every other message.
+ */
+function pathErrorText(argName, input, relPath, err, kind = 'file') {
+    const example = exports.PATH_EXAMPLE[kind];
+    switch (err.reason) {
+        case 'invalid':
+            return err.missing
+                ? `Missing ${argName}\n${acceptedForm(example)}`
+                : `Invalid path (\\ is not a separator): ${input}\n${acceptedForm(example)}`;
+        case 'absolute':
+            return `Absolute path: ${input} — use ${err.relative}\n${acceptedForm(err.relative)}`;
+        case 'outside_workspace':
+            return `${input} is outside the workspace\n${acceptedForm(example)}`;
+        case 'not_found': {
+            const lines = [`Not found: ${relPath}`, acceptedForm(err.candidates[0] ?? example)];
+            if (err.candidates.length > 0)
+                lines.push('Did you mean:', ...err.candidates.map(c => `- ${c}`));
+            return lines.join('\n');
+        }
+        case 'deleted':
+            return `Deleted from disk: ${relPath}\nThe index still holds this file, but it no longer exists on disk. Run rag-index to update the index.`;
+        case 'not_indexed':
+            return `Not indexed: ${relPath}\n${notIndexedExplanation(err.explanation)}`;
+        case 'not_a_file': return `Not a file: ${relPath}`;
+        case 'not_a_directory': return `Not a directory: ${relPath}`;
+        case 'unreadable': return `Cannot read: ${relPath} (${err.code})`;
+        case 'past_end': return `${relPath} has ${err.lineCount} lines; start_line ${err.startLine} is past the end`;
+        case 'bad_range': return `end_line ${err.endLine} is before start_line ${err.startLine}`;
+    }
+}
+/** Error response for a path error, logged at `warn` — a caller or index-freshness problem, not a server fault. */
+function pathErrorResponse(logger, tool, argName, input, relPath, err, kind = 'file') {
+    logger.warn('Tool path error', { tool, input, reason: err.reason });
+    return errorResponse(pathErrorText(argName, input, relPath, err, kind));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesearch-mcp",
-  "version": "0.2.1-alpha",
+  "version": "0.2.3-alpha",
   "description": "Local semantic codebase search via MCP — indexes projects into pgvector, exposes search to Claude",
   "license": "MIT",
   "keywords": [
@@ -42,23 +42,24 @@
     "start:web": "ts-node app.ts web",
     "index:workspace": "ts-node app.ts index",
     "index:reindex": "ts-node app.ts index --reindex",
+    "index:project": "ts-node app.ts index --project",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
     "verify": "tsc --noEmit && vitest run"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.4.1",
-    "@langchain/textsplitters": "^1.0.1",
-    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@inquirer/prompts": "^8.7.3",
+    "@langchain/textsplitters": "^1.0.2",
+    "@modelcontextprotocol/sdk": "1.32.0",
     "cli-progress": "^3.12.0",
     "drizzle-orm": "^0.45.2",
     "ignore": "^7.0.5",
-    "pg": "^8.13.0",
-    "pino": "^10.3.1",
+    "pg": "^8.23.1",
+    "pino": "^10.4.0",
     "pino-roll": "^4.0.0",
     "ts-morph": "^28.0.0",
-    "zod": "^4.3.6"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "@types/cli-progress": "^3.11.6",
@@ -66,6 +67,6 @@
     "@types/pg": "^8.20.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.6.0",
-    "vitest": "^4.1.4"
+    "vitest": "^5.0.5"
   }
 }