Merge remote-tracking branch 'origin/release/v1.46.0' into fix/review-meds-docs

# Conflicts:
#	src/__tests__/baselines/source-function-lines.json
#	src/__tests__/baselines/version-stamp-comments.json
#	src/__tests__/sharing-surface-guard.test.ts
This commit is contained in:
Marc-André Bombeck committed 2026-10-25 02:45:23 +01:00
commit d6c2760415
134 files changed
+3631 -1173

No files matched your search

+55 -89
View File
@@ -15429,45 +15429,6 @@ paths:
"403": *a9
"422": *a4
"429": *a5
/api/settings/preview-features:
get:
tags:
- Meta
summary: Get the preview-feature opt-ins
description: Every flag, off unless the caller switched it on.
responses:
"200":
description: The opt-ins.
content:
application/json:
schema:
$ref: "#/components/schemas/PreviewFeaturesEnvelope"
"401": *a1
"403": *a9
"422": *a4
"429": *a5
patch:
tags:
- Meta
summary: Switch preview features on or off
description: Sets the flags the body names and keeps the rest. An unknown flag or an empty body is refused with 422.
requestBody:
required: true
content:
application/json:
schema:
$ref: "#/components/schemas/PreviewFeaturesPatchBody"
responses:
"200":
description: The opt-ins as stored.
content:
application/json:
schema:
$ref: "#/components/schemas/PreviewFeaturesSavedEnvelope"
"401": *a1
"403": *a9
"422": *a4
"429": *a5
/api/settings/privacy-summary:
get:
tags:
@@ -27216,6 +27177,61 @@ paths:
application/json:
schema:
$ref: "#/components/schemas/ErrorEnvelope"
/api/settings/preview-features:
get:
security: []
deprecated: true
tags:
- Retired
summary: GET /api/settings/preview-features — removed in v1.46.0
description: >-
Removed in v1.46.0. Every request to this path answers 410 Gone, whatever the method and whatever credential it
carries. There is no replacement; the capability is gone rather than moved.
Stored per-account opt-ins to preview features, of which there was one, the topic overview pages. Those pages
were dropped before they shipped, so the switch governed nothing; the route and its column are gone, and no
preview is gated per account.
Retiring a path is deliberate, so the answer says so rather than leaving a client to read a 404 as a broken
deployment and retry forever. Treat 410 as terminal: drop the call, degrade the surface that depended on it, and
do not offer a retry.
responses:
"410":
description: The path was removed in v1.46.0 and will not answer again. `meta.errorCode` = `route.retired`,
`meta.removedIn` carries the version, and `meta.replacedBy` carries the replacement path or null.
content:
application/json:
schema:
$ref: "#/components/schemas/ErrorEnvelope"
patch:
security: []
deprecated: true
tags:
- Retired
summary: PATCH /api/settings/preview-features — removed in v1.46.0
description: >-
Removed in v1.46.0. Every request to this path answers 410 Gone, whatever the method and whatever credential it
carries. There is no replacement; the capability is gone rather than moved.
Stored per-account opt-ins to preview features, of which there was one, the topic overview pages. Those pages
were dropped before they shipped, so the switch governed nothing; the route and its column are gone, and no
preview is gated per account.
Retiring a path is deliberate, so the answer says so rather than leaving a client to read a 404 as a broken
deployment and retry forever. Treat 410 as terminal: drop the call, degrade the surface that depended on it, and
do not offer a retry.
responses:
"410":
description: The path was removed in v1.46.0 and will not answer again. `meta.errorCode` = `route.retired`,
`meta.removedIn` carries the version, and `meta.replacedBy` carries the replacement path or null.
content:
application/json:
schema:
$ref: "#/components/schemas/ErrorEnvelope"
components:
schemas:
CreateCycleCustomSymptomRequest:
@@ -33268,12 +33284,6 @@ components:
- version
- list
additionalProperties: false
PreviewFeaturesPatchBody:
type: object
properties:
topics:
type: boolean
additionalProperties: false
ConsentPostBody:
type: object
properties:
@@ -73603,50 +73613,6 @@ components:
- data
- error
additionalProperties: false
PreviewFeaturesEnvelope:
type: object
properties:
data:
$ref: "#/components/schemas/PreviewFeatures"
error:
type: "null"
meta:
type: object
properties:
requestId:
type: string
additionalProperties: false
required:
- data
- error
additionalProperties: false
PreviewFeatures:
type: object
properties:
topics:
type: boolean
description: Topic overview pages above the single-metric Insights pages. Off by default.
required:
- topics
additionalProperties: false
description: Per-user opt-in to preview features, one boolean per flag, every flag off by default.
PreviewFeaturesSavedEnvelope:
type: object
properties:
data:
$ref: "#/components/schemas/PreviewFeatures"
error:
type: "null"
meta:
type: object
properties:
requestId:
type: string
additionalProperties: false
required:
- data
- error
additionalProperties: false
PrivacySummaryEnvelope:
type: object
properties:
+15
View File
@@ -251,6 +251,21 @@ Pass `--only=prod` / `--only=demo` to check a single target, or
`--attempts=N --interval=ms` to widen the retry window while a slow
pull settles.
The worker loads each job's handler module on that job's first run, so a
module the image cannot load does not stop the worker from starting. Once
it has bound its queues, the worker loads every handler a single time in
the background and reports each one that fails, normally within a minute
of start. Each failure is a `job.run.failed` event at `error` with
`reason: "handler_load_failed"` and the queue's name, and stderr also gets
`[pg-boss] [registry] preloaded N/M job handlers; failed to load: <queues>`.
If either shows up after a deploy, the image is broken for those queues,
and their jobs will fail when they run. Roll back (see Rollback above)
instead of waiting for the retries to run out:
```sh
docker compose logs --since 5m app 2>&1 | grep -E 'handler_load_failed|failed to load:'
```
## Walk the synthetic journey
The version check proves the instance serves the right build. It does not