OOS-Lite v0.2.3 - Core Durability and Recovery Fixes

OOS-Lite v0.2.3 - Core Durability and Recovery Fixes

This patch release fixes several storage-engine failure modes and improves large-file ingestion without changing the public API or on-disk formats.

Core fixes

• Fixed GC rollback after a crash during a partial multi-segment swap. Original segments that had not yet been renamed are now preserved.
• Fixed a race during encrypted-store initialization by acquiring the exclusive store lock before reading or creating vault.key.
• Changed new writes to stream chunks directly into durable segment storage. WAL records now contain metadata and manifests instead of retaining all new file data in memory.
• Added WAL recovery validation so metadata is never committed when a manifest references a missing durable chunk.
• Added checked WAL length conversions for names, manifests, chunk counts, chunk sizes, total payload size, and encryption overhead.
• Fixed watcher reconciliation so same-size content changes are detected with BLAKE3.
• Standardized the remaining core decryption error message in English.

Existing WAL records containing chunk data remain readable. Existing vaults and segment files require no migration.

Windows installation

Download OOS-Lite-Setup-v0.2.3.exe and run the installer. The portable package oos-lite-windows-x86_64-v0.2.3.zip is also available for use without installation.

Linux installation

OOS-Lite requires FUSE 3 for virtual filesystem mounting.

# Ubuntu / Debian dependencies
sudo apt update
sudo apt install -y libfuse3-3 fuse3

# Download and extract OOS-Lite
wget https://github.com/pudo58/oos-lite/releases/download/v0.2.3/oos-lite-linux-x86_64-v0.2.3.tar.gz
mkdir -p "$HOME/.local/share/oos-lite"
tar -xzf oos-lite-linux-x86_64-v0.2.3.tar.gz -C "$HOME/.local/share/oos-lite"

# Install the CLI and GUI launcher for the current user
mkdir -p "$HOME/.local/bin"
ln -sf "$HOME/.local/share/oos-lite/oos-lite" "$HOME/.local/bin/oos-lite"
ln -sf "$HOME/.local/share/oos-lite/oos-lite-gui" "$HOME/.local/bin/oos-lite-gui"

# Ensure ~/.local/bin is available in the current shell
export PATH="$HOME/.local/bin:$PATH"

# Verify and initialize a store
oos-lite --version
oos-lite --store-dir "$HOME/.oos-store" init

To keep ~/.local/bin on PATH, add the following line to ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

For an encrypted store, initialize with oos-lite --store-dir "$HOME/.oos-store" --password YOUR_PASSWORD init.

Release assets

• OOS-Lite-Setup-v0.2.3.exe - Windows installer
• oos-lite-windows-x86_64-v0.2.3.zip - Windows portable binaries
• oos-lite-linux-x86_64-v0.2.3.tar.gz - Linux x86_64 binaries
• SHA256SUMS.txt - SHA-256 checksums for all packages

OOS-Lite v0.2.2 - Cloudflare Tunnel Auto-Provisioning, Share UI Overhaul & Windows Shell Fixes

OOS-Lite v0.2.2 - Cloudflare Tunnel Auto-Provisioning, Share UI Overhaul & Windows Shell Fixes

🚀 Key Improvements & Highlights

• Seamless Internet Sharing with Cloudflare Quick Tunnels:

  • Zero-Configuration Auto-Download: OOS-Lite now automatically provisions and runs cloudflared directly into the vault's .oos-store/bin/ on demand. Users no longer need to manually install or configure any external tunneling tools.
  • Hidden Background Daemon: Spawns cloudflared with CREATE_NO_WINDOW on Windows, eliminating flashing command-line terminals when generating public links.
  • Zombie Process Cleanup: Proactively terminates orphaned cloudflared background instances on startup and share creation to prevent port contention and hanging tunnels.

• Polished File Share Experience:

  • Security & Privacy: Added password hide/reveal toggle and masked password inputs.
  • One-Click Clipboard Actions: Fast copy buttons for LAN address, Internet Public URL, and Passwords with visual checkmarks and instant toast notifications.
  • Real-Time Polling: Smart auto-polling UI that gracefully waits for Cloudflare's ephemeral URL assignment and displays the ready link without requiring popup reloads.
  • Session Guard Warning: Inlined persistent warnings alerting users to keep OOS-Lite active while sharing files.

• Windows Shell & Context Menu Hardening:

  • Silent Routing: Shell context menu commands ("Store in Vault", "View History", "Restore", "Snapshot") now route directly through oos-lite-gui.exe instead of popping console windows.
  • Fixed "Select an app" File Association Glitch: Corrected installer payload to register GUI targets in HKCU without prompting Windows file-open dialogs.
  • Resilient URL Parsing: Upgraded Cloudflare output scanner to handle ANSI terminal escape sequences and variable output buffering reliably.

---

🐧 Linux Quick Start & Installation

# 1. Download Linux binary bundle from GitHub Release v0.2.2
wget https://github.com/pudo58/oos-lite/releases/download/v0.2.2/oos-lite-linux-x86_64-v0.2.2.tar.gz

# 2. Extract the archive and set executable permissions
tar -xzf oos-lite-linux-x86_64-v0.2.2.tar.gz
chmod +x oos-lite oos-lite-gui

# 3. Install runtime dependency (for Ubuntu / Debian)
sudo apt update && sudo apt install -y libfuse2

# 4. Check version and view CLI help
./oos-lite --version
./oos-lite --help

# 5. Launch embedded Web UI Dashboard & Diff Studio
./oos-lite ui

---

📦 Download Assets

• Windows Installer (Recommended): OOS-Lite-Setup-v0.2.2.exe (Complete setup wizard with desktop shortcut, context menu integration, and uninstaller)
• Windows Portable Bundle: oos-lite-windows-x86_64-v0.2.2.zip (Pre-compiled standalone Windows binaries)
• Linux Standalone Bundle: oos-lite-linux-x86_64-v0.2.2.tar.gz (Pre-compiled native 64-bit Linux binaries with FUSE support)
• Integrity Checksums: SHA256SUMS.txt (SHA-256 verification hash list)

OOS-Lite v0.2.1 - Core Security Hardening, Bug Fixes & Linux Support

OOS-Lite v0.2.1 - Core Security Hardening, Bug Fixes & Linux Support

🚀 Key Improvements & Highlights:

• Critical Bug Fixes & Data Loss Prevention:

  • Auto-Vault Safe Unbinding: File deletion in watched directories now invokes unbind_file, unlinking the active file mapping while preserving the complete ObjectRecord and all historical backup snapshots.
  • Accurate Version Progression: Version calculation after pruning or rolling back now strictly computes from the historical latest_version (instead of array length), preventing version collision and historical rollback regression.
  • Windows Sharing Violation Fix: File read options upgraded to FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE on Windows, eliminating spurious OS Error 32 sharing violations when files are actively open in editors.
  • Zero-Leak RAII Cleanup: Integrated an RAII TmpFileGuard to guarantee immediate cleanup of temporary restoration files (.tmp.*) if extraction, reading, or hashing fails.

• Security & DoS Hardening:

  • Bounded Allocation in Decoders: Enforced strict boundary checks in WAL payload decoding and Segment readers against file length and maximum segment size (256 MB), completely preventing Out-Of-Memory (OOM) and DoS crashes from malicious/corrupted headers.
  • Windows Device Name & ADS Rejection: Proactively rejects Windows DOS reserved device names (CON, PRN, AUX, NUL, COM1..9, LPT1..9) and NTFS Alternate Data Streams (:).

• High-Performance Streaming:

  • Zero-Clone WAL Ingestion: Completely eliminated multi-GB RAM buffer duplication during write-ahead logging by transferring chunk ownership directly into the WAL payload.
  • High-Responsiveness Auto-Vault: Reduced event polling and worker sleep intervals to 50ms, boosting change detection and sync responsiveness by 4x.

• Cross-Platform Native Linux Support:

  • Full native standalone binaries pre-compiled for Linux x86_64 with FUSE & POSIX integration (oos-lite-linux-x86_64.tar.gz).

---

🐧 Linux Quick Start & Installation:

# 1. Download Linux binary bundle from GitHub Release v0.2.1
wget https://github.com/pudo58/oos-lite/releases/download/v0.2.1/oos-lite-linux-x86_64.tar.gz

# 2. Extract the archive and set executable permissions
tar -xzf oos-lite-linux-x86_64.tar.gz
chmod +x oos-lite oos-lite-gui

# 3. Install runtime dependency (for Ubuntu / Debian)
sudo apt update && sudo apt install -y libfuse2

# 4. Check version and view CLI help
./oos-lite --version
./oos-lite --help

# 5. Launch embedded Web UI Dashboard & Diff Studio
./oos-lite ui

---

📦 Download Assets:

