Passes, Stages and execution order
Behavior and constraints
Pass id/enabled identifies a declaration; enabledWhen constrains activity. stage selects exact template/version/target/phase. Legacy host combinations remain separately represented in compatibility structure; host and stage are not freely interchangeable or combinable. command_list executes commands in authored order. Across Passes, ordering.after/before/requires and accesses determine order.
inputs/outputs declare resource access and programs lists callable Programs. They do not replace command bindings or attachments. Ordering IDs must resolve; requires is more than a weak hint. Reject reversed phases, cycles, missing dependencies and hazards in the candidate graph. Use generated Catalog/token data for phase names rather than a permanent fixed count.
Services use id/version with required/optional mode. Conditions and unavailable=disablePass affect the active closure. Published dependencies and executable factories must both agree; metadata registration alone is not execution support. optional does not let an active command ignore a required feature.
Inspect declared/active nodes, command occurrences, accesses and dependencies with graph dump. Program-less clear/copy/historyCommit commands still contribute resource or lifecycle relations and must not disappear from Program-only analysis.
Generated v5 structure
Required applies to the displayed object/branch. Absence of a Schema default does not establish a runtime default. Conditional rules remain in the complete definition below; Loader validation also resolves IDs, ownership, budgets and device limits.
pass · v5
| Field / branch | Presence in this object | Structural constraints |
|---|---|---|
commands | optional here | type="array"; items=#/$defs/command |
enabled | required | type="boolean" |
enabledWhen | optional here | type="array"; items=#/$defs/condition |
host | optional here | $ref="#/$defs/host" |
id | required | $ref="#/$defs/identifier" |
inputs | optional here | type="array" |
outputs | optional here | type="array" |
programs | optional here | type="array"; uniqueItems=true; items=#/$defs/identifier |
services | optional here | type="array"; items=#/$defs/service |
stage | optional here | $ref="#/$defs/stage" |
Full structural rule: #/$defs/pass
{
"additionalProperties": false,
"allOf": [
{
"not": {
"required": [
"stage",
"host"
]
}
}
],
"properties": {
"commands": {
"items": {
"$ref": "#/$defs/command"
},
"type": "array"
},
"enabled": {
"type": "boolean"
},
"enabledWhen": {
"items": {
"$ref": "#/$defs/condition"
},
"type": "array"
},
"host": {
"$ref": "#/$defs/host"
},
"id": {
"$ref": "#/$defs/identifier"
},
"inputs": {
"items": {
"oneOf": [
{
"$ref": "#/$defs/identifier"
},
{
"$ref": "#/$defs/resourceView"
}
]
},
"type": "array"
},
"outputs": {
"items": {
"oneOf": [
{
"$ref": "#/$defs/identifier"
},
{
"$ref": "#/$defs/resourceView"
}
]
},
"type": "array"
},
"programs": {
"items": {
"$ref": "#/$defs/identifier"
},
"type": "array",
"uniqueItems": true
},
"services": {
"items": {
"$ref": "#/$defs/service"
},
"type": "array"
},
"stage": {
"$ref": "#/$defs/stage"
}
},
"required": [
"id",
"enabled"
],
"type": "object"
}stage · v5
| Field / branch | Presence in this object | Structural constraints |
|---|---|---|
ordering | optional here | $ref="#/$defs/ordering" |
phase | required | enum=["modelShadow","framePrepare","shadow","opaque","sky","transparent","cloudReflection","shaftPrepare","shaftSun","cloud","particles","afterDraw","afterFinal","screenOutput"] |
target | required | enum=["world","afterDraw"] |
template | required | $ref="#/$defs/identifier" |
version | required | $ref="#/$defs/positiveVersion" |
Full structural rule: #/$defs/stage
{
"additionalProperties": false,
"properties": {
"ordering": {
"$ref": "#/$defs/ordering"
},
"phase": {
"enum": [
"modelShadow",
"framePrepare",
"shadow",
"opaque",
"sky",
"transparent",
"cloudReflection",
"shaftPrepare",
"shaftSun",
"cloud",
"particles",
"afterDraw",
"afterFinal",
"screenOutput"
]
},
"target": {
"enum": [
"world",
"afterDraw"
]
},
"template": {
"$ref": "#/$defs/identifier"
},
"version": {
"$ref": "#/$defs/positiveVersion"
}
},
"required": [
"template",
"version",
"target",
"phase"
],
"type": "object"
}host · v5
| Field / branch | Presence in this object | Structural constraints |
|---|---|---|
ordering | optional here | $ref="#/$defs/ordering" |
phase | required | enum=["modelShadow","framePrepare","shadow","opaque","sky","transparent","cloudReflection","shaftPrepare","shaftSun","cloud","particles","afterDraw","afterFinal","screenOutput"] |
target | required | enum=["world","afterDraw"] |
Full structural rule: #/$defs/host
{
"additionalProperties": false,
"properties": {
"ordering": {
"$ref": "#/$defs/ordering"
},
"phase": {
"enum": [
"modelShadow",
"framePrepare",
"shadow",
"opaque",
"sky",
"transparent",
"cloudReflection",
"shaftPrepare",
"shaftSun",
"cloud",
"particles",
"afterDraw",
"afterFinal",
"screenOutput"
]
},
"target": {
"enum": [
"world",
"afterDraw"
]
}
},
"required": [
"target",
"phase"
],
"type": "object"
}ordering · v5
| Field / branch | Presence in this object | Structural constraints |
|---|---|---|
after | optional here | type="array"; uniqueItems=true; items=#/$defs/identifier |
before | optional here | type="array"; uniqueItems=true; items=#/$defs/identifier |
requires | optional here | type="array"; uniqueItems=true; items=#/$defs/identifier |
Full structural rule: #/$defs/ordering
{
"additionalProperties": false,
"properties": {
"after": {
"items": {
"$ref": "#/$defs/identifier"
},
"type": "array",
"uniqueItems": true
},
"before": {
"items": {
"$ref": "#/$defs/identifier"
},
"type": "array",
"uniqueItems": true
},
"requires": {
"items": {
"$ref": "#/$defs/identifier"
},
"type": "array",
"uniqueItems": true
}
},
"type": "object"
}service · v5
| Field / branch | Presence in this object | Structural constraints |
|---|---|---|
enabledWhen | optional here | type="array"; items=#/$defs/condition |
id | required | $ref="#/$defs/identifier" |
mode | optional here | enum=["required","optional"] |
unavailable | optional here | enum=["disablePass"] |
version | required | $ref="#/$defs/positiveVersion" |
Full structural rule: #/$defs/service
{
"additionalProperties": false,
"properties": {
"enabledWhen": {
"items": {
"$ref": "#/$defs/condition"
},
"type": "array"
},
"id": {
"$ref": "#/$defs/identifier"
},
"mode": {
"enum": [
"required",
"optional"
]
},
"unavailable": {
"enum": [
"disablePass"
]
},
"version": {
"$ref": "#/$defs/positiveVersion"
}
},
"required": [
"id",
"version"
],
"type": "object"
}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 ·