harness-write 0.3.0

Write/Edit/MultiEdit tool for AI agent harnesses — atomic write, read-before-edit ledger, OLD_STRING_NOT_UNIQUE with match locations, OLD_STRING_NOT_FOUND with fuzzy candidates, sequential multi-edit pipeline
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# harness-write

Atomic file write + edit + multi-edit with read-before-edit ledger, OLD_STRING_NOT_UNIQUE match locations, fuzzy candidate suggestions.

Rust port of [`@agent-sh/harness-write`](https://www.npmjs.com/package/@agent-sh/harness-write). Part of the [`harness-*`](https://github.com/avifenesh/tools) monorepo — see the top-level README for architectural context.

## Install

```toml
[dependencies]
harness-write = "0.1"
```

## Usage

```rust
use harness_write::{edit, WriteSessionConfig, InMemoryLedger};
use harness_core::PermissionPolicy;
use std::sync::Arc;
use serde_json::json;

let perms = PermissionPolicy::new(vec!["/workspace".into()]);
let ledger = Arc::new(InMemoryLedger::new());
let session = WriteSessionConfig::new("/workspace", perms, ledger);
// ... after Read, the read-executor should record into ledger ...
let r = edit(json!({ "path": "...", "old_string": "foo", "new_string": "bar" }), &session).await;
```

## Tool naming

The MultiEdit tool's canonical name is `multi_edit` (`MULTIEDIT_TOOL_NAME`),
matching `fn multi_edit` and the snake_case convention of the other multi-word
tool names. The pre-0.3.0 spelling `multiedit` remains available as the
deprecated `MULTIEDIT_TOOL_NAME_LEGACY`. `is_multi_edit_tool_name()` is a
pure matcher that accepts both spellings; `normalize_multi_edit_tool_name()`
maps both to the canonical name and emits a one-time stderr deprecation
warning for the legacy spelling — use it at dispatch points.
`harness-write-cli` likewise accepts both `multi_edit` and the deprecated
`multiedit` JSON-RPC methods. The `multiedit` alias will be removed in a
future major release — migrate to `multi_edit`.

## Contract

The full contract lives in [`agent-knowledge/design/write.md`](https://github.com/avifenesh/tools/blob/main/agent-knowledge/design/write.md). Changes to this crate must stay in sync with that spec, and with the TypeScript sibling at [`@agent-sh/harness-write`](https://www.npmjs.com/package/@agent-sh/harness-write).

## License

MIT © Avi Fenesh