feat: expose skip reason as error

[karlkfi]

This change makes filters return an error, since all errors from apply/prune/wait are sent as events and don't terminate the task queue anyway. This exposes the reason why the object was skipped, instead of just skipping it silently.

• Rewrite actuation filters to return an error with the reason for skipping.
• Add explicit error types for most skip errors, to make it easier to catch and handle them.
• Add Is method to explicit error types to allow use of errors.Is for recursive unwrapped matching.
• Rename InventoryPolicyFilter to InventoryPolicyPruneFilter for consistency with InventoryPolicyApplyFilter
• Update deletion prevention inventory-id removal to use errors.Is instead of matching the filter name.
• Convert error structs to use pointers to allow nil errors and avoid copying contents.

BREAKING CHANGE: Skipped actuation events now include an error. BREAKING CHANGE: DeleteEvent.Reason replaced with an error. BREAKING CHANGE: Unused InventoryNamespaceInSet error removed. BREAKING CHANGE: InventoryOverlapError replaced with PolicyPreventedActuationError. BREAKING CHANGE: NeedAdoptionError replaced with PolicyPreventedActuationError. BREAKING CHANGE: NoInventoryObjError & MultipleInventoryObjError now use pointers.

New Error Types:

• filter.ApplyPreventedDeletionError (CurrentUIDFilter)
• filter.DependencyPreventedActuationError (DependencyFilter)
• filter.DependencyActuationMismatchError (DependencyFilter)
• inventory.PolicyPreventedActuationError (replaces NeedAdoptionError & InventoryOverlapError from InventoryPolicyApplyFilter & InventoryPolicyPruneFilter)
• filter.NamespaceInUseError (LocalNamespacesFilter)
• filter.AnnotationPreventedDeletionError (PreventRemoveFilter)
• filter.FatalError (internal use only - for filters to trigger Failed instead of Skipped)

Removed error types:

• inventory.InventoryOverlapError (replaced by PolicyPreventedActuationError)
• inventory.NeedAdoptionError (replaced by PolicyPreventedActuationError)
• inventory.InventoryNamespaceInSet (unused - namespace is being created automatically)

Other existing error types (not used for skips):

• inventory.NoInventoryObjError (used by kpt, but not cli-utils)
• inventory.MultipleInventoryObjError (ValidateNoInventory)
• manifestreader.UnknownTypesError
• error.UnknownTypeError
• error.ApplyRunError
• error.InitializeApplyOptionError
• multierror.MultiError
• object.InvalidAnnotationError
• graph.ExternalDependencyError
• graph.CyclicDependencyError
• validation.Error
• common.ResultError

[Liujingfang1]

/lgtm /approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: karlkfi, Liujingfang1

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files: - ~~[OWNERS](https://github.com/kubernetes-sigs/cli-utils/blob/master/OWNERS)~~ [Liujingfang1] Approvers can indicate their approval by writing `/approve` in a comment Approvers can cancel approval by writing `/approve cancel` in a comment