Add Citation

Find a paper, create a BibTeX entry, add it to references.bib, and provide the citation syntax.

Arguments

• $ARGUMENTS — a paper description, title, author name, or DOI (e.g., "Acemoglu 2001 colonial origins" or "10.1257/aer.91.5.1369")

Steps

1. Parse the argument to determine if it is a DOI or a descriptive search query.

1. Search for the paper:

• If a DOI is provided, fetch the metadata directly (use web search or CrossRef)
• If a description is provided, search the web to identify the paper and its DOI/metadata

1. Construct a valid BibTeX entry with these fields (at minimum):

• @article{key, (or @book, @incollection, etc. as appropriate)
• author, title, journal (or booktitle), year, volume, number, pages, doi
• Use a citation key in the format: lastname_yearword (e.g., acemoglu2001colonial)

1. Read references.bib and check for duplicate keys:

• If the exact key already exists, inform the user and show the existing entry
• If a similar key exists (same author and year), warn the user

1. Append the new entry to references.bib (add a blank line before the new entry)

1. Show the user the citation syntax for use in index.qmd:

• Narrative: @key → "Author (Year)"
• Parenthetical: [@key] → "(Author, Year)"
• Multiple: [@key1; @key2]

1. Ask if the user wants to create an annotation note in references/ (see /project:literature-note)

Error handling

• If the paper cannot be found, report the search results and ask the user to provide more details or a DOI.
• If references.bib does not exist, create it with the new entry.