@pcircle/memesh 4.0.2 → 4.1.0

package/README.es.md

@@ -1,10 +1,13 @@
+<!-- translated from README.md @ ab9d25f8d9cb7c78c4cc271717709e2efb4bac76 -->
+<!-- DO NOT edit this file by hand. The maintainer regenerates it from README.md via a private toolkit script (see internal docs). Manual edits will be overwritten on next sync. -->
+
 🌐 [English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Tiếng Việt](README.vi.md) | [Español](README.es.md) | [ภาษาไทย](README.th.md)
 
 <p align="center">
   <h1 align="center">MeMesh LLM Memory</h1>
   <p align="center">
-    <strong>La capa de memoria de IA universal más ligera.</strong><br />
-    Un solo archivo SQLite. Cualquier LLM. Cero nube.
+    <strong>Memoria local para Claude Code y agentes de codificación MCP.</strong><br />
+    Un archivo SQLite. Sin Docker. Sin infraestructura en la nube.
   </p>
   <p align="center">
     <a href="https://www.npmjs.com/package/@pcircle/memesh"><img src="https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=3b82f6&label=npm" alt="npm" /></a>
@@ -18,13 +21,15 @@
 
 ## El Problema
 
-Tu IA olvida todo entre sesiones. Cada decisión, cada corrección de bug, cada lección aprendida — desaparecen. Vuelves a explicar el mismo contexto una y otra vez, Claude redescubre los mismos patrones, y el conocimiento de IA de tu equipo se resetea a cero cada vez.
+Tu agente de codificación olvida lo que sucedió en sesiones anteriores. Cada decisión arquitectónica, corrección de bugs, prueba fallida y lección aprendida con esfuerzo debe explicarse de nuevo. Claude Code comienza desde cero, redescubre restricciones antiguas y gasta contexto en cosas que ya debería saber.
+
+**MeMesh proporciona a los agentes de codificación memoria local persistente, buscable y en evolución.**
 
-**MeMesh da a cada IA una memoria persistente, con búsqueda inteligente y en constante evolución.**
+Este paquete es la capa de memoria local de la familia de productos MeMesh. Es intencionalmente simple y de código abierto: instálalo con npm, mantén tu memoria en `~/.memesh/knowledge-graph.db` y conéctalo a Claude Code o cualquier cliente compatible con MCP. Los productos de workspace alojado y sistemas operativos empresariales deben mantenerse separados del README y roadmap de este paquete.
 
 ---
 
-## Empieza en 60 Segundos
+## Primeros Pasos en 60 Segundos
 
 ### Paso 1: Instala
 
@@ -32,33 +37,39 @@ Tu IA olvida todo entre sesiones. Cada decisión, cada corrección de bug, cada
 npm install -g @pcircle/memesh
 ```
 
-### Paso 2: Tu IA recuerda
+### Paso 2: Guarda una decisión
 
 ```bash
 memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
 ```
 
-### Paso 3: Tu IA recupera
+### Paso 3: Recupérala después
 
 ```bash
 memesh recall "login security"
