From 8f7200a5c0976230f81ea68435f209a9c5e4d874 Mon Sep 17 00:00:00 2001
From: Chris <chris@amiable.dev>
Date: Sun, 8 Mar 2026 00:07:52 +0000
Subject: [PATCH 1/3] feat(gui): Add alpha/beta release stage badge to TitleBar
 (#512)

- Add [ALPHA] badge next to CONDUCTOR logo in TitleBar with amber styling
- Badge shows ALPHA (amber) or BETA (blue), hidden for production releases
- Centralise release stage as semver pre-release suffix in workspace Cargo.toml
- Sync tauri.conf.json version to 4.37.0-alpha (also fixes #470 stale version)
- StatusBar and SettingsPanel auto-display version with -alpha suffix via getVersion()
- Add release-stage.ts utility with parseReleaseStage() and releaseStageBadgeClass()
- Add 14 tests: 11 utility tests + 3 TitleBar badge rendering tests

Closes #512

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 Cargo.lock                                    |  8 ++--
 Cargo.toml                                    |  2 +-
 conductor-gui/src-tauri/tauri.conf.json       |  2 +-
 .../ui/src/lib/components/TitleBar.svelte     | 38 ++++++++++++++++
 .../ui/src/lib/components/TitleBar.test.ts    | 40 ++++++++++++++++-
 .../ui/src/lib/utils/release-stage.test.ts    | 43 +++++++++++++++++++
 .../ui/src/lib/utils/release-stage.ts         | 28 ++++++++++++
 7 files changed, 154 insertions(+), 7 deletions(-)
 create mode 100644 conductor-gui/ui/src/lib/utils/release-stage.test.ts
 create mode 100644 conductor-gui/ui/src/lib/utils/release-stage.ts

diff --git a/Cargo.lock b/Cargo.lock
index 98b1294a..645b846d 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -792,7 +792,7 @@ dependencies = [
 
 [[package]]
 name = "conductor"
-version = "4.37.0"
+version = "4.37.0-alpha"
 dependencies = [
  "chrono",
  "conductor-core",
@@ -826,7 +826,7 @@ dependencies = [
 
 [[package]]
 name = "conductor-core"
-version = "4.37.0"
+version = "4.37.0-alpha"
 dependencies = [
  "alsa",
  "anyhow",
@@ -867,7 +867,7 @@ dependencies = [
 
 [[package]]
 name = "conductor-daemon"
-version = "4.37.0"
+version = "4.37.0-alpha"
 dependencies = [
  "anyhow",
  "arc-swap",
@@ -913,7 +913,7 @@ dependencies = [
 
 [[package]]
 name = "conductor-gui"
-version = "4.37.0"
+version = "4.37.0-alpha"
 dependencies = [
  "anyhow",
  "async-trait",
diff --git a/Cargo.toml b/Cargo.toml
index c8261a0b..90cef638 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -13,7 +13,7 @@ exclude = [
 resolver = "2"
 
 [workspace.package]
-version = "4.37.0"
+version = "4.37.0-alpha"
 edition = "2024"
 authors = ["Conductor Contributors"]
 license = "MIT"
diff --git a/conductor-gui/src-tauri/tauri.conf.json b/conductor-gui/src-tauri/tauri.conf.json
index 8881d13c..7d2b4184 100644
--- a/conductor-gui/src-tauri/tauri.conf.json
+++ b/conductor-gui/src-tauri/tauri.conf.json
@@ -1,6 +1,6 @@
 {
   "productName": "Conductor",
-  "version": "4.26.6",
+  "version": "4.37.0-alpha",
   "identifier": "com.amiable.conductor",
   "build": {
     "beforeDevCommand": "npm --prefix ui run dev",
diff --git a/conductor-gui/ui/src/lib/components/TitleBar.svelte b/conductor-gui/ui/src/lib/components/TitleBar.svelte
index 3544ebdf..c8be257c 100644
--- a/conductor-gui/ui/src/lib/components/TitleBar.svelte
+++ b/conductor-gui/ui/src/lib/components/TitleBar.svelte
@@ -6,8 +6,22 @@
 -->
 
 <script>
+  import { onMount } from 'svelte';
+  import { getVersion } from '@tauri-apps/api/app';
   import { deviceBindingsStore, profileStore } from '$lib/stores.js';
   import { workspaceView, WORKSPACE_VIEWS } from '$lib/stores/workspace.js';
+  import { parseReleaseStage } from '$lib/utils/release-stage.ts';
+
+  let releaseStage = null;
+
+  onMount(async () => {
+    try {
+      const version = await getVersion();
+      releaseStage = parseReleaseStage(version);
+    } catch {
+      releaseStage = null;
+    }
+  });
 
   // Track selected values from store state
   $: selectedDeviceId = $deviceBindingsStore.bindings?.[0]?.device_id || '';
@@ -34,6 +48,11 @@
 <div class="titlebar">
   <div class="titlebar-left">
     <span class="logo">CONDUCTOR</span>
+    {#if releaseStage}
+      <span class="release-stage" class:stage-alpha={releaseStage === 'alpha'} class:stage-beta={releaseStage === 'beta'}>
+        {releaseStage.toUpperCase()}
+      </span>
+    {/if}
   </div>
 
   <div class="titlebar-right">
@@ -85,6 +104,25 @@
     letter-spacing: 1px;
   }
 
+  .release-stage {
+    font-size: 9px;
+    font-weight: 700;
+    letter-spacing: 1px;
+    padding: 2px 6px;
+    border-radius: var(--radius-sm);
+    color: var(--bg-app);
+    margin-left: 8px;
+    text-transform: uppercase;
+  }
+
+  .release-stage.stage-alpha {
+    background: var(--amber);
+  }
+
+  .release-stage.stage-beta {
+    background: var(--blue);
+  }
+
   .titlebar-right {
     display: flex;
     align-items: center;
diff --git a/conductor-gui/ui/src/lib/components/TitleBar.test.ts b/conductor-gui/ui/src/lib/components/TitleBar.test.ts
index e8f00cb2..d9b83be8 100644
--- a/conductor-gui/ui/src/lib/components/TitleBar.test.ts
+++ b/conductor-gui/ui/src/lib/components/TitleBar.test.ts
@@ -5,8 +5,13 @@
 import { describe, it, expect, vi, afterEach } from 'vitest';
 import { render, screen, cleanup, fireEvent } from '@testing-library/svelte';
 
-const { mockSwitchTo } = vi.hoisted(() => ({
+const { mockSwitchTo, mockGetVersion } = vi.hoisted(() => ({
   mockSwitchTo: vi.fn(() => Promise.resolve({ success: true })),
+  mockGetVersion: vi.fn(() => Promise.resolve('4.37.0-alpha')),
+}));
+
+vi.mock('@tauri-apps/api/app', () => ({
+  getVersion: mockGetVersion,
 }));
 
 vi.mock('$lib/stores.js', async () => {
@@ -88,4 +93,37 @@ describe('TitleBar', () => {
     await fireEvent.change(profileDropdown, { target: { value: 'p2' } });
     expect(mockSwitchTo).toHaveBeenCalledWith('p2');
   });
+
+  it('shows ALPHA release stage badge when version is alpha', async () => {
+    mockGetVersion.mockResolvedValue('4.37.0-alpha');
+    const TitleBar = (await import('./TitleBar.svelte')).default;
+    render(TitleBar);
+    // Wait for onMount async to complete and Svelte to re-render
+    await vi.waitFor(() => {
+      expect(screen.getByText('ALPHA')).toBeTruthy();
+    }, { timeout: 2000 });
+  });
+
+  it('shows BETA release stage badge when version is beta', async () => {
+    mockGetVersion.mockResolvedValue('4.37.0-beta');
+    const TitleBar = (await import('./TitleBar.svelte')).default;
+    render(TitleBar);
+    await vi.waitFor(() => {
+      expect(screen.getByText('BETA')).toBeTruthy();
+    }, { timeout: 2000 });
+  });
+
+  it('does not show release stage badge for production version', async () => {
+    mockGetVersion.mockResolvedValue('4.37.0');
+    const TitleBar = (await import('./TitleBar.svelte')).default;
+    render(TitleBar);
+    // Wait for onMount to resolve, then assert no badge
+    await vi.waitFor(() => {
+      expect(mockGetVersion).toHaveBeenCalled();
+    }, { timeout: 2000 });
+    // Give Svelte a tick to update
+    await new Promise(r => setTimeout(r, 50));
+    expect(screen.queryByText('ALPHA')).toBeNull();
+    expect(screen.queryByText('BETA')).toBeNull();
+  });
 });
diff --git a/conductor-gui/ui/src/lib/utils/release-stage.test.ts b/conductor-gui/ui/src/lib/utils/release-stage.test.ts
new file mode 100644
index 00000000..0679b85f
--- /dev/null
+++ b/conductor-gui/ui/src/lib/utils/release-stage.test.ts
@@ -0,0 +1,43 @@
+/**
+ * Release stage utility tests (#512)
+ */
+
+import { describe, it, expect } from 'vitest';
+import { parseReleaseStage } from './release-stage.ts';
+
+describe('parseReleaseStage', () => {
+  it('returns "alpha" for alpha pre-release', () => {
+    expect(parseReleaseStage('4.37.0-alpha')).toBe('alpha');
+  });
+
+  it('returns "beta" for beta pre-release', () => {
+    expect(parseReleaseStage('4.37.0-beta')).toBe('beta');
+  });
+
+  it('returns null for production (no pre-release)', () => {
+    expect(parseReleaseStage('4.37.0')).toBe(null);
+  });
+
+  it('returns null for empty string', () => {
+    expect(parseReleaseStage('')).toBe(null);
+  });
+
+  it('returns null for "dev"', () => {
+    expect(parseReleaseStage('dev')).toBe(null);
+  });
+
+  it('is case-insensitive', () => {
+    expect(parseReleaseStage('4.37.0-ALPHA')).toBe('alpha');
+    expect(parseReleaseStage('4.37.0-Beta')).toBe('beta');
+  });
+
+  it('returns null for unrecognised pre-release tags', () => {
+    expect(parseReleaseStage('4.37.0-rc1')).toBe(null);
+    expect(parseReleaseStage('4.37.0-snapshot')).toBe(null);
+  });
+
+  it('handles version with build metadata after stage', () => {
+    expect(parseReleaseStage('4.37.0-alpha.1')).toBe('alpha');
+  });
+});
+
diff --git a/conductor-gui/ui/src/lib/utils/release-stage.ts b/conductor-gui/ui/src/lib/utils/release-stage.ts
new file mode 100644
index 00000000..5a2d756e
--- /dev/null
+++ b/conductor-gui/ui/src/lib/utils/release-stage.ts
@@ -0,0 +1,28 @@
+/**
+ * Release stage utilities — parse alpha/beta/prod from semver version strings.
+ *
+ * Single source of truth: the pre-release suffix in Cargo.toml workspace version
+ * (e.g., "4.37.0-alpha"). Tauri's getVersion() reads from tauri.conf.json which
+ * must be kept in sync.
+ */
+
+export type ReleaseStage = 'alpha' | 'beta' | null;
+
+/**
+ * Extract the release stage from a semver version string.
+ *
+ * "4.37.0-alpha" → "alpha"
+ * "4.37.0-beta"  → "beta"
+ * "4.37.0"       → null (production)
+ * "dev"          → null
+ */
+export function parseReleaseStage(version: string): ReleaseStage {
+  if (!version) return null;
+  const match = version.match(/-(\w+)/);
+  if (!match) return null;
+  const stage = match[1].toLowerCase();
+  if (stage === 'alpha') return 'alpha';
+  if (stage === 'beta') return 'beta';
+  return null;
+}
+

From 91c9b4add12c581e1f5021c89bf3250ccbe0679d Mon Sep 17 00:00:00 2001
From: Chris <chris@amiable.dev>
Date: Sun, 8 Mar 2026 00:22:11 +0000
Subject: [PATCH 2/3] fix: Address PR review feedback
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Fix test name: "build metadata" → "dotted pre-release identifier" (correct SemVer terminology)
- Drop .ts extension from import to match codebase convention
- Reword doc comment to not overpromise "single source of truth" when sync is manual

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 conductor-gui/ui/src/lib/components/TitleBar.svelte  | 2 +-
 conductor-gui/ui/src/lib/utils/release-stage.test.ts | 2 +-
 conductor-gui/ui/src/lib/utils/release-stage.ts      | 8 +++++---
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/conductor-gui/ui/src/lib/components/TitleBar.svelte b/conductor-gui/ui/src/lib/components/TitleBar.svelte
index c8be257c..5c101838 100644
--- a/conductor-gui/ui/src/lib/components/TitleBar.svelte
+++ b/conductor-gui/ui/src/lib/components/TitleBar.svelte
@@ -10,7 +10,7 @@
   import { getVersion } from '@tauri-apps/api/app';
   import { deviceBindingsStore, profileStore } from '$lib/stores.js';
   import { workspaceView, WORKSPACE_VIEWS } from '$lib/stores/workspace.js';
-  import { parseReleaseStage } from '$lib/utils/release-stage.ts';
+  import { parseReleaseStage } from '$lib/utils/release-stage';
 
   let releaseStage = null;
 
diff --git a/conductor-gui/ui/src/lib/utils/release-stage.test.ts b/conductor-gui/ui/src/lib/utils/release-stage.test.ts
index 0679b85f..ef24534d 100644
--- a/conductor-gui/ui/src/lib/utils/release-stage.test.ts
+++ b/conductor-gui/ui/src/lib/utils/release-stage.test.ts
@@ -36,7 +36,7 @@ describe('parseReleaseStage', () => {
     expect(parseReleaseStage('4.37.0-snapshot')).toBe(null);
   });
 
-  it('handles version with build metadata after stage', () => {
+  it('handles version with dotted pre-release identifier', () => {
     expect(parseReleaseStage('4.37.0-alpha.1')).toBe('alpha');
   });
 });
diff --git a/conductor-gui/ui/src/lib/utils/release-stage.ts b/conductor-gui/ui/src/lib/utils/release-stage.ts
index 5a2d756e..a979d36d 100644
--- a/conductor-gui/ui/src/lib/utils/release-stage.ts
+++ b/conductor-gui/ui/src/lib/utils/release-stage.ts
@@ -1,9 +1,11 @@
 /**
  * Release stage utilities — parse alpha/beta/prod from semver version strings.
  *
- * Single source of truth: the pre-release suffix in Cargo.toml workspace version
- * (e.g., "4.37.0-alpha"). Tauri's getVersion() reads from tauri.conf.json which
- * must be kept in sync.
+ * This helper is agnostic about where the version string comes from; it simply
+ * inspects the pre-release suffix (e.g., "4.37.0-alpha" or "4.37.0-beta") to
+ * determine the release stage. Callers are responsible for ensuring version
+ * values are consistent across Cargo.toml, tauri.conf.json (used by Tauri's
+ * getVersion()), and any other sources.
  */
 
 export type ReleaseStage = 'alpha' | 'beta' | null;

From 98c3a2ae1f74ebcce009bbbc32f59c90fece953a Mon Sep 17 00:00:00 2001
From: Chris <chris@amiable.dev>
Date: Sun, 8 Mar 2026 00:30:39 +0000
Subject: [PATCH 3/3] fix: Address second round of PR review feedback

- Remove redundant margin-left on .release-stage (parent gap handles spacing)
- Drop .ts extension from test import to match codebase convention
- Replace setTimeout with vi.waitFor in production badge test to avoid flakiness
- Version drift CI guard already tracked in #515

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 conductor-gui/ui/src/lib/components/TitleBar.svelte  | 1 -
 conductor-gui/ui/src/lib/components/TitleBar.test.ts | 9 +++------
 conductor-gui/ui/src/lib/utils/release-stage.test.ts | 2 +-
 3 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/conductor-gui/ui/src/lib/components/TitleBar.svelte b/conductor-gui/ui/src/lib/components/TitleBar.svelte
index 5c101838..2cd00a73 100644
--- a/conductor-gui/ui/src/lib/components/TitleBar.svelte
+++ b/conductor-gui/ui/src/lib/components/TitleBar.svelte
@@ -111,7 +111,6 @@
     padding: 2px 6px;
     border-radius: var(--radius-sm);
     color: var(--bg-app);
-    margin-left: 8px;
     text-transform: uppercase;
   }
 
diff --git a/conductor-gui/ui/src/lib/components/TitleBar.test.ts b/conductor-gui/ui/src/lib/components/TitleBar.test.ts
index d9b83be8..215a84b1 100644
--- a/conductor-gui/ui/src/lib/components/TitleBar.test.ts
+++ b/conductor-gui/ui/src/lib/components/TitleBar.test.ts
@@ -117,13 +117,10 @@ describe('TitleBar', () => {
     mockGetVersion.mockResolvedValue('4.37.0');
     const TitleBar = (await import('./TitleBar.svelte')).default;
     render(TitleBar);
-    // Wait for onMount to resolve, then assert no badge
+    // Wait for Svelte to update DOM and ensure no release stage badge is shown
     await vi.waitFor(() => {
-      expect(mockGetVersion).toHaveBeenCalled();
+      expect(screen.queryByText('ALPHA')).toBeNull();
+      expect(screen.queryByText('BETA')).toBeNull();
     }, { timeout: 2000 });
-    // Give Svelte a tick to update
-    await new Promise(r => setTimeout(r, 50));
-    expect(screen.queryByText('ALPHA')).toBeNull();
-    expect(screen.queryByText('BETA')).toBeNull();
   });
 });
diff --git a/conductor-gui/ui/src/lib/utils/release-stage.test.ts b/conductor-gui/ui/src/lib/utils/release-stage.test.ts
index ef24534d..cea9bb26 100644
--- a/conductor-gui/ui/src/lib/utils/release-stage.test.ts
+++ b/conductor-gui/ui/src/lib/utils/release-stage.test.ts
@@ -3,7 +3,7 @@
  */
 
 import { describe, it, expect } from 'vitest';
-import { parseReleaseStage } from './release-stage.ts';
+import { parseReleaseStage } from './release-stage';
 
 describe('parseReleaseStage', () => {
   it('returns "alpha" for alpha pre-release', () => {