# SCM Annotation Client Contracts (PR/MR Comments + Status Checks)

## Module
Integrations

## Status
VERIFIED

## Description
Unified SCM annotation contracts for PR/MR comments, status checks, and check runs with evidence link fields, plus GitHub App and GitLab implementations.

## Implementation Details
- **SCM annotation contracts**: `src/Integrations/__Libraries/StellaOps.Integrations.Contracts/ScmAnnotationContracts.cs` -- unified interface for PR/MR comments, status checks, and check runs with evidence link fields
- **GitHub App annotation client**: `src/Integrations/__Plugins/StellaOps.Integrations.Plugin.GitHubApp/GitHubAppAnnotationClient.cs` -- GitHub implementation of SCM annotations
- **GitLab annotation client**: `src/Integrations/__Plugins/StellaOps.Integrations.Plugin.GitLab/GitLabAnnotationClient.cs` -- GitLab implementation of SCM annotations
- **Integration DTOs**: `src/Integrations/__Libraries/StellaOps.Integrations.Contracts/IntegrationDtos.cs` -- annotation payload models
- **Source**: SPRINT_20260112_006_INTEGRATIONS_scm_annotations.md

## E2E Test Plan
- [x] Verify GitHub App creates PR check runs with finding summaries
- [x] Test GitLab annotation posts MR comments with evidence links
- [x] Verify status check updates reflect policy evaluation results
- [x] Test evidence link fields contain valid URLs to evidence artifacts
- [x] Verify annotation contracts handle both pass/fail outcomes

## Verification
- Run ID: run-002
- Date: 2026-02-12
- Result: pass (46/46 tests, Tier 0+1+2d verified)