% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/feature-provenance-manifest.R
\name{validate_gazepoint_feature_manifest}
\alias{validate_gazepoint_feature_manifest}
\title{Validate a Gazepoint feature-provenance manifest}
\usage{
validate_gazepoint_feature_manifest(x)
}
\arguments{
\item{x}{A feature manifest created by
\code{\link[=create_gazepoint_feature_manifest]{create_gazepoint_feature_manifest()}} or a compatible data frame.}
}
\value{
An object of class
\code{gazepoint_feature_manifest_validation} containing the overall
status, complete checks, non-passing issues, and validated manifest.
}
\description{
Validates the schema and declared scientific safeguards in a feature
manifest. Schema errors stop execution. Substantive concerns are
returned as structured \code{pass}, \code{review}, or \code{fail} checks.
}
\details{
A manifest fails when an intended predictor is declared as
outcome-derived, post-outcome, unavailable at prediction time, or an
identifier. It also fails when fold-local estimation is required but
preprocessing is declared outside the resampling fold.

Unknown or incomplete provenance is returned for review rather than
treated as evidence that a safeguard was satisfied.
}
\examples{
manifest <- create_gazepoint_feature_manifest(
  features = "fixation_duration",
  scientific_source = "Gazepoint fixation export",
  source_table = "fixations",
  transformation = "Trial-level mean",
  availability_stage = "during_exposure",
  prediction_time_available = TRUE,
  preprocessing_scope = "none",
  fold_local_required = FALSE
)

validate_gazepoint_feature_manifest(manifest)

}
