wushenghua/aetherbound-guild
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f8a593c5498f8b7ae590750ea15fdb2fedc7dcc5
aetherbound-guild/docs/runtime/fg4/IMPLEMENTATION_PLAN.md
T

45 KiB
Raw Blame History

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

Status: ACTIVE Active step: FG4-STEP-10 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 COMPLETE Emberloom looks, moves and sounds distinct while retaining the canonical game layout. Source 95fb504; media/audio, parsed input, 12-state matrix and recording pass.
FG4-STEP-5 RG-03 profiles COMPLETE Five policies prove heat/construct decisions, recovery and Save v11 through RG-04 entry. Source 791187c; five profiles, 15-state persistence and immutable Region candidate pass.
FG4-STEP-6 RG-04 complete content COMPLETE Twenty-four Quillroot Markets disclose copy, redirect, cleanse and clause decisions. Source 7cbdcc4; five immutable-source tests pass.
FG4-STEP-7 RG-04 Contract 1 COMPLETE The Company manipulates The Walking Index and writes the first Archive Record. Source 15db9fc; 11 immutable-source Godot tests pass.
FG4-STEP-8 RG-04 Contract 2 and close COMPLETE Redaction Hart falls, the fourth midpoint Record persists and RG-05 opens. Source 978039b; 15 immutable-source Godot tests and one catalog build pass.
FG4-STEP-9 RG-04 production runtime COMPLETE Quillroot has readable clause/copy presentation and distinct media/audio. Source 96b2d1a; 25 tests, five validators, two matrices and MovieWriter pass.
FG4-STEP-10 Midpoint candidate and H5 IN_PROGRESS 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.

FG4-STEP-5 Contract

ID: FG4-STEP-5
PLAYER OUTCOME: complete Emberloom remains finishable, recoverable and
  strategically state-dependent across normal, active, efficient, adversarial
  and returning play, then reloads the exact two-Record RG-04 handoff.
IN SCOPE: source-derived five-profile simulation; explicit decision timestamps;
  valve/construct/delayed-heat/cooldown/repeat/spark counterfactuals; route,
  response, Artifact and Boss-plan anti-dominance; permanent-loss recovery;
  Save-v11 migration, phase, interruption, retry, corruption, rollback and
  zero-offline matrices; immutable complete-RG-03 candidate evidence over the
  accepted Step-4 runtime.
OUT OF SCOPE: new gameplay, content, presentation, media or audio; RG-04
  execution; H5; native packages, devices, signing, stores, release and any
  human acceptance claim.
OWNED FILES: bounded FG-4 simulation/candidate tests, verification tools and
  tracked UIDs; durable Goal/plan/checkpoint/ledger closure after the pushed
  candidate source. Step-4 product/runtime/media/audio authority is read-only
  unless a declared gate exposes a product failure.
ACCEPTANCE CHECKS: all five named profiles reach exactly two RG-03 Records and
  one RG-04 unlock with ordered decision timestamps, first decision within 20
  seconds and longest nonbattle no-decision interval at most 45 seconds;
  policies produce distinct route, response, Artifact and Boss plans;
  every RG-03 pressure family has an opposed state-dependent counterfactual
  and no universal answer; adversarial play loses at least one Recruit,
  actively recovers and still finishes; returning play performs at least three
  reloads; representative Save-v11 Market, prepared, battle, result, recovery,
  Boss, handoff and Region-close states roundtrip exactly; duplicate, stale,
  tampered, rollback, corruption and interruption inputs create no value;
  all offline deltas remain zero; accepted Step-4 runtime, layout, touch,
  recording, media, audio and strict-log gates remain source-bound and clean.
EVIDENCE LEVEL EXPECTED: simulation_verified plus retained runtime_verified,
  agent_visual_reviewed and machine_audio_checked from one immutable candidate.
COMMIT BOUNDARY: focused simulation/matrix/test source push, immutable candidate
  evidence, durable closure.
LEGAL TERMINAL: FG-4 Step 5 complete RG-03 candidate ready.
NEXT STEP: FG4-STEP-6 complete RG-04 content; H5 remains frozen until Step 10.

FG4-STEP-6 Contract

ID: FG4-STEP-6
PLAYER OUTCOME: all twenty-four Quillroot Markets reveal which action will be
  copied, redirected, trapped or judged by an archive clause before the player
  commits a route and response.
IN SCOPE: shared FG-4 graph extension for EQ-121..160, AR-023..030,
  EN-R4-01..12, BO-R4-01/02 descriptors, CTR-R4-01/02, 72 route rows and
  twenty-four deterministic 3/4/3 Markets; bilingual copy; copy, redirect,
  cleanse-trap and repeat/alternate/preserve clause disclosures; content,
  generator and negative validation tests.
OUT OF SCOPE: RG-04 battle/Boss execution, Save-v11 phase mutation, settlement,
  recovery, presentation, media, audio, paid generation, simulation, H5,
  native packages, devices, signing, stores and release.
OWNED FILES: bounded extensions under runtime/fg4 for catalog, registry and
  deterministic RG-04 Market generation; focused runtime/tests/fg4 files and
  tracked UIDs; durable Step-6 closure after pushed source. RG-03 runtime,
  gameplay, media/audio and Step-5 candidate tests remain read-only.
ACCEPTANCE CHECKS: exact 40 equipment, eight Artifact, twelve enemy and two Boss
  identities resolve without changing any RG-03 row; both Contracts expose 36
  routes and twelve Markets; every enemy appears in at least two authored
  compositions; every route declares one copy/redirect/cleanse pressure plus a
  repeat, alternate or preserve clause with affected action field, obey result,
  break result and at least two rational response tags; all three clause kinds
  and all four pressure families recur across both Contracts; every Market has
  three risk routes, fixed reward and fixed Boss identity; same seed is
  byte-identical; changed seed or refresh changes only Recruit/equipment offers;
  route, clause, copy source, Boss and reward facts never reroll; both Bosses
  remain non-executable descriptors until Steps 7/8; generation mutates no
  product state and all bilingual references validate.
EVIDENCE LEVEL EXPECTED: implemented plus automated_verified RG-04 content
  authority; battle, persistence, presentation and human gates remain open.
COMMIT BOUNDARY: focused content/generator/test source push, immutable focused
  evidence, durable closure.
LEGAL TERMINAL: FG-4 Step 6 RG-04 content authority complete.
NEXT STEP: FG4-STEP-7 executes CTR-R4-01 through The Walking Index.

FG4-STEP-7 Contract

ID: FG4-STEP-7
PLAYER OUTCOME: the exact surviving RG-03 Company enters Quillroot Archive
  without reset, commits disclosed clause/copy responses through twelve Rounds,
  defeats The Walking Index by steering action count or timing one pointer
  interrupt, writes the first RG-04 Record and reaches a stable CTR-R4-02
  handoff. Defeat preserves permanent casualties and returns to the same Market
  or Boss Muster without reroll or resurrection.
IN SCOPE: exact RG-03 region-close to RG-04 activation; Save-v11 phase and
  invariant extension without a version bump; committed CTR-R4-01 Market boards;
  deterministic execution of its 36 routes; copy, redirect, cleanse-trap and
  repeat/alternate/preserve clause outcomes; Walking Index action-pointer battle
  model; revision-bound prepare, settle, recovery, Boss and Contract-close
  transactions; exact Coin/XP/Credit/Renown-20/Record operations; stable
  CTR-R4-02 handoff; focused state, route, Boss, save and RG-03 regressions.
OUT OF SCOPE: CTR-R4-02 route or Boss execution; Redaction Hart; RG-04 Region
  close or RG-05 unlock; new content identities; presentation, media, audio,
  paid generation, simulation, H5, native packages, devices, signing, stores
  and release.
