fix(strata): PRD 618 complete the forest before revealing it

.github/workflows/ci.yml

@@ -925,7 +925,7 @@ jobs:
     steps:
       - uses: actions/checkout@v7
         with:
-          ref: ${{ needs.scope.outputs.candidate_sha || github.sha }}
+          ref: ${{ needs.scope.outputs.candidate_sha }}
       - uses: ./.github/actions/pnpm
       - uses: actions/setup-node@v7
         with:
@@ -947,6 +947,32 @@ jobs:
       # `test:browser` is the test-browser job's gate; running it again here bought nothing but
       # a second copy of the slowest step in the workflow.
       - run: pnpm exec playwright test --config=benchmark.playwright.config.ts
+      # Software startup regression contract only; hardware and visual acceptance remain separate.
+      - uses: actions/checkout@v7
+        with:
+          ref: 88b988cd70d5db7266eb0281e5f74bd0e030b3e7
+          path: .worktrees/strata-startup-baseline
+      - name: Build isolated reviewed Strata baseline
+        timeout-minutes: 5
+        working-directory: .worktrees/strata-startup-baseline
+        run: |
+          set -euo pipefail
+          pnpm install --frozen-lockfile
+          pnpm --filter strata-terrain-preview... build
+      - name: Build candidate Strata with restored candidate packages
+        timeout-minutes: 3
+        run: pnpm --filter strata-terrain-preview build
+      - name: Enforce Strata startup median
+        timeout-minutes: 9
+        env:
+          EXPECTED_SOURCE_SHA: ${{ needs.scope.outputs.candidate_sha }}
+        run: timeout 9m pnpm tsx scripts/verify-strata-startup.ts
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: strata-startup-${{ needs.scope.outputs.candidate_sha }}
+          path: artifacts/strata-startup/
+          if-no-files-found: warn
 
   # visuals is NOT a job here any more. It captures frames from a WebGPU canvas, and this runner
   # has no GPU — its first execution in the repository's history failed on

biome.json

@@ -12,6 +12,7 @@
       "artifacts/**",
       "examples/strata-terrain-preview/src/world/*.json",
       "examples/strata-terrain-preview/local-assets/**",
+      "examples/strata-terrain-preview/assets/**",
       "build/**",
       "release-native/**",
       ".linchpin/**",
@@ -210,6 +211,28 @@
       "formatter": {
         "enabled": false
       }
+    },
+    {
+      "include": ["examples/procedural-animals/src/render/donor/core/motion/quadruped.js"],
+      "linter": {
+        "rules": {
+          "style": {
+            "useNamingConvention": {
+              "level": "error",
+              "options": {
+                "conventions": [
+                  {
+                    "selector": { "kind": "objectLiteralProperty" },
+                    "match": "(?:(?:D|DL|T|F|H|W|U|Lf)|(.+))"
+                  }
+                ],
+                "strictCase": false,
+                "requireAscii": false
+              }
+            }
+          }
+        }
+      }
     }
   ]
 }

docs/verification/native-coverage-2026-08-28.md

@@ -21,12 +21,12 @@ targets could not be built and are named below.
 | `src/storage/` | 327 | 286 | 87.46% |
 | `src/utils/` | 0 | 0 | 0.00% |
 | `src/vfs/` | 239 | 195 | 81.59% |
-| `src/webgpu/` | 9885 | 7581 | 76.69% |
+| `src/webgpu/` | 9888 | 7592 | 76.78% |
 | `src/webtransport/` | 1391 | 1078 | 77.50% |
 | `src/workers/` | 615 | 527 | 85.69% |
-| **TOTAL** | **24858** | **19489** | **78.40%** |
+| **TOTAL** | **24861** | **19500** | **78.44%** |
 
-Source digest: `sha256:1a8ed34cf063a9530e8fa11b2722ae0b4c475402ee1baef998b5dea0acd3a4d7`
+Source digest: `sha256:b71a3030b463e0e2288fa81b1e556ab3fce303d3268ea3fc1786bdb9b8b316eb`
 
 The default `pnpm budgets` gate reads this committed measurement without configuring or compiling
 the native host. Any native source, native C++ test, CTest registration, or coverage aggregation

