[jan-auer]

The filesystem backend stores each object key segment as one directory level. When an object was deleted, its directories stayed on disk. Self-hosted and local deployments therefore collected a growing number of empty directories, which can slow down the filesystem.

Deleting an object now also removes its directories while they are empty, up to the storage root. Cleanup stops at the first directory that still holds other objects. A failed cleanup never fails the delete.

This cleanup does not take any lock. Object locks are per object, but directories are shared by many objects, so locking every directory level would be expensive. Instead, this relies on the fact that directory removal is atomic and only succeeds on empty directories, so it can never remove stored objects. The only race is a writer that has just created a directory but has not yet placed its file in it. Writers now handle this: if the directory is gone when they create their draft or publish a resumable upload, they create it again and retry, up to three attempts. The delete releases the object lock before it starts the cleanup.

Fixes FS-158

Changelog Entry

• The filesystem backend now removes empty object directories when an object is deleted or a write fails.

[linear-code]

FS-158

[github-actions]

Changelog Preview

This PR lands in these workspaces:

• objectstore-server: CalVer

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

Bug Fixes

• The filesystem backend now removes empty object directories when an object is deleted or a write fails. by jan-auer in #755

---

_{🤖 This preview updates automatically when you update the PR.}

[codecov]

Codecov Report

❌ Patch coverage is 95.83333% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 91.88%. Comparing base (7d411dd) to head (13a2be5).

Files with missing lines	Patch %	Lines
objectstore-service/src/backend/local_fs.rs	95.83%	4 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #755      +/-   ##
==========================================
+ Coverage   91.86%   91.88%   +0.01%     
==========================================
  Files         119      119              
  Lines       22978    23059      +81     
==========================================
+ Hits        21109    21188      +79     
- Misses       1869     1871       +2     

Components	Coverage Δ
Rust Backend	94.85% <95.83%> (+<0.01%)	⬆️
Rust Client	89.13% <ø> (ø)
Python Client	91.64% <ø> (ø)

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit fc6d205. Configure here.}