erik/acdream
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

test(teleport): tp-probe AIM/ENQ/BUILD/APPLY/PLACED instrumentation (REMOVABLE)

Browse source 
Acceptance apparatus for the teleport-residency fix. ACDREAM_PROBE_TELEPORT=1
gates 5 log points with cross-thread TickCount64 timestamps + the _datLock
waited/held measurement. Stripped (or promoted) at verification (plan T6).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Erik 2026-06-22 13:45:15 +02:00
parent 02f4be72c0
commit 9ac719424c
3 changed files with 52 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

26
src/AcDream.Core/Physics/PhysicsDiagnostics.cs
View file

@ -423,6 +423,31 @@ public static class PhysicsDiagnostics
public static bool ProbeSweptEnabled { get; set; } =
Environment.GetEnvironmentVariable("ACDREAM_PROBE_SWEPT") == "1";
/// <summary>
/// Teleport-foundation timing probe (2026-06-22 — REMOVABLE diagnostic).
/// Emits one <c>[tp-probe]</c> line per teleport-pipeline event with a
/// cross-thread monotonic timestamp (<see cref="Environment.TickCount64"/>)
/// so the offline reader can order AIM / ENQ / BUILD / APPLY / PLACED across
/// the render thread and the streamer worker. Disambiguates the three
/// candidate roots for "destination not resident fast": apply-THROTTLE
/// (APPLY lands before PLACED), <c>_datLock</c> CONTENTION (BUILD waited=
/// large), and a streaming-command GATE (ENQ never fires for the dest).
/// Initial state from <c>ACDREAM_PROBE_TELEPORT=1</c>. Strip after capture.
/// </summary>
public static bool ProbeTeleportEnabled { get; set; } =
Environment.GetEnvironmentVariable("ACDREAM_PROBE_TELEPORT") == "1";
/// <summary>
/// One <c>[tp-probe]</c> line. Self-guards on <see cref="ProbeTeleportEnabled"/>,
/// so callers need not pre-check (the cost when off is a single bool read).
/// </summary>
public static void LogTeleport(string point, uint id, string extra = "")
{
if (!ProbeTeleportEnabled) return;
Console.WriteLine(System.FormattableString.Invariant(
$"[tp-probe] {point,-6} id=0x{id:X8} t={Environment.TickCount64} {extra}"));
}
/// <summary>
/// A6.P3 issue #98 step-walk investigation (2026-05-23). When true,
/// emits one <c>[step-walk]</c> line at selected points in the transition
@ -549,6 +574,7 @@ public static class PhysicsDiagnostics
ProbePlacementFailEnabled = false;
ProbeSweptEnabled = false;
ProbeStepWalkEnabled = false;
ProbeTeleportEnabled = false;
// Side-channel fields
LastBspHitPoly = null;