Skip to content

Normalize plugin identities and add plugin creation skills - #13

Merged
aaronpowell merged 1 commit into
mainfrom
aaronpowell-normalize-plugin-naming-skills
Nov 19, 2026
Merged

aaronpowell merged 1 commit into
mainfrom
aaronpowell-normalize-plugin-naming-skills

Conversation

@aaronpowell

Copy link
Copy Markdown
Collaborator

Summary

  • Enforce LANCommander.Community.<Server|Launcher>.<Name> for installable project, package, assembly and root namespace identities. Remove .Plugin from RecompCatalog and MQTT entry projects/directories, emitted assemblies and NuGet package IDs; retain component-root suffixes for non-packable helpers/tests.
  • Keep registry, solution/project references, C#/Razor namespaces, package inventory/loader checks, release tooling and installation documentation consistent. Add naming regression guards so .Plugin entry identities cannot return.
  • Add focused .github/skills/create-server-plugin/SKILL.md and .github/skills/create-launcher-plugin/SKILL.md, plus authoring/navigation updates and skill frontmatter/link validation. Guidance covers verified host contracts, packaging, storage/auth/UI boundaries, registry integration and release gates.
  • Align package metadata and guarded publication targets with the transferred canonical LANCommander/LANCommander.Community repository.

Identity and version transitions

Component New project/package/assembly identity Next version
RecompCatalog LANCommander.Community.Server.RecompCatalog (was suffixed .Plugin) 0.4.4
MQTT LANCommander.Community.Launcher.MQTT (was suffixed .Plugin; root namespace already canonical) 0.2.2
MCP LANCommander.Community.Server.Mcp (unchanged) 0.2.3
Quake3 LANCommander.Community.Server.Quake3 (unchanged) 0.1.0-beta.2

Published RecompCatalog .Plugin 0.4.2/0.4.3, MQTT .Plugin 0.2.1 and the MQTT 0.2.0 ZIP remain immutable, including their tags/assets. RecompCatalog and MQTT are new feed identities, not automatic updates to the old IDs. Their READMEs document stopped-host backup/replacement, transfer of Data, removal of old entry assemblies and rollback. Semantic plugin IDs, configuration/data IDs, imported data, MQTT client/topics and Home Assistant entity identities stay unchanged; no automatic cross-ID migration is introduced.

MCP and Quake3 advance only to avoid reusing published versions after canonical repository metadata changes. No release tags or packages have been published by this work.

Validation

  • Full solution dotnet build .\LANCommander.Community.slnx -c Release.
  • eng/Test-ReleaseSelection.ps1, eng/Test-Repository.ps1 (four components/five skills), eng/Test-ReleaseDestinations.ps1, eng/Test-NuGetPublication.ps1, and eng/Test-GitHubPackages.ps1.
  • Full eng/Validate-Plugin.ps1 Release validation for all four components: unit/integration tests, emitted NuGet metadata, private payload inventory and actual packaged assembly loading. MCP additionally exercises HTTP contracts from the extracted package; RecompCatalog verifies shared host/UI type identity.
  • Launcher source-pin/host loader, package discovery/install/update Data preservation, wrong-host/version rejection, and Home Assistant template checks including 15,000 UUIDv4 requests. MCP Node tests also pass.
  • Repacked and revalidated MCP/MQTT after final packaged-documentation edits.

Existing upstream host/dependency warnings remain. Automated checks do not claim a live GUI installation or real Home Assistant smoke test; those were not performed.

Remove .Plugin from RecompCatalog and MQTT entry projects, packages and assemblies while preserving persistent IDs. Document explicit package replacement and advance versions without modifying published artifacts. Align canonical repository metadata and add creation skills plus registry and packaged-loader guards.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@aaronpowell
aaronpowell merged commit 77e48e6 into main Nov 19, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant