wcom-pr-validation 2026.5.19.3

.NET pull request validation (global tool)

A .NET global tool that clones a pull request branch, builds and tests .NET solutions, runs optional quality checks (formatting, complexity, documentation, NuGet hygiene), and posts results as comments in Azure DevOps pull requests.

Features

• Clone PR source and validate on an isolated branch
• Restore, build (including Cake when present), and test with summarized output
• Optional checks: dotnet format, outdated packages, solution migration, Roslyn-based complexity and XML documentation analysis
• Repository-specific JSON config (.wcom-pr-validation.json) with per-step opt-outs, thresholds, skip patterns, pipeline timing, and PR comment limits
• Designed for CI/CD (Azure Pipelines) using standard environment variables

Requirements

• .NET SDK compatible with the tool’s target framework (see the package details)
• Git
• Network access to Azure DevOps for clone and PR comment APIs

Installation

dotnet tool install --global wcom-pr-validation

Use --add-source or a NuGet.config if you install from a private feed.

Quick start (command line)

Replace the URI, pull request id, branch, and token with your own. Example organization and project names are illustrative only.

wcom-pr-validation \
  --pr "12345" \
  --repo "https://dev.azure.com/contoso/Fabrikam/_git/sample-app" \
  --pat "<personal-access-token>" \
  --branch "refs/heads/feature/your-branch"

In Azure Pipelines, the same values are typically supplied through predefined pipeline variables; refer to your pipeline template or product documentation for the exact names.

Configuration (.wcom-pr-validation.json)

Place /.wcom-pr-validation.json in the root of the repository being validated (the clone). Property names are case-insensitive; // comments are allowed. If the file is missing, safe defaults apply.

Full schema, defaults, and examples: see the Repository-Specific Configuration section in the source repository README.md (this package ships a short summary only).

Documentation

For the full option list, environment variables, workflow details, configuration reference, and troubleshooting, see the project documentation shipped with your distribution (for example the repository that builds this package).

License

This package is distributed under the MIT license. See the LICENSE file in the package for full text.