Skip to content

Commit 2f627ac

Browse files
committed
docs: refine safety design copy
1 parent be1c36c commit 2f627ac

File tree

1 file changed

+4
-12
lines changed

1 file changed

+4
-12
lines changed

README.md

Lines changed: 4 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -76,21 +76,13 @@ mo analyze /Volumes # Analyze external drives only
7676

7777
## Security & Safety Design
7878

79-
Mole is a local system maintenance tool. Commands such as `clean`, `uninstall`, `purge`, `installer`, `remove`, and parts of `optimize` can perform destructive local operations.
79+
Mole is a local system maintenance tool, and some commands can perform destructive local operations.
8080

81-
Mole is designed with safety-first defaults for local system maintenance.
81+
Mole uses safety-first defaults: path validation, protected-directory rules, conservative cleanup boundaries, and explicit confirmation for higher-risk actions. When risk or uncertainty is high, Mole skips, refuses, or requires stronger confirmation rather than broadening deletion scope.
8282

83-
- Destructive operations are guarded by path validation, protected directory rules, conservative cleanup boundaries, and explicit confirmation where appropriate.
84-
- Mole prioritizes bounded cleanup over aggressive cleanup.
85-
- High-risk paths, sensitive data categories, system locations, and sudo flows have explicit protection boundaries.
86-
- When uncertainty exists, the tool should refuse, skip, or require stronger confirmation instead of widening deletion scope.
87-
- `mo analyze` is intentionally safer than cleanup flows for ad hoc deletion because it moves files to Trash through Finder instead of directly deleting them.
88-
- Release assets are published with SHA-256 checksums, curated safety notes, and GitHub artifact attestations.
83+
`mo analyze` is safer for ad hoc cleanup because it moves files to Trash through Finder instead of deleting them directly.
8984

90-
Review these documents before using high-risk commands:
91-
92-
- [SECURITY.md](SECURITY.md)
93-
- [SECURITY_AUDIT.md](SECURITY_AUDIT.md)
85+
Review [SECURITY.md](SECURITY.md) and [SECURITY_AUDIT.md](SECURITY_AUDIT.md) for reporting guidance, safety boundaries, and current limitations.
9486

9587
## Tips
9688

0 commit comments

Comments
 (0)