Integrate PDF/UA-1 checks into agent and CI workflows.

1) Single File Check

curl -sS -X POST "https://api.ua1.dev/api/validate?format=compact" \
  -F "file=@document.pdf"

Use this from OpenClaw, Claude Code, Codex, or any agent shell step.

2) CI / Release Gate

# pass only if verdict == "pass"
./skills/ua1-validator-agent/scripts/validate_pdf.sh ./docs/final.pdf
# exit 0 = pass, 2 = fail, 1 = API error

This is the recommended pipeline gate: block release when accessibility fails.

3) Batch Remediation Loop

1. Validate all PDFs in compact mode
2. Group findings by rule_id
3. Fix most frequent rules first
4. Re-validate and compare error deltas

This gives the fastest quality gain for large document sets.

API Contract

• Endpoint: POST /api/validate
• Input: multipart/form-data, field file
• Modes: full and compact (?format=compact)
• Common errors: FILE_TOO_LARGE, UNSUPPORTED_TYPE, RATE_LIMITED
• Headers: X-Request-Id, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset