3.1 KiB
Packer binary contract fixtures
These expectations are authored from the published wire contract, independently
of the Java writer. They are not captured from packer output. Tests call the real
packWorkspace service and read the embedded header and payload of assets.pa;
JSON sidecars alone are not the oracle.
Reference snapshot: runtime f7d7c167531bb662a1af9d73fc326bb476bf8aa7:
docs/specs/runtime/15-asset-management.md, sections 3–4 and 9;crates/console/prometeu-hal/src/asset.rs, scene layout constants;crates/console/prometeu-drivers/src/asset/decode.rs, nibble and channel order.
The Studio producer's fixed 256×256 sheet and asset envelope are documented in
docs/specs/packer/4. Build Artifacts and Deterministic Packing Specification.md.
No runtime checkout, executable or decoder is needed to execute these tests.
Fixture interpretation
glyph-row.hex: eight indexed pixels0,1,2,3,0,1,2,3, high nibble first. The test repeats this row within the first 8/16/32-pixel tile and leaves the rest of the 256×256 sheet at index zero.glyph-colors.hex: four independent RGBA colors, including opaque index zero, partial alpha at index one, transparent index two and distinct channel values. Each palette has these four colors followed by twelve zero entries. Tests exercise 1, 3 and 64 palettes and compare the entire serialized bank.scene-v1.hex: a 12-byte SCNE/version-1/four-layer header followed by four 32-byte layer headers and one four-byte tile per layer. All layers are active, use glyph AssetId0x01020304(16909060, not its preload slot 1), tile size 8, parallax (1.0, 0.5), width/height/count 1 and zero reserved fields. Tile flags are 1/3/5/7, exercising both flip bits; palette is zero and glyph IDs are 0/1/2/3. Serialized size is 156; decoded size is 4 × (16 + 8) = 96.
The mixed-asset test includes an asset with preload disabled and two GLYPH
preloads in slots 0/1 plus a SCENE preload in slot 0. It checks payload-relative
nonzero offsets, stable IDs, no payload gaps/trailing bytes, and equality between
the embedded header and exported sidecars. The invalid-palette case verifies
that palette index 64 cannot publish a new assets.pa.
Existing FileSystemPackerWorkspaceServiceTest coverage remains responsible for
basic emission, sparse palettes, material remapping, frozen snapshots and
selected SCENE fields. These fixtures complement those tests at the complete
artifact boundary rather than porting the runtime's decoder corpus.
Execution and limits
./gradlew :prometeu-packer:prometeu-packer-v1:test --tests '*PackerAssetContractTest'
The suite also runs under ordinary ./gradlew test. ImageIO uses in-memory
images and temporary files; no display is needed. Fixtures never launch a
runtime, skip for missing runtime, or fall back to a simulated runtime.
Passing these tests demonstrates producer contract coverage, not runtime loading/rendering. Integrated verification is manual using existing games. Record the game, Studio/runtime revisions, actions and observed result when that verification is actually performed; do not infer a gameplay pass from these byte comparisons.