codebasesearch 0.1.18 → 0.1.20

package/.prd

@@ -0,0 +1,58 @@
+{
+  "project": "thorns-mcp",
+  "created": "2026-03-06",
+  "objective": "Improve search output to be maximally revealing so agents need minimal follow-up exploration",
+  "items": [
+    {
+      "id": "1",
+      "subject": "Expand snippet from 3 lines to full chunk content in search-worker.js",
+      "status": "pending",
+      "description": "In search-worker.js line 63, snippet is truncated to 3 lines. Show full chunk content (up to ~30 lines) so agents see the complete context. Also add totalLines to each result by counting newlines in full file content.",
+      "blocking": ["3"],
+      "blockedBy": [],
+      "effort": "small",
+      "category": "feature"
+    },
+    {
+      "id": "2",
+      "subject": "Add enclosing function/class context detection to search-worker.js",
+      "status": "pending",
+      "description": "For each result, detect the nearest enclosing function or class name above the match line. Pass this as 'context' field in the result object. Use regex scan backwards through lines above line_start.",
+      "blocking": ["3"],
+      "blockedBy": [],
+      "effort": "medium",
+      "category": "feature"
+    },
+    {
+      "id": "3",
+      "subject": "Update mcp.js output formatter to display all new fields",
+      "status": "pending",
+      "description": "Update the result formatting in mcp.js to show: totalLines alongside path (e.g. 'file.js [142 lines]:5-20'), enclosing context (e.g. 'in: functionName'), and the full snippet. Also show relative path when repository_path is provided.",
+      "blocking": ["4"],
+      "blockedBy": ["1", "2"],
+      "effort": "small",
+      "category": "feature"
+    },
+    {
+      "id": "4",
+      "subject": "Verify output quality by running CLI on /mnt/c/dev/spawnpoint",
+      "status": "pending",
+      "description": "Run: node src/cli.js /mnt/c/dev/spawnpoint with a test query and inspect the output quality. Confirm snippets are longer, context is shown, line counts are shown.",
+      "blocking": ["5"],
+      "blockedBy": ["3"],
+      "effort": "small",
+      "category": "feature"
+    },
+    {
+      "id": "5",
+      "subject": "Bump version to 0.1.19 and git push",
+      "status": "pending",
+      "description": "Update package.json version from 0.1.18 to 0.1.19, git add -A, commit, push.",
+      "blocking": [],
+      "blockedBy": ["4"],
+      "effort": "small",
+      "category": "infra"
+    }
+  ],
+  "completed": []
+}

package/mcp.js

@@ -134,17 +134,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       };
     }
 
+    const repoPath = typeof repositoryPath === 'string' ? repositoryPath : null;
     const text =
       result.resultsCount === 0
-        ? `No results found for query: "${query}"\nRepository: ${result.repository}`
-        : `Found ${result.resultsCount} result${result.resultsCount !== 1 ? 's' : ''} for query: "${query}"\nRepository: ${result.repository}\n\n${result.results
-            .map(
-              (r) =>
-                `${r.rank}. ${r.relativePath}:${r.lines} (score: ${r.score}%)\n${r.snippet
-                  .split('\n')
-                  .map((line) => `   ${line}`)
-                  .join('\n')}`
-            )
+        ? `No results found for query: "${query}"`
+        : `Found ${result.resultsCount} result${result.resultsCount !== 1 ? 's' : ''} for query: "${query}"\n\n${result.results
+            .map((r) => {
+              const pathPart = r.relativePath || r.absolutePath;
+              const lineCount = r.totalLines ? ` [${r.totalLines}L]` : '';
+              const ctx = r.enclosingContext ? ` (in: ${r.enclosingContext})` : '';
+              const header = `${r.rank}. ${pathPart}${lineCount}:${r.lines}${ctx} (score: ${r.score}%)`;
+              const body = r.snippet.split('\n').map((line) => `   ${line}`).join('\n');
+              return `${header}\n${body}`;
+            })
             .join('\n\n')}`;
 
     return {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "codebasesearch",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Ultra-simple code search tool with Jina embeddings, LanceDB, and MCP protocol support",
   "type": "module",
   "bin": {
-    "codebasesearch": "./bin/code-search.js",
-    "codebasesearch-mcp": "./mcp.js"
+    "codebasesearch": "bin/code-search.js",
+    "codebasesearch-mcp": "mcp.js"
   },
   "main": "src/cli.js",
   "repository": {

package/src/search-worker.js

@@ -1,10 +1,34 @@
 import { parentPort } from 'worker_threads';
 import { resolve, relative } from 'path';
-import { existsSync } from 'fs';
+import { existsSync, readFileSync } from 'fs';
 import { loadIgnorePatterns } from './ignore-parser.js';
 import { scanRepository } from './scanner.js';
 import { buildTextIndex, searchText } from './text-search.js';
 
+function findEnclosingContext(content, lineStart) {
+  const lines = content.split('\n');
+  const targetLine = Math.min(lineStart - 1, lines.length - 1);
+  const skip = new Set(['if', 'for', 'while', 'switch', 'catch', 'else']);
+  for (let i = targetLine; i >= 0; i--) {
+    const line = lines[i];
+    const m = line.match(/(?:^|\s)(?:async\s+)?(?:function\s+(\w+)|class\s+(\w+)|(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?\(|(?:static\s+)?(?:async\s+)?(\w+)\s*\([^)]*\)\s*\{)/);
+    if (m) {
+      const name = m[1] || m[2] || m[3] || m[4];
+      if (name && !skip.has(name)) return name;
+    }
+  }
+  return null;
+}
+
+function getFileTotalLines(absoluteFilePath) {
+  try {
+    const content = readFileSync(absoluteFilePath, 'utf8');
+    return content.split('\n').length;
+  } catch {
+    return null;
+  }
+}
+
 let indexCache = new Map();
 
 async function initializeIndex(repositoryPath) {
@@ -55,13 +79,18 @@ async function performSearch(repositoryPath, query) {
       resultsCount: results.length,
       results: results.slice(0, 10).map((result, idx) => {
         const absoluteFilePath = resolve(absolutePath, result.file_path);
+        const totalLines = getFileTotalLines(absoluteFilePath);
+        const enclosingContext = findEnclosingContext(result.content, result.line_start);
+        const relPath = relative(absolutePath, absoluteFilePath);
         return {
           rank: idx + 1,
-          file: result.file_path,
-          relativePath: relative(repositoryPath, absoluteFilePath),
+          absolutePath: absoluteFilePath,
+          relativePath: relPath,
           lines: `${result.line_start}-${result.line_end}`,
+          totalLines,
+          enclosingContext,
           score: (result.score * 100).toFixed(1),
-          snippet: result.content.split('\n').slice(0, 3).join('\n'),
+          snippet: result.content.split('\n').slice(0, 30).join('\n'),
         };
       }),
     };