@robbeverhelst/do 1.173.0 → 1.174.0

package/dist/do.js

@@ -3736,6 +3736,9 @@ var userSettings = pgTable("user_settings", {
   backdrop: text("backdrop"),
   enabledModules: text("enabled_modules").array().notNull().default([]),
   autoRollOverdue: boolean("auto_roll_overdue").notNull().default(false),
+  pinnedAreaIds: text("pinned_area_ids").array().notNull().default([]),
+  focusAreaId: text("focus_area_id"),
+  focusUntil: timestamp("focus_until", { withTimezone: true }),
   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)]);
@@ -19606,7 +19609,11 @@ function setModuleEnabled(enabled, key, on) {
 }
 
 // ../../packages/schema/src/contracts/settings.ts
+var PINNED_AREAS_MAX = 5;
 var userSettingsSchema = createSelectSchema(userSettings, {
+  pinnedAreaIds: array(string2()).default([]),
+  focusAreaId: string2().nullable().default(null),
+  focusUntil: exports_coerce.date().nullable().default(null),
   createdAt: exports_coerce.date(),
   updatedAt: exports_coerce.date()
 }).omit({ autoRollOverdue: true });
@@ -19620,14 +19627,17 @@ var updateUserSettingsInputSchema = createUpdateSchema(userSettings, {
   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()
+  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()
 }).omit({
   id: true,
   tenantId: true,
   userId: true,
   createdAt: true,
   updatedAt: true,
-  autoRollOverdue: true
+  autoRollOverdue: true,
+  focusUntil: true
 }).strict();
 
 // ../../packages/schema/src/contracts/shopping.ts
@@ -21341,7 +21351,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.173.0";
+var VERSION = "1.174.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -23068,6 +23078,33 @@ var COMMAND_SPECS = [
     returns: "AreaView",
     notes: "PATCH /api/v1/areas/{id} { restingUntil: null }. Nothing was lost while it rested."
   },
+  {
+    path: ["areas", "focus"],
+    summary: "Focus on one Area for the rest of the day: Now, Tasks and Calendar show only it.",
+    args: [{ name: "id", required: false, description: "Area ULID (omit with --off)." }],
+    flags: [{ name: "off", type: "boolean", description: "Show everything again." }],
+    scopes: ["settings:write"],
+    returns: "UserSettings",
+    notes: "PATCH /api/v1/settings { focusAreaId }. Clears itself at the end of the member's day (focusUntil); hidden tasks don't move or go overdue."
+  },
+  {
+    path: ["areas", "pin"],
+    summary: "Pin an Area under Life in the desktop sidebar (up to five).",
+    args: [{ name: "id", required: true, description: "Area ULID." }],
+    flags: [],
+    scopes: ["settings:read", "settings:write"],
+    returns: "UserSettings",
+    notes: "Reads then patches settings.pinnedAreaIds; a pinned Area stays where it is."
+  },
+  {
+    path: ["areas", "unpin"],
+    summary: "Take an Area out of the desktop sidebar.",
+    args: [{ name: "id", required: true, description: "Area ULID." }],
+    flags: [],
+    scopes: ["settings:read", "settings:write"],
+    returns: "UserSettings",
+    notes: "Reads then patches settings.pinnedAreaIds."
+  },
   {
     path: ["places", "import"],
     summary: "Import the rooms of the house once from Gaard's house.json.",
@@ -25327,6 +25364,16 @@ var HANDLERS = {
     const input = parseInput(updateAreaInputSchema, { restingUntil: null });
     return { data: await requireClient().patch(`/areas/${id}`, input), render: renderRecord };
   },
+  "areas focus": async ({ args, flags, requireClient }) => {
+    const off = flagBool(flags, "off");
+    const id = off ? null : args[0];
+    if (id === undefined)
+      throw usageError("areas focus needs an area id, or --off to show everything");
+    const body = parseInput(updateUserSettingsInputSchema, { focusAreaId: id });
+    return { data: await requireClient().patch("/settings", body), render: renderRecord };
+  },
+  "areas pin": async ({ args, requireClient }) => setAreaPinned(args, requireClient, true),
+  "areas unpin": async ({ args, requireClient }) => setAreaPinned(args, requireClient, false),
   "places import": async ({ args, flags, requireClient }) => {
     const path = requireArg(args, 0, "house.json path");
     let file;
@@ -25545,6 +25592,16 @@ async function setModuleVisibility(args, requireClient, on) {
   const body = parseInput(updateUserSettingsInputSchema, { enabledModules });
   return { data: await client.patch("/settings", body), render: renderRecord };
 }
+async function setAreaPinned(args, requireClient, pinned) {
+  const id = requireArg(args, 0, "area id");
+  const client = requireClient();
+  const settings = await client.get("/settings");
+  const rest = (settings.pinnedAreaIds ?? []).filter((x) => x !== id);
+  const body = parseInput(updateUserSettingsInputSchema, {
+    pinnedAreaIds: pinned ? [...rest, id] : rest
+  });
+  return { data: await client.patch("/settings", body), render: renderRecord };
+}
 function parseTitleTags(args) {
   const titleWords = [];
   const tags = [];

package/package.json

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