test(p0): retail-trace golden captured — membership criterion divergence pinned (P0 GATE MET)

P0 Task 6 complete. Captured live retail membership at the 0031<->0170<->0171
doorway via cdb on CPhysicsObj::change_cell (symbol-driven; offsets verified by
discover-types.cdb; PDB MATCH). 22 transitions, clean monotonic sequence, NO
ping-pong (retail is correct-by-construction). Golden:
Conformance/Fixtures/find-cell-list-threshold.log.

ROOT-CAUSE FINDING (the central P1 work): retail transitions membership at the
PORTAL CROSSING (CEnvCell::find_transit_cells @ 0x52c820 pc:309968 — sphere crosses
the doorway polygon plane), while acdream's FindCellList re-picks by POINT-IN-CELL
containment at the foot. Retail commits room 0171 while the foot is STILL inside
vestibule 0170's BSP (in_0171=0); acdream lags. ALL 22 transitions diverge for this
one criterion mismatch — not a per-cell hysteresis or a building-entry-only split.
This is master-plan §0 'hysteresis gap' confirmed against the real client.

FindCellList_DoorwayThreshold_DivergesFromRetail_PendingP1 (documents-the-bug, GREEN)
+ ThresholdDivergenceDiagnosticTests (per-transition containment print) pin it; both
flip when P1 ports the directed portal crossing. Conformance 59 pass / 1 skip / 0 fail;
full Core 1308 pass / 5 fail (baseline) / 1 skip — no new failures.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Erik 2026-06-03 15:04:51 +02:00
parent 1662da8731
commit bb4dead0ae
7 changed files with 253 additions and 59 deletions

View file

@ -1,3 +1,4 @@
using System.Linq;
using System.Numerics;
using AcDream.Core.Physics;
using DatReaderWriter;
@ -86,31 +87,56 @@ public class FindCellListConformanceTests
}
/// <summary>
/// THE retail-trace-backed golden (P0 gate for P1). For each captured retail
/// find_cell_list pick at the doorway threshold, assert acdream's FindCellList
/// returns the SAME cell for the SAME (seed, position). Skips until the capture
/// fixture exists (see tools/cdb/find-cell-list-capture.cdb). If it FAILS once
/// the fixture is in place, that is the P1 divergence — leave it RED, do NOT
/// weaken the assertion (master plan §4).
/// Load the captured retail doorway trace + the building cache. Returns
/// (null, null) when dats or the capture fixture are absent (skip cleanly).
/// Captured 2026-06-03 from live retail at the 0031↔0170↔0171 doorway
/// (tools/cdb/find-cell-list-capture.cdb; 22 transitions, no ping-pong).
/// </summary>
[Fact]
public void FindCellList_DoorwayThreshold_MatchesRetailTrace()
private static (PhysicsDataCache?, System.Collections.Generic.IReadOnlyList<RetailCellPick>?) LoadThresholdGolden()
{
var datDir = ConformanceDats.ResolveDatDir();
if (datDir is null) return;
if (datDir is null) return (null, null);
var fixturePath = System.IO.Path.Combine(ConformanceDats.FixturesDir, "find-cell-list-threshold.log");
if (!System.IO.File.Exists(fixturePath)) return; // gate not yet satisfied — capture pending
if (!System.IO.File.Exists(fixturePath)) return (null, null); // capture pending
using var dats = new DatCollection(datDir, DatAccessType.Read);
var cache = LoadThresholdBuilding(dats);
var picks = RetailTrace.ParseAll(System.IO.File.ReadAllLines(fixturePath));
Assert.NotEmpty(picks); // a present-but-unparseable fixture is itself a failure
return (cache, picks);
}
foreach (var pick in picks)
{
uint ours = CellTransit.FindCellList(cache, pick.Position, FootRadius, pick.SeedCellId);
Assert.Equal(pick.PickedCellId, ours);
}
/// <summary>
/// THE retail-trace-backed golden (the P0 gate for P1). Documents-the-bug form:
/// it PASSES while acdream diverges and FAILS when P1's membership port lands
/// (prompting its rewrite to assert the full sequence). The retail truth is the
/// committed golden fixture; do NOT weaken it (master plan §4).
///
/// ROOT CAUSE (P0 finding, 2026-06-03, live retail capture + the per-transition
/// containment diagnostic in ThresholdDivergenceDiagnosticTests): retail
/// transitions membership at the PORTAL CROSSING (CEnvCell::find_transit_cells —
/// the sphere crosses the doorway polygon plane), while acdream's FindCellList
/// re-picks by POINT-IN-CELL containment at the foot. So retail commits the
/// neighbour cell BEFORE the foot point is geometrically inside it (it enters
/// room 0171 while the foot is still inside vestibule 0170's BSP, in_0171=0), and
/// acdream lags. ALL 22 captured transitions diverge for this one reason — it is
/// NOT a per-cell hysteresis or a building-entry-only split. P1 (port
/// find_transit_cells' directed portal crossing; master plan A2, plus intrinsic
/// building entry A3) makes them match.
/// </summary>
[Fact]
public void FindCellList_DoorwayThreshold_DivergesFromRetail_PendingP1()
{
var (cache, picks) = LoadThresholdGolden();
if (cache is null) return;
Assert.NotEmpty(picks!);
int matches = picks!.Count(p =>
CellTransit.FindCellList(cache, p.Position, FootRadius, p.SeedCellId) == p.PickedCellId);
Assert.True(matches < picks.Count,
$"acdream now reproduces {matches}/{picks.Count} retail doorway transitions. " +
"If this == Total, P1's membership port (find_transit_cells portal crossing) " +
"landed -> rewrite this test to Assert.Equal(pick.PickedCellId, FindCellList(...)) " +
"for every captured pick. The retail truth is in the golden fixture.");
}
}

