@robbeverhelst/do 1.390.0 → 1.391.0

package/dist/do.js

@@ -14420,7 +14420,7 @@ var configError = (message) => new CliError("config", message, EXIT.CONFIG);
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.390.0";
+var VERSION = "1.391.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -18260,6 +18260,7 @@ var userSettings = pgTable("user_settings", {
   themePack: settingsThemePack("theme_pack").notNull().default("do"),
   themePackScope: settingsThemePackScope("theme_pack_scope").notNull().default("section"),
   ui: settingsUi("ui").notNull().default("v1"),
+  healthTodayHints: text("health_today_hints").array().notNull().default(sql`'{supplements,sleep}'::text[]`),
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
   updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [unique("user_settings_tenant_user_uniq").on(t.tenantId, t.userId)]);
@@ -23945,7 +23946,8 @@ var collectionTypeValues = [
   "wine",
   "wardrobe",
   "asset",
-  "hobby"
+  "hobby",
+  "console"
 ];
 var collectionTypeSchema = _enum2(collectionTypeValues);
 var collectionViewValues = ["grid", "shelf", "map"];
@@ -29311,6 +29313,271 @@ var healthCycleShares = pgTable("health_cycle_shares", {
   updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [primaryKey({ columns: [t.tenantId, t.userId] })]);
 
+// ../../packages/schema/src/contracts/modules.ts
+var MODULE_KEYS = [
+  "tasks",
+  "habits",
+  "routines",
+  "challenges",
+  "projects",
+  "areas",
+  "notes",
+  "shopping",
+  "inventory",
+  "meals",
+  "animals",
+  "contacts",
+  "sharing",
+  "automations"
+];
+var moduleKeySchema = _enum2(MODULE_KEYS);
+var FEATURE_MODULES = [
+  {
+    key: "today",
+    label: "Today",
+    description: "Your daily dashboard \u2014 always on.",
+    group: "System",
+    defaultEnabled: true,
+    system: true
+  },
+  {
+    key: "inbox",
+    label: "Inbox",
+    description: "Quick capture and triage \u2014 always on.",
+    group: "System",
+    defaultEnabled: true,
+    system: true
+  },
+  {
+    key: "settings",
+    label: "Settings",
+    description: "This screen \u2014 always on.",
+    group: "System",
+    defaultEnabled: true,
+    system: true
+  },
+  {
+    key: "tasks",
+    label: "Tasks",
+    description: "To-dos, due dates, and starred focus.",
+    group: "Track",
+    defaultEnabled: true
+  },
+  {
+    key: "habits",
+    label: "Habits",
+    description: "Daily routines and streaks.",
+    group: "Track",
+    defaultEnabled: true
+  },
+  {
+    key: "routines",
+    label: "Routines",
+    description: "Repeatable checklists you run.",
+    group: "Track",
+    defaultEnabled: true
+  },
+  {
+    key: "challenges",
+    label: "Challenges",
+    description: "Time-boxed goals and competitions.",
+    group: "Track",
+    defaultEnabled: false
+  },
+  {
+    key: "projects",
+    label: "Projects",
+    description: "Multi-step work with milestones.",
+    group: "Organize",
+    defaultEnabled: true
+  },
+  {
+    key: "areas",
+    label: "Areas",
+    description: "Ongoing life domains (PARA areas).",
+    group: "Organize",
+    defaultEnabled: true
+  },
+  {
+    key: "notes",
+    label: "Notes",
+    description: "Quick notes and documents.",
+    group: "Organize",
+    defaultEnabled: true
+  },
+  {
+    key: "shopping",
+    label: "Shopping",
+    description: "Lists and groceries.",
+    group: "Household",
+    defaultEnabled: true
+  },
+  {
+    key: "inventory",
+    label: "Inventory",
+    description: "Things you own and stock.",
+    group: "Household",
+    defaultEnabled: true
+  },
+  {
+    key: "meals",
+    label: "Meals",
+    description: "Recipes and meal plans.",
+    group: "Household",
+    defaultEnabled: false
+  },
+  {
+    key: "animals",
+    label: "Animals",
+    description: "Pets and flocks: eggs, weights, feed and care.",
+    group: "Household",
+    defaultEnabled: false
+  },
+  {
+    key: "contacts",
+    label: "Contacts",
+    description: "People and relationships.",
+    group: "People",
+    defaultEnabled: false
+  },
+  {
+    key: "sharing",
+    label: "Members & sharing",
+    description: "Members, roles, per-item sharing and comments.",
+    group: "People",
+    defaultEnabled: false
+  },
+  {
+    key: "automations",
+    label: "Automations",
+    description: "Trigger \u2192 condition \u2192 action rules.",
+    group: "Manage",
+    defaultEnabled: false
+  }
+];
+var TOGGLEABLE_MODULES = FEATURE_MODULES.filter((m) => !m.system);
+function isModuleKey(value) {
+  return MODULE_KEYS.includes(value);
+}
+function defaultEnabledModules() {
+  return TOGGLEABLE_MODULES.filter((m) => m.defaultEnabled).map((m) => m.key);
+}
+function normalizeEnabledModules(keys) {
+  const present = new Set(keys.filter(isModuleKey));
+  return MODULE_KEYS.filter((key) => present.has(key));
+}
+function effectiveEnabledModules(enabled) {
+  const known = normalizeEnabledModules(enabled ?? []);
+  return known.length > 0 ? known : defaultEnabledModules();
+}
+function setModuleEnabled(enabled, key, on) {
+  const next = new Set(effectiveEnabledModules(enabled));
+  if (on)
+    next.add(key);
+  else
+    next.delete(key);
+  return MODULE_KEYS.filter((candidate) => next.has(candidate));
+}
+
+// ../../packages/schema/src/contracts/settings.ts
+var clockTimeSchema = string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "a time like 22:00");
+var quietHoursSchema = object({
+  from: clockTimeSchema,
+  until: clockTimeSchema,
+  days: array(number2().int().min(0).max(6)).max(7)
+});
+var PINNED_AREAS_MAX = 5;
+var PILL_PAGES = [
+  "now",
+  "habits",
+  "tasks",
+  "calendar",
+  "areas",
+  "house",
+  "collection",
+  "animals",
+  "notes",
+  "progress",
+  "landed",
+  "review",
+  "agents",
+  "profile",
+  "settings",
+  "alerts",
+  "trash"
+];
+var pillPageSchema = _enum2(PILL_PAGES);
+var PILL_PAGES_MAX = 4;
+var CALENDAR_ZOOM_MIN = 75;
+var CALENDAR_ZOOM_MAX = 300;
+var calendarZoomSchema = number2().int().min(CALENDAR_ZOOM_MIN).max(CALENDAR_ZOOM_MAX);
+var settingsGlassSchema = _enum2(settingsGlass.enumValues);
+var themePackSchema = _enum2(settingsThemePack.enumValues);
+var themePackScopeSchema = _enum2(settingsThemePackScope.enumValues);
+var settingsUiSchema = _enum2(settingsUi.enumValues);
+var HEALTH_TODAY_HINTS = ["supplements", "sleep", "appointment", "episode"];
+var healthTodayHintSchema = _enum2(HEALTH_TODAY_HINTS);
+var HEALTH_TODAY_HINTS_DEFAULT = ["supplements", "sleep"];
+var userSettingsSchema = createSelectSchema(userSettings, {
+  pinnedAreaIds: array(string2()).default([]),
+  focusAreaId: string2().nullable().default(null),
+  focusUntil: exports_coerce.date().nullable().default(null),
+  quietHours: quietHoursSchema.nullable().default(null),
+  notifications: record(string2(), unknown()).nullable().default(null),
+  lifeBlockSharing: lifeBlockSharingSchema.nullable().default(null),
+  pillPages: array(string2()).default([]).transform((ids) => ids.filter((id) => pillPageSchema.safeParse(id).success)),
+  foodDiaryMode: boolean2().default(false),
+  calendarZoom: number2().int().nullable().default(null),
+  glass: settingsGlassSchema.default("liquid"),
+  followSky: boolean2().default(true),
+  nightUntilWake: boolean2().default(false),
+  largerText: boolean2().default(false),
+  reduceMotion: boolean2().default(false),
+  showStreakNumbers: boolean2().default(true),
+  themePack: themePackSchema.default("do"),
+  themePackScope: themePackScopeSchema.default("section"),
+  ui: settingsUiSchema.default("v1"),
+  healthTodayHints: array(string2()).default([...HEALTH_TODAY_HINTS_DEFAULT]).transform((ids) => ids.filter((id) => healthTodayHintSchema.safeParse(id).success)),
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+}).omit({ autoRollOverdue: true });
+var updateUserSettingsInputSchema = createUpdateSchema(userSettings, {
+  displayName: string2().trim().max(80).nullish(),
+  avatarUrl: union([string2().url().max(2048), literal("")]).nullish(),
+  timezone: string2().min(1).optional(),
+  locale: string2().min(1).optional(),
+  theme: settingsThemeSchema.optional(),
+  density: settingsDensitySchema.optional(),
+  accent: settingsAccentSchema.optional(),
+  sunCity: string2().trim().max(80).transform((city) => city === "" ? null : city).nullish(),
+  backdrop: backdropIdSchema.nullish(),
+  enabledModules: array(string2().trim().min(1)).transform(normalizeEnabledModules).optional(),
+  pinnedAreaIds: array(ulidSchema).transform((ids) => [...new Set(ids)]).pipe(array(ulidSchema).max(PINNED_AREAS_MAX)).optional(),
+  focusAreaId: ulidSchema.nullish(),
+  quietHours: quietHoursSchema.nullish(),
+  lifeBlockSharing: lifeBlockSharingSchema.nullish(),
+  calendarZoom: calendarZoomSchema.nullish(),
+  pillPages: array(pillPageSchema).transform((ids) => [...new Set(ids)]).pipe(array(pillPageSchema).max(PILL_PAGES_MAX)).optional(),
+  glass: settingsGlassSchema.optional(),
+  followSky: boolean2().optional(),
+  nightUntilWake: boolean2().optional(),
+  largerText: boolean2().optional(),
+  reduceMotion: boolean2().optional(),
+  showStreakNumbers: boolean2().optional(),
+  themePack: themePackSchema.optional(),
+  themePackScope: themePackScopeSchema.optional(),
+  ui: settingsUiSchema.optional(),
+  healthTodayHints: array(healthTodayHintSchema).transform((ids) => HEALTH_TODAY_HINTS.filter((id) => ids.includes(id))).optional()
+}).omit({
+  id: true,
+  tenantId: true,
+  userId: true,
+  createdAt: true,
+  updatedAt: true,
+  autoRollOverdue: true,
+  focusUntil: true
+}).strict();
+
 // ../../packages/schema/src/contracts/health-records.ts
 var BODY_REGION_VALUES = [
   "head",
@@ -29587,6 +29854,14 @@ var updateHealthProfileInputSchema = object({
   emergencyContactId: ulidSchema.nullish(),
   primaryGpContactId: ulidSchema.nullish()
 }).strict();
+var healthTodaySchema = object({
+  hints: array(healthTodayHintSchema),
+  on: boolean2(),
+  supplementHabitIds: array(string2()),
+  sleep: object({ hours: number2() }).nullable(),
+  appointment: object({ id: string2(), title: string2(), at: exports_coerce.date() }).nullable(),
+  episode: object({ id: string2(), title: string2(), startedAt: exports_coerce.date() }).nullable()
+});
 var grantHealthConsentInputSchema = object({ version: literal(HEALTH_CONSENT_VERSION) }).strict();
 var HEALTH_ERASE_PHRASE = "delete my health data";
 var eraseHealthDataInputSchema = object({ confirm: literal(HEALTH_ERASE_PHRASE) }).strict();
@@ -37987,7 +38262,7 @@ var planningRules = pgTable("planning_rules", {
 var PLANNING_RULE_KINDS = planningRuleKind.enumValues;
 var planningRuleKindSchema = _enum2(PLANNING_RULE_KINDS);
 var PLANNING_RULE_SENTENCE_MAX = 280;
-var clockTimeSchema = string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "expected HH:MM (24 h)");
+var clockTimeSchema2 = string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "expected HH:MM (24 h)");
 var ruleWeekdaysSchema = array(number2().int().min(1).max(7)).min(1).max(7).transform((days) => [...new Set(days)].sort((a, b) => a - b));
 var phraseSchema = string2().trim().min(1).max(80);
 function clockMinutes(clock) {
@@ -37998,15 +38273,15 @@ var fixedTimeRuleSchema = object({
   kind: literal("fixed_time"),
   what: phraseSchema,
   days: ruleWeekdaysSchema,
-  at: clockTimeSchema,
+  at: clockTimeSchema2,
   minutes: number2().int().min(5).max(24 * 60).default(60),
   lifeKind: lifeBlockKindSchema.optional()
 }).strict();
 var keepFreeRuleSchema = object({
   kind: literal("keep_free"),
   days: ruleWeekdaysSchema,
-  from: clockTimeSchema,
-  to: clockTimeSchema,
+  from: clockTimeSchema2,
+  to: clockTimeSchema2,
   what: phraseSchema.optional()
 }).strict().refine((r) => clockMinutes(r.to) > clockMinutes(r.from), {
   message: "`to` comes after `from`",
@@ -40769,364 +41044,104 @@ var sensorOperations = defineOperations({
     path: "/sensors/home-assistant",
     scopes: ["places:read"],
     tag: "Sensors",
-    summary: "Get the Home Assistant link",
-    description: "Whether the Space has linked Home Assistant (in Settings in the app; the token is never returned), the `host` it was linked at, how many entities are mapped (`links`) and `lastReadingAt`, when the newest reading from it landed.",
-    status: 200,
-    response: { description: "The link's status." },
-    errors: { 403: true }
-  },
-  entities: {
-    method: "get",
-    path: "/sensors/home-assistant/entities",
-    scopes: ["places:read"],
-    tag: "Sensors",
-    summary: "List Home Assistant's entities",
-    description: "Every entity Home Assistant has, by `entityId`: its name, domain, state, unit, device class, `lastUpdated`, the reading it most likely gives on a Place and on an asset (`suggested`) and the sensor link it's mapped by, or null. 409 before Home Assistant is linked; 503 when it doesn't answer.",
-    status: 200,
-    response: { description: "The entities, by id." },
-    errors: { 403: true, 409: true, 503: "Home Assistant didn't answer, or refused the token." }
-  },
-  sync: {
-    method: "post",
-    path: "/sensors/home-assistant/sync",
-    scopes: ["places:write"],
-    tag: "Sensors",
-    summary: "Sync Home Assistant now",
-    description: "Read every mapped entity's state once and append it to the datapoints ledger: on a Place as `shed.temp`, `shed.humidity`, `shed.heater`, `shed.water_pct`, `shed.door`, `shed.feed_kg` or `shed.light` (what an animal's room card and the room alarm read), on an asset as `asset.state`, `asset.power` or `asset.energy`. A state already on the ledger, or one Home Assistant can't read, is skipped. The worker does the same every five minutes. Returns `{ syncedAt, entities, written, skipped, missing, error }` (`unauthorized`, `unavailable`, `bad_response`). 409 before Home Assistant is linked.",
-    status: 200,
-    response: { description: "What the sync did." },
-    errors: { 403: true, 409: true }
-  },
-  unifiStatus: {
-    method: "get",
-    path: "/sensors/unifi",
-    scopes: ["places:read"],
-    tag: "Sensors",
-    summary: "Whether UniFi is linked",
-    description: "Whether the Space has linked its UniFi controller (in the app's Settings \u2192 Home), the host and site it was linked at, how many devices are mapped to an asset, and when the newest presence reading landed. Never the API key: a key can't link or unlink UniFi.",
-    status: 200,
-    response: { description: "The status." },
-    errors: { 403: true }
-  },
-  unifiDevices: {
-    method: "get",
-    path: "/sensors/unifi/devices",
-    scopes: ["places:read", "collections:read"],
-    tag: "Sensors",
-    summary: "The devices UniFi sees",
-    description: "Every device the controller manages (gateway, switches, access points, cameras) and every client connected now: `mac`, `name`, `kind` (`device` | `client`), `model`, `online`, `firmware`, and the sensor `link` to the asset it's mapped to (behind the nodes wall). Network details. 409 before UniFi is linked; 503 when the controller can't be read.",
-    status: 200,
-    response: { description: "The devices." },
-    errors: { 403: true, 409: true }
-  },
-  syncUnifi: {
-    method: "post",
-    path: "/sensors/unifi/sync",
-    scopes: ["places:write"],
-    tag: "Sensors",
-    summary: "Sync UniFi now",
-    description: "Map every asset whose facet names a UniFi MAC (`external.unifiMac`), ask the controller once, and put each mapped device's presence on its asset as `asset.presence` (1 online, 0 offline, with its firmware): what the asset page's Live card reads. A reading lands when the presence or firmware changes, else hourly; a device the controller doesn't list reads offline and is named in `missing`. The worker does the same every five minutes. 409 before UniFi is linked.",
-    status: 200,
-    response: { description: "What the sync did." },
-    errors: { 403: true, 409: true }
-  },
-  links: {
-    method: "get",
-    path: "/sensors/links",
-    scopes: ["places:read"],
-    tag: "Sensors",
-    summary: "List the mapped entities",
-    description: "Every mapped entity, or only the ones on `nodeId`, with the name of what it lands on (`nodeTitle`). A mapping on an asset kept Not shared is its member's alone.",
-    query: [{ name: "nodeId", description: "Only the mappings on this Place or asset." }],
-    querySchema: sensorLinksQuerySchema,
-    status: 200,
-    response: { description: "The mappings, by entity id." },
-    errors: { 400: true }
-  },
-  createLink: {
-    method: "post",
-    path: "/sensors/links",
-    scopes: ["places:write"],
-    tag: "Sensors",
-    summary: "Map an entity",
-    description: "Map a Home Assistant entity (`externalId`) to a Place, an asset, or an animal (its room: the Place it's housed in) as a `reading`: a Place takes `temp`, `humidity`, `heater`, `water`, `door`, `feeder` or `light`; an asset `state`, `power` or `energy`. Mapping an entity that's already mapped moves it. 400 when the reading doesn't fit; 404 for no such node; 409 for an animal with no room.",
-    body: createSensorLinkInputSchema,
-    status: 201,
-    response: { description: "The mapping." },
-    errors: { 400: true, 404: true, 409: true }
-  },
-  removeLink: {
-    method: "delete",
-    path: "/sensors/links/{id}",
-    scopes: ["places:write"],
-    tag: "Sensors",
-    summary: "Unmap an entity",
-    description: "Remove one mapping; the readings it gave stay on the ledger.",
-    status: 204,
-    response: { description: "Removed." },
-    errors: { 404: true }
-  }
-});
-
-// ../../packages/schema/src/contracts/modules.ts
-var MODULE_KEYS = [
-  "tasks",
-  "habits",
-  "routines",
-  "challenges",
-  "projects",
-  "areas",
-  "notes",
-  "shopping",
-  "inventory",
-  "meals",
-  "animals",
-  "contacts",
-  "sharing",
-  "automations"
-];
-var moduleKeySchema = _enum2(MODULE_KEYS);
-var FEATURE_MODULES = [
-  {
-    key: "today",
-    label: "Today",
-    description: "Your daily dashboard \u2014 always on.",
-    group: "System",
-    defaultEnabled: true,
-    system: true
-  },
-  {
-    key: "inbox",
-    label: "Inbox",
-    description: "Quick capture and triage \u2014 always on.",
-    group: "System",
-    defaultEnabled: true,
-    system: true
-  },
-  {
-    key: "settings",
-    label: "Settings",
-    description: "This screen \u2014 always on.",
-    group: "System",
-    defaultEnabled: true,
-    system: true
-  },
-  {
-    key: "tasks",
-    label: "Tasks",
-    description: "To-dos, due dates, and starred focus.",
-    group: "Track",
-    defaultEnabled: true
-  },
-  {
-    key: "habits",
-    label: "Habits",
-    description: "Daily routines and streaks.",
-    group: "Track",
-    defaultEnabled: true
-  },
-  {
-    key: "routines",
-    label: "Routines",
-    description: "Repeatable checklists you run.",
-    group: "Track",
-    defaultEnabled: true
-  },
-  {
-    key: "challenges",
-    label: "Challenges",
-    description: "Time-boxed goals and competitions.",
-    group: "Track",
-    defaultEnabled: false
-  },
-  {
-    key: "projects",
-    label: "Projects",
-    description: "Multi-step work with milestones.",
-    group: "Organize",
-    defaultEnabled: true
-  },
-  {
-    key: "areas",
-    label: "Areas",
-    description: "Ongoing life domains (PARA areas).",
-    group: "Organize",
-    defaultEnabled: true
+    summary: "Get the Home Assistant link",
+    description: "Whether the Space has linked Home Assistant (in Settings in the app; the token is never returned), the `host` it was linked at, how many entities are mapped (`links`) and `lastReadingAt`, when the newest reading from it landed.",
+    status: 200,
+    response: { description: "The link's status." },
+    errors: { 403: true }
   },
-  {
-    key: "notes",
-    label: "Notes",
-    description: "Quick notes and documents.",
-    group: "Organize",
-    defaultEnabled: true
+  entities: {
+    method: "get",
+    path: "/sensors/home-assistant/entities",
+    scopes: ["places:read"],
+    tag: "Sensors",
+    summary: "List Home Assistant's entities",
+    description: "Every entity Home Assistant has, by `entityId`: its name, domain, state, unit, device class, `lastUpdated`, the reading it most likely gives on a Place and on an asset (`suggested`) and the sensor link it's mapped by, or null. 409 before Home Assistant is linked; 503 when it doesn't answer.",
+    status: 200,
+    response: { description: "The entities, by id." },
+    errors: { 403: true, 409: true, 503: "Home Assistant didn't answer, or refused the token." }
   },
-  {
-    key: "shopping",
-    label: "Shopping",
-    description: "Lists and groceries.",
-    group: "Household",
-    defaultEnabled: true
+  sync: {
+    method: "post",
+    path: "/sensors/home-assistant/sync",
+    scopes: ["places:write"],
+    tag: "Sensors",
+    summary: "Sync Home Assistant now",
+    description: "Read every mapped entity's state once and append it to the datapoints ledger: on a Place as `shed.temp`, `shed.humidity`, `shed.heater`, `shed.water_pct`, `shed.door`, `shed.feed_kg` or `shed.light` (what an animal's room card and the room alarm read), on an asset as `asset.state`, `asset.power` or `asset.energy`. A state already on the ledger, or one Home Assistant can't read, is skipped. The worker does the same every five minutes. Returns `{ syncedAt, entities, written, skipped, missing, error }` (`unauthorized`, `unavailable`, `bad_response`). 409 before Home Assistant is linked.",
+    status: 200,
+    response: { description: "What the sync did." },
+    errors: { 403: true, 409: true }
   },
-  {
-    key: "inventory",
-    label: "Inventory",
-    description: "Things you own and stock.",
-    group: "Household",
-    defaultEnabled: true
+  unifiStatus: {
+    method: "get",
+    path: "/sensors/unifi",
+    scopes: ["places:read"],
+    tag: "Sensors",
+    summary: "Whether UniFi is linked",
+    description: "Whether the Space has linked its UniFi controller (in the app's Settings \u2192 Home), the host and site it was linked at, how many devices are mapped to an asset, and when the newest presence reading landed. Never the API key: a key can't link or unlink UniFi.",
+    status: 200,
+    response: { description: "The status." },
+    errors: { 403: true }
   },
-  {
-    key: "meals",
-    label: "Meals",
-    description: "Recipes and meal plans.",
-    group: "Household",
-    defaultEnabled: false
+  unifiDevices: {
+    method: "get",
+    path: "/sensors/unifi/devices",
+    scopes: ["places:read", "collections:read"],
+    tag: "Sensors",
+    summary: "The devices UniFi sees",
+    description: "Every device the controller manages (gateway, switches, access points, cameras) and every client connected now: `mac`, `name`, `kind` (`device` | `client`), `model`, `online`, `firmware`, and the sensor `link` to the asset it's mapped to (behind the nodes wall). Network details. 409 before UniFi is linked; 503 when the controller can't be read.",
+    status: 200,
+    response: { description: "The devices." },
+    errors: { 403: true, 409: true }
   },
-  {
-    key: "animals",
-    label: "Animals",
-    description: "Pets and flocks: eggs, weights, feed and care.",
-    group: "Household",
-    defaultEnabled: false
+  syncUnifi: {
+    method: "post",
+    path: "/sensors/unifi/sync",
+    scopes: ["places:write"],
+    tag: "Sensors",
+    summary: "Sync UniFi now",
+    description: "Map every asset whose facet names a UniFi MAC (`external.unifiMac`), ask the controller once, and put each mapped device's presence on its asset as `asset.presence` (1 online, 0 offline, with its firmware): what the asset page's Live card reads. A reading lands when the presence or firmware changes, else hourly; a device the controller doesn't list reads offline and is named in `missing`. The worker does the same every five minutes. 409 before UniFi is linked.",
+    status: 200,
+    response: { description: "What the sync did." },
+    errors: { 403: true, 409: true }
   },
-  {
-    key: "contacts",
-    label: "Contacts",
-    description: "People and relationships.",
-    group: "People",
-    defaultEnabled: false
+  links: {
+    method: "get",
+    path: "/sensors/links",
+    scopes: ["places:read"],
+    tag: "Sensors",
+    summary: "List the mapped entities",
+    description: "Every mapped entity, or only the ones on `nodeId`, with the name of what it lands on (`nodeTitle`). A mapping on an asset kept Not shared is its member's alone.",
+    query: [{ name: "nodeId", description: "Only the mappings on this Place or asset." }],
+    querySchema: sensorLinksQuerySchema,
+    status: 200,
+    response: { description: "The mappings, by entity id." },
+    errors: { 400: true }
   },
-  {
-    key: "sharing",
-    label: "Members & sharing",
-    description: "Members, roles, per-item sharing and comments.",
-    group: "People",
-    defaultEnabled: false
+  createLink: {
+    method: "post",
+    path: "/sensors/links",
+    scopes: ["places:write"],
+    tag: "Sensors",
+    summary: "Map an entity",
+    description: "Map a Home Assistant entity (`externalId`) to a Place, an asset, or an animal (its room: the Place it's housed in) as a `reading`: a Place takes `temp`, `humidity`, `heater`, `water`, `door`, `feeder` or `light`; an asset `state`, `power` or `energy`. Mapping an entity that's already mapped moves it. 400 when the reading doesn't fit; 404 for no such node; 409 for an animal with no room.",
+    body: createSensorLinkInputSchema,
+    status: 201,
+    response: { description: "The mapping." },
+    errors: { 400: true, 404: true, 409: true }
   },
-  {
-    key: "automations",
-    label: "Automations",
-    description: "Trigger \u2192 condition \u2192 action rules.",
-    group: "Manage",
-    defaultEnabled: false
+  removeLink: {
+    method: "delete",
+    path: "/sensors/links/{id}",
+    scopes: ["places:write"],
+    tag: "Sensors",
+    summary: "Unmap an entity",
+    description: "Remove one mapping; the readings it gave stay on the ledger.",
+    status: 204,
+    response: { description: "Removed." },
+    errors: { 404: true }
   }
-];
-var TOGGLEABLE_MODULES = FEATURE_MODULES.filter((m) => !m.system);
-function isModuleKey(value) {
-  return MODULE_KEYS.includes(value);
-}
-function defaultEnabledModules() {
-  return TOGGLEABLE_MODULES.filter((m) => m.defaultEnabled).map((m) => m.key);
-}
-function normalizeEnabledModules(keys) {
-  const present = new Set(keys.filter(isModuleKey));
-  return MODULE_KEYS.filter((key) => present.has(key));
-}
-function effectiveEnabledModules(enabled) {
-  const known = normalizeEnabledModules(enabled ?? []);
-  return known.length > 0 ? known : defaultEnabledModules();
-}
-function setModuleEnabled(enabled, key, on) {
-  const next = new Set(effectiveEnabledModules(enabled));
-  if (on)
-    next.add(key);
-  else
-    next.delete(key);
-  return MODULE_KEYS.filter((candidate) => next.has(candidate));
-}
-
-// ../../packages/schema/src/contracts/settings.ts
-var clockTimeSchema2 = string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "a time like 22:00");
-var quietHoursSchema = object({
-  from: clockTimeSchema2,
-  until: clockTimeSchema2,
-  days: array(number2().int().min(0).max(6)).max(7)
 });
-var PINNED_AREAS_MAX = 5;
-var PILL_PAGES = [
-  "now",
-  "habits",
-  "tasks",
-  "calendar",
-  "areas",
-  "house",
-  "collection",
-  "animals",
-  "notes",
-  "progress",
-  "landed",
-  "review",
-  "agents",
-  "profile",
-  "settings",
-  "alerts",
-  "trash"
-];
-var pillPageSchema = _enum2(PILL_PAGES);
-var PILL_PAGES_MAX = 4;
-var CALENDAR_ZOOM_MIN = 75;
-var CALENDAR_ZOOM_MAX = 300;
-var calendarZoomSchema = number2().int().min(CALENDAR_ZOOM_MIN).max(CALENDAR_ZOOM_MAX);
-var settingsGlassSchema = _enum2(settingsGlass.enumValues);
-var themePackSchema = _enum2(settingsThemePack.enumValues);
-var themePackScopeSchema = _enum2(settingsThemePackScope.enumValues);
-var settingsUiSchema = _enum2(settingsUi.enumValues);
-var userSettingsSchema = createSelectSchema(userSettings, {
-  pinnedAreaIds: array(string2()).default([]),
-  focusAreaId: string2().nullable().default(null),
-  focusUntil: exports_coerce.date().nullable().default(null),
-  quietHours: quietHoursSchema.nullable().default(null),
-  notifications: record(string2(), unknown()).nullable().default(null),
-  lifeBlockSharing: lifeBlockSharingSchema.nullable().default(null),
-  pillPages: array(string2()).default([]).transform((ids) => ids.filter((id) => pillPageSchema.safeParse(id).success)),
-  foodDiaryMode: boolean2().default(false),
-  calendarZoom: number2().int().nullable().default(null),
-  glass: settingsGlassSchema.default("liquid"),
-  followSky: boolean2().default(true),
-  nightUntilWake: boolean2().default(false),
-  largerText: boolean2().default(false),
-  reduceMotion: boolean2().default(false),
-  showStreakNumbers: boolean2().default(true),
-  themePack: themePackSchema.default("do"),
-  themePackScope: themePackScopeSchema.default("section"),
-  ui: settingsUiSchema.default("v1"),
-  createdAt: exports_coerce.date(),
-  updatedAt: exports_coerce.date()
-}).omit({ autoRollOverdue: true });
-var updateUserSettingsInputSchema = createUpdateSchema(userSettings, {
-  displayName: string2().trim().max(80).nullish(),
-  avatarUrl: union([string2().url().max(2048), literal("")]).nullish(),
-  timezone: string2().min(1).optional(),
-  locale: string2().min(1).optional(),
-  theme: settingsThemeSchema.optional(),
-  density: settingsDensitySchema.optional(),
-  accent: settingsAccentSchema.optional(),
-  sunCity: string2().trim().max(80).transform((city) => city === "" ? null : city).nullish(),
-  backdrop: backdropIdSchema.nullish(),
-  enabledModules: array(string2().trim().min(1)).transform(normalizeEnabledModules).optional(),
-  pinnedAreaIds: array(ulidSchema).transform((ids) => [...new Set(ids)]).pipe(array(ulidSchema).max(PINNED_AREAS_MAX)).optional(),
-  focusAreaId: ulidSchema.nullish(),
-  quietHours: quietHoursSchema.nullish(),
-  lifeBlockSharing: lifeBlockSharingSchema.nullish(),
-  calendarZoom: calendarZoomSchema.nullish(),
-  pillPages: array(pillPageSchema).transform((ids) => [...new Set(ids)]).pipe(array(pillPageSchema).max(PILL_PAGES_MAX)).optional(),
-  glass: settingsGlassSchema.optional(),
-  followSky: boolean2().optional(),
-  nightUntilWake: boolean2().optional(),
-  largerText: boolean2().optional(),
-  reduceMotion: boolean2().optional(),
-  showStreakNumbers: boolean2().optional(),
-  themePack: themePackSchema.optional(),
-  themePackScope: themePackScopeSchema.optional(),
-  ui: settingsUiSchema.optional()
-}).omit({
-  id: true,
-  tenantId: true,
-  userId: true,
-  createdAt: true,
-  updatedAt: true,
-  autoRollOverdue: true,
-  focusUntil: true
-}).strict();
 
 // ../../packages/schema/src/operations/settings.ts
 var settingsOperations = defineOperations({
@@ -43246,6 +43261,18 @@ var hobbyFacetSchema = object({
   with: string2().min(1).max(80).nullish(),
   coverUrl
 }).strict();
+var consoleFacetSchema = object({
+  model: string2().min(1).max(120).nullish(),
+  region: string2().min(1).max(40).nullish(),
+  condition: string2().min(1).max(80).nullish(),
+  boxed: boolean2().nullish(),
+  extras: string2().min(1).max(200).nullish(),
+  year: number2().int().min(1950).max(2100).nullish(),
+  works: boolean2().nullish(),
+  fixNote: string2().min(1).max(200).nullish(),
+  plays: array(string2().trim().min(1).max(40)).max(12).nullish(),
+  coverUrl
+}).strict();
 var placeFacetSchema = object({
   address: string2().min(1).max(400).nullish(),
   lat: number2().min(-90).max(90).nullish(),
@@ -43482,6 +43509,16 @@ var COLLECTION_TYPES = {
     facetSchema: hobbyFacetSchema,
     view: "grid",
     subtitleKey: "kind"
+  },
+  console: {
+    key: "console",
+    label: "Consoles",
+    itemNoun: "console",
+    statuses: ["want", "doing", "have", "done"],
+    statusLabels: { want: "Wanted", doing: "Hooked up", have: "In the cupboard", done: "Retired" },
+    facetSchema: consoleFacetSchema,
+    view: "grid",
+    subtitleKey: "model"
   }
 };
 var COLLECTION_TYPE_LIST = collectionTypeValues.map((k) => COLLECTION_TYPES[k]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.390.0",
+  "version": "1.391.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "homepage": "https://github.com/robbeverhelst/do/tree/main/apps/cli",