Add commercial evidence dossier intake report

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, and completeness evaluation 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, and explicit intake blockers to a governed execution run; dossier reporting, promotion handoff, execution bridge, 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, and dossier 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, and a retained Markdown summary to a governed execution run; promotion handoff, execution bridge, status reporting, and final validation remain |
 
 ## Requirements
 

docs/PHASE38_COMMERCIAL_EVIDENCE_ARTIFACT_INTAKE.md

@@ -61,6 +61,19 @@ Each required review records the retained path, artifact kind, reviewer identity
 
 The evaluator returns explicit blocker codes such as `artifact-source-registration-incomplete`, `artifact-digest-coverage-incomplete`, and `redaction-review-incomplete` so release operators can correct the right evidence area without guessing.
 
+## Unit 6 - Dossier Intake Report
+
+`SigtranCommercialEvidenceDossierIntakeReports` creates a retained Markdown report for the intake:
+
+- Execution run identifier.
+- Intake identifier.
+- Reviewer identity.
+- Dossier root.
+- Source, digest, and redaction review counts.
+- Completion state and blocker count.
+
+The report path must be under the intake dossier root. This gives release operators a single retained summary before promotion handoff.
+
 ## Validation
 
 Each unit in this phase is validated with:

docs/PHASE38_SUMMARY.md

@@ -9,7 +9,8 @@ Phase 38 prepares the SDK to receive real execution artifacts and convert them i
 - Artifact digest manifest that requires SHA-256 coverage for every retained source.
 - Redaction review manifest that requires approved review for trace-bearing retained artifacts.
 - Artifact completeness evaluator that reports explicit source, digest, and redaction blockers.
+- Dossier intake report that renders a retained Markdown summary for the execution run, intake id, reviewer, counts, completion state, and blockers.
 
 ## Readiness Position
 
-The phase is in progress. Artifact intake identity, source registration, digest coverage, redaction review, and completeness evaluation are available. Dossier reporting, promotion handoff, execution bridge, status reporting, and final validation remain.
+The phase is in progress. Artifact intake identity, source registration, digest coverage, redaction review, completeness evaluation, and dossier reporting are available. Promotion handoff, execution bridge, status reporting, and final validation remain.

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; completeness evaluation 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; dossier 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, promotion handoff, execution bridge, 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, execution bridge, status reporting, and final validation remain in progress.
 
 ## Recommended First Deliverable
 

src/Sigtran.NET.Tests/Program.cs

@@ -292,6 +292,7 @@
 Run("SIGTRAN commercial evidence artifact digests cover retained sources", SigtranCommercialEvidenceArtifactDigestsCoverRetainedSources);
 Run("SIGTRAN commercial evidence redaction reviews approve trace-bearing artifacts", SigtranCommercialEvidenceRedactionReviewsApproveTraceBearingArtifacts);
 Run("SIGTRAN commercial evidence artifact completeness reports blockers", SigtranCommercialEvidenceArtifactCompletenessReportsBlockers);
+Run("SIGTRAN commercial evidence dossier intake report renders retained summary", SigtranCommercialEvidenceDossierIntakeReportRendersRetainedSummary);
 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);
@@ -4898,6 +4899,24 @@ static void SigtranCommercialEvidenceArtifactCompletenessReportsBlockers()
     Assert(blocked.Blockers.Contains("redaction-review-incomplete"), "blocked completeness should report redaction review");
 }
 
