Files
git.stella-ops.org/docs/features/checked/integrations/scm-annotation-client-contracts.md
2026-02-13 02:04:55 +02:00

30 lines
1.5 KiB
Markdown

# 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)