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.
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.
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 2Repair 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.
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 2For 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.