[docs] Update glossary - daily scan

[github-actions]

Glossary Updates

Scan Type: Incremental (daily)

Terms Added:

• CoverageAggregation: New public enum in MTP for combining per-scope values in threshold evaluations
• CoverageMetric: New public enum identifying a coverage metric (Line, Branch, Block, etc.)
• CoverageMetricResult: New public class for a single correlated coverage measurement
• CoverageReportFormat: New public enum for coverage report on-disk formats
• CoverageReportReference: New public class pointing to a rich coverage report artifact
• CoverageScope: New public readonly struct identifying the entity a coverage entry describes
• CoverageScopeLevel: New public enum for CoverageScope granularity
• CoverageScopeSummary: New public class aggregating all coverage metrics for a single scope
• ITestCoverageCapabilities: New public interface describing coverage messaging capabilities
• ITestCoverageResult: New public interface, the application-scoped read model for coverage data
• TestCoverageMessage: New public sealed class published to MTP bus by coverage collectors
• TestCoverageReportMessage: New public sealed class registering a coverage report artifact
• TestCoverageThresholdMessage: New public sealed class for a coverage threshold evaluation result

Changes Analyzed:

• Reviewed 1 commit from the last 24 hours
• Analyzed PR Add test coverage messages, coverage threshold checks, and summary #9896 (Add test coverage messages, coverage threshold checks, and summary)

Related Changes:

• Commit c88be40 / PR Add test coverage messages, coverage threshold checks, and summary #9896: Introduced the RFC 019 coverage message contract in Microsoft.Testing.Platform.Extensions.Messages and Microsoft.Testing.Platform.Services; also introduced ExitCode.CoverageThresholdFailed (14).

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

🤖 Automated content by GitHub Copilot. Generated by the Glossary Maintainer workflow. · 164.4 AIC · ⌖ 11.2 AIC · ⊞ 7.5K · [◷]( · ◷)

_{Add this agentic workflow to your repo}

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/glossary-maintainer.md@main

• expires on Jul 25, 2026, 5:43 AM UTC

---

Note

This was originally intended as a pull request, but GitHub Actions is not permitted to create or approve pull requests in this repository.
The changes have been pushed to branch docs/glossary-coverage-api-terms-da5f6ffd990aa9b4.

Click here to create the pull request

To fix the permissions issue, go to Settings → Actions → General and enable Allow GitHub Actions to create and approve pull requests. See also: gh-aw FAQ

Show patch preview (115 of 115 lines)

From af6c20dfbcae0e76611f487b698c5bb1e914e505 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Thu, 23 Jul 2026 05:39:19 +0000
Subject: [PATCH] docs: add glossary entries for coverage API types from PR
 #9896

Add 13 new glossary entries for the test coverage message contract
introduced in PR #9896 (ExitCode.CoverageThresholdFailed, RFC 019):

- CoverageAggregation
- CoverageMetric
- CoverageMetricResult
- CoverageReportFormat
- CoverageReportReference
- CoverageScope
- CoverageScopeLevel
- CoverageScopeSummary
- ITestCoverageCapabilities
- ITestCoverageResult
- TestCoverageMessage
- TestCoverageReportMessage
- TestCoverageThresholdMessage

All entries are placed in alphabetical order within their sections.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/glossary.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/docs/glossary.md b/docs/glossary.md
index a54728c..95d42c4 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -80,6 +80,38 @@ An abstract MSTest attribute base class in `Microsoft.VisualStudio.TestTools.Uni
 
 A public enum in `Microsoft.VisualStudio.TestTools.UnitTesting` used with [ConditionBaseAttribute](#conditionbaseattribute)-derived attributes to control whether the condition is reversed. `Include` (default): run the test only when the condition is met. `Exclude`: skip (ignore) the test when the condition is met, reversing the condition.
 
+### CoverageAggregation
+
+A public enum in `Microsoft.Testing.Platform.Extensions.Messages` (append-only, treat unrecognized values non-exhaustively) that specifies how per-scope coverage values are combined when evaluating a threshold. Values: `None` (0, not an aggregate — a single scope's own value), `Total` (aggregate covered / aggregate coverable across the population), `Minimum` (worst scope), `Average` (mean of per-scope percentages), `Maximum` (best scope). Use
... (truncated)