Repository navigation
fs-safe 0.21.0
Highlights
- Guarded filesystem observation:
@openclaw/fs-safe/watchobserves literal entry and tree scopes beneath an admitted Root and delivers bounded advisory invalidations; guarded scans stay authoritative. One shared Rust event thread per process uses inotify, FSEvents and ReadDirectoryChangesW on Linux, macOS and Windows, sleeps while idle, and falls back to portable polling undermode: "auto". Subscriptions become ready after one baseline scan, stay available under sustained writes, fence stale generations onsetScopes(), join native work onclose(), and supportpersistent: falseso one-shot Node commands can exit. Thanks @vincentkoc. (#690, #695, #697, #703, #707) - Linux user namespaces: private temp workspaces now work beneath unmapped ancestors, including systemd user services with
PrivateUsers=true, while UID/GID mappings and ancestor permissions are still rechecked. (#693)
Features
- Revocable atomic writes: atomic replacement can recheck caller authority before new effects and report retained destination identities for partial writes and publication, without treating receipts as permission to roll back. (#694)
- Root walking:
symlinkPolicy: "include"reports links without following their targets, preserving sorted traversal, entry budgets, and the existing skip/follow result types. Directory-to-symlink substitutions fail before descent. (#692) - Windows file retirement: the advanced surface can retire existing NTFS files through a retained handle, with exact producer identity, current authority, and separate disposition and settlement facts. There is no persistence guarantee. (#706)
Performance
- Temporary filename sanitization: skip duplicate normalization after reserved-device suffixing while preserving filename admission and fallback rules. (#689)
Compatibility
- Supplied temp workspace roots must be owned by the effective user and must not be group- or world-writable; use a private per-user root instead of shared
/tmp. A one-time warning reports host ownership that cannot be verified. (#693) - On Windows, an events-mode watch holds one handle on each watched Root, so the Root's own ancestor directories cannot be renamed while it is open; renaming inside the Root is unaffected. Use
mode: "poll"where that matters. (#697) watch()requires an explicitmode("auto","events"or"poll");"events"fails readiness withhelper-unavailablewhen no native backend is available, and Bun currently selects polling under"auto". (#690)
Published packages
| Package | Registry tarball | Verified integrity | Provenance |
|---|---|---|---|
| @openclaw/fs-safe-linux-x64-gnu@0.21.0 | tgz | sha512-xTweWAdKXB/wxpx3tAx0Z0wxdoNuqa/ItvIJyVOjHRVbG+K9NE6jIRA1X4ll2CpOUhwmC7rLWEex+hoVdv34Mw== |
verified attestation |
| @openclaw/fs-safe-linux-x64-musl@0.21.0 | tgz | sha512-IiSwkd4uSPn7OseMUozIcWvcLTkS1MuTXpiymPAZ5tipHHiPkZcXHp4f5TGdF8IUrDv8d0v9HBcPftB/z3MLZA== |
verified attestation |
| @openclaw/fs-safe-linux-arm64-gnu@0.21.0 | tgz | sha512-naEAoRrCgG4P9spDvjyn1Ej0cTsALx4sS2dX5RXT+dxogCuYZ8bdrVdOpI3d0QDSU3jejtgWOy/XWpEQbF8FhQ== |
verified attestation |
| @openclaw/fs-safe-linux-arm64-musl@0.21.0 | tgz | sha512-EqouBFD0xzZxpvAx42jGMk36iEyJxkVD+MZ+7rHdb8u96lrcIh6xOSALX48PffvFIlsaudKHD84YJBl815MF8Q== |
verified attestation |
| @openclaw/fs-safe-darwin-x64@0.21.0 | tgz | sha512-zaOYSzK+8Vp8vZ3uzReFR0WUMhAqz7uwqLPcJ/nTopo+baV3sSacFYpl7fdl9+K75pYsetG9EuowB3MKXAWdOQ== |
verified attestation |
| @openclaw/fs-safe-darwin-arm64@0.21.0 | tgz | sha512-XwqQxjkNl7UbtdFgwkcTIz1w+oRvGSETRTbPAvHh3Sfi8Mrksnryn07IRzZMEbrEpHCfRR1DnjblC72JU3zxiw== |
verified attestation |
| @openclaw/fs-safe-win32-x64-msvc@0.21.0 | tgz | sha512-NXex00Hym/JpBKvqLu2LQoxbiD6CKj3dNkbmNGIEHn3hv+W/xPTz/uKJO2hA7La3GcUA24H//dBxlTUTHz4k+A== |
verified attestation |
| @openclaw/fs-safe@0.21.0 | tgz | sha512-gKhQjKUvL1ydanvJ1tGs5+qdIlwmtddFkekngPlBZecyyfrEKHSlM5LyiIipMnxxttgqJKIw5sKw/GqLvu/RDA== |
verified attestation |
Release proof: GitHub Actions run.