feat(insights): fix DBSCAN, Persian embeddings crash, D3 physics layouts, and D3 node not found runtime error

memento-note/extension/README.md

@@ -0,0 +1,46 @@
+# Memento Web Clipper — extension Chrome
+
+Clipper web avec **panneau latéral** : le panneau reste ouvert pendant que vous surlignez du texte sur la page.
+
+## Installation (dev)
+
+1. Chrome → `chrome://extensions`
+2. **Mode développeur** → **Charger l’extension non empaquetée** → dossier `memento-note/extension`
+3. Épingle l’icône Momento
+
+> Chrome **114+** requis (Side Panel API).
+
+## Instance Momento
+
+- **Dev** : icône ⚙ → URL (`http://localhost:3000` ou IP LAN) → **Appliquer & reconnecter**
+- Connectez-vous sur **la même URL** dans Chrome (Google OAuth)
+- **Production (build Store)** : mettre `ALLOW_INSTANCE_CONFIG = false` dans `sidepanel.js` → URL `https://memento-note.com` en dur, réglages masqués
+
+## Utilisation
+
+1. Ouvrez une page web normale (pas `chrome://`)
+2. Cliquez l’icône Momento → panneau latéral
+3. Choisissez le **carnet** (liste hiérarchique)
+4. Optionnel : surlignez du texte → **Clipper la sélection** (bouton sky)
+5. Ou **Clipper cette page** (article complet + IA)
+6. Ou **Enregistrer le lien seul**
+7. **Aperçu** : titre éditable, résumé, extrait, temps de lecture → **Enregistrer dans Momento**
+
+## Dépannage
+
+| Problème | Solution |
+|----------|----------|
+| Carnets vides / 401 | **Ouvrir Momento ↗** sur la même URL, connectez-vous |
+| `localhost` vs `127.0.0.1` | Utilisez **toujours la même** URL partout (cookies session) |
+| Pas de sélection | Rechargez la page après install extension ; surlignez sur la page, pas dans le panneau |
+| Page Chrome système | Impossible — ouvrez un site http(s) normal |
+
+## Persan / RTL
+
+Détection automatique `dir` / `lang` (ex. BBC Persian), aperçu RTL avec Vazirmatn.
+
+## APIs
+
+- `GET /api/clip/notebooks`
+- `POST /api/clip/analyze`
+- `POST /api/clip/save`