Carve background green embedded in the foreground (hole handling)

The green in the finger gap survives keying because it is dark and desaturated
(brightness ~0.58, hue-shifted), so chroma confidence reads ~0 and the trimap
leaves it in the unknown band, where ViTMatte fills the pocket as foreground.
It is also connected to the exterior screen (an open notch), so neither
confidence suppression nor classic hole-filling removes it.

Add carve_background_holes (doc section 10): a pixel that is clearly
green-dominant in the input *and* mostly surrounded by genuine (non-green)
foreground is set to alpha 0. The surround cue separates such an intrusion
(finger gaps, inter-strand pockets) from the outer hair edge, which has
background on one side and is preserved. Runs after alpha cleanup.

On TestImage the finger-gap survivors (green & alpha>0.5) drop 170 -> 28 with
no visible loss of hair wisps; inter-strand green pockets clear too. Knobs in
AlphaPostSettings (hole_*, default on, surround_min 0.4).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

bgfilter/settings.py

@@ -39,6 +39,14 @@ class AlphaPostSettings:
     chroma_suppress_bg_low: float = 0.35
     chroma_suppress_bg_high: float = 0.80
     chroma_suppress_strength: float = 1.0
+    # Background-hole carving (doc section 10): remove green-dominant pixels that
+    # are embedded in the foreground (finger gaps, inter-strand pockets) where the
+    # green is too dark for the chroma confidence to flag.
+    hole_carve: bool = True
+    hole_green_dominance: float = 0.10
+    hole_fg_alpha: float = 0.5
+    hole_surround_radius_ratio: float = 0.012
+    hole_surround_min: float = 0.4
 
 
 @dataclass(frozen=True)