feat(hobbs-organizer): v1.4.0 per-TV morning routine (admin TVs tab) + photo app 1.2.1

- Admin TVs tab: wake time/days, YouTube Music playlist, Shield volume per TV,
  pushed via 5-min TV check-ins (/api/tv/config, /api/tv/report, LAN-only)
- com.dayline.photos 1.2.1: MorningActivity (screen on, volume, playlist),
  calendar alarm at wake time, Doze-safe chained check-ins
- Both TVs configured for 06:30 daily with the family playlist

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E9NnVEico3WvFxLyjy1iW3

tv app/Hobbs-Family-Organizer-Self-Hosted-v1.0.0/app/_lib/store.ts

@@ -44,11 +44,76 @@ export const DEFAULT_PHOTO_SETTINGS: PhotoSettings = {
   albums: [],
 };
 
+/**
+ * Per-TV morning routine, run by the Shield photo app (com.dayline.photos) on each TV:
+ * wake the TV, set the volume, start a YouTube Music playlist, then bring up the calendar.
+ * `id` is the TV's Android ID, reported by the app when it checks in.
+ */
+export type TvSetting = {
+  id: string;
+  name: string;
+  wake: { enabled: boolean; time: string; days: number[] };
+  music: { enabled: boolean; playlistId: string };
+  volume: { enabled: boolean; level: number };
+};
+
+export const MAX_TVS = 10;
+export const ALL_DAYS = [0, 1, 2, 3, 4, 5, 6];
+
+export function validTvId(value: unknown) {
+  return typeof value === "string" && /^[a-f0-9]{8,32}$/.test(value) ? value : null;
+}
+
+/** Accepts a YouTube / YouTube Music playlist link or a bare playlist ID; returns the ID. */
+export function validPlaylistId(value: unknown) {
+  const text = String(value ?? "").trim();
+  if (/^[A-Za-z0-9_-]{10,64}$/.test(text)) return text;
+  let url: URL;
+  try {
+    url = new URL(text);
+  } catch {
+    return null;
+  }
+  if (url.protocol !== "https:" || !["music.youtube.com", "www.youtube.com", "youtube.com", "m.youtube.com"].includes(url.hostname)) return null;
+  const list = url.searchParams.get("list") ?? "";
+  return /^[A-Za-z0-9_-]{10,64}$/.test(list) ? list : null;
+}
+
+export const playlistUrl = (playlistId: string) => `https://music.youtube.com/playlist?list=${playlistId}`;
+
+function validTime(value: unknown) {
+  return typeof value === "string" && /^([01]\d|2[0-3]):[0-5]\d$/.test(value) ? value : null;
+}
+
+function normalizeTvs(raw: unknown): TvSetting[] {
+  const seen = new Set<string>();
+  return (Array.isArray(raw) ? raw : [])
+    .map((entry) => {
+      const id = validTvId(entry?.id);
+      if (!id || seen.has(id)) return null;
+      seen.add(id);
+      const days = Array.isArray(entry.wake?.days)
+        ? [...new Set((entry.wake.days as unknown[]).map(Number).filter((day) => Number.isInteger(day) && day >= 0 && day <= 6))].sort()
+        : ALL_DAYS;
+      const level = Number(entry.volume?.level);
+      return {
+        id,
+        name: typeof entry.name === "string" ? entry.name.trim().slice(0, 40) : "",
+        wake: { enabled: entry.wake?.enabled === true, time: validTime(entry.wake?.time) ?? "06:30", days },
+        music: { enabled: entry.music?.enabled === true, playlistId: validPlaylistId(entry.music?.playlistId) ?? "" },
+        volume: { enabled: entry.volume?.enabled === true, level: Number.isFinite(level) ? Math.min(100, Math.max(0, Math.round(level))) : 40 },
+      } satisfies TvSetting;
+    })
+    .filter((entry): entry is TvSetting => entry !== null)
+    .slice(0, MAX_TVS);
+}
+
 export type Settings = {
   schema: 1;
   updatedAt: string;
   calendars: CalendarSetting[];
   photos: PhotoSettings;
+  tvs: TvSetting[];
 };
 
 /** Accepts photos.app.goo.gl short links and photos.google.com/share links. */
@@ -149,6 +214,7 @@ function normalizeSettings(raw: unknown): Settings {
       .filter((entry): entry is CalendarSetting => entry !== null)
       .slice(0, MAX_CALENDARS),
     photos: normalizePhotos(value.photos),
+    tvs: normalizeTvs(value.tvs),
   };
 }
 
@@ -188,16 +254,17 @@ async function pruneHistory() {
 }
 
 /** Saves new settings (only the parts given), first snapshotting the current ones into history. */
-export function saveSettings(patch: Partial<Pick<Settings, "calendars" | "photos">>, note: string) {
+export function saveSettings(patch: Partial<Pick<Settings, "calendars" | "photos" | "tvs">>, note: string) {
   return serialized(async () => {
     const current = await readSettings();
     const calendars = patch.calendars ?? current.calendars;
     const photos = patch.photos ?? current.photos;
+    const tvs = patch.tvs ?? current.tvs;
     const stamp = new Date().toISOString();
     const snapshotId = `${stamp.replace(/[:.]/g, "-")}`;
     await writeJsonAtomic(path.join(historyDir(), `${snapshotId}.json`), { ...current, note });
     await pruneHistory();
-    const next = normalizeSettings({ schema: 1, updatedAt: stamp, calendars, photos });
+    const next = normalizeSettings({ schema: 1, updatedAt: stamp, calendars, photos, tvs });
     await writeJsonAtomic(settingsPath(), next);
     return next;
   });