LifePlay-Revival/Docs/Migration/etat/U58/U1/U1-T4a-IMPL.md

Fiche U1-T4a — Niveau N3 — Modèle prévu opus-xhigh | utilisé Opus 5.5 (claude-opus-5-5) — Agent lp-impl — Skills sk-protocol, ue-cpp-build, lp-build, lp-ue-compat (préchargés) ; lp-commandlets, lp-paths (invoqués : outil Skill disponible ; ue-cpp-build déjà préchargé, non réinvoqué)

U1-T4a — commandlet LPAuditBlueprintCalls (addon privé, lecture seule) — IMPL, non compilé

Statut : écrit, non compilé, non exécuté (interdit par la fiche : éditeur ouvert). Toute affirmation « compile » reste à établir par la fiche N0 suivante. Légende : établi = lu dans les sources (fichier:ligne) ; estimé = déduit ; incertain = à vérifier à la compilation ou à l'exécution.

1. Fichiers touchés (dépôt addon D:\Game\LifePlay-Sandbox, aucun commit)

Fichier	Action
Plugins/LPSandbox/Source/LPModTools/LPAuditBlueprintCallsCommandlet.h	créé (51 lignes)
Plugins/LPSandbox/Source/LPModTools/LPAuditBlueprintCallsCommandlet.cpp	créé (~980 lignes, ASCII, fins de ligne LF comme les voisins)
Plugins/LPSandbox/Source/LPModTools/LPModTools.Build.cs	2 dépendances privées ajoutées (diff § 2)
D:\Game\LifePlay-master 5.5\Docs\Migration\etat\U58\U1\U1-T4a-IMPL.md	ce livrable (etat/ ignoré par git : .gitignore:74)

git -C D:\Game\LifePlay-Sandbox status --porcelain après travail : M LPModTools.Build.cs, ?? …Commandlet.cpp, ?? …Commandlet.h, ?? Tools/claude/ (déjà présent avant la fiche). Jeu : M Docs/Migration/27_Plan_Migration_UE58.md non modifié par moi (seulement lu) — présent au moment du contrôle, à attribuer à l'orchestrateur. Rien d'inclus de LifePlay ni LifePlayEditorTools ; aucun correctif de compatibilité UE4 touché.

2. Diff du Build.cs

@@ -38,7 +38,12 @@ public class LPModTools : ModuleRules
 			"SkeletalMeshUtilitiesCommon",
 			"SkeletalMeshDescription",
-			"AnimationCore"
+			"AnimationCore",
+			// LPAuditBlueprintCalls (lot U1, fiche U1-T4a) : noeuds K2 des graphes Blueprint et FBlueprintMetadata
+			"BlueprintGraph",
+			// LPAuditBlueprintCalls : K2Node_CallFunction.h et K2Node_Event.h incluent KismetCompilerMisc.h
+			// (module KismetCompiler, dependance privee de BlueprintGraph, donc non transmise)
+			"KismetCompiler"
 		});

Justification (établi) : K2Node_CallFunction.h:15 et K2Node_Event.h:16 incluent KismetCompilerMisc.h (Editor/KismetCompiler/Public) ; BlueprintGraph.Build.cs ne cite KismetCompiler qu'en privé. Même paire que LifePlayEditorTools.Build.cs du jeu. UMGEditor, Kismet, AnimGraph non ajoutés : non nécessaires (WidgetBlueprint / AnimBlueprint traités par la base UBlueprint et GetAllGraphs ; aucun FBlueprintEditorUtils, FKismetEditorUtilities ni type d'AnimGraph utilisé).

3. Comportement

• Usage : UnrealEditor-Cmd.exe <projet> -run=LPAuditBlueprintCalls [-Root=/Game[,/Autre]] [-Out=<dossier>] [-Limit=N]. Défaut des racines : /Game, /ModdingExtra, /LPAnimCore s'ils sont montés (LPAnimCore a CanContainContent: false → ignoré et signalé ; ModdingExtra monté, Content/ vide → 0 asset attendu). Racine donnée mais non montée → erreur, code 1. Sortie par défaut <projet>/Saved/Audit/BlueprintCalls/ (ignoré par git).
• Registre : SearchAllAssets(true) puis ScanPathsSynchronous(racines) (piège lp-commandlets), GetAssetsByPaths récursif, disque seulement ; filtre FAssetData::GetClass()->IsChildOf(UBlueprint) avant tout chargement ; tri par chemin ; -Limit après tri.
• Chargement un par un (LoadObject<UBlueprint>) ; null = échec listé. Toutes les 50 : FinishAllCompilation() puis CollectGarbage(RF_NoFlags) (pratique du moteur, § 4).
• Graphes : UBlueprint::GetAllGraphs (Function, Macro, Ubergraph, DelegateSignature, graphes d'interfaces, extensions, chacun avec GetAllChildrenGraphs) + UEdGraphNode::GetSubGraphs des nœuds (même paquet), dédoublonnés.
• Relevé par nœud : classe du nœud (toujours) ; UK2Node_CallFunction et dérivés → fonction (déclaration d'origine par remontée GetSuperFunction) ; UK2Node_Variable hors UK2Node_StructOperation → propriété (get/set) ; UK2Node_BaseMCDelegate (Add/Remove/Clear/Call/Assign) → propriété délégué ; ComponentBoundEvent / ActorBoundEvent → propriété délégué ; UK2Node_Event hors CustomEvent → fonction (evenement) ; UK2Node_FunctionEntry → fonction (surcharge) si sa déclaration d'origine est native.
• Lecture seule : aucun MarkPackageDirty, Modify, SavePackage, CompileBlueprint dans le code (vérifiable par grep). La résolution FMemberReference peut corriger un redirecteur en mémoire (MemberReference.cpp:384-391), sans marquer le paquet (aucun MarkPackageDirty dans MemberReference.cpp, grep vide).
• Sorties : calls.json (membres[] : type fonction|propriete|noeud, classe, classe_cpp, module, entete, nom, usages, assets, premiers_assets ≤ 20, contextes, deprecie, depreciation[], message, non_resolus, + references_depreciees pour les nœuds), tri type/module/classe/nom ; node_classes.json ; per_asset.csv (asset,classe,etat,graphes,noeuds,appels_natifs,references_natives,references_bp,non_resolus) ; summary.txt (totaux, classes d'assets, membres dépréciés utilisés, usages par module, échecs, 500 premières références non résolues, code de retour).
• Code : 0 si tout est chargé et écrit ; 1 si un échec de chargement, aucune racine, aucun Blueprint ou une écriture impossible. UseCommandletResultAsExitCode = true pour que le code du processus soit celui de Main (§ 4).

4. Choix d'API (sources 5.5.4 D:\Game\Launcher\Engine\UE_5.5\Engine\Source, recoupées en 5.8.3)

API	5.5 (établi)	5.8 (établi)
UBlueprint::GetAllGraphs	Runtime/Engine/Classes/Engine/Blueprint.h:1123, impl. Private/Blueprint.cpp:1855-1925	Blueprint.h:1107
sous-graphes AnimGraph enregistrés dans SubGraphs	Editor/AnimGraph/Private/AnimGraphNode_StateMachineBase.cpp:159, AnimStateNode.cpp:137, AnimStateTransitionNode.cpp:149	—
UEdGraph::GetAllChildrenGraphs	Runtime/Engine/Classes/EdGraph/EdGraph.h:205, Private/EdGraph/EdGraph.cpp:321	—
UEdGraphNode::GetSubGraphs / IsDeprecated / HasDeprecatedReference	EdGraphNode.h:687 / 853 / 856 ; IsDeprecated = CLASS_Deprecated (EdGraphNode.cpp:616-619), surchargé par K2Node_SpawnActor.h:39	EdGraphNode.h:697 / 870 / 873
UK2Node_CallFunction::FunctionReference / GetTargetFunction	Editor/BlueprintGraph/Classes/K2Node_CallFunction.h:75 / 155 (impl. .cpp:1375)	:71 / :150 (UE_API)
UK2Node_Variable::VariableReference / GetPropertyForVariable	K2Node_Variable.h:56 / 166	:58 / :168
UK2Node_StructOperation : UK2Node_Variable (Make/Break exclus)	K2Node_StructOperation.h:29	même ligne
UK2Node_BaseMCDelegate::DelegateReference / GetProperty	K2Node_BaseMCDelegate.h:22 / 51 (public : macro GENERATED_BODY_LEGACY finit par public:, Intermediate/…/K2Node_BaseMCDelegate.generated.h:41-46)	:22 / :51 (inline)
UK2Node_ComponentBoundEvent DelegatePropertyName / DelegateOwnerClass / GetTargetDelegateProperty	K2Node_ComponentBoundEvent.h:36 / 40 / 73	mêmes lignes
UK2Node_ActorBoundEvent idem	K2Node_ActorBoundEvent.h:35 / 39 / 77	mêmes lignes
UK2Node_Event::EventReference / FindEventSignatureFunction	K2Node_Event.h:53 / 121 (impl. .cpp:340)	mêmes lignes
UK2Node_FunctionTerminator::FunctionReference / FindSignatureFunction	K2Node_FunctionTerminator.h:32 / 59 (impl. .cpp:195)	mêmes lignes
FMemberReference GetMemberName / GetMemberParentClass / GetMemberParentPackage / IsSelfContext / IsLocalScope	Runtime/Engine/Classes/Engine/MemberReference.h:203 / 221 / 226 / 240 / 246	mêmes lignes
surcharge Blueprint → super-fonction = fonction surchargée	Editor/KismetCompiler/Private/KismetCompiler.cpp:2291 ; UFunction::GetSuperFunction Class.h:2030	Class.h:2680
FBlueprintMetadata::MD_DeprecatedFunction / MD_DeprecatedProperty / MD_DeprecationMessage	EdGraphSchema_K2.h:139 / 142 / 145	:143 / 146 / 149
CPF_Deprecated, CLASS_Deprecated	CoreUObject/Public/UObject/ObjectMacros.h:431, :250	:463, :269
UField::FindMetaData (WITH_METADATA = WITH_EDITORONLY_DATA, Core/Public/Misc/CoreMiscDefines.h:32)	Class.h:234-235	Class.h:272-273
FField::FindMetaData / GetOwnerStruct / GetOwnerUObject	Field.h:777-778 / 657 / 636	Field.h:937-938 / 811 / 790
UField::GetOwnerClass, UStruct::GetPrefixCPP, UObjectBaseUtility::GetPackage	Class.h:180, Class.h:590 (+3234), UObjectBaseUtility.h:477	Class.h:218, 781 (+4330), UObjectBaseUtility.h:504
IAssetRegistry::GetAssetsByPaths / ScanPathsSynchronous / SearchAllAssets	AssetRegistry/Public/AssetRegistry/IAssetRegistry.h:238 / 655 / 666	:324 / 793 / 809
FAssetData::PackageName / AssetClassPath / GetObjectPathString / GetClass	CoreUObject/Public/AssetRegistry/AssetData.h:180 / 189 / 342 / 456	:190 / 203 / 352 / 466
FPackageName::MountPointExists (racines enregistrées avec / final, ex. /Game/ PackageName.cpp:454)	Misc/PackageName.h:348, impl. PackageName.cpp:421-425	PackageName.h:356-358 (3 surcharges, const FString& exacte)
CollectGarbage(RF_NoFlags) précédé de FAssetCompilingManager::FinishAllCompilation	UObjectGlobals.h:881 ; pratique : Editor/UnrealEd/Private/Commandlets/BaseIteratePackagesCommandlet.cpp:917-928 ; AssetCompilingManager.h:46 / 71	UObjectGlobals.h:952 ; AssetCompilingManager.h:44 / 69
SearchAllAssets(true) avant requête en commandlet	CompileAllBlueprintsCommandlet.cpp:181	—
UseCommandletResultAsExitCode (défaut false : le moteur force 1 si une erreur a été journalisée)	Engine/Classes/Commandlets/Commandlet.h:96, Private/Commandlets/Commandlet.cpp:27, Launch/Private/LaunchEngineLoop.cpp:4256-4262	Commandlet.h:96, LaunchEngineLoop.cpp:4217-4218
LoadObject	UObjectGlobals.h:1990 (const TCHAR*)	UObjectGlobals.h:2175 (FStringView, const TCHAR* converti)
FJsonObject::Set*Field	Json/Public/Dom/JsonObject.h:181-182 (clés FString)	JsonObject.h:142, 153-160, 199, 210-211, 226-227 (clés FStringView : TEXT() et FString acceptés) ; aucune itération des clés (piège R2 évité)
divers : FName::LexicalLess, TArray::FilterByPredicate, FEngineVersion::Current, FParse::Value	NameTypes.h:737, Array.h:1208, EngineVersion.h:40, Parse.h:59 / 70	NameTypes.h:826, Array.h:1737 ([[nodiscard]], résultat utilisé), EngineVersion.h:40, Parse.h:60 / 71

Garde de version : aucune. Toutes les API utilisées existent avec la même forme d'appel en 5.5 et 5.8 (tableau) ; pas de ENGINE_MINOR_VERSION ni UE_VERSION_OLDER_THAN nécessaire (estimé, à confirmer par un build 5.8 en U4).

5. Écarts à la SPEC (fiche § 4–5)

1. Espace de noms nommé LPAuditBlueprintCallsImpl au lieu d'anonyme : c'est le style réel des voisins (LPAnimCatalogImpl, LPAnimIdentifyImpl) et la règle lp-build (collision C2374) ; using namespace dans Main seulement.
2. Champs en plus : calls.json (classe_cpp, contextes, depreciation[], message, non_resolus, references_depreciees), per_asset.csv (classe, etat, references_natives, references_bp, non_resolus), summary.txt (membres dépréciés utilisés, usages par module, 500 premières références non résolues, classes d'assets non chargées). Les champs demandés sont tous présents.
3. Code 1 aussi si aucune racine montée, aucun Blueprint trouvé, ou écriture impossible (zéro résultat = échec, sk-protocol) ; UseCommandletResultAsExitCode = true (sans quoi une erreur de compilation au chargement d'un Blueprint du jeu forcerait 1 même si tout est chargé).
4. -Root accepte , ou + comme séparateur (PowerShell coupe à la virgule sans guillemets).
5. Événements et fonctions surchargées dont la déclaration d'origine n'est pas native : non comptés comme « références BP » (ce sont des définitions du jeu) ; CustomEvent ignoré. Les références BP comptées sont celles des appels, variables et délégués.
6. Non couvert (limites, à décider) : Blueprints de niveau (ULevelScriptBlueprint dans les .umap : pas un asset de premier niveau, il faudrait charger les cartes) ; types portés par les broches, cible de DynamicCast, structure des Make/Break, fabriques des nœuds asynchrones (UK2Node_BaseAsyncTask), CreateDelegate, nœuds Property Access, liaisons de propriétés UMG et d'AnimGraph : classe du nœud seulement. Contenu des macros moteur (StandardMacros, hors racines) non parcouru.
7. Compilation au chargement laissée au moteur (chargement par défaut, comme l'éditeur) : LOAD_DisableCompileOnLoad écarté car non récursif (ObjectMacros.h:80 : « dependencies will still compile on load »), état mixte.
8. FinishAllCompilation() appelé sans condition avant chaque GC (le moteur le conditionne à FApp::CanEverRender(), BaseIteratePackagesCommandlet.cpp:917) : estimé sans effet de bord, plus sûr pour le GC.

6. Points incertains à vérifier (compilation N0, exécution)

• Compilation (incertain) : SetObjectField(…, TSharedRef) et MakeShared<FJsonValueObject>(TSharedRef) comme les voisins (compilent en 5.5 aujourd'hui) ; initialisation TArray<FString>{ TEXT(...) } ; conversion implicite TObjectPtr → const UEdGraphNode* dans les boucles (ObjectPtr.h:661 5.5) ; avertissements de masquage (C4456-4458) relus à la main, non prouvés. Attendu : LPAuditBlueprintCallsCommandlet.cpp + .gen.cpp compilés, lien de UnrealEditor-LPModTools.dll, aucun avertissement nouveau.
• Racines : forme de MountPointExists (testée avec et sans / final) ; la ligne de journal racines : /Game, /ModdingExtra ; non montees (ignorees) : /LPAnimCore doit apparaître. /Game non monté = défaut.
• Classes d'assets : GetClass() sans résolution ; les classes non chargées (souvent des classes Blueprint d'instances) sont comptées à part dans summary.txt — vérifier qu'aucune n'est une famille de Blueprint (plugin non chargé).
• Durée et mémoire : 9 068 .uasset sous Content (find Content -name "*.uasset" | wc -l) ; nombre de Blueprints inconnu ; chaque Blueprint charge ses dépendances dures. Commencer par -Limit=20.
• Sémantique : appels_natifs = nœuds d'appel vers une fonction native ; une référence non résolue dont le parent est natif apparaît dans calls.json avec non_resolus > 0 (clé = classe du parent, pas la classe déclarante).
• Lecture seule : le moteur peut écrire hors dépôts (DDC D:/DDC, Saved/, Intermediate/ ignorés) ; à contrôler par git status avant / après (3 dépôts).

7. Commandes pour la fiche suivante (N0, éditeur fermé, une seule compilation)

Avant : éditeur Unreal fermé ; Makefile.bin à déplacer seulement si un test sans addon a eu lieu depuis le dernier build (lp-build) ; noter les dates de Binaries\Win64\UnrealEditor-LPModTools.dll (jeu) et de D:\Game\LifePlay-Sandbox\Plugins\LPSandbox\Binaries\Win64 ; relever les 3 git status.

cd 'D:\Game\LifePlay-master 5.5'
git status --porcelain > "$env:TEMP\U1T4a_jeu_avant.txt"
git -C 'Content\Modules' status --porcelain > "$env:TEMP\U1T4a_modules_avant.txt"
git -C 'D:\Game\LifePlay-Sandbox' status --porcelain > "$env:TEMP\U1T4a_addon_avant.txt"

$UE='D:\Game\Launcher\Engine\UE_5.5\Engine'; $Proj='D:\Game\LifePlay-master 5.5\LifePlay.uproject'
& "$UE\Build\BatchFiles\Build.bat" LifePlayEditor Win64 Development -Project="$Proj" -WaitMutex *> 'Saved\Logs\portage\U1-T4a_build.log'; "code=$LASTEXITCODE"
# preuves : code 0, ligne « Using Visual Studio … 14.38 », Compile LPAuditBlueprintCallsCommandlet.cpp, lien UnrealEditor-LPModTools.dll, 0 avertissement nouveau

.\Tools\RunCommandlet.ps1 -Lot U1 -Commandlet LPAuditBlueprintCalls -Args '-Limit=20 -Out=Saved/Audit/BlueprintCalls_essai'
.\Tools\RunCommandlet.ps1 -Lot U1 -Commandlet LPAuditBlueprintCalls
# preuve de chargement du nouveau code : lignes LogLPAuditBlueprintCalls « racines : … » et « AUDIT blueprints … -> <dossier> »
# sorties : Saved\Audit\BlueprintCalls\{calls.json,node_classes.json,per_asset.csv,summary.txt}

git status --porcelain | Compare-Object (Get-Content "$env:TEMP\U1T4a_jeu_avant.txt")
git -C 'Content\Modules' status --porcelain | Compare-Object (Get-Content "$env:TEMP\U1T4a_modules_avant.txt")
git -C 'D:\Game\LifePlay-Sandbox' status --porcelain | Compare-Object (Get-Content "$env:TEMP\U1T4a_addon_avant.txt")

Contrôles de cohérence suggérés (sk-recount) : lignes de per_asset.csv − 1 = « traites » de summary.txt ; somme noeuds du CSV = « noeuds » du résumé = somme noeuds de node_classes.json ; etat=echec = échecs listés.

8. Handoff

Suite : lp-builder (N0) doit compiler LifePlayEditor 5.5 éditeur fermé puis lancer -Limit=20 puis tout /Game (commandes § 7), état : code écrit dans l'addon (3 fichiers, non commités), jamais compilé ni exécuté.