feat(replay-manager): add automatic replay saving

GenHub/GenHub.Core/Constants/ReplayManagerConstants.cs

@@ -29,4 +29,72 @@ public static class ReplayManagerConstants
     /// Default file name for imported replays.
     /// </summary>
     public const string DefaultImportedReplayFileName = "imported_replay.rep";
-}
+
+    /// <summary>
+    /// Name of the subdirectory for auto-saved replays.
+    /// </summary>
+    public const string SavedReplaysDirectoryName = "Saved";
+
+    /// <summary>
+    /// Default replay file name that gets overwritten by the game.
+    /// </summary>
+    public const string DefaultReplayFileName = "00000000.rep";
+
+    /// <summary>
+    /// Interval in milliseconds for checking file stability.
+    /// </summary>
+    public const int FileStabilityCheckIntervalMs = 2000;
+
+    /// <summary>
+    /// Number of consecutive stability checks required before considering file complete.
+    /// </summary>
+    public const int FileStabilityCheckCount = 3;
+
+    /// <summary>
+    /// Minimum file size in bytes to consider a replay valid (10 KB).
+    /// </summary>
+    public const long MinimumReplayFileSizeBytes = 10 * 1024;
+
+    /// <summary>
+    /// Magic bytes for replay file header validation.
+    /// </summary>
+    public const string ReplayMagicBytes = "GENREP";
+
+    /// <summary>
+    /// Date format for auto-saved replay filenames.
+    /// </summary>
+    public const string SavedReplayDateFormat = "yyyyMMdd_HHmmss";
+
+    /// <summary>
+    /// Grace period in seconds to allow stability checks to complete before stopping monitoring.
+    /// Calculated as: (FileStabilityCheckCount × FileStabilityCheckIntervalMs / 1000) + buffer
+    /// = (3 × 2000ms / 1000) + 8s buffer = 14s total
+    /// This accounts for the full stability check cycle plus OS flush delays on slow systems.
+    /// </summary>
+    public const int StopMonitoringGracePeriodSeconds = 14;
+
+    /// <summary>
+    /// Maximum number of retry attempts when saving a replay file encounters an I/O conflict.
+    /// </summary>
+    public const int SaveRetryMaxAttempts = 3;
+
+    /// <summary>
+    /// Maximum byte length for reading null-terminated strings from replay files.
+    /// </summary>
+    public const int MaxStringReadBytes = 4096;
+
+    /// <summary>
+    /// Maximum number of uniqueness suffix attempts when finding a non-colliding file path.
+    /// </summary>
+    public const int MaxUniquePathAttempts = 1000;
+
+    /// <summary>
+    /// Maximum number of players included in auto-save filename components.
+    /// </summary>
+    public const int MaxPlayersInSavedFileName = 4;
+
+    /// <summary>
+    /// Maximum filename length in bytes (Windows/most POSIX filesystems).
+    /// </summary>
+    public const int MaxFileNameLength = 255;
+}

GenHub/GenHub.Core/Interfaces/Tools/ReplayManager/IReplayMonitorService.cs

@@ -0,0 +1,58 @@
+using GenHub.Core.Models.Enums;
+using GenHub.Core.Models.Events;
+
+namespace GenHub.Core.Interfaces.Tools.ReplayManager;
+
+/// <summary>
+/// Service for monitoring replay files and automatically saving them.
+/// </summary>
+public interface IReplayMonitorService
+{
+    /// <summary>
+    /// Event raised when a replay file has been completed and saved.
+    /// </summary>
+    event EventHandler<ReplayCompletedEventArgs>? ReplayCompleted;
+
+    /// <summary>
+    /// Starts monitoring for a specific profile.
+    /// </summary>
+    /// <param name="profileId">The profile ID.</param>
+    /// <param name="gameType">The game type.</param>
+    /// <returns>A task representing the asynchronous operation.</returns>
+    Task StartMonitoringAsync(string profileId, GameType gameType);
+
+    /// <summary>
+    /// Stops monitoring for a specific profile.
+    /// </summary>
+    /// <param name="profileId">The profile ID.</param>
+    /// <returns>A task representing the asynchronous operation.</returns>
+    Task StopMonitoringAsync(string profileId);
+
+    /// <summary>
+    /// Stops all active monitoring.
+    /// </summary>
+    /// <returns>A task representing the asynchronous operation.</returns>
+    Task StopAllMonitoringAsync();
+
+    /// <summary>
+    /// Stops monitoring for a specific profile, verifying session identity.
+    /// </summary>
+    /// <param name="profileId">The profile ID.</param>
+    /// <param name="sessionId">If provided, only stops if the active session matches this ID.</param>
+    /// <returns>A task representing the asynchronous operation.</returns>
+    Task StopMonitoringAsync(string profileId, string? sessionId);
+
+    /// <summary>
+    /// Gets a value indicating whether monitoring is active for a profile.
+    /// </summary>
+    /// <param name="profileId">The profile ID.</param>
+    /// <returns>True if monitoring is active; otherwise, false.</returns>
+    bool IsMonitoring(string profileId);
+
+    /// <summary>
+    /// Gets the session ID for an active monitoring session.
+    /// </summary>
+    /// <param name="profileId">The profile ID.</param>
+    /// <returns>The session ID, or null if not monitoring.</returns>
+    string? GetSessionId(string profileId);
+}

