feat(mosaic): unified first-run UX wizard -> gateway install -> verify (#418)

tools/install.sh

@@ -12,18 +12,21 @@
 #   curl -fsSL https://git.mosaicstack.dev/mosaicstack/mosaic-stack/raw/branch/main/tools/install.sh | bash -s --
 #
 # Flags:
-#   --check         Version check only, no install
-#   --framework     Install/upgrade framework only (skip npm CLI)
-#   --cli           Install/upgrade npm CLI only (skip framework)
-#   --ref <branch>  Git ref for framework archive (default: main)
+#   --check           Version check only, no install
+#   --framework       Install/upgrade framework only (skip npm CLI)
+#   --cli             Install/upgrade npm CLI only (skip framework)
+#   --ref <branch>    Git ref for framework archive (default: main)
+#   --yes             Accept all defaults; headless/non-interactive install
+#   --no-auto-launch  Skip automatic mosaic wizard + gateway install on first install
 #
 # Environment:
-#   MOSAIC_HOME      — framework install dir    (default: ~/.config/mosaic)
-#   MOSAIC_REGISTRY  — npm registry URL          (default: Gitea instance)
-#   MOSAIC_SCOPE     — npm scope                 (default: @mosaicstack)
-#   MOSAIC_PREFIX    — npm global prefix          (default: ~/.npm-global)
-#   MOSAIC_NO_COLOR  — disable colour             (set to 1)
-#   MOSAIC_REF       — git ref for framework      (default: main)
+#   MOSAIC_HOME         — framework install dir    (default: ~/.config/mosaic)
+#   MOSAIC_REGISTRY     — npm registry URL          (default: Gitea instance)
+#   MOSAIC_SCOPE        — npm scope                 (default: @mosaicstack)
+#   MOSAIC_PREFIX       — npm global prefix          (default: ~/.npm-global)
+#   MOSAIC_NO_COLOR     — disable colour             (set to 1)
+#   MOSAIC_REF          — git ref for framework      (default: main)
+#   MOSAIC_ASSUME_YES   — equivalent to --yes        (set to 1)
 # ──────────────────────────────────────────────────────────────────────────────
 #
 # Wrapped in main() for safe curl-pipe usage.
@@ -36,15 +39,24 @@ main() {
 FLAG_CHECK=false
 FLAG_FRAMEWORK=true
 FLAG_CLI=true
+FLAG_NO_AUTO_LAUNCH=false
+FLAG_YES=false
 GIT_REF="${MOSAIC_REF:-main}"
 
+# MOSAIC_ASSUME_YES env var acts the same as --yes
+if [[ "${MOSAIC_ASSUME_YES:-0}" == "1" ]]; then
+  FLAG_YES=true
+fi
+
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    --check)      FLAG_CHECK=true; shift ;;
-    --framework)  FLAG_CLI=false; shift ;;
-    --cli)        FLAG_FRAMEWORK=false; shift ;;
-    --ref)        GIT_REF="${2:-main}"; shift 2 ;;
-    *)            shift ;;
+    --check)          FLAG_CHECK=true; shift ;;
+    --framework)      FLAG_CLI=false; shift ;;
+    --cli)            FLAG_FRAMEWORK=false; shift ;;
+    --ref)            GIT_REF="${2:-main}"; shift 2 ;;
+    --yes|-y)         FLAG_YES=true; shift ;;
+    --no-auto-launch) FLAG_NO_AUTO_LAUNCH=true; shift ;;
+    *)                shift ;;
   esac
 done
 
@@ -301,12 +313,49 @@ if [[ "$FLAG_CHECK" == "false" ]]; then
   dim "  Framework data:  $MOSAIC_HOME/"
   echo ""
 
-  # First install guidance
+  # First install guidance / auto-launch
   if [[ ! -f "$MOSAIC_HOME/SOUL.md" ]]; then
     echo ""
-    info "First install detected. Set up your agent identity:"
-    echo "  ${C}mosaic init${RESET}     (interactive SOUL.md / USER.md setup)"
-    echo "  ${C}mosaic wizard${RESET}   (full guided wizard via Node.js)"
+    if [[ "$FLAG_NO_AUTO_LAUNCH" == "false" ]] && [[ -t 0 ]] && [[ -t 1 ]]; then
+      # Interactive TTY and auto-launch not suppressed: run wizard + gateway install
+      info "First install detected — launching setup wizard…"
+      echo ""
+
+      MOSAIC_BIN="$PREFIX/bin/mosaic"
+
+      if ! command -v "$MOSAIC_BIN" &>/dev/null && ! command -v mosaic &>/dev/null; then
+        warn "mosaic binary not found on PATH — skipping auto-launch."
+        warn "Add $PREFIX/bin to PATH and run: mosaic wizard && mosaic gateway install"
+      else
+        # Prefer the absolute path from the prefix we just installed to
+        MOSAIC_CMD="mosaic"
+        if [[ -x "$MOSAIC_BIN" ]]; then
+          MOSAIC_CMD="$MOSAIC_BIN"
+        fi
+
+        # Run wizard; if it fails we still try gateway install (best effort)
+        if "$MOSAIC_CMD" wizard; then
+          ok "Wizard complete."
+        else
+          warn "Wizard exited non-zero — continuing to gateway install."
+        fi
+
+        echo ""
+        info "Launching gateway install…"
+        if "$MOSAIC_CMD" gateway install; then
+          ok "Gateway install complete."
+        else
+          warn "Gateway install exited non-zero."
+          echo "  You can retry with: ${C}mosaic gateway install${RESET}"
+        fi
+      fi
+    else
+      # Non-interactive or --no-auto-launch: print guidance only
+      info "First install detected. Set up your agent identity:"
+      echo "  ${C}mosaic init${RESET}     (interactive SOUL.md / USER.md setup)"
+      echo "  ${C}mosaic wizard${RESET}   (full guided wizard via Node.js)"
+      echo "  ${C}mosaic gateway install${RESET}   (install and start the gateway)"
+    fi
   fi
 
   echo ""