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

## Module
Integrations

## Status
IMPLEMENTED

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