chore(release): v1.34.0 — a failure looks like a failure, a number is yours or it says so

docs/api/openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: HealthLog API
-  version: 1.33.2
+  version: 1.34.0
   description: >-
     Self-hosted personal-health-tracking PWA — public API surface for the iOS native client and external ingest.
 
@@ -7578,6 +7578,7 @@ paths:
               - STAIR_DESCENT_SPEED_BASELINE
               - SIX_MINUTE_WALK_BAND
               - TRAJECTORY
+              - HEALTH_SCORE
               - SAME_TIME_BASELINE
             description: "Derived-metric id to compute (e.g. VITALS_BASELINE, FITNESS_AGE, VASCULAR_AGE_DELTA, HRV_BALANCE, BMI,
               READINESS). Closed enum: an unknown id 422s. Metrics whose compute has not yet landed return an
@@ -27073,8 +27074,8 @@ components:
               properties:
                 score:
                   type: integer
-                  minimum: -9007199254740991
-                  maximum: 9007199254740991
+                  minimum: 0
+                  maximum: 100
                 band:
                   type: string
                   enum:
@@ -27085,15 +27086,78 @@ components:
                   anyOf:
                     - type: number
                     - type: "null"
+                confidence:
+                  $ref: "#/components/schemas/DerivedConfidence"
+                composition:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - BLOOD_PRESSURE
+                      - GLYCAEMIA
+                      - ACTIVITY
+                      - SLEEP
+                      - ADIPOSITY
+                      - WELLBEING
+                      - FITNESS
+                      - LIPIDS
+                deltaReason:
+                  anyOf:
+                    - type: string
+                      enum:
+                        - algorithm_changed
+                        - composition_changed
+                        - first_eligibility_window
+                        - below_noise_floor
+                        - no_previous_window
+                        - no_current_score
+                    - type: "null"
+                scoreVersion:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                bandSetter:
+                  anyOf:
+                    - type: string
+                      enum:
+                        - BLOOD_PRESSURE
+                        - GLYCAEMIA
+                        - ACTIVITY
+                        - SLEEP
+                        - ADIPOSITY
+                        - WELLBEING
+                        - FITNESS
+                        - LIPIDS
+                    - type: "null"
+                restMode:
+                  anyOf:
+                    - type: object
+                      properties:
+                        active:
+                          type: boolean
+                        since:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        episodeCount:
+                          type: integer
+                          minimum: -9007199254740991
+                          maximum: 9007199254740991
+                      required:
+                        - active
+                        - since
+                        - episodeCount
+                      additionalProperties: false
+                    - type: "null"
               required:
                 - score
                 - band
                 - delta
               additionalProperties: false
             - type: "null"
-          description: Personal health score summary (0..100 score, traffic-light band, week-over-week delta). Null on a
-            rollup-coverage miss (it rides the thick phase alongside `extras`) and when no pillar is computable.
-            Component breakdown is deliberately not serialised here.
+          description: Derived cardiometabolic reference score summary. Null until at least three eligible domains include a
+            measured physiological domain. Additive metadata names confidence, ordered composition, the worst-pillar
+            band setter, score version, and why a delta was suppressed. Rest Mode annotates but never changes the score.
         scoreRings:
           description: "User-selected hero score rings (max 3, `selectedScoreRings` on the dashboard layout), resolved
             server-side: READINESS / RECOVERY_SCORE / SLEEP_SCORE via the derived engines (module-gated like
@@ -27327,6 +27391,24 @@ components:
         ≥36% instability flag; `advanced` is the disclosure tier — J-index (Wojcicki 1995) + LBGI/HBGI (Kovatchev
         hypo/hyper risk). All blocks are null when there are no readings; `advanced.jIndex` is null for a single-reading
         window.
+    DerivedConfidence:
+      type: object
+      properties:
+        score:
+          type: number
+          description: 0..100 confidence; feeds the shared coverage meter unchanged.
+        band:
+          type: string
+          enum:
+            - high
+            - medium
+            - low
+            - draft
+          description: Confidence band the meter renders.
+      required:
+        - score
+        - band
+      additionalProperties: false
     InsightsComprehensiveResponseEnvelope:
       type: object
       properties:
@@ -27987,6 +28069,7 @@ components:
             - STAIR_DESCENT_SPEED_BASELINE
             - SIX_MINUTE_WALK_BAND
             - TRAJECTORY
+            - HEALTH_SCORE
             - SAME_TIME_BASELINE
           description: Echoes the requested derived-metric id (tags the union).
         status:
@@ -28070,24 +28153,6 @@ components:
         - historyDays
         - missing
       additionalProperties: false
-    DerivedConfidence:
-      type: object
-      properties:
-        score:
-          type: number
-          description: 0..100 confidence; feeds the shared coverage meter unchanged.
-        band:
-          type: string
-          enum:
-            - high
-            - medium
-            - low
-            - draft
-          description: Confidence band the meter renders.
-      required:
-        - score
-        - band
-      additionalProperties: false
     DerivedProvenance:
       type: object
       properties: