@plasius/gpu-demo-viewer 0.1.8 → 0.1.10

package/CHANGELOG.md

@@ -6,6 +6,38 @@ 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.10] - 2026-10-20
+
+- Restore workshop setup and current quality controls near the start of the README; separate workspace/maintainer guidance and replace stale release counts with authoritative tracking links.
+
+- **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)
 
@@ -227,3 +259,5 @@ The format is based on Keep a Changelog and this project adheres to SemVer.
 [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
+[0.1.10]: https://github.com/Plasius-LTD/gpu-demo-viewer/releases/tag/v0.1.10

package/README.md

@@ -7,132 +7,162 @@
 [![Security Policy](https://img.shields.io/badge/security%20policy-yes-orange.svg)](./SECURITY.md)
 [![Changelog](https://img.shields.io/badge/changelog-md-blue.svg)](./CHANGELOG.md)
 
-Static root-level launcher for validating the `gpu-*` package demos from one place.
+A browser workshop for inspecting source models with the Plasius GPU renderer,
+plus a workspace launcher for the `gpu-*` package demos. The workshop provides
+camera gestures, progressive rendering, quality controls and model credits.
 
-## Purpose
+The npm package includes the viewer source, manifest and build-time acquisition
+helper. Model binaries are downloaded separately; they are not bundled in npm.
 
-This viewer exists to accelerate manual validation across the GPU package surface:
+## Run the model workshop
 
-- browser-backed demos can be launched or embedded from one URL
-- the integrated showcase consumes the shared 3D harbor runtime from `@plasius/gpu-shared`
-- the experimental wavefront path-tracing demo mounts the
-  `@plasius/gpu-renderer` WebGPU mesh BVH renderer
-- remaining code-example demos still expose their recommended command and entry file
-- the manifest is tested so new `gpu-*` demo folders do not get missed
+Use Node.js 24 or later, npm, and a WebGPU-capable browser on localhost or HTTPS.
+Clone the repository to run its Vite development server:
 
-## Run
+```sh
+git clone https://github.com/Plasius-LTD/gpu-demo-viewer.git
+cd gpu-demo-viewer
+npm ci
+npm run models:download
+npm run models:dev
+```
 
-From this package:
+Open [the local workshop](http://127.0.0.1:5291/?review=first-twelve).
+The default download command selects the original review batch. It verifies the
+exact size and SHA-256 of each model and its buffer/image dependencies, preserving
+source files and credits. Downloaded binaries live in `model-library/assets/`
+and are ignored by Git and npm. The workshop uses the published shared inspection
+and renderer dependencies from the lockfile; sibling source overrides are optional.
+
+The original batch includes a **manual Medieval house download**. Obtain the
+original GLB from the model's credited Sketchfab source and place it at
+`model-library/assets/sf-house/medieval_house.glb`, then rerun the download command.
+A missing manual file produces a placement message; this command does not download
+it for you. Only the pinned original file passes verification. Gem is excluded
+from the rollout and is not substituted.
+
+To acquire another reviewed batch or choose a different local port:
+
+```sh
+npm run models:download -- 1
+npm run models:dev -- --port 5292
+```
 
-```bash
-npm run demo
+Select one batch at a time. A catalogue record can still be held for acquisition,
+licensing or visual review; it is not a claim that the model is available locally
+or enabled on the production site. The download helper admits only configured
+resources and keeps two workers, a 100 MiB per-file limit and a 200 MiB batch limit.
+Source, creator, licence and review notes appear beside each model.
+
+## Camera and render quality
+
+Drag or use one finger to orbit; Shift/right-drag trucks, Alt-drag pans, and the
+wheel or pinch moves closer/farther. Two-finger movement trucks. Focus the canvas
+to use arrows, Shift-arrows, +/− and keyboard modes 1–5. `Home` restores framing;
+`?` replays a brief gesture reminder. Persistent instructions remain in Camera help.
+
+| Control | Choices | Default |
+| --- | --- | --- |
+| Sample target | 1, 8, 16, 32, 64, 128, 256 | 64 |
+| Light bounces | 2, 4, 6, 8, 10, 12 | 6 |
+| Render size | 480, 800, 1280 px width; 1920×1080, 2560×1440, 3840×2160 | 800 px width |
+| Denoising | On or off | On |
+
+The first pass uses one sample. Once the camera is still, batches of up to four
+refine toward the target. Camera and quality changes restart history. Hidden tabs
+pause further work; progress reports GPU-completed samples and actual dimensions.
+Settings do not reload the source model. Resizing preserves the camera.
+
+HD, QHD and 4K presets trace the exact selected dimensions independently of the
+window size; the canvas contains the image without stretching. Use one sample for
+a quick full-resolution check. GPU memory and rendering time depend on the model,
+resolution and device. Current released sampling is fixed progressive sampling;
+per-pixel adaptive controls remain separate qualification work.
+
+This workshop displays static geometry. Source animation clips remain in the
+original assets, but are not played here. Material variants are not selectable;
+for example, the sheen chair uses its default material. Completion of a render
+does not resolve the visual findings recorded in its review notes.
+
+## Embed the rendering runtime
+
+For an application view, use
+[`@plasius/gpu-shared/model-inspection`](https://github.com/Plasius-LTD/gpu-shared#inspect-a-model).
+It owns model loading, integrity verification, camera handling and refinement.
+This viewer supplies the surrounding catalogue, controls and review workflow.
+
+Node build tools can use the published acquisition helper:
+
+```sh
+npm install @plasius/gpu-demo-viewer
 ```
 
-Then open:
+```js
+import { acquisitionPlan, acquireFixtures } from "@plasius/gpu-demo-viewer/model-library/acquire";
 
-```text
-http://localhost:8000/gpu-demo-viewer/
+// Pass one reviewed batch of catalogue asset records and an absolute destination.
+export async function downloadReviewedBatch(assets, root) {
+  const plan = acquisitionPlan(assets, root); // Validates paths, sources and budgets.
+  console.log(`Verified download plan: ${plan.length} resources`);
+  return acquireFixtures({ assets, root });
+}
 ```
 
-The server points at the workspace root, so sibling package demos remain reachable from the viewer.
+The input shape follows
+[model-library/catalogue.json](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/model-library/catalogue.json).
+Only approved HTTPS providers are accepted; redirects fail. Existing files must
+match their pinned hashes and sizes; missing manual sources fail with a placement
+message. Keep this Node helper out of browser bundles. Site builds may enforce
+stricter limits and must verify the complete dependency closure.
 
-To open the experimental wavefront path-tracing technique demo directly:
+## Workspace demo launcher
 
-```text
-http://localhost:8000/gpu-demo-viewer/wavefront/?experimental=wavefront
-```
+The static root launcher expects sibling `gpu-*` package checkouts and their
+required builds. It is useful when developing the package family together.
+From a checkout named `gpu-demo-viewer`, with Python 3 installed:
 
-Deterministic 540p capture settings are available at:
-
-```text
-http://localhost:8000/gpu-demo-viewer/wavefront/?experimental=wavefront&capture=1
+```sh
+npm run demo
 ```
 
-The displayed primary-ray count is calculated as:
+Visit [the workspace launcher](http://localhost:8000/gpu-demo-viewer/).
+The server serves the parent directory so sibling demo URLs remain reachable.
+Browser-backed demos can be launched or embedded; code-example packages show
+their command and entry file. `gpu-world-generator` uses its built `demo/dist/`.
+The manifest is tested so sibling demo folders are not missed.
 
-```text
-render width x render height x samples per pixel
-```
+See [the experimental wavefront viewer](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/wavefront-viewer.md)
+for its separate capture mode, benchmark controls and timing interpretation.
 
-The debug panel also reports the separate screen-pixel count so render
-resolution and stochastic sampling cost remain visible independently.
-Continuation rays are then spawned from the active queue by bounce depth inside
-the renderer. The active demo presets are 960x540 capture, 1280x720 balanced,
-1920x1080 detail, and a 3840x2160 4K target. The 540p/720p/1080p presets
-default to 8 samples per pixel, while 4K defaults to 4 samples per pixel; the
-renderer keeps queue buffers tile-bounded so these targets do not require
-full-frame ray queues.
-
-The wavefront page runs a live render loop by default. The performance panel
-shows FPS, frame timing, primary rays per second, and a 100% stacked timing bar
-for the viewer-observed frame budget: WebGPU command dispatch, GPU completion
-wait, optional probe/readback, overlay update, and requestAnimationFrame pacing.
-These timings are browser-side measurements; they identify where the viewer is
-blocked each frame but do not yet replace future GPU timestamp-query profiling
-inside individual compute passes.
-
-## Static Validation Contract
-
-This repository is a public npm package that ships the static validation
-surface for the `gpu-*` family.
-
-- `npm run demo` serves the workspace root so sibling `gpu-*` demos are
-  reachable from one URL.
-- `npm run typecheck` syntax-checks the shipped browser entrypoints and
-  manifest modules.
-- `npm run build` verifies the static contract documented in
-  `docs/adrs/adr-0001-gpu-demo-viewer-governance-baseline.md`.
-- `npm run pack:check` verifies the public npm package payload before GitHub
-  Actions publishes it.
-- Releases are published only through `.github/workflows/cd.yml` with npm
-  provenance and the GitHub `production` environment.
-
-## Validation Notes
-
-- Browser-backed WebGPU demos still require `localhost` or `HTTPS`.
-- The wavefront path-tracing demo is a WebGPU renderer mount, not a CPU/static
-  canvas tracer. It submits only the benchmark model mesh set with
-  `displayQuality: true`, builds the renderer mesh BVH on the GPU, disables
-  environment portals, and leaves skybox/environment lighting as the only
-  scene lighting source. The demo intentionally excludes the previous synthetic
-  room, floor, wall, emissive-panel, and fluid-surface geometry so most escaped
-  paths should terminate against the skybox rather than unlit scene blockers.
-  Shallow no-light/max-depth paths return the renderer ambient residual to
-  approximate unresolved high-order indirect bounces. The demo exposes 1, 4, 8,
-  and 16 samples-per-pixel settings and defaults to 8 spp for the 540p, 720p,
-  and 1080p presets. The denoise toggle runs the renderer post pass; denoise
-  smooths neighboring pixels but does not replace active-ray skybox/environment
-  hits as the primary lighting source. The loop updates camera uniforms every
-  animation frame through `@plasius/gpu-renderer` so the FPS counter represents
-  a moving realtime render rather than repeated presentation of one static
-  frame.
-- The wavefront performance chart is intended for local tuning: compare
-  resolution, depth, samples-per-pixel, and denoise settings while watching
-  whether time is dominated by command dispatch, sampled GPU completion sync,
-  readback, overlay work, or frame pacing. The demo does not hard-sync every
-  frame; completion sync is sampled periodically to avoid making the viewer
-  itself serialize the GPU queue.
-- The shared integration showcase is 3D but does not require WebGPU initialization just to render the validation scene.
-- The showcase now resolves `@plasius/gpu-shared` through an import map so the browser entry uses the package public surface instead of a deep internal file path.
-- `gpu-world-generator` is launched from its built `demo/dist/` bundle in the viewer because its source demo uses a Vite workflow.
-- Code-example packages are listed for discovery but are not embedded in an iframe.
-
-## Local Checks
-
-```bash
+## Development and review records
+
+```sh
 npm run build
 npm run typecheck
 npm run lint
+npm run test:coverage
 npm run pack:check
-npm test
 ```
 
-## Governance
+`build` verifies the static viewer contract; `typecheck` checks shipped JavaScript
+syntax. Neither command performs browser GPU qualification.
+
+For deliberate local development against an unreleased package, the model Vite
+config accepts `PLASIUS_SHARED_INSPECTION_SOURCE` (absolute `src/model-inspection.js`)
+and `PLASIUS_RENDERER_SOURCE` (absolute `src/index.js` or built `dist/index.js`).
+These overrides are local development tools. Production consumes published,
+qualified package versions and approved source assets.
+
+- [Initial model findings](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/model-library-review.md).
+- [UHD inspection contract](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/model-inspection-uhd.md).
+- [Catalogue rollout requirements](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/catalogue-production-rollout.md) and [live delivery tracking](https://github.com/Plasius-LTD/plasius-ltd-site/issues/2308).
+- [Non-functional requirements](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/NFR.md), [workflow](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/WORKFLOW.md), [flags and capabilities](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/FLAGS_AND_CAPABILITIES.md), and [architecture decisions](https://github.com/Plasius-LTD/gpu-demo-viewer/blob/main/docs/adrs/index.md).
+
+The research manifest retains source identities and credits separately from
+acquisition state. Production entitlement and visual qualification are distinct
+from downloading a model. GitHub Project tracking owns current delivery status;
+voxel conversion follows qualification of the original-model catalogue.
 
-- Non-functional requirements: [`NFR.md`](./NFR.md)
-- Delivery workflow: [`WORKFLOW.md`](./WORKFLOW.md)
-- Feature flags and capabilities: [`FLAGS_AND_CAPABILITIES.md`](./FLAGS_AND_CAPABILITIES.md)
-- Architectural decision log: [`docs/adrs/index.md`](./docs/adrs/index.md)
 <!-- BEGIN PLASIUS RELEASE INTEGRITY -->
 ## Release integrity
 
@@ -148,56 +178,3 @@ npm 11.5.1 or newer, uses the protected `production` environment and
 short-lived npm OIDC with provenance, and has no long-lived npm write-token
 fallback. Rollback disables CD; it never rewrites published package history.
 <!-- END PLASIUS RELEASE INTEGRITY -->
-
-## 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; 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 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.
-
-During upstream progressive-renderer development, also set `PLASIUS_RENDERER_SOURCE` to an absolute reviewed `src/index.js` or built `dist/index.js`. Both source overrides are development-only; PRs remain dependency-blocked until approved package CD and final released-version validation. To use another local port: `npm run models:dev -- --port 5292`.
-
-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 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/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/catalogue-production-rollout.md

@@ -1,11 +1,13 @@
 # Complete catalogue rollout
 
-Status: delivery in progress, 18 October 2026. Parent Epic: site#2271;
+Plan recorded 18 October 2026; counts below are a historical planning snapshot,
+not current deployment status. See [Story 2308](https://github.com/Plasius-LTD/plasius-ltd-site/issues/2308)
+for delivery evidence and current status. 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
+the original twelve and 63 further models. Thirty-one have been acquired and ten
 are currently selectable in production.
 The 52 deployed files are geometry/texture resources, not 52 models.
 
@@ -113,3 +115,20 @@ 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.
+
+## Batch 3 acquisition
+
+Nine original sources are acquired: pomegranate, shell, rock face, tree stump,
+armchair, hat, boots, Sheen Chair and Sheen Cloth. Poly Haven resources retain
+the provider MD5/length and local SHA-256 inventories. Khronos sources are pinned
+to commit edc7c9e67c639d230715049ee31f9a96a6babbbe and checked against Git blob
+identities before SHA-256 inventory. Both sheen examples are CC0 in their primary
+source notices. Sheen Chair exposes its authored default material only; material
+variant selection is not claimed. This acquisition record does not admit any
+of these nine sources to production before visual qualification and site CI/CD.
+
+All nine batch-three models completed fixed64, camera reset/refinement, denoising
+off/on and native UHD1 using released packages, with no observed console errors.
+See [batch three evidence](batch-three-qualification.json). Four boot meshes are
+part of the source set; Sheen Chair retains its default authored material.
+Production verification remains pending.