Commit 409ff90a1401c0b8e2bef05d73b3be57ff9bc669 | the-knife

.github/workflows/ci.yml+3

...	@@ -92,5 +92,8 @@ jobs:	...	@@ -92,5 +92,8 @@ jobs:
92	with:	92	with:
93	node-version-file: package.json	93	node-version-file: package.json
94		94
		95	- name: Install dependencies
		96	run: bun install --frozen-lockfile
		97
95	- name: Exercise release-only workflow steps	98	- name: Exercise release-only workflow steps
96	run: node scripts/release-smoke.ts	99	run: node scripts/release-smoke.ts

.github/workflows/release.yml+119-39

...	@@ -1,14 +1,24 @@	...	@@ -1,14 +1,24 @@
1	name: Release Desktop	1	name: Release
2		2
3	on:	3	on:
4	push:	4	push:
5	tags:	5	tags:
6	- "v..*"	6	- "v..*"
		7	schedule:
		8	- cron: "0 9 * * *"
7	workflow_dispatch:	9	workflow_dispatch:
8	inputs:	10	inputs:
		11	channel:
		12	description: "Release channel"
		13	required: false
		14	default: stable
		15	type: choice
		16	options:
		17	- stable
		18	- nightly
9	version:	19	version:
10	description: "Release version (for example 1.2.3 or v1.2.3)"	20	description: "Release version (for example 1.2.3 or v1.2.3)"
11	required: true	21	required: false
12	type: string	22	type: string
13		23
14	permissions:	24	permissions:
...	@@ -21,40 +31,21 @@ jobs:	...	@@ -21,40 +31,21 @@ jobs:
21	runs-on: ubuntu-24.04	31	runs-on: ubuntu-24.04
22	timeout-minutes: 10	32	timeout-minutes: 10
23	outputs:	33	outputs:
		34	release_channel: ${{ steps.release_meta.outputs.release_channel }}
24	version: ${{ steps.release_meta.outputs.version }}	35	version: ${{ steps.release_meta.outputs.version }}
25	tag: ${{ steps.release_meta.outputs.tag }}	36	tag: ${{ steps.release_meta.outputs.tag }}
		37	release_name: ${{ steps.release_meta.outputs.name }}
		38	short_sha: ${{ steps.release_meta.outputs.short_sha }}
		39	previous_tag: ${{ steps.previous_tag.outputs.previous_tag }}
		40	cli_dist_tag: ${{ steps.release_meta.outputs.cli_dist_tag }}
26	is_prerelease: ${{ steps.release_meta.outputs.is_prerelease }}	41	is_prerelease: ${{ steps.release_meta.outputs.is_prerelease }}
27	make_latest: ${{ steps.release_meta.outputs.make_latest }}	42	make_latest: ${{ steps.release_meta.outputs.make_latest }}
28	ref: ${{ github.sha }}	43	ref: ${{ github.sha }}
29	steps:	44	steps:
30	- name: Checkout	45	- name: Checkout
31	uses: actions/checkout@v6	46	uses: actions/checkout@v6
32		47	with:
33	- id: release_meta	48	fetch-depth: 0
34	name: Resolve release version
35	shell: bash
36	run: \|
37	if [[ "${GITHUB_EVENT_NAME}" == "workflow_dispatch" ]]; then
38	raw="${{ github.event.inputs.version }}"
39	else
40	raw="${GITHUB_REF_NAME}"
41	fi
42
43	version="${raw#v}"
44	if [[ ! "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+([.-][0-9A-Za-z.-]+)?$ ]]; then
45	echo "Invalid release version: $raw" >&2
46	exit 1
47	fi
48
49	echo "version=$version" >> "$GITHUB_OUTPUT"
50	echo "tag=v$version" >> "$GITHUB_OUTPUT"
51	if [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
52	echo "is_prerelease=false" >> "$GITHUB_OUTPUT"
53	echo "make_latest=true" >> "$GITHUB_OUTPUT"
54	else
55	echo "is_prerelease=true" >> "$GITHUB_OUTPUT"
56	echo "make_latest=false" >> "$GITHUB_OUTPUT"
57	fi
58		49
59	- name: Setup Bun	50	- name: Setup Bun
60	uses: oven-sh/setup-bun@v2	51	uses: oven-sh/setup-bun@v2
...	@@ -69,6 +60,60 @@ jobs:	...	@@ -69,6 +60,60 @@ jobs:
69	- name: Install dependencies	60	- name: Install dependencies
70	run: bun install --frozen-lockfile	61	run: bun install --frozen-lockfile
71		62
		63	- id: release_meta
		64	name: Resolve release version
		65	shell: bash
		66	env:
		67	DISPATCH_CHANNEL: ${{ github.event.inputs.channel }}
		68	DISPATCH_VERSION: ${{ github.event.inputs.version }}
		69	NIGHTLY_DATE: ${{ github.run_started_at }}
		70	NIGHTLY_SHA: ${{ github.sha }}
		71	NIGHTLY_RUN_NUMBER: ${{ github.run_number }}
		72	run: \|
		73	if [[ "${GITHUB_EVENT_NAME}" == "schedule" \|\| ( "${GITHUB_EVENT_NAME}" == "workflow_dispatch" && "${DISPATCH_CHANNEL:-stable}" == "nightly" ) ]]; then
		74	nightly_date="$(date -u -d "$NIGHTLY_DATE" +%Y%m%d)"
		75
		76	node scripts/resolve-nightly-release.ts \
		77	--date "$nightly_date" \
		78	--run-number "$NIGHTLY_RUN_NUMBER" \
		79	--sha "$NIGHTLY_SHA" \
		80	--github-output
		81
		82	echo "release_channel=nightly" >> "$GITHUB_OUTPUT"
		83	echo "cli_dist_tag=nightly" >> "$GITHUB_OUTPUT"
		84	echo "is_prerelease=true" >> "$GITHUB_OUTPUT"
		85	echo "make_latest=false" >> "$GITHUB_OUTPUT"
		86	else
		87	if [[ "${GITHUB_EVENT_NAME}" == "workflow_dispatch" ]]; then
		88	raw="${DISPATCH_VERSION}"
		89	if [[ -z "$raw" ]]; then
		90	echo "workflow_dispatch stable releases require the version input." >&2
		91	exit 1
		92	fi
		93	else
		94	raw="${GITHUB_REF_NAME}"
		95	fi
		96
		97	version="${raw#v}"
		98	if [[ ! "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+([.-][0-9A-Za-z.-]+)?$ ]]; then
		99	echo "Invalid release version: $raw" >&2
		100	exit 1
		101	fi
		102
		103	echo "release_channel=stable" >> "$GITHUB_OUTPUT"
		104	echo "version=$version" >> "$GITHUB_OUTPUT"
		105	echo "tag=v$version" >> "$GITHUB_OUTPUT"
		106	echo "name=T3 Code v$version" >> "$GITHUB_OUTPUT"
		107	echo "cli_dist_tag=latest" >> "$GITHUB_OUTPUT"
		108	if [[ "$version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
		109	echo "is_prerelease=false" >> "$GITHUB_OUTPUT"
		110	echo "make_latest=true" >> "$GITHUB_OUTPUT"
		111	else
		112	echo "is_prerelease=true" >> "$GITHUB_OUTPUT"
		113	echo "make_latest=false" >> "$GITHUB_OUTPUT"
		114	fi
		115	fi
		116
72	- name: Lint	117	- name: Lint
73	run: bun run lint	118	run: bun run lint
74		119
...	@@ -78,6 +123,14 @@ jobs:	...	@@ -78,6 +123,14 @@ jobs:
78	- name: Test	123	- name: Test
79	run: bun run test	124	run: bun run test
80		125
		126	- id: previous_tag
		127	name: Resolve previous release tag
		128	run: \|
		129	node scripts/resolve-previous-release-tag.ts \
		130	--channel "${{ steps.release_meta.outputs.release_channel }}" \
		131	--current-tag "${{ steps.release_meta.outputs.tag }}" \
		132	--github-output
		133
81	build:	134	build:
82	name: Build ${{ matrix.label }}	135	name: Build ${{ matrix.label }}
83	needs: preflight	136	needs: preflight
...	@@ -206,16 +259,17 @@ jobs:	...	@@ -206,16 +259,17 @@ jobs:
206	"release/*.AppImage" \	259	"release/*.AppImage" \
207	"release/*.exe" \	260	"release/*.exe" \
208	"release/*.blockmap" \	261	"release/*.blockmap" \
209	"release/latest*.yml"; do	262	"release/*.yml"; do
210	for file in $pattern; do	263	for file in $pattern; do
211	cp "$file" release-publish/	264	cp "$file" release-publish/
212	done	265	done
213	done	266	done
214		267
215	if [[ "${{ matrix.platform }}" == "mac" && "${{ matrix.arch }}" != "arm64" ]]; then	268	if [[ "${{ matrix.platform }}" == "mac" && "${{ matrix.arch }}" != "arm64" ]]; then
216	if [[ -f release-publish/latest-mac.yml ]]; then	269	shopt -s nullglob
217	mv release-publish/latest-mac.yml "release-publish/latest-mac-${{ matrix.arch }}.yml"	270	for manifest in release-publish/*-mac.yml; do
218	fi	271	mv "$manifest" "${manifest%.yml}-${{ matrix.arch }}.yml"
		272	done
219	fi	273	fi
220		274
221	- name: Upload build artifacts	275	- name: Upload build artifacts
...	@@ -257,7 +311,7 @@ jobs:	...	@@ -257,7 +311,7 @@ jobs:
257	run: bun run build --filter=@t3tools/web --filter=t3	311	run: bun run build --filter=@t3tools/web --filter=t3
258		312
259	- name: Publish CLI package	313	- name: Publish CLI package
260	run: node apps/server/scripts/cli.ts publish --tag latest --app-version "${{ needs.preflight.outputs.version }}" --verbose	314	run: node apps/server/scripts/cli.ts publish --tag "${{ needs.preflight.outputs.cli_dist_tag }}" --app-version "${{ needs.preflight.outputs.version }}" --verbose
261		315
262	release:	316	release:
263	name: Publish GitHub Release	317	name: Publish GitHub Release
...	@@ -284,17 +338,42 @@ jobs:	...	@@ -284,17 +338,42 @@ jobs:
284		338
285	- name: Merge macOS updater manifests	339	- name: Merge macOS updater manifests
286	run: \|	340	run: \|
287	node scripts/merge-mac-update-manifests.ts \	341	shopt -s nullglob
288	release-assets/latest-mac.yml \	342	for x64_manifest in release-assets/*-mac-x64.yml; do
289	release-assets/latest-mac-x64.yml	343	arm64_manifest="${x64_manifest%-x64.yml}.yml"
290	rm -f release-assets/latest-mac-x64.yml	344	if [[ -f "$arm64_manifest" ]]; then
		345	node scripts/merge-mac-update-manifests.ts "$arm64_manifest" "$x64_manifest"
		346	rm -f "$x64_manifest"
		347	fi
		348	done
291		349
292	- name: Publish release	350	- name: Publish release
		351	if: needs.preflight.outputs.previous_tag != ''
		352	uses: softprops/action-gh-release@v2
		353	with:
		354	tag_name: ${{ needs.preflight.outputs.tag }}
		355	target_commitish: ${{ needs.preflight.outputs.ref }}
		356	name: ${{ needs.preflight.outputs.release_name }}
		357	generate_release_notes: true
		358	previous_tag: ${{ needs.preflight.outputs.previous_tag }}
		359	prerelease: ${{ needs.preflight.outputs.is_prerelease }}
		360	make_latest: ${{ needs.preflight.outputs.make_latest }}
		361	files: \|
		362	release-assets/*.dmg
		363	release-assets/*.zip
		364	release-assets/*.AppImage
		365	release-assets/*.exe
		366	release-assets/*.blockmap
		367	release-assets/*.yml
		368	fail_on_unmatched_files: true
		369
		370	- name: Publish first release
		371	if: needs.preflight.outputs.previous_tag == ''
293	uses: softprops/action-gh-release@v2	372	uses: softprops/action-gh-release@v2
294	with:	373	with:
295	tag_name: ${{ needs.preflight.outputs.tag }}	374	tag_name: ${{ needs.preflight.outputs.tag }}
296	target_commitish: ${{ needs.preflight.outputs.ref }}	375	target_commitish: ${{ needs.preflight.outputs.ref }}
297	name: T3 Code v${{ needs.preflight.outputs.version }}	376	name: ${{ needs.preflight.outputs.release_name }}
298	generate_release_notes: true	377	generate_release_notes: true
299	prerelease: ${{ needs.preflight.outputs.is_prerelease }}	378	prerelease: ${{ needs.preflight.outputs.is_prerelease }}
300	make_latest: ${{ needs.preflight.outputs.make_latest }}	379	make_latest: ${{ needs.preflight.outputs.make_latest }}
...	@@ -304,11 +383,12 @@ jobs:	...	@@ -304,11 +383,12 @@ jobs:
304	release-assets/*.AppImage	383	release-assets/*.AppImage
305	release-assets/*.exe	384	release-assets/*.exe
306	release-assets/*.blockmap	385	release-assets/*.blockmap
307	release-assets/latest*.yml	386	release-assets/*.yml
308	fail_on_unmatched_files: true	387	fail_on_unmatched_files: true
309		388
310	finalize:	389	finalize:
311	name: Finalize release	390	name: Finalize release
		391	if: needs.preflight.outputs.release_channel == 'stable'
312	needs: [preflight, release]	392	needs: [preflight, release]
313	runs-on: ubuntu-24.04	393	runs-on: ubuntu-24.04
314	timeout-minutes: 10	394	timeout-minutes: 10

.oxfmtrc.json+2-1

...	@@ -10,7 +10,8 @@	...	@@ -10,7 +10,8 @@
10	"*.tsbuildinfo",	10	"*.tsbuildinfo",
11	"**/routeTree.gen.ts",	11	"**/routeTree.gen.ts",
12	"apps/web/public/mockServiceWorker.js",	12	"apps/web/public/mockServiceWorker.js",
13	"apps/web/src/lib/vendor/qrcodegen.ts"	13	"apps/web/src/lib/vendor/qrcodegen.ts",
		14	".icon/*"
14	],	15	],
15	"sortPackageJson": {}	16	"sortPackageJson": {}
16	}	17	}

apps/desktop/scripts/electron-launcher.mjs+67-1

...	@@ -6,6 +6,7 @@ import {	...	@@ -6,6 +6,7 @@ import {
6	cpSync,	6	cpSync,
7	existsSync,	7	existsSync,
8	mkdirSync,	8	mkdirSync,
		9	mkdtempSync,
9	readFileSync,	10	readFileSync,
10	readdirSync,	11	readdirSync,
11	rmSync,	12	rmSync,
...	@@ -23,6 +24,9 @@ const LAUNCHER_VERSION = 1;	...	@@ -23,6 +24,9 @@ const LAUNCHER_VERSION = 1;
23		24
24	const __dirname = dirname(fileURLToPath(import.meta.url));	25	const __dirname = dirname(fileURLToPath(import.meta.url));
25	export const desktopDir = resolve(__dirname, "..");	26	export const desktopDir = resolve(__dirname, "..");
		27	const repoRoot = resolve(desktopDir, "..", "..");
		28	const defaultIconPath = join(desktopDir, "resources", "icon.icns");
		29	const developmentMacIconPngPath = join(repoRoot, "assets", "dev", "blueprint-macos-1024.png");
26		30
27	function setPlistString(plistPath, key, value) {	31	function setPlistString(plistPath, key, value) {
28	const replaceResult = spawnSync("plutil", ["-replace", key, "-string", value, plistPath], {	32	const replaceResult = spawnSync("plutil", ["-replace", key, "-string", value, plistPath], {
...	@@ -43,6 +47,68 @@ function setPlistString(plistPath, key, value) {	...	@@ -43,6 +47,68 @@ function setPlistString(plistPath, key, value) {
43	throw new Error(`Failed to update plist key "${key}" at ${plistPath}: ${details}`.trim());	47	throw new Error(`Failed to update plist key "${key}" at ${plistPath}: ${details}`.trim());
44	}	48	}
45		49
		50	function runChecked(command, args) {
		51	const result = spawnSync(command, args, { encoding: "utf8" });
		52	if (result.status === 0) {
		53	return;
		54	}
		55
		56	const details = [result.stdout, result.stderr].filter(Boolean).join("\n");
		57	throw new Error(`Failed to run ${command} ${args.join(" ")}: ${details}`.trim());
		58	}
		59
		60	function ensureDevelopmentIconIcns(runtimeDir) {
		61	const generatedIconPath = join(runtimeDir, "icon-dev.icns");
		62	mkdirSync(runtimeDir, { recursive: true });
		63
		64	if (!existsSync(developmentMacIconPngPath)) {
		65	return defaultIconPath;
		66	}
		67
		68	const sourceMtimeMs = statSync(developmentMacIconPngPath).mtimeMs;
		69	if (existsSync(generatedIconPath) && statSync(generatedIconPath).mtimeMs >= sourceMtimeMs) {
		70	return generatedIconPath;
		71	}
		72
		73	const iconsetRoot = mkdtempSync(join(runtimeDir, "dev-iconset-"));
		74	const iconsetDir = join(iconsetRoot, "icon.iconset");
		75	mkdirSync(iconsetDir, { recursive: true });
		76
		77	try {
		78	for (const size of [16, 32, 128, 256, 512]) {
		79	runChecked("sips", [
		80	"-z",
		81	String(size),
		82	String(size),
		83	developmentMacIconPngPath,
		84	"--out",
		85	join(iconsetDir, `icon_${size}x${size}.png`),
		86	]);
		87
		88	const retinaSize = size * 2;
		89	runChecked("sips", [
		90	"-z",
		91	String(retinaSize),
		92	String(retinaSize),
		93	developmentMacIconPngPath,
		94	"--out",
		95	join(iconsetDir, `icon_${size}x${size}@2x.png`),
		96	]);
		97	}
		98
		99	runChecked("iconutil", ["-c", "icns", iconsetDir, "-o", generatedIconPath]);
		100	return generatedIconPath;
		101	} catch (error) {
		102	console.warn(
		103	"[desktop-launcher] Failed to generate dev macOS icon, falling back to default icon.",
		104	error,
		105	);
		106	return defaultIconPath;
		107	} finally {
		108	rmSync(iconsetRoot, { recursive: true, force: true });
		109	}
		110	}
		111
46	function patchMainBundleInfoPlist(appBundlePath, iconPath) {	112	function patchMainBundleInfoPlist(appBundlePath, iconPath) {
47	const infoPlistPath = join(appBundlePath, "Contents", "Info.plist");	113	const infoPlistPath = join(appBundlePath, "Contents", "Info.plist");
48	setPlistString(infoPlistPath, "CFBundleDisplayName", APP_DISPLAY_NAME);	114	setPlistString(infoPlistPath, "CFBundleDisplayName", APP_DISPLAY_NAME);
...	@@ -102,7 +168,7 @@ function buildMacLauncher(electronBinaryPath) {	...	@@ -102,7 +168,7 @@ function buildMacLauncher(electronBinaryPath) {
102	const runtimeDir = join(desktopDir, ".electron-runtime");	168	const runtimeDir = join(desktopDir, ".electron-runtime");
103	const targetAppBundlePath = join(runtimeDir, `${APP_DISPLAY_NAME}.app`);	169	const targetAppBundlePath = join(runtimeDir, `${APP_DISPLAY_NAME}.app`);
104	const targetBinaryPath = join(targetAppBundlePath, "Contents", "MacOS", "Electron");	170	const targetBinaryPath = join(targetAppBundlePath, "Contents", "MacOS", "Electron");
105	const iconPath = join(desktopDir, "resources", "icon.icns");	171	const iconPath = isDevelopment ? ensureDevelopmentIconIcns(runtimeDir) : defaultIconPath;
106	const metadataPath = join(runtimeDir, "metadata.json");	172	const metadataPath = join(runtimeDir, "metadata.json");
107		173
108	mkdirSync(runtimeDir, { recursive: true });	174	mkdirSync(runtimeDir, { recursive: true });

apps/desktop/src/appBranding.test.ts created+47

...	@@ -0,0 +1,47 @@
1	import { describe, expect, it } from "vitest";
2
3	import { resolveDesktopAppBranding, resolveDesktopAppStageLabel } from "./appBranding";
4
5	describe("resolveDesktopAppStageLabel", () => {
6	it("uses Dev in desktop development", () => {
7	expect(
8	resolveDesktopAppStageLabel({
9	isDevelopment: true,
10	appVersion: "0.0.17-nightly.20260414.1",
11	}),
12	).toBe("Dev");
13	});
14
15	it("uses Nightly for packaged nightly builds", () => {
16	expect(
17	resolveDesktopAppStageLabel({
18	isDevelopment: false,
19	appVersion: "0.0.17-nightly.20260414.1",
20	}),
21	).toBe("Nightly");
22	});
23
24	it("uses Alpha for packaged stable builds", () => {
25	expect(
26	resolveDesktopAppStageLabel({
27	isDevelopment: false,
28	appVersion: "0.0.17",
29	}),
30	).toBe("Alpha");
31	});
32	});
33
34	describe("resolveDesktopAppBranding", () => {
35	it("returns a complete desktop branding payload", () => {
36	expect(
37	resolveDesktopAppBranding({
38	isDevelopment: false,
39	appVersion: "0.0.17-nightly.20260414.1",
40	}),
41	).toEqual({
42	baseName: "T3 Code",
43	stageLabel: "Nightly",
44	displayName: "T3 Code (Nightly)",
45	});
46	});
47	});

apps/desktop/src/appBranding.ts created+27

...	@@ -0,0 +1,27 @@
1	import type { DesktopAppBranding, DesktopAppStageLabel } from "@t3tools/contracts";
2
3	const APP_BASE_NAME = "T3 Code";
4	const NIGHTLY_VERSION_PATTERN = /-nightly\.\d{8}\.\d+$/;
5
6	export function resolveDesktopAppStageLabel(input: {
7	readonly isDevelopment: boolean;
8	readonly appVersion: string;
9	}): DesktopAppStageLabel {
10	if (input.isDevelopment) {
11	return "Dev";
12	}
13
14	return NIGHTLY_VERSION_PATTERN.test(input.appVersion) ? "Nightly" : "Alpha";
15	}
16
17	export function resolveDesktopAppBranding(input: {
18	readonly isDevelopment: boolean;
19	readonly appVersion: string;
20	}): DesktopAppBranding {
21	const stageLabel = resolveDesktopAppStageLabel(input);
22	return {
23	baseName: APP_BASE_NAME,
24	stageLabel,
25	displayName: `${APP_BASE_NAME} (${stageLabel})`,
26	};
27	}

apps/desktop/src/desktopSettings.test.ts+20

 @@ -8,6 +8,7 @@ import {
   DEFAULT_DESKTOP_SETTINGS,
   readDesktopSettings,
   setDesktopServerExposurePreference,
+  setDesktopUpdateChannelPreference,
   writeDesktopSettings,
 } from "./desktopSettings";
 @@ -35,10 +36,12 @@ describe("desktopSettings", () => {
     writeDesktopSettings(settingsPath, {
       serverExposureMode: "network-accessible",
+      updateChannel: "latest",
     });
     expect(readDesktopSettings(settingsPath)).toEqual({
       serverExposureMode: "network-accessible",
+      updateChannel: "latest",
     });
   });
 @@ -47,11 +50,28 @@ describe("desktopSettings", () => {
       setDesktopServerExposurePreference(
         {
           serverExposureMode: "local-only",
+          updateChannel: "latest",
         },
         "network-accessible",
       ),
     ).toEqual({
       serverExposureMode: "network-accessible",
+      updateChannel: "latest",
+    });
+  });
+  it("persists the requested nightly update channel", () => {
+    expect(
+      setDesktopUpdateChannelPreference(
+        {
+          serverExposureMode: "local-only",
+          updateChannel: "latest",
+        },
+        "nightly",
+      ),
+    ).toEqual({
+      serverExposureMode: "local-only",
+      updateChannel: "nightly",
     });
   });

apps/desktop/src/desktopSettings.ts+17-1

 @@ -1,13 +1,15 @@
 import * as FS from "node:fs";
 import * as Path from "node:path";
-import type { DesktopServerExposureMode } from "@t3tools/contracts";
+import type { DesktopServerExposureMode, DesktopUpdateChannel } from "@t3tools/contracts";
 export interface DesktopSettings {
   readonly serverExposureMode: DesktopServerExposureMode;
+  readonly updateChannel: DesktopUpdateChannel;
 }
 export const DEFAULT_DESKTOP_SETTINGS: DesktopSettings = {
   serverExposureMode: "local-only",
+  updateChannel: "latest",
 };
 export function setDesktopServerExposurePreference(
 @@ -22,6 +24,18 @@ export function setDesktopServerExposurePreference(
       };
 }
+export function setDesktopUpdateChannelPreference(
+  settings: DesktopSettings,
+  requestedChannel: DesktopUpdateChannel,
+): DesktopSettings {
+  return settings.updateChannel === requestedChannel
+    ? settings
+    : {
+        ...settings,
+        updateChannel: requestedChannel,
+      };
+}
 export function readDesktopSettings(settingsPath: string): DesktopSettings {
   try {
     if (!FS.existsSync(settingsPath)) {
 @@ -31,11 +45,13 @@ export function readDesktopSettings(settingsPath: string): DesktopSettings {
     const raw = FS.readFileSync(settingsPath, "utf8");
     const parsed = JSON.parse(raw) as {
       readonly serverExposureMode?: unknown;
+      readonly updateChannel?: unknown;
     };
     return {
       serverExposureMode:
         parsed.serverExposureMode === "network-accessible" ? "network-accessible" : "local-only",
+      updateChannel: parsed.updateChannel === "nightly" ? "nightly" : "latest",
     };
   } catch {
     return DEFAULT_DESKTOP_SETTINGS;

apps/desktop/src/main.ts+91-13

...	@@ -22,8 +22,10 @@ import type { MenuItemConstructorOptions } from "electron";	...	@@ -22,8 +22,10 @@ import type { MenuItemConstructorOptions } from "electron";
22	import type {	22	import type {
23	ClientSettings,	23	ClientSettings,
24	DesktopTheme,	24	DesktopTheme,
		25	DesktopAppBranding,
25	DesktopServerExposureMode,	26	DesktopServerExposureMode,
26	DesktopServerExposureState,	27	DesktopServerExposureState,
		28	DesktopUpdateChannel,
27	PersistedSavedEnvironmentRecord,	29	PersistedSavedEnvironmentRecord,
28	DesktopUpdateActionResult,	30	DesktopUpdateActionResult,
29	DesktopUpdateCheckResult,	31	DesktopUpdateCheckResult,
...	@@ -39,6 +41,7 @@ import {	...	@@ -39,6 +41,7 @@ import {
39	DEFAULT_DESKTOP_SETTINGS,	41	DEFAULT_DESKTOP_SETTINGS,
40	readDesktopSettings,	42	readDesktopSettings,
41	setDesktopServerExposurePreference,	43	setDesktopServerExposurePreference,
		44	setDesktopUpdateChannelPreference,
42	writeDesktopSettings,	45	writeDesktopSettings,
43	} from "./desktopSettings";	46	} from "./desktopSettings";
44	import {	47	import {
...	@@ -69,6 +72,7 @@ import {	...	@@ -69,6 +72,7 @@ import {
69	reduceDesktopUpdateStateOnUpdateAvailable,	72	reduceDesktopUpdateStateOnUpdateAvailable,
70	} from "./updateMachine";	73	} from "./updateMachine";
71	import { isArm64HostRunningIntelBuild, resolveDesktopRuntimeInfo } from "./runtimeArch";	74	import { isArm64HostRunningIntelBuild, resolveDesktopRuntimeInfo } from "./runtimeArch";
		75	import { resolveDesktopAppBranding } from "./appBranding";
72		76
73	syncShellEnvironment();	77	syncShellEnvironment();
74		78
...	@@ -80,9 +84,11 @@ const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";	...	@@ -80,9 +84,11 @@ const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
80	const MENU_ACTION_CHANNEL = "desktop:menu-action";	84	const MENU_ACTION_CHANNEL = "desktop:menu-action";
81	const UPDATE_STATE_CHANNEL = "desktop:update-state";	85	const UPDATE_STATE_CHANNEL = "desktop:update-state";
82	const UPDATE_GET_STATE_CHANNEL = "desktop:update-get-state";	86	const UPDATE_GET_STATE_CHANNEL = "desktop:update-get-state";
		87	const UPDATE_SET_CHANNEL_CHANNEL = "desktop:update-set-channel";
83	const UPDATE_DOWNLOAD_CHANNEL = "desktop:update-download";	88	const UPDATE_DOWNLOAD_CHANNEL = "desktop:update-download";
84	const UPDATE_INSTALL_CHANNEL = "desktop:update-install";	89	const UPDATE_INSTALL_CHANNEL = "desktop:update-install";
85	const UPDATE_CHECK_CHANNEL = "desktop:update-check";	90	const UPDATE_CHECK_CHANNEL = "desktop:update-check";
		91	const GET_APP_BRANDING_CHANNEL = "desktop:get-app-branding";
86	const GET_LOCAL_ENVIRONMENT_BOOTSTRAP_CHANNEL = "desktop:get-local-environment-bootstrap";	92	const GET_LOCAL_ENVIRONMENT_BOOTSTRAP_CHANNEL = "desktop:get-local-environment-bootstrap";
87	const GET_CLIENT_SETTINGS_CHANNEL = "desktop:get-client-settings";	93	const GET_CLIENT_SETTINGS_CHANNEL = "desktop:get-client-settings";
88	const SET_CLIENT_SETTINGS_CHANNEL = "desktop:set-client-settings";	94	const SET_CLIENT_SETTINGS_CHANNEL = "desktop:set-client-settings";
...	@@ -101,7 +107,11 @@ const SAVED_ENVIRONMENT_REGISTRY_PATH = Path.join(STATE_DIR, "saved-environments	...	@@ -101,7 +107,11 @@ const SAVED_ENVIRONMENT_REGISTRY_PATH = Path.join(STATE_DIR, "saved-environments
101	const DESKTOP_SCHEME = "t3";	107	const DESKTOP_SCHEME = "t3";
102	const ROOT_DIR = Path.resolve(__dirname, "../../..");	108	const ROOT_DIR = Path.resolve(__dirname, "../../..");
103	const isDevelopment = Boolean(process.env.VITE_DEV_SERVER_URL);	109	const isDevelopment = Boolean(process.env.VITE_DEV_SERVER_URL);
104	const APP_DISPLAY_NAME = isDevelopment ? "T3 Code (Dev)" : "T3 Code (Alpha)";	110	const desktopAppBranding: DesktopAppBranding = resolveDesktopAppBranding({
		111	isDevelopment,
		112	appVersion: app.getVersion(),
		113	});
		114	const APP_DISPLAY_NAME = desktopAppBranding.displayName;
105	const APP_USER_MODEL_ID = isDevelopment ? "com.t3tools.t3code.dev" : "com.t3tools.t3code";	115	const APP_USER_MODEL_ID = isDevelopment ? "com.t3tools.t3code.dev" : "com.t3tools.t3code";
106	const LINUX_DESKTOP_ENTRY_NAME = isDevelopment ? "t3code-dev.desktop" : "t3code.desktop";	116	const LINUX_DESKTOP_ENTRY_NAME = isDevelopment ? "t3code-dev.desktop" : "t3code.desktop";
107	const LINUX_WM_CLASS = isDevelopment ? "t3code-dev" : "t3code";	117	const LINUX_WM_CLASS = isDevelopment ? "t3code-dev" : "t3code";
...	@@ -116,8 +126,6 @@ const APP_RUN_ID = Crypto.randomBytes(6).toString("hex");	...	@@ -116,8 +126,6 @@ const APP_RUN_ID = Crypto.randomBytes(6).toString("hex");
116	const SERVER_SETTINGS_PATH = Path.join(STATE_DIR, "settings.json");	126	const SERVER_SETTINGS_PATH = Path.join(STATE_DIR, "settings.json");
117	const AUTO_UPDATE_STARTUP_DELAY_MS = 15_000;	127	const AUTO_UPDATE_STARTUP_DELAY_MS = 15_000;
118	const AUTO_UPDATE_POLL_INTERVAL_MS = 4 * 60 * 60 * 1000;	128	const AUTO_UPDATE_POLL_INTERVAL_MS = 4 * 60 * 60 * 1000;
119	const DESKTOP_UPDATE_CHANNEL = "latest";
120	const DESKTOP_UPDATE_ALLOW_PRERELEASE = false;
121	const DESKTOP_LOOPBACK_HOST = "127.0.0.1";	129	const DESKTOP_LOOPBACK_HOST = "127.0.0.1";
122	const DESKTOP_REQUIRED_PORT_PROBE_HOSTS = ["0.0.0.0", "::"] as const;	130	const DESKTOP_REQUIRED_PORT_PROBE_HOSTS = ["0.0.0.0", "::"] as const;
123	const TITLEBAR_HEIGHT = 40;	131	const TITLEBAR_HEIGHT = 40;
...	@@ -167,7 +175,11 @@ const desktopRuntimeInfo = resolveDesktopRuntimeInfo({	...	@@ -167,7 +175,11 @@ const desktopRuntimeInfo = resolveDesktopRuntimeInfo({
167	runningUnderArm64Translation: app.runningUnderARM64Translation === true,	175	runningUnderArm64Translation: app.runningUnderARM64Translation === true,
168	});	176	});
169	const initialUpdateState = (): DesktopUpdateState =>	177	const initialUpdateState = (): DesktopUpdateState =>
170	createInitialDesktopUpdateState(app.getVersion(), desktopRuntimeInfo);	178	createInitialDesktopUpdateState(
		179	app.getVersion(),
		180	desktopRuntimeInfo,
		181	desktopSettings.updateChannel,
		182	);
171		183
172	function logTimestamp(): string {	184	function logTimestamp(): string {
173	return new Date().toISOString();	185	return new Date().toISOString();
...	@@ -975,6 +987,18 @@ function resolveResourcePath(fileName: string): string \| null {	...	@@ -975,6 +987,18 @@ function resolveResourcePath(fileName: string): string \| null {
975	}	987	}
976		988
977	function resolveIconPath(ext: "ico" \| "icns" \| "png"): string \| null {	989	function resolveIconPath(ext: "ico" \| "icns" \| "png"): string \| null {
		990	if (isDevelopment && process.platform === "darwin" && ext === "png") {
		991	const developmentDockIconPath = Path.join(
		992	ROOT_DIR,
		993	"assets",
		994	"dev",
		995	"blueprint-macos-1024.png",
		996	);
		997	if (FS.existsSync(developmentDockIconPath)) {
		998	return developmentDockIconPath;
		999	}
		1000	}
		1001
978	return resolveResourcePath(`icon.${ext}`);	1002	return resolveResourcePath(`icon.${ext}`);
979	}	1003	}
980		1004
...	@@ -1074,6 +1098,26 @@ function setUpdateState(patch: Partial<DesktopUpdateState>): void {	...	@@ -1074,6 +1098,26 @@ function setUpdateState(patch: Partial<DesktopUpdateState>): void {
1074	emitUpdateState();	1098	emitUpdateState();
1075	}	1099	}
1076		1100
		1101	function createBaseUpdateState(
		1102	channel: DesktopUpdateChannel,
		1103	enabled: boolean,
		1104	): DesktopUpdateState {
		1105	return {
		1106	...createInitialDesktopUpdateState(app.getVersion(), desktopRuntimeInfo, channel),
		1107	enabled,
		1108	status: enabled ? "idle" : "disabled",
		1109	};
		1110	}
		1111
		1112	function applyAutoUpdaterChannel(channel: DesktopUpdateChannel): void {
		1113	autoUpdater.channel = channel;
		1114	autoUpdater.allowPrerelease = channel === "nightly";
		1115	autoUpdater.allowDowngrade = channel === "nightly";
		1116	console.info(
		1117	`[desktop-updater] Using update channel '${channel}' (allowPrerelease=${channel === "nightly"}).`,
		1118	);
		1119	}
		1120
1077	function shouldEnableAutoUpdates(): boolean {	1121	function shouldEnableAutoUpdates(): boolean {
1078	const hasUpdateFeedConfig =	1122	const hasUpdateFeedConfig =
1079	readAppUpdateYml() !== null \|\| Boolean(process.env.T3CODE_DESKTOP_MOCK_UPDATES);	1123	readAppUpdateYml() !== null \|\| Boolean(process.env.T3CODE_DESKTOP_MOCK_UPDATES);
...	@@ -1193,11 +1237,7 @@ function configureAutoUpdater(): void {	...	@@ -1193,11 +1237,7 @@ function configureAutoUpdater(): void {
1193	}	1237	}
1194		1238
1195	const enabled = shouldEnableAutoUpdates();	1239	const enabled = shouldEnableAutoUpdates();
1196	setUpdateState({	1240	setUpdateState(createBaseUpdateState(desktopSettings.updateChannel, enabled));
1197	...createInitialDesktopUpdateState(app.getVersion(), desktopRuntimeInfo),
1198	enabled,
1199	status: enabled ? "idle" : "disabled",
1200	});
1201	if (!enabled) {	1241	if (!enabled) {
1202	return;	1242	return;
1203	}	1243	}
...	@@ -1205,10 +1245,7 @@ function configureAutoUpdater(): void {	...	@@ -1205,10 +1245,7 @@ function configureAutoUpdater(): void {
1205		1245
1206	autoUpdater.autoDownload = false;	1246	autoUpdater.autoDownload = false;
1207	autoUpdater.autoInstallOnAppQuit = false;	1247	autoUpdater.autoInstallOnAppQuit = false;
1208	// Keep alpha branding, but force all installs onto the stable update track.	1248	applyAutoUpdaterChannel(desktopSettings.updateChannel);
1209	autoUpdater.channel = DESKTOP_UPDATE_CHANNEL;
1210	autoUpdater.allowPrerelease = DESKTOP_UPDATE_ALLOW_PRERELEASE;
1211	autoUpdater.allowDowngrade = false;
1212	autoUpdater.disableDifferentialDownload = isArm64HostRunningIntelBuild(desktopRuntimeInfo);	1249	autoUpdater.disableDifferentialDownload = isArm64HostRunningIntelBuild(desktopRuntimeInfo);
1213	let lastLoggedDownloadMilestone = -1;	1250	let lastLoggedDownloadMilestone = -1;
1214		1251
...	@@ -1486,6 +1523,11 @@ async function stopBackendAndWaitForExit(timeoutMs = 5_000): Promise<void> {	...	@@ -1486,6 +1523,11 @@ async function stopBackendAndWaitForExit(timeoutMs = 5_000): Promise<void> {
1486	}	1523	}
1487		1524
1488	function registerIpcHandlers(): void {	1525	function registerIpcHandlers(): void {
		1526	ipcMain.removeAllListeners(GET_APP_BRANDING_CHANNEL);
		1527	ipcMain.on(GET_APP_BRANDING_CHANNEL, (event) => {
		1528	event.returnValue = desktopAppBranding;
		1529	});
		1530
1489	ipcMain.removeAllListeners(GET_LOCAL_ENVIRONMENT_BOOTSTRAP_CHANNEL);	1531	ipcMain.removeAllListeners(GET_LOCAL_ENVIRONMENT_BOOTSTRAP_CHANNEL);
1490	ipcMain.on(GET_LOCAL_ENVIRONMENT_BOOTSTRAP_CHANNEL, (event) => {	1532	ipcMain.on(GET_LOCAL_ENVIRONMENT_BOOTSTRAP_CHANNEL, (event) => {
1491	event.returnValue = {	1533	event.returnValue = {
...	@@ -1713,6 +1755,42 @@ function registerIpcHandlers(): void {	...	@@ -1713,6 +1755,42 @@ function registerIpcHandlers(): void {
1713	ipcMain.removeHandler(UPDATE_GET_STATE_CHANNEL);	1755	ipcMain.removeHandler(UPDATE_GET_STATE_CHANNEL);
1714	ipcMain.handle(UPDATE_GET_STATE_CHANNEL, async () => updateState);	1756	ipcMain.handle(UPDATE_GET_STATE_CHANNEL, async () => updateState);
1715		1757
		1758	ipcMain.removeHandler(UPDATE_SET_CHANNEL_CHANNEL);
		1759	ipcMain.handle(UPDATE_SET_CHANNEL_CHANNEL, async (_event, rawChannel: unknown) => {
		1760	if (rawChannel !== "latest" && rawChannel !== "nightly") {
		1761	throw new Error("Invalid desktop update channel input.");
		1762	}
		1763	if (updateCheckInFlight \|\| updateDownloadInFlight \|\| updateInstallInFlight) {
		1764	throw new Error("Cannot change update tracks while an update action is in progress.");
		1765	}
		1766
		1767	const nextChannel = rawChannel as DesktopUpdateChannel;
		1768	if (nextChannel === desktopSettings.updateChannel) {
		1769	return updateState;
		1770	}
		1771
		1772	desktopSettings = setDesktopUpdateChannelPreference(desktopSettings, nextChannel);
		1773	writeDesktopSettings(DESKTOP_SETTINGS_PATH, desktopSettings);
		1774
		1775	const enabled = shouldEnableAutoUpdates();
		1776	setUpdateState(createBaseUpdateState(nextChannel, enabled));
		1777
		1778	if (!enabled \|\| !updaterConfigured) {
		1779	return updateState;
		1780	}
		1781
		1782	applyAutoUpdaterChannel(nextChannel);
		1783	const allowDowngrade = autoUpdater.allowDowngrade;
		1784	// An explicit channel switch should allow the immediate nightly->stable rollback path.
		1785	autoUpdater.allowDowngrade = true;
		1786	try {
		1787	await checkForUpdates("channel-change");
		1788	} finally {
		1789	autoUpdater.allowDowngrade = allowDowngrade;
		1790	}
		1791	return updateState;
		1792	});
		1793
1716	ipcMain.removeHandler(UPDATE_DOWNLOAD_CHANNEL);	1794	ipcMain.removeHandler(UPDATE_DOWNLOAD_CHANNEL);
1717	ipcMain.handle(UPDATE_DOWNLOAD_CHANNEL, async () => {	1795	ipcMain.handle(UPDATE_DOWNLOAD_CHANNEL, async () => {
1718	const result = await downloadAvailableUpdate();	1796	const result = await downloadAvailableUpdate();

apps/desktop/src/preload.ts+10

 @@ -9,9 +9,11 @@ const OPEN_EXTERNAL_CHANNEL = "desktop:open-external";
 const MENU_ACTION_CHANNEL = "desktop:menu-action";
 const UPDATE_STATE_CHANNEL = "desktop:update-state";
 const UPDATE_GET_STATE_CHANNEL = "desktop:update-get-state";
+const UPDATE_SET_CHANNEL_CHANNEL = "desktop:update-set-channel";
 const UPDATE_CHECK_CHANNEL = "desktop:update-check";
 const UPDATE_DOWNLOAD_CHANNEL = "desktop:update-download";
 const UPDATE_INSTALL_CHANNEL = "desktop:update-install";
+const GET_APP_BRANDING_CHANNEL = "desktop:get-app-branding";
 const GET_LOCAL_ENVIRONMENT_BOOTSTRAP_CHANNEL = "desktop:get-local-environment-bootstrap";
 const GET_CLIENT_SETTINGS_CHANNEL = "desktop:get-client-settings";
 const SET_CLIENT_SETTINGS_CHANNEL = "desktop:set-client-settings";
 @@ -24,6 +26,13 @@ const GET_SERVER_EXPOSURE_STATE_CHANNEL = "desktop:get-server-exposure-state";
 const SET_SERVER_EXPOSURE_MODE_CHANNEL = "desktop:set-server-exposure-mode";
 contextBridge.exposeInMainWorld("desktopBridge", {
+  getAppBranding: () => {
+    const result = ipcRenderer.sendSync(GET_APP_BRANDING_CHANNEL);
+    if (typeof result !== "object" || result === null) {
+      return null;
+    }
+    return result as ReturnType<DesktopBridge["getAppBranding"]>;
+  },
   getLocalEnvironmentBootstrap: () => {
     const result = ipcRenderer.sendSync(GET_LOCAL_ENVIRONMENT_BOOTSTRAP_CHANNEL);
     if (typeof result !== "object" || result === null) {
 @@ -61,6 +70,7 @@ contextBridge.exposeInMainWorld("desktopBridge", {
     };
   },
   getUpdateState: () => ipcRenderer.invoke(UPDATE_GET_STATE_CHANNEL),
+  setUpdateChannel: (channel) => ipcRenderer.invoke(UPDATE_SET_CHANNEL_CHANNEL, channel),
   checkForUpdate: () => ipcRenderer.invoke(UPDATE_CHECK_CHANNEL),
   downloadUpdate: () => ipcRenderer.invoke(UPDATE_DOWNLOAD_CHANNEL),
   installUpdate: () => ipcRenderer.invoke(UPDATE_INSTALL_CHANNEL),

apps/desktop/src/updateMachine.test.ts+7-6

apps/desktop/src/updateMachine.ts+7-1

 @@ -1,14 +1,20 @@
-import type { DesktopRuntimeInfo, DesktopUpdateState } from "@t3tools/contracts";
+import type {
+  DesktopRuntimeInfo,
+  DesktopUpdateChannel,
+  DesktopUpdateState,
+} from "@t3tools/contracts";
 import { getCanRetryAfterDownloadFailure, nextStatusAfterDownloadFailure } from "./updateState";
 export function createInitialDesktopUpdateState(
   currentVersion: string,
   runtimeInfo: DesktopRuntimeInfo,
+  channel: DesktopUpdateChannel,
 ): DesktopUpdateState {
   return {
     enabled: false,
     status: "disabled",
+    channel,
     currentVersion,
     hostArch: runtimeInfo.hostArch,
     appArch: runtimeInfo.appArch,

apps/desktop/src/updateState.test.ts+1

...	@@ -11,6 +11,7 @@ import {	...	@@ -11,6 +11,7 @@ import {
11	const baseState: DesktopUpdateState = {	11	const baseState: DesktopUpdateState = {
12	enabled: true,	12	enabled: true,
13	status: "idle",	13	status: "idle",
		14	channel: "latest",
14	currentVersion: "1.0.0",	15	currentVersion: "1.0.0",
15	hostArch: "x64",	16	hostArch: "x64",
16	appArch: "x64",	17	appArch: "x64",

apps/web/src/branding.test.ts created+37

...	@@ -0,0 +1,37 @@
1	import { afterEach, describe, expect, it, vi } from "vitest";
2
3	const originalWindow = globalThis.window;
4
5	afterEach(() => {
6	vi.resetModules();
7
8	if (originalWindow === undefined) {
9	Reflect.deleteProperty(globalThis, "window");
10	return;
11	}
12
13	globalThis.window = originalWindow;
14	});
15
16	describe("branding", () => {
17	it("uses injected desktop branding when available", async () => {
18	Object.defineProperty(globalThis, "window", {
19	configurable: true,
20	value: {
21	desktopBridge: {
22	getAppBranding: () => ({
23	baseName: "T3 Code",
24	stageLabel: "Nightly",
25	displayName: "T3 Code (Nightly)",
26	}),
27	},
28	},
29	});
30
31	const branding = await import("./branding");
32
33	expect(branding.APP_BASE_NAME).toBe("T3 Code");
34	expect(branding.APP_STAGE_LABEL).toBe("Nightly");
35	expect(branding.APP_DISPLAY_NAME).toBe("T3 Code (Nightly)");
36	});
37	});

apps/web/src/branding.ts+17-3

...	@@ -1,4 +1,18 @@	...	@@ -1,4 +1,18 @@
1	export const APP_BASE_NAME = "T3 Code";	1	import type { DesktopAppBranding } from "@t3tools/contracts";
2	export const APP_STAGE_LABEL = import.meta.env.DEV ? "Dev" : "Alpha";	2
3	export const APP_DISPLAY_NAME = `${APP_BASE_NAME} (${APP_STAGE_LABEL})`;	3	function readInjectedDesktopAppBranding(): DesktopAppBranding \| null {
		4	if (typeof window === "undefined") {
		5	return null;
		6	}
		7
		8	return window.desktopBridge?.getAppBranding?.() ?? null;
		9	}
		10
		11	const injectedDesktopAppBranding = readInjectedDesktopAppBranding();
		12
		13	export const APP_BASE_NAME = injectedDesktopAppBranding?.baseName ?? "T3 Code";
		14	export const APP_STAGE_LABEL =
		15	injectedDesktopAppBranding?.stageLabel ?? (import.meta.env.DEV ? "Dev" : "Alpha");
		16	export const APP_DISPLAY_NAME =
		17	injectedDesktopAppBranding?.displayName ?? `${APP_BASE_NAME} (${APP_STAGE_LABEL})`;
4	export const APP_VERSION = import.meta.env.APP_VERSION \|\| "0.0.0";	18	export const APP_VERSION = import.meta.env.APP_VERSION \|\| "0.0.0";

apps/web/src/components/desktopUpdate.logic.test.ts+1

...	@@ -17,6 +17,7 @@ import {	...	@@ -17,6 +17,7 @@ import {
17	const baseState: DesktopUpdateState = {	17	const baseState: DesktopUpdateState = {
18	enabled: true,	18	enabled: true,
19	status: "idle",	19	status: "idle",
		20	channel: "latest",
20	currentVersion: "1.0.0",	21	currentVersion: "1.0.0",
21	hostArch: "x64",	22	hostArch: "x64",
22	appArch: "x64",	23	appArch: "x64",

apps/web/src/components/settings/SettingsPanels.browser.tsx+10

 @@ -7,6 +7,7 @@ import {
   DEFAULT_SERVER_SETTINGS,
   EnvironmentId,
   type DesktopBridge,
+  type DesktopUpdateChannel,
   type DesktopUpdateState,
   type LocalApi,
   type ServerConfig,
 @@ -258,10 +259,12 @@ function makeClientSession(input: {
 const createDesktopBridgeStub = (overrides?: {
   readonly serverExposureState?: Awaited<ReturnType<DesktopBridge["getServerExposureState"]>>;
   readonly setServerExposureMode?: DesktopBridge["setServerExposureMode"];
+  readonly setUpdateChannel?: DesktopBridge["setUpdateChannel"];
 }): DesktopBridge => {
   const idleUpdateState: DesktopUpdateState = {
     enabled: false,
     status: "idle",
+    channel: "latest",
     currentVersion: "0.0.0-test",
     hostArch: "arm64",
     appArch: "arm64",
 @@ -276,6 +279,7 @@ const createDesktopBridgeStub = (overrides?: {
   };
   return {
+    getAppBranding: vi.fn().mockReturnValue(null),
     getLocalEnvironmentBootstrap: () => ({
       label: "Local environment",
       httpBaseUrl: "http://127.0.0.1:3773",
 @@ -310,6 +314,12 @@ const createDesktopBridgeStub = (overrides?: {
     openExternal: vi.fn().mockResolvedValue(true),
     onMenuAction: () => () => {},
     getUpdateState: vi.fn().mockResolvedValue(idleUpdateState),
+    setUpdateChannel:
+      overrides?.setUpdateChannel ??
+      vi.fn().mockImplementation(async (channel: DesktopUpdateChannel) => ({
+        ...idleUpdateState,
+        channel,
+      })),
     checkForUpdate: vi.fn().mockResolvedValue({ checked: false, state: idleUpdateState }),
     downloadUpdate: vi
       .fn()

apps/web/src/components/settings/SettingsPanels.tsx+88-21

...	@@ -12,6 +12,7 @@ import { useQueryClient } from "@tanstack/react-query";	...	@@ -12,6 +12,7 @@ import { useQueryClient } from "@tanstack/react-query";
12	import { type ReactNode, useCallback, useMemo, useRef, useState } from "react";	12	import { type ReactNode, useCallback, useMemo, useRef, useState } from "react";
13	import {	13	import {
14	PROVIDER_DISPLAY_NAMES,	14	PROVIDER_DISPLAY_NAMES,
		15	type DesktopUpdateChannel,
15	type ScopedThreadRef,	16	type ScopedThreadRef,
16	type ProviderKind,	17	type ProviderKind,
17	type ServerProvider,	18	type ServerProvider,
...	@@ -232,8 +233,42 @@ function AboutVersionTitle() {	...	@@ -232,8 +233,42 @@ function AboutVersionTitle() {
232	function AboutVersionSection() {	233	function AboutVersionSection() {
233	const queryClient = useQueryClient();	234	const queryClient = useQueryClient();
234	const updateStateQuery = useDesktopUpdateState();	235	const updateStateQuery = useDesktopUpdateState();
		236	const [isChangingUpdateChannel, setIsChangingUpdateChannel] = useState(false);
235		237
236	const updateState = updateStateQuery.data ?? null;	238	const updateState = updateStateQuery.data ?? null;
		239	const hasDesktopBridge = typeof window !== "undefined" && Boolean(window.desktopBridge);
		240	const selectedUpdateChannel = updateState?.channel ?? "latest";
		241
		242	const handleUpdateChannelChange = useCallback(
		243	(channel: DesktopUpdateChannel) => {
		244	const bridge = window.desktopBridge;
		245	if (
		246	!bridge \|\|
		247	typeof bridge.setUpdateChannel !== "function" \|\|
		248	channel === selectedUpdateChannel
		249	) {
		250	return;
		251	}
		252
		253	setIsChangingUpdateChannel(true);
		254	void bridge
		255	.setUpdateChannel(channel)
		256	.then((state) => {
		257	setDesktopUpdateStateQueryData(queryClient, state);
		258	})
		259	.catch((error: unknown) => {
		260	toastManager.add({
		261	type: "error",
		262	title: "Could not change update track",
		263	description: error instanceof Error ? error.message : "Update track change failed.",
		264	});
		265	})
		266	.finally(() => {
		267	setIsChangingUpdateChannel(false);
		268	});
		269	},
		270	[queryClient, selectedUpdateChannel],
		271	);
237		272
238	const handleButtonClick = useCallback(() => {	273	const handleButtonClick = useCallback(() => {
239	const bridge = window.desktopBridge;	274	const bridge = window.desktopBridge;
...	@@ -323,27 +358,59 @@ function AboutVersionSection() {	...	@@ -323,27 +358,59 @@ function AboutVersionSection() {
323	: "Current version of the application.";	358	: "Current version of the application.";
324		359
325	return (	360	return (
326	<SettingsRow	361	<>
327	title={<AboutVersionTitle />}	362	<SettingsRow
328	description={description}	363	title={<AboutVersionTitle />}
329	control={	364	description={description}
330	<Tooltip>	365	control={
331	<TooltipTrigger	366	<Tooltip>
332	render={	367	<TooltipTrigger
333	<Button	368	render={
334	size="xs"	369	<Button
335	variant={action === "install" ? "default" : "outline"}	370	size="xs"
336	disabled={buttonDisabled}	371	variant={action === "install" ? "default" : "outline"}
337	onClick={handleButtonClick}	372	disabled={buttonDisabled}
338	>	373	onClick={handleButtonClick}
339	{buttonLabel}	374	>
340	</Button>	375	{buttonLabel}
341	}	376	</Button>
342	/>	377	}
343	{buttonTooltip ? <TooltipPopup>{buttonTooltip}</TooltipPopup> : null}	378	/>
344	</Tooltip>	379	{buttonTooltip ? <TooltipPopup>{buttonTooltip}</TooltipPopup> : null}
345	}	380	</Tooltip>
346	/>	381	}
		382	/>
		383	<SettingsRow
		384	title="Update track"
		385	description="Stable follows full releases. Nightly follows the nightly desktop channel and can switch back to stable immediately."
		386	control={
		387	<Select
		388	value={selectedUpdateChannel}
		389	onValueChange={(value) => {
		390	handleUpdateChannelChange(value as DesktopUpdateChannel);
		391	}}
		392	>
		393	<SelectTrigger
		394	className="w-full sm:w-40"
		395	aria-label="Update track"
		396	disabled={!hasDesktopBridge \|\| isChangingUpdateChannel}
		397	>
		398	<SelectValue>
		399	{selectedUpdateChannel === "nightly" ? "Nightly" : "Stable"}
		400	</SelectValue>
		401	</SelectTrigger>
		402	<SelectPopup align="end" alignItemWithTrigger={false}>
		403	<SelectItem hideIndicator value="latest">
		404	Stable
		405	</SelectItem>
		406	<SelectItem hideIndicator value="nightly">
		407	Nightly
		408	</SelectItem>
		409	</SelectPopup>
		410	</Select>
		411	}
		412	/>
		413	</>
347	);	414	);
348	}	415	}
349		416

apps/web/src/lib/desktopUpdateReactQuery.test.ts+1

...	@@ -10,6 +10,7 @@ import {	...	@@ -10,6 +10,7 @@ import {
10	const baseState: DesktopUpdateState = {	10	const baseState: DesktopUpdateState = {
11	enabled: true,	11	enabled: true,
12	status: "idle",	12	status: "idle",
		13	channel: "latest",
13	currentVersion: "1.0.0",	14	currentVersion: "1.0.0",
14	hostArch: "x64",	15	hostArch: "x64",
15	appArch: "x64",	16	appArch: "x64",

apps/web/src/localApi.test.ts+4

...	@@ -157,6 +157,7 @@ function createLocalStorageStub(): Storage {	...	@@ -157,6 +157,7 @@ function createLocalStorageStub(): Storage {
157		157
158	function makeDesktopBridge(overrides: Partial<DesktopBridge> = {}): DesktopBridge {	158	function makeDesktopBridge(overrides: Partial<DesktopBridge> = {}): DesktopBridge {
159	return {	159	return {
		160	getAppBranding: () => null,
160	getLocalEnvironmentBootstrap: () => null,	161	getLocalEnvironmentBootstrap: () => null,
161	getClientSettings: async () => null,	162	getClientSettings: async () => null,
162	setClientSettings: async () => undefined,	163	setClientSettings: async () => undefined,
...	@@ -184,6 +185,9 @@ function makeDesktopBridge(overrides: Partial<DesktopBridge> = {}): DesktopBridg	...	@@ -184,6 +185,9 @@ function makeDesktopBridge(overrides: Partial<DesktopBridge> = {}): DesktopBridg
184	getUpdateState: async () => {	185	getUpdateState: async () => {
185	throw new Error("getUpdateState not implemented in test");	186	throw new Error("getUpdateState not implemented in test");
186	},	187	},
		188	setUpdateChannel: async () => {
		189	throw new Error("setUpdateChannel not implemented in test");
		190	},
187	checkForUpdate: async () => {	191	checkForUpdate: async () => {
188	throw new Error("checkForUpdate not implemented in test");	192	throw new Error("checkForUpdate not implemented in test");
189	},	193	},

assets/dev/blueprint-icon-composer.icon/Assets/T3.svg created+3

...	@@ -0,0 +1,3 @@
1	<svg width="77" height="47" viewBox="0 0 77 47" fill="none" xmlns="http://www.w3.org/2000/svg">
2	<path d="M14.56 45.5V8.58H1.69082e-06V-3.09944e-06H39.65V8.58H25.09V45.5H14.56ZM57.8454 46.28C54.6821 46.28 51.5404 45.8683 48.4204 45.045C45.3004 44.1783 42.6571 42.965 40.4904 41.405L44.5854 33.345C46.3188 34.6017 48.3338 35.5983 50.6304 36.335C52.9271 37.0717 55.2454 37.44 57.5854 37.44C60.2288 37.44 62.3088 36.92 63.8254 35.88C65.3421 34.84 66.1004 33.41 66.1004 31.59C66.1004 29.8567 65.4288 28.4917 64.0854 27.495C62.7421 26.4983 60.5754 26 57.5854 26H52.7754V19.045L65.4504 4.68L66.6204 8.45H42.7654V-3.09944e-06H74.6154V6.825L62.0054 21.19L56.6754 18.135H59.7304C65.3204 18.135 69.5454 19.3917 72.4054 21.905C75.2654 24.4183 76.6954 27.6467 76.6954 31.59C76.6954 34.1467 76.0238 36.5517 74.6804 38.805C73.3371 41.015 71.2788 42.8133 68.5054 44.2C65.7321 45.5867 62.1788 46.28 57.8454 46.28Z" fill="white"/>
3	</svg>

assets/dev/blueprint-icon-composer.icon/Assets/Texturelabs_Paper_381XL.jpg created

Binary files /dev/null and b/assets/dev/blueprint-icon-composer.icon/Assets/Texturelabs_Paper_381XL.jpg differ

assets/dev/blueprint-icon-composer.icon/Assets/gpt-image-1.5-kn76n9hynne5q3qxy3g91chp2d84t871.png created

Binary files /dev/null and b/assets/dev/blueprint-icon-composer.icon/Assets/gpt-image-1.5-kn76n9hynne5q3qxy3g91chp2d84t871.png differ

assets/dev/blueprint-icon-composer.icon/icon.json created+47

...	@@ -0,0 +1,47 @@
1	{
2	"fill": {
3	"solid": "display-p3:0.00000,0.00000,0.00000,1.00000"
4	},
5	"groups": [
6	{
7	"layers": [
8	{
9	"blend-mode": "normal",
10	"fill": "automatic",
11	"glass": true,
12	"hidden": false,
13	"image-name": "gpt-image-1.5-kn76n9hynne5q3qxy3g91chp2d84t871.png",
14	"name": "gpt-image-1.5-kn76n9hynne5q3qxy3g91chp2d84t871",
15	"position": {
16	"scale": 1.05,
17	"translation-in-points": [0, 0]
18	}
19	},
20	{
21	"image-name": "T3.svg",
22	"name": "T3",
23	"position": {
24	"scale": 10,
25	"translation-in-points": [0, 0]
26	}
27	},
28	{
29	"hidden": false,
30	"image-name": "Texturelabs_Paper_381XL.jpg",
31	"name": "Texturelabs_Paper_381XL"
32	}
33	],
34	"shadow": {
35	"kind": "neutral",
36	"opacity": 0.5
37	},
38	"translucency": {
39	"enabled": true,
40	"value": 0.5
41	}
42	}
43	],
44	"supported-platforms": {
45	"squares": ["iOS", "macOS"]
46	}
47	}

assets/dev/blueprint-ios-1024.png

Binary files a/assets/dev/blueprint-ios-1024.png and b/assets/dev/blueprint-ios-1024.png differ

assets/dev/blueprint-macos-1024.png

Binary files a/assets/dev/blueprint-macos-1024.png and b/assets/dev/blueprint-macos-1024.png differ

assets/dev/blueprint-universal-1024.png

Binary files a/assets/dev/blueprint-universal-1024.png and b/assets/dev/blueprint-universal-1024.png differ

assets/dev/blueprint-web-apple-touch-180.png

Binary files a/assets/dev/blueprint-web-apple-touch-180.png and b/assets/dev/blueprint-web-apple-touch-180.png differ

assets/dev/blueprint-web-favicon-16x16.png

Binary files a/assets/dev/blueprint-web-favicon-16x16.png and b/assets/dev/blueprint-web-favicon-16x16.png differ

assets/dev/blueprint-web-favicon-32x32.png

Binary files a/assets/dev/blueprint-web-favicon-32x32.png and b/assets/dev/blueprint-web-favicon-32x32.png differ

assets/dev/blueprint-web-favicon.ico

Binary files a/assets/dev/blueprint-web-favicon.ico and b/assets/dev/blueprint-web-favicon.ico differ

assets/dev/blueprint-windows.ico

Binary files a/assets/dev/blueprint-windows.ico and b/assets/dev/blueprint-windows.ico differ

assets/nightly/blueprint-ios-1024.png created

Binary files /dev/null and b/assets/nightly/blueprint-ios-1024.png differ

assets/nightly/blueprint-macos-1024.png created

Binary files /dev/null and b/assets/nightly/blueprint-macos-1024.png differ

assets/nightly/blueprint-universal-1024.png created

Binary files /dev/null and b/assets/nightly/blueprint-universal-1024.png differ

assets/nightly/blueprint-web-apple-touch-180.png created

Binary files /dev/null and b/assets/nightly/blueprint-web-apple-touch-180.png differ

assets/nightly/blueprint-web-favicon-16x16.png created

Binary files /dev/null and b/assets/nightly/blueprint-web-favicon-16x16.png differ

assets/nightly/blueprint-web-favicon-32x32.png created

Binary files /dev/null and b/assets/nightly/blueprint-web-favicon-32x32.png differ

assets/nightly/blueprint-web-favicon.ico created

Binary files /dev/null and b/assets/nightly/blueprint-web-favicon.ico differ

assets/nightly/blueprint-windows.ico created

Binary files /dev/null and b/assets/nightly/blueprint-windows.ico differ

docs/release.md+37-12

 @@ -1,23 +1,47 @@
 # Release Checklist
-This document covers how to run desktop releases from one tag, first without signing, then with signing.
+This document covers the unified release workflow for stable and nightly desktop releases.
 ## What the workflow does
-- Trigger: push tag matching `v*.*.*`.
+- Workflow: `.github/workflows/release.yml`
+- Triggers:
+  - push tag matching `v*.*.*` for stable releases
+  - scheduled nightly at `09:00 UTC`
+  - manual `workflow_dispatch` for either channel
 - Runs quality gates first: lint, typecheck, test.
-- Builds four artifacts in parallel:
+- Builds four artifacts in parallel for both channels:
   - macOS `arm64` DMG
   - macOS `x64` DMG
   - Linux `x64` AppImage
   - Windows `x64` NSIS installer
 - Publishes one GitHub Release with all produced files.
-  - Versions with a suffix after `X.Y.Z` (for example `1.2.3-alpha.1`) are published as GitHub prereleases.
+  - Stable tags with a suffix after `X.Y.Z` (for example `1.2.3-alpha.1`) are published as GitHub prereleases.
-  - Only plain `X.Y.Z` releases are marked as the repository's latest release.
+  - Only plain stable `X.Y.Z` releases are marked as the repository's latest release.
-- Includes Electron auto-update metadata (for example `latest*.yml` and `*.blockmap`) in release assets.
+  - Nightly runs are always GitHub prereleases and never marked latest.
-- Publishes the CLI package (`apps/server`, npm package `t3`) with OIDC trusted publishing.
+  - Automatically generated release notes are pinned to the previous tag in the same channel, so stable compares to the previous stable tag and nightly compares to the previous nightly tag.
+- Includes Electron auto-update metadata (for example `latest*.yml`, `nightly*.yml`, and `*.blockmap`) in release assets.
+- Publishes the CLI package (`apps/server`, npm package `t3`) with OIDC trusted publishing from the same workflow file:
+  - stable releases publish npm dist-tag `latest`
+  - nightly releases publish npm dist-tag `nightly`
 - Signing is optional and auto-detected per platform from secrets.
+## Nightly builds
+- Workflow: `.github/workflows/release.yml`
+- Triggers:
+  - scheduled every day at `09:00 UTC`
+  - manual `workflow_dispatch` with `channel=nightly`
+- Runs the same desktop quality gates and artifact matrix as the tagged release flow.
+- Publishes a GitHub prerelease only:
+  - tag format: `nightly-vX.Y.Z-nightly.YYYYMMDD.<run_number>`
+  - release name includes the short commit SHA
+  - `make_latest` is always `false`
+- Uses the current `apps/desktop/package.json` semver core (`X.Y.Z`) as the nightly base, then appends a nightly prerelease suffix.
+- Publishes Electron auto-update metadata to the dedicated `nightly` updater channel, so desktop users can opt into that track independently from stable.
+- Publishes the CLI package (`apps/server`, npm package `t3`) to the `nightly` npm dist-tag using the same nightly version.
+- Does not commit version bumps back to `main`.
 ## Desktop auto-update notes
 - Runtime updater: `electron-updater` in `apps/desktop/src/main.ts`.
 @@ -34,15 +58,15 @@ This document covers how to run desktop releases from one tag, first without sig
   - the app forwards it as an `Authorization: Bearer <token>` request header for updater HTTP calls.
 - Required release assets for updater:
   - platform installers (`.exe`, `.dmg`, `.AppImage`, plus macOS `.zip` for Squirrel.Mac update payloads)
-  - `latest*.yml` metadata
+  - channel metadata: `latest*.yml` for stable releases, `nightly*.yml` for nightly releases
   - `*.blockmap` files (used for differential downloads)
 - macOS metadata note:
-  - `electron-updater` reads `latest-mac.yml` for both Intel and Apple Silicon.
+  - `electron-updater` reads `latest-mac.yml` on stable and `nightly-mac.yml` on nightly, for both Intel and Apple Silicon.
-  - The workflow merges the per-arch mac manifests into one `latest-mac.yml` before publishing the GitHub Release.
+  - The workflow merges the per-arch mac manifests into one channel-specific mac manifest before publishing the GitHub Release.
 ## 0) npm OIDC trusted publishing setup (CLI)
-The workflow publishes the CLI with `bun publish` from `apps/server` after bumping
+The workflow publishes the CLI with `npm publish` from `apps/server` after bumping
 the package version to the release tag version.
 Checklist:
 @@ -57,7 +81,8 @@ Checklist:
 4. Create release tag `vX.Y.Z` and push; workflow will:
    - set `apps/server/package.json` version to `X.Y.Z`
    - build web + server
-   - run `bun publish --access public`
+   - run `npm publish --access public --tag latest`
+5. Nightly runs from the same workflow file publish with `npm publish --access public --tag nightly`.
 ## 1) Dry-run release without signing

packages/contracts/src/ipc.ts+11

...	@@ -73,6 +73,14 @@ export type DesktopUpdateStatus =	...	@@ -73,6 +73,14 @@ export type DesktopUpdateStatus =
73		73
74	export type DesktopRuntimeArch = "arm64" \| "x64" \| "other";	74	export type DesktopRuntimeArch = "arm64" \| "x64" \| "other";
75	export type DesktopTheme = "light" \| "dark" \| "system";	75	export type DesktopTheme = "light" \| "dark" \| "system";
		76	export type DesktopUpdateChannel = "latest" \| "nightly";
		77	export type DesktopAppStageLabel = "Alpha" \| "Dev" \| "Nightly";
		78
		79	export interface DesktopAppBranding {
		80	baseName: string;
		81	stageLabel: DesktopAppStageLabel;
		82	displayName: string;
		83	}
76		84
77	export interface DesktopRuntimeInfo {	85	export interface DesktopRuntimeInfo {
78	hostArch: DesktopRuntimeArch;	86	hostArch: DesktopRuntimeArch;
...	@@ -83,6 +91,7 @@ export interface DesktopRuntimeInfo {	...	@@ -83,6 +91,7 @@ export interface DesktopRuntimeInfo {
83	export interface DesktopUpdateState {	91	export interface DesktopUpdateState {
84	enabled: boolean;	92	enabled: boolean;
85	status: DesktopUpdateStatus;	93	status: DesktopUpdateStatus;
		94	channel: DesktopUpdateChannel;
86	currentVersion: string;	95	currentVersion: string;
87	hostArch: DesktopRuntimeArch;	96	hostArch: DesktopRuntimeArch;
88	appArch: DesktopRuntimeArch;	97	appArch: DesktopRuntimeArch;
...	@@ -132,6 +141,7 @@ export interface DesktopServerExposureState {	...	@@ -132,6 +141,7 @@ export interface DesktopServerExposureState {
132	}	141	}
133		142
134	export interface DesktopBridge {	143	export interface DesktopBridge {
		144	getAppBranding: () => DesktopAppBranding \| null;
135	getLocalEnvironmentBootstrap: () => DesktopEnvironmentBootstrap \| null;	145	getLocalEnvironmentBootstrap: () => DesktopEnvironmentBootstrap \| null;
136	getClientSettings: () => Promise<ClientSettings \| null>;	146	getClientSettings: () => Promise<ClientSettings \| null>;
137	setClientSettings: (settings: ClientSettings) => Promise<void>;	147	setClientSettings: (settings: ClientSettings) => Promise<void>;
...	@@ -154,6 +164,7 @@ export interface DesktopBridge {	...	@@ -154,6 +164,7 @@ export interface DesktopBridge {
154	openExternal: (url: string) => Promise<boolean>;	164	openExternal: (url: string) => Promise<boolean>;
155	onMenuAction: (listener: (action: string) => void) => () => void;	165	onMenuAction: (listener: (action: string) => void) => () => void;
156	getUpdateState: () => Promise<DesktopUpdateState>;	166	getUpdateState: () => Promise<DesktopUpdateState>;
		167	setUpdateChannel: (channel: DesktopUpdateChannel) => Promise<DesktopUpdateState>;
157	checkForUpdate: () => Promise<DesktopUpdateCheckResult>;	168	checkForUpdate: () => Promise<DesktopUpdateCheckResult>;
158	downloadUpdate: () => Promise<DesktopUpdateActionResult>;	169	downloadUpdate: () => Promise<DesktopUpdateActionResult>;
159	installUpdate: () => Promise<DesktopUpdateActionResult>;	170	installUpdate: () => Promise<DesktopUpdateActionResult>;

scripts/build-desktop-artifact.test.ts+51-1

...	@@ -2,9 +2,59 @@ import * as NodeServices from "@effect/platform-node/NodeServices";	...	@@ -2,9 +2,59 @@ import * as NodeServices from "@effect/platform-node/NodeServices";
2	import { assert, it } from "@effect/vitest";	2	import { assert, it } from "@effect/vitest";
3	import { ConfigProvider, Effect, Option } from "effect";	3	import { ConfigProvider, Effect, Option } from "effect";
4		4
5	import { resolveBuildOptions } from "./build-desktop-artifact.ts";	5	import {
		6	resolveBuildOptions,
		7	resolveDesktopBuildIconAssets,
		8	resolveDesktopUpdateChannel,
		9	resolveMockUpdateServerPort,
		10	resolveMockUpdateServerUrl,
		11	} from "./build-desktop-artifact.ts";
		12	import { BRAND_ASSET_PATHS } from "./lib/brand-assets.ts";
6		13
7	it.layer(NodeServices.layer)("build-desktop-artifact", (it) => {	14	it.layer(NodeServices.layer)("build-desktop-artifact", (it) => {
		15	it("resolves the dedicated nightly updater channel from nightly versions", () => {
		16	assert.equal(resolveDesktopUpdateChannel("0.0.17-nightly.20260413.42"), "nightly");
		17	assert.equal(resolveDesktopUpdateChannel("0.0.17"), "latest");
		18	});
		19
		20	it("switches desktop packaging icons to the nightly artwork for nightly versions", () => {
		21	assert.deepStrictEqual(resolveDesktopBuildIconAssets("0.0.17"), {
		22	macIconPng: BRAND_ASSET_PATHS.productionMacIconPng,
		23	linuxIconPng: BRAND_ASSET_PATHS.productionLinuxIconPng,
		24	windowsIconIco: BRAND_ASSET_PATHS.productionWindowsIconIco,
		25	});
		26
		27	assert.deepStrictEqual(resolveDesktopBuildIconAssets("0.0.17-nightly.20260413.42"), {
		28	macIconPng: BRAND_ASSET_PATHS.nightlyMacIconPng,
		29	linuxIconPng: BRAND_ASSET_PATHS.nightlyLinuxIconPng,
		30	windowsIconIco: BRAND_ASSET_PATHS.nightlyWindowsIconIco,
		31	});
		32	});
		33
		34	it("falls back to the default mock update port when the configured port is blank", () => {
		35	assert.equal(resolveMockUpdateServerUrl(undefined), "http://localhost:3000");
		36	assert.equal(resolveMockUpdateServerUrl(4123), "http://localhost:4123");
		37	});
		38
		39	it.effect("normalizes mock update server ports from env-style strings", () =>
		40	Effect.gen(function* () {
		41	assert.equal(yield* resolveMockUpdateServerPort(undefined), undefined);
		42	assert.equal(yield* resolveMockUpdateServerPort(""), undefined);
		43	assert.equal(yield* resolveMockUpdateServerPort(" "), undefined);
		44	assert.equal(yield* resolveMockUpdateServerPort("4123"), 4123);
		45	}),
		46	);
		47
		48	it.effect("rejects non-numeric or out-of-range mock update ports", () =>
		49	Effect.gen(function* () {
		50	const invalidPorts = ["abc", "12.5", "0", "65536"];
		51	for (const port of invalidPorts) {
		52	const exit = yield* Effect.exit(resolveMockUpdateServerPort(port));
		53	assert.equal(exit._tag, "Failure");
		54	}
		55	}),
		56	);
		57
8	it.effect("preserves explicit false boolean flags over true env defaults", () =>	58	it.effect("preserves explicit false boolean flags over true env defaults", () =>
9	Effect.gen(function* () {	59	Effect.gen(function* () {
10	const resolved = yield* resolveBuildOptions({	60	const resolved = yield* resolveBuildOptions({

scripts/build-desktop-artifact.ts+101-49

 @@ -23,23 +23,14 @@ const BuildArch = Schema.Literals(["arm64", "x64", "universal"]);
 const RepoRoot = Effect.service(Path.Path).pipe(
   Effect.flatMap((path) => path.fromFileUrl(new URL("..", import.meta.url))),
 );
-const ProductionMacIconSource = Effect.zipWith(
-  RepoRoot,
-  Effect.service(Path.Path),
-  (repoRoot, path) => path.join(repoRoot, BRAND_ASSET_PATHS.productionMacIconPng),
-);
-const ProductionLinuxIconSource = Effect.zipWith(
-  RepoRoot,
-  Effect.service(Path.Path),
-  (repoRoot, path) => path.join(repoRoot, BRAND_ASSET_PATHS.productionLinuxIconPng),
-);
-const ProductionWindowsIconSource = Effect.zipWith(
-  RepoRoot,
-  Effect.service(Path.Path),
-  (repoRoot, path) => path.join(repoRoot, BRAND_ASSET_PATHS.productionWindowsIconIco),
-);
 const encodeJsonString = Schema.encodeEffect(Schema.UnknownFromJsonString);
+interface DesktopBuildIconAssets {
+  readonly macIconPng: string;
+  readonly linuxIconPng: string;
+  readonly windowsIconIco: string;
+}
 interface PlatformConfig {
   readonly cliFlag: "--mac" | "--linux" | "--win";
   readonly defaultTarget: string;
 @@ -75,7 +66,7 @@ interface BuildCliInput {
   readonly signed: Option.Option<boolean>;
   readonly verbose: Option.Option<boolean>;
   readonly mockUpdates: Option.Option<boolean>;
-  readonly mockUpdateServerPort: Option.Option<string>;
+  readonly mockUpdateServerPort: Option.Option<number>;
 }
 function detectHostBuildPlatform(hostPlatform: string): typeof BuildPlatform.Type | undefined {
 @@ -165,7 +156,7 @@ interface ResolvedBuildOptions {
   readonly signed: boolean;
   readonly verbose: boolean;
   readonly mockUpdates: boolean;
-  readonly mockUpdateServerPort: string | undefined;
+  readonly mockUpdateServerPort: number | undefined;
 }
 interface StagePackageJson {
 @@ -213,11 +204,28 @@ const BuildEnvConfig = Config.all({
   mockUpdateServerPort: Config.string("T3CODE_DESKTOP_MOCK_UPDATE_SERVER_PORT").pipe(Config.option),
 });
+const MockUpdateServerPortSchema = Schema.NumberFromString.check(
+  Schema.isInt(),
+  Schema.isBetween({ minimum: 1, maximum: 65535 }),
+);
+const decodeMockUpdateServerPort = Schema.decodeUnknownEffect(MockUpdateServerPortSchema);
 const resolveBooleanFlag = (flag: Option.Option<boolean>, envValue: boolean) =>
   Option.getOrElse(flag, () => envValue);
 const mergeOptions = <A>(a: Option.Option<A>, b: Option.Option<A>, defaultValue: A) =>
   Option.getOrElse(a, () => Option.getOrElse(b, () => defaultValue));
+export const resolveMockUpdateServerPort = Effect.fn("resolveMockUpdateServerPort")(function* (
+  mockUpdateServerPort: string | undefined,
+) {
+  const port = mockUpdateServerPort?.trim();
+  if (!port) {
+    return undefined;
+  }
+  return yield* decodeMockUpdateServerPort(port);
+});
 export const resolveBuildOptions = Effect.fn("resolveBuildOptions")(function* (
   input: BuildCliInput,
 ) {
 @@ -254,11 +262,17 @@ export const resolveBuildOptions = Effect.fn("resolveBuildOptions")(function* (
   const verbose = resolveBooleanFlag(input.verbose, env.verbose);
   const mockUpdates = resolveBooleanFlag(input.mockUpdates, env.mockUpdates);
-  const mockUpdateServerPort = mergeOptions(
+  const mockUpdateServerPort =
-    input.mockUpdateServerPort,
+    Option.getOrUndefined(input.mockUpdateServerPort) ??
-    env.mockUpdateServerPort,
+    (yield* resolveMockUpdateServerPort(Option.getOrUndefined(env.mockUpdateServerPort)).pipe(
-    undefined,
+      Effect.mapError(
-  );
+        (cause) =>
+          new BuildScriptError({
+            message: "Invalid mock update server port.",
+            cause,
+          }),
+      ),
+    ));
   return {
     platform,
 @@ -329,14 +343,13 @@ function generateMacIconSet(
   });
 }
-function stageMacIcons(stageResourcesDir: string, verbose: boolean) {
+function stageMacIcons(stageResourcesDir: string, sourcePng: string, verbose: boolean) {
   return Effect.gen(function* () {
     const fs = yield* FileSystem.FileSystem;
     const path = yield* Path.Path;
-    const iconSource = yield* ProductionMacIconSource;
+    if (!(yield* fs.exists(sourcePng))) {
-    if (!(yield* fs.exists(iconSource))) {
       return yield* new BuildScriptError({
-        message: `Production icon source is missing at ${iconSource}`,
+        message: `Desktop macOS icon source is missing at ${sourcePng}`,
       });
     }
 @@ -350,42 +363,40 @@ function stageMacIcons(stageResourcesDir: string, verbose: boolean) {
     yield* runCommand(
       ChildProcess.make({
         ...commandOutputOptions(verbose),
-      })`sips -z 512 512 ${iconSource} --out ${iconPngPath}`,
+      })`sips -z 512 512 ${sourcePng} --out ${iconPngPath}`,
     );
-    yield* generateMacIconSet(iconSource, iconIcnsPath, tmpRoot, path, verbose);
+    yield* generateMacIconSet(sourcePng, iconIcnsPath, tmpRoot, path, verbose);
   });
 }
-function stageLinuxIcons(stageResourcesDir: string) {
+function stageLinuxIcons(stageResourcesDir: string, sourcePng: string) {
   return Effect.gen(function* () {
     const fs = yield* FileSystem.FileSystem;
     const path = yield* Path.Path;
-    const iconSource = yield* ProductionLinuxIconSource;
+    if (!(yield* fs.exists(sourcePng))) {
-    if (!(yield* fs.exists(iconSource))) {
       return yield* new BuildScriptError({
-        message: `Production icon source is missing at ${iconSource}`,
+        message: `Desktop Linux icon source is missing at ${sourcePng}`,
       });
     }
     const iconPath = path.join(stageResourcesDir, "icon.png");
-    yield* fs.copyFile(iconSource, iconPath);
+    yield* fs.copyFile(sourcePng, iconPath);
   });
 }
-function stageWindowsIcons(stageResourcesDir: string) {
+function stageWindowsIcons(stageResourcesDir: string, sourceIco: string) {
   return Effect.gen(function* () {
     const fs = yield* FileSystem.FileSystem;
     const path = yield* Path.Path;
-    const iconSource = yield* ProductionWindowsIconSource;
+    if (!(yield* fs.exists(sourceIco))) {
-    if (!(yield* fs.exists(iconSource))) {
       return yield* new BuildScriptError({
-        message: `Production Windows icon source is missing at ${iconSource}`,
+        message: `Desktop Windows icon source is missing at ${sourceIco}`,
       });
     }
     const iconPath = path.join(stageResourcesDir, "icon.ico");
-    yield* fs.copyFile(iconSource, iconPath);
+    yield* fs.copyFile(sourceIco, iconPath);
   });
 }
 @@ -441,12 +452,13 @@ function resolveDesktopRuntimeDependencies(
   return resolveCatalogDependencies(runtimeDependencies, catalog, "apps/desktop");
 }
-function resolveGitHubPublishConfig():
+function resolveGitHubPublishConfig(updateChannel: "latest" | "nightly"):
   | {
       readonly provider: "github";
       readonly owner: string;
       readonly repo: string;
-      readonly releaseType: "release";
+      readonly releaseType: "release" | "prerelease";
+      readonly channel?: "nightly";
     }
   | undefined {
   const rawRepo =
 @@ -462,17 +474,43 @@ function resolveGitHubPublishConfig():
     provider: "github",
     owner,
     repo,
-    releaseType: "release",
+    releaseType: updateChannel === "nightly" ? "prerelease" : "release",
+    ...(updateChannel === "nightly" ? { channel: "nightly" as const } : {}),
   };
 }
+export function resolveDesktopUpdateChannel(version: string): "latest" | "nightly" {
+  return /-nightly\.\d{8}\.\d+$/.test(version) ? "nightly" : "latest";
+}
+export function resolveDesktopBuildIconAssets(version: string): DesktopBuildIconAssets {
+  if (resolveDesktopUpdateChannel(version) === "nightly") {
+    return {
+      macIconPng: BRAND_ASSET_PATHS.nightlyMacIconPng,
+      linuxIconPng: BRAND_ASSET_PATHS.nightlyLinuxIconPng,
+      windowsIconIco: BRAND_ASSET_PATHS.nightlyWindowsIconIco,
+    };
+  }
+  return {
+    macIconPng: BRAND_ASSET_PATHS.productionMacIconPng,
+    linuxIconPng: BRAND_ASSET_PATHS.productionLinuxIconPng,
+    windowsIconIco: BRAND_ASSET_PATHS.productionWindowsIconIco,
+  };
+}
+export function resolveMockUpdateServerUrl(mockUpdateServerPort: number | undefined): string {
+  return `http://localhost:${mockUpdateServerPort ?? 3000}`;
+}
 const createBuildConfig = Effect.fn("createBuildConfig")(function* (
   platform: typeof BuildPlatform.Type,
   target: string,
   productName: string,
+  version: string,
   signed: boolean,
   mockUpdates: boolean,
-  mockUpdateServerPort: string | undefined,
+  mockUpdateServerPort: number | undefined,
 ) {
   const buildConfig: Record<string, unknown> = {
     appId: "com.t3tools.t3code",
 @@ -482,14 +520,15 @@ const createBuildConfig = Effect.fn("createBuildConfig")(function* (
       buildResources: "apps/desktop/resources",
     },
   };
-  const publishConfig = resolveGitHubPublishConfig();
+  const updateChannel = resolveDesktopUpdateChannel(version);
+  const publishConfig = resolveGitHubPublishConfig(updateChannel);
   if (publishConfig) {
     buildConfig.publish = [publishConfig];
   } else if (mockUpdates) {
     buildConfig.publish = [
       {
         provider: "generic",
-        url: `http://localhost:${mockUpdateServerPort ?? 3000}`,
+        url: resolveMockUpdateServerUrl(mockUpdateServerPort),
       },
     ];
   }
 @@ -533,20 +572,21 @@ const createBuildConfig = Effect.fn("createBuildConfig")(function* (
 const assertPlatformBuildResources = Effect.fn("assertPlatformBuildResources")(function* (
   platform: typeof BuildPlatform.Type,
   stageResourcesDir: string,
+  iconAssets: DesktopBuildIconAssets,
   verbose: boolean,
 ) {
   if (platform === "mac") {
-    yield* stageMacIcons(stageResourcesDir, verbose);
+    yield* stageMacIcons(stageResourcesDir, iconAssets.macIconPng, verbose);
     return;
   }
   if (platform === "linux") {
-    yield* stageLinuxIcons(stageResourcesDir);
+    yield* stageLinuxIcons(stageResourcesDir, iconAssets.linuxIconPng);
     return;
   }
   if (platform === "win") {
-    yield* stageWindowsIcons(stageResourcesDir);
+    yield* stageWindowsIcons(stageResourcesDir, iconAssets.windowsIconIco);
   }
 });
 @@ -614,6 +654,7 @@ const buildDesktopArtifact = Effect.fn("buildDesktopArtifact")(function* (
   });
   const appVersion = options.version ?? serverPackageJson.version;
+  const iconAssets = resolveDesktopBuildIconAssets(appVersion);
   const commitHash = resolveGitCommitHash(repoRoot);
   const mkdir = options.keepStage ? fs.makeTempDirectory : fs.makeTempDirectoryScoped;
   const stageRoot = yield* mkdir({
 @@ -665,7 +706,16 @@ const buildDesktopArtifact = Effect.fn("buildDesktopArtifact")(function* (
   yield* fs.copy(distDirs.desktopResources, stageResourcesDir);
   yield* fs.copy(distDirs.serverDist, path.join(stageAppDir, "apps/server/dist"));
-  yield* assertPlatformBuildResources(options.platform, stageResourcesDir, options.verbose);
+  yield* assertPlatformBuildResources(
+    options.platform,
+    stageResourcesDir,
+    {
+      macIconPng: join(repoRoot, iconAssets.macIconPng),
+      linuxIconPng: join(repoRoot, iconAssets.linuxIconPng),
+      windowsIconIco: join(repoRoot, iconAssets.windowsIconIco),
+    },
+    options.verbose,
+  );
   // electron-builder is filtering out stageResourcesDir directory in the AppImage for production
   yield* fs.copy(stageResourcesDir, path.join(stageAppDir, "apps/desktop/prod-resources"));
 @@ -683,6 +733,7 @@ const buildDesktopArtifact = Effect.fn("buildDesktopArtifact")(function* (
       options.platform,
       options.target,
       desktopPackageJson.productName ?? "T3 Code",
+      appVersion,
       options.signed,
       options.mockUpdates,
       options.mockUpdateServerPort,
 @@ -829,7 +880,8 @@ const buildDesktopArtifactCli = Command.make("build-desktop-artifact", {
     Flag.withDescription("Enable mock updates (env: T3CODE_DESKTOP_MOCK_UPDATES)."),
     Flag.optional,
   ),
-  mockUpdateServerPort: Flag.string("mock-update-server-port").pipe(
+  mockUpdateServerPort: Flag.integer("mock-update-server-port").pipe(
+    Flag.withSchema(Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 65535 }))),
     Flag.withDescription("Mock update server port (env: T3CODE_DESKTOP_MOCK_UPDATE_SERVER_PORT)."),
     Flag.optional,
   ),

scripts/lib/brand-assets.ts+6

...	@@ -6,6 +6,12 @@ export const BRAND_ASSET_PATHS = {	...	@@ -6,6 +6,12 @@ export const BRAND_ASSET_PATHS = {
6	productionWebFavicon16Png: "assets/prod/t3-black-web-favicon-16x16.png",	6	productionWebFavicon16Png: "assets/prod/t3-black-web-favicon-16x16.png",
7	productionWebFavicon32Png: "assets/prod/t3-black-web-favicon-32x32.png",	7	productionWebFavicon32Png: "assets/prod/t3-black-web-favicon-32x32.png",
8	productionWebAppleTouchIconPng: "assets/prod/t3-black-web-apple-touch-180.png",	8	productionWebAppleTouchIconPng: "assets/prod/t3-black-web-apple-touch-180.png",
		9
		10	nightlyMacIconPng: "assets/nightly/blueprint-macos-1024.png",
		11	nightlyLinuxIconPng: "assets/nightly/blueprint-universal-1024.png",
		12	nightlyWindowsIconIco: "assets/nightly/blueprint-windows.ico",
		13
		14	developmentDesktopIconPng: "assets/dev/blueprint-macos-1024.png",
9	developmentWindowsIconIco: "assets/dev/blueprint-windows.ico",	15	developmentWindowsIconIco: "assets/dev/blueprint-windows.ico",
10	developmentWebFaviconIco: "assets/dev/blueprint-web-favicon.ico",	16	developmentWebFaviconIco: "assets/dev/blueprint-web-favicon.ico",
11	developmentWebFavicon16Png: "assets/dev/blueprint-web-favicon-16x16.png",	17	developmentWebFavicon16Png: "assets/dev/blueprint-web-favicon-16x16.png",

scripts/release-smoke.ts+35-1

...	@@ -95,7 +95,7 @@ try {	...	@@ -95,7 +95,7 @@ try {
95	},	95	},
96	);	96	);
97		97
98	execFileSync("bun", ["install", "--lockfile-only", "--ignore-scripts"], {	98	execFileSync("bun", ["install", "--ignore-scripts"], {
99	cwd: tempRoot,	99	cwd: tempRoot,
100	stdio: "inherit",	100	stdio: "inherit",
101	});	101	});
...	@@ -107,6 +107,40 @@ try {	...	@@ -107,6 +107,40 @@ try {
107	"Expected bun.lock to contain the smoke version.",	107	"Expected bun.lock to contain the smoke version.",
108	);	108	);
109		109
		110	const nightlyReleaseMetadata = execFileSync(
		111	process.execPath,
		112	[
		113	resolve(repoRoot, "scripts/resolve-nightly-release.ts"),
		114	"--date",
		115	"20260413",
		116	"--run-number",
		117	"321",
		118	"--sha",
		119	"abcdef1234567890",
		120	"--root",
		121	tempRoot,
		122	],
		123	{
		124	cwd: repoRoot,
		125	encoding: "utf8",
		126	},
		127	);
		128	assertContains(
		129	nightlyReleaseMetadata,
		130	"version=9.9.9-nightly.20260413.321",
		131	"Expected nightly metadata to contain the derived nightly version.",
		132	);
		133	assertContains(
		134	nightlyReleaseMetadata,
		135	"tag=nightly-v9.9.9-nightly.20260413.321",
		136	"Expected nightly metadata to contain the derived nightly tag.",
		137	);
		138	assertContains(
		139	nightlyReleaseMetadata,
		140	"name=T3 Code Nightly 9.9.9-nightly.20260413.321 (abcdef123456)",
		141	"Expected nightly metadata to include the short commit SHA in the release name.",
		142	);
		143
110	const { arm64Path, x64Path } = writeMacManifestFixtures(tempRoot);	144	const { arm64Path, x64Path } = writeMacManifestFixtures(tempRoot);
111	execFileSync(	145	execFileSync(
112	process.execPath,	146	process.execPath,

scripts/resolve-nightly-release.test.ts created+25

...	@@ -0,0 +1,25 @@
1	import { assert, it } from "@effect/vitest";
2
3	import {
4	resolveNightlyBaseVersion,
5	resolveNightlyReleaseMetadata,
6	} from "./resolve-nightly-release.ts";
7
8	it("strips prerelease and build metadata when deriving the nightly base version", () => {
9	assert.equal(resolveNightlyBaseVersion("0.0.17"), "0.0.17");
10	assert.equal(resolveNightlyBaseVersion("9.9.9-smoke.0"), "9.9.9");
11	assert.equal(resolveNightlyBaseVersion("1.2.3-beta.4+build.9"), "1.2.3");
12	});
13
14	it("derives nightly metadata including the short commit sha in the release name", () => {
15	assert.deepStrictEqual(
16	resolveNightlyReleaseMetadata("9.9.9", "20260413", 321, "abcdef1234567890"),
17	{
18	baseVersion: "9.9.9",
19	version: "9.9.9-nightly.20260413.321",
20	tag: "nightly-v9.9.9-nightly.20260413.321",
21	name: "T3 Code Nightly 9.9.9-nightly.20260413.321 (abcdef123456)",
22	shortSha: "abcdef123456",
23	},
24	);
25	});

scripts/resolve-nightly-release.ts created+126

...	@@ -0,0 +1,126 @@
1	#!/usr/bin/env node
2
3	import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
4	import * as NodeServices from "@effect/platform-node/NodeServices";
5	import { Config, Effect, FileSystem, Option, Path, Schema } from "effect";
6	import { Command, Flag } from "effect/unstable/cli";
7
8	interface NightlyReleaseMetadata {
9	readonly baseVersion: string;
10	readonly version: string;
11	readonly tag: string;
12	readonly name: string;
13	readonly shortSha: string;
14	}
15
16	const DateSchema = Schema.String.check(Schema.isPattern(/^\d{8}$/));
17	const RunNumberSchema = Schema.FiniteFromString.check(
18	Schema.isInt(),
19	Schema.isGreaterThanOrEqualTo(1),
20	);
21	const ShaSchema = Schema.String.check(Schema.isPattern(/^[0-9a-f]{7,40}$/i));
22	const DesktopPackageJsonSchema = Schema.Struct({
23	version: Schema.NonEmptyString,
24	});
25
26	const RepoRoot = Effect.service(Path.Path).pipe(
27	Effect.flatMap((path) => path.fromFileUrl(new URL("..", import.meta.url))),
28	);
29	const decodeDesktopPackageJson = Schema.decodeUnknownEffect(
30	Schema.fromJsonString(DesktopPackageJsonSchema),
31	);
32
33	export const resolveNightlyBaseVersion = (version: string) => version.replace(/[-+].*$/, "");
34
35	export const resolveNightlyReleaseMetadata = (
36	baseVersion: string,
37	date: string,
38	runNumber: number,
39	sha: string,
40	) => {
41	const shortSha = sha.slice(0, 12);
42	const version = `${baseVersion}-nightly.${date}.${runNumber}`;
43	return {
44	baseVersion,
45	version,
46	tag: `nightly-v${version}`,
47	name: `T3 Code Nightly ${version} (${shortSha})`,
48	shortSha,
49	};
50	};
51
52	const readDesktopBaseVersion = Effect.fn("readDesktopBaseVersion")(function* (
53	rootDir: string \| undefined,
54	) {
55	const fs = yield* FileSystem.FileSystem;
56	const path = yield* Path.Path;
57	const workspaceRoot = rootDir ? path.resolve(rootDir) : yield* RepoRoot;
58	const packageJsonPath = path.join(workspaceRoot, "apps/desktop/package.json");
59	const packageJson = yield* fs
60	.readFileString(packageJsonPath)
61	.pipe(Effect.flatMap(decodeDesktopPackageJson));
62	return resolveNightlyBaseVersion(packageJson.version);
63	});
64
65	const writeOutput = Effect.fn("writeOutput")(function* (
66	metadata: NightlyReleaseMetadata,
67	writeGithubOutput: boolean,
68	) {
69	const fs = yield* FileSystem.FileSystem;
70
71	const entries = [
72	["base_version", metadata.baseVersion],
73	["version", metadata.version],
74	["tag", metadata.tag],
75	["name", metadata.name],
76	["short_sha", metadata.shortSha],
77	] as const;
78
79	if (writeGithubOutput) {
80	const githubOutputPath = yield* Config.nonEmptyString("GITHUB_OUTPUT");
81	const serialized = entries.map(([key, value]) => `${key}=${value}\n`).join("");
82	yield* fs.writeFileString(githubOutputPath, serialized, { flag: "a" });
83	} else {
84	for (const [key, value] of entries) {
85	console.log(`${key}=${value}`);
86	}
87	}
88	});
89
90	const command = Command.make(
91	"resolve-nightly-release",
92	{
93	date: Flag.string("date").pipe(
94	Flag.withSchema(DateSchema),
95	Flag.withDescription("Nightly build date in YYYYMMDD."),
96	),
97	runNumber: Flag.string("run-number").pipe(
98	Flag.withSchema(RunNumberSchema),
99	Flag.withDescription("GitHub Actions run number."),
100	),
101	sha: Flag.string("sha").pipe(
102	Flag.withSchema(ShaSchema),
103	Flag.withDescription("Commit sha for the nightly build."),
104	),
105	githubOutput: Flag.boolean("github-output").pipe(
106	Flag.withDescription("Write values to GITHUB_OUTPUT instead of stdout."),
107	Flag.withDefault(false),
108	),
109	root: Flag.string("root").pipe(
110	Flag.withDescription("Workspace root used to resolve apps/desktop/package.json."),
111	Flag.optional,
112	),
113	},
114	({ date, runNumber, sha, githubOutput, root }) =>
115	readDesktopBaseVersion(Option.getOrUndefined(root)).pipe(
116	Effect.map((baseVersion) => resolveNightlyReleaseMetadata(baseVersion, date, runNumber, sha)),
117	Effect.flatMap((metadata) => writeOutput(metadata, githubOutput)),
118	),
119	).pipe(Command.withDescription("Resolve nightly release version metadata."));
120
121	if (import.meta.main) {
122	Command.run(command, { version: "0.0.0" }).pipe(
123	Effect.provide(NodeServices.layer),
124	NodeRuntime.runMain,
125	);
126	}

scripts/resolve-previous-release-tag.ts created+203

...	@@ -0,0 +1,203 @@
1	#!/usr/bin/env node
2
3	import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
4	import * as NodeServices from "@effect/platform-node/NodeServices";
5	import { Array, Config, Effect, FileSystem, Schema, Stream, String } from "effect";
6	import { Command, Flag } from "effect/unstable/cli";
7	import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
8
9	const ReleaseChannel = Schema.Literals(["stable", "nightly"]);
10	type ReleaseChannel = typeof ReleaseChannel.Type;
11
12	interface StableVersion {
13	readonly major: number;
14	readonly minor: number;
15	readonly patch: number;
16	readonly prerelease: ReadonlyArray<string>;
17	}
18
19	interface NightlyVersion {
20	readonly major: number;
21	readonly minor: number;
22	readonly patch: number;
23	readonly date: number;
24	readonly runNumber: number;
25	}
26
27	const parseNumericIdentifier = (identifier: string): number \| undefined =>
28	/^\d+$/.test(identifier) ? Number(identifier) : undefined;
29
30	const comparePrereleaseIdentifiers = (left: string, right: string): number => {
31	const leftNumeric = parseNumericIdentifier(left);
32	const rightNumeric = parseNumericIdentifier(right);
33
34	if (leftNumeric !== undefined && rightNumeric !== undefined) {
35	return leftNumeric - rightNumeric;
36	}
37	if (leftNumeric !== undefined) {
38	return -1;
39	}
40	if (rightNumeric !== undefined) {
41	return 1;
42	}
43	return left.localeCompare(right);
44	};
45
46	const compareStableVersions = (left: StableVersion, right: StableVersion): number => {
47	if (left.major !== right.major) return left.major - right.major;
48	if (left.minor !== right.minor) return left.minor - right.minor;
49	if (left.patch !== right.patch) return left.patch - right.patch;
50
51	const leftHasPrerelease = left.prerelease.length > 0;
52	const rightHasPrerelease = right.prerelease.length > 0;
53	if (!leftHasPrerelease && !rightHasPrerelease) return 0;
54	if (!leftHasPrerelease) return 1;
55	if (!rightHasPrerelease) return -1;
56
57	const maxLength = Math.max(left.prerelease.length, right.prerelease.length);
58	for (let index = 0; index < maxLength; index += 1) {
59	const leftIdentifier = left.prerelease[index];
60	const rightIdentifier = right.prerelease[index];
61	if (leftIdentifier === undefined) return -1;
62	if (rightIdentifier === undefined) return 1;
63
64	const comparison = comparePrereleaseIdentifiers(leftIdentifier, rightIdentifier);
65	if (comparison !== 0) return comparison;
66	}
67
68	return 0;
69	};
70
71	const parseStableTag = (tag: string): StableVersion \| undefined => {
72	const match = /^v(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(tag);
73	if (!match) return undefined;
74
75	const [, major, minor, patch, prerelease] = match;
76	if (!major \|\| !minor \|\| !patch) return undefined;
77
78	return {
79	major: Number(major),
80	minor: Number(minor),
81	patch: Number(patch),
82	prerelease: prerelease ? prerelease.split(".") : [],
83	};
84	};
85
86	const compareNightlyVersions = (left: NightlyVersion, right: NightlyVersion): number => {
87	if (left.major !== right.major) return left.major - right.major;
88	if (left.minor !== right.minor) return left.minor - right.minor;
89	if (left.patch !== right.patch) return left.patch - right.patch;
90	if (left.date !== right.date) return left.date - right.date;
91	return left.runNumber - right.runNumber;
92	};
93
94	const parseNightlyTag = (tag: string): NightlyVersion \| undefined => {
95	const match = /^nightly-v(\d+)\.(\d+)\.(\d+)-nightly\.(\d{8})\.(\d+)$/.exec(tag);
96	if (!match) return undefined;
97
98	const [, major, minor, patch, date, runNumber] = match;
99	if (!major \|\| !minor \|\| !patch \|\| !date \|\| !runNumber) return undefined;
100
101	return {
102	major: Number(major),
103	minor: Number(minor),
104	patch: Number(patch),
105	date: Number(date),
106	runNumber: Number(runNumber),
107	};
108	};
109
110	const resolvePreviousReleaseTag = (
111	channel: ReleaseChannel,
112	currentTag: string,
113	tags: ReadonlyArray<string>,
114	): string \| undefined => {
115	if (channel === "stable") {
116	const current = parseStableTag(currentTag);
117	if (!current) {
118	throw new Error(`Invalid stable release tag '${currentTag}'.`);
119	}
120
121	const candidates = tags
122	.map((tag) => ({ tag, parsed: parseStableTag(tag) }))
123	.filter(
124	(entry): entry is { tag: string; parsed: StableVersion } => entry.parsed !== undefined,
125	)
126	.filter((entry) => compareStableVersions(entry.parsed, current) < 0)
127	.toSorted((left, right) => compareStableVersions(right.parsed, left.parsed));
128
129	return candidates[0]?.tag;
130	}
131
132	const current = parseNightlyTag(currentTag);
133	if (!current) {
134	throw new Error(`Invalid nightly release tag '${currentTag}'.`);
135	}
136
137	const candidates = tags
138	.map((tag) => ({ tag, parsed: parseNightlyTag(tag) }))
139	.filter((entry): entry is { tag: string; parsed: NightlyVersion } => entry.parsed !== undefined)
140	.filter((entry) => compareNightlyVersions(entry.parsed, current) < 0)
141	.toSorted((left, right) => compareNightlyVersions(right.parsed, left.parsed));
142
143	return candidates[0]?.tag;
144	};
145
146	const listGitTags = Effect.fn("listGitTags")(function* () {
147	const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
148	const child = yield* spawner.spawn(ChildProcess.make("git", ["tag", "--list"]));
149	const tags = yield* child.stdout.pipe(
150	Stream.decodeText(),
151	Stream.runFold(
152	() => "",
153	(acc, chunk) => acc + chunk,
154	),
155	Effect.map(String.split(/\r?\n/)),
156	Effect.map(Array.map(String.trim)),
157	Effect.map(Array.filter(String.isNonEmpty)),
158	);
159	return tags;
160	});
161
162	const writeOutput = Effect.fn("writeOutput")(function* (
163	previousTag: string \| undefined,
164	writeGithubOutput: boolean,
165	) {
166	const entry = `previous_tag=${previousTag ?? ""}\n`;
167
168	if (writeGithubOutput) {
169	const fs = yield* FileSystem.FileSystem;
170	const githubOutputPath = yield* Config.nonEmptyString("GITHUB_OUTPUT");
171	yield* fs.writeFileString(githubOutputPath, entry, { flag: "a" });
172	return;
173	}
174
175	process.stdout.write(entry);
176	});
177
178	const command = Command.make(
179	"resolve-previous-release-tag",
180	{
181	channel: Flag.choice("channel", ReleaseChannel.literals).pipe(
182	Flag.withDescription("Release channel whose previous tag should be resolved."),
183	),
184	currentTag: Flag.string("current-tag").pipe(
185	Flag.withDescription("Current release tag to compare against."),
186	),
187	githubOutput: Flag.boolean("github-output").pipe(
188	Flag.withDescription("Write values to GITHUB_OUTPUT instead of stdout."),
189	Flag.withDefault(false),
190	),
191	},
192	({ channel, currentTag, githubOutput }) =>
193	listGitTags().pipe(
194	Effect.map((tags) => resolvePreviousReleaseTag(channel, currentTag, tags)),
195	Effect.flatMap((previousTag) => writeOutput(previousTag, githubOutput)),
196	),
197	).pipe(Command.withDescription("Resolve the previous release tag for a stable or nightly series."));
198
199	Command.run(command, { version: "0.0.0" }).pipe(
200	Effect.scoped,
201	Effect.provide(NodeServices.layer),
202	NodeRuntime.runMain,
203	);

author	Julius Marminge <julius0216@outlook.com> 2026-04-14 18:18:37-07:00
committer	GitHub <noreply@github.com> 2026-04-14 18:18:37-07:00
log	409ff90a1401c0b8e2bef05d73b3be57ff9bc669
tree	d74b22eaea5ac7a32e6913438ff3d87a9f9651de
parent	0d280262f6c9dcaf529376b2007dc7447f86fa3c
signature	Signed by PGP key B5690EEEBB952194

...	@@ -23,7 +23,7 @@ describe("updateMachine", () => {	...	@@ -23,7 +23,7 @@ describe("updateMachine", () => {
23	it("clears transient errors when a check starts", () => {	23	it("clears transient errors when a check starts", () => {
24	const state = reduceDesktopUpdateStateOnCheckStart(	24	const state = reduceDesktopUpdateStateOnCheckStart(
25	{	25	{
26	...createInitialDesktopUpdateState("1.0.0", runtimeInfo),	26	...createInitialDesktopUpdateState("1.0.0", runtimeInfo, "latest"),
27	enabled: true,	27	enabled: true,
28	status: "error",	28	status: "error",
29	message: "network",	29	message: "network",
...	@@ -42,7 +42,7 @@ describe("updateMachine", () => {	...	@@ -42,7 +42,7 @@ describe("updateMachine", () => {
42	it("records a check failure without exposing an action", () => {	42	it("records a check failure without exposing an action", () => {
43	const state = reduceDesktopUpdateStateOnCheckFailure(	43	const state = reduceDesktopUpdateStateOnCheckFailure(
44	{	44	{
45	...createInitialDesktopUpdateState("1.0.0", runtimeInfo),	45	...createInitialDesktopUpdateState("1.0.0", runtimeInfo, "latest"),
46	enabled: true,	46	enabled: true,
47	status: "checking",	47	status: "checking",
48	},	48	},
...	@@ -58,7 +58,7 @@ describe("updateMachine", () => {	...	@@ -58,7 +58,7 @@ describe("updateMachine", () => {
58	it("preserves available version on download failure for retry", () => {	58	it("preserves available version on download failure for retry", () => {
59	const state = reduceDesktopUpdateStateOnDownloadFailure(	59	const state = reduceDesktopUpdateStateOnDownloadFailure(
60	{	60	{
61	...createInitialDesktopUpdateState("1.0.0", runtimeInfo),	61	...createInitialDesktopUpdateState("1.0.0", runtimeInfo, "latest"),
62	enabled: true,	62	enabled: true,
63	status: "downloading",	63	status: "downloading",
64	availableVersion: "1.1.0",	64	availableVersion: "1.1.0",
...	@@ -76,7 +76,7 @@ describe("updateMachine", () => {	...	@@ -76,7 +76,7 @@ describe("updateMachine", () => {
76	it("transitions to downloaded and then preserves install retry state", () => {	76	it("transitions to downloaded and then preserves install retry state", () => {
77	const downloaded = reduceDesktopUpdateStateOnDownloadComplete(	77	const downloaded = reduceDesktopUpdateStateOnDownloadComplete(
78	{	78	{
79	...createInitialDesktopUpdateState("1.0.0", runtimeInfo),	79	...createInitialDesktopUpdateState("1.0.0", runtimeInfo, "latest"),
80	enabled: true,	80	enabled: true,
81	status: "downloading",	81	status: "downloading",
82	availableVersion: "1.1.0",	82	availableVersion: "1.1.0",
...	@@ -98,7 +98,7 @@ describe("updateMachine", () => {	...	@@ -98,7 +98,7 @@ describe("updateMachine", () => {
98	it("clears stale download state when no update is available", () => {	98	it("clears stale download state when no update is available", () => {
99	const state = reduceDesktopUpdateStateOnNoUpdate(	99	const state = reduceDesktopUpdateStateOnNoUpdate(
100	{	100	{
101	...createInitialDesktopUpdateState("1.0.0", runtimeInfo),	101	...createInitialDesktopUpdateState("1.0.0", runtimeInfo, "latest"),
102	enabled: true,	102	enabled: true,
103	status: "error",	103	status: "error",
104	availableVersion: "1.1.0",	104	availableVersion: "1.1.0",
...	@@ -120,7 +120,7 @@ describe("updateMachine", () => {	...	@@ -120,7 +120,7 @@ describe("updateMachine", () => {
120	it("tracks available, download start, and progress cleanly", () => {	120	it("tracks available, download start, and progress cleanly", () => {
121	const available = reduceDesktopUpdateStateOnUpdateAvailable(	121	const available = reduceDesktopUpdateStateOnUpdateAvailable(
122	{	122	{
123	...createInitialDesktopUpdateState("1.0.0", runtimeInfo),	123	...createInitialDesktopUpdateState("1.0.0", runtimeInfo, "latest"),
124	enabled: true,	124	enabled: true,
125	status: "checking",	125	status: "checking",
126	},	126	},
...	@@ -131,6 +131,7 @@ describe("updateMachine", () => {	...	@@ -131,6 +131,7 @@ describe("updateMachine", () => {
131	const progress = reduceDesktopUpdateStateOnDownloadProgress(downloading, 55.5);	131	const progress = reduceDesktopUpdateStateOnDownloadProgress(downloading, 55.5);
132		132
133	expect(available.status).toBe("available");	133	expect(available.status).toBe("available");
		134	expect(available.channel).toBe("latest");
134	expect(downloading.status).toBe("downloading");	135	expect(downloading.status).toBe("downloading");
135	expect(downloading.downloadPercent).toBe(0);	136	expect(downloading.downloadPercent).toBe(0);
136	expect(progress.downloadPercent).toBe(55.5);	137	expect(progress.downloadPercent).toBe(55.5);

Nightly release channel (#2012)