Record one acquired Survey Event under an existing Reach — record_study_survey

Creates a local event identity without changing hierarchy, areas, existing events, notes or evidence links. This is analyst-supplied inventory, not independent acquisition verification, asset linking or FGDB acceptance.

record_study_survey_event(
  dsn,
  output_file,
  reach_id,
  acquired_date,
  source_dataset,
  evidence_note,
  report_file = NULL,
  report_purpose = "definition"
)

Arguments

dsn: Existing context GeoPackage with the parent Reach.
output_file: New .gpkg beside dsn; never overwrite existing context.
reach_id: Exact existing Reach UUID; no parentage is inferred.
acquired_date: Known date as YYYY, YYYY-MM or YYYY-MM-DD. Unknown parts remain missing integers. Invalid dates and periods entirely in the future are refused; planned/undated work belongs in scope/reconstruction notes.
source_dataset: Nonempty source/delivery reference stored as text. Not opened, copied, verified or pinned as an asset link.
evidence_note: Nonempty basis for acquisition/date interpretation, stored in availability_notes, not duplicated in Study Area notes.
report_file: Optional new .html destination in an existing directory.
report_purpose: Report view: definition (default), terrain or staging.

Value

List of context and report paths. Exact repeats of Reach, date precision/value and trimmed source reference are refused. Alternate labels or precision still need analyst duplicate review; this is not reconciliation. Existing optional columns retain values; absent columns gain typed missing values. Rendering failure may leave the context; keep it and retry read-only reporting. No acquisition or terrain availability is inferred.