unoverse 0.1.21 → 0.1.23

package/bin/unoverse.mjs

@@ -48,6 +48,11 @@ const UNIVERSE = findUniverse();
 
 // Everything the operator half owns. Listed here so an unknown command can say so,
 // rather than the two CLIs disagreeing about what exists.
+// NOTE: `update` is deliberately ABSENT. It always updates this CLI, wherever you are.
+// It used to mean the universe when you happened to be standing in one, which is the
+// same word pointing at two different objects, decided by your working directory. You
+// type it to update the CLI far more often than to refresh a local universe's images,
+// and that refresh now belongs to `start --pull`.
 const OPERATOR_COMMANDS = new Set([
   "start", "stop", "check", "logs", "deploy",
   // kept working, not advertised
@@ -94,9 +99,6 @@ switch (cmd) {
     break;
 
   case "update": {
-    // In a universe, "update" means THAT UNIVERSE (pull images, restart), not this CLI.
-    // Same word, different object, decided by where you are standing.
-    if (UNIVERSE) operator(UNIVERSE, ["update", ...args]);
     const r = spawnSync("npm", ["install", "-g", "unoverse@latest"], { stdio: "inherit" });
     if (r.status === 0) {
       const v = spawnSync("unoverse", ["-v"], { encoding: "utf8" }).stdout?.trim();

package/operator/lib/help.sh

@@ -18,7 +18,7 @@ cmd_help() {
   echo -e "    ${GREEN}update${NC}      Update this CLI"
   echo ""
   echo -e "  ${BOLD}This universe${NC}"
-  echo -e "    ${GREEN}start${NC}       Start it"
+  echo -e "    ${GREEN}start${NC}       Start it ${DIM}(--pull for the latest images)${NC}"
   echo -e "    ${GREEN}stop${NC}        Stop it"
   echo -e "    ${GREEN}check${NC}       Is it healthy ${DIM}(services, schema, environment)${NC}"
   echo -e "    ${GREEN}logs${NC}        What is it doing ${DIM}(unoverse logs <service> for one)${NC}"

package/operator/lib/start.sh

@@ -41,6 +41,15 @@ cmd_start() {
     echo "$docr_token" | docker login registry.digitalocean.com -u "$docr_token" --password-stdin >/dev/null 2>&1 || true
   fi
 
+  # `start --pull` refreshes the images first. This is where refreshing a LOCAL universe
+  # lives now: `update` is the CLI's word and means only the CLI, wherever you type it.
+  # A server is refreshed by `unoverse deploy` from your machine, not on the box.
+  if [ "${1:-}" = "--pull" ]; then
+    info "Pulling the latest images..."
+    docker compose -f "$ROOT/docker-compose.yml" pull || { fail "Image pull failed"; exit 1; }
+    echo ""
+  fi
+
   check_docker_file_sharing || exit 1
   check_first_run
   banner "Starting Unoverse Platform"

package/operator/operator.sh

@@ -57,7 +57,7 @@ source "$GRAVITY_LIB/ground.sh"
 # operate a universe. Studio is a separate app; authoring happens there.)
 case "${1:-}" in
   init)      cmd_init ;;
-  start)     cmd_start ;;
+  start)     shift; cmd_start "$@" ;;
   stop)      cmd_stop ;;
   status)    cmd_check ;;   # alias — status merged into check 2026-07-28
   logs)      cmd_logs "${2:-}" ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "The Unoverse front door — create a Studio project, a universe, or a client app, and launch Studio.",
   "license": "SEE LICENSE IN README.md",
   "type": "module",