띄우고, 내보내

# Engine port and its Tailscale Serve twin, from the family registry (cwkFirelink
# port ledger), never spelled here (cwkPippa todo #549).
ENGINE_PORT = int(FAMILY_SERVICES["cwkAvatars"]["engine"])
TWIN_PORT = int(FAMILY_SERVICES["cwkAvatars"]["https"])

# Family addresses from the vendored registry (cwkSiblingKit todo #442). The studio
# runs on service host, so Pippa and Firelink are dialed on loopback; Ember lives on the
# server Mac and is dialed through its HTTPS twin, never a raw tailnet IP. The
# public origin is the studio's own twin. Every host follows the machine's host
# profile (Pippa's Ark).
PIPPA_ORIGIN = loopback_origin("cwkPippa")
EMBER_ORIGIN = twin_origin("cwkEmber")
FAMILY_ORIGIN = loopback_origin("cwkFirelink")
PUBLIC_ORIGIN = twin_origin("cwkAvatars")

def main():
    # One writer, on the Mac the family registry places cwkAvatars on (service host
    # unless the host profile moves it, cwkPippa todo #549).
    if not runs_here("cwkAvatars"):
        raise SystemExit("Avatars has one writer, on the Mac the family registry places it on.")
    logs = engine_data_root("avatars") / "logs"
    logs.mkdir(parents=True, exist_ok=True)
    destination = HOME_DIR / "Library/LaunchAgents" / f"{LABEL}.plist"
    body = {"Label": LABEL, "ProgramArguments": [str(PYTHON), "-m", "backend.serve"], "WorkingDirectory": str(ROOT), "RunAtLoad": True, "KeepAlive": True, "ThrottleInterval": 10, "StandardOutPath": str(logs / "serve-stdout.log"), "StandardErrorPath": str(logs / "serve-stderr.log"), "EnvironmentVariables": {"PYTHONUNBUFFERED": "1", "PATH": f"{PYTHON.parent}:/usr/bin:/bin:/usr/sbin:/sbin"}}
    destination.write_bytes(plistlib.dumps(body))
    domain = f"gui/{os.getuid()}"
    subprocess.run(["launchctl", "bootout", f"{domain}/{LABEL}"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
    subprocess.run(["launchctl", "bootstrap", domain, str(destination)], check=True)
    print(f"Installed {LABEL}; inspect /api/health before claiming it is live.")

# The four delivery facts after a TestFlight upload, read from App Store Connect —
# cwkPippa/docs/IOS-NATIVE-DELIVERY.md §1 keeps them apart, and the pipeline's
# `*_UPLOAD_OK` line asserts only the first:
#
#   1 uploaded       App Store Connect has the build
#   2 processed      Apple finished processing it (processingState VALID)
#   3 assigned       it is in internal testing (internalBuildState IN_BETA_TESTING)
#   4 installed      a tester installed it (the build's install count)
#
#   testflight-facts.sh <bundle-id> <build-number> [--wait <seconds>]
#
# One line per fact, then a machine line:
#   TESTFLIGHT_FACTS build=<n> uploaded=yes|no processed=yes|no|failed assigned=yes|no installed=yes|not_counted|unknown
# Fact 4 is App Store Connect's usage metric, which trails installs (measured 2026-09-25: a
# year-long data point, counts not live). A count above zero is a fact; zero is "not counted
# yet", never "not installed" — the phone's TestFlight app stays the witness.