@agent-native/core 0.77.2 → 0.77.4

package/docs/content/locales/fr-FR/real-time-collaboration.md

@@ -38,7 +38,7 @@ Le système de collaboration comporte cinq couches imbriquées.
 
 ```an-diagram title="Cinq couches imbriquées" summary="Du CRDT en mémoire au transport qui transporte les mises à jour entre les pairs, chaque couche a une tâche."
 {
-  "html": "<div class=\"diagram-stack\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">1 &middot; Yjs Y.Doc</span><small class=\"diagram-muted\">CRDT &mdash; conflict-free merge, no coordinator</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">2 &middot; SQL canonical content</span><small class=\"diagram-muted\">_collab_docs &mdash; durable source of truth, versioned</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">3 &middot; updatedAt-gated reconcile</span><small class=\"diagram-muted\">agent edits propagate via the SQL bump</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">4 &middot; Lead-client election</span><small class=\"diagram-muted\">exactly one tab applies the snapshot</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill ok\">5 &middot; SSE fast-path + polling</span><small class=\"diagram-muted\">~tens of ms, degrades to 2s poll anywhere</small></div></div>",
+  "html": "<div class=\"diagram-stack\"><div class=\"diagram-card layer\"><span class=\"diagram-pill accent\">1 &middot; Yjs Y.Doc</span><small class=\"diagram-muted\">CRDT &mdash; fusion sans conflit, sans coordinateur</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">2 &middot; Contenu canonique SQL</span><small class=\"diagram-muted\">_collab_docs &mdash; durable source of truth, versioned</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">3 &middot; réconciliation contrôlée par updatedAt</span><small class=\"diagram-muted\">les modifications de l’agent se propagent via le bump SQL</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill\">4 &middot; Élection du client leader</span><small class=\"diagram-muted\">un seul onglet applique l’instantané</small></div><div class=\"diagram-card layer\"><span class=\"diagram-pill ok\">5 &middot; chemin rapide SSE + polling</span><small class=\"diagram-muted\">~quelques dizaines de ms, retombe sur un polling de 2 s partout</small></div></div>",
   "css": ".diagram-stack{display:flex;flex-direction:column;gap:8px}.diagram-stack .layer{display:flex;flex-direction:column;gap:4px;padding:12px 14px}"
 }
 ```
@@ -86,7 +86,7 @@ Les événements de mise à jour de collaboration suivent deux chemins :
   (le même `EventSource` utilisé par `useDbSync`). Les événements de mise à jour de la collaboration arrivent
   de type push, généralement en dizaines de millisecondes. Bien que SSE soit en bonne santé,
   la boucle d'interrogation se détend à une cadence lente (~ 12 s par défaut).
-- **Polling fallback** — `/_agent-native/poll?since=N` est interrogé toutes les 2 s
+- **Sondageing fallback** — `/_agent-native/poll?since=N` est interrogé toutes les 2 s
   lorsque SSE n'est pas disponible. Cela permet à la collaboration de fonctionner sur n'importe quel déploiement
   cible — y compris les fonctions sans serveur où se trouvent les connexions persistantes
   des invocations impossibles et différentes peuvent gérer différentes requêtes.
@@ -102,7 +102,7 @@ Les erreurs réseau utilisent un intervalle exponentiel avec gigue, plafonné à
 
 ```an-diagram title="Deux chemins d'édition, un de fusion" summary="Les frappes humaines circulent Y.Doc → serveur → SSE. Les modifications de l'agent passent par SQL : l'action est déplacée vers updateAt, le client principal se réconcilie, puis la modification entre à nouveau dans Yjs."
 {
-  "html": "<div class=\"diagram-collab\"><div class=\"lane\"><span class=\"diagram-pill\">Human edit</span><div class=\"diagram-node\">Y.Doc update<br><small class=\"diagram-muted\">debounce ~80ms</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>POST /update<br><small class=\"diagram-muted\">apply + persist</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">SSE push<br><small class=\"diagram-muted\">to all peers</small></div></div><div class=\"lane\"><span class=\"diagram-pill warn\">Agent edit</span><div class=\"diagram-node\">Action writes SQL<br><small class=\"diagram-muted\">bumps updatedAt</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>Lead client<br><small class=\"diagram-muted\">setContent into Y.Doc</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">POST /update<br><small class=\"diagram-muted\">re-enters Yjs &middot; SSE push</small></div></div></div>",
+  "html": "<div class=\"diagram-collab\"><div class=\"lane\"><span class=\"diagram-pill\">Modification humaine</span><div class=\"diagram-node\">Y.Doc update<br><small class=\"diagram-muted\">debounce ~80 ms</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>POST /update<br><small class=\"diagram-muted\">apply + persist</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">SSE push<br><small class=\"diagram-muted\">to all peers</small></div></div><div class=\"lane\"><span class=\"diagram-pill warn\">Modification agent</span><div class=\"diagram-node\">L’action écrit SQL<br><small class=\"diagram-muted\">met à jour updatedAt</small></div><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\" data-rough>Client principal<br><small class=\"diagram-muted\">setContent dans Y.Doc</small></div><span class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box diagram-accent\">POST /update<br><small class=\"diagram-muted\">re-enters Yjs &middot; SSE push</small></div></div></div>",
   "css": ".diagram-collab{display:flex;flex-direction:column;gap:14px}.diagram-collab .lane{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-collab .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -227,7 +227,7 @@ Les modèles peuvent ajouter un système de commentaires avec des discussions en
 - Barre latérale des commentaires avec vue en fil de discussion et réponse UI
 - Résoudre/annuler la résolution des threads
 - Bouton **Envoyer à AI** : envoie le contexte du fil de commentaires au chat de l'agent via `sendToAgentChat()`
-- Agent actions : `list-comments`, `add-comment`
+- Action d’agents : `list-comments`, `add-comment`
 - Synchronisation des commentaires Notion : action `sync-notion-comments` pour tirer/pousser bidirectionnel
 
 ## Itinéraires de collaboration {#collab-routes}
@@ -248,13 +248,13 @@ Toutes les routes de collaboration sont montées automatiquement sous `/_agent-n
 L'action `edit-document` du modèle de contenu est le principal moyen utilisé par les agents pour apporter des modifications aux documents en mode collaboratif :
 
 ```bash
-# Single edit
+# Modification unique
 pnpm action edit-document --id doc123 --find "old text" --replace "new text"
 
-# Batch edits
+# Modifications par lots
 pnpm action edit-document --id doc123 --edits '[{"find":"old","replace":"new"}]'
 
-# Delete text
+# Supprimer le texte
 pnpm action edit-document --id doc123 --find "delete me" --replace ""
 ```
 
@@ -625,7 +625,7 @@ Propriétés clés :
 ```an-callout
 {
   "tone": "risk",
-  "body": "**Same-region simultaneous rewrite is last-write-wins.** If the agent rewrites a passage while a human has unsaved edits in the *exact same region*, the lead-client snapshot can clobber the in-flight human edit. Edits in different regions always merge cleanly via the CRDT. For structured documents, use granular server-side merge to sidestep this entirely."
+  "body": "**La réécriture simultanée dans la même région est la dernière écriture gagnante.** Si l'agent réécrit un passage alors qu'un humain a des modifications non enregistrées dans *exactement la même région*, l'instantané du client principal peut entraver la modification humaine en vol. Les modifications dans différentes régions fusionnent toujours proprement via le CRDT. Pour les documents structurés, utilisez la fusion granulaire côté serveur pour éviter complètement cela."
 }
 ```
 

package/docs/content/locales/fr-FR/recurring-jobs.md

@@ -17,12 +17,12 @@ Les tâches sont en direct dans le [workspace](/docs/workspace) sur `jobs/<name>
 {
   "filename": "jobs/morning-digest.md",
   "language": "markdown",
-  "code": "---\nschedule: \"0 7 * * *\"\nenabled: true\nrunAs: creator\n---\n\n# Morning digest\n\nSummarize the emails received overnight. Group by sender domain.\nPin the top 3 threads that look like they need a reply today to the\n\"Needs reply\" label. Draft replies for any that are obvious.",
+  "code": "---\nschedule: \"0 7 * * *\"\nenabled: true\nrunAs: creator\n---\n\n# Résumé du matin\n\nSummarize les e-mails reçus pendant la nuit. Regroupez par domaine d'expéditeur.\nPin les trois principaux sujets qui semblent avoir besoin d'une réponse aujourd'hui au libellé\n\"Réponse nécessaire\". Rédigez des réponses pour celles qui sont évidentes.",
   "annotations": [
-    { "lines": "2", "label": "When", "note": "Standard 5-field cron — `0 7 * * *` is every day at 07:00." },
-    { "lines": "3", "label": "Pause switch", "note": "Flip to `false` to stop the job without deleting it." },
-    { "lines": "4", "label": "Identity", "note": "`creator` runs with the owner's identity and `ANTHROPIC_API_KEY`; `shared` uses the org's key." },
-    { "lines": "7-12", "label": "The prompt", "note": "The body is just a prompt — the agent runs it at each firing with all its normal tools and workspace context." }
+    { "lines": "2", "label": "Quand", "note": "Cron standard à 5 champs — `0 7 * * *` est tous les jours à 07h00." },
+    { "lines": "3", "label": "Bouton pause", "note": "Flip to `false` to stop the job without deleting it." },
+    { "lines": "4", "label": "Identité", "note": "`creator` runs with the owner's identity and `ANTHROPIC_API_KEY`; `shared` uses the org's key." },
+    { "lines": "7-12", "label": "L'invite", "note": "Le corps n'est qu'une invite : l'agent l'exécute à chaque déclenchement avec tous ses outils et son contexte d'espace de travail normaux." }
   ]
 }
 ```

package/docs/content/locales/fr-FR/routing.md

