feat: implement CSVDiscoverer and catalog registry models

GenHub/GenHub.Core/Constants/CsvConstants.cs

@@ -0,0 +1,62 @@
+namespace GenHub.Core.Constants;
+
+/// <summary>
+/// Constants specific to CSV catalog discovery and content pipeline.
+/// </summary>
+public static class CsvConstants
+{
+    /// <summary>
+    /// Source name for the CSV catalog discoverer.
+    /// </summary>
+    public const string SourceName = "Csv Discoverer";
+
+    /// <summary>
+    /// Description for the CSV catalog discoverer.
+    /// </summary>
+    public const string Description = "Discovers base game manifests from verified CSV catalogs.";
+
+    /// <summary>
+    /// Resolver ID for CSV catalog content.
+    /// </summary>
+    public const string ResolverId = "CSVResolver";
+
+    /// <summary>
+    /// Metadata key for the CSV source URL.
+    /// </summary>
+    public const string CsvUrlMetadataKey = "csvUrl";
+
+    /// <summary>
+    /// Metadata key for the game type.
+    /// </summary>
+    public const string GameTypeMetadataKey = "gameType";
+
+    /// <summary>
+    /// Metadata key for the game version.
+    /// </summary>
+    public const string VersionMetadataKey = "version";
+
+    /// <summary>
+    /// Metadata key for the content language.
+    /// </summary>
+    public const string LanguageMetadataKey = "language";
+
+    /// <summary>
+    /// Metadata key for the expected file count.
+    /// </summary>
+    public const string FileCountMetadataKey = "fileCount";
+
+    /// <summary>
+    /// String representation for Generals game type in CSV catalogs.
+    /// </summary>
+    public const string GeneralsGameType = "Generals";
+
+    /// <summary>
+    /// String representation for Zero Hour game type in CSV catalogs.
+    /// </summary>
+    public const string ZeroHourGameType = "ZeroHour";
+
+    /// <summary>
+    /// Special language filter value to include all languages.
+    /// </summary>
+    public const string AllLanguagesFilter = "ALL";
+}

GenHub/GenHub.Core/Interfaces/Common/IAppConfiguration.cs

@@ -1,3 +1,4 @@
+using GenHub.Core.Models.Content;
 using GenHub.Core.Models.Enums;
 using Microsoft.Extensions.Logging;
 
@@ -81,4 +82,10 @@ public interface IAppConfiguration
     /// <summary>Gets the maximum allowed download buffer size in bytes.</summary>
     /// <returns>The maximum buffer size in bytes.</returns>
     int GetMaxDownloadBufferSizeBytes();
+
+    /// <summary>
+    /// Gets the CSV catalog configuration.
+    /// </summary>
+    /// <returns>The CSV catalog configuration.</returns>
+    CsvCatalogConfiguration GetCsvCatalogConfiguration();
 }

GenHub/GenHub.Core/Interfaces/Common/IConfigurationProviderService.cs

@@ -1,4 +1,5 @@
 using GenHub.Core.Models.Common;
+using GenHub.Core.Models.Content;
 using GenHub.Core.Models.Enums;
 using GenHub.Core.Models.Storage;
 
@@ -155,4 +156,10 @@ public interface IConfigurationProviderService
     /// </summary>
     /// <returns>The logs directory path.</returns>
     string GetLogsPath();
+
+    /// <summary>
+    /// Gets the CSV catalog configuration.
+    /// </summary>
+    /// <returns>The CSV catalog configuration.</returns>
+    CsvCatalogConfiguration GetCsvCatalogConfiguration();
 }

GenHub/GenHub.Core/Models/Content/Checksum.cs

@@ -0,0 +1,21 @@
+using System.Text.Json.Serialization;
+
+namespace GenHub.Core.Models.Content;
+
+/// <summary>
+/// Represents checksum information for file integrity verification.
+/// </summary>
+public class Checksum
+{
+    /// <summary>
+    /// Gets or sets the MD5 hash of the file.
+    /// </summary>
+    [JsonPropertyName("md5")]
+    public string Md5 { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the SHA-256 hash of the file.
+    /// </summary>
+    [JsonPropertyName("sha256")]
+    public string Sha256 { get; set; } = string.Empty;
+}

GenHub/GenHub.Core/Models/Content/CsvCatalogConfiguration.cs

@@ -0,0 +1,22 @@
+namespace GenHub.Core.Models.Content;
+
+/// <summary>
+/// Configuration for CSV Catalog discovery.
+/// Binds to "CsvValidationCatalogs" and "GenHub:IndexFilePath" in configuration.
+/// Refers to the <see cref="IndexFilePath"/> property.
+/// </summary>
+public class CsvCatalogConfiguration
+{
+    /// <summary>
+    /// Gets or sets the list of fallback validation catalogs defined in configuration.
+    /// Used when index.json cannot be reached.
+    /// </summary>
+    public List<CsvValidationCatalog> CsvValidationCatalogs { get; set; } = [];
+
+    /// <summary>
+    /// Gets or sets the path to the index.json file.
+    /// If a relative path is provided, it is resolved relative to the application's working directory;
+    /// absolute paths are used as given. The expected file is index.json.
+    /// </summary>
+    public string IndexFilePath { get; set; } = "docs/GameInstallationFilesRegistry/index.json";
+}

GenHub/GenHub.Core/Models/Content/CsvCatalogRegistryEntry.cs

@@ -0,0 +1,76 @@
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+namespace GenHub.Core.Models.Content;
+
+/// <summary>
+/// Represents a single CSV catalog entry in the registry.
+/// </summary>
+public class CsvCatalogRegistryEntry
+{
+    /// <summary>
+    /// Gets or sets the unique identifier for this registry entry.
+    /// </summary>
+    [JsonPropertyName("id")]
+    public string Id { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the URL to the CSV file.
+    /// </summary>
+    [JsonPropertyName("url")]
+    public string Url { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the game type (e.g., "Generals", "ZeroHour").
+    /// </summary>
+    [JsonPropertyName("gameType")]
+    public string GameType { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the game version (e.g., "1.08", "1.04").
+    /// </summary>
+    [JsonPropertyName("version")]
+    public string Version { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the list of supported languages in this CSV.
+    /// </summary>
+    [JsonPropertyName("languages")]
+    public List<string> SupportedLanguages { get; set; } = [];
+
+    /// <summary>
+    /// Gets or sets the optional file count in the CSV.
+    /// </summary>
+    [JsonPropertyName("fileCount")]
+    public int? FileCount { get; set; }
+
+    /// <summary>
+    /// Gets or sets the total size of the CSV file in bytes.
+    /// </summary>
+    [JsonPropertyName("totalSizeBytes")]
+    public long TotalSizeBytes { get; set; }
+
+    /// <summary>
+    /// Gets or sets the checksum information for integrity verification.
+    /// </summary>
+    [JsonPropertyName("checksum")]
+    public Checksum? Checksum { get; set; }
+
+    /// <summary>
+    /// Gets or sets when this registry entry was generated.
+    /// </summary>
+    [JsonPropertyName("generatedAt")]
+    public DateTime? GeneratedAt { get; set; }
+
+    /// <summary>
+    /// Gets or sets the version of the generator that created this entry.
+    /// </summary>
+    [JsonPropertyName("generatorVersion")]
+    public string GeneratorVersion { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether this registry entry is active.
+    /// </summary>
+    [JsonPropertyName("isActive")]
+    public bool IsActive { get; set; }
+}

GenHub/GenHub.Core/Models/Content/CsvCatalogRegistryIndex.cs

@@ -0,0 +1,36 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+
+namespace GenHub.Core.Models.Content;
+
+/// <summary>
+/// Index of available CSV catalog registries.
+/// Represents the structure of the docs/GameInstallationFilesRegistry/index.json file.
+/// </summary>
+public class CsvCatalogRegistryIndex
+{
+    /// <summary>
+    /// Gets or sets the schema version.
+    /// </summary>
+    [JsonPropertyName("version")]
+    public string Version { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets when the index was last updated.
+    /// </summary>
+    [JsonPropertyName("lastUpdated")]
+    public DateTime? LastUpdatedAt { get; set; }
+
+    /// <summary>
+    /// Gets or sets the description of this registry index.
+    /// </summary>
+    [JsonPropertyName("description")]
+    public string Description { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the list of available catalog entries.
+    /// </summary>
+    [JsonPropertyName("registries")]
+    public List<CsvCatalogRegistryEntry> Entries { get; set; } = [];
+}

GenHub/GenHub.Core/Models/Content/CsvValidationCatalog.cs

@@ -0,0 +1,35 @@
+using System.Collections.Generic;
+
+namespace GenHub.Core.Models.Content;
+
+/// <summary>
+/// Represents a CSV catalog defined in appsettings.json.
+/// Matches the structure of CsvCatalogRegistryEntry but optimized for config binding.
+/// </summary>
+public class CsvValidationCatalog
+{
+    /// <summary>
+    /// Gets or sets the URL to the CSV file.
+    /// </summary>
+    public string Url { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the game type.
+    /// </summary>
+    public string GameType { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the version string.
+    /// </summary>
+    public string Version { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the supported languages.
+    /// </summary>
+    public List<string> SupportedLanguages { get; set; } = [];
+
+    /// <summary>
+    /// Gets or sets the file count.
+    /// </summary>
+    public int? FileCount { get; set; }
+}