Complete commercial evidence artifact intake

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, 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 |
+| Commercial evidence artifact intake | Phase 38 foundation-complete: artifact intake target identity, artifact source registration, SHA-256 digest coverage, redaction review, completeness evaluation, dossier reporting, promotion handoff, execution-to-dossier bridge, status reporting, and final validation 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; real artifact files are still required before commercial publication |
 
 ## Requirements
 

docs/PHASE38_COMMERCIAL_EVIDENCE_ARTIFACT_INTAKE.md

@@ -110,7 +110,18 @@ The bridge is intentionally a contract builder, not a file executor. Real artifa
 - 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.
+The status keeps foundation readiness separate from commercial publication readiness. Real file evidence remains a blocker until retained artifacts are captured, reviewed, and approved.
+
+## Unit 10 - Final Validation
+
+Final validation closes the artifact intake foundation:
+
+- Build, test, and package validation are run together.
+- `final-validation` is included in the public status capability list.
+- The temporary final-validation blocker is removed.
+- The real artifact file evidence blocker remains active.
+
+This keeps the phase complete as an SDK foundation while preserving the commercial release gate until real artifact files are retained and reviewed.
 
 ## Validation
 

docs/PHASE38_SUMMARY.md

@@ -13,7 +13,8 @@ Phase 38 prepares the SDK to receive real execution artifacts and convert them i
 - 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.
+- Final validation that closes the artifact intake foundation while retaining the real artifact evidence blocker.
 
 ## Readiness Position
 
-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.
+Phase 38 is foundation-complete. The SDK can receive and model a governed artifact intake pipeline from execution artifacts to digest-covered promotion handoff, but commercial publication remains blocked until real artifact files are retained, digest-calculated, redaction-reviewed, and approved.

docs/PHASE_INDEX.md

@@ -42,8 +42,8 @@ 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; status reporting complete |
+| 38 | Commercial evidence artifact intake | [Phase 38 Commercial Evidence Artifact Intake](PHASE38_COMMERCIAL_EVIDENCE_ARTIFACT_INTAKE.md), [Phase 38 Summary](PHASE38_SUMMARY.md) | Foundation complete; real artifact files still required |
 
 ## Current Commercial Gate
 
-The SDK can now define governed commercial evidence-producing execution and begin intake of retained artifacts when protected secrets are available. RC publication remains blocked until retained execution-run, release-run, and commercial evidence artifacts are complete. Stable publication remains blocked until external peer evidence, trusted timestamped signing, production performance evidence, retained release-run artifacts, and the commercial evidence dossier are complete.
+The SDK can now define governed commercial evidence-producing execution and model intake of retained artifacts when protected secrets are available. RC publication remains blocked until retained execution-run, release-run, and commercial evidence artifacts are complete. Stable publication remains blocked until external peer evidence, trusted timestamped signing, production performance evidence, retained release-run artifacts, real artifact file evidence, and the commercial evidence dossier are complete.

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 now exposes completed capabilities, foundation readiness, real artifact evidence readiness, publication readiness, and current blockers. Final validation remains in progress.
+Status: Phase 38 is foundation-complete. Artifact intake target identity 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 maps every required expected execution artifact to a concrete source path and unique retained dossier path while rejecting floating `artifacts/latest` aliases. Digest coverage records SHA-256 values for every retained source and blocks invalid digest values. Redaction review requires approved reviewer records for trace-bearing retained artifacts. Completeness evaluation reports explicit source, digest, and redaction blockers. Dossier reporting renders a retained Markdown summary with run, intake, reviewer, counts, completion state, and blockers. Promotion handoff includes all digest-covered retained artifacts and the dossier intake report. Execution-to-dossier bridge assembles the intake pipeline from a governed execution run. Status reporting exposes completed capabilities, foundation readiness, real artifact evidence readiness, publication readiness, and current blockers. Final validation is complete. Commercial publication remains blocked until real artifact files are retained, digest-calculated, redaction-reviewed, and approved.
 
 ## Recommended First Deliverable
 

src/Sigtran.NET.Tests/Program.cs

@@ -4963,15 +4963,16 @@ static void SigtranCommercialEvidenceArtifactIntakeStatusSummarizesFoundationRea
     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");
+    AssertEqual(10, SigtranCommercialEvidenceArtifactIntakeStatus.CompletedUnitCount, "artifact intake completed unit count");
+    AssertEqual(10, capabilities.Count, "artifact intake capability count");
     Assert(capabilities.Contains("execution-dossier-bridge"), "artifact intake status should include execution bridge");
+    Assert(capabilities.Contains("final-validation"), "artifact intake status should include final validation");
     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");
+    Assert(!blockers.Contains("status-final-validation-pending"), "final validation should no longer be a blocker");
 }
 
 static SigtranCommercialEvidenceDossierIntakeReport CreateDefaultCommercialEvidenceDossierIntakeReport()

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

@@ -15,20 +15,20 @@ public static class SigtranCommercialEvidenceArtifactIntakeStatus
         "dossier-intake-report",
         "promotion-handoff",
         "execution-dossier-bridge",
+        "final-validation",
         "documentation"
     ];
 
     private static readonly string[] DefaultBlockers =
     [
-        "real-artifact-file-evidence-required",
-        "status-final-validation-pending"
+        "real-artifact-file-evidence-required"
     ];
 
     /// <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;
+    public const int CompletedUnitCount = 10;
 
     /// <summary>Returns the completed artifact intake capability names.</summary>
     /// <returns>The completed capability names.</returns>