examples/strata-terrain-preview/.gitignore

@@ -2,3 +2,4 @@
 /dist/
 /src/world/.bake-stamp
 /assets/
+/assets.manifest.json

examples/strata-terrain-preview/__tests__/groundSampler.spec.ts

@@ -0,0 +1,153 @@
+import { Heightfield } from "@threenative/core/world";
+import { Mesh, Raycaster, Vector3 } from "three";
+import { describe, expect, it } from "vitest";
+import { createGroundSampler } from "../src/render/groundSampler.js";
+
+/**
+ * The drawn mesh is the reference: every case compares the sampler with a stock Three `Raycaster`
+ * on the same geometry, never with a mirrored copy of the sampler's own formula.
+ */
+function sampleCase(heights: number[], size: number, rows: number, columns: number) {
+  const field = new Heightfield({
+    rows,
+    columns,
+    width: size,
+    depth: size,
+    origin: { x: 0, z: 0 },
+    heights: Float32Array.from(heights),
+  });
+  const mesh = new Mesh(field.toGeometry());
+  mesh.updateMatrixWorld(true);
+  const sampler = createGroundSampler(field, mesh.geometry, mesh.matrixWorld);
+  const ray = (x: number, z: number): number | null => {
+    const hit = new Raycaster(new Vector3(x, 1000, z), new Vector3(0, -1, 0)).intersectObject(
+      mesh,
+      false,
+    )[0];
+    return hit?.point.y ?? null;
+  };
+  return { field, mesh, sampler, ray };
+}
+
+const sobel = (col: number, row: number): number => ((col * 7 + row * 13) % 9) - 4;
+
+describe("exact ground sampler", () => {
+  it("uses the drawn triangle planes, not the bilinear height, on a saddle", () => {
+    // Row-major [UL, UR, LL, LR]: opposite corners up, adjacent corners down.
+    const { field, sampler, ray } = sampleCase([0, 1, 1, 0], 2, 2, 2);
+    for (const [x, z] of [
+      [0.1, 0.1],
+      [-0.1, -0.1],
+      [0.25, 0.25],
+      [-0.25, -0.25],
+    ]) {
+      const expected = ray(x as number, z as number) as number;
+      expect(Number.isFinite(expected)).toBe(true);
+      const sampled = sampler(x as number, z as number) as number;
+      expect(sampled).toBeCloseTo(expected, 6);
+      // Bilinear floats well above the drawn triangle away from the shared edge.
+      expect(Math.abs(sampled - field.heightAt(x as number, z as number))).toBeGreaterThan(0.2);
+    }
+    // Points on both diagonals and the shared edge agree with the raycaster.
+    for (const [x, z] of [
+      [0, 0],
+      [0.5, 0.5],
+      [-0.5, -0.5],
+      [0.6, 0.2],
+      [-0.6, -0.2],
+    ]) {
+      const expected = ray(x as number, z as number) as number;
+      expect(Number.isFinite(expected)).toBe(true);
+      expect(sampler(x as number, z as number)).toBeCloseTo(expected, 6);
+    }
+  });
+
+  it("matches the raycaster on cell boundaries and interior samples of an irregular grid", () => {
+    const rows = 5;
+    const columns = 5;
+    const heights: number[] = [];
+    for (let row = 0; row < rows; row += 1)
+      for (let column = 0; column < columns; column += 1) heights.push(sobel(column, row));
+    const { sampler, ray } = sampleCase(heights, 4, rows, columns);
+    const points: [number, number][] = [
+      [-2, -2],
+      [0, 0],
+      [2, 2],
+      [-1, 0],
+      [0, -1],
+      [1, 0],
+      [0, 1],
+      [-1.5, 0.5],
+      [0.5, 1.5],
+      [1.25, -0.75],
+      [0.3, 0.3],
+      [-0.2, 1.1],
+    ];
+    for (const [x, z] of points) {
+      const expected = ray(x, z) as number;
+      expect(Number.isFinite(expected)).toBe(true);
+      expect(sampler(x, z)).toBeCloseTo(expected, 6);
+    }
+  });
+
+  it("matches Float32 vertices, diagonals, and the far bound on a non-binary grid", () => {
+    const rows = 17;
+    const columns = 17;
+    const heights: number[] = [];
+    for (let row = 0; row < rows; row += 1)
+      for (let column = 0; column < columns; column += 1) heights.push(sobel(column, row));
+    const { mesh, sampler, ray } = sampleCase(heights, 10.3, rows, columns);
+    const position = mesh.geometry.getAttribute("position");
+    const points: [number, number][] = [];
+    for (let row = 0; row < rows; row += 1) {
+      for (let column = 0; column < columns; column += 1) {
+        const vertex = row * columns + column;
+        points.push([position.getX(vertex), position.getZ(vertex)]);
+        if (row === rows - 1 || column === columns - 1) continue;
+        const lowerRight = vertex + columns + 1;
+        points.push([
+          (position.getX(vertex) + position.getX(lowerRight)) / 2,
+          (position.getZ(vertex) + position.getZ(lowerRight)) / 2,
+        ]);
+      }
+    }
+    for (const [x, z] of points) {
+      const expected = ray(x, z);
+      expect(expected).not.toBeNull();
+      expect(sampler(x, z)).not.toBeNull();
+      expect(sampler(x, z) as number).toBeCloseTo(expected as number, 6);
+    }
+  });
+
+  it("follows a translated mesh and matches the raycaster there", () => {
+    const { field, mesh } = sampleCase([0, 1, 1, 0], 2, 2, 2);
+    mesh.position.set(12, 3, -7);
+    mesh.updateMatrixWorld(true);
+    const moved = createGroundSampler(field, mesh.geometry, mesh.matrixWorld);
+    for (const [lx, lz] of [
+      [-0.25, -0.25],
+      [0.25, 0.25],
+      [0, 0],
+      [0.5, -0.5],
+    ]) {
+      const hit = new Raycaster(
+        new Vector3(12 + (lx as number), 1000, -7 + (lz as number)),
+        new Vector3(0, -1, 0),
+      ).intersectObject(mesh, false)[0];
+      expect(moved(12 + (lx as number), -7 + (lz as number))).toBeCloseTo(
+        hit?.point.y as number,
+        6,
+      );
+    }
+  });
+
+  it("returns null outside the grid and for a rotated topology, so the ray fallback runs", () => {
+    const { field, mesh, sampler } = sampleCase([0, 1, 1, 0], 2, 2, 2);
+    expect(sampler(2.5, 0)).toBeNull();
+    expect(sampler(0, -2.5)).toBeNull();
+    mesh.rotation.y = Math.PI / 2;
+    mesh.updateMatrixWorld(true);
+    const rotated = createGroundSampler(field, mesh.geometry, mesh.matrixWorld);
+    expect(rotated(0, 0)).toBeNull();
+  });
+});

examples/strata-terrain-preview/__tests__/temporalAA.spec.ts

@@ -0,0 +1,57 @@
+import assert from "node:assert/strict";
+import { DataTexture, FloatType, PerspectiveCamera, RedFormat } from "three";
+import TRAANode, { traa } from "three/addons/tsl/display/TRAANode.js";
+import type RTTNode from "three/src/nodes/utils/RTTNode.js";
+import { texture, vec4 } from "three/tsl";
+import type { TextureNode } from "three/webgpu";
+import { describe, expect, it } from "vitest";
+import { createOutdoorTRAA } from "../src/render/sky.js";
+
+describe("Strata temporal AA input", () => {
+  it("primes the actual beauty RTT and leaves automatic resizing enabled", () => {
+    const camera = new PerspectiveCamera();
+    const depthVelocity = texture(
+      new DataTexture(new Float32Array([1]), 1, 1, RedFormat, FloatType),
+    );
+    const input = vec4(1).mul(0.5);
+    const unprimed = traa(input, depthVelocity, depthVelocity, camera);
+    assert(unprimed instanceof TRAANode);
+    const unprimedBeauty = unprimed.beautyNode;
+    assert(isRTTNode(unprimedBeauty));
+    assert(unprimedBeauty.renderTarget);
+    expect(unprimedBeauty.width).toBeNull();
+    expect(unprimedBeauty.height).toBeNull();
+    expect(unprimedBeauty.renderTarget?.width).toBeNull();
+    expect(unprimedBeauty.renderTarget?.height).toBeNull();
+
+    const renderer = {
+      surface: () => ({
+        resolutionScale: 1,
+        scaleSource: "pinned" as const,
+        sampleCount: 1,
+        drawingBufferWidth: 640,
+        drawingBufferHeight: 360,
+        atFloor: false,
+      }),
+    };
+    const node = createOutdoorTRAA(input, depthVelocity, depthVelocity, camera, renderer);
+    assert(node instanceof TRAANode);
+    const beauty = node.beautyNode;
+    assert(isRTTNode(beauty));
+    assert(beauty.renderTarget);
+    const target = beauty.renderTarget;
+    expect(target.texture.width).toBe(640);
+    expect(target.texture.height).toBe(360);
+    expect(Number.isFinite(target.texture.width)).toBe(true);
+    expect(Number.isFinite(target.texture.height)).toBe(true);
+    expect(beauty.autoResize).toBe(true);
+
+    beauty.setSize(320, 180);
+    expect([target.width, target.height]).toEqual([320, 180]);
+    expect(beauty.autoResize).toBe(true);
+  });
+});
+
+function isRTTNode(node: TextureNode): node is RTTNode {
+  return "isRTTNode" in node && Reflect.get(node, "isRTTNode") === true;
+}

