Enum EditErrorKind 

#[non_exhaustive]
pub enum EditErrorKind {
    AmbiguousTarget,
    NoMatch,
    SyntaxInvalid,
    ConflictingEdit,
    ParseError,
    GuardRejected,
    InvalidInput,
    TypeError,
    OperationFailed,
    FormatFailed,
    AlreadyExists,
    NotFound,
    Conflicts,
    ChangesDetected,
    Binary,
    InvalidEncoding,
    FuzzySpanSuspicious,
}

Classification of edit errors.

Marked non_exhaustive so new honesty kinds (for example Self::TypeError) can land in minor releases without breaking external exhaustive matches.

Append-only variants: new kinds must be added after the last existing variant. Inserting in the middle shifts discriminants of later variants and fails cargo-semver-checks (enum_no_repr_variant_discriminant_changed), which blocks patch releases (see #1950 order fix for #1951).

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.

AmbiguousTarget

The edit target matched multiple locations in the file.

NoMatch

The edit target was not found in the file.

SyntaxInvalid

The edit would produce invalid syntax.

ConflictingEdit

Another edit already modified this region (for batch operations).

ParseError

The file could not be parsed.

GuardRejected

Path rejected by workspace PathGuard (#1492).

InvalidInput

Invalid arguments or options for the edit.

TypeError

Wrong value type for a doc selector (multi-document YAML bare key, navigate into array as object, etc.). CLI JSON uses error_kind: "type_error". Distinct from Self::InvalidInput so hosts can recover with 0.key / [0].key without scraping English (#1883).

OperationFailed

I/O or other operational failure.

FormatFailed

Post-write format/lint hook failed (format_failed / #1663). Distinct from generic Self::OperationFailed so hosts can branch without scraping English.

AlreadyExists

Create/rename destination already exists without force. CLI JSON uses error_kind: "already_exists". Distinct from Self::InvalidInput (empty path, directory target) and content SoftSkip (Self::Binary / Self::InvalidEncoding) so hosts can hint overwrite/force without scraping English (#1947 / #1963). Appended after Self::FormatFailed so 0.18.0 discriminants stay stable.

NotFound

Path not found (std::io::ErrorKind::NotFound). CLI JSON uses error_kind: "not_found". Distinct from generic Self::OperationFailed so hosts can treat missing paths separately from other I/O failures.

Conflicts

Patch/apply produced merge conflict markers. CLI JSON uses error_kind: "conflicts". Distinct from Self::ConflictingEdit (batch region overlap) and generic Self::OperationFailed.

ChangesDetected

Check/preview reported pending changes, or soft assert-count mismatch (error_kind: "changes_detected", exit 2). Distinct from Self::OperationFailed so hosts can mirror CLI exit-2 semantics without scraping English.

Binary

Target contains NUL in the binary probe window (not agent-editable text). CLI JSON uses error_kind: "binary". Distinct from Self::InvalidInput (empty path, directory target, empty pattern) so hosts can recover overwrite/delete/rename without treating all invalid input as binary (#1963). Appended after Self::ChangesDetected so 0.18/0.19 discriminants stay stable.

InvalidEncoding

Target is not valid UTF-8 (and not binary by NUL probe). CLI JSON uses error_kind: "invalid_encoding". Distinct from Self::Binary and Self::InvalidInput (#1963).

FuzzySpanSuspicious

Fuzzy match span is over-wide vs old under crate::api::FuzzySpanPolicy (or the host refused via ReplaceOptions::refuse_suspicious_fuzzy). CLI/library JSON uses error_kind: "fuzzy_span_suspicious" (#2005). Appended after Self::InvalidEncoding so 0.20/0.21 discriminants stay stable.

Trait Implementations

impl Clone for EditErrorKind

fn clone(&self) -> EditErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EditErrorKind

impl Debug for EditErrorKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EditErrorKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for EditErrorKind

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

Formats the value using the given formatter.

impl Eq for EditErrorKind

impl PartialEq for EditErrorKind

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for EditErrorKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EditErrorKind