feat(ui): unified dialogue log with overheard NPC conversations (#535)

Refactors dialogue box into a scrolling conversation log. All dialogue
(player-NPC and overheard NPC-NPC) flows chronologically, oldest at top.
Player response options at the bottom during active conversations.

- Entries expire after configurable timeout (equal for all message types)
- Walk-away clears options but preserves log entries (fair information)
- Per-character name colors from dialogue-theme.yaml (hash-indexed palette)
- Overheard lines render at 90% opacity (D-078)
- Protocol decode for conversation_events + conversation_ended
- GameState fields for conversation_events, conversation_ended, dialogue_response
- Mock Mira/Soren NPC-NPC conversation in test snapshot
- Also wires #511 debug overlay into main.gd and main.tscn

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

client/scripts/autoloads/game_state.gd

@@ -59,6 +59,11 @@ var rng_seed: Variant = null
 # v7 fields (#431, D-059/D-060)
 var pending_recognitions: Array = []  # [{entity_id, x, y, z, remaining_ticks, total_delay_ticks}]
 
+# v9 fields (#535, D-078): Overheard NPC-to-NPC conversations
+var conversation_events: Array = []  # [{speaker_id, target_id, speaker_name, target_name, occluded_line}]
+var conversation_ended: Array = []  # [{speaker_id, target_id}]
+var dialogue_response: Variant = null  # {line_id, text, speaker_entity_id} — NPC follow-up after player choice
+
 # #126, D-018: Medium-range sound events for fog-edge directional indicators.
 # Format: [{x, y, event_type, range_category}] — server sends current medium events per tick.
 var medium_sound_events: Array = []
@@ -169,6 +174,24 @@ func apply_snapshot(snapshot: Dictionary) -> void:
 	else:
 		pending_recognitions = []
 
+	# v9: conversation_events (#535, D-078) — overheard NPC-to-NPC lines
+	if snapshot.has("conversation_events") and snapshot.conversation_events is Array:
+		conversation_events = snapshot.conversation_events
+	else:
+		conversation_events = []
+
+	# v9: conversation_ended (#535, D-078) — pairs whose conversation ended
+	if snapshot.has("conversation_ended") and snapshot.conversation_ended is Array:
+		conversation_ended = snapshot.conversation_ended
+	else:
+		conversation_ended = []
+
+	# v9: dialogue_response (#535, D-028) — NPC follow-up after player choice
+	if snapshot.has("dialogue_response") and snapshot.dialogue_response is Dictionary:
+		dialogue_response = snapshot.dialogue_response
+	else:
+		dialogue_response = null
+
 	# v8: gauntlet mode (#496) — room_id and gauntlet_mode
 	if snapshot.has("gauntlet_mode") and snapshot.gauntlet_mode == true:
 		gauntlet_mode = true

client/scripts/autoloads/sim_bridge.gd

@@ -396,6 +396,37 @@ func _test_snapshot() -> Dictionary:
 			"total_delay_ticks": total_delay,
 		})
 
+	# #535: Mock overheard NPC-NPC conversation (D-078)
+	# Two NPCs (Mira and Soren) trade lines every 5 ticks starting at tick 3.
+	# Conversation ends after 6 exchanges (~30 ticks).
+	var conv_events: Array = []
+	var conv_ended: Array = []
+	var conv_start := 3
+	var conv_lines := [
+		{"speaker": "Mira", "target": "Soren", "line": "The cargo manifests don't add up. Three containers unaccounted for."},
+		{"speaker": "Soren", "target": "Mira", "line": "Could be a logging error. Happens every... cycle."},
+		{"speaker": "Mira", "target": "Soren", "line": "Not like this. Someone moved them after... check."},
+		{"speaker": "Soren", "target": "Mira", "line": "You're reading too much into it. The docks are... these days."},
+		{"speaker": "Mira", "target": "Soren", "line": "Then explain the weight discrepancy. Two hundred kilos... just gone."},
+		{"speaker": "Soren", "target": "Mira", "line": "Fine. I'll pull the bay... tonight. But keep this between us."},
+	]
+	var conv_tick_interval := 5
+	var conv_total_ticks := conv_lines.size() * conv_tick_interval
+	if _test_tick >= conv_start and _test_tick < conv_start + conv_total_ticks:
+		var conv_index := (_test_tick - conv_start) / conv_tick_interval
+		var within_tick := (_test_tick - conv_start) % conv_tick_interval
+		if within_tick == 0 and conv_index < conv_lines.size():
+			var cl: Dictionary = conv_lines[conv_index]
+			conv_events.append({
+				"speaker_id": 10,
+				"target_id": 11,
+				"speaker_name": cl.speaker,
+				"target_name": cl.target,
+				"occluded_line": cl.line,
+			})
+	elif _test_tick == conv_start + conv_total_ticks:
+		conv_ended.append({"speaker_id": 10, "target_id": 11})
+
 	return {
 		"tick": _test_tick,
 		"version": Protocol.PROTOCOL_VERSION,
@@ -417,6 +448,8 @@ func _test_snapshot() -> Dictionary:
 		"current_dialogue": dialogue,
 		"pending_recognitions": pending_recs,
 		"gauntlet_mode": _test_gauntlet_mode,
+		"conversation_events": conv_events,
+		"conversation_ended": conv_ended,
 	}
 
 # Generate a small test room: 8x6 room with walls, a door, and floor

client/scripts/main.gd

@@ -14,10 +14,12 @@ extends Node2D
 @onready var cursor_renderer = $UILayer/CursorRenderer  # D-056: z-layer 7
 @onready var gauntlet_hud = $UILayer/GauntletHUD  # #496: room timer + personal bests
 @onready var checklist_overlay = $UILayer/ChecklistOverlay  # #503: auto-checklist progress
