Généré le 15/10/2026 09:45

Schéma de référence — Orchestrateur scripté de la Chasse Produit

Document de référence canonique, mis à jour le 19/08/2026 (remplace la version du
18/08/2026, entièrement obsolète — cette nuit-là le script était en cours de construction,
cette version décrit le système RÉELLEMENT construit et testé en conditions réelles).
En cas de doute ou de reprise dans une nouvelle conversation (Claude OU Antigravity), se
référer à CE schéma avant de re-décider quoi que ce soit — ne jamais réinventer le flux
de mémoire, et ne jamais supposer qu'une étape marquée ✅ ici a pu changer sans relire le
code réel (tools/chasse_orchestrateur.py) en cas de doute.

Script réel : tools/chasse_orchestrateur.py. Toute la mission tient en UNE commande :
python tools/chasse_orchestrateur.py run --mission <nom> --objectif <N>.
Principe de base (à ne jamais perdre de vue) : tous les scripts métier existent déjà
et sont testés individuellement. Le travail de l'orchestrateur est de les enchaîner
mécaniquement dans le bon ordre, avec le bon prompt au bon moment — jamais de décision
de séquencement prise en conversation live (ni par Claude, ni par Antigravity).

⚠️ Pourquoi ce document existe aussi pour Antigravity, spécifiquement

Décision de Raphael le 19/08/2026 : si le quota hebdomadaire de Claude s'épuise pendant
une absence de Raphael, Antigravity doit pouvoir reprendre la suite (corriger/étendre ce
code, ET faire tourner elle-même les étapes qui dépendaient jusque-là de Claude). Ce
document doit donc être lisible et actionnable sans aucun contexte de conversation
préalable
— c'est le point d'entrée si Antigravity reprend seule.

🎯 Étape 0bis (ajoutée 24/08/2026) : choix des paramètres de recherche AVANT le lancement

Décision de Raphael : quand il demande "lance une chasse pour N produits" sans préciser de
filtres (mot-clé, fenêtre, pays), il ne veut jamais avoir à spécifier ces paramètres lui-même —
il délègue ce choix à l'IA (Claude), avec cette règle stricte : l'IA raisonne UNE SEULE FOIS,
avant le lancement, puis les paramètres choisis sont figés et transmis tels quels au script —
jamais de re-décision en cours d'exécution.

