boxd 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f49524201855c87e4519d024cb44bea9aa8e1025e447063abb6bc54d051ed45d
-  data.tar.gz: 1477bd7f3e17f61fc33774ba39ee6556b410a6d1b61fcf93cd6f97caf50374e4
+  metadata.gz: c522b2f321d84049fd8dd3d60cb82367edc2e4e587833020df8959ba6a13573b
+  data.tar.gz: 76708e00dcac901bcb25f3201e70d130a527d29176c1711145ebd5e4f9538063
 SHA512:
-  metadata.gz: 726612934833830a0280c892c10edc75a0dc3ce7d9cfc88f3d83dc4177bd32335e6558c25336b35bef226c783eca578c92e17665b476ae3d194d22b9d5949fb0
-  data.tar.gz: 9650055697701481d8e7cea406db62c7cd37604b0a8c1e45ef8b1a5b9f95a3ebc494ab504edee7df24e384008cad5a4b144f9ccbe4e483ed1760f062c60b74a9
+  metadata.gz: b47103a2b153dd685cbbe2bd80d001693c5db6a8636e0e513e8f53e0fd30b628a8624493f8cbdd21505813235601b7992b158a15554ac6fe70add2215329d1b5
+  data.tar.gz: f0da1fb7199421a2ddc9e940d827e264535dcc08690678dca4e07421a35a92c133c46d8f0a96471b232b2b2b476166ecfe2dc55ec80ecf065b0f06a0912816f3

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.1 — 2026-06-04
+
+First-run UX fixes for `boxd-dev`:
+
+- Top-level rescue prints a clear "Run `boxd login`" message instead of a
+  stack trace when the user isn't authenticated.
+- Auto-creates the golden VM if it doesn't exist yet, so `boxd-dev owner/repo`
+  works on a fresh boxd account with no prior setup.
+- Bundles the per-repo bootstrap script inside the gem (`lib/boxd/dev_bootstrap.sh`)
+  and uploads it to each fork at runtime — no dependency on a pre-baked golden.
+- Better handling of missing/unauthenticated `gh` CLI: skip the preflight
+  check instead of failing, and tell the user how to get the better errors back.
+
 ## 0.1.0 — 2026-06-04
 
 Initial release. CLI-backed v0.

data/boxd.gemspec

