@robbeverhelst/do 1.385.0 → 1.387.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.385.0";
+var VERSION = "1.387.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -18033,7 +18033,8 @@ var habits = pgTable("habits", {
   eventMatch: text("event_match"),
   eventOffset: text("event_offset"),
   durationMinutes: integer2("duration_minutes"),
-  activeMonths: integer2("active_months").array()
+  activeMonths: integer2("active_months").array(),
+  checklist: boolean4("checklist").notNull().default(false)
 }, (t) => [
   index("habits_tenant_idx").on(t.tenantId),
   index("habits_tenant_area_idx").on(t.tenantId, t.areaId),
@@ -19054,7 +19055,9 @@ var mealPlans = pgTable("meal_plans", {
   company: text("company"),
   leftoverPortions: integer2("leftover_portions"),
   leftoverEatBy: date5("leftover_eat_by", { mode: "string" }),
-  leftoverFrozen: boolean4("leftover_frozen").notNull().default(false)
+  leftoverFrozen: boolean4("leftover_frozen").notNull().default(false),
+  eaterUserIds: text("eater_user_ids").array().notNull().default([]),
+  guests: integer2("guests").notNull().default(0)
 }, (t) => [
   index("meal_plans_tenant_planned_idx").on(t.tenantId, t.plannedFor),
   check2("meal_plans_state_check", sql`${t.state} IN ('planned', 'cooked', 'out', 'unsure', 'draft')`)
@@ -22023,8 +22026,36 @@ var animalOperations = defineOperations({
   }
 });
 
-// ../../packages/schema/src/contracts/habit-sources.ts
-var habitSourceSchema = _enum2(["manual", "google_fit", "strava", "github"]);
+// ../../packages/schema/src/db/habit-items.ts
+var habitItems = pgTable("habit_items", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  habitId: text("habit_id").notNull().references(() => habits.id),
+  title: text("title").notNull(),
+  position: integer2("position").notNull().default(0),
+  byDay: text("by_day").array(),
+  timeOfDay: text("time_of_day"),
+  archivedAt: timestamp("archived_at", { withTimezone: true }),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  index("habit_items_habit_idx").on(t.tenantId, t.habitId, t.position),
+  check2("habit_items_time_of_day_chk", sql`${t.timeOfDay} IS NULL OR ${t.timeOfDay} IN ('morning', 'midday', 'evening')`)
+]);
+var habitItemTicks = pgTable("habit_item_ticks", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  habitId: text("habit_id").notNull().references(() => habits.id),
+  itemId: text("item_id").notNull().references(() => habitItems.id),
+  day: date5("day", { mode: "string" }).notNull(),
+  tickedAt: timestamp("ticked_at", { withTimezone: true }).notNull().defaultNow(),
+  source: habitEntrySource("source").notNull().default("manual"),
+  userId: text("user_id"),
+  agentId: text("agent_id"),
+  routineRunStepId: text("routine_run_step_id")
+}, (t) => [
+  uniqueIndex("habit_item_ticks_item_day_uniq").on(t.itemId, t.day),
+  index("habit_item_ticks_habit_day_idx").on(t.tenantId, t.habitId, t.day)
+]);
 
 // ../../packages/schema/src/contracts/recurrence.ts
 var recurrenceRuleSchema = createSelectSchema(recurrenceRules, {
@@ -22096,6 +22127,71 @@ var updateOccurrenceInputSchema = createUpdateSchema(occurrences, {
   occurrenceDate: exports_coerce.date().optional()
 }).pick({ occurrenceDate: true, status: true }).strict();
 
+// ../../packages/schema/src/contracts/habit-items.ts
+var civilDate = exports_iso.date();
+var habitItemTimeOfDaySchema = _enum2(["morning", "midday", "evening"]);
+var itemTitleSchema = string2().trim().min(1).max(120);
+var itemByDaySchema = array(byDayCodeSchema).min(1).max(7).refine((d) => new Set(d).size === d.length, "each weekday once");
+var habitItemSchema = createSelectSchema(habitItems, {
+  byDay: array(string2()).nullable(),
+  timeOfDay: string2().nullable(),
+  archivedAt: exports_coerce.date().nullable(),
+  createdAt: exports_coerce.date()
+});
+var habitItemTickSchema = createSelectSchema(habitItemTicks, {
+  tickedAt: exports_coerce.date()
+});
+var createHabitItemInputSchema = object({
+  id: ulidSchema,
+  title: itemTitleSchema,
+  byDay: itemByDaySchema.nullish(),
+  timeOfDay: habitItemTimeOfDaySchema.nullish(),
+  position: number2().int().min(0).optional()
+}).strict();
+var updateHabitItemInputSchema = object({
+  title: itemTitleSchema.optional(),
+  byDay: itemByDaySchema.nullish(),
+  timeOfDay: habitItemTimeOfDaySchema.nullish()
+}).strict();
+var reorderHabitItemsInputSchema = object({
+  ids: array(ulidSchema).min(1).max(100).refine((ids) => new Set(ids).size === ids.length, "each item once")
+}).strict();
+var habitItemTickInputSchema = object({ date: civilDate.optional() }).strict();
+var habitTickAllInputSchema = object({
+  date: civilDate.optional(),
+  except: array(ulidSchema).max(100).optional()
+}).strict();
+var habitChecklistQuerySchema = object({ date: civilDate.optional() });
+var habitItemTickedBySchema = object({
+  source: _enum2(habitEntrySource.enumValues),
+  userId: string2().nullable(),
+  agentId: string2().nullable()
+});
+var habitChecklistItemSchema = object({
+  id: ulidSchema,
+  title: string2(),
+  position: number2().int(),
+  byDay: array(string2()).nullable(),
+  timeOfDay: habitItemTimeOfDaySchema.nullable(),
+  due: boolean2(),
+  ticked: boolean2(),
+  tickedAt: exports_coerce.date().nullable(),
+  tickedBy: habitItemTickedBySchema.nullable()
+});
+var habitChecklistDaySchema = object({
+  habitId: ulidSchema,
+  date: civilDate,
+  items: array(habitChecklistItemSchema),
+  due: number2().int().min(0),
+  ticked: number2().int().min(0),
+  percent: number2().int().min(0).max(100),
+  done: boolean2()
+});
+var habitItemListSchema = array(habitItemSchema);
+
+// ../../packages/schema/src/contracts/habit-sources.ts
+var habitSourceSchema = _enum2(["manual", "google_fit", "strava", "github"]);
+
 // ../../packages/schema/src/contracts/habits.ts
 var habitSchema = createSelectSchema(habits, {
   source: habitSourceSchema.default("manual"),
@@ -22111,7 +22207,8 @@ var habitSchema = createSelectSchema(habits, {
   eventMatch: string2().nullable().default(null),
   eventOffset: string2().nullable().default(null),
   durationMinutes: number2().int().nullable().default(null),
-  activeMonths: array(number2().int()).nullable().default(null)
+  activeMonths: array(number2().int()).nullable().default(null),
+  checklist: boolean2().default(false)
 });
 var habitEntrySchema = createSelectSchema(habitEntries, {
   occurredAt: exports_coerce.date(),
@@ -22179,11 +22276,13 @@ var createHabitInputSchema = createInsertSchema(habits, {
   dayTimes: weekdayTimesSchema.nullish(),
   remind: boolean2().optional(),
   durationMinutes: habitDurationMinutesSchema.nullish(),
-  activeMonths: habitActiveMonthsSchema.optional()
+  activeMonths: habitActiveMonthsSchema.optional(),
+  checklist: boolean2().optional()
 }).omit({ tenantId: true, recurrenceRuleId: true, retiredAt: true, ...eventColumns }).extend({
   title: string2().min(1),
   schedule: habitScheduleSchema.optional(),
-  displayKind: string2().min(1).nullish()
+  displayKind: string2().min(1).nullish(),
+  items: array(createHabitItemInputSchema).max(100).optional()
 });
 var updateHabitInputSchema = createUpdateSchema(habits, {
   source: habitSourceSchema.optional(),
@@ -22207,6 +22306,7 @@ var updateHabitInputSchema = createUpdateSchema(habits, {
   pausedFrom: true,
   pausedUntil: true,
   retiredAt: true,
+  checklist: true,
   ...eventColumns
 }).extend({
   title: string2().min(1).optional(),
@@ -25090,7 +25190,10 @@ var blockTemplateInstanceSchema = object({
   routineId: string2().nullable()
 });
 var PLAN_VS_RECORD_RANGES = [7, 30, 90];
+var PLAN_VS_RECORD_MONTH_RANGES = ["month", "six", "year", "all"];
+var planVsRecordMonthRangeSchema = _enum2(PLAN_VS_RECORD_MONTH_RANGES);
 var planVsRecordQuerySchema = object({
+  range: planVsRecordMonthRangeSchema.optional(),
   days: exports_coerce.number().refine((d) => PLAN_VS_RECORD_RANGES.includes(d), {
     message: "days must be 7, 30 or 90"
   }).default(30)
@@ -25144,6 +25247,7 @@ var planVsRecordSuggestionSchema = object({
 });
 var planVsRecordSchema = object({
   days: number2().int(),
+  range: planVsRecordMonthRangeSchema.nullable().default(null),
   since: string2().nullable(),
   recordedDays: number2().int(),
   week: array(planVsRecordDaySchema),
@@ -29670,12 +29774,12 @@ var foodDaySchema = object({
   meals: number2().int(),
   completeness: _enum2(FOOD_DAY_COMPLETENESS_VALUES)
 });
-var civilDate = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "a date is YYYY-MM-DD");
-var foodDateSchema = civilDate;
+var civilDate2 = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "a date is YYYY-MM-DD");
+var foodDateSchema = civilDate2;
 var mealLogListQuerySchema = object({ from: exports_coerce.date(), to: exports_coerce.date() }).refine((q) => q.from < q.to, { message: "from must be before to" }).refine((q) => q.to.getTime() - q.from.getTime() <= 92 * 24 * 60 * 60 * 1000, {
   message: "ask for at most 92 days"
 });
-var foodDaysQuerySchema = object({ from: civilDate, to: civilDate }).refine((q) => q.from <= q.to, { message: "from must not be after to" });
+var foodDaysQuerySchema = object({ from: civilDate2, to: civilDate2 }).refine((q) => q.from <= q.to, { message: "from must not be after to" });
 var FOOD_AFTER_MARK_VALUES = ["tired", "symptom"];
 var plannedMealSchema = object({
   id: string2(),
@@ -29707,7 +29811,7 @@ var foodDayIntakeSchema = object({
   note: string2().nullable()
 });
 var foodDayViewSchema = object({
-  date: civilDate,
+  date: civilDate2,
   logs: array(mealLogViewSchema),
   total: foodDaySchema.nullable(),
   planned: array(plannedMealSchema),
@@ -29719,7 +29823,7 @@ var MEAL_AFTER_KIND_VALUES = ["symptom", "episode", "dose", "sleep", "rating"];
 var mealAfterEntrySchema = object({
   kind: _enum2(MEAL_AFTER_KIND_VALUES),
   at: exports_coerce.date().nullable(),
-  day: civilDate.nullable(),
+  day: civilDate2.nullable(),
   label: string2(),
   bodyRegion: bodyRegionSchema.nullable(),
   severity: number2().int().nullable(),
@@ -29751,7 +29855,7 @@ var mealContextSchema = object({
     triggerText: string2().nullable()
   }).nullable()
 });
-var foodWeekQuerySchema = object({ start: civilDate.optional() });
+var foodWeekQuerySchema = object({ start: civilDate2.optional() });
 var foodWeekMealSchema = object({
   id: string2(),
   title: string2(),
@@ -29762,7 +29866,7 @@ var foodWeekMealSchema = object({
   marks: array(_enum2(FOOD_AFTER_MARK_VALUES))
 });
 var foodWeekDaySchema = object({
-  day: civilDate,
+  day: civilDate2,
   total: foodDaySchema.nullable(),
   meals: array(foodWeekMealSchema),
   planned: object({ meals: number2().int(), kcal: number2().nullable() }),
@@ -29771,10 +29875,10 @@ var foodWeekDaySchema = object({
 });
 var FOOD_WEEK_READ_MAX = 2000;
 var writeFoodWeekReadInputSchema = object({
-  start: civilDate,
+  start: civilDate2,
   body: string2().trim().min(1).max(FOOD_WEEK_READ_MAX)
 }).strict();
-var foodWeekReadQuerySchema = object({ start: civilDate });
+var foodWeekReadQuerySchema = object({ start: civilDate2 });
 var foodWeekReadSchema = object({
   id: string2(),
   body: string2(),
@@ -29782,14 +29886,14 @@ var foodWeekReadSchema = object({
   updatedAt: exports_coerce.date()
 });
 var foodWeekSchema = object({
-  start: civilDate,
-  end: civilDate,
+  start: civilDate2,
+  end: civilDate2,
   week: number2().int(),
   days: array(foodWeekDaySchema),
   usualKcal: number2().nullable(),
   weight: object({
-    points: array(object({ day: civilDate, value: number2() })),
-    trend: array(object({ day: civilDate, value: number2() })),
+    points: array(object({ day: civilDate2, value: number2() })),
+    trend: array(object({ day: civilDate2, value: number2() })),
     latest: number2().nullable(),
     perWeek: number2().nullable(),
     source: metricSourceSchema.nullable()
@@ -29800,7 +29904,7 @@ var foodWeekSchema = object({
     averageProteinG: number2().nullable(),
     dinnersPlanned: number2().int(),
     dinnersAsPlanned: number2().int(),
-    dinnersNearBed: array(civilDate),
+    dinnersNearBed: array(civilDate2),
     meals: number2().int(),
     tiredAfter: number2().int(),
     tiredAfterLunch: number2().int()
@@ -29857,13 +29961,13 @@ var foodPatternSideSchema = object({
   mean: number2().nullable()
 });
 var foodPatternWeekSchema = object({
-  start: civilDate,
+  start: civilDate2,
   week: number2().int(),
   averageKcal: number2().nullable(),
   weightChange: number2().nullable()
 });
 var foodPatternDaySchema = object({
-  day: civilDate,
+  day: civilDate2,
   with: boolean2(),
   hit: boolean2().nullable(),
   value: number2().nullable()
@@ -29891,7 +29995,7 @@ var proposeFoodTrialInputSchema = object({
   question: foodPatternQuestionSchema,
   title: string2().trim().min(1).max(120),
   note: string2().trim().min(1).max(FOOD_TRIAL_NOTE_MAX),
-  startsOn: civilDate,
+  startsOn: civilDate2,
   days: number2().int().min(7).max(28).default(14)
 }).strict();
 var foodTrialSchema = object({
@@ -29900,15 +30004,15 @@ var foodTrialSchema = object({
   title: string2(),
   note: string2(),
   state: _enum2(["proposed", "running"]),
-  startsOn: civilDate,
-  endsOn: civilDate,
+  startsOn: civilDate2,
+  endsOn: civilDate2,
   days: number2().int(),
   day: number2().int().nullable(),
   author: _enum2(["me", "agent"])
 });
 var foodPatternsSchema = object({
-  from: civilDate,
-  to: civilDate,
+  from: civilDate2,
+  to: civilDate2,
   windowDays: number2().int().positive(),
   loggedDays: number2().int().nonnegative(),
   answers: array(foodPatternAnswerSchema),
@@ -31092,6 +31196,8 @@ var guestOperations = defineOperations({
 });
 
 // ../../packages/schema/src/operations/habits.ts
+var item = { itemId: "The item's ULID." };
+var notChecklist = "A habit that isn't a checklist answers 409.";
 var habitListQuery = habitListQuerySchema.extend(paginationQuerySchema.shape);
 var habitOperations = defineOperations({
   list: {
@@ -31405,6 +31511,133 @@ var habitOperations = defineOperations({
     errors: { 404: true },
     webhook: "habit.updated",
     operationId: "undo_habit_check_in"
+  },
+  listItems: {
+    method: "get",
+    path: "/habits/{id}/items",
+    scopes: ["habits:read"],
+    tag: "Habits",
+    summary: "List a checklist habit's items",
+    description: `A checklist habit is one habit made of small items; ticking them fills its day (6 of 9 is 67%). Its live items, in order, each with its weekdays (\`byDay\`, null = every day) and part of the day. ${notChecklist}`,
+    status: 200,
+    response: { description: "The items, in order." },
+    errors: { 404: true, 409: true },
+    operationId: "list_habit_items"
+  },
+  addItem: {
+    method: "post",
+    path: "/habits/{id}/items",
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Add an item to a checklist habit",
+    description: `Body \`{ id, title, byDay?, timeOfDay?, position? }\`: the item goes last, or at \`position\`. Returns the items. ${notChecklist}`,
+    body: createHabitItemInputSchema,
+    status: 201,
+    response: { description: "The items, in order." },
+    errors: { 400: true, 404: true, 409: true },
+    webhook: "habit.updated",
+    operationId: "add_habit_item"
+  },
+  updateItem: {
+    method: "patch",
+    path: "/habits/{id}/items/{itemId}",
+    pathParams: item,
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Rename an item or change when it's due",
+    description: `Body \`{ title?, byDay?, timeOfDay? }\`; null clears its weekdays or part of the day. Returns the items. ${notChecklist}`,
+    body: updateHabitItemInputSchema,
+    status: 200,
+    response: { description: "The items, in order." },
+    errors: { 400: true, 404: true, 409: true },
+    webhook: "habit.updated",
+    operationId: "update_habit_item"
+  },
+  reorderItems: {
+    method: "put",
+    path: "/habits/{id}/items/order",
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Reorder a checklist habit's items",
+    description: `Body \`{ ids }\`: every live item's id, once each, first to last (400 otherwise). Returns the items. ${notChecklist}`,
+    body: reorderHabitItemsInputSchema,
+    status: 200,
+    response: { description: "The items, in order." },
+    errors: { 400: true, 404: true, 409: true },
+    webhook: "habit.updated",
+    operationId: "reorder_habit_items"
+  },
+  archiveItem: {
+    method: "delete",
+    path: "/habits/{id}/items/{itemId}",
+    pathParams: item,
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Remove an item from a checklist habit",
+    description: `The item is archived, never deleted: the days it was ticked keep their count, and from today it's no longer due. Returns the items left. ${notChecklist}`,
+    status: 200,
+    response: { description: "The items left, in order." },
+    errors: { 404: true, 409: true },
+    webhook: "habit.updated",
+    operationId: "remove_habit_item"
+  },
+  checklist: {
+    method: "get",
+    path: "/habits/{id}/checklist",
+    scopes: ["habits:read"],
+    tag: "Habits",
+    summary: "A checklist habit's day",
+    description: `The day's items (each due or not, ticked or not, when and by whom), how many are due and ticked, the percent (6 of 9 \u2192 67) and \`done\`. \`date\` (YYYY-MM-DD) defaults to today in the member's zone. The habit's own day value is this percent (target 100), so its streak counts a day at 100%. ${notChecklist}`,
+    query: [{ name: "date", description: "The day (YYYY-MM-DD); today when absent." }],
+    querySchema: habitChecklistQuerySchema,
+    status: 200,
+    response: { description: "The checklist on the day." },
+    errors: { 400: true, 404: true, 409: true },
+    operationId: "get_habit_checklist"
+  },
+  tickItem: {
+    method: "post",
+    path: "/habits/{id}/items/{itemId}/tick",
+    pathParams: item,
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Tick an item",
+    description: `Body \`{ date? }\` (today when absent). Ticking a ticked item changes nothing. An Agent's key ticks it as that Agent's. Returns the day; fires \`habit.updated\`. ${notChecklist}`,
+    body: habitItemTickInputSchema,
+    status: 200,
+    response: { description: "The checklist on the day." },
+    errors: { 400: true, 404: true, 409: true },
+    webhook: "habit.updated",
+    operationId: "tick_habit_item"
+  },
+  untickItem: {
+    method: "post",
+    path: "/habits/{id}/items/{itemId}/untick",
+    pathParams: item,
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Untick an item",
+    description: `Body \`{ date? }\` (today when absent): undo a tick. Returns the day; fires \`habit.updated\`. ${notChecklist}`,
+    body: habitItemTickInputSchema,
+    status: 200,
+    response: { description: "The checklist on the day." },
+    errors: { 400: true, 404: true, 409: true },
+    webhook: "habit.updated",
+    operationId: "untick_habit_item"
+  },
+  tickAll: {
+    method: "post",
+    path: "/habits/{id}/items/tick-all",
+    scopes: ["habits:write"],
+    tag: "Habits",
+    summary: "Tick every item due",
+    description: `"All": body \`{ date?, except? }\` ticks every item due on the day (today when absent) but the ones in \`except\`, which end up unticked: "all done except the water". Returns the day; fires \`habit.updated\`. ${notChecklist}`,
+    body: habitTickAllInputSchema,
+    status: 200,
+    response: { description: "The checklist on the day." },
+    errors: { 400: true, 404: true, 409: true },
+    webhook: "habit.updated",
+    operationId: "tick_all_habit_items"
   }
 });
 
@@ -35257,14 +35490,16 @@ var mailCampaignOperations = defineOperations({
 
 // ../../packages/schema/src/contracts/meal-plans.ts
 var mealPlanStateSchema = _enum2(MEAL_PLAN_STATES);
-var civilDate2 = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "a date is YYYY-MM-DD");
+var civilDate3 = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "a date is YYYY-MM-DD");
 var weekMenuFields = {
   state: mealPlanStateSchema.optional(),
   cookUserId: ulidSchema.nullish(),
   company: string2().max(120).nullish(),
   leftoverPortions: number2().int().positive().nullish(),
-  leftoverEatBy: civilDate2.nullish(),
-  leftoverFrozen: boolean2().optional()
+  leftoverEatBy: civilDate3.nullish(),
+  leftoverFrozen: boolean2().optional(),
+  eaterUserIds: array(ulidSchema).max(50).optional(),
+  guests: number2().int().min(0).max(99).optional()
 };
 var mealPlanSchema = createSelectSchema(mealPlans, {
   plannedFor: exports_coerce.date(),
@@ -35273,7 +35508,9 @@ var mealPlanSchema = createSelectSchema(mealPlans, {
   company: string2().nullable().default(null),
   leftoverPortions: number2().int().nullable().default(null),
   leftoverEatBy: string2().nullable().default(null),
-  leftoverFrozen: boolean2().default(false)
+  leftoverFrozen: boolean2().default(false),
+  eaterUserIds: array(string2()).default([]),
+  guests: number2().int().default(0)
 });
 var createMealPlanInputSchema = createInsertSchema(mealPlans, {
   id: ulidSchema,
@@ -35323,10 +35560,10 @@ var mealPlanCookResultSchema = object({
 });
 var cookMealPlanInputSchema = object({
   leftoverPortions: number2().int().positive().nullish(),
-  leftoverEatBy: civilDate2.nullish()
+  leftoverEatBy: civilDate3.nullish()
 }).strict();
-var mealWeekQuerySchema = object({ start: civilDate2.optional() });
-var acceptMealDraftInputSchema = object({ start: civilDate2 }).strict();
+var mealWeekQuerySchema = object({ start: civilDate3.optional() });
+var acceptMealDraftInputSchema = object({ start: civilDate3 }).strict();
 var mealWeekCookSchema = object({
   userId: string2(),
   name: string2(),
@@ -35340,10 +35577,12 @@ var mealWeekSlotSchema = object({
   cook: mealWeekCookSchema.nullable(),
   company: string2().nullable(),
   notes: string2().nullable(),
+  eaters: array(mealWeekCookSchema).default([]),
+  guests: number2().int().min(0).default(0),
   time: string2().nullable()
 });
 var mealWeekDaySchema = object({
-  date: civilDate2,
+  date: civilDate3,
   isToday: boolean2(),
   dinner: mealWeekSlotSchema.nullable(),
   lunch: mealWeekSlotSchema.nullable()
@@ -35352,19 +35591,19 @@ var mealWeekLeftoverSchema = object({
   mealPlanId: ulidSchema,
   title: string2(),
   portions: number2().int(),
-  cookedOn: civilDate2,
-  eatBy: civilDate2.nullable(),
+  cookedOn: civilDate3,
+  eatBy: civilDate3.nullable(),
   frozen: boolean2()
 });
 var mealWeekDraftDaySchema = object({
-  date: civilDate2,
+  date: civilDate3,
   dinner: mealWeekSlotSchema.nullable(),
   why: string2().nullable()
 });
 var mealWeekSchema = object({
   week: number2().int().min(1).max(53),
-  start: civilDate2,
-  end: civilDate2,
+  start: civilDate3,
+  end: civilDate3,
   days: array(mealWeekDaySchema).length(7),
   summary: object({
     planned: number2().int().min(0),
@@ -35573,8 +35812,60 @@ var moneyOdooUndoResultSchema = object({
   line: string2()
 });
 
-// ../../packages/schema/src/contracts/money-net-worth.ts
+// ../../packages/schema/src/contracts/money-flow.ts
 var amount5 = string2();
+var MONEY_FLOW_START = "start";
+var moneyFlowQuerySchema = object({
+  from: union([moneyMonthSchema, literal(MONEY_FLOW_START)]).optional(),
+  to: moneyMonthSchema.optional(),
+  scope: moneyBudgetScopeSchema.optional()
+}).refine((q) => !q.from || q.from === MONEY_FLOW_START || !q.to || q.from <= q.to, {
+  message: "from must not be after to",
+  path: ["from"]
+});
+var moneyFlowSourceSchema = object({
+  kind: _enum2(["income", "moved_in"]),
+  categoryId: ulidSchema.nullable(),
+  name: string2(),
+  amount: amount5
+});
+var MONEY_FLOW_OUTS = [
+  "fixed",
+  "flexible",
+  "moved_out",
+  "goals",
+  "invested",
+  "kept"
+];
+var moneyFlowOutKindSchema = _enum2(MONEY_FLOW_OUTS);
+var moneyFlowOutSchema = object({
+  kind: moneyFlowOutKindSchema,
+  name: string2(),
+  amount: amount5
+});
+var moneyFlowCategorySchema = object({
+  categoryId: ulidSchema.nullable(),
+  name: string2(),
+  amount: amount5
+});
+var moneyFlowSchema = object({
+  scope: moneyBudgetScopeSchema,
+  from: moneyMonthSchema,
+  to: moneyMonthSchema,
+  through: moneyMonthSchema,
+  firstMonth: moneyMonthSchema.nullable(),
+  in: amount5,
+  sources: array(moneyFlowSourceSchema),
+  fromSavings: amount5,
+  outs: array(moneyFlowOutSchema),
+  fixed: array(moneyFlowCategorySchema),
+  flexible: array(moneyFlowCategorySchema),
+  unsorted: amount5,
+  saved: amount5
+});
+
+// ../../packages/schema/src/contracts/money-net-worth.ts
+var amount6 = string2();
 var moneySnapshotSourceSchema = _enum2(moneySnapshotSource.enumValues);
 var moneyNetWorthQuerySchema = object({
   scope: moneyBudgetScopeSchema.optional(),
@@ -35582,9 +35873,9 @@ var moneyNetWorthQuerySchema = object({
 });
 var moneyNetWorthPointSchema = object({
   month: moneyMonthSchema,
-  total: amount5.nullable(),
-  have: amount5.nullable(),
-  owe: amount5.nullable()
+  total: amount6.nullable(),
+  have: amount6.nullable(),
+  owe: amount6.nullable()
 });
 var moneyNetWorthAccountSchema = object({
   accountId: ulidSchema,
@@ -35592,7 +35883,7 @@ var moneyNetWorthAccountSchema = object({
   kind: moneyAccountKindSchema,
   visibility: _enum2(NODE_VISIBILITY_VALUES),
   currency: string2(),
-  value: amount5,
+  value: amount6,
   source: moneySnapshotSourceSchema,
   month: moneyMonthSchema,
   pensionSubtype: moneyPensionSubtypeSchema.nullable(),
@@ -35609,11 +35900,11 @@ var moneyNetWorthUnknownSchema = moneyNetWorthAccountSchema.pick({
 var moneyNetWorthSchema = object({
   scope: moneyBudgetScopeSchema,
   month: moneyMonthSchema,
-  total: amount5,
-  have: amount5,
-  owe: amount5,
-  liquid: amount5,
-  locked: amount5,
+  total: amount6,
+  have: amount6,
+  owe: amount6,
+  liquid: amount6,
+  locked: amount6,
   points: array(moneyNetWorthPointSchema),
   accounts: array(moneyNetWorthAccountSchema),
   complete: boolean2(),
@@ -35628,7 +35919,7 @@ var moneySnapshotSchema = object({
   id: ulidSchema,
   accountId: ulidSchema,
   month: moneyMonthSchema,
-  value: amount5,
+  value: amount6,
   source: moneySnapshotSourceSchema
 });
 
@@ -35718,22 +36009,22 @@ var moneySettlementViewSchema = object({
 });
 
 // ../../packages/schema/src/contracts/money-year.ts
-var amount6 = string2();
+var amount7 = string2();
 var moneyYearQuerySchema = object({
   year: exports_coerce.number().int().min(2000).max(2100).optional(),
   scope: moneyBudgetScopeSchema.optional()
 });
 var moneyYearMonthSchema = object({
   month: moneyMonthSchema,
-  income: amount6,
-  spent: amount6
+  income: amount7,
+  spent: amount7
 });
 var moneyYearCategorySchema = object({
   categoryId: ulidSchema.nullable(),
   name: string2(),
   group: _enum2(["fixed", "flexible", "income"]).nullable(),
-  amount: amount6,
-  lastYear: amount6
+  amount: amount7,
+  lastYear: amount7
 });
 var MONEY_YEAR_STREAM_CHANGES = ["new", "stopped", "up", "down", "same"];
 var moneyYearStreamChangeSchema = _enum2(MONEY_YEAR_STREAM_CHANGES);
@@ -35742,8 +36033,8 @@ var moneyYearStreamSchema = object({
   title: string2(),
   cadence: moneyCadenceSchema,
   visibility: _enum2(NODE_VISIBILITY_VALUES),
-  thisYear: amount6,
-  lastYear: amount6,
+  thisYear: amount7,
+  lastYear: amount7,
   change: moneyYearStreamChangeSchema
 });
 var moneyYearGoalSchema = object({
@@ -35752,14 +36043,14 @@ var moneyYearGoalSchema = object({
   visibility: _enum2(NODE_VISIBILITY_VALUES),
   status: moneyGoalStatusSchema,
   projectTitle: string2().nullable(),
-  thisYear: amount6,
-  saved: amount6,
-  target: amount6
+  thisYear: amount7,
+  saved: amount7,
+  target: amount7
 });
 var moneyYearTotalsSchema = object({
-  income: amount6,
-  spent: amount6,
-  saved: amount6
+  income: amount7,
+  spent: amount7,
+  saved: amount7
 });
 var moneyYearSchema = object({
   year: number2().int(),
@@ -36413,6 +36704,23 @@ var moneyOperations = defineOperations({
     response: { description: "The year." },
     errors: { 400: true }
   },
+  flow: {
+    method: "get",
+    path: "/money/flow",
+    scopes: ["finance:read"],
+    tag: "Money",
+    summary: "Get where the money went",
+    description: "What came in over a span of months and where it went, as the flow chart draws it: `sources` (each income category, null `categoryId` for income not sorted yet, and with a `scope` narrower than `all` `moved_in`, money moved in from the other budget accounts; biggest first) adding up to `in`; `outs` in the chart's order, only what's above zero: `fixed` and `flexible` spending (refunds netted, plain transfers left out; what isn't sorted yet sits under flexible), `moved_out` (to the other budget accounts, with a narrower scope), `goals` (a deposit linked to a goal, or spending toward it from the budget), `invested` (transfers into an investment or a pension account) and `kept` (what's left); `fromSavings` when more went out than came in. `fixed` and `flexible` by category, biggest first, with `unsorted`, and `saved` (goals, invested and kept). Read over the accounts counted in the budget; another member's Only me account or goal never adds to it. `from` and `to` are months (`YYYY-MM`; `to` this month and `from` `to` by default, `from=start` the ledger's first month, `firstMonth`); a span under way counts to this month (`through`). `scope`: `all` (default), `space` or `owner`.",
+    query: [
+      { name: "from", description: "The first month, YYYY-MM, or start (default: to)." },
+      { name: "to", description: "The last month, YYYY-MM (default this one)." },
+      { name: "scope", description: "all, space or owner." }
+    ],
+    querySchema: moneyFlowQuerySchema,
+    status: 200,
+    response: { description: "The flow." },
+    errors: { 400: true }
+  },
   netWorthRead: {
     method: "get",
     path: "/money/net-worth",
@@ -41452,9 +41760,14 @@ var timeBlockOperations = defineOperations({
     scopes: ["calendar:read"],
     tag: "Calendar",
     summary: "Plan vs what happened",
-    description: 'How the key\'s member\'s life blocks went against their plan over the last `days` (7, 30 or 90; default 30): `week`, last week (Monday to Sunday) as strips (each block\'s planned and recorded minutes into the day, and the day in words, "Held mostly", "Evening went elsewhere"); `hours`, where that week\'s time went per group of kinds, recorded against planned; `moves`, which blocks move over the range\'s weekdays and how, in words ("Lunch \xB7 60\u201375 min \xB7 Runs about twice the 30 planned \xB7 17 of 22"), counting a record once it\'s confirmed or 48 h old, each with `latestId` (its latest block); `evening`, the weekday evenings\' tasks (Tasks planned from 17:00) held, in words with the days work ran past 17:30, and a confidence word, or null; and `suggestion`, one template length to change ("plan it like it is", apply with `PATCH /api/v1/block-templates/{id}` `{ minutes }`) or null. Moving is information, not a miss: no score, no streak.',
+    description: "How the key's member's life blocks went against their plan over the last `days` (7, 30 or 90; default 30), or a month `range` in its place (Review's Range menu: `month`, this month so far; `six`, from the first of the month five back; `year`, this year so far; `all`, since the first recorded block; the response says its `days` and `range`): `week`, last week (Monday to Sunday) as strips (each block's planned and recorded minutes into the day, and the day in words, \"Held mostly\", \"Evening went elsewhere\"); `hours`, where that week's time went per group of kinds, recorded against planned; `moves`, which blocks move over the range's weekdays and how, in words (\"Lunch \xB7 60\u201375 min \xB7 Runs about twice the 30 planned \xB7 17 of 22\"), counting a record once it's confirmed or 48 h old, each with `latestId` (its latest block); `evening`, the weekday evenings' tasks (Tasks planned from 17:00) held, in words with the days work ran past 17:30, and a confidence word, or null; and `suggestion`, one template length to change (\"plan it like it is\", apply with `PATCH /api/v1/block-templates/{id}` `{ minutes }`) or null. Moving is information, not a miss: no score, no streak.",
     query: [
-      { name: "days", description: "7, 30 (default) or 90.", type: "integer", enum: [7, 30, 90] }
+      { name: "days", description: "7, 30 (default) or 90.", type: "integer", enum: [7, 30, 90] },
+      {
+        name: "range",
+        description: "month, six, year or all, in place of days.",
+        enum: ["month", "six", "year", "all"]
+      }
     ],
     querySchema: planVsRecordQuerySchema,
     status: 200,
@@ -41501,9 +41814,9 @@ var todayOperations = defineOperations({
 // ../../packages/schema/src/contracts/waste-calendar.ts
 var WASTE_KIND_VALUES = ["rest", "pmd", "paper", "garden", "glass", "other"];
 var wasteKindSchema = _enum2(WASTE_KIND_VALUES);
-var civilDate3 = exports_iso.date();
+var civilDate4 = exports_iso.date();
 var wasteCollectionSchema = object({
-  date: civilDate3,
+  date: civilDate4,
   kinds: array(wasteKindSchema).min(1),
   movedBy: string2().min(1).optional()
 });
@@ -49743,6 +50056,281 @@ var commands20 = [
   }
 ];
 
+// src/commands/habit-items.ts
+var DATE_FLAG = {
+  name: "date",
+  type: "string",
+  description: "The day (YYYY-MM-DD); today in your zone when absent."
+};
+var WHEN_FLAGS = [
+  {
+    name: "on",
+    type: "string",
+    description: "Its weekdays, e.g. mo,we,fr; every day when absent."
+  },
+  {
+    name: "part",
+    type: "string",
+    description: "Its part of the day: morning, midday or evening."
+  }
+];
+function itemWhenFromFlags(flags) {
+  const out = {};
+  const on = flagString(flags, "on");
+  if (on !== undefined)
+    out.byDay = on.split(",").map((d) => d.trim().toUpperCase().slice(0, 2)).filter(Boolean);
+  if (flagBool(flags, "every-day"))
+    out.byDay = null;
+  const part = flagString(flags, "part");
+  if (part !== undefined)
+    out.timeOfDay = part === "any" ? null : part.trim().toLowerCase();
+  return out;
+}
+function renderChecklist(data, mode) {
+  const parsed = habitChecklistDaySchema.safeParse(data);
+  if (!parsed.success)
+    return renderRecord(data, mode);
+  const day = parsed.data;
+  const lines = day.items.map((i) => {
+    const mark = i.ticked ? paint(mode, "green", "\u2713") : i.due ? "\xB7" : " ";
+    const off = i.due ? "" : paint(mode, "dim", " (not due)");
+    return `${mark} ${i.title}${off}  ${paint(mode, "dim", i.id)}`;
+  });
+  lines.push(paint(mode, "dim", `${day.date}: ${day.ticked} of ${day.due}, ${day.percent}%${day.done ? ", done" : ""}`));
+  return lines.join(`
+`);
+}
+function renderItems(data, mode) {
+  const parsed = habitItemListSchema.safeParse(data);
+  if (!parsed.success)
+    return renderRecord(data, mode);
+  if (parsed.data.length === 0)
+    return "No items yet.";
+  return parsed.data.map((i, n) => {
+    const when = [i.byDay?.join(","), i.timeOfDay].filter(Boolean).join(" \xB7 ");
+    return `${n + 1}. ${i.title}${when ? paint(mode, "dim", ` (${when})`) : ""}  ${paint(mode, "dim", i.id)}`;
+  }).join(`
+`);
+}
+var habitArg = { name: "id", required: true, description: "The checklist habit's ULID." };
+var itemArg = { name: "item-id", required: true, description: "The item's ULID." };
+var NOT_CHECKLIST = "A habit that isn't a checklist answers 409.";
+var commands21 = [
+  {
+    spec: {
+      path: ["habit", "items"],
+      summary: "List a checklist habit's items, in order.",
+      args: [habitArg],
+      flags: [],
+      scopes: [...habitOperations.listItems.scopes],
+      returns: "HabitItem[]",
+      notes: `${routeOf(habitOperations.listItems)}. A checklist habit is one habit of small items; ticking them fills its day (6 of 9 is 67%). Make one with \`do habits create "<title>" --data '{"checklist":true,"items":[{"id":"<ulid>","title":"Item A"}]}'\`. ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, requireClient }) => ({
+      data: await requireClient().get(pathOf(habitOperations.listItems, { id: requireArg(args, 0, "habit id") })),
+      render: renderItems
+    })
+  },
+  {
+    spec: {
+      path: ["habit", "item", "add"],
+      summary: "Add an item to a checklist habit.",
+      args: [habitArg, { name: "title", required: true, description: "The item's title." }],
+      flags: [
+        ...WHEN_FLAGS,
+        { name: "at", type: "string", description: "Its place, 1 first; last when absent." }
+      ],
+      scopes: [...habitOperations.addItem.scopes],
+      returns: "HabitItem[]",
+      notes: `${routeOf(habitOperations.addItem)}. e.g. \`do habit item add <id> "Morning glass of water" --part morning\`. ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const id = requireArg(args, 0, "habit id");
+      const title = args.slice(1).join(" ").trim();
+      if (!title)
+        throw usageError('habit item add needs a title, e.g. `do habit item add <id> "Item A"`');
+      const at = flagString(flags, "at");
+      const input = parseInput(createHabitItemInputSchema, {
+        id: ulid3(),
+        title,
+        ...itemWhenFromFlags(flags),
+        ...at !== undefined ? { position: Math.max(0, Number(at) - 1) } : {}
+      });
+      return {
+        data: await requireClient().post(pathOf(habitOperations.addItem, { id }), input),
+        render: renderItems
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["habit", "item", "edit"],
+      summary: "Rename an item or change when it's due.",
+      args: [habitArg, itemArg],
+      flags: [
+        { name: "title", type: "string", description: "Its new title." },
+        ...WHEN_FLAGS,
+        { name: "every-day", type: "boolean", description: "Due every day again." }
+      ],
+      scopes: [...habitOperations.updateItem.scopes],
+      returns: "HabitItem[]",
+      notes: `${routeOf(habitOperations.updateItem)}. --part any clears its part of the day. ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const id = requireArg(args, 0, "habit id");
+      const itemId = requireArg(args, 1, "item id");
+      const title = flagString(flags, "title");
+      const input = parseInput(updateHabitItemInputSchema, {
+        ...title !== undefined ? { title } : {},
+        ...itemWhenFromFlags(flags)
+      });
+      if (Object.keys(input).length === 0)
+        throw usageError("nothing to change \u2014 pass --title, --on, --every-day or --part");
+      return {
+        data: await requireClient().patch(pathOf(habitOperations.updateItem, { id, itemId }), input),
+        render: renderItems
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["habit", "item", "order"],
+      summary: "Put a checklist habit's items in a new order.",
+      args: [
+        habitArg,
+        { name: "item-ids", required: true, description: "Every item's ULID, first to last." }
+      ],
+      flags: [],
+      scopes: [...habitOperations.reorderItems.scopes],
+      returns: "HabitItem[]",
+      notes: `${routeOf(habitOperations.reorderItems)}. Name every item on the list once (400 otherwise). ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, requireClient }) => {
+      const id = requireArg(args, 0, "habit id");
+      const input = parseInput(reorderHabitItemsInputSchema, { ids: args.slice(1) });
+      return {
+        data: await requireClient().put(pathOf(habitOperations.reorderItems, { id }), input),
+        render: renderItems
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["habit", "item", "rm"],
+      summary: "Remove an item from a checklist habit (archived; its past ticks keep counting).",
+      args: [habitArg, itemArg],
+      flags: [],
+      scopes: [...habitOperations.archiveItem.scopes],
+      returns: "HabitItem[]",
+      notes: `${routeOf(habitOperations.archiveItem)}. ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, requireClient }) => {
+      const id = requireArg(args, 0, "habit id");
+      const itemId = requireArg(args, 1, "item id");
+      return {
+        data: await requireClient().delete(pathOf(habitOperations.archiveItem, { id, itemId })),
+        render: renderItems
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["habit", "checklist"],
+      summary: "A checklist habit's day: each item due and ticked, and the percent.",
+      args: [habitArg],
+      flags: [DATE_FLAG],
+      scopes: [...habitOperations.checklist.scopes],
+      returns: "HabitChecklistDay",
+      notes: `${routeOf(habitOperations.checklist)}. The habit's day value is this percent (target 100). ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const id = requireArg(args, 0, "habit id");
+      const date = flagString(flags, "date");
+      const q = date ? `?${new URLSearchParams({ date })}` : "";
+      return {
+        data: await requireClient().get(`${pathOf(habitOperations.checklist, { id })}${q}`),
+        render: renderChecklist
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["habit", "tick"],
+      summary: "Tick an item of a checklist habit.",
+      args: [habitArg, itemArg],
+      flags: [DATE_FLAG],
+      scopes: [...habitOperations.tickItem.scopes],
+      returns: "HabitChecklistDay",
+      notes: `${routeOf(habitOperations.tickItem)}. A ticked item stays ticked. An Agent's key ticks it as that Agent's. ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const id = requireArg(args, 0, "habit id");
+      const itemId = requireArg(args, 1, "item id");
+      const input = parseInput(habitItemTickInputSchema, dateOf(flags));
+      return {
+        data: await requireClient().post(pathOf(habitOperations.tickItem, { id, itemId }), input),
+        render: renderChecklist
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["habit", "untick"],
+      summary: "Untick an item of a checklist habit.",
+      args: [habitArg, itemArg],
+      flags: [DATE_FLAG],
+      scopes: [...habitOperations.untickItem.scopes],
+      returns: "HabitChecklistDay",
+      notes: `${routeOf(habitOperations.untickItem)}. ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const id = requireArg(args, 0, "habit id");
+      const itemId = requireArg(args, 1, "item id");
+      const input = parseInput(habitItemTickInputSchema, dateOf(flags));
+      return {
+        data: await requireClient().post(pathOf(habitOperations.untickItem, { id, itemId }), input),
+        render: renderChecklist
+      };
+    }
+  },
+  {
+    spec: {
+      path: ["habit", "tick-all"],
+      summary: 'Tick every item due ("All"), or all but some: "all done except one".',
+      args: [habitArg],
+      flags: [
+        DATE_FLAG,
+        {
+          name: "except",
+          type: "string",
+          description: "Item ULIDs to leave unticked, comma-separated."
+        }
+      ],
+      scopes: [...habitOperations.tickAll.scopes],
+      returns: "HabitChecklistDay",
+      notes: `${routeOf(habitOperations.tickAll)}. The items in --except end up unticked (unticked if they were). Find their ids with \`do habit checklist <id>\`. ${NOT_CHECKLIST}`
+    },
+    run: async ({ args, flags, requireClient }) => {
+      const id = requireArg(args, 0, "habit id");
+      const except = flagString(flags, "except");
+      const input = parseInput(habitTickAllInputSchema, {
+        ...dateOf(flags),
+        ...except ? {
+          except: except.split(",").map((s) => s.trim()).filter(Boolean)
+        } : {}
+      });
+      return {
+        data: await requireClient().post(pathOf(habitOperations.tickAll, { id }), input),
+        render: renderChecklist
+      };
+    }
+  }
+];
+function dateOf(flags) {
+  const date = flagString(flags, "date");
+  return date ? { date } : {};
+}
+
 // src/commands/habits.ts
 var SCHEDULE_FLAGS = [
   { name: "every-day", type: "boolean", description: "Due every day." },
@@ -49881,7 +50469,7 @@ function seasonFromFlags(flags) {
   const season = flagString(flags, "season");
   return season === undefined ? {} : { activeMonths: seasonFromFlag(season) };
 }
-var commands21 = [
+var commands22 = [
   {
     spec: {
       path: ["habits", "create"],
@@ -51021,7 +51609,7 @@ function healthRecordHandlers() {
   }
   return out;
 }
-var commands22 = pairCommands(HEALTH_COMMAND_SPECS, {
+var commands23 = pairCommands(HEALTH_COMMAND_SPECS, {
   ...healthRecordHandlers(),
   "health record": async ({ flags, requireClient }) => {
     const body = parseInput(logHealthInputSchema, readDataFlag(flags));
@@ -51291,7 +51879,7 @@ var commands22 = pairCommands(HEALTH_COMMAND_SPECS, {
 });
 
 // src/commands/house.ts
-var commands23 = [
+var commands24 = [
   {
     spec: {
       path: ["house"],
@@ -51573,7 +52161,7 @@ function renderSorting(data, _mode) {
   ].join(`
 `);
 }
-var commands24 = [
+var commands25 = [
   defineCommand({
     operation: inboxOperations.list,
     path: ["inbox"],
@@ -51665,7 +52253,7 @@ var commands24 = [
 ];
 
 // src/commands/incidents.ts
-var commands25 = [
+var commands26 = [
   {
     spec: {
       path: ["incidents", "open"],
@@ -51894,7 +52482,7 @@ function journalDateArg(args, verb) {
   }
   return date;
 }
-var commands26 = [
+var commands27 = [
   defineCommand({
     operation: journalOperations.day,
     path: ["journal", "day"],
@@ -52457,7 +53045,7 @@ function renderCreatedKey(data, mode) {
   ].join(`
 `);
 }
-var commands27 = [
+var commands28 = [
   {
     spec: {
       path: ["keys", "list"],
@@ -52593,7 +53181,7 @@ var KIND_FLAG2 = {
   type: "string",
   description: "The kind of an unknown word (pages, eggs, health, note, or a word taught before); remembered for the Space."
 };
-var commands28 = [
+var commands29 = [
   {
     spec: {
       path: ["log"],
@@ -52668,7 +53256,7 @@ var commands28 = [
 ];
 
 // src/commands/mail-campaigns.ts
-var commands29 = [
+var commands30 = [
   {
     spec: {
       path: ["mail-campaigns", "list"],
@@ -52983,7 +53571,7 @@ async function serveMcp(io, target) {
 }
 
 // src/commands/mcp.ts
-var commands30 = [
+var commands31 = [
   {
     spec: {
       path: ["mcp"],
@@ -53028,7 +53616,7 @@ var commands30 = [
 ];
 
 // src/commands/members.ts
-var commands31 = [
+var commands32 = [
   {
     spec: {
       path: ["invite", "create"],
@@ -53153,7 +53741,7 @@ var commands31 = [
 ];
 
 // src/commands/metrics.ts
-var commands32 = [
+var commands33 = [
   {
     spec: {
       path: ["metrics", "list"],
@@ -53281,7 +53869,7 @@ async function setModuleVisibility(args, requireClient, on) {
     render: renderRecord
   };
 }
-var commands33 = [
+var commands34 = [
   {
     spec: {
       path: ["modules", "list"],
@@ -53510,7 +54098,7 @@ function shareFlag(flags) {
 function localMonth(now) {
   return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}`;
 }
-var commands34 = [
+var commands35 = [
   defineCommand({
     operation: moneyOperations.listAccounts,
     path: ["money", "accounts"],
@@ -54372,6 +54960,33 @@ var commands34 = [
       render: renderRecord
     })
   }),
+  defineCommand({
+    operation: moneyOperations.flow,
+    path: ["money", "flow"],
+    summary: "Where the money went over a span of months: in by source, out to fixed, flexible, goals, invested and kept.",
+    args: [],
+    flags: [
+      {
+        name: "from",
+        type: "string",
+        description: "The first month, YYYY-MM, or start (default: --to)."
+      },
+      { name: "to", type: "string", description: "The last month, YYYY-MM (default this one)." },
+      { name: "scope", type: "string", description: "all (default) | space | owner." }
+    ],
+    returns: "MoneyFlow",
+    notes: ". sources (income by category, moved_in with a narrower scope) adding up to in; outs in the chart's order (fixed \xB7 flexible \xB7 moved_out \xB7 goals \xB7 invested \xB7 kept), only what's above zero; fromSavings when more went out than came in; fixed and flexible by category, with unsorted (what isn't sorted sits under flexible) and saved. `do money flow --from 2026-05 --to 2026-10`; `--from start` reads since the ledger begins.",
+    run: async ({ flags, requireClient }) => ({
+      data: await requireClient().get(pathOf(moneyOperations.flow), {
+        query: {
+          from: flagString(flags, "from"),
+          to: flagString(flags, "to"),
+          scope: flagString(flags, "scope")
+        }
+      }),
+      render: renderRecord
+    })
+  }),
   defineCommand({
     operation: moneyOperations.netWorthRead,
     path: ["money", "net-worth"],
@@ -54652,7 +55267,7 @@ var commands34 = [
 ];
 
 // src/commands/notes.ts
-var commands35 = [
+var commands36 = [
   {
     spec: {
       path: ["notes", "backlinks"],
@@ -54774,7 +55389,7 @@ var commands35 = [
 ];
 
 // src/commands/orca.ts
-var commands36 = [
+var commands37 = [
   {
     spec: {
       path: ["orca", "list"],
@@ -55140,7 +55755,7 @@ function linkBody(args) {
     return parseInput(familyTreeLinkInputSchema, { kind, a: ref, b: other });
   throw usageError("the kind is parent, child or partner");
 }
-var commands37 = [
+var commands38 = [
   {
     spec: {
       path: ["people", "propose"],
@@ -55829,7 +56444,7 @@ var commands37 = [
 
 // src/commands/places.ts
 import { readFileSync as readFileSync10 } from "fs";
-var commands38 = [
+var commands39 = [
   {
     spec: {
       path: ["places", "import"],
@@ -55886,7 +56501,7 @@ async function planDecision({ args, requireClient }, verb) {
     render: renderPlan
   };
 }
-var commands39 = [
+var commands40 = [
   {
     spec: {
       path: ["plans", "list"],
@@ -56113,7 +56728,7 @@ var commands39 = [
 ];
 
 // src/commands/presets.ts
-var commands40 = [
+var commands41 = [
   {
     spec: {
       path: ["presets", "list"],
@@ -56210,7 +56825,7 @@ function renderReviewSummary(data, mode) {
   return out.join(`
 `);
 }
-var commands41 = [
+var commands42 = [
   {
     spec: {
       path: ["progress"],
@@ -56419,7 +57034,7 @@ function renderUpdates(data, mode) {
   return updates.map((u) => updateLine(u, mode)).join(`
 `);
 }
-var commands42 = [
+var commands43 = [
   defineCommand({
     operation: projectOperations.update,
     path: ["projects", "set"],
@@ -57016,7 +57631,7 @@ var routineCommands = [
     }
   }
 ];
-var commands43 = [
+var commands44 = [
   ...routineCommands,
   {
     spec: {
@@ -57139,7 +57754,7 @@ var commands43 = [
 ];
 
 // src/commands/rsvp-answers.ts
-var commands44 = [
+var commands45 = [
   {
     spec: {
       path: ["rsvp-answers", "list"],
@@ -57193,7 +57808,7 @@ var commands44 = [
 ];
 
 // src/commands/rsvp-links.ts
-var commands45 = [
+var commands46 = [
   {
     spec: {
       path: ["rsvp-links", "list"],
@@ -57289,7 +57904,7 @@ var commands45 = [
 ];
 
 // src/commands/rsvp-questions.ts
-var commands46 = [
+var commands47 = [
   {
     spec: {
       path: ["rsvp-questions", "presets"],
@@ -57861,7 +58476,7 @@ function sessionFlags(flags) {
     body.occurredOn = on;
   return body;
 }
-var commands47 = [
+var commands48 = [
   {
     spec: {
       path: ["runs", "change"],
@@ -58178,7 +58793,7 @@ var commands47 = [
 ];
 
 // src/commands/search.ts
-var commands48 = [
+var commands49 = [
   {
     spec: {
       path: ["search"],
@@ -58211,7 +58826,7 @@ var commands48 = [
 ];
 
 // src/commands/seating-proposals.ts
-var commands49 = [
+var commands50 = [
   {
     spec: {
       path: ["seating-proposals", "list"],
@@ -58298,7 +58913,7 @@ var commands49 = [
 ];
 
 // src/commands/sensors.ts
-var commands50 = [
+var commands51 = [
   {
     spec: {
       path: ["sensors", "status"],
@@ -58458,7 +59073,7 @@ var commands50 = [
 ];
 
 // src/commands/settings.ts
-var commands51 = [
+var commands52 = [
   {
     spec: {
       path: ["settings", "get"],
@@ -58492,7 +59107,7 @@ var commands51 = [
 ];
 
 // src/commands/sharing.ts
-var commands52 = [
+var commands53 = [
   {
     spec: {
       path: ["share"],
@@ -58625,7 +59240,7 @@ var commands52 = [
 ];
 
 // src/commands/space.ts
-var commands53 = [
+var commands54 = [
   {
     spec: {
       path: ["space", "address"],
@@ -58681,7 +59296,7 @@ var commands53 = [
 ];
 
 // src/commands/tap-tags.ts
-var commands54 = [
+var commands55 = [
   {
     spec: {
       path: ["tap-tags", "tap"],
@@ -58709,7 +59324,7 @@ var BY = {
   type: "string",
   description: "The blocking task's ref (DO-147) or ULID."
 };
-var commands55 = [
+var commands56 = [
   defineCommand({
     operation: taskBlockOperations.addBlocker,
     path: ["tasks", "block"],
@@ -58775,7 +59390,7 @@ function renderSeries(data, mode) {
   }).join(`
 `);
 }
-var commands56 = [
+var commands57 = [
   defineCommand({
     operation: taskSeriesOperations.make,
     path: ["tasks", "make-series"],
@@ -58930,7 +59545,7 @@ function repeatFromFlags(flags) {
     out.anchor = "from_completion";
   return out;
 }
-var commands57 = [
+var commands58 = [
   {
     spec: {
       path: ["capture"],
@@ -59388,7 +60003,7 @@ var commands57 = [
 ];
 
 // src/commands/time-blocks.ts
-var commands58 = [
+var commands59 = [
   {
     spec: {
       path: ["time-blocks", "record"],
@@ -59424,16 +60039,27 @@ var commands58 = [
       path: ["time-blocks", "plan-vs-record"],
       summary: "How the life blocks went against their plan: last week day by day, where the time went, which blocks move (in words), and one template change worth making.",
       args: [],
-      flags: [{ name: "days", type: "string", description: "7, 30 (default) or 90." }],
+      flags: [
+        { name: "days", type: "string", description: "7, 30 (default) or 90." },
+        {
+          name: "range",
+          type: "string",
+          description: "month | six | year | all (Review's months), in place of --days."
+        }
+      ],
       scopes: [...timeBlockOperations.planVsRecord.scopes],
       returns: "PlanVsRecord",
-      notes: `${routeOf(timeBlockOperations.planVsRecord)}?days= (plan vs record). No score, no streak.`
+      notes: `${routeOf(timeBlockOperations.planVsRecord)}?days= or ?range= (plan vs record). No score, no streak.`
     },
     run: async ({ flags, requireClient }) => {
       const days = flagString(flags, "days");
+      const range = flagString(flags, "range");
       return {
         data: await requireClient().get(pathOf(timeBlockOperations.planVsRecord), {
-          query: days === undefined ? {} : { days }
+          query: {
+            ...days === undefined ? {} : { days },
+            ...range === undefined ? {} : { range }
+          }
         }),
         render: renderRecord
       };
@@ -59569,7 +60195,7 @@ function renderLandedCounts(data, mode) {
   return out.join(`
 `);
 }
-var commands59 = [
+var commands60 = [
   {
     spec: {
       path: ["today"],
@@ -59941,7 +60567,7 @@ function renderViews(data, mode) {
 function renderView(data, mode) {
   return renderViews([data], mode);
 }
-var commands60 = [
+var commands61 = [
   defineCommand({
     operation: workViewOperations.list,
     path: ["views", "list"],
@@ -60060,7 +60686,7 @@ var commands60 = [
 ];
 
 // src/commands/worktree-links.ts
-var commands61 = [
+var commands62 = [
   {
     spec: {
       path: ["worktree-links", "list"],
@@ -60227,7 +60853,8 @@ var FEATURE_COMMANDS = [
   ...commands58,
   ...commands59,
   ...commands60,
-  ...commands61
+  ...commands61,
+  ...commands62
 ];
 
 // src/registry.ts