Skip to content

chore(eddy): fix code-review findings — workflow split, et al. truncation#3

Merged
heznpc merged 1 commit into
mainfrom
chore/review-fixes-2026-05-21
May 28, 2026
Merged

chore(eddy): fix code-review findings — workflow split, et al. truncation#3
heznpc merged 1 commit into
mainfrom
chore/review-fixes-2026-05-21

Conversation

@heznpc
Copy link
Copy Markdown
Owner

@heznpc heznpc commented May 28, 2026

Addresses all 8 findings from /code-review on PR #2.

Fixes

# Finding Fix
1 Path-filter blocks non-paper PRs from merging Drop pull_request paths filter on build-pdf.yml
2 faraone2021 / cortese2025 render all 80+/22 authors → 9-page PDF Use BibTeX `and others` idiom for et al. truncation
3 Mixed UTF-8 / LaTeX-escape diacritics Resolved as side effect of #2
4 Job-level contents:write too broad Split into `build` and `publish-pdf` jobs; SLSA stays in build
5 Zenodo legacy schema uncertainty Verified against current vocabulary API → no change needed
6 gitleaks pull_request lacks branches filter Add `branches: [main]`
7 CITATION.cff type article for Zenodo preprint Change to `type: preprint` + `repository` + `institution`
8 .gitignore missing biber artifacts Add `.bcf` and `.run.xml`

Operational note

Branch protection's required check renamed from
`Compile and (on main push) publish PDF` → `build` via `gh api` before
this PR was opened. The new `publish-pdf` job (which auto-commits the
PDF) is not gated — it runs on push to main only and is downstream of
`build`.

Test plan

  • PR triggers build workflow (no paths filter)
  • `build` job reports as required check
  • Bibliography renders Faraone/Cortese with `et al.` (PDF page count drops)
  • On merge: publish-pdf job runs and auto-commits the rebuilt PDF
  • SLSA attestation attached on push to main
  • gitleaks runs and passes

…tion

Addresses all 8 findings from /code-review on PR #2.

[CONFIRMED, HIGH]
1. build-pdf.yml: drop pull_request paths filter so the required status
   check fires on every PR (not only paper/** PRs). Avoids future
   non-paper PRs being blocked by missing required check.

2. paper/main.bib: replace full author lists in faraone2021 and
   cortese2025 with `and others` (BibTeX `et al.` idiom honored by
   ACM-Reference-Format). Restores the truncation the original inline
   thebibliography had, prevents 8-page sigconf limit overrun for
   ASSETS 2026.

[PLAUSIBLE]
3. UTF-8 / LaTeX-escape mix in main.bib resolved as side effect of
   fix #2 — the only previous UTF-8 entries (Bölte, Søren, César,
   Døpfner, etc.) lived inside faraone2021's expanded author list,
   which is now `and others`. Remaining diacritic `Dah{\`o}` is the
   sole LaTeX-escape entry; consistent.

4. build-pdf.yml: split into two jobs. `build` (contents:read +
   attestations:write + id-token:write) runs on all triggers. New
   `publish-pdf` job (needs: build, contents:write) gated to push to
   main does the auto-commit. SLSA attestation stays in `build`.
   contents:write no longer leaks into compile/attest/upload steps.

5. .zenodo.json: verified against current Zenodo InvenioRDM vocabulary
   (https://zenodo.org/api/vocabularies/resourcetypes). Legacy field
   `publication_type: workingpaper` maps to canonical
   `publication-workingpaper`. No code change required — finding
   downgraded to verified-correct.

6. gitleaks.yml: add `branches: [main]` to the pull_request trigger so
   it is symmetric with the push trigger. Prevents double-scanning if
   feature branches with their own PR cycles appear later.

7. CITATION.cff: change preferred-citation.type from `article` to
   `preprint`; add `repository` and `institution.name: Zenodo`.
   Citation managers (Zotero/Mendeley) now classify correctly.

8. .gitignore: add `*.bcf` and `*.run.xml` for biber/biblatex
   artifacts. Covers a future migration without leaking aux files.

Branch-protection note: required check context renamed from
`Compile and (on main push) publish PDF` → `build` (updated via
gh api before this PR was opened).
@heznpc heznpc merged commit 78785ab into main May 28, 2026
3 checks passed
@heznpc heznpc deleted the chore/review-fixes-2026-05-21 branch May 28, 2026 23:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant