wushenghua/aetherbound-guild
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
bb904cd9bf26209855fdb5fdbb70efea6920bf28
aetherbound-guild/docs/runtime/fg4/IMPLEMENTATION_PLAN.md
T
wushenghua bb904cd9bf docs: close FG-4 Step 2
2026-08-16 22:55:25 +08:00

13 KiB
Raw Blame History

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

Status: ACTIVE Active step: FG4-STEP-3 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 IN_PROGRESS 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.

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.

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.

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 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