• Windows Installer (Recommended): OOS-Lite-Setup-v0.2.1.exe (Complete setup wizard with desktop shortcut, context menu integration, and uninstaller)
• Windows Portable Bundle: oos-lite-windows-x86_64.zip (Pre-compiled standalone Windows binaries & uninstall scripts)
• Linux Standalone Bundle: oos-lite-linux-x86_64.tar.gz (Pre-compiled native 64-bit Linux binaries)
• Integrity Checksums: SHA256SUMS.txt (SHA-256 verification hash list)

OOS-Lite v0.2.0 - Version Diff Studio, In-Place Rollback & Native Desktop Experience

OOS-Lite v0.2.0 - Version Diff Studio, In-Place Rollback & Native Desktop Experience

🚀 Key Features & Highlights:

• Version Inspector & Diff Studio:

  • Real-time line-by-line diff comparison powered by an optimized Myers diff algorithm with prefix/suffix trimming.
  • Visual color-coded diff table with dual line numbering ([-] Red for Current Version lines, [+] Green for Selected Historical Version lines).
  • Stat badges tracking additions and deletions (+X / -Y line differences).
  • Flexible 3-way mode switcher:
    • 🔀 Line Diff: Color-coded side-by-side / inline diff with additions and deletions.
    • 📄 Selected Version Content: Full file view of the historical version with line numbering and 1-click clipboard copy.
    • 📋 Current Version Content: Full file view of the current file version on disk.
  • Side-by-side visual comparison for image files (.png, .jpg, .jpeg, .webp, .gif, .svg).
  • File size and BLAKE3 content hash delta inspection for non-text binary formats.

• One-Click In-Place Rollback:

  • Direct in-place file restoration on disk without requiring manual file download and replacement.
  • Non-destructive, auditable vault commits: rolling back creates a new forward version pointing to the target manifest, preserving complete version history and audit trails.
  • Instant rollback action buttons available directly inside both the version history table and the Inspector header.

• Native Desktop Application Window:

  • Upgraded GUI launcher to run in standalone Chromium Application Mode (--app), eliminating browser address bars, navigation controls, bookmarks, and tabs.
  • True native desktop window experience with dedicated title bar, custom app icon, standard Windows window controls (minimize, maximize, snap layout, close), and default 1200x820 sizing.
  • Supported across Microsoft Edge (pre-installed on Windows 10/11), Google Chrome, and Brave.

• Complete Multi-Tier Uninstallation System:

  • Automated process killer: cleanly terminates oos-lite.exe and oos-lite-gui.exe.
  • Network port scavenger: frees TCP ports 3000 (Web Dashboard) and 8080 (WebDAV drive).
  • Virtual drive unmapper: safely disconnects drive Z:\ (
    et use Z: /delete /y).
  • Clean Registry removal: unregisters all Windows Explorer context menu keys.
  • Standalone single-click script (uninstall.bat) and integrated CLI commands (oos-lite stop, oos-lite uninstall).

• Full Explorer Context Menu Integration:

  • Right-click integration for files and directories (Store in Vault, View Version History, Snapshot Folder, Auto-Vault Sync).
  • Seamless handover from Windows Explorer right-click directly into the Desktop App and Version Diff Studio.

---

📦 Download Assets:

• Windows Installer (Recommended): OOS-Lite-Setup-v0.2.0.exe (Complete Windows setup wizard with auto-startup, desktop shortcuts, and uninstaller)
• Portable CLI & GUI Bundle: oos-lite-windows-x86_64.zip (Pre-compiled standalone binaries and uninstall scripts)
• Integrity Checksums: SHA256SUMS.txt (Verify file integrity with SHA-256)

OOS-Lite v0.1.0 - Windows Versioned & Encrypted Drive

OOS-Lite v0.1.0 - Windows Versioned & Encrypted Drive

?? Key Features & Highlights:

• Windows Versioned Drive (WebDAV Z:): Transparent mount to Windows Explorer with zero custom kernel drivers required.
• End-to-End Encryption: XChaCha20-Poly1305 with BLAKE3 MAC, Argon2id key derivation, and atomic vault key management.
• Auto-Vault & Live Sync: Background real-time directory watcher with TOCTOU-safe locking, debounce, and automatic 3-tier reconciliation.
• Desktop GUI & System Tray: Native Windows tray integration, zero CMD console flash, folder tree explorer, and dual-language (EN/VI) support.
• Data Integrity & Garbage Collection: Mark-and-sweep GC and segment FSCK integrity validation.

?? Download Assets:

• OOS-Lite-Setup-v0.1.0.exe: Complete Windows Setup Installer (Recommended)
• oos-lite-windows-x86_64.zip: Portable CLI and Desktop binaries