@plasius/gpu-demo-viewer 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -6,6 +6,42 @@ 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.9] - 2026-10-18
+
+- Add nine original natural-object and textile models with fixed64/UHD inspection evidence, pinned Khronos resources and explicit default-material limits.
+
+- **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 +242,5 @@ 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
+[0.1.9]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.9

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,31 @@ 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.
+
+Batch three adds nine locally inspected natural objects and textile studies,
+including the original Khronos sheen chair and cloth. All 31 acquired models
+retain their source hashes and credits. Local qualification does not mark the
+new batch live; the sheen chair currently supports only its default material.

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-three-qualification.json

@@ -0,0 +1,234 @@
+{
+  "date": "2026-10-18",
+  "renderer": "0.2.51",
+  "shared": "1.1.8",
+  "sourceOverrides": false,
+  "mode": "fixed-progressive",
+  "productionVerified": false,
+  "consoleErrors": 0,
+  "limitations": [
+    "Static geometry only; adaptive transport and animation are not qualified.",
+    "Sheen Chair uses its authored default material; variants are not selectable.",
+    "The source Rubber Boots set contains four boot meshes.",
+    "Physical touch hardware and screen-reader speech were not tested.",
+    "Completed images support source inspection, not full physical-fidelity approval."
+  ],
+  "models": [
+    {
+      "key": "food_pomegranate_01",
+      "triangles": 8142,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Food-Pomegranate-01.png",
+          "sha256": "b884838f06ae474122623228954630e1ce56ab5540dbb98bdb013be9ef5d70ac"
+        },
+        {
+          "file": "Food-Pomegranate-01-UHD.png",
+          "sha256": "c6bf16fae502a0da2a030d5e0cef4c4375af62bbedde069ff039823bd534a3a4"
+        }
+      ]
+    },
+    {
+      "key": "lambis_shell",
+      "triangles": 12498,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Lambis-Shell.png",
+          "sha256": "33b954c771bb4aaaf8bb9ad78f736546cfd7344885370535e989aaad1e872585"
+        },
+        {
+          "file": "Lambis-Shell-UHD.png",
+          "sha256": "b8f04147705a144a85688eb74a0dbee878bf4401275cfde11fb8eaa02ca901f5"
+        }
+      ]
+    },
+    {
+      "key": "rock_face_01",
+      "triangles": 20174,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Rock-Face-01.png",
+          "sha256": "33c7d7b6230b455e70cddab45344052ee125d47196c58943c0607a17e0fc8de8"
+        },
+        {
+          "file": "Rock-Face-01-UHD.png",
+          "sha256": "b369e857112218f79542bfe2039e677d4c45ac34fb9d912ee58c10aee80a7708"
+        }
+      ]
+    },
+    {
+      "key": "tree_stump_01",
+      "triangles": 41046,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Tree-Stump-01.png",
+          "sha256": "01b6cce2016364555fcc8fce3af3554b2380458f44efe91082df13e61ce83293"
+        },
+        {
+          "file": "Tree-Stump-01-UHD.png",
+          "sha256": "e649c3490bdac8096fde3b8aa50dd31ab92942eb40350ada9b64a4f0d0d24a4d"
+        }
+      ]
+    },
+    {
+      "key": "ArmChair_01",
+      "triangles": 5626,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Arm-Chair-01.png",
+          "sha256": "2880f3e3554562b46eefff8e00bc468ec502481c584fc13c4ddeb4b0127e6581"
+        },
+        {
+          "file": "Arm-Chair-01-UHD.png",
+          "sha256": "7529879e264de2b7f25bd5ea8e2df39ac5b3183bda21406578a6beb015990d00"
+        }
+      ]
+    },
+    {
+      "key": "fishermans_hat",
+      "triangles": 10304,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Fishermans-Hat.png",
+          "sha256": "8059b74c6dfc1074540dea7fb009f0c0634646cd5ed60b63ede9e9f524d8f01e"
+        },
+        {
+          "file": "Fishermans-Hat-UHD.png",
+          "sha256": "8d8dffb568abdcda33f922bb875536bcd9c7116c5c7bb5a05730a7d1edec9a7d"
+        }
+      ]
+    },
+    {
+      "key": "rubber_boots",
+      "triangles": 56128,
+      "primitives": 4,
+      "materials": 2,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Rubber-Boots.png",
+          "sha256": "4630658b9360eb26ef582db9ab7f7b727a5191e36dcda20b0b37d7123eab8b23"
+        },
+        {
+          "file": "Rubber-Boots-UHD.png",
+          "sha256": "9a1cb02dcee8b517a94d282af2dedc1f318b6a269b8949f7a1dca8cacc2f590c"
+        }
+      ]
+    },
+    {
+      "key": "SheenChair",
+      "triangles": 39936,
+      "primitives": 4,
+      "materials": 6,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Sheen-Chair.png",
+          "sha256": "a77903d6ead6cbcc9a03f9974ae7fe6d879c24c091bb7d384f7698b3fe3e8bb2"
+        },
+        {
+          "file": "Sheen-Chair-UHD.png",
+          "sha256": "1252911713a6a0fbb46238c06cc5845eaece04ac4cd0ff27d215a4db73875c36"
+        }
+      ]
+    },
+    {
+      "key": "SheenCloth",
+      "triangles": 115200,
+      "primitives": 1,
+      "materials": 1,
+      "completedFixedSamples": 64,
+      "denoisingOffOn": true,
+      "cameraResetAndRefinement": true,
+      "completedUhd": {
+        "width": 3840,
+        "height": 2160,
+        "samples": 1
+      },
+      "evidence": [
+        {
+          "file": "Sheen-Cloth.png",
+          "sha256": "c6b485a30af21fcafa949bc1e5d0dc7ee9f8304e6613a86617bcdd953185d247"
+        },
+        {
+          "file": "Sheen-Cloth-UHD.png",
+          "sha256": "4d41f377201f9fe4c4db329391981d1ac4c61efc3ec350c072f9dcacbe1ae7a2"
+        }
+      ]
+    }
+  ]
+}

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"
+    }
+  }
+}