implements PLN-0172 runtime glyph palette handoff

This commit is contained in:
2026-07-14 15:54:28 +01:00
parent fbe4d0cac0
commit e2a5a67621
2 changed files with 50 additions and 2 deletions
@@ -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