@plasius/gpu-demo-viewer 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -6,6 +6,24 @@ 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.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 +205,4 @@ 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

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.
 
@@ -166,3 +166,15 @@ 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.
+
+## 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.

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/catalogue-production-rollout.md

@@ -0,0 +1,80 @@
+# 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. Eleven 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.

package/model-library/catalogue.json

@@ -625,41 +625,6 @@
         ]
       }
     },
-    {
-      "key": "sf-gem",
-      "category": "Fantasy, sculpture and gems",
-      "renderer_target": "Faceted normals, coloured transmission and refraction",
-      "preparation": "Simple geometry for a new gem material; no physically correct gem shader is promised by the source.",
-      "priority": "First 12",
-      "checked": "2026-10-11",
-      "import_status": "Not imported or visually qualified in this research",
-      "name": "Gem",
-      "provider": "Sketchfab",
-      "source_url": "https://sketchfab.com/3d-models/gem-ce73ada1698342d2bde0cb7b632a5b94",
-      "authors": "TomaszObloj",
-      "licence": "CC-BY-4.0",
-      "licence_url": "http://creativecommons.org/licenses/by/4.0/",
-      "licence_status": "Source licence verified",
-      "formats": "GLB (original filename declared by author)",
-      "geometry_count": 86,
-      "geometry_unit": "Triangles reported by Sketchfab",
-      "package_mib": null,
-      "package_basis": "Download size not verified",
-      "format_evidence_url": "https://sketchfab.com/3d-models/gem-ce73ada1698342d2bde0cb7b632a5b94",
-      "download_entry_url": "https://sketchfab.com/3d-models/gem-ce73ada1698342d2bde0cb7b632a5b94",
-      "extensions": "Not inspected",
-      "source_metadata_url": "https://api.sketchfab.com/v3/models/ce73ada1698342d2bde0cb7b632a5b94",
-      "lods_advertised": false,
-      "authoring_style": "Author model; visual qualification pending",
-      "cost": "Free",
-      "attribution_required": true,
-      "material_count": 1,
-      "animation_count": 0,
-      "number": 56,
-      "files": [],
-      "status": "deferred-by-user",
-      "entry": null
-    },
     {
       "key": "antique_ceramic_vase_01",
       "category": "Glass, ceramics and lighting",
@@ -749,7 +714,7 @@
       "name": "Mosquito In Amber",
       "provider": "Khronos sample assets",
       "source_url": "https://github.com/KhronosGroup/glTF-Sample-Assets/tree/main/Models/MosquitoInAmber",
-      "authors": "Loic Norgeot (Model); © 2018 Sketchfab; Sketchfab (Real-time refraction); © 2019 Sketchfab",
+      "authors": "Loic Norgeot (Model); \u00a9 2018 Sketchfab; Sketchfab (Real-time refraction); \u00a9 2019 Sketchfab",
       "licence": "CC-BY-4.0",
       "licence_url": "https://github.com/KhronosGroup/glTF-Sample-Assets/blob/main/Models/MosquitoInAmber/README.md",
       "licence_status": "Source licence verified",
@@ -869,8 +834,17 @@
           "OPAQUE"
         ]
       },
-      "review_status": "needs-fix",
-      "observed_issue": "Confirmed visual defect: amber renders too dark with horizontal bands. Transmission, volume scaling and the render pipeline need investigation before this is showcase-ready."
+      "review_status": "fixed-qualified",
+      "observed_issue": "Fixed-wavefront correction qualified with original materials: the enclosed insect is visible and the previous dark bands are absent. Experimental adaptive transport is not qualified by this check.",
+      "qualification": {
+        "renderer": "0.2.50",
+        "sourceCommit": "ad52d1124455807cc1355525ab9ec0c2a9b9637b",
+        "date": "2026-10-18",
+        "sampling": "fixed",
+        "matchedSamples": 256,
+        "bounces": 6,
+        "nativeUhdSamples": 1
+      }
     },
     {
       "key": "Fox",
@@ -883,7 +857,7 @@
       "name": "Fox",
       "provider": "Khronos sample assets",
       "source_url": "https://github.com/KhronosGroup/glTF-Sample-Assets/tree/main/Models/Fox",
-      "authors": "PixelMannen (Model); © 2014 Public; tomkranis (Rigging & Animation); © 2014 tomkranis; @AsoboStudio and @scurest (Conversion to glTF); © 2017 @AsoboStudio and @scurest",
+      "authors": "PixelMannen (Model); \u00a9 2014 Public; tomkranis (Rigging & Animation); \u00a9 2014 tomkranis; @AsoboStudio and @scurest (Conversion to glTF); \u00a9 2017 @AsoboStudio and @scurest",
       "licence": "CC0-1.0 + CC-BY-4.0",
       "licence_url": "https://github.com/KhronosGroup/glTF-Sample-Assets/blob/main/Models/Fox/README.md",
       "licence_status": "Source licence verified",

package/model-library/index.html

@@ -30,6 +30,6 @@
 </fieldset>
 <div class="refinement"><label id="refinement" for="sample-progress">Waiting for a model…</label><progress id="sample-progress" max="64" value="0"></progress></div>
 <div class="canvas-wrap"><canvas id="canvas" width="800" height="600" tabindex="0" aria-label="Interactive Plasius model view" aria-describedby="help"></canvas><p id="hint" hidden>Drag to orbit · Shift-drag to move · Scroll to approach<br>Touch: drag or pinch · Keyboard: arrows, + / −, Home</p></div><p id="status" role="status" aria-live="polite">Preparing the review…</p></section></div>
-<p class="footnote">Gem is deferred pending its Sketchfab download. No replacement models are shown.</p></main>
+<p class="footnote">Eleven retained source models. Gem is excluded from this rollout; no substitute is shown.</p></main>
 <script type="module">import { mountLibrary } from './main.js'; mountLibrary().catch(error => { document.querySelector('#status').textContent = `Unable to open review: ${error.message}`; });</script>
 </body></html>