Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
54 commits
Select commit Hold shift + click to select a range
aa9423b
fix(serializer): overwrite import now clears old data before re-popul…
kevintseng Apr 18, 2026
2c4c527
fix(serializer): apply namespace filter at query level, not post-filter
kevintseng Apr 18, 2026
7cbc6c0
feat(core): add neural embedding module (@xenova/transformers, 384-dim)
kevintseng Apr 18, 2026
33e631d
feat(core): integrate neural embeddings into remember and recall
kevintseng Apr 18, 2026
89b58c3
feat(dashboard): add Graph and Lessons tabs with i18n support
kevintseng Apr 18, 2026
a272465
feat: v3.2.0 — neural embeddings, data integrity fixes, dashboard Gra…
kevintseng Apr 18, 2026
bd7e0e4
Merge branch 'main' into develop
kevintseng Apr 18, 2026
1117d0d
feat(dashboard): implement Precision Engineer design system
kevintseng Apr 18, 2026
d3576df
feat(dashboard): add feedback widget with i18n + restore interaction …
kevintseng Apr 18, 2026
40120da
style(design): fix touch targets and search empty state
kevintseng Apr 18, 2026
cbbf42c
feat(api): add /v1/analytics endpoint with health score, timeline, va…
kevintseng Apr 18, 2026
50cfbc4
feat(dashboard): add AnalyticsData type for /v1/analytics endpoint
kevintseng Apr 18, 2026
faf8dae
feat(dashboard): add HealthScore component with factor bars
kevintseng Apr 18, 2026
91b3ddf
feat(dashboard): add ValueMetrics component with coverage bars
kevintseng Apr 18, 2026
e30ebce
feat(dashboard): add CleanupSuggestions component with archive actions
kevintseng Apr 18, 2026
45efb65
feat(dashboard): add MemoryTimeline canvas sparkline component
kevintseng Apr 18, 2026
9c4be09
feat(dashboard): rewrite AnalyticsTab with insights + add i18n for al…
kevintseng Apr 18, 2026
c37af66
test(analytics): add tests for health score, stale detection, timelin…
kevintseng Apr 18, 2026
12457c9
docs: add /v1/analytics endpoint to architecture and API reference
kevintseng Apr 18, 2026
170c136
fix(dashboard): align frontend types with actual /v1/analytics response
kevintseng Apr 18, 2026
157b933
fix(dashboard): use correct i18n key for lessons applied label
kevintseng Apr 18, 2026
05d3784
feat(dashboard): rewrite GraphTab with type filter, search, ego graph…
kevintseng Apr 18, 2026
1c29d06
fix(dashboard): fix GraphTab blank canvas race condition
kevintseng Apr 18, 2026
1f61bac
fix(dashboard): add cooling to force simulation — graph settles after…
kevintseng Apr 18, 2026
3de124c
fix: address code review findings — staleEntities SQL + type safety
kevintseng Apr 18, 2026
0c02013
fix: eliminate all `as any` type casts in dashboard
kevintseng Apr 18, 2026
aac394b
fix: address Codex review findings — datetime, hit-testing, coverage
kevintseng Apr 18, 2026
4e31323
chore: add PRE_RELEASE_CHECKLIST.md to .gitignore
kevintseng Apr 19, 2026
2f2730c
Merge branch 'main' into develop
kevintseng Apr 19, 2026
15670fe
feat(api): add /v1/patterns endpoint for user work pattern analysis
kevintseng Apr 19, 2026
be3e2d1
feat(dashboard): add Your Patterns section to Analytics with i18n
kevintseng Apr 19, 2026
684d1a1
feat: add user patterns analysis — MCP tool + dashboard + API
kevintseng Apr 19, 2026
16d29ae
docs: add user_patterns tool and /v1/patterns endpoint (8 MCP tools, …
kevintseng Apr 19, 2026
55b29bb
fix: extract shared patterns computation, fix error handling, add tests
kevintseng Apr 19, 2026
1c02b66
fix: address Codex review — session types, AUTO_TYPES, localtime
kevintseng Apr 19, 2026
ca5c6d9
fix(security): parameterize SQL, add security headers, update vulnera…
kevintseng Apr 19, 2026
cacd375
Merge branch 'main' into develop
kevintseng Apr 19, 2026
4a2ffc1
docs: update README with v3.2.x features, new screenshots, 8 tools
kevintseng Apr 19, 2026
5432d7e
docs: add CHANGELOG, remove PyPI badge, add user stories
kevintseng Apr 19, 2026
47b1e7f
docs: add static demo page for GitHub Pages
kevintseng Apr 19, 2026
d3ccc68
docs: update all 10 translated READMEs to match v3.2.x features
kevintseng Apr 19, 2026
d33222e
docs(skills): update both skills for v3.2.x — 8 tools, proactive trig…
kevintseng Apr 19, 2026
ddf0e71
docs: add v4.0 AI-native improvements plan skeleton
kevintseng Apr 19, 2026
b25c12f
docs(skills): CLI-first rewrite with hooks documentation
kevintseng Apr 19, 2026
cccd094
feat(v4): recall effectiveness tracking — measure if injected memorie…
kevintseng Apr 19, 2026
e3b8d27
feat(v4): noise filter — auto-compress old session_keypoint/commit in…
kevintseng Apr 19, 2026
1fa721a
fix(dashboard): add i18n for RecallEffectiveness component — 11 locales
kevintseng Apr 19, 2026
17dd77b
feat(v4): auto-tagging — LLM generates tags when user provides none
kevintseng Apr 19, 2026
3df6d6e
feat(v4): continuous recall — PreToolUse hook injects memories when e…
kevintseng Apr 19, 2026
8c9d609
feat(v4): BYOK embedding + impact scoring
kevintseng Apr 19, 2026
11a6a90
refactor: break circular dependency between db.ts and embedder.ts
kevintseng Apr 19, 2026
f29aecd
chore: bump version to 4.0.0
kevintseng Apr 19, 2026
cb7fb16
docs: add v4 adversarial review findings for fix session
kevintseng Apr 19, 2026
bf18fda
fix(v4): address 12 adversarial review findings
kevintseng Apr 19, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
560 changes: 87 additions & 473 deletions CHANGELOG.md

Large diffs are not rendered by default.

35 changes: 28 additions & 7 deletions README.de.md
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down Expand Up @@ -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?
Expand Down Expand Up @@ -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 |

Expand All @@ -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.
Expand Down Expand Up @@ -183,7 +202,7 @@ memesh # öffnet Dashboard → Einstellungs-Tab

---

## Alle 6 Gedächtnis-Tools
## Alle 8 Gedächtnis-Tools

| Tool | Funktion |
|------|-------------|
Expand All @@ -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 |

---

Expand All @@ -201,7 +222,7 @@ memesh # öffnet Dashboard → Einstellungs-Tab
```
┌─────────────────┐
│ Core Engine │
│ (6 operations) │
│ (8 operations) │
└────────┬────────┘
┌─────────────────┼─────────────────┐
│ │ │
Expand All @@ -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`
Expand Down
35 changes: 28 additions & 7 deletions README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down Expand Up @@ -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?
Expand Down Expand Up @@ -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 |

Expand All @@ -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.
Expand Down Expand Up @@ -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 |
|------|-------------|
Expand All @@ -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 |

---

Expand All @@ -201,7 +222,7 @@ memesh # abre el panel → pestaña Configuración
```
┌─────────────────┐
│ Core Engine │
│ (6 operations) │
│ (8 operations) │
└────────┬────────┘
┌─────────────────┼─────────────────┐
│ │ │
Expand All @@ -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`
Expand Down
35 changes: 28 additions & 7 deletions README.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down Expand Up @@ -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 ?
Expand Down Expand Up @@ -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 |

Expand All @@ -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é.
Expand Down Expand Up @@ -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 |
|------|-------------|
Expand All @@ -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 |

---

Expand All @@ -201,7 +222,7 @@ memesh # ouvre le tableau de bord → onglet Paramètres
```
┌─────────────────┐
│ Core Engine │
│ (6 operations) │
│ (8 operations) │
└────────┬────────┘
┌─────────────────┼─────────────────┐
│ │ │
Expand All @@ -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`
Expand Down
Loading
Loading