LifePlay-Revival/Docs/Migration/etat/CAM/CAM-Tocc-VAL.md

Fiche CAM-Tocc-VAL — Niveau N1 — Modèle prévu sonnet | utilisé claude-sonnet-5-5 — Agent lp-validator — Skills sk-protocol, sk-recount, debug-verification, lp-validate
# CAM-Tocc-VAL : témoin d'occlusion C2, validation statique (2026-10-14)

Copie `D:\Game\LifePlay-master 5.8`, branche `ue5.8` (HEAD 0745917). Sans UE et sans compilation : lecture, diff et
en-têtes du moteur seulement. Aucun fichier modifié hors ce livrable. Verdict maximal possible : `PASS-STATIC`.

## 1. Fiches amont relues
- `Docs\Migration\etat\CAM\CAM-COMMUN5-DIAG.md` § 2 (a) (spécification du témoin, l. 70-73) et § 4 (l. 108 : T-occ,
  « journal seulement » ; l. 112-114 : MD5 avant écriture).
- Aucun livrable IMPL `CAM-Tocc-*` : `Glob Docs/Migration/etat/CAM/*Tocc*` ne rend aucun fichier, et `Grep Tocc|T-occ`
  sous `Docs` ne trouve que `CAM-COMMUN5-DIAG.md:108` et `BOSS-ETAT.md:54`. Les sources livrées servent d'amont (écart 1).
- Code lu en entier : `Source\LifePlay\LPCameraModeSubsystem.cpp` (503 lignes) et `.h` (66 lignes).

## 2. Points à confirmer des IMPL amont
sans objet : aucune IMPL CAM-Tocc n'existe sous `etat\CAM` (voir section 1), donc aucun point à confirmer à reprendre.
Les points à confirmer ouverts par cette VAL sont en section 6.

## 3. Critères rejoués

| # | Contrôle | Commande ou lecture | Résultat | Verdict |
|---|---|---|---|---|
| C1 | MD5 après (.cpp, .h) | `Tools\FileCheck.ps1 -Path` (copie 5.8) | `.cpp` FE9236BD138A46BBC2B63027977B3CD9 ; `.h` 7DA111CB65B267A9E2F7482CBA368BE9 : égaux aux valeurs attendues | PASS |
| C2 | MD5 avant (sauvegarde CAM-Tocc) | même commande sur `D:\Game\LifePlay_Backup_5.5\CAM-Tocc\Source\LifePlay\` | `.cpp` D8981529E3773FBF50BB7FC1C91BC91F ; `.h` 2E1E245883960C2AFFC667A9A48FD96D : égaux à ceux du DIAG (`CAM-COMMUN5-DIAG.md:114`) | PASS |
| C3 | Fins de ligne, BOM | sortie FileCheck : `LF`, CRLF 0, CR 0, BOM `-`, alertes=0 pour les 4 fichiers (503 / 66 / 456 / 62 LF) | LF sans BOM, inchangé par rapport à l'avant | PASS |
| C4 | Pas de chemin de profil Windows | Grep des motifs de dossier de profil (dossier utilisateur, données d'application) et du nom de compte sur `LPCameraModeSubsystem.*` : 0 résultat | aucun | PASS |
| C5 | Diff = ajouts seulement | `git diff --no-index --numstat` : `.cpp` 47 ajouts, 0 retrait (`--stat` : « 47 insertions(+) ») ; `.h` 4 ajouts, 0 retrait | aucune ligne existante modifiée ni retirée | PASS |
| C6 | Conformité à la spécification § 2 (a) | lecture `.cpp:267-306` | voir détail ci-dessous | PASS-STATIC |
| C7 | Déclaration et appel | `.h:55-58` ; `.cpp:217-221` ; Grep `WitnessOcclusion` sur `Source` | méthode privée déclarée dans le `.h` (l. 56) ; un seul appel (`.cpp:220`), dans le bloc `if (Label == LabelC2)`, juste après `WitnessC2(DeltaTime);` (l. 219) | PASS-STATIC |
| C8 | `WitnessC2` et ligne `Touche C` inchangés | diff : aucune ligne retirée, aucun ajout dans `WitnessC2` (l. 308-384) ni `LogSwitchKey` (l. 252-265) ; l'insertion est avant `WitnessC2` | inchangés, ligne « aucun » (`Indicateur de camera : aucun`, l. 198) intacte | PASS |
| C9 | Compilation probable | en-têtes du moteur, voir détail ci-dessous | aucune erreur prévisible | PASS-STATIC |
| C10 | Coût | analyse, voir ci-dessous | acceptable | PASS-STATIC |
| C11 | Comportement et Blueprint | diff | aucun changement de comportement du jeu : lecture par réflexion et un tracé, une ligne de journal ; aucun Blueprint, aucun asset | PASS-STATIC |

### Détail C6 (spécification, point par point)
- C2 seulement : appel dans la branche `Label == LabelC2` (`.cpp:217`), libellé `Camera: C2 Follow` (`.cpp:59`). Établi.
- Toutes les 0,5 s : `OcclusionInterval = 0.5f` (`.cpp:66`), armé à la ligne 274 avant toute sortie anticipée,
  décrémenté par le `DeltaTime` du ticker (`.cpp:269`). Estimé : le ticker tourne à 0,1 s (`TickInterval`), la
  cadence réelle est un multiple de 0,1 s, donc 0,5 s à l'image près.
- Tracé Visibility complexe, Room compris : `FCollisionQueryParams Query(SCENE_QUERY_STAT(LPCameraOcclusion), true)`
  (`.cpp:288`), `ECC_Visibility` (`.cpp:296`). Room n'est pas ajouté aux acteurs ignorés (contraste : `WitnessC2`
  l. 342 ignore Room). Établi.
- Départ caméra, arrivée tête : `CamLoc = Cam->GetActorLocation()` avec `Cam` = `Room.CamRoom` ; `Head = Mesh->GetSocketLocation("head")`
  (`.cpp:285-286`, `HeadSocket` l. 60). Tracé de `CamLoc` vers `Head` (l. 296). Établi.
- Acteurs ignorés : `Player` (l. 289), `Cam` (l. 290), `GI.Wall` (l. 291-294, nom `Wall` l. 56). Établi.
- Au plus une ligne par seconde : sur contact, `OcclusionCooldown = OcclusionLogInterval = 1.f` (l. 302) ; sans contact,
  le délai reste à 0,5 s. Donc le tracé suivant un contact a lieu 1 s plus tard (et non 0,5 s) : voir constat 3.
- Format : « Temoin C2 : joueur masque par %s (%s) de %s, visible=%d, a %.0f cm de la camera (camera a %.0f cm de la tete) »
  (l. 303) = texte de la demande. Composant, maille (`-` si ce n'est pas un `UStaticMeshComponent`), acteur,
  visible 0 ou 1, `Hit.Distance`, `FVector::Dist(CamLoc, Head)`. Établi.
- Journal seulement : aucun effet de bord hors `OcclusionCooldown` et le `UE_LOG`. Établi.

### Détail C9 (compilation probable, lue dans les en-têtes de `D:\Game\Launcher\Engine\UE_5.8\Engine\Source\Runtime\…`)
- Includes : `Components/StaticMeshComponent.h` et `Engine/StaticMesh.h` ajoutés (`.cpp:10-11`). `GetStaticMesh() const`
  existe : `Engine\Classes\Components\StaticMeshComponent.h:453`, retourne `TObjectPtr<UStaticMesh>`. `Cast<UStaticMeshComponent>`
  sur un `const UPrimitiveComponent*` : type complet par ce même en-tête.
- `GetNameSafe` : surcharge `const TObjectPtr<T>&` (`CoreUObject\Public\UObject\UObjectBaseUtility.h:912`) et
  `const UObjectBaseUtility*` (l. 893). Un `TObjectPtr<UStaticMesh>` temporaire convient à la surcharge gabarit (correspondance exacte).
  Le même appel existe déjà, compilé : `LPShowCoupleSubsystem.cpp:788` (`GetNameSafe(Shell->GetStaticMesh())`).
- `FCollisionQueryParams(SCENE_QUERY_STAT(...), true)` : `SCENE_QUERY_STAT(Q)` se développe en **deux** arguments,
  `SCENE_QUERY_STAT_NAME_ONLY(Q), SCENE_QUERY_STAT_ONLY(Q)` (`Engine\Public\CollisionQueryParams.h:39`). L'appel devient
  `(FName, TStatId, true)`, qui choisit le constructeur `FCollisionQueryParams(FName, const TStatId&, bool bInTraceComplex = false, const AActor* = NULL)`
  (l. 238) : `true` est bien `bTraceComplex`. Même forme avec `false` déjà compilée dans `WitnessC2` (`.cpp:341`).
- `LineTraceSingleByChannel(FHitResult&, const FVector&, const FVector&, ECollisionChannel, const FCollisionQueryParams&, …) const`
  (`Engine\Classes\Engine\World.h:2161`, dans `class UWorld`, l. 931). Appelée sur `UWorld* World` non const : valide
  (`World = GI->GetWorld()`, l. 276, même forme que `WitnessC2` l. 316).
- `UPrimitiveComponent::IsVisible() const` : hérité de `USceneComponent::IsVisible() const` virtuel, section publique
  (`Engine\Classes\Components\SceneComponent.h:853`, section publique des lignes 400 à 872) ; `PrimitiveComponent.h` ne le redéfinit pas (Grep : 0). Appelé via `const UPrimitiveComponent*` : valide.
- `FHitResult::GetComponent() const` rend `UPrimitiveComponent*` (`Engine\Classes\Engine\HitResult.h:227`) ; `GetActor() const` rend `AActor*` (l. 211).
  L'affectation à `const UPrimitiveComponent*` est valide.
- `UE_LOG` : 6 spécificateurs (`%s`, `%s`, `%s`, `%d`, `%.0f`, `%.0f`), 6 arguments :
  1 `*GetNameSafe(Comp)` (`const TCHAR*`) ; 2 ternaire `MeshComp ? *GetNameSafe(...) : TEXT("-")` (`const TCHAR*` des deux côtés,
  même motif que `.cpp:264`) ; 3 `*GetNameSafe(Hit.GetActor())` ; 4 `Comp && Comp->IsVisible() ? 1 : 0` (int, précédence : `(Comp && …) ? 1 : 0`) ;
  5 `Hit.Distance` (float, promu en double) ; 6 `FVector::Dist(...)` (double, UE5). Les temporaires `FString` vivent jusqu'à la fin de l'expression complète.
- `.h` : la méthode est déclarée dans la section `private`, hors UHT (pas de `UFUNCTION`), après `WitnessCooldown`. `OcclusionCooldown` initialisé à `0.f`. Aucun nouvel include nécessaire dans le `.h`.
- Espace de noms : constantes ajoutées dans `LPCameraModeLocal` (nommé, `.cpp:29`) : pas de risque C2374 (`OcclusionInterval`, `OcclusionLogInterval` définies une seule fois, Grep sur `Source`).
- Limite : lecture seule, pas de compilation. Verdict `PASS-STATIC`, pas `PASS` (rien n'a été compilé ici).

### Détail C10 (coût)
- Un tracé de ligne **complexe** unique, `LineTraceSingleByChannel`, toutes les 0,5 s (1 s après un contact), en C2 seulement.
  Un seul rayon sur le thread de jeu, limité à la caméra et à la tête (quelques mètres). Ce coût est du même ordre que celui du `WitnessC2`
  existant (trois balayages sphériques, mais seulement sous 1 m) et reste à la cadence d'un ticker à 0,1 s sans travail à chaque image.
- Lectures par réflexion : 4 `ReadObject` (GI.Room, GI.PlayerCharacter, Room.CamRoom, GI.Wall) = recherche de propriété par nom, toutes les 0,5 s : négligeable.
- Hors C2 (autres modes, menu ouvert) : aucun appel. Acceptable pour un témoin de diagnostic. Estimé (aucune mesure de temps d'image faite).
  Rappel du DIAG (`CAM-COMMUN5-DIAG.md:80`) : le coût du tracé complexe est un risque pour l'évitement B2l (sondes fréquentes), pas pour ce témoin à 2 Hz.

## 4. Diff lu en entier
- `.cpp` : `git diff --no-index` avant/après lu en entier : 4 blocs, 47 ajouts, 0 retrait (2 includes, 2 constantes + 1 commentaire,
  1 appel, 1 fonction de 40 lignes).
- `.h` : 1 bloc, 4 ajouts, 0 retrait (méthode + membre et leurs deux commentaires).
- Total : 2 fichiers, 51 lignes ajoutées. Recompte par une seconde méthode : `--numstat` (`.h` : `4 0`) et `--stat` (`.cpp` : 47 insertions) ;
  longueurs des fichiers 456 → 503 (+47) et 62 → 66 (+4) par FileCheck.
- Les deux fichiers sont **non suivis** par git dans la copie 5.8 (`git status --short` : `??` ; `git ls-files` : 0) : le diff contre HEAD est impossible,
  la sauvegarde `LifePlay_Backup_5.5\CAM-Tocc` (MD5 identiques à ceux du DIAG) sert d'état avant.
- Fichiers modifiés d'autres sous-systèmes visibles au `git status` (`LPDebugSubsystem.*`, `LPDirectControlSubsystem.*`, `LPOutdoorRoomSubsystem.*`, `LifePlay.cpp`) :
  hors périmètre de cette fiche, non lus, non attribués à CAM-Tocc.

## 5. Verdict
**PASS-STATIC** pour le témoin d'occlusion C2 (CAM-Tocc). Tous les contrôles (C1 à C11) sont conformes ; aucune erreur de compilation prévisible
d'après les en-têtes du moteur 5.8 ; aucune compilation ni essai en jeu n'a été exécuté. Le verdict `PASS` plein exige le BUILD et un essai en C2.

## 6. Points à confirmer par l'utilisateur
- [ ] BUILD de `LifePlay` (éditeur 5.8, `Tools\Build.ps1`) : 0 erreur, module `LifePlay` dans les unités compilées. Non rejoué ici.
- [ ] Essai en jeu en C2 (pub assis, le cas C5-2) : vérifier la ligne `Temoin C2 : joueur masque par …` quand le joueur disparaît, et son absence quand il est visible.
- [ ] Accepter que, après un contact, le tracé suivant ait lieu 1 s plus tard (constat 3).

Tours : 11 / 40

## Constats
Écarts
1. Aucun livrable IMPL `CAM-Tocc-*` ni fiche dans `etat\CAM` (Glob vide) : la traçabilité du « qui a écrit, instantané, fichiers à commiter » manque ; la VAL
   s'est appuyée sur le code et la sauvegarde `CAM-Tocc`. À fournir avant le ticket du gardien.
2. `Source\LifePlay\LPCameraModeSubsystem.cpp` et `.h` sont non suivis dans la copie 5.8 (`??`) : le ticket devra les ajouter (`A`), ce que la fiche n'annonce pas.

Observations (sans verdict négatif)
3. Cadence : sur contact, `OcclusionCooldown` passe à 1 s, donc un tracé tous les 1 s tant que le joueur est masqué (au plus une ligne par seconde, conforme) ;
   le tracé suivant sans contact revient à 0,5 s. Cohérent avec « au plus une ligne par seconde ».
4. `visible=` reflète `UPrimitiveComponent::IsVisible()` (drapeau du composant), pas `AActor::IsHidden()` : un acteur masqué par `SetActorHiddenInGame`
   peut donner `visible=1`. La spécification demande seulement `visible=<0|1>` ; le témoin `WitnessC2` garde son champ `cache=` pour l'acteur.
5. Seuls `Player`, `Cam` et `GI.Wall` sont ignorés (conforme) : un acteur attaché au joueur (vêtement, accessoire) ou un autre personnage dans l'axe
   serait signalé comme masquant. Utile comme preuve, à lire avec le nom de l'acteur de la ligne.
6. Le membre et la méthode ajoutés sont placés entre deux membres de données du `.h` (style seulement, sans effet).