From f80f991962b397a5670576b9d2dd661b94090078 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Thu, 1 Oct 2026 23:50:36 -0700
Subject: [PATCH 01/90] docs: reconcile PRD-269 motion history qualification
---
...ion-vectors-or-the-temporal-filters-lie.md | 48 ++++++++++++++++++-
1 file changed, 47 insertions(+), 1 deletion(-)
diff --git a/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md b/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
index 457810b575..ebf9058e8b 100644
--- a/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
+++ b/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
@@ -4,7 +4,9 @@ prd_contract: v1
# PRD-269 — motion vectors for skinned and instanced geometry, or the temporal filters lie
-**Status:** PROPOSED — filed 2026-08-29, measured at `7e5a9fe1`. Depends on
+**Status:** PARTIAL — reopened for qualification on 2026-10-02 at `d7277838`; originally
+filed 2026-08-29, measured at `7e5a9fe1`. Implementation landed in `3630847a`
+(`squash: deliver PRD-269 motion history`), but the acceptance below is not fully qualified. Depends on
[PRD-266](../useful-defaults/PRD-266-the-render-chain-names-the-tier-it-actually-ran.md); lands before
[PRD-268](./PRD-268-light-that-comes-from-off-screen.md) is judged. Batch:
[docs/PRDs/lighting](./README.md).
@@ -69,6 +71,44 @@ PRD-266 chain as a provisioning stage rather than a user-facing effect:
commands, so per-sub-draw previous transforms are what the velocity pass needs — the aggregate
object transform is not enough and will read as correct in every static test.
+## Current implementation and bounded repair
+
+The problem measurements below are historical, not a claim that the shipped engine has no
+velocity implementation. Commit `3630847a` added `VelocityTracker`, RenderChain MRT provisioning,
+the patched Three.js accessors, and CPU software-rasterization coverage. Reuse those mechanisms.
+The engine-layer defect at `d7277838` is narrower: `SceneRenderProjection.reconcile()` and
+`commit()` skip temporal bookkeeping when `renderer.projection: false`, so an authored
+`BatchedMesh` has no previous-matrix texture even with temporal rendering active. Its patched
+accessor consequently uses current sub-draw matrices as history. Projection opt-out must still
+build no mirror and perform no eligibility scan; temporal-off must retain no history work.
+
+### Phase 1 — qualify shipped motion history
+
+- [ ] Verify the existing per-object transform and MRT provisioning implementation. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts`
+- [ ] Verify the shipped batched accessor and projection pipeline integration. proof: `pnpm exec vitest run packages/core/__tests__/batched-velocity.spec.ts packages/core/__tests__/render-projection-pipeline.spec.ts`
+
+### Phase 2 — preserve temporal history through projection opt-out
+
+- [ ] Preserve explicit BatchedMesh sub-draw history across first and subsequent rendered frames with projection disabled. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts`
+- [ ] Release/reset history on temporal toggles, removal and disposal without a projection scan or temporal-off traversal. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts packages/core/__tests__/renderProjection.spec.ts`
+
+### Phase 3 — close original image-space acceptance
+
+- [ ] Add a playtest fixture for an authored moving BatchedMesh with projection disabled. proof: its scenario loads through `packages/playtest` and asserts the moving versus static sub-draw result
+- [ ] Add the original animated-character ghosting playtest with a measured rejection-fraction assertion. proof: scenario drives the active temporal stage and fails if the velocity source is removed
+
+The two Phase 3 fixtures remain implementation work; existing CPU software rasterization is not
+GPU image-space or native proof. The original acceptance and mutation descriptions are preserved
+below and remain unqualified wherever no real lane has run.
+
+## Blocked on
+
+Browser/native GPU execution requires a working WebGPU device or supported native host. This
+cloud environment has no `/dev/dri`, Android device tooling or `/dev/kvm`; the batch's attempted
+Xvfb launch failed with `EPERM`. Keep the PR draft until the original image-space and native
+acceptance has real execution evidence. No GPU, frame-cost, ghosting or platform-parity result
+is inferred from the CPU tests.
+
## Acceptance criteria
1. **A moving skinned mesh produces non-zero velocity where it moved, and zero where it did not.**
@@ -105,6 +145,12 @@ paths, which have their own lifetimes.
## Verification
+2026-10-02 qualification start: existing `render-velocity.spec.ts` passes 11/11 CPU tests.
+`node --import tsx scripts/check-doc-links.ts` resolves 2,395 links; agent mirrors are in sync.
+The prose test lane passes 178/180 tests; two `evidence-budget.spec.ts` subprocess cases are
+blocked by tsx IPC `listen EPERM` in this environment. No code was changed for those failures.
+
+
`pnpm typecheck && pnpm lint && pnpm test`; the ghosting playtest with the before/after rejection
fraction pasted; `pnpm visuals:ab` on a template with an animated character. Native parity follows
PRD-270. `pnpm tsx scripts/count-loc.ts` runs against this one specifically — a velocity pass a
From 71904523246c321c6c5336c5822956fb0ae705f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 00:02:30 -0700
Subject: [PATCH 02/90] fix(core): retain temporal history when projection is
disabled
---
...ion-vectors-or-the-temporal-filters-lie.md | 36 +++-
.../core/__tests__/render-velocity.spec.ts | 159 +++++++++++++++++-
packages/core/src/renderProjection.ts | 20 +--
3 files changed, 192 insertions(+), 23 deletions(-)
diff --git a/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md b/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
index ebf9058e8b..ea2ddb0bae 100644
--- a/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
+++ b/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
@@ -73,7 +73,7 @@ object transform is not enough and will read as correct in every static test.
## Current implementation and bounded repair
-The problem measurements below are historical, not a claim that the shipped engine has no
+The problem measurements above are historical, not a claim that the shipped engine has no
velocity implementation. Commit `3630847a` added `VelocityTracker`, RenderChain MRT provisioning,
the patched Three.js accessors, and CPU software-rasterization coverage. Reuse those mechanisms.
The engine-layer defect at `d7277838` is narrower: `SceneRenderProjection.reconcile()` and
@@ -84,13 +84,13 @@ build no mirror and perform no eligibility scan; temporal-off must retain no his
### Phase 1 — qualify shipped motion history
-- [ ] Verify the existing per-object transform and MRT provisioning implementation. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts`
-- [ ] Verify the shipped batched accessor and projection pipeline integration. proof: `pnpm exec vitest run packages/core/__tests__/batched-velocity.spec.ts packages/core/__tests__/render-projection-pipeline.spec.ts`
+- [x] Verify the existing per-object transform and MRT provisioning implementation. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts`
+- [x] Verify the shipped batched accessor and projection pipeline integration. proof: `pnpm exec vitest run packages/core/__tests__/batched-velocity.spec.ts packages/core/__tests__/render-projection-pipeline.spec.ts`
### Phase 2 — preserve temporal history through projection opt-out
-- [ ] Preserve explicit BatchedMesh sub-draw history across first and subsequent rendered frames with projection disabled. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts`
-- [ ] Release/reset history on temporal toggles, removal and disposal without a projection scan or temporal-off traversal. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts packages/core/__tests__/renderProjection.spec.ts`
+- [x] Preserve explicit BatchedMesh sub-draw history across first and subsequent rendered frames with projection disabled. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts`
+- [x] Release/reset history on temporal toggles, removal and disposal without a projection scan or temporal-off traversal. proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts packages/core/__tests__/renderProjection.spec.ts`
### Phase 3 — close original image-space acceptance
@@ -103,6 +103,11 @@ below and remain unqualified wherever no real lane has run.
## Blocked on
+Actual relevant runtime screenshots must be attached to the PR before merge (owner requirement,
+2026-10-02). They remain unverified; software-rasterizer output and test-log screenshots do not
+satisfy this gate.
+
+
Browser/native GPU execution requires a working WebGPU device or supported native host. This
cloud environment has no `/dev/dri`, Android device tooling or `/dev/kvm`; the batch's attempted
Xvfb launch failed with `EPERM`. Keep the PR draft until the original image-space and native
@@ -145,12 +150,31 @@ paths, which have their own lifetimes.
## Verification
+2026-10-02 repair: before the fix, `render-velocity.spec.ts` reports 4 failed / 12 passed:
+missing `_previousMatricesTexture` in authored batch/frame-footprint tests, plus undefined
+history in toggle and removal tests. Moving temporal enablement/update ahead of the opt-out
+return and allowing its post-render commit makes the focused lane green: 117/117 tests across
+`render-velocity`, `batched-velocity`, `render-projection-pipeline`, and `renderProjection`.
+A broader direct core-suite run was interrupted before results while the targeted lane was rerun.
+The tests assert first-frame identity, non-aliased texture history, next-frame advancement,
+static/moving CPU footprints, toggle resets, removal/disposal, no eligibility scan, and no
+steady-frame history traversal while temporal rendering is off. This verifies phases 1 and 2;
+the CPU footprint fixture builds the patched Three.js nodes but is not GPU readback.
+
+`pnpm lint` passes with 1,000 repository warnings. `pnpm typecheck` is killed with exit 137
+before completing. `pnpm test` exits 2 before assertions because tsx cannot open its IPC socket
+(`listen EPERM`). A direct core typecheck/build additionally needs the playtest package's missing
+built declarations; its normal build reaches the same tsx IPC restriction. Running the same
+validator with `node --import tsx` followed by the package's tsup build succeeds, after which
+`tsc --noEmit -p packages/core/tsconfig.json` passes. The root typecheck/full test/core package
+build remain unverified. `node packages/playtest/dist/runner/cli.js doctor --text` exits 2:
+`TN_PLAYTEST_RUNNER_FAILED`, adb not found.
+
2026-10-02 qualification start: existing `render-velocity.spec.ts` passes 11/11 CPU tests.
`node --import tsx scripts/check-doc-links.ts` resolves 2,395 links; agent mirrors are in sync.
The prose test lane passes 178/180 tests; two `evidence-budget.spec.ts` subprocess cases are
blocked by tsx IPC `listen EPERM` in this environment. No code was changed for those failures.
-
`pnpm typecheck && pnpm lint && pnpm test`; the ghosting playtest with the before/after rejection
fraction pasted; `pnpm visuals:ab` on a template with an animated character. Native parity follows
PRD-270. `pnpm tsx scripts/count-loc.ts` runs against this one specifically — a velocity pass a
diff --git a/packages/core/__tests__/render-velocity.spec.ts b/packages/core/__tests__/render-velocity.spec.ts
index 632f8ce430..2d70e7c46b 100644
--- a/packages/core/__tests__/render-velocity.spec.ts
+++ b/packages/core/__tests__/render-velocity.spec.ts
@@ -17,8 +17,10 @@ import {
import { instance, pass, skinning } from "three/tsl";
import type { Node } from "three/webgpu";
import { VelocityNode, WGSLNodeBuilder } from "three/webgpu";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it, vi } from "vitest";
+import * as projectionPlan from "../src/projection-plan.js";
+import { readBatchedMeshPreviousMatrices } from "../src/render/batched-velocity.js";
import { type IRenderChainRenderer, RenderChain } from "../src/render/chain.js";
import {
VelocityTracker,
@@ -318,6 +320,144 @@ describe("velocity provisioning on the shipped path", () => {
tracker.clear();
});
+ it("commits authored sub-draw history when projection is disabled", () => {
+ const { batch, movingBatchInstanceId, scene } = velocitySceneFixture();
+ const scan = vi.spyOn(projectionPlan, "scanProjection");
+ const projection = new SceneRenderProjection(scene, {
+ projection: false,
+ velocity: true,
+ onReport: () => undefined,
+ });
+ try {
+ projection.reconcile();
+ expect(projection.root).toBe(scene);
+ expect(projection.report).toMatchObject({ reasonCode: "disabled", batches: 0 });
+ const first = batchMatrixData(batch, "_matricesTexture").slice();
+ expect(batchMatrixData(batch, "_previousMatricesTexture")).toEqual(first);
+ expect(batchMatrixData(batch, "_previousMatricesTexture")).not.toBe(
+ batchMatrixData(batch, "_matricesTexture"),
+ );
+ projection.commit();
+
+ batch.setMatrixAt(movingBatchInstanceId, new Matrix4().makeTranslation(6.05, 0, 0));
+ projection.reconcile();
+ expect(batchMatrixData(batch, "_previousMatricesTexture")).toEqual(first);
+ expect(batchMatrixData(batch, "_matricesTexture")).not.toEqual(first);
+ const moved = batchMatrixData(batch, "_matricesTexture").slice();
+ projection.commit();
+ // Committing cannot rewrite the history the just-rendered frame consumed.
+ expect(batchMatrixData(batch, "_previousMatricesTexture")).toEqual(first);
+ projection.reconcile();
+ expect(batchMatrixData(batch, "_previousMatricesTexture")).toEqual(moved);
+ expect(scan).not.toHaveBeenCalled();
+ } finally {
+ projection.dispose();
+ scan.mockRestore();
+ }
+ });
+
+ it("resets opted-out history when temporal rendering is toggled and releases owned textures", () => {
+ const { batch, movingBatchInstanceId, scene } = velocitySceneFixture();
+ batch.userData.useVelocity = false;
+ let velocity = false;
+ const projection = new SceneRenderProjection(scene, {
+ projection: false,
+ velocity: () => velocity,
+ onReport: () => undefined,
+ });
+ projection.reconcile();
+ projection.commit();
+ expect(readBatchedMeshPreviousMatrices(batch)).toBeUndefined();
+ velocity = true;
+ projection.reconcile();
+ projection.commit();
+ const firstTexture = readBatchedMeshPreviousMatrices(batch);
+ expect(firstTexture).toBeDefined();
+ let disposals = 0;
+ firstTexture?.addEventListener("dispose", () => {
+ disposals += 1;
+ });
+ expect(batch.userData.useVelocity).toBe(true);
+
+ velocity = false;
+ projection.reconcile();
+ projection.commit();
+ expect(disposals).toBe(1);
+ expect(readBatchedMeshPreviousMatrices(batch)).toBeUndefined();
+ expect(readVelocityPreviousMatrices(batch)).toBeUndefined();
+ expect(readVelocityPreviousWorldMatrix(batch)).toBeUndefined();
+ expect(batch.userData.useVelocity).toBe(false);
+
+ batch.setMatrixAt(movingBatchInstanceId, new Matrix4().makeTranslation(8, 0, 0));
+ velocity = true;
+ projection.reconcile();
+ expect(batchMatrixData(batch, "_previousMatricesTexture")).toEqual(
+ batchMatrixData(batch, "_matricesTexture"),
+ );
+ const secondTexture = readBatchedMeshPreviousMatrices(batch);
+ expect(secondTexture).not.toBe(firstTexture);
+ secondTexture?.addEventListener("dispose", () => {
+ disposals += 1;
+ });
+ projection.dispose();
+ projection.dispose();
+ expect(disposals).toBe(2);
+ expect(readBatchedMeshPreviousMatrices(batch)).toBeUndefined();
+ expect(batch.userData.useVelocity).toBe(false);
+ });
+
+ it("releases authored batch history when an opted-out scene removes the batch", () => {
+ const { batch, scene } = velocitySceneFixture();
+ const projection = new SceneRenderProjection(scene, {
+ projection: false,
+ velocity: true,
+ onReport: () => undefined,
+ });
+ projection.reconcile();
+ const texture = readBatchedMeshPreviousMatrices(batch);
+ expect(texture).toBeDefined();
+ let disposals = 0;
+ texture?.addEventListener("dispose", () => {
+ disposals += 1;
+ });
+ scene.remove(batch);
+ projection.reconcile();
+ projection.commit();
+ expect(disposals).toBe(1);
+ expect(readBatchedMeshPreviousMatrices(batch)).toBeUndefined();
+ expect(readVelocityPreviousMatrices(batch)).toBeUndefined();
+ expect(batch.userData).not.toHaveProperty("useVelocity");
+ projection.dispose();
+ expect(disposals).toBe(1);
+ });
+
+ it("does no history traversal with projection and temporal rendering disabled", () => {
+ const { batch, scene } = velocitySceneFixture();
+ const walk = vi.spyOn(scene, "traverse");
+ const matrices = vi.spyOn(scene, "updateMatrixWorld");
+ const projection = new SceneRenderProjection(scene, {
+ projection: false,
+ velocity: false,
+ onReport: () => undefined,
+ });
+ // The one-time disabled report counts renderables; steady frames do no history work.
+ projection.reconcile();
+ walk.mockClear();
+ matrices.mockClear();
+ for (let frame = 0; frame < 3; frame += 1) {
+ projection.reconcile();
+ projection.commit();
+ }
+ expect(walk).not.toHaveBeenCalled();
+ expect(matrices).not.toHaveBeenCalled();
+ expect(readBatchedMeshPreviousMatrices(batch)).toBeUndefined();
+ expect(readVelocityPreviousMatrices(batch)).toBeUndefined();
+ expect(batch.userData).not.toHaveProperty("useVelocity");
+ projection.dispose();
+ walk.mockRestore();
+ matrices.mockRestore();
+ });
+
it("freezes rigid and bone history at the scheduled frame boundary", () => {
const scene = new Scene();
const rigid = new Mesh(new BoxGeometry(1, 1, 1), new MeshStandardMaterial());
@@ -466,7 +606,7 @@ describe("velocity provisioning on the shipped path", () => {
expect(textureNames(missingProviderPass)).not.toContain("velocity");
});
- it("renders non-zero MRT footprints for moved rigid, skinned, instanced, and batched objects", () => {
+ it.each([true, false])("renders non-zero MRT footprints with projection %s", (enabled) => {
const fixture = velocitySceneFixture();
const renderer = new SoftwareVelocityRenderer(fixture.scenePass, 200, 100);
let receivedVelocityNode: Node | undefined;
@@ -486,9 +626,13 @@ describe("velocity provisioning on the shipped path", () => {
report: () => undefined,
});
- const tracker = new VelocityTracker();
- tracker.update(fixture.scene);
- tracker.commit(fixture.scene);
+ const projection = new SceneRenderProjection(fixture.scene, {
+ projection: enabled,
+ velocity: true,
+ onReport: () => undefined,
+ });
+ projection.reconcile();
+ projection.commit();
fixture.rigid.position.x += 0.75;
const rootBone = fixture.character.skeleton.bones[0];
@@ -500,7 +644,7 @@ describe("velocity provisioning on the shipped path", () => {
new Matrix4().makeTranslation(6.05, 0, 0),
);
fixture.scene.updateMatrixWorld(true);
- tracker.update(fixture.scene);
+ projection.reconcile();
renderer.setShaderState(
prepareVelocityShaderState(fixture.camera, {
@@ -508,7 +652,7 @@ describe("velocity provisioning on the shipped path", () => {
}),
);
const rendered = renderer.render(fixture.camera);
- tracker.commit(fixture.scene);
+ projection.commit();
expect(chain.applied.velocity).toMatchObject({ provisioned: true, source: "mrt" });
expect(fixture.scenePass.getMRT()?.has("velocity")).toBe(true);
@@ -525,6 +669,7 @@ describe("velocity provisioning on the shipped path", () => {
expect(rendered.footprints.get("instanced-static")?.movingPixels).toBe(0);
expect(rendered.footprints.get("batched-moving")?.movingPixels).toBeGreaterThan(0);
expect(rendered.footprints.get("batched-static")?.movingPixels).toBe(0);
+ projection.dispose();
});
it("feeds the scheduled snapshots into Three's instance and skinning update hooks", () => {
diff --git a/packages/core/src/renderProjection.ts b/packages/core/src/renderProjection.ts
index 9933db7b9f..a878a8c729 100644
--- a/packages/core/src/renderProjection.ts
+++ b/packages/core/src/renderProjection.ts
@@ -166,7 +166,7 @@ export interface IRenderProjectionOptions {
* each frame. The verdict is reported as `disabled`, not as one of the measured declines.
*/
readonly projection?: boolean | { readonly materialChecks?: ProjectionMaterialChecks };
- /** Allocates per-sub-draw previous matrices for the material-batching lane. */
+ /** Retains drawn-object history for temporal stages, independently of projection opt-out. */
readonly velocity?: boolean | (() => boolean);
/**
* The engine's world-matrix walk, when the frame owns one. The authored scene is refreshed here
@@ -287,10 +287,15 @@ export class SceneRenderProjection {
* scene is not what renders and nothing else refreshes it.
*/
reconcile(): void {
+ const velocityEnabled = resolveVelocityEnabled(this.#velocity);
+ if (this.#velocityActive !== velocityEnabled) {
+ this.#velocityTracker.clear();
+ this.#velocityActive = velocityEnabled;
+ }
if (!this.#enabled) {
- // The game declined the projection: report the verdict once, then do nothing at all. No
- // mirror is built, no eligibility scan runs, and `root` is the authored scene — the opt-out
- // costs a compare, not a re-judged decline.
+ // Temporal history belongs to the authored draw even when its optimization is declined.
+ // No mirror or eligibility scan runs; without a temporal consumer no history work runs.
+ if (velocityEnabled) this.#velocityTracker.update(this.#source);
this.#deoptimize("disabled", "the game set renderer.projection to false");
this.#publish();
return;
@@ -298,11 +303,6 @@ export class SceneRenderProjection {
const mirror = this.#mirror;
if (mirror === undefined) return;
const startedAt = globalThis.performance?.now() ?? 0;
- const velocityEnabled = resolveVelocityEnabled(this.#velocity);
- if (this.#velocityActive !== velocityEnabled) {
- this.#velocityTracker.clear();
- this.#velocityActive = velocityEnabled;
- }
if (mirror.setVelocityEnabled(velocityEnabled)) {
this.#deoptimized = true;
this.#framesSinceDeclineScan = DECLINE_RESCAN_FRAMES;
@@ -414,7 +414,7 @@ export class SceneRenderProjection {
/** Commits the rendered transform snapshot after the colour and velocity passes consume it. */
commit(): void {
- if (!this.#enabled || !this.#velocityActive) return;
+ if (!this.#velocityActive) return;
this.#velocityTracker.commit(this.root);
}
From ac9b0f76ab7df1ec7da3d4f858b56583d11f778f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 00:07:52 -0700
Subject: [PATCH 03/90] docs(prd455): prioritize full-resolution temporal AA
milestone
---
...-reconstruction-from-dynamic-resolution.md | 22 +++++++++++++++----
1 file changed, 18 insertions(+), 4 deletions(-)
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index 5e917f42aa..db767799e7 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -4,7 +4,7 @@ prd_contract: v1
# PRD-455 — Fewer rendered pixels reconstruct into a stable full-resolution frame
-**Status:** PROPOSED — filed 2026-09-26.
+**Status:** IN PROGRESS — full-resolution temporal-AA milestone first (owner, 2026-10-02).
**Priority:** highest-value rendering project after the streaming quick wins.
**Complexity:** 8 → HIGH. The renderer already has the difficult prerequisites; the remaining risk is history correctness and proving reconstruction wins more GPU time than it costs.
**Depends on:** the landed motion-history implementation from PRD-269 (`packages/core/src/render/velocity.ts`, commit `3630847a`), the existing `RenderChain`, and [PRD-384 adaptive resolution](../PRD-384-adaptive-resolution-gpu-headroom.md).
@@ -50,6 +50,18 @@ the existing full-resolution path remains the baseline.
public knobs, if any survive measurement, are correctness/performance limits rather than a visual
style.
+## Implementation order (owner direction, 2026-10-02)
+
+First qualify plain full-resolution temporal AA using the installed Three.js 0.185.1 TRAANode,
+RenderChain and VelocityTracker. The generated game owns the opt-in provider and history-reset
+policy; no template default changes. Add a deterministic shared fixture, CPU regressions and a
+maintained headed WebGPU screenshot lane before attempting lower-resolution reconstruction.
+Then extend the existing renderer sizing seam to distinguish internal and display dimensions,
+retain one scaler, and qualify the original reconstruction/visual/performance outcomes below.
+Every PR revision retains actual runtime screenshots when the hosted capture lane can execute;
+CPU-only checks never qualify image quality or native/hardware performance. Do not promote this
+experimental path or mark the draft ready before the outstanding acceptance evidence exists.
+
## Integration ledger
| Existing surface | Change |
@@ -59,17 +71,19 @@ the existing full-resolution path remains the baseline.
| `packages/core/src/resolution-scaler.ts` | No new policy. Expose/consume the resolved scale and reset history on size transitions. |
| `packages/runtime-native/conformance/scenes/shared/` | Add one reconstruction scene that runs the same source on browser/native targets. |
-## Phase 1 — Define history correctness before chasing image quality
+### Phase 1 — Define history correctness before chasing image quality
+
+- [ ] Full-resolution temporal AA is opt-in generated source, uses the existing velocity source and resets history on discontinuity. **proof:** focused TRAANode/RenderChain tests and the deterministic runtime temporal fixture with actual screenshots; native qualification remains separately reported.
- [ ] The reconstruction stage produces a display-sized output from a smaller colour/depth input and records input size, output size, history-valid state and rejection fraction. **proof:** focused render-chain test runs 0.67→1.0 sizing, then a mutation returning the low-resolution target directly fails the output-size assertion.
- [ ] Camera cuts, projection changes and resolution changes invalidate history for the affected frame; moving skinned and instanced fixtures use the existing velocity source rather than a camera-only approximation. **proof:** deterministic fixture covers cut/resize/skinned/instanced cases and a zero-velocity mutation fails the moving-object rejection/stability assertion.
-## Phase 2 — Prove motion stability on content that exposes temporal defects
+### Phase 2 — Prove motion stability on content that exposes temporal defects
- [ ] A fixed camera route containing thin fences, foliage, sub-pixel edges, a moving character and an instanced moving object stays within pinned temporal-stability/ghosting thresholds against a full-resolution reference. **proof:** automated frame-sequence report records edge flicker, rejected-history ratio and image delta for full-res, low-res spatial upscale and temporal reconstruction; the temporal arm must beat the spatial arm on the named stability metric.
- [ ] Newly revealed surfaces do not inherit stale colour after occlusion/disocclusion events. **proof:** foreground-occluder fixture reveals a contrasting background and asserts stale-history pixels decay within the declared frame bound; disabling disocclusion rejection makes it fail.
-## Phase 3 — Keep it only if it buys real frame time
+### Phase 3 — Keep it only if it buys real frame time
- [ ] On a GPU-bound representative game, sub-1.0 rendering plus reconstruction lowers GPU/render p95 versus full-resolution rendering while meeting the Phase-2 visual thresholds. **proof:** paired fixed-route browser WebGPU and desktop-native table records internal pixels, reconstruction cost, total GPU/render p50/p95 and visual metrics; no “FPS only” verdict.
- [ ] Automatic resolution can move between at least three scales during one run without history corruption, allocation growth or a reconstruction cost spike larger than the saved raster cost. **proof:** scripted scaler route records scale transitions, history resets, render-target allocation count and per-stage cost; repeated up/down cycles end at the initial allocation baseline.
From 9113c4f7c7d1ebfddce7c9cf35fd33801506d59d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 00:15:51 -0700
Subject: [PATCH 04/90] docs: track original PRD-269 acceptance and core build
proof
---
...ion-vectors-or-the-temporal-filters-lie.md | 20 +++++++++++--------
1 file changed, 12 insertions(+), 8 deletions(-)
diff --git a/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md b/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
index ea2ddb0bae..4e7c9c38a7 100644
--- a/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
+++ b/docs/PRDs/lighting/PRD-269-motion-vectors-or-the-temporal-filters-lie.md
@@ -107,7 +107,6 @@ Actual relevant runtime screenshots must be attached to the PR before merge (own
2026-10-02). They remain unverified; software-rasterizer output and test-log screenshots do not
satisfy this gate.
-
Browser/native GPU execution requires a working WebGPU device or supported native host. This
cloud environment has no `/dev/dri`, Android device tooling or `/dev/kvm`; the batch's attempted
Xvfb launch failed with `EPERM`. Keep the PR draft until the original image-space and native
@@ -116,28 +115,32 @@ is inferred from the CPU tests.
## Acceptance criteria
-1. **A moving skinned mesh produces non-zero velocity where it moved, and zero where it did not.**
+- [ ] **A moving skinned mesh produces non-zero velocity where it moved, and zero where it did not.** proof: PR #393 GPU fixture capture and velocity-buffer assertions (pending).
A fixture animates one skinned mesh in front of a static wall; the velocity buffer is non-zero
over the mesh's screen footprint and zero over the wall, within tolerance. *Mutation:* write the
current world matrix into the previous-transform slot and the spec fails with a zero buffer over
the mesh.
-2. **Per-instance motion is per-instance.** With an `InstancedMesh` where one instance moves and the
+- [ ] **Per-instance motion is per-instance.** proof: PR #393 `InstancedMesh` and `BatchedMesh` per-instance GPU assertions (pending).
+ With an `InstancedMesh` where one instance moves and the
rest are still, velocity is non-zero only over the moving instance. *Mutation:* track one
transform for the whole `InstancedMesh` and the spec fails by marking every instance as moving.
The same case is asserted for `BatchedMesh` sub-draws.
-3. **Ghosting is measured, not judged by eye.** A playtest drives a character across a
+- [ ] **Ghosting is measured, not judged by eye.** proof: PR #393 ghosting playtest with a pinned threshold and zero-velocity control (pending).
+ A playtest drives a character across a
GI-lit background and asserts the disocclusion-rejection fraction stays below a pinned threshold
while the temporal stage remains active. *Mutation:* feed the temporal node a zero velocity
buffer and the assertion fails on the rejection fraction — the failing number is pasted in the
PRD's red before the fix lands.
-4. **No temporal stage requested, no velocity cost.** With every temporal stage off, no velocity
+- [ ] **No temporal stage requested, no velocity cost.** proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts` plus PR #393 temporal-off/on frame-cost measurement (pending).
+ With every temporal stage off, no velocity
target is allocated and the `render` phase is unchanged within noise. *Mutation:* allocate it
unconditionally and the allocation spec fails naming the target.
-5. **Bookkeeping is frame-ordered, not incidental.** Moving an object after the velocity update
+- [ ] **Bookkeeping is frame-ordered, not incidental.** proof: `pnpm exec vitest run packages/core/__tests__/render-velocity.spec.ts` plus PR #393 live colour/velocity ordering assertions (pending).
+ Moving an object after the velocity update
point within the same frame produces a velocity consistent with the colour pass — the two agree
or the frame is wrong. *Mutation:* update previous transforms at draw time instead of at the
scheduled point and the ordering spec fails.
@@ -166,8 +169,9 @@ before completing. `pnpm test` exits 2 before assertions because tsx cannot open
(`listen EPERM`). A direct core typecheck/build additionally needs the playtest package's missing
built declarations; its normal build reaches the same tsx IPC restriction. Running the same
validator with `node --import tsx` followed by the package's tsup build succeeds, after which
-`tsc --noEmit -p packages/core/tsconfig.json` passes. The root typecheck/full test/core package
-build remain unverified. `node packages/playtest/dist/runner/cli.js doctor --text` exits 2:
+`tsc --noEmit -p packages/core/tsconfig.json` passes. After that dependency was available,
+`pnpm --filter @threenative/core build` was rerun serially and passes ESM, DTS and publint
+(exit 0). The root typecheck and full test suite remain unverified. `node packages/playtest/dist/runner/cli.js doctor --text` exits 2:
`TN_PLAYTEST_RUNNER_FAILED`, adb not found.
2026-10-02 qualification start: existing `render-velocity.spec.ts` passes 11/11 CPU tests.
From 1e7d365ea94855dd36f85e6c1c218d9047572557 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 01:34:53 -0700
Subject: [PATCH 05/90] fix(render): pass temporal jitter the velocity accessor
---
...-reconstruction-from-dynamic-resolution.md | 7 ++
.../core/__tests__/temporal-chain.spec.ts | 66 +++++++++++++++++++
packages/core/src/render/chain.ts | 5 +-
3 files changed, 77 insertions(+), 1 deletion(-)
create mode 100644 packages/core/__tests__/temporal-chain.spec.ts
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index db767799e7..b01d30ef99 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -75,6 +75,13 @@ experimental path or mark the draft ready before the outstanding acceptance evid
- [ ] Full-resolution temporal AA is opt-in generated source, uses the existing velocity source and resets history on discontinuity. **proof:** focused TRAANode/RenderChain tests and the deterministic runtime temporal fixture with actual screenshots; native qualification remains separately reported.
+ Partial, 2026-10-02: the installed TRAANode setup/jitter regression reproduced
+ `setProjectionMatrix is not a function` because RenderChain supplied a sampled texture where
+ Three expects its velocity accessor. The caller now keeps accessor and texture separate;
+ `vitest run packages/core/__tests__/{temporal-chain,render-chain,render-velocity}.spec.ts
+ --maxWorkers=1` passes 56 tests after fresh-checkout red-to-green reproduction. No runtime,
+ image-quality, native, or performance qualification is claimed by these CPU tests.
+
- [ ] The reconstruction stage produces a display-sized output from a smaller colour/depth input and records input size, output size, history-valid state and rejection fraction. **proof:** focused render-chain test runs 0.67→1.0 sizing, then a mutation returning the low-resolution target directly fails the output-size assertion.
- [ ] Camera cuts, projection changes and resolution changes invalidate history for the affected frame; moving skinned and instanced fixtures use the existing velocity source rather than a camera-only approximation. **proof:** deterministic fixture covers cut/resize/skinned/instanced cases and a zero-velocity mutation fails the moving-object rejection/stability assertion.
diff --git a/packages/core/__tests__/temporal-chain.spec.ts b/packages/core/__tests__/temporal-chain.spec.ts
new file mode 100644
index 0000000000..bb92baea34
--- /dev/null
+++ b/packages/core/__tests__/temporal-chain.spec.ts
@@ -0,0 +1,66 @@
+import { PerspectiveCamera, Scene } from "three";
+import TRAANode from "three/addons/tsl/display/TRAANode.js";
+import { pass, velocity } from "three/tsl";
+import type { Node, NodeBuilder, TextureNode } from "three/webgpu";
+import { describe, expect, it } from "vitest";
+import { RenderChain } from "../src/render/chain.js";
+
+describe("the pinned TRAANode render-chain contract", () => {
+ it("keeps the sampled velocity texture separate from the jitter accessor", () => {
+ const camera = new PerspectiveCamera(50, 1280 / 720);
+ const scenePass = pass(new Scene(), camera);
+ let graph: unknown;
+ let temporal: TRAANode | undefined;
+ let sampledVelocity: Node | undefined;
+ const chain = new RenderChain({
+ renderer: {
+ kind: "webgpu",
+ raw: {},
+ setOutputNode: (node) => {
+ graph = node;
+ },
+ },
+ input: scenePass.getTextureNode(),
+ request: { stages: ["traa"], velocity: { pass: scenePass } },
+ report: () => {},
+ stages: [
+ {
+ name: "traa",
+ build: (input, context) => {
+ sampledVelocity = context.velocityNode;
+ temporal = new TRAANode(
+ input as TextureNode,
+ scenePass.getTextureNode("depth"),
+ context.velocityNode as TextureNode,
+ camera,
+ );
+ return temporal;
+ },
+ },
+ ],
+ });
+ expect(chain.applied.stages).toEqual(["traa"]);
+ expect(sampledVelocity).toBe(scenePass.getTextureNode("velocity"));
+ const wrapped = graph as { value: { velocity: unknown } };
+ temporal?.setup({
+ context: { ...wrapped.value, renderPipeline: { context: {} } },
+ renderer: {},
+ } as unknown as NodeBuilder);
+ const jitter = temporal as unknown as {
+ setViewOffset(width: number, height: number): void;
+ clearViewOffset(): void;
+ };
+ try {
+ expect(() => jitter.setViewOffset(1280, 720)).not.toThrow();
+ expect(wrapped.value.velocity).toBe(velocity);
+ expect(camera.view?.enabled).toBe(true);
+ } finally {
+ // A failed assertion must not leave Three's singleton velocity accessor jittered.
+ if (wrapped.value.velocity === velocity) jitter.clearViewOffset();
+ temporal?.dispose();
+ chain.dispose();
+ scenePass.dispose();
+ }
+ expect(camera.view?.enabled).toBe(false);
+ });
+});
diff --git a/packages/core/src/render/chain.ts b/packages/core/src/render/chain.ts
index 1e8d74bec6..f92b955071 100644
--- a/packages/core/src/render/chain.ts
+++ b/packages/core/src/render/chain.ts
@@ -1,3 +1,4 @@
+import { velocity as velocityAccessor } from "three/tsl";
import type { MRTNode, Node } from "three/webgpu";
import type { IFrameBudgetWindow } from "../frame-budget.js";
@@ -417,7 +418,9 @@ export class RenderChain {
requiresVelocityFor(this.#stageDefinitions.get(name), name),
);
if (velocityNode !== undefined && hasActiveVelocityStage)
- node = withVelocityContext(node, velocityNode);
+ // TRAANode uses context.velocity to set the unjittered projection, not to sample MRT.
+ // The sampled texture already travels to the factory via context.velocityNode.
+ node = withVelocityContext(node, velocityAccessor);
if (stages.length > 0) {
try {
From bbbf93ca8c10a30b168fdb984d31a7567ebeccaf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 01:53:17 -0700
Subject: [PATCH 06/90] feat(render): add opt-in temporal AA qualification
fixture
---
.github/workflows/integration-temporal.yml | 43 ++++++
...-reconstruction-from-dynamic-resolution.md | 12 ++
.../playtests/temporal-aa.playtest.json | 13 ++
examples/abyss-framework/temporal-main.js | 20 +++
examples/abyss-framework/temporal.html | 1 +
.../abyss-framework/temporal.vite.config.ts | 14 ++
.../__tests__/scaffold.spec.ts | 4 +-
.../__tests__/temporal-aa.spec.ts | 128 +++++++++++++++++
.../templates/starter/AGENTS.md | 2 +
.../templates/starter/CLAUDE.md | 2 +
.../starter/src/render/temporalAA.ts | 131 ++++++++++++++++++
.../runtime-native/conformance/registry.json | 16 +++
.../scenes/shared/temporal-aa-fixture.js | 104 ++++++++++++++
.../conformance/scenes/shared/temporal-aa.js | 9 ++
scripts/verify-temporal-aa.ts | 120 ++++++++++++++++
15 files changed, 618 insertions(+), 1 deletion(-)
create mode 100644 .github/workflows/integration-temporal.yml
create mode 100644 examples/abyss-framework/playtests/temporal-aa.playtest.json
create mode 100644 examples/abyss-framework/temporal-main.js
create mode 100644 examples/abyss-framework/temporal.html
create mode 100644 examples/abyss-framework/temporal.vite.config.ts
create mode 100644 packages/create-threenative/__tests__/temporal-aa.spec.ts
create mode 100644 packages/create-threenative/templates/starter/src/render/temporalAA.ts
create mode 100644 packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js
create mode 100644 packages/runtime-native/conformance/scenes/shared/temporal-aa.js
create mode 100644 scripts/verify-temporal-aa.ts
diff --git a/.github/workflows/integration-temporal.yml b/.github/workflows/integration-temporal.yml
new file mode 100644
index 0000000000..ea0c45c88b
--- /dev/null
+++ b/.github/workflows/integration-temporal.yml
@@ -0,0 +1,43 @@
+name: Integration temporal AA
+on:
+ pull_request:
+ paths:
+ - 'packages/core/src/render/chain.ts'
+ - 'packages/core/src/render/velocity.ts'
+ - 'packages/core/__tests__/temporal-chain.spec.ts'
+ - 'packages/create-threenative/templates/starter/src/render/temporalAA.ts'
+ - 'packages/create-threenative/__tests__/temporal-aa.spec.ts'
+ - 'packages/runtime-native/conformance/scenes/shared/temporal-aa*.js'
+ - 'examples/abyss-framework/temporal*'
+ - 'examples/abyss-framework/playtests/temporal-aa.playtest.json'
+ - 'scripts/verify-temporal-aa.ts'
+ - '.github/workflows/integration-temporal.yml'
+permissions:
+ contents: read
+jobs:
+ temporal:
+ runs-on: ubuntu-24.04
+ timeout-minutes: 20
+ steps:
+ - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
+ with:
+ persist-credentials: false
+ - uses: ./.github/actions/pnpm
+ - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+ with:
+ node-version: '22'
+ cache: pnpm
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm --filter @threenative/playtest build
+ - uses: ./.github/actions/playwright-chromium
+ - name: Validate actual TRAANode and history lifecycle contracts
+ run: pnpm exec vitest run packages/core/__tests__/temporal-chain.spec.ts packages/core/__tests__/render-chain.spec.ts packages/core/__tests__/render-velocity.spec.ts packages/create-threenative/__tests__/temporal-aa.spec.ts --maxWorkers=2
+ - name: Render temporal motion and reset variants
+ run: node --import tsx scripts/verify-temporal-aa.ts
+ - name: Retain actual runtime screenshots and adapter evidence
+ if: always()
+ uses: actions/upload-artifact@v7
+ with:
+ name: temporal-aa-${{ github.event.pull_request.head.sha }}
+ path: artifacts/temporal-aa
+ if-no-files-found: error
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index b01d30ef99..696406cc68 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -82,6 +82,18 @@ experimental path or mark the draft ready before the outstanding acceptance evid
--maxWorkers=1` passes 56 tests after fresh-checkout red-to-green reproduction. No runtime,
image-quality, native, or performance qualification is claimed by these CPU tests.
+ Partial, 2026-10-02: starter-only generated `temporalAA.ts` now reuses TRAANode and owns
+ explicit cut/reset, projection/size invalidation, raster-size guards and disposal. The shared
+ fixture exercises moving rigid/skinned/instanced content; `integration-temporal.yml` captures
+ reference, temporal, cut, projection and resize variants through the existing headed playtest
+ runner. Fresh focused checks: 297/297 source/scaffold/workflow tests, 67/67 native-conformance
+ contract tests, root TypeScript check, core build, fixture web build and shared native bundle
+ all pass. These are source/contracts/builds, not native execution. Local runtime capture was
+ attempted and refused because this environment has neither Xvfb nor a usable X display;
+ the hosted lane must supply actual screenshots and adapter evidence before this box is checked.
+ The complete repository test/budget/quality board and temporal visual-quality corpus are still
+ unrun for this slice. The optional conformance row does not qualify any native target.
+
- [ ] The reconstruction stage produces a display-sized output from a smaller colour/depth input and records input size, output size, history-valid state and rejection fraction. **proof:** focused render-chain test runs 0.67→1.0 sizing, then a mutation returning the low-resolution target directly fails the output-size assertion.
- [ ] Camera cuts, projection changes and resolution changes invalidate history for the affected frame; moving skinned and instanced fixtures use the existing velocity source rather than a camera-only approximation. **proof:** deterministic fixture covers cut/resize/skinned/instanced cases and a zero-velocity mutation fails the moving-object rejection/stability assertion.
diff --git a/examples/abyss-framework/playtests/temporal-aa.playtest.json b/examples/abyss-framework/playtests/temporal-aa.playtest.json
new file mode 100644
index 0000000000..0e9b4af1d3
--- /dev/null
+++ b/examples/abyss-framework/playtests/temporal-aa.playtest.json
@@ -0,0 +1,13 @@
+{
+ "name": "full-resolution-temporal-aa",
+ "schemaVersion": 1,
+ "target": "web",
+ "viewport": { "width": 1280, "height": 720 },
+ "warmupFrames": 0,
+ "artifacts": { "screenshots": "before-after" },
+ "steps": [{ "kind": "wait", "label": "motion", "waitTicks": 4 }],
+ "assert": {
+ "resources": [{ "id": "temporal", "path": "frame", "gte": 24, "changed": true }],
+ "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true }
+ }
+}
diff --git a/examples/abyss-framework/temporal-main.js b/examples/abyss-framework/temporal-main.js
new file mode 100644
index 0000000000..d08b3da87c
--- /dev/null
+++ b/examples/abyss-framework/temporal-main.js
@@ -0,0 +1,20 @@
+import { installThreePlaytestBridge } from "@threenative/playtest/three";
+import { NoToneMapping, PerspectiveCamera, Scene, WebGPURenderer } from "three/webgpu";
+import { createTemporalAAFixture } from "../../packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js";
+
+const renderer = new WebGPURenderer({ antialias: false });
+renderer.setPixelRatio(1);
+renderer.setSize(1280, 720);
+renderer.toneMapping = NoToneMapping;
+document.body.appendChild(renderer.domElement);
+await renderer.init();
+const scene = new Scene();
+const camera = new PerspectiveCamera(50, 1280 / 720, 0.1, 100);
+const fixture = createTemporalAAFixture(renderer, scene, camera, new URLSearchParams(location.search).get("variant") ?? "temporal");
+for (let index = 0; index < 20; index++) fixture.render();
+installThreePlaytestBridge({
+ camera, scene, renderer,
+ fixedStep: async (ticks) => { for (let index = 0; index < ticks; index++) fixture.render(); return ticks; },
+ resources: { read: () => ({ temporal: fixture.observation() }) },
+ tick: () => fixture.observation().frame,
+});
diff --git a/examples/abyss-framework/temporal.html b/examples/abyss-framework/temporal.html
new file mode 100644
index 0000000000..10583d4ebd
--- /dev/null
+++ b/examples/abyss-framework/temporal.html
@@ -0,0 +1 @@
+Temporal AA qualification
diff --git a/examples/abyss-framework/temporal.vite.config.ts b/examples/abyss-framework/temporal.vite.config.ts
new file mode 100644
index 0000000000..741ec7a3c3
--- /dev/null
+++ b/examples/abyss-framework/temporal.vite.config.ts
@@ -0,0 +1,14 @@
+import { fileURLToPath } from "node:url";
+import { defineConfig } from "vite";
+
+// Asset-free qualification scene, using this checkout's bundled bridge and render source directly.
+export default defineConfig({
+ build: { rollupOptions: { input: fileURLToPath(new URL("./temporal.html", import.meta.url)) } },
+ resolve: {
+ alias: {
+ "@threenative/playtest/three": fileURLToPath(
+ new URL("../../packages/playtest/dist/three/index.js", import.meta.url),
+ ),
+ },
+ },
+});
diff --git a/packages/create-threenative/__tests__/scaffold.spec.ts b/packages/create-threenative/__tests__/scaffold.spec.ts
index b15916be70..7dc70aff27 100644
--- a/packages/create-threenative/__tests__/scaffold.spec.ts
+++ b/packages/create-threenative/__tests__/scaffold.spec.ts
@@ -194,7 +194,8 @@ const PRD_201_PARENT_SCAFFOLD_HASHES: Readonly> = {
sailing: "93f7526320547acd320a340774e5384b2c42c109379bff2437cb2b01e1b0e149",
shooter: "d5a0cf3706e7a0b621fa9290564ac896467b256154d7f6abdf75ca4c36aade91",
snow: "d59cab83418e9636bb9b48f8b802b3c36defdc5889e4a03c96b1167b7a4f2623",
- starter: "d6d685a7ddba9d074869bf76afa1400357503ece29e96d857a3322c8ca61c078",
+ // PRD-455: starter-only opt-in temporalAA.ts plus its ownership/qualification paragraph.
+ starter: "2a1ce31178413a9850216e0504a3a25dd0117823a3b86371db698f6608301970",
"tower-defense": "d50982f0cdfe90786e0042e7d7113d847856c9d9eed71673adfb42e6a9349287",
};
@@ -293,6 +294,7 @@ const STARTER_PATHS = [
"src/render/lighting.ts",
"src/render/postprocessing.ts",
"src/render/worldEnvironment.ts",
+ "src/render/temporalAA.ts",
"src/render/palette.ts",
"src/render/materials.ts",
"src/render/arena.ts",
diff --git a/packages/create-threenative/__tests__/temporal-aa.spec.ts b/packages/create-threenative/__tests__/temporal-aa.spec.ts
new file mode 100644
index 0000000000..7ff634519a
--- /dev/null
+++ b/packages/create-threenative/__tests__/temporal-aa.spec.ts
@@ -0,0 +1,128 @@
+import { PerspectiveCamera, Scene } from "three";
+import TRAANode from "three/addons/tsl/display/TRAANode.js";
+import { pass, velocity } from "three/tsl";
+import type { NodeBuilder, NodeFrame, RenderTarget, Texture } from "three/webgpu";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { createTemporalAA } from "../templates/starter/src/render/temporalAA.js";
+
+afterEach(() => vi.restoreAllMocks());
+function fixture() {
+ // GPU execution belongs to the runtime fixture. Unit tests isolate reset/lifetime ownership.
+ vi.spyOn(TRAANode.prototype, "updateBefore").mockImplementation(() => undefined);
+ const camera = new PerspectiveCamera(50, 1280 / 720);
+ const scenePass = pass(new Scene(), camera);
+ scenePass.setSize(1280, 720);
+ // Render-target initialization normally sizes depth on the GPU renderer.
+ scenePass.getTextureNode("depth").value.image = { width: 1280, height: 720 };
+ const temporal = createTemporalAA(
+ scenePass.getTextureNode(),
+ scenePass.getTextureNode("depth"),
+ scenePass.getTextureNode("velocity"),
+ camera,
+ );
+ const copies: { from: Texture; to: Texture }[] = [];
+ const frame = {
+ renderer: {
+ initRenderTarget: () => {},
+ copyTextureToTexture: (from: Texture, to: Texture) => {
+ copies.push({ from, to });
+ },
+ },
+ } as unknown as NodeFrame;
+ const node = temporal.node as unknown as {
+ setSize(width: number, height: number): void;
+ setViewOffset(width: number, height: number): void;
+ clearViewOffset(): void;
+ _historyRenderTarget: RenderTarget;
+ };
+ node.setSize(1280, 720);
+ temporal.node.setup({ context: { velocity }, renderer: {} } as unknown as NodeBuilder);
+ return { camera, copies, frame, node, scenePass, temporal };
+}
+
+describe("opt-in full-resolution temporal AA", () => {
+ it("seeds current colour on first use and a camera cut, not ordinary frames", () => {
+ const { temporal, frame, copies, scenePass, node } = fixture();
+ temporal.node.updateBefore(frame);
+ expect(temporal.report()).toMatchObject({
+ frame: 1,
+ historyValid: false,
+ resetReason: "initial",
+ inputWidth: 1280,
+ outputWidth: 1280,
+ });
+ expect(copies[0]).toEqual({
+ from: scenePass.renderTarget.texture,
+ to: node._historyRenderTarget.texture,
+ });
+ temporal.node.updateBefore(frame);
+ expect(temporal.report()).toMatchObject({ frame: 2, historyValid: true, resetReason: null });
+ expect(copies).toHaveLength(1);
+ temporal.resetHistory("camera-cut");
+ temporal.node.updateBefore(frame);
+ expect(temporal.report()).toMatchObject({
+ frame: 3,
+ historyValid: false,
+ resetReason: "camera-cut",
+ });
+ expect(copies).toHaveLength(2);
+ temporal.dispose();
+ scenePass.dispose();
+ });
+ it("invalidates projection changes before jitter, not ordinary camera motion", () => {
+ const { temporal, camera, frame, node, scenePass } = fixture();
+ node.setViewOffset(1280, 720);
+ node.clearViewOffset();
+ temporal.node.updateBefore(frame);
+ camera.position.x = 1;
+ node.setViewOffset(1280, 720);
+ node.clearViewOffset();
+ temporal.node.updateBefore(frame);
+ expect(temporal.report().historyValid).toBe(true);
+ camera.fov = 70;
+ node.setViewOffset(1280, 720);
+ node.clearViewOffset();
+ temporal.node.updateBefore(frame);
+ expect(temporal.report()).toMatchObject({
+ historyValid: false,
+ resetReason: "projection-change",
+ });
+ temporal.dispose();
+ scenePass.dispose();
+ });
+ it("reports changed raster size without claiming reconstruction", () => {
+ const { temporal, frame, scenePass, node } = fixture();
+ temporal.node.updateBefore(frame);
+ scenePass.setSize(640, 360);
+ scenePass.getTextureNode("depth").value.image = { width: 640, height: 360 };
+ node.setSize(640, 360);
+ temporal.node.updateBefore(frame);
+ expect(temporal.report()).toMatchObject({
+ historyValid: false,
+ resetReason: "resize",
+ inputWidth: 640,
+ inputHeight: 360,
+ outputWidth: 640,
+ outputHeight: 360,
+ });
+ temporal.dispose();
+ scenePass.dispose();
+ });
+ it("refuses mismatched velocity dimensions instead of sampling an unrelated raster", () => {
+ const { temporal, frame, scenePass } = fixture();
+ temporal.node.velocityNode.value.image = { width: 8, height: 8 };
+ expect(() => temporal.node.updateBefore(frame)).toThrow(/same raster/);
+ temporal.dispose();
+ scenePass.dispose();
+ });
+ it("releases temporal targets once and rejects use after disposal", () => {
+ const { temporal, frame, node, scenePass } = fixture();
+ const release = vi.spyOn(node._historyRenderTarget, "dispose");
+ temporal.dispose();
+ temporal.dispose();
+ expect(release).toHaveBeenCalledTimes(1);
+ expect(() => temporal.node.updateBefore(frame)).toThrow(/disposed/);
+ expect(() => temporal.resetHistory()).toThrow(/disposed/);
+ scenePass.dispose();
+ });
+});
diff --git a/packages/create-threenative/templates/starter/AGENTS.md b/packages/create-threenative/templates/starter/AGENTS.md
index a3b6db683e..80a4451856 100644
--- a/packages/create-threenative/templates/starter/AGENTS.md
+++ b/packages/create-threenative/templates/starter/AGENTS.md
@@ -85,6 +85,8 @@ therefore keep the previous clip's pose, and `boneContact` reports in metres whe
The shipped chain is ambient occlusion on `high` and `medium`, bloom, vignette, the tone curve and the shared SMAA. There are no authored paint stages: a real sun and a real sky carry the shading, and a Kuwahara smear or an ink outline over a photograph only cost frames. `quality.ts` owns tier and strength, and every `xxxEnabled: true` carries the measurement that justified it; `TN_RENDER_CHAIN` names each stage independently, and a missing stage observation is a failure.
`input.vector("move").y` is +up, so forward uses one explicit `-move.y` conversion. A scenario with no assertions or missing observations fails; open a real capture after visual changes. When a frame costs more than it should, find the object first: backtick opens the overlay, whose **Geometry** tab captures one frame on **Capture** and ranks the objects that submitted its triangles beside their projected size on screen; an agent gets the same report from `"assert": { "geometry": { "limit": 25 } }` in a scenario, which needs `runtime.geometry`. Those numbers are measured submissions reconciled against the frame's own pass totals, so the remainder the rows do not account for is reported, and what cannot be measured — a packed batch's per-member draws, unknown bounds — says so with a reason instead of reading as zero.
+`src/render/temporalAA.ts` is an experimental, opt-in full-resolution TRAANode provider. It is not enabled by the shipped quality tiers and does not upscale. Supply the same scene pass colour/depth/velocity through a `traa` RenderChain stage, disable scene-pass MSAA, reset history on camera cuts, and dispose with the stage. Its report measures global reset/size state; per-pixel rejection, native quality and frame-time wins remain unqualified.
+
## One shadow for a big outdoor level
When one directional light must shadow a whole valley and a 2048² map smudges, set `sun.shadow.shadowNode = new VirtualShadowNode(sun, { clipExtents: [12, 40, 120] })` from `@threenative/core`: camera-centred, texel-snapped clip levels, cached until the window moves and shared through Three's shadow slot. Bias, normal bias, intensity, radius, blur samples, map type and filter stay on `sun.shadow`; map sizes come from the options. For movers call `trackCaster(object)` — tracking or untracking refreshes the cached levels once, then movement draws a per-level mover map every frame without invalidating them; call `invalidateAll()` when static geometry changes. `TN_VIRTUAL_SHADOW` reports rendered, mover-map and cached-level work.
diff --git a/packages/create-threenative/templates/starter/CLAUDE.md b/packages/create-threenative/templates/starter/CLAUDE.md
index 4b5133c358..42648522e2 100644
--- a/packages/create-threenative/templates/starter/CLAUDE.md
+++ b/packages/create-threenative/templates/starter/CLAUDE.md
@@ -87,6 +87,8 @@ therefore keep the previous clip's pose, and `boneContact` reports in metres whe
The shipped chain is ambient occlusion on `high` and `medium`, bloom, vignette, the tone curve and the shared SMAA. There are no authored paint stages: a real sun and a real sky carry the shading, and a Kuwahara smear or an ink outline over a photograph only cost frames. `quality.ts` owns tier and strength, and every `xxxEnabled: true` carries the measurement that justified it; `TN_RENDER_CHAIN` names each stage independently, and a missing stage observation is a failure.
`input.vector("move").y` is +up, so forward uses one explicit `-move.y` conversion. A scenario with no assertions or missing observations fails; open a real capture after visual changes. When a frame costs more than it should, find the object first: backtick opens the overlay, whose **Geometry** tab captures one frame on **Capture** and ranks the objects that submitted its triangles beside their projected size on screen; an agent gets the same report from `"assert": { "geometry": { "limit": 25 } }` in a scenario, which needs `runtime.geometry`. Those numbers are measured submissions reconciled against the frame's own pass totals, so the remainder the rows do not account for is reported, and what cannot be measured — a packed batch's per-member draws, unknown bounds — says so with a reason instead of reading as zero.
+`src/render/temporalAA.ts` is an experimental, opt-in full-resolution TRAANode provider. It is not enabled by the shipped quality tiers and does not upscale. Supply the same scene pass colour/depth/velocity through a `traa` RenderChain stage, disable scene-pass MSAA, reset history on camera cuts, and dispose with the stage. Its report measures global reset/size state; per-pixel rejection, native quality and frame-time wins remain unqualified.
+
## One shadow for a big outdoor level
When one directional light must shadow a whole valley and a 2048² map smudges, set `sun.shadow.shadowNode = new VirtualShadowNode(sun, { clipExtents: [12, 40, 120] })` from `@threenative/core`: camera-centred, texel-snapped clip levels, cached until the window moves and shared through Three's shadow slot. Bias, normal bias, intensity, radius, blur samples, map type and filter stay on `sun.shadow`; map sizes come from the options. For movers call `trackCaster(object)` — tracking or untracking refreshes the cached levels once, then movement draws a per-level mover map every frame without invalidating them; call `invalidateAll()` when static geometry changes. `TN_VIRTUAL_SHADOW` reports rendered, mover-map and cached-level work.
diff --git a/packages/create-threenative/templates/starter/src/render/temporalAA.ts b/packages/create-threenative/templates/starter/src/render/temporalAA.ts
new file mode 100644
index 0000000000..ede66478e4
--- /dev/null
+++ b/packages/create-threenative/templates/starter/src/render/temporalAA.ts
@@ -0,0 +1,131 @@
+// Generated user source: opt-in full-resolution temporal AA using pinned Three.js TRAANode.
+// This is not an upscaler. Colour, depth and velocity must share the same raster dimensions.
+import { Matrix4, type OrthographicCamera, type PerspectiveCamera } from "three";
+import { traa } from "three/addons/tsl/display/TRAANode.js";
+import type { Node, RenderTarget, TextureNode } from "three/webgpu";
+
+export type TemporalResetReason =
+ | "initial"
+ | "camera-cut"
+ | "projection-change"
+ | "resize"
+ | "scene-reset"
+ | "device-loss";
+export interface ITemporalAAReport {
+ readonly frame: number;
+ /** Global history availability; per-pixel disocclusion rejection is not measured here. */
+ readonly historyValid: boolean;
+ readonly resetReason: TemporalResetReason | null;
+ readonly inputWidth: number;
+ readonly inputHeight: number;
+ readonly outputWidth: number;
+ readonly outputHeight: number;
+}
+
+/**
+ * Reuse TRAANode's jitter, depth rejection and variance clipping. In a RenderChain `traa` factory,
+ * pass context.velocityNode and the scene pass's depth. Keep the scene pass single-sampled.
+ * Call resetHistory("camera-cut") on teleports and dispose with the owning stage/scene.
+ */
+export function createTemporalAA(
+ colour: Node,
+ depth: TextureNode,
+ velocity: TextureNode,
+ camera: PerspectiveCamera | OrthographicCamera,
+) {
+ const node = traa(colour, depth, velocity, camera);
+ // Three 0.185.1 exposes no reset API. Isolate its pinned target seams here: its own resize
+ // restart seeds the history from current colour, which also prevents stale colour after cuts.
+ const internals = node as unknown as {
+ beautyNode: TextureNode & {
+ isRTTNode?: boolean;
+ renderTarget?: RenderTarget;
+ passNode?: { renderTarget: RenderTarget };
+ };
+ _historyRenderTarget: RenderTarget;
+ _resolveRenderTarget: RenderTarget;
+ setViewOffset(width: number, height: number): void;
+ };
+ const projection = new Matrix4().copy(camera.projectionMatrix);
+ let pending: TemporalResetReason | null = "initial";
+ let disposed = false;
+ let report: ITemporalAAReport = {
+ frame: 0,
+ historyValid: false,
+ resetReason: "initial",
+ inputWidth: 0,
+ inputHeight: 0,
+ outputWidth: 0,
+ outputHeight: 0,
+ };
+ const updateBefore = node.updateBefore.bind(node);
+ const setViewOffset = internals.setViewOffset.bind(node);
+ internals.setViewOffset = (width, height) => {
+ camera.updateProjectionMatrix();
+ if (!camera.projectionMatrix.equals(projection)) pending ??= "projection-change";
+ projection.copy(camera.projectionMatrix);
+ setViewOffset(width, height);
+ };
+ node.updateBefore = (frame) => {
+ if (disposed) throw new Error("Temporal AA is disposed.");
+ if (frame.renderer === null) throw new Error("Temporal AA requires a renderer.");
+ const source = internals.beautyNode.isRTTNode
+ ? internals.beautyNode.renderTarget
+ : internals.beautyNode.passNode?.renderTarget;
+ if (source === undefined) throw new Error("Temporal AA requires a materialized colour input.");
+ const { width, height } = source;
+ for (const texture of [depth.value, velocity.value]) {
+ if (texture.width !== width || texture.height !== height)
+ throw new Error("Temporal AA colour, depth and velocity must share the same raster size.");
+ }
+ if (report.frame > 0 && (width !== report.inputWidth || height !== report.inputHeight))
+ pending = "resize";
+ const reason = pending;
+ // Size mismatches are restarted by upstream. A same-sized cut otherwise retains old colour.
+ if (
+ reason !== null &&
+ internals._historyRenderTarget.width === width &&
+ internals._historyRenderTarget.height === height
+ ) {
+ frame.renderer.initRenderTarget(internals._historyRenderTarget);
+ frame.renderer.copyTextureToTexture(source.texture, internals._historyRenderTarget.texture);
+ }
+ try {
+ updateBefore(frame);
+ } catch (error) {
+ pending = "scene-reset";
+ throw error;
+ }
+ report = {
+ frame: report.frame + 1,
+ historyValid: reason === null,
+ resetReason: reason,
+ inputWidth: width,
+ inputHeight: height,
+ outputWidth: internals._resolveRenderTarget.width,
+ outputHeight: internals._resolveRenderTarget.height,
+ };
+ pending = null;
+ return undefined;
+ };
+ return {
+ node,
+ report: (): ITemporalAAReport => report,
+ resetHistory: (reason: TemporalResetReason = "scene-reset"): void => {
+ if (disposed) throw new Error("Temporal AA is disposed.");
+ pending = reason;
+ },
+ dispose: (): void => {
+ if (disposed) return;
+ disposed = true;
+ node.dispose();
+ // convertToTexture allocates an RTT only when the caller did not already supply a texture.
+ if (internals.beautyNode !== colour && internals.beautyNode.isRTTNode) {
+ internals.beautyNode.renderTarget?.dispose();
+ (
+ internals.beautyNode as unknown as { _quadMesh: { material: { dispose(): void } } }
+ )._quadMesh.material.dispose();
+ }
+ },
+ };
+}
diff --git a/packages/runtime-native/conformance/registry.json b/packages/runtime-native/conformance/registry.json
index 157aeb29b0..4e19a63ae0 100644
--- a/packages/runtime-native/conformance/registry.json
+++ b/packages/runtime-native/conformance/registry.json
@@ -74,6 +74,22 @@
}
],
"tests": [
+ {
+ "id": "temporal-aa",
+ "title": "full-resolution temporal AA with object motion history",
+ "category": "rendering",
+ "status": "implemented",
+ "scene": "conformance/scenes/shared/temporal-aa.js",
+ "captureFrames": 26,
+ "browserRecipe": "webgpu",
+ "requiresHardwareAdapter": true,
+ "tolerance": {
+ "pixelMismatchRatio": 0.06,
+ "perceptualDeltaE": 9.0
+ },
+ "desktopGate": false,
+ "required": false
+ },
{
"id": "01-basic-cube",
"title": "basic cube",
diff --git a/packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js b/packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js
new file mode 100644
index 0000000000..3a64fcc014
--- /dev/null
+++ b/packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js
@@ -0,0 +1,104 @@
+import * as THREE from "three/webgpu";
+import { pass } from "three/tsl";
+import { RenderChain } from "../../../../core/src/render/chain.ts";
+import {
+ VelocityTracker,
+ readVelocityPreviousBoneMatrices,
+ readVelocityPreviousMatrices,
+ readVelocityPreviousWorldMatrix,
+} from "../../../../core/src/render/velocity.ts";
+import { createTemporalAA } from "../../../../create-threenative/templates/starter/src/render/temporalAA.ts";
+
+// Shared browser/native content. The caller owns the renderer and sole frame loop.
+export function createTemporalAAFixture(renderer, scene, camera, variant = "temporal") {
+ scene.background = new THREE.Color(0x0d1630);
+ camera.position.set(0, 0.3, 6);
+ const sun = new THREE.DirectionalLight(0xffffff, 2.0);
+ sun.position.set(2, 5, 3);
+ scene.add(new THREE.HemisphereLight(0xb4d4ff, 0x303848, 1.5), sun);
+ const white = new THREE.MeshStandardMaterial({ color: 0xe1eafa });
+ const fence = new THREE.InstancedMesh(new THREE.BoxGeometry(0.012, 2.6, 0.02), white, 40);
+ const matrix = new THREE.Matrix4();
+ for (let index = 0; index < fence.count; index++) {
+ fence.setMatrixAt(index, matrix.makeTranslation((index - 20) * 0.125, 0, -0.6));
+ }
+ scene.add(fence);
+ const diagonal = new THREE.Mesh(new THREE.BoxGeometry(5.5, 0.02, 0.03), white);
+ diagonal.rotation.z = 0.27;
+ scene.add(diagonal);
+ const rigid = new THREE.Mesh(new THREE.BoxGeometry(0.75, 0.9, 0.3), new THREE.MeshStandardMaterial({ color: 0xf0924e }));
+ rigid.position.set(-1.5, 0.6, 0.4);
+ scene.add(rigid);
+ const instances = new THREE.InstancedMesh(new THREE.SphereGeometry(0.16, 12, 8), new THREE.MeshStandardMaterial({ color: 0x60ead6 }), 3);
+ scene.add(instances);
+ const geometry = new THREE.BoxGeometry(0.28, 1.4, 0.25, 1, 8, 1);
+ const skinIndices = [], skinWeights = [];
+ for (let index = 0; index < geometry.attributes.position.count; index++) {
+ const weight = THREE.MathUtils.clamp(geometry.attributes.position.getY(index) + 0.5, 0, 1);
+ skinIndices.push(0, 1, 0, 0);
+ skinWeights.push(1 - weight, weight, 0, 0);
+ }
+ geometry.setAttribute("skinIndex", new THREE.Uint16BufferAttribute(skinIndices, 4));
+ geometry.setAttribute("skinWeight", new THREE.Float32BufferAttribute(skinWeights, 4));
+ const character = new THREE.SkinnedMesh(geometry, new THREE.MeshStandardMaterial({ color: 0xdd72df }));
+ const root = new THREE.Bone(), limb = new THREE.Bone();
+ root.add(limb); character.add(root);
+ character.bind(new THREE.Skeleton([root, limb]));
+ character.position.set(1.4, 0.25, 0.5);
+ scene.add(character);
+ const scenePass = pass(scene, camera);
+ const pipeline = new THREE.RenderPipeline(renderer);
+ const tracker = new VelocityTracker();
+ let temporal;
+ const chain = new RenderChain({
+ renderer: { kind: "webgpu", raw: renderer, setOutputNode: (node) => { pipeline.outputNode = node; }, clearOutputNode: () => {} },
+ input: scenePass.getTextureNode("output"), worldPass: scenePass,
+ request: { stages: variant === "reference" ? [] : ["traa"], velocity: { pass: scenePass } },
+ stages: [{
+ name: "traa",
+ build: (input, context) => {
+ temporal = createTemporalAA(input, scenePass.getTextureNode("depth"), context.velocityNode, camera);
+ return temporal.node;
+ },
+ dispose: () => temporal?.dispose(),
+ }],
+ });
+ if (variant === "reference") pipeline.outputNode = scenePass;
+ let frame = 0, resets = 0, lastReset = null;
+ const observation = () => ({
+ frame, resets, lastReset, aa: temporal?.report() ?? null,
+ stages: chain.applied.stages, velocity: chain.applied.velocity,
+ rigidHistory: readVelocityPreviousWorldMatrix(rigid) !== undefined,
+ skinnedHistory: readVelocityPreviousBoneMatrices(character) !== undefined,
+ instancedHistory: readVelocityPreviousMatrices(instances) !== undefined,
+ });
+ const render = () => {
+ rigid.position.x = -1.5 + Math.sin(frame / 18) * 0.65;
+ limb.rotation.z = Math.sin(frame / 13) * 0.7;
+ for (let index = 0; index < instances.count; index++) {
+ instances.setMatrixAt(index, matrix.makeTranslation(-0.5 + index * 0.6, -0.9 + Math.sin(frame / 11 + index) * 0.22, 0.3));
+ }
+ instances.instanceMatrix.needsUpdate = true;
+ camera.position.x = Math.sin(frame / 50) * 0.15 + (variant === "cut" && frame >= 20 ? 1.2 : 0);
+ if (frame === 20 && variant === "cut") temporal?.resetHistory("camera-cut");
+ if (frame === 20 && variant === "projection") { camera.fov = 65; camera.updateProjectionMatrix(); }
+ if (frame === 20 && variant === "resize") { renderer.setSize(960, 540, false); camera.aspect = 960 / 540; camera.updateProjectionMatrix(); }
+ tracker.update(scene);
+ pipeline.render();
+ tracker.commit(scene);
+ const result = temporal?.report();
+ if (result?.resetReason) { resets += 1; lastReset = result; }
+ frame += 1;
+ };
+ return {
+ render, observation,
+ dispose: () => {
+ chain.dispose(); tracker.clear(); scenePass.dispose(); pipeline.dispose();
+ const geometries = new Set(), materials = new Set();
+ scene.traverse((object) => { if (object.geometry) geometries.add(object.geometry); if (object.material) materials.add(object.material); });
+ for (const item of geometries) item.dispose();
+ for (const item of materials) item.dispose();
+ character.skeleton.dispose();
+ },
+ };
+}
diff --git a/packages/runtime-native/conformance/scenes/shared/temporal-aa.js b/packages/runtime-native/conformance/scenes/shared/temporal-aa.js
new file mode 100644
index 0000000000..a05879aa35
--- /dev/null
+++ b/packages/runtime-native/conformance/scenes/shared/temporal-aa.js
@@ -0,0 +1,9 @@
+import { createTemporalAAFixture } from "./temporal-aa-fixture.js";
+import { startVisualScene } from "./scene-support.js";
+
+export function startScene(canvas, dimensions) {
+ return startVisualScene(canvas, dimensions, "temporal-aa", ({ renderer, scene, camera }) => {
+ const fixture = createTemporalAAFixture(renderer, scene, camera);
+ return { ...fixture, detail: { milestone: "full-resolution-temporal-aa", qualification: "experimental" } };
+ });
+}
diff --git a/scripts/verify-temporal-aa.ts b/scripts/verify-temporal-aa.ts
new file mode 100644
index 0000000000..e33386ed05
--- /dev/null
+++ b/scripts/verify-temporal-aa.ts
@@ -0,0 +1,120 @@
+import assert from "node:assert/strict";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { PNG } from "pngjs";
+import { WEBGPU_BROWSER_ARGS } from "../packages/playtest/src/runner/browser.js";
+import { runStandalonePlaytest } from "../packages/playtest/src/runner/runner.js";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const output = path.join(root, "artifacts/temporal-aa");
+await mkdir(output, { recursive: true });
+const summaries = [];
+let referenceFrame: number | undefined;
+for (const variant of ["reference", "temporal", "cut", "projection", "resize"] as const) {
+ const artifactDirectory = path.join(output, variant);
+ const report = await runStandalonePlaytest({
+ allowSoftwareAdapter: true,
+ artifactDirectory,
+ browserArgs: [...WEBGPU_BROWSER_ARGS],
+ headless: false,
+ port: 0,
+ projectPath: path.join(root, "examples/abyss-framework"),
+ scenarioPath: "playtests/temporal-aa.playtest.json",
+ server: {
+ command:
+ "pnpm exec vite --config temporal.vite.config.ts --host 127.0.0.1 --port $PORT --strictPort",
+ timeoutMs: 60_000,
+ },
+ timeoutMs: 60_000,
+ trace: false,
+ url: `http://127.0.0.1:5173/temporal.html?variant=${variant}`,
+ });
+ await writeFile(
+ path.join(artifactDirectory, "report.json"),
+ `${JSON.stringify(report, null, 2)}\n`,
+ );
+ assert.ok(
+ report.capture && Object.values(report.capture.adapter).some((value) => value.length > 0),
+ `${variant}: adapter provenance required`,
+ );
+ assert.equal(report.capture.rendererKind, "webgpu", `${variant}: expected WebGPU`);
+ assert.equal(report.pass, true, `${variant}: ${JSON.stringify(report.diagnostics)}`);
+ const observed = report.observations?.resources?.temporal?.after as
+ | {
+ frame: number;
+ stages: string[];
+ rigidHistory: boolean;
+ skinnedHistory: boolean;
+ instancedHistory: boolean;
+ aa: {
+ inputWidth: number;
+ inputHeight: number;
+ outputWidth: number;
+ outputHeight: number;
+ historyValid: boolean;
+ } | null;
+ lastReset: { resetReason: string } | null;
+ }
+ | undefined;
+ assert.ok(observed && observed.frame >= 24, `${variant}: actual rendered frames required`);
+ if (referenceFrame === undefined) referenceFrame = observed.frame;
+ else
+ assert.equal(
+ observed.frame,
+ referenceFrame,
+ `${variant}: capture the same deterministic pose as the reference`,
+ );
+ for (const kind of ["rigidHistory", "skinnedHistory", "instancedHistory"] as const) {
+ assert.equal(observed[kind], true, `${variant}: ${kind} must use the existing tracker`);
+ }
+ if (variant === "reference") {
+ assert.equal(observed.aa, null);
+ assert.deepEqual(observed.stages, []);
+ } else {
+ assert.deepEqual(observed.stages, ["traa"]);
+ assert.ok(observed.aa, `${variant}: temporal result absent`);
+ assert.equal(observed.aa.historyValid, true, `${variant}: history must recover after reset`);
+ assert.equal(observed.aa.inputWidth, variant === "resize" ? 960 : 1280);
+ assert.equal(observed.aa.inputHeight, variant === "resize" ? 540 : 720);
+ assert.equal(observed.aa.outputWidth, observed.aa.inputWidth);
+ assert.equal(observed.aa.outputHeight, observed.aa.inputHeight);
+ const reset = {
+ temporal: "initial",
+ cut: "camera-cut",
+ projection: "projection-change",
+ resize: "resize",
+ }[variant];
+ assert.equal(observed.lastReset?.resetReason, reset);
+ }
+ for (const filename of ["before.png", "after.png"]) {
+ const image = PNG.sync.read(await readFile(path.join(artifactDirectory, filename)));
+ assert.ok(
+ image.width >= 960 && image.height >= 540,
+ `${variant}: actual canvas capture required`,
+ );
+ }
+ summaries.push({ variant, capture: report.capture, observed });
+}
+const reference = await readFile(path.join(output, "reference/after.png"));
+const temporal = await readFile(path.join(output, "temporal/after.png"));
+assert.ok(
+ !reference.equals(temporal),
+ "Enabling temporal AA must change the actual rendered pixels",
+);
+await writeFile(
+ path.join(output, "summary.json"),
+ `${JSON.stringify(
+ {
+ qualification:
+ "full-resolution runtime correctness only; software adapters allowed, no native, image-quality superiority or hardware-performance claim",
+ pass: true,
+ variants: summaries,
+ },
+ null,
+ 2,
+ )}\n`,
+);
+console.log(
+ `Temporal AA: five actual runtime variants captured with adapter and history evidence at ${output}`,
+);
From 60b1919f1a2117a336e8c571101e12c6035dfd09 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 02:00:17 -0700
Subject: [PATCH 07/90] fix(render): reject reset history and use bundled
capture runner
---
...-reconstruction-from-dynamic-resolution.md | 8 +++++++
.../__tests__/scaffold.spec.ts | 2 +-
.../__tests__/temporal-aa.spec.ts | 21 ++++++++++++++-----
.../starter/src/render/temporalAA.ts | 16 +++++++-------
scripts/verify-temporal-aa.ts | 21 +++++++++++++++++--
5 files changed, 51 insertions(+), 17 deletions(-)
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index 696406cc68..0674bd24fb 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -94,6 +94,14 @@ experimental path or mark the draft ready before the outstanding acceptance evid
The complete repository test/budget/quality board and temporal visual-quality corpus are still
unrun for this slice. The optional conformance row does not qualify any native target.
+ Follow-up, 2026-10-02: hosted run `36986673556` passed 61 focused tests, then failed in
+ the source-loaded runner's serialized callback (`__name` undefined), before temporal evidence.
+ The verifier now imports the freshly built public runner rather than source-transpiled browser
+ callbacks and preserves early failure diagnostics. A fresh red-to-green lifecycle regression
+ also requires reset frames to overwrite **both** resolved output and next-frame history with
+ current colour after upstream bookkeeping; a pre-resolve seed alone still reprojects at shifted
+ UVs and is not complete rejection. Five lifecycle tests pass; screenshot proof remains pending.
+
- [ ] The reconstruction stage produces a display-sized output from a smaller colour/depth input and records input size, output size, history-valid state and rejection fraction. **proof:** focused render-chain test runs 0.67→1.0 sizing, then a mutation returning the low-resolution target directly fails the output-size assertion.
- [ ] Camera cuts, projection changes and resolution changes invalidate history for the affected frame; moving skinned and instanced fixtures use the existing velocity source rather than a camera-only approximation. **proof:** deterministic fixture covers cut/resize/skinned/instanced cases and a zero-velocity mutation fails the moving-object rejection/stability assertion.
diff --git a/packages/create-threenative/__tests__/scaffold.spec.ts b/packages/create-threenative/__tests__/scaffold.spec.ts
index 7dc70aff27..23fe0bcf80 100644
--- a/packages/create-threenative/__tests__/scaffold.spec.ts
+++ b/packages/create-threenative/__tests__/scaffold.spec.ts
@@ -195,7 +195,7 @@ const PRD_201_PARENT_SCAFFOLD_HASHES: Readonly> = {
shooter: "d5a0cf3706e7a0b621fa9290564ac896467b256154d7f6abdf75ca4c36aade91",
snow: "d59cab83418e9636bb9b48f8b802b3c36defdc5889e4a03c96b1167b7a4f2623",
// PRD-455: starter-only opt-in temporalAA.ts plus its ownership/qualification paragraph.
- starter: "2a1ce31178413a9850216e0504a3a25dd0117823a3b86371db698f6608301970",
+ starter: "5a9466593ad0b5569cb95214d8735e605151423c4a2b1764260da4fd41c20c5f",
"tower-defense": "d50982f0cdfe90786e0042e7d7113d847856c9d9eed71673adfb42e6a9349287",
};
diff --git a/packages/create-threenative/__tests__/temporal-aa.spec.ts b/packages/create-threenative/__tests__/temporal-aa.spec.ts
index 7ff634519a..0dced795a1 100644
--- a/packages/create-threenative/__tests__/temporal-aa.spec.ts
+++ b/packages/create-threenative/__tests__/temporal-aa.spec.ts
@@ -8,7 +8,11 @@ import { createTemporalAA } from "../templates/starter/src/render/temporalAA.js"
afterEach(() => vi.restoreAllMocks());
function fixture() {
// GPU execution belongs to the runtime fixture. Unit tests isolate reset/lifetime ownership.
- vi.spyOn(TRAANode.prototype, "updateBefore").mockImplementation(() => undefined);
+ const events: string[] = [];
+ vi.spyOn(TRAANode.prototype, "updateBefore").mockImplementation(() => {
+ events.push("resolve");
+ return undefined;
+ });
const camera = new PerspectiveCamera(50, 1280 / 720);
const scenePass = pass(new Scene(), camera);
scenePass.setSize(1280, 720);
@@ -25,6 +29,7 @@ function fixture() {
renderer: {
initRenderTarget: () => {},
copyTextureToTexture: (from: Texture, to: Texture) => {
+ events.push("copy");
copies.push({ from, to });
},
},
@@ -34,15 +39,16 @@ function fixture() {
setViewOffset(width: number, height: number): void;
clearViewOffset(): void;
_historyRenderTarget: RenderTarget;
+ _resolveRenderTarget: RenderTarget;
};
node.setSize(1280, 720);
temporal.node.setup({ context: { velocity }, renderer: {} } as unknown as NodeBuilder);
- return { camera, copies, frame, node, scenePass, temporal };
+ return { camera, copies, events, frame, node, scenePass, temporal };
}
describe("opt-in full-resolution temporal AA", () => {
it("seeds current colour on first use and a camera cut, not ordinary frames", () => {
- const { temporal, frame, copies, scenePass, node } = fixture();
+ const { temporal, frame, copies, events, scenePass, node } = fixture();
temporal.node.updateBefore(frame);
expect(temporal.report()).toMatchObject({
frame: 1,
@@ -52,12 +58,17 @@ describe("opt-in full-resolution temporal AA", () => {
outputWidth: 1280,
});
expect(copies[0]).toEqual({
+ from: scenePass.renderTarget.texture,
+ to: node._resolveRenderTarget.texture,
+ });
+ expect(copies[1]).toEqual({
from: scenePass.renderTarget.texture,
to: node._historyRenderTarget.texture,
});
+ expect(events).toEqual(["resolve", "copy", "copy"]);
temporal.node.updateBefore(frame);
expect(temporal.report()).toMatchObject({ frame: 2, historyValid: true, resetReason: null });
- expect(copies).toHaveLength(1);
+ expect(copies).toHaveLength(2);
temporal.resetHistory("camera-cut");
temporal.node.updateBefore(frame);
expect(temporal.report()).toMatchObject({
@@ -65,7 +76,7 @@ describe("opt-in full-resolution temporal AA", () => {
historyValid: false,
resetReason: "camera-cut",
});
- expect(copies).toHaveLength(2);
+ expect(copies).toHaveLength(4);
temporal.dispose();
scenePass.dispose();
});
diff --git a/packages/create-threenative/templates/starter/src/render/temporalAA.ts b/packages/create-threenative/templates/starter/src/render/temporalAA.ts
index ede66478e4..155efcec54 100644
--- a/packages/create-threenative/templates/starter/src/render/temporalAA.ts
+++ b/packages/create-threenative/templates/starter/src/render/temporalAA.ts
@@ -81,17 +81,15 @@ export function createTemporalAA(
if (report.frame > 0 && (width !== report.inputWidth || height !== report.inputHeight))
pending = "resize";
const reason = pending;
- // Size mismatches are restarted by upstream. A same-sized cut otherwise retains old colour.
- if (
- reason !== null &&
- internals._historyRenderTarget.width === width &&
- internals._historyRenderTarget.height === height
- ) {
- frame.renderer.initRenderTarget(internals._historyRenderTarget);
- frame.renderer.copyTextureToTexture(source.texture, internals._historyRenderTarget.texture);
- }
try {
updateBefore(frame);
+ if (reason !== null) {
+ // Seeding history before resolve is insufficient: motion would still sample that seed
+ // at shifted UVs. Publish this frame verbatim, then seed next frame, after upstream has
+ // updated dimensions, depth and camera bookkeeping. A reset intentionally skips AA once.
+ frame.renderer.copyTextureToTexture(source.texture, internals._resolveRenderTarget.texture);
+ frame.renderer.copyTextureToTexture(source.texture, internals._historyRenderTarget.texture);
+ }
} catch (error) {
pending = "scene-reset";
throw error;
diff --git a/scripts/verify-temporal-aa.ts b/scripts/verify-temporal-aa.ts
index e33386ed05..d47269e20b 100644
--- a/scripts/verify-temporal-aa.ts
+++ b/scripts/verify-temporal-aa.ts
@@ -3,8 +3,10 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
import path from "node:path";
import { fileURLToPath } from "node:url";
import { PNG } from "pngjs";
-import { WEBGPU_BROWSER_ARGS } from "../packages/playtest/src/runner/browser.js";
-import { runStandalonePlaytest } from "../packages/playtest/src/runner/runner.js";
+import {
+ WEBGPU_BROWSER_ARGS,
+ runStandalonePlaytest,
+} from "../packages/playtest/dist/runner/index.js";
const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const output = path.join(root, "artifacts/temporal-aa");
@@ -13,6 +15,7 @@ const summaries = [];
let referenceFrame: number | undefined;
for (const variant of ["reference", "temporal", "cut", "projection", "resize"] as const) {
const artifactDirectory = path.join(output, variant);
+ await mkdir(artifactDirectory, { recursive: true });
const report = await runStandalonePlaytest({
allowSoftwareAdapter: true,
artifactDirectory,
@@ -29,6 +32,20 @@ for (const variant of ["reference", "temporal", "cut", "projection", "resize"] a
timeoutMs: 60_000,
trace: false,
url: `http://127.0.0.1:5173/temporal.html?variant=${variant}`,
+ }).catch(async (error: unknown) => {
+ await writeFile(
+ path.join(artifactDirectory, "failure.json"),
+ `${JSON.stringify(
+ {
+ variant,
+ pass: false,
+ error: error instanceof Error ? error.stack : String(error),
+ },
+ null,
+ 2,
+ )}\n`,
+ );
+ throw error;
});
await writeFile(
path.join(artifactDirectory, "report.json"),
From fb77d75fbf962accaeb5c85d1cd9341dd6779ccb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 02:04:13 -0700
Subject: [PATCH 08/90] docs(prd455): attach diagnostic runtime screenshot
progress
---
...-reconstruction-from-dynamic-resolution.md | 9 +++++
.../prd455/diagnostic-reference.json | 33 ++++++++++++++++++
.../prd455/diagnostic-reference.png | Bin 0 -> 13098 bytes
3 files changed, 42 insertions(+)
create mode 100644 docs/verification/prd455/diagnostic-reference.json
create mode 100644 docs/verification/prd455/diagnostic-reference.png
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index 0674bd24fb..ee3b3ffdf8 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -115,6 +115,15 @@ experimental path or mark the draft ready before the outstanding acceptance evid
- [ ] On a GPU-bound representative game, sub-1.0 rendering plus reconstruction lowers GPU/render p95 versus full-resolution rendering while meeting the Phase-2 visual thresholds. **proof:** paired fixed-route browser WebGPU and desktop-native table records internal pixels, reconstruction cost, total GPU/render p50/p95 and visual metrics; no “FPS only” verdict.
- [ ] Automatic resolution can move between at least three scales during one run without history corruption, allocation growth or a reconstruction cost spike larger than the saved raster cost. **proof:** scripted scaler route records scale transitions, history resets, render-target allocation count and per-stage cost; repeated up/down cycles end at the initial allocation baseline.
+## Runtime screenshot progress
+
+- [Diagnostic no-AA reference](../../verification/prd455/diagnostic-reference.png), hosted run
+ `36986673556`, source `bbbf93ca8c10a30b168fdb984d31a7567ebeccaf`. Actual canvas PNG inspected;
+ [provenance](../../verification/prd455/diagnostic-reference.json) records SwiftShader/software
+ WebGPU. This is a baseline progress frame, not temporal/motion/native/performance proof.
+ The run stopped at the source-runner callback error; fixed-step rendering also needs a distinct
+ Three.js frame boundary before temporal frame counts can qualify a motion sequence.
+
## Acceptance criteria
The win is **not** “TRAA is enabled.” The win is that a lower internal raster produces a stable
diff --git a/docs/verification/prd455/diagnostic-reference.json b/docs/verification/prd455/diagnostic-reference.json
new file mode 100644
index 0000000000..d84cb1f174
--- /dev/null
+++ b/docs/verification/prd455/diagnostic-reference.json
@@ -0,0 +1,33 @@
+{
+ "qualification": "Diagnostic no-AA reference screenshot only. Temporal arm and motion sequence are not qualified.",
+ "sourceCommit": "bbbf93ca8c10a30b168fdb984d31a7567ebeccaf",
+ "workflowRun": 36986673556,
+ "artifactId": 11217512537,
+ "artifactSha256": "20ddd5402c0504fbb81987df0ed8692b205d0f680616e3b45baf613a61f6a5f7",
+ "screenshotSha256": "2c8f2a2d1a4d9288dbb6f29dd29ed7da29fd672ee4d23fea0a0d7dd4093aa426",
+ "failure": "Source-loaded runner callback failed with ReferenceError: __name is not defined. Initial synchronous fixture stepping also needs a RAF boundary before claiming motion.",
+ "capture": {
+ "adapter": {
+ "architecture": "swiftshader",
+ "vendor": "google",
+ "features": "bgra8unorm-storage,chromium-experimental-timestamp-query-inside-passes,clip-distances,core-features-and-limits,depth-clip-control,depth32float-stencil8,float32-blendable,float32-filterable,indirect-first-instance,rg11b10ufloat-renderable,subgroup-size-control,subgroups,texture-component-swizzle,texture-compression-astc,texture-compression-astc-sliced-3d,texture-compression-bc,texture-compression-bc-sliced-3d,texture-compression-etc2,timestamp-query",
+ "limit.maxBindGroups": "4",
+ "limit.maxTextureDimension2D": "8192",
+ "limit.maxStorageBufferBindingSize": "1073741824"
+ },
+ "browserArgs": [
+ "--ozone-platform=x11",
+ "--enable-unsafe-webgpu",
+ "--disable-gpu-sandbox",
+ "--ignore-gpu-blocklist",
+ "--enable-features=Vulkan"
+ ],
+ "captureMethod": "page.screenshot",
+ "rendererKind": "webgpu",
+ "target": "web",
+ "viewport": {
+ "height": 720,
+ "width": 1280
+ }
+ }
+}
diff --git a/docs/verification/prd455/diagnostic-reference.png b/docs/verification/prd455/diagnostic-reference.png
new file mode 100644
index 0000000000000000000000000000000000000000..62c8f83c3b856535f444b4c50639984de1b840c3
GIT binary patch
literal 13098
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
literal 0
HcmV?d00001
From cba3172a9117be2ce123f6a1d3dc05d1ba9d0551 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 02:10:56 -0700
Subject: [PATCH 09/90] fix(playtest): qualify actual temporal frames and
reject device loss
---
.github/workflows/integration-temporal.yml | 4 +-
...-reconstruction-from-dynamic-resolution.md | 14 ++++++
examples/abyss-framework/temporal-main.js | 13 ++++-
examples/abyss-framework/temporal.html | 2 +-
.../__tests__/temporal-aa-evidence.spec.ts | 47 +++++++++++++++++++
scripts/temporal-aa-evidence.ts | 23 +++++++++
scripts/verify-temporal-aa.ts | 17 ++++---
7 files changed, 109 insertions(+), 11 deletions(-)
create mode 100644 scripts/__tests__/temporal-aa-evidence.spec.ts
create mode 100644 scripts/temporal-aa-evidence.ts
diff --git a/.github/workflows/integration-temporal.yml b/.github/workflows/integration-temporal.yml
index ea0c45c88b..46eaffccfc 100644
--- a/.github/workflows/integration-temporal.yml
+++ b/.github/workflows/integration-temporal.yml
@@ -11,6 +11,8 @@ on:
- 'examples/abyss-framework/temporal*'
- 'examples/abyss-framework/playtests/temporal-aa.playtest.json'
- 'scripts/verify-temporal-aa.ts'
+ - 'scripts/temporal-aa-evidence.ts'
+ - 'scripts/__tests__/temporal-aa-evidence.spec.ts'
- '.github/workflows/integration-temporal.yml'
permissions:
contents: read
@@ -31,7 +33,7 @@ jobs:
- run: pnpm --filter @threenative/playtest build
- uses: ./.github/actions/playwright-chromium
- name: Validate actual TRAANode and history lifecycle contracts
- run: pnpm exec vitest run packages/core/__tests__/temporal-chain.spec.ts packages/core/__tests__/render-chain.spec.ts packages/core/__tests__/render-velocity.spec.ts packages/create-threenative/__tests__/temporal-aa.spec.ts --maxWorkers=2
+ run: pnpm exec vitest run packages/core/__tests__/temporal-chain.spec.ts packages/core/__tests__/render-chain.spec.ts packages/core/__tests__/render-velocity.spec.ts packages/create-threenative/__tests__/temporal-aa.spec.ts scripts/__tests__/temporal-aa-evidence.spec.ts --maxWorkers=2
- name: Render temporal motion and reset variants
run: node --import tsx scripts/verify-temporal-aa.ts
- name: Retain actual runtime screenshots and adapter evidence
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index ee3b3ffdf8..2ea1bdfd75 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -115,6 +115,20 @@ experimental path or mark the draft ready before the outstanding acceptance evid
- [ ] On a GPU-bound representative game, sub-1.0 rendering plus reconstruction lowers GPU/render p95 versus full-resolution rendering while meeting the Phase-2 visual thresholds. **proof:** paired fixed-route browser WebGPU and desktop-native table records internal pixels, reconstruction cost, total GPU/render p50/p95 and visual metrics; no “FPS only” verdict.
- [ ] Automatic resolution can move between at least three scales during one run without history corruption, allocation growth or a reconstruction cost spike larger than the saved raster cost. **proof:** scripted scaler route records scale transitions, history resets, render-target allocation count and per-stage cost; repeated up/down cycles end at the initial allocation baseline.
+### Current execution notes
+
+Fresh full core CPU directory: 175 test files passed, 2,209 tests passed, two skipped, using pinned
+pnpm and `--maxWorkers=1`. The initial full-directory attempt exposed a child-command environment
+failure in the hot-subpath declaration test; the correct environment passed that test, then the
+entire directory was rerun green. This is still not the complete repository board.
+Hosted run `36987345933` advances past the bundled-runner repair but fails the strict console-error
+guard on one 404 in the reference fixture. The next fixture serves its compiled build and declares
+an explicit data favicon. Every fixed step now waits for Three's existing RAF frame boundary, and
+the verifier requires the AA resolve count to equal the fixture count. The verifier also rejects
+`TN_PLAYTEST_SOFTWARE_DEVICE_LOST` even when the generic runner downgrades it to a warning; unit
+regressions retain that fail-closed requirement. No visual acceptance box is inferred from a green
+CPU gate or the diagnostic reference frame.
+
## Runtime screenshot progress
- [Diagnostic no-AA reference](../../verification/prd455/diagnostic-reference.png), hosted run
diff --git a/examples/abyss-framework/temporal-main.js b/examples/abyss-framework/temporal-main.js
index d08b3da87c..eb69379906 100644
--- a/examples/abyss-framework/temporal-main.js
+++ b/examples/abyss-framework/temporal-main.js
@@ -11,10 +11,19 @@ await renderer.init();
const scene = new Scene();
const camera = new PerspectiveCamera(50, 1280 / 720, 0.1, 100);
const fixture = createTemporalAAFixture(renderer, scene, camera, new URLSearchParams(location.search).get("variant") ?? "temporal");
-for (let index = 0; index < 20; index++) fixture.render();
+// Three advances NodeUpdateType.FRAME from its existing animation clock. Multiple synchronous
+// renders would reuse one temporal result, so each deterministic step waits for that boundary.
+async function advance(ticks) {
+ for (let index = 0; index < ticks; index++) {
+ await new Promise(requestAnimationFrame);
+ fixture.render();
+ }
+ return ticks;
+}
+await advance(20);
installThreePlaytestBridge({
camera, scene, renderer,
- fixedStep: async (ticks) => { for (let index = 0; index < ticks; index++) fixture.render(); return ticks; },
+ fixedStep: advance,
resources: { read: () => ({ temporal: fixture.observation() }) },
tick: () => fixture.observation().frame,
});
diff --git a/examples/abyss-framework/temporal.html b/examples/abyss-framework/temporal.html
index 10583d4ebd..a8796b85bb 100644
--- a/examples/abyss-framework/temporal.html
+++ b/examples/abyss-framework/temporal.html
@@ -1 +1 @@
-Temporal AA qualification
+Temporal AA qualification
diff --git a/scripts/__tests__/temporal-aa-evidence.spec.ts b/scripts/__tests__/temporal-aa-evidence.spec.ts
new file mode 100644
index 0000000000..a6e195bb48
--- /dev/null
+++ b/scripts/__tests__/temporal-aa-evidence.spec.ts
@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import type { IPlaytestReport } from "../../packages/playtest/src/report.js";
+import { requireTemporalRenderEvidence } from "../temporal-aa-evidence.js";
+
+function report(): Pick & { pass: boolean } {
+ return {
+ capture: {
+ adapter: { architecture: "swiftshader", vendor: "google" },
+ browserArgs: [],
+ captureMethod: "page.screenshot",
+ rendererKind: "webgpu",
+ target: "web",
+ viewport: { width: 1280, height: 720 },
+ },
+ diagnostics: [],
+ pass: true,
+ };
+}
+describe("temporal render evidence", () => {
+ it("accepts honest software correctness evidence with adapter provenance", () => {
+ expect(() => requireTemporalRenderEvidence(report(), "temporal")).not.toThrow();
+ });
+ it("rejects software device loss even when the runner reports pass", () => {
+ const result = report();
+ result.diagnostics.push({
+ code: "TN_PLAYTEST_SOFTWARE_DEVICE_LOST",
+ message: "This lane is not render evidence",
+ severity: "warning",
+ });
+ expect(() => requireTemporalRenderEvidence(result, "temporal")).toThrow(/device loss/);
+ });
+ it("rejects unrelated error diagnostics, absent adapter identity and failed reports", () => {
+ const error = report();
+ error.diagnostics.push({
+ code: "TN_PLAYTEST_CONSOLE_ERROR",
+ severity: "error",
+ message: "Shader failed",
+ });
+ expect(() => requireTemporalRenderEvidence(error, "temporal")).toThrow(/error diagnostics/);
+ const absent = report();
+ if (absent.capture) absent.capture.adapter = {};
+ expect(() => requireTemporalRenderEvidence(absent, "temporal")).toThrow(/adapter/);
+ const failed = report();
+ failed.pass = false;
+ expect(() => requireTemporalRenderEvidence(failed, "temporal")).toThrow();
+ });
+});
diff --git a/scripts/temporal-aa-evidence.ts b/scripts/temporal-aa-evidence.ts
new file mode 100644
index 0000000000..f1a26d22b3
--- /dev/null
+++ b/scripts/temporal-aa-evidence.ts
@@ -0,0 +1,23 @@
+import assert from "node:assert/strict";
+import type { IPlaytestReport } from "../packages/playtest/src/report.js";
+
+/** Software is allowed for correctness, but a lost device is never rendered evidence. */
+export function requireTemporalRenderEvidence(
+ report: Pick & { pass: boolean },
+ variant: string,
+): void {
+ assert.ok(
+ report.capture && Object.values(report.capture.adapter).some((value) => value.length > 0),
+ `${variant}: adapter provenance required`,
+ );
+ assert.equal(report.capture.rendererKind, "webgpu", `${variant}: expected WebGPU`);
+ assert.ok(
+ !report.diagnostics.some(({ code }) => code === "TN_PLAYTEST_SOFTWARE_DEVICE_LOST"),
+ `${variant}: device loss disqualifies render evidence`,
+ );
+ assert.ok(
+ !report.diagnostics.some(({ severity }) => severity === "error"),
+ `${variant}: error diagnostics: ${JSON.stringify(report.diagnostics)}`,
+ );
+ assert.equal(report.pass, true, `${variant}: ${JSON.stringify(report.diagnostics)}`);
+}
diff --git a/scripts/verify-temporal-aa.ts b/scripts/verify-temporal-aa.ts
index d47269e20b..fde1d33bbe 100644
--- a/scripts/verify-temporal-aa.ts
+++ b/scripts/verify-temporal-aa.ts
@@ -8,6 +8,8 @@ import {
runStandalonePlaytest,
} from "../packages/playtest/dist/runner/index.js";
+import { requireTemporalRenderEvidence } from "./temporal-aa-evidence.js";
+
const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const output = path.join(root, "artifacts/temporal-aa");
await mkdir(output, { recursive: true });
@@ -26,7 +28,7 @@ for (const variant of ["reference", "temporal", "cut", "projection", "resize"] a
scenarioPath: "playtests/temporal-aa.playtest.json",
server: {
command:
- "pnpm exec vite --config temporal.vite.config.ts --host 127.0.0.1 --port $PORT --strictPort",
+ "pnpm exec vite build --config temporal.vite.config.ts && pnpm exec vite preview --config temporal.vite.config.ts --host 127.0.0.1 --port $PORT --strictPort",
timeoutMs: 60_000,
},
timeoutMs: 60_000,
@@ -51,12 +53,7 @@ for (const variant of ["reference", "temporal", "cut", "projection", "resize"] a
path.join(artifactDirectory, "report.json"),
`${JSON.stringify(report, null, 2)}\n`,
);
- assert.ok(
- report.capture && Object.values(report.capture.adapter).some((value) => value.length > 0),
- `${variant}: adapter provenance required`,
- );
- assert.equal(report.capture.rendererKind, "webgpu", `${variant}: expected WebGPU`);
- assert.equal(report.pass, true, `${variant}: ${JSON.stringify(report.diagnostics)}`);
+ requireTemporalRenderEvidence(report, variant);
const observed = report.observations?.resources?.temporal?.after as
| {
frame: number;
@@ -65,6 +62,7 @@ for (const variant of ["reference", "temporal", "cut", "projection", "resize"] a
skinnedHistory: boolean;
instancedHistory: boolean;
aa: {
+ frame: number;
inputWidth: number;
inputHeight: number;
outputWidth: number;
@@ -91,6 +89,11 @@ for (const variant of ["reference", "temporal", "cut", "projection", "resize"] a
} else {
assert.deepEqual(observed.stages, ["traa"]);
assert.ok(observed.aa, `${variant}: temporal result absent`);
+ assert.equal(
+ observed.aa.frame,
+ observed.frame,
+ `${variant}: every counted step must actually resolve`,
+ );
assert.equal(observed.aa.historyValid, true, `${variant}: history must recover after reset`);
assert.equal(observed.aa.inputWidth, variant === "resize" ? 960 : 1280);
assert.equal(observed.aa.inputHeight, variant === "resize" ? 540 : 720);
From 1a269e92feba7aebc47fbd9270aa3845f773b7ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 02:20:29 -0700
Subject: [PATCH 10/90] fix(playtest): retain temporal startup diagnostics
---
...-reconstruction-from-dynamic-resolution.md | 7 +++++
examples/abyss-framework/temporal-main.js | 26 ++++++++++++++++---
.../scenes/shared/temporal-aa-fixture.js | 13 +++++++---
.../__tests__/temporal-aa-evidence.spec.ts | 10 +++++++
scripts/temporal-aa-evidence.ts | 10 +++----
5 files changed, 53 insertions(+), 13 deletions(-)
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index 2ea1bdfd75..81eb893c13 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -129,6 +129,13 @@ the verifier requires the AA resolve count to equal the fixture count. The verif
regressions retain that fail-closed requirement. No visual acceptance box is inferred from a green
CPU gate or the diagnostic reference frame.
+Hosted run `36988336664` proves the reference arm completes 24 RAF-separated frames with no
+console or device-loss diagnostics, then the temporal arm fails before bridge installation. The
+fixture now preserves startup exceptions through its diagnostic bridge instead of losing the cause
+as a generic missing-bridge error. Error diagnostics take precedence over absent capture provenance
+without weakening either requirement. Full root lint was run: five new fixture format/declaration
+errors were corrected; a fresh whole-root error-level check then passed (existing warnings remain).
+
## Runtime screenshot progress
- [Diagnostic no-AA reference](../../verification/prd455/diagnostic-reference.png), hosted run
diff --git a/examples/abyss-framework/temporal-main.js b/examples/abyss-framework/temporal-main.js
index eb69379906..485d2b493b 100644
--- a/examples/abyss-framework/temporal-main.js
+++ b/examples/abyss-framework/temporal-main.js
@@ -10,7 +10,12 @@ document.body.appendChild(renderer.domElement);
await renderer.init();
const scene = new Scene();
const camera = new PerspectiveCamera(50, 1280 / 720, 0.1, 100);
-const fixture = createTemporalAAFixture(renderer, scene, camera, new URLSearchParams(location.search).get("variant") ?? "temporal");
+const fixture = createTemporalAAFixture(
+ renderer,
+ scene,
+ camera,
+ new URLSearchParams(location.search).get("variant") ?? "temporal",
+);
// Three advances NodeUpdateType.FRAME from its existing animation clock. Multiple synchronous
// renders would reuse one temporal result, so each deterministic step waits for that boundary.
async function advance(ticks) {
@@ -20,10 +25,23 @@ async function advance(ticks) {
}
return ticks;
}
-await advance(20);
+let startupError;
+try {
+ await advance(20);
+} catch (error) {
+ startupError = error instanceof Error ? error.stack : String(error);
+ console.error(startupError);
+}
installThreePlaytestBridge({
- camera, scene, renderer,
- fixedStep: advance,
+ camera,
+ scene,
+ renderer,
+ diagnostics: () =>
+ startupError === undefined ? [] : [{ code: "TN_TEMPORAL_STARTUP_FAILED", error: startupError }],
+ fixedStep: async (ticks) => {
+ if (startupError !== undefined) throw new Error(startupError);
+ return advance(ticks);
+ },
resources: { read: () => ({ temporal: fixture.observation() }) },
tick: () => fixture.observation().frame,
});
diff --git a/packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js b/packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js
index 3a64fcc014..093c4c3ded 100644
--- a/packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js
+++ b/packages/runtime-native/conformance/scenes/shared/temporal-aa-fixture.js
@@ -32,7 +32,8 @@ export function createTemporalAAFixture(renderer, scene, camera, variant = "temp
const instances = new THREE.InstancedMesh(new THREE.SphereGeometry(0.16, 12, 8), new THREE.MeshStandardMaterial({ color: 0x60ead6 }), 3);
scene.add(instances);
const geometry = new THREE.BoxGeometry(0.28, 1.4, 0.25, 1, 8, 1);
- const skinIndices = [], skinWeights = [];
+ const skinIndices = [];
+ const skinWeights = [];
for (let index = 0; index < geometry.attributes.position.count; index++) {
const weight = THREE.MathUtils.clamp(geometry.attributes.position.getY(index) + 0.5, 0, 1);
skinIndices.push(0, 1, 0, 0);
@@ -41,7 +42,8 @@ export function createTemporalAAFixture(renderer, scene, camera, variant = "temp
geometry.setAttribute("skinIndex", new THREE.Uint16BufferAttribute(skinIndices, 4));
geometry.setAttribute("skinWeight", new THREE.Float32BufferAttribute(skinWeights, 4));
const character = new THREE.SkinnedMesh(geometry, new THREE.MeshStandardMaterial({ color: 0xdd72df }));
- const root = new THREE.Bone(), limb = new THREE.Bone();
+ const root = new THREE.Bone();
+ const limb = new THREE.Bone();
root.add(limb); character.add(root);
character.bind(new THREE.Skeleton([root, limb]));
character.position.set(1.4, 0.25, 0.5);
@@ -64,7 +66,9 @@ export function createTemporalAAFixture(renderer, scene, camera, variant = "temp
}],
});
if (variant === "reference") pipeline.outputNode = scenePass;
- let frame = 0, resets = 0, lastReset = null;
+ let frame = 0;
+ let resets = 0;
+ let lastReset = null;
const observation = () => ({
frame, resets, lastReset, aa: temporal?.report() ?? null,
stages: chain.applied.stages, velocity: chain.applied.velocity,
@@ -94,7 +98,8 @@ export function createTemporalAAFixture(renderer, scene, camera, variant = "temp
render, observation,
dispose: () => {
chain.dispose(); tracker.clear(); scenePass.dispose(); pipeline.dispose();
- const geometries = new Set(), materials = new Set();
+ const geometries = new Set();
+ const materials = new Set();
scene.traverse((object) => { if (object.geometry) geometries.add(object.geometry); if (object.material) materials.add(object.material); });
for (const item of geometries) item.dispose();
for (const item of materials) item.dispose();
diff --git a/scripts/__tests__/temporal-aa-evidence.spec.ts b/scripts/__tests__/temporal-aa-evidence.spec.ts
index a6e195bb48..cc42627b4c 100644
--- a/scripts/__tests__/temporal-aa-evidence.spec.ts
+++ b/scripts/__tests__/temporal-aa-evidence.spec.ts
@@ -29,6 +29,16 @@ describe("temporal render evidence", () => {
});
expect(() => requireTemporalRenderEvidence(result, "temporal")).toThrow(/device loss/);
});
+ it("reports startup errors before the consequent missing screenshot provenance", () => {
+ const result = report();
+ Reflect.deleteProperty(result, "capture");
+ result.diagnostics.push({
+ code: "TN_PLAYTEST_BRIDGE_MISSING",
+ message: "Startup failed",
+ severity: "error",
+ });
+ expect(() => requireTemporalRenderEvidence(result, "temporal")).toThrow(/error diagnostics/);
+ });
it("rejects unrelated error diagnostics, absent adapter identity and failed reports", () => {
const error = report();
error.diagnostics.push({
diff --git a/scripts/temporal-aa-evidence.ts b/scripts/temporal-aa-evidence.ts
index f1a26d22b3..13c5e7881e 100644
--- a/scripts/temporal-aa-evidence.ts
+++ b/scripts/temporal-aa-evidence.ts
@@ -6,11 +6,6 @@ export function requireTemporalRenderEvidence(
report: Pick & { pass: boolean },
variant: string,
): void {
- assert.ok(
- report.capture && Object.values(report.capture.adapter).some((value) => value.length > 0),
- `${variant}: adapter provenance required`,
- );
- assert.equal(report.capture.rendererKind, "webgpu", `${variant}: expected WebGPU`);
assert.ok(
!report.diagnostics.some(({ code }) => code === "TN_PLAYTEST_SOFTWARE_DEVICE_LOST"),
`${variant}: device loss disqualifies render evidence`,
@@ -20,4 +15,9 @@ export function requireTemporalRenderEvidence(
`${variant}: error diagnostics: ${JSON.stringify(report.diagnostics)}`,
);
assert.equal(report.pass, true, `${variant}: ${JSON.stringify(report.diagnostics)}`);
+ assert.ok(
+ report.capture && Object.values(report.capture.adapter).some((value) => value.length > 0),
+ `${variant}: adapter provenance required`,
+ );
+ assert.equal(report.capture.rendererKind, "webgpu", `${variant}: expected WebGPU`);
}
From 9b6a3c6164602cfc710f04e0ea8f078832e3cd23 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 02:32:58 -0700
Subject: [PATCH 11/90] fix(render): schedule temporal inputs before resolving
history
---
...al-reconstruction-from-dynamic-resolution.md | 9 +++++++++
.../__tests__/scaffold.spec.ts | 2 +-
.../__tests__/temporal-aa.spec.ts | 17 +++++++++++++++--
.../templates/starter/src/render/temporalAA.ts | 16 ++++++++++++++++
scripts/verify-temporal-aa.ts | 7 +++++--
5 files changed, 46 insertions(+), 5 deletions(-)
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index 81eb893c13..84eecdb9ed 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -136,6 +136,15 @@ as a generic missing-bridge error. Error diagnostics take precedence over absent
without weakening either requirement. Full root lint was run: five new fixture format/declaration
errors were corrected; a fresh whole-root error-level check then passed (existing warnings remain).
+Hosted run `36989246532` exposes the actual temporal startup failure: the colour/depth/velocity
+size guard runs before the lazy scene-pass dependency. The wrapper now registers the three input
+nodes in NodeBuilder properties, following upstream GaussianBlur/FSR1's dependency mechanism, so
+Three updates the existing input pass before temporal sizing/resolve; no second draw loop is added.
+The dependency regression fails before this change and passes afterward. The verifier additionally
+runs the existing `assertCaptureNotBlank` guard on every PNG: the failed temporal artifact has one
+colour and is correctly rejected, while the clean reference has 1,641 colours and passes unchanged
+thresholds. Pending hosted execution must establish the repaired temporal arm before acceptance.
+
## Runtime screenshot progress
- [Diagnostic no-AA reference](../../verification/prd455/diagnostic-reference.png), hosted run
diff --git a/packages/create-threenative/__tests__/scaffold.spec.ts b/packages/create-threenative/__tests__/scaffold.spec.ts
index 23fe0bcf80..675ec84ec0 100644
--- a/packages/create-threenative/__tests__/scaffold.spec.ts
+++ b/packages/create-threenative/__tests__/scaffold.spec.ts
@@ -195,7 +195,7 @@ const PRD_201_PARENT_SCAFFOLD_HASHES: Readonly> = {
shooter: "d5a0cf3706e7a0b621fa9290564ac896467b256154d7f6abdf75ca4c36aade91",
snow: "d59cab83418e9636bb9b48f8b802b3c36defdc5889e4a03c96b1167b7a4f2623",
// PRD-455: starter-only opt-in temporalAA.ts plus its ownership/qualification paragraph.
- starter: "5a9466593ad0b5569cb95214d8735e605151423c4a2b1764260da4fd41c20c5f",
+ starter: "5a1f04f175829638cff912a8479194b5f5e56289b56d57a69be0452551a6f12d",
"tower-defense": "d50982f0cdfe90786e0042e7d7113d847856c9d9eed71673adfb42e6a9349287",
};
diff --git a/packages/create-threenative/__tests__/temporal-aa.spec.ts b/packages/create-threenative/__tests__/temporal-aa.spec.ts
index 0dced795a1..3897b3130f 100644
--- a/packages/create-threenative/__tests__/temporal-aa.spec.ts
+++ b/packages/create-threenative/__tests__/temporal-aa.spec.ts
@@ -42,11 +42,24 @@ function fixture() {
_resolveRenderTarget: RenderTarget;
};
node.setSize(1280, 720);
- temporal.node.setup({ context: { velocity }, renderer: {} } as unknown as NodeBuilder);
- return { camera, copies, events, frame, node, scenePass, temporal };
+ const dependencies: Record = {};
+ temporal.node.setup({
+ context: { velocity },
+ renderer: {},
+ getNodeProperties: () => dependencies,
+ } as unknown as NodeBuilder);
+ return { camera, copies, dependencies, events, frame, node, scenePass, temporal };
}
describe("opt-in full-resolution temporal AA", () => {
+ it("registers input-pass dependencies before temporal update and sizing", () => {
+ const { dependencies, temporal, scenePass } = fixture();
+ expect(Object.values(dependencies)).toContain(temporal.node.beautyNode);
+ expect(Object.values(dependencies)).toContain(temporal.node.depthNode);
+ expect(Object.values(dependencies)).toContain(temporal.node.velocityNode);
+ temporal.dispose();
+ scenePass.dispose();
+ });
it("seeds current colour on first use and a camera cut, not ordinary frames", () => {
const { temporal, frame, copies, events, scenePass, node } = fixture();
temporal.node.updateBefore(frame);
diff --git a/packages/create-threenative/templates/starter/src/render/temporalAA.ts b/packages/create-threenative/templates/starter/src/render/temporalAA.ts
index 155efcec54..5be7c099d4 100644
--- a/packages/create-threenative/templates/starter/src/render/temporalAA.ts
+++ b/packages/create-threenative/templates/starter/src/render/temporalAA.ts
@@ -46,6 +46,22 @@ export function createTemporalAA(
_resolveRenderTarget: RenderTarget;
setViewOffset(width: number, height: number): void;
};
+ const setup = node.setup.bind(node);
+ node.setup = (builder) => {
+ // NodeBuilder schedules child passes before this update only when setup declares them.
+ // Upstream TRAANode otherwise discovers these while drawing its resolve material, too late
+ // for same-frame dimensions/depth. Follow Three's GaussianBlur/FSR1 dependency pattern.
+ // Runtime NodeBuilder API, absent from the pinned @types/three declaration.
+ const properties = (
+ builder as unknown as {
+ getNodeProperties(node: Node): Record;
+ }
+ ).getNodeProperties(node);
+ properties.temporalColour = node.beautyNode;
+ properties.temporalDepth = depth;
+ properties.temporalVelocity = velocity;
+ return setup(builder);
+ };
const projection = new Matrix4().copy(camera.projectionMatrix);
let pending: TemporalResetReason | null = "initial";
let disposed = false;
diff --git a/scripts/verify-temporal-aa.ts b/scripts/verify-temporal-aa.ts
index fde1d33bbe..aa42f9c572 100644
--- a/scripts/verify-temporal-aa.ts
+++ b/scripts/verify-temporal-aa.ts
@@ -2,7 +2,7 @@ import assert from "node:assert/strict";
import { mkdir, readFile, writeFile } from "node:fs/promises";
import path from "node:path";
import { fileURLToPath } from "node:url";
-import { PNG } from "pngjs";
+import { assertCaptureNotBlank } from "../packages/playtest/dist/capture.js";
import {
WEBGPU_BROWSER_ARGS,
runStandalonePlaytest,
@@ -108,7 +108,10 @@ for (const variant of ["reference", "temporal", "cut", "projection", "resize"] a
assert.equal(observed.lastReset?.resetReason, reset);
}
for (const filename of ["before.png", "after.png"]) {
- const image = PNG.sync.read(await readFile(path.join(artifactDirectory, filename)));
+ const image = assertCaptureNotBlank(
+ await readFile(path.join(artifactDirectory, filename)),
+ `${variant}/${filename}`,
+ );
assert.ok(
image.width >= 960 && image.height >= 540,
`${variant}: actual canvas capture required`,
From d3c6628af7128018bb1a5329d3f93323dc55b7ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jo=C3=A3o=20Paulo=20Furtado?=
<30300459+jonit-dev@users.noreply.github.com>
Date: Fri, 2 Oct 2026 02:42:41 -0700
Subject: [PATCH 12/90] docs(prd455): attach verified full-resolution runtime
progress
---
...-reconstruction-from-dynamic-resolution.md | 21 +-
docs/verification/prd455/fullres-cut.png | Bin 0 -> 29295 bytes
.../prd455/fullres-projection.png | Bin 0 -> 24053 bytes
.../verification/prd455/fullres-reference.png | Bin 0 -> 15008 bytes
docs/verification/prd455/fullres-resize.png | Bin 0 -> 41663 bytes
docs/verification/prd455/fullres-runtime.json | 321 ++++++++++++++++++
docs/verification/prd455/fullres-temporal.png | Bin 0 -> 37107 bytes
7 files changed, 340 insertions(+), 2 deletions(-)
create mode 100644 docs/verification/prd455/fullres-cut.png
create mode 100644 docs/verification/prd455/fullres-projection.png
create mode 100644 docs/verification/prd455/fullres-reference.png
create mode 100644 docs/verification/prd455/fullres-resize.png
create mode 100644 docs/verification/prd455/fullres-runtime.json
create mode 100644 docs/verification/prd455/fullres-temporal.png
diff --git a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
index 84eecdb9ed..55c97237a0 100644
--- a/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
+++ b/docs/PRDs/unreal-like-features/PRD-455-temporal-reconstruction-from-dynamic-resolution.md
@@ -4,7 +4,7 @@ prd_contract: v1
# PRD-455 — Fewer rendered pixels reconstruct into a stable full-resolution frame
-**Status:** IN PROGRESS — full-resolution temporal-AA milestone first (owner, 2026-10-02).
+**Status:** IN PROGRESS — full-resolution opt-in runtime milestone verified on browser software WebGPU; reconstruction remains open (2026-10-02).
**Priority:** highest-value rendering project after the streaming quick wins.
**Complexity:** 8 → HIGH. The renderer already has the difficult prerequisites; the remaining risk is history correctness and proving reconstruction wins more GPU time than it costs.
**Depends on:** the landed motion-history implementation from PRD-269 (`packages/core/src/render/velocity.ts`, commit `3630847a`), the existing `RenderChain`, and [PRD-384 adaptive resolution](../PRD-384-adaptive-resolution-gpu-headroom.md).
@@ -73,7 +73,7 @@ experimental path or mark the draft ready before the outstanding acceptance evid
### Phase 1 — Define history correctness before chasing image quality
-- [ ] Full-resolution temporal AA is opt-in generated source, uses the existing velocity source and resets history on discontinuity. **proof:** focused TRAANode/RenderChain tests and the deterministic runtime temporal fixture with actual screenshots; native qualification remains separately reported.
+- [x] Full-resolution temporal AA is opt-in generated source, uses the existing velocity source and resets history on discontinuity. **proof:** hosted run `36990452407` at `9b6a3c6164602cfc710f04e0ea8f078832e3cd23` passes all five real runtime variants; 24 actual AA resolves, cut/projection/resize resets at frame 21, valid history by frame 24; exact source tests and actual screenshots below. Browser SwiftShader correctness only; native and visual-quality/performance superiority remain unqualified.
Partial, 2026-10-02: the installed TRAANode setup/jitter regression reproduced
`setProjectionMatrix is not a function` because RenderChain supplied a sampled texture where
@@ -147,6 +147,23 @@ thresholds. Pending hosted execution must establish the repaired temporal arm be
## Runtime screenshot progress
+[Verified full-resolution runtime provenance](../../verification/prd455/fullres-runtime.json):
+source `9b6a3c6164602cfc710f04e0ea8f078832e3cd23`, run `36990452407`, SwiftShader/google.
+All five final PNGs were inspected; all report diagnostics are empty. The reference and temporal
+arms share frame 24 and matching poses; temporal resolves also count exactly 24.
+
+- [No-AA reference](../../verification/prd455/fullres-reference.png)
+- [Opt-in temporal AA](../../verification/prd455/fullres-temporal.png)
+- [Camera-cut recovery](../../verification/prd455/fullres-cut.png)
+- [Projection-change recovery](../../verification/prd455/fullres-projection.png)
+- [Raster-resize recovery](../../verification/prd455/fullres-resize.png): 960×540 input **and output**,
+ presented on the 1280×720 canvas; this is the baseline resize path, not reconstruction.
+
+This verifies runtime operation/reset recovery in the narrow fixture. Edge-flicker/ghosting
+thresholds, same-frame reset image comparisons, native execution and hardware frame-time wins
+remain open. The PR stays draft and no shipped quality tier enables this helper.
+
+
- [Diagnostic no-AA reference](../../verification/prd455/diagnostic-reference.png), hosted run
`36986673556`, source `bbbf93ca8c10a30b168fdb984d31a7567ebeccaf`. Actual canvas PNG inspected;
[provenance](../../verification/prd455/diagnostic-reference.json) records SwiftShader/software
diff --git a/docs/verification/prd455/fullres-cut.png b/docs/verification/prd455/fullres-cut.png
new file mode 100644
index 0000000000000000000000000000000000000000..8c81d4e669c67d4118d0d73c5f1f65e29e02cbf9
GIT binary patch
literal 29295
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
literal 0
HcmV?d00001
diff --git a/docs/verification/prd455/fullres-projection.png b/docs/verification/prd455/fullres-projection.png
new file mode 100644
index 0000000000000000000000000000000000000000..839d115a98493bfc6483888ad5f8ce91da63770b
GIT binary patch
literal 24053
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