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

7.5 KiB

FG-3 Complete RG-02 Implementation Plan

Status: ACTIVE Active step: FG3-STEP-3 Activation baseline: 2f1fcd0ef0effbc804101eb62142f8596f904fe0 Goal: docs/goals/FG3_COMPLETE_RG02_GOAL.md Contract: docs/runtime/FG3_COMPLETE_RG02_CONTRACT.md

Player-Visible Stopping Point

Starting from exact saved Market 8, the player completes both Siltwake Contracts and Bosses, preserves losses and growth, and reloads with RG-03 visibly unlocked through the accepted FG-2 game presentation.

Ordered Steps

Step Status Player outcome Commit boundary
FG3-STEP-0 Contract and audit COMPLETE Owner continuation, complete Region boundary and evidence route are frozen. Goal, contract, plan, roadmap, checkpoint and ledger.
FG3-STEP-1 Contract-1 content and boards COMPLETE Market 8-12 offers truthfully prepare the remaining ordinary pressure and first Boss. Source 0208471; four immutable-source tests pass.
FG3-STEP-2 Contract-1 execution and Boss COMPLETE The surviving Company clears Round 12 and defeats or recovers from Sluiceback Mother. Source 74dab24; nine immutable-source tests pass.
FG3-STEP-3 Contract-2 content and state IN_PROGRESS The first Record opens a complete second twelve-Round Contract without resetting the Company. Contract-2 boards, route content, state/save extension and tests.
FG3-STEP-4 Contract-2 execution and Region close PENDING The player defeats The Drowned Bell and reloads two Records plus RG-03. Battle/Boss/close authority, counterfactuals and tests.
FG3-STEP-5 Production runtime PENDING The complete Region uses the accepted world-first art, motion, VFX and audio direction. Compatible adapters, runtime states, parsed input and media coverage.
FG3-STEP-6 Profiles and candidate PENDING Five policies prove the full Region is paced, recoverable and persistence-safe. Simulation, matrices, recording, immutable evidence and closure.

FG3-STEP-1 Contract

ID: FG3-STEP-1
PLAYER OUTCOME: Markets 8-12 disclose timing, movement, link and Boss-preparation
  consequences before the player spends or commits a route.
IN SCOPE: EQ-065..080; AR-009/010/013/014 plus inherited Artifact references;
  both Boss identities; 15 Contract-1 routes; five 3/4/3 Market boards;
  bilingual copy; deterministic hashes; focused content/board tests.
OUT OF SCOPE: state mutation, Save v10, battle execution, Boss execution,
  presentation, new media, Contract 2, H5 and release.
OWNED FILES: new runtime/fg3 catalog/registry/board modules, focused tests and
  tracked UIDs; durable closure after pushed source.
ACCEPTANCE CHECKS: exact IDs and counts; source references resolve; same inputs
  are byte-identical; changed seed changes owned identities; refresh changes
  only Recruit/equipment rows; route/Boss facts never reroll; all reward and
  capacity values match authority; malformed IDs/counts/formulas reject;
  P10.3 content/Market regressions pass.
EVIDENCE LEVEL EXPECTED: automated_verified for content authority.
COMMIT BOUNDARY: focused source/test push, fixed-source evidence, docs closure.
LEGAL TERMINAL: FG-3 Step 1 Contract-1 content and boards complete.
NEXT STEP: FG3-STEP-2.

Completed Step Evidence

FG3 Step 1 Contract-1 Content And Boards - 2026-08-16

  • Source 0208471d5b7bfbc070457c1708a389dd054ba5e4 adds only the isolated FG-3 catalog, validator, Market generator, two focused tests and their tracked UIDs.
  • Sixteen equipment rows complete EQ-041..080; four new Artifact rows plus inherited AR-011/012/015 complete the seven-ID Region pool. Both Boss identities, 15 routes and five Market boards have exact bilingual authority.
  • Markets 8-12 use exact 3/4/3 boards, capacities 7/8/8/9/9, offer levels 3/3/4/4/4 and rewards 36..58. Refresh changes Recruit/equipment rows only; route, tide and fixed BO-R2-01 facts never reroll.
  • R1 at /private/tmp/abg-fg3-0208471-step1-r1/evidence/ is append-only INVALID_PROCESS_POSTFLIGHT: its process query counted the controlling shell and rg command as Godot. Its functional results are not reused.
  • Fresh R2 is /private/tmp/abg-fg3-0208471-step1-r2/evidence/. Two FG-3 tests and two P10.3 regressions pass with strict diagnostics and owned processes zero. Audit SHA-256 is a1e43f049c65416b111880d04df6c031f89d50af7eb3521ccabb6a14cafe5d25; inventory SHA-256 is bc3505255ab6b6a5a995266511db0e27b3d44f5cc75d4578d8d50d74ab9dea48.
  • Step 1 reaches implemented + automated_verified. Save, battle, Boss and presentation facts remain unclaimed.

FG3 Step 2 Contract-1 Execution And Boss - 2026-08-16

  • Source 74dab244fc091e1e40a1e77933ad359368819096 adds Save v10, complete Contract-1 state, deterministic route/Boss battle authority, revision-bound transaction service, one real P10.3 Market-8 fixture and focused Save/round/Boss tests.
  • Save migration preserves exact Guild, Company, Recruit growth, equipment, economy, Artifact, promotion and seven-route state. Active/backup corruption, rollback, candidate interruption and all six zero-offline deltas pass.
  • Rounds 8-12 settle exact Coin/XP and capacities 8/8/9/9/10. Defeat removes one Fallen Recruit permanently, returns equipment, grants bounded Credit and recovers to the same board without reroll or resurrection.
  • BO-R2-01 exposes two legal plans and fixed index/egg facts. Victory pays no Coin, grants first-clear Renown 16, writes one CLEAR-RG02-C01 Company Record and opens CTR-R2-02 in the same Run.
  • R1 /private/tmp/abg-fg3-74dab24-step2-r1/evidence/ remains append-only INVALID_EVIDENCE_FINALIZATION because a post-inventory check file was left outside its 16-row inventory.
  • Fresh R2 /private/tmp/abg-fg3-74dab24-step2-r2/evidence/ passes a clean import, five FG-3 programs and four P10.3 regressions with strict diagnostics and owned Godot processes zero. Audit SHA-256 is a7c8ba5f7a7338c044ef16ebd94e9b48a6cef6c2cdd1e3133cc3d9793d27e8ad; inventory SHA-256 is c773f542b71fb0b2137a961a31c32e16f56b62927a43fbd6c086eea19117a183.
  • Step 2 reaches implemented + automated_verified; it makes no presentation, simulation, human, H5, device or release claim.

Later Step Boundaries

  • Step 2 alone owns Save-v9-to-v10 migration, Rounds 8-12, BO-R2-01, first Record and exact Contract-2 handoff.
  • Step 3 alone owns the second Contract's 36 route rows, deterministic boards and stable state/save extension; it cannot execute battle.
  • Step 4 alone owns second-Contract execution, BO-R2-02, second Record and RG-03 unlock.
  • Step 5 may extend FG-2 presentation adapters but cannot change simulation or settlement facts.
  • Step 6 may add only simulation, candidate and evidence harness code unless a declared gate exposes a product failure.

Issue Register

ID Status Boundary
FG3-I01 RESOLVED_CONTRACT Existing P10.1-P10.3 content is inherited by ID; FG-3 adds only missing rows and one complete graph instead of copying formulas.
FG3-I02 RESOLVED_STEP_2 Save v10 preserves exact Save-v9 Market 8 and recovery retains the same first Boss Muster without reroll.
FG3-I03 OPEN_STEP_4 Both Boss plans and all seven Region Artifacts require fixed valuation reversals before Region close.
FG3-I04 OPEN_STEP_5 Complete Region presentation must reuse FG-2 world-first adapters and avoid app/card fallback.