Improve installer startup feedback and add upgrade command

Author: RhysSullivan

executor/README.md

@@ -79,6 +79,7 @@ Common binary commands:
 
 ```bash
 executor doctor
+executor upgrade
 executor down
 executor up
 executor web

executor/executor.ts

@@ -35,6 +35,7 @@ function printHelp(): void {
 
 Usage:
   executor doctor [--verbose]
+  executor upgrade [--version <version>]
   executor up [backend-args]
   executor down
   executor backend <args>
@@ -43,6 +44,7 @@ Usage:
 
 Commands:
   doctor        Show install health and quick status
+  upgrade       Re-run installer to update executor
   up            Run managed backend and auto-bootstrap Convex functions
   down          Stop background backend/web services started by installer
   backend       Pass through arguments to managed convex-local-backend binary
@@ -488,6 +490,96 @@ Options:
   return 0;
 }
 
+async function runUpgrade(args: string[]): Promise<number> {
+  let requestedVersion: string | undefined;
+  let noModifyPath = false;
+  let noStarPrompt = false;
+  let index = 0;
+
+  while (index < args.length) {
+    const arg = args[index];
+
+    if (arg === "-h" || arg === "--help") {
+      console.log(`Usage:
+  executor upgrade [--version <version>] [--no-modify-path] [--no-star-prompt]
+
+Aliases:
+  executor update
+
+Options:
+  -v, --version <version>  Install specific release version
+  --no-modify-path         Do not modify shell PATH entries
+  --no-star-prompt         Do not print GitHub star prompt
+  -h, --help               Show this help`);
+      return 0;
+    }
+
+    if (arg === "-v" || arg === "--version") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("-")) {
+        console.log("Missing value for --version");
+        return 1;
+      }
+      requestedVersion = value;
+      index += 2;
+      continue;
+    }
+
+    if (arg === "--no-modify-path") {
+      noModifyPath = true;
+      index += 1;
+      continue;
+    }
+
+    if (arg === "--no-star-prompt") {
+      noStarPrompt = true;
+      index += 1;
+      continue;
+    }
+
+    console.log(`Unknown option: ${arg}`);
+    return 1;
+  }
+
+  const installUrl = Bun.env.EXECUTOR_INSTALL_URL ?? "https://executor.sh/install";
+  console.log(`[executor] upgrading via ${installUrl}`);
+
+  const response = await fetch(installUrl);
+  if (!response.ok) {
+    throw new Error(`Failed to download installer: ${response.status} ${response.statusText}`);
+  }
+
+  const script = await response.text();
+  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "executor-upgrade-"));
+  const scriptPath = path.join(tempDir, "install.sh");
+
+  try {
+    await fs.writeFile(scriptPath, script, "utf8");
+    await fs.chmod(scriptPath, 0o755);
+
+    const installerArgs: string[] = [];
+    if (requestedVersion) {
+      installerArgs.push("--version", requestedVersion);
+    }
+    if (noModifyPath) {
+      installerArgs.push("--no-modify-path");
+    }
+    if (noStarPrompt) {
+      installerArgs.push("--no-star-prompt");
+    }
+
+    const proc = Bun.spawn(["bash", scriptPath, ...installerArgs], {
+      env: process.env,
+      stdin: "inherit",
+      stdout: "inherit",
+      stderr: "inherit",
+    });
+    return await proc.exited;
+  } finally {
+    await fs.rm(tempDir, { recursive: true, force: true });
+  }
+}
+
 async function run(): Promise<void> {
   const [command, ...rest] = process.argv.slice(2);
 
@@ -501,6 +593,11 @@ async function run(): Promise<void> {
     process.exit(exitCode);
   }
 
+  if (command === "upgrade" || command === "update") {
+    const exitCode = await runUpgrade(rest);
+    process.exit(exitCode);
+  }
+
   if (command === "down" || command === "stop") {
     const exitCode = await runDown(rest);
     process.exit(exitCode);

executor/install

@@ -303,8 +303,7 @@ start_background_services() {
     if wait_for_http "http://127.0.0.1:${BACKEND_PORT}/version"; then
       echo -e "${MUTED}Started managed backend${NC} http://127.0.0.1:${BACKEND_PORT}"
     else
-      echo -e "${RED}Managed backend did not become ready automatically.${NC}"
-      echo "  Check logs: $LOG_DIR/backend.log"
+      echo -e "${MUTED}Managed backend is still initializing${NC} (continuing readiness checks)"
     fi
   fi
 
@@ -318,29 +317,65 @@ start_background_services() {
     if wait_for_http "http://127.0.0.1:${WEB_PORT}/"; then
       echo -e "${MUTED}Started web UI${NC} http://127.0.0.1:${WEB_PORT}"
     else
-      echo -e "${RED}Web UI did not become ready automatically.${NC}"
-      echo "  Check logs: $LOG_DIR/web.log"
+      echo -e "${MUTED}Web UI is still initializing${NC} (continuing readiness checks)"
     fi
   fi
 }
 
 wait_for_executor_ready() {
-  local max_seconds="${1:-120}"
-  local started
+  local max_seconds="${1:-90}"
+  local started now elapsed
+  local doctor_interval=5
+  local last_doctor_at=0
+  local backend_up=0
+  local web_up=0
+  local doctor_ok=1
+
   started="$(date +%s)"
+  echo -e "${MUTED}Waiting for services to become healthy (up to ${max_seconds}s)${NC}"
 
   while true; do
-    if "$INSTALL_DIR/$APP" doctor >/dev/null 2>&1; then
-      echo -e "${MUTED}Executor services healthy${NC}"
-      return 0
+    if wait_for_http "http://127.0.0.1:${BACKEND_PORT}/version" 1; then
+      backend_up=1
+    fi
+    if wait_for_http "http://127.0.0.1:${WEB_PORT}/" 1; then
+      web_up=1
     fi
 
-    local now
     now="$(date +%s)"
-    if (( now - started >= max_seconds )); then
+    elapsed=$((now - started))
+
+    if (( backend_up == 1 && web_up == 1 )); then
+      if (( now - last_doctor_at >= doctor_interval )); then
+        if "$INSTALL_DIR/$APP" doctor >/dev/null 2>&1; then
+          echo -e "${MUTED}Executor services healthy${NC}"
+          return 0
+        fi
+        last_doctor_at=$now
+      fi
+      doctor_ok=0
+    fi
+
+    if (( elapsed >= max_seconds )); then
       break
     fi
 
+    if (( elapsed > 0 && elapsed % 5 == 0 )); then
+      if (( backend_up == 0 || web_up == 0 )); then
+        local backend_state="starting"
+        local web_state="starting"
+        if (( backend_up == 1 )); then
+          backend_state="running"
+        fi
+        if (( web_up == 1 )); then
+          web_state="running"
+        fi
+        echo -e "${MUTED}Still starting... backend=${backend_state} web=${web_state}${NC}"
+      elif (( doctor_ok == 0 )); then
+        echo -e "${MUTED}Services up; waiting for Convex functions bootstrap...${NC}"
+      fi
+    fi
+
     sleep 0.5
   done
 
@@ -384,6 +419,7 @@ fi
 echo "Dashboard: http://localhost:${WEB_PORT}"
 echo "Use:"
 echo "  executor doctor            # friendly health check"
+echo "  executor upgrade           # update to latest release"
 echo "  executor down              # stop background services"
 echo "  executor up                # start backend manually"
 echo "  executor web               # start web manually"

executor/package.json

@@ -19,6 +19,7 @@
     "iac:diff": "bun run --cwd infra diff",
     "iac:remove": "bun run --cwd infra remove",
     "up": "bun run executor.ts up",
+    "upgrade": "bun run executor.ts upgrade",
     "down": "bun run executor.ts down",
     "backend": "bun run executor.ts backend",
     "convex": "bun run executor.ts backend",