Diagnostic code reference
Behavior and constraints
Read exit status, then stable code, severity, family, evidence and authored provenance. Fix the first sourced error and rerun before treating cascading failures as independent causes. Explain warnings too: DLABI2005 on disabled Terrain can hide world content. Exit 0 does not mean warning-free or visually complete.
Original diagnostic titles, causes and shortest fixes are retained from pinned tool output; codes are not translated. The generated directory does not claim every diagnostic was triggered in this run. Missing driver/content evidence remains deferred/notProvided rather than being rewritten as success or failure.
Structured diagnostic shape
JSON results retain code/message/severity and applicable file, pointer, Program, resource and identifier/version context. Provenance can identify the pre-composition authored file while enginePath identifies the composed logical location. These are different paths. Legacy CLI/RPC envelopes follow the selected contract version.
DLMAN covers Loader configuration, DLABI Scene/interfaces, DLDATA materials/typed data, P9UI settings and DLTOOL tool/document contracts. Schema checks cover structure rather than these semantic diagnostics.
Generated diagnostic catalog
| Code | Family | Evidence | Severity | Title | Cause | Shortest fix | JSON example |
|---|---|---|---|---|---|---|---|
DLABI1001 | sceneAbi.catalog | resolved | error | Catalog Duplicate Registration | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1002 | sceneAbi.catalog | resolved | error | Catalog Unknown Identifier | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1003 | sceneAbi.catalog | resolved | error | Catalog Unsupported Version | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1004 | sceneAbi.catalog | resolved | error | Catalog Invalid Metadata | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1005 | sceneAbi.catalog | resolved | error | Catalog Missing Dependency | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI1006 | sceneAbi.catalog | resolved | error | Catalog Expected Hash Mismatch | An ID, version, dependency, metadata field, or expected Catalog hash is invalid. | Refresh Catalog v2 and author only published ID/version pairs. | shape |
DLABI2001 | sceneAbi.routeOwnership | resolved | error | Route Missing | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI2002 | sceneAbi.routeOwnership | resolved | error | Route Duplicate | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI2003 | sceneAbi.routeOwnership | resolved | error | Route Ownership Conflict | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI2004 | sceneAbi.routeOwnership | resolved | error | Route Mode Unsupported | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI2005 | sceneAbi.routeOwnership | resolved | error | Route Category Disabled | A category route is missing, duplicated, unsupported, disabled, or owned by the wrong Stage. | Declare exactly one allowed mode per category and keep override Stages pack-owned and active. | shape |
DLABI3001 | sceneAbi.targetState | resolved | error | Target Color Attachment Count Invalid | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3002 | sceneAbi.targetState | resolved | error | Target Output Location Invalid | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3003 | sceneAbi.targetState | resolved | error | Target Attachment Operation Invalid | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3004 | sceneAbi.targetState | resolved | error | Target Depth Attachment Missing | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3005 | sceneAbi.targetState | resolved | error | State Preset Unsupported | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3006 | sceneAbi.targetState | resolved | error | Target Viewport Policy Invalid | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI3007 | sceneAbi.targetState | resolved | error | Target Resource View Unsupported | The named target topology, attachment operation, state preset, or viewport policy is invalid. | Match the Provider target capability and keep named topology separate from active draw buffers. | shape |
DLABI4001 | sceneAbi.bindingInterface | resolved | error | Binding Unknown | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4002 | sceneAbi.bindingInterface | resolved | error | Binding Required Missing | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4003 | sceneAbi.bindingInterface | resolved | error | Binding Type Mismatch | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4004 | sceneAbi.bindingInterface | resolved | error | Binding Frequency Mismatch | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4005 | sceneAbi.bindingInterface | resolved | error | Binding Slot Conflict | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4006 | sceneAbi.bindingInterface | resolved | error | Shader Interface Mismatch | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4007 | sceneAbi.bindingInterface | resolved | error | Provider Service Closure Invalid | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI4008 | sceneAbi.bindingInterface | resolved | error | Provider Program Invalid | A Provider, Program, binding, slot, frequency, type, or shader interface does not match its public ABI. | Copy the required binding and vertex/output contract from Catalog v2 exactly. | shape |
DLABI5001 | sceneAbi.deviceFramebuffer | resolved | error | Device Limit Exceeded | A real device limit, format, attachment extent, or framebuffer completeness check failed. | Reduce targets or choose supported formats/extents, then verify on the target driver. | shape |
DLABI5002 | sceneAbi.deviceFramebuffer | resolved | error | Device Render Target Format Unsupported | A real device limit, format, attachment extent, or framebuffer completeness check failed. | Reduce targets or choose supported formats/extents, then verify on the target driver. | shape |
DLABI5003 | sceneAbi.deviceFramebuffer | resolved | error | Framebuffer Attachment Extent Mismatch | A real device limit, format, attachment extent, or framebuffer completeness check failed. | Reduce targets or choose supported formats/extents, then verify on the target driver. | shape |
DLABI5004 | sceneAbi.deviceFramebuffer | resolved | error | Framebuffer Incomplete | A real device limit, format, attachment extent, or framebuffer completeness check failed. | Reduce targets or choose supported formats/extents, then verify on the target driver. | shape |
DLABI6001 | sceneAbi.fallbackSource | resolved | error | Fallback Program Missing | A BuiltIn fallback Program or its owner-isolated source closure is missing or mixed. | Use the published BuiltIn recipe unchanged and never include across Pack/BuiltIn owner roots. | shape |
DLABI6002 | sceneAbi.fallbackSource | resolved | error | Fallback Source Owner Mixed | A BuiltIn fallback Program or its owner-isolated source closure is missing or mixed. | Use the published BuiltIn recipe unchanged and never include across Pack/BuiltIn owner roots. | shape |
DLABI6003 | sceneAbi.fallbackSource | resolved | error | Fallback Source Unavailable | A BuiltIn fallback Program or its owner-isolated source closure is missing or mixed. | Use the published BuiltIn recipe unchanged and never include across Pack/BuiltIn owner roots. | shape |
DLAST1001 | customData | resolved | error | Raw expression budget exceeded | Variable count or raw AST nodes, including inactive branches, exceed ABI v1 limits. | Reduce variables and raw expression size. | shape |
DLAST1002 | customData | resolved | error | Variable identifier is invalid | A variable ID is invalid or duplicated. | Use unique case-sensitive ABI identifiers. | shape |
DLAST1003 | customData | resolved | error | Expression signature is invalid | Types, literal/default lanes, function name or arity do not match the closed ABI. | Use exact typed operands and explicit casts or constructors. | shape |
DLAST1004 | customData | resolved | error | Dependency depth exceeded | A raw AST or cross-variable reference chain exceeds depth 64. | Flatten the expression and shorten reference chains. | shape |
DLAST1005 | customData | resolved | error | Variable dependency cycle | Variable references form a cycle, including inactive branches. | Remove cyclic references; recursive evaluation is unsupported. | shape |
DLAST1006 | customData | resolved | error | Expression reference is absent | A variable, named material constant or consumer variable cannot be resolved. | Declare the referenced ID and use the matching resolved material plan. | shape |
DLAST1007 | customData | resolved | error | Expression frequency is incompatible | The declared frequency is lower than an executable dependency or input availability. | Use frame/view frequency appropriate to the input contract. | shape |
DLAST1008 | customData | resolved | error | Weighted operation budget exceeded | The compiled generation/frame/view instructions exceed fixed type-weighted ABI limits. | Reduce expensive operations and reuse shared expressions. | shape |
DLAST1009 | customData | resolved | error | Typed input contract is unavailable | The exact input ID/version is unknown or a host input is used at generation frequency. | Use a published typed input with an exact version and legal frequency. | shape |
DLAST1010 | customData | resolved | error | Option expression is invalid | An option type, float32 range or finite string enum map is incompatible. | Match the option type; map every allowed string value to a finite scalar. | shape |
DLAST1011 | customData | resolved | error | Mandatory constant expression failed | A guaranteed constant operation divides by zero, overflows, casts illegally or produces a non-finite value. | Fix the reported node; useDefault does not hide mandatory compile-time faults. | shape |
DLAST1012 | customData | resolved | error | Input consumer lacks capability | A consumer lacks required world/frame/view, phase/category or service capabilities. | Provide the exact input capabilities at every consumer. | shape |
DLAST1013 | customData | resolved | error | Unit or coordinate space is incompatible | Known units or spaces conflict, or matrix source/target spaces cannot compose. | Preserve metadata and compose compatible transforms; casts cannot erase conflicts. | shape |
DLAST2001 | customData | resolved | warning | Declared frequency is unnecessarily high | The output variable is declared at a higher frequency than its executable dependencies. | Lower its declared frequency when consumers permit it. | shape |
DLCONTENT1001-DLCONTENT1004 | contentIdentity | importedSnapshot | error | Content snapshot rejected | The snapshot exceeds budgets, has invalid identities/hash or belongs to a stale world. | Export a fresh WorldFinal snapshot and resolve against its exact identity. | shape |
DLDATA1001 | dataAbi | authored | error | Data execution is unsupported | A host predating the P11 data ABI cannot execute the declared module. | Use a P11-capable host and Manifest v5 or omit the unsupported module. | shape |
DLDATA2001-DLDATA2002 | dataTools | resolvedOffline | error | Data explanation rejected | The request contract or production data plan is invalid. | Use data requestVersion 1 and fix the reported source file/pointer. | shape |
DLDATA3001 | dataDriver | publishedDataInterface | error | Data driver evidence rejected | The version, hash, published identity or linked layout/location is invalid. | Export a fresh v5 data-driver report from the exact world/generation. | shape |
DLGRAPH0001-DLGRAPH0004 | graph | resolved | error | Graph request rejected | The graph contract, Catalog identity, manifest identity, or Program selection is incompatible. | Refresh Catalog v2 and repeat the request with a supported graph contract. | shape |
DLGRAPH0101-DLGRAPH0102 | graph | resolved | warning | Graph evidence is partial | An optional service or offline BuiltIn source could not be projected. | Inspect the message; ship the required host service or treat BuiltIn source as descriptor-only. | shape |
DLGRAPH1001-DLGRAPH1002 | graph | resolved | information/error | Resource hazard direction | Two command accesses require an explicit or inferred ordering. | Add a valid dependency/order edge when the diagnostic is an error. | shape |
DLGRAPH1101-DLGRAPH1102 | graph | resolved | information/error | Mixed legacy hazard direction | A command access overlaps a legacy Stage access. | Add an order compatible with both the command and legacy Stage. | shape |
DLGRAPH1201 | graph | resolved | information | Read-modify-write access | One command reads and writes the same resource. | No action is needed unless the command did not intentionally request read-modify-write. | shape |
DLMAN0001-DLMAN0099 | manifest | authored | error | Manifest validation failure | The production Loader rejected one or more authored values. | Fix the first reported file and JSON pointer, then validate again. | shape |
DLMAN0101 | manifest | authored | warning | Optional Catalog reference unavailable | An optional service reference is not registered by this host. | Remove the optional reference or install a host that publishes it. | shape |
DLMAT1001 | materialAbi | authored | error | Material table declaration is invalid | The pack has multiple tables or lacks Manifest v5/materials ABI v1. | Declare one persistent buffer with materialTable version 1. | shape |
DLMAT1002 | materialAbi | resolved | error | Material table has an invalid consumer or writer | A writer, host storage alias, or non-storage binding targets the immutable table. | Use explicit readOnly storageBuffer command bindings and allocator-owned storage. | shape |
DLMAT1003 | materialAbi | resolved | error | Material Program binding conflicts | Program invocations disagree on table binding, symbol, or SSBO slots. | Give every invocation the same table binding; use Program variants for different contracts. | shape |
DLMAT1004 | materialAbi | driverObserved | error | Material table device limit or upload failure | The payload, SSBO slot, or stage/combined block count exceeds the actual device limit, or upload fails. | Reduce the table or choose available SSBO bindings; inspect the GL error. | shape |
DLMAT1005 | materialAbi | staticSource | error | Material block source violates ABI v1 | The readonly std430 block, highp uvec4 layout, or precision does not match its invocation. | Include /dawnlight/materials-v1.glsl or author the exact documented raw block. | shape |
DLMAT1006 | materialAbi | driverObserved | error | Linked material block violates ABI v1 | The driver reports a missing block, wrong binding/type/offset/stride, or reflection error. | Keep the block active and inspect the linked driver layout before publication. | shape |
DLPROGRAM0001 | program | resolved | error | Program is absent | The requested Program is not in the resolved graph. | Use a Program ID from graph v2 or enable the Stage that owns it. | shape |
DLPUBLISH1101-DLPUBLISH1104 | p11Release | acceptance | error | P11 publication rejected | The independent acceptance matrix is pending, stale, incomplete or has mismatched evidence files. | Complete every P11 dimension including performance, preserve full input identities and evidence hashes. | shape |
DLREPORT0000-DLREPORT0020 | driverReport | driverObserved | error | Driver report is invalid | The report format, hash, ordering, path safety, generation inputs, or native identity is invalid. | Export a fresh report from the published generation and do not edit it. | shape |
DLREPORT0101-DLREPORT0104 | driverReport | driverObserved | warning/error | Driver evidence is partial | A prepared command, Program, or FBO row has incomplete evidence. | Re-export after the generation finishes preparing; do not promote partial evidence. | shape |
DLREPORT1001-DLREPORT1010 | driverReport | driverObserved | error | Driver report is stale | Pack, Manifest, Catalog, source, generation inputs, epoch, or owner identity changed. | Export a new report from the exact currently published generation. | shape |
DLSCENE0001-DLSCENE0005 | scene | resolved | error | Scene explanation rejected | The Scene explain version, Catalog, route count, or route projection is invalid. | Refresh Catalog v2 and fix the authored route identified by provenance. | shape |
DLSCENE0100 | scene | resolved | information | Legacy Manifest has no Scene routes | Manifest v3 uses the legacy pipeline and cannot expose Manifest v4 route records. | Migrate to Manifest v4 only when Scene category control is required. | shape |
DLSCHEMA1001-DLSCHEMA1003 | schema | authored | error | Schema operation rejected | The version, output path, or managed output tree is invalid. | Use version 3, 4 or 5 and an explicit empty or schema-managed directory; keep the v5 bundle separate. | shape |
DLSCHEMA2001-DLSCHEMA2002 | schema | authored | error | Schema bundle differs | A generated artifact is missing or does not match the code-owned bytes. | Regenerate into staging, review the diff, then run schema approve explicitly. | shape |
DLSHADER0301-DLSHADER0302 | shader | staticReflection | error | Shader preprocessing failure | A source/include path or preprocessor conditional is invalid. | Fix the reported source line and keep includes inside the selected owner root. | shape |
DLTOOL1001-DLTOOL1002 | tool | authored | error | Unsafe documentation output | A documentation path is implicit, unsafe, reparse-backed, or non-empty. | Use an explicit empty temporary directory outside the read-only publish tree. | shape |
DLTOOL2001-DLTOOL2004 | tool | authored | error | Documentation contract mismatch | A guide fence, file tree, path, or generated diagnostic table drifted. | Restore file= markers and regenerate the checked table from the code-owned Catalog. | shape |
DLVIS3001-DLVIS3008 | visualEvidence | driverObserved | error | Driver/RenderDoc cross evidence rejected | The observation, matched report, Program interface, event topology, or resource chain is invalid. | Re-export the exact generation report and recollect the selected RDC events before visual review. | shape |
Complete examples
Sources and machine records
Coverage inventory · Schema v5 · Catalog v2 · Completion v2
schema-v3 · schema-v4 · schema-v5 · completion-v1 · completion-v2 · temporal · settings-guide ·