LifePlay-Revival/Docs/Migration/etat/REL/STM1/STM1-B6-FIN.md

Fiche STM1-B6 (IMPL O2 + BUILD-FIN, STM1-SPEC-08) — Niveau N3 — Modèle prévu opus medium | utilisé claude-opus-5-5 — Agent session « Medium · STM1 » (pas de sous-agent) — Skills sk-protocol

STM1-B6 : masquage des maisons génériques posées dans l'eau (O2, option D) (2026-10-20)

Décisions :

• choix de l'utilisateur, tapé dans cette session et cité mot pour mot : « option D » ;
• GO de Big Boss sur SPEC-08 et sur le code sans processus UE ;
• puis GO de jeton UE (après la BUILD-FIN de KEY2). Ordre : CopieEtat, instantané, éditeur, commandlet (Water/CentralLondon_Mask, seul asset écrit), Development.

Résultat : code et builds à 0. Masque écrit (59 centres). Aucun autre asset modifié. L'essai en jeu reste à faire (build d'essai sur ordre de l'utilisateur).

1. Code

Fichier	État	MD5 avant (instantané STM1-O2)	MD5 après	Lignes	Fins de ligne
Source/LifePlay/LPCityWaterMask.h	A	–	966dc14d525c34c7fd19d0f0b73b8a6d	34	LF (0 CR)
Source/LifePlay/LPCityWaterSubsystem.h	M	DEB58EC1…	2cdc10018eb1287d7f9e302eee182185	72	LF (0 CR)
Source/LifePlay/LPCityWaterSubsystem.cpp	M	EC0946C5…	9c0b257ee0ae377146aeda72519330bf	323	LF (0 CR)
Source/LifePlayEditorTools/LPBuildCityWaterCommandlet.cpp	M	C5709BDD… (après O3) ; 69746A35… avant O3 (instantané STM1-O3)	fa6fbb72cabc0fd73663ef0e86942309	731	LF (0 CR)

• ULPCityWaterMask (UDataAsset, module LifePlay) : City, SourceBuildingCount, Centers (centres de boîte, repère de la carte, cm) et AreasM2.
• Commandlet, deux options :
  • -ListBuildingsInWater=<f.md> [-ThresholdM2] (O3) ;
  • -MaskOnly (O2) : écrit /Game/Heavy/StreetMap/Water/<Ville>_Mask. Il ne relit ni ne réécrit le maillage d'eau, refuse d'écraser un masque existant, et ne fait qu'un rapport en -DryRun.
• Sous-système de l'eau :
  • LoadMask est appelé à chaque changement de carte ;
  • HideHousesInWater traite les UInstancedStaticMeshComponent de MapMarkers dont le maillage commence par House ou Skyscraper. Les arbres et jeeps ne sont pas touchés ;
  • chaque instance est ramenée dans le repère de la carte, puis comparée aux centres du masque (≤ 50 cm, cases de 1 m) ;
  • une instance trouvée est mise à l'échelle 0 par UpdateInstanceTransform, avec un MarkRenderStateDirty par composant ;
  • une nouvelle passe a lieu quand le nombre d'instances change ;
  • constantes : SpareAboveAreaM2 = 0 (option D : aucune épargne), MatchToleranceCm = 50, MaskCellCm = 100 ;
  • témoin, écrit au changement seulement : [LPCity] EAU <Ville> : masque n centres ; instances maisons N ; masquees m ; epargnees k (seuil s m2) ; centres sans instance c.
• Aucun Blueprint, GI, MapMarkers ni carte modifié. Aucune lecture du GI ajoutée.

2. Builds et commandlet (jeton UE)

