Merge remote-tracking branch 'origin/main' into feat/sentiment-trend

# Conflicts:
#	docs/index.html

Author: calvarezg

CHANGELOG.md

@@ -1,3 +1,66 @@
+# [1.656.0](https://github.com/adobe/spacecat-api-service/compare/v1.655.2...v1.656.0) (2026-07-16)
+
+
+### Features
+
+* **serenity:** edit prompts in place — id-stable rename and tag update with 409 conflict mapping ([#2833](https://github.com/adobe/spacecat-api-service/issues/2833)) ([5f7a1bf](https://github.com/adobe/spacecat-api-service/commit/5f7a1bf088a57945cd8656436c44dfbad8c9296d)), closes [Hi#level](https://github.com/Hi/issues/level)
+
+## [1.655.2](https://github.com/adobe/spacecat-api-service/compare/v1.655.1...v1.655.2) (2026-07-16)
+
+
+### Bug Fixes
+
+* **edge-optimize:** derive CloudFront connector externalId from org (server-side), drop client-supplied model ([#2804](https://github.com/adobe/spacecat-api-service/issues/2804)) ([cd77f7a](https://github.com/adobe/spacecat-api-service/commit/cd77f7a5b540b3f5c46bb950c4b1fd6ddf92ccf7))
+
+## [1.655.1](https://github.com/adobe/spacecat-api-service/compare/v1.655.0...v1.655.1) (2026-07-16)
+
+
+### Bug Fixes
+
+* **llmo-akamai:** apply Optimize-at-Edge rules via JSON Patch, not full-tree PUT ([#2820](https://github.com/adobe/spacecat-api-service/issues/2820)) ([e88e7a9](https://github.com/adobe/spacecat-api-service/commit/e88e7a92744cf59ce44a283454f682c85cfe792e)), closes [adobe/spacecat-shared#1813](https://github.com/adobe/spacecat-shared/issues/1813) [#2407](https://github.com/adobe/spacecat-api-service/issues/2407)
+
+# [1.655.0](https://github.com/adobe/spacecat-api-service/compare/v1.654.4...v1.655.0) (2026-07-16)
+
+
+### Features
+
+* **aso-overlay:** CloudWatch EMF instrumentation for READ path (SITES-48140) ([#2822](https://github.com/adobe/spacecat-api-service/issues/2822)) ([4606c73](https://github.com/adobe/spacecat-api-service/commit/4606c7395aab9bd214ee5a506e0df770fb3ccd7b)), closes [adobe/spacecat-infrastructure#675](https://github.com/adobe/spacecat-infrastructure/issues/675)
+
+## [1.654.4](https://github.com/adobe/spacecat-api-service/compare/v1.654.3...v1.654.4) (2026-07-16)
+
+
+### Bug Fixes
+
+* **serenity:** enable bounded-backoff retry on the Semrush REST transport ([#2766](https://github.com/adobe/spacecat-api-service/issues/2766)) ([c923da3](https://github.com/adobe/spacecat-api-service/commit/c923da369ff554f4469056082d026cb8c35231a2))
+
+## [1.654.3](https://github.com/adobe/spacecat-api-service/compare/v1.654.2...v1.654.3) (2026-07-15)
+
+
+### Bug Fixes
+
+* **aso-overlay:** add Surrogate-Key header for Fastly targeted purge (SITES-48140) ([#2826](https://github.com/adobe/spacecat-api-service/issues/2826)) ([9c1fa79](https://github.com/adobe/spacecat-api-service/commit/9c1fa79f9f03920007a8c24a08c42e25db6f5284)), closes [experience-platform/mystique#3381](https://github.com/experience-platform/mystique/issues/3381) [experience-platform/mystique-deploy#568](https://github.com/experience-platform/mystique-deploy/issues/568) [mystique#3381](https://github.com/mystique/issues/3381) [mystique#3381](https://github.com/mystique/issues/3381) [adobe/spacecat-api-service#2822](https://github.com/adobe/spacecat-api-service/issues/2822)
+
+## [1.654.2](https://github.com/adobe/spacecat-api-service/compare/v1.654.1...v1.654.2) (2026-07-15)
+
+
+### Bug Fixes
+
+* domain/segement wide deployment support in IVE ([#2800](https://github.com/adobe/spacecat-api-service/issues/2800)) ([344c45c](https://github.com/adobe/spacecat-api-service/commit/344c45c0a88eae9cef72e52649cb4f5a1ec82a72))
+
+## [1.654.1](https://github.com/adobe/spacecat-api-service/compare/v1.654.0...v1.654.1) (2026-07-15)
+
+
+### Bug Fixes
+
+* **preflight:** thread ims_org_id to mysticat analyze; fail-closed when missing (SITES-48037) ([#2818](https://github.com/adobe/spacecat-api-service/issues/2818)) ([123db03](https://github.com/adobe/spacecat-api-service/commit/123db03dc71a7d64b27a96bfe88cb010fc2b8c43)), closes [let-it-throu#and-fail-late](https://github.com/let-it-throu/issues/and-fail-late) [#3408](https://github.com/adobe/spacecat-api-service/issues/3408)
+
+# [1.654.0](https://github.com/adobe/spacecat-api-service/compare/v1.653.0...v1.654.0) (2026-07-15)
+
+
+### Features
+
+* capture guidance_markdown + feedback_subject_id on backoffice reviews ([#2798](https://github.com/adobe/spacecat-api-service/issues/2798)) ([1435d52](https://github.com/adobe/spacecat-api-service/commit/1435d52111e8ee2748488dcc8c918717f64e7cdd)), closes [#790](https://github.com/adobe/spacecat-api-service/issues/790)
+
 # [1.653.0](https://github.com/adobe/spacecat-api-service/compare/v1.652.1...v1.653.0) (2026-07-15)
 
 

docs/index.html

@@ -6141,6 +6141,23 @@ site-llmo-akamai-plan:
                   items:
                     type: string
                   description: Top-level rule names after the merge.
+                validated:
+                  type: boolean
+                  description: >-
+                    Whether the dry-run PAPI validation ran. When false, it could not be performed
+                    and errors/warnings fall back to the base version's own warnings.
+                errors:
+                  type: array
+                  items:
+                    type: object
+                    additionalProperties: true
+                  description: PAPI validation errors for the change deploy would make (empty if none).
+                warnings:
+                  type: array
+                  items:
+                    type: object
+                    additionalProperties: true
+                  description: PAPI validation warnings for the change deploy would make.
                 merged:
                   type: object
                   additionalProperties: true

docs/openapi/llmo-api.yaml

@@ -10976,7 +10976,7 @@ SerenityPrompt:
   properties:
     semrushPromptId:
       type: string
-      description: Upstream prompt id. Changes whenever the prompt is re-created (e.g. on PATCH).
+      description: Upstream prompt id. Stable across edits — PATCH updates the prompt in place and echoes the same id.
     geoTargetId:
       type: integer
       minimum: 1
@@ -11133,13 +11133,13 @@ SerenityCreatePromptsResponse:
 SerenityUpdatePromptRequest:
   type: object
   description: |
-    Replace the prompt's text and tags. Carries the owning slice in
+    Edit the prompt's text and tags in place. Carries the owning slice in
     `geoTargetId` + `languageCode` so the server can resolve the upstream
     project without scanning. `geoTargetId`, `languageCode`, and `text` are
-    always required — the upstream provider's API has no in-place update or
-    GET-by-id, so the server runs DELETE-old + POST-new and treats the body
-    as the full next state. `tagIds` (non-empty) is required; tags are addressed
-    by upstream id and never by name, so a `tags` key is rejected with 400.
+    always required — the upstream provider's API has no GET-by-id, so the
+    body is treated as the full next state. `tagIds` (non-empty) is required;
+    tags are addressed by upstream id and never by name, so a `tags` key is
+    rejected with 400.
   required: [geoTargetId, languageCode, text, tagIds]
   properties:
     geoTargetId:
@@ -11153,7 +11153,7 @@ SerenityUpdatePromptRequest:
       type: array
       items: { type: string }
       minItems: 1
-      description: Upstream tag ids to attach to the replacement prompt.
+      description: Upstream tag ids the prompt carries after the edit (full replacement set).
 
 SerenityBulkDeletePromptsRequest:
   type: object

docs/openapi/schemas.yaml

@@ -154,21 +154,22 @@ v2-serenity-prompt-by-id:
     tags: [serenity]
     summary: Update a Serenity prompt
     description: |
-      Body carries `{geoTargetId, languageCode, text}` plus exactly one of
-      `tags` (names) or `tagIds` (upstream ids, the id-based write path —
-      serenity-docs#24). `geoTargetId`/`languageCode`/`text` are always
-      required — the upstream provider has no in-place update (and no
-      GET-by-id), so the implementation is DELETE-old + POST-new + publish
-      and the payload is treated as the full next state. Clients always
-      have the current text/tags(-ids) available locally (from the list
-      call that rendered the edit form), which keeps this endpoint a
-      single straight line and avoids the per-request pagination
-      "preserve-on-omit" semantics would force.
+      Body carries `{geoTargetId, languageCode, text, tagIds}` — all
+      required; tags are addressed by upstream id, never by name
+      (serenity-docs#24), and the payload is treated as the full next
+      state. Clients always have the current text/tagIds available
+      locally (from the list call that rendered the edit form), which
+      keeps this endpoint a single straight line and avoids the
+      per-request pagination "preserve-on-omit" semantics would force.
 
-      An explicit empty `tags: []` clears tags (not applicable to
-      `tagIds`, which must be non-empty when present). The response
-      carries the new `semrushPromptId` (the value changes on every
-      upstream re-create).
+      The edit is applied IN PLACE upstream (serenity-docs#63): the text
+      and the tag set are written without deleting the prompt, so the
+      response echoes the UNCHANGED `semrushPromptId` and anything keyed
+      to that id survives the edit. A `text` that exactly matches a
+      DIFFERENT prompt's text in the same slice is refused with 409
+      `conflict`, with nothing changed upstream. The edit lands in the
+      upstream draft layer and is published as part of the request (same
+      publish contract as create).
     operationId: updateSerenityPrompt
     security:
       - ims_key: []
@@ -186,6 +187,11 @@ v2-serenity-prompt-by-id:
       '400': { $ref: './responses.yaml#/400' }
       '404':
         description: Organization, brand, slice, or prompt not found, or serenity is not active for the organization.
+      '409':
+        description: The new text exactly matches a different prompt's text in this slice; nothing was changed upstream.
+        content:
+          application/json:
+            schema: { $ref: './schemas.yaml#/SerenityErrorResponse' }
       '502':
         description: Upstream returned a non-2xx response.
         content: