- Remove CacheCheckResult and simplify Cache::check_cache to return
Option<OrganizationPlan>
- Replace cache_response_with_metadata with cache_response that takes a
base path; update Gemini client and tests to use new API
- Improve load_or_create error handling and early-return when cache file
missing
- Expand README/docs/INSTALLATION.md with detailed per-OS install and
PATH instructions
- Add PATH argument to command-line options tables
- Add Custom Path Organization section with examples
- Update basic usage examples to include path usage
- Add combined options examples with custom paths
- Add Custom Path Support section to README
- Document path validation, normalization, and use cases
Documentation now fully covers the new custom path functionality
with clear examples and explanations.
Split the 630-line README.md into focused, well-organized documentation:
- README.md: Concise overview with quick start and links
- docs/INSTALLATION.md: Installation instructions and setup
- docs/CONFIGURATION.md: Configuration options and custom categories
- docs/USAGE.md: Command-line options and usage examples
- docs/HOW_IT_WORKS.md: Architecture and internal processes
- docs/TROUBLESHOOTING.md: Common issues and solutions
- docs/DEVELOPMENT.md: Project structure and development guide
- docs/CONTRIBUTING.md: Contribution guidelines and standards
Benefits:
- Main README is now clean and welcoming (~150 lines vs 630)
- Each doc has a clear, focused purpose
- Better navigation with cross-linking between docs
- Follows GitHub best practices with docs/ directory
- Easier to maintain and update specific sections
