@robbeverhelst/do 1.297.0 → 1.298.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 }),
@@ -20635,7 +20689,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,
@@ -22055,6 +22110,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"];
@@ -22927,12 +23005,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(),
@@ -23799,6 +23880,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 +25393,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 +25532,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 +26267,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 +26525,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 +27449,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 +27477,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 +27486,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 +27559,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 +27585,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 +27607,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 +27619,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 +27653,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()
@@ -27829,6 +28068,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 +29706,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.297.0";
+var VERSION = "1.298.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -30326,6 +30611,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 +30885,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"],
@@ -31354,10 +31656,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 +31694,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 +31861,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,6 +32567,15 @@ 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).",
@@ -34691,6 +35035,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.",
@@ -34891,6 +35284,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).",
@@ -35282,13 +35721,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.",
@@ -36866,14 +37322,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 +37359,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 +38332,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 +38434,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 +39553,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 +40545,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) };
@@ -40489,6 +41038,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 +41298,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.298.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",