Skip to content

fs-safe 0.21.0

Choose a tag to compare

@github-actions github-actions released this 27 Sep 00:45
· 346 commits to main since this release
v0.21.0
97ff587

Highlights

  • Guarded filesystem observation: @openclaw/fs-safe/watch observes 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 under mode: "auto". Subscriptions become ready after one baseline scan, stay available under sustained writes, fence stale generations on setScopes(), join native work on close(), and support persistent: false so 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 explicit mode ("auto", "events" or "poll"); "events" fails readiness with helper-unavailable when 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.