@plasius/gpu-demo-viewer 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -6,6 +6,44 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 
 ## [Unreleased]
 
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.1.8] - 2026-10-18
+
+- Consume released renderer 0.2.51 and shared 1.1.8 for responsive camera updates and material reuse on repeated modular-kit meshes.
+
+- Export the existing bounded Node asset-acquisition helper for hash-pinned build-time consumers; record five further acquired foliage/terrain models and four LOD holds.
+
+- Prepare six original Poly Haven models for the next review batch and bound acquisition to an explicitly selected batch.
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [0.1.7] - 2026-10-18
+
+- Exclude Gem at user request and record the original Amber fixed-transport qualification; the production target is 74 models.
+
+- Track all 75 model candidates, their first-twelve/seven-batch membership and explicit acquisition, held and production states before the later voxel pass.
+
 - **Added**
   - (placeholder)
 
@@ -187,3 +225,5 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 [0.1.4]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.4
 [0.1.5]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.5
 [0.1.6]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.6
+[0.1.7]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.7
+[0.1.8]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.8

package/README.md

@@ -151,13 +151,13 @@ fallback. Rollback disables CD; it never rewrites published package history.
 
 ## Model library review
 
-`npm run models:download` installs the ten reviewed, freely licensed Poly Haven and Khronos fixtures from `model-library/catalogue.json`, including all buffer/image dependencies. Downloads are bounded and SHA-256 checked; binaries are ignored by Git and npm. `npm run models:dev` opens the localhost server on port 5291. Visit `http://127.0.0.1:5291/?review=first-twelve`. The Medieval house is a manually supplied eleventh asset; only Gem remains deferred. Source links, creators and licences are available beside each model.
+`npm run models:download` installs the ten reviewed, freely licensed Poly Haven and Khronos fixtures from `model-library/catalogue.json`, including all buffer/image dependencies. Downloads are bounded and SHA-256 checked; binaries are ignored by Git and npm. `npm run models:dev` opens the localhost server on port 5291. Visit `http://127.0.0.1:5291/?review=first-twelve`. The Medieval house is a manually supplied eleventh asset; Gem is excluded from the rollout by request. Source links, creators and licences are available beside each model.
 
 For Medieval house, obtain the original GLB from its credited Sketchfab source and place it at `model-library/assets/sf-house/medieval_house.glb`, then run `npm run models:download` to verify its pinned size and SHA-256 and write its credits. This command never downloads manual assets; a missing file produces an explicit placement message. The catalogue stores no private local paths.
 
 This page consumes the shared model-inspection package entrypoint. While its upstream release is pending, development testing can set `PLASIUS_SHARED_INSPECTION_SOURCE` to an absolute path to the reviewed sibling `src/model-inspection.js`; this explicit source override is for localhost development only, not a released dependency or production deployment.
 
-Mouse/touch/keyboard inspection reuses the material-study camera. The view progressively refines while the camera is still, stopping at the selected sample target. `Home` restores framing and `?` displays a brief gesture reminder. Resizing updates resolution while preserving the camera. Fox is static here; its Survey, Walk and Run clips remain in the original download. Amber currently exposes a visible transmission/volume rendering defect. See `docs/model-library-review.md` for the initial findings; none of these fixtures is implicitly approved for the production showcase.
+Mouse/touch/keyboard inspection reuses the material-study camera. The view progressively refines while the camera is still, stopping at the selected sample target. `Home` restores framing and `?` displays a brief gesture reminder. Resizing updates resolution while preserving the camera. Fox is static here; its Survey, Walk and Run clips remain in the original download. Amber uses the fixed-continuation correction in renderer 0.2.50; its original materials are unchanged. See `docs/model-library-review.md` for the initial findings; none of these fixtures is implicitly approved for the production showcase.
 
 Render-quality controls select 8–256 total samples, 2–12 light bounces, 480/800/1280px render width and denoising. Defaults are 64/6/800/on. The first pass is one sample; idle refinement adds up to four samples per batch. Camera and quality changes restart history. Hidden tabs pause further work; the progress bar reports completed samples and actual dimensions. Settings do not reload the source model.
 
