Momento/AGENTS.md

Agent memory (Memento)

Learned User Preferences

• Français obligatoire dans les réponses à l’utilisateur : français adulte, phrases complètes, comme on parle à quelqu’un d’intelligent qui n’est pas informaticien. Interdit : anglais, mots anglais collés dans une phrase française, jargon de designer ou de développeur (ex. héros, widget, streak, CTA, dashboard, flashcards — dire plutôt « grand encadré », « carte », « jours d’affilée », « bouton », « page d’accueil », « cartes de révision »). Le français télégraphique, infantile ou incorrect est une correction dure (l’utilisateur a déjà dit qu’il ne comprenait rien). Expliquer simplement ce qui a changé à l’écran — nommer le bouton ou la barre visible, pas une métaphore (« chapeau de l’éditeur »). Rester sur le sujet demandé (ne pas digresser vers git/ops hors scope quand la demande porte sur une feature métier). Nom produit : Memento (jamais « Momento ») — libellés, metadata, pages publiques, docs.
• Interface : tout libellé via i18n dans les 15 fichiers memento-note/locales/*.json (FR et EN comme références de contenu) ; éviter le texte en dur ; traductions contextuelles (sens produit, pas mot à mot — ex. « connecter votre propre fournisseur ») ; libellés FR lisibles (éviter jargon non expliqué : « wiki », « embed », etc.) et aide contextuelle où l'UX l'exige ; lors d'une traduction complète, mettre à jour toutes les locales concernées ; si l'utilisateur demande seulement les clés i18n, ajouter les clés (souvent EN/FR) sans remplir les 15 locales — il traduit souvent avec un autre modèle ; jamais de marque tierce dans les libellés utilisateur (ex. référence design « Kimi » → UI/i18n = « Page interactive » / « Interactive page ») ; insights Memory Echo (texte généré/stocké) : langue utilisateur à la génération + fallback i18n à l'affichage (memoryEcho.defaultInsight) — jamais d'anglais en dur quand l'UI est FR.
• Base de données : INTERDIT TOTALEMENT de lancer prisma db push --force-reset, prisma migrate reset, DROP TABLE, TRUNCATE, pg_restore avec clean, ou TOUTE commande qui vide/supprime des données — MÊME SI l'utilisateur est d'accord — sans avoir d'abord : (1) dumpé la base avec bash /home/devparsa/dev/Memento/dump-db.sh, (2) vérifié le dump fait au moins 1Mo, (3) obtenu un "OUI" explicite de l'utilisateur. 4 incidents de perte de données documentés (14/05, 15/05 x2, 16/05). NE JAMAIS REFAIRE ÇA.
• Design produit : migration depuis architectural-grid1 (base) et architectural-grid (prototype UI courant) ; consulter le prototype avant toute implémentation UI ; logique liste/carte puis contenu au clic ; parité actions liste/carte (menus « … », déplacer, génération SVG, etc.) ; contraste éditeur clair / sidebar sombre ; retirer thèmes obsolètes ; pas de refresh/revalidation complets inutiles (aligné prototype — mutations optimistes, pas de revalidatePath systématique ni resync depuis initialNotes) ; Memory Echo en section inline dans l'éditeur (pas l'ancienne modale) — similarité sur contenu représentatif (pas de troncature arbitraire type 200/800 car.) ; recherche (sidebar / résultats, ex. flux « ouvrir la note ») et navigation liste des notes (modes affichage, icônes vs initiales…) : suivre SearchModal et les patterns actuels dans architectural-grid, pas une approximation ou un ancien flux ; sidebar rail (sidebar.tsx) : une seule icône active ; largeur sidebar (components/sidebar.tsx) — redimensionnement utilisateur par poignée sur le bord droit (desktop md+, 280–560px, persisté localStorage memento-sidebar-width) ; défaut responsive w-80 puis plus large en xl/2xl si aucune valeur stockée ; hauteur zone carnets ajustable via poignée horizontale (memento-sidebar-notebooks-height, min 120px) ; fallback Suspense de app/(main)/layout.tsx aligné sur les largeurs par défaut (rail fixe 54px) ; pas de bouton « Note du jour » dans la sidebar (retiré volontairement) ; dashboard Second Brain (/home, dashboard-view.tsx) : vue d'ensemble interactive (pas dashboard statique/mort) — layout v7 configurable (catalogue ~22 widgets, persisté /api/dashboard/layout) — ne PAS alléger/cacher des widgets ni bumper DASHBOARD_LAYOUT_VERSION dans lib/dashboard/layout.ts (réécrit les layouts de tous les utilisateurs) ; distill ≠ amputer le produit ; jamais reset d'un dashboard vivant sans confirmation explicite ; chantier carte par carte / Impeccable sur /home : ne pas cacher les cartes catalogue-only (revue du matin, boucles ouvertes, usage, Gmail) ni les activer sans demande ; « Continuer » : pas de notes vides sans titre (un extrait est OK si la note a du texte) ; compteurs inbox / à réviser / découvertes / thèmes une seule rangée actionnable, pas répétés dans le sous-titre ET le bandeau ET les raccourcis du panneau latéral ; « L'IA a trouvé » ne doit pas reciter les mêmes ponts que « Prochaines pistes » ; « Personnaliser » pas en barre fixe en bas qui recouvre les cartes ; widget « Prochaines pistes » (next-paths) = recommandations actionnables depuis la dernière note éditée (fast paths briefing puis enrichissement async /api/briefing/paths) ; widget « Revue quotidienne » = checklist matinale interactive (inbox, découvertes IA, connexion, flashcards) — pas une revue automatique de contenu ; cartes cliquables, section Memory Echo « L'IA a trouvé » exploitable (pas vide après 1ère visite), consentement/provider IA + quotas vérifiés sur chaque action IA (dashboard et agents) ; chaque widget : aide contextuelle « ? » i18n ; couleurs alignées sur le thème settings ; icônes Lucide (pas emojis système type 🎯) ; MindMapCard remplace l'ancien MiniResonanceGraph D3 (graphe décoratif qui débordait) ; navigation sidebar alignée sur /home ; activeView synchronisé avec pathname et query (/insights, /revision, /home?reminders=1) ; /home sans filtre = dashboard, liste notes via ?forceList=1 (lib/dashboard/home-route.ts) — toujours un moyen de revenir au dashboard depuis notes/liste (ne jamais coincer l’utilisateur dans la vue notes ; un chantier design/Impeccable ne doit pas casser routing/sidebar/forceList) ; panneau latéral contextuel par route (pas la liste carnets sur /insights ou Rappels) ; /insights (insights sémantiques) : suivre InsightsView.tsx + graphe réseau associé dans le prototype (ex. composition type NetworkGraph.tsx) ; distincte de /graph ; ne pas substituer par une UX « géométrique » décorative ou un regroupement par carnet hors spec prototype ; ne pas inventer ni enchaîner d’autres dessins sans accord explicite (rejetés : libellés de thèmes tronqués, zones colorées avec noms empilés, titres de notes sur le cluster, grille de bulles, liste comme vue d’arrivée à la place du graphe) ; ne pas retirer les noms notes/thèmes/connexions du graphe sans demande ; Connexions (network-graph.tsx) : une fois les noms restaurés, ne plus y toucher (aucun nouvel essai de dessin) ; si un dessin est refusé, s’arrêter et attendre — pas d’essais en série ; lorsque données clusters en retard ou partiellement périmées, montrer l’état dégradé exploitable plutôt qu’une page vide ; liens/ponts proposés : pertinence sémantique réelle (rejeter associations absurdes cross-domaine) ; pas d'IDs techniques type « cluster 15 » exposés à l'utilisateur ; bouton Menu immersif /insights : cacher la sidebar ET agrandir le contenu principal (pas de bandeau beige vide — attention twMerge qui peut faire perdre fixed au profit de relative) ; si l'utilisateur hésite entre variantes UX, trancher pour le design prototype plutôt que multiplier les toggles ; scores Impeccable indicatifs — ils ne primeront pas sur le prototype architectural-grid ni PRODUCT.md en cas de conflit ; landing page (components/landing-page.tsx) : style marketing sombre/premium type x.ai (pas de fond blanc plat) ; mettre en avant Second Brain ; textes publics sans jargon produit anglais restant (lock-in, Scraper, Slide Gen, SM-2, etc.) ; noms de modèles BYOK depuis le catalogue serveur vivant (/api/public/byok-catalog) — pas une liste figée ; multilinguisme avec sélecteur de langue (icône globe — ne pas confondre avec navigation back) ; harmonie dark mode (ex. zone notifications).
• Locale persane : dates en calendrier iranien (conversion), chiffres persans, et vérification RTL/positionnement global (app et extension Web Clipper) ; Memory Echo et recherche sémantique doivent fonctionner en persan (RTL, embeddings — pas de contournement « EN only ») ; attention à ne pas confondre un nom de carnet (ex. « Persan ») avec le libellé de langue.
• Flux Excalidraw / diagrammes générés : accès via notification en plus d'une simple redirection ; priorité à la mise en page et au texte contenu dans les formes ; proposer des modes visuels (ex. coloré vs plus austère) tout en visant un rendu proche du style Excalidraw (polices, look).
• Interdiction d'écrire des tests sauf demande explicite ; en CI, seul npm run test:unit (tests/unit/**) — pas tests/migration/ ; ne jamais générer de code superflu.
• Déploiement : privilégier le chemin rapide (artifact Next.js en CI + Dockerfile.prebuilt) ; CI/CD très robuste (pas d'image Docker obsolète en prod, pas de migrations/schéma DB via le workflow deploy) ; éviter les rebuild Docker complets inutiles (~15 min par itération) ; ne pas pousser un déploiement quand des features clés sont inachevées ; ne pas insister sur le déploiement tant que le produit n'est pas fini ou meilleur ; ne jamais hardcoder d'IP/URL dans le repo ou les défauts CI — uniquement variables d'env (ex. GRAFANA_BIND, GRAFANA_URL) ; la config runtime reste sur le serveur dans .env.docker. Machines : agent/dev = 192.168.1.83 (devSanbox) ; prod = 192.168.1.190 (/opt/memento) — ne jamais confondre les deux au diagnostic services. CI/CD Gitea spécifique : (1) CI ubuntu-24.04 = lint + tests + build (validation) ; deploy docker-host = build sur le serveur → /tmp/web-artifact.tgz → deploy-prod.sh — sans upload/download-artifact inter-runners (stockage Gitea instable ; si artifacts utilisés, @v3 uniquement — @v4 → GHESNotSupportedError) ; (2) Dockerfile.socket.prebuilt doit utiliser --legacy-peer-deps dans npm install (conflit TipTap 3.22.5 vs 3.23.6) ; (3) le serveur de prod (192.168.1.190) ne peut pas pull Docker Hub (DNS cassé) — le build Docker complet échoue, seul le chemin prebuilt artifact fonctionne ; (4) docker-entrypoint.sh applique les migrations Prisma avant de démarrer le serveur Next.js (ordre correct) ; (5) rollback d'urgence : docker tag memento-memento-note:rollback memento-memento-note:latest && docker compose up -d --force-recreate memento-note ; (6) scripts/deploy-prod.sh charge /opt/memento/.env.docker via un parseur robuste ligne-par-ligne (jamais source — crash unexpected EOF sur guillemet non fermé) et teste Postgres avec pg_isready + credentials du conteneur ($POSTGRES_USER interne) ; (7) lint CI = eslint --max-warnings 9999 : les warnings ne bloquent pas, seules les erreurs bloquent (ex. no-html-link-for-pages → <Link> obligatoire pour la navigation interne, pas <a href="/">) ; TRAVAILLER SUR UNE BRANCHE pendant le dev, ne push sur main que quand le code est testé et fonctionnel — avant push main : exécuter localement npm run lint, npm run test:unit, npm run build (même enchaînement que CI) ; chaque push sur main déclenche un déploiement automatique en production.
• Authentification : priorité à l'inscription/connexion via Google OAuth (plutôt qu'un compte email/mot de passe) ; bouton Google absent en local = attendu (visible seulement en prod) — ne pas « corriger » ça ; inscription email/mdp : email de confirmation obligatoire (lib/auth/email-verification.ts, envoi à l'inscription) — login bloqué tant que emailVerified est null ; OAuth Google marque l'email comme vérifié automatiquement ; exiger une vraie déconnexion (invalidation session/cookies — pas de reconnexion implicite, y compris en navigation privée) ; prod : AUTH_GOOGLE_ID/AUTH_GOOGLE_SECRET dans /opt/memento/.env.docker et variables/secrets Gitea Actions (workflow deploy n'écrit pas les valeurs vides) — absence → invalid_client ; redirect URI exacte https://memento-note.com/api/auth/callback/google ; config via Google Auth Platform (Branding → Audience In production, pas Testing → Clients Web) ; ALLOW_REGISTRATION=true requis pour inscription email (env ou SystemConfig en base — la DB peut primer sur l'env) ; navigateur intégré Cursor peu fiable pour le login (focus volé, cookies isolés, OAuth Google souvent bloqué) — préférer un vrai navigateur pour la connexion manuelle, et pour l'automation (démos/Playwright) une session JWT/cookies stockée plutôt que de rejouer le login dans le browser Cursor.
• Priorité absolue à la qualité UX, même si l'implémentation est complexe (« je m'en fous si c'est complexe ») ; préférer les solutions long terme aux rustines ; si l'utilisateur demande explicitement d'analyser sans coder, expliquer d'abord et ne pas modifier le code tant qu'il n'a pas validé ; pour les tâches ops (config OAuth prod, serveur), préfère un guidage interactif étape par étape plutôt qu'un bloc d'instructions monolithique ; ne jamais affirmer qu'un correctif ou une feature est fait sans vérification réelle (app, prototype architectural-grid, ou test), notamment navigation recherche/liste notes et vue /insights vs fichiers prototype — l'utilisateur sanctionne fermement les fausses déclarations ; ouverture note liée depuis l'éditeur (ex. bloc live « Ouvrir ») : split peek inline animé (lib/note-peek-sync.ts, note-editor-split-peek.tsx — éditeur courant à gauche, note liée en lecture seule à droite en LTR ; inversé en RTL fa/ar), pas nouvel onglet ; Interactive Demo (player TipTap) : sélecteur de vitesse visible (0.5x / 1x / 2x / 4x — pas un bouton cycle cryptique) ; scènes dignes du contenu (pas de boîtes jouet 2 nœuds / texte plat) — labels et équations issus de la note (TipTap math data-latex / KaTeX) ; génération IA via le modèle slides (getSlidesProvider), pas la lane chat ; Page interactive (explainer publié, ≠ Interactive Demo TipTap) : pipeline note → PageSpec → /p/{slug} ; priorité vitesse/fiabilité de génération (chemin déterministe buildPageFromNote / démo déterministe plutôt que LLM lent qui timeoute ~150 s vs abort client) ; simulateurs (ex. cycle de Carnot) : flèches correctement orientées, têtes SVG non déformées, flux branchés sur la machine (pas de flèches flottantes) ; unités température commutables K / °C / °F ; distinguer énergie (kJ) et puissance (W) ; modes frigo / PAC / moteur ; ne jamais annuler du code non commité (git checkout, reset fichier) sans demande explicite (perte de travail documentée, ex. drag handle éditeur) ; ne jamais remettre du code que l'utilisateur a explicitement retiré sans demander d'abord (ex. reserveUsageOrThrow retiré intentionnellement de organize-notebook.ts — agent l'a remis sans demander → user mécontent) ; correction i18n ou spec doc : ne pas refondre logique/UI hors scope (ex. US-4 structuredViewBlock — garder le dual-mode base locale + lien carnet, pas de suppression du mode local) ; en frustration ou pour déléguer, prévoir des prompts / briefs d'implémentation détaillés (autre modèle ou dev), en plus des briefs outil de design ; vidéos promo : VO anglaise ; montrer de vraies features authentifiées (dashboard, Memory Echo, Insights, Revision, Agents, menu / éditeur…) — pas un slideshow landing seul ; démos note/éditeur : masquer sidebar/carnets pour focaliser la note ; style kinetic OK (coupes rapides + texte à l'écran) mais pas de fade-to-black entre plans (clignote) — crossfades ; après saisie, montrer le sparkle titre IA ; interdit Ken Burns / zoompan (surtout sur fonds pointillés → moiré / tremblement) — images fixes, fond uni stable à la capture.
• Livraison : une user story à la fois, tester et valider avec l'utilisateur avant la suivante (pas d'auto-validation ni d'enchaînement de code non demandé) ; « suivant » / « continue » / « ok vas-y » après un commit n'est pas un chèque en blanc pour changer la surface majeure suivante sans montrer le plan et obtenir validation ; « fais le reste » = uniquement les points déjà listés, pas la permission d’inventer ni de retoucher une surface déjà refusée (surtout le dessin /insights) ; suivi dans docs/user-stories.md ; briefs pour outil de design externe sur demande ; avant de développer une story, vérifier d'abord dans le code si la feature existe déjà — les docs de stories (docs/story-nextgen-editor.md, docs/user-stories.md) sont souvent périmés (features livrées mais marquées « à faire ») ; dashboard Second Brain : même rythme — une feature à la fois, validation explicite avant la suivante.
• Facturation & quotas IA : limites mensuelles, tiers (BASIC/PRO/BUSINESS/ENTERPRISE) et Price IDs Stripe via Admin > Facturation & quotas (/admin/billing) — pas via .env pour le métier ; secrets Stripe (STRIPE_SECRET_KEY, webhook) restent en env serveur ; doc memento-note/docs/admin-billing-quotas-guide.md ; essai gratuit abonnement = 7 jours (SUBSCRIPTION_TRIAL_DAYS dans lib/billing/trial-constants.ts — pas 14) : afficher clairement sur landing et UI facturation (i18n partout) ; tier BASIC sans accès MCP ; chaque usage IA (dashboard, agents, MCP si autorisé, etc.) doit décompter le quota — mécanisme = réservation atomique upfront (Redis/Postgres) avant l'appel IA, sans rollback si l'appel échoue ensuite ; BYOK peut contourner selon config — listes de modèles (réglages et pages publiques) via le catalogue serveur (/api/user/api-keys/live-models, /api/public/byok-catalog), pas de noms en dur ; ne pas affirmer un déploiement prod sans vérif réelle (ex. travail MCP/quotas encore local).

Learned Workspace Facts

• Application Next.js principalement sous memento-note/.
• Référentiels design du workspace : architectural-grid1/ et architectural-grid/ à la racine du repo Memento.
• i18n : 15 fichiers sous memento-note/locales/ (de, en, es, fr, it, pt, nl, pl, ru, zh, ja, ko, ar, fa, hi) ; logique sous memento-note/lib/i18n/ ; référence en.json (~2218 clés) ; auditer les « non traduits » par flatten EN vs locale (souvent valeurs identiques à l'EN) ; pages auth (/login, /register) : LanguageProvider + detectUserLanguage comme les layouts public/main (pas d'anglais forcé).
• Workflow BMad : stories sous docs/ (ex. 3-4-host-pays-session-logic.md), suivi sprint dans docs/sprint-status.yaml et stories courantes dans docs/user-stories.md ; skills sous .claude/skills/bmad-* ; _bmad-output/planning-artifacts souvent vide — planification de référence dans docs/ ; préférer une user story par feature (pas de stories groupées).
• PostgreSQL Docker (memento-postgres) port 5433 ; Redis (memento-redis) port 6379 ; règles Prisma/DB dans CLAUDE.md.
• Admin facturation : page /admin/billing (billing-admin-client.tsx, actions admin-billing.ts) — quotas par feature IA, config Stripe métier en base (effet ~60 s), santé/stats ops ; essai 7 jours via lib/billing/trial-constants.ts ; guide memento-note/docs/admin-billing-quotas-guide.md ; settings user /settings/billing (billing-plans.tsx) ; catalogues modèles BYOK : lib/ai/live-public-catalog.ts, /api/public/byok-catalog (landing/tarifs), /api/user/api-keys/live-models (réglages clés).
• Hosts : machine agent/dev (192.168.1.83, Vibe/annotations locales) ≠ prod (192.168.1.190, dépôt /opt/memento) — ne jamais diagnostiquer l'un pour l'autre. Production : conteneur memento-note port 3000, URL publique https://memento-note.com (nginx + Cloudflare ; ancien domaine note.parsanet.org) ; NEXTAUTH_URL aligné sur ce domaine ; auth prod requiert AUTH_GOOGLE_ID/AUTH_GOOGLE_SECRET dans .env.docker (sinon OAuth invalid_client) et ALLOW_REGISTRATION=true pour l'inscription email ; email sortant via Resend (SMTP_FROM ex. noreply@memento-note.com, domaine vérifié sur resend.com) ; monitoring Grafana via GRAFANA_BIND / GRAFANA_URL dans .env.docker (pas d'IP en dur dans le compose) ; deploy (deploy.yaml / deploy-prod.sh) sans toucher Postgres (pas de postgresql-client, pas de migrations auto en prod).
• CI/CD Gitea : .gitea/workflows/ci.yaml — CI sur ubuntu-24.04 (lint + tests + build validation), deploy sur runner docker-host (build local /tmp/web-artifact.tgz, sans artifacts inter-runners) ; deploy manuel via .gitea/workflows/deploy.yaml ou bash scripts/deploy-prod.sh.
• Migrations prebuilt + vérif deploy : docker compose exec memento-note node ./node_modules/prisma/build/index.js migrate deploy (pas npx prisma) ; helper scripts/migrate-docker.sh ; GET /api/build-info (SHA Git) ; comparer 127.0.0.1:3000 et domaine Cloudflare — purger cache si versions divergent ; 403 /api/manifest côté domaine = souvent Cloudflare.
• Éditeur riche : rich-text-editor.tsx — immediatelyRender: false ; activer shouldRerenderOnTransaction: false (quick win perf TipTap 2.5) ; drag handle / menu bloc via @tiptap/extension-drag-handle-react (spec officielle — pas de double plugin DragHandleExtension + composant React, pas de repositionnement maison) ; poignée dans colonne gutter fixe du wrapper (padding + getReferencedVirtualElement), pas sur le bord des listes/numéros ; CSS : pas opacity:0 sur .drag-handle (visibilité gérée par le plugin) ; config/callbacks stables hors composant ; fondation blocs : tiptap-unique-id-extension.ts / data-id persisté à la sauvegarde (références « Copier la référence ») ; Smart Paste : lib/editor/smart-paste-extension.ts ; peek split note source : lib/note-peek-sync.ts + note-editor-split-peek.tsx ; Interactive Demo : JSON déclaratif allowlisté + player TipTap (lib/interactive-demo/ — validate.ts / resolve.ts / schéma ; components/interactive-demo/ ; extension tiptap-interactive-demo-extension ; API /api/ai/interactive-demo via getSlidesProvider + extraction formules type slides, labels KaTeX) — le player consomme resolve.ts (pas de logique de portée dans React) ; Page interactive (explainer) : lib/interactive-page/ (PageSpecV1, schema/validate/normalize, fixtures thermo/Carnot) + components/interactive-page/ (page-view, sim-block, publish dialog) + API /api/ai/interactive-page ; preview /dev/interactive-page ; publication publique /p/{slug} ; simulateur Carnot : lib/simulators/carnot-cycle*.ts + components/simulators/carnot-cycle*.tsx (modes frigo/PAC/moteur, unités K/°C/°F, énergie kJ vs puissance W) ; conversion markdown → texte enrichi : un seul convertisseur lib/markdown-to-html.ts (markdownToHtml, gfm+breaks) + une action atomique convertToRichText(html) dans note-editor-context.tsx (applique le HTML immédiatement via setContentImmediate — pas le setContent débouncé 800ms — et bascule isMarkdown=false) ; toolbar (handleConvertToRichtext) et chat IA contextuel (contextual-ai-chat.tsx, action toRichText → /api/ai/convert-markdown) passent par cette action unique (ne pas dupliquer la conversion ni oublier de basculer isMarkdown) ; US-4 structuredViewBlock (tiptap-structured-view-block-extension.tsx, structured-view-block-embed.tsx) : dual-mode — base locale autonome par défaut (/database, /vue, isLocal: true) + option « Lier à un carnet » (Structured Views) ; i18n structuredViewBlock.* ; rejeté : ancien databaseBlock « Auteurs & Œuvres » et spec embed-only docs/story-nextgen-editor-us4-redesign.md ; epic active docs/story-nextgen-editor.md — priorité PERF > NEXTGEN > UX > MOBILE > MARKDOWN.
• Sync mutations notes entre composants : memento-note/lib/note-change-sync.ts (emitNoteChange, événement NOTE_CHANGE_EVENT) ; tracking quotas IA : événement ai-usage-changed (window) — doit être dispatché depuis tous les points d'appel IA (recherche sémantique, auto-tag, auto-title, chat, reformulation, analyse carnet, etc.) ; UI quotas : usage-meter.tsx (polling 5s + écoute événement).
• Roadmap / écart prototype vs prod : Web Clipper — ClipperSimulator.tsx = référence design uniquement (pas de simulateur en prod) ; extension memento-note/extension/ v0.3 Side Panel (clip page/sélection/lien ; popup Chrome se ferme au clic page — Side Panel pour la sélection) ; i18n extension 15 langues (_locales/, détection locale navigateur ; script extension/i18n/generate-translations.cjs) ; host_permissions incl. LAN ; URL serveur configurable en dev, adresse prod figée en release ; cookies/session alignés avec l'instance cible ; Flashcards IA SM-2 livrées : /revision, /api/flashcards/*, génération depuis l'éditeur (GraduationCap) — réf. prototype RevisionView.tsx ; Structured Views partiellement livrées : schéma par carnet, Table/Kanban, champs partagés et valeurs par note (/home + toolbar carnet) — suivi de tâches par carnet via Kanban structuré (pas de vue agrégée Notes/Tâches sur la home ; cases à cocher inline dans les notes) ; Éditeur Next-Gen livré (doc docs/story-nextgen-editor.md périmé — vérifier le code) : US-1 poignée gutter unique (editor-block-drag-handle.tsx + lib/editor/global-drag-handle-extension.ts, extension Novel tiptap-extension-global-drag-handle), US-2 menu action bloc (block-action-menu.tsx), US-3 Smart Paste transclusion (smart-paste-extension.ts + smart-paste-menu.tsx), US-4 database inline (structuredViewBlock), plus data-id / liveBlock / peek split ; /insights livré : app/(main)/insights/page.tsx + network-graph.tsx (clusters sémantiques, bridge notes ; ≠ /graph) ; US-TEMPORAL reporté ; encore en gap : transclusion bidirectionnelle complète, graphe knowledge enrichi (GraphKnowledgeMap.tsx) ; publication Chrome Web Store : icônes 16/48/128, privacy policy, host_permissions prod restreints vs build dev ; Wizards : NotebookOrganizerDialog (tags/doublons) branché via bouton "Tags IA" dans home-client.tsx — StructuredViewsWizard encore orphelin (pas de point d'entrée UI) ; Publication web (note-editor-toolbar.tsx) : deux modes — simple (copie directe) + IA (2-3 templates visuellement distincts, reformulation/mise en page adaptée au contenu — exercices, toggles, callouts — images incluses, KaTeX pour équations) — quota IA consommé uniquement sur publication IA ; l'utilisateur rejette les rendus « copie du texte » / mise en page nulle ; champs DB publication sur modèle Note : publicSlug (pas publishedSlug), publishedContent (pas publishedHtml) — publishMode est paramètre API uniquement (mode: 'simple' | 'ai'), pas un champ en base ; Second Brain dashboard (/home, dashboard-view.tsx) livré : layout v7 configurable (~22 widgets, /api/dashboard/layout) — bumper DASHBOARD_LAYOUT_VERSION (lib/dashboard/layout.ts) réécrit les layouts persistés de tous les utilisateurs ; route isDashboardHomeRoute (lib/dashboard/home-route.ts) — liste notes via /home?forceList=1 ; briefing agrégé (/api/briefing), pistes fast+enrich (/api/briefing/paths, paths-fast.ts), suggestions agents, scan Gmail (GmailScanHistory), navigation sidebar /home ; bento interactif — MindMapCard (clusters), suggestions agents (AgentSuggestion, cron), Memory Echo, sentiment, inbox/révisions ; Gmail OAuth (/api/integrations/gmail/*, pattern Calendar) — scan vols/colis/abonnements → notes + rappels ; crons entrypoint : agents, agent-suggestions, clusters, reminders, gmail-scan, sync-usage ; vidéos promo : pipeline promo-video/ (make_promo.py, make_promo_features.py, make_promo_slash.py, make_promo_slash_kinetic.py, SCENARIO.md) — captures app authentifiée (Playwright + session JWT), VO EN (edge-tts), montage stable sans zoom (crossfades si kinetic).