Configuration Migration Utilities (#262)

* Initial plan

* Add ConfigurationMigration utilities, Version fields in config classes, and tests

Co-authored-by: michaelbeale-IL <63321611+michaelbeale-IL@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: michaelbeale-IL <63321611+michaelbeale-IL@users.noreply.github.com>

Author: Copilot

src/Libraries/ACATCore.Tests.Configuration/ConfigurationMigrationTests.cs

@@ -271,6 +271,8 @@
     <Compile Include="Utility\ExtensionInstantiator.cs" />
     <Compile Include="Utility\HotkeyManager.cs" />
     <Compile Include="Utility\ConfigurationWatcher.cs" />
+    <Compile Include="Utility\ConfigurationMigration.cs" />
+    <Compile Include="Utility\Migrations\MigrationBase.cs" />
     <Compile Include="Utility\JsonConfigurationLoader.cs" />
     <Compile Include="Utility\LogManager.cs" />
     <Compile Include="Utility\TopMostManager.cs" />

src/Libraries/ACATCore/ACAT.Core.csproj

@@ -21,6 +21,12 @@ namespace ACAT.Core.Configuration
     /// </summary>
     public class AbbreviationsJson
     {
+        /// <summary>
+        /// Configuration file version for migration support
+        /// </summary>
+        [JsonPropertyName("version")]
+        public string Version { get; set; } = "1.0.0";
+
         /// <summary>
         /// List of abbreviation entries
         /// </summary>

src/Libraries/ACATCore/Configuration/AbbreviationsJson.cs

@@ -24,6 +24,12 @@ namespace ACAT.Core.Configuration
     /// </summary>
     public class ActuatorSettingsJson
     {
+        /// <summary>
+        /// Configuration file version for migration support
+        /// </summary>
+        [JsonPropertyName("version")]
+        public string Version { get; set; } = "1.0.0";
+
         /// <summary>
         /// List of actuator configurations
         /// </summary>

src/Libraries/ACATCore/Configuration/ActuatorSettingsJson.cs

@@ -23,6 +23,12 @@ namespace ACAT.Core.Configuration
     /// </summary>
     public class PanelConfigJson
     {
+        /// <summary>
+        /// Configuration file version for migration support
+        /// </summary>
+        [JsonPropertyName("version")]
+        public string Version { get; set; } = "1.0.0";
+
         /// <summary>
         /// List of widget attribute definitions
         /// </summary>

src/Libraries/ACATCore/Configuration/PanelConfigJson.cs

@@ -24,6 +24,12 @@ namespace ACAT.Core.Configuration
     /// </summary>
     public class PreferredWordPredictorsJson
     {
+        /// <summary>
+        /// Configuration file version for migration support
+        /// </summary>
+        [JsonPropertyName("version")]
+        public string Version { get; set; } = "1.0.0";
+
         /// <summary>
         /// List of preferred word predictors for different languages
         /// </summary>

src/Libraries/ACATCore/Configuration/PreferredWordPredictorsJson.cs

@@ -21,6 +21,12 @@ namespace ACAT.Core.Configuration
     /// </summary>
     public class PronunciationsJson
     {
+        /// <summary>
+        /// Configuration file version for migration support
+        /// </summary>
+        [JsonPropertyName("version")]
+        public string Version { get; set; } = "1.0.0";
+
         /// <summary>
         /// List of pronunciation entries
         /// </summary>

src/Libraries/ACATCore/Configuration/PronunciationsJson.cs

@@ -23,6 +23,12 @@ namespace ACAT.Core.Configuration
     /// </summary>
     public class ThemeJson
     {
+        /// <summary>
+        /// Configuration file version for migration support
+        /// </summary>
+        [JsonPropertyName("version")]
+        public string Version { get; set; } = "1.0.0";
+
         /// <summary>
         /// Description of the theme
         /// </summary>