git:20260628.5b6cfa0 to git:20260708.fadfd64
6 added, 0 removed. Audit A to A.
# HuggingFace Publishing Adapter
## Purpose
Publishes manuscript and reproducibility bundles to HuggingFace Hub repositories,
usually as datasets for research artifacts.
+ ## Modules
+
+ | Module | Role |
+ | --- | --- |
+ | `models.py` | `HuggingFaceConfig`, `HuggingFaceResult`, `HFRepoType` — frozen config/result dataclasses and the repo-type enum (`model` / `dataset` / `space`); token defaults to `HUGGINGFACE_TOKEN` then `HF_TOKEN`, and `HuggingFaceResult.ok` is `True` when `status == "ok"` |
+
## Contracts
- Keep `dry_run=True` as the safe default.
- Resolve tokens from explicit config first, then `HUGGINGFACE_TOKEN` or
`HF_TOKEN`; never log token values.
- Preserve the raw HTTP path for hermetic tests and dependency-light installs.
- Use the optional `huggingface_hub` client only for real Hub uploads that need
Git-LFS handling.
- Return structured `HuggingFaceResult` values instead of raising on HTTP or
credential failures.
## Verification
```bash
uv run pytest tests/infra_tests/publishing/test_huggingface_adapter.py
```
## Parent Docs
- Publishing module: [`../AGENTS.md`](../AGENTS.md)
- Adapter README: [`README.md`](README.md)