Add per-event NASA moon images with east-sky cloud veil

Three changes driven by the same goal: make each monthly moon post
look like east captured it at that exact moment.

Tighter illumination windows (±4% of target phase):
  Full moon:   95% → 96–100%  (was a 5-point band; now hugs exact full)
  Quarters:    40–65% → 46–54%  (was a 25-point band; now ±4% of 50%)
This ensures the NASA Dial-a-Moon render timestamp is pulled within
4 percentage points of the true phase, making the fetched image
genuinely represent that night's moon.  One fresh fetch per event,
~3/month, cached by hour — never reused across months.

Atmospheric cloud veil from east's surrounding sky:
  _extract_cloud_veil() samples the annular sky region just outside
  east's moon disk (2×–5× radius), scales it to the output frame,
  blurs heavily (GaussianBlur r≈output_width/10) so it reads as haze
  rather than an upscaled photo, then blends it over the NASA composite
  at an opacity proportional to sky brightness:
    sky < 5% mean brightness → no veil (clear dark night)
    sky ~10%                 → ~17% veil (thin haze / airglow)
    sky ≥ 20%                → 40% veil (max, MOON_CLOUD_OVERLAY_MAX_OPACITY)
  After the veil pass the NASA moon disk is re-pasted sharply so the
  haze sits naturally behind the crisp lunar surface.
  This is the honest answer to "east can't capture high-res clouds":
  east's real atmospheric fingerprint becomes the veil texture.

New sky-cam.conf keys:
  MOON_CLOUD_OVERLAY_ENABLED=true
  MOON_CLOUD_OVERLAY_MAX_OPACITY=0.40
  #MOON_CLOUD_OVERLAY_BLUR=0  (0 = auto)

https://claude.ai/code/session_01HkTxpNSTWtViZzxbrbKytR

moon_phase_monthly.py

@@ -85,13 +85,18 @@ OUT_H = int(CONF.get('MOON_OUTPUT_H', CONF.get('MOON_FULL_OUTPUT_H', 1080)))
 MOON_PCT = float(CONF.get('MOON_HEIGHT_PCT', 0.92))
 REQUIRE_EAST_VERIFY = CONF.get('MOON_REQUIRE_EAST_VERIFY', 'true').lower() != 'false'
 
+CLOUD_OVERLAY_ENABLED = CONF.get('MOON_CLOUD_OVERLAY_ENABLED', 'true').lower() != 'false'
+CLOUD_OVERLAY_MAX_OPACITY = float(CONF.get('MOON_CLOUD_OVERLAY_MAX_OPACITY', 0.40))
+CLOUD_OVERLAY_BLUR = int(CONF.get('MOON_CLOUD_OVERLAY_BLUR', 0))
+
 
 PHASE_SPEC = {
     'full': {
         'index': 2,
         'label': 'Full Moon',
         'emoji': '🌕',
-        'illum_min': float(CONF.get('MOON_FULL_MIN_ILLUMINATION', 0.95)),
+        # ±4% of target (100%): accept 96–100% illumination
+        'illum_min': float(CONF.get('MOON_FULL_MIN_ILLUMINATION', 0.96)),
         'illum_max': 1.01,
         'waxing': None,
         'window_before': int(CONF.get('MOON_FULL_WINDOW_BEFORE_DAYS', 1)),
@@ -103,8 +108,9 @@ PHASE_SPEC = {
         'index': 1,
         'label': 'First Quarter (Waxing Half)',
         'emoji': '🌓',
-        'illum_min': float(CONF.get('MOON_QUARTER_MIN_ILLUMINATION', 0.40)),
-        'illum_max': float(CONF.get('MOON_QUARTER_MAX_ILLUMINATION', 0.65)),
+        # ±4% of target (50%): accept 46–54% illumination, waxing only
+        'illum_min': float(CONF.get('MOON_QUARTER_MIN_ILLUMINATION', 0.46)),
+        'illum_max': float(CONF.get('MOON_QUARTER_MAX_ILLUMINATION', 0.54)),
         'waxing': True,
         'window_before': int(CONF.get('MOON_QUARTER_WINDOW_BEFORE_DAYS', 1)),
         'window_after': int(CONF.get('MOON_QUARTER_WINDOW_AFTER_DAYS', 1)),
@@ -115,8 +121,9 @@ PHASE_SPEC = {
         'index': 3,
         'label': 'Third Quarter (Waning Half)',
         'emoji': '🌗',
-        'illum_min': float(CONF.get('MOON_QUARTER_MIN_ILLUMINATION', 0.40)),
-        'illum_max': float(CONF.get('MOON_QUARTER_MAX_ILLUMINATION', 0.65)),
+        # ±4% of target (50%): accept 46–54% illumination, waning only
+        'illum_min': float(CONF.get('MOON_QUARTER_MIN_ILLUMINATION', 0.46)),
+        'illum_max': float(CONF.get('MOON_QUARTER_MAX_ILLUMINATION', 0.54)),
         'waxing': False,
         'window_before': int(CONF.get('MOON_QUARTER_WINDOW_BEFORE_DAYS', 1)),
         'window_after': int(CONF.get('MOON_QUARTER_WINDOW_AFTER_DAYS', 1)),
@@ -325,11 +332,14 @@ def run_phase(phase: str, target_utc: datetime | None, cam: str,
         cam, dry_run, no_upload, out_path,
         witness_text=f'witnessed at {local_dt.strftime("%Y-%m-%d %H:%M:%S %Z")} '
                      f'({delta_min:+.0f} min from exact {phase})',
+        east_frame_path=path,
+        east_detection=det,
     )
 
 
 def _render_and_post(phase, spec, target_utc, when_utc, local_dt, cam,
-                     dry_run, no_upload, out_path, witness_text):
+                     dry_run, no_upload, out_path, witness_text,
+                     east_frame_path=None, east_detection=None):
     if out_path is None:
         out_dir = pathlib.Path(MOVIES_DIR) / cam / _output_subdir(phase)
         out_dir.mkdir(parents=True, exist_ok=True)
@@ -362,6 +372,11 @@ def _render_and_post(phase, spec, target_utc, when_utc, local_dt, cam,
         str(nasa_path), out_path,
         output_size=(OUT_W, OUT_H), moon_height_pct=MOON_PCT,
         caption=caption,
+        east_frame_path=east_frame_path,
+        east_detection=east_detection,
+        cloud_overlay_enabled=CLOUD_OVERLAY_ENABLED,
+        cloud_overlay_max_opacity=CLOUD_OVERLAY_MAX_OPACITY,
+        cloud_overlay_blur=CLOUD_OVERLAY_BLUR,
     )
     print(f'wrote {out_path}')