Skip to content

Audit cooked-scene first-frame publication and retirement guarantees #886

Open

Description

@JeanPhilippeKernel

Context and problem

PR #879 adds transactional cooked-scene publication and resource preparation. M2 issue #873 describes a complete immutable initial frame, prepared GPU resources and pipelines, capacity reserved for publication/results/retirement, bounded cancellation and completion-safe retirement, with no fallible work or blocking GPU waits inside guarded commit. The implementation contains readiness and publication guards, but the full wording of those combined guarantees has not been independently audited end to end. This issue tracks that audit and any concrete gaps; it is not a claim that the existing implementation is broken.

Work

  • Trace candidate preparation through Rendering/Scenes/CookedSceneResourceRequest, GPU mailbox, resource and pipeline readiness, Applications/RuntimeSceneHost/editor scene publication, immutable frame reservation, commit and retirement. Identify the owner and lifetime of each resource and reservation.
  • For every transition, document what is reserved, which calls can fail or wait, which thread executes them, and what happens to the outgoing scene and in-flight GPU resources on cancellation, supersession, failure and device loss.
  • Verify that required textures, environment, materials, meshes, descriptors, pipeline variants and first-frame snapshot are ready and retained at the actual commit boundary. Identify any unbounded first-use work, device-idle operation or main-thread fence wait introduced by loading.
  • Fix demonstrated correctness or boundedness gaps. If a condition is outside the implemented capability profile, state that explicitly and reconcile [Feature] M2: source-independent cooked scene loading and complete first-frame rendering #873 rather than presenting partial coverage as full acceptance.

Acceptance and verification

  • Provide a short traceability matrix from the [Feature] M2: source-independent cooked scene loading and complete first-frame rendering #873 first-frame and lifecycle requirements to code, deterministic tests and any documented exclusions.
  • Exercise missing/failed resource or pipeline preparation, exhausted publication/retirement capacity, cancellation before and after submission, supersession, shutdown and device loss. Check no incomplete candidate is published and the prior scene/generation remains valid when rollback is possible.
  • Confirm GPU resources stay pinned until real completion and no fallible operation or blocking GPU wait occurs inside the guarded commit. Record platform/validation limitations.
  • Coordinate latency and calibrated-memory measurement with Qualify cooked scene performance and resource profile #880; this issue does not replace or silently relax those performance gates.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions