papers/README.md

# Arriella arXiv manuscript set

**Directory:** `docs/arxiv/`  
**Purpose:** Publication-ready manuscripts for **arXiv** → **Hugging Face Papers**.  
**Authors:** Beelzebub4888, Tcoder · **Affiliation:** Infinidev Corp  
**Contact:** https://formsubmit.co/el/sumuhu · **Hub user:** [UnaverageTech411](https://huggingface.co/UnaverageTech411)

## What this is (and is not)

| Correct | Incorrect |
|---------|-----------|
| Submit LaTeX/PDF to **arxiv.org** | Upload papers as Hugging Face **Spaces** |
| Index announced IDs on **hf.co/papers/<id>** | Fake **model** repos that only contain markdown |
| Keep Spaces for **runnable demos** only (`Learnit`, etc.) | Treat Spaces as a paper host |

Hugging Face Paper Pages are built on **arXiv**. There is no Hub repo type that replaces arXiv for papers.

## Manuscript index

| ID | Title | Categories | Path |
|----|-------|------------|------|
| 01 | Arriella: A Local Fleet Factory for Role-Scoped Small Language Models | cs.CL, cs.LG | [`01-fleet-factory/`](01-fleet-factory/) |
| 02 | Arriella Grapevine: A Local Omni Multimodal Extension | cs.CV, cs.CL | [`02-grapevine/`](02-grapevine/) |
| 03 | Honest Capability Ingestion (Eat System) | cs.LG, cs.CL | [`03-eat-system/`](03-eat-system/) |
| 04 | Multimodal Routing for Text-Only Fleet Tiers | cs.CL, cs.CV | [`04-multimodal-routing/`](04-multimodal-routing/) |
| 05 | Arriella Fleet Evaluation Report | cs.CL | [`05-evaluation/`](05-evaluation/) |
| 06 | Fleet Internal Reasoning Wire Format | cs.CL | [`06-reasoning-format/`](06-reasoning-format/) |
| 07 | Model Interior Projection (MIP) | cs.HC, cs.LG | [`07-mip/`](07-mip/) |

Each folder: `paper.md`, `abstract.txt`, `metadata.yaml` (add `arxiv_id` / `hf_papers` after acceptance).

Sources merged from `docs/papers/`, `docs/guides/`, `docs/benchmarks/`, and `docs/archive/2026-07/`.

## Workflow

Detailed steps: [`SUBMISSION.md`](SUBMISSION.md)

```powershell
# 1) Build arXiv source zips
.\.venv\Scripts\python.exe scripts\package_arxiv.py

# 2) Upload each zip at https://arxiv.org/submit  (human step)

# 3) After announcement, index on HF Papers
.\.venv\Scripts\python.exe scripts\index_hf_papers.py --arxiv-id YYYY.NNNNN --manuscript 01-fleet-factory
```

Packaged zips land in `docs/arxiv/submission-packages/` (gitignored if large; regenerate anytime).

## Stance rules

- Foundations are clay; Arriella products are factory outputs.
- Same-size open instruct competition only — no frontier parity claims.
- Scout under-recovered; Ascension not automatically smarter than Flagship.
- Grapevine is a multimodal **extension** (no Inkling weights).
- Prefer measured tables over slogans.