@@ -32,6 +32,7 @@ Gem::Specification.new do |spec|
 
   spec.files = Dir[
     "lib/**/*.rb",
+    "lib/boxd/dev_bootstrap.sh",
     "bin/boxd-dev",
     "README.md",
     "LICENSE",

data/lib/boxd/dev_bootstrap.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# Per-fork bootstrap. Uploaded by the boxd-dev binary every time it runs,
+# so the script always tracks the gem's version. Reads REPO_URL and
+# REPO_NAME from the environment.
+
+set -e
+echo "[bootstrap] $(date +%T) starting"
+cd ~
+
+if [ -n "${REPO_URL:-}" ] && [ -n "${REPO_NAME:-}" ] && [ ! -d "$REPO_NAME" ]; then
+  echo "[bootstrap] cloning $REPO_URL"
+  git clone "$REPO_URL"
+fi
+[ -n "${REPO_NAME:-}" ] && cd "$REPO_NAME" || exit 0
+
+# Prefer the project's own setup script if it ships one.
+for s in script/bootstrap script/setup bin/setup; do
+  if [ -x "$s" ]; then
+    echo "[bootstrap] running $s"
+    "$s"
+    echo "[bootstrap] done."
+    exit 0
+  fi
+done
+
+# Ecosystem-default install per detected manifest.
+if [ -f package.json ]; then
+  if [ -f pnpm-lock.yaml ]; then
+    command -v pnpm >/dev/null || sudo npm i -g pnpm
+    pnpm install
+  elif [ -f yarn.lock ]; then
+    command -v yarn >/dev/null || sudo npm i -g yarn
+    yarn install
+  else
+    npm install
+  fi
+fi
+if [ -f Cargo.toml ]; then
+  if ! command -v cargo >/dev/null; then
+    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \
+      | sh -s -- -y --default-toolchain stable --profile minimal
+  fi
+  . "$HOME/.cargo/env" 2>/dev/null || true
+  cargo fetch
+fi
+if [ -f mix.exs ]; then
+  if ! command -v mix >/dev/null; then
+    sudo apt-get update -qq && sudo apt-get install -y elixir
+  fi
+  mix local.hex --force && mix local.rebar --force
+  mix deps.get
+fi
+if [ -f Gemfile ]; then
+  if ! command -v bundle >/dev/null; then
+    sudo apt-get update -qq && sudo apt-get install -y ruby ruby-bundler
+  fi
+  bundle install
+fi
+if [ -f go.mod ] && command -v go >/dev/null; then
+  go mod download
+fi
+if [ -f pyproject.toml ] || [ -f requirements.txt ]; then
+  if ! command -v uv >/dev/null; then
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+  fi
+  export PATH="$HOME/.local/bin:$PATH"
+  if [ -f pyproject.toml ]; then
+    uv sync || true
+  else
+    uv pip install -r requirements.txt || pip install -r requirements.txt
+  fi
+fi
+echo "[bootstrap] done."

data/lib/boxd/dev_command.rb

@@ -20,15 +20,36 @@ module Boxd
   #   <bare VM name>                                # connect to existing
   class DevCommand
     GOLDEN_DEFAULT = "dev-golden"
-    BOOTSTRAP_PATH = "/usr/local/bin/dev-bootstrap"
+    BOOTSTRAP_LOCAL = File.expand_path("dev_bootstrap.sh", __dir__)
+    BOOTSTRAP_REMOTE = "/tmp/dev-bootstrap"
 
     def initialize(argv)
       @argv = argv
     end
 
     def run
-      arg = @argv.first || ENV["BOXD_DEV_VM"] || "dev-chad"
+      do_run
+    rescue Boxd::CLIMissingError => e
+      warn e.message
+      exit 1
+    rescue Boxd::AuthenticationError
+      warn <<~MSG
+        boxd-dev: you're not logged in to boxd yet.
+
+          Run:  boxd login
+
+        (or set BOXD_TOKEN to a long-lived API key from `boxd keys create`)
+      MSG
+      exit 1
+    rescue Boxd::Error => e
+      warn "boxd-dev: #{e.message}"
+      exit 1
+    end
+
+    private
 
+    def do_run
+      arg = @argv.first || ENV["BOXD_DEV_VM"] || "dev-chad"
       repo = parse_repo(arg)
       vm   = repo ? "dev-#{repo[:slug]}" : arg
       golden = ENV.fetch("BOXD_GOLDEN", GOLDEN_DEFAULT)
@@ -41,8 +62,6 @@ module Boxd
       exec_attach(box)
     end
 
-    private
-
     # ---- repo reference parsing ------------------------------------------
 
     def parse_repo(arg)
@@ -76,7 +95,14 @@ module Boxd
       return unless repo[:host] == "github.com"
 
       unless system("command -v gh > /dev/null 2>&1")
-        warn "boxd-dev: gh CLI not found; skipping repo existence check"
+        warn "boxd-dev: gh CLI not installed; skipping repo preflight check."
+        warn "  install for better errors: brew install gh && gh auth login"
+        return
+      end
+
+      unless system("gh auth status > /dev/null 2>&1")
+        warn "boxd-dev: gh not authenticated; skipping repo preflight check."
+        warn "  authenticate for better errors: gh auth login"
         return
       end
 
@@ -101,8 +127,9 @@ module Boxd
       end
 
       unless compute.boxes.find(golden)
-        warn "boxd-dev: golden VM '#{golden}' is missing (set BOXD_GOLDEN to override)"
-        exit 1
+        warn "boxd-dev: golden VM '#{golden}' doesn't exist yet — creating it..."
+        compute.boxes.create(name: golden, auto_suspend_timeout: 0)
+        warn "boxd-dev: created #{golden} (vanilla VM; bake setup into it later if you want)."
       end
 
       warn "boxd-dev: forking #{golden} → #{vm} (#{repo[:display]})..."
@@ -112,9 +139,15 @@ module Boxd
     # ---- tmux + bootstrap ------------------------------------------------
 
     # Ensure the persistent tmux session "dev" exists on the box. If a
-    # repo arg was given and the clone isn't there yet, kick off the
-    # bootstrap script in pane 0 so the attaching shell sees the build live.
+    # repo arg was given and the clone isn't there yet, upload the bundled
+    # bootstrap script and kick it off inside pane 0 — the attaching shell
+    # shows the build live and lands at a shell in the repo dir.
     def prep_tmux(box, repo)
+      # Upload the gem's bootstrap script on every run so it always tracks the
+      # gem version (cheap idempotent write).
+      box.write_file(BOOTSTRAP_REMOTE, File.read(BOOTSTRAP_LOCAL))
+      box.exec(["chmod", "+x", BOOTSTRAP_REMOTE])
+
       script = +<<~SH
         set -e
         if ! tmux has-session -t dev 2>/dev/null; then
@@ -124,7 +157,7 @@ module Boxd
       if repo
         script << <<~SH
           if [ ! -d "$HOME/#{repo[:repo]}" ]; then
-            tmux send-keys -t dev "REPO_URL='#{repo[:clone_url]}' REPO_NAME='#{repo[:repo]}' #{BOOTSTRAP_PATH} && cd ~/#{repo[:repo]}" Enter
+            tmux send-keys -t dev "REPO_URL='#{repo[:clone_url]}' REPO_NAME='#{repo[:repo]}' #{BOOTSTRAP_REMOTE} && cd ~/#{repo[:repo]}" Enter
           else
             tmux send-keys -t dev "cd ~/#{repo[:repo]}" Enter
           fi

data/lib/boxd/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Boxd
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: boxd
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - boxd contributors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-04 00:00:00.000000000 Z
+date: 2026-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -62,6 +62,7 @@ files:
 - lib/boxd/box_service.rb
 - lib/boxd/cli_backend.rb
 - lib/boxd/compute.rb
+- lib/boxd/dev_bootstrap.sh
 - lib/boxd/dev_command.rb
 - lib/boxd/errors.rb
 - lib/boxd/version.rb