refactor: code review cleanup and test suite improvements

- Restructure test suite with class-based organization and clearer docstrings explaining test strategy and mock design decisions

- Fix DummyResponse mock to properly support streaming responses (raw attribute) matching real requests.Response behavior

- Improve mock_responses router with explicit URL matching and clear fallthrough-to-404 semantics

- Consolidate shared fixtures in conftest.py with descriptive comments on each fixture purpose

- Clean up exception hierarchy and CLI interface

- Update documentation and metadata for consistency

Author: HzaCode

.zenodo.json

@@ -1,6 +1,6 @@
 {
-  "title": "OneCite: Universal Citation Management and Academic Reference Toolkit",
-  "description": "OneCite is a powerful command-line tool and Python library designed to automate the tedious process of citation management. It supports multiple input formats (DOI, arXiv ID, PMID, paper titles, etc.) and generates clean, accurate bibliographic entries in BibTeX, APA, or MLA format.",
+  "title": "OneCite: Citation Management and Academic Reference Toolkit",
+  "description": "OneCite is a command-line tool and Python library that automates citation management. It supports multiple input formats (DOI, arXiv ID, PMID, paper titles, etc.) and generates clean, accurate bibliographic entries in BibTeX, APA, or MLA format.",
   "creators": [
     {
       "name": "He, Zhiang",

CHANGELOG.md

@@ -7,41 +7,39 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 ## [Unreleased]
 
 ### Added
-- Comprehensive RST documentation using Sphinx
+- RST documentation using Sphinx
 - Full API reference documentation
 - FAQ section with common questions
 - Contributing guidelines
-- MCP (Model Context Protocol) integration documentation
 - Pre-commit hooks configuration
 
 ### Changed
-- Improved error handling and exception hierarchy
-- Enhanced Python API with better type hints
-- Updated README with more examples
+- Refactored exception hierarchy
+- Added type hints to Python API
+- Updated README examples
 
 ### Fixed
-- Various bug fixes in data source integration
+- CrossRef and Semantic Scholar response parsing edge cases
 
 ## [0.0.11] - 2024-10-19
 
 ### Added
-- MCP server support for AI assistant integration
 - Custom YAML-based template system
 - Support for multiple output formats (BibTeX, APA, MLA)
 - Interactive mode for ambiguous reference selection
 - Support for DOI, arXiv, PMID, ISBN, and GitHub identifiers
 - Integration with 9 major academic data sources
-- Comprehensive test suite
+- Test suite
 
 ### Changed
 - Refactored core processing pipeline
-- Improved data source prioritization
-- Enhanced error messages
+- Reordered data source priority (CrossRef first for DOI queries)
+- Clearer error messages on failed lookups
 
 ### Fixed
-- Fixed encoding issues with special characters
-- Improved robustness of DOI parsing
-- Fixed compatibility with older Python versions
+- Encoding issues with non-ASCII characters in author names
+- DOI parsing for URLs with trailing query strings
+- Python 3.10 compatibility issues
 
 ## [0.0.10] - 2024-10-01
 
@@ -51,10 +49,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 - Support for journal articles and conference papers
 
 ### Changed
-- Improved search accuracy
+- Better title matching for fuzzy searches
 
 ### Fixed
-- Fixed several data source API issues
+- PubMed API response handling
+- Semantic Scholar rate limit handling
 
 ## [0.0.9] and Earlier
 

CITATION.cff

@@ -1,14 +1,14 @@
 cff-version: 1.2.0
 message: "If you use this software, please cite it as below."
 type: software
-title: "OneCite: Universal Citation Management and Academic Reference Toolkit"
+title: "OneCite: Citation Management and Academic Reference Toolkit"
 authors:
   - family-names: "He"
     given-names: "Zhiang"
     email: "ang@hezhiang.com"
 repository-code: "https://github.com/HzaCode/OneCite"
 url: "https://github.com/HzaCode/OneCite"
-abstract: "OneCite is a powerful command-line tool and Python library designed to automate the tedious process of citation management. It supports multiple input formats (DOI, arXiv ID, PMID, paper titles, etc.) and generates clean, accurate bibliographic entries in BibTeX, APA, or MLA format."
+abstract: "OneCite is a command-line tool and Python library that automates citation management. It supports multiple input formats (DOI, arXiv ID, PMID, paper titles, etc.) and generates clean, accurate bibliographic entries in BibTeX, APA, or MLA format."
 keywords:
   - citation
   - bibliography