chore: development v0.2.102 - comprehensive testing complete [auto-commit]

Author: githubrobbi

Cargo.lock

@@ -39,7 +39,7 @@ exclude = [
 # Workspace Package Metadata (inherited by all crates)
 # ─────────────────────────────────────────────────────────────────────────────
 [workspace.package]
-version = "0.2.101"
+version = "0.2.102"
 edition = "2024"
 rust-version = "1.85"
 license = "MPL-2.0 OR LicenseRef-UFFS-Commercial"

Cargo.toml

@@ -21,7 +21,7 @@ Traditional file search tools (including `os.walk`, `FindFirstFile`, etc.) work
 
 **UFFS reads the MFT directly** - once - and queries it in memory using Polars DataFrames. This is like reading the entire phonebook once instead of looking up each name individually.
 
-### Benchmark Results (v0.2.101)
+### Benchmark Results (v0.2.102)
 
 | Drive Type | Records | Time | Throughput |
 |------------|---------|------|------------|
@@ -33,7 +33,7 @@ Traditional file search tools (including `os.walk`, `FindFirstFile`, etc.) work
 
 | Comparison | Records | Time | Notes |
 |------------|---------|------|-------|
-| **UFFS v0.2.101** | **18.7 Million** | **~142 seconds** | All disks, fast mode |
+| **UFFS v0.2.102** | **18.7 Million** | **~142 seconds** | All disks, fast mode |
 | UFFS v0.1.30 | 18.7 Million | ~315 seconds | Baseline |
 | Everything | 19 Million | 178 seconds | All disks |
 | WizFile | 6.5 Million | 299 seconds | Single HDD |

README.md

@@ -4688,7 +4688,9 @@ const INDEX_MAGIC: &[u8; 8] = b"UFFSIDX\0";
 /// Current index file format version.
 /// Version 2: Changed `IndexNameRef` to use bit-packed `meta` field instead of
 /// separate length/flags
-const INDEX_VERSION: u32 = 2;
+/// Version 3: Added tree metrics (descendants, treesize, `tree_allocated`) to
+/// `FileRecord` serialization
+const INDEX_VERSION: u32 = 3;
 
 /// Persistent index header stored at the beginning of the index file.
 #[derive(Debug, Clone)]
@@ -4836,6 +4838,10 @@ impl MftIndex {
             buffer.extend_from_slice(&record.first_stream.name.offset.to_le_bytes());
             buffer.extend_from_slice(&record.first_stream.name.meta.to_le_bytes());
             buffer.extend_from_slice(&record.first_stream.flags.to_le_bytes());
+            // Tree metrics (Version 3+)
+            buffer.extend_from_slice(&record.descendants.to_le_bytes());
+            buffer.extend_from_slice(&record.treesize.to_le_bytes());
+            buffer.extend_from_slice(&record.tree_allocated.to_le_bytes());
         }
 
         // Write names
@@ -5039,6 +5045,10 @@ impl MftIndex {
             let stream_name_offset = read_u32!();
             let stream_name_meta = read_u32!();
             let stream_flags = read_u8!();
+            // Tree metrics (Version 3+)
+            let descendants = if version >= 3 { read_u32!() } else { 0 };
+            let treesize = if version >= 3 { read_u64!() } else { 0 };
+            let tree_allocated = if version >= 3 { read_u64!() } else { 0 };
 
             records.push(FileRecord {
                 frs,
@@ -5072,9 +5082,9 @@ impl MftIndex {
                     },
                     flags: stream_flags,
                 },
-                descendants: 0,
-                treesize: 0,
-                tree_allocated: 0,
+                descendants,
+                treesize,
+                tree_allocated,
             });
         }
 
@@ -5193,6 +5203,12 @@ impl MftIndex {
         // Compute stats from loaded data
         index.recompute_stats();
 
+        // If loading an old version (< 3) without tree metrics, recompute them
+        if version < 3 {
+            tracing::debug!("Old index version {version} - recomputing tree metrics");
+            index.compute_tree_metrics();
+        }
+
         Ok((index, header))
     }
 

crates/uffs-mft/src/index.rs

@@ -4062,6 +4062,14 @@ async fn cmd_index_update(drive: char, force_full: bool, ttl: Option<u64>) -> Re
             );
             println!("   Applied in {:.3}s", apply_time.as_secs_f64());
 
+            // Recompute tree metrics after structural changes
+            println!();
+            println!("🔨 Recomputing tree metrics...");
+            let tree_start = Instant::now();
+            updated_index.compute_tree_metrics();
+            let tree_time = tree_start.elapsed();
+            println!("   Computed in {:.3}s", tree_time.as_secs_f64());
+
             // Save updated index
             let handle = VolumeHandle::open(drive)?;
             let volume_data = handle.volume_data();

crates/uffs-mft/src/main.rs

@@ -3897,6 +3897,10 @@ impl MultiDriveMftReader {
                 "📊 USN changes applied"
             );
 
+            // Recompute tree metrics after structural changes
+            debug!(drive = %drive, "🔨 Recomputing tree metrics after USN updates");
+            index.compute_tree_metrics();
+
             // Save updated index to cache with new checkpoint
             let handle = match VolumeHandle::open(drive) {
                 Ok(h) => h,

crates/uffs-mft/src/reader.rs

@@ -1 +1 @@
-v0.2.101
+v0.2.102