Add a pose review harness and record the blocked pose capture

tools/npc_baseline.py

@@ -52,21 +52,24 @@ def next_free_path(path: Path) -> Path:
         index += 1
 
 
-def build_sheet(source: Path, output: Path) -> Path:
+def build_sheet(source: Path, output: Path, views: list[str] | None = None) -> Path:
+    """Tile one capture per (variant, view). `views` defaults to the six baseline
+    views; the pose harness passes pose names instead (see the module docstring)."""
     from PIL import Image, ImageDraw
 
+    views = views or VIEWS
     cell_w, cell_h = 320, 180
     label_h = 22
     header_h = 28
-    sheet_w = cell_w * len(VIEWS)
+    sheet_w = cell_w * len(views)
     sheet_h = header_h + (cell_h + label_h) * len(VARIANTS)
     sheet = Image.new("RGB", (sheet_w, sheet_h), (24, 26, 30))
     draw = ImageDraw.Draw(sheet)
-    for column, view in enumerate(VIEWS):
+    for column, view in enumerate(views):
         draw.text((column * cell_w + 8, 8), view.replace("_", " ").title(),
                   fill=(220, 224, 230))
     for row, variant in enumerate(VARIANTS):
-        for column, view in enumerate(VIEWS):
+        for column, view in enumerate(views):
             path = latest_for(source, f"{variant}__{view}")
             if path is None:
                 raise FileNotFoundError(
@@ -132,6 +135,9 @@ def main(argv: list[str] | None = None) -> int:
                        help="directory containing the capture_npc_baseline.gd PNGs")
     sheet.add_argument("--out", type=Path, default=None,
                        help="output JPEG (default: <dir>/sheet.jpg; never overwritten)")
+    sheet.add_argument("--views", default="",
+                       help="comma-separated view tokens instead of the six baseline views "
+                            "(pose harness: idle,walk_contact,walk_pass,sit)")
     compare = sub.add_parser("compare")
     compare.add_argument("--before", required=True, type=Path)
     compare.add_argument("--after", required=True, type=Path)
@@ -143,8 +149,9 @@ def main(argv: list[str] | None = None) -> int:
         if not output.is_absolute():
             output = ROOT / output
         output = next_free_path(output)
+        views = [v.strip() for v in args.views.split(",") if v.strip()] or None
         try:
-            written = build_sheet(source, output)
+            written = build_sheet(source, output, views)
         except FileNotFoundError as exc:
             print(exc)
             return 2