@grec0/memory-bank-mcp 0.0.4 → 0.0.6

package/README.md

@@ -153,18 +153,25 @@ Edita tu archivo de configuración de Claude Desktop:
 
 ## 📚 Herramientas Disponibles
 
+> **⚠️ IMPORTANTE**: Todas las herramientas requieren `projectId` obligatorio. Este ID debe coincidir con el definido en tu archivo `AGENTS.md`.
+
 ### `memorybank_index_code`
 
 Indexa código semánticamente para permitir búsquedas.
 
 **Parámetros:**
+- `projectId` **(REQUERIDO)**: Identificador único del proyecto
 - `path` (opcional): Ruta relativa o absoluta (default: raíz del workspace)
 - `recursive` (opcional): Indexar subdirectorios (default: true)
 - `forceReindex` (opcional): Forzar reindexación completa (default: false)
 
 **Ejemplo:**
-```
-memorybank_index_code({ path: "src/auth", recursive: true })
+```json
+{
+  "projectId": "my-project",
+  "path": "src/auth",
+  "recursive": true
+}
 ```
 
 ### `memorybank_search`
@@ -172,6 +179,7 @@ memorybank_index_code({ path: "src/auth", recursive: true })
 Busca código por similitud semántica.
 
 **Parámetros:**
+- `projectId` **(REQUERIDO)**: Identificador del proyecto donde buscar
 - `query` (requerido): Consulta en lenguaje natural
 - `topK` (opcional): Número de resultados (default: 10)
 - `minScore` (opcional): Score mínimo 0-1 (default: 0.4)
@@ -179,12 +187,13 @@ Busca código por similitud semántica.
 - `filterByLanguage` (opcional): Filtrar por lenguaje
 
 **Ejemplo:**
-```
-memorybank_search({ 
-  query: "función que autentica usuarios con JWT",
-  topK: 5,
-  minScore: 0.8
-})
+```json
+{
+  "projectId": "my-project",
+  "query": "función que autentica usuarios con JWT",
+  "topK": 5,
+  "minScore": 0.8
+}
 ```
 
 ### `memorybank_read_file`
@@ -206,16 +215,18 @@ memorybank_read_file({ path: "src/auth/service.ts", startLine: 50, endLine: 100
 Escribe un archivo y lo reindexa automáticamente.
 
 **Parámetros:**
+- `projectId` **(REQUERIDO)**: Identificador del proyecto para reindexación
 - `path` (requerido): Ruta del archivo
 - `content` (requerido): Contenido del archivo
 - `autoReindex` (opcional): Auto-reindexar (default: true)
 
 **Ejemplo:**
-```
-memorybank_write_file({
-  path: "src/utils/validator.ts",
-  content: "export function validateEmail(email: string) { ... }"
-})
+```json
+{
+  "projectId": "my-project",
+  "path": "src/utils/validator.ts",
+  "content": "export function validateEmail(email: string) { ... }"
+}
 ```
 
 ### `memorybank_get_stats`
@@ -231,9 +242,15 @@ memorybank_get_stats({})
 
 Analiza la cobertura de indexación del proyecto.
 
+**Parámetros:**
+- `projectId` **(REQUERIDO)**: Identificador del proyecto a analizar
+- `path` (opcional): Ruta específica a analizar
+
 **Ejemplo:**
-```
-memorybank_analyze_coverage({})
+```json
+{
+  "projectId": "my-project"
+}
 ```
 
 ### `memorybank_generate_project_docs` 🆕
@@ -241,12 +258,15 @@ memorybank_analyze_coverage({})
 Genera documentación estructurada del proyecto usando IA con razonamiento (gpt-5-mini).
 
 **Parámetros:**
-- `projectId` (opcional): ID del proyecto
+- `projectId` **(REQUERIDO)**: Identificador del proyecto
 - `force` (opcional): Forzar regeneración (default: false)
 
 **Ejemplo:**
-```
-memorybank_generate_project_docs({ force: true })
+```json
+{
+  "projectId": "my-project",
+  "force": true
+}
 ```
 
 Genera 6 documentos markdown:
@@ -262,16 +282,119 @@ Genera 6 documentos markdown:
 Lee la documentación del proyecto generada por IA.
 
 **Parámetros:**
+- `projectId` **(REQUERIDO)**: Identificador del proyecto
 - `document` (opcional): Documento específico o "all"/"summary" (default: "summary")
 - `format` (opcional): "full" o "summary" (default: "full")
 
 **Ejemplo:**
-```
+```json
 // Obtener resumen de todos los docs
-memorybank_get_project_docs({ document: "summary" })
+{
+  "projectId": "my-project",
+  "document": "summary"
+}
 
 // Obtener documento específico
-memorybank_get_project_docs({ document: "systemPatterns" })
+{
+  "projectId": "my-project",
+  "document": "systemPatterns"
+}
+```
+
+## 📋 Plantillas de Instrucciones para Agentes
+
+Memory Bank incluye plantillas de instrucciones en dos formatos:
+- **AGENTS.md** - Estándar [agents.md](https://agents.md/) (compatible con múltiples agentes)
+- **VSCode/Copilot** - Formato `.github/copilot-instructions.md` para VS Code
+
+### Instalación - Formato AGENTS.md
+
+Copia la plantilla que prefieras a la raíz de tu proyecto:
+
+```bash
+# Elegir una plantilla
+cp node_modules/@grec0/memory-bank-mcp/templates/AGENTS.basic.md ./AGENTS.md
+
+# Editar los placeholders
+# Reemplaza {{PROJECT_ID}} con tu ID de proyecto
+# Reemplaza {{WORKSPACE_PATH}} con la ruta del workspace
+```
+
+### Instalación - Formato VS Code
+
+Para VS Code con GitHub Copilot, usa el formato `copilot-instructions.md`:
+
+```bash
+# Crear carpeta .github si no existe
+mkdir -p .github
+
+# Elegir una plantilla
+cp node_modules/@grec0/memory-bank-mcp/templates/vscode/copilot-instructions.basic.md ./.github/copilot-instructions.md
+
+# Habilitar en VS Code settings.json:
+# "github.copilot.chat.codeGeneration.useInstructionFiles": true
+```
+
+También puedes usar el archivo `.instructions.md` con aplicación condicional:
+
+```bash
+# Crear carpeta de instrucciones
+mkdir -p .github/instructions
+
+# Copiar instrucciones base
+cp node_modules/@grec0/memory-bank-mcp/templates/vscode/memory-bank.instructions.md ./.github/instructions/
+```
+
+### 1. Basic Mode (`AGENTS.basic.md`)
+
+**Para proyectos donde quieres control total.**
+
+- ✅ El agente SIEMPRE consulta el Memory Bank antes de actuar
+- ✅ Solo indexa cuando el usuario lo solicita explícitamente
+- ✅ Pide permiso antes de modificar código
+- ✅ Sugiere reindexar después de cambios
+
+**Ideal para**: Proyectos críticos, revisión de código, onboarding.
+
+### 2. Auto-Index Mode (`AGENTS.auto-index.md`)
+
+**Para desarrollo activo con sincronización automática.**
+
+- ✅ El agente consulta el Memory Bank automáticamente
+- ✅ Reindexa CADA archivo después de modificarlo
+- ✅ Mantiene el Memory Bank siempre actualizado
+- ✅ Puede leer/escribir archivos directamente
+
+**Ideal para**: Desarrollo activo, iteración rápida, equipos.
+
+### 3. Sandboxed Mode (`AGENTS.sandboxed.md`)
+
+**Para entornos sin acceso directo al sistema de archivos.**
+
+- ✅ NO tiene acceso directo a archivos
+- ✅ DEBE usar `memorybank_read_file` para leer
+- ✅ DEBE usar `memorybank_write_file` para escribir
+- ✅ Auto-reindexa automáticamente en cada escritura
+
+**Ideal para**: Entornos restringidos, desarrollo remoto, seguridad.
+
+### Ejemplo de `AGENTS.md` Configurado
+
+```markdown
+# AGENTS.md
+
+## Project Configuration
+- **Project ID**: `my-awesome-app`
+- **Workspace**: `/home/user/projects/my-awesome-app`
+
+## Memory Bank Instructions
+
+### CRITICAL: Always Consult Before Acting
+Before any action, call `memorybank_search` with projectId="my-awesome-app"
+
+### Auto-Indexing Policy
+AFTER every file modification:
+memorybank_index_code({ projectId: "my-awesome-app", path: "<modified_file>" })
 ```
 
 ## 🎯 Casos de Uso
@@ -279,13 +402,13 @@ memorybank_get_project_docs({ document: "systemPatterns" })
 ### 1. Primera Indexación
 
 ```
-Usuario: Hola, quiero que me ayudes con mi proyecto
+Usuario: Hola, quiero que me ayudes con mi proyecto. El projectId es "my-app"
 Claude: [ejecuta memorybank_get_stats]
         Veo que no hay código indexado aún. 
         ¿Deseas que indexe el proyecto para poder ayudarte mejor?
 
 Usuario: Sí
-Claude: [ejecuta memorybank_index_code({})]
+Claude: [ejecuta memorybank_index_code({ projectId: "my-app" })]
         He indexado 145 archivos (1,234 chunks) en 45 segundos.
         ¿En qué puedo ayudarte?
 ```
@@ -294,7 +417,7 @@ Claude: [ejecuta memorybank_index_code({})]
 
 ```
 Usuario: ¿Cómo funciona la autenticación en este proyecto?
-Claude: [ejecuta memorybank_search({ query: "autenticación login usuarios" })]
+Claude: [ejecuta memorybank_search({ projectId: "my-app", query: "autenticación login usuarios" })]
         
         La autenticación se implementa en src/auth/authService.ts (líneas 23-87):
         
@@ -308,11 +431,11 @@ Claude: [ejecuta memorybank_search({ query: "autenticación login usuarios" })]
 
 ```
 Usuario: Añade validación de email al formulario de registro
-Claude: [busca formulario de registro]
-        [busca validadores existentes]
+Claude: [busca formulario de registro con projectId]
+        [busca validadores existentes con projectId]
         [lee archivo actual]
         [genera código respetando estilo del proyecto]
-        [escribe archivo con memorybank_write_file]
+        [escribe archivo con memorybank_write_file({ projectId: "my-app", ... })]
         
         He añadido la validación de email en src/forms/RegisterForm.tsx línea 45.
         Usa el validador existente de emailValidator.ts para mantener consistencia.
@@ -440,16 +563,32 @@ El sistema maneja automáticamente rate limits con exponential backoff, pero si
 
 ### Índice desactualizado
 
-```
+```json
 memorybank_get_stats({})
 ```
 
 Si `pendingFiles` muestra archivos pendientes:
 
+```json
+{
+  "projectId": "my-project",
+  "forceReindex": true
+}
 ```
-memorybank_index_code({ forceReindex: true })
+
+### Error: "projectId is required"
+
+**Solución**: Todas las herramientas requieren `projectId`. Asegúrate de incluirlo en cada llamada:
+
+```json
+{
+  "projectId": "my-project",
+  "query": "..."
+}
 ```
 
+Tip: Define el `projectId` en tu archivo `AGENTS.md` para que el agente lo use consistentemente.
+
 ## 🤝 Contribución
 
 ¡Contribuciones son bienvenidas!
@@ -462,7 +601,16 @@ memorybank_index_code({ forceReindex: true })
 
 ## 📖 Documentación Adicional
 
-- [AGENT_INSTRUCTIONS.md](AGENT_INSTRUCTIONS.md): Guía completa para agentes de IA
+- [templates/](templates/): Plantillas de instrucciones para agentes
+  - **Formato AGENTS.md** (estándar multi-agente):
+    - `AGENTS.basic.md`: Modo básico (indexación manual)
+    - `AGENTS.auto-index.md`: Modo auto-indexación
+    - `AGENTS.sandboxed.md`: Modo sin acceso directo a archivos
+  - **Formato VS Code** (`templates/vscode/`):
+    - `copilot-instructions.basic.md`: Modo básico para Copilot
+    - `copilot-instructions.auto-index.md`: Modo auto-indexación para Copilot
+    - `copilot-instructions.sandboxed.md`: Modo sandboxed para Copilot
+    - `memory-bank.instructions.md`: Instrucciones con aplicación condicional
 - [wiki/Developer-Guide.md](wiki/Developer-Guide.md): Guía para desarrolladores
 - [wiki/API-Reference.md](wiki/API-Reference.md): Referencia completa de API
 

package/dist/common/indexManager.js

@@ -6,6 +6,12 @@ import * as fs from "fs";
 import * as path from "path";
 import { scanFiles, scanSingleFile } from "./fileScanner.js";
 import { chunkCode } from "./chunker.js";
+/**
+ * Normalizes a path to use forward slashes for consistent cross-platform behavior
+ */
+function normalizePath(filePath) {
+    return filePath.split(path.sep).join('/');
+}
 /**
  * Index manager coordinating the entire indexing pipeline
  */
@@ -43,9 +49,16 @@ export class IndexManager {
      */
     loadMetadata() {
         try {
+            console.error(`Loading metadata from: ${this.metadataPath}`);
             if (fs.existsSync(this.metadataPath)) {
                 const data = fs.readFileSync(this.metadataPath, "utf-8");
-                return JSON.parse(data);
+                const metadata = JSON.parse(data);
+                const fileCount = Object.keys(metadata.files || {}).length;
+                console.error(`Loaded metadata: ${fileCount} files tracked`);
+                return metadata;
+            }
+            else {
+                console.error(`Metadata file not found: ${this.metadataPath}`);
             }
         }
         catch (error) {
@@ -66,7 +79,9 @@ export class IndexManager {
             if (!fs.existsSync(dir)) {
                 fs.mkdirSync(dir, { recursive: true });
             }
+            const fileCount = Object.keys(this.metadata.files).length;
             fs.writeFileSync(this.metadataPath, JSON.stringify(this.metadata, null, 2));
+            console.error(`  Saved metadata: ${fileCount} files tracked → ${this.metadataPath}`);
         }
         catch (error) {
             console.error(`Warning: Could not save index metadata: ${error}`);
@@ -79,11 +94,21 @@ export class IndexManager {
         if (forceReindex) {
             return true;
         }
-        const fileInfo = this.metadata.files[file.path];
+        // Use normalized path for consistent lookup
+        const normalizedPath = normalizePath(file.path);
+        const fileInfo = this.metadata.files[normalizedPath];
         if (!fileInfo) {
+            // Debug: show first few new files
+            const trackedCount = Object.keys(this.metadata.files).length;
+            if (trackedCount === 0) {
+                console.error(`  New file (no metadata): ${normalizedPath}`);
+            }
             return true; // New file
         }
         if (fileInfo.hash !== file.hash) {
+            console.error(`  Changed file: ${normalizedPath}`);
+            console.error(`    Stored hash: ${fileInfo.hash.substring(0, 16)}...`);
+            console.error(`    Current hash: ${file.hash.substring(0, 16)}...`);
             return true; // File changed
         }
         return false;
@@ -128,11 +153,12 @@ export class IndexManager {
             // Prepare chunk records for storage (using snake_case for LanceDB)
             // Note: All fields must have non-undefined values for LanceDB Arrow conversion
             const timestamp = Date.now();
-            console.error(`  Storing chunks with project_id: '${projectId}'`);
+            const normalizedFilePath = normalizePath(file.path);
+            console.error(`  Storing chunks with project_id: '${projectId}', file: '${normalizedFilePath}'`);
             const chunkRecords = chunks.map((chunk, i) => ({
                 id: chunk.id,
                 vector: embeddings[i].vector,
-                file_path: chunk.filePath,
+                file_path: normalizedFilePath, // Use normalized path for consistency
                 content: chunk.content,
                 start_line: chunk.startLine,
                 end_line: chunk.endLine,
@@ -144,13 +170,13 @@ export class IndexManager {
                 context: chunk.context || "", // Ensure non-undefined for LanceDB
                 project_id: projectId,
             }));
-            // Delete old chunks for this file
-            await this.vectorStore.deleteChunksByFile(file.path);
+            // Delete old chunks for this file using normalized path
+            await this.vectorStore.deleteChunksByFile(normalizedFilePath);
             // Insert new chunks
             await this.vectorStore.insertChunks(chunkRecords);
             console.error(`  Stored ${chunkRecords.length} chunks in vector store`);
-            // Update metadata
-            this.metadata.files[file.path] = {
+            // Update metadata with normalized path for consistent lookups
+            this.metadata.files[normalizedFilePath] = {
                 hash: file.hash,
                 lastIndexed: timestamp,
                 chunkCount: chunks.length,
@@ -191,19 +217,36 @@ export class IndexManager {
         const shouldAutoUpdateDocs = options.autoUpdateDocs !== undefined
             ? options.autoUpdateDocs
             : this.autoUpdateDocs;
+        // Use workspaceRoot for consistent path normalization, fallback to rootPath
+        const workspaceRoot = options.workspaceRoot || options.rootPath;
         console.error(`\n=== Starting indexing process ===`);
         console.error(`Root path: ${options.rootPath}`);
+        console.error(`Workspace root: ${workspaceRoot}`);
         console.error(`Project ID: ${projectId}`);
         console.error(`Force reindex: ${options.forceReindex || false}`);
         console.error(`Auto-update docs: ${shouldAutoUpdateDocs}`);
         // Initialize vector store
         await this.vectorStore.initialize();
-        // Scan files
+        // Scan files - always use workspaceRoot for consistent relative paths
         console.error(`\nScanning files...`);
         const files = scanFiles({
             rootPath: options.rootPath,
             recursive: options.recursive !== undefined ? options.recursive : true,
         });
+        // Normalize paths to be relative to workspaceRoot, not rootPath
+        // This ensures consistent paths in metadata regardless of which subfolder was indexed
+        if (workspaceRoot !== options.rootPath) {
+            const rootPathResolved = path.resolve(options.rootPath);
+            const workspaceRootResolved = path.resolve(workspaceRoot);
+            for (const file of files) {
+                // Convert path from relative-to-rootPath to relative-to-workspaceRoot
+                const absolutePath = path.join(rootPathResolved, file.path);
+                file.path = path.relative(workspaceRootResolved, absolutePath);
+                // Use forward slashes for consistency
+                file.path = file.path.split(path.sep).join('/');
+            }
+            console.error(`  Normalized ${files.length} file paths to workspace root`);
+        }
         if (files.length === 0) {
             console.error("No files found to index");
             return {
@@ -351,6 +394,7 @@ export class IndexManager {
         const queryVector = await this.embeddingService.generateQueryEmbedding(query);
         // Search vector store
         const results = await this.vectorStore.search(queryVector, {
+            filterByProject: options.projectId,
             topK: options.topK || 10,
             minScore: options.minScore || 0.0,
             filterByFile: options.filterByFile,

package/dist/index.js

@@ -33,7 +33,10 @@ const server = new McpServer({
     version: VERSION,
 });
 // Tool: Index Code
-server.tool("memorybank_index_code", "Indexa semánticamente código de un directorio o archivo específico para permitir búsquedas semánticas", {
+server.tool("memorybank_index_code", "Indexa semánticamente código de un directorio o archivo específico para permitir búsquedas semánticas. El projectId es OBLIGATORIO y debe coincidir con el definido en AGENTS.md", {
+    projectId: z
+        .string()
+        .describe("Identificador único del proyecto (OBLIGATORIO). Debe coincidir con el definido en AGENTS.md del proyecto"),
     path: z
         .string()
         .optional()
@@ -50,6 +53,7 @@ server.tool("memorybank_index_code", "Indexa semánticamente código de un direc
         .describe("Forzar reindexación completa aunque no haya cambios"),
 }, async (args) => {
     const result = await indexCode({
+        projectId: args.projectId,
         path: args.path,
         recursive: args.recursive,
         forceReindex: args.forceReindex,
@@ -59,7 +63,10 @@ server.tool("memorybank_index_code", "Indexa semánticamente código de un direc
     };
 });
 // Tool: Search Memory Bank
-server.tool("memorybank_search", "Busca código relevante mediante búsqueda semántica vectorial. Usa esta herramienta SIEMPRE que necesites información sobre el código", {
+server.tool("memorybank_search", "Busca código relevante mediante búsqueda semántica vectorial. Usa esta herramienta SIEMPRE que necesites información sobre el código. El projectId es OBLIGATORIO", {
+    projectId: z
+        .string()
+        .describe("Identificador del proyecto donde buscar (OBLIGATORIO). Debe coincidir con el usado al indexar"),
     query: z
         .string()
         .describe("Consulta semántica: describe qué estás buscando en lenguaje natural (ej: 'función de autenticación', '¿cómo se validan los emails?')"),
@@ -83,6 +90,7 @@ server.tool("memorybank_search", "Busca código relevante mediante búsqueda sem
         .describe("Filtrar resultados por lenguaje de programación (ej: 'typescript', 'python')"),
 }, async (args) => {
     const result = await searchMemory({
+        projectId: args.projectId,
         query: args.query,
         topK: args.topK,
         minScore: args.minScore,
@@ -117,7 +125,10 @@ server.tool("memorybank_read_file", "Lee el contenido de un archivo específico
     };
 });
 // Tool: Write File
-server.tool("memorybank_write_file", "Escribe o modifica un archivo y automáticamente lo reindexa en el Memory Bank para mantener la consistencia", {
+server.tool("memorybank_write_file", "Escribe o modifica un archivo y automáticamente lo reindexa en el Memory Bank para mantener la consistencia. El projectId es OBLIGATORIO para la reindexación correcta", {
+    projectId: z
+        .string()
+        .describe("Identificador del proyecto (OBLIGATORIO). Necesario para la auto-reindexación correcta"),
     path: z
         .string()
         .describe("Ruta relativa o absoluta del archivo a escribir"),
@@ -131,6 +142,7 @@ server.tool("memorybank_write_file", "Escribe o modifica un archivo y automátic
         .describe("Reindexar automáticamente el archivo después de escribirlo"),
 }, async (args) => {
     const result = await writeFile({
+        projectId: args.projectId,
         path: args.path,
         content: args.content,
         autoReindex: args.autoReindex,
@@ -147,9 +159,17 @@ server.tool("memorybank_get_stats", "Obtiene estadísticas del Memory Bank: arch
     };
 });
 // Tool: Analyze Coverage
-server.tool("memorybank_analyze_coverage", "Analiza la cobertura de indexación del proyecto. Muestra qué carpetas/archivos están indexados, cuáles no, y cuáles tienen cambios pendientes. Perfecto para visualizar el estado del conocimiento del agente sobre el proyecto. NOTA: Puede tardar en workspaces grandes", {}, async () => {
+server.tool("memorybank_analyze_coverage", "Analiza la cobertura de indexación del proyecto. Muestra qué carpetas/archivos están indexados, cuáles no, y cuáles tienen cambios pendientes. OBLIGATORIO: projectId y path (ruta absoluta del workspace). NOTA: Puede tardar en workspaces grandes", {
+    projectId: z
+        .string()
+        .describe("Identificador del proyecto a analizar (OBLIGATORIO)"),
+    path: z
+        .string()
+        .describe("Ruta absoluta del workspace a analizar (OBLIGATORIO). Ejemplo: 'C:/workspaces/mi-proyecto'"),
+}, async (args) => {
     try {
-        const result = await analyzeCoverage(indexManager, vectorStore, workspaceRoot);
+        const targetPath = args.path;
+        const result = await analyzeCoverage(indexManager, vectorStore, targetPath, args.projectId);
         return {
             content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
         };
@@ -189,11 +209,10 @@ server.tool("memorybank_analyze_coverage", "Analiza la cobertura de indexación
     }
 });
 // Tool: Generate Project Docs
-server.tool(generateProjectDocsToolDefinition.name, generateProjectDocsToolDefinition.description, {
+server.tool(generateProjectDocsToolDefinition.name, generateProjectDocsToolDefinition.description + ". El projectId es OBLIGATORIO", {
     projectId: z
         .string()
-        .optional()
-        .describe("ID del proyecto (opcional, usa 'default' si no se especifica)"),
+        .describe("Identificador del proyecto (OBLIGATORIO). Debe coincidir con el usado al indexar"),
     force: z
         .boolean()
         .optional()
@@ -209,7 +228,10 @@ server.tool(generateProjectDocsToolDefinition.name, generateProjectDocsToolDefin
     };
 });
 // Tool: Get Project Docs
-server.tool(getProjectDocsToolDefinition.name, getProjectDocsToolDefinition.description, {
+server.tool(getProjectDocsToolDefinition.name, getProjectDocsToolDefinition.description + ". El projectId es OBLIGATORIO", {
+    projectId: z
+        .string()
+        .describe("Identificador del proyecto (OBLIGATORIO). Debe coincidir con el usado al generar los docs"),
     document: z
         .string()
         .optional()
@@ -222,6 +244,7 @@ server.tool(getProjectDocsToolDefinition.name, getProjectDocsToolDefinition.desc
         .describe("Formato de salida: 'full' devuelve contenido completo, 'summary' devuelve resumen de todos los docs"),
 }, async (args) => {
     const result = await getProjectDocs({
+        projectId: args.projectId,
         document: args.document,
         format: args.format,
     }, projectKnowledgeService);

package/dist/tools/analyzeCoverage.js

@@ -203,10 +203,13 @@ function generateRecommendations(stats, tree) {
 /**
  * Analyzes indexation coverage of the project
  */
-export async function analyzeCoverage(indexManager, vectorStore, workspaceRoot) {
+export async function analyzeCoverage(indexManager, vectorStore, workspaceRoot, projectId) {
     try {
         console.error("\n=== Analizando cobertura de indexación ===");
         console.error(`Workspace root: ${workspaceRoot}`);
+        if (projectId) {
+            console.error(`Project ID: ${projectId}`);
+        }
         // 1. Scan all code files in workspace with timeout protection
         console.error("Escaneando archivos del workspace...");
         // Add timeout and file limit protection

package/dist/tools/indexCode.js

@@ -15,12 +15,15 @@ export async function indexCode(params, indexManager, workspaceRoot) {
                 : path.join(workspaceRoot, params.path)
             : workspaceRoot;
         console.error(`\nIndexing code at: ${targetPath}`);
+        console.error(`Project ID: ${params.projectId}`);
         console.error(`Workspace root: ${workspaceRoot}`);
         console.error(`Recursive: ${params.recursive !== false}`);
         console.error(`Force reindex: ${params.forceReindex || false}`);
-        // Run indexing
+        // Run indexing - pass workspaceRoot for consistent path normalization
         const result = await indexManager.indexFiles({
+            projectId: params.projectId,
             rootPath: targetPath,
+            workspaceRoot: workspaceRoot, // Always normalize paths relative to workspace
             recursive: params.recursive !== false,
             forceReindex: params.forceReindex || false,
         });

package/dist/tools/searchMemory.js

@@ -17,6 +17,7 @@ export async function searchMemory(params, indexManager) {
             };
         }
         console.error(`\nSearching Memory Bank for: "${params.query}"`);
+        console.error(`Project ID: ${params.projectId}`);
         console.error(`Top K: ${params.topK || 10}`);
         console.error(`Min score: ${params.minScore || 0.4}`);
         if (params.filterByFile) {
@@ -27,6 +28,7 @@ export async function searchMemory(params, indexManager) {
         }
         // Search
         const results = await indexManager.search(params.query, {
+            projectId: params.projectId,
             topK: params.topK || 10,
             minScore: params.minScore !== undefined ? params.minScore : 0.4,
             filterByFile: params.filterByFile,

package/dist/tools/writeFile.js

@@ -28,8 +28,8 @@ export async function writeFile(params, indexManager, workspaceRoot) {
         let chunksCreated = 0;
         if (autoReindex) {
             try {
-                console.error(`Auto-reindexing ${params.path}...`);
-                const reindexResult = await indexManager.reindexFile(filePath, workspaceRoot);
+                console.error(`Auto-reindexing ${params.path} for project ${params.projectId}...`);
+                const reindexResult = await indexManager.reindexFile(filePath, workspaceRoot, params.projectId);
                 if (reindexResult.success) {
                     reindexed = true;
                     chunksCreated = reindexResult.chunksCreated;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grec0/memory-bank-mcp",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "MCP server for semantic code indexing with Memory Bank - AI-powered codebase understanding",
   "license": "MIT",
   "author": "@grec0",