docs(cache): remove static dataset invalidation

docs/openapi.yaml

@@ -178,7 +178,7 @@ paths:
       operationId: createAnalyticsRun
       summary: Create or return the current analytics run
       description: |
-        Idempotently resolves the current merchant/source/cohort/metric revision
+        Idempotently resolves the current merchant/dataset/metric version
         and starts only missing sections. Equivalent concurrent starts deduplicate.
       parameters:
         - $ref: '#/components/parameters/IdempotencyKeyHeader'
@@ -1052,8 +1052,7 @@ components:
         - runId
         - state
         - period
-        - merchantSourceRevision
-        - cohortRevision
+        - datasetSnapshotId
         - metricDefinitionVersion
         - createdAt
         - updatedAt
@@ -1066,14 +1065,10 @@ components:
           $ref: '#/components/schemas/AnalyticsRunState'
         period:
           $ref: '#/components/schemas/ReportingPeriod'
-        merchantSourceRevision:
+        datasetSnapshotId:
           type: string
-          pattern: '^[0-9]+$'
-          description: Decimal string to avoid client integer-width loss.
-        cohortRevision:
-          type: string
-          pattern: '^[0-9]+$'
-          description: Decimal string to avoid client integer-width loss.
+          pattern: '^ds_[A-Za-z0-9_-]{8,60}$'
+          description: Opaque identifier for the immutable completed-import snapshot.
         metricDefinitionVersion:
           type: string
           const: 0.4.0
@@ -1147,14 +1142,14 @@ components:
     ReadySectionMetadata:
       type: object
       additionalProperties: false
-      required: [calculatedAt, sourceRevision, metricDefinitionVersion]
+      required: [calculatedAt, datasetSnapshotId, metricDefinitionVersion]
       properties:
         calculatedAt:
           type: string
           format: date-time
-        sourceRevision:
+        datasetSnapshotId:
           type: string
-          pattern: '^[0-9]+$'
+          pattern: '^ds_[A-Za-z0-9_-]{8,60}$'
         metricDefinitionVersion:
           type: string
           const: 0.4.0