@pcircle/memesh 4.0.3 → 4.1.0

package/README.fr.md

@@ -1,110 +1,284 @@
+<!-- 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 locale pour Claude Code et les coding agents compatibles MCP.</strong><br />
-    Un seul fichier SQLite. Sans Docker. Sans dépendance au 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>
+    <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>
   </p>
 </p>
 
-> Ce README en français est une version condensée. Pour la documentation complète et la version la plus à jour, utilisez le [English README](README.md).
+---
 
-## Quel problème cela résout-il ?
+## Le Problème
 
-Les coding agents perdent facilement le contexte d'une session à l'autre. Les décisions d'architecture, les bugs déjà corrigés, les leçons apprises et les contraintes du projet doivent alors être réexpliqués sans cesse.
+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 conserve ces connaissances en local, les rend consultables, et permet de les réutiliser au bon moment.**
+**MeMesh offre aux agents de codage une mémoire locale persistante, consultable et évolutive.**
 
-Ce package npm correspond à la version plugin / package locale de MeMesh. Il ne représente ni le workspace cloud ni une plateforme enterprise complète.
+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émarrage en 60 secondes
+---
 
-### 1. Installer
+## Démarrer en 60 Secondes
+
+### Étape 1 : Installer
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-### 2. Enregistrer une décision
+### Étape 2 : Mémoriser une décision
 
 ```bash
 memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
 ```
 
-### 3. La retrouver plus tard
+### Étape 3 : La rappeler plus tard
 
 ```bash
 memesh recall "login security"
-# → retrouve "OAuth 2.0 with PKCE" même avec une autre formulation
+# → 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
 ```
 
-Ouvrir le dashboard :
+Ouvrez le tableau de bord pour explorer votre mémoire :
 
 ```bash
 memesh
 ```
 
-## Pour qui ?
+<p align="center">
+  <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 — score de santé, frise chronologique, motifs, couverture des connaissances" 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>
+
+---
+
+## À Qui S'Adresse-T-Il ?
+
+| Si vous êtes... | MeMesh vous aide à... |
+|---|---|
+| **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 |
+
+---
+
+## Conçu d'Abord Pour Les Agents De Codage
+
+<table>
+<tr>
+<td width="33%" align="center">
+
+**Claude Code / Desktop**
+```bash
+memesh-mcp
+```
+Outils MCP + hooks Claude Code
+
+</td>
+<td width="33%" align="center">
+
+**N'Importe Quel Client HTTP**
+```bash
+curl localhost:3737/v1/recall \
+  -H "Content-Type: application/json" \
+  -d '{"query":"auth"}'
+```
+`memesh serve` (REST API)
+
+</td>
+<td width="33%" align="center">
+
+**N'Importe Quel LLM (Format OpenAI)**
+```bash
+memesh export-schema \
+  --format openai
+```
+Collez les outils dans n'importe quel appel API
+
+</td>
+</tr>
+</table>
+
+---
 
-- Les développeurs qui utilisent Claude Code et veulent garder le contexte entre les sessions
-- Les utilisateurs avancés qui souhaitent partager la même mémoire locale entre plusieurs agents MCP
-- Les petites équipes AI-native qui veulent partager leur connaissance projet via export / import
-- Les développeurs d'agents qui veulent brancher une mémoire locale via CLI, HTTP ou MCP
+## Pourquoi Pas OpenMemory, Cursor Memories, Mem0 Ou Zep ?
 
-## Pourquoi choisir MeMesh ?
+| | **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 |
 
-- Local-first : les données restent dans votre propre fichier SQLite
-- Installation légère : `npm install -g` et c'est parti
-- Intégration directe : CLI, HTTP et MCP sont pris en charge
-- Bien adapté à Claude Code : les hooks ramènent le bon contexte dans le flux de travail
-- Inspectable : le dashboard permet de voir et nettoyer la mémoire
-- Frontière de confiance plus sûre : les mémoires importées restent consultables, mais ne sont pas injectées automatiquement dans les hooks Claude tant qu'elles n'ont pas été revues ou resauvegardées localement
+**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.**
 
