Adding grading sweep and autokeying

README.md

@@ -111,6 +111,29 @@ gnommo -p myproject import
 
 ---
 
+### Stage 3: Grading
+
+Iterate on keying/grading without running a full preprocess. It seeks a few
+seconds into a raw clip, runs it through the `talkinghead` filter chain, and
+writes `grade_preview.mov` (ProRes 4444 with alpha) to the project root.
+
+# 1. KEY — auto, objective. Generates a candidate + preview, applies on pick.
+gnommo -p video3 grade --stage key
+open video3/grade_sweep/key_1.png        # sanity-check the matte
+gnommo -p video3 grade --pick key_1      # writes it to project.json
+
+# 2. DESPILL — sweep, YOU pick. 7 stills, spill_suppress 0.7–1.5.
+gnommo -p video3 grade --stage despill
+open video3/grade_sweep/                  # eyeball despill_1..7.png
+gnommo -p video3 grade --pick despill_5   # apply whichever looks clean
+
+# 3. GRADE — sweep, YOU pick. 6 stills, paleness 0.0–1.0.
+gnommo -p video3 grade --stage grade
+open video3/grade_sweep/                   # eyeball grade_1..6.png
+gnommo -p video3 grade --pick grade_3      # apply the paleness you like
+
+
+
 ### Stage 3: Preprocess
 
 Applies video filters (chroma key, scaling, etc.) to narration segments.
@@ -167,11 +190,7 @@ some blue, saturated yellow fabric reflects almost none. `yellow_protect`
 (yellow) while leaving skin/scalp spill fully suppressed. Bump it toward `1.0`
 if warm colours go orange; leave at `0` if you have no strong yellows.
 
-#### Grade preview (`grade`)
 
-Iterate on keying/grading without running a full preprocess. It seeks a few
-seconds into a raw clip, runs it through the `talkinghead` filter chain, and
-writes `grade_preview.mov` (ProRes 4444 with alpha) to the project root.
 
 ```bash
 gnommo -p myproject grade                      # first raw_mov clip, 3s from 5s in