-# → Encuentra "OAuth 2.0 with PKCE" aunque busques con otras palabras
+# → Encuentra "OAuth 2.0 with PKCE" aunque buscaste palabras diferentes
 ```
 
-**Eso es todo.** MeMesh ya está recordando y recuperando entre sesiones.
+**Eso es todo.** MeMesh ahora está recordando y recuperando a través de sesiones.
 
-Abre el panel para explorar tu memoria:
+Si quieres verificar la instalación y la conexión local de extremo a extremo:
+
+```bash
+memesh doctor
+```
+
+Abre el dashboard para explorar tu memoria:
 
 ```bash
 memesh
 ```
 
 <p align="center">
-  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — encuentra cualquier recuerdo al instante" width="100%" />
+  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — encuentra cualquier memoria al instante" width="100%" />
 </p>
 
 <p align="center">
-  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — comprende el conocimiento de tu IA" width="100%" />
+  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — puntuación de salud, línea de tiempo, patrones, cobertura del conocimiento" width="100%" />
 </p>
 
 <p align="center">
@@ -67,18 +78,18 @@ memesh
 
 ---
 
-## ¿Para Quién Es?
+## ¿Para Quién Es Esto?
 
 | Si eres... | MeMesh te ayuda a... |
-|---------------|---------------------|
-| **Desarrollador usando Claude Code** | Recordar decisiones, patrones y lecciones entre sesiones automáticamente |
-| **Equipo construyendo con LLMs** | Compartir conocimiento del equipo mediante exportación/importación, manteniendo el contexto de IA de todos alineado |
-| **Desarrollador de agentes de IA** | Dar a tus agentes memoria persistente mediante MCP, HTTP API o Python SDK |
-| **Usuario avanzado con múltiples herramientas de IA** | Una capa de memoria que funciona con Claude, GPT, LLaMA, Ollama o cualquier cliente MCP |
+|---|---|
+| **Un desarrollador usando Claude Code** | Recuperar automáticamente decisiones del proyecto, lecciones específicas de archivos y fracasos anteriores mientras trabajas |
+| **Un usuario avanzado de agentes de codificación** | Compartir una capa de memoria local entre herramientas compatibles con MCP |
+| **Un equipo experimentando con flujos de trabajo de IA para codificación** | Exportar/importar conocimiento del proyecto sin introducir infraestructura alojada |
+| **Un desarrollador de agentes** | Añadir memoria local mediante MCP, HTTP, CLI o el SDK de Python |
 
 ---
 
-## Funciona con Todo
+## Diseñado para Agentes de Codificación en Primer Lugar
 
 <table>
 <tr>
@@ -88,18 +99,18 @@ memesh
 ```bash
 memesh-mcp
 ```
-Protocolo MCP (configurado automáticamente)
+Herramientas MCP + hooks de Claude Code
 
 </td>
 <td width="33%" align="center">
 
-**Python / LangChain**
-```python
-from memesh import MeMesh
-m = MeMesh()
-m.recall("auth")
+**Cualquier Cliente HTTP**
+```bash
+curl localhost:3737/v1/recall \
+  -H "Content-Type: application/json" \
+  -d '{"query":"auth"}'
 ```
-`pip install memesh`
+`memesh serve` (REST API)
 
 </td>
 <td width="33%" align="center">
@@ -109,7 +120,7 @@ m.recall("auth")
 memesh export-schema \
   --format openai
 ```
-Pega las herramientas en cualquier llamada a la API
+Pega las herramientas en cualquier llamada API
 
 </td>
 </tr>
@@ -117,103 +128,120 @@ Pega las herramientas en cualquier llamada a la API
 
 ---
 
-## ¿Por Qué No Mem0 / Zep?
+## ¿Por Qué No OpenMemory, Cursor Memories, Mem0 o Zep?
 
-| | **MeMesh** | Mem0 | Zep |
-|---|---|---|---|
-| **Tiempo de instalación** | 5 segundos | 30–60 minutos | 30+ minutos |
-| **Configuración** | `npm i -g` — listo | Neo4j + VectorDB + claves API | Neo4j + config |
-| **Almacenamiento** | Archivo SQLite único | Neo4j + Qdrant | Neo4j |
-| **Funciona sin conexión** | Sí, siempre | No | No |
-| **Panel** | Integrado (7 pestañas + analytics) | Ninguno | Ninguno |
-| **Dependencias** | 6 | 20+ | 10+ |
-| **Precio** | Gratis para siempre | Plan gratuito / De pago | Plan gratuito / De pago |
+| | **MeMesh** | OpenMemory | Cursor Memories | Mem0 | Zep / Graphiti |
+|---|---|---|---|---|---|
+| **Mejor caso de uso** | Memoria local para agentes de codificación | Memoria local/entre clientes MCP | Memoria de proyecto nativa de Cursor | Memoria de aplicación/agente gestionada | Grafos de conocimiento temporal |
+| **Forma de instalación** | `npm install -g @pcircle/memesh` | Flujo de aplicación/servidor local | Integrada en Cursor | API en la nube / SDK / MCP | Configuración de servicio/framework |
+| **Almacenamiento** | Un archivo SQLite local | Stack de memoria local | Reglas/memories gestionados por Cursor | Stack alojado o auto-alojado | Base de datos de grafos |
+| **Nube requerida** | No | No en modo local | Depende de la cuenta/configuración de Cursor | Sí para la plataforma | Generalmente sí/auto-alojado |
+| **Hooks de Claude Code** | Primera clase | Herramientas MCP | No | Herramientas MCP | No específico de Claude Code |
+| **Dashboard** | Integrado | Integrado | Configuración de Cursor | Dashboard de plataforma | Herramientas de plataforma/grafo |
+| **Tradeoff** | Cuña local simple, no a escala empresarial | Huella de aplicación local más amplia | Bloqueado a Cursor | Plataforma gestionada fuerte, menos local-first | Modelo de grafo fuerte, configuración más pesada |
 
-**MeMesh sacrifica:** funcionalidades enterprise multi-inquilino a cambio de **instalación instantánea, cero infraestructura y 100 % de privacidad**.
+**MeMesh intercambia infraestructura gestionada a escala empresarial por configuración local instantánea, almacenamiento inspectable y hooks de flujo de trabajo de agentes de codificación.**
 
 ---
 
-## Qué Ocurre Automáticamente
+## Qué Sucede Automáticamente en Claude Code
 
-No necesitas recordar todo manualmente. MeMesh tiene **4 hooks** que capturan conocimiento sin que hagas nada:
+No necesitas recordar todo manualmente. MeMesh tiene **6 hooks** que capturan e inyectan conocimiento mientras trabajas:
 
 | Cuándo | Qué hace MeMesh |
-|------|------------------|
-| **Al inicio de cada sesión** | Carga tus recuerdos más relevantes + advertencias proactivas de lecciones pasadas |
-| **Tras cada `git commit`** | Registra lo que cambiaste, con estadísticas del diff |
+|---|---|
+| **Al inicio de cada sesión** | Carga tus memorias más relevantes + advertencias proactivas de lecciones pasadas + banner de orquestación agentica |
+| **Antes de editar archivos** | Recupera memorias vinculadas al archivo o proyecto antes de que Claude escriba código |
+| **Antes de comandos bash** | Nudge a Claude para que envíe comandos de alta verificabilidad (test, build, lint, migrate, deploy, benchmark) como agentes de fondo |
+| **Después de cada `git commit`** | Registra qué cambiaste, con estadísticas de diff |
 | **Cuando Claude se detiene** | Captura archivos editados, errores corregidos y genera automáticamente lecciones estructuradas a partir de fallos |
-| **Antes de la compactación de contexto** | Guarda el conocimiento antes de que se pierda por los límites del contexto |
+| **Antes de compresión de contexto** | Guarda conocimiento antes de que se pierda en límites de contexto |
 
-> **Desactívalo cuando quieras:** `export MEMESH_AUTO_CAPTURE=false`
+> **Desactiva en cualquier momento:** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
-## Panel de Control
+## Dashboard
 
-7 pestañas, 11 idiomas, cero dependencias externas. Accede en `http://localhost:3737/dashboard` cuando el servidor esté activo.
+7 pestañas, 11 idiomas, cero dependencias externas. Accede en `http://localhost:3737/dashboard` cuando el servidor está en ejecución.
 
 | Pestaña | Qué ves |
-|---------|---------|
+|---|---|
 | **Search** | Búsqueda de texto completo + similitud vectorial en todas las memorias |
