Phase 15: Storyteller (25 events, daily roll, banner+modal UI)

Three-agent fan-out reusing the contracts-first pattern: Opus pre-wrote EventDef class + 5 EventBus signals + Storyteller autoload stub before dispatch. Pattern proven across Phases 12/13/14/15. EventDef + 25-event corpus (Agent A): - scenes/storyteller/event_def.gd — data class with id/title/body/ category/display/cooldown_days/base_weight/choices/auto_pause/ focus_tile/trigger_predicate/on_resolve - scenes/storyteller/event_catalog.gd — class_name EventCatalog with register_all() dispatcher + 25 _event_NN() static factories covering all 8 categories (nudge×4, seasonal×4, wanderer×4, threat×4, disease×3, resource×3, lore×2, milestone×1) - Strings catalog: 50 keys added (event.<id>.title + event.<id>.body) + ui.go_there / ui.dismiss for UI buttons - on_resolve effects: real-wired for a_bad_cut (StatusCatalog.bleeding), one_year_survived + refugee_family + sleeplessness (colony mood thoughts); stubbed-with-log for wanderer spawns (Phase 17 recruit UI), resource buffs (Phase 17 work-buff system), wolf spawn (EventBus signal pending), fever (StatusCatalog.sick pending), seasonal effects Storyteller real implementation (Agent B): - autoload/storyteller.gd — replaced stub with full logic: * Daily 6 AM roll via Clock.phase_changed(&dawn), one-per-day guard * Per-event cooldown via _event_last_fired Dict; per-category via _category_last_fired Dict + CATEGORY_COOLDOWN_DAYS (nudge=2, seasonal=12, wanderer=5, threat=3, disease=4, resource=3, lore=6, milestone=30) — both gates must pass * Tension model: 0..100, −3/roll decay, +15 on THREAT fire (net +12) Category multipliers: THREAT = lerp(2.0, 0.3, t/100), RESOURCE = lerp(0.5, 1.5, t/100), others = 1.0 * State-trigger 3× weight boost when predicate currently true * Auto-pause Sim before showing UI for auto_pause events * Ghost state: _on_pawn_died flips on World.pawns empty, _ghost_wanderer_target_day = today + randi_range(3, 5), daily roll bypasses pool and force-fires WANDERER (prefers a_traveler) * Full save/load round-trip incl. cooldown dicts (StringName↔String) Banner + Modal UI (Agent C): - scenes/ui/storyteller_banner.gd — class_name StorytellerBanner extends CanvasLayer (layer 15), top-center under top-bar, 6-sec auto-dismiss Timer, tap-to-dismiss-early, internal queue for back-to-back events - scenes/ui/storyteller_modal.gd — class_name StorytellerModal extends CanvasLayer (layer 20), center PanelContainer, full-screen 0.45 dim ColorRect, 0/1/2 choice button layouts - camera_rig.gd: pan_to_tile(tile) public helper using existing _centre_on tween slot - Both UI scenes runtime-instantiated in main.gd as CanvasLayer children (no .tscn edit needed) - %pawn% substitution at display time (World.pawns[0].pawn_name fallback) Modal auto-hide-on-resolve fix (Opus mid-flight): - Original Agent C modal only hid on internal button click. Added EventBus.storyteller_event_resolved subscriber → _set_visible(false) so external resolve_current calls (test scripts, ghost-state auto-fire) also dismiss the dialog. MCP runtime verified across two boots: - Boot 1: day 0 roll → lone_wolf THREAT, modal 'A starving wolf circles your livestock.' with Prepare/Dismiss + auto-pause (tick 1 frozen). Resolve → tension 27→42, sim resumed. - Boot 2: day 0 roll → an_old_map LORE, top-center banner, non-blocking. Banner path + modal path both visually confirmed. Deferred to Phase 17 polish: - EventBus.request_wolf_spawn signal — wolf-spawn effects log-stub today - Wanderer recruit UI (modal currently dismisses, pawn add deferred) - Resource buff system (next-N-jobs multipliers) - 3+ choice modals (current UI renders first 2) - .tres event resources (currently code-as-data factories) Delegation: 3× gdscript-refactor (Sonnet) agents in parallel; modal-hide fix on Opus; integration + MCP verify on Opus. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:01:35 +01:00 · 2026-05-11 19:01:35 +01:00 · 3da7353387
commit 3da7353387
parent 67ec2cce7f
18 changed files with 1560 additions and 13 deletions
--- a/scenes/main/main.gd
+++ b/scenes/main/main.gd
@ -4,6 +4,13 @@ extends Node2D
 ## Once we add menus / continue-game / new-game flows this will branch
 ## on game state. For Phase 1 it just instances the World and TopBar,
 ## which are children placed in main.tscn.
+##
+## Phase 15 — StorytellerBanner and StorytellerModal are runtime-instantiated
+## here (same pattern as world.gd's BeautySystem / DirtinessSystem). Both are
+## CanvasLayer nodes so they draw above the world regardless of scene-tree order.
+
+const STORYTELLER_BANNER_SCRIPT: Script = preload("res://scenes/ui/storyteller_banner.gd")
+const STORYTELLER_MODAL_SCRIPT: Script = preload("res://scenes/ui/storyteller_modal.gd")


 func _ready() -> void:
@ -16,3 +23,18 @@ func _ready() -> void:
 	assert(EventBus != null, "EventBus autoload missing")
 	assert(Strings != null, "Strings autoload missing")
 	assert(SaveSystem != null, "SaveSystem autoload missing")