+static void SigtranCommercialEvidenceDossierIntakeReportRendersRetainedSummary()
+{
+    SigtranCommercialEvidenceArtifactCompletenessResult completeness = CreateDefaultCommercialEvidenceArtifactCompletenessResult();
+    SigtranCommercialEvidenceDossierIntakeReport report = SigtranCommercialEvidenceDossierIntakeReports.CreateDefault(completeness);
+    string markdown = report.RenderMarkdown();
+
+    Assert(report.IsReady, markdown);
+    Assert(report.UsesDossierReportPath, "dossier intake report should be retained under dossier root");
+    Assert(markdown.Contains("run-20260622-001", StringComparison.Ordinal), "dossier intake report should include run id");
+    Assert(markdown.Contains("intake-20260622-001", StringComparison.Ordinal), "dossier intake report should include intake id");
+    Assert(markdown.Contains("Complete: `True`", StringComparison.Ordinal), "dossier intake report should include completion state");
+}
+
+static SigtranCommercialEvidenceArtifactCompletenessResult CreateDefaultCommercialEvidenceArtifactCompletenessResult()
+{
+    return SigtranCommercialEvidenceArtifactCompleteness.Evaluate(CreateDefaultCommercialEvidenceRedactionReviewManifest());
+}
+
 static SigtranCommercialEvidenceRedactionReviewManifest CreateDefaultCommercialEvidenceRedactionReviewManifest()
 {
     return SigtranCommercialEvidenceRedactionReviews.CreateApproved(

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

@@ -0,0 +1,84 @@
+namespace Sigtran.NET.Core.Utilities;
+
+/// <summary>
+/// Describes the commercial evidence dossier intake report.
+/// </summary>
+public sealed class SigtranCommercialEvidenceDossierIntakeReport
+{
+    /// <summary>Creates a commercial evidence dossier intake report.</summary>
+    /// <param name="completeness">The artifact completeness result.</param>
+    /// <param name="reportPath">The retained report path.</param>
+    public SigtranCommercialEvidenceDossierIntakeReport(
+        SigtranCommercialEvidenceArtifactCompletenessResult completeness,
+        string reportPath)
+    {
+        Completeness = completeness ?? throw new ArgumentNullException(nameof(completeness));
+        ReportPath = string.IsNullOrWhiteSpace(reportPath) ? throw new ArgumentException("Report path is required.", nameof(reportPath)) : reportPath;
+    }
+
+    /// <summary>The artifact completeness result.</summary>
+    public SigtranCommercialEvidenceArtifactCompletenessResult Completeness { get; }
+
+    /// <summary>The retained report path.</summary>
+    public string ReportPath { get; }
+
+    /// <summary>The artifact intake target.</summary>
+    public SigtranCommercialEvidenceArtifactIntakeTarget Target => Completeness.RedactionReviewManifest.DigestManifest.SourceManifest.Target;
+
+    /// <summary>The number of registered artifact sources.</summary>
+    public int SourceCount => Completeness.RedactionReviewManifest.DigestManifest.SourceManifest.Sources.Count;
+
+    /// <summary>The number of digest entries.</summary>
+    public int DigestCount => Completeness.RedactionReviewManifest.DigestManifest.Digests.Count;
+
+    /// <summary>The number of redaction reviews.</summary>
+    public int RedactionReviewCount => Completeness.RedactionReviewManifest.Reviews.Count;
+
+    /// <summary>Whether the report path is scoped under the dossier root.</summary>
+    public bool UsesDossierReportPath => ReportPath.StartsWith(Target.DossierRoot + "/", StringComparison.Ordinal);
+
+    /// <summary>Whether the report is ready for retention.</summary>
+    public bool IsReady => Completeness.IsComplete
+        && UsesDossierReportPath
+        && SourceCount > 0
+        && DigestCount == SourceCount;
+
+    /// <summary>Renders the report as Markdown.</summary>
+    /// <returns>The rendered Markdown report.</returns>
+    public string RenderMarkdown()
+    {
+        return string.Join(
+            Environment.NewLine,
+            [
+                "# Commercial Evidence Dossier Intake Report",
+                string.Empty,
+                $"Run: `{Target.ExecutionRun.RunId}`",
+                $"Intake: `{Target.IntakeId}`",
+                $"Reviewer: `{Target.ReviewerName}`",
+                $"Dossier root: `{Target.DossierRoot}`",
+                $"Sources: `{SourceCount}`",
+                $"Digests: `{DigestCount}`",
+                $"Redaction reviews: `{RedactionReviewCount}`",
+                $"Complete: `{Completeness.IsComplete}`",
+                $"Blockers: `{Completeness.Blockers.Count}`"
+            ]);
+    }
+}
+
+/// <summary>
+/// Provides commercial evidence dossier intake report helpers.
+/// </summary>
+public static class SigtranCommercialEvidenceDossierIntakeReports
+{
+    /// <summary>Creates the default retained dossier intake report.</summary>
+    /// <param name="completeness">The artifact completeness result.</param>
+    /// <returns>The dossier intake report.</returns>
+    public static SigtranCommercialEvidenceDossierIntakeReport CreateDefault(
+        SigtranCommercialEvidenceArtifactCompletenessResult completeness)
+    {
+        ArgumentNullException.ThrowIfNull(completeness);
+        SigtranCommercialEvidenceArtifactIntakeTarget target = completeness.RedactionReviewManifest.DigestManifest.SourceManifest.Target;
+
+        return new(completeness, $"{target.DossierRoot}/intake-report.md");
+    }
+}