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.
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 :
reportModal — rendu Markdown injecté en direct dans le DOM de la page principalePour 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é.
docViewerModal — un <iframe> chargeant un .html autonome généré par le serveurPour 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).
Le mot "indexer" peut recouvrir deux besoins très différents, de coût radicalement différent :
artifacts/*.md observés sont tous < 100 Ko). À cette échelle, aucune structure d'index n'est nécessaire — un simple parcours linéaire du texte déjà présent dans le DOM (ou dans la chaîne Markdown source) prend quelques millisecondes. Parler d'"indexation" ici serait un sur-dimensionnement.Le cœur de cette étude porte sur (A), qui est le sens le plus probable de "recherche dans le visualiseur".
TreeWalker + <mark>, zéro dépendance externeTechnique 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").
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 :
index.html, via <script src="/jarvis/search_viewer.js">, pour alimenter la barre de recherche du reportModal (ciblant #reportText du document principal).REPORT_HTML_TEMPLATE (server.py l.2228), ajouter une balise <script src="/jarvis/search_viewer.js"></script> juste avant </body> (l.2270) plus le marquage HTML minimal de la barre (un bouton 🔍 + input, same CSS inline que le reste du template, cohérent avec --blue/--border déjà définis l.2235). Comme le .html est auto-porté et servi par le même serveur Jarvis (/jarvis/search_viewer.js est accessible depuis n'importe quelle origine qui charge ce fichier, y compris un lien Telegram ouvert directement hors de docViewerModal), cette approche a un avantage décisif : la recherche fonctionne même quand le rapport est ouvert directement dans un nouvel onglet (lien partagé sur Telegram, cf. règle 6/9 CLAUDE.md), pas seulement à l'intérieur de l'iframe de Jarvis. Elle évite aussi tout besoin de scripter depuis la page parente à travers la frontière d'iframe (plus simple, plus robuste, fonctionne même si l'attribut sandbox était ajouté un jour par erreur).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.
.report-head-main l.340 et .doc-viewer-header l.356-360 côté index.html ; .sticky-nav-bar côté REPORT_HTML_TEMPLATE), qui déroule une barre de recherche (input + compteur + flèches ↑↓ + bouton fermer).Ctrl+F intercepté uniquement quand le modal est ouvert (pour ne pas court-circuiter le Ctrl+F natif du navigateur en dehors du contexte rapport).Entrée / Shift+Entrée pour naviguer suivant/précédent, Échap pour fermer la barre de recherche en premier (sans fermer tout le modal au premier Échap — nuance à câbler proprement dans closeActiveModal(), l.3829-3839, qui gère déjà la cascade de fermeture : il faudra y insérer un niveau "barre de recherche ouverte" avant les niveaux existants, pour que Échap ferme d'abord la recherche puis, au second appui, le rapport).renderReportContent() est ré-appelé à chaque mise à jour de statut de mission tant que alreadyRendered est faux (l.3669-3676, logique anti-scintillement du 13/10/2026). Si une recherche est active au moment où une mission running passe à done, le <mark> injecté est détruit par le nouveau innerHTML. Il faut soit réappliquer la recherche après chaque rendu si une requête est active, soit — plus simple — considérer que ce cas est rare (rapports déjà terminés sont statiques, la recherche sert surtout sur du contenu figé) et se contenter de relancer la recherche automatiquement si le texte de recherche n'est pas vide après un re-rendu..html déjà générés avant le déploiement de cette fonctionnalité : convert_report_to_standalone_html() ne régénère que si la source est plus récente que le .html existant (dest.stat().st_mtime >= src.stat().st_mtime, l.2300) — donc les dizaines de rapports déjà présents dans artifacts/ ne récupèreront pas la barre de recherche rétroactivement, sauf à forcer une régénération ponctuelle (boucle simple sur ARTIFACTS_DIR.glob("*.html") qui retrouve le .md/.txt source et le reconvertit). Impact faible — les prochains rapports en bénéficient automatiquement, un script de rattrapage à la demande règle l'historique en quelques secondes si souhaité.server.py ou REPORT_HTML_TEMPLATE — pas de blocage de script inline/externe à anticiper.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 :
afficher_rapport_artefact), qui reçoit le mot-clé dicté.{"type":"ui_command","action":"search_in_report","query":"<mot>"}.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.
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.
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).
| 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.