examples/strata-terrain-preview/package.json

@@ -9,8 +9,9 @@
     "build": "pnpm bake && vite build",
     "build:desktop": "pnpm bake && node ../../packages/runtime-native/scripts/bundle.mjs --project . --entry src/game.ts --target desktop --output dist/strata-terrain-native.js",
     "typecheck": "pnpm bake && tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
     "test:terrain:web": "node ../../packages/playtest/dist/runner/cli.js playtests/terrain.playtest.json --url 'http://127.0.0.1:5196/?showcase=1' --server-command 'pnpm dev --host 127.0.0.1 --port 5196 --strictPort' --browser-recipe webgpu --headed --artifacts artifacts/playtest/web && node scripts/verify-ocean.mjs artifacts/playtest/web",
-    "test:terrain:desktop": "node scripts/stage-native-assets.mjs && pnpm build:desktop && node ../../packages/playtest/dist/runner/cli.js playtests/terrain.playtest.json --target desktop --executable ../../packages/runtime-native/build/tn-linux/mystral --host-arg run --host-arg dist/strata-terrain-native.js --artifacts artifacts/playtest/desktop && node scripts/verify-ocean.mjs artifacts/playtest/desktop && sh ../../scripts/xvfb.sh ../../packages/runtime-native/build/tn-linux/mystral run dist/strata-terrain-native.js --headless --frames 300 --screenshot artifacts/playtest/desktop/terrain-300frames.png",
+    "test:terrain:desktop": "node scripts/stage-native-assets.mjs && pnpm build:desktop && node ../../packages/playtest/dist/runner/cli.js ../playtests/terrain.playtest.json --project assets --target desktop --executable ../../../packages/runtime-native/build/tn-linux/mystral --host-arg run --host-arg ../dist/strata-terrain-native.js --artifacts ../artifacts/playtest/desktop && node scripts/verify-ocean.mjs artifacts/playtest/desktop && (cd assets && sh ../../../scripts/xvfb.sh ../../../packages/runtime-native/build/tn-linux/mystral run ../dist/strata-terrain-native.js --headless --frames 300 --screenshot ../artifacts/playtest/desktop/terrain-300frames.png)",
     "test:terrain:editor": "node scripts/verify-editor.mjs",
     "test:consumer": "node scripts/verify-consumer.mjs",
     "test:kit": "node scripts/verify-starter-kit.mjs",