@crowley/rag-mcp 1.0.2 → 1.0.3

package/dist/formatters.d.ts

@@ -26,6 +26,19 @@ export declare function formatMemoryResults(results: Array<{
     memory: Record<string, unknown>;
     score: number;
 }>, emptyMessage?: string): string;
+/** Format navigate-mode search results as compact navigation pointers */
+export declare function formatNavigationResults(results: Array<{
+    file: string;
+    lines?: [number, number];
+    symbols?: string[];
+    imports?: string[];
+    connections?: string[];
+    layer?: string;
+    service?: string;
+    preview?: string;
+    score: number;
+    graphExpanded?: boolean;
+}>): string;
 /** Format a simple list of files with scores */
 export declare function formatFileList(files: Array<{
     file: string;

package/dist/formatters.js

@@ -60,6 +60,26 @@ export function formatMemoryResults(results, emptyMessage = "No memories found."
     });
     return result;
 }
+/** Format navigate-mode search results as compact navigation pointers */
+export function formatNavigationResults(results) {
+    if (!results?.length)
+        return "No results found.";
+    return results.map(r => {
+        const loc = r.lines ? `:${r.lines[0]}-${r.lines[1]}` : '';
+        let out = `**${r.file}${loc}** (${pct(r.score)})`;
+        if (r.layer)
+            out += ` [${r.layer}]`;
+        if (r.graphExpanded)
+            out += ' _(graph)_';
+        if (r.preview)
+            out += `\n\`${truncate(r.preview, 100)}\``;
+        if (r.symbols?.length)
+            out += `\nSymbols: ${r.symbols.join(', ')}`;
+        if (r.connections?.length)
+            out += `\nConnections: ${r.connections.map(c => '`' + c + '`').join(', ')}`;
+        return out;
+    }).join('\n\n');
+}
 /** Format a simple list of files with scores */
 export function formatFileList(files, emptyMessage = "No files found.") {
     if (!files || files.length === 0)

package/dist/tools/search.js

@@ -2,7 +2,7 @@
  * Search tools module - codebase search, similarity search, grouped/hybrid search,
  * documentation search, and project statistics.
  */
-import { formatCodeResults, truncate, pct } from "../formatters.js";
+import { formatCodeResults, formatNavigationResults, truncate } from "../formatters.js";
 /**
  * Create the search tools module with project-specific descriptions.
  */
@@ -10,7 +10,7 @@ export function createSearchTools(projectName) {
     const tools = [
         {
             name: "search_codebase",
-            description: `Search the ${projectName} codebase for relevant code. Returns matching files with code snippets and relevance scores.`,
+            description: `Search the ${projectName} codebase. Returns file locations, symbols, and graph connections. Use Read tool to view the actual code at returned locations.`,
             inputSchema: {
                 type: "object",
                 properties: {
@@ -64,7 +64,7 @@ export function createSearchTools(projectName) {
         },
         {
             name: "grouped_search",
-            description: `Search ${projectName} codebase with results grouped by file. Returns one best match per file instead of multiple chunks.`,
+            description: `Search ${projectName} codebase grouped by file. Returns file locations with symbols and connections. Use Read tool to view the actual code.`,
             inputSchema: {
                 type: "object",
                 properties: {
@@ -100,7 +100,7 @@ export function createSearchTools(projectName) {
         },
         {
             name: "hybrid_search",
-            description: `Hybrid search combining keyword matching and semantic similarity for ${projectName}. Better for finding exact terms + related concepts.`,
+            description: `Hybrid search combining keyword matching and semantic similarity for ${projectName}. Returns file locations with symbols and connections. Use Read tool to view code.`,
             inputSchema: {
                 type: "object",
                 properties: {
@@ -186,7 +186,7 @@ export function createSearchTools(projectName) {
         },
         {
             name: "search_graph",
-            description: `Search ${projectName} codebase with graph expansion. Finds semantically similar code plus connected files via import/call relationships.`,
+            description: `Search ${projectName} codebase with graph expansion. Returns file locations plus connected files via import/call relationships. Use Read tool to view code.`,
             inputSchema: {
                 type: "object",
                 properties: {
@@ -216,13 +216,14 @@ export function createSearchTools(projectName) {
                 collection: `${ctx.collectionPrefix}codebase`,
                 query,
                 limit,
+                mode: "navigate",
                 filters: { language, path, layer, service },
             });
             const results = response.data.results;
             if (!results || results.length === 0) {
                 return "No results found for this query.";
             }
-            return formatCodeResults(results, 500);
+            return formatNavigationResults(results);
         },
         search_similar: async (args, ctx) => {
             const { code, limit = 5 } = args;
@@ -246,23 +247,15 @@ export function createSearchTools(projectName) {
                 query,
                 groupBy,
                 limit,
+                mode: "navigate",
                 filters: hasFilters ? filters : undefined,
             });
             const groups = response.data.groups;
             if (!groups || groups.length === 0) {
                 return "No results found.";
             }
-            return groups
-                .map((g) => {
-                const r = g.results[0];
-                return (`**${g[groupBy]}** (score: ${pct(r.score)})\n` +
-                    "```" +
-                    (r.language || "") +
-                    "\n" +
-                    truncate(r.content, 300) +
-                    "\n```");
-            })
-                .join("\n\n---\n\n");
+            const allResults = groups.flatMap((g) => g.results);
+            return formatNavigationResults(allResults);
         },
         hybrid_search: async (args, ctx) => {
             const { query, limit = 10, semanticWeight = 0.7, language, layer, service } = args;
@@ -273,20 +266,14 @@ export function createSearchTools(projectName) {
                 query,
                 limit,
                 semanticWeight,
+                mode: "navigate",
                 filters: hasFilters ? filters : undefined,
             });
             const results = response.data.results;
             if (!results || results.length === 0) {
                 return "No results found.";
             }
-            return results
-                .map((r) => `**${r.file}** (combined: ${pct(r.score)}${r.semanticScore != null ? `, semantic: ${pct(r.semanticScore)}` : ''}${r.keywordScore != null ? `, keyword: ${pct(r.keywordScore)}` : ''})\n` +
-                "```" +
-                (r.language || "") +
-                "\n" +
-                truncate(r.content, 300) +
-                "\n```")
-                .join("\n\n---\n\n");
+            return formatNavigationResults(results);
         },
         search_docs: async (args, ctx) => {
             const { query, limit = 5 } = args;
@@ -329,27 +316,20 @@ export function createSearchTools(projectName) {
                 query,
                 limit,
                 expandHops,
+                mode: "navigate",
             });
             const { results, graphExpanded, expandedFiles } = response.data;
+            if ((!results || results.length === 0) && (!graphExpanded || graphExpanded.length === 0)) {
+                return "No results found.";
+            }
             let output = "";
             if (results && results.length > 0) {
                 output += "**Direct matches:**\n\n";
-                output += results
-                    .map((r) => `**${r.file}** (score: ${pct(r.score)})\n` +
-                    "```" + (r.language || "") + "\n" +
-                    truncate(r.content, 300) + "\n```")
-                    .join("\n\n");
+                output += formatNavigationResults(results);
             }
             if (graphExpanded && graphExpanded.length > 0) {
                 output += "\n\n---\n\n**Graph-connected files:**\n\n";
-                output += graphExpanded
-                    .map((r) => `**${r.file}** (score: ${pct(r.score)})\n` +
-                    "```" + (r.language || "") + "\n" +
-                    truncate(r.content, 300) + "\n```")
-                    .join("\n\n");
-            }
-            if (!output) {
-                return "No results found.";
+                output += formatNavigationResults(graphExpanded);
             }
             if (expandedFiles && expandedFiles.length > 0) {
                 output += `\n\n_Graph expanded to ${expandedFiles.length} additional files._`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowley/rag-mcp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Universal RAG MCP Server for any project",
   "type": "module",
   "main": "dist/index.js",