+
+	# Phase 15 — Storyteller UI layers. Runtime-instantiated so no .tscn edit is
+	# needed. CanvasLayer ensures correct draw order above World/TopBar regardless
+	# of parent-node position.
+	var banner := CanvasLayer.new()
+	banner.set_script(STORYTELLER_BANNER_SCRIPT)
+	banner.name = "StorytellerBanner"
+	add_child(banner)
+
+	var modal := CanvasLayer.new()
+	modal.set_script(STORYTELLER_MODAL_SCRIPT)
+	modal.name = "StorytellerModal"
+	add_child(modal)
+
+	Audit.log("main", "Phase 15 — StorytellerBanner + StorytellerModal mounted.")
--- a/scenes/storyteller/event_catalog.gd
+++ b/scenes/storyteller/event_catalog.gd
@ -0,0 +1,622 @@
+class_name EventCatalog
+## Phase 15 — static registry that constructs all 25 EventDefs from the
+## 25-prompt corpus (docs/design.md §"Prompt corpus") and registers them
+## with the Storyteller autoload at world boot.
+##
+## Usage (in world.gd _ready, after systems are up):
+##   EventCatalog.register_all(Storyteller)
+##
+## Design decisions (see memory.md §"Decisions"):
+## - English copy is inlined in each factory AND mirrored as Strings keys so
+##   the i18n hook (`Strings.t(key)`) exists today without requiring it.
+##   EventDef carries the rendered English string; locale switching can swap
+##   it via the string table later without touching EventDef or this catalog.
+## - Effect helpers below are stubbed with Audit.log lines where full
+##   integration is post-Phase-15:
+##     _spawn_wanderer_pawn  — Phase 17 recruit UI wires the real spawn.
+##     _apply_buff_next_n_jobs — Phase 17 work-buff system.
+##     _spawn_wolves — WolfSpawner is a scene child, not reachable statically;
+##       real wiring will go through EventBus or a future WolfSpawner autoload.
+##     _apply_pawn_status (sick) — StatusCatalog.sick() ships Phase 17.
+##   All real-wired effects are noted per-event below.
+##
+## The 25-event count is the Phase 15 gate. Do not commit with != 25.
+
+
+## Construct all 25 EventDefs and register them with `storyteller_node`.
+## Called once from world._ready(), after World systems are mounted.
+static func register_all(storyteller_node: Node) -> void:
+	var defs: Array = [
+		# ── Nudges (1-4) ──────────────────────────────────────────────────
+		_event_01_first_beds(),
+		_event_02_empty_larder(),
+		_event_03_no_fire(),
+		_event_04_walls(),
+		# ── Seasonal (5-8) ────────────────────────────────────────────────
+		_event_05_spring_awakens(),
+		_event_06_summers_heat(),
+		_event_07_autumns_harvest(),
+		_event_08_winters_edge(),
+		# ── Wanderers (9-12) ──────────────────────────────────────────────
+		_event_09_a_traveler(),
+		_event_10_the_refugee_family(),
+		_event_11_the_old_soldier(),
+		_event_12_the_wandering_healer(),
+		# ── Threats (13-16) ───────────────────────────────────────────────
+		_event_13_wolves_at_the_edge(),
+		_event_14_lone_wolf(),
+		_event_15_pack_hunt(),
+		_event_16_bandit_scouts(),
+		# ── Disease (17-19) ───────────────────────────────────────────────
+		_event_17_fever(),
+		_event_18_a_bad_cut(),
+		_event_19_the_sleeplessness(),
+		# ── Resource (20-22) ──────────────────────────────────────────────
+		_event_20_bountiful_harvest(),
+		_event_21_lumberjacks_luck(),
+		_event_22_veins_of_iron(),
+		# ── Lore (23-24) ──────────────────────────────────────────────────
+		_event_23_strange_stones(),
+		_event_24_an_old_map(),
+		# ── Milestone (25) ────────────────────────────────────────────────
+		_event_25_one_year_survived(),
+	]
+	for def in defs:
+		storyteller_node.register_event(def)
+	Audit.log("storyteller", "%d events registered" % defs.size())
+
+
+# ── Nudge factories ─────────────────────────────────────────────────────────
+
+static func _event_01_first_beds() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"first_beds"
+	d.title = "First Beds"
+	d.body = "Your settlers slept on the cold ground again. They are starting to ache."
+	d.category = EventDef.Category.NUDGE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 3
+	d.base_weight = 3.0  # high weight — active whenever trigger is true
+	d.auto_pause = false
+	# Trigger: day 2+, fewer beds than pawns.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 2 and World.beds.size() < World.pawns.size()
+	d.on_resolve = func(_c: int) -> void:
+		pass  # nudge — dismiss only, no mechanical effect
+	return d
+
+
+static func _event_02_empty_larder() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"empty_larder"
+	d.title = "Empty Larder"
+	d.body = "The larder is bare. Spring won't last forever."
+	d.category = EventDef.Category.NUDGE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 3
+	d.base_weight = 2.0
+	d.auto_pause = false
+	# Trigger: day 3+, no crops in the world (proxy for no farm zone).
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 3 and World.crops.is_empty()
+	d.on_resolve = func(_c: int) -> void:
+		pass
+	return d
+
+
+static func _event_03_no_fire() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"no_fire"
+	d.title = "No Fire"
+	d.body = "Without a hearth, the cold will bite by night."
+	d.category = EventDef.Category.NUDGE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 3
+	d.base_weight = 2.0
+	d.auto_pause = false
+	# Trigger: day 4+, no light sources (proxy for no hearth/torch).
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 4 and World.light_sources.is_empty()
+	d.on_resolve = func(_c: int) -> void:
+		pass
+	return d
+
+
+static func _event_04_walls() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"walls"
+	d.title = "Walls?"
+	d.body = "Sleeping under stars is romantic until the wolves arrive."
+	d.category = EventDef.Category.NUDGE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 4
+	d.base_weight = 2.0
+	d.auto_pause = false
+	# Trigger: day 5+, build queue has no wall entities and no completed walls.
+	# Proxy: no doors means no enclosed building.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 5 and World.doors.is_empty()
+	d.on_resolve = func(_c: int) -> void:
+		pass
+	return d
+
+
+# ── Seasonal factories ──────────────────────────────────────────────────────
+
+static func _event_05_spring_awakens() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"spring_awakens"
+	d.title = "Spring Awakens"
+	d.body = "The thaw runs in every stream. Crops will grow fast now."
+	d.category = EventDef.Category.SEASONAL
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 12
+	d.base_weight = 1.0
+	d.auto_pause = false
+	# Trigger: first tick of spring. Storyteller fires this once per season boundary.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_season() == Clock.SEASON_SPRING
+	# Effect: stubbed — Phase 17 will apply +10% crop growth for the season.
+	d.on_resolve = func(_c: int) -> void:
+		Audit.log("storyteller", "spring_awakens resolved — crop growth buff stubbed (Phase 17)")
+	return d
+
+
+static func _event_06_summers_heat() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"summers_heat"
+	d.title = "Summer's Heat"
+	d.body = "The sun beats down. Unsheltered work will tire faster."
+	d.category = EventDef.Category.SEASONAL
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 12
+	d.base_weight = 1.0
+	d.auto_pause = false
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_season() == Clock.SEASON_SUMMER
+	# Effect: stubbed — Phase 17 will apply outdoor work −5% speed modifier.
+	d.on_resolve = func(_c: int) -> void:
+		Audit.log("storyteller", "summers_heat resolved — outdoor fatigue buff stubbed (Phase 17)")
+	return d
+
+
+static func _event_07_autumns_harvest() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"autumns_harvest"
+	d.title = "Autumn's Harvest"
+	d.body = "The fields are heavy with the last of the year's bounty."
+	d.category = EventDef.Category.SEASONAL
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 12
+	d.base_weight = 1.0
+	d.auto_pause = false
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_season() == Clock.SEASON_AUTUMN
+	# Effect: stubbed — Phase 17 will apply +15% harvest yield.
+	d.on_resolve = func(_c: int) -> void:
+		Audit.log("storyteller", "autumns_harvest resolved — yield buff stubbed (Phase 17)")
+	return d
+
+
+static func _event_08_winters_edge() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"winters_edge"
+	d.title = "Winter's Edge"
+	d.body = "Frost has come. The road is closed; you are alone."
+	d.category = EventDef.Category.SEASONAL
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 12
+	d.base_weight = 1.0
+	d.auto_pause = false
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_season() == Clock.SEASON_WINTER
+	# Effect: no wanderers 5 days + raise threat weight — both stubbed Phase 17.
+	d.on_resolve = func(_c: int) -> void:
+		Audit.log("storyteller", "winters_edge resolved — wanderer suppress + threat weight stubbed (Phase 17)")
+	return d
+
+
+# ── Wanderer factories ──────────────────────────────────────────────────────
+
+static func _event_09_a_traveler() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"a_traveler"
+	d.title = "A Traveler"
+	d.body = "A weary traveler stumbles toward your gate. They look hungry. Will you welcome them?"
+	d.category = EventDef.Category.WANDERER
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 5
+	d.base_weight = 1.0
+	d.choices = ["Welcome", "Send away"]
+	d.auto_pause = true
+	# Trigger: ghost state (all pawns gone) OR ~8 days have passed.
+	d.trigger_predicate = func() -> bool:
+		return Storyteller.ghost_state or Clock.current_day() >= 8
+	# Effect: Welcome → +1 pawn (stub); Send away → no effect.
+	d.on_resolve = func(c: int) -> void:
+		if c == 0:
+			_spawn_wanderer_pawn({})
+	return d
+
+
+static func _event_10_the_refugee_family() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"the_refugee_family"
+	d.title = "The Refugee Family"
+	d.body = "A family fleeing bandits arrives. They have nothing, but they would work hard."
+	d.category = EventDef.Category.WANDERER
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 8
+	d.base_weight = 1.0
+	d.choices = ["Welcome", "Refuse"]
+	d.auto_pause = true
+	# Trigger: post-day-15.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 15
+	# Effect: Welcome → +2 pawns low skills (stub); Refuse → −2 mood colony 1 day (stub).
+	d.on_resolve = func(c: int) -> void:
+		if c == 0:
+			_spawn_wanderer_pawn({})
+			_spawn_wanderer_pawn({})
+		else:
+			_apply_colony_mood_thought(func() -> Thought: return ThoughtCatalog.slept_on_floor())  # placeholder thought, Phase 17 adds colony_refused_refugees
+			Audit.log("storyteller", "refugee_family refused — colony mood penalty stubbed (Phase 17)")
+	return d
+
+
+static func _event_11_the_old_soldier() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"the_old_soldier"
+	d.title = "The Old Soldier"
+	d.body = "A retired soldier offers his blade for a place by your fire. Combat 8, but old and tired."
+	d.category = EventDef.Category.WANDERER
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 8
+	d.base_weight = 1.0
+	d.choices = ["Welcome", "Refuse"]
+	d.auto_pause = true
+	# Trigger: post-day-20.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 20
+	d.on_resolve = func(c: int) -> void:
+		if c == 0:
+			_spawn_wanderer_pawn({"combat": 8})
+	return d
+
+
+static func _event_12_the_wandering_healer() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"the_wandering_healer"
+	d.title = "The Wandering Healer"
+	d.body = "A traveling healer asks for shelter. She brings knowledge of medicine."
+	d.category = EventDef.Category.WANDERER
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 8
+	d.base_weight = 1.0
+	d.choices = ["Welcome", "Refuse"]
+	d.auto_pause = true
+	# Trigger: any pawn has a status (proxy for sick/injured — exact sick() status ships Phase 17).
+	d.trigger_predicate = func() -> bool:
+		for p in World.pawns:
+			if not p.statuses.is_empty():
+				return true
+		return false
+	d.on_resolve = func(c: int) -> void:
+		if c == 0:
+			_spawn_wanderer_pawn({"medicine": 6})
+	return d
+
+
+# ── Threat factories ─────────────────────────────────────────────────────────
+
+static func _event_13_wolves_at_the_edge() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"wolves_at_the_edge"
+	d.title = "Wolves at the Edge"
+	d.body = "Wolves howl in the distance. They will be here by nightfall."
+	d.category = EventDef.Category.THREAT
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 3
+	d.base_weight = 1.0
+	d.choices = ["Prepare"]
+	d.auto_pause = true
+	# Trigger: anytime after day 3 (season-weighting handled by Storyteller tension).
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 3
+	# Effect: spawn 1-3 wolves (stubbed until WolfSpawner is accessible statically).
+	d.on_resolve = func(_c: int) -> void:
+		_spawn_wolves(randi_range(1, 3))
+	return d
+
+
+static func _event_14_lone_wolf() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"lone_wolf"
+	d.title = "Lone Wolf"
+	d.body = "A starving wolf circles your livestock."
+	d.category = EventDef.Category.THREAT
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 3
+	d.base_weight = 1.5  # slightly higher — low-threat random, more common
+	d.choices = ["Prepare"]
+	d.auto_pause = true
+	# Trigger: anytime (low-threat random).
+	d.trigger_predicate = func() -> bool:
+		return true
+	d.on_resolve = func(_c: int) -> void:
+		_spawn_wolves(1)
+	return d
+
+
+static func _event_15_pack_hunt() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"pack_hunt"
+	d.title = "Pack Hunt"
+	d.body = "A hunting pack moves through the forest. They smell your colony."
+	d.category = EventDef.Category.THREAT
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 5
+	d.base_weight = 1.0
+	d.choices = ["Prepare"]
+	d.auto_pause = true
+	# Trigger: post-day-30.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 30
+	d.on_resolve = func(_c: int) -> void:
+		_spawn_wolves(randi_range(4, 6))
+	return d
+
+
+static func _event_16_bandit_scouts() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"bandit_scouts"
+	d.title = "Bandit Scouts"
+	d.body = "Strange figures watched from the treeline at dusk. Bandits, perhaps."
+	d.category = EventDef.Category.THREAT
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 5
+	d.base_weight = 1.0
+	d.choices = ["Stay alert"]
+	d.auto_pause = true
+	# Trigger: post-day-25.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 25
+	# Effect: flavor + threat-likelihood raise — stubbed (v2 raids).
+	d.on_resolve = func(_c: int) -> void:
+		Audit.log("storyteller", "bandit_scouts resolved — threat-likelihood raise stubbed (v2 raids)")
+	return d
+
+
+# ── Disease factories ────────────────────────────────────────────────────────
+
+static func _event_17_fever() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"fever"
+	d.title = "Fever"
+	d.body = "%pawn% woke with a fever. The sickness may spread."
+	d.category = EventDef.Category.DISEASE
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 4
+	d.base_weight = 1.0
+	d.choices = ["Treat them"]
+	d.auto_pause = true
+	# Trigger: random after ~30 days.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 30 and not World.pawns.is_empty()
+	# Effect: Sick status on random pawn — StatusCatalog.sick() ships Phase 17.
+	d.on_resolve = func(_c: int) -> void:
+		Audit.log("storyteller", "fever resolved — StatusCatalog.sick() stubbed (Phase 17)")
+	return d
+
+
+static func _event_18_a_bad_cut() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"a_bad_cut"
+	d.title = "A Bad Cut"
+	d.body = "%pawn% gashed their hand chopping wood. The wound looks deep."
+	d.category = EventDef.Category.DISEASE
+	d.display = EventDef.Display.MODAL
+	d.cooldown_days = 4
+	d.base_weight = 1.0
+	d.choices = ["Treat them"]
+	d.auto_pause = true
+	# Trigger: any tree chopped and low chance (proxy: trees exist and day >= 5).
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 5 and not World.trees.is_empty()
+	# Effect: Bleeding status on a random pawn — real-wired (StatusCatalog.bleeding exists).
+	d.on_resolve = func(_c: int) -> void:
+		_apply_pawn_status(func() -> Status: return StatusCatalog.bleeding(1))
+	return d
+
+
+static func _event_19_the_sleeplessness() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"the_sleeplessness"
+	d.title = "The Sleeplessness"
+	d.body = "%pawn% has barely slept. Something weighs on them."
+	d.category = EventDef.Category.DISEASE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 4
+	d.base_weight = 1.0
+	d.auto_pause = false
+	# Trigger: any pawn is tired (has the tired thought/status).
+	d.trigger_predicate = func() -> bool:
+		for p in World.pawns:
+			if p.is_tired():
+				return true
+		return false
+	# Effect: mood penalty 2 days — apply tired thought colony-wide (stubbed intensity).
+	d.on_resolve = func(_c: int) -> void:
+		_apply_colony_mood_thought(func() -> Thought: return ThoughtCatalog.tired())
+	return d
+
+
+# ── Resource factories ───────────────────────────────────────────────────────
+
+static func _event_20_bountiful_harvest() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"bountiful_harvest"
+	d.title = "Bountiful Harvest"
+	d.body = "Your fields exceeded the season. The granary swells."
+	d.category = EventDef.Category.RESOURCE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 3
+	d.base_weight = 1.0
+	d.auto_pause = false
+	# Trigger: autumn (harvest season) and crops are present.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_season() == Clock.SEASON_AUTUMN and not World.crops.is_empty()
+	# Effect: +25% yield — stubbed, Phase 17 crop-yield multiplier.
+	d.on_resolve = func(_c: int) -> void:
+		_apply_buff_next_n_jobs(&"harvest", 10, 1.25)
+	return d
+
+
+static func _event_21_lumberjacks_luck() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"lumberjacks_luck"
+	d.title = "Lumberjack's Luck"
+	d.body = "%pawn% found a copse of unusually thick trees."
+	d.category = EventDef.Category.RESOURCE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 3
+	d.base_weight = 1.0
+	d.auto_pause = false
+	# Trigger: trees present (chop job context).
+	d.trigger_predicate = func() -> bool:
+		return not World.trees.is_empty()
+	# Effect: next 3 trees +50% wood — stubbed.
+	d.on_resolve = func(_c: int) -> void:
+		_apply_buff_next_n_jobs(&"chop", 3, 1.5)
+	return d
+
+
+static func _event_22_veins_of_iron() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"veins_of_iron"
+	d.title = "Veins of Iron"
+	d.body = "A miner reports a rich vein, deeper than expected."
+	d.category = EventDef.Category.RESOURCE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 3
+	d.base_weight = 1.0
+	d.auto_pause = false
+	# Trigger: rocks present (mine job context).
+	d.trigger_predicate = func() -> bool:
+		return not World.rocks.is_empty()
+	# Effect: next mining yield ×2 — stubbed.
+	d.on_resolve = func(_c: int) -> void:
+		_apply_buff_next_n_jobs(&"mine", 1, 2.0)
+	return d
+
+
+# ── Lore factories ───────────────────────────────────────────────────────────
+
+static func _event_23_strange_stones() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"strange_stones"
+	d.title = "Strange Stones"
+	d.body = "Settlers report finding carved stones in the wood — older than any memory."
+	d.category = EventDef.Category.LORE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 6
+	d.base_weight = 1.0
+	d.auto_pause = false
+	# Trigger: post-day-15, random.
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 15
+	d.on_resolve = func(_c: int) -> void:
+		pass  # flavor only
+	return d
+
+
+static func _event_24_an_old_map() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"an_old_map"
+	d.title = "An Old Map"
+	d.body = "%pawn% found a tattered map. Roads to the north, half-faded."
+	d.category = EventDef.Category.LORE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 6
+	d.base_weight = 1.0
+	d.auto_pause = false
+	# Trigger: post-recruit (more than 1 pawn present).
+	d.trigger_predicate = func() -> bool:
+		return World.pawns.size() > 1
+	d.on_resolve = func(_c: int) -> void:
+		pass  # flavor; seeds v2 trade/exploration
+	return d
+
+
+# ── Milestone factory ────────────────────────────────────────────────────────
+
+static func _event_25_one_year_survived() -> EventDef:
+	var d := EventDef.new()
+	d.id = &"one_year_survived"
+	d.title = "One Year Survived"
+	d.body = "A full year. The first frost feels different now — yours is a real settlement."
+	d.category = EventDef.Category.MILESTONE
+	d.display = EventDef.Display.BANNER
+	d.cooldown_days = 30
+	d.base_weight = 1.0
+	d.auto_pause = false
+	# Trigger: end of first winter (day >= 4 seasons × 12 days = 48).
+	d.trigger_predicate = func() -> bool:
+		return Clock.current_day() >= 48 and Clock.current_season() == Clock.SEASON_WINTER
+	# Effect: +5 mood "We made it" colony 2 days — real-wired via colony thought.
+	d.on_resolve = func(_c: int) -> void:
+		_apply_colony_mood_thought(func() -> Thought: return ThoughtCatalog.well_rested())
+		# well_rested() is the closest existing +5 mood thought; Phase 17 adds
+		# ThoughtCatalog.we_made_it() with correct label + longer duration.
+	return d
+
+
+# ── Effect helpers ───────────────────────────────────────────────────────────
+## All helpers are static. Stub bodies log via Audit where the underlying
+## system is not yet available; real bodies are annotated per-helper.
+
+## Instantiate a new pawn at a random map-edge tile with optional skill seed.
+## STUB — Phase 17 recruit UI will wire the real spawn via PawnFactory or similar.
+static func _spawn_wanderer_pawn(skills: Dictionary = {}) -> void:
+	Audit.log("storyteller", "_spawn_wanderer_pawn called with skills=%s — stubbed (Phase 17)" % str(skills))
+
+
+## Flag the next `count` jobs of `kind` to use a yield multiplier.
+## STUB — Phase 17 work-buff system will implement the ring buffer.
+static func _apply_buff_next_n_jobs(kind: StringName, count: int, multiplier: float) -> void:
+	Audit.log("storyteller", "_apply_buff_next_n_jobs: kind=%s count=%d ×%.2f — stubbed (Phase 17)" % [kind, count, multiplier])
+
+
+## Emit EventBus.request_wolf_spawn so WolfSpawner (scene child) picks it up.
+## WolfSpawner listens on that signal (Phase 10). This is the correct bus-based
+## wiring — no get_node("/root/...") smell.
+static func _spawn_wolves(count: int) -> void:
+	if EventBus.has_signal("request_wolf_spawn"):
+		EventBus.emit_signal("request_wolf_spawn", count)
+	else:
+		Audit.log("storyteller", "_spawn_wolves: EventBus.request_wolf_spawn not declared — stubbed (Phase 17)")
+
+
+## Apply a status to a random pawn (or a specific pawn if non-null).
+## The factory callable returns a fresh Status — mirrors StatusCatalog pattern.
+## REAL for statuses that exist (bleeding); STUB for sick() until Phase 17.
+static func _apply_pawn_status(status_factory: Callable, pawn = null) -> void:
+	var target = pawn
+	if target == null:
+		if World.pawns.is_empty():
+			Audit.log("storyteller", "_apply_pawn_status: no pawns present")
+			return
+		target = World.pawns[randi() % World.pawns.size()]
+	if target.has_method("add_status"):
+		target.add_status(status_factory.call())
+	else:
+		Audit.log("storyteller", "_apply_pawn_status: target missing add_status()")
+
+
+## Apply a thought to every living pawn in the colony.
+## `thought_factory` is a Callable that returns a fresh Thought each time.
+## REAL — ThoughtCatalog thoughts and Pawn.add_thought() both exist.
+static func _apply_colony_mood_thought(thought_factory: Callable) -> void:
+	for p in World.pawns:
+		if p.has_method("add_thought"):
+			p.add_thought(thought_factory.call())
--- a/scenes/storyteller/event_catalog.gd.uid
+++ b/scenes/storyteller/event_catalog.gd.uid
@ -0,0 +1 @@
+uid://bcvgf1norskt3
--- a/scenes/storyteller/event_def.gd
+++ b/scenes/storyteller/event_def.gd
@ -0,0 +1,81 @@
+class_name EventDef extends RefCounted
+## Phase 15 — Storyteller event definition (data class).
+##
+## EventDef is the static, authored shape of one event from the 25-prompt corpus
+## (see docs/design.md "Prompt corpus"). Storyteller picks one EventDef per
+## daily 6 AM roll, then runs its trigger predicate + cooldown gates, then
+## applies its effect.
+##
+## EventDef instances are constructed in EventCatalog (`scenes/storyteller/event_catalog.gd`)
+## by Agent A. They're treated as immutable at runtime; per-event cooldown state
+## lives in Storyteller, NOT here.
+##
+## Categories (locked, mirror design.md headings):
+##   NUDGE     — soft dismissible banner, no pause
+##   SEASONAL  — ambient banner on season transition
+##   WANDERER  — modal with choice (Welcome / Refuse)
+##   THREAT    — modal with auto-pause; spawns hostiles
+##   DISEASE   — modal or nudge; applies status to a pawn
+##   RESOURCE  — banner; applies a transient buff
+##   LORE      — flavor banner, no mechanical effect
+##   MILESTONE — celebratory banner; small mood thought
+##
+## Display kinds:
+##   BANNER — non-blocking, auto-dismiss
+##   MODAL  — blocking, may auto-pause, may carry choices
+
+enum Category {
+	NUDGE,
+	SEASONAL,
+	WANDERER,
+	THREAT,
+	DISEASE,
+	RESOURCE,
+	LORE,
+	MILESTONE,
+}
+
+enum Display {
+	BANNER,
+	MODAL,
+}
+
+## Stable id. Used for cooldown tracking and Strings.t() keys.
+var id: StringName = &""
+
+## Display title — short. Localized via Strings catalog by Agent A.
+var title: String = ""
+
+## Body copy — 1-2 sentences, supports `%pawn%` substitution.
+var body: String = ""
+
+var category: Category = Category.NUDGE
+var display: Display = Display.BANNER
+
+## Cooldown in in-game days from this event. Per-event gate.
+## Per-category cooldowns live in Storyteller.CATEGORY_COOLDOWN_DAYS.
+var cooldown_days: int = 3
+
+## Base weight in the daily roll's weighted pool. Tension/state modifiers
+## multiply this at roll time.
+var base_weight: float = 1.0
+
+## Optional choice labels for MODAL events (e.g. ["Welcome", "Send away"]).
+## Empty array = dismiss-only.
+var choices: Array[String] = []
+
+## If true, this event causes a sim auto-pause when fired (Storyteller calls
+## Sim.set_speed(PAUSE) before showing the UI).
+var auto_pause: bool = false
+
+## Optional tile to focus the "Go there" camera-pan on. Vector2i(-1, -1) = no jump.
+var focus_tile: Vector2i = Vector2i(-1, -1)
+
+## Predicate evaluated by Storyteller before this event is eligible to roll.
+## Set in the EventCatalog factory; returns true when world state matches.
+## Signature: Callable that takes no args, returns bool.
+var trigger_predicate: Callable = Callable()
+
+## Effect applied when the event resolves (chosen path for modals, immediate for banners).
+## Signature: Callable taking (choice_index: int) — choice 0 = first option / dismiss.
+var on_resolve: Callable = Callable()
--- a/scenes/storyteller/event_def.gd.uid
+++ b/scenes/storyteller/event_def.gd.uid
@ -0,0 +1 @@
+uid://fymgewgr885g
--- a/scenes/ui/storyteller_banner.gd
+++ b/scenes/ui/storyteller_banner.gd
@ -0,0 +1,198 @@
+class_name StorytellerBanner extends CanvasLayer
+## Phase 15 — Non-blocking ambient banner for BANNER-display EventDef events.
+##
+## Anchored top-center just below the top bar (~60 px Y offset).
+## Shows: title (bold), body, optional "Go there" button.
+## Auto-dismisses after 6 sec via Timer; tap-to-dismiss-early also supported.
+##
+## Multiple banners queue — only one is visible at a time.  On dismiss the
+## next queued event is shown automatically.
+##
+## On dismiss: calls Storyteller.resolve_current(0).
+## Subscribes to EventBus.storyteller_event_fired in _ready; ignores MODAL events.
+
+const AUTO_DISMISS_SEC: float = 6.0
+const TILE_SIZE_PX: int = 16
+
+## Internal queue of pending EventDef refs (BANNER display only).
+var _queue: Array = []
+## The EventDef currently on screen (null when idle).
+var _current_event = null
+
+# ── node refs ───────────────────────────────────────────────────────────────
+var _root: Control = null
+var _title_label: Label = null
+var _body_label: Label = null
+var _go_there_btn: Button = null
+var _dismiss_btn: Button = null
+var _timer: Timer = null
+
+
+func _ready() -> void:
+	layer = 15  # above world (0), above top-bar (10), below modal (20)
+
+	_build_ui()
+	_root.visible = false
+
+	EventBus.storyteller_event_fired.connect(_on_event_fired)
+	Audit.log("storyteller_ui", "StorytellerBanner ready")
+
+
+func _exit_tree() -> void:
+	if EventBus.storyteller_event_fired.is_connected(_on_event_fired):
+		EventBus.storyteller_event_fired.disconnect(_on_event_fired)
+
+
+# ── UI construction ──────────────────────────────────────────────────────────
+
+func _build_ui() -> void:
+	# Outer anchor — top-center strip.
+	_root = Control.new()
+	_root.name = "BannerRoot"
+	_root.set_anchors_preset(Control.PRESET_TOP_WIDE)
+	_root.custom_minimum_size = Vector2(0, 80)
+	_root.offset_top = 60     # sit just below the 48 px top bar
+	_root.offset_bottom = 140
+	_root.mouse_filter = Control.MOUSE_FILTER_PASS
+	add_child(_root)
+
+	# Panel background centred horizontally.
+	var panel := PanelContainer.new()
+	panel.name = "Panel"
+	panel.set_anchors_preset(Control.PRESET_CENTER_TOP)
+	panel.custom_minimum_size = Vector2(480, 80)
+	# Offset so it stays centred regardless of screen width.
+	panel.offset_left = -240
+	panel.offset_right = 240
+	panel.offset_top = 0
+	panel.offset_bottom = 80
+	panel.mouse_default_cursor_shape = Control.CURSOR_POINTING_HAND
+	_root.add_child(panel)
+
+	# Tap-anywhere-to-dismiss — GuiInput on the panel itself.
+	panel.gui_input.connect(_on_panel_gui_input)
+
+	var vbox := VBoxContainer.new()
+	vbox.add_theme_constant_override("separation", 4)
+	panel.add_child(vbox)
+
+	_title_label = Label.new()
+	_title_label.name = "TitleLabel"
+	_title_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
+	_title_label.autowrap_mode = TextServer.AUTOWRAP_WORD_SMART
+	vbox.add_child(_title_label)
+
+	_body_label = Label.new()
+	_body_label.name = "BodyLabel"
+	_body_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
+	_body_label.autowrap_mode = TextServer.AUTOWRAP_WORD_SMART
+	vbox.add_child(_body_label)
+
+	var btn_row := HBoxContainer.new()
+	btn_row.alignment = BoxContainer.ALIGNMENT_CENTER
+	btn_row.add_theme_constant_override("separation", 8)
+	vbox.add_child(btn_row)
+
+	_go_there_btn = Button.new()
+	_go_there_btn.name = "GoThereBtn"
+	_go_there_btn.text = Strings.t(&"ui.go_there")
+	_go_there_btn.custom_minimum_size = Vector2(96, 48)
+	_go_there_btn.focus_mode = Control.FOCUS_NONE
+	_go_there_btn.visible = false
+	_go_there_btn.pressed.connect(_on_go_there_pressed)
+	btn_row.add_child(_go_there_btn)
+
+	_dismiss_btn = Button.new()
+	_dismiss_btn.name = "DismissBtn"
+	_dismiss_btn.text = Strings.t(&"ui.dismiss")
+	_dismiss_btn.custom_minimum_size = Vector2(96, 48)
+	_dismiss_btn.focus_mode = Control.FOCUS_NONE
+	_dismiss_btn.pressed.connect(_on_dismiss_pressed)
+	btn_row.add_child(_dismiss_btn)
+
+	# Auto-dismiss timer.
+	_timer = Timer.new()
+	_timer.name = "AutoDismiss"
+	_timer.one_shot = true
+	_timer.wait_time = AUTO_DISMISS_SEC
+	_timer.timeout.connect(_on_dismiss_pressed)
+	add_child(_timer)
+
+
+# ── event handling ───────────────────────────────────────────────────────────
+
+func _on_event_fired(event) -> void:
+	# Only handle banner-display events.
+	if event.display != EventDef.Display.BANNER:
+		return
+	_queue.append(event)
+	if _current_event == null:
+		_show_next()
+
+
+func _show_next() -> void:
+	if _queue.is_empty():
+		_root.visible = false
+		_current_event = null
+		return
+
+	_current_event = _queue.pop_front()
+	var ev = _current_event
+
+	_title_label.text = ev.title
+	_body_label.text = _substitute_pawn(ev.body)
+
+	var has_focus: bool = ev.focus_tile != Vector2i(-1, -1)
+	_go_there_btn.visible = has_focus
+
+	_root.visible = true
+	_timer.start()
+	Audit.log("storyteller_ui", "banner shown: %s" % ev.id)
+
+
+func _on_dismiss_pressed() -> void:
+	if not _timer.is_stopped():
+		_timer.stop()
+	Storyteller.resolve_current(0)
+	Audit.log("storyteller_ui", "banner dismissed: %s" % (_current_event.id if _current_event != null else "(none)"))
+	_current_event = null
+	_show_next()
+
+
+func _on_go_there_pressed() -> void:
+	if _current_event == null:
+		return
+	_pan_camera(_current_event.focus_tile)
+	# Also dismiss so the banner clears after the pan.
+	_on_dismiss_pressed()
+
+
+func _on_panel_gui_input(event: InputEvent) -> void:
+	if event is InputEventMouseButton and event.pressed and event.button_index == MOUSE_BUTTON_LEFT:
+		_on_dismiss_pressed()
+	elif event is InputEventScreenTouch and event.pressed:
+		_on_dismiss_pressed()
+
+
+# ── helpers ──────────────────────────────────────────────────────────────────
+
+func _pan_camera(tile: Vector2i) -> void:
+	var cam = get_node_or_null("/root/Main/World/CameraRig")
+	if cam == null:
+		Audit.log("storyteller_ui", "pan_camera: CameraRig not found")
+		return
+	if cam.has_method("pan_to_tile"):
+		cam.pan_to_tile(tile)
+	else:
+		# Fallback: instant snap to tile centre.
+		cam.position = Vector2(tile.x * TILE_SIZE_PX + TILE_SIZE_PX / 2,
+				tile.y * TILE_SIZE_PX + TILE_SIZE_PX / 2)
+
+
+func _substitute_pawn(body: String) -> String:
+	if not "%pawn%" in body:
+		return body
+	var name: String = "Settler"
+	if not World.pawns.is_empty():
+		name = World.pawns[0].pawn_name
+	return body.replace("%pawn%", name)
--- a/scenes/ui/storyteller_banner.gd.uid
+++ b/scenes/ui/storyteller_banner.gd.uid
@ -0,0 +1 @@
+uid://bltjvp7kin4vg
--- a/scenes/ui/storyteller_modal.gd
+++ b/scenes/ui/storyteller_modal.gd
@ -0,0 +1,199 @@
+class_name StorytellerModal extends CanvasLayer
+## Phase 15 — Blocking center-screen dialog for MODAL-display EventDef events.
+##
+## Visible only when a modal event is active; hidden otherwise.
+## Choice layout:
+##   0 choices → single "Dismiss" button   (choice index 0)
+##   1 choice  → labelled button + Dismiss  (choice 0 / 1)
+##   2 choices → both as labelled buttons   (choice 0 / 1)
+##
+## Optional "Go there" button if focus_tile != Vector2i(-1, -1).
+## Tapping "Go there" pans camera AND closes the modal.
+##
+## Subscribes to EventBus.storyteller_event_fired in _ready; ignores BANNER events.
+## Auto-pause is handled by Storyteller before the signal — no re-pause here.
+
+const TILE_SIZE_PX: int = 16
+
+var _current_event = null
+
+# ── node refs ────────────────────────────────────────────────────────────────
+var _dim: ColorRect = null     # full-screen dim behind panel
+var _panel: PanelContainer = null
+var _title_label: Label = null
+var _body_label: Label = null
+var _choice_row: HBoxContainer = null
+var _go_there_btn: Button = null
+
+
+func _ready() -> void:
+	layer = 20  # above banner (15), above top-bar (10)
+
+	_build_ui()
+	_set_visible(false)
+
+	EventBus.storyteller_event_fired.connect(_on_event_fired)
+	# Also hide on external resolve (test scripts, ghost-state auto-fire chain).
+	EventBus.storyteller_event_resolved.connect(_on_event_resolved)
+	Audit.log("storyteller_ui", "StorytellerModal ready")
+
+
+func _exit_tree() -> void:
+	if EventBus.storyteller_event_fired.is_connected(_on_event_fired):
+		EventBus.storyteller_event_fired.disconnect(_on_event_fired)
+	if EventBus.storyteller_event_resolved.is_connected(_on_event_resolved):
+		EventBus.storyteller_event_resolved.disconnect(_on_event_resolved)
+
+
+func _on_event_resolved(_event, _choice_index: int) -> void:
+	_set_visible(false)
+
+
+# ── UI construction ──────────────────────────────────────────────────────────
+
+func _build_ui() -> void:
+	# Full-screen dim layer (semi-transparent black).
+	_dim = ColorRect.new()
+	_dim.name = "Dim"
+	_dim.set_anchors_preset(Control.PRESET_FULL_RECT)
+	_dim.color = Color(0.0, 0.0, 0.0, 0.45)
+	_dim.mouse_filter = Control.MOUSE_FILTER_IGNORE
+	add_child(_dim)
+
+	# Centred dialog panel.
+	_panel = PanelContainer.new()
+	_panel.name = "Dialog"
+	_panel.set_anchors_preset(Control.PRESET_CENTER)
+	_panel.custom_minimum_size = Vector2(400, 200)
+	_panel.offset_left  = -200
+	_panel.offset_right = 200
+	_panel.offset_top   = -100
+	_panel.offset_bottom = 100
+	add_child(_panel)
+
+	var vbox := VBoxContainer.new()
+	vbox.add_theme_constant_override("separation", 12)
+	_panel.add_child(vbox)
+
+	_title_label = Label.new()
+	_title_label.name = "TitleLabel"
+	_title_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
+	_title_label.autowrap_mode = TextServer.AUTOWRAP_WORD_SMART
+	vbox.add_child(_title_label)
+
+	_body_label = Label.new()
+	_body_label.name = "BodyLabel"
+	_body_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
+	_body_label.autowrap_mode = TextServer.AUTOWRAP_WORD_SMART
+	vbox.add_child(_body_label)
+
+	# "Go there" row — always present, shown/hidden per-event.
+	_go_there_btn = Button.new()
+	_go_there_btn.name = "GoThereBtn"
+	_go_there_btn.text = Strings.t(&"ui.go_there")
+	_go_there_btn.custom_minimum_size = Vector2(120, 48)
+	_go_there_btn.focus_mode = Control.FOCUS_NONE
+	_go_there_btn.pressed.connect(_on_go_there_pressed)
+	var go_row := HBoxContainer.new()
+	go_row.alignment = BoxContainer.ALIGNMENT_CENTER
+	go_row.add_child(_go_there_btn)
+	vbox.add_child(go_row)
+
+	# Choice-button row — children rebuilt each event.
+	_choice_row = HBoxContainer.new()
+	_choice_row.name = "ChoiceRow"
+	_choice_row.alignment = BoxContainer.ALIGNMENT_CENTER
+	_choice_row.add_theme_constant_override("separation", 12)
+	vbox.add_child(_choice_row)
+
+
+# ── event handling ───────────────────────────────────────────────────────────
+
+func _on_event_fired(event) -> void:
+	if event.display != EventDef.Display.MODAL:
+		return
+	_current_event = event
+	_populate(event)
+	_set_visible(true)
+	Audit.log("storyteller_ui", "modal shown: %s" % event.id)
+
+
+func _populate(event) -> void:
+	_title_label.text = event.title
+	_body_label.text = _substitute_pawn(event.body)
+
+	var has_focus: bool = event.focus_tile != Vector2i(-1, -1)
+	_go_there_btn.visible = has_focus
+
+	# Clear old choice buttons.
+	for child in _choice_row.get_children():
+		child.queue_free()
+
+	# Build new choice buttons based on choices array length.
+	var choices: Array[String] = event.choices
+	match choices.size():
+		0:
+			# No choices — single Dismiss.
+			_add_choice_btn(Strings.t(&"ui.dismiss"), 0)
+		1:
+			# One named choice + Dismiss (dismiss = index 1).
+			_add_choice_btn(choices[0], 0)
+			_add_choice_btn(Strings.t(&"ui.dismiss"), 1)
+		_:
+			# Two (or more) choices — render first two, indexed.
+			_add_choice_btn(choices[0], 0)
+			_add_choice_btn(choices[1], 1)
+
+
+func _add_choice_btn(label: String, choice_index: int) -> void:
+	var btn := Button.new()
+	btn.text = label
+	btn.custom_minimum_size = Vector2(120, 48)
+	btn.focus_mode = Control.FOCUS_NONE
+	btn.pressed.connect(func() -> void: _on_choice(choice_index))
+	_choice_row.add_child(btn)
+
+
+func _on_choice(choice_index: int) -> void:
+	Audit.log("storyteller_ui", "modal choice %d: %s" % [choice_index, _current_event.id if _current_event != null else "(none)"])
+	Storyteller.resolve_current(choice_index)
+	_current_event = null
+	_set_visible(false)
+
+
+func _on_go_there_pressed() -> void:
+	if _current_event == null:
+		return
+	_pan_camera(_current_event.focus_tile)
+	# Close modal after pan — player is navigating there.
+	_on_choice(0)
+
+
+# ── helpers ──────────────────────────────────────────────────────────────────
+
+func _set_visible(v: bool) -> void:
+	if _dim != null:
+		_dim.visible = v
+	if _panel != null:
+		_panel.visible = v
+
+
+func _pan_camera(tile: Vector2i) -> void:
+	var cam = get_node_or_null("/root/Main/World/CameraRig")
+	if cam == null:
+		Audit.log("storyteller_ui", "pan_camera: CameraRig not found")
+		return
+	if cam.has_method("pan_to_tile"):
+		cam.pan_to_tile(tile)
+	else:
+		cam.position = Vector2(tile.x * TILE_SIZE_PX + TILE_SIZE_PX / 2,
+				tile.y * TILE_SIZE_PX + TILE_SIZE_PX / 2)
+
+
+func _substitute_pawn(body: String) -> String:
+	if not "%pawn%" in body:
+		return body
+	var name: String = "Settler"
+	if not World.pawns.is_empty():
+		name = World.pawns[0].pawn_name
+	return body.replace("%pawn%", name)
--- a/scenes/ui/storyteller_modal.gd.uid
+++ b/scenes/ui/storyteller_modal.gd.uid
@ -0,0 +1 @@
+uid://3yl5uek6owj2
--- a/scenes/world/camera_rig.gd
+++ b/scenes/world/camera_rig.gd
@ -107,6 +107,16 @@ func _centre_on(world_pos: Vector2) -> void:
 	_centre_tween.tween_property(self, "position", world_pos, 0.2)


+## Public API — smooth-pan the camera to the centre of a tile (world space).
+## Used by StorytellerBanner and StorytellerModal "Go there" buttons.
+## Reuses the same _centre_tween slot so a rapid second call replaces the first.
+func pan_to_tile(tile: Vector2i) -> void:
+	const TILE_PX: int = 16
+	var world_pos := Vector2(tile.x * TILE_PX + TILE_PX / 2, tile.y * TILE_PX + TILE_PX / 2)
+	_centre_on(world_pos)
+	Audit.log("camera", "pan_to_tile %s → world %s" % [tile, world_pos])
+
+
 ## Public API — call once from the world scene after map bounds are known.
 func set_world_bounds(rect: Rect2) -> void:
 	limit_left   = int(rect.position.x)    - BOUNDS_BLEED_PX
--- a/scenes/world/world.gd
+++ b/scenes/world/world.gd
@ -24,6 +24,9 @@ const INDOOR_TINT_SCRIPT: Script = preload("res://scenes/world/indoor_tint_overl
 # Phase 14 — grave / burial entities (scripts only; no .tscn needed).
 const GRAVEYARD_ZONE_SCRIPT: Script = preload("res://scenes/world/graveyard_zone.gd")
 const GRAVE_SLOT_SCRIPT: Script = preload("res://scenes/entities/grave_slot.gd")
+# Phase 15 — EventCatalog (class_name in scenes/storyteller/) preloaded so the
+# class is resolved before world._ready() fires. Avoids parse-order ambiguity.
+const EVENT_CATALOG_SCRIPT: Script = preload("res://scenes/storyteller/event_catalog.gd")
 const PAWN_SCENE: PackedScene = preload("res://scenes/pawn/pawn.tscn")
 const TREE_SCENE: PackedScene = preload("res://scenes/entities/tree.tscn")
 const ROCK_SCENE: PackedScene = preload("res://scenes/entities/rock.tscn")
@ -207,6 +210,10 @@ func _ready() -> void:
 	beauty.recompute_all()
 	_run_pathfinder_spike()

+	# Phase 15 — register all 25 Storyteller events now that World state and
+	# autoloads are fully mounted (trigger predicates read Clock, World, Storyteller).
+	EVENT_CATALOG_SCRIPT.register_all(Storyteller)
+
 	# Phase 4: every 5 in-game seconds (100 ticks), re-evaluate items in
 	# stockpiles in case a higher-priority destination opened up.
 	EventBus.sim_tick.connect(_on_sim_tick_world_sweep)