Summary

Improve the R2 storage structure to eliminate redundancy by storing all blobs in the versions/ directory rather than duplicating the current version in a separate blobs/ directory.

Changes

• 📁 Updated storage structure to use only metadata/ and versions/ directories
• 🔧 Added current_version field to metadata to track the active version timestamp
• 📝 Updated API documentation to reflect blob fetching from versions directory
• ✨ Enhanced version history documentation with implementation details
• 📚 Added storage design notes explaining the benefits

Benefits

1. No redundancy - Each blob stored only once
2. Simpler updates - Just add new timestamp file and update metadata pointer
3. Atomic operations - No need to copy/move files between directories
4. Better consistency - Single source of truth for all content
5. Easier cleanup - When pruning old versions, just delete timestamp files

Implementation Impact

When this design is implemented:

• GET /api/blobs/{id} will read metadata first to get current_version, then fetch from versions/{id}/{current_version}.bin
• PUT /api/gists/{id} will create new file at versions/{id}/{new-timestamp}.bin and update metadata
• No migration needed for new projects, but existing projects would need to move blobs from blobs/ to versions/

🤖 Generated with Claude Code