[dayfine]

Depends on #192 (base frlg/autostory-gift-rng; the diff shows only this change).

Adds two story capabilities the table can name as GAME steps: a bounded capture of a named species, and a PC deposit or withdrawal at a Pokemon Center.

• capture_step() (capture rattata catches=1 encounters=20 balls=5 pace=east [move=1 turns=2]): steps back and forth in the patch, runs from other or unread species, weakens only from green HP with the named move, throws balls until caught, and stops at its encounter or ball cap or an empty bag. A catch goes to the party, or to the PC when the party is full.
• A shiny of any species stops the program where it is (no RUN, no ball, no reload) so a person decides; other failures reload the checkpoint as usual.
• pc_step() (pc deposit slot=2 box=1, pc withdraw box=1 slot=7) follows pokefirered's storage system: refuses to deposit the last Pokemon or the last one that can fight and to withdraw into a full party, and never moves the cursor on the STORE/WITHDRAW menu, which holds RELEASE.
• The decisions run on injected steps (CaptureActions, PcStorageActions); the console side reuses handle_encounter(), flee_battle(), WildEncounterReader, the bag reader and the box detectors. No table rows yet; the first uses (Route 4 Rattata, Magikarp deposit) come with their checkpoints.
• Needs a capture for the wild Pokemon's HP bar (follow-up); until then nothing is weakened on the console.
• PC screens (2026-11-02): PcScreenReader reads every PC screen from console B's captures of two deposits: the PC list, the storage menu and a Pokemon's menu with their cursor rows, the party panel's slot under the hand, the box chooser's box, "Continue BOX operations?", messages and the overworld. The step waits for each screen before its press, since a press sent before a menu is drawn went to the message behind it; an overworld frame is confirmed on a second one and waited out while the PC boots. Image tests in PokemonFRLG/PcScreenReader/ (PokemonFRLG: ItemListReader, PlayerFacingReader, OptionMenuReader and SaveCardReader test images CommandLineTests#2, a FileException in CI). PcPartyMember is renamed from PartyMember, which clashed with FRLG: AutoStory, FireRed from a new game to the Boulder Badge #120's.

Testing

• New suites PokemonFRLG::AutoStoryCapture (decisions per encounter, variants, messages, capture and PC steps in the shared segment runner: reloads vs. the shiny stop) and PokemonFRLG::AutoStoryPcStorage (deposits, withdrawals and refusals on a fake PC that follows pokefirered, other screens, variants). The deposit path matches the inputs that worked by hand on console B.
• Syntax-checked locally with the Windows-Clang warning set and code health is clean; tests run in fork CI (not locally: the lab app is open). Not run on the console.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AKYzhrMnPK61XHWEch4a6E

[dayfine]

Superseded by #215 (FRLG stack consolidated into stage PRs; will be resplit for upstream).