Phase 17: Touch UX (PawnDetail+BuildDrawer+WorkMatrix+AlertsLog+Settings)

Three-agent fan-out shipping the major touch UI surfaces. Opus pre-wrote
6 EventBus signals (pawn_selected/deselected, pawn_priority_changed,
alert_added, request_wolf_spawn, day_ended) + Pawn.work_priorities
Dictionary stub before dispatch. Pattern proven across Phases 12-17.

Pawn detail + Settings (Agent A):
- scenes/ui/pawn_detail_panel.gd — right-side CanvasLayer (layer 18),
  ~360px wide, opens on EventBus.pawn_selected. Renders portrait,
  HP/Hunger/Sleep bars with threshold colors, current job, mood +
  sulking, statuses, top 5 mood thoughts, full skill table,
  read-only work-priorities row. Live-refreshes each sim tick.
- scenes/ui/settings_menu.gd — modal CanvasLayer (layer 26), opened
  via Settings button. Auto-pause toggles (Threat/Wanderer/Pawn-Down/
  Modal), audio sliders (stubs for Phase 18), accessibility checkboxes.
  Persists via GameState.apply_settings.
- scenes/world/selection.gd — extended to emit pawn_selected/deselected
  through EventBus on tap.

Build drawer + 12 new Designation tools (Agent B):
- scenes/ui/build_drawer.gd — bottom-sheet CanvasLayer (layer 16) with
  4 tabs (Designate/Build/Stockpile/Cancel) + FAB ⊕ open button.
  Each tab has HFlowContainer of 80×80 buttons with procedural colored
  icons + label. Tap → Designation.set_active_tool + alert + auto-close.
- Designation: added TOOL_CHOP, TOOL_MINE, TOOL_BUILD_CRATE,
  TOOL_BUILD_BED, TOOL_BUILD_TORCH, 5× TOOL_BUILD_WORKBENCH_* variants,
  TOOL_PAINT_STOCKPILE. Plus tool_material override for wall/floor.
- World._on_designation_added: extended dispatch for all 12 new tools;
  added _spawn_workbench() helper for the 5 bench kinds.

Work matrix + Alerts log + Decision refactor + Wolf signal (Agent C):
- scenes/ai/decision.gd: Layer 4 now filters by pawn.work_priorities
  (0=OFF skip, sort by level ascending with provider.priority tiebreak).
  NEEDS_CATEGORIES (rest/eat/sleep) bypass the filter — a pawn can
  never starve from misconfiguration. Audit log prefixes work decisions
  with (pri=N).
- scenes/ui/work_priority_matrix.gd — CanvasLayer (layer 17) bottom-sheet
  grid: rows=pawns × cols=8 work categories. Each cell tap-cycles
  1→2→3→4→0→1, color-coded (red/orange/yellow/blue/gray). Writes back
  to pawn.work_priorities + emits pawn_priority_changed.
- scenes/ui/alerts_log.gd — CanvasLayer (layer 19) ring buffer 50
  entries. Newest first, severity icon (info/warn/danger), Day HH:MM
  timestamp, Go-there camera pan. Listens to alert_added +
  storyteller_event_fired + day_ended.
- EventBus.request_wolf_spawn wired end-to-end: EventCatalog
  _spawn_wolves emits; WolfSpawner._on_request_wolf_spawn force-spawns
  bypassing the darkness/cooldown gates.
- Clock emits EventBus.day_ended(summary) at dusk→night transition.

Top bar buttons added in order: ‖ / 1× / 5× / 12× / Save / Load /
Settings / Build / Work / Log[N]. Plus the ⊕ FAB at bottom-right.

MCP runtime verified all 4 surfaces via screenshot:
- PawnDetailPanel: Bram shows Crafting=8 / Cooking=2 / Manual=0
  matching seed; bars green; Mood: 50; work-priorities readout
- BuildDrawer: 4 tabs visible, Designate tab shows Chop/Mine/Dig grave/
  No roof buttons with procedural icons
- WorkPriorityMatrix: 3 pawns × 8 categories, all '3' (NORMAL default)
  cells in yellow, tap-to-cycle ready
- AlertsLog: 4 entries — red 'Wolf pack approaching!' danger, blue
  'Bram is at the cabin' info, yellow 'Test alert' warn, blue 'Spring
  Awakens' from boot storyteller roll. Go-there button per entry.

Mouse drag-paint works as-is (user noted). Existing
Selection/Designation _unhandled_input handles drag.

Deferred to Phase 17.5 polish:
- Per-pawn/per-job view layers on the matrix
- Stockpile 4×4 chip filter UI (paint creates 1×1 zones today)
- Bill UI for workbenches (programmatic only today)
- 'No stockpile accepts X' / 'Bill blocked' alert emit wiring
- DaySummaryCard visual (signal emits today, no card UI)
- Wanderer recruit UI, resource buff system

Delegation: 3× gdscript-refactor (Sonnet) agents in parallel;
integration + MCP verify on Opus.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

autoload/game_state.gd

@@ -8,16 +8,50 @@ extends Node
 var current_map_id: StringName = &"slice_temperate_forest"
 var session_started_at_unix: int = 0  # for "you've been away X minutes" toast
 
+# Phase 17 — player settings persisted across sessions.
+# Auto-pause booleans mirror the SettingsMenu checkboxes.
+# Audio floats are 0.0..1.0; default 1.0 (full volume).
+# Accessibility stubs wired in a later phase.
+var settings: Dictionary = {
+	"pause_on_threat":    true,
+	"pause_on_wanderer":  true,
+	"pause_on_pawn_down": true,
+	"pause_on_modal":     true,
+	"audio_master":       1.0,
+	"audio_music":        1.0,
+	"audio_sfx":          1.0,
+	"audio_ambient":      1.0,
+	"accessibility_large_text":   false,
+	"accessibility_reduce_motion": false,
+}
+
 
 func _ready() -> void:
 	session_started_at_unix = int(Time.get_unix_time_from_system())
 
 
+## Apply a dictionary of setting values.  Unknown keys are silently ignored so
+## callers can pass partial dicts (e.g. only the audio block).  Each recognised
+## key is type-coerced to match the default type in `settings`.
+func apply_settings(d: Dictionary) -> void:
+	for key in d:
+		if not settings.has(key):
+			continue
+		var default_val = settings[key]
+		if default_val is bool:
+			settings[key] = bool(d[key])
+		elif default_val is float:
+			settings[key] = clampf(float(d[key]), 0.0, 1.0)
+		else:
+			settings[key] = d[key]
+
+
 # Phase 16 expands these into real save round-trip.
 func save_dict() -> Dictionary:
 	return {
 		"current_map_id": String(current_map_id),
 		"session_started_at_unix": session_started_at_unix,
+		"settings": settings.duplicate(),
 	}
 
 
@@ -26,3 +60,6 @@ func apply_dict(d: Dictionary) -> void:
 		current_map_id = StringName(d["current_map_id"])
 	if d.has("session_started_at_unix"):
 		session_started_at_unix = int(d["session_started_at_unix"])
+	# Phase 17 — restore settings block; partial saves are fine.
+	if d.has("settings") and d["settings"] is Dictionary:
+		apply_settings(d["settings"])