docs: close FG-4 Step 2

This commit is contained in:
2026-08-16 22:55:25 +08:00
parent 3ce6f89f0e
commit bb904cd9bf
4 changed files with 141 additions and 9 deletions
@@ -102,6 +102,6 @@ signing, device installation, stores and publishing remain outside this plan.
## Immediate Next Action
Implement FG4 Step 2 only: migrate the exact FG-3 RG-02 close into Save v11,
then execute RG-03 Contract 1, Furnace That Walks and permanent-loss recovery
without adding presentation, media, simulation or delivery behavior.
Implement FG4 Step 3 only: add and execute the second twelve-Market Emberloom
Contract, Foreman Nine-Sparks, the second RG-03 Record and exact RG-04 unlock
through the existing Save-v11 authority without presentation or delivery work.
+69 -3
View File
@@ -1,7 +1,7 @@
# FG-4 Midgame RG-03 And RG-04 Implementation Plan
> Status: `ACTIVE`
> Active step: `FG4-STEP-2`
> 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`
@@ -20,8 +20,8 @@ H5 checkpoint without resetting carried consequences.
| --- | --- | --- | --- |
| `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 | `IN_PROGRESS` | The carried Company clears twelve Rounds and Furnace That Walks or recovers from loss. | Save migration, shared state/transactions, battle/Boss tests. |
| `FG4-STEP-3` RG-03 Contract 2 and close | `PENDING` | Foreman Nine-Sparks falls, two Records persist and RG-04 opens. | Second 36 routes/12 boards, execution, exact close and regressions. |
| `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. |
@@ -100,6 +100,44 @@ 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
@@ -124,6 +162,34 @@ NEXT STEP: FG4-STEP-3.
- 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,