@robbeverhelst/do 1.386.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.386.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),
@@ -22025,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, {
@@ -22098,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"),
@@ -22113,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(),
@@ -22181,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(),
@@ -22209,6 +22306,7 @@ var updateHabitInputSchema = createUpdateSchema(habits, {
   pausedFrom: true,
   pausedUntil: true,
   retiredAt: true,
+  checklist: true,
   ...eventColumns
 }).extend({
   title: string2().min(1).optional(),
@@ -29676,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(),
@@ -29713,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),
@@ -29725,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(),
@@ -29757,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(),
@@ -29768,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() }),
@@ -29777,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(),
@@ -29788,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()
@@ -29806,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()
@@ -29863,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()
@@ -29897,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({
@@ -29906,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),
@@ -31098,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: {
@@ -31411,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"
   }
 });
 
@@ -35263,13 +35490,13 @@ 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(),
+  leftoverEatBy: civilDate3.nullish(),
   leftoverFrozen: boolean2().optional(),
   eaterUserIds: array(ulidSchema).max(50).optional(),
   guests: number2().int().min(0).max(99).optional()
@@ -35333,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(),
@@ -35355,7 +35582,7 @@ var mealWeekSlotSchema = object({
   time: string2().nullable()
 });
 var mealWeekDaySchema = object({
-  date: civilDate2,
+  date: civilDate3,
   isToday: boolean2(),
   dinner: mealWeekSlotSchema.nullable(),
   lunch: mealWeekSlotSchema.nullable()
@@ -35364,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),
@@ -41587,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()
 });
@@ -49829,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." },
@@ -49967,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"],
@@ -51107,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));
@@ -51377,7 +51879,7 @@ var commands22 = pairCommands(HEALTH_COMMAND_SPECS, {
 });
 
 // src/commands/house.ts
