@robbeverhelst/do 1.339.1 → 1.340.0

package/dist/do.js

@@ -14418,7 +14418,7 @@ var configError = (message) => new CliError("config", message, EXIT.CONFIG);
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.339.1";
+var VERSION = "1.340.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -24062,6 +24062,39 @@ var calendarOperations = defineOperations({
     status: 200,
     response: { description: "The event, after.", view: "Event" },
     errors: { 400: true, 404: true }
+  },
+  status: {
+    method: "get",
+    path: "/calendar/status",
+    scopes: ["calendar:read"],
+    tag: "Calendar",
+    summary: "Calendar connection status",
+    description: "Each of the member's calendar connections: its `status` and `health` (`ok` \xB7 `retrying` \xB7 `reconnect` \xB7 `pending`), `lastError`, when do last wrote to its calendar (`lastPushAt`) and last pulled from it (`lastSyncAt`). `retrying` means a passing failure; the background sweep tries again. `reconnect` means the member has to reconnect in Settings. Needs a key that acts for a member.",
+    status: 200,
+    response: { description: "One entry per calendar connection.", list: true },
+    errors: { 400: true }
+  },
+  push: {
+    method: "post",
+    path: "/calendar/push",
+    scopes: ["calendar:write"],
+    tag: "Calendar",
+    summary: "Push to the calendar now",
+    description: "Reconcile do's placements (timed tasks, deadlines, Time blocks, timed routine occurrences) onto do's own calendar in each of the member's usable connections, now rather than at the next sweep. Idempotent: a settled calendar is all `skipped`. A connection that needs reconnecting is left out. Needs a key that acts for a member.",
+    status: 200,
+    response: { description: "One push result per connection.", list: true },
+    errors: { 400: true }
+  },
+  refresh: {
+    method: "post",
+    path: "/calendar/refresh",
+    scopes: ["calendar:write"],
+    tag: "Calendar",
+    summary: "Sync the calendar now",
+    description: "Pull each of the member's calendar connections into do's mirror now (however recently it last synced), then push do's placements out. Returns `{ mirrored, pushed }`. Needs a key that acts for a member.",
+    status: 200,
+    response: { description: "What the pull and the push moved." },
+    errors: { 400: true }
   }
 });
 
@@ -41116,6 +41149,43 @@ function renderEvents(data, mode) {
   return events.map((e) => renderEvent(e, mode)).join(`
 `);
 }
+var CALENDAR_HEALTH = {
+  ok: "ok",
+  retrying: "retrying (a passing failure; the sweep tries again)",
+  reconnect: "needs reconnecting in Settings",
+  pending: "never finished connecting"
+};
+function renderCalendarStatus(data, mode) {
+  const rows = data ?? [];
+  if (rows.length === 0)
+    return paint(mode, "dim", "No calendar connected.");
+  const at = (iso) => iso ? shortDate(iso) : "never";
+  return rows.map((s) => {
+    const health = CALENDAR_HEALTH[s.health ?? ""] ?? s.health ?? "?";
+    const lines = [
+      `${paint(mode, "bold", s.account ?? s.provider ?? "calendar")} \u2014 ${health}`,
+      `  last push ${at(s.lastPushAt)} \xB7 last sync ${at(s.lastSyncAt)}`,
+      ...s.lastError ? [`  ${paint(mode, "dim", s.lastError)}`] : [],
+      `  ${paint(mode, "dim", s.connectionId)}`
+    ];
+    return lines.join(`
+`);
+  }).join(`
+`);
+}
+function renderCalendarPush(data, mode) {
+  const rows = data ?? [];
+  if (rows.length === 0)
+    return paint(mode, "dim", "No calendar to push to.");
+  return rows.map((p) => p.error ? `${p.connectionId}: not pushed \u2014 ${p.error}` : `${p.connectionId}: ${p.created ?? 0} created \xB7 ${p.updated ?? 0} updated \xB7 ${p.deleted ?? 0} removed \xB7 ${p.skipped ?? 0} already in sync${p.failed ? ` \xB7 ${p.failed} failed` : ""}`).join(`
+`);
+}
+function renderCalendarRefresh(data, mode) {
+  const r = data;
+  const pulled = (r.mirrored ?? []).map((m) => `${m.connectionId}: pulled ${m.created ?? 0} new \xB7 ${m.updated ?? 0} changed \xB7 ${m.cancelled ?? 0} cancelled`);
+  return [...pulled, renderCalendarPush(r.pushed ?? [], mode)].join(`
+`);
+}
 
 // src/command-helpers.ts
 function applyPageFlags(query, flags) {
@@ -42806,6 +42876,51 @@ var commands5 = [
         render: renderEvent
       };
     }
+  },
+  {
+    spec: {
+      path: ["calendar", "status"],
+      summary: "How each of the member's calendar connections is doing: ok, retrying or needs reconnecting, the last failure, and when do last pushed to and synced from it.",
+      args: [],
+      flags: [],
+      scopes: [...calendarOperations.status.scopes],
+      returns: "CalendarConnectionStatus[]",
+      notes: `${routeOf(calendarOperations.status)}. retrying = a passing failure the sweep retries; reconnect = the member reconnects in Settings. Needs a key that acts for a member.`
+    },
+    run: async ({ requireClient }) => ({
+      data: await requireClient().get(pathOf(calendarOperations.status)),
+      render: renderCalendarStatus
+    })
+  },
+  {
+    spec: {
+      path: ["calendar", "push"],
+      summary: "Push do's timed tasks, deadlines, Time blocks and routines to the member's calendar now. Idempotent.",
+      args: [],
+      flags: [],
+      scopes: [...calendarOperations.push.scopes],
+      returns: "CalendarPushResult[]",
+      notes: `${routeOf(calendarOperations.push)}. A connection that needs reconnecting is left out. Needs a key that acts for a member.`
+    },
+    run: async ({ requireClient }) => ({
+      data: await requireClient().post(pathOf(calendarOperations.push), {}),
+      render: renderCalendarPush
+    })
+  },
+  {
+    spec: {
+      path: ["calendar", "refresh"],
+      summary: "Sync the member's calendar now: pull their calendars into do, then push do's placements out.",
+      args: [],
+      flags: [],
+      scopes: [...calendarOperations.refresh.scopes],
+      returns: "{ mirrored, pushed }",
+      notes: `${routeOf(calendarOperations.refresh)}. Pulls however recently it last synced. Needs a key that acts for a member.`
+    },
+    run: async ({ requireClient }) => ({
+      data: await requireClient().post(pathOf(calendarOperations.refresh), {}),
+      render: renderCalendarRefresh
+    })
   }
 ];
 

package/package.json

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