ci: add GitHub Actions CI workflow (mirrors gts-go/gts-rust/gts-ts)

.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+# Baseline whitespace conventions enforced by `make fmt` (dotnet format).
+# Kept intentionally minimal so the formatter's built-in C# defaults apply
+# without imposing heavy style opinions.
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+
+[*.cs]
+indent_size = 4
+
+[*.{csproj,props,targets}]
+indent_size = 2
+
+[*.{json,yml,yaml}]
+indent_size = 2

.github/workflows/ci.yml

@@ -0,0 +1,149 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+    paths-ignore:
+      - '**/*.md'
+      - 'docs/**'
+  pull_request:
+    branches: [ main, develop ]
+    paths-ignore:
+      - '**/*.md'
+      - 'docs/**'
+
+# Cancel previous runs for the same ref to save CI minutes.
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  DOTNET_NOLOGO: 'true'
+  DOTNET_CLI_TELEMETRY_OPTOUT: 'true'
+  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 'true'
+
+jobs:
+  test:
+    name: Test Suite (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ ubuntu-latest, windows-latest, macos-latest ]
+
+    steps:
+      - name: Force LF in working tree (w/a for Windows)
+        if: runner.os == 'Windows'
+        shell: bash
+        run: |
+          git config --global core.autocrlf false
+          git config --global core.eol lf
+
+      - name: Checkout
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          clean: 'true'
+          persist-credentials: false
+
+      # Install the .NET 8 SDK for the net8.0 target. global.json intentionally
+      # stays permissive ("8.0.0" + rollForward=latestMajor, i.e. "min .NET 8,
+      # use whatever newer SDK is present"); that pin is not a downloadable
+      # build, so we install an 8.0 SDK explicitly rather than via global.json.
+      - name: Set up .NET
+        uses: actions/setup-dotnet@67a3573c9a986a3f9c594539f4ab511d57bb3ce9 # v4.3.1
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Show .NET version
+        run: dotnet --info
+
+      - name: Restore
+        run: dotnet restore gts-dotnet.sln
+
+      # Formatting check (fast fail for style issues)
+      - name: dotnet format (check)
+        run: make fmt
+
+      # Analyzers (linter)
+      - name: dotnet format analyzers (check)
+        run: make lint
+
+      # Build
+      - name: build
+        run: dotnet build gts-dotnet.sln -c Release --no-restore
+
+      # Unit tests
+      - name: test
+        run: dotnet test gts-dotnet.sln -c Release --no-build
+
+  security:
+    name: Security (dotnet list package --vulnerable on Ubuntu)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+
+      - name: Set up .NET
+        uses: actions/setup-dotnet@67a3573c9a986a3f9c594539f4ab511d57bb3ce9 # v4.3.1
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Restore
+        run: dotnet restore gts-dotnet.sln
+
+      # Report vulnerable NuGet dependencies but do not fail CI.
+      - name: dotnet list package --vulnerable
+        run: make security
+        continue-on-error: true
+
+  coverage:
+    name: Code Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+
+      - name: Set up .NET
+        uses: actions/setup-dotnet@67a3573c9a986a3f9c594539f4ab511d57bb3ce9 # v4.3.1
+        with:
+          dotnet-version: '8.0.x'
+
+      # Generate a Cobertura coverage report.
+      - name: Run tests with coverage
+        run: dotnet test gts-dotnet.sln -c Release --collect:"XPlat Code Coverage"
+
+      # Upload to Codecov; do not fail CI if Codecov is down/misconfigured.
+      - name: Upload to Codecov
+        uses: codecov/codecov-action@0f8570b1a125f4937846a11fcfa3bcd548bd8c97 # v4.6.0
+        with:
+          files: '**/coverage.cobertura.xml'
+          fail_ci_if_error: false
+          # token: ${{ secrets.CODECOV_TOKEN }}  # Uncomment if required for private repos
+
+  gts-spec-tests:
+    name: GTS Spec Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+
+      - name: Set up .NET
+        uses: actions/setup-dotnet@67a3573c9a986a3f9c594539f4ab511d57bb3ce9 # v4.3.1
+        with:
+          dotnet-version: '8.0.x'
+
+      # Builds the gts CLI binary, pulls the gts-spec test-runner image from
+      # GHCR (tag from .gts-spec-version), starts the server natively, waits
+      # for readiness, then runs pytest inside the container against
+      # host.docker.internal:$PORT. See Makefile.
+      - name: Run gts-spec tests via docker
+        run: make gts-spec-tests

Gts.Application/GtsHttpApiHelpers.cs

@@ -75,4 +75,4 @@ internal static JsonObject ResolveSchemaRefs(JsonObject schema, IReadOnlyDiction
         if (result.Errors is { Count: > 0 }) return string.Join("; ", result.Errors);
         return result.FailureReason == GtsValidationFailure.PrecedentIncompatible ? "Parent GTS Type Schema not found" : result.FailureReason?.ToWire() ?? "JSON Schema validation failed";
     }
-}
+}

Gts.Application/GtsHttpContracts.cs

@@ -17,4 +17,4 @@ internal static class GtsHttpJson
     {
         PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower
     };
-}
+}

Gts.Application/GtsOperationEndpoints.cs

@@ -128,4 +128,4 @@ JsonValue value when value.TryGetValue<decimal>(out var decimalNumber) => Result
             _ => Results.Json(new { resolved = true, value = result.Value?.DeepClone() })
         };
     }
-}
+}

Gts.Store/GtsCastService.cs

@@ -80,4 +80,4 @@ private static JsonObject CanonicalSchema(JsonObject schema) =>
             : schema;
 
     private static GtsInstanceCastResult Failure(string? id, GtsId target, GtsValidationFailure reason) => new() { Ok = false, InstanceId = id, ToSchemaId = target, FailureReason = reason };
-}
+}

Gts.Store/GtsInstanceValidationService.cs

@@ -139,4 +139,4 @@ private static bool HasMixedDialectReferences(JsonNode? node, string dialect, IR
         }
         return node is JsonArray array && array.Any(child => HasMixedDialectReferences(child, dialect, schemas, visited));
     }
-}
+}

Gts.Store/GtsRefConstraint.cs

@@ -30,4 +30,4 @@ internal bool Matches(string value)
         // requires a full match or a '~' segment boundary immediately after the pattern.
         return value.Length == Pattern.Length || Pattern.EndsWith('~') || value[Pattern.Length] == '~';
     }
-}
+}

Gts.Store/GtsSchemaCompatibilityService.cs

@@ -17,4 +17,4 @@ public static (bool Backward, IReadOnlyList<string> BackwardErrors, bool Forward
         var (forward, forwardErrors) = GtsJsonSchemaEvolutionCompatibility.CheckForward(oldSchema, newSchema);
         return (backward, backwardErrors, forward, forwardErrors);
     }
-}
+}

Gts.Store/GtsSchemaDependencyGraph.cs

@@ -134,4 +134,4 @@ private static JsonObject Resolve(JsonObject schema, Func<GtsId, JsonObject?> lo
             };
         return clone;
     }
-}
+}

Gts.Store/GtsSchemaValidationService.cs

@@ -105,4 +105,4 @@ internal async ValueTask<GtsSchemaValidationResult> ValidateAsync(GtsId schemaId
     }
 
     private static GtsSchemaValidationResult Failure(string? id, GtsValidationFailure reason) => new() { Ok = false, SchemaId = id, FailureReason = reason };
-}
+}

Gts.Store/GtsTraitComposer.cs

@@ -70,4 +70,4 @@ private static void CollectValues(JsonObject schema, JsonObject values)
                 CollectValues(branch, values);
         }
     }
-}
+}

Gts.Store/Validation/GtsFormatRegistry.cs

@@ -73,4 +73,4 @@ public override bool Validate(JsonElement value, out string? errorMessage)
             return valid;
         }
     }
-}
+}

Gts.Store/Validation/GtsJson.cs

@@ -8,4 +8,4 @@ internal static class GtsJson
     internal static JsonElement ToElement(JsonNode? node) => JsonSerializer.SerializeToElement(node);
 
     internal static JsonObject CloneObject(JsonObject source) => (JsonObject)source.DeepClone();
-}
+}

Gts.Store/Validation/GtsJsonPointer.cs

@@ -17,4 +17,4 @@ internal static bool TryEvaluate(JsonNode? root, string reference, out JsonNode?
         var pointerText = reference.StartsWith('#') ? reference[1..] : reference;
         return JsonPointer.TryParse(pointerText, out var pointer) && pointer.TryEvaluate(root, out result);
     }
-}
+}

Gts.Store/Validation/GtsJsonSchemaEngine.cs

@@ -199,4 +199,4 @@ private static void Walk(EvaluationResults node, List<string> errors)
         foreach (var detail in node.Details ?? [])
             Walk(detail, errors);
     }
-}
+}

Gts.Store/Validation/GtsJsonSchemaEvaluator.cs

@@ -20,4 +20,4 @@ internal static void ValidateSchema(JsonObject normalizedSchemaDocument) =>
         Engine.ValidateSchema(normalizedSchemaDocument);
 
     internal static IReadOnlyList<string> FlattenErrors(EvaluationResults results) => Engine.FlattenErrors(results);
-}
+}

Gts.Store/Validation/IGtsJsonSchemaEngine.cs

@@ -12,4 +12,4 @@ internal interface IGtsJsonSchemaEngine
     void ValidateSchema(JsonObject normalizedSchemaDocument);
 
     IReadOnlyList<string> FlattenErrors(EvaluationResults results);
-}
+}

Gts.Tests/Extraction/ExtractBasicTests.cs

@@ -120,4 +120,4 @@ public void ExtractingIdReturnsNullWhenValidIdDoesNotExist()
         Assert.Null(result.Id);
         Assert.Null(result.SelectedEntityField);
     }
-}
+}

Gts.Tests/Extraction/ExtractEntityTests.cs

@@ -1,4 +1,4 @@
-using System.Text.Json.Nodes;
+using System.Text.Json.Nodes;
 using Gts.Extraction;
 
 namespace Gts.Tests.Extraction;
@@ -85,4 +85,4 @@ public void ExtractingPopulatesRefsFromDoubleDollarRefInAllOf()
 
         Assert.Contains(entity.GtsRefs, r => r.Id == "gts.x.test6.events.type.v1~");
     }
-}
+}

Gts.Tests/Extraction/ExtractSchemaTests.cs

@@ -1,4 +1,4 @@
-using System.Text.Json.Nodes;
+using System.Text.Json.Nodes;
 using Gts.Extraction;
 
 namespace Gts.Tests.Extraction;

Gts.Tests/GtsIdTests.cs

@@ -72,10 +72,10 @@
         string? str = null;
 
         Assert.False(GtsId.TryParse(str, out _));
         Assert.Throws<ParseException>(() => GtsId.Parse(str));
 
         Assert.False(GtsId.TryParsePattern(str, out _));
         Assert.Throws<ParseException>(() => GtsId.ParsePattern(str));
     }
 
     [Fact]
@@ -129,4 +129,4 @@
         Assert.Equal(id1, id12);
         Assert.NotEqual(id1, id2);
     }
-}
+}

Gts.Tests/Parsing/IdentifierParserTests.cs

@@ -1,4 +1,4 @@
-using Gts.Parsing;
+using Gts.Parsing;
 
 namespace Gts.Tests.Parsing;
 

Gts.Tests/Parsing/InstanceParserTests.cs

@@ -1,4 +1,4 @@
-using Gts.Parsing;
+using Gts.Parsing;
 using Pidgin;
 
 namespace Gts.Tests.Parsing;
@@ -30,4 +30,4 @@ public void InstanceParsesTripleSegment()
         var segments = id.ToArray();
         Assert.Equal(3, segments.Length);
     }
-}
+}

Gts.Tests/Parsing/PatternParserTests.cs

@@ -1,4 +1,4 @@
-using Gts.Parsing;
+using Gts.Parsing;
 using Pidgin;
 
 namespace Gts.Tests.Parsing;
@@ -148,4 +148,4 @@ public void GtsPatternParsesMultipleWithTildeAtTheEnd()
         var segments = id.ToArray();
         Assert.Single(segments);
     }
-}
+}

Gts.Tests/Parsing/SectionParserTests.cs

@@ -1,4 +1,4 @@
-using Gts.Parsing;
+using Gts.Parsing;
 using Pidgin;
 
 namespace Gts.Tests.Parsing;
@@ -18,4 +18,4 @@ public void GtsDoesNotParseUppercaseLiteral()
         Assert.Throws<ParseException<char>>(
             () => Parsers.GtsPrefix.ParseOrThrow("GTS"));
     }
-}
+}

Gts.Tests/Parsing/SegmentParserTests.cs

@@ -1,4 +1,4 @@
-using Gts.Parsing;
+using Gts.Parsing;
 using Pidgin;
 
 namespace Gts.Tests.Parsing;
@@ -15,7 +15,7 @@
         Assert.Equal("namespace", segment.Namespace);
         Assert.Equal("type", segment.Type);
 
         Assert.Equal(1, segment.Version.Value.Major);
         Assert.Null(segment.Version.Value.Minor);
     }
 
@@ -29,7 +29,7 @@
         Assert.Equal("namespace", segment.Namespace);
         Assert.Equal("type", segment.Type);
 
         Assert.Equal(1, segment.Version.Value.Major);
         Assert.Equal(0, segment.Version.Value.Minor);
     }
 }

Gts.Tests/Parsing/TypeParserTests.cs

@@ -1,4 +1,4 @@
-using Gts.Parsing;
+using Gts.Parsing;
 using Pidgin;
 
 namespace Gts.Tests.Parsing;
@@ -30,4 +30,4 @@ public void TypeParsesDoubleSegment()
         var segments = id.ToArray();
         Assert.Equal(2, segments.Length);
     }
-}
+}

Gts.Tests/Parsing/VersionParserTests.cs

@@ -46,4 +46,4 @@ public void VersionFullParsesPartialVersionString()
         Assert.Equal(123, major);
         Assert.Null(minor);
     }
-}
+}

Gts.Tests/Validation/JsonInfrastructureTests.cs

@@ -152,4 +152,4 @@ public void Shared_id_parser_rejects_negative_versions(string id)
     {
         Assert.False(GtsId.TryParse(id, out _));
     }
-}
+}