@robbeverhelst/do 1.48.0 → 1.50.0

package/dist/do.js

@@ -21567,32 +21567,37 @@ function parseCapture(input) {
   return { title, tags, ...priority ? { priority } : {}, ...area ? { area } : {} };
 }
 // ../../packages/schema/src/presets/collection-types.ts
+var coverUrl = exports_external.string().url().max(2048).nullish();
 var bookFacetSchema = exports_external.object({
   author: exports_external.string().min(1).max(200).nullish(),
-  coverUrl: exports_external.string().url().max(2048).nullish(),
+  coverUrl,
   pageCount: exports_external.number().int().min(1).max(1e5).nullish()
 }).strict();
-var stubFacetSchema = exports_external.object({}).strict();
-var ALL_STATUSES = collectionStatusValues;
-var DEFAULT_STATUS_LABELS = {
-  want: "Want",
-  have: "Have",
-  doing: "Doing",
-  done: "Done",
-  dropped: "Dropped"
-};
-function stubType(key, label, itemNoun) {
-  return {
-    key,
-    label,
-    itemNoun,
-    statuses: ALL_STATUSES,
-    statusLabels: DEFAULT_STATUS_LABELS,
-    facetSchema: stubFacetSchema,
-    view: "grid",
-    stub: true
-  };
-}
+var filmFacetSchema = exports_external.object({
+  kind: exports_external.enum(["movie", "show"]).nullish(),
+  year: exports_external.number().int().min(1888).max(2100).nullish(),
+  director: exports_external.string().min(1).max(200).nullish(),
+  coverUrl
+}).strict();
+var gameFacetSchema2 = exports_external.object({
+  platform: exports_external.string().min(1).max(120).nullish(),
+  coverUrl
+}).strict();
+var musicFacetSchema = exports_external.object({
+  artist: exports_external.string().min(1).max(200).nullish(),
+  year: exports_external.number().int().min(1860).max(2100).nullish(),
+  coverUrl
+}).strict();
+var placeFacetSchema2 = 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()
+}).strict();
+var wineFacetSchema = exports_external.object({
+  type: exports_external.enum(["wine", "whisky"]).nullish(),
+  region: exports_external.string().min(1).max(200).nullish(),
+  vintage: exports_external.number().int().min(1800).max(2100).nullish()
+}).strict();
 var COLLECTION_TYPES = {
   book: {
     key: "book",
@@ -21608,15 +21613,90 @@ var COLLECTION_TYPES = {
     },
     facetSchema: bookFacetSchema,
     view: "shelf",
+    subtitleKey: "author",
     lookupId: "open-library"
   },
-  film: stubType("film", "Films & TV", "title"),
-  game: stubType("game", "Games", "game"),
-  music: stubType("music", "Music", "album"),
-  place: stubType("place", "Places", "place"),
-  wine: stubType("wine", "Wines", "bottle")
+  film: {
+    key: "film",
+    label: "Films & TV",
+    itemNoun: "title",
+    statuses: ["want", "doing", "done", "dropped"],
+    statusLabels: { want: "Want", doing: "Watching", done: "Watched", dropped: "Dropped" },
+    facetSchema: filmFacetSchema,
+    view: "grid",
+    subtitleKey: "director",
+    lookupId: "tmdb"
+  },
+  game: {
+    key: "game",
+    label: "Games",
+    itemNoun: "game",
+    statuses: ["want", "have", "doing", "done", "dropped"],
+    statusLabels: {
+      want: "Want",
+      have: "Have",
+      doing: "Playing",
+      done: "Beaten",
+      dropped: "Dropped"
+    },
+    facetSchema: gameFacetSchema2,
+    view: "grid",
+    subtitleKey: "platform",
+    lookupId: "igdb"
+  },
+  music: {
+    key: "music",
+    label: "Music",
+    itemNoun: "album",
+    statuses: ["want", "done"],
+    statusLabels: { want: "Want", done: "Listened" },
+    facetSchema: musicFacetSchema,
+    view: "shelf",
+    subtitleKey: "artist"
+  },
+  place: {
+    key: "place",
+    label: "Places",
+    itemNoun: "place",
+    statuses: ["want", "done"],
+    statusLabels: { want: "Want", done: "Been" },
+    facetSchema: placeFacetSchema2,
+    view: "map",
+    subtitleKey: "address"
+  },
+  wine: {
+    key: "wine",
+    label: "Wines",
+    itemNoun: "bottle",
+    statuses: ["want", "have"],
+    statusLabels: { want: "Want", have: "Have" },
+    facetSchema: wineFacetSchema,
+    view: "grid",
+    subtitleKey: "region"
+  }
 };
 var COLLECTION_TYPE_LIST = collectionTypeValues.map((k) => COLLECTION_TYPES[k]);
+var collectionTypeSummarySchema = exports_external.object({
+  key: collectionTypeSchema,
+  label: exports_external.string(),
+  itemNoun: exports_external.string(),
+  statuses: exports_external.array(collectionStatusSchema),
+  statusLabels: exports_external.record(exports_external.string(), exports_external.string()),
+  view: collectionViewSchema,
+  lookupId: exports_external.string().nullable()
+});
+function toCollectionTypeSummary(config2) {
+  return {
+    key: config2.key,
+    label: config2.label,
+    itemNoun: config2.itemNoun,
+    statuses: [...config2.statuses],
+    statusLabels: { ...config2.statusLabels },
+    view: config2.view,
+    lookupId: config2.lookupId ?? null
+  };
+}
+var COLLECTION_TYPE_SUMMARIES = COLLECTION_TYPE_LIST.map(toCollectionTypeSummary);
 // ../../packages/schema/src/presets/recipe.ts
 var presetEntitySchema = exports_external.enum([
   "habit",
@@ -23635,7 +23715,7 @@ function parseCapture2(input) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.48.0";
+var VERSION = "1.50.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -24262,6 +24342,81 @@ var COMMAND_SPECS = [
     returns: "PresetInstallResult",
     notes: "Authors content as the caller, so it needs a key minted while logged in."
   },
+  {
+    path: ["collection", "types"],
+    summary: "List the catalog Types (key \xB7 label \xB7 status subset).",
+    args: [],
+    flags: [],
+    scopes: ["collections:read"],
+    returns: "CollectionTypeSummary",
+    notes: "The Type registry is code-defined (ADR 0017); served from GET /api/v1/collection/types."
+  },
+  {
+    path: ["collection", "list"],
+    summary: "List Collection Items, optionally sliced by Type / Status / tag.",
+    args: [],
+    flags: [
+      { name: "type", type: "string", description: "Filter to one Type (book|film|game|\u2026)." },
+      {
+        name: "status",
+        type: "string",
+        description: "Filter to one Status (want|have|doing|done|dropped)."
+      },
+      { name: "tag", type: "string", description: "Filter to Items carrying this tag." }
+    ],
+    scopes: ["collections:read"],
+    returns: "CollectionItemView"
+  },
+  {
+    path: ["collection", "add"],
+    summary: "Add a Collection Item (the title may embed #tag).",
+    args: [{ name: "title", required: true, description: "Item title; may embed #tag." }],
+    flags: [
+      { name: "type", type: "string", description: "Type (book|film|game|music|place|wine)." },
+      {
+        name: "status",
+        type: "string",
+        description: "Initial status; defaults to the Type's first."
+      }
+    ],
+    scopes: ["collections:write"],
+    returns: "CollectionItemView",
+    grammar: {
+      "#tag": "Adds a tag. Repeatable: '#scifi #2024'."
+    },
+    notes: "--type is required; the per-Type facet rides --data (validated server-side against the Type)."
+  },
+  {
+    path: ["collection", "set-status"],
+    summary: "Set a Collection Item's status (browse/filter spine).",
+    args: [
+      { name: "id", required: true, description: "Item ULID." },
+      {
+        name: "status",
+        required: true,
+        description: "want|have|doing|done|dropped (per-Type subset)."
+      }
+    ],
+    flags: [],
+    scopes: ["collections:write"],
+    returns: "CollectionItemView"
+  },
+  {
+    path: ["collection", "add-entry"],
+    summary: "Log a dated Entry against an Item (recomputes its headline rating).",
+    args: [{ name: "id", required: true, description: "Item ULID." }],
+    flags: [
+      { name: "rating", type: "string", description: "Rating 1\u20135 for this Entry." },
+      { name: "note", type: "string", description: "Free-text note for this Entry." },
+      {
+        name: "on",
+        type: "string",
+        description: "Day it occurred (YYYY-MM-DD); defaults to today."
+      }
+    ],
+    scopes: ["collections:write"],
+    returns: "CollectionItemDetail"
+  },
   {
     path: ["invite", "create"],
     summary: "Create a Space invite (email/link/guest).",
@@ -25018,6 +25173,55 @@ var HANDLERS = {
     const result = presetInstallResultSchema.parse(await requireClient().post(`/presets/${encodeURIComponent(key)}/install`, undefined));
     return { data: result, render: renderPresetInstall };
   },
+  "collection types": async ({ requireClient }) => {
+    const types2 = collectionTypeSummarySchema.array().parse(await requireClient().get("/collection/types"));
+    return { data: types2, render: renderList };
+  },
+  "collection list": async ({ flags, requireClient }) => {
+    const query = {
+      type: flagString(flags, "type"),
+      status: flagString(flags, "status"),
+      tag: flagString(flags, "tag")
+    };
+    return { data: await requireClient().get("/collection", { query }), render: renderList };
+  },
+  "collection add": async ({ args, flags, requireClient }) => {
+    const { title, tags } = parseTitleTags(args);
+    if (title.length === 0)
+      throw usageError('collection add needs a title, e.g. `do collection add "Dune" --type book`');
+    const type = requireFlag(flags, "type", "collection add needs --type <book|film|game|music|place|wine>");
+    const body = parseInput(createCollectionItemInputSchema, {
+      id: ulid3(),
+      type,
+      title,
+      ...tags.length > 0 ? { tags } : {},
+      ...flagString(flags, "status") ? { status: flagString(flags, "status") } : {}
+    });
+    return { data: await requireClient().post("/collection", body), render: renderRecord };
+  },
+  "collection set-status": async ({ args, requireClient }) => {
+    const id = requireArg(args, 0, "item id");
+    const status = requireArg(args, 1, "status");
+    const body = parseInput(updateCollectionItemInputSchema, { status });
+    return { data: await requireClient().patch(`/collection/${id}`, body), render: renderRecord };
+  },
+  "collection add-entry": async ({ args, flags, io, requireClient }) => {
+    const id = requireArg(args, 0, "item id");
+    const rating = flagString(flags, "rating");
+    if (rating !== undefined && Number.isNaN(Number(rating))) {
+      throw usageError("--rating must be a number (1\u20135)");
+    }
+    const body = parseInput(createCollectionEntryInputSchema, {
+      id: ulid3(),
+      occurredOn: flagString(flags, "on") ?? isoDay(io.now()),
+      ...rating !== undefined ? { rating: Number(rating) } : {},
+      ...flagString(flags, "note") ? { note: flagString(flags, "note") } : {}
+    });
+    return {
+      data: await requireClient().post(`/collection/${id}/entries`, body),
+      render: renderRecord
+    };
+  },
   "invite create": async ({ flags, requireClient }) => {
     const body = parseInput(createInviteInputSchema, { id: ulid3(), ...readDataFlag(flags) });
     return { data: await requireClient().post("/invites", body), render: renderRecord };
@@ -25203,6 +25407,22 @@ async function setModuleVisibility(args, requireClient, on) {
   const body = parseInput(updateUserSettingsInputSchema, { enabledModules });
   return { data: await client.patch("/settings", body), render: renderRecord };
 }
+function parseTitleTags(args) {
+  const titleWords = [];
+  const tags = [];
+  for (const token of args.join(" ").split(/\s+/).filter(Boolean)) {
+    if (token.length > 1 && token.startsWith("#"))
+      tags.push(token.slice(1));
+    else
+      titleWords.push(token);
+  }
+  return { title: titleWords.join(" ").trim(), tags };
+}
+function isoDay(date6) {
+  const month = String(date6.getMonth() + 1).padStart(2, "0");
+  const day = String(date6.getDate()).padStart(2, "0");
+  return `${date6.getFullYear()}-${month}-${day}`;
+}
 function requireArg(args, index2, name) {
   const value = args[index2];
   if (value === undefined || value.length === 0) {

package/package.json

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