Merge branch 'feat/medication-record-only' into release/v1.39.1

src/lib/openapi/routes/medications/schemas.ts

@@ -222,9 +222,24 @@ export const medicationResource = z
       .describe(
         "v1.16.11 as-needed (PRN) flag. When true the medication carries ZERO schedules (the write routes 422 on any schedule entry alongside the flag): it is never due (`nextDueAt` stays null), never reminded, and excluded from every compliance rate/streak — but intakes still log as ad-hoc rows, inventory still consumes per `unitsPerDose`, and the history renders. Stays active indefinitely. Mutually exclusive with `oneShot`.",
       ),
+    trackIntake: z
+      .boolean()
+      .describe(
+        "v1.39.1 — intake tracking. True (the default) for every medication that existed before the field. When false the medication is kept as a record: nothing is ever due (`nextDueAt` stays null), nothing reminds on any channel, and it is excluded from every adherence figure. Its stored schedule then travels in `recordedSchedules` while `schedules` is served empty, so a client that arms reminders from `schedules` stays silent without an update.",
+      ),
     createdAt: z.iso.datetime({ offset: true }),
     updatedAt: z.iso.datetime({ offset: true }),
-    schedules: z.array(medicationScheduleResource),
+    schedules: z
+      .array(medicationScheduleResource)
+      .describe(
+        "The schedules in force. Empty for an as-needed medication and (v1.39.1) for a medication with `trackIntake: false`, whose stored schedule is in `recordedSchedules`.",
+      ),
+    recordedSchedules: z
+      .array(medicationScheduleResource)
+      .optional()
+      .describe(
+        "v1.39.1 — present only when `trackIntake` is false: the stored schedule, kept as information. Nothing derives a due dose or a reminder from it. Absent on a tracked medication, whose schedule is `schedules`.",
+      ),
   })
   .meta({
     id: "Medication",
@@ -761,10 +776,10 @@ export const medicationComplianceResponse = z
         "Whether a local adherence percentage applies to this medication.",
       ),
     notApplicableReason: z
-      .literal("NO_LOCAL_SCHEDULE")
+      .enum(["NO_LOCAL_SCHEDULE", "INTAKE_NOT_TRACKED"])
       .nullable()
       .describe(
-        "Reason adherence is not applicable. NO_LOCAL_SCHEDULE means the medication has no HealthLog-owned expected-dose grid.",
+        "Reason adherence is not applicable. NO_LOCAL_SCHEDULE means the medication has no HealthLog-owned expected-dose grid. INTAKE_NOT_TRACKED (v1.39.1) means the medication's intake tracking is switched off (`trackIntake: false`): its schedule is kept as information and nothing is expected from it.",
       ),
     compliance7: complianceResult.describe(
       "Seven-day adherence summary. When applicable is false, this remains a non-null all-zero compatibility placeholder for released clients and must not be rendered as a percentage.",
@@ -797,7 +812,9 @@ export const medicationComplianceSummaryEntry = z
       .describe(
         "Whether this medication has a local expected-dose grid and therefore a displayable adherence percentage.",
       ),
-    notApplicableReason: z.literal("NO_LOCAL_SCHEDULE").nullable(),
+    notApplicableReason: z
+      .enum(["NO_LOCAL_SCHEDULE", "INTAKE_NOT_TRACKED"])
+      .nullable(),
     compliance7: complianceResult.describe(
       "Seven-day adherence summary, or an all-zero compatibility placeholder when applicable is false.",
     ),