Refactor code structure and optimize performance across multiple modules

src/__Libraries/StellaOps.Canonical.Json.Tests/CanonVersionTests.cs

@@ -3,6 +3,7 @@ using System.Text.Json;
 using System.Text.RegularExpressions;
 using Xunit;
 
+using StellaOps.TestKit;
 namespace StellaOps.Canonical.Json.Tests;
 
 /// <summary>
@@ -13,20 +14,23 @@ public class CanonVersionTests
 {
     #region Version Constants
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void V1_HasExpectedValue()
     {
         Assert.Equal("stella:canon:v1", CanonVersion.V1);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void VersionFieldName_HasUnderscorePrefix()
     {
         Assert.Equal("_canonVersion", CanonVersion.VersionFieldName);
         Assert.StartsWith("_", CanonVersion.VersionFieldName);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void Current_EqualsV1()
     {
         Assert.Equal(CanonVersion.V1, CanonVersion.Current);
@@ -36,35 +40,40 @@ public class CanonVersionTests
 
     #region IsVersioned Detection
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void IsVersioned_VersionedJson_ReturnsTrue()
     {
         var json = """{"_canonVersion":"stella:canon:v1","foo":"bar"}"""u8;
         Assert.True(CanonVersion.IsVersioned(json));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void IsVersioned_LegacyJson_ReturnsFalse()
     {
         var json = """{"foo":"bar"}"""u8;
         Assert.False(CanonVersion.IsVersioned(json));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void IsVersioned_EmptyJson_ReturnsFalse()
     {
         var json = "{}"u8;
         Assert.False(CanonVersion.IsVersioned(json));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void IsVersioned_TooShort_ReturnsFalse()
     {
         var json = """{"_ca":"v"}"""u8;
         Assert.False(CanonVersion.IsVersioned(json));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void IsVersioned_WrongFieldName_ReturnsFalse()
     {
         var json = """{"_version":"stella:canon:v1","foo":"bar"}"""u8;
@@ -75,28 +84,32 @@ public class CanonVersionTests
 
     #region ExtractVersion
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void ExtractVersion_VersionedJson_ReturnsVersion()
     {
         var json = """{"_canonVersion":"stella:canon:v1","foo":"bar"}"""u8;
         Assert.Equal("stella:canon:v1", CanonVersion.ExtractVersion(json));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void ExtractVersion_CustomVersion_ReturnsVersion()
     {
         var json = """{"_canonVersion":"custom:v2","foo":"bar"}"""u8;
         Assert.Equal("custom:v2", CanonVersion.ExtractVersion(json));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void ExtractVersion_LegacyJson_ReturnsNull()
     {
         var json = """{"foo":"bar"}"""u8;
         Assert.Null(CanonVersion.ExtractVersion(json));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void ExtractVersion_EmptyVersion_ReturnsNull()
     {
         var json = """{"_canonVersion":"","foo":"bar"}"""u8;
@@ -107,7 +120,8 @@ public class CanonVersionTests
 
     #region CanonicalizeVersioned
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_IncludesVersionMarker()
     {
         var obj = new { foo = "bar" };
@@ -118,7 +132,8 @@ public class CanonVersionTests
         Assert.Contains("\"foo\":\"bar\"", json);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_VersionMarkerIsFirst()
     {
         var obj = new { aaa = 1, zzz = 2 };
@@ -131,7 +146,8 @@ public class CanonVersionTests
         Assert.True(versionIndex < aaaIndex);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_SortsOtherKeys()
     {
         var obj = new { z = 3, a = 1, m = 2 };
@@ -142,7 +158,8 @@ public class CanonVersionTests
         Assert.Matches(@"\{""_canonVersion"":""[^""]+"",""a"":1,""m"":2,""z"":3\}", json);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_CustomVersion_UsesProvidedVersion()
     {
         var obj = new { foo = "bar" };
@@ -152,14 +169,16 @@ public class CanonVersionTests
         Assert.Contains("\"_canonVersion\":\"custom:v99\"", json);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_NullVersion_ThrowsArgumentException()
     {
         var obj = new { foo = "bar" };
         Assert.ThrowsAny<ArgumentException>(() => CanonJson.CanonicalizeVersioned(obj, null!));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_EmptyVersion_ThrowsArgumentException()
     {
         var obj = new { foo = "bar" };
@@ -170,7 +189,8 @@ public class CanonVersionTests
 
     #region Hash Difference (Versioned vs Legacy)
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void HashVersioned_DiffersFromLegacyHash()
     {
         var obj = new { foo = "bar", count = 42 };
@@ -181,7 +201,8 @@ public class CanonVersionTests
         Assert.NotEqual(legacyHash, versionedHash);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void HashVersionedPrefixed_DiffersFromLegacyHashPrefixed()
     {
         var obj = new { foo = "bar", count = 42 };
@@ -194,7 +215,8 @@ public class CanonVersionTests
         Assert.StartsWith("sha256:", legacyHash);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void HashVersioned_SameInput_ProducesSameHash()
     {
         var obj = new { foo = "bar", count = 42 };
@@ -205,7 +227,8 @@ public class CanonVersionTests
         Assert.Equal(hash1, hash2);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void HashVersioned_DifferentVersions_ProduceDifferentHashes()
     {
         var obj = new { foo = "bar" };
@@ -220,7 +243,8 @@ public class CanonVersionTests
 
     #region Determinism
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_SameInput_ProducesSameBytes()
     {
         var obj = new { name = "test", value = 123, nested = new { x = 1, y = 2 } };
@@ -231,7 +255,8 @@ public class CanonVersionTests
         Assert.Equal(bytes1, bytes2);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_DifferentPropertyOrder_ProducesSameBytes()
     {
         // Create two objects with same properties but defined in different order
@@ -247,7 +272,8 @@ public class CanonVersionTests
         Assert.Equal(bytes1, bytes2);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_StableAcrossMultipleCalls()
     {
         var obj = new { id = Guid.Parse("12345678-1234-1234-1234-123456789012"), name = "stable" };
@@ -264,7 +290,8 @@ public class CanonVersionTests
 
     #region Golden File / Snapshot Tests
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_KnownInput_ProducesKnownOutput()
     {
         // Golden test: exact output for known input to detect algorithm changes
@@ -276,7 +303,8 @@ public class CanonVersionTests
         Assert.Equal("""{"_canonVersion":"stella:canon:v1","message":"hello","number":42}""", json);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void HashVersioned_KnownInput_ProducesKnownHash()
     {
         // Golden test: exact hash for known input to detect algorithm changes
@@ -294,7 +322,8 @@ public class CanonVersionTests
         Assert.Equal(hash, hash2);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_NestedObject_ProducesCorrectOutput()
     {
         var obj = new
@@ -313,7 +342,8 @@ public class CanonVersionTests
 
     #region Backward Compatibility
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanVersion_CanDistinguishLegacyFromVersioned()
     {
         var obj = new { foo = "bar" };
@@ -325,7 +355,8 @@ public class CanonVersionTests
         Assert.True(CanonVersion.IsVersioned(versioned));
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void LegacyCanonicalize_StillWorks()
     {
         // Ensure we haven't broken the legacy canonicalize method
@@ -341,7 +372,8 @@ public class CanonVersionTests
 
     #region Edge Cases
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_EmptyObject_IncludesOnlyVersion()
     {
         var obj = new { };
@@ -351,7 +383,8 @@ public class CanonVersionTests
         Assert.Equal("""{"_canonVersion":"stella:canon:v1"}""", json);
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_WithSpecialCharacters_HandlesCorrectly()
     {
         var obj = new { message = "hello\nworld", special = "quote:\"test\"" };
@@ -365,7 +398,8 @@ public class CanonVersionTests
         Assert.Equal("stella:canon:v1", parsed.GetProperty("_canonVersion").GetString());
     }
 
-    [Fact]
+    [Trait("Category", TestCategories.Unit)]
+        [Fact]
     public void CanonicalizeVersioned_WithUnicodeCharacters_HandlesCorrectly()
     {
         var obj = new { greeting = "こんにちは", emoji = "🚀" };