From 589c7cfb57f1ef14a2da01d88ffd235927a0ac15 Mon Sep 17 00:00:00 2001
From: Erik <erik.nihlen@gmail.com>
Date: Sun, 21 Jun 2026 20:12:45 +0200
Subject: [PATCH] =?UTF-8?q?feat(slice2):=20arrival-gate=20probe=20?=
 =?UTF-8?q?=E2=80=94=20log=20NotReady=E2=86=92Ready=20flip=20with=20landbl?=
 =?UTF-8?q?ock=20count?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 src/AcDream.Core/Physics/PhysicsDiagnostics.cs | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/AcDream.Core/Physics/PhysicsDiagnostics.cs b/src/AcDream.Core/Physics/PhysicsDiagnostics.cs
index 06a3180c..51ee9977 100644
--- a/src/AcDream.Core/Physics/PhysicsDiagnostics.cs
+++ b/src/AcDream.Core/Physics/PhysicsDiagnostics.cs
@@ -31,6 +31,19 @@ public static class PhysicsDiagnostics
     public static bool ProbeResolveEnabled { get; set; } =
         Environment.GetEnvironmentVariable("ACDREAM_PROBE_RESOLVE") == "1";
 
+    /// <summary>
+    /// Retail teleport readiness gate (§3.4, 2026-06-21). When true, every transition of
+    /// the <c>TeleportArrivalReadiness</c> verdict (NotReady → Ready / Impossible) emits one
+    /// <c>[arrival-gate]</c> line: the destination cell id, landblock id, verdict,
+    /// <c>PhysicsEngine.LandblockCount</c> at the moment it flips, and whether the
+    /// flip was forced (Impossible) or natural (Ready).
+    ///
+    /// <para>Initial state from <c>ACDREAM_PROBE_RESOLVE=1</c> — shares the existing probe
+    /// flag because this is a readiness-path extension; no new env var needed.</para>
+    /// </summary>
+    public static bool ProbeArrivalGateEnabled { get; set; } =
+        Environment.GetEnvironmentVariable("ACDREAM_PROBE_RESOLVE") == "1";
+
     /// <summary>
     /// When true, every change to <c>PlayerMovementController.CellId</c>
     /// emits one <c>[cell-transit]</c> line: old → new cell, current
@@ -534,6 +547,7 @@ public static class PhysicsDiagnostics
     public static void ResetForTest()
     {
         ProbeResolveEnabled           = false;
+        ProbeArrivalGateEnabled       = false;
         ProbeCellEnabled              = false;
         ProbeBuildingEnabled          = false;
         ProbeCellSetEnabled           = false;