feat: show installation method in settings footer (#2231)

* feat: show installation method in settings footer

* test: register shared unknown locale string

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: kingpanther13

src/ha_mcp/settings_ui/locales/en.json

@@ -13,6 +13,13 @@
     "theme.light": "Light",
     "theme.dark": "Dark",
     "status.loading": "Loading…",
+    "footer.installation": "installation: {method}",
+    "footer.deployment.addon": "app/add-on",
+    "footer.deployment.docker": "container/docker",
+    "footer.deployment.pyinstaller": "standalone binary",
+    "footer.deployment.git": "source checkout",
+    "footer.deployment.pypi": "python package",
+    "footer.deployment.unknown": "unknown",
     "nav.skip": "Skip to content",
     "tabs.aria": "Settings sections",
     "tabs.tools": "Tools",

src/ha_mcp/settings_ui/settings.js

@@ -536,14 +536,36 @@ async function applyInfoChrome() {
         '⚠ Changes saved. Restart the ha-mcp process, then refresh the MCP tool list in your AI client.'
       );
     }
-    // Version footer — show the running ha-mcp build at the bottom
-    // of every page. ``info.version`` is whatever
-    // ``HA_MCP_BUILD_VERSION`` the addon's Dockerfile set (e.g.
-    // ``7.5.0`` on stable, ``7.5.0.dev355`` on dev), with a fallback
-    // to package metadata in standalone deployments.
+    // Footer — show the running build and the same deployment classification
+    // used by ha_report_issue. The backend keeps embedded and sidecar distinct
+    // because they need different restart behavior; preserve those concise
+    // names here and clarify the less obvious packaging-oriented values.
     if (info.version) {
       const fEl = document.getElementById('versionFooterText');
-      if (fEl) fEl.textContent = 'ha-mcp ' + info.version;
+      const deploymentMode = typeof info.deployment_mode === 'string'
+        ? info.deployment_mode
+        : '';
+      const deploymentLabels = {
+        embedded: 'embedded',
+        sidecar: 'sidecar',
+        addon: t('footer.deployment.addon', {}, 'app/add-on'),
+        docker: t('footer.deployment.docker', {}, 'container/docker'),
+        pyinstaller: t('footer.deployment.pyinstaller', {}, 'standalone binary'),
+        git: t('footer.deployment.git', {}, 'source checkout'),
+        pypi: t('footer.deployment.pypi', {}, 'python package'),
+        unknown: t('footer.deployment.unknown', {}, 'unknown'),
+      };
+      const deploymentLabel = Object.prototype.hasOwnProperty.call(
+        deploymentLabels, deploymentMode
+      ) ? deploymentLabels[deploymentMode] : deploymentMode;
+      const installation = deploymentLabel
+        ? ' · ' + t(
+          'footer.installation',
+          {method: deploymentLabel},
+          'installation: {method}'
+        )
+        : '';
+      if (fEl) fEl.textContent = 'ha-mcp ' + info.version + installation;
     }
   } catch (e) {
     // A transient /api/settings/info failure must not leave the restart

tests/src/unit/test_locale_parity.py

@@ -678,8 +678,10 @@ def test_derived_catalogs_match_the_canonical_store() -> None:
 AUTHORED_SHARED_PLACES = {
     "src/ha_mcp/settings_ui/locales": (
         "messages.advanced.extra_yaml_write_keys.label",
+        "messages.footer.deployment.unknown",
     ),
     "custom_components/ha_mcp_tools/translations": (
+        "common.version_unknown",
         "options.step.tools_info.data.extra_yaml_keys",
     ),
 }

tests/src/unit/test_settings_ui_js_behavior.py

@@ -628,11 +628,19 @@ def _assert_clean_init(result: HarnessResult) -> None:
 
 
 class TestVersionFooter:
-    """The version footer at the bottom of the settings page reads from
-    /api/settings/info on init and renders ``ha-mcp <version>`` so an
-    operator can see the running build without leaving the UI.
+    """The footer at the bottom of the settings page reads from
+    /api/settings/info on init and renders the running version and installation
+    method so an operator can identify the active build without leaving the UI.
     """
 
+    @staticmethod
+    def _footer_text(result: HarnessResult) -> str:
+        match = re.search(r'id="versionFooterText">([^<]*)</div>', result.dom)
+        assert match is not None, (
+            f"version footer missing; dom tail: {result.dom[-1500:]}"
+        )
+        return match.group(1)
+
     def test_version_rendered_from_settings_info(self, settings_script: str) -> None:
         fetches = {
             **DEFAULT_FETCHES,
@@ -654,8 +662,103 @@ def test_version_rendered_from_settings_info(self, settings_script: str) -> None
             invoke="await new Promise(r => setTimeout(r, 200));",
         )
         _assert_clean_init(result)
-        assert "ha-mcp 7.5.0.dev400" in result.dom, (
-            f"version footer missing or wrong; dom tail: {result.dom[-1500:]}"
+        assert self._footer_text(result) == "ha-mcp 7.5.0.dev400"
+
+    @pytest.mark.parametrize(
+        ("deployment_mode", "expected_label"),
+        [
+            ("embedded", "embedded"),
+            ("sidecar", "sidecar"),
+            ("addon", "app/add-on"),
+            ("docker", "container/docker"),
+            ("pyinstaller", "standalone binary"),
+            ("git", "source checkout"),
+            ("pypi", "python package"),
+            ("unknown", "unknown"),
+            ("future-mode", "future-mode"),
+            ("constructor", "constructor"),
+        ],
+    )
+    def test_installation_method_rendered_from_settings_info(
+        self,
+        settings_script: str,
+        deployment_mode: str,
+        expected_label: str,
+    ) -> None:
+        fetches = {
+            **DEFAULT_FETCHES,
+            "/api/settings/info": {
+                "status": 200,
+                "json": {
+                    "is_addon": deployment_mode == "addon",
+                    "is_sidecar": deployment_mode == "sidecar",
+                    "deployment_mode": deployment_mode,
+                    "instance_id": "test-id",
+                    "started_at": 0,
+                    "version": "8.2.0",
+                },
+            },
+        }
+        result = run_script(
+            settings_script,
+            initial_html=MIN_DOM,
+            fetch_map=fetches,
+            invoke="await new Promise(r => setTimeout(r, 200));",
+        )
+        _assert_clean_init(result)
+        assert (
+            self._footer_text(result)
+            == f"ha-mcp 8.2.0 · installation: {expected_label}"
+        )
+
+    @pytest.mark.parametrize(
+        ("deployment_mode", "translated_label"),
+        [("embedded", "intégré"), ("sidecar", "accompagnement")],
+    )
+    def test_server_mode_labels_stay_raw_when_footer_phrase_is_localized(
+        self,
+        settings_script: str,
+        deployment_mode: str,
+        translated_label: str,
+    ) -> None:
+        from ha_mcp.settings_ui._i18n import build_payload, serialize_payload
+
+        catalog = build_payload("fr")
+        catalog["messages"].update(
+            {
+                "footer.installation": "mode d’installation : {method}",
+                f"footer.deployment.{deployment_mode}": translated_label,
+            }
+        )
+        payload = serialize_payload(catalog)
+        localized_dom = MIN_DOM.replace(
+            "</body>",
+            f'<script id="ha-mcp-i18n" type="application/json">{payload}</script>'
+            "</body>",
+        )
+        fetches = {
+            **DEFAULT_FETCHES,
+            "/api/settings/info": {
+                "status": 200,
+                "json": {
+                    "is_addon": False,
+                    "is_sidecar": deployment_mode == "sidecar",
+                    "deployment_mode": deployment_mode,
+                    "instance_id": "test-id",
+                    "started_at": 0,
+                    "version": "8.2.0",
+                },
+            },
+        }
+        result = run_script(
+            settings_script,
+            initial_html=localized_dom,
+            fetch_map=fetches,
+            invoke="await new Promise(r => setTimeout(r, 200));",
+        )
+        _assert_clean_init(result)
+        assert self._footer_text(result) == (
+            f"ha-mcp 8.2.0 · mode d’installation : {deployment_mode}"
         )
 
     def test_version_omitted_when_info_response_lacks_version(
@@ -684,7 +787,7 @@ def test_version_omitted_when_info_response_lacks_version(
             invoke="await new Promise(r => setTimeout(r, 200));",
         )
         _assert_clean_init(result)
-        assert "ha-mcp undefined" not in result.dom
+        assert self._footer_text(result) == ""
 
 
 class TestXssGuard: