Crossref export: emit hasPreprint relation from related-article preprint entries

[Copilot]

XMLProgramRelatedItemPipe only emitted isTranslationOf / hasTranslation relations, so a JATS <related-article related-article-type="preprint" .../> was dropped from the xmlcrossref deposit and the preprint link was never registered with Crossref (e.g. http://doi.org/10.1590/0102-469854644).

O que esse PR faz?

Estende XMLProgramRelatedItemPipe._transform_original (em articlemeta/export_crossref.py) para emitir, no program do journal_article principal, um <intra_work_relation relationship-type="hasPreprint" identifier-type="doi"> para cada entrada de v241 cujo t == 'preprint'. SciELO armazena <related-article> em v241 com subcampos i (href/DOI), t (related-article-type) e n (ext-link-type); apenas entradas com n == 'doi' (ou ausente) são emitidas, pois hasPreprint exige DOI.

• Pipe alterado: novo helper _get_preprint_relations(raw) que filtra raw.data['article']['v241']; _transform_original itera o resultado e adiciona um related_item por preprint, depois das traduções.
• Escopo do relacionamento: emitido apenas no journal_article principal (DOI canônico). As traduções já apontam para ele via hasTranslation, então o vínculo com o preprint fica ancorado na obra original.
• Testes: três casos novos em tests/test_export_crossref.py cobrindo (1) emissão correta no artigo principal e ausência nas traduções, (2) ausência de v241, (3) related-article-type diferente de preprint.

Trecho do XML resultante:

<program xmlns="http://www.crossref.org/relations.xsd">
  ...
  <related_item>
    <intra_work_relation relationship-type="hasPreprint" identifier-type="doi">10.1590/SciELOPreprints.9348</intra_work_relation>
  </related_item>
</program>

Onde a revisão poderia começar?

articlemeta/export_crossref.py — XMLProgramRelatedItemPipe._get_preprint_relations e _transform_original.

Como este poderia ser testado manualmente?

1. Selecionar um artigo cujo XML JATS contenha <related-article ext-link-type="doi" related-article-type="preprint" xlink:href="..."/> (ex.: PID S0102-46982024000100100, DOI 10.1590/0102-469854644).
2. Garantir que o registro carregado no articleMeta tenha article.v241 populado (subcampos i, t=preprint, n=doi).
3. Gerar a saída no formato xmlcrossref e verificar a presença, no journal_article principal, de <program><related_item><intra_work_relation relationship-type="hasPreprint" identifier-type="doi">…</intra_work_relation></related_item></program> apontando para o DOI do preprint.
4. Rodar os testes alvo: pytest tests/test_export_crossref.py -k "related_item or preprint".

Algum cenário de contexto que queira dar?

A relação hasPreprint é o mecanismo do Crossref para vincular o artigo final ao preprint correspondente (visível em relation na API do Crossref). Hoje esse vínculo se perde no depósito, embora esteja correto no XML do artigo. A mudança não afeta o depósito de relações de tradução já existentes.

Screenshots

N/A — alteração apenas no XML gerado.

Referências

• Crossref – Relationships: https://www.crossref.org/documentation/schema-library/markup-guide-metadata-segments/relationships/
• Mapeamento v241 ↔ <related-article> em scieloorg/prodtools (prodtools/db/xc_models.py).

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• articlemeta.scielo.org
  • Triggering command: /usr/bin/curl curl -s REDACTED (dns block)
  • Triggering command: /usr/bin/curl curl -s REDACTED -o /tmp/sample.json -w %{http_code}\n _TOKEN"; }; f (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)