@robbeverhelst/do 1.170.0 → 1.171.0

package/dist/do.js

@@ -3606,7 +3606,8 @@ var areas = pgTable("areas", {
   reviewCadence: reviewCadence("review_cadence"),
   archivedAt: timestamp("archived_at", { withTimezone: true }),
   purpose: text("purpose"),
-  standards: jsonb("standards").$type().notNull().default(sql`'[]'::jsonb`)
+  standards: jsonb("standards").$type().notNull().default(sql`'[]'::jsonb`),
+  restingUntil: date("resting_until", { mode: "string" })
 }, (t) => [
   index("areas_tenant_idx").on(t.tenantId),
   check("areas_standards_chk", sql`jsonb_typeof(${t.standards}) = 'array' AND jsonb_array_length(${t.standards}) <= 5`)
@@ -19217,16 +19218,18 @@ var createAreaInputSchema = createInsertSchema(areas, {
   id: ulidSchema,
   icon: areaIconSchema.nullish(),
   purpose: areaPurposeSchema.nullish()
-}).omit({ tenantId: true, archivedAt: true, standards: true }).extend({ title: string2().min(1) });
+}).omit({ tenantId: true, archivedAt: true, standards: true, restingUntil: true }).extend({ title: string2().min(1) });
 var updateAreaInputSchema = createUpdateSchema(areas, {
   icon: areaIconSchema.nullish(),
   archivedAt: exports_coerce.date().nullish(),
   purpose: areaPurposeSchema.nullish(),
-  standards: array(areaStandardInputSchema).max(5).optional()
+  standards: array(areaStandardInputSchema).max(5).optional(),
+  restingUntil: exports_iso.date().nullish()
 }).omit({ id: true, tenantId: true }).extend({ title: string2().min(1).optional() }).strict();
 var areaViewSchema = areaSchema.extend({
   title: string2(),
   archivedAt: exports_coerce.date().nullable().default(null),
+  restingUntil: exports_iso.date().nullable().default(null),
   createdAt: exports_coerce.date(),
   updatedAt: exports_coerce.date(),
   deletedAt: exports_coerce.date().nullable(),
@@ -19247,6 +19250,38 @@ var areaDetailSchema = areaViewSchema.extend({
   tasks: array(taskViewSchema),
   notes: array(noteViewSchema)
 });
+var areaOwnerLensSchema = _enum2(["mine", "agents", "all"]);
+var areaOverviewQuerySchema = object({
+  owner: areaOwnerLensSchema.default("mine")
+});
+var areaAttentionKindSchema = _enum2(["busier", "steady", "quiet", "resting"]);
+var areaAttentionSchema = object({
+  kind: areaAttentionKindSchema,
+  word: string2().min(1),
+  reason: string2().nullable()
+});
+var areaMovingLineSchema = object({
+  kind: _enum2(["project", "task", "habits"]),
+  id: string2().nullable(),
+  title: string2(),
+  detail: string2().nullable()
+});
+var areaOverviewItemSchema = object({
+  id: string2(),
+  title: string2(),
+  color: areaSchema.shape.color,
+  icon: string2().nullable(),
+  purpose: string2().nullable().default(null),
+  attention: areaAttentionSchema,
+  moving: array(areaMovingLineSchema).max(2),
+  waiting: number2().int().min(0),
+  standardsWorthALook: number2().int().min(0).default(0),
+  restingUntil: exports_iso.date().nullable()
+});
+var areaOverviewSchema = object({
+  owner: areaOwnerLensSchema,
+  areas: array(areaOverviewItemSchema)
+});
 
 // ../../packages/schema/src/presets/facets.ts
 var PANTRY_DISPLAY_KIND = "pantry";
@@ -21299,7 +21334,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.170.0";
+var VERSION = "1.171.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -22987,6 +23022,45 @@ var COMMAND_SPECS = [
     returns: "AreaDetail",
     notes: "DELETE /api/v1/areas/:id/standards/:standardId."
   },
+  {
+    path: ["areas", "overview"],
+    summary: "How each Area is going, in words: attention against its own usual, what's moving, and what waits on you.",
+    args: [],
+    flags: [
+      {
+        name: "owner",
+        type: "string",
+        description: "Whose work counts: mine (default; agents' work doesn't), agents or all."
+      }
+    ],
+    scopes: ["areas:read"],
+    returns: "AreaOverview",
+    notes: 'GET /api/v1/areas/overview. Words, never a score: "Busier than usual", "Steady", "Quiet for three weeks", "Resting", each with a short reason. The only count is what waits on you. Resting Areas come last.'
+  },
+  {
+    path: ["areas", "rest"],
+    summary: "Rest an Area until a day: it keeps everything and folds to the foot of the overview.",
+    args: [{ name: "id", required: true, description: "Area ULID." }],
+    flags: [
+      {
+        name: "until",
+        type: "string",
+        description: "The day it's back (YYYY-MM-DD). Required."
+      }
+    ],
+    scopes: ["areas:write"],
+    returns: "AreaView",
+    notes: "PATCH /api/v1/areas/{id} { restingUntil }. Between active and archived: its attention reads Resting, back in that month. Bring it back early with `do areas back`."
+  },
+  {
+    path: ["areas", "back"],
+    summary: "Bring a resting Area back today.",
+    args: [{ name: "id", required: true, description: "Area ULID." }],
+    flags: [],
+    scopes: ["areas:write"],
+    returns: "AreaView",
+    notes: "PATCH /api/v1/areas/{id} { restingUntil: null }. Nothing was lost while it rested."
+  },
   {
     path: ["places", "import"],
     summary: "Import the rooms of the house once from Gaard's house.json.",
@@ -23705,6 +23779,31 @@ function renderFromEarlier(data, mode) {
   ].join(`
 `);
 }
+function renderAreaOverview(data, mode) {
+  const d = data;
+  const all = d.areas ?? [];
+  if (all.length === 0)
+    return paint(mode, "dim", "No areas yet.");
+  const active = all.filter((a) => a.attention.kind !== "resting");
+  const resting = all.filter((a) => a.attention.kind === "resting");
+  const lens = d.owner === "agents" ? "Agents" : d.owner === "all" ? "All" : "Mine";
+  const out = [paint(mode, "bold", `Your areas \xB7 ${lens}`)];
+  for (const a of active) {
+    const waiting = a.waiting ? paint(mode, "yellow", `  ${a.waiting} waiting`) : "";
+    out.push(`  ${paint(mode, "bold", a.title)}${waiting}  ${paint(mode, "dim", a.id)}`);
+    if (a.purpose)
+      out.push(`    ${paint(mode, "dim", a.purpose)}`);
+    const reason = a.attention.reason ? paint(mode, "dim", ` \xB7 ${a.attention.reason}`) : "";
+    out.push(`    ${a.attention.word}${reason}`);
+    for (const m of a.moving ?? [])
+      out.push(`    \xB7 ${m.title}${m.detail ? `, ${m.detail}` : ""}`);
+  }
+  if (resting.length > 0) {
+    out.push("", paint(mode, "dim", `Resting: ${resting.map((a) => `${a.title}${a.attention.reason ? `, ${a.attention.reason.replace(/^B/, "b")}` : ""}`).join("; ")}.`));
+  }
+  return out.join(`
+`);
+}
 function renderFromEarlierAnswer(data, mode) {
   const d = data;
   const n = d.tasks ?? 0;
@@ -25200,6 +25299,27 @@ var HANDLERS = {
     const area = await requireClient().delete(`/areas/${id}/standards/${standard}`);
     return { data: area.standards ?? [], render: renderStandards };
   },
+  "areas overview": async ({ flags, requireClient }) => {
+    const owner = flagString(flags, "owner");
+    const query = parseInput(areaOverviewQuerySchema, owner ? { owner } : {});
+    return {
+      data: await requireClient().get("/areas/overview", { query }),
+      render: renderAreaOverview
+    };
+  },
+  "areas rest": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "area id");
+    const until = flagString(flags, "until");
+    if (!until)
+      throw usageError("areas rest needs --until <YYYY-MM-DD>, the day it's back");
+    const input = parseInput(updateAreaInputSchema, { restingUntil: until });
+    return { data: await requireClient().patch(`/areas/${id}`, input), render: renderRecord };
+  },
+  "areas back": async ({ args, requireClient }) => {
+    const id = requireArg(args, 0, "area id");
+    const input = parseInput(updateAreaInputSchema, { restingUntil: null });
+    return { data: await requireClient().patch(`/areas/${id}`, input), render: renderRecord };
+  },
   "places import": async ({ args, flags, requireClient }) => {
     const path = requireArg(args, 0, "house.json path");
     let file;

package/package.json

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