@salesforce/lds-adapters-analytics-wave 1.463.0 → 1.465.0

package/dist/es/es2018/analytics-wave.js

@@ -23190,7 +23190,7 @@ const getAnalyticsLimitsAdapterFactory = (luvio) => function WAVE__getAnalyticsL
 };
 
 const TTL$i = 300;
-const VERSION$M = "5d9aba0ee3f2f80287493bdc7dd1fa9a";
+const VERSION$M = "c0feda50a4a8fc2e5637843b6c1b8eed";
 function validate$12(obj, path = 'PlatformAuditCheckRepresentation') {
     const v_error = (() => {
         if (typeof obj !== 'object' || ArrayIsArray(obj) || obj === null) {
@@ -23257,8 +23257,62 @@ function validate$12(obj, path = 'PlatformAuditCheckRepresentation') {
                 return new TypeError(message);
             }
         }
-        obj.coverageScanned;
-        obj.coverageTotal;
+        if (obj.coverageScanned !== undefined) {
+            const obj_coverageScanned = obj.coverageScanned;
+            const path_coverageScanned = path + '.coverageScanned';
+            let obj_coverageScanned_union0 = null;
+            const obj_coverageScanned_union0_error = (() => {
+                if (typeof obj_coverageScanned !== 'number') {
+                    return new TypeError('Expected "number" but received "' + typeof obj_coverageScanned + '" (at "' + path_coverageScanned + '")');
+                }
+            })();
+            if (obj_coverageScanned_union0_error != null) {
+                obj_coverageScanned_union0 = obj_coverageScanned_union0_error.message;
+            }
+            let obj_coverageScanned_union1 = null;
+            const obj_coverageScanned_union1_error = (() => {
+                if (obj_coverageScanned !== null) {
+                    return new TypeError('Expected "null" but received "' + typeof obj_coverageScanned + '" (at "' + path_coverageScanned + '")');
+                }
+            })();
+            if (obj_coverageScanned_union1_error != null) {
+                obj_coverageScanned_union1 = obj_coverageScanned_union1_error.message;
+            }
+            if (obj_coverageScanned_union0 && obj_coverageScanned_union1) {
+                let message = 'Object doesn\'t match union (at "' + path_coverageScanned + '")';
+                message += '\n' + obj_coverageScanned_union0.split('\n').map((line) => '\t' + line).join('\n');
+                message += '\n' + obj_coverageScanned_union1.split('\n').map((line) => '\t' + line).join('\n');
+                return new TypeError(message);
+            }
+        }
+        if (obj.coverageTotal !== undefined) {
+            const obj_coverageTotal = obj.coverageTotal;
+            const path_coverageTotal = path + '.coverageTotal';
+            let obj_coverageTotal_union0 = null;
+            const obj_coverageTotal_union0_error = (() => {
+                if (typeof obj_coverageTotal !== 'number') {
+                    return new TypeError('Expected "number" but received "' + typeof obj_coverageTotal + '" (at "' + path_coverageTotal + '")');
+                }
+            })();
+            if (obj_coverageTotal_union0_error != null) {
+                obj_coverageTotal_union0 = obj_coverageTotal_union0_error.message;
+            }
+            let obj_coverageTotal_union1 = null;
+            const obj_coverageTotal_union1_error = (() => {
+                if (obj_coverageTotal !== null) {
+                    return new TypeError('Expected "null" but received "' + typeof obj_coverageTotal + '" (at "' + path_coverageTotal + '")');
+                }
+            })();
+            if (obj_coverageTotal_union1_error != null) {
+                obj_coverageTotal_union1 = obj_coverageTotal_union1_error.message;
+            }
+            if (obj_coverageTotal_union0 && obj_coverageTotal_union1) {
+                let message = 'Object doesn\'t match union (at "' + path_coverageTotal + '")';
+                message += '\n' + obj_coverageTotal_union0.split('\n').map((line) => '\t' + line).join('\n');
+                message += '\n' + obj_coverageTotal_union1.split('\n').map((line) => '\t' + line).join('\n');
+                return new TypeError(message);
+            }
+        }
         if (obj.limitationNote !== undefined) {
             const obj_limitationNote = obj.limitationNote;
             const path_limitationNote = path + '.limitationNote';
@@ -23349,11 +23403,13 @@ const select$1f = function PlatformAuditCheckRepresentationSelect() {
             },
             {
                 name: 'coverageScanned',
-                kind: 'Scalar'
+                kind: 'Scalar',
+                required: false
             },
             {
                 name: 'coverageTotal',
-                kind: 'Scalar'
+                kind: 'Scalar',
+                required: false
             },
             {
                 name: 'limitationNote',
@@ -23383,16 +23439,6 @@ function equals$M(existing, incoming) {
     if (!(existing_status === incoming_status)) {
         return false;
     }
-    const existing_coverageScanned = existing.coverageScanned;
-    const incoming_coverageScanned = incoming.coverageScanned;
-    if (!(existing_coverageScanned === incoming_coverageScanned)) {
-        return false;
-    }
-    const existing_coverageTotal = existing.coverageTotal;
-    const incoming_coverageTotal = incoming.coverageTotal;
-    if (!(existing_coverageTotal === incoming_coverageTotal)) {
-        return false;
-    }
     const existing_checkCompletedDate = existing.checkCompletedDate;
     const incoming_checkCompletedDate = incoming.checkCompletedDate;
     // if at least one of these optionals is defined
@@ -23419,6 +23465,32 @@ function equals$M(existing, incoming) {
             return false;
         }
     }
+    const existing_coverageScanned = existing.coverageScanned;
+    const incoming_coverageScanned = incoming.coverageScanned;
+    // if at least one of these optionals is defined
+    if (existing_coverageScanned !== undefined || incoming_coverageScanned !== undefined) {
+        // if one of these is not defined we know the other is defined and therefore
+        // not equal
+        if (existing_coverageScanned === undefined || incoming_coverageScanned === undefined) {
+            return false;
+        }
+        if (!(existing_coverageScanned === incoming_coverageScanned)) {
+            return false;
+        }
+    }
+    const existing_coverageTotal = existing.coverageTotal;
+    const incoming_coverageTotal = incoming.coverageTotal;
+    // if at least one of these optionals is defined
+    if (existing_coverageTotal !== undefined || incoming_coverageTotal !== undefined) {
+        // if one of these is not defined we know the other is defined and therefore
+        // not equal
+        if (existing_coverageTotal === undefined || incoming_coverageTotal === undefined) {
+            return false;
+        }
+        if (!(existing_coverageTotal === incoming_coverageTotal)) {
+            return false;
+        }
+    }
     const existing_limitationNote = existing.limitationNote;
     const incoming_limitationNote = incoming.limitationNote;
     // if at least one of these optionals is defined
@@ -23537,7 +23609,7 @@ function equals$L(existing, incoming) {
     return true;
 }
 
-const VERSION$K = "936db61354149ac16a6d4af9b7504b5a";
+const VERSION$K = "9a2c2926bd5c97af09b7fc0bbaf2066f";
 function validate$10(obj, path = 'PlatformAuditFindingRepresentation') {
     const v_error = (() => {
         if (typeof obj !== 'object' || ArrayIsArray(obj) || obj === null) {
@@ -23615,7 +23687,7 @@ function equals$K(existing, incoming) {
     return true;
 }
 
-const VERSION$J = "c8e93d7c8c090a959704d87fcb7f563e";
+const VERSION$J = "51c6525f2259b5219e90d75c591ddf7d";
 function validate$$(obj, path = 'PlatformAuditUrgencyRepresentation') {
     const v_error = (() => {
         if (typeof obj !== 'object' || ArrayIsArray(obj) || obj === null) {
@@ -26625,7 +26697,7 @@ function select$V(luvio, params) {
     return select$W();
 }
 function keyBuilder$F(luvio, params) {
-    return keyPrefix + '::RecipeCollectionRepresentation:(' + 'format:' + params.queryParams.format + ',' + 'lastModifiedAfter:' + params.queryParams.lastModifiedAfter + ',' + 'lastModifiedBefore:' + params.queryParams.lastModifiedBefore + ',' + 'licenseType:' + params.queryParams.licenseType + ',' + 'nextScheduledAfter:' + params.queryParams.nextScheduledAfter + ',' + 'nextScheduledBefore:' + params.queryParams.nextScheduledBefore + ',' + 'page:' + params.queryParams.page + ',' + 'pageSize:' + params.queryParams.pageSize + ',' + 'q:' + params.queryParams.q + ',' + 'sort:' + params.queryParams.sort + ',' + 'status:' + params.queryParams.status + ')';
+    return keyPrefix + '::RecipeCollectionRepresentation:(' + 'format:' + params.queryParams.format + ',' + 'lastModifiedAfter:' + params.queryParams.lastModifiedAfter + ',' + 'lastModifiedBefore:' + params.queryParams.lastModifiedBefore + ',' + 'licenseType:' + params.queryParams.licenseType + ',' + 'nextScheduledAfter:' + params.queryParams.nextScheduledAfter + ',' + 'nextScheduledBefore:' + params.queryParams.nextScheduledBefore + ',' + 'page:' + params.queryParams.page + ',' + 'pageSize:' + params.queryParams.pageSize + ',' + 'q:' + params.queryParams.q + ',' + 'recipePermsFolderId:' + params.queryParams.recipePermsFolderId + ',' + 'sort:' + params.queryParams.sort + ',' + 'status:' + params.queryParams.status + ')';
 }
 function getResponseCacheKeys$p(storeKeyMap, luvio, resourceParams, response) {
     getTypeCacheKeys$d(storeKeyMap, luvio, response, () => keyBuilder$F(luvio, resourceParams));
@@ -26684,6 +26756,7 @@ const getRecipes_ConfigPropertyMetadata = [
     generateParamConfigMetadata('page', false, 1 /* QueryParameter */, 0 /* String */),
     generateParamConfigMetadata('pageSize', false, 1 /* QueryParameter */, 3 /* Integer */),
     generateParamConfigMetadata('q', false, 1 /* QueryParameter */, 0 /* String */),
+    generateParamConfigMetadata('recipePermsFolderId', false, 1 /* QueryParameter */, 0 /* String */),
     generateParamConfigMetadata('sort', false, 1 /* QueryParameter */, 0 /* String */),
     generateParamConfigMetadata('status', false, 1 /* QueryParameter */, 0 /* String */, true),
 ];

package/dist/es/es2018/types/src/generated/adapters/getRecipes.d.ts

@@ -15,6 +15,7 @@ export interface GetRecipesConfig {
     page?: string;
     pageSize?: number;
     q?: string;
+    recipePermsFolderId?: string;
     sort?: string;
     status?: Array<string>;
 }

package/dist/es/es2018/types/src/generated/resources/getWaveRecipes.d.ts

@@ -11,6 +11,7 @@ export interface ResourceRequestConfig {
         page?: string;
         pageSize?: number;
         q?: string;
+        recipePermsFolderId?: string;
         sort?: string;
         status?: Array<string>;
     };

package/dist/es/es2018/types/src/generated/types/PlatformAuditCheckCollectionRepresentation.d.ts

@@ -16,9 +16,9 @@ export declare function getTypeCacheKeys(rootKeySet: $64$luvio_engine_DurableSto
  *    (none)
  */
 export interface PlatformAuditCheckCollectionRepresentationNormalized {
-    /** The checks in this collection. */
+    /** Every check of the audit run, ordered by check name. Finished checks carry their results; checks that have not finished carry only their status. If the server cannot determine which checks have not finished, only the finished checks are listed. */
     checks: Array<PlatformAuditCheckRepresentation_PlatformAuditCheckRepresentation>;
-    /** The total number of checks in this collection. */
+    /** The number of checks listed - every check of the audit run, or only the finished checks when the server cannot determine which have not finished. */
     totalSize: number;
 }
 /**

package/dist/es/es2018/types/src/generated/types/PlatformAuditCheckRepresentation.d.ts

@@ -1,6 +1,6 @@
 import { IngestPath as $64$luvio_engine_IngestPath, Luvio as $64$luvio_engine_Luvio, Store as $64$luvio_engine_Store, FragmentSelection as $64$luvio_engine_FragmentSelection, ResourceIngest as $64$luvio_engine_ResourceIngest, DurableStoreKeyMetadataMap as $64$luvio_engine_DurableStoreKeyMetadataMap, NormalizedKeyMetadata as $64$luvio_engine_NormalizedKeyMetadata } from '@luvio/engine';
 export declare const TTL = 300;
-export declare const VERSION = "5d9aba0ee3f2f80287493bdc7dd1fa9a";
+export declare const VERSION = "c0feda50a4a8fc2e5637843b6c1b8eed";
 export declare function validate(obj: any, path?: string): TypeError | null;
 export declare const RepresentationType: string;
 export declare function normalize(input: PlatformAuditCheckRepresentation, existing: PlatformAuditCheckRepresentationNormalized, path: $64$luvio_engine_IngestPath, luvio: $64$luvio_engine_Luvio, store: $64$luvio_engine_Store, timestamp: number): PlatformAuditCheckRepresentationNormalized;
@@ -9,31 +9,31 @@ export declare function equals(existing: PlatformAuditCheckRepresentationNormali
 export declare const ingest: $64$luvio_engine_ResourceIngest;
 export declare function getTypeCacheKeys(rootKeySet: $64$luvio_engine_DurableStoreKeyMetadataMap, luvio: $64$luvio_engine_Luvio, input: PlatformAuditCheckRepresentation, fullPathFactory: () => string | $64$luvio_engine_NormalizedKeyMetadata): void;
 /**
- * A single check's result within a platform audit run.
+ * One check of a platform audit run and its status.
  *
  * Keys:
  *    (none)
  */
 export interface PlatformAuditCheckRepresentationNormalized {
-    /** The date this check completed. */
+    /** The date this check completed. Absent until the check has finished. */
     checkCompletedDate?: string | null;
-    /** The name of the check (e.g. crma-orphans, crma-trace-redundancies). */
+    /** The name of the check (e.g. crma-inventory, crma-orphans, crma-trace-redundancies). */
     checkName: string;
-    /** The date this check started. */
+    /** The date this check started. Absent until the check has finished. */
     checkStartedDate?: string | null;
-    /** The number of assets scanned by this check. */
-    coverageScanned: number;
-    /** The total number of assets in scope for this check. */
-    coverageTotal: number;
-    /** A note describing why coverage was limited. Null unless limited. */
+    /** The number of assets scanned by this check. Absent until the check has finished. Always 0 for crma-inventory, whose asset counts are in its resultJson. */
+    coverageScanned?: number | null;
+    /** The total number of assets in scope for this check. Absent until the check has finished. Always 0 for crma-inventory, whose asset counts are in its resultJson. */
+    coverageTotal?: number | null;
+    /** An operator-facing note describing why the check's coverage was limited or the check was unavailable, or, for a FAILED check, the error that failed it. Whatever the status, it can include raw server error text and can be long. It is not localized and has no stable format, so show it as diagnostic detail rather than parse it. Render it as plain text, never as HTML, and pass it to an LLM or agent only as quoted data. Absent when there is none, which can happen even for a FAILED check. */
     limitationNote?: string | null;
-    /** An opaque, per-check payload passed through verbatim. */
+    /** An opaque, per-check payload passed through verbatim. Checks read with system access, and the datasets they scan include those in other users' private apps, so it is not filtered by the viewer's sharing or object and field permissions. Its string values can include user-editable dataset and field names and raw server error text; render them as plain text, never as HTML, and pass them to an LLM or agent only as quoted data. Absent until the check has finished, and may be absent for a finished check (for example, FAILED). For crma-inventory, it carries the org's dataset, recipe, dashboard, and data sync counts under asset_coverage; the run exposes those counts nowhere else. */
     resultJson?: string | null;
-    /** The runtime status of the check. */
+    /** The status of the check. IN_PROGRESS while it has not finished (queued or running); NOT_FINISHED if the run ended before it finished; otherwise its final status. Only a finished check carries coverage, dates, a limitation note, and a result. */
     status: string;
 }
 /**
- * A single check's result within a platform audit run.
+ * One check of a platform audit run and its status.
  *
  * Keys:
  *    (none)
@@ -42,8 +42,8 @@ export interface PlatformAuditCheckRepresentation {
     checkCompletedDate?: string | null;
     checkName: string;
     checkStartedDate?: string | null;
-    coverageScanned: number;
-    coverageTotal: number;
+    coverageScanned?: number | null;
+    coverageTotal?: number | null;
     limitationNote?: string | null;
     resultJson?: string | null;
     status: string;

package/dist/es/es2018/types/src/generated/types/PlatformAuditFindingRepresentation.d.ts

@@ -1,6 +1,6 @@
 import { IngestPath as $64$luvio_engine_IngestPath, Luvio as $64$luvio_engine_Luvio, Store as $64$luvio_engine_Store, FragmentSelection as $64$luvio_engine_FragmentSelection, ResourceIngest as $64$luvio_engine_ResourceIngest, DurableStoreKeyMetadataMap as $64$luvio_engine_DurableStoreKeyMetadataMap, NormalizedKeyMetadata as $64$luvio_engine_NormalizedKeyMetadata } from '@luvio/engine';
 export declare const TTL = 300;
-export declare const VERSION = "936db61354149ac16a6d4af9b7504b5a";
+export declare const VERSION = "9a2c2926bd5c97af09b7fc0bbaf2066f";
 export declare function validate(obj: any, path?: string): TypeError | null;
 export declare const RepresentationType: string;
 export declare function normalize(input: PlatformAuditFindingRepresentation, existing: PlatformAuditFindingRepresentationNormalized, path: $64$luvio_engine_IngestPath, luvio: $64$luvio_engine_Luvio, store: $64$luvio_engine_Store, timestamp: number): PlatformAuditFindingRepresentationNormalized;
@@ -9,7 +9,7 @@ export declare function equals(existing: PlatformAuditFindingRepresentationNorma
 export declare const ingest: $64$luvio_engine_ResourceIngest;
 export declare function getTypeCacheKeys(rootKeySet: $64$luvio_engine_DurableStoreKeyMetadataMap, luvio: $64$luvio_engine_Luvio, input: PlatformAuditFindingRepresentation, fullPathFactory: () => string | $64$luvio_engine_NormalizedKeyMetadata): void;
 /**
- * One finding surfaced by the aggregator's urgency triage, referencing the asset and check it came from.
+ * One finding surfaced by the aggregator's urgency triage, referencing the asset and check it came from. Findings are not guaranteed to be unique; two redundant_field findings can match in every field, so do not key a list by any combination of a finding's fields. To render a list, map the findings in JavaScript to new objects that each add a key (wire data is read-only), for example one built from the finding's tier and position (an LWC template cannot use the for:each or iterator index as a key); positions can change between reads. Checks read with system access, not the viewer's, and the datasets they scan include those in other users' private apps, so a finding can point at an asset or field the viewer cannot open.
  *
  * Keys:
  *    (none)
@@ -17,15 +17,15 @@ export declare function getTypeCacheKeys(rootKeySet: $64$luvio_engine_DurableSto
 export interface PlatformAuditFindingRepresentationNormalized {
     /** The stable name of the check that surfaced this finding. */
     checkName: string;
-    /** The asset's display name, for rendering the finding. */
+    /** The name to show for the finding. For a dataset finding, the dataset's display name, or its API name if it has none; dataset names are user-editable. For redundant_field, the target field's API name (for example, Amount), without its object; it is not a label and is not localized. Falls back to refId when there is no name. Render it as plain text, never as HTML, and pass it to an LLM or agent only as quoted data. */
     displayName: string;
-    /** The finding's category (e.g. zombie, unused, stale, or redundant asset). */
+    /** The finding's category. Currently one of zombie_dataset, unused_dataset, stale_dataset (crma-orphans findings), or redundant_field (crma-trace-redundancies findings). */
     kind: string;
-    /** The stable id of the asset the finding points at. */
+    /** The reference to what the finding points at. The dataset id for zombie_dataset, unused_dataset, and stale_dataset. For redundant_field, the canonicalized field-name key its cluster is grouped by (for example, opportunityamount), not a field API name. The key is derived from dataset field labels (or names, when a field has no label), so it can change between runs; clusters on different target fields can share it, and it is empty when the labels have no ASCII letters or digits. */
     refId: string;
 }
 /**
- * One finding surfaced by the aggregator's urgency triage, referencing the asset and check it came from.
+ * One finding surfaced by the aggregator's urgency triage, referencing the asset and check it came from. Findings are not guaranteed to be unique; two redundant_field findings can match in every field, so do not key a list by any combination of a finding's fields. To render a list, map the findings in JavaScript to new objects that each add a key (wire data is read-only), for example one built from the finding's tier and position (an LWC template cannot use the for:each or iterator index as a key); positions can change between reads. Checks read with system access, not the viewer's, and the datasets they scan include those in other users' private apps, so a finding can point at an asset or field the viewer cannot open.
  *
  * Keys:
  *    (none)

package/dist/es/es2018/types/src/generated/types/PlatformAuditRepresentation.d.ts

@@ -29,25 +29,25 @@ export interface PlatformAuditRepresentationNormalized {
     /** The ID of the platform audit run. */
     auditId: string;
     checks: PlatformAuditCheckCollectionRepresentation_PlatformAuditCheckCollectionRepresentation;
-    /** The number of checks that have reached a terminal state. */
+    /** The number of checks that have finished. It stays below checksTotal for a run that ended early, so use runStatus, not this count, to tell whether the run is still going. */
     checksTerminal: number;
     /** The total number of checks fanned out for this audit run. */
     checksTotal: number;
-    /** The date the platform audit run completed. Null while the run is Running. */
+    /** The date the platform audit run completed. Absent while the run is RUNNING. */
     completedDate?: string | null;
     /** The date the platform audit run was created. */
     createdDate: string;
-    /** The aggregated health score for the run. Null while Running, not yet computed, or suppressed. */
+    /** The aggregated health score for the run, computed from its finished checks on every read, including while RUNNING. Absent when the score is suppressed (the scored checks scanned less than half of their candidates, or had no candidates, as when no finished check could be scored) or could not be computed. */
     healthScore?: number | null;
-    /** The runtime status of the platform audit run. */
+    /** The runtime status of the platform audit run. RUNNING until every check has finished or the run ends early. A run that ended before every check finished, for example because it ran too long, is FAILED. Otherwise the terminal status depends on every check except crma-inventory - READY if each is COMPLETE, FAILED if none is COMPLETE or COMPLETE_WITH_LIMITATIONS, and COMPLETE_WITH_LIMITATIONS otherwise. crma-inventory only counts the org's assets and its status does not affect the run's, so a READY run can have a crma-inventory check that is COMPLETE_WITH_LIMITATIONS, UNAVAILABLE, or FAILED. A FAILED run can still carry finished checks, findings, and a health score; any unfinished check it lists is NOT_FINISHED. */
     runStatus: string;
     /** The scope of assets covered by the platform audit run. */
     scope: string;
-    /** Whether the health score is suppressed for this run. */
+    /** Whether the health score is suppressed for this run. Absent only when scoring could not be computed. */
     scoreSuppressed?: boolean | null;
-    /** The aggregated health urgency triage, split into critical-now and needs-attention tiers. Omitted when scoring was suppressed or the run is still running. */
+    /** The aggregated health urgency triage, split into critical-now and needs-attention tiers, computed from the finished checks on every read. Lists the scored checks' findings even when the score is suppressed. Absent only when scoring could not be computed. */
     urgency?: PlatformAuditUrgencyRepresentation_PlatformAuditUrgencyRepresentation | null;
-    /** The aggregated health verdict for the run. Null while Running or not yet computed. */
+    /** The aggregated health verdict for the run (Healthy, NeedsAttention, Critical, or Indeterminate when the score is suppressed), computed from its finished checks on every read, including while RUNNING. Absent only when scoring could not be computed. */
     verdict?: string | null;
 }
 /**

package/dist/es/es2018/types/src/generated/types/PlatformAuditSnapshotRepresentation.d.ts

@@ -20,25 +20,25 @@ export interface PlatformAuditSnapshotRepresentationNormalized {
     /** The ID of the platform audit run. */
     auditId: string;
     checks: PlatformAuditCheckCollectionRepresentation_PlatformAuditCheckCollectionRepresentation;
-    /** The number of checks that have reached a terminal state. */
+    /** The number of checks that have finished. It stays below checksTotal for a run that ended early, so use runStatus, not this count, to tell whether the run is still going. */
     checksTerminal: number;
     /** The total number of checks fanned out for this audit run. */
     checksTotal: number;
-    /** The date the platform audit run completed. Null while the run is Running. */
+    /** The date the platform audit run completed. Absent while the run is RUNNING. */
     completedDate?: string | null;
     /** The date the platform audit run was created. */
     createdDate: string;
-    /** The aggregated health score for the run. Null while Running, not yet computed, or suppressed. */
+    /** The aggregated health score for the run, computed from its finished checks on every read, including while RUNNING. Absent when the score is suppressed (the scored checks scanned less than half of their candidates, or had no candidates, as when no finished check could be scored) or could not be computed. */
     healthScore?: number | null;
-    /** The runtime status of the platform audit run. */
+    /** The runtime status of the platform audit run. RUNNING until every check has finished or the run ends early. A run that ended before every check finished, for example because it ran too long, is FAILED. Otherwise the terminal status depends on every check except crma-inventory - READY if each is COMPLETE, FAILED if none is COMPLETE or COMPLETE_WITH_LIMITATIONS, and COMPLETE_WITH_LIMITATIONS otherwise. crma-inventory only counts the org's assets and its status does not affect the run's, so a READY run can have a crma-inventory check that is COMPLETE_WITH_LIMITATIONS, UNAVAILABLE, or FAILED. A FAILED run can still carry finished checks, findings, and a health score; any unfinished check it lists is NOT_FINISHED. */
     runStatus: string;
     /** The scope of assets covered by the platform audit run. */
     scope: string;
-    /** Whether the health score is suppressed for this run. */
+    /** Whether the health score is suppressed for this run. Absent only when scoring could not be computed. */
     scoreSuppressed?: boolean | null;
-    /** The aggregated health urgency triage, split into critical-now and needs-attention tiers. Omitted when scoring was suppressed or the run is still running. */
+    /** The aggregated health urgency triage, split into critical-now and needs-attention tiers, computed from the finished checks on every read. Lists the scored checks' findings even when the score is suppressed. Absent only when scoring could not be computed. */
     urgency?: PlatformAuditUrgencyRepresentation_PlatformAuditUrgencyRepresentation | null;
-    /** The aggregated health verdict for the run. Null while Running or not yet computed. */
+    /** The aggregated health verdict for the run (Healthy, NeedsAttention, Critical, or Indeterminate when the score is suppressed), computed from its finished checks on every read, including while RUNNING. Absent only when scoring could not be computed. */
     verdict?: string | null;
 }
 /**

package/dist/es/es2018/types/src/generated/types/PlatformAuditSummaryRepresentation.d.ts

@@ -17,23 +17,23 @@ export declare function getTypeCacheKeys(rootKeySet: $64$luvio_engine_DurableSto
 export interface PlatformAuditSummaryRepresentationNormalized {
     /** The ID of the platform audit run. */
     auditId: string;
-    /** The number of checks that have reached a terminal state. */
+    /** The number of checks that have finished. It stays below checksTotal for a run that ended early, so use runStatus, not this count, to tell whether the run is still going. */
     checksTerminal: number;
     /** The total number of checks fanned out for this audit run. */
     checksTotal: number;
-    /** The date the platform audit run completed. Null while the run is Running. */
+    /** The date the platform audit run completed. Absent while the run is RUNNING. */
     completedDate?: string | null;
     /** The date the platform audit run was created. */
     createdDate: string;
-    /** The aggregated health score for the run. Null while Running, not yet computed, or suppressed. */
+    /** The aggregated health score for the run, computed from its finished checks on every read, including while RUNNING. Absent when the score is suppressed (the scored checks scanned less than half of their candidates, or had no candidates, as when no finished check could be scored) or could not be computed. */
     healthScore?: number | null;
-    /** The runtime status of the platform audit run. */
+    /** The runtime status of the platform audit run. RUNNING until every check has finished or the run ends early. A run that ended before every check finished, for example because it ran too long, is FAILED. Otherwise the terminal status depends on every check except crma-inventory - READY if each is COMPLETE, FAILED if none is COMPLETE or COMPLETE_WITH_LIMITATIONS, and COMPLETE_WITH_LIMITATIONS otherwise. crma-inventory only counts the org's assets and its status does not affect the run's, so a READY run can have a crma-inventory check that is COMPLETE_WITH_LIMITATIONS, UNAVAILABLE, or FAILED. A FAILED run can still have a health score. */
     runStatus: string;
     /** The scope of assets covered by the platform audit run. */
     scope: string;
-    /** Whether the health score is suppressed for this run. */
+    /** Whether the health score is suppressed for this run. Absent only when scoring could not be computed. */
     scoreSuppressed?: boolean | null;
-    /** The aggregated health verdict for the run. Null while Running or not yet computed. */
+    /** The aggregated health verdict for the run (Healthy, NeedsAttention, Critical, or Indeterminate when the score is suppressed), computed from its finished checks on every read, including while RUNNING. Absent only when scoring could not be computed. */
     verdict?: string | null;
 }
 /**

package/dist/es/es2018/types/src/generated/types/PlatformAuditUrgencyRepresentation.d.ts

@@ -1,7 +1,7 @@
 import { PlatformAuditFindingRepresentation as PlatformAuditFindingRepresentation_PlatformAuditFindingRepresentation } from './PlatformAuditFindingRepresentation';
 import { IngestPath as $64$luvio_engine_IngestPath, Luvio as $64$luvio_engine_Luvio, Store as $64$luvio_engine_Store, FragmentSelection as $64$luvio_engine_FragmentSelection, ResourceIngest as $64$luvio_engine_ResourceIngest, DurableStoreKeyMetadataMap as $64$luvio_engine_DurableStoreKeyMetadataMap, NormalizedKeyMetadata as $64$luvio_engine_NormalizedKeyMetadata } from '@luvio/engine';
 export declare const TTL = 300;
-export declare const VERSION = "c8e93d7c8c090a959704d87fcb7f563e";
+export declare const VERSION = "51c6525f2259b5219e90d75c591ddf7d";
 export declare function validate(obj: any, path?: string): TypeError | null;
 export declare const RepresentationType: string;
 export declare function normalize(input: PlatformAuditUrgencyRepresentation, existing: PlatformAuditUrgencyRepresentationNormalized, path: $64$luvio_engine_IngestPath, luvio: $64$luvio_engine_Luvio, store: $64$luvio_engine_Store, timestamp: number): PlatformAuditUrgencyRepresentationNormalized;
@@ -10,19 +10,19 @@ export declare function equals(existing: PlatformAuditUrgencyRepresentationNorma
 export declare const ingest: $64$luvio_engine_ResourceIngest;
 export declare function getTypeCacheKeys(rootKeySet: $64$luvio_engine_DurableStoreKeyMetadataMap, luvio: $64$luvio_engine_Luvio, input: PlatformAuditUrgencyRepresentation, fullPathFactory: () => string | $64$luvio_engine_NormalizedKeyMetadata): void;
 /**
- * The aggregator's two-tier urgency triage over the run's findings.
+ * The aggregator's two-tier urgency triage over the run's findings. Each check contributes only the findings it surfaces, and the number it surfaces is capped (currently at most 25 datasets per label for crma-orphans and 10 clusters for crma-trace-redundancies; the caps can change), so list lengths are not org-wide counts.
  *
  * Keys:
  *    (none)
  */
 export interface PlatformAuditUrgencyRepresentationNormalized {
-    /** Findings the user should act on now, ordered as the aggregator surfaced them. */
+    /** Findings the user should act on now, sorted by checkName, then refId. */
     criticalNow: Array<PlatformAuditFindingRepresentation_PlatformAuditFindingRepresentation>;
-    /** Findings that need attention as standing hygiene, ordered as the aggregator surfaced them. */
+    /** Findings that need attention as standing hygiene, sorted by checkName, then refId. */
     needsAttention: Array<PlatformAuditFindingRepresentation_PlatformAuditFindingRepresentation>;
 }
 /**
- * The aggregator's two-tier urgency triage over the run's findings.
+ * The aggregator's two-tier urgency triage over the run's findings. Each check contributes only the findings it surfaces, and the number it surfaces is capped (currently at most 25 datasets per label for crma-orphans and 10 clusters for crma-trace-redundancies; the caps can change), so list lengths are not org-wide counts.
  *
  * Keys:
  *    (none)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@salesforce/lds-adapters-analytics-wave",
-    "version": "1.463.0",
+    "version": "1.465.0",
     "license": "SEE LICENSE IN LICENSE.txt",
     "description": "The Einstein Analytics family of APIs",
     "main": "dist/es/es2018/analytics-wave.js",
@@ -58,10 +58,10 @@
         }
     },
     "dependencies": {
-        "@salesforce/lds-bindings": "^1.463.0"
+        "@salesforce/lds-bindings": "^1.465.0"
     },
     "devDependencies": {
-        "@salesforce/lds-compiler-plugins": "^1.463.0"
+        "@salesforce/lds-compiler-plugins": "^1.465.0"
     },
     "volta": {
         "extends": "../../package.json"

package/sfdc/index.js

@@ -24900,7 +24900,7 @@ const getDependenciesAdapterFactory = (luvio) => function WAVE__getDependencies(
 };
 
 const TTL$i = 300;
-const VERSION$G = "5d9aba0ee3f2f80287493bdc7dd1fa9a";
+const VERSION$G = "c0feda50a4a8fc2e5637843b6c1b8eed";
 function validate$Y(obj, path = 'PlatformAuditCheckRepresentation') {
     const v_error = (() => {
         if (typeof obj !== 'object' || ArrayIsArray(obj) || obj === null) {
@@ -24967,8 +24967,62 @@ function validate$Y(obj, path = 'PlatformAuditCheckRepresentation') {
                 return new TypeError(message);
             }
         }
-        obj.coverageScanned;
-        obj.coverageTotal;
+        if (obj.coverageScanned !== undefined) {
+            const obj_coverageScanned = obj.coverageScanned;
+            const path_coverageScanned = path + '.coverageScanned';
+            let obj_coverageScanned_union0 = null;
+            const obj_coverageScanned_union0_error = (() => {
+                if (typeof obj_coverageScanned !== 'number') {
+                    return new TypeError('Expected "number" but received "' + typeof obj_coverageScanned + '" (at "' + path_coverageScanned + '")');
+                }
+            })();
+            if (obj_coverageScanned_union0_error != null) {
+                obj_coverageScanned_union0 = obj_coverageScanned_union0_error.message;
+            }
+            let obj_coverageScanned_union1 = null;
+            const obj_coverageScanned_union1_error = (() => {
+                if (obj_coverageScanned !== null) {
+                    return new TypeError('Expected "null" but received "' + typeof obj_coverageScanned + '" (at "' + path_coverageScanned + '")');
+                }
+            })();
+            if (obj_coverageScanned_union1_error != null) {
+                obj_coverageScanned_union1 = obj_coverageScanned_union1_error.message;
+            }
+            if (obj_coverageScanned_union0 && obj_coverageScanned_union1) {
+                let message = 'Object doesn\'t match union (at "' + path_coverageScanned + '")';
+                message += '\n' + obj_coverageScanned_union0.split('\n').map((line) => '\t' + line).join('\n');
+                message += '\n' + obj_coverageScanned_union1.split('\n').map((line) => '\t' + line).join('\n');
+                return new TypeError(message);
+            }
+        }
+        if (obj.coverageTotal !== undefined) {
+            const obj_coverageTotal = obj.coverageTotal;
+            const path_coverageTotal = path + '.coverageTotal';
+            let obj_coverageTotal_union0 = null;
+            const obj_coverageTotal_union0_error = (() => {
+                if (typeof obj_coverageTotal !== 'number') {
+                    return new TypeError('Expected "number" but received "' + typeof obj_coverageTotal + '" (at "' + path_coverageTotal + '")');
+                }
+            })();
+            if (obj_coverageTotal_union0_error != null) {
+                obj_coverageTotal_union0 = obj_coverageTotal_union0_error.message;
+            }
+            let obj_coverageTotal_union1 = null;
+            const obj_coverageTotal_union1_error = (() => {
+                if (obj_coverageTotal !== null) {
+                    return new TypeError('Expected "null" but received "' + typeof obj_coverageTotal + '" (at "' + path_coverageTotal + '")');
+                }
+            })();
+            if (obj_coverageTotal_union1_error != null) {
+                obj_coverageTotal_union1 = obj_coverageTotal_union1_error.message;
+            }
+            if (obj_coverageTotal_union0 && obj_coverageTotal_union1) {
+                let message = 'Object doesn\'t match union (at "' + path_coverageTotal + '")';
+                message += '\n' + obj_coverageTotal_union0.split('\n').map((line) => '\t' + line).join('\n');
+                message += '\n' + obj_coverageTotal_union1.split('\n').map((line) => '\t' + line).join('\n');
+                return new TypeError(message);
+            }
+        }
         if (obj.limitationNote !== undefined) {
             const obj_limitationNote = obj.limitationNote;
             const path_limitationNote = path + '.limitationNote';
@@ -25059,11 +25113,13 @@ const select$1i = function PlatformAuditCheckRepresentationSelect() {
             },
             {
                 name: 'coverageScanned',
-                kind: 'Scalar'
+                kind: 'Scalar',
+                required: false
             },
             {
                 name: 'coverageTotal',
-                kind: 'Scalar'
+                kind: 'Scalar',
+                required: false
             },
             {
                 name: 'limitationNote',
@@ -25093,16 +25149,6 @@ function equals$G(existing, incoming) {
     if (!(existing_status === incoming_status)) {
         return false;
     }
-    const existing_coverageScanned = existing.coverageScanned;
-    const incoming_coverageScanned = incoming.coverageScanned;
-    if (!(existing_coverageScanned === incoming_coverageScanned)) {
-        return false;
-    }
-    const existing_coverageTotal = existing.coverageTotal;
-    const incoming_coverageTotal = incoming.coverageTotal;
-    if (!(existing_coverageTotal === incoming_coverageTotal)) {
-        return false;
-    }
     const existing_checkCompletedDate = existing.checkCompletedDate;
     const incoming_checkCompletedDate = incoming.checkCompletedDate;
     // if at least one of these optionals is defined
@@ -25129,6 +25175,32 @@ function equals$G(existing, incoming) {
             return false;
         }
     }
+    const existing_coverageScanned = existing.coverageScanned;
+    const incoming_coverageScanned = incoming.coverageScanned;
+    // if at least one of these optionals is defined
+    if (existing_coverageScanned !== undefined || incoming_coverageScanned !== undefined) {
+        // if one of these is not defined we know the other is defined and therefore
+        // not equal
+        if (existing_coverageScanned === undefined || incoming_coverageScanned === undefined) {
+            return false;
+        }
+        if (!(existing_coverageScanned === incoming_coverageScanned)) {
+            return false;
+        }
+    }
+    const existing_coverageTotal = existing.coverageTotal;
+    const incoming_coverageTotal = incoming.coverageTotal;
+    // if at least one of these optionals is defined
+    if (existing_coverageTotal !== undefined || incoming_coverageTotal !== undefined) {
+        // if one of these is not defined we know the other is defined and therefore
+        // not equal
+        if (existing_coverageTotal === undefined || incoming_coverageTotal === undefined) {
+            return false;
+        }
+        if (!(existing_coverageTotal === incoming_coverageTotal)) {
+            return false;
+        }
+    }
     const existing_limitationNote = existing.limitationNote;
     const incoming_limitationNote = incoming.limitationNote;
     // if at least one of these optionals is defined
@@ -25247,7 +25319,7 @@ function equals$F(existing, incoming) {
     return true;
 }
 
-const VERSION$E = "936db61354149ac16a6d4af9b7504b5a";
+const VERSION$E = "9a2c2926bd5c97af09b7fc0bbaf2066f";
 function validate$W(obj, path = 'PlatformAuditFindingRepresentation') {
     const v_error = (() => {
         if (typeof obj !== 'object' || ArrayIsArray(obj) || obj === null) {
@@ -25325,7 +25397,7 @@ function equals$E(existing, incoming) {
     return true;
 }
 
-const VERSION$D = "c8e93d7c8c090a959704d87fcb7f563e";
+const VERSION$D = "51c6525f2259b5219e90d75c591ddf7d";
 function validate$V(obj, path = 'PlatformAuditUrgencyRepresentation') {
     const v_error = (() => {
         if (typeof obj !== 'object' || ArrayIsArray(obj) || obj === null) {
@@ -27888,7 +27960,7 @@ function select$11(luvio, params) {
     return select$12();
 }
 function keyBuilder$F(luvio, params) {
-    return keyPrefix + '::RecipeCollectionRepresentation:(' + 'format:' + params.queryParams.format + ',' + 'lastModifiedAfter:' + params.queryParams.lastModifiedAfter + ',' + 'lastModifiedBefore:' + params.queryParams.lastModifiedBefore + ',' + 'licenseType:' + params.queryParams.licenseType + ',' + 'nextScheduledAfter:' + params.queryParams.nextScheduledAfter + ',' + 'nextScheduledBefore:' + params.queryParams.nextScheduledBefore + ',' + 'page:' + params.queryParams.page + ',' + 'pageSize:' + params.queryParams.pageSize + ',' + 'q:' + params.queryParams.q + ',' + 'sort:' + params.queryParams.sort + ',' + 'status:' + params.queryParams.status + ')';
+    return keyPrefix + '::RecipeCollectionRepresentation:(' + 'format:' + params.queryParams.format + ',' + 'lastModifiedAfter:' + params.queryParams.lastModifiedAfter + ',' + 'lastModifiedBefore:' + params.queryParams.lastModifiedBefore + ',' + 'licenseType:' + params.queryParams.licenseType + ',' + 'nextScheduledAfter:' + params.queryParams.nextScheduledAfter + ',' + 'nextScheduledBefore:' + params.queryParams.nextScheduledBefore + ',' + 'page:' + params.queryParams.page + ',' + 'pageSize:' + params.queryParams.pageSize + ',' + 'q:' + params.queryParams.q + ',' + 'recipePermsFolderId:' + params.queryParams.recipePermsFolderId + ',' + 'sort:' + params.queryParams.sort + ',' + 'status:' + params.queryParams.status + ')';
 }
 function getResponseCacheKeys$y(storeKeyMap, luvio, resourceParams, response) {
     getTypeCacheKeys$d(storeKeyMap, luvio, response, () => keyBuilder$F(luvio, resourceParams));
@@ -27947,6 +28019,7 @@ const getRecipes_ConfigPropertyMetadata = [
     generateParamConfigMetadata('page', false, 1 /* QueryParameter */, 0 /* String */),
     generateParamConfigMetadata('pageSize', false, 1 /* QueryParameter */, 3 /* Integer */),
     generateParamConfigMetadata('q', false, 1 /* QueryParameter */, 0 /* String */),
+    generateParamConfigMetadata('recipePermsFolderId', false, 1 /* QueryParameter */, 0 /* String */),
     generateParamConfigMetadata('sort', false, 1 /* QueryParameter */, 0 /* String */),
     generateParamConfigMetadata('status', false, 1 /* QueryParameter */, 0 /* String */, true),
 ];
@@ -38424,4 +38497,4 @@ withDefaultLuvio((luvio) => {
 });
 
 export { createDataConnector, createDataflowJob, createDataset, createDatasetVersion, createReplicatedDataset, createWaveFolder, deleteDataConnector, deleteDataset, deleteRecipe, deleteReplicatedDataset, deleteWaveFolder, executeQuery, executeQuery_imperative, generatePlatformAuditReport, getActions, getActions_imperative, getAnalyticsLimits, getAnalyticsLimits_imperative, getAsset, getAssetNotifyChange, getAsset_imperative, getDataConnector, getDataConnectorNotifyChange, getDataConnectorSourceFields, getDataConnectorSourceFieldsNotifyChange, getDataConnectorSourceFieldsWithAdvProps, getDataConnectorSourceFieldsWithAdvPropsNotifyChange, getDataConnectorSourceFieldsWithAdvProps_imperative, getDataConnectorSourceFields_imperative, getDataConnectorSourceObject, getDataConnectorSourceObjectDataPreviewWithFields, getDataConnectorSourceObjectDataPreviewWithFields_imperative, getDataConnectorSourceObjectNotifyChange, getDataConnectorSourceObject_imperative, getDataConnectorSourceObjects, getDataConnectorSourceObjects_imperative, getDataConnectorStatus, getDataConnectorStatus_imperative, getDataConnectorTypes, getDataConnectorTypes_imperative, getDataConnector_imperative, getDataConnectors, getDataConnectors_imperative, getDataflowJob, getDataflowJobNode, getDataflowJobNodeNotifyChange, getDataflowJobNodeStage, getDataflowJobNodeStageNotifyChange, getDataflowJobNodeStageParents, getDataflowJobNodeStageParentsNotifyChange, getDataflowJobNodeStageParents_imperative, getDataflowJobNodeStage_imperative, getDataflowJobNodeStages, getDataflowJobNodeStages_imperative, getDataflowJobNode_imperative, getDataflowJobNodes, getDataflowJobNodes_imperative, getDataflowJobNotifyChange, getDataflowJob_imperative, getDataflowJobs, getDataflowJobs_imperative, getDataflows, getDataflows_imperative, getDataset, getDatasetNotifyChange, getDatasetVersion, getDatasetVersionNotifyChange, getDatasetVersion_imperative, getDatasetVersions, getDatasetVersions_imperative, getDataset_imperative, getDatasets, getDatasets_imperative, getDependencies, getDependencies_imperative, getLatestPlatformAudit, getLatestPlatformAudit_imperative, getPlatformAudit, getPlatformAuditCheck, getPlatformAuditCheck_imperative, getPlatformAuditHistory, getPlatformAuditHistory_imperative, getPlatformAuditNotifyChange, getPlatformAuditReport, getPlatformAuditReport_imperative, getPlatformAudit_imperative, getRecipe, getRecipeNotification, getRecipeNotificationNotifyChange, getRecipeNotification_imperative, getRecipeNotifyChange, getRecipe_imperative, getRecipes, getRecipes_imperative, getRecycleBin, getRecycleBinAsset, getRecycleBinAssetNotifyChange, getRecycleBinAsset_imperative, getRecycleBin_imperative, getReplicatedDataset, getReplicatedDatasetNotifyChange, getReplicatedDataset_imperative, getReplicatedDatasets, getReplicatedDatasets_imperative, getReplicatedFields, getReplicatedFieldsNotifyChange, getReplicatedFieldsWithAdvancedProps, getReplicatedFieldsWithAdvancedPropsNotifyChange, getReplicatedFieldsWithAdvancedProps_imperative, getReplicatedFields_imperative, getSchedule, getScheduleNotifyChange, getSchedule_imperative, getSecurityCoverageDatasetVersion, getSecurityCoverageDatasetVersion_imperative, getWaveFolder, getWaveFolderNotifyChange, getWaveFolder_imperative, getWaveFolders, getWaveFolders_imperative, getWaveTemplate, getWaveTemplateConfig, getWaveTemplateConfigNotifyChange, getWaveTemplateConfig_imperative, getWaveTemplateNotifyChange, getWaveTemplateReleaseNotes, getWaveTemplateReleaseNotesNotifyChange, getWaveTemplateReleaseNotes_imperative, getWaveTemplate_imperative, getWaveTemplates, getWaveTemplates_imperative, getWaveUnsupportedFeatures, getWaveUnsupportedFeatures_imperative, getXmd, getXmd_imperative, ingestDataConnector, permanentlyDeleteAsset, restoreAsset, softDeleteAsset, triggerPlatformAudit, updateDataConnector, updateDataflowJob, updateDataset, updateDatasetVersion, updatePartialWaveFolder, updateRecipe, updateRecipeNotification, updateReplicatedDataset, updateReplicatedFields, updateSchedule, updateWaveFolder, updateXmd, validateWaveTemplate };
-// version: 1.463.0-8515018faf
+// version: 1.465.0-4371689bb7

package/src/raml/api.raml

@@ -2785,13 +2785,21 @@ types:
         description: The ID of the platform audit run.
         type: string
       runStatus:
-        description: The runtime status of the platform audit run.
+        description: The runtime status of the platform audit run. RUNNING until every check
+          has finished or the run ends early. A run that ended before every check finished,
+          for example because it ran too long, is FAILED. Otherwise the terminal status depends
+          on every check except crma-inventory - READY if each is COMPLETE, FAILED if none is
+          COMPLETE or COMPLETE_WITH_LIMITATIONS, and COMPLETE_WITH_LIMITATIONS otherwise.
+          crma-inventory only counts the org's assets and its status does not affect the
+          run's, so a READY run can have a crma-inventory check that is
+          COMPLETE_WITH_LIMITATIONS, UNAVAILABLE, or FAILED. A FAILED run can still carry finished checks,
+          findings, and a health score; any unfinished check it lists is NOT_FINISHED.
         type: string
         enum:
-          - Running
-          - Ready
-          - CompleteWithLimitations
-          - Failed
+          - RUNNING
+          - READY
+          - COMPLETE_WITH_LIMITATIONS
+          - FAILED
       scope:
         description: The scope of assets covered by the platform audit run.
         type: string
@@ -2803,7 +2811,9 @@ types:
         format: double
         type: number
       checksTerminal:
-        description: The number of checks that have reached a terminal state.
+        description: The number of checks that have finished. It stays below checksTotal
+          for a run that ended early, so use runStatus, not this count, to tell whether the
+          run is still going.
         # TODO: Hand-rolled from "format: int64, type: integer" due to W-8274943
         format: double
         type: number
@@ -2811,30 +2821,37 @@ types:
         description: The date the platform audit run was created.
         type: string
       completedDate:
-        description: The date the platform audit run completed. Null while the run is Running.
+        description: The date the platform audit run completed. Absent while the run is RUNNING.
         type: string | nil
         required: false
       checks:
-        description: The checks that make up this platform audit run.
+        description: Every check of the audit run with its status - finished checks with
+          their results, and checks that have not finished without one.
         type: PlatformAuditCheckCollectionRepresentation
       healthScore:
-        description: The aggregated health score for the run. Null while Running, not yet
-          computed, or suppressed.
+        description: The aggregated health score for the run, computed from its finished
+          checks on every read, including while RUNNING. Absent when the score is suppressed
+          (the scored checks scanned less than half of their candidates, or had no
+          candidates, as when no finished check could be scored) or could not be computed.
         type: integer | nil
         required: false
       verdict:
-        description: The aggregated health verdict for the run. Null while Running or not
-          yet computed.
+        description: The aggregated health verdict for the run (Healthy, NeedsAttention,
+          Critical, or Indeterminate when the score is suppressed), computed from its
+          finished checks on every read, including while RUNNING. Absent only when scoring
+          could not be computed.
         type: string | nil
         required: false
       urgency:
         description: The aggregated health urgency triage, split into critical-now and
-          needs-attention tiers. Omitted when scoring was suppressed or the run is still
-          running.
+          needs-attention tiers, computed from the finished checks on every read. Lists the
+          scored checks' findings even when the score is suppressed. Absent only when scoring
+          could not be computed.
         type: PlatformAuditUrgencyRepresentation | nil
         required: false
       scoreSuppressed:
-        description: Whether the health score is suppressed for this run.
+        description: Whether the health score is suppressed for this run. Absent only when
+          scoring could not be computed.
         type: boolean | nil
         required: false
   PlatformAuditSnapshotRepresentation: # TODO Hand-rolled W-24314623
@@ -2848,13 +2865,21 @@ types:
         description: The ID of the platform audit run.
         type: string
       runStatus:
-        description: The runtime status of the platform audit run.
+        description: The runtime status of the platform audit run. RUNNING until every check
+          has finished or the run ends early. A run that ended before every check finished,
+          for example because it ran too long, is FAILED. Otherwise the terminal status depends
+          on every check except crma-inventory - READY if each is COMPLETE, FAILED if none is
+          COMPLETE or COMPLETE_WITH_LIMITATIONS, and COMPLETE_WITH_LIMITATIONS otherwise.
+          crma-inventory only counts the org's assets and its status does not affect the
+          run's, so a READY run can have a crma-inventory check that is
+          COMPLETE_WITH_LIMITATIONS, UNAVAILABLE, or FAILED. A FAILED run can still carry finished checks,
+          findings, and a health score; any unfinished check it lists is NOT_FINISHED.
         type: string
         enum:
-          - Running
-          - Ready
-          - CompleteWithLimitations
-          - Failed
+          - RUNNING
+          - READY
+          - COMPLETE_WITH_LIMITATIONS
+          - FAILED
       scope:
         description: The scope of assets covered by the platform audit run.
         type: string
@@ -2866,7 +2891,9 @@ types:
         format: double
         type: number
       checksTerminal:
-        description: The number of checks that have reached a terminal state.
+        description: The number of checks that have finished. It stays below checksTotal
+          for a run that ended early, so use runStatus, not this count, to tell whether the
+          run is still going.
         # TODO: Hand-rolled from "format: int64, type: integer" due to W-8274943
         format: double
         type: number
@@ -2874,71 +2901,103 @@ types:
         description: The date the platform audit run was created.
         type: string
       completedDate:
-        description: The date the platform audit run completed. Null while the run is Running.
+        description: The date the platform audit run completed. Absent while the run is RUNNING.
         type: string | nil
         required: false
       checks:
-        description: The checks that make up this platform audit run.
+        description: Every check of the audit run with its status - finished checks with
+          their results, and checks that have not finished without one.
         type: PlatformAuditCheckCollectionRepresentation
       healthScore:
-        description: The aggregated health score for the run. Null while Running, not yet
-          computed, or suppressed.
+        description: The aggregated health score for the run, computed from its finished
+          checks on every read, including while RUNNING. Absent when the score is suppressed
+          (the scored checks scanned less than half of their candidates, or had no
+          candidates, as when no finished check could be scored) or could not be computed.
         type: integer | nil
         required: false
       verdict:
-        description: The aggregated health verdict for the run. Null while Running or not
-          yet computed.
+        description: The aggregated health verdict for the run (Healthy, NeedsAttention,
+          Critical, or Indeterminate when the score is suppressed), computed from its
+          finished checks on every read, including while RUNNING. Absent only when scoring
+          could not be computed.
         type: string | nil
         required: false
       urgency:
         description: The aggregated health urgency triage, split into critical-now and
-          needs-attention tiers. Omitted when scoring was suppressed or the run is still
-          running.
+          needs-attention tiers, computed from the finished checks on every read. Lists the
+          scored checks' findings even when the score is suppressed. Absent only when scoring
+          could not be computed.
         type: PlatformAuditUrgencyRepresentation | nil
         required: false
       scoreSuppressed:
-        description: Whether the health score is suppressed for this run.
+        description: Whether the health score is suppressed for this run. Absent only when
+          scoring could not be computed.
         type: boolean | nil
         required: false
   PlatformAuditCheckRepresentation: # TODO Hand-rolled W-24314623
-    description: A single check's result within a platform audit run.
+    description: One check of a platform audit run and its status.
     type: object
     properties:
       checkName:
-        description: The name of the check (e.g. crma-orphans, crma-trace-redundancies).
+        description: The name of the check (e.g. crma-inventory, crma-orphans,
+          crma-trace-redundancies).
         type: string
       status:
-        description: The runtime status of the check.
+        description: The status of the check. IN_PROGRESS while it has not finished (queued
+          or running); NOT_FINISHED if the run ended before it finished; otherwise its final
+          status. Only a finished check carries coverage, dates, a limitation note, and a
+          result.
         type: string
         enum:
-          - Complete
-          - CompleteWithLimitations
-          - Unavailable
-          - Failed
+          - IN_PROGRESS # TODO Hand-rolled W-24564863
+          - NOT_FINISHED # TODO Hand-rolled W-24564863
+          - COMPLETE
+          - COMPLETE_WITH_LIMITATIONS
+          - UNAVAILABLE
+          - FAILED
       coverageScanned:
-        description: The number of assets scanned by this check.
+        description: The number of assets scanned by this check. Absent until the check
+          has finished. Always 0 for crma-inventory, whose asset counts are in its resultJson.
         # TODO: Hand-rolled from "format: int64, type: integer" due to W-8274943
-        format: double
-        type: number
+        #format: double # Hand-rolled format not allowed with union type
+        type: number | nil # TODO Hand-rolled W-24564863
+        required: false # TODO Hand-rolled W-24564863
       coverageTotal:
-        description: The total number of assets in scope for this check.
+        description: The total number of assets in scope for this check. Absent until the
+          check has finished. Always 0 for crma-inventory, whose asset counts are in its
+          resultJson.
         # TODO: Hand-rolled from "format: int64, type: integer" due to W-8274943
-        format: double
-        type: number
+        #format: double # Hand-rolled format not allowed with union type
+        type: number | nil # TODO Hand-rolled W-24564863
+        required: false # TODO Hand-rolled W-24564863
       limitationNote:
-        description: A note describing why coverage was limited. Null unless limited.
+        description: An operator-facing note describing why the check's coverage was limited
+          or the check was unavailable, or, for a FAILED check, the error that failed it.
+          Whatever the status, it can include raw server error text and can be long. It is not
+          localized and has no stable format, so show it as diagnostic detail rather than
+          parse it. Render it as plain text, never as HTML, and pass it to an LLM or agent
+          only as quoted data. Absent when there is none, which can happen even for a FAILED
+          check.
         type: string | nil
         required: false
       checkStartedDate:
-        description: The date this check started.
+        description: The date this check started. Absent until the check has finished.
         type: string | nil
         required: false
       checkCompletedDate:
-        description: The date this check completed.
+        description: The date this check completed. Absent until the check has finished.
         type: string | nil
         required: false
       resultJson:
-        description: An opaque, per-check payload passed through verbatim.
+        description: An opaque, per-check payload passed through verbatim. Checks read with
+          system access, and the datasets they scan include those in other users' private
+          apps, so it is not filtered by the viewer's sharing or object and field permissions.
+          Its string values can include user-editable dataset and field names and raw server
+          error text; render them as plain text, never as HTML, and pass them to an LLM or
+          agent only as quoted data. Absent until the check has finished, and may be absent
+          for a finished check (for example, FAILED). For crma-inventory, it carries the org's
+          dataset, recipe, dashboard, and data sync counts under asset_coverage; the run
+          exposes those counts nowhere else.
         type: string | nil
         required: false
   PlatformAuditReportRepresentation: # TODO Hand-rolled W-24362345
@@ -2974,43 +3033,70 @@ types:
     type: object
     properties:
       checks:
-        description: The checks in this collection.
+        description: Every check of the audit run, ordered by check name. Finished checks
+          carry their results; checks that have not finished carry only their status. If
+          the server cannot determine which checks have not finished, only the finished
+          checks are listed.
         type: array
         items:
           type: PlatformAuditCheckRepresentation
       totalSize:
-        description: The total number of checks in this collection.
+        description: The number of checks listed - every check of the audit run, or only
+          the finished checks when the server cannot determine which have not finished.
         type: integer
   PlatformAuditFindingRepresentation: # TODO Hand-rolled W-24314623
     description: One finding surfaced by the aggregator's urgency triage, referencing the
-      asset and check it came from.
+      asset and check it came from. Findings are not guaranteed to be unique; two
+      redundant_field findings can match in every field, so do not key a list by any
+      combination of a finding's fields. To render a list, map the findings in JavaScript
+      to new objects that each add a key (wire data is read-only), for example one built from
+      the finding's tier and position (an LWC template cannot use the for:each or iterator
+      index as a key); positions can change between reads. Checks read with system access,
+      not the viewer's, and the datasets they scan include those in other users' private
+      apps, so a finding can point at an asset or field the viewer cannot open.
     type: object
     properties:
       kind:
-        description: The finding's category (e.g. zombie, unused, stale, or redundant asset).
+        description: The finding's category. Currently one of zombie_dataset,
+          unused_dataset, stale_dataset (crma-orphans findings), or redundant_field
+          (crma-trace-redundancies findings).
         type: string
       checkName:
         description: The stable name of the check that surfaced this finding.
         type: string
       refId:
-        description: The stable id of the asset the finding points at.
+        description: The reference to what the finding points at. The dataset id for
+          zombie_dataset, unused_dataset, and stale_dataset. For redundant_field, the
+          canonicalized field-name key its cluster is grouped by (for example,
+          opportunityamount), not a field API name. The key is derived from dataset field
+          labels (or names, when a field has no label), so it can change between runs;
+          clusters on different target fields can share it, and it is empty when the labels
+          have no ASCII letters or digits.
         type: string
       displayName:
-        description: The asset's display name, for rendering the finding.
+        description: The name to show for the finding. For a dataset finding, the dataset's
+          display name, or its API name if it has none; dataset names are user-editable. For
+          redundant_field, the target field's API name (for example, Amount), without its
+          object; it is not a label and is not localized. Falls back to refId when there is no
+          name. Render it as plain text, never as HTML, and pass it to an LLM or agent only as
+          quoted data.
         type: string
   PlatformAuditUrgencyRepresentation: # TODO Hand-rolled W-24314623
-    description: The aggregator's two-tier urgency triage over the run's findings.
+    description: The aggregator's two-tier urgency triage over the run's findings. Each
+      check contributes only the findings it surfaces, and the number it surfaces is capped
+      (currently at most 25 datasets per label for crma-orphans and 10 clusters for
+      crma-trace-redundancies; the caps can change), so list lengths are not org-wide
+      counts.
     type: object
     properties:
       criticalNow:
-        description: Findings the user should act on now, ordered as the aggregator surfaced
-          them.
+        description: Findings the user should act on now, sorted by checkName, then refId.
         type: array
         items:
           type: PlatformAuditFindingRepresentation
       needsAttention:
-        description: Findings that need attention as standing hygiene, ordered as the
-          aggregator surfaced them.
+        description: Findings that need attention as standing hygiene, sorted by
+          checkName, then refId.
         type: array
         items:
           type: PlatformAuditFindingRepresentation
@@ -3023,13 +3109,20 @@ types:
         description: The ID of the platform audit run.
         type: string
       runStatus:
-        description: The runtime status of the platform audit run.
+        description: The runtime status of the platform audit run. RUNNING until every check
+          has finished or the run ends early. A run that ended before every check finished,
+          for example because it ran too long, is FAILED. Otherwise the terminal status depends
+          on every check except crma-inventory - READY if each is COMPLETE, FAILED if none is
+          COMPLETE or COMPLETE_WITH_LIMITATIONS, and COMPLETE_WITH_LIMITATIONS otherwise.
+          crma-inventory only counts the org's assets and its status does not affect the
+          run's, so a READY run can have a crma-inventory check that is
+          COMPLETE_WITH_LIMITATIONS, UNAVAILABLE, or FAILED. A FAILED run can still have a health score.
         type: string
         enum:
-          - Running
-          - Ready
-          - CompleteWithLimitations
-          - Failed
+          - RUNNING
+          - READY
+          - COMPLETE_WITH_LIMITATIONS
+          - FAILED
       scope:
         description: The scope of assets covered by the platform audit run.
         type: string
@@ -3041,7 +3134,9 @@ types:
         format: double
         type: number
       checksTerminal:
-        description: The number of checks that have reached a terminal state.
+        description: The number of checks that have finished. It stays below checksTotal
+          for a run that ended early, so use runStatus, not this count, to tell whether the
+          run is still going.
         # TODO: Hand-rolled from "format: int64, type: integer" due to W-8274943
         format: double
         type: number
@@ -3049,21 +3144,26 @@ types:
         description: The date the platform audit run was created.
         type: string
       completedDate:
-        description: The date the platform audit run completed. Null while the run is Running.
+        description: The date the platform audit run completed. Absent while the run is RUNNING.
         type: string | nil
         required: false
       healthScore:
-        description: The aggregated health score for the run. Null while Running, not yet
-          computed, or suppressed.
+        description: The aggregated health score for the run, computed from its finished
+          checks on every read, including while RUNNING. Absent when the score is suppressed
+          (the scored checks scanned less than half of their candidates, or had no
+          candidates, as when no finished check could be scored) or could not be computed.
         type: integer | nil
         required: false
       verdict:
-        description: The aggregated health verdict for the run. Null while Running or not
-          yet computed.
+        description: The aggregated health verdict for the run (Healthy, NeedsAttention,
+          Critical, or Indeterminate when the score is suppressed), computed from its
+          finished checks on every read, including while RUNNING. Absent only when scoring
+          could not be computed.
         type: string | nil
         required: false
       scoreSuppressed:
-        description: Whether the health score is suppressed for this run.
+        description: Whether the health score is suppressed for this run. Absent only when
+          scoring could not be computed.
         type: boolean | nil
         required: false
   PlatformAuditCollectionRepresentation: # TODO Hand-rolled W-24314623
@@ -7864,7 +7964,10 @@ types:
         required: true
   /platform-audit/{auditId}/checks/{checkId}: # TODO Hand-rolled W-24314623
     get:
-      description: Get a single check's result within a platform audit run.
+      description: Get a single check's result within a platform audit run. Returns 404
+        when the run or the check does not exist. The server has no record of a check until
+        it finishes, so an IN_PROGRESS or NOT_FINISHED check also returns 404; a FAILED check
+        returns 200.
       responses:
         '200':
           description: Success
@@ -7876,6 +7979,7 @@ types:
         type: string
         required: true
       checkId:
+        description: The check's name (e.g. crma-orphans). A check has no separate id.
         type: string
         required: true
   /platform-audit/{auditId}/report: # TODO Hand-rolled W-24362345
@@ -7987,6 +8091,9 @@ types:
         q:
           type: string
           required: false
+        recipePermsFolderId:
+          type: string
+          required: false
         sort:
           type: string
           required: false