wushenghua/aetherbound-guild
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
45669e4e5e880ddb96351c09698db239eea6ee52
aetherbound-guild/docs/runtime/fg4/IMPLEMENTATION_PLAN.md
T
wushenghua 45669e4e5e docs: close FG-4 Step 3
2026-08-16 23:37:44 +08:00

17 KiB
Raw Blame History

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

Status: ACTIVE Active step: FG4-STEP-4 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 COMPLETE Twelve Emberloom Markets disclose valve, construct, burst and cooldown pressure before commitment. Source 00f3c46; four immutable-source tests pass.
FG4-STEP-2 Save v11 and RG-03 Contract 1 COMPLETE The carried Company clears twelve Rounds and Furnace That Walks or recovers from loss. Source 3ce6f89; eight immutable-source tests pass.
FG4-STEP-3 RG-03 Contract 2 and close COMPLETE Foreman Nine-Sparks falls, two Records persist and RG-04 opens. Source 1b4607c; 13 immutable-source tests pass.
FG4-STEP-4 RG-03 production runtime IN_PROGRESS 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.

FG4-STEP-2 Contract

ID: FG4-STEP-2
PLAYER OUTCOME: the exact closed RG-02 Company enters RG-03 Market 1, clears
  twelve valve-driven Rounds, defeats Furnace That Walks, writes the first
  Emberloom Record and reaches a stable Contract-2 handoff; a failed ordinary
  or Boss battle returns to the same disclosed board/Muster after permanent
  loss instead of rerolling or resurrecting.
IN SCOPE: Save-v10 region-close to Save-v11 migration; one shared FG-4 Run
  state; revision-bound prepare, settle, recovery and Contract-close services;
  deterministic ordinary and Furnace battle resolution; all 36 Step-1 routes;
  exact Coin/XP/recovery/Credit/Record/Renown operations; focused Save, state,
  route and Boss tests; FG-3 persistence and close regressions.
OUT OF SCOPE: CTR-R3-02 routes or execution; Foreman Nine-Sparks execution;
  RG-04; presentation, media, audio, simulation, H5, native delivery and
  release.
OWNED FILES: new runtime/fg4 Save/state/battle/service modules, focused
  runtime/tests/fg4 fixture/tests and tracked UIDs; durable Step-2 closure
  after pushed source.
ACCEPTANCE CHECKS: migration preserves exact Guild, Company, Recruit levels,
  HP, one-slot equipment, inventory, Coin/Credit, Records and active Artifacts;
  Save v11 rejects checksum drift, rollback, future version, active/backup
  corruption and interrupted candidate writes with zero offline value; all
  route facts replay from the committed board; at least two state-dependent
  response plans remain viable across all 36 routes; victory settles Coin/XP
  exactly once; defeat removes Fallen Recruits permanently, returns equipment,
  grants bounded Credit, pays no battle Coin and restores the same board or
  Muster; Boss victory pays no Coin, grants Renown 18, writes one Record and
  reaches the immutable CTR-R3-02 handoff exactly once.
EVIDENCE LEVEL EXPECTED: implemented plus automated_verified execution and
  persistence authority.
COMMIT BOUNDARY: focused Save/state/battle/test source push, immutable focused
  evidence, durable closure.
LEGAL TERMINAL: FG-4 Step 2 RG-03 Contract 1 execution complete.
NEXT STEP: FG4-STEP-3.

FG4-STEP-3 Contract

ID: FG4-STEP-3
PLAYER OUTCOME: the exact first Emberloom Record opens twelve new Markets in
  the same Run; the surviving Company manages repeated action tags and spark
  promotion, defeats Foreman Nine-Sparks, writes the second RG-03 Record and
  reloads with RG-04 unlocked. Defeat returns to the same Market or Muster with
  permanent consequences intact.
IN SCOPE: CTR-R3-02 identity; 36 second-Contract routes and twelve deterministic
  3/4/3 Markets using the existing 40 equipment, seven Artifacts and twelve
  enemy identities; Save-v11 phase/invariant extension; revision-bound handoff,
  route, recovery, Boss and Region-close transactions; Foreman battle model;
  exact Coin/XP/renown/Record/RG-04 operations; focused content/state/battle/
  close tests and Step-2/FG-3 regressions.
OUT OF SCOPE: RG-04 content or gameplay; new Profession/Trait definitions;
  presentation, generated media, audio, simulation, H5, native delivery and
  release.
OWNED FILES: bounded extensions under runtime/fg4, focused runtime/tests/fg4
  files and tracked UIDs; durable Step-3 closure after pushed source.
ACCEPTANCE CHECKS: first Record activates one byte-stable Market 1 without
  resetting Company, HP, growth, one-slot equipment, economy, Artifact,
  history or prior receipts; all twelve enemies remain exercised; every Market
  discloses repetition counter, next spark promotion and at least two rational
  responses; all 36 routes replay from their committed boards and have two
  viable state-dependent plans; ordinary/Boss success, duplicate, stale,
  tamper, defeat and recovery boundaries remain atomic; Foreman exposes varied
  tags versus one safe promotion, pays no Coin, grants Renown 22, writes
  CLEAR-RG03-C02 and the second RG-03 Record, unlocks RG-04 once and roundtrips
  Save v11 in result, recovery and closed states with zero offline value.
EVIDENCE LEVEL EXPECTED: implemented plus automated_verified complete RG-03
  execution and persistence authority.
COMMIT BOUNDARY: focused content/state/battle/test source push, immutable
  focused evidence, durable closure.
LEGAL TERMINAL: FG-4 Step 3 complete RG-03 authority complete.
NEXT STEP: FG4-STEP-4.

FG4-STEP-4 Contract

ID: FG4-STEP-4
PLAYER OUTCOME: one continuous landscape game carries the surviving Company
  through Emberloom Markets, ordinary victory, permanent-loss recovery, both
  fixed Bosses, two Records and the visible RG-04 unlock. Valve, delayed heat,
  constructs, repeated tags and spark promotion are readable world actions,
  not labels on a Region-specific card page.
IN SCOPE: compatible FG-4 adapter/presenter extensions over the accepted FG-2/
  FG-3 world-first controller; exact Step-3 Market, battle, recovery, handoff,
  Boss, Record and Region-close event binding; RG-03 environment, ordinary
  enemy and both Boss media; event-bound motion/VFX; original local music,
  ambience and semantic SFX; bilingual copy; parsed ScreenTouch/ScreenDrag;
  required landscape, text-scale, accessibility and resource-mode fixtures.
OUT OF SCOPE: battle/economy/Save/content formulas, RG-04 content or gameplay,
  a replacement card page or second event authority, five-profile simulation,
  H5, native packages, devices, signing, stores and release.
OWNED FILES: bounded FG-4 campaign adapters/presenters, focused runtime tests
  and tools, traceable RG-03 media/audio source and processed runtime assets,
  import metadata and tracked UIDs; durable Step-4 closure after pushed source.
ACCEPTANCE CHECKS: runtime receipts and terminal states equal Step-3 snapshots;
  the canonical controller remains the sole gameplay/event authority; distinct
  normal states cover Market 1, valve/construct/delayed-heat pressure, repeat
  counter/spark promotion, ordinary victory, loss/recovery, BO-R3-01,
  Contract-2 handoff, BO-R3-02, both Records and RG-04; all twelve enemy IDs
  and both Boss identities are runtime-seen through traceable media; decisive
  heat, construct, repeat, promotion, Fallen, result and unlock events drive
  visible motion/VFX and semantic audio; small/reference/large landscape,
  en/zh_CN, 130% text, reduced motion/flashes, mute and low power do not
  overflow or change results; parsed touch/drag has fallback/direct zero; one
  fixed 20-30 second normal-render recording is nonblank and strict-clean.
EVIDENCE LEVEL EXPECTED: runtime_verified plus supporting agent visual review
  and machine audio checks for complete RG-03. Human acceptance remains open.
COMMIT BOUNDARY: focused adapter/test/media/audio source push, immutable
  runtime evidence, durable closure.
LEGAL TERMINAL: FG-4 Step 4 RG-03 production runtime complete.
NEXT STEP: FG4-STEP-5.

Completed Step Evidence

