Save uncommitted changes

README.md

@@ -70,6 +70,8 @@ curl -fsSL "${BASE}/LocalFlowPlugins/${CATEGORY}/${PLUGIN}/1.0.0/index.js" -o "$
 | `setAnimationFlag` | `utility` |
 | `extractChaptersXml` | `utility` |
 | `finalizeMedia` | `utility` |
+| `copyToWorkDir` | `utility` |
+| `replaceOriginalFile` | `utility` |
 | `audioSelectorClamping` | `audio` |
 | `backupSourceAudio` | `audio` |
 | `extractSubtitlesAndOcr` | `subtitles` |
@@ -97,7 +99,10 @@ LocalFlowPlugins/
 │   ├── mediaAnalyzerGOP/1.0.0/index.js
 │   ├── setAnimationFlag/1.0.0/index.js
 │   ├── extractChaptersXml/1.0.0/index.js
-│   └── finalizeMedia/1.0.0/index.js
+│   ├── finalizeMedia/1.0.0/index.js
+│   ├── copyToWorkDir/2.0.0/index.js
+│   ├── replaceOriginalFile/1.0.0/index.js
+│   └── replaceOriginalFile/2.0.0/index.js
 ├── audio/
 │   ├── audioSelectorClamping/1.0.0/index.js
 │   └── backupSourceAudio/1.0.0/index.js
@@ -245,7 +250,33 @@ 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
+### 8. `copyToWorkDir` — Copy Source to Work Dir (Progress)
+
+**Category**: `utility` · **Step**: before transcode
+
+Streams the source file to the worker's local `workDir`, verifies the byte count,
+and reports throttled copy progress. It stores the original library path in
+`variables.originalLibraryFile` for `replaceOriginalFile`.
+
+### 9. `replaceOriginalFile` — Replace Original File
+
+**Category**: `utility` · **Step**: after transcode
+
+The `1.0.0` version performs the same verified, atomic replacement as the
+progress version but does not emit transfer progress callbacks or progress logs.
+It is useful when the standard Tdarr replacement behavior is desired without
+additional progress reporting.
+
+### 10. `replaceOriginalFile` — Replace Original File (Progress)
+
+**Category**: `utility` · **Step**: after transcode
+
+Streams the processed file to a temporary file beside the original, verifies its
+size, then atomically replaces the original. An existing original is moved to
+`.partial.old` during the operation and restored if replacement fails. The
+processed work file is deleted after a successful replacement.
+
+### 11. `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