@pcircle/memesh 2.10.1 → 3.0.0

package/scripts/hooks/session-summary.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+
+// Session Auto-Capture — Stop hook
+// Extracts knowledge from completed Claude Code sessions
+// and stores as session-insight entities in MeMesh.
+
+import { createRequire } from 'module';
+import { homedir } from 'os';
+import { join, basename } from 'path';
+import { existsSync, mkdirSync, readFileSync } from 'fs';
+
+const require = createRequire(import.meta.url);
+
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS entities (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  type TEXT NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  metadata JSON
+);
+
+CREATE TABLE IF NOT EXISTS observations (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  entity_id INTEGER NOT NULL,
+  content TEXT NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS relations (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  from_entity_id INTEGER NOT NULL,
+  to_entity_id INTEGER NOT NULL,
+  relation_type TEXT NOT NULL,
+  metadata JSON,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (from_entity_id) REFERENCES entities(id) ON DELETE CASCADE,
+  FOREIGN KEY (to_entity_id) REFERENCES entities(id) ON DELETE CASCADE,
+  UNIQUE(from_entity_id, to_entity_id, relation_type)
+);
+
+CREATE TABLE IF NOT EXISTS tags (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  entity_id INTEGER NOT NULL,
+  tag TEXT NOT NULL,
+  FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_tags_entity ON tags(entity_id);
+CREATE INDEX IF NOT EXISTS idx_tags_tag ON tags(tag);
+DELETE FROM tags
+WHERE id NOT IN (
+  SELECT MIN(id)
+  FROM tags
+  GROUP BY entity_id, tag
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_tags_entity_tag_unique ON tags(entity_id, tag);
+CREATE INDEX IF NOT EXISTS idx_observations_entity ON observations(entity_id);
+CREATE INDEX IF NOT EXISTS idx_relations_from ON relations(from_entity_id);
+CREATE INDEX IF NOT EXISTS idx_relations_to ON relations(to_entity_id);
+`;
+
+// Parse a JSONL transcript file.
+// Mirrors logic in src/core/extractor.ts parseTranscript().
+// Defensive: never throws — malformed lines are silently skipped.
+function parseTranscript(transcriptPath) {
+  const filesEdited = new Set();
+  const bashCommands = [];
+  const errorsEncountered = [];
+  let toolCallCount = 0;
+
+  try {
+    const lines = readFileSync(transcriptPath, 'utf8').split('\n').filter(l => l.trim());
+    for (const line of lines) {
+      try {
+        const entry = JSON.parse(line);
+
+        // Count tool calls
+        if (entry.type === 'tool_use' || entry.tool_name) toolCallCount++;
+
+        // Track file edits (Write, Edit tools)
+        if (entry.tool_name === 'Write' || entry.tool_name === 'Edit') {
+          const inp = entry.tool_input ?? {};
+          const fp = (inp.file_path ?? inp.path);
+          if (fp && typeof fp === 'string') filesEdited.add(basename(fp));
+        }
+
+        // Track meaningful bash commands
+        if (entry.tool_name === 'Bash') {
+          const cmd = (entry.tool_input?.command) ?? '';
+          if (typeof cmd === 'string' && cmd.length > 10 && !cmd.startsWith('ls') && !cmd.startsWith('cd')) {
+            bashCommands.push(cmd.slice(0, 100));
+          }
+        }
+
+        // Track errors from tool results
+        if (entry.type === 'tool_result' && entry.content != null) {
+          const text = typeof entry.content === 'string'
+            ? entry.content
+            : JSON.stringify(entry.content);
+          if (text.includes('Error') || text.includes('FAIL') || text.includes('error:')) {
+            errorsEncountered.push(text.slice(0, 200));
+          }
+        }
+      } catch {
+        // Skip malformed JSONL lines
+      }
+    }
+  } catch {
+    // Transcript unreadable — return empty results
+  }
+
+  return { filesEdited: [...filesEdited], bashCommands, errorsEncountered, toolCallCount };
+}
+
+// Main: read stdin, extract insights, store in DB
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => { input += chunk; });
+process.stdin.on('end', () => {
+  try {
+    if (!input.trim()) return exit0();
+
+    // Opt-out check
+    if (process.env.MEMESH_AUTO_CAPTURE === 'false') return exit0();
+
+    let inputData;
+    try {
+      inputData = JSON.parse(input);
+    } catch {
+      return exit0();
+    }
+
+    const sessionId = inputData.session_id || 'unknown';
+    const transcriptPath = inputData.transcript_path;
+    const cwd = inputData.cwd || process.cwd();
+    const stopReason = inputData.stop_reason || 'unknown';
+    const wasAgenticLoop = inputData.was_in_agentic_loop === true;
+
+    // Guards: skip low-signal sessions
+    if (stopReason === 'user_interrupt') return exit0();
+    if (!wasAgenticLoop) return exit0();
+    if (!transcriptPath || !existsSync(transcriptPath)) return exit0();
+
+    // Parse transcript
+    const { filesEdited, bashCommands, errorsEncountered, toolCallCount } = parseTranscript(transcriptPath);
+
+    // Skip sessions with too little activity
+    if (toolCallCount < 3) return exit0();
+
+    // Open DB
+    const dbPath = process.env.MEMESH_DB_PATH || join(homedir(), '.memesh', 'knowledge-graph.db');
+    const dbDir = process.env.MEMESH_DB_PATH
+      ? join(process.env.MEMESH_DB_PATH, '..')
+      : join(homedir(), '.memesh');
+    if (!existsSync(dbDir)) mkdirSync(dbDir, { recursive: true });
+
+    const Database = require('better-sqlite3');
+    const sqliteVec = require('sqlite-vec');
+
+    const db = new Database(dbPath);
+    try {
+      db.pragma('journal_mode = WAL');
+      db.pragma('foreign_keys = ON');
+
+      // Ensure schema exists (tables may already exist from MeMesh server)
+      db.exec(SCHEMA_SQL);
+
+      // Migrate: add status column if missing (v2.11 -> v2.12)
+      const cols = db.prepare("PRAGMA table_info(entities)").all();
+      if (!cols.some(c => c.name === 'status')) {
+        db.exec("ALTER TABLE entities ADD COLUMN status TEXT NOT NULL DEFAULT 'active'");
+        db.exec("CREATE INDEX IF NOT EXISTS idx_entities_status ON entities(status)");
+      }
+
+      // Load sqlite-vec extension
+      sqliteVec.load(db);
+
+      // Duplicate detection: if we already captured this session, bail
+      const shortId = sessionId.slice(0, 8);
+      const alreadyCaptured = db.prepare("SELECT id FROM entities WHERE name = ?").get(`session-${shortId}-files`);
+      if (alreadyCaptured) return exit0();
+
+      // Build and store session memories
+      const projectName = basename(cwd);
+      const baseTags = ['source:auto-capture', `session:${shortId}`, `project:${projectName}`];
+
+      const insertEntity = db.prepare('INSERT OR IGNORE INTO entities (name, type) VALUES (?, ?)');
+      const selectEntity = db.prepare('SELECT id FROM entities WHERE name = ?');
+      const insertObs = db.prepare('INSERT INTO observations (entity_id, content) VALUES (?, ?)');
+      const insertTag = db.prepare('INSERT OR IGNORE INTO tags (entity_id, tag) VALUES (?, ?)');
+
+      function storeMemory(name, type, observations, tags) {
+        insertEntity.run(name, type);
+        const row = selectEntity.get(name);
+        if (!row) return;
+        for (const obs of observations) insertObs.run(row.id, obs);
+        for (const tag of tags) insertTag.run(row.id, tag);
+      }
+
+      // Rule 1: File editing session summary
+      if (filesEdited.length > 0) {
+        storeMemory(
+          `session-${shortId}-files`,
+          'session-insight',
+          [
+            `Session edited ${filesEdited.length} file(s): ${filesEdited.join(', ')}`,
+            `Total tool calls: ${toolCallCount}`,
+          ],
+          baseTags
+        );
+      }
+
+      // Rule 2: Error -> Fix pattern detection
+      if (errorsEncountered.length > 0 && filesEdited.length > 0) {
+        storeMemory(
+          `session-${shortId}-fixes`,
+          'session-insight',
+          [
+            `Fixed ${errorsEncountered.length} error(s) by editing ${filesEdited.join(', ')}`,
+            ...errorsEncountered.slice(0, 3).map(e => `Error: ${e.slice(0, 100)}`),
+          ],
+          [...baseTags, 'type:bugfix']
+        );
+      }
+
+      // Rule 3: Heavy session summary (20+ tool calls = significant work)
+      if (toolCallCount >= 20) {
+        storeMemory(
+          `session-${shortId}-summary`,
+          'session-insight',
+          [
+            `Significant session: ${toolCallCount} tool calls, ${filesEdited.length} files edited`,
+            ...bashCommands.slice(0, 3).map(c => `Command: ${c}`),
+          ],
+          [...baseTags, 'type:heavy-session']
+        );
+      }
+    } finally {
+      db.close();
+    }
+  } catch (err) {
+    // Never crash Claude Code — leave a trace for debugging
+    try { process.stderr.write(`[memesh session-summary] ${err?.message || err}\n`); } catch {}
+  }
+
+  // Silent output — don't clutter Claude's response
+  console.log(JSON.stringify({ suppressOutput: true }));
+  exit0();
+});
+
+function exit0() {
+  process.exit(0);
+}

package/README.de.md

@@ -1,212 +0,0 @@
-<div align="center">
-
-<img src="https://img.shields.io/badge/%F0%9F%A7%A0-MeMesh-blueviolet?style=for-the-badge" alt="MeMesh" />
-
-# MeMesh Plugin
-
-### Deine KI-Coding-Sitzungen verdienen ein Gedächtnis.
-
-MeMesh Plugin gibt Claude Code ein persistentes, durchsuchbares Gedächtnis — damit jede Sitzung auf der vorherigen aufbaut.
-
-[![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
-[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
-[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
-[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
-[![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
-
-```bash
-npm install -g @pcircle/memesh
-```
-
-[Loslegen](#loslegen) · [So funktioniert es](#so-funktioniert-es) · [Befehle](#befehle) · [Dokumentation](docs/USER_GUIDE.md)
-
-[English](README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · **Deutsch** · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
-
-</div>
-
-> **Hinweis**: Dieses Projekt hieß ursprünglich „Claude Code Buddy" und wurde in MeMesh Plugin umbenannt, um mögliche Markenrechtsprobleme zu vermeiden.
-
----
-
-## Das Problem
-
-Du steckst mitten in einem Projekt mit Claude Code. Vor drei Sitzungen hast du wichtige Entscheidungen getroffen — welche Auth-Bibliothek, warum dieses Datenbankschema, welche Muster zu verwenden sind. Aber Claude erinnert sich nicht. Du wiederholst dich. Der Kontext geht verloren. Du verschwendest Zeit.
-
-**MeMesh löst das.** Es gibt Claude ein persistentes, durchsuchbares Gedächtnis, das mit deinem Projekt wächst.
-
----
-
-## So funktioniert es
-
-<table>
-<tr>
-<td width="50%">
-
-### Vor MeMesh
-```
-Sitzung 1: "Verwende JWT für Auth"
-Sitzung 2: "Warum haben wir JWT gewählt?"
-Sitzung 3: "Moment, welche Auth-Bibliothek nutzen wir?"
-```
-Du wiederholst Entscheidungen. Claude vergisst den Kontext. Der Fortschritt stockt.
-
-</td>
-<td width="50%">
-
-### Nach MeMesh
-```
-Sitzung 1: "Verwende JWT für Auth" → gespeichert
-Sitzung 2: buddy-remember "auth" → sofortiger Abruf
-Sitzung 3: Kontext wird beim Start automatisch geladen
-```
-Jede Sitzung knüpft dort an, wo du aufgehört hast.
-
-</td>
-</tr>
-</table>
-
----
-
-## Was du bekommst
-
-**Durchsuchbares Projektgedächtnis** — Frage „Was haben wir über Auth entschieden?" und erhalte sofort eine semantisch abgeglichene Antwort. Keine Stichwortsuche — *Bedeutungssuche*, angetrieben durch lokale ONNX-Embeddings.
-
-**Intelligente Aufgabenanalyse** — `buddy-do "Benutzer-Auth hinzufügen"` führt nicht einfach aus. Es zieht relevanten Kontext aus vergangenen Sitzungen, prüft welche Muster du etabliert hast und erstellt einen angereicherten Plan, bevor eine einzige Zeile geschrieben wird.
-
-**Proaktiver Abruf** — MeMesh ruft automatisch relevante Erinnerungen ab, wenn du eine Sitzung startest, ein Test fehlschlägt oder ein Fehler auftritt. Kein manuelles Suchen nötig.
-
-**Workflow-Automatisierung** — Sitzungszusammenfassungen beim Start. Verfolgung von Dateiänderungen. Code-Review-Erinnerungen vor Commits. Alles läuft leise im Hintergrund.
-
-**Aus Fehlern lernen** — Fehler und Korrekturen aufzeichnen, um eine Wissensbasis aufzubauen. Derselbe Fehler passiert nicht zweimal.
-
----
-
-## Loslegen
-
-**Voraussetzungen**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
-
-```bash
-npm install -g @pcircle/memesh
-```
-
-Claude Code neu starten. Das war's.
-
-**Überprüfen** — tippe in Claude Code:
-
-```
-buddy-help
-```
-
-Du solltest eine Liste der verfügbaren Befehle sehen.
-
-<details>
-<summary><strong>Aus dem Quellcode installieren</strong> (für Mitwirkende)</summary>
-
-```bash
-git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
-cd claude-code-buddy
-npm install && npm run build
-```
-
-</details>
-
----
-
-## Befehle
-
-| Befehl | Was er tut |
-|--------|-----------|
-| `buddy-do "Aufgabe"` | Aufgabe mit vollem Gedächtniskontext ausführen |
-| `buddy-remember "Thema"` | Vergangene Entscheidungen und Kontext durchsuchen |
-| `buddy-help` | Verfügbare Befehle anzeigen |
-
-**Praxisbeispiele:**
-
-```bash
-# Sich in einer neuen Codebase orientieren
-buddy-do "explain this codebase"
-
-# Features mit Kontext aus vergangener Arbeit bauen
-buddy-do "add user authentication"
-
-# Nachvollziehen, warum Entscheidungen getroffen wurden
-buddy-remember "API design decisions"
-buddy-remember "why we chose PostgreSQL"
-```
-
-Alle Daten bleiben auf deinem Rechner mit automatischer 90-Tage-Aufbewahrung.
-
----
-
-## Wie unterscheidet sich das von CLAUDE.md?
-
-| | CLAUDE.md | MeMesh |
-|---|-----------|--------|
-| **Zweck** | Statische Anweisungen für Claude | Lebendiges Gedächtnis, das mit deinem Projekt wächst |
-| **Suche** | Manuelle Textsuche | Semantische Suche nach Bedeutung |
-| **Aktualisierung** | Du bearbeitest manuell | Erfasst Entscheidungen automatisch während der Arbeit |
-| **Abruf** | Wird immer geladen (kann lang werden) | Zeigt relevanten Kontext bei Bedarf |
-| **Umfang** | Allgemeine Präferenzen | Projektspezifischer Wissensgraph |
-
-**Sie ergänzen sich.** CLAUDE.md sagt Claude, *wie* er arbeiten soll. MeMesh erinnert sich daran, *was* ihr gebaut habt.
-
----
-
-## Plattformunterstützung
-
-| Plattform | Status |
-|-----------|--------|
-| macOS | ✅ |
-| Linux | ✅ |
-| Windows | ✅ (WSL2 empfohlen) |
-
-**Funktioniert mit:** Claude Code CLI · VS Code Extension · Cursor (via MCP) · Jeder MCP-kompatible Editor
-
----
-
-## Architektur
-
-MeMesh läuft als Claude Code Plugin lokal mit integrierter MCP-Komponente:
-
-- **Knowledge Graph** — SQLite-basierter Entity-Speicher mit FTS5-Volltextsuche
-- **Vector Embeddings** — ONNX Runtime für semantische Ähnlichkeit (läuft 100% lokal)
-- **Content Dedup** — SHA-256-Hashing überspringt redundante Embedding-Berechnungen
-- **Batch Processing** — Effiziente Massenoperationen für große Wissensbasen
-- **Hook System** — Proaktiver Abruf bei Sitzungsstart, Testfehlern und Fehlern
-
-Alles läuft lokal. Keine Cloud. Keine API-Aufrufe. Deine Daten verlassen nie deinen Rechner.
-
----
-
-## Dokumentation
-
-| Dokument | Beschreibung |
-|----------|-------------|
-| [Erste Schritte](docs/GETTING_STARTED.md) | Schritt-für-Schritt-Einrichtungsanleitung |
-| [Benutzerhandbuch](docs/USER_GUIDE.md) | Vollständige Anleitung mit Beispielen |
-| [Befehle](docs/COMMANDS.md) | Komplette Befehlsreferenz |
-| [Architektur](docs/ARCHITECTURE.md) | Technischer Tiefgang |
-| [Mitwirken](CONTRIBUTING.md) | Richtlinien für Beiträge |
-| [Entwicklung](docs/DEVELOPMENT.md) | Entwicklungsumgebung für Mitwirkende |
-
----
-
-## Mitwirken
-
-Beiträge sind willkommen! Siehe [CONTRIBUTING.md](CONTRIBUTING.md) für den Einstieg.
-
----
-
-## Lizenz
-
-MIT — Siehe [LICENSE](LICENSE)
-
----
-
-<div align="center">
-
-**Gebaut mit Claude Code, für Claude Code.**
-
-[Bug melden](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [Feature anfragen](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [Hilfe erhalten](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
-
-</div>

package/README.es.md

@@ -1,212 +0,0 @@
-<div align="center">
-
-<img src="https://img.shields.io/badge/%F0%9F%A7%A0-MeMesh-blueviolet?style=for-the-badge" alt="MeMesh" />
-
-# MeMesh Plugin
-
-### Tus sesiones de programación con IA merecen memoria.
-
-MeMesh Plugin le da a Claude Code una memoria persistente y consultable — para que cada sesión se base en la anterior.
-
-[![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
-[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
-[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
-[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
-[![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
-
-```bash
-npm install -g @pcircle/memesh
-```
-
-[Comenzar](#comenzar) · [Cómo funciona](#cómo-funciona) · [Comandos](#comandos) · [Docs](docs/USER_GUIDE.md)
-
-[English](README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · **Español** · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
-
-</div>
-
-> **Nota**: Este proyecto se llamaba originalmente "Claude Code Buddy" y fue renombrado a MeMesh Plugin para evitar posibles problemas de marca registrada.
-
----
-
-## El problema
-
-Estás metido de lleno en un proyecto con Claude Code. Tomaste decisiones importantes hace tres sesiones — qué biblioteca de autenticación usar, por qué elegiste ese esquema de base de datos, qué patrones seguir. Pero Claude no recuerda. Te repites. Pierdes contexto. Pierdes tiempo.
-
-**MeMesh soluciona esto.** Le da a Claude una memoria persistente y consultable que crece con tu proyecto.
-
----
-
-## Cómo funciona
-
-<table>
-<tr>
-<td width="50%">
-
-### Antes de MeMesh
-```
-Session 1: "Use JWT for auth"
-Session 2: "Why did we pick JWT again?"
-Session 3: "Wait, what auth library are we using?"
-```
-Repites decisiones. Claude olvida el contexto. El progreso se detiene.
-
-</td>
-<td width="50%">
-
-### Después de MeMesh
-```
-Session 1: "Use JWT for auth" → saved
-Session 2: buddy-remember "auth" → instant recall
-Session 3: Context auto-loaded on start
-```
-Cada sesión continúa donde lo dejaste.
-
-</td>
-</tr>
-</table>
-
----
-
-## Lo que obtienes
-
-**Memoria de proyecto consultable** — Pregunta "¿qué decidimos sobre la auth?" y obtén una respuesta instantánea con coincidencia semántica. No es búsqueda por palabras clave — es búsqueda por *significado*, impulsada por embeddings ONNX locales.
-
-**Análisis inteligente de tareas** — `buddy-do "add user auth"` no solo ejecuta. Extrae contexto relevante de sesiones anteriores, verifica qué patrones has establecido y construye un plan enriquecido antes de escribir una sola línea.
-
-**Recuperación proactiva** — MeMesh muestra automáticamente memorias relevantes cuando inicias una sesión, cuando falla un test o cuando encuentras un error. Sin búsqueda manual necesaria.
-
-**Automatización del flujo de trabajo** — Resúmenes de sesión al iniciar. Seguimiento de cambios en archivos. Recordatorios de revisión de código antes de commits. Todo ejecutándose silenciosamente en segundo plano.
-
-**Aprendizaje de errores** — Registra errores y correcciones para construir una base de conocimiento. El mismo error no ocurre dos veces.
-
----
-
-## Comenzar
-
-**Requisitos previos**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
-
-```bash
-npm install -g @pcircle/memesh
-```
-
-Reinicia Claude Code. Eso es todo.
-
-**Verificar** — escribe en Claude Code:
-
-```
-buddy-help
-```
-
-Deberías ver una lista de comandos disponibles.
-
-<details>
-<summary><strong>Instalar desde el código fuente</strong> (contribuidores)</summary>
-
-```bash
-git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
-cd claude-code-buddy
-npm install && npm run build
-```
-
-</details>
-
----
-
-## Comandos
-
-| Comando | Qué hace |
-|---------|----------|
-| `buddy-do "tarea"` | Ejecutar una tarea con contexto de memoria completo |
-| `buddy-remember "tema"` | Buscar decisiones y contexto anteriores |
-| `buddy-help` | Mostrar comandos disponibles |
-
-**Ejemplos reales:**
-
-```bash
-# Orientarte en un codebase nuevo para ti
-buddy-do "explain this codebase"
-
-# Construir funcionalidades con contexto de trabajo anterior
-buddy-do "add user authentication"
-
-# Recordar por qué se tomaron decisiones
-buddy-remember "API design decisions"
-buddy-remember "why we chose PostgreSQL"
-```
-
-Todos los datos permanecen en tu máquina con retención automática de 90 días.
-
----
-
-## ¿En qué se diferencia de CLAUDE.md?
-
-| | CLAUDE.md | MeMesh |
-|---|-----------|--------|
-| **Propósito** | Instrucciones estáticas para Claude | Memoria viva que crece con tu proyecto |
-| **Búsqueda** | Búsqueda manual de texto | Búsqueda semántica por significado |
-| **Actualizaciones** | Las editas manualmente | Captura decisiones automáticamente mientras trabajas |
-| **Recuperación** | Siempre cargado (puede volverse extenso) | Muestra contexto relevante bajo demanda |
-| **Alcance** | Preferencias generales | Grafo de conocimiento específico del proyecto |
-
-**Funcionan juntos.** CLAUDE.md le dice a Claude *cómo* trabajar. MeMesh recuerda *qué* has construido.
-
----
-
-## Plataformas soportadas
-
-| Plataforma | Estado |
-|------------|--------|
-| macOS | ✅ |
-| Linux | ✅ |
-| Windows | ✅ (WSL2 recomendado) |
-
-**Compatible con:** Claude Code CLI · VS Code Extension · Cursor (vía MCP) · Cualquier editor compatible con MCP
-
----
-
-## Arquitectura
-
-MeMesh funciona como un plugin de Claude Code en local, con un componente MCP integrado:
-
-- **Grafo de conocimiento** — Almacén de entidades respaldado por SQLite con búsqueda de texto completo FTS5
-- **Embeddings vectoriales** — Runtime ONNX para similitud semántica (se ejecuta 100% localmente)
-- **Deduplicación de contenido** — Hashing SHA-256 omite cálculos de embedding redundantes
-- **Procesamiento por lotes** — Operaciones masivas eficientes para grandes bases de conocimiento
-- **Sistema de hooks** — Recuperación proactiva al iniciar sesión, fallos de tests y errores
-
-Todo se ejecuta localmente. Sin nube. Sin llamadas API. Tus datos nunca salen de tu máquina.
-
----
-
-## Documentación
-
-| Documento | Descripción |
-|-----------|-------------|
-| [Primeros pasos](docs/GETTING_STARTED.md) | Guía de configuración paso a paso |
-| [Guía de usuario](docs/USER_GUIDE.md) | Guía completa de uso con ejemplos |
-| [Comandos](docs/COMMANDS.md) | Referencia completa de comandos |
-| [Arquitectura](docs/ARCHITECTURE.md) | Análisis técnico en profundidad |
-| [Contribuir](CONTRIBUTING.md) | Directrices para contribuir |
-| [Desarrollo](docs/DEVELOPMENT.md) | Configuración de desarrollo para contribuidores |
-
----
-
-## Contribuir
-
-¡Las contribuciones son bienvenidas! Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para comenzar.
-
----
-
-## Licencia
-
-MIT — Ver [LICENSE](LICENSE)
-
----
-
-<div align="center">
-
-**Construido con Claude Code, para Claude Code.**
-
-[Reportar bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [Solicitar función](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [Obtener ayuda](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
-
-</div>