Files
aetherbound-guild/docs/runtime/fg4/media/REQUEST_LEDGER.md
T

92 lines
5.1 KiB
Markdown

# FG-4 RG-03 Image Request Ledger
> Provider: API Mart `gpt-image-2`
> Task ceiling: four paid calls and USD 5 equivalent total
> Paid calls used: four
> Total cost: USD `0.056` / `0.56` credits
> Status: `CALL_CEILING_REACHED`
## Dynamic Slice Boundary
FG-4 Step 3 proves the complete RG-03 state and battle authority, but RG-03
does not yet exist in the accepted landscape world runtime. Reusing Siltwake
would hide the valve, heat, construct, repeat and spark-promotion decisions;
building a Region-specific card page would violate the active contract.
The bounded request set is therefore exactly:
1. one Emberloom three-band environment source;
2. one two-cell Boss identity anchor source;
3. one replacement Boss anchor source after attempt 01 failed the exact
eight-spark identity count; its body/material identity is locked while
repeated spark count moves to deterministic runtime composition;
4. one combined two-row Boss action plus twelve-enemy identity sheet after the
replacement anchors pass.
No UI, text, Company redesign, RG-04 asset, video, music or SFX generation is
authorized by this ledger. A provider failure may be retried only while the
total submitted paid requests remains within the four-call task ceiling.
## Production Contract
- Runtime target: Godot landscape `844x390`, logical world `422x195@2x`.
- First focal read: the active Emberloom threat or Boss on the right lane.
- Second focal read: valve/heat/construct or repeat/spark state around the line.
- Third focal read: one primary command in the lower HUD.
- Visual identity: true low-grid Japanese fantasy pixel art; soot-black iron,
oxidized brass, kiln ivory, ember red and cyan-white pressure highlights.
- Environment output is one source with three separable horizontal bands.
The background band is opaque; midground and foreground use removable
magenta. Actor and prop sheets use removable magenta throughout.
- Every subject remains full-body, side-view, centered, uncropped and readable
at `36-96` logical pixels. Boss action rows preserve the accepted body
anchor. One processed spark identity is repeated in eight fixed world slots;
the image model never owns authoritative spark count.
- Generated pixels are raw sources only. Deterministic chroma removal, grid
extraction, palette limiting, pixel-cluster conversion, manifest binding,
Godot import and normal-render review remain mandatory.
- No labels, frame numbers, borders, UI, logos, watermarks, third-party
characters, detached effects, shadows, scenery inside actor cells or text.
## Planned Calls
<!-- markdownlint-disable MD013 -->
| Call | Prompt | References | Size | Resolution | Planned output | Status |
| --- | --- | --- | --- | --- | --- | --- |
| `FG4-IMG-01` | `prompts/emberloom-layers.prompt.txt` | accepted Siltwake layer source | `3:4` | `2k` | three separable Emberloom environment plates | `ACCEPTED_SOURCE` |
| `FG4-IMG-02` | `prompts/rg03-boss-anchors.prompt.txt` v1 | accepted FG-3 Boss pixel language | `16:9` | `2k` | Furnace and Foreman identity anchors | `REJECTED_IDENTITY_COUNT` |
| `FG4-IMG-03` | `prompts/rg03-boss-anchors.prompt.txt` v2 | rejected attempt only for material/scale vocabulary | `16:9` | `2k` | Furnace, Foreman body and one spark identity source | `PARTIAL_SOURCE_LOCKED` |
| `FG4-IMG-04` | `prompts/rg03-boss-actions-enemies.prompt.txt` | locked `FG4-IMG-03` plus accepted FG-3 actor language | `3:4` | `2k` | eight Boss action frames and twelve enemy anchors | `ACCEPTED_SOURCE` |
<!-- markdownlint-enable MD013 -->
## Acceptance
- Exactly four completed provider task IDs and recorded returned costs.
- Three environment layers at `380x180`, `422x195` and `320x180`, palette no
larger than 32 colors, binary alpha and integer `2x` pixel clusters.
- Twelve distinct RG-03 enemy identities, each in the declared cell with no
crop, neighbor debris or chroma. Valve, construct, repeat and spark state are
deterministic world/VFX primitives bound to authoritative events.
- Both Bosses retain one locked identity and four readable action frames with a
stable baseline, pivot, scale and `8 FPS` non-loop timing.
- Runtime evidence, not this ledger, proves integration and presentation.
## Completed Requests
- `FG4-IMG-01`: task `task_01M05MHAPX586RQDE8FC5XZYP8`, USD `0.014`;
accepted as the three-band Emberloom source.
- `FG4-IMG-02`: task `task_01M05MKQJ9YG7YZ1BZ5WMQFZYK`, USD `0.014`;
Furnace identity passes, but the Foreman has seven rather than exactly eight
tethered sparks. The raw source and report remain append-only attempt 01 and
no runtime asset may derive from it.
- `FG4-IMG-03`: task `task_01M05MV77JF5X2VT93EYREED3E`, USD `0.014`;
body, harness, material and individual spark identity pass, but the model
again emitted seven sparks. Runtime processing must remove repeated raw
sparks, retain one source-bound spark identity and compose exactly eight
slots from gameplay state. No runtime count may be inferred from this raw.
- `FG4-IMG-04`: task `task_01M05N7A7HQ13BVFNBFR0GXDQ1`, USD `0.014`;
accepted as two coherent four-frame Boss body rows plus twelve ordered enemy
anchors. Foreman action rows correctly contain no repeated spark objects.