.NET: add public API analyzers - #7935
Merged
Merged
Conversation
Add PublicAPI analyzer coverage for released .NET packages, including nullable-aware shipped baselines and unshipped API publish validation. Add automation to promote unshipped API entries into shipped baselines after release branches move forward. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Vincent Biret (baywet)
temporarily deployed
to
github-app-auth
August 28, 2026 16:51 — with 
GitHub Actions
Inactive
GitHub Actions
Inactive
Vincent Biret (baywet)
temporarily deployed
to
github-app-auth
August 28, 2026 16:51 — with
GitHub Actions
Inactive
GitHub Actions
Inactive
Vincent Biret (baywet)
temporarily deployed
to
github-app-auth
August 28, 2026 16:51 — with
GitHub Actions
Inactive
GitHub Actions
Inactive
Vincent Biret (baywet)
had a problem deploying
to
integration
August 28, 2026 16:51 — with
GitHub Actions
Error
GitHub Actions
Error
Vincent Biret (baywet)
had a problem deploying
to
integration
August 28, 2026 16:51 — with
GitHub Actions
Error
GitHub Actions
Error
agent-framework-automation
Bot
added
documentation
Vincent Biret (baywet)
marked this pull request as ready for review
August 28, 2026 16:52
Vincent Biret (baywet)
requested review from
SergeyMenshykh,
Tao Chen (TaoChenOSU),
chetantoshniwal,
Eduard van Valkenburg (eavanvalkenburg),
Giles Odigwe (giles17),
Evan Mattson (moonbox3),
Peter Ibekwe (peibekwe),
Roger Barreto (rogerbarreto) and
westey (westey-m)
as code owners
August 28, 2026 16:52
Vincent Biret (baywet)
enabled auto-merge
August 28, 2026 16:52
Vincent Biret (baywet)
temporarily deployed
to
github-app-auth
August 28, 2026 16:52 — with
GitHub Actions
Inactive
GitHub Actions
Inactive
Contributor
There was a problem hiding this comment.
Pull request overview
Adds public API tracking and release safeguards for released .NET packages.
Changes:
- Adds nullable-aware shipped/unshipped API baselines per target framework.
- Integrates
Microsoft.CodeAnalysis.PublicApiAnalyzersand publish validation. - Adds API-promotion tooling, automation, and contributor guidance.
Reviewed changes
Copilot reviewed 74 out of 84 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
.github/workflows/promote-shipped-apis.yml |
Automates API-baseline promotion PRs. |
CONTRIBUTING.md |
Documents API-baseline workflow. |
dotnet/Directory.Packages.props |
Pins the analyzer package. |
dotnet/nuget/nuget-package.props |
Wires analyzers and publish validation. |
dotnet/eng/scripts/promote-shipped-apis.ps1 |
Promotes unshipped API entries. |
dotnet/eng/scripts/test-unshipped-public-apis.ps1 |
Rejects unshipped APIs during publishing. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/net8.0/PublicAPI.Shipped.txt |
Records net8.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/net8.0/PublicAPI.Unshipped.txt |
Initializes net8.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/net9.0/PublicAPI.Shipped.txt |
Records net9.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/net9.0/PublicAPI.Unshipped.txt |
Initializes net9.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/net10.0/PublicAPI.Shipped.txt |
Records net10.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/net10.0/PublicAPI.Unshipped.txt |
Initializes net10.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/net472/PublicAPI.Shipped.txt |
Records net472 shipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/net472/PublicAPI.Unshipped.txt |
Initializes net472 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/netstandard2.0/PublicAPI.Shipped.txt |
Records netstandard2.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt |
Initializes netstandard2.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/net8.0/PublicAPI.Shipped.txt |
Records net8.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/net8.0/PublicAPI.Unshipped.txt |
Initializes net8.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/net9.0/PublicAPI.Shipped.txt |
Records net9.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/net9.0/PublicAPI.Unshipped.txt |
Initializes net9.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/net10.0/PublicAPI.Shipped.txt |
Records net10.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/net10.0/PublicAPI.Unshipped.txt |
Initializes net10.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/net472/PublicAPI.Shipped.txt |
Records net472 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/net472/PublicAPI.Unshipped.txt |
Initializes net472 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/netstandard2.0/PublicAPI.Shipped.txt |
Records netstandard2.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Abstractions/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt |
Initializes netstandard2.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/net8.0/PublicAPI.Shipped.txt |
Records net8.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/net8.0/PublicAPI.Unshipped.txt |
Initializes net8.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/net9.0/PublicAPI.Shipped.txt |
Records net9.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/net9.0/PublicAPI.Unshipped.txt |
Initializes net9.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/net10.0/PublicAPI.Shipped.txt |
Records net10.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/net10.0/PublicAPI.Unshipped.txt |
Initializes net10.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/net472/PublicAPI.Shipped.txt |
Records net472 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/net472/PublicAPI.Unshipped.txt |
Initializes net472 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/netstandard2.0/PublicAPI.Shipped.txt |
Records netstandard2.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Harness/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt |
Initializes netstandard2.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/net8.0/PublicAPI.Shipped.txt |
Records net8.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/net8.0/PublicAPI.Unshipped.txt |
Initializes net8.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/net9.0/PublicAPI.Shipped.txt |
Records net9.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/net9.0/PublicAPI.Unshipped.txt |
Initializes net9.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/net10.0/PublicAPI.Shipped.txt |
Records net10.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/net10.0/PublicAPI.Unshipped.txt |
Initializes net10.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/net472/PublicAPI.Shipped.txt |
Records net472 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/net472/PublicAPI.Unshipped.txt |
Initializes net472 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/netstandard2.0/PublicAPI.Shipped.txt |
Records netstandard2.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.OpenAI/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt |
Initializes netstandard2.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/net8.0/PublicAPI.Shipped.txt |
Records net8.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/net8.0/PublicAPI.Unshipped.txt |
Initializes net8.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/net9.0/PublicAPI.Shipped.txt |
Records net9.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/net9.0/PublicAPI.Unshipped.txt |
Initializes net9.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/net10.0/PublicAPI.Shipped.txt |
Records net10.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/net10.0/PublicAPI.Unshipped.txt |
Initializes net10.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/net472/PublicAPI.Shipped.txt |
Records net472 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/net472/PublicAPI.Unshipped.txt |
Initializes net472 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/netstandard2.0/PublicAPI.Shipped.txt |
Records netstandard2.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt |
Initializes netstandard2.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/net8.0/PublicAPI.Shipped.txt |
Records net8.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/net8.0/PublicAPI.Unshipped.txt |
Initializes net8.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/net9.0/PublicAPI.Shipped.txt |
Records net9.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/net9.0/PublicAPI.Unshipped.txt |
Initializes net9.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/net10.0/PublicAPI.Shipped.txt |
Records net10.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/net10.0/PublicAPI.Unshipped.txt |
Initializes net10.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/net472/PublicAPI.Shipped.txt |
Records net472 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/net472/PublicAPI.Unshipped.txt |
Initializes net472 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/netstandard2.0/PublicAPI.Shipped.txt |
Records netstandard2.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt |
Initializes netstandard2.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/net8.0/PublicAPI.Shipped.txt |
Records net8.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/net8.0/PublicAPI.Unshipped.txt |
Initializes net8.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/net9.0/PublicAPI.Shipped.txt |
Records net9.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/net9.0/PublicAPI.Unshipped.txt |
Initializes net9.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/net10.0/PublicAPI.Shipped.txt |
Records net10.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/net10.0/PublicAPI.Unshipped.txt |
Initializes net10.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/net472/PublicAPI.Shipped.txt |
Records net472 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/net472/PublicAPI.Unshipped.txt |
Initializes net472 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/netstandard2.0/PublicAPI.Shipped.txt |
Records netstandard2.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative.Mcp/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt |
Initializes netstandard2.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.GitHub.Copilot/PublicAPI/net8.0/PublicAPI.Shipped.txt |
Records net8.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.GitHub.Copilot/PublicAPI/net8.0/PublicAPI.Unshipped.txt |
Initializes net8.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.GitHub.Copilot/PublicAPI/net9.0/PublicAPI.Shipped.txt |
Records net9.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.GitHub.Copilot/PublicAPI/net9.0/PublicAPI.Unshipped.txt |
Initializes net9.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.GitHub.Copilot/PublicAPI/net10.0/PublicAPI.Shipped.txt |
Records net10.0 shipped APIs. |
dotnet/src/Microsoft.Agents.AI.GitHub.Copilot/PublicAPI/net10.0/PublicAPI.Unshipped.txt |
Initializes net10.0 unshipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Generators/PublicAPI/netstandard2.0/PublicAPI.Shipped.txt |
Records generator shipped APIs. |
dotnet/src/Microsoft.Agents.AI.Workflows.Generators/PublicAPI/netstandard2.0/PublicAPI.Unshipped.txt |
Initializes generator unshipped APIs. |
💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
MAF Automated Review — Iteration 1
Result: Findings reported
Scope: full PR (1 commit(s)): 6e37574ced15
Model: gpt-5.6-sol
Overview
The PR consistently enables nullable-aware public API analysis for released packages, supplies per-TFM baselines, and adds automated validation and promotion scripts with scoped staging and lease-protected pushes. The analyzer is centrally pinned and private, while publish validation rejects populated unshipped files. Two baseline lifecycle gaps remain: the initial shipped snapshots include an API added after the latest release, and missing per-TFM baseline files silently disable both analysis and publish validation.
Reviewed the supplied pull-request change set across correctness, security/reliability, architecture, and failure behavior.
2 verified findings remained after source verification (2 medium) across 2 files. Details are attached to the affected lines below.
Affected areas: dotnet/nuget/nuget-package.props, dotnet/src/Microsoft.Agents.AI/PublicAPI/net8.0/PublicAPI.Shipped.txt
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Vincent Biret (baywet)
temporarily deployed
to
github-app-auth
August 28, 2026 16:59 — with
GitHub Actions
Inactive
GitHub Actions
Inactive
Vincent Biret (baywet)
had a problem deploying
to
integration
August 28, 2026 17:00 — with
GitHub Actions
Error
GitHub Actions
Error
Vincent Biret (baywet)
had a problem deploying
to
integration
August 28, 2026 17:00 — with
GitHub Actions
Error
GitHub Actions
Error
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This was referenced Sep 7, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation & Context
The released .NET packages need build-time public API tracking so accidental public surface changes, source-breaking changes, and nullability changes are visible during review instead of only during packaging or release validation.
This change sets up Public API Analyzers for released .NET packages and adds shipped baselines for the APIs already released.
Description & Review Guide
Adds
Microsoft.CodeAnalysis.PublicApiAnalyzers5.6.0 to released .NET packages, introduces nullable-enabled per-target-frameworkPublicAPI.Shipped.txtandPublicAPI.Unshipped.txtbaselines, adds scripts to promote and validate unshipped API entries, and adds a workflow that opens or updates promotion PRs.Builds for released packages now fail when public API additions, removals, or nullability changes are not represented in the API baseline files. Publish packaging also fails if any unshipped API entries remain.
Please focus on the analyzer wiring in
dotnet/nuget/nuget-package.props, the per-TFM baseline layout, and the shipped API promotion workflow.Related Issue
Fixes #7933
No other open PR was found for this issue.
Contribution Checklist
breaking changelabel (or add "[BREAKING]" to the title prefix, before or after any language prefix) — a workflow keeps the label and title prefix in sync automatically.