From ebf3312fe7f049d509bbcb2b624ac860799dab75 Mon Sep 17 00:00:00 2001 From: Xiangzhe Date: Tue, 18 Aug 2026 02:08:34 -0300 Subject: [PATCH] docs(video): document timestamped contact sheets --- docs/security/GUARDRAILS.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/security/GUARDRAILS.md b/docs/security/GUARDRAILS.md index ba1418312b..cd1699a65b 100644 --- a/docs/security/GUARDRAILS.md +++ b/docs/security/GUARDRAILS.md @@ -331,6 +331,12 @@ compared only with the last frame retained. The first and final timeline frames are always retained; comparator or decoder errors fail open and keep coverage. The output metadata reports how many frames were dropped. +An explicitly marked video part may request a timestamped contact sheet. The +bridge builds at most a 4-column, 16-frame JPEG grid and labels the resulting +observation with every source timestamp. If `sharp` cannot decode or compose +the grid, the bridge falls back to the individual JPEG frames; a client abort +still propagates through the sheet operation. + Callers may attach an optional `transcript.cues` array to a supported video part when they already possess aligned text. Each cue must carry `text`, a finite `start`/`end` interval inside the probed duration, and a whitelisted