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

1.5 KiB

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

  • 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

Verification

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