ente-cli 0.4.68 → 0.4.70

package/dist/cli.mjs

@@ -3710,8 +3710,97 @@ function warn(opts, latest) {
   );
 }
 
+// core/errors.ts
+var ApiError = class extends Error {
+  statusCode;
+  error;
+  constructor(statusCode, message, error) {
+    super(`HTTP ${statusCode}: ${message}`);
+    this.name = "ApiError";
+    this.statusCode = statusCode;
+    this.detail = message;
+    this.error = error ?? {};
+  }
+  /** The backend's human message, without the `HTTP <code>:` prefix. */
+  detail;
+};
+var ExitWithCode = class extends Error {
+  code;
+  constructor(code2) {
+    super(`exit ${code2}`);
+    this.name = "ExitWithCode";
+    this.code = code2;
+  }
+};
+
+// core/output.ts
+function emit(stdout, data, json, rowsFn, headers) {
+  if (json || !rowsFn) {
+    stdout.write(`${JSON.stringify(data, null, 2)}
+`);
+    return;
+  }
+  stdout.write(`${renderTable(rowsFn(data), headers)}
+`);
+}
+function errorMessage(err) {
+  if (!(err instanceof Error)) return String(err);
+  const data = err.data;
+  if (typeof data === "string" && data.length > 0) return data;
+  if (data && typeof data === "object") {
+    const { message, code: code2 } = data;
+    if (typeof message === "string" && message.length > 0) {
+      return typeof code2 === "string" ? `${message} (${code2})` : message;
+    }
+    return `${err.message}: ${JSON.stringify(data)}`;
+  }
+  return err.message;
+}
+function renderTable(rows, headers) {
+  if (rows.length === 0) return "(none)";
+  const cols = headers ?? Object.keys(rows[0] ?? {});
+  const widths = cols.map((c) => Math.max(c.length, ...rows.map((r) => (r[c] ?? "").length)));
+  const line = (cells) => cells.map((cell, i) => cell.padEnd(widths[i] ?? 0)).join("  ").trimEnd();
+  const out = [line(cols), line(cols.map((_, i) => "\u2500".repeat(widths[i] ?? 0)))];
+  for (const r of rows) out.push(line(cols.map((c) => r[c] ?? "")));
+  return out.join("\n");
+}
+
+// core/errorOutput.ts
+function writeCommandError(stdout, stderr, json, error) {
+  if (!json) {
+    stderr.write(`Error: ${errorMessage(error)}
+`);
+    return;
+  }
+  const data = error instanceof ApiError ? error.error : error instanceof Error && "data" in error ? error.data : void 0;
+  const details = data && typeof data === "object" && !Array.isArray(data) ? data : {};
+  stdout.write(`${JSON.stringify({ error: {
+    ...details,
+    message: errorMessage(error),
+    ...error instanceof ApiError ? { statusCode: error.statusCode } : {}
+  } }, null, 2)}
+`);
+}
+
+// core/run.ts
+async function runCli(cli2, argv, context) {
+  try {
+    const command = cli2.process(argv, context);
+    return await cli2.run(command, context);
+  } catch (error) {
+    writeCommandError(
+      context.stdout,
+      context.stderr,
+      argv.includes("--json"),
+      argv.includes("--json") ? new Error("Invalid command or options. Run 'ente <command> --help' for usage.") : error
+    );
+    return 1;
+  }
+}
+
 // ente/version.ts
-var VERSION = "0.4.68";
+var VERSION = "0.4.70";
 
 // ente/branding.ts
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -3842,62 +3931,6 @@ function deleteJwt(cacheDir, key) {
   return true;
 }
 
