local-development-gateway 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31c635514c35283b8ebab124d6a9f9ac8e17e8de5faaeb8573b0c73153b3efd4
-  data.tar.gz: 946d3a12335cff8a00f10a5ac330de37b5f5ec509a33779e44cefc265b8c0554
+  metadata.gz: c8606a508df46ba2018a8cd768c86e6a41ce38a5ef7caedff7c5832017d34e38
+  data.tar.gz: ebd5a8310bcb5b235d0c00c717813873b73e6061d6333f89ba188818636b3162
 SHA512:
-  metadata.gz: 04b07e9aeb612b723744759bebb4f8e19319ac885a9dff3163446eaebcaf9a424cb203c36c89649a2378d1db675c5a167aade5bc0f33e6c82ccb70c11d7bcec6
-  data.tar.gz: 28528704687762d7a053b62f7c1fc1e7f5af76700e4c332efadaef32cb5c594e420af8bbd53803a1e3d0cecdafa3d892ceeee5edbac100aa388ea72e98a80de1
+  metadata.gz: cb84da27199e8af6e78189f9025240ae090ae84372e3ccbd3f1d25240e18a4710a3eb16f32793b2e1411bc0bb9d9f0535f9a4ff5955815cc1b0eda322680fdd8
+  data.tar.gz: e0e3a2a24e3f039d516a150496b37527ff98d6549aafaeeb0aca5b36116f68ed24bb5f3948c35ab3555efeca1c40267d334f233d50a46aa7dbf55c50333b62e5

data/README.md

@@ -106,6 +106,21 @@ command that must not start a missing gateway, pass
 `ensure_running: false`; the block still runs and unused-gateway cleanup is
 attempted.
 
+### Installed versus active versions
+
+`bundle exec local-development-gateway status` reports the invoking gem's installed version separately from each running shared service's active version, provenance, and mounted asset path. Healthy CLI `up`/`ensure` reuse also prints these diagnostics without recreating containers. Ruby callers can inspect `LocalDevelopmentGateway.status`; `ensure_running` still returns `:reused` for healthy services, and `ready?` remains a health check, not an artifact-version check.
+
+For the database router, the active version comes from a record written by the Ruby process after loading the library at startup. For the HTTP gateway, it is the gateway configuration artifact version recorded in a container-creation label, not the Traefik image version. Missing records or labels are `unknown`. A legacy mount path containing a gem version is useful diagnostic evidence but does not prove which Ruby code or configuration the running process loaded. Neither version record is a content hash or proof that bind-mounted files have remained unchanged.
+
+Installing a newer gem does not update already-running services. A known difference is reported as `mismatch`; legacy `unknown` provenance cannot establish that an upgrade is active. Coordinate restart timing with all consumers before explicitly updating only the database router:
+
+```sh
+bundle exec local-development-gateway up --no-deps --force-recreate database-router
+bundle exec local-development-gateway status
+```
+
+Recreating the shared database router interrupts existing database client sessions across every consuming project/worktree. This command leaves the HTTP gateway and consumer database containers/volumes alone. If the HTTP gateway itself needs an update, separately coordinate and explicitly select `gateway` instead. Do not use `down` for a router-only update. After updating, confirm the selected service's active version is current and exercise an encrypted connection to the intended database; readiness alone is insufficient release verification.
+
 ## Worktree database services
 
 The gateway includes protocol drivers for encrypted SQL Server and PostgreSQL
@@ -419,6 +434,11 @@ It mounts the Docker socket so it can discover labelled containers. A read-only
 | A project uses normal ports unexpectedly | Confirm the gateway container is running and has `local-gateway=true`. |
 | Authentication rejects the callback | Confirm the generated hostname matches the allowed wildcard callback pattern. |
 
+## Release 0.2.3
+
+- Status and healthy CLI reuse distinguish the installed gem version from each active shared service, reporting mismatches and unknown legacy provenance without restarting services.
+- Scoped router update instructions explain shared database session interruption and keep restart timing under caller control. Health readiness and Ruby lifecycle return values remain unchanged.
+
 ## Release 0.2.2
 
 - Canonical SQL Server/PostgreSQL Compose integration supports concurrent

data/docker-compose.yml

@@ -13,6 +13,7 @@ services:
       start_period: 1s
     labels:
       local-gateway: "true"
+      local-gateway.version: "${LOCAL_DEVELOPMENT_GATEWAY_VERSION:-unknown}"
     ports:
       - "127.0.0.1:80:80"
     restart: unless-stopped
@@ -29,7 +30,7 @@ services:
       - -I/app/lib
       - -rlocal_development_gateway
       - -e
-      - LocalDevelopmentGateway::DatabaseRouter.run
+      - File.write("/tmp/local-development-gateway-version", LocalDevelopmentGateway::VERSION); LocalDevelopmentGateway::DatabaseRouter.run
     healthcheck:
       test:
         - CMD
@@ -43,6 +44,7 @@ services:
       start_period: 1s
     labels:
       local-gateway: "true"
+      local-gateway.version: "${LOCAL_DEVELOPMENT_GATEWAY_VERSION:-unknown}"
     ports:
       - "127.0.0.1:1433:1433"
       - "127.0.0.1:5432:5432"

data/lib/local_development_gateway/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LocalDevelopmentGateway
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

data/lib/local_development_gateway.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "open3"
+require "json"
 require "local_development_gateway/version"
 
 module LocalDevelopmentGateway
@@ -29,16 +30,16 @@ module LocalDevelopmentGateway
   end
 
   class Docker
-    def call(*args, capture: true)
+    def call(*args, capture: true, env: {})
       command = ["docker", *args]
       if capture
-        stdout, stderr, status = Open3.capture3(*command)
+        stdout, stderr, status = Open3.capture3(env, *command)
         unless status.success?
           raise DockerError.new(command, stderr.empty? ? stdout : stderr)
         end
 
         stdout
-      elsif system(*command)
+      elsif system(env, *command)
         true
       else
         raise DockerError.new(command, "")
@@ -85,7 +86,17 @@ module LocalDevelopmentGateway
     end
 
     def status
-      compose("ps", "--all")
+      output = compose("ps", "--all")
+      output << "\nInstalled gateway version: #{VERSION}\n"
+      SERVICE_NAMES.each do |service|
+        ids = gateway_container_ids(service: service, status: "running")
+        if ids.empty?
+          output << "#{service}: not running; active=unknown\n"
+        else
+          ids.each { |id| output << service_version_status(service, id) }
+        end
+      end
+      output
     end
 
     def logs(*args, follow: false)
@@ -122,12 +133,56 @@ module LocalDevelopmentGateway
         "--file",
         COMPOSE_FILE,
         *args,
-        capture: capture
+        capture: capture,
+        env: {
+          "LOCAL_DEVELOPMENT_GATEWAY_VERSION" => VERSION
+        }
       )
     end
 
     private
 
+    def service_version_status(service, id)
+      container = JSON.parse(@runner.call("inspect", id)).fetch(0)
+      if service == "database-router"
+        version = router_version(id)
+        provenance = "process-start record"
+        asset_target = "/app/lib"
+      else
+        version = container.dig("Config", "Labels", "local-gateway.version")
+        provenance = "container-creation label"
+        asset_target = "/etc/traefik/traefik.yml"
+      end
+      version = "unknown" if version.nil? || version.empty?
+      comparison = version_comparison(version)
+      mount =
+        container
+          .fetch("Mounts", [])
+          .find { |entry| entry["Destination"] == asset_target }
+      source = "unknown"
+      source = mount.fetch("Source") if mount
+      "#{service} (#{id[0, 12]}): active=#{version}; #{comparison}; " \
+        "provenance=#{provenance}; mounted assets=#{source}\n"
+    end
+
+    def router_version(id)
+      @runner.call(
+        "exec",
+        id,
+        "cat",
+        "/tmp/local-development-gateway-version"
+      ).strip
+    rescue DockerError
+      nil
+    end
+
+    def version_comparison(version)
+      return "unknown" if version == "unknown"
+      return "current" if version == VERSION
+
+      "mismatch (installed=#{VERSION}); explicit service recreation required"
+    end
+
     def wait_until_ready
       deadline = @clock.call + @timeout
       until ready?
@@ -233,7 +288,7 @@ module LocalDevelopmentGateway
 
       Commands:
         up, ensure  Start or reuse the shared gateway
-        status      Show the gateway Compose status
+        status      Show Compose status and installed/active gateway versions
         ready       Check gateway readiness
         logs        Follow gateway logs
         down, stop  Stop the gateway only when unused
@@ -260,7 +315,8 @@ module LocalDevelopmentGateway
 
       case command
       when "up", "ensure"
-        @client.ensure_running(*@argv)
+        result = @client.ensure_running(*@argv)
+        @output.write(@client.status) if result == :reused
       when "status"
         @output.write(@client.status)
       when "ready"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: local-development-gateway
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Marlen Brunner
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-14 00:00:00.000000000 Z
+date: 2026-10-22 00:00:00.000000000 Z
 dependencies: []
 description: Ruby API and CLI for starting, monitoring, and conditionally stopping
   the shared Docker gateway.