AGENTS.md@.github/actions/setup-acceptance-documents git:20261031.a87934eA

Immutable. This exact content never changes and is served at /api/v1/blob/9eb5673b80b4f1bc.

# setup-acceptance-documents contract

This composite action only orchestrates preparation of official document prerequisites.
Do not call it on a shared workstation. It uses fresh `RUNNER_TEMP` storage
and the disposable hosted runner's user font/tool directories. Third-party
archives and model blobs must retain their exact source-pinned hashes and lengths.

The model action binds an unoccupied loopback port, disables cloud operations
and implicit model acquisition, and records its owned daemon PID and birth.
Every caller of that action must perform identity-checked process-group cleanup
in an `always()` step. No shared service may be stopped or replaced.

`mode` defaults to `native`. Validate exactly `native` or `converter` before
cache restoration, download or setup. Pandoc/crossref verification is
unconditional; native package and JuliaMono preparation are conditioned only on
that validated output. Genuine acceptance callers use native preparation;
routine infrastructure smoke selects converter and separately prepares its
declared readers and TeX. Ordinary project cells explicitly select native for EDA and
converter elsewhere, according to their actual source-declared tests.

Cache only official archives, with OS, architecture, validated mode and source
identity in the key. Validate exact length and SHA-256 again before every use;
cached data cannot supply test outcomes or acceptance.

Run `actionlint` after edits and retain genuine failed preparation diagnostics.
See [README.md](README.md) for usage.

Linux callers in either mode, and all native callers, must first prepare their selected locked Python environment.
`python-executable` defaults to `.venv/bin/python`; common acceptance explicitly
selects its prepared `output/runtime-envs/3.14/bin/python`. The helper's
`--prepared-python PATH` mode preserves that environment, checks actual CPython
support, and runs the unchanged LaTeX package validator with it. It performs no
Python bootstrap, dependency sync or implicit reconciliation. Missing runtime,
native tools, packages or failed validation remain failures. Linux native
preparation explicitly includes `texlive-plain-generic` for the actual `soul.sty`
provider. After platform package preparation, require successful `kpsewhich
soul.sty` resolution and an actual provider file; retain its path and SHA-256.
A package inventory or cached archive cannot replace that runtime lookup.

The Linux mirror guard uses the action-owned `ubuntu_apt_mirrors.py` policy.
Admit only its exact three-row ASCII serialization: Azure or a reviewed standard
commercial EC2 regional Ubuntu host, followed by the fixed HTTPS archive and
security fallbacks. The finite region set is source reviewed; unknown regions,
URLs, paths, whitespace, extra rows and priority arrangements are refused. Allow
only original or already preferred archive/primary priorities and derive the
maximum read size from those accepted byte forms. Do not infer a hosted file's
complete bytes or hash from its size or selected hostname.

Require root-owned, non-symlink regular files and an active signed Ubuntu Noble
stanza using that mirror list; retain bounded before/after logs. Replace only the
known mirror file atomically, preserving owner and mode. Keep all three URLs,
fallbacks, repository signatures, keyrings, packages and execution limits
unchanged. Refuse unknown or changing files/stanzas; do not rewrite other APT
configuration. Run permanent byte-policy tests without host APT access and use a
separate disposable Linux root-file control for filesystem behavior.