@@ -23,7 +23,7 @@ Préfixez un segment avec `$` pour un paramètre dynamique. Préfixez `_` pour e
 
 ```an-diagram title="La mise en page sans chemin enveloppe les pages" summary="Une disposition _app.tsx (pas de segment URL) restitue le shell partagé une fois ; les pages correspondantes s'affichent dans son <Outlet/>, de sorte que la barre latérale de l'agent ne remonte jamais lors de la navigation."
 {
-"html": "<div class=\"diagram-layout\" data-rough><div class=\"diagram-shell\"><span class=\"diagram-pill accent\">_app.tsx</span><small class=\"diagram-muted\">pathless layout · persistent shell + agent sidebar</small><div class=\"diagram-outlet\" data-rough><small class=\"diagram-muted\">&lt;Outlet/&gt; — the matched page</small><div class=\"diagram-row\"><span class=\"diagram-pill\">_index.tsx &rarr; /</span><span class=\"diagram-pill\">settings.tsx &rarr; /settings</span><span class=\"diagram-pill\">inbox.$threadId.tsx &rarr; /inbox/:threadId</span></div></div></div></div>",
+"html": "<div class=\"diagram-layout\" data-rough><div class=\"diagram-shell\"><span class=\"diagram-pill accent\">_app.tsx</span><small class=\"diagram-muted\">layout sans chemin · shell persistant + barre agent</small><div class=\"diagram-outlet\" data-rough><small class=\"diagram-muted\">&lt;Outlet/&gt; — the matched page</small><div class=\"diagram-row\"><span class=\"diagram-pill\">_index.tsx &rarr; /</span><span class=\"diagram-pill\">settings.tsx &rarr; /settings</span><span class=\"diagram-pill\">inbox.$threadId.tsx &rarr; /inbox/:threadId</span></div></div></div></div>",
 "css": ".diagram-layout .diagram-shell{display:flex;flex-direction:column;gap:8px;padding:16px}.diagram-layout .diagram-outlet{display:flex;flex-direction:column;gap:8px;padding:14px;margin-top:6px}.diagram-layout .diagram-row{display:flex;flex-wrap:wrap;gap:8px;margin-top:4px}"
 }
 

package/docs/content/locales/fr-FR/sandbox-adapters.md

@@ -42,7 +42,7 @@ En gardant le contrat étroit, un adaptateur distant hérite de la même posture
 
 ```an-diagram title="Le parent garde les secrets ; l'adaptateur exécute uniquement du code" summary="run-code construit le module et exécute le pont de bouclage ; l'adaptateur reçoit un module non secret + limites et renvoie stdout/stderr/exit."
 {
-  "html": "<div class=\"diagram-sandbox\"><div class=\"diagram-box\" data-rough><strong>Parent process</strong><small class=\"diagram-muted\">builds module · loopback bridge · env scrub · output format</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">non-secret module + limits &rarr;</div><div class=\"diagram-pill ok\">&larr; stdout / stderr / exitCode</div><div class=\"diagram-pill\">&harr; bridge calls (127.0.0.1)</div></div><div class=\"diagram-panel center\" data-rough><strong>SandboxAdapter.run</strong><small class=\"diagram-muted\">local child · Docker · remote · durable</small></div></div>",
+  "html": "<div class=\"diagram-sandbox\"><div class=\"diagram-box\" data-rough><strong>Processus parent</strong><small class=\"diagram-muted\">construit le module · pont loopback · nettoyage env · format de sortie</small></div><div class=\"diagram-col\"><div class=\"diagram-pill accent\">non-secret module + limits &rarr;</div><div class=\"diagram-pill ok\">&larr; stdout / stderr / exitCode</div><div class=\"diagram-pill\">&harr; bridge calls (127.0.0.1)</div></div><div class=\"diagram-panel center\" data-rough><strong>SandboxAdapter.run</strong><small class=\"diagram-muted\">processus enfant local · Docker · distant · durable</small></div></div>",
   "css": ".diagram-sandbox{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sandbox .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-sandbox .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
 }
 ```
@@ -135,7 +135,7 @@ registerSandboxAdapter(adapter)  →  AGENT_NATIVE_SANDBOX  →  local default
 Sélectionne un adaptateur intégré par identifiant. Actuellement, seul le `local` (valeur par défaut) est câblé ; les valeurs inconnues reviennent au niveau local plutôt que d'échouer l'exécution.
 
 ```bash
-AGENT_NATIVE_SANDBOX=local   # the default — explicit
+AGENT_NATIVE_SANDBOX=local   # la valeur par défaut - explicite
 ```
 
 ### `registerSandboxAdapter()` {#register}

package/docs/content/locales/fr-FR/security.md

@@ -11,7 +11,7 @@ Les applications natives d'agent sont conçues pour être sécurisées par défa
 
 ```an-diagram title="Défense en couches" summary="Le framework possède la majeure partie de la surface des menaces ; vous possédez deux choses : le marquage des tables pour la portée et la validation des entrées externes."
 {
-  "html": "<div class=\"sec-layers\"><div class=\"diagram-card free\"><span class=\"diagram-pill ok\">Framework owns</span><small class=\"diagram-muted\">SQL isolation &middot; parameterized queries &middot; XSS escaping &middot; auth guard &middot; CSRF cookies &middot; secret encryption</small></div><div class=\"diagram-card you\"><span class=\"diagram-pill warn\">You own</span><small class=\"diagram-muted\">A. tag tables with ownableColumns() &amp; route through access guards<br>B. give every action a Zod schema &amp; send user URLs through the SSRF guard</small></div></div>",
+  "html": "<div class=\"sec-layers\"><div class=\"diagram-card free\"><span class=\"diagram-pill ok\">Possédé par le framework</span><small class=\"diagram-muted\">SQL isolation &middot; parameterized queries &middot; XSS escaping &middot; auth guard &middot; CSRF cookies &middot; secret encryption</small></div><div class=\"diagram-card you\"><span class=\"diagram-pill warn\">Vous en gardez le contrôle</span><small class=\"diagram-muted\">A. tag tables with ownableColumns() &amp; route through access guards<br>B. give every action a Zod schema &amp; send user URLs through the SSRF guard</small></div></div>",
   "css": ".sec-layers{display:flex;flex-direction:column;gap:12px}.sec-layers .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px}"
 }
 ```
@@ -86,7 +86,7 @@ await exec(`INSERT INTO notes (title) VALUES ('${title}')`);
 ```an-callout
 {
   "tone": "risk",
-  "body": "Never build SQL by string concatenation or template literals. Pass user input as `args` to `exec` / `db-query`, or use Drizzle — both always parameterize. The `pnpm guards` checks catch unscoped and concatenated queries at CI time."
+  "body": "Ne construisez jamais SQL par concaténation de chaînes ou par littéraux de modèle. Transmettez l'entrée utilisateur comme `args` à `exec` / `db-query`, ou utilisez Drizzle - les deux sont toujours paramétrés. Les vérifications `pnpm guards` détectent les requêtes non ciblées et concaténées au moment CI."
 }
 ```
 
@@ -125,7 +125,7 @@ session.orgId → AGENT_ORG_ID → SQL row scoping
 
 ```an-diagram title="Le pipeline de cadrage" summary="L'agent SQL ne touche jamais directement les tables de base : il lit une vue temporaire limitée à l'identité actuelle, de sorte qu'un nom de table nu ne peut renvoyer que les lignes possédées."
 {
-  "html": "<div class=\"scope-pipe\"><div class=\"diagram-node\">Signed-in session<br><small class=\"diagram-muted\">email &middot; orgId</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Request context<br><small class=\"diagram-muted\">AGENT_ORG_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Temporary VIEW<br><small class=\"diagram-muted\">WHERE owner_email = ? AND org_id = ?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">Agent SQL<br><small class=\"diagram-muted\">bare table names only</small></div></div>",
+  "html": "<div class=\"scope-pipe\"><div class=\"diagram-node\">Session connectée<br><small class=\"diagram-muted\">email &middot; orgId</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Request context<br><small class=\"diagram-muted\">AGENT_ORG_ID</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Temporary VIEW<br><small class=\"diagram-muted\">WHERE owner_email = ? AND org_id = ?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node ok\">SQL de l’agent<br><small class=\"diagram-muted\">bare table names only</small></div></div>",
   "css": ".scope-pipe{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.scope-pipe .diagram-node{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.scope-pipe .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -189,7 +189,7 @@ export const projects = table("projects", {
 });
 ```
 
-```an-schema title="What ownableColumns() adds" summary="The three columns that make a table tenant-aware and shareable."
+```an-schema title="What ownableColumns() adds" summary="Les trois colonnes qui rendent une table sensible aux locataires et partageable."
 {
   "entities": [
     {
@@ -198,8 +198,8 @@ export const projects = table("projects", {
       "note": "Any table that spreads ...ownableColumns()",
       "fields": [
         { "name": "owner_email", "type": "text", "nullable": false, "note": "Creator. Auto-filled by write actions; auto-injected on INSERT." },
-        { "name": "org_id", "type": "text", "nullable": true, "note": "Owner's active org at creation. Drives org-visibility checks." },
-        { "name": "visibility", "type": "enum", "nullable": false, "note": "private | org | public — coarse default, defaults to private." }
+        { "name": "org_id", "type": "text", "nullable": true, "note": "Organisation active du propriétaire au moment de la création. Pilote les contrôles de visibilité de l’organisation." },
+        { "name": "visibility", "type": "enum", "nullable": false, "note": "privé | org | public – valeur par défaut grossière, par défaut privée." }
       ]
     }
   ]
@@ -219,8 +219,8 @@ Les tables créées avec `ownableColumns()` nécessitent ces lectures et écritu
 ### Validation
 
 ```bash
