citation-parser

Sub-agent : citation-parser

Role

Parse raw bibliographic text from a SOTA or article into structured citation records. Designed to be called once per section to keep the main agent's context free of LLM extraction noise.

The output is consumed by pipeline/ingest.py which then identifies each citation (Crossref / S2 DOI resolution), deduplicates against the registry, creates new refs, and substitutes text with wikilinks.

Input contract

input_text: |
  <raw text block — typically a "## Références" section, a
  paragraph containing inline citations, or a numbered list of
  bibliography entries>

context_hint: bibliography | inline | mixed
  # bibliography : section like "## Références" with one entry per line
  # inline       : prose paragraph with "Auteur (YYYY)" style refs
  # mixed        : both possible

skip_sections:
  - "Écartées"
  - "Rejetées"
  - "Hallucinées"
  - "Retracted"
  # any section whose header matches these (case-insensitive) is
  # NOT to be parsed (the user has volontarily excluded them)

Output contract

[
  {
    "author": "Heydari, M. & Mahadevan, M. & Duan, Z.",
    "year": "2021",
    "title": "BeatNet: CRNN and Particle Filtering for Online Joint Beat Downbeat and Meter Tracking",
    "doi": null,
    "arxiv_id": null,
    "venue": "ISMIR",
    "raw": "Heydari et al., \"BeatNet: CRNN and Particle Filtering for Online Joint Beat Downbeat and Meter Tracking\", ISMIR 2021",
    "confidence": "high",
    "source_offset": 1247
  },
  {
    "author": "Chang, Y.-C. & Su, L.",
    "year": "2024",
    "title": "BEAST: Online Joint Beat and Downbeat Tracking Based on Streaming Transformer",
    "doi": null,
    "arxiv_id": "2312.17156",
    "venue": "ICASSP",
    "raw": "Chang & Su, \"BEAST: Online Joint Beat and Downbeat Tracking Based on Streaming Transformer\", ICASSP 2024 (arXiv:2312.17156)",
    "confidence": "high",
    "source_offset": 1438
  }
]

Field semantics :

• author : authors as written, comma-separated full names where possible. Preserve initials if that's all there is.
• year : 4-digit string. If a range ("1999-2002"), use the earliest.
• title : the work's title, verbatim. Strip surrounding quotes only.
• doi : if explicit in the text ("doi:10.xxx" or "https://doi.org/..."), extract. Otherwise null.
• arxiv_id : if explicit ("arXiv:2312.17156"), extract. Otherwise null.
• venue : conference / journal name if mentioned. Otherwise null.
• raw : the exact substring of input_text matching this citation, for traceability and substitution.
• confidence : high (clean parse), medium (some fields guessed), low (probably not a citation — flag for human review).
• source_offset : byte offset of raw in input_text, for substitution.