Mécanique :
1. Avant setup, l'IA appelante lit python tools/chasse_strategie.py resume --limit 10 —
historique réel des dernières chasses (paramètres utilisés + indicateurs de qualité réels :
taux d'élimination au Tri Croisé, produits retenus).
2. L'IA raisonne (casquette "media buyer expérimenté") : garder la même combinaison si elle
marche encore bien, varier --query/--jours en priorité si le taux d'élimination grimpe ou
si les derniers produits retenus se répètent trop dans la même niche, ou tenter une
exploration ponctuelle même sans signal négatif (ne jamais rester figé indéfiniment). --country
n'est PAS un levier de rotation par défaut — voir précision ci-dessous.
3. python tools/chasse_strategie.py record --mission <nom> --jours <str> [--query <str>] [--country <str>] --justification "<raisonnement>" — fige la décision par écrit.
4. Lance chasse_orchestrateur.py run --mission <nom> --objectif <N> --jours <str> [--query <str>] [--country <str>] avec EXACTEMENT ces paramètres.
5. Clôture automatique (depuis le 24/08/2026, ne dépend plus de l'IA appelante) :
chasse_orchestrateur.py appelle lui-même chasse_strategie.py cloturer --mission <nom> à
l'étape 11->FIN de cmd_run (et dans cmd_mission_close pour une clôture manuelle/de secours)
— calcule les indicateurs réels (relit le state.json) pour nourrir la décision de la PROCHAINE
chasse. Correctif suite à un oubli réel le 24/08/2026 (mission chasse-5produits-20260824-suite
jamais clôturée dans l'historique jusqu'à vérification manuelle) : la fiabilité de ce mécanisme
ne doit plus dépendre de la mémoire de session de l'IA. Best-effort, silencieux si la mission
n'a jamais été record-ée en amont (ne bloque jamais la vraie clôture de la mission).

--country (ajouté 24/08/2026, existait dans minea_api_client.py mais jamais exposé plus
haut, toujours figé sur "US"). Précision de Raphael (24/08/2026) : rester sur "US" par défaut
dans l'immense majorité des cas
— les US sont le marché témoin où naissent la plupart des
tendances dropshipping avant de se diffuser ailleurs, ce n'est pas un marché parmi d'autres à
faire tourner. Le vrai levier de diversification au quotidien reste --query/--jours, JAMAIS
--country en premier réflexe. --country n'est utile qu'en exploration ponctuelle et rare,
limitée aux autres grands marchés anglophones Tier 1 (GB, CA, AU) si vraiment recherché — jamais
comme rotation systématique, jamais vers un marché non-anglophone par défaut.

Ce module (tools/chasse_strategie.py) n'automatise PAS la décision elle-même (pas de seuil
figé "si taux > X% alors changer") — il fournit juste les données réelles pour que l'IA
appelante décide en connaissance de cause. La décision reste un raisonnement explicite, écrit
dans --justification, jamais un calcul caché.

🔄 Changements du 24/08/2026 (fin de nuit, résumé)

🔄 Changements du 24/08/2026 (nuit, résumé)

🔄 Changements du 24/08/2026 (soir, résumé)

🔄 Changements du 23/08/2026 (résumé, détail dans les fichiers cités)

Légende des acteurs

Couleur Acteur Rôle
🔧 Bleu Orchestrateur (script Python, chasse_orchestrateur.py) Séquence tout mécaniquement. Ne juge jamais rien lui-même. Tourne en subprocess, aucune IA ne le pilote en conversation.
🟣 Violet Claude Sollicité via CLI headless (claude -p ..., processus séparé de toute conversation) — jamais besoin de présence humaine NI d'une conversation Claude Code active.
🟢 Vert Antigravity Sollicitée via l'appel direct intégré (common.run_antigravity_direct, CLI headless agy -p ... avec proxy SOCKS5 + permissions auto-approuvées) — remplace depuis le 14/10/2026 l'ancien système IDU d'injection CDP/CTP dans sa fenêtre UI (port 9333, cdp_inject_antigravity.py). Mêmes outils (terminal/fichiers/navigateur) qu'en mode agentique, appel bloquant cette fois (plus de polling DOM). S'applique à l'ensemble des étapes : Tri Croisé, Filtre Visuel Vidéo et Juge Produit en repli.
⚪ Gris Raphael Déclenche la mission (une seule commande). N'intervient plus ensuite sauf garde-fou ou décision explicite qu'il a demandé à garder (aucune aujourd'hui — tout le pipeline est allé de bout en bout sans lui le 19/08/2026).

Table de référence — état RÉEL au 19/08/2026 (tout est construit et testé en live)

# Étape Script réel Statut
0 Initialisation mission : garde-fous reset, watchdog démarré/vérifié, task_running.json écrit (pour que task_watchdog.py sache qu'une mission scriptée est active) chasse_orchestrateur.py setup ✅ Construit, testé.
1 Scan Minea (Option A, fenêtre --jours) avec détection dynamique de fin de page réelle (hauteur de page + nouvelles cartes, plus de compteur de scrolls fixe) minea_scraper.py option-a-scan ✅ Reconstruit le 19/08/2026. Sort arret_raison : limite_candidats_atteinte / budget_temps_epuise (garde-fou pur, 150s) / fond_de_page_atteint (seul signal fiable de fenêtre épuisée).
1→2a/2b Tri Croisé (lot entier) : prompt → Claude headless → décision, puis antigravity_triage.py cross-triage réconcilie avec la décision Antigravity (appel direct headless CLI agy -p, sans CDP/CTP). Accord ELIMINE → éliminé. Désaccord → GARDE par défaut. chasse_orchestrateur.py triage ✅ Construit, testé.
2→9 Pour CHAQUE candidat shortlisté, traitement unitaire strict (un seul en vol à la fois, jusqu'au bout — jamais en lot) : audit concurrent + plancher prix → extraction média → sourcing natif puis secours RapidAPI → jugement visuel dual-IA (Claude frames + Antigravity vidéo complète via CLI headless direct agy -p) → réconciliation → écriture Tracker. Boucle jusqu'à objectif/garde-fou/épuisement de fenêtre (avec échelle d'escalade automatique : 5,15 → 1,5 → 15,30 → 30,60, seulement après 3 fond_de_page_atteint CONFIRMÉS sur la fenêtre courante). chasse_orchestrateur.py run (boucle principale) ✅ Construit, testé en conditions réelles le 19/08/2026 (mission chasse-4produits-20260819, 4/4 lignes écrites, 0 intervention manuelle).
⚠️ Sourcing échoué (natif + secours) Écrit quand même la ligne au Tracker (Prix d'achat/lien vides, Statut "À sourcer") — pas un rejet, juste "pas encore sourcé". Ne compte pas dans l'objectif tant que le Juge n'est pas passé en Mode RÉSERVE. tracker_writer.py --sourcing-statut echoue ✅ Construit, testé.
9→10 Dispatch mécanique du Juge, un candidat à la fois (Traitement Unitaire), sans AUCUNE décision prise en conversation — ni par Claude ni par Antigravity. Voir section dédiée ci-dessous, c'est le point le plus important pour la continuité. _run_judge_chain() dans chasse_orchestrateur.py (appelé automatiquement en fin de run, ou manuellement via chasse_orchestrateur.py judge) ✅ Construit et testé le 19/08/2026, avec repli automatique Antigravity si Claude échoue/timeout (ajouté ce soir même).
10 Jugement approfondi 7 filtres, un par produit product_judge.py (appelé PAR le Juge dispatché, pas directement par l'orchestrateur) Inchangé, utilisé tout le week-end.
10→11 Rapport final (classe Validé/Disqualifié, seulement après que le Juge a écrit un vrai verdict) report_generator.py generate --tracking-prefix ... ✅ Construit, testé. Envoie sur Telegram tout seul.
📊 Stats Dashboard statistique des rejets (Pre-Tracker + Post-Tracker) stats_rejets.py regenerate ✅ Construit le 19/08/2026. Génère rapport_stats_rejets_dashboard.html et envoie sur Telegram tout seul.
11→FIN Clôture mécanique : arrête le watchdog, supprime task_running.json, statut mission → mission_cloturee (fin de cmd_run, inline) ✅ Construit, testé.

Résumé opérationnel : depuis le 19/08/2026, python tools/chasse_orchestrateur.py run --mission <nom> --objectif <N> suffit — TOUT s'enchaîne (scan → tri → sourcing → jugement visuel → Tracker → Juge → rapport → clôture), sans qu'aucune IA n'ait besoin d'être en conversation pour décider quoi que ce soit. cmd_run gère lui-même la reprise d'une mission déjà commencée (relance sur le state.json existant).


Le Juge Produit (étape 9→10) — mécanique complète, y compris le repli Antigravity

C'est l'étape la plus critique pour la continuité pendant une absence de Claude (quota
épuisé), donc détaillée à part.

Comment ça marche (_run_judge_chain()) : pour chaque ligne écrite au Tracker et pas
encore jugée, dans l'ordre, un seul candidat à la fois :

  1. Dispatch vers Claude (claude -p ... en headless, isolé de toute conversation —
    AUCUN contexte de la chasse transmis, anti-biais-de-confirmation, décision du
    12/08/2026). Le prompt cite la SOP (SOP_Juge_Produit_scriptee_DRAFT.md) et demande
    d'appeler product_judge.py check-eligible/verdict (ou -reserve si le sourcing a
    échoué), puis d'écrire un résumé JSON dans un fichier signal.
  2. Attente jusqu'à 20 min (JUDGE_TIMEOUT_SEC) que ce fichier apparaisse.
  3. Si échec de dispatch immédiat OU timeout → repli automatique sur Antigravity :
    même prompt (adapté au libellé), exécuté via l'appel direct intégré
    (common.run_antigravity_direct, CLI headless agy -p ... — depuis le 14/10/2026,
    remplace l'ancienne injection CDP port 9333 dans sa fenêtre UI). Antigravity a les mêmes
    outils (terminal, lecture/écriture fichier, recherche web) qu'elle utilise déjà couramment
    en mode agentique — elle peut exécuter product_judge.py elle-même exactement comme
    Claude. Appel bloquant, fenêtre JUDGE_TIMEOUT_SEC_ANTIGRAVITY (15 min) ; le fichier
    signal doit déjà exister à son retour, plus besoin d'un repoll séparé de même durée.
  4. Si les deux ont échoué → verdict "timeout", candidat à rejuger manuellement plus tard.

Piloter quel agent utiliser — champ judge_executor du state.json de la mission,
3 valeurs possibles (réglable à setup, à run, ou à tout moment via judge) :
- auto (défaut) : Claude d'abord, repli Antigravity automatique si besoin. C'est le
mode normal, à ne pas changer sauf raison précise.

- antigravity_only : saute directement Antigravity, sans passer par Claude. À utiliser
explicitement si le quota Claude est connu épuisé
— évite d'attendre 20 min pour rien
avant le repli, sur CHAQUE candidat.
- claude_only : aucun repli (debug/comparaison uniquement).

Commandes utiles pour Antigravity si elle reprend seule :

# Rejuger un candidat resté en "timeout" (ex: après une coupure) :
python tools/chasse_orchestrateur.py judge --mission <nom> --candidate-id <id> --judge-executor antigravity_only

# Basculer TOUTE une mission sur Antigravity pour la suite (avant de relancer run) :
python tools/chasse_orchestrateur.py run --mission <nom> --objectif <N> --judge-executor antigravity_only

Important pour Antigravity : si tu es toi-même l'agent dispatché (processus CLI headless direct agy recevant le prompt qui commence par "Tu es le Juge Produit (agent antigravity)..."), suis-le
exactement comme un Cas C isolé de la SOP — n'ajoute PAS de contexte que tu aurais sur la
chasse en cours par ailleurs, c'est délibérément cloisonné.


Ce qui reste à construire (honnête, au 19/08/2026 — ne pas supposer que c'est fait)

Autres commandes CLI disponibles (débogage/reprise ciblée)

scan, triage, source (test isolé sourcing, n'écrit rien au Tracker), guardrail-check,
status (dump l'état complet d'une mission), judge (voir ci-dessus), mission-close
(clôture manuelle/secours — run le fait déjà tout seul en temps normal).