Cargo.toml

# =============================================================================
# Cargo.toml - UFFS (Ultra Fast File Search) Workspace
# =============================================================================
#
# SPDX-License-Identifier: MPL-2.0
# Copyright (c) 2025-2026 Robert Nio
#
# UFFS - Ultra Fast File Search
# Ultra-high-performance file search using direct MFT reading and Polars
# DataFrames for blazing-fast queries.
# Contact: 50460704+githubrobbi@users.noreply.github.com for licensing inquiries
#
# Last Updated: April 2026 - Nightly (1.96+) / Edition 2024
# =============================================================================

# ─────────────────────────────────────────────────────────────────────────────
# Workspace Configuration
# ─────────────────────────────────────────────────────────────────────────────
[workspace]
resolver = "3"
members = [
    # ── Foundation ──
    "crates/uffs-polars",   # 🚀 Polars facade (compilation isolation)
    "crates/uffs-security", # 🔒 Crypto, key storage, secure FS ops
    "crates/uffs-text",     # 📝 Unicode text processing, i18n foundation
    "crates/uffs-mft",      # 📦 MFT reading → Polars DataFrame
    "crates/uffs-core",     # 🎯 Query engine + compact search engine
    # ── Daemon Architecture ──
    "crates/uffs-daemon",   # 🛡️ Background service process
    "crates/uffs-client",   # 📡 Thin client library
    "crates/uffs-mcp",      # 🤖 MCP stdio adapter for AI agents
    "crates/uffs-broker",   # 🔑 Windows elevated handle broker (optional)
    # ── Surfaces ──
    "crates/uffs-cli",      # 🖥️  Command-line interface
    "crates/uffs-tui",      # 📟 Terminal UI
    "crates/uffs-gui",      # 🪟 Graphical UI (future)
    # ── Tools ──
    "crates/uffs-diag",     # 🔬 Retained workspace-only diagnostic tools (not shipped in dist/)
]

# ─────────────────────────────────────────────────────────────────────────────
# Workspace Package Metadata (inherited by all crates)
# ─────────────────────────────────────────────────────────────────────────────
[workspace.package]
version = "0.4.100"
edition = "2024"
# MSRV: Pure Rust code compiles on stable 1.91+ (Duration::from_mins),
# but Polars is built with features = ["nightly", "simd"] which requires
# a nightly toolchain. See rust-toolchain.toml for the pinned nightly channel.
rust-version = "1.91"
license = "MPL-2.0 OR LicenseRef-UFFS-Commercial"
repository = "https://github.com/githubrobbi/UltraFastFileSearch"
authors = ["Robert Nio <50460704+githubrobbi@users.noreply.github.com>"]
description = "UFFS - Ultra Fast File Search using direct NTFS MFT reading and Polars DataFrames"
documentation = "https://docs.rs/uffs"
readme = "README.md"
keywords = ["mft", "ntfs", "file-search", "windows", "polars"]
categories = ["filesystem", "command-line-utilities"]

# ─────────────────────────────────────────────────────────────────────────────
# Workspace Dependencies (shared versions & pins)
# ─────────────────────────────────────────────────────────────────────────────
[workspace.dependencies]
# ───── Internal Crates ─────
uffs-polars   = { path = "crates/uffs-polars" }
uffs-security = { path = "crates/uffs-security" }
uffs-text     = { path = "crates/uffs-text" }
uffs-mft      = { path = "crates/uffs-mft", features = ["zstd"] }
uffs-core     = { path = "crates/uffs-core" }
uffs-client   = { path = "crates/uffs-client" }
uffs-daemon   = { path = "crates/uffs-daemon" }
# NOTE: no `uffs-diag` workspace dependency alias on purpose.
# It is a top-level diagnostic/tool crate, not a shared runtime dependency.

# ───── Polars (via facade crate for compilation isolation) ─────
# Polars is pinned to a specific commit in crates/uffs-polars/Cargo.toml (rev = "...").
# Run `just polars` to bump to the latest main HEAD.

# ───── Async Runtime ─────
tokio = { version = "1.51.0", features = ["full", "macros", "rt-multi-thread", "time", "tracing"] }

# ───── Windows APIs (Windows only) ─────
windows = { version = "0.62.2", features = [
    "Win32_Foundation",
    "Win32_Security",
    "Win32_Security_Authorization",
    "Win32_Security_Cryptography",
    "Win32_Storage",
    "Win32_Storage_FileSystem",
    "Win32_System_Com",
    "Win32_System_IO",
    "Win32_System_Ioctl",
    "Win32_System_Memory",
    "Win32_System_Pipes",
    "Win32_System_SystemInformation",
    "Win32_System_Threading",
    "Win32_System_Wmi",
    "Win32_UI_Shell",
    "Win32_UI_WindowsAndMessaging",
] }

# ───── Serialization ─────
serde = { version = "1.0.228", features = ["derive"] }
serde_json = "1.0.149"
toml = "1.1.2"

# ───── Data Structures ─────
bitflags = "2.11.0"
bytemuck = { version = "1.25.0", features = ["derive"] }
smallvec = "1.15.1"
zerocopy = { version = "0.8", features = ["derive"] }

# ───── Error Handling ─────
thiserror = "2.0.18"
anyhow = "1.0.102"

# ───── Logging & Tracing ─────
tracing = "0.1.44"
tracing-subscriber = { version = "0.3.23", features = ["fmt", "time", "env-filter"] }
tracing-appender = "0.2.4"

# ───── CLI ─────
clap = { version = "4.6.0", features = ["derive", "env", "unicode", "wrap_help"] }
indicatif = "0.18.4"

# ───── TUI ─────
ratatui = "0.30.0"
crossterm = "0.29.0"
ratatui-textarea = { version = "0.8.0", features = ["crossterm", "search"] }
devicons = "0.6.12"

# ───── Pattern Matching ─────
regex = "1.12.3"
memchr = "2.8.0"
aho-corasick = "1.1.4"
globset = "0.4.18"

# ───── Time ─────
chrono = { version = "0.4.44", features = ["serde"] }

# ───── Directories ─────
dirs-next = "2.0.0"

# ───── Hashing ─────
rustc-hash = "2.1.2"

# ───── Formatting / Encoding ─────
itoa = "1.0.18"
sha2 = "0.11.0"
hex = "0.4.3"

# ───── Parallelism ─────
rayon = "1.11.0"

# ───── Memory ─────
mimalloc = "0.1.48"
memmap2 = "0.9.10"

# ───── System ─────
libc = "0.2"

# ───── Security / Crypto ─────
aes-gcm = "0.10"
rand = "0.10.0"
security-framework = "3.7.0"

# ───── Compression ─────
zstd = { version = "0.13.3", features = ["zstdmt"] }

# ───── Testing & Benchmarking ─────
criterion = "0.8.2"
proptest = "1.11.0"
assert_cmd = "2.2.0"

# ═══════════════════════════════════════════════════════════════════════════════
# WORKSPACE-WIDE SUPER STRICT LINTING CONFIGURATION (2026 CUTTING-EDGE STANDARDS)
# ═══════════════════════════════════════════════════════════════════════════════
# All crates inherit these STRICTEST possible clippy settings for maximum code quality
# This ensures consistent, high-quality standards across the entire workspace
# Updated: April 2026 - Nightly (1.96+) / Edition 2024

[workspace.lints.clippy]
# ───── Core lint groups (strictest levels) ─────
cargo = { level = "deny", priority = -1 }
nursery = { level = "deny", priority = -1 }
pedantic = { level = "deny", priority = -1 }

# ───── DENY level lints (strictest possible - no exceptions) ─────
wildcard_imports = "deny"
unwrap_used = "deny"                    # Force proper error handling
expect_used = "deny"                    # Force proper error handling
panic = "deny"                          # No panics allowed
todo = "deny"                           # No TODOs in production code
unimplemented = "deny"                  # No unimplemented code
unreachable = "deny"                    # No unreachable code
missing_docs_in_private_items = "deny"  # Document everything
undocumented_unsafe_blocks = "deny"     # Document all unsafe (if any)
multiple_unsafe_ops_per_block = "deny"  # Limit unsafe operations
unnecessary_safety_doc = "deny"         # Accurate safety docs
unnecessary_safety_comment = "deny"     # Accurate safety comments

# ───── WARN level lints (very strict but not blocking) ─────
missing_errors_doc = "warn"             # Document error conditions
missing_panics_doc = "warn"             # Document panic conditions
missing_safety_doc = "warn"             # Document safety requirements
cognitive_complexity = "warn"           # Keep functions simple
too_many_lines = "warn"                 # Keep functions short
type_complexity = "warn"                # Keep types simple
large_enum_variant = "warn"             # Optimize enum memory usage
large_stack_arrays = "warn"             # Avoid large stack allocations
large_types_passed_by_value = "warn"    # Pass large types by reference
trivially_copy_pass_by_ref = "warn"     # Pass small types by value
clone_on_ref_ptr = "warn"               # Avoid unnecessary clones
redundant_clone = "warn"                # Remove redundant clones
unnecessary_wraps = "warn"              # Remove unnecessary Result/Option wraps
option_option = "warn"                  # Avoid Option<Option<T>>
result_unit_err = "warn"                # Use better error types
bool_to_int_with_if = "warn"            # Use more idiomatic conversions
cast_lossless = "warn"                  # Use lossless casts
cast_possible_truncation = "warn"       # Warn about truncating casts
cast_possible_wrap = "warn"             # Warn about wrapping casts
cast_precision_loss = "warn"            # Warn about precision loss
cast_sign_loss = "warn"                 # Warn about sign loss
float_cmp = "warn"                      # Proper float comparisons
float_cmp_const = "warn"                # Proper float constant comparisons
lossy_float_literal = "warn"            # Avoid lossy float literals
imprecise_flops = "warn"                # Precise floating point operations
suboptimal_flops = "warn"               # Optimal floating point operations
fn_params_excessive_bools = "warn"      # Avoid too many boolean parameters
struct_excessive_bools = "warn"         # Avoid too many boolean fields
verbose_bit_mask = "warn"               # Use cleaner bit operations
inefficient_to_string = "warn"          # Use efficient string conversions
string_add = "warn"                     # Use format! instead of string addition
string_add_assign = "warn"              # Use format! instead of +=
string_slice = "warn"                   # Use proper string slicing
str_to_string = "warn"                  # Use to_owned() instead of to_string()
implicit_clone = "warn"                 # Make clones explicit
cloned_instead_of_copied = "warn"       # Use copy when possible
map_clone = "warn"                      # Use copied() instead of map(clone)
filter_map_next = "warn"                # Use find_map instead
flat_map_option = "warn"                # Use filter_map instead
manual_filter_map = "warn"              # Use filter_map
manual_find_map = "warn"                # Use find_map
map_unwrap_or = "warn"                  # Use map_or instead
unnecessary_unwrap = "warn"             # Remove unnecessary unwraps
or_fun_call = "warn"                    # Use or_else for expensive operations
single_match_else = "warn"              # Use if let instead of match
match_bool = "warn"                     # Use if instead of match on bool
indexing_slicing = "warn"               # Avoid indexing and slicing on Vec
match_same_arms = "warn"                # Combine identical match arms
redundant_pattern_matching = "warn"     # Simplify pattern matching
single_match = "warn"                   # Use if let instead of single match
wildcard_enum_match_arm = "warn"        # Handle all enum variants explicitly
enum_glob_use = "warn"                  # Avoid glob imports of enums
use_self = "warn"                       # Use Self instead of type name
needless_pass_by_value = "warn"         # Pass by reference when appropriate
trivial_regex = "warn"                  # Use string methods instead of regex
naive_bytecount = "warn"               # Use bytecount crate for counting
manual_memcpy = "warn"                  # Use copy_from_slice
manual_swap = "warn"                    # Use mem::swap
ptr_as_ptr = "warn"                     # Use cast() instead of as
ptr_cast_constness = "warn"             # Proper const pointer casts
ref_as_ptr = "warn"                     # Proper reference to pointer conversion
borrow_as_ptr = "warn"                  # Proper borrow to pointer conversion
case_sensitive_file_extension_comparisons = "warn"  # Case-insensitive file extensions
path_buf_push_overwrite = "warn"        # Avoid PathBuf overwrite bugs
same_name_method = "warn"               # Avoid method name conflicts
shadow_reuse = "warn"                   # Avoid variable shadowing
shadow_same = "warn"                    # Avoid identical variable shadowing
shadow_unrelated = "warn"               # Avoid unrelated variable shadowing
similar_names = "warn"                  # Avoid confusingly similar names
suspicious_else_formatting = "warn"     # Proper else formatting
suspicious_unary_op_formatting = "warn" # Proper unary operator formatting
tabs_in_doc_comments = "warn"           # Use spaces in doc comments
trailing_empty_array = "warn"           # Remove trailing empty arrays
unicode_not_nfc = "warn"                # Use NFC Unicode normalization
unseparated_literal_suffix = "warn"     # Separate literal suffixes
unused_self = "warn"                    # Remove unused self parameters
used_underscore_binding = "warn"        # Don't use underscore bindings
useless_let_if_seq = "warn"             # Simplify let-if sequences
zero_sized_map_values = "warn"          # Avoid zero-sized map values

# ───── Restriction lints (hand-picked — we do NOT enable the whole group) ─────
as_pointer_underscore = "deny"          # Dangerous pointer casts with inferred type (1.85+)
cfg_not_test = "warn"                   # Catch cfg(not(test)) misuse
deref_by_slicing = "warn"              # Use &* instead of &v[..]
empty_line_after_doc_comments = "warn" # Clean doc comment style
empty_line_after_outer_attr = "warn"   # Clean attribute style
four_forward_slashes = "warn"          # Catch //// (typo for ///)
iter_filter_is_ok = "warn"             # Use flatten() instead of filter + is_ok
iter_filter_is_some = "warn"           # Use flatten() instead of filter + is_some
manual_is_power_of_two = "warn"        # Use is_power_of_two()
pathbuf_init_then_push = "warn"        # Use PathBuf::from directly
pub_underscore_fields = "warn"         # Don't expose _prefixed fields
renamed_function_params = "warn"       # Trait impls must match param names
set_contains_or_insert = "warn"        # Use entry API for sets
unnecessary_map_or = "warn"            # Simplify map_or calls (1.92+)
unnecessary_result_map_or_else = "warn" # Simplify Result::map_or_else

# ───── Error handling & safety ─────
error_impl_error = "warn"               # Proper Error trait implementations
exit = "deny"                           # No std::process::exit
get_unwrap = "deny"                     # Use get().ok_or() instead
let_underscore_must_use = "warn"        # Don't ignore must_use values
map_err_ignore = "warn"                 # Don't ignore map_err values
mem_forget = "deny"                     # Avoid mem::forget
missing_assert_message = "warn"         # Add messages to assertions
missing_asserts_for_indexing = "warn"   # Assert before indexing
try_err = "warn"                        # Use ? instead of try!

# ───── Memory & allocation ─────
assigning_clones = "warn"               # Use clone_from instead of clone + assign
rc_buffer = "warn"                      # Avoid Rc<String> or Rc<Vec>
rc_mutex = "warn"                       # Avoid Rc<Mutex<T>>
read_zero_byte_vec = "warn"             # Avoid reading into zero-capacity vec
significant_drop_in_scrutinee = "warn"  # Avoid drops in match scrutinee
significant_drop_tightening = "warn"    # Tighten significant drop scope

# ───── Concurrency & performance ─────
mutex_atomic = "warn"                   # Use atomics instead of mutex for simple types
stable_sort_primitive = "warn"          # Use unstable_sort for primitives
infinite_loop = "warn"                  # Detect infinite loops

# ───── Iterator patterns ─────
collection_is_never_read = "warn"       # Detect unused collections
iter_on_empty_collections = "warn"      # Avoid iterating empty collections
iter_on_single_items = "warn"           # Use std::iter::once instead
iter_over_hash_type = "warn"            # Non-deterministic iteration order
needless_collect = "warn"               # Avoid unnecessary collect()
needless_for_each = "warn"              # Use for loop instead of for_each

# ───── String & formatting ─────
format_push_string = "warn"             # Use write! instead of format! + push
manual_string_new = "warn"              # Use String::new()
needless_raw_string_hashes = "warn"     # Minimize raw string hashes
needless_raw_strings = "warn"           # Avoid unnecessary raw strings
string_lit_chars_any = "warn"           # Use contains instead of chars().any()

# ───── Numeric & type precision ─────
default_numeric_fallback = "warn"       # Explicit numeric types
float_arithmetic = "warn"               # Be careful with float arithmetic
suspicious_xor_used_as_pow = "warn"     # Detect ^ used as power
unreadable_literal = "warn"             # Use underscores in large literals

# ───── Idiomatic patterns ─────
equatable_if_let = "warn"               # Use == instead of if let for equality
if_then_some_else_none = "warn"         # Use bool::then instead
manual_assert = "warn"                  # Use assert! macro
manual_instant_elapsed = "warn"         # Use Instant::elapsed()
manual_is_ascii_check = "warn"          # Use is_ascii methods
manual_let_else = "warn"                # Use let-else syntax
manual_ok_or = "warn"                   # Use ok_or instead of match
option_if_let_else = "warn"             # Use map_or_else instead
verbose_file_reads = "warn"             # Use fs::read_to_string

# ───── Control flow & logic ─────
debug_assert_with_mut_call = "warn"     # Avoid side effects in debug_assert
mixed_read_write_in_expression = "warn" # Avoid read+write in same expression
same_functions_in_if_condition = "warn" # Avoid duplicate function calls

# ───── Code style & structure ─────
empty_drop = "warn"                     # Remove empty Drop implementations
empty_structs_with_brackets = "warn"    # Use unit struct syntax
impl_trait_in_params = "warn"           # Prefer generics over impl Trait in params
let_underscore_untyped = "warn"         # Type underscore bindings
min_ident_chars = "warn"                # Minimum identifier length
no_effect_underscore_binding = "warn"   # Remove no-effect underscore bindings
nonstandard_macro_braces = "warn"       # Consistent macro brace style
partial_pub_fields = "warn"             # Consistent field visibility
pub_without_shorthand = "warn"          # Use pub(crate) shorthand
redundant_type_annotations = "warn"     # Remove redundant type annotations
ref_patterns = "warn"                   # Avoid ref patterns
rest_pat_in_fully_bound_structs = "warn" # Avoid .. in fully bound structs
semicolon_inside_block = "warn"         # Consistent semicolon placement
semicolon_outside_block = "warn"        # Consistent semicolon placement
single_call_fn = "allow"                # Intentional: helper functions improve readability even if called once
unnecessary_self_imports = "warn"       # Remove unnecessary self imports
unnecessary_struct_initialization = "warn" # Simplify struct initialization
unneeded_field_pattern = "warn"         # Remove unneeded field patterns

# ───── Filesystem ─────
filetype_is_file = "warn"               # Use is_file() properly

# ───── Output discipline ─────
print_stderr = "warn"                   # Use proper logging instead
print_stdout = "warn"                   # Use proper logging instead
use_debug = "warn"                      # Avoid Debug in production

# ───── Portability ─────
std_instead_of_alloc = "warn"           # Use alloc when std not needed
std_instead_of_core = "warn"            # Use core when std not needed

# ───── Testing hygiene ─────
tests_outside_test_module = "warn"      # Keep tests in test modules

# ───── Unused / dead code ─────
unused_async = "warn"                   # Remove unused async
unused_peekable = "warn"                # Remove unused peekable
unused_rounding = "warn"                # Remove unused rounding

# ───── Exceptions ─────
# External deps (polars, tokio ecosystem) pull transitive version conflicts
# that we cannot resolve. Acknowledged and allowed.
multiple_crate_versions = "allow"

[workspace.lints.rust]
# ───── Rust compiler lints (strictest possible) ─────
unsafe_code = "deny"                    # No unsafe code without explicit allow
missing_docs = "warn"                   # Warn on missing public docs
rust_2024_compatibility = { level = "warn", priority = -1 }  # Ensure 2024 edition compatibility
# ───── Future-proofing lints ─────
future_incompatible = { level = "deny", priority = -1 }  # Catch future breaking changes
nonstandard_style = { level = "warn", priority = -1 }    # Consistent naming conventions
unexpected_cfgs = "warn"                # Catch typos / stale cfg attributes
# ───── Additional safety lints ─────
unsafe_op_in_unsafe_fn = "deny"         # Require unsafe blocks inside unsafe fn
unused_crate_dependencies = "warn"      # Detect unused dependencies
unused_import_braces = "warn"           # Clean import style
unused_lifetimes = "warn"               # Remove unnecessary lifetimes
unused_macro_rules = "warn"             # Remove unused macro rules
unused_qualifications = "warn"          # Remove unnecessary path qualifications
variant_size_differences = "warn"       # Warn about enum variant size differences