-var commands23 = [
+var commands24 = [
   {
     spec: {
       path: ["house"],
@@ -51659,7 +52161,7 @@ function renderSorting(data, _mode) {
   ].join(`
 `);
 }
-var commands24 = [
+var commands25 = [
   defineCommand({
     operation: inboxOperations.list,
     path: ["inbox"],
@@ -51751,7 +52253,7 @@ var commands24 = [
 ];
 
 // src/commands/incidents.ts
-var commands25 = [
+var commands26 = [
   {
     spec: {
       path: ["incidents", "open"],
@@ -51980,7 +52482,7 @@ function journalDateArg(args, verb) {
   }
   return date;
 }
-var commands26 = [
+var commands27 = [
   defineCommand({
     operation: journalOperations.day,
     path: ["journal", "day"],
@@ -52543,7 +53045,7 @@ function renderCreatedKey(data, mode) {
   ].join(`
 `);
 }
-var commands27 = [
+var commands28 = [
   {
     spec: {
       path: ["keys", "list"],
@@ -52679,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"],
@@ -52754,7 +53256,7 @@ var commands28 = [
 ];
 
 // src/commands/mail-campaigns.ts
-var commands29 = [
+var commands30 = [
   {
     spec: {
       path: ["mail-campaigns", "list"],
@@ -53069,7 +53571,7 @@ async function serveMcp(io, target) {
 }
 
 // src/commands/mcp.ts
-var commands30 = [
+var commands31 = [
   {
     spec: {
       path: ["mcp"],
@@ -53114,7 +53616,7 @@ var commands30 = [
 ];
 
 // src/commands/members.ts
-var commands31 = [
+var commands32 = [
   {
     spec: {
       path: ["invite", "create"],
@@ -53239,7 +53741,7 @@ var commands31 = [
 ];
 
 // src/commands/metrics.ts
-var commands32 = [
+var commands33 = [
   {
     spec: {
       path: ["metrics", "list"],
@@ -53367,7 +53869,7 @@ async function setModuleVisibility(args, requireClient, on) {
     render: renderRecord
   };
 }
-var commands33 = [
+var commands34 = [
   {
     spec: {
       path: ["modules", "list"],
@@ -53596,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"],
@@ -54765,7 +55267,7 @@ var commands34 = [
 ];
 
 // src/commands/notes.ts
-var commands35 = [
+var commands36 = [
   {
     spec: {
       path: ["notes", "backlinks"],
@@ -54887,7 +55389,7 @@ var commands35 = [
 ];
 
 // src/commands/orca.ts
-var commands36 = [
+var commands37 = [
   {
     spec: {
       path: ["orca", "list"],
@@ -55253,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"],
@@ -55942,7 +56444,7 @@ var commands37 = [
 
 // src/commands/places.ts
 import { readFileSync as readFileSync10 } from "fs";
-var commands38 = [
+var commands39 = [
   {
     spec: {
       path: ["places", "import"],
@@ -55999,7 +56501,7 @@ async function planDecision({ args, requireClient }, verb) {
     render: renderPlan
   };
 }
-var commands39 = [
+var commands40 = [
   {
     spec: {
       path: ["plans", "list"],
@@ -56226,7 +56728,7 @@ var commands39 = [
 ];
 
 // src/commands/presets.ts
-var commands40 = [
+var commands41 = [
   {
     spec: {
       path: ["presets", "list"],
@@ -56323,7 +56825,7 @@ function renderReviewSummary(data, mode) {
   return out.join(`
 `);
 }
-var commands41 = [
+var commands42 = [
   {
     spec: {
       path: ["progress"],
@@ -56532,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"],
@@ -57129,7 +57631,7 @@ var routineCommands = [
     }
   }
 ];
-var commands43 = [
+var commands44 = [
   ...routineCommands,
   {
     spec: {
@@ -57252,7 +57754,7 @@ var commands43 = [
 ];
 
 // src/commands/rsvp-answers.ts
-var commands44 = [
+var commands45 = [
   {
     spec: {
       path: ["rsvp-answers", "list"],
@@ -57306,7 +57808,7 @@ var commands44 = [
 ];
 
 // src/commands/rsvp-links.ts
-var commands45 = [
+var commands46 = [
   {
     spec: {
       path: ["rsvp-links", "list"],
@@ -57402,7 +57904,7 @@ var commands45 = [
 ];
 
 // src/commands/rsvp-questions.ts
-var commands46 = [
+var commands47 = [
   {
     spec: {
       path: ["rsvp-questions", "presets"],
@@ -57974,7 +58476,7 @@ function sessionFlags(flags) {
     body.occurredOn = on;
   return body;
 }
-var commands47 = [
+var commands48 = [
   {
     spec: {
       path: ["runs", "change"],
@@ -58291,7 +58793,7 @@ var commands47 = [
 ];
 
 // src/commands/search.ts
-var commands48 = [
+var commands49 = [
   {
     spec: {
       path: ["search"],
@@ -58324,7 +58826,7 @@ var commands48 = [
 ];
 
 // src/commands/seating-proposals.ts
-var commands49 = [
+var commands50 = [
   {
     spec: {
       path: ["seating-proposals", "list"],
@@ -58411,7 +58913,7 @@ var commands49 = [
 ];
 
 // src/commands/sensors.ts
-var commands50 = [
+var commands51 = [
   {
     spec: {
       path: ["sensors", "status"],
@@ -58571,7 +59073,7 @@ var commands50 = [
 ];
 
 // src/commands/settings.ts
-var commands51 = [
+var commands52 = [
   {
     spec: {
       path: ["settings", "get"],
@@ -58605,7 +59107,7 @@ var commands51 = [
 ];
 
 // src/commands/sharing.ts
-var commands52 = [
+var commands53 = [
   {
     spec: {
       path: ["share"],
@@ -58738,7 +59240,7 @@ var commands52 = [
 ];
 
 // src/commands/space.ts
-var commands53 = [
+var commands54 = [
   {
     spec: {
       path: ["space", "address"],
@@ -58794,7 +59296,7 @@ var commands53 = [
 ];
 
 // src/commands/tap-tags.ts
-var commands54 = [
+var commands55 = [
   {
     spec: {
       path: ["tap-tags", "tap"],
@@ -58822,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"],
@@ -58888,7 +59390,7 @@ function renderSeries(data, mode) {
   }).join(`
 `);
 }
-var commands56 = [
+var commands57 = [
   defineCommand({
     operation: taskSeriesOperations.make,
     path: ["tasks", "make-series"],
@@ -59043,7 +59545,7 @@ function repeatFromFlags(flags) {
     out.anchor = "from_completion";
   return out;
 }
-var commands57 = [
+var commands58 = [
   {
     spec: {
       path: ["capture"],
@@ -59501,7 +60003,7 @@ var commands57 = [
 ];
 
 // src/commands/time-blocks.ts
-var commands58 = [
+var commands59 = [
   {
     spec: {
       path: ["time-blocks", "record"],
@@ -59693,7 +60195,7 @@ function renderLandedCounts(data, mode) {
   return out.join(`
 `);
 }
-var commands59 = [
+var commands60 = [
   {
     spec: {
       path: ["today"],
@@ -60065,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"],
@@ -60184,7 +60686,7 @@ var commands60 = [
 ];
 
 // src/commands/worktree-links.ts
-var commands61 = [
+var commands62 = [
   {
     spec: {
       path: ["worktree-links", "list"],
@@ -60351,7 +60853,8 @@ var FEATURE_COMMANDS = [
   ...commands58,
   ...commands59,
   ...commands60,
-  ...commands61
+  ...commands61,
+  ...commands62
 ];
 
 // src/registry.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.386.0",
+  "version": "1.387.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "homepage": "https://github.com/robbeverhelst/do/tree/main/apps/cli",