Généré le 13/10/2026 19:02

Analyse de faisabilité — Recherche par mots-clés dans le visualiseur de rapports/documents de Jarvis

Demande de Raphaël : étudier l'intégration d'une fonctionnalité de recherche par mots-clés directement dans le visualiseur de rapports/documents de l'interface Jarvis, analyser les solutions techniques pour indexer et rechercher du texte dans les artifacts affichés (markdown, HTML, fichiers texte), et évaluer la complexité d'implémentation.

Méthode : code vérifié directement (pas supposé) dans JARVIS_LIVE_VOICE/server.py et JARVIS_LIVE_VOICE/public_jarvis/app.js + index.html.


1. Constat de départ : il existe DEUX visionneuses distinctes, pas une

Raphaël consulte des rapports via deux mécanismes différents dans l'interface, avec des architectures radicalement différentes du point de vue de la recherche de texte :

1.1 reportModal — rendu Markdown injecté en direct dans le DOM de la page principale

Pour les rapports de mission (openReport(), app.js l.3660-3683), le Markdown est converti côté client via marked.js + DOMPurify (mdRender(), l.3625-3642) puis injecté dans this.reportText.innerHTML (l.3819) — un <div id="reportText"> qui vit dans le document principal, pas dans un cadre isolé.

1.2 docViewerModal — un <iframe> chargeant un .html autonome généré par le serveur

Pour les rapports d'artifacts ouverts par bouton ou par commande vocale (afficher_rapport_artefact, openDocViewer() l.3854-3864), le contenu provient d'un fichier .html généré côté serveur par convert_report_to_standalone_html() (server.py l.2293-2316), via render_markdown_to_html() (l.2275-2290) qui utilise la lib markdown Python (markdown_lib.markdown(..., extensions=["tables","fenced_code","nl2br","sane_lists"])) et injecte le résultat dans REPORT_HTML_TEMPLATE (l.2228-2272). Ce .html est servi statiquement sous /artifacts/ (StaticFiles, l.845) et chargé dans <iframe id="docViewerFrame"> (index.html l.362) — sans attribut sandbox, et sur le même domaine que la page principale (même host Jarvis). Ce point est déterminant : un iframe same-origin reste scriptable depuis la page parente (iframe.contentDocument/contentWindow sont accessibles), contrairement à un iframe cross-origin qui aurait bloqué toute injection de script de recherche depuis app.js.

Conséquence pratique : une solution de recherche doit couvrir les deux cas, mais ils n'ont pas la même meilleure stratégie d'implémentation (voir §3.2).


2. Ce que "indexer" veut dire ici — cadrer le bon problème

Le mot "indexer" peut recouvrir deux besoins très différents, de coût radicalement différent :

Le cœur de cette étude porte sur (A), qui est le sens le plus probable de "recherche dans le visualiseur".


3. Solution technique recommandée — recherche intra-document

3.1 Principe : TreeWalker + <mark>, zéro dépendance externe

Technique standard, sans librairie : parcourir les nœuds texte du conteneur affiché avec document.createTreeWalker(container, NodeFilter.SHOW_TEXT), construire la liste des correspondances (comparaison insensible à la casse et aux accents via normalisation Unicode NFD + suppression des diacritiques), puis envelopper chaque correspondance dans un <mark class="jarvis-search-hit"> (surbrillance jaune) avec une variante .active (surbrillance plus vive) pour la correspondance courante, plus scrollIntoView({block:'center'}) à chaque navigation.

C'est la même famille de technique que Ctrl+F du navigateur, réimplémentée en JS pour pouvoir l'intégrer dans l'UI de Jarvis (barre de recherche stylée, compteur "3/12", flèches précédent/suivant, raccourci clavier) plutôt que de dépendre du widget natif du navigateur (qui ne fonctionnerait pas correctement à l'intérieur d'un <iframe> ciblé séparément du document principal, et qui est inutilisable en pilotage vocal).

Aucune nouvelle dépendance : pas de lunr.js, pas de Fuse.js, pas de moteur côté serveur — le volume ne le justifie pas (§2) et ça ajouterait une dépendance CDN, exactement le type de fragilité déjà corrigée le 11/10/2026 pour marked.js/DOMPurify (cf. mémoire project_jarvis_liens_rapports_non_cliquables_cdn_vendor_fix_11102026 — un CDN inaccessible cassait le rendu). Tout doit rester auto-porté, cohérent avec la philosophie déjà actée pour render_markdown_to_html() (commentaire l.2276-2281 : "sans aucune dépendance CDN").

3.2 Un seul script partagé, inclus dans les DEUX contextes

Point d'implémentation important pour éviter la duplication de logique (source d'incohérence à terme, cf. règle 10 de CLAUDE.md) : écrire la logique de recherche/surlignage une seule fois, dans un nouveau fichier statique JARVIS_LIVE_VOICE/public_jarvis/search_viewer.js, et l'inclure dans les deux contextes :

C'est donc la bonne architecture pour les deux cas à la fois — pas une solution par visionneuse, une seule brique réutilisée deux fois.

3.3 Interface utilisateur

3.4 Points de friction réels identifiés (pas hypothétiques)


4. Extension vocale — "cherche X dans le rapport" (optionnelle, phase 2)

L'écosystème a déjà un canal pour piloter l'UI depuis la voix : le WebSocket ui_command (app.js l.2303-2329), utilisé par exemple pour open_artifact_report et close_mission. Ajouter une commande search_in_report suit exactement le même patron déjà en place :

  1. Exposer un nouvel outil/fonction au cerveau vocal (même famille que afficher_rapport_artefact), qui reçoit le mot-clé dicté.
  2. Le serveur pousse {"type":"ui_command","action":"search_in_report","query":"<mot>"}.
  3. Côté client, un nouveau else if (data.action === 'search_in_report') appelle directement les fonctions exposées par search_viewer.js (window.JarvisSearch.run(query)), qui détecte elle-même quel conteneur est actif (reportModal vs docViewerModal vs iframe.contentDocument).

Effort réduit car 90% de la mécanique de dispatch existe déjà — le seul vrai travail est l'exposition de l'outil au modèle vocal et le branchement du else if.


5. Recherche transversale multi-rapports (bonus, hors périmètre initial, phase 3)

Si le besoin réel dépasse "chercher dans le rapport ouvert" et vise "retrouver LEQUEL de mes rapports parle de X" : comme tous les artifacts sont déjà des fichiers texte/HTML sur disque sous ARTIFACTS_DIR (et la racine C:\ASSISTANT_IA\*.md, cf. la logique de collecte déjà existante dans tool_read_artifact() l.2357 et ses variantes de scan l.2385-2415), une recherche transversale ne nécessite aucune base de données ni moteur d'indexation dédié à ce volume (quelques centaines de fichiers). Un simple parcours + str.lower() sur le contenu de chaque fichier (voire un appel à ripgrep, déjà présent dans l'environnement de l'agent) suffit, exécuté à la demande en quelques centaines de millisecondes. Ce n'est donc pas un chantier distinct coûteux — plutôt une nouvelle route API légère (/api/search_artifacts?q=...) réutilisant la logique déjà écrite au §2385-2415 de server.py, qui renverrait une liste de fichiers + extraits, affichée dans un petit panneau de résultats avant d'ouvrir le document choisi via openDocViewer().

Non traité en détail ici car ce n'est pas le sens le plus direct de la demande de Raphaël (qui parle du "visualiseur" au singulier), mais à garder en tête comme extension naturelle et peu coûteuse si le besoin se confirme.


6. Verdict de faisabilité

Faisabilité technique : élevée. Complexité globale : faible pour le cœur de la fonctionnalité. Aucune nouvelle dépendance externe, aucune base de données, aucun moteur d'indexation — uniquement du JavaScript natif (TreeWalker, Range, normalisation Unicode) et un fichier statique partagé entre les deux visionneuses déjà existantes. Le principal travail n'est pas algorithmique (chercher une sous-chaîne dans un texte de quelques dizaines de Ko est trivial) mais d'intégration UI (barre de recherche cohérente avec le design existant, cascade de fermeture Échap, réapplication après re-rendu).


7. Plan de mise en œuvre recommandé

Phase Contenu Complexité Effort estimé Nouvelle dépendance
1 — Cœur search_viewer.js partagé (TreeWalker + surbrillance + nav clavier) + barre UI dans reportModal et docViewerModal/REPORT_HTML_TEMPLATE + gestion Échap en cascade Faible 2 à 3 h Aucune
2 — Vocal Commande "cherche X dans le rapport" via nouveau ui_command: search_in_report, réutilisant le canal WebSocket existant Faible à modérée 1 à 2 h Aucune
3 — Transversal (bonus) Route /api/search_artifacts, scan des fichiers déjà listés par tool_read_artifact, petit panneau de résultats Modérée 2 à 4 h Aucune
Rattrapage historique (optionnel) Script one-shot de régénération des .html déjà présents dans artifacts/ pour qu'ils héritent de la barre de recherche Triviale < 30 min Aucune

Aucune ligne de ce tableau n'a été exécutée — ceci est l'étude de faisabilité demandée, pas une implémentation. Recommandation : démarrer par la Phase 1 seule, qui couvre déjà le besoin exprimé ("recherche par mots-clés dans le visualiseur"), et ne passer aux phases 2/3 que si Raphaël confirme le besoin après usage de la Phase 1.