@robbeverhelst/do 1.347.0 → 1.349.0

package/dist/do.js

@@ -14420,7 +14420,7 @@ var configError = (message) => new CliError("config", message, EXIT.CONFIG);
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.347.0";
+var VERSION = "1.349.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -18030,7 +18030,8 @@ var habits = pgTable("habits", {
   eventSourceId: text("event_source_id"),
   eventMatch: text("event_match"),
   eventOffset: text("event_offset"),
-  durationMinutes: integer2("duration_minutes")
+  durationMinutes: integer2("duration_minutes"),
+  activeMonths: integer2("active_months").array()
 }, (t) => [
   index("habits_tenant_idx").on(t.tenantId),
   index("habits_tenant_area_idx").on(t.tenantId, t.areaId),
@@ -18048,7 +18049,8 @@ var habitEntries = pgTable("habit_entries", {
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
   externalId: text("external_id"),
   agentId: text("agent_id"),
-  note: text("note")
+  note: text("note"),
+  matchedName: text("matched_name")
 }, (t) => [
   index("habit_entries_habit_occurred_idx").on(t.habitId, t.occurredAt),
   uniqueIndex("habit_entries_habit_external_uniq").on(t.habitId, t.externalId).where(sql`${t.externalId} IS NOT NULL`)
@@ -18299,7 +18301,8 @@ var challengeParts = pgTable("challenge_parts", {
   challengeId: text("challenge_id").notNull().references(() => challenges.id, { onDelete: "cascade" }),
   kind: challengePartKind("kind").notNull(),
   subjectId: text("subject_id").notNull(),
-  position: integer2("position").notNull()
+  position: integer2("position").notNull(),
+  resumeOnStart: boolean4("resume_on_start").notNull().default(false)
 }, (t) => [
   index("challenge_parts_tenant_idx").on(t.tenantId),
   index("challenge_parts_challenge_idx").on(t.challengeId, t.position),
@@ -19216,7 +19219,10 @@ var agentChangeSchema = object({
   checkIn: object({
     value: number2(),
     unit: string2().nullable(),
-    measurementType: habitMeasurementTypeSchema
+    measurementType: habitMeasurementTypeSchema,
+    matched: string2().nullish(),
+    target: number2().nullish(),
+    dayValue: number2().nullish()
   }).optional()
 });
 var agentChangesPageSchema = object({
@@ -20823,7 +20829,10 @@ var animalHandoverContactSchema = object({
 var animalHandoverSupplySchema = animalSupplySchema.extend({
   lastsTrip: boolean2().nullable()
 });
-var animalHandoverHabitSchema = nodeRefSchema.extend({ restsThroughTrip: boolean2() });
+var animalHandoverHabitSchema = nodeRefSchema.extend({
+  restsThroughTrip: boolean2(),
+  timeOfDay: string2().nullable().default(null)
+});
 var animalHandoverSchema = object({
   trip: animalHandoverTripSchema.nullable(),
   areaId: ulidSchema.nullable(),
@@ -21397,7 +21406,8 @@ var habitSchema = createSelectSchema(habits, {
   eventSourceId: string2().nullable().default(null),
   eventMatch: string2().nullable().default(null),
   eventOffset: string2().nullable().default(null),
-  durationMinutes: number2().int().nullable().default(null)
+  durationMinutes: number2().int().nullable().default(null),
+  activeMonths: array(number2().int()).nullable().default(null)
 });
 var habitEntrySchema = createSelectSchema(habitEntries, {
   occurredAt: exports_coerce.date(),
@@ -21405,7 +21415,8 @@ var habitEntrySchema = createSelectSchema(habitEntries, {
   externalId: string2().nullish(),
   kind: habitEntryKindSchema.default("check_in"),
   agentId: string2().nullish(),
-  note: string2().nullish()
+  note: string2().nullish(),
+  matchedName: string2().nullish()
 }).extend({
   by: string2().nullish()
 });
@@ -21416,6 +21427,12 @@ var habitTimeOfDaySchema = union([
 ]);
 var HABIT_DURATION_MAX_MINUTES = 600;
 var habitDurationMinutesSchema = number2().int().min(1).max(HABIT_DURATION_MAX_MINUTES);
+var habitActiveMonthsSchema = array(number2().int().min(1).max(12)).max(12).nullable().transform((months) => {
+  if (!months)
+    return null;
+  const set = [...new Set(months)].sort((x, y) => x - y);
+  return set.length === 0 || set.length === 12 ? null : set;
+});
 var habitAliasSchema = string2().trim().min(1).max(60);
 var habitAliasesSchema = array(habitAliasSchema).max(12).transform((aliases) => aliases.filter((a, i) => aliases.findIndex((b) => b.toLowerCase() === a.toLowerCase()) === i));
 var habitScheduleSchema = discriminatedUnion("kind", [
@@ -21455,7 +21472,8 @@ var createHabitInputSchema = createInsertSchema(habits, {
   aliases: habitAliasesSchema.optional(),
   timeOfDay: habitTimeOfDaySchema.nullish(),
   remind: boolean2().optional(),
-  durationMinutes: habitDurationMinutesSchema.nullish()
+  durationMinutes: habitDurationMinutesSchema.nullish(),
+  activeMonths: habitActiveMonthsSchema.optional()
 }).omit({ tenantId: true, recurrenceRuleId: true, retiredAt: true, ...eventColumns }).extend({
   title: string2().min(1),
   schedule: habitScheduleSchema.optional(),
@@ -21472,7 +21490,8 @@ var updateHabitInputSchema = createUpdateSchema(habits, {
   aliases: habitAliasesSchema.optional(),
   timeOfDay: habitTimeOfDaySchema.nullish(),
   remind: boolean2().optional(),
-  durationMinutes: habitDurationMinutesSchema.nullish()
+  durationMinutes: habitDurationMinutesSchema.nullish(),
+  activeMonths: habitActiveMonthsSchema.optional()
 }).omit({
   id: true,
   tenantId: true,
@@ -21484,7 +21503,8 @@ var updateHabitInputSchema = createUpdateSchema(habits, {
   ...eventColumns
 }).extend({
   title: string2().min(1).optional(),
-  schedule: habitScheduleSchema.optional()
+  schedule: habitScheduleSchema.optional(),
+  displayKind: string2().trim().min(1).max(40).optional()
 });
 var HABIT_ENTRY_NOTE_MAX = 280;
 var habitEntryNoteSchema = string2().trim().max(HABIT_ENTRY_NOTE_MAX).transform((note) => note === "" ? null : note);
@@ -21512,7 +21532,9 @@ var habitStreakSchema = object({
 });
 var habitRoutineRefSchema = object({
   id: ulidSchema,
-  title: string2()
+  title: string2(),
+  path: array(string2()).default([]),
+  step: number2().int().positive().nullable().default(null)
 });
 var habitLastCheckInSchema = object({
   at: exports_coerce.date(),
@@ -21592,20 +21614,49 @@ var habitCheckInByTitleInputSchema = object({
   value: number2().nonnegative().optional(),
   mode: habitCheckInModeSchema.default("add"),
   occurredAt: union([civilDateSchema, exports_coerce.date()]).optional(),
-  note: habitEntryNoteSchema.nullish()
+  note: habitEntryNoteSchema.nullish(),
+  again: boolean2().optional()
 }).strict();
 var habitCandidateSchema = object({
   id: ulidSchema,
   title: string2(),
-  aliases: array(string2())
+  aliases: array(string2()),
+  standing: string2().optional()
+});
+var habitCheckInQuestionSchema = object({
+  prompt: string2(),
+  options: array(string2()).min(2)
 });
 var habitCheckInAmbiguousSchema = object({
   error: object({
     code: literal("ambiguous_habit"),
     message: string2(),
-    details: object({ candidates: array(habitCandidateSchema).min(2) })
+    details: object({
+      candidates: array(habitCandidateSchema).min(2),
+      question: habitCheckInQuestionSchema.optional()
+    })
+  })
+});
+var habitCheckInAlreadyMetSchema = object({
+  error: object({
+    code: literal("already_met"),
+    message: string2(),
+    details: object({ habit: habitCandidateSchema, question: habitCheckInQuestionSchema })
   })
 });
+var habitCheckInReceiptSchema = object({
+  entryId: ulidSchema,
+  habitId: ulidSchema,
+  title: string2(),
+  matched: string2(),
+  value: number2(),
+  occurredAt: exports_coerce.date(),
+  paused: boolean2(),
+  says: string2()
+});
+var habitCheckInByTitleResultSchema = habitSummarySchema.extend({
+  receipt: habitCheckInReceiptSchema.nullable()
+});
 var habitAliasInputSchema = object({ alias: habitAliasSchema }).strict();
 var habitSkipInputSchema = object({
   date: exports_iso.date().optional(),
@@ -22737,6 +22788,11 @@ var updateRoutineRunInputSchema = object({
 var routineRunsQuerySchema = object({
   limit: exports_coerce.number().int().min(1).max(200).optional()
 });
+var recentRoutineRunsQuerySchema = object({
+  since: exports_coerce.date().optional(),
+  status: routineRunStatusSchema.optional(),
+  limit: exports_coerce.number().int().min(1).max(200).default(50)
+});
 var routineDoneInputSchema = object({
   id: ulidSchema.optional(),
   occurrenceDate: exports_coerce.date().nullish()
@@ -22804,7 +22860,11 @@ var routineTodayStepSchema = object({
   minutes: number2().int().nullable(),
   done: boolean2(),
   depth: number2().int().nonnegative().default(0),
-  optional: boolean2().default(false)
+  optional: boolean2().default(false),
+  habitId: string2().nullable().default(null),
+  routineId: string2().nullable().default(null),
+  habitToday: _enum2(["due", "not_due", "paused"]).nullable().default(null),
+  amount: object({ value: number2(), target: number2().nullable(), unit: string2().nullable() }).nullable().default(null)
 });
 var routineTodayStateSchema = _enum2(["done", "running", "upcoming", "resting"]);
 var routineTodaySchema = object({
@@ -24649,6 +24709,198 @@ var calendarOperations = defineOperations({
   }
 });
 
+// ../../packages/schema/src/contracts/challenges.ts
+var challengeStatusSchema = _enum2(["upcoming", "active", "ended"]);
+var challengeSchema = createSelectSchema(challenges, {
+  startAt: exports_coerce.date(),
+  endAt: exports_coerce.date(),
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date()
+});
+var createChallengeInputSchema = createInsertSchema(challenges, {
+  id: ulidSchema,
+  title: string2().min(1),
+  description: string2().nullish(),
+  metric: string2().min(1),
+  target: number2().int().positive(),
+  startAt: exports_coerce.date(),
+  endAt: exports_coerce.date(),
+  subjectType: challengeSubjectTypeSchema.nullish(),
+  subjectId: string2().min(1).nullish()
+}).omit({ tenantId: true, source: true, createdBy: true, createdAt: true, updatedAt: true }).strict().refine((v) => v.endAt > v.startAt, {
+  message: "endAt must be after startAt",
+  path: ["endAt"]
+}).refine((v) => v.subjectType == null === (v.subjectId == null), {
+  message: "subjectType and subjectId must be set together",
+  path: ["subjectId"]
+});
+var challengePartKindSchema = _enum2(challengePartKind.enumValues);
+var createChallengePartInputSchema = object({
+  kind: challengePartKindSchema,
+  subjectId: ulidSchema,
+  resumeOnStart: boolean2().optional()
+}).strict().refine((p) => !p.resumeOnStart || p.kind === "habit", {
+  message: "only a habit part can resume on the start day",
+  path: ["resumeOnStart"]
+});
+var CHALLENGE_MAX_PARTS = 5;
+var createChallengeWithPartsInputSchema = object({
+  id: ulidSchema.optional(),
+  title: string2().trim().min(1),
+  description: string2().nullish(),
+  startOn: exports_iso.date(),
+  endOn: exports_iso.date(),
+  projectId: ulidSchema.nullish(),
+  parts: array(createChallengePartInputSchema).min(1).max(CHALLENGE_MAX_PARTS)
+}).strict().refine((v) => v.endOn >= v.startOn, {
+  message: "endOn must not be before startOn",
+  path: ["endOn"]
+});
+var updateChallengeInputSchema = object({
+  title: string2().trim().min(1),
+  description: string2().nullish(),
+  startOn: exports_iso.date(),
+  endOn: exports_iso.date(),
+  projectId: ulidSchema.nullish(),
+  parts: array(createChallengePartInputSchema).min(1).max(CHALLENGE_MAX_PARTS)
+}).strict().refine((v) => v.endOn >= v.startOn, {
+  message: "endOn must not be before startOn",
+  path: ["endOn"]
+});
+var createChallengeRequestSchema = union([
+  createChallengeWithPartsInputSchema,
+  createChallengeInputSchema
+]);
+var listChallengesQuerySchema = object({ projectId: ulidSchema.optional(), habitId: ulidSchema.optional() }).strict();
+var challengePartStatusSchema = _enum2(["done", "running", "waiting"]);
+var challengePartViewSchema = object({
+  kind: challengePartKindSchema,
+  subjectId: string2(),
+  title: string2().nullable(),
+  scheduleLabel: string2(),
+  done: number2().int().nonnegative(),
+  due: number2().int().nonnegative(),
+  status: challengePartStatusSchema,
+  note: string2().nullable(),
+  resumeOnStart: boolean2().optional()
+});
+var challengeDayStatusSchema = _enum2(["met", "missed", "open", "later"]);
+var challengeDaySchema = object({
+  date: exports_iso.date(),
+  status: challengeDayStatusSchema
+});
+var joinChallengeInputSchema = object({ id: ulidSchema }).strict();
+var challengeViewSchema = challengeSchema.extend({
+  participantCount: number2().int().nonnegative(),
+  joined: boolean2(),
+  progress: number2().int().nonnegative(),
+  status: challengeStatusSchema,
+  completed: boolean2(),
+  subjectTitle: string2().nullable(),
+  dayNumber: number2().int().nonnegative(),
+  dayCount: number2().int().nonnegative(),
+  projectTitle: string2().nullable(),
+  parts: array(challengePartViewSchema),
+  days: array(challengeDaySchema)
+});
+var challengeLeaderboardEntrySchema = object({
+  userId: ulidSchema,
+  email: string2(),
+  progress: number2().int().nonnegative(),
+  rank: number2().int().positive(),
+  completed: boolean2()
+});
+var selfComparisonMetricSchema = object({
+  metric: string2(),
+  thisWeek: number2().int().nonnegative(),
+  fourWeekAverage: number2().nonnegative(),
+  deltaPct: number2().nullable(),
+  personalBest: number2().int().nonnegative(),
+  isPersonalBest: boolean2()
+});
+var selfComparisonSchema = object({
+  weekStart: exports_coerce.date(),
+  metrics: array(selfComparisonMetricSchema)
+});
+
+// ../../packages/schema/src/operations/challenges.ts
+var NO_MEMBER = "The key acts for no member.";
+var challengeOperations = defineOperations({
+  list: {
+    method: "get",
+    path: "/challenges",
+    scopes: ["habits:read"],
+    tag: "Habits",
+    summary: "List challenges",
+    description: "Every challenge in the key's Space, newest first, each with its status (upcoming, active or ended), Day N of M, its parts with done vs due so far and their status, its days (met, missed, open or later) and its linked project. `projectId` or `habitId` keeps the challenges a project or a habit is in.",
+    query: [
+      { name: "projectId", description: "Only the challenges linked to this project." },
+      { name: "habitId", description: "Only the challenges with this habit as a part." }
+    ],
+    querySchema: listChallengesQuerySchema,
+    status: 200,
+    response: { description: "The Space's challenges.", list: true },
+    errors: { 400: true, 403: NO_MEMBER }
+  },
+  get: {
+    method: "get",
+    path: "/challenges/{id}",
+    scopes: ["habits:read"],
+    tag: "Habits",
+    summary: "Show a challenge",
+    description: "One challenge with the key's member's progress: Day N of M, each part's schedule, done vs due, status and next note, and each calendar day's state.",
+    status: 200,
+    response: { description: "The challenge." },
+    errors: { 403: NO_MEMBER, 404: true }
+  },
+  create: {
+    method: "post",
+    path: "/challenges",
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Create a challenge",
+    description: "A challenge from `startOn` to `endOn` (both included) with one to five parts (`habit` or `task_series`, each by id; a paused habit part may `resumeOnStart`) and an optional `projectId`; or a legacy metric challenge (`metric`, `target`, `startAt`, `endAt`). The key's member joins it.",
+    body: createChallengeRequestSchema,
+    status: 201,
+    response: { description: "The created challenge." },
+    errors: { 400: true, 403: NO_MEMBER, 409: true }
+  },
+  update: {
+    method: "patch",
+    path: "/challenges/{id}",
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Update a challenge",
+    description: "The whole form again: title, description, start and end day, project and parts (replaced in their order).",
+    body: updateChallengeInputSchema,
+    status: 200,
+    response: { description: "The challenge." },
+    errors: { 400: true, 403: NO_MEMBER, 404: true }
+  },
+  end: {
+    method: "post",
+    path: "/challenges/{id}/end",
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "End a challenge early",
+    description: "Its window closes now and it reads as ended. One that hasn't started is a 400 (delete it instead).",
+    status: 200,
+    response: { description: "The ended challenge." },
+    errors: { 400: true, 403: NO_MEMBER, 404: true }
+  },
+  remove: {
+    method: "delete",
+    path: "/challenges/{id}",
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Delete a challenge",
+    description: "Gone for good, with its parts and who joined; its habits and task series stay.",
+    status: 204,
+    response: { description: "Deleted." },
+    errors: { 403: NO_MEMBER, 404: true }
+  }
+});
+
 // ../../packages/schema/src/operations/changes.ts
 var changesOperations = defineOperations({
   list: {
@@ -28849,7 +29101,7 @@ var foodPatternsSchema = object({
 });
 
 // ../../packages/schema/src/operations/food-log.ts
-var NO_MEMBER = "The key holds no health scope by name, or has no member behind it.";
+var NO_MEMBER2 = "The key holds no health scope by name, or has no member behind it.";
 var HIDDEN2 = "No such meal, or it isn't the key's member's.";
 var RECEIPT2 = "The meal with its `receipt`: a headline with the kcal range, a confidence word (close \xB7 estimate \xB7 rough), a line per item with its source, and the Undo / Edit / Save as my meal calls.";
 var ITEM = "Each item: `label` and one of `foodId` (from `GET /api/v1/foods/search`), `productId` or `recipeId`, with `grams`, `quantity` + `unit` (`2 boterham`, `1 el`) or `servings`; optional `gramsLow`/`gramsHigh` and `matchConfidence`. With no reference, an `estimate` `{kcal, proteinG, carbsG, fatG}` (a labelled guess). The numbers are computed: table \xD7 grams.";
@@ -28870,7 +29122,7 @@ var foodLogOperations = defineOperations({
     querySchema: mealLogListQuerySchema,
     status: 200,
     response: { description: "The meals." },
-    errors: { 400: true, 403: NO_MEMBER }
+    errors: { 400: true, 403: NO_MEMBER2 }
   },
   create: {
     method: "post",
@@ -28882,7 +29134,7 @@ var foodLogOperations = defineOperations({
     body: createMealLogInputSchema,
     status: 201,
     response: { description: RECEIPT2 },
-    errors: { 400: true, 403: NO_MEMBER },
+    errors: { 400: true, 403: NO_MEMBER2 },
     operationId: "food_log"
   },
   get: {
@@ -28992,7 +29244,7 @@ var foodLogOperations = defineOperations({
     body: writeFoodWeekReadInputSchema,
     status: 200,
     response: { description: "The food week, with its read." },
-    errors: { 400: true, 403: NO_MEMBER },
+    errors: { 400: true, 403: NO_MEMBER2 },
     operationId: "food_week_read"
   },
   removeWeekRead: {
@@ -29006,7 +29258,7 @@ var foodLogOperations = defineOperations({
     querySchema: foodWeekReadQuerySchema,
     status: 204,
     response: { description: "Taken back." },
-    errors: { 400: true, 403: NO_MEMBER },
+    errors: { 400: true, 403: NO_MEMBER2 },
     operationId: "food_week_read_remove"
   },
   patterns: {
@@ -29030,7 +29282,7 @@ var foodLogOperations = defineOperations({
     body: proposeFoodTrialInputSchema,
     status: 201,
     response: { description: "The trial, proposed." },
-    errors: { 400: true, 403: NO_MEMBER },
+    errors: { 400: true, 403: NO_MEMBER2 },
     operationId: "food_trial"
   },
   stopTrial: {
@@ -29061,7 +29313,7 @@ var foodLogOperations = defineOperations({
     querySchema: foodDaysQuerySchema,
     status: 200,
     response: { description: "The days." },
-    errors: { 400: true, 403: NO_MEMBER }
+    errors: { 400: true, 403: NO_MEMBER2 }
   },
   day: {
     method: "get",
@@ -29074,7 +29326,7 @@ var foodLogOperations = defineOperations({
     description: "One day: its meals, its total (null when nothing is logged) and the household's planned meals for it.",
     status: 200,
     response: { description: "The day." },
-    errors: { 400: true, 403: NO_MEMBER }
+    errors: { 400: true, 403: NO_MEMBER2 }
   },
   recall: {
     method: "get",
@@ -29085,7 +29337,7 @@ var foodLogOperations = defineOperations({
     description: `What the member eats often: their most-logged meals of the last 30 days (with the last one's id, to log it again) and their saved meals. Use it before asking what "the usual" is.`,
     status: 200,
     response: { description: "Frequent and saved meals." },
-    errors: { 403: NO_MEMBER },
+    errors: { 403: NO_MEMBER2 },
     operationId: "food_recall"
   }
 });
@@ -30165,14 +30417,14 @@ var habitOperations = defineOperations({
     scopes: ["habits:write"],
     tag: "Habits",
     summary: "Check in a habit by title",
-    description: 'Check in the habit whose `title` or one of whose aliases is this (case-insensitive) \u2014 "wake", "did my run", "meditated". `value` defaults to 1. `mode: "add"` (default) logs it on top of the day ("12 pages"); `mode: "set"` makes it the day\'s total ("read 40 total") by writing one entry with the difference, keeping earlier check-ins (amount habits only, else 400). `occurredAt` back-dates it: an instant, or a `YYYY-MM-DD` member\'s day (noon in their zone); `set` works on the member\'s day it lands in. Several matching habits are a 409 with `error.code: "ambiguous_habit"` and `error.details.candidates` (`id`, `title`, `aliases`) to ask which; none is a 404 naming close titles; a habit counted from an ingest (Google Fit, Strava, GitHub) is a 409 \u2014 it checks itself in. An Agent\'s key records an `agent` check-in naming the Agent. `note` puts a short note on the check-in ("drill done, felt heavy" \u2192 `note: "felt heavy"`); a `set` that changes nothing puts it on the day\'s latest check-in. The refreshed habit\'s `lastCheckIn.id` is the entry, for adding a note later. Returns the refreshed habit; fires `habit.updated`.',
+    description: 'Check in the habit whose `title` or one of whose aliases is this (case-insensitive) \u2014 "wake", "did my run", "meditated". `value` defaults to 1. `mode: "add"` (default) logs it on top of the day ("12 pages"); `mode: "set"` makes it the day\'s total ("read 40 total") by writing one entry with the difference, keeping earlier check-ins (amount habits only, else 400). `occurredAt` back-dates it: an instant, or a `YYYY-MM-DD` member\'s day (noon in their zone); `set` works on the member\'s day it lands in. Several matching habits are a 409 with `error.code: "ambiguous_habit"`, `error.details.candidates` (`id`, `title`, `aliases`, `standing`: "done, 07:03", "tonight") and `error.details.question` ("Which one? \u2026", one answer per habit and "Neither") to ask which, never a guessed tick; none is a 404 naming close titles; a habit counted from an ingest (Google Fit, Strava, GitHub) is a 409 ("Checked in by Google Fit: \u2026 counts itself.") \u2014 it checks itself in; a yes/no habit already done today is a 409 `already_met` with `error.details.habit` and `error.details.question` ("\u2026 Tick it again?"), unless `again: true`. A paused habit is ticked; its streak waits. An Agent\'s key records an `agent` check-in naming the Agent. `note` puts a short note on the check-in ("drill done, felt heavy" \u2192 `note: "felt heavy"`); a `set` that changes nothing puts it on the day\'s latest check-in. The refreshed habit\'s `lastCheckIn.id` is the entry, for adding a note later. Returns the refreshed habit with its `receipt` (`entryId`, undone with `DELETE /habits/{id}/check-ins/{entryId}`; `habitId`, `title`, `matched`: the alias or title the words matched, `value`, `occurredAt`, `paused`, `says`: "Water the plants, 3 of 4"), null when a `set` changed nothing; fires `habit.updated`.',
     body: habitCheckInByTitleInputSchema,
     status: 201,
-    response: { description: "The refreshed habit." },
+    response: { description: "The refreshed habit, with its check-in's receipt." },
     errors: {
       400: true,
       404: true,
-      409: "Several habits answer to the title (with the candidates), or it is counted from an ingest."
+      409: "Several habits answer to the title (with the candidates and the question), it is counted from an ingest, or a yes/no habit is already done today (already_met)."
     },
     webhook: "habit.updated"
   },
@@ -31326,7 +31578,8 @@ var houseUpkeepSoonSchema = object({
   nextOn: day.nullable(),
   placeTitle: string2().nullable().default(null),
   lastOn: day.nullable().default(null),
-  occurrenceId: string2().nullable().default(null)
+  occurrenceId: string2().nullable().default(null),
+  thisMonth: boolean2().optional()
 });
 var housePlaceTileSchema = object({
   id: string2(),
@@ -34387,7 +34640,7 @@ var memberOperations = defineOperations({
 });
 
 // ../../packages/schema/src/operations/metrics.ts
-var NO_MEMBER2 = "The key acts for no member.";
+var NO_MEMBER3 = "The key acts for no member.";
 var metricOperations = defineOperations({
   list: {
     method: "get",
@@ -34402,7 +34655,7 @@ var metricOperations = defineOperations({
     querySchema: metricsQuerySchema,
     status: 200,
     response: { description: "Every Metric with its points." },
-    errors: { 403: NO_MEMBER2 }
+    errors: { 403: NO_MEMBER3 }
   },
   sessions: {
     method: "get",
@@ -34417,7 +34670,7 @@ var metricOperations = defineOperations({
     querySchema: sessionsQuerySchema,
     status: 200,
     response: { description: "The sessions." },
-    errors: { 403: NO_MEMBER2 }
+    errors: { 403: NO_MEMBER3 }
   },
   import: {
     method: "post",
@@ -34429,7 +34682,7 @@ var metricOperations = defineOperations({
     body: importMetricsInputSchema,
     status: 201,
     response: { description: "How many points landed and how many were skipped." },
-    errors: { 400: true, 403: NO_MEMBER2 }
+    errors: { 400: true, 403: NO_MEMBER3 }
   },
   log: {
     method: "post",
@@ -34448,7 +34701,7 @@ var metricOperations = defineOperations({
     body: logMetricInputSchema,
     status: 201,
     response: { description: "The Metric." },
-    errors: { 400: true, 403: NO_MEMBER2 }
+    errors: { 400: true, 403: NO_MEMBER3 }
   }
 });
 
@@ -37345,6 +37598,16 @@ var reviewMarkSchema = object({
   date: progressDateSchema,
   state: reviewMarkStateSchema
 });
+var reviewTallySchema = object({ done: countSchema2, due: countSchema2 });
+var reviewHabitsSchema = object({
+  kept30: reviewTallySchema,
+  kept30Before: reviewTallySchema,
+  checkIns: countSchema2,
+  checkInsByAgent: countSchema2,
+  checkInsFromRoutines: countSchema2,
+  paused: countSchema2,
+  grown: countSchema2
+});
 var reviewNumbersSchema = object({
   tasksDone: countSchema2,
   tasksDoneDelta: number2().int(),
@@ -37367,7 +37630,13 @@ var reviewStreakSchema = object({
   current: countSchema2,
   best: countSchema2,
   unitLabel: string2().min(1),
-  marks: array(reviewMarkSchema)
+  marks: array(reviewMarkSchema),
+  state: _enum2(["active", "recovering", "broken"]).optional(),
+  graceUsed: countSchema2.optional(),
+  graceBudget: countSchema2.optional(),
+  kept30: reviewTallySchema.optional(),
+  period: reviewTallySchema.optional(),
+  paused: boolean2().optional()
 });
 var reviewProjectSchema = object({
   projectId: string2().min(1),
@@ -37386,14 +37655,15 @@ var reviewSummarySchema = object({
   numbers: reviewNumbersSchema,
   series: array(reviewSeriesEntrySchema).length(8),
   streaks: array(reviewStreakSchema),
-  projects: array(reviewProjectSchema)
+  projects: array(reviewProjectSchema),
+  habits: reviewHabitsSchema.optional()
 }).refine((s) => s.series.at(-1)?.current === true, {
   message: "the last series entry is the asked period",
   path: ["series"]
 }).refine((s) => s.from <= s.to, { message: "from is on or before to", path: ["from"] });
 
 // ../../packages/schema/src/operations/progress.ts
-var NO_MEMBER3 = "The key acts for no member.";
+var NO_MEMBER4 = "The key acts for no member.";
 var question = {
   question: { description: "The question's key.", enum: insightsQuestionSchema.options }
 };
@@ -37439,7 +37709,7 @@ var progressOperations = defineOperations({
     scopes: ["tasks:read", "habits:read"],
     tag: "Reads",
     summary: "Review summary",
-    description: "Plan > Review in one read, for the ISO week (Monday to Sunday) or calendar month holding `date` (default: the one holding today, in the key's member's saved timezone): the headline numbers (tasks done, mine and the agents', against the period before; habit days met and due; projects with a task done; challenges running), tasks done and habit days met for the last 8 periods (oldest first, the last one the asked period), one streak row per live habit (current and best run, `unitLabel` `N days` for a daily habit and `N in a row` otherwise, and a mark per day of the week or per week of the month: done, missed, open, later or not_due, a day it isn't due that never breaks the run), and each open project's tasks done of its total, the most recently active first.",
+    description: "Plan > Review in one read, for the ISO week (Monday to Sunday) or calendar month holding `date` (default: the one holding today, in the key's member's saved timezone): the headline numbers (tasks done, mine and the agents', against the period before; habit days met and due; projects with a task done; challenges running), tasks done and habit days met for the last 8 periods (oldest first, the last one the asked period), one streak row per live habit (current and best run, `unitLabel` `N days` for a daily habit and `N in a row` otherwise, and a mark per day of the week or per week of the month: done, missed, open, later or not_due, a day it isn't due that never breaks the run), and each open project's tasks done of its total, the most recently active first. For Review \u203A Habits each streak row also carries its `state` (active, recovering or broken), grace used of its budget, `kept30` (due days met of due over the last 30 days), `period` (met of due in the asked period) and whether it rests today (`paused`), and `habits` gives the tiles: kept over the last 30 days and the 30 before, the period's check-ins with how many an agent and a routine made, and how many habits rest and have grown.",
     query: [
       {
         name: "span",
@@ -37482,7 +37752,7 @@ var progressOperations = defineOperations({
     querySchema: githubCommitsQuerySchema,
     status: 200,
     response: { description: "The split." },
-    errors: { 400: true, 403: NO_MEMBER3 }
+    errors: { 400: true, 403: NO_MEMBER4 }
   },
   questions: {
     method: "get",
@@ -37493,7 +37763,7 @@ var progressOperations = defineOperations({
     description: "Insights' answers to its fixed questions, for the key's member only: late nights vs the next day's rating, the morning routine vs the day, good runs, bedtime this week vs usual, what the best days have in common, reading this week vs usual. Each is `shown`, `no_difference` or `collecting` (with `neededDays`); recomputed weekly (Monday 04:00 in the member's zone). Quote `sentence` and `footer` verbatim; a pattern goes together, never a cause. Mention only a Medium or High one.",
     status: 200,
     response: { description: "This week's answers.", view: "InsightsAnswersResponse" },
-    errors: { 403: NO_MEMBER3 },
+    errors: { 403: NO_MEMBER4 },
     operationId: "get_insights"
   },
   dismiss: {
@@ -37534,7 +37804,7 @@ var progressOperations = defineOperations({
     body: memberActivityInputSchema,
     status: 201,
     response: { description: "Recorded." },
-    errors: { 400: true, 403: NO_MEMBER3 },
+    errors: { 400: true, 403: NO_MEMBER4 },
     operationId: "record_member_activity"
   }
 });
@@ -38091,6 +38361,19 @@ var routineOperations = defineOperations({
     response: { description: "`{ today, routines }`." },
     operationId: "routines_today"
   },
+  recentRuns: {
+    method: "get",
+    path: "/routines/runs",
+    scopes: ["routines:read"],
+    tag: "Routines",
+    summary: "Recent runs",
+    description: "The Space's recent routine runs across its live routines, newest first, each with its per-step state: `since` (a day or an instant) keeps those started at or after it, `status` (`in_progress`, `completed`, `abandoned`) keeps one kind, `limit` (1\u2013200, 50 by default) the newest. The Runs page reads the last completed run and the runs left unfinished in the last 7 days from it.",
+    querySchema: recentRoutineRunsQuerySchema,
+    status: 200,
+    response: { description: "The runs, newest first." },
+    errors: { 400: true },
+    operationId: "routines_recent_runs"
+  },
   getRun: {
     method: "get",
     path: "/routines/runs/{runId}",
@@ -44980,8 +45263,225 @@ var commands5 = [
   }
 ];
 
-// src/commands/changes.ts
+// src/commands/challenges.ts
+var STATUS_TITLE = { active: "Active", upcoming: "Upcoming", ended: "Ended" };
+var DAY_MARK = { met: "\u25CF", missed: "\u25CB", open: "\u25CC", later: "\xB7" };
+var day3 = (at) => new Date(at).toISOString().slice(0, 10);
+function when(c) {
+  if (c.status === "upcoming")
+    return `starts ${day3(c.startAt)}`;
+  if (c.status === "ended")
+    return `ended ${day3(c.endAt)}`;
+  return `Day ${c.dayNumber} of ${c.dayCount}`;
+}
+function kept(c) {
+  if (c.parts.length === 0)
+    return `${c.progress} / ${c.target} ${c.metric}`;
+  const met = c.days.filter((d) => d.status === "met").length;
+  const settled = c.days.filter((d) => d.status === "met" || d.status === "missed").length;
+  return `kept ${met} of ${settled} ${settled === 1 ? "day" : "days"}`;
+}
+function oneLine(c, mode) {
+  const project = c.projectTitle ? `  ${paint(mode, "dim", `\xB7 ${c.projectTitle}`)}` : "";
+  return `  ${c.title}  ${when(c)}  ${kept(c)}${project}  ${paint(mode, "dim", c.id)}`;
+}
+function renderChallenges(data, mode) {
+  const page = data;
+  const list = Array.isArray(page) ? page : page.data;
+  if (list.length === 0)
+    return paint(mode, "dim", "(no challenges)");
+  return ["active", "upcoming", "ended"].map((status) => {
+    const rows = list.filter((c) => c.status === status);
+    if (rows.length === 0)
+      return null;
+    return [paint(mode, "bold", STATUS_TITLE[status]), ...rows.map((c) => oneLine(c, mode))].join(`
+`);
+  }).filter((group) => group !== null).join(`
+
+`);
+}
+function renderChallenge(data, mode) {
+  const c = data;
+  const head = [
+    `${paint(mode, "bold", c.title)}  ${STATUS_TITLE[c.status]}  ${when(c)}`,
+    `  ${day3(c.startAt)} to ${day3(c.endAt)}${c.projectTitle ? `  \xB7 ${c.projectTitle}` : ""}  ${kept(c)}`
+  ];
+  if (c.parts.length === 0) {
+    const lens = c.subjectTitle ? `  (${c.subjectTitle})` : "";
+    return [...head, `  ${c.metric}: ${c.progress} of ${c.target}${lens}`].join(`
+`);
+  }
+  const parts = c.parts.map((p) => {
+    const mark = p.status === "done" ? "\u2713" : p.status === "running" ? "\u25B8" : "\xB7";
+    const note = p.note ? `  ${paint(mode, "dim", p.note)}` : "";
+    return `  ${mark} ${p.title ?? "(gone)"}  ${paint(mode, "dim", p.scheduleLabel)}  ${p.done} of ${p.due}  ${p.status}${note}`;
+  });
+  const strip = c.days.map((d) => DAY_MARK[d.status]).join("");
+  return [
+    ...head,
+    "",
+    "Parts",
+    ...parts,
+    "",
+    `Days  ${strip}`,
+    paint(mode, "dim", "      \u25CF met  \u25CB missed  \u25CC today  \xB7 later")
+  ].join(`
+`);
+}
+var PART_GRAMMAR = "`habit:<id>` or `series:<id>` (a task series); repeat --part for up to five, in order.";
+function partOf(raw, resume) {
+  const [kind, id] = raw.split(":", 2);
+  if (!id || kind !== "habit" && kind !== "series") {
+    throw usageError(`--part takes ${PART_GRAMMAR} Got "${raw}".`);
+  }
+  if (kind === "series")
+    return { kind: "task_series", subjectId: id };
+  return { kind: "habit", subjectId: id, ...resume.has(id) ? { resumeOnStart: true } : {} };
+}
+var FORM_FLAGS = [
+  { name: "from", type: "string", description: "The first day, YYYY-MM-DD." },
+  { name: "to", type: "string", description: "The last day, YYYY-MM-DD (included)." },
+  { name: "part", type: "string", description: `A part: ${PART_GRAMMAR}` },
+  { name: "project", type: "string", description: "The project it's for (its id)." },
+  { name: "description", type: "string", description: "What it's for, in a line." },
+  {
+    name: "resume-on-start",
+    type: "string",
+    description: "A paused habit part (its id) to bring back on the first day; repeat it."
+  }
+];
 var commands6 = [
+  defineCommand({
+    operation: challengeOperations.list,
+    path: ["challenges", "list"],
+    summary: "List the challenges: Active, Upcoming, Ended, with Day N of M.",
+    flags: [
+      { name: "project", type: "string", description: "Only those linked to this project." },
+      { name: "habit", type: "string", description: "Only those with this habit as a part." }
+    ],
+    returns: "ChallengeView[]",
+    run: async ({ flags, requireClient }) => {
+      const project = flagString(flags, "project");
+      const habit = flagString(flags, "habit");
+      const query = new URLSearchParams({
+        ...project ? { projectId: project } : {},
+        ...habit ? { habitId: habit } : {}
+      }).toString();
+      return {
+        data: await requireClient().get(`${pathOf(challengeOperations.list)}${query ? `?${query}` : ""}`),
+        render: renderChallenges
+      };
+    }
+  }),
+  defineCommand({
+    operation: challengeOperations.get,
+    path: ["challenges", "show"],
+    summary: "Show a challenge: its parts with done vs due, and a mark per day.",
+    args: [{ name: "challenge", required: true, description: "The challenge's id." }],
+    returns: "ChallengeView",
+    run: async ({ args, requireClient }) => ({
+      data: await requireClient().get(pathOf(challengeOperations.get, { id: requireArg(args, 0, "challenge") })),
+      render: renderChallenge
+    })
+  }),
+  defineCommand({
+    operation: challengeOperations.create,
+    path: ["challenges", "create"],
+    summary: "Create a challenge from --from to --to with one to five --part.",
+    args: [{ name: "title", required: true, description: "The challenge's title." }],
+    flags: [...FORM_FLAGS],
+    returns: "ChallengeView",
+    run: async ({ args, flags, requireClient }) => {
+      const title = args.join(" ").trim();
+      const resume = new Set(flagStrings(flags, "resume-on-start"));
+      const project = flagString(flags, "project");
+      const description = flagString(flags, "description");
+      const body = parseInput(createChallengeWithPartsInputSchema, {
+        id: ulid3(),
+        title,
+        startOn: flagString(flags, "from"),
+        endOn: flagString(flags, "to"),
+        parts: flagStrings(flags, "part").map((p) => partOf(p, resume)),
+        ...project ? { projectId: project } : {},
+        ...description ? { description } : {}
+      });
+      return {
+        data: await requireClient().post(pathOf(challengeOperations.create), body),
+        render: renderChallenge
+      };
+    }
+  }),
+  defineCommand({
+    operation: challengeOperations.update,
+    path: ["challenges", "update"],
+    summary: "Change a challenge: what you pass replaces it; --part replaces all its parts.",
+    args: [{ name: "challenge", required: true, description: "The challenge's id." }],
+    flags: [
+      { name: "title", type: "string", description: "A new title." },
+      ...FORM_FLAGS,
+      { name: "no-project", type: "boolean", description: "Unlink its project." }
+    ],
+    returns: "ChallengeView",
+    run: async ({ args, flags, requireClient }) => {
+      const id = requireArg(args, 0, "challenge");
+      const client = requireClient();
+      const now = await client.get(pathOf(challengeOperations.get, { id }));
+      if (now.parts.length === 0) {
+        throw usageError("A metric challenge has no parts to edit; end it or delete it instead.");
+      }
+      const resume = new Set(flagStrings(flags, "resume-on-start"));
+      const given = flagStrings(flags, "part");
+      const parts = given.length ? given.map((p) => partOf(p, resume)) : now.parts.map((p) => p.kind === "habit" ? {
+        kind: "habit",
+        subjectId: p.subjectId,
+        ...p.resumeOnStart || resume.has(p.subjectId) ? { resumeOnStart: true } : {}
+      } : { kind: p.kind, subjectId: p.subjectId });
+      const description = flagString(flags, "description");
+      const body = parseInput(updateChallengeInputSchema, {
+        title: flagString(flags, "title") ?? now.title,
+        description: description ?? now.description ?? null,
+        startOn: flagString(flags, "from") ?? day3(now.startAt),
+        endOn: flagString(flags, "to") ?? day3(now.endAt),
+        projectId: flagBool(flags, "no-project") ? null : flagString(flags, "project") ?? now.projectId,
+        parts
+      });
+      return {
+        data: await client.patch(pathOf(challengeOperations.update, { id }), body),
+        render: renderChallenge
+      };
+    }
+  }),
+  defineCommand({
+    operation: challengeOperations.end,
+    path: ["challenges", "end"],
+    summary: "End a challenge early: it closes today and reads as ended.",
+    args: [{ name: "challenge", required: true, description: "The challenge's id." }],
+    returns: "ChallengeView",
+    run: async ({ args, requireClient }) => ({
+      data: await requireClient().post(pathOf(challengeOperations.end, { id: requireArg(args, 0, "challenge") }), {}),
+      render: (data, mode) => `Ended early.
+${renderChallenge(data, mode)}`
+    })
+  }),
+  defineCommand({
+    operation: challengeOperations.remove,
+    path: ["challenges", "rm"],
+    summary: "Delete a challenge; its habits and task series stay.",
+    args: [{ name: "challenge", required: true, description: "The challenge's id." }],
+    returns: "{ ok, deleted }",
+    run: async ({ args, requireClient }) => {
+      const id = requireArg(args, 0, "challenge");
+      await requireClient().delete(pathOf(challengeOperations.remove, { id }));
+      return {
+        data: { ok: true, deleted: id },
+        render: () => "Deleted the challenge. Its habits and task series stay."
+      };
+    }
+  })
+];
+
+// src/commands/changes.ts
+var commands7 = [
   {
     spec: {
       path: ["changes"],
@@ -45032,7 +45532,7 @@ function redact(secret) {
     return "********";
   return `${secret.slice(0, 6)}\u2026${secret.slice(-2)}`;
 }
-var commands7 = [
+var commands8 = [
   {
     spec: {
       path: ["whoami"],
@@ -45200,7 +45700,7 @@ var whereFlags = (flags) => ({
   ...flagString(flags, "chapter") ? { chapter: flagString(flags, "chapter") } : {},
   ...flagString(flags, "linked-note") ? { linkedNoteId: flagString(flags, "linked-note") } : {}
 });
-var commands8 = [
+var commands9 = [
   {
     spec: {
       path: ["collection", "types"],
@@ -45640,7 +46140,7 @@ var commands8 = [
 ];
 
 // src/commands/comments.ts
-var commands9 = [
+var commands10 = [
   {
     spec: {
       path: ["comment"],
@@ -46305,7 +46805,7 @@ function renderKraken(data, mode) {
   return lines.join(`
 `);
 }
-var commands10 = pairCommands(CONNECTION_COMMAND_SPECS, CONNECTION_HANDLERS);
+var commands11 = pairCommands(CONNECTION_COMMAND_SPECS, CONNECTION_HANDLERS);
 
 // src/commands/contacts.ts
 var FIELD_FLAGS = [
@@ -46447,7 +46947,7 @@ function contactBodyFromFlags(flags, base, op, current) {
   }
   return body;
 }
-var commands11 = pairCommands(CONTACT_COMMAND_SPECS, {
+var commands12 = pairCommands(CONTACT_COMMAND_SPECS, {
   "contacts create": async ({ args, flags, requireClient }) => {
     const name = args.join(" ").trim();
     const base = { id: ulid3(), ...name ? { title: name } : {}, ...readDataFlag(flags) };
@@ -46493,7 +46993,7 @@ var commands11 = pairCommands(CONTACT_COMMAND_SPECS, {
 });
 
 // src/commands/data-export.ts
-var commands12 = [
+var commands13 = [
   {
     spec: {
       path: ["export"],
@@ -46532,7 +47032,7 @@ function dayDateArg(args, verb) {
   }
   return date;
 }
-var commands13 = [
+var commands14 = [
   {
     spec: {
       path: ["days", "record"],
@@ -46658,7 +47158,7 @@ var commands13 = [
 // src/commands/documents.ts
 import { readFileSync as readFileSync4 } from "fs";
 import { basename } from "path";
-var commands14 = [
+var commands15 = [
   {
     spec: {
       path: ["documents", "file"],
@@ -47037,7 +47537,7 @@ async function echoThreadId(client, ref) {
 function splitList(value) {
   return value.split(",").map((v) => v.trim()).filter((v) => v.length > 0);
 }
-var commands15 = [
+var commands16 = [
   {
     spec: {
       path: ["echo", "post"],
@@ -47356,7 +47856,7 @@ var commands15 = [
 // src/commands/files.ts
 import { readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "fs";
 import { basename as basename2 } from "path";
-var commands16 = [
+var commands17 = [
   {
     spec: {
       path: ["files", "list"],
@@ -47526,7 +48026,7 @@ var commands16 = [
 ];
 
 // src/commands/food.ts
-var commands17 = [
+var commands18 = [
   {
     spec: {
       path: ["foods", "search"],
@@ -48071,7 +48571,7 @@ var commands17 = [
 // src/commands/guest-lists.ts
 import { writeFileSync as writeFileSync3 } from "fs";
 import { basename as basename3 } from "path";
-var commands18 = [
+var commands19 = [
   {
     spec: {
       path: ["guest-lists", "overview"],
@@ -48161,7 +48661,7 @@ var commands18 = [
 ];
 
 // src/commands/guests.ts
-var commands19 = [
+var commands20 = [
   {
     spec: {
       path: ["guests", "sent"],
@@ -48220,9 +48720,14 @@ var SCHEDULE_FLAGS = [
     type: "string",
     description: "How long it takes (15m, 1h, 1h30m; 1\u2013600 minutes); none clears it back to 15m."
   },
+  {
+    name: "season",
+    type: "string",
+    description: "Only in season: a run of months (Oct-Apr) or a list (oct,nov,dec or 10,11,12); off makes it all year."
+  },
   { name: "data", type: "string", description: "JSON for any other field of the contract." }
 ];
-var SCHEDULE_NOTES = 'One of --every-day, --on mo,we,fr, --every 3d|2w [--from YYYY-MM-DD], --monthly 1|last sets its schedule; days it isn\'t due never break the streak. Without one, it keeps `period` + `frequencyCount` (3\xD7 a week). A schedule that follows the waste calendar goes in --data: `{"schedule":{"kind":"event","sourceId":"<its connection id>","match":"bin collection","offset":"day_before_evening"}}` (or `same_day`; a match naming a kind, "PMD", follows only those pickups). The reply\'s `nextDue` lists its next 4 due days. --time 16:30|morning|midday|evening and --for 20m put it on your do calendar at that time on each due day (a part of day at 08:00, 12:30 or 19:00; 15 minutes without --for).';
+var SCHEDULE_NOTES = 'One of --every-day, --on mo,we,fr, --every 3d|2w [--from YYYY-MM-DD], --monthly 1|last sets its schedule; days it isn\'t due never break the streak. Without one, it keeps `period` + `frequencyCount` (3\xD7 a week). A schedule that follows the waste calendar goes in --data: `{"schedule":{"kind":"event","sourceId":"<its connection id>","match":"bin collection","offset":"day_before_evening"}}` (or `same_day`; a match naming a kind, "PMD", follows only those pickups). The reply\'s `nextDue` lists its next 4 due days. --time 16:30|morning|midday|evening and --for 20m put it on your do calendar at that time on each due day (a part of day at 08:00, 12:30 or 19:00; 15 minutes without --for). --season Oct-Apr keeps it to those months: out of season it isn\'t due, its days never break the streak, and it leaves every list (--season off: all year).';
 function localToday() {
   const now = new Date;
   const pad = (n) => String(n).padStart(2, "0");
@@ -48282,7 +48787,45 @@ function timingFromFlags(flags) {
   }
   return out;
 }
-var commands20 = [
+var MONTH_NAMES = [
+  "jan",
+  "feb",
+  "mar",
+  "apr",
+  "may",
+  "jun",
+  "jul",
+  "aug",
+  "sep",
+  "oct",
+  "nov",
+  "dec"
+];
+function monthOf(raw) {
+  const text = raw.trim().toLowerCase();
+  const n = /^\d{1,2}$/.test(text) ? Number(text) : MONTH_NAMES.indexOf(text.slice(0, 3)) + 1;
+  if (n < 1 || n > 12)
+    throw usageError(`--season: "${raw}" isn't a month`);
+  return n;
+}
+function seasonFromFlag(raw) {
+  const text = raw.trim().toLowerCase();
+  if (text === "off" || text === "none")
+    return null;
+  return text.split(",").flatMap((part) => {
+    const [from, to] = part.split("-");
+    if (to === undefined)
+      return [monthOf(part)];
+    const start = monthOf(from);
+    const length = (monthOf(to) - start + 12) % 12 + 1;
+    return Array.from({ length }, (_, i) => (start - 1 + i) % 12 + 1);
+  });
+}
+function seasonFromFlags(flags) {
+  const season = flagString(flags, "season");
+  return season === undefined ? {} : { activeMonths: seasonFromFlag(season) };
+}
+var commands21 = [
   {
     spec: {
       path: ["habits", "create"],
@@ -48302,7 +48845,8 @@ var commands20 = [
         ...title ? { title } : {},
         ...readDataFlag(flags),
         ...schedule ? { schedule } : {},
-        ...timingFromFlags(flags)
+        ...timingFromFlags(flags),
+        ...seasonFromFlags(flags)
       });
       if (flagBool(flags, "dry-run")) {
         return {
@@ -48319,7 +48863,7 @@ var commands20 = [
   {
     spec: {
       path: ["habits", "update"],
-      summary: "Change a habit: its schedule (--every-day, --on, --every, --monthly), --time, --for or --data.",
+      summary: "Change a habit: its schedule (--every-day, --on, --every, --monthly), --time, --for, --season or --data.",
       args: [{ name: "id", required: true, description: "Habit ULID." }],
       flags: SCHEDULE_FLAGS,
       scopes: [...habitOperations.update.scopes],
@@ -48332,10 +48876,11 @@ var commands20 = [
       const body = parseInput(updateHabitInputSchema, {
         ...readDataFlag(flags),
         ...schedule ? { schedule } : {},
-        ...timingFromFlags(flags)
+        ...timingFromFlags(flags),
+        ...seasonFromFlags(flags)
       });
       if (Object.keys(body).length === 0)
-        throw usageError("nothing to change \u2014 pass a schedule flag such as --on mo,we, --time, --for, or --data");
+        throw usageError("nothing to change \u2014 pass a schedule flag such as --on mo,we, --time, --for, --season, or --data");
       const client = requireClient();
       if (flagBool(flags, "dry-run")) {
         const before = await client.get(pathOf(habitOperations.get, { id }));
@@ -48423,11 +48968,16 @@ var commands20 = [
           name: "note",
           type: "string",
           description: 'A short note on the check-in ("felt heavy"), at most 280 characters.'
+        },
+        {
+          name: "again",
+          type: "boolean",
+          description: "Tick a yes/no habit that's already done today once more."
         }
       ],
       scopes: [...habitOperations.checkInByTitle.scopes],
       returns: "HabitSummary",
-      notes: `${routeOf(habitOperations.checkInByTitle)}. Title or alias, case-insensitive; several matches \u2192 409 with error.details.candidates (id, title, aliases), none \u2192 404 naming close titles; a habit counted from Google Fit, Strava or GitHub \u2192 409. --set writes the difference to the day's total as its own check-in. An Agent's key records the check-in as that Agent's ("<agent>, 07:12"). --note puts a short note on it ("drill done, felt heavy" \u2192 --note "felt heavy"); the reply's lastCheckIn.id is the check-in, for \`do habit note\` later.`
+      notes: `${routeOf(habitOperations.checkInByTitle)}. Title or alias, case-insensitive; several matches \u2192 409 with error.details.candidates (id, title, aliases, standing) and error.details.question (which one, with "Neither"), none \u2192 404 naming close titles; a habit counted from Google Fit, Strava or GitHub \u2192 409 ("Checked in by \u2026"); a yes/no habit already done today \u2192 409 already_met with its question, unless --again. The reply's receipt names the habit, the alias it matched, the value and time, its words ("Water the plants, 3 of 4"; a paused habit's "the streak waits") and entryId, the check-in to undo. --set writes the difference to the day's total as its own check-in. An Agent's key records the check-in as that Agent's ("<agent>, 07:12"). --note puts a short note on it ("drill done, felt heavy" \u2192 --note "felt heavy"); the reply's lastCheckIn.id is the check-in, for \`do habit note\` later.`
     },
     run: async ({ args, flags, requireClient }) => {
       const title = args.join(" ").trim();
@@ -48447,7 +48997,8 @@ var commands20 = [
         ...value !== undefined ? { value } : {},
         mode: set ? "set" : "add",
         ...at ? { occurredAt: at } : {},
-        ...note !== undefined ? { note } : {}
+        ...note !== undefined ? { note } : {},
+        ...flags.again === true ? { again: true } : {}
       });
       return {
         data: await requireClient().post(pathOf(habitOperations.checkInByTitle), input),
@@ -49414,7 +49965,7 @@ function healthRecordHandlers() {
   }
   return out;
 }
-var commands21 = pairCommands(HEALTH_COMMAND_SPECS, {
+var commands22 = pairCommands(HEALTH_COMMAND_SPECS, {
   ...healthRecordHandlers(),
   "health record": async ({ flags, requireClient }) => {
     const body = parseInput(logHealthInputSchema, readDataFlag(flags));
@@ -49684,7 +50235,7 @@ var commands21 = pairCommands(HEALTH_COMMAND_SPECS, {
 });
 
 // src/commands/house.ts
-var commands22 = [
+var commands23 = [
   {
     spec: {
       path: ["house"],
@@ -49966,7 +50517,7 @@ function renderSorting(data, _mode) {
   ].join(`
 `);
 }
-var commands23 = [
+var commands24 = [
   defineCommand({
     operation: inboxOperations.list,
     path: ["inbox"],
@@ -50058,7 +50609,7 @@ var commands23 = [
 ];
 
 // src/commands/incidents.ts
-var commands24 = [
+var commands25 = [
   {
     spec: {
       path: ["incidents", "open"],
@@ -50287,7 +50838,7 @@ function journalDateArg(args, verb) {
   }
   return date;
 }
-var commands25 = [
+var commands26 = [
   defineCommand({
     operation: journalOperations.day,
     path: ["journal", "day"],
@@ -50850,7 +51401,7 @@ function renderCreatedKey(data, mode) {
   ].join(`
 `);
 }
-var commands26 = [
+var commands27 = [
   {
     spec: {
       path: ["keys", "list"],
@@ -50986,7 +51537,7 @@ var KIND_FLAG = {
   type: "string",
   description: "The kind of an unknown word (pages, eggs, health, note, or a word taught before); remembered for the Space."
 };
-var commands27 = [
+var commands28 = [
   {
     spec: {
       path: ["log"],
@@ -51061,7 +51612,7 @@ var commands27 = [
 ];
 
 // src/commands/mail-campaigns.ts
-var commands28 = [
+var commands29 = [
   {
     spec: {
       path: ["mail-campaigns", "list"],
@@ -51376,7 +51927,7 @@ async function serveMcp(io, target) {
 }
 
 // src/commands/mcp.ts
-var commands29 = [
+var commands30 = [
   {
     spec: {
       path: ["mcp"],
@@ -51421,7 +51972,7 @@ var commands29 = [
 ];
 
 // src/commands/members.ts
-var commands30 = [
+var commands31 = [
   {
     spec: {
       path: ["invite", "create"],
@@ -51546,7 +52097,7 @@ var commands30 = [
 ];
 
 // src/commands/metrics.ts
-var commands31 = [
+var commands32 = [
   {
     spec: {
       path: ["metrics", "list"],
@@ -51674,7 +52225,7 @@ async function setModuleVisibility(args, requireClient, on) {
     render: renderRecord
   };
 }
-var commands32 = [
+var commands33 = [
   {
     spec: {
       path: ["modules", "list"],
@@ -51898,7 +52449,7 @@ function shareFlag(flags) {
 function localMonth(now) {
   return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}`;
 }
-var commands33 = [
+var commands34 = [
   defineCommand({
     operation: moneyOperations.listAccounts,
     path: ["money", "accounts"],
@@ -53040,7 +53591,7 @@ var commands33 = [
 ];
 
 // src/commands/notes.ts
-var commands34 = [
+var commands35 = [
   {
     spec: {
       path: ["notes", "backlinks"],
@@ -53162,7 +53713,7 @@ var commands34 = [
 ];
 
 // src/commands/orca.ts
-var commands35 = [
+var commands36 = [
   {
     spec: {
       path: ["orca", "list"],
@@ -53516,7 +54067,7 @@ function linkBody(args) {
     return parseInput(familyTreeLinkInputSchema, { kind, a: ref, b: other });
   throw usageError("the kind is parent, child or partner");
 }
-var commands36 = [
+var commands37 = [
   {
     spec: {
       path: ["people", "propose"],
@@ -54205,7 +54756,7 @@ var commands36 = [
 
 // src/commands/places.ts
 import { readFileSync as readFileSync10 } from "fs";
-var commands37 = [
+var commands38 = [
   {
     spec: {
       path: ["places", "import"],
@@ -54262,7 +54813,7 @@ async function planDecision({ args, requireClient }, verb) {
     render: renderPlan
   };
 }
-var commands38 = [
+var commands39 = [
   {
     spec: {
       path: ["plans", "list"],
@@ -54489,7 +55040,7 @@ var commands38 = [
 ];
 
 // src/commands/presets.ts
-var commands39 = [
+var commands40 = [
   {
     spec: {
       path: ["presets", "list"],
@@ -54586,7 +55137,7 @@ function renderReviewSummary(data, mode) {
   return out.join(`
 `);
 }
-var commands40 = [
+var commands41 = [
   {
     spec: {
       path: ["progress"],
@@ -54795,7 +55346,7 @@ function renderUpdates(data, mode) {
   return updates.map((u) => updateLine(u, mode)).join(`
 `);
 }
-var commands41 = [
+var commands42 = [
   defineCommand({
     operation: projectOperations.update,
     path: ["projects", "set"],
@@ -54960,6 +55511,23 @@ function renderRoutinesToday(data, mode) {
   }).join(`
 `);
 }
+var RUN_WORDS = {
+  in_progress: "going",
+  completed: "done",
+  abandoned: "left"
+};
+function renderRecentRuns(data, mode) {
+  const list = (data.data ?? data) || [];
+  if (list.length === 0)
+    return "No runs.";
+  return list.map((r) => {
+    const steps = r.steps.filter((s) => s.refKind !== "routine");
+    const done = steps.filter((s) => s.status === "done").length;
+    const when = r.startedAt.slice(0, 16).replace("T", " ");
+    return `${when}  ${r.routineTitle}  ${paint(mode, "dim", `${RUN_WORDS[r.status] ?? r.status} \xB7 ${done} of ${steps.length} done  ${r.id}`)}`;
+  }).join(`
+`);
+}
 function renderRoutineTaskAdded(data) {
   const run = data;
   const last = run.steps?.at(-1)?.title ?? "the task";
@@ -55375,8 +55943,48 @@ var routineCommands = [
     }
   }
 ];
-var commands42 = [
+var commands43 = [
   ...routineCommands,
+  {
+    spec: {
+      path: ["routines", "runs"],
+      summary: "Recent runs across your routines: when, how far, done or left.",
+      args: [],
+      flags: [
+        {
+          name: "since",
+          type: "string",
+          description: "Only runs started on or after this day (YYYY-MM-DD) or instant."
+        },
+        { name: "status", type: "string", description: "in_progress, completed or abandoned." },
+        {
+          name: "limit",
+          type: "string",
+          description: "How many, newest first (1-200, default 50)."
+        }
+      ],
+      scopes: [...routineOperations.recentRuns.scopes],
+      returns: "RoutineRunView[]",
+      notes: `${routeOf(routineOperations.recentRuns)}. A routine in Trash is left out. "Left" runs (abandoned) can be finished again from the app's Runs page.`
+    },
+    run: async ({ flags, requireClient }) => {
+      const query = parseInput(recentRoutineRunsQuerySchema, {
+        since: flagString(flags, "since"),
+        status: flagString(flags, "status"),
+        limit: flagString(flags, "limit")
+      });
+      return {
+        data: await requireClient().get(pathOf(routineOperations.recentRuns), {
+          query: {
+            since: query.since ? flagString(flags, "since") : undefined,
+            status: query.status,
+            limit: String(query.limit)
+          }
+        }),
+        render: renderRecentRuns
+      };
+    }
+  },
   {
     spec: {
       path: ["routines", "today"],
@@ -55458,7 +56066,7 @@ var commands42 = [
 ];
 
 // src/commands/rsvp-answers.ts
-var commands43 = [
+var commands44 = [
   {
     spec: {
       path: ["rsvp-answers", "list"],
@@ -55512,7 +56120,7 @@ var commands43 = [
 ];
 
 // src/commands/rsvp-links.ts
-var commands44 = [
+var commands45 = [
   {
     spec: {
       path: ["rsvp-links", "list"],
@@ -55608,7 +56216,7 @@ var commands44 = [
 ];
 
 // src/commands/rsvp-questions.ts
-var commands45 = [
+var commands46 = [
   {
     spec: {
       path: ["rsvp-questions", "presets"],
@@ -56180,7 +56788,7 @@ function sessionFlags(flags) {
     body.occurredOn = on;
   return body;
 }
-var commands46 = [
+var commands47 = [
   {
     spec: {
       path: ["runs", "change"],
@@ -56497,7 +57105,7 @@ var commands46 = [
 ];
 
 // src/commands/search.ts
-var commands47 = [
+var commands48 = [
   {
     spec: {
       path: ["search"],
@@ -56530,7 +57138,7 @@ var commands47 = [
 ];
 
 // src/commands/seating-proposals.ts
-var commands48 = [
+var commands49 = [
   {
     spec: {
       path: ["seating-proposals", "list"],
@@ -56617,7 +57225,7 @@ var commands48 = [
 ];
 
 // src/commands/sensors.ts
-var commands49 = [
+var commands50 = [
   {
     spec: {
       path: ["sensors", "status"],
@@ -56777,7 +57385,7 @@ var commands49 = [
 ];
 
 // src/commands/settings.ts
-var commands50 = [
+var commands51 = [
   {
     spec: {
       path: ["settings", "get"],
@@ -56811,7 +57419,7 @@ var commands50 = [
 ];
 
 // src/commands/sharing.ts
-var commands51 = [
+var commands52 = [
   {
     spec: {
       path: ["share"],
@@ -56944,7 +57552,7 @@ var commands51 = [
 ];
 
 // src/commands/tap-tags.ts
-var commands52 = [
+var commands53 = [
   {
     spec: {
       path: ["tap-tags", "tap"],
@@ -56972,7 +57580,7 @@ var BY = {
   type: "string",
   description: "The blocking task's ref (DO-147) or ULID."
 };
-var commands53 = [
+var commands54 = [
   defineCommand({
     operation: taskBlockOperations.addBlocker,
     path: ["tasks", "block"],
@@ -57038,7 +57646,7 @@ function renderSeries(data, mode) {
   }).join(`
 `);
 }
-var commands54 = [
+var commands55 = [
   defineCommand({
     operation: taskSeriesOperations.make,
     path: ["tasks", "make-series"],
@@ -57193,7 +57801,7 @@ function repeatFromFlags(flags) {
     out.anchor = "from_completion";
   return out;
 }
-var commands55 = [
+var commands56 = [
   {
     spec: {
       path: ["capture"],
@@ -57651,7 +58259,7 @@ var commands55 = [
 ];
 
 // src/commands/time-blocks.ts
-var commands56 = [
+var commands57 = [
   {
     spec: {
       path: ["time-blocks", "record"],
@@ -57832,7 +58440,7 @@ function renderLandedCounts(data, mode) {
   return out.join(`
 `);
 }
-var commands57 = [
+var commands58 = [
   {
     spec: {
       path: ["today"],
@@ -58204,7 +58812,7 @@ function renderViews(data, mode) {
 function renderView(data, mode) {
   return renderViews([data], mode);
 }
-var commands58 = [
+var commands59 = [
   defineCommand({
     operation: workViewOperations.list,
     path: ["views", "list"],
@@ -58323,7 +58931,7 @@ var commands58 = [
 ];
 
 // src/commands/worktree-links.ts
-var commands59 = [
+var commands60 = [
   {
     spec: {
       path: ["worktree-links", "list"],
@@ -58488,7 +59096,8 @@ var FEATURE_COMMANDS = [
   ...commands56,
   ...commands57,
   ...commands58,
-  ...commands59
+  ...commands59,
+  ...commands60
 ];
 
 // src/registry.ts