@pcircle/memesh 4.0.2 → 4.1.0

package/README.fr.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>La couche mémoire IA universelle la plus légère.</strong><br />
-    Un seul fichier SQLite. N'importe quel LLM. Zéro cloud.
+    <strong>Mémoire locale pour Claude Code et les agents de codage MCP.</strong><br />
+    Un fichier SQLite. Aucun Docker. Aucun cloud requis.
   </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,35 +21,43 @@
 
 ## Le Problème
 
-Votre IA oublie tout entre les sessions. Chaque décision, chaque correction de bug, chaque leçon apprise — effacées. Vous réexpliquez le même contexte en boucle, Claude redécouvre les mêmes patterns, et les connaissances IA de votre équipe repartent à zéro à chaque fois.
+Votre agent de codage oublie ce qui s'est passé d'une session à l'autre. Chaque décision architecturale, correction de bug, test échoué et leçon apprise difficilement doit être réexpliquée. Claude Code redémarre à zéro, redécouvre les anciennes contraintes et gaspille du contexte sur des éléments qu'il devrait déjà connaître.
+
+**MeMesh offre aux agents de codage une mémoire locale persistante, consultable et évolutive.**
 
-**MeMesh donne à chaque IA une mémoire persistante, consultable et en constante évolution.**
+Ce package constitue la couche de mémoire locale de la famille de produits MeMesh. Il est volontairement léger et open-source : installez-le avec npm, conservez votre mémoire dans `~/.memesh/knowledge-graph.db` et connectez-le à Claude Code ou à tout client compatible MCP. Les produits d'espace de travail hébergé et les systèmes d'exploitation d'entreprise doivent rester distincts de ce README et de la feuille de route du package.
 
 ---
 
-## Démarrez en 60 Secondes
+## Démarrer en 60 Secondes
 
-### Étape 1 : Installez
+### Étape 1 : Installer
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-### Étape 2 : Votre IA se souvient
+### Étape 2 : Mémoriser une décision
 
 ```bash
 memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
 ```
 
-### Étape 3 : Votre IA retrouve
+### Étape 3 : La rappeler plus tard
 
 ```bash
 memesh recall "login security"
-# → Trouve "OAuth 2.0 with PKCE" même avec des mots différents
+# → Trouve "OAuth 2.0 with PKCE" même si vous avez cherché des mots différents
 ```
 
 **C'est tout.** MeMesh mémorise et rappelle désormais d'une session à l'autre.
 
+Pour vérifier l'installation et la connexion locale de bout en bout :
+
+```bash
+memesh doctor
+```
+
 Ouvrez le tableau de bord pour explorer votre mémoire :
 
 ```bash
@@ -54,11 +65,11 @@ memesh
 ```
 
 <p align="center">
-  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — retrouvez n'importe quel souvenir instantanément" width="100%" />
+  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — trouve n'importe quelle mémoire instantanément" width="100%" />
 </p>
 
 <p align="center">
-  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — visualisez les connaissances de votre IA" width="100%" />
+  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — score de santé, frise chronologique, motifs, couverture des connaissances" width="100%" />
 </p>
 
 <p align="center">
@@ -67,18 +78,18 @@ memesh
 
 ---
 
-## Pour Qui Est-ce Fait ?
+## À Qui S'Adresse-T-Il ?
 
 | Si vous êtes... | MeMesh vous aide à... |
-|---------------|---------------------|
-| **Un développeur utilisant Claude Code** | Mémoriser décisions, patterns et leçons entre sessions automatiquement |
-| **Une équipe qui construit avec des LLMs** | Partager les connaissances de l'équipe via export/import, garder le contexte IA de tous aligné |
-| **Un développeur d'agents IA** | Donner à vos agents une mémoire persistante via MCP, HTTP API ou Python SDK |
-| **Un utilisateur avancé avec plusieurs outils IA** | Une couche mémoire qui fonctionne avec Claude, GPT, LLaMA, Ollama ou n'importe quel client MCP |
+|---|---|
+| **Un développeur utilisant Claude Code** | Rappeler automatiquement les décisions du projet, les leçons spécifiques aux fichiers et les échecs passés au fur et à mesure du travail |
+| **Un utilisateur avancé d'agent de codage** | Partager une couche de mémoire locale unique sur les outils compatibles MCP |
+| **Une équipe expérimentant les workflows de codage IA** | Exporter/importer les connaissances du projet sans infrastructure hébergée |
+| **Un développeur d'agent** | Ajouter la mémoire locale via MCP, HTTP, CLI ou le SDK Python |
 
 ---
 
-## Compatible avec Tout
+## Conçu d'Abord Pour Les Agents De Codage
 
 <table>
 <tr>
@@ -88,23 +99,23 @@ memesh
 ```bash
 memesh-mcp
 ```
-Protocole MCP (configuré automatiquement)
+Outils MCP + hooks Claude Code
 
 </td>
 <td width="33%" align="center">
 
-**Python / LangChain**
-```python
-from memesh import MeMesh
-m = MeMesh()
-m.recall("auth")
+**N'Importe Quel Client HTTP**
+```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">
 
-**N'importe quel LLM (format OpenAI)**
+**N'Importe Quel LLM (Format OpenAI)**
 ```bash
 memesh export-schema \
   --format openai
@@ -117,103 +128,120 @@ Collez les outils dans n'importe quel appel API
 
 ---
 
-## Pourquoi Pas Mem0 / Zep ?
+## Pourquoi Pas OpenMemory, Cursor Memories, Mem0 Ou Zep ?
 
-| | **MeMesh** | Mem0 | Zep |
-|---|---|---|---|
-| **Temps d'installation** | 5 secondes | 30–60 minutes | 30+ minutes |
-| **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é (7 onglets + analytiques) | Aucun | Aucun |
-| **Dépendances** | 6 | 20+ | 10+ |
-| **Prix** | Gratuit à vie | Offre gratuite / Payant | Offre gratuite / Payant |
+| | **MeMesh** | OpenMemory | Cursor Memories | Mem0 | Zep / Graphiti |
+|---|---|---|---|---|---|
+| **Meilleur usage** | Mémoire locale pour agents de codage | Mémoire MCP locale/multi-client | Mémoire de projet Cursor native | Mémoire d'app/agent gérée | Graphes de connaissances temporels |
+| **Installation** | `npm install -g @pcircle/memesh` | App/serveur local | Intégré à Cursor | API Cloud / SDK / MCP | Configuration service/framework |
+| **Stockage** | Un seul fichier SQLite local | Pile de mémoire locale | Règles/mémoires gérés par Cursor | Stack hébergée ou auto-hébergée | Base de données graphe |
+| **Cloud requis** | Non | Non pour le mode local | Dépend du compte/paramètres Cursor | Oui pour la plateforme | Généralement oui/auto-hébergée |
+| **Hooks Claude Code** | Première classe | Outils MCP | Non | Outils MCP | Pas spécifique à Claude Code |
+| **Tableau de bord** | Intégré | Intégré | Paramètres Cursor | Tableau de bord plateforme | Outils plateforme/graphe |
+| **Tradeoff** | Coin simple et local, non adapté à l'échelle entreprise | Empreinte app locale plus large | Verrouillé à Cursor | Plateforme gérée puissante, moins local-first | Modèle graphe puissant, configuration plus lourde |
 
-**MeMesh échange :** les fonctionnalités multi-tenant enterprise contre **une installation instantanée, zéro infrastructure et 100 % de confidentialité**.
+**MeMesh sacrifie l'infrastructure gérée à l'échelle entreprise pour une installation locale instantanée, un stockage inspectable et des hooks de workflow spécifiques aux agents de codage.**
 
 ---
 
-## Ce qui Se Passe Automatiquement
+## Ce Qui Se Passe Automatiquement Dans Claude Code
 
-Inutile de tout mémoriser manuellement. MeMesh dispose de **4 hooks** qui capturent les connaissances sans que vous ayez à faire quoi que ce soit :
+Vous n'avez pas besoin de tout mémoriser manuellement. MeMesh possède **6 hooks** qui capturent et injectent les connaissances au fur et à mesure que vous travaillez :
 
-| Quand | Ce que fait MeMesh |
-|------|------------------|
-| **Au démarrage de chaque session** | Charge vos souvenirs les plus pertinents + avertissements proactifs des leçons passées |
+| Quand | Ce que MeMesh fait |
+|---|---|
+| **Au début de chaque session** | Charge vos mémoires les plus pertinentes + avertissements proactifs des leçons passées + banneau d'orchestration agentique |
+| **Avant d'éditer des fichiers** | Rappelle les mémoires liées au fichier ou au projet avant que Claude ne rédige du code |
+| **Avant les commandes bash** | Encourage Claude à dispatcher les commandes très vérifiables (test, build, lint, migrate, deploy, benchmark) en tant qu'agents de fond |
 | **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 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 |
+| **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 défaillances |
+| **Avant la compaction de contexte** | Sauvegarde les connaissances avant qu'elles ne soient perdues aux limites de contexte |
 
-> **Désactivez à tout moment :** `export MEMESH_AUTO_CAPTURE=false`
+> **Refuser à tout moment :** `export MEMESH_AUTO_CAPTURE=false`
 
 ---
 
-## Tableau de Bord
+## Tableau De Bord
 
-7 onglets, 11 langues, zéro dépendance externe. Accessible à `http://localhost:3737/dashboard` lorsque le serveur tourne.
+7 onglets, 11 langues, zéro dépendance externe. Accessible à `http://localhost:3737/dashboard` quand le serveur s'exécute.
 
 | 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 |
+|---|---|
+| **Recherche** | Recherche par texte intégral + similarité vectorielle sur toutes les mémoires |
+| **Parcourir** | Liste paginée de toutes les entités avec archivage/restauration |
+| **Analytics** | Score de santé de la mémoire (0–100), frise chronologique 30 jours, métriques de valeur, couverture des connaissances, suggestions de nettoyage, vos motifs de travail |
+| **Graphe** | Graphe de connaissances force-directed interactif avec filtres de type, recherche, mode ego, carte thermique de récence |
+| **Leçons** | Leçons structurées tirées des défaillances passées (erreur, cause racine, correctif, prévention) |
+| **Gérer** | Archivez et restaurez les entités |
+| **Paramètres** | Configuration du fournisseur LLM, sélecteur de langue instantané |
 
 ---
 
 ## 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é.
+**🧠 Recherche Intelligente** — Cherchez « sécurité login » et trouvez des mémoires sur « OAuth PKCE ». MeMesh enrichit les requêtes avec des termes connexes en utilisant votre LLM configuré.
+
+**📊 Classement Avec Score** — Les résultats sont classés par pertinence (30 %) + récence (25 %) + fréquence (15 %) + confiance (15 %) + impact de rappel (10 %) + validité temporelle (5 %).
+
+**🔄 Évolution Des Connaissances** — Les décisions changent. `forget` archive les anciennes mémoires (jamais supprimer). Les relations `supersedes` relient ancien → nouveau. Votre IA voit toujours la version la plus récente.
+
+**⚠️ Détection De Conflits** — Si vous avez deux mémoires qui se contredisent, MeMesh vous avertit.
+
+**📦 Partage D'Équipe** — `memesh export > team-knowledge.json` → partagez avec votre équipe → `memesh import team-knowledge.json`
+Les bundles importés restent consultables, mais MeMesh n'injecte pas automatiquement les mémoires importées dans les hooks Claude jusqu'à ce que vous les examiniez ou les rémémorisiez localement.
+
+---
 
-**📊 Classement par Score** — Résultats classés par pertinence (35 %) + date de dernière utilisation (25 %) + fréquence (20 %) + confiance (15 %) + si l'info est toujours d'actualité (5 %).
+## Exemple D'Utilisation
 
-**🔄 Évolution des Connaissances** — Les décisions changent. `forget` archive les anciens souvenirs (ne supprime jamais). Les relations `supersedes` relient l'ancien au nouveau. Votre IA voit toujours la dernière version.
+> « MeMesh s'est souvenu que nous avions choisi PKCE plutôt que le flux implicite il y a trois semaines. Quand j'ai demandé à Claude à nouveau sur l'auth, il le savait déjà — pas besoin de réexpliquer. »
+> — **Développeur seul, construisant une SaaS**
 
-**⚠️ Détection de Conflits** — Si deux souvenirs se contredisent, MeMesh vous avertit.
+> « Nous exportons la mémoire de notre équipe tous les vendredis et l'importons le lundi. Chaque Claude de l'équipe commence la semaine en sachant ce que l'équipe a appris la semaine précédente. »
+> — **Startup à 3 personnes, base de connaissances partagée**
 
-**📦 Partage en Équipe** — `memesh export > team-knowledge.json` → partagez avec votre équipe → `memesh import team-knowledge.json`
+> « Le tableau de bord m'a montré que 90 % de mes mémoires étaient des journaux de session auto-générés. J'ai commencé à utiliser `remember` délibérément pour les décisions architecturales. Un changement radical. »
+> — **Développeur qui a découvert l'onglet Analytics**
 
 ---
 
-## Activez le Mode Intelligent (Optionnel)
+## Déverrouiller Le Mode Smart (Optionnel)
 
-MeMesh fonctionne entièrement hors ligne par défaut. Ajoutez une clé API LLM pour débloquer une recherche plus intelligente :
+MeMesh fonctionne hors ligne par défaut. Ajoutez une clé API LLM uniquement si vous souhaitez l'expansion de requête, l'extraction plus intelligente et la compression :
 
 ```bash
 memesh config set llm.provider anthropic
 memesh config set llm.api-key sk-ant-...
 ```
 
-Ou utilisez l'onglet Paramètres du tableau de bord (configuration visuelle) :
+Ou utilisez l'onglet Settings du tableau de bord (configuration visuelle) :
 
 ```bash
-memesh  # ouvre le tableau de bord → onglet Paramètres
+memesh  # ouvre le tableau de bord → onglet Settings
 ```
 
-| | Niveau 0 (par défaut) | Niveau 1 (Mode Intelligent) |
+| | Niveau 0 (défaut) | Niveau 1 (Mode Smart) |
 |---|---|---|
-| **Recherche** | Correspondance de mots-clés FTS5 | + Expansion de requête par LLM (~97 % de rappel) |
-| **Capture automatique** | Patterns basés sur des règles | + LLM extrait décisions et leçons |
-| **Compression** | Non disponible | `consolidate` compresse les souvenirs verbeux |
-| **Coût** | Gratuit, sans clé API | ~0,0001 $ par recherche (Haiku) |
+| **Recherche** | Correspondance de mots-clés FTS5 | + expansion de requête LLM (~97 % de rappel) |
+| **Auto-capture** | Motifs basés sur les règles | + LLM extrait les décisions & leçons |
+| **Compression** | Non disponible | `consolidate` compresse les mémoires verbeux |
+| **Coût** | Gratuit, aucune clé API | ~$0.0001 par recherche (Haiku) |
 
 ---
 
-## Les 8 Outils Mémoire
+## Les 9 Outils De Mémoire
 
 | Outil | Ce qu'il fait |
-|------|-------------|
-| `remember` | Stocke les connaissances avec observations, relations et tags |
-| `recall` | Recherche intelligente avec scoring multi-facteurs et expansion de requête par LLM |
-| `forget` | Archivage doux (ne supprime jamais) ou suppression d'observations spécifiques |
-| `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 |
+|---|---|
+| `remember` | Stocker les connaissances avec observations, relations et tags |
+| `recall` | Recherche intelligente avec notation multi-facteurs et expansion de requête LLM |
+| `forget` | Soft-archivage (jamais supprimer) ou suppression d'observations spécifiques |
+| `consolidate` | Compression des mémoires verbeux alimentée par LLM |
+| `export` | Partager les mémoires au format JSON entre projets ou membres d'équipe |
+| `import` | Importer les mémoires avec stratégies de fusion (skip / overwrite / append) |
+| `learn` | Enregistrer les leçons structurées à partir des erreurs (erreur, cause racine, correctif, prévention) |
+| `user_patterns` | Analyser vos motifs de travail — planning, outils, forces, domaines d'apprentissage |
+| `verify_agent_work` | Persister un rapport de vérification pour le travail d'agent de fond ; reality-check les modifications de fichier revendiquées contre `git diff` |
 
 ---
 
@@ -234,7 +262,7 @@ memesh  # ouvre le tableau de bord → onglet Paramètres
                     (~/.memesh/knowledge-graph.db)
 ```
 
-Le cœur est indépendant du framework. La même logique s'exécute depuis le terminal, HTTP ou MCP.
+Le cœur est agnostique du framework. La même logique s'exécute depuis le terminal, HTTP ou MCP.
 
 ---
 
@@ -243,7 +271,8 @@ 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    # 413 tests
+npm test             # 489 tests
+npm run test:e2e-dashboard
 ```
 
 Tableau de bord : `cd dashboard && npm install && npm run dev`
@@ -251,5 +280,5 @@ Tableau de bord : `cd dashboard && npm install && npm run dev`
 ---
 
 <p align="center">
-  <strong>MIT</strong> — Fait par <a href="https://pcircle.ai">PCIRCLE AI</a>
+  <strong>MIT</strong> — Créé par <a href="https://pcircle.ai">PCIRCLE AI</a>
 </p>