Recording verify guards | Doc Detective

Structural assertions on the produced video file, evaluated when the recording stops. Unlike checkpoint drift (a WARNING), a violated guard FAILs the stopRecord step — these are properties you explicitly demand of the artifact.

Referenced In

Record (detailed)

Fields

Field	Type	Description	Default
minDuration	number	Optional. Fail if the video is shorter than this many seconds. Minimum: 0	—
maxDuration	number	Optional. Fail if the video is longer than this many seconds. Minimum: 0	—
resolution	one of: - boolean - object(Verify resolution (detailed))	Optional. Verify the video’s dimensions (±2 pixels — encoders round to even dimensions). `true` compares against the capture plan’s resolved expectation (the crop rectangle when a window/viewport crop applied, else the capture frame size; skipped when no expectation exists for the engine). An object compares literal dimensions.	—
notBlack	boolean	Optional. Fail if the video is essentially all black (black frames cover 95% or more of its duration) — the classic symptom of a broken screen capture.	—

Examples

{
  "minDuration": 42,
  "maxDuration": 42,
  "resolution": true,
  "notBlack": true
}