@robbeverhelst/do 1.388.0 → 1.389.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.388.0";
+var VERSION = "1.389.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -29275,6 +29275,36 @@ var healthDataKeys = pgTable("health_data_keys", {
   sealedKey: text("sealed_key").notNull(),
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [primaryKey({ columns: [t.tenantId, t.userId] })]);
+var healthCycleSettings = pgTable("health_cycle_settings", {
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  userId: text("user_id").notNull().references(() => users.id),
+  on: boolean4("on").notNull().default(false),
+  usualLength: integer2("usual_length"),
+  shareNext: boolean4("share_next").notNull().default(false),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  primaryKey({ columns: [t.tenantId, t.userId] }),
+  check2("health_cycle_settings_length_chk", sql`${t.usualLength} IS NULL OR ${t.usualLength} BETWEEN 15 AND 60`)
+]);
+var healthCycleDays = pgTable("health_cycle_days", {
+  id: text("id").primaryKey(),
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  userId: text("user_id").notNull().references(() => users.id),
+  day: date5("day", { mode: "string" }).notNull(),
+  flow: text("flow"),
+  symptoms: text("symptoms").array().notNull().default(sql`'{}'::text[]`),
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [
+  uniqueIndex("health_cycle_days_member_day_uniq").on(t.tenantId, t.userId, t.day),
+  check2("health_cycle_days_flow_chk", sql`${t.flow} IS NULL OR ${t.flow} IN ('none', 'light', 'medium', 'heavy')`)
+]);
+var healthCycleShares = pgTable("health_cycle_shares", {
+  tenantId: text("tenant_id").notNull().references(() => tenants.id),
+  userId: text("user_id").notNull().references(() => users.id),
+  nextOn: date5("next_on", { mode: "string" }).notNull(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (t) => [primaryKey({ columns: [t.tenantId, t.userId] })]);
 
 // ../../packages/schema/src/contracts/health-records.ts
 var BODY_REGION_VALUES = [
@@ -31645,6 +31675,283 @@ var habitOperations = defineOperations({
   }
 });
 
+// ../../packages/schema/src/contracts/plans.ts
+var PLAN_KINDS = ["week", "day"];
+var PLAN_ITEM_ACTIONS = ["plan", "someday", "let_go"];
+var PLAN_ITEM_STATES = ["proposed", "accepted", "dismissed"];
+var PLAN_STATUSES = ["open", "settled", "replaced"];
+var PLAN_DUPLICATE_MODES = ["merge", "reject"];
+var PLAN_MERGE_OUTCOMES = [
+  "scheduled_task",
+  "covered_by_item",
+  "already_planned"
+];
+var PLAN_MATCH_KINDS = ["task", "time_block", "event"];
+var PLAN_MAX_ITEMS = 60;
+var PLAN_MAX_BLOCKS = 140;
+var PLAN_REASON_MAX = 280;
+var PLAN_NOTE_MAX = 2000;
+var planKindSchema = _enum2(PLAN_KINDS);
+var planItemActionSchema = _enum2(PLAN_ITEM_ACTIONS);
+var planItemStateSchema = _enum2(PLAN_ITEM_STATES);
+var planStatusSchema = _enum2(PLAN_STATUSES);
+var civilDaySchema = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "expected YYYY-MM-DD").refine((s) => new Date(`${s}T00:00:00Z`).toISOString().slice(0, 10) === s, "not a real day");
+var DAY_MS = 24 * 60 * 60 * 1000;
+function addCivilDays(day, n) {
+  return new Date(Date.parse(`${day}T00:00:00Z`) + n * DAY_MS).toISOString().slice(0, 10);
+}
+function planDays(kind, startsOn) {
+  return kind === "week" ? Array.from({ length: 7 }, (_, i) => addCivilDays(startsOn, i)) : [startsOn];
+}
+function isMonday(day) {
+  return new Date(`${day}T00:00:00Z`).getUTCDay() === 1;
+}
+var planItemInputSchema = object({
+  taskId: ulidSchema,
+  action: planItemActionSchema.default("plan"),
+  day: civilDaySchema.optional(),
+  at: exports_coerce.date().optional(),
+  durationMinutes: number2().int().min(5).max(24 * 60).optional(),
+  reason: string2().trim().min(1).max(PLAN_REASON_MAX).optional()
+}).strict().superRefine((v, ctx) => {
+  if (v.action === "plan") {
+    if (v.day === undefined === (v.at === undefined)) {
+      ctx.addIssue({
+        code: "custom",
+        message: "a `plan` item takes exactly one of `day` or `at`",
+        path: ["day"]
+      });
+    }
+    if (v.durationMinutes !== undefined && v.at === undefined) {
+      ctx.addIssue({
+        code: "custom",
+        message: "`durationMinutes` goes with `at` (a time)",
+        path: ["durationMinutes"]
+      });
+    }
+  } else if (v.day !== undefined || v.at !== undefined || v.durationMinutes !== undefined) {
+    ctx.addIssue({
+      code: "custom",
+      message: `a \`${v.action}\` item takes no day, time or duration`,
+      path: ["action"]
+    });
+  }
+});
+var planBlockInputSchema = object({
+  templateId: ulidSchema.optional(),
+  lifeKind: lifeBlockKindSchema,
+  title: string2().trim().min(1).max(500).optional(),
+  startAt: exports_coerce.date(),
+  endAt: exports_coerce.date(),
+  routineId: ulidSchema.optional(),
+  reason: string2().trim().min(1).max(PLAN_REASON_MAX).optional()
+}).strict().refine((v) => {
+  const minutes = (v.endAt.getTime() - v.startAt.getTime()) / 60000;
+  return minutes > 0 && minutes <= TIME_BLOCK_MAX_MINUTES;
+}, { message: "endAt must be after startAt and at most a day later", path: ["endAt"] });
+var createPlanInputSchema = object({
+  kind: planKindSchema,
+  startsOn: civilDaySchema,
+  forUserId: string2().min(1).optional(),
+  note: string2().trim().min(1).max(PLAN_NOTE_MAX).optional(),
+  items: array(planItemInputSchema).max(PLAN_MAX_ITEMS).default([]),
+  blocks: array(planBlockInputSchema).max(PLAN_MAX_BLOCKS).default([]),
+  onDuplicate: _enum2(PLAN_DUPLICATE_MODES).default("merge")
+}).strict().superRefine((v, ctx) => {
+  if (v.items.length + v.blocks.length === 0) {
+    ctx.addIssue({
+      code: "custom",
+      message: "a plan proposes at least one item or block",
+      path: ["items"]
+    });
+  }
+  if (v.kind === "week" && !isMonday(v.startsOn)) {
+    ctx.addIssue({
+      code: "custom",
+      message: "a week plan starts on a Monday",
+      path: ["startsOn"]
+    });
+  }
+  const days = new Set(planDays(v.kind, v.startsOn));
+  const seen = new Set;
+  v.items.forEach((item, i) => {
+    if (seen.has(item.taskId)) {
+      ctx.addIssue({
+        code: "custom",
+        message: "one item per task",
+        path: ["items", i, "taskId"]
+      });
+    }
+    seen.add(item.taskId);
+    if (item.day !== undefined && !days.has(item.day)) {
+      ctx.addIssue({
+        code: "custom",
+        message: `the day falls outside the ${v.kind}`,
+        path: ["items", i, "day"]
+      });
+    }
+  });
+});
+var planDecisionInputSchema = object({
+  itemIds: array(string2().min(1)).min(1).max(PLAN_MAX_ITEMS + PLAN_MAX_BLOCKS).optional()
+}).strict();
+var planAdjustInputSchema = object({
+  itemId: string2().min(1),
+  startAt: exports_coerce.date(),
+  endAt: exports_coerce.date()
+}).strict().refine((v) => {
+  const minutes = (v.endAt.getTime() - v.startAt.getTime()) / 60000;
+  return minutes >= 5 && minutes <= TIME_BLOCK_MAX_MINUTES;
+}, { message: "endAt must be 5 minutes to a day after startAt", path: ["endAt"] });
+var PLAN_TEMPLATES = ["normal", "light", "away"];
+var planTemplateSchema = _enum2(PLAN_TEMPLATES);
+var planDraftInputSchema = object({
+  startsOn: civilDaySchema.refine(isMonday, "a week starts on a Monday"),
+  template: planTemplateSchema.default("normal")
+}).strict();
+var planPlaceInputSchema = object({
+  taskId: ulidSchema,
+  startAt: exports_coerce.date(),
+  endAt: exports_coerce.date()
+}).strict().refine((v) => {
+  const minutes = (v.endAt.getTime() - v.startAt.getTime()) / 60000;
+  return minutes >= 5 && minutes <= TIME_BLOCK_MAX_MINUTES;
+}, { message: "endAt must be 5 minutes to a day after startAt", path: ["endAt"] });
+var planUnplaceInputSchema = object({ taskId: ulidSchema }).strict();
+var planListQuerySchema = object({
+  kind: planKindSchema.optional(),
+  status: planStatusSchema.optional(),
+  startsOn: civilDaySchema.optional(),
+  taskId: ulidSchema.optional()
+});
+var planTaskSchema = object({
+  id: ulidSchema,
+  title: string2(),
+  status: taskStatusSchema,
+  scheduledAt: exports_coerce.date().nullable(),
+  allDay: boolean2(),
+  dueAt: exports_coerce.date().nullable(),
+  durationMinutes: number2().int().nullable(),
+  areaId: string2().nullable(),
+  projectId: string2().nullable(),
+  moveCount: number2().int().nonnegative().default(0)
+});
+var planItemViewSchema = object({
+  id: string2(),
+  taskId: ulidSchema,
+  action: planItemActionSchema,
+  scheduledAt: exports_coerce.date().nullable(),
+  allDay: boolean2(),
+  durationMinutes: number2().int().nullable(),
+  reason: string2().nullable(),
+  state: planItemStateSchema,
+  decidedAt: exports_coerce.date().nullable(),
+  task: planTaskSchema
+});
+var planBlockViewSchema = object({
+  id: string2(),
+  templateId: string2().nullable(),
+  lifeKind: lifeBlockKindSchema,
+  title: string2(),
+  startAt: exports_coerce.date(),
+  endAt: exports_coerce.date(),
+  routineId: string2().nullable(),
+  reason: string2().nullable(),
+  state: planItemStateSchema,
+  decidedAt: exports_coerce.date().nullable(),
+  blockId: string2().nullable()
+});
+var planViewSchema = object({
+  id: string2(),
+  kind: planKindSchema,
+  startsOn: civilDaySchema,
+  userId: string2(),
+  agentId: string2().nullable(),
+  note: string2().nullable(),
+  template: planTemplateSchema.nullable().default(null),
+  status: planStatusSchema,
+  createdAt: exports_coerce.date(),
+  updatedAt: exports_coerce.date(),
+  items: array(planItemViewSchema),
+  blocks: array(planBlockViewSchema).default([])
+});
+var planMergeSchema = object({
+  blockIndex: number2().int().min(0),
+  title: string2(),
+  outcome: _enum2(PLAN_MERGE_OUTCOMES),
+  match: object({ kind: _enum2(PLAN_MATCH_KINDS), id: string2(), title: string2() }),
+  hint: string2()
+});
+var PLAN_RULE_OUTCOMES = [
+  "anchored",
+  "added",
+  "kept_free",
+  "over_limit",
+  "below_min",
+  "not_theirs"
+];
+var planShapingSchema = object({
+  ruleId: string2(),
+  sentence: string2(),
+  outcome: _enum2(PLAN_RULE_OUTCOMES),
+  title: string2(),
+  hint: string2()
+});
+var planCreateResultSchema = planViewSchema.extend({
+  merged: array(planMergeSchema).default([]),
+  shaped: array(planShapingSchema).default([])
+});
+
+// ../../packages/schema/src/contracts/health-cycle.ts
+var HEALTH_CYCLE_FLOWS = ["none", "light", "medium", "heavy"];
+var healthCycleFlowSchema = _enum2(HEALTH_CYCLE_FLOWS);
+var HEALTH_CYCLE_SYMPTOMS = ["cramps", "headache", "tired", "low_mood", "skin"];
+var healthCycleSymptomSchema = _enum2(HEALTH_CYCLE_SYMPTOMS);
+var HEALTH_CYCLE_LENGTH_MIN = 15;
+var HEALTH_CYCLE_LENGTH_MAX = 60;
+var healthCycleSettingsSchema = object({
+  on: boolean2(),
+  usualLength: number2().int().nullable(),
+  shareNext: boolean2()
+});
+var healthCycleDaySchema = object({
+  day: civilDaySchema,
+  flow: healthCycleFlowSchema.nullable(),
+  symptoms: array(healthCycleSymptomSchema)
+});
+var healthCycleSummarySchema = object({
+  lastStart: civilDaySchema.nullable(),
+  day: number2().int().nullable(),
+  length: number2().int(),
+  lengthFrom: _enum2(["set", "cycles", "default"]),
+  periodDays: number2().int().nullable(),
+  nextOn: civilDaySchema.nullable(),
+  fertile: tuple([number2().int(), number2().int()]).nullable(),
+  lengths: array(object({ start: civilDaySchema, days: number2().int() })),
+  regular: string2().nullable()
+});
+var healthCycleViewSchema = object({
+  settings: healthCycleSettingsSchema,
+  days: array(healthCycleDaySchema),
+  summary: healthCycleSummarySchema.nullable()
+});
+var updateHealthCycleSettingsInputSchema = object({
+  on: boolean2().optional(),
+  usualLength: number2().int().min(HEALTH_CYCLE_LENGTH_MIN).max(HEALTH_CYCLE_LENGTH_MAX).nullable().optional(),
+  shareNext: boolean2().optional()
+}).strict().refine((v) => Object.keys(v).length > 0, { message: "set one setting at least" });
+var logHealthCycleDayInputSchema = object({
+  flow: healthCycleFlowSchema.nullable().optional(),
+  symptoms: array(healthCycleSymptomSchema).max(HEALTH_CYCLE_SYMPTOMS.length).refine((xs) => new Set(xs).size === xs.length, { message: "a symptom once" }).optional()
+}).strict().refine((v) => v.flow !== undefined || v.symptoms !== undefined, {
+  message: "give a flow or symptoms"
+});
+var healthCycleSharedSchema = array(object({
+  userId: string2(),
+  name: string2(),
+  nextOn: civilDaySchema
+}));
+
 // ../../packages/schema/src/contracts/health-export.ts
 var HEALTH_EXPORT_RESOURCE_TYPES = [
   "Patient",
@@ -31851,6 +32158,73 @@ var healthOperations = defineOperations({
     response: { description: "The profile." },
     errors: { 400: true, 403: "Health is off for the member, or the key acts for no member." }
   },
+  getCycle: {
+    method: "get",
+    path: "/health/cycle",
+    scopes: ["health:read"],
+    tag: "Health",
+    summary: "Get the member's cycle",
+    description: "Cycle, an optional part of Health each member turns on for themselves (off by default): `settings` (`on`, the `usualLength` they set or null, `shareNext`), the `days` logged in the last 400 days (oldest first: `day`, `flow` none/light/medium/heavy or null, `symptoms`) and the `summary` they make (the cycle's `day` today, `lastStart`, the usual `length` and where it comes from, `nextOn` and the `fertile` window as cycle days, both estimates, the last six `lengths`, and `regular`). While Cycle is off, `days` is empty and `summary` null.",
+    status: 200,
+    response: { description: "The member's cycle." },
+    errors: { 403: "The key acts for no member." }
+  },
+  updateCycleSettings: {
+    method: "patch",
+    path: "/health/cycle/settings",
+    scopes: ["health:write"],
+    tag: "Health",
+    summary: "Change the cycle settings",
+    description: "Set `usualLength` (15\u201360 days, or null to work it out from the cycles) and `shareNext` (share only the next period's date with the Space). Only the member turns Cycle `on` or off, in do; a key that tries is refused (403). Returns the cycle.",
+    body: updateHealthCycleSettingsInputSchema,
+    status: 200,
+    response: { description: "The member's cycle." },
+    errors: {
+      400: true,
+      403: "Health or Cycle is off, a key tried to turn Cycle on or off, or the key acts for no member."
+    }
+  },
+  logCycleDay: {
+    method: "put",
+    path: "/health/cycle/days/{day}",
+    scopes: ["health:write"],
+    tag: "Health",
+    summary: "Log a cycle day",
+    description: "Log the day (`YYYY-MM-DD`, today or before): the `flow` (none, light, medium, heavy, or null to clear it) and the `symptoms` (cramps, headache, tired, low_mood, skin). It replaces what the day had; an absent key keeps its part. Returns the cycle.",
+    body: logHealthCycleDayInputSchema,
+    status: 200,
+    response: { description: "The member's cycle." },
+    errors: {
+      400: true,
+      403: "Health or Cycle is off for the member, or the key acts for no member."
+    }
+  },
+  deleteCycleDay: {
+    method: "delete",
+    path: "/health/cycle/days/{day}",
+    scopes: ["health:write"],
+    tag: "Health",
+    summary: "Take back a cycle day",
+    description: "Nothing logged on the day any more. Returns the cycle.",
+    status: 200,
+    response: { description: "The member's cycle." },
+    errors: {
+      400: true,
+      403: "Health or Cycle is off for the member, or the key acts for no member.",
+      404: true
+    }
+  },
+  listSharedCycleDates: {
+    method: "get",
+    path: "/health/cycle/shared",
+    scopes: ["health:read"],
+    tag: "Health",
+    summary: "List the shared next period dates",
+    description: "The next period date each other member of the Space shares (`userId`, `name`, `nextOn`, an estimate), soonest first. Only the date: nothing they log is shared.",
+    status: 200,
+    response: { description: "The shared dates." },
+    errors: { 403: "The key acts for no member." }
+  },
   log: {
     method: "post",
     path: "/health/log",
@@ -37786,233 +38160,6 @@ var planningRuleOperations = defineOperations({
   })
 });
 
-// ../../packages/schema/src/contracts/plans.ts
-var PLAN_KINDS = ["week", "day"];
-var PLAN_ITEM_ACTIONS = ["plan", "someday", "let_go"];
-var PLAN_ITEM_STATES = ["proposed", "accepted", "dismissed"];
-var PLAN_STATUSES = ["open", "settled", "replaced"];
-var PLAN_DUPLICATE_MODES = ["merge", "reject"];
-var PLAN_MERGE_OUTCOMES = [
-  "scheduled_task",
-  "covered_by_item",
-  "already_planned"
-];
-var PLAN_MATCH_KINDS = ["task", "time_block", "event"];
-var PLAN_MAX_ITEMS = 60;
-var PLAN_MAX_BLOCKS = 140;
-var PLAN_REASON_MAX = 280;
-var PLAN_NOTE_MAX = 2000;
-var planKindSchema = _enum2(PLAN_KINDS);
-var planItemActionSchema = _enum2(PLAN_ITEM_ACTIONS);
-var planItemStateSchema = _enum2(PLAN_ITEM_STATES);
-var planStatusSchema = _enum2(PLAN_STATUSES);
-var civilDaySchema = string2().regex(/^\d{4}-\d{2}-\d{2}$/, "expected YYYY-MM-DD").refine((s) => new Date(`${s}T00:00:00Z`).toISOString().slice(0, 10) === s, "not a real day");
-var DAY_MS = 24 * 60 * 60 * 1000;
-function addCivilDays(day, n) {
-  return new Date(Date.parse(`${day}T00:00:00Z`) + n * DAY_MS).toISOString().slice(0, 10);
-}
-function planDays(kind, startsOn) {
-  return kind === "week" ? Array.from({ length: 7 }, (_, i) => addCivilDays(startsOn, i)) : [startsOn];
-}
-function isMonday(day) {
-  return new Date(`${day}T00:00:00Z`).getUTCDay() === 1;
-}
-var planItemInputSchema = object({
-  taskId: ulidSchema,
-  action: planItemActionSchema.default("plan"),
-  day: civilDaySchema.optional(),
-  at: exports_coerce.date().optional(),
-  durationMinutes: number2().int().min(5).max(24 * 60).optional(),
-  reason: string2().trim().min(1).max(PLAN_REASON_MAX).optional()
-}).strict().superRefine((v, ctx) => {
-  if (v.action === "plan") {
-    if (v.day === undefined === (v.at === undefined)) {
-      ctx.addIssue({
-        code: "custom",
-        message: "a `plan` item takes exactly one of `day` or `at`",
-        path: ["day"]
-      });
-    }
-    if (v.durationMinutes !== undefined && v.at === undefined) {
-      ctx.addIssue({
-        code: "custom",
-        message: "`durationMinutes` goes with `at` (a time)",
-        path: ["durationMinutes"]
-      });
-    }
-  } else if (v.day !== undefined || v.at !== undefined || v.durationMinutes !== undefined) {
-    ctx.addIssue({
-      code: "custom",
-      message: `a \`${v.action}\` item takes no day, time or duration`,
-      path: ["action"]
-    });
-  }
-});
-var planBlockInputSchema = object({
-  templateId: ulidSchema.optional(),
-  lifeKind: lifeBlockKindSchema,
-  title: string2().trim().min(1).max(500).optional(),
-  startAt: exports_coerce.date(),
-  endAt: exports_coerce.date(),
-  routineId: ulidSchema.optional(),
-  reason: string2().trim().min(1).max(PLAN_REASON_MAX).optional()
-}).strict().refine((v) => {
-  const minutes = (v.endAt.getTime() - v.startAt.getTime()) / 60000;
-  return minutes > 0 && minutes <= TIME_BLOCK_MAX_MINUTES;
-}, { message: "endAt must be after startAt and at most a day later", path: ["endAt"] });
-var createPlanInputSchema = object({
-  kind: planKindSchema,
-  startsOn: civilDaySchema,
-  forUserId: string2().min(1).optional(),
-  note: string2().trim().min(1).max(PLAN_NOTE_MAX).optional(),
-  items: array(planItemInputSchema).max(PLAN_MAX_ITEMS).default([]),
-  blocks: array(planBlockInputSchema).max(PLAN_MAX_BLOCKS).default([]),
-  onDuplicate: _enum2(PLAN_DUPLICATE_MODES).default("merge")
-}).strict().superRefine((v, ctx) => {
-  if (v.items.length + v.blocks.length === 0) {
-    ctx.addIssue({
-      code: "custom",
-      message: "a plan proposes at least one item or block",
-      path: ["items"]
-    });
-  }
-  if (v.kind === "week" && !isMonday(v.startsOn)) {
-    ctx.addIssue({
-      code: "custom",
-      message: "a week plan starts on a Monday",
-      path: ["startsOn"]
-    });
-  }
-  const days = new Set(planDays(v.kind, v.startsOn));
-  const seen = new Set;
-  v.items.forEach((item, i) => {
-    if (seen.has(item.taskId)) {
-      ctx.addIssue({
-        code: "custom",
-        message: "one item per task",
-        path: ["items", i, "taskId"]
-      });
-    }
-    seen.add(item.taskId);
-    if (item.day !== undefined && !days.has(item.day)) {
-      ctx.addIssue({
-        code: "custom",
-        message: `the day falls outside the ${v.kind}`,
-        path: ["items", i, "day"]
-      });
-    }
-  });
-});
-var planDecisionInputSchema = object({
-  itemIds: array(string2().min(1)).min(1).max(PLAN_MAX_ITEMS + PLAN_MAX_BLOCKS).optional()
-}).strict();
-var planAdjustInputSchema = object({
-  itemId: string2().min(1),
-  startAt: exports_coerce.date(),
-  endAt: exports_coerce.date()
-}).strict().refine((v) => {
-  const minutes = (v.endAt.getTime() - v.startAt.getTime()) / 60000;
-  return minutes >= 5 && minutes <= TIME_BLOCK_MAX_MINUTES;
-}, { message: "endAt must be 5 minutes to a day after startAt", path: ["endAt"] });
-var PLAN_TEMPLATES = ["normal", "light", "away"];
-var planTemplateSchema = _enum2(PLAN_TEMPLATES);
-var planDraftInputSchema = object({
-  startsOn: civilDaySchema.refine(isMonday, "a week starts on a Monday"),
-  template: planTemplateSchema.default("normal")
-}).strict();
-var planPlaceInputSchema = object({
-  taskId: ulidSchema,
-  startAt: exports_coerce.date(),
-  endAt: exports_coerce.date()
-}).strict().refine((v) => {
-  const minutes = (v.endAt.getTime() - v.startAt.getTime()) / 60000;
-  return minutes >= 5 && minutes <= TIME_BLOCK_MAX_MINUTES;
-}, { message: "endAt must be 5 minutes to a day after startAt", path: ["endAt"] });
-var planUnplaceInputSchema = object({ taskId: ulidSchema }).strict();
-var planListQuerySchema = object({
-  kind: planKindSchema.optional(),
-  status: planStatusSchema.optional(),
-  startsOn: civilDaySchema.optional(),
-  taskId: ulidSchema.optional()
-});
-var planTaskSchema = object({
-  id: ulidSchema,
-  title: string2(),
-  status: taskStatusSchema,
-  scheduledAt: exports_coerce.date().nullable(),
-  allDay: boolean2(),
-  dueAt: exports_coerce.date().nullable(),
-  durationMinutes: number2().int().nullable(),
-  areaId: string2().nullable(),
-  projectId: string2().nullable(),
-  moveCount: number2().int().nonnegative().default(0)
-});
-var planItemViewSchema = object({
-  id: string2(),
-  taskId: ulidSchema,
-  action: planItemActionSchema,
-  scheduledAt: exports_coerce.date().nullable(),
-  allDay: boolean2(),
-  durationMinutes: number2().int().nullable(),
-  reason: string2().nullable(),
-  state: planItemStateSchema,
-  decidedAt: exports_coerce.date().nullable(),
-  task: planTaskSchema
-});
-var planBlockViewSchema = object({
-  id: string2(),
-  templateId: string2().nullable(),
-  lifeKind: lifeBlockKindSchema,
-  title: string2(),
-  startAt: exports_coerce.date(),
-  endAt: exports_coerce.date(),
-  routineId: string2().nullable(),
-  reason: string2().nullable(),
-  state: planItemStateSchema,
-  decidedAt: exports_coerce.date().nullable(),
-  blockId: string2().nullable()
-});
-var planViewSchema = object({
-  id: string2(),
-  kind: planKindSchema,
-  startsOn: civilDaySchema,
-  userId: string2(),
-  agentId: string2().nullable(),
-  note: string2().nullable(),
-  template: planTemplateSchema.nullable().default(null),
-  status: planStatusSchema,
-  createdAt: exports_coerce.date(),
-  updatedAt: exports_coerce.date(),
-  items: array(planItemViewSchema),
-  blocks: array(planBlockViewSchema).default([])
-});
-var planMergeSchema = object({
-  blockIndex: number2().int().min(0),
-  title: string2(),
-  outcome: _enum2(PLAN_MERGE_OUTCOMES),
-  match: object({ kind: _enum2(PLAN_MATCH_KINDS), id: string2(), title: string2() }),
-  hint: string2()
-});
-var PLAN_RULE_OUTCOMES = [
-  "anchored",
-  "added",
-  "kept_free",
-  "over_limit",
-  "below_min",
-  "not_theirs"
-];
-var planShapingSchema = object({
-  ruleId: string2(),
-  sentence: string2(),
-  outcome: _enum2(PLAN_RULE_OUTCOMES),
-  title: string2(),
-  hint: string2()
-});
-var planCreateResultSchema = planViewSchema.extend({
-  merged: array(planMergeSchema).default([]),
-  shaped: array(planShapingSchema).default([])
-});
-
 // ../../packages/schema/src/operations/plans.ts
 function decision(path, verb, what) {
   return {
@@ -51502,6 +51649,74 @@ var HEALTH_COMMAND_SPECS = [
     scopes: WRITE6,
     returns: "HealthLabAnalyteView",
     notes: "Body: SetHealthLabAnalyteInput. An absent key keeps a field; null clears it."
+  },
+  {
+    path: ["health", "cycle"],
+    summary: "Show your cycle: the settings, the days logged and what they say.",
+    args: [],
+    flags: [],
+    scopes: READ6,
+    returns: "HealthCycleView",
+    notes: `${routeOf(healthOperations.getCycle)}. Off until you turn it on in do: then \`days\` is empty and \`summary\` null. \`summary.nextOn\` and \`fertile\` are estimates from the usual length.`
+  },
+  {
+    path: ["health", "cycle", "log"],
+    summary: "Log a cycle day (do health cycle log 2026-10-22 --flow light --symptoms cramps,tired).",
+    args: [{ name: "day", required: true, description: "The day, YYYY-MM-DD: today or before." }],
+    flags: [
+      DATA_FLAG,
+      {
+        name: "flow",
+        type: "string",
+        description: 'none|light|medium|heavy; "" clears it.'
+      },
+      {
+        name: "symptoms",
+        type: "string",
+        description: 'cramps,headache,tired,low_mood,skin, comma-separated; "" clears them.'
+      }
+    ],
+    scopes: WRITE6,
+    returns: "HealthCycleView",
+    notes: `${routeOf(healthOperations.logCycleDay)}. Body: LogHealthCycleDayInput. It replaces what the day had; a part not given stays.`
+  },
+  {
+    path: ["health", "cycle", "unlog"],
+    summary: "Take back a cycle day: nothing logged on it.",
+    args: [{ name: "day", required: true, description: "The day, YYYY-MM-DD." }],
+    flags: [],
+    scopes: WRITE6,
+    returns: "HealthCycleView"
+  },
+  {
+    path: ["health", "cycle", "set"],
+    summary: "Set your usual cycle length or share the next date (--length 30, --share on).",
+    args: [],
+    flags: [
+      DATA_FLAG,
+      {
+        name: "length",
+        type: "string",
+        description: "Your usual length, 15\u201360 days; auto works it out from your cycles."
+      },
+      {
+        name: "share",
+        type: "string",
+        description: "on|off: share only the next period's date with the Space."
+      }
+    ],
+    scopes: WRITE6,
+    returns: "HealthCycleView",
+    notes: `${routeOf(healthOperations.updateCycleSettings)}. Body: UpdateHealthCycleSettingsInput. Turning Cycle on or off is yours alone, in do: a key that tries gets 403.`
+  },
+  {
+    path: ["health", "cycle", "shared"],
+    summary: "List the next period dates the Space's other members share with it.",
+    args: [],
+    flags: [],
+    scopes: READ6,
+    returns: "HealthCycleShared",
+    notes: "Only the date each one shares (an estimate); nothing they log."
   }
 ];
 var HEALTH_RECORD_OPERATIONS = {
@@ -51722,6 +51937,51 @@ var commands23 = pairCommands(HEALTH_COMMAND_SPECS, {
     data: await requireClient().post(pathOf(googleHealthOperations.sync), {}),
     render: renderRecord
   }),
+  "health cycle": async ({ requireClient }) => ({
+    data: await requireClient().get(pathOf(healthOperations.getCycle)),
+    render: renderRecord
+  }),
+  "health cycle log": async ({ args, flags, requireClient }) => {
+    const day = requireArg(args, 0, "day");
+    const fields = flagString(flags, "data") ? readDataFlag(flags) : {};
+    const flow = flagString(flags, "flow");
+    if (flow !== undefined)
+      fields.flow = flow.trim() ? flow.trim() : null;
+    const symptoms = flagString(flags, "symptoms");
+    if (symptoms !== undefined) {
+      fields.symptoms = symptoms.split(",").map((s) => s.trim()).filter(Boolean);
+    }
+    const body = parseInput(logHealthCycleDayInputSchema, fields);
+    return {
+      data: await requireClient().put(pathOf(healthOperations.logCycleDay, { day }), body),
+      render: renderRecord
+    };
+  },
+  "health cycle unlog": async ({ args, requireClient }) => ({
+    data: await requireClient().delete(pathOf(healthOperations.deleteCycleDay, { day: requireArg(args, 0, "day") })),
+    render: renderRecord
+  }),
+  "health cycle set": async ({ flags, requireClient }) => {
+    const fields = flagString(flags, "data") ? readDataFlag(flags) : {};
+    const length = flagString(flags, "length");
+    if (length !== undefined)
+      fields.usualLength = length === "auto" ? null : Number(length);
+    const share = flagString(flags, "share");
+    if (share !== undefined) {
+      if (share !== "on" && share !== "off")
+        throw usageError("--share is on or off");
+      fields.shareNext = share === "on";
+    }
+    const body = parseInput(updateHealthCycleSettingsInputSchema, fields);
+    return {
+      data: await requireClient().patch(pathOf(healthOperations.updateCycleSettings), body),
+      render: renderRecord
+    };
+  },
+  "health cycle shared": async ({ requireClient }) => ({
+    data: await requireClient().getPage(pathOf(healthOperations.listSharedCycleDates)),
+    render: renderList
+  }),
   "health consent": async ({ requireClient }) => ({
     data: await requireClient().get(pathOf(healthOperations.getConsent)),
     render: renderRecord

package/package.json

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