-// core/errors.ts
-var ApiError = class extends Error {
-  statusCode;
-  error;
-  constructor(statusCode, message, error) {
-    super(`HTTP ${statusCode}: ${message}`);
-    this.name = "ApiError";
-    this.statusCode = statusCode;
-    this.detail = message;
-    this.error = error ?? {};
-  }
-  /** The backend's human message, without the `HTTP <code>:` prefix. */
-  detail;
-};
-var ExitWithCode = class extends Error {
-  code;
-  constructor(code2) {
-    super(`exit ${code2}`);
-    this.name = "ExitWithCode";
-    this.code = code2;
-  }
-};
-
-// core/output.ts
-function emit(stdout, data, json, rowsFn, headers) {
-  if (json || !rowsFn) {
-    stdout.write(`${JSON.stringify(data, null, 2)}
-`);
-    return;
-  }
-  stdout.write(`${renderTable(rowsFn(data), headers)}
-`);
-}
-function errorMessage(err) {
-  if (!(err instanceof Error)) return String(err);
-  const data = err.data;
-  if (typeof data === "string" && data.length > 0) return data;
-  if (data && typeof data === "object") {
-    const { message, code: code2 } = data;
-    if (typeof message === "string" && message.length > 0) {
-      return typeof code2 === "string" ? `${message} (${code2})` : message;
-    }
-    return `${err.message}: ${JSON.stringify(data)}`;
-  }
-  return err.message;
-}
-function renderTable(rows, headers) {
-  if (rows.length === 0) return "(none)";
-  const cols = headers ?? Object.keys(rows[0] ?? {});
-  const widths = cols.map((c) => Math.max(c.length, ...rows.map((r) => (r[c] ?? "").length)));
-  const line = (cells) => cells.map((cell, i) => cell.padEnd(widths[i] ?? 0)).join("  ").trimEnd();
-  const out = [line(cols), line(cols.map((_, i) => "\u2500".repeat(widths[i] ?? 0)))];
-  for (const r of rows) out.push(line(cols.map((c) => r[c] ?? "")));
-  return out.join("\n");
-}
-
 // core/command.ts
 var BaseCommand = class extends Command {
   json = options_exports.Boolean("--json", false, {
@@ -3935,8 +3968,7 @@ var BaseCommand = class extends Command {
       return typeof code2 === "number" ? code2 : 0;
     } catch (err) {
       if (err instanceof ExitWithCode) return err.code;
-      this.context.stderr.write(`Error: ${errorMessage(err)}
-`);
+      writeCommandError(this.context.stdout, this.context.stderr, this.json, err);
       return 1;
     }
   }
@@ -4750,6 +4782,12 @@ ${footer}` : body;
   }
   // --- shared: activity list (used by `activity list` and `tasks`) --------
   async runActivityList(opts) {
+    if ((opts.compact || opts.cursor !== void 0) && (!opts.entity || opts.typeFilter || opts.onlyOpen || opts.attrFilter?.length || opts.sort && opts.sort !== "created")) {
+      throw new Error("--compact/--cursor require --entity and cannot combine with --type, --only-open, --attr or --sort deadline. Use an unfiltered page, then inspect full details.");
+    }
+    if (opts.minCount !== void 0 && (!Number.isSafeInteger(opts.minCount) || opts.minCount < 0 || !opts.entity || opts.typeFilter || opts.onlyOpen || opts.attrFilter?.length)) {
+      throw new Error("--min-count requires an unfiltered entity-scoped page and a nonnegative integer. Use 0 for a strict time window.");
+    }
     if (opts.sort && !VALID_SORT.has(opts.sort)) {
       throw new Error(`Invalid --sort value '${opts.sort}'. Allowed: deadline, created`);
     }
@@ -4795,6 +4833,8 @@ ${footer}` : body;
     const hasClientFilters = !!(opts.typeFilter || opts.onlyOpen || opts.attrFilter && opts.attrFilter.length);
     let activities;
     let serverHasMore;
+    let nextCursor;
+    let projection;
     if (hasClientFilters) {
       const hoursCutoff = opts.hours ? Date.now() - opts.hours * 36e5 : void 0;
       activities = [];
@@ -4840,9 +4880,14 @@ ${footer}` : body;
       if (opts.limit) params.limit = String(opts.limit);
       if (opts.before !== void 0) params.before = String(opts.before);
       if (opts.after !== void 0) params.after = String(opts.after);
+      if (opts.cursor !== void 0) params.cursor = opts.cursor;
+      if (opts.compact) params.compact = "true";
+      if (opts.minCount !== void 0) params.minCount = String(opts.minCount);
       const res = await client.listActivities(params);
       activities = res.data ?? [];
       serverHasMore = res.hasMore;
+      nextCursor = res.nextCursor;
+      projection = res.projection;
     }
     if (opts.typeFilter) activities = activities.filter((a) => a.type === opts.typeFilter);
     if (opts.onlyOpen) activities = activities.filter((a) => !a.completed);
@@ -4863,14 +4908,20 @@ ${footer}` : body;
     const hasMore = hasClientFilters ? void 0 : serverHasMore;
     const jsonData = { data: activities };
     if (hasMore !== void 0) jsonData.hasMore = hasMore;
+    if (nextCursor !== void 0) jsonData.nextCursor = nextCursor;
+    if (projection !== void 0) jsonData.projection = projection;
     this.emitText(jsonWithSpaces(jsonData, spaces), () => {
       let body = formatActivityList(activities);
-      if (hasMore && activities.length) {
-        const oldest = activities[activities.length - 1];
+      if (hasMore && nextCursor) {
         body += `
 
-(more results available \u2014 use --before ${oldest.createdAt})`;
+(more results available \u2014 use --cursor '${nextCursor.replaceAll("'", "'\\''")}' with the same --entity and filters)`;
+      } else if (hasMore && activities.length) {
+        body += `
+
+(more results available \u2014 use --before ${activities[activities.length - 1].createdAt})`;
       }
+      if (projection) body += "\n\nCompact excerpts. Full detail: ente activity get <activityId> --json";
       return this.withFooter(body, spaces);
     });
   }
@@ -11115,14 +11166,12 @@ var AuthLogin = class extends BaseCommand {
     try {
       resp = await validateExternalCredential(cleanUrl, key, controller.signal);
     } catch {
-      this.err(`Could not reach ${cleanUrl}`);
-      return 1;
+      throw new Error(`Could not reach ${cleanUrl}`);
     } finally {
       clearTimeout(timer);
     }
     if (resp.status >= 400) {
-      this.err(`Authentication failed: ${resp.status} ${resp.statusText}`);
-      return 1;
+      throw new Error(`Authentication failed: ${resp.status} ${resp.statusText}`);
     }
     const previous = readCredentialsForCleanup(this.profile);
     if (previous) {
@@ -11818,6 +11867,7 @@ var EntityCreate = class extends ProfileCommand {
     const spaces = await spacesFooterFromMemberships(caller);
     const jsonOut = { data: { entityId } };
     if (pinFailures.length) {
+      jsonOut.error = { message: "Entity created, but some parent relationships failed.", code: "PARTIAL_SUCCESS" };
       jsonOut.data = {
         entityId,
         pinFailures: pinFailures.map(([target, error]) => ({ target, error })),
@@ -11843,6 +11893,13 @@ Pinned to: ${pinSucceeded.join(", ")}`;
     }
   }
 };
+var EntityShowCorrection = class extends ProfileCommand {
+  static paths = [["entity", "show"]];
+  nameOrId = options_exports.String();
+  async run() {
+    throw new Error("Use 'ente entity get <name-or-id>' to read entity details.");
+  }
+};
 var EntityGet = class extends ProfileCommand {
   static paths = [["entity", "get"]];
   static usage = Command.Usage({ category: "Entity", description: "Get entity details" });
@@ -11926,10 +11983,9 @@ var EntityUpdate = class extends ProfileCommand {
       didSomething = true;
     }
     if (!didSomething) {
-      this.err(
+      throw new Error(
         "Nothing to update. Specify --name, --alias-add, --alias-remove, --attr, --tag, or --description."
       );
-      return 1;
     }
     const spaces = await spacesFooterFromMemberships(caller);
     this.emitText(
@@ -12215,6 +12271,7 @@ var EntityHtmlUpdate = class extends ProfileCommand {
   }
 };
 var ENTITY_COMMANDS = [
+  EntityShowCorrection,
   EntityList,
   EntityCreate,
   EntityGet,
@@ -12247,6 +12304,96 @@ function readContentOption(content, contentFile) {
   return void 0;
 }
 
+// ente/deadline.ts
+var DEFAULT_HOUR = 22;
+var DEFAULT_MINUTE = 0;
+function addDaysToBerlinToday(days) {
+  const t = berlinToday();
+  const dt = new Date(Date.UTC(t.year, t.month - 1, t.day) + days * 864e5);
+  return { year: dt.getUTCFullYear(), month: dt.getUTCMonth() + 1, day: dt.getUTCDate() };
+}
+function parseTimeOrDefault(s) {
+  if (!s) return [DEFAULT_HOUR, DEFAULT_MINUTE];
+  const m = /^(\d{1,2}):(\d{2})$/.exec(s);
+  if (!m) throw new Error(`Invalid time format: '${s}'. Use HH:MM (e.g. 14:00).`);
+  const hour = Number(m[1]);
+  const minute = Number(m[2]);
+  if (hour > 23 || minute > 59) throw new Error(`Invalid time format: '${s}'.`);
+  return [hour, minute];
+}
+function validateDate(year, month, day, original) {
+  if (month < 1 || month > 12 || day < 1 || day > 31) {
+    throw new Error(`Invalid date: '${original}'.`);
+  }
+  const d = new Date(Date.UTC(year, month - 1, day));
+  if (d.getUTCFullYear() !== year || d.getUTCMonth() + 1 !== month || d.getUTCDate() !== day) {
+    throw new Error(`Invalid date: '${original}' \u2014 day ${day} does not exist in month ${month}.`);
+  }
+}
+function parseDeadline(input) {
+  const trimmed = input.trim().toLowerCase();
+  if (trimmed.startsWith("tomorrow")) {
+    const [hour, minute] = parseTimeOrDefault(trimmed.slice("tomorrow".length).trim());
+    const t = addDaysToBerlinToday(1);
+    return berlinToEpochMs(t.year, t.month, t.day, hour, minute);
+  }
+  if (trimmed.startsWith("today")) {
+    const [hour, minute] = parseTimeOrDefault(trimmed.slice("today".length).trim());
+    const t = addDaysToBerlinToday(0);
+    return berlinToEpochMs(t.year, t.month, t.day, hour, minute);
+  }
+  const rel = /^\+(\d+)\s*(days?|weeks?)$/.exec(trimmed);
+  if (rel) {
+    const n = Number(rel[1]);
+    const days = rel[2].startsWith("week") ? n * 7 : n;
+    const t = addDaysToBerlinToday(days);
+    return berlinToEpochMs(t.year, t.month, t.day, DEFAULT_HOUR, DEFAULT_MINUTE);
+  }
+  const iso = /^(\d{4})-(\d{2})-(\d{2})t(\d{2}):(\d{2})(?::(\d{2}))?(?:z|([+-])(\d{2}):(\d{2}))$/.exec(
+    trimmed
+  );
+  if (iso) {
+    const year = Number(iso[1]);
+    const month = Number(iso[2]);
+    const day = Number(iso[3]);
+    const hour = Number(iso[4]);
+    const minute = Number(iso[5]);
+    const second = iso[6] ? Number(iso[6]) : 0;
+    validateDate(year, month, day, input);
+    if (hour > 23 || minute > 59 || second > 59) throw new Error(`Invalid time in deadline: '${input}'.`);
+    let offsetMs = 0;
+    if (iso[7]) {
+      const sign = iso[7] === "-" ? -1 : 1;
+      offsetMs = sign * (Number(iso[8]) * 60 + Number(iso[9])) * 6e4;
+    }
+    return Date.UTC(year, month - 1, day, hour, minute, second) - offsetMs;
+  }
+  const date = /^(\d{4})-(\d{2})-(\d{2})(?:\s+(\d{1,2}):(\d{2}))?$/.exec(trimmed);
+  if (date) {
+    const year = Number(date[1]);
+    const month = Number(date[2]);
+    const day = Number(date[3]);
+    validateDate(year, month, day, input);
+    const hour = date[4] ? Number(date[4]) : DEFAULT_HOUR;
+    const minute = date[5] ? Number(date[5]) : DEFAULT_MINUTE;
+    if (hour > 23 || minute > 59) throw new Error(`Invalid time in deadline: '${input}'.`);
+    return berlinToEpochMs(year, month, day, hour, minute);
+  }
+  throw new Error(
+    `Cannot parse deadline '${input}'. Accepted: "tomorrow", "today", "+3 days", "+1 week", "2026-03-15", "2026-03-15 14:00", "2026-03-15T14:00:00+01:00"`
+  );
+}
+function defaultDeadline() {
+  const t = addDaysToBerlinToday(1);
+  return berlinToEpochMs(t.year, t.month, t.day, DEFAULT_HOUR, DEFAULT_MINUTE);
+}
+function deadlineChange(deadline, clear) {
+  if (clear && deadline !== void 0) throw new Error("Use either --deadline or --clear-deadline, not both.");
+  if (clear) return { deadline: void 0 };
+  if (deadline !== void 0) return { deadline: parseDeadline(deadline) };
+  return null;
+}
+
 // ente/fileAttachments.ts
 import { readFileSync as readFileSync8 } from "node:fs";
 import { basename, extname } from "node:path";
@@ -12413,6 +12560,7 @@ var activitiesCreate = makeFunctionReference("activities:create");
 var activitiesGetCompleteByIdRich = makeFunctionReference("activities:getCompleteByIdRich");
 var activitiesGetByIdRich = makeFunctionReference("activities:getByIdRich");
 var activitiesSearchRich = makeFunctionReference("activities:searchRich");
+var activitiesUpdateDeadline = makeFunctionReference("activities:updateDeadline");
 var activitiesUpdateTitle = makeFunctionReference("activities:updateTitle");
 var activitiesSetContentFromMarkdown = makeFunctionReference("activities:setContentFromMarkdown");
 var activitiesReadContent = makeFunctionReference("activities:readContentDurable");
@@ -12447,6 +12595,9 @@ var ActivityList = class extends ClientCommand {
   static paths = [["activity", "list"]];
   static usage = Command.Usage({ category: "Activity", description: "List activities" });
   entity = options_exports.String("--entity", { description: "Filter by entity (name or ID)" });
+  compact = options_exports.Boolean("--compact", false, { description: "Entity-scoped compact page; preserves spaces and continuation. Read full detail with activity get." });
+  cursor = options_exports.String("--cursor", { description: "Opaque nextCursor from the previous entity-scoped page; keep the same entity and filters" });
+  minCount = options_exports.String("--min-count", { description: "Minimum entity history entries, even outside the time window (default 5). Use 0 for a strict window." });
   type = options_exports.String("--type", { description: "Filter by type (task, call, note, message, conversation, meeting)" });
   attr = options_exports.Array("--attr", { description: "Filter by attribute key=value" });
   onlyOpen = options_exports.Boolean("--only-open", false, { description: "Only show non-completed activities" });
@@ -12460,6 +12611,7 @@ var ActivityList = class extends ClientCommand {
   });
   async run() {
     if (this.archived) {
+      if (this.compact || this.cursor !== void 0 || this.minCount !== void 0) throw new Error("--compact/--cursor/--min-count require an active entity-scoped activity list.");
       const client = this.client();
       const params = { archived: "true" };
       if (this.limit) params.limit = this.limit;
@@ -12472,6 +12624,9 @@ var ActivityList = class extends ClientCommand {
       return;
     }
     await this.runActivityList({
+      compact: this.compact,
+      cursor: this.cursor,
+      minCount: this.minCount !== void 0 ? Number(this.minCount) : void 0,
       entity: this.entity,
       typeFilter: this.type,
       attrFilter: this.attr,
@@ -12676,14 +12831,16 @@ var ActivityUpdate = class extends ProfileCommand {
   content = options_exports.String("--content", { description: "Update content" });
   contentFile = options_exports.String("--content-file", { description: "Read updated content from a markdown/text file" });
   title = options_exports.String("--title", { description: "Update title" });
+  deadline = options_exports.String("--deadline", { description: "Update deadline (human-friendly)" });
+  clearDeadline = options_exports.Boolean("--clear-deadline", false, { description: "Remove the deadline" });
   entityAdd = options_exports.Array("--entity-add", { description: "Link additional entities" });
   entityRemove = options_exports.Array("--entity-remove", { description: "Unlink entities" });
   async run() {
     const content = readContentOption(this.content, this.contentFile);
+    const deadline = deadlineChange(this.deadline, this.clearDeadline);
     const hasEntityChange = !!(this.entityAdd && this.entityAdd.length || this.entityRemove && this.entityRemove.length);
-    if (this.content === void 0 && this.contentFile === void 0 && this.title === void 0 && !hasEntityChange && !this.agentAssignee?.length && !this.clearAgentAssignees) {
-      this.err("Nothing to update. Specify content, title, entity links or agent assignees.");
-      return 1;
+    if (this.content === void 0 && this.contentFile === void 0 && this.title === void 0 && deadline === null && !hasEntityChange && !this.agentAssignee?.length && !this.clearAgentAssignees) {
+      throw new Error("Nothing to update. Specify content, title, deadline, entity links or agent assignees.");
     }
     if (this.clearAgentAssignees && this.agentAssignee?.length) throw new Error("Choose --agent-assignee or --clear-agent-assignees");
     const caller = await resolveCaller();
@@ -12692,6 +12849,7 @@ var ActivityUpdate = class extends ProfileCommand {
       { activityId: this.id, agentAssigneeIds: this.agentAssignee ?? [] }
     );
     if (this.title !== void 0) await caller.mutation(activitiesUpdateTitle, { activityId: this.id, title: this.title });
+    if (deadline) await caller.mutation(activitiesUpdateDeadline, { activityId: this.id, ...deadline });
     if (content !== void 0) await caller.mutation(activitiesSetContentFromMarkdown, { activityId: this.id, markdown: content });
     if (hasEntityChange) {
       const rich = await caller.query(activitiesGetByIdRich, { activityId: this.id });
@@ -12703,8 +12861,7 @@ var ActivityUpdate = class extends ProfileCommand {
       const newIds = currentIds.filter((eid) => !removeSet.has(eid));
       for (const eid of addIds) if (!currentIds.includes(eid)) newIds.push(eid);
       if (newIds.length === 0) {
-        this.err("Cannot remove all entities \u2014 an activity must have at least one.");
-        return 1;
+        throw new Error("Cannot remove all entities \u2014 an activity must have at least one.");
       }
       await caller.mutation(activitiesUpdateEntities, { activityId: this.id, entities: newIds });
     }
@@ -12879,8 +13036,7 @@ var ActivityMessageAdd = class extends ProfileCommand {
   async run() {
     const markdown = readContentOption(this.content, this.contentFile);
     if (!markdown?.trim()) {
-      this.err("Message content is required. Specify --content or --content-file.");
-      return 1;
+      throw new Error("Message content is required. Specify --content or --content-file.");
     }
     const caller = await resolveCaller();
     const messageId = await caller.mutation(messagesCreateFromMarkdown, {
@@ -13174,90 +13330,6 @@ var ActivityTranscript = class extends ProfileCommand {
 };
 var ACTIVITY_TRANSCRIPT_COMMANDS = [ActivityTranscript];
 
-// ente/deadline.ts
-var DEFAULT_HOUR = 22;
-var DEFAULT_MINUTE = 0;
-function addDaysToBerlinToday(days) {
-  const t = berlinToday();
-  const dt = new Date(Date.UTC(t.year, t.month - 1, t.day) + days * 864e5);
-  return { year: dt.getUTCFullYear(), month: dt.getUTCMonth() + 1, day: dt.getUTCDate() };
-}
-function parseTimeOrDefault(s) {
-  if (!s) return [DEFAULT_HOUR, DEFAULT_MINUTE];
-  const m = /^(\d{1,2}):(\d{2})$/.exec(s);
-  if (!m) throw new Error(`Invalid time format: '${s}'. Use HH:MM (e.g. 14:00).`);
-  const hour = Number(m[1]);
-  const minute = Number(m[2]);
-  if (hour > 23 || minute > 59) throw new Error(`Invalid time format: '${s}'.`);
-  return [hour, minute];
-}
-function validateDate(year, month, day, original) {
-  if (month < 1 || month > 12 || day < 1 || day > 31) {
-    throw new Error(`Invalid date: '${original}'.`);
-  }
-  const d = new Date(Date.UTC(year, month - 1, day));
-  if (d.getUTCFullYear() !== year || d.getUTCMonth() + 1 !== month || d.getUTCDate() !== day) {
-    throw new Error(`Invalid date: '${original}' \u2014 day ${day} does not exist in month ${month}.`);
-  }
-}
-function parseDeadline(input) {
-  const trimmed = input.trim().toLowerCase();
-  if (trimmed.startsWith("tomorrow")) {
-    const [hour, minute] = parseTimeOrDefault(trimmed.slice("tomorrow".length).trim());
-    const t = addDaysToBerlinToday(1);
-    return berlinToEpochMs(t.year, t.month, t.day, hour, minute);
-  }
-  if (trimmed.startsWith("today")) {
-    const [hour, minute] = parseTimeOrDefault(trimmed.slice("today".length).trim());
-    const t = addDaysToBerlinToday(0);
-    return berlinToEpochMs(t.year, t.month, t.day, hour, minute);
-  }
-  const rel = /^\+(\d+)\s*(days?|weeks?)$/.exec(trimmed);
-  if (rel) {
-    const n = Number(rel[1]);
-    const days = rel[2].startsWith("week") ? n * 7 : n;
-    const t = addDaysToBerlinToday(days);
-    return berlinToEpochMs(t.year, t.month, t.day, DEFAULT_HOUR, DEFAULT_MINUTE);
-  }
-  const iso = /^(\d{4})-(\d{2})-(\d{2})t(\d{2}):(\d{2})(?::(\d{2}))?(?:z|([+-])(\d{2}):(\d{2}))$/.exec(
-    trimmed
-  );
-  if (iso) {
-    const year = Number(iso[1]);
-    const month = Number(iso[2]);
-    const day = Number(iso[3]);
-    const hour = Number(iso[4]);
-    const minute = Number(iso[5]);
-    const second = iso[6] ? Number(iso[6]) : 0;
-    validateDate(year, month, day, input);
-    if (hour > 23 || minute > 59 || second > 59) throw new Error(`Invalid time in deadline: '${input}'.`);
-    let offsetMs = 0;
-    if (iso[7]) {
-      const sign = iso[7] === "-" ? -1 : 1;
-      offsetMs = sign * (Number(iso[8]) * 60 + Number(iso[9])) * 6e4;
-    }
-    return Date.UTC(year, month - 1, day, hour, minute, second) - offsetMs;
-  }
-  const date = /^(\d{4})-(\d{2})-(\d{2})(?:\s+(\d{1,2}):(\d{2}))?$/.exec(trimmed);
-  if (date) {
-    const year = Number(date[1]);
-    const month = Number(date[2]);
-    const day = Number(date[3]);
-    validateDate(year, month, day, input);
-    const hour = date[4] ? Number(date[4]) : DEFAULT_HOUR;
-    const minute = date[5] ? Number(date[5]) : DEFAULT_MINUTE;
-    if (hour > 23 || minute > 59) throw new Error(`Invalid time in deadline: '${input}'.`);
-    return berlinToEpochMs(year, month, day, hour, minute);
-  }
-  throw new Error(
-    `Cannot parse deadline '${input}'. Accepted: "tomorrow", "today", "+3 days", "+1 week", "2026-03-15", "2026-03-15 14:00", "2026-03-15T14:00:00+01:00"`
-  );
-}
-function defaultDeadline() {
-  const t = addDaysToBerlinToday(1);
-  return berlinToEpochMs(t.year, t.month, t.day, DEFAULT_HOUR, DEFAULT_MINUTE);
-}
-
 // ente/commands/task.ts
 function toTaskItem(rich) {
   return {
@@ -13296,7 +13368,7 @@ var activitiesSetAttribute = makeFunctionReference("activities:setAttribute");
 var activitiesUpdateCreatedAt2 = makeFunctionReference("activities:updateCreatedAt");
 var activitiesUpdateTitle2 = makeFunctionReference("activities:updateTitle");
 var activitiesSetContentFromMarkdown2 = makeFunctionReference("activities:setContentFromMarkdown");
-var activitiesUpdateDeadline = makeFunctionReference("activities:updateDeadline");
+var activitiesUpdateDeadline2 = makeFunctionReference("activities:updateDeadline");
 var activitiesSetCompleted = makeFunctionReference("activities:setCompleted");
 var activitiesUpdateAssignees = makeFunctionReference("activities:updateAssignees");
 function parseShortId(idStr) {
@@ -13333,8 +13405,7 @@ var TaskListCmd = class extends ClientCommand {
     else if (this.due === "today") params.dueBy = String(endOfTodayBerlin());
     else if (this.due === "overdue") params.dueBy = String(Date.now());
     else if (this.due) {
-      this.err(`Unknown --due value: '${this.due}'. Use: today, overdue, or all.`);
-      return 1;
+      throw new Error(`Unknown --due value: '${this.due}'. Use: today, overdue, or all.`);
     }
     const res = await client.listTasks(params);
     const tasks = (res.data ?? []).slice();
@@ -13462,17 +13533,18 @@ var TaskUpdate = class extends ProfileCommand {
   content = options_exports.String("--content", { description: "Update content" });
   attr = options_exports.Array("--attr", { description: "Set attributes as key=value pairs" });
   deadline = options_exports.String("--deadline", { description: "Update deadline (human-friendly)" });
+  clearDeadline = options_exports.Boolean("--clear-deadline", false, { description: "Remove the deadline" });
   async run() {
     const attributes = parseAttrs(this.attr);
-    if (this.title === void 0 && this.content === void 0 && this.deadline === void 0 && Object.keys(attributes).length === 0) {
-      this.err("Nothing to update. Specify --title, --content, --attr, or --deadline.");
-      return 1;
+    const deadline = deadlineChange(this.deadline, this.clearDeadline);
+    if (this.title === void 0 && this.content === void 0 && deadline === null && Object.keys(attributes).length === 0) {
+      throw new Error("Nothing to update. Specify --title, --content, --attr, --deadline, or --clear-deadline.");
     }
     const caller = await resolveCaller();
     const activityId = await resolveTaskIdC(caller, this.id);
     if (this.title !== void 0) await caller.mutation(activitiesUpdateTitle2, { activityId, title: this.title });
     if (this.content !== void 0) await caller.mutation(activitiesSetContentFromMarkdown2, { activityId, markdown: this.content });
-    if (this.deadline) await caller.mutation(activitiesUpdateDeadline, { activityId, deadline: parseDeadline(this.deadline) });
+    if (deadline) await caller.mutation(activitiesUpdateDeadline2, { activityId, ...deadline });
     for (const [key, value] of Object.entries(attributes)) {
       await caller.mutation(activitiesSetAttribute, { activityId, key, value });
     }
@@ -14984,7 +15056,7 @@ var RecordingRerunCommand = class extends ProfileCommand {
       audioPreserved
     };
     if (after.processingStatus === "error") {
-      this.emitText(data, () => `Pipeline failed for ${after.id}: ${after.processingError}`);
+      this.emitText({ ...data, error: { message: `Pipeline failed for ${after.id}: ${after.processingError}` } }, () => `Pipeline failed for ${after.id}: ${after.processingError}`);
       return 1;
     }
     this.emitText(
@@ -15927,7 +15999,7 @@ Commands:
   ente guide [topic]           This help
 
 Run \`ente <command> --help\` for detailed usage on any command.
-Run \`ente guide <topic>\` for deep dives: entities, tasks, activities, search, patterns, limits`
+Run \`ente guide <topic>\` for deep dives: entities, tasks, activities, search, retrieval, patterns, limits`
   },
   entities: {
     title: "Entities",
@@ -15986,7 +16058,8 @@ Creating tasks:
   ente task create "Reply to Ashley" --entity "Ashley" --space "Personal" --deadline "tomorrow" --assignee ashley@example.com
   ente task create "Fix bug" --entity "TiVA" --space "TiVA" --deadline "+3 days" --attr github-issue=https://...
 
-  Every task needs a deadline. If not specified, defaults to tomorrow 22:00 Berlin.
+  Without --deadline a task is due tomorrow 22:00 Berlin; --no-deadline creates it without one.
+  Remove a deadline later with: ente task update 5 --clear-deadline
 
 Deadlines (human-friendly):
   "tomorrow"              \u2192 tomorrow 22:00 Berlin
@@ -16053,6 +16126,26 @@ Archiving (trash):
   ente activity delete <activity-id>        # move to trash (soft delete)
   ente activity list --archived             # list trashed activities
   ente activity restore <activity-id>       # restore from trash`
+  },
+  retrieval: {
+    title: "Bounded retrieval",
+    content: `Resolve entities globally first: ente search "Apollo" --json
+Use an explicit space when the task specifies one:
+  ente query "launch decisions" --space "Work" --entity "Apollo" --since 1791763200000 --until 1792368000000 --limit 8 --json
+Time filters apply to activity evidence; query uses no model.
+
+Read one compact entity-history page:
+  ente activity list --entity <id> --after 1791763200000 --min-count 0 --limit 10 --compact --json
+Continue with --cursor <nextCursor>, keeping the entity and time filters.
+Compact pages retain spaces/member context, IDs, hasMore and nextCursor.
+Bodies are excerpts; projection.fullDetail names the complete read.
+  ente activity get <activityId> --json
+
+Keep spaces, spaceId/spaceIds, scope, warnings and continuation when selecting
+fields. Access does not authorize copying records into another space.
+Check command exits before parsing JSON. JSON failures use an error envelope
+on stdout and a nonzero exit. Use entity get, not entity show.
+For examples: playbooks/retrieve-bounded-context.md`
   },
   search: {
     title: "Search \u2014 Fuzzy, Multi-Strategy",
@@ -16145,8 +16238,7 @@ var GuideCmd = class extends BaseCommand {
     }
     const entry = TOPICS[this.topic.toLowerCase()];
     if (!entry) {
-      this.err(`Unknown topic: '${this.topic}'. Available: ${TOPIC_NAMES.join(", ")}`);
-      return 1;
+      throw new Error(`Unknown topic: '${this.topic}'. Available: ${TOPIC_NAMES.join(", ")}`);
     }
     this.out(`
   ${entry.title}
@@ -17197,7 +17289,7 @@ async function main() {
       upgradeCommand: ENTE_BRANDING.upgradeCommand
     });
   }
-  await cli.runExit(argv);
+  process.exitCode = await runCli(cli, argv, { stdout: process.stdout, stderr: process.stderr });
 }
 void main();
 /*! Bundled license information: