feat: complete download acquisition, publisher catalog browsing, and dependency management

.github/workflows/gitnexus.yml

@@ -33,6 +33,8 @@ jobs:
     name: GitNexus Index & Artifact
     runs-on: ubuntu-latest
     timeout-minutes: 10
+    env:
+      NODE_OPTIONS: "--dns-result-order=ipv4first"
 
     steps:
       - name: Checkout Code

.gitignore

@@ -5,6 +5,8 @@
 .*
 !.github/
 !.gitignore
+!.gitattributes
+!**/.gitattributes
 !.agents/
 !.claude/
 

GenHub/Directory.Packages.props

@@ -5,8 +5,7 @@
   </PropertyGroup>
   <ItemGroup>
     <!-- Avalonia packages -->
-    <!-- Important: keep version in sync! -->
-    <PackageVersion Include="AngleSharp" Version="1.5.0" />
+    <PackageVersion Include="AngleSharp" Version="1.5.2" />
     <PackageVersion Include="Avalonia" Version="11.2.7" />
     <PackageVersion Include="Avalonia.Desktop" Version="11.2.7" />
     <PackageVersion Include="Avalonia.Themes.Fluent" Version="11.2.7" />
@@ -56,4 +55,4 @@
     <PackageVersion Include="HeyRed.ImageSharp.Heif" Version="2.1.3" />
     <PackageVersion Include="LibHeif.Native" Version="1.15.1" />
   </ItemGroup>
-</Project>
+</Project>

GenHub/GenHub.Core/Constants/AODMapsConstants.cs

@@ -3,7 +3,7 @@
 namespace GenHub.Core.Constants;
 
 /// <summary>
-/// Constants for AODMaps (Age of Defense Maps) provider.
+/// Constants for AODMaps (Art of Defense Maps) provider.
 /// </summary>
 [SuppressMessage("Minor Code Smell", "S1075:URIs should not be hardcoded", Justification = "Centralized URI constants / mock demo paths")]
 [SuppressMessage("Minor Code Smell", "S101:Types should be named in PascalCase", Justification = "Domain acronym")]
@@ -19,7 +19,7 @@ public static class AODMapsConstants
     public const string DiscovererSourceName = "AODMaps";
 
     /// <summary>Gets the discoverer description.</summary>
-    public const string DiscovererDescription = "Age of Defense Maps";
+    public const string DiscovererDescription = "Art of Defense Maps";
 
     /// <summary>Gets the resolver ID for AODMaps.</summary>
     public const string ResolverId = "AODMaps";
@@ -117,6 +117,9 @@ public static class AODMapsConstants
     /// <summary>Gets the download URL metadata key.</summary>
     public const string DownloadUrlMetadataKey = "downloadUrl";
 
+    /// <summary>Gets the list page URL metadata key.</summary>
+    public const string ListPageUrlMetadataKey = "listPageUrl";
+
     /// <summary>Gets the direct download metadata key.</summary>
     public const string DirectDownloadMetadataKey = "directDownload";
 
@@ -126,6 +129,30 @@ public static class AODMapsConstants
     /// <summary>Gets the download count metadata key.</summary>
     public const string DownloadCountMetadataKey = "downloadCount";
 
+    /// <summary>Gets the player count metadata key.</summary>
+    public const string PlayerCountMetadataKey = ContentConstants.PlayerCountMetadataKey;
+
+    /// <summary>Gets the category metadata key used for download-card badges and combined filtering.</summary>
+    public const string CategoryMetadataKey = ContentConstants.CategoryMetadataKey;
+
+    /// <summary>Filter / badge label for Compstomp maps.</summary>
+    public const string CategoryCompstomp = "Compstomp";
+
+    /// <summary>Filter / badge label for map packs.</summary>
+    public const string CategoryMapPacks = "Map Packs";
+
+    /// <summary>Filter / badge label for air maps.</summary>
+    public const string CategoryAir = "Air";
+
+    /// <summary>Filter / badge label for race maps.</summary>
+    public const string CategoryRace = "Race";
+
+    /// <summary>Filter / badge label for Art of Attack maps.</summary>
+    public const string CategoryAoa = "AOA";
+
+    /// <summary>Filter / badge label for Contra AOD maps.</summary>
+    public const string CategoryContra = "Contra";
+
     /// <summary>Gets the last updated metadata key.</summary>
     public const string LastUpdatedMetadataKey = "lastUpdated";
 

GenHub/GenHub.Core/Constants/AppUpdateConstants.cs

@@ -173,6 +173,28 @@ public static class AppUpdateConstants
         "3. Launch the installed version (will be in %LOCALAPPDATA%\\GenHub)\n\n" +
         "Update available: v{1}";
 
+    /// <summary>
+    /// Default update notification title.
+    /// </summary>
+    public const string UpdateNotificationTitle = "Update Available";
+
+    /// <summary>
+    /// Update available notification message format.
+    /// {0}: Version.
+    /// </summary>
+    public const string UpdateAvailableMessageFormat = "A new version ({0}) is available.";
+
+    /// <summary>
+    /// Branch/Artifact update notification title.
+    /// </summary>
+    public const string BranchUpdateNotificationTitle = "Branch Update Available";
+
+    /// <summary>
+    /// Branch update available notification message format.
+    /// {0}: Version, {1}: Branch.
+    /// </summary>
+    public const string BranchUpdateAvailableMessageFormat = "A new build ({0}) is available on branch '{1}'.";
+
     /// <summary>
     /// Update available notification title for release channel.
     /// </summary>
@@ -214,7 +236,7 @@ public static class AppUpdateConstants
     public const string UpdateFailedNotificationFormat = "Failed to install update: {0}";
 
     /// <summary>
-    /// View updates action button text.
+    /// "View Updates" action text.
     /// </summary>
     public const string ViewUpdatesAction = "View Updates";
 

GenHub/GenHub.Core/Constants/CatalogConstants.cs

@@ -1,8 +1,26 @@
 namespace GenHub.Core.Constants;
 
 /// <summary>
-/// Constants for publisher catalog system.
+/// Constants for the modular publisher-catalog system.
 /// </summary>
+/// <remarks>
+/// Layering (see Publisher Studio architecture):
+/// <list type="bullet">
+/// <item>
+/// <b>Provider Definition</b> — static publisher metadata + catalog endpoint(s)
+/// (bundled <c>*.provider.json</c> today; user-hosted definitions via Publisher Studio later).
+/// </item>
+/// <item>
+/// <b>Catalog</b> — dynamic content listing (<c>catalog.json</c> / remote endpoint), updated on each release.
+/// </item>
+/// <item>
+/// <b>Artifacts</b> — downloadable files referenced by catalog releases.
+/// </item>
+/// </list>
+/// Anyone can author a GenHub-schema catalog, host it, and share
+/// <c>genhub://subscribe?url=...</c>. Discovery uses <see cref="GenericCatalogResolverId"/>
+/// for catalog-direct subscriptions without per-publisher code.
+/// </remarks>
 public static class CatalogConstants
 {
     /// <summary>
@@ -11,12 +29,17 @@ public static class CatalogConstants
     public const int CatalogSchemaVersion = 1;
 
     /// <summary>
-    /// Filename for subscriptions storage.
+    /// Filename for user subscription storage under application data.
     /// </summary>
     public const string SubscriptionFileName = "subscriptions.json";
 
     /// <summary>
-    /// Resolver ID for generic catalog resolver.
+    /// Sidebar / discoverer category for user-subscribed catalogs (vs built-in static/dynamic).
+    /// </summary>
+    public const string SubscribedPublisherCategory = "subscribed";
+
+    /// <summary>
+    /// Resolver / pipeline ID for the generic catalog pipeline (any GenHub-schema catalog).
     /// </summary>
     public const string GenericCatalogResolverId = "generic-catalog";
 
@@ -29,4 +52,44 @@ public static class CatalogConstants
     /// Maximum catalog size in bytes (10 MB).
     /// </summary>
     public const long MaxCatalogSizeBytes = 10 * 1024 * 1024;
+
+    /// <summary>
+    /// Maximum number of entries allowed when extracting publisher catalog archives.
+    /// </summary>
+    public const int MaxZipEntryCount = 50_000;
+
+    /// <summary>
+    /// Maximum cumulative uncompressed size allowed when extracting publisher catalog archives (5 GB).
+    /// </summary>
+    public const long MaxZipUncompressedSizeBytes = 5L * 1024 * 1024 * 1024;
+
+    /// <summary>
+    /// Resolver metadata key for serialized publisher profile JSON.
+    /// </summary>
+    public const string PublisherProfileJsonMetadataKey = "publisherProfileJson";
+
+    /// <summary>
+    /// Resolver metadata key for serialized catalog item JSON.
+    /// </summary>
+    public const string CatalogItemJsonMetadataKey = "catalogItemJson";
+
+    /// <summary>
+    /// Resolver metadata key for serialized release JSON.
+    /// </summary>
+    public const string ReleaseJsonMetadataKey = "releaseJson";
+
+    /// <summary>
+    /// Resolver metadata key for the stable catalog content id (not the display name).
+    /// </summary>
+    public const string CatalogContentIdMetadataKey = "catalogContentId";
+
+    /// <summary>
+    /// Resolver metadata key for serialized bundle component descriptors.
+    /// </summary>
+    public const string BundleComponentsJsonMetadataKey = "bundleComponentsJson";
+
+    /// <summary>
+    /// Resolver metadata key for serialized publisher referrals JSON.
+    /// </summary>
+    public const string CatalogReferralsJsonMetadataKey = "catalogReferralsJson";
 }

GenHub/GenHub.Core/Constants/CncLabsConstants.cs

@@ -117,24 +117,19 @@ public static class CNCLabsConstants
     public const string QueryStringIdParameter = "id";
 
     /// <summary>
-    /// CSS selector for a single downloadable item container on list pages.
+    /// CSS selector for a single downloadable item container on list pages (2026 Bootstrap redesign).
     /// </summary>
-    public const string ListItemSelector = "div.DownloadItem";
+    public const string ListItemSelector = "div.list-group-item";
 
     /// <summary>
-    /// CSS selector for the hidden input that carries the map's numeric File Id.
+    /// CSS selector for the anchor with the display name of the map (2026 Bootstrap redesign).
     /// </summary>
-    public const string FileIdHiddenSelector = "input[type='hidden'][id$='FileIdField']";
+    public const string DisplayNameAnchorSelector = "h5 a[href*='/downloads/details/']";
 
     /// <summary>
-    /// CSS selector for the anchor with the display name of the map.
+    /// CSS selector for the element that contains the short description (2026 Bootstrap redesign).
     /// </summary>
-    public const string DisplayNameAnchorSelector = "a.DisplayName";
-
-    /// <summary>
-    /// CSS selector for the element that contains the short description.
-    /// </summary>
-    public const string DescriptionSelector = "span[id$='DescriptionLabel']";
+    public const string DescriptionSelector = "div.mb-1.text-muted.small";
 
     /// <summary>
     /// CSS selector for bold labels inside the item description cell (used to locate the "Author:" label).

GenHub/GenHub.Core/Constants/CommunityOutpostCatalogConstants.cs

@@ -15,7 +15,10 @@ public static class CommunityOutpostCatalogConstants
     public const string UnknownVersion = "unknown";
 
     /// <summary>Default base URL for making relative URLs absolute.</summary>
-    public const string DefaultBaseUrl = "https://legi.cc/patch";
+    public const string DefaultBaseUrl = CommunityOutpostConstants.BaseUrl + "/patch";
+
+    /// <summary>Default base URL for downloading GenPatcher content .dat packages.</summary>
+    public const string DefaultFilesBaseUrl = CommunityOutpostConstants.BaseUrl + "/gp2/f";
 
     /// <summary>Metadata key for the content code.</summary>
     public const string ContentCodeKey = "contentCode";

GenHub/GenHub.Core/Constants/CommunityOutpostConstants.cs

@@ -10,9 +10,14 @@ namespace GenHub.Core.Constants;
 /// Endpoint URLs and timeouts are configured via data-driven configuration.
 /// See <c>Providers/communityoutpost.provider.json</c> for runtime-configurable values.
 /// </remarks>
-[SuppressMessage("Minor Code Smell", "S1075:URIs should not be hardcoded", Justification = "Centralized URI constants / mock demo paths")]
+[SuppressMessage("Minor Code Smell", "S1075:URIs should not be hardcoded", Justification = "Default base URL for Community Outpost service")]
 public static class CommunityOutpostConstants
 {
+    /// <summary>
+    /// Base URL for Community Outpost / GenPatcher service.
+    /// </summary>
+    public const string BaseUrl = "https://legi.cc";
+
     /// <summary>
     /// The publisher ID for Community Outpost.
     /// </summary>
@@ -53,6 +58,11 @@ public static class CommunityOutpostConstants
     /// </summary>
     public const string ContentName = "Community Patch";
 
+    /// <summary>
+    /// Tag and content code for Community Patch items.
+    /// </summary>
+    public const string CommunityPatchTag = "community-patch";
+
     /// <summary>
     /// Description for the discoverer.
     /// </summary>

GenHub/GenHub.Core/Constants/ContentConstants.cs

@@ -94,4 +94,31 @@ public static class ContentConstants
     /// Maximum allowed size for the content catalog in bytes (10 MB).
     /// </summary>
     public const long MaxCatalogSizeBytes = 10 * ConversionConstants.BytesPerMegabyte;
+
+    /// <summary>
+    /// Shared resolver/display metadata key for map player counts.
+    /// Builtin and catalog publishers should set this so download cards can render a consistent badge.
+    /// </summary>
+    public const string PlayerCountMetadataKey = "playerCount";
+
+    /// <summary>
+    /// Shared resolver/display metadata key for content categories (AOA, Compstomp, ModDB category, etc.).
+    /// </summary>
+    public const string CategoryMetadataKey = "category";
+
+    /// <summary>
+    /// Display metadata key for a comma-separated list of included/required content names
+    /// (e.g. catalog ContentBundle dependencies resolved to friendly titles).
+    /// </summary>
+    public const string IncludesSummaryMetadataKey = "includesSummary";
+
+    /// <summary>
+    /// Number of recent releases and addons to eagerly preload extended details for.
+    /// </summary>
+    public const int PreloadRecentItemsLimit = 5;
+
+    /// <summary>
+    /// Maximum concurrent background requests when preloading recent item details.
+    /// </summary>
+    public const int PreloadConcurrencyLimit = 3;
 }

GenHub/GenHub.Core/Constants/DirectoryNames.cs

@@ -93,4 +93,19 @@ public static class DirectoryNames
     /// Directory for storing tool workspaces.
     /// </summary>
     public const string ToolWorkspaces = "ToolWorkspaces";
+
+    /// <summary>
+    /// Directory for persistent Playwright browser profiles (cookies/storage for bot-protected sites).
+    /// </summary>
+    public const string BrowserProfiles = "BrowserProfiles";
+
+    /// <summary>
+    /// Directory for the app-owned Playwright Chromium runtime (not the system Chrome/Edge install).
+    /// </summary>
+    public const string BrowserRuntime = "BrowserRuntime";
+
+    /// <summary>
+    /// Directory for game movie assets.
+    /// </summary>
+    public const string Movies = "Movies";
 }

GenHub/GenHub.Core/Constants/GameClientConstants.cs

@@ -78,6 +78,12 @@ public static class GameClientConstants
     /// <summary>Primary Generals Vanilla Patch archive filename.</summary>
     public const string GeneralsPatchBig = "Patch.big";
 
+    /// <summary>Generals Vanilla security archive filename.</summary>
+    public const string GeneralsSecurityBig = "gensec.big";
+
+    /// <summary>Zero Hour archive extension suffix.</summary>
+    public const string ZeroHourArchiveExtensionSuffix = "ZH.big";
+
     // ===== GeneralsOnline Client Detection =====
 
     /// <summary>GeneralsOnline 60Hz client executable name.</summary>