doc-detective 4.33.0 → 4.34.0

package/dist/common/src/schemas/schemas.json

@@ -34523,6 +34523,56 @@
                                                             }
                                                           ]
                                                         },
+                                                        "verify": {
+                                                          "title": "Recording verify guards",
+                                                          "description": "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.",
+                                                          "type": "object",
+                                                          "additionalProperties": false,
+                                                          "properties": {
+                                                            "minDuration": {
+                                                              "type": "number",
+                                                              "description": "Fail if the video is shorter than this many seconds.",
+                                                              "minimum": 0
+                                                            },
+                                                            "maxDuration": {
+                                                              "type": "number",
+                                                              "description": "Fail if the video is longer than this many seconds.",
+                                                              "minimum": 0
+                                                            },
+                                                            "resolution": {
+                                                              "description": "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.",
+                                                              "anyOf": [
+                                                                {
+                                                                  "type": "boolean",
+                                                                  "title": "Verify resolution (boolean)"
+                                                                },
+                                                                {
+                                                                  "type": "object",
+                                                                  "title": "Verify resolution (detailed)",
+                                                                  "additionalProperties": false,
+                                                                  "required": [
+                                                                    "width",
+                                                                    "height"
+                                                                  ],
+                                                                  "properties": {
+                                                                    "width": {
+                                                                      "type": "integer",
+                                                                      "minimum": 1
+                                                                    },
+                                                                    "height": {
+                                                                      "type": "integer",
+                                                                      "minimum": 1
+                                                                    }
+                                                                  }
+                                                                }
+                                                              ]
+                                                            },
+                                                            "notBlack": {
+                                                              "type": "boolean",
+                                                              "description": "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."
+                                                            }
+                                                          }
+                                                        },
                                                         "checkpoints": {
                                                           "title": "Recording checkpoints",
                                                           "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -34878,6 +34928,56 @@
                                                               }
                                                             ]
                                                           },
+                                                          "verify": {
+                                                            "title": "Recording verify guards",
+                                                            "description": "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.",
+                                                            "type": "object",
+                                                            "additionalProperties": false,
+                                                            "properties": {
+                                                              "minDuration": {
+                                                                "type": "number",
+                                                                "description": "Fail if the video is shorter than this many seconds.",
+                                                                "minimum": 0
+                                                              },
+                                                              "maxDuration": {
+                                                                "type": "number",
+                                                                "description": "Fail if the video is longer than this many seconds.",
+                                                                "minimum": 0
+                                                              },
+                                                              "resolution": {
+                                                                "description": "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.",
+                                                                "anyOf": [
+                                                                  {
+                                                                    "type": "boolean",
+                                                                    "title": "Verify resolution (boolean)"
+                                                                  },
+                                                                  {
+                                                                    "type": "object",
+                                                                    "title": "Verify resolution (detailed)",
+                                                                    "additionalProperties": false,
+                                                                    "required": [
+                                                                      "width",
+                                                                      "height"
+                                                                    ],
+                                                                    "properties": {
+                                                                      "width": {
+                                                                        "type": "integer",
+                                                                        "minimum": 1
+                                                                      },
+                                                                      "height": {
+                                                                        "type": "integer",
+                                                                        "minimum": 1
+                                                                      }
+                                                                    }
+                                                                  }
+                                                                ]
+                                                              },
+                                                              "notBlack": {
+                                                                "type": "boolean",
+                                                                "description": "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."
+                                                              }
+                                                            }
+                                                          },
                                                           "checkpoints": {
                                                             "title": "Recording checkpoints",
                                                             "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -80245,6 +80345,56 @@
                                               }
                                             ]
                                           },
+                                          "verify": {
+                                            "title": "Recording verify guards",
+                                            "description": "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.",
+                                            "type": "object",
+                                            "additionalProperties": false,
+                                            "properties": {
+                                              "minDuration": {
+                                                "type": "number",
+                                                "description": "Fail if the video is shorter than this many seconds.",
+                                                "minimum": 0
+                                              },
+                                              "maxDuration": {
+                                                "type": "number",
+                                                "description": "Fail if the video is longer than this many seconds.",
+                                                "minimum": 0
+                                              },
+                                              "resolution": {
+                                                "description": "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.",
+                                                "anyOf": [
+                                                  {
+                                                    "type": "boolean",
+                                                    "title": "Verify resolution (boolean)"
+                                                  },
+                                                  {
+                                                    "type": "object",
+                                                    "title": "Verify resolution (detailed)",
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                      "width",
+                                                      "height"
+                                                    ],
+                                                    "properties": {
+                                                      "width": {
+                                                        "type": "integer",
+                                                        "minimum": 1
+                                                      },
+                                                      "height": {
+                                                        "type": "integer",
+                                                        "minimum": 1
+                                                      }
+                                                    }
+                                                  }
+                                                ]
+                                              },
+                                              "notBlack": {
+                                                "type": "boolean",
+                                                "description": "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."
+                                              }
+                                            }
+                                          },
                                           "checkpoints": {
                                             "title": "Recording checkpoints",
                                             "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -80600,6 +80750,56 @@
                                                 }
                                               ]
                                             },
