Phase 19 — onboarding: hint tour + Help modal + tooltip pass

Three-agent fan-out (gdscript-refactor x3) ships the chosen Phase 19
approach: contextual hints during first session + a Help reference,
plus a sweep of hover tooltips for desktop discoverability.

- HintSystem (autoload) + HintOverlay (layer 22 top-center banner):
  7-step tour gated on player events — welcome (boot+2s), pawn select,
  build drawer open, stockpile painted, work matrix open, day_ended,
  tour_complete. Per-hint dismissals persist as Array[String] in
  GameState.settings['dismissed_hints']. Max-3 FIFO queue if hints
  chain. Reduce-motion path snaps in/out instead of tweening.
  Reset_tour() public API for the Help modal.

- HelpModal (layer 20): 5-tab static reference (Controls / Verbs /
  Priorities / Storyteller / Tips). Opens via EventBus.help_requested,
  dimmed backdrop, X/Esc/backdrop-tap dismiss. SettingsMenu gains an
  'Onboarding' section: Show-hints checkbox, Help button (emits
  help_requested), Reset hints button (calls HintSystem.reset_tour with
  has_method guard). Pre-existing 'W' keybind reference fixed to 'P'.

- Tooltip pass: tooltip_text via Strings.t on every TopBar button
  (10 buttons incl. speed shortcuts), BuildDrawer FAB, and every tool
  button in BuildDrawer (21 tools). _add_tool_btn extended with optional
  tooltip param. ~34 new tooltip.* string keys.

Contracts pre-written (Opus): EventBus.help_requested, hint_dismissed,
ui_panel_opened signals; GameState show_hints + dismissed_hints
defaults; BuildDrawer.open + WorkPriorityMatrix.open emit
ui_panel_opened so HintSystem can subscribe via one signal.

Also recorded [MED] known bug in memory.md: drag-paint with active
paint tool is eaten by camera drag-pan.

MCP runtime verified: welcome banner fires 2s after boot, dismiss
queues build_drawer hint on next ui_panel_opened, dismissed_hints
persisted as ['welcome'], HelpModal opens via help_requested with
tab switching working (Controls → Tips verified visually).

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

scenes/ui/settings_menu.gd

@@ -29,6 +29,9 @@ var _sl_ambient: HSlider = null
 var _cb_large_text:     CheckBox = null
 var _cb_reduce_motion:  CheckBox = null
 
+# Onboarding controls.
+var _cb_show_hints: CheckBox = null
+
 
 func _ready() -> void:
 	layer = 26
@@ -136,6 +139,35 @@ func _build_ui() -> void:
 
 	_add_separator(vbox)
 
+	# ── Onboarding section ────────────────────────────────────────────────────
+	var onboard_hdr := Label.new()
+	onboard_hdr.text = Strings.t(&"ui.settings.section.onboarding")
+	vbox.add_child(onboard_hdr)
+
+	_cb_show_hints = _make_checkbox(Strings.t(&"ui.settings.show_hints"), vbox)
+
+	var onboard_btns := HBoxContainer.new()
+	onboard_btns.add_theme_constant_override("separation", 12)
+	vbox.add_child(onboard_btns)
+
+	var help_btn := Button.new()
+	help_btn.name = "HelpBtn"
+	help_btn.text = Strings.t(&"ui.settings.help")
+	help_btn.custom_minimum_size = Vector2(120, 48)
+	help_btn.focus_mode = Control.FOCUS_NONE
+	help_btn.pressed.connect(_on_help_pressed)
+	onboard_btns.add_child(help_btn)
+
+	var reset_hints_btn := Button.new()
+	reset_hints_btn.name = "ResetHintsBtn"
+	reset_hints_btn.text = Strings.t(&"ui.settings.reset_hints")
+	reset_hints_btn.custom_minimum_size = Vector2(140, 48)
+	reset_hints_btn.focus_mode = Control.FOCUS_NONE
+	reset_hints_btn.pressed.connect(_on_reset_hints_pressed)
+	onboard_btns.add_child(reset_hints_btn)
+
+	_add_separator(vbox)
+
 	# ── Save / Cancel row ─────────────────────────────────────────────────────
 	var btn_row := HBoxContainer.new()
 	btn_row.alignment = BoxContainer.ALIGNMENT_CENTER
@@ -226,6 +258,8 @@ func _load_from_game_state() -> void:
 	_cb_large_text.button_pressed    = bool(s.get("accessibility_large_text",    false))
 	_cb_reduce_motion.button_pressed = bool(s.get("accessibility_reduce_motion", false))
 
+	_cb_show_hints.button_pressed = bool(s.get("show_hints", true))
+
 
 func _collect_to_dict() -> Dictionary:
 	return {
@@ -240,6 +274,7 @@ func _collect_to_dict() -> Dictionary:
 		"audio_ambient":      _sl_ambient.value,
 		"accessibility_large_text":    _cb_large_text.button_pressed,
 		"accessibility_reduce_motion": _cb_reduce_motion.button_pressed,
+		"show_hints":                  _cb_show_hints.button_pressed,
 	}
 
 
@@ -276,6 +311,24 @@ func _on_cancel_pressed() -> void:
 	_set_visible(false)
 
 
+func _on_help_pressed() -> void:
+	# Close settings first, then open help so layer 20 (HelpModal) draws above.
+	_set_visible(false)
+	EventBus.help_requested.emit()
+	Audit.log("settings_menu", "help requested")
+
+
+func _on_reset_hints_pressed() -> void:
+	if HintSystem != null and HintSystem.has_method("reset_tour"):
+		HintSystem.reset_tour()
+	else:
+		# Fallback: direct dict mutation if HintSystem hasn't landed yet.
+		GameState.settings["dismissed_hints"] = [] as Array
+		GameState.settings["show_hints"] = true
+	EventBus.alert_added.emit(&"info", Strings.t(&"ui.settings.hints_reset"), Vector2i(-1, -1))
+	Audit.log("settings_menu", "hints reset")
+
+
 # ── visibility ────────────────────────────────────────────────────────────────
 
 func _set_visible(v: bool) -> void: