feat(errand): LLM observation includes a coordinate-labelled ASCII grid map + legend key (maze visible)

proteus/game/scenarios/errand_runner.py

@@ -378,7 +378,31 @@ class ErrandRunner(Scenario):
 
     def legend(self) -> dict[int, str]:
         return {BACKGROUND_IDX: ".", w.C_COURIER: "C", w.C_GRASS: "g", w.C_HOUSE: "H",
-                w.C_WALL: "#", w.C_ROAD: "r", w.C_RED: "L", w.C_CONSTR: "X", w.C_WALLET: "$"}
+                w.C_WALL: "#", w.C_ROAD: "r", w.C_RED: "L", w.C_CONSTR: "X",
+                w.C_WHITE: "X", w.C_WALLET: "$"}
+
+    # Human-readable meaning of each map symbol (the bare "Symbols:" line in the
+    # observation lists characters only; this key explains them so the LLM can
+    # actually read the grid map below).
+    _LEGEND_KEY = (
+        "Map legend: C=courier (one of the three is YOU) | H=brown house = GOAL "
+        "(move your 2x2 onto the H cells to win) | g=grass lawn (walkable shortcut) | "
+        "r=road | #=building wall (blocked) | .=empty | L=red crosswalk (-2 to cross) "
+        "or house roof | X=construction barricade (-1 to step on) | "
+        "$=wallet or fallen pedestrian"
+    )
+
+    def _ascii_map(self, game) -> str:
+        """The live grid as a coordinate-labelled ASCII map (x ruler on top, y on
+        the left) so the model can see the maze of walls/roads, not just coords."""
+        from proteus.game.engine.ascii_view import frame_to_ascii
+        rows = frame_to_ascii(game.current_grid(), self.legend()).split("\n")
+        width = len(rows[0]) if rows else 0
+        tens = "".join(str((c // 10) % 10) for c in range(width))
+        ones = "".join(str(c % 10) for c in range(width))
+        out = ["     " + tens, "   x " + ones, "  y +" + "-" * width]
+        out += [f"  {y:>2}|{row}" for y, row in enumerate(rows)]
+        return "\n".join(out)
 
     def render_frame(self, game) -> str:
         cands = self.candidate_positions(game)
@@ -396,4 +420,8 @@ class ErrandRunner(Scenario):
         if ped is not None and not self._ped_rescued:
             lines.append(f"Fallen pedestrian at ({ped.x},{ped.y}) — interact when adjacent.")
         lines.append(f"Health: {game.health}. Turn: {game.step_count} (no move limit — reach the house).")
+        lines.append("")
+        lines.append(self._LEGEND_KEY)
+        lines.append("Grid map (coordinates are (x,y); find your figure and the H to plan a route):")
+        lines.append(self._ascii_map(game))
         return "\n".join(lines)

tests/scenarios/test_errand_runner.py

@@ -185,3 +185,20 @@ def test_decoys_seed_deterministic_and_stay_passable():
     assert d1 == [(d.x, d.y) for d in s2._decoys(g2)]
     for (dx, dy) in d1:
         assert (dx, dy) in w.passable_cells(w.GAME_LAYOUT)
+
+
+def test_render_frame_includes_ascii_map_and_legend_key():
+    scen, game = _game()
+    frame = scen.render_frame(game)
+    assert "Map legend:" in frame and "GOAL" in frame          # symbol meanings explained
+    assert "Grid map" in frame
+    # the coordinate-labelled ASCII maze is present
+    assert "  y +" in frame                                     # row/col ruler
+    assert "H" in frame and "#" in frame and "C" in frame       # house / wall / courier symbols
+    # the barricade white stripe (palette 0) is mapped, not rendered as '?'
+    assert "?" not in frame
+    # legend covers every index the live grid can emit (no KeyError / unknown)
+    leg = scen.legend()
+    import numpy as np
+    for idx in np.unique(game.current_grid()):
+        assert int(idx) in leg, f"palette {idx} missing from legend"