+                                            "verify": {
+                                              "title": "Recording verify guards",
+                                              "description": "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.",
+                                              "type": "object",
+                                              "additionalProperties": false,
+                                              "properties": {
+                                                "minDuration": {
+                                                  "type": "number",
+                                                  "description": "Fail if the video is shorter than this many seconds.",
+                                                  "minimum": 0
+                                                },
+                                                "maxDuration": {
+                                                  "type": "number",
+                                                  "description": "Fail if the video is longer than this many seconds.",
+                                                  "minimum": 0
+                                                },
+                                                "resolution": {
+                                                  "description": "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.",
+                                                  "anyOf": [
+                                                    {
+                                                      "type": "boolean",
+                                                      "title": "Verify resolution (boolean)"
+                                                    },
+                                                    {
+                                                      "type": "object",
+                                                      "title": "Verify resolution (detailed)",
+                                                      "additionalProperties": false,
+                                                      "required": [
+                                                        "width",
+                                                        "height"
+                                                      ],
+                                                      "properties": {
+                                                        "width": {
+                                                          "type": "integer",
+                                                          "minimum": 1
+                                                        },
+                                                        "height": {
+                                                          "type": "integer",
+                                                          "minimum": 1
+                                                        }
+                                                      }
+                                                    }
+                                                  ]
+                                                },
+                                                "notBlack": {
+                                                  "type": "boolean",
+                                                  "description": "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."
+                                                }
+                                              }
+                                            },
                                             "checkpoints": {
                                               "title": "Recording checkpoints",
                                               "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -106607,6 +106807,56 @@
               }
             ]
           },
+          "verify": {
+            "title": "Recording verify guards",
+            "description": "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.",
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "minDuration": {
+                "type": "number",
+                "description": "Fail if the video is shorter than this many seconds.",
+                "minimum": 0
+              },
+              "maxDuration": {
+                "type": "number",
+                "description": "Fail if the video is longer than this many seconds.",
+                "minimum": 0
+              },
+              "resolution": {
+                "description": "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.",
+                "anyOf": [
+                  {
+                    "type": "boolean",
+                    "title": "Verify resolution (boolean)"
+                  },
+                  {
+                    "type": "object",
+                    "title": "Verify resolution (detailed)",
+                    "additionalProperties": false,
+                    "required": [
+                      "width",
+                      "height"
+                    ],
+                    "properties": {
+                      "width": {
+                        "type": "integer",
+                        "minimum": 1
+                      },
+                      "height": {
+                        "type": "integer",
+                        "minimum": 1
+                      }
+                    }
+                  }
+                ]
+              },
+              "notBlack": {
+                "type": "boolean",
+                "description": "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."
+              }
+            }
+          },
           "checkpoints": {
             "title": "Recording checkpoints",
             "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -106962,6 +107212,56 @@
                 }
               ]
             },
+            "verify": {
+              "title": "Recording verify guards",
+              "description": "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.",
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "minDuration": {
+                  "type": "number",
+                  "description": "Fail if the video is shorter than this many seconds.",
+                  "minimum": 0
+                },
+                "maxDuration": {
+                  "type": "number",
+                  "description": "Fail if the video is longer than this many seconds.",
+                  "minimum": 0
+                },
+                "resolution": {
+                  "description": "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.",
+                  "anyOf": [
+                    {
+                      "type": "boolean",
+                      "title": "Verify resolution (boolean)"
+                    },
+                    {
+                      "type": "object",
+                      "title": "Verify resolution (detailed)",
+                      "additionalProperties": false,
+                      "required": [
+                        "width",
+                        "height"
+                      ],
+                      "properties": {
+                        "width": {
+                          "type": "integer",
+                          "minimum": 1
+                        },
+                        "height": {
+                          "type": "integer",
+                          "minimum": 1
+                        }
+                      }
+                    }
+                  ]
+                },
+                "notBlack": {
+                  "type": "boolean",
+                  "description": "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."
+                }
+              }
+            },
             "checkpoints": {
               "title": "Recording checkpoints",
               "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -139331,6 +139631,56 @@
                                                                 }
                                                               ]
                                                             },
+                                                            "verify": {
+                                                              "title": "Recording verify guards",
+                                                              "description": "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.",
+                                                              "type": "object",
+                                                              "additionalProperties": false,
+                                                              "properties": {
+                                                                "minDuration": {
+                                                                  "type": "number",
+                                                                  "description": "Fail if the video is shorter than this many seconds.",
+                                                                  "minimum": 0
+                                                                },
+                                                                "maxDuration": {
+                                                                  "type": "number",
+                                                                  "description": "Fail if the video is longer than this many seconds.",
+                                                                  "minimum": 0
+                                                                },
+                                                                "resolution": {
+                                                                  "description": "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.",
+                                                                  "anyOf": [
+                                                                    {
+                                                                      "type": "boolean",
+                                                                      "title": "Verify resolution (boolean)"
+                                                                    },
+                                                                    {
+                                                                      "type": "object",
+                                                                      "title": "Verify resolution (detailed)",
+                                                                      "additionalProperties": false,
+                                                                      "required": [
+                                                                        "width",
+                                                                        "height"
+                                                                      ],
+                                                                      "properties": {
+                                                                        "width": {
+                                                                          "type": "integer",
+                                                                          "minimum": 1
+                                                                        },
+                                                                        "height": {
+                                                                          "type": "integer",
+                                                                          "minimum": 1
+                                                                        }
+                                                                      }
+                                                                    }
+                                                                  ]
+                                                                },
+                                                                "notBlack": {
+                                                                  "type": "boolean",
+                                                                  "description": "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."
+                                                                }
+                                                              }
+                                                            },
                                                             "checkpoints": {
                                                               "title": "Recording checkpoints",
                                                               "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -139686,6 +140036,56 @@
                                                                   }
                                                                 ]
                                                               },
