docs(lab): freeze M4.8 viewer and regression canon

2026-08-24 22:38:54 +03:00
parent 4fa1669ab7
commit eb416ff80a
4 changed files with 293 additions and 15 deletions
@@ -185,6 +185,29 @@ The evidence slot has two admitted renderers:
 - `diagnostic-model` — a specialized visual result such as the LAB E28 L2.6
  surface/timeline/review viewer.

+Recorded camera clips used for review are a frozen sub-contract of the admitted
+viewer, `missioncore.laboratory-recorded-clip-viewer/v1`, implemented by
+`LaboratoryRecordedClipPlayer`. It owns the generation-bound fMP4 manifest,
+bounded MediaSource buffering, source-time playback clock, clip looping and the
+canonical timeline. A LAB may provide typed overlays and an alternative spatial
+scene, but it may not implement its own frame timer, per-frame JPEG playback,
+media cache, port, Rerun blueprint or loading grammar. Exact JPEG remains a
+paused-frame/fallback evidence endpoint, never the continuous playback transport.
+Forward frame progression may roll an already-buffered segment target; a
+backward seek or clip loop must perform an explicit decoder seek and remain
+decoder-ready without exposing a per-frame loader.
+
+When recorded camera and frame-indexed spatial evidence are both required for
+one review question, the shared player presents them simultaneously on the same
+media clock. The camera remains the clock owner; a bounded experiment-neutral
+spatial cache prefetches exact source sequences, including across the loop
+boundary. Mode switching changes presentation only. It must not pause the clock,
+hide the companion camera, create another transport, or flash a full-stage
+loader between spatial frames. Connected M4.8 workflows project CAMERA, 3D and
+PLAN through the same left-side vertical glass rail of canonical circular
+actions; the report, assisted correction and formal review flows do not invent
+separate mode-control geometry.
+
 An admitted diagnostic viewer may own the result interaction internally when
 the evidence itself is the review/result instrument, as in E28 and E30. This is
 not permission to omit the result from a new ordinary LAB report. New bounded