Render Preview Runbook

Service owner: GUI/engine render workflow owner

Criticality: high for local authoring and review, medium for AI-related paths

Support model: engineering support during active development and release review

Primary owner: core engine/render owner

Secondary owner: GUI owner

AI-related secondary owner: normalization adapter owner

repeated render failures for valid published compositions

repeated params parsing failures on normal user input

version list not matching repository state

normalized output stale-state behaving incorrectly

copy actions silently failing

invalid versionText

invalid paramsText

selected composition missing from repository after reload

missing or unresolved block ref during render

missing normalizer configuration

provider failure during normalization

verify selected composition and version still exist

verify render path works without normalization

verify projectKey and dataPath did not unexpectedly change session state

inspect engine error surfaced in UI

if issue is normalization-only, keep deterministic render available and disable AI expectation in triage

if normalization unavailable:

keep Raw and Rendered modes operational

if render fails due to asset/data issue:

preserve UI state and explicit error text

if clipboard unavailable:

keep preview available without copy support

reload compositions list

repeat preview with known-good published composition

render with empty params, then with representative params

trigger normalization and verify stale-state after source change

Team Lead: render workflow owner

Core owner: deterministic renderer owner

GUI owner: render screen owner

AI owner: normalization adapter owner