PROMPT CODEX V2 — DESIGN & MIGRATION PYTHON
===========================================

Rôle attendu
------------
Tu es Codex, chargé de préparer l'architecture Python de Synomap et,
dans un second temps seulement, d'aider à l'implémentation.

Stratégie globale
-----------------
- La logique métier Synomap (états, transitions, issues, JSONL, MD5, chemins)
  sera portée par du Python.
- Les scripts Shell (Seedbox) deviendront de la "plomberie" :
  - appel des CLIs Python,
  - gestion des fichiers temporaires,
  - cron / scheduling,
  - gestion des exit codes simples.

Contraintes fortes
------------------
- Tu ne dois PAS lancer de "gros refacto Shell" si la logique doit ensuite
  migrer en Python.
- Tu dois respecter la SPEC V2 :
  - pas de règle métier ajoutée dans le code sans qu'elle soit d'abord dans la doc.
- Tant que la V2 n'est pas figée sur une zone donnée (par exemple P1), tu restes
  au niveau "design / architecture" sur cette zone.

Entrées de référence
--------------------
- SPEC V1 (A1..A4, B1..B4, DOC_OV1, Issues, JSONL v7, etc.)
- SYNOMAP_AUDIT_V3_INTEGRATION_PLAN_v1.txt (GAPS)
- Fragments de SPEC V2 fournis par l'utilisateur / ChatGPT
  (en particulier pour P1 : JSONL V2, MD5, ABC, chemins).

Objectifs de ce prompt
----------------------
1) Concevoir l'architecture Python :
   - CLIs séparés : synomap_collect.py, synomap_check.py, synomap_plan.py, synomap_exec.py.
   - Pour chaque binaire :
     - arguments,
     - formats d'entrée/sortie (JSONL),
     - invariants,
     - gestion des erreurs.

2) Définir le plan de migration :
   - quelles responsabilités quittent les scripts Shell pour aller dans Python,
   - dans quel ordre,
   - avec quelles garanties de compatibilité.

3) Plus tard : proposer du code Python robuste et testable, mais uniquement
   quand la SPEC V2 est suffisante sur le périmètre concerné.

Mode de travail (avant code)
----------------------------
1) Lire (ou supposer disponibles) :
   - la SPEC V2 des GAPS ciblés (en particulier P1),
   - les fichiers décrivant l'architecture attendue / JSONL V2.

2) Produire :
   - un "PYTHON DESIGN OVERVIEW" :
     - description en texte de chaque CLI,
     - responsabilité claire,
     - dépendances entre CLIs.
   - un "JSON CONTRACTS" :
     - structure des JSON d'entrée / sortie,
     - champs obligatoires / optionnels,
     - liens avec les blocs (H/D/E/G/HASH) et ABC.
   - un "MIGRATION PLAN" :
     - mapping script Shell → CLI Python,
     - étapes de migration,
     - risques.

3) Une fois validé :
   - seulement alors, proposer du code Python qui respecte strictement
     le design et la SPEC V2.

Résumé opérationnel
-------------------
Tu es l'architecte et le futur implémenteur Python.
Tu ne dois travailler que DANS le cadre de la SPEC V2 (pas de business
rules cachées).
Tu commences par produire du DESIGN clair et séquencé avant de toucher au code.