s8n
fedf3388b8
Adds processes/ umbrella for repeatable acquisition workflows. First child is subtitles/, with recipe README (executable by Claude Code), CHANGELOG, per-show run logs, and a tested helper at lib/sub-fetch.sh. Run on American Dad: S01 (7 eps) passed, S02-S04 (51 eps) broke. Library uses Hulu/DSP season ordering; OpenSubtitles indexes by Fox airing order; plugin queries by (parent_imdb_id, season, episode) so library S02E01 returns 0 hits. v2 design = direct OpenSubtitles REST with per-episode imdb_id lookup; pending API-key registration.
24 lines
1.1 KiB
Markdown
24 lines
1.1 KiB
Markdown
# processes/ — repeatable acquisition workflows
|
|
|
|
This folder holds the canonical recipes for **acquiring external content** for
|
|
the ARRFLIX library: subtitles, artwork, metadata, episode stills, etc.
|
|
Internal ops (encoding, importing, theming) stay in `bin/` and `docs/`.
|
|
|
|
Each process is its own sub-folder with three files:
|
|
|
|
| File | Purpose |
|
|
|---|---|
|
|
| `README.md` | The canonical recipe. Step-by-step, executable by Claude Code. Always reflects the latest version. |
|
|
| `CHANGELOG.md` | Why the recipe changed, version-by-version. One entry per breakage that forced a revision. |
|
|
| `runs/<show>.md` | Evidence log: what happened when this recipe was applied to a specific show. |
|
|
|
|
Recipes evolve via the **iteration model**: apply to a show, succeed or break,
|
|
amend the recipe to handle the new case + every prior case, retry. A recipe
|
|
that "just works" is one that has survived every show in the library without
|
|
amendment for a full sweep.
|
|
|
|
## Children
|
|
|
|
| Process | Status | Last touched |
|
|
|---|---|---|
|
|
| [`subtitles/`](subtitles/) | v1 — partial pass on American Dad (S01 only); broke on S02 | 2026-05-09 |
|