use "source" as element name for all uses of data-provenance.yaml

docs/_data/components/schemas/array-max-monitored-elements.yaml

@@ -169,13 +169,13 @@ forecast-proposal-status:
 
   properties:
     <<: *common-proposal-status-props
-    forecast-provider:
+    source:
       $ref: ./data-provenance.yaml
     begins: # nominates the forecast window
       $ref: ./period-start.yaml
 
   required:
-    - forecast-provider
+    - source
     - begins
     - incomplete-obligation-count
     - incomplete-obligations
@@ -189,10 +189,10 @@ real-time-proposal-status:
     Includes any validation errors encountered while processing proposals.
   properties:
     <<: *common-proposal-status-props
-    ratings-provider:
+    source:
       $ref: ./data-provenance.yaml
   required:
-    - ratings-provider
+    - source
     - incomplete-obligation-count
     - incomplete-obligations
     - invalid-proposal-count
@@ -306,10 +306,10 @@ seasonal-ratings-proposal-status:
         unfulfilled Obligations indicated in `incomplete-obligation-count`.
       items:
         $ref: ./array-max-seasons.yaml#/missing-seasonal-obligation
-    provider-info:
+    source:
       $ref: ./data-provenance.yaml
   required:
-    - provider-info
+    - source
     - incomplete-obligation-count
     - invalid-proposal-count
 
@@ -345,4 +345,4 @@ seasonal-override-set:
   minItems: 0
   maxItems: *max-facilities
   items:
-    $ref: ./time-bound-static-ratings.yaml#/seasonal-override
+    $ref: ./time-bound-static-ratings.yaml#/seasonal-override

docs/_data/components/schemas/headers.yaml

@@ -86,15 +86,15 @@ forecast-snapshot-header: &forecast-snapshot-header
         RFC 3339 date-time string with *no fractional seconds component* that
         Nominates the operational window of this snapshot.
 
-    snapshot-provenance:
+    source:
       $ref: ./data-provenance.yaml
     power-system-resources:
       $ref: ./array-max-monitored-elements.yaml#/named-power-system-resources
     default-emergency-durations:
       $ref: ./array-max-emergency-durations.yaml#/emergency-durations
   required:
     - begins
-    - snapshot-provenance
+    - source
     - power-system-resources
     - default-emergency-durations
 
@@ -113,21 +113,21 @@ forecast-snapshot-slim-header:
   required:
     - begins
     - ends
-    - snapshot-provenance
+    - source
     - power-system-resources
     - default-emergency-durations
 
 real-time-snapshot-header:
   description: Details about the snapshot provided by the Clearinghouse provider.
   properties:
-    snapshot-provenance:
+    source:
       $ref: ./data-provenance.yaml
     power-system-resources:
       $ref: ./array-max-monitored-elements.yaml#/named-power-system-resources
     default-emergency-durations:
       $ref: ./array-max-emergency-durations.yaml#/emergency-durations
   required:
-    - snapshot-provenance
+    - source
     - power-system-resources
 
 seasonal-proposal-header:
@@ -136,7 +136,6 @@ seasonal-proposal-header:
 
     Describes the contents of this seasonal ratings proposal.
 
-
 seasonal-proposal-header-slim:
   <<: *common-header
   description: |

docs/_data/components/schemas/time-bound-static-ratings.yaml

@@ -1,13 +1,13 @@
-temporary-aar-exception-request:
+temporary-aar-exception-request: &time-bound-static-rating
   type: object
   description: |
     Represents a temporary AAR Exception against a resource.
-    Includes a start and (optional) end time, and a reason.  
+    Includes a start and (optional) end time, and a reason.
 
     May or may not include a set of values, depending on the business
-    context in which the temporary AAR exception is used.  
-  properties: &time-bound-static-rating
-    provenance: 
+    context in which the temporary AAR exception is used.
+  properties: &time-bound-static-rating-props
+    source:
       $ref: ./data-provenance.yaml
     resource:
       $ref: ./names.yaml
@@ -25,56 +25,44 @@ temporary-aar-exception-request:
       type: string
       format: free-form
       maxLength: 4000
+  additionalProperties: false
   required:
+    - source
     - resource
     - start-time
     - continuous-operating-limit
     - emergency-operating-limits
 