-pnpm action db-check-scoping           # Check all tables have owner_email
-pnpm action db-check-scoping --require-org  # Also require org_id
+pnpm action db-check-scoping           # Vérifiez que toutes les tables ont le propriétaire_email
+pnpm action db-check-scoping --require-org  # Nécessite également org_id
 ```
 
 ## Gestion des secrets {#secrets}

package/docs/content/locales/fr-FR/server.md

@@ -9,7 +9,7 @@ Les applications natives d'agent utilisent [Nitro](https://nitro.build) pour les
 
 ```an-diagram title="Ce qui s'exécute sur le serveur" summary="Les actions sont la valeur par défaut. Les routes de fichiers personnalisées et les routes montées sur le framework partagent la même application Nitro et la même base de données SQL."
 {
-  "html": "<div class=\"diagram-server\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">Navigateur / UI</div><div class=\"diagram-node\">boucle agent</div><div class=\"diagram-node\">clients externes<br><small class=\"diagram-muted\">HTTP · MCP · A2A</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>serveur Nitro</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">surface par défaut</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">/_agent-native/*</span><small class=\"diagram-muted\">framework routes</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">/api/*</span><small class=\"diagram-muted\">custom file routes</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">plugins</span><small class=\"diagram-muted\">startup: migrations, jobs</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>base de données SQL<br><small class=\"diagram-muted\">Drizzle · the coordination point</small></div></div>",
+  "html": "<div class=\"diagram-server\"><div class=\"diagram-col entry\"><div class=\"diagram-node\">Navigateur / UI</div><div class=\"diagram-node\">boucle agent</div><div class=\"diagram-node\">clients externes<br><small class=\"diagram-muted\">HTTP · MCP · A2A</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>serveur Nitro</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">surface par défaut</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">/_agent-native/*</span><small class=\"diagram-muted\">framework routes</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">/api/*</span><small class=\"diagram-muted\">custom file routes</small></div><div class=\"diagram-row\"><span class=\"diagram-pill\">plugins</span><small class=\"diagram-muted\">démarrage : migrations, jobs</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>base de données SQL<br><small class=\"diagram-muted\">Drizzle · point de coordination</small></div></div>",
   "css": ".diagram-server{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-server .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-server .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 16px}.diagram-server .diagram-row{display:flex;align-items:center;gap:8px}.diagram-server .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -111,17 +111,17 @@ Actions monté par le framework s'exécute automatiquement avec le contexte de l
   "annotations": [
     {
       "lines": "7-10",
-      "label": "Custom routes have no auto-context",
-      "note": "Unlike actions, a file route must load the session itself and fail closed when there is no authenticated user."
+      "label": "Les itinéraires personnalisés n'ont pas de contexte automatique",
+      "note": "Contrairement aux actions, une route de fichiers doit charger la session elle-même et échouer lorsqu'il n'y a aucun utilisateur authentifié."
     },
     {
       "lines": "12-13",
-      "label": "Establish request context",
-      "note": "`runWithRequestContext` makes the user/org available to scoping helpers for the duration of the work."
+      "label": "Établir le contexte de la demande",
+      "note": "`runWithRequestContext` met l'utilisateur et l'organisation à disposition des aides de portée pendant toute la durée du travail."
     },
     {
       "lines": "18-19",
-      "label": "Scope ownable reads",
+      "label": "Lectures appartenant à la portée",
       "note": "`accessFilter` constrains the query to rows the caller may see. Never run an unscoped `db.select().from(ownableTable)` here."
     }
   ]
@@ -185,16 +185,16 @@ Cela fonctionne dans les déploiements sans serveur et multi-instances, car la b
 
 ```an-diagram title="Boucle de synchronisation SQL-backed" summary="Pas d'observateurs, pas d'état collant. Une écriture modifie une version dans SQL ; chaque client interroge la version et la récupère."
 {
-  "html": "<div class=\"diagram-sync\"><div class=\"diagram-box\" data-rough>Action / helper<br><small class=\"diagram-muted\">mutates data</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>base de données SQL</strong><small class=\"diagram-muted\">sync version increments</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">useDbSync()<br><small class=\"diagram-muted\">polls /_agent-native/poll</small></div><div class=\"diagram-pill ok\">invalidate caches &rarr; UI refreshes</div></div></div>",
+  "html": "<div class=\"diagram-sync\"><div class=\"diagram-box\" data-rough>Action / assistant<br><small class=\"diagram-muted\">mutates data</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>base de données SQL</strong><small class=\"diagram-muted\">sync version increments</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">useDbSync()<br><small class=\"diagram-muted\">polls /_agent-native/poll</small></div><div class=\"diagram-pill ok\">invalidate caches &rarr; UI refreshes</div></div></div>",
   "css": ".diagram-sync{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sync .diagram-col{display:flex;flex-direction:column;gap:8px;align-items:flex-start}.diagram-sync .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
 
-```an-api title="The poll endpoint" method="GET" path="/_agent-native/poll"
+```an-api title="Le point final du sondage" method="GET" path="/_agent-native/poll"
 {
   "method": "GET",
   "path": "/_agent-native/poll",
-  "summary": "Return the current per-source database sync versions so the client can detect changes.",
+  "summary": "Renvoie les versions actuelles de synchronisation de la base de données par source afin que le client puisse détecter les modifications.",
   "description": "`useDbSync()` calls this on an interval (and falls back to it when SSE is unavailable). When a returned version is higher than the client's last-seen value, the matching React Query caches are invalidated and refetch.",
   "auth": "Session cookie (request-scoped identity)",
   "responses": [
@@ -215,7 +215,7 @@ Le webhooks entrant doit être vérifié, conservé et renvoyé rapidement. Le t
 
 ```an-diagram title="Modèle de file d'attente d'intégration" summary="Le gestionnaire de webhook renvoie en millisecondes ; une exécution signée distincte exécute le travail lent de l'agent."
 {
-  "html": "<div class=\"diagram-webhook\"><div class=\"diagram-box\" data-rough>Inbound webhook<br><small class=\"diagram-muted\">Slack · Stripe · email</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>Handler</strong><div class=\"diagram-step\"><span class=\"diagram-pill\">1</span><small class=\"diagram-muted\">verify signature</small></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><small class=\"diagram-muted\">insert work into SQL</small></div><div class=\"diagram-step\"><span class=\"diagram-pill\">3</span><small class=\"diagram-muted\">self-fire processor</small></div><div class=\"diagram-step\"><span class=\"diagram-pill ok\">4</span><small class=\"diagram-muted\">return 200 now</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Signed processor<br><small class=\"diagram-muted\">runs agent loop, posts result</small></div></div>",
+  "html": "<div class=\"diagram-webhook\"><div class=\"diagram-box\" data-rough>Webhook entrant<br><small class=\"diagram-muted\">Slack · Stripe · email</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel\" data-rough><strong>Handler</strong><div class=\"diagram-step\"><span class=\"diagram-pill\">1</span><small class=\"diagram-muted\">verify signature</small></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><small class=\"diagram-muted\">insère le travail dans SQL</small></div><div class=\"diagram-step\"><span class=\"diagram-pill\">3</span><small class=\"diagram-muted\">self-fire processor</small></div><div class=\"diagram-step\"><span class=\"diagram-pill ok\">4</span><small class=\"diagram-muted\">return 200 now</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Signed processor<br><small class=\"diagram-muted\">exécute la boucle agent et publie le résultat</small></div></div>",
   "css": ".diagram-webhook{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-webhook .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:14px 16px}.diagram-webhook .diagram-step{display:flex;align-items:center;gap:8px}.diagram-webhook .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```

package/docs/content/locales/fr-FR/sharing.md

@@ -74,7 +74,7 @@ Chaque ressource partageable reçoit un bouton de partage dans son en-tête. Cli
 
 - Sélecteur de visibilité (`Private` / `Organization` / `Public link`).
 - Saisie automatique « Ajouter des personnes ou des équipes » : recherchez des utilisateurs dans l'organisation ou collez un e-mail.
-- Une case à cocher `Notify people` de style Google Docs pour les autorisations individuelles par e-mail.
+- Une case à cocher `Notifier people` de style Google Docs pour les autorisations individuelles par e-mail.
 - Une liste des subventions actuelles avec des sélecteurs de rôles et un contrôle de suppression.
 - Un bouton copier-lien qui respecte la visibilité actuelle.
 
@@ -127,7 +127,7 @@ export const decks = table("decks", {
 export const deckShares = createSharesTable("deck_shares");
 ```
 
-```an-schema title="Resource + companion shares table" summary="Coarse visibility lives on the resource; each fine-grained grant is a row in the shares table."
+```an-schema title="Tableau des partages de ressources et de compagnons" summary="Coarse visibility lives on the resource; each fine-grained grant is a row in the shares table."
 {
   "entities": [
     {
@@ -137,9 +137,9 @@ export const deckShares = createSharesTable("deck_shares");
       "fields": [
         { "name": "id", "type": "text", "pk": true },
         { "name": "title", "type": "text", "nullable": false },
-        { "name": "owner_email", "type": "text", "nullable": false, "note": "The single source of truth for ownership." },
+        { "name": "owner_email", "type": "text", "nullable": false, "note": "La seule source de vérité pour la propriété." },
         { "name": "org_id", "type": "text", "nullable": true },
-        { "name": "visibility", "type": "enum", "nullable": false, "note": "private | org | public" }
+        { "name": "visibility", "type": "enum", "nullable": false, "note": "privé | org | publique" }
       ]
     },
     {
@@ -149,9 +149,9 @@ export const deckShares = createSharesTable("deck_shares");
       "fields": [
         { "name": "id", "type": "text", "pk": true },
         { "name": "resource_id", "type": "text", "fk": "decks.id", "nullable": false },
-        { "name": "principal_type", "type": "enum", "note": "user | org" },
+        { "name": "principal_type", "type": "enum", "note": "utilisateur | org" },
         { "name": "principal_id", "type": "text", "note": "email (user) or org id (org)" },
-        { "name": "role", "type": "enum", "note": "viewer | editor | admin" },
+        { "name": "role", "type": "enum", "note": "spectateur | éditeur | administrateur" },
         { "name": "created_by", "type": "text" },
         { "name": "created_at", "type": "text" }
       ]

package/docs/content/locales/fr-FR/skills-guide.md

@@ -15,7 +15,7 @@ Les éléments `name` et `description` de chaque compétence sont toujours injec
 
 ```an-diagram title="Divulgation progressive" summary="Seul le nom + la description de chaque compétence est toujours en contexte. Le corps entier se charge à la demande lorsque la tâche correspond."
 {
-  "html": "<div class=\"sk-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Always in the system prompt</span><div class=\"sk-list\"><span class=\"diagram-pill\">storing-data &mdash; <small class=\"diagram-muted\">add data models&hellip;</small></span><span class=\"diagram-pill\">real-time-sync &mdash; <small class=\"diagram-muted\">wire polling&hellip;</small></span><span class=\"diagram-pill\">create-skill &mdash; <small class=\"diagram-muted\">add a skill&hellip;</small></span></div><small class=\"diagram-muted\">just name + description (cheap)</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><small class=\"diagram-muted\">task matches a description</small><span class=\"diagram-pill accent\">load on demand</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Full <code>SKILL.md</code> body<br><small class=\"diagram-muted\">rules, code, do/don't</small></div></div>",
+  "html": "<div class=\"sk-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Toujours dans le prompt système</span><div class=\"sk-list\"><span class=\"diagram-pill\">storing-data &mdash; <small class=\"diagram-muted\">add data models&hellip;</small></span><span class=\"diagram-pill\">real-time-sync &mdash; <small class=\"diagram-muted\">wire polling&hellip;</small></span><span class=\"diagram-pill\">create-skill &mdash; <small class=\"diagram-muted\">add a skill&hellip;</small></span></div><small class=\"diagram-muted\">just name + description (cheap)</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><small class=\"diagram-muted\">task matches a description</small><span class=\"diagram-pill accent\">load on demand</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Full <code>SKILL.md</code> body<br><small class=\"diagram-muted\">règles, code, à faire / à éviter</small></div></div>",
   "css": ".sk-flow{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.sk-flow .diagram-card{display:flex;flex-direction:column;gap:8px;padding:14px 16px;min-width:240px}.sk-flow .sk-list{display:flex;flex-direction:column;gap:6px}.sk-flow .center{display:flex;flex-direction:column;align-items:center;gap:6px}.sk-flow .diagram-arrow{font-size:22px}"
 }
 ```
@@ -86,10 +86,10 @@ Chaque compétence est un fichier Markdown avec le thème principal YAML :
   "language": "markdown",
   "code": "---\nname: project-imports\ndescription: >-\n  How to import projects from the legacy CSV export. Use when the user uploads\n  a project CSV or asks to migrate projects from the old system.\n---\n\n# Project Imports\n\n## Rule\n\nAlways validate the CSV header row before writing any rows. Reject unknown\ncolumns rather than silently dropping them.\n\n## How\n\n1. Call `get-import-schema` to fetch the expected columns.\n2. Parse the first CSV row and diff against the schema.\n3. If any required columns are missing, return an error — do not proceed.\n4. Stream remaining rows through `create-project-item` in batches of 50.\n\n## Don't\n\n- Don't hold all rows in memory — stream them.\n- Don't create duplicate projects; check for an existing name first.\n\n## Related Skills\n\n- **storing-data** — SQL schema and write patterns for new rows\n- **sharing** — exposing a project to other users after import",
   "annotations": [
-    { "lines": "2", "label": "Discovery key", "note": "The `name` matches the folder; it is how the skill is invoked as `/project-imports`." },
-    { "lines": "3-5", "label": "The trigger", "note": "This `description` is the **only** text always in context. Make it state precisely *when* the skill applies." },
-    { "lines": "9-14", "label": "Rules first", "note": "Lead with the hard rule and the why; the agent reads the body only once the task matches." },
-    { "lines": "27-30", "label": "Cross-link", "note": "Point at related skills so the agent can chain them instead of re-deriving guidance." }
+    { "lines": "2", "label": "Clé de découverte", "note": "The `name` matches the folder; it is how the skill is invoked as `/project-imports`." },
+    { "lines": "3-5", "label": "Le déclencheur", "note": "Ce `description` est le **seul** texte toujours en contexte. Faites-le indiquer précisément *quand* la compétence s'applique." },
+    { "lines": "9-14", "label": "Les règles d'abord", "note": "Commencez par la règle stricte et le pourquoi ; l’agent ne lit le corps que lorsque la tâche correspond." },
+    { "lines": "27-30", "label": "Lien croisé", "note": "Pointez sur les compétences associées afin que l'agent puisse les enchaîner au lieu de rediriger les conseils." }
   ]
 }
 ```
@@ -132,7 +132,7 @@ Cela remplace l'ancien hack consistant à s'appuyer sur le code Claude lisant un
 
 ```an-diagram title="Quel agent charge quelle compétence" summary="scope décide si l'agent d'exécution intégré à l'application voit une compétence. Les compétences dev sont visibles uniquement par votre agent de codage."
 {
-"html": "<div class=\"sc-grid\"><div class=\"diagram-card\"><span class=\"diagram-pill\">.agents/skills/</span><div class=\"sc-row\"><span class=\"diagram-pill ok\">scope: both</span><small class=\"diagram-muted\">default</small></div><div class=\"sc-row\"><span class=\"diagram-pill ok\">scope: runtime</span></div><div class=\"sc-row\"><span class=\"diagram-pill warn\">scope: dev</span></div></div><div class=\"sc-targets\"><div class=\"diagram-box\">Runtime agent<br><small class=\"diagram-muted\">reads <code>both</code> + <code>runtime</code></small></div><div class=\"diagram-box\">Coding agent<br><small class=\"diagram-muted\">Claude Code reads <code>.claude/skills/</code> + <code>dev</code></small></div></div></div>",
+"html": "<div class=\"sc-grid\"><div class=\"diagram-card\"><span class=\"diagram-pill\">.agents/skills/</span><div class=\"sc-row\"><span class=\"diagram-pill ok\">scope: both</span><small class=\"diagram-muted\">default</small></div><div class=\"sc-row\"><span class=\"diagram-pill ok\">scope: runtime</span></div><div class=\"sc-row\"><span class=\"diagram-pill warn\">scope: dev</span></div></div><div class=\"sc-targets\"><div class=\"diagram-box\">Runtime agent<br><small class=\"diagram-muted\">reads <code>both</code> + <code>runtime</code></small></div><div class=\"diagram-box\">Agent de code<br><small class=\"diagram-muted\">Claude Code reads <code>.claude/skills/</code> + <code>dev</code></small></div></div></div>",
 "css": ".sc-grid{display:flex;gap:24px;flex-wrap:wrap;align-items:flex-start}.sc-grid .diagram-card{display:flex;flex-direction:column;gap:8px;padding:14px 16px}.sc-grid .sc-row{display:flex;align-items:center;gap:8px}.sc-grid .sc-targets{display:flex;flex-direction:column;gap:10px}"
 }
 
@@ -199,30 +199,30 @@ Hosted est le chemin d’installation par défaut. Le lancement local est explic
 travail hors ligne ou utilisation sensible à la confidentialité.
 
 ```bash
-# Happy path: exported instructions plus hosted MCP connector.
+# Chemin heureux : instructions exportées et connecteur MCP hébergé.
 npx @agent-native/core@latest skills add visual-plan
 npx @agent-native/core@latest skills add assets
 
-# Repo-first Content docs/blog/MDX editing.
+# Édition docs/blog/MDX avec Content, d'abord dans le dépôt.
 npx @agent-native/core@latest skills add content --mode local-files --scope project
 
-# Vercel/open Skills CLI: exported instructions only, no MCP config.
+# Compétences Vercel/open CLI : instructions exportées uniquement, pas de configuration MCP.
 npx skills@latest add BuilderIO/agent-native --skill assets
 
-# Register a hosted MCP connector for local agent clients.
+# Enregistrez un connecteur MCP hébergé pour les clients d'agent locaux.
 npx @agent-native/core@latest app-skill ensure --manifest templates/assets/agent-native.app-skill.json
 
-# Materialize and run editable local source.
+# Matérialisez et exécutez une source locale modifiable.
 npx @agent-native/core@latest app-skill launch --manifest templates/assets/agent-native.app-skill.json --local --into ./assets-local
 
-# Build marketplace adapters: Codex plugin, Claude marketplace, Vercel skills,
-# plain/Claude skills, and MCP configs.
+# Créez des adaptateurs de marché : plugin Codex, compétences Claude marketplace, Vercel,
+# Compétences plain/Claude et configurations MCP.
 npx @agent-native/core@latest app-skill pack --manifest templates/assets/agent-native.app-skill.json --out ./dist/assets-skill
 
-# Install a local exported bundle with the Vercel/open Skills CLI.
+# Installez un bundle exporté local avec les compétences Vercel/open CLI.
 npx skills@latest add ./dist/assets-skill --skill assets -a codex -y
 
-# Add the generated Claude Code marketplace, then install its Assets plugin.
+# Ajoutez la place de marché Claude Code générée, puis installez son plugin Assets.
 claude plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace
 claude plugin install agent-native-assets@agent-native-apps
 ```
@@ -272,7 +272,7 @@ espace de travail). Actualisez ces skills échafaudés à partir du CLI actuel/d
 
 ```bash
 npm run skills:update
-# or, without relying on the local package script:
+# ou, sans compter sur le script du package local :
 npx @agent-native/core@latest skills update scaffold --project
 ```
 

package/docs/content/locales/fr-FR/template-analytics.md

@@ -10,7 +10,7 @@ Posez des questions d'analyse dans un anglais simple, récupérez des graphiques
 ```an-wireframe
 {
   "surface": "desktop",
-  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:500px;box-sizing:border-box'><h1 style='margin:0'>Agent-Native Templates</h1><p class='wf-muted' style='margin:0'>Adoption and engagement across the last 12 weeks.</p><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:12px'><div class='wf-card'><small class='wf-muted'>Weekly active users</small><br/><strong>24,318</strong><br/><span class='wf-pill accent'>+12.4%</span></div><div class='wf-card'><small class='wf-muted'>New signups</small><br/><strong>1,842</strong><br/><span class='wf-pill accent'>+8.7%</span></div><div class='wf-card'><small class='wf-muted'>Revenue MRR</small><br/><strong>$48,210</strong><br/><span class='wf-pill accent'>+21.3%</span></div></div><div style='display:grid;grid-template-columns:1fr 1fr;gap:12px;flex:1'><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Weekly active users</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:38%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:44%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:58%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:74%;flex:1;background:var(--wf-accent-soft)'></div></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Revenue over time</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:32%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:48%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:63%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:80%;flex:1;background:var(--wf-accent-soft)'></div></div></div></div><div class='wf-card'><strong>Signups by source</strong><br/><small class='wf-muted'>Lower chart begins below the main charts.</small></div></div>"
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:500px;box-sizing:border-box'><h1 style='margin:0'>Templates Agent-Native</h1><p class='wf-muted' style='margin:0'>Adoption et engagement sur les 12 dernières semaines.</p><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:12px'><div class='wf-card'><small class='wf-muted'>Utilisateurs actifs hebdomadaires</small><br/><strong>24,318</strong><br/><span class='wf-pill accent'>+12.4%</span></div><div class='wf-card'><small class='wf-muted'>Nouvelles inscriptions</small><br/><strong>1,842</strong><br/><span class='wf-pill accent'>+8.7%</span></div><div class='wf-card'><small class='wf-muted'>MRR de revenus</small><br/><strong>$48,210</strong><br/><span class='wf-pill accent'>+21.3%</span></div></div><div style='display:grid;grid-template-columns:1fr 1fr;gap:12px;flex:1'><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Utilisateurs actifs hebdomadaires</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:38%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:44%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:58%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:74%;flex:1;background:var(--wf-accent-soft)'></div></div></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Revenus dans le temps</strong><div style='flex:1;display:flex;align-items:end;gap:8px'><div style='height:32%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:48%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:63%;flex:1;background:var(--wf-accent-soft)'></div><div style='height:80%;flex:1;background:var(--wf-accent-soft)'></div></div></div></div><div class='wf-card'><strong>Inscriptions par source</strong><br/><small class='wf-muted'>Le graphique inférieur commence sous les graphiques principaux.</small></div></div>"
 }
 ```
 
@@ -18,7 +18,7 @@ Il s'agit d'un remplacement open source d'Amplitude, Mixpanel et Looker, destin
 
 ```an-diagram title="Question à tracer" summary="L'agent consulte le dictionnaire de données, écrit SQL, le valide par rapport à l'entrepôt, puis restitue un graphique ou enregistre un panneau."
 {
-  "html": "<div class=\"diagram-flow\"><div class=\"diagram-node\">Plain-English<br>question</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">reads data dictionary</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Writes SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill ok\">Dry-run validate</div><small class=\"diagram-muted\">BigQuery / source</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Chart, table, or<br>saved panel</div></div>",
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-node\">Langage simple<br>question</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Agent</span><small class=\"diagram-muted\">reads data dictionary</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Écrit du SQL</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-pill ok\">Valider en dry-run</div><small class=\"diagram-muted\">BigQuery / origine</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Graphique, tableau ou<br>saved panel</div></div>",
   "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:6px;align-items:center}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}"
 }
 ```
@@ -162,23 +162,23 @@ Le client de connexion à faible portée reste distinct des clients d'intégrati
 
 Tableaux de base (voir `templates/analytics/server/db/schema.ts`) :
 
-```an-schema title="Analytics data model" summary="Dashboards and analyses are the resources; views, shares, and a query cache hang off them. Org tables come from @agent-native/core/org."
+```an-schema title="Modèle de données Analytics" summary="Les dashboards et analyses sont les ressources ; vues, partages et cache de requêtes s’y rattachent. Les tables d’organisation viennent de @agent-native/core/org."
 {
   "entities": [
     {
       "id": "dashboards",
       "name": "dashboards",
-      "note": "Explorer and SQL dashboards",
+      "note": "Tableaux de bord Explorer et SQL",
       "fields": [
         { "name": "id", "type": "text", "pk": true },
         { "name": "kind", "type": "text", "note": "\"explorer\" or \"sql\"" },
-        { "name": "config", "type": "text", "note": "JSON matching SqlDashboardConfig" }
+        { "name": "config", "type": "text", "note": "JSON correspondant à SqlDashboardConfig" }
       ]
     },
     {
       "id": "dashboard_views",
       "name": "dashboard_views",
-      "note": "Saved filter presets per dashboard",
+      "note": "Préréglages de filtres enregistrés par tableau de bord",
       "fields": [
         { "name": "id", "type": "text", "pk": true },
         { "name": "dashboard_id", "type": "text", "fk": "dashboards.id" }
@@ -187,12 +187,12 @@ Tableaux de base (voir `templates/analytics/server/db/schema.ts`) :
     {
       "id": "analyses",
       "name": "analyses",
-      "note": "Re-runnable ad-hoc investigations",
+      "note": "Enquêtes ad hoc réexécutables",
       "fields": [
         { "name": "id", "type": "text", "pk": true },
         { "name": "question", "type": "text" },
-        { "name": "instructions", "type": "text", "note": "Re-run steps" },
-        { "name": "dataSources", "type": "text", "note": "Sources touched" },
+        { "name": "instructions", "type": "text", "note": "Réexécuter les étapes" },
+        { "name": "dataSources", "type": "text", "note": "Sources touchées" },
         { "name": "resultMarkdown", "type": "text" },
         { "name": "resultData", "type": "text", "nullable": true }
       ]
@@ -200,7 +200,7 @@ Tableaux de base (voir `templates/analytics/server/db/schema.ts`) :
     {
       "id": "bigquery_cache",
       "name": "bigquery_cache",
-      "note": "Result cache keyed by SQL hash",
+      "note": "Cache des résultats saisi par le hachage SQL",
       "fields": [
         { "name": "sql_hash", "type": "text", "pk": true },
         { "name": "bytes_processed", "type": "integer" }