REQ 025

REQ-025: Run failures are categorized policy/reporting/build from stage state

Requirement

The native pipeline shall record which of policy/reporting/build category a run failure belongs to, based on whether any stage recorded a failed gate, else whether the dependencyTrack stage was still running, else treating the failure as a build-category failure.

Rationale

Lets Test-SbomArtifact.ps1 return a distinct exit code per failure class, so a CI consumer can react differently (block a release vs. just warn) without re-parsing log text.

Fit Criterion

Complete-PipelineRunRecord sets failureCategory to policy if any stage shows gate: failed, else reporting if the dependencyTrack stage was still running, else build.

Verification

Code review of Build-Sbom.ps1's Complete-PipelineRunRecord function; cross-checked against Test-SbomArtifact.ps1's own documented exit codes (REQ-009).

Source

Software-Requirements-Specification

Priority

High

TestID

TEST-025

TestArtifact

Code review; cross-checked against Test-SbomArtifact.ps1's exit codes (REQ-009)

CodeRef

Build-Sbom.ps1 Complete-PipelineRunRecord module

Status

Verified (manual)