@plasius/gpu-demo-viewer 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -6,6 +6,26 @@ 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)
 
@@ -206,3 +226,4 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 [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

@@ -165,7 +165,7 @@ 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
 
@@ -178,3 +178,26 @@ Ten models are currently production-verified. Amber is locally qualified with re
 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/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

@@ -5,7 +5,7 @@ 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. Eleven have been acquired and ten
+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.
 
@@ -78,3 +78,38 @@ 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.