fix: two-layer scoring (#27/#3), simplify identifier routing + DataCite fallback (#23), clarify template semantics (#16)

Author: Ang

README.md

@@ -69,7 +69,7 @@ OneCite solves this by accepting **any mix of identifiers and text queries** and
 | **Multi-Source Lookup**     | Queries CrossRef, arXiv, PubMed, Semantic Scholar, Google Books, and others for every entry.         |
 | **Many Identifier Types**   | Accepts DOI, PMID, arXiv ID, ISBN, GitHub URL, Zenodo DOI, or plain text queries.                    |
 | 🎛️ **Interactive Mode**    | Manually select the correct entry when multiple potential matches are found.                          |
-| **Custom Templates**        | YAML-based templates to control which fields are collected and how entries are typed.                 |
+| **Custom Templates**        | YAML-based presets that provide a fallback BibTeX entry type when auto-detection is inconclusive.    |
 
 
 ## 🌐 Data Sources

onecite/cli.py

@@ -81,7 +81,7 @@ def create_parser() -> argparse.ArgumentParser:
     process_parser.add_argument(
         '--template',
         default='journal_article_full',
-        help='Template to use (default: journal_article_full)'
+        help='Fallback BibTeX entry-type preset when auto-detection is inconclusive (default: journal_article_full)'
     )
     process_parser.add_argument(
         '--output-format',

onecite/core.py

@@ -55,10 +55,11 @@ class CompletedEntry(TypedDict, total=False):
 
 
 class TemplateLoader:
-    """Loads YAML template files that control citation field collection.
+    """Loads YAML template files that provide fallback BibTeX entry types.
 
-    Templates define which bibliographic fields to collect and how
-    entries are typed (e.g. article, inproceedings).
+    Templates are used when auto-detection cannot determine the entry type
+    from metadata. They specify which entry_type (e.g. @article, @book)
+    to use as a fallback and which fields are expected.
     """
 
     def __init__(self, templates_dir: Optional[str] = None):
@@ -84,7 +85,8 @@ def load_template(self, template_name: str) -> Dict[str, Any]:
 
         Returns:
             A dictionary describing the template with keys ``name``,
-            ``entry_type``, and ``fields``.
+            ``entry_type``, and ``fields``. The template provides a
+            fallback entry type when auto-detection is inconclusive.
         """
         template_path = os.path.join(self.templates_dir, f"{template_name}.yaml")
 
@@ -110,11 +112,11 @@ def _get_default_template(self) -> Dict[str, Any]:
                 {'name': 'title', 'required': True},
                 {'name': 'journal', 'required': True},
                 {'name': 'year', 'required': True},
-                {'name': 'volume', 'required': False, 'source_priority': ['crossref_api', 'user_prompt']},
-                {'name': 'number', 'required': False, 'source_priority': ['crossref_api', 'user_prompt']},
-                {'name': 'pages', 'required': False, 'source_priority': ['crossref_api', 'google_scholar_scraper']},
-                {'name': 'publisher', 'required': False, 'source_priority': ['crossref_api', 'user_prompt']},
-                {'name': 'doi', 'required': False, 'source_priority': ['crossref_api']},
+                {'name': 'volume', 'required': False},
+                {'name': 'number', 'required': False},
+                {'name': 'pages', 'required': False},
+                {'name': 'publisher', 'required': False},
+                {'name': 'doi', 'required': False},
             ]
         }
 

onecite/pipeline.py

@@ -11,28 +11,12 @@ fields:
     required: true
   - name: edition
     required: false
-    source_priority:
-      - crossref_api
-      - google_books_api
-      - user_prompt
   - name: isbn
     required: false
-    source_priority:
-      - crossref_api
-      - google_books_api
   - name: address
     required: false
-    source_priority:
-      - crossref_api
-      - google_books_api
-      - user_prompt
   - name: pages
     required: false
-    source_priority:
-      - crossref_api
-      - google_books_api
   - name: doi
     required: false
-    source_priority:
-      - crossref_api
 

onecite/templates/book.yaml

@@ -11,20 +11,9 @@ fields:
     required: true
   - name: pages
     required: false
-    source_priority:
-      - crossref_api
-      - google_scholar_scraper
   - name: organization
     required: false
-    source_priority:
-      - crossref_api
-      - user_prompt
   - name: publisher
     required: false
-    source_priority:
-      - crossref_api
-      - user_prompt
   - name: doi
     required: false
-    source_priority:
-      - crossref_api

onecite/templates/conference_paper.yaml

@@ -11,20 +11,9 @@ fields:
     required: true
   - name: doi
     required: false
-    source_priority:
-      - zenodo_api
-      - datacite_api
-      - figshare_api
   - name: url
     required: false
-    source_priority:
-      - zenodo_api
-      - figshare_api
-      - datacite_api
   - name: version
     required: false
-    source_priority:
-      - zenodo_api
-      - figshare_api
   - name: note
     required: false

onecite/templates/dataset.yaml

@@ -11,25 +11,11 @@ fields:
     required: true
   - name: volume
     required: false
-    source_priority: 
-      - crossref_api
-      - user_prompt
   - name: number
     required: false
-    source_priority:
-      - crossref_api
-      - user_prompt
   - name: pages
     required: false
-    source_priority:
-      - crossref_api
-      - google_scholar_scraper
   - name: publisher
     required: false
-    source_priority:
-      - crossref_api
-      - user_prompt
   - name: doi
     required: false
-    source_priority:
-      - crossref_api

onecite/templates/journal_article_full.yaml

@@ -11,30 +11,13 @@ fields:
     required: true
   - name: abstract
     required: false
-    source_priority:
-      - crossref_api
-      - pubmed_api
   - name: volume
     required: false
-    source_priority:
-      - crossref_api
-      - user_prompt
   - name: number
     required: false
-    source_priority:
-      - crossref_api
-      - user_prompt
   - name: pages
     required: false
-    source_priority:
-      - crossref_api
-      - google_scholar_scraper
   - name: publisher
     required: false
-    source_priority:
-      - crossref_api
-      - user_prompt
   - name: doi
     required: false
-    source_priority:
-      - crossref_api

onecite/templates/journal_article_with_abstract.yaml

@@ -9,23 +9,11 @@ fields:
     required: true
   - name: version
     required: false
-    source_priority:
-      - github_api
-      - zenodo_api
   - name: url
     required: false
-    source_priority:
-      - github_api
-      - zenodo_api
   - name: doi
     required: false
-    source_priority:
-      - zenodo_api
-      - crossref_api
   - name: publisher
     required: false
-    source_priority:
-      - github_api
-      - zenodo_api
   - name: note
     required: false