LifePlay-Revival/Docs/Migration/etat/ST/STG/STG-M1d-VAL.md

# STG-M1d-VAL : validation statique du bloc COUPLE de LPDebugSubsystem (2026-10-14)

Fiche STG-M1d-VAL — Niveau N1 — Modèle prévu lp-validator (sonnet) | utilisé claude-sonnet-5-5 — Agent lp-validator — Skills sk-protocol, sk-recount, debug-verification, lp-validate

Lot STG, copie `D:\Game\LifePlay-master 5.8`, branche ue5.8. Lecture seule sauf ce livrable. Pas de build, pas d'UE, rien lancé.

## 1. Fiches amont relues

- `Docs\Migration\etat\ST\STG\STG-M1d-IMPL.md` (IMPL, points à confirmer § 4).
- `Docs\Migration\etat\ST\STG\STG-C54-DIAG.md` § 5 (mesure M1d : os le plus bas, bassin, surface sous le bassin, animation et position dans le cycle) : le bloc répond à ce § 5.
- Instantané `D:\Game\LifePlay_Backup_5.5\STG-M1d\` (`manifest.csv` : `LPDebugSubsystem.cpp`, 29622 octets, MD5 `E281ACE2…`).

## 2. Points à confirmer de l'IMPL (§ 4)

| Id | Point | Résultat | Preuve |
|---|---|---|---|
| P1 | diff limité au bloc M1d | PASS-STATIC | § 3 et § 4 : 1 hunk, +50 / -0, bloc M1d seul |
| P2 | API UE 5.8 | **FAIL** (un appel non compilable) | `UAnimSingleNodeInstance::GetLength()` non const, voir écart 1 ; le reste PASS-STATIC (tableau § 5) |
| P3 | aucun effet de bord, lecture seule | PASS-STATIC | § 6 |
| P4 | compilation au build COMMUN-6 | reporté (non mesurable sans build) ; **annoncé en échec** par P2 | écart 1 |

## 3. Critères rejoués (commande, sortie brute)

MD5 (`certutil -hashfile … MD5`) :
```
LPDebugSubsystem.cpp : 31e2a3c5ff4a3feb5d9d5bf1c1b0afb0   (attendu 31E2A3C5FF4A3FEB5D9D5BF1C1B0AFB0 : conforme)
LPDebugSubsystem.h   : 78d3a07957d81e0b39c5d9a81e5e03d3   (attendu 78D3A079… : conforme, inchangé)
```
Fins de ligne (`.\Tools\FileCheck.ps1 Source/LifePlay/LPDebugSubsystem.cpp,Source/LifePlay/LPDebugSubsystem.h`) :
```
CRLF  819  0  0 -   31E2A3C5FF4A3FEB5D9D5BF1C1B0AFB0  Source\LifePlay\LPDebugSubsystem.cpp
CRLF   53  0  0 -   78D3A07957D81E0B39C5D9A81E5E03D3  Source\LifePlay\LPDebugSubsystem.h
fichiers=2 CRLF=2 alertes=0 introuvables=0     exit=0
```
`git ls-files --eol` : `i/crlf w/crlf` pour le `.cpp`. CRLF homogène (LF seul = 0, CR seul = 0).

Diff instantané → actuel :
`git diff --no-index --numstat --ignore-cr-at-eol <instantané>\…\LPDebugSubsystem.cpp Source/LifePlay/LPDebugSubsystem.cpp` → `50  0` ; `-U0 … | grep -c '^@@'` → `1`.

## 4. Diff lu en entier

Un seul hunk, `@@ -492,0 +493,50 @@`, 50 lignes ajoutées (l. 493 à 541 du fichier actuel, dont la ligne vide finale), 0 supprimée : le bloc M1d, inséré entre la fin du bloc `GIState` (l. 491) et le commentaire « Paires de personnages visibles » (l. 543). Aucun autre changement. P1 : PASS-STATIC. (Le diff contre HEAD montre 318 lignes, ce sont les lots antérieurs non commités : hors périmètre.)

## 5. API UE 5.8 (en-têtes `D:\Game\Launcher\Engine\UE_5.8\Engine\Source\Runtime\Engine\`)

| Appel du bloc | Déclaration lue | Const sur l'objet utilisé | Verdict |
|---|---|---|---|
| `Body->GetNumBones()` (`const USkeletalMeshComponent*`) | `Classes/Components/SkinnedMeshComponent.h:1144` `int32 GetNumBones() const` | oui | OK |
| `Body->GetBoneName(int32)` | `SkinnedMeshComponent.h:1165` `FName GetBoneName(int32) const` | oui | OK |
| `Body->GetBoneIndex(FName)` | `SkinnedMeshComponent.h:1156` `int32 GetBoneIndex(FName) const` | oui | OK |
| `Body->GetBoneLocation(FName)` | `SkinnedMeshComponent.h:2014` `FVector GetBoneLocation(FName, EBoneSpaces::Type Space = EBoneSpaces::WorldSpace) const` | oui ; espace par défaut = monde | OK |
| `Body->GetSingleNodeInstance()` | `Classes/Components/SkeletalMeshComponent.h:1539` `UAnimSingleNodeInstance* GetSingleNodeInstance() const` | oui | OK (retourne un pointeur non const) |
| `Single->GetAnimationAsset()` | `Classes/Animation/AnimSingleNodeInstance.h:78` `virtual UAnimationAsset* GetAnimationAsset() const` | oui | OK |
| `Single->GetCurrentTime()` | `AnimSingleNodeInstance.h:114` `float GetCurrentTime() const` | oui | OK |
| **`Single->GetLength()`** | `AnimSingleNodeInstance.h:67` `ENGINE_API float GetLength();` (**non const** ; définition `Private/Animation/AnimSingleNodeInstance.cpp:425` `float UAnimSingleNodeInstance::GetLength()`) | **non** : `Single` est déclaré `const UAnimSingleNodeInstance*` (cpp l. 532) | **ERREUR** C2662 attendue |
| `Under.GetComponent()->GetReadableName()` | `Classes/Components/ActorComponent.h:1219` `virtual FString GetReadableName() const` (héritée par `UPrimitiveComponent`) | oui | OK |
| `Under.ImpactPoint.Z` | `Classes/Engine/HitResult.h:53` `FVector_NetQuantize ImpactPoint` | n/a | OK (double) |
| `World->LineTraceSingleByChannel(Under, …, ECC_Visibility, Query)` | `Classes/Engine/World.h:2161` `bool … const` | oui | OK ; `Query` est un `FCollisionQueryParams` (cpp l. 374) |
| `TNumericLimits<double>::Max()` | déjà utilisé l. 544 et 575 du même fichier, mêmes inclusions | n/a | OK |
| `ECollisionEnabled::NoCollision` | enum utilisé l. 416 (`ECollisionEnabled::Type`) | n/a | OK |

Visibilité : `World` (cpp l. 341), `Persons` (l. 363, `TArray<ACharacter*>`), `Query` (l. 374) sont déclarés au niveau fonction avant le bloc (l. 493) ; le bloc est dans la même fonction `WritePersonsDump`. `Persons` est parcouru en `const ACharacter*` : `IsHidden`, `GetCapsuleComponent`, `GetMesh` sont const. `UAnimSingleNodeInstance` : `Animation/AnimSingleNodeInstance.h` est inclus (l. 20) ; `UAnimationAsset` arrive par ce même en-tête.

Printf (cpp l. 534 à 538) : 12 spécificateurs (`%s %s %.2f %.2f %.1f %.1f %s %.1f %s %s %.1f %.1f`) pour 12 arguments : nom (`*FString`), `Playing ? *Playing->GetName() : TEXT("-")` (`const TCHAR*` des deux côtés), `GetCurrentTime()`/`0.0` (float/double promu en double, `%f` correct), `GetLength()`/`0.0` (idem), `Body->GetComponentLocation().Z` (double), `Lowest` (double), `*LowestBone.ToString()`, `Pelvis.Z`, `*PelvisBone.ToString()`, `*GetReadableName()` ou `TEXT("-")` (`const TCHAR*`), `ImpactPoint.Z` ou `0.0` (double), `Lowest - ImpactPoint.Z` ou `0.0` (double). Compte et types conformes. Le `*FString` temporaire d'un ternaire vit jusqu'à la fin de l'expression complète : même schéma déjà utilisé l. 397 et 399.

## 6. Logique

- Actif seulement si `SexOn` est vrai : `CoupleSexOn && GetPropertyValue_InContainer(CoupleGI)` (l. 497-498) ; propriété absente = bloc sauté. PASS-STATIC.
- Lecture seule : aucune affectation à un objet du jeu ; seules des variables locales et `Lines.Add`. `LineTraceSingleByChannel` const ; `GetBoneLocation` const. P3 PASS-STATIC.
- Personnes cachées ou capsule autre que `NoCollision` : `continue` (l. 504-507) ; pointeurs nuls testés (`Cap`, `Body`) avant usage ; `GetNumBones() == 0` écarté avant `GetBoneName(0)` (l. 527). PASS-STATIC.
- Trace : le `Query` ignore tous les `Person_C` (l. 370, 375) ; `bTraceComplex` vrai (l. 374).
- Shadowing. Réglage : `Source/LifePlay.Target.cs:11` et `LifePlayEditor.Target.cs:11` `BuildSettingsVersion.V7` ; `CppCompileWarnings.cs:90-93` du moteur : shadow = Error pour V2 et plus (cible), /we4456 /we4458 /we4459. `LifePlay.Build.cs` ne le modifie pas (grep `Shadow|Warning` sans résultat). Variables du bloc : `CoupleGI`, `CoupleSexOn`, `Person`, `Cap`, `Body`, `Lowest`, `LowestBone`, `Bone`, `BoneName`, `BoneZ`, `PelvisBone`, `Pelvis`, `Under`, `bUnder`, `Single`, `Playing`. Variables visibles de la fonction à cet endroit : `Reason`, `bFile` (paramètres), `World`, `Lines`, `Persons`, `Ignored`, `Query`. Les autres noms de la fonction (`GI`, `Room…`, `It`, `Loc`, `Capsule`, `Move`, `Mesh`, `Single` l. 407, `GIState`, `Scene`, `Keys`, `Player`…) vivent dans des portées déjà fermées (boucle l. 378-419, bloc l. 421-491, `if` l. 350-361) : pas de masquage, ni `Person` (boucle précédente close), ni `Single` (l. 407 dans un `if` fermé). Aucun des 16 noms ne masque un autre dans le bloc (`Bone` boucle, `BoneName` corps de boucle, distincts). Déclaration globale masquée (C4459) : les noms précédents de l'espace de noms anonyme (l. 44-48) ne sont pas repris ; non recherché dans le reste du module (réserve R2). Verdict : aucun masquage relevé ; le réglage (Error) rendrait un masquage bloquant, donc le contrôle compte.

## 7. Verdict

**FAIL** (statique). Une erreur de compilation établie par lecture des en-têtes : `Single->GetLength()` (cpp l. 535) appelé sur `const UAnimSingleNodeInstance*`, méthode non const. Message attendu : MSVC C2662 « impossible de convertir le pointeur 'this' de 'const UAnimSingleNodeInstance' en 'UAnimSingleNodeInstance &' ». Le reste du bloc est conforme (P1, P3, MD5, CRLF, printf, visibilité, shadowing).

Correctif pour l'IMPL (non appliqué, je ne corrige pas) : déclarer `Single` sans `const` (`UAnimSingleNodeInstance* Single = Body->GetSingleNodeInstance();`, la méthode retourne déjà un pointeur non const, l. 1539). `GetAnimationAsset`/`GetCurrentTime` restent appelables. Après correction : nouvelle VAL statique du MD5 et de la ligne, puis build COMMUN-6 (P4).

## 8. Écarts et réserves

1. **Écart 1 (bloquant)** : `GetLength()` non const sur pointeur const (ci-dessus). L'IMPL § 4 P2 ne le signalait pas ; le texte « GetLength » y figure sans mention de constness.
2. R2 : C4459 (global masqué) non exploré hors du fichier ; d'autres fichiers du module n'entrent pas dans ce `.cpp`, risque faible (noms de l'espace de noms anonyme seulement).
3. R3 : l'ordre des inclusions n'a pas été compilé ; `UAnimationAsset` est supposé fourni par `AnimSingleNodeInstance.h` (estimé, non établi par compilation).
4. Non mesuré : compilation (P4), comportement en jeu, valeur des Z. `LPTestStringCompat`, `Build.ps1 -FromLog` et G-U3 : sans objet (aucun build).

Aucun chemin `C:\Users` ni nom de compte dans ce livrable.

## 9. Points à confirmer par l'utilisateur

- [ ] Faire corriger l'IMPL (suppression du `const` sur `Single`) puis refaire une VAL statique.
- [ ] Build COMMUN-6 seulement après cette correction.

## 10. Fichiers à commiter

A : `Docs/Migration/etat/ST/STG/STG-M1d-VAL.md` (ce livrable). Aucun autre fichier modifié par moi (`LPDebugSubsystem.cpp` : à commiter par le gardien seulement après correction, build et nouvelle VAL).

Tours : 8 / 25