feat: major CLI enhancements with batch operations, progress indicators, and improved UX

[alienx5499]

Summary

This major release introduces significant enhancements to the tlock CLI tool, including batch encryption/decryption operations, progress indicators, verbose/quiet modes, status checking, and improved user experience. This represents a substantial upgrade from v1.3.0 to v1.4.0.

Rationale

• Users need to process multiple files efficiently with batch operations
• Long-running operations benefit from progress indicators and better feedback
• Enhanced error handling and user experience improves adoption
• Status checking helps users understand when files can be decrypted
• Verbose/quiet modes provide flexibility for different use cases

Changes

New CLI Commands

• --status / -s: Check encryption status and remaining time for files
• --batch-encrypt: Encrypt multiple files in a directory
• --batch-decrypt: Decrypt multiple files in a directory
• --input-dir: Specify input directory for batch operations
• --output-dir: Specify output directory for batch operations
• --pattern: File pattern matching for batch operations (e.g., ".txt", ".tle")

Enhanced User Experience

• --verbose / -v: Enable detailed progress information and logging
• --quiet / -q: Suppress all output except errors
• Progress bars for batch operations showing completion percentage and elapsed time
• Improved error messages with better context
• Enhanced help text with comprehensive usage examples

New Features

• Batch Operations: Process multiple files simultaneously with pattern matching
• Progress Indicators: Visual progress bars and status updates for long operations
• Status Checking: Query encryption status and remaining time for encrypted files
• Enhanced Logging: Structured logging with different verbosity levels
• Better Error Handling: More descriptive error messages and recovery suggestions

Technical Improvements

• Modular command structure with separate files for different operations
• Progress tracking utilities for long-running operations
• Enhanced file pattern matching for batch operations
• Improved validation and error checking
• Better separation of concerns in the codebase

Scope

• CLI tool enhancements (cmd/tle/)
• New command implementations
• Progress tracking utilities
• Enhanced user experience features
• Backward compatible with existing functionality

Testing

• All existing tests pass
• New functionality tested with various file types and patterns
• Batch operations tested with large file sets
• Progress indicators verified for accuracy

Risks

• Low risk - all changes are additive and backward compatible
• New commands are opt-in and don't affect existing workflows
• Enhanced error handling reduces risk of user confusion
• Progress indicators may slightly impact performance but provide better UX

Breaking Changes

• None - all changes are backward compatible

Migration Guide

• No migration required - existing commands work unchanged
• New features are available immediately with updated CLI
• Users can gradually adopt new batch operations and status checking

Performance Impact

• Batch operations are more efficient than individual file processing
• Progress indicators add minimal overhead
• Verbose mode may increase output but doesn't affect core functionality
• Overall performance improvement through better resource utilization

Documentation Updates

• Updated help text with new commands and options
• Enhanced usage examples for batch operations
• Added status checking documentation
• Improved error message descriptions

Example Usage

Batch Encryption

# Encrypt all .txt files in a directory
tle --batch-encrypt --input-dir ./documents --output-dir ./encrypted --pattern "*.txt" -D 1h

# Encrypt with verbose output
tle --batch-encrypt --input-dir ./data --output-dir ./encrypted --pattern "*.pdf" -D 30m -v

Batch Decryption

# Decrypt all .tle files
tle --batch-decrypt --input-dir ./encrypted --output-dir ./decrypted --pattern "*.tle"

# Quiet mode for scripting
tle --batch-decrypt --input-dir ./encrypted --output-dir ./decrypted -q

Status Checking

# Check if a file is ready to decrypt
tle --status encrypted_file.tle

# Check with verbose output
tle --status encrypted_file.tle -v

Enhanced Single File Operations

# Verbose encryption with progress
tle -D 1h -o encrypted.txt input.txt -v

# Quiet mode for automation
tle -d encrypted.txt -o decrypted.txt -q