╔══════════════════════════════════════════════════════════════════════════╗
║                   MODE ASSISTÉ - GUIDE RAPIDE                            ║
╚══════════════════════════════════════════════════════════════════════════╝

┌──────────────────────────────────────────────────────────────────────────┐
│                        QU'EST-CE QUE C'EST ?                             │
└──────────────────────────────────────────────────────────────────────────┘

Le Mode Assisté suggère automatiquement des actions basées sur ce que tu as
déjà fait. C'est comme un assistant qui te dit : "Tu veux que je fasse ça ?"

┌──────────────────────────────────────────────────────────────────────────┐
│                        COMMENT ÇA MARCHE ?                               │
└──────────────────────────────────────────────────────────────────────────┘

PHASE 1 : APPRENTISSAGE (Mode Shadow)
  1. Lance l'application : cd geniusia2 && ./run.sh
  2. Clique sur "Start"
  3. Effectue 3 fois la même action (ex: 3 clics sur "Enregistrer")
  4. Le système détecte le pattern et crée une tâche
  5. Tu vois une notification : "Tâche apprise"

PHASE 2 : SUGGESTIONS (Mode Assisté)
  1. Refais une action similaire (1 seul clic sur "Enregistrer")
  2. Un overlay apparaît avec la suggestion
  3. Tu choisis :
     - [Entrée] : Accepter → Le système exécute automatiquement
     - [Échap]  : Refuser → Rien ne se passe
     - [Alt+C]  : Corriger → (À venir)

┌──────────────────────────────────────────────────────────────────────────┐
│                        EXEMPLE VISUEL                                    │
└──────────────────────────────────────────────────────────────────────────┘

Tu fais 3x :  [Clic] → [Clic] → [Clic]
              ↓
Le système :  "Pattern détecté ! Tâche créée : 'Clic sur Enregistrer'"
              ↓
Tu refais :   [Clic]
              ↓
Le système :  ┌─────────────────────────────────────┐
              │  🤝 Suggestion d'Action             │
              │                                     │
              │  Tâche : Clic sur Enregistrer       │
              │  Confiance : 89%                    │
              │                                     │
              │  [Entrée] Accepter                  │
              │  [Échap] Refuser                    │
              │  [Alt+C] Corriger                   │
              └─────────────────────────────────────┘
              ↓
Tu appuies :  [Entrée]
              ↓
Le système :  ✅ Action exécutée automatiquement !

┌──────────────────────────────────────────────────────────────────────────┐
│                        TESTER LE MODE ASSISTÉ                            │
└──────────────────────────────────────────────────────────────────────────┘

Option 1 : Test Automatisé
  $ geniusia2/venv/bin/python test_mode_assiste_complet.py
  
  Résultat : 4/4 tests réussis ✅

Option 2 : Test Manuel
  $ geniusia2/venv/bin/python test_mode_assiste_manuel.py
  
  Résultat : Liste les tâches et simule une suggestion

Option 3 : Application Complète
  $ cd geniusia2 && ./run.sh
  
  Résultat : Interface graphique avec Mode Assisté actif

┌──────────────────────────────────────────────────────────────────────────┐
│                        CONFIGURATION                                     │
└──────────────────────────────────────────────────────────────────────────┘

Fichier : geniusia2/core/config.py

assist:
  similarity_threshold: 0.75    # Seuil pour afficher suggestion (75%)
  suggestion_timeout: 10.0      # Timeout en secondes

Tu peux baisser le seuil à 0.65 si tu veux plus de suggestions.

┌──────────────────────────────────────────────────────────────────────────┐
│                        ÉTAT ACTUEL                                       │
└──────────────────────────────────────────────────────────────────────────┘

✅ FONCTIONNEL (90%)
  • SuggestionManager : Recherche de suggestions
  • Orchestrator : Intégration complète
  • GUI : Overlay visuel
  • Callbacks : Tous les événements
  • Exécution : Automatique sur acceptation

⚠️  À AMÉLIORER (10%)
  • Dialogue de correction (Alt+C)
  • Historique des suggestions
  • Statistiques en temps réel

┌──────────────────────────────────────────────────────────────────────────┐
│                        PROBLÈMES COURANTS                                │
└──────────────────────────────────────────────────────────────────────────┘

Problème : Aucune suggestion n'apparaît
  Causes :
    - Pas de tâche similaire apprise
    - Similarité < 75%
    - Contexte trop différent
  
  Solutions :
    1. Vérifier les tâches : python3 read_pkl.py --list
    2. Baisser le seuil dans config.py : similarity_threshold: 0.65
    3. Refaire l'apprentissage avec plus d'exemples

Problème : L'exécution échoue
  Causes :
    - Élément non trouvé
    - Interface a changé
    - Permissions insuffisantes
  
  Solutions :
    1. Vérifier les logs : cat geniusia2/data/logs/logs_*.json
    2. Refaire l'apprentissage
    3. Vérifier les permissions X11/Wayland

Problème : L'overlay ne disparaît pas
  Causes :
    - Bug dans la GUI
    - Callback non appelé
  
  Solutions :
    1. Appuyer sur Échap
    2. Redémarrer l'application
    3. Vérifier les logs

┌──────────────────────────────────────────────────────────────────────────┐
│                        DOCUMENTATION                                     │
└──────────────────────────────────────────────────────────────────────────┘

Complète :
  • MODE_ASSISTE_FINAL.md
  • GUIDE_TEST_MODE_ASSISTE.md
  • ETAT_PROJET_19_11.md

Technique :
  • geniusia2/core/suggestion_manager.py
  • test_mode_assiste_complet.py
  • test_mode_assiste_manuel.py

┌──────────────────────────────────────────────────────────────────────────┐
│                        COMMANDES UTILES                                  │
└──────────────────────────────────────────────────────────────────────────┘

# Lancer l'application
cd geniusia2 && ./run.sh

# Tests automatisés
geniusia2/venv/bin/python test_mode_assiste_complet.py

# Test manuel
geniusia2/venv/bin/python test_mode_assiste_manuel.py

# Voir les tâches
geniusia2/venv/bin/python read_pkl.py --list

# Diagnostic
geniusia2/venv/bin/python diagnostic_data.py

# Reconstruire l'index FAISS
./rebuild_index.sh

╔══════════════════════════════════════════════════════════════════════════╗
║                    LE MODE ASSISTÉ EST PRÊT ! 🚀                         ║
╚══════════════════════════════════════════════════════════════════════════╝
