Skip to content

Configuration lab: diagnose and repair ​

Complete negative examples and expected results ​

These ZIPs are intentionally invalid and intended for offline diagnosis, not working presets. Each applies one explicit edit to the same standalone color pack. The pinned Analyzer runs pack, graph and Program interface on source and fresh ZIP, expecting exit 1; restoring the original Manifest makes all three exit 0. The three cases total 27 actual calls.

unknown-provider · Expected rejection

Download intentionally invalid ZIP

1514ff3bd2bddf9f49a4ba3b4c6d105aa9aba3e91234d84b685a34d926d03bea

DLMAN0001 · shaderpack.json

/passes/0/commands/0/sceneProvider/id

SceneDraw Provider 'dawnlight:scene_draw/missing' is not registered.

Source + fresh ZIP: pack/graph/interface exit 1. Restored source: all three exit 0.

unknown-program · Expected rejection

Download intentionally invalid ZIP

0481381a1cdab5afe0635e3167eaa1130580ca96e3ea89ba2aea190b1f50516d

DLMAN0001 · shaderpack.json

/passes/4/commands/0/program

Program 'practice:post/missing' is not declared in $.passes[4].programs.

Source + fresh ZIP: pack/graph/interface exit 1. Restored source: all three exit 0.

history-on-persistent · Expected rejection

Download intentionally invalid ZIP

80ffb5751f733089490d4b7137ec1d4ca075f64250a2e0be0ef515c30bbd9e58

DLMAN0001 · shaderpack.json

/passes/4/commands/1/resource

History commit resource 'practice:post/color' must declare the history lifetime; found 'Persistent'.

Source + fresh ZIP: pack/graph/interface exit 1. Restored source: all three exit 0.

Exact edit recipes · Validation receipt

Read code, file and pointer ​

Extract unknown-provider into a fresh work directory and run these commands at its root. DLMAN0001 identifies file=shaderpack.json and pointer=/passes/0/commands/0/sceneProvider/id: the first Pass and first command, not a line number. The value is the unregistered dawnlight:scene_draw/missing. This version reports DLMAN0001 at the Loader layer; do not relabel it DLABI1002 based on meaning.

powershell
shaderpack-analyzer.exe pack validate . --format json
$LASTEXITCODE
shaderpack-analyzer.exe graph dump . --contract 2 --include-inactive
shaderpack-analyzer.exe program interface . --program practice:post/grade --contract 2

Repair one value, then repeat the loop ​

Restore the published Catalog v2 ID dawnlight:scene_draw/terrain_opaque and keep version 2. Repeat pack → scene → graph → interface. Failed graph/interface responses retain provenance; they do not supply a successful graph or driver observation. After repair inspect four BuiltIn routes, effect accesses and one present.

powershell
shaderpack-analyzer.exe pack validate . --format json
shaderpack-analyzer.exe scene explain . --include-inactive --format json
shaderpack-analyzer.exe graph dump . --contract 2 --include-inactive
shaderpack-analyzer.exe program interface . --program practice:post/grade --contract 2

For unknown-program restore practice:post/grade. For history-on-persistent remove the added historyCommit; a persistent texture does not acquire History writers/fallback simply by renaming it. Downloaded recipe JSON records every edit.

From repair to matching runtime evidence ​

Manual saving may change JSON bytes: a semantic repair no longer has the original ZIP’s source fingerprint. To reproduce this runtime record, freshly extract the valid color pack, check its inventory, then load, change options, reload, resize and return to BuiltIn in a creative world. Export that generation’s Scene report. The invalid Provider frame-bridge request timed out; runtime rejection and generation preservation remain unverified. See the actual record.

This lab supplies no RenderDoc, numeric data readback or performance gate. Messages provide context; stable location uses code/file/pointer and exact provenance.

Author documentation · Manifest v5 / Scene ABI v2