Accept an explicitly reviewed retained Stream Network

Operates on a named list of local relations, not on a database connection. Supply inspection decisions before calling: this function never fills them in. Current ACCEPTANCE validation must pass. Failed validation raises a `fluvgeo_acceptance_error` carrying `validation` and `geodatabase` (the unchanged scientific state with the new run appended). Nothing is written to disk.

accept_stream_network(
  geodatabase,
  reviewer,
  review_notes = NA_character_,
  reaches = NULL,
  accepted_at = Sys.time()
)

Arguments

geodatabase

Named list containing Configuration, membership, Observation, prepared segments, and their related evidence tables.

reviewer

Explicit observation reviewer's identifier.

review_notes

Optional replacement qualification notes. NA preserves existing notes; missing scientific qualifications are never invented.

reaches

Optional governed Reach-Stream mappings for validation.

accepted_at

Acceptance time, converted to UTC; cannot predate inspections.

Value

A new relations list, with an appended passing acceptance run and accepted observation/segment status. Input objects remain unchanged.

Details

Successful acceptance records observation reviewer/time/notes and sets all segment review states to ACCEPTED. Segment modified times describe the inspected scientific state and are deliberately unchanged by this status-only transition. Observation modification provenance records the transition. Existing validation history and inspection decisions are preserved. Already accepted observations must be explicitly reopened before a new acceptance.