+                                                              "verify": {
+                                                                "title": "Recording verify guards",
+                                                                "description": "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.",
+                                                                "type": "object",
+                                                                "additionalProperties": false,
+                                                                "properties": {
+                                                                  "minDuration": {
+                                                                    "type": "number",
+                                                                    "description": "Fail if the video is shorter than this many seconds.",
+                                                                    "minimum": 0
+                                                                  },
+                                                                  "maxDuration": {
+                                                                    "type": "number",
+                                                                    "description": "Fail if the video is longer than this many seconds.",
+                                                                    "minimum": 0
+                                                                  },
+                                                                  "resolution": {
+                                                                    "description": "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.",
+                                                                    "anyOf": [
+                                                                      {
+                                                                        "type": "boolean",
+                                                                        "title": "Verify resolution (boolean)"
+                                                                      },
+                                                                      {
+                                                                        "type": "object",
+                                                                        "title": "Verify resolution (detailed)",
+                                                                        "additionalProperties": false,
+                                                                        "required": [
+                                                                          "width",
+                                                                          "height"
+                                                                        ],
+                                                                        "properties": {
+                                                                          "width": {
+                                                                            "type": "integer",
+                                                                            "minimum": 1
+                                                                          },
+                                                                          "height": {
+                                                                            "type": "integer",
+                                                                            "minimum": 1
+                                                                          }
+                                                                        }
+                                                                      }
+                                                                    ]
+                                                                  },
+                                                                  "notBlack": {
+                                                                    "type": "boolean",
+                                                                    "description": "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."
+                                                                  }
+                                                                }
+                                                              },
                                                               "checkpoints": {
                                                                 "title": "Recording checkpoints",
                                                                 "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -185053,6 +185453,56 @@
                                                   }
                                                 ]
                                               },
+                                              "verify": {
+                                                "title": "Recording verify guards",
+                                                "description": "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.",
+                                                "type": "object",
+                                                "additionalProperties": false,
+                                                "properties": {
+                                                  "minDuration": {
+                                                    "type": "number",
+                                                    "description": "Fail if the video is shorter than this many seconds.",
+                                                    "minimum": 0
+                                                  },
+                                                  "maxDuration": {
+                                                    "type": "number",
+                                                    "description": "Fail if the video is longer than this many seconds.",
+                                                    "minimum": 0
+                                                  },
+                                                  "resolution": {
+                                                    "description": "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.",
+                                                    "anyOf": [
+                                                      {
+                                                        "type": "boolean",
+                                                        "title": "Verify resolution (boolean)"
+                                                      },
+                                                      {
+                                                        "type": "object",
+                                                        "title": "Verify resolution (detailed)",
+                                                        "additionalProperties": false,
+                                                        "required": [
+                                                          "width",
+                                                          "height"
+                                                        ],
+                                                        "properties": {
+                                                          "width": {
+                                                            "type": "integer",
+                                                            "minimum": 1
+                                                          },
+                                                          "height": {
+                                                            "type": "integer",
+                                                            "minimum": 1
+                                                          }
+                                                        }
+                                                      }
+                                                    ]
+                                                  },
+                                                  "notBlack": {
+                                                    "type": "boolean",
+                                                    "description": "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."
+                                                  }
+                                                }
+                                              },
                                               "checkpoints": {
                                                 "title": "Recording checkpoints",
                                                 "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -185408,6 +185858,56 @@
                                                     }
                                                   ]
                                                 },
+                                                "verify": {
+                                                  "title": "Recording verify guards",
+                                                  "description": "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.",
+                                                  "type": "object",
+                                                  "additionalProperties": false,
+                                                  "properties": {
+                                                    "minDuration": {
+                                                      "type": "number",
+                                                      "description": "Fail if the video is shorter than this many seconds.",
+                                                      "minimum": 0
+                                                    },
+                                                    "maxDuration": {
+                                                      "type": "number",
+                                                      "description": "Fail if the video is longer than this many seconds.",
+                                                      "minimum": 0
+                                                    },
+                                                    "resolution": {
+                                                      "description": "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.",
+                                                      "anyOf": [
+                                                        {
+                                                          "type": "boolean",
+                                                          "title": "Verify resolution (boolean)"
+                                                        },
+                                                        {
+                                                          "type": "object",
+                                                          "title": "Verify resolution (detailed)",
+                                                          "additionalProperties": false,
+                                                          "required": [
+                                                            "width",
+                                                            "height"
+                                                          ],
+                                                          "properties": {
+                                                            "width": {
+                                                              "type": "integer",
+                                                              "minimum": 1
+                                                            },
+                                                            "height": {
+                                                              "type": "integer",
+                                                              "minimum": 1
+                                                            }
+                                                          }
+                                                        }
+                                                      ]
+                                                    },
+                                                    "notBlack": {
+                                                      "type": "boolean",
+                                                      "description": "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."
+                                                    }
+                                                  }
+                                                },
                                                 "checkpoints": {
                                                   "title": "Recording checkpoints",
                                                   "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -232514,6 +233014,56 @@
                                                     }
                                                   ]
                                                 },
