@robbeverhelst/do 1.297.0 → 1.299.0

package/dist/do.js

@@ -4516,6 +4516,21 @@ var sensorLinks = pgTable("sensor_links", {
   index("sensor_links_node_idx").on(t.nodeId)
 ]);
 
+// ../../packages/schema/src/db/tap-tags.ts
+var tapTagKind = pgEnum("tap_tag_kind", ["habit", "routine"]);
+var tapTags = pgTable("tap_tags", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  label: text("label").notNull(),
+  kind: tapTagKind("kind").notNull(),
+  targetId: text("target_id").notNull().references(() => nodes.id),
+  createdBy: text("created_by").references(() => users.id, { onDelete: "set null" }),
+  lastTappedAt: timestamp("last_tapped_at", { withTimezone: true }),
+  lastTappedBy: text("last_tapped_by").references(() => users.id, { onDelete: "set null" }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [index("tap_tags_tenant_idx").on(t.tenantId), index("tap_tags_target_idx").on(t.targetId)]);
+
 // ../../packages/schema/src/db/planning-rules.ts
 var planningRuleKind = pgEnum("planning_rule_kind", [
   "fixed_time",
@@ -5047,6 +5062,38 @@ var contactCircles = pgTable("contact_circles", {
   primaryKey({ columns: [t.contactId, t.circleId] }),
   index("contact_circles_circle_idx").on(t.circleId)
 ]);
+var personProposalKind = pgEnum("person_proposal_kind", [
+  "birth",
+  "move",
+  "new_job",
+  "wedding",
+  "engagement",
+  "death",
+  "other"
+]);
+var personProposalStatus = pgEnum("person_proposal_status", [
+  "pending",
+  "accepted",
+  "skipped"
+]);
+var personProposals = pgTable("person_proposals", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  userId: text("user_id").notNull().references(() => users.id),
+  contactId: text("contact_id").notNull().references(() => contacts.id, { onDelete: "cascade" }),
+  kind: personProposalKind("kind").notNull().default("other"),
+  title: text("title").notNull(),
+  source: text("source").notNull(),
+  heardAt: timestamp("heard_at", { withTimezone: true }).notNull(),
+  items: jsonb("items").$type().notNull(),
+  status: personProposalStatus("status").notNull().default("pending"),
+  decidedAt: timestamp("decided_at", { withTimezone: true }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  uniqueIndex("person_proposals_source_uniq").on(t.tenantId, t.userId, t.source),
+  index("person_proposals_user_status_idx").on(t.tenantId, t.userId, t.status)
+]);
 
 // ../../packages/schema/src/db/files.ts
 var bytea = customType({
@@ -5096,6 +5143,7 @@ var households = pgTable("households", {
   address: jsonb("address").$type(),
   language: text("language").notNull().default("nl"),
   group: boolean("group").notNull().default(false),
+  addressConfirmedAt: timestamp("address_confirmed_at", { withTimezone: true }),
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
   updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [index("households_tenant_idx").on(t.tenantId)]);
@@ -5109,6 +5157,9 @@ var guestLists = pgTable("guest_lists", {
   rsvpKeyDateId: text("rsvp_key_date_id").references(() => keyDates.id, {
     onDelete: "set null"
   }),
+  finalInfoKeyDateId: text("final_info_key_date_id").references(() => keyDates.id, {
+    onDelete: "set null"
+  }),
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
   updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [uniqueIndex("guest_lists_project_uniq").on(t.tenantId, t.projectId)]);
@@ -5162,12 +5213,15 @@ var guests = pgTable("guests", {
   uniqueIndex("guests_list_contact_uniq").on(t.guestListId, t.contactId),
   index("guests_contact_idx").on(t.contactId)
 ]);
+var rsvpLinkMode = pgEnum("rsvp_link_mode", ["address", "full"]);
 var rsvpLinks = pgTable("rsvp_links", {
   id: text("id").primaryKey(),
   tenantId: text("tenant_id").notNull().references(() => tenants.id),
   guestListId: text("guest_list_id").notNull().references(() => guestLists.id, { onDelete: "cascade" }),
   householdId: text("household_id").notNull().references(() => households.id),
   tokenHash: text("token_hash").notNull().unique(),
+  mode: rsvpLinkMode("mode").notNull().default("full"),
+  tokenSealed: text("token_sealed"),
   expiresAt: timestamp("expires_at", { withTimezone: true }).notNull(),
   revokedAt: timestamp("revoked_at", { withTimezone: true }),
   lastUsedAt: timestamp("last_used_at", { withTimezone: true }),
@@ -5448,6 +5502,7 @@ var EVIDENCE_SOURCES = [
   "routine_run",
   "do_activity",
   "github",
+  "phone_location",
   "plan_default"
 ];
 var blockEvidence = pgTable("block_evidence", {
@@ -5464,7 +5519,7 @@ var blockEvidence = pgTable("block_evidence", {
 }, (t) => [
   index("block_evidence_block_idx").on(t.blockId, t.at),
   check("block_evidence_weight_range", sql`${t.weight} BETWEEN 1 AND 5`),
-  check("block_evidence_source_check", sql`${t.source} IN ('chat', 'edit_do', 'edit_google', 'google_health', 'wakehook', 'strava', 'habit', 'task', 'routine_run', 'do_activity', 'github', 'plan_default')`)
+  check("block_evidence_source_check", sql`${t.source} IN ('chat', 'edit_do', 'edit_google', 'google_health', 'wakehook', 'strava', 'habit', 'task', 'routine_run', 'do_activity', 'github', 'phone_location', 'plan_default')`)
 ]);
 
 // ../../packages/schema/src/db/food-log.ts
@@ -20635,7 +20690,8 @@ var habitTodayItemSchema = object({
     source: habitEntrySourceSchema,
     by: string2().optional(),
     at: exports_coerce.date()
-  }).nullable().default(null)
+  }).nullable().default(null),
+  private: boolean3().default(false)
 });
 var habitTodayRoutineSchema = object({
   routineId: ulidSchema,
@@ -20658,9 +20714,20 @@ var METRICS = {
   mood: { label: "Mood", unit: "/5", min: 1, max: 5, step: 1 },
   rating: { label: "Day rating", unit: "/10", min: 1, max: 10, step: 1 },
   energy: { label: "Energy", unit: "/10", min: 1, max: 10, step: 1 },
-  bedtime: { label: "Bedtime", unit: "clock", min: 0, max: 720, step: 5 }
+  bedtime: { label: "Bedtime", unit: "clock", min: 0, max: 720, step: 5 },
+  resting_hr: { label: "Resting heart rate", unit: "bpm", min: 25, max: 200, step: 1 },
+  hrv: { label: "HRV", unit: "ms", min: 1, max: 400, step: 1 }
 };
-var metricKeySchema = _enum2(["weight", "sleep", "mood", "rating", "energy", "bedtime"]);
+var metricKeySchema = _enum2([
+  "weight",
+  "sleep",
+  "mood",
+  "rating",
+  "energy",
+  "bedtime",
+  "resting_hr",
+  "hrv"
+]);
 var metricSourceSchema = _enum2([
   "manual",
   "device",
@@ -22055,6 +22122,29 @@ var animalLostCardStateSchema = object({
   photos: array(animalLostCardPhotoSchema),
   chipOnFile: boolean3()
 });
+var animalAcquisitionInputSchema = object({
+  pickUpOn: keyDateDaySchema.nullish(),
+  quarantine: boolean3().optional(),
+  extraSteps: array(string2().trim().min(1).max(200)).max(10).optional()
+}).strict();
+var animalAcquisitionStepSchema = object({
+  id: ulidSchema,
+  title: string2(),
+  done: boolean3(),
+  quarantine: boolean3()
+});
+var animalAcquisitionSchema = object({
+  taskId: ulidSchema,
+  title: string2(),
+  pickUpOn: string2().nullable(),
+  arrived: boolean3(),
+  steps: array(animalAcquisitionStepSchema),
+  blockers: array(string2())
+});
+var animalArrivedInputSchema = object({
+  on: keyDateDaySchema.optional(),
+  quarantineMonths: number2().int().min(0).max(12).optional()
+}).strict();
 
 // ../../packages/schema/src/contracts/sensors.ts
 var sensorProviderValues = ["home_assistant", "unifi"];
@@ -22065,7 +22155,8 @@ var PLACE_SENSOR_READINGS = Object.keys(SHED_READING_TYPES);
 var ASSET_READING_TYPES = {
   state: "asset.state",
   power: "asset.power",
-  energy: "asset.energy"
+  energy: "asset.energy",
+  presence: "asset.presence"
 };
 var ASSET_SENSOR_READINGS = Object.keys(ASSET_READING_TYPES);
 var sensorReadingValues = [
@@ -22138,6 +22229,27 @@ var assetReadingSchema = object({
   device: string2().nullable(),
   at: exports_coerce.date()
 });
+var unifiLinkInputSchema = object({
+  baseUrl: string2().trim().url().refine((u) => /^https?:\/\//i.test(u), "must start with http:// or https://"),
+  apiKey: string2().trim().min(1).max(500),
+  site: string2().trim().min(1).max(100).default("default")
+}).strict();
+var unifiStatusSchema = object({
+  linked: boolean3(),
+  host: string2().nullable(),
+  site: string2().nullable(),
+  links: number2().int().nonnegative(),
+  lastReadingAt: string2().nullable()
+});
+var unifiDeviceSchema = object({
+  mac: string2(),
+  name: string2(),
+  kind: _enum2(["device", "client"]),
+  model: string2().nullable(),
+  online: boolean3(),
+  firmware: string2().nullable(),
+  link: sensorLinkSchema.nullable()
+});
 
 // ../../packages/schema/src/contracts/house.ts
 var day = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "must be a calendar day (YYYY-MM-DD)");
@@ -22927,12 +23039,15 @@ var healthProfileSchema = createSelectSchema(healthProfiles, {
   notes: string2().nullable().default(null),
   sex: string2().nullable().default(null)
 });
+var HEALTH_CONSENT_VERSION = "2026-10-18";
 var healthConsentStateSchema = object({
   granted: boolean3(),
   version: string2().nullable(),
-  grantedAt: exports_coerce.date().nullable()
+  grantedAt: exports_coerce.date().nullable(),
+  currentVersion: string2().default(HEALTH_CONSENT_VERSION),
+  renewalNeeded: boolean3().default(false),
+  aiProvider: string2().nullable().default(null)
 });
-var HEALTH_CONSENT_VERSION = "2026-10-18";
 var subject = { subjectNodeId: ulidSchema.nullish() };
 var createHealthConditionInputSchema = object({
   id: ulidSchema.optional(),
@@ -23473,10 +23588,17 @@ var JOURNAL_SEARCH_LIMIT = 30;
 var journalSearchQuerySchema = object({
   q: string2().trim().min(2, "search for at least 2 characters").max(100)
 });
+var journalSearchUnderstoodSchema = object({
+  words: array(string2()),
+  from: journalDateSchema.nullable(),
+  to: journalDateSchema.nullable(),
+  feeling: _enum2(["low", "high"]).nullable()
+});
 var journalSearchSchema = object({
   q: string2(),
   timezone: string2().min(1),
-  days: array(journalDayListItemSchema).max(JOURNAL_SEARCH_LIMIT)
+  days: array(journalDayListItemSchema).max(JOURNAL_SEARCH_LIMIT),
+  understood: journalSearchUnderstoodSchema.nullable().default(null)
 });
 var journalLinkInputSchema = object({
   kind: string2().trim().regex(/^[a-z][a-z_]{0,31}$/, "a link kind is a short lowercase word"),
@@ -23799,6 +23921,60 @@ var journalWeekSchema = object({
   usual: number2().nullable(),
   numbers: journalWeekNumbersSchema
 });
+var journalMonthKeySchema = string2().regex(/^\d{4}-(0[1-9]|1[0-2])$/, "must be a month (YYYY-MM)");
+var journalYearKeySchema = string2().regex(/^\d{4}$/, "must be a year (YYYY)");
+var journalPeriodKeySchema = union([
+  journalWeekKeySchema,
+  journalMonthKeySchema,
+  journalYearKeySchema
+]);
+function journalPeriodKind(key) {
+  if (journalWeekKeySchema.safeParse(key).success)
+    return "week";
+  if (journalMonthKeySchema.safeParse(key).success)
+    return "month";
+  if (journalYearKeySchema.safeParse(key).success)
+    return "year";
+  return null;
+}
+var journalPeriodMilestoneSchema = object({
+  id: string2(),
+  title: string2(),
+  kind: journalMilestoneKindSchema,
+  happenedOn: journalDateSchema,
+  precision: journalMilestonePrecisionSchema,
+  planned: boolean3()
+});
+var journalMonthSchema = object({
+  month: journalMonthKeySchema,
+  from: journalDateSchema,
+  to: journalDateSchema,
+  timezone: string2().min(1),
+  recap: journalRecapSchema.nullable(),
+  days: array(journalDayListItemSchema),
+  usual: number2().nullable(),
+  numbers: journalWeekNumbersSchema,
+  milestones: array(journalPeriodMilestoneSchema)
+});
+var journalYearMonthSchema = object({
+  month: journalMonthKeySchema,
+  average: number2().nullable(),
+  rated: number2().int().nonnegative(),
+  kept: number2().int().nonnegative(),
+  best: journalDateSchema.nullable()
+});
+var journalYearSchema = object({
+  year: journalYearKeySchema,
+  from: journalDateSchema,
+  to: journalDateSchema,
+  timezone: string2().min(1),
+  recap: journalRecapSchema.nullable(),
+  days: array(journalDayListItemSchema),
+  months: array(journalYearMonthSchema),
+  usual: number2().nullable(),
+  numbers: journalWeekNumbersSchema,
+  milestones: array(journalPeriodMilestoneSchema)
+});
 
 // ../../packages/schema/src/contracts/modules.ts
 var MODULE_KEYS = [
@@ -25258,6 +25434,43 @@ var personNoteUndoResultSchema = object({
   id: ulidSchema,
   removed: number2().int()
 });
+var personProposalKindSchema = _enum2(personProposalKind.enumValues);
+var personProposalStatusSchema = _enum2(personProposalStatus.enumValues);
+var mailSourceSchema = string2().trim().regex(/^gmail:[A-Za-z0-9_-]{1,100}$/, "a mail source is gmail:<message id>");
+var createPersonProposalInputSchema = object({
+  id: ulidSchema,
+  contactId: ulidSchema.optional(),
+  person: string2().trim().min(1).max(120).optional(),
+  kind: personProposalKindSchema.default("other"),
+  title: string2().trim().min(1).max(200),
+  source: mailSourceSchema,
+  heardAt: exports_coerce.date(),
+  items: array(personNoteItemSchema).min(1).max(10).optional()
+}).strict().refine((n) => Boolean(n.contactId) !== Boolean(n.person), {
+  message: "name the person by contactId or by person, not both",
+  path: ["contactId"]
+});
+var personProposalSchema = object({
+  id: ulidSchema,
+  contactId: ulidSchema,
+  contactTitle: string2(),
+  kind: personProposalKindSchema,
+  title: string2(),
+  source: string2(),
+  heardAt: exports_coerce.date(),
+  items: array(personNoteItemSchema),
+  status: personProposalStatusSchema,
+  decidedAt: exports_coerce.date().nullable(),
+  createdAt: exports_coerce.date()
+});
+var personProposalsQuerySchema = object({
+  status: personProposalStatusSchema.optional(),
+  source: mailSourceSchema.optional()
+});
+var personProposalAcceptResultSchema = object({
+  proposal: personProposalSchema,
+  receipt: personNoteReceiptSchema
+});
 var personFindQuerySchema = object({
   q: string2().trim().min(1).max(120),
   limit: exports_coerce.number().int().min(1).max(20).optional()
@@ -25360,6 +25573,7 @@ var peopleOverviewSchema = object({
     phone: string2().nullable().default(null)
   })),
   heardLately: array(contactMomentViewSchema),
+  proposals: array(personProposalSchema).default([]),
   lent: array(object({
     itemId: ulidSchema,
     title: string2(),
@@ -26094,7 +26308,8 @@ var warrantyFieldsSchema = object({
   amount: amount4,
   purchaseDate: keyDateDaySchema,
   warrantyMonths: number2().int().min(0).max(600),
-  serial: text4
+  serial: text4,
+  room: text4
 }).partial().strict();
 var payToIban = string2().transform(compactIban).pipe(string2().regex(/^[A-Z]{2}\d{2}[A-Z0-9]{8,30}$/, "expected an IBAN"));
 var payRef = string2().trim().min(1).max(140);
@@ -26351,6 +26566,44 @@ var incidentsQuerySchema = object({
   policyId: ulidSchema.optional()
 });
 
+// ../../packages/schema/src/contracts/tap-tags.ts
+var tapTagKindSchema = _enum2(tapTagKind.enumValues);
+var tapTagViewSchema = object({
+  id: string2(),
+  label: string2(),
+  kind: tapTagKindSchema,
+  targetId: string2(),
+  targetTitle: string2(),
+  path: string2(),
+  lastTappedAt: exports_coerce.date().nullable(),
+  createdAt: exports_coerce.date()
+});
+var labelSchema = string2().trim().min(1).max(80);
+var createTapTagInputSchema = object({
+  id: ulidSchema,
+  label: labelSchema,
+  kind: tapTagKindSchema,
+  targetId: string2().min(1)
+}).strict();
+var updateTapTagInputSchema = object({
+  label: labelSchema.optional(),
+  kind: tapTagKindSchema.optional(),
+  targetId: string2().min(1).optional()
+}).strict().refine((v) => v.kind === undefined === (v.targetId === undefined), {
+  message: "kind and targetId are changed together",
+  path: ["targetId"]
+}).refine((v) => Object.keys(v).length > 0, { message: "nothing to change" });
+var tapUndoSchema = discriminatedUnion("kind", [
+  object({ kind: literal("habit_entry"), habitId: string2(), entryId: string2() }),
+  object({ kind: literal("routine_run"), runId: string2(), stepRunIds: array(string2()) })
+]);
+var tapResultSchema = object({
+  tag: tapTagViewSchema,
+  outcome: _enum2(["done", "already"]),
+  line: string2(),
+  undo: tapUndoSchema.nullable()
+});
+
 // ../../packages/schema/src/contracts/planning-rules.ts
 var PLANNING_RULE_KINDS = planningRuleKind.enumValues;
 var planningRuleKindSchema = _enum2(PLANNING_RULE_KINDS);
@@ -27237,6 +27490,7 @@ var householdAddressSchema = object({
 var householdRowSchema = createSelectSchema(households, {
   address: householdAddressSchema.nullable(),
   group: boolean3().default(false),
+  addressConfirmedAt: exports_coerce.date().nullable(),
   createdAt: exports_coerce.date(),
   updatedAt: exports_coerce.date()
 });
@@ -27264,6 +27518,7 @@ var guestListSchema = createSelectSchema(guestLists, {
 var guestListViewSchema = guestListSchema.extend({
   projectTitle: string2(),
   rsvpBy: keyDateDaySchema.nullable(),
+  finalInfoFrom: keyDateDaySchema.nullable().default(null),
   projectDay: keyDateDaySchema.nullable().default(null)
 });
 var createGuestListInputSchema = object({
@@ -27272,7 +27527,8 @@ var createGuestListInputSchema = object({
   tiers: array(guestTierSchema).min(1).max(6).optional(),
   caps: capsSchema.optional(),
   sides: array(sideSchema).max(4).optional(),
-  rsvpBy: keyDateDaySchema.nullish()
+  rsvpBy: keyDateDaySchema.nullish(),
+  finalInfoFrom: keyDateDaySchema.nullish()
 }).strict();
 var updateGuestListInputSchema = createGuestListInputSchema.omit({ id: true, projectId: true }).partial().strict();
 var guestListsQuerySchema = object({ projectId: ulidSchema.optional() });
@@ -27344,6 +27600,7 @@ var guestListOverviewSchema = object({
     householdId: ulidSchema.nullable(),
     title: string2(),
     address: householdAddressSchema.nullable(),
+    addressConfirmedAt: exports_coerce.date().nullable(),
     language: rsvpLanguageSchema,
     group: boolean3().default(false),
     guests: array(guestViewSchema)
@@ -27369,16 +27626,20 @@ var guestListOverviewSchema = object({
   })
 });
 var RSVP_TOKEN_RE = /^rsvp_[A-Za-z0-9_-]{43}$/;
+var RSVP_LINK_MODES = ["address", "full"];
+var rsvpLinkModeSchema = _enum2(RSVP_LINK_MODES);
 var rsvpLinkSchema = object({
   id: ulidSchema,
   guestListId: ulidSchema,
   householdId: ulidSchema,
   householdTitle: string2(),
+  mode: rsvpLinkModeSchema,
   expiresAt: exports_coerce.date(),
   revokedAt: exports_coerce.date().nullable(),
   lastUsedAt: exports_coerce.date().nullable(),
   createdAt: exports_coerce.date(),
-  live: boolean3()
+  live: boolean3(),
+  revealable: boolean3()
 });
 var mintedRsvpLinkSchema = rsvpLinkSchema.extend({
   token: string2().regex(RSVP_TOKEN_RE),
@@ -27387,6 +27648,7 @@ var mintedRsvpLinkSchema = rsvpLinkSchema.extend({
 var createRsvpLinksInputSchema = object({
   guestListId: ulidSchema,
   householdIds: array(ulidSchema).min(1).max(500).optional(),
+  mode: rsvpLinkModeSchema.optional(),
   expiresAt: exports_coerce.date().optional()
 }).strict();
 var rsvpLinksQuerySchema = object({ guestListId: ulidSchema });
@@ -27398,14 +27660,29 @@ var publicRsvpGuestSchema = object({
   rsvp: answersSchema,
   diet: string2().nullable(),
   plusOne: boolean3(),
-  plusOneName: string2().nullable()
+  plusOneName: string2().nullable(),
+  table: string2().nullable().default(null)
+}).strict();
+var publicRsvpEventSchema = object({
+  key: guestTierSchema,
+  name: object({ nl: string2().optional(), pt: string2().optional() }),
+  startsAt: exports_coerce.date().nullable(),
+  endsAt: exports_coerce.date().nullable(),
+  placeName: string2().nullable(),
+  address: string2().nullable(),
+  mapUrl: string2().nullable(),
+  dressCode: object({ nl: string2().optional(), pt: string2().optional() }).nullable(),
+  note: object({ nl: string2().optional(), pt: string2().optional() }).nullable()
 }).strict();
 var publicRsvpViewSchema = object({
+  mode: rsvpLinkModeSchema,
   language: rsvpLanguageSchema,
   event: string2(),
   household: string2(),
   rsvpBy: keyDateDaySchema.nullable(),
+  finalInfoFrom: keyDateDaySchema.nullable().default(null),
   tiers: array(guestTierSchema),
+  events: array(publicRsvpEventSchema).default([]),
   guests: array(publicRsvpGuestSchema),
   address: householdAddressSchema.nullable(),
   answeredAt: exports_coerce.date().nullable()
@@ -27417,9 +27694,12 @@ var submitRsvpInputSchema = object({
     diet: string2().trim().max(200).nullish(),
     plusOneName: string2().trim().max(120).nullish(),
     email: string2().trim().email().max(254).nullish()
-  }).strict()).min(1).max(30),
-  address: householdAddressSchema.nullish()
-}).strict();
+  }).strict()).max(30).default([]),
+  address: householdAddressSchema.nullish(),
+  language: rsvpLanguageSchema.optional()
+}).strict().refine((i) => i.guests.length > 0 || !!i.address || !!i.language, {
+  message: "nothing to send: answers, an address or a language"
+});
 var eventTextSchema = (max) => object({
   nl: string2().trim().min(1).max(max).optional(),
   pt: string2().trim().min(1).max(max).optional()
@@ -27488,7 +27768,7 @@ var createSeatingProposalInputSchema = object({
   return new Set(ids).size === ids.length;
 }, { message: "a guest can sit at one table only", path: ["tables"] });
 var seatingProposalsQuerySchema = object({ guestListId: ulidSchema });
-var GUEST_EXPORT_KINDS = ["caterer", "venue", "floor-plan", "church"];
+var GUEST_EXPORT_KINDS = ["caterer", "venue", "floor-plan", "church", "answers"];
 var guestExportKindSchema = _enum2(GUEST_EXPORT_KINDS);
 var thankYouGiftSchema = object({
   momentId: ulidSchema,
@@ -27829,6 +28109,52 @@ var googleContactsImportResultSchema = object({
   missing: array(string2())
 });
 
+// ../../packages/schema/src/contracts/github.ts
+var GITHUB_RESOURCES = ["commits", "pull_requests", "issues"];
+var githubResourceSchema = _enum2(GITHUB_RESOURCES);
+var githubBase = {
+  repo: string2().min(1),
+  url: string2().min(1)
+};
+var githubCommitValueSchema = object({
+  ...githubBase,
+  sha: string2().min(1),
+  message: string2().default(""),
+  by: _enum2(["human", "agent"]).optional(),
+  agent: string2().nullish()
+}).strict();
+var githubPullRequestValueSchema = object({
+  ...githubBase,
+  number: number2().int().positive(),
+  title: string2().default(""),
+  state: string2().min(1),
+  merged: boolean3().default(false)
+}).strict();
+var githubIssueValueSchema = object({
+  ...githubBase,
+  number: number2().int().positive(),
+  title: string2().default(""),
+  state: string2().min(1)
+}).strict();
+var githubCommitsQuerySchema = object({
+  days: exports_coerce.number().int().refine((d) => d === 7 || d === 30, "7 or 30").default(7)
+});
+var githubCommitsDaySchema = object({
+  day: string2(),
+  byYou: number2().int(),
+  byAgents: number2().int()
+});
+var githubCommitsSchema = object({
+  days: number2().int(),
+  from: string2(),
+  to: string2(),
+  byYou: number2().int(),
+  byAgents: number2().int(),
+  unsorted: number2().int(),
+  agents: array(object({ name: string2(), count: number2().int() })),
+  perDay: array(githubCommitsDaySchema)
+});
+
 // ../../packages/schema/src/contracts/calendar.ts
 var calendarEventLinkSchema = createSelectSchema(calendarEventLinks, {
   createdAt: exports_coerce.date(),
@@ -29421,7 +29747,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.297.0";
+var VERSION = "1.299.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -30326,6 +30652,22 @@ var ENTITIES = [
       canDelete: true
     }
   },
+  {
+    name: "tap-tags",
+    path: "/tap-tags",
+    readScope: "habits:read",
+    returns: "TapTagView",
+    canGet: true,
+    listFlags: [],
+    write: {
+      scope: "habits:write",
+      createSchema: createTapTagInputSchema,
+      createInput: "CreateTapTagInput",
+      updateSchema: updateTapTagInputSchema,
+      updateInput: "UpdateTapTagInput",
+      canDelete: true
+    }
+  },
   {
     name: "animals",
     path: "/animals",
@@ -30584,7 +30926,8 @@ var HEALTH_COMMAND_SPECS = [
     args: [],
     flags: [],
     scopes: READ,
-    returns: "HealthConsentState"
+    returns: "HealthConsentState",
+    notes: "`granted` is on at today's consent text (`currentVersion`); `renewalNeeded` means you agreed to an older text, so writes wait until you agree again in do. `aiProvider` names who processes what the agent reads (null when this deployment names none)."
   },
   {
     path: ["health", "profile"],
@@ -30700,6 +31043,21 @@ var HEALTH_COMMAND_SPECS = [
     scopes: READ,
     returns: "HealthSummary"
   },
+  {
+    path: ["health", "export"],
+    summary: "Take every health record with you: one FHIR R4 Bundle (JSON) with the documents inline.",
+    args: [],
+    flags: [
+      {
+        name: "no-files",
+        type: "boolean",
+        description: "Leave the documents' bytes out (their DocumentReferences stay)."
+      }
+    ],
+    scopes: ["health:export"],
+    returns: "HealthExportBundle",
+    notes: "Streams GET /api/v1/health/export verbatim: redirect it to a file (`do health export > health.json`). The export shows in your Who looked."
+  },
   {
     path: ["health", "shares"],
     summary: "Your For-the-doctor links: sections, expiry, opens; never the secret.",
@@ -31316,7 +31674,7 @@ var COMMAND_SPECS = [
     flags: [],
     scopes: ["journal:read"],
     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."
+    notes: "GET /api/v1/journal/search?q= \u2014 your own days only, best match first (at most 30): the words (and a few that mean the same, English and Dutch) in the one-liner, tags, highlights, summary and entries; a date phrase (in March, last week, 14 October, 2026-02) narrows to its window; a heavy or bright question (rough, tired, a great day) adds the days rated 4 or less / 8 or more. `understood` says how it was read. journal:read is a sensitive scope."
   },
   {
     path: ["journal", "recall"],
@@ -31354,10 +31712,34 @@ var COMMAND_SPECS = [
     returns: "JournalWeek",
     notes: "GET /api/v1/journal/weeks/{week} \u2014 your own week only. `recap` is null until one was written. journal:read is a sensitive scope."
   },
+  {
+    path: ["journal", "month"],
+    summary: "One month of the Journal: its recap, its days, the usual rating, the numbers from Progress and the milestones that happened in it.",
+    args: [{ name: "month", required: true, description: "The month, e.g. 2026-10." }],
+    flags: [],
+    scopes: ["journal:read"],
+    returns: "JournalMonth",
+    notes: "GET /api/v1/journal/months/{month} \u2014 your own month only. `recap` is null until one was written; `usual` is the mean rating over the three months before. journal:read is a sensitive scope."
+  },
+  {
+    path: ["journal", "year"],
+    summary: "One year of the Journal: its recap, its days (the rating pixels), each month's average and best day, the usual, the numbers and the year's milestones.",
+    args: [{ name: "year", required: true, description: "The year, e.g. 2026." }],
+    flags: [],
+    scopes: ["journal:read"],
+    returns: "JournalYear",
+    notes: "GET /api/v1/journal/years/{year} \u2014 your own year only. `recap` is null until one was written; `usual` is the mean rating of the year before. journal:read is a sensitive scope."
+  },
   {
     path: ["journal", "recap"],
-    summary: "Write or replace a week's recap: the prose, its best moments and one pattern line.",
-    args: [{ name: "week", required: true, description: "The ISO week, e.g. 2026-W42." }],
+    summary: "Write or replace a week's, a month's or a year's recap: the prose, its best moments and one pattern line.",
+    args: [
+      {
+        name: "period",
+        required: true,
+        description: "The ISO week (2026-W42), the month (2026-10) or the year (2026)."
+      }
+    ],
     flags: [
       { name: "body", type: "string", description: "The recap in markdown." },
       {
@@ -31368,7 +31750,7 @@ var COMMAND_SPECS = [
     ],
     scopes: ["journal:write"],
     returns: "JournalWeek",
-    notes: "PUT /api/v1/journal/weeks/{week}/recap (journal_write_recap). The body replaces the prose; moments and pattern replace theirs when given (pattern null clears it). Returns the week."
+    notes: "PUT /api/v1/journal/weeks/{week}/recap (journal_write_recap), /api/v1/journal/months/{month}/recap or /api/v1/journal/years/{year}/recap, by the period's shape. The body replaces the prose; moments and pattern replace theirs when given (pattern null clears it). Returns the period (a JournalWeek, JournalMonth or JournalYear)."
   },
   {
     path: ["journal", "write"],
@@ -31535,6 +31917,15 @@ var COMMAND_SPECS = [
     returns: "JournalExport",
     notes: "GET /api/v1/journal/export. Prints `nextSince`; pass it as --since next time. do is the record: the files are read-only copies and are overwritten."
   },
+  {
+    path: ["progress", "commits"],
+    summary: "Your GitHub commits: the ones you made, and your agents' on your account.",
+    args: [],
+    flags: [{ name: "days", type: "string", description: "7 (default) or 30." }],
+    scopes: ["habits:read"],
+    returns: "GithubCommits",
+    notes: "GET /api/v1/progress/commits \u2014 your own only. `byYou`, `byAgents` with `agents` by name, `unsorted` (synced before the split) and `perDay`. Only your own commits count toward Insights and a GitHub-sourced habit."
+  },
   {
     path: ["progress", "questions"],
     summary: "Insights' answers: late nights vs the next day, the morning routine, good runs, bedtime, best days, reading.",
@@ -32232,9 +32623,18 @@ var COMMAND_SPECS = [
     returns: "AwayState",
     notes: "GET/PUT /api/v1/habits/away. While away, habits leave Now, reminders stop and plants wait; tasks and events carry on. Reading needs habits:read, setting habits:write."
   },
+  {
+    path: ["tap-tags", "tap"],
+    summary: "Tap a tag as if the phone read its sticker: check its habit in, or mark today's run of its routine done.",
+    args: [{ name: "id", required: true, description: "The tag id (the ULID in /t/<id>)." }],
+    flags: [],
+    scopes: ["habits:write", "routines:write"],
+    returns: "TapResult",
+    notes: "POST /api/v1/tap-tags/{id}/tap. Acts as the key's member; a second tap within 30 s does nothing (outcome already). The receipt's undo names the check-in (DELETE /habits/{habitId}/entries/{entryId}) or the run's steps (POST /routines/runs/{runId}/undo)."
+  },
   {
     path: ["metrics", "list"],
-    summary: "Show weight, sleep, mood, the day rating, energy and bedtime as daily trend lines (no target, no streak).",
+    summary: "Show weight, sleep, mood, the day rating, energy, bedtime, resting heart rate and HRV as daily trend lines (no target, no streak). Resting heart rate and HRV need health:read too.",
     args: [],
     flags: [{ name: "days", type: "string", description: "How far back, 1\u2013730 (default 90)." }],
     scopes: ["habits:read"],
@@ -32242,7 +32642,7 @@ var COMMAND_SPECS = [
   },
   {
     path: ["metrics", "sessions"],
-    summary: "Show workout sessions your connections brought in (Google Fit, Strava), newest first.",
+    summary: "Show workout sessions your connections brought in (Google Fit, Google Health, Strava), newest first.",
     args: [],
     flags: [{ name: "days", type: "string", description: "How far back, 1\u2013365 (default 14)." }],
     scopes: ["habits:read"],
@@ -32250,9 +32650,13 @@ var COMMAND_SPECS = [
   },
   {
     path: ["metrics", "log"],
-    summary: "Log a value: weight (kg), sleep (h), mood (1\u20135), rating (1\u201310), energy (1\u201310) or bedtime (HH:MM).",
+    summary: "Log a value: weight (kg), sleep (h), mood (1\u20135), rating (1\u201310), energy (1\u201310), bedtime (HH:MM), resting_hr (bpm) or hrv (ms; these two need health:write).",
     args: [
-      { name: "key", required: true, description: "weight|sleep|mood|rating|energy|bedtime." },
+      {
+        name: "key",
+        required: true,
+        description: "weight|sleep|mood|rating|energy|bedtime|resting_hr|hrv."
+      },
       {
         name: "value",
         required: true,
@@ -34691,6 +35095,55 @@ var COMMAND_SPECS = [
     returns: "void",
     notes: "DELETE /api/v1/animals/{id}/lost-card. Destructive: a printed QR stops working, so it needs --allow-destructive. Turning it on again makes a new link."
   },
+  {
+    path: ["animals", "acquisition"],
+    summary: "Bringing a planned animal home: its checklist.",
+    args: [{ name: "id", required: true, description: "Animal ULID." }],
+    flags: [],
+    scopes: ["animals:read"],
+    returns: "AnimalAcquisition",
+    notes: 'GET /api/v1/animals/{id}/acquisition. The Task "Bring <name> home", its steps in order, `blockers` to sort before the pick-up (papers its kind needs that aren\'t on file) and `arrived`; 404 when none was planned.'
+  },
+  {
+    path: ["animals", "acquisition-plan"],
+    summary: "Plan bringing a planned animal home: a Task with a step per line of the checklist.",
+    args: [{ name: "id", required: true, description: "Animal ULID." }],
+    flags: [
+      {
+        name: "pick-up",
+        type: "string",
+        description: "The pick-up day, YYYY-MM-DD (the Task's due day)."
+      },
+      {
+        name: "data",
+        type: "string",
+        description: 'JSON: `{ "quarantine": true, "extraSteps": ["Buy a UV lamp"] }`.'
+      }
+    ],
+    scopes: ["animals:write"],
+    returns: "AnimalAcquisition",
+    notes: "POST /api/v1/animals/{id}/acquisition. The steps: the papers its kind needs (DogID, CatID, CITES A, closed ring), the vet check, its home, and the quarantine before it meets the others (on by default for a reptile or a bird). Only a planned animal; one per animal (409)."
+  },
+  {
+    path: ["animals", "arrived"],
+    summary: "A planned animal is home: its status, the quarantine Period, the Task done.",
+    args: [{ name: "id", required: true, description: "Animal ULID." }],
+    flags: [
+      {
+        name: "on",
+        type: "string",
+        description: "The day it came home, YYYY-MM-DD (today by default)."
+      },
+      {
+        name: "quarantine-months",
+        type: "string",
+        description: "How long it stays apart (0\u201312); 3 when its checklist has the quarantine step."
+      }
+    ],
+    scopes: ["animals:write"],
+    returns: "AnimalDetail",
+    notes: "POST /api/v1/animals/{id}/arrived. Sets acquiredOn and the status (`quarantine` with a Period, else `active`); open steps stay open."
+  },
   {
     path: ["runs", "change"],
     summary: "Apply a chat update to a run: its changes, with a receipt and Undo.",
@@ -34812,6 +35265,33 @@ var COMMAND_SPECS = [
     returns: "SensorSyncResult",
     notes: "POST /api/v1/sensors/home-assistant/sync. A room's readings feed its card and the room alarm; an asset's show on its page. Returns entities, written, skipped, missing and the error (unauthorized, unavailable, bad_response). 409 before Home Assistant is linked."
   },
+  {
+    path: ["sensors", "unifi"],
+    summary: "Whether the Space has linked UniFi, how many devices are mapped, the newest reading.",
+    args: [],
+    flags: [],
+    scopes: ["places:read"],
+    returns: "UnifiStatus",
+    notes: "GET /api/v1/sensors/unifi. Linking UniFi (address + API key) is a member's, in Settings \u2192 Home; a key never sees the API key."
+  },
+  {
+    path: ["sensors", "unifi-devices"],
+    summary: "Every device and connected client UniFi sees, with the asset each is mapped to.",
+    args: [],
+    flags: [],
+    scopes: ["places:read", "collections:read"],
+    returns: "UnifiDevice[]",
+    notes: "GET /api/v1/sensors/unifi/devices. Map one with `do sensors map <mac> <asset> --reading presence --provider unifi`, or give the asset `external.unifiMac` on its facet. 409 before UniFi is linked."
+  },
+  {
+    path: ["sensors", "unifi-sync"],
+    summary: "Put every mapped device's presence (online/offline, firmware) on its asset now.",
+    args: [],
+    flags: [],
+    scopes: ["places:write"],
+    returns: "SensorSyncResult",
+    notes: "POST /api/v1/sensors/unifi/sync. Assets whose facet names a UniFi MAC are mapped first; readings land as asset.presence on change, else hourly. The worker does the same every five minutes. 409 before UniFi is linked."
+  },
   {
     path: ["sensors", "links"],
     summary: "The mapped entities, or the ones on one Place or asset.",
@@ -34836,7 +35316,12 @@ var COMMAND_SPECS = [
       {
         name: "reading",
         type: "string",
-        description: "A room's temp|humidity|heater|water|door|feeder|light, or an asset's state|power|energy."
+        description: "A room's temp|humidity|heater|water|door|feeder|light, or an asset's state|power|energy|presence."
+      },
+      {
+        name: "provider",
+        type: "string",
+        description: "home_assistant (default) or unifi: a UniFi device by its MAC, onto an asset's presence."
       },
       { name: "label", type: "string", description: "A name for it (Home Assistant's own)." }
     ],
@@ -34891,6 +35376,52 @@ var COMMAND_SPECS = [
     returns: "RunDetail",
     notes: "PATCH /api/v1/runs/{id}/sessions/{sessionId}."
   },
+  {
+    path: ["people", "propose"],
+    summary: "Propose a life event read in the member's mail; nothing is written until they save it.",
+    args: [],
+    flags: [
+      {
+        name: "data",
+        type: "string",
+        description: 'JSON CreatePersonProposalInput, e.g. {"person":"Sam","kind":"birth","title":"Baby girl, Mila","source":"gmail:18c2f0a1b2","heardAt":"2026-10-18T08:00:00Z"}.'
+      }
+    ],
+    scopes: ["contacts:write"],
+    returns: "PersonProposal",
+    notes: "Needs a member's key and PEOPLE_MAIL_PROPOSALS_ENABLED on the server (else forbidden). Kinds: birth, move, new_job, wedding, engagement, death, other. Without items, saving writes one life update (the title, on heardAt). The same mail again returns the proposal it already made. Only the member whose key it is sees it."
+  },
+  {
+    path: ["people", "proposals"],
+    summary: "Your life events from mail: pending, saved or skipped.",
+    args: [],
+    flags: [
+      { name: "status", type: "string", description: "pending, accepted or skipped." },
+      {
+        name: "source",
+        type: "string",
+        description: "gmail:<id>: whether this mail was proposed already (the watch dedupes with it)."
+      }
+    ],
+    scopes: ["contacts:read"],
+    returns: "PersonProposal"
+  },
+  {
+    path: ["people", "accept"],
+    summary: "Save a proposal: write its life update (and its items) on the person.",
+    args: [{ name: "id", required: true, description: "The proposal's id." }],
+    flags: [],
+    scopes: ["contacts:write"],
+    returns: "PersonProposalAcceptResult"
+  },
+  {
+    path: ["people", "skip"],
+    summary: "Skip a proposal: nothing is written, and the mail isn't proposed again.",
+    args: [{ name: "id", required: true, description: "The proposal's id." }],
+    flags: [],
+    scopes: ["contacts:write"],
+    returns: "PersonProposal"
+  },
   {
     path: ["runs", "sessions", "delete"],
     summary: "Delete a session (its changes stay applied; destructive).",
@@ -35248,13 +35779,13 @@ var COMMAND_SPECS = [
   },
   {
     path: ["guest-lists", "export"],
-    summary: "Export for the caterer (CSV) or the venue (CSV) to stdout, or save the floor plan (PDF) to a file.",
+    summary: "Export for the caterer, the venue, the church or the RSVP answers (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)."
+        description: "caterer (meals and diets per table), venue (who sits where), church (who comes to the ceremony), answers (every RSVP answer, a row per guest) or floor-plan (PDF)."
       },
       {
         name: "out",
@@ -35282,13 +35813,30 @@ var COMMAND_SPECS = [
       {
         name: "data",
         type: "string",
-        description: 'JSON CreateRsvpLinksInput, e.g. {"guestListId":"01\u2026"} (every household without a live link) or with "householdIds":["01\u2026"] (re-mints, revoking the old link).'
+        description: 'JSON CreateRsvpLinksInput, e.g. {"guestListId":"01\u2026"} (every household without a live link), "mode":"address" for the save-the-date (address only), or with "householdIds":["01\u2026"] (re-mints, revoking the old link; prefer `do rsvp-links replace`).'
       }
     ],
     scopes: ["contacts:write"],
     returns: "MintedRsvpLink",
     notes: "A guest in no household gets a household of one first. A link stops at the end of the RSVP deadline day (or after 120 days without one) unless expiresAt says otherwise. Send each household its own `path` on the web app."
   },
+  {
+    path: ["rsvp-links", "token"],
+    summary: "Show a live RSVP link again: the same token it was minted with.",
+    args: [{ name: "id", required: true, description: "The link's id." }],
+    flags: [],
+    scopes: ["contacts:write"],
+    returns: "MintedRsvpLink",
+    notes: "The mail and the paper QR carry this one link. A revoked or expired link is gone; one minted before tokens were kept can't be shown: replace it."
+  },
+  {
+    path: ["rsvp-links", "replace"],
+    summary: "Replace an RSVP link: a new token, and the old link (and its QR) stops working.",
+    args: [{ name: "id", required: true, description: "The link's id." }],
+    flags: [],
+    scopes: ["contacts:write"],
+    returns: "MintedRsvpLink"
+  },
   {
     path: ["rsvp-links", "revoke"],
     summary: "Stop one RSVP link working.",
@@ -36761,9 +37309,15 @@ function renderJournalDays(data, mode) {
 }
 function renderJournalSearch(data, mode) {
   const d = data;
-  if ((d.days ?? []).length === 0)
-    return paint(mode, "dim", "(no journal days mention that)");
-  return renderJournalDays({ days: d.days }, mode);
+  const u = d.understood;
+  const read = u && (u.from || u.feeling) ? paint(mode, "dim", `Read as: ${[
+    u.from && u.to ? u.from === u.to ? u.from : `${u.from} \u2013 ${u.to}` : null,
+    ...u.words,
+    u.feeling === "low" ? "heavier days" : u.feeling === "high" ? "brighter days" : null
+  ].filter(Boolean).join(" \xB7 ")}`) : null;
+  const body = (d.days ?? []).length === 0 ? paint(mode, "dim", "(no journal days mention that)") : renderJournalDays({ days: d.days }, mode);
+  return read ? `${read}
+${body}` : body;
 }
 function renderJournalRecall(data, mode) {
   const d = data;
@@ -36866,14 +37420,32 @@ function renderJournalMilestone(data, mode) {
   return out.join(`
 `);
 }
-function renderJournalWeek(data, mode) {
+function renderJournalPeriod(data, mode) {
   const d = data;
-  const out = [`Week ${d.week?.slice(6) ?? "?"}  ${paint(mode, "dim", `${d.from} \u2013 ${d.to}`)}`];
+  const kind = d.week ? "week" : d.month ? "month" : "year";
+  const head = d.week ? `Week ${d.week.slice(6)}` : d.month ?? d.year ?? "?";
+  const out = [`${head}  ${paint(mode, "dim", `${d.from} \u2013 ${d.to}`)}`];
   const days = d.days ?? [];
-  const ratings = days.flatMap((day) => day.metrics?.rating === undefined ? [] : [`${day.date.slice(5)} ${day.metrics.rating}`]);
-  if (ratings.length > 0) {
-    const usual = d.usual == null ? "" : paint(mode, "dim", `  (usual ${d.usual})`);
-    out.push(`${ratings.join(" \xB7 ")}${usual}`);
+  const usual = d.usual == null ? "" : paint(mode, "dim", `  (usual ${d.usual})`);
+  if (kind === "week") {
+    const ratings = days.flatMap((day) => day.metrics?.rating === undefined ? [] : [`${day.date.slice(5)} ${day.metrics.rating}`]);
+    if (ratings.length > 0)
+      out.push(`${ratings.join(" \xB7 ")}${usual}`);
+  } else if (kind === "month") {
+    const ratings = days.flatMap((day) => day.metrics?.rating === undefined ? [] : [day.metrics.rating]);
+    if (ratings.length > 0) {
+      const avg = Math.round(ratings.reduce((a, b) => a + b, 0) / ratings.length * 10) / 10;
+      out.push(`avg ${avg} \xB7 ${ratings.length} rated${usual}`);
+    }
+  } else {
+    for (const m of d.months ?? []) {
+      if (m.rated === 0 && m.kept === 0)
+        continue;
+      const avg = m.average == null ? "\u2014" : String(m.average);
+      out.push(`  ${m.month}  avg ${avg} \xB7 ${m.rated} rated \xB7 ${m.kept} kept`);
+    }
+    if (d.usual != null)
+      out.push(paint(mode, "dim", `  usual ${d.usual} the year before`));
   }
   if (d.recap) {
     out.push("", d.recap.body);
@@ -36885,7 +37457,12 @@ function renderJournalWeek(data, mode) {
     if (d.recap.pattern)
       out.push("", `${paint(mode, "dim", "Pattern")} ${d.recap.pattern}`);
   } else {
-    out.push("", paint(mode, "dim", "(no recap for this week yet)"));
+    out.push("", paint(mode, "dim", `(no recap for this ${kind} yet)`));
+  }
+  if ((d.milestones ?? []).length > 0) {
+    out.push("", paint(mode, "dim", "Milestones"));
+    for (const m of d.milestones ?? [])
+      out.push(`  \u25C6 ${m.title}${paint(mode, "dim", ` \xB7 ${m.happenedOn}`)}`);
   }
   const n = d.numbers;
   if (n) {
@@ -37853,6 +38430,16 @@ var HANDLERS = {
     data: await requireClient().get("/progress/habits"),
     render: renderProgressHabits
   }),
+  "progress commits": async ({ flags, requireClient }) => {
+    const days = flagString(flags, "days");
+    const query = parseInput(githubCommitsQuerySchema, days ? { days } : {});
+    return {
+      data: await requireClient().get("/progress/commits", {
+        query: { days: String(query.days) }
+      }),
+      render: renderRecord
+    };
+  },
   "progress questions": async ({ requireClient }) => ({
     data: await requireClient().get("/progress/questions"),
     render: renderInsightsAnswers
@@ -37945,19 +38532,43 @@ var HANDLERS = {
     const week = journalWeekArg(args, "week");
     return {
       data: await requireClient().get(`/journal/weeks/${week}`),
-      render: renderJournalWeek
+      render: renderJournalPeriod
+    };
+  },
+  "journal month": async ({ args, requireClient }) => {
+    const month = args[0] ?? "";
+    if (journalPeriodKind(month) !== "month") {
+      throw usageError("journal month needs a month as YYYY-MM, e.g. `do journal month 2026-10`");
+    }
+    return {
+      data: await requireClient().get(`/journal/months/${month}`),
+      render: renderJournalPeriod
+    };
+  },
+  "journal year": async ({ args, requireClient }) => {
+    const year = args[0] ?? "";
+    if (journalPeriodKind(year) !== "year") {
+      throw usageError("journal year needs a year as YYYY, e.g. `do journal year 2026`");
+    }
+    return {
+      data: await requireClient().get(`/journal/years/${year}`),
+      render: renderJournalPeriod
     };
   },
   "journal recap": async ({ args, flags, requireClient }) => {
-    const week = journalWeekArg(args, "recap");
+    const period = args[0] ?? "";
+    const kind = journalPeriodKind(period);
+    if (kind === null) {
+      throw usageError("journal recap needs a week (2026-W42), a month (2026-10) or a year (2026), e.g. `do journal recap 2026-W42`");
+    }
     const body = { ...readDataFlag(flags) };
     const text = flagString(flags, "body");
     if (text !== undefined)
       body.body = text;
     const input = parseInput(journalWriteRecapInputSchema, body);
     return {
-      data: await requireClient().put(`/journal/weeks/${week}/recap`, input),
-      render: renderJournalWeek
+      data: await requireClient().put(`/journal/${kind}s/${period}/recap`, input),
+      render: renderJournalPeriod
     };
   },
   "journal write": async ({ args, flags, requireClient }) => {
@@ -39040,6 +39651,13 @@ var HANDLERS = {
     });
     return { data: await requireClient().post("/metrics/import", input), render: renderRecord };
   },
+  "tap-tags tap": async ({ args, requireClient }) => {
+    const id = requireArg(args, 0, "tag id");
+    return {
+      data: await requireClient().post(`/tap-tags/${encodeURIComponent(id)}/tap`, {}),
+      render: renderRecord
+    };
+  },
   "agents list": async ({ requireClient }) => ({
     data: await requireClient().getPage("/agents"),
     render: renderList
@@ -40025,6 +40643,35 @@ var HANDLERS = {
     await requireClient().delete(`/animals/${id}/lost-card`);
     return { data: { ok: true, animalId: id }, render: renderRecord };
   },
+  "animals acquisition": async ({ args, requireClient }) => ({
+    data: await requireClient().get(`/animals/${requireArg(args, 0, "animal id")}/acquisition`),
+    render: renderRecord
+  }),
+  "animals acquisition-plan": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "animal id");
+    const pickUp = flagString(flags, "pick-up");
+    const body = parseInput(animalAcquisitionInputSchema, {
+      ...readDataFlag(flags),
+      ...pickUp ? { pickUpOn: pickUp } : {}
+    });
+    return {
+      data: await requireClient().post(`/animals/${id}/acquisition`, body),
+      render: renderRecord
+    };
+  },
+  "animals arrived": async ({ args, flags, requireClient }) => {
+    const id = requireArg(args, 0, "animal id");
+    const on = flagString(flags, "on");
+    const months = flagString(flags, "quarantine-months");
+    const body = parseInput(animalArrivedInputSchema, {
+      ...on ? { on } : {},
+      ...months !== undefined ? { quarantineMonths: Number(months) } : {}
+    });
+    return {
+      data: await requireClient().post(`/animals/${id}/arrived`, body),
+      render: renderRecord
+    };
+  },
   "runs change": async ({ args, flags, requireClient }) => {
     const id = requireArg(args, 0, "run id");
     const body = { ...readDataFlag(flags) };
@@ -40124,6 +40771,18 @@ var HANDLERS = {
     data: await requireClient().post("/sensors/home-assistant/sync", {}),
     render: renderRecord
   }),
+  "sensors unifi": async ({ requireClient }) => ({
+    data: await requireClient().get("/sensors/unifi"),
+    render: renderRecord
+  }),
+  "sensors unifi-devices": async ({ requireClient }) => ({
+    data: await requireClient().get("/sensors/unifi/devices"),
+    render: renderList
+  }),
+  "sensors unifi-sync": async ({ requireClient }) => ({
+    data: await requireClient().post("/sensors/unifi/sync", {}),
+    render: renderRecord
+  }),
   "sensors links": async ({ flags, requireClient }) => ({
     data: await requireClient().get("/sensors/links", {
       query: { nodeId: flagString(flags, "node") }
@@ -40135,6 +40794,7 @@ var HANDLERS = {
       externalId: requireArg(args, 0, "entity id"),
       nodeId: requireArg(args, 1, "node id"),
       reading: flagString(flags, "reading"),
+      ...flagString(flags, "provider") ? { provider: flagString(flags, "provider") } : {},
       ...flagString(flags, "label") ? { label: flagString(flags, "label") } : {}
     });
     return { data: await requireClient().post("/sensors/links", body), render: renderRecord };
@@ -40231,6 +40891,12 @@ var HANDLERS = {
     }),
     render: renderRecord
   }),
+  "health export": async ({ flags, requireClient }) => {
+    const raw = await requireClient().getText("/health/export", {
+      query: { files: flagBool(flags, "no-files") ? "false" : undefined }
+    });
+    return { raw, data: undefined, render: () => raw };
+  },
   "health shares": async ({ requireClient }) => ({
     data: await requireClient().getPage("/health/shares"),
     render: renderList
@@ -40489,6 +41155,33 @@ var HANDLERS = {
       render: renderRecord
     };
   },
+  "people propose": async ({ flags, requireClient }) => {
+    const body = parseInput(createPersonProposalInputSchema, {
+      id: ulid3(),
+      ...readDataFlag(flags)
+    });
+    return { data: await requireClient().post("/people/proposals", body), render: renderRecord };
+  },
+  "people proposals": async ({ flags, requireClient }) => {
+    const status = flagString(flags, "status");
+    const source = flagString(flags, "source");
+    const query = parseInput(personProposalsQuerySchema, {
+      ...status ? { status } : {},
+      ...source ? { source } : {}
+    });
+    return {
+      data: await requireClient().get("/people/proposals", { query }),
+      render: renderRecord
+    };
+  },
+  "people accept": async ({ args, requireClient }) => ({
+    data: await requireClient().post(`/people/proposals/${requireArg(args, 0, "proposal id")}/accept`, {}),
+    render: renderRecord
+  }),
+  "people skip": async ({ args, requireClient }) => ({
+    data: await requireClient().post(`/people/proposals/${requireArg(args, 0, "proposal id")}/skip`, {}),
+    render: renderRecord
+  }),
   "people brief": async ({ args, requireClient }) => {
     const id = requireArg(args, 0, "contact id");
     return { data: await requireClient().get(`/people/${id}/brief`), render: renderRecord };
@@ -40722,6 +41415,17 @@ var HANDLERS = {
     const body = parseInput(createRsvpLinksInputSchema, readDataFlag(flags));
     return { data: await requireClient().post("/rsvp-links", body), render: renderRecord };
   },
+  "rsvp-links token": async ({ args, requireClient }) => {
+    const id = requireArg(args, 0, "rsvp link id");
+    return { data: await requireClient().get(`/rsvp-links/${id}/token`), render: renderRecord };
+  },
+  "rsvp-links replace": async ({ args, requireClient }) => {
+    const id = requireArg(args, 0, "rsvp link id");
+    return {
+      data: await requireClient().post(`/rsvp-links/${id}/replace`, {}),
+      render: renderRecord
+    };
+  },
   "rsvp-links revoke": async ({ args, requireClient }) => {
     const id = requireArg(args, 0, "rsvp link id");
     return {

package/package.json

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