Diagnostic code reference

Interpretation

Codes identify failure families; the message and source span explain the specific instance. The entries below cover significant current diagnostics, not a guarantee that every internal exception is a stable public enum. Syntax failure, unresolved geometry and runtime observation must not be conflated.

Causes and recovery

Code	Domain / cause	Example / resolution
BAD_UNIT	QWAY typed syntax	height=55kg: use a length unit such as 55cm.
UNKNOWN_COMMAND	Language	An invented command: use the actual signature reference.
MISSING_IDENTITY	QWAY bindings	Declaration without id or host binding: provide a stable UUID, not a changing alias-derived ID.
UNKNOWN_REFERENCE	QWAY	@missing: declare or correct the referenced alias.
WRIGHT_INVALID_MEMBERSHIP	WRIGHT topology	An object's room UUID does not exist in the topology: select an existing room UUID. Compilation rejects the scene; changing the object's alias cannot repair membership.
DUPLICATE_ALIAS	Language/identity	Two declarations reuse an alias: rename one without changing the intended UUID.
UNKNOWN_ASSET	Compiler	Asset ID outside pinned catalog: import/select a real asset.
MANIFEST_REQUIRED	Compiler dependencies	Object has no valid analysis pin: analyze and explicitly adopt a manifest.
CONTENT_MISMATCH	Asset integrity	Snapshot bytes/hash disagree: restore the exact pinned resource; do not bypass hash validation.
UNKNOWN_FEATURE	Manifest reference	Surface absent from pinned manifest: select a measured feature, not an invented label.
RELATION_CYCLE	Semantic graph	Cyclic placement dependencies: remove/restructure conflicting relations.
HARD_RELATION_FAILED	Independent geometry	Requested hard relation cannot be verified: inspect residual/collision evidence, revise intent.
MAINTAIN_UNSUPPORTED	Temporal semantics	Maintain requested where runtime enforcement is unavailable: use initial/monitor only if that matches intent.
ORIENTATION_UNCERTAIN	Normalization	Insufficient front/up evidence: inspect geometry and author explicit axes.
ORIENTATION_AXES_CONFLICT	Normalization	Up and forward conflict: choose distinct perpendicular axes.
WITHERS_SEMANTIC_APPROXIMATION	Semantic measurement	Withers estimated rather than exact: inspect confidence/reference; do not equate it to total mesh height.
SIZE_OVERRIDE_CONFLICT	Sizing intent	Conflicting explicit size instructions: retain one coherent target.
PHYSICAL_COMPATIBILITY	Physics compile	Motion/collider/controller combination unsafe: change explicit physical intent or supported shape.
STATIC_COLLIDER_MOTION	Physics compile	Static-only collider on moving body: select a supported moving-body collider.
ANIMATION_CLIP_UNKNOWN	Animation compile	Clip index absent from pinned asset: choose an actual clip.
UNKNOWN_ALIAS	RIDLEY	Shot references absent subject: bind an existing QWAY object.
ALIAS_REBOUND	RIDLEY identity	Alias now names another UUID: explicitly reconcile the binding.
INVALID_TIMING	RIDLEY	Negative/zero visible duration or timeline over budget: fix timing.
EXPLICIT_TRANSITION_REQUIRED	RIDLEY	Standalone cut/transition: put transition=cut\|smooth on destination shot.
STALE_CINEMATIC_WORLD	Runtime	Direction compiled against another world hash: recompile the same project coherently.
SUBJECT_FRAME_CLIPPED	Camera observation	Framing could not contain requested subject: inspect shot and scene obstruction.
TRANSITION_PATH_BLOCKED	Camera observation	Smooth path obstructed: revise movement/transition; no hidden wall deletion.
EVENT_CYCLE_BUDGET	Runtime bus	Reentrant event loop: simplify transitions/once policy.
WORLDPACK_INVALID_DRAFT	Export	Current source is not accepted: fix/compile before exporting.
WORLD_PLAYER_NOT_INTERACTIVE	Runtime	Dispatch during load or non-experience mode: await ready and select intended mode.