aetherbound-guild/docs/runtime/PHASE9_0R8_FRONT_DOOR_CONTRACT.md

Phase 9.0R8 Front-Door Runtime Contract

State Map

BOOT -> TITLE -> MAIN_MENU
MAIN_MENU -> YARD
MAIN_MENU <-> GAME_INTRO
MAIN_MENU <-> SETTINGS
gameplay Home/confirmed Restart -> MAIN_MENU

BOOT is automatic resource verification. TITLE is the visual identity and one explicit entry action. MAIN_MENU is the navigation authority. These are different states even when they reuse the same background.

Stable Controls

Page	Required controls
Title	EnterGameButton
Main menu	StartNewGameButton, GameIntroButton, SettingsButton
Introduction	IntroductionBackButton
Settings	SettingsLocaleButton, SettingsTextScaleButton, SettingsMotionButton, SettingsMuteButton, SettingsBackButton

The main menu must not render Continue, Load, Account or release/store actions while their systems are absent.

Introduction Copy Authority

The page answers four questions in player language:

1. Who am I? The guild captain rebuilding an expedition Company across broken wind roads.
2. What do I do first? Choose one front and one rear Recruit, then depart.
3. Why is combat automatic? The player builds the Company and reads the threat; recruited roles execute the committed plan.
4. What changes between battles? Diagnose the result, adapt equipment, choose routes and train an individual member so the next encounter changes.

It describes only the currently playable R7 flow. It does not advertise future chapters, saves, a Market or a complete profession catalog as present.

Settings Semantics

Settings are session-local presentation values and never mutate gameplay:

• language: 简体中文 / English;
• text: 100% / 130%;
• motion: 标准 / 减少动态;
• sound: 开启 / 静音.

Each row names the category, current value and effect. Tapping cycles the two declared values and immediately rerenders the current Settings page. Back keeps the selected presentation values and returns to Main Menu.

New Game And Home

• start_new_game is legal only from Main Menu.
• It calls the existing complete transient cleanup exactly once, then opens the Guild Yard with the preserved first-choice guidance.
• go_home and confirmed Restart clear the same transient state and return to Main Menu.
• Title entry, Introduction, Settings and Back never clear or create gameplay state.

Presentation

• Title remains an immersive world scene with identity and one command.
• Main Menu uses the world as the dominant surface and one quiet command rail; it is not a settings form or nested card dashboard.
• Introduction uses an expedition path composition with four numbered beats.
• Settings uses one parchment workbench with four full-width named rows.
• Primary landscape is 844x390; no scrolling; all actions at least 44px.
• Portrait continues to request landscape orientation.

Evidence

• Domain/navigation test proves legal page transitions, no fake Continue, gameplay mutation boundaries and Home/Restart cleanup.
• Real parsed ScreenTouch covers Title -> Main Menu -> Introduction -> Back -> Settings -> all four changes -> Back -> New Game.
• Normal rendering covers Boot success, Title, Main Menu, Introduction and Settings in Chinese plus English/130% Settings.
• P9.0R7 focused, touch and R3-R6 regressions remain green.