-temporary-aar-exception:
-  type: object
+temporary-aar-exception: &time-bound-static-limit
+  <<: *time-bound-static-rating
   description: |
     Data structure for a temporary AAR Exception against a resource.
     Includes a unique ID, start and (optional) end time, and a reason.  
 
     May or may not include a set of values, depending on the business
     context in which the temporary AAR exception is used.  
-  allOf:
-  - $ref: '#/temporary-aar-exception-request'
-  - type: object
-    properties:
-      id:
-        $ref: ./server-generated-id.yaml
-    required:
-      - id
-
-seasonal-override-request:
-  type: object
-  description: |
-    Data structure for a seasonal override against a resource.
-    Includes a unique ID, start and (optional) end time, and a reason.  
-
-    Must also include a set of values.  
-  properties: 
-    <<: *time-bound-static-rating
+  properties:
+    <<: *time-bound-static-rating-props
+    id:
+      $ref: ./server-generated-id.yaml
+  additionalProperties: false
   required:
+    - source
+    - id
     - resource
     - start-time
     - continuous-operating-limit
     - emergency-operating-limits
 
-seasonal-override:
-  type: object
+seasonal-override-request:
+  <<: *time-bound-static-rating
   description: |
     Data structure for a seasonal override against a resource.
-    Includes a unique ID, start and (optional) end time, and a reason.  
-
     Must also include a set of values.  
-  allOf:
-    - $ref: '#/seasonal-override-request'
-    - type: object
-      properties:
-        id:
-          $ref: ./server-generated-id.yaml
-      required:
-        - id
+
+seasonal-override:
+  <<: *time-bound-static-limit
+  description: |
+    Data structure for a seasonal override against a resource.  Includes a
+    unique ID, start and (optional) end time, and a reason.  Must also include a
+    set of values.

docs/example-narratives/examples/forecast-limits-detailed.json

@@ -1,7 +1,7 @@
 {
     "snapshot-header": {
         "begins": "2023-07-12T16:00:00-07:00",        
-        "snapshot-provenance": {
+        "source": {
             "provider":"X-AMPL-RC",
             "last-updated": "2023-07-12T16:00:00-07:00",
             "origin-id": "//trolie.example.com/snapshots/2024-08-05T11%3a00%3a00-07%3a00"

docs/example-narratives/examples/forecast-limits-slim-active-power.json

@@ -2,7 +2,7 @@
     "snapshot-header": {
         "begins": "2023-07-12T16:00:00-07:00",
         "ends": "2023-07-12T18:00:00-07:00",
-        "snapshot-provenance": {
+        "source": {
             "provider":"X-AMPL",
             "last-updated": "2023-07-12T16:00:00-07:00",
             "origin-id": "//trolie.example.com/snapshots/2024-08-05T11%3a00%3a00-07%3a00"

docs/example-narratives/examples/forecast-limits.json

@@ -1,7 +1,7 @@
 {
     "snapshot-header": {
         "begins": "2023-07-12T16:00:00-07:00",
-        "snapshot-provenance": {
+        "source": {
             "provider":"X-AMPL",
             "last-updated": "2023-07-12T16:00:00-07:00",
             "origin-id": "//trolie.example.com/snapshots/2024-08-05T11%3a00%3a00-07%3a00"

docs/example-narratives/examples/forecast-ratings-proposal-status-complete.json

@@ -1,5 +1,5 @@
 {
-  "forecast-provider": {
+  "source": {
     "provider": "UTILITY-A",
     "last-updated": "2023-07-12T15:05:43.044267100-07:00",
     "origin-id": "5aeacb25-9b65-4738-8a00-ac10afa63640"

docs/example-narratives/examples/forecast-ratings-proposal-status.json

@@ -1,5 +1,5 @@
 {
-  "forecast-provider": {
+  "source": {
     "provider": "UTILITY-A",
     "last-updated": "2023-07-12T15:05:43.044267100-07:00",
     "origin-id": "5aeacb25-9b65-4738-8a00-ac10afa63640"

docs/example-narratives/examples/realtime-limit-set-detailed.json

@@ -1,6 +1,6 @@
 {
   "snapshot-header": {
-    "snapshot-provenance": {
+    "source": {
       "provider": "X-AMPL-RC",
       "last-updated": "2023-07-12T15:05:43.044267100-07:00",
       "origin-id": "//trolie.example.com/snapshots/2024-08-05T11%3a00%3a00-07%3a00"

docs/example-narratives/examples/realtime-limit-set-slim.json

@@ -1,6 +1,6 @@
 {
     "snapshot-header": {
-        "snapshot-provenance": {
+        "source": {
             "provider": "X-AMPL",
             "last-updated": "2023-07-12T15:05:43.044267100-07:00",
             "origin-id": "//trolie.example.com/snapshots/2024-08-05T11%3a00%3a00-07%3a00"

docs/example-narratives/examples/realtime-limit-set.json

@@ -1,6 +1,6 @@
 {
     "snapshot-header": {
-        "snapshot-provenance": {
+        "source": {
             "provider":"X-AMPL",
             "last-updated": "2023-07-12T15:05:43.044267100-07:00",
             "origin-id": "//trolie.example.com/snapshots/2024-08-05T11%3a00%3a00-07%3a00"

docs/example-narratives/examples/realtime-proposal-status-complete.json

@@ -1,5 +1,5 @@
 {
-  "ratings-provider": {
+  "source": {
     "provider": "UTILITY-A",
     "last-updated": "2023-07-12T15:05:43.044267100-07:00",
     "origin-id": "5aeacb25-9b65-4738-8a00-ac10afa63640"

docs/example-narratives/examples/realtime-proposal-status.json

@@ -1,5 +1,5 @@
 {
-  "ratings-provider": {
+  "source": {
     "provider": "UTILITY-A",
     "last-updated": "2023-07-12T15:05:43.044267100-07:00",
     "origin-id": "5aeacb25-9b65-4738-8a00-ac10afa63640"

docs/example-narratives/examples/seasonal-override-get.json

@@ -1,5 +1,5 @@
 {
-  "provenance": {
+  "source": {
     "provider":"X-AMPL",
     "last-updated": "2023-07-12T15:05:43.044267100-07:00",
     "origin-id": "//trolie.example.com/seasonal-overrides/513a7cb3-5d3c-4b7e-849c-e4015846db53"
@@ -25,18 +25,18 @@
     "mva": 160
   },
   "emergency-operating-limits": [
-    { 
+    {
       "duration-name": "emergency",
       "limit": {
         "mva": 165
       }
     },
-    { 
+    {
       "duration-name": "load-shed",
       "limit": {
         "mva": 170
       }
-    }     
+    }
   ],
   "reason": "Increased vegetation proximity"
-}
+}

docs/example-narratives/examples/seasonal-override-list.json

@@ -1,6 +1,6 @@
 [
   {
-    "provenance": {
+    "source": {
       "provider":"X-AMPL",
       "last-updated": "2023-07-12T15:05:43.044267100-07:00",
       "origin-id": "//trolie.example.com/seasonal-overrides/513a7cb3-5d3c-4b7e-849c-e4015846db53"
@@ -26,19 +26,19 @@
       "mva": 160
     },
     "emergency-operating-limits": [
-      { 
+      {
         "duration-name": "emergency",
         "limit": {
           "mva": 165
         }
       },
-      { 
+      {
         "duration-name": "load-shed",
         "limit": {
           "mva": 170
         }
-      }     
+      }
     ],
     "reason": "Increased vegetation proximity"
   }
-]
+]

docs/example-narratives/examples/seasonal-override-post.json

@@ -1,4 +1,9 @@
 {
+  "source": {
+    "provider":"X-AMPL",
+    "last-updated": "2023-07-12T15:05:43.044267100-07:00",
+    "origin-id": "513a7cb3-5d3c-4b7e-849c-e4015846db53"
+  },
   "resource": {
     "resource-id": "8badf00d",
     "alternate-identifiers": [
@@ -19,18 +24,18 @@
     "mva": 160
   },
   "emergency-operating-limits": [
-    { 
+    {
       "duration-name": "emergency",
       "limit": {
         "mva": 165
       }
     },
-    { 
+    {
       "duration-name": "load-shed",
       "limit": {
         "mva": 170
       }
-    }     
+    }
   ],
   "reason": "Increased vegetation proximity"
-}
+}