feat: user-friendly menu gating, clearer install/configure path for backends

1 files changed, 9 insertions, 0 deletions

diff --git a/app/backends/__init__.py b/app/backends/__init__.py
index ef713ba..83f9866 100644
--- a/app/backends/__init__.py
+++ b/app/backends/__init__.py
@@ -95,6 +95,14 @@ class BackendStatus:
     downloaded); DETAILS then names them. The backend still counts as ready
     (the hub surfaces the warning), but a conversion would fail until the
     models are installed.
+
+    PARTIAL is an optional, more specific label for a backend that is set up
+    only part-way (neither running nor fully installed): audio.cpp reports
+    "downloaded (not built)" when its checkout exists but ``audiocpp_server``
+    was never built, and "built (not configured)" when the binary exists but
+    no ``server.json`` does. The hub shows it verbatim (amber) instead of the
+    generic "unavailable"/"installed" text, and dims the name while the
+    backend is still unusable.
     """
     key: str
     label: str
@@ -110,6 +118,7 @@ class BackendStatus:
     remote_urls: Dict[str, str] = field(default_factory=dict)
     remote_models: List[str] = field(default_factory=list)
     models_missing: bool = False
+    partial: str = ""
 
     @property
     def ready(self) -> bool: