[dayfine]

Depends on #114 (and through it #43–#45).

FRLG's story was a declarative table and BDSP's a list of wrapped functions, with no shared way to say "walk here, talk, answer YES, fight". This adds one step vocabulary (Pokemon_StorySteps.h), with a builder from table rows to engine events and an executor interface each game implements, and one StoryRunOptions group both programs embed: start and end checkpoint dropdowns (#43's select database, joined at #44's story_index()), attempts per checkpoint, stop at the first failure, a Thorough/Fast checks level and the game's language. SegmentPolicy is the one place retries are set, and record_story_stats() adds a run to #45's AutoStoryStats. Tested with the StorySteps suite against a fake executor (event order, skip conditions, poses, failures, the retry policy, the options and the stats) and the existing StorySegments suite in fork CI; no console runs of its own.

Design note

• Shared types. StoryStep{kind, name, why, target (Pose), direction, legs, fight_wild, yes, may_lose, battles, items, variant, skip_if, pose_after} and StoryCheckpoint{id, title, start (Pose), steps}. build_story_checkpoint() emits a from_save event for the start pose, then one event per step; saving stays the game's (FRLG saves at the end, BDSP at the start).
• Executor. StoryStepExecutor has one virtual per kind, each failing as unsupported_step unless overridden, so a table using a kind the game lacks fails by name. Chosen over a table of std::function because a fake overrides only what a test needs, and the kinds stay one list. run() wraps every step (FRLG turns console exceptions into failed Outcomes; BDSP goes through its runner for screenshots and the lab log line). begin_attempt() is called once per attempt. holds() answers skip_if, by default from run flags that earlier steps set.
• Game extras. Per-checkpoint data rides in the game's row type, derived from StoryCheckpoint (FRLG: supplies and START menu; BDSP: what a failure does). Per-step extras go in variant: BDSP route plan costs (town, robust), D-pad legs that may end a tile short, and segment-registered variants for the Mart lady, the signs' gap and the Jubilife stairs. Trainer sight lives in BDSP's executor (its route kind fights who sees us; trainers reset per attempt). Door line-up is inside BDSP's HEAL (lit doorway by sight).
• Poses. Game-defined through the existing Pose/TilePose: FRLG one-tile poses with facing; BDSP sets of world tiles. Executors return where a step left the player; pose_after covers scenes.
• FRLG. Every kind maps 1:1 (NEW_GAME, OPTIONS was SET_OPTIONS, ROUTE, LEGS, STEP, TALK, ANSWER, MASH, BATTLE, HEAL, SHOP with its items now in the table, READY).
• BDSP 00.04 after the catch. Train → ROUTE to the catch grass + TRAIN 3. Center → ROUTE into Sandgem (robust) + ROUTE to the sign (town) + LEGS west taps (one short ok) + HEAL. Mart lady → SHOP variant (lady, clerk after two misses), ending on Route 202's save spot. Save → the row's start save. Route 202 north → ROUTE to the exit rows with trainer sight. Jubilife scene → STEP variant (the stairs) + MASH.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AKYzhrMnPK61XHWEch4a6E