@takara-ai/miru-code 0.4.9 → 0.4.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takara-ai/miru-code",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "Miru (見る) — hybrid code search for agents. Bun, TypeScript, Takara embeddings.",
   "type": "module",
   "license": "MIT",

package/src/installer/search-policy.ts

@@ -55,8 +55,8 @@ ${SEARCH_POLICY_BODY}
 ### MCP workflow
 
 1. Call \`search\` with \`repo\` set to the project root (local path or https:// git URL).
-2. Use returned \`file_path\` and \`line\` from hits; call \`find_related\` to explore neighbors.
-3. Read files only when a chunk lacks context or you are about to edit.
+2. Use \`absolute_path\` (local repos) or \`file_path\` plus line from hits; call \`find_related\` to explore neighbors.
+3. Read files via \`absolute_path\` when a chunk lacks context or you are about to edit.
 
 ### CLI fallback (no MCP in this session)
 

package/src/mcp/server.ts

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import * as z from "zod";
 import type { ContentType } from "../types.ts";
-import { formatResults, resolveChunk } from "../utils.ts";
+import { formatResults, localRepoRoot, resolveChunk } from "../utils.ts";
 import { getIndexForRepo, type IndexCache, toolText } from "./index-cache.ts";
 
 const REPO_DESCRIPTION =
@@ -13,6 +13,7 @@ const SERVER_INSTRUCTIONS =
   "DO NOT use Grep, Glob, SemanticSearch, or Read to explore code when this server is available. " +
   "Call `search` first for any question about how code works; call `find_related` on a hit to explore neighbors. " +
   "Always pass the project root as `repo` (local path or https:// git URL). Never guess URLs. " +
+  "Local repos return `absolute_path` on each hit — use it for Read/edit. " +
   "Native search is only for exact literal confirmation or files outside the indexed repo.";
 
 export function createMcpServer(cache: IndexCache): McpServer {
@@ -45,7 +46,8 @@ export function createMcpServer(cache: IndexCache): McpServer {
         if (results.length === 0) {
           return toolText(JSON.stringify({ error: "No results found." }));
         }
-        return toolText(JSON.stringify(formatResults(query, results)));
+        const repoRoot = localRepoRoot(repo);
+        return toolText(JSON.stringify(formatResults(query, results, { repoRoot })));
       } catch (err) {
         return toolText(err instanceof Error ? err.message : String(err));
       }
@@ -62,7 +64,7 @@ export function createMcpServer(cache: IndexCache): McpServer {
         file_path: z
           .string()
           .describe(
-            "Path to the file as stored in the index (use file_path from a search result).",
+            "Path from a search hit (`file_path` or `absolute_path` for local repos).",
           ),
         line: z.number().int().describe("Line number (1-indexed)."),
         repo: z.string().describe(REPO_DESCRIPTION),
@@ -72,7 +74,8 @@ export function createMcpServer(cache: IndexCache): McpServer {
     async ({ file_path: filePath, line, repo, top_k: topK }) => {
       try {
         const index = await getIndexForRepo(repo, cache);
-        const chunk = resolveChunk(index.chunks, filePath, line);
+        const repoRoot = localRepoRoot(repo);
+        const chunk = resolveChunk(index.chunks, filePath, line, repoRoot);
         if (!chunk) {
           return toolText(
             `No chunk found at ${filePath}:${line}. Make sure the file is indexed and the line number is within a known chunk.`,
@@ -85,7 +88,9 @@ export function createMcpServer(cache: IndexCache): McpServer {
           );
         }
         return toolText(
-          JSON.stringify(formatResults(`Chunks related to ${filePath}:${line}`, results)),
+          JSON.stringify(
+            formatResults(`Chunks related to ${filePath}:${line}`, results, { repoRoot }),
+          ),
         );
       } catch (err) {
         return toolText(err instanceof Error ? err.message : String(err));

package/src/utils.ts

@@ -1,6 +1,6 @@
-import { resolve } from "node:path";
+import { join, relative, resolve, sep } from "node:path";
 import type { Chunk, ContentType, SearchResult } from "./types.ts";
-import { searchResultToDict } from "./types.ts";
+import { chunkToDict } from "./types.ts";
 
 const GIT_URL_SCHEMES = [
   "https://",
@@ -23,10 +23,38 @@ export function isAllowedRepoSource(repo: string): boolean {
   return repo.startsWith("https://") || repo.startsWith("http://");
 }
 
-export function resolveChunk(chunks: Chunk[], filePath: string, line: number): Chunk | null {
+/** Resolved local repo root for MCP output; null for remote git URLs. */
+export function localRepoRoot(repo: string): string | null {
+  return isGitUrl(repo) ? null : resolve(repo);
+}
+
+/** Map an absolute or repo-relative path to the index-relative form. */
+export function toIndexedFilePath(filePath: string, repoRoot?: string | null): string {
+  if (!repoRoot) {
+    return filePath;
+  }
+  const root = resolve(repoRoot);
+  const candidate = resolve(root, filePath);
+  if (candidate === root) {
+    return "";
+  }
+  const prefix = root.endsWith(sep) ? root : `${root}${sep}`;
+  if (candidate.startsWith(prefix)) {
+    return relative(root, candidate).replace(/\\/g, "/");
+  }
+  return filePath;
+}
+
+export function resolveChunk(
+  chunks: Chunk[],
+  filePath: string,
+  line: number,
+  repoRoot?: string | null,
+): Chunk | null {
+  const indexedPath = toIndexedFilePath(filePath, repoRoot);
   let fallback: Chunk | null = null;
   for (const chunk of chunks) {
-    if (chunk.file_path === filePath && chunk.start_line <= line && line <= chunk.end_line) {
+    if (chunk.file_path === indexedPath && chunk.start_line <= line && line <= chunk.end_line) {
       if (line < chunk.end_line) {
         return chunk;
       }
@@ -38,13 +66,31 @@ export function resolveChunk(chunks: Chunk[], filePath: string, line: number): C
   return fallback;
 }
 
+function chunkToResponseDict(chunk: Chunk, repoRoot?: string | null): Record<string, unknown> {
+  const dict = chunkToDict(chunk);
+  if (!repoRoot) {
+    return dict;
+  }
+  const absolutePath = join(resolve(repoRoot), chunk.file_path);
+  return {
+    ...dict,
+    absolute_path: absolutePath,
+    location: `${absolutePath}:${chunk.start_line}-${chunk.end_line}`,
+  };
+}
+
 export function formatResults(
   query: string,
   results: SearchResult[],
+  options?: { repoRoot?: string | null },
 ): { query: string; results: Record<string, unknown>[] } {
+  const repoRoot = options?.repoRoot ?? null;
   return {
     query,
-    results: results.map(searchResultToDict),
+    results: results.map((result) => ({
+      chunk: chunkToResponseDict(result.chunk, repoRoot),
+      score: result.score,
+    })),
   };
 }