patchloom 0.26.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

# Patchloom 0.26.0

Safer path containment, FIFO handling, and multi-file soft skips for agents
and library hosts. Pure renames and deletes guard the path you named, not only
the symlink target. Special files (FIFOs and similar) no longer hang text probes
or get mislabeled as unreadable. Public soft-skip reporting gains
`not_regular_file`. Minor release for a public SoftTextSkip break under 0.x
(`bump-minor-pre-major`).

## Highlights

PathGuard can check the **entry** (the path you pass) for delete and path-only
rename, including pure git rename patches under `--contain`. Soft text and
binary probes refuse non-regular files before open, so FIFOs do not block the
CLI. Multi-path replace, search, and tidy put special co-paths in `refused[]`
with `reason: not_regular_file` so agents do not retry chmod. Multi-file patch
apply always backs up creates and rename destinations so a mid-batch failure
can restore. Windows install docs prefer Scoop and GitHub assets over winget
and Chocolatey while those channels catch up.

## Breaking changes

- **`SoftTextSkip` is `#[non_exhaustive]` and gains `NotRegularFile`.**
  Hosts that match on `SoftTextSkip` exhaustively must add a `_` arm.
  Existing specials (FIFO, socket, device, and other non-regular entries)
  use `NotRegularFile` (`as_reason` → `not_regular_file`) instead of
  `Unreadable`. Missing paths stay `Unreadable`. ([#2122](https://github.com/patchloom/patchloom/pull/2122))

## Bug fixes

- **FIFOs hung rename, backup, and binary probes.**
  Rename, backup, and related paths no longer open special nodes for
  content probes. Path-only rename of a FIFO still works when the product
  allows it; text ops refuse FIFO with a clear error. ([#2113](https://github.com/patchloom/patchloom/pull/2113))

- **`is_binary_file` and soft text read still opened specials.**
  Public probes refuse non-regular paths from metadata before open (same
  hang class as rename). ([#2118](https://github.com/patchloom/patchloom/pull/2118))

- **PathGuard followed symlink targets for delete and path-only rename.**
  Entry mode checks the path you named so a workspace symlink to an
  outside target is not treated as an allowed outside path. CLI, MCP, and
  library delete/rename dual paths share the policy. Pure patch renames
  use entry guard at execute; content hunks still follow. ([#2116](https://github.com/patchloom/patchloom/pull/2116), [#2117](https://github.com/patchloom/patchloom/pull/2117), [#2121](https://github.com/patchloom/patchloom/pull/2121))

- **Multi-file patch apply could leave orphan creates after a mid-batch failure.**
  Creates and rename destinations always get a backup marker so restore can
  undo a partial apply. Soft-read diagnostics no longer re-open a FIFO on
  error. ([#2120](https://github.com/patchloom/patchloom/pull/2120))

- **Multi-path FIFO soft skip said `unreadable` while stderr said not a regular file.**
  Soft skip reason is `not_regular_file`. Search and tidy multi-path lists
  now refuse the same specials as replace (not silent skip of non-`is_file`
  entries). ([#2122](https://github.com/patchloom/patchloom/pull/2122), [#2123](https://github.com/patchloom/patchloom/pull/2123))

- **Git octal C-quotes, dangling paths, and sole special peels.**
  Pure renames decode git octal escapes; dangling append/prepend/create
  peels are consistent; sole-path text ops still follow real symlink
  targets. ([#2110](https://github.com/patchloom/patchloom/pull/2110))

## Docs

- Install docs prefer Scoop and GitHub portable assets over winget and
  Chocolatey while community packages lag. ([#2119](https://github.com/patchloom/patchloom/pull/2119))

## Numbers

| Metric | Notes |
|--------|--------|
| Version | 0.25.0 → 0.26.0 (0.x minor for public SoftTextSkip change) |
| Focus | PathGuard entry, FIFO safety, multi-path soft refuse honesty |

## Upgrading

- **Library hosts matching `SoftTextSkip`:** handle `NotRegularFile` or use
  a wildcard arm (`#[non_exhaustive]`).
- **Agents:** multi-path specials report `refused[].reason: not_regular_file`.
  Do not treat that as a permission problem.
- **Containment:** delete and path-only rename (including pure patch renames)
  use entry PathGuard when that mode is enabled.
- Install from crates.io, npm, Homebrew, or Scoop after the tag ships. Winget
  and Chocolatey may lag.

## Full changelog

https://github.com/patchloom/patchloom/compare/patchloom-v0.25.0...patchloom-v0.26.0