gdkbox 0.1.15 → 0.1.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d9c5210ae4aa4a4b61bcbba7431b83759e39de9d2621dd93f27f51d7ead4b7b
-  data.tar.gz: d60b1306ff0df5e95c32437574e4caa9be879b8ad735bae3af2092cc854d4d61
+  metadata.gz: ee5748a17847e4b6d1390b5a12d52c964cc5ce5a5ec4cf2f4ede5dbc093d39c6
+  data.tar.gz: 000363cc6e8a0c5ef47bc26ca86556a16188c8cf7ab91aeae64698db6c0f01d7
 SHA512:
-  metadata.gz: 14b31086f6ae0df58074b07236dd6824afd1f0bba5bc76c5e5311e1847f4d962a7e989599805d72ea547a641f7afeac79b5c68321aedee5beafe8d025077327a
-  data.tar.gz: 79423220439fd62c3d16cd0d266c8583f11696bb538e1c26cee8fbd20813cf623a2c027b80b9903dddf765091e74c279f9a54e18d45f78fefae9428ffceec802
+  metadata.gz: 8cbe190b3bebaeca9e0ae149d1e3f3ce542168f757a808c2f6efc005773393463fc4b8cc9f5079a1cd072ff1102fb6109691efcd76072251f7e05bbfb32cc4b5
+  data.tar.gz: 8274f14772efd5630fd685366c22c34c08ef3561af0faf0e563d145616a6a789bb715edfc631db6ae0d096ef60d758a0d0dced17c141288c09a421458831a702

data/README.md

@@ -112,6 +112,7 @@ Or run it straight from the checkout without installing:
 | `--image` | official GDK image | Override the container image. |
 | `--ssh-port` | next free from 2222 | Host port to publish SSH on. Auto-allocation skips ports in use on the host (e.g. a local GDK). |
 | `--web-port` | next free from 3000 | Host port to publish the GDK web UI on. Auto-allocation skips ports in use on the host. |
+| `--vite-port` | next free from 3038 | Port for vite assets. Published with the **same number inside and outside** the box (asset URLs embed it); GDK in the box is reconfigured to match. |
 | `--harness ID` | `claude` (or config.yml) | Agent harness to install: claude, codex, opencode, pi. |
 | `--no-agent` | (agent installed) | Skip installing the agent harness. |
 | `--skill NAME [NAME...]` | (none) | Seed skill(s) into the box at creation for dispatched agents. |

data/lib/gdkbox/box.rb

@@ -56,6 +56,10 @@ module GDKBox
       data && data["web_port"]
     end
 
+    def vite_port
+      data && data["vite_port"]
+    end
+
     def web_url
       "http://127.0.0.1:#{web_port}"
     end
@@ -85,8 +89,9 @@ module GDKBox
     # fields go into the same locked store write as the port reservation, so
     # there is no window in which another orchestrator's `claim` can grab a
     # box this one is still provisioning.
-    def create!(image: nil, ssh_port: nil, web_port: nil, harness: Harness.default,
-      install_agent: true, api_key: nil, claim_owner: nil, claim_ttl: nil)
+    def create!(image: nil, ssh_port: nil, web_port: nil, vite_port: nil,
+      harness: Harness.default, install_agent: true, api_key: nil,
+      claim_owner: nil, claim_ttl: nil)
       raise Error, "Box '#{name}' already exists" if exists?
 
       harness = Harness[harness]
@@ -104,8 +109,9 @@ module GDKBox
       # port and collide at `docker run`. Holding an exclusive lock while we
       # choose ports *and* persist a preliminary record makes each sibling see
       # the others' reservations.
-      ssh_port, web_port = reserve_ports!(
-        cname, ssh_port, web_port, claim_owner: claim_owner, claim_ttl: claim_ttl
+      ssh_port, web_port, vite_port = reserve_ports!(
+        cname, ssh_port, web_port, vite_port,
+        claim_owner: claim_owner, claim_ttl: claim_ttl
       )
 
       begin
@@ -118,7 +124,10 @@ module GDKBox
           hostname: Config::GDK_HOSTNAME,
           publish: [
             "127.0.0.1:#{ssh_port}:#{Config::SSH_CONTAINER_PORT}",
-            "127.0.0.1:#{web_port}:#{Config::GDK_WEB_CONTAINER_PORT}"
+            "127.0.0.1:#{web_port}:#{Config::GDK_WEB_CONTAINER_PORT}",
+            # Same number on both sides: asset URLs embed this port, so what
+            # the browser dials must be where vite listens (see VITE_PORT_BASE).
+            "127.0.0.1:#{vite_port}:#{vite_port}"
           ],
           labels: { "gdkbox" => "true", "gdkbox.name" => name }
         )
@@ -145,6 +154,17 @@ module GDKBox
       )
       @store.save(@data)
 
+      # Align vite's in-container listen port with the published one so asset
+      # URLs work from the host browser. Best-effort — the box is fully
+      # usable for SSH/agent work without it — but the outcome is recorded
+      # so `status`/`ls --json` can surface a box whose assets won't load.
+      @data["vite_port_configured"] = begin
+        provisioner.setup_vite_port(cname, vite_port)
+        true
+      rescue StandardError
+        false
+      end
+
       # Best-effort: a host without a git identity (or a transient exec
       # failure) should not abort the box; `gdkbox set-git` can seed it later.
       begin
@@ -454,6 +474,10 @@ module GDKBox
         # Back-compat: orchestrators predating multi-harness check this field.
         "claude_installed" => (harness.id == "claude" && (data && data["agent_installed"])) || false,
         "api_key_set" => (data && data["api_key_set"]) || false,
+        # Vite assets: the published port (nil on boxes created before vite
+        # support) and whether the in-box alignment step succeeded.
+        "vite_port" => vite_port,
+        "vite_port_configured" => (data && data["vite_port_configured"]) || false,
         # Active claim (nil when free; an expired lease counts as free).
         "claimed_by" => claimed_by,
         "claim_expires_at" => (claimed_by ? data["claim_expires_at"] : nil)
@@ -494,8 +518,9 @@ module GDKBox
     # than the cryptic bind error `docker run` would produce later.
     # A claim_owner is written into this same record, so the box is claimed
     # from the instant it becomes visible to other processes.
-    def reserve_ports!(cname, ssh_port, web_port, claim_owner: nil, claim_ttl: nil)
-      { "--ssh-port" => ssh_port, "--web-port" => web_port }.each do |flag, port|
+    def reserve_ports!(cname, ssh_port, web_port, vite_port, claim_owner: nil, claim_ttl: nil)
+      { "--ssh-port" => ssh_port, "--web-port" => web_port,
+        "--vite-port" => vite_port }.each do |flag, port|
         if port && Ports.bound?(port)
           raise Error, "Port #{port} (#{flag}) is already in use on 127.0.0.1."
         end
@@ -504,11 +529,13 @@ module GDKBox
       with_create_lock do
         ssh_port ||= next_port(Config::SSH_PORT_BASE)
         web_port ||= next_port(Config::WEB_PORT_BASE, exclude: [ssh_port])
+        vite_port ||= next_port(Config::VITE_PORT_BASE, exclude: [ssh_port, web_port])
         @data = {
           "name" => name,
           "container_name" => cname,
           "ssh_port" => ssh_port,
           "web_port" => web_port,
+          "vite_port" => vite_port,
           "agent_installed" => false,
           "api_key_set" => false
         }
@@ -518,7 +545,7 @@ module GDKBox
           @data["claim_expires_at"] = (Time.now.utc + claim_ttl).iso8601 if claim_ttl
         end
         @store.save(@data)
-        [ssh_port, web_port]
+        [ssh_port, web_port, vite_port]
       end
     end
 

data/lib/gdkbox/cli.rb

@@ -24,6 +24,9 @@ module GDKBox
     option :image, type: :string, desc: "Override the GDK image to use"
     option :ssh_port, type: :numeric, desc: "Host port to publish SSH on"
     option :web_port, type: :numeric, desc: "Host port to publish the GDK web UI on"
+    option :vite_port, type: :numeric,
+      desc: "Port for vite assets (same number inside and outside the box; " \
+        "asset URLs embed it)"
     option :harness, type: :string,
       desc: "Agent harness to install (see `gdkbox harnesses`; default from config.yml or claude)"
     option :agent, type: :boolean, default: true,
@@ -60,6 +63,7 @@ module GDKBox
         image: options[:image],
         ssh_port: options[:ssh_port],
         web_port: options[:web_port],
+        vite_port: options[:vite_port],
         harness: harness.id,
         install_agent: options[:agent],
         api_key: api_key,
@@ -78,6 +82,12 @@ module GDKBox
       setup_host
 
       say "\nBox '#{name}' is up.", :green
+      unless box.data["vite_port_configured"]
+        say "\n  Could not align the box's vite port with the published " \
+          "#{box.vite_port} — browser asset loading may fail.", :yellow
+        say "  Retry inside the box: gdk config set vite.port #{box.vite_port} " \
+          "&& gdk reconfigure && gdk restart vite", :yellow
+      end
       print_connection_details(box)
       unless api_key
         say "\n  No #{harness.key_env} seeded. Before unattended dispatch, run:", :yellow
@@ -135,8 +145,9 @@ module GDKBox
       boxes.each do |box|
         status = docker.available? ? box.state : "unknown"
         claim = box.claimed_by ? " claimed:#{box.claimed_by}" : ""
-        say format("%-20s %-10s ssh:%-6s web:%-6s %s%s",
-          box.name, status, box.ssh_port, box.web_port, box.web_url, claim)
+        say format("%-20s %-10s ssh:%-6s web:%-6s vite:%-6s %s%s",
+          box.name, status, box.ssh_port, box.web_port, box.vite_port || "-",
+          box.web_url, claim)
       end
     end
 
@@ -663,6 +674,7 @@ module GDKBox
       say "  SSH:       ssh #{box.ssh_host_alias}", :cyan
       say "  VS Code:   gdkbox code #{box.name}", :cyan
       say "  Web UI:    #{box.web_url} (http://#{HostsFile::HOSTNAME}:#{box.web_port})", :cyan
+      say "  Assets:    vite on port #{box.vite_port}", :cyan if box.vite_port
       say "  Agent:     ssh #{box.ssh_host_alias} -t #{box.harness.bin}", :cyan
     end
   end

data/lib/gdkbox/config.rb

@@ -40,6 +40,14 @@ module GDKBox
     SSH_CONTAINER_PORT = 22
     GDK_WEB_CONTAINER_PORT = 3000
 
+    # GDK's vite dev server default port. Unlike SSH/web, the vite port is
+    # published host:N -> container:N with the *same* number on both sides:
+    # GitLab embeds absolute asset URLs (http://gdk.local:<vite_port>/...) in
+    # its HTML, so the port the browser dials must be the port vite listens
+    # on inside the box. Each box gets the next free number from this base
+    # and its GDK is reconfigured to serve vite there.
+    VITE_PORT_BASE = 3038
+
     # Starting points for the host-side published ports. Each new box claims
     # the next free port at or above these bases.
     SSH_PORT_BASE = 2222

data/lib/gdkbox/provisioner.rb

@@ -183,6 +183,28 @@ module GDKBox
       git fetch --quiet origin
     BASH
 
+    # Makes GDK serve vite on the box's published vite port. Asset URLs embed
+    # this port (http://gdk.local:<port>/assets/vite/...), so the in-container
+    # listen port must equal the host-published one. The reconfigure is
+    # skipped when the configured port already matches (the common case for
+    # the first box, which gets vite's default port); `gdk reconfigure` is
+    # what makes it slow otherwise.
+    #
+    # The restart must cover *all* services, not just vite: rails boots with
+    # the container and holds the old ViteRuby config, so with only vite
+    # restarted it probes the old port, decides the dev server is down, and
+    # every page 500s with ViteRuby::MissingEntrypointError. Services may not
+    # exist yet during first boot, hence the trailing `|| true`.
+    VITE_PORT_SETUP = <<~'BASH'
+      set -e
+      current=$(gdk config get vite.port 2>/dev/null || echo "")
+      if [ "$current" != "$GDKBOX_VITE_PORT" ]; then
+        gdk config set vite.port "$GDKBOX_VITE_PORT"
+        gdk reconfigure
+        gdk restart || true
+      fi
+    BASH
+
     def initialize(docker:, config:)
       @docker = docker
       @config = config
@@ -220,6 +242,15 @@ module GDKBox
       )
     end
 
+    def setup_vite_port(container_name, port)
+      @docker.exec(
+        container_name, VITE_PORT_SETUP,
+        user: @config.ssh_user,
+        workdir: @config.remote_path,
+        env: { "GDKBOX_VITE_PORT" => port.to_s }
+      )
+    end
+
     def setup_git_identity(container_name, name:, email:)
       @docker.exec(
         container_name, GIT_IDENTITY_SETUP,

data/lib/gdkbox/store.rb

@@ -41,7 +41,7 @@ module GDKBox
 
     # Every host port already claimed by an existing box.
     def used_ports
-      all.flat_map { |box| [box["ssh_port"], box["web_port"]] }.compact
+      all.flat_map { |box| [box["ssh_port"], box["web_port"], box["vite_port"]] }.compact
     end
   end
 end

data/lib/gdkbox/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GDKBox
-  VERSION = "0.1.15"
+  VERSION = "0.1.16"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gdkbox
 version: !ruby/object:Gem::Version
-  version: 0.1.15
+  version: 0.1.16
 platform: ruby
 authors:
 - jotolo