+                                                "verify": {
+                                                  "title": "Recording verify guards",
+                                                  "description": "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.",
+                                                  "type": "object",
+                                                  "additionalProperties": false,
+                                                  "properties": {
+                                                    "minDuration": {
+                                                      "type": "number",
+                                                      "description": "Fail if the video is shorter than this many seconds.",
+                                                      "minimum": 0
+                                                    },
+                                                    "maxDuration": {
+                                                      "type": "number",
+                                                      "description": "Fail if the video is longer than this many seconds.",
+                                                      "minimum": 0
+                                                    },
+                                                    "resolution": {
+                                                      "description": "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.",
+                                                      "anyOf": [
+                                                        {
+                                                          "type": "boolean",
+                                                          "title": "Verify resolution (boolean)"
+                                                        },
+                                                        {
+                                                          "type": "object",
+                                                          "title": "Verify resolution (detailed)",
+                                                          "additionalProperties": false,
+                                                          "required": [
+                                                            "width",
+                                                            "height"
+                                                          ],
+                                                          "properties": {
+                                                            "width": {
+                                                              "type": "integer",
+                                                              "minimum": 1
+                                                            },
+                                                            "height": {
+                                                              "type": "integer",
+                                                              "minimum": 1
+                                                            }
+                                                          }
+                                                        }
+                                                      ]
+                                                    },
+                                                    "notBlack": {
+                                                      "type": "boolean",
+                                                      "description": "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."
+                                                    }
+                                                  }
+                                                },
                                                 "checkpoints": {
                                                   "title": "Recording checkpoints",
                                                   "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -232869,6 +233419,56 @@
                                                       }
                                                     ]
                                                   },
+                                                  "verify": {
+                                                    "title": "Recording verify guards",
+                                                    "description": "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.",
+                                                    "type": "object",
+                                                    "additionalProperties": false,
+                                                    "properties": {
+                                                      "minDuration": {
+                                                        "type": "number",
+                                                        "description": "Fail if the video is shorter than this many seconds.",
+                                                        "minimum": 0
+                                                      },
+                                                      "maxDuration": {
+                                                        "type": "number",
+                                                        "description": "Fail if the video is longer than this many seconds.",
+                                                        "minimum": 0
+                                                      },
+                                                      "resolution": {
+                                                        "description": "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.",
+                                                        "anyOf": [
+                                                          {
+                                                            "type": "boolean",
+                                                            "title": "Verify resolution (boolean)"
+                                                          },
+                                                          {
+                                                            "type": "object",
+                                                            "title": "Verify resolution (detailed)",
+                                                            "additionalProperties": false,
+                                                            "required": [
+                                                              "width",
+                                                              "height"
+                                                            ],
+                                                            "properties": {
+                                                              "width": {
+                                                                "type": "integer",
+                                                                "minimum": 1
+                                                              },
+                                                              "height": {
+                                                                "type": "integer",
+                                                                "minimum": 1
+                                                              }
+                                                            }
+                                                          }
+                                                        ]
+                                                      },
+                                                      "notBlack": {
+                                                        "type": "boolean",
+                                                        "description": "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."
+                                                      }
+                                                    }
+                                                  },
                                                   "checkpoints": {
                                                     "title": "Recording checkpoints",
                                                     "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -277498,6 +278098,56 @@
                                                           }
                                                         ]
                                                       },
+                                                      "verify": {
+                                                        "title": "Recording verify guards",
+                                                        "description": "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.",
+                                                        "type": "object",
+                                                        "additionalProperties": false,
+                                                        "properties": {
+                                                          "minDuration": {
+                                                            "type": "number",
+                                                            "description": "Fail if the video is shorter than this many seconds.",
+                                                            "minimum": 0
+                                                          },
+                                                          "maxDuration": {
+                                                            "type": "number",
+                                                            "description": "Fail if the video is longer than this many seconds.",
+                                                            "minimum": 0
+                                                          },
+                                                          "resolution": {
+                                                            "description": "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.",
+                                                            "anyOf": [
+                                                              {
+                                                                "type": "boolean",
+                                                                "title": "Verify resolution (boolean)"
+                                                              },
+                                                              {
+                                                                "type": "object",
+                                                                "title": "Verify resolution (detailed)",
+                                                                "additionalProperties": false,
+                                                                "required": [
+                                                                  "width",
+                                                                  "height"
+                                                                ],
+                                                                "properties": {
+                                                                  "width": {
+                                                                    "type": "integer",
+                                                                    "minimum": 1
+                                                                  },
+                                                                  "height": {
+                                                                    "type": "integer",
+                                                                    "minimum": 1
+                                                                  }
+                                                                }
+                                                              }
+                                                            ]
+                                                          },
+                                                          "notBlack": {
+                                                            "type": "boolean",
+                                                            "description": "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."
+                                                          }
+                                                        }
+                                                      },
                                                       "checkpoints": {
                                                         "title": "Recording checkpoints",
                                                         "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -277853,6 +278503,56 @@
                                                             }
                                                           ]
                                                         },
+                                                        "verify": {
+                                                          "title": "Recording verify guards",
+                                                          "description": "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.",
+                                                          "type": "object",
+                                                          "additionalProperties": false,
+                                                          "properties": {
+                                                            "minDuration": {
+                                                              "type": "number",
+                                                              "description": "Fail if the video is shorter than this many seconds.",
+                                                              "minimum": 0
+                                                            },
+                                                            "maxDuration": {
+                                                              "type": "number",
+                                                              "description": "Fail if the video is longer than this many seconds.",
+                                                              "minimum": 0
+                                                            },
+                                                            "resolution": {
+                                                              "description": "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.",
+                                                              "anyOf": [
+                                                                {
+                                                                  "type": "boolean",
+                                                                  "title": "Verify resolution (boolean)"
+                                                                },
+                                                                {
+                                                                  "type": "object",
+                                                                  "title": "Verify resolution (detailed)",
+                                                                  "additionalProperties": false,
+                                                                  "required": [
+                                                                    "width",
+                                                                    "height"
+                                                                  ],
+                                                                  "properties": {
+                                                                    "width": {
+                                                                      "type": "integer",
+                                                                      "minimum": 1
+                                                                    },
+                                                                    "height": {
+                                                                      "type": "integer",
+                                                                      "minimum": 1
+                                                                    }
+                                                                  }
+                                                                }
+                                                              ]
+                                                            },
+                                                            "notBlack": {
+                                                              "type": "boolean",
+                                                              "description": "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."
+                                                            }
+                                                          }
+                                                        },
                                                         "checkpoints": {
                                                           "title": "Recording checkpoints",
                                                           "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -325443,6 +326143,56 @@
                                                     }
                                                   ]
                                                 },
