Skip to content

research: add reproducible LaTeX and arXiv package for pilot v1 - #162

Merged
ErenAri merged 9 commits into
mainfrom
research/preprint-v1-latex
Sep 19, 2026
Merged

ErenAri merged 9 commits into
mainfrom
research/preprint-v1-latex

Conversation

@ErenAri

@ErenAri ErenAri commented Sep 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Add a reproducible LaTeX/PDF and arXiv-source packaging path for the already
finalized pilot-v1 preprint.

Added

  • docs/paper/latex/main.tex
    • arXiv-oriented pdfLaTeX source;
    • embedded bibliography, so no BibTeX/Biber dependency is required;
    • exact Version DOI 10.5281/zenodo.22848155;
    • evidence-bounded RQ1–RQ4 results and threats-to-validity language.
  • docs/paper/latex/build.sh
    • verifies the frozen SHA-256 of all three pilot-v1 SVG figures;
    • creates conversion-only SVG compatibility copies for Ubuntu/Inkscape 1.2
      without mutating the frozen source SVGs;
    • requires all 70 Figure-3 matrix-cell <use> instances to survive
      normalization;
    • converts the exact frozen figures to PDF;
    • compiles the paper twice with pdfLaTeX;
    • rejects unresolved references/citations and overfull boxes;
    • emits a minimal arXiv source tarball and SHA-256 manifest.
  • .github/workflows/preprint-v1.yml
    • independently builds the PDF and arXiv bundle on GitHub Actions;
    • uploads the review PDF, source tarball, and checksum file as a temporary
      workflow artifact.
  • docs/paper/latex/README.md
    • local build, SVG-conversion compatibility, and evidence-boundary docs.
  • docs/paper/latex/ARXIV.md
    • proposed arXiv metadata and submission checklist.
  • docs/paper/SUBMISSION.md
    • updated to reflect completed LaTeX conversion and frozen-figure binding.

CI validation

Final head: 1676088b9d98ebb2d7aeba15d669c3593d1ba29f

The dedicated preprint-v1 workflow passed on run 35462556205.
The exact CI artifact was downloaded and independently inspected.

  • PDF: 8 pages
  • figures: 3
  • Figure 3: all compatibility-matrix cells render correctly
  • no clipping observed in rendered page inspection
  • no unresolved references/citations
  • no overfull boxes
  • exact pilot-v1 Version DOI present

Final CI output SHA-256:

  • PDF bpfcompat-preprint-v1.pdf:
    921363245ea69e2c95243f8381f08692ab35f88da6be424651f47207ccfdfaba
  • arXiv source bpfcompat-arxiv-v1.tar.gz:
    fd2d6ba5e93b3b58d9b650439e22e2cd9c692ced57aace04f0c5184197fbfc05

The source tarball contains only:

  • main.tex
  • figures/figure-1.pdf
  • figures/figure-2.pdf
  • figures/figure-3.pdf

Conversion issue found and fixed

The first exact CI PDF exposed an Ubuntu 24.04 / Inkscape 1.2 compatibility
issue: SVG2 <use href="#..."> matrix cells in frozen Figure 3 were omitted
during PDF conversion. The frozen SVG itself was correct.

The build now hash-verifies the frozen SVG and applies an equivalent
conversion-only xlink:href normalization before Inkscape. The source evidence
is untouched. The corrected CI PDF was rendered again and visually verified.

Frozen evidence boundary

This PR does not modify:

  • research/**
  • research-v1 tag/release
  • Zenodo dataset files
  • archive lock or canonical analysis

The exact dataset citation remains 10.5281/zenodo.22848155.

Checks

  • preprint-v1 ✅
  • ci ✅
  • CodeQL ✅
  • docs-consistency ✅
  • experimental-freeze ✅
  • bpfcompat-example-hosted ✅
  • CodeRabbit ✅
  • unresolved review threads: 0

Copilot AI lite review requested due to automatic review settings September 19, 2026 18:44

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@coderabbitai

coderabbitai Bot commented Sep 19, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 28 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 5c67d09c-95b4-4527-9dda-c807f27c057c

📥 Commits

Reviewing files that changed from the base of the PR and between 5dd3e69 and 1676088.

📒 Files selected for processing (6)
  • .github/workflows/preprint-v1.yml
  • docs/paper/SUBMISSION.md
  • docs/paper/latex/ARXIV.md
  • docs/paper/latex/README.md
  • docs/paper/latex/build.sh
  • docs/paper/latex/main.tex

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ErenAri
ErenAri merged commit c029596 into main Sep 19, 2026
13 checks passed
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.

2 participants