Enum UserFields 

#[non_exhaustive]
pub enum UserFields {
    Preserve,
    Authored,
}

Who is authoritative for the user-authored [doiget] fields (tags, collections, annotation) on a write.

A fetch never authors them: every DoigetExtension the orchestrator builds hard-codes Vec::new() / None. Letting that win silently discarded a user’s tags on any re-fetch, which is the loss ADR-0056 closed for oa_status / license and left open here.

The distinction has to be explicit rather than “is the incoming value empty”, because doiget tag --remove and doiget annotate --clear legitimately mean the empty value.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Preserve

The caller did not author them; keep whatever is on disk. Fetches.

Authored

The caller means exactly what it wrote, empty included. doiget tag, doiget annotate, and their MCP equivalents.

Trait Implementations

impl Clone for UserFields

fn clone(&self) -> UserFields

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for UserFields

impl Debug for UserFields

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for UserFields

impl PartialEq for UserFields

fn eq(&self, other: &UserFields) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for UserFields