docs(fg4): close Quillroot content step

This commit is contained in:
2026-08-17 02:51:57 +08:00
parent 7cbdcc4651
commit bbbbb370d3
5 changed files with 154 additions and 8 deletions
+79 -3
View File
@@ -1,7 +1,7 @@
# FG-4 Midgame RG-03 And RG-04 Implementation Plan
> Status: `ACTIVE`
> Active step: `FG4-STEP-6`
> Active step: `FG4-STEP-7`
> Activation baseline: `fe90d6fac57e19df68e27fd4286575aac2c52d64`
> Goal: `docs/goals/FG4_MIDGAME_RG03_RG04_GOAL.md`
> Contract: `docs/runtime/FG4_MIDGAME_RG03_RG04_CONTRACT.md`
@@ -24,8 +24,8 @@ H5 checkpoint without resetting carried consequences.
| `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 | `IN_PROGRESS` | Twenty-four Quillroot Markets disclose copy, redirect, cleanse and clause decisions. | 40 equipment, 8 Artifacts, 12 enemies, 2 Boss descriptors, 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-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 | `IN_PROGRESS` | 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. |
@@ -257,6 +257,54 @@ 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
```text
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.
```
## Completed Step Evidence
### FG4 Step 1 RG-03 Contract-1 Content Authority - 2026-08-16
@@ -401,6 +449,33 @@ NEXT STEP: FG4-STEP-7 executes CTR-R4-01 through The Walking Index.
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.
## Later Step Boundaries
- Step 4 may generate and bind only RG-03 presentation media/audio inside the
@@ -427,5 +502,6 @@ NEXT STEP: FG4-STEP-7 executes CTR-R4-01 through The Walking Index.
| `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. |
<!-- markdownlint-enable MD013 -->