+                                                "verify": {
+                                                  "title": "Recording verify guards",
+                                                  "description": "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.",
+                                                  "type": "object",
+                                                  "additionalProperties": false,
+                                                  "properties": {
+                                                    "minDuration": {
+                                                      "type": "number",
+                                                      "description": "Fail if the video is shorter than this many seconds.",
+                                                      "minimum": 0
+                                                    },
+                                                    "maxDuration": {
+                                                      "type": "number",
+                                                      "description": "Fail if the video is longer than this many seconds.",
+                                                      "minimum": 0
+                                                    },
+                                                    "resolution": {
+                                                      "description": "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.",
+                                                      "anyOf": [
+                                                        {
+                                                          "type": "boolean",
+                                                          "title": "Verify resolution (boolean)"
+                                                        },
+                                                        {
+                                                          "type": "object",
+                                                          "title": "Verify resolution (detailed)",
+                                                          "additionalProperties": false,
+                                                          "required": [
+                                                            "width",
+                                                            "height"
+                                                          ],
+                                                          "properties": {
+                                                            "width": {
+                                                              "type": "integer",
+                                                              "minimum": 1
+                                                            },
+                                                            "height": {
+                                                              "type": "integer",
+                                                              "minimum": 1
+                                                            }
+                                                          }
+                                                        }
+                                                      ]
+                                                    },
+                                                    "notBlack": {
+                                                      "type": "boolean",
+                                                      "description": "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."
+                                                    }
+                                                  }
+                                                },
                                                 "checkpoints": {
                                                   "title": "Recording checkpoints",
                                                   "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -325798,6 +326548,56 @@
                                                       }
                                                     ]
                                                   },
+                                                  "verify": {
+                                                    "title": "Recording verify guards",
+                                                    "description": "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.",
+                                                    "type": "object",
+                                                    "additionalProperties": false,
+                                                    "properties": {
+                                                      "minDuration": {
+                                                        "type": "number",
+                                                        "description": "Fail if the video is shorter than this many seconds.",
+                                                        "minimum": 0
+                                                      },
+                                                      "maxDuration": {
+                                                        "type": "number",
+                                                        "description": "Fail if the video is longer than this many seconds.",
+                                                        "minimum": 0
+                                                      },
+                                                      "resolution": {
+                                                        "description": "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.",
+                                                        "anyOf": [
+                                                          {
+                                                            "type": "boolean",
+                                                            "title": "Verify resolution (boolean)"
+                                                          },
+                                                          {
+                                                            "type": "object",
+                                                            "title": "Verify resolution (detailed)",
+                                                            "additionalProperties": false,
+                                                            "required": [
+                                                              "width",
+                                                              "height"
+                                                            ],
+                                                            "properties": {
+                                                              "width": {
+                                                                "type": "integer",
+                                                                "minimum": 1
+                                                              },
+                                                              "height": {
+                                                                "type": "integer",
+                                                                "minimum": 1
+                                                              }
+                                                            }
+                                                          }
+                                                        ]
+                                                      },
+                                                      "notBlack": {
+                                                        "type": "boolean",
+                                                        "description": "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."
+                                                      }
+                                                    }
+                                                  },
                                                   "checkpoints": {
                                                     "title": "Recording checkpoints",
                                                     "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -370427,6 +371227,56 @@
                                                           }
                                                         ]
                                                       },
+                                                      "verify": {
+                                                        "title": "Recording verify guards",
+                                                        "description": "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.",
+                                                        "type": "object",
+                                                        "additionalProperties": false,
+                                                        "properties": {
+                                                          "minDuration": {
+                                                            "type": "number",
+                                                            "description": "Fail if the video is shorter than this many seconds.",
+                                                            "minimum": 0
+                                                          },
+                                                          "maxDuration": {
+                                                            "type": "number",
+                                                            "description": "Fail if the video is longer than this many seconds.",
+                                                            "minimum": 0
+                                                          },
+                                                          "resolution": {
+                                                            "description": "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.",
+                                                            "anyOf": [
+                                                              {
+                                                                "type": "boolean",
+                                                                "title": "Verify resolution (boolean)"
+                                                              },
+                                                              {
+                                                                "type": "object",
+                                                                "title": "Verify resolution (detailed)",
+                                                                "additionalProperties": false,
+                                                                "required": [
+                                                                  "width",
+                                                                  "height"
+                                                                ],
+                                                                "properties": {
+                                                                  "width": {
+                                                                    "type": "integer",
+                                                                    "minimum": 1
+                                                                  },
+                                                                  "height": {
+                                                                    "type": "integer",
+                                                                    "minimum": 1
+                                                                  }
+                                                                }
+                                                              }
+                                                            ]
+                                                          },
+                                                          "notBlack": {
+                                                            "type": "boolean",
+                                                            "description": "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."
+                                                          }
+                                                        }
+                                                      },
                                                       "checkpoints": {
                                                         "title": "Recording checkpoints",
                                                         "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -370782,6 +371632,56 @@
                                                             }
                                                           ]
                                                         },
