Add operations readiness report

Author: ammarheidari

README.md

@@ -41,7 +41,7 @@ The first production milestone is M3UA over a transport abstraction. SCCP, TCAP,
 | Release candidates | Phase 7 manifest added for package version, source commit, internal release gates, and commercial promotion gates |
 | Release automation | Phase 10 foundation-ready: deterministic release plan, artifact manifest with digest tracking, SBOM plan, package signing plan, provenance tracking, release notes validation, publish channels, release gate evaluator, release CI profile, and status report added; stable commercial publication still requires real signing, SBOM generation, native SCTP evidence, and external interoperability evidence |
 | Developer experience | Phase 11 foundation-ready: capability catalog, M3UA ASP-to-SG quickstart, sample templates, configuration profiles, troubleshooting index, API reference index, adoption gates, documentation readiness report, DX CI profile, and status report added; enterprise production adoption still requires commercial readiness |
-| Operations | Phase 12 started: production operations capability catalog, runbook catalog, incident response targets, health check matrix, rollback plan, maintenance policy, and support handbook added |
+| Operations | Phase 12 started: production operations capability catalog, runbook catalog, incident response targets, health check matrix, rollback plan, maintenance policy, support handbook, and readiness report added |
 | Package governance | Phase 7 policy added: current package metadata is tracked; commercial target still requires package signing and SBOM automation |
 | Security governance | Phase 7 security policy added with private disclosure and severity response targets |
 | Compatibility policy | Phase 7 policy added: net10.0 target, SemVer, pre-stable breaking-change allowance, and stable major-version rule |

docs/PHASE12_OPERATIONS.md

@@ -39,3 +39,9 @@ The plan stops publication, communicates the affected version, preserves artifac
 ## Support Handbook
 
 `SigtranSupportHandbook.GetRules()` defines public GitHub issue support, private security disclosure, and commercial escalation channels.
+
+## Operations Readiness
+
+`SigtranOperationsReadiness.GetReport()` separates operations foundation readiness from production operations readiness.
+
+Production operations remain blocked until wider commercial readiness is complete.

src/sigtran.net.Tests/Program.cs

@@ -67,6 +67,7 @@
 Run("SIGTRAN rollback plan defines package recovery steps", SigtranRollbackPlanDefinesPackageRecoverySteps);
 Run("SIGTRAN maintenance policy gates protocol and transport changes", SigtranMaintenancePolicyGatesProtocolAndTransportChanges);
 Run("SIGTRAN support handbook defines public private and commercial channels", SigtranSupportHandbookDefinesPublicPrivateAndCommercialChannels);
+Run("SIGTRAN operations readiness separates foundation from production", SigtranOperationsReadinessSeparatesFoundationFromProduction);
 Run("Native SCTP platform probe reports socket creation capability", NativeSctpPlatformProbeReportsSocketCreationCapability);
 Run("Native SCTP socket factory creates or reports unsupported platform", NativeSctpSocketFactoryCreatesOrReportsUnsupportedPlatform);
 Run("Native SCTP connection planner resolves endpoints", NativeSctpConnectionPlannerResolvesEndpoints);
@@ -906,6 +907,15 @@ static void SigtranSupportHandbookDefinesPublicPrivateAndCommercialChannels()
     Assert(rules.Any(static rule => rule.Channel == SigtranSupportChannel.Commercial && rule.EscalatesIncidents), "support should include commercial escalation");
 }
 
+static void SigtranOperationsReadinessSeparatesFoundationFromProduction()
+{
+    SigtranOperationsReadinessReport report = SigtranOperationsReadiness.GetReport();
+
+    Assert(report.FoundationReady, "operations foundation should be ready");
+    Assert(!report.CommercialReady, "commercial readiness should still require external gates");
+    Assert(!report.ProductionOperationsReady, "production operations should wait for commercial readiness");
+}
+
 static void NativeSctpPlatformProbeReportsSocketCreationCapability()
 {
     AssertEqual(132, NativeSctpPlatform.IpProtocolSctp, "native SCTP protocol number");

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

@@ -0,0 +1,80 @@
+namespace sigtran.net.Core.Utilities;
+
+/// <summary>
+/// Describes production operations readiness.
+/// </summary>
+public sealed class SigtranOperationsReadinessReport
+{
+    /// <summary>Creates an operations readiness report.</summary>
+    /// <param name="hasRunbooks">Whether runbooks are available.</param>
+    /// <param name="hasIncidentTargets">Whether incident targets are available.</param>
+    /// <param name="hasHealthChecks">Whether health checks are available.</param>
+    /// <param name="hasRollbackPlan">Whether rollback plan is available.</param>
+    /// <param name="hasMaintenancePolicy">Whether maintenance policy is available.</param>
+    /// <param name="hasSupportHandbook">Whether support handbook is available.</param>
+    /// <param name="commercialReady">Whether commercial readiness is complete.</param>
+    public SigtranOperationsReadinessReport(
+        bool hasRunbooks,
+        bool hasIncidentTargets,
+        bool hasHealthChecks,
+        bool hasRollbackPlan,
+        bool hasMaintenancePolicy,
+        bool hasSupportHandbook,
+        bool commercialReady)
+    {
+        HasRunbooks = hasRunbooks;
+        HasIncidentTargets = hasIncidentTargets;
+        HasHealthChecks = hasHealthChecks;
+        HasRollbackPlan = hasRollbackPlan;
+        HasMaintenancePolicy = hasMaintenancePolicy;
+        HasSupportHandbook = hasSupportHandbook;
+        CommercialReady = commercialReady;
+    }
+
+    /// <summary>Whether runbooks are available.</summary>
+    public bool HasRunbooks { get; }
+
+    /// <summary>Whether incident targets are available.</summary>
+    public bool HasIncidentTargets { get; }
+
+    /// <summary>Whether health checks are available.</summary>
+    public bool HasHealthChecks { get; }
+
+    /// <summary>Whether rollback plan is available.</summary>
+    public bool HasRollbackPlan { get; }
+
+    /// <summary>Whether maintenance policy is available.</summary>
+    public bool HasMaintenancePolicy { get; }
+
+    /// <summary>Whether support handbook is available.</summary>
+    public bool HasSupportHandbook { get; }
+
+    /// <summary>Whether commercial readiness is complete.</summary>
+    public bool CommercialReady { get; }
+
+    /// <summary>Whether operations foundation is ready.</summary>
+    public bool FoundationReady => HasRunbooks && HasIncidentTargets && HasHealthChecks && HasRollbackPlan && HasMaintenancePolicy && HasSupportHandbook;
+
+    /// <summary>Whether production operations are ready.</summary>
+    public bool ProductionOperationsReady => FoundationReady && CommercialReady;
+}
+
+/// <summary>
+/// Provides operations readiness helpers.
+/// </summary>
+public static class SigtranOperationsReadiness
+{
+    /// <summary>Returns the current operations readiness report.</summary>
+    /// <returns>The current operations readiness report.</returns>
+    public static SigtranOperationsReadinessReport GetReport()
+    {
+        return new(
+            hasRunbooks: SigtranRunbooks.GetRunbooks().Count > 0,
+            hasIncidentTargets: SigtranIncidentResponse.GetTargets().Count > 0,
+            hasHealthChecks: SigtranHealthChecks.GetDefinitions().Count > 0,
+            hasRollbackPlan: SigtranRollbackPlans.CreateDefaultPackageRollback().Steps.Count > 0,
+            hasMaintenancePolicy: SigtranMaintenancePolicies.CreateDefault().RequiresRollbackPlan,
+            hasSupportHandbook: SigtranSupportHandbook.GetRules().Count > 0,
+            commercialReady: SigtranCommercialReadiness.GetReport().CommercialReady);
+    }
+}