@robbeverhelst/do 1.48.0 → 1.49.0

package/dist/do.js

@@ -21617,6 +21617,29 @@ var COLLECTION_TYPES = {
   wine: stubType("wine", "Wines", "bottle")
 };
 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(),
+  stub: exports_external.boolean()
+});
+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,
+    stub: config2.stub ?? false
+  };
+}
+var COLLECTION_TYPE_SUMMARIES = COLLECTION_TYPE_LIST.map(toCollectionTypeSummary);
 // ../../packages/schema/src/presets/recipe.ts
 var presetEntitySchema = exports_external.enum([
   "habit",
@@ -23635,7 +23658,7 @@ function parseCapture2(input) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.48.0";
+var VERSION = "1.49.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -24262,6 +24285,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 +25116,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 +25350,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.49.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "type": "module",