From cbddf0431938e022f51eaa6b7db871d402851b59 Mon Sep 17 00:00:00 2001 From: wusumac <736139669@qq.com> Date: Thu, 13 Aug 2026 01:51:03 +0800 Subject: [PATCH] docs: open P9.0R5 first session arc --- AGENTS.md | 14 +-- CURRENT_CHECKPOINT.md | 20 +++- .../PHASE9_0R5_FIRST_SESSION_ARC_GOAL.md | 107 ++++++++++++++++++ .../PHASE9_GODOT_VERTICAL_SLICE_LEDGER.md | 1 + .../PHASE9_0R5_FIRST_SESSION_ARC_CONTRACT.md | 80 +++++++++++++ 5 files changed, 212 insertions(+), 10 deletions(-) create mode 100644 docs/goals/PHASE9_0R5_FIRST_SESSION_ARC_GOAL.md create mode 100644 docs/runtime/PHASE9_0R5_FIRST_SESSION_ARC_CONTRACT.md diff --git a/AGENTS.md b/AGENTS.md index c311a760..9d0299be 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,16 +10,16 @@ Runtime source belongs under `runtime/`; accepted HTML design authority remains under `prototype/` and may not be silently rewritten to fit implementation. P9.0R3 is the Owner-accepted baseline for tutorial-battle pacing and event-bound combat feedback inside the preserved Title -> Guild Yard -> -tutorial battle -> victory flow. Its source is frozen. P9.0R4 is the only -active runtime slice: diagnose that first victory, apply the existing 20-Coin -Steady payout, choose one of two run-local loaned adaptations, and see the -consequence in one second short battle. It uses a fast H5 preview before full -candidate evidence so Owner direction can be reviewed without waiting for a -complete matrix on every iteration. +tutorial battle -> victory flow. Its source is frozen. P9.0R4 remains the +preserved two-battle preview baseline. P9.0R5 is the only active runtime slice: +begin at the real Title, preserve both existing battles, return to the Guild, +choose between retaining the learned equipment or recruiting the missing rear, +then see the choice in one third encounter and session result. It continues the +fast-H5-before-formal-candidate cadence. It shortens dead holds between accepted authored animation states and adds bounded damage/heal number pops, impact nudge and existing VFX timing without changing HP results, roles, victory, animation assets or the opening flow. -Contract, difficulty, Market, permanent equipment inventory, Party order, +Contract, difficulty, formal Market/permanent equipment inventory, Party order, authoritative combat, persistence, chapters, device packaging, stores and release remain frozen. diff --git a/CURRENT_CHECKPOINT.md b/CURRENT_CHECKPOINT.md index 55cef019..082877c2 100644 --- a/CURRENT_CHECKPOINT.md +++ b/CURRENT_CHECKPOINT.md @@ -1,8 +1,9 @@ # Current Checkpoint -Active Goal: `docs/goals/PHASE9_0R4_SECOND_CYCLE_ADAPTATION_GOAL.md` -Active contract: `docs/runtime/PHASE9_0R4_SECOND_CYCLE_ADAPTATION_CONTRACT.md` +Active Goal: `docs/goals/PHASE9_0R5_FIRST_SESSION_ARC_GOAL.md` +Active contract: `docs/runtime/PHASE9_0R5_FIRST_SESSION_ARC_CONTRACT.md` Active ledger: `docs/reviews/PHASE9_GODOT_VERTICAL_SLICE_LEDGER.md` +P9.0R5 baseline: `6ae33971451912b3cc87c8ffe3b8831fa67c967c` P9.0R4 baseline: `232e3a0a45ec2437ddd528502d487d5264f1c6ae` P9.0R4 product preview source: `e895c42e83950acf141470629f4a8c4a3fde67e2` P9.0R4 test-metadata closure: `365af5429ba6b4c3e2179c7a8ae6c70de7aeb774` @@ -10,7 +11,20 @@ Animation repair baseline: `db75a17ce8b0a3bc702ad535fa16491debf582e4` Fixed product source: `425fae82d3d88a002bdaadeabb498d8bf0d069cd` Battle-feedback behavior commit: `3b26b3d671ae7d043ab4bfcbd8b31e77df6d6d0d` Battle-feedback baseline: `be17debf4ed3ebe5c3e6de2701d5e3c374de1dcb` -Stage: `P9_0R4_FAST_H5_PREVIEW_READY` +Stage: `P9_0R5_FIRST_SESSION_ARC_ACTIVE` + +P9.0R5 preserves the complete real Title-to-second-result P9.0R4 path and owns +one Guild return decision plus a third battle. From `20 Coin`, the player either +retains the learned item for `12` and keeps Company `2`, or recruits the missing +rear for `14`, returns the loan and reaches Company `3`. The third encounter +must visibly use the retained item or added rear and end with exact causal +Coin/Company/HP/time facts. Formal Market, inventory, save, chapters, +authoritative combat, packaging and release remain frozen. + +The only next action is implementation followed by the bounded fast gate and a +fresh H5 beginning at Title. Full candidate evidence waits for Owner review. + +## P9.0R4 Fast-Preview Baseline P9.0R4 owns only the first-result diagnosis, the existing `B0/R1/Q0` Steady `+20 Coin` payout, one unselected choice between run-local loaned `EQ-002` and diff --git a/docs/goals/PHASE9_0R5_FIRST_SESSION_ARC_GOAL.md b/docs/goals/PHASE9_0R5_FIRST_SESSION_ARC_GOAL.md new file mode 100644 index 00000000..51af6460 --- /dev/null +++ b/docs/goals/PHASE9_0R5_FIRST_SESSION_ARC_GOAL.md @@ -0,0 +1,107 @@ +# Phase 9.0R5 First-Session Arc Goal + +## Owner Decision And Role + +On 2026-08-13 the Owner asked for a larger playable delivery beginning at the +real game entry instead of another isolated continuation page. + +- Role: development task. +- Repository: `aetherbound_guild` only. +- Baseline: clean/upstream P9.0R4 preview closure + `6ae33971451912b3cc87c8ffe3b8831fa67c967c`. +- Preserved P9.0R4 product source: + `e895c42e83950acf141470629f4a8c4a3fde67e2`. +- Active contract: `docs/runtime/PHASE9_0R5_FIRST_SESSION_ARC_CONTRACT.md`. +- Active ledger: `docs/reviews/PHASE9_GODOT_VERTICAL_SLICE_LEDGER.md`. + +## Player Hypothesis + +A fresh player can start from Title, form a squad, understand the first result, +make a tactical adaptation, then make a different resource/roster decision and +finish a third battle without coaching. + +The complete preview loop is: + +`Title -> Yard -> battle 1 -> diagnosis/+20 Coin -> loan choice -> battle 2 -> Guild return -> keep equipment or recruit -> battle 3 -> session result` + +## Owned Slice + +1. Preserve the full P9.0R4 path from the real Title without fixture shortcuts. +2. Replace the P9.0R4 terminal with one visible return to the Guild Yard. +3. Present current Coin, the two-person squad, the learned threat and exactly two + stable, unselected responses: + - pay `12 Coin` to retain the selected `EQ-002` or `EQ-061` for the next + encounter, leaving `8 Coin` and Company `2`; + - pay `14 Coin` to recruit the missing rear Profession, return the loaned + item, leave `6 Coin` and Company `3`. +4. The missing rear is deterministic: Farstring recruits Kindhand; Kindhand + recruits Farstring. It is a run-local tutorial Recruit using the accepted + Profession identity and art, not a new named protagonist or Market offer. +5. Run one third automatic encounter in which the retained item or added rear + visibly acts, changes HP/event order/time, and produces a causal session + result. +6. Keep Home and confirmed Restart available. Restart clears all three battles, + Coin, loan, Guild choice and added Recruit. + +## Fixed Third Encounter + +The third encounter is a bounded `130 HP` Riftblade captain presentation using +existing assets. It is not a new catalog identity or authoritative combat. + +| Guild choice | Company | Coin | First pressure | Distinct contribution | +|---|---:|---:|---|---| +| retain `EQ-002` | 2 | 8 | front `100 -> 90` | item resists push; safer but slower | +| retain `EQ-061` | 2 | 8 | front acts `130 -> 102`, then front `100 -> 70` | item keeps initiative; faster but riskier | +| recruit missing rear | 3 | 6 | front `100 -> 70` | Farstring deals one rear hit and Kindhand heals `+12` | + +All paths defeat the captain. Final front HP is state-dependent: retained +`EQ-002` yields `90` with Farstring or `100` with Kindhand; retained `EQ-061` +yields `70` with Farstring or `82` with Kindhand; the three-person route yields +`82`. Declared encounter time is `7.60`, `6.60`, or `7.00` seconds. + +## Preview-First Cadence + +The Owner receives another fast H5 direction preview before formal candidate +work. The preview gate runs: + +- focused three-cycle state/transaction tests; +- one complete real parsed-ScreenTouch route beginning at Title; +- preserved P9.0R4/P9.0R3 regressions; +- normal-render `844x390` states for Guild unselected/selected, third-battle + pressure, three-person action and final result; +- strict diagnostics and remote Title launch. + +Full matrices, both locales/text scales, all branch recordings, immutable +inventory and final candidate publication remain postponed until Owner accepts +the expanded session direction. + +## Frozen + +- P9.0R3/P9.0R4 first two battles, values, roles and accepted presentation. +- Existing character, enemy, background, VFX and animation source assets. +- Formal Market boards, generated offers, permanent equipment inventory, Party + order, risk selection, casualty/recovery and save/persistence. +- Chapter/content expansion, authoritative combat, paid generation, audio + expansion, device packaging, TestFlight, stores and release. + +## Acceptance + +- A fresh Title start reaches the final session result using only visible game + actions and no fixture-only jump. +- The Guild choice has no preselection, can be revised before departure and + deducts Coin exactly once at commit. +- Retain and recruit routes leave exact Coin `8/6`, Company `2/3`, and mutually + exclusive retained-item/added-Recruit state. +- The added rear actor is visible in the line, changes body poses and produces + one exact committed heal or ranged hit. +- The final result explains the player's Guild decision before showing Coin, + Company, HP and time, and offers replay/home without opening frozen systems. +- The H5 is explicitly a fast direction preview, not a formal candidate. + +## Legal Terminals + +`Aetherbound Guild P9.0R5 full first-session H5 preview ready` + +or + +`Aetherbound Guild P9.0R5 redesign required: ` diff --git a/docs/reviews/PHASE9_GODOT_VERTICAL_SLICE_LEDGER.md b/docs/reviews/PHASE9_GODOT_VERTICAL_SLICE_LEDGER.md index 3c5102a5..b7e19a22 100644 --- a/docs/reviews/PHASE9_GODOT_VERTICAL_SLICE_LEDGER.md +++ b/docs/reviews/PHASE9_GODOT_VERTICAL_SLICE_LEDGER.md @@ -26,3 +26,4 @@ separate. | 2026-08-13 | Owner play review of Gallery `_N8bdzMkdn1c` | `P9_0R3_OWNER_ACCEPTED` | Owner reports that this version is acceptable and authorizes continued development. The accepted P9.0R3 battle cadence, character motion and event-bound damage/heal feedback become the frozen `human_reviewed` direction. Listening, broader fun/continuation, physical device, packaging, store and release remain open. The next slice must start from the first victory and prove one readable adaptation before a strategically different second battle; it may not reopen accepted battle values or presentation. | | 2026-08-13 | P9.0R4 task opened from clean/upstream `232e3a0` | `P9_0R4_SECOND_CYCLE_ADAPTATION_ACTIVE` | Owner authorizes continued development and requests faster playable review. The bounded slice is first-result diagnosis, existing Steady `B0/R1/Q0` `+20 Coin`, unselected loan choice `EQ-002` safety versus `EQ-061` tempo, one changed second battle and exact consequence. A fast H5 preview follows focused plus one-route runtime validation; complete immutable candidate evidence waits for Owner direction acceptance. P9.0R3 and all frozen Market/persistence/content/release scope remain unchanged. | | 2026-08-13 | product `e895c42`; test metadata `365af54`; Gallery `qpgmCKQMz1TS` | `P9_0R4_FAST_H5_PREVIEW_READY` | Clean/upstream source passes focused second-cycle `Coin=20 once=true choices=2 unselected=true revision=true lock=true safe_hp=90,100 fast_hp=70,82 safe_time=7.05 fast_time=6.00 feedback=4,5 cleanup=true`, parsed ScreenTouch `touch=4 fallback=0 direct=0`, P9.0R1 domain and P9.0R3 feedback regressions. Five `844x390` zh_CN normal-render states pass 44px control bounds and strict product/runtime diagnostics zero. The nine-file 53 MB Web bundle launches remotely to the real Title with browser warnings/errors zero. Cold load is roughly one minute because `37.7 MB` WASM plus `17.1 MB` PCK are served without compression and with 300-second private cache; delivery optimization remains open. This is preview evidence only. Full matrices, both route recordings, immutable inventory and formal candidate status wait for Owner direction acceptance. | +| 2026-08-13 | P9.0R5 opened from clean/upstream `6ae3397` | `P9_0R5_FIRST_SESSION_ARC_ACTIVE` | Owner asks for a larger delivery beginning at the real game entry. P9.0R5 preserves P9.0R4 through battle two, then owns one Guild return choice: spend 12 Coin to retain the learned item and Company 2, or spend 14 Coin to recruit the missing rear, return the loan and reach Company 3. A third captain encounter and exact session result must expose the consequence. Formal Market/inventory/save/content/release remain frozen; another fast H5 precedes formal candidate work. | diff --git a/docs/runtime/PHASE9_0R5_FIRST_SESSION_ARC_CONTRACT.md b/docs/runtime/PHASE9_0R5_FIRST_SESSION_ARC_CONTRACT.md new file mode 100644 index 00000000..3ac62bb8 --- /dev/null +++ b/docs/runtime/PHASE9_0R5_FIRST_SESSION_ARC_CONTRACT.md @@ -0,0 +1,80 @@ +# Phase 9.0R5 First-Session Arc Runtime Contract + +## State Machine + +```text +Title -> Yard -> first_battle -> first_result -> adaptation + -> second_battle -> second_result -> guild_return_unselected + -> guild_return_selected -> third_battle -> session_result +``` + +Title is the only fresh entry. Tests may create fixed states for layout/capture, +but the owner-facing H5 always starts at Boot/Title and can reach every state by +visible controls. + +## Guild Choice Transaction + +The second result enters Guild return with `20 Coin`, Company `2`, the selected +loan recorded and no Guild choice selected. + +| Choice | Commit | Result | +|---|---|---| +| `retain_item` | subtract `12 Coin`; retain P9.0R4 item | Coin `8`, Company `2`, no added rear | +| `recruit_rear` | subtract `14 Coin`; return loan; add missing rear | Coin `6`, Company `3`, no active item | + +Selection does not spend. Switching selection does not spend. `Begin third +expedition` is the only commit, is enabled only with one legal choice, and is +inert after the first successful commit. + +## Third Battle Events + +### Retained equipment + +1. two-person line enters against captain (`130 HP`); +2. `EQ-061` optionally commits an early front hit `130 -> 102`; otherwise the + captain telegraphs; +3. captain hit commits front to `90` with `EQ-002`, otherwise `70`; +4. selected original rear commits Farstring damage or Kindhand healing; +5. retained-item/front follow-up commits captain toward the finish; +6. coordinated hit commits captain to `26`; +7. finisher commits captain to `0`. + +### Added rear + +1. three-person line enters against captain (`130 HP`), with no active item; +2. captain telegraphs; +3. full strike commits front `100 -> 70`; +4. original rear acts; +5. added rear acts, ensuring the line has exactly one Farstring hit and one + Kindhand heal; front becomes `82` and captain becomes `94`; +6. three-person coordination commits captain `94 -> 32`; +7. finisher commits captain `32 -> 0`. + +Every HP mutation creates exactly one existing P9.0R3 number payload. The added +rear uses the existing accepted idle/advance/action frames. No actor respawns, +relationship state, level, XP, save or Market identity is created. + +## Presentation + +- Guild return is a yard scene: current actors and Coin remain in the world; + the two decisions sit on one physical preparation bench, not a receipt table. +- Each decision names exact cost, resulting Company size, retained/lost state, + benefit and tradeoff. Neither is recommended or preselected. +- A recruited third actor occupies the protected rear-left footprint while the + original rear shifts toward center; retained-item route keeps the two-person + geometry. +- Session result leads with the causal choice: retained counter or broader + Company. Exact Coin, Company, front HP and battle time follow. +- Primary preview viewport is `844x390`; no normal action requires scrolling. + +## Fast Evidence + +- Focused test covers selection/revision, once-only spend, insufficient/invalid + rejection, mutual exclusion, all initial rear/item combinations, exact HP/ + Coin/Company/time and cleanup. +- Parsed ScreenTouch begins on real Title and reaches session result through the + complete primary route with fallback/direct `0`. +- Normal-render captures cover Guild unselected/selected, retained-item battle, + three-person battle/action and both result meanings. +- Strict scan includes script, parse/resource/import, assertion, ObjectDB and + cleanup markers. Preview evidence cannot become formal candidate evidence.