PaperCLI v2.0.2 - Code Architecture & Documentation Improvements
This release delivers important bug fixes and comprehensive documentation updates, ensuring accurate user guidance and improved code reliability across the application.
🐛 Critical Bug Fixes
🖱️ Multiselect UI Correction
• Fixed Toast Message: Corrected multiselect mode toast notification showing incorrect ESC key binding
• Accurate Instructions: Now correctly displays F11 as the exit key for multiselect mode
• User Experience: Eliminates confusion about keyboard shortcuts during multiselect operations
📦 Import Dependencies
• Missing Import Fix: Added missing time import in collection dialog preventing potential runtime errors
• Code Reliability: Ensures all time-dependent functionality in collection management works correctly
• Stability Enhancement: Prevents import errors during collection operations
📚 Comprehensive Documentation Overhaul
📖 README.md Major Update
• Installation Instructions: Updated source installation command to use correct ng.papercli module path
• Keyboard Shortcuts: Updated all keyboard shortcut documentation to match actual implementation
• Command Reference: Added comprehensive subcommand documentation for all available commands
• Configuration Variables: Complete environment variable documentation including new options
• Export Formats: Updated export format documentation with IEEE references and all available options
• Roadmap Cleanup: Removed outdated roadmap items that are no longer relevant
⌨️ Accurate Keyboard Documentation
• ESC vs Ctrl+C: Corrected documentation showing ESC clears input (now correctly shows Ctrl+C)
• Function Keys: Verified all F1-F12 key bindings match actual implementation
• Chat Interface: Updated chat interface shortcuts to reflect current functionality
• Selection Mode: Corrected multiselect exit key documentation (F11, not ESC)
⚙️ Enhanced Configuration Documentation
• Environment Variables: Added missing OPENAI_MAX_TOKENS, OPENAI_TEMPERATURE configuration options
• Theme Support: Documented PAPERCLI_THEME environment variable
• OneDrive Settings: Added PAPERCLI_REMOTE_PATH and PAPERCLI_AUTO_SYNC documentation
• PDF Settings: Enhanced PAPERCLI_PDF_PAGES documentation
📋 Complete Command Documentation
• Add Commands: Detailed subcommands for all paper addition methods (arxiv, dblp, pdf, etc.)
• Edit Commands: Comprehensive edit subcommands with field-specific editing options
• Filter Commands: Complete filter subcommands for all search criteria
• Export Commands: All available export formats with specific command syntax
• Config Commands: Enhanced configuration command documentation with all available options
🔧 Technical Improvements
📁 Code Organization
• Import Management: Proper import organization in collection dialog module
• Dependencies: Ensured all required modules are correctly imported
• Code Reliability: Enhanced error prevention through proper dependency management
📝 Documentation Accuracy
• Implementation Sync: Documentation now accurately reflects actual codebase implementation
• Feature Coverage: All features and commands properly documented with correct syntax
• User Guidance: Clear, accurate instructions for all application functionality
• Module Paths: Corrected installation and running instructions for new architecture
📦 Installation
# Via pipx (recommended)
pipx install git+https://github.com/SXKDZ/papercli.git@v2.0.2
# Via pip
pip install git+https://github.com/SXKDZ/papercli.git@v2.0.2
# Update existing installation
pipx reinstall git+https://github.com/SXKDZ/papercli.git@v2.0.2📈 Development Impact
This maintenance release delivers:
• Critical UI Fix: Corrected multiselect mode user guidance
• Import Reliability: Fixed missing dependencies preventing runtime errors
• Documentation Accuracy: Major README.md overhaul ensuring all documentation matches implementation
• User Experience: Improved user guidance through accurate keyboard shortcut and command documentation
• Configuration Coverage: Complete environment variable documentation for all available options
• Installation Instructions: Updated for new ng/ architecture with correct module paths
Full Changelog: v2.0.1...v2.0.2