@pcircle/memesh 4.0.3 → 4.1.0

package/README.es.md

@@ -1,110 +1,284 @@
+<!-- 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 local para Claude Code y los coding agents compatibles con MCP.</strong><br />
-    Un archivo SQLite. Sin Docker. Sin depender de la 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>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-22c55e?style=flat-square" alt="MIT" /></a>
+    <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-22c55e?style=flat-square" alt="Node" /></a>
+    <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-a855f7?style=flat-square" alt="MCP" /></a>
   </p>
 </p>
 
-> Este README en español es una guía resumida. Para la documentación completa y más reciente, toma como referencia el [English README](README.md).
+---
 
-## ¿Qué problema resuelve?
+## El Problema
 
-Los coding agents pierden el contexto con facilidad entre sesiones. Decisiones de arquitectura, bugs ya corregidos, lecciones aprendidas y restricciones del proyecto terminan explicándose una y otra 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 conserva ese conocimiento en local, lo hace consultable y permite reutilizarlo cuando vuelve a hacer falta.**
+**MeMesh proporciona a los agentes de codificación memoria local persistente, buscable y en evolución.**
 
-Este paquete npm es la versión local del plugin / package de MeMesh. No es el producto de workspace en la nube ni una plataforma enterprise completa.
+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
+---
 
-### 1. Instala
+## Primeros Pasos en 60 Segundos
+
+### Paso 1: Instala
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-### 2. Guarda una decisión
+### Paso 2: Guarda una decisión
 
 ```bash
 memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
 ```
 
-### 3. Recupérala después
+### Paso 3: Recupérala después
 
 ```bash
 memesh recall "login security"
-# → encuentra "OAuth 2.0 with PKCE" aunque uses otras palabras
+# → Encuentra "OAuth 2.0 with PKCE" aunque buscaste palabras diferentes
+```
+
+**Eso es todo.** MeMesh ahora está recordando y recuperando a través de sesiones.
+
+Si quieres verificar la instalación y la conexión local de extremo a extremo:
+
+```bash
+memesh doctor
 ```
 
-Abre el dashboard:
+Abre el dashboard para explorar tu memoria:
 
 ```bash
 memesh
 ```
 
-## ¿Para quién está pensado?
+<p align="center">
+  <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 — puntuación de salud, línea de tiempo, patrones, cobertura del conocimiento" width="100%" />
+</p>
+
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — grafo de conocimiento interactivo con filtros de tipo y modo ego" width="100%" />
+</p>
+
+---
+
+## ¿Para Quién Es Esto?
+
+| Si eres... | MeMesh te ayuda a... |
+|---|---|
+| **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 |
+
+---
+
+## Diseñado para Agentes de Codificación en Primer Lugar
+
+<table>
+<tr>
+<td width="33%" align="center">
+
+**Claude Code / Desktop**
+```bash
+memesh-mcp
+```
+Herramientas MCP + hooks de Claude Code
+
+</td>
+<td width="33%" align="center">
+
+**Cualquier Cliente HTTP**
+```bash
+curl localhost:3737/v1/recall \
+  -H "Content-Type: application/json" \
+  -d '{"query":"auth"}'
+```
+`memesh serve` (REST API)
+
+</td>
+<td width="33%" align="center">
+
+**Cualquier LLM (formato OpenAI)**
+```bash
+memesh export-schema \
+  --format openai
+```
+Pega las herramientas en cualquier llamada API
+
+</td>
+</tr>
+</table>
+
+---
 
-- Desarrolladores que usan Claude Code y quieren mantener contexto entre sesiones
-- Usuarios avanzados que quieren compartir la misma memoria local entre varios MCP coding agents
-- Equipos AI-native pequeños que quieren compartir conocimiento de proyecto vía export / import
-- Desarrolladores de agents que quieren integrar memoria local mediante CLI, HTTP o MCP
+## ¿Por Qué No OpenMemory, Cursor Memories, Mem0 o Zep?
 
-## ¿Por qué MeMesh?
+| | **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 |
 
-- Local-first: los datos quedan en tu propio archivo SQLite
-- Instalación ligera: `npm install -g` y listo
-- Integración directa: soporta CLI, HTTP y MCP
-- Encaja bien con Claude Code: los hooks ayudan a traer el contexto adecuado al flujo de trabajo
-- Es visible y manejable: el dashboard permite revisar y limpiar la memoria
-- Límite de confianza más seguro: la memoria importada sigue siendo searchable, pero no se inyecta automáticamente en los hooks de Claude hasta que la revises o la vuelvas a guardar en local
+**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é hace automáticamente en Claude Code?
+---
 
-Hoy MeMesh ayuda en 5 momentos:
+## Qué Sucede Automáticamente en Claude Code
 
-- al iniciar la sesión, carga memorias relevantes y lecciones ya conocidas
-- antes de editar archivos, recupera memoria relacionada con el archivo o el proyecto
-- después de `git commit`, registra los cambios realizados
-- al terminar la sesión, resume correcciones, errores y lessons learned
-- antes del compactado de contexto, guarda lo importante en la memoria local
+No necesitas recordar todo manualmente. MeMesh tiene **6 hooks** que capturan e inyectan conocimiento mientras trabajas:
 
-## ¿Qué incluye el dashboard?
+| Cuándo | Qué hace MeMesh |
+|---|---|
+| **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 compresión de contexto** | Guarda conocimiento antes de que se pierda en límites de contexto |
 
-El dashboard tiene 7 pestañas y soporte para 11 idiomas:
+> **Desactiva en cualquier momento:** `export MEMESH_AUTO_CAPTURE=false`
 
-- Search: buscar memoria
-- Browse: ver todas las memorias
-- Analytics: revisar salud y tendencias
-- Graph: ver relaciones de conocimiento
-- Lessons: revisar lecciones aprendidas
-- Manage: archivar y restaurar
-- Settings: configurar proveedor de LLM e idioma
+---
 
-## ¿Qué es Smart Mode?
+## Dashboard
 
-MeMesh funciona offline por defecto. Si configuras una API key de LLM, puedes activar capacidades adicionales, por ejemplo:
+7 pestañas, 11 idiomas, cero dependencias externas. Accede en `http://localhost:3737/dashboard` cuando el servidor está en ejecución.
 
-- query expansion
-- mejor extracción automática
-- organización y compresión más inteligentes
+| Pestaña | Qué ves |
+|---|---|
+| **Search** | Búsqueda de texto completo + similitud vectorial en todas las memorias |
+| **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** | Archiva y restaura entidades |
+| **Settings** | Configuración de proveedor LLM, selector de idioma instantáneo |
 
-Sin API key, las funciones principales siguen disponibles.
+---
 
-## Más información
+## Características Inteligentes
 
-- Funciones completas, comparativas, API y detalles de release: [English README](README.md)
-- Guía de integraciones: [docs/platforms/README.md](docs/platforms/README.md)
-- Referencia de API: [docs/api/API_REFERENCE.md](docs/api/API_REFERENCE.md)
+**🧠 Búsqueda Inteligente** — Busca "login security" y encuentra memorias sobre "OAuth PKCE". MeMesh expande consultas con términos relacionados usando tu LLM configurado.
 
-## Desarrollo y verificación
+**📊 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 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 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**
+
+---
+
+## Desbloquea Modo Inteligente (Opcional)
+
+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 dashboard (configuración visual):
+
+```bash
+memesh  # abre dashboard → pestaña Settings
+```
+
+| | Nivel 0 (por defecto) | Nivel 1 (Modo Inteligente) |
+|---|---|---|
+| **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 9 Herramientas de Memoria
+
+| Herramienta | Qué hace |
+|---|---|
+| `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` |
+
+---
+
+## Arquitectura
+
+```
+                    ┌─────────────────┐
+                    │   Core Engine   │
+                    │  (8 operations) │
+                    └────────┬────────┘
+           ┌─────────────────┼─────────────────┐
+           │                 │                 │
+     CLI (memesh)    HTTP API (serve)    MCP (memesh-mcp)
+           │                 │                 │
+           └─────────────────┼─────────────────┘
+                             │
+                    SQLite + FTS5 + sqlite-vec
+                    (~/.memesh/knowledge-graph.db)
+```
+
+El core es agnóstico de framework. La misma lógica se ejecuta desde terminal, HTTP o MCP.
+
+---
+
+## Contribuir
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
-cd memesh-llm-memory
-npm install
-npm run build
-npm test
+cd memesh-llm-memory && npm install && npm run build
+npm test             # 489 tests
+npm run test:e2e-dashboard
 ```
+
+Dashboard: `cd dashboard && npm install && npm run dev`
+
+---
+
+<p align="center">
+  <strong>MIT</strong> — Hecho por <a href="https://pcircle.ai">PCIRCLE AI</a>
+</p>