@pcircle/memesh 3.2.0 → 4.0.0

package/README.de.md

@@ -11,7 +11,6 @@
     <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>
-    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
   </p>
 </p>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — verstehe das Wissen deiner KI" 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%" />
+</p>
+
 ---
 
 ## Für Wen ist Das?
@@ -122,7 +125,7 @@ Tools in jeden API-Aufruf einfügen
 | **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 (5 Tabs) | Keins | Keins |
+| **Dashboard** | Integriert (7 Tabs + Analytik) | Keins | Keins |
 | **Abhängigkeiten** | 6 | 20+ | 10+ |
 | **Preis** | Dauerhaft kostenlos | Kostenlose Stufe / Kostenpflichtig | Kostenlose Stufe / Kostenpflichtig |
 
@@ -136,15 +139,31 @@ Du musst nicht alles manuell merken. MeMesh hat **4 Hooks**, die Wissen erfassen
 
 | Wann | Was MeMesh tut |
 |------|------------------|
-| **Zu Beginn jeder Session** | Lädt deine relevantesten Erinnerungen (nach Scoring-Algorithmus gerankt) |
+| **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 getroffene Entscheidungen |
+| **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 |
 
 > **Jederzeit deaktivierbar:** `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.
+
+| 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) |
+| **Manage** | Entitäten archivieren und wiederherstellen |
+| **Settings** | LLM-Anbieter-Konfiguration, Sprachauswahl |
+
+---
+
 ## Intelligente Funktionen
 
 **🧠 Smart Search** — Suche nach „login security" und finde Erinnerungen über „OAuth PKCE". MeMesh erweitert Suchanfragen mit verwandten Begriffen über das konfigurierte LLM.
@@ -183,7 +202,7 @@ memesh  # öffnet Dashboard → Einstellungs-Tab
 
 ---
 
-## Alle 6 Gedächtnis-Tools
+## Alle 8 Gedächtnis-Tools
 
 | Tool | Funktion |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # öffnet Dashboard → Einstellungs-Tab
 | `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 |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # öffnet Dashboard → Einstellungs-Tab
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ Der Kern ist framework-unabhängig. Dieselbe Logik läuft vom Terminal, HTTP ode
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
 cd memesh-llm-memory && npm install && npm run build
-npm test -- --run    # 289 tests
+npm test -- --run    # 413 tests
 ```
 
 Dashboard: `cd dashboard && npm install && npm run dev`

package/README.es.md

@@ -11,7 +11,6 @@
     <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>
-    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
   </p>
 </p>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — comprende el conocimiento de tu IA" 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?
@@ -122,7 +125,7 @@ Pega las herramientas en cualquier llamada a la API
 | **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 (5 pestañas) | Ninguno | Ninguno |
+| **Panel** | Integrado (7 pestañas + analytics) | Ninguno | Ninguno |
 | **Dependencias** | 6 | 20+ | 10+ |
 | **Precio** | Gratis para siempre | Plan gratuito / De pago | Plan gratuito / De pago |
 
@@ -136,15 +139,31 @@ No necesitas recordar todo manualmente. MeMesh tiene **4 hooks** que capturan co
 
 | Cuándo | Qué hace MeMesh |
 |------|------------------|
-| **Al inicio de cada sesión** | Carga tus recuerdos más relevantes (clasificados por algoritmo de puntuación) |
+| **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 |
-| **Cuando Claude se detiene** | Captura archivos editados, errores corregidos y decisiones tomadas |
+| **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 |
 
 > **Desactívalo cuando quieras:** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## Panel de Control
+
+7 pestañas, 11 idiomas, cero dependencias externas. Accede en `http://localhost:3737/dashboard` cuando el servidor esté activo.
+
+| 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 |
+| **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 |
+
+---
+
 ## Funcionalidades 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.
@@ -183,7 +202,7 @@ memesh  # abre el panel → pestaña Configuración
 
 ---
 
-## Las 6 Herramientas de Memoria
+## Las 8 Herramientas de Memoria
 
 | Herramienta | Qué hace |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # abre el panel → pestaña Configuración
 | `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 |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # abre el panel → pestaña Configuración
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ 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    # 289 tests
+npm test -- --run    # 413 tests
 ```
 
 Panel: `cd dashboard && npm install && npm run dev`

package/README.fr.md

@@ -11,7 +11,6 @@
     <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>
-    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
   </p>
 </p>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — visualisez les connaissances de votre IA" width="100%" />
 </p>
 
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — graphe de connaissances interactif avec filtres de type et mode ego" width="100%" />
+</p>
+
 ---
 
 ## Pour Qui Est-ce Fait ?
@@ -122,7 +125,7 @@ Collez les outils dans n'importe quel appel API
 | **Configuration** | `npm i -g` — terminé | Neo4j + VectorDB + clés API | Neo4j + config |
 | **Stockage** | Fichier SQLite unique | Neo4j + Qdrant | Neo4j |
 | **Fonctionne hors ligne** | Oui, toujours | Non | Non |
-| **Tableau de bord** | Intégré (5 onglets) | Aucun | Aucun |
+| **Tableau de bord** | Intégré (7 onglets + analytiques) | Aucun | Aucun |
 | **Dépendances** | 6 | 20+ | 10+ |
 | **Prix** | Gratuit à vie | Offre gratuite / Payant | Offre gratuite / Payant |
 
@@ -136,15 +139,31 @@ Inutile de tout mémoriser manuellement. MeMesh dispose de **4 hooks** qui captu
 
 | Quand | Ce que fait MeMesh |
 |------|------------------|
-| **Au démarrage de chaque session** | Charge vos souvenirs les plus pertinents (classés par algorithme de scoring) |
+| **Au démarrage de chaque session** | Charge vos souvenirs les plus pertinents + avertissements proactifs des leçons passées |
 | **Après chaque `git commit`** | Enregistre ce que vous avez modifié, avec les statistiques de diff |
-| **Quand Claude s'arrête** | Capture les fichiers édités, les erreurs corrigées et les décisions prises |
+| **Quand Claude s'arrête** | Capture les fichiers édités, les erreurs corrigées et génère automatiquement des leçons structurées à partir des échecs |
 | **Avant la compaction du contexte** | Sauvegarde les connaissances avant qu'elles se perdent dans les limites du contexte |
 
 > **Désactivez à tout moment :** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## Tableau de Bord
+
+7 onglets, 11 langues, zéro dépendance externe. Accessible à `http://localhost:3737/dashboard` lorsque le serveur tourne.
+
+| Onglet | Ce que vous voyez |
+|--------|-------------------|
+| **Search** | Recherche plein texte + similarité vectorielle sur tous les souvenirs |
+| **Browse** | Liste paginée de toutes les entités avec archivage/restauration |
+| **Analytics** | Score de Santé Mémoire (0-100), timeline 30 jours, métriques de valeur, couverture des connaissances, suggestions de nettoyage, vos habitudes de travail |
+| **Graph** | Graphe de connaissances interactif dirigé par forces avec filtres de type, recherche, mode ego, carte thermique de récence |
+| **Lessons** | Leçons structurées tirées des échecs passés (erreur, cause racine, correction, prévention) |
+| **Manage** | Archiver et restaurer des entités |
+| **Settings** | Configuration du fournisseur LLM, sélecteur de langue |
+
+---
+
 ## Fonctionnalités Intelligentes
 
 **🧠 Recherche Intelligente** — Cherchez « login security » et trouvez des souvenirs sur « OAuth PKCE ». MeMesh élargit les requêtes avec des termes connexes via le LLM configuré.
@@ -183,7 +202,7 @@ memesh  # ouvre le tableau de bord → onglet Paramètres
 
 ---
 
-## Les 6 Outils Mémoire
+## Les 8 Outils Mémoire
 
 | Outil | Ce qu'il fait |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # ouvre le tableau de bord → onglet Paramètres
 | `consolidate` | Compression de souvenirs verbeux assistée par LLM |
 | `export` | Partage les souvenirs en JSON entre projets ou membres d'équipe |
 | `import` | Importe des souvenirs avec des stratégies de fusion (ignorer / écraser / ajouter) |
+| `learn` | Enregistre des leçons structurées à partir des erreurs (erreur, cause racine, correction, prévention) |
+| `user_patterns` | Analyse vos habitudes de travail — planning, outils, points forts, axes d'apprentissage |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # ouvre le tableau de bord → onglet Paramètres
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ Le cœur est indépendant du framework. La même logique s'exécute depuis le te
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
 cd memesh-llm-memory && npm install && npm run build
