@adobe/spacecat-shared-data-access 4.22.1 → 4.24.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [@adobe/spacecat-shared-data-access-v4.24.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v4.23.0...@adobe/spacecat-shared-data-access-v4.24.0) (2026-09-02)
+
+### Features
+
+* **data-access:** add GeoExperiment.allStuckImpactMeasurementChecks query ([#1905](https://github.com/adobe/spacecat-shared/issues/1905)) ([db0596b](https://github.com/adobe/spacecat-shared/commit/db0596b20807ae1ae6e5a9388eb68a62d8ab280b))
+
+## [@adobe/spacecat-shared-data-access-v4.23.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v4.22.1...@adobe/spacecat-shared-data-access-v4.23.0) (2026-08-28)
+
+### Features
+
+* **data-access:** add suggestionKey attribute to Suggestion schema ([#1899](https://github.com/adobe/spacecat-shared/issues/1899)) ([0d6ecc3](https://github.com/adobe/spacecat-shared/commit/0d6ecc3f46984140d13bd84614e362d289106a39))
+
 ## [@adobe/spacecat-shared-data-access-v4.22.1](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v4.22.0...@adobe/spacecat-shared-data-access-v4.22.1) (2026-08-19)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-data-access",
-  "version": "4.22.1",
+  "version": "4.24.0",
   "description": "Shared modules of the Spacecat Services - Data Access",
   "type": "module",
   "engines": {

package/src/models/geo-experiment/geo-experiment.collection.js

@@ -60,6 +60,32 @@ class GeoExperimentCollection extends BaseCollection {
       },
     );
   }
+
+  /**
+   * Gets all geo experiments left at status COMPLETED / phase IMPACT_MEASUREMENT_STARTED — a
+   * combination that only arises when a manual impact-measurement re-trigger leaves the
+   * experiment COMPLETED (so it stays outside allActive()) but nobody has followed up with a
+   * check of the re-submitted Mystique task. Used by the experimentation engine's bounded
+   * stuck-check sweep to find and resolve abandoned re-triggers (see
+   * llmo-experimentation-engine/docs/decisions/007-manual-impact-measurement-check-completed-
+   * status.md). Same cost/indexing characteristic as allActive() above — a filtered query over
+   * all GeoExperiment records, not a dedicated secondary index.
+   *
+   * @param {object} [options={}] - Query options (limit, cursor, order).
+   * @returns {Promise<GeoExperiment[]>} Array of stuck experiments.
+   */
+  async allStuckImpactMeasurementChecks(options = {}) {
+    return this.all(
+      {},
+      {
+        ...options,
+        where: (attrs, op) => op.and(
+          op.eq(attrs.status, GeoExperiment.STATUSES.COMPLETED),
+          op.eq(attrs.phase, GeoExperiment.PHASES.IMPACT_MEASUREMENT_STARTED),
+        ),
+      },
+    );
+  }
 }
 
 export default GeoExperimentCollection;

package/src/models/suggestion/suggestion.schema.js

@@ -50,6 +50,11 @@ const schema = new SchemaBuilder(Suggestion, SuggestionCollection)
   .addAttribute('skipDetail', {
     type: 'string',
     validate: (value) => !value || (isString(value) && value.length <= 500),
+  })
+  .addAttribute('suggestionKey', {
+    type: 'string',
+    readOnly: true,
+    validate: (value) => !value || isString(value),
   });
 
 export default schema.build();