"""
Build helpers for the Prole installer (root-level package).

UI-agnostic command composition for the Prole macOS app build.
"""
from __future__ import annotations

from pathlib import Path


def get_build_command(project_root: Path, env: str | None) -> str:
    """Return the Prole app build command with an env comment suffix.

    Example output:
    cd "/path/to/repo" && ./prole-app/build.sh build # Dev
    """
    env_label = (env or "Dev").strip().title()
    prole_root = str(project_root)
    return f"cd \"{prole_root}\" && ./prole-app/build.sh build # {env_label}"