feat(configurator): .desktop + launcher -- GNOME Dock / Activities + WSLg Start Menu

Two surfaces, one .desktop file:

usr/share/applications/mios-configurator.desktop
  Standard freedesktop.org desktop entry. On a deployed bare-metal /
  Hyper-V / QEMU MiOS host this surfaces in the GNOME Dock + Activities
  + Application Grid. On a Windows-side MiOS-DEV podman backend, WSLg
  auto-publishes installed .desktop files into the Windows Start Menu
  under "<Distro> Apps" so the same icon shows up there too. One file,
  two operator surfaces.

usr/libexec/mios/mios-configurator-launch
  The Exec= target. Stages a writable mios.toml seed at
  ~/Downloads/mios.toml (highest layer wins: per-user > host > vendor),
  copies the configurator HTML to ~/Downloads/mios-configurator.html
  (Flatpak home-portal exposes that path), and launches:
    1. Epiphany flatpak (org.gnome.Epiphany) -- best File System
       Access API support; WSLg routes the window to the Windows
       desktop on MiOS-DEV
    2. xdg-open                              -- whatever browser the
       deployed-host's GNOME has registered as default
    3. Plain echo of the file:// URL         -- last-resort surface
       (operator copy/pastes into a browser manually)

.gitignore: whitelist /usr/share/applications/mios-*.desktop so the
new entry is tracked.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: Kabuki94

.gitignore

@@ -184,6 +184,12 @@ usr/share/doc/*
 !/usr/share/doc/mios/**
 !/usr/share/mios/
 !/usr/share/mios/**
+# Desktop-entry .desktop files for the GNOME Dock / Activities (deployed
+# hosts) and the WSLg-published Windows Start Menu (MiOS-DEV). Only
+# MiOS-owned entries are tracked.
+!/usr/share/applications/
+usr/share/applications/*
+!/usr/share/applications/mios-*.desktop
 # AI runtime state (memory, knowledge graphs, scratch) belongs in
 # mios-bootstrap.git -- it is per-host and seeded into /var at first
 # boot. The OpenAI-API surface manifests in usr/share/mios/ai/v1/

usr/libexec/mios/mios-configurator-launch

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# /usr/libexec/mios/mios-configurator-launch -- open the MiOS HTML
+# configurator in a sensible browser, with the layered mios.toml
+# pre-staged in ~/Downloads so File System Access API can bind to it
+# (or fall back to the standard <input type="file">).
+#
+# Targets, in order of preference:
+#   1. Epiphany flatpak (org.gnome.Epiphany)   -- best FSA support;
+#      WSLg routes the window to the Windows desktop.
+#   2. xdg-open                                -- whatever the host
+#      desktop has set as default browser.
+#   3. Plain echo of the URL                   -- last resort if
+#      nothing else is available.
+#
+# Invoked from:
+#   - /usr/share/applications/mios-configurator.desktop (GNOME Dock /
+#     Activities on deployed hosts; Windows Start Menu via WSLg on
+#     MiOS-DEV)
+#   - Windows-side `MiOS Configurator.lnk` Start Menu / Desktop
+#     shortcuts (which call `wsl -d podman-MiOS-DEV --exec
+#     /usr/libexec/mios/mios-configurator-launch`)
+set -euo pipefail
+
+HTML=/usr/share/mios/configurator/index.html
+DL_DIR="${HOME}/Downloads"
+mkdir -p "$DL_DIR"
+
+# Stage a writable mios.toml seed (highest layer wins).
+if [[ ! -f "$DL_DIR/mios.toml" ]]; then
+    for src in "$HOME/.config/mios/mios.toml" /etc/mios/mios.toml /usr/share/mios/mios.toml; do
+        if [[ -r "$src" ]]; then
+            cp "$src" "$DL_DIR/mios.toml"
+            chmod 0644 "$DL_DIR/mios.toml"
+            break
+        fi
+    done
+fi
+
+# Stage the HTML where Flatpak's home-portal exposes it.
+if [[ -r "$HTML" ]]; then
+    cp "$HTML" "$DL_DIR/mios-configurator.html"
+fi
+
+URL="file://$DL_DIR/mios-configurator.html"
+[[ ! -f "$DL_DIR/mios-configurator.html" ]] && URL="file://$HTML"
+
+# Try Epiphany flatpak first.
+if flatpak list --app --columns=application 2>/dev/null | grep -qx org.gnome.Epiphany; then
+    exec flatpak run --system org.gnome.Epiphany "$URL" >/dev/null 2>&1 &
+    disown
+    echo "MiOS Configurator opened in Epiphany: $URL"
+    exit 0
+fi
+
+# Fall back to xdg-open (delegates to whatever browser is registered).
+if command -v xdg-open >/dev/null 2>&1; then
+    exec xdg-open "$URL" >/dev/null 2>&1 &
+    disown
+    echo "MiOS Configurator opened via xdg-open: $URL"
+    exit 0
+fi
+
+# Last resort: print the URL so the operator can copy/paste.
+echo "MiOS Configurator URL (no browser found):"
+echo "  $URL"
+echo "Edit ~/Downloads/mios.toml and re-run mios-rebuild to apply."
+exit 0

usr/share/applications/mios-configurator.desktop

@@ -0,0 +1,18 @@
+[Desktop Entry]
+Type=Application
+Version=1.0
+Name=MiOS Configurator
+GenericName=System Configuration Editor
+Comment=Edit /etc/mios/mios.toml — identity, AI, packages, flatpaks, desktop
+Exec=/usr/libexec/mios/mios-configurator-launch
+Icon=preferences-system
+Categories=System;Settings;PackageManager;
+Keywords=mios;configurator;system;settings;packages;flatpak;ai;
+Terminal=false
+StartupNotify=true
+StartupWMClass=org.gnome.Epiphany
+# WSLg auto-publishes this entry to the Windows Start Menu under
+# "<Distro> Apps" when MiOS-DEV is the source distro, so the same
+# .desktop file gives Linux GNOME Dock + Activities visibility on a
+# deployed MiOS host AND a Windows Start Menu entry on the Win-side
+# dev VM. One file, two surfaces.