ValidationEngine 1.0.4

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet tool install --global ValidationEngine --version 1.0.4
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local ValidationEngine --version 1.0.4
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=ValidationEngine&version=1.0.4
                    


                    

                
nuke :add-package ValidationEngine --version 1.0.4

ValidationEngine

Core deterministic mechanical rule engine and orchestrator for the ValidationEngine standards validation suite, distributed as the validation-engine .NET global tool.

What It Is

The entry point and orchestrator for a validation run — a standalone .NET global tool that owns the deterministic rule engine and coordinates the optional ValidationEngine.Agent and ValidationEngine.Link add-on tools when they are installed.

What It Does

validation-engine validates a target repository against a standards corpus (see Standards Source):

  • Runs deterministic, mechanical rule checks against the repository.
  • Orchestrates optional sibling tools — validation-engine-agent for AI-assisted manual-only rule evaluation and validation-engine-link for markdown link validation — when they are installed and applicable to the current run.
  • Renders results as Markdown and JSON via ValidationEngine.Reporting, writes them to Working/ValidationDiscrepancies.md / .json, and retains a pruned run history under Working/ValidationHistory/.
  • Exits with a status code reflecting the outcome: 0 clean, 1 violations or manual-review items present, 2 engine errors.

Its Modularity

ValidationEngine depends on ValidationEngine.Models (shared contracts) and ValidationEngine.Reporting (default renderers, used only because this project's Program.cs is a composition root — any other consumer is free to supply its own renderer implementations). ValidationEngine.Agent and ValidationEngine.Link are launched as external sibling processes, not compiled dependencies, so each can be installed, updated, or omitted independently without requiring a new release of this package.

How It Works

  1. Resolves the repository root and the standards corpus location.
  2. Runs its deterministic mechanical rule set against the repository.
  3. Launches validation-engine-agent and/or validation-engine-link as sibling processes when they are installed and applicable rules require them.
  4. Merges all findings into a single report, renders it, writes it to disk, and prunes history.
  5. Returns an exit code reflecting the outcome, suitable for CI/PR gating.

Design Notes

See KnowledgeBase.md for recorded design decisions and rationale, including why repository-local addenda suppress findings rather than removing rules from the run.

Installing

dotnet tool install --global ValidationEngine

Usage

Run from the root of the repository you want to validate:

validation-engine
Argument Description
-RepositoryRoot <path> Repository to validate. Defaults to the current directory.
-GlobalStandardsRoot <path> Standards corpus location override; falls back to GLOBALSTANDARDS_ROOT env var, then "standardsPath" in validationengine.config.json, then Docs/Standards under the repository root.
-Mode <Manual\|Pr\|...> Run mode; controls which rule set(s) execute. Defaults to Manual.
-TargetBranch <branch> Base branch for PR-mode diff scoping.

License

MIT — see LICENSE.

License

MIT — see LICENSE.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.0.4 82 9/8/2026
1.0.3 73 9/8/2026
1.0.2 70 9/7/2026
1.0.0 80 9/6/2026