feat: log coglet build info and SDK version at startup (#2829)

* feat: log coglet build info and SDK version at startup

Print coglet version, git sha, dirty flag, build time, and debug/release
mode to logs on boot. Also log cog SDK and Python versions.

Expose git_sha and build_time in the /health-check response so running
containers can be identified without log access.

Add COGLET_GIT_DIRTY to build.rs and track .git/index for rebuild on
staging changes.

* refactor: rename 'cog' to 'python_sdk' in VersionInfo

Align with naming convention: 'cog' is the suite, 'coglet' is the
in-container server, 'python_sdk' is the SDK models are built on.

* fix: clean:go now removes dist/go/, add build summary

clean:go was removing ./cog (legacy path) but build:cog outputs to
dist/go/*/cog, so 'mise clean && mise build' left a stale CLI binary.

Also add a _build_summary task that prints artifact paths and versions
after 'mise build'.

* fix: update test assertion to match renamed python_sdk version field

Author: michaeldwan

crates/coglet-python/build.rs

@@ -20,6 +20,22 @@ fn main() {
         .unwrap_or_else(|| "unknown".to_string());
     println!("cargo:rustc-env=COGLET_GIT_SHA={git_sha}");
 
+    // Git dirty flag
+    let git_dirty = Command::new("git")
+        .args(["status", "--porcelain"])
+        .output()
+        .ok()
+        .filter(|o| o.status.success())
+        .map(|o| {
+            if String::from_utf8_lossy(&o.stdout).trim().is_empty() {
+                "false"
+            } else {
+                "true"
+            }
+        })
+        .unwrap_or("unknown");
+    println!("cargo:rustc-env=COGLET_GIT_DIRTY={git_dirty}");
+
     // Build timestamp (UTC, ISO 8601)
     let build_time = Command::new("date")
         .args(["-u", "+%Y-%m-%dT%H:%M:%SZ"])
@@ -40,9 +56,10 @@ fn main() {
         .unwrap_or_else(|| "unknown".to_string());
     println!("cargo:rustc-env=COGLET_RUSTC_VERSION={rustc_version}");
 
-    // Rebuild if git HEAD changes
+    // Rebuild if git HEAD changes or files are staged
     println!("cargo:rerun-if-changed=../../.git/HEAD");
     println!("cargo:rerun-if-changed=../../.git/refs");
+    println!("cargo:rerun-if-changed=../../.git/index");
 }
 
 /// Convert a semver version string to PEP 440 format.

crates/coglet-python/src/lib.rs

@@ -43,6 +43,8 @@ pub struct BuildInfo {
     #[pyo3(get)]
     git_sha: String,
     #[pyo3(get)]
+    dirty: bool,
+    #[pyo3(get)]
     build_time: String,
     #[pyo3(get)]
     rustc_version: String,
@@ -53,8 +55,12 @@ pub struct BuildInfo {
 impl BuildInfo {
     fn __repr__(&self) -> String {
         format!(
-            "BuildInfo(version='{}', git_sha='{}', build_time='{}', rustc_version='{}')",
-            self.version, self.git_sha, self.build_time, self.rustc_version
+            "BuildInfo(version='{}', git_sha='{}', dirty={}, build_time='{}', rustc_version='{}')",
+            self.version,
+            self.git_sha,
+            if self.dirty { "True" } else { "False" },
+            self.build_time,
+            self.rustc_version
         )
     }
 }
@@ -64,10 +70,20 @@ impl BuildInfo {
         Self {
             version: env!("COGLET_PEP440_VERSION").to_string(),
             git_sha: env!("COGLET_GIT_SHA").to_string(),
+            dirty: env!("COGLET_GIT_DIRTY") == "true",
             build_time: env!("COGLET_BUILD_TIME").to_string(),
             rustc_version: env!("COGLET_RUSTC_VERSION").to_string(),
         }
     }
+
+    /// Git SHA with optional `-dirty` suffix.
+    fn sha_display(&self) -> String {
+        if self.dirty {
+            format!("{}-dirty", self.git_sha)
+        } else {
+            self.git_sha.clone()
+        }
+    }
 }
 
 fn set_active() {
@@ -133,8 +149,10 @@ fn init_tracing(
     }
 }
 
-fn detect_version(py: Python<'_>) -> VersionInfo {
-    let mut version = VersionInfo::new();
+fn detect_version(py: Python<'_>, build: &BuildInfo) -> VersionInfo {
+    let mut version = VersionInfo::new()
+        .with_git_sha(build.sha_display())
+        .with_build_time(build.build_time.clone());
 
     if let Ok(sys) = py.import("sys")
         && let Ok(py_version) = sys.getattr("version")
@@ -148,7 +166,7 @@ fn detect_version(py: Python<'_>) -> VersionInfo {
         && let Ok(cog_version) = cog.getattr("__version__")
         && let Ok(v) = cog_version.extract::<String>()
     {
-        version = version.with_cog(v);
+        version = version.with_python_sdk(v);
     }
 
     version
@@ -280,7 +298,18 @@ fn serve_impl(
     let (setup_log_tx, setup_log_rx) = tokio::sync::mpsc::unbounded_channel();
     init_tracing(false, Some(setup_log_tx));
 
-    info!("coglet {}", env!("CARGO_PKG_VERSION"));
+    let build = BuildInfo::new();
+    info!(
+        "coglet {} ({}, built {}{})",
+        env!("CARGO_PKG_VERSION"),
+        build.sha_display(),
+        build.build_time,
+        if cfg!(debug_assertions) {
+            ", debug"
+        } else {
+            ""
+        },
+    );
 
     let config = ServerConfig {
         host,
@@ -297,7 +326,12 @@ fn serve_impl(
         info!("await_explicit_shutdown: installed SIGTERM ignore handler");
     }
 
-    let version = detect_version(py);
+    let version = detect_version(py, &build);
+    info!(
+        "python sdk {}",
+        version.python_sdk.as_deref().unwrap_or("unknown")
+    );
+    info!("python {}", version.python.as_deref().unwrap_or("unknown"));
 
     let Some(pred_ref) = predictor_ref else {
         info!("No predictor specified, serving health endpoints only");

crates/coglet-python/tests/test_coglet.py

@@ -336,7 +336,7 @@ def test_returns_version_info(self, sync_predictor: Path):
             assert "version" in health
             assert "coglet" in health["version"]
             assert "python" in health["version"]
-            assert "cog" in health["version"]
+            assert "python_sdk" in health["version"]
 
 
 class TestSyncPredictor:

crates/coglet/src/snapshots/coglet__version__tests__version_full.snap

@@ -4,6 +4,8 @@ expression: info
 ---
 {
   "coglet": "0.1.0",
-  "cog": "0.9.0",
+  "git_sha": "abc1234-dirty",
+  "build_time": "2026-03-12T18:00:00Z",
+  "python_sdk": "0.9.0",
   "python": "3.11.0"
 }

crates/coglet/src/version.rs

@@ -8,9 +8,15 @@ pub const COGLET_VERSION: &str = env!("CARGO_PKG_VERSION");
 pub struct VersionInfo {
     /// Coglet runtime version.
     pub coglet: &'static str,
-    /// Cog Python SDK version (if available).
+    /// Git SHA (with optional `-dirty` suffix).
     #[serde(skip_serializing_if = "Option::is_none")]
-    pub cog: Option<String>,
+    pub git_sha: Option<String>,
+    /// Build timestamp (UTC, ISO 8601).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub build_time: Option<String>,
+    /// Python SDK version (if available).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub python_sdk: Option<String>,
     /// Python version.
     #[serde(skip_serializing_if = "Option::is_none")]
     pub python: Option<String>,
@@ -20,7 +26,9 @@ impl Default for VersionInfo {
     fn default() -> Self {
         Self {
             coglet: COGLET_VERSION,
-            cog: None,
+            git_sha: None,
+            build_time: None,
+            python_sdk: None,
             python: None,
         }
     }
@@ -32,9 +40,21 @@ impl VersionInfo {
         Self::default()
     }
 
-    /// Set cog SDK version.
-    pub fn with_cog(mut self, version: String) -> Self {
-        self.cog = Some(version);
+    /// Set git SHA (with optional `-dirty` suffix).
+    pub fn with_git_sha(mut self, sha: String) -> Self {
+        self.git_sha = Some(sha);
+        self
+    }
+
+    /// Set build timestamp.
+    pub fn with_build_time(mut self, time: String) -> Self {
+        self.build_time = Some(time);
+        self
+    }
+
+    /// Set Python SDK version.
+    pub fn with_python_sdk(mut self, version: String) -> Self {
+        self.python_sdk = Some(version);
         self
     }
 
@@ -53,17 +73,21 @@ mod tests {
     fn version_info_has_coglet_version() {
         let info = VersionInfo::new();
         assert_eq!(info.coglet, COGLET_VERSION);
-        assert!(info.cog.is_none());
+        assert!(info.python_sdk.is_none());
         assert!(info.python.is_none());
     }
 
     #[test]
     fn version_info_builder_pattern() {
         let info = VersionInfo::new()
-            .with_cog("0.9.0".to_string())
+            .with_git_sha("abc1234".to_string())
+            .with_build_time("2026-03-12T18:00:00Z".to_string())
+            .with_python_sdk("0.9.0".to_string())
             .with_python("3.11.0".to_string());
 
-        assert_eq!(info.cog, Some("0.9.0".to_string()));
+        assert_eq!(info.git_sha, Some("abc1234".to_string()));
+        assert_eq!(info.build_time, Some("2026-03-12T18:00:00Z".to_string()));
+        assert_eq!(info.python_sdk, Some("0.9.0".to_string()));
         assert_eq!(info.python, Some("3.11.0".to_string()));
     }
 
@@ -72,7 +96,9 @@ mod tests {
         // Only coglet when no optional fields set
         let info = VersionInfo {
             coglet: "0.1.0",
-            cog: None,
+            git_sha: None,
+            build_time: None,
+            python_sdk: None,
             python: None,
         };
         insta::assert_json_snapshot!("version_minimal", info);
@@ -82,7 +108,9 @@ mod tests {
     fn version_info_serializes_full() {
         let info = VersionInfo {
             coglet: "0.1.0",
-            cog: Some("0.9.0".to_string()),
+            git_sha: Some("abc1234-dirty".to_string()),
+            build_time: Some("2026-03-12T18:00:00Z".to_string()),
+            python_sdk: Some("0.9.0".to_string()),
             python: Some("3.11.0".to_string()),
         };
         insta::assert_json_snapshot!("version_full", info);

mise.toml

@@ -96,8 +96,29 @@ alias = "build:all"
 description = "Build all components"
 run = [
   { tasks = ["build:cog", "build:coglet:wheel:linux-x64", "build:sdk"] },
+  { task = "_build_summary" },
 ]
 
+[tasks._build_summary]
+hide = true
+description = "Print build artifacts summary"
+run = """
+#!/usr/bin/env bash
+echo ""
+echo "=== Build Artifacts ==="
+if BINARY=$(ls dist/go/*/cog 2>/dev/null | head -1); then
+  VERSION=$("$BINARY" --version 2>/dev/null || echo "unknown")
+  echo "  cli:        $BINARY ($VERSION)"
+fi
+for whl in dist/coglet-*.whl; do
+  [ -f "$whl" ] && echo "  coglet:     $whl"
+done
+for whl in dist/cog-*.whl; do
+  [ -f "$whl" ] && echo "  python-sdk: $whl"
+done
+echo ""
+"""
+
 [tasks.install]
 depends = ["build:cog"]
 description = "Build and symlink cog CLI"
@@ -535,7 +556,7 @@ run = [
 
 [tasks."clean:go"]
 description = "Clean Go build artifacts"
-run = "rm -f cog base-image"
+run = "rm -rf cog base-image dist/go"
 
 [tasks."clean:rust"]
 description = "Clean Rust build artifacts"