LifePlay-Revival/Docs/Migration/etat/U58/U2/U2-FICHES.md

Fiches U2 — Orchestrateur N2 — Modèle prévu Opus high | utilisé Opus 5.5 (claude-opus-5-5), 2026-10-08

# U2 — Retrait 4.27 et chemin moteur (plan 27 § U2)

Dossier de travail : `D:\Game\LifePlay-master 5.8`, branche `ue5.8` (à `1825884`, tag `U2-avant`).
Instantané : `D:\Game\LifePlay_Backup_5.5\U2` (944 fichiers : Source, Config, Tools, Docs, LifePlay.uproject, README.md).
Entrée : inventaire `etat/U58/U1/U1-RELIQUATS.md` (tableaux A–D) et décisions utilisateur du plan 27 § U2.
`EngineAssociation` reste `5.5` pendant U2 (bascule en U3) : la compilation de contrôle se fait avec UE 5.5.

## Conception retenue (orchestrateur)

- **Point unique du moteur** : `Tools/Engine.ps1`, dot-sourcé par les scripts. La version est **lue dans
  `LifePlay.uproject` (`EngineAssociation`)** : passer à 5.8 en U3 bascule tous les scripts sans autre édition.
  Variables exposées : `$LPProjectRoot`, `$LPProject`, `$LPEngineVersion`, `$LPEngineBase`
  (`D:\Game\Launcher\Engine`, seul chemin codé), `$LPEngineRoot` (`$LPEngineBase\UE_<ver>\Engine`, surchargé par
  `$env:LP_ENGINE_ROOT` s'il est défini), `$LPBuildRoot` (`D:\Game\LifePlay_Build_<ver>`). Erreur explicite si
  `$LPEngineRoot` n'existe pas.
- Dossiers de sortie : dérivés de la version → `_5.8` automatiquement après U3 (décision utilisateur) ;
  `Config/DefaultGame.ini` `StagingDirectory` (statique) passe à `D:/Game/LifePlay_Build_5.8` dès U2.
  `LifePlay_Backup_5.5` (sauvegardes) : inchangé.
- Retrait des fichiers : `git rm` (historique git + instantané U2 = copie préalable).

## U2-T1 — IMPL code C++ et config (N1, agent lp-impl, modèle sonnet)
1. Objectif : retirer les 16 commandlets D3 et nettoyer les références ; libellés « 4.27 » réécrits sans changement de comportement.
2. Note a–f : 1-1-0-1-1-0 (4) → N1.
3. Contexte : U1-RELIQUATS § B, § D ; décisions plan 27 § U2.
4. Entrées : `git rm` des 32 fichiers `Source/LifePlayEditorTools/<Nom>Commandlet.{h,cpp}` des 16 noms de § D.1 ;
   `LifePlayEditorTools.Build.cs` (commentaires l.33/36/39 ; une dépendance n'est retirée que si un grep prouve
   qu'aucun fichier restant du module ne l'utilise — sinon garder et le dire) ; commentaires qui citent un commandlet
   retiré : `LPAssetRegistryHelpers.h:10`, `LPNavigationHelpers.h:12`, `LPStringCompat.h:15`, `LPDataCompat.h:9` ;
   libellés « 4.27 » de `LPStringCompat.h/.cpp` et `LPTestStringCompatCommandlet.h/.cpp` (commentaires et chaînes de
   log) → « sémantique UE4 conservée en 5.8 » / « hérité(UE4) » ; `Config/DefaultEngine.ini` l.15, 19, 128 :
   commentaires réécrits (TAA validé en jeu 5.5, ERR-032 ; valeurs inchangées) ; commentaires historiques
   `LPCheckMeshesCommandlet.h:6`, `LPCheckStreetMapCommandlet.h:8/.cpp:50` réécrits sans 4.27.
5. Pièges : fichiers CRLF (garder la fin de ligne) ; `LPAssetListUtils.h` est partagé (garder) ; `LPResavePackages` et
   `LPTestStringCompat` gardés ; ne pas renommer fonctions, variables ni classes (`Find427`, `Stristr427` restent).
6. Interdits : aucune ligne de logique modifiée hors chaînes de log ; pas de `Tools/`, `Docs/`, `Plugins/` ; pas de
   compilation (T4) ; pas de commit.
7. Livrable `etat/U58/U2/U2-T1-IMPL.md` : liste des fichiers retirés (32), diff résumé par fichier, grep avant/après.
8. Acceptation : `git grep -n -E 'LPFix|LPConvertAtmosphericFog' -- Source Config` = 0 ; `git grep -inE '4\.27|UE_4' -- Source Config`
   ne renvoie que des en-têtes historiques justifiés un par un dans le livrable.
9. Arrêt : une référence à un commandlet retiré dans du code actif (non commentaire) → arrêt et rapport.

## U2-T2 — IMPL outils (N1, agent lp-impl, modèle sonnet)
1. Objectif : `Tools/Engine.ps1` (conception ci-dessus) lu par tous les scripts ; outils sans référence 4.27.
2. Note : 1-1-1-1-1-0 (5) → N1 (borne haute, conception fixée par l'orchestrateur).
3. Contexte : U1-RELIQUATS § A, § B (Tools), § D.4 ; décisions plan 27 § U2.
4. Entrées : créer `Tools/Engine.ps1` ; `RunCommandlet.ps1` et `BuildDebug.ps1` : paramètre `-Engine` gardé mais
   défaut vide → `$LPEngineRoot` ; `BuildDebug.ps1` archive sous `$LPBuildRoot`-`<Config>` (même forme que
   `D:\Game\LifePlay_Build_5.5_<Config>` aujourd'hui) ; exemples d'aide sans `LPFix*` ; `ReimportCorrectif.ps1`
   **adapté** (exemple sans `LPFix*`, moteur par `Engine.ps1`, appel `LPCheckMeshAssignment` gardé) ;
   `CheckIntegrity.ps1` : retirer `-Ref427`, `-InitRef427`, `$Root427`, T-STAT-04 (arbre 4.27) ; T-STAT-02 devient
   « Modules = référence `<ver>` » contre `<BackupRoot>\ref_modules_<ver>.csv` créé par un nouveau `-InitRef`
   (SKIP explicite si absent : la référence 5.8 sera figée après G-U6) ; `LogStats.ps1` l.6, 12 (commentaire et
   exemple A/B 5.5 contre 5.8) ; `Tools/debug/LifePlay_debug_ui.ps1:15-16` : chemins de build via `Engine.ps1`
   quand le script tourne depuis le dépôt (s'il est copié dans un build empaqueté, garder un repli sur `$PSScriptRoot`
   — lire le script avant) ; exemples `…_5.5_…` de `CollectDebugArtifacts.ps1`, `SplitModules.ps1`,
   `SummarizeDebugCsv.ps1` ; `AssetHeaders.ps1:7` reformulé « UE4 » ; `Config/DefaultGame.ini:16` → `_5.8`.
5. Pièges : PowerShell 7 et 5.1 (`sk-windows-shell`) ; dot-source `. "$PSScriptRoot\Engine.ps1"` ; chemin avec espace.
6. Interdits : `Snapshot.ps1`, `Restore.ps1` (BackupRoot inchangé) ; pas de `Source/`, `Docs/` ; pas de commit.
7. Livrable `etat/U58/U2/U2-T2-IMPL.md` avec preuve d'exécution : `. .\Tools\Engine.ps1; $LPEngineRoot` → UE_5.5 ;
   `$env:LP_ENGINE_ROOT` respecté ; `CheckIntegrity.ps1` lancé (aucune erreur de syntaxe) ; `Get-Help` des scripts.
8. Acceptation : `git grep -nE 'UE_5\.5|UE_4|4\.27|427' -- Tools` = 0 hors justification écrite ; aucun script de
   `Tools/` ne code `D:\Game\Launcher` en dehors d'`Engine.ps1`.
9. Arrêt : un script dont le comportement changerait au-delà du chemin → arrêt et rapport.

## U2-T3 — DOC bandeaux et docs actifs (N1, agent lp-writer)
1. Objectif : bandeau « historique 4.27 » sur les docs historiques ; docs actifs alignés sur `Tools/Engine.ps1`.
2. Note : 1-0-0-0-1-1 (3) → N1.
3. Contexte : U1-RELIQUATS § C ; règle « pas de réécriture du passé ».
4. Entrées : bandeau (sous le titre) sur 01, 02, 03, 04, 05, 06, 07, 11, 12, 17, `Architecture/Rapport_Session_2026-09-28.md`,
   `Architecture/VictoryPlugin_Architecture.md`, et les docs 13, 24 si leurs mentions sont historiques ; docs actifs
   mis à jour (pas de bandeau) : 08 Guide développeur, 09 Commandes utiles, 10 Protocole (une note : référence de
   comportement = build 5.5 validé, D5), `Docs/Migration/README.md` (index) — exemples `$UE = '…UE_5.5…'` remplacés
   par `. .\Tools\Engine.ps1` / `$LPEngineRoot`, commandlets retirés marqués « retirés en U2 (historique git) ».
5. Pièges : ne pas toucher Journal_Modifications, Registre_Erreurs, patchs `correctifs/*.patch`, 27, 28, README.md
   racine, Change_Logs.txt (CHG écrit par l'orchestrateur).
6. Interdits : pas de `Source/`, `Tools/`, `Config/` ; pas de réécriture de contenu historique ; pas de commit.
7. Livrable `etat/U58/U2/U2-T3-DOC.md` : fichiers modifiés, texte du bandeau, lignes changées dans 08/09/10/README.
8. Acceptation : `git grep -n 'UE_5\.5' -- Docs/Migration/08* Docs/Migration/09*` = 0.
9. Arrêt : doute sur le caractère historique ou actif d'un doc → le lister, ne pas trancher.

## U2-T4 — BUILD contrôle 5.5 (N0, agent lp-builder, modèle haiku) — après T1 et T2
Compilation `LifePlayEditor Win64 Development` de la copie 5.8 avec UE 5.5 (chemin pris dans `Tools/Engine.ps1`),
première compilation de la copie (pas de Binaries) ; puis `.\Tools\RunCommandlet.ps1 -Lot U2 -Commandlet LPTestStringCompat`.
Acceptation : code 0, toolset 14.38.33130 au journal, aucun avertissement nouveau, test vert.
Livrable `etat/U58/U2/U2-T4-BUILD.md`.

## U2-T5 — VAL (N1, agent lp-validator) — après T4
Recompte des greps d'acceptation T1–T3, lecture du diff entier `git diff U2-avant`, ajouts non demandés, verdict.
Livrable `etat/U58/U2/U2-VAL.md`.

## INT / DOC (orchestrateur)
CHG-252, plan 27 (résultat U2), doc 28, registre des reports (doc 21) ; commit sur `ue5.8` seulement ; skill
`lp-commandlets` mise à jour (local) ; mémoire. Rien n'est poussé.