docs: register experimental mobile shell repo

Author: Code4me2

README.md

@@ -9,7 +9,8 @@ architecture, deployment, and verification flow.
 
 ## Component repos
 
-- `hestia-shell` — QML shell surface, orb, drawers, assistant UI state.
+- `hestia-mobile-shell` — experimental PureOS/Phosh AI-primary mobile visual layer.
+- `hestia-shell` — desktop/laptop QML shell surface and reference assistant UI model.
 - `hestia-ai-bridge` — phone-local AI socket and assistant event bus.
 - `unmute-streaming-client` — phone microphone/speaker realtime voice client.
 - `unmute` — backend realtime voice/STT/TTS service on inference hardware.

docs/plans/mobile-ai-primary-ui.md

@@ -125,22 +125,16 @@ When the user explicitly wants normal apps:
 
 ## Recommended repo decision
 
-Create a separate repo when implementation starts:
+Implementation has started in a separate repo:
 
 ```text
 Code4me2/hestia-mobile-shell
+https://github.com/Code4me2/hestia-mobile-shell
 ```
 
-Alternative names:
+`hestia-mobile-shell` is the mobile-native AI-primary visual layer for PureOS/Phosh. The scope is broader than a single app, but it remains clearly separate from desktop `hestia-shell`.
 
-```text
-Code4me2/hestia-mobile-ui
-Code4me2/hestia-phosh-shell
-```
-
-Recommendation: use `hestia-mobile-shell` because the scope is broader than a single app, but still clearly separate from desktop `hestia-shell`.
-
-`hestia-mobile` remains the integration/meta repo and should reference this future repo in `mobile-stack.json` once created.
+`hestia-mobile` remains the integration/meta repo and now references this experimental repo in `mobile-stack.json`.
 
 ## What to keep from current work
 

mobile-stack.json

@@ -9,6 +9,13 @@
       "branch": "main",
       "owner": "integration"
     },
+    "hestia-mobile-shell": {
+      "path": "/home/purism/projects/ai-phone-review/hestia-mobile-shell",
+      "remote": "git@github.com:Code4me2/hestia-mobile-shell.git",
+      "branch": "main",
+      "owner": "mobile-shell-ui",
+      "status": "experimental"
+    },
     "hestia-shell": {
       "path": "/home/purism/projects/ai-phone-review/hestia-shell",
       "remote": "git@github.com:Code4me2/hestia-shell.git",
@@ -56,9 +63,18 @@
     "voice_output_device": 11
   },
   "health_policy": {
-    "unmute_required_true": ["stt_up", "tts_up", "llm_up", "ok"],
-    "unmute_non_blocking_false": ["voice_cloning_up"],
-    "bridge_required_true": ["orchestrator_online"],
+    "unmute_required_true": [
+      "stt_up",
+      "tts_up",
+      "llm_up",
+      "ok"
+    ],
+    "unmute_non_blocking_false": [
+      "voice_cloning_up"
+    ],
+    "bridge_required_true": [
+      "orchestrator_online"
+    ],
     "orchestrator_required_status": "healthy"
   }
 }