@@ -165,4 +165,39 @@ During upstream progressive-renderer development, also set `PLASIUS_RENDERER_SOU
 
 The model review includes native 1920 × 1080, 2560 × 1440 and 3840 × 2160 quality presets. These trace the exact selected pixel dimensions independently of viewport size; the canvas contains the image without stretching. A one-sample target supports quick full-resolution checks. See [UHD inspection design](docs/model-inspection-uhd.md).
 
-The released model review uses fixed progressive sampling with native UHD sizes and requires renderer0.2.49/shared1.1.7 or newer. Adaptive controls remain in a separate qualification branch. See [release scope](docs/model-review-release.md); the local inspection catalogue explicitly retains unresolved visual findings.
+The released model review uses fixed progressive sampling with native UHD sizes and requires renderer 0.2.51/shared 1.1.8 or newer. Adaptive controls remain in a separate qualification branch. See [release scope](docs/model-review-release.md); the local inspection catalogue explicitly retains unresolved visual findings.
+
+## Complete model catalogue rollout
+
+The [74-model production rollout](docs/catalogue-production-rollout.md) tracks the
+eleven retained originals and seven subsequent batches of nine. The research
+manifest retains the excluded Gem identity, making 75 research records. `model-library/rollout.json`
+records acquisition/qualification state separately from production entitlement;
+`research-catalogue.json` preserves the original source identities and credits.
+Ten models are currently production-verified. Amber is locally qualified with renderer 0.2.50 and awaits production verification; Gem is excluded by request. Research entries are not a claim of downloaded or working
+models. Voxel conversion is the following pass after original-model production
+qualification. GitHub Story [2308](https://github.com/Plasius-LTD/plasius-ltd-site/issues/2308)
+owns delivery and acceptance.
+
+### Review batch downloads
+
+`npm run models:download -- 1` acquires only the six checked Poly Haven models
+in the first follow-on batch. The default remains batch 0 (the original group).
+Each batch retains the existing 200 MiB total and 100 MiB per-file download
+limits, two workers and exact hashes. Downloaded models are candidates, not
+production approvals. The local workshop includes acquired candidates with
+their source credits; production remains a separately qualified catalogue.
+
+### Build-time model acquisition
+
+Node consumers may import `acquisitionPlan` and `acquireFixtures` from
+`@plasius/gpu-demo-viewer/model-library/acquire`. Pass reviewed asset metadata
+and a destination root; the helper verifies exact bytes and SHA-256, uses only
+approved HTTPS providers without redirects, and bounds concurrency, time and
+bytes. Select one explicit reviewed batch per call (200 MiB total / 100 MiB per
+resource maximum). Existing files must match; missing manual sources fail closed.
+This Node subpath is build tooling and must not enter browser bundles. Binary
+assets are not included in the npm package. Site build-time use retains stricter
+resource limits and verifies the complete source dependency closure.
+
+The review now consumes published renderer 0.2.51 and shared 1.1.8: camera movement reuses unchanged scene geometry, and repeated source primitives share their authored materials during import.

package/docs/adrs/adr-0005-build-time-model-acquisition-subpath.md

@@ -0,0 +1,19 @@
+# ADR 0005: Share the bounded Node model acquisition helper
+
+Accepted for staged delivery, 18 October 2026. Feature site#1170, Story site#2308,
+Task #62. The growing original-model catalogue must not put every source binary
+in site Git history or duplicate the reviewed acquisition implementation.
+
+Expose `model-library/acquire.js` as `@plasius/gpu-demo-viewer/model-library/acquire`.
+This is a Node-only tooling boundary; browser entrypoints and public runtime APIs
+remain unchanged. Preserve existing provider allowlists, SHA-256/length checks,
+redirect rejection, two workers, deadlines, manual-source admission and byte
+budgets. Callers select explicit batches and may impose tighter constraints.
+
+The site materializes reviewed sources during normal CI/builds, then tests the
+complete output and embeds it in its approved deployment artifact. A missing or
+changed provider source fails the build. Original bytes and credits remain
+traceable; package tarballs contain metadata/tools, never source binary bundles.
+
+Export regression, existing acquisition failure tests, combined LCOV and approved
+package CI/CD are required before the site consumes this boundary.

package/docs/adrs/index.md

@@ -6,3 +6,5 @@
 - [ADR-0002: Hosted OIDC Package Publication](./adr-0002-hosted-oidc-package-publication.md)
 
 - [ADR 0003: Reviewed model library](adr-0003-reviewed-model-library.md)
+
+- [ADR 0005: Build-time model acquisition subpath](adr-0005-build-time-model-acquisition-subpath.md)

package/docs/amber-fixed-qualification.json

@@ -0,0 +1,54 @@
+{
+  "date": "2026-10-18",
+  "rendererCorrectionCommit": "ad52d1124455807cc1355525ab9ec0c2a9b9637b",
+  "releasedBaseline": "0.2.49",
+  "candidateVersion": "0.2.50",
+  "sourceAssetsUnchanged": true,
+  "matchedComparison": {
+    "samples": 256,
+    "maxDepth": 6,
+    "width": 800,
+    "height": 282,
+    "denoise": false
+  },
+  "nativeUhd": {
+    "width": 3840,
+    "height": 2160,
+    "samples": 1,
+    "maxDepth": 6,
+    "denoise": true
+  },
+  "cameraReset": {
+    "before": 256,
+    "afterMovement": 0,
+    "refined": 256
+  },
+  "proof": [
+    {
+      "file": "released-256.png",
+      "sha256": "98e8243c5deb8bd80352af9ea24bdaf924b981be0f3495f6920530b6bccdc881"
+    },
+    {
+      "file": "bounded-256.png",
+      "sha256": "981c87a2780b779a9fc54f6d18b1cf920538aea08b5f062f5c1828cc5f23988a"
+    },
+    {
+      "file": "bounded-256-denoised.png",
+      "sha256": "23f414fe11cc727057d8b81e0c9533c8cbbcfd91f10e9a33a51126afb20bd61b"
+    },
+    {
+      "file": "Amber-UHD-1.png",
+      "sha256": "58ac9b4cda4df5f21ad21e7d7ce9718f3606646af0535cf8412b4471e29a2961"
+    },
+    {
+      "file": "Amber-camera-refined.png",
+      "sha256": "e3670b2bbc302206f533a661388177069e1d61dd382121c39e5b50de43139e0d"
+    }
+  ],
+  "limits": [
+    "Fixed sampling only; experimental adaptive transport remains unqualified.",
+    "UHD at one sample demonstrates admission and dimensions, not matched-quality or real-time performance.",
+    "Fox is static; source animations are retained but not played.",
+    "Physical touch and screen-reader speech have not been tested."
+  ]
+}

package/docs/batch-one-qualification.json

@@ -0,0 +1,161 @@
+{
+  "date": "2026-10-18",
+  "renderer": "0.2.50",
+  "sharedSource": "3d119868bb9be471f71e04e1e91ed467a958b2d6",
+  "mode": "fixed-progressive",
+  "sourcePolicy": "Original source resources unchanged; default modular-kit layouts retained.",
+  "productionVerified": false,
+  "limitations": [
+    "No adaptive transport qualification.",
+    "Static geometry only; no animation entitlement implied.",
+    "This is a source-model inspection catalogue, not assembled cinematic scenes.",
+    "Dandelion source contains five widely spaced plants; use camera approach/truck for leaf detail.",
+    "Physical touch hardware and screen-reader speech were not tested."
+  ],
+  "models": [
+    {
+      "key": "large_iron_gate",
+      "triangles": 38140,
+      "primitives": 4,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Large-Iron-Gate.png",
+          "sha256": "c1b6d1d907ef6dc24a2483b44b035b834dac306c780e1a3e8d05164f4bb93892"
+        },
+        {
+          "file": "Large-Iron-Gate-UHD.png",
+          "sha256": "94c3b333073b0cd572fd1f93bb1176a4caf697c3c10b48c901e7136e7d8b557c"
+        }
+      ]
+    },
+    {
+      "key": "modular_factory_facade",
+      "triangles": 175014,
+      "primitives": 263,
+      "materials": 6,
+      "completedFixedSamples": 64,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Modular-Factory-Facade.png",
+          "sha256": "afb015f2d620513b3bb88bff49df06948100fb76e9696cd5296e1da217228f25"
+        },
+        {
+          "file": "Modular-Factory-Facade-UHD.png",
+          "sha256": "6ec1279c040cb6af2d3aeb290e6c40ad3a35548882406cf659a98c3358e9f8fe"
+        }
+      ]
+    },
+    {
+      "key": "modular_fort_01",
+      "triangles": 28218,
+      "primitives": 45,
+      "materials": 3,
+      "completedFixedSamples": 64,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Modular-Fort-01.png",
+          "sha256": "c2a9b7fc1124946ed1ffc9f5cf710752422221581df81699229ff7236bd66503"
+        },
+        {
+          "file": "Modular-Fort-01-UHD.png",
+          "sha256": "992eec049485a2ba1a90ee1c3097cafdec0f7ab00220423d9e8eb5de7daba0ec"
+        }
+      ]
+    },
+    {
+      "key": "modular_urban_apartments_facade",
+      "triangles": 270045,
+      "primitives": 193,
+      "materials": 5,
+      "completedFixedSamples": 64,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Modular-Urban-Apartments-Facade.png",
+          "sha256": "0de5ba7e3e084477d871ea6a3d87d462c2cc848568184a5706ee905698ff27f7"
+        },
+        {
+          "file": "Modular-Urban-Apartments-Facade-UHD.png",
+          "sha256": "da58feb5597d1642b672812333a8d3b4591dd02288cee0ca6f00c7ddb2459935"
+        }
+      ]
+    },
+    {
+      "key": "modular_wooden_pier",
+      "triangles": 84780,
+      "primitives": 12,
+      "materials": 2,
+      "completedFixedSamples": 64,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Modular-Wooden-Pier.png",
+          "sha256": "6417b2f48258bdcaa29447984c65b504ce6e8d5b61ec5b695d3045dc3fb9afc1"
+        },
+        {
+          "file": "Modular-Wooden-Pier-UHD.png",
+          "sha256": "11625d3cb251e7fb45f125b17ed67044a8fea737d1c333713893de1dd704eb73"
+        }
+      ]
+    },
+    {
+      "key": "dandelion_01",
+      "triangles": 54764,
+      "primitives": 5,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Dandelion-01.png",
+          "sha256": "eba0dfe86dca4bfdd37203e44e9041fa832f21f6329ee57d5b8316c35bb6577b"
+        },
+        {
+          "file": "Dandelion-01-UHD.png",
+          "sha256": "342b2d313c18e2a4eda35fa1e85a66f3bdb7fb475095c23bfc292c7efe5bd62b"
+        }
+      ]
+    }
+  ],
+  "registryConsumptionCheck": {
+    "renderer": "0.2.51",
+    "shared": "1.1.8",
+    "sourceOverrides": false,
+    "completedFixedSamples": 64,
+    "cameraResetAndRefinement": true,
+    "consoleErrors": 0,
+    "evidence": {
+      "file": "Factory-released-packages.png",
+      "sha256": "57ad9a850dfffdf642bc2e641fe19484ba343df27f245fac20af02cec4ec00eb"
+    }
+  }
+}

package/docs/batch-two-qualification.json

@@ -0,0 +1,145 @@
+{
+  "date": "2026-10-18",
+  "rendererSource": "65de630819322cdd90955417d21f97dd51416e90",
+  "sharedSource": "3d119868bb9be471f71e04e1e91ed467a958b2d6",
+  "requiredPublishedPackages": {
+    "@plasius/gpu-renderer": "0.2.51",
+    "@plasius/gpu-shared": "1.1.8"
+  },
+  "mode": "fixed-progressive",
+  "productionVerified": false,
+  "limitations": [
+    "Static source geometry only; this does not qualify adaptive transport or animation.",
+    "Physical touch hardware and screen-reader speech were not tested.",
+    "Changing quality settings reallocates the renderer and can take several seconds on dense sources."
+  ],
+  "models": [
+    {
+      "key": "grass_medium_01",
+      "triangles": 24730,
+      "primitives": 17,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Grass-Medium-01.png",
+          "sha256": "c3110d79baa4cf1307cf818f694458b8e1865bdb1f3758a0210ebe0ac0e3ddc1"
+        },
+        {
+          "file": "Grass-Medium-01-UHD.png",
+          "sha256": "2bef23adc598ebaf0f6df4008444325e7425b0199edcac49e3690c2b8f44fd91"
+        }
+      ]
+    },
+    {
+      "key": "searsia_lucida",
+      "triangles": 377192,
+      "primitives": 21,
+      "materials": 3,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Searsia-Lucida.png",
+          "sha256": "571ba465753bd4aec4d063b60e72e7196ed1ce0936a335dd28c0b7266be04b15"
+        },
+        {
+          "file": "Searsia-Lucida-UHD.png",
+          "sha256": "06478a062b57dc382d37c5ae448d2b3987b99bfa77589407b470af24a888ffe1"
+        }
+      ]
+    },
+    {
+      "key": "boulder_01",
+      "triangles": 66122,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Boulder-01.png",
+          "sha256": "d5a85db2d77d54bee0a2359ee3704ad1a751952dae9da55f52ee845df8c5dc21"
+        },
+        {
+          "file": "Boulder-01-UHD.png",
+          "sha256": "0c8e927d9845c5218740c7efc65c7b282bb0f7d45166779b3244dd6aebc12793"
+        }
+      ]
+    },
+    {
+      "key": "coastal_cliff_01",
+      "triangles": 461824,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Coastal-Cliff-01.png",
+          "sha256": "13ca80f446d6ee1199c67712a9f81b3c8b1303ecea335de0217d2b723c229adb"
+        },
+        {
+          "file": "Coastal-Cliff-01-UHD.png",
+          "sha256": "532cf5b9b272ce0e395e82bf044fa964b3cd00ebbac8160c4295b78edce5ee15"
+        }
+      ]
+    },
+    {
+      "key": "dead_tree_trunk",
+      "triangles": 101802,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Dead-Tree-Trunk.png",
+          "sha256": "ae1c01085ea5d4ed1fc05bd76ffa7a1d622dc620ca67c5a578b0cfedc59de3ce"
+        },
+        {
+          "file": "Dead-Tree-Trunk-UHD.png",
+          "sha256": "3664c0101bd9d80e4993376272d1e83abe23298001dc72f7ab526acf09d83b8a"
+        }
+      ]
+    }
+  ],
+  "registryConsumptionCheck": {
+    "renderer": "0.2.51",
+    "shared": "1.1.8",
+    "sourceOverrides": false,
+    "completedFixedSamples": 64,
+    "cameraResetAndRefinement": true,
+    "consoleErrors": 0,
+    "evidence": {
+      "file": "Searsia-Lucida-released-packages.png",
+      "sha256": "2c33f63553d04e901e3386e13b83100e700631efc15b4685c79a1abf0dae7b86"
+    }
+  }
+}

package/docs/catalogue-production-rollout.md

@@ -0,0 +1,115 @@
+# Complete catalogue rollout
+
+Status: delivery in progress, 18 October 2026. Parent Epic: site#2271;
+Feature: site#1170. First-batch Story: site#2303; production Task: site#2305.
+
+The research catalogue contains 75 distinct source assets/sets. Gem is explicitly
+excluded by the user, leaving 74 production candidates: eleven retained from
+the original twelve and 63 further models. Twenty-two have been acquired and ten
+are currently selectable in production.
+The 52 deployed files are geometry/texture resources, not 52 models.
+
+## Delivery sequence
+
+1. Diagnose Mosquito In Amber using its unchanged source geometry, textures and
+   material properties. Compare released rendering with isolated corrections;
+   retain known-bad evidence. Resolve transport/import faults with tests in the
+   owning `@plasius/*` package before updating consumers. Do not whiten the
+   material, remove transmission, replace the model or hide defects with filtering.
+2. Retain the excluded Gem research identity for provenance. Do not download or
+   substitute it. Verify all eleven retained originals and their source credits.
+3. Release qualified owning packages through approved main `cd.yml`, consume
+   registry versions, and publish the eleven retained first-group models through site CI/CD.
+4. Process the remaining 63 candidates in seven batches of nine, preserving
+   catalogue order. An individual dependency or unresolved licence is explicitly
+   held; it must not prevent unrelated candidates being inspected. Batch membership
+   and per-model status are version controlled; GitHub Project issues own delivery.
+5. Only after this original-model pass is available in production, begin a
+   separately designed PVOX conversion pass using the existing Plasius voxel
+   packages. Preserve original hashes/credits to support source-versus-voxel
+   comparisons. No voxel runtime or format is reimplemented here.
+
+## Qualification and publication
+
+For every model record source identity, author, licence, original hashes,
+chosen LOD, dependencies, transformations, triangle/texture/memory budgets,
+supported extensions and any animation limitation. Floating Castle still needs
+its upstream scan credits resolved. Large tree source bundles need suitable LODs;
+do not increase existing runtime/download limits merely to admit them.
+
+Reuse gpu-shared import/inspection, gpu-renderer, camera and model packages.
+Keep one selected model in flight, cancel stale work and dispose GPU resources.
+Lazy-load selected assets only; catalogue expansion must not download every asset
+or add renderer code to the homepage. Acquisition retains strict hashes, source
+allowlists, timeout, byte limits and bounded concurrency. Original binaries stay
+out of npm packages and private file paths stay out of committed metadata.
+
+Before public enablement: compare texture/material/silhouette appearance with
+the source; test completed fixed sampling, progressive refinement, camera reset,
+denoising off/on, errors, teardown, keyboard, 320px layout and UHD admission.
+Record actual dimensions/counts and timings; a completed render is not evidence
+of physical material accuracy or animation playback. Preserve source materials.
+
+Tests cover batch identity/completeness, pending and failed assets, integrity,
+cancellation, selection and release-manifest exclusion of unqualified entries.
+Require relevant tests, type/lint/build/package checks, >=80% coverage and every
+changed runtime source in LCOV. Shader coverage retains the standing exception.
+
+Production inherits the stored `gpu-demo.scene-fidelity.enabled` feature flag
+and existing GPU-route capability. Source catalogue qualification is distinct
+from rollout authorization. No production environment-variable bypass is added.
+Rollback uses the stored flag/capability and the prior approved deployment.
+Record exact successful CI/CD, production asset hashes and sensitive backend
+secretref mappings before closing any release-bearing item. Keep adaptive
+transport qualification separate; its draft packages are not production inputs.
+
+## Completion evidence
+
+This document is the design, not a claim of additional published models. Batch
+tracking must distinguish researched, acquired, imported, visually qualified and
+production-verified counts. Missing/held models keep the overall work open.
+
+## Fixed Amber qualification
+
+The [qualification record](amber-fixed-qualification.json) binds the renderer
+source and exact screenshot hashes for the original-source comparison. The
+enclosed insect is now visible without the previous severe dark shell or bands.
+All retained fixture categories completed fixed64 checks; Amber additionally
+completed fixed256 with denoising off/on, camera reset/refinement and native
+3840×2160 at one sample. These checks do not qualify adaptive transport or claim
+complete cinematic presentation. Production verification remains a separate gate.
+
+## Batch 1 acquisition
+
+Six CC0 Poly Haven sources are acquired unchanged: Large Iron Gate, Modular
+Factory Facade, Modular Fort 01, Modular Urban Apartments Facade, Modular Wooden
+Pier and Dandelion 01. Their 60 files total 58,823,648 bytes. Provider MD5/length
+checks and recorded SHA-256 inventories agree; glTF dependency closure is complete.
+`models:download -- 1` selects only this batch; runtime review still loads one
+model at a time. Floating Castle, Thatched Cottage and Diffuse Transmission Plant
+remain outside the acquired set. No additional model is production-qualified by
+this acquisition record.
+
+## Batch 1 inspection
+
+The [qualification record](batch-one-qualification.json) records all six source
+models completing fixed64 and native 3840×2160 at one sample. The material reuse
+correction in shared PR150 makes the factory kit usable without duplicating its
+six materials across 263 primitives. Camera and quality controls remain the
+shared inspection APIs. The modular sources remain separate kit pieces; the
+dandelion source contains five plants spread apart. This qualification supports
+source inspection and does not claim assembled environments or cinematic quality.
+Production remains pending registry consumption and approved site deployment.
+
+## Batch 2 acquisition
+
+Grass Medium 01, Searsia Lucida, Boulder 01, Coastal Cliff 01 and Dead Tree Trunk
+are acquired unchanged (25 files, 48,818,088 bytes). All five completed fixed64,
+camera reset/refinement and native UHD1 inspection; see
+[batch two evidence](batch-two-qualification.json). The workshop consumes
+published renderer 0.2.51 and shared 1.1.8, including the camera scene-reuse fix.
+Quality changes still reallocate the renderer; dense models can take several seconds.
+Four LOD0 tree sources exceed the unchanged 500,000-triangle limit: Fir Tree 01
+(6,982,937), Island Tree 01 (1,599,403), Jacaranda Tree (3,863,832) and Pine Tree 01
+(17,182,252). These need deliberate LOD preparation before admission; increasing
+the runtime budget or silently replacing their sources is not a qualification.