@robbeverhelst/do 1.390.0 → 1.392.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.392.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)]);
@@ -23932,6 +23933,24 @@ var collectionSavedViews = pgTable("collection_saved_views", {
 }, (t) => [
   index("collection_saved_views_tenant_idx").on(t.tenantId)
 ]);
+var collectionKinds = pgTable("collection_kinds", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  key: text("key").notNull(),
+  name: text("name").notNull(),
+  one: text("one").notNull(),
+  many: text("many").notNull(),
+  icon: text("icon").notNull().default("tag"),
+  preset: text("preset"),
+  fields: jsonb("fields").$type().notNull().default([]),
+  statusWords: jsonb("status_words").$type().notNull(),
+  view: text("view").notNull().default("grid"),
+  createdByUserId: text("created_by_user_id").references(() => users.id, {
+    onDelete: "set null"
+  }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [unique("collection_kinds_tenant_key_uniq").on(t.tenantId, t.key)]);
 
 // ../../packages/schema/src/contracts/collection-values.ts
 var collectionStatusValues = ["want", "have", "doing", "done", "dropped", "gone"];
@@ -23945,7 +23964,8 @@ var collectionTypeValues = [
   "wine",
   "wardrobe",
   "asset",
-  "hobby"
+  "hobby",
+  "console"
 ];
 var collectionTypeSchema = _enum2(collectionTypeValues);
 var collectionViewValues = ["grid", "shelf", "map"];
@@ -26137,6 +26157,162 @@ var circleOperations = defineOperations({
   })
 });
 
