@forgeax/engine-app 0.1.6 → 0.1.19

package/dist/internal/browser-rhi-debug-runtime.d.ts

@@ -1,10 +1,10 @@
 import type { Renderer } from '@forgeax/engine-render';
 import type { RhiDevice, RhiInstance } from '@forgeax/engine-rhi';
-import type { CreateShaderModuleFn, RecorderAttachment } from '@forgeax/engine-rhi-debug';
+import type { CreateShaderModuleFn, RecorderAttachment, V7Tape } from '@forgeax/engine-rhi-debug';
 export interface BrowserRhiDebugRuntime {
     readonly rhi: RhiInstance;
     readonly attachment: RecorderAttachment;
-    readonly createReplayDevice: () => Promise<import('@forgeax/engine-types').Result<RhiDevice, unknown>>;
+    readonly createReplayDevice: (tape: V7Tape) => Promise<import('@forgeax/engine-types').Result<RhiDevice, unknown>>;
     readonly createShaderModule: CreateShaderModuleFn;
     readonly rhiInstrumentation: import('@forgeax/engine-render/internal/construct-renderer').RhiBackendInstrumentation;
     attachRenderer(renderer: Renderer): () => void;

package/dist/internal/browser-rhi-debug-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-rhi-debug-runtime.d.ts","sourceRoot":"","sources":["../../src/internal/browser-rhi-debug-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EACV,oBAAoB,EAEpB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CACxC,OAAO,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAC3D,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,OAAO,oDAAoD,EAAE,yBAAyB,CAAC;IACpH,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;CAChD;AAmBD;;;;GAIG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAuBpF"}
+{"version":3,"file":"browser-rhi-debug-runtime.d.ts","sourceRoot":"","sources":["../../src/internal/browser-rhi-debug-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EACV,oBAAoB,EAEpB,kBAAkB,EAClB,MAAM,EACP,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,OAAO,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,OAAO,oDAAoD,EAAE,yBAAyB,CAAC;IACpH,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAAC;CAChD;AAmBD;;;;GAIG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAyBpF"}

package/dist/tool-preview/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/tool-preview/bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/tool-preview/bootstrap.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-app",
-  "version": "0.1.6",
+  "version": "0.1.19",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -23,32 +23,32 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-animation": "0.1.6",
-    "@forgeax/engine-assets-runtime": "0.1.6",
-    "@forgeax/engine-audio": "0.1.6",
-    "@forgeax/engine-audio-webaudio": "0.1.6",
-    "@forgeax/engine-debug-draw": "0.1.6",
-    "@forgeax/engine-ecs": "0.1.6",
-    "@forgeax/engine-input": "0.1.6",
-    "@forgeax/engine-physics": "0.1.6",
-    "@forgeax/engine-physics-rapier2d": "0.1.6",
-    "@forgeax/engine-physics-rapier3d": "0.1.6",
-    "@forgeax/engine-plugin": "0.1.6",
-    "@forgeax/engine-profiler": "0.1.6",
-    "@forgeax/engine-render": "0.1.6",
-    "@forgeax/engine-rhi": "0.1.6",
-    "@forgeax/engine-runtime": "0.1.6",
-    "@forgeax/engine-scene": "0.1.6",
-    "@forgeax/engine-state": "0.1.6",
-    "@forgeax/engine-tool-runtime": "0.1.6",
-    "@forgeax/engine-types": "0.1.6"
+    "@forgeax/engine-animation": "0.1.19",
+    "@forgeax/engine-assets-runtime": "0.1.19",
+    "@forgeax/engine-audio": "0.1.19",
+    "@forgeax/engine-audio-webaudio": "0.1.19",
+    "@forgeax/engine-debug-draw": "0.1.19",
+    "@forgeax/engine-ecs": "0.1.19",
+    "@forgeax/engine-input": "0.1.19",
+    "@forgeax/engine-physics": "0.1.19",
+    "@forgeax/engine-physics-rapier2d": "0.1.19",
+    "@forgeax/engine-physics-rapier3d": "0.1.19",
+    "@forgeax/engine-plugin": "0.1.19",
+    "@forgeax/engine-profiler": "0.1.19",
+    "@forgeax/engine-render": "0.1.19",
+    "@forgeax/engine-rhi": "0.1.19",
+    "@forgeax/engine-rhi-debug": "0.1.19",
+    "@forgeax/engine-runtime": "0.1.19",
+    "@forgeax/engine-scene": "0.1.19",
+    "@forgeax/engine-state": "0.1.19",
+    "@forgeax/engine-tool-runtime": "0.1.19",
+    "@forgeax/engine-types": "0.1.19"
   },
   "devDependencies": {
-    "@forgeax/engine-remote": "0.1.6",
-    "@forgeax/engine-rhi-debug": "0.1.6",
-    "@forgeax/engine-rhi-null": "0.1.6",
-    "@forgeax/engine-rhi-webgpu": "0.1.6",
-    "@forgeax/engine-rhi-wgpu": "0.1.6",
+    "@forgeax/engine-remote": "0.1.19",
+    "@forgeax/engine-rhi-null": "0.1.19",
+    "@forgeax/engine-rhi-webgpu": "0.1.19",
+    "@forgeax/engine-rhi-wgpu": "0.1.19",
     "@types/ws": "^8.5.10",
     "@webgpu/types": "^0.1.71",
     "ws": "^8.20.0"

package/src/__tests__/browser-frame-signal.browser.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  FORGEAX_FRAME_SUBMITTED_EVENT,
+  publishBrowserFrameSubmitted,
+} from '../browser-frame-signal';
+
+describe('publishBrowserFrameSubmitted in a browser', () => {
+  it('dispatches frame-submitted on a real HTMLCanvasElement', () => {
+    const canvas = document.createElement('canvas');
+    const received: Event[] = [];
+    canvas.addEventListener(FORGEAX_FRAME_SUBMITTED_EVENT, (event) => received.push(event));
+
+    publishBrowserFrameSubmitted(canvas, { frameId: 11, deviceGeneration: 4 });
+
+    expect(received).toHaveLength(1);
+    expect(received[0]).toBeInstanceOf(CustomEvent);
+    expect((received[0] as CustomEvent).detail).toEqual({ frameId: 11, deviceGeneration: 4 });
+  });
+});

package/src/__tests__/browser-frame-signal.unit.test.ts

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  FORGEAX_FRAME_SUBMITTED_EVENT,
+  publishBrowserFrameSubmitted,
+} from '../browser-frame-signal';
+
+describe('publishBrowserFrameSubmitted', () => {
+  it('projects Dawn canvas progress without requiring DOM event methods', () => {
+    const documentElement = { dataset: {} as DOMStringMap };
+    const canvas = { ownerDocument: { documentElement } } as HTMLCanvasElement;
+
+    expect(() =>
+      publishBrowserFrameSubmitted(canvas, { frameId: 7, deviceGeneration: 2 }),
+    ).not.toThrow();
+    expect(documentElement.dataset.forgeaxFrameSubmitted).toBe('7');
+  });
+
+  it('dispatches the browser event when the canvas supports dispatchEvent', () => {
+    let dispatchedEvent: Event | undefined;
+    const dispatchEvent = (event: Event): boolean => {
+      dispatchedEvent = event;
+      return true;
+    };
+    const canvas = { dispatchEvent } as unknown as HTMLCanvasElement;
+
+    publishBrowserFrameSubmitted(canvas, { frameId: 9, deviceGeneration: 3 });
+
+    expect(dispatchedEvent).toBeInstanceOf(CustomEvent);
+    if (!(dispatchedEvent instanceof CustomEvent))
+      throw new Error('frame event was not dispatched');
+    expect(dispatchedEvent.type).toBe(FORGEAX_FRAME_SUBMITTED_EVENT);
+    expect(dispatchedEvent.detail).toEqual({ frameId: 9, deviceGeneration: 3 });
+  });
+});

