feat(api,ai): #72 OpenAPI 3.1 enrichie + fiabilisation de l'outil AI UI

API (#72):
- backend/openapi_docs.py: 18 tags documentes, assignation auto par prefixe,
  securite bearerAuth/cookieAuth, erreurs 401/403/404/422/500, exemples,
  page /api autonome (liens /docs, /redoc, /openapi.json)
- backend/schemas.py: response_model Pydantic pour ~35 endpoints sans modele
- main.py: FastAPI enrichi + override app.openapi; routes /api et /api/
- ai_routes/bookslm_routes: response_model + doc SSE
- frontend: entree 'API' du menu (i18n FR/EN)
- tests/test_openapi.py (58 tests)

AI UI:
- BooksLM: requetes authentifiees (AuthManager), parsing SSE {token}/error,
  message utilisateur correct (plus le placeholder vide), barre de contexte
- AI Editor: Ctrl/Cmd+J lie une seule fois, libelles i18n, modale de
  reecriture accessible a la place de window.prompt()
- tests/frontend/ai.test.mjs (7 tests) + CI

docs/ROADMAP.md

@@ -767,8 +767,20 @@
   - Widgets temps réel via EventSource `/api/admin/stream` + snapshot `/api/admin/stats`
   - CRUD users + fix routing `/admin.html` + fix scroll
 
-### 72. API publique documentée — OpenAPI 3.1
-- **Effort :** 1-2 jours | **Impact :** 🟢
+### 72. API publique documentée — OpenAPI 3.1 ✅ TERMINÉ
+- **Effort :** 1-2 jours (réalisé) | **Impact :** 🟢 | **Statut :** ✅ Livré (2026-09-11)
+- **Implémentation réelle :**
+  - `backend/openapi_docs.py` — 18 tags documentés + assignation automatique par préfixe de route
+    (`tag_for_path`, `canonical_tag`), enrichissement du schéma (`enrich_openapi_schema` :
+    sécurité `bearerAuth`/`cookieAuth`, erreurs 401/403/404/422/500, exemples requête/réponse,
+    serveur, `externalDocs`), page `/api` autonome (`render_api_landing`).
+  - `backend/schemas.py` — `response_model` Pydantic pour ~35 endpoints qui n'en avaient pas.
+  - `backend/main.py` — `FastAPI(...)` enrichi (description Markdown, contact, licence, tags) +
+    override `app.openapi` ; routes `/api` et `/api/`.
+  - `backend/ai_routes.py` / `backend/bookslm_routes.py` — `response_model` (AI status, BooksLM
+    context) + documentation SSE.
+  - Frontend — entrée « API » du menu d'options (i18n FR/EN) ouvrant `/docs`.
+  - Tests — `tests/test_openapi.py` (58 tests) + `tests/frontend/ai.test.mjs` (7 tests).
 - **Description :** Une page de documentation interactive et auto-générée de toutes les API REST d'ObsiGate, accessible via un bouton dans l'interface. L'équivalent d'un manuel technique mais qui se teste en direct.
   - **OpenAPI 3.1** : c'est le format standard mondial pour décrire une API REST. Un seul fichier JSON/YAML contient la description de tous les endpoints, leurs paramètres, les formats de réponse, les codes d'erreur, et les modèles de données. Ce standard est supporté par des centaines d'outils.
   - **Swagger UI** : une interface web qui lit le fichier OpenAPI et génère automatiquement une documentation interactive. L'utilisateur voit chaque endpoint, peut remplir les paramètres dans un formulaire, cliquer « Execute » et voir la réponse réelle de l'API en direct. Parfait pour les développeurs qui veulent intégrer ObsiGate à leurs scripts ou comprendre comment fonctionne l'API.
@@ -781,12 +793,12 @@
   - **Auto-génération** : FastAPI génère déjà partiellement le schéma OpenAPI. Le travail consiste à compléter les docstrings manquantes, ajouter `response_model` sur les endpoints qui n'en ont pas, et enrichir avec des exemples.
 - **Pourquoi c'est important :** Une API sans documentation est comme un logiciel sans interface — techniquement fonctionnel mais inutilisable. Avec une doc OpenAPI, ObsiGate devient intégrable dans n'importe quel écosystème. Un développeur peut en 5 minutes comprendre comment uploader un fichier, chercher dans un vault, ou récupérer le contenu d'une note — et écrire un script qui automatise ses workflows.
 - **Sous-tâches :**
-  - [ ] Audit des endpoints existants → compléter les docstrings manquants
-  - [ ] Ajout de `response_model` sur tous les endpoints (40+ actuellement, ~15 sans modèle)
-  - [ ] Exemples dans les schémas : `examples=[...]` pour les endpoints clés
-  - [ ] Tagging des endpoints par catégorie (Files, Vaults, Search, Auth, AI, Backups)
-  - [ ] Serveur mock : `prism` ou `openapi-generator` pour tests sans backend
-  - [ ] Page de documentation intégrée : lien dans le menu header (« API »)
+  - [x] Audit des endpoints existants → compléter les docstrings manquants
+  - [x] Ajout de `response_model` sur tous les endpoints (40+ actuellement, ~15 sans modèle)
+  - [x] Exemples dans les schémas : `examples=[...]` pour les endpoints clés
+  - [x] Tagging des endpoints par catégorie (Files, Vaults, Search, Auth, AI, Backups)
+  - [ ] Serveur mock : `prism` ou `openapi-generator` pour tests sans backend — ⚪ NON RETENU (le schéma 3.1 est validé par `tests/test_openapi.py`)
+  - [x] Page de documentation intégrée : lien dans le menu header (« API »)
 
 ### 73. Synchronisation multi-appareils — Obsidian Sync compatible
 - **Effort :** 6-8 jours | **Impact :** 🟢
@@ -897,11 +909,11 @@
 
 | Priorité | Items | Effort total estimé |
 |---|---|---|
-| ✅ Complété | #1 → #59, #63-68, #71, #74, #75, #76, #78 (58 E2E, 59 offline, 63 i18n, 64 MFA TOTP+WebAuthn, 65 thèmes, 66 export, 67 push, 68 health, 71 admin, 74 PDF, 75 split view, 76 BooksLM, 78 Excalidraw) | ~80 jours réalisés |
+| ✅ Complété | #1 → #59, #63-68, #71, #72 (OpenAPI 3.1), #74, #75, #76, #78 (58 E2E, 59 offline, 63 i18n, 64 MFA TOTP+WebAuthn, 65 thèmes, 66 export, 67 push, 68 health, 71 admin, 72 OpenAPI, 74 PDF, 75 split view, 76 BooksLM, 78 Excalidraw) | ~82 jours réalisés |
 | 🔵 P2 restant | #77 Desktop : signature code (optionnel), wizard 1er lancement (optionnel), 6 tests E2E **manuels** | ~1-2 jours |
 | ⚪ P3 restant | #62 Collaboration Yjs (5-7j) | ~5-7 jours |
-| ⚪ P4 restant | #69 Mobile éditeur (2-3j) · #70 Sémantique (4-5j) · #72 OpenAPI (1-2j) · #73 Sync (6-8j) | 13-18 jours |
-| **Total restant** | **6 items + finitions** | **~19-27 jours** |
+| ⚪ P4 restant | #69 Mobile éditeur (2-3j) · #70 Sémantique (4-5j) · #73 Sync (6-8j) | 11-16 jours |
+| **Total restant** | **5 items + finitions** | **~17-25 jours** |
 
 #75 : E2E matriciels 37/37 verts (split-view.spec.js + split-view-matrix.spec.js) — 2026-09-08.
 
@@ -912,5 +924,5 @@
 - Les items P3/P4 ne sont pas ordonnés par priorité interne — à raffiner selon les retours utilisateurs.
 - L'effort inclut le développement + tests unitaires + intégration CI, mais pas la documentation utilisateur.
 - Les items marqués 🟢 (nice-to-have) sont de bons candidats pour des contributions externes.
-- #59 (hors-ligne), #63 (i18n), #64 (MFA), #65-66, #67-68, #71, #74-76, #78 sont livrés — les P3 restants à plus fort rapport effort/valeur : #72 (OpenAPI, 1-2j) et #62 (collaboration).
+- #59 (hors-ligne), #63 (i18n), #64 (MFA), #65-66, #67-68, #71, #72 (OpenAPI), #74-76, #78 sont livrés — les P3 restants à plus fort rapport effort/valeur : #62 (collaboration).
 - #78 est terminé (B5 recherche texte, C8 menu contextuel, F3 E2E, doc H1-H3) ; F2 non retenu. BUG-002 (loading infini Excalidraw) corrigé par les commits a4ea322/185d603.