@pcircle/memesh 4.0.2 → 4.1.0

package/README.de.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>Die leichteste universelle KI-Gedächtnisschicht.</strong><br />
-    Eine SQLite-Datei. Jedes LLM. Kein Cloud-Dienst.
+    <strong>Lokaler Speicher für Claude Code und MCP-Coding-Agenten.</strong><br />
+    Eine SQLite-Datei. Kein Docker. Keine Cloud erforderlich.
   </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,67 +21,75 @@
 
 ## Das Problem
 
-Deine KI vergisst zwischen Sessions alles. Jede Entscheidung, jeder Bugfix, jede Erkenntnis — weg. Du erklärst denselben Kontext immer wieder, Claude entdeckt dieselben Muster erneut, und das KI-Wissen deines Teams wird jedes Mal auf null zurückgesetzt.
+Ihr Coding-Agent vergisst, was zwischen Sessions passiert ist. Jede Architekturentscheidung, jede Bugfix, jeder fehlgeschlagene Test und jede hart erarbeitete Erkenntnis muss erneut erklärt werden. Claude Code startet von vorne, entdeckt alte Constraints neu und verschwendet Context auf Dinge, die es längst wissen sollte.
+
+**MeMesh gibt Coding-Agenten persistenten, durchsuchbaren und evolvirenden lokalen Speicher.**
 
-**MeMesh gibt jeder KI ein dauerhaftes, durchsuchbares und sich weiterentwickelndes Gedächtnis.**
+Dieses Paket ist die lokale Speicherschicht der MeMesh-Produktfamilie. Es ist bewusst klein und Open-Source gestaltet: Installation via npm, Speicherung im Wissensgraphen unter `~/.memesh/knowledge-graph.db`, Anbindung an Claude Code oder jeden MCP-kompatiblen Client. Gehostete Workspace- und Enterprise-Betriebssystem-Produkte bleiben separat von diesem README und der Roadmap.
 
 ---
 
-## In 60 Sekunden Loslegen
+## In 60 Sekunden starten
 
-### Schritt 1: Installieren
+### Schritt 1: Installation
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-### Schritt 2: Deine KI erinnert sich
+### Schritt 2: Entscheidung speichern
 
 ```bash
 memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
 ```
 
-### Schritt 3: Deine KI ruft ab
+### Schritt 3: Später abrufen
 
 ```bash
 memesh recall "login security"
-# → Findet "OAuth 2.0 with PKCE", obwohl du andere Wörter verwendet hast
+# → Findet "OAuth 2.0 with PKCE" auch mit anderen Suchbegriffen
 ```
 
-**Das war's.** MeMesh erinnert und ruft nun über Sessions hinweg ab.
+**Das ist alles.** MeMesh merkt sich jetzt Informationen über Sessions hinweg.
 
-Öffne das Dashboard, um dein Gedächtnis zu erkunden:
+Um Installation und lokale Integration End-to-End zu überprüfen:
+
+```bash
+memesh doctor
+```
+
+Dashboard öffnen, um den Speicher zu erkunden:
 
 ```bash
 memesh
 ```
 
 <p align="center">
-  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — finde jede Erinnerung sofort" width="100%" />
+  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — find any memory instantly" width="100%" />
 </p>
 
 <p align="center">
-  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — verstehe das Wissen deiner KI" width="100%" />
+  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — health score, timeline, patterns, knowledge coverage" width="100%" />
 </p>
 
 <p align="center">
-  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — interaktiver Wissensgraph mit Typfiltern und Ego-Modus" width="100%" />
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — interactive knowledge graph with type filters and ego mode" width="100%" />
 </p>
 
 ---
 
-## Für Wen ist Das?
+## Für wen ist das gedacht?
 
-| Wenn du... | hilft dir MeMesh... |
+| Wenn Sie... | hilft Ihnen MeMesh... |
 |---------------|---------------------|
