chore: derive build version from git tags for all components (#305)

Compute version strings from git describe in openshell-core's build.rs
using the guess-next-dev scheme (e.g. 0.0.4-dev.6+g2bf9969). All binary
crates and the TUI splash screen now use the shared openshell_core::VERSION
constant instead of CARGO_PKG_VERSION.

In Docker/CI builds where .git is absent, falls back to CARGO_PKG_VERSION
which is already set correctly by the sed-patch pipeline. Also adds
OPENSHELL_CARGO_VERSION support to the cluster image and fast-deploy
supervisor builds for parity with the gateway.

Author: johntmyers

crates/openshell-cli/src/main.rs

@@ -298,7 +298,7 @@ const DOCTOR_HELP: &str = "\x1b[1mALIAS\x1b[0m
 /// `OpenShell` CLI - agent execution and management.
 #[derive(Parser, Debug)]
 #[command(name = "openshell")]
-#[command(author, version, about, long_about = None)]
+#[command(author, version = openshell_core::VERSION, about, long_about = None)]
 #[command(propagate_version = true)]
 #[command(help_template = HELP_TEMPLATE)]
 #[command(disable_help_subcommand = true)]

crates/openshell-core/build.rs

@@ -4,6 +4,19 @@
 use std::env;
 
 fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // --- Git-derived version ---
+    // Compute a version from `git describe` for local builds. In Docker/CI
+    // builds where .git is absent, this silently does nothing and the binary
+    // falls back to CARGO_PKG_VERSION (which is already sed-patched by the
+    // build pipeline).
+    println!("cargo:rerun-if-changed=../../.git/HEAD");
+    println!("cargo:rerun-if-changed=../../.git/refs/tags");
+
+    if let Some(version) = git_version() {
+        println!("cargo:rustc-env=OPENSHELL_GIT_VERSION={version}");
+    }
+
+    // --- Protobuf compilation ---
     // Use bundled protoc from protobuf-src
     // SAFETY: This is run at build time in a single-threaded build script context.
     // No other threads are reading environment variables concurrently.
@@ -33,3 +46,48 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
 
     Ok(())
 }
+
+/// Derive a version string from `git describe --tags`.
+///
+/// Implements the "guess-next-dev" convention used by the release pipeline
+/// (`setuptools-scm`): when there are commits past the last tag, the patch
+/// version is bumped and `-dev.<N>+g<sha>` is appended.
+///
+/// Examples:
+///   on tag v0.0.3          → "0.0.3"
+///   3 commits past v0.0.3  → "0.0.4-dev.3+g2bf9969"
+///
+/// Returns `None` when git is unavailable or the repo has no matching tags.
+fn git_version() -> Option<String> {
+    let output = std::process::Command::new("git")
+        .args(["describe", "--tags", "--long", "--match", "v*"])
+        .output()
+        .ok()?;
+
+    if !output.status.success() {
+        return None;
+    }
+
+    let desc = String::from_utf8(output.stdout).ok()?;
+    let desc = desc.trim();
+    let desc = desc.strip_prefix('v').unwrap_or(desc);
+
+    // `git describe --long` format: <tag>-<N>-g<sha>
+    // Split from the right to handle tags that contain hyphens.
+    let (rest, sha) = desc.rsplit_once('-')?;
+    let (tag, commits_str) = rest.rsplit_once('-')?;
+    let commits: u32 = commits_str.parse().ok()?;
+
+    if commits == 0 {
+        // Exactly on a tag — use the tag version as-is.
+        return Some(tag.to_string());
+    }
+
+    // Bump patch version (guess-next-dev scheme).
+    let mut parts = tag.splitn(3, '.');
+    let major = parts.next()?;
+    let minor = parts.next()?;
+    let patch: u32 = parts.next()?.parse().ok()?;
+
+    Some(format!("{major}.{minor}.{}-dev.{commits}+{sha}", patch + 1))
+}

crates/openshell-core/src/lib.rs

@@ -7,6 +7,7 @@
 //! - Protocol buffer definitions and generated code
 //! - Configuration management
 //! - Common error types
+//! - Build version metadata
 
 pub mod config;
 pub mod error;
@@ -16,3 +17,14 @@ pub mod proto;
 
 pub use config::{Config, TlsConfig};
 pub use error::{Error, Result};
+
+/// Build version string derived from git metadata.
+///
+/// For local builds this is computed by `build.rs` via `git describe` using
+/// the guess-next-dev scheme (e.g. `0.0.4-dev.6+g2bf9969`). In Docker/CI
+/// builds where `.git` is absent, falls back to `CARGO_PKG_VERSION` which
+/// is already set correctly by the build pipeline's sed patch.
+pub const VERSION: &str = match option_env!("OPENSHELL_GIT_VERSION") {
+    Some(v) => v,
+    None => env!("CARGO_PKG_VERSION"),
+};

crates/openshell-sandbox/src/main.rs

@@ -14,6 +14,7 @@ use openshell_sandbox::run_sandbox;
 /// OpenShell Sandbox - process isolation and monitoring.
 #[derive(Parser, Debug)]
 #[command(name = "openshell-sandbox")]
+#[command(version = openshell_core::VERSION)]
 #[command(about = "Process sandbox and monitor", long_about = None)]
 struct Args {
     /// Command to execute in the sandbox.

crates/openshell-server/src/auth.rs

@@ -121,7 +121,7 @@ fn render_connect_page(
         .replace('<', "\\x3c")
         .replace('>', "\\x3e");
 
-    let version = env!("CARGO_PKG_VERSION");
+    let version = openshell_core::VERSION;
 
     format!(
         r#"<!DOCTYPE html>

crates/openshell-server/src/grpc.rs

@@ -134,7 +134,7 @@ impl OpenShell for OpenShellService {
     ) -> Result<Response<HealthResponse>, Status> {
         Ok(Response::new(HealthResponse {
             status: ServiceStatus::Healthy.into(),
-            version: env!("CARGO_PKG_VERSION").to_string(),
+            version: openshell_core::VERSION.to_string(),
         }))
     }
 

crates/openshell-server/src/http.rs

@@ -31,7 +31,7 @@ async fn healthz() -> impl IntoResponse {
 async fn readyz() -> impl IntoResponse {
     let response = HealthResponse {
         status: "healthy",
-        version: env!("CARGO_PKG_VERSION"),
+        version: openshell_core::VERSION,
     };
 
     (StatusCode::OK, Json(response))

crates/openshell-server/src/main.rs

@@ -15,6 +15,7 @@ use openshell_server::{run_server, tracing_bus::TracingLogBus};
 /// `OpenShell` Server - gRPC and HTTP server with protocol multiplexing.
 #[derive(Parser, Debug)]
 #[command(name = "openshell-server")]
+#[command(version = openshell_core::VERSION)]
 #[command(about = "OpenShell gRPC/HTTP server", long_about = None)]
 struct Args {
     /// Port to bind the server to (all interfaces).

crates/openshell-tui/src/ui/splash.rs

@@ -45,8 +45,8 @@ const ART_WIDTH: u16 = 40;
 /// Total content lines: 6 (OPEN) + 6 (SHELL) + 1 (blank) + 1 (tagline) = 14.
 const CONTENT_LINES: u16 = 14;
 
-// Border (2) + top/bottom inner padding (2) + content + blank before footer (1) + footer (1).
-const MODAL_HEIGHT: u16 = CONTENT_LINES + 6;
+// Border (2) + top/bottom inner padding (2) + content + blank before footer (1) + footer (2).
+const MODAL_HEIGHT: u16 = CONTENT_LINES + 7;
 
 // Art width + left/right padding (3+3) + borders (2).
 const MODAL_WIDTH: u16 = ART_WIDTH + 8;
@@ -73,13 +73,13 @@ pub fn draw(frame: &mut Frame<'_>, area: Rect, theme: &crate::theme::Theme) {
     let inner = block.inner(popup);
     frame.render_widget(block, popup);
 
-    // Split inner area: art content + spacer + footer.
+    // Split inner area: art content + spacer + footer (2 lines).
     let chunks = Layout::default()
         .direction(Direction::Vertical)
         .constraints([
             Constraint::Length(CONTENT_LINES), // OPEN + SHELL + blank + tagline
             Constraint::Min(0),                // spacer
-            Constraint::Length(1),             // footer
+            Constraint::Length(2),             // footer (version + prompt)
         ])
         .split(inner);
 
@@ -102,27 +102,20 @@ pub fn draw(frame: &mut Frame<'_>, area: Rect, theme: &crate::theme::Theme) {
 
     frame.render_widget(Paragraph::new(content_lines), chunks[0]);
 
-    // -- Footer: version + ALPHA badge (left) + prompt (right) --
-    let version = format!("v{}", env!("CARGO_PKG_VERSION"));
-    let spacer = " ";
+    // -- Footer: version + ALPHA badge on line 1, prompt on line 2 --
+    let version = format!("v{}", openshell_core::VERSION);
     let alpha_badge = "ALPHA";
-    let prompt_text = "press any key";
-
-    // Pad between left group and prompt to fill the line.
-    let used = version.len() + spacer.len() + alpha_badge.len() + prompt_text.len() + 2; // +2 for ░ and space
-    let footer_width = chunks[2].width as usize;
-    let gap = footer_width.saturating_sub(used);
-
-    let footer = Line::from(vec![
-        Span::styled(version, t.accent),
-        Span::styled(spacer, t.muted),
-        Span::styled(alpha_badge, t.title_bar),
-        Span::styled(" ".repeat(gap), t.muted),
-        Span::styled(prompt_text, t.muted),
-        Span::styled(" ░", t.muted),
+
+    let footer = Paragraph::new(vec![
+        Line::from(vec![
+            Span::styled(version, t.accent),
+            Span::styled(" ", t.muted),
+            Span::styled(alpha_badge, t.title_bar),
+        ]),
+        Line::from(Span::styled("press any key ░", t.muted)),
     ]);
 
-    frame.render_widget(Paragraph::new(footer), chunks[2]);
+    frame.render_widget(footer, chunks[2]);
 }
 
 fn centered_rect(width: u16, height: u16, area: Rect) -> Rect {

deploy/docker/Dockerfile.cluster

@@ -76,6 +76,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends curl ca-certifi
 FROM --platform=$BUILDPLATFORM rust:1.88-slim AS supervisor-builder
 ARG TARGETARCH
 ARG BUILDARCH
+ARG OPENSHELL_CARGO_VERSION
 ARG CARGO_TARGET_CACHE_SCOPE=default
 ARG SCCACHE_MEMCACHED_ENDPOINT
 
@@ -135,6 +136,9 @@ RUN --mount=type=cache,id=cargo-registry-supervisor-${TARGETARCH},sharing=locked
     --mount=type=cache,id=cargo-target-supervisor-${TARGETARCH}-${CARGO_TARGET_CACHE_SCOPE},sharing=locked,target=/build/target \
     --mount=type=cache,id=sccache-supervisor-${TARGETARCH},sharing=locked,target=/tmp/sccache \
     . cross-build.sh && \
+    if [ -n "${OPENSHELL_CARGO_VERSION:-}" ]; then \
+      sed -i -E '/^\[workspace\.package\]/,/^\[/{s/^version[[:space:]]*=[[:space:]]*".*"/version = "'"${OPENSHELL_CARGO_VERSION}"'"/}' Cargo.toml; \
+    fi && \
     cargo_cross_build --release -p openshell-sandbox && \
     mkdir -p /build/out && \
     cp "$(cross_output_dir release)/openshell-sandbox" /build/out/