Save uncommitted changes

README.md

@@ -69,6 +69,7 @@ curl -fsSL "${BASE}/LocalFlowPlugins/${CATEGORY}/${PLUGIN}/1.0.0/index.js" -o "$
 | `mediaAnalyzerGOP` | `utility` |
 | `setAnimationFlag` | `utility` |
 | `extractChaptersXml` | `utility` |
+| `finalizeMedia` | `utility` |
 | `audioSelectorClamping` | `audio` |
 | `backupSourceAudio` | `audio` |
 | `extractSubtitlesAndOcr` | `subtitles` |
@@ -95,7 +96,8 @@ LocalFlowPlugins/
 ├── utility/
 │   ├── mediaAnalyzerGOP/1.0.0/index.js
 │   ├── setAnimationFlag/1.0.0/index.js
-│   └── extractChaptersXml/1.0.0/index.js
+│   ├── extractChaptersXml/1.0.0/index.js
+│   └── finalizeMedia/1.0.0/index.js
 ├── audio/
 │   ├── audioSelectorClamping/1.0.0/index.js
 │   └── backupSourceAudio/1.0.0/index.js
@@ -206,6 +208,10 @@ OCR failures are logged as **warnings** without stopping the pipeline.
 
 **Output naming**: `<basename>.<lang>[.forced][.default][.sdh].srt`
 
+Text tracks take precedence over bitmap tracks with the same language and flags.
+Two-letter `it`/`en` tags are normalized to `ita`/`eng`; an Italian forced track
+is always marked `default`.
+
 | Input | Default | Description |
 |---|---|---|
 | `subtitleEditPath` | `SubtitleEdit` | Name or full path of SubtitleEdit CLI. Must be in PATH or provide absolute path. |
@@ -219,7 +225,7 @@ OCR failures are logged as **warnings** without stopping the pipeline.
 
 ### 7. `transcode2PassX265` — 2-Pass x265 Transcode
 
-**Category**: `video` · **Step**: last
+**Category**: `video` · **Step**: before `finalizeMedia`
 
 Performs 2-pass libx265 encoding using VBV parameters from `args.variables`.
 
@@ -239,6 +245,13 @@ Performs 2-pass libx265 encoding using VBV parameters from `args.variables`.
 
 **Reads from variables**: `gopKeyint`, `gopMinKeyint`, `gopSceneCut`, `vBitrate`, `vMaxRate`, `vBufSize`, `x265Tune`, `audioHasIta`, `audioItaStreamIndex`, `audioItaOpusBitrate`, `audioHasEng`, `audioEngStreamIndex`, `audioEngOpusBitrate`
 
+### 8. `finalizeMedia` — Finalize Media & Sidecars
+
+Run after `Move To Directory`. It normalizes subtitle language codes, adds
+`.default` to `ita.forced`, removes duplicate `_chapters` sidecars, and removes
+the original source directory only when it is empty. It also canonicalizes
+chapter XML sidecars to `<media>_chapters.xml` and removes duplicate copies.
+
 ---
 
 ## 🔗 Flow Variable Map