zotero-cite

name	zotero-cite
description	Resolve a thesis citation via Zotero MCP, insert into vault/tese/references.bib if missing, and return the Pandoc @cite-key ready to paste into a chapter. Use when the user says "citar", "cite", "cita", "insere citação", "zotero", or references an author/title while drafting tese/manuscrito/*.md.
user-invocable	true

Bridge Zotero → references.bib → ABNT-validated @cite-key. Never silently overwrite existing entries.

Inputs

One of:

• Author + year: /zotero-cite "Mondzain 2002" or /zotero-cite Pateman 1988
• Zotero item key: /zotero-cite ABCD1234
• Free query: /zotero-cite "contrato sexual visual alegoria feminina"

Pipeline

Step 1 — Locate in Zotero

Use mcp__zotero-mcp__zotero_search_items with the query. If multiple hits, show top 5 with {key, title, authors, year} and ask the user to pick. If zero hits, stop and suggest the user add the item to Zotero first.

Step 2 — Derive cite-key

Read vault/tese/references.bib and check if a BibTeX entry already exists for the chosen item. Match by DOI, ISBN, or title + year + first author.

• Exists → reuse its cite-key. Skip to Step 4.
• Missing → proceed to Step 3.

Cite-key convention for this repo: SURNAME_YEAR_KEYWORD in lowercase, ASCII-only (e.g., mondzain_2002_image, pateman_1988_contract).

Step 3 — Fetch metadata and append to references.bib

mcp__zotero-mcp__zotero_item_metadata(item_key=<key>)

Map to BibTeX:

Zotero field	BibTeX field
itemType=book	@book
itemType=journalArticle	@article
itemType=bookSection	@incollection
itemType=thesis	@phdthesis / @mastersthesis
creators (authors)	author = {SURNAME, Given and ...}
date / issued	year (YYYY)
title	title
publisher	publisher
place	address
DOI	doi
URL	url + urldate (YYYY-MM-DD, today UTC)

Append the new entry to vault/tese/references.bib via Edit. Preserve alphabetical order by cite-key. Do not touch existing entries.

Step 4 — Validate ABNT

Dispatch the abnt-checker subagent with the newly written BibTeX block and the Pandoc-rendered form (run a dry-render snippet through pandoc --citeproc --csl=vault/tese/abnt.csl if available). Collect any warnings.

Step 5 — Return

Emit:

ZOTERO-CITE
  source:   Zotero key <X> → "<Title>" (<Author> <Year>)
  bib:      <cite-key>     [new | reused]
  abnt:     OK | N warning(s) — <summary>
  ready:    @<cite-key>

If abnt status is not OK, show each warning verbatim; do not silently accept.

Rules

• Never overwrite an existing BibTeX entry. If conflict detected, ask the user which to keep.
• If Zotero returns no DOI/URL but the item is online-only, prompt for a URL before writing.
• Always set urldate to today UTC (YYYY-MM-DD) for online sources.
• Titles go inside {...} to preserve capitalization: title = {{ICONOCRACIA: Alegoria Feminina...}}.
• Do not insert the @cite-key into chapter text automatically — the user pastes it where the citation belongs. Return it, don't write it.

When to run

• While drafting any tese/manuscrito/*.md chapter and a new source is mentioned
• After a literature review batch to ingest several items at once (pass a list)
• When chapter-integrity agent flags a missing cite-key