+                                                        "verify": {
+                                                          "title": "Recording verify guards",
+                                                          "description": "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.",
+                                                          "type": "object",
+                                                          "additionalProperties": false,
+                                                          "properties": {
+                                                            "minDuration": {
+                                                              "type": "number",
+                                                              "description": "Fail if the video is shorter than this many seconds.",
+                                                              "minimum": 0
+                                                            },
+                                                            "maxDuration": {
+                                                              "type": "number",
+                                                              "description": "Fail if the video is longer than this many seconds.",
+                                                              "minimum": 0
+                                                            },
+                                                            "resolution": {
+                                                              "description": "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.",
+                                                              "anyOf": [
+                                                                {
+                                                                  "type": "boolean",
+                                                                  "title": "Verify resolution (boolean)"
+                                                                },
+                                                                {
+                                                                  "type": "object",
+                                                                  "title": "Verify resolution (detailed)",
+                                                                  "additionalProperties": false,
+                                                                  "required": [
+                                                                    "width",
+                                                                    "height"
+                                                                  ],
+                                                                  "properties": {
+                                                                    "width": {
+                                                                      "type": "integer",
+                                                                      "minimum": 1
+                                                                    },
+                                                                    "height": {
+                                                                      "type": "integer",
+                                                                      "minimum": 1
+                                                                    }
+                                                                  }
+                                                                }
+                                                              ]
+                                                            },
+                                                            "notBlack": {
+                                                              "type": "boolean",
+                                                              "description": "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."
+                                                            }
+                                                          }
+                                                        },
                                                         "checkpoints": {
                                                           "title": "Recording checkpoints",
                                                           "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -421702,6 +422602,56 @@
                                           }
                                         ]
                                       },
+                                      "verify": {
+                                        "title": "Recording verify guards",
+                                        "description": "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.",
+                                        "type": "object",
+                                        "additionalProperties": false,
+                                        "properties": {
+                                          "minDuration": {
+                                            "type": "number",
+                                            "description": "Fail if the video is shorter than this many seconds.",
+                                            "minimum": 0
+                                          },
+                                          "maxDuration": {
+                                            "type": "number",
+                                            "description": "Fail if the video is longer than this many seconds.",
+                                            "minimum": 0
+                                          },
+                                          "resolution": {
+                                            "description": "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.",
+                                            "anyOf": [
+                                              {
+                                                "type": "boolean",
+                                                "title": "Verify resolution (boolean)"
+                                              },
+                                              {
+                                                "type": "object",
+                                                "title": "Verify resolution (detailed)",
+                                                "additionalProperties": false,
+                                                "required": [
+                                                  "width",
+                                                  "height"
+                                                ],
+                                                "properties": {
+                                                  "width": {
+                                                    "type": "integer",
+                                                    "minimum": 1
+                                                  },
+                                                  "height": {
+                                                    "type": "integer",
+                                                    "minimum": 1
+                                                  }
+                                                }
+                                              }
+                                            ]
+                                          },
+                                          "notBlack": {
+                                            "type": "boolean",
+                                            "description": "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."
+                                          }
+                                        }
+                                      },
                                       "checkpoints": {
                                         "title": "Recording checkpoints",
                                         "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -422057,6 +423007,56 @@
                                             }
                                           ]
                                         },
+                                        "verify": {
+                                          "title": "Recording verify guards",
+                                          "description": "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.",
+                                          "type": "object",
+                                          "additionalProperties": false,
+                                          "properties": {
+                                            "minDuration": {
+                                              "type": "number",
+                                              "description": "Fail if the video is shorter than this many seconds.",
+                                              "minimum": 0
+                                            },
+                                            "maxDuration": {
+                                              "type": "number",
+                                              "description": "Fail if the video is longer than this many seconds.",
+                                              "minimum": 0
+                                            },
+                                            "resolution": {
+                                              "description": "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.",
+                                              "anyOf": [
+                                                {
+                                                  "type": "boolean",
+                                                  "title": "Verify resolution (boolean)"
+                                                },
+                                                {
+                                                  "type": "object",
+                                                  "title": "Verify resolution (detailed)",
+                                                  "additionalProperties": false,
+                                                  "required": [
+                                                    "width",
+                                                    "height"
+                                                  ],
+                                                  "properties": {
+                                                    "width": {
+                                                      "type": "integer",
+                                                      "minimum": 1
+                                                    },
+                                                    "height": {
+                                                      "type": "integer",
+                                                      "minimum": 1
+                                                    }
+                                                  }
+                                                }
+                                              ]
+                                            },
+                                            "notBlack": {
+                                              "type": "boolean",
+                                              "description": "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."
+                                            }
+                                          }
+                                        },
                                         "checkpoints": {
                                           "title": "Recording checkpoints",
                                           "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -466686,6 +467686,56 @@
                                                 }
                                               ]
                                             },
+                                            "verify": {
+                                              "title": "Recording verify guards",
+                                              "description": "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.",
+                                              "type": "object",
+                                              "additionalProperties": false,
+                                              "properties": {
+                                                "minDuration": {
+                                                  "type": "number",
+                                                  "description": "Fail if the video is shorter than this many seconds.",
+                                                  "minimum": 0
+                                                },
+                                                "maxDuration": {
+                                                  "type": "number",
+                                                  "description": "Fail if the video is longer than this many seconds.",
+                                                  "minimum": 0
+                                                },
+                                                "resolution": {
+                                                  "description": "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.",
+                                                  "anyOf": [
+                                                    {
+                                                      "type": "boolean",
+                                                      "title": "Verify resolution (boolean)"
+                                                    },
+                                                    {
+                                                      "type": "object",
+                                                      "title": "Verify resolution (detailed)",
+                                                      "additionalProperties": false,
+                                                      "required": [
+                                                        "width",
+                                                        "height"
+                                                      ],
+                                                      "properties": {
+                                                        "width": {
+                                                          "type": "integer",
+                                                          "minimum": 1
+                                                        },
+                                                        "height": {
+                                                          "type": "integer",
+                                                          "minimum": 1
+                                                        }
+                                                      }
+                                                    }
+                                                  ]
+                                                },
+                                                "notBlack": {
+                                                  "type": "boolean",
+                                                  "description": "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."
+                                                }
+                                              }
+                                            },
                                             "checkpoints": {
                                               "title": "Recording checkpoints",
                                               "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -467041,6 +468091,56 @@
                                                   }
                                                 ]
                                               },
+                                              "verify": {
+                                                "title": "Recording verify guards",
+                                                "description": "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.",
+                                                "type": "object",
+                                                "additionalProperties": false,
+                                                "properties": {
+                                                  "minDuration": {
+                                                    "type": "number",
+                                                    "description": "Fail if the video is shorter than this many seconds.",
+                                                    "minimum": 0
+                                                  },
+                                                  "maxDuration": {
+                                                    "type": "number",
+                                                    "description": "Fail if the video is longer than this many seconds.",
+                                                    "minimum": 0
+                                                  },
+                                                  "resolution": {
+                                                    "description": "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.",
+                                                    "anyOf": [
+                                                      {
+                                                        "type": "boolean",
+                                                        "title": "Verify resolution (boolean)"
+                                                      },
+                                                      {
+                                                        "type": "object",
+                                                        "title": "Verify resolution (detailed)",
+                                                        "additionalProperties": false,
+                                                        "required": [
+                                                          "width",
+                                                          "height"
+                                                        ],
+                                                        "properties": {
+                                                          "width": {
+                                                            "type": "integer",
+                                                            "minimum": 1
+                                                          },
+                                                          "height": {
+                                                            "type": "integer",
+                                                            "minimum": 1
+                                                          }
+                                                        }
+                                                      }
+                                                    ]
+                                                  },
+                                                  "notBlack": {
+                                                    "type": "boolean",
+                                                    "description": "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."
+                                                  }
+                                                }
+                                              },
                                               "checkpoints": {
                                                 "title": "Recording checkpoints",
                                                 "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -513362,6 +514462,56 @@
                           }
                         ]
                       },
+                      "verify": {
+                        "title": "Recording verify guards",
+                        "description": "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.",
+                        "type": "object",
+                        "additionalProperties": false,
+                        "properties": {
+                          "minDuration": {
+                            "type": "number",
+                            "description": "Fail if the video is shorter than this many seconds.",
+                            "minimum": 0
+                          },
+                          "maxDuration": {
+                            "type": "number",
+                            "description": "Fail if the video is longer than this many seconds.",
+                            "minimum": 0
+                          },
+                          "resolution": {
+                            "description": "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.",
+                            "anyOf": [
+                              {
+                                "type": "boolean",
+                                "title": "Verify resolution (boolean)"
+                              },
+                              {
+                                "type": "object",
+                                "title": "Verify resolution (detailed)",
+                                "additionalProperties": false,
+                                "required": [
+                                  "width",
+                                  "height"
+                                ],
+                                "properties": {
+                                  "width": {
+                                    "type": "integer",
+                                    "minimum": 1
+                                  },
+                                  "height": {
+                                    "type": "integer",
+                                    "minimum": 1
+                                  }
+                                }
+                              }
+                            ]
+                          },
+                          "notBlack": {
+                            "type": "boolean",
+                            "description": "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."
+                          }
+                        }
+                      },
                       "checkpoints": {
                         "title": "Recording checkpoints",
                         "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -513717,6 +514867,56 @@
                             }
                           ]
                         },
+                        "verify": {
+                          "title": "Recording verify guards",
+                          "description": "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.",
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "minDuration": {
+                              "type": "number",
+                              "description": "Fail if the video is shorter than this many seconds.",
+                              "minimum": 0
+                            },
+                            "maxDuration": {
+                              "type": "number",
+                              "description": "Fail if the video is longer than this many seconds.",
+                              "minimum": 0
+                            },
+                            "resolution": {
+                              "description": "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.",
+                              "anyOf": [
+                                {
+                                  "type": "boolean",
+                                  "title": "Verify resolution (boolean)"
+                                },
+                                {
+                                  "type": "object",
+                                  "title": "Verify resolution (detailed)",
+                                  "additionalProperties": false,
+                                  "required": [
+                                    "width",
+                                    "height"
+                                  ],
+                                  "properties": {
+                                    "width": {
+                                      "type": "integer",
+                                      "minimum": 1
+                                    },
+                                    "height": {
+                                      "type": "integer",
+                                      "minimum": 1
+                                    }
+                                  }
+                                }
+                              ]
+                            },
+                            "notBlack": {
+                              "type": "boolean",
+                              "description": "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."
+                            }
+                          }
+                        },
                         "checkpoints": {
                           "title": "Recording checkpoints",
                           "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -561691,6 +562891,56 @@
                                 }
                               ]
                             },