-| **Browse** | Lista paginada de todas las entidades con archivado/restauración |
-| **Analytics** | Puntuación de Salud de Memoria (0-100), timeline de 30 días, métricas de valor, cobertura de conocimiento, sugerencias de limpieza, tus patrones de trabajo |
+| **Browse** | Lista paginada de todas las entidades con archivo/restauración |
+| **Analytics** | Puntuación de Salud de Memoria (0-100), línea de tiempo de 30 días, métricas de valor, cobertura de conocimiento, sugerencias de limpieza, tus patrones de trabajo |
 | **Graph** | Grafo de conocimiento interactivo dirigido por fuerzas con filtros de tipo, búsqueda, modo ego, mapa de calor de recencia |
 | **Lessons** | Lecciones estructuradas de fallos pasados (error, causa raíz, corrección, prevención) |
-| **Manage** | Archivar y restaurar entidades |
-| **Settings** | Configuración del proveedor LLM, selector de idioma |
+| **Manage** | Archiva y restaura entidades |
+| **Settings** | Configuración de proveedor LLM, selector de idioma instantáneo |
 
 ---
 
-## Funcionalidades Inteligentes
+## Características Inteligentes
 
-**🧠 Búsqueda Inteligente** — Busca "login security" y encuentra recuerdos sobre "OAuth PKCE". MeMesh expande las consultas con términos relacionados usando el LLM configurado.
+**🧠 Búsqueda Inteligente** — Busca "login security" y encuentra memorias sobre "OAuth PKCE". MeMesh expande consultas con términos relacionados usando tu LLM configurado.
 
-**📊 Clasificación por Puntuación** — Los resultados se ordenan por relevancia (35 %) + última vez que se usó (25 %) + frecuencia (20 %) + confianza (15 %) + si la información sigue siendo actual (5 %).
+**📊 Ranking Puntuado** — Los resultados se clasifican por relevancia (30%) + recencia (25%) + frecuencia (15%) + confianza (15%) + impacto de recuperación (10%) + validez temporal (5%).
 
-**🔄 Evolución del Conocimiento** — Las decisiones cambian. `forget` archiva los recuerdos antiguos (nunca borra). Las relaciones `supersedes` conectan lo viejo con lo nuevo. Tu IA siempre ve la versión más reciente.
+**🔄 Evolución del Conocimiento** — Las decisiones cambian. `forget` archiva memorias antiguas (nunca borra). Las relaciones `supersedes` vinculan antiguas → nuevas. Tu IA siempre ve la versión más reciente.
 
-**⚠️ Detección de Conflictos** — Si tienes dos recuerdos que se contradicen, MeMesh te avisa.
+**⚠️ Detección de Conflictos** — Si tienes dos memorias que se contradicen, MeMesh te advierte.
 
 **📦 Compartir en Equipo** — `memesh export > team-knowledge.json` → comparte con tu equipo → `memesh import team-knowledge.json`
+Los bundles importados permanecen buscables, pero MeMesh no inyecta automáticamente memorias importadas en hooks de Claude hasta que las revises o las guardes localmente de nuevo.
+
+---
+
+## Ejemplos de Uso
+
+> "MeMesh recordó que elegimos PKCE sobre implicit flow hace tres semanas. Cuando le pregunté a Claude sobre auth de nuevo, ya lo sabía — sin necesidad de re-explicar."
+> — **Desarrollador independiente, construyendo un SaaS**
+
+> "Exportamos la memoria de nuestro equipo cada viernes e la importamos el lunes. El Claude de cada uno comienza la semana sabiendo qué aprendió el equipo la semana pasada."
+> — **Startup de 3 personas, base de conocimiento compartida**
+
+> "El dashboard me mostró que 90% de mis memorias eran logs de sesión auto-generados. Empecé a usar `remember` deliberadamente para decisiones arquitectónicas. Cambio de juego."
+> — **Desarrollador que descubrió la pestaña Analytics**
 
 ---
 
-## Activa el Modo Inteligente (Opcional)
+## Desbloquea Modo Inteligente (Opcional)
 
-MeMesh funciona completamente sin conexión por defecto. Añade una clave API de LLM para desbloquear búsquedas más inteligentes:
+MeMesh funciona sin conexión por defecto. Añade una clave API de LLM solo si quieres expansión de consultas, extracción más inteligente y compresión:
 
 ```bash
 memesh config set llm.provider anthropic
 memesh config set llm.api-key sk-ant-...
 ```
 
-O usa la pestaña Configuración del panel (configuración visual):
+O usa la pestaña Configuración del dashboard (configuración visual):
 
 ```bash
-memesh  # abre el panel → pestaña Configuración
+memesh  # abre dashboard → pestaña Settings
 ```
 
 | | Nivel 0 (por defecto) | Nivel 1 (Modo Inteligente) |
 |---|---|---|
-| **Búsqueda** | Coincidencia de palabras clave FTS5 | + Expansión de consulta por LLM (~97 % de recall) |
-| **Captura automática** | Patrones basados en reglas | + LLM extrae decisiones y lecciones |
-| **Compresión** | No disponible | `consolidate` comprime recuerdos extensos |
-| **Coste** | Gratis, sin clave API | ~$0,0001 por búsqueda (Haiku) |
+| **Búsqueda** | Coincidencia de palabras clave FTS5 | + expansión de consultas LLM (~97% de recall) |
+| **Auto-capture** | Patrones basados en reglas | + LLM extrae decisiones y lecciones |
+| **Compresión** | No disponible | `consolidate` comprime memorias verbosas |
+| **Costo** | Gratis, sin clave API | ~$0.0001 por búsqueda (Haiku) |
 
 ---
 
-## Las 8 Herramientas de Memoria
+## Las 9 Herramientas de Memoria
 
 | Herramienta | Qué hace |
-|------|-------------|
-| `remember` | Guarda conocimiento con observaciones, relaciones y etiquetas |
-| `recall` | Búsqueda inteligente con puntuación multifactorial y expansión de consulta por LLM |
-| `forget` | Archivado suave (nunca borra) o elimina observaciones específicas |
-| `consolidate` | Compresión de memorias extensas asistida por LLM |
-| `export` | Comparte memorias como JSON entre proyectos o miembros del equipo |
-| `import` | Importa memorias con estrategias de fusión (omitir / sobrescribir / añadir) |
-| `learn` | Registra lecciones estructuradas a partir de errores (error, causa raíz, corrección, prevención) |
-| `user_patterns` | Analiza tus patrones de trabajo — horario, herramientas, fortalezas, áreas de aprendizaje |
+|---|---|
+| `remember` | Guardar conocimiento con observaciones, relaciones y etiquetas |
+| `recall` | Búsqueda inteligente con scoring multifactor y expansión de consultas LLM |
+| `forget` | Archivo suave (nunca borra) o elimina observaciones específicas |
+| `consolidate` | Compresión impulsada por LLM de memorias verbosas |
+| `export` | Compartir memorias como JSON entre proyectos o miembros del equipo |
+| `import` | Importar memorias con estrategias de fusión (skip / overwrite / append) |
+| `learn` | Registrar lecciones estructuradas de errores (error, causa raíz, corrección, prevención) |
+| `user_patterns` | Analizar tus patrones de trabajo — horario, herramientas, fortalezas, áreas de aprendizaje |
+| `verify_agent_work` | Persiste un reporte de verificación para trabajo de agente de fondo; verifica cambios de archivos contra `git diff` |
 
 ---
 
@@ -234,7 +262,7 @@ memesh  # abre el panel → pestaña Configuración
                     (~/.memesh/knowledge-graph.db)
 ```
 
-El núcleo es independiente del framework. La misma lógica se ejecuta desde el terminal, HTTP o MCP.
+El core es agnóstico de framework. La misma lógica se ejecuta desde terminal, HTTP o MCP.
 
 ---
 
@@ -243,10 +271,11 @@ El núcleo es independiente del framework. La misma lógica se ejecuta desde el
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
 cd memesh-llm-memory && npm install && npm run build
-npm test -- --run    # 413 tests
+npm test             # 489 tests
+npm run test:e2e-dashboard
 ```
 
-Panel: `cd dashboard && npm install && npm run dev`
+Dashboard: `cd dashboard && npm install && npm run dev`
 
 ---