OWNED FILES: bounded extensions and new activation/state/battle/transaction
  modules under runtime/fg4, focused runtime/tests/fg4 fixtures/tests and tracked
  UIDs; durable Step-7 closure after pushed source. Accepted RG-03 presentation,
  media/audio, profiles and Step-5 evidence remain read-only.
ACCEPTANCE CHECKS: activation requires exact closed RG-03 plus both RG-03 clear
  receipts and preserves Guild, Company, HP/growth, one-slot equipment,
  inventory, Coin/Credit, Records, active Artifact, route history and prior
  receipts byte-equivalent; all 36 CTR-R4-01 route facts replay from the
  committed board and expose at least two state-dependent plans; all four
  pressure families and three clause kinds reverse response value in at least
  one state; ordinary victory settles exact Coin/XP once; duplicate, stale,
  tampered and wrong-phase inputs mutate nothing; defeat removes Fallen
  Recruits permanently, returns equipment, grants bounded Credit, pays no
  battle Coin and restores the same board/Muster; Walking Index supports
  action-count steering and pointer interrupt, pays no Coin, grants Renown 20,
  writes CLEAR-RG04-C01 plus one Company Record and reaches immutable
  CTR-R4-02 handoff exactly once; representative activation, Market, prepared,
  recovery, Boss, result and handoff Save-v11 states roundtrip with corruption,
  rollback, interruption and all offline deltas rejected.
EVIDENCE LEVEL EXPECTED: implemented plus automated_verified CTR-R4-01
  execution and persistence authority. Presentation and human gates stay open.
COMMIT BOUNDARY: focused state/battle/transaction/test source push, immutable
  focused evidence and durable closure.
LEGAL TERMINAL: FG-4 Step 7 Quillroot Contract 1 complete.
NEXT STEP: FG4-STEP-8 executes CTR-R4-02 through Redaction Hart and RG-05.

FG4-STEP-8 Contract

ID: FG4-STEP-8
PLAYER OUTCOME: the first Archive Record opens twelve final Quillroot Markets
  without resetting the surviving Company; the player seeds safe rules or
  reorders and interrupts disclosed replays, defeats Redaction Hart, writes the
  second RG-04 Record, unlocks RG-05 and reloads the exact closed midpoint Guild.
  Defeat preserves permanent casualties and returns to the same Market or
  Muster without reroll or resurrection.
IN SCOPE: exact CTR-R4-02 activation from the Step-7 handoff; Save-v11 phase and
  invariant extension without a version bump; deterministic execution of all
  36 second-Contract routes; copy, redirect, cleanse-trap, redaction and visible
  replay-order outcomes; Redaction Hart safe-rule-seed versus reorder/interrupt
  battle model; revision-bound prepare, settle, recovery, Boss, Contract and
  Region-close transactions; exact Coin/XP/Credit/Renown-24/two-Record/RG-05
  operations; focused state, route, Boss, save and complete RG-03/C1 regressions.
OUT OF SCOPE: RG-05 gameplay/content; presentation, media, audio, paid
  generation, five-profile simulation, layout/touch/recording, H5, native
  packages, devices, signing, stores and release.
OWNED FILES: bounded extensions and new second-Contract execution modules under
  runtime/fg4, focused runtime/tests/fg4 fixtures/tests and tracked UIDs;
  durable Step-8 closure after pushed source. Accepted RG-03 presentation,
  media/audio, profiles and all earlier immutable evidence remain read-only.
ACCEPTANCE CHECKS: activation requires exact CLEAR-RG04-C01 handoff and
  preserves Guild, Company, HP/growth, one-slot equipment, inventory,
  Coin/Credit, Records, active Artifact, 60-route history and all prior receipts
  byte-equivalent; all 36 CTR-R4-02 routes replay from committed boards and
  retain two state-dependent plans across all clause/pressure families;
  redaction source, omitted target clause and replay order remain disclosed;
  ordinary success pays exact Coin/XP once; duplicate, stale, wrong-phase and
  tampered inputs mutate nothing; defeat permanently removes Fallen Recruits,
  returns equipment, grants bounded Credit, pays no Coin and preserves the same
  board/Muster; Redaction Hart supports safe seeded rules and reorder/interrupt,
  pays no Coin, grants Renown 24, writes CLEAR-RG04-C02 plus the second RG-04
  Record, closes RG-04 and unlocks RG-05 exactly once; representative activation,
  Market, prepared, recovery, Boss, result and Region-close Save-v11 states
  roundtrip with replay, rollback, corruption, interruption and all offline
  deltas rejected.
EVIDENCE LEVEL EXPECTED: implemented plus automated_verified complete RG-04
  execution and persistence authority. Presentation and human gates stay open.
COMMIT BOUNDARY: focused execution/state/test source push, immutable focused
  evidence and durable closure.
LEGAL TERMINAL: FG-4 Step 8 complete RG-04 execution candidate ready.
NEXT STEP: FG4-STEP-9 binds Quillroot presentation, motion and audio.

FG4-STEP-9 Contract

ID: FG4-STEP-9
PLAYER OUTCOME: one continuous landscape game carries the surviving Company
  from exact RG-04 entry through a disclosed Quillroot route, clause/copy
  resolution, permanent-loss recovery, both fixed Bosses, two Archive Records
  and the visible RG-05 unlock. Copy source, omitted target clause and replay
  order are recognizable world events before they resolve, not a card wall or
  debug-only labels.
IN SCOPE: compatible FG-4 adapter/controller extensions over the accepted
  world-first runtime; exact Step-8 Market, prepared, battle, recovery, handoff,
  Boss, Record and Region-close event binding; distinct Quillroot environment,
  ordinary enemy and both Boss runtime media produced from existing owned
  sources or deterministic local original tools only; 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: gameplay, economy, Save or content formulas; RG-05 gameplay;
  paid image/TTS/video or ElevenLabs generation; five-profile simulation; H5;
  native packages, devices, signing, stores and release.
OWNED FILES: bounded extensions under runtime/campaign for the FG-4 adapter and
  controller; traceable RG-04 additions under runtime/assets/fg4; deterministic
  FG-4 media/audio tools and manifests; focused runtime/tests/fg4 files and
  tracked UIDs; durable Step-9 closure after pushed source. Step-8 execution
  authority and all accepted RG-03 presentation bytes remain read-only unless
  a focused regression proves the smallest compatible repair is necessary.
ACCEPTANCE CHECKS: runtime receipts and terminal states equal exact Step-8
  snapshots; the canonical controller remains the sole gameplay/event
  authority; distinct normal states cover RG-04 entry, clause and copy source,
  redaction source, omitted target, visible replay order, ordinary victory,
  permanent loss/recovery, BO-R4-01, Contract-2 handoff, BO-R4-02, both Records
  and RG-05; all twelve R4 enemy IDs and both Boss identities are runtime-seen
  through traceable media; copy, redirect, cleanse, clause, redaction, Fallen,
  recovery, Record and unlock events drive bounded motion/VFX and semantic
  audio; small/reference/large landscape, en/zh_CN, 130% text, reduced motion,
  reduced 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; paid calls remain zero.
EVIDENCE LEVEL EXPECTED: runtime_verified plus supporting agent visual review
  and machine audio checks for complete RG-04. Human acceptance remains open.
COMMIT BOUNDARY: focused adapter/test/media/audio source push, immutable runtime
  evidence and durable closure.
LEGAL TERMINAL: FG-4 Step 9 RG-04 production runtime complete.
NEXT STEP: FG4-STEP-10 creates the combined midpoint candidate and cached H5.

FG4-STEP-10 Contract

ID: FG4-STEP-10
PLAYER OUTCOME: reload the exact closed RG-04 Company, prove that Emberloom and
  Quillroot require different plans across five play policies, then open one
  cached landscape H5 that reaches representative heat, clause, loss/recovery,
  Boss, Record and RG-05 states without resetting carried consequences.
IN SCOPE: combined normal, active, efficient, adversarial and returning
  profiles with explicit decision timestamps; counterfactual route, Artifact
  and Boss choices across both Regions; Save-v11 migration, roundtrip,
  corruption, replay, rollback, interruption and zero-offline matrices; one
  immutable source-bound regression/runtime candidate; runtime-only Web export;
  local and remote byte/MIME/cache checks; private Gallery checkpoint-2 handoff;
  durable FG-4 closure; bounded test-attempt lifecycle tooling that archives
  compact results, removes source/HOME/cache/browser temporary roots after each
  attempt and retains at most three unprotected failed-attempt payloads.
OUT OF SCOPE: gameplay, economy, Save-version or content changes; presentation
  redesign; new or paid media/audio; RG-05 gameplay; native packages, devices,
  signing, TestFlight, stores, publishing and release.
OWNED FILES: bounded candidate/simulation/persistence tests under
  runtime/tests/fg4 and tracked UIDs; existing runtime-only Web/export and
  Gallery handoff tooling when byte-compatible; bounded tools and tool tests for
  isolated attempt cleanup and Playwright temporary-root ownership; durable
  Goal, plan, checkpoint, roadmap and ledger closure. Accepted Step-9 product/
  media/audio remain frozen.
ACCEPTANCE CHECKS: five profiles complete all 48 ordinary Rounds and four
  Bosses with explicit decision timestamps and no universal route, Artifact or
  Boss answer; permanent-loss recovery remains viable; all required Save-v11
  states roundtrip and reject mutation/replay/rollback/corruption/interruption
  with offline value zero; Step-9 source-bound runtime/touch/media/audio gates
  remain strict-clean; runtime-only Web excludes tests/docs/evidence/build;
  local and remote payloads are byte-identical with correct MIME, long-lived
  immutable caching and conditional 304; the signed private H5 opens the real
  844x390 game; a runner self-test proves success/failure archival, cleanup of
  owned source/HOME/cache/TMP/browser roots, stale-owned recovery and a maximum
  of three unprotected failed-attempt payloads. Owner comprehension, fun,
  visual and listening gates stay open.
EVIDENCE LEVEL EXPECTED: simulation_verified plus retained runtime_verified,
  agent_visual_reviewed and machine_audio_checked; H5 transport verified.
COMMIT BOUNDARY: focused candidate/test source push, immutable combined
  evidence, runtime-only Web/Gallery handoff and durable FG-4 closure.
LEGAL TERMINAL: Aetherbound Guild FG-4 midpoint candidate ready for Owner
  checkpoint 2.
NEXT STEP: stop for Owner checkpoint 2; RG-05 and native delivery stay frozen.

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.

FG4 Step 4 RG-03 Production Runtime - 2026-08-16

  • Product/evidence source 95fb5045a7bee41e2dc31768cbae8da118965681 is pushed, upstream-equal and clean. It extends the accepted world-first controller through all 24 RG-03 Rounds, both Bosses, permanent-loss recovery, two Records and the visible RG-04 unlock without changing Step-3 gameplay, economy, Save or content facts.
  • Emberloom uses nine layered environment plates, twelve ordinary enemy identities, two four-frame Boss actions, one deterministically composed eight-spark prop, event-bound motion/VFX, original music and ambience, and eleven semantic SFX. Thirteen audio assets bind 21 semantic events.
  • Four paid image calls cost USD 0.056. One seven-spark Boss anchor is retained rejected; the accepted runtime composes exactly eight sparks. The current task's four-call allowance is exhausted and no paid media generation remains authorized for Step 9.
  • R1 /private/tmp/abg-fg4-95fb504-step4-r1/evidence/ is append-only INVALID_HARNESS because its strict-diagnostic count expanded to an empty value. R2 /private/tmp/abg-fg4-95fb504-step4-r2/evidence/ is append-only INVALID_PREFLIGHT_SELF_MATCH because its process preflight counted its own shell arguments. Neither attempt contributes product judgment or is reused.
  • Fresh authoritative R3 is /private/tmp/abg-fg4-95fb504-step4-r3/evidence/. Fifteen headless programs, three normal-render programs, five Python validators and one 745-frame / 24.833333s MovieWriter recording pass. Twelve distinct native-size frames cover required viewports, locales, 130% text and resource/accessibility modes. Parsed Touch/Drag are 107/1; fallback/direct, strict diagnostics and black intervals are zero. The 67-row inventory verifies completely with SHA-256 ad8e0186ce1f37c27cce8130cdea38048204dfd582e6f798dff7cdcfdc2bfed8.
  • Step 4 reaches implemented + automated_verified + runtime_verified + agent_visual_reviewed + machine_audio_checked. Human understanding, fun, visual/listening, H5, device, packaging, signing, store and release remain open or frozen.

FG4 Step 5 Complete RG-03 Candidate - 2026-08-16

  • Verification source 791187c20e2f5c5f1c1f3152b3b985c30b180c21 is pushed, upstream-equal and clean. Its runtime delta over Step-4 product source 95fb504 is exactly two candidate tests and their tracked UIDs; gameplay, Save authority, presentation, media and audio are byte-identical.
  • Normal, active, efficient, adversarial and returning profiles each record 53 ordered decisions and clear all 24 ordinary Rounds plus both Bosses. Across 265 decisions, longest nonbattle gap is 34.3s; five policy signatures, three Artifact contexts, all 24 route positions, both Boss plans, 16 winning secondary responses and six event-bound pressure families are exercised.
  • Five recovery cycles preserve permanent loss and still close RG-03. Returning play reloads nine stable boundaries. All profiles finish with four total Records, exactly two RG-03 Records and one RG-04 unlock; offline rewards and same-battle resurrection are zero.
  • Fifteen Save-v11 states cover Market, prepared, recovery, both Bosses, results, handoff and Region close. Save-v10 migration, 15-entry hash chain, exact roundtrip, duplicate determinism, mutation, rollback, future version, active/backup, dual corruption and interrupted candidate-write boundaries pass.
  • Fresh immutable R1 is /private/tmp/abg-fg4-791187c-step5-r1/evidence/. Seventeen headless, two normal-render, one MovieWriter and five Python programs produce 25 unique markers with strict diagnostics zero. Twelve distinct native captures and a 745-frame / 24.833333s recording pass; runtime Touch/Drag are 20/1, recording Touch/Drag are 107/1, and fallback/direct/black intervals are zero. The 59-row inventory verifies completely with SHA-256 e79e3b891e1df4078fa9912cb0d200d13ee8c3c31c97e0907d88507117fa65cb.
  • Step 5 reaches simulation_verified + runtime_verified + agent_visual_reviewed + machine_audio_checked. Human comprehension, strategy depth, fun, visual/listening, H5, device, packaging, signing, store and release remain open or frozen.

FG4 Step 6 RG-04 Content Authority - 2026-08-16

  • Source 7cbdcc46514c2b7bf72a03279bfa77e624523a66 is pushed, upstream-equal and adds the reproducible RG-04 supplement, shared graph validation, one deterministic two-Contract Market generator and focused tests. All RG-03 catalog rows remain byte-equivalent.
  • The combined FG-4 graph resolves EQ-081..160, AR-016..030, 24 ordinary/ elite enemies and four Bosses. RG-03 Bosses remain executable; Walking Index and Redaction Hart remain non-executable descriptors for Steps 7/8.
  • Twenty-four Quillroot Markets and 72 routes use exact 3/4/3 boards, capacity ten, offer levels 1..4, equipment price 20, rewards 26..69, all three clause kinds and all four pressure families. Every R4 enemy occurs in at least two authored routes.
  • Same seed is byte-identical. Seed and refresh alter only Recruit/equipment offers; route, clause, copy source, Boss and reward facts remain unchanged. Generation mutates no product state.
  • Fresh immutable R1 is /private/tmp/abg-fg4-7cbdcc4-step6-r1/evidence/. Two RG-04 focused programs and three RG-03 regressions pass with five exact markers, strict diagnostics zero and owned engine processes zero. Audit SHA-256 is dfbf22d5e10400d52b499c781ded8f127f0e5e6b6619217b1b4cb52eb2cbbf5b; the 13-row inventory verifies with SHA-256 b7839f6a5b6cd1dfe8531452dd751628568159b4219df4fabe809f910058debe.
  • Step 6 reaches implemented + automated_verified. Battle, Save mutation, presentation, media, audio, simulation, human, H5, device and release gates remain open or frozen.

FG4 Step 7 RG-04 Contract 1 - 2026-08-17

  • Source 15db9fcffdc87a7a2630bf9beb793b1ef213eb58 is pushed, upstream-equal and extends the shared RunState through exact RG-04 activation, twelve ordinary Rounds, Walking Index, permanent-loss recovery, one Record and stable CTR-R4-02 handoff without changing Save version 11.
  • Activation requires both RG-03 clear receipts and the exact closed result hash. Company, HP/growth, one-slot equipment, inventory, Coin/Credit, Artifacts, 48-route history, Records and prior receipts remain byte-equivalent.
  • All 36 routes have two viable plans; 12 Artifact-state cases reverse obey/ break priority. All three clause kinds and four pressure families emit disclosed, event-bound outcomes. Victory pays exact Coin/XP once; defeat permanently removes Fallen, returns equipment and recovers to the same board.
  • Walking Index exposes action-count steering and pointer interrupt. Both work in the inherited build; AR-024 reverses the interrupt plan. Victory pays no Coin, grants Renown 20, writes CLEAR-RG04-C01 plus one 12-route Record and reaches immutable CTR-R4-02; Boss recovery costs 32 and never resurrects.
  • Fresh immutable R1 is /private/tmp/abg-fg4-15db9fc-step7-r1/evidence/. Eleven Godot programs plus one byte-stable catalog build produce 12 unique markers with strict diagnostics, credential-pattern matches and owned processes zero. Audit SHA-256 is ccc96e7296360c28ccae8cd9e3a8b1ce94a24ef4bcf5d08c00ad88dd628cac73; the 21-row inventory verifies with SHA-256 b33696b6b971de5c1d793ef49f0f1b5d34f0f139b20a9c9c53c76c4ab69e9601.
  • Step 7 reaches implemented + automated_verified. CTR-R4-02, Region close, RG-05, presentation, simulation, human, H5, device and release remain open or frozen.

FG4 Step 8 RG-04 Contract 2 And Region Close - 2026-08-17

  • Product/evidence source 978039b33c00733fdbb76085e06c50b9088dc41e is pushed, upstream-equal and extends Save-v11 state through exact CTR-R4-02 activation, twelve final Rounds, Redaction Hart and atomic RG-04 close without changing earlier gameplay or Save version.
  • Activation preserves the surviving Company, growth/HP, one-slot equipment, inventory, Coin/Credit, Artifacts, Records, all 60 prior routes and prior receipts. All 36 new routes retain two viable plans and twelve Artifact-state reversals across three clauses and four pressure families.
  • Every committed route exposes the redaction source, omitted target clause and replay order before resolution. Victory settles Coin/XP once; defeat permanently removes Fallen, returns equipment and recovers the same board.
  • Redaction Hart supports safe rule seeding and reorder/interruption. Victory pays no Coin, grants Renown 24, writes CLEAR-RG04-C02 plus the second RG-04 Record, closes the Region and unlocks RG-05; recovery costs 34 and never resurrects.
  • Fresh immutable R1 is /private/tmp/abg-fg4-978039b-step8-r1/evidence/. Fifteen Godot programs and one byte-stable catalog build produce 16 unique markers with strict diagnostics, credential-pattern matches and owned processes zero. Audit SHA-256 is 8fa8ee92e4a5ce4d80c903d914f79f1690db3bcf7b42ec7a67156c4450a42384; the 25-row inventory verifies with SHA-256 5223ed47f312d6c0acb94f20eca043412c91e750eef4f16a2835b93f54eaa9b1.
  • Step 8 reaches implemented + automated_verified. Step 9 now owns only Quillroot presentation, motion and audio. Simulation, H5, human, device and release gates remain open or frozen.