-npm test -- --run    # 289 tests
+npm test -- --run    # 413 tests
 ```
 
 Tableau de bord : `cd dashboard && npm install && npm run dev`

package/README.ja.md

@@ -11,7 +11,6 @@
     <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>
-    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
   </p>
 </p>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — AI の知識を可視化" width="100%" />
 </p>
 
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — タイプフィルターとエゴモード付きインタラクティブ知識グラフ" width="100%" />
+</p>
+
 ---
 
 ## 誰のためのツールか？
@@ -122,7 +125,7 @@ memesh export-schema \
 | **設定方法** | `npm i-g` — 完了 | Neo4j + VectorDB + API キー | Neo4j + 設定 |
 | **ストレージ** | SQLite ファイル 1 つ | Neo4j + Qdrant | Neo4j |
 | **オフライン利用** | 常時対応 | 非対応 | 非対応 |
-| **ダッシュボード** | 組み込み（5 タブ） | なし | なし |
+| **ダッシュボード** | 組み込み（7 タブ + アナリティクス） | なし | なし |
 | **依存関係** | 6 | 20+ | 10+ |
 | **価格** | 永久無料 | 無料枠 / 有料 | 無料枠 / 有料 |
 
@@ -136,15 +139,31 @@ memesh export-schema \
 
 | タイミング | MeMesh が行うこと |
 |------|------------------|
-| **セッション開始時** | スコアリングアルゴリズムで最も関連性の高いメモリを読み込む |
+| **セッション開始時** | 最も関連性の高いメモリを読み込み + 過去の教訓からのプロアクティブな警告 |
 | **`git commit` 後** | 変更内容と差分統計を記録する |
-| **Claude 終了時** | 編集したファイル・修正したエラー・下した決断をキャプチャする |
+| **Claude 終了時** | 編集したファイル・修正したエラーをキャプチャし、失敗から構造化された教訓を自動生成 |
 | **コンテキスト圧縮前** | コンテキスト上限で失われる前に知識を保存する |
 
 > **いつでも無効化：** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## ダッシュボード
+
+7 タブ、11 言語、外部依存ゼロ。サーバー起動中は `http://localhost:3737/dashboard` でアクセス。
+
+| タブ | 内容 |
+|------|------|
+| **Search** | すべてのメモリに対する全文検索 + ベクトル類似度検索 |
+| **Browse** | すべてのエンティティのページネーション一覧（アーカイブ/復元対応） |
+| **Analytics** | メモリヘルススコア（0-100）、30日タイムライン、価値指標、知識カバレッジ、クリーンアップ提案、作業パターン |
+| **Graph** | タイプフィルター、検索、エゴモード、最新性ヒートマップ付きインタラクティブ力学グラフ |
+| **Lessons** | 過去の失敗から生成された構造化レッスン（エラー、根本原因、修正方法、予防策） |
+| **Manage** | エンティティのアーカイブと復元 |
+| **Settings** | LLM プロバイダー設定、言語セレクター |
+
+---
+
 ## スマート機能
 
 **🧠 スマート検索** — 「login security」で「OAuth PKCE」に関するメモリが見つかります。設定した LLM を使ってクエリを関連語に展開します。
@@ -183,7 +202,7 @@ memesh  # ダッシュボードを開く → 設定タブ
 
 ---
 
-## 全 6 つのメモリツール
+## 全 8 つのメモリツール
 
 | ツール | 機能 |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # ダッシュボードを開く → 設定タブ
 | `consolidate` | LLM を使って冗長なメモリを圧縮 |
 | `export` | メモリを JSON でプロジェクトやチームメンバーと共有 |
 | `import` | マージ戦略（スキップ / 上書き / 追加）を選んでメモリをインポート |
+| `learn` | ミスから構造化されたレッスンを記録（エラー、根本原因、修正方法、予防策） |
+| `user_patterns` | 作業パターンを分析 — スケジュール、ツール、強み、学習分野 |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # ダッシュボードを開く → 設定タブ
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ memesh  # ダッシュボードを開く → 設定タブ
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
 cd memesh-llm-memory && npm install && npm run build
-npm test -- --run    # 289 tests
+npm test -- --run    # 413 tests
 ```
 
 ダッシュボード：`cd dashboard && npm install && npm run dev`

package/README.ko.md

@@ -11,7 +11,6 @@
     <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>
-    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
   </p>
 </p>
 
@@ -62,6 +61,10 @@ memesh
   <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — AI의 지식을 한눈에 파악" width="100%" />
 </p>
 
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — 타입 필터와 에고 모드가 있는 인터랙티브 지식 그래프" width="100%" />
+</p>
+
 ---
 
 ## 누구를 위한 도구인가?
@@ -122,7 +125,7 @@ memesh export-schema \
 | **설정 방법** | `npm i -g` — 완료 | Neo4j + VectorDB + API 키 | Neo4j + 설정 |
 | **저장소** | SQLite 파일 하나 | Neo4j + Qdrant | Neo4j |
 | **오프라인 사용** | 항상 가능 | 불가 | 불가 |
-| **대시보드** | 내장 (5개 탭) | 없음 | 없음 |
+| **대시보드** | 내장 (7개 탭 + 분석) | 없음 | 없음 |
 | **의존성** | 6개 | 20개 이상 | 10개 이상 |
 | **가격** | 영구 무료 | 무료 티어 / 유료 | 무료 티어 / 유료 |
 
@@ -136,15 +139,31 @@ memesh export-schema \
 
 | 언제 | MeMesh가 하는 일 |
 |------|------------------|
-| **모든 세션 시작 시** | 스코어링 알고리즘으로 가장 관련성 높은 메모리를 로드 |
+| **모든 세션 시작 시** | 가장 관련성 높은 메모리를 로드 + 과거 교훈으로부터의 사전 경고 |
 | **모든 `git commit` 후** | 변경 내용과 diff 통계를 기록 |
-| **Claude 종료 시** | 편집한 파일, 수정한 오류, 내린 결정을 포착 |
+| **Claude 종료 시** | 편집한 파일, 수정한 오류를 포착하고 실패로부터 구조화된 교훈을 자동 생성 |
 | **컨텍스트 압축 전** | 컨텍스트 한계로 사라지기 전에 지식을 저장 |
 
 > **언제든 비활성화:** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## 대시보드
+
+7개 탭, 11개 언어, 외부 의존성 제로. 서버 실행 중 `http://localhost:3737/dashboard`에서 접근.
+
+| 탭 | 내용 |
+|----|------|
+| **Search** | 모든 메모리에 대한 전문 검색 + 벡터 유사도 검색 |
+| **Browse** | 모든 엔티티의 페이지네이션 목록 (아카이브/복원 지원) |
+| **Analytics** | 메모리 건강 점수 (0-100), 30일 타임라인, 가치 지표, 지식 커버리지, 정리 제안, 작업 패턴 |
+| **Graph** | 타입 필터, 검색, 에고 모드, 최신성 히트맵이 있는 인터랙티브 포스 그래프 |
+| **Lessons** | 과거 실패로부터 생성된 구조화된 교훈 (오류, 근본 원인, 수정, 예방) |
+| **Manage** | 엔티티 아카이브 및 복원 |
+| **Settings** | LLM 제공자 설정, 언어 선택 |
+
+---
+
 ## 스마트 기능
 
 **🧠 스마트 검색** — "login security"를 검색하면 "OAuth PKCE"에 관한 메모리를 찾아냅니다. 설정한 LLM을 이용해 쿼리를 관련 용어로 확장합니다.
@@ -183,7 +202,7 @@ memesh  # 대시보드 열기 → 설정 탭
 
 ---
 
-## 전체 6가지 메모리 도구
+## 전체 8가지 메모리 도구
 
 | 도구 | 기능 |
 |------|-------------|
@@ -193,6 +212,8 @@ memesh  # 대시보드 열기 → 설정 탭
 | `consolidate` | LLM 기반 장황한 메모리 압축 |
 | `export` | 메모리를 JSON으로 프로젝트 또는 팀원과 공유 |
 | `import` | 병합 전략(건너뛰기 / 덮어쓰기 / 추가)을 선택해 메모리 가져오기 |
+| `learn` | 실수로부터 구조화된 교훈 기록 (오류, 근본 원인, 수정, 예방) |
+| `user_patterns` | 작업 패턴 분석 — 일정, 도구, 강점, 학습 영역 |
 
 ---
 
@@ -201,7 +222,7 @@ memesh  # 대시보드 열기 → 설정 탭
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +243,7 @@ memesh  # 대시보드 열기 → 설정 탭
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
 cd memesh-llm-memory && npm install && npm run build
-npm test -- --run    # 289 tests
+npm test -- --run    # 413 tests
 ```
 
 대시보드: `cd dashboard && npm install && npm run dev`

package/README.md

@@ -11,7 +11,6 @@
     <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>
-    <a href="https://pypi.org/project/memesh/"><img src="https://img.shields.io/badge/pip-memesh-3b82f6?style=flat-square" alt="PyPI" /></a>
   </p>
 </p>
 
@@ -59,7 +58,11 @@ memesh
 </p>
 
 <p align="center">
-  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — understand your AI's knowledge" 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 — interactive knowledge graph with type filters and ego mode" width="100%" />
 </p>
 
 ---
@@ -90,13 +93,12 @@ MCP protocol (auto-configured)
 </td>
 <td width="33%" align="center">
 
-**Python / LangChain**
-```python
-from memesh import MeMesh
-m = MeMesh()
-m.recall("auth")
+**Any HTTP Client**
+```bash
+curl localhost:3737/v1/recall \
+  -d '{"query":"auth"}'
 ```