-| **Entwickler der Claude Code nutzt** | Entscheidungen, Muster und Erkenntnisse sitzungsübergreifend automatisch zu merken |
-| **Team, das mit LLMs entwickelt** | Team-Wissen per Export/Import zu teilen und den KI-Kontext aller synchron zu halten |
-| **KI-Agent-Entwickler** | Deinen Agenten über MCP, HTTP API oder Python SDK dauerhaftes Gedächtnis zu geben |
-| **Power-User mit mehreren KI-Tools** | Eine Gedächtnisschicht für Claude, GPT, LLaMA, Ollama oder jeden MCP-Client |
+| **Claude Code verwenden** | Projektentscheidungen, dateispezifische Erkenntnisse und vergangene Fehler während der Arbeit automatisch abrufen |
+| **Power-User von Coding-Agenten** | Eine lokale Speicherschicht über MCP-kompatible Tools verteilen |
+| **ein Team mit KI-Coding-Workflows experimentiert** | Projektwissen ohne gehostete Infrastruktur aus- und importieren |
+| **Agent-Entwickler** | Lokalen Speicher via MCP, HTTP, CLI oder Python-SDK hinzufügen |
 
 ---
 
-## Funktioniert mit Allem
+## Speziell für Coding-Agenten entwickelt
 
 <table>
 <tr>
@@ -88,28 +99,28 @@ memesh
 ```bash
 memesh-mcp
 ```
-MCP-Protokoll (automatisch konfiguriert)
+MCP-Tools + Claude Code Hooks
 
 </td>
 <td width="33%" align="center">
 
-**Python / LangChain**
-```python
-from memesh import MeMesh
-m = MeMesh()
-m.recall("auth")
+**Beliebige HTTP-Clients**
+```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">
 
-**Beliebige LLMs (OpenAI-Format)**
+**Jedes LLM (OpenAI-Format)**
 ```bash
 memesh export-schema \
   --format openai
 ```
-Tools in jeden API-Aufruf einfügen
+Tools in beliebige API-Aufrufe einfügen
 
 </td>
 </tr>
@@ -117,103 +128,120 @@ Tools in jeden API-Aufruf einfügen
 
 ---
 
-## Warum Nicht Einfach Mem0 / Zep?
+## Warum nicht OpenMemory, Cursor Memories, Mem0 oder Zep?
 
-| | **MeMesh** | Mem0 | Zep |
-|---|---|---|---|
-| **Installationszeit** | 5 Sekunden | 30–60 Minuten | 30+ Minuten |
-| **Einrichtung** | `npm i -g` — fertig | Neo4j + VectorDB + API-Schlüssel | Neo4j + Konfiguration |
-| **Speicherung** | Einzelne SQLite-Datei | Neo4j + Qdrant | Neo4j |
-| **Offline nutzbar** | Ja, immer | Nein | Nein |
-| **Dashboard** | Integriert (7 Tabs + Analytik) | Keins | Keins |
-| **Abhängigkeiten** | 6 | 20+ | 10+ |
-| **Preis** | Dauerhaft kostenlos | Kostenlose Stufe / Kostenpflichtig | Kostenlose Stufe / Kostenpflichtig |
+| | **MeMesh** | OpenMemory | Cursor Memories | Mem0 | Zep / Graphiti |
+|---|---|---|---|---|---|
+| **Beste Eignung** | Lokaler Speicher für Coding-Agenten | Lokaler/MCP-basierter Cross-Client-Speicher | Cursor-natives Projektgedächtnis | Verwalteter App-/Agent-Speicher | Temporale Wissensgraphen |
+| **Installationsform** | `npm install -g @pcircle/memesh` | Lokale App/Server-Flow | In Cursor eingebaut | Cloud API / SDK / MCP | Service/Framework-Setup |
+| **Speicherung** | Eine lokale SQLite-Datei | Lokaler Memory-Stack | Cursor-verwaltete Regeln/Memories | Gehostet oder selbstgehostet | Graphdatenbank |
+| **Cloud erforderlich** | Nein | Nein im lokalen Modus | Abhängig von Cursor-Konto/-Einstellungen | Ja für Plattform | Meist ja/selbstgehostet |
+| **Claude Code Hooks** | Erste Klasse | MCP-Tools | Nein | MCP-Tools | Nicht Claude Code-spezifisch |
+| **Dashboard** | Eingebaut | Eingebaut | Cursor-Einstellungen | Plattform-Dashboard | Plattform/Graph-Tools |
+| **Tradeoff** | Einfache lokale Lösung, nicht Enterprise-skaliert | Größerer lokaler App-Footprint | An Cursor gebunden | Starke verwaltete Plattform, weniger lokal | Starkes Graph-Modell, aufwendigere Einrichtung |
 
