implements PLN-0172 runtime glyph palette handoff
This commit is contained in:
@@ -2,7 +2,8 @@
|
||||
id: PLN-0172
|
||||
ticket: runtime-owned-variable-glyph-bank-palette-protocol
|
||||
title: Runtime Spec Handoff to Packer and Studio
|
||||
status: open
|
||||
status: done
|
||||
completed: 2026-07-14
|
||||
created: 2026-07-14
|
||||
ref_decisions: [DEC-0041]
|
||||
tags: [runtime, packer, studio, handoff, glyph-bank, palette-serialization]
|
||||
@@ -110,3 +111,50 @@ to lessons.
|
||||
- Downstream repositories may still treat `metadata.palette_authored` as
|
||||
authoritative; this plan must make runtime-effective metadata explicit.
|
||||
- Creating handoff text too early could freeze pre-implementation details.
|
||||
|
||||
## Handoff Note
|
||||
|
||||
Runtime is the protocol authority for `GLYPH/indexed_v1`. Downstream packer and
|
||||
studio work must follow the published runtime specs, not the historical studio
|
||||
agenda.
|
||||
|
||||
Canonical runtime references:
|
||||
|
||||
- `docs/specs/runtime/15-asset-management.md`, section `4.1 GLYPH asset
|
||||
contract in v1`
|
||||
- `docs/specs/runtime/04-gfx-peripheral.md`, section `19.4 Palette
|
||||
Association`
|
||||
- `docs/specs/runtime/04-gfx-peripheral.md`, section `20.1.b Scene dependency
|
||||
fatal boundary`
|
||||
- `docs/specs/runtime/04-gfx-peripheral.md`, section `20.2
|
||||
composer.emit_sprite`
|
||||
|
||||
Downstream producers must emit:
|
||||
|
||||
- `codec = NONE`
|
||||
- packed `u4` indexed pixels
|
||||
- RGBA8888 palette bytes in `R, G, B, A` order
|
||||
- root effective metadata fields `tile_size`, `width`, `height`, and
|
||||
`palette_count`
|
||||
- `palette_count` in `1..=64`
|
||||
- exactly `palette_count * 16 * 4` palette bytes
|
||||
- `size = ceil(width * height / 2) + palette_count * 16 * 4`
|
||||
- `decoded_size = width * height + palette_count * 16 * 4`
|
||||
|
||||
Downstream producers must not emit:
|
||||
|
||||
- sparse-to-dense palette remapping metadata for v1
|
||||
- a `GLYPH/indexed_v2` payload for this change
|
||||
- fixed 64-palette padding unless `palette_count = 64` and the payload
|
||||
directly satisfies the runtime v1 contract
|
||||
- effective runtime behavior based on `palette_authored`; that field is
|
||||
informative unless a later runtime spec promotes it to an effective root
|
||||
metadata field
|
||||
|
||||
Required downstream fixture coverage:
|
||||
|
||||
- one glyph bank with `palette_count = 1`
|
||||
- one glyph bank with an intermediate `palette_count`
|
||||
- one glyph bank with `palette_count = 64`
|
||||
- payload-size and decoded-size assertions for each fixture
|
||||
- a negative fixture or validation case for metadata/payload mismatch
|
||||
|
||||
Reference in New Issue
Block a user