Crate harness_write 

Write/Edit/MultiEdit tool — Rust port of @agent-sh/harness-write.

Contract matches agent-knowledge/design/write.md and the TS package: atomic write via temp file + rename, read-before-edit ledger enforcement (NOT_READ_THIS_SESSION / STALE_READ), fuzzy candidates on OLD_STRING_NOT_FOUND, match locations on OLD_STRING_NOT_UNIQUE, CRLF→LF normalization, sequential MultiEdit pipeline with rollback on failure.

Structs

ApplyResult

EditMeta

EditParams

EditSpec

ErrorResult

FuzzyCandidate

InMemoryLedger

LedgerEntry

MatchLocation

MultiEditMeta

MultiEditParams

PreviewMeta

PreviewResult

TextWriteResult

WriteMeta

WriteParams

WriteSessionConfig

Enums

EditResult

MultiEditResult

PipelineResult

WriteParseError

WriteResult

Constants

BINARY_SAMPLE_BYTES

CONTEXT_LINES

DEFAULT_FUZZY_LENGTH_TOLERANCE

DEFAULT_FUZZY_THRESHOLD

DEFAULT_FUZZY_TOP_K

EDIT_TOOL_DESCRIPTION

EDIT_TOOL_NAME

MAX_EDIT_FILE_SIZE

MULTIEDIT_TOOL_DESCRIPTION

MULTIEDIT_TOOL_NAME

Canonical MultiEdit tool name. Matches fn multi_edit and the snake_case convention used by every other multi-word tool name in the workspace (bash_output, bash_kill).

MULTIEDIT_TOOL_NAME_LEGACYDeprecated

Legacy MultiEdit tool name (pre-0.3.0 spelling). Still accepted as an alias anywhere tool names are matched/dispatched, but deprecated.

WRITE_TOOL_DESCRIPTION

WRITE_TOOL_NAME

Traits

Ledger

Mirror of the TS Ledger surface: keyed by path, most-recent wins.

Functions

apply_edit

Apply a single edit spec to content. Returns either the new content + counts, or a structured ToolError.

apply_pipeline

build_match_locations

edit

find_all_occurrences

Find all exact occurrences of needle in haystack. Returns byte offsets.

find_fuzzy_candidates

is_multi_edit_tool_name

Returns true if name names the MultiEdit tool — either the canonical "multi_edit" or the deprecated legacy "multiedit" spelling.

levenshtein

Levenshtein distance O(n*m) time, O(min(n,m)) space.

multi_edit

normalize_line_endings

Normalize CRLF → LF. Matches the TS normalizer exactly.

normalize_multi_edit_tool_name

Resolves name to the canonical MultiEdit tool name ("multi_edit"), or None when name is not a MultiEdit spelling.

safe_parse_edit_params

safe_parse_multi_edit_params

safe_parse_write_params

similarity

substring_boundary_collisions

Boundary-collision check: flag lines where needle sits adjacent to identifier characters — caller may be stomping on a longer identifier.

unified_diff

Produce a unified-diff string. Uses the similar crate’s grouped hunks. Output shape: --- old\n+++ new\n@@ ... @@\n ...\n- ...\n+ ....

warn_legacy_multi_edit_tool_name

Emits a one-time (per process) deprecation warning on stderr telling the caller to migrate from "multiedit" to "multi_edit". Subsequent calls are no-ops, so dispatch loops do not spam logs.

write