From ba9bed6a0dcf40db3226aa99a785ef04a59c6a89 Mon Sep 17 00:00:00 2001
From: Josh Wright <josh@thewrightserver.net>
Date: Sat, 17 Oct 2026 09:45:53 -0400
Subject: [PATCH] Fix release version labels across deployment views

---
 src/lib/artifact-version.ts                   | 13 +++
 src/lib/deployment-plan.ts                    |  2 +
 src/lib/server/fleet/launch-recipes.ts        | 31 +++++-
 src/lib/server/fleet/scripts.ts               |  9 +-
 .../server/provisioning/activation-files.ts   |  4 +-
 src/lib/server/provisioning/move-recipes.ts   | 11 ++-
 src/lib/server/provisioning/native.ts         |  3 +-
 src/lib/ui/campaigns.ts                       | 29 ++++--
 .../components/DeployCollectionDialog.svelte  |  5 +-
 .../ui/components/DeployServerDialog.svelte   |  3 +-
 src/lib/ui/components/LaunchRecipe.svelte     |  3 +-
 src/routes/api/campaigns/+server.ts           | 16 ++-
 src/routes/api/campaigns/[id]/+server.ts      |  6 +-
 src/routes/api/deployments/[id]/+server.ts    |  6 +-
 tests/unit/campaign-list.test.ts              | 48 ++++++++-
 .../launch-recipe-summary-migration.test.ts   | 89 +++++++++++++++++
 tests/unit/launch-recipes.test.ts             | 50 ++++++++++
 tests/unit/native-provisioning.test.ts        | 98 +++++++++++++++++--
 tests/unit/ui-campaigns.test.ts               | 48 ++++++++-
 tests/unit/ui-launch-recipe.test.ts           | 50 ++++++++++
 20 files changed, 485 insertions(+), 39 deletions(-)
 create mode 100644 tests/unit/ui-launch-recipe.test.ts

diff --git a/src/lib/artifact-version.ts b/src/lib/artifact-version.ts
index 66d76eb..a928668 100644
--- a/src/lib/artifact-version.ts
+++ b/src/lib/artifact-version.ts
@@ -1,3 +1,5 @@
+import type { LaunchFileSummary } from './deployment-plan.js';
+
 /** Keep the upload number visible: two builds may share a publisher's release tag. */
 export function artifactVersionLabel(
     version: { version: number; release_version?: string | null } | null | undefined,
@@ -10,3 +12,14 @@ export function artifactVersionLabel(
           ? `Unversioned (upload ${version.version})`
           : `v${version.version}`;
 }
+
+export function launchFileVersionLabel(
+    file: Pick<LaunchFileSummary, 'version' | 'releaseVersion' | 'kind'>
+): string {
+    return file.version === null
+        ? 'Generated'
+        : artifactVersionLabel(
+              { version: file.version, release_version: file.releaseVersion },
+              file.kind
+          );
+}
diff --git a/src/lib/deployment-plan.ts b/src/lib/deployment-plan.ts
index 71d9618..498c350 100644
--- a/src/lib/deployment-plan.ts
+++ b/src/lib/deployment-plan.ts
@@ -6,6 +6,8 @@ export interface LaunchFileSummary {
     path: string;
     versionId: number | null;
     version: number | null;
+    /** Missing on snapshots recorded before publisher release versions were retained. */
+    releaseVersion?: string | null;
     sha256: string;
     size: number;
 }
diff --git a/src/lib/server/fleet/launch-recipes.ts b/src/lib/server/fleet/launch-recipes.ts
index 26c32f9..6b3d04e 100644
--- a/src/lib/server/fleet/launch-recipes.ts
+++ b/src/lib/server/fleet/launch-recipes.ts
@@ -171,6 +171,7 @@ function buildRecipe(
         path: script.target_rel_path,
         versionId: version.id,
         version: version.version,
+        releaseVersion: version.release_version,
         sha256: version.sha256,
         size: version.size
     });
@@ -187,6 +188,7 @@ function buildRecipe(
             kind: 'config',
             versionId: null,
             version: null,
+            releaseVersion: null,
             sha256: sha256Buffer(content),
             size: content.length,
             ...(includeContent ? { content: content.toString('base64') } : {})
@@ -249,18 +251,41 @@ export function recipeSummaryForDeployment(
         )
         .get(id) as { recipe_summary: string | null; blueprint_name: string | null } | undefined;
     if (!row) return null;
-    if (row.recipe_summary !== null)
-        return { recipe: JSON.parse(row.recipe_summary), blueprintName: row.blueprint_name };
+    if (row.recipe_summary !== null) {
+        const saved: LaunchRecipeSummary = JSON.parse(row.recipe_summary);
+        const summary = withHistoricalReleaseVersions(saved);
+        if (summary !== saved)
+            db()
+                .prepare(
+                    'UPDATE server_launch_recipes SET recipe_summary = ? WHERE deployment_id = ?'
+                )
+                .run(JSON.stringify(summary), id);
+        return { recipe: summary, blueprintName: row.blueprint_name };
+    }
     // Old snapshots remain readable. Populate on first access, without making
     // controller startup scan and decode every retained plugin in its history.
     const launch = recipeForDeployment(id)!;
-    const summary = summarizeRecipe(launch.recipe);
+    const summary = withHistoricalReleaseVersions(summarizeRecipe(launch.recipe));
     db()
         .prepare('UPDATE server_launch_recipes SET recipe_summary = ? WHERE deployment_id = ?')
         .run(JSON.stringify(summary), id);
     return { recipe: summary, blueprintName: row.blueprint_name };
 }
 
+/** Restore display metadata from the exact retained upload, preserving the captured recipe. */
+function withHistoricalReleaseVersions(summary: LaunchRecipeSummary): LaunchRecipeSummary {
+    const files = summary.files.map((file) => {
+        if (file.releaseVersion !== undefined || file.versionId === null) return file;
+        const version = getVersionMetadata(file.versionId);
+        if (!version || version.version !== file.version || version.sha256 !== file.sha256)
+            return file;
+        return { ...file, releaseVersion: version.release_version };
+    });
+    return files.some((file, index) => file !== summary.files[index])
+        ? { ...summary, files }
+        : summary;
+}
+
 export function recipeForDeployment(
     id: string
 ): { recipe: LaunchRecipePlan; blueprintName: string | null } | null {
diff --git a/src/lib/server/fleet/scripts.ts b/src/lib/server/fleet/scripts.ts
index 21eca18..44728ea 100644
--- a/src/lib/server/fleet/scripts.ts
+++ b/src/lib/server/fleet/scripts.ts
@@ -192,12 +192,17 @@ export function getVersion(id: number): ScriptVersionRow | undefined {
         ScriptVersionRow | undefined;
 }
 
-export type ScriptVersionMetadata = Pick<ScriptVersionRow, 'id' | 'version' | 'sha256' | 'size'>;
+export type ScriptVersionMetadata = Pick<
+    ScriptVersionRow,
+    'id' | 'version' | 'release_version' | 'sha256' | 'size'
+>;
 
 /** Planning a launch never needs to load potentially large script or plugin bytes. */
 export function getVersionMetadata(id: number): ScriptVersionMetadata | undefined {
     return db()
-        .prepare('SELECT id, version, sha256, size FROM script_versions WHERE id = ?')
+        .prepare(
+            'SELECT id, version, release_version, sha256, size FROM script_versions WHERE id = ?'
+        )
         .get(id) as ScriptVersionMetadata | undefined;
 }
 
diff --git a/src/lib/server/provisioning/activation-files.ts b/src/lib/server/provisioning/activation-files.ts
index 09312e5..1904b8a 100644
--- a/src/lib/server/provisioning/activation-files.ts
+++ b/src/lib/server/provisioning/activation-files.ts
@@ -12,7 +12,7 @@ export function applyActivationFiles(
 ): void {
     const changes = db()
         .prepare(
-            `SELECT f.*, ${blobSize('f.content_hash')} AS size, v.version FROM staged_file_changes f
+            `SELECT f.*, ${blobSize('f.content_hash')} AS size, v.version, v.release_version FROM staged_file_changes f
         JOIN provisioning_sources s ON s.kind=f.source_kind AND s.source_id=f.source_id AND s.server=f.server
         LEFT JOIN script_versions v ON v.id=f.script_version_id
         WHERE s.operation_id=? AND f.state='pending' ORDER BY f.id`
@@ -21,6 +21,7 @@ export function applyActivationFiles(
         content_hash: string | null;
         size: number;
         version: number | null;
+        release_version: string | null;
     })[];
     for (const change of changes) {
         assertPublicFileTarget(change.server, change.kind, change.rel_path);
@@ -36,6 +37,7 @@ export function applyActivationFiles(
             path: change.rel_path,
             versionId: change.script_version_id,
             version: change.version,
+            releaseVersion: change.release_version,
             sha256: change.content_hash,
             size: change.size,
             ...(includeContent
diff --git a/src/lib/server/provisioning/move-recipes.ts b/src/lib/server/provisioning/move-recipes.ts
index ecde12a..c89f9e5 100644
--- a/src/lib/server/provisioning/move-recipes.ts
+++ b/src/lib/server/provisioning/move-recipes.ts
@@ -38,11 +38,17 @@ export function captureMoveRecipe(server: string): LaunchRecipePlan {
                 ? undefined
                 : (db()
                       .prepare(
-                          `SELECT v.version,v.kind,s.name
+                          `SELECT v.version,v.release_version,v.kind,s.name
             FROM script_versions v JOIN scripts s ON s.id=v.script_id WHERE v.id=?`
                       )
                       .get(file.script_version_id) as
-                      { version: number; kind: string; name: string } | undefined);
+                      | {
+                            version: number;
+                            release_version: string | null;
+                            kind: string;
+                            name: string;
+                        }
+                      | undefined);
         const kind = version?.kind === 'baseline' ? 'config' : (version?.kind ?? before?.kind);
         if (!['script', 'plugin', 'config'].includes(kind ?? ''))
             throw new Error(`The deployed file type is unavailable for ${file.rel_path}.`);
@@ -59,6 +65,7 @@ export function captureMoveRecipe(server: string): LaunchRecipePlan {
             path: file.rel_path,
             versionId: file.script_version_id,
             version: version?.version ?? null,
+            releaseVersion: version?.release_version ?? null,
             sha256: file.sha256,
             size: file.size
         };
diff --git a/src/lib/server/provisioning/native.ts b/src/lib/server/provisioning/native.ts
index 9a245a0..98fb83c 100644
--- a/src/lib/server/provisioning/native.ts
+++ b/src/lib/server/provisioning/native.ts
@@ -1149,7 +1149,8 @@ function sameLaunchFiles(first: LaunchRecipePlan, second: LaunchRecipePlan): boo
         expectedMap: recipe.expectedMap,
         configFile: recipe.configFile,
         configSource: recipe.configSource,
-        files: recipe.files
+        // Older frozen recipes lack release labels; display metadata does not change a launch.
+        files: recipe.files.map(({ releaseVersion: _releaseVersion, ...file }) => file)
     });
     return JSON.stringify(selected(first)) === JSON.stringify(selected(second));
 }
diff --git a/src/lib/ui/campaigns.ts b/src/lib/ui/campaigns.ts
index 22214f2..6a40bb5 100644
--- a/src/lib/ui/campaigns.ts
+++ b/src/lib/ui/campaigns.ts
@@ -1,15 +1,21 @@
 import { statusPresentation, type StatusTone } from './status.js';
 import { plural } from './plural.js';
+import { artifactVersionLabel } from '../artifact-version.js';
 
 export type CampaignServerGroup = 'attention' | 'processing' | 'queued' | 'complete' | 'inactive';
 
-export interface CampaignSummary {
+interface CampaignScriptSummary {
+    script_name: string | null;
+    script_version: number | null;
+    script_release_version: string | null;
+    script_kind: string | null;
+}
+
+export interface CampaignSummary extends CampaignScriptSummary {
     action: string;
     beta_id: number | null;
     rolled_back_by: string | null;
-    script_name: string | null;
-    script_version: number | null;
-    scripts: { script_name: string | null; script_version: number | null }[];
+    scripts: CampaignScriptSummary[];
     servers: { restart_state: string; server_deleted_at?: string | null }[];
 }
 
@@ -23,8 +29,19 @@ export function campaignTitle(campaign: CampaignSummary): string {
         return `${action} · Beta #${campaign.beta_id}`;
     if (campaign.scripts.length > 1) return `${action} · ${campaign.scripts.length} scripts`;
     const script = campaign.scripts[0] ?? campaign;
-    if (script.script_name)
-        return `${action} · ${script.script_name}${script.script_version !== null ? ` v${script.script_version}` : ''}`;
+    if (script.script_name) {
+        const version =
+            script.script_version === null
+                ? ''
+                : ` ${artifactVersionLabel(
+                      {
+                          version: script.script_version,
+                          release_version: script.script_release_version
+                      },
+                      script.script_kind ?? 'script'
+                  )}`;
+        return `${action} · ${script.script_name}${version}`;
+    }
     return campaign.beta_id ? `${action} · Beta #${campaign.beta_id}` : action;
 }
 
diff --git a/src/lib/ui/components/DeployCollectionDialog.svelte b/src/lib/ui/components/DeployCollectionDialog.svelte
index 9a1efe8..183df3c 100644
--- a/src/lib/ui/components/DeployCollectionDialog.svelte
+++ b/src/lib/ui/components/DeployCollectionDialog.svelte
@@ -15,6 +15,7 @@
     } from '$ui/collection-summary.js';
     import { serverTitle } from '$ui/server-labels.js';
     import { timeFormat } from '$ui/stores/time-zone.js';
+    import { launchFileVersionLabel } from '$lib/artifact-version.js';
     import type { NativeHostSelectionStatus } from '$ui/native-game-files.js';
     import type { NativeDeploymentSelection } from '$lib/hosts.js';
     import type { ZombieGame } from '$lib/map-aliases.js';
@@ -609,9 +610,7 @@
                                     <ul class="file-list">
                                         {#each entry.recipe.files as file}<li>
                                                 <strong>{file.name}</strong><span
-                                                    >{file.version === null
-                                                        ? 'Generated'
-                                                        : `v${file.version}`} · {file.kind}</span
+                                                    >{launchFileVersionLabel(file)} · {file.kind}</span
                                                 ><code>{file.path}</code>
                                             </li>{/each}
                                     </ul>
diff --git a/src/lib/ui/components/DeployServerDialog.svelte b/src/lib/ui/components/DeployServerDialog.svelte
index 0e0ad6b..838b6aa 100644
--- a/src/lib/ui/components/DeployServerDialog.svelte
+++ b/src/lib/ui/components/DeployServerDialog.svelte
@@ -9,6 +9,7 @@
     import { createServerLaunchController, type ServerLaunchState } from '$ui/server-launch.js';
     import { serverTitle } from '$ui/server-labels.js';
     import { timeFormat } from '$ui/stores/time-zone.js';
+    import { launchFileVersionLabel } from '$lib/artifact-version.js';
     import type { NativeHostSelectionStatus } from '$ui/native-game-files.js';
     import type { NativeDeploymentSelection } from '$lib/hosts.js';
     import type { ZombieMapEntry, ZombieGame } from '$lib/map-aliases.js';
@@ -378,7 +379,7 @@
                         {#each preview.recipe.files as file}<li>
                                 <div>
                                     <strong>{file.name}</strong><span
-                                        >{file.version === null ? 'Generated' : `v${file.version}`} ·
+                                        >{launchFileVersionLabel(file)} ·
                                         {file.kind}</span
                                     >
                                 </div>
diff --git a/src/lib/ui/components/LaunchRecipe.svelte b/src/lib/ui/components/LaunchRecipe.svelte
index b0d4da3..72a5c0e 100644
--- a/src/lib/ui/components/LaunchRecipe.svelte
+++ b/src/lib/ui/components/LaunchRecipe.svelte
@@ -1,5 +1,6 @@
 <script lang="ts">
     import RelativeTime from '$ui/components/RelativeTime.svelte';
+    import { launchFileVersionLabel } from '$lib/artifact-version.js';
     import type { LaunchRecipeSummary } from '$lib/deployment-plan.js';
     let { recipe, historical = false }: { recipe: LaunchRecipeSummary; historical?: boolean } =
         $props();
@@ -36,7 +37,7 @@
             {#each recipe.files as file}<li>
                     <div>
                         <strong>{file.name}</strong><span
-                            >{file.version !== null ? `v${file.version}` : 'Generated'} · {file.kind}
+                            >{launchFileVersionLabel(file)} · {file.kind}
                             · {file.size.toLocaleString()} bytes</span
                         >
                     </div>
diff --git a/src/routes/api/campaigns/+server.ts b/src/routes/api/campaigns/+server.ts
index f2ea197..3876d4d 100644
--- a/src/routes/api/campaigns/+server.ts
+++ b/src/routes/api/campaigns/+server.ts
@@ -70,8 +70,9 @@ export async function GET({ url }: { url: URL }) {
         .prepare(
             `SELECT d.id, d.action, d.started_at, d.finished_at, d.triggered_by,
                     d.script_id, d.script_version_id, d.prior_version_id, d.beta_id, d.rolled_back_by,
-                    s.name AS script_name, sv.version AS script_version,
-                    pv.version AS prior_version
+                    s.name AS script_name, s.kind AS script_kind,
+                    sv.version AS script_version, sv.release_version AS script_release_version,
+                    pv.version AS prior_version, pv.release_version AS prior_release_version
              FROM deployments d
              LEFT JOIN scripts s ON s.id = d.script_id
              LEFT JOIN script_versions sv ON sv.id = d.script_version_id
@@ -92,8 +93,11 @@ export async function GET({ url }: { url: URL }) {
         beta_id: number | null;
         rolled_back_by: string | null;
         script_name: string | null;
+        script_kind: string | null;
         script_version: number | null;
+        script_release_version: string | null;
         prior_version: number | null;
+        prior_release_version: string | null;
     }>;
 
     const ids = deployments.map((deployment) => deployment.id);
@@ -126,8 +130,9 @@ export async function GET({ url }: { url: URL }) {
 
     const scriptRows = db()
         .prepare(
-            `SELECT ds.deployment_id, ds.script_id, s.name AS script_name,
-                    sv.version AS script_version, pv.version AS prior_version
+            `SELECT ds.deployment_id, ds.script_id, s.name AS script_name, ds.kind AS script_kind,
+                    sv.version AS script_version, sv.release_version AS script_release_version,
+                    pv.version AS prior_version, pv.release_version AS prior_release_version
              FROM deployment_scripts ds
              LEFT JOIN scripts s ON s.id = ds.script_id
              LEFT JOIN script_versions sv ON sv.id = ds.script_version_id
@@ -138,8 +143,11 @@ export async function GET({ url }: { url: URL }) {
         deployment_id: string;
         script_id: number;
         script_name: string | null;
+        script_kind: string | null;
         script_version: number | null;
+        script_release_version: string | null;
         prior_version: number | null;
+        prior_release_version: string | null;
     }>;
     const scriptsByDep = new Map<string, typeof scriptRows>();
     for (const s of scriptRows) {
diff --git a/src/routes/api/campaigns/[id]/+server.ts b/src/routes/api/campaigns/[id]/+server.ts
index 3f7a899..35ac35d 100644
--- a/src/routes/api/campaigns/[id]/+server.ts
+++ b/src/routes/api/campaigns/[id]/+server.ts
@@ -27,9 +27,9 @@ export async function GET({ params }: { params: { id: string } }) {
 
     const scripts = db()
         .prepare(
-            `SELECT ds.script_id, s.name AS script_name, s.target_rel_path,
-                    ds.script_version_id, sv.version AS script_version,
-                    ds.prior_version_id, pv.version AS prior_version
+            `SELECT ds.script_id, s.name AS script_name, s.target_rel_path, ds.kind AS script_kind,
+                    ds.script_version_id, sv.version AS script_version, sv.release_version AS script_release_version,
+                    ds.prior_version_id, pv.version AS prior_version, pv.release_version AS prior_release_version
              FROM deployment_scripts ds
              LEFT JOIN scripts s ON s.id = ds.script_id
              LEFT JOIN script_versions sv ON sv.id = ds.script_version_id
diff --git a/src/routes/api/deployments/[id]/+server.ts b/src/routes/api/deployments/[id]/+server.ts
index 24d9eb2..56d9dda 100644
--- a/src/routes/api/deployments/[id]/+server.ts
+++ b/src/routes/api/deployments/[id]/+server.ts
@@ -31,9 +31,9 @@ export async function GET({ params, url }: { params: { id: string }; url?: URL }
 
     const scripts = db()
         .prepare(
-            `SELECT ds.script_id, s.name AS script_name, s.target_rel_path,
-                    ds.script_version_id, sv.version AS script_version,
-                    ds.prior_version_id, pv.version AS prior_version
+            `SELECT ds.script_id, s.name AS script_name, s.target_rel_path, ds.kind AS script_kind,
+                    ds.script_version_id, sv.version AS script_version, sv.release_version AS script_release_version,
+                    ds.prior_version_id, pv.version AS prior_version, pv.release_version AS prior_release_version
              FROM deployment_scripts ds
              LEFT JOIN scripts s ON s.id = ds.script_id
              LEFT JOIN script_versions sv ON sv.id = ds.script_version_id
diff --git a/tests/unit/campaign-list.test.ts b/tests/unit/campaign-list.test.ts
index 3cf4374..0e97f2f 100644
--- a/tests/unit/campaign-list.test.ts
+++ b/tests/unit/campaign-list.test.ts
@@ -1,6 +1,10 @@
 import { afterEach, beforeEach, expect, it, vi } from 'vitest';
 import { newFixture, type Fixture } from '../helpers/fixture.js';
-import { campaignOutcome, type CampaignSummary } from '../../src/lib/ui/campaigns.js';
+import {
+    campaignOutcome,
+    campaignTitle,
+    type CampaignSummary
+} from '../../src/lib/ui/campaigns.js';
 
 let fixture: Fixture;
 beforeEach(async () => {
@@ -61,6 +65,48 @@ it('searches script names, campaign IDs and friendly server names across all ret
     expect((await get('q=not-found')).total).toBe(0);
 });
 
+it('exposes release versions for campaign titles and both campaign detail endpoints', async () => {
+    const { handle, get, add } = await setup();
+    add('aggregate-script', ['done']);
+    add('legacy-script', ['done']);
+    add('config', ['done']);
+    handle.exec(`
+        INSERT INTO scripts(id,name,target_rel_path,kind)
+            VALUES(1,'Double Tap','double.gsc','script'),(2,'Server settings','settings.cfg','config');
+        INSERT INTO script_versions(id,script_id,version,release_version,kind,sha256,size)
+            VALUES(1,1,2,'1.3.0','script','old',0),(2,1,11,'2.4.1','script','new',0),
+                  (3,2,4,NULL,'config','settings',0);
+        INSERT INTO deployment_scripts(deployment_id,script_id,script_version_id,prior_version_id,kind)
+            VALUES('aggregate-script',1,2,1,'script'),('config',2,3,NULL,'config');
+        UPDATE deployments SET script_id=1,script_version_id=2,prior_version_id=1 WHERE id='legacy-script';
+    `);
+    const { deployments } = await get();
+    const versions = {
+        script_kind: 'script',
+        script_version: 11,
+        script_release_version: '2.4.1',
+        prior_version: 2,
+        prior_release_version: '1.3.0'
+    };
+    const aggregate = deployments.find((row) => row.id === 'aggregate-script')!;
+    const legacy = deployments.find((row) => row.id === 'legacy-script')!;
+    expect(aggregate.scripts).toEqual([expect.objectContaining(versions)]);
+    expect(legacy).toMatchObject(versions);
+    expect(campaignTitle(aggregate)).toBe('Promote · Double Tap 2.4.1 (upload 11)');
+    expect(campaignTitle(legacy)).toBe('Promote · Double Tap 2.4.1 (upload 11)');
+    expect(campaignTitle(deployments.find((row) => row.id === 'config')!)).toBe(
+        'Promote · Server settings v4'
+    );
+
+    const { GET: campaignDetail } = await import('../../src/routes/api/campaigns/[id]/+server.js');
+    const { GET: deploymentDetail } =
+        await import('../../src/routes/api/deployments/[id]/+server.js');
+    for (const detail of [campaignDetail, deploymentDetail]) {
+        const response = await (await detail({ params: { id: 'aggregate-script' } })).json();
+        expect(response.scripts).toEqual([expect.objectContaining(versions)]);
+    }
+});
+
 it('keeps API status filters and active/history partitions consistent with displayed outcomes', async () => {
     const { handle, get, add } = await setup();
     add('complete', ['done']);
diff --git a/tests/unit/launch-recipe-summary-migration.test.ts b/tests/unit/launch-recipe-summary-migration.test.ts
index 97d1d27..f7d6f81 100644
--- a/tests/unit/launch-recipe-summary-migration.test.ts
+++ b/tests/unit/launch-recipe-summary-migration.test.ts
@@ -15,6 +15,95 @@ afterEach(async () => {
 });
 
 describe('persisted launch recipe summaries', () => {
+    it.each([false, true])(
+        'restores exact historical release labels with cached summary=%s without rewriting the recipe',
+        async (cached) => {
+            const { db } = await import('../../src/lib/server/db/index.js');
+            const { createScript, uploadNewVersion } =
+                await import('../../src/lib/server/fleet/scripts.js');
+            const {
+                captureRecipe,
+                summarizeRecipe,
+                recipeSummaryForDeployment,
+                recipeForDeployment
+            } = await import('../../src/lib/server/fleet/launch-recipes.js');
+            const saved = createScript({
+                name: 'Historical script',
+                scopeType: 'game',
+                scopeValue: 't5',
+                targetRelPath: 'history.gsc',
+                content: Buffer.from('historical bytes'),
+                releaseVersion: '2.3.4'
+            });
+            db()
+                .prepare('UPDATE scripts SET current_version_id = ? WHERE id = ?')
+                .run(saved.version.id, saved.script.id);
+            const recipe = captureRecipe('t5', 'theater');
+            const original = recipe.files[0];
+            delete original.releaseVersion;
+            const unversioned = createScript({
+                name: 'Legacy script',
+                targetRelPath: 'legacy.gsc',
+                content: Buffer.from('historical bytes'),
+                releaseVersion: '1.0.0'
+            });
+            db()
+                .prepare('UPDATE script_versions SET release_version = NULL WHERE id = ?')
+                .run(unversioned.version.id);
+            recipe.files.push(
+                { ...original, path: 'recorded.gsc', releaseVersion: '1.8.0' },
+                { ...original, path: 'legacy.gsc', versionId: unversioned.version.id },
+                { ...original, path: 'missing.gsc', versionId: 9999 },
+                { ...original, path: 'mismatched.gsc', sha256: 'different' }
+            );
+            const latest = uploadNewVersion(
+                saved.script.id,
+                Buffer.from('newer bytes'),
+                undefined,
+                '9.0.0'
+            );
+            db()
+                .prepare('UPDATE scripts SET current_version_id = ? WHERE id = ?')
+                .run(latest.id, saved.script.id);
+            const encoded = JSON.stringify(recipe);
+            const summary = summarizeRecipe(recipe);
+            db()
+                .exec(`INSERT INTO server_deployments(id,server,action,state,stage,started_at,triggered_by)
+                VALUES('historical','retired-server','create','done','Complete','2025-01-01','fixture')`);
+            db()
+                .prepare(
+                    'INSERT INTO server_launch_recipes(deployment_id,recipe,recipe_summary) VALUES(?,?,?)'
+                )
+                .run('historical', encoded, cached ? JSON.stringify(summary) : null);
+
+            const restored = recipeSummaryForDeployment('historical')!.recipe;
+            expect(restored.fingerprint).toBe(summary.fingerprint);
+            expect(restored.files.find((file) => file.path === 'history.gsc')).toMatchObject({
+                version: 1,
+                releaseVersion: '2.3.4'
+            });
+            expect(
+                restored.files.find((file) => file.path === 'recorded.gsc')!.releaseVersion
+            ).toBe('1.8.0');
+            expect(
+                restored.files.find((file) => file.path === 'legacy.gsc')!.releaseVersion
+            ).toBeNull();
+            for (const path of ['missing.gsc', 'mismatched.gsc'])
+                expect(restored.files.find((file) => file.path === path)).not.toHaveProperty(
+                    'releaseVersion'
+                );
+            expect(recipeSummaryForDeployment('historical')!.recipe).toEqual(restored);
+            expect(recipeForDeployment('historical')!.recipe).toEqual(recipe);
+            const stored = db()
+                .prepare(
+                    'SELECT recipe,recipe_summary FROM server_launch_recipes WHERE deployment_id = ?'
+                )
+                .get('historical') as { recipe: string; recipe_summary: string };
+            expect(stored.recipe).toBe(encoded);
+            expect(JSON.parse(stored.recipe_summary)).toEqual(restored);
+        }
+    );
+
     it('lazily upgrades legacy snapshots once without changing fingerprints or retained bytes', async () => {
         const recipe: LaunchRecipe = {
             format: 1,
diff --git a/tests/unit/launch-recipes.test.ts b/tests/unit/launch-recipes.test.ts
index 03bd158..02e7d95 100644
--- a/tests/unit/launch-recipes.test.ts
+++ b/tests/unit/launch-recipes.test.ts
@@ -82,12 +82,62 @@ describe('launch recipes and previews', () => {
         expect(second.name).toBe(first.name);
         expect(second.port).toBe(first.port);
         expect(first.recipe.files).toHaveLength(3);
+        expect(first.recipe.files[0]).toMatchObject({ version: 1, releaseVersion: '1.0.0' });
         expect(first.recipe.files[0]).not.toHaveProperty('content');
         expect(db().prepare('SELECT * FROM server_keys').all()).toEqual([]);
         expect(db().prepare('SELECT * FROM server_creation_jobs').all()).toEqual([]);
         expect(JSON.stringify(first)).not.toContain('private-');
     });
 
+    it('retains the selected script and plugin release in both planned and captured files', async () => {
+        const { script } = await seedArtifacts();
+        const { createScript, uploadNewVersion } =
+            await import('../../src/lib/server/fleet/scripts.js');
+        const { captureRecipe, captureRecipePlan } =
+            await import('../../src/lib/server/fleet/launch-recipes.js');
+        const { db } = await import('../../src/lib/server/db/index.js');
+        const selected = uploadNewVersion(
+            script.script.id,
+            Buffer.from('updated perks'),
+            undefined,
+            '2.3.4'
+        );
+        const plugin = createScript({
+            name: 'Native perks',
+            kind: 'plugin',
+            scopeType: 'game',
+            scopeValue: 't5',
+            targetRelPath: 'perks.dll',
+            content: Buffer.from('plugin'),
+            releaseVersion: 'v4.5.6'
+        });
+        for (const [id, versionId] of [
+            [script.script.id, selected.id],
+            [plugin.script.id, plugin.version.id]
+        ])
+            db()
+                .prepare('UPDATE scripts SET current_version_id = ? WHERE id = ?')
+                .run(versionId, id);
+        for (const capture of [captureRecipePlan, captureRecipe]) {
+            const recipe = capture('t5', 'theater');
+            expect(recipe.files).toEqual(
+                expect.arrayContaining([
+                    expect.objectContaining({
+                        path: 'perks.gsc',
+                        version: 2,
+                        releaseVersion: '2.3.4'
+                    }),
+                    expect.objectContaining({
+                        path: 'perks.dll',
+                        version: 1,
+                        releaseVersion: 'v4.5.6'
+                    }),
+                    expect.objectContaining({ kind: 'config', version: null, releaseVersion: null })
+                ])
+            );
+        }
+    });
+
     it('returns the same operation for repeated submission, even after expiry and restart', async () => {
         const { previewCreation, queueCreateServer } =
             await import('../../src/lib/server/fleet/create.js');
diff --git a/tests/unit/native-provisioning.test.ts b/tests/unit/native-provisioning.test.ts
index 22f89e6..f8e5801 100644
--- a/tests/unit/native-provisioning.test.ts
+++ b/tests/unit/native-provisioning.test.ts
@@ -174,7 +174,7 @@ async function moveTarget() {
 }
 
 describe('rebalance instance migrations', () => {
-    it('preserves deployed configuration, patched file versions, identity and credentials on an active source', async () => {
+    it.each(['current', 'legacy'])('preserves deployed files (%s)', async (recipeFormat) => {
         const { config } = await import('../../src/lib/server/config.js');
         Object.assign(config.rcon, { password: '' });
         const { createScript, uploadNewVersion } =
@@ -196,7 +196,16 @@ describe('rebalance instance migrations', () => {
             scopeValue: 't5',
             content: Buffer.from('original deployed script')
         });
-        for (const artifact of [baseline, script])
+        const plugin = createScript({
+            releaseVersion: 'v2.4.0',
+            name: 'Deployed plugin',
+            kind: 'plugin',
+            targetRelPath: 'preserved.dll',
+            scopeType: 'game',
+            scopeValue: 't5',
+            content: Buffer.from('deployed plugin')
+        });
+        for (const artifact of [baseline, script, plugin])
             db()
                 .prepare('UPDATE scripts SET current_version_id=? WHERE id=?')
                 .run(artifact.version.id, artifact.script.id);
@@ -243,10 +252,36 @@ describe('rebalance instance migrations', () => {
         const original = nativeInstance(job.name)!;
         const recipe = captureMoveRecipe(job.name);
         expect(recipe.files.every((file) => file.content === undefined)).toBe(true);
+        expect(recipe.files.find((file) => file.path === 'preserved.gsc')).toMatchObject({
+            versionId: patched.id,
+            version: patched.version,
+            releaseVersion: '1.0.1'
+        });
+        expect(recipe.files.find((file) => file.path === 'preserved.dll')).toMatchObject({
+            versionId: plugin.version.id,
+            releaseVersion: 'v2.4.0'
+        });
         const id = requestInstanceMove(job.name, target.id, {
             triggeredBy: 'rebalance:test',
             recipe
         });
+        if (recipeFormat === 'legacy') {
+            const stored = db()
+                .prepare(
+                    'SELECT recipe, recipe_summary FROM server_launch_recipes WHERE deployment_id=?'
+                )
+                .get(id) as { recipe: string; recipe_summary: string };
+            const legacy = (encoded: string) => {
+                const value = JSON.parse(encoded);
+                for (const file of value.files) delete file.releaseVersion;
+                return JSON.stringify(value);
+            };
+            db()
+                .prepare(
+                    'UPDATE server_launch_recipes SET recipe=?,recipe_summary=? WHERE deployment_id=?'
+                )
+                .run(legacy(stored.recipe), legacy(stored.recipe_summary), id);
+        }
         await advance();
         const removal = hostMigration(id)!.remove_operation_id!;
         expect(removal).toBeTruthy();
@@ -304,7 +339,14 @@ describe('rebalance instance migrations', () => {
             generation: 2
         });
         expect(getHost(hostId)?.mode).toBe('active');
-        expect(JSON.stringify(getDeployment(id)?.recipe)).not.toContain(launch.rconPassword);
+        const displayedRecipe = getDeployment(id)?.recipe;
+        expect(displayedRecipe?.files.find((file) => file.path === 'preserved.gsc')).toMatchObject({
+            releaseVersion: '1.0.1'
+        });
+        expect(displayedRecipe?.files.find((file) => file.path === 'preserved.dll')).toMatchObject({
+            releaseVersion: 'v2.4.0'
+        });
+        expect(JSON.stringify(displayedRecipe)).not.toContain(launch.rconPassword);
     });
 
     it('rechecks occupancy, target capacity and run admission before removing the source', async () => {
@@ -1773,17 +1815,21 @@ describe('native instance provisioning', () => {
         expect(getHost(hostId)?.mode).toBe('active');
     });
     it('builds campaign replacements with requested plugins, configuration, additions and removals', async () => {
-        const { createScript } = await import('../../src/lib/server/fleet/scripts.js');
+        const { createScript, uploadNewVersion } =
+            await import('../../src/lib/server/fleet/scripts.js');
         const { db } = await import('../../src/lib/server/db/index.js');
+        let replacementPluginId = 0;
         for (const path of ['replace.dll', 'remove.dll']) {
             const file = createScript({
                 name: path,
                 kind: 'plugin',
+                releaseVersion: 'v2.0.0',
                 targetRelPath: path,
                 scopeType: 'game',
                 scopeValue: 't5',
                 content: Buffer.from('promoted plugin')
             });
+            if (path === 'replace.dll') replacementPluginId = file.script.id;
             db()
                 .prepare('UPDATE scripts SET current_version_id=? WHERE id=?')
                 .run(file.version.id, file.script.id);
@@ -1791,6 +1837,21 @@ describe('native instance provisioning', () => {
         const job = await queue();
         await advance();
         await acknowledge(job.deploymentId);
+        const replacement = uploadNewVersion(
+            replacementPluginId,
+            Buffer.from('requested plugin'),
+            undefined,
+            'v2.1.0'
+        );
+        const addition = createScript({
+            name: 'New script',
+            kind: 'script',
+            releaseVersion: '3.2.1',
+            targetRelPath: 'new.gsc',
+            scopeType: 'game',
+            scopeValue: 't5',
+            content: Buffer.from('new script')
+        });
         db()
             .prepare(
                 "INSERT INTO deployments(id,action,started_at) VALUES('files-rebuild','promote',?)"
@@ -1803,9 +1864,19 @@ describe('native instance provisioning', () => {
             .run(job.name);
         const { queueFileChange } = await import('../../src/lib/server/fleet/staged-files.js');
         const changes = [
-            { kind: 'plugin', relPath: 'replace.dll', content: Buffer.from('requested plugin') },
+            {
+                kind: 'plugin',
+                relPath: 'replace.dll',
+                content: Buffer.from('requested plugin'),
+                scriptVersionId: replacement.id
+            },
             { kind: 'plugin', relPath: 'remove.dll', content: null },
-            { kind: 'script', relPath: 'new.gsc', content: Buffer.from('new script') },
+            {
+                kind: 'script',
+                relPath: 'new.gsc',
+                content: Buffer.from('new script'),
+                scriptVersionId: addition.version.id
+            },
             { kind: 'config', relPath: 'custom.cfg', content: Buffer.from('set custom 1') }
         ] as const;
         for (const change of changes)
@@ -1839,6 +1910,21 @@ describe('native instance provisioning', () => {
             if (change.content === null) expect(actual).toBeUndefined();
             else expect(Buffer.from(actual!.content!, 'base64')).toEqual(change.content);
         }
+        expect(recipe.files.find((file) => file.path === 'replace.dll')).toMatchObject({
+            versionId: replacement.id,
+            version: replacement.version,
+            releaseVersion: 'v2.1.0'
+        });
+        expect(recipe.files.find((file) => file.path === 'new.gsc')).toMatchObject({
+            versionId: addition.version.id,
+            version: addition.version.version,
+            releaseVersion: '3.2.1'
+        });
+        expect(recipe.files.find((file) => file.path === 'custom.cfg')).toMatchObject({
+            versionId: null,
+            version: null,
+            releaseVersion: null
+        });
         const files = getHostOperation(staged.stage_operation_id)!.payload.files as Array<{
             id: number;
             path: string;
diff --git a/tests/unit/ui-campaigns.test.ts b/tests/unit/ui-campaigns.test.ts
index 19cc3b0..d9dcb16 100644
--- a/tests/unit/ui-campaigns.test.ts
+++ b/tests/unit/ui-campaigns.test.ts
@@ -15,13 +15,25 @@ it('names campaigns with their script or beta and gives maintenance a readable t
         rolled_back_by: null,
         script_name: null,
         script_version: null,
+        script_release_version: null,
+        script_kind: null,
         scripts: [],
         servers: []
     };
     expect(campaignTitle(campaign)).toBe('Promote · Beta #74');
     expect(
-        campaignTitle({ ...campaign, scripts: [{ script_name: 'Double Tap', script_version: 2 }] })
-    ).toBe('Promote · Double Tap v2');
+        campaignTitle({
+            ...campaign,
+            scripts: [
+                {
+                    script_name: 'Double Tap',
+                    script_version: 2,
+                    script_release_version: '1.3.0',
+                    script_kind: 'script'
+                }
+            ]
+        })
+    ).toBe('Promote · Double Tap 1.3.0 (upload 2)');
     expect(
         campaignTitle({
             ...campaign,
@@ -32,6 +44,38 @@ it('names campaigns with their script or beta and gives maintenance a readable t
     expect(campaignTitle({ ...campaign, action: 'drift' })).toBe('Maintenance repair');
 });
 
+it('uses release labels for legacy campaigns and preserves config version labels', () => {
+    const campaign = {
+        action: 'promote',
+        beta_id: null,
+        rolled_back_by: null,
+        script_name: 'Double Tap',
+        script_version: 11,
+        script_release_version: '2.4.1',
+        script_kind: 'script',
+        scripts: [],
+        servers: []
+    };
+    expect(campaignTitle(campaign)).toBe('Promote · Double Tap 2.4.1 (upload 11)');
+    expect(campaignTitle({ ...campaign, script_release_version: null })).toBe(
+        'Promote · Double Tap Unversioned (upload 11)'
+    );
+    expect(campaignTitle({ ...campaign, script_version: null })).toBe('Promote · Double Tap');
+    expect(
+        campaignTitle({
+            ...campaign,
+            scripts: [
+                {
+                    script_name: 'Server settings',
+                    script_version: 4,
+                    script_release_version: null,
+                    script_kind: 'config'
+                }
+            ]
+        })
+    ).toBe('Promote · Server settings v4');
+});
+
 it('summarizes progress without letting deleted servers create false alarms or false completion', () => {
     const campaign = {
         rolled_back_by: null,
diff --git a/tests/unit/ui-launch-recipe.test.ts b/tests/unit/ui-launch-recipe.test.ts
new file mode 100644
index 0000000..bc5f6e3
--- /dev/null
+++ b/tests/unit/ui-launch-recipe.test.ts
@@ -0,0 +1,50 @@
+import { expect, it } from 'vitest';
+import { render } from 'svelte/server';
+import LaunchRecipe from '../../src/lib/ui/components/LaunchRecipe.svelte';
+import type { LaunchFileSummary, LaunchRecipeSummary } from '../../src/lib/deployment-plan.js';
+
+const file = (overrides: Partial<LaunchFileSummary>): LaunchFileSummary => ({
+    name: 'Script',
+    kind: 'script',
+    path: 'script.gsc',
+    versionId: 20,
+    version: 11,
+    sha256: 'a'.repeat(64),
+    size: 1200,
+    ...overrides
+});
+const recipe: LaunchRecipeSummary = {
+    game: 't5',
+    mapSlug: 'theater',
+    mapName: 'Kino der Toten',
+    expectedMap: 'zombie_theater',
+    capturedAt: '2026-10-17T12:00:00Z',
+    image: 'runtime:latest',
+    configFile: 'dedicated_sp.cfg',
+    configSource: 'Production',
+    fingerprint: 'b'.repeat(64),
+    files: [
+        file({ releaseVersion: '1.2.3' }),
+        file({ kind: 'plugin', releaseVersion: 'v3.1.0' }),
+        file({ version: 2 }),
+        file({ kind: 'config', version: 3 }),
+        file({ kind: 'config', versionId: null, version: null })
+    ]
+};
+
+it.each([false, true])(
+    'shows release versions and preserves legacy/generated labels in historical=%s launch files',
+    (historical) => {
+        const body = render(LaunchRecipe, { props: { recipe, historical } }).body.replace(
+            /\s+/g,
+            ' '
+        );
+        expect(body).toContain('1.2.3 (upload 11) · script');
+        expect(body).toContain('v3.1.0 (upload 11) · plugin');
+        expect(body).toContain('Unversioned (upload 2) · script');
+        expect(body).toContain('v3 · config');
+        expect(body).toContain('Generated · config');
+        expect(body).not.toContain('v11 ·');
+        expect(body).not.toContain('v2 ·');
+    }
+);