Add commercial evidence artifact intake status

Author: ammarheidari

README.md

@@ -73,7 +73,7 @@ The first production milestone is M3UA over a transport abstraction. SCCP, TCAP,
 | RC publish and commercial gate | Phase 35 complete: dry-run release rehearsal, gated NuGet prerelease publication, retained release notes, retained migration notes, final commercial readiness reporting, RC/stable decisioning, RC publication evidence manifest, release workflow channel wiring, status reporting, and final commercial gate report are available; stable publication remains blocked until commercial evidence is complete |
 | Commercial evidence readiness lockdown | Phase 36 foundation-complete: release target locking, protected secret readiness, evidence retention mapping, commercial evidence checklist, release preflight, protected release environments, dossier handoff, go/no-go gating, status reporting, and final validation are available; RC and stable publication remain blocked until retained commercial release evidence is complete |
 | Commercial evidence execution orchestration | Phase 37 foundation-complete: evidence execution run identity, stage catalog, operator command plan, execution environment contract, artifact collection manifest, digest/redaction verification, blocker classification, retry/resume policy, status reporting, and final validation are available; real retained execution artifacts are still required before commercial publication |
-| Commercial evidence artifact intake | Phase 38 in progress: artifact intake target identity, artifact source registration, SHA-256 digest coverage, redaction review, completeness evaluation, dossier reporting, promotion handoff, and execution-to-dossier bridge are available, binding a stable intake id, reviewer identity, UTC receipt time, run-scoped dossier root, concrete source paths, unique retained dossier paths, retained digests, trace-bearing artifact approvals, explicit intake blockers, retained Markdown summary, digest-covered handoff, and end-to-end intake assembly to a governed execution run; status reporting and final validation remain |
+| Commercial evidence artifact intake | Phase 38 in progress: artifact intake target identity, artifact source registration, SHA-256 digest coverage, redaction review, completeness evaluation, dossier reporting, promotion handoff, execution-to-dossier bridge, and status reporting are available, binding a stable intake id, reviewer identity, UTC receipt time, run-scoped dossier root, concrete source paths, unique retained dossier paths, retained digests, trace-bearing artifact approvals, explicit intake blockers, retained Markdown summary, digest-covered handoff, end-to-end intake assembly, and intake readiness status to a governed execution run; final validation remains |
 
 ## Requirements
 

docs/PHASE38_COMMERCIAL_EVIDENCE_ARTIFACT_INTAKE.md

@@ -100,6 +100,18 @@ The handoff does not publish a package. It creates a verified package of intake
 
 The bridge is intentionally a contract builder, not a file executor. Real artifact copying, digest calculation, and redaction review still happen in the lab or release workflow and provide the values passed into the bridge.
 
+## Unit 9 - Artifact Intake Status
+
+`SigtranCommercialEvidenceArtifactIntakeStatus` exposes the current artifact intake state:
+
+- Completed intake capabilities.
+- Default commercial publication blockers.
+- Artifact intake foundation readiness.
+- Real artifact evidence readiness.
+- Commercial publication readiness.
+
+The status keeps foundation readiness separate from commercial publication readiness. Real file evidence and final validation remain blockers until the phase is closed and real retained artifacts are reviewed.
+
 ## Validation
 
 Each unit in this phase is validated with:

docs/PHASE38_SUMMARY.md

@@ -12,7 +12,8 @@ Phase 38 prepares the SDK to receive real execution artifacts and convert them i
 - Dossier intake report that renders a retained Markdown summary for the execution run, intake id, reviewer, counts, completion state, and blockers.
 - Promotion handoff that includes all digest-covered retained artifacts and the dossier intake report.
 - Execution-to-dossier bridge that assembles the intake target, source manifest, digest manifest, redaction review, completeness, report, and handoff from a governed execution run.
+- Artifact intake status that exposes completed capabilities, foundation readiness, real artifact evidence readiness, publication readiness, and current blockers.
 
 ## Readiness Position
 
-The phase is in progress. Artifact intake identity, source registration, digest coverage, redaction review, completeness evaluation, dossier reporting, promotion handoff, and execution bridge are available. Status reporting and final validation remain.
+The phase is in progress. Artifact intake identity, source registration, digest coverage, redaction review, completeness evaluation, dossier reporting, promotion handoff, execution bridge, and status reporting are available. Final validation remains.

docs/PHASE_INDEX.md

@@ -42,7 +42,7 @@ This index is the complete phase map for Sigtran.NET. It links each phase to the
 | 35 | RC publish and commercial gate | [Phase 35 RC Publish And Commercial Gate](PHASE35_RC_PUBLISH_COMMERCIAL_GATE.md), [Phase 35 Summary](PHASE35_SUMMARY.md), [Phase 35 Commercial Gate Report](PHASE35_COMMERCIAL_GATE_REPORT.md) | RC gate foundation complete; stable publication blocked |
 | 36 | Commercial evidence readiness lockdown | [Phase 36 Commercial Evidence Readiness Lockdown](PHASE36_COMMERCIAL_EVIDENCE_READINESS_LOCKDOWN.md), [Phase 36 Summary](PHASE36_SUMMARY.md) | Foundation complete; real commercial evidence still required |
 | 37 | Commercial evidence execution orchestration | [Phase 37 Commercial Evidence Execution Orchestration](PHASE37_COMMERCIAL_EVIDENCE_EXECUTION_ORCHESTRATION.md), [Phase 37 Summary](PHASE37_SUMMARY.md) | Foundation complete; real execution artifacts still required |
-| 38 | Commercial evidence artifact intake | [Phase 38 Commercial Evidence Artifact Intake](PHASE38_COMMERCIAL_EVIDENCE_ARTIFACT_INTAKE.md), [Phase 38 Summary](PHASE38_SUMMARY.md) | In progress; execution bridge complete |
+| 38 | Commercial evidence artifact intake | [Phase 38 Commercial Evidence Artifact Intake](PHASE38_COMMERCIAL_EVIDENCE_ARTIFACT_INTAKE.md), [Phase 38 Summary](PHASE38_SUMMARY.md) | In progress; status reporting complete |
 
 ## Current Commercial Gate
 

docs/SDK_ROADMAP.md

@@ -339,7 +339,7 @@ Status: Phase 37 is foundation-complete. Evidence execution run identity binds a
 - Register artifact sources, digests, redaction reviews, completeness results, dossier reports, promotion handoff, and execution-to-dossier bridging.
 - Keep intake foundation separate from commercial publication: intake can prove that artifacts are ready for review, but publication remains blocked until all retained evidence is complete and approved.
 
-Status: Phase 38 is in progress. Artifact intake target identity now binds a stable intake id, reviewer identity, UTC receipt time, and run-scoped dossier root to a governed commercial evidence execution run. Artifact source registration now maps every required expected execution artifact to a concrete source path and unique retained dossier path while rejecting floating `artifacts/latest` aliases. Digest coverage now records SHA-256 values for every retained source and blocks invalid digest values. Redaction review now requires approved reviewer records for trace-bearing retained artifacts. Completeness evaluation now reports explicit source, digest, and redaction blockers. Dossier reporting now renders a retained Markdown summary with run, intake, reviewer, counts, completion state, and blockers. Promotion handoff now includes all digest-covered retained artifacts and the dossier intake report. Execution-to-dossier bridge now assembles the intake pipeline from a governed execution run. Status reporting and final validation remain in progress.
+Status: Phase 38 is in progress. Artifact intake target identity now binds a stable intake id, reviewer identity, UTC receipt time, and run-scoped dossier root to a governed commercial evidence execution run. Artifact source registration now maps every required expected execution artifact to a concrete source path and unique retained dossier path while rejecting floating `artifacts/latest` aliases. Digest coverage now records SHA-256 values for every retained source and blocks invalid digest values. Redaction review now requires approved reviewer records for trace-bearing retained artifacts. Completeness evaluation now reports explicit source, digest, and redaction blockers. Dossier reporting now renders a retained Markdown summary with run, intake, reviewer, counts, completion state, and blockers. Promotion handoff now includes all digest-covered retained artifacts and the dossier intake report. Execution-to-dossier bridge now assembles the intake pipeline from a governed execution run. Status reporting now exposes completed capabilities, foundation readiness, real artifact evidence readiness, publication readiness, and current blockers. Final validation remains in progress.
 
 ## Recommended First Deliverable
 

src/Sigtran.NET.Tests/Program.cs

@@ -295,6 +295,7 @@
 Run("SIGTRAN commercial evidence dossier intake report renders retained summary", SigtranCommercialEvidenceDossierIntakeReportRendersRetainedSummary);
 Run("SIGTRAN commercial evidence promotion handoff includes digests and report", SigtranCommercialEvidencePromotionHandoffIncludesDigestsAndReport);
 Run("SIGTRAN commercial evidence dossier intake bridge builds handoff from execution run", SigtranCommercialEvidenceDossierIntakeBridgeBuildsHandoffFromExecutionRun);
+Run("SIGTRAN commercial evidence artifact intake status summarizes foundation readiness", SigtranCommercialEvidenceArtifactIntakeStatusSummarizesFoundationReadiness);
 Run("SIGTRAN status capabilities use domain documentation labels", SigtranStatusCapabilitiesUseDomainDocumentationLabels);
 Run("Native SCTP platform probe reports socket creation capability", NativeSctpPlatformProbeReportsSocketCreationCapability);
 Run("Native SCTP socket factory creates or reports unsupported platform", NativeSctpSocketFactoryCreatesOrReportsUnsupportedPlatform);
@@ -4957,6 +4958,22 @@ static void SigtranCommercialEvidenceDossierIntakeBridgeBuildsHandoffFromExecuti
     Assert(result.Report.ReportPath.StartsWith(result.Target.DossierRoot, StringComparison.Ordinal), "bridge report should stay under dossier root");
 }
 
+static void SigtranCommercialEvidenceArtifactIntakeStatusSummarizesFoundationReadiness()
+{
+    IReadOnlyList<string> capabilities = SigtranCommercialEvidenceArtifactIntakeStatus.GetCompletedCapabilities();
+    IReadOnlyList<string> blockers = SigtranCommercialEvidenceArtifactIntakeStatus.GetDefaultBlockers();
+
+    AssertEqual(9, SigtranCommercialEvidenceArtifactIntakeStatus.CompletedUnitCount, "artifact intake completed unit count");
+    AssertEqual(9, capabilities.Count, "artifact intake capability count");
+    Assert(capabilities.Contains("execution-dossier-bridge"), "artifact intake status should include execution bridge");
+    Assert(capabilities.Contains("documentation"), "artifact intake status should include documentation");
+    Assert(SigtranCommercialEvidenceArtifactIntakeStatus.ArtifactIntakeFoundationReady, SigtranCommercialEvidenceArtifactIntakeStatus.Describe());
+    Assert(!SigtranCommercialEvidenceArtifactIntakeStatus.RealArtifactEvidenceReady, SigtranCommercialEvidenceArtifactIntakeStatus.Describe());
+    Assert(!SigtranCommercialEvidenceArtifactIntakeStatus.CommercialPublicationReady, SigtranCommercialEvidenceArtifactIntakeStatus.Describe());
+    Assert(blockers.Contains("real-artifact-file-evidence-required"), "artifact intake status should require real file evidence");
+    Assert(blockers.Contains("status-final-validation-pending"), "artifact intake status should retain final validation blocker before closeout");
+}
+
 static SigtranCommercialEvidenceDossierIntakeReport CreateDefaultCommercialEvidenceDossierIntakeReport()
 {
     return SigtranCommercialEvidenceDossierIntakeReports.CreateDefault(CreateDefaultCommercialEvidenceArtifactCompletenessResult());
@@ -5028,7 +5045,8 @@ static void SigtranStatusCapabilitiesUseDomainDocumentationLabels()
         SigtranSupplyChainReleaseStatus.GetCompletedCapabilities(),
         SigtranReleaseCandidatePublicationStatus.GetCompletedCapabilities(),
         SigtranCommercialEvidenceReadinessLockdownStatus.GetCompletedCapabilities(),
-        SigtranCommercialEvidenceExecutionStatus.GetCompletedCapabilities()
+        SigtranCommercialEvidenceExecutionStatus.GetCompletedCapabilities(),
+        SigtranCommercialEvidenceArtifactIntakeStatus.GetCompletedCapabilities()
     ];
 
     foreach (IReadOnlyList<string> capabilities in statusCapabilities)

src/Sigtran.NET/Core/Utilities/SigtranCommercialEvidenceArtifactIntakeStatus.cs

@@ -0,0 +1,84 @@
+namespace Sigtran.NET.Core.Utilities;
+
+/// <summary>
+/// Provides commercial evidence artifact intake status reporting.
+/// </summary>
+public static class SigtranCommercialEvidenceArtifactIntakeStatus
+{
+    private static readonly string[] Capabilities =
+    [
+        "artifact-intake-target",
+        "artifact-source-manifest",
+        "artifact-digest-manifest",
+        "redaction-review-manifest",
+        "artifact-completeness-evaluation",
+        "dossier-intake-report",
+        "promotion-handoff",
+        "execution-dossier-bridge",
+        "documentation"
+    ];
+
+    private static readonly string[] DefaultBlockers =
+    [
+        "real-artifact-file-evidence-required",
+        "status-final-validation-pending"
+    ];
+
+    /// <summary>The status label.</summary>
+    public const string StatusLabel = "Commercial Evidence Artifact Intake";
+
+    /// <summary>The number of completed commercial evidence artifact intake work units.</summary>
+    public const int CompletedUnitCount = 9;
+
+    /// <summary>Returns the completed artifact intake capability names.</summary>
+    /// <returns>The completed capability names.</returns>
+    public static IReadOnlyList<string> GetCompletedCapabilities()
+    {
+        return Capabilities.ToArray();
+    }
+
+    /// <summary>Returns default blockers for commercial publication.</summary>
+    /// <returns>The default commercial publication blockers.</returns>
+    public static IReadOnlyList<string> GetDefaultBlockers()
+    {
+        return DefaultBlockers.ToArray();
+    }
+
+    /// <summary>Whether the artifact intake foundation contracts are ready.</summary>
+    public static bool ArtifactIntakeFoundationReady => Capabilities.Length == CompletedUnitCount
+        && CreateDefaultBridgeResult().IsReady;
+
+    /// <summary>Whether real artifact file evidence is available in the default status.</summary>
+    public static bool RealArtifactEvidenceReady => false;
+
+    /// <summary>Whether artifact intake currently allows commercial publication.</summary>
+    public static bool CommercialPublicationReady => ArtifactIntakeFoundationReady
+        && RealArtifactEvidenceReady
+        && DefaultBlockers.Length == 0;
+
+    /// <summary>Formats a compact commercial evidence artifact intake summary.</summary>
+    /// <returns>The commercial evidence artifact intake summary.</returns>
+    public static string Describe()
+    {
+        return $"{StatusLabel}: completedUnits={CompletedUnitCount} capabilities={Capabilities.Length} foundationReady={ArtifactIntakeFoundationReady} realArtifactEvidenceReady={RealArtifactEvidenceReady} commercialPublicationReady={CommercialPublicationReady} blockers={DefaultBlockers.Length}";
+    }
+
+    private static SigtranCommercialEvidenceDossierIntakeBridgeResult CreateDefaultBridgeResult()
+    {
+        SigtranCommercialEvidenceExecutionRun run = SigtranCommercialEvidenceExecutionRuns.CreateReleaseCandidateRun(
+            "1.0.0-rc.1",
+            "abcdef123456",
+            "run-20260622-001",
+            "release-automation",
+            DateTimeOffset.UtcNow);
+
+        return SigtranCommercialEvidenceDossierIntakeBridge.BuildDefault(
+            run,
+            "intake-20260622-001",
+            "release-review",
+            $"{run.RunArtifactRoot}/incoming/intake-20260622-001",
+            new string('a', 64),
+            new string('b', 64),
+            DateTimeOffset.UtcNow);
+    }
+}