ADRs for mat-vis. Each captures what was decided, why, what was rejected, and what would trigger revisiting.
- 0001 — Storage: JSON + .mtlx in git, Parquet + rowmap as Release assets
- 0002 — Hosting via GitHub Releases; tiered hosting for 8K+
- 0003 — Resolution tiers + category partitioning at 4K+
- 0004 — Lazy local cache as default access mode
- 0005 —
SQL shim in clients— superseded by ADR-0001 - 0006 — Release versioning: client semver + data calver + delta overlays
- 0007 — Substrate move to HF Datasets + tar container, drop per-category partitioning — supersedes 0001/0002/0003
- 0008 — Dataset tree is the source of truth;
release-manifest.jsonis an optional convenience snapshot — partly supersedes 0007 - 0009 — Derive pipeline: HTTP-range streaming, parallel workers, ICC-strip, fail-fast
- 0010 — Sharded derive pipeline via GH Actions matrix — partly supersedes 0009
- 0011 — mat_vis curated + upstream.raw mirror (hybrid index) — partly reshapes 0001's record surface
- 0012 — Per-file substrate on Hugging Face (drop the tar) — partly supersedes 0007, retires 0010's merge-shards path
# NNNN. Title
- Status: Proposed | Accepted | Superseded by NNNN
- Date: YYYY-MM-DD
- Deciders: @handles
## Context
## Decision
## Consequences
## Upgrade triggers