Add a repeatable screenshot capture and compare smoke

Both capture helpers now accept --out=res://docs/screenshots, and
tools/check_screenshots.sh renders the staged set (using xvfb-run when headless)
before running screen_designs.py compare. Record the judge result: 7 match,
4 review, 0 diff. Headless 226/226 and the smoke both pass in a clean worktree.

src/test/capture_screenshots.gd

@@ -1,10 +1,11 @@
 extends SceneTree
 ## Dev helper: run the game windowed and capture staged screenshots for the
 ## README (day set + LATE-night set with street lamps and flashlight).
-## Saves 1280x720 PNGs to user://screenshots/.
+## Saves 1280x720 PNGs to user://screenshots/ by default.
 ## Usage: godot --path . --script res://src/test/capture_screenshots.gd
+##        godot --path . --script res://src/test/capture_screenshots.gd -- --out=res://docs/screenshots
 
-const OUT_DIR := "user://screenshots"
+var out_dir := "user://screenshots"
 const MAX_FRAMES := 3600 # hard cap (~60s)
 
 var frames := 0
@@ -16,6 +17,9 @@ var camera_staged := false
 var wand_attempts := 0
 
 func _initialize() -> void:
+	for arg in OS.get_cmdline_user_args():
+		if arg.begins_with("--out="):
+			out_dir = arg.trim_prefix("--out=")
 	root.size = Vector2i(1280, 720)
 	var packed: PackedScene = load("res://scenes/main.tscn")
 	var inst: Node = packed.instantiate()
@@ -231,9 +235,9 @@ func _face_target() -> void:
 	gm.guard.head.rotation.x = deg_to_rad(-4.0)
 
 func _shoot(file_name: String) -> void:
-	var dir := DirAccess.open("user://")
-	if dir == null or not dir.dir_exists("screenshots"):
-		dir.make_dir_recursive("screenshots")
+	var dir := DirAccess.open(out_dir)
+	if dir == null:
+		DirAccess.make_dir_recursive_absolute(ProjectSettings.globalize_path(out_dir))
 	var img: Image = root.get_texture().get_image()
-	var err := img.save_png(OUT_DIR.path_join(file_name))
+	var err := img.save_png(out_dir.path_join(file_name))
 	print("%s -> err=%d (%dx%d)" % [file_name, err, img.get_width(), img.get_height()])