223 lines
13 KiB
Markdown
223 lines
13 KiB
Markdown
# 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
|
|
|
|
<!-- markdownlint-disable MD013 -->
|
|
|
|
| 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. |
|
|
|
|
<!-- markdownlint-enable MD013 -->
|
|
|
|
## FG4-STEP-1 Contract
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
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
|
|
|
|
<!-- markdownlint-disable MD013 -->
|
|
|
|
| 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. |
|
|
|
|
<!-- markdownlint-enable MD013 -->
|