# IMPORT-LOG

Append-only ledger of media-import events for ARRFLIX. Each file in this
directory documents a single import operation so future audits can trace
content on disk back to its provenance.

## Convention

- **One file per import event.**
- **Filename format:** `YYYY-MM-DD-<source>-<show-slug>.md`
  - `<source>` is the upstream type (`youtube`, `tvdb-rip`, `bluray`, `manual`, etc.).
  - `<show-slug>` is the lowercase show name with `-` separators.
  - Example: `2026-05-08-youtube-sassy-the-sasquatch.md`.
- **Date** is the day the import landed on the live library (not the day the
  source was published).

## Required sections

Each entry should include:

1. **Source** — upstream URL/handle, channel/distributor, identifiers.
2. **Date imported** — ISO-8601.
3. **Episodes imported** — table mapping source identifier → canonical
   filename → Jellyfin item id (resolution + size where applicable).
4. **Naming rules applied** — citations of the `docs/0X.md` rule numbers
   invoked, with a short note on the specific edit each made.
5. **rsync stats** — `sent / received / speedup` from the transfer.
6. **Jellyfin verification** — series id, episode count, direct-play status.
7. **Known caveats** — anything that wasn't perfect (missing metadata,
   failed thumbnails, age-restricted episodes, etc.).
8. **Source manifest copied** — top-level fields of the operator's
   `manifest.json`. Do **not** embed the full `episodes[]` array — link to
   the canonical files in the live library instead.

## Boundaries

- **No access tokens, API keys, or session cookies** in any log file.
- For YouTube imports, **do not include full video URLs** — record the bare
  `videoId` only, so import logs are not indexable as a re-distribution
  pointer.
- Logs are **immutable once committed**. To correct a mistake, append a
  follow-up entry rather than rewriting history.