GenHub/GenHub.Core/Models/Events/ReplayCompletedEventArgs.cs

@@ -0,0 +1,24 @@
+using GenHub.Core.Models.Tools.ReplayManager;
+
+namespace GenHub.Core.Models.Events;
+
+/// <summary>
+/// Event arguments for replay completion.
+/// </summary>
+public sealed class ReplayCompletedEventArgs : EventArgs
+{
+    /// <summary>
+    /// Gets the profile ID.
+    /// </summary>
+    public required string ProfileId { get; init; }
+
+    /// <summary>
+    /// Gets the saved replay file path.
+    /// </summary>
+    public required string SavedFilePath { get; init; }
+
+    /// <summary>
+    /// Gets the replay metadata.
+    /// </summary>
+    public required ReplayMetadata Metadata { get; init; }
+}

GenHub/GenHub.Core/Models/Events/ReplayFileCompletedEventArgs.cs

@@ -0,0 +1,12 @@
+namespace GenHub.Core.Models.Events;
+
+/// <summary>
+/// Event arguments for replay file completion.
+/// </summary>
+public sealed class ReplayFileCompletedEventArgs : EventArgs
+{
+    /// <summary>
+    /// Gets the completed file path.
+    /// </summary>
+    public required string FilePath { get; init; }
+}

GenHub/GenHub.Core/Models/GameProfile/CreateProfileRequest.cs

@@ -53,6 +53,9 @@ public class CreateProfileRequest
     /// <summary>Gets or sets the command line arguments to pass to the game executable.</summary>
     public string? CommandLineArguments { get; set; }
 
+    /// <summary>Gets or sets a value indicating whether to automatically save replays for this profile.</summary>
+    public bool AutoSaveReplays { get; set; }
+
     /// <summary>Gets or sets the IP address for GameSpy/Networking services.</summary>
     public string? GameSpyIPAddress { get; set; }
 

GenHub/GenHub.Core/Models/GameProfile/GameProfile.cs

@@ -211,6 +211,11 @@ public class GameProfile : IGameProfile
     /// <summary>Gets or sets a value indicating whether props are shown.</summary>
     public bool? VideoShowProps { get; set; }
 
+    // ===== GenHub Features =====
+
+    /// <summary>Gets or sets a value indicating whether to automatically save replays for this profile.</summary>
+    public bool AutoSaveReplays { get; set; }
+
     // ===== TheSuperHackers Client Settings =====
 
     /// <summary>Gets or sets a value indicating whether to archive replays automatically (TSH).</summary>

GenHub/GenHub.Core/Models/GameProfile/UpdateProfileRequest.cs

@@ -90,6 +90,11 @@ public class UpdateProfileRequest
     /// </summary>
     public string? CommandLineArguments { get; set; }
 
+    /// <summary>
+    /// Gets or sets a value indicating whether to automatically save replays for this profile.
+    /// </summary>
+    public bool? AutoSaveReplays { get; set; }
+
     /// <summary>
     /// Gets or sets the video resolution width for this profile.
     /// </summary>

GenHub/GenHub.Core/Models/Tools/ReplayManager/PlayerInfo.cs

@@ -0,0 +1,42 @@
+namespace GenHub.Core.Models.Tools.ReplayManager;
+
+/// <summary>
+/// Information about a player in a replay.
+/// </summary>
+public sealed class PlayerInfo
+{
+    /// <summary>
+    /// Gets the player name.
+    /// </summary>
+    public required string Name { get; init; }
+
+    /// <summary>
+    /// Gets the player type (Human or AI).
+    /// </summary>
+    public required PlayerType Type { get; init; }
+
+    /// <summary>
+    /// Gets the faction/side (e.g., USA, China, GLA).
+    /// </summary>
+    public string? Faction { get; init; }
+
+    /// <summary>
+    /// Gets the team number.
+    /// </summary>
+    public int? Team { get; init; }
+
+    /// <summary>
+    /// Gets the player color.
+    /// </summary>
+    public string? Color { get; init; }
+
+    /// <summary>
+    /// Gets the AI difficulty (for AI players).
+    /// </summary>
+    public string? AiDifficulty { get; init; }
+
+    /// <summary>
+    /// Gets the starting position/slot number.
+    /// </summary>
+    public int? StartPosition { get; init; }
+}

GenHub/GenHub.Core/Models/Tools/ReplayManager/PlayerType.cs

@@ -0,0 +1,22 @@
+namespace GenHub.Core.Models.Tools.ReplayManager;
+
+/// <summary>
+/// Player type enumeration.
+/// </summary>
+public enum PlayerType
+{
+    /// <summary>
+    /// Human player.
+    /// </summary>
+    Human,
+
+    /// <summary>
+    /// AI/Computer player.
+    /// </summary>
+    Computer,
+
+    /// <summary>
+    /// Observer/spectator.
+    /// </summary>
+    Observer,
+}

GenHub/GenHub.Core/Models/Tools/ReplayManager/ReplayMetadata.cs

@@ -1,7 +1,9 @@
+using GenHub.Core.Models.Enums;
+
 namespace GenHub.Core.Models.Tools.ReplayManager;
 
 /// <summary>
-/// Placeholder for future replay parsing feature.
+/// Metadata extracted from a replay file.
 /// </summary>
 public sealed class ReplayMetadata
 {
@@ -11,9 +13,9 @@ public sealed class ReplayMetadata
     public string? MapName { get; init; }
 
     /// <summary>
-    /// Gets the list of players.
+    /// Gets the list of player information.
     /// </summary>
-    public IReadOnlyList<string>? Players { get; init; }
+    public IReadOnlyList<PlayerInfo>? Players { get; init; }
 
     /// <summary>
     /// Gets the game duration.
@@ -24,4 +26,54 @@ public sealed class ReplayMetadata
     /// Gets the date the game was played.
     /// </summary>
     public DateTime? GameDate { get; init; }
-}
+
+    /// <summary>
+    /// Gets the game type (Generals or Zero Hour).
+    /// </summary>
+    public GameType? GameType { get; init; }
+
+    /// <summary>
+    /// Gets the file size in bytes.
+    /// </summary>
+    public long FileSizeBytes { get; init; }
+
+    /// <summary>
+    /// Gets a value indicating whether the replay was successfully parsed.
+    /// </summary>
+    public bool IsParsed { get; init; }
+
+    /// <summary>
+    /// Gets the original file path.
+    /// </summary>
+    public string? OriginalFilePath { get; init; }
+
+    /// <summary>
+    /// Gets the game mode (e.g., Skirmish, Online).
+    /// </summary>
+    public string? GameMode { get; init; }
+
+    /// <summary>
+    /// Gets the game version string.
+    /// </summary>
+    public string? GameVersion { get; init; }
+
+    /// <summary>
+    /// Gets the build date string.
+    /// </summary>
+    public string? BuildDate { get; init; }
+
+    /// <summary>
+    /// Gets the starting credits for the match.
+    /// </summary>
+    public int? StartingCredits { get; init; }
+
+    /// <summary>
+    /// Gets whether fog of war was enabled.
+    /// </summary>
+    public bool? FogOfWar { get; init; }
+
+    /// <summary>
+    /// Gets the game speed setting.
+    /// </summary>
+    public string? GameSpeed { get; init; }
+}