#	Geste	Résultat	Résumé
1	CopieEtat -Lot STM1 avant	proc=0 ; alertes GIT attendues (fichiers STM1 et LPKeyboardSubsystem.cpp de KEY2)	STM1-B6-AVANT.json
2	Instantané STM1-O2 : 3 sources, puis Content\Heavy\StreetMap\Water (CentralLondon 5BDF4F0A, M_LP_Water D413292C)	5 entrées	LifePlay_Backup_5.5\STM1-O2\manifest.csv
3	Build.ps1 -Lot STM1 -EtatDir <absolu> (éditeur)	code=0 duree=52s erreurs=0 avertissements=1 unites=3	STM1_Build_20261020-162803.txt
4	LPBuildCityWater … -MaskOnly -DryRun	code=0 ; 59 centres ; masque non écrit	STM1_LPBuildCityWater_20261020-162902.txt
5	LPBuildCityWater … -MaskOnly	code=0 duree=21s ; asset ecrit : /Game/Heavy/StreetMap/Water/CentralLondon_Mask, 59 centres sur 49425 batiments ; maillage d'eau non touche	STM1_LPBuildCityWater_20261020-162935.txt
6	Build.ps1 -Lot STM1 -Target LifePlay -Config Development -EtatDir <absolu>	code=0 duree=53s erreurs=0 avertissements=1 unites=2	STM1_Build_20261020-163006.txt
7	CopieEtat -Lot STM1 après ; UeState	proc=0 parasites=0 verrou=243:libre ; processus=0	STM1-B6-APRES.json

L'avertissement unique des deux builds est le C4701 de LPCameraModeSubsystem.cpp(2378), fichier du lot CAM2 et antérieur à STM1.

Les sorties des commandlets sont passées par le scratchpad (chemin sans espace, leçon d'O3) ; ce chemin est neutralisé dans les résumés.

3. MD5 des assets

Asset	MD5	Taille	État
Content/Heavy/StreetMap/Water/CentralLondon_Mask.uasset	F6F684B295B31298F8FB747F4F5946F4	2 712 o	A (seul fichier écrit dans Content, hors git)
Water/CentralLondon.uasset	5BDF4F0A6B3E709DAE9EFCFE8BCA2F6E	391 602 o	inchangé
Water/M_LP_Water.uasset	D413292C80C8C190766AD83ACFE2E418	5 717 o	inchangé
BPs/GI / BPs/MapMarkers / BPs/StreetMap_Static	32FC0A97 / FB72765C / B7F20462	–	inchangés (identiques à B5)
StreetMap/CentralLondon / Static/CentralLondon	A6C4D9B6 / FBA15A84	–	inchangés

find Content -newer <début du build éditeur> ne renvoie que CentralLondon_Mask.uasset. LPKeyboardSubsystem.cpp (KEY2) vaut toujours 0eb6a592 : non touché.

4. Essai en jeu (à faire, sur ordre de l'utilisateur)

Une build d'essai cuite est nécessaire : elle inclut le masque, puisque /Game est cuit en entier.

Sur la carte de Londres, en mode par défaut :

• plus aucune maison générique sur la Tamise (59 bâtiments visés) ;
• ponts, jeeps, arbres et quais intacts ;
• une ligne [LPCity] EAU CentralLondon : masque 59 centres ; … masquees ≈ 59 ; epargnees 0 (seuil 0 m2) ; centres sans instance ≈ 0.

Si le nombre de centres sans instance est élevé, le repère des instances diffère de celui de la carte : à diagnostiquer avant toute retouche.

5. Fichiers

• Projet : LPCityWaterMask.h (A) ; LPCityWaterSubsystem.h et .cpp (M) ; LPBuildCityWaterCommandlet.cpp (M).
• Hors git : Content/Heavy/StreetMap/Water/CentralLondon_Mask.uasset (A).
• Livrables : STM1-SPEC-08.md, STM1-B6-FIN.md, STM1-B6-AVANT.json, STM1-B6-APRES.json, résumés de build et de commandlet ci-dessus.
• CHG : à réserver (brouillon).

État : O2 implémenté et compilé, jeton UE rendu ; essai en jeu en attente.