FG4 Step 9 RG-04 Production Runtime - 2026-08-17

  • Product source d27e5e4b2fdf6a83abfbc81f45de9d3088c3a830 and recording-exit evidence source 96b2d1a784b29d2cd012459838ee3039cd9d84f3 are pushed, upstream-equal and clean. Gameplay, economy, Save v11 and content authority remain byte-unchanged from Step 8.
  • The canonical world-first controller carries all 24 Quillroot ordinary Rounds, Walking Index, Redaction Hart, permanent-loss recovery, two Archive Records and RG-05. Nine environment plates, 12 ordinary identities, two four-frame Bosses, bounded archive VFX, distinct music/ambience and four new semantic SFX are integrated with zero paid Step-9 calls.
  • R1 is append-only INVALID_STALE_TEST_CONTRACT; R2 is append-only INVALID_LOW_DISK_RUNTIME_DIAGNOSTIC; R3 is append-only FAIL_RECORDING_AUDIO_CLIPPING; R4 is append-only INVALID_GRAY_RECORDING_TEARDOWN. No attempt contributes to R5 or is reused.
  • Fresh immutable R5 is /private/tmp/abg-fg4-96b2d1a-step9-r5/evidence/. Twenty-five headless programs, five Python/media/audio checks, two normal-render programs, 12 unique RG-04 captures and a 765-frame / 25.5s MovieWriter pass. Parsed Touch/Drag are 106/1; fallback/direct, strict diagnostics, black intervals and clipped samples are zero. The final sample remains the visible RG-05 state. Audio peak/RMS are -2.5937/-20.6621 dBFS.
  • Audit SHA-256 is aa311b0144fb83b81ce7f3f1769863504f6de8ef5d107c2c064677251fd5b5ed; the 84-row inventory verifies with SHA-256 ce3ab2b31f3593c20ffb6f9f101d87944d0e7c05c95d3e3faa64a33853a8f30e.
  • Step 9 reaches runtime_verified + agent_visual_reviewed + machine_audio_checked. Human comprehension, strategy depth, fun, visual/listening, H5, device and release remain open or frozen.

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. Paid generation requires a new Owner decision because Step 4 exhausted the current four-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 RESOLVED_STEP_4 Step 4 used all four authorized image calls for USD 0.056. Further paid generation requires a new Owner decision.
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.
FG4-I06 RESOLVED_STEP_5 Five policies, 16 winning secondary responses, five permanent-loss recoveries and 15 Save-v11 states close the immutable RG-03 candidate.
FG4-I07 RESOLVED_STEP_6 One validated combined graph preserves all RG-03 rows and adds complete RG-04 content, deterministic Markets and descriptor-only Bosses.
FG4-I08 RESOLVED_STEP_7 Exact RG-03 close activates RG-04; 36 routes, Walking Index, permanent-loss recovery, one Record and Save-v11 C2 handoff are atomic.
FG4-I09 RESOLVED_STEP_9 The final Quillroot mix reserves 3 dB SFX headroom and the recording keeps RG-05 visible through teardown; R5 is strict-clean.
FG4-I10 RESOLVED_STEP_10_RUNNER Cleanup/retention passed; after dirty-tree attempt 01 proved Godot can return zero on parse error, the runner added strict diagnostic rejection and exact-one required-marker gates. Attempt 01 is development-only INVALID_RUNNER_DIAGNOSTIC and is not reused.
Reference in New Issue View Git Blame Copy Permalink