@robbeverhelst/do 1.170.0 → 1.172.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.172.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -21536,7 +21571,7 @@ var ENTITIES = [
       DUE_BEFORE_FLAG,
       {
         name: "owner",
-        description: "owner: me, member:<id|email>, agent:<id|name>[/<desk>], any or none (agent:Echo = every desk)"
+        description: "owner: me, member:<id|email>, agent:<id|name>[/<desk>], any or none (agent:<name> = every desk)"
       },
       {
         name: "waitingOn",
@@ -21546,7 +21581,7 @@ var ENTITIES = [
       { name: "completedBefore", description: "finished before this instant (ISO or date)" },
       {
         name: "proposed",
-        description: "only tasks Proposed by Echo (made by an Agent for a member, not accepted yet); --proposed=false for only the plan",
+        description: "only tasks Proposed by the agent (made by an Agent for a member, not accepted yet); --proposed=false for only the plan",
         boolean: true
       },
       {
@@ -22053,7 +22088,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["tasks", "accept"],
-    summary: "Accept a task Proposed by Echo: it joins the plan as suggested (day, Deadline, Area kept).",
+    summary: "Accept a task Proposed by the agent: it joins the plan as suggested (day, Deadline, Area kept).",
     args: [{ name: "id", required: true, description: "Task ULID." }],
     flags: [],
     scopes: ["tasks:write"],
@@ -22062,7 +22097,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["tasks", "dismiss"],
-    summary: "Not now on a task Proposed by Echo: it leaves the Inbox for a week, still proposed.",
+    summary: "Not now on a task Proposed by the agent: it leaves the Inbox for a week, still proposed.",
     args: [{ name: "id", required: true, description: "Task ULID." }],
     flags: [],
     scopes: ["tasks:write"],
@@ -22150,7 +22185,7 @@ var COMMAND_SPECS = [
     ],
     scopes: ["habits:write"],
     returns: "HabitSummary",
-    notes: `POST /api/v1/habits/check-in. Title or alias, case-insensitive; several matches \u2192 409 with error.details.candidates (id, title, aliases), none \u2192 404 naming close titles; a habit counted from Google Fit, Strava or GitHub \u2192 409. --set writes the difference to the day's total as its own check-in. An Agent's key records the check-in as that Agent's ("Echo, 07:12"). --note puts a short note on it ("drill done, felt heavy" \u2192 --note "felt heavy"); the reply's lastCheckIn.id is the check-in, for \`do habit note\` later.`
+    notes: `POST /api/v1/habits/check-in. Title or alias, case-insensitive; several matches \u2192 409 with error.details.candidates (id, title, aliases), none \u2192 404 naming close titles; a habit counted from Google Fit, Strava or GitHub \u2192 409. --set writes the difference to the day's total as its own check-in. An Agent's key records the check-in as that Agent's ("<agent>, 07:12"). --note puts a short note on it ("drill done, felt heavy" \u2192 --note "felt heavy"); the reply's lastCheckIn.id is the check-in, for \`do habit note\` later.`
   },
   {
     path: ["habit", "alias", "add"],
@@ -22434,7 +22469,7 @@ var COMMAND_SPECS = [
     ],
     scopes: ["orca:write"],
     returns: "OrcaSendMessageResult",
-    notes: "An Agent's key gets a 428 confirmation_required; it runs once the member confirms in the Echo panel (#678)."
+    notes: "An Agent's key gets a 428 confirmation_required; it runs once the member confirms in do's agent panel (#678)."
   },
   {
     path: ["orca", "restart"],
@@ -22522,7 +22557,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["agent", "connection", "get"],
-    summary: "Show the agent runtime the Echo panel's chat goes to (never its key).",
+    summary: "Show the agent runtime the agent panel's chat goes to (never its key).",
     args: [],
     flags: [],
     scopes: ["agents:read"],
@@ -22531,7 +22566,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["agent", "connection", "set"],
-    summary: "Point the Echo panel at an agent runtime (replaces the connection).",
+    summary: "Point the agent panel at an agent runtime (replaces the connection).",
     args: [],
     flags: [
       { name: "endpoint", type: "string", description: "The runtime's base URL (required)." },
@@ -22548,9 +22583,9 @@ var COMMAND_SPECS = [
       {
         name: "auto-file",
         type: "boolean",
-        description: "Let Echo file new captures (needs --agent)."
+        description: "Let the agent file new captures (needs --agent)."
       },
-      { name: "no-auto-file", type: "boolean", description: "Stop Echo filing new captures." },
+      { name: "no-auto-file", type: "boolean", description: "Stop the agent filing new captures." },
       {
         name: "key-stdin",
         type: "boolean",
@@ -22571,7 +22606,7 @@ var COMMAND_SPECS = [
     ],
     scopes: ["agents:write"],
     returns: "None",
-    notes: "Owner/admin only. An Agent's key gets a 428 confirmation_required until the member confirms in the Echo panel."
+    notes: "Owner/admin only. An Agent's key gets a 428 confirmation_required until the member confirms in do's agent panel."
   },
   {
     path: ["agent", "post"],
@@ -22664,7 +22699,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["echo", "threads", "list"],
-    summary: "List your recent Echo threads, newest first.",
+    summary: "List your recent agent threads, newest first.",
     args: [],
     flags: [{ name: "limit", type: "string", description: "How many, 1\u201350 (default 10)." }],
     scopes: ["agents:read"],
@@ -22673,7 +22708,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["echo", "threads", "current"],
-    summary: "Show the Echo thread the panel opens on, with its turns.",
+    summary: "Show the agent thread the panel opens on, with its turns.",
     args: [],
     flags: [],
     scopes: ["agents:read"],
@@ -22682,7 +22717,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["echo", "threads", "show"],
-    summary: "Show one of your Echo threads, with its turns.",
+    summary: "Show one of your agent threads, with its turns.",
     args: [{ name: "id", required: true, description: "Thread ULID (see `echo threads list`)." }],
     flags: [],
     scopes: ["agents:read"],
@@ -22691,7 +22726,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["echo", "threads", "new"],
-    summary: "Start a new Echo conversation (it becomes the current thread).",
+    summary: "Start a new agent conversation (it becomes the current thread).",
     args: [],
     flags: [],
     scopes: ["agents:write"],
@@ -22958,7 +22993,7 @@ var COMMAND_SPECS = [
     flags: STANDARD_LINK_FLAGS,
     scopes: ["areas:write"],
     returns: "AreaDetail",
-    notes: "POST /api/v1/areas/:id/standards. Echo adds standards only after the member said yes; the change list keeps Undo."
+    notes: "POST /api/v1/areas/:id/standards. The agent adds standards only after the member said yes; the change list keeps Undo."
   },
   {
     path: ["areas", "standards", "link"],
@@ -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.",
@@ -23630,7 +23704,7 @@ function suggestionText(s) {
     s.owner ? `owner ${ownerText(s.owner)}` : null,
     s.scheduledAt ? shortDate(s.scheduledAt) : null
   ].filter(Boolean);
-  return `${s.by?.name ?? "Echo"} suggests ${parts.join(", ")}`;
+  return `${s.by?.name ?? "The agent"} suggests ${parts.join(", ")}`;
 }
 function worktreeText(link) {
   const where = link.branch ?? link.path ?? link.worktreeId ?? "";
@@ -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;
@@ -24029,7 +24128,7 @@ function renderEchoThread(data, mode) {
   const wrapped = data;
   const thread = wrapped && typeof wrapped === "object" && "thread" in wrapped ? wrapped.thread : data;
   if (!thread)
-    return paint(mode, "dim", "No Echo thread yet.");
+    return paint(mode, "dim", "No thread yet.");
   const head = `${thread.title ?? "New conversation"}  ${paint(mode, "dim", thread.id ?? "")}`;
   const turns = thread.turns ?? [];
   const posts = thread.posts ?? [];
@@ -24045,7 +24144,7 @@ ${paint(mode, "dim", "(nothing asked yet)")}`;
         order: i,
         lines: [
           `  ${paint(mode, "bold", "You")}   ${t.question ?? ""}`,
-          `  ${paint(mode, "bold", "Echo")}  ${t.reply ?? ""}${paint(mode, "dim", note)}`
+          `  ${paint(mode, "bold", "Agent")}  ${t.reply ?? ""}${paint(mode, "dim", note)}`
         ]
       };
     }),
@@ -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.172.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",