package/src/__tests__/create-app-stop.test.ts

@@ -392,8 +392,9 @@ describe('feat-20260619 M3: auto-register audioTickSystem', () => {
         addEventListener: vi.fn(),
         removeEventListener: vi.fn(),
       });
-      // biome-ignore lint/suspicious/noExplicitAny: vitest mock for AudioContext constructor
-      globalThis.AudioContext = vi.fn(() => makeMockAudioContextForApp()) as any;
+      globalThis.AudioContext = vi.fn(function AudioContextMock() {
+        return makeMockAudioContextForApp();
+      }) as unknown as typeof AudioContext;
 
       const rafStub = installRafStub();
 
@@ -458,6 +459,7 @@ describe('feat-20260619 M3: auto-register audioTickSystem', () => {
         expect(rafStub.tickFn).not.toBeNull();
         rafStub.tickFn?.();
 
+        expect(world.execution.health).toBe('healthy');
         expect(playSpy).toHaveBeenCalledTimes(1);
 
         app.stop();
@@ -477,8 +479,9 @@ describe('feat-20260619 M3: auto-register audioTickSystem', () => {
         addEventListener: vi.fn(),
         removeEventListener: vi.fn(),
       });
-      // biome-ignore lint/suspicious/noExplicitAny: vitest mock for AudioContext constructor
-      globalThis.AudioContext = vi.fn(() => makeMockAudioContextForApp()) as any;
+      globalThis.AudioContext = vi.fn(function AudioContextMock() {
+        return makeMockAudioContextForApp();
+      }) as unknown as typeof AudioContext;
 
       const rafStub = installRafStub();
 
@@ -543,8 +546,9 @@ describe('feat-20260619 M3: auto-register audioTickSystem', () => {
         addEventListener: vi.fn(),
         removeEventListener: vi.fn(),
       });
-      // biome-ignore lint/suspicious/noExplicitAny: vitest mock for AudioContext constructor
-      globalThis.AudioContext = vi.fn(() => makeMockAudioContextForApp()) as any;
+      globalThis.AudioContext = vi.fn(function AudioContextMock() {
+        return makeMockAudioContextForApp();
+      }) as unknown as typeof AudioContext;
 
       const rafStub = installRafStub();
 

package/src/__tests__/create-app.test.ts

@@ -23,7 +23,7 @@
 
 import { World } from '@forgeax/engine-ecs';
 import { Camera, orthographic, perspective } from '@forgeax/engine-render';
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 
 import { syncCameraAspect, syncCanvasDrawingBuffer } from '../create-app';
 import { resolveRhiDebugFlag } from '../internal/rhi-debug-flag';
@@ -231,6 +231,18 @@ describe('create-app.test.ts', () => {
       expect(r.value.aspect).toBeCloseTo(2, 5);
     });
 
+    it('does not journal a same-f32 aspect on every frame', () => {
+      const world = new World();
+      world.spawn({ component: Camera, data: perspective({ fov: 1, aspect: 1 }) }).unwrap();
+      const set = vi.spyOn(world, 'set');
+
+      syncCameraAspect(world, 1280, 720);
+      syncCameraAspect(world, 1280, 720);
+
+      expect(set).toHaveBeenCalledTimes(1);
+      set.mockRestore();
+    });
+
     it('autoAspect=false camera is left untouched', () => {
       const world = new World();
       const cam = world

package/src/__tests__/tool-preview-runtime-contract.unit.test.ts

@@ -0,0 +1,47 @@
+import { readFileSync } from 'node:fs';
+import { describe, expect, it } from 'vitest';
+
+const bootstrapSource = readFileSync(
+  new URL('../tool-preview/bootstrap.ts', import.meta.url),
+  'utf8',
+);
+const runtimeSource = readFileSync(
+  new URL('../internal/browser-rhi-debug-runtime.ts', import.meta.url),
+  'utf8',
+);
+
+describe('tool preview runtime contract', () => {
+  it('captures one rendered frame after warmup and the live-resource snapshot', () => {
+    const finalFrame = bootstrapSource.indexOf('if (frame === recipe.frames - 1)');
+    const armed = bootstrapSource.indexOf(
+      'encodedCapture = runtime.attachment.captureFrame()',
+      finalFrame,
+    );
+    const snapshot = bootstrapSource.indexOf('runtime.attachment.frameBoundary()', armed);
+    const rendered = bootstrapSource.indexOf('app.stepFrame(recipe.deltaSeconds)', snapshot);
+    const finalized = bootstrapSource.indexOf(
+      'const finalized = await runtime.attachment.frameBoundary()',
+      rendered,
+    );
+
+    expect(finalFrame).toBeGreaterThan(-1);
+    expect(armed).toBeGreaterThan(finalFrame);
+    expect(snapshot).toBeGreaterThan(armed);
+    expect(rendered).toBeGreaterThan(snapshot);
+    expect(finalized).toBeGreaterThan(rendered);
+  });
+
+  it('requests replay features and limits from the recorded tape', () => {
+    expect(bootstrapSource).toContain('runtime.createReplayDevice(parsed.value)');
+    expect(runtimeSource).toContain('createReplayDevice: async (tape)');
+    expect(runtimeSource).toContain(
+      'replayDeviceRequest(tape, adapter.value.features, adapter.value.limits)',
+    );
+  });
+
+  it('publishes owner identity only after the recorded tape proves a subject draw', () => {
+    expect(bootstrapSource).toContain("resource.kind === 'material' || resource.kind === 'mesh'");
+    expect(bootstrapSource).toContain('return drawCalls > 2');
+    expect(bootstrapSource).toContain('observation: capture.resource.ownerFacts');
+  });
+});

package/src/browser-frame-signal.ts

@@ -0,0 +1,44 @@
+/**
+ * Browser-visible render progress owned by the App frame loop.
+ *
+ * The Renderer already emits `frame-submitted` after its sole queue-submit
+ * boundary. This adapter projects that event onto the document without
+ * exposing a renderer handle or creating a second readiness registry. DevKit
+ * capture waits on the same projection, then verifies compositor pixels.
+ */
+
+export const FORGEAX_FRAME_SUBMITTED_DATASET = 'forgeaxFrameSubmitted';
+export const FORGEAX_FRAME_SUBMITTED_EVENT = 'forgeax:frame-submitted';
+
+export interface BrowserFrameSubmitted {
+  readonly frameId: number;
+  readonly deviceGeneration: number;
+}
+
+export function resetBrowserFrameSubmitted(canvas: HTMLCanvasElement): void {
+  const documentElement = canvas.ownerDocument?.documentElement;
+  if (documentElement !== undefined) {
+    delete documentElement.dataset[FORGEAX_FRAME_SUBMITTED_DATASET];
+  }
+}
+
+export function publishBrowserFrameSubmitted(
+  canvas: HTMLCanvasElement,
+  event: BrowserFrameSubmitted,
+): void {
+  const documentElement = canvas.ownerDocument?.documentElement;
+  if (documentElement !== undefined) {
+    documentElement.dataset[FORGEAX_FRAME_SUBMITTED_DATASET] = String(event.frameId);
+  }
+  // Dawn-node smoke canvases intentionally expose only the drawing-buffer
+  // surface; they are not DOM EventTargets. Keep the document projection
+  // above useful for those hosts, while dispatching the browser event only
+  // when the host actually provides the optional EventTarget capability.
+  if (typeof CustomEvent === 'function' && typeof canvas.dispatchEvent === 'function') {
+    canvas.dispatchEvent(
+      new CustomEvent(FORGEAX_FRAME_SUBMITTED_EVENT, {
+        detail: Object.freeze({ ...event }),
+      }),
+    );
+  }
+}

package/src/canvas-policy.ts

@@ -11,6 +11,7 @@ export function syncCameraAspect(world: World, canvasW: number, canvasH: number)
     if (!camera.ok) continue;
     if (camera.value.autoAspect !== true) continue;
     if (camera.value.projection !== CAMERA_PROJECTION_PERSPECTIVE) continue;
+    if (camera.value.aspect === Math.fround(aspect)) continue;
     world.set(row.entity, Camera, { aspect });
   }
 }

package/src/create-app.ts

@@ -47,6 +47,7 @@ import {
 import { err, ok, type Result } from '@forgeax/engine-types';
 
 import { createAnimationPayloadLookup } from './animation-asset-lookup';
+import { publishBrowserFrameSubmitted, resetBrowserFrameSubmitted } from './browser-frame-signal';
 import type { AppErrorCode, AppErrorDetailFor } from './errors';
 import { APP_ERROR_HINTS, APP_EXPECTED, AppError } from './errors';
 import {
@@ -564,6 +565,7 @@ async function createAppFromCanvas(
     world,
     pluginContext,
     executionControl,
+    onFrameSubmitted: (event) => publishBrowserFrameSubmitted(canvas, event),
     ...(inputBackend !== undefined ? { inputBackend } : {}),
     ...(inputHandle === undefined
       ? {}
@@ -600,6 +602,7 @@ async function createAppFromCanvas(
 
   // The aspect-sync sidecar belongs to the canvas path because it owns the DOM
   // canvas. It runs as an Update system so it shares World scheduling semantics.
+  resetBrowserFrameSubmitted(canvas);
   const built = await buildApp(buildArgs);
   if (!built.ok) {
     await pluginContext.fiber.dispose();
@@ -805,6 +808,7 @@ export function syncCameraAspect(world: World, canvasW: number, canvasH: number)
     // perspective discriminator is the numeric column value.
     if (r.value.autoAspect !== true) continue;
     if (r.value.projection !== CAMERA_PROJECTION_PERSPECTIVE) continue;
+    if (r.value.aspect === Math.fround(aspect)) continue;
     world.set(entity, Camera, { aspect });
   }
 }
@@ -994,6 +998,11 @@ interface BuildAppArgs {
     | undefined;
   readonly profiler?: import('@forgeax/engine-profiler').Profiler;
   readonly executionControl?: import('./execution/control').LocalExecutionControl;
+  /** Canvas-form projection of the Renderer frame-submitted event. */
+  readonly onFrameSubmitted?: (event: {
+    readonly frameId: number;
+    readonly deviceGeneration: number;
+  }) => void;
 }
 
 /**
@@ -1118,6 +1127,10 @@ async function buildApp(args: BuildAppArgs): Promise<Result<App, AppError | RhiE
       return;
     }
     rendererUnsubscribe = renderer.subscribe((event) => {
+      if (event.kind === 'frame-submitted') {
+        args.onFrameSubmitted?.(event);
+        return;
+      }
       if (event.kind !== 'error') return;
       const e: RenderError = event.error;
       dispatch(e);

package/src/index.ts

@@ -39,6 +39,13 @@ export {
   createFullscreenRenderFeature,
   type FullscreenRenderFeatureOptions,
 } from '@forgeax/engine-render/authoring';
+export {
+  type BrowserFrameSubmitted,
+  FORGEAX_FRAME_SUBMITTED_DATASET,
+  FORGEAX_FRAME_SUBMITTED_EVENT,
+  publishBrowserFrameSubmitted,
+  resetBrowserFrameSubmitted,
+} from './browser-frame-signal';
 export { createApp, measureCanvasDrawingBuffer, syncCanvasDrawingBuffer } from './create-app';
 export type {
   AppDetailCanvasDetached,

package/src/internal/browser-rhi-debug-runtime.ts

@@ -4,16 +4,17 @@ import type {
   CreateShaderModuleFn,
   RecordableBackend,
   RecorderAttachment,
+  V7Tape,
 } from '@forgeax/engine-rhi-debug';
-import { attachRecorder } from '@forgeax/engine-rhi-debug';
+import { attachRecorder, replayDeviceRequest } from '@forgeax/engine-rhi-debug';
 import { createRhiInstrumentation } from './rhi-capture';
 
 export interface BrowserRhiDebugRuntime {
   readonly rhi: RhiInstance;
   readonly attachment: RecorderAttachment;
-  readonly createReplayDevice: () => Promise<
-    import('@forgeax/engine-types').Result<RhiDevice, unknown>
-  >;
+  readonly createReplayDevice: (
+    tape: V7Tape,
+  ) => Promise<import('@forgeax/engine-types').Result<RhiDevice, unknown>>;
   readonly createShaderModule: CreateShaderModuleFn;
   readonly rhiInstrumentation: import('@forgeax/engine-render/internal/construct-renderer').RhiBackendInstrumentation;
   attachRenderer(renderer: Renderer): () => void;
@@ -51,10 +52,12 @@ export async function createBrowserRhiDebugRuntime(): Promise<BrowserRhiDebugRun
     attachment,
     createShaderModule: backend.createShaderModule,
     rhiInstrumentation: createRhiInstrumentation(attachment),
-    createReplayDevice: async () => {
+    createReplayDevice: async (tape) => {
       const adapter = await backend.rhi.requestAdapter();
       if (!adapter.ok) return adapter;
-      return adapter.value.requestDevice();
+      return adapter.value.requestDevice(
+        replayDeviceRequest(tape, adapter.value.features, adapter.value.limits),
+      );
     },
     attachRenderer(_renderer: Renderer): () => void {
       // Frame boundaries and device loss are connected by the typed

package/src/tool-preview/bootstrap.ts

@@ -203,6 +203,12 @@ function resourceSubjectDigest(resource: ToolPreviewResourceFacts | undefined):
   return candidates.find((value): value is string => typeof value === 'string' && value.length > 0);
 }
 
+function resourceSubjectDrawn(resource: ToolPreviewResourceFacts, drawCalls: number): boolean {
+  if (resource.kind === 'texture') return drawCalls > 0;
+  if (resource.kind === 'material' || resource.kind === 'mesh') return drawCalls > 2;
+  return resource.observation !== undefined;
+}
+
 export async function replayToolPreviewCapture(
   capture: ToolPreviewCaptureResult,
 ): Promise<Result<ToolPreviewRunResult, ToolPreviewHostError>> {
@@ -217,13 +223,29 @@ export async function replayToolPreviewCapture(
       detail: { phase: 'tape-parse', cause: parsed.error },
     });
   }
-  const subjectDigest = resourceSubjectDigest(capture.resource);
-  if (capture.resource !== undefined && subjectDigest === undefined) {
+  const drawCalls = countDrawCalls(parsed.value);
+  const resource =
+    capture.resource !== undefined &&
+    capture.resource.observation === undefined &&
+    capture.resource.ownerFacts !== undefined &&
+    resourceSubjectDrawn(capture.resource, drawCalls)
+      ? { ...capture.resource, observation: capture.resource.ownerFacts }
+      : capture.resource;
+  const subjectDigest = resourceSubjectDigest(resource);
+  if (resource !== undefined && subjectDigest === undefined) {
     return err({
       code: 'tool-preview-bootstrap-failed',
       expected: 'the resource owner to publish a subject identity before evidence publication',
       hint: 'repair AssetRegistry owner facts or post-frame observation; recipe and trace are not subject identity',
-      detail: { phase: 'resource-identity' },
+      detail: {
+        phase: 'resource-identity',
+        cause: {
+          kind: resource.kind,
+          drawCalls,
+          ownerFactsPublished: resource.ownerFacts !== undefined,
+          observationPublished: resource.observation !== undefined,
+        },
+      },
     });
   }
   let runtime: Awaited<ReturnType<typeof createBrowserRhiDebugRuntime>>;
@@ -237,7 +259,7 @@ export async function replayToolPreviewCapture(
       detail: { phase: 'replay-runtime', cause },
     });
   }
-  const replayDevice = await runtime.createReplayDevice();
+  const replayDevice = await runtime.createReplayDevice(parsed.value);
   if (!replayDevice.ok) {
     return err({
       code: 'tool-preview-capability-unavailable',
@@ -259,7 +281,6 @@ export async function replayToolPreviewCapture(
     });
   }
   const replay = replayResult.value;
-  const drawCalls = countDrawCalls(parsed.value);
   if (drawCalls === 0) {
     await replay.dispose();
     return err({
@@ -507,7 +528,7 @@ export async function replayToolPreviewCapture(
         },
       },
     },
-    ...(capture.resource === undefined ? {} : { resource: capture.resource }),
+    ...(resource === undefined ? {} : { resource }),
   });
 }
 
@@ -673,7 +694,7 @@ export async function createToolPreviewHost(
       });
     const executeStartedAtMs = performance.now();
     const actionTrace: ToolPreviewAction[] = [];
-    const encodedCapture = runtime.attachment.captureFrame();
+    let encodedCapture: ReturnType<typeof runtime.attachment.captureFrame> | undefined;
     for (let frame = 0; frame < recipe.frames; frame += 1) {
       for (const action of recipe.actions.filter((candidate) => candidate.frame === frame)) {
         let accepted = false;
@@ -697,6 +718,17 @@ export async function createToolPreviewHost(
         }
         actionTrace.push(action);
       }
+      if (frame === recipe.frames - 1) {
+        encodedCapture = runtime.attachment.captureFrame();
+        const snapshot = await runtime.attachment.frameBoundary();
+        if (!snapshot.ok)
+          return err({
+            code: 'tool-preview-bootstrap-failed',
+            expected: 'RHI-debug snapshots live resources before the captured frame',
+            hint: snapshot.error.hint,
+            detail: { phase: 'rhi-snapshot', cause: snapshot.error },
+          });
+      }
       const stepped = app.stepFrame(recipe.deltaSeconds);
       if (!stepped.ok)
         return err({
@@ -710,12 +742,14 @@ export async function createToolPreviewHost(
       // only the feature's intentional `next-frame` pending state.
       await new Promise<void>((resolve) => setTimeout(resolve, 0));
     }
-    // RecorderAttachment captures one complete frame. The first boundary
-    // snapshots live resources and the following boundary finalizes it;
-    // explicit boundaries keep stepFrame() deterministic for preview hosts.
-    await runtime.attachment.frameBoundary();
-    await new Promise<void>((resolve) => setTimeout(resolve, 0));
-    await runtime.attachment.frameBoundary();
+    const finalized = await runtime.attachment.frameBoundary();
+    if (!finalized.ok)
+      return err({
+        code: 'tool-preview-bootstrap-failed',
+        expected: 'RHI-debug finalizes the captured frame',
+        hint: finalized.error.hint,
+        detail: { phase: 'rhi-finalize', cause: finalized.error },
+      });
     if (options.collectResourceFacts !== undefined) {
       try {
         const collected = await options.collectResourceFacts(app, resourceFacts);
@@ -744,6 +778,14 @@ export async function createToolPreviewHost(
         detail: { phase: 'profiler-finish', cause: profile.error },
       });
     }
+    if (encodedCapture === undefined) {
+      return err({
+        code: 'tool-preview-bootstrap-failed',
+        expected: 'a positive-frame recipe to arm one captured frame',
+        hint: 'validate the recipe before running the preview host',
+        detail: { phase: 'rhi-capture' },
+      });
+    }
     const tape = await encodedCapture;
     if (!tape.ok)
       return err({