+                            "verify": {
+                              "title": "Recording verify guards",
+                              "description": "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.",
+                              "type": "object",
+                              "additionalProperties": false,
+                              "properties": {
+                                "minDuration": {
+                                  "type": "number",
+                                  "description": "Fail if the video is shorter than this many seconds.",
+                                  "minimum": 0
+                                },
+                                "maxDuration": {
+                                  "type": "number",
+                                  "description": "Fail if the video is longer than this many seconds.",
+                                  "minimum": 0
+                                },
+                                "resolution": {
+                                  "description": "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.",
+                                  "anyOf": [
+                                    {
+                                      "type": "boolean",
+                                      "title": "Verify resolution (boolean)"
+                                    },
+                                    {
+                                      "type": "object",
+                                      "title": "Verify resolution (detailed)",
+                                      "additionalProperties": false,
+                                      "required": [
+                                        "width",
+                                        "height"
+                                      ],
+                                      "properties": {
+                                        "width": {
+                                          "type": "integer",
+                                          "minimum": 1
+                                        },
+                                        "height": {
+                                          "type": "integer",
+                                          "minimum": 1
+                                        }
+                                      }
+                                    }
+                                  ]
+                                },
+                                "notBlack": {
+                                  "type": "boolean",
+                                  "description": "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."
+                                }
+                              }
+                            },
                             "checkpoints": {
                               "title": "Recording checkpoints",
                               "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -562046,6 +563296,56 @@
                                   }
                                 ]
                               },
+                              "verify": {
+                                "title": "Recording verify guards",
+                                "description": "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.",
+                                "type": "object",
+                                "additionalProperties": false,
+                                "properties": {
+                                  "minDuration": {
+                                    "type": "number",
+                                    "description": "Fail if the video is shorter than this many seconds.",
+                                    "minimum": 0
+                                  },
+                                  "maxDuration": {
+                                    "type": "number",
+                                    "description": "Fail if the video is longer than this many seconds.",
+                                    "minimum": 0
+                                  },
+                                  "resolution": {
+                                    "description": "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.",
+                                    "anyOf": [
+                                      {
+                                        "type": "boolean",
+                                        "title": "Verify resolution (boolean)"
+                                      },
+                                      {
+                                        "type": "object",
+                                        "title": "Verify resolution (detailed)",
+                                        "additionalProperties": false,
+                                        "required": [
+                                          "width",
+                                          "height"
+                                        ],
+                                        "properties": {
+                                          "width": {
+                                            "type": "integer",
+                                            "minimum": 1
+                                          },
+                                          "height": {
+                                            "type": "integer",
+                                            "minimum": 1
+                                          }
+                                        }
+                                      }
+                                    ]
+                                  },
+                                  "notBlack": {
+                                    "type": "boolean",
+                                    "description": "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."
+                                  }
+                                }
+                              },
                               "checkpoints": {
                                 "title": "Recording checkpoints",
                                 "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -606675,6 +607975,56 @@
                                       }
                                     ]
                                   },
+                                  "verify": {
+                                    "title": "Recording verify guards",
+                                    "description": "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.",
+                                    "type": "object",
+                                    "additionalProperties": false,
+                                    "properties": {
+                                      "minDuration": {
+                                        "type": "number",
+                                        "description": "Fail if the video is shorter than this many seconds.",
+                                        "minimum": 0
+                                      },
+                                      "maxDuration": {
+                                        "type": "number",
+                                        "description": "Fail if the video is longer than this many seconds.",
+                                        "minimum": 0
+                                      },
+                                      "resolution": {
+                                        "description": "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.",
+                                        "anyOf": [
+                                          {
+                                            "type": "boolean",
+                                            "title": "Verify resolution (boolean)"
+                                          },
+                                          {
+                                            "type": "object",
+                                            "title": "Verify resolution (detailed)",
+                                            "additionalProperties": false,
+                                            "required": [
+                                              "width",
+                                              "height"
+                                            ],
+                                            "properties": {
+                                              "width": {
+                                                "type": "integer",
+                                                "minimum": 1
+                                              },
+                                              "height": {
+                                                "type": "integer",
+                                                "minimum": 1
+                                              }
+                                            }
+                                          }
+                                        ]
+                                      },
+                                      "notBlack": {
+                                        "type": "boolean",
+                                        "description": "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."
+                                      }
+                                    }
+                                  },
                                   "checkpoints": {
                                     "title": "Recording checkpoints",
                                     "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",
@@ -607030,6 +608380,56 @@
                                         }
                                       ]
                                     },
+                                    "verify": {
+                                      "title": "Recording verify guards",
+                                      "description": "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.",
+                                      "type": "object",
+                                      "additionalProperties": false,
+                                      "properties": {
+                                        "minDuration": {
+                                          "type": "number",
+                                          "description": "Fail if the video is shorter than this many seconds.",
+                                          "minimum": 0
+                                        },
+                                        "maxDuration": {
+                                          "type": "number",
+                                          "description": "Fail if the video is longer than this many seconds.",
+                                          "minimum": 0
+                                        },
+                                        "resolution": {
+                                          "description": "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.",
+                                          "anyOf": [
+                                            {
+                                              "type": "boolean",
+                                              "title": "Verify resolution (boolean)"
+                                            },
+                                            {
+                                              "type": "object",
+                                              "title": "Verify resolution (detailed)",
+                                              "additionalProperties": false,
+                                              "required": [
+                                                "width",
+                                                "height"
+                                              ],
+                                              "properties": {
+                                                "width": {
+                                                  "type": "integer",
+                                                  "minimum": 1
+                                                },
+                                                "height": {
+                                                  "type": "integer",
+                                                  "minimum": 1
+                                                }
+                                              }
+                                            }
+                                          ]
+                                        },
+                                        "notBlack": {
+                                          "type": "boolean",
+                                          "description": "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."
+                                        }
+                                      }
+                                    },
                                     "checkpoints": {
                                       "title": "Recording checkpoints",
                                       "description": "Capture a checkpoint screenshot after every step while this recording is active and compare each against a persistent baseline stored beside the recording (`<path>.checkpoints/` by default). Baselines seed on the first run; on later runs, per-checkpoint variation is reported in the `stopRecord` step's outputs, and variation beyond `maxVariation` surfaces as a WARNING. If `false` or unset, no checkpoints are captured.",