From 42ea0e91f95712060c1f38b8297be35ff20ea3cf Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Thu, 12 Nov 2026 14:52:46 +1100 Subject: [PATCH 1/2] build: update all plugins to LANCommander beta.4 Use published beta.4 server contracts and pin launcher source to the released commit. Adapt primary-action selection and generated manifests to ActionType while preserving existing safety checks and component versions. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .github/skills/plugin-release/SKILL.md | 2 +- Directory.Packages.props | 2 +- RELEASES.md | 17 ++++++------ eng/Build-Plugin.ps1 | 4 +-- eng/Test-GitHubPackages.ps1 | 2 +- eng/Test-NuGetPublication.ps1 | 2 +- eng/Test-ReleaseSelection.ps1 | 8 +++--- eng/Validate-Plugin.ps1 | 2 +- eng/lancommander-source.json | 4 +-- eng/plugins.json | 14 +++++----- plugins/Launcher.MQTT/CHANGELOG.md | 7 +++++ plugins/Launcher.MQTT/README.md | 26 +++++++++---------- plugins/Launcher.MQTT/examples/TEST-GUIDE.md | 6 ++--- .../HomeAssistantLauncherPlugin.cs | 4 +-- ...nder.Community.Launcher.MQTT.Plugin.csproj | 2 +- .../LANCommanderGameLaunchHost.cs | 17 ++++++++---- ...nity.Launcher.MQTT.HostLoader.Tests.csproj | 2 +- .../PluginLoadContextTests.cs | 6 ++--- .../PluginPackageTests.cs | 9 ++++--- .../PluginSettingsTests.cs | 18 +++++++++++++ plugins/Server.Mcp/CHANGELOG.md | 2 ++ plugins/Server.Mcp/README.md | 2 +- .../McpPlugin.cs | 2 +- .../McpHttpTests.cs | 2 +- plugins/Server.Quake3/CHANGELOG.md | 5 ++++ .../Server.Quake3/Directory.Packages.props | 2 +- .../PackageLoaderTests.cs | 2 +- .../Quake3Plugin.cs | 2 +- plugins/Server.Quake3/README.md | 10 +++---- plugins/Server.RecompCatalog/CHANGELOG.md | 6 +++++ .../LcxPackageBuilder.cs | 2 +- .../RecompCatalogPlugin.cs | 2 +- .../HostContractTests.cs | 2 +- .../LcxPackageBuilderTests.cs | 1 + plugins/Server.RecompCatalog/README.md | 6 ++--- 35 files changed, 123 insertions(+), 79 deletions(-) diff --git a/.github/skills/plugin-release/SKILL.md b/.github/skills/plugin-release/SKILL.md index d7b00d2..aad580d 100644 --- a/.github/skills/plugin-release/SKILL.md +++ b/.github/skills/plugin-release/SKILL.md @@ -35,7 +35,7 @@ and retry guarantees. Do not copy its changing component table here. authorization. 6. Launcher.MQTT now builds a real NuGet payload, declares the launcher-specific package type, and uses the same feed jobs as server plugins. Preserve its - pinned beta.3 host contracts, private-dependency inventory and extracted + pinned beta.4 host contracts, private-dependency inventory and extracted package install/loader tests. Follow its README's existing-ZIP upgrade preparation: the host updater preserves only `Data`, not root settings or discovery journals. Never replace the published 0.2.0 ZIP/tag. diff --git a/Directory.Packages.props b/Directory.Packages.props index 9703e0a..e0cbbb1 100644 --- a/Directory.Packages.props +++ b/Directory.Packages.props @@ -1,7 +1,7 @@ true - 2.2.0-beta.3 + 2.2.0-beta.4 diff --git a/RELEASES.md b/RELEASES.md index ff4fb0e..611620c 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -29,10 +29,10 @@ replace a published release asset; choose a new version and matching changelog entry for subsequent changes. Values in the files alone do not mean a version has been published. -All current components target LANCommander `2.2.0-beta.3`. Server components +All current components target LANCommander `2.2.0-beta.4`. Server components use the matching published NuGet packages. Launcher.MQTT is source-coupled to the host and uses the pinned source snapshot in `eng/lancommander-source.json` -(commit `9eefa639a904059c0a03f39e7908332f468828af`). Do not substitute a +(commit `675befe0673c03aded2b45995694661ce454ba95`). Do not substitute a mutable checkout or invent package adapters for unavailable host contracts. ## Prerequisites and validation @@ -225,13 +225,12 @@ preserved by the host updater. Discovery metadata does not establish installability. LANCommander inspects the single plugin assembly under `lib/` for its `[LANCommanderPlugin]` metadata, including `Hosts` and host-version bounds. -The launcher installer was rechecked against current upstream main -[`123ec53`](https://github.com/LANCommander/LANCommander/commit/123ec53a5dd177c2124001ad9f0ce9cb1a6e8acc) -and the released beta.3 source -[`9eefa63`](https://github.com/LANCommander/LANCommander/commit/9eefa639a904059c0a03f39e7908332f468828af). -The beta.3 reader/staging/launcher installer contracts are unchanged in that -comparison; no unverified host upgrade is needed. The launcher remains bounded -to beta.3 until another host version is explicitly validated. +The launcher installer and loader are validated against the released beta.4 source +[`675befe`](https://github.com/LANCommander/LANCommander/commit/675befe0673c03aded2b45995694661ce454ba95). +Its package reader/staging contracts still preserve only `Data`. The launcher +remains bounded to beta.4 until another host version is explicitly validated. +Beta.4 replaces the primary-action flag with `ActionType.Primary`; the MQTT +adapter uses that discriminator while retaining the exactly-one-primary guard. Earlier upstream discovery research was pinned at commit [`38f162d`](https://github.com/LANCommander/LANCommander/commit/38f162ddeb2a3db1388cb898c4e6b20c4f4bf95d): [`PluginPackageTypes.cs`](https://github.com/LANCommander/LANCommander/blob/38f162ddeb2a3db1388cb898c4e6b20c4f4bf95d/LANCommander.SDK/Plugins/PluginPackageTypes.cs), diff --git a/eng/Build-Plugin.ps1 b/eng/Build-Plugin.ps1 index 55da8b9..6f5c6a3 100644 --- a/eng/Build-Plugin.ps1 +++ b/eng/Build-Plugin.ps1 @@ -32,7 +32,7 @@ if ($Plugin -eq 'Launcher.MQTT') { [IO.Path]::GetFullPath($env:LANCOMMANDER_SOURCE_ROOT) } else { - Join-Path $repositoryRoot '.cache/lancommander-beta3' + Join-Path $repositoryRoot '.cache/lancommander-beta4' } & (Join-Path $PSScriptRoot 'Prepare-LANCommanderSource.ps1') -Destination $hostSource | Out-Null $sourcePin = Get-Content -LiteralPath (Join-Path $PSScriptRoot 'lancommander-source.json') -Raw | ConvertFrom-Json @@ -88,7 +88,7 @@ $manifest = [ordered]@{ host = $component.host minimumHostVersion = $component.minimumHostVersion maximumHostVersion = $component.maximumHostVersion - lanCommanderPackageVersion = if ($component.hostPackageVersion) { $component.hostPackageVersion } else { '2.2.0-beta.3' } + lanCommanderPackageVersion = if ($component.hostPackageVersion) { $component.hostPackageVersion } else { '2.2.0-beta.4' } lanCommanderSourceCommit = if ($Plugin -eq 'Launcher.MQTT') { $sourcePin.commit } elseif ($component.hostSourceCommit) { $component.hostSourceCommit } else { $null } artifactFormat = $component.artifactFormat asset = Split-Path -Leaf $asset diff --git a/eng/Test-GitHubPackages.ps1 b/eng/Test-GitHubPackages.ps1 index 1b33265..b1697a5 100644 --- a/eng/Test-GitHubPackages.ps1 +++ b/eng/Test-GitHubPackages.ps1 @@ -164,7 +164,7 @@ try { component = 'Server.Mcp' version = '0.2.1' host = 'Server' - minimumHostVersion = '2.2.0-beta.3' + minimumHostVersion = '2.2.0-beta.4' maximumHostVersion = $null artifactFormat = 'nupkg' asset = $packageName diff --git a/eng/Test-NuGetPublication.ps1 b/eng/Test-NuGetPublication.ps1 index e39f4cf..84f7556 100644 --- a/eng/Test-NuGetPublication.ps1 +++ b/eng/Test-NuGetPublication.ps1 @@ -113,7 +113,7 @@ function New-TestArtifact { component = 'Server.Mcp' version = $PackageVersion host = 'Server' - minimumHostVersion = '2.2.0-beta.3' + minimumHostVersion = '2.2.0-beta.4' maximumHostVersion = $null artifactFormat = 'nupkg' asset = $assetName diff --git a/eng/Test-ReleaseSelection.ps1 b/eng/Test-ReleaseSelection.ps1 index 86bff54..4e4c3b3 100644 --- a/eng/Test-ReleaseSelection.ps1 +++ b/eng/Test-ReleaseSelection.ps1 @@ -34,13 +34,13 @@ Assert-Equal @('0.2.1', '0.4.2', '0.2.1') @($batch | ForEach-Object version) 'In $all = @(Resolve-PluginSelection -Plugins @('Server.Mcp', 'Server.RecompCatalog', 'Launcher.MQTT', 'Server.Quake3')) Assert-Equal @('0.2.1', '0.4.2', '0.2.1', '0.1.0-alpha.1') @($all | ForEach-Object version) 'Four-component independent versions' $quakeMetadata = @(Get-PluginRegistry | Where-Object key -CEQ 'Server.Quake3')[0] -Assert-Equal '2.2.0-beta.3' $quakeMetadata.minimumHostVersion 'Published Quake host API baseline' -Assert-Equal '2.2.0-beta.3' $quakeMetadata.hostPackageVersion 'Quake package host baseline' +Assert-Equal '2.2.0-beta.4' $quakeMetadata.minimumHostVersion 'Published Quake host API baseline' +Assert-Equal '2.2.0-beta.4' $quakeMetadata.hostPackageVersion 'Quake package host baseline' $repositoryRoot = Split-Path $PSScriptRoot -Parent [xml] $packageVersions = Get-Content -LiteralPath (Join-Path $repositoryRoot 'Directory.Packages.props') -Raw $hostVersion = $packageVersions.Project.PropertyGroup.LANCommanderPackageVersion -Assert-Equal '2.2.0-beta.3' $hostVersion 'Shared published host package baseline' +Assert-Equal '2.2.0-beta.4' $hostVersion 'Shared published host package baseline' foreach ($component in @(Get-PluginRegistry)) { Assert-Equal $hostVersion $component.minimumHostVersion "$($component.key) minimum host baseline" if ($component.hostPackageVersion) { @@ -53,7 +53,7 @@ Assert-Equal @('LANCommander.Plugin', 'LANCommander.Plugin.Launcher') @($launche Assert-Equal $hostVersion $launcherMetadata.maximumHostVersion 'Exact launcher host compatibility' $sourcePin = Get-Content -LiteralPath (Join-Path $PSScriptRoot 'lancommander-source.json') -Raw | ConvertFrom-Json Assert-Equal "v$hostVersion" $sourcePin.tag 'Launcher source tag matches package baseline' -Assert-Equal '9eefa639a904059c0a03f39e7908332f468828af' $sourcePin.commit 'Released beta.3 launcher source' +Assert-Equal '675befe0673c03aded2b45995694661ce454ba95' $sourcePin.commit 'Released beta.4 launcher source' foreach ($version in @('1.2.3', '0.3.0-beta.1', '1.2.3-rc.2+build.7')) { if (-not (Test-PluginSemVer $version)) { throw "Valid SemVer was rejected: $version" } diff --git a/eng/Validate-Plugin.ps1 b/eng/Validate-Plugin.ps1 index ee2bf7b..6c90f49 100644 --- a/eng/Validate-Plugin.ps1 +++ b/eng/Validate-Plugin.ps1 @@ -17,7 +17,7 @@ $packageOutput = if ($OutputDirectory) { $OutputDirectory } else { } if ($Plugin -eq 'Launcher.MQTT') { - $hostSource = Join-Path $repositoryRoot '.cache/lancommander-beta3' + $hostSource = Join-Path $repositoryRoot '.cache/lancommander-beta4' & (Join-Path $PSScriptRoot 'Prepare-LANCommanderSource.ps1') -Destination $hostSource | Out-Null $env:LANCOMMANDER_SOURCE_ROOT = $hostSource $env:LANCOMMANDER_MQTT_PLUGIN_PATH = Join-Path $repositoryRoot 'plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/bin/Release/net10.0/plugin-package/LANCommander.Community.Launcher.MQTT.Plugin.dll' diff --git a/eng/lancommander-source.json b/eng/lancommander-source.json index 7a96b42..a005df7 100644 --- a/eng/lancommander-source.json +++ b/eng/lancommander-source.json @@ -1,7 +1,7 @@ { "repository": "https://github.com/LANCommander/LANCommander.git", - "tag": "v2.2.0-beta.3", - "commit": "9eefa639a904059c0a03f39e7908332f468828af", + "tag": "v2.2.0-beta.4", + "commit": "675befe0673c03aded2b45995694661ce454ba95", "projects": [ "LANCommander.SDK", "LANCommander.Launcher.Plugins", diff --git a/eng/plugins.json b/eng/plugins.json index 5d9e3a0..03af766 100644 --- a/eng/plugins.json +++ b/eng/plugins.json @@ -24,10 +24,10 @@ "quake3" ], "host": "Server", - "minimumHostVersion": "2.2.0-beta.3", + "minimumHostVersion": "2.2.0-beta.4", "maximumHostVersion": null, - "hostPackageVersion": "2.2.0-beta.3", - "hostSourceCommit": "9eefa639a904059c0a03f39e7908332f468828af", + "hostPackageVersion": "2.2.0-beta.4", + "hostSourceCommit": "675befe0673c03aded2b45995694661ce454ba95", "artifactFormat": "nupkg", "githubPackagesEligible": true, "nugetOrgEligible": true @@ -54,7 +54,7 @@ "mcp" ], "host": "Server", - "minimumHostVersion": "2.2.0-beta.3", + "minimumHostVersion": "2.2.0-beta.4", "maximumHostVersion": null, "artifactFormat": "nupkg", "githubPackagesEligible": true, @@ -83,7 +83,7 @@ "catalog" ], "host": "Server", - "minimumHostVersion": "2.2.0-beta.3", + "minimumHostVersion": "2.2.0-beta.4", "maximumHostVersion": null, "artifactFormat": "nupkg", "githubPackagesEligible": true, @@ -113,8 +113,8 @@ "homeassistant" ], "host": "Launcher", - "minimumHostVersion": "2.2.0-beta.3", - "maximumHostVersion": "2.2.0-beta.3", + "minimumHostVersion": "2.2.0-beta.4", + "maximumHostVersion": "2.2.0-beta.4", "artifactFormat": "nupkg", "githubPackagesEligible": true, "nugetOrgEligible": true diff --git a/plugins/Launcher.MQTT/CHANGELOG.md b/plugins/Launcher.MQTT/CHANGELOG.md index b28cfdb..1e77b5f 100644 --- a/plugins/Launcher.MQTT/CHANGELOG.md +++ b/plugins/Launcher.MQTT/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## Unreleased + +- Update the source pin and exact host bounds to released LANCommander + 2.2.0-beta.4. Use `ActionType.Primary` rather than the legacy read-only + primary-action flag, retaining the exactly-one-primary safety check. +- Component versions and existing release artifacts are unchanged. + ## 0.2.1 Unreleased: package the launcher as `LANCommander.Community.Launcher.MQTT.Plugin` diff --git a/plugins/Launcher.MQTT/README.md b/plugins/Launcher.MQTT/README.md index 0e3eeef..14ba0f2 100644 --- a/plugins/Launcher.MQTT/README.md +++ b/plugins/Launcher.MQTT/README.md @@ -43,7 +43,7 @@ rejects new requests rather than evicting valid IDs. Accepted is not completed; install success requires terminal queue status and an installed record/manifest. Launch completion means the normal LC run returned, not an exit-code verdict. -The source-pinned adapter and MQTT transport are now implemented as well. The host adapter builds against the exact `v2.2.0-beta.3` source tree, starts only in the GUI launcher, and keeps a fresh service scope alive for the full `GameService.Run` task. It launches only one unambiguous primary action for an allowlisted, already-installed game. The adapter retains verified source project references for its launcher service contracts and host-loader tests. +The source-pinned adapter and MQTT transport are now implemented as well. The host adapter builds against the exact `v2.2.0-beta.4` source tree, starts only in the GUI launcher, and keeps a fresh service scope alive for the full `GameService.Run` task. It launches only one unambiguous `ActionType.Primary` action for an allowlisted, already-installed game. The adapter retains verified source project references for its launcher service contracts and host-loader tests. The MQTT client uses authenticated MQTT 5, clean sessions, non-retained commands/results, retained discovery/state and last will, bounded ingress and reconnect/HA-birth replay. @@ -108,7 +108,7 @@ are supplementary, not the installer contract. Build and validate locally: pwsh .\eng\Validate-Plugin.ps1 -Plugin Launcher.MQTT -OutputDirectory "C:\path\to\new-artifact-folder" ``` -Use LANCommander **2.2.0-beta.3**'s Launcher plugin manager to install the local +Use LANCommander **2.2.0-beta.4**'s Launcher plugin manager to install the local `.nupkg`, or find this package in a configured feed after a maintainer release. Installation is staged until restart. Releases use GitHub Packages automatically; NuGet.org is used only if the release workflow has `NUGET_API_KEY`. @@ -156,7 +156,7 @@ whole archive, `lib` wrapper, or any host DLLs into `Plugins`. 1. Install through the Launcher plugin manager (see above and the [test guide](examples/TEST-GUIDE.md)), restart the GUI and configure it in Launcher settings. Alternatively copy `src\LANCommander.Community.Launcher.MQTT.Plugin\homeassistant.example.json` to the plugin's `Data/homeassistant.json` and fill it in locally. `ExposureMode` is `"selected"` (default; `Favorites` is the UUID/title allowlist, now unlimited) or `"all"` (the authenticated visible library). An empty selection safely exposes no games. 2. Set `UseTls` to `false` for plaintext MQTT (usually port `1883`), or `true` for TLS (usually port `8883`). Use the port configured on your broker; it is not changed automatically. Certificate errors are ignored when TLS is enabled. Existing configurations must add `BrokerUsername` and `BrokerPassword`; no Credential Manager entry is read. 3. Use the repository validation command to materialize the pinned LANCommander - `v2.2.0-beta.3` source commit and run the core/loader/template tests: + `v2.2.0-beta.4` source commit and run the core/loader/template tests: ```powershell pwsh .\eng\Validate-Plugin.ps1 -Plugin Launcher.MQTT -OutputDirectory "C:\path\to\new-artifact-folder" @@ -194,7 +194,7 @@ and `command/install_selected` require matching actions and an empty UUID `00000000-0000-0000-0000-000000000000`. All use the same request ID/time envelope. Selected-action results contain the resolved UUID. Do not retain any command. -To repeat package discovery, installation, Data-preserving update and beta.3 +To repeat package discovery, installation, Data-preserving update and beta.4 host-loader checks against the actual artifact: ```powershell @@ -219,17 +219,15 @@ replace a manual button press on a running Home Assistant installation. ### Verified package contracts -The released beta.3 source at -[`9eefa63`](https://github.com/LANCommander/LANCommander/commit/9eefa639a904059c0a03f39e7908332f468828af) -already supports launcher NuGet installation. This was rechecked against -current main -[`123ec53`](https://github.com/LANCommander/LANCommander/commit/123ec53a5dd177c2124001ad9f0ce9cb1a6e8acc). +The released beta.4 source at +[`675befe`](https://github.com/LANCommander/LANCommander/commit/675befe0673c03aded2b45995694661ce454ba95) +supports launcher NuGet installation and is the verified build/load baseline. The package reader selects `lib/`, inspects one assembly attribute for launcher host/version compatibility and installs the assembly-named folder. The staging updater retains only `Data`: -[`PluginPackageReader`](https://github.com/LANCommander/LANCommander/blob/9eefa639a904059c0a03f39e7908332f468828af/LANCommander.PluginManagement/PluginPackageReader.cs), -[`PluginStaging`](https://github.com/LANCommander/LANCommander/blob/9eefa639a904059c0a03f39e7908332f468828af/LANCommander.PluginManagement/PluginStaging.cs), -[`LauncherPluginService`](https://github.com/LANCommander/LANCommander/blob/9eefa639a904059c0a03f39e7908332f468828af/LANCommander.Launcher.Services/Plugins/LauncherPluginService.cs). +[`PluginPackageReader`](https://github.com/LANCommander/LANCommander/blob/675befe0673c03aded2b45995694661ce454ba95/LANCommander.PluginManagement/PluginPackageReader.cs), +[`PluginStaging`](https://github.com/LANCommander/LANCommander/blob/675befe0673c03aded2b45995694661ce454ba95/LANCommander.PluginManagement/PluginStaging.cs), +[`LauncherPluginService`](https://github.com/LANCommander/LANCommander/blob/675befe0673c03aded2b45995694661ce454ba95/LANCommander.Launcher.Services/Plugins/LauncherPluginService.cs). The service/package-management host projects are not published as usable -NuGet dependencies, so source pinning remains necessary. The exact beta.3 -minimum/maximum range is unchanged; newer hosts are not claimed compatible. +NuGet dependencies, so source pinning remains necessary. The exact beta.4 +minimum/maximum range excludes older and newer hosts until separately verified. diff --git a/plugins/Launcher.MQTT/examples/TEST-GUIDE.md b/plugins/Launcher.MQTT/examples/TEST-GUIDE.md index 92bd1cb..b08366c 100644 --- a/plugins/Launcher.MQTT/examples/TEST-GUIDE.md +++ b/plugins/Launcher.MQTT/examples/TEST-GUIDE.md @@ -1,7 +1,7 @@ # Launcher test package 0.2.1 -Actual Windows GUI Launcher plugin targeting **LANCommander v2.2.0-beta.3**, -source commit `9eefa639a904059c0a03f39e7908332f468828af`, .NET 10. +Actual Windows GUI Launcher plugin targeting **LANCommander v2.2.0-beta.4**, +source commit `675befe0673c03aded2b45995694661ce454ba95`, .NET 10. The earlier PoC's real HA-to-LC launch was confirmed by the user. This iteration adds native configuration, scalable selection and the normal LC install queue. Its new GUI and real install workflow still require your smoke test. @@ -177,7 +177,7 @@ administration if removing the plugin entirely. ## Verification boundary -Automated checks build from isolated pinned beta.3 source, exercise the actual +Automated checks build from isolated pinned beta.4 source, exercise the actual plugin loader/default host type identity/headless initialization and inspect the four-DLL inventory. The actual NuGet artifact is searched on a local feed, installed/staged by the pinned host package manager, upgraded with Data diff --git a/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/HomeAssistantLauncherPlugin.cs b/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/HomeAssistantLauncherPlugin.cs index 8e0dc37..705a434 100644 --- a/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/HomeAssistantLauncherPlugin.cs +++ b/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/HomeAssistantLauncherPlugin.cs @@ -12,8 +12,8 @@ typeof(LANCommander.Community.Launcher.MQTT.HomeAssistantLauncherPlugin), Id = "com.aaronpowell.lancommander.homeassistant", Hosts = PluginHost.Launcher, - MinHostVersion = "2.2.0-beta.3", - MaxHostVersion = "2.2.0-beta.3")] + MinHostVersion = "2.2.0-beta.4", + MaxHostVersion = "2.2.0-beta.4")] namespace LANCommander.Community.Launcher.MQTT; diff --git a/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/LANCommander.Community.Launcher.MQTT.Plugin.csproj b/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/LANCommander.Community.Launcher.MQTT.Plugin.csproj index 42915e1..f6938b7 100644 --- a/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/LANCommander.Community.Launcher.MQTT.Plugin.csproj +++ b/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/LANCommander.Community.Launcher.MQTT.Plugin.csproj @@ -39,7 +39,7 @@ - + diff --git a/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/LANCommanderGameLaunchHost.cs b/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/LANCommanderGameLaunchHost.cs index 907671d..81aa0dd 100644 --- a/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/LANCommanderGameLaunchHost.cs +++ b/plugins/Launcher.MQTT/src/LANCommander.Community.Launcher.MQTT.Plugin/LANCommanderGameLaunchHost.cs @@ -80,15 +80,13 @@ public async Task StartGameAsync(Guid gameId, CancellationTo var service = scope.ServiceProvider.GetRequiredService(); var game = await service.GetAsync(gameId).ConfigureAwait(false); var client = root.GetRequiredService(); - var actions = (await client.GetActionsAsync(game.InstallDirectory, gameId).ConfigureAwait(false)) - .Where(action => action.IsPrimaryAction).ToArray(); - if (actions.Length != 1) - throw new InvalidOperationException("The installed game must have exactly one primary launch action."); + var action = RequirePrimaryAction( + await client.GetActionsAsync(game.InstallDirectory, gameId).ConfigureAwait(false)); Task? completion = null; await Dispatcher.UIThread.InvokeAsync(() => { EnsureNoQueueOrGameOperation(); - completion = service.Run(game, actions[0]); + completion = service.Run(game, action); }); return new LaunchSession(client, gameId, completion!, scope); } @@ -126,6 +124,15 @@ public static string RequireInstallDestination(IEnumerable directories) return configured[0]; } + public static LANCommander.SDK.Models.Manifest.Action RequirePrimaryAction( + IEnumerable actions) + { + var primary = actions.Where(action => action.Type == ActionType.Primary).ToArray(); + if (primary.Length != 1) + throw new InvalidOperationException("The installed game must have exactly one primary launch action."); + return primary[0]; + } + private void EnsureNoQueueOrGameOperation() { var queue = root.GetRequiredService().Queue; diff --git a/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests.csproj b/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests.csproj index 070ae91..8ae6f53 100644 --- a/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests.csproj +++ b/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests.csproj @@ -26,6 +26,6 @@ - + diff --git a/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginLoadContextTests.cs b/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginLoadContextTests.cs index febf1f0..1d1c279 100644 --- a/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginLoadContextTests.cs +++ b/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginLoadContextTests.cs @@ -25,7 +25,7 @@ public async Task Host_loader_discovers_package_and_skips_transport_in_headless_ var services = new ServiceCollection().AddLogging(); var loader = new PluginLoaderService(); loader.DiscoverAndConfigure(services, PluginHost.Launcher, - Path.GetDirectoryName(directory)!, "2.2.0-beta.3", NullLogger.Instance); + Path.GetDirectoryName(directory)!, "2.2.0-beta.4", NullLogger.Instance); var loaded = Assert.Single(loader.Plugins); Assert.Equal("com.aaronpowell.lancommander.homeassistant", loaded.Plugin.Id); Assert.Contains(services, descriptor => descriptor.ServiceType.FullName == typeof(HomeAssistantRuntime).FullName @@ -56,8 +56,8 @@ public void Plugin_entrypoint_and_host_service_types_bind_to_host_assemblies() Assert.NotNull(manifest); Assert.Equal("LANCommander.Community.Launcher.MQTT.Plugin", pluginAssembly.GetName().Name); - Assert.Equal("2.2.0-beta.3", manifest.MinHostVersion); - Assert.Equal("2.2.0-beta.3", manifest.MaxHostVersion); + Assert.Equal("2.2.0-beta.4", manifest.MinHostVersion); + Assert.Equal("2.2.0-beta.4", manifest.MaxHostVersion); Assert.True(typeof(IPlugin).IsAssignableFrom(manifest!.EntryPoint)); var plugin = Activator.CreateInstance(manifest.EntryPoint) as IPlugin; Assert.Equal("com.aaronpowell.lancommander.homeassistant", plugin?.Id); diff --git a/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginPackageTests.cs b/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginPackageTests.cs index d1dcec8..45aba3b 100644 --- a/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginPackageTests.cs +++ b/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginPackageTests.cs @@ -31,7 +31,7 @@ public async Task Actual_package_is_discoverable_installs_loads_and_preserves_da Assert.Empty((await feeds.SearchAsync("", PluginPackageTypes.Server)).Packages); var staging = new PluginStaging(root, Path.Combine(root, ".staging")); var manager = new PluginPackageManager(PluginHost.Launcher, feeds, new PluginLoaderService(), - staging, NullLogger.Instance, "2.2.0-beta.3", NuGetFramework.Parse("net10.0")); + staging, NullLogger.Instance, "2.2.0-beta.4", NuGetFramework.Parse("net10.0")); await using (var stream = File.OpenRead(packagePath!)) { var result = await manager.InstallAsync(stream); @@ -54,16 +54,17 @@ public async Task Actual_package_is_discoverable_installs_loads_and_preserves_da Assert.False(File.Exists(Path.Combine(installed, "homeassistant.json"))); var loader = new PluginLoaderService(); var services = new ServiceCollection().AddLogging(); - loader.DiscoverAndConfigure(services, PluginHost.Launcher, root, "2.2.0-beta.3", NullLogger.Instance); + loader.DiscoverAndConfigure(services, PluginHost.Launcher, root, "2.2.0-beta.4", NullLogger.Instance); var plugin = Assert.Single(loader.Plugins); Assert.Equal("com.aaronpowell.lancommander.homeassistant", plugin.Plugin.Id); Assert.Equal(expectedVersion, plugin.Plugin.Version); } [Theory] - [InlineData(PluginHost.Server, "2.2.0-beta.3")] + [InlineData(PluginHost.Server, "2.2.0-beta.4")] [InlineData(PluginHost.Launcher, "2.2.0-alpha.4")] - [InlineData(PluginHost.Launcher, "2.2.0-beta.4")] + [InlineData(PluginHost.Launcher, "2.2.0-beta.3")] + [InlineData(PluginHost.Launcher, "2.2.0-beta.5")] public void Actual_package_rejects_wrong_host_or_unverified_version(PluginHost host, string version) { var packagePath = Environment.GetEnvironmentVariable("LANCOMMANDER_MQTT_PACKAGE_PATH"); diff --git a/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginSettingsTests.cs b/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginSettingsTests.cs index bdaa34b..dc8e3ce 100644 --- a/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginSettingsTests.cs +++ b/plugins/Launcher.MQTT/tests/LANCommander.Community.Launcher.MQTT.HostLoader.Tests/PluginSettingsTests.cs @@ -8,6 +8,24 @@ namespace LANCommander.Community.Launcher.MQTT.HostLoader.Tests; public sealed class PluginSettingsTests { + [Fact] + public void Launch_requires_exactly_one_primary_type_and_accepts_legacy_manifest_flag() + { + var primary = new LANCommander.SDK.Models.Manifest.Action { Type = LANCommander.SDK.Enums.ActionType.Primary }; + var other = new[] + { + new LANCommander.SDK.Models.Manifest.Action { Type = LANCommander.SDK.Enums.ActionType.Secondary }, + new LANCommander.SDK.Models.Manifest.Action { Type = LANCommander.SDK.Enums.ActionType.Config }, + new LANCommander.SDK.Models.Manifest.Action { Type = LANCommander.SDK.Enums.ActionType.Join } + }; + Assert.Same(primary, LANCommanderGameLaunchHost.RequirePrimaryAction(other.Append(primary))); + Assert.Throws(() => LANCommanderGameLaunchHost.RequirePrimaryAction(other)); + var legacy = new LANCommander.SDK.Models.Manifest.Action { IsPrimaryAction = true }; + Assert.Same(legacy, LANCommanderGameLaunchHost.RequirePrimaryAction([legacy])); + Assert.Throws(() => + LANCommanderGameLaunchHost.RequirePrimaryAction([primary, legacy])); + } + [Theory] [InlineData(null, false)] [InlineData(false, false)] diff --git a/plugins/Server.Mcp/CHANGELOG.md b/plugins/Server.Mcp/CHANGELOG.md index 52f517e..46cd0fc 100644 --- a/plugins/Server.Mcp/CHANGELOG.md +++ b/plugins/Server.Mcp/CHANGELOG.md @@ -2,6 +2,8 @@ ## Unreleased +- Update host packages and minimum host version to LANCommander 2.2.0-beta.4 + without changing the component version or existing releases. - The MCP setup page now shows the endpoint derived from LANCommander's address and path base (with an unsaved override), and tabbed, copyable client setup for the GitHub Copilot app, Claude Code, Codex and general MCP clients using diff --git a/plugins/Server.Mcp/README.md b/plugins/Server.Mcp/README.md index ca1c95b..e9a5e75 100644 --- a/plugins/Server.Mcp/README.md +++ b/plugins/Server.Mcp/README.md @@ -11,7 +11,7 @@ match that project name. The persistent plugin ID remains ## Requirements -- LANCommander server **2.2.0-beta.3 or later** with the server plugin framework. +- LANCommander server **2.2.0-beta.4 or later** with the server plugin framework. - .NET 10 SDK to build. - An MCP client supporting Streamable HTTP and an administrator's LANCommander bearer token. diff --git a/plugins/Server.Mcp/src/LANCommander.Community.Server.Mcp/McpPlugin.cs b/plugins/Server.Mcp/src/LANCommander.Community.Server.Mcp/McpPlugin.cs index 344cb15..13f4ebe 100644 --- a/plugins/Server.Mcp/src/LANCommander.Community.Server.Mcp/McpPlugin.cs +++ b/plugins/Server.Mcp/src/LANCommander.Community.Server.Mcp/McpPlugin.cs @@ -9,7 +9,7 @@ using Microsoft.Extensions.Logging; [assembly: LANCommanderPlugin(typeof(McpPlugin), Id = McpPlugin.PluginId, - MinHostVersion = "2.2.0-beta.3", Hosts = PluginHost.Server)] + MinHostVersion = "2.2.0-beta.4", Hosts = PluginHost.Server)] namespace LANCommander.Community.Server.Mcp; diff --git a/plugins/Server.Mcp/tests/LANCommander.Community.Server.Mcp.Tests/McpHttpTests.cs b/plugins/Server.Mcp/tests/LANCommander.Community.Server.Mcp.Tests/McpHttpTests.cs index 6e92ecc..fb71883 100644 --- a/plugins/Server.Mcp/tests/LANCommander.Community.Server.Mcp.Tests/McpHttpTests.cs +++ b/plugins/Server.Mcp/tests/LANCommander.Community.Server.Mcp.Tests/McpHttpTests.cs @@ -395,7 +395,7 @@ public void PluginIsServerOnlyAndAdministratorOnly() var attribute = Assert.Single(typeof(McpPlugin).Assembly.GetCustomAttributes(typeof(LANCommanderPluginAttribute), false) .Cast()); Assert.Equal(PluginHost.Server, attribute.Hosts); - Assert.Equal("2.2.0-beta.3", attribute.MinHostVersion); + Assert.Equal("2.2.0-beta.4", attribute.MinHostVersion); Assert.False(new McpEndpoints().Access.IsSatisfiedBy(new ClaimsPrincipal(new ClaimsIdentity()))); } } diff --git a/plugins/Server.Quake3/CHANGELOG.md b/plugins/Server.Quake3/CHANGELOG.md index dd0b743..566dbc9 100644 --- a/plugins/Server.Quake3/CHANGELOG.md +++ b/plugins/Server.Quake3/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +## Unreleased + +- Update host packages and minimum host version to LANCommander 2.2.0-beta.4 + without changing the component version or existing releases. + ## 0.1.0-alpha.1 - Add native administrator-only Quake 3 server selection, status, bounded diff --git a/plugins/Server.Quake3/Directory.Packages.props b/plugins/Server.Quake3/Directory.Packages.props index ed79c3a..77c3576 100644 --- a/plugins/Server.Quake3/Directory.Packages.props +++ b/plugins/Server.Quake3/Directory.Packages.props @@ -1,7 +1,7 @@ - 2.2.0-beta.3 + 2.2.0-beta.4 diff --git a/plugins/Server.Quake3/LANCommander.Community.Server.Quake3.Host.Tests/PackageLoaderTests.cs b/plugins/Server.Quake3/LANCommander.Community.Server.Quake3.Host.Tests/PackageLoaderTests.cs index 622bce2..4656549 100644 --- a/plugins/Server.Quake3/LANCommander.Community.Server.Quake3.Host.Tests/PackageLoaderTests.cs +++ b/plugins/Server.Quake3/LANCommander.Community.Server.Quake3.Host.Tests/PackageLoaderTests.cs @@ -40,7 +40,7 @@ public void LoadPluginWithSharedHostTypeIdentity() var assembly = context.LoadFromStream(pluginStream); var attribute = assembly.GetCustomAttribute(); Assert.NotNull(attribute); - Assert.Equal("2.2.0-beta.3", attribute.MinHostVersion); + Assert.Equal("2.2.0-beta.4", attribute.MinHostVersion); Assert.Equal(PluginHost.Server, attribute.Hosts); var pluginType = Assert.Single(assembly.GetTypes(), t => typeof(IPlugin).IsAssignableFrom(t) && !t.IsAbstract); var plugin = Assert.IsAssignableFrom(Activator.CreateInstance(pluginType)); diff --git a/plugins/Server.Quake3/LANCommander.Community.Server.Quake3/Quake3Plugin.cs b/plugins/Server.Quake3/LANCommander.Community.Server.Quake3/Quake3Plugin.cs index 846da2b..b6b48b6 100644 --- a/plugins/Server.Quake3/LANCommander.Community.Server.Quake3/Quake3Plugin.cs +++ b/plugins/Server.Quake3/LANCommander.Community.Server.Quake3/Quake3Plugin.cs @@ -6,7 +6,7 @@ [assembly: LANCommanderPlugin(typeof(LANCommander.Community.Server.Quake3.Quake3Plugin), Id = LANCommander.Community.Server.Quake3.Quake3Plugin.PluginId, - MinHostVersion = "2.2.0-beta.3", Hosts = PluginHost.Server)] + MinHostVersion = "2.2.0-beta.4", Hosts = PluginHost.Server)] namespace LANCommander.Community.Server.Quake3; diff --git a/plugins/Server.Quake3/README.md b/plugins/Server.Quake3/README.md index 0ebc12a..cf7faba 100644 --- a/plugins/Server.Quake3/README.md +++ b/plugins/Server.Quake3/README.md @@ -10,13 +10,13 @@ the container. ## Compatibility and development status -Requires LANCommander Server **2.2.0-beta.3 or later**. The Quake-specific +Requires LANCommander Server **2.2.0-beta.4 or later**. The Quake-specific central package file pins only this plugin's SDK, Server.Plugins and Server.UI -contracts to published `2.2.0-beta.3`, matching the shared host baseline. +contracts to published `2.2.0-beta.4`, matching the shared host baseline. The host provides `IServerProvider.ListFilesAsync`, `OpenFileAsync`, `WriteFileAsync` and `ServerFileInfo`. These APIs were added in [LANCommander/LANCommander#480](https://github.com/LANCommander/LANCommander/pull/480) -and are included in beta.3. A running host must itself be beta.3 or later; +and remain available in beta.4. A running host must itself be beta.4 or later; restoring compile-time NuGet packages does not upgrade the server. The plugin package and assembly are both @@ -119,8 +119,8 @@ Deleting/replacing state is an operator action, not an automatic recovery. ## Build and verification The pinned public host packages were built from upstream tag -`v2.2.0-beta.3` (source commit -`9eefa639a904059c0a03f39e7908332f468828af`). +`v2.2.0-beta.4` (source commit +`675befe0673c03aded2b45995694661ce454ba95`). Requires .NET 10 SDK and PowerShell 7. Core tests do not need LC, Docker or game assets: diff --git a/plugins/Server.RecompCatalog/CHANGELOG.md b/plugins/Server.RecompCatalog/CHANGELOG.md index b169f11..49aff9d 100644 --- a/plugins/Server.RecompCatalog/CHANGELOG.md +++ b/plugins/Server.RecompCatalog/CHANGELOG.md @@ -1,5 +1,11 @@ # Changelog +## Unreleased + +- Update host packages and minimum host version to LANCommander 2.2.0-beta.4 + without changing the component version or existing releases. +- Emit the beta.4 `ActionType.Primary` discriminator in generated game manifests. + ## 0.4.2 Unreleased monorepo migration build. Builds against the LANCommander 2.2.0-beta.3 diff --git a/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Infrastructure/LcxPackageBuilder.cs b/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Infrastructure/LcxPackageBuilder.cs index ba4ae97..d1ac790 100644 --- a/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Infrastructure/LcxPackageBuilder.cs +++ b/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Infrastructure/LcxPackageBuilder.cs @@ -62,7 +62,7 @@ public async Task BuildAsync( Path = selectedExecutable.Replace('/', Path.DirectorySeparatorChar), WorkingDirectory = Path.GetDirectoryName( selectedExecutable.Replace('/', Path.DirectorySeparatorChar)) ?? "", - IsPrimaryAction = true, + Type = ActionType.Primary, SortOrder = 0, Platforms = RuntimePlatform.Windows, }, diff --git a/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Plugin/RecompCatalogPlugin.cs b/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Plugin/RecompCatalogPlugin.cs index b2a93c1..cc919cd 100644 --- a/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Plugin/RecompCatalogPlugin.cs +++ b/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Plugin/RecompCatalogPlugin.cs @@ -12,7 +12,7 @@ [assembly: LANCommanderPlugin( typeof(RecompCatalogPlugin), Id = RecompCatalogPlugin.PluginId, - MinHostVersion = "2.2.0-beta.3", + MinHostVersion = "2.2.0-beta.4", Hosts = PluginHost.Server)] namespace LANCommander.Community.Server.RecompCatalog.Plugin; diff --git a/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Tests/HostContractTests.cs b/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Tests/HostContractTests.cs index 7d49043..9645ff5 100644 --- a/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Tests/HostContractTests.cs +++ b/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Tests/HostContractTests.cs @@ -20,7 +20,7 @@ public void DeclaresMinimumHostVersionForPublishedContracts() var plugin = typeof(RecompCatalogPlugin).Assembly.GetCustomAttribute(); Assert.NotNull(plugin); - Assert.Equal("2.2.0-beta.3", plugin.MinHostVersion); + Assert.Equal("2.2.0-beta.4", plugin.MinHostVersion); Assert.Equal(PluginHost.Server, plugin.Hosts); } diff --git a/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Tests/LcxPackageBuilderTests.cs b/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Tests/LcxPackageBuilderTests.cs index 837a8f8..b4d4713 100644 --- a/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Tests/LcxPackageBuilderTests.cs +++ b/plugins/Server.RecompCatalog/LANCommander.Community.Server.RecompCatalog.Tests/LcxPackageBuilderTests.cs @@ -129,6 +129,7 @@ public async Task BuildsImportableLcxWithStableIdsAndProvenance() Assert.Equal("v1.2.3", manifest.Version); Assert.Contains("owner/repository", manifest.Notes); Assert.Equal(Path.Combine("bin", "game.exe"), Assert.Single(manifest.Actions).Path); + Assert.Equal(LANCommander.SDK.Enums.ActionType.Primary, Assert.Single(manifest.Actions).Type); Assert.Equal(result.ArchiveId, Assert.Single(manifest.Archives).Id); Assert.Contains( manifest.CustomFields, diff --git a/plugins/Server.RecompCatalog/README.md b/plugins/Server.RecompCatalog/README.md index b681df9..f69e713 100644 --- a/plugins/Server.RecompCatalog/README.md +++ b/plugins/Server.RecompCatalog/README.md @@ -95,11 +95,11 @@ for eligibility, permissions, and retry behavior. The plugin builds against the LANCommander NuGet packages `LANCommander.SDK`, `LANCommander.Server.Plugins`, and `LANCommander.Server.UI`. Their shared version is `LANCommanderPackageVersion` in the repository-root `Directory.Packages.props` -(`2.2.0-beta.3`). +(`2.2.0-beta.4`). The plugin needs the host contracts (`IMetadataLookup`, version redistributables, and bulk custom field reads) originally added in `2.2.0-alpha.3`. This build targets -`2.2.0-beta.3` or later: +`2.2.0-beta.4` or later: ```powershell dotnet build .\LANCommander.Community.slnx -c Release @@ -305,7 +305,7 @@ nothing is administrator-only by default. LANCommander's plugin load context treats `LANCommander.SDK`, `LANCommander.Server.Plugins`, and `LANCommander.Server.UI` as shared host assemblies, so the plugin resolves the server's already-loaded copies instead of loading second ones. The server must be LANCommander -`2.2.0-beta.3` or later; older 2.2.0 prereleases fail to activate this build. +`2.2.0-beta.4` or later; older 2.2.0 prereleases fail to activate this build. ## Known gaps From ecb0615824f9211ca1d4434931122e3fa3986886 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Thu, 12 Nov 2026 16:03:09 +1100 Subject: [PATCH 2/2] chore: prepare beta.4 plugin releases Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- RELEASES.md | 6 +-- eng/Test-GitHubPackages.ps1 | 38 +++++++++-------- eng/Test-NuGetPublication.ps1 | 50 +++++++++++++---------- eng/Test-ReleaseSelection.ps1 | 10 ++--- plugins/Launcher.MQTT/CHANGELOG.md | 13 ++---- plugins/Launcher.MQTT/README.md | 8 ++-- plugins/Server.Mcp/CHANGELOG.md | 15 ++++--- plugins/Server.Mcp/README.md | 6 +-- plugins/Server.Mcp/version.txt | 2 +- plugins/Server.Quake3/CHANGELOG.md | 7 ++-- plugins/Server.Quake3/version.txt | 2 +- plugins/Server.RecompCatalog/CHANGELOG.md | 7 ++-- plugins/Server.RecompCatalog/README.md | 2 +- plugins/Server.RecompCatalog/version.txt | 2 +- 14 files changed, 86 insertions(+), 82 deletions(-) diff --git a/RELEASES.md b/RELEASES.md index 611620c..3bd210e 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -94,8 +94,8 @@ runtime exclusions and loader-identity checks. `version.txt`: ```powershell - git tag -a server-mcp-v0.2.1 -m "Server.Mcp 0.2.1" - git push origin server-mcp-v0.2.1 + git tag -a server-mcp-v0.2.2 -m "Server.Mcp 0.2.2" + git push origin server-mcp-v0.2.2 ``` The example is illustrative; check the current version file and release @@ -113,7 +113,7 @@ existing tag, component version, and `main` ancestry and then uses the normal build, release, and feed jobs. Do not move or recreate the tag. For example: ```powershell -gh workflow run release.yml --repo aaronpowell/LANCommander.Community --ref main -f tag=server-mcp-v0.2.1 +gh workflow run release.yml --repo aaronpowell/LANCommander.Community --ref main -f tag=server-mcp-v0.2.2 ``` For a run that successfully built the package but failed later, pass that run's diff --git a/eng/Test-GitHubPackages.ps1 b/eng/Test-GitHubPackages.ps1 index b1697a5..720dc5f 100644 --- a/eng/Test-GitHubPackages.ps1 +++ b/eng/Test-GitHubPackages.ps1 @@ -2,6 +2,10 @@ $ErrorActionPreference = 'Stop' $repositoryRoot = Split-Path $PSScriptRoot -Parent Import-Module (Join-Path $PSScriptRoot 'PluginRelease.psm1') -Force Import-Module (Join-Path $PSScriptRoot 'GitHubPackages.psm1') -Force +$testComponent = @(Get-PluginRegistry | Where-Object key -CEQ 'Server.Mcp')[0] +$testVersion = Get-PluginVersion $testComponent +$testTag = "$($testComponent.tagPrefix)-v$testVersion" +$wrongTag = "$($testComponent.tagPrefix)-v99.99.99" $testRoot = Join-Path ([IO.Path]::GetTempPath()) "lancommander-github-packages-$([Guid]::NewGuid().ToString('N'))" New-Item -ItemType Directory -Path $testRoot | Out-Null $originalGitHubToken = [Environment]::GetEnvironmentVariable('GITHUB_TOKEN', 'Process') @@ -13,12 +17,12 @@ function New-TestPackage { $stream = [IO.File]::Open($Path, [IO.FileMode]::CreateNew) $archive = [System.IO.Compression.ZipArchive]::new($stream, [System.IO.Compression.ZipArchiveMode]::Create) try { - $nuspec = @' + $nuspec = @" - LANCommander.Community.Server.Mcp - 0.2.1 + $($testComponent.packageId) + $testVersion test Test package LANCommander plugin server mcp @@ -26,7 +30,7 @@ function New-TestPackage { -'@ +"@ foreach ($entryData in @( @{ name = 'LANCommander.Community.Server.Mcp.nuspec'; value = $nuspec }, @{ name = 'lib/net10.0/payload.dll'; value = $Payload } @@ -140,29 +144,29 @@ try { throw 'Component releases must provide scoped caller permissions, optional NuGet.org secret forwarding, and exact-artifact main-only recovery dispatch.' } - Assert-ReleaseWorkflowContext -Tag 'server-mcp-v0.2.1' -Repository 'aaronpowell/LANCommander.Community' ` + Assert-ReleaseWorkflowContext -Tag $testTag -Repository 'aaronpowell/LANCommander.Community' ` -ExpectedRepository 'aaronpowell/LANCommander.Community' -Actions 'true' ` - -EventName 'push' -Ref 'refs/tags/server-mcp-v0.2.1' - Assert-ReleaseWorkflowContext -Tag 'server-mcp-v0.2.1' -Repository 'aaronpowell/LANCommander.Community' ` + -EventName 'push' -Ref "refs/tags/$testTag" + Assert-ReleaseWorkflowContext -Tag $testTag -Repository 'aaronpowell/LANCommander.Community' ` -ExpectedRepository 'aaronpowell/LANCommander.Community' -Actions 'true' ` -EventName 'workflow_dispatch' -Ref 'refs/heads/main' Assert-Fails { - Assert-ReleaseWorkflowContext -Tag 'server-mcp-v0.2.1' -Repository 'aaronpowell/LANCommander.Community' ` + Assert-ReleaseWorkflowContext -Tag $testTag -Repository 'aaronpowell/LANCommander.Community' ` -ExpectedRepository 'aaronpowell/LANCommander.Community' -Actions 'true' ` -EventName 'workflow_dispatch' -Ref 'refs/heads/feature' } 'main-branch recovery dispatch' 'Non-main recovery dispatch' $artifactDirectory = Join-Path $testRoot 'artifact' New-Item -ItemType Directory -Path $artifactDirectory | Out-Null - $packageName = 'LANCommander.Community.Server.Mcp.0.2.1.nupkg' + $packageName = "$($testComponent.packageId).$testVersion.nupkg" $packagePath = Join-Path $artifactDirectory $packageName New-TestPackage -Path $packagePath - & (Join-Path $PSScriptRoot 'Test-NuGetPackage.ps1') -Plugin Server.Mcp -PackagePath $packagePath -ExpectedVersion '0.2.1' -RequireRepositoryUrl + & (Join-Path $PSScriptRoot 'Test-NuGetPackage.ps1') -Plugin Server.Mcp -PackagePath $packagePath -ExpectedVersion $testVersion -RequireRepositoryUrl $hash = (Get-FileHash -LiteralPath $packagePath -Algorithm SHA256).Hash.ToLowerInvariant() Set-Content -LiteralPath "$packagePath.sha256" -Value "$hash $packageName" -NoNewline [ordered]@{ component = 'Server.Mcp' - version = '0.2.1' + version = $testVersion host = 'Server' minimumHostVersion = '2.2.0-beta.4' maximumHostVersion = $null @@ -172,10 +176,10 @@ try { sourceCommit = '0000000000000000000000000000000000000000' } | ConvertTo-Json -Depth 5 | Set-Content -LiteralPath (Join-Path $artifactDirectory 'release-manifest.json') - $disabledOutput = (& (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community 2>&1) -join "`n" + $disabledOutput = (& (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community 2>&1) -join "`n" if ($disabledOutput -notmatch 'publishing is disabled') { throw 'The default GitHub Packages path did not remain disabled.' } - $planOutput = (& (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community -Publish -PlanOnly 2>&1) -join "`n" + $planOutput = (& (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community -Publish -PlanOnly 2>&1) -join "`n" $planLine = @($planOutput -split "\r?\n" | Where-Object { $_ -match '^\{"component"' }) | Select-Object -Last 1 $plan = $planLine | ConvertFrom-Json if ($plan.component -cne 'Server.Mcp' -or @@ -187,22 +191,22 @@ try { } Remove-Item Env:GITHUB_TOKEN -ErrorAction SilentlyContinue Assert-Fails { - & (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community -Publish + & (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community -Publish } 'GITHUB_TOKEN is unavailable' 'Missing GitHub Packages credential' Assert-Fails { - & (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag server-mcp-v0.2.2 -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community -Publish -PlanOnly + & (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag $wrongTag -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community -Publish -PlanOnly } 'does not match' 'Release tag selection' $manifestPath = Join-Path $artifactDirectory 'release-manifest.json' $manifestText = Get-Content -LiteralPath $manifestPath -Raw try { Set-Content -LiteralPath $manifestPath -Value ($manifestText.Replace('"nupkg"', '"zip"')) Assert-Fails { - & (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community -Publish -PlanOnly + & (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $artifactDirectory -Owner aaronpowell -Repository aaronpowell/LANCommander.Community -Publish -PlanOnly } 'manifest does not match' 'ZIP artifact rejected by NuGet publisher' } finally { Set-Content -LiteralPath $manifestPath -Value $manifestText } Assert-Fails { - & (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $artifactDirectory -Owner someone-else -Repository someone-else/LANCommander.Community -Publish -PlanOnly + & (Join-Path $PSScriptRoot 'Publish-GitHubPackage.ps1') -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $artifactDirectory -Owner someone-else -Repository someone-else/LANCommander.Community -Publish -PlanOnly } 'restricted to the canonical' 'Repository/owner guard' $equivalentPath = Join-Path $testRoot 'equivalent.nupkg' diff --git a/eng/Test-NuGetPublication.ps1 b/eng/Test-NuGetPublication.ps1 index 84f7556..58bd4ce 100644 --- a/eng/Test-NuGetPublication.ps1 +++ b/eng/Test-NuGetPublication.ps1 @@ -2,6 +2,10 @@ $ErrorActionPreference = 'Stop' $repositoryRoot = Split-Path $PSScriptRoot -Parent Import-Module (Join-Path $PSScriptRoot 'PluginRelease.psm1') -Force Import-Module (Join-Path $PSScriptRoot 'NuGetRelease.psm1') -Force +$testComponent = @(Get-PluginRegistry | Where-Object key -CEQ 'Server.Mcp')[0] +$testVersion = Get-PluginVersion $testComponent +$testTag = "$($testComponent.tagPrefix)-v$testVersion" +$wrongTag = "$($testComponent.tagPrefix)-v99.99.99" $publisher = Join-Path $PSScriptRoot 'Publish-NuGetPackage.ps1' $testRoot = Join-Path ([IO.Path]::GetTempPath()) "lancommander-nuget-tests-$([Guid]::NewGuid().ToString('N'))" New-Item -ItemType Directory -Path $testRoot | Out-Null @@ -11,11 +15,12 @@ function New-TestPackage { param( [Parameter(Mandatory)][string] $Path, [string] $PackageId = 'LANCommander.Community.Server.Mcp', - [string] $Version = '0.2.1', + [string] $Version, [string[]] $Types = @('LANCommander.Plugin', 'LANCommander.Plugin.Server'), [string[]] $Tags = @('LANCommander', 'plugin', 'server', 'mcp') ) + if (-not $Version) { $Version = $script:testVersion } Add-Type -AssemblyName System.IO.Compression.FileSystem $stream = [IO.File]::Open($Path, [IO.FileMode]::CreateNew) $archive = [System.IO.Compression.ZipArchive]::new($stream, [System.IO.Compression.ZipArchiveMode]::Create) @@ -96,13 +101,14 @@ function New-TestArtifact { param( [Parameter(Mandatory)][string] $Directory, [string] $PackageId = 'LANCommander.Community.Server.Mcp', - [string] $PackageVersion = '0.2.1', + [string] $PackageVersion, [string] $NuspecId = $PackageId, [string] $NuspecVersion = $PackageVersion, [string[]] $Types = @('LANCommander.Plugin', 'LANCommander.Plugin.Server'), [string[]] $Tags = @('LANCommander', 'plugin', 'server', 'mcp') ) + if (-not $PackageVersion) { $PackageVersion = $script:testVersion } New-Item -ItemType Directory -Path $Directory | Out-Null $assetName = "$PackageId.$PackageVersion.nupkg" $assetPath = Join-Path $Directory $assetName @@ -150,22 +156,22 @@ try { $skipJob -notmatch 'NUGET_API_KEY repository secret is not configured') { throw 'NuGet.org must be automatically selected only for eligible packages with a configured API key, or report its intentional skip; recovery uses the main publisher commit.' } - Assert-ReleaseWorkflowContext -Tag 'server-mcp-v0.2.1' -Repository 'aaronpowell/LANCommander.Community' ` + Assert-ReleaseWorkflowContext -Tag $testTag -Repository 'aaronpowell/LANCommander.Community' ` -ExpectedRepository 'aaronpowell/LANCommander.Community' -Actions 'true' ` -EventName 'workflow_dispatch' -Ref 'refs/heads/main' Assert-Fails { - Assert-ReleaseWorkflowContext -Tag 'server-mcp-v0.2.1' -Repository 'aaronpowell/LANCommander.Community' ` + Assert-ReleaseWorkflowContext -Tag $testTag -Repository 'aaronpowell/LANCommander.Community' ` -ExpectedRepository 'aaronpowell/LANCommander.Community' -Actions 'true' ` -EventName 'workflow_dispatch' -Ref 'refs/heads/feature' } 'main-branch recovery dispatch' 'Non-main NuGet recovery dispatch' - Assert-ReleaseSourceCheckout -Tag 'server-mcp-v0.2.1' -TagCommit 'abc' -HeadCommit 'abc' ` - -WorkflowCommit 'abc' -EventName 'push' -Ref 'refs/tags/server-mcp-v0.2.1' ` + Assert-ReleaseSourceCheckout -Tag $testTag -TagCommit 'abc' -HeadCommit 'abc' ` + -WorkflowCommit 'abc' -EventName 'push' -Ref "refs/tags/$testTag" ` -TagIsAncestorOfMain $true - Assert-ReleaseSourceCheckout -Tag 'server-mcp-v0.2.1' -TagCommit 'abc' -HeadCommit 'def' ` + Assert-ReleaseSourceCheckout -Tag $testTag -TagCommit 'abc' -HeadCommit 'def' ` -WorkflowCommit 'def' -EventName 'workflow_dispatch' -Ref 'refs/heads/main' ` -TagIsAncestorOfMain $true Assert-Fails { - Assert-ReleaseSourceCheckout -Tag 'server-mcp-v0.2.1' -TagCommit 'abc' -HeadCommit 'def' ` + Assert-ReleaseSourceCheckout -Tag $testTag -TagCommit 'abc' -HeadCommit 'def' ` -WorkflowCommit 'def' -EventName 'workflow_dispatch' -Ref 'refs/heads/main' ` -TagIsAncestorOfMain $false } 'tag reachable from main' 'Unreviewed source tag recovery' @@ -180,54 +186,54 @@ try { $validDirectory = Join-Path $testRoot 'valid' New-TestArtifact -Directory $validDirectory - $disabledOutput = (& $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $validDirectory 2>&1) -join "`n" + $disabledOutput = (& $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $validDirectory 2>&1) -join "`n" if ($disabledOutput -notmatch 'publication is disabled') { throw 'The default NuGet path did not remain disabled.' } - $planOutput = (& $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $validDirectory -Publish -PlanOnly 2>&1) -join "`n" + $planOutput = (& $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $validDirectory -Publish -PlanOnly 2>&1) -join "`n" $plan = $planOutput -split "\r?\n" | Where-Object { $_ -match '^\{"component"' } | Select-Object -Last 1 | ConvertFrom-Json if ($plan.component -cne 'Server.Mcp' -or $plan.packageId -cne 'LANCommander.Community.Server.Mcp' -or - $plan.version -cne '0.2.1' -or $plan.publishRequested -ne $true) { + $plan.version -cne $testVersion -or $plan.publishRequested -ne $true) { throw 'The opt-in package plan did not preserve component, package identity, and version.' } Assert-Fails { - & $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.2 -ArtifactDirectory $validDirectory -Publish -PlanOnly + & $publisher -Plugin Server.Mcp -Tag $wrongTag -ArtifactDirectory $validDirectory -Publish -PlanOnly } 'does not match' 'Release tag selection' Assert-Fails { - & $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $validDirectory -Publish + & $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $validDirectory -Publish } 'NUGET_API_KEY' 'Missing NuGet credential' $env:NUGET_API_KEY = 'test-only-not-a-real-key' Assert-Fails { - & $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $validDirectory -Publish + & $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $validDirectory -Publish } 'protected GitHub Actions workflow' 'Tag workflow guard' Remove-Item Env:NUGET_API_KEY -ErrorAction SilentlyContinue $wrongIdDirectory = Join-Path $testRoot 'wrong-id' New-TestArtifact -Directory $wrongIdDirectory -NuspecId 'LANCommander.Wrong' Assert-Fails { - & $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $wrongIdDirectory -Publish -PlanOnly + & $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $wrongIdDirectory -Publish -PlanOnly } 'identity/version mismatch' 'Package identity validation' $wrongVersionDirectory = Join-Path $testRoot 'wrong-version' New-TestArtifact -Directory $wrongVersionDirectory -NuspecVersion '9.9.9' Assert-Fails { - & $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $wrongVersionDirectory -Publish -PlanOnly + & $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $wrongVersionDirectory -Publish -PlanOnly } 'identity/version mismatch' 'Package version validation' $wrongTypesDirectory = Join-Path $testRoot 'wrong-types' New-TestArtifact -Directory $wrongTypesDirectory -Types @('LANCommander.Plugin') Assert-Fails { - & $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $wrongTypesDirectory -Publish -PlanOnly + & $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $wrongTypesDirectory -Publish -PlanOnly } 'Package types' 'Package type validation' $wrongChecksumDirectory = Join-Path $testRoot 'wrong-checksum' New-TestArtifact -Directory $wrongChecksumDirectory - Set-Content -LiteralPath (Join-Path $wrongChecksumDirectory 'LANCommander.Community.Server.Mcp.0.2.1.nupkg.sha256') -Value 'bad checksum' + Set-Content -LiteralPath (Join-Path $wrongChecksumDirectory "LANCommander.Community.Server.Mcp.$testVersion.nupkg.sha256") -Value 'bad checksum' Assert-Fails { - & $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $wrongChecksumDirectory -Publish -PlanOnly + & $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $wrongChecksumDirectory -Publish -PlanOnly } 'checksum sidecar' 'Artifact integrity validation' $manifestPath = Join-Path $validDirectory 'release-manifest.json' @@ -235,12 +241,12 @@ try { try { Set-Content -LiteralPath $manifestPath -Value ($manifestText.Replace('"nupkg"', '"zip"')) Assert-Fails { - & $publisher -Plugin Server.Mcp -Tag server-mcp-v0.2.1 -ArtifactDirectory $validDirectory -Publish -PlanOnly + & $publisher -Plugin Server.Mcp -Tag $testTag -ArtifactDirectory $validDirectory -Publish -PlanOnly } 'manifest does not match' 'ZIP artifact rejected by NuGet publisher' } finally { Set-Content -LiteralPath $manifestPath -Value $manifestText } - $expectedPackagePath = Join-Path $validDirectory 'LANCommander.Community.Server.Mcp.0.2.1.nupkg' + $expectedPackagePath = Join-Path $validDirectory "LANCommander.Community.Server.Mcp.$testVersion.nupkg" $signedPackagePath = Join-Path $testRoot 'repository-signed.nupkg' New-RepositorySignedTestPackage -SourcePath $expectedPackagePath -DestinationPath $signedPackagePath $validVerificationOutput = @' @@ -252,7 +258,7 @@ Service index: https://api.nuget.org/v3/index.json Compare-NuGetPackagePayload -ExpectedPackagePath $expectedPackagePath -PublishedPackagePath $signedPackagePath $changedNuspecPath = Join-Path $testRoot 'changed-nuspec.nupkg' - New-TestPackage -Path $changedNuspecPath -PackageId 'LANCommander.Community.Server.Mcp' -Version '0.2.1' -Tags @('changed') + New-TestPackage -Path $changedNuspecPath -PackageId 'LANCommander.Community.Server.Mcp' -Version $testVersion -Tags @('changed') $changedNuspecSignedPath = Join-Path $testRoot 'changed-nuspec-signed.nupkg' New-RepositorySignedTestPackage -SourcePath $changedNuspecPath -DestinationPath $changedNuspecSignedPath Assert-Fails { diff --git a/eng/Test-ReleaseSelection.ps1 b/eng/Test-ReleaseSelection.ps1 index 4e4c3b3..fc6e59a 100644 --- a/eng/Test-ReleaseSelection.ps1 +++ b/eng/Test-ReleaseSelection.ps1 @@ -16,23 +16,23 @@ function Assert-Fails { $single = @(Resolve-PluginSelection -Plugins @('Server.Mcp')) Assert-Equal 'Server.Mcp' $single[0].key 'Single-component selection' -Assert-Equal '0.2.1' $single[0].version 'Single-component version' +Assert-Equal '0.2.2' $single[0].version 'Single-component version' $tag = @(Resolve-PluginSelection -Tag 'launcher-mqtt-v0.2.1') Assert-Equal 'Launcher.MQTT' $tag[0].key 'Component-tag selection' Assert-Equal '0.2.1' $tag[0].version 'Component-tag SemVer' -$quake = @(Resolve-PluginSelection -Tag 'server-quake3-v0.1.0-alpha.1') +$quake = @(Resolve-PluginSelection -Tag 'server-quake3-v0.1.0-beta.1') Assert-Equal 'Server.Quake3' $quake[0].key 'Quake component-tag selection' -Assert-Equal '0.1.0-alpha.1' $quake[0].version 'Quake independent prerelease' +Assert-Equal '0.1.0-beta.1' $quake[0].version 'Quake independent prerelease' Assert-Equal 4 @(Get-PluginRegistry).Count 'Complete component registry' $batch = @(Resolve-PluginSelection -Plugins @('Server.Mcp', 'Server.RecompCatalog', 'Launcher.MQTT')) Assert-Equal @('Server.Mcp', 'Server.RecompCatalog', 'Launcher.MQTT') @($batch | ForEach-Object key) 'Coordinated LC batch' -Assert-Equal @('0.2.1', '0.4.2', '0.2.1') @($batch | ForEach-Object version) 'Independent batch versions' +Assert-Equal @('0.2.2', '0.4.3', '0.2.1') @($batch | ForEach-Object version) 'Independent batch versions' $all = @(Resolve-PluginSelection -Plugins @('Server.Mcp', 'Server.RecompCatalog', 'Launcher.MQTT', 'Server.Quake3')) -Assert-Equal @('0.2.1', '0.4.2', '0.2.1', '0.1.0-alpha.1') @($all | ForEach-Object version) 'Four-component independent versions' +Assert-Equal @('0.2.2', '0.4.3', '0.2.1', '0.1.0-beta.1') @($all | ForEach-Object version) 'Four-component independent versions' $quakeMetadata = @(Get-PluginRegistry | Where-Object key -CEQ 'Server.Quake3')[0] Assert-Equal '2.2.0-beta.4' $quakeMetadata.minimumHostVersion 'Published Quake host API baseline' Assert-Equal '2.2.0-beta.4' $quakeMetadata.hostPackageVersion 'Quake package host baseline' diff --git a/plugins/Launcher.MQTT/CHANGELOG.md b/plugins/Launcher.MQTT/CHANGELOG.md index 1e77b5f..4f5b55d 100644 --- a/plugins/Launcher.MQTT/CHANGELOG.md +++ b/plugins/Launcher.MQTT/CHANGELOG.md @@ -1,19 +1,14 @@ # Changelog -## Unreleased - -- Update the source pin and exact host bounds to released LANCommander - 2.2.0-beta.4. Use `ActionType.Primary` rather than the legacy read-only - primary-action flag, retaining the exactly-one-primary safety check. -- Component versions and existing release artifacts are unchanged. - ## 0.2.1 -Unreleased: package the launcher as `LANCommander.Community.Launcher.MQTT.Plugin` +Package the launcher as `LANCommander.Community.Launcher.MQTT.Plugin` NuGet with `LANCommander.Plugin` and `LANCommander.Plugin.Launcher` types. Build and validate the private payload once, then use the same release artifact for GitHub Packages and optional NuGet.org publication. Retain the verified -LANCommander beta.3 source pin and exact host compatibility range. +LANCommander beta.4 source pin and exact host compatibility range. Launch only +the single `ActionType.Primary` action, retaining the exactly-one-primary safety +check. Store writable settings and the discovery journal in the host-preserved `Data` directory. Existing ZIP users must back up and move both files into `Data` diff --git a/plugins/Launcher.MQTT/README.md b/plugins/Launcher.MQTT/README.md index 14ba0f2..4d5583e 100644 --- a/plugins/Launcher.MQTT/README.md +++ b/plugins/Launcher.MQTT/README.md @@ -7,10 +7,10 @@ The source projects and namespaces use folder now use their project names, including `Plugins/LANCommander.Community.Launcher.MQTT.Plugin`. The persistent plugin ID and `homeassistant.json` configuration identity remain unchanged. Version 0.2.1 -is an unreleased packaging/data-safety update to the published 0.2.0 ZIP -prototype; this change does not publish a release or replace that ZIP. +is the first NuGet release, following the original 0.2.0 ZIP prototype; the +published ZIP and tag remain unchanged. -## Current prototype (0.2.1) +## Current version (0.2.1) Open **Launcher settings > Home Assistant MQTT** to configure broker address/port, username, masked password, optional TLS, stable client ID and topic prefix. @@ -114,7 +114,7 @@ Installation is staged until restart. Releases use GitHub Packages automatically NuGet.org is used only if the release workflow has `NUGET_API_KEY`. Feed visibility/authentication is configured by the user/maintainer, not this plugin. The existing 0.2.0 ZIP is immutable and is not retroactively published -as NuGet. Version 0.2.1 is not published by this change. +as NuGet. Version 0.2.1 uses the beta.4 host baseline. **Existing ZIP installations require preparation before a NuGet upgrade.** The host updater replaces the plugin folder and preserves **only `Data`**. diff --git a/plugins/Server.Mcp/CHANGELOG.md b/plugins/Server.Mcp/CHANGELOG.md index 46cd0fc..b3c53ad 100644 --- a/plugins/Server.Mcp/CHANGELOG.md +++ b/plugins/Server.Mcp/CHANGELOG.md @@ -1,22 +1,21 @@ # Changelog -## Unreleased +## 0.2.2 -- Update host packages and minimum host version to LANCommander 2.2.0-beta.4 - without changing the component version or existing releases. +- Update host packages and minimum host version to LANCommander 2.2.0-beta.4. - The MCP setup page now shows the endpoint derived from LANCommander's address and path base (with an unsaved override), and tabbed, copyable client setup for the GitHub Copilot app, Claude Code, Codex and general MCP clients using - token placeholders or environment variables. Not yet assigned a version. + token placeholders or environment variables. - The **Settings > Integrations > MCP** navigation entry now shows the `Plug` icon. ## 0.2.1 -Unreleased monorepo migration build. Includes the existing MCP setup page and -LANCommander 2.2.0-beta.3 compatibility work. Aligns package and assembly -names with the project; the semantic plugin ID is unchanged. The published -`0.2.0` artifact is not replaced. +Monorepo migration release. Includes the MCP setup page and LANCommander +2.2.0-beta.3 compatibility work. Aligns package and assembly names with the +project; the semantic plugin ID is unchanged. The published `0.2.0` artifact +is not replaced. ## 0.2.0 diff --git a/plugins/Server.Mcp/README.md b/plugins/Server.Mcp/README.md index e9a5e75..72106cb 100644 --- a/plugins/Server.Mcp/README.md +++ b/plugins/Server.Mcp/README.md @@ -29,7 +29,7 @@ pwsh .\eng\Validate-Plugin.ps1 -Plugin Server.Mcp -OutputDirectory "$env:TEMP\se ``` The selected package is written to the output directory as -`LANCommander.Community.Server.Mcp.0.2.1.nupkg`. Upload it through the server's plugin +`LANCommander.Community.Server.Mcp.0.2.2.nupkg`. Upload it through the server's plugin package installer, then restart LANCommander. The package declares `LANCommander.Plugin` and `LANCommander.Plugin.Server` and bundles its private dependencies and dependency manifest under `lib/net10.0`. Host-owned LANCommander @@ -53,8 +53,8 @@ runtime assembly name, and project name now match; the persistent plugin ID is unchanged. Do not copy just the main DLL. Use either manual installation or the package installer, not both. -The published `0.2.0` package is historical and is not replaced by this -repository's development version `0.2.1`. See the repository's +The published `0.2.0` and `0.2.1` packages are historical and are not replaced +by version `0.2.2`. See the repository's [plugin release procedure](../../RELEASES.md) for the current tag, workflow, and publication behavior. diff --git a/plugins/Server.Mcp/version.txt b/plugins/Server.Mcp/version.txt index 0c62199..ee1372d 100644 --- a/plugins/Server.Mcp/version.txt +++ b/plugins/Server.Mcp/version.txt @@ -1 +1 @@ -0.2.1 +0.2.2 diff --git a/plugins/Server.Quake3/CHANGELOG.md b/plugins/Server.Quake3/CHANGELOG.md index 566dbc9..22857c1 100644 --- a/plugins/Server.Quake3/CHANGELOG.md +++ b/plugins/Server.Quake3/CHANGELOG.md @@ -1,9 +1,10 @@ # Changelog -## Unreleased +## 0.1.0-beta.1 -- Update host packages and minimum host version to LANCommander 2.2.0-beta.4 - without changing the component version or existing releases. +- Update host packages and minimum host version to LANCommander 2.2.0-beta.4. +- Retain the host-routed file contracts and validate package loading against the + beta.4 host packages. ## 0.1.0-alpha.1 diff --git a/plugins/Server.Quake3/version.txt b/plugins/Server.Quake3/version.txt index d6711f8..4ab2ff6 100644 --- a/plugins/Server.Quake3/version.txt +++ b/plugins/Server.Quake3/version.txt @@ -1 +1 @@ -0.1.0-alpha.1 +0.1.0-beta.1 diff --git a/plugins/Server.RecompCatalog/CHANGELOG.md b/plugins/Server.RecompCatalog/CHANGELOG.md index 49aff9d..a2344a6 100644 --- a/plugins/Server.RecompCatalog/CHANGELOG.md +++ b/plugins/Server.RecompCatalog/CHANGELOG.md @@ -1,14 +1,13 @@ # Changelog -## Unreleased +## 0.4.3 -- Update host packages and minimum host version to LANCommander 2.2.0-beta.4 - without changing the component version or existing releases. +- Update host packages and minimum host version to LANCommander 2.2.0-beta.4. - Emit the beta.4 `ActionType.Primary` discriminator in generated game manifests. ## 0.4.2 -Unreleased monorepo migration build. Builds against the LANCommander 2.2.0-beta.3 +Monorepo migration release. Builds against the LANCommander 2.2.0-beta.3 dependency baseline. Aligns package and owned assembly names with their project names; the semantic plugin ID is unchanged. diff --git a/plugins/Server.RecompCatalog/README.md b/plugins/Server.RecompCatalog/README.md index f69e713..15b977e 100644 --- a/plugins/Server.RecompCatalog/README.md +++ b/plugins/Server.RecompCatalog/README.md @@ -43,7 +43,7 @@ LANCommander server build that carries the plugin contracts described under verify the hash: ```powershell - $package = 'LANCommander.Community.Server.RecompCatalog.Plugin.0.4.2.nupkg' + $package = 'LANCommander.Community.Server.RecompCatalog.Plugin.0.4.3.nupkg' $expected = (Get-Content "$package.sha256").Split(' ')[0] (Get-FileHash $package -Algorithm SHA256).Hash.ToLowerInvariant() -eq $expected ``` diff --git a/plugins/Server.RecompCatalog/version.txt b/plugins/Server.RecompCatalog/version.txt index 2b7c5ae..17b2ccd 100644 --- a/plugins/Server.RecompCatalog/version.txt +++ b/plugins/Server.RecompCatalog/version.txt @@ -1 +1 @@ -0.4.2 +0.4.3