onboard a new wave into a merge recipe — onboard_new

semi-automated workflow that detects variable diffs against the previous wave, generates a candidate wave_index entry, checks expected-presence constraints, flags potential boundary breaks, and prints an onboarding checklist.

Usage

onboard_new_wave(recipe_path, new_file, prev_wave_id = NULL)

Arguments

recipe_path: character. path to the current canonical YAML recipe.
new_file: character. path to the new wave data file (.sav, .dta, or .csv).
prev_wave_id: character. wave id to diff against (e.g. "ch24q"). if NULL, the diff step is skipped.

Value

an onboarding report list (invisibly).

Examples

if (FALSE) { # \dontrun{
onboard_new_wave(
  "ch_merge_recipe.yml",
  "ch25r_EN_1.0p.sav",
  prev_wave_id = "ch24q"
)
} # }