From 851cecc757d92e641fa8c109f2438bc13cd74060 Mon Sep 17 00:00:00 2001
From: Erik <erik.nihlen@gmail.com>
Date: Tue, 2 Jun 2026 14:08:00 +0200
Subject: [PATCH] =?UTF-8?q?feat(core):=20Phase=20W=20Stage=200=20=E2=80=94?=
 =?UTF-8?q?=20[cell-swept]=20diagnostic=20(swept=20vs=20static=20cell,=20n?=
 =?UTF-8?q?o=20behavior=20change)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add ProbeSweptEnabled (ACDREAM_PROBE_SWEPT=1) to PhysicsDiagnostics mirroring
ProbeCellEnabled. Emits one [cell-swept] line per ResolveWithTransition call —
sp.CurCellId and sp.CheckCellId (the transition's swept cells) alongside the
incoming cellId so a doorway capture shows whether the swept cell is stable
where ResolveCellId strobes. No ResolveCellId call in the probe — avoids the
CellGraph.CurrCell side effect. No behavior change.

TDD: ProbeSweptEnabled_DefaultsToFalse RED→GREEN in PhysicsDiagnosticsTests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/AcDream.Core/Physics/PhysicsDiagnostics.cs    | 15 +++++++++++++++
 src/AcDream.Core/Physics/PhysicsEngine.cs         |  9 +++++++++
 .../Physics/PhysicsDiagnosticsTests.cs            | 11 +++++++++++
 3 files changed, 35 insertions(+)

diff --git a/src/AcDream.Core/Physics/PhysicsDiagnostics.cs b/src/AcDream.Core/Physics/PhysicsDiagnostics.cs
index 260ed07..43a1a8d 100644
--- a/src/AcDream.Core/Physics/PhysicsDiagnostics.cs
+++ b/src/AcDream.Core/Physics/PhysicsDiagnostics.cs
@@ -408,6 +408,21 @@ public static class PhysicsDiagnostics
     public static bool ProbePlacementFailEnabled { get; set; } =
         Environment.GetEnvironmentVariable("ACDREAM_PROBE_PLACEMENT_FAIL") == "1";
 
+    /// <summary>
+    /// Phase W Stage 0 (2026-06-02): one <c>[cell-swept]</c> line per
+    /// <see cref="PhysicsEngine.ResolveWithTransition"/> call — the
+    /// transition's swept cell (<c>sp.CurCellId</c>/<c>sp.CheckCellId</c>)
+    /// vs the position-derived cell the legacy static
+    /// <see cref="PhysicsEngine.ResolveCellId"/> path used. Proves the swept
+    /// cell is stable where the static one strobes at the doorway boundary.
+    ///
+    /// <para>
+    /// Initial state from <c>ACDREAM_PROBE_SWEPT=1</c>. Zero cost when off.
+    /// </para>
+    /// </summary>
+    public static bool ProbeSweptEnabled { get; set; } =
+        Environment.GetEnvironmentVariable("ACDREAM_PROBE_SWEPT") == "1";
+
     /// <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
diff --git a/src/AcDream.Core/Physics/PhysicsEngine.cs b/src/AcDream.Core/Physics/PhysicsEngine.cs
index 4fd40ef..33d03db 100644
--- a/src/AcDream.Core/Physics/PhysicsEngine.cs
+++ b/src/AcDream.Core/Physics/PhysicsEngine.cs
@@ -898,6 +898,15 @@ public sealed class PhysicsEngine
                 $"[resolve] ent=0x{movingEntityId:X8} in=({currentPos.X:F3},{currentPos.Y:F3},{currentPos.Z:F3}) cell=0x{cellId:X8} tgt=({targetPos.X:F3},{targetPos.Y:F3},{targetPos.Z:F3}) out=({probePost.X:F3},{probePost.Y:F3},{probePost.Z:F3}) cell=0x{sp.CheckCellId:X8} ok={ok} groundedIn={isOnGround} cp={probeCp} hit={probeHit} walkable={sp.HasLastWalkablePolygon}"));
         }
 
+        // Phase W Stage 0 (2026-06-02): [cell-swept] probe — swept cell vs static-derived cell.
+        // Emits before the ResolveResult is built so it shows what BOTH paths would return.
+        // No ResolveCellId call here (it has a CellGraph.CurrCell side effect). No behavior change.
+        if (PhysicsDiagnostics.ProbeSweptEnabled)
+        {
+            Console.WriteLine(System.FormattableString.Invariant(
+                $"[cell-swept] ent=0x{movingEntityId:X8} ok={ok} inCell=0x{cellId:X8} curCell=0x{sp.CurCellId:X8} checkCell=0x{sp.CheckCellId:X8} curPos=({sp.CurPos.X:F3},{sp.CurPos.Y:F3},{sp.CurPos.Z:F3}) checkPos=({sp.CheckPos.X:F3},{sp.CheckPos.Y:F3},{sp.CheckPos.Z:F3})"));
+        }
+
         ResolveResult resolveResult;
         if (ok)
         {
diff --git a/tests/AcDream.Core.Tests/Physics/PhysicsDiagnosticsTests.cs b/tests/AcDream.Core.Tests/Physics/PhysicsDiagnosticsTests.cs
index 8c9d45b..81ee081 100644
--- a/tests/AcDream.Core.Tests/Physics/PhysicsDiagnosticsTests.cs
+++ b/tests/AcDream.Core.Tests/Physics/PhysicsDiagnosticsTests.cs
@@ -143,6 +143,17 @@ public class PhysicsDiagnosticsTests
         }
     }
 
+    // -----------------------------------------------------------------------
+    // ProbeSweptEnabled — Phase W Stage 0 (2026-06-02): [cell-swept] diagnostic.
+    // -----------------------------------------------------------------------
+
+    [Fact]
+    public void ProbeSweptEnabled_DefaultsToFalse()
+    {
+        PhysicsDiagnostics.ProbeSweptEnabled = false;
+        Assert.False(PhysicsDiagnostics.ProbeSweptEnabled);
+    }
+
     // -----------------------------------------------------------------------
     // ProbeDumpGfxObjs — parallel of ProbeDumpCells (A6.P3 #98, evening v2).
     // -----------------------------------------------------------------------