LifePlay-Revival/Docs/Migration/etat/OPT/OPT0/OPT0-PIPELINE.md

OPT0-PIPELINE : organisation du pipeline de mesure et de test (axe B, par paliers)

2026-10-15, session Sonnet · OPT0-R, fiche K0. Décision de l'utilisateur pour l'axe B : par paliers, d'abord le banc console + CSV, puis un essai Gauntlet. Source des faits : OPT\BC\ (ids cités). Ce document organise ; il ne livre aucun outil installé ni essai.

Révision du 2026-10-15 (lot PIPE1, fiche PIPE1-IMPL-02) : paliers réalignés sur le barème M0 à M4 adopté par l'utilisateur (« approuve le modèle de xHigh »). Le choix du palier se fait par la grille question × enjeu du skill lp-perf (bareme.md) ; preuves dans etat\AG\PIPE1\PIPE1-REVUE-02-MODELE.md. L'ancien P1 (PresentMon en direct) devient M2 hors ligne ; P2a devient M1 ; P2b (Gauntlet) passe hors grille ; P3 (Tracy) est retiré.

Vue d'ensemble

Palier	Outil	Mesure	Build	Statut en 5.8	BUILD-GO
M0	Tools\LogStats.ps1 -Compare -Stats	compteurs du jeu : F5, DESTROY, à-coups (-LPHitchLog)	Development	en service	non, si la build existe
M1	CSV Profiler par le lanceur Session C, SummarizeDebugCsv.ps1, PerfReportTool (R4-01 à R4-04, R11-08 à R11-10)	cadence instrumentée, coût par fil, mémoire LLM	Development	éprouvé en 5.5, à éprouver en 5.8	oui si la build Development est à refaire
M2	trace ETW hors ligne puis PresentMon --etl_file (R11-01 à R11-06)	cadence ressentie de la Shipping	Shipping	jamais essayé (B2-ter)	non (la build existe)
M3	journal de performance d'AMD Adrenalin	cadence (grain à relever)	toutes	format inconnu	non
M4	Unreal Insights : lanceur Session A, export sans interface (R11-11, R4-05 et suivantes)	quelle fonction, quel Blueprint	DebugGame ou Development	éprouvé en 5.5, à éprouver en 5.8	oui si la build est à refaire
hors grille	Gauntlet (R3-12, R3-101, R11-17, R11-18)	lancer, jouer et juger sans humain	Development	à éprouver après M1	oui (BuildCookRun)

Pas de build Test : le moteur du lanceur ne l'installe pas (BaseEngine.ini:4002-4007, relevé dans PIPE1-REVUE-02.md F2). Tracy est retiré : Insights (M4) couvre les fonctions.

Règles communes

• Le palier se choisit par la grille de bareme.md (skill lp-perf) ; la fiche porte la ligne Mesure : … avant tout lancement.
• Verdict = nombres comparés à la base (bareme.md R8) : pour M0, M1 et M4 (Development), référence O0 (5.5 : médiane 16,7 ms, 159 images > 50 ms, 112 > 100 ms ; critère médiane ≤ 17 ms ± 1, Docs\18_Build_Debug.md:86-87, :128), rebasée sur O0-5.8 après l'épreuve de M1 ; pour M2 et M3 (Shipping), base Shipping de l'alpha établie par l'épreuve de M2, sans laquelle le verdict est « non jugé ». Jamais de comparaison entre les deux. Aucun seuil n'est inventé ici.
• Résultats rangés sous D:\Game\LifePlay-master 5.8\Docs\Migration\etat\<projet>\<lot>\ ; jamais dans .hyperai\work\.
• Aucune installation par un agent : le téléchargement des outils tiers est un geste de l'utilisateur, avec relevé du MD5.
• Un palier rodé est lancé par la session (script, sortie d'une ligne par passe) ; un agent lp-perf seulement si le script manque ou échoue ; un agent qui juge est lp-validator (relit les nombres, ne modifie rien).
• Rôle humain : jouer le scénario O0 (une partie par passe), ressenti (caméra, confort), décision, gestes de poste (session élevée, activation d'Adrenalin, téléchargements).

M0 : LogStats

Rubrique	Contenu
Déclencheur	non-régression des compteurs du jeu (grille : Q0, ou plancher E1)
Entrées	LifePlay.log de deux parties Development (A et B), même scénario
Commandes	Tools\LogStats.ps1 -Compare <A>,<B> -Stats
Sorties	compteurs normalisés, section trame / F5 / DESTROY / hitch
Verdict	écart des compteurs A/B ; à-coups seulement si la partie a été lancée avec -LPHitchLog
Rôle humain	jouer la partie (souvent la même passe que M1)
Emplacement	etat\OPT\<lot>\logstats\

M1 : CSV Profiler (lanceur Session C)

Rubrique	Contenu
Déclencheur	cadence instrumentée, coût par fil ou mémoire (Q1, Q3), plancher E2 et E3
Entrées	build Development (Tools\BuildDebug.ps1 -Config Development), scénario O0
Commandes	recette csvprofile.md : -csvGpuStats -llm -llmcsv -ExecCmds="csvprofile repeat=20, csvprofile frames=9000", sans -LPHitchLog, jamais -csvCaptureFrames
Sorties	Saved\Profiling\CSV\*.csv, synthèse SummarizeDebugCsv.ps1, rapport PerfReportTool en option
Verdict	médiane FrameTime, images > 50 et > 100 ms, GT ; contre la base O0
Rôle humain	jouer le scénario O0, une partie par passe
Emplacement	etat\OPT\<lot>\csv\

M2 : PresentMon hors ligne

Rubrique	Contenu
Déclencheur	cadence ressentie de la Shipping (Q2), plancher E3
Entrées	build Shipping (alpha), version de PresentMon figée (2.6.0)
Commandes	trace ETW par wpr ou logman (fournisseurs relevés dans le source de PresentMon 2.6.0), puis PresentMon --etl_file ; recette presentmon.md
Sorties	CSV de PresentMon, synthèse Tools\PresentMonStats.py
Verdict	percentiles 95 et 99 de MsBetweenPresents, images au-dessus du seuil de la base Shipping (sans base : « non jugé »), MsGPUBusy contre MsBetweenPresents
Rôle humain	session élevée ; jouer le scénario
Réserve	la capture en direct ne capte rien sur ce poste (0 image en 6 essais, OPT0-TACHES.md:203-218) ; la voie hors ligne n'est pas essayée et peut échouer pour la même cause. Repli : M3
Emplacement	etat\OPT\<lot>\presentmon\

M3 : AMD Adrenalin

Repli de M2. Activation par l'utilisateur ; format et grain à relever sur un vrai fichier avant d'écrire une recette (OPT0-TACHES.md:217).

M4 : Unreal Insights

Rubrique	Contenu
Déclencheur	quelle fonction ou quel Blueprint coûte (Q4) ; montée depuis M1 (bareme.md R3)
Entrées	build DebugGame ou Development ; passe courte (4 min au plus), à part de M1
Commandes	canaux cpu,frame,bookmark,loadtime (sans memory), -statnamedevents, -tracefile ; export UnrealInsights.exe -OpenTraceFile=… -AutoQuit -NoUI -ExecOnAnalysisCompleteCmd="@=export.rsp" (TimingInsights.ExportTimerStatistics), bareme.md § 1.1
Sorties	.utrace, export CSV des minuteurs d'un fil
Verdict	minuteurs en tête du fil visé ; la trace fausse la cadence, ses temps d'image ne servent pas de verdict
Rôle humain	jouer la passe courte
Réserve	traces longues : 3,3 Go pour 10 min, plus de 50 Go de mémoire à l'analyse (Docs\11_Audit_Optimisation.md:280-281)
Emplacement	etat\OPT\<lot>\insights\

Hors grille : Gauntlet (après l'épreuve de M1)

Rubrique	Contenu
Déclencheur	M1 stable ; décision de l'utilisateur de rejouer M1 sans humain
Entrées	build empaquetée Development par BuildCookRun (tests compilés hors Test et Shipping, R11-17), nom de test
Commandes	recette gauntlet.md
Sorties	rapport JSON / HTML (-ReportExportPath, R3-02), code de sortie
Verdict	code de sortie + comparaison des CSV de M1
Rôle humain	décider la fin de l'essai ; lire les rapports de plantage
Agents	lp-impl pour la SPEC et les réglages, lp-builder pour lancer
Emplacement	etat\OPT\<lot>\gauntlet\
Réserve	un éditeur hôte pilote le client (R11-18, estimé)

Pilotage par agent (axe B, hors paliers)

Le MCP de l'éditeur et Remote Control (R6) servent à piloter l'éditeur ; Remote Control est désactivé en build empaquetée et s'active par drapeaux. Les paliers M0 à M4 ne dépendent pas du MCP.

Suite

1. Épreuve de M1 en 5.8 (fiche à part) : donne la base O0-5.8 et la dispersion du poste, d'où les seuils et le nombre de passes de X2.
2. Épreuve de M4 en 5.8 (lanceur Session A, export sans interface).
3. Épreuve de M2 (fiche B2-ter, accord de l'utilisateur) ; en cas d'échec, M3.
4. Après l'épreuve de M1 seulement : décision sur Gauntlet.
5. K1 : versement des enseignements dans les skills, soumis à l'utilisateur.