CapabilityGraphValidator

Validates the capability graph across a set of plugin manifests: every hard `requires` must be satisfied by some plugin's `provides`, and the plugin dependency graph must be acyclic. Unprovided `suggests` are reported as a degradation path, never a failure. Reads both capability formats: the typed `capabilities.*` records and the legacy bare-FQCN `contracts.*` arrays; matching is by interface FQCN. Ported 1:1 from `scripts/library/validate-capability-graph.php` (B5 / T014) — this class takes the already-resolved list of manifest file paths (the caller globs; kept filesystem-glob-decoupled so it is trivially testable against a synthetic fixture set).

public function validate(array $manifestFiles): Milpa\DevTools\Validators\CapabilityGraphResult

Validates the capability graph across every manifest in `$manifestFiles`.

Parameters