the app's metadata.templateRef (name + pinned version).
the manifest of the version being upgraded TO.
TemplateManifestInvalidError the target manifest is not .strict()-valid.
TemplateUpgradeNotEligibleError template mismatch, minUpgradeFrom
violation, or an unevaluable version pair.
Gate a template upgrade: the target manifest must belong to the same template the app was deployed from, and the app's current version must satisfy the target's
spec.minUpgradeFrom. Returns the operator-facing upgrade metadata on success. Pure.