feat(theme-sync): #79 slice 1 — auto day/night theme primitive

First slice of the auto time-of-day theme pair (VISION § D, split into
CLI / timer / menu). `nomarchy-theme-sync auto` reads
settings.autoTheme.{enable,day,night,sunrise,sunset}, picks day vs night
from the local clock, and applies the matching preset — but only if it
differs from the current one, so the slice-2 timer can fire freely
without triggering needless rebuilds. `--which` prints the decision
without switching; `--force` and `--no-switch` included.

cmd_apply's core is factored into apply_named() so `auto` drives the
exact same one engine (no second pipeline). apply behavior is unchanged.

Verification: V1 (package builds) + functional tests on the built binary
against scratch state — wide-day window → day slug, a 00:00–00:01 day
span → night, disabled → no-op, missing day/night → clear die, auto
--no-switch writes state, a re-run no-ops as "already on", and plain
apply still writes (refactor intact). V0 py_compile + flake check +
checks.theme-sync-validate green.

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

pkgs/nomarchy-theme-sync/nomarchy-theme-sync.py

@@ -18,6 +18,7 @@ Commands:
   apply <name|file.json>     merge a preset into the state + rebuild
   set <dotted.path> <value>  tweak one key (e.g. `set ui.gapsOut 16`) + rebuild
   get [dotted.path]          print the current state (or one key)
+  auto [--which]             apply the day/night theme for the current time
   validate                   check the state file against the schema (read-only)
   wallpaper                  apply the current wallpaper via swww
   bg [next|auto]             cycle the theme's wallpapers (instant, no rebuild)
@@ -466,11 +467,13 @@ def cmd_list(_args) -> None:
     print("\n".join(names))
 
 
-def cmd_apply(args) -> None:
-    candidate = Path(args.theme).expanduser()
-    preset_path = candidate if candidate.is_file() else find_preset(args.theme)
+def apply_named(theme: str, no_switch: bool = False) -> None:
+    """Merge a preset (name or JSON file) into the state and rebuild. Shared
+    by `apply` and `auto` so the day/night switch is the *same* one engine."""
+    candidate = Path(theme).expanduser()
+    preset_path = candidate if candidate.is_file() else find_preset(theme)
     if preset_path is None:
-        die(f"unknown theme '{args.theme}' (try `nomarchy-theme-sync list`)")
+        die(f"unknown theme '{theme}' (try `nomarchy-theme-sync list`)")
 
     preset = json.loads(preset_path.read_text())
     # Merge over current state. Presets carry a full appearance block —
@@ -483,14 +486,63 @@ def cmd_apply(args) -> None:
     state = deep_merge(old, preset)
     write_state(state)
     if auto_commit_enabled(old) or auto_commit_enabled(state):
-        auto_commit(f"nomarchy: apply theme {state.get('name', args.theme)}")
-    log(f"theme: {state.get('name', args.theme)}")
+        auto_commit(f"nomarchy: apply theme {state.get('name', theme)}")
+    log(f"theme: {state.get('name', theme)}")
     check_fonts(state)
-    if not args.no_switch:
+    if not no_switch:
         run_switch()
         apply_wallpaper(state)
 
 
+def cmd_apply(args) -> None:
+    apply_named(args.theme, no_switch=args.no_switch)
+
+
+def _hhmm_to_min(s: str, default: str) -> int:
+    """'HH:MM' → minutes since midnight; falls back to `default` on garbage."""
+    for candidate in (s, default):
+        try:
+            h, m = str(candidate).split(":")
+            return int(h) * 60 + int(m)
+        except (ValueError, AttributeError):
+            continue
+    return 0
+
+
+def cmd_auto(args) -> None:
+    """Apply the day or night theme for the current local time, per
+    settings.autoTheme = {enable, day, night, sunrise, sunset}. Slice 1 of
+    the auto time-of-day pair (BACKLOG #79): the timer (slice 2) and menu
+    (slice 3) drive this; it can also be run by hand or from a user cron."""
+    state = load_state()
+    at = (state.get("settings") or {}).get("autoTheme") or {}
+    if not at.get("enable"):
+        if not args.which:
+            log("auto-theme: off (enable via settings.autoTheme.enable)")
+        return
+    day, night = at.get("day"), at.get("night")
+    if not day or not night:
+        die("auto-theme needs settings.autoTheme.day and .night (theme slugs)")
+
+    sunrise = _hhmm_to_min(at.get("sunrise", "07:00"), "07:00")
+    sunset = _hhmm_to_min(at.get("sunset", "20:00"), "20:00")
+    now = time.localtime()
+    mins = now.tm_hour * 60 + now.tm_min
+    # Normal case sunrise < sunset: daytime is the span between them. If a
+    # user inverts them, treat the between-span as night (still coherent).
+    between = sunrise <= mins < sunset
+    daytime = between if sunrise <= sunset else not between
+    target = day if daytime else night
+
+    if args.which:
+        print(target)
+        return
+    if state.get("slug") == target and not args.force:
+        log(f"auto-theme: already on {target} ({'day' if daytime else 'night'})")
+        return
+    apply_named(target, no_switch=args.no_switch)
+
+
 def cmd_set(args) -> None:
     state = load_state()
     try:
@@ -590,6 +642,12 @@ def main() -> None:
     p.add_argument("path", nargs="?")
     p.set_defaults(func=cmd_get)
 
+    p = sub.add_parser("auto", help="apply the day/night theme for the current time (settings.autoTheme)")
+    p.add_argument("--which", action="store_true", help="print the theme that WOULD apply, don't switch")
+    p.add_argument("--force", action="store_true", help="apply even if already on the target theme")
+    p.add_argument("--no-switch", action="store_true", help="write state only, skip the rebuild")
+    p.set_defaults(func=cmd_auto)
+
     sub.add_parser("validate", help="check theme-state.json against the schema (read-only)").set_defaults(func=cmd_validate)
 
     sub.add_parser("wallpaper", help="apply the current wallpaper via swww").set_defaults(func=cmd_wallpaper)