@forgeax/engine-rhi-debug 0.1.6 → 0.1.7

package/dist/replay/device-request.d.ts

@@ -0,0 +1,8 @@
+import type { Tape } from '../protocol/types';
+/**
+ * Build the strongest fresh WebGPU device the current adapter can provide for
+ * a recorded tape. Optional features must be enabled, not merely advertised,
+ * and replay receives concrete adapter limits instead of lower device defaults.
+ */
+export declare function replayDeviceRequest(tape: Tape, adapterFeatures: ReadonlySet<GPUFeatureName>, adapterLimits: Readonly<Record<string, number>>): GPUDeviceDescriptor;
+//# sourceMappingURL=device-request.d.ts.map

package/dist/replay/device-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-request.d.ts","sourceRoot":"","sources":["../../src/replay/device-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAY9C;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,WAAW,CAAC,cAAc,CAAC,EAC5C,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC9C,mBAAmB,CAgBrB"}

package/dist/replay/readback.d.ts

@@ -13,6 +13,12 @@ export interface TextureReadbackSubresource {
     readonly aspect?: 'all' | 'depth-only' | 'stencil-only';
 }
 export type ReplayReadbackRequest = BufferReadbackRange | TextureReadbackSubresource;
+export interface ReplayReadbackProvenance {
+    readonly generation: number;
+    readonly resourceId: string;
+    readonly subresource: ReplayReadbackRequest | null;
+    readonly selectedWorkIndex?: number;
+}
 export interface ReplayReadbackResult {
     readonly resourceId: string;
     readonly kind: 'buffer' | 'texture';
@@ -20,6 +26,7 @@ export interface ReplayReadbackResult {
     readonly width?: number;
     readonly height?: number;
     readonly bytes: Uint8Array;
+    readonly provenance: ReplayReadbackProvenance;
 }
 export declare function readReplayResource(device: RhiDevice, table: ResourceTable, resourceId: string, subresource: ReplayReadbackRequest | undefined, createShaderModule: CreateShaderModuleFn): Promise<Result<ReplayReadbackResult, RhiDebugError>>;
 //# sourceMappingURL=readback.d.ts.map

package/dist/replay/readback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readback.d.ts","sourceRoot":"","sources":["../../src/replay/readback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,SAAS,EAEV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAWrE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC;CACzD;AAED,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,0BAA0B,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,kBAAkB,EAAE,oBAAoB,GACvC,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAgBtD"}
+{"version":3,"file":"readback.d.ts","sourceRoot":"","sources":["../../src/replay/readback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,SAAS,EAEV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAWrE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC;CACzD;AAED,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,0BAA0B,CAAC;AAErF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;CAC/C;AAID,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,kBAAkB,EAAE,oBAAoB,GACvC,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAoCtD"}

package/dist/replay/session.d.ts

@@ -1,6 +1,7 @@
 import type { RhiDevice } from '@forgeax/engine-rhi';
 import { type Result } from '@forgeax/engine-types';
 import { type RhiDebugError } from '../errors';
+import { type WorkBinding, type WorkPipeline } from '../frame-model';
 import type { Tape } from '../protocol/types';
 import type { CreateShaderModuleFn } from '../recorder';
 import { type BufferReadbackRange, type ReplayReadbackResult } from './readback';
@@ -20,6 +21,22 @@ export interface WorkInspection {
     readonly eventIndex: number;
     readonly passIndex: number;
     readonly attachment: ReplayReadbackResult | undefined;
+    readonly pipeline?: WorkPipeline;
+    readonly bindings?: readonly WorkBinding[];
+    readonly vertexBuffers?: readonly {
+        readonly slot: number;
+        readonly bufferHandleId: string;
+        readonly offset: number;
+        readonly size: number | null;
+    }[];
+    readonly indexBuffer?: {
+        readonly bufferHandleId: string;
+        readonly format: string;
+        readonly offset: number;
+        readonly size: number | null;
+    } | null;
+    readonly shaders?: WorkPipeline['shaders'];
+    readonly resourceIds?: readonly string[];
 }
 export interface ReplaySession {
     readonly generation: number;

package/dist/replay/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/replay/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,SAAS,EAEV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAEpE,OAAO,KAAK,EAAmC,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;CACnD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC;CACzD;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE3E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IAClD,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,mBAAmB,EACjC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;CACjD;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CA+G/C;AAoSD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/replay/session.ts"],"names":[],"mappings":"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"}

package/dist/texel-decode.d.ts

@@ -1,16 +1,17 @@
 /** Decode a single IEEE half-float (16-bit) bit pattern to a JS number. */
 export declare function halfToFloat(h: number): number;
 /**
- * Decode tight raw GPU bytes of an uncompressed color texture into RGBA8 the
- * canvas can paint via putImageData. Returns null when the format has no
- * {@link formatInfo} entry (compressed / depth / unknown -> caller falls back).
+ * Decode tight raw GPU bytes of a supported color or depth/stencil plane into
+ * RGBA8 the canvas can paint via putImageData. Returns null when the format has
+ * no {@link formatInfo} entry or the requested aspect is invalid.
  *
  * @param bytes - Tight readback bytes (no row padding), length = w*h*bytesPerTexel.
  * @param format - The texture's real format string.
  * @param width - Texture width in pixels.
  * @param height - Texture height in pixels.
+ * @param aspect - Explicit plane selected by readback for depth/stencil formats.
  */
-export declare function decodeToRgba8(bytes: Uint8Array, format: string, width: number, height: number): Uint8ClampedArray<ArrayBuffer> | null;
+export declare function decodeToRgba8(bytes: Uint8Array, format: string, width: number, height: number, aspect?: 'all' | 'depth-only' | 'stencil-only'): Uint8ClampedArray<ArrayBuffer> | null;
 /**
  * Decode a single texel from tight raw GPU bytes into raw float RGBA values
  * without the display clamp (D-4: raw byte bypass for HDR fidelity).

package/dist/texel-decode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"texel-decode.d.ts","sourceRoot":"","sources":["../src/texel-decode.ts"],"names":[],"mappings":"AAqBA,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAe7C;AA8GD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,iBAAiB,CAAC,WAAW,CAAC,GAAG,IAAI,CAoCvC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA4BzC"}
+{"version":3,"file":"texel-decode.d.ts","sourceRoot":"","sources":["../src/texel-decode.ts"],"names":[],"mappings":"AAqBA,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAe7C;AA8GD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,KAAK,GAAG,YAAY,GAAG,cAAsB,GACpD,iBAAiB,CAAC,WAAW,CAAC,GAAG,IAAI,CAuCvC;AA+BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA4BzC"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@forgeax/engine-rhi-debug",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
-  "description": "Single-file v7 RHI tape capture, deterministic fresh-backend replay, and structured offline inspection for forgeax-engine.",
+  "description": "Single-file v7 RHI tape capture, FrameModel projection, deterministic fresh-backend replay, and structured AI-readable inspection for forgeax-engine.",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -26,19 +26,19 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-rhi": "0.1.6",
-    "@forgeax/engine-types": "0.1.6",
+    "@forgeax/engine-rhi": "0.1.7",
+    "@forgeax/engine-types": "0.1.7",
     "@noble/hashes": "^2.2.0",
     "pako": "^1.0.11"
   },
   "devDependencies": {
-    "@forgeax/engine-rhi-null": "0.1.6",
+    "@forgeax/engine-rhi-null": "0.1.7",
     "@types/node": "^20.14.0",
     "@webgpu/types": "^0.1.71"
   },
   "peerDependencies": {
-    "@forgeax/engine-rhi-webgpu": "0.1.6",
-    "@forgeax/engine-rhi-wgpu": "0.1.6"
+    "@forgeax/engine-rhi-webgpu": "0.1.7",
+    "@forgeax/engine-rhi-wgpu": "0.1.7"
   },
   "forgeax": {
     "metrics": {

package/src/__tests__/consumer-inventory.unit.test.ts

@@ -1,6 +1,6 @@
 import { spawnSync } from 'node:child_process';
 // @perf-budget-skip: intentional repository-wide inventory subprocess gate.
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -8,6 +8,17 @@ import { describe, expect, it } from 'vitest';
 
 const repoRoot = resolve(fileURLToPath(new URL('../../../../', import.meta.url)));
 const inventoryScript = join(repoRoot, 'apps/shared/scripts/rhi-debug-consumer-inventory.mjs');
+const oosInventoryScript = join(repoRoot, 'apps/shared/scripts/rhi-debug-oos-inventory.mjs');
+
+const deletedFieldConsumers = [
+  'apps/shared/scripts/rhi-debug-browser-admission.mjs',
+  'apps/shared/scripts/rhi-debug-verify.mjs',
+  'apps/learn-render/4.advanced-opengl/5.framebuffers/scripts/smoke-browser-live.mjs',
+  'apps/rhi-debug-viewer/src/viewer-model.ts',
+  'apps/rhi-debug-viewer/scripts/smoke-browser.mjs',
+  'apps/rhi-debug-viewer/scripts/smoke-browser-no-webgpu.mjs',
+  'packages/rhi-debug/src/__tests__/e2e.browser.test.ts',
+];
 
 type ChannelReport = {
   totalMatches: number;
@@ -40,6 +51,33 @@ function runInventory(root: string): { status: number | null; report: InventoryR
 }
 
 describe('rhi-debug consumer inventory', () => {
+  it('reports all nine OOS boundaries and retained owners as machine-readable pass rows', () => {
+    const result = spawnSync(process.execPath, [oosInventoryScript, '--json', '--assert-pass'], {
+      cwd: repoRoot,
+      encoding: 'utf8',
+    });
+    expect(result.status).toBe(0);
+    const report = JSON.parse(result.stdout) as {
+      status: string;
+      oos: readonly { id: string; status: string }[];
+      retainedCore: readonly { present: boolean }[];
+    };
+    expect(report.status).toBe('pass');
+    expect(report.oos.map((entry) => entry.id)).toEqual([
+      'OOS-1',
+      'OOS-2',
+      'OOS-3',
+      'OOS-4',
+      'OOS-5',
+      'OOS-6',
+      'OOS-7',
+      'OOS-8',
+      'OOS-9',
+    ]);
+    expect(report.oos.every((entry) => entry.status === 'pass')).toBe(true);
+    expect(report.retainedCore.every((entry) => entry.present)).toBe(true);
+  });
+
   it('enumerates TS, erased-script, and JSON/schema consumer channels', () => {
     const fixture = mkdtempSync(join(tmpdir(), 'forgeax-rhi-debug-consumers-'));
     try {
@@ -103,4 +141,14 @@ describe('rhi-debug consumer inventory', () => {
       ),
     );
   });
+
+  it('finds no deleted FrameModel fields across the three consumer channels', () => {
+    const deleted =
+      /(?:\bmodel\.(?:tree|draws|meta|resourceTable|resourceEntries|totalDraws)|buildTapeIndex)/;
+    const matches = deletedFieldConsumers.flatMap((relativePath) => {
+      const source = readFileSync(join(repoRoot, relativePath), 'utf8');
+      return deleted.test(source) ? [relativePath] : [];
+    });
+    expect(matches).toEqual([]);
+  });
 });

package/src/__tests__/e2e.browser.test.ts

@@ -180,7 +180,9 @@ describe.skipIf(!GPU_AVAILABLE)('M4 browser capture and replay gate', () => {
     const model = buildFrameModel(captured.tape);
     expect(captured.tape.header.formatVersion).toBe(7);
     expect(captured.tape.events.length).toBeGreaterThan(0);
-    expect(model.meta.totalDraws).toBeGreaterThan(0);
+    expect(model.works.some((work) => work.kind === 'draw' || work.kind === 'drawIndexed')).toBe(
+      true,
+    );
     expect(captured.tape.events.some((event) => event.kind === 'setBindGroup')).toBe(true);
     expect(model.works.length).toBeGreaterThan(0);
 
@@ -199,6 +201,9 @@ describe.skipIf(!GPU_AVAILABLE)('M4 browser capture and replay gate', () => {
     expect(work.attachment?.kind).toBe('texture');
     expect(work.attachment?.width).toBe(SIZE);
     expect(work.attachment?.height).toBe(SIZE);
+    expect(work.attachment?.provenance.selectedWorkIndex).toBe(0);
+    expect(work.attachment?.provenance.resourceId).toBeDefined();
+    expect(work.attachment?.provenance.subresource).toBeNull();
     expect(hasVisibleRgb(work.attachment?.bytes ?? new Uint8Array())).toBe(true);
     await session.dispose();
   }, 60_000);

package/src/__tests__/frame-model-parity.test-d.ts

@@ -1,7 +1,19 @@
 import { expectTypeOf, it } from 'vitest';
 import type { FrameModel } from '../frame-model';
 
-it('exposes stable workIndex fields', () => {
+type HasKey<T, K extends PropertyKey> = K extends keyof T ? true : false;
+type IsReadonlyMap<T> = T extends ReadonlyMap<unknown, unknown> ? true : false;
+
+it('exposes only the canonical JSON-safe model shape', () => {
+  expectTypeOf<HasKey<FrameModel, 'commands'>>().toEqualTypeOf<true>();
+  expectTypeOf<HasKey<FrameModel, 'passes'>>().toEqualTypeOf<true>();
+  expectTypeOf<HasKey<FrameModel, 'resources'>>().toEqualTypeOf<true>();
+  expectTypeOf<HasKey<FrameModel, 'works'>>().toEqualTypeOf<true>();
+  expectTypeOf<HasKey<FrameModel, 'tree'>>().toEqualTypeOf<false>();
+  expectTypeOf<HasKey<FrameModel, 'draws'>>().toEqualTypeOf<false>();
+  expectTypeOf<HasKey<FrameModel, 'meta'>>().toEqualTypeOf<false>();
+  expectTypeOf<HasKey<FrameModel, 'resourceLifecycle'>>().toEqualTypeOf<true>();
+  expectTypeOf<IsReadonlyMap<FrameModel['resources']>>().toEqualTypeOf<false>();
   expectTypeOf<FrameModel['works'][number]['workIndex']>().toEqualTypeOf<number>();
   expectTypeOf<FrameModel['works'][number]['eventIndex']>().toEqualTypeOf<number>();
   expectTypeOf<FrameModel['works'][number]['passIndex']>().toEqualTypeOf<number>();

package/src/__tests__/frame-model-parity.unit.test.ts

@@ -2,37 +2,284 @@ import { describe, expect, it } from 'vitest';
 import { buildFrameModel } from '../frame-model';
 import type { Tape } from '../protocol/types';
 
-describe('FrameModel parity', () => {
-  it('is JSON-safe and derives work entries from the same index', () => {
+function makeTape(): Tape {
+  return {
+    header: { formatVersion: 7, rhiCaps: {}, eventCount: 15, blobCount: 0 },
+    bootstrap: [
+      {
+        handleId: 'buffer-1',
+        kind: 'buffer',
+        create: { kind: 'createBuffer', handleId: 'buffer-1', desc: { size: 64, usage: 4 } },
+        initialData: [],
+      },
+      {
+        handleId: 'shader:1',
+        kind: 'shader-module',
+        create: {
+          kind: 'createShaderModule',
+          handleId: 'shader:1',
+          wgslCode: '@vertex fn vs_main() -> @builtin(position) vec4f { return vec4f(0.0); }',
+        },
+        initialData: [],
+      },
+    ],
+    events: [
+      {
+        kind: 'beginRenderPass',
+        passHandleId: 'pass:render',
+        cmdHandleId: 'encoder:1',
+        desc: { colorAttachments: [] },
+        colorAttachmentViewHandleIds: [],
+      },
+      { kind: 'pushDebugGroup', cmdHandleId: 'encoder:1', groupLabel: 'render group' },
+      { kind: 'passPushDebugGroup', passHandleId: 'pass:render', groupLabel: 'nested group' },
+      { kind: 'insertDebugMarker', cmdHandleId: 'encoder:1', markerLabel: 'before draws' },
+      {
+        kind: 'draw',
+        passHandleId: 'pass:render',
+        vertexCount: 3,
+        instanceCount: 1,
+        firstVertex: 0,
+        firstInstance: 0,
+      },
+      {
+        kind: 'drawIndexed',
+        passHandleId: 'pass:render',
+        indexCount: 3,
+        instanceCount: 1,
+        firstIndex: 0,
+        baseVertex: 0,
+        firstInstance: 0,
+      },
+      {
+        kind: 'drawIndirect',
+        passHandleId: 'pass:render',
+        indirectBufferHandleId: 'buffer-1',
+        indirectOffset: 0,
+      },
+      {
+        kind: 'drawIndexedIndirect',
+        passHandleId: 'pass:render',
+        indirectBufferHandleId: 'buffer-1',
+        indirectOffset: 16,
+      },
+      { kind: 'passPopDebugGroup', passHandleId: 'pass:render' },
+      { kind: 'popDebugGroup', cmdHandleId: 'encoder:1' },
+      { kind: 'endRenderPass', passHandleId: 'pass:render' },
+      {
+        kind: 'beginComputePass',
+        passHandleId: 'pass:compute',
+        cmdHandleId: 'encoder:1',
+        desc: {},
+      },
+      { kind: 'dispatchWorkgroups', passHandleId: 'pass:compute', x: 2, y: 3, z: 1 },
+      {
+        kind: 'dispatchWorkgroupsIndirect',
+        passHandleId: 'pass:compute',
+        indirectBufferHandleId: 'buffer-1',
+        indirectOffset: 32,
+      },
+      { kind: 'endComputePass', passHandleId: 'pass:compute' },
+    ],
+    blobs: [],
+  };
+}
+
+describe('FrameModel canonical projection', () => {
+  it('exposes one JSON-safe projection with six globally indexed work kinds', () => {
+    const model = buildFrameModel(makeTape());
+    const roundTrip = JSON.parse(JSON.stringify(model)) as typeof model;
+
+    expect(roundTrip).toEqual(model);
+    expect(Object.keys(model)).toEqual([
+      'commands',
+      'passes',
+      'resources',
+      'resourceLifecycle',
+      'works',
+    ]);
+    expect(
+      model.works.map((work) => [work.workIndex, work.eventIndex, work.passIndex, work.kind]),
+    ).toEqual([
+      [0, 4, 0, 'draw'],
+      [1, 5, 0, 'drawIndexed'],
+      [2, 6, 0, 'drawIndirect'],
+      [3, 7, 0, 'drawIndexedIndirect'],
+      [4, 12, 1, 'dispatchWorkgroups'],
+      [5, 13, 1, 'dispatchWorkgroupsIndirect'],
+    ]);
+    expect(model.commands[1]).toMatchObject({
+      eventIndex: 1,
+      passIndex: 0,
+      group: ['render group'],
+    });
+    expect(model.commands[3]).toMatchObject({ eventIndex: 3, marker: 'before draws' });
+    expect(model.passes.map((pass) => pass.workIndices)).toEqual([
+      [0, 1, 2, 3],
+      [4, 5],
+    ]);
+    expect(model.resources).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ resourceId: 'buffer-1', kind: 'buffer' }),
+        expect.objectContaining({ resourceId: 'shader:1', kind: 'shader-module' }),
+      ]),
+    );
+    expect(model.works.every((work) => work.eventIndex >= 0 && work.passIndex >= 0)).toBe(true);
+  });
+
+  it('fails closed instead of exposing empty legacy projections or Map values', () => {
+    const model = buildFrameModel(makeTape()) as unknown as Record<string, unknown>;
+    for (const field of ['tree', 'draws', 'meta']) {
+      expect(model, `legacy field ${field} must be absent`).not.toHaveProperty(field);
+    }
+    expect(model).not.toHaveProperty('totalDraws');
+    expect(model.resources).toBeInstanceOf(Array);
+    expect(JSON.stringify(model)).not.toContain('ReadonlyMap');
+  });
+
+  it('resolves pipeline, shader, and bind-group facts from the bootstrap closure', () => {
     const tape: Tape = {
-      header: { formatVersion: 7, rhiCaps: {}, eventCount: 2, blobCount: 0 },
-      bootstrap: [],
+      header: { formatVersion: 7, rhiCaps: {}, eventCount: 5, blobCount: 0 },
+      bootstrap: [
+        {
+          handleId: 'texture:sample',
+          kind: 'texture',
+          create: {
+            kind: 'createTexture',
+            handleId: 'texture:sample',
+            desc: { size: [2, 2, 1], format: 'rgba8unorm', usage: 4 },
+          },
+          initialData: [],
+        },
+        {
+          handleId: 'view:sample',
+          kind: 'texture-view',
+          create: {
+            kind: 'createTextureView',
+            sourceHandleId: 'texture:sample',
+            resultHandleId: 'view:sample',
+            desc: {},
+          },
+          initialData: [],
+        },
+        {
+          handleId: 'shader:vertex',
+          kind: 'shader-module',
+          create: {
+            kind: 'createShaderModule',
+            handleId: 'shader:vertex',
+            wgslCode: '@vertex fn main() -> @builtin(position) vec4f { return vec4f(); }',
+          },
+          initialData: [],
+        },
+        {
+          handleId: 'shader:fragment',
+          kind: 'shader-module',
+          create: {
+            kind: 'createShaderModule',
+            handleId: 'shader:fragment',
+            wgslCode: '@fragment fn main() -> @location(0) vec4f { return vec4f(1.0); }',
+          },
+          initialData: [],
+        },
+        {
+          handleId: 'bgl:main',
+          kind: 'binding',
+          create: {
+            kind: 'createBindGroupLayout',
+            handleId: 'bgl:main',
+            desc: { entries: [] },
+          },
+          initialData: [],
+        },
+        {
+          handleId: 'bindGroup:main',
+          kind: 'binding',
+          create: {
+            kind: 'createBindGroup',
+            handleId: 'bindGroup:main',
+            layoutHandleId: 'bgl:main',
+            entries: [{ binding: 3, resourceKind: 'textureView' }],
+            resourceHandleIds: ['view:sample'],
+          },
+          initialData: [],
+        },
+        {
+          handleId: 'pipelineLayout:main',
+          kind: 'binding',
+          create: {
+            kind: 'createPipelineLayout',
+            handleId: 'pipelineLayout:main',
+            bglHandleIds: ['bgl:main'],
+          },
+          initialData: [],
+        },
+        {
+          handleId: 'pipeline:main',
+          kind: 'pipeline',
+          create: {
+            kind: 'createRenderPipeline',
+            handleId: 'pipeline:main',
+            desc: {
+              vertex: { entryPoint: 'main', buffers: [] },
+              fragment: { entryPoint: 'main', targets: [{ format: 'rgba8unorm' }] },
+            },
+            layoutHandleId: 'pipelineLayout:main',
+            vertexShaderModuleHandleId: 'shader:vertex',
+            fragmentShaderModuleHandleId: 'shader:fragment',
+          },
+          initialData: [],
+        },
+      ],
       events: [
         {
           kind: 'beginRenderPass',
-          passHandleId: 'pass:1',
-          cmdHandleId: 'cmd:1',
+          passHandleId: 'pass:render',
+          cmdHandleId: 'encoder:1',
           desc: { colorAttachments: [] },
-          colorAttachmentViewHandleIds: [],
+          colorAttachmentViewHandleIds: ['view:sample'],
+        },
+        {
+          kind: 'setPipeline',
+          passHandleId: 'pass:render',
+          pipelineHandleId: 'pipeline:main',
+        },
+        {
+          kind: 'setBindGroup',
+          passHandleId: 'pass:render',
+          index: 0,
+          bindGroupHandleId: 'bindGroup:main',
         },
         {
           kind: 'draw',
-          passHandleId: 'pass:1',
+          passHandleId: 'pass:render',
           vertexCount: 3,
           instanceCount: 1,
           firstVertex: 0,
           firstInstance: 0,
         },
+        { kind: 'endRenderPass', passHandleId: 'pass:render' },
       ],
       blobs: [],
     };
-    const model = buildFrameModel(tape);
-    expect(model.works[0]).toMatchObject({
-      workIndex: 0,
-      eventIndex: 1,
-      passIndex: 0,
-      kind: 'draw',
+
+    const work = buildFrameModel(tape).works[0];
+    expect(work?.pipeline).toMatchObject({
+      status: 'available',
+      pipelineHandleId: 'pipeline:main',
     });
-    expect(JSON.stringify(model)).not.toContain('Map');
+    expect(work?.pipeline.shaders.map((shader) => shader.moduleHandleId)).toEqual([
+      'shader:vertex',
+      'shader:fragment',
+    ]);
+    expect(work?.bindings).toEqual([
+      expect.objectContaining({
+        groupIndex: 0,
+        binding: 3,
+        bindGroupId: 'bindGroup:main',
+        resourceId: 'view:sample',
+        resourceKind: 'textureView',
+      }),
+    ]);
   });
 });