LifePlay-Revival/Docs/Migration/etat/REL/MAPDL1/MAPDL1-REX-2026-10-22.md

Fiche MAPDL1-REX-2026-10-22 — Niveau N2 — Modèle prévu opus medium | utilisé claude-opus-5-5 — Agent session « Medium · MAPDL1 » — Skills sk-protocol, lp-lot, lp-city

MAPDL1 : retour d'expérience pour les skills et les agents (2026-10-22)

Demande de l'utilisateur, citée mot pour mot par Big Boss : « je souhaite aussi leur retour d'expérience pour enrichir les skills et agents ».

Cette fiche ne touche ni les skills ni les agents : Big Boss les posera après l'accord de l'utilisateur.

Chaque leçon donne quatre choses :

• Fait : ce qui a été observé, avec sa preuve (fichier:ligne, ou livrable du lot) ;
• Règle : ce qu'il faut retenir ;
• Où : le skill et sa section, ou l'agent ;
• Texte : un texte prêt à coller.

Priorités :

• P1 : évite une perte de données, une build cassée ou une donnée fausse ;
• P2 : évite des tours ou des allers-retours ;
• P3 : confort.

P1

R1. Le Move du moteur supprime la destination

• Fait : IFileManager::Move(Dest, Src, Replace=true, …) supprime d'abord la destination (Engine/Source/Runtime/Core/Private/HAL/FileManagerGeneric.cpp:303). E5 a donc choisi Move(…, false, false, false, true) (LPCityMapsDownload.cpp:109) pour ne jamais rien supprimer. Vu en relecture, avant tout dégât.
• Règle : dans un code qui « ne supprime jamais », Replace est toujours false. On écarte d'abord la destination existante par un déplacement horodaté.
• Où : lp-ue-compat, nouvelle section « API de fichiers » ; rappel dans sk-change-safety.
• Texte : « IFileManager::Move avec bReplace=true supprime la destination avant de déplacer (FileManagerGeneric.cpp:303). Pour une pose sans suppression : Move(Dest, Src, /*Replace*/false, /*EvenIfReadOnly*/false, /*Attributes*/false, /*bDoNotRetryOrError*/true), après avoir déplacé l'ancienne destination dans un dossier horodaté. Source : MAPDL1-E5. »

R2. OpenSSL dans un module du jeu : conflit de UI

• Fait : E2 bis a échoué sur une erreur unique, openssl/ossl_typ.h(144,22): error C2365: 'UI' : redéfinition ; la précédente définition était 'espace de noms' (MAPDL1-E2B-BUILD.md). La correction est la parade du moteur, #define UI UI_ST avant les en-têtes et #undef UI après (BuildPatchServices/Private/Common/Crypto.cpp:6-12). E2 ter a ensuite rendu code 0.
• Règle : on n'inclut jamais openssl/*.h sans cet encadrement. Avant de lancer la build, on cherche par Grep tous les fichiers qui incluent OpenSSL : une seule build doit suffire.
• Où : lp-ue-compat (ruptures connues) et ue-cpp-build (C2365).
• Texte : « OpenSSL : #define UI UI_ST / THIRD_PARTY_INCLUDES_START / #include "openssl/evp.h" / THIRD_PARTY_INCLUDES_END / #undef UI. Sans cela : C2365 'UI' (le typedef d'OpenSSL heurte l'espace de noms UI d'UE). Modèle : Engine/Source/Runtime/Online/BuildPatchServices/Private/Common/Crypto.cpp:6-12. »

R3. Height d'un UStreetMap est en centimètres

• Fait : StreetMap.h:304 annonce des « meters », mais l'import écrit des centimètres (StreetMapFactory.cpp:387). Le GeoJSON de S7 en tient compte : height_m = Height / 100 (MAPDL1-S7-IMPL.md § 2).
• Règle : toute lecture de FStreetMapBuilding::Height passe en centimètres, quel que soit le commentaire.
• Où : lp-city § 2, tableau des pièges de géométrie.
• Texte : « FStreetMapBuilding::Height est en cm, malgré le commentaire « meters » (Public/StreetMap.h:304 ; écrit en cm par StreetMapImporting/StreetMapFactory.cpp:387) | établi, MAPDL1-S7 ».

R4. Une session compile le code posé par une autre

• Faits :
  • La build de l'éditeur de COM31 a rendu Target is up to date, avec 0 unité. La ligne R-1 avait en effet déjà été compilée à 18:23 par la build de la 1.7.4 de Paris : la DLL de l'éditeur était plus récente que la source (MAPDL1-COM31-BUILD.md). lp-builder y a vu un « échec probable » et s'est arrêté.
  • W1 et W2, posés par MAPDL1 sans être compilés, ont été compilés par le build de la 1.7.7 de STM1 (STM1-155, code 0).
  • MAPDL1 et STM1 se sont échangé leurs listes de fichiers : aucun recouvrement.
• Règles :
  • (a) Avant d'appeler « échec » un Target is up to date, on compare la date de la DLL ou de l'exe à celle de la dernière source modifiée.
  • (b) Tout code posé non compilé est annoncé aux autres sessions, avec ses MD5 : leur build le compilera, et une casse doit revenir à son auteur.
  • (c) Avant d'écrire dans Source\, chaque session publie sa liste de fichiers et attend le signal de Big Boss.
• Où : lp-build § 8 pour (a) ; lp-lot/boss.md pour (b) et (c) ; agent lp-builder pour (a).
• Texte (lp-builder) : « Target is up to date avec 0 unité n'est pas un échec si la DLL ou l'exe est plus récent que la source modifiée : une autre session a déjà compilé. Relève les deux dates (Get-Item), rapporte, et continue la fiche si elle le prévoit. »
• Texte (boss.md) : « Code posé non compilé : son auteur l'annonce à Big Boss et aux sessions qui compilent (fichiers et MD5). La première build qui le compile rapporte toute erreur à l'auteur. Écriture dans Source\ : liste des fichiers échangée entre les sessions, puis signal de Big Boss. »

R5. Reprise à l'identique d'une ancienne carte UE4

• Faits :
  • Les cartes « NEW Maps » de Mega sont des UStreetMap UE4 cuits, non versionnés (legacy −7, ue4 = 0, drapeaux 0x80000000), avec des propriétés étiquetées. On les lit hors moteur (LireCarteUE4.py) et on les reprend par réflexion (LPImportLegacyStreetMap, MAPDL1-P1-IMPL).
  • Le maillage LPBuildCityStatic -Flat passe la comparaison avec Londres (1,59 %). Le réglage par défaut et -Unlit échouent (58 %).
  • -Unlit réduit le nombre de sommets, pas celui des triangles.
  • Formule des triangles classiques : 3·Pb − 2·B, écart observé de 0 à −0,18 %.
  • Poids de la 3D classique : environ 20 octets par triangle dans l'archive (MAPDL1-AUTO-FIN § 2).
  • Un asset pilote laissé sous Content\ a cassé la cuisson des packs (DirectoriesToAlwaysCook couvre /Game).
• Règles :
  • reprise par réflexion, sans conversion ;
  • -Flat pour le maillage statique repris ;
  • aucun asset de travail sous Content\ entre deux sessions ;
  • fourchettes de contrôle tirées de la formule.
• Où : lp-city, nouvelle section « 9. Reprise d'une ancienne carte LifePlay (Mega) » ; lp-commandlets, table des cartes, avec une ligne LPImportLegacyStreetMap.
• Texte (lp-city § 9) : « Ancienne carte Mega = UStreetMap UE4 cuit, non versionné (legacy −7, ue4 = 0, drapeaux 0x80000000), propriétés étiquetées. Lecture hors moteur : Tools\LireCarteUE4.py --totaux ; reprise : LPImportLegacyStreetMap (réflexion, -DryRun) ; chaîne : RepriseCarte.ps1 (Lire, Creer, Importer, Classic, ODbL). Maillage statique : -Flat (Londres 1,59 % ; défaut et -Unlit 58 %). Triangles classiques ≈ 3·Pb − 2·B (écart de 0 à −0,18 %) ; environ 20 o par triangle dans l'archive. Jamais d'asset de travail sous Content\ (cuisson cassée, MAPDL1-P1). Les données (sans lat/lon ni identifiants OSM) se livrent en GeoJSON en plan local (SPEC-07). »

P2

R6. Exécutants haiku et chemins sous Git Bash

• Faits :
  • EXEC-1 s'est arrêté sur un code 64 : le chemin du script, qui contient une espace, n'était pas entre guillemets dans Git Bash (MAPDL1-AUTO-EXEC-1.md).
  • Avec un chemin absolu entre guillemets et des barres obliques, le lot 1 est passé (5 villes sur 5) sans aucune décision à prendre (AUTO-FIN § 2).
  • Snapshot.ps1 ne pose pas de code de sortie : il faut $global:LASTEXITCODE = 0 avant l'appel.
  • Un if à un seul élément devient un scalaire : il faut @(if …) (JOURNAL-BROUILLON, 14:15).
• Règles :
  • une brève pour haiku donne chaque commande en entier, avec un chemin absolu entre guillemets et des / ;
  • elle ne laisse aucun choix ;
  • elle donne le code attendu et l'arrêt sur tout écart.
• Où : sk-windows-shell ; agent lp-builder ; sk-orchestrate (fiche pour un modèle réduit).
• Texte (sk-windows-shell) : « Git Bash et chemin avec espace : pwsh -NoProfile -File "D:/Game/LifePlay-master 5.8/Tools/X.ps1" (guillemets, /). Sans guillemets : code 64. Tools\Snapshot.ps1 ne pose pas de code : $global:LASTEXITCODE = 0 avant l'appel. PowerShell : un if qui rend un seul élément est un scalaire ; écrire @(if …). »

R7. Dépassement du budget de tours (S7 : 62 pour 40)

• Fait : lp-impl (sonnet) a utilisé 62 tours pour 40 (MAPDL1-S7-IMPL.md). Causes déclarées :

  • débogage de commandes inline ;
  • l'unité de Height ;
  • des essais ajoutés hors de la fiche (un vrai passage d'ODbL en plus du -ABlanc demandé).

  La fiche couvrait 3 outils liés physiquement, l'écriture en place et 3 villes d'essai, au niveau N3 avec 40 tours.

• Règles :

  • une fiche qui touche 3 outils avec des essais mesurés reçoit 60 tours ;
  • les commandes répétées passent par un script ponctuel Saved\<lot>\ dès le 2e essai, pas en inline ;
  • aucun essai hors de la fiche sans le noter comme écart avant de le lancer.

• Où : sk-orchestrate (barème du budget) ; agent lp-impl ; sk-protocol § 8.

• Texte (lp-impl) : « Une commande longue ou répétée (pwsh inline, chemins avec \) passe par un script ponctuel Saved\<lot>\ dès le 2e essai. Un essai que la fiche ne demande pas ne se lance pas ; on le propose dans le compte rendu. »

• Texte (sk-orchestrate) : « Budget : 3 fichiers ou plus, plus des essais mesurés = 60 tours (N3), pas 40. »

R8. Mise en page Slate : contrôle obligatoire hors de la zone qui défile ; habillage des chemins

• Faits :
  • Dans COM31, la case d'accord était dans la même SScrollBox (plafonnée par SBox::MaxDesiredHeight) que la licence dépliée : elle passait sous le cadre (cas B2, TESTS-02 § E).
  • AutoWrapText ne coupe qu'entre deux mots : un chemin sans espace dépasse (B8).
  • Correctifs W1 :
    • la case et les messages sortent de la zone qui défile ;
    • .WrappingPolicy(ETextWrappingPolicy::AllowPerCharacterWrapping) (STextBlock.h:121, TextLayout.h:72) ;
    • la hauteur de la zone suit le viewport (UWidgetLayoutLibrary::GetViewportScale).
• Règles :
  • les contrôles obligatoires (case d'accord, boutons) et les messages ne vont jamais dans une zone qui défile ;
  • tout texte qui peut contenir un chemin ou une URL reçoit AllowPerCharacterWrapping ;
  • une fenêtre se vérifie en 1280×720.
• Où : agent lp-impl (rubrique Slate et UMG) ; lp-ue-compat (API Slate 5.8).
• Texte : « Slate : les contrôles obligatoires et les messages hors de la SScrollBox (plafonnée par SBox::MaxDesiredHeight, qui peut suivre le viewport : MaxDesiredHeight_Lambda + UWidgetLayoutLibrary::GetViewportScale). Chemin ou URL : .WrappingPolicy(ETextWrappingPolicy::AllowPerCharacterWrapping), car AutoWrapText ne coupe qu'entre deux mots. Vérifier en 1280×720. Source : MAPDL1, essai COM31 (B2, B8). »

R9. Fichier partiel vide après un échec réseau

• Fait : CreateFileWriter(…, FILEWRITE_Append) crée le fichier, et son dossier, avant le premier octet. L'échec voulu de B5 (DNS) a laissé Saved\Downloads\lpm_city_manila\…zip.part de 0 octet dans un dossier visible (B9). Correctif W2 :
  • le .part est écrit à côté du zip ;
  • à l'échec et à l'annulation, un .part vide est déplacé dans _rejet\ (SetAsideEmptyPart), sans aucun Delete.
• Règle : un téléchargement qui échoue sans recevoir d'octet ne laisse ni fichier ni dossier visible. On le range (déplacement), on ne le supprime pas.
• Où : agent lp-impl ; lp-ue-compat (HTTP).
• Texte : « HTTP en flux (SetResponseBodyReceiveStream) : le .part existe dès l'ouverture. À l'échec ou à l'annulation, s'il fait 0 octet, le déplacer dans _rejet\ ; pas de sous-dossier par téléchargement. Source : MAPDL1 W2. »

R10. Le cahier d'essai se calcule comme le code

• Fait : le cahier attendait « Download (21 MB) » pour 22 075 120 octets. Le jeu affiche 22, car il arrondit au-dessus (LPCityMapsSubsystem.cpp:734). C'est le cahier qui avait tort (TESTS-02 A1).
• Règle : une valeur attendue se calcule par la formule du code, qu'on cite, et non de tête.
• Où : lp-doc (gabarit FIT) ; agent lp-writer.
• Texte : « Valeur attendue d'un affichage : la calculer par la formule du code, avec fichier:ligne (arrondi, unités). Exemple : 22 075 120 o → « 22 MB » (Mo arrondi au-dessus). »

P3

R11. Crochet ecriture-gardien et agents de lecture

• Fait observé dans MAPDL1 : une commande Bash de lp-validator (E3 bis) a été refusée par le crochet, à cause d'un accent grave dans le texte. C'était un faux positif, sans effet ; l'agent l'a relancée sans ce caractère (MAPDL1-E3B-VAL.md, compte rendu).
• Non observé dans MAPDL1 : le blocage des agents de collecte que cite Big Boss. Big Boss le complète avec ses propres preuves.
• Règle : pour un agent sans Edit, pas d'accent grave ni de > dans les commandes du shell. Les recherches passent par Grep ou Read.
• Où : sk-protocol § 7 (agents sans Edit) ; hooks\cas-v2.jsonl (cas d'essai).
• Texte : « Agent sans Edit : aucune commande shell avec accent grave, > ni ->, même dans du texte cité ; le crochet ecriture-gardien les refuse (faux positif, MAPDL1-E3B). Reformuler, ou passer par Grep et Read. »

R12. Outils liés physiquement : écriture en place

• Fait : IndexCartes, LireCarteUE4, RepriseCarte et RecetteCarte sont des liens physiques entre le jeu et l'addon. Ils ont été écrits par [IO.File]::WriteAllBytes, qui tronque le même fichier. Les MD5 sont identiques des deux côtés et fsutil montre 2 liens (S6-1-IMPL, S7-IMPL). La mémoire du projet le disait déjà ; les fiches l'ont rappelé à chaque fois.
• Règle : la règle est déjà en mémoire ; il faut l'écrire dans le skill.
• Où : lp-paths (Outils du jeu) ; agents lp-impl et lp-writer.
• Texte : « Beaucoup de fichiers de Tools\ sont liés physiquement à l'addon : Edit et Write rompent le lien. Vérifier par fsutil hardlink list ; écrire en place par [IO.File]::WriteAllBytes(<Tools>, [IO.File]::ReadAllBytes(<brouillon>)) ; relire les 2 liens et les 2 MD5. »

R13. EtatDir.ps1 ne connaît pas un nouveau lot

• Fait : Build.ps1 a écrit ses résumés dans etat\MAPDL1-E2B\, etat\MAPDL1-E2T\ et etat\MAPDL1-COM31\, à la racine d'etat\. Ils ont été déplacés à la clôture (MAPDL1-BILAN § 6).
• Règle : à l'ouverture d'un lot, on ajoute sa règle à EtatDir.ps1, ou on passe -EtatDir à chaque Build.ps1 et à chaque RunCommandlet.ps1.
• Où : lp-lot (Avant toute modification) ; agent lp-builder (passer -EtatDir si la fiche le donne).
• Texte : « Nouveau lot : règle dans Tools\EtatDir.ps1, ou -EtatDir <etat>\<projet>\<lot> sur chaque Build.ps1 / RunCommandlet.ps1. Sinon, les résumés vont à la racine d'etat\ (MAPDL1). »

R14. Avertissement préexistant à séparer d'un effet nouveau

• Fait : Accessed None … property GI in /Game/UI/CityMenu.CityMenu_C apparaît 5 fois dans l'essai COM31. Il figure déjà dans les 6 derniers journaux de COM30, sans E1 (TESTS-02 § E).
• Règle : avant d'attribuer un avertissement à un lot, on le compte dans les journaux de la build précédente.
• Où : lp-validate § 3 ; agent lp-validator.
• Texte : « Avertissement en jeu : le compter dans les journaux de la build d'avant (Saved\Logs\*.log) avant de l'attribuer au lot. Exemple : CityMenu GI (Accessed None), préexistant à MAPDL1. »

Fichiers

• A Docs/Migration/etat/REL/MAPDL1/MAPDL1-REX-2026-10-22.md
• Aucun skill ni agent n'est modifié.