@robbeverhelst/do 1.87.0 → 1.89.0

package/dist/do.js

@@ -4371,6 +4371,7 @@ var userSettings = pgTable("user_settings", {
   density: settingsDensity("density").notNull().default("comfortable"),
   accent: settingsAccent("accent").notNull().default("teal"),
   enabledModules: text("enabled_modules").array().notNull().default([]),
+  autoRollOverdue: boolean("auto_roll_overdue").notNull().default(false),
   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)]);
@@ -4479,7 +4480,8 @@ var notificationType = pgEnum("notification_type", [
   "contact_date_due",
   "automation",
   "streak_at_risk",
-  "reflection_nudge"
+  "reflection_nudge",
+  "shutdown_nudge"
 ]);
 var notifications = pgTable("notifications", {
   id: text("id").primaryKey(),
@@ -19740,6 +19742,11 @@ var linkGoogleInputSchema = exports_external.object({
   code: exports_external.string().min(1),
   state: exports_external.string().min(1)
 });
+// ../../packages/schema/src/contracts/pagination.ts
+var paginationQuerySchema = exports_external.object({
+  limit: exports_external.coerce.number().int().positive().optional(),
+  cursor: exports_external.string().min(1).optional()
+});
 // ../../packages/schema/src/contracts/value-sets.ts
 var areaColorSchema = exports_external.enum(areaColor.enumValues);
 var reviewCadenceSchema = exports_external.enum(reviewCadence.enumValues);
@@ -19784,41 +19791,6 @@ var barcodeLookupResultSchema = exports_external.object({
   title: exports_external.string().nullable(),
   category: exports_external.string().nullable()
 });
-// ../../packages/schema/src/contracts/books.ts
-var bookCoverQuerySchema = exports_external.object({
-  title: exports_external.string().min(1).max(300)
-});
-var bookCoverResultSchema = exports_external.object({
-  coverUrl: exports_external.string().url().nullable(),
-  author: exports_external.string().nullable()
-});
-// ../../packages/schema/src/contracts/watch.ts
-var watchPosterQuerySchema = exports_external.object({
-  title: exports_external.string().min(1).max(300)
-});
-var watchPosterResultSchema = exports_external.object({
-  posterUrl: exports_external.string().url().nullable(),
-  year: exports_external.number().int().nullable(),
-  kind: exports_external.enum(["movie", "show"]).nullable()
-});
-// ../../packages/schema/src/contracts/games.ts
-var gameCoverQuerySchema = exports_external.object({
-  title: exports_external.string().min(1).max(300)
-});
-var gameCoverResultSchema = exports_external.object({
-  coverUrl: exports_external.string().url().nullable(),
-  year: exports_external.number().int().nullable(),
-  platform: exports_external.string().nullable()
-});
-// ../../packages/schema/src/contracts/music.ts
-var albumCoverQuerySchema = exports_external.object({
-  title: exports_external.string().min(1).max(300)
-});
-var albumCoverResultSchema = exports_external.object({
-  coverUrl: exports_external.string().url().nullable(),
-  year: exports_external.number().int().nullable(),
-  artist: exports_external.string().nullable()
-});
 // ../../packages/schema/src/contracts/tasks.ts
 var taskSchema = createSelectSchema(tasks, {
   scheduledAt: exports_external.coerce.date().nullable(),
@@ -20226,12 +20198,6 @@ var MODULE_KEYS = [
   "shopping",
   "inventory",
   "meals",
-  "library",
-  "watchlist",
-  "games",
-  "cellar",
-  "places",
-  "music",
   "contacts",
   "automations"
 ];
@@ -20331,48 +20297,6 @@ var FEATURE_MODULES = [
     group: "Household",
     defaultEnabled: true
   },
-  {
-    key: "library",
-    label: "Library",
-    description: "Books and things you catalog.",
-    group: "Collections",
-    defaultEnabled: true
-  },
-  {
-    key: "watchlist",
-    label: "Watchlist",
-    description: "Films and shows to watch.",
-    group: "Collections",
-    defaultEnabled: true
-  },
-  {
-    key: "games",
-    label: "Games",
-    description: "Games to play and backlog.",
-    group: "Collections",
-    defaultEnabled: true
-  },
-  {
-    key: "cellar",
-    label: "Cellar",
-    description: "Wines and bottles you keep.",
-    group: "Collections",
-    defaultEnabled: true
-  },
-  {
-    key: "places",
-    label: "Places",
-    description: "Spots to visit and remember.",
-    group: "Collections",
-    defaultEnabled: true
-  },
-  {
-    key: "music",
-    label: "Music",
-    description: "Albums and records to hear.",
-    group: "Collections",
-    defaultEnabled: true
-  },
   {
     key: "contacts",
     label: "Contacts",
@@ -20421,7 +20345,8 @@ var updateUserSettingsInputSchema = createUpdateSchema(userSettings, {
   theme: settingsThemeSchema.optional(),
   density: settingsDensitySchema.optional(),
   accent: settingsAccentSchema.optional(),
-  enabledModules: exports_external.array(exports_external.string().trim().min(1)).transform(normalizeEnabledModules).optional()
+  enabledModules: exports_external.array(exports_external.string().trim().min(1)).transform(normalizeEnabledModules).optional(),
+  autoRollOverdue: exports_external.boolean().optional()
 }).omit({ id: true, tenantId: true, userId: true, createdAt: true, updatedAt: true }).strict();
 // ../../packages/schema/src/contracts/notifications.ts
 var notificationSchema = createSelectSchema(notifications, {
@@ -20451,6 +20376,19 @@ var todayResponseSchema = exports_external.object({
   overdueTasks: exports_external.array(taskViewSchema),
   overdueOccurrences: exports_external.array(occurrenceViewSchema)
 });
+var rolloverInputSchema = exports_external.object({
+  taskIds: exports_external.array(exports_external.string().min(1)).default([]),
+  occurrenceIds: exports_external.array(exports_external.string().min(1)).default([]),
+  action: exports_external.enum(["reschedule", "drop"]),
+  to: exports_external.coerce.date().optional()
+}).refine((v) => v.action !== "reschedule" || v.to !== undefined, {
+  message: "`to` is required when action is `reschedule`",
+  path: ["to"]
+});
+var rolloverResultSchema = exports_external.object({
+  tasks: exports_external.number().int().nonnegative(),
+  occurrences: exports_external.number().int().nonnegative()
+});
 var reviewDayStatSchema = exports_external.object({
   date: exports_external.string(),
   completedTasks: exports_external.number().int().nonnegative(),
@@ -20531,15 +20469,6 @@ var shoppingListDetailSchema = shoppingListViewSchema.extend({
 });
 var setShoppingItemCheckedInputSchema = exports_external.object({ isChecked: exports_external.boolean() }).strict();
 // ../../packages/schema/src/presets/facets.ts
-var MEDIA_SHELF_DISPLAY_KIND = "media-shelf";
-var bookStatusValues = ["to-read", "reading", "read"];
-var bookStatusSchema = exports_external.enum(bookStatusValues);
-var mediaShelfFacetSchema = exports_external.object({
-  author: exports_external.string().min(1).max(200).nullish(),
-  coverUrl: exports_external.string().url().max(2048).nullish(),
-  status: bookStatusSchema.default("to-read"),
-  rating: exports_external.number().int().min(1).max(5).nullish()
-}).strict();
 var PANTRY_DISPLAY_KIND = "pantry";
 var WARDROBE_DISPLAY_KIND = "wardrobe";
 var TOOLS_DISPLAY_KIND = "tools";
@@ -20575,75 +20504,11 @@ var medsFacetSchema = exports_external.object({
   refillBy: isoDateString.nullish(),
   prescription: exports_external.boolean().nullish()
 }).strict();
-var WATCH_SHELF_DISPLAY_KIND = "watch-shelf";
-var watchKindValues = ["movie", "show"];
-var watchKindSchema = exports_external.enum(watchKindValues);
-var watchStatusValues = ["to-watch", "watching", "watched"];
-var watchStatusSchema = exports_external.enum(watchStatusValues);
-var watchFacetSchema = exports_external.object({
-  kind: watchKindSchema.default("movie"),
-  status: watchStatusSchema.default("to-watch"),
-  rating: exports_external.number().int().min(1).max(5).nullish(),
-  year: exports_external.number().int().min(1888).max(2200).nullish(),
-  posterUrl: exports_external.string().url().max(2048).nullish()
-}).strict();
-var GAME_SHELF_DISPLAY_KIND = "game-shelf";
-var gameStatusValues = ["backlog", "playing", "beaten", "dropped"];
-var gameStatusSchema = exports_external.enum(gameStatusValues);
-var gameFacetSchema = exports_external.object({
-  status: gameStatusSchema.default("backlog"),
-  platform: exports_external.string().min(1).max(100).nullish(),
-  rating: exports_external.number().int().min(1).max(5).nullish(),
-  hoursPlayed: exports_external.number().min(0).max(1e5).nullish(),
-  coverUrl: exports_external.string().url().max(2048).nullish()
-}).strict();
-var BOTTLE_SHELF_DISPLAY_KIND = "bottle-shelf";
-var bottleTypeValues = ["wine", "whisky", "other"];
-var bottleTypeSchema = exports_external.enum(bottleTypeValues);
-var bottleFacetSchema = exports_external.object({
-  type: bottleTypeSchema.default("wine"),
-  region: exports_external.string().min(1).max(200).nullish(),
-  vintage: exports_external.number().int().min(1000).max(2200).nullish(),
-  rating: exports_external.number().int().min(1).max(5).nullish(),
-  drinkBy: isoDateString.nullish(),
-  quantity: exports_external.number().int().min(0).max(1e5).nullish()
-}).strict();
-var PLACE_SHELF_DISPLAY_KIND = "place-shelf";
-var placeStatusValues = ["want", "visited"];
-var placeStatusSchema = exports_external.enum(placeStatusValues);
-var placeFacetSchema = exports_external.object({
-  status: placeStatusSchema.default("want"),
-  country: exports_external.string().min(1).max(120).nullish(),
-  city: exports_external.string().min(1).max(120).nullish(),
-  lat: exports_external.number().min(-90).max(90).nullish(),
-  lng: exports_external.number().min(-180).max(180).nullish(),
-  rating: exports_external.number().int().min(1).max(5).nullish(),
-  tripLink: exports_external.string().min(1).max(2048).nullish()
-}).strict();
-var ALBUM_SHELF_DISPLAY_KIND = "album-shelf";
-var albumStatusValues = ["want", "owned", "listened"];
-var albumStatusSchema = exports_external.enum(albumStatusValues);
-var albumFormatValues = ["vinyl", "digital", "cd"];
-var albumFormatSchema = exports_external.enum(albumFormatValues);
-var albumFacetSchema = exports_external.object({
-  status: albumStatusSchema.default("want"),
-  artist: exports_external.string().min(1).max(200).nullish(),
-  format: albumFormatSchema.nullish(),
-  rating: exports_external.number().int().min(1).max(5).nullish(),
-  year: exports_external.number().int().min(1860).max(2200).nullish(),
-  coverUrl: exports_external.string().url().max(2048).nullish()
-}).strict();
 var facetSchemasByDisplayKind = {
-  [MEDIA_SHELF_DISPLAY_KIND]: mediaShelfFacetSchema,
   [PANTRY_DISPLAY_KIND]: pantryFacetSchema,
   [WARDROBE_DISPLAY_KIND]: wardrobeFacetSchema,
   [TOOLS_DISPLAY_KIND]: toolsFacetSchema,
-  [MEDS_DISPLAY_KIND]: medsFacetSchema,
-  [WATCH_SHELF_DISPLAY_KIND]: watchFacetSchema,
-  [GAME_SHELF_DISPLAY_KIND]: gameFacetSchema,
-  [BOTTLE_SHELF_DISPLAY_KIND]: bottleFacetSchema,
-  [PLACE_SHELF_DISPLAY_KIND]: placeFacetSchema,
-  [ALBUM_SHELF_DISPLAY_KIND]: albumFacetSchema
+  [MEDS_DISPLAY_KIND]: medsFacetSchema
 };
 
 // ../../packages/schema/src/contracts/inventory.ts
@@ -22256,7 +22121,7 @@ var filmFacetSchema = exports_external.object({
   episodeCount: exports_external.number().int().min(1).max(1e4).nullish(),
   currentEpisode: exports_external.number().int().min(0).max(1e4).nullish()
 }).strict();
-var gameFacetSchema2 = exports_external.object({
+var gameFacetSchema = exports_external.object({
   platform: exports_external.string().min(1).max(120).nullish(),
   coverUrl,
   completion: exports_external.number().int().min(0).max(100).nullish()
@@ -22266,7 +22131,7 @@ var musicFacetSchema = exports_external.object({
   year: exports_external.number().int().min(1860).max(2100).nullish(),
   coverUrl
 }).strict();
-var placeFacetSchema2 = exports_external.object({
+var placeFacetSchema = exports_external.object({
   address: exports_external.string().min(1).max(400).nullish(),
   lat: exports_external.number().min(-90).max(90).nullish(),
   lng: exports_external.number().min(-180).max(180).nullish()
@@ -22325,7 +22190,7 @@ var COLLECTION_TYPES = {
       done: "Beaten",
       dropped: "Dropped"
     },
-    facetSchema: gameFacetSchema2,
+    facetSchema: gameFacetSchema,
     view: "grid",
     subtitleKey: "platform",
     lookupId: "igdb",
@@ -22348,7 +22213,7 @@ var COLLECTION_TYPES = {
     itemNoun: "place",
     statuses: ["want", "done"],
     statusLabels: { want: "Want", done: "Been" },
-    facetSchema: placeFacetSchema2,
+    facetSchema: placeFacetSchema,
     view: "map",
     subtitleKey: "address",
     lookupId: "nominatim"
@@ -22456,12 +22321,6 @@ var presetEntitySchema = exports_external.enum([
   "habit",
   "list",
   "inventory",
-  "library",
-  "watchlist",
-  "games",
-  "cellar",
-  "places",
-  "music",
   "routine",
   "area",
   "project",
@@ -22817,38 +22676,6 @@ var automationPresets = [
   }
 ];
 
-// ../../packages/schema/src/presets/features/cellar.ts
-var bottles = [
-  { title: "Rioja Reserva", type: "wine", region: "Rioja", vintage: 2016 },
-  { title: "Lagavulin 16", type: "whisky", region: "Islay", vintage: 2008 },
-  { title: "Barolo", type: "wine", region: "Piedmont", vintage: 2018 }
-];
-var cellarPreset = {
-  key: "cellar",
-  entity: "cellar",
-  name: "Cellar",
-  description: "Wine & whisky you keep \u2014 type, region, vintage and ratings.",
-  icon: "\uD83C\uDF77",
-  color: "#9f1239",
-  category: "Collecting",
-  displayKind: BOTTLE_SHELF_DISPLAY_KIND,
-  recipe: {
-    nodes: [
-      {
-        ref: "list",
-        kind: "shopping_list",
-        title: "Cellar",
-        displayKind: BOTTLE_SHELF_DISPLAY_KIND,
-        items: bottles.map((b) => ({
-          title: b.title,
-          facet: { type: b.type, region: b.region, vintage: b.vintage, quantity: 1 }
-        }))
-      }
-    ]
-  }
-};
-var cellarPresets = [cellarPreset];
-
 // ../../packages/schema/src/presets/features/challenges.ts
 var challengePresetDefs = [
   {
@@ -22996,38 +22823,6 @@ var contactPresets = contactCircleDefs.map((def) => ({
   }
 }));
 
-// ../../packages/schema/src/presets/features/games.ts
-var games2 = [
-  { title: "Hollow Knight: Silksong", platform: "PC" },
-  { title: "Elden Ring", platform: "PS5" },
-  { title: "Baldur's Gate 3", platform: "PC" }
-];
-var gamesPreset = {
-  key: "games",
-  entity: "games",
-  name: "Games to play",
-  description: "A backlog of games \u2014 covers, status and ratings.",
-  icon: "\uD83C\uDFAE",
-  color: "#8b5cf6",
-  category: "Playing",
-  displayKind: GAME_SHELF_DISPLAY_KIND,
-  recipe: {
-    nodes: [
-      {
-        ref: "list",
-        kind: "shopping_list",
-        title: "Games to play",
-        displayKind: GAME_SHELF_DISPLAY_KIND,
-        items: games2.map((g) => ({
-          title: g.title,
-          facet: { platform: g.platform, status: "backlog" }
-        }))
-      }
-    ]
-  }
-};
-var gamesPresets = [gamesPreset];
-
 // ../../packages/schema/src/presets/features/habits.ts
 var habitPresets = [
   {
@@ -23652,37 +23447,7 @@ var listPresetDefs = [
     items: ["Change HVAC filter", "Clean gutters", "Test smoke alarms", "Descale kettle"]
   }
 ];
-var booksToRead = [
-  { title: "Atomic Habits", author: "James Clear" },
-  { title: "Deep Work", author: "Cal Newport" },
-  { title: "The Pragmatic Programmer", author: "Andrew Hunt" }
-];
-var booksToReadPreset = {
-  key: "books-to-read",
-  entity: "library",
-  name: "Books to Read",
-  description: "Your reading queue \u2014 covers, status and ratings.",
-  icon: "\uD83D\uDCDA",
-  color: "#f59e0b",
-  category: "Reading",
-  displayKind: MEDIA_SHELF_DISPLAY_KIND,
-  recipe: {
-    nodes: [
-      {
-        ref: "list",
-        kind: "shopping_list",
-        title: "Books to Read",
-        displayKind: MEDIA_SHELF_DISPLAY_KIND,
-        items: booksToRead.map((book) => ({
-          title: book.title,
-          facet: { author: book.author, status: "to-read" }
-        }))
-      }
-    ]
-  }
-};
 var shoppingListPresets = [
-  booksToReadPreset,
   ...listPresetDefs.map((def) => ({
     key: def.key,
     entity: "list",
@@ -23910,70 +23675,6 @@ var mealPresets = [
   }
 ];
 
-// ../../packages/schema/src/presets/features/music.ts
-var albums = [
-  { title: "In Rainbows", artist: "Radiohead", year: 2007 },
-  { title: "Blonde", artist: "Frank Ocean", year: 2016 },
-  { title: "Random Access Memories", artist: "Daft Punk", year: 2013 }
-];
-var musicPreset = {
-  key: "music",
-  entity: "music",
-  name: "Albums",
-  description: "Albums to hear and own \u2014 artist, format, status and ratings.",
-  icon: "\uD83D\uDCBF",
-  color: "#db2777",
-  category: "Listening",
-  displayKind: ALBUM_SHELF_DISPLAY_KIND,
-  recipe: {
-    nodes: [
-      {
-        ref: "list",
-        kind: "shopping_list",
-        title: "Albums",
-        displayKind: ALBUM_SHELF_DISPLAY_KIND,
-        items: albums.map((a) => ({
-          title: a.title,
-          facet: { artist: a.artist, year: a.year, status: "want" }
-        }))
-      }
-    ]
-  }
-};
-var musicPresets = [musicPreset];
-
-// ../../packages/schema/src/presets/features/places.ts
-var places = [
-  { title: "Kyoto temples", country: "Japan", city: "Kyoto" },
-  { title: "Northern Lights", country: "Iceland", city: "Reykjav\xEDk" },
-  { title: "Patagonia trek", country: "Argentina", city: "El Chalt\xE9n" }
-];
-var placesPreset = {
-  key: "places",
-  entity: "places",
-  name: "Places to go",
-  description: "A bucket-list of places \u2014 want/visited, location and ratings.",
-  icon: "\uD83D\uDCCD",
-  color: "#0d9488",
-  category: "Exploring",
-  displayKind: PLACE_SHELF_DISPLAY_KIND,
-  recipe: {
-    nodes: [
-      {
-        ref: "list",
-        kind: "shopping_list",
-        title: "Places to go",
-        displayKind: PLACE_SHELF_DISPLAY_KIND,
-        items: places.map((p) => ({
-          title: p.title,
-          facet: { country: p.country, city: p.city, status: "want" }
-        }))
-      }
-    ]
-  }
-};
-var placesPresets = [placesPreset];
-
 // ../../packages/schema/src/presets/features/projects.ts
 var projectPresetDefs = [
   {
@@ -24162,47 +23863,10 @@ var routinePresets = routinePresetDefs.map((def) => ({
   }
 }));
 
-// ../../packages/schema/src/presets/features/watchlist.ts
-var watchlistTitles = [
-  { title: "Dune: Part Two", kind: "movie", year: 2024 },
-  { title: "Oppenheimer", kind: "movie", year: 2023 },
-  { title: "Severance", kind: "show", year: 2022 }
-];
-var watchlistPreset = {
-  key: "watchlist",
-  entity: "watchlist",
-  name: "Watchlist",
-  description: "Films & shows to watch \u2014 posters, status and ratings.",
-  icon: "\uD83C\uDFAC",
-  color: "#6366f1",
-  category: "Watching",
-  displayKind: WATCH_SHELF_DISPLAY_KIND,
-  recipe: {
-    nodes: [
-      {
-        ref: "list",
-        kind: "shopping_list",
-        title: "Watchlist",
-        displayKind: WATCH_SHELF_DISPLAY_KIND,
-        items: watchlistTitles.map((t) => ({
-          title: t.title,
-          facet: { kind: t.kind, year: t.year, status: "to-watch" }
-        }))
-      }
-    ]
-  }
-};
-var watchlistPresets = [watchlistPreset];
-
 // ../../packages/schema/src/presets/features/index.ts
 var featurePresets = [
   ...habitPresets,
   ...shoppingListPresets,
-  ...watchlistPresets,
-  ...gamesPresets,
-  ...cellarPresets,
-  ...placesPresets,
-  ...musicPresets,
   ...inventoryPresets,
   ...routinePresets,
   ...areaPresets,
@@ -24468,7 +24132,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.87.0";
+var VERSION = "1.89.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -24502,6 +24166,16 @@ class DoClient {
   delete(path) {
     return this.request("DELETE", path, {});
   }
+  async getPage(path, opts = {}) {
+    const res = await this.send("GET", path, opts);
+    if (res.status === 204)
+      return { data: [], nextCursor: null };
+    const text2 = await res.text();
+    const parsed = text2.length > 0 ? safeJson(text2) : undefined;
+    if (!res.ok)
+      throw httpError(res.status, parsed);
+    return normalizePage(parsed);
+  }
   url(path, query) {
     const origin = this.opts.apiUrl.replace(/\/+$/, "");
     const url2 = new URL(`${origin}${API_PREFIX}${path}`);
@@ -24550,6 +24224,16 @@ function unwrapEnvelope(body) {
   }
   return body;
 }
+function normalizePage(body) {
+  if (typeof body === "object" && body !== null && !Array.isArray(body) && "nextCursor" in body) {
+    const record2 = body;
+    if (Array.isArray(record2.data)) {
+      const nextCursor = typeof record2.nextCursor === "string" ? record2.nextCursor : null;
+      return { data: record2.data, nextCursor };
+    }
+  }
+  return { data: Array.isArray(body) ? body : [], nextCursor: null };
+}
 function safeJson(text2) {
   try {
     return JSON.parse(text2);
@@ -24781,102 +24465,6 @@ var ENTITIES = [
       canDelete: true
     }
   },
-  {
-    name: "library",
-    path: "/library",
-    readScope: "collections:read",
-    returns: "ShoppingList",
-    canGet: true,
-    listFlags: [],
-    write: {
-      scope: "collections:write",
-      createSchema: createShoppingListInputSchema,
-      createInput: "CreateShoppingListInput",
-      updateSchema: updateShoppingListInputSchema,
-      updateInput: "UpdateShoppingListInput",
-      canDelete: true
-    }
-  },
-  {
-    name: "watchlist",
-    path: "/watchlist",
-    readScope: "collections:read",
-    returns: "ShoppingList",
-    canGet: true,
-    listFlags: [],
-    write: {
-      scope: "collections:write",
-      createSchema: createShoppingListInputSchema,
-      createInput: "CreateShoppingListInput",
-      updateSchema: updateShoppingListInputSchema,
-      updateInput: "UpdateShoppingListInput",
-      canDelete: true
-    }
-  },
-  {
-    name: "games",
-    path: "/games",
-    readScope: "collections:read",
-    returns: "ShoppingList",
-    canGet: true,
-    listFlags: [],
-    write: {
-      scope: "collections:write",
-      createSchema: createShoppingListInputSchema,
-      createInput: "CreateShoppingListInput",
-      updateSchema: updateShoppingListInputSchema,
-      updateInput: "UpdateShoppingListInput",
-      canDelete: true
-    }
-  },
-  {
-    name: "cellar",
-    path: "/cellar",
-    readScope: "collections:read",
-    returns: "ShoppingList",
-    canGet: true,
-    listFlags: [],
-    write: {
-      scope: "collections:write",
-      createSchema: createShoppingListInputSchema,
-      createInput: "CreateShoppingListInput",
-      updateSchema: updateShoppingListInputSchema,
-      updateInput: "UpdateShoppingListInput",
-      canDelete: true
-    }
-  },
-  {
-    name: "places",
-    path: "/places",
-    readScope: "collections:read",
-    returns: "ShoppingList",
-    canGet: true,
-    listFlags: [],
-    write: {
-      scope: "collections:write",
-      createSchema: createShoppingListInputSchema,
-      createInput: "CreateShoppingListInput",
-      updateSchema: updateShoppingListInputSchema,
-      updateInput: "UpdateShoppingListInput",
-      canDelete: true
-    }
-  },
-  {
-    name: "music",
-    path: "/music",
-    readScope: "collections:read",
-    returns: "ShoppingList",
-    canGet: true,
-    listFlags: [],
-    write: {
-      scope: "collections:write",
-      createSchema: createShoppingListInputSchema,
-      createInput: "CreateShoppingListInput",
-      updateSchema: updateShoppingListInputSchema,
-      updateInput: "UpdateShoppingListInput",
-      canDelete: true
-    }
-  },
   {
     name: "inventory-items",
     path: "/inventory-items",
@@ -24964,6 +24552,14 @@ function entityOperations(e) {
 }
 
 // src/registry.ts
+var PAGINATION_FLAGS = [
+  { name: "limit", type: "string", description: "Max rows to return (1\u2013100)." },
+  {
+    name: "cursor",
+    type: "string",
+    description: "Opaque keyset cursor from a previous page's nextCursor."
+  }
+];
 var GLOBAL_FLAGS = [
   { name: "json", type: "boolean", description: "Emit JSON (automatic when stdout is piped)." },
   { name: "quiet", type: "boolean", description: "Suppress human output (errors still report)." },
@@ -25115,7 +24711,7 @@ var COMMAND_SPECS = [
       {
         name: "entity",
         type: "string",
-        description: "Filter to one gallery facet (habit|list|library|watchlist|games|cellar|places|music|routine|area|project|recipe|contact|challenge|automation)."
+        description: "Filter to one gallery facet (habit|list|routine|area|project|recipe|contact|challenge|automation)."
       }
     ],
     scopes: ["presets:read"],
@@ -25151,7 +24747,8 @@ var COMMAND_SPECS = [
         type: "string",
         description: "Filter to one Status (want|have|doing|done|dropped)."
       },
-      { name: "tag", type: "string", description: "Filter to Items carrying this tag." }
+      { name: "tag", type: "string", description: "Filter to Items carrying this tag." },
+      ...PAGINATION_FLAGS
     ],
     scopes: ["collections:read"],
     returns: "CollectionItemView"
@@ -25523,11 +25120,18 @@ function buildManifest() {
         }
       } : {},
       returns: e.returns,
-      listFlags: e.listFlags.map((f) => ({
-        name: f.name,
-        description: f.description,
-        required: f.required ?? false
-      }))
+      listFlags: [
+        ...e.listFlags.map((f) => ({
+          name: f.name,
+          description: f.description,
+          required: f.required ?? false
+        })),
+        ...PAGINATION_FLAGS.map((f) => ({
+          name: f.name,
+          description: f.description,
+          required: false
+        }))
+      ]
     })),
     exitCodes: {
       success: EXIT.OK,
@@ -25647,17 +25251,35 @@ function renderWhoami(data, mode) {
 `);
 }
 function renderList(data, mode) {
-  if (!Array.isArray(data))
+  const page = asPage(data);
+  if (page === undefined)
     return renderRecord(data, mode);
-  if (data.length === 0)
-    return paint(mode, "dim", "(no records)");
-  const lines = data.map((row) => {
-    const label = labelOf(row);
-    const id = idOf(row);
-    return id ? `  ${label}  ${paint(mode, "dim", id)}` : `  ${label}`;
-  });
-  return [`${data.length} record(s):`, ...lines].join(`
+  const { rows, nextCursor } = page;
+  const body = rows.length === 0 ? paint(mode, "dim", "(no records)") : [
+    `${rows.length} record(s):`,
+    ...rows.map((row) => {
+      const label = labelOf(row);
+      const id = idOf(row);
+      return id ? `  ${label}  ${paint(mode, "dim", id)}` : `  ${label}`;
+    })
+  ].join(`
 `);
+  if (nextCursor === null)
+    return body;
+  return `${body}
+${paint(mode, "dim", `\u2026 more \u2014 rerun with --cursor ${nextCursor}`)}`;
+}
+function asPage(data) {
+  if (Array.isArray(data))
+    return { rows: data, nextCursor: null };
+  if (data !== null && typeof data === "object" && "nextCursor" in data) {
+    const record2 = data;
+    if (Array.isArray(record2.data)) {
+      const nextCursor = typeof record2.nextCursor === "string" ? record2.nextCursor : null;
+      return { rows: record2.data, nextCursor };
+    }
+  }
+  return;
 }
 function renderRecord(data, mode) {
   if (data === null || typeof data !== "object")
@@ -25847,7 +25469,8 @@ async function dispatchEntity(entity, rest, flags, requireClient) {
       else if (f.required)
         throw usageError(`\`${entity.name} list\` requires --${f.name}`);
     }
-    return { data: await client.get(entity.path, { query }), render: renderList };
+    applyPageFlags(query, flags);
+    return { data: await client.getPage(entity.path, { query }), render: renderList };
   }
   if (op === "get") {
     if (!entity.canGet)
@@ -26015,7 +25638,8 @@ var HANDLERS = {
       status: flagString(flags, "status"),
       tag: flagString(flags, "tag")
     };
-    return { data: await requireClient().get("/collection", { query }), render: renderList };
+    applyPageFlags(query, flags);
+    return { data: await requireClient().getPage("/collection", { query }), render: renderList };
   },
   "collection add": async ({ args, flags, requireClient }) => {
     const { title, tags: tags2 } = parseTitleTags(args);
@@ -26229,6 +25853,19 @@ var HANDLERS = {
     render: () => `${CLI_NAME} ${VERSION}`
   })
 };
+function applyPageFlags(query, flags) {
+  const limit = flagString(flags, "limit");
+  if (limit !== undefined) {
+    const n = Number(limit);
+    if (!Number.isInteger(n) || n <= 0) {
+      throw usageError("--limit must be a positive integer");
+    }
+    query.limit = String(n);
+  }
+  const cursor = flagString(flags, "cursor");
+  if (cursor !== undefined)
+    query.cursor = cursor;
+}
 async function setModuleVisibility(args, requireClient, on) {
   const key = requireArg(args, 0, "module key");
   if (!isModuleKey(key)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.87.0",
+  "version": "1.89.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "type": "module",