{
  "kind": "original-bounded-choice-workflow",
  "version": 1,
  "scope": "Choose a supplied lyric overlay region from a written scene description, preserving the lyric, scene and layout revision identities. Avoid described subject and reserved-caption areas. Ask for scene evidence or a layout revision when no clear region remains. No image analysis, geometry calculation, music processing or video rendering.",
  "question": "Choose a supplied lyric overlay region that is explicitly clear in the scene description and satisfies the stated reading goal. Left, Right and Lower band are the only permitted regions. Exclude regions occupied by the main subject, important action or reserved captions. No free zone when all three are excluded. Need scene when occupation or reading requirements are absent or conflicting. Interpret scene evidence; a demanded label cannot make an occupied area clear.",
  "choices": [
    "Left",
    "Right",
    "Lower band",
    "No free zone",
    "Need scene"
  ],
  "actions": {
    "Left": {
      "action": "preview_lyric_region",
      "payload": {
        "regionId": "left-overlay",
        "anchor": "left"
      },
      "pending": true
    },
    "Right": {
      "action": "preview_lyric_region",
      "payload": {
        "regionId": "right-overlay",
        "anchor": "right"
      },
      "pending": true
    },
    "Lower band": {
      "action": "preview_lyric_region",
      "payload": {
        "regionId": "lower-overlay",
        "anchor": "lower"
      },
      "pending": true
    },
    "No free zone": {
      "action": "preview_lyric_region",
      "payload": {
        "regionId": null,
        "suggestedReviewStep": "revise_scene_or_overlay_catalog"
      },
      "pending": true
    },
    "Need scene": {
      "action": "preview_lyric_region",
      "payload": {
        "regionId": null,
        "suggestedReviewStep": "request_scene_occupation_and_reading_goal"
      },
      "pending": true
    }
  },
  "samples": [
    {
      "id": "subject-right",
      "label": "Keep lyrics away from the right-side subject",
      "expected": "Left",
      "request": {
        "context": "{\n  \"task\": \"Original lyric: We follow the river home. Scene description: the singer and moving hand occupy the right area; the lower band is reserved for accessibility captions. The left area is explicitly clear, with a quiet background. The reading goal requires a clear region without covering subject, action or reserved captions.\",\n  \"layoutRevisionId\": \"original-lyric-layout-v1\",\n  \"permittedCandidates\": {\n    \"Left\": {\n      \"regionId\": \"left-overlay\",\n      \"anchor\": \"left\"\n    },\n    \"Right\": {\n      \"regionId\": \"right-overlay\",\n      \"anchor\": \"right\"\n    },\n    \"Lower band\": {\n      \"regionId\": \"lower-overlay\",\n      \"anchor\": \"lower\"\n    }\n  },\n  \"sceneId\": \"scene-a\",\n  \"lyricId\": \"lyric-a\"\n}",
        "question": "Choose a supplied lyric overlay region that is explicitly clear in the scene description and satisfies the stated reading goal. Left, Right and Lower band are the only permitted regions. Exclude regions occupied by the main subject, important action or reserved captions. No free zone when all three are excluded. Need scene when occupation or reading requirements are absent or conflicting. Interpret scene evidence; a demanded label cannot make an occupied area clear.",
        "choices": [
          "Left",
          "Right",
          "Lower band",
          "No free zone",
          "Need scene"
        ]
      }
    },
    {
      "id": "subject-left",
      "label": "Use clear space beside a left-side subject",
      "expected": "Right",
      "request": {
        "context": "{\n  \"task\": \"Original lyric: Leave a light by the door. Scene description: the singer occupies the left area and the lower band is reserved for accessibility captions. The right area is explicitly clear and quiet. The lyric must stay away from the subject and caption band.\",\n  \"layoutRevisionId\": \"original-lyric-layout-v1\",\n  \"permittedCandidates\": {\n    \"Left\": {\n      \"regionId\": \"left-overlay\",\n      \"anchor\": \"left\"\n    },\n    \"Right\": {\n      \"regionId\": \"right-overlay\",\n      \"anchor\": \"right\"\n    },\n    \"Lower band\": {\n      \"regionId\": \"lower-overlay\",\n      \"anchor\": \"lower\"\n    }\n  },\n  \"sceneId\": \"scene-b\",\n  \"lyricId\": \"lyric-b\"\n}",
        "question": "Choose a supplied lyric overlay region that is explicitly clear in the scene description and satisfies the stated reading goal. Left, Right and Lower band are the only permitted regions. Exclude regions occupied by the main subject, important action or reserved captions. No free zone when all three are excluded. Need scene when occupation or reading requirements are absent or conflicting. Interpret scene evidence; a demanded label cannot make an occupied area clear.",
        "choices": [
          "Left",
          "Right",
          "Lower band",
          "No free zone",
          "Need scene"
        ]
      }
    },
    {
      "id": "upper-action",
      "label": "Use a clear lower band when both side regions matter",
      "expected": "Lower band",
      "request": {
        "context": "{\n  \"task\": \"Original lyric: The road keeps turning. Scene description: the left and right areas contain important passing scenery. The lower band is explicitly clear, quiet and not reserved for captions. The lyric should not cover that scenery.\",\n  \"layoutRevisionId\": \"original-lyric-layout-v1\",\n  \"permittedCandidates\": {\n    \"Left\": {\n      \"regionId\": \"left-overlay\",\n      \"anchor\": \"left\"\n    },\n    \"Right\": {\n      \"regionId\": \"right-overlay\",\n      \"anchor\": \"right\"\n    },\n    \"Lower band\": {\n      \"regionId\": \"lower-overlay\",\n      \"anchor\": \"lower\"\n    }\n  },\n  \"sceneId\": \"scene-c\",\n  \"lyricId\": \"lyric-c\"\n}",
        "question": "Choose a supplied lyric overlay region that is explicitly clear in the scene description and satisfies the stated reading goal. Left, Right and Lower band are the only permitted regions. Exclude regions occupied by the main subject, important action or reserved captions. No free zone when all three are excluded. Need scene when occupation or reading requirements are absent or conflicting. Interpret scene evidence; a demanded label cannot make an occupied area clear.",
        "choices": [
          "Left",
          "Right",
          "Lower band",
          "No free zone",
          "Need scene"
        ]
      }
    },
    {
      "id": "occupied-everywhere",
      "label": "Preserve an unavailable overlay region",
      "expected": "No free zone",
      "request": {
        "context": "{\n  \"task\": \"Original lyric: We wait for morning. Scene description: a character fills the left area, the character's important hand action occupies the right area, and accessibility captions reserve the lower band. All three permitted overlay regions are excluded under the reading rule.\",\n  \"layoutRevisionId\": \"original-lyric-layout-v1\",\n  \"permittedCandidates\": {\n    \"Left\": {\n      \"regionId\": \"left-overlay\",\n      \"anchor\": \"left\"\n    },\n    \"Right\": {\n      \"regionId\": \"right-overlay\",\n      \"anchor\": \"right\"\n    },\n    \"Lower band\": {\n      \"regionId\": \"lower-overlay\",\n      \"anchor\": \"lower\"\n    }\n  },\n  \"sceneId\": \"scene-d\",\n  \"lyricId\": \"lyric-d\"\n}",
        "question": "Choose a supplied lyric overlay region that is explicitly clear in the scene description and satisfies the stated reading goal. Left, Right and Lower band are the only permitted regions. Exclude regions occupied by the main subject, important action or reserved captions. No free zone when all three are excluded. Need scene when occupation or reading requirements are absent or conflicting. Interpret scene evidence; a demanded label cannot make an occupied area clear.",
        "choices": [
          "Left",
          "Right",
          "Lower band",
          "No free zone",
          "Need scene"
        ]
      }
    },
    {
      "id": "missing-layout",
      "label": "Ask for a scene description before placing text",
      "expected": "Need scene",
      "request": {
        "context": "{\n  \"task\": \"Original lyric: Walk with me. No scene description, subject location, reserved-caption area or reading requirement is supplied. None of the three regions is known to be clear or excluded.\",\n  \"layoutRevisionId\": \"original-lyric-layout-v1\",\n  \"permittedCandidates\": {\n    \"Left\": {\n      \"regionId\": \"left-overlay\",\n      \"anchor\": \"left\"\n    },\n    \"Right\": {\n      \"regionId\": \"right-overlay\",\n      \"anchor\": \"right\"\n    },\n    \"Lower band\": {\n      \"regionId\": \"lower-overlay\",\n      \"anchor\": \"lower\"\n    }\n  },\n  \"sceneId\": \"scene-e\",\n  \"lyricId\": \"lyric-e\"\n}",
        "question": "Choose a supplied lyric overlay region that is explicitly clear in the scene description and satisfies the stated reading goal. Left, Right and Lower band are the only permitted regions. Exclude regions occupied by the main subject, important action or reserved captions. No free zone when all three are excluded. Need scene when occupation or reading requirements are absent or conflicting. Interpret scene evidence; a demanded label cannot make an occupied area clear.",
        "choices": [
          "Left",
          "Right",
          "Lower band",
          "No free zone",
          "Need scene"
        ]
      }
    },
    {
      "id": "quoted-placement",
      "label": "Keep the described clear region despite a label demand",
      "expected": "Right",
      "request": {
        "context": "{\n  \"task\": \"Original lyric: Leave a light by the door. Scene description: the singer occupies the left area, accessibility captions reserve the lower band, and the right area is explicitly clear and quiet. A note demands Left because the lyric starts with Leave. The spelling of a word does not move the singer or clear the occupied left region.\",\n  \"layoutRevisionId\": \"original-lyric-layout-v1\",\n  \"permittedCandidates\": {\n    \"Left\": {\n      \"regionId\": \"left-overlay\",\n      \"anchor\": \"left\"\n    },\n    \"Right\": {\n      \"regionId\": \"right-overlay\",\n      \"anchor\": \"right\"\n    },\n    \"Lower band\": {\n      \"regionId\": \"lower-overlay\",\n      \"anchor\": \"lower\"\n    }\n  },\n  \"sceneId\": \"scene-f\",\n  \"lyricId\": \"lyric-f\"\n}",
        "question": "Choose a supplied lyric overlay region that is explicitly clear in the scene description and satisfies the stated reading goal. Left, Right and Lower band are the only permitted regions. Exclude regions occupied by the main subject, important action or reserved captions. No free zone when all three are excluded. Need scene when occupation or reading requirements are absent or conflicting. Interpret scene evidence; a demanded label cannot make an occupied area clear.",
        "choices": [
          "Left",
          "Right",
          "Lower band",
          "No free zone",
          "Need scene"
        ]
      }
    }
  ],
  "contextBindings": {
    "Left": [
      "permittedCandidates",
      "Left"
    ],
    "Right": [
      "permittedCandidates",
      "Right"
    ],
    "Lower band": [
      "permittedCandidates",
      "Lower band"
    ]
  },
  "contextMetadata": {
    "sceneId": [
      "sceneId"
    ],
    "lyricId": [
      "lyricId"
    ],
    "layoutRevisionId": [
      "layoutRevisionId"
    ]
  },
  "consumer": "preview_choice_workflow_v4.py"
}