+// ../../packages/schema/src/contracts/collection-kinds.ts
+var collectionKindFieldTypeValues = [
+  "text",
+  "number",
+  "choice",
+  "year",
+  "date",
+  "yesno"
+];
+var collectionKindFieldTypeSchema = _enum2(collectionKindFieldTypeValues);
+var collectionKindIconValues = [
+  "disc",
+  "dice",
+  "brick",
+  "book",
+  "pad",
+  "sprout",
+  "paw",
+  "tag"
+];
+var collectionKindIconSchema = _enum2(collectionKindIconValues);
+var collectionKindPresetValues = ["lego", "vinyl", "board", "custom"];
+var collectionKindPresetSchema = _enum2(collectionKindPresetValues);
+var slug = string2().min(1).max(40).regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "lowercase letters and digits, dashes between");
+var collectionKindKeySchema = slug.refine((k) => !collectionTypeValues.includes(k), "that's a built-in kind");
+var collectionKindFieldSchema = object({
+  key: slug,
+  label: string2().trim().min(1).max(40),
+  type: collectionKindFieldTypeSchema,
+  choices: array(string2().trim().min(1).max(40)).max(30).optional()
+}).strict().refine((f) => f.type === "choice" || f.choices === undefined, {
+  message: "only a choice field has choices",
+  path: ["choices"]
+});
+var collectionKindFieldsSchema = array(collectionKindFieldSchema).max(12).refine((fs) => new Set(fs.map((f) => f.key)).size === fs.length, "each field key once");
+var word = string2().trim().min(1).max(30);
+var collectionKindStatusWordsSchema = object({ want: word, have: word, doing: word, done: word, dropped: word }).strict();
+var collectionKindSchema = object({
+  id: ulidSchema,
+  key: string2(),
+  name: string2(),
+  one: string2(),
+  many: string2(),
+  icon: string2(),
+  preset: string2().nullable(),
+  fields: array(object({
+    key: string2(),
+    label: string2(),
+    type: string2(),
+    choices: array(string2()).optional()
+  })),
+  statusWords: collectionKindStatusWordsSchema,
+  view: string2(),
+  itemCount: number2().int(),
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+});
+var name2 = string2().trim().min(1).max(40);
+var createCollectionKindInputSchema = object({
+  id: ulidSchema,
+  name: name2,
+  key: collectionKindKeySchema.optional(),
+  one: name2.optional(),
+  many: name2.optional(),
+  icon: collectionKindIconSchema.optional(),
+  preset: collectionKindPresetSchema.optional(),
+  fields: collectionKindFieldsSchema.optional(),
+  statusWords: collectionKindStatusWordsSchema.optional()
+}).strict();
+var updateCollectionKindInputSchema = object({
+  name: name2.optional(),
+  one: name2.optional(),
+  many: name2.optional(),
+  icon: collectionKindIconSchema.optional(),
+  fields: collectionKindFieldsSchema.optional(),
+  statusWords: collectionKindStatusWordsSchema.optional()
+}).strict();
+var f = (label, type) => ({
+  key: kindSlug(label),
+  label,
+  type
+});
+var COLLECTION_KIND_PRESETS = {
+  lego: {
+    name: "LEGO",
+    one: "set",
+    icon: "brick",
+    fields: [
+      f("Set number", "text"),
+      f("Pieces", "number"),
+      f("Theme", "choice"),
+      f("Bags", "number"),
+      f("Minifigures", "number"),
+      f("Released", "year")
+    ],
+    statusWords: {
+      want: "Want",
+      have: "In the box",
+      doing: "Building",
+      done: "Built",
+      dropped: "Parted out"
+    }
+  },
+  vinyl: {
+    name: "Vinyl",
+    one: "record",
+    icon: "disc",
+    fields: [
+      f("Artist", "text"),
+      f("Label", "choice"),
+      f("Pressing", "text"),
+      f("Speed", "number"),
+      f("Condition", "choice"),
+      f("Released", "year")
+    ],
+    statusWords: {
+      want: "Want",
+      have: "Have",
+      doing: "On rotation",
+      done: "Played out",
+      dropped: "Sold"
+    }
+  },
+  board: {
+    name: "Board games",
+    one: "board game",
+    icon: "dice",
+    fields: [
+      f("Players", "number"),
+      f("Play time", "text"),
+      f("Designer", "text"),
+      f("Expansions", "text"),
+      f("Plays", "number"),
+      f("Released", "year")
+    ],
+    statusWords: {
+      want: "Want",
+      have: "Have",
+      doing: "Learning",
+      done: "Played",
+      dropped: "Gave away"
+    }
+  },
+  custom: {
+    name: "",
+    one: "",
+    icon: "tag",
+    fields: [f("Maker", "text"), f("Year", "year"), f("Condition", "choice")],
+    statusWords: { want: "Want", have: "Have", doing: "Using", done: "Done", dropped: "Gone" }
+  }
+};
+function kindSlug(name) {
+  const s = name.toLowerCase().normalize("NFKD").replace(/[\u0300-\u036F]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40).replace(/-+$/, "");
+  return s || "kind";
+}
+
 // ../../packages/schema/src/contracts/pagination.ts
 var paginationQuerySchema = object({
   limit: exports_coerce.number().int().positive().optional(),
@@ -26147,6 +26323,7 @@ var paginationQuerySchema = object({
 var READ2 = ["collections:read"];
 var WRITE2 = ["collections:write"];
 var entryParams = { entryId: "The entry's ULID." };
+var kindParams = { kindId: "The kind's ULID." };
 var collectionOperations = defineOperations({
   ...crudOperations({
     segment: "collection",
@@ -26202,6 +26379,65 @@ var collectionOperations = defineOperations({
     status: 200,
     response: { description: "The Type registry." }
   },
+  listKinds: {
+    method: "get",
+    path: "/collection/kinds",
+    scopes: READ2,
+    tag: "Collection",
+    summary: "List the Space's own kinds",
+    description: "The kinds the Space added (vinyl, board games, \u2026) beside the built-in Types, by name: each with its `key` (what an Item of it carries as its `type`), `name`, `one`/`many`, `icon`, the `preset` it started from, its `fields` (key, label, type: `text`, `number`, `choice`, `year`, `date` or `yesno`, and a choice field's `choices`; the first three show on its tile), its `statusWords` for want, have, doing, done and dropped, its `view` (`grid`) and `itemCount`.",
+    status: 200,
+    response: { description: "The kinds." }
+  },
+  createKind: {
+    method: "post",
+    path: "/collection/kinds",
+    scopes: WRITE2,
+    tag: "Collection",
+    summary: "Add a kind",
+    description: "Start from a `preset` (`lego`, `vinyl`, `board` or `custom`, \"Something else\") and a `name`; what's left out comes from the preset (the icon, the fields, the status words), the `key` is the name's slug (never a built-in Type; 409 when the Space has it) and `one`/`many` come from the name. It starts on the clean grid.",
+    body: createCollectionKindInputSchema,
+    status: 201,
+    response: { description: "The kind." },
+    errors: { 400: true, 409: "The Space already has a kind with this key." }
+  },
+  getKind: {
+    method: "get",
+    path: "/collection/kinds/{kindId}",
+    pathParams: kindParams,
+    scopes: READ2,
+    tag: "Collection",
+    summary: "A kind of the Space's own",
+    description: "The same shape as a row of the list.",
+    status: 200,
+    response: { description: "The kind." },
+    errors: { 404: true }
+  },
+  updateKind: {
+    method: "patch",
+    path: "/collection/kinds/{kindId}",
+    pathParams: kindParams,
+    scopes: WRITE2,
+    tag: "Collection",
+    summary: "Change a kind",
+    description: "Its name, one/many, icon, `fields` (replaces the list) or `statusWords`; a field left out stays. The key never changes.",
+    body: updateCollectionKindInputSchema,
+    status: 200,
+    response: { description: "The kind." },
+    errors: { 400: true, 404: true }
+  },
+  removeKind: {
+    method: "delete",
+    path: "/collection/kinds/{kindId}",
+    pathParams: kindParams,
+    scopes: WRITE2,
+    tag: "Collection",
+    summary: "Remove a kind",
+    description: "Only a kind with no Items (409 otherwise: move or remove them first).",
+    status: 204,
+    response: { description: "Removed." },
+    errors: { 404: true, 409: "The kind still has Items." }
+  },
   backfillCovers: {
     method: "post",
     path: "/collection/covers",
@@ -29311,6 +29547,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 +30088,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 +38496,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 +38507,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`",
@@ -40065,18 +40574,18 @@ var runPlayStatusValues = [
   "dropped"
 ];
 var runPlayStatusSchema = _enum2(runPlayStatusValues);
-var name2 = string2().trim().min(1).max(200);
+var name3 = string2().trim().min(1).max(200);
 var text5 = string2().trim().max(2000);
 var shortText2 = string2().trim().max(300);
 var isoDate = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "must be an ISO date (YYYY-MM-DD)");
 var ref = string2().trim().min(1).max(200);
 var runCharacterSchema = object({
-  name: name2,
+  name: name3,
   pronoun: _enum2(["he", "she", "they"]).nullish(),
   subtitle: shortText2.nullish(),
   level: number2().int().min(0).max(1e4).nullish(),
   build: shortText2.nullish(),
-  stats: array(object({ k: name2, v: union([number2(), shortText2]) }).strict()).max(40).optional(),
+  stats: array(object({ k: name3, v: union([number2(), shortText2]) }).strict()).max(40).optional(),
   traits: array(shortText2).max(20).optional(),
   backstory: text5.nullish(),
   rules: array(shortText2).max(30).optional(),
@@ -40085,12 +40594,12 @@ var runCharacterSchema = object({
 var runArcSchema = object({
   title: shortText2.nullish(),
   chapters: array(object({
-    key: name2,
-    name: name2,
+    key: name3,
+    name: name3,
     range: shortText2.nullish(),
     moral: text5.nullish()
   }).strict()).max(40),
-  current: name2.nullish()
+  current: name3.nullish()
 }).strict();
 var runStepStatusValues = ["done", "now", "todo", "skipped"];
 var runStepStatusSchema = _enum2(runStepStatusValues);
@@ -40103,7 +40612,7 @@ var runQuestStatusValues = ["active", "paused", "planned", "done", "failed"];
 var runQuestStatusSchema = _enum2(runQuestStatusValues);
 var runQuestSchema = object({
   ref: ref.nullish(),
-  name: name2,
+  name: name3,
   line: shortText2.nullish(),
   status: runQuestStatusSchema.default("active"),
   objective: text5.nullish(),
@@ -40118,7 +40627,7 @@ var runQuestSchema = object({
   }).strict()).max(40).optional(),
   pausedAt: shortText2.nullish(),
   why: text5.nullish(),
-  revisitAt: name2.nullish()
+  revisitAt: name3.nullish()
 }).strict();
 var runNextStepsSchema = object({
   items: array(shortText2.pipe(string2().min(1))).max(3),
@@ -40127,50 +40636,50 @@ var runNextStepsSchema = object({
 }).strict();
 var runChoiceSchema = object({
   ref: ref.nullish(),
-  title: name2,
+  title: name3,
   place: shortText2.nullish(),
   status: _enum2(["made", "planned"]).default("made"),
   options: array(shortText2).max(6).optional(),
   why: text5.nullish(),
   consequence: text5.nullish(),
-  revisitAt: name2.nullish(),
-  chapter: name2.nullish(),
+  revisitAt: name3.nullish(),
+  chapter: name3.nullish(),
   tone: _enum2(["good", "grey", "dark"]).nullish(),
   on: isoDate.nullish()
 }).strict();
 var runHomeSchema = object({
   ref: ref.nullish(),
-  name: name2,
+  name: name3,
   role: _enum2(["home", "collector", "storage", "planned", "later"]).default("home"),
   place: shortText2.nullish(),
-  upgrades: array(object({ name: name2, done: boolean2().default(false) }).strict()).max(40).optional(),
+  upgrades: array(object({ name: name3, done: boolean2().default(false) }).strict()).max(40).optional(),
   steward: shortText2.nullish(),
   note: text5.nullish()
 }).strict();
 var runPersonSchema = object({
   ref: ref.nullish(),
-  name: name2,
+  name: name3,
   role: _enum2(["child", "spouse", "steward", "follower", "pet", "rival", "other"]),
   status: _enum2(["with", "planned", "lost"]).default("with"),
   home: shortText2.nullish(),
   note: text5.nullish()
 }).strict();
 var runMountSchema = object({
-  name: name2,
+  name: name3,
   status: _enum2(["with", "planned", "lost"]).default("with"),
   note: text5.nullish()
 }).strict();
 var runUniqueSchema = object({
   ref: ref.nullish(),
-  name: name2,
+  name: name3,
   status: _enum2(["have", "now", "want"]).default("have"),
   source: shortText2.nullish(),
   displayAt: shortText2.nullish(),
-  set: name2.nullish()
+  set: name3.nullish()
 }).strict();
 var runChecklistSchema = object({
   key: string2().trim().min(1).max(60).regex(/^[a-z0-9][a-z0-9_-]*$/, "must be a lowercase slug"),
-  label: name2,
+  label: name3,
   total: number2().int().min(0).max(5000).nullish(),
   items: array(object({ id: ref, label: shortText2.nullish() }).strict()).max(5000).optional(),
   done: array(ref).max(5000),
@@ -40179,7 +40688,7 @@ var runChecklistSchema = object({
   legend: shortText2.nullish()
 }).strict();
 var runTeamMemberSchema = object({
-  species: name2,
+  species: name3,
   nick: shortText2.nullish(),
   level: number2().int().min(1).max(100).nullish(),
   nature: shortText2.nullish(),
@@ -40193,8 +40702,8 @@ var runAchievementsSchema = object({
   source: _enum2(["steam", "xbox", "psn", "manual"]).default("manual"),
   total: number2().int().min(0).max(5000).nullish(),
   enabled: boolean2().default(true),
-  unlocked: array(object({ name: name2, on: isoDate.nullish(), hint: shortText2.nullish(), key: ref.nullish() }).strict()).max(5000),
-  locked: array(object({ name: name2, hint: shortText2.nullish(), key: ref.nullish() }).strict()).max(5000).optional(),
+  unlocked: array(object({ name: name3, on: isoDate.nullish(), hint: shortText2.nullish(), key: ref.nullish() }).strict()).max(5000),
+  locked: array(object({ name: name3, hint: shortText2.nullish(), key: ref.nullish() }).strict()).max(5000).optional(),
   syncedAt: string2().datetime({ offset: true }).nullish()
 }).strict();
 var runRareFindsSchema = object({
@@ -40204,7 +40713,7 @@ var runRareFindsSchema = object({
 }).strict();
 var runInstallSchema = object({
   edition: shortText2.nullish(),
-  mods: array(object({ name: name2, url: string2().url().max(2000).nullish() }).strict()).max(200).default([]),
+  mods: array(object({ name: name3, url: string2().url().max(2000).nullish() }).strict()).max(200).default([]),
   savePath: string2().trim().max(500).nullish(),
   lastBackup: isoDate.nullish(),
   notes: text5.nullish()
@@ -40214,7 +40723,7 @@ var runSaveFields = {
   game: _enum2(["skyrim"]).default("skyrim"),
   fileName: shortText2.nullish(),
   saveNumber: number2().int().min(0).max(1e9),
-  playerName: name2,
+  playerName: name3,
   level: number2().int().min(0).max(1e4),
   location: shortText2,
   race: shortText2.nullish(),
@@ -40260,7 +40769,7 @@ var runFacetSchema = object({
   install: runInstallSchema.nullish(),
   save: runSaveSchema.nullish(),
   money: object({ goal: shortText2.nullish(), purpose: shortText2.nullish() }).strict().nullish(),
-  links: array(object({ label: name2, url: string2().url().max(2000) }).strict()).max(50).optional()
+  links: array(object({ label: name3, url: string2().url().max(2000) }).strict()).max(50).optional()
 }).strict();
 var runListSectionValues = [
   "orderOfPlay",
@@ -40414,12 +40923,12 @@ var runSaveHeaderResultSchema = object({
 var createRunInputSchema = object({
   id: ulidSchema,
   gameId: ulidSchema,
-  title: name2,
+  title: name3,
   status: runPlayStatusSchema.optional(),
   facet: runFacetSchema.optional()
 }).strict();
 var updateRunInputSchema = object({
-  title: name2.optional(),
+  title: name3.optional(),
   status: runPlayStatusSchema.optional(),
   facet: runFacetSchema.optional()
 }).strict();
@@ -40808,325 +41317,65 @@ var sensorOperations = defineOperations({
     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
-  },
-  {
-    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
+  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 +43495,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 +43743,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]);
@@ -47095,6 +47366,106 @@ var commands9 = [
       return { data: types, render: renderList };
     }
   },
+  {
+    spec: {
+      path: ["collection", "kinds"],
+      summary: "List the Space's own kinds (vinyl, board games, \u2026) with their fields and words.",
+      args: [],
+      flags: [],
+      scopes: [...collectionOperations.listKinds.scopes],
+      returns: "CollectionKind[]",
+      notes: `${routeOf(collectionOperations.listKinds)}. Each kind's \`key\` is what an Item of it carries as its \`type\`.`
+    },
+    run: async ({ requireClient }) => ({
+      data: await requireClient().getPage(pathOf(collectionOperations.listKinds)),
+      render: renderList
+    })
+  },
+  {
+    spec: {
+      path: ["collection", "kind"],
+      summary: "One of the Space's own kinds.",
+      args: [{ name: "id", required: true, description: "Kind ULID." }],
+      flags: [],
+      scopes: [...collectionOperations.getKind.scopes],
+      returns: "CollectionKind",
+      notes: `${routeOf(collectionOperations.getKind)}.`
+    },
+    run: readOperation(collectionOperations.getKind, renderRecord, { kindId: "kind id" })
+  },
+  {
+    spec: {
+      path: ["collection", "kind-add"],
+      summary: "Add a kind: from a preset (lego, vinyl, board, custom) or from scratch.",
+      args: [{ name: "name", required: true, description: 'Its name ("Vinyl").' }],
+      flags: [
+        {
+          name: "preset",
+          type: "string",
+          description: `Start from ${Object.keys(COLLECTION_KIND_PRESETS).join(", ")}; what's left out comes from it.`
+        },
+        {
+          name: "data",
+          type: "string",
+          description: 'More JSON: `{ "key": "\u2026", "one": "record", "many": "records", "icon": "disc", "fields": [{ "key": "artist", "label": "Artist", "type": "text" }], "statusWords": { \u2026 } }`. The id is minted.'
+        }
+      ],
+      scopes: [...collectionOperations.createKind.scopes],
+      returns: "CollectionKind",
+      notes: `${routeOf(collectionOperations.createKind)}. The key is the name's slug unless given; a key the Space has is a 409. \`do collection kind-add Vinyl --preset vinyl\`.`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const name = requireArg(args, 0, "name");
+      const preset = flagString(flags, "preset");
+      if (preset)
+        parseInput(collectionKindPresetSchema, preset);
+      const body = parseInput(createCollectionKindInputSchema, {
+        id: ulid3(),
+        name,
+        ...preset ? { preset } : {},
+        ...readDataFlag(flags)
+      });
+      return {
+        data: await requireClient().post(pathOf(collectionOperations.createKind), body),
+        render: renderRecord
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["collection", "kind-update"],
+      summary: "Change a kind: its name, one/many, icon, fields or status words (the key stays).",
+      args: [{ name: "id", required: true, description: "Kind ULID." }],
+      flags: [{ name: "data", type: "string", description: "UpdateCollectionKindInput JSON." }],
+      scopes: [...collectionOperations.updateKind.scopes],
+      returns: "CollectionKind",
+      notes: `${routeOf(collectionOperations.updateKind)}. \`fields\` replaces the list.`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const kindId = requireArg(args, 0, "kind id");
+      const body = parseInput(updateCollectionKindInputSchema, readDataFlag(flags));
+      return {
+        data: await requireClient().patch(pathOf(collectionOperations.updateKind, { kindId }), body),
+        render: renderRecord
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["collection", "kind-remove"],
+      summary: "Remove a kind that has no Items.",
+      args: [{ name: "id", required: true, description: "Kind ULID." }],
+      flags: [],
+      scopes: [...collectionOperations.removeKind.scopes],
+      returns: "void",
+      notes: `${routeOf(collectionOperations.removeKind)}. A 409 while it still has Items.`
+    },
+    run: async ({ args, requireClient }) => {
+      const kindId = requireArg(args, 0, "kind id");
+      await requireClient().delete(pathOf(collectionOperations.removeKind, { kindId }));
+      return { data: { ok: true, kindId }, render: renderRecord };
+    }
+  },
   {
     spec: {
       path: ["collection", "list"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.390.0",
+  "version": "1.392.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",