wushenghua/aetherbound-guild
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
41374ee0560d7ffd2b42784f219224ded060a708
aetherbound-guild/docs/plans/M47_UNIFIED_UI_MVP.md
T

6.9 KiB
Raw Blame History

M47 Unified UI MVP

Status

  • Plan: M47_UNIFIED_UI_MVP
  • Status: COMPLETE
  • Activated: 2026-09-05
  • Baseline: 4d342c4 (M46_MVP_UI_CONSISTENCY_PASS closure)
  • Owner request: produce a directly playable MVP proving that Market, Readiness and Battle Result belong to one authored game.

Objective

Create a small, playable presentation MVP that repairs the information architecture and page grammar of the three highest-signal screens. Keep the existing gameplay, controllers, services, Save/Receipt behavior, routing, static masters and accepted Japanese 2D hand-drawn art unchanged.

Player-visible stopping point

  • The player can complete the existing first-cycle route while Market, Readiness and Battle Result share one recognizable shell, type scale, spacing rhythm, surface treatment and command hierarchy.
  • Each target page exposes one primary action, two or three primary facts, and secondary detail only when it helps a decision.
  • Debug hashes, internal IDs and implementation-oriented copy are hidden from normal presentation.
  • Body text remains readable at 760x360, 844x390 and 1280x720 in both supported locales; primary commands retain at least 48 logical pixels.
  • The MVP is runnable locally from the existing Godot project and can be handed to the Owner for an uncoached first-cycle tryout.

UI system contract

Tokens

All target pages use ABGUI_Tokens for type roles (title, heading, body, label, micro), spacing, command heights, semantic colors, surface radii and notice severities. Page code may choose geometry but may not invent a competing token vocabulary.

Page shell

Each target page follows this shared grammar:

  1. full-bleed hand-drawn world/master;
  2. compact top rail for page identity and one resource/state fact;
  3. one focal work surface;
  4. one attached context/notice surface;
  5. one bottom command rail with primary, secondary and utility semantics.

The shell is a grammar, not a forced identical layout. Market remains a desk, Readiness remains a formation review, and Result remains a post-battle outcome surface.

Component entry points

Target pages must use ABGUIFactory/ABGPageView helpers for labels, commands, icons, notices and flat surfaces. Direct Button.new(), ad-hoc StyleBoxFlat.new() and raw page color literals are forbidden in new or rewritten target-page code. Existing static masters and authored portraits are reused.

Information budget

  • Market: selected offer, profession/trait/price, coin and one next action.
  • Readiness: committed line, pressure/risk, one warning summary and one next action.
  • Result: outcome, reward delta, knockout/recovery fact, causal summary and one continuation action.

Ordered steps

M47-A — Contract and baseline (COMPLETE)

  • Freeze this contract and the source-bound baseline captures.
  • Record the issue register and exact acceptance checks.
  • Update CURRENT_CHECKPOINT.md and the development ledger.
  • No runtime product code changes in this step.

Acceptance: exactly one active plan/step; baseline is 4d342c4; no tracked runtime changes; existing M46 evidence remains intact.

Closure: M47-A closes at source 1d3a526. The unified-shell contract, information budget, frozen scope and three-page stopping point are recorded; no runtime product code changed in activation.

M47-B — Shared MVP shell (COMPLETE)

  • Add presentation-only shell/surface helpers and target-page layout helpers.
  • Extend token roles only where the three pages require them.
  • Add focused foundation tests for shell geometry, type minimums, command variants and hidden-debug-field policy.

Closure: M47-B closes at source 57fbd67. ABGPageView now mounts the shared MVP shell over each target page, ABGUI_Tokens owns the shell surfaces, and ABG_M47_UNIFIED_UI_MVP_OK passes with shell, surface, typography and input assertions.

M47-C — Three-page migration (COMPLETE)

  • Recompose Market, Readiness and Battle Result around the shared shell while preserving stable node names, intents, focus order and controller snapshots.
  • Remove normal-view Board hash/internal diagnostics and reduce competing status blocks.
  • Keep all domain/application/controller code and static art masters unchanged.

Closure: M47-C closes at source f911095. Market, Readiness and Battle Result now mount the shared shell, present player-facing status copy instead of internal hashes/IDs, use a readable small-screen text floor, and preserve all existing node names, intents and controller snapshots. Focused Market, Readiness and Result View contracts pass.

M47-D — Playable verification and handoff (COMPLETE)

  • Run focused View tests plus the existing first-cycle candidate/audit through tools/run_test_attempt.py with strict diagnostics, exact markers, parsed touch/restart and owned cleanup.
  • Capture 760x360, 844x390, 1280x720 in zh_CN and en; inspect for clipping, overlap, hierarchy, minimum text and primary-action clarity.
  • Record the visual audit and provide the local run/tryout command.

Closure: M47-D closes at source 1a08127. The source-bound full first-cycle audit passes with marker ABG_MVP_FIRST_CYCLE_AUDIT_OK, 34 focused checks, 128 normal 100% captures across 760x360, 844x390 and 1280x720 in zh_CN/en, strict diagnostics 0, parsed touch/restart and owned cleanup. Evidence archive: /private/tmp/aetherbound-guild-test-evidence/m47-mvp-audit-long/20260905T170957Z-89658 (SHA-256 693e90ede44d35621d518a979a88c5af24334f677ba50aed68584f8755daf7fb).

Acceptance checks

  • New marker: ABG_M47_UNIFIED_UI_MVP_OK exactly once.
  • Existing first-cycle markers and Save/Receipt regressions remain green.
  • Strict Godot diagnostics remain 0; no unowned evidence/cache roots remain.
  • No changes to gameplay, economy, content identities, routing, Save schema, localization semantics or static-master assets.
  • Target pages contain no direct Button.new() or raw command StyleBoxFlat construction after migration; shared factories provide command state/icon styling.
  • Normal captures show one shared visual grammar without flattening the page-specific art compositions.

Frozen scope

  • No new professions, regions, bosses, contracts or economy systems.
  • No battle-rule, controller, Save, audio, packaging, device or release work.
  • No pixel-art conversion, post-process pixelation or static-master repaint.
  • No mass rewrite of entry_shell.gd or Router extraction.
  • Do not delete or stage .uid, .import or prototype_incremental/.

Commit boundaries

  • M47-A: plan/checkpoint/ledger activation.
  • M47-B: shared MVP shell and focused foundation test.
  • M47-C: Market, Readiness and Battle Result migration.
  • M47-D: verification, visual audit and handoff.

Each boundary must be committed and pushed before the next step becomes IN_PROGRESS. A failed check keeps the same step active.

Final handoff

ABG M47 UNIFIED UI MVP READY FOR OWNER TRYOUT

Reference in New Issue View Git Blame Copy Permalink