Resolve desktop artifact version from HEAD semver tags

Author: clawsweeper[bot]

scripts/build-desktop-artifact.test.ts

@@ -3,6 +3,7 @@ import { assert, it } from "@effect/vitest";
 import { ConfigProvider, Effect, Option } from "effect";
 
 import {
+  resolveDesktopArtifactVersion,
   resolveBuildOptions,
   resolveDesktopBuildIconAssets,
   resolveDesktopProductName,
@@ -23,6 +24,28 @@ it.layer(NodeServices.layer)("build-desktop-artifact", (it) => {
     assert.equal(resolveDesktopProductName("0.0.17-nightly.20260413.42"), "T3 Code (Nightly)");
   });
 
+  it("resolves explicit desktop artifact versions before HEAD tags", () => {
+    assert.equal(resolveDesktopArtifactVersion("9.9.9", ["v1.2.3"], "0.0.22"), "9.9.9");
+  });
+
+  it("falls back to the server package version when HEAD has no exact semver tags", () => {
+    assert.equal(
+      resolveDesktopArtifactVersion(undefined, ["release-1.2.3", "1.2", "1.2.3-dev+"], "0.0.22"),
+      "0.0.22",
+    );
+  });
+
+  it("strips a leading v from exact semver tags on HEAD", () => {
+    assert.equal(resolveDesktopArtifactVersion(undefined, ["v1.2.3"], "0.0.22"), "1.2.3");
+  });
+
+  it("resolves multiple HEAD semver tags deterministically", () => {
+    assert.equal(
+      resolveDesktopArtifactVersion(undefined, ["v1.2.4", "1.2.3", "not-a-version"], "0.0.22"),
+      "1.2.4",
+    );
+  });
+
   it("switches desktop packaging icons to the nightly artwork for nightly versions", () => {
     assert.deepStrictEqual(resolveDesktopBuildIconAssets("0.0.17"), {
       macIconPng: BRAND_ASSET_PATHS.productionMacIconPng,

scripts/build-desktop-artifact.ts

@@ -150,6 +150,31 @@ const resolveGitCommitHash = Effect.fn("resolveGitCommitHash")(function* (repoRo
   return hash.toLowerCase();
 });
 
+const resolveGitHeadTags = Effect.fn("resolveGitHeadTags")(function* (repoRoot: string) {
+  const result = yield* spawnAndCollectOutput(
+    ChildProcess.make("git", ["tag", "--points-at", "HEAD"], {
+      cwd: repoRoot,
+    }),
+  ).pipe(
+    Effect.catch(() =>
+      Effect.succeed({
+        stdout: "",
+        stderr: "",
+        exitCode: 1,
+      }),
+    ),
+  );
+
+  if (result.exitCode !== 0) {
+    return [];
+  }
+
+  return result.stdout
+    .split(/\r?\n/)
+    .map((tag) => tag.trim())
+    .filter((tag) => tag.length > 0);
+});
+
 const resolvePythonForNodeGyp = Effect.fn("resolvePythonForNodeGyp")(function* () {
   const fs = yield* FileSystem.FileSystem;
   const path = yield* Path.Path;
@@ -532,6 +557,26 @@ export function resolveDesktopUpdateChannel(version: string): "latest" | "nightl
   return /-nightly\.\d{8}\.\d+$/.test(version) ? "nightly" : "latest";
 }
 
+const ExactSemverTagPattern =
+  /^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+
+export function resolveDesktopArtifactVersion(
+  explicitVersion: string | undefined,
+  headTags: ReadonlyArray<string>,
+  fallbackVersion: string,
+): string {
+  if (explicitVersion) {
+    return explicitVersion;
+  }
+
+  const headSemverVersions = headTags
+    .filter((tag) => ExactSemverTagPattern.test(tag))
+    .map((tag) => tag.replace(/^v/, ""))
+    .toSorted((a, b) => a.localeCompare(b, "en"));
+
+  return headSemverVersions.at(-1) ?? fallbackVersion;
+}
+
 export function resolveDesktopBuildIconAssets(version: string): DesktopBuildIconAssets {
   if (resolveDesktopUpdateChannel(version) === "nightly") {
     return {
@@ -710,7 +755,11 @@ const buildDesktopArtifact = Effect.fn("buildDesktopArtifact")(function* (
       }),
   });
 
-  const appVersion = options.version ?? serverPackageJson.version;
+  const appVersion = resolveDesktopArtifactVersion(
+    options.version,
+    yield* resolveGitHeadTags(repoRoot),
+    serverPackageJson.version,
+  );
   const iconAssets = resolveDesktopBuildIconAssets(appVersion);
   const commitHash = yield* resolveGitCommitHash(repoRoot);
   const mkdir = options.keepStage ? fs.makeTempDirectory : fs.makeTempDirectoryScoped;