Refactor Python tools and native E2E capture

Author: gajop

.env.example

@@ -1,7 +1,7 @@
 # Local dev config. Copy to .env and edit. .env is gitignored — never committed.
 
 # Absolute path to your built spring engine install dir (the one containing the
-# `spring` binary). Used by tools/dev/launch.sh and tools/smoke/run_sbc.py.
+# `spring` binary). Used by the manual launcher and smoke tests.
 SBC_ENGINE_DIR=/path/to/spring-bar/build-linux/install
 
 # Engine build + rust dirs, used only by the engine-build just recipes

CLAUDE.md

@@ -2,7 +2,7 @@
 
 ## Use `just` for every dev command
 
-Never invoke `cargo`, `pytest`, `luacheck` or `tools/e2e/ui_driver.py` directly. The
+Never invoke `cargo`, `pytest`, `luacheck` or E2E Python modules directly. The
 recipes carry the right directories, flags and env (the crate lives in `native/`, so
 plain `cargo` from the repo root does not even find a `Cargo.toml`).
 

build/README.md

@@ -12,10 +12,10 @@ then renames `spring` to `SpringBoard` or `SpringBoard.exe`. The application
 build exports the exact `.sdz` embedded in the application as the standalone
 editor artifact.
 
-```bash
-uv run --project build --locked sbc-packager-base --help
-uv run --project build --locked sbc-packager-application --help
-```
+Use `just bundle-base-linux` for the editor archive and
+`just bundle-application-linux` for the complete application. `just --show
+bundle-base-linux` and `just --show bundle-application-linux` show their
+arguments.
 
 Linux applications use `.tar.gz`; Windows applications use `.zip`. Every
 published file has a SHA-256 checksum.

build/pyproject.toml

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import gzip
 import hashlib
 import shutil

build/sbc_packager/application/archive.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import shutil
 from pathlib import Path
 from typing import Annotated

build/sbc_packager/application/cli.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import json
 from dataclasses import dataclass
 from pathlib import Path

build/sbc_packager/application/config.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import shutil
 import subprocess
 from pathlib import Path

build/sbc_packager/application/engine.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import typer
 
 from .application.cli import application_command

build/sbc_packager/cli.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import json
 import re
 import shutil
@@ -70,9 +68,7 @@ def find_engine_loading_image(engine_directory: Path) -> Path | None:
     if not base_directory.is_dir():
         return None
     candidates = sorted(
-        path
-        for path in base_directory.iterdir()
-        if path.is_file() and path.suffix.lower() in SUPPORTED_IMAGE_SUFFIXES
+        path for path in base_directory.iterdir() if path.is_file() and path.suffix.lower() in SUPPORTED_IMAGE_SUFFIXES
     )
     preferred = base_directory / "RecoilEngine_4K.png"
     if preferred in candidates: