bakeshot 0.1.0__tar.gz

bakeshot-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ryohei Horiuchi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bakeshot-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: bakeshot
+Version: 0.1.0
+Summary: Capture the same UI your users see, without a simulator or a device.
+License: MIT
+Project-URL: Homepage, https://github.com/Ryoheihoriuchi0000/bakeshot
+Project-URL: Issues, https://github.com/Ryoheihoriuchi0000/bakeshot/issues
+Keywords: ios,screenshots,app-store,fastlane,snapshot,swiftui,xcode
+Classifier: Environment :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Bakeshot
+
+**Capture the same UI your users see — without a simulator or a device.**
+
+https://github.com/user-attachments/assets/6a902e87-bb5d-467f-8c55-96d89f550ac3
+
+## Without Bakeshot
+
+Getting the screens you want means installing the app, opening the right
+screen, getting it into the right state, placing the widget, configuring it, getting real
+data into it — and only then taking the shot.
+
+| The screenshot you want | What you or your agent has to do first |
+|---|---|
+| A home screen with a month of history | Seed the database, or tap the data in by hand |
+| A seven-day streak | Use the app for seven days running — or forge the dates in storage |
+| The paid tier, active | Set up a StoreKit sandbox account and buy through it |
+| An empty state, an error state | Wipe the data, or cut the network, and hope nothing else changes |
+| A chart that looks good | Keep re-seeding until the numbers happen to make a nice shape |
+| The same shots in five languages | Change the device language and take every shot again, five times |
+| A widget | Install the app, add the widget, configure it, get data into it, then photograph the home screen and crop |
+
+And you do all of it again next release.
+
+## With Bakeshot
+
+You describe the state in code; Bakeshot builds your app, runs it on your Mac as a real iOS
+binary, and draws the view.
+
+```swift
+shotBoth("home") { HomeView().environmentObject(thirtyDaysOfHistory()) }
+shot("paywall", dark: true) { PlusSheet().environmentObject(PlusStore(active: true)) }
+```
+
+Nothing is simulated or mocked up: these are your real views, your real fonts and assets,
+rendered by iOS. The app never has to reach the state — the state is handed to it.
+
+It does not decorate. Backgrounds, captions and device frames are somebody else's job
+(try [app-store-screenshots](https://github.com/ParthJadhav/app-store-screenshots)).
+Bakeshot does the part nobody has automated: **the real UI, in the state that sells it.**
+
+## Use it
+
+```bash
+pip install git+https://github.com/Ryoheihoriuchi0000/bakeshot
+cd MyApp
+bakeshot init
+```
+
+Then tell your coding agent:
+
+> **Bakeshot を使って App Store Connect 用のプロモーション画像を作成して**
+> — or, in English, *"use Bakeshot to create the promotional images for App Store Connect"*
+
+`init` installs a skill into `.claude/skills/bakeshot/`, so the agent reads your models and
+views, writes the scene script, runs the render, fixes whatever crashed, and tells you where
+the images are. You do not have to learn the flags, or the file, or any of this README.
+
+<details>
+<summary>Not using Claude Code?</summary>
+
+Point any agent at the skill: *"Read `.claude/skills/bakeshot/SKILL.md` and follow it."*
+Or drive it yourself: edit `Bakeshot/Scenes.swift`, then `bakeshot bake --locale ja --locale en`.
+
+</details>
+
+PNGs land in `Bakeshot/out/<locale>/`, at real store dimensions.
+
+## The scene script
+
+`Bakeshot/Scenes.swift` is where you say what to shoot and in what state. It is plain
+Swift against your own types, which is why an agent can write it:
+
+```swift
+enum BakeshotScenes {
+    @MainActor static var scenes: [BakeshotScene] {
+        [
+            shotBoth("home_busy") { HomeView().environmentObject(busyStore()) },
+            shot("paywall", dark: true) { PlusSheet().environmentObject(PlusStore()) },
+            shotBoth("widget", size: .widgetMedium) { MyWidgetView(entry: demoEntry()) },
+        ].flatMap { $0 }
+    }
+}
+
+@MainActor private func busyStore() -> AppStore {
+    let s = AppStore()
+    s.tags = [Tag(name: "Study"), Tag(name: "Workout"), Tag(name: "Work")]
+    s.logs = (0..<20).map { LogEntry(minutes: 30 + $0 * 5) }
+    return s
+}
+```
+
+An empty app makes a worthless screenshot. The state is the product.
+
+## Does it touch my project?
+
+**No.** Bakeshot never edits your files, your `.xcodeproj`, or your git history.
+
+To render your views it needs one test target hosted by your app. Rather than add that
+to your project, it works on a hidden throwaway copy of the `.xcodeproj`, and deletes it
+when the run ends — including when the run fails. Nothing is left behind.
+
+<details>
+<summary>What actually happens</summary>
+
+1. Copy `MyApp.xcodeproj` → `.MyApp-bakeshot.xcodeproj` (hidden, temporary, sits next to
+   the original because Xcode projects reference their files by relative path).
+2. Add a test target to the copy, hosted by your app.
+3. Build the copy for *My Mac (Designed for iPad)* — your iOS binary, running on macOS,
+   so Firebase, UIKit, your fonts and assets are all the real thing.
+4. Render each scene with `UIHostingController` + `drawHierarchy`, write PNGs.
+5. Delete the copy.
+
+</details>
+
+## Requirements
+
+- Apple silicon Mac with Xcode
+- `gem install --user-install xcodeproj`
+- Your app must be signable with your own team — the setup you already build with
+
+`bakeshot init` checks all of this and tells you what is missing.
+
+## Price
+
+Everything above is free: every screen, every state, every language, every device size.
+
+| | |
+|---|---|
+| Public | free, forever — app screens |
+| Widgets | **$49 / year** |
+| Team / agency | **$199 / year** — several projects, CI |
+| Launch offer | **$99 once**, first 100 buyers |
+
+The version you paid for keeps working forever; renewing buys the next year of updates.
+Xcode breaks this kind of tool roughly once a year — that is what the renewal pays for.
+
+## Known limits
+
+- Xcode is driven while baking, so you cannot use Xcode during a run.
+  (`xcodebuild test` cannot launch an iOS-on-Mac test host; the IDE can.)
+- Screens that need network, keychain or a live account crash while rendering.
+  Bakeshot names them and bakes the rest — give them fakes in the scene script.
+- Widget sources are compiled into the test bundle, so a widget that depends on the
+  extension's own asset catalog may render without those images.
+
+## License
+
+MIT

bakeshot-0.1.0/README.md

@@ -0,0 +1,149 @@
+# Bakeshot
+
+**Capture the same UI your users see — without a simulator or a device.**
+
+https://github.com/user-attachments/assets/6a902e87-bb5d-467f-8c55-96d89f550ac3
+
+## Without Bakeshot
+
+Getting the screens you want means installing the app, opening the right
+screen, getting it into the right state, placing the widget, configuring it, getting real
+data into it — and only then taking the shot.
+
+| The screenshot you want | What you or your agent has to do first |
+|---|---|
+| A home screen with a month of history | Seed the database, or tap the data in by hand |
+| A seven-day streak | Use the app for seven days running — or forge the dates in storage |
+| The paid tier, active | Set up a StoreKit sandbox account and buy through it |
+| An empty state, an error state | Wipe the data, or cut the network, and hope nothing else changes |
+| A chart that looks good | Keep re-seeding until the numbers happen to make a nice shape |
+| The same shots in five languages | Change the device language and take every shot again, five times |
+| A widget | Install the app, add the widget, configure it, get data into it, then photograph the home screen and crop |
+
+And you do all of it again next release.
+
+## With Bakeshot
+
+You describe the state in code; Bakeshot builds your app, runs it on your Mac as a real iOS
+binary, and draws the view.
+
+```swift
+shotBoth("home") { HomeView().environmentObject(thirtyDaysOfHistory()) }
+shot("paywall", dark: true) { PlusSheet().environmentObject(PlusStore(active: true)) }
+```
+
+Nothing is simulated or mocked up: these are your real views, your real fonts and assets,
+rendered by iOS. The app never has to reach the state — the state is handed to it.
+
+It does not decorate. Backgrounds, captions and device frames are somebody else's job
+(try [app-store-screenshots](https://github.com/ParthJadhav/app-store-screenshots)).
+Bakeshot does the part nobody has automated: **the real UI, in the state that sells it.**
+
+## Use it
+
+```bash
+pip install git+https://github.com/Ryoheihoriuchi0000/bakeshot
+cd MyApp
+bakeshot init
+```
+
+Then tell your coding agent:
+
+> **Bakeshot を使って App Store Connect 用のプロモーション画像を作成して**
+> — or, in English, *"use Bakeshot to create the promotional images for App Store Connect"*
+
+`init` installs a skill into `.claude/skills/bakeshot/`, so the agent reads your models and
+views, writes the scene script, runs the render, fixes whatever crashed, and tells you where
+the images are. You do not have to learn the flags, or the file, or any of this README.
+
+<details>
+<summary>Not using Claude Code?</summary>
+
+Point any agent at the skill: *"Read `.claude/skills/bakeshot/SKILL.md` and follow it."*
+Or drive it yourself: edit `Bakeshot/Scenes.swift`, then `bakeshot bake --locale ja --locale en`.
+
+</details>
+
+PNGs land in `Bakeshot/out/<locale>/`, at real store dimensions.
+
+## The scene script
+
+`Bakeshot/Scenes.swift` is where you say what to shoot and in what state. It is plain
+Swift against your own types, which is why an agent can write it:
+
+```swift
+enum BakeshotScenes {
+    @MainActor static var scenes: [BakeshotScene] {
+        [
+            shotBoth("home_busy") { HomeView().environmentObject(busyStore()) },
+            shot("paywall", dark: true) { PlusSheet().environmentObject(PlusStore()) },
+            shotBoth("widget", size: .widgetMedium) { MyWidgetView(entry: demoEntry()) },
+        ].flatMap { $0 }
+    }
+}
+
+@MainActor private func busyStore() -> AppStore {
+    let s = AppStore()
+    s.tags = [Tag(name: "Study"), Tag(name: "Workout"), Tag(name: "Work")]
+    s.logs = (0..<20).map { LogEntry(minutes: 30 + $0 * 5) }
+    return s
+}
+```
+
+An empty app makes a worthless screenshot. The state is the product.
+
+## Does it touch my project?
+
+**No.** Bakeshot never edits your files, your `.xcodeproj`, or your git history.
+
+To render your views it needs one test target hosted by your app. Rather than add that
+to your project, it works on a hidden throwaway copy of the `.xcodeproj`, and deletes it
+when the run ends — including when the run fails. Nothing is left behind.
+
+<details>
+<summary>What actually happens</summary>
+
+1. Copy `MyApp.xcodeproj` → `.MyApp-bakeshot.xcodeproj` (hidden, temporary, sits next to
+   the original because Xcode projects reference their files by relative path).
+2. Add a test target to the copy, hosted by your app.
+3. Build the copy for *My Mac (Designed for iPad)* — your iOS binary, running on macOS,
+   so Firebase, UIKit, your fonts and assets are all the real thing.
+4. Render each scene with `UIHostingController` + `drawHierarchy`, write PNGs.
+5. Delete the copy.
+
+</details>
+
+## Requirements
+
+- Apple silicon Mac with Xcode
+- `gem install --user-install xcodeproj`
+- Your app must be signable with your own team — the setup you already build with
+
+`bakeshot init` checks all of this and tells you what is missing.
+
+## Price
+
+Everything above is free: every screen, every state, every language, every device size.
+
+| | |
+|---|---|
+| Public | free, forever — app screens |
+| Widgets | **$49 / year** |
+| Team / agency | **$199 / year** — several projects, CI |
+| Launch offer | **$99 once**, first 100 buyers |
+
+The version you paid for keeps working forever; renewing buys the next year of updates.
+Xcode breaks this kind of tool roughly once a year — that is what the renewal pays for.
+
+## Known limits
+
+- Xcode is driven while baking, so you cannot use Xcode during a run.
+  (`xcodebuild test` cannot launch an iOS-on-Mac test host; the IDE can.)
+- Screens that need network, keychain or a live account crash while rendering.
+  Bakeshot names them and bakes the rest — give them fakes in the scene script.
+- Widget sources are compiled into the test bundle, so a widget that depends on the
+  extension's own asset catalog may render without those images.
+
+## License
+
+MIT

bakeshot-0.1.0/bakeshot/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

bakeshot-0.1.0/bakeshot/bake.py

@@ -0,0 +1,293 @@
+"""焼く本体。本物の iOS ランタイム（My Mac / Designed for iPad）でアプリの View を描く。
+
+⚠ `xcodebuild test` はホストの起動で死ぬ（Xcode 26.3、最小アプリでも再現）。
+  同じ xcodeproj を Xcode IDE が走らせると通るので、AppleScript で Xcode を操作する。
+"""
+import re
+import shutil
+import time
+import uuid
+from pathlib import Path
+
+from . import devices, features, scenes as scenes_mod, xcode
+
+KIT = Path(__file__).parent / "hostkit"
+CONTAINERS = Path.home() / "Library" / "Containers"
+
+
+def log(msg, kind="·"):
+    print(f"{kind} {msg}", flush=True)
+
+
+_used_widgets = False
+
+
+def used_widgets() -> bool:
+    return _used_widgets
+
+
+def error_lines(out: str):
+    """ビルド出力からコンパイルエラーの行だけ。"""
+    return [l for l in out.splitlines() if ": error:" in l]
+
+
+def failing_shot_lines(errs, lines):
+    """エラーの出た行のうち、**撮影行だけ**を返す。
+
+    撮影行以外を消すと土台のコードが壊れ、無関係な構文エラーだらけになって
+    本当の原因が見えなくなる。実際にそうなっていたので、ここは厳しくする。
+    戻り値は [(行番号1始まり, 画面の名前)]。"""
+    nums = {int(m.group(1)) for l in errs
+            for m in [re.search(r"RenderTests\.swift:(\d+):", l)] if m}
+    found = []
+    for n in sorted(nums, reverse=True):
+        if n - 1 >= len(lines):
+            continue
+        m = re.search(r'bake\("([^"]+?)(?:_light|_dark)?"', lines[n - 1])
+        if m:
+            found.append((n, m.group(1)))
+    return found
+
+
+def skip_names(names):
+    """撮影側は _light / _dark を落とした名前で照合する。合わせないと素通りする。"""
+    return sorted({re.sub(r"_(light|dark)$", "", n) for n in names})
+
+
+# fatalError などのメッセージは stderr に出てからプロセスが死ぬ。描画側がそれをファイルに残す
+_NOISE = ("<unknown>", "CoreSimulator", "nw_", "objc[", "Metal", "AVF ", "Could not create")
+
+
+def crash_reason(box) -> str:
+    """落ちた理由を1〜2行で。何も無ければ空。"""
+    if not box:
+        return ""
+    f = box / "STDERR"
+    if not f.exists():
+        return ""
+    try:
+        text = f.read_text(encoding="utf-8", errors="replace")
+    except OSError:
+        return ""
+    lines = [l.strip() for l in text.splitlines() if l.strip()]
+    keep = [l for l in lines if not any(n in l for n in _NOISE)]
+    fatal = [i for i, l in enumerate(keep) if "Fatal error" in l or "Precondition failed" in l]
+    if fatal:
+        i = fatal[-1]
+        return " ".join(keep[i:i + 2])[:300]
+    return keep[-1][:300] if keep else ""
+
+
+def find_out_dir(token: str):
+    """アプリのサンドボックスにある受け皿。コンテナは走るまで決まらない。"""
+    for c in CONTAINERS.iterdir() if CONTAINERS.is_dir() else []:
+        d = c / "Data" / "tmp" / "bakeshot_out" / token
+        if d.is_dir():
+            return d
+    return None
+
+
+def ensure_scenes(root: Path, module: str, imports: str) -> Path:
+    """台本を用意する。**何をどんな状態で撮るかは利用者（とそのエージェント）が書く。**
+    自動検出は下書きでしかない（空の初期状態しか出せない）。"""
+    d = root / "Bakeshot"
+    f = d / "Scenes.swift"
+    if f.exists():
+        return f
+    d.mkdir(parents=True, exist_ok=True)
+    views = scenes_mod.guess_views(root)
+    f.write_text(scenes_mod.draft(module, imports, views), encoding="utf-8")
+    # エージェント用のスキル。置いておけば、利用者は「スクショ作って」で済む
+    skill_src = KIT / "skill" / "SKILL.md"
+    skill_dst = root / ".claude" / "skills" / "bakeshot" / "SKILL.md"
+    if skill_src.exists() and not skill_dst.exists():
+        skill_dst.parent.mkdir(parents=True, exist_ok=True)
+        skill_dst.write_text(skill_src.read_text(encoding="utf-8"), encoding="utf-8")
+    for src_name, dst_name in [("agent_guide.md", "AGENT.md")]:
+        g = KIT / src_name
+        if g.exists():
+            (d / dst_name).write_text(g.read_text(encoding="utf-8").replace("__MODULE__", module),
+                                      encoding="utf-8")
+    return f
+
+
+def bake(root: Path, project: Path, app_target: str, locale: str, device: str,
+         out_root: Path, bundle_id: str = "", strip_ext: bool = True,
+         strip_ent: bool = False, team: str = "", keep: bool = False):
+    features.pro()          # 完全版が入っていれば端末とウィジェットが増える
+    module = scenes_mod.module_name(app_target)
+    # Swift の識別子にならない名前（protoc-gen-swift のようなハイフン入り）は import できない
+    _ok = re.compile(r"^[A-Za-z_][A-Za-z0-9_]*$")
+    imports = "".join(f"#if canImport({m})\nimport {m}\n#endif\n"
+                      for m in sorted(scenes_mod.local_package_modules(root)) if _ok.match(m))
+    scenes_file = ensure_scenes(root, module, imports)
+    names = scenes_mod.names(scenes_file.read_text(encoding="utf-8"))
+    if not names:
+        raise SystemExit("台本に絵がありません。Bakeshot/Scenes.swift に shot / shotBoth を書いてください。")
+
+    global _used_widgets
+    token = uuid.uuid4().hex[:8]
+    work = root / "Bakeshot" / ".work"
+    shutil.rmtree(work, ignore_errors=True)
+    work.mkdir(parents=True, exist_ok=True)
+
+    w, h, top, bottom, _px = devices.metrics(device)
+    test = (KIT / "RenderTests.swift.template").read_text(encoding="utf-8")
+    for k, v in [("__IMPORTS__", imports), ("__MODULE__", module), ("__TOKEN__", token),
+                 ("__W__", str(w)), ("__H__", str(h)), ("__TOP__", str(top)), ("__BOTTOM__", str(bottom))]:
+        test = test.replace(k, v)
+    test_file = work / "RenderTests.swift"
+    test_file.write_text(test, encoding="utf-8")
+    api_file = work / "BakeshotSceneAPI.swift"
+    api_file.write_text((KIT / "BakeshotSceneAPI.swift.template").read_text(encoding="utf-8"), encoding="utf-8")
+
+    log(f"台本にある {len(names)} 枚を焼きます（{locale} / {device}\"）")
+    # ウィジェットは公開版に処理が無い。台本に混ざっていると、
+    # ウィジェットの型が見つからずビルドごと落ちる。**先に、はっきり止める。**
+    if ".widget" in scenes_file.read_text(encoding="utf-8"):
+        _used_widgets = True
+    if not features.pro() and _used_widgets:
+        raise SystemExit(
+            "台本にウィジェットがあります。ウィジェットは完全版の機能です。\n"
+            f"  買う:   {'https://bakeshot.lemonsqueezy.com'}\n"
+            "  今すぐ焼くなら: Bakeshot/Scenes.swift から size: .widget… の行と、\n"
+            "  そこで使っている下ごしらえを消してください（アプリの画面だけになります）。")
+
+    # 1) xcodeproj を複製してテストターゲットを足す
+    # 使い捨ての写し。**君のプロジェクトには一切書き込まない。**
+    # 同じ場所に置くのは、xcodeproj の中のファイル参照が相対パスだから（動かすと全部壊れる）。
+    # 先頭のドットで隠しておき、終わったら消す。
+    dst = project.with_name("." + project.stem + "-bakeshot.xcodeproj")
+    xcode.close_project(dst)
+    code, out = xcode.run(["/usr/bin/env", "ruby", str(KIT / "add_test_target.rb"),
+                           str(project), str(dst),
+                           ":".join([str(test_file), str(api_file), str(scenes_file)]),
+                           app_target, bundle_id, "1" if strip_ext else "0",
+                           "1" if strip_ent else "0", locale, team,
+                           str(work / "widget"), features.widget_support_rb()],
+                          env_extra=xcode.UTF8)
+    if code != 0:
+        shutil.rmtree(dst, ignore_errors=True)
+        if "cannot load such file -- xcodeproj" in out:
+            raise SystemExit("Ruby の xcodeproj gem がありません。`gem install --user-install xcodeproj` を実行してください")
+        raise SystemExit(f"xcodeproj の複製に失敗:\n{out[-800:]}")
+
+    # 2) 先にビルドだけ通す（Xcode 経由だとコンパイルエラーが読めない）。
+    #    引数が要る View が台本に混ざっていたら、その行を外して組み直す
+    try:
+        dest_id = xcode.mac_destination_id(dst)
+    except SystemExit:
+        shutil.rmtree(dst, ignore_errors=True)
+        raise
+    derived = work / "dd"
+    pruned = []
+    for attempt in range(1, 5):
+        code, out = xcode.build_for_testing(dst, dest_id, derived)
+        if code == 0:
+            break
+        errs = error_lines(out)
+        lines = test_file.read_text(encoding="utf-8").splitlines()
+        hits = failing_shot_lines(errs, lines)
+        if not hits or attempt == 4:
+            why = " / ".join(re.sub(r"^.*?: error: ", "", l) for l in errs[:4])
+            if not keep:
+                shutil.rmtree(dst, ignore_errors=True)
+            raise SystemExit(f"ビルドに失敗しました:\n{why or out[-600:]}")
+        dropped = []
+        for n, name in hits:
+            if name not in pruned:
+                pruned.append(name)
+            dropped.append(name)
+            lines[n - 1] = ""
+        test_file.write_text("\n".join(lines), encoding="utf-8")
+        log(f"コンパイルが通らないので外しました: {', '.join(dropped)}", "!")
+        for e in errs[:4]:
+            log(re.sub(r"^.*?: error: ", "", e), " ")
+
+    # 3) Xcode に走らせ、進捗ファイルで打ち切る。
+    #    落ちる View があるとテストの完了が返ってこないので、Xcode の完了は当てにしない。
+    out_dir_final = out_root / locale
+    out_dir_final.mkdir(parents=True, exist_ok=True)
+    remaining = [n for n in names if n not in pruned]
+    failed, collected, rounds = [], 0, 0
+    start_s = str(KIT / "start_test.applescript")
+    stop_s = str(KIT / "stop_test.applescript")
+    try:
+        while remaining and rounds < len(names) + 2:
+            rounds += 1
+            log("Xcode で My Mac (Designed for iPad) を実行しています…" if rounds == 1
+                else f"残り {len(remaining)} 枚でもう一周（{rounds} 回目）")
+            box = find_out_dir(token)
+            if box:
+                for f in ("STATE", "LOG", "STDERR"):
+                    (box / f).unlink(missing_ok=True)
+                # 落ちた絵は飛ばす。ソースではなくこのファイルで伝える（再ビルドを起こさない）
+                # 撮影側は _light / _dark を落とした名前で見ている。合わせないと素通りする
+                skips = skip_names(failed + pruned)
+                (box / "SKIP").write_text("\n".join(skips), encoding="utf-8")
+            code, out = xcode.osascript([start_s, str(dst), "BakeshotRender"])
+            if "not loaded" in out:
+                raise SystemExit("Xcode がプロジェクトを開けませんでした\n  うまくいかない時は、Xcode を一度終了してからやり直してください。")
+
+            last, last_change, finished = "", time.time(), False
+            deadline = time.time() + (1200 if rounds == 1 else 600)
+            while time.time() < deadline:
+                time.sleep(1)
+                box = box or find_out_dir(token)
+                if not box:
+                    continue
+                now = (box / "STATE").read_text(encoding="utf-8") if (box / "STATE").exists() else ""
+                if now != last:
+                    last, last_change = now, time.time()
+                if now.startswith("FINISHED"):
+                    finished = True
+                    break
+                if last and time.time() - last_change > 30:
+                    break
+            xcode.osascript([stop_s, str(dst)])
+            time.sleep(3)          # 止まり切る前に次を走らせると、Xcode が受け付けない
+            if not box:
+                raise SystemExit("Xcode でテストが始まりませんでした（ビルドが通っていない可能性）\n  うまくいかない時は、Xcode を一度終了してからやり直してください。")
+
+            done = set()
+            for f in sorted(box.glob("*.png")):
+                shutil.copy2(f, out_dir_final / f.name)
+                f.unlink()
+                collected += 1
+                done.add(f.stem)
+            fresh = [n for n in remaining if n in done]
+            for n in fresh:
+                log(f"✓ {n}", "")
+            remaining = [n for n in remaining if n not in done]
+            if finished:
+                break
+
+            parts = last.strip().split(" ")
+            if len(parts) == 2 and parts[0] in ("STARTED", "TIMEOUT") and parts[1] in remaining:
+                remaining.remove(parts[1])
+                failed.append(parts[1])
+                why = crash_reason(box)
+                log(f"✗ {parts[1]} は焼いている最中に"
+                    f"{'固まった' if parts[0] == 'TIMEOUT' else '落ちた'}ので外しました"
+                    + (f"\n   {why}" if why else ""), "!")
+            elif not last and not done:
+                raise SystemExit(f"Xcode でテストが動きませんでした（{rounds} 回目）"
+                             "  うまくいかない時は、Xcode を一度終了してからやり直してください。")
+            elif not fresh:
+                tail = ""
+                if (box / "LOG").exists():
+                    tail = " / ".join(box.read_text if False else
+                                      (box / "LOG").read_text(encoding="utf-8").splitlines()[-4:])
+                log(f"これ以上進みません。残り {len(remaining)} 枚は焼けませんでした（最後の様子: {tail or '記録なし'}）", "!")
+                failed += remaining
+                remaining = []
+    finally:
+        xcode.osascript([stop_s, str(dst), "close"])
+        if not keep:
+            shutil.rmtree(dst, ignore_errors=True)
+        shutil.rmtree(work / "dd", ignore_errors=True)
+
+    log(f"{collected} 枚できました → {out_dir_final}", "✓")
+    if failed or pruned:
+        log(f"焼けなかった: {', '.join(sorted(set(failed + pruned)))}", "!")
+    return collected