[workspace.lints.rustdoc]
# ───── Documentation quality lints ─────
broken_intra_doc_links = "deny"         # No broken doc links
private_intra_doc_links = "warn"        # Warn about private doc links
missing_crate_level_docs = "warn"       # Require crate-level documentation
invalid_codeblock_attributes = "warn"   # Valid code block attributes
invalid_html_tags = "warn"              # Valid HTML in docs
invalid_rust_codeblocks = "warn"        # Valid Rust in doc code blocks
bare_urls = "warn"                      # Use proper markdown links

# ─────────────────────────────────────────────────────────────────────────────
# Cargo Profiles
# ─────────────────────────────────────────────────────────────────────────────
[profile.dev]
opt-level = 0
debug = true
debug-assertions = true
overflow-checks = true
incremental = true
codegen-units = 256

[profile.debug-optimized]
inherits = "dev"
opt-level = 2
debug = true
debug-assertions = true
overflow-checks = true

[profile.release]
opt-level = 3
debug = false
debug-assertions = false
overflow-checks = false
incremental = false
codegen-units = 1
lto = "fat"
panic = "abort"
strip = "symbols"
rpath = false
# trim-paths = "object"                 # Reproducible builds (not yet stable in Cargo)

[profile.profiling]
inherits = "release"
debug = true                            # Enable debug symbols for flamegraph
strip = false                           # Don't strip symbols (needed for profiling)
lto = false                             # Disable LTO for cleaner call stacks in profiles
codegen-units = 16                      # Balance between compile time and consistent stacks

[profile.bench]
inherits = "release"
codegen-units = 1
debug = false
debug-assertions = false
incremental = false
lto = "thin"
opt-level = 3
overflow-checks = false
strip = "debuginfo"

[profile.dist]
inherits = "release"
lto = "thin"

[profile.test]
inherits = "dev"

[profile.dev.package.polars]
opt-level = 2                           # Optimize Polars even in dev for usable performance

[profile.dev.package."*"]
opt-level = 0

# ─────────────────────────────────────────────────────────────────────────────
# Cross-compile profile for cargo-xwin (macOS → Windows MSVC)
# ─────────────────────────────────────────────────────────────────────────────
# Workaround for COFF archive size limits. Debug builds of polars produce
# ~5.5 GB .rlib files that exceed what lld-link can parse.
# See: docs/xwin-msvc-rlib-size-root-cause-and-workarounds.md
#
# Usage: cargo xwin build --profile xwin-dev --target x86_64-pc-windows-msvc
# ─────────────────────────────────────────────────────────────────────────────
[profile.xwin-dev]
inherits = "dev"
debug = 2                               # Full debug for YOUR code
debug-assertions = true
overflow-checks = true
incremental = false                     # Required: incremental breaks xwin archives
opt-level = 0                           # Fast compile for your code

# Tame polars crates to keep .rlib under COFF limits
# codegen-units=1 dramatically reduces archive member count
# opt-level=1 often REDUCES code size for generic-heavy crates
# debug=1 keeps line tables for backtraces but skips variable info
[profile.xwin-dev.package.polars]
debug = 1
opt-level = 1
codegen-units = 1

# All other deps: fast compile, minimal debug
[profile.xwin-dev.package."*"]
debug = 1
opt-level = 0


# ─────────────────────────────────────────────────────────────────────────────
# Workspace Metadata
# ─────────────────────────────────────────────────────────────────────────────

# Workspace-level release-plz configuration
[workspace.metadata.release-plz]
git_release_enable = true
git_tag_enable = true
changelog_update = true
dependencies_update = true
allow_dirty = false
publish = true
git_release_draft = false

# Workspace-level cargo-dist configuration
[workspace.metadata.dist]
cargo-dist-version = "0.30.0"
ci = ["github"]
installers = ["shell", "powershell"]
targets = [
    "aarch64-apple-darwin",
    "x86_64-apple-darwin",
    "x86_64-unknown-linux-gnu",
    "aarch64-unknown-linux-gnu",
    "x86_64-pc-windows-msvc"
]
pr-run-mode = "plan"
allow-dirty = ["ci"]