FG4 Step 1 RG-03 Contract-1 Content Authority - 2026-08-16

  • Source 00f3c462326bcd561380f10f9727d34b1d527d5a adds only the FG-4 catalog, validator, deterministic Market generator, two focused tests and their tracked UIDs.
  • The bilingual graph resolves 40 equipment rows, seven Artifacts, twelve enemies, two non-executable Boss descriptors, 36 routes and twelve Markets. All enemies appear in at least two authored route compositions.
  • Boards use exact 3/4/3 shape, capacity ten, offer levels 1..4, equipment price 18 and rewards 24..60. A changed seed or refresh changes only Recruit/equipment offers; route, valve, reward and fixed Boss facts remain byte-equivalent.
  • Fresh fixed-source R1 is /private/tmp/abg-fg4-00f3c46-step1-r1/evidence/. Two FG-4 tests and two FG-3 regressions pass with strict diagnostics and owned processes zero. Audit SHA-256 is d0fd81e0a49eedc712641005334f351f1cf689a79c625ea4b90b4ebd65b0af96; inventory SHA-256 is 46bc16149e92fe7891adcf42d8142913215223c79f6f66aeb207a7515aabe27e.
  • Step 1 reaches implemented + automated_verified; Save, battle, Boss execution, presentation and human gates remain unclaimed.

FG4 Step 2 Save v11 And RG-03 Contract 1 - 2026-08-16

  • Source 3ce6f89f0e583ae12e286146372ffd3143822929 adds Save v11, one shared RG-03 RunState, deterministic route/Boss battle authority, revision-bound transactions, one real FG-3 close fixture and four focused test programs.
  • Migration preserves the exact Guild, surviving Company, HP/growth, one-slot equipment, economy, 24-route history, Records and active Artifact. Checksum, rollback, future version, active/backup corruption, interruption and all six zero-offline values pass.
  • All 36 routes have two viable responses. Twelve victories settle exact Coin and XP; ordinary and Boss defeat permanently remove Fallen Recruits, return equipment, grant bounded Credit and restore the same board or Muster without reroll or resurrection.
  • Furnace That Walks exposes two plans, pays no Coin, grants Renown 18, writes CLEAR-RG03-C01 plus one Company Record and reaches the exact CTR-R3-02 handoff once.
  • R1 /private/tmp/abg-fg4-3ce6f89-step2-r1/evidence/ remains append-only INVALID_CONTROLLER_COMPLETION_BOUNDARY and is not reused. Fresh R2 is /private/tmp/abg-fg4-3ce6f89-step2-r2/evidence/: six FG-4 tests and two FG-3 regressions pass with strict diagnostics and owned processes zero. Audit SHA-256 is f8366fc056d1d1416e4bc95bc96796cb8dc393f7fec2b65e41ed076413ebc873; inventory SHA-256 is 362816833701de78cd39c08194bfbda9018a0e5de260f8f2df1d648696ffddc0.
  • Step 2 reaches implemented + automated_verified; presentation, simulation and human/device/release gates remain unclaimed.

FG4 Step 3 RG-03 Contract 2 And Close - 2026-08-16

  • Source 1b4607cc164cbf9fe9bc7d1f709244fd1c83f83e adds the exact second-Contract content, deterministic Market generator, activation, route/Boss execution, Region close, shared RunState extension, fixture and five focused tests with tracked UIDs.
  • Twelve 3/4/3 Markets expose an eight-spark repeat counter, next promoted spark, copied target rule and safe-promotion reward. All 36 routes exercise the existing twelve enemies and retain two viable state-dependent plans.
  • The first RG-03 Record activates Contract 2 without changing Company, HP, growth, one-slot equipment, Coin/Credit, active Artifact, 36-route history or prior receipts. Ordinary and Boss defeat preserve permanent casualties and recover to the exact committed board or Muster.
  • Foreman Nine-Sparks exposes varied tags versus one safe promotion, pays no Coin, grants Renown 22, writes CLEAR-RG03-C02 and the second Record, then unlocks RG-04 exactly once. Result, recovery and closed states roundtrip Save v11 with zero offline value.
  • Fresh immutable R1 is /private/tmp/abg-fg4-1b4607c-step3-r1/evidence/. Thirteen programs pass with exact markers, strict diagnostics zero and Godot pre/postflight counts zero. Audit SHA-256 is 2396c25697be09b4abbc0a02a526e66c894cecdf2ce4110b70b3a83f3fc4fac6; inventory SHA-256 is 09e5ee7a24d79dbac7c8da8962c4240db8caada207bd92898c8774122bbfd1a7.
  • Step 3 reaches implemented + automated_verified; presentation, simulation and human/device/release gates remain unclaimed.

Later Step Boundaries

  • 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 RESOLVED_STEP_1 One validated bilingual data graph now binds catalog identities without parsing Markdown at runtime.
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.
Reference in New Issue View Git Blame Copy Permalink