Add release candidate manifest

Author: ammarheidari

README.md

@@ -38,6 +38,7 @@ The first production milestone is M3UA over a transport abstraction. SCCP, TCAP,
 | 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 |
 | External interoperability evidence | Phase 7 registry added for peer-stack lab results and packet trace references; current evidence inventory is empty until real lab artifacts are captured |
+| Release candidates | Phase 7 manifest added for package version, source commit, internal release gates, and commercial promotion gates |
 
 ## Requirements
 

docs/PHASE7_COMMERCIALIZATION.md

@@ -43,3 +43,14 @@ registry.Add(new SigtranInteropEvidenceItem(
 ```
 
 The current registry is intentionally empty until real lab artifacts are added. Commercial readiness requires at least one passing external evidence item, and later release policies should require multiple peer stacks and scenarios.
+
+## Release Candidate Manifest
+
+`SigtranReleaseCandidate.Create(version, commitSha)` creates an auditable release snapshot.
+
+```csharp
+SigtranReleaseCandidateManifest manifest =
+    SigtranReleaseCandidate.Create("1.0.0-alpha.1", "abcdef0");
+```
+
+Release candidates can be published after internal gates pass. Promotion to commercial production remains blocked until the commercial readiness report is fully green.

src/sigtran.net.Tests/Program.cs

@@ -23,6 +23,7 @@
 Run("SIGTRAN commercial readiness reports release gates", SigtranCommercialReadinessReportsReleaseGates);
 Run("SIGTRAN native SCTP support matrix reports verification status", SigtranNativeSctpSupportMatrixReportsVerificationStatus);
 Run("SIGTRAN interop evidence registry tracks lab results", SigtranInteropEvidenceRegistryTracksLabResults);
+Run("SIGTRAN release candidate manifest reports promotion gates", SigtranReleaseCandidateManifestReportsPromotionGates);
 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);
@@ -305,6 +306,16 @@ static void SigtranInteropEvidenceRegistryTracksLabResults()
     Assert(!SigtranInteropEvidence.CreateCurrentRegistry().HasPassingEvidence(), "current interop evidence should be empty until real lab artifacts are added");
 }
 
+static void SigtranReleaseCandidateManifestReportsPromotionGates()
+{
+    SigtranReleaseCandidateManifest manifest = SigtranReleaseCandidate.Create("1.0.0-alpha.1", "abcdef0");
+
+    AssertEqual("Sigtran.Net", manifest.PackageId, "release candidate package id");
+    Assert(manifest.CanPublishReleaseCandidate, "release candidate should be publishable after internal gates");
+    Assert(!manifest.CanPromoteToCommercialProduction, "release candidate should not promote without commercial gates");
+    Assert(manifest.Describe().Contains("commercialProduction=False", StringComparison.Ordinal), manifest.Describe());
+}
+
 static void TcapBerElementEncodesShortAndLongLengths()
 {
     Span<byte> shortBuffer = stackalloc byte[8];

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

@@ -0,0 +1,64 @@
+namespace sigtran.net.Core.Utilities;
+
+/// <summary>
+/// Describes one SDK release candidate manifest.
+/// </summary>
+public sealed class SigtranReleaseCandidateManifest
+{
+    /// <summary>Creates a release candidate manifest.</summary>
+    /// <param name="packageId">The package id.</param>
+    /// <param name="version">The package version.</param>
+    /// <param name="commitSha">The source commit SHA.</param>
+    /// <param name="readiness">The commercial readiness report.</param>
+    public SigtranReleaseCandidateManifest(
+        string packageId,
+        string version,
+        string commitSha,
+        SigtranCommercialReadinessReport readiness)
+    {
+        PackageId = string.IsNullOrWhiteSpace(packageId) ? throw new ArgumentException("Package id is required.", nameof(packageId)) : packageId;
+        Version = string.IsNullOrWhiteSpace(version) ? throw new ArgumentException("Version is required.", nameof(version)) : version;
+        CommitSha = string.IsNullOrWhiteSpace(commitSha) ? throw new ArgumentException("Commit SHA is required.", nameof(commitSha)) : commitSha;
+        Readiness = readiness ?? throw new ArgumentNullException(nameof(readiness));
+    }
+
+    /// <summary>The package id.</summary>
+    public string PackageId { get; }
+
+    /// <summary>The package version.</summary>
+    public string Version { get; }
+
+    /// <summary>The source commit SHA.</summary>
+    public string CommitSha { get; }
+
+    /// <summary>The commercial readiness report.</summary>
+    public SigtranCommercialReadinessReport Readiness { get; }
+
+    /// <summary>Whether this manifest can be used for a public release candidate.</summary>
+    public bool CanPublishReleaseCandidate => Readiness.InternalReleaseReady;
+
+    /// <summary>Whether this manifest can be promoted to commercial production.</summary>
+    public bool CanPromoteToCommercialProduction => Readiness.CommercialReady;
+
+    /// <summary>Formats a compact manifest summary.</summary>
+    /// <returns>The manifest summary.</returns>
+    public string Describe()
+    {
+        return $"{PackageId} {Version} commit={CommitSha} releaseCandidate={CanPublishReleaseCandidate} commercialProduction={CanPromoteToCommercialProduction}";
+    }
+}
+
+/// <summary>
+/// Builds release candidate manifests for the SDK.
+/// </summary>
+public static class SigtranReleaseCandidate
+{
+    /// <summary>Creates a release candidate manifest.</summary>
+    /// <param name="version">The package version.</param>
+    /// <param name="commitSha">The source commit SHA.</param>
+    /// <returns>The release candidate manifest.</returns>
+    public static SigtranReleaseCandidateManifest Create(string version, string commitSha)
+    {
+        return new("Sigtran.Net", version, commitSha, SigtranCommercialReadiness.GetReport());
+    }
+}