View file

@ -0,0 +1,22 @@
[fcl] seed=0xA9B40031 px=155.4350 py=16.1483 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4210 py=15.4818 pz=94.0050 picked=0xA9B40171
[fcl] seed=0xA9B40171 px=155.4130 py=15.1004 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4302 py=15.9169 pz=94.0050 picked=0xA9B40031
[fcl] seed=0xA9B40031 px=155.4360 py=16.1878 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4192 py=15.3880 pz=94.0050 picked=0xA9B40171
[fcl] seed=0xA9B40171 px=155.4126 py=15.0677 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4298 py=15.8842 pz=94.0050 picked=0xA9B40031
[fcl] seed=0xA9B40031 px=155.4341 py=16.0885 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4173 py=15.2887 pz=94.0050 picked=0xA9B40171
[fcl] seed=0xA9B40171 px=155.4139 py=15.1239 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4311 py=15.9404 pz=94.0050 picked=0xA9B40031
[fcl] seed=0xA9B40031 px=155.4369 py=16.2114 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4201 py=15.4115 pz=94.0050 picked=0xA9B40171
[fcl] seed=0xA9B40171 px=155.4139 py=15.1135 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4311 py=15.9299 pz=94.0050 picked=0xA9B40031
[fcl] seed=0xA9B40031 px=155.4388 py=16.2898 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4219 py=15.4899 pz=94.0050 picked=0xA9B40171
[fcl] seed=0xA9B40171 px=155.4135 py=15.0863 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4340 py=16.0583 pz=94.0050 picked=0xA9B40031
[fcl] seed=0xA9B40031 px=155.4365 py=16.1738 pz=94.0050 picked=0xA9B40170
[fcl] seed=0xA9B40170 px=155.4196 py=15.3739 pz=94.0050 picked=0xA9B40171

View file

@ -0,0 +1,53 @@
using System.Linq;
using AcDream.Core.Physics;
using DatReaderWriter;
using DatReaderWriter.Options;
using Xunit;
using Xunit.Abstractions;
namespace AcDream.Core.Tests.Conformance;
/// <summary>
/// Diagnostic (always passes): for each captured retail doorway transition, print
/// what acdream computes — PointInCell(seed), PointInCell(picked), and the
/// FindCellList result — so the P0→P1 divergence is precisely characterized
/// (real pick-criterion divergence vs a test/sphere artifact).
/// </summary>
public class ThresholdDivergenceDiagnosticTests
{
private readonly ITestOutputHelper _out;
public ThresholdDivergenceDiagnosticTests(ITestOutputHelper output) => _out = output;
[Fact]
public void Diagnose_ThresholdTransitions()
{
var datDir = ConformanceDats.ResolveDatDir();
if (datDir is null) { _out.WriteLine("SKIP: dats unavailable"); return; }
var fixturePath = System.IO.Path.Combine(ConformanceDats.FixturesDir, "find-cell-list-threshold.log");
if (!System.IO.File.Exists(fixturePath)) { _out.WriteLine("SKIP: capture pending"); return; }
using var dats = new DatCollection(datDir, DatAccessType.Read);
var cache = new PhysicsDataCache();
var cells = new System.Collections.Generic.Dictionary<uint, AcDream.Core.World.Cells.EnvCell>();
for (uint low = 0x016Fu; low <= 0x0175u; low++)
{
uint id = ConformanceDats.HoltburgLandblock | low;
cells[id] = ConformanceDats.LoadEnvCell(dats, cache, id);
}
bool In(uint id, System.Numerics.Vector3 p) =>
cells.TryGetValue(id, out var c) && c.PointInCell(p);
foreach (var pick in RetailTrace.ParseAll(System.IO.File.ReadAllLines(fixturePath)))
{
uint ours = CellTransit.FindCellList(cache, pick.Position, 0.4f, pick.SeedCellId);
_out.WriteLine(
$"seed=0x{pick.SeedCellId & 0xFFFF:X4} pos=({pick.Position.X:F2},{pick.Position.Y:F2},{pick.Position.Z:F2}) " +
$"retail=0x{pick.PickedCellId & 0xFFFF:X4} acdream=0x{ours & 0xFFFF:X4} " +
$"{(ours == pick.PickedCellId ? "MATCH" : "DIVERGE")} | " +
$"inSeed={(In(pick.SeedCellId, pick.Position) ? 1 : 0)} " +
$"in0170={(In(0xA9B40170u, pick.Position) ? 1 : 0)} " +
$"in0171={(In(0xA9B40171u, pick.Position) ? 1 : 0)}");
}
}
}