Repository navigation
fs-safe 0.26.3
Highlights
- Native health and signed Windows binaries: inspect runtime native support with
getFsSafeNativeStatus(); Windows addons and the security helper now carry timestamped OpenClaw Foundation signatures. (#965, #960) - Linux copy compatibility: recover from refused reflink I/O, including ZFS block cloning, through a guarded byte copy. (#972)
- Less native filesystem overhead: retain directory parents, reuse writable-file admission, batch Root verification, and avoid unrelated macOS watch wakeups. (#971, #959, #966, #955, #968)
Features
- Native runtime health: add async
getFsSafeNativeStatus()with optional probing, path-free load reasons, and actionable guidance, exported from the root andconfigentry points. (#965) - Signed Windows binaries: Authenticode-sign both Windows native addons and the security helper with timestamped OpenClaw Foundation signatures, and verify the signed bytes before publication. (#960)
Fixes
- High-bit filesystem identities: preserve Node's signed bigint stat identities across native directory checks, allowing guarded writes and build locks on filesystems with high-bit inode numbers. (#979)
- Linux reflink fallback: fall back to a guarded byte copy when FICLONE refuses I/O with
EIOorEAGAIN, including ZFS block cloning; real copy and cleanup errors remain fatal. Reported in openclaw/openclaw#169071. (#972) - Native fallback warnings: explain why native support is unavailable, name the expected package version, and give cause-specific recovery guidance for Windows security and private-creation fallbacks. (#961)
Performance
- Native directory creation: retain parent handles during recursive mkdir, reducing the measured case from 160 to 5 promises and 381 to 74 Linux syscalls; nested mkdir also reuses existing parents. (#971, #959)
- Native writable-file creation: reuse parent admission, reducing measured direct-root append syscalls from 117 to 36 and
openWritablesyscalls from 115 to 34 while retaining identity and cleanup checks. (#966) - Native Root verification: batch verification and checked close to reduce dispatch overhead while retaining identity checks and close-error handling. (#955)
- macOS file watching: avoid JavaScript reconciliation for unrelated sibling writes and child-only changes to directory entry scopes while preserving missing-entry discovery and replacement notifications. (#968)
Docs and Tooling
- Durable queue design: document a link-free ownership protocol and mixed-version boundaries. (#969)
- Benchmark comparisons: balance independent build comparisons and restore benchmark setup in relocated checkouts. (#976, #970)
Published packages
| Package | Registry tarball | Verified integrity | Provenance |
|---|---|---|---|
| @openclaw/fs-safe-win32-arm64-msvc@0.26.3 | tgz | sha512-XMXZgVadAzGBguFlcNK6IwaegWohsSTjJTUEvVH4A52T7UFHZtRoImuOAf0xLjhBOBKgehT87+ADfEERUDN6Rg== |
verified attestation |
| @openclaw/fs-safe-linux-x64-gnu@0.26.3 | tgz | sha512-U2AbB6W4uLYyeBJWjuE5G3VqvdJDqQ/ZyUuk840ZPjXrfLOmGC0kaYJOq5BcCjwIfAv5spHtVQ6BgqYLdJIXVA== |
verified attestation |
| @openclaw/fs-safe-linux-x64-musl@0.26.3 | tgz | sha512-/u9oGTLpPuHjhGGu8YWXQZnvFshgg1zNTw5auP7WGNqMQJXj0TnfvIBMQHnuWZ6vVZQTmECHzcQzOoZNIduvfQ== |
verified attestation |
| @openclaw/fs-safe-linux-arm64-gnu@0.26.3 | tgz | sha512-fBHtjqFYQzjn40opd2pjGCKZORsj4e+WQa4NsPr70ZU17pq7GGgPe6gmz0XUWAQiIdoAjCPm4h4nimfKtC7CLQ== |
verified attestation |
| @openclaw/fs-safe-linux-arm64-musl@0.26.3 | tgz | sha512-IvPm7ppCmq4RYzJUwlWRA+suq7ZzQLnXsNO0Qw7BV8r+RmztHd1WIbD1FJDJAVEf8C2oDRo/4FcTIT7MdfZqPw== |
verified attestation |
| @openclaw/fs-safe-darwin-x64@0.26.3 | tgz | sha512-3AlJBxQ2fyP/dSVHBDeSd9oAc2/qm0zzsnLACaEYFL4UALInz4eR21+PXEnjATJjdmGsZeeJ1lFTNm8s/bZAIg== |
verified attestation |
| @openclaw/fs-safe-darwin-arm64@0.26.3 | tgz | sha512-fLTwYvQGaKRkffeXMhZteCQh2ugOAZ1dWuqLLKZj58vTG/0fTPKEnVHKKYKspgiSrzB7/zwBqjuxh5LHHOoQbw== |
verified attestation |
| @openclaw/fs-safe-win32-x64-msvc@0.26.3 | tgz | sha512-KH4kn429FnoSKvSy1n7iGw8tzoBrJYXye4GxkKRtzYmzeFCW+6/s27O4QFOPOHqT2yqDjCwFRQT4ws5R0wWyfQ== |
verified attestation |
| @openclaw/fs-safe-freebsd-x64@0.26.3 | tgz | sha512-7CmAP/I1xYl47ZqqGAa0GVSDVS1mNF0G053RVpJg5xIcRwnbAvut5o5SLdW4kASEzQDYUHOpttMqnkdIGXUTMQ== |
verified attestation |
| @openclaw/fs-safe-freebsd-arm64@0.26.3 | tgz | sha512-ShOI91bnXkEetPmrqLiXYCwCiItamHRBIi83QBQqKQI7pcmDyGePGLIxyPVF1zJVewAIkfXqsBHqajfeTSCasg== |
verified attestation |
| @openclaw/fs-safe@0.26.3 | tgz | sha512-p9ORyEheR2x+PMvxsrYyM47KN7LH7bsgyeiKaCvu08ibW/8733h/NmUy2xWoNP39ChULBN8adRcT03DSs3sXWw== |
verified attestation |
Release proof: GitHub Actions run.