commit 6665a6bab206685eb49eb1b2ae3f204f59d7a0f0
parent e61db76c8e9092f84bac8d0c72e9b38e272ee894
Author: I Mean I'm Just Saying <imeanimjustsaying@kiwifarms.st>
Date: Sat, 26 Sep 2026 16:51:24 -0400
docs: AGENTS.md — full: true / "Persist source video" download the source despite a transcript or captions (persist-only when a transcript exists); every metadata.info.json rewrite appends to metadata.history.json
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Diffstat:
1 file changed, 11 insertions(+), 0 deletions(-)
diff --git a/AGENTS.md b/AGENTS.md
@@ -89,6 +89,17 @@ machine with no editor. The editor fetches only for a channel it already archive
`transcripts/channels/<slug>/`), so an MCP pointed at a public site with a fresh editor
gets a 404 `Channel "<slug>" not found` on every clip.
+**`full: true` and "Persist source video" download the source even when a transcript or
+captions exist** (`forceMedia` on `downloadOneManaged`, release 10 slice N; "Persist kept
+now" too). On a youtube-handling channel that pass used to be skipped for any video with a
+transcript — the job ended `done` with no file. With a transcript on disk the forced pass
+moves the container into the saved-video store and does nothing else: no subtitles, no
+`audio.<fmt>`, no transcription. **Every rewrite of `metadata.info.json` appends to
+`metadata.history.json`** beside it (`common/lib/metadataHistory.ts`): the old and new values
+of changed content keys (title, description, …), the counters that moved, and
+formats/thumbnails/caption URLs only by fingerprint; 200 entries, newest last. The video
+page shows it under the description.
+
`umtool/report-to-video/` renders a cited sweep report to an mp4. What it needs:
- **yt-dlp** — clip media is fetched over the network per clip. Local media does not
