Happy review

api/openapi.yaml

@@ -1015,13 +1015,14 @@ components:
         id: { type: string }
         task_id: { type: string }
         snapshot_n: { type: integer }
-        agent_session_id: { type: string, description: The reviewer's session. }
-        vendor: { type: string }
-        model: { type: string }
+        agent_session_id: { type: string, description: "The reviewer's session; empty when skipped." }
+        vendor: { type: string, description: "Empty when skipped." }
+        model: { type: string, description: "Empty when skipped." }
         state:
           type: string
-          enum: [running, done, failed]
-          x-enum-varnames: [ReviewStateRunning, ReviewStateDone, ReviewStateFailed]
+          enum: [running, done, failed, skipped]
+          x-enum-varnames: [ReviewStateRunning, ReviewStateDone, ReviewStateFailed, ReviewStateSkipped]
+          description: "skipped: the snapshot's step changed no files, so no reviewer ran."
         result: { type: object, description: "done: the reviewer's submit_review arguments: summary (Markdown) and findings, each with severity, category, title, detail, path and line." }
         error: { type: string, description: "failed: why." }
         created_at: { type: string, format: date-time }