color-correction

1# Color Correction (measure, don't eyeball)
2 
3## The core principle
4 
5You cannot reliably judge color from a storyboard or contact sheet. "Is it washed
6out?" flip-flops by eye, especially on AI-gen video. Make color measurable with the
7`get_image (action:"analyze_color")` MCP tool, read the numbers like a colorist reads scopes, pick the
8fix the data points to, then re-measure to confirm. The whole skill is this loop:
9 
10```
11extract a frame ─► get_image (action:"analyze_color") ─► read black/white points + contrast + saturation
12       ▲                                          │
13       │                                          ▼
14   re-measure  ◄──── apply fix (levels / contrast / match) ◄── diagnose from the numbers
15```
16 
17> Origin: on a WAN-Animate render we argued for many turns over whether the clip was
18> "washed out." The instant we measured it, the answer was unambiguous and the *correct*
19> fix (a contrast stretch, not the color-match nodes we'd been adding) fell straight out.
20 
21---
22 
23## The `get_image (action:"analyze_color")` tool
24 
25Read-only. Source = `asset_id`, a ComfyUI output ref (`filename`/`subfolder`/`type`), or
26an image `path` (absolute, or under the output dir). It returns per-image stats, heuristic
27flags, a one-line verdict, and optionally an overlaid R/G/B/luma histogram PNG.
28 
29```
30get_image({ action: "analyze_color", filename: "render_00007_.png" })       # absolute numbers
31…