Add native SCTP support matrix

Author: ammarheidari

README.md

@@ -36,6 +36,7 @@ The first production milestone is M3UA over a transport abstraction. SCCP, TCAP,
 | MAP readiness | Foundation readiness report with capability count; external MAP SMS interoperability vectors and operator-profile validation remain the production gate |
 | Interoperability tooling | Phase 6 foundation-ready: trace frames, Wireshark-friendly hex dumps, conformance vectors, built-in M3UA/MAP vectors, simulator scripts, MAP SMS flow builders, local TCP samples, sample catalog, CI profile, and readiness report; production gate is external interoperability lab evidence |
 | Commercial readiness | Phase 7 started: internal release readiness is available; commercial production readiness requires native SCTP verification, external interoperability evidence, and release governance |
+| Native SCTP support | Phase 7 matrix added: Linux requires lab verification; Windows and macOS are contract-only until a production provider is verified |
 
 ## Requirements
 

docs/PHASE7_COMMERCIALIZATION.md

@@ -15,3 +15,15 @@ bool canClaimCommercialProduction = report.CommercialReady;
 Internal release readiness is currently available because SDK foundations, interoperability tooling, and CI verification are present.
 
 Commercial readiness remains blocked until native SCTP verification, external interoperability evidence, and release governance are complete.
+
+## Native SCTP Support Matrix
+
+`SigtranNativeSctpSupport.GetSupportMatrix()` exposes the current native SCTP support plan:
+
+| Platform | Status |
+| --- | --- |
+| Linux | Verification required |
+| Windows | Contract only |
+| macOS | Contract only |
+
+Linux is the target for native SCTP lab verification. Windows and macOS remain supported through transport contracts and development adapters until a production provider is selected and verified.

docs/SCTP_TRANSPORT.md

@@ -114,3 +114,7 @@ The report exposes `FoundationCapabilityCount` and `RequiredFoundationCapability
 Phase 2 completes the SDK-level SCTP foundation: metadata contracts, association lifecycle vocabulary, connection options, reconnect policy, stream selection, PPID helpers, health snapshots, readiness reporting, and a metadata-aware TCP development adapter.
 
 The remaining production gate is explicit: native SCTP implementation and interoperability verification are required before this SDK can be used as a production SCTP stack.
+
+## Phase 7 Native SCTP Matrix
+
+`SigtranNativeSctpSupport.GetSupportMatrix()` records native SCTP support claims for commercial release planning. Linux is marked as verification required, while Windows and macOS are contract-only until a production provider is selected and verified.

src/sigtran.net.Tests/Program.cs

@@ -21,6 +21,7 @@
 Run("SIGTRAN interoperability readiness reports foundation status", SigtranInteroperabilityReadinessReportsFoundationStatus);
 Run("SIGTRAN phase 6 status summarizes completed tooling", SigtranPhase6StatusSummarizesCompletedTooling);
 Run("SIGTRAN commercial readiness reports release gates", SigtranCommercialReadinessReportsReleaseGates);
+Run("SIGTRAN native SCTP support matrix reports verification status", SigtranNativeSctpSupportMatrixReportsVerificationStatus);
 Run("TCAP BER element encodes short and long lengths", TcapBerElementEncodesShortAndLongLengths);
 Run("TCAP transaction identifiers use BER context tags", TcapTransactionIdentifiersUseBerContextTags);
 Run("TCAP BER Invoke component round-trips", TcapBerInvokeComponentRoundTrips);
@@ -281,6 +282,17 @@ static void SigtranCommercialReadinessReportsReleaseGates()
     Assert(report.Describe().Contains("externalInterop=False", StringComparison.Ordinal), report.Describe());
 }
 
+static void SigtranNativeSctpSupportMatrixReportsVerificationStatus()
+{
+    IReadOnlyList<SigtranNativeSctpSupportEntry> matrix = SigtranNativeSctpSupport.GetSupportMatrix();
+
+    AssertEqual(3, matrix.Count, "native SCTP support matrix count");
+    AssertEqual(SigtranOperatingSystemFamily.Linux, matrix[0].OperatingSystem, "native SCTP Linux row");
+    AssertEqual(SigtranNativeSctpSupportStatus.VerificationRequired, matrix[0].Status, "native SCTP Linux status");
+    AssertEqual(SigtranNativeSctpSupportStatus.ContractOnly, matrix[1].Status, "native SCTP Windows status");
+    Assert(!SigtranNativeSctpSupport.IsProductionVerified(), "native SCTP should not be production verified yet");
+}
+
 static void TcapBerElementEncodesShortAndLongLengths()
 {
     Span<byte> shortBuffer = stackalloc byte[8];

src/sigtran.net/Core/Utilities/SigtranCommercialReadiness.cs

@@ -73,7 +73,7 @@ public static SigtranCommercialReadinessReport GetReport()
             hasSdkFoundation: true,
             hasInteroperabilityTooling: SigtranInteroperabilityReadiness.GetReport().FoundationReady,
             hasCiVerification: SigtranCiVerification.CreateDefaultProfile().Steps.Count > 0,
-            hasNativeSctpVerification: false,
+            hasNativeSctpVerification: SigtranNativeSctpSupport.IsProductionVerified(),
             hasExternalInteroperabilityEvidence: false,
             hasReleaseGovernance: false);
     }

src/sigtran.net/Core/Utilities/SigtranNativeSctpSupport.cs

@@ -0,0 +1,87 @@
+namespace sigtran.net.Core.Utilities;
+
+/// <summary>
+/// Identifies an operating system family for native SCTP support planning.
+/// </summary>
+public enum SigtranOperatingSystemFamily
+{
+    /// <summary>Linux operating systems.</summary>
+    Linux,
+
+    /// <summary>Windows operating systems.</summary>
+    Windows,
+
+    /// <summary>macOS operating systems.</summary>
+    MacOS
+}
+
+/// <summary>
+/// Identifies native SCTP support status.
+/// </summary>
+public enum SigtranNativeSctpSupportStatus
+{
+    /// <summary>The SDK exposes contracts only.</summary>
+    ContractOnly,
+
+    /// <summary>The platform requires lab verification.</summary>
+    VerificationRequired,
+
+    /// <summary>The platform is verified for production use.</summary>
+    ProductionVerified
+}
+
+/// <summary>
+/// Describes native SCTP support for one operating system family.
+/// </summary>
+public sealed class SigtranNativeSctpSupportEntry
+{
+    /// <summary>Creates a native SCTP support entry.</summary>
+    /// <param name="operatingSystem">The operating system family.</param>
+    /// <param name="status">The support status.</param>
+    /// <param name="notes">The support notes.</param>
+    public SigtranNativeSctpSupportEntry(
+        SigtranOperatingSystemFamily operatingSystem,
+        SigtranNativeSctpSupportStatus status,
+        string notes)
+    {
+        OperatingSystem = operatingSystem;
+        Status = status;
+        Notes = string.IsNullOrWhiteSpace(notes) ? throw new ArgumentException("Support notes are required.", nameof(notes)) : notes;
+    }
+
+    /// <summary>The operating system family.</summary>
+    public SigtranOperatingSystemFamily OperatingSystem { get; }
+
+    /// <summary>The support status.</summary>
+    public SigtranNativeSctpSupportStatus Status { get; }
+
+    /// <summary>The support notes.</summary>
+    public string Notes { get; }
+}
+
+/// <summary>
+/// Provides native SCTP support planning data.
+/// </summary>
+public static class SigtranNativeSctpSupport
+{
+    private static readonly SigtranNativeSctpSupportEntry[] Entries =
+    [
+        new(SigtranOperatingSystemFamily.Linux, SigtranNativeSctpSupportStatus.VerificationRequired, "Target platform for native SCTP lab verification."),
+        new(SigtranOperatingSystemFamily.Windows, SigtranNativeSctpSupportStatus.ContractOnly, "Use the transport contract or development TCP adapter until a verified SCTP provider is selected."),
+        new(SigtranOperatingSystemFamily.MacOS, SigtranNativeSctpSupportStatus.ContractOnly, "No production native SCTP claim is made.")
+    ];
+
+    /// <summary>Returns the native SCTP support matrix.</summary>
+    /// <returns>The native SCTP support entries.</returns>
+    public static IReadOnlyList<SigtranNativeSctpSupportEntry> GetSupportMatrix()
+    {
+        return Entries.ToArray();
+    }
+
+    /// <summary>Returns whether every platform entry is production verified.</summary>
+    /// <returns>True when all entries are production verified; otherwise false.</returns>
+    public static bool IsProductionVerified()
+    {
+        return Entries.All(static entry => entry.Status == SigtranNativeSctpSupportStatus.ProductionVerified);
+    }
+}