@robbeverhelst/do 1.294.0 → 1.296.0

package/dist/do.js

@@ -5051,7 +5051,14 @@ var files = pgTable("files", {
 ]);
 
 // ../../packages/schema/src/db/guests.ts
-var guestTier = pgEnum("guest_tier", ["ceremony", "reception", "dinner", "party"]);
+var guestTier = pgEnum("guest_tier", [
+  "civil",
+  "church",
+  "ceremony",
+  "reception",
+  "dinner",
+  "party"
+]);
 var households = pgTable("households", {
   id: text("id").primaryKey().references(() => nodes.id),
   tenantId: text("tenant_id").notNull().references(() => tenants.id),
@@ -5084,6 +5091,23 @@ var guestTables = pgTable("guest_tables", {
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
   updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [index("guest_tables_list_idx").on(t.guestListId)]);
+var guestListEvents = pgTable("guest_list_events", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  guestListId: text("guest_list_id").notNull().references(() => guestLists.id, { onDelete: "cascade" }),
+  key: guestTier("key").notNull(),
+  name: jsonb("name").$type().notNull(),
+  startsAt: timestamp("starts_at", { withTimezone: true }),
+  endsAt: timestamp("ends_at", { withTimezone: true }),
+  placeName: text("place_name"),
+  address: text("address"),
+  mapUrl: text("map_url"),
+  dressCode: jsonb("dress_code").$type(),
+  note: jsonb("note").$type(),
+  sort: integer("sort").notNull().default(0),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [uniqueIndex("guest_list_events_key_uniq").on(t.guestListId, t.key)]);
 var guests = pgTable("guests", {
   id: text("id").primaryKey(),
   tenantId: text("tenant_id").notNull().references(() => tenants.id),
@@ -5197,6 +5221,46 @@ var mailDeliveries = pgTable("mail_deliveries", {
   uniqueIndex("mail_deliveries_campaign_email_uniq").on(t.campaignId, t.toEmail)
 ]);
 
+// ../../packages/schema/src/db/rsvp-questions.ts
+var rsvpQuestionKind = pgEnum("rsvp_question_kind", [
+  "choice",
+  "multi",
+  "text",
+  "number",
+  "yes_no"
+]);
+var rsvpQuestionScope = pgEnum("rsvp_question_scope", ["household", "guest"]);
+var rsvpQuestions = pgTable("rsvp_questions", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  guestListId: text("guest_list_id").notNull().references(() => guestLists.id, { onDelete: "cascade" }),
+  kind: rsvpQuestionKind("kind").notNull(),
+  label: jsonb("label").$type().notNull(),
+  options: jsonb("options").$type().notNull().default([]),
+  scope: rsvpQuestionScope("scope").notNull().default("household"),
+  eventKey: text("event_key"),
+  required: boolean("required").notNull().default(false),
+  sort: integer("sort").notNull().default(0),
+  showIf: jsonb("show_if").$type().notNull().default([]),
+  preset: text("preset"),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [index("rsvp_questions_list_idx").on(t.guestListId)]);
+var rsvpAnswers = pgTable("rsvp_answers", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  guestListId: text("guest_list_id").notNull().references(() => guestLists.id, { onDelete: "cascade" }),
+  questionId: text("question_id").notNull().references(() => rsvpQuestions.id, { onDelete: "cascade" }),
+  householdId: text("household_id").notNull().references(() => households.id, { onDelete: "cascade" }),
+  guestId: text("guest_id").references(() => guests.id, { onDelete: "cascade" }),
+  value: jsonb("value").$type().notNull(),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  unique("rsvp_answers_uniq").on(t.questionId, t.householdId, t.guestId).nullsNotDistinct(),
+  index("rsvp_answers_list_idx").on(t.guestListId)
+]);
+
 // ../../packages/schema/src/db/calendar.ts
 var calendarLinkPurpose = pgEnum("calendar_link_purpose", ["block", "deadline"]);
 var calendarEventLinks = pgTable("calendar_event_links", {
@@ -20566,7 +20630,13 @@ var METRICS = {
   bedtime: { label: "Bedtime", unit: "clock", min: 0, max: 720, step: 5 }
 };
 var metricKeySchema = _enum2(["weight", "sleep", "mood", "rating", "energy", "bedtime"]);
-var metricSourceSchema = _enum2(["manual", "device", "agent", "google_fit"]);
+var metricSourceSchema = _enum2([
+  "manual",
+  "device",
+  "agent",
+  "google_fit",
+  "google_health"
+]);
 var loggedMetricSourceSchema = _enum2(["manual", "device", "agent"]);
 var metricPointSchema = object({
   day: string2(),
@@ -20590,7 +20660,7 @@ var sessionSchema = object({
   sport: string2(),
   name: string2().nullable(),
   minutes: number2().nullable(),
-  source: _enum2(["google_fit", "strava"])
+  source: _enum2(["google_fit", "google_health", "strava"])
 });
 var sessionsQuerySchema = object({
   days: exports_coerce.number().int().min(1).max(365).default(14)
@@ -22777,6 +22847,65 @@ var journalMilestoneListSchema = object({
   milestones: array(journalMilestoneSchema)
 });
 
+// ../../packages/schema/src/contracts/journal-recall.ts
+var JOURNAL_RECALL_LIMIT = 30;
+var JOURNAL_RECALL_MAX_DAYS = 366;
+var daysBetween = (from, to) => (Date.parse(`${to}T00:00:00Z`) - Date.parse(`${from}T00:00:00Z`)) / 86400000;
+var journalRecallQuerySchema = object({
+  q: string2().trim().min(2, "search for at least 2 characters").max(100).optional(),
+  around: journalDateSchema.optional(),
+  from: journalDateSchema.optional(),
+  to: journalDateSchema.optional(),
+  limit: exports_coerce.number().int().min(1).max(JOURNAL_RECALL_LIMIT).optional()
+}).strict().refine((q) => !(q.around && (q.from || q.to)), {
+  message: "give around, or from and to, not both",
+  path: ["around"]
+}).refine((q) => !q.from || !q.to || q.from <= q.to, {
+  message: "from must be on or before to",
+  path: ["to"]
+}).refine((q) => !q.from || !q.to || daysBetween(q.from, q.to) < JOURNAL_RECALL_MAX_DAYS, {
+  message: `a recall covers at most ${JOURNAL_RECALL_MAX_DAYS} days`,
+  path: ["to"]
+});
+var journalRecallMilestoneSchema = object({
+  id: string2(),
+  title: string2(),
+  kind: journalMilestoneKindSchema,
+  happenedOn: journalDateSchema,
+  precision: journalMilestonePrecisionSchema,
+  planned: boolean3()
+});
+var journalRecallEarlierSchema = object({
+  date: journalDateSchema,
+  yearsAgo: number2().int().positive(),
+  title: string2().nullable(),
+  rating: number2().nullable()
+});
+var journalRecallSchema = object({
+  q: string2().nullable(),
+  from: journalDateSchema.nullable(),
+  to: journalDateSchema.nullable(),
+  timezone: string2().min(1),
+  days: array(journalDayListItemSchema).max(JOURNAL_RECALL_LIMIT),
+  rated: number2().int().nonnegative(),
+  average: number2().nullable(),
+  milestones: array(journalRecallMilestoneSchema),
+  earlier: array(journalRecallEarlierSchema)
+});
+var journalDigestDaySchema = object({
+  date: journalDateSchema,
+  title: string2().nullable(),
+  rating: number2().nullable()
+});
+var journalDigestSchema = object({
+  from: journalDateSchema,
+  to: journalDateSchema,
+  timezone: string2().min(1),
+  days: array(journalDigestDaySchema),
+  milestones: array(journalRecallMilestoneSchema),
+  text: string2()
+});
+
 // ../../packages/schema/src/contracts/journal-recap.ts
 var journalWeekKeySchema = string2().regex(/^\d{4}-W(0[1-9]|[1-4]\d|5[0-3])$/, "must be an ISO week (YYYY-Www)");
 var JOURNAL_MOMENTS_MAX = 3;
@@ -25131,6 +25260,7 @@ var insuranceFieldsSchema = object({
 }).partial().strict();
 var contractFieldsSchema = object({
   customerNo: text4,
+  product: text4,
   plan: text4,
   price: amount4,
   cadence: documentCadenceSchema,
@@ -26941,7 +27071,7 @@ var guestListViewSchema = guestListSchema.extend({
 var createGuestListInputSchema = object({
   id: ulidSchema,
   projectId: ulidSchema,
-  tiers: array(guestTierSchema).min(1).max(4).optional(),
+  tiers: array(guestTierSchema).min(1).max(6).optional(),
   caps: capsSchema.optional(),
   sides: array(sideSchema).max(4).optional(),
   rsvpBy: keyDateDaySchema.nullish()
@@ -26970,7 +27100,7 @@ var createGuestInputSchema = object({
   guestListId: ulidSchema,
   contactId: ulidSchema,
   side: sideSchema.nullish(),
-  tiers: array(guestTierSchema).max(4).optional(),
+  tiers: array(guestTierSchema).max(6).optional(),
   rsvp: answersSchema.optional(),
   plusOne: boolean3().optional(),
   plusOneName: string2().trim().min(1).max(120).nullish(),
@@ -27092,6 +27222,35 @@ var submitRsvpInputSchema = object({
   }).strict()).min(1).max(30),
   address: householdAddressSchema.nullish()
 }).strict();
+var eventTextSchema = (max) => object({
+  nl: string2().trim().min(1).max(max).optional(),
+  pt: string2().trim().min(1).max(max).optional()
+}).strict().refine((t) => t.nl !== undefined || t.pt !== undefined, "give it in NL or PT");
+var guestEventKeySchema = guestTierSchema;
+var guestListEventSchema = createSelectSchema(guestListEvents, {
+  name: object({ nl: string2().optional(), pt: string2().optional() }),
+  dressCode: object({ nl: string2().optional(), pt: string2().optional() }).nullable(),
+  note: object({ nl: string2().optional(), pt: string2().optional() }).nullable(),
+  startsAt: exports_coerce.date().nullable(),
+  endsAt: exports_coerce.date().nullable(),
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+});
+var eventFields = {
+  name: eventTextSchema(120),
+  startsAt: exports_coerce.date().nullish(),
+  endsAt: exports_coerce.date().nullish(),
+  placeName: string2().trim().min(1).max(120).nullish(),
+  address: string2().trim().min(1).max(300).nullish(),
+  mapUrl: string2().trim().url().max(500).refine((u) => /^https?:\/\//.test(u), "expected an http(s) link").nullish(),
+  dressCode: eventTextSchema(200).nullish(),
+  note: eventTextSchema(1000).nullish(),
+  sort: number2().int().min(0).max(1e4).optional()
+};
+var endsAfterStart2 = (e) => !e.startsAt || !e.endsAt || e.endsAt >= e.startsAt;
+var createGuestListEventInputSchema = object({ id: ulidSchema, guestListId: ulidSchema, key: guestEventKeySchema, ...eventFields }).strict().refine(endsAfterStart2, { message: "endsAt is before startsAt", path: ["endsAt"] });
+var updateGuestListEventInputSchema = object(eventFields).partial().strict().refine(endsAfterStart2, { message: "endsAt is before startsAt", path: ["endsAt"] });
+var guestListEventsQuerySchema = object({ guestListId: ulidSchema });
 var guestTableSchema = createSelectSchema(guestTables, {
   createdAt: exports_coerce.date(),
   updatedAt: exports_coerce.date()
@@ -27181,6 +27340,10 @@ var mailFooterSchema = object({
   deleteBy: keyDateDaySchema.optional(),
   contact: email2().max(320).optional()
 }).strict();
+var mailLookShape = {
+  couple: string2().trim().min(1).max(120).optional(),
+  imagesUrl: url({ protocol: /^https$/ }).max(500).optional()
+};
 var lineSchema = string2().trim().min(1).max(2000);
 var mailMessageCopySchema = object({
   subject: string2().trim().min(1).max(200),
@@ -27191,6 +27354,7 @@ var mailMessageCopySchema = object({
 var mailMessageDataSchema = object({
   nl: mailMessageCopySchema,
   pt: mailMessageCopySchema.optional(),
+  ...mailLookShape,
   footer: mailFooterSchema.optional()
 }).strict();
 var mailDaySchema = object({
@@ -27212,9 +27376,37 @@ var mailSaveTheDateDataSchema = object({
   pt: mailSaveTheDateCopySchema.optional(),
   days: array(mailDaySchema).min(1).max(5),
   calendarTitle: string2().trim().min(1).max(120).optional(),
+  ...mailLookShape,
   footer: mailFooterSchema.optional()
 }).strict();
 var mailSaveTheDateDeliverySchema = object({ link: url().optional() }).strict();
+var mailProgrammeItemSchema = object({
+  date: keyDateDaySchema.optional(),
+  time: string2().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "time is HH:MM"),
+  label: mailDaySchema.shape.label,
+  place: string2().trim().min(1).max(200).optional()
+}).strict();
+var laterMailShape = {
+  nl: mailSaveTheDateCopySchema,
+  pt: mailSaveTheDateCopySchema.optional(),
+  days: array(mailDaySchema).min(1).max(5),
+  ...mailLookShape,
+  footer: mailFooterSchema.optional()
+};
+var mailInvitationDataSchema = object({
+  ...laterMailShape,
+  programme: array(mailProgrammeItemSchema).max(12).optional(),
+  rsvpBy: keyDateDaySchema.optional(),
+  calendarTitle: string2().trim().min(1).max(120).optional()
+}).strict();
+var mailReminderDataSchema = object({ ...laterMailShape, rsvpBy: keyDateDaySchema }).strict();
+var mailFinalInfoDataSchema = object({ ...laterMailShape, programme: array(mailProgrammeItemSchema).max(12).optional() }).strict();
+var mailHouseholdDeliverySchema = object({
+  link: url().optional(),
+  household: string2().trim().min(1).max(200).optional(),
+  programme: array(mailProgrammeItemSchema).max(12).optional(),
+  table: string2().trim().min(1).max(120).optional()
+}).strict();
 var mailProviderEventSchema = looseObject({
   type: string2().min(1),
   created_at: string2().optional(),
@@ -27229,11 +27421,20 @@ var mailProviderEventSchema = looseObject({
 });
 var MAIL_CAMPAIGN_KINDS = ["message", "save_the_date", "invitation"];
 var mailCampaignKindSchema = _enum2(MAIL_CAMPAIGN_KINDS);
-var MAIL_TEMPLATES = ["message", "save_the_date"];
+var MAIL_TEMPLATES = [
+  "message",
+  "save_the_date",
+  "invitation",
+  "reminder",
+  "final_info"
+];
 var mailTemplateSchema = _enum2(MAIL_TEMPLATES);
 var mailTemplateDataSchemas = {
   message: mailMessageDataSchema,
-  save_the_date: mailSaveTheDateDataSchema
+  save_the_date: mailSaveTheDateDataSchema,
+  invitation: mailInvitationDataSchema,
+  reminder: mailReminderDataSchema,
+  final_info: mailFinalInfoDataSchema
 };
 function mailTemplateDataError(template, data) {
   const parsed = mailTemplateDataSchemas[template].safeParse(data);
@@ -27289,6 +27490,100 @@ var mailCampaignViewSchema = mailCampaignSchema.extend({
   readyToSend: boolean3()
 });
 
+// ../../packages/schema/src/contracts/rsvp-questions.ts
+var RSVP_QUESTION_KINDS = ["choice", "multi", "text", "number", "yes_no"];
+var rsvpQuestionKindSchema = _enum2(RSVP_QUESTION_KINDS);
+var rsvpQuestionScopeSchema = _enum2(["household", "guest"]);
+var RSVP_QUESTION_PRESETS = ["diet", "message"];
+var rsvpQuestionPresetSchema = _enum2(RSVP_QUESTION_PRESETS);
+var RSVP_SHOW_IF_MAX = 5;
+var rsvpTextSchema = (max) => object({
+  nl: string2().trim().min(1).max(max).optional(),
+  pt: string2().trim().min(1).max(max).optional()
+}).strict().refine((t) => t.nl !== undefined || t.pt !== undefined, "give it in NL or PT");
+var keySchema = string2().regex(/^[a-z][a-z0-9_]{0,31}$/, "expected a short lower-case word (vegan, civil)");
+var rsvpQuestionOptionSchema = object({ key: keySchema, label: rsvpTextSchema(120) }).strict();
+var rsvpShowIfConditionSchema = union([
+  object({
+    questionId: ulidSchema,
+    equals: union([string2().max(200), number2(), boolean3()])
+  }).strict(),
+  object({ eventKey: keySchema.optional(), rsvp: literal("yes") }).strict()
+]);
+var rsvpAnswerValueSchema = union([
+  string2().max(2000),
+  array(string2().max(32)).max(20),
+  number2(),
+  boolean3()
+]);
+var rsvpQuestionSchema = createSelectSchema(rsvpQuestions, {
+  label: object({ nl: string2().optional(), pt: string2().optional() }),
+  options: array(object({
+    key: string2(),
+    label: object({ nl: string2().optional(), pt: string2().optional() })
+  })),
+  showIf: array(rsvpShowIfConditionSchema),
+  preset: rsvpQuestionPresetSchema.nullable(),
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+});
+var rsvpAnswerSchema = createSelectSchema(rsvpAnswers, {
+  value: rsvpAnswerValueSchema,
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+});
+function rsvpOptionsProblem(kind, options) {
+  if (kind === "choice" || kind === "multi") {
+    if (options.length < 2)
+      return `a ${kind} question needs two options or more`;
+    if (new Set(options.map((o) => o.key)).size !== options.length)
+      return "each option needs its own key";
+    return null;
+  }
+  return options.length > 0 ? `a ${kind} question has no options` : null;
+}
+var questionFields = {
+  label: rsvpTextSchema(300),
+  options: array(rsvpQuestionOptionSchema).max(30).optional(),
+  scope: rsvpQuestionScopeSchema.optional(),
+  eventKey: keySchema.nullish(),
+  required: boolean3().optional(),
+  sort: number2().int().min(0).max(1e4).optional(),
+  showIf: array(rsvpShowIfConditionSchema).max(RSVP_SHOW_IF_MAX).optional()
+};
+var createRsvpQuestionInputSchema = object({
+  id: ulidSchema,
+  guestListId: ulidSchema,
+  kind: rsvpQuestionKindSchema,
+  ...questionFields
+}).strict().superRefine((q, ctx) => {
+  const problem = rsvpOptionsProblem(q.kind, q.options ?? []);
+  if (problem)
+    ctx.addIssue({ code: "custom", message: problem, path: ["options"] });
+  if (q.showIf?.some((c) => ("questionId" in c) && c.questionId === q.id))
+    ctx.addIssue({
+      code: "custom",
+      message: "a question can't depend on itself",
+      path: ["showIf"]
+    });
+});
+var updateRsvpQuestionInputSchema = object(questionFields).partial().strict();
+var rsvpQuestionsQuerySchema = object({ guestListId: ulidSchema });
+var rsvpAnswerInputSchema = object({
+  questionId: ulidSchema,
+  guestId: ulidSchema.nullish(),
+  value: rsvpAnswerValueSchema.nullable()
+}).strict();
+var setRsvpAnswersInputSchema = object({
+  guestListId: ulidSchema,
+  householdId: ulidSchema,
+  answers: array(rsvpAnswerInputSchema).min(1).max(200)
+}).strict();
+var rsvpAnswersQuerySchema = object({
+  guestListId: ulidSchema,
+  householdId: ulidSchema.optional()
+});
+
 // ../../packages/schema/src/contracts/calendar.ts
 var calendarEventLinkSchema = createSelectSchema(calendarEventLinks, {
   createdAt: exports_coerce.date(),
@@ -28881,7 +29176,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.294.0";
+var VERSION = "1.296.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -29596,6 +29891,24 @@ var ENTITIES = [
       canDelete: true
     }
   },
+  {
+    name: "guest-list-events",
+    path: "/guest-list-events",
+    readScope: "contacts:read",
+    returns: "GuestListEvent",
+    canGet: true,
+    listFlags: [
+      { name: "list", description: "the guest list's id (required)", query: "guestListId" }
+    ],
+    write: {
+      scope: "contacts:write",
+      createSchema: createGuestListEventInputSchema,
+      createInput: "CreateGuestListEventInput",
+      updateSchema: updateGuestListEventInputSchema,
+      updateInput: "UpdateGuestListEventInput",
+      canDelete: true
+    }
+  },
   {
     name: "guest-tables",
     path: "/guest-tables",
@@ -29614,6 +29927,24 @@ var ENTITIES = [
       canDelete: true
     }
   },
+  {
+    name: "rsvp-questions",
+    path: "/rsvp-questions",
+    readScope: "contacts:read",
+    returns: "RsvpQuestion",
+    canGet: true,
+    listFlags: [
+      { name: "list", description: "the guest list's id (required)", query: "guestListId" }
+    ],
+    write: {
+      scope: "contacts:write",
+      createSchema: createRsvpQuestionInputSchema,
+      createInput: "CreateRsvpQuestionInput",
+      updateSchema: updateRsvpQuestionInputSchema,
+      updateInput: "UpdateRsvpQuestionInput",
+      canDelete: true
+    }
+  },
   {
     name: "guests",
     path: "/guests",
@@ -30329,6 +30660,24 @@ var HEALTH_COMMAND_SPECS = [
     scopes: READ,
     returns: "HealthLabOverview"
   },
+  {
+    path: ["health", "google", "status"],
+    summary: "Whether your Google Health is connected, the last sync, and what stops it.",
+    args: [],
+    flags: [],
+    scopes: READ,
+    returns: "GoogleHealthStatus",
+    notes: "GET /api/v1/health/google-health. Connecting needs Google's consent in a browser: Settings \u2192 Health in do. `failure` (reauth, not_linked, unavailable, other) says what stops the sync, with a title and a hint."
+  },
+  {
+    path: ["health", "google", "sync"],
+    summary: "Sync your Google Health now (sleep, resting heart rate, HRV, steps, workouts), as the morning sync does.",
+    args: [],
+    flags: [],
+    scopes: WRITE2,
+    returns: "GoogleHealthSyncResult",
+    notes: "POST /api/v1/health/google-health/sync. Written and skipped per resource, and the status after it; a sync that stops answers 200 with `status.failure`. 409 before Google Health is connected, 403 while the server has it switched off."
+  },
   {
     path: ["health", "analyte"],
     summary: "One analyte's trend across draws (do health analyte vitamin_d).",
@@ -30715,6 +31064,33 @@ var COMMAND_SPECS = [
     returns: "JournalSearch",
     notes: "GET /api/v1/journal/search?q= \u2014 matches the one-liner, highlights, the summary and entries of your own days (at most 30). journal:read is a sensitive scope."
   },
+  {
+    path: ["journal", "recall"],
+    summary: "Recall your Journal: the days that answer some words or a window (or the last 7 days), the milestones near them and the same date in earlier years.",
+    args: [{ name: "words", required: false, description: "A topic to look for (2+ characters)." }],
+    flags: [
+      {
+        name: "around",
+        type: "string",
+        description: "A day, YYYY-MM-DD: reads 3 days either side."
+      },
+      { name: "from", type: "string", description: "The window's first day, YYYY-MM-DD." },
+      { name: "to", type: "string", description: "The window's last day, YYYY-MM-DD." },
+      { name: "limit", type: "string", description: "At most this many days (1\u201330)." }
+    ],
+    scopes: ["journal:read"],
+    returns: "JournalRecall",
+    notes: "GET /api/v1/journal/recall (journal_recall) \u2014 your own days only, dated so an answer can cite them; another member's days never answer. --around can't be combined with --from/--to. journal:read is a sensitive scope."
+  },
+  {
+    path: ["journal", "digest"],
+    summary: "The last 7 days of your Journal as a short digest: each day's line and rating, and the milestones a week either side.",
+    args: [],
+    flags: [],
+    scopes: ["journal:read"],
+    returns: "JournalDigest",
+    notes: "GET /api/v1/journal/digest \u2014 `text` is the few plain lines an agent keeps in its private session. journal:read is a sensitive scope."
+  },
   {
     path: ["journal", "week"],
     summary: "One week of the Journal: its recap (prose, best moments, a pattern), its days, the usual rating and the numbers from Progress.",
@@ -31736,6 +32112,44 @@ var COMMAND_SPECS = [
     returns: "DoccleStatus",
     notes: "PATCH /api/v1/documents/doccle with { archiveAfterImport }."
   },
+  {
+    path: ["documents", "ask"],
+    summary: "Ask the papers a question (doc_ask): the passages that answer, best first, each with its paper, file and page.",
+    args: [
+      {
+        name: "question",
+        required: true,
+        description: '"Is water damage from a burst pipe covered?"'
+      }
+    ],
+    flags: [
+      { name: "document", type: "string", description: "Ask this paper only (document id)." },
+      {
+        name: "limit",
+        type: "string",
+        description: "How many passages at most (default 5, up to 20)."
+      }
+    ],
+    scopes: ["documents:read"],
+    returns: "DocumentAnswer",
+    notes: "POST /api/v1/documents/ask with { question, documentId?, limit? }. Reads the papers' key fields and their files' text (a page per form feed). do writes no prose: word the answer from the passages, quote the pages, and say it is not legal advice. `withoutText` names the papers with no file text to read. An Only me paper answers only its owner's key with documents:private."
+  },
+  {
+    path: ["documents", "search"],
+    summary: "Search the papers' words (key fields and file text), a passage per hit.",
+    args: [{ name: "words", required: true, description: "The words to find." }],
+    flags: [
+      { name: "document", type: "string", description: "Only this paper (document id)." },
+      {
+        name: "limit",
+        type: "string",
+        description: "How many hits at most (default 20, up to 50)."
+      }
+    ],
+    scopes: ["documents:read"],
+    returns: "{ q, hits: DocumentPassage[] }",
+    notes: "GET /api/v1/documents/search?q=&documentId=&limit=."
+  },
   {
     path: ["documents", "unmatched"],
     summary: "List the papers that ask for money (an amount due) and have no payment linked yet, oldest due first.",
@@ -34310,6 +34724,31 @@ var COMMAND_SPECS = [
     scopes: ["contacts:write"],
     returns: "GuestView"
   },
+  {
+    path: ["rsvp-answers", "list"],
+    summary: "A guest list's answers to its RSVP questions, or one household's.",
+    args: [],
+    flags: [
+      { name: "list", type: "string", description: "The guest list's id (required)." },
+      { name: "household", type: "string", description: "Only this household's answers." }
+    ],
+    scopes: ["contacts:read"],
+    returns: "RsvpAnswer"
+  },
+  {
+    path: ["rsvp-answers", "set"],
+    summary: "Set a household's RSVP answers (null clears one); an answer to a hidden question is dropped.",
+    args: [],
+    flags: [
+      {
+        name: "data",
+        type: "string",
+        description: 'JSON SetRsvpAnswersInput, e.g. {"guestListId":"01\u2026","householdId":"01\u2026","answers":[{"questionId":"01\u2026","value":true},{"questionId":"01\u2026","guestId":"01\u2026","value":["vegan"]}]}'
+      }
+    ],
+    scopes: ["contacts:write"],
+    returns: "RsvpAnswer"
+  },
   {
     path: ["seating-proposals", "list"],
     summary: "A guest list's proposed seating plans, newest first.",
@@ -34415,18 +34854,23 @@ var COMMAND_SPECS = [
   },
   {
     path: ["guest-lists", "export"],
-    summary: "Export for the caterer (CSV), the venue (CSV) or the floor plan (PDF) to stdout.",
+    summary: "Export for the caterer (CSV) or the venue (CSV) to stdout, or save the floor plan (PDF) to a file.",
     args: [{ name: "id", required: true, description: "The guest list's id." }],
     flags: [
       {
         name: "kind",
         type: "string",
         description: "caterer (meals and diets per table), venue (who sits where) or floor-plan (PDF)."
+      },
+      {
+        name: "out",
+        type: "string",
+        description: "Where to save the floor plan (default: the name the API gives it)."
       }
     ],
     scopes: ["contacts:read"],
     returns: "string",
-    notes: "Redirect to a file: `do guest-lists export <id> --kind floor-plan > plan.pdf`."
+    notes: "A CSV goes to stdout (`> tables.csv`); the floor plan is saved: `do guest-lists export <id> --kind floor-plan --out plan.pdf`."
   },
   {
     path: ["rsvp-links", "list"],
@@ -35927,6 +36371,33 @@ function renderJournalSearch(data, mode) {
     return paint(mode, "dim", "(no journal days mention that)");
   return renderJournalDays({ days: d.days }, mode);
 }
+function renderJournalRecall(data, mode) {
+  const d = data;
+  const head = [
+    d.q ? `\u201C${d.q}\u201D` : null,
+    d.from && d.to ? `${d.from} \u2013 ${d.to}` : null,
+    d.average != null ? `avg ${d.average} over ${d.rated} rated` : null
+  ].filter(Boolean).join(" \xB7 ");
+  const out = head ? [paint(mode, "dim", head)] : [];
+  out.push((d.days ?? []).length === 0 ? paint(mode, "dim", "(no journal day answers that)") : renderJournalDays({ days: d.days }, mode));
+  if ((d.milestones ?? []).length > 0) {
+    out.push("", paint(mode, "dim", "Milestones near"));
+    for (const m of d.milestones ?? [])
+      out.push(`  \u25C6 ${m.title}${paint(mode, "dim", ` \xB7 ${m.happenedOn}${m.planned ? " (planned)" : ""}`)}`);
+  }
+  if ((d.earlier ?? []).length > 0) {
+    out.push("", paint(mode, "dim", "On this day"));
+    for (const e of d.earlier ?? []) {
+      const rating = e.rating == null ? "" : paint(mode, "dim", `  ${e.rating}/10`);
+      out.push(`  ${e.date}  ${e.title ?? paint(mode, "dim", "(no entry)")}${rating}`);
+    }
+  }
+  return out.join(`
+`);
+}
+function renderJournalDigest(data) {
+  return data.text ?? "";
+}
 function renderJournalImportScan(data, mode) {
   const d = data;
   const items = d.items;
@@ -37055,6 +37526,27 @@ var HANDLERS = {
       render: renderJournalSearch
     };
   },
+  "journal recall": async ({ args, flags, requireClient }) => {
+    const q = args.join(" ").trim() || undefined;
+    if (q !== undefined && q.length < 2)
+      throw usageError("journal recall needs 2+ characters");
+    const query = {
+      q,
+      around: flagString(flags, "around"),
+      from: flagString(flags, "from"),
+      to: flagString(flags, "to"),
+      limit: flagString(flags, "limit")
+    };
+    parseInput(journalRecallQuerySchema, Object.fromEntries(Object.entries(query).filter(([, v]) => v !== undefined)));
+    return {
+      data: await requireClient().get("/journal/recall", { query }),
+      render: renderJournalRecall
+    };
+  },
+  "journal digest": async ({ requireClient }) => ({
+    data: await requireClient().get("/journal/digest"),
+    render: renderJournalDigest
+  }),
   "journal week": async ({ args, requireClient }) => {
     const week = journalWeekArg(args, "week");
     return {
@@ -37531,6 +38023,32 @@ var HANDLERS = {
       render: renderRecord
     };
   },
+  "documents ask": async ({ args, flags, requireClient }) => {
+    const question = args.join(" ").trim();
+    if (!question)
+      throw usageError('documents ask needs a question ("Is water damage covered?")');
+    const limit = flagString(flags, "limit");
+    const body = Object.fromEntries(Object.entries({
+      question,
+      documentId: flagString(flags, "document"),
+      limit: limit === undefined ? undefined : Number(limit)
+    }).filter(([, value]) => value !== undefined));
+    return { data: await requireClient().post("/documents/ask", body), render: renderRecord };
+  },
+  "documents search": async ({ args, flags, requireClient }) => {
+    const q = args.join(" ").trim();
+    if (!q)
+      throw usageError("documents search needs the words to find");
+    const query = Object.fromEntries(Object.entries({
+      q,
+      documentId: flagString(flags, "document"),
+      limit: flagString(flags, "limit")
+    }).filter(([, value]) => value !== undefined));
+    return {
+      data: await requireClient().get("/documents/search", { query }),
+      render: renderRecord
+    };
+  },
   "documents unmatched": async ({ requireClient }) => ({
     data: await requireClient().get("/documents/unmatched"),
     render: renderList
@@ -39266,6 +39784,14 @@ var HANDLERS = {
     data: await requireClient().delete(`/health/shares/${requireArg(args, 0, "id")}`),
     render: renderRecord
   }),
+  "health google status": async ({ requireClient }) => ({
+    data: await requireClient().get("/health/google-health"),
+    render: renderRecord
+  }),
+  "health google sync": async ({ requireClient }) => ({
+    data: await requireClient().post("/health/google-health/sync", {}),
+    render: renderRecord
+  }),
   "health consent": async ({ requireClient }) => ({
     data: await requireClient().get("/health/consent"),
     render: renderRecord
@@ -39605,6 +40131,21 @@ var HANDLERS = {
     const body = parseInput(markGuestsSentInputSchema, readDataFlag(flags));
     return { data: await requireClient().post("/guests/sent", body), render: renderRecord };
   },
+  "rsvp-answers list": async ({ flags, requireClient }) => {
+    const list = flagString(flags, "list");
+    if (!list)
+      throw usageError("rsvp-answers list needs --list <guest list id>");
+    const household = flagString(flags, "household");
+    const query = parseInput(rsvpAnswersQuerySchema, {
+      guestListId: list,
+      ...household ? { householdId: household } : {}
+    });
+    return { data: await requireClient().get("/rsvp-answers", { query }), render: renderRecord };
+  },
+  "rsvp-answers set": async ({ flags, requireClient }) => {
+    const body = parseInput(setRsvpAnswersInputSchema, readDataFlag(flags));
+    return { data: await requireClient().put("/rsvp-answers", body), render: renderRecord };
+  },
   "seating-proposals list": async ({ flags, requireClient }) => {
     const list = flagString(flags, "list");
     if (!list)
@@ -39682,7 +40223,17 @@ var HANDLERS = {
   "guest-lists export": async ({ args, flags, requireClient }) => {
     const id = requireArg(args, 0, "guest list id");
     const kind = parseInput(guestExportKindSchema, flagString(flags, "kind") ?? "venue");
-    const raw = await requireClient().getText(`/guest-lists/${id}/exports/${kind}`);
+    const path = `/guest-lists/${id}/exports/${kind}`;
+    if (kind === "floor-plan") {
+      const file = await requireClient().getBytes(path);
+      const out = flagString(flags, "out") ?? basename2(file.name ?? "floor-plan.pdf");
+      writeFileSync2(out, file.bytes);
+      return {
+        data: { id, kind, saved: out, size: file.bytes.byteLength, type: file.contentType },
+        render: renderRecord
+      };
+    }
+    const raw = await requireClient().getText(path);
     return { raw, data: undefined, render: () => raw };
   },
   "rsvp-links list": async ({ flags, requireClient }) => {

package/package.json

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