refactor: enhance test framework with automated resource tracking and scripted error capture capabilities

tests/helpers/gridmap_mock.gd

@@ -0,0 +1,24 @@
+extends Node
+
+# Minimal EnhancedGridMap stand-in for Gauntlet headless tests. Records
+# set_cell_item calls so lifecycle tests can run the local sync path without a
+# real GridMap. Only the surface the manager touches is implemented.
+
+var cell_size := Vector3(1, 1, 1)
+var cells: Dictionary = {} # Vector3i -> item id
+var astar_inits := 0
+
+func set_cell_item(pos: Vector3i, item: int, _orientation: int = 0) -> void:
+	if item == -1:
+		cells.erase(pos)
+	else:
+		cells[pos] = item
+
+func get_cell_item(pos: Vector3i) -> int:
+	return cells.get(pos, -1)
+
+func initialize_astar() -> void:
+	astar_inits += 1
+
+func update_grid_data() -> void:
+	pass

tests/helpers/gridmap_mock.gd.uid

@@ -0,0 +1 @@
+uid://b7ihsm80fbyb5

tests/helpers/main_mock.gd

@@ -0,0 +1,9 @@
+extends Node
+
+# Minimal "Main" stand-in for Gauntlet headless tests. Provides the RPC methods
+# the GauntletManager calls on its main_scene so calls resolve without the full
+# game scene. Methods are no-ops that just need to exist + be rpc-tagged.
+
+@rpc("any_peer", "call_local", "reliable")
+func sync_grid_item(_x: int, _y: int, _z: int, _item: int) -> void:
+	pass

tests/helpers/main_mock.gd.uid

@@ -0,0 +1 @@
+uid://ca04jq87bj3ap