@robbeverhelst/do 1.90.0 → 1.91.0

package/dist/do.js

@@ -25,7 +25,8 @@ var GLOBAL_BOOLEAN_FLAGS = [
   "verbose",
   "help",
   "version",
-  "allow-destructive"
+  "allow-destructive",
+  "dry-run"
 ];
 var SHORT_ALIASES = {
   h: "help",
@@ -24136,7 +24137,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.90.0";
+var VERSION = "1.91.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -24551,7 +24552,7 @@ function entityOperations(e) {
   if (e.write?.updateSchema)
     ops.push("update");
   if (e.write?.canDelete)
-    ops.push("delete");
+    ops.push("delete", "archive");
   return ops;
 }
 
@@ -24589,6 +24590,11 @@ var GLOBAL_FLAGS = [
     name: "allow-destructive",
     type: "boolean",
     description: "Permit a destructive verb (delete/revoke/remove-member). Off by default \u2014 a guardrail for autonomous agents."
+  },
+  {
+    name: "dry-run",
+    type: "boolean",
+    description: "Preview a create/update/delete/archive (prints before/after) without writing \u2014 for agent-driven cleanup."
   }
 ];
 var COMMAND_SPECS = [
@@ -25367,6 +25373,19 @@ function shortDate(iso) {
 
 // src/today.ts
 var OPEN_STATUSES = new Set(["todo", "in_progress"]);
+function isTaskLike(value) {
+  return typeof value === "object" && value !== null && typeof value.id === "string";
+}
+function normalizeTasks(response) {
+  if (Array.isArray(response))
+    return response.filter(isTaskLike);
+  if (response && typeof response === "object") {
+    const data = response.data;
+    if (Array.isArray(data))
+      return data.filter(isTaskLike);
+  }
+  return [];
+}
 function toDate(value) {
   if (value == null)
     return null;
@@ -25383,7 +25402,7 @@ var pad = (n) => String(n).padStart(2, "0");
 function selectToday(tasks3, now) {
   const { start, end, label } = localDayBounds(now);
   const items = [];
-  for (const task of tasks3) {
+  for (const task of normalizeTasks(tasks3)) {
     if (!OPEN_STATUSES.has(task.status))
       continue;
     const scheduled = toDate(task.scheduledAt);
@@ -25482,11 +25501,18 @@ async function dispatchEntity(entity, rest, flags, requireClient) {
     const id = requireArg(args, 0, "id");
     return { data: await client.get(`${entity.path}/${id}`), render: renderRecord };
   }
+  const dryRun = flagBool(flags, "dry-run");
   if (op === "create") {
     const write = requireWrite(entity, "create");
     if (!write.createSchema)
       throw usageError(`\`${entity.name}\` cannot be created`);
     const body = parseInput(write.createSchema, { id: ulid3(), ...readDataFlag(flags) });
+    if (dryRun) {
+      return {
+        data: { dryRun: true, op: "create", entity: entity.name, after: body },
+        render: renderRecord
+      };
+    }
     return { data: await client.post(entity.path, body), render: renderRecord };
   }
   if (op === "update") {
@@ -25495,16 +25521,42 @@ async function dispatchEntity(entity, rest, flags, requireClient) {
       throw usageError(`\`${entity.name}\` cannot be updated`);
     const id = requireArg(args, 0, "id");
     const body = parseInput(write.updateSchema, readDataFlag(flags));
+    if (dryRun) {
+      const before = entity.canGet ? await client.get(`${entity.path}/${id}`) : null;
+      return {
+        data: {
+          dryRun: true,
+          op: "update",
+          entity: entity.name,
+          id,
+          before,
+          after: mergePreview(before, body),
+          changes: body
+        },
+        render: renderRecord
+      };
+    }
     return { data: await client.patch(`${entity.path}/${id}`, body), render: renderRecord };
   }
-  if (op === "delete") {
-    const write = requireWrite(entity, "delete");
+  if (op === "delete" || op === "archive") {
+    const write = requireWrite(entity, op);
     if (!write.canDelete)
-      throw usageError(`\`${entity.name}\` cannot be deleted`);
+      throw usageError(`\`${entity.name}\` cannot be ${op}d`);
     const id = requireArg(args, 0, "id");
-    assertDestructiveAllowed(flags, `delete ${entity.name} ${id}`);
+    if (dryRun) {
+      const before = entity.canGet ? await client.get(`${entity.path}/${id}`) : null;
+      return {
+        data: { dryRun: true, op, entity: entity.name, id, before, softDelete: true },
+        render: renderRecord
+      };
+    }
+    if (op === "delete")
+      assertDestructiveAllowed(flags, `delete ${entity.name} ${id}`);
     await client.delete(`${entity.path}/${id}`);
-    return { data: { ok: true, deleted: id }, render: renderRecord };
+    return {
+      data: op === "archive" ? { ok: true, archived: id, softDelete: true } : { ok: true, deleted: id, softDelete: true },
+      render: renderRecord
+    };
   }
   throw usageError(`unknown operation for ${entity.name}: \`${op ?? ""}\` (use ${entityOperations(entity).join(", ")})`);
 }
@@ -25542,7 +25594,16 @@ var HANDLERS = {
     return { data: task, render: renderTask };
   },
   today: async ({ io, requireClient }) => {
-    const tasks3 = await requireClient().get("/tasks", { query: { filter: "all" } });
+    const client = requireClient();
+    const tasks3 = [];
+    let cursor;
+    do {
+      const page = await client.getPage("/tasks", {
+        query: { filter: "all", cursor }
+      });
+      tasks3.push(...page.data);
+      cursor = page.nextCursor ?? undefined;
+    } while (cursor);
     return {
       data: selectToday(tasks3, io.now()),
       render: renderToday
@@ -25949,6 +26010,13 @@ function requireWrite(entity, op) {
   }
   return entity.write;
 }
+function mergePreview(before, changes) {
+  const patch = changes && typeof changes === "object" && !Array.isArray(changes) ? changes : {};
+  if (before && typeof before === "object" && !Array.isArray(before)) {
+    return { ...before, ...patch };
+  }
+  return changes;
+}
 function readDataFlag(flags) {
   const raw = flagString(flags, "data");
   if (raw === undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.90.0",
+  "version": "1.91.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "type": "module",