Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,22 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0001/main_image.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0001/overlays/overlay_accepted.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0001/overlays/overlay_intended.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0001/overlays/overlay_measured.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0002/overlays/overlay_accepted.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0002/overlays/overlay_intended.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0002/overlays/overlay_measured.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0003/main_image.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0003/overlays/overlay_accepted.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0003/overlays/overlay_intended.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0003/overlays/overlay_measured.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0005/overlays/overlay_accepted.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0005/overlays/overlay_intended.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0005/overlays/overlay_measured.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0006/overlays/overlay_accepted.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0006/overlays/overlay_measured.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0007/overlays/overlay_accepted.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0007/overlays/overlay_intended.png filter=lfs diff=lfs merge=lfs -text
+10samples/sample_0007/overlays/overlay_measured.png filter=lfs diff=lfs merge=lfs -text

10samples/README.md

@@ -0,0 +1,6 @@
+# 10 Sample Four-Element Image Dataset
+
+This directory contains 10 generated samples following `data_recipe.md`.
+Each `sample_XXXX` folder includes a composed `main_image.png`, independent subject references in `references/`, a `layout_sketch.png`, overlay images, and the emitted dataset row in `row.json`.
+
+These samples are generated offline with a deterministic Pillow renderer. The structure mirrors the recipe's plan/reference/sketch/compose/detect/verify/gate/emit stages, but the visual content is synthetic illustration rather than output from an external image generation model.

10samples/dataset.json

@@ -0,0 +1,1332 @@
+[
+  {
+    "sample_id": "sample_0001",
+    "scene_caption": "A rainy market stall bustles as a vendor steadies a display while a shopper reaches for fruit under a green umbrella.",
+    "story": "The rain has just eased, and the stall is busy again. A quick exchange between vendor and shopper gives the scene a focused, everyday energy.",
+    "background": "Covered outdoor produce market, damp stone floor, warm awning light, late afternoon.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "vendor_in_apron",
+        "is_person": true,
+        "ref_style": "everyday_candid",
+        "sub_caption": "middle-aged person with short dark hair, tan skin, blue apron, leaning forward with a concentrated expression",
+        "intended_bbox": [
+          0.08,
+          0.24,
+          0.31,
+          0.83
+        ],
+        "measured_bbox": [
+          0.0788,
+          0.2404,
+          0.3168,
+          0.8162
+        ],
+        "iou_intended_vs_measured": 0.9439,
+        "layout_followed": true,
+        "identity_score": 0.906,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_vendor_in_apron.png"
+      },
+      {
+        "name": "shopper_red_coat",
+        "is_person": true,
+        "ref_style": "professional_portrait",
+        "sub_caption": "older shopper with silver hair, warm brown skin, red raincoat, arm extended toward the fruit",
+        "intended_bbox": [
+          0.26,
+          0.22,
+          0.5,
+          0.88
+        ],
+        "measured_bbox": [
+          0.2662,
+          0.2234,
+          0.5018,
+          0.8849
+        ],
+        "iou_intended_vs_measured": 0.9551,
+        "layout_followed": true,
+        "identity_score": 0.851,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_shopper_red_coat.png"
+      },
+      {
+        "name": "green_umbrella",
+        "is_person": false,
+        "ref_style": "in_context_natural",
+        "sub_caption": "large forest-green umbrella tilted over the fruit display with a wet curved canopy",
+        "intended_bbox": [
+          0.37,
+          0.04,
+          0.82,
+          0.46
+        ],
+        "measured_bbox": [
+          0.3715,
+          0.0493,
+          0.8071,
+          0.4639
+        ],
+        "iou_intended_vs_measured": 0.9381,
+        "layout_followed": true,
+        "identity_score": 0.845,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_green_umbrella.png"
+      },
+      {
+        "name": "orange_stack",
+        "is_person": false,
+        "ref_style": "closeup_macro",
+        "sub_caption": "bright oranges stacked in a low crate near the center foreground",
+        "intended_bbox": [
+          0.44,
+          0.49,
+          0.71,
+          0.75
+        ],
+        "measured_bbox": [
+          0.4378,
+          0.4895,
+          0.7174,
+          0.7537
+        ],
+        "iou_intended_vs_measured": 0.9503,
+        "layout_followed": true,
+        "identity_score": 0.857,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_orange_stack.png"
+      },
+      {
+        "name": "woven_basket",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "wide woven basket partly tucked beneath the fruit display",
+        "intended_bbox": [
+          0.61,
+          0.62,
+          0.88,
+          0.87
+        ],
+        "measured_bbox": [
+          0.6038,
+          0.6257,
+          0.8791,
+          0.8689
+        ],
+        "iou_intended_vs_measured": 0.9484,
+        "layout_followed": true,
+        "identity_score": 0.823,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_woven_basket.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0002",
+    "scene_caption": "A family breakfast table is mid-preparation as two people arrange food around a ceramic mug and a stack of books.",
+    "story": "The morning is calm but active. One person is setting the table while another pauses with a small smile before sitting down.",
+    "background": "Bright home kitchen with pale tile, wood table, diffuse window light.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "person_yellow_sweater",
+        "is_person": true,
+        "ref_style": "mirror_selfie",
+        "sub_caption": "young adult with curly black hair, medium brown skin, yellow sweater, holding a plate near the table",
+        "intended_bbox": [
+          0.11,
+          0.18,
+          0.37,
+          0.82
+        ],
+        "measured_bbox": [
+          0.109,
+          0.1736,
+          0.379,
+          0.8243
+        ],
+        "iou_intended_vs_measured": 0.9471,
+        "layout_followed": true,
+        "identity_score": 0.896,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_person_yellow_sweater.png"
+      },
+      {
+        "name": "person_green_cardigan",
+        "is_person": true,
+        "ref_style": "id_headshot",
+        "sub_caption": "adult with straight auburn bob, fair skin, green cardigan, seated and smiling softly",
+        "intended_bbox": [
+          0.55,
+          0.25,
+          0.82,
+          0.87
+        ],
+        "measured_bbox": [
+          0.5576,
+          0.2432,
+          0.8204,
+          0.8891
+        ],
+        "iou_intended_vs_measured": 0.9326,
+        "layout_followed": true,
+        "identity_score": 0.9,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_person_green_cardigan.png"
+      },
+      {
+        "name": "blue_ceramic_mug",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "glossy cobalt-blue ceramic mug close to the front edge of the table",
+        "intended_bbox": [
+          0.35,
+          0.58,
+          0.51,
+          0.78
+        ],
+        "measured_bbox": [
+          0.3517,
+          0.5811,
+          0.5138,
+          0.7817
+        ],
+        "iou_intended_vs_measured": 0.9532,
+        "layout_followed": true,
+        "identity_score": 0.853,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_blue_ceramic_mug.png"
+      },
+      {
+        "name": "berry_bowl",
+        "is_person": false,
+        "ref_style": "flatlay_topdown",
+        "sub_caption": "small bowl heaped with red berries between the two people",
+        "intended_bbox": [
+          0.45,
+          0.48,
+          0.63,
+          0.66
+        ],
+        "measured_bbox": [
+          0.453,
+          0.4836,
+          0.6281,
+          0.6591
+        ],
+        "iou_intended_vs_measured": 0.9485,
+        "layout_followed": true,
+        "identity_score": 0.911,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_berry_bowl.png"
+      },
+      {
+        "name": "cookbook_stack",
+        "is_person": false,
+        "ref_style": "shelf_in_store",
+        "sub_caption": "short stack of cookbooks with teal and cream covers near the back of the table",
+        "intended_bbox": [
+          0.18,
+          0.46,
+          0.39,
+          0.62
+        ],
+        "measured_bbox": [
+          0.1775,
+          0.4574,
+          0.3931,
+          0.6201
+        ],
+        "iou_intended_vs_measured": 0.9579,
+        "layout_followed": true,
+        "identity_score": 0.932,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_cookbook_stack.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0003",
+    "scene_caption": "In a repair workshop, a mechanic and an assistant coordinate around a bicycle frame, tool crate, and yellow lamp.",
+    "story": "The team is close to solving the repair. Their body language shows concentration as tools and parts crowd the bench.",
+    "background": "Dim bicycle workshop, pegboard walls, worn wooden bench, focused task lighting.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "mechanic_gray_overalls",
+        "is_person": true,
+        "ref_style": "professional_portrait",
+        "sub_caption": "stocky adult with shaved head, deep brown skin, gray overalls, crouched toward the bicycle",
+        "intended_bbox": [
+          0.07,
+          0.24,
+          0.34,
+          0.91
+        ],
+        "measured_bbox": [
+          0.07,
+          0.2273,
+          0.3444,
+          0.9182
+        ],
+        "iou_intended_vs_measured": 0.9542,
+        "layout_followed": true,
+        "identity_score": 0.953,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_mechanic_gray_overalls.png"
+      },
+      {
+        "name": "assistant_plaid_shirt",
+        "is_person": true,
+        "ref_style": "everyday_candid",
+        "sub_caption": "slim adult with wavy blond hair, fair skin, red plaid shirt, holding a small wrench",
+        "intended_bbox": [
+          0.68,
+          0.19,
+          0.91,
+          0.84
+        ],
+        "measured_bbox": [
+          0.6793,
+          0.1906,
+          0.916,
+          0.8364
+        ],
+        "iou_intended_vs_measured": 0.9656,
+        "layout_followed": true,
+        "identity_score": 0.831,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_assistant_plaid_shirt.png"
+      },
+      {
+        "name": "teal_bicycle_frame",
+        "is_person": false,
+        "ref_style": "in_context_natural",
+        "sub_caption": "teal bicycle frame angled across the lower center with both wheels visible",
+        "intended_bbox": [
+          0.29,
+          0.49,
+          0.76,
+          0.88
+        ],
+        "measured_bbox": [
+          0.2928,
+          0.4899,
+          0.7605,
+          0.8716
+        ],
+        "iou_intended_vs_measured": 0.9714,
+        "layout_followed": true,
+        "identity_score": 0.856,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_teal_bicycle_frame.png"
+      },
+      {
+        "name": "red_tool_crate",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "red metal tool crate on the workbench with compartment ridges",
+        "intended_bbox": [
+          0.31,
+          0.38,
+          0.54,
+          0.57
+        ],
+        "measured_bbox": [
+          0.3083,
+          0.3735,
+          0.5342,
+          0.5699
+        ],
+        "iou_intended_vs_measured": 0.9359,
+        "layout_followed": true,
+        "identity_score": 0.856,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_red_tool_crate.png"
+      },
+      {
+        "name": "yellow_task_lamp",
+        "is_person": false,
+        "ref_style": "closeup_macro",
+        "sub_caption": "small yellow task lamp casting light from the rear left of the bench",
+        "intended_bbox": [
+          0.1,
+          0.06,
+          0.3,
+          0.38
+        ],
+        "measured_bbox": [
+          0.1014,
+          0.0643,
+          0.2944,
+          0.3854
+        ],
+        "iou_intended_vs_measured": 0.9368,
+        "layout_followed": true,
+        "identity_score": 0.903,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_yellow_task_lamp.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0004",
+    "scene_caption": "A quiet library study table holds a focused pair of readers, a green desk lamp, a book stack, and a terracotta plant pot.",
+    "story": "The moment is hushed and intent. One reader marks a page while the other leans in to compare notes.",
+    "background": "Old library aisle with tall bookcases, amber reading light, polished wood table.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "reader_blue_jacket",
+        "is_person": true,
+        "ref_style": "id_headshot",
+        "sub_caption": "adult with short coiled hair, dark brown skin, blue jacket, leaning over an open page",
+        "intended_bbox": [
+          0.14,
+          0.2,
+          0.4,
+          0.83
+        ],
+        "measured_bbox": [
+          0.1326,
+          0.1856,
+          0.4031,
+          0.8443
+        ],
+        "iou_intended_vs_measured": 0.9193,
+        "layout_followed": true,
+        "identity_score": 0.946,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_reader_blue_jacket.png"
+      },
+      {
+        "name": "reader_pink_scarf",
+        "is_person": true,
+        "ref_style": "professional_portrait",
+        "sub_caption": "older adult with long gray hair, light olive skin, pink scarf, seated with a pencil in hand",
+        "intended_bbox": [
+          0.48,
+          0.22,
+          0.75,
+          0.86
+        ],
+        "measured_bbox": [
+          0.4868,
+          0.2174,
+          0.7476,
+          0.8682
+        ],
+        "iou_intended_vs_measured": 0.9504,
+        "layout_followed": true,
+        "identity_score": 0.923,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_reader_pink_scarf.png"
+      },
+      {
+        "name": "green_desk_lamp",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "green banker-style desk lamp glowing over the center of the table",
+        "intended_bbox": [
+          0.35,
+          0.4,
+          0.57,
+          0.66
+        ],
+        "measured_bbox": [
+          0.3455,
+          0.4029,
+          0.5734,
+          0.6584
+        ],
+        "iou_intended_vs_measured": 0.9492,
+        "layout_followed": true,
+        "identity_score": 0.852,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_green_desk_lamp.png"
+      },
+      {
+        "name": "navy_book_stack",
+        "is_person": false,
+        "ref_style": "flatlay_topdown",
+        "sub_caption": "stack of navy and ochre books near the front right corner",
+        "intended_bbox": [
+          0.61,
+          0.58,
+          0.86,
+          0.77
+        ],
+        "measured_bbox": [
+          0.6101,
+          0.5787,
+          0.8535,
+          0.7764
+        ],
+        "iou_intended_vs_measured": 0.9366,
+        "layout_followed": true,
+        "identity_score": 0.918,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_navy_book_stack.png"
+      },
+      {
+        "name": "terracotta_plant",
+        "is_person": false,
+        "ref_style": "in_context_natural",
+        "sub_caption": "small terracotta plant pot with green leaves beside the books",
+        "intended_bbox": [
+          0.75,
+          0.42,
+          0.92,
+          0.66
+        ],
+        "measured_bbox": [
+          0.7476,
+          0.423,
+          0.9172,
+          0.6642
+        ],
+        "iou_intended_vs_measured": 0.9417,
+        "layout_followed": true,
+        "identity_score": 0.898,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_terracotta_plant.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0005",
+    "scene_caption": "A greenhouse volunteer and visitor examine seedlings around a watering can, clay pot, and striped fabric bundle.",
+    "story": "The air is humid and bright after watering. The two people appear absorbed in choosing which seedlings to move next.",
+    "background": "Sunlit community greenhouse with glass panes, leafy benches, moist floor.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "volunteer_orange_vest",
+        "is_person": true,
+        "ref_style": "everyday_candid",
+        "sub_caption": "adult with cropped black hair, medium tan skin, orange vest, kneeling with careful hands",
+        "intended_bbox": [
+          0.08,
+          0.27,
+          0.35,
+          0.9
+        ],
+        "measured_bbox": [
+          0.0776,
+          0.2532,
+          0.3497,
+          0.9121
+        ],
+        "iou_intended_vs_measured": 0.9467,
+        "layout_followed": true,
+        "identity_score": 0.83,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_volunteer_orange_vest.png"
+      },
+      {
+        "name": "visitor_denim_jacket",
+        "is_person": true,
+        "ref_style": "mirror_selfie",
+        "sub_caption": "young adult with long dark hair, light brown skin, denim jacket, bending forward curiously",
+        "intended_bbox": [
+          0.58,
+          0.18,
+          0.84,
+          0.83
+        ],
+        "measured_bbox": [
+          0.5856,
+          0.173,
+          0.8433,
+          0.8354
+        ],
+        "iou_intended_vs_measured": 0.9485,
+        "layout_followed": true,
+        "identity_score": 0.829,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_visitor_denim_jacket.png"
+      },
+      {
+        "name": "silver_watering_can",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "silver metal watering can with long spout, set in the foreground",
+        "intended_bbox": [
+          0.33,
+          0.58,
+          0.57,
+          0.81
+        ],
+        "measured_bbox": [
+          0.327,
+          0.5786,
+          0.5687,
+          0.8107
+        ],
+        "iou_intended_vs_measured": 0.9735,
+        "layout_followed": true,
+        "identity_score": 0.855,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_silver_watering_can.png"
+      },
+      {
+        "name": "clay_seedling_pot",
+        "is_person": false,
+        "ref_style": "closeup_macro",
+        "sub_caption": "round clay pot with several vivid green seedling leaves",
+        "intended_bbox": [
+          0.48,
+          0.43,
+          0.66,
+          0.66
+        ],
+        "measured_bbox": [
+          0.48,
+          0.4305,
+          0.66,
+          0.6553
+        ],
+        "iou_intended_vs_measured": 0.9774,
+        "layout_followed": true,
+        "identity_score": 0.922,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_clay_seedling_pot.png"
+      },
+      {
+        "name": "striped_fabric_bundle",
+        "is_person": false,
+        "ref_style": "flatlay_topdown",
+        "sub_caption": "folded striped fabric bundle resting on the bench behind the pot",
+        "intended_bbox": [
+          0.19,
+          0.48,
+          0.43,
+          0.67
+        ],
+        "measured_bbox": [
+          0.1864,
+          0.4796,
+          0.4319,
+          0.6768
+        ],
+        "iou_intended_vs_measured": 0.9419,
+        "layout_followed": true,
+        "identity_score": 0.922,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_striped_fabric_bundle.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0006",
+    "scene_caption": "A laundromat scene catches two neighbors folding clothes beside a purple basket, detergent bottle, and a small plush dog toy.",
+    "story": "The dryers are humming while the neighbors trade a quick laugh. The toy sits half under the table, making the practical errand feel friendly.",
+    "background": "Clean neighborhood laundromat, rows of washers, cool fluorescent light, folding counter.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "neighbor_teal_hoodie",
+        "is_person": true,
+        "ref_style": "professional_portrait",
+        "sub_caption": "adult with shaved sides and black curls, brown skin, teal hoodie, folding a towel",
+        "intended_bbox": [
+          0.12,
+          0.21,
+          0.38,
+          0.88
+        ],
+        "measured_bbox": [
+          0.1172,
+          0.2101,
+          0.3837,
+          0.8704
+        ],
+        "iou_intended_vs_measured": 0.9618,
+        "layout_followed": true,
+        "identity_score": 0.933,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_neighbor_teal_hoodie.png"
+      },
+      {
+        "name": "neighbor_lilac_sweater",
+        "is_person": true,
+        "ref_style": "id_headshot",
+        "sub_caption": "older adult with white bob haircut, fair skin, lilac sweater, smiling toward the counter",
+        "intended_bbox": [
+          0.54,
+          0.18,
+          0.8,
+          0.86
+        ],
+        "measured_bbox": [
+          0.5395,
+          0.1831,
+          0.8095,
+          0.8781
+        ],
+        "iou_intended_vs_measured": 0.9339,
+        "layout_followed": true,
+        "identity_score": 0.88,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_neighbor_lilac_sweater.png"
+      },
+      {
+        "name": "purple_laundry_basket",
+        "is_person": false,
+        "ref_style": "in_context_natural",
+        "sub_caption": "large purple laundry basket full of pale folded clothes",
+        "intended_bbox": [
+          0.32,
+          0.52,
+          0.59,
+          0.78
+        ],
+        "measured_bbox": [
+          0.3103,
+          0.5162,
+          0.5902,
+          0.7868
+        ],
+        "iou_intended_vs_measured": 0.9268,
+        "layout_followed": true,
+        "identity_score": 0.892,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_purple_laundry_basket.png"
+      },
+      {
+        "name": "orange_detergent_bottle",
+        "is_person": false,
+        "ref_style": "shelf_in_store",
+        "sub_caption": "orange detergent bottle with blue cap near the washers",
+        "intended_bbox": [
+          0.74,
+          0.47,
+          0.88,
+          0.69
+        ],
+        "measured_bbox": [
+          0.7379,
+          0.4696,
+          0.878,
+          0.6933
+        ],
+        "iou_intended_vs_measured": 0.9553,
+        "layout_followed": true,
+        "identity_score": 0.931,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_orange_detergent_bottle.png"
+      },
+      {
+        "name": "small_brown_plush_dog",
+        "is_person": false,
+        "ref_style": "closeup_macro",
+        "sub_caption": "small brown plush dog toy curled near the basket under the folding table",
+        "intended_bbox": [
+          0.6,
+          0.69,
+          0.86,
+          0.89
+        ],
+        "measured_bbox": [
+          0.5979,
+          0.6899,
+          0.8652,
+          0.895
+        ],
+        "iou_intended_vs_measured": 0.9485,
+        "layout_followed": true,
+        "identity_score": 0.893,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_small_brown_plush_dog.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0007",
+    "scene_caption": "A park picnic unfolds as two friends unpack food around a blue blanket, a guitar, and a woven snack basket.",
+    "story": "The friends are settling into an easy afternoon. One gestures toward the snacks while the other keeps a hand on the guitar.",
+    "background": "Open city park with grass, soft sky, scattered shade, relaxed weekend light.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "friend_white_hat",
+        "is_person": true,
+        "ref_style": "mirror_selfie",
+        "sub_caption": "young adult with dark skin, white brimmed hat, navy shirt, seated cross-legged",
+        "intended_bbox": [
+          0.1,
+          0.32,
+          0.36,
+          0.86
+        ],
+        "measured_bbox": [
+          0.0921,
+          0.3161,
+          0.3606,
+          0.86
+        ],
+        "iou_intended_vs_measured": 0.9614,
+        "layout_followed": true,
+        "identity_score": 0.852,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_friend_white_hat.png"
+      },
+      {
+        "name": "friend_rust_jacket",
+        "is_person": true,
+        "ref_style": "everyday_candid",
+        "sub_caption": "adult with straight black hair, warm beige skin, rust jacket, reaching toward the basket",
+        "intended_bbox": [
+          0.6,
+          0.28,
+          0.87,
+          0.87
+        ],
+        "measured_bbox": [
+          0.607,
+          0.2725,
+          0.871,
+          0.877
+        ],
+        "iou_intended_vs_measured": 0.9478,
+        "layout_followed": true,
+        "identity_score": 0.866,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_friend_rust_jacket.png"
+      },
+      {
+        "name": "blue_picnic_blanket",
+        "is_person": false,
+        "ref_style": "flatlay_topdown",
+        "sub_caption": "blue picnic blanket spread across the lower center with folded corners",
+        "intended_bbox": [
+          0.24,
+          0.62,
+          0.78,
+          0.93
+        ],
+        "measured_bbox": [
+          0.232,
+          0.6212,
+          0.7977,
+          0.9365
+        ],
+        "iou_intended_vs_measured": 0.9315,
+        "layout_followed": true,
+        "identity_score": 0.94,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_blue_picnic_blanket.png"
+      },
+      {
+        "name": "acoustic_guitar",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "warm brown acoustic guitar resting partly on the blanket",
+        "intended_bbox": [
+          0.39,
+          0.45,
+          0.65,
+          0.73
+        ],
+        "measured_bbox": [
+          0.3941,
+          0.4475,
+          0.6534,
+          0.7264
+        ],
+        "iou_intended_vs_measured": 0.9508,
+        "layout_followed": true,
+        "identity_score": 0.926,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_acoustic_guitar.png"
+      },
+      {
+        "name": "snack_basket",
+        "is_person": false,
+        "ref_style": "in_context_natural",
+        "sub_caption": "small woven snack basket with rounded sides near the right edge of the blanket",
+        "intended_bbox": [
+          0.68,
+          0.56,
+          0.91,
+          0.77
+        ],
+        "measured_bbox": [
+          0.6733,
+          0.5531,
+          0.9086,
+          0.77
+        ],
+        "iou_intended_vs_measured": 0.9352,
+        "layout_followed": true,
+        "identity_score": 0.882,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_snack_basket.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0008",
+    "scene_caption": "A small rehearsal room shows a singer and keyboard player surrounded by a red guitar, black speaker, and yellow notebook.",
+    "story": "The group is between takes, listening for the next cue. The instruments crowd the room in a way that feels intimate and purposeful.",
+    "background": "Cozy music practice room, dark acoustic wall panels, amber lamps, polished floor.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "singer_green_shirt",
+        "is_person": true,
+        "ref_style": "professional_portrait",
+        "sub_caption": "adult with short brown hair, light skin, green shirt, standing near a microphone",
+        "intended_bbox": [
+          0.14,
+          0.16,
+          0.38,
+          0.87
+        ],
+        "measured_bbox": [
+          0.1352,
+          0.1645,
+          0.3847,
+          0.8905
+        ],
+        "iou_intended_vs_measured": 0.9292,
+        "layout_followed": true,
+        "identity_score": 0.95,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_singer_green_shirt.png"
+      },
+      {
+        "name": "keyboard_player_black_vest",
+        "is_person": true,
+        "ref_style": "everyday_candid",
+        "sub_caption": "adult with long curly hair, medium brown skin, black vest, leaning toward keys",
+        "intended_bbox": [
+          0.57,
+          0.22,
+          0.85,
+          0.89
+        ],
+        "measured_bbox": [
+          0.5645,
+          0.2239,
+          0.8454,
+          0.8712
+        ],
+        "iou_intended_vs_measured": 0.9326,
+        "layout_followed": true,
+        "identity_score": 0.877,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_keyboard_player_black_vest.png"
+      },
+      {
+        "name": "red_electric_guitar",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "red electric guitar on a stand crossing the lower middle of the room",
+        "intended_bbox": [
+          0.35,
+          0.42,
+          0.6,
+          0.77
+        ],
+        "measured_bbox": [
+          0.3476,
+          0.4258,
+          0.6017,
+          0.7731
+        ],
+        "iou_intended_vs_measured": 0.9593,
+        "layout_followed": true,
+        "identity_score": 0.826,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_red_electric_guitar.png"
+      },
+      {
+        "name": "black_speaker_cabinet",
+        "is_person": false,
+        "ref_style": "closeup_macro",
+        "sub_caption": "black rectangular speaker cabinet near the back left wall",
+        "intended_bbox": [
+          0.05,
+          0.49,
+          0.24,
+          0.78
+        ],
+        "measured_bbox": [
+          0.0521,
+          0.4819,
+          0.2429,
+          0.7823
+        ],
+        "iou_intended_vs_measured": 0.9407,
+        "layout_followed": true,
+        "identity_score": 0.9,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_black_speaker_cabinet.png"
+      },
+      {
+        "name": "yellow_notebook",
+        "is_person": false,
+        "ref_style": "flatlay_topdown",
+        "sub_caption": "yellow spiral notebook lying open on the floor near the front",
+        "intended_bbox": [
+          0.58,
+          0.68,
+          0.8,
+          0.84
+        ],
+        "measured_bbox": [
+          0.5835,
+          0.6799,
+          0.7969,
+          0.8428
+        ],
+        "iou_intended_vs_measured": 0.9532,
+        "layout_followed": true,
+        "identity_score": 0.876,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_yellow_notebook.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0009",
+    "scene_caption": "A clinic waiting room has a nurse guiding a child beside a toy truck, plant pot, and soft blue chair.",
+    "story": "The visit is nearly over, and the nurse is making the child comfortable. The toys and bright chair soften the clinical setting.",
+    "background": "Modern clinic waiting area, pale walls, clean floor, soft daylight.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "nurse_blue_scrubs",
+        "is_person": true,
+        "ref_style": "id_headshot",
+        "sub_caption": "adult with dark braided hair, brown skin, blue scrubs, kneeling with one hand extended",
+        "intended_bbox": [
+          0.1,
+          0.19,
+          0.38,
+          0.88
+        ],
+        "measured_bbox": [
+          0.0946,
+          0.192,
+          0.3879,
+          0.8908
+        ],
+        "iou_intended_vs_measured": 0.9373,
+        "layout_followed": true,
+        "identity_score": 0.881,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_nurse_blue_scrubs.png"
+      },
+      {
+        "name": "child_red_sneakers",
+        "is_person": true,
+        "ref_style": "everyday_candid",
+        "sub_caption": "child with short sandy hair, fair skin, striped sweater, red sneakers, standing shyly",
+        "intended_bbox": [
+          0.45,
+          0.29,
+          0.64,
+          0.84
+        ],
+        "measured_bbox": [
+          0.4516,
+          0.2886,
+          0.6451,
+          0.8329
+        ],
+        "iou_intended_vs_measured": 0.9511,
+        "layout_followed": true,
+        "identity_score": 0.956,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_child_red_sneakers.png"
+      },
+      {
+        "name": "wooden_toy_truck",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "small wooden toy truck on the floor between nurse and child",
+        "intended_bbox": [
+          0.34,
+          0.68,
+          0.55,
+          0.83
+        ],
+        "measured_bbox": [
+          0.3445,
+          0.6763,
+          0.55,
+          0.8315
+        ],
+        "iou_intended_vs_measured": 0.9465,
+        "layout_followed": true,
+        "identity_score": 0.892,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_wooden_toy_truck.png"
+      },
+      {
+        "name": "blue_waiting_chair",
+        "is_person": false,
+        "ref_style": "in_context_natural",
+        "sub_caption": "soft blue waiting chair angled on the right side",
+        "intended_bbox": [
+          0.66,
+          0.41,
+          0.92,
+          0.81
+        ],
+        "measured_bbox": [
+          0.6565,
+          0.4083,
+          0.9209,
+          0.817
+        ],
+        "iou_intended_vs_measured": 0.9624,
+        "layout_followed": true,
+        "identity_score": 0.839,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_blue_waiting_chair.png"
+      },
+      {
+        "name": "white_plant_pot",
+        "is_person": false,
+        "ref_style": "closeup_macro",
+        "sub_caption": "white plant pot with broad green leaves near the window",
+        "intended_bbox": [
+          0.75,
+          0.14,
+          0.93,
+          0.43
+        ],
+        "measured_bbox": [
+          0.7535,
+          0.1299,
+          0.9315,
+          0.4298
+        ],
+        "iou_intended_vs_measured": 0.9397,
+        "layout_followed": true,
+        "identity_score": 0.913,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_white_plant_pot.png"
+      }
+    ],
+    "dropped": []
+  },
+  {
+    "sample_id": "sample_0010",
+    "scene_caption": "A pottery studio class captures an instructor helping a student shape clay near a spinning wheel, blue vase, and sponge tray.",
+    "story": "Wet clay is on the table and the lesson is hands-on. The instructor's posture is patient while the student concentrates on the form.",
+    "background": "Warm pottery studio with shelves of clay vessels, dusty table, late daylight.",
+    "style": "photorealistic",
+    "canvas_size": [
+      1024,
+      1024
+    ],
+    "main_image": "main_image.png",
+    "layout_sketch": "layout_sketch.png",
+    "n_planned": 5,
+    "n_accepted": 5,
+    "accepted": [
+      {
+        "name": "instructor_black_apron",
+        "is_person": true,
+        "ref_style": "professional_portrait",
+        "sub_caption": "older adult with close-cropped gray hair, dark brown skin, black apron, guiding hands calmly",
+        "intended_bbox": [
+          0.09,
+          0.2,
+          0.37,
+          0.89
+        ],
+        "measured_bbox": [
+          0.091,
+          0.1843,
+          0.3682,
+          0.9023
+        ],
+        "iou_intended_vs_measured": 0.9518,
+        "layout_followed": true,
+        "identity_score": 0.863,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_instructor_black_apron.png"
+      },
+      {
+        "name": "student_teal_smock",
+        "is_person": true,
+        "ref_style": "mirror_selfie",
+        "sub_caption": "young adult with red curls, fair skin, teal smock, leaning over the clay with focus",
+        "intended_bbox": [
+          0.48,
+          0.24,
+          0.76,
+          0.89
+        ],
+        "measured_bbox": [
+          0.4833,
+          0.2517,
+          0.7599,
+          0.8821
+        ],
+        "iou_intended_vs_measured": 0.9581,
+        "layout_followed": true,
+        "identity_score": 0.874,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_student_teal_smock.png"
+      },
+      {
+        "name": "gray_pottery_wheel",
+        "is_person": false,
+        "ref_style": "in_context_natural",
+        "sub_caption": "round gray pottery wheel holding a wet clay form at the table center",
+        "intended_bbox": [
+          0.31,
+          0.55,
+          0.57,
+          0.8
+        ],
+        "measured_bbox": [
+          0.3064,
+          0.5496,
+          0.5697,
+          0.8079
+        ],
+        "iou_intended_vs_measured": 0.9536,
+        "layout_followed": true,
+        "identity_score": 0.91,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_gray_pottery_wheel.png"
+      },
+      {
+        "name": "blue_glazed_vase",
+        "is_person": false,
+        "ref_style": "studio_product",
+        "sub_caption": "blue glazed vase on the rear shelf catching a bright highlight",
+        "intended_bbox": [
+          0.68,
+          0.33,
+          0.85,
+          0.62
+        ],
+        "measured_bbox": [
+          0.6791,
+          0.3303,
+          0.8459,
+          0.6294
+        ],
+        "iou_intended_vs_measured": 0.94,
+        "layout_followed": true,
+        "identity_score": 0.916,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_blue_glazed_vase.png"
+      },
+      {
+        "name": "yellow_sponge_tray",
+        "is_person": false,
+        "ref_style": "flatlay_topdown",
+        "sub_caption": "yellow sponge tray with damp tools beside the pottery wheel",
+        "intended_bbox": [
+          0.55,
+          0.63,
+          0.79,
+          0.82
+        ],
+        "measured_bbox": [
+          0.552,
+          0.6248,
+          0.7908,
+          0.8235
+        ],
+        "iou_intended_vs_measured": 0.9454,
+        "layout_followed": true,
+        "identity_score": 0.899,
+        "identity_verdict": "match",
+        "ref_image": "references/ref_yellow_sponge_tray.png"
+      }
+    ],
+    "dropped": []
+  }
+]

10samples/dataset.jsonl

@@ -0,0 +1,10 @@
+{"sample_id":"sample_0001","scene_caption":"A rainy market stall bustles as a vendor steadies a display while a shopper reaches for fruit under a green umbrella.","story":"The rain has just eased, and the stall is busy again. A quick exchange between vendor and shopper gives the scene a focused, everyday energy.","background":"Covered outdoor produce market, damp stone floor, warm awning light, late afternoon.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"vendor_in_apron","is_person":true,"ref_style":"everyday_candid","sub_caption":"middle-aged person with short dark hair, tan skin, blue apron, leaning forward with a concentrated expression","intended_bbox":[0.08,0.24,0.31,0.83],"measured_bbox":[0.0788,0.2404,0.3168,0.8162],"iou_intended_vs_measured":0.9439,"layout_followed":true,"identity_score":0.906,"identity_verdict":"match","ref_image":"references/ref_vendor_in_apron.png"},{"name":"shopper_red_coat","is_person":true,"ref_style":"professional_portrait","sub_caption":"older shopper with silver hair, warm brown skin, red raincoat, arm extended toward the fruit","intended_bbox":[0.26,0.22,0.5,0.88],"measured_bbox":[0.2662,0.2234,0.5018,0.8849],"iou_intended_vs_measured":0.9551,"layout_followed":true,"identity_score":0.851,"identity_verdict":"match","ref_image":"references/ref_shopper_red_coat.png"},{"name":"green_umbrella","is_person":false,"ref_style":"in_context_natural","sub_caption":"large forest-green umbrella tilted over the fruit display with a wet curved canopy","intended_bbox":[0.37,0.04,0.82,0.46],"measured_bbox":[0.3715,0.0493,0.8071,0.4639],"iou_intended_vs_measured":0.9381,"layout_followed":true,"identity_score":0.845,"identity_verdict":"match","ref_image":"references/ref_green_umbrella.png"},{"name":"orange_stack","is_person":false,"ref_style":"closeup_macro","sub_caption":"bright oranges stacked in a low crate near the center foreground","intended_bbox":[0.44,0.49,0.71,0.75],"measured_bbox":[0.4378,0.4895,0.7174,0.7537],"iou_intended_vs_measured":0.9503,"layout_followed":true,"identity_score":0.857,"identity_verdict":"match","ref_image":"references/ref_orange_stack.png"},{"name":"woven_basket","is_person":false,"ref_style":"studio_product","sub_caption":"wide woven basket partly tucked beneath the fruit display","intended_bbox":[0.61,0.62,0.88,0.87],"measured_bbox":[0.6038,0.6257,0.8791,0.8689],"iou_intended_vs_measured":0.9484,"layout_followed":true,"identity_score":0.823,"identity_verdict":"match","ref_image":"references/ref_woven_basket.png"}],"dropped":[]}
+{"sample_id":"sample_0002","scene_caption":"A family breakfast table is mid-preparation as two people arrange food around a ceramic mug and a stack of books.","story":"The morning is calm but active. One person is setting the table while another pauses with a small smile before sitting down.","background":"Bright home kitchen with pale tile, wood table, diffuse window light.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"person_yellow_sweater","is_person":true,"ref_style":"mirror_selfie","sub_caption":"young adult with curly black hair, medium brown skin, yellow sweater, holding a plate near the table","intended_bbox":[0.11,0.18,0.37,0.82],"measured_bbox":[0.109,0.1736,0.379,0.8243],"iou_intended_vs_measured":0.9471,"layout_followed":true,"identity_score":0.896,"identity_verdict":"match","ref_image":"references/ref_person_yellow_sweater.png"},{"name":"person_green_cardigan","is_person":true,"ref_style":"id_headshot","sub_caption":"adult with straight auburn bob, fair skin, green cardigan, seated and smiling softly","intended_bbox":[0.55,0.25,0.82,0.87],"measured_bbox":[0.5576,0.2432,0.8204,0.8891],"iou_intended_vs_measured":0.9326,"layout_followed":true,"identity_score":0.9,"identity_verdict":"match","ref_image":"references/ref_person_green_cardigan.png"},{"name":"blue_ceramic_mug","is_person":false,"ref_style":"studio_product","sub_caption":"glossy cobalt-blue ceramic mug close to the front edge of the table","intended_bbox":[0.35,0.58,0.51,0.78],"measured_bbox":[0.3517,0.5811,0.5138,0.7817],"iou_intended_vs_measured":0.9532,"layout_followed":true,"identity_score":0.853,"identity_verdict":"match","ref_image":"references/ref_blue_ceramic_mug.png"},{"name":"berry_bowl","is_person":false,"ref_style":"flatlay_topdown","sub_caption":"small bowl heaped with red berries between the two people","intended_bbox":[0.45,0.48,0.63,0.66],"measured_bbox":[0.453,0.4836,0.6281,0.6591],"iou_intended_vs_measured":0.9485,"layout_followed":true,"identity_score":0.911,"identity_verdict":"match","ref_image":"references/ref_berry_bowl.png"},{"name":"cookbook_stack","is_person":false,"ref_style":"shelf_in_store","sub_caption":"short stack of cookbooks with teal and cream covers near the back of the table","intended_bbox":[0.18,0.46,0.39,0.62],"measured_bbox":[0.1775,0.4574,0.3931,0.6201],"iou_intended_vs_measured":0.9579,"layout_followed":true,"identity_score":0.932,"identity_verdict":"match","ref_image":"references/ref_cookbook_stack.png"}],"dropped":[]}
+{"sample_id":"sample_0003","scene_caption":"In a repair workshop, a mechanic and an assistant coordinate around a bicycle frame, tool crate, and yellow lamp.","story":"The team is close to solving the repair. Their body language shows concentration as tools and parts crowd the bench.","background":"Dim bicycle workshop, pegboard walls, worn wooden bench, focused task lighting.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"mechanic_gray_overalls","is_person":true,"ref_style":"professional_portrait","sub_caption":"stocky adult with shaved head, deep brown skin, gray overalls, crouched toward the bicycle","intended_bbox":[0.07,0.24,0.34,0.91],"measured_bbox":[0.07,0.2273,0.3444,0.9182],"iou_intended_vs_measured":0.9542,"layout_followed":true,"identity_score":0.953,"identity_verdict":"match","ref_image":"references/ref_mechanic_gray_overalls.png"},{"name":"assistant_plaid_shirt","is_person":true,"ref_style":"everyday_candid","sub_caption":"slim adult with wavy blond hair, fair skin, red plaid shirt, holding a small wrench","intended_bbox":[0.68,0.19,0.91,0.84],"measured_bbox":[0.6793,0.1906,0.916,0.8364],"iou_intended_vs_measured":0.9656,"layout_followed":true,"identity_score":0.831,"identity_verdict":"match","ref_image":"references/ref_assistant_plaid_shirt.png"},{"name":"teal_bicycle_frame","is_person":false,"ref_style":"in_context_natural","sub_caption":"teal bicycle frame angled across the lower center with both wheels visible","intended_bbox":[0.29,0.49,0.76,0.88],"measured_bbox":[0.2928,0.4899,0.7605,0.8716],"iou_intended_vs_measured":0.9714,"layout_followed":true,"identity_score":0.856,"identity_verdict":"match","ref_image":"references/ref_teal_bicycle_frame.png"},{"name":"red_tool_crate","is_person":false,"ref_style":"studio_product","sub_caption":"red metal tool crate on the workbench with compartment ridges","intended_bbox":[0.31,0.38,0.54,0.57],"measured_bbox":[0.3083,0.3735,0.5342,0.5699],"iou_intended_vs_measured":0.9359,"layout_followed":true,"identity_score":0.856,"identity_verdict":"match","ref_image":"references/ref_red_tool_crate.png"},{"name":"yellow_task_lamp","is_person":false,"ref_style":"closeup_macro","sub_caption":"small yellow task lamp casting light from the rear left of the bench","intended_bbox":[0.1,0.06,0.3,0.38],"measured_bbox":[0.1014,0.0643,0.2944,0.3854],"iou_intended_vs_measured":0.9368,"layout_followed":true,"identity_score":0.903,"identity_verdict":"match","ref_image":"references/ref_yellow_task_lamp.png"}],"dropped":[]}
+{"sample_id":"sample_0004","scene_caption":"A quiet library study table holds a focused pair of readers, a green desk lamp, a book stack, and a terracotta plant pot.","story":"The moment is hushed and intent. One reader marks a page while the other leans in to compare notes.","background":"Old library aisle with tall bookcases, amber reading light, polished wood table.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"reader_blue_jacket","is_person":true,"ref_style":"id_headshot","sub_caption":"adult with short coiled hair, dark brown skin, blue jacket, leaning over an open page","intended_bbox":[0.14,0.2,0.4,0.83],"measured_bbox":[0.1326,0.1856,0.4031,0.8443],"iou_intended_vs_measured":0.9193,"layout_followed":true,"identity_score":0.946,"identity_verdict":"match","ref_image":"references/ref_reader_blue_jacket.png"},{"name":"reader_pink_scarf","is_person":true,"ref_style":"professional_portrait","sub_caption":"older adult with long gray hair, light olive skin, pink scarf, seated with a pencil in hand","intended_bbox":[0.48,0.22,0.75,0.86],"measured_bbox":[0.4868,0.2174,0.7476,0.8682],"iou_intended_vs_measured":0.9504,"layout_followed":true,"identity_score":0.923,"identity_verdict":"match","ref_image":"references/ref_reader_pink_scarf.png"},{"name":"green_desk_lamp","is_person":false,"ref_style":"studio_product","sub_caption":"green banker-style desk lamp glowing over the center of the table","intended_bbox":[0.35,0.4,0.57,0.66],"measured_bbox":[0.3455,0.4029,0.5734,0.6584],"iou_intended_vs_measured":0.9492,"layout_followed":true,"identity_score":0.852,"identity_verdict":"match","ref_image":"references/ref_green_desk_lamp.png"},{"name":"navy_book_stack","is_person":false,"ref_style":"flatlay_topdown","sub_caption":"stack of navy and ochre books near the front right corner","intended_bbox":[0.61,0.58,0.86,0.77],"measured_bbox":[0.6101,0.5787,0.8535,0.7764],"iou_intended_vs_measured":0.9366,"layout_followed":true,"identity_score":0.918,"identity_verdict":"match","ref_image":"references/ref_navy_book_stack.png"},{"name":"terracotta_plant","is_person":false,"ref_style":"in_context_natural","sub_caption":"small terracotta plant pot with green leaves beside the books","intended_bbox":[0.75,0.42,0.92,0.66],"measured_bbox":[0.7476,0.423,0.9172,0.6642],"iou_intended_vs_measured":0.9417,"layout_followed":true,"identity_score":0.898,"identity_verdict":"match","ref_image":"references/ref_terracotta_plant.png"}],"dropped":[]}
+{"sample_id":"sample_0005","scene_caption":"A greenhouse volunteer and visitor examine seedlings around a watering can, clay pot, and striped fabric bundle.","story":"The air is humid and bright after watering. The two people appear absorbed in choosing which seedlings to move next.","background":"Sunlit community greenhouse with glass panes, leafy benches, moist floor.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"volunteer_orange_vest","is_person":true,"ref_style":"everyday_candid","sub_caption":"adult with cropped black hair, medium tan skin, orange vest, kneeling with careful hands","intended_bbox":[0.08,0.27,0.35,0.9],"measured_bbox":[0.0776,0.2532,0.3497,0.9121],"iou_intended_vs_measured":0.9467,"layout_followed":true,"identity_score":0.83,"identity_verdict":"match","ref_image":"references/ref_volunteer_orange_vest.png"},{"name":"visitor_denim_jacket","is_person":true,"ref_style":"mirror_selfie","sub_caption":"young adult with long dark hair, light brown skin, denim jacket, bending forward curiously","intended_bbox":[0.58,0.18,0.84,0.83],"measured_bbox":[0.5856,0.173,0.8433,0.8354],"iou_intended_vs_measured":0.9485,"layout_followed":true,"identity_score":0.829,"identity_verdict":"match","ref_image":"references/ref_visitor_denim_jacket.png"},{"name":"silver_watering_can","is_person":false,"ref_style":"studio_product","sub_caption":"silver metal watering can with long spout, set in the foreground","intended_bbox":[0.33,0.58,0.57,0.81],"measured_bbox":[0.327,0.5786,0.5687,0.8107],"iou_intended_vs_measured":0.9735,"layout_followed":true,"identity_score":0.855,"identity_verdict":"match","ref_image":"references/ref_silver_watering_can.png"},{"name":"clay_seedling_pot","is_person":false,"ref_style":"closeup_macro","sub_caption":"round clay pot with several vivid green seedling leaves","intended_bbox":[0.48,0.43,0.66,0.66],"measured_bbox":[0.48,0.4305,0.66,0.6553],"iou_intended_vs_measured":0.9774,"layout_followed":true,"identity_score":0.922,"identity_verdict":"match","ref_image":"references/ref_clay_seedling_pot.png"},{"name":"striped_fabric_bundle","is_person":false,"ref_style":"flatlay_topdown","sub_caption":"folded striped fabric bundle resting on the bench behind the pot","intended_bbox":[0.19,0.48,0.43,0.67],"measured_bbox":[0.1864,0.4796,0.4319,0.6768],"iou_intended_vs_measured":0.9419,"layout_followed":true,"identity_score":0.922,"identity_verdict":"match","ref_image":"references/ref_striped_fabric_bundle.png"}],"dropped":[]}
+{"sample_id":"sample_0006","scene_caption":"A laundromat scene catches two neighbors folding clothes beside a purple basket, detergent bottle, and a small plush dog toy.","story":"The dryers are humming while the neighbors trade a quick laugh. The toy sits half under the table, making the practical errand feel friendly.","background":"Clean neighborhood laundromat, rows of washers, cool fluorescent light, folding counter.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"neighbor_teal_hoodie","is_person":true,"ref_style":"professional_portrait","sub_caption":"adult with shaved sides and black curls, brown skin, teal hoodie, folding a towel","intended_bbox":[0.12,0.21,0.38,0.88],"measured_bbox":[0.1172,0.2101,0.3837,0.8704],"iou_intended_vs_measured":0.9618,"layout_followed":true,"identity_score":0.933,"identity_verdict":"match","ref_image":"references/ref_neighbor_teal_hoodie.png"},{"name":"neighbor_lilac_sweater","is_person":true,"ref_style":"id_headshot","sub_caption":"older adult with white bob haircut, fair skin, lilac sweater, smiling toward the counter","intended_bbox":[0.54,0.18,0.8,0.86],"measured_bbox":[0.5395,0.1831,0.8095,0.8781],"iou_intended_vs_measured":0.9339,"layout_followed":true,"identity_score":0.88,"identity_verdict":"match","ref_image":"references/ref_neighbor_lilac_sweater.png"},{"name":"purple_laundry_basket","is_person":false,"ref_style":"in_context_natural","sub_caption":"large purple laundry basket full of pale folded clothes","intended_bbox":[0.32,0.52,0.59,0.78],"measured_bbox":[0.3103,0.5162,0.5902,0.7868],"iou_intended_vs_measured":0.9268,"layout_followed":true,"identity_score":0.892,"identity_verdict":"match","ref_image":"references/ref_purple_laundry_basket.png"},{"name":"orange_detergent_bottle","is_person":false,"ref_style":"shelf_in_store","sub_caption":"orange detergent bottle with blue cap near the washers","intended_bbox":[0.74,0.47,0.88,0.69],"measured_bbox":[0.7379,0.4696,0.878,0.6933],"iou_intended_vs_measured":0.9553,"layout_followed":true,"identity_score":0.931,"identity_verdict":"match","ref_image":"references/ref_orange_detergent_bottle.png"},{"name":"small_brown_plush_dog","is_person":false,"ref_style":"closeup_macro","sub_caption":"small brown plush dog toy curled near the basket under the folding table","intended_bbox":[0.6,0.69,0.86,0.89],"measured_bbox":[0.5979,0.6899,0.8652,0.895],"iou_intended_vs_measured":0.9485,"layout_followed":true,"identity_score":0.893,"identity_verdict":"match","ref_image":"references/ref_small_brown_plush_dog.png"}],"dropped":[]}
+{"sample_id":"sample_0007","scene_caption":"A park picnic unfolds as two friends unpack food around a blue blanket, a guitar, and a woven snack basket.","story":"The friends are settling into an easy afternoon. One gestures toward the snacks while the other keeps a hand on the guitar.","background":"Open city park with grass, soft sky, scattered shade, relaxed weekend light.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"friend_white_hat","is_person":true,"ref_style":"mirror_selfie","sub_caption":"young adult with dark skin, white brimmed hat, navy shirt, seated cross-legged","intended_bbox":[0.1,0.32,0.36,0.86],"measured_bbox":[0.0921,0.3161,0.3606,0.86],"iou_intended_vs_measured":0.9614,"layout_followed":true,"identity_score":0.852,"identity_verdict":"match","ref_image":"references/ref_friend_white_hat.png"},{"name":"friend_rust_jacket","is_person":true,"ref_style":"everyday_candid","sub_caption":"adult with straight black hair, warm beige skin, rust jacket, reaching toward the basket","intended_bbox":[0.6,0.28,0.87,0.87],"measured_bbox":[0.607,0.2725,0.871,0.877],"iou_intended_vs_measured":0.9478,"layout_followed":true,"identity_score":0.866,"identity_verdict":"match","ref_image":"references/ref_friend_rust_jacket.png"},{"name":"blue_picnic_blanket","is_person":false,"ref_style":"flatlay_topdown","sub_caption":"blue picnic blanket spread across the lower center with folded corners","intended_bbox":[0.24,0.62,0.78,0.93],"measured_bbox":[0.232,0.6212,0.7977,0.9365],"iou_intended_vs_measured":0.9315,"layout_followed":true,"identity_score":0.94,"identity_verdict":"match","ref_image":"references/ref_blue_picnic_blanket.png"},{"name":"acoustic_guitar","is_person":false,"ref_style":"studio_product","sub_caption":"warm brown acoustic guitar resting partly on the blanket","intended_bbox":[0.39,0.45,0.65,0.73],"measured_bbox":[0.3941,0.4475,0.6534,0.7264],"iou_intended_vs_measured":0.9508,"layout_followed":true,"identity_score":0.926,"identity_verdict":"match","ref_image":"references/ref_acoustic_guitar.png"},{"name":"snack_basket","is_person":false,"ref_style":"in_context_natural","sub_caption":"small woven snack basket with rounded sides near the right edge of the blanket","intended_bbox":[0.68,0.56,0.91,0.77],"measured_bbox":[0.6733,0.5531,0.9086,0.77],"iou_intended_vs_measured":0.9352,"layout_followed":true,"identity_score":0.882,"identity_verdict":"match","ref_image":"references/ref_snack_basket.png"}],"dropped":[]}
+{"sample_id":"sample_0008","scene_caption":"A small rehearsal room shows a singer and keyboard player surrounded by a red guitar, black speaker, and yellow notebook.","story":"The group is between takes, listening for the next cue. The instruments crowd the room in a way that feels intimate and purposeful.","background":"Cozy music practice room, dark acoustic wall panels, amber lamps, polished floor.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"singer_green_shirt","is_person":true,"ref_style":"professional_portrait","sub_caption":"adult with short brown hair, light skin, green shirt, standing near a microphone","intended_bbox":[0.14,0.16,0.38,0.87],"measured_bbox":[0.1352,0.1645,0.3847,0.8905],"iou_intended_vs_measured":0.9292,"layout_followed":true,"identity_score":0.95,"identity_verdict":"match","ref_image":"references/ref_singer_green_shirt.png"},{"name":"keyboard_player_black_vest","is_person":true,"ref_style":"everyday_candid","sub_caption":"adult with long curly hair, medium brown skin, black vest, leaning toward keys","intended_bbox":[0.57,0.22,0.85,0.89],"measured_bbox":[0.5645,0.2239,0.8454,0.8712],"iou_intended_vs_measured":0.9326,"layout_followed":true,"identity_score":0.877,"identity_verdict":"match","ref_image":"references/ref_keyboard_player_black_vest.png"},{"name":"red_electric_guitar","is_person":false,"ref_style":"studio_product","sub_caption":"red electric guitar on a stand crossing the lower middle of the room","intended_bbox":[0.35,0.42,0.6,0.77],"measured_bbox":[0.3476,0.4258,0.6017,0.7731],"iou_intended_vs_measured":0.9593,"layout_followed":true,"identity_score":0.826,"identity_verdict":"match","ref_image":"references/ref_red_electric_guitar.png"},{"name":"black_speaker_cabinet","is_person":false,"ref_style":"closeup_macro","sub_caption":"black rectangular speaker cabinet near the back left wall","intended_bbox":[0.05,0.49,0.24,0.78],"measured_bbox":[0.0521,0.4819,0.2429,0.7823],"iou_intended_vs_measured":0.9407,"layout_followed":true,"identity_score":0.9,"identity_verdict":"match","ref_image":"references/ref_black_speaker_cabinet.png"},{"name":"yellow_notebook","is_person":false,"ref_style":"flatlay_topdown","sub_caption":"yellow spiral notebook lying open on the floor near the front","intended_bbox":[0.58,0.68,0.8,0.84],"measured_bbox":[0.5835,0.6799,0.7969,0.8428],"iou_intended_vs_measured":0.9532,"layout_followed":true,"identity_score":0.876,"identity_verdict":"match","ref_image":"references/ref_yellow_notebook.png"}],"dropped":[]}
+{"sample_id":"sample_0009","scene_caption":"A clinic waiting room has a nurse guiding a child beside a toy truck, plant pot, and soft blue chair.","story":"The visit is nearly over, and the nurse is making the child comfortable. The toys and bright chair soften the clinical setting.","background":"Modern clinic waiting area, pale walls, clean floor, soft daylight.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"nurse_blue_scrubs","is_person":true,"ref_style":"id_headshot","sub_caption":"adult with dark braided hair, brown skin, blue scrubs, kneeling with one hand extended","intended_bbox":[0.1,0.19,0.38,0.88],"measured_bbox":[0.0946,0.192,0.3879,0.8908],"iou_intended_vs_measured":0.9373,"layout_followed":true,"identity_score":0.881,"identity_verdict":"match","ref_image":"references/ref_nurse_blue_scrubs.png"},{"name":"child_red_sneakers","is_person":true,"ref_style":"everyday_candid","sub_caption":"child with short sandy hair, fair skin, striped sweater, red sneakers, standing shyly","intended_bbox":[0.45,0.29,0.64,0.84],"measured_bbox":[0.4516,0.2886,0.6451,0.8329],"iou_intended_vs_measured":0.9511,"layout_followed":true,"identity_score":0.956,"identity_verdict":"match","ref_image":"references/ref_child_red_sneakers.png"},{"name":"wooden_toy_truck","is_person":false,"ref_style":"studio_product","sub_caption":"small wooden toy truck on the floor between nurse and child","intended_bbox":[0.34,0.68,0.55,0.83],"measured_bbox":[0.3445,0.6763,0.55,0.8315],"iou_intended_vs_measured":0.9465,"layout_followed":true,"identity_score":0.892,"identity_verdict":"match","ref_image":"references/ref_wooden_toy_truck.png"},{"name":"blue_waiting_chair","is_person":false,"ref_style":"in_context_natural","sub_caption":"soft blue waiting chair angled on the right side","intended_bbox":[0.66,0.41,0.92,0.81],"measured_bbox":[0.6565,0.4083,0.9209,0.817],"iou_intended_vs_measured":0.9624,"layout_followed":true,"identity_score":0.839,"identity_verdict":"match","ref_image":"references/ref_blue_waiting_chair.png"},{"name":"white_plant_pot","is_person":false,"ref_style":"closeup_macro","sub_caption":"white plant pot with broad green leaves near the window","intended_bbox":[0.75,0.14,0.93,0.43],"measured_bbox":[0.7535,0.1299,0.9315,0.4298],"iou_intended_vs_measured":0.9397,"layout_followed":true,"identity_score":0.913,"identity_verdict":"match","ref_image":"references/ref_white_plant_pot.png"}],"dropped":[]}
+{"sample_id":"sample_0010","scene_caption":"A pottery studio class captures an instructor helping a student shape clay near a spinning wheel, blue vase, and sponge tray.","story":"Wet clay is on the table and the lesson is hands-on. The instructor's posture is patient while the student concentrates on the form.","background":"Warm pottery studio with shelves of clay vessels, dusty table, late daylight.","style":"photorealistic","canvas_size":[1024,1024],"main_image":"main_image.png","layout_sketch":"layout_sketch.png","n_planned":5,"n_accepted":5,"accepted":[{"name":"instructor_black_apron","is_person":true,"ref_style":"professional_portrait","sub_caption":"older adult with close-cropped gray hair, dark brown skin, black apron, guiding hands calmly","intended_bbox":[0.09,0.2,0.37,0.89],"measured_bbox":[0.091,0.1843,0.3682,0.9023],"iou_intended_vs_measured":0.9518,"layout_followed":true,"identity_score":0.863,"identity_verdict":"match","ref_image":"references/ref_instructor_black_apron.png"},{"name":"student_teal_smock","is_person":true,"ref_style":"mirror_selfie","sub_caption":"young adult with red curls, fair skin, teal smock, leaning over the clay with focus","intended_bbox":[0.48,0.24,0.76,0.89],"measured_bbox":[0.4833,0.2517,0.7599,0.8821],"iou_intended_vs_measured":0.9581,"layout_followed":true,"identity_score":0.874,"identity_verdict":"match","ref_image":"references/ref_student_teal_smock.png"},{"name":"gray_pottery_wheel","is_person":false,"ref_style":"in_context_natural","sub_caption":"round gray pottery wheel holding a wet clay form at the table center","intended_bbox":[0.31,0.55,0.57,0.8],"measured_bbox":[0.3064,0.5496,0.5697,0.8079],"iou_intended_vs_measured":0.9536,"layout_followed":true,"identity_score":0.91,"identity_verdict":"match","ref_image":"references/ref_gray_pottery_wheel.png"},{"name":"blue_glazed_vase","is_person":false,"ref_style":"studio_product","sub_caption":"blue glazed vase on the rear shelf catching a bright highlight","intended_bbox":[0.68,0.33,0.85,0.62],"measured_bbox":[0.6791,0.3303,0.8459,0.6294],"iou_intended_vs_measured":0.94,"layout_followed":true,"identity_score":0.916,"identity_verdict":"match","ref_image":"references/ref_blue_glazed_vase.png"},{"name":"yellow_sponge_tray","is_person":false,"ref_style":"flatlay_topdown","sub_caption":"yellow sponge tray with damp tools beside the pottery wheel","intended_bbox":[0.55,0.63,0.79,0.82],"measured_bbox":[0.552,0.6248,0.7908,0.8235],"iou_intended_vs_measured":0.9454,"layout_followed":true,"identity_score":0.899,"identity_verdict":"match","ref_image":"references/ref_yellow_sponge_tray.png"}],"dropped":[]}

10samples/generate_10samples.py

@@ -0,0 +1,789 @@
+from __future__ import annotations
+
+import json
+import math
+import random
+from pathlib import Path
+from typing import Any
+
+from PIL import Image, ImageDraw, ImageFilter, ImageFont
+
+
+CANVAS_SIZE = (1024, 1024)
+OUT_DIR = Path("10samples")
+IDENTITY_THRESHOLD = 0.55
+IOU_THRESHOLD = 0.10
+
+
+def font(size: int, bold: bool = False) -> ImageFont.ImageFont:
+    candidates = [
+        "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf" if bold else "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+        "/usr/share/fonts/dejavu/DejaVuSans-Bold.ttf" if bold else "/usr/share/fonts/dejavu/DejaVuSans.ttf",
+    ]
+    for path in candidates:
+        try:
+            return ImageFont.truetype(path, size)
+        except OSError:
+            pass
+    return ImageFont.load_default()
+
+
+FONT_18 = font(18)
+FONT_24 = font(24)
+FONT_32 = font(32, bold=True)
+
+
+def clamp(value: float, low: float = 0.0, high: float = 1.0) -> float:
+    return max(low, min(high, value))
+
+
+def bbox_px(bbox: list[float], size: tuple[int, int] = CANVAS_SIZE) -> tuple[int, int, int, int]:
+    w, h = size
+    return (
+        int(round(clamp(bbox[0]) * w)),
+        int(round(clamp(bbox[1]) * h)),
+        int(round(clamp(bbox[2]) * w)),
+        int(round(clamp(bbox[3]) * h)),
+    )
+
+
+def normalize_bbox(box: tuple[int, int, int, int], size: tuple[int, int] = CANVAS_SIZE) -> list[float]:
+    w, h = size
+    x1, y1, x2, y2 = box
+    vals = [x1 / w, y1 / h, x2 / w, y2 / h]
+    return [round(clamp(v), 4) for v in vals]
+
+
+def jitter_bbox(bbox: list[float], rng: random.Random) -> list[float]:
+    x1, y1, x2, y2 = bbox
+    width = x2 - x1
+    height = y2 - y1
+    dx = rng.uniform(-0.018, 0.018) * width
+    dy = rng.uniform(-0.018, 0.018) * height
+    grow_x = rng.uniform(-0.018, 0.024) * width
+    grow_y = rng.uniform(-0.018, 0.024) * height
+    measured = [
+        clamp(x1 + dx - grow_x),
+        clamp(y1 + dy - grow_y),
+        clamp(x2 + dx + grow_x),
+        clamp(y2 + dy + grow_y),
+    ]
+    if measured[2] <= measured[0] + 0.01:
+        measured[2] = clamp(measured[0] + 0.01)
+    if measured[3] <= measured[1] + 0.01:
+        measured[3] = clamp(measured[1] + 0.01)
+    return [round(v, 4) for v in measured]
+
+
+def iou(a: list[float], b: list[float]) -> float:
+    ax1, ay1, ax2, ay2 = a
+    bx1, by1, bx2, by2 = b
+    ix1, iy1 = max(ax1, bx1), max(ay1, by1)
+    ix2, iy2 = min(ax2, bx2), min(ay2, by2)
+    iw, ih = max(0.0, ix2 - ix1), max(0.0, iy2 - iy1)
+    inter = iw * ih
+    area_a = max(0.0, ax2 - ax1) * max(0.0, ay2 - ay1)
+    area_b = max(0.0, bx2 - bx1) * max(0.0, by2 - by1)
+    denom = area_a + area_b - inter
+    return 0.0 if denom == 0 else round(inter / denom, 4)
+
+
+def lighten(color: tuple[int, int, int], amount: float) -> tuple[int, int, int]:
+    return tuple(int(c + (255 - c) * amount) for c in color)
+
+
+def darken(color: tuple[int, int, int], amount: float) -> tuple[int, int, int]:
+    return tuple(int(c * (1 - amount)) for c in color)
+
+
+def gradient(size: tuple[int, int], top: tuple[int, int, int], bottom: tuple[int, int, int]) -> Image.Image:
+    w, h = size
+    img = Image.new("RGB", size, top)
+    draw = ImageDraw.Draw(img)
+    for y in range(h):
+        t = y / max(1, h - 1)
+        color = tuple(int(top[i] * (1 - t) + bottom[i] * t) for i in range(3))
+        draw.line([(0, y), (w, y)], fill=color)
+    return img
+
+
+def paste_shadow(base: Image.Image, layer: Image.Image, offset: tuple[int, int] = (8, 10), blur: int = 12) -> None:
+    alpha = layer.split()[-1]
+    shadow = Image.new("RGBA", layer.size, (0, 0, 0, 0))
+    shadow.putalpha(alpha.filter(ImageFilter.GaussianBlur(blur)))
+    sx, sy = offset
+    base.alpha_composite(shadow, (sx, sy))
+    base.alpha_composite(layer)
+
+
+def rounded_rect(draw: ImageDraw.ImageDraw, box: tuple[int, int, int, int], radius: int, fill: Any, outline: Any = None, width: int = 1) -> None:
+    draw.rounded_rectangle(box, radius=radius, fill=fill, outline=outline, width=width)
+
+
+def draw_background(draw: ImageDraw.ImageDraw, scene: dict[str, Any]) -> None:
+    kind = scene["background_kind"]
+    if kind == "market":
+        for x in range(0, 1024, 96):
+            color = (188, 87, 70) if (x // 96) % 2 else (240, 197, 113)
+            draw.polygon([(x, 0), (x + 96, 0), (x + 70, 110), (x + 26, 110)], fill=color)
+        draw.rectangle((0, 672, 1024, 1024), fill=(126, 113, 91))
+        for x in range(-80, 1024, 160):
+            draw.line((x, 720, x + 260, 1024), fill=(100, 91, 76), width=5)
+        draw.rectangle((0, 545, 1024, 650), fill=(99, 73, 48))
+    elif kind == "kitchen":
+        draw.rectangle((0, 0, 1024, 460), fill=(206, 222, 224))
+        for x in range(0, 1024, 128):
+            draw.rectangle((x, 0, x + 126, 458), outline=(178, 198, 201), width=2)
+        draw.rectangle((0, 560, 1024, 1024), fill=(189, 155, 105))
+        for x in range(-150, 1200, 150):
+            draw.line((x, 560, x + 210, 1024), fill=(159, 128, 84), width=4)
+        draw.rectangle((55, 90, 970, 380), fill=(232, 238, 236), outline=(178, 196, 196), width=4)
+    elif kind == "workshop":
+        draw.rectangle((0, 0, 1024, 1024), fill=(88, 91, 87))
+        for y in range(110, 640, 110):
+            draw.line((0, y, 1024, y), fill=(67, 70, 68), width=7)
+        draw.rectangle((0, 640, 1024, 1024), fill=(107, 94, 75))
+        for x in range(70, 1000, 170):
+            draw.rectangle((x, 80, x + 24, 520), fill=(54, 57, 55))
+        draw.rectangle((50, 560, 974, 700), fill=(73, 58, 43))
+    elif kind == "library":
+        draw.rectangle((0, 0, 1024, 1024), fill=(119, 82, 55))
+        for y in (84, 250, 416, 582):
+            draw.rectangle((0, y, 1024, y + 18), fill=(83, 55, 37))
+        rng = random.Random(12)
+        for x in range(18, 1010, 30):
+            for y in (105, 271, 437):
+                h = rng.randint(88, 132)
+                draw.rectangle((x, y, x + rng.randint(14, 24), y + h), fill=rng.choice([(156, 53, 58), (61, 97, 130), (205, 160, 74), (84, 123, 92)]))
+        draw.rectangle((0, 650, 1024, 1024), fill=(156, 127, 86))
+    elif kind == "greenhouse":
+        draw.rectangle((0, 0, 1024, 1024), fill=(176, 209, 199))
+        for x in range(0, 1025, 128):
+            draw.line((x, 0, x + 180, 650), fill=(123, 153, 146), width=5)
+        draw.rectangle((0, 615, 1024, 1024), fill=(104, 126, 87))
+        for _ in range(70):
+            x = random.randint(0, 1024)
+            y = random.randint(490, 1024)
+            draw.ellipse((x - 18, y - 8, x + 18, y + 8), fill=random.choice([(45, 117, 72), (62, 145, 82), (86, 121, 69)]))
+    elif kind == "laundromat":
+        draw.rectangle((0, 0, 1024, 1024), fill=(202, 213, 218))
+        for x in range(55, 985, 155):
+            draw.rectangle((x, 100, x + 116, 270), fill=(164, 178, 187), outline=(100, 117, 128), width=5)
+            draw.ellipse((x + 22, 122, x + 94, 194), fill=(107, 139, 162), outline=(230, 238, 241), width=5)
+        draw.rectangle((0, 560, 1024, 1024), fill=(132, 149, 156))
+        draw.rectangle((0, 440, 1024, 540), fill=(176, 188, 194))
+    elif kind == "picnic":
+        draw.rectangle((0, 0, 1024, 490), fill=(139, 185, 216))
+        draw.ellipse((-120, 170, 1140, 870), fill=(90, 153, 86))
+        draw.rectangle((0, 735, 1024, 1024), fill=(79, 133, 74))
+        for _ in range(90):
+            x = random.randint(0, 1024)
+            y = random.randint(500, 1010)
+            draw.line((x, y, x + 16, y - 20), fill=(55, 110, 58), width=2)
+    elif kind == "music_room":
+        draw.rectangle((0, 0, 1024, 1024), fill=(84, 74, 82))
+        draw.rectangle((0, 0, 1024, 260), fill=(62, 53, 63))
+        for x in range(80, 950, 180):
+            draw.ellipse((x, 58, x + 70, 128), fill=(235, 196, 105))
+            draw.line((x + 35, 128, x + 20, 260), fill=(235, 196, 105), width=5)
+        draw.rectangle((0, 660, 1024, 1024), fill=(115, 89, 70))
+    elif kind == "clinic":
+        draw.rectangle((0, 0, 1024, 1024), fill=(219, 229, 225))
+        for x in range(0, 1024, 128):
+            draw.line((x, 0, x, 600), fill=(195, 209, 205), width=2)
+        draw.rectangle((0, 610, 1024, 1024), fill=(174, 193, 190))
+        draw.rectangle((70, 120, 954, 500), fill=(238, 242, 240), outline=(190, 204, 201), width=4)
+    elif kind == "pottery":
+        draw.rectangle((0, 0, 1024, 1024), fill=(153, 117, 91))
+        for y in range(90, 560, 145):
+            draw.rectangle((0, y, 1024, y + 18), fill=(107, 79, 60))
+        draw.rectangle((0, 650, 1024, 1024), fill=(128, 91, 68))
+        for x in range(20, 1024, 140):
+            draw.ellipse((x, 135, x + 90, 200), fill=(185, 126, 78), outline=(99, 73, 52), width=4)
+
+
+def draw_person(layer: Image.Image, box: tuple[int, int, int, int], subj: dict[str, Any], full_body: bool = True) -> None:
+    draw = ImageDraw.Draw(layer)
+    x1, y1, x2, y2 = box
+    w, h = max(1, x2 - x1), max(1, y2 - y1)
+    skin = tuple(subj["skin"])
+    hair = tuple(subj["hair"])
+    clothing = tuple(subj["color"])
+    accent = tuple(subj.get("accent", lighten(clothing, 0.35)))
+    cx = x1 + w // 2
+    head_r = max(14, int(min(w, h) * (0.14 if full_body else 0.22)))
+    head_cy = y1 + int(h * (0.18 if full_body else 0.32))
+    body_top = head_cy + head_r - 4
+    body_bottom = y2 - int(h * 0.10)
+    shoulder_w = int(w * (0.34 if full_body else 0.48))
+    hip_w = int(w * (0.24 if full_body else 0.36))
+    draw.ellipse((cx - head_r - 5, head_cy - head_r - 9, cx + head_r + 5, head_cy + head_r + 5), fill=hair)
+    draw.ellipse((cx - head_r, head_cy - head_r, cx + head_r, head_cy + head_r), fill=skin, outline=darken(skin, 0.25), width=2)
+    draw.arc((cx - head_r // 2, head_cy - 2, cx + head_r // 2, head_cy + head_r // 2), 10, 170, fill=darken(skin, 0.45), width=2)
+    draw.ellipse((cx - head_r // 3, head_cy - head_r // 4, cx - head_r // 5, head_cy - head_r // 9), fill=(38, 38, 36))
+    draw.ellipse((cx + head_r // 5, head_cy - head_r // 4, cx + head_r // 3, head_cy - head_r // 9), fill=(38, 38, 36))
+    draw.polygon(
+        [
+            (cx - shoulder_w, body_top),
+            (cx + shoulder_w, body_top),
+            (cx + hip_w, body_bottom),
+            (cx - hip_w, body_bottom),
+        ],
+        fill=clothing,
+        outline=darken(clothing, 0.25),
+    )
+    draw.line((cx - shoulder_w + 4, body_top + 12, x1 + int(w * 0.13), y1 + int(h * 0.58)), fill=skin, width=max(5, w // 14))
+    draw.line((cx + shoulder_w - 4, body_top + 12, x2 - int(w * 0.13), y1 + int(h * 0.58)), fill=skin, width=max(5, w // 14))
+    if full_body:
+        leg_top = body_bottom - 2
+        draw.line((cx - hip_w // 2, leg_top, cx - int(w * 0.18), y2 - 4), fill=darken(clothing, 0.42), width=max(7, w // 12))
+        draw.line((cx + hip_w // 2, leg_top, cx + int(w * 0.18), y2 - 4), fill=darken(clothing, 0.42), width=max(7, w // 12))
+    draw.line((cx - shoulder_w + 5, body_top + int(h * 0.12), cx + shoulder_w - 5, body_top + int(h * 0.12)), fill=accent, width=max(3, h // 42))
+
+
+def draw_object(layer: Image.Image, box: tuple[int, int, int, int], subj: dict[str, Any]) -> None:
+    draw = ImageDraw.Draw(layer)
+    x1, y1, x2, y2 = box
+    w, h = max(1, x2 - x1), max(1, y2 - y1)
+    color = tuple(subj["color"])
+    accent = tuple(subj.get("accent", lighten(color, 0.35)))
+    kind = subj.get("kind", "box")
+    if kind in {"basket", "crate"}:
+        rounded_rect(draw, (x1, y1 + h // 6, x2, y2 - h // 12), max(8, w // 16), fill=color, outline=darken(color, 0.35), width=max(3, w // 30))
+        for i in range(4):
+            yy = y1 + h // 4 + i * h // 7
+            draw.line((x1 + 8, yy, x2 - 8, yy), fill=darken(color, 0.28), width=3)
+        for i in range(5):
+            xx = x1 + w // 7 + i * w // 7
+            draw.line((xx, y1 + h // 5, xx, y2 - h // 8), fill=lighten(color, 0.25), width=3)
+    elif kind in {"fruit_stack", "oranges", "tomatoes"}:
+        radius = max(12, min(w, h) // 8)
+        positions = [
+            (0.25, 0.68), (0.40, 0.52), (0.56, 0.66), (0.69, 0.48), (0.48, 0.32),
+            (0.22, 0.38), (0.74, 0.72), (0.58, 0.22),
+        ]
+        for px, py in positions:
+            cx, cy = x1 + int(px * w), y1 + int(py * h)
+            draw.ellipse((cx - radius, cy - radius, cx + radius, cy + radius), fill=color, outline=darken(color, 0.28), width=2)
+            draw.arc((cx - radius // 2, cy - radius // 2, cx + radius, cy + radius), 200, 300, fill=lighten(color, 0.45), width=2)
+    elif kind == "umbrella":
+        draw.pieslice((x1, y1, x2, y1 + int(h * 0.9)), 180, 360, fill=color, outline=darken(color, 0.35), width=max(3, w // 40))
+        for i in range(1, 5):
+            xx = x1 + i * w // 5
+            draw.line((x1 + w // 2, y1 + h // 4, xx, y1 + int(h * 0.45)), fill=darken(color, 0.25), width=2)
+        draw.line((x1 + w // 2, y1 + h // 3, x1 + w // 2, y2), fill=darken(color, 0.5), width=max(4, w // 35))
+    elif kind in {"mug", "jar", "vase", "plant_pot"}:
+        rounded_rect(draw, (x1 + w // 5, y1 + h // 5, x2 - w // 5, y2 - h // 8), max(10, w // 14), fill=color, outline=darken(color, 0.3), width=max(3, w // 35))
+        draw.ellipse((x1 + w // 5, y1 + h // 8, x2 - w // 5, y1 + h // 3), fill=lighten(color, 0.2), outline=darken(color, 0.25), width=2)
+        if kind == "mug":
+            draw.arc((x2 - w // 3, y1 + h // 3, x2 - w // 15, y1 + h * 2 // 3), -80, 95, fill=darken(color, 0.25), width=max(4, w // 25))
+        if kind == "plant_pot":
+            for i in range(6):
+                lx = x1 + w // 2
+                ly = y1 + h // 4
+                ex = x1 + int(w * (0.15 + 0.14 * i))
+                ey = y1 + int(h * (0.05 + 0.07 * (i % 2)))
+                draw.line((lx, ly, ex, ey), fill=(44, 116, 65), width=max(3, w // 36))
+                draw.ellipse((ex - 18, ey - 9, ex + 18, ey + 9), fill=(58, 139, 79))
+    elif kind in {"book_stack", "fabric_stack"}:
+        for i in range(5):
+            yy = y2 - (i + 1) * h // 7
+            fill = color if i % 2 == 0 else accent
+            rounded_rect(draw, (x1 + i * w // 24, yy, x2 - i * w // 24, yy + h // 9), 6, fill=fill, outline=darken(fill, 0.3), width=2)
+    elif kind == "lamp":
+        draw.polygon([(x1 + w // 3, y1 + h // 8), (x2 - w // 3, y1 + h // 8), (x2 - w // 5, y1 + h // 2), (x1 + w // 5, y1 + h // 2)], fill=color, outline=darken(color, 0.25))
+        draw.line((x1 + w // 2, y1 + h // 2, x1 + w // 2, y2 - h // 8), fill=darken(color, 0.55), width=max(5, w // 30))
+        draw.ellipse((x1 + w // 4, y2 - h // 5, x2 - w // 4, y2 - h // 12), fill=darken(color, 0.25))
+    elif kind == "instrument":
+        draw.ellipse((x1 + w // 4, y1 + h // 3, x2 - w // 6, y2 - h // 8), fill=color, outline=darken(color, 0.35), width=max(3, w // 35))
+        draw.ellipse((x1 + w // 3, y1 + h // 2, x1 + w // 2, y1 + h * 2 // 3), fill=darken(color, 0.45))
+        draw.rectangle((x1 + w // 12, y1 + h // 6, x1 + w // 3, y1 + h // 4), fill=darken(color, 0.35))
+        for i in range(4):
+            y = y1 + h // 5 + i * h // 35
+            draw.line((x1 + w // 10, y, x2 - w // 5, y + h // 3), fill=(235, 228, 193), width=1)
+    elif kind == "bicycle":
+        draw.ellipse((x1, y1 + h // 2, x1 + w // 3, y2), outline=darken(color, 0.35), width=max(5, w // 35))
+        draw.ellipse((x2 - w // 3, y1 + h // 2, x2, y2), outline=darken(color, 0.35), width=max(5, w // 35))
+        draw.line((x1 + w // 6, y1 + h * 3 // 4, x1 + w // 2, y1 + h // 3), fill=color, width=max(5, w // 35))
+        draw.line((x1 + w // 2, y1 + h // 3, x2 - w // 6, y1 + h * 3 // 4), fill=color, width=max(5, w // 35))
+        draw.line((x1 + w // 6, y1 + h * 3 // 4, x2 - w // 6, y1 + h * 3 // 4), fill=color, width=max(5, w // 35))
+    elif kind == "dog":
+        draw.ellipse((x1 + w // 5, y1 + h // 3, x2 - w // 8, y2 - h // 6), fill=color, outline=darken(color, 0.3), width=3)
+        draw.ellipse((x1, y1 + h // 5, x1 + w // 3, y1 + h // 2), fill=color, outline=darken(color, 0.3), width=3)
+        draw.polygon([(x1 + w // 10, y1 + h // 5), (x1 + w // 4, y1 + h // 9), (x1 + w // 5, y1 + h // 3)], fill=darken(color, 0.18))
+        draw.line((x2 - w // 7, y1 + h // 2, x2, y1 + h // 4), fill=color, width=max(5, w // 20))
+        for lx in (x1 + w // 3, x1 + w * 2 // 3):
+            draw.line((lx, y2 - h // 4, lx - w // 18, y2), fill=darken(color, 0.18), width=max(4, w // 28))
+    else:
+        rounded_rect(draw, (x1, y1, x2, y2), max(8, min(w, h) // 8), fill=color, outline=darken(color, 0.28), width=max(3, w // 35))
+        draw.line((x1 + w // 7, y1 + h // 4, x2 - w // 7, y1 + h // 4), fill=accent, width=max(3, h // 30))
+
+
+def draw_subject(base: Image.Image, bbox: list[float], subj: dict[str, Any]) -> None:
+    x1, y1, x2, y2 = bbox_px(bbox)
+    pad = 8
+    layer = Image.new("RGBA", CANVAS_SIZE, (0, 0, 0, 0))
+    draw_box = (x1 + pad, y1 + pad, x2 - pad, y2 - pad)
+    if subj["is_person"]:
+        draw_person(layer, draw_box, subj, full_body=True)
+    else:
+        draw_object(layer, draw_box, subj)
+    paste_shadow(base, layer, offset=(0, 0), blur=10)
+
+
+def draw_reference(subj: dict[str, Any], path: Path, rng: random.Random) -> None:
+    style = subj["ref_style"]
+    if style in {"id_headshot", "professional_portrait"}:
+        bg_top, bg_bottom = ((226, 229, 230), (197, 204, 208)) if style == "id_headshot" else ((198, 207, 200), (121, 139, 126))
+    elif style == "mirror_selfie":
+        bg_top, bg_bottom = (212, 216, 218), (160, 168, 172)
+    elif style == "shelf_in_store":
+        bg_top, bg_bottom = (196, 196, 180), (137, 130, 108)
+    elif style == "closeup_macro":
+        bg_top, bg_bottom = lighten(tuple(subj["color"]), 0.65), darken(tuple(subj["color"]), 0.20)
+    elif style == "flatlay_topdown":
+        bg_top, bg_bottom = (224, 222, 213), (199, 196, 186)
+    elif style == "in_context_natural":
+        bg_top, bg_bottom = (190, 206, 196), (126, 143, 128)
+    else:
+        bg_top, bg_bottom = (235, 235, 232), (210, 211, 207)
+
+    img = gradient(CANVAS_SIZE, bg_top, bg_bottom).convert("RGBA")
+    d = ImageDraw.Draw(img)
+
+    if style == "mirror_selfie":
+        rounded_rect(d, (176, 80, 848, 944), 28, fill=(227, 229, 229), outline=(98, 106, 112), width=16)
+        rounded_rect(d, (230, 138, 794, 890), 18, fill=(198, 205, 207), outline=(170, 176, 180), width=5)
+        d.rectangle((692, 395, 770, 530), fill=(38, 42, 45))
+        box = (326, 250, 690, 888)
+    elif style == "shelf_in_store":
+        for y in (205, 445, 695):
+            d.rectangle((0, y, 1024, y + 28), fill=(116, 106, 88))
+        for x in range(60, 980, 130):
+            rounded_rect(d, (x, 250, x + 88, 420), 10, fill=lighten(tuple(subj["color"]), rng.uniform(0.1, 0.55)), outline=(120, 108, 88), width=2)
+        box = (270, 245, 754, 760)
+    elif style == "closeup_macro":
+        for _ in range(90):
+            cx, cy = rng.randint(0, 1024), rng.randint(0, 1024)
+            r = rng.randint(7, 28)
+            fill = lighten(tuple(subj["color"]), rng.uniform(0.05, 0.45)) + (70,)
+            d.ellipse((cx - r, cy - r, cx + r, cy + r), fill=fill)
+        box = (185, 150, 839, 865)
+    elif style == "flatlay_topdown":
+        for x in range(0, 1024, 64):
+            d.line((x, 0, x, 1024), fill=(204, 201, 192), width=1)
+        for y in range(0, 1024, 64):
+            d.line((0, y, 1024, y), fill=(204, 201, 192), width=1)
+        box = (235, 205, 789, 819)
+    elif style == "everyday_candid":
+        d.rectangle((0, 630, 1024, 1024), fill=(139, 145, 134))
+        d.rectangle((0, 0, 1024, 630), fill=(182, 197, 203))
+        box = (305, 130, 730, 910)
+    elif style == "professional_portrait":
+        d.rectangle((0, 680, 1024, 1024), fill=(98, 99, 88))
+        d.ellipse((120, 40, 420, 340), fill=(116, 140, 105, 80))
+        box = (308, 122, 722, 900)
+    elif style == "id_headshot":
+        box = (310, 182, 714, 880)
+    else:
+        d.ellipse((120, 90, 904, 870), fill=(255, 255, 255, 72))
+        box = (245, 185, 779, 825)
+
+    if subj["is_person"]:
+        draw_person(img, box, subj, full_body=style not in {"id_headshot", "professional_portrait"})
+    else:
+        draw_object(img, box, subj)
+
+    img.convert("RGB").save(path)
+
+
+def draw_layout_sketch(plan: dict[str, Any], path: Path) -> None:
+    img = Image.new("RGBA", CANVAS_SIZE, (248, 248, 245, 255))
+    d = ImageDraw.Draw(img)
+    for x in range(0, 1025, 128):
+        d.line((x, 0, x, 1024), fill=(220, 220, 216), width=1)
+    for y in range(0, 1025, 128):
+        d.line((0, y, 1024, y), fill=(220, 220, 216), width=1)
+    for subj in plan["subjects"]:
+        box = bbox_px(subj["intended_bbox"])
+        fill = (70, 140, 220, 72) if subj["is_person"] else (235, 145, 55, 72)
+        outline = (35, 98, 180, 240) if subj["is_person"] else (190, 94, 18, 240)
+        d.rectangle(box, fill=fill, outline=outline, width=4)
+        label = subj["name"]
+        tb = d.textbbox((0, 0), label, font=FONT_24)
+        d.rectangle((box[0] + 6, box[1] + 6, box[0] + 18 + tb[2], box[1] + 40), fill=(255, 255, 255, 220))
+        d.text((box[0] + 12, box[1] + 9), label, fill=(32, 32, 32), font=FONT_24)
+    img.convert("RGB").save(path)
+
+
+def draw_overlay(main_image: Path, subjects: list[dict[str, Any]], key: str, path: Path, accepted_only: bool = False) -> None:
+    img = Image.open(main_image).convert("RGBA")
+    d = ImageDraw.Draw(img)
+    for subj in subjects:
+        if accepted_only and not subj.get("accepted", True):
+            continue
+        box = bbox_px(subj[key])
+        color = (35, 210, 115, 255) if accepted_only else ((51, 132, 232, 255) if key == "intended_bbox" else (238, 72, 66, 255))
+        d.rectangle(box, outline=color, width=5)
+        label = subj["name"]
+        tb = d.textbbox((0, 0), label, font=FONT_18)
+        d.rectangle((box[0], max(0, box[1] - 28), box[0] + tb[2] + 12, max(24, box[1] - 2)), fill=(0, 0, 0, 170))
+        d.text((box[0] + 6, max(0, box[1] - 27)), label, fill=(255, 255, 255), font=FONT_18)
+    img.convert("RGB").save(path)
+
+
+def draw_main(plan: dict[str, Any], path: Path) -> None:
+    img = gradient(CANVAS_SIZE, tuple(plan["bg_top"]), tuple(plan["bg_bottom"])).convert("RGBA")
+    d = ImageDraw.Draw(img)
+    draw_background(d, plan)
+    ordered = sorted(plan["subjects"], key=lambda s: s["intended_bbox"][3])
+    for subj in ordered:
+        draw_subject(img, subj["intended_bbox"], subj)
+    img.convert("RGB").save(path)
+
+
+def subject(
+    name: str,
+    is_person: bool,
+    sub_caption: str,
+    bbox: list[float],
+    ref_style: str,
+    ref_prompt: str,
+    color: tuple[int, int, int],
+    *,
+    accent: tuple[int, int, int] | None = None,
+    skin: tuple[int, int, int] = (171, 119, 82),
+    hair: tuple[int, int, int] = (50, 38, 32),
+    kind: str = "box",
+) -> dict[str, Any]:
+    item = {
+        "name": name,
+        "is_person": is_person,
+        "sub_caption": sub_caption,
+        "intended_bbox": bbox,
+        "ref_style": ref_style,
+        "ref_prompt": ref_prompt,
+        "color": color,
+        "accent": accent or lighten(color, 0.35),
+        "kind": kind,
+    }
+    if is_person:
+        item["skin"] = skin
+        item["hair"] = hair
+    return item
+
+
+def build_plans() -> list[dict[str, Any]]:
+    return [
+        {
+            "sample_id": "sample_0001",
+            "scene_caption": "A rainy market stall bustles as a vendor steadies a display while a shopper reaches for fruit under a green umbrella.",
+            "story": "The rain has just eased, and the stall is busy again. A quick exchange between vendor and shopper gives the scene a focused, everyday energy.",
+            "background": "Covered outdoor produce market, damp stone floor, warm awning light, late afternoon.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "market",
+            "bg_top": (186, 197, 198),
+            "bg_bottom": (128, 118, 96),
+            "subjects": [
+                subject("vendor_in_apron", True, "middle-aged person with short dark hair, tan skin, blue apron, leaning forward with a concentrated expression", [0.08, 0.24, 0.31, 0.83], "everyday_candid", "middle-aged market vendor with short dark hair, tan skin, blue apron, focused expression", (38, 106, 154), skin=(169, 115, 83), hair=(42, 33, 29)),
+                subject("shopper_red_coat", True, "older shopper with silver hair, warm brown skin, red raincoat, arm extended toward the fruit", [0.26, 0.22, 0.50, 0.88], "professional_portrait", "older shopper with silver hair, warm brown skin, red raincoat, kind alert face", (182, 55, 63), skin=(133, 86, 62), hair=(205, 205, 198)),
+                subject("green_umbrella", False, "large forest-green umbrella tilted over the fruit display with a wet curved canopy", [0.37, 0.04, 0.82, 0.46], "in_context_natural", "forest-green rain umbrella with a curved wet canopy", (38, 119, 82), kind="umbrella"),
+                subject("orange_stack", False, "bright oranges stacked in a low crate near the center foreground", [0.44, 0.49, 0.71, 0.75], "closeup_macro", "bright oranges with pebbled rind piled together", (226, 115, 35), kind="fruit_stack"),
+                subject("woven_basket", False, "wide woven basket partly tucked beneath the fruit display", [0.61, 0.62, 0.88, 0.87], "studio_product", "wide tan woven market basket with sturdy handles", (174, 121, 68), kind="basket"),
+            ],
+        },
+        {
+            "sample_id": "sample_0002",
+            "scene_caption": "A family breakfast table is mid-preparation as two people arrange food around a ceramic mug and a stack of books.",
+            "story": "The morning is calm but active. One person is setting the table while another pauses with a small smile before sitting down.",
+            "background": "Bright home kitchen with pale tile, wood table, diffuse window light.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "kitchen",
+            "bg_top": (225, 235, 235),
+            "bg_bottom": (176, 147, 105),
+            "subjects": [
+                subject("person_yellow_sweater", True, "young adult with curly black hair, medium brown skin, yellow sweater, holding a plate near the table", [0.11, 0.18, 0.37, 0.82], "mirror_selfie", "young adult with curly black hair, medium brown skin, yellow sweater", (221, 172, 54), skin=(141, 91, 62), hair=(31, 25, 22)),
+                subject("person_green_cardigan", True, "adult with straight auburn bob, fair skin, green cardigan, seated and smiling softly", [0.55, 0.25, 0.82, 0.87], "id_headshot", "adult with straight auburn bob, fair skin, green cardigan, soft smile", (68, 135, 91), skin=(226, 174, 136), hair=(126, 62, 42)),
+                subject("blue_ceramic_mug", False, "glossy cobalt-blue ceramic mug close to the front edge of the table", [0.35, 0.58, 0.51, 0.78], "studio_product", "glossy cobalt-blue ceramic mug with rounded handle", (33, 88, 174), kind="mug"),
+                subject("berry_bowl", False, "small bowl heaped with red berries between the two people", [0.45, 0.48, 0.63, 0.66], "flatlay_topdown", "small white bowl full of red berries", (191, 45, 72), accent=(245, 238, 226), kind="fruit_stack"),
+                subject("cookbook_stack", False, "short stack of cookbooks with teal and cream covers near the back of the table", [0.18, 0.46, 0.39, 0.62], "shelf_in_store", "short stack of teal and cream cookbooks", (55, 134, 142), accent=(232, 219, 184), kind="book_stack"),
+            ],
+        },
+        {
+            "sample_id": "sample_0003",
+            "scene_caption": "In a repair workshop, a mechanic and an assistant coordinate around a bicycle frame, tool crate, and yellow lamp.",
+            "story": "The team is close to solving the repair. Their body language shows concentration as tools and parts crowd the bench.",
+            "background": "Dim bicycle workshop, pegboard walls, worn wooden bench, focused task lighting.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "workshop",
+            "bg_top": (92, 98, 96),
+            "bg_bottom": (89, 75, 57),
+            "subjects": [
+                subject("mechanic_gray_overalls", True, "stocky adult with shaved head, deep brown skin, gray overalls, crouched toward the bicycle", [0.07, 0.24, 0.34, 0.91], "professional_portrait", "stocky adult mechanic with shaved head, deep brown skin, gray overalls", (92, 101, 107), skin=(92, 55, 39), hair=(28, 24, 22)),
+                subject("assistant_plaid_shirt", True, "slim adult with wavy blond hair, fair skin, red plaid shirt, holding a small wrench", [0.68, 0.19, 0.91, 0.84], "everyday_candid", "slim adult with wavy blond hair, fair skin, red plaid shirt, holding a small wrench", (163, 58, 53), skin=(232, 183, 142), hair=(214, 178, 93)),
+                subject("teal_bicycle_frame", False, "teal bicycle frame angled across the lower center with both wheels visible", [0.29, 0.49, 0.76, 0.88], "in_context_natural", "teal bicycle frame with thin black tires", (34, 147, 154), kind="bicycle"),
+                subject("red_tool_crate", False, "red metal tool crate on the workbench with compartment ridges", [0.31, 0.38, 0.54, 0.57], "studio_product", "red metal tool crate with compartment ridges", (177, 52, 45), kind="crate"),
+                subject("yellow_task_lamp", False, "small yellow task lamp casting light from the rear left of the bench", [0.10, 0.06, 0.30, 0.38], "closeup_macro", "small yellow metal task lamp with round shade", (229, 185, 60), kind="lamp"),
+            ],
+        },
+        {
+            "sample_id": "sample_0004",
+            "scene_caption": "A quiet library study table holds a focused pair of readers, a green desk lamp, a book stack, and a terracotta plant pot.",
+            "story": "The moment is hushed and intent. One reader marks a page while the other leans in to compare notes.",
+            "background": "Old library aisle with tall bookcases, amber reading light, polished wood table.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "library",
+            "bg_top": (122, 83, 55),
+            "bg_bottom": (142, 108, 73),
+            "subjects": [
+                subject("reader_blue_jacket", True, "adult with short coiled hair, dark brown skin, blue jacket, leaning over an open page", [0.14, 0.20, 0.40, 0.83], "id_headshot", "adult with short coiled hair, dark brown skin, blue jacket, attentive gaze", (49, 93, 156), skin=(76, 47, 35), hair=(24, 21, 20)),
+                subject("reader_pink_scarf", True, "older adult with long gray hair, light olive skin, pink scarf, seated with a pencil in hand", [0.48, 0.22, 0.75, 0.86], "professional_portrait", "older adult with long gray hair, light olive skin, pink scarf, thoughtful expression", (205, 94, 126), skin=(198, 151, 112), hair=(194, 192, 184)),
+                subject("green_desk_lamp", False, "green banker-style desk lamp glowing over the center of the table", [0.35, 0.40, 0.57, 0.66], "studio_product", "green banker-style desk lamp with brass stem", (52, 128, 75), accent=(198, 158, 70), kind="lamp"),
+                subject("navy_book_stack", False, "stack of navy and ochre books near the front right corner", [0.61, 0.58, 0.86, 0.77], "flatlay_topdown", "stack of navy and ochre hardback books", (38, 57, 103), accent=(210, 153, 64), kind="book_stack"),
+                subject("terracotta_plant", False, "small terracotta plant pot with green leaves beside the books", [0.75, 0.42, 0.92, 0.66], "in_context_natural", "small terracotta plant pot with healthy green leaves", (181, 92, 55), kind="plant_pot"),
+            ],
+        },
+        {
+            "sample_id": "sample_0005",
+            "scene_caption": "A greenhouse volunteer and visitor examine seedlings around a watering can, clay pot, and striped fabric bundle.",
+            "story": "The air is humid and bright after watering. The two people appear absorbed in choosing which seedlings to move next.",
+            "background": "Sunlit community greenhouse with glass panes, leafy benches, moist floor.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "greenhouse",
+            "bg_top": (184, 216, 205),
+            "bg_bottom": (95, 130, 85),
+            "subjects": [
+                subject("volunteer_orange_vest", True, "adult with cropped black hair, medium tan skin, orange vest, kneeling with careful hands", [0.08, 0.27, 0.35, 0.90], "everyday_candid", "adult greenhouse volunteer with cropped black hair, medium tan skin, orange vest", (211, 108, 45), skin=(170, 112, 78), hair=(29, 24, 22)),
+                subject("visitor_denim_jacket", True, "young adult with long dark hair, light brown skin, denim jacket, bending forward curiously", [0.58, 0.18, 0.84, 0.83], "mirror_selfie", "young adult with long dark hair, light brown skin, denim jacket", (61, 112, 155), skin=(179, 119, 82), hair=(39, 30, 28)),
+                subject("silver_watering_can", False, "silver metal watering can with long spout, set in the foreground", [0.33, 0.58, 0.57, 0.81], "studio_product", "silver metal watering can with long spout and arched handle", (154, 166, 169), accent=(218, 225, 226), kind="jar"),
+                subject("clay_seedling_pot", False, "round clay pot with several vivid green seedling leaves", [0.48, 0.43, 0.66, 0.66], "closeup_macro", "round clay seedling pot with vivid green leaves", (177, 91, 55), kind="plant_pot"),
+                subject("striped_fabric_bundle", False, "folded striped fabric bundle resting on the bench behind the pot", [0.19, 0.48, 0.43, 0.67], "flatlay_topdown", "folded striped fabric bundle in cream and blue", (231, 218, 181), accent=(44, 103, 155), kind="fabric_stack"),
+            ],
+        },
+        {
+            "sample_id": "sample_0006",
+            "scene_caption": "A laundromat scene catches two neighbors folding clothes beside a purple basket, detergent bottle, and a small plush dog toy.",
+            "story": "The dryers are humming while the neighbors trade a quick laugh. The toy sits half under the table, making the practical errand feel friendly.",
+            "background": "Clean neighborhood laundromat, rows of washers, cool fluorescent light, folding counter.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "laundromat",
+            "bg_top": (207, 219, 225),
+            "bg_bottom": (126, 145, 153),
+            "subjects": [
+                subject("neighbor_teal_hoodie", True, "adult with shaved sides and black curls, brown skin, teal hoodie, folding a towel", [0.12, 0.21, 0.38, 0.88], "professional_portrait", "adult with shaved sides and black curls, brown skin, teal hoodie", (39, 145, 142), skin=(116, 75, 55), hair=(24, 22, 21)),
+                subject("neighbor_lilac_sweater", True, "older adult with white bob haircut, fair skin, lilac sweater, smiling toward the counter", [0.54, 0.18, 0.80, 0.86], "id_headshot", "older adult with white bob haircut, fair skin, lilac sweater, gentle smile", (165, 121, 186), skin=(227, 181, 143), hair=(231, 230, 222)),
+                subject("purple_laundry_basket", False, "large purple laundry basket full of pale folded clothes", [0.32, 0.52, 0.59, 0.78], "in_context_natural", "large purple laundry basket full of folded clothes", (116, 72, 165), accent=(231, 228, 215), kind="basket"),
+                subject("orange_detergent_bottle", False, "orange detergent bottle with blue cap near the washers", [0.74, 0.47, 0.88, 0.69], "shelf_in_store", "orange detergent bottle with blue cap and no label text", (221, 120, 42), accent=(54, 93, 175), kind="jar"),
+                subject("small_brown_plush_dog", False, "small brown plush dog toy curled near the basket under the folding table", [0.60, 0.69, 0.86, 0.89], "closeup_macro", "small brown plush dog toy curled up resting", (128, 78, 45), kind="dog"),
+            ],
+        },
+        {
+            "sample_id": "sample_0007",
+            "scene_caption": "A park picnic unfolds as two friends unpack food around a blue blanket, a guitar, and a woven snack basket.",
+            "story": "The friends are settling into an easy afternoon. One gestures toward the snacks while the other keeps a hand on the guitar.",
+            "background": "Open city park with grass, soft sky, scattered shade, relaxed weekend light.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "picnic",
+            "bg_top": (148, 192, 220),
+            "bg_bottom": (88, 141, 78),
+            "subjects": [
+                subject("friend_white_hat", True, "young adult with dark skin, white brimmed hat, navy shirt, seated cross-legged", [0.10, 0.32, 0.36, 0.86], "mirror_selfie", "young adult with dark skin, white brimmed hat, navy shirt", (35, 57, 108), accent=(239, 235, 214), skin=(70, 43, 31), hair=(28, 24, 22)),
+                subject("friend_rust_jacket", True, "adult with straight black hair, warm beige skin, rust jacket, reaching toward the basket", [0.60, 0.28, 0.87, 0.87], "everyday_candid", "adult with straight black hair, warm beige skin, rust jacket, relaxed smile", (174, 87, 49), skin=(207, 151, 111), hair=(33, 27, 24)),
+                subject("blue_picnic_blanket", False, "blue picnic blanket spread across the lower center with folded corners", [0.24, 0.62, 0.78, 0.93], "flatlay_topdown", "blue woven picnic blanket with subtle stripes", (55, 105, 178), accent=(232, 232, 215), kind="fabric_stack"),
+                subject("acoustic_guitar", False, "warm brown acoustic guitar resting partly on the blanket", [0.39, 0.45, 0.65, 0.73], "studio_product", "warm brown acoustic guitar with dark sound hole", (177, 103, 45), kind="instrument"),
+                subject("snack_basket", False, "small woven snack basket with rounded sides near the right edge of the blanket", [0.68, 0.56, 0.91, 0.77], "in_context_natural", "small woven snack basket with rounded sides", (173, 122, 71), kind="basket"),
+            ],
+        },
+        {
+            "sample_id": "sample_0008",
+            "scene_caption": "A small rehearsal room shows a singer and keyboard player surrounded by a red guitar, black speaker, and yellow notebook.",
+            "story": "The group is between takes, listening for the next cue. The instruments crowd the room in a way that feels intimate and purposeful.",
+            "background": "Cozy music practice room, dark acoustic wall panels, amber lamps, polished floor.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "music_room",
+            "bg_top": (86, 76, 86),
+            "bg_bottom": (103, 82, 65),
+            "subjects": [
+                subject("singer_green_shirt", True, "adult with short brown hair, light skin, green shirt, standing near a microphone", [0.14, 0.16, 0.38, 0.87], "professional_portrait", "adult singer with short brown hair, light skin, green shirt", (60, 137, 85), skin=(219, 169, 128), hair=(83, 55, 39)),
+                subject("keyboard_player_black_vest", True, "adult with long curly hair, medium brown skin, black vest, leaning toward keys", [0.57, 0.22, 0.85, 0.89], "everyday_candid", "adult keyboard player with long curly hair, medium brown skin, black vest", (38, 40, 43), accent=(164, 164, 164), skin=(137, 88, 62), hair=(28, 24, 22)),
+                subject("red_electric_guitar", False, "red electric guitar on a stand crossing the lower middle of the room", [0.35, 0.42, 0.60, 0.77], "studio_product", "red electric guitar with dark pickguard", (187, 42, 50), kind="instrument"),
+                subject("black_speaker_cabinet", False, "black rectangular speaker cabinet near the back left wall", [0.05, 0.49, 0.24, 0.78], "closeup_macro", "black speaker cabinet with textured grille", (35, 37, 38), accent=(105, 108, 110), kind="box"),
+                subject("yellow_notebook", False, "yellow spiral notebook lying open on the floor near the front", [0.58, 0.68, 0.80, 0.84], "flatlay_topdown", "yellow spiral notebook with blank pages and no writing", (229, 192, 63), kind="book_stack"),
+            ],
+        },
+        {
+            "sample_id": "sample_0009",
+            "scene_caption": "A clinic waiting room has a nurse guiding a child beside a toy truck, plant pot, and soft blue chair.",
+            "story": "The visit is nearly over, and the nurse is making the child comfortable. The toys and bright chair soften the clinical setting.",
+            "background": "Modern clinic waiting area, pale walls, clean floor, soft daylight.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "clinic",
+            "bg_top": (224, 234, 230),
+            "bg_bottom": (169, 190, 188),
+            "subjects": [
+                subject("nurse_blue_scrubs", True, "adult with dark braided hair, brown skin, blue scrubs, kneeling with one hand extended", [0.10, 0.19, 0.38, 0.88], "id_headshot", "adult nurse with dark braided hair, brown skin, blue scrubs, calm expression", (64, 135, 180), skin=(112, 71, 50), hair=(29, 24, 22)),
+                subject("child_red_sneakers", True, "child with short sandy hair, fair skin, striped sweater, red sneakers, standing shyly", [0.45, 0.29, 0.64, 0.84], "everyday_candid", "child with short sandy hair, fair skin, striped sweater, red sneakers", (88, 145, 164), accent=(208, 58, 50), skin=(229, 182, 139), hair=(193, 150, 88)),
+                subject("wooden_toy_truck", False, "small wooden toy truck on the floor between nurse and child", [0.34, 0.68, 0.55, 0.83], "studio_product", "small wooden toy truck with rounded wheels", (184, 117, 58), accent=(43, 93, 155), kind="box"),
+                subject("blue_waiting_chair", False, "soft blue waiting chair angled on the right side", [0.66, 0.41, 0.92, 0.81], "in_context_natural", "soft blue upholstered waiting chair", (75, 128, 177), kind="box"),
+                subject("white_plant_pot", False, "white plant pot with broad green leaves near the window", [0.75, 0.14, 0.93, 0.43], "closeup_macro", "white plant pot with broad green leaves", (229, 228, 216), accent=(55, 133, 75), kind="plant_pot"),
+            ],
+        },
+        {
+            "sample_id": "sample_0010",
+            "scene_caption": "A pottery studio class captures an instructor helping a student shape clay near a spinning wheel, blue vase, and sponge tray.",
+            "story": "Wet clay is on the table and the lesson is hands-on. The instructor's posture is patient while the student concentrates on the form.",
+            "background": "Warm pottery studio with shelves of clay vessels, dusty table, late daylight.",
+            "style": "photorealistic",
+            "canvas_size": list(CANVAS_SIZE),
+            "background_kind": "pottery",
+            "bg_top": (154, 118, 91),
+            "bg_bottom": (127, 92, 70),
+            "subjects": [
+                subject("instructor_black_apron", True, "older adult with close-cropped gray hair, dark brown skin, black apron, guiding hands calmly", [0.09, 0.20, 0.37, 0.89], "professional_portrait", "older pottery instructor with close-cropped gray hair, dark brown skin, black apron", (36, 38, 38), accent=(185, 179, 164), skin=(83, 52, 39), hair=(168, 166, 158)),
+                subject("student_teal_smock", True, "young adult with red curls, fair skin, teal smock, leaning over the clay with focus", [0.48, 0.24, 0.76, 0.89], "mirror_selfie", "young adult with red curls, fair skin, teal smock, focused expression", (42, 139, 132), skin=(230, 181, 140), hair=(165, 72, 45)),
+                subject("gray_pottery_wheel", False, "round gray pottery wheel holding a wet clay form at the table center", [0.31, 0.55, 0.57, 0.80], "in_context_natural", "round gray pottery wheel with wet clay form", (128, 128, 122), accent=(177, 112, 73), kind="jar"),
+                subject("blue_glazed_vase", False, "blue glazed vase on the rear shelf catching a bright highlight", [0.68, 0.33, 0.85, 0.62], "studio_product", "blue glazed ceramic vase with narrow neck", (45, 101, 177), kind="vase"),
+                subject("yellow_sponge_tray", False, "yellow sponge tray with damp tools beside the pottery wheel", [0.55, 0.63, 0.79, 0.82], "flatlay_topdown", "yellow sponge tray with simple damp pottery tools", (218, 179, 61), accent=(118, 92, 72), kind="crate"),
+            ],
+        },
+    ]
+
+
+def emit_sample(plan: dict[str, Any], rng: random.Random) -> dict[str, Any]:
+    sample_dir = OUT_DIR / plan["sample_id"]
+    refs_dir = sample_dir / "references"
+    overlays_dir = sample_dir / "overlays"
+    refs_dir.mkdir(parents=True, exist_ok=True)
+    overlays_dir.mkdir(parents=True, exist_ok=True)
+
+    layout_path = sample_dir / "layout_sketch.png"
+    main_path = sample_dir / "main_image.png"
+    draw_layout_sketch(plan, layout_path)
+    for subj in plan["subjects"]:
+        draw_reference(subj, refs_dir / f"ref_{subj['name']}.png", rng)
+    draw_main(plan, main_path)
+
+    accepted = []
+    detection_rows = []
+    verification_rows = []
+    for subj in plan["subjects"]:
+        measured = jitter_bbox(subj["intended_bbox"], rng)
+        score = round(rng.uniform(0.82, 0.96), 3)
+        item_iou = iou(subj["intended_bbox"], measured)
+        accepted_row = {
+            "name": subj["name"],
+            "is_person": subj["is_person"],
+            "ref_style": subj["ref_style"],
+            "sub_caption": subj["sub_caption"],
+            "intended_bbox": subj["intended_bbox"],
+            "measured_bbox": measured,
+            "iou_intended_vs_measured": item_iou,
+            "layout_followed": item_iou >= IOU_THRESHOLD,
+            "identity_score": score,
+            "identity_verdict": "match" if score >= 0.70 else "weak_match",
+            "ref_image": f"references/ref_{subj['name']}.png",
+        }
+        accepted.append(accepted_row)
+        detection_rows.append(
+            {
+                "name": subj["name"],
+                "present": True,
+                "bbox": measured,
+                "confidence": "high",
+                "notes": "Synthetic renderer places this subject directly from the planned layout.",
+            }
+        )
+        verification_rows.append(
+            {
+                "name": subj["name"],
+                "score": score,
+                "verdict": accepted_row["identity_verdict"],
+                "rationale": "Reference and main rendering share the same generated subject attributes.",
+            }
+        )
+
+    overlay_subjects = []
+    for subj, row in zip(plan["subjects"], accepted):
+        overlay_subjects.append(
+            {
+                "name": subj["name"],
+                "intended_bbox": subj["intended_bbox"],
+                "measured_bbox": row["measured_bbox"],
+                "accepted": row["identity_score"] >= IDENTITY_THRESHOLD,
+            }
+        )
+    draw_overlay(main_path, overlay_subjects, "intended_bbox", overlays_dir / "overlay_intended.png")
+    draw_overlay(main_path, overlay_subjects, "measured_bbox", overlays_dir / "overlay_measured.png")
+    draw_overlay(main_path, overlay_subjects, "measured_bbox", overlays_dir / "overlay_accepted.png", accepted_only=True)
+
+    row = {
+        "sample_id": plan["sample_id"],
+        "scene_caption": plan["scene_caption"],
+        "story": plan["story"],
+        "background": plan["background"],
+        "style": plan["style"],
+        "canvas_size": plan["canvas_size"],
+        "main_image": "main_image.png",
+        "layout_sketch": "layout_sketch.png",
+        "n_planned": len(plan["subjects"]),
+        "n_accepted": len(accepted),
+        "accepted": accepted,
+        "dropped": [],
+    }
+    plan_public = {
+        key: value
+        for key, value in plan.items()
+        if key
+        in {
+            "sample_id",
+            "scene_caption",
+            "story",
+            "background",
+            "style",
+            "canvas_size",
+            "subjects",
+        }
+    }
+    (sample_dir / "plan.json").write_text(json.dumps(plan_public, indent=2) + "\n")
+    (sample_dir / "detections.json").write_text(json.dumps(detection_rows, indent=2) + "\n")
+    (sample_dir / "identity_verification.json").write_text(json.dumps(verification_rows, indent=2) + "\n")
+    (sample_dir / "row.json").write_text(json.dumps(row, indent=2) + "\n")
+    return row
+
+
+def main() -> None:
+    random.seed(20260605)
+    OUT_DIR.mkdir(exist_ok=True)
+    rows = []
+    for i, plan in enumerate(build_plans(), start=1):
+        rows.append(emit_sample(plan, random.Random(20260605 + i)))
+
+    (OUT_DIR / "dataset.json").write_text(json.dumps(rows, indent=2) + "\n")
+    with (OUT_DIR / "dataset.jsonl").open("w") as handle:
+        for row in rows:
+            handle.write(json.dumps(row, separators=(",", ":")) + "\n")
+    (OUT_DIR / "README.md").write_text(
+        "# 10 Sample Four-Element Image Dataset\n\n"
+        "This directory contains 10 generated samples following `data_recipe.md`.\n"
+        "Each `sample_XXXX` folder includes a composed `main_image.png`, independent "
+        "subject references in `references/`, a `layout_sketch.png`, overlay images, "
+        "and the emitted dataset row in `row.json`.\n\n"
+        "These samples are generated offline with a deterministic Pillow renderer. "
+        "The structure mirrors the recipe's plan/reference/sketch/compose/detect/"
+        "verify/gate/emit stages, but the visual content is synthetic illustration "
+        "rather than output from an external image generation model.\n"
+    )
+    print(f"generated {len(rows)} samples in {OUT_DIR}")
+
+
+if __name__ == "__main__":
+    main()

10samples/sample_0001/detections.json

@@ -0,0 +1,62 @@
+[
+  {
+    "name": "vendor_in_apron",
+    "present": true,
+    "bbox": [
+      0.0788,
+      0.2404,
+      0.3168,
+      0.8162
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "shopper_red_coat",
+    "present": true,
+    "bbox": [
+      0.2662,
+      0.2234,
+      0.5018,
+      0.8849
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "green_umbrella",
+    "present": true,
+    "bbox": [
+      0.3715,
+      0.0493,
+      0.8071,
+      0.4639
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "orange_stack",
+    "present": true,
+    "bbox": [
+      0.4378,
+      0.4895,
+      0.7174,
+      0.7537
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "woven_basket",
+    "present": true,
+    "bbox": [
+      0.6038,
+      0.6257,
+      0.8791,
+      0.8689
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  }
+]

10samples/sample_0001/identity_verification.json

@@ -0,0 +1,32 @@
+[
+  {
+    "name": "vendor_in_apron",
+    "score": 0.906,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "shopper_red_coat",
+    "score": 0.851,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "green_umbrella",
+    "score": 0.845,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "orange_stack",
+    "score": 0.857,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "woven_basket",
+    "score": 0.823,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  }
+]

10samples/sample_0001/plan.json

@@ -0,0 +1,153 @@
+{
+  "sample_id": "sample_0001",
+  "scene_caption": "A rainy market stall bustles as a vendor steadies a display while a shopper reaches for fruit under a green umbrella.",
+  "story": "The rain has just eased, and the stall is busy again. A quick exchange between vendor and shopper gives the scene a focused, everyday energy.",
+  "background": "Covered outdoor produce market, damp stone floor, warm awning light, late afternoon.",
+  "style": "photorealistic",
+  "canvas_size": [
+    1024,
+    1024
+  ],
+  "subjects": [
+    {
+      "name": "vendor_in_apron",
+      "is_person": true,
+      "sub_caption": "middle-aged person with short dark hair, tan skin, blue apron, leaning forward with a concentrated expression",
+      "intended_bbox": [
+        0.08,
+        0.24,
+        0.31,
+        0.83
+      ],
+      "ref_style": "everyday_candid",
+      "ref_prompt": "middle-aged market vendor with short dark hair, tan skin, blue apron, focused expression",
+      "color": [
+        38,
+        106,
+        154
+      ],
+      "accent": [
+        113,
+        158,
+        189
+      ],
+      "kind": "box",
+      "skin": [
+        169,
+        115,
+        83
+      ],
+      "hair": [
+        42,
+        33,
+        29
+      ]
+    },
+    {
+      "name": "shopper_red_coat",
+      "is_person": true,
+      "sub_caption": "older shopper with silver hair, warm brown skin, red raincoat, arm extended toward the fruit",
+      "intended_bbox": [
+        0.26,
+        0.22,
+        0.5,
+        0.88
+      ],
+      "ref_style": "professional_portrait",
+      "ref_prompt": "older shopper with silver hair, warm brown skin, red raincoat, kind alert face",
+      "color": [
+        182,
+        55,
+        63
+      ],
+      "accent": [
+        207,
+        125,
+        130
+      ],
+      "kind": "box",
+      "skin": [
+        133,
+        86,
+        62
+      ],
+      "hair": [
+        205,
+        205,
+        198
+      ]
+    },
+    {
+      "name": "green_umbrella",
+      "is_person": false,
+      "sub_caption": "large forest-green umbrella tilted over the fruit display with a wet curved canopy",
+      "intended_bbox": [
+        0.37,
+        0.04,
+        0.82,
+        0.46
+      ],
+      "ref_style": "in_context_natural",
+      "ref_prompt": "forest-green rain umbrella with a curved wet canopy",
+      "color": [
+        38,
+        119,
+        82
+      ],
+      "accent": [
+        113,
+        166,
+        142
+      ],
+      "kind": "umbrella"
+    },
+    {
+      "name": "orange_stack",
+      "is_person": false,
+      "sub_caption": "bright oranges stacked in a low crate near the center foreground",
+      "intended_bbox": [
+        0.44,
+        0.49,
+        0.71,
+        0.75
+      ],
+      "ref_style": "closeup_macro",
+      "ref_prompt": "bright oranges with pebbled rind piled together",
+      "color": [
+        226,
+        115,
+        35
+      ],
+      "accent": [
+        236,
+        164,
+        112
+      ],
+      "kind": "fruit_stack"
+    },
+    {
+      "name": "woven_basket",
+      "is_person": false,
+      "sub_caption": "wide woven basket partly tucked beneath the fruit display",
+      "intended_bbox": [
+        0.61,
+        0.62,
+        0.88,
+        0.87
+      ],
+      "ref_style": "studio_product",
+      "ref_prompt": "wide tan woven market basket with sturdy handles",
+      "color": [
+        174,
+        121,
+        68
+      ],
+      "accent": [
+        202,
+        167,
+        133
+      ],
+      "kind": "basket"
+    }
+  ]
+}

10samples/sample_0001/row.json

@@ -0,0 +1,133 @@
+{
+  "sample_id": "sample_0001",
+  "scene_caption": "A rainy market stall bustles as a vendor steadies a display while a shopper reaches for fruit under a green umbrella.",
+  "story": "The rain has just eased, and the stall is busy again. A quick exchange between vendor and shopper gives the scene a focused, everyday energy.",
+  "background": "Covered outdoor produce market, damp stone floor, warm awning light, late afternoon.",
+  "style": "photorealistic",
+  "canvas_size": [
+    1024,
+    1024
+  ],
+  "main_image": "main_image.png",
+  "layout_sketch": "layout_sketch.png",
+  "n_planned": 5,
+  "n_accepted": 5,
+  "accepted": [
+    {
+      "name": "vendor_in_apron",
+      "is_person": true,
+      "ref_style": "everyday_candid",
+      "sub_caption": "middle-aged person with short dark hair, tan skin, blue apron, leaning forward with a concentrated expression",
+      "intended_bbox": [
+        0.08,
+        0.24,
+        0.31,
+        0.83
+      ],
+      "measured_bbox": [
+        0.0788,
+        0.2404,
+        0.3168,
+        0.8162
+      ],
+      "iou_intended_vs_measured": 0.9439,
+      "layout_followed": true,
+      "identity_score": 0.906,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_vendor_in_apron.png"
+    },
+    {
+      "name": "shopper_red_coat",
+      "is_person": true,
+      "ref_style": "professional_portrait",
+      "sub_caption": "older shopper with silver hair, warm brown skin, red raincoat, arm extended toward the fruit",
+      "intended_bbox": [
+        0.26,
+        0.22,
+        0.5,
+        0.88
+      ],
+      "measured_bbox": [
+        0.2662,
+        0.2234,
+        0.5018,
+        0.8849
+      ],
+      "iou_intended_vs_measured": 0.9551,
+      "layout_followed": true,
+      "identity_score": 0.851,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_shopper_red_coat.png"
+    },
+    {
+      "name": "green_umbrella",
+      "is_person": false,
+      "ref_style": "in_context_natural",
+      "sub_caption": "large forest-green umbrella tilted over the fruit display with a wet curved canopy",
+      "intended_bbox": [
+        0.37,
+        0.04,
+        0.82,
+        0.46
+      ],
+      "measured_bbox": [
+        0.3715,
+        0.0493,
+        0.8071,
+        0.4639
+      ],
+      "iou_intended_vs_measured": 0.9381,
+      "layout_followed": true,
+      "identity_score": 0.845,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_green_umbrella.png"
+    },
+    {
+      "name": "orange_stack",
+      "is_person": false,
+      "ref_style": "closeup_macro",
+      "sub_caption": "bright oranges stacked in a low crate near the center foreground",
+      "intended_bbox": [
+        0.44,
+        0.49,
+        0.71,
+        0.75
+      ],
+      "measured_bbox": [
+        0.4378,
+        0.4895,
+        0.7174,
+        0.7537
+      ],
+      "iou_intended_vs_measured": 0.9503,
+      "layout_followed": true,
+      "identity_score": 0.857,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_orange_stack.png"
+    },
+    {
+      "name": "woven_basket",
+      "is_person": false,
+      "ref_style": "studio_product",
+      "sub_caption": "wide woven basket partly tucked beneath the fruit display",
+      "intended_bbox": [
+        0.61,
+        0.62,
+        0.88,
+        0.87
+      ],
+      "measured_bbox": [
+        0.6038,
+        0.6257,
+        0.8791,
+        0.8689
+      ],
+      "iou_intended_vs_measured": 0.9484,
+      "layout_followed": true,
+      "identity_score": 0.823,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_woven_basket.png"
+    }
+  ],
+  "dropped": []
+}

10samples/sample_0002/detections.json

@@ -0,0 +1,62 @@
+[
+  {
+    "name": "person_yellow_sweater",
+    "present": true,
+    "bbox": [
+      0.109,
+      0.1736,
+      0.379,
+      0.8243
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "person_green_cardigan",
+    "present": true,
+    "bbox": [
+      0.5576,
+      0.2432,
+      0.8204,
+      0.8891
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "blue_ceramic_mug",
+    "present": true,
+    "bbox": [
+      0.3517,
+      0.5811,
+      0.5138,
+      0.7817
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "berry_bowl",
+    "present": true,
+    "bbox": [
+      0.453,
+      0.4836,
+      0.6281,
+      0.6591
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "cookbook_stack",
+    "present": true,
+    "bbox": [
+      0.1775,
+      0.4574,
+      0.3931,
+      0.6201
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  }
+]

10samples/sample_0002/identity_verification.json

@@ -0,0 +1,32 @@
+[
+  {
+    "name": "person_yellow_sweater",
+    "score": 0.896,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "person_green_cardigan",
+    "score": 0.9,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "blue_ceramic_mug",
+    "score": 0.853,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "berry_bowl",
+    "score": 0.911,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "cookbook_stack",
+    "score": 0.932,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  }
+]

10samples/sample_0002/plan.json

@@ -0,0 +1,153 @@
+{
+  "sample_id": "sample_0002",
+  "scene_caption": "A family breakfast table is mid-preparation as two people arrange food around a ceramic mug and a stack of books.",
+  "story": "The morning is calm but active. One person is setting the table while another pauses with a small smile before sitting down.",
+  "background": "Bright home kitchen with pale tile, wood table, diffuse window light.",
+  "style": "photorealistic",
+  "canvas_size": [
+    1024,
+    1024
+  ],
+  "subjects": [
+    {
+      "name": "person_yellow_sweater",
+      "is_person": true,
+      "sub_caption": "young adult with curly black hair, medium brown skin, yellow sweater, holding a plate near the table",
+      "intended_bbox": [
+        0.11,
+        0.18,
+        0.37,
+        0.82
+      ],
+      "ref_style": "mirror_selfie",
+      "ref_prompt": "young adult with curly black hair, medium brown skin, yellow sweater",
+      "color": [
+        221,
+        172,
+        54
+      ],
+      "accent": [
+        232,
+        201,
+        124
+      ],
+      "kind": "box",
+      "skin": [
+        141,
+        91,
+        62
+      ],
+      "hair": [
+        31,
+        25,
+        22
+      ]
+    },
+    {
+      "name": "person_green_cardigan",
+      "is_person": true,
+      "sub_caption": "adult with straight auburn bob, fair skin, green cardigan, seated and smiling softly",
+      "intended_bbox": [
+        0.55,
+        0.25,
+        0.82,
+        0.87
+      ],
+      "ref_style": "id_headshot",
+      "ref_prompt": "adult with straight auburn bob, fair skin, green cardigan, soft smile",
+      "color": [
+        68,
+        135,
+        91
+      ],
+      "accent": [
+        133,
+        177,
+        148
+      ],
+      "kind": "box",
+      "skin": [
+        226,
+        174,
+        136
+      ],
+      "hair": [
+        126,
+        62,
+        42
+      ]
+    },
+    {
+      "name": "blue_ceramic_mug",
+      "is_person": false,
+      "sub_caption": "glossy cobalt-blue ceramic mug close to the front edge of the table",
+      "intended_bbox": [
+        0.35,
+        0.58,
+        0.51,
+        0.78
+      ],
+      "ref_style": "studio_product",
+      "ref_prompt": "glossy cobalt-blue ceramic mug with rounded handle",
+      "color": [
+        33,
+        88,
+        174
+      ],
+      "accent": [
+        110,
+        146,
+        202
+      ],
+      "kind": "mug"
+    },
+    {
+      "name": "berry_bowl",
+      "is_person": false,
+      "sub_caption": "small bowl heaped with red berries between the two people",
+      "intended_bbox": [
+        0.45,
+        0.48,
+        0.63,
+        0.66
+      ],
+      "ref_style": "flatlay_topdown",
+      "ref_prompt": "small white bowl full of red berries",
+      "color": [
+        191,
+        45,
+        72
+      ],
+      "accent": [
+        245,
+        238,
+        226
+      ],
+      "kind": "fruit_stack"
+    },
+    {
+      "name": "cookbook_stack",
+      "is_person": false,
+      "sub_caption": "short stack of cookbooks with teal and cream covers near the back of the table",
+      "intended_bbox": [
+        0.18,
+        0.46,
+        0.39,
+        0.62
+      ],
+      "ref_style": "shelf_in_store",
+      "ref_prompt": "short stack of teal and cream cookbooks",
+      "color": [
+        55,
+        134,
+        142
+      ],
+      "accent": [
+        232,
+        219,
+        184
+      ],
+      "kind": "book_stack"
+    }
+  ]
+}

10samples/sample_0002/row.json

@@ -0,0 +1,133 @@
+{
+  "sample_id": "sample_0002",
+  "scene_caption": "A family breakfast table is mid-preparation as two people arrange food around a ceramic mug and a stack of books.",
+  "story": "The morning is calm but active. One person is setting the table while another pauses with a small smile before sitting down.",
+  "background": "Bright home kitchen with pale tile, wood table, diffuse window light.",
+  "style": "photorealistic",
+  "canvas_size": [
+    1024,
+    1024
+  ],
+  "main_image": "main_image.png",
+  "layout_sketch": "layout_sketch.png",
+  "n_planned": 5,
+  "n_accepted": 5,
+  "accepted": [
+    {
+      "name": "person_yellow_sweater",
+      "is_person": true,
+      "ref_style": "mirror_selfie",
+      "sub_caption": "young adult with curly black hair, medium brown skin, yellow sweater, holding a plate near the table",
+      "intended_bbox": [
+        0.11,
+        0.18,
+        0.37,
+        0.82
+      ],
+      "measured_bbox": [
+        0.109,
+        0.1736,
+        0.379,
+        0.8243
+      ],
+      "iou_intended_vs_measured": 0.9471,
+      "layout_followed": true,
+      "identity_score": 0.896,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_person_yellow_sweater.png"
+    },
+    {
+      "name": "person_green_cardigan",
+      "is_person": true,
+      "ref_style": "id_headshot",
+      "sub_caption": "adult with straight auburn bob, fair skin, green cardigan, seated and smiling softly",
+      "intended_bbox": [
+        0.55,
+        0.25,
+        0.82,
+        0.87
+      ],
+      "measured_bbox": [
+        0.5576,
+        0.2432,
+        0.8204,
+        0.8891
+      ],
+      "iou_intended_vs_measured": 0.9326,
+      "layout_followed": true,
+      "identity_score": 0.9,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_person_green_cardigan.png"
+    },
+    {
+      "name": "blue_ceramic_mug",
+      "is_person": false,
+      "ref_style": "studio_product",
+      "sub_caption": "glossy cobalt-blue ceramic mug close to the front edge of the table",
+      "intended_bbox": [
+        0.35,
+        0.58,
+        0.51,
+        0.78
+      ],
+      "measured_bbox": [
+        0.3517,
+        0.5811,
+        0.5138,
+        0.7817
+      ],
+      "iou_intended_vs_measured": 0.9532,
+      "layout_followed": true,
+      "identity_score": 0.853,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_blue_ceramic_mug.png"
+    },
+    {
+      "name": "berry_bowl",
+      "is_person": false,
+      "ref_style": "flatlay_topdown",
+      "sub_caption": "small bowl heaped with red berries between the two people",
+      "intended_bbox": [
+        0.45,
+        0.48,
+        0.63,
+        0.66
+      ],
+      "measured_bbox": [
+        0.453,
+        0.4836,
+        0.6281,
+        0.6591
+      ],
+      "iou_intended_vs_measured": 0.9485,
+      "layout_followed": true,
+      "identity_score": 0.911,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_berry_bowl.png"
+    },
+    {
+      "name": "cookbook_stack",
+      "is_person": false,
+      "ref_style": "shelf_in_store",
+      "sub_caption": "short stack of cookbooks with teal and cream covers near the back of the table",
+      "intended_bbox": [
+        0.18,
+        0.46,
+        0.39,
+        0.62
+      ],
+      "measured_bbox": [
+        0.1775,
+        0.4574,
+        0.3931,
+        0.6201
+      ],
+      "iou_intended_vs_measured": 0.9579,
+      "layout_followed": true,
+      "identity_score": 0.932,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_cookbook_stack.png"
+    }
+  ],
+  "dropped": []
+}

10samples/sample_0003/detections.json

@@ -0,0 +1,62 @@
+[
+  {
+    "name": "mechanic_gray_overalls",
+    "present": true,
+    "bbox": [
+      0.07,
+      0.2273,
+      0.3444,
+      0.9182
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "assistant_plaid_shirt",
+    "present": true,
+    "bbox": [
+      0.6793,
+      0.1906,
+      0.916,
+      0.8364
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "teal_bicycle_frame",
+    "present": true,
+    "bbox": [
+      0.2928,
+      0.4899,
+      0.7605,
+      0.8716
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "red_tool_crate",
+    "present": true,
+    "bbox": [
+      0.3083,
+      0.3735,
+      0.5342,
+      0.5699
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "yellow_task_lamp",
+    "present": true,
+    "bbox": [
+      0.1014,
+      0.0643,
+      0.2944,
+      0.3854
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  }
+]

10samples/sample_0003/identity_verification.json

@@ -0,0 +1,32 @@
+[
+  {
+    "name": "mechanic_gray_overalls",
+    "score": 0.953,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "assistant_plaid_shirt",
+    "score": 0.831,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "teal_bicycle_frame",
+    "score": 0.856,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "red_tool_crate",
+    "score": 0.856,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "yellow_task_lamp",
+    "score": 0.903,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  }
+]

10samples/sample_0003/plan.json

@@ -0,0 +1,153 @@
+{
+  "sample_id": "sample_0003",
+  "scene_caption": "In a repair workshop, a mechanic and an assistant coordinate around a bicycle frame, tool crate, and yellow lamp.",
+  "story": "The team is close to solving the repair. Their body language shows concentration as tools and parts crowd the bench.",
+  "background": "Dim bicycle workshop, pegboard walls, worn wooden bench, focused task lighting.",
+  "style": "photorealistic",
+  "canvas_size": [
+    1024,
+    1024
+  ],
+  "subjects": [
+    {
+      "name": "mechanic_gray_overalls",
+      "is_person": true,
+      "sub_caption": "stocky adult with shaved head, deep brown skin, gray overalls, crouched toward the bicycle",
+      "intended_bbox": [
+        0.07,
+        0.24,
+        0.34,
+        0.91
+      ],
+      "ref_style": "professional_portrait",
+      "ref_prompt": "stocky adult mechanic with shaved head, deep brown skin, gray overalls",
+      "color": [
+        92,
+        101,
+        107
+      ],
+      "accent": [
+        149,
+        154,
+        158
+      ],
+      "kind": "box",
+      "skin": [
+        92,
+        55,
+        39
+      ],
+      "hair": [
+        28,
+        24,
+        22
+      ]
+    },
+    {
+      "name": "assistant_plaid_shirt",
+      "is_person": true,
+      "sub_caption": "slim adult with wavy blond hair, fair skin, red plaid shirt, holding a small wrench",
+      "intended_bbox": [
+        0.68,
+        0.19,
+        0.91,
+        0.84
+      ],
+      "ref_style": "everyday_candid",
+      "ref_prompt": "slim adult with wavy blond hair, fair skin, red plaid shirt, holding a small wrench",
+      "color": [
+        163,
+        58,
+        53
+      ],
+      "accent": [
+        195,
+        126,
+        123
+      ],
+      "kind": "box",
+      "skin": [
+        232,
+        183,
+        142
+      ],
+      "hair": [
+        214,
+        178,
+        93
+      ]
+    },
+    {
+      "name": "teal_bicycle_frame",
+      "is_person": false,
+      "sub_caption": "teal bicycle frame angled across the lower center with both wheels visible",
+      "intended_bbox": [
+        0.29,
+        0.49,
+        0.76,
+        0.88
+      ],
+      "ref_style": "in_context_natural",
+      "ref_prompt": "teal bicycle frame with thin black tires",
+      "color": [
+        34,
+        147,
+        154
+      ],
+      "accent": [
+        111,
+        184,
+        189
+      ],
+      "kind": "bicycle"
+    },
+    {
+      "name": "red_tool_crate",
+      "is_person": false,
+      "sub_caption": "red metal tool crate on the workbench with compartment ridges",
+      "intended_bbox": [
+        0.31,
+        0.38,
+        0.54,
+        0.57
+      ],
+      "ref_style": "studio_product",
+      "ref_prompt": "red metal tool crate with compartment ridges",
+      "color": [
+        177,
+        52,
+        45
+      ],
+      "accent": [
+        204,
+        123,
+        118
+      ],
+      "kind": "crate"
+    },
+    {
+      "name": "yellow_task_lamp",
+      "is_person": false,
+      "sub_caption": "small yellow task lamp casting light from the rear left of the bench",
+      "intended_bbox": [
+        0.1,
+        0.06,
+        0.3,
+        0.38
+      ],
+      "ref_style": "closeup_macro",
+      "ref_prompt": "small yellow metal task lamp with round shade",
+      "color": [
+        229,
+        185,
+        60
+      ],
+      "accent": [
+        238,
+        209,
+        128
+      ],
+      "kind": "lamp"
+    }
+  ]
+}

10samples/sample_0003/row.json

@@ -0,0 +1,133 @@
+{
+  "sample_id": "sample_0003",
+  "scene_caption": "In a repair workshop, a mechanic and an assistant coordinate around a bicycle frame, tool crate, and yellow lamp.",
+  "story": "The team is close to solving the repair. Their body language shows concentration as tools and parts crowd the bench.",
+  "background": "Dim bicycle workshop, pegboard walls, worn wooden bench, focused task lighting.",
+  "style": "photorealistic",
+  "canvas_size": [
+    1024,
+    1024
+  ],
+  "main_image": "main_image.png",
+  "layout_sketch": "layout_sketch.png",
+  "n_planned": 5,
+  "n_accepted": 5,
+  "accepted": [
+    {
+      "name": "mechanic_gray_overalls",
+      "is_person": true,
+      "ref_style": "professional_portrait",
+      "sub_caption": "stocky adult with shaved head, deep brown skin, gray overalls, crouched toward the bicycle",
+      "intended_bbox": [
+        0.07,
+        0.24,
+        0.34,
+        0.91
+      ],
+      "measured_bbox": [
+        0.07,
+        0.2273,
+        0.3444,
+        0.9182
+      ],
+      "iou_intended_vs_measured": 0.9542,
+      "layout_followed": true,
+      "identity_score": 0.953,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_mechanic_gray_overalls.png"
+    },
+    {
+      "name": "assistant_plaid_shirt",
+      "is_person": true,
+      "ref_style": "everyday_candid",
+      "sub_caption": "slim adult with wavy blond hair, fair skin, red plaid shirt, holding a small wrench",
+      "intended_bbox": [
+        0.68,
+        0.19,
+        0.91,
+        0.84
+      ],
+      "measured_bbox": [
+        0.6793,
+        0.1906,
+        0.916,
+        0.8364
+      ],
+      "iou_intended_vs_measured": 0.9656,
+      "layout_followed": true,
+      "identity_score": 0.831,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_assistant_plaid_shirt.png"
+    },
+    {
+      "name": "teal_bicycle_frame",
+      "is_person": false,
+      "ref_style": "in_context_natural",
+      "sub_caption": "teal bicycle frame angled across the lower center with both wheels visible",
+      "intended_bbox": [
+        0.29,
+        0.49,
+        0.76,
+        0.88
+      ],
+      "measured_bbox": [
+        0.2928,
+        0.4899,
+        0.7605,
+        0.8716
+      ],
+      "iou_intended_vs_measured": 0.9714,
+      "layout_followed": true,
+      "identity_score": 0.856,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_teal_bicycle_frame.png"
+    },
+    {
+      "name": "red_tool_crate",
+      "is_person": false,
+      "ref_style": "studio_product",
+      "sub_caption": "red metal tool crate on the workbench with compartment ridges",
+      "intended_bbox": [
+        0.31,
+        0.38,
+        0.54,
+        0.57
+      ],
+      "measured_bbox": [
+        0.3083,
+        0.3735,
+        0.5342,
+        0.5699
+      ],
+      "iou_intended_vs_measured": 0.9359,
+      "layout_followed": true,
+      "identity_score": 0.856,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_red_tool_crate.png"
+    },
+    {
+      "name": "yellow_task_lamp",
+      "is_person": false,
+      "ref_style": "closeup_macro",
+      "sub_caption": "small yellow task lamp casting light from the rear left of the bench",
+      "intended_bbox": [
+        0.1,
+        0.06,
+        0.3,
+        0.38
+      ],
+      "measured_bbox": [
+        0.1014,
+        0.0643,
+        0.2944,
+        0.3854
+      ],
+      "iou_intended_vs_measured": 0.9368,
+      "layout_followed": true,
+      "identity_score": 0.903,
+      "identity_verdict": "match",
+      "ref_image": "references/ref_yellow_task_lamp.png"
+    }
+  ],
+  "dropped": []
+}

10samples/sample_0004/detections.json

@@ -0,0 +1,62 @@
+[
+  {
+    "name": "reader_blue_jacket",
+    "present": true,
+    "bbox": [
+      0.1326,
+      0.1856,
+      0.4031,
+      0.8443
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "reader_pink_scarf",
+    "present": true,
+    "bbox": [
+      0.4868,
+      0.2174,
+      0.7476,
+      0.8682
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "green_desk_lamp",
+    "present": true,
+    "bbox": [
+      0.3455,
+      0.4029,
+      0.5734,
+      0.6584
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "navy_book_stack",
+    "present": true,
+    "bbox": [
+      0.6101,
+      0.5787,
+      0.8535,
+      0.7764
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  },
+  {
+    "name": "terracotta_plant",
+    "present": true,
+    "bbox": [
+      0.7476,
+      0.423,
+      0.9172,
+      0.6642
+    ],
+    "confidence": "high",
+    "notes": "Synthetic renderer places this subject directly from the planned layout."
+  }
+]

10samples/sample_0004/identity_verification.json

@@ -0,0 +1,32 @@
+[
+  {
+    "name": "reader_blue_jacket",
+    "score": 0.946,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "reader_pink_scarf",
+    "score": 0.923,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "green_desk_lamp",
+    "score": 0.852,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "navy_book_stack",
+    "score": 0.918,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  },
+  {
+    "name": "terracotta_plant",
+    "score": 0.898,
+    "verdict": "match",
+    "rationale": "Reference and main rendering share the same generated subject attributes."
+  }
+]