# Layout

Every file lives at **`<subject>/<kind>/…`**. Both artifact servers use the same tree;
`artifacts.klt.pw` is public, `private-artifacts.klt.pw` is LAN/Tailscale only.

| Level | Axis | Values |
|---|---|---|
| 1 | **subject**: what it's about | `calliope` · `fantasy` · `history` · `home` · `llm` · `music` · `newsletter` · `podcast` · `redlib` (new subjects are fine; one lowercase word or kebab-case noun) |
| 2 | **kind**: what sort of artifact | `builds` · `diagnostics` · `docs` · `media` · `pages` · `reports` (only these) |
| 3 | depends on kind | `reports/<series>/` · `diagnostics/<crashes\|incidents>/` · `media/<YYYY-MM>/` · `docs/` and `pages/` and `builds/` hold files directly |

- **reports**: recurring, machine-generated output, one folder per series (`fantasy/reports/sleeper/`, `fantasy/reports/yahoo/`, `history/reports/daily/`).
- **pages**: standalone pages a program publishes or regenerates in place (`fantasy/pages/yahoo-draft-board-2026.html`, Calliope's published pages).
- **docs**: one-off write-ups: designs, specs, test reports, punchlists. A doc's own images/videos go in a folder named after it (`docs/ux-consult-2026-09-14.html` + `docs/ux-consult-2026-09-14/`). Prefer a `-YYYY-MM-DD` suffix.
- **media**: loose screenshots/recordings, by month.
- **builds**: installable binaries (APKs). **diagnostics**: crash reports and incident bundles.
- The root holds only subject folders (plus `inbox/` on the private server: unsorted uploads, to be filed later). No loose files.
- Sibling folders always answer the same question, so equal things sit at equal depth.

Old URLs from before 2026-10-19 redirect (301) to their new locations, via nginx-proxy
`vhost/<host>.redirects` (generated by `~/analysis/2026-10-19-artifacts-organization/reorganize.py`).

## Writers

| Writer | Writes to |
|---|---|
| fantasy-daily-advisor (cron; `.env.sleeper` / `.env.yahoo` `PUBLIC_ARTIFACTS_DIR`) | `fantasy/reports/sleeper/`, `fantasy/reports/yahoo/` |
| history-daily `pipeline/config.py` `ARTIFACTS_DIR` | `history/reports/daily/` |
| realtime-android voice-agent `publish_page`, public pages (compose mount `html/calliope/pages`) | `calliope/pages/` |