-## Que fait-il automatiquement dans Claude Code ?
+---
 
-Aujourd'hui, MeMesh intervient à 5 moments :
+## Ce Qui Se Passe Automatiquement Dans Claude Code
 
-- au démarrage de session, il charge les mémoires pertinentes et les leçons connues
-- avant l'édition d'un fichier, il rappelle ce qui est lié au fichier ou au projet
-- après un `git commit`, il enregistre les changements effectués
-- à la fin de session, il résume les corrections, erreurs et lessons learned
-- avant la compaction du contexte, il sauvegarde ce qui ne doit pas être perdu
+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 :
 
-## Que contient le dashboard ?
+| 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 défaillances |
+| **Avant la compaction de contexte** | Sauvegarde les connaissances avant qu'elles ne soient perdues aux limites de contexte |
 
-Le dashboard propose 7 onglets et prend en charge 11 langues :
+> **Refuser à tout moment :** `export MEMESH_AUTO_CAPTURE=false`
 
-- Search : rechercher dans la mémoire
-- Browse : parcourir toutes les mémoires
-- Analytics : suivre la santé et les tendances
-- Graph : visualiser les relations de connaissance
-- Lessons : revoir les leçons apprises
-- Manage : archiver et restaurer
-- Settings : configurer le provider LLM et la langue
+---
 
-## Qu'est-ce que le Smart Mode ?
+## Tableau De Bord
 
-MeMesh fonctionne hors ligne par défaut. Si vous configurez une API key LLM, vous pouvez activer des capacités supplémentaires, par exemple :
+7 onglets, 11 langues, zéro dépendance externe. Accessible à `http://localhost:3737/dashboard` quand le serveur s'exécute.
 
-- query expansion
-- une extraction automatique plus utile
-- une organisation et une compression plus intelligentes
+| Onglet | Ce que vous voyez |
+|---|---|
+| **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é |
 
-Sans API key, le cœur du produit reste totalement utilisable.
+---
 
-## Aller plus loin
+## Fonctionnalités Intelligentes
 
-- Fonctionnalités complètes, comparaisons, API et notes de release : [English README](README.md)
-- Guide d'intégration : [docs/platforms/README.md](docs/platforms/README.md)
-- Référence API : [docs/api/API_REFERENCE.md](docs/api/API_REFERENCE.md)
+**🧠 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é.
 
-## Développement et vérification
+**📊 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.
+
+---
+
+## Exemple D'Utilisation
+
+> « 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**
+
+> « 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**
+
+> « 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**
+
+---
+
+## Déverrouiller Le Mode Smart (Optionnel)
+
+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 Settings du tableau de bord (configuration visuelle) :
+
+```bash
+memesh  # ouvre le tableau de bord → onglet Settings
+```
+
+| | Niveau 0 (défaut) | Niveau 1 (Mode Smart) |
+|---|---|---|
+| **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 9 Outils De Mémoire
+
+| Outil | Ce qu'il fait |
+|---|---|
+| `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` |
+
+---
+
+## Architecture
+
+```
+                    ┌─────────────────┐
+                    │   Core Engine   │
+                    │  (8 operations) │
+                    └────────┬────────┘
+           ┌─────────────────┼─────────────────┐
+           │                 │                 │
+     CLI (memesh)    HTTP API (serve)    MCP (memesh-mcp)
+           │                 │                 │
+           └─────────────────┼─────────────────┘
+                             │
+                    SQLite + FTS5 + sqlite-vec
+                    (~/.memesh/knowledge-graph.db)
+```
+
+Le cœur est agnostique du framework. La même logique s'exécute depuis le terminal, HTTP ou MCP.
+
+---
+
+## Contribuer
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
-cd memesh-llm-memory
-npm install
-npm run build
-npm test
+cd memesh-llm-memory && npm install && npm run build
+npm test             # 489 tests
+npm run test:e2e-dashboard
 ```
+
+Tableau de bord : `cd dashboard && npm install && npm run dev`
+
+---
+
+<p align="center">
+  <strong>MIT</strong> — Créé par <a href="https://pcircle.ai">PCIRCLE AI</a>
+</p>