simplify

Co-authored-by: Copilot <copilot@github.com>

Author: Julusian

apps/package-manager-api/asyncapi/asyncapi.yaml

@@ -104,8 +104,6 @@ operations:
     $ref: './operations/from-consumer.yaml#/sendPackageContainerRemoved'
 
   # Consumer receives from PM
-  receiveExpectationStatusAdded:
-    $ref: './operations/from-consumer.yaml#/receiveExpectationStatusAdded'
   receiveExpectationStatusUpdated:
     $ref: './operations/from-consumer.yaml#/receiveExpectationStatusUpdated'
   receiveExpectationStatusRemoved:

apps/package-manager-api/asyncapi/channels/from-pm.yaml

@@ -10,12 +10,10 @@ workStatuses:
   address: workStatuses
   title: Work Statuses Channel
   description: >
-    The Package Manager sends CRUD-delta events for ExpectationStatus objects
-    over this channel. The consumer maintains a live view of all expectation statuses,
-    keyed by ExpectationId.
+    The Package Manager sends upsert and removed events for ExpectationStatus
+    objects over this channel. The consumer maintains a live view of all
+    expectation statuses, keyed by ExpectationId.
   messages:
-    ExpectationStatusAdded:
-      $ref: '../components/messages/from-pm-messages.yaml#/ExpectationStatusAdded'
     ExpectationStatusUpdated:
       $ref: '../components/messages/from-pm-messages.yaml#/ExpectationStatusUpdated'
     ExpectationStatusRemoved:

apps/package-manager-api/asyncapi/components/messages/from-pm-messages.yaml

@@ -1,7 +1,7 @@
 # Messages sent FROM the Package Manager TO the consumer.
 #
-# Three event channels (CRUD deltas) plus two event channels for package-info:
-#   - workStatuses        (ExpectationStatus CRUD, keyed by ExpectationId)
+# Three event channels plus two event channels for package-info:
+#   - workStatuses        (ExpectationStatus upsert/remove, keyed by ExpectationId)
 #   - containerStatuses   (PackageContainerStatus update/remove)
 #   - containerPackageStatuses (PackageContainerPackageStatus update/remove)
 #   - packageInfo         (PackageInfo update/remove — fire and forget)
@@ -12,28 +12,10 @@
 # ---------------------------------------------------------------------------
 # workStatuses channel messages
 # ---------------------------------------------------------------------------
-ExpectationStatusAdded:
-  name: ExpectationStatusAdded
-  title: Expectation Status Added
-  summary: Status reporting has started for a new Expectation.
-  contentType: application/json
-  payload:
-    type: object
-    required:
-      - event
-      - status
-    properties:
-      event:
-        type: string
-        const: added
-      status:
-        $ref: '../schemas/statuses.yaml#/ExpectationStatus'
-    additionalProperties: false
-
 ExpectationStatusUpdated:
   name: ExpectationStatusUpdated
   title: Expectation Status Updated
-  summary: The status of an Expectation has changed (state, progress, reason, etc.).
+  summary: Upsert the status of an Expectation. The consumer creates or replaces the stored status keyed by ExpectationId.
   contentType: application/json
   payload:
     type: object

apps/package-manager-api/asyncapi/operations/from-consumer.yaml

@@ -39,21 +39,13 @@ sendPackageContainerRemoved:
   summary: The consumer notifies the PM that a PackageContainerExpectation has been removed.
 
 # The consumer receives status events from the PM:
-receiveExpectationStatusAdded:
-  action: receive
-  channel:
-    $ref: '../channels/from-pm.yaml#/workStatuses'
-  messages:
-    - $ref: '../channels/from-pm.yaml#/workStatuses/messages/ExpectationStatusAdded'
-  summary: The consumer receives a new ExpectationStatus from the PM.
-
 receiveExpectationStatusUpdated:
   action: receive
   channel:
     $ref: '../channels/from-pm.yaml#/workStatuses'
   messages:
     - $ref: '../channels/from-pm.yaml#/workStatuses/messages/ExpectationStatusUpdated'
-  summary: The consumer receives an updated ExpectationStatus from the PM.
+  summary: The consumer upserts (creates or replaces) an ExpectationStatus from the PM.
 
 receiveExpectationStatusRemoved:
   action: receive

apps/package-manager-api/asyncapi/operations/from-pm.yaml

@@ -40,21 +40,13 @@ receivePackageContainerRemoved:
   summary: PM receives notification that a PackageContainerExpectation has been removed.
 
 # PM sends status events to the consumer:
-sendExpectationStatusAdded:
-  action: send
-  channel:
-    $ref: '../channels/from-pm.yaml#/workStatuses'
-  messages:
-    - $ref: '../channels/from-pm.yaml#/workStatuses/messages/ExpectationStatusAdded'
-  summary: PM notifies the consumer of a new ExpectationStatus.
-
 sendExpectationStatusUpdated:
   action: send
   channel:
     $ref: '../channels/from-pm.yaml#/workStatuses'
   messages:
     - $ref: '../channels/from-pm.yaml#/workStatuses/messages/ExpectationStatusUpdated'
-  summary: PM notifies the consumer of an updated ExpectationStatus.
+  summary: PM upserts an ExpectationStatus on the consumer (create or replace).
 
 sendExpectationStatusRemoved:
   action: send