Roadmap

[djdarcy]

Roadmap

Evergreen tracking issue for dazzlesum development priorities.

Phase 1: Bug Fixes and Stability (current)

• Fix verify --exclude support (verify traversed excluded dirs)
• Fix shadow-dir verify path resolution (100% false "missing" failures)
• Fix Python 3.12+ SyntaxWarnings (raw strings for ASCII art)
• Fix subprocess encoding for non-ASCII filenames (utf-8 + errors='replace')
• Add counting progress feedback and directory exclusion during counting
• Add throughput display (MB/s) to progress bar
• Fix large monolithic files stalling near 99% ([BUG] Large monolithic checksum files stall near 99% completion and monolithic verification is overly squelched #2)

Phase 2: Performance and Caching

• SQLite tree cache for fast startup (feat: SQLite tree cache and incremental hashing for large filesystems #9) -- eliminates 8-hour counting phase on large filesystems
• Implement update_mode (parameter exists but is unimplemented) -- mtime-based change detection
• Persist per-file mtime in .shasum format (enables incremental hashing)
• Activate STATE_FILENAME (.dazzle-state.json) or replace with SQLite
• Optional Dazzle-Locate64 integration for instant tree population (feat: Tree export capability for downstream tools Dazzle-Locate64#5)

Phase 3: Package Modernization

• Refactor 4,359-line monolith into proper PyPI package structure (feat: Refactor monolith into PyPI package with DazzleTreeLib integration #10)
• Add git-repokit-common scripts/ subtree for versioning
• Integrate DazzleTreeLib for tree traversal (4-5x caching speedup, async support)
• Use shared DazzleTools libraries (dazzle-filekit, unctools) instead of internal path handling
• pip install dazzlesum with proper entry points
• Performance benchmarking: DazzleTreeLib vs FIFODirectoryWalker, native tools vs hashlib

Phase 4: Advanced Features

• Daily change detection pipeline (Everything + mtime for local, mtime-only for remote)
• Release integration (version bump + SHA manifest + structural listing)
• Parallel hashing (async file reading with DazzleTreeLib)
• Git LFS-aware checksumming (skip LFS pointer files)
• Cross-platform CI testing

Related projects

• DazzleTreeLib -- universal tree traversal library
• Dazzle-Locate64 -- fast file indexing (Bump actions/checkout from 4 to 5 #5: tree export)
• dazzle-filekit -- shared path handling