patchloom 0.24.0

Structured file editing library and CLI for AI agents: parser-backed JSON/YAML/TOML edits, AST-aware code operations, multi-file batching, markdown operations, and MCP server
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

# Patchloom 0.24.0

MCP coding agents get directory inventory without a second filesystem server,
a tighter core tool pack, and clearer path rules. Library hosts get public
batch fuzzy refuse, safer multi-file apply, and more reliable path peels.
Fourteen commits since 0.23.0.

## Highlights

`list_files` is part of the core MCP pack (11 tools) so agents can inventory a
workspace with the same ignore and glob rules as search. Walks honor
`max_depth` at walk time. Embedders that apply multi-op buffer edits can call
`refuse_batch_if_suspicious_fuzzy` instead of reimplementing over-wide span
policy. Host and agent JSON paths report more accurate peels for missing
paths, binary loads, multi-file fuzzy refuse, and apply failures with undo.

## New features

- **MCP `list_files` (full and core pack).**
  Bounded directory inventory with ignore / exclude / glob rules, optional
  multi-root `paths`, `max_results` (default 500) with `truncated` and
  `total_matched`, and optional `max_depth` relative to each walk root.
  Missing roots hard-fail; `../` escapes are rejected. Prefer this over a
  second filesystem MCP for list + search + edit. (#2077, #2079, #2080, #2081)

  Set `PATCHLOOM_MCP_SURFACE=core` for the 11-tool pack:
  `read_file`, `search_files`, `list_files`, `replace_text`, `batch_replace`,
  `doc_get`, `doc_set`, `doc_query`, `md_replace_section`, `execute_plan`,
  `server_info`.

- **Walk-time `max_depth` prune.**
  Deep trees stop descending past `max_depth` instead of filtering only after
  a full walk. Search and other unlimited walks are unchanged. (#2080, #2078)

- **`api::refuse_batch_if_suspicious_fuzzy`.**
  Public helper for hosts that run buffer multi-op then write themselves.
  Same over-wide fuzzy refuse policy and `EditErrorKind::FuzzySpanSuspicious`
  shape as the disk path and `for_agent`. (#2065, #2067)

- **Agent packaging for dual-host MCP.**
  Canonical CLI / plan / MCP name map in handshake and `agent-rules`,
  explore guidance that prefers MCP tools over shell file walks for edits,
  and YAML `style_changed` when block-sequence indent or presentation shifts
  on write (values stay correct). Core tool names share one source of truth
  with `agent-rules --surface core`. (#2073, #2074)

## Bug fixes

- **Library relative multi-component paths.**
  Relative paths such as `src/lib.rs` no longer double-join under the project
  root (`src/src/lib.rs`). Absolute path handling for doc, md, tidy, patch,
  and AST write siblings matches. (#2068, #2069)

- **Finalize before write and atomic multi-file apply.**
  Library `write_if_apply` / `apply_mutation` create the backup session before
  mutating so a failed write can restore. Multi-file patch apply preflights
  then commits one session (no half-applied trees). Cross-file markdown move
  follows the same atomic path. (#2071)

- **Host and agent peels.**
  AST rename/replace missing path peels as not-found; batch AST remapper keeps
  binary and invalid-encoding kinds; multi-file fuzzy total miss lands in
  `refused[]`; MCP `ast_rename` miss is `isError` + `no_matches`; doc keys/len
  multi-doc edges no longer soft-miss incorrectly. (#2068, #2069)

- **Search same-line match order.**
  Matches on one line sort by column so agents can map index to
  `replace --nth`. (#2069)

- **Plan `for_each` nested `has_symbol`.**
  Nested methods match correctly under symbol checks. (#2069)

- **Exclude globs vs explicit file args.**
  `.patchloom.toml` exclude still filters walks, but an explicit file path
  on the command line is not dropped as `no_matches`. (#2072)

- **Case-insensitive whole-line insert.**
  `replace -i` with insert-after on a whole-line case fold no longer glues
  the replacement to the anchor (`Debug` + insert no longer yields
  `Debugnote`). (#2072)

- **MCP absolute paths under the workspace.**
  Docs and agent packaging match runtime: absolute paths that resolve inside
  the MCP root are allowed (`AllowIfContained`); outside and `../` still
  reject. Agents can join `server_info.cwd` with a relative path. (#2075)

## Numbers

| Metric | 0.23.0 | 0.24.0 |
|--------|--------|--------|
| Test attributes (`src/` + `tests/`) | 4,069 | 4,129 |
| Unit-ish (`src/`) | 2,739 | 2,783 |
| Commands | 24 | 24 |
| MCP core pack tools | 10 | 11 (`list_files`) |

## Upgrading

- From crates: `patchloom = "0.24"`
- From npm: `npx patchloom@0.24` or pin `patchloom@0.24.0`
- CLI binary: GitHub Release installers, Homebrew tap, Scoop, Chocolatey,
  or (when the community PR is approved) `winget install Patchloom.Patchloom`
- **MCP hosts / agents:** add `list_files` to inventories; prefer
  `PATCHLOOM_MCP_SURFACE=core` for coding agents unless you need AST tools.
  Absolute paths under the server root are valid; do not reject them solely
  for looking absolute.
- **Library hosts:** call `refuse_batch_if_suspicious_fuzzy` on buffer multi-op
  before write if you previously inlined the span check. Keep a wildcard
  match arm on `EditErrorKind` and related `#[non_exhaustive]` types.
  Relative multi-component paths and multi-file apply/session behavior
  match CLI/tx more closely; re-test host glue that assumed old join or
  half-apply edge cases.
- **YAML writers:** watch `style_changed` when block-sequence presentation
  shifts; content values remain correct.

## Full changelog

https://github.com/patchloom/patchloom/compare/patchloom-v0.23.0...patchloom-v0.24.0