🛠️ Plan de Correctifs — Résolution de l'Écran Noir Android (Profil OVH) et de la Boucle Port 1083

Date d'intervention : 30 octobre 2026
Localisation de référence : Guadeloupe (UTC-4)
Périmètre : Client Mobile Android (JarvisLocalForwarder.kt, MainActivity.kt) & Superviseur Vocal PC (supervisor.py)


1. Vue d'Ensemble des 3 Failles & Solutions

Composant Faille Identifiée Conséquence Réelle Correctif Concret
Android : JarvisLocalForwarder.kt Socket(targetHost, targetPort) bloquant sans timeout + client.getOutputStream() hors try/catch. Freeze initial de 75s à 120s si la route VPN tarde ; crash fatal du thread pool Android (Socket is closed). Timeout de connexion TCP strict (4 000 ms) + encapsulation complète des ouvertures de flux dans try/catch.
Android : MainActivity.kt onRenderProcessGone détruit la WebView (null) mais fige showHome = false. L'écran reste totalement noir en cas de plantage ou réinitialisation WebView, piégeant l'utilisateur. Forcer showHomeState.value = true et hasConnectionErrorState.value = true pour afficher l'écran d'accueil avec alerte.
PC : supervisor.py (Port 1083) Détection de processus par netstat -ano inopérante ; tentative de bind répétée toutes les 2s. Boucle de crash infinie et spam du log Uvicorn/Superviseur alors que le pont est déjà fonctionnel. Test préalable d'ouverture de port (is_port_open) et backoff passif si le pont est déjà actif.

2. Correctifs Détaillés avec Diffs de Code

Correctif 1 : Sécurisation de JarvisLocalForwarder.kt

Fichier : C:\ASSISTANT_IA\JARVIS_ANDROID\app\src\main\java\com\example\jarvis\service\JarvisLocalForwarder.kt

Problème :

Solution :

<<<< ORIGINAL (Lignes 64-80)
    private fun forward(client: Socket, targetHost: String, targetPort: Int) {
        try {
            val target = Socket(targetHost, targetPort)
            // WebView -> PC
            executor.execute {
                pipe(client.getInputStream(), target.getOutputStream(), client, target)
            }
            // PC -> WebView
            executor.execute {
                pipe(target.getInputStream(), client.getOutputStream(), target, client)
            }
        } catch (e: Exception) {
            Log.e(TAG, "Erreur connexion relais vers $targetHost:$targetPort: ${e.message}")
            try { client.close() } catch (_: Exception) {}
        }
    }
==== CORRECTIF
    private fun forward(client: Socket, targetHost: String, targetPort: Int) {
        try {
            // Connexion avec timeout strict de 4 secondes pour éviter tout freeze
            val target = Socket().apply {
                connect(java.net.InetSocketAddress(targetHost, targetPort), 4000)
                tcpNoDelay = true
            }

            // WebView -> PC (sécurisé contre les exceptions sur les threads d'arrière-plan)
            executor.execute {
                try {
                    val input = client.getInputStream()
                    val output = target.getOutputStream()
                    pipe(input, output, client, target)
                } catch (e: Exception) {
                    try { client.close() } catch (_: Exception) {}
                    try { target.close() } catch (_: Exception) {}
                }
            }

            // PC -> WebView
            executor.execute {
                try {
                    val input = target.getInputStream()
                    val output = client.getOutputStream()
                    pipe(input, output, target, client)
                } catch (e: Exception) {
                    try { target.close() } catch (_: Exception) {}
                    try { client.close() } catch (_: Exception) {}
                }
            }
        } catch (e: Exception) {
            Log.e(TAG, "Erreur connexion relais vers $targetHost:$targetPort: ${e.message}")
            try { client.close() } catch (_: Exception) {}
        }
    }
>>>>

Correctif 2 : Auto-Récupération Visuelle dans MainActivity.kt

Fichier : C:\ASSISTANT_IA\JARVIS_ANDROID\app\src\main\java\com\example\jarvis\MainActivity.kt

Problème :

Solution :

<<<< ORIGINAL (Lignes 772-783)
    override fun onRenderProcessGone(
        view: WebView?,
        detail: RenderProcessGoneDetail?
    ): Boolean {
        val didCrash = detail?.didCrash() ?: false
        Log.e("MainActivity", "Processus de rendu WebView termine (didCrash=$didCrash) -> auto-recuperation sans crash de l'app")
        jarvisWebView = null
        runOnUiThread {
            showHomeState.value = false
        }
        return true
    }
==== CORRECTIF
    override fun onRenderProcessGone(
        view: WebView?,
        detail: RenderProcessGoneDetail?
    ): Boolean {
        val didCrash = detail?.didCrash() ?: false
        Log.e("MainActivity", "Processus de rendu WebView termine (didCrash=$didCrash) -> basculement sur l'accueil avec notification")
        try {
            view?.destroy()
        } catch (_: Exception) {}
        jarvisWebView = null
        runOnUiThread {
            // Rétablit immédiatement l'interface d'accueil et signale l'erreur de connexion
            hasConnectionErrorState.value = true
            showHomeState.value = true
        }
        return true
    }
>>>>

Correctif 3 : Élimination de la Boucle de Crashs Port 1083 dans supervisor.py

Fichier : C:\ASSISTANT_IA\JARVIS_LIVE_VOICE\supervisor.py

Problème :

Solution :

Ajouter une fonction simple et rapide de test d'écoute socket directe (is_port_listening(host, port)) avant toute tentative de démarrage :

<<<< AJOUT FONCTION DANS supervisor.py
def _is_port_in_use(port, host="127.0.0.1"):
    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
        s.settimeout(0.5)
        return s.connect_ex((host, port)) == 0
==== MODIFICATION DANS run_supervised_in
def run_supervised_in(cmd, cwd, env, log_file_name, label, port=None):
    log_path = BASE_DIR / log_file_name
    while True:
        try:
            if port and _is_port_in_use(port):
                log(f"ℹ️ Port {port} ({label}) déjà en écoute et opérationnel. Mise en veille de la supervision (120s)...")
                time.sleep(120)
                continue

            if port:
                _free_stale_port_holder(port, cmd, label)

            log(f"Lancement de {label}...")
            proc = subprocess.Popen(
...
>>>>

3. Matrice de Risques et Impact Technique

  1. Aucun impact sur les flux vocaux actuels : Le serveur vocal PC (port 8000) et le transit VPN OVH restent totalement inchangés et fonctionnels.
  2. Gain de réactivité mobile : Le timeout de 4 secondes garantit qu'en cas de micro-coupure réseau 4G/Wi-Fi en Guadeloupe, l'application mobile ne fige plus 2 minutes mais reprend instantanément.
  3. Élimination de la surchauffe CPU / logs : L'arrêt de la boucle de relance sur le port 1083 supprime 1 800 tentatives infructueuses de bind par heure et allège les journaux de bord.