Skip to content

armgit / peel

Public Imported from GitHub
0

Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.

Say what a rename by name still takes, and what the helper does about it

Țugui Dragoș328162ded1dc
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 600d470d..91505ad5 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -552,7 +552,7 @@ its place (`SettingsView`), whose zap takes Peel's whole folder, `Terminal/` inc
- Scanners take their slow parts as parameters (how to measure a folder, how to run a tool), so a test can
stand in for a folder that never answers or a tool that fails.
- The `Attack*Tests` files try to get past the safety rules on purpose: another case, a link, a `/.vol` path, a
- folder swapped between the check and the move.
+ folder swapped between the check and the move, an object swapped into an item's name while the helper moves it.
- A few tests read this Mac instead of a fixture, and the slowest ones run only when asked for
(`PEEL_TEST_THIS_MAC=1`).
- `PeelUITests` runs Xcode's accessibility audit on every page, About, Settings, and the menu bar panel, in both
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9274e531..278afd36 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -983,8 +983,8 @@ its changes the way [Keep a Changelog](https://keepachangelog.com/) suggests.
of that account can redefine.
- The helper takes each item it moves to the Trash or puts back through a folder of its own that only it can reach,
and checks there that it is the item it was asked to move, so nothing put in the item's place on the way moves
- instead, nor goes back where code is loaded from. It no longer moves anything from outside the startup disk, such as
- from a home folder kept on another disk.
+ instead, nor goes back where code is loaded from, and a Put Back of something else says the helper has no record of
+ it. It no longer moves anything from outside the startup disk, such as from a home folder kept on another disk.
## 1.2.1 (2026-10-25)
diff --git a/SAFETY.md b/SAFETY.md
index 86c188fe..090cb31a 100644
--- a/SAFETY.md
+++ b/SAFETY.md
@@ -130,10 +130,13 @@ and as the system names it, spelled as the disk stores it.
**The thing judged is the thing moved.** A check made by name and a move made by name are two looks at
the disk, and between them a folder can be swapped for a link into Messages by anything running as you. So
Peel holds the folder open, asks the question again about the name the system gives that open folder, and
-moves the item through it: whatever the old name leads to by then is not touched. Putting an item back
-holds the folder it returns to in the same way. The cost is that Finder's own Put Back does not know these
-items, since only Apple's by-name call writes the note Finder reads; Peel's History puts them back, and in
-Finder they can be dragged out. One move still goes by name, the first ever made on a disk, because that
+moves the item through it: whatever the old name leads to by then is not touched. A rename still takes whatever
+holds the name at that instant; for Peel's own moves that is something your account could have moved anyway, and
+its helper, which moves what only root can, checks each item once more in a folder only root can reach, as the
+section on the helper says. Putting an item back holds the folder it returns to in the same way. The cost is that
+Finder's own Put Back does not know these items, since only Apple's by-name call writes the note Finder reads;
+Peel's History puts them back, and in Finder they can be dragged out. One move still goes by name, the first ever
+made on a disk, because that
call is the only thing that makes a disk's Trash. What it moved is then compared with what was judged, and
a difference is reported instead of recorded.