feat(assistant): #94-#97 historique permanent, sidebar IA, panneau + et bouton rond
This commit is contained in:
@@ -203,6 +203,8 @@ Avant de corriger quoi que ce soit, un agent IA doit :
|
||||
| 2026-09-16 | #93 (complément) | Correction | `frontend/js/editor-inline.js`, `frontend/js/utils.js`, `frontend/js/viewer.js`, `frontend/js/ui.js`, `frontend/js/pane-manager.js`, `frontend/js/sync.js`, `tests/frontend/editor-inline.test.mjs`, `docs/features/editeur-inline.md`, `docs/CONTRIBUTING.md`, `CHANGELOG.md` | Garde-fous de **session d'édition inline** (#93) : l'activation d'un onglet (`TabManager.activate`, `PaneTabManager.activate`) appelle `detachInlineEditor()` avant de vider la zone de contenu, et l'événement SSE `index_updated` sur le fichier affiché recharge le **tampon de l'éditeur** (`reloadExternalWrite()`) au lieu de re-rendre la vue lecture — ces deux chemins détruisaient la session CodeMirror/Forge en cours. Nouveau helper `queryEditor()` (l'en-tête/pied/marque voyagent avec le conteneur en mode inline, `modal.querySelector()` les manquait) ; `closeEditor()` remet le conteneur dans la modale avant de restaurer en-tête/pied/marque. `docs/CONTRIBUTING.md` documente `scripts/install-hooks.sh` (hooks de versionnage) dans la mise en place d'un clone. Vérifié : validate-imports 38 modules, unit 9/9, suites JSDOM (editor-inline 25/25, pane-manager, mobile-editor 35/35, toolbar-order, ai 84/84, sw 8/8, collab 10/10, semantic-search 4/4, desktop 23, plugins 21, excalidraw-viewer) toutes vertes, pytest 1082 passed / 6 skipped. | 🟢 corrigé (en attente vérif utilisateur) |
|
||||
| 2026-09-16 | BUG-047 | Correction + build | `VERSION` (nouveau), `scripts/bump_version.py` (nouveau), `.githooks/prepare-commit-msg` + `.githooks/post-commit` (nouveaux), `scripts/install-hooks.sh` (nouveau), `scripts/bump_version.sh`, `backend/version.py`, `Dockerfile`, `docker-compose.yml`, `build.sh`, `.gitea/workflows/ci.yml`, `desktop/build.rs`, `package.json`, `README.md`, `README.fr.md`, `docs/ROADMAP.md`, `docs/DELIVERY_WORKFLOW.md`, `docs/DEVELOPMENT_AND_RELEASES.md`, `tests/test_version.py` (nouveau) | **Version alignée de bout en bout.** Cause : la version affichée venait du dernier **tag git** et aucun tag n'était créé aux livraisons → 66 commits livrés mais UI/API figées sur `2.2.1` ; quatre autres numéros codés en dur dérivaient (`package.json` 1.0.0, desktop 2.0.0, `Dockerfile` 2.2.1, README 1.7.0). Nouveau modèle : **`VERSION` (racine) = source unique de vérité** (`MAJEUR.MINEUR.CORRECTIF`), incrémentée **automatiquement au commit** par le hook versionné `prepare-commit-msg` (SemVer depuis le message : `!:`/`BREAKING CHANGE` → MAJEUR, `feat` → MINEUR, sinon CORRECTIF ; aucun bump pour merge/revert/`chore(release)`/amend) qui resynchronise `package.json`, desktop Tauri, ROADMAP, READMEs et publie la section `[Unreleased]` du CHANGELOG en `[X.Y.Z] — date` ; `post-commit` rattache ces fichiers au commit qui vient d'être créé (amend immédiat, le commit n'étant pas encore poussé) puis crée le tag `vX.Y.Z`, publié au push (`push.followTags`). `bump_version.py` (avec `--dry-run`, `--set`, `--major\|--minor\|--patch`, `--print-version`) reste utilisable à la main ; `scripts/install-hooks.sh` installe les hooks. Côté build : Docker `COPY VERSION` (plus d'`ARG VERSION` ni d'env compose codés en dur), `build.sh` et CI lisent `VERSION`, `desktop/build.rs` aussi. Vérifié : `tests/test_version.py` (46 tests, dont le garde-fou `TestRepoVersionAlignment` : VERSION ↔ package.json ↔ desktop ↔ CHANGELOG ↔ ROADMAP ↔ READMEs ↔ pipeline sans numéro codé en dur), pytest complet, ruff/mypy 0, `/api/health` → `2.3.0` sur l'instance de test reconstruite. | 🟢 corrigé (en attente vérif utilisateur) |
|
||||
|
||||
| 2026-09-16 | #94, #95, #96, #97 | Feature | `backend/ai_history.py` (nouveau), `backend/bookslm_routes.py`, `frontend/js/bookslm.js`, `frontend/js/config.js`, `frontend/index.html`, `frontend/style.css`, `frontend/locales/{fr,en}.json`, `tests/test_bookslm.py`, `tests/frontend/ai.test.mjs`, `docs/features/ai-assistant-history.md` (nouvelle), `docs/ROADMAP.md`, `CHANGELOG.md` | **Assistant IA** : #95 historique **permanent** (backend `data/ai_history/{user}.json`, cap 200, endpoints CRUD `/api/ai/bookslm/history[…]` résumés/full, sync frontend debounced 600 ms + repli localStorage + migration des clés legacy `bookslm-sessions-*`/`bookslm-history-*`, événement `bookslm:history-updated`) ; #96 onglet sidebar `#sidebar-tab-ai` (`messages-square`) + panneau `#sidebar-panel-ai` (liste chronologique, ouverture via `openWithSession`) ; #97 bouton **« + »** remplaçant « Attach an image » + panneau modulaire `.bookslm-ext-menu` (registre `_extensions` : Fichiers, Image, Contextes, Skills, Deep Research = mode agent + prompt, Recherche web & Canva en « Bientôt ») ; #94 bouton d'envoi circulaire + icône Lucide `arrow-up`. Vérifié : pytest 1088 passed / 6 skipped, ruff 0, mypy 0 (71 fichiers), tests frontend IA 84/84, unit 9/9, validate-imports 38 modules. | 🟢 corrigé (en attente vérif utilisateur) |
|
||||
|
||||
---
|
||||
|
||||
## 📜 Historique des bugs résolus
|
||||
|
||||
+7
-61
@@ -1,6 +1,6 @@
|
||||
# ObsiGate — Roadmap
|
||||
|
||||
> **Version :** 2.3.4 | **Dernière mise à jour :** 2026-09-16
|
||||
> **Version :** 2.4.0 | **Dernière mise à jour :** 2026-09-16
|
||||
> **Ce fichier ne contient que le travail à venir** (🔵 En cours + ⚪ Backlog) et un index compact
|
||||
> vers les fonctionnalités livrées.
|
||||
> - **Méthode de livraison à appliquer pour toute tâche : [DELIVERY_WORKFLOW.md](./DELIVERY_WORKFLOW.md)**
|
||||
@@ -94,63 +94,6 @@
|
||||
- [ ] Transverse : `tenacity` (backoff), cache SQLite des résultats web avec TTL, secrets via Infisical
|
||||
- [ ] Chaque outil : libellé `labels.py` + clés i18n `ai.step.*` FR/EN + tests (httpx mocké)
|
||||
|
||||
### 94. Assistant IA — Bouton de soumission arrondi et icône renouvelée
|
||||
|
||||
- **Effort :** 0,5 jour | **Impact :** 🟢 | **Zone :** frontend (`style.css`, `bookslm.js`)
|
||||
- **Description :** remplacer le bouton de soumission du panneau Assistant IA par un bouton rond
|
||||
et changer l'icône avion (`✈`) par une icône plus moderne (par ex. flèche vers le haut ou
|
||||
icône séduisante).
|
||||
- **Sous-tâches :**
|
||||
- [ ] Remplacer l'icône avion par une icône alternatif (flèche, paper plane stylisée, etc.)
|
||||
- [ ] Rendre le bouton de soumission circulaire (taille fixe, border-radius 50%)
|
||||
- [ ] Ajuster le positionnement (aligné en bas à droite de la zone de saisie)
|
||||
- [ ] i18n FR/EN + tests frontend
|
||||
|
||||
### 95. Assistant IA — Historique permanent des conversations (persistance côté backend)
|
||||
|
||||
- **Effort :** 2-3 jours | **Impact :** 🟡 | **Zone :** backend + frontend
|
||||
- **Description :** rendre la gestion de l'historique des conversations avec l'assistant IA
|
||||
permanente en persistant les échanges côté backend (et non uniquement en session/navigateur).
|
||||
L'historique doit survivre aux rechargements de page et être consultable à tout moment.
|
||||
- **Sous-tâches :**
|
||||
- [ ] Persister les conversations dans un stockage backend (SQLite ou JSON chiffré)
|
||||
- [ ] API CRUD pour les conversations (liste, récupération, suppression)
|
||||
- [ ] Synchroniser l'historique côté frontend au chargement du panneau IA
|
||||
- [ ] Nettoyage automatique de l'historique (rétention configurable, purge des anciennes)
|
||||
- [ ] Tests unitaires backend + tests frontend
|
||||
|
||||
### 96. Assistant IA — Accès rapide à l'historique depuis le panneau de navigation
|
||||
|
||||
- **Effort :** 1 jour | **Impact :** 🟡 | **Zone :** frontend (`nav.js`, `bookslm.js`)
|
||||
- **Description :** ajouter un icône dédié dans le panneau de navigation gauche (à côté de
|
||||
Vaultes, Tags, Récent, Sauvegarde) permettant d'ouvrir directement la liste des
|
||||
conversations de l'historique de l'assistant IA.
|
||||
- **Sous-tâches :**
|
||||
- [ ] Ajouter l'icône « Historique IA » dans la sidebar de navigation
|
||||
- [ ] Au clic : afficher un panneau latéral avec la liste chronologique des conversations
|
||||
- [ ] Sélection d'une conversation → ouverture dans le panneau Assistant IA
|
||||
- [ ] Indicateur visuel (badge) si de nouvelles conversations sont présentes
|
||||
- [ ] i18n FR/EN + tests frontend
|
||||
|
||||
### 97. Assistant IA — Panneau « + » extensible (fichiers, Deep Research, contextes, skills, etc.)
|
||||
|
||||
- **Effort :** 2-3 jours | **Impact :** 🟡 | **Zone :** frontend (`bookslm.js`, `style.css`)
|
||||
- **Description :** remplacer le bouton « Attach an image » par un bouton « + » qui ouvre
|
||||
un panneau d'extensions contenant diverses actions : téléverser des fichiers, Deep Research,
|
||||
ajouter des contextes, ajouter des skills, recherche sur Internet, intégration Canva, et
|
||||
d'autres options à venir. Ce panneau est extensible et modulaire.
|
||||
- **Sous-tâches :**
|
||||
- [ ] Remplacer le bouton « Attach an image » par un bouton « + » (icône universelle)
|
||||
- [ ] Panneau overlay / dropdown listant les options disponibles
|
||||
- [ ] Téléverser des fichiers (drag & drop + sélecteur)
|
||||
- [ ] Deep Research (lancement d'une recherche approfondie via les outils IA)
|
||||
- [ ] Ajouter contextes (fichiers, répertoires, URL)
|
||||
- [ ] Ajouter skills (catalogue de skills disponibles)
|
||||
- [ ] Recherche sur Internet (accès direct à `web_search`)
|
||||
- [ ] Intégration Canva (ou outil externe similaire)
|
||||
- [ ] Architecture modulaire : chaque option est un plugin/extensible facilement
|
||||
- [ ] i18n FR/EN + tests frontend
|
||||
|
||||
---
|
||||
|
||||
## ⚪ Backlog — Sécurité, architecture & performance (P0/P1)
|
||||
@@ -247,6 +190,10 @@
|
||||
| 88 | Assistant IA — contexte applicatif (documents ouverts, répertoire, recherche, fichiers récents) & liens de fichiers fiables (BUG-041, BUG-042) | 2.3.0 | [features/ai-app-context.md](./features/ai-app-context.md) |
|
||||
| 91 | Assistant IA — Zone de discussion façon Notion : post ancré en haut, fournisseur/modèle discret & barre d'actions | 2.3.0 | [features/ai-assistant-conversation-ux.md](./features/ai-assistant-conversation-ux.md) |
|
||||
| 93 | Édition inline — « Editer » et « Forge » remplacent la vue lecture (assistant IA qui met le document à jour) | 2.3.0 | [features/editeur-inline.md](./features/editeur-inline.md) |
|
||||
| 94 | Assistant IA — Bouton de soumission arrondi + icône renouvelée (arrow-up) | 2.4.0 | [features/ai-assistant-history.md](./features/ai-assistant-history.md) |
|
||||
| 95 | Assistant IA — Historique permanent des conversations (persistance backend) | 2.4.0 | [features/ai-assistant-history.md](./features/ai-assistant-history.md) |
|
||||
| 96 | Assistant IA — Accès rapide à l'historique depuis la sidebar de navigation | 2.4.0 | [features/ai-assistant-history.md](./features/ai-assistant-history.md) |
|
||||
| 97 | Assistant IA — Panneau « + » extensible (fichiers, Deep Research, contextes, skills…) | 2.4.0 | [features/ai-assistant-history.md](./features/ai-assistant-history.md) |
|
||||
|
||||
---
|
||||
|
||||
@@ -254,13 +201,12 @@
|
||||
|
||||
| Priorité | Items | Effort total estimé |
|
||||
|---|---|---|
|
||||
| ✅ Complété | #1 → #59, #61–72, #74–76, #78–84, #88–93 | ~108 jours réalisés |
|
||||
| ✅ Complété | #1 → #59, #61–72, #74–76, #78–84, #88–93, #94–97 | ~112 jours réalisés |
|
||||
| 🔵 P2 restant | #77 Desktop : signature de code (non retenue), 6 tests E2E **manuels** ([protocole](./DESKTOP_E2E_CHECKLIST.md)) | ~0,5-1 jour |
|
||||
| ⚪ P4 restant | #73 Sync (6-8j) | 6-8 jours |
|
||||
| ⚪ P2 restant | #92 Assistant IA — écosystème d'outils phase 2 (web étendu, sources connectées, documents) | 3-5 jours |
|
||||
| ⚪ P2 restant | #94–97 Assistant IA — améliorations UI (soumission, historique, navigation, panneau +) | ~6-7 jours |
|
||||
| ⚪ P0/P1 restant | #85-87 Refonte architecturale, performance, CI/CD (issues BUG-035 → BUG-040) | ~15-23 jours |
|
||||
| **Total restant** | **11 items + finitions** | **~37-54 jours** |
|
||||
| **Total restant** | **10 items + finitions** | **~30-47 jours** |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,100 @@
|
||||
# #94–#97 — Assistant IA : historique permanent, accès sidebar, bouton rond et panneau « + »
|
||||
|
||||
> **Statut :** ✅ Livré (en attente de validation utilisateur)
|
||||
> **Effort :** ~7 jours | **Impact :** 🟡
|
||||
> **Références :** [Roadmap](../ROADMAP.md) · [Changelog](../../CHANGELOG.md)
|
||||
|
||||
- **Description :** quatre améliorations de l'Assistant IA livrées ensemble :
|
||||
1. **#94** — bouton de soumission **circulaire** avec icône Lucide `arrow-up`
|
||||
(remplace l'avion ✈️).
|
||||
2. **#95** — **historique permanent** des conversations **persisté côté backend**
|
||||
(les échanges survivent aux rechargements de page et aux navigateurs).
|
||||
3. **#96** — accès rapide à l'**historique depuis la sidebar de navigation** (onglet dédié).
|
||||
4. **#97** — panneau **« + » extensible** remplaçant « Attach an image » (modules :
|
||||
fichiers, image, contextes, skills, Deep Research, web, Canva).
|
||||
|
||||
## A. Backend — persistance des conversations (#95) — ✅ livré
|
||||
- [x] **`backend/ai_history.py`** (nouveau) : stockage JSON par utilisateur
|
||||
(`data/ai_history/{username}.json`), écriture atomique (tmp + `shutil.move`),
|
||||
plafond `MAX_SESSIONS = 200` (purge des plus anciennes), tri par `updatedAt` desc.
|
||||
- [x] `list_sessions`, `get_session`, `upsert_session`, `delete_session` ;
|
||||
la liste renvoie des **résumés sans messages** (`_summary` : titre, mode, vault,
|
||||
contexte, `message_count`, `preview`) pour rester légère.
|
||||
- [x] **`backend/bookslm_routes.py`** : modèle Pydantic `BookslmSession` et 4 endpoints :
|
||||
- `GET /api/ai/bookslm/history` — liste des conversations (résumés).
|
||||
- `GET /api/ai/bookslm/history/{session_id}` — conversation complète (404 si absente).
|
||||
- `PUT /api/ai/bookslm/history/{session_id}` — création/mise à jour (l'`id` du corps
|
||||
est forcé à l'`id` du path → jamais d'écriture sous une autre clé).
|
||||
- `DELETE /api/ai/bookslm/history/{session_id}` — suppression (booléen `ok`).
|
||||
- [x] Isolation par utilisateur (`require_auth`) ; saisies défensives (username/id vides) →
|
||||
`[]` ou `None`.
|
||||
|
||||
## B. Frontend — sync serveur + cache local (#95) — ✅ livré
|
||||
- [x] `frontend/js/bookslm.js` : clé local globale `bookslm-sessions-all-{username}` ;
|
||||
**migration** des anciennes clés périmées `bookslm-sessions-<ctx>` et
|
||||
`bookslm-history-<ctx>` à la première ouverture.
|
||||
- [x] `_loadHistory(preferredSessionId)` **async** au chargement du panneau :
|
||||
lecture serveur (`GET /history`), hydratation du localStorage, repli hors-ligne
|
||||
silencieux si le serveur ne répond pas.
|
||||
- [x] Synchronisation **debounced 600 ms** (`_syncHistoryToServer` → `_flushHistoryToServer`)
|
||||
via `_dirtySessionIds` / `_deletedIds` : `PUT`/`DELETE` seulement pour les sessions
|
||||
modifiées ; pas d'appel réseau à la simple ouverture.
|
||||
- [x] `_positionSession` : nouvelle session insérée en tête, session rechargée remise à jour.
|
||||
- [x] `openContext(opts, preferredSessionId)` **async** ; `openWithSession(sessionOrId)`
|
||||
public pour ouvrir une conversation connue (utilisé par la sidebar #96).
|
||||
- [x] `_notifyHistoryChanged()` : événement `bookslm:history-updated` pour rafraîchir la
|
||||
sidebar #96 sans rechargement.
|
||||
|
||||
## C. Frontend — sidebar & historique (#96) — ✅ livré
|
||||
- [x] `frontend/index.html` : cinquième onglet `#sidebar-tab-ai` (icône Lucide
|
||||
`messages-square`) et panneau `#sidebar-panel-ai` (`#ai-history-list`,
|
||||
`#ai-history-empty`).
|
||||
- [x] `frontend/js/config.js` : `loadAISessionList()` / `renderAIHistoryList()` (réutilise
|
||||
les classes `.recent-*` de l'UI), placeholder « Aucune conversation », listener
|
||||
`bookslm:history-updated` monté par `initSidebarTabs()` et actif quand l'onglet `ai`
|
||||
est affiché.
|
||||
- [x] Le clic sur une conversation l'ouvre dans le panneau Assistant IA
|
||||
(via `openWithSession`) et bascule la sidebar.
|
||||
|
||||
## D. Frontend — panneau « + » extensible (#97) — ✅ livré
|
||||
- [x] Bouton « Attach an image » remplacé par un bouton **« + »** circulaire
|
||||
(`frontend/js/bookslm.js`, `.bookslm-btn-plus`).
|
||||
- [x] Panneau overlay `.bookslm-ext-menu` (dropdown au-dessus de la zone de saisie,
|
||||
fermeture au clic extérieur / Échap) listant les modules.
|
||||
- [x] Architecture **modulaire** : registre `_extensions` (objet d'enregistrement
|
||||
simple) — chaque entrée : `id`, icône, libellé i18n, action ;
|
||||
`renderExtMenu()` construit la liste ; un nouveau module s'ajoute en une entrée.
|
||||
- [x] Modules livrés : **Fichiers** (sélecteur général `.bookslm-files-input`),
|
||||
**Image** (joindre une image), **Contextes/fichiers**, **Skills**,
|
||||
**Deep Research** (mode agent + prompt pré-rempli), **Recherche sur Internet**,
|
||||
**Canva**.
|
||||
- [x] `web`/`canva` affichés **désactivés** avec badge « Bientôt » (`.bookslm-ext-soon`)
|
||||
— le catalogue d'outils #92 les alimentera.
|
||||
- [x] `_startDeepResearch()` : active le mode agent, injecte le prompt Deep Research et
|
||||
déclenche l'envoi.
|
||||
|
||||
## E. UI — bouton rond & icône (#94) — ✅ livré
|
||||
- [x] `.bookslm-btn-send` circulaire (40 px, `border-radius: 50%`), icône Lucide
|
||||
`arrow-up` à la place de l'emoji ✈️, aligné en bas à droite de la zone de saisie.
|
||||
- [x] i18n FR/EN : `bookslm.add_options`, `bookslm.ext_files`, `bookslm.ext_image_hint`,
|
||||
`bookslm.ext_contexts`, `bookslm.ext_skills`, `bookslm.ext_deep_research`,
|
||||
`bookslm.ext_web`, `bookslm.ext_canva`, `bookslm.coming_soon`, `bookslm.soon`,
|
||||
`bookslm.ext_more_coming`, `bookslm.deep_research_prompt`,
|
||||
`bookslm.deep_research_started`, `bookslm.mode_*`.
|
||||
|
||||
## F. Tests — ✅ livré
|
||||
- [x] `tests/test_bookslm.py` : `TestBooksLMSessionHistoryEndpoints` (7) + `TestAIGatewayHistoryStore` (4) —
|
||||
liste résumée sans messages, full 404, upsert qui force l'id et isole par utilisateur,
|
||||
delete, cap à 200, purge.
|
||||
- [x] `tests/frontend/ai.test.mjs` : persistance/reouverture/suppression de sessions,
|
||||
migration de l'historique legacy, menu d'historique.
|
||||
- [x] Vérifs : pytest **1088 passed / 6 skipped**, ruff 0, mypy 0 (71 fichiers),
|
||||
frontend `ai.test.mjs` **84/84**, `unit.test.mjs` 9/9, `validate-imports` 38 modules.
|
||||
|
||||
## G. Points d'attention
|
||||
- Le localStorage reste un **cache** : le serveur est la source de vérité (`data/ai_history/`).
|
||||
En cas de données locales corrompues, un `localStorage.clear()` réinitialise proprement.
|
||||
- `MAX_SESSIONS = 200` : le comportement de purge est testé (`TestAIGatewayHistoryStore`)
|
||||
; la rétention configurable (item #95 du backlog) pourra s'appuyer sur ce plafond.
|
||||
- Les modules web/Canva du panneau « + » sont volontairement désactivés tant que
|
||||
l'écosystème d'outils phase 2 (#92) n'est pas livré.
|
||||
@@ -57,6 +57,10 @@
|
||||
- [x] **D2. Régénérer** : Bouton pour régénérer la dernière réponse (utile si la réponse est hors-sujet).
|
||||
- [x] **D3. Exporter la conversation** : Bouton pour exporter l'historique en Markdown → sauvegarder comme note dans le répertoire courant.
|
||||
- [x] **D4. Historique des conversations** : Stockage dans `localStorage` par clé `bookslm-history-{vault}-{directory}`. Liste déroulante dans le header pour charger une conversation précédente.
|
||||
> **Évolué (#95, 2026-09-16) :** l'historique est désormais **persisté côté backend**
|
||||
> (`data/ai_history/{user}.json`), le localStorage ne sert plus que de cache,
|
||||
> et les anciennes clés `bookslm-sessions-*` / `bookslm-history-*` sont migrées.
|
||||
> Voir [ai-assistant-history.md](./ai-assistant-history.md).
|
||||
- [x] **D5. Indicateur de contexte (barre de progression %) — non retenu, compteur fichiers/caractères affiché)** : Barre de progression montrant l'utilisation du contexte (% de la limite `BOOKSLM_MAX_TOTAL_CHARS`). Si le répertoire est trop gros, suggérer de réduire le scope.
|
||||
- [x] **D6. Suggestions de questions** : Après l'indexation, afficher 3 questions suggérées basées sur les titres et métadonnées des fichiers (« Résume ce répertoire », « Quels sont les thèmes principaux ? », « Y a-t-il des contradictions entre ces documents ? »).
|
||||
|
||||
|
||||
Reference in New Issue
Block a user