Files
aetherbound-guild/docs/runtime/fg4/IMPLEMENTATION_PLAN.md
T

6.0 KiB

FG-4 Midgame RG-03 And RG-04 Implementation Plan

Status: ACTIVE Active step: FG4-STEP-1 Activation baseline: fe90d6fac57e19df68e27fd4286575aac2c52d64 Goal: docs/goals/FG4_MIDGAME_RG03_RG04_GOAL.md Contract: docs/runtime/FG4_MIDGAME_RG03_RG04_CONTRACT.md

Player-Visible Stopping Point

Starting from exact RG-02 close, the same Company completes Emberloom Works and Quillroot Archive, writes four new Records, unlocks RG-05 and reaches a cached H5 checkpoint without resetting carried consequences.

Ordered Steps

Step Status Player outcome Commit boundary
FG4-STEP-0 Acceptance and activation COMPLETE FG-3 is accepted and the exact two-Region midpoint boundary is frozen. PMO acceptance, Goal, contract, plan, roadmap, checkpoint and ledger.
FG4-STEP-1 RG-03 Contract-1 content IN_PROGRESS Twelve Emberloom Markets disclose valve, construct, burst and cooldown pressure before commitment. Shared FG-4 graph, 36 routes, 12 boards and focused tests.
FG4-STEP-2 Save v11 and RG-03 Contract 1 PENDING The carried Company clears twelve Rounds and Furnace That Walks or recovers from loss. Save migration, shared state/transactions, battle/Boss tests.
FG4-STEP-3 RG-03 Contract 2 and close PENDING Foreman Nine-Sparks falls, two Records persist and RG-04 opens. Second 36 routes/12 boards, execution, exact close and regressions.
FG4-STEP-4 RG-03 production runtime PENDING Emberloom looks, moves and sounds distinct while retaining the canonical game layout. Media/audio bindings, runtime fixtures, parsed input and recording.
FG4-STEP-5 RG-03 profiles PENDING Five policies prove heat/construct decisions, recovery and Save v11 through RG-04 entry. Simulation, persistence and immutable Region checkpoint.
FG4-STEP-6 RG-04 complete content PENDING Twenty-four Quillroot Markets disclose copy, redirect, cleanse and clause decisions. 40 equipment, 8 Artifacts, 24 enemies/Bosses, 72 routes and 24 boards.
FG4-STEP-7 RG-04 Contract 1 PENDING The Company manipulates The Walking Index and writes the first Archive Record. Shared execution extensions, recovery, close and Save-v11 tests.
FG4-STEP-8 RG-04 Contract 2 and close PENDING Redaction Hart falls, the fourth midpoint Record persists and RG-05 opens. Final execution, atomic Region close and regressions.
FG4-STEP-9 RG-04 production runtime PENDING Quillroot has readable clause/copy presentation and distinct media/audio. Media/audio bindings, layouts, touch and continuous runtime.
FG4-STEP-10 Midpoint candidate and H5 PENDING Two Regions pass five profiles, persistence and runtime, then open in one cached review H5. Immutable candidate, runtime-only Web, Gallery handoff and closure.

FG4-STEP-1 Contract

ID: FG4-STEP-1
PLAYER OUTCOME: RG-03 Contract 1 offers twelve readable Market decisions whose
  valve position, countdown, enemy composition, response tags and recovery cost
  are known before the player commits.
IN SCOPE: shared FG-4 catalog/schema; EQ-081..120; AR-016..022;
  EN-R3-01..12; BO-R3-01/02 descriptors; CTR-R3-01; 36 route rows;
  twelve deterministic 3/4/3 Markets; bilingual copy; focused content and
  generator tests.
OUT OF SCOPE: Save v11, state mutation, battle/Boss execution, Contract 2
  routes, presentation, generated media, audio, simulation, H5 and native
  delivery.
OWNED FILES: runtime/fg4/catalog.json, content_registry.gd,
  market_generator.gd, focused runtime/tests/fg4 files and tracked UIDs;
  durable Step-1 closure after pushed source.
ACCEPTANCE CHECKS: exact IDs/counts and source references; all twelve enemies
  appear in at least two authored compositions; every Market has three risk
  routes and at least two rational response tags; pressure valve position and
  countdown are deterministic; same input is byte-identical; changed seed
  changes only owned Recruit/equipment identities; refresh never rerolls route,
  valve, Boss or reward facts; no product state mutation occurs.
EVIDENCE LEVEL EXPECTED: implemented plus automated_verified content authority.
COMMIT BOUNDARY: focused content/generator/test source push, immutable focused
  evidence, durable closure.
LEGAL TERMINAL: FG-4 Step 1 RG-03 content authority complete.
NEXT STEP: FG4-STEP-2.

Later Step Boundaries

  • Step 2 alone owns Save v11, RG-03 state mutation, Contract-1 battle, Furnace That Walks, recovery and first Contract close.
  • Step 3 alone adds RG-03 Contract-2 routes, Foreman Nine-Sparks and RG-04 unlock; it reuses the shared state, generator and battle schema.
  • Step 4 may generate and bind only RG-03 presentation media/audio inside the current task's paid ceiling.
  • Step 5 adds no content; it owns profiles, persistence and the RG-03 checkpoint candidate.
  • Step 6 adds complete RG-04 content through the existing shared graph without executing battle.
  • Steps 7 and 8 execute the two RG-04 Contracts without duplicating services.
  • Step 9 owns only RG-04 presentation and the remaining paid-call allowance.
  • Step 10 adds no gameplay/content. It owns combined evidence and checkpoint-2 H5 transport only; native delivery remains frozen.

Issue Register

ID Status Boundary
FG4-I01 RESOLVED_ACTIVATION Integrated two-Contract-per-Region authority outranks the older alternate-boss revisit wording.
FG4-I02 OPEN_STEP_1 Existing catalog prose must become one validated data graph without copying Markdown strings into battle formulas.
FG4-I03 FROZEN_MEDIA Paid generation starts only in Steps 4/9 and stays inside four calls/USD 5 for this request.
FG4-I04 OPEN_HUMAN Checkpoint-2 comprehension, strategy depth, fun, visual and listening judgments remain Owner gates.
FG4-I05 FROZEN_DELIVERY Native packages, devices, signing, stores and release require separate authorization.