+@onready var debug_overlay = $UILayer/DebugOverlay  # #511: F3 debug overlay
 @onready var bug_report_dialog = $ModalLayer/BugReportDialog  # #495: F12 WRONG button
 @onready var settings_dialog = $ModalLayer/SettingsDialog     # #528: audio settings (ESC/OPEN_MENU)
 
 var _last_dialogue_npc_id: int = -1  # D-064: NPC entity_id for WalkAway input
+var _last_dialogue_npc_name: String = ""  # #535: NPC name for dialogue_response attribution
 var _camera_anchored: bool = false
 var _last_monologue_tick: int = -1       # Prevent re-consuming monologue when same tick polled twice
 var _last_dialogue_tick: int = -1
@@ -130,6 +132,10 @@ func _process(_delta: float) -> void:
 		if checklist_overlay and checklist_overlay.has_method("update_from_state"):
 			checklist_overlay.update_from_state()
 
+		# #511: Update debug overlay (F3 toggle, dev tool)
+		if debug_overlay and debug_overlay.has_method("update_from_state"):
+			debug_overlay.update_from_state()
+
 		# D-018 #125: Play close-range sound events via positional 2D audio
 		_play_close_sound_events()
 
@@ -146,6 +152,11 @@ func _process(_delta: float) -> void:
 		# D-061: Show dialogue if server sent one this tick (#434)
 		_consume_dialogue()
 
+		# #535: Consume overheard conversation events and responses
+		_consume_conversation_events()
+		_consume_conversation_ended()
+		_consume_dialogue_response()
+
 	# Track camera to player position every frame (D-015: locked, no panning)
 	if _camera_anchored:
 		camera.global_position = GameState.player_position * Constants.TILE_SIZE
@@ -316,6 +327,7 @@ func _consume_dialogue() -> void:
 	_last_dialogue_tick = GameState.current_tick
 	var dlg: Dictionary = GameState.current_dialogue
 	_last_dialogue_npc_id = dlg.get("npc_entity_id", -1)
+	_last_dialogue_npc_name = dlg.get("npc_name", "")
 	dialogue_box.show_dialogue(
 		dlg.get("npc_name", ""),
 		dlg.get("speech", ""),
@@ -324,6 +336,34 @@ func _consume_dialogue() -> void:
 	GameState.current_dialogue = null
 
 
+# #535: Consume overheard NPC-NPC conversation events (D-078).
+# Each event carries pre-occluded text — render verbatim in the dialogue log.
+func _consume_conversation_events() -> void:
+	if not dialogue_box:
+		return
+	for event in GameState.conversation_events:
+		dialogue_box.append_conversation_event(event)
+	GameState.conversation_events = []
+
+
+# #535: Handle conversation_ended events — notify dialogue box to stop tracking pairs.
+func _consume_conversation_ended() -> void:
+	if not dialogue_box:
+		return
+	for event in GameState.conversation_ended:
+		dialogue_box.on_conversation_ended(event)
+	GameState.conversation_ended = []
+
+
+# #535: Consume dialogue_response — NPC follow-up line after player picks an option.
+func _consume_dialogue_response() -> void:
+	if GameState.dialogue_response == null or not dialogue_box:
+		return
+	var dr: Dictionary = GameState.dialogue_response
+	dialogue_box.append_dialogue_response(_last_dialogue_npc_name, dr.get("text", ""))
+	GameState.dialogue_response = null
+
+
 # D-061: Handle dialogue option selection → send to server
 func _on_dialogue_option_selected(response_id: String, text: String) -> void:
 	SimBridge.send_input({

client/scripts/protocol/protocol.gd

@@ -180,6 +180,32 @@ static func decode_snapshot(bytes: PackedByteArray) -> Variant:
 			"speaker_entity_id": int(raw_dr.get("speaker_entity_id", -1)),
 		}
 
+	# v9: conversation_events (#535, D-078) — overheard NPC-to-NPC dialogue lines.
+	# Each event carries pre-occluded text plus speaker/target attribution.
+	var conversation_events: Array = []
+	var raw_conv_events: Variant = raw.get("conversation_events")
+	if raw_conv_events is Array:
+		for raw_ce in raw_conv_events:
+			if raw_ce is Dictionary and raw_ce.has("occluded_line"):
+				conversation_events.append({
+					"speaker_id": int(raw_ce.get("speaker_id", 0)),
+					"target_id": int(raw_ce.get("target_id", 0)),
+					"speaker_name": str(raw_ce.get("speaker_name", "")),
+					"target_name": str(raw_ce.get("target_name", "")),
+					"occluded_line": str(raw_ce["occluded_line"]),
+				})
+
+	# v9: conversation_ended (#535, D-078) — pairs whose conversation ended this tick.
+	var conversation_ended: Array = []
+	var raw_conv_ended: Variant = raw.get("conversation_ended")
+	if raw_conv_ended is Array:
+		for raw_end in raw_conv_ended:
+			if raw_end is Dictionary:
+				conversation_ended.append({
+					"speaker_id": int(raw_end.get("speaker_id", 0)),
+					"target_id": int(raw_end.get("target_id", 0)),
+				})
+
 	return {
 		"tick": tick,
 		"entities": entities,
@@ -195,6 +221,8 @@ static func decode_snapshot(bytes: PackedByteArray) -> Variant:
 		"current_dialogue": current_dialogue,
 		"dialogue_response": dialogue_response,
 		"pending_recognitions": pending_recognitions,
+		"conversation_events": conversation_events,
+		"conversation_ended": conversation_ended,
 	}