-**MeMesh tauscht:** Enterprise-Multi-Tenant-Funktionen gegen **sofortige Einrichtung, kein Infrastrukturaufwand und 100 % Datenschutz**.
+**MeMesh tauscht Enterprise-skalierte verwaltete Infrastruktur gegen sofortige lokale Einrichtung, inspektierbaren Speicher und Coding-Agent-Workflow-Hooks.**
 
 ---
 
-## Was Automatisch Passiert
+## Was läuft in Claude Code automatisch ab
 
-Du musst nicht alles manuell merken. MeMesh hat **4 Hooks**, die Wissen erfassen, ohne dass du etwas tun musst:
+Sie müssen nicht manuell alles speichern. MeMesh verfügt über **6 Hooks**, die Wissen während der Arbeit erfassen und injizieren:
 
-| Wann | Was MeMesh tut |
+| Wenn | Was MeMesh tut |
 |------|------------------|
-| **Zu Beginn jeder Session** | Lädt deine relevantesten Erinnerungen + proaktive Warnungen aus früheren Lektionen |
-| **Nach jedem `git commit`** | Erfasst was du geändert hast, mit Diff-Statistiken |
-| **Wenn Claude beendet** | Erfasst bearbeitete Dateien, behobene Fehler und generiert automatisch strukturierte Lektionen aus Fehlern |
-| **Vor der Kontextkomprimierung** | Sichert Wissen, bevor es durch Kontextgrenzen verloren geht |
+| **Am Anfang jeder Session** | Lädt Ihre relevantesten Memories + proaktive Warnungen aus früheren Lektionen + Agentur-Orchestrierungs-Banner |
+| **Vor Dateibearbeitungen** | Ruft Memories ab, die an die Datei oder das Projekt gebunden sind, bevor Claude Code schreibt |
+| **Vor Bash-Befehlen** | Ermutigt Claude, hochverifizierbare Befehle (Test, Build, Lint, Migration, Deployment, Benchmark) als Hintergrund-Agenten zu versenden |
+| **Nach jedem `git commit`** | Erfasst Ihre Änderungen mit Diff-Statistiken |
+| **Wenn Claude stoppt** | Erfasst bearbeitete Dateien und behobene Fehler; generiert automatisch strukturierte Lektionen aus Fehlern |
+| **Vor Context-Verdichtung** | Speichert Wissen, bevor es durch Context-Limits verloren geht |
 
-> **Jederzeit deaktivierbar:** `export MEMESH_AUTO_CAPTURE=false`
+> **Jederzeit abschalten:** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
 ## Dashboard
 
-7 Tabs, 11 Sprachen, null externe Abhängigkeiten. Zugriff über `http://localhost:3737/dashboard` wenn der Server läuft.
+7 Reiter, 11 Sprachen, keine externen Abhängigkeiten. Zugang unter `http://localhost:3737/dashboard` wenn der Server läuft.
 
-| Tab | Was du siehst |
-|-----|---------------|
-| **Search** | Volltextsuche + Vektor-Ähnlichkeitssuche über alle Erinnerungen |
-| **Browse** | Paginierte Liste aller Entitäten mit Archivierung/Wiederherstellung |
-| **Analytics** | Memory Health Score (0-100), 30-Tage-Timeline, Wert-Metriken, Wissensabdeckung, Aufräum-Vorschläge, deine Arbeitsmuster |
-| **Graph** | Interaktiver kräftebasierter Wissensgraph mit Typfiltern, Suche, Ego-Modus, Aktualitäts-Heatmap |
-| **Lessons** | Strukturierte Lektionen aus vergangenen Fehlern (Fehler, Ursache, Fix, Prävention) |
+| Reiter | Was Sie sehen |
+|--------|-------------|
+| **Search** | Volltextsuche + Vektorsimilarität über alle Memories |
+| **Browse** | Paginierte Liste aller Entitäten mit Archiv-/Restore-Funktion |
+| **Analytics** | Memory Health Score (0-100), 30-Tage-Timeline, Wertkennzahlen, Wissensabdeckung, Bereinigungsvorschläge, Ihre Arbeitsmuster |
+| **Graph** | Interaktiver kraft-gerichteter Wissensgraph mit Typfiltern, Suche, Ego-Modus, Aktualitäts-Heatmap |
+| **Lessons** | Strukturierte Lektionen aus vergangenen Fehlern (Fehler, Grundursache, Behebung, Prävention) |
 | **Manage** | Entitäten archivieren und wiederherstellen |
-| **Settings** | LLM-Anbieter-Konfiguration, Sprachauswahl |
+| **Settings** | LLM-Provider-Konfiguration, sofortiger Sprachwahlschalter |
 
 ---
 
-## Intelligente Funktionen
+## Intelligente Features
 
-**🧠 Smart Search** — Suche nach „login security" und finde Erinnerungen über „OAuth PKCE". MeMesh erweitert Suchanfragen mit verwandten Begriffen über das konfigurierte LLM.
+**🧠 Intelligente Suche** — Suche nach „Login Security" und finde Memories über „OAuth PKCE". MeMesh erweitert Anfragen mit verwandten Begriffen unter Verwendung Ihres konfigurierten LLM.
+
+**📊 Bewertetes Ranking** — Ergebnisse geordnet nach Relevanz (30%) + Aktualität (25%) + Häufigkeit (15%) + Konfidenz (15%) + Abruf-Auswirkung (10%) + Zeitliche Gültigkeit (5%).
+
+**🔄 Wissensentwicklung** — Entscheidungen ändern sich. `forget` archiviert alte Memories (löscht nie). `supersedes`-Relationen verbinden alt → neu. Ihr KI sieht immer die aktuelle Version.
+
+**⚠️ Konflikterkennung** — Wenn Sie zwei Memories haben, die sich widersprechen, warnt Sie MeMesh.
+
+**📦 Team-Freigabe** — `memesh export > team-knowledge.json` → mit Team teilen → `memesh import team-knowledge.json`
+Importierte Bundles bleiben durchsuchbar, aber MeMesh injiziert importierte Memories nicht automatisch in Claude Hooks, bis Sie sie überprüfen oder lokal neu speichern.
+
+---
 
-**📊 Scored Ranking** — Ergebnisse gerankt nach Relevanz (35 %) + letzter Nutzung (25 %) + Häufigkeit (20 %) + Vertrauen (15 %) + ob die Info noch aktuell ist (5 %).
+## Beispiele aus der Praxis
 
-**🔄 Wissensentwicklung** — Entscheidungen ändern sich. `forget` archiviert alte Erinnerungen (löscht nie). `supersedes`-Beziehungen verknüpfen Alt mit Neu. Deine KI sieht immer die neueste Version.
+> "MeMesh hat sich daran erinnert, dass wir vor drei Wochen PKCE gegenüber Implicit Flow gewählt haben. Als ich Claude erneut nach Auth fragte, wusste es bereits Bescheid — keine Wiederholungen nötig."
+> — **Einzelentwickler, baut eine SaaS**
 
-**⚠️ Konflikterkennung** — Wenn zwei Erinnerungen sich widersprechen, warnt MeMesh dich.
+> "Wir exportieren unseren Team-Memory jeden Freitag und importieren ihn Montag. Jedes Claude des Teams startet die Woche mit dem Wissen aus der Vorwoche."
+> — **3er-Startup mit gemeinsamer Wissensbasis**
 
-**📦 Team-Sharing** — `memesh export > team-knowledge.json` → mit Team teilen → `memesh import team-knowledge.json`
+> "Das Dashboard zeigte mir, dass 90 % meiner Memories automatisch generierte Session-Logs waren. Ich begann, `remember` bewusst für Architekturentscheidungen zu nutzen. Ein Spielwechsel."
+> — **Entwickler, der den Analytics-Reiter entdeckte**
 
 ---
 
-## Smart Mode Freischalten (Optional)
+## Smart Mode freischalten (optional)
 
-MeMesh funktioniert standardmäßig vollständig offline. Füge einen LLM-API-Schlüssel hinzu, um intelligentere Suche zu aktivieren:
+MeMesh funktioniert standardmäßig offline. Fügen Sie einen LLM API-Schlüssel nur hinzu, wenn Sie Query-Erweiterung, intelligentere Extraktion und Kompression wünschen:
 
 ```bash
 memesh config set llm.provider anthropic
 memesh config set llm.api-key sk-ant-...
 ```
 
-Oder verwende den Einstellungs-Tab im Dashboard (visuelle Einrichtung):
+Oder nutzen Sie den Dashboard-Settings-Reiter (visuelles Setup):
 
 ```bash
-memesh  # öffnet Dashboard → Einstellungs-Tab
+memesh  # öffnet Dashboard → Settings-Reiter
 ```
 
-| | Level 0 (Standard) | Level 1 (Smart Mode) |
+| | Stufe 0 (Standard) | Stufe 1 (Smart Mode) |
 |---|---|---|
-| **Suche** | FTS5 Keyword-Matching | + LLM-Anfrageerweiterung (~97 % Recall) |
-| **Auto-Erfassung** — | Regelbasierte Muster | + LLM extrahiert Entscheidungen & Erkenntnisse |
-| **Komprimierung** | Nicht verfügbar | `consolidate` komprimiert ausführliche Erinnerungen |
-| **Kosten** | Kostenlos, kein API-Schlüssel | ~0,0001 $ pro Suche (Haiku) |
+| **Search** | FTS5-Keyword-Matching | + LLM Query-Erweiterung (~97 % Recall) |
+| **Auto-Capture** | Regelbasierte Muster | + LLM extrahiert Entscheidungen & Lektionen |
+| **Kompression** | Nicht verfügbar | `consolidate` komprimiert ausschweifende Memories |
+| **Kosten** | Kostenlos, kein API-Schlüssel | ~$0,0001 pro Suche (Haiku) |
 
 ---
 
-## Alle 8 Gedächtnis-Tools
+## Alle 9 Memory-Tools
 
-| Tool | Funktion |
+| Tool | Was es tut |
 |------|-------------|
-| `remember` | Speichert Wissen mit Beobachtungen, Beziehungen und Tags |
-| `recall` | Intelligente Suche mit Multi-Faktor-Scoring und LLM-Anfrageerweiterung |
-| `forget` | Soft-Archivierung (kein Löschen) oder Entfernen spezifischer Beobachtungen |
-| `consolidate` | LLM-gestützte Komprimierung ausführlicher Erinnerungen |
-| `export` | Teilt Erinnerungen als JSON zwischen Projekten oder Teammitgliedern |
-| `import` | Importiert Erinnerungen mit Zusammenführungsstrategien (überspringen / überschreiben / anhängen) |
-| `learn` | Strukturierte Lektionen aus Fehlern aufzeichnen (Fehler, Ursache, Fix, Prävention) |
-| `user_patterns` | Analysiere deine Arbeitsmuster — Zeitplan, Tools, Stärken, Lernbereiche |
+| `remember` | Wissen mit Beobachtungen, Relationen und Tags speichern |
+| `recall` | Intelligente Suche mit Multi-Faktor-Bewertung und LLM Query-Erweiterung |
+| `forget` | Soft-Archivierung (löscht nie) oder entfernt spezifische Beobachtungen |
+| `consolidate` | LLM-gestützte Kompression ausschweifender Memories |
+| `export` | Memories als JSON zwischen Projekten oder Teamkollegen teilen |
+| `import` | Memories mit Merge-Strategien importieren (Skip / Overwrite / Append) |
+| `learn` | Strukturierte Lektionen aus Fehlern erfassen (Fehler, Grundursache, Behebung, Prävention) |
+| `user_patterns` | Arbeitsmuster analysieren — Zeitplan, Tools, Stärken, Lernbereiche |
+| `verify_agent_work` | Verifizierungsbericht für Hintergrund-Agent-Arbeit speichern; Reality-Check gegen behauptete Dateiänderungen via `git diff` |
 
 ---
 
@@ -234,16 +262,17 @@ memesh  # öffnet Dashboard → Einstellungs-Tab
                     (~/.memesh/knowledge-graph.db)
 ```
 
-Der Kern ist framework-unabhängig. Dieselbe Logik läuft vom Terminal, HTTP oder MCP aus.
+Der Kern ist Framework-agnostisch. Dieselbe Logik läuft vom Terminal, HTTP oder MCP.
 
 ---
 
-## Mitwirken
+## Beitragen
 
 ```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
 ```
 
 Dashboard: `cd dashboard && npm install && npm run dev`