-`pip install memesh`
+`memesh serve` (REST API)
 
 </td>
 <td width="33%" align="center">
@@ -122,7 +124,7 @@ Paste tools into any API call
 | **Setup** | `npm i -g` — done | Neo4j + VectorDB + API keys | Neo4j + config |
 | **Storage** | Single SQLite file | Neo4j + Qdrant | Neo4j |
 | **Works offline** | Yes, always | No | No |
-| **Dashboard** | Built-in (5 tabs) | None | None |
+| **Dashboard** | Built-in (7 tabs + analytics) | None | None |
 | **Dependencies** | 6 | 20+ | 10+ |
 | **Price** | Free forever | Free tier / Paid | Free tier / Paid |
 
@@ -136,15 +138,31 @@ You don't need to manually remember everything. MeMesh has **4 hooks** that capt
 
 | When | What MeMesh does |
 |------|------------------|
-| **Every session start** | Loads your most relevant memories (ranked by scoring algorithm) |
+| **Every session start** | Loads your most relevant memories + proactive warnings from past lessons |
 | **After every `git commit`** | Records what you changed, with diff stats |
-| **When Claude stops** | Captures files edited, errors fixed, and decisions made |
+| **When Claude stops** | Captures files edited, errors fixed, and auto-generates structured lessons from failures |
 | **Before context compaction** | Saves knowledge before it's lost to context limits |
 
 > **Opt out anytime:** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
+## Dashboard
+
+7 tabs, 11 languages, zero external dependencies. Access at `http://localhost:3737/dashboard` when the server is running.
+
+| Tab | What you see |
+|-----|-------------|
+| **Search** | Full-text + vector similarity search across all memories |
+| **Browse** | Paginated list of all entities with archive/restore |
+| **Analytics** | Memory Health Score (0-100), 30-day timeline, value metrics, knowledge coverage, cleanup suggestions, your work patterns |
+| **Graph** | Interactive force-directed knowledge graph with type filters, search, ego mode, recency heatmap |
+| **Lessons** | Structured lessons from past failures (error, root cause, fix, prevention) |
+| **Manage** | Archive and restore entities |
+| **Settings** | LLM provider config, language selector |
+
+---
+
 ## Smart Features
 
 **🧠 Smart Search** — Search "login security" and find memories about "OAuth PKCE". MeMesh expands queries with related terms using your configured LLM.
@@ -159,6 +177,19 @@ You don't need to manually remember everything. MeMesh has **4 hooks** that capt
 
 ---
 
+## Real-World Usage
+
+> "MeMesh remembered that we chose PKCE over implicit flow three weeks ago. When I asked Claude about auth again, it already knew — no re-explaining needed."
+> — **Solo developer, building a SaaS**
+
+> "We export our team's memory every Friday and import it Monday. Everyone's Claude starts the week knowing what the team learned last week."
+> — **3-person startup, shared knowledge base**
+
+> "The dashboard showed me that 90% of my memories were auto-generated session logs. I started using `remember` deliberately for architecture decisions. Game changer."
+> — **Developer who discovered the Analytics tab**
+
+---
+
 ## Unlock Smart Mode (Optional)
 
 MeMesh works fully offline out of the box. Add an LLM API key to unlock smarter search:
@@ -183,7 +214,7 @@ memesh  # opens dashboard → Settings tab
 
 ---
 
-## All 6 Memory Tools
+## All 8 Memory Tools
 
 | Tool | What it does |
 |------|-------------|
@@ -193,6 +224,8 @@ memesh  # opens dashboard → Settings tab
 | `consolidate` | LLM-powered compression of verbose memories |
 | `export` | Share memories as JSON between projects or team members |
 | `import` | Import memories with merge strategies (skip / overwrite / append) |
+| `learn` | Record structured lessons from mistakes (error, root cause, fix, prevention) |
+| `user_patterns` | Analyze your work patterns — schedule, tools, strengths, learning areas |
 
 ---
 
@@ -201,7 +234,7 @@ memesh  # opens dashboard → Settings tab
 ```
                     ┌─────────────────┐
                     │   Core Engine   │
-                    │  (6 operations) │
+                    │  (8 operations) │
                     └────────┬────────┘
            ┌─────────────────┼─────────────────┐
            │                 │                 │
@@ -222,7 +255,7 @@ Core is framework-agnostic. Same logic runs from terminal, HTTP, or MCP.
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
 cd memesh-llm-memory && npm install && npm run build
-npm test -- --run    # 289 tests
+npm test -- --run    # 413 tests
 ```
 
 Dashboard: `cd dashboard && npm install && npm run dev`