docs/paper: arXiv submission build script + .gitignore tarball

Author: WaylandYang

.gitignore

@@ -24,6 +24,7 @@ htmlcov/
 *.synctex.gz
 *.toc
 docs/paper/main.pdf
+docs/paper/dcp-arxiv-*.tar.gz
 
 # Local MCP / Claude Desktop configs (user-specific paths and ports)
 .mcp.json

docs/paper/README.md

@@ -26,6 +26,27 @@ pdflatex main
 
 Output: `main.pdf`.
 
+## Submit to arXiv
+
+```powershell
+# Builds figures + paper + arXiv-ready tarball
+.\build-arxiv.ps1
+```
+
+Outputs `dcp-arxiv-vX.Y.Z.tar.gz` (~80 KB). Upload it at
+[arxiv.org/submit](https://arxiv.org/submit):
+
+- **Primary category:** `cs.NI` (Networking and Internet Architecture)
+- **Secondary (optional):** `cs.DC` (Distributed Computing) and/or `cs.LG`
+- **License:** arXiv non-exclusive license
+- **Title:** match the LaTeX `\title{}`
+- **Abstract:** copy from LaTeX `\begin{abstract}`
+
+arXiv will run pdflatex itself; the tarball already includes the precompiled
+`main.bbl` so the bibliography resolves on first pass.
+
+The tarball is `.gitignored` — regenerate before each upload.
+
 ## Before submitting to arXiv
 
 1. **Authors.** Replace `deeplethe` and the placeholder email. arXiv lets

docs/paper/build-arxiv.ps1

@@ -0,0 +1,58 @@
+# Build an arXiv-ready tarball of the DCP paper.
+#
+# Usage:
+#   cd docs/paper
+#   .\build-arxiv.ps1
+#
+# Output: docs/paper/dcp-arxiv-v0.X.tar.gz
+#
+# Bumps the version by reading the project version from pyproject.toml.
+
+$ErrorActionPreference = "Stop"
+$paperDir = $PSScriptRoot
+Set-Location $paperDir
+
+# Pull version from pyproject.toml for the filename.
+$pyproject = Get-Content "..\..\pyproject.toml" -Raw
+$version = if ($pyproject -match '(?m)^version\s*=\s*"([^"]+)"') { $matches[1] } else { "dev" }
+
+Write-Output "=== regenerating figures ==="
+python figures\make_figures.py
+
+Write-Output "`n=== rebuilding paper (latexmk pdflatex bibtex pdflatex pdflatex) ==="
+latexmk -pdf -interaction=nonstopmode main.tex | Out-Null
+
+if (-not (Test-Path "main.pdf")) {
+    Write-Error "main.pdf not produced; check main.log"
+    exit 1
+}
+if (-not (Test-Path "main.bbl")) {
+    Write-Error "main.bbl not produced; bibtex did not run"
+    exit 1
+}
+
+$stage = Join-Path $env:TEMP "dcp-arxiv-staging"
+if (Test-Path $stage) { Remove-Item -Recurse -Force $stage }
+New-Item -ItemType Directory -Path $stage | Out-Null
+New-Item -ItemType Directory -Path "$stage\figures" | Out-Null
+
+Copy-Item main.tex $stage
+Copy-Item refs.bib $stage
+Copy-Item main.bbl $stage
+Copy-Item figures\*.pdf "$stage\figures\"
+
+$out = Join-Path $paperDir "dcp-arxiv-v$version.tar.gz"
+if (Test-Path $out) { Remove-Item $out }
+tar -czf $out -C $stage .
+
+$size = [math]::Round((Get-Item $out).Length / 1KB, 1)
+Write-Output "`n=== done ==="
+Write-Output "  $out  ($size KB)"
+Write-Output "  contains: main.tex, refs.bib, main.bbl, 5 figures"
+Write-Output ""
+Write-Output "Upload to arXiv:"
+Write-Output "  1. arxiv.org -> Submit"
+Write-Output "  2. Primary category: cs.NI  (or cs.DC for distributed/systems)"
+Write-Output "  3. Cross-list: cs.LG (machine learning) optional"
+Write-Output "  4. License: arXiv non-exclusive"
+Write-Output "  5. Upload the tar.gz above; arXiv builds latex itself"