Updated Clip Handling Logic (markdown)

Clip-Handling-Logic.md

@@ -0,0 +1,64 @@
+# Clip Handling Logic
+
+This page explains how the LCS Pipeline processes clips — from raw input files to final uploads.
+
+## Overview
+
+Each clip goes through a multi-stage process:
+
+1. **Discovery**: Files are found in `hits/`, `misses/`, `montages/`, or `outtakes/` folders.
+2. **Metadata Extraction**: Reads `notes.json` if available.
+3. **Title Generation**: Auto or manual titles are generated.
+4. **Rendering**: Intro + title + clip + outro stitched together.
+5. **Upload**: Posted to YouTube (and PeerTube if wide format).
+6. **Archival**: Final metadata and URLs are saved.
+
+## Clip Categories
+
+* `hits/`: Notable eliminations.
+* `misses/`: Funny or fail moments.
+* `montages/`: Pre-trimmed highlight reels.
+* `outtakes/`: Manually marked moments.
+
+## Notes File
+
+Each clip folder may include a `notes.json` with optional metadata:
+
+```json
+{
+  "highlight": "Gramps nails a double headshot!",
+  "tags": ["Fortnite", "Double Kill", "Highlights"],
+  "gag_name": "Senior Sniper Supreme"
+}
+```
+
+## Format Rules
+
+* Vertical clips: Filename ends with `-vert` or `-vertical`.
+* Each clip → one output video.
+* Output stored in `rendered/` subfolder of the session.
+
+## Rendering Pipeline
+
+```text
+[ intro ] + [ dynamic title card ] + [ content ] + [ outro ]
+```
+
+## Publishing Rules
+
+* Vertical: Upload to YouTube Shorts playlist.
+* Wide: Upload to both YouTube Clips and PeerTube.
+
+## Automation Notes
+
+* Title overlays use Fortnite fonts/colors.
+* If `notes.json` is missing, OpenAI fallback generates description.
+* Upload returns YouTube URL for archive.
+
+## Dev Tip
+
+Set debug flag in `config.py` to avoid destructive actions during tests.
+
+---
+
+🧠 Managed and documented by ChatGPT, the official LCS Pipeline wiki boss. 😎