Repository navigation
Lumen v1.5.0: Refined
Lumen v1.5.0 is a complete architectural rebuild of the desktop client and indexing pipeline. We stripped secondary window dependencies, eliminated multi-megabyte heap allocation bottlenecks, added progressive-disclosure keyboard ergonomics, and unified the interface onto native Windows 11 Desktop Acrylic glass.
Highlights & Key Features
1. Unified Single-Window Architecture (Zero Dispatcher Crashes)
- Single-HWND Canvas: Eliminated
SettingsWindowcompletely. The entire application now operates within a single native window handle (HWND) and a singleDispatcherQueue, permanently eradicating the WinUI 3CoreMessagingXP.dll0xc000027bmulti-window fail-fast crash. - In-Place Spring Transition: Pressing
Ctrl + ,or typingpreferencesexecutes an in-place view flip on the DWM compositor thread, swapping between the Search canvas and Preferences canvas without tearing down the visual tree or clearing your search state. - Native DWM Window Dragging: Intercepts mouse coordinates via Win32
WM_SYSCOMMAND (SC_MOVE | HTCAPTION). Drag the window from any non-interactive surface with zero mouse-sticking or pointer-lock bugs.
2. Zero-Allocation Search Engine (46,800× Heap Reduction)
- Benchmark-Verified SIMD Token Matching: Replaced naive LINQ iteration with a zero-allocation indexed loop with early exit.
- Benchmark Results (100,000 files):
- Heap Allocations: Reduced from 12,000,384 Bytes (~12MB) down to 256 Bytes per query.
- Garbage Collection: Dropped from 1,429 Gen 0 pauses per 1,000 searches to ZERO (0) collections.
- Execution Latency: Dropped from 6.90ms to 3.31ms for multi-word unordered token matching across entire drive tables.
3. Incremental FTS5 Document Indexing
- Timestamp MTime Cache: SQLite FTS5 document indexing now checks file
LastWriteTimeUtcticks prior to extraction. Unmodified documents are skipped in 0.01 milliseconds. - Target Scoping: Filtered document candidate discovery strictly to user profiles (Desktop, Documents, Downloads, Custom paths), eliminating redundant parsing of 20,000+ system files in
AppDataandProgram Files. - Stable Idle Footprint: Background indexing settles into an
Idlestate within seconds, dropping background memory to a stable working set baseline (~575MB holding 2.8M files and 25K full-text documents).
4. Progressive Disclosure & Intentional Aesthetics
- Staggered Filter Pills: A cascading row of semantic filter pills (
All,Docs,Images,Videos,Audio,Folders, andDrives) drops down from behind the search bar only when typing begins, animated withcubic-bezier(0.17, 0.73, 0.24, 1)and a 22ms per-pill delay. - Orthogonal Drive Scoping:
Drives ▾features a native flyout dropdown allowing users to scope searches to specific volumes (e.g.C:,D:) while simultaneously combining category filters (e.g. searching onlyImagesonD:). - Native Desktop Acrylic: Replaced opaque Mica fallback with
DesktopAcrylicBackdrop, restoring real-time frosted glass transparency over desktop wallpapers and underlying windows. - Semantic File Categories & Left-Edge Ambient Glow: File icons and cards feature color-coded category identities with a soft left-to-right gradient wash:
- 🔵 Documents: Electric Cerulean (
#3B82F6) - 🟢 Images: Emerald Green (
#10B981) - 🟡 Audio: Warm Amber (
#F59E0B) - 🟣 Video: Electric Violet (
#A855F7) - 🔷 Code / Data: Cyan (
#06B6D4) - 🌿 Drives / Folders: Neon Mint (
#84CC16)
- 🔵 Documents: Electric Cerulean (
- FTS5 In-Content Gradient Badge: Matches found inside the text of documents are highlighted with a glowing emerald-to-teal
[ 📄 Text Match ]gradient badge. - Clean Breadcrumb Hierarchy: Redundant filenames are stripped from paths, rendering clean chevron breadcrumbs (
~ › Documents › Projects).
5. Context-Aware 44px Action Footer
- Idle State: Displays passive keyboard navigation cues (
Navigate ↑↓,Dismiss Esc,Preferences Ctrl+,). - Selected State: Automatically cross-fades to actionable verbs (
Open ↵,Copy Path Ctrl+C,Copy File Ctrl+Shift+C) the instant an item is highlighted. - First-Item Auto-Select: Search results auto-select the top result on population, allowing instant execution on
Enterwithout touching arrow keys.
🔬 Benchmark DotNet Summary
| Method | Mean | Ratio | Gen 0 / 1k Ops | Allocated / Query |
|---|---|---|---|---|
| Legacy Exact String Match | 1.85 ms | 1.00 | - | 40 B |
| Tokenized Zero-Alloc Loop (v1.5.0) | 3.31 ms | 1.80 | - | 256 B |
| Naive LINQ Search (Pre-v1.5.0) | 6.90 ms | 3.74 | 1429.68 | 12,000,384 B |
🛠️ Verification & Quality Gates
Lumen v1.5.0 was compiled and verified through our automated CI verification pipeline:
- Unit & FTS5 Tests: 50/50 automated test assertions passed.
- Architecture Rules: NetArchTest verified that
Lumen.Sharedmaintains zero UI dependencies. - E2E UI Automation: FlaUI UIA3 automated test suite launched
LumenApp.exe, verified the search canvas, and confirmed graceful shutdown.
📦 Installation & Verification
Windows Package Manager (Winget)
winget install LumenByHXManual Download
Download Lumen_v1.5.0_Setup.exe below.
| File | SHA-256 Checksum |
|---|---|
Lumen_v1.5.0_Setup.exe |
D04490252FD562149EE1ED7E355F9D565DE7F6A4387389E285819FA27B149372 |
Note on Windows SmartScreen: Lumen v1.5.0 is an independent, community-distributed utility without an EV Code Signing Certificate. If Windows SmartScreen displays a warning, click "More Info" → "Run Anyway". You can inspect the VirusTotal clean report below.
- 🔍 VirusTotal Scan Report: VirusTotal
- 🌐 Official Website: tools.archx.ma
How to Compute the Hash Right Now
Open PowerShell at your solution root and run:
(Get-FileHash output\Lumen_v1.5.0_Setup.exe -Algorithm SHA256).Hash