diff --git a/docs/script-budget-history/2026-11-11-pr1621-held-clinical-review-fixes.md b/docs/script-budget-history/2026-11-11-pr1621-held-clinical-review-fixes.md
new file mode 100644
index 000000000..9977812a8
--- /dev/null
+++ b/docs/script-budget-history/2026-11-11-pr1621-held-clinical-review-fixes.md
@@ -0,0 +1,11 @@
+# 11 Nov 2026, Held clinical review fixes (PR #1621)
+
+Changed on top of `main` at `5b08a5e`: Home `/ward-flow` raised 575.4 to 575.7; referrals `/ward-flow/referrals` raised 583.6 to 583.9; ward `/ward-flow/ward/rph-adult-secure` raised 613.8 to 614.1; capacity `/ward-flow/capacity` raised 654.3 to 654.7. Each raise is under 1 KB, within the 5 KB per-screen allowance in HOW-WE-WORK section 6.
+
+Measured on hosted CI (production build of the PR head `eda932a`, merged with main): Home 575.4 KB, referrals 583.6 KB, ward 613.8 KB, capacity 654.4 KB, each over its limit after rounding. Main alone measured 575.2, 583.5, 613.6 and 654.1. Each new limit is the measurement plus about 0.3.
+
+Why it changed: the shared bed-forecast code that these routes load grew by 0.1 to 0.3 KB gzipped. Planned admissions now skip a patient who already holds a named bed (`patientsHoldingANamedBed`), and the ED long-wait check moved into one shared `isLongWait` helper (D-145 item 1).
+
+Trim tried: the forecast is already part of each route's first load and the added code is the fix itself, so lazy loading would save nothing. No other safe trim was found.
+
+Later the same day (PR head `65ea28a`, merged with main `c339231`): ED `/ward-flow/ed` raised 535.4 to 535.7. Hosted CI measured 535.4 KB against main alone 535.2 KB; the same shared `isLongWait` helper and named-bed check account for the 0.2 KB. Same trim reasoning as above.
diff --git a/docs/ward-flow/journey/MAP-INVENTORY.md b/docs/ward-flow/journey/MAP-INVENTORY.md
index 5bf83b42e..e03ee3f2c 100644
--- a/docs/ward-flow/journey/MAP-INVENTORY.md
+++ b/docs/ward-flow/journey/MAP-INVENTORY.md
@@ -3,7 +3,7 @@
 The route is selective. Its action notes and the additional command models have source review evidence; source digests detect later edits. This does not establish runtime or clinical acceptance.
 
 ## 193 CURRENT ENGINE EVENTS
-Source-contract SHA256: e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e18616914ab6
+Source-contract SHA256: 058aeabf4009259104c6d772f6126c1c9d7fb94286b54b256eda1dd711025423
 - RECORD_ADMISSION_CARE — diagram-reviewed; event roles: ward, coordinator, community
   Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance.
   Permission source: src/components/ward-management/ward-flow-event-roles.ts:20
@@ -1693,7 +1693,7 @@ Source-contract SHA256: e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e186
 - BOOK_PLANNED_ADMISSION — modelled; event roles: coordinator, bed_manager, ward
   Reviewed command model: New PA-* record in booked state, holding no bed.
   Permission source: src/components/ward-management/ward-flow-event-roles.ts:613
-  Event/dispatch reference: src/components/ward-management/capacity/planned-admissions-reducer.ts:74
+  Event/dispatch reference: src/components/ward-management/capacity/planned-admissions-reducer.ts:78
   Event/dispatch reference: src/components/ward-management/ward-flow-reducer.ts:2340
   Subject: A future planned admission
   Before: No booking for this linked patient, or an initials-only booking to create
@@ -1710,14 +1710,14 @@ Source-contract SHA256: e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e186
   effects: Stores a required same-ward authorisation override. No bed count or admission changes until conversion; initials invoke the typed-text persistence boundary.
   tests: tests/ward-planned-admissions.test.ts
   tests: tests/ward-audit24-1-planned-booking-authorised.test.ts
-  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:299; SHA256 fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3
-  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:263; SHA256 fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3
+  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:334; SHA256 d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df
+  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:298; SHA256 d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df
   Reviewed source: src/components/ward-management/ward-flow-events.ts:2431; SHA256 378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf
   Reviewed source: src/components/ward-management/ward-access-state.ts:659; SHA256 924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07
 - CHANGE_PLANNED_ADMISSION — modelled; event roles: coordinator, bed_manager, ward
   Reviewed command model: Still booked, with revised fields, changedAt and incremented changeCount.
   Permission source: src/components/ward-management/ward-flow-event-roles.ts:614
-  Event/dispatch reference: src/components/ward-management/capacity/planned-admissions-reducer.ts:388
+  Event/dispatch reference: src/components/ward-management/capacity/planned-admissions-reducer.ts:423
   Event/dispatch reference: src/components/ward-management/ward-flow-reducer.ts:2345
   Subject: An existing booked planned admission
   Before: booked plan with current ward/date/stay/reason/legal status/gender
@@ -1735,14 +1735,14 @@ Source-contract SHA256: e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e186
   effects: Replaces planning fields, records changedAt/count and record-derived linked gender. No bed is held or released.
   tests: tests/ward-planned-admissions.test.ts
   tests: tests/ward-audit24-1-planned-booking-authorised.test.ts
-  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:383; SHA256 fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3
-  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:263; SHA256 fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3
+  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:418; SHA256 d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df
+  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:298; SHA256 d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df
   Reviewed source: src/components/ward-management/ward-flow-events.ts:2488; SHA256 378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf
   Reviewed source: src/components/ward-management/ward-access-state.ts:659; SHA256 924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07
 - CANCEL_PLANNED_ADMISSION — modelled; event roles: coordinator, bed_manager, ward
   Reviewed command model: cancelled with cancel reason and time.
   Permission source: src/components/ward-management/ward-flow-event-roles.ts:615
-  Event/dispatch reference: src/components/ward-management/capacity/planned-admissions-reducer.ts:464
+  Event/dispatch reference: src/components/ward-management/capacity/planned-admissions-reducer.ts:499
   Event/dispatch reference: src/components/ward-management/ward-flow-reducer.ts:2350
   Subject: One booked planned admission
   Before: booked
@@ -1755,13 +1755,13 @@ Source-contract SHA256: e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e186
   effects: No capacity refund occurs because booking held no bed. Cancelled plans no longer count as pending arrivals.
   effects: The step can be taken back by UNDO_RELEASE_STEP within the Undo window, filed against the booking.
   tests: tests/ward-planned-admissions.test.ts
-  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:459; SHA256 fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3
+  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:494; SHA256 d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df
   Reviewed source: src/components/ward-management/ward-flow-events.ts:2488; SHA256 378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf
   Reviewed source: src/components/ward-management/ward-access-state.ts:659; SHA256 924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07
 - CONVERT_PLANNED_ADMISSION — modelled; event roles: ward, coordinator
   Reviewed command model: Plan arrived and linked to a new occupied admission.
   Permission source: src/components/ward-management/ward-flow-event-roles.ts:616
-  Event/dispatch reference: src/components/ward-management/capacity/planned-admissions-reducer.ts:488
+  Event/dispatch reference: src/components/ward-management/capacity/planned-admissions-reducer.ts:523
   Event/dispatch reference: src/components/ward-management/ward-flow-reducer.ts:743
   Subject: A booked plan and its receiving ward
   Before: booked plan, no current linked bed/journey, ready eligible capacity
@@ -1777,7 +1777,7 @@ Source-contract SHA256: e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e186
   effects: Marks plan arrived with convertedAt/admissionId; does not create a numbered bed assignment or admit merely because its date passed.
   tests: tests/ward-planned-admissions.test.ts
   tests: tests/ward-planned-arrival-closed-bed.test.ts
-  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:483; SHA256 fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3
+  Reviewed source: src/components/ward-management/capacity/planned-admissions-reducer.ts:518; SHA256 d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df
   Reviewed source: src/components/ward-management/ward-flow-events.ts:2516; SHA256 378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf
   Reviewed source: src/components/ward-management/ward-access-state.ts:659; SHA256 924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07
 - RECORD_SUPPORT_NOTIFICATION — modelled; event roles: ward, coordinator
diff --git a/docs/ward-flow/journey/event-dispositions.json b/docs/ward-flow/journey/event-dispositions.json
index 4c76c503a..d55c76df1 100644
--- a/docs/ward-flow/journey/event-dispositions.json
+++ b/docs/ward-flow/journey/event-dispositions.json
@@ -2310,13 +2310,13 @@
       "sources": [
         {
           "path": "src/components/ward-management/capacity/planned-admissions-reducer.ts",
-          "line": 299,
-          "sha256": "fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"
+          "line": 334,
+          "sha256": "d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"
         },
         {
           "path": "src/components/ward-management/capacity/planned-admissions-reducer.ts",
-          "line": 263,
-          "sha256": "fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"
+          "line": 298,
+          "sha256": "d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"
         },
         {
           "path": "src/components/ward-management/ward-flow-events.ts",
@@ -2361,13 +2361,13 @@
       "sources": [
         {
           "path": "src/components/ward-management/capacity/planned-admissions-reducer.ts",
-          "line": 383,
-          "sha256": "fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"
+          "line": 418,
+          "sha256": "d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"
         },
         {
           "path": "src/components/ward-management/capacity/planned-admissions-reducer.ts",
-          "line": 263,
-          "sha256": "fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"
+          "line": 298,
+          "sha256": "d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"
         },
         {
           "path": "src/components/ward-management/ward-flow-events.ts",
@@ -2408,8 +2408,8 @@
       "sources": [
         {
           "path": "src/components/ward-management/capacity/planned-admissions-reducer.ts",
-          "line": 459,
-          "sha256": "fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"
+          "line": 494,
+          "sha256": "d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"
         },
         {
           "path": "src/components/ward-management/ward-flow-events.ts",
@@ -2450,8 +2450,8 @@
       "sources": [
         {
           "path": "src/components/ward-management/capacity/planned-admissions-reducer.ts",
-          "line": 483,
-          "sha256": "fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"
+          "line": 518,
+          "sha256": "d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"
         },
         {
           "path": "src/components/ward-management/ward-flow-events.ts",
diff --git a/docs/ward-flow/journey/machines.json b/docs/ward-flow/journey/machines.json
index 2fcdf924c..8d07b6c2b 100644
--- a/docs/ward-flow/journey/machines.json
+++ b/docs/ward-flow/journey/machines.json
@@ -1738,8 +1738,8 @@
     "sources": [
       {
         "path": "src/components/ward-management/capacity/planned-admissions-reducer.ts",
-        "line": 584,
-        "sha256": "fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"
+        "line": 619,
+        "sha256": "d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"
       },
       {
         "path": "src/components/ward-management/legal-forms/legal-forms-screen.tsx",
diff --git a/docs/ward-flow/journey/ward-journey-explorer.html b/docs/ward-flow/journey/ward-journey-explorer.html
index 70659ed84..ff09285b0 100644
--- a/docs/ward-flow/journey/ward-journey-explorer.html
+++ b/docs/ward-flow/journey/ward-journey-explorer.html
@@ -1284,7 +1284,7 @@ <h3>What to do here</h3>
 
     <!-- prettier-ignore -->
     <script>
-      const DATA = {"vocab":{"vocabularies":{"DECLINE_REASONS":{"file":"ward-model.ts","members":["no_suitable_bed","age_band_not_provided_here","sex_designation_unavailable","secure_bed_unavailable","belongs_to_another_service","referred_elsewhere","specialling_unavailable","acuity_mix","capability_mismatch","bed_pulled_for_earlier_referral","another_reason"]},"SUPPORT_SERVICE_TYPES":{"file":"ward-model-bed-release.ts","members":["pharmacy","transport","cleaning"]},"ARRIVAL_CHECKS":{"file":"ward-model-bed-release.ts","members":["contraband_search","medication_chart"]},"BED_RELEASE_STATES":{"file":"ward-model-bed-release.ts","members":["expected","confirmed","discharged"]},"BED_RELEASE_WAITING_ON":{"file":"ward-model-bed-release.ts","members":["Awaiting ward round","Awaiting family or carer agreement","Awaiting accommodation","Awaiting community team acceptance","Awaiting legal or Mental Health Act process","Awaiting transport","Nothing outstanding"]},"HEALTH_SERVICES":{"file":"ward-model-vocabulary.ts","members":["North Metro","South Metro","East Metro","WACHS","CAHS","Private"]},"COHORTS":{"file":"ward-model-vocabulary.ts","members":["Adult","Older adult","Youth"]},"BLOCKERS_MEANING_NOTHING_IS_BLOCKING":{"file":"ward-model-vocabulary.ts","members":["No blocker","None — in transit","None — handover complete","None — the movement did not proceed","None — cleared"]},"SEXES":{"file":"ward-model-vocabulary.ts","members":["Female","Male"]},"RECORDED_SEXES":{"file":"ward-model-vocabulary.ts","members":["Another term","Not recorded"]},"URGENCY_LEVELS":{"file":"ward-model-vocabulary.ts","members":["1","2","3"]},"ATS_CATEGORIES":{"file":"ward-model-vocabulary.ts","members":["1","2","3","4","5"]},"TRAVEL_MODES":{"file":"ward-model-vocabulary.ts","members":["Ambulance (St John)","Mental Health Transport","Patient transport service","RFDS","Police escort","Ward escort","Family or carer"]},"ARRIVAL_MODES":{"file":"ward-model-vocabulary.ts","members":["ambulance","mental_health_transport","hospital_transfer","rfds","police","ward_escort","self"]},"UPLOADED_FILE_TYPES":{"file":"ward-model-vocabulary.ts","members":["PDF","JPEG","PNG","Other"]},"SEX_DESIGNATIONS":{"file":"ward-model-vocabulary.ts","members":["Undesignated","Female only","Male only"]},"REFERRAL_GENDERS":{"file":"ward-model-vocabulary.ts","members":["Female","Male","Non-binary","Different term"]},"MOVEMENT_STAGES":{"file":"ward-model-vocabulary.ts","members":["placement_requested","destination_review","accepted_awaiting_bed","pulled","handover_ready","moving","arrived"]},"STEP_BACK_REASONS":{"file":"ward-model-vocabulary.ts","members":["recorded_in_error","the_decision_changed","the_patient_situation_changed","the_bed_was_lost"]},"PAPER_EXPIRY_CORRECTION_REASONS":{"file":"ward-model-vocabulary.ts","members":["transcription_error","paper_rechecked"]},"LEGAL_FORM_MAKER_ROLES":{"file":"ward-model-vocabulary.ts","members":["medical_practitioner","amhp","psychiatrist","mental_health_practitioner","person_in_charge"]},"LEGAL_FORM_COPY_STATES":{"file":"ward-model-vocabulary.ts","members":["yes","declined","not_yet"]},"LEGAL_FORM_ENDINGS":{"file":"ward-model-vocabulary.ts","members":["revoked","form_3e","replaced","ended_as_typed"]},"LEGAL_FORM_CONSENT_STATES":{"file":"ward-model-vocabulary.ts","members":["yes","not_yet"]},"TRANSPORT_PROVIDERS":{"file":"ward-model-movement-parts.ts","members":["Ambulance service"]},"TRANSPORT_LEGAL_STATUSES":{"file":"ward-model-movement-parts.ts","members":["voluntary","involuntary"]},"TRANSPORT_EXCEPTION_GAPS":{"file":"ward-model-movement-parts.ts","members":["legal_status_differs","transport_order_missing","fit_to_travel_missing"]},"TRANSPORT_EXCEPTION_REASONS":{"file":"ward-model-movement-parts.ts","members":["paper_sighted","treating_team_confirmed","urgent_to_follow"]},"MOVEMENT_REFERRAL_ABSENCE_REASONS":{"file":"ward-model-movement-parts.ts","members":["none_raised","not_asked"]},"EXAMINATION_OUTCOMES":{"file":"ward-model-movement-parts.ts","members":["inpatient_order","community_order","revoked","further_examination_ordered"]},"PSYCH_REVIEW_GRADES":{"file":"ward-model-movement-parts.ts","members":["registrar","consultant"]},"ED_OUTCOMES":{"file":"ward-model-movement-parts.ts","members":["for_discharge","for_community_follow_up"]},"REFERRAL_SOURCES":{"file":"ward-model-referral-parts.ts","members":["community","crisis_service","ambulance","inter_hospital","ed_medical","gp","psychiatric_ward"]},"REFERRAL_STATES":{"file":"ward-model-referral-parts.ts","members":["queued","accepted","declined"]},"COMMUNITY_DECLINE_REASONS":{"file":"ward-model-referral-parts.ts","members":["outside_the_teams_catchment","needs_inpatient_care_not_community_follow_up","client_declined_or_could_not_be_contacted","already_open_to_another_community_team"]},"HOME_REGIONS":{"file":"ward-model-referral-parts.ts","members":["Perth Metropolitan","Peel","South West","Great Southern","Wheatbelt","Goldfields-Esperance","Mid West","Gascoyne","Pilbara","Kimberley"]},"REFERRAL_DESTINATION_KINDS":{"file":"ward-model-referral-parts.ts","members":["psychiatric_ward","emergency_department","community_team"]},"REFERRAL_PURPOSES":{"file":"ward-model-referral-parts.ts","members":["bed","psychiatric_review","medical_assessment"]},"COMMUNITY_REFERRAL_PURPOSES":{"file":"ward-model-referral-parts.ts","members":["follow_up","assess_for_admission"]},"REFERRAL_ADDRESSING_STATES":{"file":"ward-model-referral-parts.ts","members":["queued","accepted","declined","cancelled"]},"SUBURB_UNKNOWN_REASONS":{"file":"ward-model-referral-parts.ts","members":["not_known"]},"ABSENCE_STEPS":{"file":"ward-model-leave.ts","members":["searched","psychiatrist_told","return_order_made","description_recorded","police_notified","next_of_kin_told"]},"URGENCY_CHANGE_REASONS":{"file":"ward-change-reasons.ts","members":["reassessed","new_information","correcting_an_error"]},"LEGAL_STATUS_CHANGE_REASONS":{"file":"ward-change-reasons.ts","members":["recorded_by_treating_team","correcting_an_error"]},"LEGAL_FORM_RECEIPT_CORRECTION_REASONS":{"file":"ward-change-reasons.ts","members":["recorded_in_error","recorded_against_wrong_movement","form_had_not_physically_arrived"]},"RELEASE_PULL_REASONS":{"file":"ward-change-reasons.ts","members":["patient_no_longer_coming","bed_needed_for_another_patient","ward_withdrew_the_bed","pull_made_in_error"]},"CANCEL_TRANSPORT_REASONS":{"file":"ward-change-reasons.ts","members":["provider_unavailable","patient_not_ready","destination_changed","job_created_in_error"]},"STOP_TRANSPORT_REASONS":{"file":"ward-change-reasons.ts","members":["The examination was revoked","The referral was withdrawn","The receiving ward can no longer take the patient","Absconded in transit, whereabouts unknown"]},"TRANSPORT_WHEREABOUTS":{"file":"ward-change-reasons.ts","members":["Back at the sending emergency department","At another emergency department","At a general hospital","With the transport crew","Another place — needs follow-up"]},"DIVERSION_REASONS":{"file":"ward-change-reasons.ts","members":["Needs urgent medical care on the way","The vehicle or crew was sent to an emergency","The receiving ward can no longer take the patient","Another reason — needs follow-up"]},"ESCALATION_CONTACTS":{"file":"ward-change-reasons.ts","members":["State bed coordination desk","Duty psychiatrist","Bed management","Nurse unit manager (destination ward)","Escort or transport provider","Other service"]},"BED_RELEASE_BLOCKERS":{"file":"ward-change-reasons.ts","members":["Awaiting clean","Awaiting pharmacy","Awaiting placement confirmation","Awaiting service coordination","Awaiting accommodation","Awaiting transport","Awaiting receiving-service acceptance","Awaiting family or carer arrangement","Funding or plan decision pending"]},"WITHDRAWAL_REASONS":{"file":"ward-change-reasons.ts","members":["another_unit_accepted","referrer_withdrew","coordinator_withdrew","ed_outcome_recorded"]},"WARD_REQUEST_WITHDRAWAL_REASONS":{"file":"ward-change-reasons.ts","members":["no_answer_from_the_ward","bed_no_longer_available","needs_changed_ward_no_longer_suits","closer_to_home_or_family_elsewhere","making_room_within_the_referral_limit","referred_in_error","another_reason"]},"OVERRIDE_REASONS":{"file":"ward-change-reasons.ts","members":["The receiving team has agreed despite the mismatch","Clinical urgency outweighs the mismatch","The bed information is known to be out of date","Continuity with a previous admission at this unit","Closer to the person's home or family"]},"REFERRAL_CAP_REASONS":{"file":"ward-change-reasons.ts","members":["No answer yet from the wards already asked","Clinical urgency needs a wider search","The wards already asked are unlikely to have a bed soon"]},"NOT_ON_SENDING_WARD_REASONS":{"file":"ward-change-reasons.ts","members":["Recently discharged from this ward","Known to this ward's team but not in a bed"]},"BED_PREPARATION_NOTES":{"file":"ward-change-reasons.ts","members":["Being cleaned","Awaiting maintenance or repair"]},"GENDER_PLACEMENT_REASONS":{"file":"ward-change-reasons.ts","members":["A single room is available on this ward","The patient's stated preference, agreed with the ward","No single room is free; the ward agreed a bed and a plan for privacy","The only suitable Ready bed, agreed with the ward","The patient knows this ward from an earlier stay","Closer to the patient's home or supports"]},"URGENT_MARK_REASONS":{"file":"ward-change-reasons.ts","members":["cannot_safely_prevent_leaving","cannot_be_observed_safely_here","safety_of_others_in_this_setting","no_psychiatric_cover_at_this_site","needs_medical_care_unavailable_here","escort_in_place_and_unsustainable","cannot_protect_from_others_here","setting_unsuitable_for_age_group","this_setting_cannot_continue_current_care","another_reason_not_listed"]},"WARD_INTAKE_CONSTRAINTS":{"file":"ward-change-reasons.ts","members":["staffing_shortage","infection_control","bay_or_room_closed","high_acuity_on_ward","waiting_for_bed_clean","other_call_the_ward"]},"DISCHARGE_DELAY_CLEAR_REASONS":{"file":"ward-change-reasons.ts","members":["resolved_clinically","package_confirmed","accommodation_secured","transport_arranged","family_carer_ready","entered_in_error","other"]},"ADMISSION_STATES":{"file":"ward-admissions.ts","members":["waitlisted","pulled","occupied","departed"]},"FOLLOW_UP_STATES":{"file":"ward-admissions.ts","members":["arranged","not_arranged"]},"DISCHARGE_BARRIERS":{"file":"ward-admissions.ts","members":["Accommodation / Housing","NDIS","SAT / Public Guardian","RACF / Aged Care","Clinical / Treatment","Social / Family","Several"]},"DISCHARGE_ROLE_LABELS":{"file":"ward-admissions.ts","members":["Nurse in charge"]},"PLANNED_ADMISSION_REASONS":{"file":"ward-admissions.ts","members":["court_ordered","planned_ect","respite","planned_transfer","other"]},"PLANNED_ADMISSION_CANCEL_REASONS":{"file":"ward-admissions.ts","members":["no_longer_needed","admitted_elsewhere","rebooked","booked_in_error"]},"PLANNED_ADMISSION_STATES":{"file":"ward-admissions.ts","members":["booked","cancelled","arrived"]},"RELEASE_BANDS":{"file":"ward-bed-availability.ts","members":["now","by-midday","by-1600","tonight","tomorrow"]},"GENDERS":{"file":"ward-patients.ts","members":["Female","Male","Non-binary","Different term"]},"PATIENT_FIELDS":{"file":"ward-patients.ts","members":["id","umrn","givenName","familyName","dateOfBirth","preferredName","sex","gender","address","suburb","generalPractitioner","catchmentCommunityTeam","legalStatus","aboriginalOrTorresStraitIslanderStatus","interpreterLanguage","communityTreatmentOrder","addedAt","registrationScope","mobilePhone","otherPhone","email","postcode","nextOfKinName","nextOfKinRelationship","nextOfKinPhone","supportPersonRole","supportPersonName","supportPersonPhone","medicareNumber","medicareReference","medicareExpiry","dvaFileNumber","healthFund","concessionCard","gpPhone","countryOfBirth","interpreterRequired","maritalStatus","advanceHealthDirective","enduringGuardian","carePlans","tribunalHearing","culturalSupportRequested"]},"ELIGIBILITY_GATES":{"file":"ward-eligibility.ts","members":["acuity","age","allocatable_bed","authorisation","capacity_freshness","cohort","forensic","legal_status","prior_decline","security","gender_designation","sex_mix","specialling"]},"CARE_PLAN_TYPES":{"file":"ward-patient-care-plans.ts","members":["Crisis/safety plan","Frequent presenter plan","Community care plan","Other"]},"CARE_PLAN_HELPS":{"file":"ward-patient-care-plans.ts","members":["Quiet space","Known staff member","Family or carer involved early","Clear plan explained","Interpreter","Cultural support","Contact the community team"]},"TRIBUNAL_OUTCOMES":{"file":"ward-patient-care-plans.ts","members":["Held","Adjourned","Cancelled"]},"CULTURAL_SUPPORT_REQUESTS":{"file":"ward-patient-care-plans.ts","members":["Aboriginal liaison officer","Other cultural support"]}},"labels":{"stepBackReasonLabels":{"recorded_in_error":"Recorded in error","the_decision_changed":"The decision changed","the_patient_situation_changed":"The situation changed","the_bed_was_lost":"The bed was lost"},"suburbUnknownLabels":{"not_known":"Suburb not known"},"legalFormReceiptCorrectionReasonLabels":{"recorded_in_error":"Recorded in error","recorded_against_wrong_movement":"Recorded against the wrong movement","form_had_not_physically_arrived":"Form had not physically arrived"},"withdrawalReasonLabels":{"another_unit_accepted":"Withdrawn — another unit accepted this patient.","referrer_withdrew":"Withdrawn by the referrer.","coordinator_withdrew":"Withdrawn by the coordinator.","ed_outcome_recorded":"Withdrawn — the department recorded an outcome for this patient."},"wardRequestWithdrawalReasonLabels":{"no_answer_from_the_ward":"No answer from the ward yet","bed_no_longer_available":"The bed is no longer available","needs_changed_ward_no_longer_suits":"Needs have changed; this ward no longer suits","closer_to_home_or_family_elsewhere":"Closer to home or family elsewhere","making_room_within_the_referral_limit":"Making room within the referral limit","referred_in_error":"Referred in error","another_reason":"Another reason — needs follow-up"},"changeReasonLabels":{"cannot_be_observed_safely_here":"Cannot be observed safely here","no_psychiatric_cover_at_this_site":"No psychiatric cover at this site","cannot_safely_prevent_leaving":"Cannot safely prevent leaving","needs_medical_care_unavailable_here":"Needs medical care unavailable here","safety_of_others_in_this_setting":"Safety of others in this setting","escort_in_place_and_unsustainable":"Escort in place and unsustainable","cannot_protect_from_others_here":"Cannot protect from harm by others here","setting_unsuitable_for_age_group":"No age-appropriate area here","this_setting_cannot_continue_current_care":"This setting cannot continue current care","another_reason_not_listed":"Another reason, not listed here","reassessed":"Reassessed","new_information":"New information","correcting_an_error":"Correcting an error","not_given":"No reason given","recorded_by_treating_team":"Recorded by treating team","patient_no_longer_coming":"No longer coming","bed_needed_for_another_patient":"Bed needed elsewhere","ward_withdrew_the_bed":"Ward withdrew the bed","pull_made_in_error":"Pull made in error","provider_unavailable":"Provider unavailable","patient_not_ready":"Not yet ready","destination_changed":"Destination changed","job_created_in_error":"Job created in error"},"wardIntakeConstraintLabels":{"staffing_shortage":"Staffing shortage","infection_control":"Infection control","bay_or_room_closed":"Bay or room closed","high_acuity_on_ward":"High acuity on the ward","waiting_for_bed_clean":"Waiting for a bed to be cleaned","other_call_the_ward":"Other — call the ward"}}},"actions":[{"event":"RECEIVE_REFERRAL","name":"Raise a referral at the front door","group":"At the front door","lane":"expected","nodes":["raised","addressed","armCommunity","armWard","armEd","srcCommunity","srcCrisis","srcPolice","srcAmbulance","srcHospital","srcEd","srcGp"],"roles":["community","ed","ward","coordinator"],"does":"Creates a front-door referral to the chosen destinations, bounded by the configured parallel-referral cap. Distinct named wards may be asked together; duplicate recipients and a broad ward arm mixed with named ward arms are refused.","needs":"A known patient and source, valid destination/intake answers and a unique submission id when supplied. An ED uses ed_medical; a ward uses psychiatric_ward and its own origin ward, and must carry that ward's site. Form rule (design audit FORM-REF, 5 Nov 2026): the home region may be left out (it warns in the drawer and shows as not recorded), and the engine also accepts a referral with no origin site, though the drawer fills an ED or community referral's location and referring service from the sending desk and blocks Send when it cannot (Josh, 5 Nov 2026); one that is given must be listed, and a supplied originSiteCode must resolve in the world's state.scenario network, including a fictional-network scenario. The intake may carry an unconfirmed catchment, a pending clearance with no expected time or contact, and blank referrer contact details, but a referrer phone that is typed must be a phone number (digits and the form's own characters; audit M39, 10 Nov 2026); the legal status, clearance answer, age band, urgency and gender still block in the drawer.","changes":"Creates the referral with every destination set to waiting.","reasons":["COHORTS","REFERRAL_DESTINATION_KINDS","REFERRAL_PURPOSES","SEXES","REFERRAL_GENDERS","REFERRAL_SOURCES","HOME_REGIONS"],"refuses":[{"when":"Guard: event.destinations.length === 0","message":"RECEIVE_REFERRAL needs at least one destination","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":381}},{"when":"Guard: event.destinations.length > state.configuration.parallelReferralCap","message":"RECEIVE_REFERRAL may address at most ${state.configuration.parallelReferralCap} destinations, not ${event.destinations.length}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":387}},{"when":"Guard: new Set(recipientKeys).size !== recipientKeys.length || (broadWard && kinds.filter((kind) => kind === \"psychiatric_ward\").length > 1)","message":"RECEIVE_REFERRAL cannot address the same destination kind twice","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":405}},{"when":"Guard: !scenarioEmergencyDepartments(state.scenario).some((department) => department.id === edDestination.edId)","message":"RECEIVE_REFERRAL edId must resolve to a real emergency department","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":419}},{"when":"Guard: event.role === \"ed\" && event.source !== \"ed_medical\"","message":"RECEIVE_REFERRAL raised as role ed must carry source ed_medical, not ${event.source}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":482}},{"when":"Guard: event.source === \"ed_medical\" && !originSite.emergencyDepartment","message":"RECEIVE_REFERRAL source ed_medical requires an origin site with an emergency department","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":546}}],"screen":{"screen":"use-ward-referral-drawer-state.ts (+ command completion helper)","control":"Send referral A recoverable draft keeps one submission id, so reopening the sheet after an uncertain send reconciles that same submission instead of minting another referral."},"review":{"reviewedOn":"2026-11-10","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":391,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":362,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/referrals/use-ward-referral-drawer-state.ts","line":997,"sha256":"d97d86918bafd69a286053ba13087a5b9809f740ca07d7ab3106e0f044275909"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":386,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":392,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":410,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":424,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":487,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":551,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"ADD_PATIENT","name":"Add a person who is not on file","group":"At the front door","lane":"record","nodes":["raised","rkDuplicate","rkIntakeLost"],"roles":["ed","community","ward","coordinator"],"does":"Registers somebody with no referral, movement or bed record yet — the “searched, nobody came up, so add them” record.","needs":"A unique nonblank UMRN, given and family names, a real date of birth from 1900 through the applicable Perth day, and valid optional sex, gender, Indigenous-status and source-desk values. Optional preferred name, address, general practitioner, catchment community team, interpreter language and the 22 optional administrative details (ADMIN_DETAIL_FIELDS: contacts, next of kin and support person, Medicare and funding, planning) are trimmed; blank means not recorded.","changes":"Creates a new patient record, including any optional typed details given.","reasons":["GENDERS"],"refuses":[{"when":"Gender not from the list","message":"ADD_PATIENT gender must be chosen from GENDERS"}],"screen":{"screen":"add-patient.tsx (+1 other)","control":"Add patient"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":395,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-registration-reducer.ts","line":37,"sha256":"9e0f9c39d6d4a7f8f406fd438e09cd9ea7b7c6631a7bdd5e059d1f38de3caac4"},{"path":"src/components/ward-management/patients/add-patient.tsx","line":614,"sha256":"fc5752f90ad948491ad836c940e4eb1571aba082c71cee36e4e6083afdf78002"},{"path":"src/components/ward-management/referrals/use-referral-command-completion.ts","line":426,"sha256":"4dc5c8e0880f6118448453f12bb3df5c80ec20db2762669c955b2de29bae2feb"}]}},{"event":"RECORD_MEDICAL_CLEARANCE","name":"Record whether they are medically cleared","group":"At the front door","lane":"record","nodes":["addressed","rkClearance","edArrived"],"roles":["ed","coordinator"],"does":"Records the current medical-clearance answer on a referral and synchronises its matching linked movements. Fresh positive clearance resumes a recorded medical-deterioration pause.","needs":"An existing referral, finite recording time and boolean answer. Re-clearance must be later than any unresolved linked deterioration.","changes":"Replaces the referral answer and the matching movements’ clearance. Positive re-clearance stamps resumedAt and restates their blocker; it does not restore a released bed or booking.","reasons":[],"refuses":[{"when":"Guard: !referral","message":"no referral found for id ${event.referralId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":165}},{"when":"Current handler guard; inspect the cited source for its full condition","message":"Re-clearance must be recorded after the medical deterioration.","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":178}}],"screen":{"screen":"ed/ed-lists-desktop.tsx","control":"Record medically cleared"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":39,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":167,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-lists-desktop.tsx","line":186,"sha256":"ffc826779fff9455a88d5d6613c00d692ecdb7933bf87882fe31bcc756c16eb9"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":169,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":182,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_ARRIVED_IN_DEPARTMENT","name":"Mark that an expected patient has turned up","group":"At the front door","lane":"record","nodes":["addressed","edExpected","edArrived","edNeverArrives"],"roles":["ed","coordinator"],"does":"Marks that a patient the department was expecting has physically arrived.","needs":"The referral exists. The first recorded arrival wins; a later call leaves it unchanged rather than taking the minimum supplied timestamp.","changes":"Stamps the arrival time, once.","reasons":[],"refuses":[{"when":"Guard: !referral","message":"no referral found for id ${event.referralId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":214}}],"screen":{"screen":"ed/ed-lists-desktop.tsx","control":"Mark arrived in department"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":43,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":216,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-lists-desktop.tsx","line":366,"sha256":"ffc826779fff9455a88d5d6613c00d692ecdb7933bf87882fe31bcc756c16eb9"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":218,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"ACCEPT_REFERRAL","name":"Accept the referral","group":"At the front door","lane":"expected","nodes":["wardAnswers","wardAccepted","othersCancelled","cmhtAnswers","cmhtAccepted","edAnswers","edAccepted","cmhtNothing","wardBlocked","dForced","dNonBinary"],"roles":["ward","coordinator","ed","community"],"does":"A ward, emergency department or community team says yes to the destination addressed to it. The first yes automatically cancels every other destination still waiting — except a community arm, which never competes for the bed.","needs":"The destination was addressed to the acting desk and has not been withdrawn. Normally it is queued. An explicit reassessment can turn a decline into acceptance; updates on an already accepted arm add history rather than accepting twice. Ward eligibility and bed criteria still apply. At the shared authenticated boundary, a scoped caller must be authorised for the stored receiving ED or community team (including a community team in its scoped service); outbound visibility alone does not authorise the answer. The statewide coordinator retains whole-network authority. On the referral match screen the coordinator answers any arm and a desk answers only its own kind; a ward desk answers only when working in a ward scope, dispatching as ward with its acting ward.","changes":"Marks that destination accepted, cancels the other waiting non-community destinations, notifies the referrer and the receiving ward. No bed is pulled and no movement is created.","reasons":["GENDER_PLACEMENT_REASONS","OVERRIDE_REASONS"],"override":true,"refuses":[{"when":"Guard: !addressing","message":"referral ${referral.id} was not addressed to ${event.destinationKind.replace(/_/g, \" \")}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":805}},{"when":"Guard: event.destinationKind !== \"community_team\" && referralState(referral) === \"accepted\" && !(hasClinicalReassessment && addressing.state === \"accepted\")","message":"referral ${referral.id} has already been accepted elsewhere","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":836}},{"when":"Guard: addressing.state !== \"queued\" && !( (hasClinicalReassessment && addressing.state === \"accepted\") || (event.reassessment === true && addressing.state === \"declined\") )","message":"${event.destinationKind.replace(/_/g, \" \")} has already answered referral ${referral.id} (${addressing.state})","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":852}},{"when":"Guard: addressing.withdrawnAt !== undefined","message":"referral ${referral.id} was withdrawn by its referrer, so ${event.destinationKind.replace(/_/g, \" \")} cannot accept it","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":863}},{"when":"Guard: openLinkedMovement","message":"referral ${referral.id} already has an open movement (${openLinkedMovement.id}); it cannot also be accepted into a ward while that movement is open","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":941}},{"when":"Guard: !event.unitId","message":"ACCEPT_REFERRAL into a psychiatric ward must name a unit","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":946}}],"screen":{"screen":"referral-match.tsx (+1 other)","control":"Accept at the named ward"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":427,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":745,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/community/community-screen.tsx","line":589,"sha256":"4cce4397ba7d06901141717dd89e58cf12315dc45e90f35604b527e6cebf5671"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1351,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/referrals/referral-match.tsx","line":421,"sha256":"12f313fd1b9c2dcfa081b3f54ce46a20ee163651084afcc31bdceeae335ea044"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":813,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":844,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":860,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":871,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":949,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":954,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"DECLINE_REFERRAL","name":"Decline the referral","group":"At the front door","lane":"stall","nodes":["wardAnswers","wardDeclined","cmhtAnswers","cmhtDeclined","edAnswers","edDeclined","cmhtNothing"],"roles":["ward","coordinator","ed","community"],"does":"Records the destination’s answer. A substantive decline closes that arm; bed-unavailable reasons on a ward arm waitlist it and keep it live. Gender mismatch is not a decline reason.","needs":"A known addressed destination, matching desk kind/place and a valid reason. Re-answering a decided arm requires the documented reassessment path. At the shared authenticated boundary, a scoped caller must be authorised for the stored receiving ED or community team (including a community team in its scoped service); outbound visibility alone does not authorise the answer. The statewide coordinator retains whole-network authority. On the referral match screen the coordinator answers any arm and a desk answers only its own kind; a ward desk answers only when working in a ward scope, dispatching as ward with its acting ward.","changes":"Records a decline or waitlist history entry and the corresponding notices, retaining other arms.","reasons":["REFERRAL_DECLINE_REASONS","COMMUNITY_DECLINE_REASONS"],"refuses":[{"when":"Guard: event.destinationKind !== \"community_team\" && referralState(referral) === \"accepted\"","message":"referral ${referral.id} has already been accepted elsewhere","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1187}},{"when":"Guard: addressing.withdrawnAt !== undefined","message":"referral ${referral.id} was withdrawn by its referrer, so ${event.destinationKind.replace(/_/g, \" \")} cannot decline it","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1202}},{"when":"Guard: !declineReasonsFor[event.destinationKind].includes(event.reason)","message":"DECLINE_REFERRAL reason must be chosen from ${declineReasonListName[event.destinationKind]}, the vocabulary for ${event.destinationKind.replace(/_/g, \" \")} destinations","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1227}}],"screen":{"screen":"referral-match.tsx (+2 others)","control":"Decline referral"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":439,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1141,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/community/community-screen.tsx","line":529,"sha256":"4cce4397ba7d06901141717dd89e58cf12315dc45e90f35604b527e6cebf5671"},{"path":"src/components/ward-management/ed/use-ed-screen-decline.ts","line":135,"sha256":"ff7e1679d14d0e040af8cfa6bf07805d7c1bffc9cf8cf7a0d055fedc5f4862fd"},{"path":"src/components/ward-management/referrals/referral-match.tsx","line":466,"sha256":"12f313fd1b9c2dcfa081b3f54ce46a20ee163651084afcc31bdceeae335ea044"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1195,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1210,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1235,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"RECORD_REFERRER_WITHDRAWAL","name":"The referrer takes the referral back","group":"At the front door","lane":"stall","nodes":["wardAnswers","cmhtWithdrawn","wardNothing","cmhtNothing","wardWithdrawn"],"roles":["coordinator","community","ed","ward"],"does":"The referring party withdraws — either just the community half, leaving the bed request standing, or the whole referral, which also gives back any held bed and cancels any transport.","needs":"The recorded sender desk/place or coordinator. Whole-referral withdrawal requires waiting non-withdrawn arms and no accepted placement or collected linked journey. The separately scoped community-arm path has its own reason and state checks.","changes":"Stamps the withdrawal on every still-waiting destination; closes any linked open movement as “did not proceed”.","reasons":["WARD_REQUEST_WITHDRAWAL_REASONS"],"refuses":[{"when":"Guard: event.reason === undefined || !WARD_REQUEST_WITHDRAWAL_REASONS.includes(event.reason)","message":"RECORD_REFERRER_WITHDRAWAL scoped to community_team must give a reason from WARD_REQUEST_WITHDRAWAL_REASONS","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":943}},{"when":"Guard: referralState(referral) === \"accepted\"","message":"referral ${referral.id} has already been accepted, so it cannot be withdrawn","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":982}},{"when":"Guard: referral.destinations.some( (addressing) => addressing.destination.kind !== \"community_team\" && addressing.withdrawnAt !== undefined, )","message":"referral ${referral.id} has already been recorded as withdrawn by its referrer","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":989}},{"when":"Guard: waiting.length === 0","message":"every destination on referral ${referral.id} has already answered","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":999}},{"when":"Guard: collectedLinkedMovement","message":"referral ${referral.id} is linked to movement ${collectedLinkedMovement.id}, whose transport has already been collected; this needs a coordinator decision (see STOP_TRANSPORT) rather than an automatic withdrawal","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1020}}],"screen":{"screen":"referral-match.tsx","control":"Withdraw referral to community team"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":477,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":801,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/referrals/use-referral-match-state.tsx","line":202,"sha256":"5c100c488ba449b9b76e099dfa98e04a34fa726d633e9fa56b592c125f01344b"},{"path":"src/components/ward-management/referrals/referral-match.tsx","line":556,"sha256":"12f313fd1b9c2dcfa081b3f54ce46a20ee163651084afcc31bdceeae335ea044"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":897,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":936,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":943,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":953,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":974,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"ADD_REFERRAL_CORRECTION","name":"Add a correction to a referral","group":"At the front door","lane":"record","nodes":["wardAnswers","addressed"],"roles":["community","ed","ward","coordinator"],"does":"Adds a dated, attributed note correcting something on a referral, at any point in its life. What was said before stays readable.","needs":"An existing referral and a nonblank note within the correction limit. It can be at any stage, but sender-kind/place restrictions apply to ward, ED and community desks.","changes":"Appends the note. Never overwrites.","reasons":[],"refuses":[{"when":"Guard: note.length === 0","message":"ADD_REFERRAL_CORRECTION note must say something — a blank is not a correction","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1209}},{"when":"Guard: note.length > REFERRAL_CORRECTION_NOTE_MAX_CHARACTERS","message":"ADD_REFERRAL_CORRECTION note is ${note.length} characters and the limit is ${REFERRAL_CORRECTION_NOTE_MAX_CHARACTERS} — it is refused rather than shortened","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1217}}],"screen":{"screen":"referrals/referral-history-corrections.tsx","control":"Add a correction"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":484,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1124,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/referrals/referral-history-corrections.tsx","line":73,"sha256":"da6432d4f3190b3305d3890162266ab68e46e2bd8a8bd22649fc91ff66499107"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1159,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1167,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"RECORD_LOCAL_BED_SOUGHT","name":"Record that a bed closer to home was looked for","group":"At the front door","lane":"record","nodes":["wardAnswers","addressed"],"roles":["coordinator"],"does":"Records that somebody looked for a bed nearer the person's home before sending them further. It never gates an acceptance — it exists so the search can be shown to have happened.","needs":"The referral is still undecided and no earlier local-bed search is already recorded.","changes":"Stamps the search and who did it.","reasons":[],"refuses":[{"when":"Guard: referralState(referral) !== \"queued\"","message":"referral ${referral.id} was already decided (${referralState(referral)})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1107}},{"when":"Guard: referral.localBedSought !== undefined","message":"referral ${referral.id} already records a local bed search","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1112}}],"screen":{"screen":"referral-match.tsx","control":"Record that a local bed was sought and none was suitable"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":445,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1045,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/referrals/referral-match.tsx","line":447,"sha256":"12f313fd1b9c2dcfa081b3f54ce46a20ee163651084afcc31bdceeae335ea044"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1052,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1057,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RAISE_REFERRAL","name":"Start a bed search from a department","group":"Finding a bed","lane":"expected","nodes":["seam","placement","edRaise"],"roles":["ed","community","ward","coordinator"],"does":"Creates the movement that tracks placement. An ED journey may link its addressed referral; an accepting ward or coordinator may continue an accepted direct ED/community referral. pullBed requests an atomic raise-and-pull through both ordinary checks.","needs":"Valid draft facts and a real ED unless continuing an accepted direct community referral. A linked referral and destination must match, be live and fund no other open movement; direct continuation has its own accepting-ward checks. A community continuation needs its referring service and location on the referral (the drawer fills them from the sending desk and blocks Send without them) and is refused without either, never starting at an empty site. A supplied patientId, or one inherited from the linked referral, must still name a current patient; an omitted identity remains supported.","changes":"Creates a placement_requested movement, or accepted_awaiting_bed for a valid direct continuation. Captures typed legal-paper facts; pullBed also reserves the bed only when both steps succeed.","reasons":["REFERRAL_GENDERS"],"refuses":[{"when":"Guard: !raisedFrom","message":"RAISE_REFERRAL referralId must name a referral this system already holds, and ${event.referralId} names none","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":161}},{"when":"Guard: !addressing","message":"referral ${referral.id} was never addressed to ${department?.name ?? \"this ward\"}, so a journey raised there did not come from it","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":229}},{"when":"Guard: addressing.withdrawnAt !== undefined","message":"referral ${referral.id} was withdrawn by its referrer, so no journey can be raised from it","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":241}},{"when":"Guard: addressing.state === \"declined\"","message":"${department?.name ?? \"This ward\"} declined referral ${referral.id}, so no journey can be raised from it","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":251}},{"when":"Guard: blockingLinkedMovement","message":"referral ${referral.id} already has a linked movement (${blockingLinkedMovement.id}) that did not close as \"did not proceed\"; a second journey cannot be raised while it stands","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":270}}],"screen":{"screen":"ed-screen.tsx","control":"Ask for a bed"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":37,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":92,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward/ward-accepted-referral-placement-form.tsx","line":100,"sha256":"09fa59dfc3618d8943dcf23a008c14b4747a9a1deae31e892a762db3808f8c4f"},{"path":"src/components/ward-management/ed/ed-screen.tsx","line":333,"sha256":"c4987128df9afd2b09fe2bd0636cfa523fa2fae4bf693c0b58e6c78a16144a9f"},{"path":"src/components/ward-management/referrals/pull-accepted-referral.tsx","line":133,"sha256":"e7628cba7f522dcaab9c9b1c7091518dfc979f1178a7e44d3d93d1555926976f"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":160,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":216,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":228,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":238,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":257,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"REFER_TO_UNITS","name":"Ask one or more wards","group":"Finding a bed","lane":"expected","nodes":["asked","dForced"],"roles":["coordinator"],"does":"Adds new wards to an open placement request without dropping live requests. The configured cap warns and records an over-cap act; it does not prohibit asking more wards.","needs":"An open referrable stage, real new wards, valid optional reasons, eligibility and any required recorded gender-placement check. Already-live wards are not rechecked or counted twice.","changes":"Adds those wards to the live list and moves the record to destination review.","reasons":["OVERRIDE_REASONS","GENDER_PLACEMENT_REASONS"],"override":true,"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":707}},{"when":"Guard: movement.closure","message":"cannot refer a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":709}},{"when":"Guard: !REFERRABLE_MOVEMENT_STAGES.includes(movement.stage)","message":"cannot refer a movement at its current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":729}},{"when":"Guard: unknown","message":"no unit found for id ${unknown}","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":734}}],"screen":{"screen":"shortlist-panel.tsx","control":"Refer"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":85,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":675,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/capacity/step-down-board.tsx","line":48,"sha256":"d40940bff7a00cac5ae44bf3b2dfb7a8894e9578bf624275b4bb2fb8fe4d7fc0"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":316,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/coordinator/shortlist-panel.tsx","line":843,"sha256":"d4037bcfbce9686478d640bc8f19fba727986518c4d49cede83ee6c9748d65cb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":677,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":679,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":699,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":704,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"ACCEPT_IN_PRINCIPLE","name":"A ward accepts in principle","group":"Finding a bed","lane":"expected","nodes":["inPrinciple","dForced","dGenderHard"],"roles":["ward","coordinator"],"does":"A ward formally accepts the patient and becomes the destination. Every other ward asked is withdrawn automatically. Still no bed is set aside.","needs":"An open movement at destination_review, a live request to the acting ward, no earlier acceptance, current ward availability and eligibility. A supplied bed number must be valid, suitable and neither occupied nor held; required gender/override records must exist.","changes":"Records the accepting ward, clears every other live request, and tells the referring department.","reasons":[],"override":true,"refuses":[{"when":"Guard: movement.closure","message":"cannot accept a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":114}},{"when":"Guard: movement.acceptedUnitId","message":"movement ${movement.id} is already accepted at ${already?.name ?? movement.acceptedUnitId}; the referral to ${attemptedUnit?.name ?? event.unitId} was withdrawn","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":122}},{"when":"Guard: movement.stage !== \"destination_review\"","message":"cannot accept a movement at its current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":129}},{"when":"Guard: !movement.referredUnitIds.includes(event.unitId)","message":"${event.unitId} does not hold a live referral for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":133}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Accept in principle"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":86,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":108,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1313,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward/ward-answer-view.tsx","line":469,"sha256":"fb9fd5b92aaf4cac6a3397267e1dff8062ed70bbc9333b6476a77663ae83b37c"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":295,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":114,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":122,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":129,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":133,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"DECLINE","name":"A ward declines the bed search","group":"Finding a bed","lane":"stall","nodes":["sWardDecline"],"roles":["ward","coordinator"],"does":"A ward records a substantive decline or a bed-unavailable waitlist answer. A waitlist keeps the ward request live; gender mismatch does not decline it.","needs":"The record is at destination review and this ward holds a live request.","changes":"A substantive decline removes that ward and appends history and a referrer notice. A waitlist keeps the request, records waitlisted history and notifies the referrer; the stage remains destination_review.","reasons":["DECLINE_REASONS"],"refuses":[{"when":"Guard: movement.stage !== \"destination_review\"","message":"cannot decline at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":254}},{"when":"Guard: !movement.referredUnitIds.includes(event.unitId)","message":"${event.unitId} does not hold a live referral for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":258}},{"when":"Guard: !DECLINE_REASONS.includes(event.reason) && !Object.hasOwn(LEGACY_DECLINE_REASONS, event.reason)","message":"DECLINE reason must be chosen from DECLINE_REASONS","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":309}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Confirm decline"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":91,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":240,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1404,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward/ward-answer-view.tsx","line":402,"sha256":"fb9fd5b92aaf4cac6a3397267e1dff8062ed70bbc9333b6476a77663ae83b37c"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":254,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":258,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":312,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"WITHDRAW_WARD_REQUEST","name":"Take back one ward's request","group":"Finding a bed","lane":"stall","nodes":["asked","sWithdrawWard"],"roles":["coordinator"],"does":"Withdraws the request from one named ward only. Every other ward asked carries on considering.","needs":"That ward holds a live request.","changes":"Removes that one ward and tells it why.","reasons":["WARD_REQUEST_WITHDRAWAL_REASONS"],"refuses":[{"when":"Guard: !movement.referredUnitIds.includes(event.unitId)","message":"${event.unitId} does not hold a live referral for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1132}},{"when":"Guard: !WARD_REQUEST_WITHDRAWAL_REASONS.includes(event.reason)","message":"WITHDRAW_WARD_REQUEST reason must be chosen from WARD_REQUEST_WITHDRAWAL_REASONS","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1135}}],"screen":{"screen":"shortlist-panel.tsx","control":"Withdraw this request"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":495,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1069,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/coordinator/shortlist-panel.tsx","line":885,"sha256":"d4037bcfbce9686478d640bc8f19fba727986518c4d49cede83ee6c9748d65cb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1082,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1085,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"WITHDRAW_ACCEPTANCE","name":"Undo a ward's acceptance","group":"Finding a bed","lane":"stall","nodes":["sAcceptWithdrawn"],"roles":["coordinator"],"does":"Withdraws an acceptance before handover, including a pulled bed or a movement stepped back while retaining its held admission. A matching bed is released in the same act.","needs":"An open movement at accepted_awaiting_bed, pulled, or an earlier stepped-back stage with a held admission, plus a listed correction reason. Cancel a live booking first; collection refuses withdrawal.","changes":"Clears the accepting ward and time and any released hold fields (including the referral arm's numbered bed hold), appends withdrawal/release history and notices. Ordinarily returns to destination_review; an earlier stepped-back stage stays as found. It does not re-refer the ward. For an agreed return identified by sourceAdmissionId, the bed-release notice goes to that source stay's sending ward rather than its ED alias.","reasons":["STEP_BACK_REASONS"],"refuses":[{"when":"Guard: holdsBed && movement.transport?.collectedAt !== undefined","message":"movement ${movement.id}'s patient has been collected; use STOP_TRANSPORT","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1329}},{"when":"Guard: holdsBed && movement.transport !== undefined && movement.transport.cancelledAt === undefined","message":"movement ${movement.id} has a transport job booked; cancel it (CANCEL_TRANSPORT) before withdrawing the acceptance","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1335}},{"when":"Guard: holdsBed && bedReleased === state","message":"movement ${movement.id}'s pulled bed matches no releasable reservation","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1345}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx","control":"Withdraw the acceptance"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":492,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1301,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1794,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1341,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1347,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1357,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"WITHDRAW_REFERRAL","name":"Abandon the bed search","group":"Finding a bed","lane":"end","nodes":["sAbandoned"],"roles":["ed","community","ward","coordinator"],"does":"Cancels the search outright — either pulling it from every ward still being asked, or, once accepted, revoking the acceptance and giving back any held bed.","needs":"An open movement and the recorded sending desk/place or coordinator. After acceptance this path is restricted to the originating ED or coordinator and refuses after collection; other sending desks cannot revoke an accepted movement here. Execution uses canonical actingPlaceId, or a ward's actingUnitId, before the legacy placeId fallback; a supplied legacy alias that disagrees with the canonical claim is refused. Shared scope validates legacy placeId as an authority claim too.","changes":"Closes the movement as “did not proceed”, releases any held bed, cancels any live transport.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"movement ${movement.id} has already closed and cannot be withdrawn","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":919}},{"when":"Guard: event.role !== \"coordinator\" && event.role !== \"ed\"","message":"movement ${movement.id} has already been accepted by ${movement.acceptedUnitId}; only the referrer or the coordinator may revoke it now","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":990}},{"when":"Guard: movement.transport?.collectedAt !== undefined","message":"movement ${movement.id}'s patient has already been collected; use STOP_TRANSPORT to stop the journey instead of withdrawing the referral","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":999}},{"when":"Guard: movement.referredUnitIds.length === 0","message":"movement ${movement.id} holds no live referral to withdraw","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1065}}],"screen":{"screen":"ward-flow-raise.ts; ed/ed-screen-actions.ts; patients/patient-transit-operations.tsx","control":"Withdraw referral"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":373,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":883,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-raise.ts","line":13,"sha256":"a077d0f6d55ef4d03e7beca435fcbce745b6eee1628698b0f6b9acd30289c207"},{"path":"src/components/ward-management/ed/ed-screen-actions.ts","line":40,"sha256":"69b93a5f2adbb5c42be0b7ba826c12ec1b3eec58ed2a3d08ac99273ef66d4636"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":983,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":889,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":960,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":969,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1021,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"REFER_TO_COMMUNITY_TEAM","name":"Send them to a community team instead","group":"Finding a bed","lane":"diversion","nodes":["edToCommunity","cmhtFromSearch"],"roles":["ed","coordinator"],"does":"Instead of admitting, refers the patient straight to a named community team — ends the bed search, creates or reuses a real community referral, and tells everybody involved.","needs":"The record is open and transport has not collected the patient. If they are on a legal form, a conclusive examination outcome must already be recorded.","changes":"Gives back any held bed, cancels transport, withdraws live ward requests, closes the movement, and raises or reuses the community arm. When creating a new community referral, the movement's origin ED site is looked up within state.scenario, preserving the fictional-network origin when available; queued-arm reuse is unchanged.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot refer a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":487}},{"when":"Guard: !communityTeamOptions().includes(event.team)","message":"team \"${event.team}\" is not a valid community mental health team","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":490}},{"when":"Guard: movement.transport?.collectedAt !== undefined","message":"movement ${movement.id}'s patient has already been collected; use STOP_TRANSPORT to stop the journey instead of referring to a community team","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":500}},{"when":"Guard: isOnForm && (!movement.examination || movement.examination.outcome === \"further_examination_ordered\")","message":"movement ${movement.id} is on a legal form; a conclusive examination outcome must be recorded before referring to a community team","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":513}}],"screen":{"screen":"ed/ed-screen-row-forms.tsx","control":"Confirm CMHT referral"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":195,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":477,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ed/ed-screen-row-forms.tsx","line":693,"sha256":"092ace45298789630ea1548b50896070d092ccf6e1e2ff5efa2be02b089f0dfd"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":481,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":484,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":494,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":507,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"RECORD_ED_OUTCOME","name":"The department decides they need no bed","group":"Finding a bed","lane":"end","nodes":["edOutcome","edAnswers"],"roles":["ed","coordinator"],"does":"Records that the patient no longer needs a psychiatric bed — going home, or to community follow-up — and unwinds everything already in motion.","needs":"The record is open and transport has not collected the patient. For “for discharge” on a legal form, a conclusive examination outcome must already be recorded.","changes":"Releases a held bed, cancels an uncollected transport job, drops live ward requests, closes the movement, and notifies every ward affected.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot record an ED outcome for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":331}},{"when":"Current handler guard; inspect the cited source for its full condition","message":"movement ${movement.id}'s patient is actively in transit; use STOP_TRANSPORT to stop the journey instead of recording an ED outcome","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":346}},{"when":"Guard: event.outcome === \"for_discharge\" && isOnLegalFormForDischarge && (!movement.examination || movement.examination.outcome === \"further_examination_ordered\")","message":"movement ${movement.id} is on a legal form; a conclusive examination outcome must be recorded before recording \"for discharge\"","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":362}}],"screen":{"screen":"ed/ed-screen-row-forms.tsx","control":"For discharge"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":84,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":328,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-row-forms.tsx","line":298,"sha256":"092ace45298789630ea1548b50896070d092ccf6e1e2ff5efa2be02b089f0dfd"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":335,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":350,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":366,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_NO_REFERRAL","name":"Record that nobody referred them","group":"Finding a bed","lane":"record","nodes":["placement","edRaise"],"roles":["ed","coordinator"],"does":"Records that, on checking, nobody actually referred this patient in.","needs":"The record is open and is not already linked to a referral.","changes":"Stamps the absence and its reason.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot record a referral answer for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":300}},{"when":"Guard: movement.referralId !== undefined","message":"movement ${movement.id} was raised from referral ${movement.referralId}, so it cannot also record that nobody referred this patient","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":311}}],"screen":{"screen":"ed/ed-screen-row-menu.tsx","control":"No referral raised"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":81,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":297,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-row-menu.tsx","line":481,"sha256":"00d889ba5d86974abf82e2dd2ac8644e8de2a6d5c4e736ae39b00c927c49b205"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":304,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":315,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_ESCALATION","name":"Record an escalation","group":"Finding a bed","lane":"record","nodes":["asked","rkEscalate"],"roles":["coordinator"],"does":"Records that the search was escalated — which wards were tried, and who was contacted.","needs":"The record is open.","changes":"Stamps the escalation, the wards tried and the contact, and adds it to the journey's escalation history (item 28, 9 Nov 2026).","reasons":["ESCALATION_CONTACTS"],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1122}},{"when":"Guard: movement.closure","message":"cannot escalate a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1124}}],"screen":{"screen":"ward-tasks-drawer.tsx; alerts/alerts-screen.tsx; delays/delays-screen.tsx","control":"Record escalation"},"review":{"reviewedOn":"2026-11-10","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":104,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1065,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-tasks-drawer.tsx","line":673,"sha256":"f14b8983f1421e5ab23f25dd3d11d6489cf9119e06884a1fcb58e8374c68018f"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":738,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/delays/delays-screen.tsx","line":170,"sha256":"da99c0834991445b845454355401c6a6a5fa156c5e433f242c08d24ef23e9297"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1094,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1069,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"STEP_BACK_STAGE","name":"Correct the record backwards","group":"Finding a bed","lane":"record","nodes":["asked","inPrinciple","pulled"],"roles":["coordinator"],"does":"Moves the record back to an earlier point. A pure record correction — it deliberately releases no bed and cancels no transport.","needs":"An open, unarrived movement, an earlier valid stage and listed correction reason. A stage-only seeded bed hold cannot be stepped back before pulled because that would lose its reservation.","changes":"Moves the stage and logs the correction. Nothing else is touched at all.","reasons":["STEP_BACK_REASONS"],"refuses":[{"when":"Guard: movement.stage === \"arrived\" || movement.transport?.arrivedAt !== undefined","message":"cannot step back an arrived movement (invariant I-05: physical arrival is irreversible)","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":698}},{"when":"Guard: toIndex >= fromIndex","message":"STEP_BACK_STAGE target must be strictly before the movement's current stage (movement ${movement.id} is at ${stageCopy[movement.stage].label}, target was ${stageCopy[event.to].label})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":713}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx; patients/patient-transit-operations.tsx","control":"Correct the record"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":491,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":750,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1902,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":928,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":757,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":772,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"PULL_PATIENT","name":"Take the bed","group":"Holding the bed","lane":"expected","nodes":["pulled","dRepull","dForced","dGenderHard","dNoLongerSuits"],"roles":["ward","coordinator"],"does":"The ward claims the bed it accepted, and an admission record is created marked held — not occupied. A patient is not arrived until the ward says they have arrived.","needs":"An open movement at accepted_awaiting_bed and the accepting ward, consistent reservation/identity, current capacity (the Ready figure counts live pulled admissions, and beds still being made ready must not use up all of it), eligibility, bed-kind/gender/legal checks and no conflicting active placement. Other journeys' pending numbered bed reservations at the ward (a held bed number on another movement or referral arm) also come off Ready and off the free locked and open counts, so a pull cannot take a bed another record was promised.","changes":"Reserves an allocatable bed, creates or consistently adopts the held admission and starts the configured hold timer. The bed is held rather than occupied.","reasons":["OVERRIDE_REASONS"],"override":true,"refuses":[{"when":"Guard: movement.acceptedUnitId !== event.unitId","message":"movement ${movement.id} was accepted at ${movement.acceptedUnitId ?? \"no unit\"}, not ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":92}},{"when":"Guard: !speciallingAnsweredRestore && lacksObservationStaff(movement.observation, restoreUnit, admissionsExcludingOwn)","message":"${restoreUnit.name} has not enough observation staff left; this patient needs ${observationSummary(movement.observation)} and the ward cannot staff it","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":154}},{"when":"Guard: !acuityAnsweredRestore && acuityOverrideNeededRestore","message":"${restoreUnit.name} ${HIGH_ACUITY_STAFFING_REFUSAL}. This placement ${OVERRIDE_REASON_REQUIRED} and the nurse unit manager consulted.","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":167}},{"when":"Guard: pullReady \u003c= 0","message":"no Ready bed remains at ${unit.name} (allocatable ${unit.allocatable.value}, physically empty ${unit.empty.value})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":210}},{"when":"Guard: pending > 0 && pullReady \u003c= pending","message":"every free bed at ${unit.name} is still being made ready (${pending} pending); a patient cannot be pulled to a bed that is not open","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":227}},{"when":"Guard: !speciallingAnswered && lacksObservationStaff(movement.observation, unit, state.admissions)","message":"${unit.name} has not enough observation staff left (${remainingSpeciallingCapacity(unit, state.admissions)} of ${unit.speciallingCapacity} free); this patient needs ${observationSummary(movement.observation)} and the ward cannot staff it","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":249}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Pull a bed"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":90,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":79,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1449,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward/ward-answer-view.tsx","line":477,"sha256":"fb9fd5b92aaf4cac6a3397267e1dff8062ed70bbc9333b6476a77663ae83b37c"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":306,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":98,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":160,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":173,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":223,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":241,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":262,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"RELEASE_PULL","name":"Give the held bed back","group":"Holding the bed","lane":"stall","nodes":["sPullReleased"],"roles":["coordinator","ward"],"does":"A ward gives back a bed it was holding before the patient arrived. The admission record is deleted outright — nobody was ever in this bed.","needs":"An open movement at pulled, a listed release reason, an authorised holding ward/coordinator and no physical collection. Cancel a live booking first. An Undo carrying expectedPull must still name this exact pull.","changes":"Returns the bed to the ward, deletes the admission, sends the record back to “accepted, awaiting bed”, and tells the department. For a return movement with sourceAdmissionId, the in-app release/withdrawal notice targets the actual sending stay ward. Ordinary ED/community origins retain their existing recipient paths; no external-provider delivery is implied. The movement's and its referral arm's held bed numbers are cleared with the pull. A release that matches no releasable bed reservation is refused rather than recorded.","reasons":["RELEASE_PULL_REASONS"],"refuses":[{"when":"Guard: movement.stage !== \"pulled\"","message":"cannot release a pull at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":483}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"RELEASE_PULL was raised acting as unit ${event.actingUnitId} but movement ${movement.id}'s bed is pulled at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":492}},{"when":"Guard: !RELEASE_PULL_REASONS.includes(event.reason)","message":"RELEASE_PULL reason must be chosen from RELEASE_PULL_REASONS","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":501}},{"when":"Guard: bedReleased === state","message":"movement ${movement.id}'s pulled bed matches no releasable reservation","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":524}}],"screen":{"screen":"alerts/alerts-screen.tsx; ward/ward-screen.tsx; patients/patient-transit-operations.tsx","control":"Release the pulled bed"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":114,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":453,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":723,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1847,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":867,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":537,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":546,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":555,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"RELEASE_HELD_BED","name":"Release a bed left held by a stopped journey","group":"Holding the bed","lane":"stall","nodes":["sStopTransport"],"roles":["coordinator","ward","ed"],"does":"Releases the bed that stopping a transport deliberately left held, once it is decided the patient is not coming after all. The only way to give that bed back.","needs":"The journey was stopped after collection, and a bed is still held.","changes":"Releases the bed and deletes the admission.","reasons":[],"refuses":[{"when":"Guard: !isStoppedTransport && !isRevokedExamHold && !awaitingRelease","message":"movement ${movement.id} was not stopped by STOP_TRANSPORT and has no examination-revoked hold, so there is no pulled bed to release this way","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":573}},{"when":"Guard: !heldBedOutstanding","message":"movement ${movement.id} has no bed pulled — it may already have been released","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":583}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"RELEASE_HELD_BED was raised acting as unit ${event.actingUnitId} but movement ${movement.id}'s bed is pulled at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":591}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx; ward/ward-arrivals-corridor.tsx","control":"Release the held bed"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":190,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":618,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1167,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward/ward-arrivals-corridor.tsx","line":630,"sha256":"572956c1b4769defd00bc1a5dc027ff2d76c476388cee6d36833c8321e3824a4"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":632,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":642,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":650,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"RECORD_TRANSPORT_NEED","name":"Record whether transport is needed","group":"The journey","lane":"record","nodes":["booked","dNoTransport"],"roles":["ed","ward","community","coordinator"],"does":"Records whether the patient will need help getting to the ward. Answering “no” is what lets them be marked arrived with no journey at all.","needs":"An open movement. The ward must be the sending ward; a supplied ED place must match the origin. Cancel a live booking before recording that transport is not needed.","changes":"Sets or replaces the answer.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot record a transport need for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":233}},{"when":"Guard: !sendingWard","message":"RECORD_TRANSPORT_NEED was raised by ward ${event.actingUnitId ?? \"(unnamed)\"}, but this patient did not start on a ward","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":251}}],"screen":{"screen":"ed/ed-screen-row-menu.tsx","control":"No transport needed"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":52,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":229,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-row-menu.tsx","line":458,"sha256":"00d889ba5d86974abf82e2dd2ac8644e8de2a6d5c4e736ae39b00c927c49b205"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":237,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":255,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"BOOK_TRANSPORT","name":"Book the transport","group":"The journey","lane":"expected","nodes":["booked"],"roles":["ed","ward","community","coordinator"],"does":"Logs an already arranged booking: provider, explicit escort and transport-legal-status answers, an optional estimate, and optional typed CAD number. It calls no transport service.","needs":"An open movement at pulled or handover_ready with an accepted destination or admission and no live booking. Desk/place must match sender or coordinator; global medical-clearance/deterioration guards apply. A blank CAD is permitted for later recording. A blank estimated time is permitted too (W32, 5 Nov 2026: it warns in the form); one that is given must be a finite time. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Creates the transport job and records who booked it — which decides who may later cancel it.","reasons":["TRANSPORT_PROVIDERS","TRANSPORT_LEGAL_STATUSES"],"refuses":[{"when":"Guard: movement.stage !== \"pulled\" && movement.stage !== \"handover_ready\"","message":"cannot book transport at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":654}},{"when":"Guard: movement.transport && movement.transport.cancelledAt === undefined","message":"transport for movement ${movement.id} is already booked","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":660}},{"when":"Guard: typeof event.escortRequired !== \"boolean\"","message":"BOOK_TRANSPORT escortRequired must be answered, and it has no default","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":669}},{"when":"Guard: event.estimatedAt !== undefined && (typeof event.estimatedAt !== \"number\" || !Number.isFinite(event.estimatedAt))","message":"BOOK_TRANSPORT estimatedAt must be a real time when it is given","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":690}},{"when":"Guard: event.role === \"ward\" && !event.actingUnitId","message":"BOOK_TRANSPORT raised as ward must state its actingUnitId, and it has no default","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":695}},{"when":"Guard: event.role === \"community\" && !event.actingPlaceId","message":"BOOK_TRANSPORT raised as community must state its actingPlaceId, and it has no default","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":733}}],"screen":{"screen":"officer/officer-needs-transport.tsx; community/use-community-screen-overlays.ts; ed/ed-screen-actions.ts; patients/patient-transit-operations.tsx; patients/patient-now-screen.tsx","control":"Transport booked The officer booking form guards entered answers and pending saves on outer close or job change. Keep editing retains the draft; only an accepted current save clears the booking without a discard question. A held uncertain command stays owned for same-command recovery rather than sending a duplicate."},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":153,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":654,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-needs-transport.tsx","line":349,"sha256":"a10acca50b2c048546f9b0018a94030b1f6534d508d75c456787087a8aab4b1e"},{"path":"src/components/ward-management/community/use-community-screen-overlays.ts","line":122,"sha256":"647d6312cc81bb2edcb34ac5b2f6214fccfcd4bec1eb3e2f5742fe286eafbb23"},{"path":"src/components/ward-management/ed/ed-screen-actions.ts","line":47,"sha256":"69b93a5f2adbb5c42be0b7ba826c12ec1b3eec58ed2a3d08ac99273ef66d4636"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":640,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":512,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":666,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":672,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":681,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":702,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":707,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":745,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"HANDOVER_READY","name":"Confirm handover is ready","group":"The journey","lane":"expected","nodes":["handover","dNoLongerSuits"],"roles":["ed","community","coordinator"],"does":"Confirms the patient is ready for the booked crew to collect.","needs":"An open movement at pulled, the sending desk or coordinator, and either a booked job or recorded no-transport answer. Explicit negative medical clearance or unresolved deterioration, gender/legal bed issues refuse onward movement.","changes":"Moves the record to handover ready.","reasons":[],"refuses":[{"when":"Guard: movement.stage !== \"pulled\"","message":"cannot ready a handover at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":97}},{"when":"Guard: !movement.transport && !noTransportNeeded","message":"cannot ready a handover before transport is booked (BOOK_TRANSPORT)","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":107}}],"screen":{"screen":"patients/patient-transit-operations.tsx","control":"Mark handover ready"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":94,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":85,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":664,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":99,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":109,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"TRANSPORT_ACCEPTED","name":"The crew accepts the job","group":"The journey","lane":"expected","nodes":["enroute","dNoLongerSuits"],"roles":["officer","coordinator"],"does":"Records that the transport provider has accepted the collection job.","needs":"An open handover-ready movement, a booked job with no existing acceptance and current medical, gender and legal checks. A revoked/community-order examination while a bed is held must be resolved.","changes":"Stamps the acceptance.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot accept transport for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":130}},{"when":"Guard: movement.transport.acceptedAt !== undefined","message":"transport for movement ${movement.id} was already accepted","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":158}}],"screen":{"screen":"officer-screen.tsx","control":"Accepted"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":95,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":128,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-screen.tsx","line":521,"sha256":"da86cd3b9a7e8018baf1a5abb7477e66bdb918fd911ad8f43779f95de7b68027"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":685,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":132,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":160,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"TRANSPORT_EN_ROUTE","name":"The crew sets off","group":"The journey","lane":"expected","nodes":["enroute"],"roles":["officer","coordinator"],"does":"Records that an accepted provider has set off towards the patient. Global medical pause/clearance and examination-held-bed blockers apply; this event does not itself rerun the held-unit gender or legal-authorisation helpers.","needs":"An open handover-ready movement, an accepted job not already en route, and no unresolved medical or examination/held-bed restriction.","changes":"Stamps the departure.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot move transport for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":180}},{"when":"Guard: movement.transport.enRouteAt !== undefined","message":"transport for movement ${movement.id} is already en route","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":216}}],"screen":{"screen":"officer-screen.tsx","control":"En route"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":96,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":178,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-screen.tsx","line":528,"sha256":"da86cd3b9a7e8018baf1a5abb7477e66bdb918fd911ad8f43779f95de7b68027"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":705,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":182,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":218,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"PATIENT_COLLECTED","name":"The patient is picked up","group":"The journey","lane":"expected","nodes":["collected","dNoLongerSuits"],"roles":["officer","coordinator"],"does":"Records that the patient has physically been collected and the journey has begun. After this, cancelling is no longer possible — only stopping.","needs":"An open handover-ready movement with a booked en-route job and current medical, gender and legal checks. A valid supplied exception/identity-check record is retained; collection can restore moving after a stage correction without replacing its original physical time. No restrictive practice may still be recorded as in use for the patient at the sending ward.","changes":"Moves the record to moving and stamps the collection.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot collect a patient for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":231}},{"when":"Guard: examinationRevokedHoldingBed || awaitingRelease","message":"cannot collect a patient for movement ${movement.id}: the examination was revoked and this movement still has a bed pulled — a person must release the bed first","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":246}},{"when":"Guard: sourceRestrictiveRefusal","message":"${what} is still recorded as in use for this patient. Record when it ended before they leave the ward","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":278}}],"screen":{"screen":"officer-screen.tsx","control":"Collected"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":97,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":229,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-screen.tsx","line":544,"sha256":"da86cd3b9a7e8018baf1a5abb7477e66bdb918fd911ad8f43779f95de7b68027"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":726,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":233,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":248,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"PATIENT_ARRIVED","name":"The ward says they have arrived","group":"The journey","lane":"expected","nodes":["arrived","dNoTransport"],"roles":["officer","ward","coordinator"],"does":"The officer records delivery of the transport leg only. The receiving ward or coordinator confirms physical arrival, occupies the reserved bed and closes the movement. Physical arrival is irreversible.","needs":"An open movement with collection recorded at moving, or no transport needed and no live job at pulled/handover_ready. The receiving ward must identify itself. Ward arrival additionally checks the matching reservation, identity, bed eligibility and any source stay.","changes":"Officer: stamps transport.arrivedAt and leaves moving open. Ward/coordinator: occupies the held admission, adjusts bed figures and closes arrived; a linked source stay is departed on transfer arrival. When linked journey/stay observation levels diverge, retained accepted-edit sequence decides which is later, including same-minute edits and new edits against legacy history. If neither entry has sequence, the existing timestamp fallback remains (journey wins ties); a winning journey level appends reconciliation history to the stay. A winning journey observation sequence is retained in the stay reconciliation history; genuinely unordered legacy ties retain the existing timestamp/journey fallback.","reasons":[],"refuses":[{"when":"Guard: movement.stage !== \"pulled\" && movement.stage !== \"handover_ready\"","message":"cannot arrive a patient with no transport needed at the movement's current stage (${stageCopy[movement.stage].label}); the bed must be pulled first","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":346}},{"when":"Guard: movement.stage !== \"moving\" || movement.transport?.collectedAt === undefined","message":"cannot arrive a patient at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":353}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"ward ${event.actingUnitId} cannot confirm arrival for a patient accepted at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":372}}],"screen":{"screen":"officer/officer-screen.tsx; tools/ward-tool-feed.tsx; board/ward-board.tsx; patients/patient-transit-operations.tsx","control":"Confirm Arrival"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":98,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":315,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-screen.tsx","line":563,"sha256":"da86cd3b9a7e8018baf1a5abb7477e66bdb918fd911ad8f43779f95de7b68027"},{"path":"src/components/ward-management/tools/ward-tool-feed.tsx","line":217,"sha256":"35b50e734a9396586e280e12df0c557991ce7b20cf0601d932b279a1734add90"},{"path":"src/components/ward-management/board/ward-board.tsx","line":357,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":781,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":354,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":361,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":380,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-observation.ts","line":48,"sha256":"b714525f0d4c6d18d050f9a3600f38c8de4e9a013595a77844c5c492fbdc2e3c"}]}},{"event":"CANCEL_TRANSPORT","name":"Cancel the transport before collection","group":"The journey","lane":"stall","nodes":["sCancelTransport","dCancelLie"],"roles":["coordinator","ed","ward","community"],"does":"Cancels an uncollected live booking, recording its identity and CAD in unwind history. The coordinator may act; ward/community must match their booked sender and a supplied ED place must match booking provenance. Nothing is rebooked.","needs":"An open movement with a live uncollected, undelivered job, an authorised booking desk/place and a listed cancellation reason.","changes":"Deletes the job entirely. The stage does not move and the bed stays held. The job's awaiting-departure and booking-estimate-passed inbox rows get a returned snooze entry and a released ownership entry appended, keeping their earlier history.","reasons":["CANCEL_TRANSPORT_REASONS"],"refuses":[{"when":"Guard: movement.transport.arrivedAt !== undefined","message":"cannot cancel transport for movement ${movement.id} — the patient has arrived","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":834}},{"when":"Guard: movement.transport.collectedAt !== undefined","message":"cannot cancel transport for movement ${movement.id} — the patient has departed","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":837}},{"when":"Guard: movement.transport.bookedBy?.role !== \"ward\" || !event.actingUnitId || movement.transport.bookedBy.unitId !== event.actingUnitId","message":"CANCEL_TRANSPORT raised as ward acting as ${event.actingUnitId} may only cancel transport it booked for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":856}},{"when":"Guard: movement.transport.bookedBy?.placeId && movement.transport.bookedBy.placeId !== event.actingPlaceId","message":"CANCEL_TRANSPORT raised as ED acting as ${event.actingPlaceId} may only cancel transport it booked for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":880}},{"when":"Guard: !CANCEL_TRANSPORT_REASONS.includes(event.reason)","message":"CANCEL_TRANSPORT reason must be chosen from CANCEL_TRANSPORT_REASONS","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":889}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx; community/use-community-screen-overlays.ts","control":"Cancel transport"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":175,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":835,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1444,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/community/use-community-screen-overlays.ts","line":140,"sha256":"647d6312cc81bb2edcb34ac5b2f6214fccfcd4bec1eb3e2f5742fe286eafbb23"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":848,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":851,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":870,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":894,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":903,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"STOP_TRANSPORT","name":"Stop the journey after collection","group":"The journey","lane":"diversion","nodes":["sStopTransport"],"roles":["coordinator","ed"],"does":"Stops a journey with the patient already in the vehicle. Somebody must say where the patient now is. The movement closes and the bed deliberately stays held.","needs":"The patient has been collected, and has not arrived or already been stopped.","changes":"Stamps the stop, its reason and the whereabouts; closes the movement; leaves the bed held until it is separately released.","reasons":["STOP_TRANSPORT_REASONS","TRANSPORT_WHEREABOUTS"],"refuses":[{"when":"Guard: movement.transport.collectedAt === undefined","message":"movement ${movement.id}'s transport has not been collected yet; use CANCEL_TRANSPORT instead","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":990}},{"when":"Guard: movement.transport.arrivedAt !== undefined","message":"movement ${movement.id}'s patient has already arrived","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":996}},{"when":"Guard: !TRANSPORT_WHEREABOUTS.includes(event.whereabouts)","message":"STOP_TRANSPORT whereabouts must be chosen from TRANSPORT_WHEREABOUTS","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1015}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx","control":"Stop transport"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":185,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1013,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1557,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1026,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1032,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1051,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"RECORD_LEFT_DEPARTMENT","name":"Record that they have left the department","group":"The journey","lane":"record","nodes":["edLeft"],"roles":["ed","coordinator"],"does":"Records the time the patient physically left the emergency department.","needs":"An outcome has already been recorded, and this has not been recorded before.","changes":"Stamps the departure time.","reasons":[],"refuses":[{"when":"Guard: movement.leftDepartmentAt !== undefined","message":"movement ${movement.id} has already been recorded as left department","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":555}},{"when":"Guard: movement.edOutcome === undefined","message":"movement ${movement.id} has no ed outcome recorded; record an outcome before marking left department","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":561}}],"screen":{"screen":"ed/ed-screen-row-menu.tsx","control":"Left the department"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":196,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":529,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-row-menu.tsx","line":605,"sha256":"00d889ba5d86974abf82e2dd2ac8644e8de2a6d5c4e736ae39b00c927c49b205"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":533,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":539,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_EXAMINATION","name":"Record an examination outcome","group":"Legal status and examinations","lane":"breach","nodes":["dRevoked","rkExam","sAbandoned"],"roles":["ed","coordinator"],"does":"Records an examination or a permitted repeat. Inpatient/further-examination outcomes record facts only. Revocation while any bed is held retains that bed for a person to release, even before transport commitment. A community order before commitment may close and release.","needs":"The record is open. A second examination is only allowed if the last one ordered a further examination.","changes":"Keeps superseded examinations. After collection or at handover_ready/moving, community-order/revocation records a blocker without refund or closure; revocation with any held bed does the same and tells its ward. Otherwise community-order/revocation closes the search, releases any matching hold, cancels uncollected transport and withdraws requests.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot record an examination for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":580}},{"when":"Guard: previousExamination && previousExamination.outcome !== \"further_examination_ordered\"","message":"movement ${movement.id} was already examined","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":591}}],"screen":{"screen":"ed/use-ed-examination-save.ts","control":"Confirm examination outcome"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":38,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":549,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/use-ed-examination-save.ts","line":145,"sha256":"357b8af4b99fb9c0609a07c4d6230c6be722e71a5f396c7d627909a9ef141fea"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":558,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":569,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"CHANGE_LEGAL_STATUS","name":"Change the legal status","group":"Legal status and examinations","lane":"record","nodes":["occupied","asked","rkLegalStatus"],"roles":["coordinator","ed","ward","community"],"does":"Changes the patient's status under the Mental Health Act, recording who changed it and why. It never reacts on its own — even if this makes an already-accepted bed unlawful, that only surfaces for a human to look at.","needs":"An open movement, sender-kind permission and a listed legal-status-change reason; signed/shared scope further binds the actual sender.","changes":"Sets the status and logs the change.","reasons":["LEGAL_STATUS_CHANGE_REASONS"],"refuses":[{"when":"Guard: movement.closure","message":"cannot change legal status for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1277}},{"when":"Guard: !LEGAL_STATUS_CHANGE_REASONS.includes(event.reason)","message":"CHANGE_LEGAL_STATUS reason must be chosen from LEGAL_STATUS_CHANGE_REASONS","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1285}}],"screen":{"screen":"movements/sent-journey-changes.tsx","control":"Record legal status change"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":113,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1219,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/movements/sent-journey-changes.tsx","line":196,"sha256":"2bc1df9ee01cd20bf12d9fc8d7dee1a31c82589a2c354a0f5d595bd8cca25072"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1227,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1235,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"RECORD_LEGAL_FORM_RECEIVED","name":"Mark a form as physically received","group":"Legal status and examinations","lane":"record","nodes":["occupied","rkForm"],"roles":["ed","ward","community","coordinator"],"does":"Marks that a patient's legal form has physically arrived. Any of the nine forms with a legal clock (1A, 3A, 3C, 3D, 5A, 5B, 6A, 6B, 6C) can be marked, not only Form 1A (owner ruling D-16).","needs":"An open movement sent by this desk kind or coordinator, a supported recorded legal-clock form and no previous receipt. Signed/shared scope further limits the actual sender. An optional typed received time must not be later than now.","changes":"Stamps the receipt: the typed received time when given (marked as typed), otherwise now.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot mark legal form received for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":473}},{"when":"Guard: movement.legalFormReceivedAt !== undefined","message":"legal form for movement ${movement.id} was already marked as received","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":477}},{"when":"Guard: !movement.legalForm || !isLegalClockFormCode(movement.legalForm.code)","message":"movement ${movement.id} does not carry a receivable legal form (legal form ${movement.legalForm?.code ?? \"none\"}), so a legal form receipt cannot be recorded against it","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":485}},{"when":"Guard: event.receivedAt !== undefined && (!Number.isFinite(event.receivedAt) || event.receivedAt > event.now)","message":"The time received can't be later than now. Check the time on the form.","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":491}}],"screen":{"screen":"legal-forms/legal-forms-screen.tsx","control":"Mark Form 1A received (the legal forms screen marks the other eight)"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":59,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":434,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/legal-forms/legal-forms-screen.tsx","line":358,"sha256":"6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":445,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":449,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":457,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"CORRECT_LEGAL_FORM_RECEIPT","name":"Undo a form receipt","group":"Legal status and examinations","lane":"record","nodes":["occupied","rkForm"],"roles":["ed","ward","community","coordinator"],"does":"Undoes a receipt logged by mistake, keeping a record that a correction happened and why.","needs":"An open movement sent by this desk kind, an existing receipt and a listed correction reason; signed/shared scope further binds the actual sender.","changes":"Clears the receipt, and its typed-time mark, and appends the correction.","reasons":["LEGAL_FORM_RECEIPT_CORRECTION_REASONS"],"refuses":[{"when":"Guard: movement.closure","message":"cannot correct a legal form receipt for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":447}},{"when":"Guard: movement.legalFormReceivedAt === undefined","message":"movement ${movement.id} has no recorded legal form receipt to correct","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":451}}],"screen":{"screen":"ed/use-ed-record-save.ts","control":"Save correction"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":65,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":429,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ed/use-ed-record-save.ts","line":200,"sha256":"b2d00eed8f4b907f3817792ae148eaa015d1b860de762bc4d38abd2eb1045de5"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":440,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":444,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"RECORD_LEGAL_FORM_EXPIRY","name":"Record or extend a form's expiry","group":"Legal status and examinations","lane":"record","nodes":["occupied","rkForm","rkExpiryShut"],"roles":["ed","coordinator","ward"],"does":"Records typed paper expiry or a later extension. An explicit correction may move it earlier only with a reason and matching expected paper facts. No statutory duration is computed.","needs":"An existing form and finite typed expiry on an open movement, or the admitting ward’s admitted-stay path. An extension is strictly later; a correction must differ and match the current code, written time and previous expiry.","changes":"Stores the typed expiry, clears any calculated legacy clock, appends basis/author/time history tagged with the zero-based form instance (the count of earlier forms) and, for a correction, its previous facts and reason.","reasons":[],"refuses":[{"when":"Guard: !movement.legalForm","message":"There is no legal form on this record to add an expiry to.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":60}},{"when":"Guard: !Number.isFinite(event.dueAt)","message":"Enter the expiry written on the form.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":65}},{"when":"Guard: correction === undefined && isExtension && event.dueAt \u003c= currentDueAt","message":"An extension's new expiry must be later than the expiry already recorded.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":106}}],"screen":{"screen":"ed/use-ed-expiry-save.ts; legal-forms/legal-forms-screen.tsx","control":"Save expiry"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":75,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":52,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ed/use-ed-expiry-save.ts","line":119,"sha256":"390d0c109a96a4045b56601ad724774fdd964536984fefba4aac3c67787059c9"},{"path":"src/components/ward-management/legal-forms/legal-forms-screen.tsx","line":1277,"sha256":"6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":68,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":73,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":114,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}]}},{"event":"RECORD_MOVEMENT_GENDER","name":"Correct the recorded gender","group":"Legal status and examinations","lane":"record","nodes":["asked","pulled"],"roles":["ed","coordinator"],"does":"Corrects the gender recorded on an open record and, if a ward already holds or has accepted the bed, tells the coordinator to check the placement still suits.","needs":"The record is open and the new value differs from what is there.","changes":"Sets the gender, logs the change, and raises a notice where a bed is involved.","reasons":["REFERRAL_GENDERS"],"refuses":[{"when":"Guard: movement.closure","message":"cannot record gender for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":506}},{"when":"Guard: movement.gender === event.gender","message":"movement ${movement.id} is already recorded as gender ${event.gender}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":512}}],"screen":{"screen":"ed/ed-screen-referred.tsx","control":"Record gender"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":80,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":480,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-referred.tsx","line":266,"sha256":"0b0d6dde9843e2750f4dbadd23e4e7d9c30b2c2c9eee9e4f2c539961a97568aa"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":484,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":490,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_LEAVING","name":"Record that the patient has left","group":"On the ward","lane":"expected","nodes":["personLeaves","bedReleased","end0","end1","end2","end3","end4","end5","end6","end7"],"roles":["ward","coordinator"],"does":"Records physical departure from an occupied stay and retains the departed admission. It is distinct from the protected revision-checked RECORD_PATIENT_DISCHARGE path.","needs":"The caller names the stay’s ward and a listed destination at a finite time no earlier than arrival. No active transit, restrictive-practice or open return-movement conflict. An involuntary community/against-advice departure needs a recorded permitted paper transition.","changes":"Ends the admission and raises the ward's empty and allocatable counts by one (only the timestamps move if this person's release had already been completed), gives back a locked bed, adjusts the sex mix, ends any leave bed, and completes this person's pending bed release.","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== admission.unitId","message":"RECORD_LEAVING was raised acting as unit ${event.actingUnitId} but admission ${admission.id} belongs to unit ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":134}},{"when":"Guard: admission.state === \"departed\"","message":"admission ${admission.id} has already left","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":140}},{"when":"Guard: admission.state !== \"occupied\"","message":"admission ${admission.id} is ${admission.state}, and only somebody occupying a bed can leave one","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":148}}],"screen":{"screen":"ward-board.tsx (+1 other)","control":"Record that they have left The ward departure caller retains one pending subject through an uncertain failed outcome that carries confirmation, follows only the same command receipt and scopes Undo to the receipt-created departure step. Old-world completions must not free a replacement world command or advertise stale Undo; ordinary reset keeps the screen DOM so opener focus can be restored."},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":220,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":122,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":1217,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1745,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/tools/ward-tool-feed.tsx","line":218,"sha256":"35b50e734a9396586e280e12df0c557991ce7b20cf0601d932b279a1734add90"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":254,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/board/ward-board.tsx","line":885,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":134,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":140,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":148,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_AWAY_AT_EMERGENCY_DEPARTMENT","name":"Record that they are away at an ED","group":"On the ward","lane":"diversion","nodes":["dAway"],"roles":["ward","coordinator"],"does":"Notes that an admitted patient has gone to an emergency department for a medical problem, while the ward keeps their bed.","needs":"An occupied stay on the named acting ward, no existing ED absence, and no simultaneous leave or absence-without-leave record. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Stamps the absence. No bed figure moves at all.","reasons":[],"refuses":[{"when":"Guard: admission.awayAtEmergencyDepartmentSince !== null","message":"admission ${admission.id} is already recorded as away at an emergency department","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":229}},{"when":"Guard: heldBed","message":"admission ${admission.id} is ${heldBed.absentWithoutLeave ? \"absent without leave\" : \"on leave\"} (${heldBed.id}); record the return first","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":238}}],"screen":{"screen":"ward-board.tsx","control":"Record that they have gone to an emergency department"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":232,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":208,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward/ward-screen-overlays.tsx","line":273,"sha256":"27f313a7a06534fcdb3003ce8e31074b16648e74280f57980b2e051d81a16dd8"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":445,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/board/ward-board.tsx","line":904,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":701,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":229,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":238,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_RETURNED_FROM_EMERGENCY_DEPARTMENT","name":"Record that they are back","group":"On the ward","lane":"diversion","nodes":["dAway"],"roles":["ward","coordinator"],"does":"Notes that a patient who went to an emergency department is back on the ward, in the bed that was kept for them.","needs":"The named acting ward owns the stay and it is recorded away at ED. The handler does not additionally require occupied state, so a recorded absence can be cleared. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Clears the absence.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":246}},{"when":"Guard: admission.awayAtEmergencyDepartmentSince === null","message":"admission ${admission.id} is not recorded as away at an emergency department","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":257}}],"screen":{"screen":"ward-board.tsx","control":"Record that they are back on the ward"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":233,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":244,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward/ward-screen-overlays.tsx","line":284,"sha256":"27f313a7a06534fcdb3003ce8e31074b16648e74280f57980b2e051d81a16dd8"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":477,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/board/ward-board.tsx","line":988,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":717,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":246,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":257,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_LEAVE_BED","name":"Record a bed as on leave","group":"On the ward","lane":"diversion","nodes":["dAway"],"roles":["ward","coordinator"],"does":"Records that a bed is held for somebody on approved leave, with an expected return. It does not go back into circulation while they are away.","needs":"A real occupied admission on the named acting ward, no existing leave/absence and no current ED absence. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Creates the leave record.","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== event.unitId","message":"RECORD_LEAVE_BED was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":314}},{"when":"Guard: onLeave.unitId !== event.unitId","message":"RECORD_LEAVE_BED names admission ${onLeave.id} on unit ${onLeave.unitId}, not unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":326}}],"screen":{"screen":"patients/patient-now-screen.tsx","control":"Leave recording through the patient workspace; command dispatch is present"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":208,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":317,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":680,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":324,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":336,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"END_LEAVE_BED","name":"End a bed's leave","group":"On the ward","lane":"diversion","nodes":["dAway"],"roles":["ward","coordinator"],"does":"Ends a bed's recorded leave period.","needs":"The leave record exists and belongs to this ward. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Removes the leave record. The step can be taken back by UNDO_BED_STEP within the Undo window.","reasons":[],"refuses":[{"when":"Guard: !leaveBed","message":"no leave bed found for id ${event.leaveBedId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":672}},{"when":"Guard: event.actingUnitId !== leaveBed.unitId","message":"END_LEAVE_BED was raised acting as unit ${event.actingUnitId} but leave bed ${leaveBed.id} belongs to unit ${leaveBed.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":677}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Ended"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":209,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":654,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1770,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/board/ward-board.tsx","line":980,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":623,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":656,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":661,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"FLAG_BED_RELEASE","name":"Flag a bed as coming free","group":"The bed coming free","lane":"expected","nodes":["bedReleased","ready"],"roles":["ward","bed_manager","coordinator"],"does":"A ward flags an upcoming discharge for a named occupying admission, saying when and what it is waiting on.","needs":"The ward may only flag a stay on its own ward, with no other live release for that stay.","changes":"Creates the bed release at “expected”.","reasons":["BED_RELEASE_WAITING_ON","BED_RELEASE_BLOCKERS"],"refuses":[{"when":"Guard: event.actingUnitId !== event.unitId","message":"FLAG_BED_RELEASE was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":398}},{"when":"Guard: event.blocker !== undefined && !BED_RELEASE_BLOCKERS.includes(event.blocker)","message":"FLAG_BED_RELEASE blocker must be chosen from BED_RELEASE_BLOCKERS","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":443}}],"screen":{"screen":"NONE","control":"Source references only; full route reachability and control wording need rendered proof."},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":199,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":370,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":377,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":422,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"CONFIRM_BED_RELEASE","name":"Confirm the discharge is going ahead","group":"The bed coming free","lane":"expected","nodes":["bedReleased","ready"],"roles":["ward","bed_manager","coordinator"],"does":"Confirms an expected discharge is now decided. It does not free the bed — that is a separate step.","needs":"The release is currently expected.","changes":"Moves expected to confirmed, clears waitingOn and records the linked admission’s discharge decision. A blocker survives; no bed is freed. A sign-off from Ward Decisions can be taken back for a short time by UNDO_RELEASE_STEP on the same release (M37, D-129).","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"CONFIRM_BED_RELEASE was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":492}},{"when":"Guard: release.state !== \"expected\"","message":"cannot move release ${release.id} from ${release.state} to confirmed","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":498}}],"screen":{"screen":"ward-screen.tsx","control":"Confirm"},"review":{"reviewedOn":"2026-11-10","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":200,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":464,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1683,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":473,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":479,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"REVERT_BED_RELEASE","name":"Put a confirmed discharge back to expected","group":"The bed coming free","lane":"stall","nodes":["bedReleased","bedStuck","ready"],"roles":["ward","bed_manager","coordinator"],"does":"Reverses a confirmed discharge decision, restating what it is now waiting on. The only step of the three that goes backwards.","needs":"The release is currently confirmed.","changes":"Moves confirmed to expected with listed waitingOn and clears the linked admission’s discharge decision. The blocker survives.","reasons":["BED_RELEASE_WAITING_ON"],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"REVERT_BED_RELEASE was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":531}},{"when":"Guard: release.state !== \"confirmed\"","message":"cannot move release ${release.id} from ${release.state} to expected","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":537}},{"when":"Guard: !BED_RELEASE_WAITING_ON.includes(event.waitingOn)","message":"REVERT_BED_RELEASE waitingOn must be chosen from BED_RELEASE_WAITING_ON","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":542}}],"screen":{"screen":"NONE","control":"Source references only; full route reachability and control wording need rendered proof."},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":204,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":503,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":512,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":518,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":523,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"BLOCK_BED_RELEASE","name":"Flag a discharge as stuck","group":"The bed coming free","lane":"stall","nodes":["bedStuck"],"roles":["ward","bed_manager","coordinator"],"does":"Flags that a discharge — expected or confirmed — is currently stuck, and says why. Being stuck is a flag, not a stage.","needs":"The bed has not already been released.","changes":"Stores the listed blocker and actor/time on the release and linked stay. The release stage remains unchanged.","reasons":["BED_RELEASE_BLOCKERS"],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"BLOCK_BED_RELEASE was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":568}},{"when":"Guard: !event.blocker || !BED_RELEASE_BLOCKERS.includes(event.blocker)","message":"BLOCK_BED_RELEASE requires a blocker chosen from BED_RELEASE_BLOCKERS","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":574}},{"when":"Guard: release.state === \"discharged\"","message":"cannot block release ${release.id} because it is already released","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":581}}],"screen":{"screen":"board/ward-board-blocker-dialog.tsx","control":"Confirm blocked"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":205,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":542,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/board/ward-board-blocker-dialog.tsx","line":73,"sha256":"6d6cfae35d61c34b3ac76b235a2a8e23875c7be085ecef1532dbd5f3f36a174c"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":549,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":555,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":562,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"CLEAR_BED_RELEASE_BLOCK","name":"Clear the stuck flag","group":"The bed coming free","lane":"expected","nodes":["bedStuck"],"roles":["ward","bed_manager","coordinator"],"does":"Clears the stuck flag once whatever was holding the discharge up has been resolved.","needs":"There is a flag to clear.","changes":"Clears the release and linked stay blocker; retains clearance time/role, prior blocker and any supplied listed clearance reason.","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"CLEAR_BED_RELEASE_BLOCK was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":605}},{"when":"Guard: release.blocker === null","message":"release ${release.id} carries no blocked flag to clear","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":611}}],"screen":{"screen":"ward-screen.tsx","control":"No longer held up"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":206,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":582,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1702,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/discharges/discharge-board.tsx","line":502,"sha256":"ecf458cf14c85ca2977016749fdaa85569920ec790d4a37c9d7b1be21e3d4ac9"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":589,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":595,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"SET_BED_PREPARATION","name":"Mark a bed as being made ready","group":"The bed coming free","lane":"record","nodes":["bedReleased","rkPrep"],"roles":["ward","bed_manager","coordinator"],"does":"Marks a bed as being cleaned or awaiting repair. This is information only — it never stops the bed being counted as available or offered to somebody.","needs":"The ward may only set it on its own release.","changes":"Sets the note. No capacity figure moves.","reasons":["BED_PREPARATION_NOTES"],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"SET_BED_PREPARATION was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":645}},{"when":"Guard: requestedNote !== undefined && !(BED_PREPARATION_NOTES as readonly string[]).includes(requestedNote)","message":"SET_BED_PREPARATION note must be chosen from BED_PREPARATION_NOTES","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":653}}],"screen":{"screen":"ward/ward-screen-overlays.tsx","control":"Confirm being made ready"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":207,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":619,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen-overlays.tsx","line":296,"sha256":"27f313a7a06534fcdb3003ce8e31074b16648e74280f57980b2e051d81a16dd8"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":629,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":637,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"CONFIRM_CAPACITY","name":"Restate how many beds a ward has","group":"The ward's own numbers","lane":"record","nodes":["asked"],"roles":["ward","bed_manager","coordinator"],"does":"A ward restates how many beds it can currently allocate. This does move a real bed count.","needs":"The ward may only restate its own, with a current revision and a nonnegative whole number no greater than its bed count.","changes":"Sets the allocatable figure, marks it as ward-sourced, and stamps the time.","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== event.unitId","message":"CONFIRM_CAPACITY was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":329}},{"when":"Guard: event.value > unit.beds","message":"CONFIRM_CAPACITY says unit ${unit.id} can allocate ${event.value} beds, which is more than the ${unit.beds} beds it has","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":350}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Confirm capacity"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":100,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":298,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1591,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward/ward-answer-view.tsx","line":492,"sha256":"fb9fd5b92aaf4cac6a3397267e1dff8062ed70bbc9333b6476a77663ae83b37c"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":308,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":329,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"RECORD_WARD_INTAKE_CONSTRAINTS","name":"Record what is restricting a ward's intake","group":"The ward's own numbers","lane":"record","nodes":["asked"],"roles":["ward","coordinator"],"does":"A ward records the restrictions it is currently operating under — staffing, infection control, a closed bay, and so on.","needs":"The ward may only record its own.","changes":"Replaces its constraint list.","reasons":["WARD_INTAKE_CONSTRAINTS"],"refuses":[{"when":"Guard: event.actingUnitId !== event.unitId","message":"RECORD_WARD_INTAKE_CONSTRAINTS was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":820}},{"when":"Guard: event.codes.some((code) => !WARD_INTAKE_CONSTRAINTS.includes(code))","message":"RECORD_WARD_INTAKE_CONSTRAINTS codes must all be chosen from WARD_INTAKE_CONSTRAINTS","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":830}}],"screen":{"screen":"NONE","control":"Source references only; full route reachability and control wording need rendered proof."},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":103,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":767,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":774,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":784,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"REQUEST_CAPACITY_REFRESH","name":"Ask a ward to refresh its numbers","group":"The ward's own numbers","lane":"record","nodes":["asked"],"roles":["coordinator"],"does":"Records that somebody asked a ward to refresh its bed numbers. It changes no bed count itself.","needs":"The ward exists.","changes":"Logs the request.","reasons":[],"refuses":[{"when":"Guard: !unit","message":"no unit found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":702}}],"screen":{"screen":"capacity-screen.tsx","control":"Request update"},"review":{"reviewedOn":"2026-11-09","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":376,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":682,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/hub/hub-screen.tsx","line":725,"sha256":"48bf478fbb659cdfe32bf9915e52a2e396c9fde1f33e09c3c2fa4c82f27f20c8"},{"path":"src/components/ward-management/capacity/capacity-ward-drawer.tsx","line":237,"sha256":"c491da820b4c6f942c6a98ef83eef3742c493a612a36e6e9abae92fd892ab554"},{"path":"src/components/ward-management/capacity/capacity-screen.tsx","line":202,"sha256":"ecc814d195ffaeb48c7fc9b72270a832a9fd6fd95f30650133d6c4a4ca229a0c"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":686,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"CHANGE_URGENCY","name":"Change how urgent it is","group":"Urgency and blockers","lane":"record","nodes":["asked","rkUrgent"],"roles":["coordinator","ed","ward","community"],"does":"Changes the urgency, recording who changed it and why. It triggers no re-sorting or re-referral on its own.","needs":"An open movement, sender-kind permission and a listed urgency level. A supplied reason must be listed; omission is recorded as not_given. Signed/shared scope further binds the actual sender.","changes":"Sets the urgency and logs the change.","reasons":["URGENCY_CHANGE_REASONS","URGENCY_LEVELS"],"refuses":[{"when":"Guard: !URGENCY_LEVELS.includes(event.urgency as (typeof URGENCY_LEVELS)[number])","message":"CHANGE_URGENCY urgency must be chosen from URGENCY_LEVELS","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1239}},{"when":"Guard: event.reason !== undefined && !URGENCY_CHANGE_REASONS.includes(event.reason)","message":"CHANGE_URGENCY reason must be chosen from URGENCY_CHANGE_REASONS","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1248}}],"screen":{"screen":"movements/sent-journey-changes.tsx","control":"Record urgency change"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":112,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1178,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/movements/sent-journey-changes.tsx","line":170,"sha256":"2bc1df9ee01cd20bf12d9fc8d7dee1a31c82589a2c354a0f5d595bd8cca25072"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1189,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1198,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"FLAG_MOVEMENT_URGENT","name":"Flag it urgent","group":"Urgency and blockers","lane":"record","nodes":["asked","pulled","rkUrgent","rkQueue"],"roles":["coordinator","ed"],"does":"Marks the patient urgent so they sit above every urgency level in the coordinator's queue, recording who and why.","needs":"The record is open and not already flagged.","changes":"Sets the flag and opens a history entry.","reasons":["URGENT_MARK_REASONS"],"refuses":[{"when":"Guard: movement.flaggedUrgent","message":"movement ${movement.id} is already flagged urgent","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2064}},{"when":"Guard: !URGENT_MARK_REASONS.includes(event.reason)","message":"FLAG_MOVEMENT_URGENT reason must be chosen from URGENT_MARK_REASONS","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2067}}],"screen":{"screen":"movement-drawer.tsx (+1 other)","control":"Flag this patient as urgent"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":352,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2070,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-drawer.tsx","line":401,"sha256":"0078e33c1bd4d2308ec3cffeb86545370c49996efe564c889909e00005d07550"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1261,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2102,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2105,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"CLEAR_MOVEMENT_URGENT_FLAG","name":"Clear the urgent flag","group":"Urgency and blockers","lane":"record","nodes":["asked","pulled","rkUrgent"],"roles":["coordinator","ed"],"does":"Removes the urgent flag once it is no longer needed.","needs":"It is currently flagged. Deliberately allowed even on a closed record.","changes":"Clears the flag and closes the history entry.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2082}},{"when":"Guard: !movement.flaggedUrgent","message":"movement ${movement.id} is not flagged urgent","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2086}}],"screen":{"screen":"movement-drawer.tsx (+1 other)","control":"Remove the urgent flag"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":353,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2094,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-drawer.tsx","line":358,"sha256":"0078e33c1bd4d2308ec3cffeb86545370c49996efe564c889909e00005d07550"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1211,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2096,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2128,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"RECORD_MOVEMENT_BLOCKER","name":"Say what is holding this up","group":"Urgency and blockers","lane":"record","nodes":["asked","pulled","handover"],"roles":["ed","community","ward","coordinator","officer"],"does":"Free text describing what is actually holding the patient up. The only free-text field of its kind in the engine.","needs":"An open movement and nonblank text. An unresolved revoked-examination or diversion hold cannot be overwritten; a case-only variant of a no-blocker sentinel refuses and directs to CLEAR_MOVEMENT_BLOCKER.","changes":"Replaces the blocker text.","reasons":[],"refuses":[{"when":"Guard: blocker.length === 0","message":"RECORD_MOVEMENT_BLOCKER blocker must say something — a blank is not a statement","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":787}},{"when":"Guard: nearMiss !== undefined","message":"\"${blocker}\" differs from \"${nearMiss}\" only in case, and would be stored as an active blocker — use CLEAR_MOVEMENT_BLOCKER to say nothing is holding this up","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":805}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx","control":"Record it"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":280,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":710,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1304,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":741,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":759,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"CLEAR_MOVEMENT_BLOCKER","name":"Say nothing is holding it up","group":"Urgency and blockers","lane":"record","nodes":["asked","pulled","handover"],"roles":["ed","community","ward","coordinator","officer"],"does":"Records that nothing is holding the patient up any more — which is a different statement from nobody ever having recorded one.","needs":"An open movement with an active blocker, and no unresolved revoked-examination or diversion hold. The explicit hold must be resolved through reassessment/release rather than cleared as prose.","changes":"Writes “None — cleared”.","reasons":["BLOCKERS_MEANING_NOTHING_IS_BLOCKING"],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2118}},{"when":"Guard: BLOCKERS_MEANING_NOTHING_IS_BLOCKING.some((inactive) => inactive === movement.blocker.trim())","message":"movement ${movement.id} already records that nothing is holding it up","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2147}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx","control":"Clear — nothing is holding this up"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":287,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2130,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1365,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2132,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2161,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"MARK_NOTICE_READ","name":"Mark a notice read","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["coordinator","ed","ward","officer","community","bed_manager"],"does":"Marks a notice as read by the person or team it was actually addressed to.","needs":"You are the addressee, exactly, and it is not already marked.","changes":"Stamps who read it and when.","reasons":[],"refuses":[{"when":"Guard: notice.to.role !== event.role || notice.to.placeId !== event.actingPlaceId","message":"MARK_NOTICE_READ role/actingPlaceId (${event.role}/${event.actingPlaceId ?? \"none\"}) must match notice ${event.noticeId}'s own addressee (${notice.to.role}/${notice.to.placeId ?? \"none\"})","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":297}},{"when":"Guard: notice.readAt !== undefined","message":"notice ${event.noticeId} is already marked read","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":301}}],"screen":{"screen":"shell/ward-bar-state.ts; community/community-screen.tsx; ward/ward-screen.tsx","control":"Mark as read"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":505,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":290,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/shell/ward-bar-state.ts","line":316,"sha256":"8272a84387337469217e8a70798c6b37922f30bb1e3eaf8a185fdc504f9a34a3"},{"path":"src/components/ward-management/community/community-screen.tsx","line":832,"sha256":"4cce4397ba7d06901141717dd89e58cf12315dc45e90f35604b527e6cebf5671"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1099,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":297,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":301,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"}]}},{"event":"ACKNOWLEDGE_INBOX_ITEM","name":"Acknowledge an inbox row","group":"The coordinator's inbox","lane":"record","nodes":["rkInbox"],"roles":["coordinator"],"does":"Records that the coordinator has seen a row and is on top of it, without removing or hiding it.","needs":"The row names a real category and a real record.","changes":"Logs the acknowledgement. Touches nothing else.","reasons":[],"refuses":[{"when":"Guard: inboxItemId.length === 0","message":"ACKNOWLEDGE_INBOX_ITEM inboxItemId must name a row — a blank names nothing","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":315}},{"when":"Guard: !inboxCategory || !namesRecord","message":"ACKNOWLEDGE_INBOX_ITEM inboxItemId ${inboxItemId} does not name a real inbox row — its prefix must be one of INBOX_CATEGORIES and its remainder an existing record for that category","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":336}}],"screen":{"screen":"alerts-screen.tsx (+1 other)","control":"Acknowledge Alert"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":526,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":312,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-tasks-drawer.tsx","line":428,"sha256":"f14b8983f1421e5ab23f25dd3d11d6489cf9119e06884a1fcb58e8374c68018f"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":670,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":315,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":336,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"}]}},{"event":"COMPLETE_INBOX_ITEM","name":"Tick off an inbox row","group":"The coordinator's inbox","lane":"record","nodes":["rkInbox"],"roles":["coordinator"],"does":"Records completion of a classified human commitment. The current commitment is the coordinator’s daily check, whose id must name a signed integer day. Live fact rows cannot be ticked away.","needs":"A nonblank classified commitment id, a valid daily-check day suffix and no current completion. This is a daily-check record, not proof that any patient/bed action was performed.","changes":"Appends completed role/time history without mutating patient, movement or unit facts.","reasons":[],"refuses":[{"when":"Guard: inboxItemId.length === 0","message":"COMPLETE_INBOX_ITEM inboxItemId must name a row — a blank names nothing","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":352}},{"when":"Guard: inboxItemId.startsWith(INBOX_CATEGORIES.daily_check.idPrefix) && !/^day-(?:0|-?[1-9]\\d*)$/.test(inboxItemId.slice(INBOX_CATEGORIES.daily_check.idPrefix.length))","message":"inbox row ${inboxItemId} does not name a day for the daily check","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":369}},{"when":"Guard: inboxItemCompletionState(history) === \"complete\"","message":"inbox row ${inboxItemId} is already complete","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":373}}],"screen":{"screen":"delays/daily-check-line.tsx; ward-tasks-drawer.tsx","control":"Daily check completion; generic commitment action when supplied"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":527,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":349,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-tasks-drawer.tsx","line":432,"sha256":"f14b8983f1421e5ab23f25dd3d11d6489cf9119e06884a1fcb58e8374c68018f"},{"path":"src/components/ward-management/delays/daily-check-line.tsx","line":286,"sha256":"488ea1f4f5286bbff224f264bfd40e405af78caae5ac7fe88f197679394d43f0"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":352,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":369,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":373,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"}]}},{"event":"REOPEN_INBOX_ITEM","name":"Reopen a completed row","group":"The coordinator's inbox","lane":"record","nodes":["rkInbox"],"roles":["coordinator"],"does":"Undoes a completed row, while keeping the fact that it was once completed.","needs":"It is currently complete.","changes":"Logs the reopening.","reasons":[],"refuses":[{"when":"Guard: inboxItemId.length === 0","message":"REOPEN_INBOX_ITEM inboxItemId must name a row — a blank names nothing","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":387}},{"when":"Guard: inboxItemCompletionState(history) !== \"complete\"","message":"inbox row ${inboxItemId} is not complete, so there is nothing to reopen","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":391}}],"screen":{"screen":"ward-tasks-drawer.tsx","control":"Generic completion-history reopening action when a completed commitment is supplied"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":528,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":384,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-tasks-drawer.tsx","line":436,"sha256":"f14b8983f1421e5ab23f25dd3d11d6489cf9119e06884a1fcb58e8374c68018f"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":387,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":391,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"}]}},{"event":"ADVANCE_CLOCK","name":"Move the demonstration clock","group":"Running the demonstration","lane":"record","nodes":["rkClock"],"roles":["demo"],"does":"Adds a finite nonnegative simulation offset to the app clock. Ordinary provider time follows wall time, refreshing at minute boundaries while visible and catching up on return; initialNow pins deterministic test/render time.","needs":"The demo role and finite nonnegative minutes; coordinator is not in this event’s permission list.","changes":"Increases clockOffsetMinutes; it does not itself create a legal expiry or resolve a timed task. In the local provider, command acceptance precedes device durability: the saved-on-device flag remains false until the matching committed safe copy is written, and owned unsaved work is protected on unload. These persistence indicators do not add an engine transition.","reasons":[],"refuses":[{"when":"Guard: finiteInstant(event.minutes) === null || event.minutes \u003c 0","message":"ADVANCE_CLOCK minutes must be a finite, non-negative number","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1800}}],"screen":{"screen":"ward-global-search.tsx; tools/ward-demo-panel.tsx","control":"Global Search offers Advance demo clock (+15m), dispatching minutes=15 under role demo; the Demo panel also offers +15 min and +1 hour. Imperative search navigation and desk switching first consult the composed unsaved-work guard."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":105,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1807,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-global-search.tsx","line":1275,"sha256":"b7c651d7a0a3110b10e5d46aeb7ab769359393240cf55bb4024fc570504185ac"},{"path":"src/components/ward-management/tools/ward-demo-panel.tsx","line":268,"sha256":"002918ecd56f5d0f951247f9cbc1b96adccea94e8d024b3a82cb0ed46b6dbebc"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":440,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"},{"path":"src/components/ward-management/use-ward-minute-tick.ts","line":12,"sha256":"5637f3746158c8b09a50abf19699294ced1b1d25e91be6a7b03e870c746f7fa7"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1811,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"RESET_SCENARIO","name":"Reset the board","group":"Running the demonstration","lane":"record","nodes":[],"roles":["demo"],"does":"Restores the currently loaded recognised scenario, falling back to standard for a damaged scenario value.","needs":"Nothing.","changes":"Re-seeds all board state around the current visible time and clears the simulation offset, preserving the visible clock rather than always selecting the standard scenario. A genuine accepted reseed advances worldGeneration exactly once; wrong-role/rejected reseeds do not. A non-safe or exhausted generation refuses replacement by retaining the old state, so generation is never wrapped or reused. Reset also invalidates older asynchronous local scenario-file import requests. A newer import, reset, changed world generation or retired provider lifetime prevents an older read from replacing the current day. Imported local state is not reported durable before its device copy is written.","reasons":[],"refuses":[],"screen":{"screen":"ward-flow-provider.tsx; tools/ward-demo-panel.tsx","control":"Reset scenario"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":106,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1789,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":1133,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"},{"path":"src/components/ward-management/tools/ward-demo-panel.tsx","line":197,"sha256":"002918ecd56f5d0f951247f9cbc1b96adccea94e8d024b3a82cb0ed46b6dbebc"}]}},{"event":"SET_SCENARIO","name":"Switch to a different simulated night","group":"Running the demonstration","lane":"record","nodes":[],"roles":["demo"],"does":"Switches to a different pre-built simulated night, resetting every patient, ward and record.","needs":"A recognised scenario.","changes":"Replaces the whole state. A genuine accepted reseed advances worldGeneration exactly once; wrong-role/rejected reseeds do not. A non-safe or exhausted generation refuses replacement by retaining the old state, so generation is never wrapped or reused.","reasons":["WARD_SCENARIOS"],"refuses":[{"when":"Guard: !WARD_SCENARIOS.includes(event.scenario)","message":"SET_SCENARIO scenario must be chosen from WARD_SCENARIOS","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1791}}],"screen":{"screen":"demo-reset/ward-demo-reset.tsx; tools/ward-demo-panel.tsx","control":"Both pickers ask before replacing the synthetic world. The separate Demo reset waits for the command outcome, keeps choices unavailable while it is pending, and reports a current accepted replacement as complete. Failed, refused, cancelled or unknown completion is not reported as success, and obsolete or unmounted results do not announce into a replacement workspace."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":107,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1797,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/demo-reset/ward-demo-reset.tsx","line":131,"sha256":"8e2f79f5ec7d9a3e37df33fde6bad92cafe4a8412191b49c10751dd2bf600c9e"},{"path":"src/components/ward-management/tools/ward-demo-panel.tsx","line":197,"sha256":"002918ecd56f5d0f951247f9cbc1b96adccea94e8d024b3a82cb0ed46b6dbebc"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1802,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"SET_CONFIGURATION","name":"Change the coordinator's settings","group":"Running the demonstration","lane":"record","nodes":["rkSettings"],"roles":["coordinator"],"does":"Saves the tunable settings the rest of the system reads — access-time targets, the parallel referral cap, how long a bed hold lasts.","needs":"A validated complete configuration and, when supplied, a valid baseline. Conflicting edits since that baseline refuse; non-conflicting draft fields merge. Signed/shared access also enforces coordinator scope.","changes":"Applies the validated configuration or field merge atomically. It does not silently overwrite a conflicting baseline.","reasons":[],"refuses":[],"screen":{"screen":"settings-screen.tsx","control":"Save Configuration"},"review":{"reviewedOn":"2026-11-08","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":109,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1818,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/settings/settings-screen.tsx","line":443,"sha256":"aba9a6945556afdd1f1dba22fdb45f47b7f7e197829ff42ea2d94bdfb9ee3ab1"}]}},{"event":"RECORD_PATIENT_DISCHARGE","name":"Record a patient’s physical departure","group":"Not wired up here","lane":"record","nodes":["rkDischarge","personLeaves"],"roles":["ward","coordinator"],"does":"The protected discharge handler records physical departure of a linked occupied admission. It runs before the generic reducer switch; the later grouped switch case is not the behaviour.","needs":"Permitted ward/coordinator actor, finite time, current world generation and discharge revision, matching linked patient/stay, lawful destination and no active transit/restrictive-practice/open-return conflict.","changes":"Departs the stay through the shared departure helper, adjusts resources, retains audit and a bounded step-undo record. A stale or inaccessible request refuses.","reasons":[],"refuses":[{"when":"Guard: dischargeBlockingTransit(state, admission)","message":"Patient is currently in transit to another facility.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":445}}],"screen":{"screen":"ward-flow-provider.tsx (discharge context)","control":"Record departure through the discharge record context"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":22,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":471,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":1236,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":481,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"}]}},{"event":"OPEN_DISCHARGE_RECORD","name":"Open an authorised discharge record","group":"Not wired up here","lane":"record","nodes":["rkDischarge"],"roles":["coordinator","ward","community","bed_manager"],"does":"Checks actor access to a discharge record and appends its protected open/read audit receipt. It runs before the generic switch.","needs":"A valid actor, current generation, valid request id/optional namespace and an accessible admission. A coordinator must also give an on-behalf-of-the-ward reason from the closed `ON_BEHALF_REASONS` list (D-80 item 17); any other desk sends none. A repeated matching receipt is reused only while that read remains allowed.","changes":"Records an accepted read audit event, carrying the coordinator's listed reason as `onBehalfReason`; changes no admission or bed figure.","reasons":[],"refuses":[{"when":"Guard: event.role === \"coordinator\" ? !isOnBehalfReason(event.onBehalfReason) : event.onBehalfReason !== undefined","message":"Choose why you are opening this ward's record on the ward's behalf. Nothing was opened.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":186}}],"screen":{"screen":"ward-flow-provider.tsx (discharge context)","control":"Open the discharge record through its audited context; the Discharges board and the Capacity ward drawer ask a coordinator for the reason first"},"review":{"reviewedOn":"2026-11-09","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":25,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":178,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":1265,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"}]}},{"event":"REVIEW_AUDIT_EVENT","name":"Record a governance review","group":"Not wired up here","lane":"record","nodes":[],"roles":["coordinator"],"does":"The coordinator records one listed review decision against an accessible audit event, including supported synthetic governance entries. It runs before the generic switch.","needs":"Coordinator, finite time, current generation and expected review count, a non-review audit entry in this generation and safe counters.","changes":"Appends a uniquely sequenced review and its audit record. A later review changes the expected count; UNDO_AUDIT_REVIEW is a separate recorded action.","reasons":[],"refuses":[],"screen":{"screen":"governance-registers.tsx","control":"Governance review decision"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":26,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":131,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/governance-registers.tsx","line":546,"sha256":"c68c89bd3aa60a17ca378d9e3f369d3ee42ffa57ac035d1ca8ebd4e29c8b634d"}]}},{"event":"RECORD_DIVERSION","name":"Divert a journey already under way","group":"The journey","lane":"diversion","nodes":["rkDiversion"],"roles":["officer","coordinator"],"does":"Records that a patient already in the vehicle was taken somewhere other than the ward expecting them, with a reason and the place they went.","needs":"A transport job that has been collected, on a movement that is open, not arrived, not already stopped or cancelled, and not already diverted.","changes":"Marks the movement diverted and records where the patient is. The held bed is NOT given back by this act.","reasons":["DIVERSION_REASONS"],"refuses":[{"when":"Guard: movement.transport.collectedAt === undefined","message":"movement ${movement.id}'s transport has not been collected yet; diversion is only for a journey already under way","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1150}},{"when":"Guard: movement.transport.arrivedAt !== undefined","message":"movement ${movement.id}'s patient has already arrived","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1154}},{"when":"Guard: movement.transport.stoppedAt !== undefined || movement.transport.cancelledAt !== undefined","message":"movement ${movement.id}'s transport was already stopped or cancelled","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1157}},{"when":"Guard: movement.transport.diversion","message":"movement ${movement.id} was already diverted","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1160}},{"when":"Guard: !DIVERSION_REASONS.includes(event.reason)","message":"RECORD_DIVERSION reason must be chosen from DIVERSION_REASONS","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1163}}],"screen":{"screen":"officer/officer-job-detail.tsx (via use-officer-diversion-save.ts); movements/movement-workspace-cockpit.tsx","control":"Divert Diversion reason/place and pending save are guarded against outer dismissal. Draft and completion belong to the same access lifetime, movement and transport job; another job is not recorded or dismissed by an old completion."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":192,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1092,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/officer/use-officer-diversion-save.ts","line":66,"sha256":"bd611831cda3c81a8e99cf89c4d375acbb2e9e95948890a8880e7a9b4425b77b"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1678,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1105,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1109,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1112,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1115,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1118,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RELEASE_DIVERTED_BED","name":"Give back the bed a diverted patient was holding","group":"Holding the bed","lane":"record","nodes":["rkDiversion"],"roles":["coordinator","ward","ed"],"does":"Releases the bed still held for a movement that was diverted. Separate from the diversion itself, deliberately: diverting somebody does not decide what happens to their bed.","needs":"A movement that really was diverted, and that still holds a bed.","changes":"Returns the bed to the ward's figures.","reasons":[],"refuses":[{"when":"Guard: movement.transport?.diversion === undefined","message":"movement ${movement.id} was not diverted, so there is no diverted bed to release this way","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":634}},{"when":"Guard: movement.closure !== undefined || !movementHoldsBedByStage(movement)","message":"movement ${movement.id} has no bed pulled — it may already have been released","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":640}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"RELEASE_DIVERTED_BED was raised acting as unit ${event.actingUnitId} but movement ${movement.id}'s bed is pulled at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":646}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx; ward/ward-arrivals-corridor.tsx; ed/ed-screen-referred.tsx","control":"Release the diverted bed"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":194,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":686,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1168,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward/ward-arrivals-corridor.tsx","line":662,"sha256":"572956c1b4769defd00bc1a5dc027ff2d76c476388cee6d36833c8321e3824a4"},{"path":"src/components/ward-management/ed/ed-screen-referred.tsx","line":357,"sha256":"0b0d6dde9843e2750f4dbadd23e4e7d9c30b2c2c9eee9e4f2c539961a97568aa"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":693,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":699,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":705,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"SET_ARRIVAL_DETAILS","name":"Record how and when they are expected","group":"The journey","lane":"record","nodes":["edExpected"],"roles":["coordinator","ed","ward","community"],"does":"Records the way the patient is travelling, any tracking number, and the time they are expected.","needs":"An open movement with an accepted ward. A ward names itself and matches that receiving ward; coordinator may also act.","changes":"Stores arrival mode, optional tracking and estimate, retaining first-record author/time and later update provenance. Keeps the pull-expiry timer. An already-late estimate can send one-time ED/ward notices; it reserves no bed and moves no stage.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1132}},{"when":"Guard: movement.closure","message":"cannot update arrival details on closed movement","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1134}}],"screen":{"screen":"arrival-time-modal.tsx","control":"Set arrival details The arrival dialog names the patient and record, keeps edited answers on Keep editing, requires explicit Discard details before an unsaved close, and blocks dismissal while pending. A delayed discard only closes the unchanged current mounted draft; saving closes only on a current accepted outcome."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":534,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1165,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/referrals/arrival-time-modal.tsx","line":173,"sha256":"b4b6a5c54f7517706f955942876fa195982fdfccf9fe481094705fa9ceae98f5"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1167,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1169,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"EVALUATE_ARRIVAL_LATENESS","name":"Work out whether an expected arrival is late","group":"The journey","lane":"record","nodes":["edExpected"],"roles":["coordinator","ed","ward"],"does":"Compares the expected arrival time against the clock and records whether it has passed.","needs":"A movement, and a role allowed to ask.","changes":"When late, stamps the movement and sends notices to the emergency department and ward. When on time, leaves it unchanged. No journey stage moves.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1216}},{"when":"Guard: movement.closure","message":"This movement is closed.","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1217}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Review late arrival"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":555,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1250,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":140,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1252,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1253,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"SET_STEP_DOWN_CANDIDATE","name":"Mark somebody as a step-down candidate","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Records that this admission could move to a lower level of care.","needs":"An existing admission. A ward must name that admission’s ward; coordinator permission is separate.","changes":"Sets the flag, and nothing else. No bed figure moves.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":720}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== admission.unitId","message":"SET_STEP_DOWN_CANDIDATE was raised acting as unit ${event.actingUnitId} but admission ${admission.id} is at ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":726}}],"screen":{"screen":"board/ward-board-detail-panel.tsx","control":"Step-down candidate"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":535,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":702,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":508,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":704,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":710,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"SET_DISCHARGE_BARRIER","name":"Record what is holding a discharge up","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Records the single thing in the way of this discharge, or that nothing is.","needs":"An existing admission, the acting ward when role is ward, and a listed barrier or None/null. The reducer does not impose a seven-day minimum.","changes":"Replaces the discharge-barrier field, with None normalised to null. It records a reason; it does not free or reserve a bed.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":743}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== admission.unitId","message":"SET_DISCHARGE_BARRIER was raised acting as unit ${event.actingUnitId} but admission ${admission.id} is at ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":748}}],"screen":{"screen":"ward/ward-screen-overlays.tsx; board/ward-board-detail-panel.tsx","control":"Discharge barrier"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":540,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":725,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen-overlays.tsx","line":329,"sha256":"27f313a7a06534fcdb3003ce8e31074b16648e74280f57980b2e051d81a16dd8"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":549,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":727,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":732,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"SET_CLINICALLY_READY","name":"Record clinically ready and why not gone","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Records the day a patient on the ward became clinically ready for discharge and the one reason they have not gone, or clears both (Josh, 9 Nov 2026).","needs":"An occupied admission, the acting ward when role is ward, a day from arrival to today and a reason from DELAYED_DISCHARGE_REASONS (the long-stay list less Clinical / Treatment), or null to clear.","changes":"Sets or clears clinicallyReadySince and delayedDischargeReason together. Delayed bed days by reason are derived from them; no bed is freed or reserved.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":759}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== admission.unitId","message":"SET_CLINICALLY_READY was raised acting as unit ${event.actingUnitId} but admission ${admission.id} is at ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":764}},{"when":"Guard: admission.state !== \"occupied\" || admission.arrivedAt === null","message":"SET_CLINICALLY_READY applies only to a patient on the ward","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":768}},{"when":"Guard: !isDelayedDischargeReason(ready.reason)","message":"SET_CLINICALLY_READY reason must be chosen from DELAYED_DISCHARGE_REASONS","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":774}},{"when":"Guard: the day is not finite, is before the arrival day or after today","message":"SET_CLINICALLY_READY date must fall between arrival and today","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":782}}],"screen":{"screen":"board/ward-board-clinically-ready.tsx","control":"Clinically ready since"},"review":{"reviewedOn":"2026-11-09","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":542,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":757,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/board/ward-board-clinically-ready.tsx","line":95,"sha256":"e96eb8cc65cf8106ffb61275d82972e5b40617de1b68c6dceb0737fb47a3ef78"}]}},{"event":"UPDATE_EXPECTED_DISCHARGE","name":"Set or move the expected discharge date","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Sets when this admission is expected to leave. Moving a date already set counts as one more move.","needs":"An admission that has not already left. A ward can only set it for its own patients. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Sets the expected time, increments date-move count only when an existing date differs, and stamps when. A ward setter is Nurse in charge; coordinator setter is null. Pending linked bed-release dates follow; completed release dates stay historical.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":226}},{"when":"Guard: admission.state === \"departed\"","message":"cannot update expected discharge for departed admission ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":229}},{"when":"Guard: event.role === \"ward\" && (!event.actingUnitId || event.actingUnitId !== admission.unitId)","message":"UPDATE_EXPECTED_DISCHARGE was raised acting as unit ${event.actingUnitId ?? \"unspecified\"} but admission ${admission.id} belongs to unit ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":235}},{"when":"Guard: typeof event.expectedDischargeAt !== \"number\" || !Number.isFinite(event.expectedDischargeAt)","message":"UPDATE_EXPECTED_DISCHARGE expectedDischargeAt must be a valid timestamp","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":239}}],"screen":{"screen":"ward/ward-drawer-discharge-date.tsx; board/ward-board-detail-panel.tsx; patients/patient-now-screen.tsx; discharges/discharge-detail-panes.tsx","control":"Update expected departure The ward drawer fixes its day choices when the editor opens, so a save made just after midnight keeps the day that was chosen."},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":23,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":224,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-drawer-discharge-date.tsx","line":81,"sha256":"54731b0b51ea23bdd098e653f19cefc60e759ac91e8a170418a96e9837f3aa87"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":385,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":734,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/discharges/discharge-detail-panes.tsx","line":304,"sha256":"e5336a5cf0037d9c50af5a381b33e5ac5f8278de1a800067197254a82a19aec3"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":227,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":230,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":236,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":240,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"RECORD_ADMISSION_CARE","name":"Record care journey fact","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator","community"],"does":"Records a care journey fact (such as a transfer, transport, clinical plan or document) against an admission on the discharge board.","needs":"Current generation/revision, permitted ward/coordinator/community actor and accessible linked occupied/departed stay. Community writes only its allowed care kinds for its own team; transfer acceptance and cancellation are coordinator-only, and an accepted or handover transfer step needs a linked placement record (a ward referral or agreed repatriation). Change-kind validation and sequence-specific guards apply. A transfer recorded as arrived also needs a Ready bed at the receiving ward once its live pulls are counted.","changes":"Appends or updates the care journey record. Moves no bed figure — except a transfer recorded as arrived, which also ends this admission as transferred, opens a new occupied admission and an arrived movement at the receiving ward, completes any live bed release for the leaver, and moves both wards' bed figures.","reasons":[],"refuses":[{"when":"Guard: patientRecordIsInvoluntary(patient?.legalStatus) || stayLegalStatusIsInvoluntary(state, admission)","message":"Record the checked transport authority for this involuntary arrangement.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":254}},{"when":"Guard: previous !== \"5A\" && previous !== \"5B\"","message":"A Form 5B continuation needs a recorded Form 5A or earlier Form 5B for this stay.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":262}},{"when":"Guard: transfer accepted/handover && !dischargeMovement(state, admission)","message":"Create a linked placement record through a ward referral or agreed repatriation before recording this transfer.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":255}},{"when":"Guard: pulledBedAvailability(receiving, livePulled).ready \u003c= 0","message":"No Ready bed remains at the receiving ward.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":330}}],"screen":{"screen":"discharge-care-journey.tsx","control":"Record care fact"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":20,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":228,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1737,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward/ward-leave-paper-authority.tsx","line":141,"sha256":"e8727edeed2ac11af122dcd34039702137c3355dc9404cf567e5d1316f14fff7"},{"path":"src/components/ward-management/discharges/discharge-care-journey.tsx","line":122,"sha256":"ccb0ccd1a1dd746abeef58fb9f7c3aa79e38c0316a68b6a3160ffe85c7dd44f4"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":274,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":282,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"}]}},{"event":"RECORD_ADMISSION_FOLLOW_UP","name":"Record follow-up arrangement","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Records follow-up contact arrangements against an admission on the discharge board.","needs":"Current generation/revision, permitted ward/coordinator actor and accessible linked occupied/departed stay. The listed follow-up state cannot be recorded after death on the ward, or before arrival.","changes":"Updates the follow-up arrangement on the admission. Moves no bed figure.","reasons":[],"refuses":[],"screen":{"screen":"discharge-follow-up.tsx","control":"Record follow-up"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":21,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":448,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1738,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/discharges/discharge-follow-up.tsx","line":87,"sha256":"807a917c3e51421e00d0e3aea3f79340f47939406bd66baea66e7312372dcce6"}]}},{"event":"RECORD_MOVEMENT_MEDICAL_CLEARANCE","name":"Record medical clearance against the movement","group":"Finding a bed","lane":"record","nodes":["rkClearance"],"roles":["ed","coordinator"],"does":"Records clearance on a movement and synchronises its matching linked referral. Fresh positive clearance resumes a recorded deterioration pause.","needs":"An existing movement, ED/coordinator role, finite recording time and boolean answer; an ED must name itself and be the journey's origin ED (M2); positive re-clearance must follow the recorded deterioration. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Replaces clearance on the movement, matching linked referral and matching sibling movements. Positive fresh clearance records resumedAt for satisfied pauses; it does not restore released resources.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1321}},{"when":"Guard: event.role !== \"ed\" && event.role !== \"coordinator\"","message":"role ${event.role} cannot record movement medical clearance; only ed or coordinator may record clearance","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1326}},{"when":"Guard: event.role === \"ed\" && actingPlaceId is not the journey's originEdId","message":"Only the originating ED may record medical clearance for this journey.","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1283}}],"screen":{"screen":"ed/ed-medical-placement-controls.tsx; patients/patient-now-screen.tsx","control":"Medically cleared"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":543,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1271,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-medical-placement-controls.tsx","line":148,"sha256":"89a5797a48cde8abca855128c5449c6b73e4dae9a065352fb94e6810d203dbec"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":1423,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1273,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1278,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"UPLOAD_PATIENT_FORM","name":"Attach a file to the movement","group":"Legal status and examinations","lane":"record","nodes":["rkLegalWritten"],"roles":["coordinator","ed","ward","community","officer"],"does":"Records document type, recognised file type and byte size as attachment metadata. The selected file’s name and bytes are not stored by this event.","needs":"An existing movement, nonblank document type, recognised file type and positive safe-integer byte size. Legacy filenames are read only to derive their type.","changes":"Appends generated document id, formName, fileType, sizeBytes and role/time metadata; no file body or original filename is retained.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":789}},{"when":"Guard: event.fileType === undefined && (typeof legacyName !== \"string\" || legacyName.trim().length === 0)","message":"Document details need a recognised file type.","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":800}}],"screen":{"screen":"upload-forms-modal.tsx","control":"Upload a form"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":544,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":771,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/officer/officer-forms-pack.tsx","line":293,"sha256":"bec740b858e305b841f30e084461ba51f96e7c63b939c2394771c1ab06728d02"},{"path":"src/components/ward-management/referrals/upload-forms-modal.tsx","line":75,"sha256":"070b8a39d8755ece7a56af9cb756aaf8714457c3751d29f1c468ef6a7cf4b18b"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":777,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":788,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"RECORD_LEGAL_FORM_WRITTEN","name":"Record that a legal form was written","group":"Legal status and examinations","lane":"record","nodes":["rkLegalWritten"],"roles":["ed","coordinator","ward"],"does":"Records which form was written, with typed start and expiry times.","needs":"A supported form, finite typed written time and any typed expiry. A ward requires an admitted stay; ED requires an open movement, while an admitted stay permits the coordinator/ward path after arrival. 3C after3D refuses; this event cannot shorten existing same-form paper expiry.","changes":"Stores current paper facts and history, preserves matching same-form paper facts on a time edit, and clears a calculated legacy clock. A different form clears the old receipt. A same-form time edit also keeps the details typed from that paper and the typed receipt mark; a different form clears them.","reasons":[],"refuses":[{"when":"Guard: movement.closure && !(admitted && event.role !== \"ed\")","message":"cannot record a written form for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":233}},{"when":"Guard: !isLegalClockFormCode(event.formCode)","message":"That form is not a recognised legal form in this prototype","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":244}},{"when":"Guard: event.formCode === \"3C\" && form3CRefusedAfter3D(movement.legalForm?.code ?? movement.legalClock?.code)","message":"Form 3C is refused when the person arrived on a Form 3D","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":247}}],"screen":{"screen":"legal-forms-screen.tsx","control":"Record a written form"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":546,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":275,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/legal-forms/legal-forms-screen.tsx","line":524,"sha256":"6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":299,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":313,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":316,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}]}},{"event":"RECORD_LEGAL_FORM_CONTINUATION","name":"Record that a form was continued","group":"Legal status and examinations","lane":"record","nodes":["rkLegalWritten"],"roles":["ed","coordinator","ward","community"],"does":"Records a continuation with typed times. A 5B continues a 5A; other supported forms can replace paper facts without a prior form.","needs":"An open movement, supported form and valid typed start and expiry times. On a ward desk only the ward that accepted the person may record it (D-128); the app checks the named ward and the shared server checks it is the caller's own place.","changes":"Stores the paper form and typed expiry, clears the old legal clock and the typed receipt mark.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":345}},{"when":"Guard: !isLegalClockFormCode(event.formCode)","message":"That form is not a recognised legal form in this prototype","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":355}},{"when":"Guard: event.role === \"ward\" && actingUnitId is not movement.acceptedUnitId","message":"Only the ward that accepted this person can record a continuation.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":425}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Record legal form continuation"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":554,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":415,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":322,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":417,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":437,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}]}},{"event":"RECORD_COUNTRY_EXTENSION","name":"Record a typed country Form 1A extension","group":"Legal status and examinations","lane":"record","nodes":["rkLegalWritten"],"roles":["ed","coordinator"],"does":"For an eligible open country Form1A, forwards the clinician’s typed paper expiry through RECORD_LEGAL_FORM_EXPIRY. It computes no statutory deadline.","needs":"An existing open movement carrying current Form1A with paper region country, a finite paperExpiresAt and the ordinary expiry extension rules.","changes":"Records the typed expiry and expiry history through the standard expiry handler, clearing any calculated legacy clock.","reasons":[],"refuses":[{"when":"Guard: movement.closure || event.paperExpiresAt === undefined || !Number.isFinite(event.paperExpiresAt)","message":"Country extensions are recorded as a typed expiry. Enter the new expiry written on the country extension form.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":317}},{"when":"Guard: !countryExtensionEligible(movement)","message":"A country extension requires a current Form 1A with its paper setting recorded as country.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":323}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Record country paper extension"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":553,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":382,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":359,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":389,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":395,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}]}},{"event":"FLAG_LEGAL_MISMATCH","name":"Flag that the ward's authority does not match","group":"Legal status and examinations","lane":"record","nodes":["rkLegalMismatch"],"roles":["ward","coordinator"],"does":"Records one of two mismatches: an involuntary patient on a voluntary ward, or a voluntary patient on a locked one.","needs":"An open movement and real ward. The submitted mismatch kind must match the current patient legal status and ward authority/bed configuration.","changes":"Raises the flag. It does not stop anything by itself.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2216}},{"when":"Guard: !unit","message":"no unit found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2219}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Flag current legal placement mismatch"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":559,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2265,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":187,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2241,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2267,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"RAISE_EXPECT_FLAG","name":"Start a forty-eight-hour or seven-day clock by hand","group":"Urgency and blockers","lane":"record","nodes":["rkExpectFlag"],"roles":["ward","coordinator","ed","community"],"does":"Raises one of two hand-set clocks against a movement.","needs":"An open movement with no uncleared flag and kind voluntary_48h or involuntary_7d.","changes":"Records the current manually raised flag. Replacing a previously cleared flag keeps that prior record in expectFlagHistory; no automatic state transition is implied.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"This movement is closed.","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2195}},{"when":"Guard: movement.expectFlag && movement.expectFlag.clearedAt === undefined","message":"movement ${movement.id} already has an open expect flag","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2197}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Raise expectation review flag"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":558,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2206,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":116,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2239,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2244,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"CLEAR_EXPECT_FLAG","name":"Clear that hand-set clock","group":"Urgency and blockers","lane":"record","nodes":["rkExpectFlag"],"roles":["ward","coordinator","ed","community"],"does":"Clears the flag raised above.","needs":"An open movement with an uncleared expect flag.","changes":"Stamps clearedAt and clearedBy on the flag; it is retained rather than removed.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2180}},{"when":"Guard: !movement.expectFlag || movement.expectFlag.clearedAt !== undefined","message":"movement ${movement.id} has no open expect flag to clear","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2183}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Clear expectation review flag"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":557,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2192,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":114,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2194,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2197,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"RELEASE_AND_REOPEN_SEARCH","name":"Give the bed back and reopen the search, in one act","group":"Holding the bed","lane":"stall","nodes":["sPullReleased"],"roles":["coordinator","ward"],"does":"Releases the held bed AND puts the movement back into the bed search together, rather than as two separate steps.","needs":"An open movement at pulled or accepted_awaiting_bed, a listed release reason and no live booking; a ward must match the accepting ward. A bed need not already be held on the accepted-only branch.","changes":"Returns any matching held bed, clears acceptance/hold/requests/transport and moves to placement_requested. Logs pull release when held, otherwise acceptance withdrawal. For a return movement with sourceAdmissionId, the in-app release/withdrawal notice targets the actual sending stay ward. Ordinary ED/community origins retain their existing recipient paths; no external-provider delivery is implied.","reasons":["RELEASE_PULL_REASONS"],"refuses":[{"when":"Guard: movement.closure","message":"cannot release and reopen a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":757}},{"when":"Guard: movement.stage !== \"pulled\" && movement.stage !== \"accepted_awaiting_bed\"","message":"cannot release and reopen at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":763}},{"when":"Guard: !RELEASE_PULL_REASONS.includes(event.reason)","message":"RELEASE_AND_REOPEN_SEARCH reason must be chosen from RELEASE_PULL_REASONS","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":774}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"RELEASE_AND_REOPEN_SEARCH was raised acting as unit ${event.actingUnitId} but movement ${movement.id}'s bed is at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":780}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Release held bed and reopen search"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":556,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":812,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":228,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":816,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":822,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":833,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":839,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"CONFIRM_MORNING_ROLLUP","name":"Confirm the ward's morning count","group":"The ward's own numbers","lane":"record","nodes":["rkWardDay"],"roles":["ward","bed_manager","coordinator"],"does":"A ward confirming how many discharges it expects that morning.","needs":"The acting ward must match the target; the count must be a nonnegative safe integer.","changes":"Records the confirmed number against the ward.","reasons":[],"refuses":[{"when":"Guard: !unit","message":"no unit found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2239}},{"when":"Guard: (event.role === \"ward\" && event.actingUnitId === undefined) || (event.actingUnitId !== undefined && event.actingUnitId !== event.unitId)","message":"CONFIRM_MORNING_ROLLUP was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2249}}],"screen":{"screen":"ward-screen.tsx","control":"Confirm the morning rollup"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":565,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2262,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1079,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2264,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2254,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"SEND_WARD_BUZZ","name":"Send a message to a ward","group":"The ward's own numbers","lane":"record","nodes":["rkWardDay"],"roles":["coordinator","bed_manager"],"does":"Records a ward refresh request with a listed message and optional urgent boolean. It sends no external message.","needs":"A real unit, a message from WARD_BUZZ_MESSAGES and, if supplied, a boolean urgent answer. Blank/unlisted messages refuse.","changes":"Appends a refresh-request record with role/time, message and urgency; moves no bed figure.","reasons":[],"refuses":[{"when":"Guard: !WARD_BUZZ_MESSAGES.includes(event.message) || (event.urgent !== undefined && typeof event.urgent !== \"boolean\")","message":"Choose a valid ward refresh message.","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2273}},{"when":"Guard: !unit","message":"no unit found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2275}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Request ward capacity review"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":566,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2293,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":210,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2298,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2325,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"EVALUATE_LEAVE_BED_WARNINGS","name":"Sweep the beds held during leave","group":"The ward's own numbers","lane":"record","nodes":["rkWardDay"],"roles":["ward","coordinator"],"does":"Works out which beds being held while somebody is on leave are worth warning about.","needs":"Nothing but the clock — it takes no patient and no ward.","changes":"For each leave bed over the open-warning threshold that has not been warned, records openWarningAt and sends a ward notice. It does not release the bed or move capacity.","reasons":[],"refuses":[],"screen":{"screen":"movement-workflow-actions.tsx","control":"Review leave bed warnings"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":564,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":819,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":163,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"}]}},{"event":"RECORD_REPATRIATION","name":"Log a repatriation arranged by phone","group":"The journey","lane":"record","nodes":["dRepat"],"roles":["coordinator"],"does":"Logs a repatriation already arranged off the system: the home hospital, whether its ward agreed, road or flight, and voluntary or involuntary, with the provider, the CAD or tracking number and an estimated time when known (W13, 5 Nov 2026: each left out warns, and a blank CAD is CAD to follow; a typed depart time the form cannot read blocks the plan form rather than recording without it). It books nothing.","needs":"A non-departed admission with valid home hospital, mode and legal status. A provider, if given, must be listed; a typed CAD must pass the CAD rule; an estimate, if given, must be finite. An unanswered prior plan may later be agreed once; an agreed plan cannot be agreed again while its return remains open; after a did_not_proceed closure a distinct new attempt may be agreed. An involuntary stay cannot be logged as a voluntary return. Any still-open return for the source stay refuses another plan. A retained agreed plan may start a distinct new attempt only after its linked return closed did_not_proceed; this retry qualification does not allow duplicate live returns or duplicate agreement of an active plan.","changes":"Creates or updates the telephone plan. Each distinct plan’s first agreement creates an open placement_requested return movement linked to the source stay; it does not itself book transport or transfer the patient. A retry preserves its prior closed journey and a flat earlier plan snapshot while replacing the single current plan for that stay. Agreed return origin site/ED lookup follows the saved scenario network. Local restore validates flat prior records and retains typed CAD values only as the redaction placeholder. An agreement that does not repeat the plan's provider or estimated time keeps the plan's own; a value it gives wins.","reasons":["TRANSPORT_PROVIDERS","TRANSPORT_LEGAL_STATUSES"],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":471}},{"when":"Guard: existingRecord && (existingRecord.receivingWardAgreed || event.receivingWardAgreed !== true)","message":"admission ${admission.id} already has a repatriation record","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":496}},{"when":"Guard: !scenarioHasSite(state.scenario, event.homeHospital)","message":"RECORD_REPATRIATION homeHospital ${event.homeHospital} does not name a real site","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":499}},{"when":"Guard: typeof event.receivingWardAgreed !== \"boolean\"","message":"RECORD_REPATRIATION receivingWardAgreed must be answered, and it has no default","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":502}},{"when":"Guard: !(REPATRIATION_MODES as readonly string[]).includes(event.mode)","message":"RECORD_REPATRIATION mode must be chosen from REPATRIATION_MODES","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":505}},{"when":"Guard: event.provider !== undefined && !(TRANSPORT_PROVIDERS as readonly string[]).includes(event.provider)","message":"RECORD_REPATRIATION provider must be chosen from TRANSPORT_PROVIDERS","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":508}}],"screen":{"screen":"out-of-area-board.tsx","control":"Record repatriation After the latest linked return journey is closed did_not_proceed, the Out of area screen reopens the return-plan form rather than treating the older agreed plan as still active. Historical records remain; retry acceptance and creation of another journey remain engine decisions."},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":568,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":478,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/out-of-area/out-of-area-board.tsx","line":418,"sha256":"0e5d43b3a020ff60e265e2e4fb200f16d505dd667d737677943fdc01ff23f26d"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":481,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":506,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":509,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":512,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":515,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":518,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_HANDOVER_SIGN_OFF","name":"Sign off the shift handover","group":"The ward's own numbers","lane":"record","nodes":["rkWardDay"],"roles":["coordinator","ward"],"does":"Records that the shift handover was signed off.","needs":"A permitted role and, when supplied, a real ward. A sign-off cannot name both a ward and the whole network; signed/shared scope further limits the acting desk.","changes":"Appends role/time plus the selected ward id or network flag. It records no personal name/note and makes no claim that a sheet was sent.","reasons":[],"refuses":[{"when":"Guard: event.unitId !== undefined && !findUnit(state, event.unitId)","message":"no ward found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":452}},{"when":"Guard: event.network === true && event.unitId !== undefined","message":"a sign-off names one ward or the whole network, not both","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":455}}],"screen":{"screen":"handover/handover-scope-rules.ts","control":"Sign off the handover The handover being reviewed retains outgoing ward journeys through the linked source stay or referral origin and outgoing community journeys through their originating team. Display inclusion does not widen the desk allowed to sign off."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":577,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":457,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/handover/handover-scope-rules.ts","line":113,"sha256":"a5ef90b1a994a20b49344788004bcd8160e5f58383e77fa48a82bde80e67f198"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":462,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":465,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_CLINICAL_CONTACT","name":"Record that a team was contacted","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["community","coordinator"],"does":"Records that somebody contacted a community team. This is the contact itself, not a message sent through the system.","needs":"A community team that exists.","changes":"Stores the team, the time and the role.","reasons":[],"refuses":[{"when":"Guard: !team","message":"RECORD_CLINICAL_CONTACT teamId ${event.teamId} does not name a real team","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":648}}],"screen":{"screen":"community/use-community-contact-save.ts","control":"Contacted"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":585,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":659,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/community/use-community-contact-save.ts","line":154,"sha256":"6503061cec64069859f3ed3a8f52042ef6d18bce27c5de7c37f88bfe8ab5da8e"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":663,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"DISPATCH_BROADCAST_ALERT","name":"Send a network-wide alert","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["coordinator","bed_manager"],"does":"Sends an alert to wards and emergency departments across the network, with a severity, a category, who it is aimed at and how long it lasts.","needs":"Nonblank title/message; listed severity/category/scope; finite positive duration; directive or bed_call kind; any explicit recipients must be real ward/ED desks. A bed call requires at least one targeted ward.","changes":"Adds the alert as active, with nobody yet acknowledging it. It belongs to no patient.","reasons":[],"refuses":[{"when":"Guard: !event.title.trim() || !event.message.trim()","message":"DISPATCH_BROADCAST_ALERT requires a non-empty title and message","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":71}},{"when":"Guard: finiteInstant(event.durationMinutes) === null || event.durationMinutes \u003c= 0","message":"DISPATCH_BROADCAST_ALERT durationMinutes must be a finite positive number","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":92}}],"screen":{"screen":"alerts-screen.tsx","control":"+ Broadcast Network Alert"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":594,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":69,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":827,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":71,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":92,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"}]}},{"event":"ACKNOWLEDGE_BROADCAST_ALERT","name":"Acknowledge a network-wide alert","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["coordinator","ward","ed","officer","community","bed_manager"],"does":"Records that one ward or desk has seen a network-wide alert.","needs":"An active alert and known ward/ED desk not already acknowledged; the special coordinator desk id requires coordinator role. Signed access must match the actor’s actual desk.","changes":"Adds the unit to the alert's acknowledged list.","reasons":[],"refuses":[{"when":"Guard: !target","message":"ACKNOWLEDGE_BROADCAST_ALERT alertId ${event.alertId} not found","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":155}},{"when":"Guard: !isAlertActive(target, event.now)","message":"ACKNOWLEDGE_BROADCAST_ALERT alertId ${event.alertId} is no longer active","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":178}}],"screen":{"screen":"shell/ward-broadcast-banner-body.tsx; shell/ward-broadcast-banner.tsx","control":"Acknowledge this directive for your desk; desk comes from current signed/route context"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":595,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":151,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/shell/ward-broadcast-banner-body.tsx","line":130,"sha256":"a96ae00d184b52341105eb90f8a0438f5f5561f787c2522f97e0e7ea62e87178"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":155,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":178,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"}]}},{"event":"STAND_DOWN_BROADCAST_ALERT","name":"Stand down a network-wide alert","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["coordinator","bed_manager"],"does":"Ends a network-wide alert once the pressure has passed.","needs":"An alert that exists and has not already been stood down.","changes":"Marks the alert stood down, with the time and who did it.","reasons":[],"refuses":[{"when":"Guard: !target","message":"STAND_DOWN_BROADCAST_ALERT alertId ${event.alertId} not found","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":202}},{"when":"Guard: target.status === \"stood_down\"","message":"STAND_DOWN_BROADCAST_ALERT alertId ${event.alertId} is already stood down","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":208}}],"screen":{"screen":"alerts-screen.tsx","control":"Stand Down Directive"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":596,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":198,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":861,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/shell/ward-broadcast-banner.tsx","line":125,"sha256":"d34087fc1cfb2356065997d7942882cd1bc9791e3041e71ec0fb0d279fe429be"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":202,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":208,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"}]}}],"stages":{"width":2880,"height":4832,"spineX":910,"nodes":[{"id":"srcCommunity","lane":"expected","x":60,"y":66,"w":236,"h":62,"label":"A community team","phase":"front"},{"id":"srcCrisis","lane":"expected","x":312,"y":66,"w":236,"h":62,"label":"A crisis service","phase":"front"},{"id":"srcPolice","lane":"expected","x":564,"y":66,"w":236,"h":62,"label":"Police","phase":"front"},{"id":"srcAmbulance","lane":"expected","x":816,"y":66,"w":236,"h":62,"label":"Ambulance","phase":"front"},{"id":"srcHospital","lane":"expected","x":1068,"y":66,"w":236,"h":62,"label":"Another hospital","phase":"front"},{"id":"srcEd","lane":"expected","x":1320,"y":66,"w":236,"h":62,"label":"A doctor in an ED","phase":"front"},{"id":"srcGp","lane":"expected","x":1572,"y":66,"w":236,"h":62,"label":"A GP","phase":"front"},{"id":"hdr-src","lane":"heading","x":60,"y":14,"w":700,"h":40,"label":"Who raises it  ·  seven","sub":"A doctor in an ED may only raise it as an ED referral — they cannot claim another source.","phase":"front"},{"id":"raised","lane":"expected","x":700,"y":200,"w":420,"h":80,"label":"A referral is raised","sub":"Somebody has decided this person needs to go somewhere.","patient":"Wherever they already were.","bed":"Nothing yet.","phase":"front"},{"id":"addressed","lane":"expected","x":700,"y":320,"w":420,"h":86,"label":"Addressed to up to three places at once","sub":"Up to the configured recipient cap. Distinct named psychiatric wards can be addressed together; duplicate recipients and mixing a broad ward request with named ward requests are refused.","patient":"Still where they were.","bed":"Nothing yet.","phase":"front"},{"id":"armCommunity","lane":"expected","x":60,"y":460,"w":460,"h":90,"label":"①  Sent to a community team","sub":"Named as free text — there is no register of teams to choose from.","patient":"At home, or wherever they were.","bed":"Nothing. This arm never involves one.","phase":"front"},{"id":"armWard","lane":"expected","x":700,"y":460,"w":420,"h":90,"label":"②  Sent to a psychiatric ward","sub":"Carries what the bed must be: sex, gender, secure, involuntary, high-acuity nursing.","patient":"Still waiting.","bed":"Nothing reserved.","phase":"front"},{"id":"armEd","lane":"expected","x":1300,"y":460,"w":500,"h":90,"label":"③  Sent to an emergency department","sub":"Must say what it is FOR: a bed, a psychiatric review, or a medical assessment.","patient":"On their way to, or already in, that department.","bed":"Nothing.","phase":"front"},{"id":"cmhtAnswers","lane":"expected","x":60,"y":600,"w":460,"h":70,"label":"The team answers","phase":"front"},{"id":"cmhtAccepted","lane":"end","x":60,"y":720,"w":460,"h":90,"label":"Accepted — community follow-up","sub":"The arm ends here. It never becomes a bed search.","phase":"front"},{"id":"cmhtDeclined","lane":"end","x":60,"y":860,"w":460,"h":112,"label":"Declined — four reasons","sub":"Outside the team's catchment · needs inpatient care, not community follow-up · the client declined or could not be contacted · already open to another team.","phase":"front"},{"id":"cmhtNothing","lane":"stall","x":60,"y":1012,"w":460,"h":104,"label":"No answer yet","sub":"The arm remains queued until answered or withdrawn. Other acceptances do not cancel a community arm. Displayed waiting/overdue indicators do not decide or close it.","finding":"Nothing anywhere can close a queued community arm except the team answering or the referrer.","phase":"front"},{"id":"cmhtWithdrawn","lane":"stall","x":60,"y":1152,"w":460,"h":110,"label":"The referrer withdraws just this arm","sub":"A narrow exception added 17 September 2026, and only while the arm is still queued — a team that has already answered keeps its answer. The bed request stands.","phase":"front"},{"id":"cmhtFromSearch","lane":"diversion","x":60,"y":1298,"w":460,"h":110,"label":"It can also begin part-way through a bed search","sub":"Redirecting a bed search to a community team raises a real referral of this kind — or reuses a queued arm already asking that same team, rather than asking twice. So this arm does not only start at the front door.","phase":"front"},{"id":"cmhtExempt","lane":"note","x":60,"y":1444,"w":460,"h":100,"label":"This arm is exempt from the automatic cancellation","sub":"In both directions. A ward accepting does not close it, and it accepting does not close the bed search. It is the only arm that behaves this way.","phase":"front"},{"id":"wardAnswers","lane":"expected","x":700,"y":600,"w":420,"h":70,"label":"The ward answers","phase":"front"},{"id":"wardAccepted","lane":"expected","x":700,"y":720,"w":420,"h":90,"label":"Accepted","sub":"Records the ward answer, with an optional named bed reservation on the referral. It creates no movement or admission.","patient":"Still waiting.","bed":"No movement pull yet; a named bed can be reserved on this answer.","phase":"front"},{"id":"wardDeclined","lane":"end","x":700,"y":860,"w":420,"h":112,"label":"Declined — seven reasons","sub":"No suitable bed · age band not provided here · no bed of that designation · no secure bed · belongs to another service · referred elsewhere · another reason.","phase":"front"},{"id":"wardNothing","lane":"stall","x":700,"y":1022,"w":420,"h":96,"label":"No answer at all","sub":"The destination remains waiting until answered, withdrawn or cancelled by a competing acceptance. Current target/overdue displays can flag waiting; they do not choose an answer.","phase":"front"},{"id":"othersCancelled","lane":"diversion","x":700,"y":1168,"w":420,"h":100,"label":"Every other waiting arm is cancelled","sub":"Automatically, the moment a ward OR a department accepts — except the community arm, which is exempt in both directions. The referrer is neither asked nor told.","phase":"front"},{"id":"wardWithdrawn","lane":"diversion","x":700,"y":1310,"w":420,"h":130,"label":"The referrer takes the WHOLE referral back","sub":"The default, and the opposite of the community arm's one-arm exception: every still-queued destination goes at once. If a bed search is already running it releases the held bed and cancels the transport, and closes as 'did not proceed'. Refused once transport has collected the patient — that needs a coordinator, not an automatic withdrawal.","phase":"front"},{"id":"wardBlocked","lane":"stall","x":700,"y":1470,"w":420,"h":116,"label":"A ward cannot accept while a department's bed search is live","sub":"One referral, two arms: if the emergency department already raised the bed search, the ward arm is refused until that movement closes or arrives. Neither arm's screen shows the other.","phase":"front"},{"id":"edBoard","lane":"expected","x":1300,"y":600,"w":500,"h":90,"label":"It lands on that department's board","sub":"And the referrer can see their patient sitting there.","phase":"front"},{"id":"edExpected","lane":"expected","x":1300,"y":740,"w":500,"h":90,"label":"Expected to arrive","sub":"Triaged, and not here yet. It sits on a separate list from the referrals.","patient":"Not here yet.","bed":"Nothing.","phase":"front"},{"id":"edNeverArrives","lane":"stall","x":1300,"y":880,"w":500,"h":120,"label":"Expected, and never arrives","sub":"A queued ED arm can be declined or withdrawn before arrival, removing this expectation. Otherwise it stays until arrival; past 72 hours the screen adds a reminder but changes no record.","finding":"A queued ED arm can be declined or withdrawn before arrival; the expectation then disappears without an arrival stamp.","phase":"front"},{"id":"edArrived","lane":"expected","x":1300,"y":1040,"w":500,"h":86,"label":"Marked present","sub":"The only door between the two lists. Stamped once; a repeat keeps the earliest time.","patient":"Physically in the department.","bed":"Nothing.","phase":"front"},{"id":"edAnswers","lane":"expected","x":1300,"y":1176,"w":500,"h":70,"label":"The department answers, or acts","phase":"front"},{"id":"edAccepted","lane":"expected","x":1300,"y":1296,"w":500,"h":104,"label":"Accepted — the department takes them","sub":"And every other destination still waiting is cancelled on the spot, including the ward request sent alongside it. The referrer is not asked.","patient":"In the department.","bed":"Nothing — accepting reserves none.","phase":"front"},{"id":"edDeclined","lane":"end","x":1300,"y":1450,"w":500,"h":104,"label":"Declined — three reasons only","sub":"Belongs to another service · referred elsewhere · another reason. The four bed-shaped reasons are withheld on purpose: an ED is not being asked for a bed.","phase":"front"},{"id":"edRaise","lane":"expected","x":1300,"y":1604,"w":500,"h":104,"label":"A doctor raises a bed search from here","sub":"This is what creates the record that moves. It can be linked back to the referral that sent them, or raised for somebody nobody referred.","patient":"In the department.","bed":"Nothing yet.","phase":"front"},{"id":"edOutcome","lane":"end","x":1300,"y":1758,"w":500,"h":112,"label":"The department decides no bed is needed","sub":"Two labels, one behaviour: 'for community follow-up' raises no referral and tells no team — only the separate action below does that. Unwinds a held bed, an uncollected transport job and every live ward request. Refused once transport has collected them.","phase":"bed"},{"id":"edToCommunity","lane":"diversion","x":1300,"y":1920,"w":500,"h":124,"label":"Referred straight to a community team instead","sub":"Ends the bed search and creates or reuses a real community referral. Available from the moment the bed search exists until the patient is collected — not only from a department. Refused once they are collected, and while a legal form has no conclusive examination outcome.","phase":"bed"},{"id":"edLeft","lane":"end","x":1300,"y":2084,"w":500,"h":90,"label":"Left the department","sub":"Only recordable after an outcome has been recorded first.","phase":"bed"},{"id":"seam","lane":"seam","x":700,"y":1700,"w":420,"h":100,"label":"A separate movement is raised","sub":"Acceptance does not create the bed-search record. RAISE_REFERRAL creates it separately and can link it to the referral.","patient":"Unchanged.","bed":"Still nothing.","phase":"bed"},{"id":"placement","lane":"expected","x":700,"y":1854,"w":420,"h":60,"label":"Placement requested","patient":"Waiting, wherever they are.","bed":"Nothing yet.","phase":"bed"},{"id":"asked","lane":"expected","x":700,"y":1968,"w":420,"h":76,"label":"Wards are asked","sub":"One at a time, or several at once, up to three.","patient":"Still waiting.","bed":"Nothing yet.","phase":"bed"},{"id":"inPrinciple","lane":"expected","x":700,"y":2098,"w":420,"h":76,"label":"A ward accepts in principle","sub":"Still no bed set aside.","patient":"Still waiting.","bed":"Promised, not reserved.","phase":"bed"},{"id":"pulled","lane":"expected","x":700,"y":2228,"w":420,"h":90,"label":"A bed is pulled and held","sub":"Empty, offered to nobody else. Four hours is the default, not a rule — a coordinator can set the hold anywhere between thirty minutes and four hours. The admission this creates now names the movement it came from — a join added by owner ruling on 21 September, and the first pointer of any kind between the patient's track and the bed's; it is empty for the beds seeded as already occupied, so anything reading it has to cope with nothing being there.","patient":"Still where they were.","bed":"Held.","phase":"bed"},{"id":"booked","lane":"expected","x":700,"y":2372,"w":420,"h":76,"label":"Transport is booked","sub":"Five answers, none defaulted — provider, escort, CAD number, voluntary or involuntary, estimated time.","patient":"Waiting, with a journey arranged.","bed":"Held.","phase":"bed"},{"id":"handover","lane":"expected","x":700,"y":2502,"w":420,"h":60,"label":"Handover ready","patient":"Ready to be collected.","bed":"Held.","phase":"bed"},{"id":"enroute","lane":"expected","x":700,"y":2616,"w":420,"h":70,"label":"The crew accepts, and sets off","patient":"Still where they were.","bed":"Held.","phase":"bed"},{"id":"collected","lane":"expected","x":700,"y":2740,"w":420,"h":76,"label":"The patient is collected","sub":"After this point, everything changes.","patient":"In a vehicle, between two places.","bed":"Held.","phase":"bed"},{"id":"arrived","lane":"expected","x":700,"y":2870,"w":420,"h":76,"label":"The ward says they have arrived","sub":"Ward confirmation closes the movement and records the occupied stay. An officer Delivered stamp ends only the transport leg. STEP_BACK_STAGE refuses arrival; a separate scoped, time-limited Undo can correct the latest unchanged arrival snapshot.","patient":"On the ward.","bed":"Occupied.","phase":"ward"},{"id":"occupied","lane":"expected","x":700,"y":3000,"w":420,"h":60,"label":"Occupied — on the ward","patient":"Being treated.","bed":"Theirs, through leave and absence.","phase":"ward"},{"id":"ready","lane":"expected","x":700,"y":3114,"w":420,"h":86,"label":"Clinically ready to leave","sub":"The patient's departure and the named bed-release record proceed on two tracks.","patient":"Finished with hospital, possibly still in the bed.","bed":"Occupied.","phase":"ward"},{"id":"sWardDecline","lane":"stall","x":60,"y":1968,"w":460,"h":96,"label":"A ward declines — seven reasons","sub":"No bed · sex mix · no specialling · acuity mix · capability mismatch · bed pulled for an earlier referral · out of catchment.","phase":"bed"},{"id":"sWithdrawWard","lane":"stall","x":60,"y":2104,"w":460,"h":96,"label":"One ward's request is taken back","sub":"Seven reasons. The other wards asked carry on considering.","phase":"bed"},{"id":"sAcceptWithdrawn","lane":"stall","x":60,"y":2240,"w":460,"h":96,"label":"The acceptance is withdrawn","sub":"A listed reason records why the acceptance is withdrawn. An uncollected pulled or stepped-back hold is released in the same act; cancel a live job first. Handover-ready and moving are refused.","phase":"bed"},{"id":"sAbandoned","lane":"end","x":60,"y":2376,"w":460,"h":96,"label":"The bed search is abandoned","sub":"Pulled from every ward still considering it, or — once a ward has accepted — the acceptance revoked and any held bed given back. It closes as 'did not proceed'. This is also where an examination outcome of a community order, or a revocation, lands while no bed is held yet.","phase":"bed"},{"id":"sPullReleased","lane":"stall","x":60,"y":2512,"w":460,"h":96,"label":"The held bed is given back — four reasons","sub":"NINE different actions delete that admission, not one — releasing the pull (four reasons of its own), releasing a held bed after transport was stopped, abandoning the bed search, the referrer withdrawing it, the department deciding no bed is needed, sending them to a community team instead, an examination outcome that ends it, releasing the bed a diverted journey held, and releasing the bed while reopening the search. Whichever it was, the admission record is deleted outright: nobody was ever in this bed.","phase":"bed"},{"id":"sCancelTransport","lane":"stall","x":60,"y":2648,"w":460,"h":96,"label":"Transport cancelled before collection","sub":"A listed reason removes the job without moving the stage or automatically rebooking. The held-bed notice checks the admission link as well as stage, including a stepped-back pull.","finding":"The role/booking-place, collected, delivered and closed checks are distinct; an officer delivery can precede ward arrival without closure.","phase":"bed"},{"id":"sStopTransport","lane":"diversion","x":60,"y":2784,"w":460,"h":96,"label":"The journey is stopped after collection","sub":"Three reasons, and somebody must say where the patient now is. The movement closes and the bed stays held.","finding":"An officer delivery can precede ward arrival without closure, so delivered and closed refusal paths are distinct.","phase":"bed"},{"id":"sAbscond","lane":"record","x":60,"y":3000,"w":460,"h":96,"label":"Absent without leave is recorded","sub":"The occupied stay and held bed remain. The ward records absence, its steps and return against the admission; the current order can also create an action-inbox fact.","phase":"ward"},{"id":"dForced","lane":"forced","x":1300,"y":2284,"w":500,"h":100,"label":"A coordinator places them anyway","sub":"Eight of the bed checks can be passed by recording one of five reasons — the receiving team has agreed despite the mismatch · clinical urgency outweighs it · the bed information is known to be out of date · continuity with an earlier admission here · closer to home or family. Running out of one-to-one nursing or of high-acuity capacity can be passed the same way, and passing the acuity one also demands that the nurse unit manager was consulted.","phase":"bed"},{"id":"dGenderHard","lane":"stall","x":1300,"y":2424,"w":500,"h":100,"label":"The one refusal nothing can override","sub":"If the ward is designated for one gender and the patient's recorded gender is the other, no reason passes it and the app will not even offer the list. Non-binary, Different term, and not-recorded genders can use the coordinator-reviewed exception. Every other bed check here can be forced; this one cannot.","phase":"bed"},{"id":"dNonBinary","lane":"forced","x":1300,"y":2564,"w":500,"h":100,"label":"A patient with a non-binary, Different term, or unrecorded gender onto a single-gender ward","sub":"Only a coordinator, and only with one of six recorded reasons — a single room is available · the patient's stated preference, agreed with the ward · no single room is free and the ward agreed a plan for privacy · the only suitable ready bed, agreed with the ward · they know this ward from an earlier stay · closer to home or supports.","phase":"bed"},{"id":"dStatutory","lane":"record","x":1300,"y":2704,"w":500,"h":100,"label":"Record a form from the Forms page","sub":"The form selector and checked paper time reach the supported form-writing handler. Authorised users can save; refusal keeps the draft and shows the reason. This does not issue a legal instrument or calculate its statutory expiry.","phase":"bed"},{"id":"dNoTransport","lane":"diversion","x":1300,"y":2844,"w":500,"h":100,"label":"No transport needed","sub":"Marked arrived straight from the held bed, with no journey recorded at all.","phase":"bed"},{"id":"dRepull","lane":"record","x":1300,"y":2984,"w":500,"h":100,"label":"Pulling again when the bed is already held","sub":"Restoring an already-linked hold preserves its bed rather than consuming another. Current code rechecks the matching admission, patient placement, observation/high-acuity staffing, legal authority and gender before restoring the pulled stage.","finding":"Restoring a hold does not consume a second bed; staffing, legal, gender and matching-admission checks still run.","phase":"ward"},{"id":"dNoLongerSuits","lane":"stall","x":1300,"y":3124,"w":500,"h":100,"label":"A held destination no longer suits","sub":"Current gender/legal facts are checked at forward steps. WITHDRAW_ACCEPTANCE can release an uncollected pulled or stepped-back hold atomically after any live job is cancelled; no obsolete three-step sequence should be assumed.","finding":"A held acceptance can now be withdrawn atomically after cancelling a live job; handover-ready/moving still require the supported earlier-stage path.","phase":"ward"},{"id":"dCancelLie","lane":"record","x":1300,"y":3264,"w":500,"h":100,"label":"Cancellation keeps the bed facts separate","sub":"The hold is detected from the linked admission OR the pulled-or-later stage. Cancelling removes the job and preserves the bed and current stage, including after a step back.","finding":"Cancellation checks both the admission link and stage before describing whether the bed stays held.","phase":"ward"},{"id":"dRevoked","lane":"record","x":1300,"y":3404,"w":500,"h":100,"label":"The legal authority is revoked before collection","sub":"A revoked examination while a bed is held records the examination and flags release without refunding the bed. Acceptance, en-route and collection refuse while that hold is unresolved; physical arrival remains recordable.","phase":"ward"},{"id":"dAway","lane":"diversion","x":1300,"y":3544,"w":500,"h":100,"label":"Away at an ED, or on leave","sub":"An ED trip and leave name the occupied admission. Return records clear the relevant absence. Leave also records its kind and optional psychiatrist-authorisation answer; the bed stays held while away.","phase":"ward"},{"id":"dClosedRecord","lane":"record","x":1300,"y":3684,"w":500,"h":100,"label":"Closure limits corrections; admitted forms have a separate route","sub":"Most movement actions refuse closure. The admitting ward can still record a supported written form or typed expiry for a current occupied stay. STEP_BACK_STAGE refuses arrival, while a separate scoped Undo can reverse the latest unchanged transport/arrival snapshot within its window.","finding":"Most movement commands refuse closure, but admitted-ward form and expiry commands have explicit supported post-arrival routes.","phase":"ward"},{"id":"dRepat","lane":"diversion","x":1300,"y":3824,"w":500,"h":100,"label":"Sending a country patient home","sub":"Logged against the admission once it has been arranged off the system: home hospital, whether its ward agreed, road or flight, provider and tracking number. It books nothing. Only when the home ward agreed does it also open a new movement asking for a bed at home.","phase":"ward"},{"id":"personLeaves","lane":"expected","x":400,"y":4044,"w":440,"h":96,"label":"Track one — the person leaves","sub":"Eight recorded departure destinations. A psychiatric transfer releases the sending ward bed while taking a receiving bed.","patient":"Gone.","bed":"Normally empty and allocatable rise once and the live release completes; an over-capacity arrival conflict is reconciled without inventing an extra bed.","phase":"leaving"},{"id":"bedReleased","lane":"expected","x":920,"y":4044,"w":440,"h":96,"label":"Track two — the bed is released","sub":"Expected can go directly to discharged or pass through confirmed. The named admission leaving completes its release in the same write; capacity reconciliation prevents counting an already-recorded release or an over-capacity arrival twice.","patient":"Names the stay it belongs to, and nothing else about them.","bed":"Counted as available again, at the last step only.","phase":"leaving"},{"id":"bedStuck","lane":"stall","x":1440,"y":4044,"w":400,"h":96,"label":"Stuck, or waiting on something","sub":"Seven things it can wait on, nine reasons it can be stuck. Neither is a stage.","phase":"leaving"},{"id":"end0","lane":"end","x":60,"y":4274,"w":230,"h":112,"label":"Discharged to the community","sub":"Frees a bed.","phase":"leaving"},{"id":"end1","lane":"diversion","x":312,"y":4274,"w":230,"h":112,"label":"Transferred to another psychiatric ward","sub":"Frees THIS ward's bed and gains the state nothing — the only one that is not a release.","phase":"leaving"},{"id":"end2","lane":"end","x":564,"y":4274,"w":230,"h":112,"label":"Transferred to a general hospital","sub":"Frees a bed.","phase":"leaving"},{"id":"end3","lane":"end","x":816,"y":4274,"w":230,"h":112,"label":"Moved to residential care","sub":"Frees a bed.","phase":"leaving"},{"id":"end4","lane":"end","x":1068,"y":4274,"w":230,"h":112,"label":"Left against advice","sub":"Frees a bed.","phase":"leaving"},{"id":"end5","lane":"end","x":1320,"y":4274,"w":230,"h":112,"label":"Died on the ward","sub":"Frees a bed.","phase":"leaving"},{"id":"end6","lane":"end","x":1572,"y":4274,"w":230,"h":112,"label":"Transferred to police or prison custody","sub":"Frees a bed.","phase":"leaving"},{"id":"end7","lane":"end","x":1824,"y":4274,"w":230,"h":112,"label":"Did not return","sub":"Frees a bed.","phase":"leaving"},{"id":"rkDuplicate","lane":"record","x":2400,"y":460,"w":420,"h":104,"label":"Is this the same person already?","sub":"Duplicate matching warns about number and demographic similarities. A duplicate record number blocks registration in both form and reducer; name similarity alone remains a review warning.","phase":"alongside"},{"id":"rkIntakeLost","lane":"record","x":2400,"y":588,"w":420,"h":104,"label":"Add patient saves identity; referral saves intake","sub":"The current Add patient form asks for identity, optional gender and Aboriginal or Torres Strait Islander status. Clinical intake and location belong to the referral flow. Obsolete non-working Print/Save draft controls are hidden; the historical silent-discard finding no longer describes this screen.","phase":"alongside"},{"id":"rkClearance","lane":"record","x":2400,"y":1031,"w":420,"h":104,"label":"Is the patient medically cleared?","sub":"Three answers, not two — unrecorded, cleared, and explicitly not cleared.","phase":"alongside"},{"id":"rkClock","lane":"absent","x":2400,"y":1832,"w":420,"h":104,"label":"The display follows wall-clock time","sub":"The provider updates elapsed wall-clock time at minute boundaries and catches up when the page becomes visible. A controlled test clock is separate. A display becoming overdue does not by itself prove that a domain action ran; check the event handler for that action.","phase":"alongside"},{"id":"rkSettings","lane":"record","x":2400,"y":1960,"w":420,"h":104,"label":"Settings change current operational defaults","sub":"WardConfiguration carries twelve fields: access/decision/transfer/booking targets, parallel-recipient cap, pull hold, morning deadline, due-soon warnings and Forecast thresholds. A valid full draft is merged against its baseline or refused for conflicting fields; old optional keys take documented defaults.","phase":"alongside"},{"id":"rkQueue","lane":"record","x":2400,"y":2088,"w":420,"h":104,"label":"Where they sit in the queue","sub":"Flagged urgent first, then the urgency tier, then whoever has waited longest, then the record's own id as a tie-break. Nothing else moves anybody up.","phase":"alongside"},{"id":"rkClash","lane":"record","x":2400,"y":2216,"w":420,"h":104,"label":"Duplicate bed requests are surfaced","sub":"The current duplicate-bed-request derivation finds multiple active requests for one linked patient and creates a coordinator fact row. It does not rank patients or choose a winner. This is distinct from a physical double-booking check.","phase":"alongside"},{"id":"rkUrgent","lane":"record","x":2400,"y":2344,"w":420,"h":104,"label":"Flagged urgent","sub":"Ten reasons. Lifts the patient above every urgency level, and re-sorts nothing on its own.","phase":"alongside"},{"id":"rkEscalate","lane":"record","x":2400,"y":2472,"w":420,"h":104,"label":"Escalated","sub":"Which wards were tried and who was rung. Six people it can be escalated to.","phase":"alongside"},{"id":"rkCapacity","lane":"record","x":2400,"y":2600,"w":420,"h":104,"label":"A ward states how many beds it can allocate","sub":"Set outright rather than counted up, and refused if it claims more beds than the ward physically has. Asking a ward to refresh it records that somebody asked, and moves no number at all.","phase":"alongside"},{"id":"rkLegalStatus","lane":"record","x":2400,"y":2728,"w":420,"h":104,"label":"The legal status changes","sub":"Four values. Changing it triggers nothing — even if it makes the accepted ward unlawful.","phase":"alongside"},{"id":"rkForm","lane":"record","x":2400,"y":2856,"w":420,"h":104,"label":"The legal paperwork arrives","sub":"Nine forms can be recorded as received — 1A, 3A, 3C, 3D, 5A, 5B, 6A, 6B, 6C. Receipt can be undone and recorded again; every expiry is a time a clinician typed.","phase":"alongside"},{"id":"rkExam","lane":"record","x":2400,"y":2984,"w":420,"h":104,"label":"An examination is recorded","sub":"Four outcomes. Only “a further examination is ordered” allows a second one.","phase":"alongside"},{"id":"rkLegalWritten","lane":"record","x":2400,"y":3112,"w":420,"h":104,"label":"The paperwork is written, continued, or attached","sub":"Written and continued forms record paper facts and clear legacy calculated clocks; same-form written-time edits preserve applicable typed facts. An admitted ward has a post-arrival route. A3C after3D is refused. A country1A extension requires a current country setting and a finite typed later paper expiry; no statutory duration is computed.","phase":"alongside"},{"id":"rkLegalMismatch","lane":"record","x":2400,"y":3240,"w":420,"h":104,"label":"The ward's authority does not match the person's status","sub":"Two shapes, both named: an involuntary patient on a voluntary ward, and a voluntary patient on a locked one. It can be flagged, and it cannot be overridden: ward authority for an involuntary patient is never overridable (owner ruling, 25 September).","phase":"alongside"},{"id":"rkNotice","lane":"record","x":2400,"y":3368,"w":420,"h":104,"label":"Somebody is told","sub":"Twenty-four kinds of notice. Written once, never rewritten, never deleted, never expiring.","phase":"alongside"},{"id":"rkDiversion","lane":"record","x":2400,"y":3496,"w":420,"h":104,"label":"The journey is diverted while it is under way","sub":"Only once the patient is actually in the vehicle — it is refused before collection, after arrival, and a second time on a movement already diverted. It records a reason and where they were taken instead. The held bed does not come back on its own: giving it back is a separate act, and refused unless this movement was in fact diverted.","phase":"alongside"},{"id":"rkExpiryShut","lane":"stall","x":2400,"y":3624,"w":420,"h":104,"label":"Expiry can be recorded for an admitted patient","sub":"The legal-event handler permits the ward to record a typed expiry for its admitted patient even when the movement is closed. This is a recorded time, not a computed legal limit. See ward-flow-record-legal-events.ts.","finding":"The admitted-patient expiry route is implemented for the ward. Read the current legal-event handler; the old closed-movement gap is retired.","phase":"alongside"},{"id":"rkExpectFlag","lane":"record","x":2400,"y":3752,"w":420,"h":104,"label":"A clock somebody starts by hand","sub":"Two kinds, forty-eight hours and seven days, raised against a movement and cleared again. Only one can be open at a time — raising a second is refused, and so is clearing one that was never raised. Nothing starts it automatically and nothing expires it; it is a note about time, not a timer.","phase":"alongside"},{"id":"rkAwayRule","lane":"record","x":2400,"y":3880,"w":420,"h":104,"label":"The rule for a bed kept during a medical trip","sub":"The unwired retention helper keeps the bed by default, including above the24-hour threshold; above threshold adds requiresReview. Only an explicit override changes freesBed. The numeric constant is24 while an adjacent historical provenance comment still says48.","phase":"alongside"},{"id":"rkInbox","lane":"record","x":2400,"y":4008,"w":420,"h":104,"label":"A row appears in the coordinator's inbox","sub":"The current inbox derives fact rows from movements, stays, planned bookings and bed-meeting actions. Facts are acknowledged/owned/snoozed, never ticked away. The daily check is a commitment; its day-shaped ID can be completed and reopened.","finding":"Completion applies to commitment IDs; fact rows use their source condition and bed-meeting actions have a dedicated completion event.","phase":"alongside"},{"id":"rkDischargePlan","lane":"record","x":2400,"y":4136,"w":420,"h":104,"label":"Step-down, and what is holding the discharge up","sub":"Two settings on a known admission: step-down candidacy and one discharge barrier. The acting ward must match; a substantive barrier is refused for a stay under seven days. Neither moves a bed figure.","phase":"alongside"},{"id":"rkDischarge","lane":"record","x":2400,"y":4264,"w":420,"h":104,"label":"A discharge recorded the other way","sub":"A second event does exactly what recording a departure does, but only for a patient whose identity is linked, and only against the revision number the screen last read. Same result, different door.","phase":"alongside"},{"id":"rkPrep","lane":"record","x":2400,"y":4392,"w":420,"h":104,"label":"The bed is being prepared","sub":"Cleaning/repair is a separate preparation flag. It does not directly rewrite the ward count; the pull handler separately refuses when every free bed is still being made ready.","phase":"alongside"},{"id":"rkOwnership","lane":"record","x":2400,"y":4520,"w":420,"h":104,"label":"Only the ward it belongs to may touch it","sub":"Confirming a release, reversing it, flagging it stuck, clearing that flag, marking the bed being cleaned, and finally freeing it are each refused to any other ward. It is what stops one ward's freed bed landing in another ward's figures.","phase":"alongside"},{"id":"rkWardDay","lane":"record","x":2400,"y":4648,"w":420,"h":104,"label":"The ward's own day, beside the patient's","sub":"A morning count a ward confirms, a message it can be sent, and a sweep that works out which beds on leave are worth warning about. None of them belongs to any one patient, which is why they sit off the journey rather than on it.","phase":"alongside"},{"id":"hdr-rec","lane":"heading","x":2400,"y":380,"w":420,"h":60,"label":"Recorded alongside  ·","sub":"Happens at some point without moving the journey.","phase":"alongside"},{"id":"hdr-left","lane":"heading","x":60,"y":1892,"w":460,"h":56,"label":"←  Stalls, undos and endings","sub":"Grey goes back into the route. Teal does not.","phase":"bed"},{"id":"hdr-spine","lane":"heading","x":700,"y":1614,"w":420,"h":56,"label":"Read down the middle  ↓","sub":"Read straight down.","phase":"front"},{"id":"hdr-right","lane":"heading","x":1300,"y":2208,"w":500,"h":56,"label":"Diversions  →","sub":"It carries on, somewhere other than expected.","phase":"bed"}],"edges":[{"from":"srcCommunity","to":"raised","d":"M 178 128 L 178 152 Q 178 164 190 164 L 898 164 Q 910 164 910 176 L 910 200","p":[[178,128],[178,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcCrisis","to":"raised","d":"M 430 128 L 430 152 Q 430 164 442 164 L 898 164 Q 910 164 910 176 L 910 200","p":[[430,128],[430,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcPolice","to":"raised","d":"M 682 128 L 682 152 Q 682 164 694 164 L 898 164 Q 910 164 910 176 L 910 200","p":[[682,128],[682,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcAmbulance","to":"raised","d":"M 934 128 L 934 152 Q 934 164 922 164 L 922 164 Q 910 164 910 176 L 910 200","p":[[934,128],[934,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcHospital","to":"raised","d":"M 1186 128 L 1186 152 Q 1186 164 1174 164 L 922 164 Q 910 164 910 176 L 910 200","p":[[1186,128],[1186,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcEd","to":"raised","d":"M 1438 128 L 1438 152 Q 1438 164 1426 164 L 922 164 Q 910 164 910 176 L 910 200","p":[[1438,128],[1438,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcGp","to":"raised","d":"M 1690 128 L 1690 152 Q 1690 164 1678 164 L 922 164 Q 910 164 910 176 L 910 200","p":[[1690,128],[1690,164],[910,164],[910,200]],"lane":"expected"},{"from":"raised","to":"addressed","d":"M 910 280 L 910 320","p":[[910,280],[910,320]],"lane":"expected"},{"from":"addressed","to":"armCommunity","d":"M 910 406 L 910 421 Q 910 433 898 433 L 302 433 Q 290 433 290 445 L 290 460","p":[[910,406],[910,433],[290,433],[290,460]],"lane":"expected"},{"from":"addressed","to":"armWard","d":"M 910 406 L 910 460","p":[[910,406],[910,460]],"lane":"expected"},{"from":"addressed","to":"armEd","d":"M 910 406 L 910 421 Q 910 433 922 433 L 1538 433 Q 1550 433 1550 445 L 1550 460","p":[[910,406],[910,433],[1550,433],[1550,460]],"lane":"expected"},{"from":"armCommunity","to":"cmhtAnswers","d":"M 290 550 L 290 600","p":[[290,550],[290,600]],"lane":"expected"},{"from":"cmhtAnswers","to":"cmhtAccepted","d":"M 290 670 L 290 720","p":[[290,670],[290,720]],"lane":"end","terminal":true},{"from":"cmhtAnswers","to":"cmhtDeclined","d":"M 290 670 L 290 681 Q 290 692 301 692 L 544 692 Q 556 692 556 704 L 556 826 Q 556 838 544 838 L 301 838 Q 290 838 290 849 L 290 860","p":[[290,670],[290,692],[556,692],[556,838],[290,838],[290,860]],"lane":"end","terminal":true},{"from":"cmhtAnswers","to":"cmhtNothing","d":"M 290 670 L 290 681 Q 290 692 279 692 L 36 692 Q 24 692 24 704 L 24 978 Q 24 990 36 990 L 279 990 Q 290 990 290 1001 L 290 1012","p":[[290,670],[290,692],[24,692],[24,990],[290,990],[290,1012]],"lane":"stall"},{"from":"cmhtAnswers","to":"cmhtWithdrawn","d":"M 290 670 L 290 681 Q 290 692 301 692 L 566 692 Q 578 692 578 704 L 578 1118 Q 578 1130 566 1130 L 301 1130 Q 290 1130 290 1141 L 290 1152","p":[[290,670],[290,692],[578,692],[578,1130],[290,1130],[290,1152]],"lane":"stall"},{"from":"cmhtFromSearch","to":"cmhtAnswers","d":"M 290 1298 L 290 1287 Q 290 1276 301 1276 L 588 1276 Q 600 1276 600 1264 L 600 704 Q 600 692 588 692 L 301 692 Q 290 692 290 681 L 290 670","p":[[290,1298],[290,1276],[600,1276],[600,692],[290,692],[290,670]],"lane":"expected"},{"from":"armWard","to":"wardAnswers","d":"M 910 550 L 910 600","p":[[910,550],[910,600]],"lane":"expected"},{"from":"wardAnswers","to":"wardWithdrawn","d":"M 910 670 L 910 681 Q 910 692 921 692 L 1144 692 Q 1156 692 1156 704 L 1156 1276 Q 1156 1288 1144 1288 L 921 1288 Q 910 1288 910 1299 L 910 1310","p":[[910,670],[910,692],[1156,692],[1156,1288],[910,1288],[910,1310]],"lane":"diversion"},{"from":"wardAnswers","to":"wardBlocked","d":"M 910 670 L 910 681 Q 910 692 899 692 L 676 692 Q 664 692 664 704 L 664 1436 Q 664 1448 676 1448 L 899 1448 Q 910 1448 910 1459 L 910 1470","p":[[910,670],[910,692],[664,692],[664,1448],[910,1448],[910,1470]],"lane":"stall"},{"from":"wardAnswers","to":"wardAccepted","d":"M 910 670 L 910 720","p":[[910,670],[910,720]],"lane":"expected"},{"from":"wardAnswers","to":"wardDeclined","d":"M 910 670 L 910 681 Q 910 692 921 692 L 1166 692 Q 1178 692 1178 704 L 1178 826 Q 1178 838 1166 838 L 921 838 Q 910 838 910 849 L 910 860","p":[[910,670],[910,692],[1178,692],[1178,838],[910,838],[910,860]],"lane":"end","terminal":true},{"from":"wardAnswers","to":"wardNothing","d":"M 910 670 L 910 681 Q 910 692 899 692 L 654 692 Q 642 692 642 704 L 642 988 Q 642 1000 654 1000 L 899 1000 Q 910 1000 910 1011 L 910 1022","p":[[910,670],[910,692],[642,692],[642,1000],[910,1000],[910,1022]],"lane":"stall"},{"from":"wardAccepted","to":"othersCancelled","d":"M 910 810 L 910 821 Q 910 832 921 832 L 1188 832 Q 1200 832 1200 844 L 1200 1134 Q 1200 1146 1188 1146 L 921 1146 Q 910 1146 910 1157 L 910 1168","p":[[910,810],[910,832],[1200,832],[1200,1146],[910,1146],[910,1168]],"lane":"diversion","auto":true},{"from":"armEd","to":"edBoard","d":"M 1550 550 L 1550 600","p":[[1550,550],[1550,600]],"lane":"expected"},{"from":"edBoard","to":"edExpected","d":"M 1550 690 L 1550 740","p":[[1550,690],[1550,740]],"lane":"expected"},{"from":"edExpected","to":"edArrived","d":"M 1550 830 L 1550 841 Q 1550 852 1561 852 L 1824 852 Q 1836 852 1836 864 L 1836 1006 Q 1836 1018 1824 1018 L 1561 1018 Q 1550 1018 1550 1029 L 1550 1040","p":[[1550,830],[1550,852],[1836,852],[1836,1018],[1550,1018],[1550,1040]],"lane":"expected"},{"from":"edExpected","to":"edNeverArrives","d":"M 1550 830 L 1550 880","p":[[1550,830],[1550,880]],"lane":"stall"},{"from":"edArrived","to":"edAnswers","d":"M 1550 1126 L 1550 1176","p":[[1550,1126],[1550,1176]],"lane":"expected"},{"from":"edAnswers","to":"edAccepted","d":"M 1550 1246 L 1550 1296","p":[[1550,1246],[1550,1296]],"lane":"expected"},{"from":"edAnswers","to":"edDeclined","d":"M 1550 1246 L 1550 1257 Q 1550 1268 1561 1268 L 1824 1268 Q 1836 1268 1836 1280 L 1836 1416 Q 1836 1428 1824 1428 L 1561 1428 Q 1550 1428 1550 1439 L 1550 1450","p":[[1550,1246],[1550,1268],[1836,1268],[1836,1428],[1550,1428],[1550,1450]],"lane":"end","terminal":true},{"from":"edAccepted","to":"edRaise","d":"M 1550 1400 L 1550 1411 Q 1550 1422 1539 1422 L 1276 1422 Q 1264 1422 1264 1434 L 1264 1570 Q 1264 1582 1276 1582 L 1539 1582 Q 1550 1582 1550 1593 L 1550 1604","p":[[1550,1400],[1550,1422],[1264,1422],[1264,1582],[1550,1582],[1550,1604]],"lane":"expected"},{"from":"edAccepted","to":"othersCancelled","d":"M 1300 1348 L 1120 1218","p":[[1300,1348],[1120,1218]],"lane":"diversion","auto":true},{"from":"edRaise","to":"edOutcome","d":"M 1550 1708 L 1550 1758","p":[[1550,1708],[1550,1758]],"lane":"end","terminal":true},{"from":"edRaise","to":"edToCommunity","d":"M 1550 1708 L 1550 1719 Q 1550 1730 1561 1730 L 1824 1730 Q 1836 1730 1836 1742 L 1836 1886 Q 1836 1898 1824 1898 L 1561 1898 Q 1550 1898 1550 1909 L 1550 1920","p":[[1550,1708],[1550,1730],[1836,1730],[1836,1898],[1550,1898],[1550,1920]],"lane":"diversion"},{"from":"edOutcome","to":"edLeft","d":"M 1550 1870 L 1550 1881 Q 1550 1892 1539 1892 L 1276 1892 Q 1264 1892 1264 1904 L 1264 2050 Q 1264 2062 1276 2062 L 1539 2062 Q 1550 2062 1550 2073 L 1550 2084","p":[[1550,1870],[1550,1892],[1264,1892],[1264,2062],[1550,2062],[1550,2084]],"lane":"end","terminal":true},{"from":"seam","to":"placement","d":"M 910 1800 L 910 1854","p":[[910,1800],[910,1854]],"lane":"expected"},{"from":"placement","to":"asked","d":"M 910 1914 L 910 1968","p":[[910,1914],[910,1968]],"lane":"expected"},{"from":"asked","to":"inPrinciple","d":"M 910 2044 L 910 2098","p":[[910,2044],[910,2098]],"lane":"expected"},{"from":"inPrinciple","to":"pulled","d":"M 910 2174 L 910 2228","p":[[910,2174],[910,2228]],"lane":"expected"},{"from":"pulled","to":"booked","d":"M 910 2318 L 910 2372","p":[[910,2318],[910,2372]],"lane":"expected"},{"from":"booked","to":"handover","d":"M 910 2448 L 910 2502","p":[[910,2448],[910,2502]],"lane":"expected"},{"from":"handover","to":"enroute","d":"M 910 2562 L 910 2616","p":[[910,2562],[910,2616]],"lane":"expected"},{"from":"enroute","to":"collected","d":"M 910 2686 L 910 2740","p":[[910,2686],[910,2740]],"lane":"expected"},{"from":"collected","to":"arrived","d":"M 910 2816 L 910 2870","p":[[910,2816],[910,2870]],"lane":"expected"},{"from":"arrived","to":"occupied","d":"M 910 2946 L 910 3000","p":[[910,2946],[910,3000]],"lane":"expected"},{"from":"occupied","to":"ready","d":"M 910 3060 L 910 3114","p":[[910,3060],[910,3114]],"lane":"expected"},{"from":"wardAccepted","to":"seam","d":"M 910 810 L 910 824 Q 910 836 898 836 L 672 836 Q 660 836 660 848 L 660 1738 Q 660 1750 672 1750 L 700 1750","p":[[910,810],[910,836],[660,836],[660,1750],[700,1750]],"lane":"seam"},{"from":"edRaise","to":"placement","d":"M 1550 1708 L 1550 1722 Q 1550 1734 1538 1734 L 1252 1734 Q 1240 1734 1240 1746 L 1240 1872 Q 1240 1884 1228 1884 L 1120 1884","p":[[1550,1708],[1550,1734],[1240,1734],[1240,1884],[1120,1884]],"lane":"expected"},{"from":"asked","to":"sWardDecline","d":"M 700 2006 L 585 2006 Q 580 2006 580 2011 L 580 2011 Q 580 2016 575 2016 L 520 2016","p":[[700,2006],[580,2006],[580,2016],[520,2016]],"lane":"stall","both":true},{"from":"asked","to":"sWithdrawWard","d":"M 700 2006 L 592 2006 Q 580 2006 580 2018 L 580 2140 Q 580 2152 568 2152 L 520 2152","p":[[700,2006],[580,2006],[580,2152],[520,2152]],"lane":"stall","both":true},{"from":"inPrinciple","to":"sAcceptWithdrawn","d":"M 700 2136 L 592 2136 Q 580 2136 580 2148 L 580 2276 Q 580 2288 568 2288 L 520 2288","p":[[700,2136],[580,2136],[580,2288],[520,2288]],"lane":"stall","both":true},{"from":"inPrinciple","to":"sAbandoned","d":"M 700 2136 L 592 2136 Q 580 2136 580 2148 L 580 2412 Q 580 2424 568 2424 L 520 2424","p":[[700,2136],[580,2136],[580,2424],[520,2424]],"lane":"end","terminal":true},{"from":"pulled","to":"sPullReleased","d":"M 700 2273 L 592 2273 Q 580 2273 580 2285 L 580 2548 Q 580 2560 568 2560 L 520 2560","p":[[700,2273],[580,2273],[580,2560],[520,2560]],"lane":"stall","both":true},{"from":"booked","to":"sCancelTransport","d":"M 700 2410 L 592 2410 Q 580 2410 580 2422 L 580 2684 Q 580 2696 568 2696 L 520 2696","p":[[700,2410],[580,2410],[580,2696],[520,2696]],"lane":"stall","both":true},{"from":"collected","to":"sStopTransport","d":"M 700 2778 L 592 2778 Q 580 2778 580 2790 L 580 2820 Q 580 2832 568 2832 L 520 2832","p":[[700,2778],[580,2778],[580,2832],[520,2832]],"lane":"diversion"},{"from":"occupied","to":"sAbscond","d":"M 700 3030 L 589 3030 Q 580 3030 580 3039 L 580 3039 Q 580 3048 571 3048 L 520 3048","p":[[700,3030],[580,3030],[580,3048],[520,3048]],"lane":"record"},{"from":"asked","to":"dForced","d":"M 1120 2006 L 1168 2006 Q 1180 2006 1180 2018 L 1180 2322 Q 1180 2334 1192 2334 L 1300 2334","p":[[1120,2006],[1180,2006],[1180,2334],[1300,2334]],"lane":"forced"},{"from":"dForced","to":"dForced","d":"M 1300 2334 L 1262 2334","p":[[1300,2334],[1262,2334]],"lane":"forced","terminal":true},{"from":"asked","to":"dGenderHard","d":"M 1120 2006 L 1168 2006 Q 1180 2006 1180 2018 L 1180 2462 Q 1180 2474 1192 2474 L 1300 2474","p":[[1120,2006],[1180,2006],[1180,2474],[1300,2474]],"lane":"stall"},{"from":"dGenderHard","to":"dGenderHard","d":"M 1300 2474 L 1262 2474","p":[[1300,2474],[1262,2474]],"lane":"stall","terminal":true},{"from":"inPrinciple","to":"dNonBinary","d":"M 1120 2136 L 1168 2136 Q 1180 2136 1180 2148 L 1180 2602 Q 1180 2614 1192 2614 L 1300 2614","p":[[1120,2136],[1180,2136],[1180,2614],[1300,2614]],"lane":"forced"},{"from":"dNonBinary","to":"dNonBinary","d":"M 1300 2614 L 1262 2614","p":[[1300,2614],[1262,2614]],"lane":"forced","terminal":true},{"from":"inPrinciple","to":"dStatutory","d":"M 1120 2136 L 1168 2136 Q 1180 2136 1180 2148 L 1180 2742 Q 1180 2754 1192 2754 L 1300 2754","p":[[1120,2136],[1180,2136],[1180,2754],[1300,2754]],"lane":"record"},{"from":"dStatutory","to":"dStatutory","d":"M 1300 2754 L 1262 2754","p":[[1300,2754],[1262,2754]],"lane":"record","terminal":true},{"from":"pulled","to":"dNoTransport","d":"M 1120 2273 L 1168 2273 Q 1180 2273 1180 2285 L 1180 2882 Q 1180 2894 1192 2894 L 1300 2894","p":[[1120,2273],[1180,2273],[1180,2894],[1300,2894]],"lane":"diversion"},{"from":"dNoTransport","to":"arrived","d":"M 1550 2944 L 1550 2958 Q 1550 2970 1562 2970 L 1848 2970 Q 1860 2970 1860 2958 L 1860 2920 Q 1860 2908 1848 2908 L 1120 2908","p":[[1550,2944],[1550,2970],[1860,2970],[1860,2908],[1120,2908]],"lane":"expected"},{"from":"pulled","to":"dRepull","d":"M 1120 2273 L 1168 2273 Q 1180 2273 1180 2285 L 1180 3022 Q 1180 3034 1192 3034 L 1300 3034","p":[[1120,2273],[1180,2273],[1180,3034],[1300,3034]],"lane":"record","both":true},{"from":"handover","to":"dNoLongerSuits","d":"M 1120 2532 L 1168 2532 Q 1180 2532 1180 2544 L 1180 3162 Q 1180 3174 1192 3174 L 1300 3174","p":[[1120,2532],[1180,2532],[1180,3174],[1300,3174]],"lane":"stall"},{"from":"dNoLongerSuits","to":"dNoLongerSuits","d":"M 1300 3174 L 1262 3174","p":[[1300,3174],[1262,3174]],"lane":"stall","terminal":true},{"from":"booked","to":"dCancelLie","d":"M 1120 2410 L 1168 2410 Q 1180 2410 1180 2422 L 1180 3302 Q 1180 3314 1192 3314 L 1300 3314","p":[[1120,2410],[1180,2410],[1180,3314],[1300,3314]],"lane":"record"},{"from":"dCancelLie","to":"dCancelLie","d":"M 1300 3314 L 1262 3314","p":[[1300,3314],[1262,3314]],"lane":"record","terminal":true},{"from":"enroute","to":"dRevoked","d":"M 1120 2651 L 1168 2651 Q 1180 2651 1180 2663 L 1180 3442 Q 1180 3454 1192 3454 L 1300 3454","p":[[1120,2651],[1180,2651],[1180,3454],[1300,3454]],"lane":"record"},{"from":"dRevoked","to":"dRevoked","d":"M 1300 3454 L 1262 3454","p":[[1300,3454],[1262,3454]],"lane":"record","terminal":true},{"from":"occupied","to":"dAway","d":"M 1120 3030 L 1168 3030 Q 1180 3030 1180 3042 L 1180 3582 Q 1180 3594 1192 3594 L 1300 3594","p":[[1120,3030],[1180,3030],[1180,3594],[1300,3594]],"lane":"diversion","both":true},{"from":"arrived","to":"dClosedRecord","d":"M 1120 2908 L 1168 2908 Q 1180 2908 1180 2920 L 1180 3722 Q 1180 3734 1192 3734 L 1300 3734","p":[[1120,2908],[1180,2908],[1180,3734],[1300,3734]],"lane":"record"},{"from":"dClosedRecord","to":"dClosedRecord","d":"M 1300 3734 L 1262 3734","p":[[1300,3734],[1262,3734]],"lane":"record","terminal":true},{"from":"ready","to":"dRepat","d":"M 1120 3157 L 1168 3157 Q 1180 3157 1180 3169 L 1180 3862 Q 1180 3874 1192 3874 L 1300 3874","p":[[1120,3157],[1180,3157],[1180,3874],[1300,3874]],"lane":"diversion"},{"from":"dRepat","to":"dRepat","d":"M 1300 3874 L 1262 3874","p":[[1300,3874],[1262,3874]],"lane":"diversion","terminal":true},{"from":"ready","to":"personLeaves","d":"M 910 3200 L 910 3610 Q 910 3622 898 3622 L 632 3622 Q 620 3622 620 3634 L 620 4044","p":[[910,3200],[910,3622],[620,3622],[620,4044]],"lane":"expected"},{"from":"ready","to":"bedReleased","d":"M 910 3200 L 910 3610 Q 910 3622 922 3622 L 1128 3622 Q 1140 3622 1140 3634 L 1140 4044","p":[[910,3200],[910,3622],[1140,3622],[1140,4044]],"lane":"expected"},{"from":"bedReleased","to":"bedStuck","d":"M 1360 4092 L 1440 4092","p":[[1360,4092],[1440,4092]],"lane":"stall","both":true},{"from":"personLeaves","to":"end0","d":"M 620 4140 L 620 4195 Q 620 4207 608 4207 L 187 4207 Q 175 4207 175 4219 L 175 4274","p":[[620,4140],[620,4207],[175,4207],[175,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end1","d":"M 620 4140 L 620 4195 Q 620 4207 608 4207 L 439 4207 Q 427 4207 427 4219 L 427 4274","p":[[620,4140],[620,4207],[427,4207],[427,4274]],"lane":"diversion"},{"from":"personLeaves","to":"end2","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 667 4207 Q 679 4207 679 4219 L 679 4274","p":[[620,4140],[620,4207],[679,4207],[679,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end3","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 919 4207 Q 931 4207 931 4219 L 931 4274","p":[[620,4140],[620,4207],[931,4207],[931,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end4","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 1171 4207 Q 1183 4207 1183 4219 L 1183 4274","p":[[620,4140],[620,4207],[1183,4207],[1183,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end5","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 1423 4207 Q 1435 4207 1435 4219 L 1435 4274","p":[[620,4140],[620,4207],[1435,4207],[1435,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end6","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 1675 4207 Q 1687 4207 1687 4219 L 1687 4274","p":[[620,4140],[620,4207],[1687,4207],[1687,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end7","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 1927 4207 Q 1939 4207 1939 4219 L 1939 4274","p":[[620,4140],[620,4207],[1939,4207],[1939,4274]],"lane":"end","terminal":true},{"from":"raised","to":"rkDuplicate","d":"M 1120 240 L 2342 240 Q 2354 240 2354 252 L 2354 500 Q 2354 512 2366 512 L 2400 512","p":[[1120,240],[2354,240],[2354,512],[2400,512]],"lane":"record","dashed":true},{"from":"raised","to":"rkIntakeLost","d":"M 1120 240 L 2342 240 Q 2354 240 2354 252 L 2354 628 Q 2354 640 2366 640 L 2400 640","p":[[1120,240],[2354,240],[2354,640],[2400,640]],"lane":"record","dashed":true},{"from":"edArrived","to":"rkClearance","d":"M 1800 1083 L 2354 1083 L 2354 1083 L 2400 1083","p":[[1800,1083],[2354,1083],[2354,1083],[2400,1083]],"lane":"record","dashed":true},{"from":"placement","to":"rkClock","d":"M 1120 1884 L 2354 1884 L 2354 1884 L 2400 1884","p":[[1120,1884],[2354,1884],[2354,1884],[2400,1884]],"lane":"absent","terminal":true,"dashed":true},{"from":"placement","to":"rkSettings","d":"M 1120 1884 L 2342 1884 Q 2354 1884 2354 1896 L 2354 2000 Q 2354 2012 2366 2012 L 2400 2012","p":[[1120,1884],[2354,1884],[2354,2012],[2400,2012]],"lane":"record","dashed":true},{"from":"asked","to":"rkQueue","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2128 Q 2354 2140 2366 2140 L 2400 2140","p":[[1120,2006],[2354,2006],[2354,2140],[2400,2140]],"lane":"record","dashed":true},{"from":"asked","to":"rkClash","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2256 Q 2354 2268 2366 2268 L 2400 2268","p":[[1120,2006],[2354,2006],[2354,2268],[2400,2268]],"lane":"record","dashed":true},{"from":"asked","to":"rkUrgent","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2384 Q 2354 2396 2366 2396 L 2400 2396","p":[[1120,2006],[2354,2006],[2354,2396],[2400,2396]],"lane":"record","dashed":true},{"from":"asked","to":"rkEscalate","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2512 Q 2354 2524 2366 2524 L 2400 2524","p":[[1120,2006],[2354,2006],[2354,2524],[2400,2524]],"lane":"record","dashed":true},{"from":"asked","to":"rkCapacity","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2640 Q 2354 2652 2366 2652 L 2400 2652","p":[[1120,2006],[2354,2006],[2354,2652],[2400,2652]],"lane":"record","dashed":true},{"from":"inPrinciple","to":"rkLegalStatus","d":"M 1120 2136 L 2342 2136 Q 2354 2136 2354 2148 L 2354 2768 Q 2354 2780 2366 2780 L 2400 2780","p":[[1120,2136],[2354,2136],[2354,2780],[2400,2780]],"lane":"record","dashed":true},{"from":"pulled","to":"rkForm","d":"M 1120 2273 L 2342 2273 Q 2354 2273 2354 2285 L 2354 2896 Q 2354 2908 2366 2908 L 2400 2908","p":[[1120,2273],[2354,2273],[2354,2908],[2400,2908]],"lane":"record","dashed":true},{"from":"pulled","to":"rkExam","d":"M 1120 2273 L 2342 2273 Q 2354 2273 2354 2285 L 2354 3024 Q 2354 3036 2366 3036 L 2400 3036","p":[[1120,2273],[2354,2273],[2354,3036],[2400,3036]],"lane":"record","dashed":true},{"from":"pulled","to":"rkLegalWritten","d":"M 1120 2273 L 2342 2273 Q 2354 2273 2354 2285 L 2354 3152 Q 2354 3164 2366 3164 L 2400 3164","p":[[1120,2273],[2354,2273],[2354,3164],[2400,3164]],"lane":"record","dashed":true},{"from":"pulled","to":"rkLegalMismatch","d":"M 1120 2273 L 2342 2273 Q 2354 2273 2354 2285 L 2354 3280 Q 2354 3292 2366 3292 L 2400 3292","p":[[1120,2273],[2354,2273],[2354,3292],[2400,3292]],"lane":"record","dashed":true},{"from":"collected","to":"rkNotice","d":"M 1120 2778 L 2342 2778 Q 2354 2778 2354 2790 L 2354 3408 Q 2354 3420 2366 3420 L 2400 3420","p":[[1120,2778],[2354,2778],[2354,3420],[2400,3420]],"lane":"record","dashed":true},{"from":"collected","to":"rkDiversion","d":"M 1120 2778 L 2342 2778 Q 2354 2778 2354 2790 L 2354 3536 Q 2354 3548 2366 3548 L 2400 3548","p":[[1120,2778],[2354,2778],[2354,3548],[2400,3548]],"lane":"record","dashed":true},{"from":"arrived","to":"rkExpiryShut","d":"M 1120 2908 L 2342 2908 Q 2354 2908 2354 2920 L 2354 3664 Q 2354 3676 2366 3676 L 2400 3676","p":[[1120,2908],[2354,2908],[2354,3676],[2400,3676]],"lane":"stall","dashed":true},{"from":"arrived","to":"rkExpectFlag","d":"M 1120 2908 L 2342 2908 Q 2354 2908 2354 2920 L 2354 3792 Q 2354 3804 2366 3804 L 2400 3804","p":[[1120,2908],[2354,2908],[2354,3804],[2400,3804]],"lane":"record","dashed":true},{"from":"occupied","to":"rkAwayRule","d":"M 1120 3030 L 2342 3030 Q 2354 3030 2354 3042 L 2354 3920 Q 2354 3932 2366 3932 L 2400 3932","p":[[1120,3030],[2354,3030],[2354,3932],[2400,3932]],"lane":"record","dashed":true},{"from":"occupied","to":"rkInbox","d":"M 1120 3030 L 2342 3030 Q 2354 3030 2354 3042 L 2354 4048 Q 2354 4060 2366 4060 L 2400 4060","p":[[1120,3030],[2354,3030],[2354,4060],[2400,4060]],"lane":"record","dashed":true},{"from":"occupied","to":"rkDischargePlan","d":"M 1120 3030 L 2342 3030 Q 2354 3030 2354 3042 L 2354 4176 Q 2354 4188 2366 4188 L 2400 4188","p":[[1120,3030],[2354,3030],[2354,4188],[2400,4188]],"lane":"record","dashed":true},{"from":"ready","to":"rkDischarge","d":"M 1120 3157 L 2342 3157 Q 2354 3157 2354 3169 L 2354 4304 Q 2354 4316 2366 4316 L 2400 4316","p":[[1120,3157],[2354,3157],[2354,4316],[2400,4316]],"lane":"record","dashed":true},{"from":"bedReleased","to":"rkPrep","d":"M 1360 4092 L 2342 4092 Q 2354 4092 2354 4104 L 2354 4432 Q 2354 4444 2366 4444 L 2400 4444","p":[[1360,4092],[2354,4092],[2354,4444],[2400,4444]],"lane":"record","dashed":true},{"from":"bedReleased","to":"rkOwnership","d":"M 1360 4092 L 2342 4092 Q 2354 4092 2354 4104 L 2354 4560 Q 2354 4572 2366 4572 L 2400 4572","p":[[1360,4092],[2354,4092],[2354,4572],[2400,4572]],"lane":"record","dashed":true},{"from":"bedReleased","to":"rkWardDay","d":"M 1360 4092 L 2342 4092 Q 2354 4092 2354 4104 L 2354 4688 Q 2354 4700 2366 4700 L 2400 4700","p":[[1360,4092],[2354,4092],[2354,4700],[2400,4700]],"lane":"record","dashed":true},{"from":"cmhtAccepted","to":"cmhtAccepted","d":"M 60 765 L 22 765","p":[[60,765],[22,765]],"lane":"end","terminal":true},{"from":"cmhtDeclined","to":"cmhtDeclined","d":"M 60 916 L 22 916","p":[[60,916],[22,916]],"lane":"end","terminal":true},{"from":"cmhtNothing","to":"cmhtNothing","d":"M 60 1064 L 22 1064","p":[[60,1064],[22,1064]],"lane":"stall","terminal":true},{"from":"cmhtWithdrawn","to":"cmhtWithdrawn","d":"M 60 1207 L 22 1207","p":[[60,1207],[22,1207]],"lane":"stall","terminal":true},{"from":"wardDeclined","to":"wardDeclined","d":"M 700 916 L 662 916","p":[[700,916],[662,916]],"lane":"end","terminal":true},{"from":"wardNothing","to":"wardNothing","d":"M 700 1070 L 662 1070","p":[[700,1070],[662,1070]],"lane":"stall","terminal":true},{"from":"othersCancelled","to":"othersCancelled","d":"M 700 1218 L 662 1218","p":[[700,1218],[662,1218]],"lane":"diversion","terminal":true},{"from":"wardWithdrawn","to":"wardWithdrawn","d":"M 700 1375 L 662 1375","p":[[700,1375],[662,1375]],"lane":"diversion","terminal":true},{"from":"wardBlocked","to":"wardBlocked","d":"M 700 1528 L 662 1528","p":[[700,1528],[662,1528]],"lane":"stall","terminal":true},{"from":"edNeverArrives","to":"edNeverArrives","d":"M 1300 940 L 1262 940","p":[[1300,940],[1262,940]],"lane":"stall","terminal":true},{"from":"edDeclined","to":"edDeclined","d":"M 1300 1502 L 1262 1502","p":[[1300,1502],[1262,1502]],"lane":"end","terminal":true},{"from":"edToCommunity","to":"edToCommunity","d":"M 1300 1982 L 1262 1982","p":[[1300,1982],[1262,1982]],"lane":"diversion","terminal":true},{"from":"edLeft","to":"edLeft","d":"M 1300 2129 L 1262 2129","p":[[1300,2129],[1262,2129]],"lane":"end","terminal":true},{"from":"sWardDecline","to":"sWardDecline","d":"M 60 2016 L 22 2016","p":[[60,2016],[22,2016]],"lane":"stall","terminal":true},{"from":"sWithdrawWard","to":"sWithdrawWard","d":"M 60 2152 L 22 2152","p":[[60,2152],[22,2152]],"lane":"stall","terminal":true},{"from":"sAcceptWithdrawn","to":"sAcceptWithdrawn","d":"M 60 2288 L 22 2288","p":[[60,2288],[22,2288]],"lane":"stall","terminal":true},{"from":"sAbandoned","to":"sAbandoned","d":"M 60 2424 L 22 2424","p":[[60,2424],[22,2424]],"lane":"end","terminal":true},{"from":"sPullReleased","to":"sPullReleased","d":"M 60 2560 L 22 2560","p":[[60,2560],[22,2560]],"lane":"stall","terminal":true},{"from":"sCancelTransport","to":"sCancelTransport","d":"M 60 2696 L 22 2696","p":[[60,2696],[22,2696]],"lane":"stall","terminal":true},{"from":"sStopTransport","to":"sStopTransport","d":"M 60 2832 L 22 2832","p":[[60,2832],[22,2832]],"lane":"diversion","terminal":true},{"from":"dForced","to":"dForced","d":"M 1300 2334 L 1262 2334","p":[[1300,2334],[1262,2334]],"lane":"forced","terminal":true},{"from":"dGenderHard","to":"dGenderHard","d":"M 1300 2474 L 1262 2474","p":[[1300,2474],[1262,2474]],"lane":"stall","terminal":true},{"from":"dNonBinary","to":"dNonBinary","d":"M 1300 2614 L 1262 2614","p":[[1300,2614],[1262,2614]],"lane":"forced","terminal":true},{"from":"dNoLongerSuits","to":"dNoLongerSuits","d":"M 1300 3174 L 1262 3174","p":[[1300,3174],[1262,3174]],"lane":"stall","terminal":true},{"from":"dAway","to":"dAway","d":"M 1300 3594 L 1262 3594","p":[[1300,3594],[1262,3594]],"lane":"diversion","terminal":true},{"from":"dRepat","to":"dRepat","d":"M 1300 3874 L 1262 3874","p":[[1300,3874],[1262,3874]],"lane":"diversion","terminal":true},{"from":"bedStuck","to":"bedStuck","d":"M 1440 4092 L 1402 4092","p":[[1440,4092],[1402,4092]],"lane":"stall","terminal":true},{"from":"end0","to":"end0","d":"M 60 4330 L 22 4330","p":[[60,4330],[22,4330]],"lane":"end","terminal":true},{"from":"end1","to":"end1","d":"M 427 4386 L 427 4424","p":[[427,4386],[427,4424]],"lane":"diversion","terminal":true},{"from":"end2","to":"end2","d":"M 679 4386 L 679 4424","p":[[679,4386],[679,4424]],"lane":"end","terminal":true},{"from":"end3","to":"end3","d":"M 931 4386 L 931 4424","p":[[931,4386],[931,4424]],"lane":"end","terminal":true},{"from":"end4","to":"end4","d":"M 1183 4386 L 1183 4424","p":[[1183,4386],[1183,4424]],"lane":"end","terminal":true},{"from":"end5","to":"end5","d":"M 1435 4386 L 1435 4424","p":[[1435,4386],[1435,4424]],"lane":"end","terminal":true},{"from":"end6","to":"end6","d":"M 1687 4386 L 1687 4424","p":[[1687,4386],[1687,4424]],"lane":"end","terminal":true},{"from":"end7","to":"end7","d":"M 2054 4330 L 2092 4330","p":[[2054,4330],[2092,4330]],"lane":"end","terminal":true},{"from":"rkClock","to":"rkClock","d":"M 2400 1884 L 2362 1884","p":[[2400,1884],[2362,1884]],"lane":"absent","terminal":true},{"from":"rkExpiryShut","to":"rkExpiryShut","d":"M 2400 3676 L 2362 3676","p":[[2400,3676],[2362,3676]],"lane":"stall","terminal":true}]},"machines":{"machines":[{"id":"referral","name":"A referral destination","subject":"One addressed destination. A referral can name several distinct wards within the configured recipient cap; answers and reassessments belong to the individual destination.","width":1064,"height":456,"states":[{"id":"start","kind":"start","x":482,"y":20,"w":80,"h":40,"label":"raised"},{"id":"queued","kind":"normal","x":412,"y":110,"w":220,"h":76,"label":"Waiting","sub":"Doing nothing is a real answer, and the commonest one. It stays here indefinitely."},{"id":"accepted","kind":"terminal","x":804,"y":110,"w":220,"h":76,"label":"Accepted","sub":"Records a destination answer. Acceptance creates no movement or admission; a ward answer may also reserve a named bed on the referral."},{"id":"declined","kind":"terminal","x":20,"y":110,"w":220,"h":76,"label":"Declined","sub":"Ends this answer. An explicit clinical reassessment can reconsider a declined destination."},{"id":"cancelled","kind":"terminal","x":804,"y":270,"w":220,"h":86,"label":"Cancelled","sub":"Closed automatically because another destination accepted. Nobody is asked."},{"id":"withdrawn","kind":"flag","x":20,"y":270,"w":220,"h":96,"label":"Withdrawn — a flag, not a state","sub":"Stamped on every destination still waiting. The arm stays waiting; it does not end."}],"transitions":[{"from":"start","to":"queued","action":"RECEIVE_REFERRAL","route":"down"},{"from":"queued","to":"accepted","action":"ACCEPT_REFERRAL","route":"straight"},{"from":"queued","to":"declined","action":"DECLINE_REFERRAL","route":"straight","guard":"the reason must come from this destination kind's own list"},{"from":"declined","to":"accepted","action":"ACCEPT_REFERRAL","route":"below","offset":0,"kind":"back","label":"on clinical reassessment","guard":"only as an explicit clinical reassessment of this destination"},{"from":"queued","to":"cancelled","action":"ACCEPT_REFERRAL","route":"below","offset":40,"label":"another arm accepted","kind":"side","guard":"a community arm is exempt in both directions and is never cancelled"},{"from":"queued","to":"withdrawn","action":"RECORD_REFERRER_WITHDRAWAL","route":"below","offset":40,"guard":"refused once anything is accepted, and refused outright once transport has collected the patient","kind":"side","label":"stamps every waiting arm"}],"note":"The destination states remain queued, accepted, declined and cancelled. A withdrawal stamps still-queued arms without rewriting their state. A clinical reassessment can update an accepted answer or turn a decline into acceptance; the ordinary first-acceptance cancellation excludes community arms in both directions."},{"id":"movement","name":"A movement","subject":"The separate bed-search record created by RAISE_REFERRAL, or created already arrived by an admitted-ward transfer. Front-door acceptance alone creates no movement. Seven stages plus a separate closure.","width":3122,"height":900,"states":[{"id":"start","kind":"start","x":20,"y":370,"w":230,"h":60,"label":"Movement created"},{"id":"placement_requested","kind":"normal","x":20,"y":180,"w":230,"h":86,"label":"Placement requested","sub":"Wards can be asked from here."},{"id":"destination_review","kind":"normal","x":492,"y":180,"w":230,"h":86,"label":"Destination review","sub":"Wards can be asked from here too — and only from these two."},{"id":"accepted_awaiting_bed","kind":"normal","x":964,"y":180,"w":230,"h":86,"label":"Accepted, awaiting bed","sub":"A ward has said yes. No bed is set aside."},{"id":"pulled","kind":"normal","x":1436,"y":180,"w":230,"h":86,"label":"Bed pulled","sub":"A bed is pulled and linked to an admission. The hold uses current configuration and any applicable extra-travel extension; expiry flags it for a person rather than releasing it."},{"id":"handover_ready","kind":"normal","x":1908,"y":180,"w":230,"h":86,"label":"Handover ready","sub":"Requires a booked job or an explicitly recorded no-transport-needed answer, plus current held-bed gender and legal checks."},{"id":"moving","kind":"normal","x":2380,"y":180,"w":230,"h":86,"label":"Moving","sub":"The patient is in the vehicle."},{"id":"arrived","kind":"terminal","x":2852,"y":180,"w":230,"h":86,"label":"Arrived","sub":"STEP_BACK_STAGE cannot reverse arrival. A separate scoped Undo may reverse the latest unchanged recorded arrival within its window and restored-bed checks."},{"id":"closed","kind":"terminal","x":1396,"y":760,"w":310,"h":90,"label":"Closed — did not proceed","sub":"Not a stage. The stage it closed at is still recorded."}],"transitions":[{"from":"start","to":"placement_requested","action":"RAISE_REFERRAL","route":"up","label":"creates it"},{"from":"placement_requested","to":"destination_review","action":"REFER_TO_UNITS","route":"straight"},{"from":"destination_review","to":"destination_review","action":"DECLINE","route":"self","offset":0,"label":"a ward says no","guard":"that ward drops off the list; the stage does not move"},{"from":"destination_review","to":"destination_review","action":"WITHDRAW_WARD_REQUEST","route":"self","offset":34,"label":"take one ward back"},{"from":"destination_review","to":"destination_review","action":"REFER_TO_UNITS","route":"self","offset":68,"label":"ask more wards"},{"from":"destination_review","to":"accepted_awaiting_bed","action":"ACCEPT_IN_PRINCIPLE","route":"straight"},{"from":"accepted_awaiting_bed","to":"destination_review","action":"WITHDRAW_ACCEPTANCE","route":"below","offset":40,"kind":"back","guard":"Allowed while awaiting a bed or with a pulled/stepped-back hold. A held bed is released atomically; cancel a live transport job first. Refused at handover-ready/moving."},{"from":"accepted_awaiting_bed","to":"pulled","action":"PULL_PATIENT","route":"straight"},{"from":"pulled","to":"accepted_awaiting_bed","action":"RELEASE_PULL","route":"below","offset":90,"kind":"back"},{"from":"pulled","to":"handover_ready","action":"HANDOVER_READY","route":"straight"},{"from":"handover_ready","to":"moving","action":"PATIENT_COLLECTED","route":"straight","guard":"refused while a revoked examination still holds the bed, or while restrictive practice is still recorded as in use for the patient at the sending ward"},{"from":"moving","to":"arrived","action":"PATIENT_ARRIVED","route":"straight"},{"from":"pulled","to":"arrived","action":"PATIENT_ARRIVED","route":"above","offset":30,"label":"no transport needed","kind":"skip"},{"from":"pulled","to":"closed","action":"WITHDRAW_REFERRAL","route":"exit","offset":0,"kind":"exit"},{"from":"pulled","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":38,"kind":"exit"},{"from":"pulled","to":"closed","action":"REFER_TO_COMMUNITY_TEAM","route":"exit","offset":76,"kind":"exit"},{"from":"pulled","to":"closed","action":"RECORD_EXAMINATION","route":"exit","offset":114,"kind":"exit","label":"community order or revoked","guard":"A community order before transport commitment closes and refunds. Revocation while a bed is held retains it and flags release; commitment or collection also retains the bed."},{"from":"moving","to":"closed","action":"STOP_TRANSPORT","route":"exit","offset":0,"kind":"exit","guard":"the bed deliberately stays held; only releasing the held bed gives it back"},{"from":"arrived","to":"closed","action":"PATIENT_ARRIVED","route":"exit","offset":0,"kind":"side","label":"closes as arrived, not as did-not-proceed"},{"from":"start","to":"arrived","action":"RECORD_ADMISSION_CARE","route":"below","offset":0,"kind":"skip","label":"ward transfer arrival: created already arrived","guard":"only a coordinator recording a transfer as arrived, for an occupied admission, into a ward with a suitable free bed and staffing; the new movement is opened and closed as arrived in one write, never raised in a department"},{"from":"moving","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":130,"kind":"back","label":"to ANY strictly earlier stage","guard":"refused once arrived; touches nothing but the stage — no bed given back, no transport cancelled"},{"from":"destination_review","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":90,"kind":"back","guard":"the same step back as from Moving: to any strictly earlier stage, touching nothing but the stage"},{"from":"accepted_awaiting_bed","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":100,"kind":"back","guard":"the same step back as from Moving: to any strictly earlier stage, touching nothing but the stage"},{"from":"pulled","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":110,"kind":"back","guard":"the same step back as from Moving: to any strictly earlier stage, touching nothing but the stage"},{"from":"handover_ready","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":120,"kind":"back","guard":"the same step back as from Moving: to any strictly earlier stage, touching nothing but the stage"},{"from":"pulled","to":"destination_review","action":"WITHDRAW_ACCEPTANCE","route":"below","offset":120,"kind":"back","guard":"the held bed is released in the same write; cancel a live transport job first"},{"from":"placement_requested","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":150,"kind":"exit"},{"from":"placement_requested","to":"closed","action":"RECORD_EXAMINATION","route":"exit","offset":174,"kind":"exit","label":"community order","guard":"a community order before a bed is pulled closes the journey"},{"from":"destination_review","to":"closed","action":"WITHDRAW_REFERRAL","route":"exit","offset":198,"kind":"exit"},{"from":"destination_review","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":222,"kind":"exit"},{"from":"destination_review","to":"closed","action":"RECORD_EXAMINATION","route":"exit","offset":246,"kind":"exit","label":"community order","guard":"a community order before a bed is pulled closes the journey"},{"from":"accepted_awaiting_bed","to":"closed","action":"WITHDRAW_REFERRAL","route":"exit","offset":270,"kind":"exit"},{"from":"accepted_awaiting_bed","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":294,"kind":"exit"},{"from":"accepted_awaiting_bed","to":"closed","action":"RECORD_EXAMINATION","route":"exit","offset":318,"kind":"exit","label":"community order","guard":"a community order before a bed is pulled closes the journey"},{"from":"handover_ready","to":"closed","action":"WITHDRAW_REFERRAL","route":"exit","offset":342,"kind":"exit"},{"from":"handover_ready","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":366,"kind":"exit"}],"note":"STEP_BACK_STAGE records a strictly earlier stage with a reason, leaving bed and transport intact. It refuses a closure, an arrived stage or a delivered transport leg. WITHDRAW_ACCEPTANCE can release an uncollected hold atomically after cancelling a live job. The separate scoped UNDO_TRANSPORT_STEP route may reverse the latest recorded arrival while its time-window, unchanged-snapshot, actor and restored-bed checks pass. Withdrawing the referral (after placement is requested), an ED outcome (before Moving) and a community order (before a bed is pulled) close the movement from every open stage the engine allows, not only from Bed pulled; tests/ward-audit-m26-machine-moves.test.ts checks every arrow against the engine."},{"id":"admission","name":"An admission","subject":"The held or occupied stay. A new pull creates a held admission; supported direct placement/planned-arrival and ward-transfer paths can create an occupied admission without passing through Held.","width":1684,"height":426,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":190,"h":76,"label":"No admission"},{"id":"pulled","kind":"normal","x":458,"y":60,"w":230,"h":76,"label":"Held","sub":"A bed is theirs. They are not here yet."},{"id":"occupied","kind":"normal","x":936,"y":60,"w":230,"h":76,"label":"Occupied","sub":"Stays theirs through leave, an ED trip, and an absconding."},{"id":"departed","kind":"terminal","x":1414,"y":60,"w":230,"h":76,"label":"Departed","sub":"Kept. Ended, never deleted."},{"id":"deleted","kind":"flag","x":423,"y":250,"w":300,"h":86,"label":"Removed — not a state","sub":"There is no “deleted” among the four admission states. The record itself is taken away."},{"id":"waitlisted","kind":"unreachable","x":1434,"y":250,"w":190,"h":86,"label":"Waitlisted","sub":"No action in the engine can produce this. Only the starting fixture writes it."}],"transitions":[{"from":"none","to":"pulled","action":"PULL_PATIENT","route":"straight","label":"creates it"},{"from":"pulled","to":"occupied","action":"PATIENT_ARRIVED","route":"straight"},{"from":"occupied","to":"departed","action":"RECORD_LEAVING","route":"straight","guard":"only from occupied, and only by the ward they are on"},{"from":"occupied","to":"departed","action":"RECORD_ADMISSION_CARE","route":"below","offset":0,"kind":"side","label":"transferred to another ward","guard":"only when a coordinator records the transfer as arrived; the stay ends with the destination transferred-to-another-psychiatric-ward and any live bed release is completed"},{"from":"none","to":"occupied","action":"RECORD_ADMISSION_CARE","route":"below","offset":60,"kind":"skip","label":"transfer arrival: new admission, already occupied","guard":"the receiving ward gets a NEW admission with a new linked movement; no bed is pulled first, so it never passes through Held"},{"from":"occupied","to":"occupied","action":"RECORD_AWAY_AT_EMERGENCY_DEPARTMENT","route":"self","offset":0,"label":"away at an ED — bed untouched"},{"from":"occupied","to":"occupied","action":"RECORD_RETURNED_FROM_EMERGENCY_DEPARTMENT","route":"self","offset":34,"label":"and back"},{"from":"pulled","to":"deleted","action":"RELEASE_PULL","route":"exit","offset":0,"kind":"exit"},{"from":"pulled","to":"deleted","action":"RELEASE_HELD_BED","route":"exit","offset":38,"kind":"exit"},{"from":"pulled","to":"deleted","action":"WITHDRAW_REFERRAL","route":"exit","offset":76,"kind":"exit"},{"from":"pulled","to":"deleted","action":"RECORD_ED_OUTCOME","route":"exit","offset":114,"kind":"exit"},{"from":"pulled","to":"deleted","action":"REFER_TO_COMMUNITY_TEAM","route":"exit","offset":152,"kind":"exit"},{"from":"pulled","to":"deleted","action":"RECORD_EXAMINATION","route":"exit","offset":190,"kind":"exit"}],"note":"Ending and deleting are deliberately different. A departed admission is kept as a record that somebody was here; a released pull is removed, because the claim that they would be here is being retracted."},{"id":"transport","name":"A transport job","subject":"Booked by phone and logged here. Collection is the line that changes what is possible.","width":2390,"height":436,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":170,"h":76,"label":"No job"},{"id":"booked","kind":"normal","x":432,"y":60,"w":190,"h":76,"label":"Booked"},{"id":"accepted","kind":"normal","x":864,"y":60,"w":190,"h":76,"label":"Crew accepted"},{"id":"enroute","kind":"normal","x":1296,"y":60,"w":190,"h":76,"label":"En route"},{"id":"collected","kind":"normal","x":1728,"y":60,"w":190,"h":76,"label":"Collected","sub":"After this, cancelling is impossible."},{"id":"arrived","kind":"terminal","x":2160,"y":60,"w":190,"h":76,"label":"Arrived"},{"id":"stopped","kind":"terminal","x":1683,"y":260,"w":280,"h":86,"label":"Stopped","sub":"Somebody must say where the patient now is."}],"transitions":[{"from":"none","to":"booked","action":"BOOK_TRANSPORT","route":"straight","guard":"five answers, none defaulted"},{"from":"booked","to":"accepted","action":"TRANSPORT_ACCEPTED","route":"straight"},{"from":"accepted","to":"enroute","action":"TRANSPORT_EN_ROUTE","route":"straight","guard":"Requires an open movement at handover-ready, an accepted job and no earlier en-route timestamp. Refused while a revoked/community-order examination retains a bed or awaits release; this handler itself does not rerun held-unit gender/legal checks."},{"from":"enroute","to":"collected","action":"PATIENT_COLLECTED","route":"straight","guard":"refused while restrictive practice is still recorded as in use for the patient at the sending ward"},{"from":"collected","to":"arrived","action":"PATIENT_ARRIVED","route":"straight"},{"from":"booked","to":"none","action":"CANCEL_TRANSPORT","route":"below","offset":0,"kind":"exit","label":"the job is deleted, not marked"},{"from":"accepted","to":"none","action":"CANCEL_TRANSPORT","route":"below","offset":20,"kind":"exit"},{"from":"enroute","to":"none","action":"CANCEL_TRANSPORT","route":"below","offset":40,"kind":"exit","guard":"The booking ward/team must match the supplied acting place; an ED claim is checked against the recorded booking place when both are present. Coordinator access remains subject to the authenticated access boundary."},{"from":"collected","to":"stopped","action":"STOP_TRANSPORT","route":"exit","offset":0,"kind":"exit"}],"note":"Cancel and stop are not two names for one thing. Cancel deletes a job before collection and leaves the bed held; stop ends a journey already underway, closes the movement, and also leaves the bed held — but only stop demands to know where the patient is."},{"id":"bedrelease","name":"A bed release","subject":"A ward's plan for a bed coming free. It names the stay it belongs to, and nothing else about the person leaving.","width":1709,"height":566,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":170,"h":76,"label":"Not flagged"},{"id":"expected","kind":"normal","x":463,"y":60,"w":210,"h":76,"label":"Expected","sub":"Carries what it is waiting on — one of seven."},{"id":"confirmed","kind":"normal","x":946,"y":60,"w":210,"h":76,"label":"Confirmed","sub":"Decided. Still not a free bed."},{"id":"discharged","kind":"terminal","x":1429,"y":60,"w":240,"h":76,"label":"Discharged","sub":"The only step here that moves a real bed count."},{"id":"blocked","kind":"flag","x":428,"y":420,"w":280,"h":86,"label":"Stuck — a flag, not a stage","sub":"One of nine reasons. Sits on top of expected or confirmed; either can be flagged."},{"id":"preparing","kind":"flag","x":1250,"y":420,"w":300,"h":86,"label":"Being made ready — a flag","sub":"Cleaning or repair is a separate flag. It can be set on an expected, confirmed or discharged release, and recording the departure (or a ward transfer arriving) sets it too. It does not rewrite the ward count, but a new pull refuses when every free bed is still being prepared."}],"transitions":[{"from":"none","to":"expected","action":"FLAG_BED_RELEASE","route":"straight"},{"from":"expected","to":"confirmed","action":"CONFIRM_BED_RELEASE","route":"straight"},{"from":"confirmed","to":"expected","action":"REVERT_BED_RELEASE","route":"below","offset":40,"kind":"back"},{"from":"confirmed","to":"discharged","action":"RECORD_LEAVING","route":"straight"},{"from":"expected","to":"discharged","action":"RECORD_LEAVING","route":"above","offset":30,"kind":"skip","label":"straight from expected"},{"from":"confirmed","to":"discharged","action":"RECORD_ADMISSION_CARE","route":"below","offset":0,"kind":"side","label":"the patient's ward transfer completes it"},{"from":"expected","to":"discharged","action":"RECORD_ADMISSION_CARE","route":"below","offset":60,"kind":"skip","label":"straight from expected, by ward transfer"},{"from":"expected","to":"blocked","action":"BLOCK_BED_RELEASE","route":"exit","offset":0,"kind":"side"},{"from":"confirmed","to":"blocked","action":"BLOCK_BED_RELEASE","route":"exit","offset":90,"kind":"side"},{"from":"blocked","to":"expected","action":"CLEAR_BED_RELEASE_BLOCK","route":"exit","offset":0,"kind":"side"},{"from":"expected","to":"preparing","action":"SET_BED_PREPARATION","route":"exit","offset":110,"kind":"side"},{"from":"confirmed","to":"preparing","action":"SET_BED_PREPARATION","route":"exit","offset":130,"kind":"side"},{"from":"discharged","to":"preparing","action":"SET_BED_PREPARATION","route":"exit","offset":150,"kind":"side","label":"made ready after the person leaves"},{"from":"expected","to":"preparing","action":"RECORD_LEAVING","route":"exit","offset":170,"kind":"side","label":"the departure also marks the bed"},{"from":"confirmed","to":"preparing","action":"RECORD_LEAVING","route":"exit","offset":190,"kind":"side","label":"the departure also marks the bed"},{"from":"expected","to":"preparing","action":"RECORD_ADMISSION_CARE","route":"exit","offset":210,"kind":"side","label":"a ward transfer arriving also marks the bed"},{"from":"confirmed","to":"preparing","action":"RECORD_ADMISSION_CARE","route":"exit","offset":230,"kind":"side","label":"a ward transfer arriving also marks the bed"}],"note":"Being stuck used to be a fourth stage and was deliberately removed on 28 August 2026, because each stage says only how certain the discharge is. Stuck-ness and cleaning are two separate flags sitting on top."},{"id":"expects","name":"The front door — an expect becomes a referral","subject":"A door the earlier drawing missed entirely. A referral that has been triaged but whose patient has not arrived sits on a separate list; marking them present is what moves it.","width":2011,"height":240,"states":[{"id":"raised","kind":"start","x":20,"y":60,"w":200,"h":70,"label":"Raised"},{"id":"expected","kind":"normal","x":537,"y":60,"w":260,"h":90,"label":"Expected to arrive","sub":"Triaged, and the patient is not here yet. It sits on the Expects list."},{"id":"present","kind":"normal","x":1114,"y":60,"w":260,"h":90,"label":"In the department","sub":"Marked present. It now reads as a referral rather than an expect."},{"id":"cleared","kind":"flag","x":1691,"y":60,"w":280,"h":90,"label":"Medically cleared — or not","sub":"Three answers, not two: unrecorded, cleared, and explicitly not cleared."}],"transitions":[{"from":"raised","to":"expected","action":"RECEIVE_REFERRAL","route":"straight"},{"from":"expected","to":"present","action":"RECORD_ARRIVED_IN_DEPARTMENT","route":"straight","guard":"stamped once; a repeat keeps the earliest time"},{"from":"present","to":"cleared","action":"RECORD_MEDICAL_CLEARANCE","route":"straight","kind":"side"},{"from":"expected","to":"cleared","action":"RECORD_MEDICAL_CLEARANCE","route":"below","offset":0,"kind":"side","label":"clearance can come first"}],"note":"The owner's own words for this, quoted in the model: “When expects arrive and are marked as arrived, they become referrals.” Being marked present is the only door between the two lists."},{"id":"legalstatus","name":"A patient's legal status","subject":"Four values on an open movement. CHANGE_LEGAL_STATUS records a change and history; it does not itself release a bed or advance the journey. Sending-desk kind and authenticated place scope still apply.","width":1683,"height":226,"states":[{"id":"voluntary","kind":"normal","x":20,"y":60,"w":240,"h":76,"label":"Voluntary"},{"id":"referred","kind":"normal","x":451,"y":60,"w":280,"h":76,"label":"Referred for psychiatric examination"},{"id":"detained","kind":"normal","x":922,"y":60,"w":280,"h":76,"label":"Detained awaiting examination"},{"id":"involuntary","kind":"normal","x":1393,"y":60,"w":250,"h":76,"label":"Involuntary inpatient"}],"transitions":[{"from":"voluntary","to":"referred","action":"CHANGE_LEGAL_STATUS","route":"straight"},{"from":"referred","to":"detained","action":"CHANGE_LEGAL_STATUS","route":"straight"},{"from":"detained","to":"involuntary","action":"CHANGE_LEGAL_STATUS","route":"straight"},{"from":"involuntary","to":"voluntary","action":"CHANGE_LEGAL_STATUS","route":"below","offset":20,"kind":"back","label":"any value to any other"}],"note":"Any value can be recorded as another; arrows illustrate examples rather than an enforced legal sequence. The handler requires a listed reason and an open movement. A newly unsuitable accepted ward is surfaced for a person; forward placement/transport steps recheck legal authority, so the change can block later progress."},{"id":"examination","name":"An examination","subject":"Four outcomes. Two of them end the bed search; one of them asks for another examination and is the only way a second one is allowed.","width":1757,"height":426,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":200,"h":70,"label":"Not examined"},{"id":"further","kind":"normal","x":449,"y":60,"w":260,"h":90,"label":"Further examination ordered","sub":"The only outcome that allows another examination."},{"id":"inpatient","kind":"terminal","x":938,"y":60,"w":250,"h":90,"label":"Inpatient order","sub":"Recorded. Nothing else changes."},{"id":"ended","kind":"terminal","x":1417,"y":60,"w":300,"h":90,"label":"Community order, or revoked","sub":"A community order or revocation is recorded. Closure/release depends on the held-bed and transport facts."},{"id":"superseded","kind":"flag","x":320,"y":250,"w":300,"h":86,"label":"Superseded","sub":"The previous examination is kept, not overwritten."}],"transitions":[{"from":"none","to":"further","action":"RECORD_EXAMINATION","route":"straight"},{"from":"none","to":"inpatient","action":"RECORD_EXAMINATION","route":"above","offset":26,"kind":"skip"},{"from":"none","to":"ended","action":"RECORD_EXAMINATION","route":"above","offset":60,"kind":"skip"},{"from":"further","to":"superseded","action":"RECORD_EXAMINATION","route":"exit","offset":0,"kind":"side","label":"a second examination","guard":"a second examination is refused unless the last one ordered a further one"}],"note":"A community order before transport commitment closes the search and releases its hold. Revocation with a held bed retains the bed and admission, keeps the movement open and flags a person to act. At handover-ready, moving or after collection either ending outcome also retains it. Acceptance, en-route and collection refuse an unresolved examination/hold; physical arrival remains recordable."},{"id":"notice","name":"A notice","subject":"Twenty-four kinds of message, addressed to one role at one place. Written once, never rewritten, never deleted and never expiring.","width":1442,"height":246,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":200,"h":70,"label":"Nothing sent"},{"id":"unread","kind":"normal","x":531,"y":60,"w":280,"h":96,"label":"Raised, unread","sub":"Its wording is frozen at the moment it is written, even if the thing it describes later changes."},{"id":"read","kind":"terminal","x":1122,"y":60,"w":280,"h":96,"label":"Read","sub":"Only the addressee can mark it, only by clicking, and only once."}],"transitions":[{"from":"none","to":"unread","action":"ACCEPT_REFERRAL","route":"straight","label":"one of twenty-four kinds","guard":"raised as a side-effect of an action, never on its own"},{"from":"unread","to":"read","action":"MARK_NOTICE_READ","route":"straight","guard":"refused if you are not the addressee, and refused a second time"}],"note":"Opening the drawer does not mark a notice read. MARK_NOTICE_READ requires the addressed role/place and an unread notice. These are append-only authored messages, separate from derived action-inbox rows and from broadcast alerts. Referral-answer notices resolve the referring ED for ed_medical referrals; other source kinds currently have no safe referrer addressee."},{"id":"inbox","name":"A row in the coordinator's inbox","subject":"Derived fact rows come from movements, stays, planned bookings and bed-meeting actions. A separate daily nobody-missed check is a commitment with append-only completion history.","width":1640,"height":416,"states":[{"id":"absent","kind":"start","x":20,"y":60,"w":220,"h":70,"label":"Not showing"},{"id":"showing","kind":"normal","x":620,"y":60,"w":300,"h":96,"label":"Showing","sub":"A current fact category is true, or a commitment is due. The current categories live in INBOX_CATEGORIES rather than a fixed five-item list."},{"id":"acknowledged","kind":"normal","x":1300,"y":60,"w":300,"h":96,"label":"Acknowledged","sub":"Somebody has seen a fact row. The row stays exactly where it was. A commitment is never acknowledged."},{"id":"ticked","kind":"normal","x":1140,"y":230,"w":300,"h":96,"label":"Commitment completed","sub":"The daily check can be completed and reopened. Live fact categories cannot be ticked away; bed-meeting actions use their dedicated completion event."}],"transitions":[{"from":"absent","to":"showing","action":"ACKNOWLEDGE_INBOX_ITEM","route":"straight","label":"the situation becomes true","kind":"side","guard":"nothing raises a row — it is derived, and appears on its own"},{"from":"showing","to":"acknowledged","action":"ACKNOWLEDGE_INBOX_ITEM","route":"straight","guard":"hides nothing and removes nothing; a second person acknowledging is a second real fact"},{"from":"showing","to":"ticked","action":"COMPLETE_INBOX_ITEM","route":"exit","offset":0,"kind":"side","label":"commitments only","guard":"Only commitment IDs; daily-check IDs require the day-N shape, and an already-complete history refuses. A commitment is completed straight from Showing and is never acknowledged. Facts remain until their underlying situation changes."},{"from":"ticked","to":"showing","action":"REOPEN_INBOX_ITEM","route":"above","offset":0,"kind":"back","label":"back to showing"}],"note":"Acknowledgement, ownership, snoozing and completion are separate histories. Real fact rows are never completed by COMPLETE_INBOX_ITEM. The daily check uses a day-shaped identifier rather than a movement; bed-meeting actions use COMPLETE_BED_MEETING_ACTION. CANCEL_TRANSPORT appends a returned snooze and a released ownership entry to the job's awaiting-departure and booking-estimate-passed rows. Completion validates category and day syntax, not whether the day is the current day."},{"id":"legalform","name":"A legal form's receipt","subject":"Whether the paperwork has physically arrived. It can be undone, and then happen again.","width":1382,"height":240,"states":[{"id":"not","kind":"start","x":20,"y":60,"w":240,"h":76,"label":"Not recorded as received"},{"id":"received","kind":"normal","x":521,"y":60,"w":260,"h":90,"label":"Recorded as received","sub":"Any of the nine forms with a legal clock, not only 1A. A second receipt is refused. A typed received time is kept as typed and cannot be later than now."},{"id":"expiry","kind":"flag","x":1042,"y":60,"w":300,"h":90,"label":"An expiry, typed by a clinician","sub":"Expiry comes from checked paper facts. An extension must be later; a correction with matching prior form/time/expiry and a listed reason may move it earlier."}],"transitions":[{"from":"not","to":"received","action":"RECORD_LEGAL_FORM_RECEIVED","route":"straight"},{"from":"received","to":"not","action":"CORRECT_LEGAL_FORM_RECEIPT","route":"below","offset":20,"kind":"back","guard":"three reasons: recorded in error, recorded against the wrong movement, or the form had not physically arrived"},{"from":"received","to":"expiry","action":"RECORD_LEGAL_FORM_EXPIRY","route":"straight","kind":"side"},{"from":"not","to":"expiry","action":"RECORD_LEGAL_FORM_EXPIRY","route":"above","offset":0,"kind":"side","label":"before a receipt"}],"note":"Receipt correction appends its reason and clears the receipt without erasing history. Expiry entry need not wait for a receipt: it requires a recorded form. The admitted ward may record a typed expiry on an arrived/closed movement; a checked correction and a later extension are distinct paths."}],"resources":{"title":"A ward's two bed counts","blurb":"The illustrated routes below show the principal stored-count changes; the current event models also cover planned admissions, direct placement and undo. A normal departure completes the named live release and raises empty/allocatable once. A departure resolving an arrival-capacity conflict clears that conflict instead of inventing another bed. Ready capacity also excludes closed wards, individually closed beds and other journeys' pending numbered reservations.","counts":[{"name":"Allocatable","means":"Beds the ward will let a coordinator take.","moves":[{"action":"PULL_PATIENT","effect":"− 1"},{"action":"RELEASE_PULL","effect":"+ 1"},{"action":"RELEASE_HELD_BED","effect":"+ 1"},{"action":"WITHDRAW_REFERRAL","effect":"+ 1","note":"via the same release"},{"action":"RECORD_ED_OUTCOME","effect":"+ 1","note":"via the same release"},{"action":"REFER_TO_COMMUNITY_TEAM","effect":"+ 1","note":"via the same release"},{"action":"RECORD_EXAMINATION","effect":"+ 1","note":"Community order before commitment can release a hold; revocation with a held bed retains it for a person to release."},{"action":"RECORD_LEAVING","effect":"+ 1","note":"the named patient leaving, which also completes their bed release"},{"action":"RECORD_ADMISSION_CARE","effect":"+ 1 on the ward they leave, − 1 on the ward they arrive at","note":"only a transfer recorded as arrived; the source ward's live bed release is completed in the same write"},{"action":"CONFIRM_CAPACITY","effect":"set outright","note":"a ward's own self-report, which can put it above the empty count"}]},{"name":"Empty","means":"Beds with physically nobody in them.","moves":[{"action":"PATIENT_ARRIVED","effect":"Usually −1, floored at zero; a pre-counted seeded pull is not decremented twice. Arrival into no empty bed is recorded as a capacity conflict."},{"action":"RECORD_LEAVING","effect":"+ 1","note":"Normally +1, bounded by authored capacity; resolving an arrival conflict or already-counted release does not create an extra free bed."},{"action":"RECORD_ADMISSION_CARE","effect":"+ 1 on the ward they leave, − 1 on the ward they arrive at","note":"only a transfer recorded as arrived"}]}]},"gates":{"title":"Can this ward take this patient?","blurb":"Thirteen possible eligibility labels across two paths, not thirteen blocking checks at every step. Eight labels belong to the suitability-override list. Acuity and specialling rows are information only; their actual staffing checks occur at placement. Gender designation has no override; Ready-bed and other physical-record checks run separately.","overridable":"Overridable means a coordinator may proceed anyway by choosing one of five recorded reasons: the receiving team has agreed despite the mismatch; clinical urgency outweighs the mismatch; the bed information is known to be out of date; continuity with a previous admission at this unit; closer to the person's home or family.","rows":[{"gate":"Authorisation","override":true,"referral":false,"movement":true,"asks":"If this patient is not voluntary, is the ward authorised under the Mental Health Act?"},{"gate":"Legal status","override":true,"referral":true,"movement":false,"asks":"The same question, asked at the front door instead — is an authorised bed needed, and does this ward have one?"},{"gate":"Cohort","override":true,"referral":false,"movement":true,"asks":"Does the ward's cohort match the patient's — adult, older adult, or youth?"},{"gate":"Age","override":true,"referral":true,"movement":false,"asks":"The same question at the front door, asked against the age band on the referral."},{"gate":"Security","override":true,"referral":true,"movement":true,"differs":true,"asks":"Does the patient need a locked bed?","note":"THE SAME NAME, TWO DIFFERENT QUESTIONS. At the front door it asks whether a locked bed is free right now. On a movement it asks only whether the ward has locked beds at all. The gap is known and written down."},{"gate":"Sex mix","override":true,"referral":true,"movement":true,"differs":true,"asks":"Is there already an occupant of the same sex, or more than one free bed?","note":"Both current sex-mix paths use Ready availability, with recorded gender and the defined recorded-sex fallback for non-binary or absent gender. Do not repeat the former front-door-versus-movement capacity difference for this row."},{"gate":"Forensic","override":true,"referral":true,"movement":true,"asks":"Is this a forensic ward? If so it is never offered."},{"gate":"Capacity freshness","override":true,"referral":true,"movement":true,"asks":"How long ago did the ward last confirm its numbers? A stale figure fails."},{"gate":"Gender designation","override":false,"referral":true,"movement":true,"hard":true,"asks":"Does the ward's designation suit the gender recorded at referral?","note":"Gender designation is checked before suitability overrides. A binary gender conflicting with the ward cannot be overridden. Non-binary, Different term and unrecorded gender can use an explicit coordinator placement record, subject to the current ward-checked reason requirements."},{"gate":"Acuity","override":false,"referral":true,"movement":true,"hard":true,"asks":"Information only: what high-acuity staffing is authored for the ward? Current use is checked at placement.","note":"This eligibility row always passes with info:true. PULL_PATIENT separately checks remaining high-acuity staffing and requires a valid reason plus nurse unit manager consultation for its supported exception."},{"gate":"Specialling","override":false,"referral":true,"movement":true,"hard":true,"differs":true,"asks":"Information only: what observation staffing is authored, and what does the recorded level need?","note":"This row always passes with info:true. A referral does not record observation level. PULL_PATIENT checks actual remaining observation staff; the eligibility row is not itself a hard refusal."},{"gate":"Prior decline","override":false,"referral":false,"movement":true,"hard":true,"asks":"Has this ward previously declined this movement? This is historical context; the reducer does not enforce it as a suitability refusal."},{"gate":"A bed to allocate","override":false,"referral":true,"movement":true,"hard":true,"differs":true,"asks":"Is there a bed to give?","note":"Movement matching can accept in principle on allocatable capacity; immediate referral matching requires Ready availability. PULL_PATIENT requires a Ready bed. Physical arrival is still recorded at zero empty capacity and creates an arrival-capacity conflict rather than refusing a patient in transit."}],"outside":{"title":"Placement and held-destination checks outside the label table","blurb":"These checks answer physical reservations, staffing and record consistency at their actual handlers. They are not all evaluated on every path; an already-held restoration has its own checks and physical arrival has a separate record-first path.","items":["A new pull needs a Ready bed, including closed-ward and closed-bed adjustments and live pulled admissions; when beds are being made ready it needs more Ready beds than pending ones (planned arrivals likewise). An arrival into zero empty capacity is recorded as a capacity conflict.","Every free bed still being prepared prevents a new pull.","Current observation staff and high-acuity capacity are checked at placement; supported exceptions need their recorded facts and acuity also needs nurse unit manager consultation.","A Secure request using an open bed requires the supported recorded reason; naming an unavailable numbered reservation still refuses.","Coordinator gender-placement records are required for the cases defined by genderReviewNeeded, and a binary designation conflict has no suitability override.","A restored hold rechecks its matching admission, current staffing, legal authority and gender rather than consuming another bed.","A no-transport arrival rechecks gender/legal status before arrival; an already-moving patient is recorded without stranding them at the door."]}},"gaps":[{"title":"The stored Unit.held field is not the live operational count","body":"Operational held/closed/Ready figures are derived. Unit.held remains seed and storage-validation data, so saying it is read in zero places is false. Filling this stored field is not a way to change the live derived figure.","question":"Would retiring this legacy storage field improve the model? Any removal needs a separately scoped migration and compatibility review."},{"title":"A patient-shaped placement wrapper remains separate from the live matching path","body":"genderEligibility is called by validateGenderPlacement, while live referral and movement matching share genderDesignationResult. These are distinct API shapes; the old claim that genderEligibility is never called is false. The wrapper currently has no production caller found in this source scan.","question":"Should the unused wrapper be retained as a public contract or retired under a separately reviewed API change? Its existence does not mean current matching skips gender."},{"title":"Inbox completion is for commitments; fact rows need their source condition resolved","body":"The daily nobody-missed check is a completable commitment, while derived fact rows cannot be ticked away. Bed-meeting actions have a separate completion event. COMPLETE_INBOX_ITEM validates the daily-check identifier shape and appends history; it does not verify that the named day is today.","question":"Should the daily-check API allow retrospective/future day records? Keep that product decision separate from the rule that live facts cannot be silenced."}],"review":{"reviewedOn":"2026-11-05","basis":"Source comparison of eleven machines, route nodes, gates, resources and current gap notes; not runtime or clinical acceptance. 5 November follow-up: explicit handler, payload, authority and caller review reconciled the consolidated audit repairs. Accepted observation sequence and legacy-tie fallback, current place/Undo provenance, safe world reset/import identity, return retry, meeting occurrence metadata and UI draft/completion ownership qualify existing transitions; they add no clinical decision or new physical transport stage. See CURRENT-REVIEW.md for the source-by-source review scope and reused versus fresh evidence. Main29f61/domain1430 reconciliation: accepted observation order is max(retained history,0)+1 with positive-safe restore metadata and sequence preserved through arrival; legacy ties retain compatibility fallback. Import and archive Undo share normalized retained identity, excluding explicit missing/privacy sentinels. Complete inverses preserve occupied-stay/leave consistency. No transition geometry or clinical rule changed; see CURRENT-REVIEW.md. #1447 consolidation, 5 November: other journeys' pending numbered bed reservations come off Ready and the free locked/open counts in the pull and planned-arrival gates; a pull release clears its held bed number and refuses a release matching no reservation; a coordinator transfer recorded as arrived needs a Ready bed; restore refuses a save whose live absences, active stays or numbered beds have more than one owner and names the broken rule. No transition geometry or clinical rule changed.","sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":584,"sha256":"fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"},{"path":"src/components/ward-management/legal-forms/legal-forms-screen.tsx","line":1,"sha256":"6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"},{"path":"src/components/ward-management/legal-forms/legal-forms-sheets.tsx","line":325,"sha256":"2d9f381246fc35b7c04bfcd41c26e67d584e594d41f73d8ddf1f913b7036c2bc"},{"path":"src/components/ward-management/patients/add-patient.tsx","line":87,"sha256":"fc5752f90ad948491ad836c940e4eb1571aba082c71cee36e4e6083afdf78002"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":1,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/shell/ward-broadcast-banner-body.tsx","line":1,"sha256":"a96ae00d184b52341105eb90f8a0438f5f5561f787c2522f97e0e7ea62e87178"},{"path":"src/components/ward-management/shell/ward-broadcast-banner.tsx","line":1,"sha256":"d34087fc1cfb2356065997d7942882cd1bc9791e3041e71ec0fb0d279fe429be"},{"path":"src/components/ward-management/shell/ward-facade.ts","line":32,"sha256":"1f67e3da9d32ff7085af624d524b3bcefe1c1c7790164963a98d21da4c830d6b"},{"path":"src/components/ward-management/ward-change-reasons.ts","line":1,"sha256":"b22acd93e5b480a06ecaa78e29979f31d274e4700187416623afd9e32553b2e4"},{"path":"src/components/ward-management/ward-configuration.ts","line":34,"sha256":"3e6cffc45878c910d85d900ae10360c06b6c647bbb4cf749875aaf5bb5640ca8"},{"path":"src/components/ward-management/ward-derivations-transport.ts","line":265,"sha256":"877a3c89501efb8f518b4bae3e30b51efd042e38b4b066f2db6ebbc81591ebba"},{"path":"src/components/ward-management/ward-derivations.ts","line":1,"sha256":"c254f1512e5602170a15419774de985744bf603ba81113e8ecd46f21d5adccfe"},{"path":"src/components/ward-management/ward-duplicate-bed-requests.ts","line":1,"sha256":"1bef25c3e6a549941d0753e095e0c7aa4bb26a1fc2dd12e8a526e1f8d2f9ddf6"},{"path":"src/components/ward-management/ward-eligibility.ts","line":49,"sha256":"5a876b1943bbfa47b1db277fb4a5b36b37d80de4c4ff9bb6b620366d7217800d"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":619,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":1,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":430,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":1,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":601,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":52,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":376,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1169,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":392,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1219,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-storage-validation.ts","line":460,"sha256":"cd370f6848c32198af9d13d0f8d43a4b1c5af4f1b9c1e2e5f1a8c15aefc81769"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":85,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":270,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":58,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-model-leave.ts","line":1,"sha256":"ef7c345e94d36c3ee2e7ee4c1eda650106340a856d29afdb1da1feadc38aea4e"},{"path":"src/components/ward-management/ward-model-notices.ts","line":1,"sha256":"9f4ca23254737cc5eec8353ee99d05265b4f9fe7bc04d17fe7c2abd954c08678"},{"path":"src/components/ward-management/ward-model-referral-parts.ts","line":1,"sha256":"a23ccdb01397d9807f0455c3baed92c6c8700422593ebcb89f5a51e990281fb6"},{"path":"src/components/ward-management/ward-model.ts","line":1,"sha256":"246b885c01dade4f48f7a46d323569f34ac206a306597ae60a761a2b5d6b2f2d"},{"path":"src/components/ward-management/ward-patient-registration-reducer.ts","line":77,"sha256":"9e0f9c39d6d4a7f8f406fd438e09cd9ea7b7c6631a7bdd5e059d1f38de3caac4"},{"path":"src/components/ward-management/ward-ready-beds.ts","line":1,"sha256":"489095566f42be24921c7ba289b59a13514c656bf4846cf9cf94fad5a5aeb13c"},{"path":"src/components/ward-management/ward-undo.ts","line":1,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-observation.ts","line":48,"sha256":"b714525f0d4c6d18d050f9a3600f38c8de4e9a013595a77844c5c492fbdc2e3c"},{"path":"src/components/ward-management/ward-retained-umrn.ts","line":13,"sha256":"7968243f077b9d5c9a6fe6a56385f48ff6a97aa39cfdeec8fe97f05919693d80"}]}},"coverage":{"total":98,"mapped":46,"refusalSitesInSelectedFiles":160,"sampledSourceFiles":["ward-flow-reducer.ts","ward-flow-record-events.ts","ward-flow-undo-events.ts"],"refusalsNamed":248,"rows":[{"name":"Raise a referral at the front door","event":"RECEIVE_REFERRAL","transitions":["A referral destination: raised → Waiting","The front door — an expect becomes a referral: Raised → Expected to arrive"],"writes":""},{"name":"Add a person who is not on file","event":"ADD_PATIENT","transitions":[],"writes":"Creates a patient record."},{"name":"Record whether they are medically cleared","event":"RECORD_MEDICAL_CLEARANCE","transitions":["The front door — an expect becomes a referral: In the department → Medically cleared — or not","The front door — an expect becomes a referral: Expected to arrive → Medically cleared — or not"],"writes":"Replaces the referral answer and the matching movements’ clearance. Positive re-clearance stamps resumedAt and restates their blocker; it does not restore a released bed or booking."},{"name":"Mark that an expected patient has turned up","event":"RECORD_ARRIVED_IN_DEPARTMENT","transitions":["The front door — an expect becomes a referral: Expected to arrive → In the department"],"writes":"The arrival time, on a referral. Stamped once; a repeat is harmless."},{"name":"Accept the referral","event":"ACCEPT_REFERRAL","transitions":["A referral destination: Waiting → Accepted","A referral destination: Declined → Accepted","A referral destination: Waiting → Cancelled","A notice: Nothing sent → Raised, unread"],"writes":""},{"name":"Decline the referral","event":"DECLINE_REFERRAL","transitions":["A referral destination: Waiting → Declined"],"writes":""},{"name":"The referrer takes the referral back","event":"RECORD_REFERRER_WITHDRAWAL","transitions":["A referral destination: Waiting → Withdrawn — a flag, not a state"],"writes":""},{"name":"Add a correction to a referral","event":"ADD_REFERRAL_CORRECTION","transitions":[],"writes":"Appends a correction note to a referral. Never overwrites."},{"name":"Record that a bed closer to home was looked for","event":"RECORD_LOCAL_BED_SOUGHT","transitions":[],"writes":"That a closer-to-home bed was looked for, on a referral."},{"name":"Start a bed search from a department","event":"RAISE_REFERRAL","transitions":["A movement: Movement created → Placement requested"],"writes":""},{"name":"Ask one or more wards","event":"REFER_TO_UNITS","transitions":["A movement: Placement requested → Destination review","A movement: Destination review → Destination review"],"writes":""},{"name":"A ward accepts in principle","event":"ACCEPT_IN_PRINCIPLE","transitions":["A movement: Destination review → Accepted, awaiting bed"],"writes":""},{"name":"A ward declines the bed search","event":"DECLINE","transitions":["A movement: Destination review → Destination review"],"writes":""},{"name":"Take back one ward's request","event":"WITHDRAW_WARD_REQUEST","transitions":["A movement: Destination review → Destination review"],"writes":""},{"name":"Undo a ward's acceptance","event":"WITHDRAW_ACCEPTANCE","transitions":["A movement: Accepted, awaiting bed → Destination review","A movement: Bed pulled → Destination review"],"writes":""},{"name":"Abandon the bed search","event":"WITHDRAW_REFERRAL","transitions":["A movement: Bed pulled → Closed — did not proceed","A movement: Destination review → Closed — did not proceed","A movement: Accepted, awaiting bed → Closed — did not proceed","A movement: Handover ready → Closed — did not proceed","An admission: Held → Removed — not a state"],"writes":""},{"name":"Send them to a community team instead","event":"REFER_TO_COMMUNITY_TEAM","transitions":["A movement: Bed pulled → Closed — did not proceed","An admission: Held → Removed — not a state"],"writes":""},{"name":"The department decides they need no bed","event":"RECORD_ED_OUTCOME","transitions":["A movement: Bed pulled → Closed — did not proceed","A movement: Placement requested → Closed — did not proceed","A movement: Destination review → Closed — did not proceed","A movement: Accepted, awaiting bed → Closed — did not proceed","A movement: Handover ready → Closed — did not proceed","An admission: Held → Removed — not a state"],"writes":""},{"name":"Record that nobody referred them","event":"RECORD_NO_REFERRAL","transitions":[],"writes":"That nobody referred this patient, on a movement."},{"name":"Record an escalation","event":"RECORD_ESCALATION","transitions":[],"writes":"The wards tried and who was contacted, on a movement."},{"name":"Correct the record backwards","event":"STEP_BACK_STAGE","transitions":["A movement: Moving → Placement requested","A movement: Destination review → Placement requested","A movement: Accepted, awaiting bed → Placement requested","A movement: Bed pulled → Placement requested","A movement: Handover ready → Placement requested"],"writes":""},{"name":"Take the bed","event":"PULL_PATIENT","transitions":["A movement: Accepted, awaiting bed → Bed pulled","An admission: No admission → Held"],"writes":""},{"name":"Give the held bed back","event":"RELEASE_PULL","transitions":["A movement: Bed pulled → Accepted, awaiting bed","An admission: Held → Removed — not a state"],"writes":""},{"name":"Release a bed left held by a stopped journey","event":"RELEASE_HELD_BED","transitions":["An admission: Held → Removed — not a state"],"writes":""},{"name":"Record whether transport is needed","event":"RECORD_TRANSPORT_NEED","transitions":[],"writes":"Whether transport is needed, on a movement. This is what allows arrival with no journey."},{"name":"Book the transport","event":"BOOK_TRANSPORT","transitions":["A transport job: No job → Booked"],"writes":""},{"name":"Confirm handover is ready","event":"HANDOVER_READY","transitions":["A movement: Bed pulled → Handover ready"],"writes":""},{"name":"The crew accepts the job","event":"TRANSPORT_ACCEPTED","transitions":["A transport job: Booked → Crew accepted"],"writes":""},{"name":"The crew sets off","event":"TRANSPORT_EN_ROUTE","transitions":["A transport job: Crew accepted → En route"],"writes":""},{"name":"The patient is picked up","event":"PATIENT_COLLECTED","transitions":["A movement: Handover ready → Moving","A transport job: En route → Collected"],"writes":""},{"name":"The ward says they have arrived","event":"PATIENT_ARRIVED","transitions":["A movement: Moving → Arrived","A movement: Bed pulled → Arrived","A movement: Arrived → Closed — did not proceed","An admission: Held → Occupied","A transport job: Collected → Arrived"],"writes":""},{"name":"Cancel the transport before collection","event":"CANCEL_TRANSPORT","transitions":["A transport job: Booked → No job","A transport job: Crew accepted → No job","A transport job: En route → No job"],"writes":""},{"name":"Stop the journey after collection","event":"STOP_TRANSPORT","transitions":["A movement: Moving → Closed — did not proceed","A transport job: Collected → Stopped"],"writes":""},{"name":"Record that they have left the department","event":"RECORD_LEFT_DEPARTMENT","transitions":[],"writes":"The time they physically left the department, on a movement."},{"name":"Record an examination outcome","event":"RECORD_EXAMINATION","transitions":["A movement: Bed pulled → Closed — did not proceed","A movement: Placement requested → Closed — did not proceed","A movement: Destination review → Closed — did not proceed","A movement: Accepted, awaiting bed → Closed — did not proceed","An admission: Held → Removed — not a state","An examination: Not examined → Further examination ordered","An examination: Not examined → Inpatient order","An examination: Not examined → Community order, or revoked","An examination: Further examination ordered → Superseded"],"writes":""},{"name":"Change the legal status","event":"CHANGE_LEGAL_STATUS","transitions":["A patient's legal status: Voluntary → Referred for psychiatric examination","A patient's legal status: Referred for psychiatric examination → Detained awaiting examination","A patient's legal status: Detained awaiting examination → Involuntary inpatient","A patient's legal status: Involuntary inpatient → Voluntary"],"writes":"The Mental Health Act status, on a movement, plus a log entry. Triggers nothing."},{"name":"Mark a form as physically received","event":"RECORD_LEGAL_FORM_RECEIVED","transitions":["A legal form's receipt: Not recorded as received → Recorded as received"],"writes":"That the Form 1A physically arrived, on a movement."},{"name":"Undo a form receipt","event":"CORRECT_LEGAL_FORM_RECEIPT","transitions":["A legal form's receipt: Recorded as received → Not recorded as received"],"writes":"Clears that receipt and appends the correction."},{"name":"Record or extend a form's expiry","event":"RECORD_LEGAL_FORM_EXPIRY","transitions":["A legal form's receipt: Recorded as received → An expiry, typed by a clinician","A legal form's receipt: Not recorded as received → An expiry, typed by a clinician"],"writes":"Stores the typed expiry, clears any calculated legacy clock, appends basis/author/time history and, for a correction, its previous facts and reason."},{"name":"Correct the recorded gender","event":"RECORD_MOVEMENT_GENDER","transitions":[],"writes":"The recorded gender on a movement, plus a notice if a bed is involved."},{"name":"Record that the patient has left","event":"RECORD_LEAVING","transitions":["An admission: Occupied → Departed","A bed release: Confirmed → Discharged","A bed release: Expected → Discharged","A bed release: Expected → Being made ready — a flag","A bed release: Confirmed → Being made ready — a flag"],"writes":""},{"name":"Record that they are away at an ED","event":"RECORD_AWAY_AT_EMERGENCY_DEPARTMENT","transitions":["An admission: Occupied → Occupied"],"writes":""},{"name":"Record that they are back","event":"RECORD_RETURNED_FROM_EMERGENCY_DEPARTMENT","transitions":["An admission: Occupied → Occupied"],"writes":""},{"name":"Record a bed as on leave","event":"RECORD_LEAVE_BED","transitions":[],"writes":"Creates a leave record against a ward's bed."},{"name":"End a bed's leave","event":"END_LEAVE_BED","transitions":[],"writes":"Removes that leave record."},{"name":"Flag a bed as coming free","event":"FLAG_BED_RELEASE","transitions":["A bed release: Not flagged → Expected"],"writes":""},{"name":"Confirm the discharge is going ahead","event":"CONFIRM_BED_RELEASE","transitions":["A bed release: Expected → Confirmed"],"writes":""},{"name":"Put a confirmed discharge back to expected","event":"REVERT_BED_RELEASE","transitions":["A bed release: Confirmed → Expected"],"writes":""},{"name":"Flag a discharge as stuck","event":"BLOCK_BED_RELEASE","transitions":["A bed release: Expected → Stuck — a flag, not a stage","A bed release: Confirmed → Stuck — a flag, not a stage"],"writes":""},{"name":"Clear the stuck flag","event":"CLEAR_BED_RELEASE_BLOCK","transitions":["A bed release: Stuck — a flag, not a stage → Expected"],"writes":""},{"name":"Mark a bed as being made ready","event":"SET_BED_PREPARATION","transitions":["A bed release: Expected → Being made ready — a flag","A bed release: Confirmed → Being made ready — a flag","A bed release: Discharged → Being made ready — a flag"],"writes":""},{"name":"Restate how many beds a ward has","event":"CONFIRM_CAPACITY","transitions":[],"writes":"Sets a ward's allocatable count outright — see the two bed counts."},{"name":"Record what is restricting a ward's intake","event":"RECORD_WARD_INTAKE_CONSTRAINTS","transitions":[],"writes":"Replaces a ward's list of intake restrictions."},{"name":"Ask a ward to refresh its numbers","event":"REQUEST_CAPACITY_REFRESH","transitions":[],"writes":"Logs that somebody asked a ward to refresh. Moves no count."},{"name":"Change how urgent it is","event":"CHANGE_URGENCY","transitions":[],"writes":"The urgency level on a movement, plus a log entry. Re-sorts nothing."},{"name":"Flag it urgent","event":"FLAG_MOVEMENT_URGENT","transitions":[],"writes":"The urgent flag on a movement, and opens a history entry."},{"name":"Clear the urgent flag","event":"CLEAR_MOVEMENT_URGENT_FLAG","transitions":[],"writes":"Clears that flag and closes the history entry."},{"name":"Say what is holding this up","event":"RECORD_MOVEMENT_BLOCKER","transitions":[],"writes":"Free text describing what is holding a movement up."},{"name":"Say nothing is holding it up","event":"CLEAR_MOVEMENT_BLOCKER","transitions":[],"writes":"Writes the sentinel meaning nothing is holding it up."},{"name":"Mark a notice read","event":"MARK_NOTICE_READ","transitions":["A notice: Raised, unread → Read"],"writes":"Who read a notice, and when."},{"name":"Acknowledge an inbox row","event":"ACKNOWLEDGE_INBOX_ITEM","transitions":["A row in the coordinator's inbox: Not showing → Showing","A row in the coordinator's inbox: Showing → Acknowledged"],"writes":"Logs that a coordinator has seen an inbox row."},{"name":"Tick off an inbox row","event":"COMPLETE_INBOX_ITEM","transitions":["A row in the coordinator's inbox: Showing → Commitment completed"],"writes":"Appends completed role/time history without mutating patient, movement or unit facts."},{"name":"Reopen a completed row","event":"REOPEN_INBOX_ITEM","transitions":["A row in the coordinator's inbox: Commitment completed → Showing"],"writes":"Logs an inbox row as reopened, keeping that it was once done."},{"name":"Move the demonstration clock","event":"ADVANCE_CLOCK","transitions":[],"writes":"Adds the simulation clock offset; the provider also follows wall time at visible minute ticks."},{"name":"Reset the board","event":"RESET_SCENARIO","transitions":[],"writes":"Re-seeds all board state around the current visible time and clears the simulation offset, preserving the visible clock rather than always selecting the standard scenario."},{"name":"Switch to a different simulated night","event":"SET_SCENARIO","transitions":[],"writes":"Replaces the whole board with a different simulated night."},{"name":"Change the coordinator's settings","event":"SET_CONFIGURATION","transitions":[],"writes":"Applies the validated configuration or field merge atomically. It does not silently overwrite a conflicting baseline."},{"name":"Record a patient’s physical departure","event":"RECORD_PATIENT_DISCHARGE","transitions":[],"writes":"Departs the stay through the shared departure helper, adjusts resources, retains audit and a bounded step-undo record. A stale or inaccessible request refuses."},{"name":"Open an authorised discharge record","event":"OPEN_DISCHARGE_RECORD","transitions":[],"writes":"Records an accepted read audit event; changes no admission or bed figure."},{"name":"Record a governance review","event":"REVIEW_AUDIT_EVENT","transitions":[],"writes":"Appends a uniquely sequenced review and its audit record. A later review changes the expected count; UNDO_AUDIT_REVIEW is a separate recorded action."},{"name":"Divert a journey already under way","event":"RECORD_DIVERSION","transitions":[],"writes":"That a journey already under way was diverted, with a reason and where the patient went instead."},{"name":"Give back the bed a diverted patient was holding","event":"RELEASE_DIVERTED_BED","transitions":[],"writes":"Gives back the bed a diverted movement was still holding. Refused unless it really was diverted."},{"name":"Record how and when they are expected","event":"SET_ARRIVAL_DETAILS","transitions":[],"writes":"Stores arrival mode, optional tracking and estimate, retaining first-record author/time and later update provenance. Keeps the pull-expiry timer. An already-late estimate can send one-time ED/ward notices; it reserves no bed and moves no stage."},{"name":"Work out whether an expected arrival is late","event":"EVALUATE_ARRIVAL_LATENESS","transitions":[],"writes":"When late, stamps the movement and sends ED and ward notices; changes no stage."},{"name":"Mark somebody as a step-down candidate","event":"SET_STEP_DOWN_CANDIDATE","transitions":[],"writes":"Whether this admission is a candidate to step down to a lower level of care."},{"name":"Record what is holding a discharge up","event":"SET_DISCHARGE_BARRIER","transitions":[],"writes":"Stores a listed discharge barrier or clears it; no seven-day reducer gate and no bed count change."},{"name":"Record clinically ready and why not gone","event":"SET_CLINICALLY_READY","transitions":[],"writes":"Stores the day an on-ward patient became clinically ready and one listed reason they have not gone, or clears both (Josh, 9 Nov 2026); no bed count change."},{"name":"Set or move the expected discharge date","event":"UPDATE_EXPECTED_DISCHARGE","transitions":[],"writes":"Sets the expected time, increments date-move count only when an existing date differs, and stamps when. A ward setter is Nurse in charge; coordinator setter is null. Pending linked bed-release dates follow; completed release dates stay historical."},{"name":"Record care journey fact","event":"RECORD_ADMISSION_CARE","transitions":["A movement: Movement created → Arrived","An admission: Occupied → Departed","An admission: No admission → Occupied","A bed release: Confirmed → Discharged","A bed release: Expected → Discharged","A bed release: Expected → Being made ready — a flag","A bed release: Confirmed → Being made ready — a flag"],"writes":""},{"name":"Record follow-up arrangement","event":"RECORD_ADMISSION_FOLLOW_UP","transitions":[],"writes":"Follow-up contact arrangements recorded against an admission on the discharge board."},{"name":"Record medical clearance against the movement","event":"RECORD_MOVEMENT_MEDICAL_CLEARANCE","transitions":[],"writes":"Replaces clearance on the movement, matching linked referral and matching sibling movements. Positive fresh clearance records resumedAt for satisfied pauses; it does not restore released resources."},{"name":"Attach a file to the movement","event":"UPLOAD_PATIENT_FORM","transitions":[],"writes":"Appends generated document id, formName, fileType, sizeBytes and role/time metadata; no file body or original filename is retained."},{"name":"Record that a legal form was written","event":"RECORD_LEGAL_FORM_WRITTEN","transitions":[],"writes":"Stores current paper facts and history, preserves matching same-form paper facts on a time edit, and clears a calculated legacy clock. A different form clears the old receipt."},{"name":"Record that a form was continued","event":"RECORD_LEGAL_FORM_CONTINUATION","transitions":[],"writes":"The continued form and clinician-typed times; clears the old legal clock."},{"name":"Record a typed country Form 1A extension","event":"RECORD_COUNTRY_EXTENSION","transitions":[],"writes":"For eligible country Form1A, records typed paper expiry through the ordinary expiry handler; computes no statutory deadline."},{"name":"Flag that the ward's authority does not match","event":"FLAG_LEGAL_MISMATCH","transitions":[],"writes":"That a ward's authority does not match this person's legal status, in one of two shapes."},{"name":"Start a forty-eight-hour or seven-day clock by hand","event":"RAISE_EXPECT_FLAG","transitions":[],"writes":"Records the current manually raised flag. Replacing a previously cleared flag keeps that prior record in expectFlagHistory; no automatic state transition is implied."},{"name":"Clear that hand-set clock","event":"CLEAR_EXPECT_FLAG","transitions":[],"writes":"Stamps clearedAt and clearedBy on the flag; it is retained rather than removed."},{"name":"Give the bed back and reopen the search, in one act","event":"RELEASE_AND_REOPEN_SEARCH","transitions":[],"writes":"Returns any matching held bed, clears acceptance/hold/requests/transport and moves to placement_requested. Logs pull release when held, otherwise acceptance withdrawal."},{"name":"Confirm the ward's morning count","event":"CONFIRM_MORNING_ROLLUP","transitions":[],"writes":"A ward confirming its own morning count of expected discharges."},{"name":"Send a message to a ward","event":"SEND_WARD_BUZZ","transitions":[],"writes":"Appends a refresh request with a listed message and optional urgency; blank messages refuse and nothing is sent externally."},{"name":"Sweep the beds held during leave","event":"EVALUATE_LEAVE_BED_WARNINGS","transitions":[],"writes":"For each leave bed over the open-warning threshold that has not been warned, records openWarningAt and sends a ward notice. It does not release the bed or move capacity."},{"name":"Log a repatriation arranged by phone","event":"RECORD_REPATRIATION","transitions":[],"writes":"Creates or updates the telephone plan. First agreement creates an open placement_requested return movement linked to the source stay; it does not itself book transport or transfer the patient."},{"name":"Sign off the shift handover","event":"RECORD_HANDOVER_SIGN_OFF","transitions":[],"writes":"Appends role/time plus the selected ward id or network flag. It records no personal name/note and makes no claim that a sheet was sent."},{"name":"Record that a team was contacted","event":"RECORD_CLINICAL_CONTACT","transitions":[],"writes":"Which community team was contacted, when, and by which role."},{"name":"Send a network-wide alert","event":"DISPATCH_BROADCAST_ALERT","transitions":[],"writes":"A network-wide alert, active, with nobody yet acknowledging it. Belongs to no patient."},{"name":"Acknowledge a network-wide alert","event":"ACKNOWLEDGE_BROADCAST_ALERT","transitions":[],"writes":"One more unit on the alert's acknowledged list."},{"name":"Stand down a network-wide alert","event":"STAND_DOWN_BROADCAST_ALERT","transitions":[],"writes":"The alert marked stood down, with the time and the role."}]},"catalogue":[{"event":"RECORD_ADMISSION_CARE","roles":["ward","coordinator","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":20},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":213},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1580}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ADMISSION_FOLLOW_UP","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":21},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":213},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1579}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_PATIENT_DISCHARGE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":22},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1578}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"UPDATE_EXPECTED_DISCHARGE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":23},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":226},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1772}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"OPEN_DISCHARGE_RECORD","roles":["coordinator","ward","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":25},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":178},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1575}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REVIEW_AUDIT_EVENT","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":26},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":131},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1576}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RAISE_REFERRAL","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":37},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1573},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":92}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_EXAMINATION","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":38},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":549},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1872}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_MEDICAL_CLEARANCE","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":39},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":167},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1863}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ARRIVED_IN_DEPARTMENT","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":43},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":216},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1864}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_TRANSPORT_NEED","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":52},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":229},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1865}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_RECEIVED","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":59},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":434},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1546}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CORRECT_LEGAL_FORM_RECEIPT","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":65},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1853},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":429}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_EXPIRY","roles":["ed","coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":75},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1358},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":52},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1869}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_MOVEMENT_GENDER","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":80},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":480},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1870}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_NO_REFERRAL","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":81},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":297},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1866}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ED_OUTCOME","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":84},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":328},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1867}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REFER_TO_UNITS","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":85},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1855},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":675}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ACCEPT_IN_PRINCIPLE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":86},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":890},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":108}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"PULL_PATIENT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":90},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":79},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":694}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"DECLINE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":91},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1903},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":240}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"HANDOVER_READY","roles":["ed","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":94},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1997},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":85}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"TRANSPORT_ACCEPTED","roles":["officer","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":95},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1998},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":128}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"TRANSPORT_EN_ROUTE","roles":["officer","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":96},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1999},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":178}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"PATIENT_COLLECTED","roles":["officer","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":97},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2000},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":229},{"path":"src/components/ward-management/ward-transport-collection-events.ts","line":11}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"PATIENT_ARRIVED","roles":["officer","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":98},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1603},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":315}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CONFIRM_CAPACITY","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":100},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":300},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1774}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_WARD_INTAKE_CONSTRAINTS","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":103},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":767},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1878}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ESCALATION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":104},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1065},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1885}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ADVANCE_CLOCK","roles":["demo"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":105},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1817}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RESET_SCENARIO","roles":["demo"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":106},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1595}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_SCENARIO","roles":["demo"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":107},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1595}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_CONFIGURATION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":109},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1828}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CHANGE_URGENCY","roles":["coordinator","ed","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":112},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1859},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1178}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CHANGE_LEGAL_STATUS","roles":["coordinator","ed","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":113},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1860},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1219}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RELEASE_PULL","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":114},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":493},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1990}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"EXTEND_PULL","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":116},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":454},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1989}],"status":"modelled","model":{"subject":"One open movement whose bed is pulled now","before":"A pulled bed with its Pull time limit","after":"The same pulled bed with a later Pull time limit and one more pullExtensions entry","payload":["movementId; minutes (60, 120 or 240 from PULL_HOLD_EXTENSION_MINUTES); actingUnitId for a ward caller; now; role."],"scope":"coordinator and ward in the role table; a ward acts only for the unit holding the bed (claim, not proof).","guards":["The movement exists, is not closed, is at stage pulled with a Pull time limit, and its patient has not been collected.","minutes is on the fixed list.","The new limit stays within PULL_HOLD_MAX_TOTAL_MINUTES (12 hours) of the pull; a lapsed limit is extended from now."],"effects":["Moves Movement.pullExpiresAt later and appends { at, by, minutes } to Movement.pullExtensions; no bed count, stage or notice changes. PULL_PATIENT clears the list on a new pull."],"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":454,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-bed-hold-extension.ts","line":48,"sha256":"668e77dbccc3fcaa5409abea768e539bb949659a919c68a81b0bfb4578cd04dc"}],"tests":["tests/ward-extend-pull.test.ts"]},"reason":"Reviewed command model (feature 11, 9 Nov 2026): the ward or coordinator adds a fixed amount to a pulled bed's Pull time limit."},{"event":"BOOK_TRANSPORT","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":153},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2002},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":654}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CANCEL_TRANSPORT","roles":["coordinator","ed","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":175},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2003},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":840}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"STOP_TRANSPORT","roles":["coordinator","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":185},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2004},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1018}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_TRANSPORT_CAD","roles":["ed","ward","community","coordinator","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":188},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2007},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1131},{"path":"src/components/ward-management/ward-transport-collection-events.ts","line":30}],"status":"modelled","model":{"subject":"A movement’s current transport job","before":"Live, unarrived, uncancelled transport with no nonblank CAD number","after":"Same job carrying a trimmed CAD number and cadAdded time/role","payload":["movementId; cadNumber is required text, trimmed after validation","actingUnitId required in practice for ward callers; role and now"],"scope":"ED, ward, community, coordinator or officer in EVENT_ROLE. Ward acts only for the sending stay/ward; shared scope also restricts ED to origin ED and community to the sending team. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Existing open movement and live job; no existing nonblank CAD number","Reject blank or placeholder CAD values; ward’s actingUnitId must identify the sending ward"],"effects":["Updates only movement.transport.cadNumber and cadAdded; does not dispatch, accept or advance the job"],"sources":[{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1126,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":188,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-transport-collection-events.ts","line":30,"sha256":"1ebf665a65645eb14f53647d07db90bef0a947b2a7e298f2b6f203b7c78d3496"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-transport-cad-to-follow.test.ts"]},"reason":"Source-reviewed command model: Same job carrying a trimmed CAD number and cadAdded time/role."},{"event":"RELEASE_HELD_BED","roles":["coordinator","ward","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":190},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":619},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1991}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_DIVERSION","roles":["officer","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":192},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1092},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1886}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RELEASE_DIVERTED_BED","roles":["coordinator","ward","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":194},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":687},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1992}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REFER_TO_COMMUNITY_TEAM","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":195},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1854},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":477}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEFT_DEPARTMENT","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":196},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":529},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1871}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"FLAG_BED_RELEASE","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":199},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":372},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1775}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CONFIRM_BED_RELEASE","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":200},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":466},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1776}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REVERT_BED_RELEASE","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":204},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":505},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1777}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"BLOCK_BED_RELEASE","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":205},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":544},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1778}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CLEAR_BED_RELEASE_BLOCK","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":206},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":584},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1779}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_BED_PREPARATION","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":207},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":621},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1780}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEAVE_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":208},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1347},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":317},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1879}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"END_LEAVE_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":209},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":656},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1781}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ABSENT_WITHOUT_LEAVE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":213},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1348},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":372},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1880}],"status":"modelled","model":{"subject":"An occupied admission and its held leave-bed record","before":"Occupied stay, not away at ED, with no recorded absence","after":"Leave-bed record carries absentWithoutLeave {since,steps:[]}; stay remains occupied","payload":["admissionId; actingUnitId must match the stay’s ward; role and now"],"scope":"Ward or coordinator; every caller supplies the admission ward claim. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Stay must exist and be occupied","Reject another ward, existing absence, or a stay recorded away at an ED"],"effects":["Updates an existing leave-bed record or creates one with expectedReturn=now; preserves existing leave details","Keeps the admission and bed occupancy; return is recorded separately through END_LEAVE_BED"],"sources":[{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":372,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":213,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1380,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-absence-and-cto.test.ts","tests/ward-away-from-ward-exclusive.test.ts"]},"reason":"Source-reviewed command model: Leave-bed record carries absentWithoutLeave {since,steps:[]}; stay remains occupied."},{"event":"RECORD_ABSENCE_STEP","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":214},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1349},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":424},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1881}],"status":"modelled","model":{"subject":"An existing absence without leave","before":"Absence has no record of this listed missing-person step","after":"Same absence with one timed step appended","payload":["admissionId; actingUnitId; step from ABSENCE_STEPS; role and now"],"scope":"Ward or coordinator; actingUnitId must equal the absence record’s unit. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["An absence record must exist for the admission","Step must be listed, not already recorded, and not earlier than absence.since"],"effects":["Appends {step,at} to absentWithoutLeave.steps; does not end absence, release a bed or contact anyone"],"sources":[{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":424,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":214,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1389,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-absence-and-cto.test.ts"]},"reason":"Source-reviewed command model: Same absence with one timed step appended."},{"event":"RECORD_COMMUNITY_TREATMENT_ORDER","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":215},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1359},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":155},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1882}],"status":"modelled","model":{"subject":"A patient’s recorded community treatment order","before":"Patient exists with no current order, no occupied stay and no open non-arrived placement","after":"Form 5A recorded with time and desk label; any ended order retained in earlier history","payload":["patientId; role and now; no user-supplied lapse time"],"scope":"Community or coordinator. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Reject missing patient or a current order without endedAt","Reject an occupied admission or open movement whose stage is not arrived; waitlisted/pulled stays alone do not block"],"effects":["Writes patient.communityTreatmentOrder; moves prior ended order and its earlier history into earlier","No automatic expiry, placement, legal-status change or bed move","The step can be taken back by UNDO_PATIENT_RECORD within the Undo window, filed against the patient record."],"sources":[{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":155,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":215,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1398,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-absence-and-cto.test.ts"]},"reason":"Source-reviewed command model: Form 5A recorded with time and desk label; any ended order retained in earlier history."},{"event":"END_COMMUNITY_TREATMENT_ORDER","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":216},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":669},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1782}],"status":"modelled","model":{"subject":"A patient’s current community treatment order","before":"Order exists and has no endedAt","after":"Same order retained with endedAt=now","payload":["patientId; role and now"],"scope":"Community or coordinator. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient and an unended order must exist; repeat ending is refused"],"effects":["Adds endedAt; retains the order and earlier history; no timer or automatic end","The step can be taken back by UNDO_PATIENT_RECORD within the Undo window, filed against the patient record."],"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":667,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":216,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1405,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-absence-and-cto.test.ts"]},"reason":"Source-reviewed command model: Same order retained with endedAt=now."},{"event":"RECORD_LEAVING","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":220},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1343},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":122},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1601}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_AWAY_AT_EMERGENCY_DEPARTMENT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":232},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1344},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":208},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1875}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_RETURNED_FROM_EMERGENCY_DEPARTMENT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":233},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1345},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":244},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1876}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_STAY_DISCHARGE_BLOCKER","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":236},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1346},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":264},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1877}],"status":"modelled","model":{"subject":"An occupied admission and its pending bed releases","before":"Occupied stay with no blocker or another recorded blocker","after":"Stay blockReason and linked nondischarged releases carry the chosen blocker","payload":["admissionId; actingUnitId; blocker from BED_RELEASE_BLOCKERS; role and now"],"scope":"Ward, site bed manager or coordinator; actingUnitId must equal admission.unitId. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Admission must exist, be occupied and match actingUnitId","blocker must be a nonempty member of BED_RELEASE_BLOCKERS"],"effects":["Replaces admission.blockReason","For all linked releases not discharged, updates blocker, blockedBy, blockerRecordedAt and confirmedAt; moves no capacity figure or bed state"],"sources":[{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":264,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":236,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1838,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-stay-discharge-blocker.test.ts"]},"reason":"Source-reviewed command model: Stay blockReason and linked nondischarged releases carry the chosen blocker."},{"event":"CLEAR_STAY_DISCHARGE_BLOCKER","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":237},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":249},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1773}],"status":"modelled","model":{"subject":"An admission’s current discharge blocker","before":"Admission carries a non-null blockReason","after":"Admission blockReason=null; clearance retained on matching pending release or admission","payload":["admissionId; actingUnitId; optional reason from DISCHARGE_DELAY_CLEAR_REASONS; role and now"],"scope":"Ward, site bed manager or coordinator; actingUnitId must equal admission.unitId. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Admission and a current blocker must exist","If reason supplied it must be listed; no default reason is invented"],"effects":["Clears the stay blocker","If a same-ward nondischarged release has the same blocker, clears its blocker/blockedBy and appends clearance history there; otherwise appends stayBlockClearances","Does not release the bed or change admission state"],"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":247,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":237,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1855,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-stay-discharge-blocker.test.ts"]},"reason":"Source-reviewed command model: Admission blockReason=null; clearance retained on matching pending release or admission."},{"event":"RECORD_OBSERVATION_LEVEL","roles":["ed","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":240},"sources":[{"path":"src/components/ward-management/ward-flow-observation-events.ts","line":33},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1900}],"status":"modelled","model":{"subject":"An open movement or occupied admission and its agreeing live counterpart","before":"Target has its recorded observation and retained change-count token","after":"Named target and any agreeing linked open counterpart carry the new observation and append from/to history","payload":["target is {kind:movement,movementId,actingUnitId?} or {kind:admission,admissionId,actingUnitId}","observation is a valid Observation; expected editing token required once the target has prior changes; role and now"],"scope":"EVENT_ROLE applies. Ward movement updates require its accepted ward; admission target requires its ward claim and refuses ED callers. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Valid observation; target exists; movement open or admission bed occupied","New value must differ; token must match and linked records must agree; missing token refused after first recorded change","Seeded links without matching observations stay unlinked rather than silently overwriting the other record","Accepted edits require a safe retained sequence allocator below Number.MAX_SAFE_INTEGER; exhaustion refuses before writing.","Accepted observation sequence is reducer-generated from retained movement/admission history, independent of the audit counter; restore permits missing legacy metadata or positive safe integers and refuses zero, fractions and unsafe values."],"effects":["Updates observation and appends {at,sequence,from,to} on each linked record","No new placement or capacity allocation; staffing eligibility remains a separate pull check","Accepted observation history entries also carry sequence=max(all retained movement/admission observation sequences,0)+1; an agreeing linked counterpart receives that same edit sequence. PATIENT_ARRIVED uses retained accepted order before legacy minute timestamps. Genuinely unordered legacy ties retain the previous fallback; no historical order is invented.","An accepted edit marks its audit decision accepted with no reason code."],"sources":[{"path":"src/components/ward-management/ward-flow-observation-events.ts","line":33,"sha256":"7e10fb51b2f76135bdfacbcd7643473e686dd0eb797e9e7906e427cdf26563cd"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":240,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-observation-events.ts","line":33,"sha256":"7e10fb51b2f76135bdfacbcd7643473e686dd0eb797e9e7906e427cdf26563cd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-observation.ts","line":48,"sha256":"b714525f0d4c6d18d050f9a3600f38c8de4e9a013595a77844c5c492fbdc2e3c"}],"tests":["tests/ward-observation-levels.test.ts","tests/ward-observation-expected-token.test.ts","tests/ward-audit-s2-observation-join.test.ts","tests/ward-consolidated-domain-20261104.test.ts"]},"reason":"Source-reviewed command model: Named target and any agreeing linked open counterpart carry the new observation and append from/to history."},{"event":"RECORD_MOVEMENT_BLOCKER","roles":["ed","community","ward","coordinator","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":280},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":710},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1874}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CLEAR_MOVEMENT_BLOCKER","roles":["ed","community","ward","coordinator","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":287},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2140}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"FLAG_MOVEMENT_TURNAROUND_PRIORITY","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":308},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2027}],"status":"modelled","model":{"subject":"A waiting movement’s receiving-unit preference","before":"Waiting unplaced movement with an open suitable ward request and current turnaround source","after":"Same movement carries {unitId,flaggedAt,source}; no bed is promised","payload":["movementId; unitId; optional source cld or departure; finite now; role"],"scope":"Coordinator only, within its shared authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Unit and target must exist; current source must be CLD-ready occupied criteria with feature enabled, or confirmed unblocked departure on an occupied stay","Clinical/legal gates must pass (allocation/freshness and the helper’s locked-bed security exception are separate); open request must match selected unit","Movement must be open, not arrived and unaccepted","Same unit/source preference already recorded is refused"],"effects":["Sets turnaroundPriority only; does not hold capacity, discharge anybody, accept a request or advance stage","Selectors later hide a preference whose original readiness source no longer qualifies"],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2017,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":308,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":692,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-turnaround-priority.ts","line":65,"sha256":"f4a062f776b7e676eb045bd32daf9aac4a636392dab5599a571687cbf47db4b8"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-cld-turnaround-priority.test.ts"]},"reason":"Source-reviewed command model: Same movement carries {unitId,flaggedAt,source}; no bed is promised."},{"event":"FLAG_REFERRAL_TURNAROUND_PRIORITY","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":309},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2028}],"status":"modelled","model":{"subject":"A waiting referral’s receiving-unit preference","before":"Waiting unplaced referral with an open suitable ward request and current turnaround source","after":"Same referral carries {unitId,flaggedAt,source}; no bed is promised","payload":["referralId; unitId; optional source cld or departure; finite now; role"],"scope":"Coordinator only, within its shared authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Unit and target must exist; current source must be CLD-ready occupied criteria with feature enabled, or confirmed unblocked departure on an occupied stay","Clinical/legal gates must pass (allocation/freshness and the helper’s locked-bed security exception are separate); open request must match selected unit","Referral must still be queued with an unwithdrawn ward request; no linked movement may exist","Same unit/source preference already recorded is refused"],"effects":["Sets turnaroundPriority only; does not hold capacity, discharge anybody, accept a request or advance stage","Selectors later hide a preference whose original readiness source no longer qualifies"],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2018,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":309,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":701,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-turnaround-priority.ts","line":65,"sha256":"f4a062f776b7e676eb045bd32daf9aac4a636392dab5599a571687cbf47db4b8"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-cld-turnaround-priority.test.ts"]},"reason":"Source-reviewed command model: Same referral carries {unitId,flaggedAt,source}; no bed is promised."},{"event":"MARK_REFERRAL_OPENED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":312},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1910},{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":17}],"status":"modelled","model":{"subject":"One addressed ward’s copy of a referral","before":"Ward copy exists without openedAt","after":"Same copy has openedAt=now; answer state unchanged","payload":["referralId; unitId; actingUnitId; role and now"],"scope":"Ward or coordinator; actingUnitId must equal unitId even for the coordinator. Named copy preferred, otherwise an unnamed ward copy. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Referral and an applicable ward copy must exist","Reject mismatched actingUnitId and a copy already stamped opened"],"effects":["Stamps openedAt once; does not answer, stop the decision clock or alter decidedAt"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":102,"sha256":"a7980fe9e58a4d1fcc774d48dfeb4e2673b66d0624fef24d00fae7b1fcf32039"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":312,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":716,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-referral-followup.test.ts"]},"reason":"Source-reviewed command model: Same copy has openedAt=now; answer state unchanged."},{"event":"REQUEST_REFERRAL_INFORMATION","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":313},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1911},{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":118}],"status":"modelled","model":{"subject":"One awaiting ward copy’s information checklist","before":"Ward copy queued and unwithdrawn","after":"New listed needs appended; existing open needs retained without duplication","payload":["referralId; unitId; needs is a nonempty list from REFERRAL_INFORMATION_NEEDS","actingUnitId optional in type but required for ward’s own-unit check; role and now"],"scope":"Ward for its own copy or coordinator; named copy preferred over unnamed. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Applicable ward copy must still await answer","Every need must be listed; at least one deduplicated need must not already be open"],"effects":["Appends {need,at,by} to informationNeeds; met historical needs can be requested again","No referral decision or decision-clock change"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":118,"sha256":"a7980fe9e58a4d1fcc774d48dfeb4e2673b66d0624fef24d00fae7b1fcf32039"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":313,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":729,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-referral-followup.test.ts"]},"reason":"Source-reviewed command model: New listed needs appended; existing open needs retained without duplication."},{"event":"MARK_REFERRAL_INFORMATION_MET","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":315},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1912},{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":55}],"status":"modelled","model":{"subject":"One information category requested by one or all current requesting wards","before":"At least one requested listed need remains unmet on a queued, unwithdrawn ward copy","after":"Selected open request(s) stamped metAt and metBy; checklist history retained","payload":["referralId; need from REFERRAL_INFORMATION_NEED_IDS","Exactly one target shape: wardUnitId string, or allRequestingWards:true; role and now"],"scope":"Sending ED/community/ward desk or coordinator. Ward requires referral.source=psychiatric_ward; shared boundary verifies the stored sender rather than destination ward identity. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Reject invalid/ambiguous target or off-list need","Named target requires awaiting copy and an unmet need; all-target needs at least one current matching request"],"effects":["Named target stamps its first unmet matching entry; all-target stamps matching unmet entries on every awaiting ward copy","Does not answer any ward or stop its decision clock"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":148,"sha256":"a7980fe9e58a4d1fcc774d48dfeb4e2673b66d0624fef24d00fae7b1fcf32039"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":315,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":740,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-referral-followup.test.ts","tests/ward-sender-information-supplied.test.ts"]},"reason":"Source-reviewed command model: Selected open request(s) stamped metAt and metBy; checklist history retained."},{"event":"ASSIGN_REFERRAL","roles":["coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":318},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1918},{"path":"src/components/ward-management/ward-flow-referral-owner-events.ts","line":21}],"status":"modelled","model":{"subject":"The desk chasing a front-door referral","before":"Referral not accepted or fully withdrawn; owner desk differs or is absent","after":"ownerHistory appended; its last owner is the current chasing desk","payload":["referralId; owner from REFERRAL_OWNER_DESKS; role and finite now"],"scope":"Coordinator may assign any listed owner desk; ED/community may take only for their own role. Not a lock on other permitted actions. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Referral must exist and not be accepted or fully withdrawn; the follow-up helper does not require a queued arm","Owner must be listed; reject another desk’s self-assignment and same current owner"],"effects":["Appends {owner,at,by}; destinations, answers and decision clock unchanged"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-owner-events.ts","line":44,"sha256":"13b724abff93f6ec86c6b232d9ea7f00e66609f8297122508a7976198f8ce19e"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":318,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":764,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/referrals/referral-owner-and-calls-model.ts","line":28,"sha256":"783d84f0aa1cc62b1f388bfabaa637c851ef47570a4ebfefc94406d550e4bde3"}],"tests":["tests/ward-referral-owner-and-calls.test.ts","tests/ward-referral-owner-and-calls-scope.test.ts"]},"reason":"Source-reviewed command model: ownerHistory appended; its last owner is the current chasing desk."},{"event":"LOG_REFERRAL_CONTACT","roles":["coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":319},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1919},{"path":"src/components/ward-management/ward-flow-referral-owner-events.ts","line":67}],"status":"modelled","model":{"subject":"A front-door referral’s call log","before":"Referral not accepted or fully withdrawn, with prior contact history or none","after":"New checked contact/outcome entry appended","payload":["referralId; contact is psychiatric_ward/unitId, community_team/teamId, or referrer","outcome from REFERRAL_CONTACT_OUTCOMES; role and finite now"],"scope":"Coordinator, ED or community, subject to record/place scope; contact names the called place, not acting authority. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Referral must exist and not be accepted or fully withdrawn; the follow-up helper does not require a queued arm","Contact kind and outcome must be listed; named ward/team must exist"],"effects":["Appends checked {contact,outcome,at,by}; drops unrecognised contact fields","A logged call does not decide referral or pause its decision clock"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-owner-events.ts","line":67,"sha256":"13b724abff93f6ec86c6b232d9ea7f00e66609f8297122508a7976198f8ce19e"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":319,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":779,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/referrals/referral-owner-and-calls-model.ts","line":28,"sha256":"783d84f0aa1cc62b1f388bfabaa637c851ef47570a4ebfefc94406d550e4bde3"}],"tests":["tests/ward-referral-owner-and-calls.test.ts"]},"reason":"Source-reviewed command model: New checked contact/outcome entry appended."},{"event":"RECORD_REFERRAL_COMMITMENT","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":321},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1926},{"path":"src/components/ward-management/ward-flow-referral-commitment-events.ts","line":24}],"status":"modelled","model":{"subject":"One awaiting ward copy’s response commitment","before":"Open referral awaiting this ward, commitment absent or not resolved","after":"Checked step/promise/callback entry appended without answering referral","payload":["referralId; unitId; actingUnitId for ward; role and finite now","step and/or nextCallbackAt required; promisedFor required only with step=promised","promisedFor and nextCallbackAt must be finite and at or after now"],"scope":"Coordinator records any listed step/callback; ward only its own acknowledged/promised step. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward and addressed, queued, unwithdrawn copy on open referral","Listed steps move forward; repeated response_requested and promised allowed; resolved blocks further entries","Ward cannot make callback-only entry; promise time refused on other steps"],"effects":["Appends commitment with unitId, at and desk label; keeps earlier entries","Does not change state, decidedAt, clocks or automatically call anyone"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-commitment-events.ts","line":24,"sha256":"a304422664462b4413fa82c9ae19d0425aef260d8ccf65239ca708d722b08994"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":321,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":796,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/referrals/referral-owner-and-calls-model.ts","line":28,"sha256":"783d84f0aa1cc62b1f388bfabaa637c851ef47570a4ebfefc94406d550e4bde3"},{"path":"src/components/ward-management/referrals/referral-commitments-model.ts","line":73,"sha256":"b8ad888efb64576aa225df86d86b58d9e31306fda7791fe9815a00a4c6c82325"}],"tests":["tests/ward-referral-commitments.test.ts"]},"reason":"Source-reviewed command model: Checked step/promise/callback entry appended without answering referral."},{"event":"ASK_MORE_WARDS","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":322},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1932},{"path":"src/components/ward-management/ward-flow-referral-ask-events.ts","line":24}],"status":"modelled","model":{"subject":"An open community referral’s addressed wards","before":"Open community referral has named ward request(s) with reusable bed requirements","after":"Additional named wards queued, preserving existing destinations","payload":["referralId; nonempty distinct unitIds named by coordinator; role and now"],"scope":"Coordinator only; no automatic ranking or suggestion. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Referral must be community source and not closed/withdrawn","Existing ward request must name a ward; any unnamed ward arm blocks expansion","Each new unit must exist, not have been asked before, be open and currently eligible","Awaiting existing wards plus additions must stay within parallelReferralCap"],"effects":["Copies original ward bed requirements into each new queued arm; stamps referredAt and addedBy","Does not answer existing arms, create a movement or reserve a bed"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-ask-events.ts","line":24,"sha256":"d3c249774b280ef5c1b57d1f4c7575d2dce9ef721ec1f85ed2ac2c53e7874d08"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":322,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-ask-events.ts","line":24,"sha256":"d3c249774b280ef5c1b57d1f4c7575d2dce9ef721ec1f85ed2ac2c53e7874d08"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/referrals/referral-owner-and-calls-model.ts","line":28,"sha256":"783d84f0aa1cc62b1f388bfabaa637c851ef47570a4ebfefc94406d550e4bde3"}],"tests":["tests/ward-referral-ask-more-wards.test.ts"]},"reason":"Source-reviewed command model: Additional named wards queued, preserving existing destinations."},{"event":"CLOSE_WARD_TO_ADMISSIONS","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":325},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1939},{"path":"src/components/ward-management/ward-flow-ward-closure-events.ts","line":17}],"status":"modelled","model":{"subject":"A ward’s admissions closure","before":"Known ward open to admissions","after":"isClosed=true with admissionsClosure reason/time/desk and optional expected reopening","payload":["unitId; reason from WARD_CLOSURE_REASONS; optional until","actingUnitId for ward; role and now"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Ward must exist and not already be closed","Listed reason; supplied until later than now and no farther than largest WARD_REOPEN_AFTER_HOURS choice"],"effects":["Writes closure record; existing holds/acceptances and bed figures remain","Eligibility/shortlists refuse new admissions; until is a prompt, never automatic reopening"],"sources":[{"path":"src/components/ward-management/ward-flow-ward-closure-events.ts","line":44,"sha256":"2fd18c518e21b86c1cda4b425c6cf5163251b409d3cddffd1f8a3b225f5142ef"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":325,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":815,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-closure.test.ts"]},"reason":"Source-reviewed command model: isClosed=true with admissionsClosure reason/time/desk and optional expected reopening."},{"event":"REOPEN_WARD_TO_ADMISSIONS","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":326},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1940},{"path":"src/components/ward-management/ward-flow-ward-closure-events.ts","line":72}],"status":"modelled","model":{"subject":"A ward’s admissions closure","before":"Known ward marked closed","after":"isClosed=false; admissionsClosure removed","payload":["unitId; actingUnitId for ward; role and now"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Ward must exist and be closed"],"effects":["Removes closure record rather than advancing any waiting move; changes no bed count","Reopening is a person’s action; old closure-linked review/transition records are no longer current"],"sources":[{"path":"src/components/ward-management/ward-flow-ward-closure-events.ts","line":72,"sha256":"2fd18c518e21b86c1cda4b425c6cf5163251b409d3cddffd1f8a3b225f5142ef"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":326,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":826,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-closure.test.ts","tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: isClosed=false; admissionsClosure removed."},{"event":"SET_BED_CLOSED","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":328},"sources":[{"path":"src/components/ward-management/ward-flow-bed-closure-events.ts","line":24},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1943}],"status":"modelled","model":{"subject":"One exact numbered bed’s closure mark","before":"Empty offerable bed is open, or numbered bed has active closed mark","after":"closed=true appends a mark; closed=false stamps active mark reopenedAt","payload":["unitId; actingUnitId; integer bedNumber within 1..unit.beds; closed boolean","Optional listed reason when closing; no reason when reopening; role and now"],"scope":"Ward, site bed manager or coordinator; actingUnitId must equal unitId. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Closing rejects already-closed, occupied/replayed seat, pulled/held bed, or no Ready capacity","Reopening requires an active mark and refuses any supplied reason"],"effects":["Records exact numbered mark and retains reopening history; does not rewrite allocatable confirmation","Derived Ready excludes active closed marks and recovers after reopen; existing stay seating retained"],"sources":[{"path":"src/components/ward-management/ward-flow-bed-closure-events.ts","line":56,"sha256":"e19afdf5df97f09582af829f62e2ff463cbf9ef8ba8e2b873e79ea7e7931497f"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":328,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":834,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-bed-closed-mark.test.ts","tests/ward-bed-closed-mark-kinds.test.ts"]},"reason":"Source-reviewed command model: closed=true appends a mark; closed=false stamps active mark reopenedAt."},{"event":"RECORD_BED_MEETING_ACTION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":333},"sources":[{"path":"src/components/ward-management/ward-flow-bed-meeting-events.ts","line":30},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1977}],"status":"modelled","model":{"subject":"A movement or admission’s agreed meeting task","before":"Subject exists and has no open action of this kind","after":"meetingActions appended with chosen task, owner and due time","payload":["subject {kind:movement|admission,id}; action from BED_MEETING_ACTION_KINDS","owner from BED_MEETING_ACTION_OWNERS; known unitId required for ward owner; dueAt later than now; role and now"],"scope":"Coordinator chair only; owner names a role, not a person. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Subject exists; action/owner listed; ward owner must name known ward","Reject dueAt not later than now or an existing open same-kind action"],"effects":["Appends task with recordedAt; does not change patient stage, occupancy or placement","No automatic execution when due","Before a new occurrence reuses its stable meeting inbox id, append returned snooze and released ownership boundaries where prior histories exist. Even a same-minute replacement starts without the preceding occurrence owner/snooze; histories are retained and the new occurrence may be claimed/snoozed again."],"sources":[{"path":"src/components/ward-management/ward-flow-bed-meeting-events.ts","line":61,"sha256":"b28604a0b11e841e1daf151279719831992a89765e8553a84974993d57ed5e2c"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":333,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":850,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-bed-meeting-actions.test.ts","tests/ward-consolidated-meeting-counts-20261104.test.ts"]},"reason":"Source-reviewed command model: meetingActions appended with chosen task, owner and due time."},{"event":"COMPLETE_BED_MEETING_ACTION","roles":["coordinator","ward","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":334},"sources":[{"path":"src/components/ward-management/ward-flow-bed-meeting-events.ts","line":105},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1978}],"status":"modelled","model":{"subject":"An open task on a movement or admission","before":"Chosen subject carries an open action of this kind","after":"Same action stamped doneAt and doneBy","payload":["subject {kind:movement|admission,id}; listed action; actingUnitId for ward owner; role and now"],"scope":"Coordinator or owning ward/ED/community role; ward must match ownerUnitId. Site bed manager denied by EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Subject and open listed action must exist","Caller must be coordinator or correct owning role/place"],"effects":["Retains task and stamps completion; does not enact the action or change subject’s stage"],"sources":[{"path":"src/components/ward-management/ward-flow-bed-meeting-events.ts","line":105,"sha256":"b28604a0b11e841e1daf151279719831992a89765e8553a84974993d57ed5e2c"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":334,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":865,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-bed-meeting-actions.test.ts","tests/ward-bed-manager-actions.test.ts","tests/ward-consolidated-meeting-counts-20261104.test.ts"]},"reason":"Source-reviewed command model: Same action stamped doneAt and doneBy."},{"event":"RECORD_RESTRICTIVE_PRACTICE_START","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":338},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1950},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":61}],"status":"modelled","model":{"subject":"A ward’s operational restrictive-practice episodes","before":"Occupied stay on this ward with no open same-practice episode","after":"New episode with typed start and recording metadata appended","payload":["unitId; admissionId; practice from RESTRICTIVE_PRACTICE_IDS; startedAt","actingUnitId for ward; role and now; typed time finite and within last 24h, not future"],"scope":"Ward for itself or coordinator; site bed manager cannot record episodes. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward, occupied admission belonging to it, listed practice","Reject invalid typed time and duplicate open practice for same stay"],"effects":["Appends Unit.restrictivePractice.episodes with generated id, startedAt, recordedAt and desk label","No legal limit or order computed; no occupancy change; separate departure guards require open episodes ended"],"sources":[{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":61,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":338,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/restrictive-practice/ward-restrictive-practice.ts","line":136,"sha256":"c605b305700a3df7cb0e8f7f1f923ac844971e33743d4227b677773e9ec056aa"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-restrictive-practice.test.ts","tests/ward-audit-s3-restrictive-practice-departure.test.ts"]},"reason":"Source-reviewed command model: New episode with typed start and recording metadata appended."},{"event":"RECORD_RESTRICTIVE_PRACTICE_END","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":339},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1951},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":95}],"status":"modelled","model":{"subject":"One ward’s open restrictive-practice episode","before":"Episode exists without endedAt","after":"Same episode stamped with typed endedAt","payload":["unitId; episodeId; endedAt; actingUnitId for ward; role and now","endedAt finite, within last 24h, not future or before startedAt"],"scope":"Ward for itself or coordinator; site bed manager cannot end episodes. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward and open episode","Reject invalid/before-start typed time or already-ended episode; current admission occupancy is not required"],"effects":["Sets endedAt on episode and retains its start/recording metadata","No patient transfer, bed move or legal decision performed"],"sources":[{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":95,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":339,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/restrictive-practice/ward-restrictive-practice.ts","line":147,"sha256":"c605b305700a3df7cb0e8f7f1f923ac844971e33743d4227b677773e9ec056aa"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-restrictive-practice.test.ts"]},"reason":"Source-reviewed command model: Same episode stamped with typed endedAt."},{"event":"RECORD_RESTRICTIVE_PRACTICE_FOLLOW_UP","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":341},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1952},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":109}],"status":"modelled","model":{"subject":"One restrictive-practice episode on a ward","before":"Episode ended, with its follow-up tasks marked so far","after":"The chosen follow-up task marked done or cleared","payload":["unitId; episodeId; task from RESTRICTIVE_PRACTICE_FOLLOW_UP_TASKS; done (boolean); now; role."],"scope":"ward or coordinator in the role table; authenticated reference scope applies.","guards":["The episode exists on the ward.","The episode has an end time recorded.","task is a listed follow-up task and done is a boolean."],"effects":["Sets or removes the task in the episode's followUp; an empty followUp is removed."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1942,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":109,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"}],"tests":["tests/ward-legal-form-gap-items.test.ts"]},"reason":"Reviewed command model: marks or clears one follow-up task on an ended restrictive-practice episode."},{"event":"RECORD_WARD_INCIDENT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":342},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1953},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":131}],"status":"modelled","model":{"subject":"A ward’s operational incident list","before":"Known ward with existing or empty incident history","after":"New category/time incident appended","payload":["unitId; category from WARD_INCIDENT_CATEGORY_IDS; at finite within last24h and not future","actingUnitId for ward; role and now; no patient id or narrative"],"scope":"Ward for itself or coordinator; site bed manager cannot record incidents. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward, listed category and valid typed time"],"effects":["Appends ward incident id/category/at/recordedAt/recordedBy","No patient, bed, stay or legal record changes; detailed incident report remains outside this app"],"sources":[{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":131,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":342,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/restrictive-practice/ward-restrictive-practice.ts","line":160,"sha256":"c605b305700a3df7cb0e8f7f1f923ac844971e33743d4227b677773e9ec056aa"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-restrictive-practice.test.ts"]},"reason":"Source-reviewed command model: New category/time incident appended."},{"event":"SET_SECLUSION_ROOM_STATUS","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":343},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1954},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":152}],"status":"modelled","model":{"subject":"A ward’s recorded seclusion-room availability","before":"Room status absent or different","after":"seclusionRoom replaced with status, time and desk label","payload":["unitId; status from SECLUSION_ROOM_STATUS_IDS; actingUnitId for ward; role and now"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward; listed status; repeat identical status refused"],"effects":["Writes only Unit.restrictivePractice.seclusionRoom","Does not start/end an episode or alter beds; selectors show an open seclusion episode as in use over the recorded availability"],"sources":[{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":152,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":343,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/restrictive-practice/ward-restrictive-practice.ts","line":184,"sha256":"c605b305700a3df7cb0e8f7f1f923ac844971e33743d4227b677773e9ec056aa"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-restrictive-practice.test.ts"]},"reason":"Source-reviewed command model: seclusionRoom replaced with status, time and desk label."},{"event":"MARK_CANCELLED_MOVE_CHECK","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":347},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":58},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1965}],"status":"modelled","model":{"subject":"A cancelled move’s follow-up checklist","before":"Move is cancelled, with prior mark or no mark for selected item","after":"Selected item’s mark replaced with addressed/not_applicable and time/desk","payload":["movementId; item from CANCELLED_MOVE_CHECK_ITEMS; mark from CANCELLED_MOVE_CHECK_MARKS","actingUnitId for ward; role and now"],"scope":"Coordinator or ward that accepted this move. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Movement exists and is cancelled; item/mark listed","Cannot mark pulled_bed addressed while cancelled move still holds a bed"],"effects":["Keeps one current mark per item; does not release beds, cancel transport or change movement stage"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":58,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":347,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":225,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: Selected item’s mark replaced with addressed/not_applicable and time/desk."},{"event":"RECORD_ACCEPTANCE_CONDITION","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":348},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":79},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1966}],"status":"modelled","model":{"subject":"A standing acceptance’s operational conditions","before":"Open accepted move without this current condition","after":"New condition appended tied to acceptedUnitId and acceptedAt","payload":["movementId; condition from ACCEPTANCE_CONDITION_KINDS; agreedWith from its list","readyAt required only for bed_after_time: later than now and within largest ACCEPTANCE_BED_AFTER_HOURS choice","actingUnitId for ward; role and now"],"scope":"Coordinator or the accepting ward. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Movement must exist, be open and accepted","Reject duplicate current condition, off-list values, missing/out-of-range bed-after time or time on another condition"],"effects":["Appends condition and agreement provenance; does not hold a bed, change stage or modify eligibility","Times prompt review; no automatic condition completion"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":79,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":348,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":239,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: New condition appended tied to acceptedUnitId and acceptedAt."},{"event":"MARK_ACCEPTANCE_CONDITION_MET","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":349},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":80},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1967}],"status":"modelled","model":{"subject":"A current acceptance’s unmet condition","before":"Open accepted move has this current condition not met","after":"Condition retained with met {at,by}","payload":["movementId; listed condition; actingUnitId for ward; role and now"],"scope":"Coordinator or the accepting ward. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Movement open and accepted; selected current condition exists and is not already met"],"effects":["Stamps met on that exact condition; leaves stage, placement, capacity and acceptance unchanged"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":80,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":349,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":250,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: Condition retained with met {at,by}."},{"event":"RECORD_RESTRICTION_REVIEW","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":350},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":139},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1968}],"status":"modelled","model":{"subject":"A ward’s active restriction review reminder","before":"Restriction currently active, with prior review or none","after":"One current review for restriction recorded/replaced","payload":["unitId; restriction from WARD_RESTRICTION_KINDS; reviewer from RESTRICTION_REVIEWER_ROLES","expectedAt later than now and within largest RESTRICTION_REVIEW_AFTER_HOURS choice; actingUnitId for ward; role and now"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Ward exists and named restriction is currently active; listed restriction/reviewer","Review time must be later than now and bounded by listed choices"],"effects":["Replaces review for same restriction, preserving others; closure review captures closure.startedAt","Does not lift restriction or reopen ward when time passes"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":139,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":350,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":262,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: One current review for restriction recorded/replaced."},{"event":"MARK_CLOSURE_TRANSITION_ITEM","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":351},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":169},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1969}],"status":"modelled","model":{"subject":"A closed ward’s current handover checklist","before":"Ward has admissionsClosure and selected still-pointing record is unmarked","after":"Closure transitionMarks appended with current derived item and recording metadata","payload":["unitId; item from CLOSURE_TRANSITION_ITEM_KINDS; actingUnitId for ward; role and now","Record id: referralId for referral, plannedAdmissionId for booked_arrival, movementId for other listed item kinds"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Ward must exist, be closed and carry admissionsClosure","Item must still point at the ward according to closureTransitionItems and must not already be marked"],"effects":["Appends derived item with at/by to current closure; does not move, cancel, reassign or release the underlying record"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":169,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":351,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":276,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: Closure transitionMarks appended with current derived item and recording metadata."},{"event":"FLAG_MOVEMENT_URGENT","roles":["coordinator","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":352},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2080}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CLEAR_MOVEMENT_URGENT_FLAG","roles":["coordinator","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":353},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2104}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"WITHDRAW_REFERRAL","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":373},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1856},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":883}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REQUEST_CAPACITY_REFRESH","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":376},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":684},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1783}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECEIVE_REFERRAL","roles":["community","ed","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":391},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1904},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":362}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ADD_PATIENT","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":395},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1792},{"path":"src/components/ward-management/ward-patient-registration-reducer.ts","line":39}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ARCHIVE_PATIENT","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":397},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1794},{"path":"src/components/ward-management/ward-patient-archive-reducer.ts","line":10}],"status":"modelled","model":{"subject":"An erroneous standalone patient registration","before":"Patient has only registration fields and no care records/references elsewhere","after":"Patient removed from active patients list; audit event and sequence retained","payload":["patientId; reason from PATIENT_ARCHIVE_REASONS (duplicate, test, wrong_person); role and now"],"scope":"Coordinator only, with shared record scope applied. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; listed archive reason","Registration facts include the optional typed details (preferred name, address, GP, catchment team, interpreter language, Indigenous status, and the ADMIN_DETAIL_FIELDS administrative details); refuse any non-registration fact or any state/audit care reference; prior archive-attempt audit entries do not block"],"effects":["Filters patient from patients; keeps sequence so id is not reused","Reducer audit wrapper retains the archive event/reason; no care record is removed","The step can be taken back by UNDO_PATIENT_RECORD within the Undo window."],"sources":[{"path":"src/components/ward-management/ward-patient-archive-reducer.ts","line":10,"sha256":"bfd91bd2e7955ee0c776cf1c8e5fb3ecb1dd76d2cd0d2c9a71a9789270b95898"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":397,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-archive.ts","line":30,"sha256":"2738c8d1a80a5d8fc418865719058ee2603141bb9493d55954cae83742455eb3"},{"path":"src/components/ward-management/ward-patient-archive.ts","line":44,"sha256":"2738c8d1a80a5d8fc418865719058ee2603141bb9493d55954cae83742455eb3"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-patient-archive.test.ts"]},"reason":"Source-reviewed command model: Patient removed from active patients list; audit event and sequence retained."},{"event":"ACCEPT_REFERRAL","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":427},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":873},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":728}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"HOLD_REFERRAL_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":428},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1906},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":695}],"status":"modelled","model":{"subject":"An accepted ward arm’s exact numbered bed hold","before":"Current accepted, unwithdrawn ward arm without started bed journey; old numbered hold may exist","after":"Same arm carries chosen heldBedNumber","payload":["referralId; unitId; actingUnitId; bedNumber; role and now"],"scope":"Ward for its own beds or coordinator; shared place/record boundary also applies. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known referral and currently accepted arm for unit; no linked movement or pulled/occupied/departed referral stay","Ward open; numbered bed valid, free, unheld and of required kind","Recheck current suitability using only override already recorded at acceptance"],"effects":["Sets/reassigns arm.heldBedNumber; retains acceptance author/time and referral state","Does not mint movement/admission or overwrite allocatable confirmation; hold is considered by bed availability checks"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":680,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":428,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1538,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-review-engine-regressions.test.ts","tests/ward-override-surfaces.test.ts"]},"reason":"Source-reviewed command model: Same arm carries chosen heldBedNumber."},{"event":"DECLINE_REFERRAL","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":439},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1907},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1148}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LOCAL_BED_SOUGHT","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":445},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1045},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1884}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_REFERRER_WITHDRAWAL","roles":["coordinator","community","ed","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":477},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":801},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1883}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ADD_REFERRAL_CORRECTION","roles":["community","ed","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":484},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1858},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1124}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"STEP_BACK_STAGE","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":491},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":751},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1993}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"WITHDRAW_ACCEPTANCE","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":492},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1908},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1308}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"WITHDRAW_WARD_REQUEST","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":495},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1857},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1069}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"MARK_NOTICE_READ","roles":["coordinator","ed","ward","officer","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":505},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2189},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":290}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ACKNOWLEDGE_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":526},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2190},{"path":"src/components/ward-management/ward-inbox-events.ts","line":41},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":312}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"COMPLETE_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":527},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2191},{"path":"src/components/ward-management/ward-inbox-events.ts","line":71},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":349}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REOPEN_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":528},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2192},{"path":"src/components/ward-management/ward-inbox-events.ts","line":99},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":384}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"TAKE_INBOX_ITEM_OWNERSHIP","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":530},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2193},{"path":"src/components/ward-management/ward-inbox-events.ts","line":111},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":402}],"status":"modelled","model":{"subject":"A coordinator inbox row and its occurrence-specific history","before":"Real current inbox row not already owned by this desk","after":"Ownership history appended; current owner is acting role’s label","payload":["inboxItemId trimmed before lookup; role and now"],"scope":"Coordinator role only; shared authenticated scope must also permit the row’s subject. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. Scoped state projection retains this metadata for permitted meeting-action subjects by parsing the encoded subject id; metadata for other subjects stays excluded.","guards":["Row must exist; same current owner for this occurrence refused"],"effects":["Appends {at,by} to inboxOwnership; underlying row/fact and its visibility unchanged"],"sources":[{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":402,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":530,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-events.ts","line":111,"sha256":"c3c63fd47887f9bbabdefc8aa6b6742f72848bc9f744afa55b2aa7efd80f037c"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-inbox-snooze.ts","line":84,"sha256":"eda403a5e8fbf768036d873898501882422dad29ebc3c7362c7766a10daaf1dd"}],"tests":["tests/ward-inbox-snooze.test.ts","tests/ward-consolidated-census-20261104.test.ts"]},"reason":"Source-reviewed command model: Ownership history appended; current owner is acting role’s label."},{"event":"RELEASE_INBOX_ITEM_OWNERSHIP","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":531},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2194},{"path":"src/components/ward-management/ward-inbox-events.ts","line":121},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":422}],"status":"modelled","model":{"subject":"A coordinator inbox row and its occurrence-specific history","before":"Ownership history’s current entry belongs to acting role, applying a current-row start when available","after":"Ownership history appended with kind=released; ownership relinquished","payload":["inboxItemId trimmed before lookup; role and now"],"scope":"Coordinator role only; shared authenticated scope must also permit the row’s subject. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. Scoped state projection retains this metadata for permitted meeting-action subjects by parsing the encoded subject id; metadata for other subjects stays excluded.","guards":["Current owner must match acting role after filtering entries older than the row’s current occurrence, if a start is available; this branch does not independently require row existence"],"effects":["Appends released history entry; does not delete prior ownership, resolve fact or hide row"],"sources":[{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":422,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":531,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-events.ts","line":121,"sha256":"c3c63fd47887f9bbabdefc8aa6b6742f72848bc9f744afa55b2aa7efd80f037c"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-inbox-snooze.ts","line":84,"sha256":"eda403a5e8fbf768036d873898501882422dad29ebc3c7362c7766a10daaf1dd"}],"tests":["tests/ward-inbox-snooze.test.ts","tests/ward-alerts-release-ownership.dom.test.tsx","tests/ward-consolidated-census-20261104.test.ts"]},"reason":"Source-reviewed command model: Ownership history appended with kind=released; ownership relinquished."},{"event":"SNOOZE_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":532},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2195},{"path":"src/components/ward-management/ward-inbox-events.ts","line":133},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":435}],"status":"modelled","model":{"subject":"A coordinator inbox row and its occurrence-specific history","before":"Real current inbox row visible or previously snoozed","after":"Latest snoozed entry hides row until chosen return time while fact remains","payload":["inboxItemId; reason from SNOOZE_REASON_IDS; finite until after now; role and now"],"scope":"Coordinator role only; shared authenticated scope must also permit the row’s subject. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. Scoped state projection retains this metadata for permitted meeting-action subjects by parsing the encoded subject id; metadata for other subjects stays excluded.","guards":["Real row and listed reason","until within SNOOZE_MAX_MINUTES (currently24h); act-now row limited by RED_ROW_SNOOZE_CAP_MINUTES (currently60min)"],"effects":["Appends {kind:snoozed,at,by,until,reason}; no mutation of underlying patient/unit fact","Current-occurrence selectors return row when until passes or a newer occurrence starts"],"sources":[{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":435,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":532,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-events.ts","line":133,"sha256":"c3c63fd47887f9bbabdefc8aa6b6742f72848bc9f744afa55b2aa7efd80f037c"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-inbox-snooze.ts","line":84,"sha256":"eda403a5e8fbf768036d873898501882422dad29ebc3c7362c7766a10daaf1dd"}],"tests":["tests/ward-inbox-snooze.test.ts","tests/ward-consolidated-census-20261104.test.ts"]},"reason":"Source-reviewed command model: Latest snoozed entry hides row until chosen return time while fact remains."},{"event":"UNSNOOZE_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":533},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2196},{"path":"src/components/ward-management/ward-inbox-events.ts","line":142},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":469}],"status":"modelled","model":{"subject":"A coordinator inbox row and its occurrence-specific history","before":"History has an active snooze, applying a current-row start when available","after":"Snooze history appended with kind=returned; active snooze ends now","payload":["inboxItemId trimmed before lookup; role and now"],"scope":"Coordinator role only; shared authenticated scope must also permit the row’s subject. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. Scoped state projection retains this metadata for permitted meeting-action subjects by parsing the encoded subject id; metadata for other subjects stays excluded.","guards":["Active snooze must exist after occurrence filtering; expired or older-occurrence entry refused; this branch does not independently require row existence"],"effects":["Appends returned entry, retaining earlier history; an underlying row, if still present, returns to the active list without resolving its fact"],"sources":[{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":469,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":533,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-events.ts","line":142,"sha256":"c3c63fd47887f9bbabdefc8aa6b6742f72848bc9f744afa55b2aa7efd80f037c"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-inbox-snooze.ts","line":84,"sha256":"eda403a5e8fbf768036d873898501882422dad29ebc3c7362c7766a10daaf1dd"}],"tests":["tests/ward-inbox-snooze.test.ts","tests/ward-consolidated-census-20261104.test.ts"]},"reason":"Source-reviewed command model: Snooze history appended with kind=returned; active snooze ends now."},{"event":"SET_ARRIVAL_DETAILS","roles":["coordinator","ed","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":534},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2005},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1170}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_STEP_DOWN_CANDIDATE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":535},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":704},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1784}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_WARD_DIAGNOSIS","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":537},"sources":[{"path":"src/components/ward-management/ward-flow-diagnosis-events.ts","line":14},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2358}],"status":"modelled","model":{"subject":"One current admission","before":"No ward diagnosis, or a different ward diagnosis block","after":"Latest ward diagnosis block with recording time and desk","payload":["admissionId; block from TentativeDiagnosisBlock; now and role; actingUnitId when acting as ward."],"scope":"ward or coordinator. A ward must name the admission's own unit; authenticated scoped access must also permit the admission.","guards":["Admission exists and is not departed.","Block is listed and differs from the current ward block."],"effects":["Replaces admission.wardDiagnosis only; does not overwrite the referrer's tentativeDiagnosis or move a bed."],"sources":[{"path":"src/components/ward-management/ward-flow-diagnosis-events.ts","line":29,"sha256":"c0c3188726823be6157098eb593cf59300372f9328512b293328cd76d8a16e4a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":537,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-ward-diagnosis.test.ts"]},"reason":"Reviewed command model: Latest ward diagnosis block with recording time and desk."},{"event":"MARK_WEEKEND_DISCHARGE_REVIEWED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":539},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2360},{"path":"src/components/ward-management/ward-flow-weekend-review-events.ts","line":15}],"status":"modelled","model":{"subject":"One current inpatient admission","before":"No review tick for this weekend","after":"Weekend discharge review tick with weekend, time and desk","payload":["admissionId; weekendStart instant; now and role; actingUnitId when acting as ward."],"scope":"ward or coordinator. A ward must name the admission's own unit; authenticated scoped access must also permit the admission.","guards":["Admission exists and is pulled or occupied.","Weekend is within a week of now and not already ticked."],"effects":["Appends to admission.weekendDischargeReviews only; changes no date, bed or plan."],"sources":[{"path":"src/components/ward-management/ward-flow-weekend-review-events.ts","line":23,"sha256":"1360db583261541d85f5978b485e46777413053f2ab988012b22b8aac4280ab2"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":539,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-weekend-discharge-review.test.ts"]},"reason":"Reviewed command model: Weekend discharge review tick with weekend, time and desk."},{"event":"SET_DISCHARGE_BARRIER","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":540},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":727},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1785}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_CLINICALLY_READY","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":542},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":757},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1786}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_DISCHARGE_CRITERIA","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":543},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":800},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1787}],"status":"modelled","model":{"subject":"An occupied admission's criteria-led discharge record","before":"Unset, current, paused or lapsed criteria","after":"Criteria set/reviewed, cleared, or one stored criterion ticked/unticked","payload":["admissionId; criteria string[] or null; met string[]; setByTreatingPsychiatrist boolean; optional patientSpecific string[] or tick {criterion,met}; actingUnitId for ward; finite now."],"scope":"ward or coordinator, with ward actingUnitId equal to the stay's unit and authenticated admission scope.","guards":["Admission must be occupied and time finite.","For setting or ticking criteria, only recorded voluntary patients are eligible; involuntary, CTO and unknown legal status refuse. criteria:null clears before this eligibility check.","Setting/changing the list needs the treating-psychiatrist flag; an ordinary tick keeps the stored list and refuses a lapsed review. Clearing with criteria:null does not require that flag.","Listed criteria must be unique and valid; patient-specific items obey count/length/trim bounds; ticks must name stored criteria."],"effects":["Writes admission.dischargeCriteria; review resets its validity time and review-bound/lapsed ticks, while retained applicable ticks persist.","No departure, bed release or clinical eligibility decision is performed; typed patient-specific payloads follow the typed-text persistence boundary."],"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":753,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-discharge-criteria.ts","line":271,"sha256":"70e720fb09a6a8bd9ab6952b29e786e949b7c635b3eded6a97c9be8582648c5b"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2114,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-criteria-led-discharge.test.ts"]},"reason":"Reviewed command model: Criteria set/reviewed, cleared, or one stored criterion ticked/unticked."},{"event":"RECORD_ED_MEDICAL_DETERIORATION","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":544},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1165},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1887}],"status":"modelled","model":{"subject":"An accepted originating-ED movement before collection","before":"Accepted/pulled pre-transfer placement with optional live transport","after":"placement_requested, medically uncleared and explicitly paused; acceptance and reservation removed","payload":["movementId; actingPlaceId naming the originating ED; finite now not before movement.openedAt; role."],"scope":"ed or coordinator; actingPlaceId must equal movement.originEdId even for coordinator. A source-admission transfer cannot use this path; authenticated movement/place scope also applies.","guards":["Movement exists, has an accepted psychiatric destination and is not closed, moving or already collected.","An unrecovered deterioration already recorded refuses; any held admission must be a consistent pulled reservation."],"effects":["Releases pulled bed/admission and matching referral bed hold; clears acceptance, pull timer, admission linkage and ward request lists.","Cancels live transport, records withdrawal/release/cancellation unwind history, false medical clearance and deterioration stamp.","Copies negative clearance to the identity-matching referral and appends an acceptance-withdrawn notice to the former ward. A later re-clearance does not reallocate a bed."],"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1165,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2134,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-medical-deterioration-ui.dom.test.tsx","tests/ward-reservation-release-capacity.test.ts"]},"reason":"Reviewed command model: placement_requested, medically uncleared and explicitly paused; acceptance and reservation removed."},{"event":"RECORD_MOVEMENT_MEDICAL_CLEARANCE","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":545},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1271},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1888}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"UPLOAD_PATIENT_FORM","roles":["coordinator","ed","ward","community","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":546},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":818},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1788}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_WRITTEN","roles":["ed","coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":548},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1360},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":275},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1889}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_CODE","roles":["ed","coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":550},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1361},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":274},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1890}],"status":"modelled","model":{"subject":"A movement's current legal-form record","before":"Current form, or no form recorded","after":"Chosen form code without an invented written time","payload":["movementId; recognised formCode; now; role. No writtenAt, region, ageBand or paperExpiresAt is carried by this command."],"scope":"ed, coordinator or ward. Ward requires an admitted stay in its own scoped unit; ED cannot amend a closed movement. An admitted ward/coordinator may record a later form despite arrival closure.","guards":["Movement exists; ward has an admitted stay.","Form code is recognised, differs from the current code, and is not 3C after 3D.","A closed record refuses except admitted non-ED recording."],"effects":["Replaces legalForm code/kind with its retained form history, removes formedAt, prior paper expiry/receipt for a different form and legacy legalClock.","Does not calculate legal expiry or default the written time. Undo is part of UNDO_LEGAL_FORM_RECORD.","A new form code also clears the typed receipt mark and any paper details typed for the old form."],"sources":[{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":274,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2168,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":832,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-ed-handover-events.test.ts"]},"reason":"Reviewed command model: Chosen form code without an invented written time."},{"event":"RECORD_ED_PRESENTATION","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":552},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1362},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":205},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1891}],"status":"modelled","model":{"subject":"An open movement's ED presentation choices","before":"Recorded ED presentation list or none","after":"Canonical fixed-list choices, or field removed for an empty selection","payload":["movementId; presentations array of EdPresentation choices; now; role."],"scope":"ed or coordinator, additionally subject to authenticated movement/place scope.","guards":["Movement exists and has no closure.","presentations must be an array and every item must be in the fixed ED list."],"effects":["Filters choices into canonical list order, deduplicating them; empty choice removes edPresentations.","Does not change movement stage, diagnosis, legal status or capacity. Included in ED-step Undo."],"sources":[{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":205,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2194,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-undo.ts","line":92,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-ed-handover-events.test.ts"]},"reason":"Reviewed command model: Canonical fixed-list choices, or field removed for an empty selection."},{"event":"RECORD_LEGAL_FORM_DETAILS","roles":["ed","coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":554},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1363},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":222},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1892}],"status":"modelled","model":{"subject":"The current legal form on one movement","before":"Form recorded, details as last typed","after":"Form carries the typed maker, copy given, ending, consent and review-by values","payload":["movementId; formCode; optional madeBy, copyGiven, endedBy, consent, reviewBy (omitted keeps, null clears); now; role."],"scope":"ed, coordinator or ward in the role table; a ward only for a person admitted to its own bed.","guards":["The movement exists; a closed movement only when admitted and not ED.","formCode matches the movement's current form.","Each detail is from its list; reviewBy is a finite time; consent only for a Form 6B."],"effects":["Replaces the form's details with the merged values; other form fields are unchanged."],"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":96,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":222,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}],"tests":["tests/ward-legal-form-gap-items.test.ts"]},"reason":"Reviewed command model: records the written legal form's typed details on the movement's current form."},{"event":"RECORD_COUNTRY_EXTENSION","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":555},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1364},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":382},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1893}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_CONTINUATION","roles":["ed","coordinator","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":556},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1365},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":415},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1894}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"EVALUATE_ARRIVAL_LATENESS","roles":["coordinator","ed","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":557},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2006},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1260}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RELEASE_AND_REOPEN_SEARCH","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":558},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":813},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1994}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CLEAR_EXPECT_FLAG","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":559},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2202}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REQUEST_PSYCH_REVIEW","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":561},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2216},{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":16}],"status":"modelled","model":{"subject":"One open movement","before":"No psychReview recorded","after":"psychReview.requestedAt = now","payload":["movementId","role and now"],"scope":"ED or coordinator (EVENT_ROLE); shared command scope checks the movement as for other movement commands.","guards":["Movement must exist and not be closed","Refused when a review is already asked for"],"effects":["Writes psychReview.requestedAt only; the ED Awaiting review list keeps its order","Undone by UNDO_ED_STEP"],"sources":[{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":61,"sha256":"c8c07485713088517586cb0556d07e0a8ac812413934ba064f12d412b00936f4"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2213,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":561,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-psych-review-ready-next.test.ts","tests/ward-event-permissions.test.ts"]},"reason":"Reviewed command model (9 Nov 2026): the emergency department records that a psychiatric review was asked for; a time only, nothing ordered or scored."},{"event":"RECORD_PSYCH_REVIEW_SEEN","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":562},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2217},{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":23}],"status":"modelled","model":{"subject":"One open movement with a review asked for","before":"psychReview without the named grade seen","after":"psychReview.registrarSeenAt or consultantSeenAt = now","payload":["movementId; grade registrar or consultant","role and now"],"scope":"ED or coordinator (EVENT_ROLE); shared command scope checks the movement.","guards":["Movement must exist and not be closed","Grade from PSYCH_REVIEW_GRADES","A review must have been asked for; each grade recorded once"],"effects":["Writes the seen time only; no examination, placement or order follows","Undone by UNDO_ED_STEP"],"sources":[{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":69,"sha256":"c8c07485713088517586cb0556d07e0a8ac812413934ba064f12d412b00936f4"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2214,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":562,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-psych-review-ready-next.test.ts","tests/ward-event-permissions.test.ts"]},"reason":"Reviewed command model (9 Nov 2026): records that the registrar or consultant saw the person for the review asked for; a time only."},{"event":"MARK_WARD_READY_FOR_NEXT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":563},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2218},{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":31}],"status":"modelled","model":{"subject":"One ward","before":"readyForNextAt absent (or present, for cancel)","after":"Unit.readyForNextAt = now, or removed on cancel","payload":["unitId; optional cancel","actingUnitId for ward; role and now"],"scope":"Ward for itself or coordinator (EVENT_ROLE); shared command scope checks the unit.","guards":["Ward acts only for itself","Unit must exist","Mark refused when closed to admissions or already marked; cancel refused when not marked"],"effects":["Coordinator Home shows the ward and the first on its wait list as a fact; nothing is pulled","A PULL_PATIENT into the ward clears the mark"],"sources":[{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":84,"sha256":"c8c07485713088517586cb0556d07e0a8ac812413934ba064f12d412b00936f4"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2215,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":563,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-psych-review-ready-next.test.ts","tests/ward-event-permissions.test.ts"]},"reason":"Reviewed command model (9 Nov 2026): a ward says it is ready for its next patient, or cancels that; a fact for the coordinator, who still pulls by hand."},{"event":"RAISE_EXPECT_FLAG","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":564},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2227}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"FLAG_LEGAL_MISMATCH","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":565},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2249}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"EVALUATE_LEAVE_BED_WARNINGS","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":566},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":862},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1789}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CONFIRM_MORNING_ROLLUP","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":567},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2272}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SEND_WARD_BUZZ","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":568},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2303}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_REPATRIATION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":570},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1351},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":478},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1896}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_HOME_SERVICE_RETURN","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":572},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2365}],"status":"modelled","model":{"subject":"One current stay's home-service return discussion","before":"No request, a request without agreement, or an earlier recorded answer","after":"Fresh requested record, or request with agreed/not_yet_agreed/declined answer","payload":["admissionId; step requested|answered; homeHospital required for request; answer required for answered; optional prerequisites from RETURN_PREREQUISITES and finite nextReviewAt; now; role."],"scope":"coordinator only; authenticated scope must permit the admission. A valid home site need not itself be the current admission site.","guards":["Admission exists and is not departed; optional review date finite.","Request names a site in the current scenario. Answer requires an existing request and a listed answer.","Prerequisites are listed; a declined answer cannot carry agreed prerequisites."],"effects":["Latest record per stay; fresh request clears earlier answer/prerequisites. Answer retains request and appends answer time/desk, with prerequisites unique in listed order.","Records a discussion only: does not book transport or a bed, raise a return movement or change the stay."],"sources":[{"path":"src/components/ward-management/out-of-area/home-service-return.ts","line":122,"sha256":"2f3fbdc6ba3e36b6eb890a51a7707e8b26f71eba4a803181220c17c63d1249d7"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2351,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":570,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-home-service-return.test.ts"]},"reason":"Reviewed command model: Fresh requested record, or request with agreed/not_yet_agreed/declined answer."},{"event":"FLAG_RETURN_EARLY","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":574},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2370}],"status":"modelled","model":{"subject":"One current out-of-area stay","before":"No early-return flag on the stay","after":"An early-return flag naming the home hospital, time and role","payload":["admissionId; homeHospital (listed site code); now; role."],"scope":"coordinator in the role table.","guards":["The stay exists and has not departed.","homeHospital is a listed site.","The stay is not already flagged."],"effects":["Appends a returnEarlyFlags record; the home ward site, community and officer desks see an alert while the stay is current."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":410,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/out-of-area/return-early.ts","line":70,"sha256":"28c9ec25e8d1fc5808db7af91d11f76ce64b235c292fdddfa60d1423ac2eedb3"}],"tests":["tests/ward-return-early.test.ts"]},"reason":"Reviewed command model: the coordinator flags an out-of-area stay as ready to return early to a home hospital."},{"event":"RECORD_DIRECTORY_CHECK","roles":["coordinator","bed_manager","ward","ed","community","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":576},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2367}],"status":"modelled","model":{"subject":"An on-call directory entry identifier","before":"Seeded check metadata or a previously recorded check","after":"Latest {entryId, at, by} check for that identifier","payload":["entryId matching the 1–80 character slug pattern; now; role."],"scope":"coordinator, bed_manager, ward, ed, community or officer. This reducer validates identifier shape, not membership in the seeded directory; authenticated access remains separate.","guards":["entryId must be a string matching the directory-entry slug grammar."],"effects":["Replaces the latest check for the same identifier while retaining checks for other identifiers; audit records successive checks.","Does not change the directory's phone/contact data or verify it against an external service."],"sources":[{"path":"src/components/ward-management/on-call/on-call-checks.ts","line":40,"sha256":"4c75385ac14339cbc7d98efc18af52257bb6ae185011b80e244fcf21f6d68e9d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":574,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2386,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}],"tests":["tests/ward-on-call-checks.test.ts"]},"reason":"Reviewed command model: Latest {entryId, at, by} check for that identifier."},{"event":"RECORD_HANDOVER_SIGN_OFF","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":579},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1350},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":457},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1895}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_SITE_HANDOVER_SIGN_OFF","roles":["bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":583},"sources":[{"path":"src/components/ward-management/site-sign-off/site-handover-sign-off-reducer.ts","line":28},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2373}],"status":"modelled","model":{"subject":"One site and upcoming shift handover","before":"No sign-off for this site/shift","after":"Site sign-off with a snapshot of unsigned wards and unanswered bed calls","payload":["siteCode; integer finite shiftAt at a configured shift start; now; role."],"scope":"bed_manager for its own site or whole-network coordinator. A service coordinator is refused by authenticated command scope; signing does not sign any ward's sheet.","guards":["Site has at least one ward.","shiftAt is the next handover in the one-shift sign-off window.","Site/shift has not already been signed. Open checks do not block signing."],"effects":["Appends siteHandoverSignOffs with at/by/siteCode/shiftAt and reducer-derived unsignedUnitIds/unansweredBedCallIds.","Leaves ward sign-offs and bed calls open and unchanged. Creates the site-specific step Undo."],"sources":[{"path":"src/components/ward-management/site-sign-off/site-handover-sign-off-reducer.ts","line":26,"sha256":"dc671972ed160a7492f79cde72ca6dab6dad70b59921bd378ecee4721b326db5"},{"path":"src/components/ward-management/site-sign-off/site-handover-sign-off.ts","line":80,"sha256":"abebadfb3e48655f6e362172ed644ae06615e26916f33334ce17419955567a33"},{"path":"src/components/ward-management/ward-access-state.ts","line":687,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":581,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-site-handover-sign-off.test.ts","tests/ward-handover-site-sign-off.dom.test.tsx"]},"reason":"Reviewed command model: Site sign-off with a snapshot of unsigned wards and unanswered bed calls."},{"event":"RECORD_TRIAGE_SIGNED","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":587},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2379}],"status":"modelled","model":{"subject":"One person on this workspace","before":"No signed triage, or earlier signed triages, on the person","after":"One more signed triage record on the person: time, desk role and closed-list codes","payload":["patientId; now; role; urgency (A to G); outcome (listed); legal (listed code); review (listed code); flags (RAMP factor keys marked present); problems and actions (webPSOLIS list codes, in the order chosen); venue and referralType (webPSOLIS list code or null)."],"scope":"ed, community, ward and coordinator in the role table, the same desks as RAISE_REFERRAL; a shared desk is sent a record only with a person it is sent.","guards":["The person exists on this workspace.","Urgency is one of A to G.","Outcome, legal status and review are each from their fixed lists.","Every flag is a RAMP factor key; unknown fields are dropped.","Problems and actions are arrays of at most 60 codes from their webPSOLIS lists (kept once each, in the order chosen); venue and referral type are null or a code from their list. Typed text is refused."],"effects":["Appends a triages record (codes only); the patient record's Now tab lists it. No Undo: it is a signed record. Typed text (assessment, mental state, formulation, plan) stays in the form and is never in the event."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2378,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/triage/triage-signed-reducer.ts","line":46,"sha256":"88ebffb9dc86dd544d9bdac7f561fcf4998a3af62d9a19ffe4211c5325142666"},{"path":"src/components/ward-management/ward-access-state.ts","line":329,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-triage-signed.test.ts","tests/ward-event-permissions.test.ts"]},"reason":"Reviewed command model (7 Nov 2026): a clinician signs a mental health triage and risk assessment (SMHMR900 and SMHMR905) for one person; closed-list codes only, never typed text."},{"event":"REQUEST_WARD_STAFF","roles":["ward","coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":591},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2375}],"status":"modelled","model":{"subject":"A ward's staff request for this shift or next shift","before":"Known ward; no open request for that ward and shift, or one to update","after":"staffRequests holds one open request for the ward and shift with count and ordered reasons","payload":["unitId; shift this or next; count 1, 2, 3 or 4 or more","reasons: one or more distinct items from STAFF_REQUEST_REASONS; actingUnitId for ward callers; role and now"],"scope":"Ward, coordinator or site bed manager in EVENT_ROLE; a ward acts only for its own ward (actingUnitId must equal unitId). Executive changes nothing (D-80). Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known unit; shift and count from their lists","Reject empty, duplicate or unlisted reasons, and a ward naming another ward"],"effects":["Appends a record, or updates count, reasons and updatedAt on the open one; never names a patient","Does not change beds, placement, movements or any patient stage"],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2375,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/staffing/staff-requests.ts","line":132,"sha256":"d3e51d13faedefa5314d5f128c59473110a61bae075bd5ddb362788d5ae479f3"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":591,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-staff-requests.test.ts"]},"reason":"Source-reviewed command model: one open staff request per ward per shift, added or updated in place."},{"event":"CLOSE_WARD_STAFF_REQUEST","roles":["ward","coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":592},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2376}],"status":"modelled","model":{"subject":"An open staff request on a ward","before":"Request exists on the named ward and is still open","after":"Request carries closedAt, closedBy and outcome","payload":["requestId and unitId; outcome from STAFF_REQUEST_OUTCOMES","actingUnitId for ward callers; role and now"],"scope":"Ward, coordinator or site bed manager in EVENT_ROLE; a ward acts only for its own ward (actingUnitId must equal unitId). Executive changes nothing (D-80). Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. A ward may only withdraw; the coordinator or bed manager records any other outcome.","guards":["Request found on that ward and open; outcome listed","Reject a ward recording an outcome other than withdrawn"],"effects":["Closes the one record; open lists and alerts drop it","Does not change beds, placement, movements or any patient stage"],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2376,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/staffing/staff-requests.ts","line":171,"sha256":"d3e51d13faedefa5314d5f128c59473110a61bae075bd5ddb362788d5ae479f3"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":592,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-staff-requests.test.ts"]},"reason":"Source-reviewed command model: an open staff request closed as arranged, not available or withdrawn."},{"event":"RECORD_CLINICAL_CONTACT","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":596},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1352},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":664},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1897}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"DISPATCH_BROADCAST_ALERT","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":600},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":69},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2328}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ACKNOWLEDGE_BROADCAST_ALERT","roles":["coordinator","ward","ed","officer","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":601},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":151},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2329}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"STAND_DOWN_BROADCAST_ALERT","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":602},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":198},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2330}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"EXTEND_BROADCAST_ALERT","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":603},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":228},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2331}],"status":"modelled","model":{"subject":"An active broadcast alert","before":"Active alert with current expiry/duration","after":"Same active alert with expiry and duration each extended by the fixed default","payload":["alertId; now; role. Added duration is DEFAULT_BROADCAST_EXTENSION_MINUTES, not client text or a client-selected number."],"scope":"coordinator or bed_manager. A scoped actor must control every recipient of the existing alert, not merely see one recipient.","guards":["Alert exists and is active at now; stood-down or expired alerts cannot be revived by extension."],"effects":["Adds 30 minutes (current default) to stored durationMinutes and to existing expiresAt; preserves recipients, replies and acknowledgements."],"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":228,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":461,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2395,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":708,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-top25-broadcast-extend.dom.test.tsx"]},"reason":"Reviewed command model: Same active alert with expiry and duration each extended by the fixed default."},{"event":"ADD_BROADCAST_ALERT_UNITS","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":604},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":243},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2332}],"status":"modelled","model":{"subject":"An active directive or bed call's recipients","before":"Existing recipient scope/list","after":"Existing recipients plus new unique named desks","payload":["alertId; non-empty unitIds array naming real desks; now; role."],"scope":"coordinator or bed_manager. Authenticated scope must cover the existing alert's full recipient set and every newly added desk.","guards":["Alert exists and is active; Pull now cannot add recipients.","Bed calls accept real wards only; directives may also name real ED desks.","At least one named desk has not already been asked."],"effects":["Resolves previous scope into an explicit targetUnitIds list, appends only new ids and recomputes targetScopeLabel.","Does not reset expiry or clear previous replies/acknowledgements."],"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":243,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2394,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":708,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-broadcast-add-units.test.ts"]},"reason":"Reviewed command model: Existing recipients plus new unique named desks."},{"event":"RAISE_PULL_NOW","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":608},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":293},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2333}],"status":"modelled","model":{"subject":"A waiting movement and a new patient-specific broadcast","before":"Waiting open movement with wards considering/accepting it, no live Pull now","after":"Same movement plus active Pull now addressed to the relevant wards","payload":["movementId; now; role. Recipients, text, severity, deadlines and id are generated from state/constants."],"scope":"coordinator only; authenticated scope must permit the movement and every ward selected by pullNowWards.","guards":["Movement exists, is open and in PULL_NOW_LIVE_STAGES.","No currently live still-applicable Pull now exists for this movement.","At least one real relevant ward can be asked."],"effects":["Prepends an active critical pull_now alert, increments broadcastSequence and records answerBy/expiry and movement stage-change count at dispatch.","Recipients are accepting ward, else real referred wards. Does not itself pull a bed, move the patient or change movement stage."],"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":293,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-model.ts","line":317,"sha256":"b27896e799de72fbb71c7782bc2a571627809762c61a40dcecb86b07007ca647"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2416,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":729,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-global-alerts.test.ts"]},"reason":"Reviewed command model: Same movement plus active Pull now addressed to the relevant wards."},{"event":"REPLY_BROADCAST_ALERT","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":610},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":348},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2334}],"status":"modelled","model":{"subject":"One desk's answer to a bed call or Pull now","before":"Active applicable alert with no answer or a different latest answer for this desk","after":"Reply appended; desk also acknowledged","payload":["alertId; real unitId; answer from this alert kind's fixed list; optional beds, readyAt or reason as required by answer; now; role."],"scope":"ward, bed_manager or coordinator, with authenticated place/record scope. A bed call accepts wards only; Pull now accepts only its target wards.","guards":["Alert exists and is active; Pull now's movement must still be waiting; directives use acknowledgement instead.","Unit is real and included when recipients are explicit; answer belongs to kind-specific list.","can_take needs whole beds in 1..BED_CALL_MAX_BEDS; after_discharge/bed_ready_at needs finite future readyAt within the configured horizon; Pull now cannot needs a listed decline reason.","An identical latest answer is refused."],"effects":["Appends reply {unitId,answer,at,role,...conditional detail}; adds desk to acknowledgedUnits once.","Answers are reported capacity statements, not bed allocation or automatic movement transitions."],"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":348,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2415,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-global-alerts.test.ts","tests/ward-broadcast-audience-bed-call-wards.test.ts"]},"reason":"Reviewed command model: Reply appended; desk also acknowledged."},{"event":"BOOK_PLANNED_ADMISSION","roles":["coordinator","bed_manager","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":613},"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":74},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2340}],"status":"modelled","model":{"subject":"A future planned admission","before":"No booking for this linked patient, or an initials-only booking to create","after":"New PA-* record in booked state, holding no bed","payload":["Exactly one of patientId or initials; sex; ageBand; reason; unitId; expectedArrivalAt; expectedStayDays; legalStatus; now/role. Optional gender, overrideReason, actingUnitId. Linked patient requires calendarDate for age validation."],"scope":"coordinator, bed_manager or ward; ward may book its own ward only. Authenticated place/record scope additionally applies.","guards":["Finite now and arrival, listed reason/legal status/gender and bounded whole expectedStayDays; destination unit exists.","Arrival must fall within the configured booking window; a newly chosen arrival cannot be in the past.","Ward caller must name its actingUnitId and all affected wards must be that unit.","Admission authorisation gate needs a listed override reason when applicable; other placement gates are rechecked on conversion.","Ward must be open to new admissions. Sex and ageBand are listed.","Linked patient exists, has no occupied/pulled bed or existing booked planned admission; recorded birth date matches cohort on arrival date. Initials-only requires 1–3 letters; the panel names digits and more than three letters separately, while blank initials get the generic \"Initials are one to three letters.\" line; a direct event with neither patient nor initials is rejected by the patient-or-initials guard."],"effects":["Appends a booked plan and increments plannedAdmissionSequence; linked gender comes from patient record, never event.","Stores a required same-ward authorisation override. No bed count or admission changes until conversion; initials invoke the typed-text persistence boundary."],"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":299,"sha256":"fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"},{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":263,"sha256":"fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2431,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-planned-admissions.test.ts","tests/ward-audit24-1-planned-booking-authorised.test.ts"]},"reason":"Reviewed command model: New PA-* record in booked state, holding no bed."},{"event":"CHANGE_PLANNED_ADMISSION","roles":["coordinator","bed_manager","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":614},"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":388},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2345}],"status":"modelled","model":{"subject":"An existing booked planned admission","before":"booked plan with current ward/date/stay/reason/legal status/gender","after":"Still booked, with revised fields, changedAt and incremented changeCount","payload":["plannedAdmissionId; replacement reason/unitId/expectedArrivalAt/expectedStayDays/legalStatus; now/role. Optional gender, overrideReason, actingUnitId; calendarDate when a linked arrival changes calendar day."],"scope":"coordinator, bed_manager or ward; a ward may change neither from nor to another ward. Authenticated record and destination scope also applies.","guards":["Finite now and arrival, listed reason/legal status/gender and bounded whole expectedStayDays; destination unit exists.","Arrival must fall within the configured booking window; a newly chosen arrival cannot be in the past.","Ward caller must name its actingUnitId and all affected wards must be that unit.","Admission authorisation gate needs a listed override reason when applicable; other placement gates are rechecked on conversion.","Plan exists and remains booked.","Changing to a different closed ward refuses; an existing booking at a newly closed ward may remain there.","An overdue booking may retain its old arrival time while other fields change; moving a linked arrival date must still match its recorded cohort.","Authorisation override may persist for the same standing ward/gate; moving away drops an irrelevant override."],"effects":["Replaces planning fields, records changedAt/count and record-derived linked gender. No bed is held or released."],"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":383,"sha256":"fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"},{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":263,"sha256":"fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2488,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-planned-admissions.test.ts","tests/ward-audit24-1-planned-booking-authorised.test.ts"]},"reason":"Reviewed command model: Still booked, with revised fields, changedAt and incremented changeCount."},{"event":"CANCEL_PLANNED_ADMISSION","roles":["coordinator","bed_manager","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":615},"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":464},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2350}],"status":"modelled","model":{"subject":"One booked planned admission","before":"booked","after":"cancelled with cancel reason and time","payload":["plannedAdmissionId; unitId equal to booking's ward; listed cancellation reason; finite now; role; actingUnitId when ward."],"scope":"coordinator, bed_manager or ward, with own-ward identity for ward and authenticated booking scope.","guards":["Booking exists and state is booked.","Reason is listed; unitId matches booking; ward scope matches; now finite."],"effects":["Retains the booking record, changing state/cancelledAt/cancelReason.","No capacity refund occurs because booking held no bed. Cancelled plans no longer count as pending arrivals.","The step can be taken back by UNDO_RELEASE_STEP within the Undo window, filed against the booking."],"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":459,"sha256":"fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2488,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-planned-admissions.test.ts"]},"reason":"Reviewed command model: cancelled with cancel reason and time."},{"event":"CONVERT_PLANNED_ADMISSION","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":616},"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":488},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":743}],"status":"modelled","model":{"subject":"A booked plan and its receiving ward","before":"booked plan, no current linked bed/journey, ready eligible capacity","after":"Plan arrived and linked to a new occupied admission","payload":["plannedAdmissionId; unitId equal to booking's ward; finite now; role; actingUnitId for ward."],"scope":"ward or coordinator only; ward must name its own booked ward. Authenticated booking/ward scope additionally applies.","guards":["Plan exists and is booked; unit matches and is open. Linked patient has neither another held/occupied bed nor an open movement.","A Ready bed exists (pulledBedAvailability, counting live pulled admissions) and, when beds are pending preparation, more Ready beds than pending ones. Secure request requires a free locked bed. Other journeys' pending numbered reservations at the ward come off Ready and off the free locked and open counts first.","Current placement eligibility gates pass; only a recorded same-ward authorisation override waives that specific gate.","A gender-placement review requirement refuses this shortcut; use referral journey instead."],"effects":["Creates an occupied AD-ARR-* admission with recorded patient/sex/gender/planned legal status, without a movement/referral; increments admissionSequence.","Decrements ward empty and allocatable counts by one, locked count when used, and increments sex mix.","Marks plan arrived with convertedAt/admissionId; does not create a numbered bed assignment or admit merely because its date passed."],"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":483,"sha256":"fcd8e3b7667a295dc58225efa80ca7dc36863ad203ca4b6873c535c7ae5a0eb3"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2516,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-planned-admissions.test.ts","tests/ward-planned-arrival-closed-bed.test.ts"]},"reason":"Reviewed command model: Plan arrived and linked to a new occupied admission."},{"event":"RECORD_SUPPORT_NOTIFICATION","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":619},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1353},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":676},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1898}],"status":"modelled","model":{"subject":"One completed involuntary arrival/transfer or discharge, and one support party","before":"No or earlier checklist Tell record","after":"Another told/not_applicable record appended","payload":["occasion admission|transfer|discharge; party from checklist; outcome told|not_applicable; now/role. Arrival/transfer names movementId only; discharge admissionId only. told needs nonblank bounded who and optional contactedAt\u003c=now; not_applicable needs nonblank bounded reason and forbids who/contactedAt."],"scope":"ward or coordinator. Authenticated arriving movement must belong to its accepted ward scope; admission references and acting place are separately scoped.","guards":["now finite; occasion/party/outcome listed.","Named subject exists and meets completed involuntary arrival/transfer/discharge eligibility; arrival occasion matches recorded source.","Conditional text fields obey exclusive shape and length/time rules."],"effects":["Appends uniquely numbered SN-* record with subject/occasion/party/desk/time and outcome detail; creates step Undo.","Advisory recording only: neither calculates legal duties/deadlines nor blocks or advances the journey. Typed who/reason invokes typed-text persistence boundary."],"sources":[{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":671,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2519,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":887,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-support-notifications.test.ts","tests/ward-discharge-support-notification.test.ts"]},"reason":"Reviewed command model: Another told/not_applicable record appended."},{"event":"SEND_RELEASE_SUPPORT_NOTICE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":620},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1956},{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":29}],"status":"modelled","model":{"subject":"One confirmed bed release and a support service","before":"confirmed release with no Sent record for chosen service","after":"confirmed release with service marked Sent","payload":["releaseId; service from SUPPORT_SERVICE_TYPES; actingUnitId required and equal to release.unitId; now; role."],"scope":"ward or coordinator; actingUnitId must equal the release's ward even for coordinator, and authenticated scope also applies.","guards":["Release exists and remains confirmed.","Service is listed and has not already been notified.","Acting unit is the release's own unit."],"effects":["Appends {service,at,by} to supportNoticesSent.","This prototype writes the record; no external pharmacy, transport or cleaning integration is invoked by this handler. No bed/stage change."],"sources":[{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":52,"sha256":"057ef764a841f671c0fac813c4f9485a121ca811c1228b7fec3b7abdbd94d5fd"},{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":28,"sha256":"057ef764a841f671c0fac813c4f9485a121ca811c1228b7fec3b7abdbd94d5fd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-release-notices.test.ts"]},"reason":"Reviewed command model: confirmed release with service marked Sent."},{"event":"RECORD_DISCHARGE_DEPENDENCY","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":622},"sources":[{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":34},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1959}],"status":"modelled","model":{"subject":"One non-discharged bed release and one logistics kind","before":"Missing or existing dependency for this kind","after":"Latest outstanding/done/not_needed state and owner recorded","payload":["releaseId; actingUnitId equal to release ward; kind/owner/state from closed lists; now; role."],"scope":"ward or coordinator, requiring release's own actingUnitId and authenticated release scope.","guards":["Release exists and is not discharged.","Kind, owner and state are listed.","Repeating the same already-outstanding owner/state refuses; done/not_needed can be reconfirmed."],"effects":["Adds or replaces the dependency by kind, recording time and desk label.","Does not alter release stage, blocker, bed counts, or call an external service."],"sources":[{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":60,"sha256":"dc256c1d387ba227491f407b6f56c3692ba3478fd4bd96dc95a5bb5b45e7e9dd"},{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":78,"sha256":"dc256c1d387ba227491f407b6f56c3692ba3478fd4bd96dc95a5bb5b45e7e9dd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-discharge-dependencies.test.ts"]},"reason":"Reviewed command model: Latest outstanding/done/not_needed state and owner recorded."},{"event":"RECORD_DISCHARGE_PLAN_CHANGE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":623},"sources":[{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":49},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1960}],"status":"modelled","model":{"subject":"One non-discharged bed release's logistics plan","before":"Current expected time or planned destination","after":"One changed fact, with recorded change history where applicable","payload":["releaseId; actingUnitId equal to release ward; exactly one of finite expectedAt or listed leavingDestination; now; role."],"scope":"ward or coordinator, requiring release's own actingUnitId and authenticated release scope.","guards":["Release exists and is not discharged.","Exactly one fact is carried and it differs from the current recorded fact.","Date is finite; destination is in LEAVING_DESTINATIONS."],"effects":["Date branch updates BedRelease.expectedAt and appends planChanges; destination branch writes plannedDestination and appends a change only if a prior destination existed.","Done dependencies relying on a changed fact can be shown as needing recheck by selectors. Handler does not itself cancel logistics, change release stage or bed counts.","A date change on a release linked to a stay that has not departed also updates that stay's expected discharge date, date-move count and set-by (updateExpectedDischargeDate), and the stay's other pending releases."],"sources":[{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":101,"sha256":"dc256c1d387ba227491f407b6f56c3692ba3478fd4bd96dc95a5bb5b45e7e9dd"},{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":49,"sha256":"dc256c1d387ba227491f407b6f56c3692ba3478fd4bd96dc95a5bb5b45e7e9dd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-discharge-dependencies.test.ts"]},"reason":"Reviewed command model: One changed fact, with recorded change history where applicable."},{"event":"RECORD_DISCHARGE_CHECK","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":625},"sources":[{"path":"src/components/ward-management/discharges/discharge-check-events.ts","line":37},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2361}],"status":"modelled","model":{"subject":"One stay with a bed (not waitlisted) and one checklist item","before":"Item not ticked, or ticked with a different state","after":"One discharge checklist item recorded as done, not needed or outstanding","payload":["admissionId; item and state from closed lists; now and role; actingUnitId when acting as ward."],"scope":"ward or coordinator. A ward must name the admission's own unit.","guards":["Admission exists and is not waitlisted.","Item and state are listed, and the state differs from the item's current ticked state."],"effects":["Sets admission.dischargeChecks[item] with time and desk role.","Advisory only: never blocks RECORD_LEAVING or RECORD_PATIENT_DISCHARGE and changes no release or bed figure."],"sources":[{"path":"src/components/ward-management/discharges/discharge-check-events.ts","line":60,"sha256":"584c52430b354fe68ebf1f0504c424400f28a32eb8f081f08ffb27a7016896d1"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":625,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-discharge-follow-through.test.ts"]},"reason":"Reviewed command model: One discharge checklist item recorded as done, not needed or outstanding."},{"event":"RECORD_FOLLOW_UP_REPLY","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":627},"sources":[{"path":"src/components/ward-management/discharges/discharge-check-events.ts","line":51},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2362}],"status":"modelled","model":{"subject":"One stay with a bed (not waitlisted) referred to the acting community team","before":"No reply, or a different reply or decline reason","after":"The community team's follow-up reply recorded, with a listed reason when declined","payload":["admissionId; reply from awaiting/accepted/declined; declineReason from a closed list only with declined; now and role; actingTeamId when acting as a community team."],"scope":"community or coordinator. A community desk must name a known team the admission's referral named.","guards":["Admission exists and is not waitlisted.","A community desk names its team, and the stay belongs to that team.","Reply is listed; a decline carries a listed reason and nothing else does; the same reply is not recorded twice."],"effects":["Sets admission.followUpReply with time and desk role; the ward reads it on the discharge board and checklist.","Does not change the ward's followUp record, the care journey, any release or bed figure."],"sources":[{"path":"src/components/ward-management/discharges/discharge-check-events.ts","line":60,"sha256":"584c52430b354fe68ebf1f0504c424400f28a32eb8f081f08ffb27a7016896d1"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":627,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-discharge-follow-through.test.ts"]},"reason":"Reviewed command model: The community team's follow-up reply recorded, with a listed reason when declined."},{"event":"RECORD_ARRIVAL_CHECK","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":628},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1962},{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":44}],"status":"modelled","model":{"subject":"An open movement's pre-transfer checklist flag","before":"Contraband-search or medication-chart flag false/unrecorded or true","after":"Chosen flag set to the opposite recorded boolean","payload":["movementId; check from ARRIVAL_CHECKS; done boolean; now; role."],"scope":"ed or coordinator; authenticated movement/place scope additionally applies.","guards":["Movement exists and has no closure.","Check is listed and done is boolean.","Unrecorded counts as false; trying to record the same effective value refuses."],"effects":["Writes contrabandSearchDone or medicationChartDone only. false takes a mistaken tick back.","Does not itself certify a clinical assessment, create a notice or advance stage."],"sources":[{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":91,"sha256":"057ef764a841f671c0fac813c4f9485a121ca811c1228b7fec3b7abdbd94d5fd"},{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":43,"sha256":"057ef764a841f671c0fac813c4f9485a121ca811c1228b7fec3b7abdbd94d5fd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-release-notices.test.ts","tests/ward-top25-admission-checklist.dom.test.tsx"]},"reason":"Reviewed command model: Chosen flag set to the opposite recorded boolean."},{"event":"UNDO_REFERRAL_DECISION","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":632},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1752},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":98}],"status":"modelled","model":{"subject":"The latest accepted/declined decision snapshot on a referral","before":"Referral exactly as the latest undoable decision left it","after":"Referral restored to its pre-decision snapshot","payload":["referralId; now; role; optional recordSeq to bind the exact decision; actingUnitId when ward."],"scope":"ward, coordinator, ed or community in role table, then original acting role (and ward) or coordinator; authenticated reference scope applies.","guards":["Referral and its decision Undo record exist; supplied recordSeq matches newest record.","now is not before the decision and is within UNDO_WINDOW_MINUTES (currently five).","Current referral deeply equals saved after snapshot; original-role/ward check passes.","An undone ACCEPT_REFERRAL refuses while a movement for the referral is not closed as did_not_proceed, or a stay from it holds a bed."],"effects":["Restores full referral before snapshot, removes only notices created by that decision id/time, and consumes the Undo record.","Does not remove the audit evidence of the decision or Undo; a later reassessment can make this Undo inapplicable."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":98,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1465,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-undo.ts","line":491,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-and-bed-board.test.ts","tests/ward-undo-toast-record-seq.dom.test.tsx"]},"reason":"Reviewed command model: Referral restored to its pre-decision snapshot."},{"event":"UNDO_AUDIT_REVIEW","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":634},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":104},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1577}],"status":"modelled","model":{"subject":"One captured-event review in the current world generation","before":"Latest review on its captured event","after":"That review removed while audit history remains","payload":["reviewId; expectedGeneration matching current worldGeneration; finite now; role."],"scope":"coordinator only, with authenticated review/record scope; role check occurs before protected payload handling.","guards":["expectedGeneration is a safe current counter; review exists uniquely in this generation.","No later review on that event remains; undo newest first.","Time is at or after review and within UNDO_WINDOW_MINUTES."],"effects":["Removes that review from auditReviews and appends audited Undo; audit review ids are not reused.","Does not erase the reviewed event or its original review/Undo audit entries."],"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":103,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2587,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-undo.ts","line":491,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-and-bed-board.test.ts","tests/ward-governance.dom.test.tsx"]},"reason":"Reviewed command model: That review removed while audit history remains."},{"event":"PLACE_IN_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":636},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":99},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1771}],"status":"modelled","model":{"subject":"A current occupied/pulled stay on one ward","before":"Stay in another numbered bed or with known kind but no number","after":"Same stay recorded in the selected numbered bed and matching bed kind","payload":["admissionId; integer bedNumber within unit.beds; now/role; actingUnitId for ward; optional listed overrideReason when moving a locked/secure/involuntary stay to an open bed."],"scope":"ward or coordinator; ward must name admission's own unit. Authenticated stay/ward scope applies.","guards":["Admission exists and bedIsOccupied; unit exists; new bed differs and is in range, unoccupied and not held by another journey.","Prior bed kind can be determined safely; resulting locked/free counts are supported.","Open-bed move that needs an override has a listed reason."],"effects":["Updates admission bedNumber/bedKind, adjusts allocatableLocked only for kind changes; total empty/allocatable counts stay unchanged.","For a linked pulled stay, keeps movement heldBedNumber and accepted referral arm heldBedNumber aligned.","Captures the exact bed-placement Undo snapshot including prior kind, capacity revision and linked holds."],"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":97,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2592,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-and-bed-board.test.ts","tests/ward-release-pull-undo-guard.test.ts"]},"reason":"Reviewed command model: Same stay recorded in the selected numbered bed and matching bed kind."},{"event":"UNDO_PLACE_IN_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":637},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1753},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":134}],"status":"modelled","model":{"subject":"A stay's latest numbered-bed move","before":"Stay still in saved destination bed; any changed kind capacity/linked holds unchanged","after":"Prior bed number/kind and associated hold numbers restored","payload":["admissionId; now; role; optional recordSeq; actingUnitId when ward."],"scope":"ward or coordinator; original acting role/ward or coordinator, plus authenticated stay scope.","guards":["Latest move record exists; exact supplied recordSeq, time-window and acting-role checks pass.","Stay remains current on same unit/in afterBed; changed kind capacity revision/count and linked pulled movement/referral arm still match saved after values.","Every restored numbered bed remains valid, unoccupied and unheld by another journey."],"effects":["Restores bedNumber (or absence), bedKind (or absence), changed free-locked count and linked hold numbers without overwriting unrelated rows.","Consumes bed-placement Undo; same-kind moves do not overwrite or block on unrelated later capacity changes."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":134,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2612,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-undo.ts","line":491,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-and-bed-board.test.ts","tests/ward-release-pull-undo-guard.test.ts"]},"reason":"Reviewed command model: Prior bed number/kind and associated hold numbers restored."},{"event":"UNDO_REFER_TO_UNITS","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":640},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1754},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261}],"status":"modelled","model":{"subject":"Latest undoable REFER_TO_UNITS on the named subject","before":"Saved step record and unchanged post-step state","after":"Movement offer/ward-referral changes reversed","payload":["movementId; now; role; optional recordSeq matching the exact newest step."],"scope":"coordinator only. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for REFER_TO_UNITS; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts"]},"reason":"Reviewed command model: Movement offer/ward-referral changes reversed."},{"event":"UNDO_ACCEPT_IN_PRINCIPLE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":641},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1755},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":262}],"status":"modelled","model":{"subject":"Latest undoable ACCEPT_IN_PRINCIPLE on the named subject","before":"Saved step record and unchanged post-step state","after":"Acceptance, held bed/admission and generated notices restored to pre-acceptance","payload":["movementId; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"ward or coordinator; original ward actingUnitId or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for ACCEPT_IN_PRINCIPLE; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts"]},"reason":"Reviewed command model: Acceptance, held bed/admission and generated notices restored to pre-acceptance."},{"event":"UNDO_LEGAL_FORM_RECORD","roles":["ed","coordinator","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":642},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1756},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":263}],"status":"modelled","model":{"subject":"Latest undoable RECORD_LEGAL_FORM_WRITTEN, RECORD_LEGAL_FORM_CODE, RECORD_LEGAL_FORM_RECEIVED or RECORD_LEGAL_FORM_EXPIRY on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest recorded form/time/receipt/expiry and accompanying changed rows restored","payload":["movementId; now; role; optional recordSeq matching the exact newest step."],"scope":"ed, coordinator, ward or community; original acting role or coordinator (role eligibility is not authority over another place). Authenticated record/place scope remains required. A ward must match the original ward captured in the saved Undo record, not merely a ward eligible to view or act on the movement now. Missing legacy ward provenance refuses a ward caller; coordinator handling remains available.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The legitimate legal-form Undo payload omits actingUnitId: reducer role consistency falls back to the saved record.unitId, while shared authenticated scope independently compares that original ward with the caller's scope.","The original ward is recorded on the source legal-form step even when its legitimate caller omitted actingUnitId: receipt provenance uses the sending stay or ward referral, while other form entries use the receiving stay. Another eligible ward cannot substitute for that original ward; coordinator and original-role rules otherwise remain.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_LEGAL_FORM_WRITTEN, RECORD_LEGAL_FORM_CODE, RECORD_LEGAL_FORM_RECEIVED or RECORD_LEGAL_FORM_EXPIRY; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-audit-legal-group.test.ts","tests/ward-ed-handover-events.test.ts","tests/ward-consolidated-authority.test.ts"]},"reason":"Reviewed command model: Newest recorded form/time/receipt/expiry and accompanying changed rows restored."},{"event":"UNDO_SUPPORT_NOTIFICATION","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":643},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1757},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":264}],"status":"modelled","model":{"subject":"Latest undoable RECORD_SUPPORT_NOTIFICATION on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest Tell record removed from the subject's checklist","payload":["movementId or admissionId identifying the original Tell subject; now; role; optional recordSeq matching the exact newest step."],"scope":"ward or coordinator; original acting role or coordinator; arriving movement must remain inside accepted-ward scope. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_SUPPORT_NOTIFICATION; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts","tests/ward-support-notifications.test.ts"]},"reason":"Reviewed command model: Newest Tell record removed from the subject's checklist."},{"event":"UNDO_REPATRIATION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":644},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1758},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":265}],"status":"modelled","model":{"subject":"Latest undoable RECORD_REPATRIATION on the named subject","before":"Saved step record and unchanged post-step state","after":"Return transport record and all generated journey/notice changes restored","payload":["admissionId; now; role; optional recordSeq matching the exact newest step."],"scope":"coordinator only. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_REPATRIATION; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-out-of-area-repatriation.test.ts"]},"reason":"Reviewed command model: Return transport record and all generated journey/notice changes restored."},{"event":"UNDO_FLAG_RETURN_EARLY","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":645},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1759},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":266}],"status":"modelled","model":{"subject":"The newest FLAG_RETURN_EARLY on one stay","before":"Stay flagged early by that step","after":"Stay as it was before the flag","payload":["admissionId; now; role; optional recordSeq."],"scope":"coordinator in the role table.","guards":["A matching Undo record exists for this kind of step on this subject; a supplied recordSeq must match the newest record.","The undoing role is the role (and ward) that acted, or a coordinator; now is within UNDO_WINDOW_MINUTES.","The subject has not changed since the step, and restoring it would not put the patient in a second bed or clash with an occupied bed number.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Restores the saved snapshot of the step, removes notices that step raised and consumes the Undo record.","The audit evidence of the step and of the Undo stays."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1508,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":266,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"}],"tests":["tests/ward-return-early.test.ts"]},"reason":"Reviewed command model: takes back the newest early-return flag on a stay within the Undo window."},{"event":"UNDO_HANDOVER_SIGN_OFF","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":646},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1760},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":267}],"status":"modelled","model":{"subject":"Latest undoable RECORD_HANDOVER_SIGN_OFF on the named subject","before":"Saved step record and unchanged post-step state","after":"Latest sign-off for that ward or network removed","payload":["unitId for ward sign-off; omitted names network subject; now; role; optional recordSeq matching the exact newest step."],"scope":"coordinator or ward; original acting role/ward or coordinator; a ward must name its own ward. Authenticated record/place scope remains required. Only the statewide coordinator may omit unitId for a whole-network subject; a scoped coordinator must name a ward inside its scope.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","Shared scoped callers cannot resolve a missing unitId to the whole-network sign-off; an ordinary in-scope ward target remains allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_HANDOVER_SIGN_OFF; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts","tests/ward-consolidated-authority.test.ts"]},"reason":"Reviewed command model: Latest sign-off for that ward or network removed."},{"event":"UNDO_SITE_HANDOVER_SIGN_OFF","roles":["bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":649},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1761},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":268}],"status":"modelled","model":{"subject":"Latest undoable RECORD_SITE_HANDOVER_SIGN_OFF on the named subject","before":"Saved step record and unchanged post-step state","after":"Latest sign-off for that site removed; no ward sign-off changed","payload":["siteCode; now; role; optional recordSeq matching the exact newest step."],"scope":"bed_manager only for its own site; coordinator is not eligible even if it signed as cover. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_SITE_HANDOVER_SIGN_OFF; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":283,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"}],"tests":["tests/ward-undo-steps.test.ts","tests/ward-site-handover-sign-off.test.ts"]},"reason":"Reviewed command model: Latest sign-off for that site removed; no ward sign-off changed."},{"event":"UNDO_ED_STEP","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":650},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1762},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":269}],"status":"modelled","model":{"subject":"Latest undoable RECORD_ARRIVED_IN_DEPARTMENT, RECORD_EXAMINATION, RECORD_MEDICAL_CLEARANCE, RECORD_TRANSPORT_NEED, RECORD_ED_PRESENTATION, HANDOVER_READY, REQUEST_PSYCH_REVIEW or RECORD_PSYCH_REVIEW_SEEN on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest ED board step and all records it changed restored","payload":["movementId or referralId identifying original subject; now; role; optional recordSeq matching the exact newest step."],"scope":"ed, ward, community or coordinator; original acting role or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_ARRIVED_IN_DEPARTMENT, RECORD_EXAMINATION, RECORD_MEDICAL_CLEARANCE, RECORD_TRANSPORT_NEED, RECORD_ED_PRESENTATION, HANDOVER_READY, REQUEST_PSYCH_REVIEW or RECORD_PSYCH_REVIEW_SEEN; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-ed-examination-save.dom.test.tsx","tests/ward-ed-handover-events.test.ts"]},"reason":"Reviewed command model: Newest ED board step and all records it changed restored."},{"event":"UNDO_TRANSPORT_STEP","roles":["officer","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":651},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1763},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":270}],"status":"modelled","model":{"subject":"Latest undoable TRANSPORT_ACCEPTED, TRANSPORT_EN_ROUTE, PATIENT_COLLECTED or PATIENT_ARRIVED on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest transport stage reversed, including arrival-created stay and affected bed/resource changes","payload":["movementId; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"officer, ward or coordinator; original acting role/ward or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for TRANSPORT_ACCEPTED, TRANSPORT_EN_ROUTE, PATIENT_COLLECTED or PATIENT_ARRIVED; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts","tests/ward-undo-dependent-records.test.ts"]},"reason":"Reviewed command model: Newest transport stage reversed, including arrival-created stay and affected bed/resource changes."},{"event":"UNDO_DEPARTURE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":652},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1764},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":271}],"status":"modelled","model":{"subject":"Latest undoable RECORD_LEAVING or RECORD_PATIENT_DISCHARGE on the named subject","before":"Saved step record and unchanged post-step state","after":"Departure reversed, stay and capacity restored if still safe","payload":["admissionId; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"ward or coordinator; original acting role/ward or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_LEAVING or RECORD_PATIENT_DISCHARGE; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-departure-undo-integrity.test.ts"]},"reason":"Reviewed command model: Departure reversed, stay and capacity restored if still safe."},{"event":"UNDO_ABSENT_WITHOUT_LEAVE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":653},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1765},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":272}],"status":"modelled","model":{"subject":"Latest undoable RECORD_ABSENT_WITHOUT_LEAVE on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest absence record and related row changes reversed","payload":["admissionId; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"ward or coordinator; original acting role/ward or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_ABSENT_WITHOUT_LEAVE; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-engine-safety.test.ts"]},"reason":"Reviewed command model: Newest absence record and related row changes reversed."},{"event":"UNDO_BED_MEETING_ACTION","roles":["coordinator","ward","ed","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":655},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1766},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":273}],"status":"modelled","model":{"subject":"Latest undoable COMPLETE_BED_MEETING_ACTION or RECORD_BED_MEETING_ACTION on the named subject","before":"Saved step record and unchanged post-step state","after":"One completed meeting action reopened to its exact prior state","payload":["subject {kind:movement|admission,id}; action BedMeetingActionKind; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"coordinator, ward, ed, community or bed_manager; original acting role/ward or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for COMPLETE_BED_MEETING_ACTION or RECORD_BED_MEETING_ACTION (Chase Undo); removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-bed-meeting-undo-event-type.ts","line":10,"sha256":"a112bd8031c48d720a344b7a3fe9821b6f41db2d88956a2b001f8e5fca8fdb41"}],"tests":["tests/ward-bed-meeting-undo.test.ts"]},"reason":"Reviewed command model: One completed meeting action reopened to its exact prior state."},{"event":"UNDO_BED_STEP","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":657},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1767},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":274}],"status":"modelled","model":{"subject":"One bed (unitId and bedNumber) or one leave bed record","before":"Bed as the SET_BED_CLOSED or END_LEAVE_BED step left it","after":"Bed or leave record restored to before that step","payload":["now; role; optional recordSeq; actingUnitId when ward; leaveBedId, or unitId and bedNumber."],"scope":"ward, bed_manager or coordinator in the role table.","guards":["A matching Undo record exists for this kind of step on this subject; a supplied recordSeq must match the newest record.","The undoing role is the role (and ward) that acted, or a coordinator; now is within UNDO_WINDOW_MINUTES.","The subject has not changed since the step, and restoring it would not put the patient in a second bed or clash with an occupied bed number.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Restores the saved snapshot of the step, removes notices that step raised and consumes the Undo record.","The audit evidence of the step and of the Undo stays."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1516,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":274,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"}],"tests":["tests/ward-tier1-undo.test.ts","tests/ward-undo-dependent-records.test.ts"]},"reason":"Reviewed command model: takes back a bed closed or reopened, or a return from leave, within the Undo window."},{"event":"UNDO_RELEASE_STEP","roles":["coordinator","ward","ed","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":658},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1768},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":275}],"status":"modelled","model":{"subject":"One movement, one bed release, or one planned admission","before":"As the release, confirm, cancel or withdraw step left it","after":"Restored to before that step","payload":["now; role; optional recordSeq; actingUnitId when ward; movementId, releaseId or plannedAdmissionId."],"scope":"coordinator, ward, ed, community or bed_manager in the role table.","guards":["A matching Undo record exists for this kind of step on this subject; a supplied recordSeq must match the newest record.","The undoing role is the role (and ward) that acted, or a coordinator; now is within UNDO_WINDOW_MINUTES.","The subject has not changed since the step, and restoring it would not put the patient in a second bed or clash with an occupied bed number.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Restores the saved snapshot of the step, removes notices that step raised and consumes the Undo record.","The audit evidence of the step and of the Undo stays."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1517,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":275,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"}],"tests":["tests/ward-tier1-undo.test.ts"]},"reason":"Reviewed command model: takes back a released bed, confirmed discharge sign-off, cancelled transport, withdrawn ward request or cancelled planned admission."},{"event":"UNDO_PATIENT_RECORD","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":659},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1769},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":276}],"status":"modelled","model":{"subject":"One patient record","before":"As the CTO or archive step left it","after":"Patient record restored to before that step","payload":["patientId; now; role; optional recordSeq."],"scope":"community or coordinator in the role table.","guards":["A matching Undo record exists for this kind of step on this subject; a supplied recordSeq must match the newest record.","The undoing role is the role (and ward) that acted, or a coordinator; now is within UNDO_WINDOW_MINUTES.","The subject has not changed since the step, and restoring it would not put the patient in a second bed or clash with an occupied bed number.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Restores the saved snapshot of the step, removes notices that step raised and consumes the Undo record.","The audit evidence of the step and of the Undo stays."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1518,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":276,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-retained-umrn.ts","line":25,"sha256":"7968243f077b9d5c9a6fe6a56385f48ff6a97aa39cfdeec8fe97f05919693d80"}],"tests":["tests/ward-tier1-undo.test.ts","tests/ward-retained-umrn.test.ts"]},"reason":"Reviewed command model: takes back a community treatment order recorded or ended, or a record archived in error."},{"event":"RECORD_CARE_PLAN","roles":["ward","ed","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":663},"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-events.ts","line":14},{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":44}],"status":"modelled","model":{"subject":"A patient record's care plans","before":"Patient exists, holding zero or more care plans (at most one Current)","after":"New Current plan appended; any earlier Current plan marked Superseded, never deleted","payload":["patientId; plan with type and what helps from fixed lists, agreed by (short text), typed dates, optional key contact and one short note","optional attachment as file type and size only (never the file or its name); role and now"],"scope":"Ward, ED, community or coordinator in EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; finite now; plan type and helps on their lists; agreed by and agreed date required","Short text over its limit refused, never shortened; attachment needs a listed type and a positive byte size; at most 20 plans per person"],"effects":["Replaces the patient's carePlans with the superseded list plus the new Current plan","Typed-text event: a session that sends it stops saving to browser storage"],"tests":["tests/ward-patient-care-plans.test.ts","tests/ward-event-permissions.test.ts"],"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":44,"sha256":"ebd947f4ec177d0acb998b35f3ebd66d0ac58b777c9a874e20ed3e67203caa1d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":663,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-care-plans.ts","line":98,"sha256":"20f25414be8b4ae5eb1b9cc9eee189ba1ba08b0466b00ee6f7139876b963752f"}]},"reason":"Source-reviewed command model: a new Current care plan on the patient; the previous Current plan becomes Superseded."},{"event":"RECORD_TRIBUNAL_HEARING","roles":["ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":664},"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-events.ts","line":22},{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":81}],"status":"modelled","model":{"subject":"A patient record's tribunal hearing","before":"Patient exists, with or without an earlier hearing date","after":"tribunalHearing holds the typed date, optional typed time, role and time recorded; any earlier hearing and outcome replaced","payload":["patientId; date as YYYY-MM-DD; optional time as HH:MM; role and now"],"scope":"Ward, community or coordinator in EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; finite now; a real calendar date; a 24-hour time when given"],"effects":["Shown as typed, never a countdown (D-93); a worded flag once the date has passed with no outcome"],"tests":["tests/ward-patient-care-plans.test.ts","tests/ward-event-permissions.test.ts"],"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":81,"sha256":"ebd947f4ec177d0acb998b35f3ebd66d0ac58b777c9a874e20ed3e67203caa1d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":664,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-care-plans.ts","line":149,"sha256":"20f25414be8b4ae5eb1b9cc9eee189ba1ba08b0466b00ee6f7139876b963752f"}]},"reason":"Source-reviewed command model: a Mental Health Tribunal hearing date held on the patient as typed."},{"event":"RECORD_TRIBUNAL_OUTCOME","roles":["ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":665},"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-events.ts","line":33},{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":95}],"status":"modelled","model":{"subject":"A patient record's tribunal hearing","before":"Patient exists with a recorded hearing date","after":"tribunalHearing.outcome holds Held, Adjourned or Cancelled with role and time recorded","payload":["patientId; outcome from TRIBUNAL_OUTCOMES; role and now"],"scope":"Ward, community or coordinator in EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; finite now; a hearing date must be recorded; outcome on the list"],"effects":["Clears the hearing-date-passed flag"],"tests":["tests/ward-patient-care-plans.test.ts","tests/ward-event-permissions.test.ts"],"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":95,"sha256":"ebd947f4ec177d0acb998b35f3ebd66d0ac58b777c9a874e20ed3e67203caa1d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":665,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}]},"reason":"Source-reviewed command model: the outcome of the recorded tribunal hearing, held beside its date."},{"event":"SET_CULTURAL_SUPPORT_REQUEST","roles":["ward","ed","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":666},"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-events.ts","line":41},{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":107}],"status":"modelled","model":{"subject":"A patient record's cultural support request","before":"Patient exists, with or without a request","after":"culturalSupportRequested holds the listed request, or is removed when request is null","payload":["patientId; request from CULTURAL_SUPPORT_REQUESTS or null; role and now"],"scope":"Ward, ED, community or coordinator in EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; finite now; request on the list or null"],"effects":["Never derived from the Aboriginal status field; set only by this event"],"tests":["tests/ward-patient-care-plans.test.ts","tests/ward-event-permissions.test.ts"],"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":107,"sha256":"ebd947f4ec177d0acb998b35f3ebd66d0ac58b777c9a874e20ed3e67203caa1d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":666,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-care-plans.ts","line":168,"sha256":"20f25414be8b4ae5eb1b9cc9eee189ba1ba08b0466b00ee6f7139876b963752f"}]},"reason":"Source-reviewed command model: cultural support the person or family asked for, set or taken off."}],"contractSha256":"e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e18616914ab6","made":{"builtAt":"2026-11-11T03:10:13.402Z","commit":"9a6677af2dc1900f8e7ae08435a2393f844d6c86","branch":"claude/project-thread-bnphlk-clinical","dirty":true,"dirtyCount":12},"refusalCoverage":null};
+      const DATA = {"vocab":{"vocabularies":{"DECLINE_REASONS":{"file":"ward-model.ts","members":["no_suitable_bed","age_band_not_provided_here","sex_designation_unavailable","secure_bed_unavailable","belongs_to_another_service","referred_elsewhere","specialling_unavailable","acuity_mix","capability_mismatch","bed_pulled_for_earlier_referral","another_reason"]},"SUPPORT_SERVICE_TYPES":{"file":"ward-model-bed-release.ts","members":["pharmacy","transport","cleaning"]},"ARRIVAL_CHECKS":{"file":"ward-model-bed-release.ts","members":["contraband_search","medication_chart"]},"BED_RELEASE_STATES":{"file":"ward-model-bed-release.ts","members":["expected","confirmed","discharged"]},"BED_RELEASE_WAITING_ON":{"file":"ward-model-bed-release.ts","members":["Awaiting ward round","Awaiting family or carer agreement","Awaiting accommodation","Awaiting community team acceptance","Awaiting legal or Mental Health Act process","Awaiting transport","Nothing outstanding"]},"HEALTH_SERVICES":{"file":"ward-model-vocabulary.ts","members":["North Metro","South Metro","East Metro","WACHS","CAHS","Private"]},"COHORTS":{"file":"ward-model-vocabulary.ts","members":["Adult","Older adult","Youth"]},"BLOCKERS_MEANING_NOTHING_IS_BLOCKING":{"file":"ward-model-vocabulary.ts","members":["No blocker","None — in transit","None — handover complete","None — the movement did not proceed","None — cleared"]},"SEXES":{"file":"ward-model-vocabulary.ts","members":["Female","Male"]},"RECORDED_SEXES":{"file":"ward-model-vocabulary.ts","members":["Another term","Not recorded"]},"URGENCY_LEVELS":{"file":"ward-model-vocabulary.ts","members":["1","2","3"]},"ATS_CATEGORIES":{"file":"ward-model-vocabulary.ts","members":["1","2","3","4","5"]},"TRAVEL_MODES":{"file":"ward-model-vocabulary.ts","members":["Ambulance (St John)","Mental Health Transport","Patient transport service","RFDS","Police escort","Ward escort","Family or carer"]},"ARRIVAL_MODES":{"file":"ward-model-vocabulary.ts","members":["ambulance","mental_health_transport","hospital_transfer","rfds","police","ward_escort","self"]},"UPLOADED_FILE_TYPES":{"file":"ward-model-vocabulary.ts","members":["PDF","JPEG","PNG","Other"]},"SEX_DESIGNATIONS":{"file":"ward-model-vocabulary.ts","members":["Undesignated","Female only","Male only"]},"REFERRAL_GENDERS":{"file":"ward-model-vocabulary.ts","members":["Female","Male","Non-binary","Different term"]},"MOVEMENT_STAGES":{"file":"ward-model-vocabulary.ts","members":["placement_requested","destination_review","accepted_awaiting_bed","pulled","handover_ready","moving","arrived"]},"STEP_BACK_REASONS":{"file":"ward-model-vocabulary.ts","members":["recorded_in_error","the_decision_changed","the_patient_situation_changed","the_bed_was_lost"]},"PAPER_EXPIRY_CORRECTION_REASONS":{"file":"ward-model-vocabulary.ts","members":["transcription_error","paper_rechecked"]},"LEGAL_FORM_MAKER_ROLES":{"file":"ward-model-vocabulary.ts","members":["medical_practitioner","amhp","psychiatrist","mental_health_practitioner","person_in_charge"]},"LEGAL_FORM_COPY_STATES":{"file":"ward-model-vocabulary.ts","members":["yes","declined","not_yet"]},"LEGAL_FORM_ENDINGS":{"file":"ward-model-vocabulary.ts","members":["revoked","form_3e","replaced","ended_as_typed"]},"LEGAL_FORM_CONSENT_STATES":{"file":"ward-model-vocabulary.ts","members":["yes","not_yet"]},"TRANSPORT_PROVIDERS":{"file":"ward-model-movement-parts.ts","members":["Ambulance service"]},"TRANSPORT_LEGAL_STATUSES":{"file":"ward-model-movement-parts.ts","members":["voluntary","involuntary"]},"TRANSPORT_EXCEPTION_GAPS":{"file":"ward-model-movement-parts.ts","members":["legal_status_differs","transport_order_missing","fit_to_travel_missing"]},"TRANSPORT_EXCEPTION_REASONS":{"file":"ward-model-movement-parts.ts","members":["paper_sighted","treating_team_confirmed","urgent_to_follow"]},"MOVEMENT_REFERRAL_ABSENCE_REASONS":{"file":"ward-model-movement-parts.ts","members":["none_raised","not_asked"]},"EXAMINATION_OUTCOMES":{"file":"ward-model-movement-parts.ts","members":["inpatient_order","community_order","revoked","further_examination_ordered"]},"PSYCH_REVIEW_GRADES":{"file":"ward-model-movement-parts.ts","members":["registrar","consultant"]},"ED_OUTCOMES":{"file":"ward-model-movement-parts.ts","members":["for_discharge","for_community_follow_up"]},"REFERRAL_SOURCES":{"file":"ward-model-referral-parts.ts","members":["community","crisis_service","ambulance","inter_hospital","ed_medical","gp","psychiatric_ward"]},"REFERRAL_STATES":{"file":"ward-model-referral-parts.ts","members":["queued","accepted","declined"]},"COMMUNITY_DECLINE_REASONS":{"file":"ward-model-referral-parts.ts","members":["outside_the_teams_catchment","needs_inpatient_care_not_community_follow_up","client_declined_or_could_not_be_contacted","already_open_to_another_community_team"]},"HOME_REGIONS":{"file":"ward-model-referral-parts.ts","members":["Perth Metropolitan","Peel","South West","Great Southern","Wheatbelt","Goldfields-Esperance","Mid West","Gascoyne","Pilbara","Kimberley"]},"REFERRAL_DESTINATION_KINDS":{"file":"ward-model-referral-parts.ts","members":["psychiatric_ward","emergency_department","community_team"]},"REFERRAL_PURPOSES":{"file":"ward-model-referral-parts.ts","members":["bed","psychiatric_review","medical_assessment"]},"COMMUNITY_REFERRAL_PURPOSES":{"file":"ward-model-referral-parts.ts","members":["follow_up","assess_for_admission"]},"REFERRAL_ADDRESSING_STATES":{"file":"ward-model-referral-parts.ts","members":["queued","accepted","declined","cancelled"]},"SUBURB_UNKNOWN_REASONS":{"file":"ward-model-referral-parts.ts","members":["not_known"]},"ABSENCE_STEPS":{"file":"ward-model-leave.ts","members":["searched","psychiatrist_told","return_order_made","description_recorded","police_notified","next_of_kin_told"]},"URGENCY_CHANGE_REASONS":{"file":"ward-change-reasons.ts","members":["reassessed","new_information","correcting_an_error"]},"LEGAL_STATUS_CHANGE_REASONS":{"file":"ward-change-reasons.ts","members":["recorded_by_treating_team","correcting_an_error"]},"LEGAL_FORM_RECEIPT_CORRECTION_REASONS":{"file":"ward-change-reasons.ts","members":["recorded_in_error","recorded_against_wrong_movement","form_had_not_physically_arrived"]},"RELEASE_PULL_REASONS":{"file":"ward-change-reasons.ts","members":["patient_no_longer_coming","bed_needed_for_another_patient","ward_withdrew_the_bed","pull_made_in_error"]},"CANCEL_TRANSPORT_REASONS":{"file":"ward-change-reasons.ts","members":["provider_unavailable","patient_not_ready","destination_changed","job_created_in_error"]},"STOP_TRANSPORT_REASONS":{"file":"ward-change-reasons.ts","members":["The examination was revoked","The referral was withdrawn","The receiving ward can no longer take the patient","Absconded in transit, whereabouts unknown"]},"TRANSPORT_WHEREABOUTS":{"file":"ward-change-reasons.ts","members":["Back at the sending emergency department","At another emergency department","At a general hospital","With the transport crew","Another place — needs follow-up"]},"DIVERSION_REASONS":{"file":"ward-change-reasons.ts","members":["Needs urgent medical care on the way","The vehicle or crew was sent to an emergency","The receiving ward can no longer take the patient","Another reason — needs follow-up"]},"ESCALATION_CONTACTS":{"file":"ward-change-reasons.ts","members":["State bed coordination desk","Duty psychiatrist","Bed management","Nurse unit manager (destination ward)","Escort or transport provider","Other service"]},"BED_RELEASE_BLOCKERS":{"file":"ward-change-reasons.ts","members":["Awaiting clean","Awaiting pharmacy","Awaiting placement confirmation","Awaiting service coordination","Awaiting accommodation","Awaiting transport","Awaiting receiving-service acceptance","Awaiting family or carer arrangement","Funding or plan decision pending"]},"WITHDRAWAL_REASONS":{"file":"ward-change-reasons.ts","members":["another_unit_accepted","referrer_withdrew","coordinator_withdrew","ed_outcome_recorded"]},"WARD_REQUEST_WITHDRAWAL_REASONS":{"file":"ward-change-reasons.ts","members":["no_answer_from_the_ward","bed_no_longer_available","needs_changed_ward_no_longer_suits","closer_to_home_or_family_elsewhere","making_room_within_the_referral_limit","referred_in_error","another_reason"]},"OVERRIDE_REASONS":{"file":"ward-change-reasons.ts","members":["The receiving team has agreed despite the mismatch","Clinical urgency outweighs the mismatch","The bed information is known to be out of date","Continuity with a previous admission at this unit","Closer to the person's home or family"]},"REFERRAL_CAP_REASONS":{"file":"ward-change-reasons.ts","members":["No answer yet from the wards already asked","Clinical urgency needs a wider search","The wards already asked are unlikely to have a bed soon"]},"NOT_ON_SENDING_WARD_REASONS":{"file":"ward-change-reasons.ts","members":["Recently discharged from this ward","Known to this ward's team but not in a bed"]},"BED_PREPARATION_NOTES":{"file":"ward-change-reasons.ts","members":["Being cleaned","Awaiting maintenance or repair"]},"GENDER_PLACEMENT_REASONS":{"file":"ward-change-reasons.ts","members":["A single room is available on this ward","The patient's stated preference, agreed with the ward","No single room is free; the ward agreed a bed and a plan for privacy","The only suitable Ready bed, agreed with the ward","The patient knows this ward from an earlier stay","Closer to the patient's home or supports"]},"URGENT_MARK_REASONS":{"file":"ward-change-reasons.ts","members":["cannot_safely_prevent_leaving","cannot_be_observed_safely_here","safety_of_others_in_this_setting","no_psychiatric_cover_at_this_site","needs_medical_care_unavailable_here","escort_in_place_and_unsustainable","cannot_protect_from_others_here","setting_unsuitable_for_age_group","this_setting_cannot_continue_current_care","another_reason_not_listed"]},"WARD_INTAKE_CONSTRAINTS":{"file":"ward-change-reasons.ts","members":["staffing_shortage","infection_control","bay_or_room_closed","high_acuity_on_ward","waiting_for_bed_clean","other_call_the_ward"]},"DISCHARGE_DELAY_CLEAR_REASONS":{"file":"ward-change-reasons.ts","members":["resolved_clinically","package_confirmed","accommodation_secured","transport_arranged","family_carer_ready","entered_in_error","other"]},"ADMISSION_STATES":{"file":"ward-admissions.ts","members":["waitlisted","pulled","occupied","departed"]},"FOLLOW_UP_STATES":{"file":"ward-admissions.ts","members":["arranged","not_arranged"]},"DISCHARGE_BARRIERS":{"file":"ward-admissions.ts","members":["Accommodation / Housing","NDIS","SAT / Public Guardian","RACF / Aged Care","Clinical / Treatment","Social / Family","Several"]},"DISCHARGE_ROLE_LABELS":{"file":"ward-admissions.ts","members":["Nurse in charge"]},"PLANNED_ADMISSION_REASONS":{"file":"ward-admissions.ts","members":["court_ordered","planned_ect","respite","planned_transfer","other"]},"PLANNED_ADMISSION_CANCEL_REASONS":{"file":"ward-admissions.ts","members":["no_longer_needed","admitted_elsewhere","rebooked","booked_in_error"]},"PLANNED_ADMISSION_STATES":{"file":"ward-admissions.ts","members":["booked","cancelled","arrived"]},"RELEASE_BANDS":{"file":"ward-bed-availability.ts","members":["now","by-midday","by-1600","tonight","tomorrow"]},"GENDERS":{"file":"ward-patients.ts","members":["Female","Male","Non-binary","Different term"]},"PATIENT_FIELDS":{"file":"ward-patients.ts","members":["id","umrn","givenName","familyName","dateOfBirth","preferredName","sex","gender","address","suburb","generalPractitioner","catchmentCommunityTeam","legalStatus","aboriginalOrTorresStraitIslanderStatus","interpreterLanguage","communityTreatmentOrder","addedAt","registrationScope","mobilePhone","otherPhone","email","postcode","nextOfKinName","nextOfKinRelationship","nextOfKinPhone","supportPersonRole","supportPersonName","supportPersonPhone","medicareNumber","medicareReference","medicareExpiry","dvaFileNumber","healthFund","concessionCard","gpPhone","countryOfBirth","interpreterRequired","maritalStatus","advanceHealthDirective","enduringGuardian","carePlans","tribunalHearing","culturalSupportRequested"]},"ELIGIBILITY_GATES":{"file":"ward-eligibility.ts","members":["acuity","age","allocatable_bed","authorisation","capacity_freshness","cohort","forensic","legal_status","prior_decline","security","gender_designation","sex_mix","specialling"]},"CARE_PLAN_TYPES":{"file":"ward-patient-care-plans.ts","members":["Crisis/safety plan","Frequent presenter plan","Community care plan","Other"]},"CARE_PLAN_HELPS":{"file":"ward-patient-care-plans.ts","members":["Quiet space","Known staff member","Family or carer involved early","Clear plan explained","Interpreter","Cultural support","Contact the community team"]},"TRIBUNAL_OUTCOMES":{"file":"ward-patient-care-plans.ts","members":["Held","Adjourned","Cancelled"]},"CULTURAL_SUPPORT_REQUESTS":{"file":"ward-patient-care-plans.ts","members":["Aboriginal liaison officer","Other cultural support"]}},"labels":{"stepBackReasonLabels":{"recorded_in_error":"Recorded in error","the_decision_changed":"The decision changed","the_patient_situation_changed":"The situation changed","the_bed_was_lost":"The bed was lost"},"suburbUnknownLabels":{"not_known":"Suburb not known"},"legalFormReceiptCorrectionReasonLabels":{"recorded_in_error":"Recorded in error","recorded_against_wrong_movement":"Recorded against the wrong movement","form_had_not_physically_arrived":"Form had not physically arrived"},"withdrawalReasonLabels":{"another_unit_accepted":"Withdrawn — another unit accepted this patient.","referrer_withdrew":"Withdrawn by the referrer.","coordinator_withdrew":"Withdrawn by the coordinator.","ed_outcome_recorded":"Withdrawn — the department recorded an outcome for this patient."},"wardRequestWithdrawalReasonLabels":{"no_answer_from_the_ward":"No answer from the ward yet","bed_no_longer_available":"The bed is no longer available","needs_changed_ward_no_longer_suits":"Needs have changed; this ward no longer suits","closer_to_home_or_family_elsewhere":"Closer to home or family elsewhere","making_room_within_the_referral_limit":"Making room within the referral limit","referred_in_error":"Referred in error","another_reason":"Another reason — needs follow-up"},"changeReasonLabels":{"cannot_be_observed_safely_here":"Cannot be observed safely here","no_psychiatric_cover_at_this_site":"No psychiatric cover at this site","cannot_safely_prevent_leaving":"Cannot safely prevent leaving","needs_medical_care_unavailable_here":"Needs medical care unavailable here","safety_of_others_in_this_setting":"Safety of others in this setting","escort_in_place_and_unsustainable":"Escort in place and unsustainable","cannot_protect_from_others_here":"Cannot protect from harm by others here","setting_unsuitable_for_age_group":"No age-appropriate area here","this_setting_cannot_continue_current_care":"This setting cannot continue current care","another_reason_not_listed":"Another reason, not listed here","reassessed":"Reassessed","new_information":"New information","correcting_an_error":"Correcting an error","not_given":"No reason given","recorded_by_treating_team":"Recorded by treating team","patient_no_longer_coming":"No longer coming","bed_needed_for_another_patient":"Bed needed elsewhere","ward_withdrew_the_bed":"Ward withdrew the bed","pull_made_in_error":"Pull made in error","provider_unavailable":"Provider unavailable","patient_not_ready":"Not yet ready","destination_changed":"Destination changed","job_created_in_error":"Job created in error"},"wardIntakeConstraintLabels":{"staffing_shortage":"Staffing shortage","infection_control":"Infection control","bay_or_room_closed":"Bay or room closed","high_acuity_on_ward":"High acuity on the ward","waiting_for_bed_clean":"Waiting for a bed to be cleaned","other_call_the_ward":"Other — call the ward"}}},"actions":[{"event":"RECEIVE_REFERRAL","name":"Raise a referral at the front door","group":"At the front door","lane":"expected","nodes":["raised","addressed","armCommunity","armWard","armEd","srcCommunity","srcCrisis","srcPolice","srcAmbulance","srcHospital","srcEd","srcGp"],"roles":["community","ed","ward","coordinator"],"does":"Creates a front-door referral to the chosen destinations, bounded by the configured parallel-referral cap. Distinct named wards may be asked together; duplicate recipients and a broad ward arm mixed with named ward arms are refused.","needs":"A known patient and source, valid destination/intake answers and a unique submission id when supplied. An ED uses ed_medical; a ward uses psychiatric_ward and its own origin ward, and must carry that ward's site. Form rule (design audit FORM-REF, 5 Nov 2026): the home region may be left out (it warns in the drawer and shows as not recorded), and the engine also accepts a referral with no origin site, though the drawer fills an ED or community referral's location and referring service from the sending desk and blocks Send when it cannot (Josh, 5 Nov 2026); one that is given must be listed, and a supplied originSiteCode must resolve in the world's state.scenario network, including a fictional-network scenario. The intake may carry an unconfirmed catchment, a pending clearance with no expected time or contact, and blank referrer contact details, but a referrer phone that is typed must be a phone number (digits and the form's own characters; audit M39, 10 Nov 2026); the legal status, clearance answer, age band, urgency and gender still block in the drawer.","changes":"Creates the referral with every destination set to waiting.","reasons":["COHORTS","REFERRAL_DESTINATION_KINDS","REFERRAL_PURPOSES","SEXES","REFERRAL_GENDERS","REFERRAL_SOURCES","HOME_REGIONS"],"refuses":[{"when":"Guard: event.destinations.length === 0","message":"RECEIVE_REFERRAL needs at least one destination","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":381}},{"when":"Guard: event.destinations.length > state.configuration.parallelReferralCap","message":"RECEIVE_REFERRAL may address at most ${state.configuration.parallelReferralCap} destinations, not ${event.destinations.length}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":387}},{"when":"Guard: new Set(recipientKeys).size !== recipientKeys.length || (broadWard && kinds.filter((kind) => kind === \"psychiatric_ward\").length > 1)","message":"RECEIVE_REFERRAL cannot address the same destination kind twice","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":405}},{"when":"Guard: !scenarioEmergencyDepartments(state.scenario).some((department) => department.id === edDestination.edId)","message":"RECEIVE_REFERRAL edId must resolve to a real emergency department","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":419}},{"when":"Guard: event.role === \"ed\" && event.source !== \"ed_medical\"","message":"RECEIVE_REFERRAL raised as role ed must carry source ed_medical, not ${event.source}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":482}},{"when":"Guard: event.source === \"ed_medical\" && !originSite.emergencyDepartment","message":"RECEIVE_REFERRAL source ed_medical requires an origin site with an emergency department","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":546}}],"screen":{"screen":"use-ward-referral-drawer-state.ts (+ command completion helper)","control":"Send referral A recoverable draft keeps one submission id, so reopening the sheet after an uncertain send reconciles that same submission instead of minting another referral."},"review":{"reviewedOn":"2026-11-10","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":391,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":362,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/referrals/use-ward-referral-drawer-state.ts","line":997,"sha256":"d97d86918bafd69a286053ba13087a5b9809f740ca07d7ab3106e0f044275909"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":386,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":392,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":410,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":424,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":487,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":551,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"ADD_PATIENT","name":"Add a person who is not on file","group":"At the front door","lane":"record","nodes":["raised","rkDuplicate","rkIntakeLost"],"roles":["ed","community","ward","coordinator"],"does":"Registers somebody with no referral, movement or bed record yet — the “searched, nobody came up, so add them” record.","needs":"A unique nonblank UMRN, given and family names, a real date of birth from 1900 through the applicable Perth day, and valid optional sex, gender, Indigenous-status and source-desk values. Optional preferred name, address, general practitioner, catchment community team, interpreter language and the 22 optional administrative details (ADMIN_DETAIL_FIELDS: contacts, next of kin and support person, Medicare and funding, planning) are trimmed; blank means not recorded.","changes":"Creates a new patient record, including any optional typed details given.","reasons":["GENDERS"],"refuses":[{"when":"Gender not from the list","message":"ADD_PATIENT gender must be chosen from GENDERS"}],"screen":{"screen":"add-patient.tsx (+1 other)","control":"Add patient"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":395,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-registration-reducer.ts","line":37,"sha256":"9e0f9c39d6d4a7f8f406fd438e09cd9ea7b7c6631a7bdd5e059d1f38de3caac4"},{"path":"src/components/ward-management/patients/add-patient.tsx","line":614,"sha256":"fc5752f90ad948491ad836c940e4eb1571aba082c71cee36e4e6083afdf78002"},{"path":"src/components/ward-management/referrals/use-referral-command-completion.ts","line":426,"sha256":"4dc5c8e0880f6118448453f12bb3df5c80ec20db2762669c955b2de29bae2feb"}]}},{"event":"RECORD_MEDICAL_CLEARANCE","name":"Record whether they are medically cleared","group":"At the front door","lane":"record","nodes":["addressed","rkClearance","edArrived"],"roles":["ed","coordinator"],"does":"Records the current medical-clearance answer on a referral and synchronises its matching linked movements. Fresh positive clearance resumes a recorded medical-deterioration pause.","needs":"An existing referral, finite recording time and boolean answer. Re-clearance must be later than any unresolved linked deterioration.","changes":"Replaces the referral answer and the matching movements’ clearance. Positive re-clearance stamps resumedAt and restates their blocker; it does not restore a released bed or booking.","reasons":[],"refuses":[{"when":"Guard: !referral","message":"no referral found for id ${event.referralId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":165}},{"when":"Current handler guard; inspect the cited source for its full condition","message":"Re-clearance must be recorded after the medical deterioration.","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":178}}],"screen":{"screen":"ed/ed-lists-desktop.tsx","control":"Record medically cleared"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":39,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":167,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-lists-desktop.tsx","line":186,"sha256":"ffc826779fff9455a88d5d6613c00d692ecdb7933bf87882fe31bcc756c16eb9"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":169,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":182,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_ARRIVED_IN_DEPARTMENT","name":"Mark that an expected patient has turned up","group":"At the front door","lane":"record","nodes":["addressed","edExpected","edArrived","edNeverArrives"],"roles":["ed","coordinator"],"does":"Marks that a patient the department was expecting has physically arrived.","needs":"The referral exists. The first recorded arrival wins; a later call leaves it unchanged rather than taking the minimum supplied timestamp.","changes":"Stamps the arrival time, once.","reasons":[],"refuses":[{"when":"Guard: !referral","message":"no referral found for id ${event.referralId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":214}}],"screen":{"screen":"ed/ed-lists-desktop.tsx","control":"Mark arrived in department"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":43,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":216,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-lists-desktop.tsx","line":366,"sha256":"ffc826779fff9455a88d5d6613c00d692ecdb7933bf87882fe31bcc756c16eb9"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":218,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"ACCEPT_REFERRAL","name":"Accept the referral","group":"At the front door","lane":"expected","nodes":["wardAnswers","wardAccepted","othersCancelled","cmhtAnswers","cmhtAccepted","edAnswers","edAccepted","cmhtNothing","wardBlocked","dForced","dNonBinary"],"roles":["ward","coordinator","ed","community"],"does":"A ward, emergency department or community team says yes to the destination addressed to it. The first yes automatically cancels every other destination still waiting — except a community arm, which never competes for the bed.","needs":"The destination was addressed to the acting desk and has not been withdrawn. Normally it is queued. An explicit reassessment can turn a decline into acceptance; updates on an already accepted arm add history rather than accepting twice. Ward eligibility and bed criteria still apply. At the shared authenticated boundary, a scoped caller must be authorised for the stored receiving ED or community team (including a community team in its scoped service); outbound visibility alone does not authorise the answer. The statewide coordinator retains whole-network authority. On the referral match screen the coordinator answers any arm and a desk answers only its own kind; a ward desk answers only when working in a ward scope, dispatching as ward with its acting ward.","changes":"Marks that destination accepted, cancels the other waiting non-community destinations, notifies the referrer and the receiving ward. No bed is pulled and no movement is created.","reasons":["GENDER_PLACEMENT_REASONS","OVERRIDE_REASONS"],"override":true,"refuses":[{"when":"Guard: !addressing","message":"referral ${referral.id} was not addressed to ${event.destinationKind.replace(/_/g, \" \")}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":805}},{"when":"Guard: event.destinationKind !== \"community_team\" && referralState(referral) === \"accepted\" && !(hasClinicalReassessment && addressing.state === \"accepted\")","message":"referral ${referral.id} has already been accepted elsewhere","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":836}},{"when":"Guard: addressing.state !== \"queued\" && !( (hasClinicalReassessment && addressing.state === \"accepted\") || (event.reassessment === true && addressing.state === \"declined\") )","message":"${event.destinationKind.replace(/_/g, \" \")} has already answered referral ${referral.id} (${addressing.state})","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":852}},{"when":"Guard: addressing.withdrawnAt !== undefined","message":"referral ${referral.id} was withdrawn by its referrer, so ${event.destinationKind.replace(/_/g, \" \")} cannot accept it","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":863}},{"when":"Guard: openLinkedMovement","message":"referral ${referral.id} already has an open movement (${openLinkedMovement.id}); it cannot also be accepted into a ward while that movement is open","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":941}},{"when":"Guard: !event.unitId","message":"ACCEPT_REFERRAL into a psychiatric ward must name a unit","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":946}}],"screen":{"screen":"referral-match.tsx (+1 other)","control":"Accept at the named ward"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":427,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":745,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/community/community-screen.tsx","line":589,"sha256":"4cce4397ba7d06901141717dd89e58cf12315dc45e90f35604b527e6cebf5671"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1351,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/referrals/referral-match.tsx","line":421,"sha256":"12f313fd1b9c2dcfa081b3f54ce46a20ee163651084afcc31bdceeae335ea044"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":813,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":844,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":860,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":871,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":949,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":954,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"DECLINE_REFERRAL","name":"Decline the referral","group":"At the front door","lane":"stall","nodes":["wardAnswers","wardDeclined","cmhtAnswers","cmhtDeclined","edAnswers","edDeclined","cmhtNothing"],"roles":["ward","coordinator","ed","community"],"does":"Records the destination’s answer. A substantive decline closes that arm; bed-unavailable reasons on a ward arm waitlist it and keep it live. Gender mismatch is not a decline reason.","needs":"A known addressed destination, matching desk kind/place and a valid reason. Re-answering a decided arm requires the documented reassessment path. At the shared authenticated boundary, a scoped caller must be authorised for the stored receiving ED or community team (including a community team in its scoped service); outbound visibility alone does not authorise the answer. The statewide coordinator retains whole-network authority. On the referral match screen the coordinator answers any arm and a desk answers only its own kind; a ward desk answers only when working in a ward scope, dispatching as ward with its acting ward.","changes":"Records a decline or waitlist history entry and the corresponding notices, retaining other arms.","reasons":["REFERRAL_DECLINE_REASONS","COMMUNITY_DECLINE_REASONS"],"refuses":[{"when":"Guard: event.destinationKind !== \"community_team\" && referralState(referral) === \"accepted\"","message":"referral ${referral.id} has already been accepted elsewhere","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1187}},{"when":"Guard: addressing.withdrawnAt !== undefined","message":"referral ${referral.id} was withdrawn by its referrer, so ${event.destinationKind.replace(/_/g, \" \")} cannot decline it","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1202}},{"when":"Guard: !declineReasonsFor[event.destinationKind].includes(event.reason)","message":"DECLINE_REFERRAL reason must be chosen from ${declineReasonListName[event.destinationKind]}, the vocabulary for ${event.destinationKind.replace(/_/g, \" \")} destinations","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1227}}],"screen":{"screen":"referral-match.tsx (+2 others)","control":"Decline referral"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":439,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1141,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/community/community-screen.tsx","line":529,"sha256":"4cce4397ba7d06901141717dd89e58cf12315dc45e90f35604b527e6cebf5671"},{"path":"src/components/ward-management/ed/use-ed-screen-decline.ts","line":135,"sha256":"ff7e1679d14d0e040af8cfa6bf07805d7c1bffc9cf8cf7a0d055fedc5f4862fd"},{"path":"src/components/ward-management/referrals/referral-match.tsx","line":466,"sha256":"12f313fd1b9c2dcfa081b3f54ce46a20ee163651084afcc31bdceeae335ea044"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1195,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1210,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1235,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"RECORD_REFERRER_WITHDRAWAL","name":"The referrer takes the referral back","group":"At the front door","lane":"stall","nodes":["wardAnswers","cmhtWithdrawn","wardNothing","cmhtNothing","wardWithdrawn"],"roles":["coordinator","community","ed","ward"],"does":"The referring party withdraws — either just the community half, leaving the bed request standing, or the whole referral, which also gives back any held bed and cancels any transport.","needs":"The recorded sender desk/place or coordinator. Whole-referral withdrawal requires waiting non-withdrawn arms and no accepted placement or collected linked journey. The separately scoped community-arm path has its own reason and state checks.","changes":"Stamps the withdrawal on every still-waiting destination; closes any linked open movement as “did not proceed”.","reasons":["WARD_REQUEST_WITHDRAWAL_REASONS"],"refuses":[{"when":"Guard: event.reason === undefined || !WARD_REQUEST_WITHDRAWAL_REASONS.includes(event.reason)","message":"RECORD_REFERRER_WITHDRAWAL scoped to community_team must give a reason from WARD_REQUEST_WITHDRAWAL_REASONS","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":943}},{"when":"Guard: referralState(referral) === \"accepted\"","message":"referral ${referral.id} has already been accepted, so it cannot be withdrawn","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":982}},{"when":"Guard: referral.destinations.some( (addressing) => addressing.destination.kind !== \"community_team\" && addressing.withdrawnAt !== undefined, )","message":"referral ${referral.id} has already been recorded as withdrawn by its referrer","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":989}},{"when":"Guard: waiting.length === 0","message":"every destination on referral ${referral.id} has already answered","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":999}},{"when":"Guard: collectedLinkedMovement","message":"referral ${referral.id} is linked to movement ${collectedLinkedMovement.id}, whose transport has already been collected; this needs a coordinator decision (see STOP_TRANSPORT) rather than an automatic withdrawal","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1020}}],"screen":{"screen":"referral-match.tsx","control":"Withdraw referral to community team"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":477,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":801,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/referrals/use-referral-match-state.tsx","line":202,"sha256":"5c100c488ba449b9b76e099dfa98e04a34fa726d633e9fa56b592c125f01344b"},{"path":"src/components/ward-management/referrals/referral-match.tsx","line":556,"sha256":"12f313fd1b9c2dcfa081b3f54ce46a20ee163651084afcc31bdceeae335ea044"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":897,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":936,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":943,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":953,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":974,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"ADD_REFERRAL_CORRECTION","name":"Add a correction to a referral","group":"At the front door","lane":"record","nodes":["wardAnswers","addressed"],"roles":["community","ed","ward","coordinator"],"does":"Adds a dated, attributed note correcting something on a referral, at any point in its life. What was said before stays readable.","needs":"An existing referral and a nonblank note within the correction limit. It can be at any stage, but sender-kind/place restrictions apply to ward, ED and community desks.","changes":"Appends the note. Never overwrites.","reasons":[],"refuses":[{"when":"Guard: note.length === 0","message":"ADD_REFERRAL_CORRECTION note must say something — a blank is not a correction","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1209}},{"when":"Guard: note.length > REFERRAL_CORRECTION_NOTE_MAX_CHARACTERS","message":"ADD_REFERRAL_CORRECTION note is ${note.length} characters and the limit is ${REFERRAL_CORRECTION_NOTE_MAX_CHARACTERS} — it is refused rather than shortened","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1217}}],"screen":{"screen":"referrals/referral-history-corrections.tsx","control":"Add a correction"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":484,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1124,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/referrals/referral-history-corrections.tsx","line":73,"sha256":"da6432d4f3190b3305d3890162266ab68e46e2bd8a8bd22649fc91ff66499107"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1159,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1167,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"RECORD_LOCAL_BED_SOUGHT","name":"Record that a bed closer to home was looked for","group":"At the front door","lane":"record","nodes":["wardAnswers","addressed"],"roles":["coordinator"],"does":"Records that somebody looked for a bed nearer the person's home before sending them further. It never gates an acceptance — it exists so the search can be shown to have happened.","needs":"The referral is still undecided and no earlier local-bed search is already recorded.","changes":"Stamps the search and who did it.","reasons":[],"refuses":[{"when":"Guard: referralState(referral) !== \"queued\"","message":"referral ${referral.id} was already decided (${referralState(referral)})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1107}},{"when":"Guard: referral.localBedSought !== undefined","message":"referral ${referral.id} already records a local bed search","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1112}}],"screen":{"screen":"referral-match.tsx","control":"Record that a local bed was sought and none was suitable"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":445,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1045,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/referrals/referral-match.tsx","line":447,"sha256":"12f313fd1b9c2dcfa081b3f54ce46a20ee163651084afcc31bdceeae335ea044"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1052,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1057,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RAISE_REFERRAL","name":"Start a bed search from a department","group":"Finding a bed","lane":"expected","nodes":["seam","placement","edRaise"],"roles":["ed","community","ward","coordinator"],"does":"Creates the movement that tracks placement. An ED journey may link its addressed referral; an accepting ward or coordinator may continue an accepted direct ED/community referral. pullBed requests an atomic raise-and-pull through both ordinary checks.","needs":"Valid draft facts and a real ED unless continuing an accepted direct community referral. A linked referral and destination must match, be live and fund no other open movement; direct continuation has its own accepting-ward checks. A community continuation needs its referring service and location on the referral (the drawer fills them from the sending desk and blocks Send without them) and is refused without either, never starting at an empty site. A supplied patientId, or one inherited from the linked referral, must still name a current patient; an omitted identity remains supported.","changes":"Creates a placement_requested movement, or accepted_awaiting_bed for a valid direct continuation. Captures typed legal-paper facts; pullBed also reserves the bed only when both steps succeed.","reasons":["REFERRAL_GENDERS"],"refuses":[{"when":"Guard: !raisedFrom","message":"RAISE_REFERRAL referralId must name a referral this system already holds, and ${event.referralId} names none","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":161}},{"when":"Guard: !addressing","message":"referral ${referral.id} was never addressed to ${department?.name ?? \"this ward\"}, so a journey raised there did not come from it","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":229}},{"when":"Guard: addressing.withdrawnAt !== undefined","message":"referral ${referral.id} was withdrawn by its referrer, so no journey can be raised from it","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":241}},{"when":"Guard: addressing.state === \"declined\"","message":"${department?.name ?? \"This ward\"} declined referral ${referral.id}, so no journey can be raised from it","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":251}},{"when":"Guard: blockingLinkedMovement","message":"referral ${referral.id} already has a linked movement (${blockingLinkedMovement.id}) that did not close as \"did not proceed\"; a second journey cannot be raised while it stands","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":270}}],"screen":{"screen":"ed-screen.tsx","control":"Ask for a bed"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":37,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":92,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward/ward-accepted-referral-placement-form.tsx","line":100,"sha256":"09fa59dfc3618d8943dcf23a008c14b4747a9a1deae31e892a762db3808f8c4f"},{"path":"src/components/ward-management/ed/ed-screen.tsx","line":333,"sha256":"c4987128df9afd2b09fe2bd0636cfa523fa2fae4bf693c0b58e6c78a16144a9f"},{"path":"src/components/ward-management/referrals/pull-accepted-referral.tsx","line":133,"sha256":"e7628cba7f522dcaab9c9b1c7091518dfc979f1178a7e44d3d93d1555926976f"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":160,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":216,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":228,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":238,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":257,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"REFER_TO_UNITS","name":"Ask one or more wards","group":"Finding a bed","lane":"expected","nodes":["asked","dForced"],"roles":["coordinator"],"does":"Adds new wards to an open placement request without dropping live requests. The configured cap warns and records an over-cap act; it does not prohibit asking more wards.","needs":"An open referrable stage, real new wards, valid optional reasons, eligibility and any required recorded gender-placement check. Already-live wards are not rechecked or counted twice.","changes":"Adds those wards to the live list and moves the record to destination review.","reasons":["OVERRIDE_REASONS","GENDER_PLACEMENT_REASONS"],"override":true,"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":707}},{"when":"Guard: movement.closure","message":"cannot refer a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":709}},{"when":"Guard: !REFERRABLE_MOVEMENT_STAGES.includes(movement.stage)","message":"cannot refer a movement at its current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":729}},{"when":"Guard: unknown","message":"no unit found for id ${unknown}","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":734}}],"screen":{"screen":"shortlist-panel.tsx","control":"Refer"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":85,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":675,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/capacity/step-down-board.tsx","line":48,"sha256":"d40940bff7a00cac5ae44bf3b2dfb7a8894e9578bf624275b4bb2fb8fe4d7fc0"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":316,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/coordinator/shortlist-panel.tsx","line":843,"sha256":"d4037bcfbce9686478d640bc8f19fba727986518c4d49cede83ee6c9748d65cb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":677,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":679,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":699,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":704,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"ACCEPT_IN_PRINCIPLE","name":"A ward accepts in principle","group":"Finding a bed","lane":"expected","nodes":["inPrinciple","dForced","dGenderHard"],"roles":["ward","coordinator"],"does":"A ward formally accepts the patient and becomes the destination. Every other ward asked is withdrawn automatically. Still no bed is set aside.","needs":"An open movement at destination_review, a live request to the acting ward, no earlier acceptance, current ward availability and eligibility. A supplied bed number must be valid, suitable and neither occupied nor held; required gender/override records must exist.","changes":"Records the accepting ward, clears every other live request, and tells the referring department.","reasons":[],"override":true,"refuses":[{"when":"Guard: movement.closure","message":"cannot accept a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":114}},{"when":"Guard: movement.acceptedUnitId","message":"movement ${movement.id} is already accepted at ${already?.name ?? movement.acceptedUnitId}; the referral to ${attemptedUnit?.name ?? event.unitId} was withdrawn","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":122}},{"when":"Guard: movement.stage !== \"destination_review\"","message":"cannot accept a movement at its current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":129}},{"when":"Guard: !movement.referredUnitIds.includes(event.unitId)","message":"${event.unitId} does not hold a live referral for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":133}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Accept in principle"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":86,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":108,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1313,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward/ward-answer-view.tsx","line":469,"sha256":"fb9fd5b92aaf4cac6a3397267e1dff8062ed70bbc9333b6476a77663ae83b37c"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":295,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":114,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":122,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":129,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":133,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"DECLINE","name":"A ward declines the bed search","group":"Finding a bed","lane":"stall","nodes":["sWardDecline"],"roles":["ward","coordinator"],"does":"A ward records a substantive decline or a bed-unavailable waitlist answer. A waitlist keeps the ward request live; gender mismatch does not decline it.","needs":"The record is at destination review and this ward holds a live request.","changes":"A substantive decline removes that ward and appends history and a referrer notice. A waitlist keeps the request, records waitlisted history and notifies the referrer; the stage remains destination_review.","reasons":["DECLINE_REASONS"],"refuses":[{"when":"Guard: movement.stage !== \"destination_review\"","message":"cannot decline at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":254}},{"when":"Guard: !movement.referredUnitIds.includes(event.unitId)","message":"${event.unitId} does not hold a live referral for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":258}},{"when":"Guard: !DECLINE_REASONS.includes(event.reason) && !Object.hasOwn(LEGACY_DECLINE_REASONS, event.reason)","message":"DECLINE reason must be chosen from DECLINE_REASONS","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":309}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Confirm decline"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":91,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":240,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1404,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward/ward-answer-view.tsx","line":402,"sha256":"fb9fd5b92aaf4cac6a3397267e1dff8062ed70bbc9333b6476a77663ae83b37c"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":254,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":258,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":312,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"WITHDRAW_WARD_REQUEST","name":"Take back one ward's request","group":"Finding a bed","lane":"stall","nodes":["asked","sWithdrawWard"],"roles":["coordinator"],"does":"Withdraws the request from one named ward only. Every other ward asked carries on considering.","needs":"That ward holds a live request.","changes":"Removes that one ward and tells it why.","reasons":["WARD_REQUEST_WITHDRAWAL_REASONS"],"refuses":[{"when":"Guard: !movement.referredUnitIds.includes(event.unitId)","message":"${event.unitId} does not hold a live referral for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1132}},{"when":"Guard: !WARD_REQUEST_WITHDRAWAL_REASONS.includes(event.reason)","message":"WITHDRAW_WARD_REQUEST reason must be chosen from WARD_REQUEST_WITHDRAWAL_REASONS","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1135}}],"screen":{"screen":"shortlist-panel.tsx","control":"Withdraw this request"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":495,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1069,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/coordinator/shortlist-panel.tsx","line":885,"sha256":"d4037bcfbce9686478d640bc8f19fba727986518c4d49cede83ee6c9748d65cb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1082,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1085,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"WITHDRAW_ACCEPTANCE","name":"Undo a ward's acceptance","group":"Finding a bed","lane":"stall","nodes":["sAcceptWithdrawn"],"roles":["coordinator"],"does":"Withdraws an acceptance before handover, including a pulled bed or a movement stepped back while retaining its held admission. A matching bed is released in the same act.","needs":"An open movement at accepted_awaiting_bed, pulled, or an earlier stepped-back stage with a held admission, plus a listed correction reason. Cancel a live booking first; collection refuses withdrawal.","changes":"Clears the accepting ward and time and any released hold fields (including the referral arm's numbered bed hold), appends withdrawal/release history and notices. Ordinarily returns to destination_review; an earlier stepped-back stage stays as found. It does not re-refer the ward. For an agreed return identified by sourceAdmissionId, the bed-release notice goes to that source stay's sending ward rather than its ED alias.","reasons":["STEP_BACK_REASONS"],"refuses":[{"when":"Guard: holdsBed && movement.transport?.collectedAt !== undefined","message":"movement ${movement.id}'s patient has been collected; use STOP_TRANSPORT","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1329}},{"when":"Guard: holdsBed && movement.transport !== undefined && movement.transport.cancelledAt === undefined","message":"movement ${movement.id} has a transport job booked; cancel it (CANCEL_TRANSPORT) before withdrawing the acceptance","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1335}},{"when":"Guard: holdsBed && bedReleased === state","message":"movement ${movement.id}'s pulled bed matches no releasable reservation","source":{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1345}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx","control":"Withdraw the acceptance"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":492,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1301,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1794,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1341,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1347,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1357,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"}]}},{"event":"WITHDRAW_REFERRAL","name":"Abandon the bed search","group":"Finding a bed","lane":"end","nodes":["sAbandoned"],"roles":["ed","community","ward","coordinator"],"does":"Cancels the search outright — either pulling it from every ward still being asked, or, once accepted, revoking the acceptance and giving back any held bed.","needs":"An open movement and the recorded sending desk/place or coordinator. After acceptance this path is restricted to the originating ED or coordinator and refuses after collection; other sending desks cannot revoke an accepted movement here. Execution uses canonical actingPlaceId, or a ward's actingUnitId, before the legacy placeId fallback; a supplied legacy alias that disagrees with the canonical claim is refused. Shared scope validates legacy placeId as an authority claim too.","changes":"Closes the movement as “did not proceed”, releases any held bed, cancels any live transport.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"movement ${movement.id} has already closed and cannot be withdrawn","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":919}},{"when":"Guard: event.role !== \"coordinator\" && event.role !== \"ed\"","message":"movement ${movement.id} has already been accepted by ${movement.acceptedUnitId}; only the referrer or the coordinator may revoke it now","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":990}},{"when":"Guard: movement.transport?.collectedAt !== undefined","message":"movement ${movement.id}'s patient has already been collected; use STOP_TRANSPORT to stop the journey instead of withdrawing the referral","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":999}},{"when":"Guard: movement.referredUnitIds.length === 0","message":"movement ${movement.id} holds no live referral to withdraw","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1065}}],"screen":{"screen":"ward-flow-raise.ts; ed/ed-screen-actions.ts; patients/patient-transit-operations.tsx","control":"Withdraw referral"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":373,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":883,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-raise.ts","line":13,"sha256":"a077d0f6d55ef4d03e7beca435fcbce745b6eee1628698b0f6b9acd30289c207"},{"path":"src/components/ward-management/ed/ed-screen-actions.ts","line":40,"sha256":"69b93a5f2adbb5c42be0b7ba826c12ec1b3eec58ed2a3d08ac99273ef66d4636"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":983,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":889,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":960,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":969,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1021,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"REFER_TO_COMMUNITY_TEAM","name":"Send them to a community team instead","group":"Finding a bed","lane":"diversion","nodes":["edToCommunity","cmhtFromSearch"],"roles":["ed","coordinator"],"does":"Instead of admitting, refers the patient straight to a named community team — ends the bed search, creates or reuses a real community referral, and tells everybody involved.","needs":"The record is open and transport has not collected the patient. If they are on a legal form, a conclusive examination outcome must already be recorded.","changes":"Gives back any held bed, cancels transport, withdraws live ward requests, closes the movement, and raises or reuses the community arm. When creating a new community referral, the movement's origin ED site is looked up within state.scenario, preserving the fictional-network origin when available; queued-arm reuse is unchanged.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot refer a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":487}},{"when":"Guard: !communityTeamOptions().includes(event.team)","message":"team \"${event.team}\" is not a valid community mental health team","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":490}},{"when":"Guard: movement.transport?.collectedAt !== undefined","message":"movement ${movement.id}'s patient has already been collected; use STOP_TRANSPORT to stop the journey instead of referring to a community team","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":500}},{"when":"Guard: isOnForm && (!movement.examination || movement.examination.outcome === \"further_examination_ordered\")","message":"movement ${movement.id} is on a legal form; a conclusive examination outcome must be recorded before referring to a community team","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":513}}],"screen":{"screen":"ed/ed-screen-row-forms.tsx","control":"Confirm CMHT referral"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":195,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":477,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ed/ed-screen-row-forms.tsx","line":693,"sha256":"092ace45298789630ea1548b50896070d092ccf6e1e2ff5efa2be02b089f0dfd"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":481,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":484,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":494,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":507,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"RECORD_ED_OUTCOME","name":"The department decides they need no bed","group":"Finding a bed","lane":"end","nodes":["edOutcome","edAnswers"],"roles":["ed","coordinator"],"does":"Records that the patient no longer needs a psychiatric bed — going home, or to community follow-up — and unwinds everything already in motion.","needs":"The record is open and transport has not collected the patient. For “for discharge” on a legal form, a conclusive examination outcome must already be recorded.","changes":"Releases a held bed, cancels an uncollected transport job, drops live ward requests, closes the movement, and notifies every ward affected.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot record an ED outcome for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":331}},{"when":"Current handler guard; inspect the cited source for its full condition","message":"movement ${movement.id}'s patient is actively in transit; use STOP_TRANSPORT to stop the journey instead of recording an ED outcome","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":346}},{"when":"Guard: event.outcome === \"for_discharge\" && isOnLegalFormForDischarge && (!movement.examination || movement.examination.outcome === \"further_examination_ordered\")","message":"movement ${movement.id} is on a legal form; a conclusive examination outcome must be recorded before recording \"for discharge\"","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":362}}],"screen":{"screen":"ed/ed-screen-row-forms.tsx","control":"For discharge"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":84,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":328,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-row-forms.tsx","line":298,"sha256":"092ace45298789630ea1548b50896070d092ccf6e1e2ff5efa2be02b089f0dfd"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":335,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":350,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":366,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_NO_REFERRAL","name":"Record that nobody referred them","group":"Finding a bed","lane":"record","nodes":["placement","edRaise"],"roles":["ed","coordinator"],"does":"Records that, on checking, nobody actually referred this patient in.","needs":"The record is open and is not already linked to a referral.","changes":"Stamps the absence and its reason.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot record a referral answer for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":300}},{"when":"Guard: movement.referralId !== undefined","message":"movement ${movement.id} was raised from referral ${movement.referralId}, so it cannot also record that nobody referred this patient","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":311}}],"screen":{"screen":"ed/ed-screen-row-menu.tsx","control":"No referral raised"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":81,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":297,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-row-menu.tsx","line":481,"sha256":"00d889ba5d86974abf82e2dd2ac8644e8de2a6d5c4e736ae39b00c927c49b205"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":304,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":315,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_ESCALATION","name":"Record an escalation","group":"Finding a bed","lane":"record","nodes":["asked","rkEscalate"],"roles":["coordinator"],"does":"Records that the search was escalated — which wards were tried, and who was contacted.","needs":"The record is open.","changes":"Stamps the escalation, the wards tried and the contact, and adds it to the journey's escalation history (item 28, 9 Nov 2026).","reasons":["ESCALATION_CONTACTS"],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1122}},{"when":"Guard: movement.closure","message":"cannot escalate a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1124}}],"screen":{"screen":"ward-tasks-drawer.tsx; alerts/alerts-screen.tsx; delays/delays-screen.tsx","control":"Record escalation"},"review":{"reviewedOn":"2026-11-10","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":104,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1065,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-tasks-drawer.tsx","line":673,"sha256":"f14b8983f1421e5ab23f25dd3d11d6489cf9119e06884a1fcb58e8374c68018f"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":738,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/delays/delays-screen.tsx","line":170,"sha256":"da99c0834991445b845454355401c6a6a5fa156c5e433f242c08d24ef23e9297"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1094,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1069,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"STEP_BACK_STAGE","name":"Correct the record backwards","group":"Finding a bed","lane":"record","nodes":["asked","inPrinciple","pulled"],"roles":["coordinator"],"does":"Moves the record back to an earlier point. A pure record correction — it deliberately releases no bed and cancels no transport.","needs":"An open, unarrived movement, an earlier valid stage and listed correction reason. A stage-only seeded bed hold cannot be stepped back before pulled because that would lose its reservation.","changes":"Moves the stage and logs the correction. Nothing else is touched at all.","reasons":["STEP_BACK_REASONS"],"refuses":[{"when":"Guard: movement.stage === \"arrived\" || movement.transport?.arrivedAt !== undefined","message":"cannot step back an arrived movement (invariant I-05: physical arrival is irreversible)","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":698}},{"when":"Guard: toIndex >= fromIndex","message":"STEP_BACK_STAGE target must be strictly before the movement's current stage (movement ${movement.id} is at ${stageCopy[movement.stage].label}, target was ${stageCopy[event.to].label})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":713}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx; patients/patient-transit-operations.tsx","control":"Correct the record"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":491,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":750,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1902,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":928,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":757,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":772,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"PULL_PATIENT","name":"Take the bed","group":"Holding the bed","lane":"expected","nodes":["pulled","dRepull","dForced","dGenderHard","dNoLongerSuits"],"roles":["ward","coordinator"],"does":"The ward claims the bed it accepted, and an admission record is created marked held — not occupied. A patient is not arrived until the ward says they have arrived.","needs":"An open movement at accepted_awaiting_bed and the accepting ward, consistent reservation/identity, current capacity (the Ready figure counts live pulled admissions, and beds still being made ready must not use up all of it), eligibility, bed-kind/gender/legal checks and no conflicting active placement. Other journeys' pending numbered bed reservations at the ward (a held bed number on another movement or referral arm) also come off Ready and off the free locked and open counts, so a pull cannot take a bed another record was promised.","changes":"Reserves an allocatable bed, creates or consistently adopts the held admission and starts the configured hold timer. The bed is held rather than occupied.","reasons":["OVERRIDE_REASONS"],"override":true,"refuses":[{"when":"Guard: movement.acceptedUnitId !== event.unitId","message":"movement ${movement.id} was accepted at ${movement.acceptedUnitId ?? \"no unit\"}, not ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":92}},{"when":"Guard: !speciallingAnsweredRestore && lacksObservationStaff(movement.observation, restoreUnit, admissionsExcludingOwn)","message":"${restoreUnit.name} has not enough observation staff left; this patient needs ${observationSummary(movement.observation)} and the ward cannot staff it","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":154}},{"when":"Guard: !acuityAnsweredRestore && acuityOverrideNeededRestore","message":"${restoreUnit.name} ${HIGH_ACUITY_STAFFING_REFUSAL}. This placement ${OVERRIDE_REASON_REQUIRED} and the nurse unit manager consulted.","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":167}},{"when":"Guard: pullReady \u003c= 0","message":"no Ready bed remains at ${unit.name} (allocatable ${unit.allocatable.value}, physically empty ${unit.empty.value})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":210}},{"when":"Guard: pending > 0 && pullReady \u003c= pending","message":"every free bed at ${unit.name} is still being made ready (${pending} pending); a patient cannot be pulled to a bed that is not open","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":227}},{"when":"Guard: !speciallingAnswered && lacksObservationStaff(movement.observation, unit, state.admissions)","message":"${unit.name} has not enough observation staff left (${remainingSpeciallingCapacity(unit, state.admissions)} of ${unit.speciallingCapacity} free); this patient needs ${observationSummary(movement.observation)} and the ward cannot staff it","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":249}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Pull a bed"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":90,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":79,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1449,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward/ward-answer-view.tsx","line":477,"sha256":"fb9fd5b92aaf4cac6a3397267e1dff8062ed70bbc9333b6476a77663ae83b37c"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":306,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":98,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":160,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":173,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":223,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":241,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":262,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"RELEASE_PULL","name":"Give the held bed back","group":"Holding the bed","lane":"stall","nodes":["sPullReleased"],"roles":["coordinator","ward"],"does":"A ward gives back a bed it was holding before the patient arrived. The admission record is deleted outright — nobody was ever in this bed.","needs":"An open movement at pulled, a listed release reason, an authorised holding ward/coordinator and no physical collection. Cancel a live booking first. An Undo carrying expectedPull must still name this exact pull.","changes":"Returns the bed to the ward, deletes the admission, sends the record back to “accepted, awaiting bed”, and tells the department. For a return movement with sourceAdmissionId, the in-app release/withdrawal notice targets the actual sending stay ward. Ordinary ED/community origins retain their existing recipient paths; no external-provider delivery is implied. The movement's and its referral arm's held bed numbers are cleared with the pull. A release that matches no releasable bed reservation is refused rather than recorded.","reasons":["RELEASE_PULL_REASONS"],"refuses":[{"when":"Guard: movement.stage !== \"pulled\"","message":"cannot release a pull at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":483}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"RELEASE_PULL was raised acting as unit ${event.actingUnitId} but movement ${movement.id}'s bed is pulled at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":492}},{"when":"Guard: !RELEASE_PULL_REASONS.includes(event.reason)","message":"RELEASE_PULL reason must be chosen from RELEASE_PULL_REASONS","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":501}},{"when":"Guard: bedReleased === state","message":"movement ${movement.id}'s pulled bed matches no releasable reservation","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":524}}],"screen":{"screen":"alerts/alerts-screen.tsx; ward/ward-screen.tsx; patients/patient-transit-operations.tsx","control":"Release the pulled bed"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":114,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":453,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":723,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1847,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":867,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":537,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":546,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":555,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"RELEASE_HELD_BED","name":"Release a bed left held by a stopped journey","group":"Holding the bed","lane":"stall","nodes":["sStopTransport"],"roles":["coordinator","ward","ed"],"does":"Releases the bed that stopping a transport deliberately left held, once it is decided the patient is not coming after all. The only way to give that bed back.","needs":"The journey was stopped after collection, and a bed is still held.","changes":"Releases the bed and deletes the admission.","reasons":[],"refuses":[{"when":"Guard: !isStoppedTransport && !isRevokedExamHold && !awaitingRelease","message":"movement ${movement.id} was not stopped by STOP_TRANSPORT and has no examination-revoked hold, so there is no pulled bed to release this way","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":573}},{"when":"Guard: !heldBedOutstanding","message":"movement ${movement.id} has no bed pulled — it may already have been released","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":583}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"RELEASE_HELD_BED was raised acting as unit ${event.actingUnitId} but movement ${movement.id}'s bed is pulled at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":591}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx; ward/ward-arrivals-corridor.tsx","control":"Release the held bed"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":190,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":618,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1167,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward/ward-arrivals-corridor.tsx","line":630,"sha256":"572956c1b4769defd00bc1a5dc027ff2d76c476388cee6d36833c8321e3824a4"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":632,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":642,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":650,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"RECORD_TRANSPORT_NEED","name":"Record whether transport is needed","group":"The journey","lane":"record","nodes":["booked","dNoTransport"],"roles":["ed","ward","community","coordinator"],"does":"Records whether the patient will need help getting to the ward. Answering “no” is what lets them be marked arrived with no journey at all.","needs":"An open movement. The ward must be the sending ward; a supplied ED place must match the origin. Cancel a live booking before recording that transport is not needed.","changes":"Sets or replaces the answer.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot record a transport need for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":233}},{"when":"Guard: !sendingWard","message":"RECORD_TRANSPORT_NEED was raised by ward ${event.actingUnitId ?? \"(unnamed)\"}, but this patient did not start on a ward","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":251}}],"screen":{"screen":"ed/ed-screen-row-menu.tsx","control":"No transport needed"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":52,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":229,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-row-menu.tsx","line":458,"sha256":"00d889ba5d86974abf82e2dd2ac8644e8de2a6d5c4e736ae39b00c927c49b205"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":237,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":255,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"BOOK_TRANSPORT","name":"Book the transport","group":"The journey","lane":"expected","nodes":["booked"],"roles":["ed","ward","community","coordinator"],"does":"Logs an already arranged booking: provider, explicit escort and transport-legal-status answers, an optional estimate, and optional typed CAD number. It calls no transport service.","needs":"An open movement at pulled or handover_ready with an accepted destination or admission and no live booking. Desk/place must match sender or coordinator; global medical-clearance/deterioration guards apply. A blank CAD is permitted for later recording. A blank estimated time is permitted too (W32, 5 Nov 2026: it warns in the form); one that is given must be a finite time. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Creates the transport job and records who booked it — which decides who may later cancel it.","reasons":["TRANSPORT_PROVIDERS","TRANSPORT_LEGAL_STATUSES"],"refuses":[{"when":"Guard: movement.stage !== \"pulled\" && movement.stage !== \"handover_ready\"","message":"cannot book transport at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":654}},{"when":"Guard: movement.transport && movement.transport.cancelledAt === undefined","message":"transport for movement ${movement.id} is already booked","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":660}},{"when":"Guard: typeof event.escortRequired !== \"boolean\"","message":"BOOK_TRANSPORT escortRequired must be answered, and it has no default","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":669}},{"when":"Guard: event.estimatedAt !== undefined && (typeof event.estimatedAt !== \"number\" || !Number.isFinite(event.estimatedAt))","message":"BOOK_TRANSPORT estimatedAt must be a real time when it is given","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":690}},{"when":"Guard: event.role === \"ward\" && !event.actingUnitId","message":"BOOK_TRANSPORT raised as ward must state its actingUnitId, and it has no default","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":695}},{"when":"Guard: event.role === \"community\" && !event.actingPlaceId","message":"BOOK_TRANSPORT raised as community must state its actingPlaceId, and it has no default","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":733}}],"screen":{"screen":"officer/officer-needs-transport.tsx; community/use-community-screen-overlays.ts; ed/ed-screen-actions.ts; patients/patient-transit-operations.tsx; patients/patient-now-screen.tsx","control":"Transport booked The officer booking form guards entered answers and pending saves on outer close or job change. Keep editing retains the draft; only an accepted current save clears the booking without a discard question. A held uncertain command stays owned for same-command recovery rather than sending a duplicate."},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":153,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":654,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-needs-transport.tsx","line":349,"sha256":"a10acca50b2c048546f9b0018a94030b1f6534d508d75c456787087a8aab4b1e"},{"path":"src/components/ward-management/community/use-community-screen-overlays.ts","line":122,"sha256":"647d6312cc81bb2edcb34ac5b2f6214fccfcd4bec1eb3e2f5742fe286eafbb23"},{"path":"src/components/ward-management/ed/ed-screen-actions.ts","line":47,"sha256":"69b93a5f2adbb5c42be0b7ba826c12ec1b3eec58ed2a3d08ac99273ef66d4636"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":640,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":512,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":666,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":672,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":681,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":702,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":707,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":745,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"HANDOVER_READY","name":"Confirm handover is ready","group":"The journey","lane":"expected","nodes":["handover","dNoLongerSuits"],"roles":["ed","community","coordinator"],"does":"Confirms the patient is ready for the booked crew to collect.","needs":"An open movement at pulled, the sending desk or coordinator, and either a booked job or recorded no-transport answer. Explicit negative medical clearance or unresolved deterioration, gender/legal bed issues refuse onward movement.","changes":"Moves the record to handover ready.","reasons":[],"refuses":[{"when":"Guard: movement.stage !== \"pulled\"","message":"cannot ready a handover at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":97}},{"when":"Guard: !movement.transport && !noTransportNeeded","message":"cannot ready a handover before transport is booked (BOOK_TRANSPORT)","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":107}}],"screen":{"screen":"patients/patient-transit-operations.tsx","control":"Mark handover ready"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":94,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":85,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":664,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":99,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":109,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"TRANSPORT_ACCEPTED","name":"The crew accepts the job","group":"The journey","lane":"expected","nodes":["enroute","dNoLongerSuits"],"roles":["officer","coordinator"],"does":"Records that the transport provider has accepted the collection job.","needs":"An open handover-ready movement, a booked job with no existing acceptance and current medical, gender and legal checks. A revoked/community-order examination while a bed is held must be resolved.","changes":"Stamps the acceptance.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot accept transport for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":130}},{"when":"Guard: movement.transport.acceptedAt !== undefined","message":"transport for movement ${movement.id} was already accepted","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":158}}],"screen":{"screen":"officer-screen.tsx","control":"Accepted"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":95,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":128,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-screen.tsx","line":521,"sha256":"da86cd3b9a7e8018baf1a5abb7477e66bdb918fd911ad8f43779f95de7b68027"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":685,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":132,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":160,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"TRANSPORT_EN_ROUTE","name":"The crew sets off","group":"The journey","lane":"expected","nodes":["enroute"],"roles":["officer","coordinator"],"does":"Records that an accepted provider has set off towards the patient. Global medical pause/clearance and examination-held-bed blockers apply; this event does not itself rerun the held-unit gender or legal-authorisation helpers.","needs":"An open handover-ready movement, an accepted job not already en route, and no unresolved medical or examination/held-bed restriction.","changes":"Stamps the departure.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot move transport for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":180}},{"when":"Guard: movement.transport.enRouteAt !== undefined","message":"transport for movement ${movement.id} is already en route","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":216}}],"screen":{"screen":"officer-screen.tsx","control":"En route"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":96,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":178,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-screen.tsx","line":528,"sha256":"da86cd3b9a7e8018baf1a5abb7477e66bdb918fd911ad8f43779f95de7b68027"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":705,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":182,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":218,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"PATIENT_COLLECTED","name":"The patient is picked up","group":"The journey","lane":"expected","nodes":["collected","dNoLongerSuits"],"roles":["officer","coordinator"],"does":"Records that the patient has physically been collected and the journey has begun. After this, cancelling is no longer possible — only stopping.","needs":"An open handover-ready movement with a booked en-route job and current medical, gender and legal checks. A valid supplied exception/identity-check record is retained; collection can restore moving after a stage correction without replacing its original physical time. No restrictive practice may still be recorded as in use for the patient at the sending ward.","changes":"Moves the record to moving and stamps the collection.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot collect a patient for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":231}},{"when":"Guard: examinationRevokedHoldingBed || awaitingRelease","message":"cannot collect a patient for movement ${movement.id}: the examination was revoked and this movement still has a bed pulled — a person must release the bed first","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":246}},{"when":"Guard: sourceRestrictiveRefusal","message":"${what} is still recorded as in use for this patient. Record when it ended before they leave the ward","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":278}}],"screen":{"screen":"officer-screen.tsx","control":"Collected"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":97,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":229,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-screen.tsx","line":544,"sha256":"da86cd3b9a7e8018baf1a5abb7477e66bdb918fd911ad8f43779f95de7b68027"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":726,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":233,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":248,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"PATIENT_ARRIVED","name":"The ward says they have arrived","group":"The journey","lane":"expected","nodes":["arrived","dNoTransport"],"roles":["officer","ward","coordinator"],"does":"The officer records delivery of the transport leg only. The receiving ward or coordinator confirms physical arrival, occupies the reserved bed and closes the movement. Physical arrival is irreversible.","needs":"An open movement with collection recorded at moving, or no transport needed and no live job at pulled/handover_ready. The receiving ward must identify itself. Ward arrival additionally checks the matching reservation, identity, bed eligibility and any source stay.","changes":"Officer: stamps transport.arrivedAt and leaves moving open. Ward/coordinator: occupies the held admission, adjusts bed figures and closes arrived; a linked source stay is departed on transfer arrival. When linked journey/stay observation levels diverge, retained accepted-edit sequence decides which is later, including same-minute edits and new edits against legacy history. If neither entry has sequence, the existing timestamp fallback remains (journey wins ties); a winning journey level appends reconciliation history to the stay. A winning journey observation sequence is retained in the stay reconciliation history; genuinely unordered legacy ties retain the existing timestamp/journey fallback.","reasons":[],"refuses":[{"when":"Guard: movement.stage !== \"pulled\" && movement.stage !== \"handover_ready\"","message":"cannot arrive a patient with no transport needed at the movement's current stage (${stageCopy[movement.stage].label}); the bed must be pulled first","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":346}},{"when":"Guard: movement.stage !== \"moving\" || movement.transport?.collectedAt === undefined","message":"cannot arrive a patient at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":353}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"ward ${event.actingUnitId} cannot confirm arrival for a patient accepted at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":372}}],"screen":{"screen":"officer/officer-screen.tsx; tools/ward-tool-feed.tsx; board/ward-board.tsx; patients/patient-transit-operations.tsx","control":"Confirm Arrival"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":98,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":315,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/officer/officer-screen.tsx","line":563,"sha256":"da86cd3b9a7e8018baf1a5abb7477e66bdb918fd911ad8f43779f95de7b68027"},{"path":"src/components/ward-management/tools/ward-tool-feed.tsx","line":217,"sha256":"35b50e734a9396586e280e12df0c557991ce7b20cf0601d932b279a1734add90"},{"path":"src/components/ward-management/board/ward-board.tsx","line":357,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/patients/patient-transit-operations.tsx","line":781,"sha256":"46eec4eb89318cfa453c751fab6f5d6dab2c345eb6a2c5c1cad56be0c69ffc5f"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":354,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":361,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":380,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-observation.ts","line":48,"sha256":"b714525f0d4c6d18d050f9a3600f38c8de4e9a013595a77844c5c492fbdc2e3c"}]}},{"event":"CANCEL_TRANSPORT","name":"Cancel the transport before collection","group":"The journey","lane":"stall","nodes":["sCancelTransport","dCancelLie"],"roles":["coordinator","ed","ward","community"],"does":"Cancels an uncollected live booking, recording its identity and CAD in unwind history. The coordinator may act; ward/community must match their booked sender and a supplied ED place must match booking provenance. Nothing is rebooked.","needs":"An open movement with a live uncollected, undelivered job, an authorised booking desk/place and a listed cancellation reason.","changes":"Deletes the job entirely. The stage does not move and the bed stays held. The job's awaiting-departure and booking-estimate-passed inbox rows get a returned snooze entry and a released ownership entry appended, keeping their earlier history.","reasons":["CANCEL_TRANSPORT_REASONS"],"refuses":[{"when":"Guard: movement.transport.arrivedAt !== undefined","message":"cannot cancel transport for movement ${movement.id} — the patient has arrived","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":834}},{"when":"Guard: movement.transport.collectedAt !== undefined","message":"cannot cancel transport for movement ${movement.id} — the patient has departed","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":837}},{"when":"Guard: movement.transport.bookedBy?.role !== \"ward\" || !event.actingUnitId || movement.transport.bookedBy.unitId !== event.actingUnitId","message":"CANCEL_TRANSPORT raised as ward acting as ${event.actingUnitId} may only cancel transport it booked for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":856}},{"when":"Guard: movement.transport.bookedBy?.placeId && movement.transport.bookedBy.placeId !== event.actingPlaceId","message":"CANCEL_TRANSPORT raised as ED acting as ${event.actingPlaceId} may only cancel transport it booked for movement ${movement.id}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":880}},{"when":"Guard: !CANCEL_TRANSPORT_REASONS.includes(event.reason)","message":"CANCEL_TRANSPORT reason must be chosen from CANCEL_TRANSPORT_REASONS","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":889}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx; community/use-community-screen-overlays.ts","control":"Cancel transport"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":175,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":835,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1444,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/community/use-community-screen-overlays.ts","line":140,"sha256":"647d6312cc81bb2edcb34ac5b2f6214fccfcd4bec1eb3e2f5742fe286eafbb23"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":848,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":851,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":870,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":894,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":903,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"STOP_TRANSPORT","name":"Stop the journey after collection","group":"The journey","lane":"diversion","nodes":["sStopTransport"],"roles":["coordinator","ed"],"does":"Stops a journey with the patient already in the vehicle. Somebody must say where the patient now is. The movement closes and the bed deliberately stays held.","needs":"The patient has been collected, and has not arrived or already been stopped.","changes":"Stamps the stop, its reason and the whereabouts; closes the movement; leaves the bed held until it is separately released.","reasons":["STOP_TRANSPORT_REASONS","TRANSPORT_WHEREABOUTS"],"refuses":[{"when":"Guard: movement.transport.collectedAt === undefined","message":"movement ${movement.id}'s transport has not been collected yet; use CANCEL_TRANSPORT instead","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":990}},{"when":"Guard: movement.transport.arrivedAt !== undefined","message":"movement ${movement.id}'s patient has already arrived","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":996}},{"when":"Guard: !TRANSPORT_WHEREABOUTS.includes(event.whereabouts)","message":"STOP_TRANSPORT whereabouts must be chosen from TRANSPORT_WHEREABOUTS","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1015}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx","control":"Stop transport"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":185,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1013,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1557,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1026,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1032,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1051,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"RECORD_LEFT_DEPARTMENT","name":"Record that they have left the department","group":"The journey","lane":"record","nodes":["edLeft"],"roles":["ed","coordinator"],"does":"Records the time the patient physically left the emergency department.","needs":"An outcome has already been recorded, and this has not been recorded before.","changes":"Stamps the departure time.","reasons":[],"refuses":[{"when":"Guard: movement.leftDepartmentAt !== undefined","message":"movement ${movement.id} has already been recorded as left department","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":555}},{"when":"Guard: movement.edOutcome === undefined","message":"movement ${movement.id} has no ed outcome recorded; record an outcome before marking left department","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":561}}],"screen":{"screen":"ed/ed-screen-row-menu.tsx","control":"Left the department"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":196,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":529,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-row-menu.tsx","line":605,"sha256":"00d889ba5d86974abf82e2dd2ac8644e8de2a6d5c4e736ae39b00c927c49b205"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":533,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":539,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_EXAMINATION","name":"Record an examination outcome","group":"Legal status and examinations","lane":"breach","nodes":["dRevoked","rkExam","sAbandoned"],"roles":["ed","coordinator"],"does":"Records an examination or a permitted repeat. Inpatient/further-examination outcomes record facts only. Revocation while any bed is held retains that bed for a person to release, even before transport commitment. A community order before commitment may close and release.","needs":"The record is open. A second examination is only allowed if the last one ordered a further examination.","changes":"Keeps superseded examinations. After collection or at handover_ready/moving, community-order/revocation records a blocker without refund or closure; revocation with any held bed does the same and tells its ward. Otherwise community-order/revocation closes the search, releases any matching hold, cancels uncollected transport and withdraws requests.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot record an examination for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":580}},{"when":"Guard: previousExamination && previousExamination.outcome !== \"further_examination_ordered\"","message":"movement ${movement.id} was already examined","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":591}}],"screen":{"screen":"ed/use-ed-examination-save.ts","control":"Confirm examination outcome"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":38,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":549,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/use-ed-examination-save.ts","line":145,"sha256":"357b8af4b99fb9c0609a07c4d6230c6be722e71a5f396c7d627909a9ef141fea"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":558,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":569,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"CHANGE_LEGAL_STATUS","name":"Change the legal status","group":"Legal status and examinations","lane":"record","nodes":["occupied","asked","rkLegalStatus"],"roles":["coordinator","ed","ward","community"],"does":"Changes the patient's status under the Mental Health Act, recording who changed it and why. It never reacts on its own — even if this makes an already-accepted bed unlawful, that only surfaces for a human to look at.","needs":"An open movement, sender-kind permission and a listed legal-status-change reason; signed/shared scope further binds the actual sender.","changes":"Sets the status and logs the change.","reasons":["LEGAL_STATUS_CHANGE_REASONS"],"refuses":[{"when":"Guard: movement.closure","message":"cannot change legal status for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1277}},{"when":"Guard: !LEGAL_STATUS_CHANGE_REASONS.includes(event.reason)","message":"CHANGE_LEGAL_STATUS reason must be chosen from LEGAL_STATUS_CHANGE_REASONS","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1285}}],"screen":{"screen":"movements/sent-journey-changes.tsx","control":"Record legal status change"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":113,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1219,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/movements/sent-journey-changes.tsx","line":196,"sha256":"2bc1df9ee01cd20bf12d9fc8d7dee1a31c82589a2c354a0f5d595bd8cca25072"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1227,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1235,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"RECORD_LEGAL_FORM_RECEIVED","name":"Mark a form as physically received","group":"Legal status and examinations","lane":"record","nodes":["occupied","rkForm"],"roles":["ed","ward","community","coordinator"],"does":"Marks that a patient's legal form has physically arrived. Any of the nine forms with a legal clock (1A, 3A, 3C, 3D, 5A, 5B, 6A, 6B, 6C) can be marked, not only Form 1A (owner ruling D-16).","needs":"An open movement sent by this desk kind or coordinator, a supported recorded legal-clock form and no previous receipt. Signed/shared scope further limits the actual sender. An optional typed received time must not be later than now.","changes":"Stamps the receipt: the typed received time when given (marked as typed), otherwise now.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"cannot mark legal form received for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":473}},{"when":"Guard: movement.legalFormReceivedAt !== undefined","message":"legal form for movement ${movement.id} was already marked as received","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":477}},{"when":"Guard: !movement.legalForm || !isLegalClockFormCode(movement.legalForm.code)","message":"movement ${movement.id} does not carry a receivable legal form (legal form ${movement.legalForm?.code ?? \"none\"}), so a legal form receipt cannot be recorded against it","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":485}},{"when":"Guard: event.receivedAt !== undefined && (!Number.isFinite(event.receivedAt) || event.receivedAt > event.now)","message":"The time received can't be later than now. Check the time on the form.","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":491}}],"screen":{"screen":"legal-forms/legal-forms-screen.tsx","control":"Mark Form 1A received (the legal forms screen marks the other eight)"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":59,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":434,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/legal-forms/legal-forms-screen.tsx","line":358,"sha256":"6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":445,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":449,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":457,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"CORRECT_LEGAL_FORM_RECEIPT","name":"Undo a form receipt","group":"Legal status and examinations","lane":"record","nodes":["occupied","rkForm"],"roles":["ed","ward","community","coordinator"],"does":"Undoes a receipt logged by mistake, keeping a record that a correction happened and why.","needs":"An open movement sent by this desk kind, an existing receipt and a listed correction reason; signed/shared scope further binds the actual sender.","changes":"Clears the receipt, and its typed-time mark, and appends the correction.","reasons":["LEGAL_FORM_RECEIPT_CORRECTION_REASONS"],"refuses":[{"when":"Guard: movement.closure","message":"cannot correct a legal form receipt for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":447}},{"when":"Guard: movement.legalFormReceivedAt === undefined","message":"movement ${movement.id} has no recorded legal form receipt to correct","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":451}}],"screen":{"screen":"ed/use-ed-record-save.ts","control":"Save correction"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":65,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":429,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ed/use-ed-record-save.ts","line":200,"sha256":"b2d00eed8f4b907f3817792ae148eaa015d1b860de762bc4d38abd2eb1045de5"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":440,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":444,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"RECORD_LEGAL_FORM_EXPIRY","name":"Record or extend a form's expiry","group":"Legal status and examinations","lane":"record","nodes":["occupied","rkForm","rkExpiryShut"],"roles":["ed","coordinator","ward"],"does":"Records typed paper expiry or a later extension. An explicit correction may move it earlier only with a reason and matching expected paper facts. No statutory duration is computed.","needs":"An existing form and finite typed expiry on an open movement, or the admitting ward’s admitted-stay path. An extension is strictly later; a correction must differ and match the current code, written time and previous expiry.","changes":"Stores the typed expiry, clears any calculated legacy clock, appends basis/author/time history tagged with the zero-based form instance (the count of earlier forms) and, for a correction, its previous facts and reason.","reasons":[],"refuses":[{"when":"Guard: !movement.legalForm","message":"There is no legal form on this record to add an expiry to.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":60}},{"when":"Guard: !Number.isFinite(event.dueAt)","message":"Enter the expiry written on the form.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":65}},{"when":"Guard: correction === undefined && isExtension && event.dueAt \u003c= currentDueAt","message":"An extension's new expiry must be later than the expiry already recorded.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":106}}],"screen":{"screen":"ed/use-ed-expiry-save.ts; legal-forms/legal-forms-screen.tsx","control":"Save expiry"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":75,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":52,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ed/use-ed-expiry-save.ts","line":119,"sha256":"390d0c109a96a4045b56601ad724774fdd964536984fefba4aac3c67787059c9"},{"path":"src/components/ward-management/legal-forms/legal-forms-screen.tsx","line":1277,"sha256":"6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":68,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":73,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":114,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}]}},{"event":"RECORD_MOVEMENT_GENDER","name":"Correct the recorded gender","group":"Legal status and examinations","lane":"record","nodes":["asked","pulled"],"roles":["ed","coordinator"],"does":"Corrects the gender recorded on an open record and, if a ward already holds or has accepted the bed, tells the coordinator to check the placement still suits.","needs":"The record is open and the new value differs from what is there.","changes":"Sets the gender, logs the change, and raises a notice where a bed is involved.","reasons":["REFERRAL_GENDERS"],"refuses":[{"when":"Guard: movement.closure","message":"cannot record gender for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":506}},{"when":"Guard: movement.gender === event.gender","message":"movement ${movement.id} is already recorded as gender ${event.gender}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":512}}],"screen":{"screen":"ed/ed-screen-referred.tsx","control":"Record gender"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":80,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":480,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-screen-referred.tsx","line":266,"sha256":"0b0d6dde9843e2750f4dbadd23e4e7d9c30b2c2c9eee9e4f2c539961a97568aa"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":484,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":490,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RECORD_LEAVING","name":"Record that the patient has left","group":"On the ward","lane":"expected","nodes":["personLeaves","bedReleased","end0","end1","end2","end3","end4","end5","end6","end7"],"roles":["ward","coordinator"],"does":"Records physical departure from an occupied stay and retains the departed admission. It is distinct from the protected revision-checked RECORD_PATIENT_DISCHARGE path.","needs":"The caller names the stay’s ward and a listed destination at a finite time no earlier than arrival. No active transit, restrictive-practice or open return-movement conflict. An involuntary community/against-advice departure needs a recorded permitted paper transition.","changes":"Ends the admission and raises the ward's empty and allocatable counts by one (only the timestamps move if this person's release had already been completed), gives back a locked bed, adjusts the sex mix, ends any leave bed, and completes this person's pending bed release.","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== admission.unitId","message":"RECORD_LEAVING was raised acting as unit ${event.actingUnitId} but admission ${admission.id} belongs to unit ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":134}},{"when":"Guard: admission.state === \"departed\"","message":"admission ${admission.id} has already left","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":140}},{"when":"Guard: admission.state !== \"occupied\"","message":"admission ${admission.id} is ${admission.state}, and only somebody occupying a bed can leave one","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":148}}],"screen":{"screen":"ward-board.tsx (+1 other)","control":"Record that they have left The ward departure caller retains one pending subject through an uncertain failed outcome that carries confirmation, follows only the same command receipt and scopes Undo to the receipt-created departure step. Old-world completions must not free a replacement world command or advertise stale Undo; ordinary reset keeps the screen DOM so opener focus can be restored."},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":220,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":122,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":1217,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1745,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/tools/ward-tool-feed.tsx","line":218,"sha256":"35b50e734a9396586e280e12df0c557991ce7b20cf0601d932b279a1734add90"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":254,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/board/ward-board.tsx","line":885,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":134,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":140,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":148,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_AWAY_AT_EMERGENCY_DEPARTMENT","name":"Record that they are away at an ED","group":"On the ward","lane":"diversion","nodes":["dAway"],"roles":["ward","coordinator"],"does":"Notes that an admitted patient has gone to an emergency department for a medical problem, while the ward keeps their bed.","needs":"An occupied stay on the named acting ward, no existing ED absence, and no simultaneous leave or absence-without-leave record. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Stamps the absence. No bed figure moves at all.","reasons":[],"refuses":[{"when":"Guard: admission.awayAtEmergencyDepartmentSince !== null","message":"admission ${admission.id} is already recorded as away at an emergency department","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":229}},{"when":"Guard: heldBed","message":"admission ${admission.id} is ${heldBed.absentWithoutLeave ? \"absent without leave\" : \"on leave\"} (${heldBed.id}); record the return first","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":238}}],"screen":{"screen":"ward-board.tsx","control":"Record that they have gone to an emergency department"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":232,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":208,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward/ward-screen-overlays.tsx","line":273,"sha256":"27f313a7a06534fcdb3003ce8e31074b16648e74280f57980b2e051d81a16dd8"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":445,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/board/ward-board.tsx","line":904,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":701,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":229,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":238,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_RETURNED_FROM_EMERGENCY_DEPARTMENT","name":"Record that they are back","group":"On the ward","lane":"diversion","nodes":["dAway"],"roles":["ward","coordinator"],"does":"Notes that a patient who went to an emergency department is back on the ward, in the bed that was kept for them.","needs":"The named acting ward owns the stay and it is recorded away at ED. The handler does not additionally require occupied state, so a recorded absence can be cleared. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Clears the absence.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":246}},{"when":"Guard: admission.awayAtEmergencyDepartmentSince === null","message":"admission ${admission.id} is not recorded as away at an emergency department","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":257}}],"screen":{"screen":"ward-board.tsx","control":"Record that they are back on the ward"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":233,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":244,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward/ward-screen-overlays.tsx","line":284,"sha256":"27f313a7a06534fcdb3003ce8e31074b16648e74280f57980b2e051d81a16dd8"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":477,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/board/ward-board.tsx","line":988,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":717,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":246,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":257,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_LEAVE_BED","name":"Record a bed as on leave","group":"On the ward","lane":"diversion","nodes":["dAway"],"roles":["ward","coordinator"],"does":"Records that a bed is held for somebody on approved leave, with an expected return. It does not go back into circulation while they are away.","needs":"A real occupied admission on the named acting ward, no existing leave/absence and no current ED absence. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Creates the leave record.","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== event.unitId","message":"RECORD_LEAVE_BED was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":314}},{"when":"Guard: onLeave.unitId !== event.unitId","message":"RECORD_LEAVE_BED names admission ${onLeave.id} on unit ${onLeave.unitId}, not unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":326}}],"screen":{"screen":"patients/patient-now-screen.tsx","control":"Leave recording through the patient workspace; command dispatch is present"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":208,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":317,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":680,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":324,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":336,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"END_LEAVE_BED","name":"End a bed's leave","group":"On the ward","lane":"diversion","nodes":["dAway"],"roles":["ward","coordinator"],"does":"Ends a bed's recorded leave period.","needs":"The leave record exists and belongs to this ward. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Removes the leave record. The step can be taken back by UNDO_BED_STEP within the Undo window.","reasons":[],"refuses":[{"when":"Guard: !leaveBed","message":"no leave bed found for id ${event.leaveBedId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":672}},{"when":"Guard: event.actingUnitId !== leaveBed.unitId","message":"END_LEAVE_BED was raised acting as unit ${event.actingUnitId} but leave bed ${leaveBed.id} belongs to unit ${leaveBed.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":677}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Ended"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":209,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":654,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1770,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/board/ward-board.tsx","line":980,"sha256":"9de0c99b18db0f7709030d017def2ae105456d80a64cbb880f7bf6c2609599ea"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":623,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":656,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":661,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"FLAG_BED_RELEASE","name":"Flag a bed as coming free","group":"The bed coming free","lane":"expected","nodes":["bedReleased","ready"],"roles":["ward","bed_manager","coordinator"],"does":"A ward flags an upcoming discharge for a named occupying admission, saying when and what it is waiting on.","needs":"The ward may only flag a stay on its own ward, with no other live release for that stay.","changes":"Creates the bed release at “expected”.","reasons":["BED_RELEASE_WAITING_ON","BED_RELEASE_BLOCKERS"],"refuses":[{"when":"Guard: event.actingUnitId !== event.unitId","message":"FLAG_BED_RELEASE was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":398}},{"when":"Guard: event.blocker !== undefined && !BED_RELEASE_BLOCKERS.includes(event.blocker)","message":"FLAG_BED_RELEASE blocker must be chosen from BED_RELEASE_BLOCKERS","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":443}}],"screen":{"screen":"NONE","control":"Source references only; full route reachability and control wording need rendered proof."},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":199,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":370,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":377,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":422,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"CONFIRM_BED_RELEASE","name":"Confirm the discharge is going ahead","group":"The bed coming free","lane":"expected","nodes":["bedReleased","ready"],"roles":["ward","bed_manager","coordinator"],"does":"Confirms an expected discharge is now decided. It does not free the bed — that is a separate step.","needs":"The release is currently expected.","changes":"Moves expected to confirmed, clears waitingOn and records the linked admission’s discharge decision. A blocker survives; no bed is freed. A sign-off from Ward Decisions can be taken back for a short time by UNDO_RELEASE_STEP on the same release (M37, D-129).","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"CONFIRM_BED_RELEASE was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":492}},{"when":"Guard: release.state !== \"expected\"","message":"cannot move release ${release.id} from ${release.state} to confirmed","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":498}}],"screen":{"screen":"ward-screen.tsx","control":"Confirm"},"review":{"reviewedOn":"2026-11-10","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":200,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":464,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1683,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":473,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":479,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"REVERT_BED_RELEASE","name":"Put a confirmed discharge back to expected","group":"The bed coming free","lane":"stall","nodes":["bedReleased","bedStuck","ready"],"roles":["ward","bed_manager","coordinator"],"does":"Reverses a confirmed discharge decision, restating what it is now waiting on. The only step of the three that goes backwards.","needs":"The release is currently confirmed.","changes":"Moves confirmed to expected with listed waitingOn and clears the linked admission’s discharge decision. The blocker survives.","reasons":["BED_RELEASE_WAITING_ON"],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"REVERT_BED_RELEASE was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":531}},{"when":"Guard: release.state !== \"confirmed\"","message":"cannot move release ${release.id} from ${release.state} to expected","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":537}},{"when":"Guard: !BED_RELEASE_WAITING_ON.includes(event.waitingOn)","message":"REVERT_BED_RELEASE waitingOn must be chosen from BED_RELEASE_WAITING_ON","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":542}}],"screen":{"screen":"NONE","control":"Source references only; full route reachability and control wording need rendered proof."},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":204,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":503,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":512,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":518,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":523,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"BLOCK_BED_RELEASE","name":"Flag a discharge as stuck","group":"The bed coming free","lane":"stall","nodes":["bedStuck"],"roles":["ward","bed_manager","coordinator"],"does":"Flags that a discharge — expected or confirmed — is currently stuck, and says why. Being stuck is a flag, not a stage.","needs":"The bed has not already been released.","changes":"Stores the listed blocker and actor/time on the release and linked stay. The release stage remains unchanged.","reasons":["BED_RELEASE_BLOCKERS"],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"BLOCK_BED_RELEASE was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":568}},{"when":"Guard: !event.blocker || !BED_RELEASE_BLOCKERS.includes(event.blocker)","message":"BLOCK_BED_RELEASE requires a blocker chosen from BED_RELEASE_BLOCKERS","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":574}},{"when":"Guard: release.state === \"discharged\"","message":"cannot block release ${release.id} because it is already released","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":581}}],"screen":{"screen":"board/ward-board-blocker-dialog.tsx","control":"Confirm blocked"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":205,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":542,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/board/ward-board-blocker-dialog.tsx","line":73,"sha256":"6d6cfae35d61c34b3ac76b235a2a8e23875c7be085ecef1532dbd5f3f36a174c"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":549,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":555,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":562,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"CLEAR_BED_RELEASE_BLOCK","name":"Clear the stuck flag","group":"The bed coming free","lane":"expected","nodes":["bedStuck"],"roles":["ward","bed_manager","coordinator"],"does":"Clears the stuck flag once whatever was holding the discharge up has been resolved.","needs":"There is a flag to clear.","changes":"Clears the release and linked stay blocker; retains clearance time/role, prior blocker and any supplied listed clearance reason.","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"CLEAR_BED_RELEASE_BLOCK was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":605}},{"when":"Guard: release.blocker === null","message":"release ${release.id} carries no blocked flag to clear","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":611}}],"screen":{"screen":"ward-screen.tsx","control":"No longer held up"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":206,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":582,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1702,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/discharges/discharge-board.tsx","line":502,"sha256":"ecf458cf14c85ca2977016749fdaa85569920ec790d4a37c9d7b1be21e3d4ac9"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":589,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":595,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"SET_BED_PREPARATION","name":"Mark a bed as being made ready","group":"The bed coming free","lane":"record","nodes":["bedReleased","rkPrep"],"roles":["ward","bed_manager","coordinator"],"does":"Marks a bed as being cleaned or awaiting repair. This is information only — it never stops the bed being counted as available or offered to somebody.","needs":"The ward may only set it on its own release.","changes":"Sets the note. No capacity figure moves.","reasons":["BED_PREPARATION_NOTES"],"refuses":[{"when":"Guard: event.actingUnitId !== release.unitId","message":"SET_BED_PREPARATION was raised acting as unit ${event.actingUnitId} but release ${release.id} belongs to unit ${release.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":645}},{"when":"Guard: requestedNote !== undefined && !(BED_PREPARATION_NOTES as readonly string[]).includes(requestedNote)","message":"SET_BED_PREPARATION note must be chosen from BED_PREPARATION_NOTES","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":653}}],"screen":{"screen":"ward/ward-screen-overlays.tsx","control":"Confirm being made ready"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":207,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":619,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen-overlays.tsx","line":296,"sha256":"27f313a7a06534fcdb3003ce8e31074b16648e74280f57980b2e051d81a16dd8"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":629,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":637,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"CONFIRM_CAPACITY","name":"Restate how many beds a ward has","group":"The ward's own numbers","lane":"record","nodes":["asked"],"roles":["ward","bed_manager","coordinator"],"does":"A ward restates how many beds it can currently allocate. This does move a real bed count.","needs":"The ward may only restate its own, with a current revision and a nonnegative whole number no greater than its bed count.","changes":"Sets the allocatable figure, marks it as ward-sourced, and stamps the time.","reasons":[],"refuses":[{"when":"Guard: event.actingUnitId !== event.unitId","message":"CONFIRM_CAPACITY was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":329}},{"when":"Guard: event.value > unit.beds","message":"CONFIRM_CAPACITY says unit ${unit.id} can allocate ${event.value} beds, which is more than the ${unit.beds} beds it has","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":350}}],"screen":{"screen":"ward-screen.tsx (+1 other)","control":"Confirm capacity"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":100,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":298,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1591,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward/ward-answer-view.tsx","line":492,"sha256":"fb9fd5b92aaf4cac6a3397267e1dff8062ed70bbc9333b6476a77663ae83b37c"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":308,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":329,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"RECORD_WARD_INTAKE_CONSTRAINTS","name":"Record what is restricting a ward's intake","group":"The ward's own numbers","lane":"record","nodes":["asked"],"roles":["ward","coordinator"],"does":"A ward records the restrictions it is currently operating under — staffing, infection control, a closed bay, and so on.","needs":"The ward may only record its own.","changes":"Replaces its constraint list.","reasons":["WARD_INTAKE_CONSTRAINTS"],"refuses":[{"when":"Guard: event.actingUnitId !== event.unitId","message":"RECORD_WARD_INTAKE_CONSTRAINTS was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":820}},{"when":"Guard: event.codes.some((code) => !WARD_INTAKE_CONSTRAINTS.includes(code))","message":"RECORD_WARD_INTAKE_CONSTRAINTS codes must all be chosen from WARD_INTAKE_CONSTRAINTS","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":830}}],"screen":{"screen":"NONE","control":"Source references only; full route reachability and control wording need rendered proof."},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":103,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":767,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":774,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":784,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"REQUEST_CAPACITY_REFRESH","name":"Ask a ward to refresh its numbers","group":"The ward's own numbers","lane":"record","nodes":["asked"],"roles":["coordinator"],"does":"Records that somebody asked a ward to refresh its bed numbers. It changes no bed count itself.","needs":"The ward exists.","changes":"Logs the request.","reasons":[],"refuses":[{"when":"Guard: !unit","message":"no unit found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":702}}],"screen":{"screen":"capacity-screen.tsx","control":"Request update"},"review":{"reviewedOn":"2026-11-09","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":376,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":682,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/hub/hub-screen.tsx","line":725,"sha256":"48bf478fbb659cdfe32bf9915e52a2e396c9fde1f33e09c3c2fa4c82f27f20c8"},{"path":"src/components/ward-management/capacity/capacity-ward-drawer.tsx","line":237,"sha256":"c491da820b4c6f942c6a98ef83eef3742c493a612a36e6e9abae92fd892ab554"},{"path":"src/components/ward-management/capacity/capacity-screen.tsx","line":202,"sha256":"ecc814d195ffaeb48c7fc9b72270a832a9fd6fd95f30650133d6c4a4ca229a0c"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":686,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"CHANGE_URGENCY","name":"Change how urgent it is","group":"Urgency and blockers","lane":"record","nodes":["asked","rkUrgent"],"roles":["coordinator","ed","ward","community"],"does":"Changes the urgency, recording who changed it and why. It triggers no re-sorting or re-referral on its own.","needs":"An open movement, sender-kind permission and a listed urgency level. A supplied reason must be listed; omission is recorded as not_given. Signed/shared scope further binds the actual sender.","changes":"Sets the urgency and logs the change.","reasons":["URGENCY_CHANGE_REASONS","URGENCY_LEVELS"],"refuses":[{"when":"Guard: !URGENCY_LEVELS.includes(event.urgency as (typeof URGENCY_LEVELS)[number])","message":"CHANGE_URGENCY urgency must be chosen from URGENCY_LEVELS","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1239}},{"when":"Guard: event.reason !== undefined && !URGENCY_CHANGE_REASONS.includes(event.reason)","message":"CHANGE_URGENCY reason must be chosen from URGENCY_CHANGE_REASONS","source":{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1248}}],"screen":{"screen":"movements/sent-journey-changes.tsx","control":"Record urgency change"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":112,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1178,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/movements/sent-journey-changes.tsx","line":170,"sha256":"2bc1df9ee01cd20bf12d9fc8d7dee1a31c82589a2c354a0f5d595bd8cca25072"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1189,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1198,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"}]}},{"event":"FLAG_MOVEMENT_URGENT","name":"Flag it urgent","group":"Urgency and blockers","lane":"record","nodes":["asked","pulled","rkUrgent","rkQueue"],"roles":["coordinator","ed"],"does":"Marks the patient urgent so they sit above every urgency level in the coordinator's queue, recording who and why.","needs":"The record is open and not already flagged.","changes":"Sets the flag and opens a history entry.","reasons":["URGENT_MARK_REASONS"],"refuses":[{"when":"Guard: movement.flaggedUrgent","message":"movement ${movement.id} is already flagged urgent","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2064}},{"when":"Guard: !URGENT_MARK_REASONS.includes(event.reason)","message":"FLAG_MOVEMENT_URGENT reason must be chosen from URGENT_MARK_REASONS","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2067}}],"screen":{"screen":"movement-drawer.tsx (+1 other)","control":"Flag this patient as urgent"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":352,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2070,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-drawer.tsx","line":401,"sha256":"0078e33c1bd4d2308ec3cffeb86545370c49996efe564c889909e00005d07550"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1261,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2102,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2105,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"CLEAR_MOVEMENT_URGENT_FLAG","name":"Clear the urgent flag","group":"Urgency and blockers","lane":"record","nodes":["asked","pulled","rkUrgent"],"roles":["coordinator","ed"],"does":"Removes the urgent flag once it is no longer needed.","needs":"It is currently flagged. Deliberately allowed even on a closed record.","changes":"Clears the flag and closes the history entry.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2082}},{"when":"Guard: !movement.flaggedUrgent","message":"movement ${movement.id} is not flagged urgent","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2086}}],"screen":{"screen":"movement-drawer.tsx (+1 other)","control":"Remove the urgent flag"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":353,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2094,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-drawer.tsx","line":358,"sha256":"0078e33c1bd4d2308ec3cffeb86545370c49996efe564c889909e00005d07550"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1211,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2096,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2128,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"RECORD_MOVEMENT_BLOCKER","name":"Say what is holding this up","group":"Urgency and blockers","lane":"record","nodes":["asked","pulled","handover"],"roles":["ed","community","ward","coordinator","officer"],"does":"Free text describing what is actually holding the patient up. The only free-text field of its kind in the engine.","needs":"An open movement and nonblank text. An unresolved revoked-examination or diversion hold cannot be overwritten; a case-only variant of a no-blocker sentinel refuses and directs to CLEAR_MOVEMENT_BLOCKER.","changes":"Replaces the blocker text.","reasons":[],"refuses":[{"when":"Guard: blocker.length === 0","message":"RECORD_MOVEMENT_BLOCKER blocker must say something — a blank is not a statement","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":787}},{"when":"Guard: nearMiss !== undefined","message":"\"${blocker}\" differs from \"${nearMiss}\" only in case, and would be stored as an active blocker — use CLEAR_MOVEMENT_BLOCKER to say nothing is holding this up","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":805}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx","control":"Record it"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":280,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":710,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1304,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":741,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":759,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"CLEAR_MOVEMENT_BLOCKER","name":"Say nothing is holding it up","group":"Urgency and blockers","lane":"record","nodes":["asked","pulled","handover"],"roles":["ed","community","ward","coordinator","officer"],"does":"Records that nothing is holding the patient up any more — which is a different statement from nobody ever having recorded one.","needs":"An open movement with an active blocker, and no unresolved revoked-examination or diversion hold. The explicit hold must be resolved through reassessment/release rather than cleared as prose.","changes":"Writes “None — cleared”.","reasons":["BLOCKERS_MEANING_NOTHING_IS_BLOCKING"],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2118}},{"when":"Guard: BLOCKERS_MEANING_NOTHING_IS_BLOCKING.some((inactive) => inactive === movement.blocker.trim())","message":"movement ${movement.id} already records that nothing is holding it up","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2147}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx","control":"Clear — nothing is holding this up"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":287,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2130,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1365,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2132,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2161,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"MARK_NOTICE_READ","name":"Mark a notice read","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["coordinator","ed","ward","officer","community","bed_manager"],"does":"Marks a notice as read by the person or team it was actually addressed to.","needs":"You are the addressee, exactly, and it is not already marked.","changes":"Stamps who read it and when.","reasons":[],"refuses":[{"when":"Guard: notice.to.role !== event.role || notice.to.placeId !== event.actingPlaceId","message":"MARK_NOTICE_READ role/actingPlaceId (${event.role}/${event.actingPlaceId ?? \"none\"}) must match notice ${event.noticeId}'s own addressee (${notice.to.role}/${notice.to.placeId ?? \"none\"})","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":297}},{"when":"Guard: notice.readAt !== undefined","message":"notice ${event.noticeId} is already marked read","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":301}}],"screen":{"screen":"shell/ward-bar-state.ts; community/community-screen.tsx; ward/ward-screen.tsx","control":"Mark as read"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":505,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":290,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/shell/ward-bar-state.ts","line":316,"sha256":"8272a84387337469217e8a70798c6b37922f30bb1e3eaf8a185fdc504f9a34a3"},{"path":"src/components/ward-management/community/community-screen.tsx","line":832,"sha256":"4cce4397ba7d06901141717dd89e58cf12315dc45e90f35604b527e6cebf5671"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1099,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":297,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":301,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"}]}},{"event":"ACKNOWLEDGE_INBOX_ITEM","name":"Acknowledge an inbox row","group":"The coordinator's inbox","lane":"record","nodes":["rkInbox"],"roles":["coordinator"],"does":"Records that the coordinator has seen a row and is on top of it, without removing or hiding it.","needs":"The row names a real category and a real record.","changes":"Logs the acknowledgement. Touches nothing else.","reasons":[],"refuses":[{"when":"Guard: inboxItemId.length === 0","message":"ACKNOWLEDGE_INBOX_ITEM inboxItemId must name a row — a blank names nothing","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":315}},{"when":"Guard: !inboxCategory || !namesRecord","message":"ACKNOWLEDGE_INBOX_ITEM inboxItemId ${inboxItemId} does not name a real inbox row — its prefix must be one of INBOX_CATEGORIES and its remainder an existing record for that category","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":336}}],"screen":{"screen":"alerts-screen.tsx (+1 other)","control":"Acknowledge Alert"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":526,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":312,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-tasks-drawer.tsx","line":428,"sha256":"f14b8983f1421e5ab23f25dd3d11d6489cf9119e06884a1fcb58e8374c68018f"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":670,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":315,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":336,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"}]}},{"event":"COMPLETE_INBOX_ITEM","name":"Tick off an inbox row","group":"The coordinator's inbox","lane":"record","nodes":["rkInbox"],"roles":["coordinator"],"does":"Records completion of a classified human commitment. The current commitment is the coordinator’s daily check, whose id must name a signed integer day. Live fact rows cannot be ticked away.","needs":"A nonblank classified commitment id, a valid daily-check day suffix and no current completion. This is a daily-check record, not proof that any patient/bed action was performed.","changes":"Appends completed role/time history without mutating patient, movement or unit facts.","reasons":[],"refuses":[{"when":"Guard: inboxItemId.length === 0","message":"COMPLETE_INBOX_ITEM inboxItemId must name a row — a blank names nothing","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":352}},{"when":"Guard: inboxItemId.startsWith(INBOX_CATEGORIES.daily_check.idPrefix) && !/^day-(?:0|-?[1-9]\\d*)$/.test(inboxItemId.slice(INBOX_CATEGORIES.daily_check.idPrefix.length))","message":"inbox row ${inboxItemId} does not name a day for the daily check","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":369}},{"when":"Guard: inboxItemCompletionState(history) === \"complete\"","message":"inbox row ${inboxItemId} is already complete","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":373}}],"screen":{"screen":"delays/daily-check-line.tsx; ward-tasks-drawer.tsx","control":"Daily check completion; generic commitment action when supplied"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":527,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":349,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-tasks-drawer.tsx","line":432,"sha256":"f14b8983f1421e5ab23f25dd3d11d6489cf9119e06884a1fcb58e8374c68018f"},{"path":"src/components/ward-management/delays/daily-check-line.tsx","line":286,"sha256":"488ea1f4f5286bbff224f264bfd40e405af78caae5ac7fe88f197679394d43f0"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":352,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":369,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":373,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"}]}},{"event":"REOPEN_INBOX_ITEM","name":"Reopen a completed row","group":"The coordinator's inbox","lane":"record","nodes":["rkInbox"],"roles":["coordinator"],"does":"Undoes a completed row, while keeping the fact that it was once completed.","needs":"It is currently complete.","changes":"Logs the reopening.","reasons":[],"refuses":[{"when":"Guard: inboxItemId.length === 0","message":"REOPEN_INBOX_ITEM inboxItemId must name a row — a blank names nothing","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":387}},{"when":"Guard: inboxItemCompletionState(history) !== \"complete\"","message":"inbox row ${inboxItemId} is not complete, so there is nothing to reopen","source":{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":391}}],"screen":{"screen":"ward-tasks-drawer.tsx","control":"Generic completion-history reopening action when a completed commitment is supplied"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":528,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":384,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-tasks-drawer.tsx","line":436,"sha256":"f14b8983f1421e5ab23f25dd3d11d6489cf9119e06884a1fcb58e8374c68018f"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":387,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":391,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"}]}},{"event":"ADVANCE_CLOCK","name":"Move the demonstration clock","group":"Running the demonstration","lane":"record","nodes":["rkClock"],"roles":["demo"],"does":"Adds a finite nonnegative simulation offset to the app clock. Ordinary provider time follows wall time, refreshing at minute boundaries while visible and catching up on return; initialNow pins deterministic test/render time.","needs":"The demo role and finite nonnegative minutes; coordinator is not in this event’s permission list.","changes":"Increases clockOffsetMinutes; it does not itself create a legal expiry or resolve a timed task. In the local provider, command acceptance precedes device durability: the saved-on-device flag remains false until the matching committed safe copy is written, and owned unsaved work is protected on unload. These persistence indicators do not add an engine transition.","reasons":[],"refuses":[{"when":"Guard: finiteInstant(event.minutes) === null || event.minutes \u003c 0","message":"ADVANCE_CLOCK minutes must be a finite, non-negative number","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1800}}],"screen":{"screen":"ward-global-search.tsx; tools/ward-demo-panel.tsx","control":"Global Search offers Advance demo clock (+15m), dispatching minutes=15 under role demo; the Demo panel also offers +15 min and +1 hour. Imperative search navigation and desk switching first consult the composed unsaved-work guard."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":105,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1807,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-global-search.tsx","line":1275,"sha256":"b7c651d7a0a3110b10e5d46aeb7ab769359393240cf55bb4024fc570504185ac"},{"path":"src/components/ward-management/tools/ward-demo-panel.tsx","line":268,"sha256":"002918ecd56f5d0f951247f9cbc1b96adccea94e8d024b3a82cb0ed46b6dbebc"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":440,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"},{"path":"src/components/ward-management/use-ward-minute-tick.ts","line":12,"sha256":"5637f3746158c8b09a50abf19699294ced1b1d25e91be6a7b03e870c746f7fa7"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1811,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"RESET_SCENARIO","name":"Reset the board","group":"Running the demonstration","lane":"record","nodes":[],"roles":["demo"],"does":"Restores the currently loaded recognised scenario, falling back to standard for a damaged scenario value.","needs":"Nothing.","changes":"Re-seeds all board state around the current visible time and clears the simulation offset, preserving the visible clock rather than always selecting the standard scenario. A genuine accepted reseed advances worldGeneration exactly once; wrong-role/rejected reseeds do not. A non-safe or exhausted generation refuses replacement by retaining the old state, so generation is never wrapped or reused. Reset also invalidates older asynchronous local scenario-file import requests. A newer import, reset, changed world generation or retired provider lifetime prevents an older read from replacing the current day. Imported local state is not reported durable before its device copy is written.","reasons":[],"refuses":[],"screen":{"screen":"ward-flow-provider.tsx; tools/ward-demo-panel.tsx","control":"Reset scenario"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":106,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1789,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":1133,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"},{"path":"src/components/ward-management/tools/ward-demo-panel.tsx","line":197,"sha256":"002918ecd56f5d0f951247f9cbc1b96adccea94e8d024b3a82cb0ed46b6dbebc"}]}},{"event":"SET_SCENARIO","name":"Switch to a different simulated night","group":"Running the demonstration","lane":"record","nodes":[],"roles":["demo"],"does":"Switches to a different pre-built simulated night, resetting every patient, ward and record.","needs":"A recognised scenario.","changes":"Replaces the whole state. A genuine accepted reseed advances worldGeneration exactly once; wrong-role/rejected reseeds do not. A non-safe or exhausted generation refuses replacement by retaining the old state, so generation is never wrapped or reused.","reasons":["WARD_SCENARIOS"],"refuses":[{"when":"Guard: !WARD_SCENARIOS.includes(event.scenario)","message":"SET_SCENARIO scenario must be chosen from WARD_SCENARIOS","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1791}}],"screen":{"screen":"demo-reset/ward-demo-reset.tsx; tools/ward-demo-panel.tsx","control":"Both pickers ask before replacing the synthetic world. The separate Demo reset waits for the command outcome, keeps choices unavailable while it is pending, and reports a current accepted replacement as complete. Failed, refused, cancelled or unknown completion is not reported as success, and obsolete or unmounted results do not announce into a replacement workspace."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":107,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1797,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/demo-reset/ward-demo-reset.tsx","line":131,"sha256":"8e2f79f5ec7d9a3e37df33fde6bad92cafe4a8412191b49c10751dd2bf600c9e"},{"path":"src/components/ward-management/tools/ward-demo-panel.tsx","line":197,"sha256":"002918ecd56f5d0f951247f9cbc1b96adccea94e8d024b3a82cb0ed46b6dbebc"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1802,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"SET_CONFIGURATION","name":"Change the coordinator's settings","group":"Running the demonstration","lane":"record","nodes":["rkSettings"],"roles":["coordinator"],"does":"Saves the tunable settings the rest of the system reads — access-time targets, the parallel referral cap, how long a bed hold lasts.","needs":"A validated complete configuration and, when supplied, a valid baseline. Conflicting edits since that baseline refuse; non-conflicting draft fields merge. Signed/shared access also enforces coordinator scope.","changes":"Applies the validated configuration or field merge atomically. It does not silently overwrite a conflicting baseline.","reasons":[],"refuses":[],"screen":{"screen":"settings-screen.tsx","control":"Save Configuration"},"review":{"reviewedOn":"2026-11-08","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":109,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1818,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/settings/settings-screen.tsx","line":443,"sha256":"aba9a6945556afdd1f1dba22fdb45f47b7f7e197829ff42ea2d94bdfb9ee3ab1"}]}},{"event":"RECORD_PATIENT_DISCHARGE","name":"Record a patient’s physical departure","group":"Not wired up here","lane":"record","nodes":["rkDischarge","personLeaves"],"roles":["ward","coordinator"],"does":"The protected discharge handler records physical departure of a linked occupied admission. It runs before the generic reducer switch; the later grouped switch case is not the behaviour.","needs":"Permitted ward/coordinator actor, finite time, current world generation and discharge revision, matching linked patient/stay, lawful destination and no active transit/restrictive-practice/open-return conflict.","changes":"Departs the stay through the shared departure helper, adjusts resources, retains audit and a bounded step-undo record. A stale or inaccessible request refuses.","reasons":[],"refuses":[{"when":"Guard: dischargeBlockingTransit(state, admission)","message":"Patient is currently in transit to another facility.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":445}}],"screen":{"screen":"ward-flow-provider.tsx (discharge context)","control":"Record departure through the discharge record context"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":22,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":471,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":1236,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":481,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"}]}},{"event":"OPEN_DISCHARGE_RECORD","name":"Open an authorised discharge record","group":"Not wired up here","lane":"record","nodes":["rkDischarge"],"roles":["coordinator","ward","community","bed_manager"],"does":"Checks actor access to a discharge record and appends its protected open/read audit receipt. It runs before the generic switch.","needs":"A valid actor, current generation, valid request id/optional namespace and an accessible admission. A coordinator must also give an on-behalf-of-the-ward reason from the closed `ON_BEHALF_REASONS` list (D-80 item 17); any other desk sends none. A repeated matching receipt is reused only while that read remains allowed.","changes":"Records an accepted read audit event, carrying the coordinator's listed reason as `onBehalfReason`; changes no admission or bed figure.","reasons":[],"refuses":[{"when":"Guard: event.role === \"coordinator\" ? !isOnBehalfReason(event.onBehalfReason) : event.onBehalfReason !== undefined","message":"Choose why you are opening this ward's record on the ward's behalf. Nothing was opened.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":186}}],"screen":{"screen":"ward-flow-provider.tsx (discharge context)","control":"Open the discharge record through its audited context; the Discharges board and the Capacity ward drawer ask a coordinator for the reason first"},"review":{"reviewedOn":"2026-11-09","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":25,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":178,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-provider.tsx","line":1265,"sha256":"e9e61e8c9565b8eb4de566ce23b51268e47702fd15b37db757c29eee675d48f7"}]}},{"event":"REVIEW_AUDIT_EVENT","name":"Record a governance review","group":"Not wired up here","lane":"record","nodes":[],"roles":["coordinator"],"does":"The coordinator records one listed review decision against an accessible audit event, including supported synthetic governance entries. It runs before the generic switch.","needs":"Coordinator, finite time, current generation and expected review count, a non-review audit entry in this generation and safe counters.","changes":"Appends a uniquely sequenced review and its audit record. A later review changes the expected count; UNDO_AUDIT_REVIEW is a separate recorded action.","reasons":[],"refuses":[],"screen":{"screen":"governance-registers.tsx","control":"Governance review decision"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":26,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":131,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/governance-registers.tsx","line":546,"sha256":"c68c89bd3aa60a17ca378d9e3f369d3ee42ffa57ac035d1ca8ebd4e29c8b634d"}]}},{"event":"RECORD_DIVERSION","name":"Divert a journey already under way","group":"The journey","lane":"diversion","nodes":["rkDiversion"],"roles":["officer","coordinator"],"does":"Records that a patient already in the vehicle was taken somewhere other than the ward expecting them, with a reason and the place they went.","needs":"A transport job that has been collected, on a movement that is open, not arrived, not already stopped or cancelled, and not already diverted.","changes":"Marks the movement diverted and records where the patient is. The held bed is NOT given back by this act.","reasons":["DIVERSION_REASONS"],"refuses":[{"when":"Guard: movement.transport.collectedAt === undefined","message":"movement ${movement.id}'s transport has not been collected yet; diversion is only for a journey already under way","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1150}},{"when":"Guard: movement.transport.arrivedAt !== undefined","message":"movement ${movement.id}'s patient has already arrived","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1154}},{"when":"Guard: movement.transport.stoppedAt !== undefined || movement.transport.cancelledAt !== undefined","message":"movement ${movement.id}'s transport was already stopped or cancelled","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1157}},{"when":"Guard: movement.transport.diversion","message":"movement ${movement.id} was already diverted","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1160}},{"when":"Guard: !DIVERSION_REASONS.includes(event.reason)","message":"RECORD_DIVERSION reason must be chosen from DIVERSION_REASONS","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1163}}],"screen":{"screen":"officer/officer-job-detail.tsx (via use-officer-diversion-save.ts); movements/movement-workspace-cockpit.tsx","control":"Divert Diversion reason/place and pending save are guarded against outer dismissal. Draft and completion belong to the same access lifetime, movement and transport job; another job is not recorded or dismissed by an old completion."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":192,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1092,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/officer/use-officer-diversion-save.ts","line":66,"sha256":"bd611831cda3c81a8e99cf89c4d375acbb2e9e95948890a8880e7a9b4425b77b"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1678,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1105,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1109,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1112,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1115,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1118,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"RELEASE_DIVERTED_BED","name":"Give back the bed a diverted patient was holding","group":"Holding the bed","lane":"record","nodes":["rkDiversion"],"roles":["coordinator","ward","ed"],"does":"Releases the bed still held for a movement that was diverted. Separate from the diversion itself, deliberately: diverting somebody does not decide what happens to their bed.","needs":"A movement that really was diverted, and that still holds a bed.","changes":"Returns the bed to the ward's figures.","reasons":[],"refuses":[{"when":"Guard: movement.transport?.diversion === undefined","message":"movement ${movement.id} was not diverted, so there is no diverted bed to release this way","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":634}},{"when":"Guard: movement.closure !== undefined || !movementHoldsBedByStage(movement)","message":"movement ${movement.id} has no bed pulled — it may already have been released","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":640}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"RELEASE_DIVERTED_BED was raised acting as unit ${event.actingUnitId} but movement ${movement.id}'s bed is pulled at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":646}}],"screen":{"screen":"movements/movement-workspace-cockpit.tsx; ward/ward-arrivals-corridor.tsx; ed/ed-screen-referred.tsx","control":"Release the diverted bed"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":194,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":686,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/movements/movement-workspace-cockpit.tsx","line":1168,"sha256":"2ef8ebba0653d4efbf1d7e0928f60095bef89af5668a243bfec29833df47d09e"},{"path":"src/components/ward-management/ward/ward-arrivals-corridor.tsx","line":662,"sha256":"572956c1b4769defd00bc1a5dc027ff2d76c476388cee6d36833c8321e3824a4"},{"path":"src/components/ward-management/ed/ed-screen-referred.tsx","line":357,"sha256":"0b0d6dde9843e2750f4dbadd23e4e7d9c30b2c2c9eee9e4f2c539961a97568aa"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":693,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":699,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":705,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"SET_ARRIVAL_DETAILS","name":"Record how and when they are expected","group":"The journey","lane":"record","nodes":["edExpected"],"roles":["coordinator","ed","ward","community"],"does":"Records the way the patient is travelling, any tracking number, and the time they are expected.","needs":"An open movement with an accepted ward. A ward names itself and matches that receiving ward; coordinator may also act.","changes":"Stores arrival mode, optional tracking and estimate, retaining first-record author/time and later update provenance. Keeps the pull-expiry timer. An already-late estimate can send one-time ED/ward notices; it reserves no bed and moves no stage.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1132}},{"when":"Guard: movement.closure","message":"cannot update arrival details on closed movement","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1134}}],"screen":{"screen":"arrival-time-modal.tsx","control":"Set arrival details The arrival dialog names the patient and record, keeps edited answers on Keep editing, requires explicit Discard details before an unsaved close, and blocks dismissal while pending. A delayed discard only closes the unchanged current mounted draft; saving closes only on a current accepted outcome."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":534,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1165,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/referrals/arrival-time-modal.tsx","line":173,"sha256":"b4b6a5c54f7517706f955942876fa195982fdfccf9fe481094705fa9ceae98f5"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1167,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1169,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"EVALUATE_ARRIVAL_LATENESS","name":"Work out whether an expected arrival is late","group":"The journey","lane":"record","nodes":["edExpected"],"roles":["coordinator","ed","ward"],"does":"Compares the expected arrival time against the clock and records whether it has passed.","needs":"A movement, and a role allowed to ask.","changes":"When late, stamps the movement and sends notices to the emergency department and ward. When on time, leaves it unchanged. No journey stage moves.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1216}},{"when":"Guard: movement.closure","message":"This movement is closed.","source":{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1217}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Review late arrival"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":555,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1250,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":140,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1252,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1253,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"}]}},{"event":"SET_STEP_DOWN_CANDIDATE","name":"Mark somebody as a step-down candidate","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Records that this admission could move to a lower level of care.","needs":"An existing admission. A ward must name that admission’s ward; coordinator permission is separate.","changes":"Sets the flag, and nothing else. No bed figure moves.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":720}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== admission.unitId","message":"SET_STEP_DOWN_CANDIDATE was raised acting as unit ${event.actingUnitId} but admission ${admission.id} is at ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":726}}],"screen":{"screen":"board/ward-board-detail-panel.tsx","control":"Step-down candidate"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":535,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":702,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":508,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":704,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":710,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"SET_DISCHARGE_BARRIER","name":"Record what is holding a discharge up","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Records the single thing in the way of this discharge, or that nothing is.","needs":"An existing admission, the acting ward when role is ward, and a listed barrier or None/null. The reducer does not impose a seven-day minimum.","changes":"Replaces the discharge-barrier field, with None normalised to null. It records a reason; it does not free or reserve a bed.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":743}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== admission.unitId","message":"SET_DISCHARGE_BARRIER was raised acting as unit ${event.actingUnitId} but admission ${admission.id} is at ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":748}}],"screen":{"screen":"ward/ward-screen-overlays.tsx; board/ward-board-detail-panel.tsx","control":"Discharge barrier"},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":540,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":725,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-screen-overlays.tsx","line":329,"sha256":"27f313a7a06534fcdb3003ce8e31074b16648e74280f57980b2e051d81a16dd8"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":549,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":727,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":732,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"SET_CLINICALLY_READY","name":"Record clinically ready and why not gone","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Records the day a patient on the ward became clinically ready for discharge and the one reason they have not gone, or clears both (Josh, 9 Nov 2026).","needs":"An occupied admission, the acting ward when role is ward, a day from arrival to today and a reason from DELAYED_DISCHARGE_REASONS (the long-stay list less Clinical / Treatment), or null to clear.","changes":"Sets or clears clinicallyReadySince and delayedDischargeReason together. Delayed bed days by reason are derived from them; no bed is freed or reserved.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":759}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== admission.unitId","message":"SET_CLINICALLY_READY was raised acting as unit ${event.actingUnitId} but admission ${admission.id} is at ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":764}},{"when":"Guard: admission.state !== \"occupied\" || admission.arrivedAt === null","message":"SET_CLINICALLY_READY applies only to a patient on the ward","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":768}},{"when":"Guard: !isDelayedDischargeReason(ready.reason)","message":"SET_CLINICALLY_READY reason must be chosen from DELAYED_DISCHARGE_REASONS","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":774}},{"when":"Guard: the day is not finite, is before the arrival day or after today","message":"SET_CLINICALLY_READY date must fall between arrival and today","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":782}}],"screen":{"screen":"board/ward-board-clinically-ready.tsx","control":"Clinically ready since"},"review":{"reviewedOn":"2026-11-09","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":542,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":757,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/board/ward-board-clinically-ready.tsx","line":95,"sha256":"e96eb8cc65cf8106ffb61275d82972e5b40617de1b68c6dceb0737fb47a3ef78"}]}},{"event":"UPDATE_EXPECTED_DISCHARGE","name":"Set or move the expected discharge date","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Sets when this admission is expected to leave. Moving a date already set counts as one more move.","needs":"An admission that has not already left. A ward can only set it for its own patients. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Sets the expected time, increments date-move count only when an existing date differs, and stamps when. A ward setter is Nurse in charge; coordinator setter is null. Pending linked bed-release dates follow; completed release dates stay historical.","reasons":[],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":226}},{"when":"Guard: admission.state === \"departed\"","message":"cannot update expected discharge for departed admission ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":229}},{"when":"Guard: event.role === \"ward\" && (!event.actingUnitId || event.actingUnitId !== admission.unitId)","message":"UPDATE_EXPECTED_DISCHARGE was raised acting as unit ${event.actingUnitId ?? \"unspecified\"} but admission ${admission.id} belongs to unit ${admission.unitId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":235}},{"when":"Guard: typeof event.expectedDischargeAt !== \"number\" || !Number.isFinite(event.expectedDischargeAt)","message":"UPDATE_EXPECTED_DISCHARGE expectedDischargeAt must be a valid timestamp","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":239}}],"screen":{"screen":"ward/ward-drawer-discharge-date.tsx; board/ward-board-detail-panel.tsx; patients/patient-now-screen.tsx; discharges/discharge-detail-panes.tsx","control":"Update expected departure The ward drawer fixes its day choices when the editor opens, so a save made just after midnight keeps the day that was chosen."},"review":{"reviewedOn":"2026-11-07","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":23,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":224,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward/ward-drawer-discharge-date.tsx","line":81,"sha256":"54731b0b51ea23bdd098e653f19cefc60e759ac91e8a170418a96e9837f3aa87"},{"path":"src/components/ward-management/board/ward-board-detail-panel.tsx","line":385,"sha256":"a6190fbbd536d39477392e2b3cae399adf0a642e903fe18ce329ceb12472a177"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":734,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/discharges/discharge-detail-panes.tsx","line":304,"sha256":"e5336a5cf0037d9c50af5a381b33e5ac5f8278de1a800067197254a82a19aec3"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":227,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":230,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":236,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":240,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"RECORD_ADMISSION_CARE","name":"Record care journey fact","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator","community"],"does":"Records a care journey fact (such as a transfer, transport, clinical plan or document) against an admission on the discharge board.","needs":"Current generation/revision, permitted ward/coordinator/community actor and accessible linked occupied/departed stay. Community writes only its allowed care kinds for its own team; transfer acceptance and cancellation are coordinator-only, and an accepted or handover transfer step needs a linked placement record (a ward referral or agreed repatriation). Change-kind validation and sequence-specific guards apply. A transfer recorded as arrived also needs a Ready bed at the receiving ward once its live pulls are counted.","changes":"Appends or updates the care journey record. Moves no bed figure — except a transfer recorded as arrived, which also ends this admission as transferred, opens a new occupied admission and an arrived movement at the receiving ward, completes any live bed release for the leaver, and moves both wards' bed figures.","reasons":[],"refuses":[{"when":"Guard: patientRecordIsInvoluntary(patient?.legalStatus) || stayLegalStatusIsInvoluntary(state, admission)","message":"Record the checked transport authority for this involuntary arrangement.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":254}},{"when":"Guard: previous !== \"5A\" && previous !== \"5B\"","message":"A Form 5B continuation needs a recorded Form 5A or earlier Form 5B for this stay.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":262}},{"when":"Guard: transfer accepted/handover && !dischargeMovement(state, admission)","message":"Create a linked placement record through a ward referral or agreed repatriation before recording this transfer.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":255}},{"when":"Guard: pulledBedAvailability(receiving, livePulled).ready \u003c= 0","message":"No Ready bed remains at the receiving ward.","source":{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":330}}],"screen":{"screen":"discharge-care-journey.tsx","control":"Record care fact"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":20,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":228,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1737,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward/ward-leave-paper-authority.tsx","line":141,"sha256":"e8727edeed2ac11af122dcd34039702137c3355dc9404cf567e5d1316f14fff7"},{"path":"src/components/ward-management/discharges/discharge-care-journey.tsx","line":122,"sha256":"ccb0ccd1a1dd746abeef58fb9f7c3aa79e38c0316a68b6a3160ffe85c7dd44f4"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":274,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":282,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"}]}},{"event":"RECORD_ADMISSION_FOLLOW_UP","name":"Record follow-up arrangement","group":"On the ward","lane":"record","nodes":["rkDischargePlan"],"roles":["ward","coordinator"],"does":"Records follow-up contact arrangements against an admission on the discharge board.","needs":"Current generation/revision, permitted ward/coordinator actor and accessible linked occupied/departed stay. The listed follow-up state cannot be recorded after death on the ward, or before arrival.","changes":"Updates the follow-up arrangement on the admission. Moves no bed figure.","reasons":[],"refuses":[],"screen":{"screen":"discharge-follow-up.tsx","control":"Record follow-up"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":21,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":448,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1738,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/discharges/discharge-follow-up.tsx","line":87,"sha256":"807a917c3e51421e00d0e3aea3f79340f47939406bd66baea66e7312372dcce6"}]}},{"event":"RECORD_MOVEMENT_MEDICAL_CLEARANCE","name":"Record medical clearance against the movement","group":"Finding a bed","lane":"record","nodes":["rkClearance"],"roles":["ed","coordinator"],"does":"Records clearance on a movement and synchronises its matching linked referral. Fresh positive clearance resumes a recorded deterioration pause.","needs":"An existing movement, ED/coordinator role, finite recording time and boolean answer; an ED must name itself and be the journey's origin ED (M2); positive re-clearance must follow the recorded deterioration. In the patient workspace, an exceptional record opening is read only: patient-scoped UI gates do not offer this mutation. An ordinary authorised caller retains its own route role and the relevant stay/receiving-ward claim; a desk-switch hint grants no authority.","changes":"Replaces clearance on the movement, matching linked referral and matching sibling movements. Positive fresh clearance records resumedAt for satisfied pauses; it does not restore released resources.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1321}},{"when":"Guard: event.role !== \"ed\" && event.role !== \"coordinator\"","message":"role ${event.role} cannot record movement medical clearance; only ed or coordinator may record clearance","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1326}},{"when":"Guard: event.role === \"ed\" && actingPlaceId is not the journey's originEdId","message":"Only the originating ED may record medical clearance for this journey.","source":{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1283}}],"screen":{"screen":"ed/ed-medical-placement-controls.tsx; patients/patient-now-screen.tsx","control":"Medically cleared"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":543,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1271,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ed/ed-medical-placement-controls.tsx","line":148,"sha256":"89a5797a48cde8abca855128c5449c6b73e4dae9a065352fb94e6810d203dbec"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":1423,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1273,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1278,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"}]}},{"event":"UPLOAD_PATIENT_FORM","name":"Attach a file to the movement","group":"Legal status and examinations","lane":"record","nodes":["rkLegalWritten"],"roles":["coordinator","ed","ward","community","officer"],"does":"Records document type, recognised file type and byte size as attachment metadata. The selected file’s name and bytes are not stored by this event.","needs":"An existing movement, nonblank document type, recognised file type and positive safe-integer byte size. Legacy filenames are read only to derive their type.","changes":"Appends generated document id, formName, fileType, sizeBytes and role/time metadata; no file body or original filename is retained.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":789}},{"when":"Guard: event.fileType === undefined && (typeof legacyName !== \"string\" || legacyName.trim().length === 0)","message":"Document details need a recognised file type.","source":{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":800}}],"screen":{"screen":"upload-forms-modal.tsx","control":"Upload a form"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":544,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":771,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/officer/officer-forms-pack.tsx","line":293,"sha256":"bec740b858e305b841f30e084461ba51f96e7c63b939c2394771c1ab06728d02"},{"path":"src/components/ward-management/referrals/upload-forms-modal.tsx","line":75,"sha256":"070b8a39d8755ece7a56af9cb756aaf8714457c3751d29f1c468ef6a7cf4b18b"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":777,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":788,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"}]}},{"event":"RECORD_LEGAL_FORM_WRITTEN","name":"Record that a legal form was written","group":"Legal status and examinations","lane":"record","nodes":["rkLegalWritten"],"roles":["ed","coordinator","ward"],"does":"Records which form was written, with typed start and expiry times.","needs":"A supported form, finite typed written time and any typed expiry. A ward requires an admitted stay; ED requires an open movement, while an admitted stay permits the coordinator/ward path after arrival. 3C after3D refuses; this event cannot shorten existing same-form paper expiry.","changes":"Stores current paper facts and history, preserves matching same-form paper facts on a time edit, and clears a calculated legacy clock. A different form clears the old receipt. A same-form time edit also keeps the details typed from that paper and the typed receipt mark; a different form clears them.","reasons":[],"refuses":[{"when":"Guard: movement.closure && !(admitted && event.role !== \"ed\")","message":"cannot record a written form for a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":233}},{"when":"Guard: !isLegalClockFormCode(event.formCode)","message":"That form is not a recognised legal form in this prototype","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":244}},{"when":"Guard: event.formCode === \"3C\" && form3CRefusedAfter3D(movement.legalForm?.code ?? movement.legalClock?.code)","message":"Form 3C is refused when the person arrived on a Form 3D","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":247}}],"screen":{"screen":"legal-forms-screen.tsx","control":"Record a written form"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":546,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":275,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/legal-forms/legal-forms-screen.tsx","line":524,"sha256":"6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":299,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":313,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":316,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}]}},{"event":"RECORD_LEGAL_FORM_CONTINUATION","name":"Record that a form was continued","group":"Legal status and examinations","lane":"record","nodes":["rkLegalWritten"],"roles":["ed","coordinator","ward","community"],"does":"Records a continuation with typed times. A 5B continues a 5A; other supported forms can replace paper facts without a prior form.","needs":"An open movement, supported form and valid typed start and expiry times. On a ward desk only the ward that accepted the person may record it (D-128); the app checks the named ward and the shared server checks it is the caller's own place.","changes":"Stores the paper form and typed expiry, clears the old legal clock and the typed receipt mark.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":345}},{"when":"Guard: !isLegalClockFormCode(event.formCode)","message":"That form is not a recognised legal form in this prototype","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":355}},{"when":"Guard: event.role === \"ward\" && actingUnitId is not movement.acceptedUnitId","message":"Only the ward that accepted this person can record a continuation.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":425}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Record legal form continuation"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":554,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":415,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":322,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":417,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":437,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}]}},{"event":"RECORD_COUNTRY_EXTENSION","name":"Record a typed country Form 1A extension","group":"Legal status and examinations","lane":"record","nodes":["rkLegalWritten"],"roles":["ed","coordinator"],"does":"For an eligible open country Form1A, forwards the clinician’s typed paper expiry through RECORD_LEGAL_FORM_EXPIRY. It computes no statutory deadline.","needs":"An existing open movement carrying current Form1A with paper region country, a finite paperExpiresAt and the ordinary expiry extension rules.","changes":"Records the typed expiry and expiry history through the standard expiry handler, clearing any calculated legacy clock.","reasons":[],"refuses":[{"when":"Guard: movement.closure || event.paperExpiresAt === undefined || !Number.isFinite(event.paperExpiresAt)","message":"Country extensions are recorded as a typed expiry. Enter the new expiry written on the country extension form.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":317}},{"when":"Guard: !countryExtensionEligible(movement)","message":"A country extension requires a current Form 1A with its paper setting recorded as country.","source":{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":323}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Record country paper extension"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":553,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":382,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":359,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":389,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":395,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}]}},{"event":"FLAG_LEGAL_MISMATCH","name":"Flag that the ward's authority does not match","group":"Legal status and examinations","lane":"record","nodes":["rkLegalMismatch"],"roles":["ward","coordinator"],"does":"Records one of two mismatches: an involuntary patient on a voluntary ward, or a voluntary patient on a locked one.","needs":"An open movement and real ward. The submitted mismatch kind must match the current patient legal status and ward authority/bed configuration.","changes":"Raises the flag. It does not stop anything by itself.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2216}},{"when":"Guard: !unit","message":"no unit found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2219}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Flag current legal placement mismatch"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":559,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2265,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":187,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2241,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2267,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"RAISE_EXPECT_FLAG","name":"Start a forty-eight-hour or seven-day clock by hand","group":"Urgency and blockers","lane":"record","nodes":["rkExpectFlag"],"roles":["ward","coordinator","ed","community"],"does":"Raises one of two hand-set clocks against a movement.","needs":"An open movement with no uncleared flag and kind voluntary_48h or involuntary_7d.","changes":"Records the current manually raised flag. Replacing a previously cleared flag keeps that prior record in expectFlagHistory; no automatic state transition is implied.","reasons":[],"refuses":[{"when":"Guard: movement.closure","message":"This movement is closed.","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2195}},{"when":"Guard: movement.expectFlag && movement.expectFlag.clearedAt === undefined","message":"movement ${movement.id} already has an open expect flag","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2197}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Raise expectation review flag"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":558,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2206,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":116,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2239,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2244,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"CLEAR_EXPECT_FLAG","name":"Clear that hand-set clock","group":"Urgency and blockers","lane":"record","nodes":["rkExpectFlag"],"roles":["ward","coordinator","ed","community"],"does":"Clears the flag raised above.","needs":"An open movement with an uncleared expect flag.","changes":"Stamps clearedAt and clearedBy on the flag; it is retained rather than removed.","reasons":[],"refuses":[{"when":"Guard: !movement","message":"no movement found for id ${event.movementId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2180}},{"when":"Guard: !movement.expectFlag || movement.expectFlag.clearedAt !== undefined","message":"movement ${movement.id} has no open expect flag to clear","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2183}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Clear expectation review flag"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":557,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2192,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":114,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2194,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2197,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"RELEASE_AND_REOPEN_SEARCH","name":"Give the bed back and reopen the search, in one act","group":"Holding the bed","lane":"stall","nodes":["sPullReleased"],"roles":["coordinator","ward"],"does":"Releases the held bed AND puts the movement back into the bed search together, rather than as two separate steps.","needs":"An open movement at pulled or accepted_awaiting_bed, a listed release reason and no live booking; a ward must match the accepting ward. A bed need not already be held on the accepted-only branch.","changes":"Returns any matching held bed, clears acceptance/hold/requests/transport and moves to placement_requested. Logs pull release when held, otherwise acceptance withdrawal. For a return movement with sourceAdmissionId, the in-app release/withdrawal notice targets the actual sending stay ward. Ordinary ED/community origins retain their existing recipient paths; no external-provider delivery is implied.","reasons":["RELEASE_PULL_REASONS"],"refuses":[{"when":"Guard: movement.closure","message":"cannot release and reopen a closed movement (${movement.closure.reason})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":757}},{"when":"Guard: movement.stage !== \"pulled\" && movement.stage !== \"accepted_awaiting_bed\"","message":"cannot release and reopen at the movement's current stage (${stageCopy[movement.stage].label})","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":763}},{"when":"Guard: !RELEASE_PULL_REASONS.includes(event.reason)","message":"RELEASE_AND_REOPEN_SEARCH reason must be chosen from RELEASE_PULL_REASONS","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":774}},{"when":"Guard: event.role === \"ward\" && event.actingUnitId !== movement.acceptedUnitId","message":"RELEASE_AND_REOPEN_SEARCH was raised acting as unit ${event.actingUnitId} but movement ${movement.id}'s bed is at ${movement.acceptedUnitId}","source":{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":780}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Release held bed and reopen search"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":556,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":812,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":228,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":816,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":822,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":833,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":839,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"}]}},{"event":"CONFIRM_MORNING_ROLLUP","name":"Confirm the ward's morning count","group":"The ward's own numbers","lane":"record","nodes":["rkWardDay"],"roles":["ward","bed_manager","coordinator"],"does":"A ward confirming how many discharges it expects that morning.","needs":"The acting ward must match the target; the count must be a nonnegative safe integer.","changes":"Records the confirmed number against the ward.","reasons":[],"refuses":[{"when":"Guard: !unit","message":"no unit found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2239}},{"when":"Guard: (event.role === \"ward\" && event.actingUnitId === undefined) || (event.actingUnitId !== undefined && event.actingUnitId !== event.unitId)","message":"CONFIRM_MORNING_ROLLUP was raised acting as unit ${event.actingUnitId} but targets unit ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2249}}],"screen":{"screen":"ward-screen.tsx","control":"Confirm the morning rollup"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":565,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2262,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward/ward-screen.tsx","line":1079,"sha256":"5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2264,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2254,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"SEND_WARD_BUZZ","name":"Send a message to a ward","group":"The ward's own numbers","lane":"record","nodes":["rkWardDay"],"roles":["coordinator","bed_manager"],"does":"Records a ward refresh request with a listed message and optional urgent boolean. It sends no external message.","needs":"A real unit, a message from WARD_BUZZ_MESSAGES and, if supplied, a boolean urgent answer. Blank/unlisted messages refuse.","changes":"Appends a refresh-request record with role/time, message and urgency; moves no bed figure.","reasons":[],"refuses":[{"when":"Guard: !WARD_BUZZ_MESSAGES.includes(event.message) || (event.urgent !== undefined && typeof event.urgent !== \"boolean\")","message":"Choose a valid ward refresh message.","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2273}},{"when":"Guard: !unit","message":"no unit found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2275}}],"screen":{"screen":"movement-workflow-actions.tsx","control":"Request ward capacity review"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":566,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2293,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":210,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2298,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2325,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}]}},{"event":"EVALUATE_LEAVE_BED_WARNINGS","name":"Sweep the beds held during leave","group":"The ward's own numbers","lane":"record","nodes":["rkWardDay"],"roles":["ward","coordinator"],"does":"Works out which beds being held while somebody is on leave are worth warning about.","needs":"Nothing but the clock — it takes no patient and no ward.","changes":"For each leave bed over the open-warning threshold that has not been warned, records openWarningAt and sends a ward notice. It does not release the bed or move capacity.","reasons":[],"refuses":[],"screen":{"screen":"movement-workflow-actions.tsx","control":"Review leave bed warnings"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":564,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":819,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/movements/movement-workflow-actions.tsx","line":163,"sha256":"650137e651d6fe56400b63cee0f307dfbbf5021f929fcefe34a7f6af50ed48ee"}]}},{"event":"RECORD_REPATRIATION","name":"Log a repatriation arranged by phone","group":"The journey","lane":"record","nodes":["dRepat"],"roles":["coordinator"],"does":"Logs a repatriation already arranged off the system: the home hospital, whether its ward agreed, road or flight, and voluntary or involuntary, with the provider, the CAD or tracking number and an estimated time when known (W13, 5 Nov 2026: each left out warns, and a blank CAD is CAD to follow; a typed depart time the form cannot read blocks the plan form rather than recording without it). It books nothing.","needs":"A non-departed admission with valid home hospital, mode and legal status. A provider, if given, must be listed; a typed CAD must pass the CAD rule; an estimate, if given, must be finite. An unanswered prior plan may later be agreed once; an agreed plan cannot be agreed again while its return remains open; after a did_not_proceed closure a distinct new attempt may be agreed. An involuntary stay cannot be logged as a voluntary return. Any still-open return for the source stay refuses another plan. A retained agreed plan may start a distinct new attempt only after its linked return closed did_not_proceed; this retry qualification does not allow duplicate live returns or duplicate agreement of an active plan.","changes":"Creates or updates the telephone plan. Each distinct plan’s first agreement creates an open placement_requested return movement linked to the source stay; it does not itself book transport or transfer the patient. A retry preserves its prior closed journey and a flat earlier plan snapshot while replacing the single current plan for that stay. Agreed return origin site/ED lookup follows the saved scenario network. Local restore validates flat prior records and retains typed CAD values only as the redaction placeholder. An agreement that does not repeat the plan's provider or estimated time keeps the plan's own; a value it gives wins.","reasons":["TRANSPORT_PROVIDERS","TRANSPORT_LEGAL_STATUSES"],"refuses":[{"when":"Guard: !admission","message":"no admission found for id ${event.admissionId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":471}},{"when":"Guard: existingRecord && (existingRecord.receivingWardAgreed || event.receivingWardAgreed !== true)","message":"admission ${admission.id} already has a repatriation record","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":496}},{"when":"Guard: !scenarioHasSite(state.scenario, event.homeHospital)","message":"RECORD_REPATRIATION homeHospital ${event.homeHospital} does not name a real site","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":499}},{"when":"Guard: typeof event.receivingWardAgreed !== \"boolean\"","message":"RECORD_REPATRIATION receivingWardAgreed must be answered, and it has no default","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":502}},{"when":"Guard: !(REPATRIATION_MODES as readonly string[]).includes(event.mode)","message":"RECORD_REPATRIATION mode must be chosen from REPATRIATION_MODES","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":505}},{"when":"Guard: event.provider !== undefined && !(TRANSPORT_PROVIDERS as readonly string[]).includes(event.provider)","message":"RECORD_REPATRIATION provider must be chosen from TRANSPORT_PROVIDERS","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":508}}],"screen":{"screen":"out-of-area-board.tsx","control":"Record repatriation After the latest linked return journey is closed did_not_proceed, the Out of area screen reopens the return-plan form rather than treating the older agreed plan as still active. Historical records remain; retry acceptance and creation of another journey remain engine decisions."},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":568,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":478,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/out-of-area/out-of-area-board.tsx","line":418,"sha256":"0e5d43b3a020ff60e265e2e4fb200f16d505dd667d737677943fdc01ff23f26d"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":481,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":506,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":509,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":512,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":515,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":518,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_HANDOVER_SIGN_OFF","name":"Sign off the shift handover","group":"The ward's own numbers","lane":"record","nodes":["rkWardDay"],"roles":["coordinator","ward"],"does":"Records that the shift handover was signed off.","needs":"A permitted role and, when supplied, a real ward. A sign-off cannot name both a ward and the whole network; signed/shared scope further limits the acting desk.","changes":"Appends role/time plus the selected ward id or network flag. It records no personal name/note and makes no claim that a sheet was sent.","reasons":[],"refuses":[{"when":"Guard: event.unitId !== undefined && !findUnit(state, event.unitId)","message":"no ward found for id ${event.unitId}","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":452}},{"when":"Guard: event.network === true && event.unitId !== undefined","message":"a sign-off names one ward or the whole network, not both","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":455}}],"screen":{"screen":"handover/handover-scope-rules.ts","control":"Sign off the handover The handover being reviewed retains outgoing ward journeys through the linked source stay or referral origin and outgoing community journeys through their originating team. Display inclusion does not widen the desk allowed to sign off."},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":577,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":457,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/handover/handover-scope-rules.ts","line":113,"sha256":"a5ef90b1a994a20b49344788004bcd8160e5f58383e77fa48a82bde80e67f198"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":462,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":465,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"RECORD_CLINICAL_CONTACT","name":"Record that a team was contacted","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["community","coordinator"],"does":"Records that somebody contacted a community team. This is the contact itself, not a message sent through the system.","needs":"A community team that exists.","changes":"Stores the team, the time and the role.","reasons":[],"refuses":[{"when":"Guard: !team","message":"RECORD_CLINICAL_CONTACT teamId ${event.teamId} does not name a real team","source":{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":648}}],"screen":{"screen":"community/use-community-contact-save.ts","control":"Contacted"},"review":{"reviewedOn":"2026-11-05","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":585,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":659,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/community/use-community-contact-save.ts","line":154,"sha256":"6503061cec64069859f3ed3a8f52042ef6d18bce27c5de7c37f88bfe8ab5da8e"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":663,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"}]}},{"event":"DISPATCH_BROADCAST_ALERT","name":"Send a network-wide alert","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["coordinator","bed_manager"],"does":"Sends an alert to wards and emergency departments across the network, with a severity, a category, who it is aimed at and how long it lasts.","needs":"Nonblank title/message; listed severity/category/scope; finite positive duration; directive or bed_call kind; any explicit recipients must be real ward/ED desks. A bed call requires at least one targeted ward.","changes":"Adds the alert as active, with nobody yet acknowledging it. It belongs to no patient.","reasons":[],"refuses":[{"when":"Guard: !event.title.trim() || !event.message.trim()","message":"DISPATCH_BROADCAST_ALERT requires a non-empty title and message","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":71}},{"when":"Guard: finiteInstant(event.durationMinutes) === null || event.durationMinutes \u003c= 0","message":"DISPATCH_BROADCAST_ALERT durationMinutes must be a finite positive number","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":92}}],"screen":{"screen":"alerts-screen.tsx","control":"+ Broadcast Network Alert"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":594,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":69,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":827,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":71,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":92,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"}]}},{"event":"ACKNOWLEDGE_BROADCAST_ALERT","name":"Acknowledge a network-wide alert","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["coordinator","ward","ed","officer","community","bed_manager"],"does":"Records that one ward or desk has seen a network-wide alert.","needs":"An active alert and known ward/ED desk not already acknowledged; the special coordinator desk id requires coordinator role. Signed access must match the actor’s actual desk.","changes":"Adds the unit to the alert's acknowledged list.","reasons":[],"refuses":[{"when":"Guard: !target","message":"ACKNOWLEDGE_BROADCAST_ALERT alertId ${event.alertId} not found","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":155}},{"when":"Guard: !isAlertActive(target, event.now)","message":"ACKNOWLEDGE_BROADCAST_ALERT alertId ${event.alertId} is no longer active","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":178}}],"screen":{"screen":"shell/ward-broadcast-banner-body.tsx; shell/ward-broadcast-banner.tsx","control":"Acknowledge this directive for your desk; desk comes from current signed/route context"},"review":{"reviewedOn":"2026-11-03","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":595,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":151,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/shell/ward-broadcast-banner-body.tsx","line":130,"sha256":"a96ae00d184b52341105eb90f8a0438f5f5561f787c2522f97e0e7ea62e87178"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":155,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":178,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"}]}},{"event":"STAND_DOWN_BROADCAST_ALERT","name":"Stand down a network-wide alert","group":"The coordinator's inbox","lane":"record","nodes":["rkNotice"],"roles":["coordinator","bed_manager"],"does":"Ends a network-wide alert once the pressure has passed.","needs":"An alert that exists and has not already been stood down.","changes":"Marks the alert stood down, with the time and who did it.","reasons":[],"refuses":[{"when":"Guard: !target","message":"STAND_DOWN_BROADCAST_ALERT alertId ${event.alertId} not found","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":202}},{"when":"Guard: target.status === \"stood_down\"","message":"STAND_DOWN_BROADCAST_ALERT alertId ${event.alertId} is already stood down","source":{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":208}}],"screen":{"screen":"alerts-screen.tsx","control":"Stand Down Directive"},"review":{"reviewedOn":"2026-11-06","sources":[{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":596,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":198,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/alerts-screen.tsx","line":861,"sha256":"f6c8553c1f95d0d24d39598f85249f0988d98668dc7e9bbc951fd80bce56ab72"},{"path":"src/components/ward-management/shell/ward-broadcast-banner.tsx","line":125,"sha256":"d34087fc1cfb2356065997d7942882cd1bc9791e3041e71ec0fb0d279fe429be"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":202,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":208,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"}]}}],"stages":{"width":2880,"height":4832,"spineX":910,"nodes":[{"id":"srcCommunity","lane":"expected","x":60,"y":66,"w":236,"h":62,"label":"A community team","phase":"front"},{"id":"srcCrisis","lane":"expected","x":312,"y":66,"w":236,"h":62,"label":"A crisis service","phase":"front"},{"id":"srcPolice","lane":"expected","x":564,"y":66,"w":236,"h":62,"label":"Police","phase":"front"},{"id":"srcAmbulance","lane":"expected","x":816,"y":66,"w":236,"h":62,"label":"Ambulance","phase":"front"},{"id":"srcHospital","lane":"expected","x":1068,"y":66,"w":236,"h":62,"label":"Another hospital","phase":"front"},{"id":"srcEd","lane":"expected","x":1320,"y":66,"w":236,"h":62,"label":"A doctor in an ED","phase":"front"},{"id":"srcGp","lane":"expected","x":1572,"y":66,"w":236,"h":62,"label":"A GP","phase":"front"},{"id":"hdr-src","lane":"heading","x":60,"y":14,"w":700,"h":40,"label":"Who raises it  ·  seven","sub":"A doctor in an ED may only raise it as an ED referral — they cannot claim another source.","phase":"front"},{"id":"raised","lane":"expected","x":700,"y":200,"w":420,"h":80,"label":"A referral is raised","sub":"Somebody has decided this person needs to go somewhere.","patient":"Wherever they already were.","bed":"Nothing yet.","phase":"front"},{"id":"addressed","lane":"expected","x":700,"y":320,"w":420,"h":86,"label":"Addressed to up to three places at once","sub":"Up to the configured recipient cap. Distinct named psychiatric wards can be addressed together; duplicate recipients and mixing a broad ward request with named ward requests are refused.","patient":"Still where they were.","bed":"Nothing yet.","phase":"front"},{"id":"armCommunity","lane":"expected","x":60,"y":460,"w":460,"h":90,"label":"①  Sent to a community team","sub":"Named as free text — there is no register of teams to choose from.","patient":"At home, or wherever they were.","bed":"Nothing. This arm never involves one.","phase":"front"},{"id":"armWard","lane":"expected","x":700,"y":460,"w":420,"h":90,"label":"②  Sent to a psychiatric ward","sub":"Carries what the bed must be: sex, gender, secure, involuntary, high-acuity nursing.","patient":"Still waiting.","bed":"Nothing reserved.","phase":"front"},{"id":"armEd","lane":"expected","x":1300,"y":460,"w":500,"h":90,"label":"③  Sent to an emergency department","sub":"Must say what it is FOR: a bed, a psychiatric review, or a medical assessment.","patient":"On their way to, or already in, that department.","bed":"Nothing.","phase":"front"},{"id":"cmhtAnswers","lane":"expected","x":60,"y":600,"w":460,"h":70,"label":"The team answers","phase":"front"},{"id":"cmhtAccepted","lane":"end","x":60,"y":720,"w":460,"h":90,"label":"Accepted — community follow-up","sub":"The arm ends here. It never becomes a bed search.","phase":"front"},{"id":"cmhtDeclined","lane":"end","x":60,"y":860,"w":460,"h":112,"label":"Declined — four reasons","sub":"Outside the team's catchment · needs inpatient care, not community follow-up · the client declined or could not be contacted · already open to another team.","phase":"front"},{"id":"cmhtNothing","lane":"stall","x":60,"y":1012,"w":460,"h":104,"label":"No answer yet","sub":"The arm remains queued until answered or withdrawn. Other acceptances do not cancel a community arm. Displayed waiting/overdue indicators do not decide or close it.","finding":"Nothing anywhere can close a queued community arm except the team answering or the referrer.","phase":"front"},{"id":"cmhtWithdrawn","lane":"stall","x":60,"y":1152,"w":460,"h":110,"label":"The referrer withdraws just this arm","sub":"A narrow exception added 17 September 2026, and only while the arm is still queued — a team that has already answered keeps its answer. The bed request stands.","phase":"front"},{"id":"cmhtFromSearch","lane":"diversion","x":60,"y":1298,"w":460,"h":110,"label":"It can also begin part-way through a bed search","sub":"Redirecting a bed search to a community team raises a real referral of this kind — or reuses a queued arm already asking that same team, rather than asking twice. So this arm does not only start at the front door.","phase":"front"},{"id":"cmhtExempt","lane":"note","x":60,"y":1444,"w":460,"h":100,"label":"This arm is exempt from the automatic cancellation","sub":"In both directions. A ward accepting does not close it, and it accepting does not close the bed search. It is the only arm that behaves this way.","phase":"front"},{"id":"wardAnswers","lane":"expected","x":700,"y":600,"w":420,"h":70,"label":"The ward answers","phase":"front"},{"id":"wardAccepted","lane":"expected","x":700,"y":720,"w":420,"h":90,"label":"Accepted","sub":"Records the ward answer, with an optional named bed reservation on the referral. It creates no movement or admission.","patient":"Still waiting.","bed":"No movement pull yet; a named bed can be reserved on this answer.","phase":"front"},{"id":"wardDeclined","lane":"end","x":700,"y":860,"w":420,"h":112,"label":"Declined — seven reasons","sub":"No suitable bed · age band not provided here · no bed of that designation · no secure bed · belongs to another service · referred elsewhere · another reason.","phase":"front"},{"id":"wardNothing","lane":"stall","x":700,"y":1022,"w":420,"h":96,"label":"No answer at all","sub":"The destination remains waiting until answered, withdrawn or cancelled by a competing acceptance. Current target/overdue displays can flag waiting; they do not choose an answer.","phase":"front"},{"id":"othersCancelled","lane":"diversion","x":700,"y":1168,"w":420,"h":100,"label":"Every other waiting arm is cancelled","sub":"Automatically, the moment a ward OR a department accepts — except the community arm, which is exempt in both directions. The referrer is neither asked nor told.","phase":"front"},{"id":"wardWithdrawn","lane":"diversion","x":700,"y":1310,"w":420,"h":130,"label":"The referrer takes the WHOLE referral back","sub":"The default, and the opposite of the community arm's one-arm exception: every still-queued destination goes at once. If a bed search is already running it releases the held bed and cancels the transport, and closes as 'did not proceed'. Refused once transport has collected the patient — that needs a coordinator, not an automatic withdrawal.","phase":"front"},{"id":"wardBlocked","lane":"stall","x":700,"y":1470,"w":420,"h":116,"label":"A ward cannot accept while a department's bed search is live","sub":"One referral, two arms: if the emergency department already raised the bed search, the ward arm is refused until that movement closes or arrives. Neither arm's screen shows the other.","phase":"front"},{"id":"edBoard","lane":"expected","x":1300,"y":600,"w":500,"h":90,"label":"It lands on that department's board","sub":"And the referrer can see their patient sitting there.","phase":"front"},{"id":"edExpected","lane":"expected","x":1300,"y":740,"w":500,"h":90,"label":"Expected to arrive","sub":"Triaged, and not here yet. It sits on a separate list from the referrals.","patient":"Not here yet.","bed":"Nothing.","phase":"front"},{"id":"edNeverArrives","lane":"stall","x":1300,"y":880,"w":500,"h":120,"label":"Expected, and never arrives","sub":"A queued ED arm can be declined or withdrawn before arrival, removing this expectation. Otherwise it stays until arrival; past 72 hours the screen adds a reminder but changes no record.","finding":"A queued ED arm can be declined or withdrawn before arrival; the expectation then disappears without an arrival stamp.","phase":"front"},{"id":"edArrived","lane":"expected","x":1300,"y":1040,"w":500,"h":86,"label":"Marked present","sub":"The only door between the two lists. Stamped once; a repeat keeps the earliest time.","patient":"Physically in the department.","bed":"Nothing.","phase":"front"},{"id":"edAnswers","lane":"expected","x":1300,"y":1176,"w":500,"h":70,"label":"The department answers, or acts","phase":"front"},{"id":"edAccepted","lane":"expected","x":1300,"y":1296,"w":500,"h":104,"label":"Accepted — the department takes them","sub":"And every other destination still waiting is cancelled on the spot, including the ward request sent alongside it. The referrer is not asked.","patient":"In the department.","bed":"Nothing — accepting reserves none.","phase":"front"},{"id":"edDeclined","lane":"end","x":1300,"y":1450,"w":500,"h":104,"label":"Declined — three reasons only","sub":"Belongs to another service · referred elsewhere · another reason. The four bed-shaped reasons are withheld on purpose: an ED is not being asked for a bed.","phase":"front"},{"id":"edRaise","lane":"expected","x":1300,"y":1604,"w":500,"h":104,"label":"A doctor raises a bed search from here","sub":"This is what creates the record that moves. It can be linked back to the referral that sent them, or raised for somebody nobody referred.","patient":"In the department.","bed":"Nothing yet.","phase":"front"},{"id":"edOutcome","lane":"end","x":1300,"y":1758,"w":500,"h":112,"label":"The department decides no bed is needed","sub":"Two labels, one behaviour: 'for community follow-up' raises no referral and tells no team — only the separate action below does that. Unwinds a held bed, an uncollected transport job and every live ward request. Refused once transport has collected them.","phase":"bed"},{"id":"edToCommunity","lane":"diversion","x":1300,"y":1920,"w":500,"h":124,"label":"Referred straight to a community team instead","sub":"Ends the bed search and creates or reuses a real community referral. Available from the moment the bed search exists until the patient is collected — not only from a department. Refused once they are collected, and while a legal form has no conclusive examination outcome.","phase":"bed"},{"id":"edLeft","lane":"end","x":1300,"y":2084,"w":500,"h":90,"label":"Left the department","sub":"Only recordable after an outcome has been recorded first.","phase":"bed"},{"id":"seam","lane":"seam","x":700,"y":1700,"w":420,"h":100,"label":"A separate movement is raised","sub":"Acceptance does not create the bed-search record. RAISE_REFERRAL creates it separately and can link it to the referral.","patient":"Unchanged.","bed":"Still nothing.","phase":"bed"},{"id":"placement","lane":"expected","x":700,"y":1854,"w":420,"h":60,"label":"Placement requested","patient":"Waiting, wherever they are.","bed":"Nothing yet.","phase":"bed"},{"id":"asked","lane":"expected","x":700,"y":1968,"w":420,"h":76,"label":"Wards are asked","sub":"One at a time, or several at once, up to three.","patient":"Still waiting.","bed":"Nothing yet.","phase":"bed"},{"id":"inPrinciple","lane":"expected","x":700,"y":2098,"w":420,"h":76,"label":"A ward accepts in principle","sub":"Still no bed set aside.","patient":"Still waiting.","bed":"Promised, not reserved.","phase":"bed"},{"id":"pulled","lane":"expected","x":700,"y":2228,"w":420,"h":90,"label":"A bed is pulled and held","sub":"Empty, offered to nobody else. Four hours is the default, not a rule — a coordinator can set the hold anywhere between thirty minutes and four hours. The admission this creates now names the movement it came from — a join added by owner ruling on 21 September, and the first pointer of any kind between the patient's track and the bed's; it is empty for the beds seeded as already occupied, so anything reading it has to cope with nothing being there.","patient":"Still where they were.","bed":"Held.","phase":"bed"},{"id":"booked","lane":"expected","x":700,"y":2372,"w":420,"h":76,"label":"Transport is booked","sub":"Five answers, none defaulted — provider, escort, CAD number, voluntary or involuntary, estimated time.","patient":"Waiting, with a journey arranged.","bed":"Held.","phase":"bed"},{"id":"handover","lane":"expected","x":700,"y":2502,"w":420,"h":60,"label":"Handover ready","patient":"Ready to be collected.","bed":"Held.","phase":"bed"},{"id":"enroute","lane":"expected","x":700,"y":2616,"w":420,"h":70,"label":"The crew accepts, and sets off","patient":"Still where they were.","bed":"Held.","phase":"bed"},{"id":"collected","lane":"expected","x":700,"y":2740,"w":420,"h":76,"label":"The patient is collected","sub":"After this point, everything changes.","patient":"In a vehicle, between two places.","bed":"Held.","phase":"bed"},{"id":"arrived","lane":"expected","x":700,"y":2870,"w":420,"h":76,"label":"The ward says they have arrived","sub":"Ward confirmation closes the movement and records the occupied stay. An officer Delivered stamp ends only the transport leg. STEP_BACK_STAGE refuses arrival; a separate scoped, time-limited Undo can correct the latest unchanged arrival snapshot.","patient":"On the ward.","bed":"Occupied.","phase":"ward"},{"id":"occupied","lane":"expected","x":700,"y":3000,"w":420,"h":60,"label":"Occupied — on the ward","patient":"Being treated.","bed":"Theirs, through leave and absence.","phase":"ward"},{"id":"ready","lane":"expected","x":700,"y":3114,"w":420,"h":86,"label":"Clinically ready to leave","sub":"The patient's departure and the named bed-release record proceed on two tracks.","patient":"Finished with hospital, possibly still in the bed.","bed":"Occupied.","phase":"ward"},{"id":"sWardDecline","lane":"stall","x":60,"y":1968,"w":460,"h":96,"label":"A ward declines — seven reasons","sub":"No bed · sex mix · no specialling · acuity mix · capability mismatch · bed pulled for an earlier referral · out of catchment.","phase":"bed"},{"id":"sWithdrawWard","lane":"stall","x":60,"y":2104,"w":460,"h":96,"label":"One ward's request is taken back","sub":"Seven reasons. The other wards asked carry on considering.","phase":"bed"},{"id":"sAcceptWithdrawn","lane":"stall","x":60,"y":2240,"w":460,"h":96,"label":"The acceptance is withdrawn","sub":"A listed reason records why the acceptance is withdrawn. An uncollected pulled or stepped-back hold is released in the same act; cancel a live job first. Handover-ready and moving are refused.","phase":"bed"},{"id":"sAbandoned","lane":"end","x":60,"y":2376,"w":460,"h":96,"label":"The bed search is abandoned","sub":"Pulled from every ward still considering it, or — once a ward has accepted — the acceptance revoked and any held bed given back. It closes as 'did not proceed'. This is also where an examination outcome of a community order, or a revocation, lands while no bed is held yet.","phase":"bed"},{"id":"sPullReleased","lane":"stall","x":60,"y":2512,"w":460,"h":96,"label":"The held bed is given back — four reasons","sub":"NINE different actions delete that admission, not one — releasing the pull (four reasons of its own), releasing a held bed after transport was stopped, abandoning the bed search, the referrer withdrawing it, the department deciding no bed is needed, sending them to a community team instead, an examination outcome that ends it, releasing the bed a diverted journey held, and releasing the bed while reopening the search. Whichever it was, the admission record is deleted outright: nobody was ever in this bed.","phase":"bed"},{"id":"sCancelTransport","lane":"stall","x":60,"y":2648,"w":460,"h":96,"label":"Transport cancelled before collection","sub":"A listed reason removes the job without moving the stage or automatically rebooking. The held-bed notice checks the admission link as well as stage, including a stepped-back pull.","finding":"The role/booking-place, collected, delivered and closed checks are distinct; an officer delivery can precede ward arrival without closure.","phase":"bed"},{"id":"sStopTransport","lane":"diversion","x":60,"y":2784,"w":460,"h":96,"label":"The journey is stopped after collection","sub":"Three reasons, and somebody must say where the patient now is. The movement closes and the bed stays held.","finding":"An officer delivery can precede ward arrival without closure, so delivered and closed refusal paths are distinct.","phase":"bed"},{"id":"sAbscond","lane":"record","x":60,"y":3000,"w":460,"h":96,"label":"Absent without leave is recorded","sub":"The occupied stay and held bed remain. The ward records absence, its steps and return against the admission; the current order can also create an action-inbox fact.","phase":"ward"},{"id":"dForced","lane":"forced","x":1300,"y":2284,"w":500,"h":100,"label":"A coordinator places them anyway","sub":"Eight of the bed checks can be passed by recording one of five reasons — the receiving team has agreed despite the mismatch · clinical urgency outweighs it · the bed information is known to be out of date · continuity with an earlier admission here · closer to home or family. Running out of one-to-one nursing or of high-acuity capacity can be passed the same way, and passing the acuity one also demands that the nurse unit manager was consulted.","phase":"bed"},{"id":"dGenderHard","lane":"stall","x":1300,"y":2424,"w":500,"h":100,"label":"The one refusal nothing can override","sub":"If the ward is designated for one gender and the patient's recorded gender is the other, no reason passes it and the app will not even offer the list. Non-binary, Different term, and not-recorded genders can use the coordinator-reviewed exception. Every other bed check here can be forced; this one cannot.","phase":"bed"},{"id":"dNonBinary","lane":"forced","x":1300,"y":2564,"w":500,"h":100,"label":"A patient with a non-binary, Different term, or unrecorded gender onto a single-gender ward","sub":"Only a coordinator, and only with one of six recorded reasons — a single room is available · the patient's stated preference, agreed with the ward · no single room is free and the ward agreed a plan for privacy · the only suitable ready bed, agreed with the ward · they know this ward from an earlier stay · closer to home or supports.","phase":"bed"},{"id":"dStatutory","lane":"record","x":1300,"y":2704,"w":500,"h":100,"label":"Record a form from the Forms page","sub":"The form selector and checked paper time reach the supported form-writing handler. Authorised users can save; refusal keeps the draft and shows the reason. This does not issue a legal instrument or calculate its statutory expiry.","phase":"bed"},{"id":"dNoTransport","lane":"diversion","x":1300,"y":2844,"w":500,"h":100,"label":"No transport needed","sub":"Marked arrived straight from the held bed, with no journey recorded at all.","phase":"bed"},{"id":"dRepull","lane":"record","x":1300,"y":2984,"w":500,"h":100,"label":"Pulling again when the bed is already held","sub":"Restoring an already-linked hold preserves its bed rather than consuming another. Current code rechecks the matching admission, patient placement, observation/high-acuity staffing, legal authority and gender before restoring the pulled stage.","finding":"Restoring a hold does not consume a second bed; staffing, legal, gender and matching-admission checks still run.","phase":"ward"},{"id":"dNoLongerSuits","lane":"stall","x":1300,"y":3124,"w":500,"h":100,"label":"A held destination no longer suits","sub":"Current gender/legal facts are checked at forward steps. WITHDRAW_ACCEPTANCE can release an uncollected pulled or stepped-back hold atomically after any live job is cancelled; no obsolete three-step sequence should be assumed.","finding":"A held acceptance can now be withdrawn atomically after cancelling a live job; handover-ready/moving still require the supported earlier-stage path.","phase":"ward"},{"id":"dCancelLie","lane":"record","x":1300,"y":3264,"w":500,"h":100,"label":"Cancellation keeps the bed facts separate","sub":"The hold is detected from the linked admission OR the pulled-or-later stage. Cancelling removes the job and preserves the bed and current stage, including after a step back.","finding":"Cancellation checks both the admission link and stage before describing whether the bed stays held.","phase":"ward"},{"id":"dRevoked","lane":"record","x":1300,"y":3404,"w":500,"h":100,"label":"The legal authority is revoked before collection","sub":"A revoked examination while a bed is held records the examination and flags release without refunding the bed. Acceptance, en-route and collection refuse while that hold is unresolved; physical arrival remains recordable.","phase":"ward"},{"id":"dAway","lane":"diversion","x":1300,"y":3544,"w":500,"h":100,"label":"Away at an ED, or on leave","sub":"An ED trip and leave name the occupied admission. Return records clear the relevant absence. Leave also records its kind and optional psychiatrist-authorisation answer; the bed stays held while away.","phase":"ward"},{"id":"dClosedRecord","lane":"record","x":1300,"y":3684,"w":500,"h":100,"label":"Closure limits corrections; admitted forms have a separate route","sub":"Most movement actions refuse closure. The admitting ward can still record a supported written form or typed expiry for a current occupied stay. STEP_BACK_STAGE refuses arrival, while a separate scoped Undo can reverse the latest unchanged transport/arrival snapshot within its window.","finding":"Most movement commands refuse closure, but admitted-ward form and expiry commands have explicit supported post-arrival routes.","phase":"ward"},{"id":"dRepat","lane":"diversion","x":1300,"y":3824,"w":500,"h":100,"label":"Sending a country patient home","sub":"Logged against the admission once it has been arranged off the system: home hospital, whether its ward agreed, road or flight, provider and tracking number. It books nothing. Only when the home ward agreed does it also open a new movement asking for a bed at home.","phase":"ward"},{"id":"personLeaves","lane":"expected","x":400,"y":4044,"w":440,"h":96,"label":"Track one — the person leaves","sub":"Eight recorded departure destinations. A psychiatric transfer releases the sending ward bed while taking a receiving bed.","patient":"Gone.","bed":"Normally empty and allocatable rise once and the live release completes; an over-capacity arrival conflict is reconciled without inventing an extra bed.","phase":"leaving"},{"id":"bedReleased","lane":"expected","x":920,"y":4044,"w":440,"h":96,"label":"Track two — the bed is released","sub":"Expected can go directly to discharged or pass through confirmed. The named admission leaving completes its release in the same write; capacity reconciliation prevents counting an already-recorded release or an over-capacity arrival twice.","patient":"Names the stay it belongs to, and nothing else about them.","bed":"Counted as available again, at the last step only.","phase":"leaving"},{"id":"bedStuck","lane":"stall","x":1440,"y":4044,"w":400,"h":96,"label":"Stuck, or waiting on something","sub":"Seven things it can wait on, nine reasons it can be stuck. Neither is a stage.","phase":"leaving"},{"id":"end0","lane":"end","x":60,"y":4274,"w":230,"h":112,"label":"Discharged to the community","sub":"Frees a bed.","phase":"leaving"},{"id":"end1","lane":"diversion","x":312,"y":4274,"w":230,"h":112,"label":"Transferred to another psychiatric ward","sub":"Frees THIS ward's bed and gains the state nothing — the only one that is not a release.","phase":"leaving"},{"id":"end2","lane":"end","x":564,"y":4274,"w":230,"h":112,"label":"Transferred to a general hospital","sub":"Frees a bed.","phase":"leaving"},{"id":"end3","lane":"end","x":816,"y":4274,"w":230,"h":112,"label":"Moved to residential care","sub":"Frees a bed.","phase":"leaving"},{"id":"end4","lane":"end","x":1068,"y":4274,"w":230,"h":112,"label":"Left against advice","sub":"Frees a bed.","phase":"leaving"},{"id":"end5","lane":"end","x":1320,"y":4274,"w":230,"h":112,"label":"Died on the ward","sub":"Frees a bed.","phase":"leaving"},{"id":"end6","lane":"end","x":1572,"y":4274,"w":230,"h":112,"label":"Transferred to police or prison custody","sub":"Frees a bed.","phase":"leaving"},{"id":"end7","lane":"end","x":1824,"y":4274,"w":230,"h":112,"label":"Did not return","sub":"Frees a bed.","phase":"leaving"},{"id":"rkDuplicate","lane":"record","x":2400,"y":460,"w":420,"h":104,"label":"Is this the same person already?","sub":"Duplicate matching warns about number and demographic similarities. A duplicate record number blocks registration in both form and reducer; name similarity alone remains a review warning.","phase":"alongside"},{"id":"rkIntakeLost","lane":"record","x":2400,"y":588,"w":420,"h":104,"label":"Add patient saves identity; referral saves intake","sub":"The current Add patient form asks for identity, optional gender and Aboriginal or Torres Strait Islander status. Clinical intake and location belong to the referral flow. Obsolete non-working Print/Save draft controls are hidden; the historical silent-discard finding no longer describes this screen.","phase":"alongside"},{"id":"rkClearance","lane":"record","x":2400,"y":1031,"w":420,"h":104,"label":"Is the patient medically cleared?","sub":"Three answers, not two — unrecorded, cleared, and explicitly not cleared.","phase":"alongside"},{"id":"rkClock","lane":"absent","x":2400,"y":1832,"w":420,"h":104,"label":"The display follows wall-clock time","sub":"The provider updates elapsed wall-clock time at minute boundaries and catches up when the page becomes visible. A controlled test clock is separate. A display becoming overdue does not by itself prove that a domain action ran; check the event handler for that action.","phase":"alongside"},{"id":"rkSettings","lane":"record","x":2400,"y":1960,"w":420,"h":104,"label":"Settings change current operational defaults","sub":"WardConfiguration carries twelve fields: access/decision/transfer/booking targets, parallel-recipient cap, pull hold, morning deadline, due-soon warnings and Forecast thresholds. A valid full draft is merged against its baseline or refused for conflicting fields; old optional keys take documented defaults.","phase":"alongside"},{"id":"rkQueue","lane":"record","x":2400,"y":2088,"w":420,"h":104,"label":"Where they sit in the queue","sub":"Flagged urgent first, then the urgency tier, then whoever has waited longest, then the record's own id as a tie-break. Nothing else moves anybody up.","phase":"alongside"},{"id":"rkClash","lane":"record","x":2400,"y":2216,"w":420,"h":104,"label":"Duplicate bed requests are surfaced","sub":"The current duplicate-bed-request derivation finds multiple active requests for one linked patient and creates a coordinator fact row. It does not rank patients or choose a winner. This is distinct from a physical double-booking check.","phase":"alongside"},{"id":"rkUrgent","lane":"record","x":2400,"y":2344,"w":420,"h":104,"label":"Flagged urgent","sub":"Ten reasons. Lifts the patient above every urgency level, and re-sorts nothing on its own.","phase":"alongside"},{"id":"rkEscalate","lane":"record","x":2400,"y":2472,"w":420,"h":104,"label":"Escalated","sub":"Which wards were tried and who was rung. Six people it can be escalated to.","phase":"alongside"},{"id":"rkCapacity","lane":"record","x":2400,"y":2600,"w":420,"h":104,"label":"A ward states how many beds it can allocate","sub":"Set outright rather than counted up, and refused if it claims more beds than the ward physically has. Asking a ward to refresh it records that somebody asked, and moves no number at all.","phase":"alongside"},{"id":"rkLegalStatus","lane":"record","x":2400,"y":2728,"w":420,"h":104,"label":"The legal status changes","sub":"Four values. Changing it triggers nothing — even if it makes the accepted ward unlawful.","phase":"alongside"},{"id":"rkForm","lane":"record","x":2400,"y":2856,"w":420,"h":104,"label":"The legal paperwork arrives","sub":"Nine forms can be recorded as received — 1A, 3A, 3C, 3D, 5A, 5B, 6A, 6B, 6C. Receipt can be undone and recorded again; every expiry is a time a clinician typed.","phase":"alongside"},{"id":"rkExam","lane":"record","x":2400,"y":2984,"w":420,"h":104,"label":"An examination is recorded","sub":"Four outcomes. Only “a further examination is ordered” allows a second one.","phase":"alongside"},{"id":"rkLegalWritten","lane":"record","x":2400,"y":3112,"w":420,"h":104,"label":"The paperwork is written, continued, or attached","sub":"Written and continued forms record paper facts and clear legacy calculated clocks; same-form written-time edits preserve applicable typed facts. An admitted ward has a post-arrival route. A3C after3D is refused. A country1A extension requires a current country setting and a finite typed later paper expiry; no statutory duration is computed.","phase":"alongside"},{"id":"rkLegalMismatch","lane":"record","x":2400,"y":3240,"w":420,"h":104,"label":"The ward's authority does not match the person's status","sub":"Two shapes, both named: an involuntary patient on a voluntary ward, and a voluntary patient on a locked one. It can be flagged, and it cannot be overridden: ward authority for an involuntary patient is never overridable (owner ruling, 25 September).","phase":"alongside"},{"id":"rkNotice","lane":"record","x":2400,"y":3368,"w":420,"h":104,"label":"Somebody is told","sub":"Twenty-four kinds of notice. Written once, never rewritten, never deleted, never expiring.","phase":"alongside"},{"id":"rkDiversion","lane":"record","x":2400,"y":3496,"w":420,"h":104,"label":"The journey is diverted while it is under way","sub":"Only once the patient is actually in the vehicle — it is refused before collection, after arrival, and a second time on a movement already diverted. It records a reason and where they were taken instead. The held bed does not come back on its own: giving it back is a separate act, and refused unless this movement was in fact diverted.","phase":"alongside"},{"id":"rkExpiryShut","lane":"stall","x":2400,"y":3624,"w":420,"h":104,"label":"Expiry can be recorded for an admitted patient","sub":"The legal-event handler permits the ward to record a typed expiry for its admitted patient even when the movement is closed. This is a recorded time, not a computed legal limit. See ward-flow-record-legal-events.ts.","finding":"The admitted-patient expiry route is implemented for the ward. Read the current legal-event handler; the old closed-movement gap is retired.","phase":"alongside"},{"id":"rkExpectFlag","lane":"record","x":2400,"y":3752,"w":420,"h":104,"label":"A clock somebody starts by hand","sub":"Two kinds, forty-eight hours and seven days, raised against a movement and cleared again. Only one can be open at a time — raising a second is refused, and so is clearing one that was never raised. Nothing starts it automatically and nothing expires it; it is a note about time, not a timer.","phase":"alongside"},{"id":"rkAwayRule","lane":"record","x":2400,"y":3880,"w":420,"h":104,"label":"The rule for a bed kept during a medical trip","sub":"The unwired retention helper keeps the bed by default, including above the24-hour threshold; above threshold adds requiresReview. Only an explicit override changes freesBed. The numeric constant is24 while an adjacent historical provenance comment still says48.","phase":"alongside"},{"id":"rkInbox","lane":"record","x":2400,"y":4008,"w":420,"h":104,"label":"A row appears in the coordinator's inbox","sub":"The current inbox derives fact rows from movements, stays, planned bookings and bed-meeting actions. Facts are acknowledged/owned/snoozed, never ticked away. The daily check is a commitment; its day-shaped ID can be completed and reopened.","finding":"Completion applies to commitment IDs; fact rows use their source condition and bed-meeting actions have a dedicated completion event.","phase":"alongside"},{"id":"rkDischargePlan","lane":"record","x":2400,"y":4136,"w":420,"h":104,"label":"Step-down, and what is holding the discharge up","sub":"Two settings on a known admission: step-down candidacy and one discharge barrier. The acting ward must match; a substantive barrier is refused for a stay under seven days. Neither moves a bed figure.","phase":"alongside"},{"id":"rkDischarge","lane":"record","x":2400,"y":4264,"w":420,"h":104,"label":"A discharge recorded the other way","sub":"A second event does exactly what recording a departure does, but only for a patient whose identity is linked, and only against the revision number the screen last read. Same result, different door.","phase":"alongside"},{"id":"rkPrep","lane":"record","x":2400,"y":4392,"w":420,"h":104,"label":"The bed is being prepared","sub":"Cleaning/repair is a separate preparation flag. It does not directly rewrite the ward count; the pull handler separately refuses when every free bed is still being made ready.","phase":"alongside"},{"id":"rkOwnership","lane":"record","x":2400,"y":4520,"w":420,"h":104,"label":"Only the ward it belongs to may touch it","sub":"Confirming a release, reversing it, flagging it stuck, clearing that flag, marking the bed being cleaned, and finally freeing it are each refused to any other ward. It is what stops one ward's freed bed landing in another ward's figures.","phase":"alongside"},{"id":"rkWardDay","lane":"record","x":2400,"y":4648,"w":420,"h":104,"label":"The ward's own day, beside the patient's","sub":"A morning count a ward confirms, a message it can be sent, and a sweep that works out which beds on leave are worth warning about. None of them belongs to any one patient, which is why they sit off the journey rather than on it.","phase":"alongside"},{"id":"hdr-rec","lane":"heading","x":2400,"y":380,"w":420,"h":60,"label":"Recorded alongside  ·","sub":"Happens at some point without moving the journey.","phase":"alongside"},{"id":"hdr-left","lane":"heading","x":60,"y":1892,"w":460,"h":56,"label":"←  Stalls, undos and endings","sub":"Grey goes back into the route. Teal does not.","phase":"bed"},{"id":"hdr-spine","lane":"heading","x":700,"y":1614,"w":420,"h":56,"label":"Read down the middle  ↓","sub":"Read straight down.","phase":"front"},{"id":"hdr-right","lane":"heading","x":1300,"y":2208,"w":500,"h":56,"label":"Diversions  →","sub":"It carries on, somewhere other than expected.","phase":"bed"}],"edges":[{"from":"srcCommunity","to":"raised","d":"M 178 128 L 178 152 Q 178 164 190 164 L 898 164 Q 910 164 910 176 L 910 200","p":[[178,128],[178,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcCrisis","to":"raised","d":"M 430 128 L 430 152 Q 430 164 442 164 L 898 164 Q 910 164 910 176 L 910 200","p":[[430,128],[430,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcPolice","to":"raised","d":"M 682 128 L 682 152 Q 682 164 694 164 L 898 164 Q 910 164 910 176 L 910 200","p":[[682,128],[682,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcAmbulance","to":"raised","d":"M 934 128 L 934 152 Q 934 164 922 164 L 922 164 Q 910 164 910 176 L 910 200","p":[[934,128],[934,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcHospital","to":"raised","d":"M 1186 128 L 1186 152 Q 1186 164 1174 164 L 922 164 Q 910 164 910 176 L 910 200","p":[[1186,128],[1186,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcEd","to":"raised","d":"M 1438 128 L 1438 152 Q 1438 164 1426 164 L 922 164 Q 910 164 910 176 L 910 200","p":[[1438,128],[1438,164],[910,164],[910,200]],"lane":"expected"},{"from":"srcGp","to":"raised","d":"M 1690 128 L 1690 152 Q 1690 164 1678 164 L 922 164 Q 910 164 910 176 L 910 200","p":[[1690,128],[1690,164],[910,164],[910,200]],"lane":"expected"},{"from":"raised","to":"addressed","d":"M 910 280 L 910 320","p":[[910,280],[910,320]],"lane":"expected"},{"from":"addressed","to":"armCommunity","d":"M 910 406 L 910 421 Q 910 433 898 433 L 302 433 Q 290 433 290 445 L 290 460","p":[[910,406],[910,433],[290,433],[290,460]],"lane":"expected"},{"from":"addressed","to":"armWard","d":"M 910 406 L 910 460","p":[[910,406],[910,460]],"lane":"expected"},{"from":"addressed","to":"armEd","d":"M 910 406 L 910 421 Q 910 433 922 433 L 1538 433 Q 1550 433 1550 445 L 1550 460","p":[[910,406],[910,433],[1550,433],[1550,460]],"lane":"expected"},{"from":"armCommunity","to":"cmhtAnswers","d":"M 290 550 L 290 600","p":[[290,550],[290,600]],"lane":"expected"},{"from":"cmhtAnswers","to":"cmhtAccepted","d":"M 290 670 L 290 720","p":[[290,670],[290,720]],"lane":"end","terminal":true},{"from":"cmhtAnswers","to":"cmhtDeclined","d":"M 290 670 L 290 681 Q 290 692 301 692 L 544 692 Q 556 692 556 704 L 556 826 Q 556 838 544 838 L 301 838 Q 290 838 290 849 L 290 860","p":[[290,670],[290,692],[556,692],[556,838],[290,838],[290,860]],"lane":"end","terminal":true},{"from":"cmhtAnswers","to":"cmhtNothing","d":"M 290 670 L 290 681 Q 290 692 279 692 L 36 692 Q 24 692 24 704 L 24 978 Q 24 990 36 990 L 279 990 Q 290 990 290 1001 L 290 1012","p":[[290,670],[290,692],[24,692],[24,990],[290,990],[290,1012]],"lane":"stall"},{"from":"cmhtAnswers","to":"cmhtWithdrawn","d":"M 290 670 L 290 681 Q 290 692 301 692 L 566 692 Q 578 692 578 704 L 578 1118 Q 578 1130 566 1130 L 301 1130 Q 290 1130 290 1141 L 290 1152","p":[[290,670],[290,692],[578,692],[578,1130],[290,1130],[290,1152]],"lane":"stall"},{"from":"cmhtFromSearch","to":"cmhtAnswers","d":"M 290 1298 L 290 1287 Q 290 1276 301 1276 L 588 1276 Q 600 1276 600 1264 L 600 704 Q 600 692 588 692 L 301 692 Q 290 692 290 681 L 290 670","p":[[290,1298],[290,1276],[600,1276],[600,692],[290,692],[290,670]],"lane":"expected"},{"from":"armWard","to":"wardAnswers","d":"M 910 550 L 910 600","p":[[910,550],[910,600]],"lane":"expected"},{"from":"wardAnswers","to":"wardWithdrawn","d":"M 910 670 L 910 681 Q 910 692 921 692 L 1144 692 Q 1156 692 1156 704 L 1156 1276 Q 1156 1288 1144 1288 L 921 1288 Q 910 1288 910 1299 L 910 1310","p":[[910,670],[910,692],[1156,692],[1156,1288],[910,1288],[910,1310]],"lane":"diversion"},{"from":"wardAnswers","to":"wardBlocked","d":"M 910 670 L 910 681 Q 910 692 899 692 L 676 692 Q 664 692 664 704 L 664 1436 Q 664 1448 676 1448 L 899 1448 Q 910 1448 910 1459 L 910 1470","p":[[910,670],[910,692],[664,692],[664,1448],[910,1448],[910,1470]],"lane":"stall"},{"from":"wardAnswers","to":"wardAccepted","d":"M 910 670 L 910 720","p":[[910,670],[910,720]],"lane":"expected"},{"from":"wardAnswers","to":"wardDeclined","d":"M 910 670 L 910 681 Q 910 692 921 692 L 1166 692 Q 1178 692 1178 704 L 1178 826 Q 1178 838 1166 838 L 921 838 Q 910 838 910 849 L 910 860","p":[[910,670],[910,692],[1178,692],[1178,838],[910,838],[910,860]],"lane":"end","terminal":true},{"from":"wardAnswers","to":"wardNothing","d":"M 910 670 L 910 681 Q 910 692 899 692 L 654 692 Q 642 692 642 704 L 642 988 Q 642 1000 654 1000 L 899 1000 Q 910 1000 910 1011 L 910 1022","p":[[910,670],[910,692],[642,692],[642,1000],[910,1000],[910,1022]],"lane":"stall"},{"from":"wardAccepted","to":"othersCancelled","d":"M 910 810 L 910 821 Q 910 832 921 832 L 1188 832 Q 1200 832 1200 844 L 1200 1134 Q 1200 1146 1188 1146 L 921 1146 Q 910 1146 910 1157 L 910 1168","p":[[910,810],[910,832],[1200,832],[1200,1146],[910,1146],[910,1168]],"lane":"diversion","auto":true},{"from":"armEd","to":"edBoard","d":"M 1550 550 L 1550 600","p":[[1550,550],[1550,600]],"lane":"expected"},{"from":"edBoard","to":"edExpected","d":"M 1550 690 L 1550 740","p":[[1550,690],[1550,740]],"lane":"expected"},{"from":"edExpected","to":"edArrived","d":"M 1550 830 L 1550 841 Q 1550 852 1561 852 L 1824 852 Q 1836 852 1836 864 L 1836 1006 Q 1836 1018 1824 1018 L 1561 1018 Q 1550 1018 1550 1029 L 1550 1040","p":[[1550,830],[1550,852],[1836,852],[1836,1018],[1550,1018],[1550,1040]],"lane":"expected"},{"from":"edExpected","to":"edNeverArrives","d":"M 1550 830 L 1550 880","p":[[1550,830],[1550,880]],"lane":"stall"},{"from":"edArrived","to":"edAnswers","d":"M 1550 1126 L 1550 1176","p":[[1550,1126],[1550,1176]],"lane":"expected"},{"from":"edAnswers","to":"edAccepted","d":"M 1550 1246 L 1550 1296","p":[[1550,1246],[1550,1296]],"lane":"expected"},{"from":"edAnswers","to":"edDeclined","d":"M 1550 1246 L 1550 1257 Q 1550 1268 1561 1268 L 1824 1268 Q 1836 1268 1836 1280 L 1836 1416 Q 1836 1428 1824 1428 L 1561 1428 Q 1550 1428 1550 1439 L 1550 1450","p":[[1550,1246],[1550,1268],[1836,1268],[1836,1428],[1550,1428],[1550,1450]],"lane":"end","terminal":true},{"from":"edAccepted","to":"edRaise","d":"M 1550 1400 L 1550 1411 Q 1550 1422 1539 1422 L 1276 1422 Q 1264 1422 1264 1434 L 1264 1570 Q 1264 1582 1276 1582 L 1539 1582 Q 1550 1582 1550 1593 L 1550 1604","p":[[1550,1400],[1550,1422],[1264,1422],[1264,1582],[1550,1582],[1550,1604]],"lane":"expected"},{"from":"edAccepted","to":"othersCancelled","d":"M 1300 1348 L 1120 1218","p":[[1300,1348],[1120,1218]],"lane":"diversion","auto":true},{"from":"edRaise","to":"edOutcome","d":"M 1550 1708 L 1550 1758","p":[[1550,1708],[1550,1758]],"lane":"end","terminal":true},{"from":"edRaise","to":"edToCommunity","d":"M 1550 1708 L 1550 1719 Q 1550 1730 1561 1730 L 1824 1730 Q 1836 1730 1836 1742 L 1836 1886 Q 1836 1898 1824 1898 L 1561 1898 Q 1550 1898 1550 1909 L 1550 1920","p":[[1550,1708],[1550,1730],[1836,1730],[1836,1898],[1550,1898],[1550,1920]],"lane":"diversion"},{"from":"edOutcome","to":"edLeft","d":"M 1550 1870 L 1550 1881 Q 1550 1892 1539 1892 L 1276 1892 Q 1264 1892 1264 1904 L 1264 2050 Q 1264 2062 1276 2062 L 1539 2062 Q 1550 2062 1550 2073 L 1550 2084","p":[[1550,1870],[1550,1892],[1264,1892],[1264,2062],[1550,2062],[1550,2084]],"lane":"end","terminal":true},{"from":"seam","to":"placement","d":"M 910 1800 L 910 1854","p":[[910,1800],[910,1854]],"lane":"expected"},{"from":"placement","to":"asked","d":"M 910 1914 L 910 1968","p":[[910,1914],[910,1968]],"lane":"expected"},{"from":"asked","to":"inPrinciple","d":"M 910 2044 L 910 2098","p":[[910,2044],[910,2098]],"lane":"expected"},{"from":"inPrinciple","to":"pulled","d":"M 910 2174 L 910 2228","p":[[910,2174],[910,2228]],"lane":"expected"},{"from":"pulled","to":"booked","d":"M 910 2318 L 910 2372","p":[[910,2318],[910,2372]],"lane":"expected"},{"from":"booked","to":"handover","d":"M 910 2448 L 910 2502","p":[[910,2448],[910,2502]],"lane":"expected"},{"from":"handover","to":"enroute","d":"M 910 2562 L 910 2616","p":[[910,2562],[910,2616]],"lane":"expected"},{"from":"enroute","to":"collected","d":"M 910 2686 L 910 2740","p":[[910,2686],[910,2740]],"lane":"expected"},{"from":"collected","to":"arrived","d":"M 910 2816 L 910 2870","p":[[910,2816],[910,2870]],"lane":"expected"},{"from":"arrived","to":"occupied","d":"M 910 2946 L 910 3000","p":[[910,2946],[910,3000]],"lane":"expected"},{"from":"occupied","to":"ready","d":"M 910 3060 L 910 3114","p":[[910,3060],[910,3114]],"lane":"expected"},{"from":"wardAccepted","to":"seam","d":"M 910 810 L 910 824 Q 910 836 898 836 L 672 836 Q 660 836 660 848 L 660 1738 Q 660 1750 672 1750 L 700 1750","p":[[910,810],[910,836],[660,836],[660,1750],[700,1750]],"lane":"seam"},{"from":"edRaise","to":"placement","d":"M 1550 1708 L 1550 1722 Q 1550 1734 1538 1734 L 1252 1734 Q 1240 1734 1240 1746 L 1240 1872 Q 1240 1884 1228 1884 L 1120 1884","p":[[1550,1708],[1550,1734],[1240,1734],[1240,1884],[1120,1884]],"lane":"expected"},{"from":"asked","to":"sWardDecline","d":"M 700 2006 L 585 2006 Q 580 2006 580 2011 L 580 2011 Q 580 2016 575 2016 L 520 2016","p":[[700,2006],[580,2006],[580,2016],[520,2016]],"lane":"stall","both":true},{"from":"asked","to":"sWithdrawWard","d":"M 700 2006 L 592 2006 Q 580 2006 580 2018 L 580 2140 Q 580 2152 568 2152 L 520 2152","p":[[700,2006],[580,2006],[580,2152],[520,2152]],"lane":"stall","both":true},{"from":"inPrinciple","to":"sAcceptWithdrawn","d":"M 700 2136 L 592 2136 Q 580 2136 580 2148 L 580 2276 Q 580 2288 568 2288 L 520 2288","p":[[700,2136],[580,2136],[580,2288],[520,2288]],"lane":"stall","both":true},{"from":"inPrinciple","to":"sAbandoned","d":"M 700 2136 L 592 2136 Q 580 2136 580 2148 L 580 2412 Q 580 2424 568 2424 L 520 2424","p":[[700,2136],[580,2136],[580,2424],[520,2424]],"lane":"end","terminal":true},{"from":"pulled","to":"sPullReleased","d":"M 700 2273 L 592 2273 Q 580 2273 580 2285 L 580 2548 Q 580 2560 568 2560 L 520 2560","p":[[700,2273],[580,2273],[580,2560],[520,2560]],"lane":"stall","both":true},{"from":"booked","to":"sCancelTransport","d":"M 700 2410 L 592 2410 Q 580 2410 580 2422 L 580 2684 Q 580 2696 568 2696 L 520 2696","p":[[700,2410],[580,2410],[580,2696],[520,2696]],"lane":"stall","both":true},{"from":"collected","to":"sStopTransport","d":"M 700 2778 L 592 2778 Q 580 2778 580 2790 L 580 2820 Q 580 2832 568 2832 L 520 2832","p":[[700,2778],[580,2778],[580,2832],[520,2832]],"lane":"diversion"},{"from":"occupied","to":"sAbscond","d":"M 700 3030 L 589 3030 Q 580 3030 580 3039 L 580 3039 Q 580 3048 571 3048 L 520 3048","p":[[700,3030],[580,3030],[580,3048],[520,3048]],"lane":"record"},{"from":"asked","to":"dForced","d":"M 1120 2006 L 1168 2006 Q 1180 2006 1180 2018 L 1180 2322 Q 1180 2334 1192 2334 L 1300 2334","p":[[1120,2006],[1180,2006],[1180,2334],[1300,2334]],"lane":"forced"},{"from":"dForced","to":"dForced","d":"M 1300 2334 L 1262 2334","p":[[1300,2334],[1262,2334]],"lane":"forced","terminal":true},{"from":"asked","to":"dGenderHard","d":"M 1120 2006 L 1168 2006 Q 1180 2006 1180 2018 L 1180 2462 Q 1180 2474 1192 2474 L 1300 2474","p":[[1120,2006],[1180,2006],[1180,2474],[1300,2474]],"lane":"stall"},{"from":"dGenderHard","to":"dGenderHard","d":"M 1300 2474 L 1262 2474","p":[[1300,2474],[1262,2474]],"lane":"stall","terminal":true},{"from":"inPrinciple","to":"dNonBinary","d":"M 1120 2136 L 1168 2136 Q 1180 2136 1180 2148 L 1180 2602 Q 1180 2614 1192 2614 L 1300 2614","p":[[1120,2136],[1180,2136],[1180,2614],[1300,2614]],"lane":"forced"},{"from":"dNonBinary","to":"dNonBinary","d":"M 1300 2614 L 1262 2614","p":[[1300,2614],[1262,2614]],"lane":"forced","terminal":true},{"from":"inPrinciple","to":"dStatutory","d":"M 1120 2136 L 1168 2136 Q 1180 2136 1180 2148 L 1180 2742 Q 1180 2754 1192 2754 L 1300 2754","p":[[1120,2136],[1180,2136],[1180,2754],[1300,2754]],"lane":"record"},{"from":"dStatutory","to":"dStatutory","d":"M 1300 2754 L 1262 2754","p":[[1300,2754],[1262,2754]],"lane":"record","terminal":true},{"from":"pulled","to":"dNoTransport","d":"M 1120 2273 L 1168 2273 Q 1180 2273 1180 2285 L 1180 2882 Q 1180 2894 1192 2894 L 1300 2894","p":[[1120,2273],[1180,2273],[1180,2894],[1300,2894]],"lane":"diversion"},{"from":"dNoTransport","to":"arrived","d":"M 1550 2944 L 1550 2958 Q 1550 2970 1562 2970 L 1848 2970 Q 1860 2970 1860 2958 L 1860 2920 Q 1860 2908 1848 2908 L 1120 2908","p":[[1550,2944],[1550,2970],[1860,2970],[1860,2908],[1120,2908]],"lane":"expected"},{"from":"pulled","to":"dRepull","d":"M 1120 2273 L 1168 2273 Q 1180 2273 1180 2285 L 1180 3022 Q 1180 3034 1192 3034 L 1300 3034","p":[[1120,2273],[1180,2273],[1180,3034],[1300,3034]],"lane":"record","both":true},{"from":"handover","to":"dNoLongerSuits","d":"M 1120 2532 L 1168 2532 Q 1180 2532 1180 2544 L 1180 3162 Q 1180 3174 1192 3174 L 1300 3174","p":[[1120,2532],[1180,2532],[1180,3174],[1300,3174]],"lane":"stall"},{"from":"dNoLongerSuits","to":"dNoLongerSuits","d":"M 1300 3174 L 1262 3174","p":[[1300,3174],[1262,3174]],"lane":"stall","terminal":true},{"from":"booked","to":"dCancelLie","d":"M 1120 2410 L 1168 2410 Q 1180 2410 1180 2422 L 1180 3302 Q 1180 3314 1192 3314 L 1300 3314","p":[[1120,2410],[1180,2410],[1180,3314],[1300,3314]],"lane":"record"},{"from":"dCancelLie","to":"dCancelLie","d":"M 1300 3314 L 1262 3314","p":[[1300,3314],[1262,3314]],"lane":"record","terminal":true},{"from":"enroute","to":"dRevoked","d":"M 1120 2651 L 1168 2651 Q 1180 2651 1180 2663 L 1180 3442 Q 1180 3454 1192 3454 L 1300 3454","p":[[1120,2651],[1180,2651],[1180,3454],[1300,3454]],"lane":"record"},{"from":"dRevoked","to":"dRevoked","d":"M 1300 3454 L 1262 3454","p":[[1300,3454],[1262,3454]],"lane":"record","terminal":true},{"from":"occupied","to":"dAway","d":"M 1120 3030 L 1168 3030 Q 1180 3030 1180 3042 L 1180 3582 Q 1180 3594 1192 3594 L 1300 3594","p":[[1120,3030],[1180,3030],[1180,3594],[1300,3594]],"lane":"diversion","both":true},{"from":"arrived","to":"dClosedRecord","d":"M 1120 2908 L 1168 2908 Q 1180 2908 1180 2920 L 1180 3722 Q 1180 3734 1192 3734 L 1300 3734","p":[[1120,2908],[1180,2908],[1180,3734],[1300,3734]],"lane":"record"},{"from":"dClosedRecord","to":"dClosedRecord","d":"M 1300 3734 L 1262 3734","p":[[1300,3734],[1262,3734]],"lane":"record","terminal":true},{"from":"ready","to":"dRepat","d":"M 1120 3157 L 1168 3157 Q 1180 3157 1180 3169 L 1180 3862 Q 1180 3874 1192 3874 L 1300 3874","p":[[1120,3157],[1180,3157],[1180,3874],[1300,3874]],"lane":"diversion"},{"from":"dRepat","to":"dRepat","d":"M 1300 3874 L 1262 3874","p":[[1300,3874],[1262,3874]],"lane":"diversion","terminal":true},{"from":"ready","to":"personLeaves","d":"M 910 3200 L 910 3610 Q 910 3622 898 3622 L 632 3622 Q 620 3622 620 3634 L 620 4044","p":[[910,3200],[910,3622],[620,3622],[620,4044]],"lane":"expected"},{"from":"ready","to":"bedReleased","d":"M 910 3200 L 910 3610 Q 910 3622 922 3622 L 1128 3622 Q 1140 3622 1140 3634 L 1140 4044","p":[[910,3200],[910,3622],[1140,3622],[1140,4044]],"lane":"expected"},{"from":"bedReleased","to":"bedStuck","d":"M 1360 4092 L 1440 4092","p":[[1360,4092],[1440,4092]],"lane":"stall","both":true},{"from":"personLeaves","to":"end0","d":"M 620 4140 L 620 4195 Q 620 4207 608 4207 L 187 4207 Q 175 4207 175 4219 L 175 4274","p":[[620,4140],[620,4207],[175,4207],[175,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end1","d":"M 620 4140 L 620 4195 Q 620 4207 608 4207 L 439 4207 Q 427 4207 427 4219 L 427 4274","p":[[620,4140],[620,4207],[427,4207],[427,4274]],"lane":"diversion"},{"from":"personLeaves","to":"end2","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 667 4207 Q 679 4207 679 4219 L 679 4274","p":[[620,4140],[620,4207],[679,4207],[679,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end3","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 919 4207 Q 931 4207 931 4219 L 931 4274","p":[[620,4140],[620,4207],[931,4207],[931,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end4","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 1171 4207 Q 1183 4207 1183 4219 L 1183 4274","p":[[620,4140],[620,4207],[1183,4207],[1183,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end5","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 1423 4207 Q 1435 4207 1435 4219 L 1435 4274","p":[[620,4140],[620,4207],[1435,4207],[1435,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end6","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 1675 4207 Q 1687 4207 1687 4219 L 1687 4274","p":[[620,4140],[620,4207],[1687,4207],[1687,4274]],"lane":"end","terminal":true},{"from":"personLeaves","to":"end7","d":"M 620 4140 L 620 4195 Q 620 4207 632 4207 L 1927 4207 Q 1939 4207 1939 4219 L 1939 4274","p":[[620,4140],[620,4207],[1939,4207],[1939,4274]],"lane":"end","terminal":true},{"from":"raised","to":"rkDuplicate","d":"M 1120 240 L 2342 240 Q 2354 240 2354 252 L 2354 500 Q 2354 512 2366 512 L 2400 512","p":[[1120,240],[2354,240],[2354,512],[2400,512]],"lane":"record","dashed":true},{"from":"raised","to":"rkIntakeLost","d":"M 1120 240 L 2342 240 Q 2354 240 2354 252 L 2354 628 Q 2354 640 2366 640 L 2400 640","p":[[1120,240],[2354,240],[2354,640],[2400,640]],"lane":"record","dashed":true},{"from":"edArrived","to":"rkClearance","d":"M 1800 1083 L 2354 1083 L 2354 1083 L 2400 1083","p":[[1800,1083],[2354,1083],[2354,1083],[2400,1083]],"lane":"record","dashed":true},{"from":"placement","to":"rkClock","d":"M 1120 1884 L 2354 1884 L 2354 1884 L 2400 1884","p":[[1120,1884],[2354,1884],[2354,1884],[2400,1884]],"lane":"absent","terminal":true,"dashed":true},{"from":"placement","to":"rkSettings","d":"M 1120 1884 L 2342 1884 Q 2354 1884 2354 1896 L 2354 2000 Q 2354 2012 2366 2012 L 2400 2012","p":[[1120,1884],[2354,1884],[2354,2012],[2400,2012]],"lane":"record","dashed":true},{"from":"asked","to":"rkQueue","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2128 Q 2354 2140 2366 2140 L 2400 2140","p":[[1120,2006],[2354,2006],[2354,2140],[2400,2140]],"lane":"record","dashed":true},{"from":"asked","to":"rkClash","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2256 Q 2354 2268 2366 2268 L 2400 2268","p":[[1120,2006],[2354,2006],[2354,2268],[2400,2268]],"lane":"record","dashed":true},{"from":"asked","to":"rkUrgent","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2384 Q 2354 2396 2366 2396 L 2400 2396","p":[[1120,2006],[2354,2006],[2354,2396],[2400,2396]],"lane":"record","dashed":true},{"from":"asked","to":"rkEscalate","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2512 Q 2354 2524 2366 2524 L 2400 2524","p":[[1120,2006],[2354,2006],[2354,2524],[2400,2524]],"lane":"record","dashed":true},{"from":"asked","to":"rkCapacity","d":"M 1120 2006 L 2342 2006 Q 2354 2006 2354 2018 L 2354 2640 Q 2354 2652 2366 2652 L 2400 2652","p":[[1120,2006],[2354,2006],[2354,2652],[2400,2652]],"lane":"record","dashed":true},{"from":"inPrinciple","to":"rkLegalStatus","d":"M 1120 2136 L 2342 2136 Q 2354 2136 2354 2148 L 2354 2768 Q 2354 2780 2366 2780 L 2400 2780","p":[[1120,2136],[2354,2136],[2354,2780],[2400,2780]],"lane":"record","dashed":true},{"from":"pulled","to":"rkForm","d":"M 1120 2273 L 2342 2273 Q 2354 2273 2354 2285 L 2354 2896 Q 2354 2908 2366 2908 L 2400 2908","p":[[1120,2273],[2354,2273],[2354,2908],[2400,2908]],"lane":"record","dashed":true},{"from":"pulled","to":"rkExam","d":"M 1120 2273 L 2342 2273 Q 2354 2273 2354 2285 L 2354 3024 Q 2354 3036 2366 3036 L 2400 3036","p":[[1120,2273],[2354,2273],[2354,3036],[2400,3036]],"lane":"record","dashed":true},{"from":"pulled","to":"rkLegalWritten","d":"M 1120 2273 L 2342 2273 Q 2354 2273 2354 2285 L 2354 3152 Q 2354 3164 2366 3164 L 2400 3164","p":[[1120,2273],[2354,2273],[2354,3164],[2400,3164]],"lane":"record","dashed":true},{"from":"pulled","to":"rkLegalMismatch","d":"M 1120 2273 L 2342 2273 Q 2354 2273 2354 2285 L 2354 3280 Q 2354 3292 2366 3292 L 2400 3292","p":[[1120,2273],[2354,2273],[2354,3292],[2400,3292]],"lane":"record","dashed":true},{"from":"collected","to":"rkNotice","d":"M 1120 2778 L 2342 2778 Q 2354 2778 2354 2790 L 2354 3408 Q 2354 3420 2366 3420 L 2400 3420","p":[[1120,2778],[2354,2778],[2354,3420],[2400,3420]],"lane":"record","dashed":true},{"from":"collected","to":"rkDiversion","d":"M 1120 2778 L 2342 2778 Q 2354 2778 2354 2790 L 2354 3536 Q 2354 3548 2366 3548 L 2400 3548","p":[[1120,2778],[2354,2778],[2354,3548],[2400,3548]],"lane":"record","dashed":true},{"from":"arrived","to":"rkExpiryShut","d":"M 1120 2908 L 2342 2908 Q 2354 2908 2354 2920 L 2354 3664 Q 2354 3676 2366 3676 L 2400 3676","p":[[1120,2908],[2354,2908],[2354,3676],[2400,3676]],"lane":"stall","dashed":true},{"from":"arrived","to":"rkExpectFlag","d":"M 1120 2908 L 2342 2908 Q 2354 2908 2354 2920 L 2354 3792 Q 2354 3804 2366 3804 L 2400 3804","p":[[1120,2908],[2354,2908],[2354,3804],[2400,3804]],"lane":"record","dashed":true},{"from":"occupied","to":"rkAwayRule","d":"M 1120 3030 L 2342 3030 Q 2354 3030 2354 3042 L 2354 3920 Q 2354 3932 2366 3932 L 2400 3932","p":[[1120,3030],[2354,3030],[2354,3932],[2400,3932]],"lane":"record","dashed":true},{"from":"occupied","to":"rkInbox","d":"M 1120 3030 L 2342 3030 Q 2354 3030 2354 3042 L 2354 4048 Q 2354 4060 2366 4060 L 2400 4060","p":[[1120,3030],[2354,3030],[2354,4060],[2400,4060]],"lane":"record","dashed":true},{"from":"occupied","to":"rkDischargePlan","d":"M 1120 3030 L 2342 3030 Q 2354 3030 2354 3042 L 2354 4176 Q 2354 4188 2366 4188 L 2400 4188","p":[[1120,3030],[2354,3030],[2354,4188],[2400,4188]],"lane":"record","dashed":true},{"from":"ready","to":"rkDischarge","d":"M 1120 3157 L 2342 3157 Q 2354 3157 2354 3169 L 2354 4304 Q 2354 4316 2366 4316 L 2400 4316","p":[[1120,3157],[2354,3157],[2354,4316],[2400,4316]],"lane":"record","dashed":true},{"from":"bedReleased","to":"rkPrep","d":"M 1360 4092 L 2342 4092 Q 2354 4092 2354 4104 L 2354 4432 Q 2354 4444 2366 4444 L 2400 4444","p":[[1360,4092],[2354,4092],[2354,4444],[2400,4444]],"lane":"record","dashed":true},{"from":"bedReleased","to":"rkOwnership","d":"M 1360 4092 L 2342 4092 Q 2354 4092 2354 4104 L 2354 4560 Q 2354 4572 2366 4572 L 2400 4572","p":[[1360,4092],[2354,4092],[2354,4572],[2400,4572]],"lane":"record","dashed":true},{"from":"bedReleased","to":"rkWardDay","d":"M 1360 4092 L 2342 4092 Q 2354 4092 2354 4104 L 2354 4688 Q 2354 4700 2366 4700 L 2400 4700","p":[[1360,4092],[2354,4092],[2354,4700],[2400,4700]],"lane":"record","dashed":true},{"from":"cmhtAccepted","to":"cmhtAccepted","d":"M 60 765 L 22 765","p":[[60,765],[22,765]],"lane":"end","terminal":true},{"from":"cmhtDeclined","to":"cmhtDeclined","d":"M 60 916 L 22 916","p":[[60,916],[22,916]],"lane":"end","terminal":true},{"from":"cmhtNothing","to":"cmhtNothing","d":"M 60 1064 L 22 1064","p":[[60,1064],[22,1064]],"lane":"stall","terminal":true},{"from":"cmhtWithdrawn","to":"cmhtWithdrawn","d":"M 60 1207 L 22 1207","p":[[60,1207],[22,1207]],"lane":"stall","terminal":true},{"from":"wardDeclined","to":"wardDeclined","d":"M 700 916 L 662 916","p":[[700,916],[662,916]],"lane":"end","terminal":true},{"from":"wardNothing","to":"wardNothing","d":"M 700 1070 L 662 1070","p":[[700,1070],[662,1070]],"lane":"stall","terminal":true},{"from":"othersCancelled","to":"othersCancelled","d":"M 700 1218 L 662 1218","p":[[700,1218],[662,1218]],"lane":"diversion","terminal":true},{"from":"wardWithdrawn","to":"wardWithdrawn","d":"M 700 1375 L 662 1375","p":[[700,1375],[662,1375]],"lane":"diversion","terminal":true},{"from":"wardBlocked","to":"wardBlocked","d":"M 700 1528 L 662 1528","p":[[700,1528],[662,1528]],"lane":"stall","terminal":true},{"from":"edNeverArrives","to":"edNeverArrives","d":"M 1300 940 L 1262 940","p":[[1300,940],[1262,940]],"lane":"stall","terminal":true},{"from":"edDeclined","to":"edDeclined","d":"M 1300 1502 L 1262 1502","p":[[1300,1502],[1262,1502]],"lane":"end","terminal":true},{"from":"edToCommunity","to":"edToCommunity","d":"M 1300 1982 L 1262 1982","p":[[1300,1982],[1262,1982]],"lane":"diversion","terminal":true},{"from":"edLeft","to":"edLeft","d":"M 1300 2129 L 1262 2129","p":[[1300,2129],[1262,2129]],"lane":"end","terminal":true},{"from":"sWardDecline","to":"sWardDecline","d":"M 60 2016 L 22 2016","p":[[60,2016],[22,2016]],"lane":"stall","terminal":true},{"from":"sWithdrawWard","to":"sWithdrawWard","d":"M 60 2152 L 22 2152","p":[[60,2152],[22,2152]],"lane":"stall","terminal":true},{"from":"sAcceptWithdrawn","to":"sAcceptWithdrawn","d":"M 60 2288 L 22 2288","p":[[60,2288],[22,2288]],"lane":"stall","terminal":true},{"from":"sAbandoned","to":"sAbandoned","d":"M 60 2424 L 22 2424","p":[[60,2424],[22,2424]],"lane":"end","terminal":true},{"from":"sPullReleased","to":"sPullReleased","d":"M 60 2560 L 22 2560","p":[[60,2560],[22,2560]],"lane":"stall","terminal":true},{"from":"sCancelTransport","to":"sCancelTransport","d":"M 60 2696 L 22 2696","p":[[60,2696],[22,2696]],"lane":"stall","terminal":true},{"from":"sStopTransport","to":"sStopTransport","d":"M 60 2832 L 22 2832","p":[[60,2832],[22,2832]],"lane":"diversion","terminal":true},{"from":"dForced","to":"dForced","d":"M 1300 2334 L 1262 2334","p":[[1300,2334],[1262,2334]],"lane":"forced","terminal":true},{"from":"dGenderHard","to":"dGenderHard","d":"M 1300 2474 L 1262 2474","p":[[1300,2474],[1262,2474]],"lane":"stall","terminal":true},{"from":"dNonBinary","to":"dNonBinary","d":"M 1300 2614 L 1262 2614","p":[[1300,2614],[1262,2614]],"lane":"forced","terminal":true},{"from":"dNoLongerSuits","to":"dNoLongerSuits","d":"M 1300 3174 L 1262 3174","p":[[1300,3174],[1262,3174]],"lane":"stall","terminal":true},{"from":"dAway","to":"dAway","d":"M 1300 3594 L 1262 3594","p":[[1300,3594],[1262,3594]],"lane":"diversion","terminal":true},{"from":"dRepat","to":"dRepat","d":"M 1300 3874 L 1262 3874","p":[[1300,3874],[1262,3874]],"lane":"diversion","terminal":true},{"from":"bedStuck","to":"bedStuck","d":"M 1440 4092 L 1402 4092","p":[[1440,4092],[1402,4092]],"lane":"stall","terminal":true},{"from":"end0","to":"end0","d":"M 60 4330 L 22 4330","p":[[60,4330],[22,4330]],"lane":"end","terminal":true},{"from":"end1","to":"end1","d":"M 427 4386 L 427 4424","p":[[427,4386],[427,4424]],"lane":"diversion","terminal":true},{"from":"end2","to":"end2","d":"M 679 4386 L 679 4424","p":[[679,4386],[679,4424]],"lane":"end","terminal":true},{"from":"end3","to":"end3","d":"M 931 4386 L 931 4424","p":[[931,4386],[931,4424]],"lane":"end","terminal":true},{"from":"end4","to":"end4","d":"M 1183 4386 L 1183 4424","p":[[1183,4386],[1183,4424]],"lane":"end","terminal":true},{"from":"end5","to":"end5","d":"M 1435 4386 L 1435 4424","p":[[1435,4386],[1435,4424]],"lane":"end","terminal":true},{"from":"end6","to":"end6","d":"M 1687 4386 L 1687 4424","p":[[1687,4386],[1687,4424]],"lane":"end","terminal":true},{"from":"end7","to":"end7","d":"M 2054 4330 L 2092 4330","p":[[2054,4330],[2092,4330]],"lane":"end","terminal":true},{"from":"rkClock","to":"rkClock","d":"M 2400 1884 L 2362 1884","p":[[2400,1884],[2362,1884]],"lane":"absent","terminal":true},{"from":"rkExpiryShut","to":"rkExpiryShut","d":"M 2400 3676 L 2362 3676","p":[[2400,3676],[2362,3676]],"lane":"stall","terminal":true}]},"machines":{"machines":[{"id":"referral","name":"A referral destination","subject":"One addressed destination. A referral can name several distinct wards within the configured recipient cap; answers and reassessments belong to the individual destination.","width":1064,"height":456,"states":[{"id":"start","kind":"start","x":482,"y":20,"w":80,"h":40,"label":"raised"},{"id":"queued","kind":"normal","x":412,"y":110,"w":220,"h":76,"label":"Waiting","sub":"Doing nothing is a real answer, and the commonest one. It stays here indefinitely."},{"id":"accepted","kind":"terminal","x":804,"y":110,"w":220,"h":76,"label":"Accepted","sub":"Records a destination answer. Acceptance creates no movement or admission; a ward answer may also reserve a named bed on the referral."},{"id":"declined","kind":"terminal","x":20,"y":110,"w":220,"h":76,"label":"Declined","sub":"Ends this answer. An explicit clinical reassessment can reconsider a declined destination."},{"id":"cancelled","kind":"terminal","x":804,"y":270,"w":220,"h":86,"label":"Cancelled","sub":"Closed automatically because another destination accepted. Nobody is asked."},{"id":"withdrawn","kind":"flag","x":20,"y":270,"w":220,"h":96,"label":"Withdrawn — a flag, not a state","sub":"Stamped on every destination still waiting. The arm stays waiting; it does not end."}],"transitions":[{"from":"start","to":"queued","action":"RECEIVE_REFERRAL","route":"down"},{"from":"queued","to":"accepted","action":"ACCEPT_REFERRAL","route":"straight"},{"from":"queued","to":"declined","action":"DECLINE_REFERRAL","route":"straight","guard":"the reason must come from this destination kind's own list"},{"from":"declined","to":"accepted","action":"ACCEPT_REFERRAL","route":"below","offset":0,"kind":"back","label":"on clinical reassessment","guard":"only as an explicit clinical reassessment of this destination"},{"from":"queued","to":"cancelled","action":"ACCEPT_REFERRAL","route":"below","offset":40,"label":"another arm accepted","kind":"side","guard":"a community arm is exempt in both directions and is never cancelled"},{"from":"queued","to":"withdrawn","action":"RECORD_REFERRER_WITHDRAWAL","route":"below","offset":40,"guard":"refused once anything is accepted, and refused outright once transport has collected the patient","kind":"side","label":"stamps every waiting arm"}],"note":"The destination states remain queued, accepted, declined and cancelled. A withdrawal stamps still-queued arms without rewriting their state. A clinical reassessment can update an accepted answer or turn a decline into acceptance; the ordinary first-acceptance cancellation excludes community arms in both directions."},{"id":"movement","name":"A movement","subject":"The separate bed-search record created by RAISE_REFERRAL, or created already arrived by an admitted-ward transfer. Front-door acceptance alone creates no movement. Seven stages plus a separate closure.","width":3122,"height":900,"states":[{"id":"start","kind":"start","x":20,"y":370,"w":230,"h":60,"label":"Movement created"},{"id":"placement_requested","kind":"normal","x":20,"y":180,"w":230,"h":86,"label":"Placement requested","sub":"Wards can be asked from here."},{"id":"destination_review","kind":"normal","x":492,"y":180,"w":230,"h":86,"label":"Destination review","sub":"Wards can be asked from here too — and only from these two."},{"id":"accepted_awaiting_bed","kind":"normal","x":964,"y":180,"w":230,"h":86,"label":"Accepted, awaiting bed","sub":"A ward has said yes. No bed is set aside."},{"id":"pulled","kind":"normal","x":1436,"y":180,"w":230,"h":86,"label":"Bed pulled","sub":"A bed is pulled and linked to an admission. The hold uses current configuration and any applicable extra-travel extension; expiry flags it for a person rather than releasing it."},{"id":"handover_ready","kind":"normal","x":1908,"y":180,"w":230,"h":86,"label":"Handover ready","sub":"Requires a booked job or an explicitly recorded no-transport-needed answer, plus current held-bed gender and legal checks."},{"id":"moving","kind":"normal","x":2380,"y":180,"w":230,"h":86,"label":"Moving","sub":"The patient is in the vehicle."},{"id":"arrived","kind":"terminal","x":2852,"y":180,"w":230,"h":86,"label":"Arrived","sub":"STEP_BACK_STAGE cannot reverse arrival. A separate scoped Undo may reverse the latest unchanged recorded arrival within its window and restored-bed checks."},{"id":"closed","kind":"terminal","x":1396,"y":760,"w":310,"h":90,"label":"Closed — did not proceed","sub":"Not a stage. The stage it closed at is still recorded."}],"transitions":[{"from":"start","to":"placement_requested","action":"RAISE_REFERRAL","route":"up","label":"creates it"},{"from":"placement_requested","to":"destination_review","action":"REFER_TO_UNITS","route":"straight"},{"from":"destination_review","to":"destination_review","action":"DECLINE","route":"self","offset":0,"label":"a ward says no","guard":"that ward drops off the list; the stage does not move"},{"from":"destination_review","to":"destination_review","action":"WITHDRAW_WARD_REQUEST","route":"self","offset":34,"label":"take one ward back"},{"from":"destination_review","to":"destination_review","action":"REFER_TO_UNITS","route":"self","offset":68,"label":"ask more wards"},{"from":"destination_review","to":"accepted_awaiting_bed","action":"ACCEPT_IN_PRINCIPLE","route":"straight"},{"from":"accepted_awaiting_bed","to":"destination_review","action":"WITHDRAW_ACCEPTANCE","route":"below","offset":40,"kind":"back","guard":"Allowed while awaiting a bed or with a pulled/stepped-back hold. A held bed is released atomically; cancel a live transport job first. Refused at handover-ready/moving."},{"from":"accepted_awaiting_bed","to":"pulled","action":"PULL_PATIENT","route":"straight"},{"from":"pulled","to":"accepted_awaiting_bed","action":"RELEASE_PULL","route":"below","offset":90,"kind":"back"},{"from":"pulled","to":"handover_ready","action":"HANDOVER_READY","route":"straight"},{"from":"handover_ready","to":"moving","action":"PATIENT_COLLECTED","route":"straight","guard":"refused while a revoked examination still holds the bed, or while restrictive practice is still recorded as in use for the patient at the sending ward"},{"from":"moving","to":"arrived","action":"PATIENT_ARRIVED","route":"straight"},{"from":"pulled","to":"arrived","action":"PATIENT_ARRIVED","route":"above","offset":30,"label":"no transport needed","kind":"skip"},{"from":"pulled","to":"closed","action":"WITHDRAW_REFERRAL","route":"exit","offset":0,"kind":"exit"},{"from":"pulled","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":38,"kind":"exit"},{"from":"pulled","to":"closed","action":"REFER_TO_COMMUNITY_TEAM","route":"exit","offset":76,"kind":"exit"},{"from":"pulled","to":"closed","action":"RECORD_EXAMINATION","route":"exit","offset":114,"kind":"exit","label":"community order or revoked","guard":"A community order before transport commitment closes and refunds. Revocation while a bed is held retains it and flags release; commitment or collection also retains the bed."},{"from":"moving","to":"closed","action":"STOP_TRANSPORT","route":"exit","offset":0,"kind":"exit","guard":"the bed deliberately stays held; only releasing the held bed gives it back"},{"from":"arrived","to":"closed","action":"PATIENT_ARRIVED","route":"exit","offset":0,"kind":"side","label":"closes as arrived, not as did-not-proceed"},{"from":"start","to":"arrived","action":"RECORD_ADMISSION_CARE","route":"below","offset":0,"kind":"skip","label":"ward transfer arrival: created already arrived","guard":"only a coordinator recording a transfer as arrived, for an occupied admission, into a ward with a suitable free bed and staffing; the new movement is opened and closed as arrived in one write, never raised in a department"},{"from":"moving","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":130,"kind":"back","label":"to ANY strictly earlier stage","guard":"refused once arrived; touches nothing but the stage — no bed given back, no transport cancelled"},{"from":"destination_review","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":90,"kind":"back","guard":"the same step back as from Moving: to any strictly earlier stage, touching nothing but the stage"},{"from":"accepted_awaiting_bed","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":100,"kind":"back","guard":"the same step back as from Moving: to any strictly earlier stage, touching nothing but the stage"},{"from":"pulled","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":110,"kind":"back","guard":"the same step back as from Moving: to any strictly earlier stage, touching nothing but the stage"},{"from":"handover_ready","to":"placement_requested","action":"STEP_BACK_STAGE","route":"above","offset":120,"kind":"back","guard":"the same step back as from Moving: to any strictly earlier stage, touching nothing but the stage"},{"from":"pulled","to":"destination_review","action":"WITHDRAW_ACCEPTANCE","route":"below","offset":120,"kind":"back","guard":"the held bed is released in the same write; cancel a live transport job first"},{"from":"placement_requested","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":150,"kind":"exit"},{"from":"placement_requested","to":"closed","action":"RECORD_EXAMINATION","route":"exit","offset":174,"kind":"exit","label":"community order","guard":"a community order before a bed is pulled closes the journey"},{"from":"destination_review","to":"closed","action":"WITHDRAW_REFERRAL","route":"exit","offset":198,"kind":"exit"},{"from":"destination_review","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":222,"kind":"exit"},{"from":"destination_review","to":"closed","action":"RECORD_EXAMINATION","route":"exit","offset":246,"kind":"exit","label":"community order","guard":"a community order before a bed is pulled closes the journey"},{"from":"accepted_awaiting_bed","to":"closed","action":"WITHDRAW_REFERRAL","route":"exit","offset":270,"kind":"exit"},{"from":"accepted_awaiting_bed","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":294,"kind":"exit"},{"from":"accepted_awaiting_bed","to":"closed","action":"RECORD_EXAMINATION","route":"exit","offset":318,"kind":"exit","label":"community order","guard":"a community order before a bed is pulled closes the journey"},{"from":"handover_ready","to":"closed","action":"WITHDRAW_REFERRAL","route":"exit","offset":342,"kind":"exit"},{"from":"handover_ready","to":"closed","action":"RECORD_ED_OUTCOME","route":"exit","offset":366,"kind":"exit"}],"note":"STEP_BACK_STAGE records a strictly earlier stage with a reason, leaving bed and transport intact. It refuses a closure, an arrived stage or a delivered transport leg. WITHDRAW_ACCEPTANCE can release an uncollected hold atomically after cancelling a live job. The separate scoped UNDO_TRANSPORT_STEP route may reverse the latest recorded arrival while its time-window, unchanged-snapshot, actor and restored-bed checks pass. Withdrawing the referral (after placement is requested), an ED outcome (before Moving) and a community order (before a bed is pulled) close the movement from every open stage the engine allows, not only from Bed pulled; tests/ward-audit-m26-machine-moves.test.ts checks every arrow against the engine."},{"id":"admission","name":"An admission","subject":"The held or occupied stay. A new pull creates a held admission; supported direct placement/planned-arrival and ward-transfer paths can create an occupied admission without passing through Held.","width":1684,"height":426,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":190,"h":76,"label":"No admission"},{"id":"pulled","kind":"normal","x":458,"y":60,"w":230,"h":76,"label":"Held","sub":"A bed is theirs. They are not here yet."},{"id":"occupied","kind":"normal","x":936,"y":60,"w":230,"h":76,"label":"Occupied","sub":"Stays theirs through leave, an ED trip, and an absconding."},{"id":"departed","kind":"terminal","x":1414,"y":60,"w":230,"h":76,"label":"Departed","sub":"Kept. Ended, never deleted."},{"id":"deleted","kind":"flag","x":423,"y":250,"w":300,"h":86,"label":"Removed — not a state","sub":"There is no “deleted” among the four admission states. The record itself is taken away."},{"id":"waitlisted","kind":"unreachable","x":1434,"y":250,"w":190,"h":86,"label":"Waitlisted","sub":"No action in the engine can produce this. Only the starting fixture writes it."}],"transitions":[{"from":"none","to":"pulled","action":"PULL_PATIENT","route":"straight","label":"creates it"},{"from":"pulled","to":"occupied","action":"PATIENT_ARRIVED","route":"straight"},{"from":"occupied","to":"departed","action":"RECORD_LEAVING","route":"straight","guard":"only from occupied, and only by the ward they are on"},{"from":"occupied","to":"departed","action":"RECORD_ADMISSION_CARE","route":"below","offset":0,"kind":"side","label":"transferred to another ward","guard":"only when a coordinator records the transfer as arrived; the stay ends with the destination transferred-to-another-psychiatric-ward and any live bed release is completed"},{"from":"none","to":"occupied","action":"RECORD_ADMISSION_CARE","route":"below","offset":60,"kind":"skip","label":"transfer arrival: new admission, already occupied","guard":"the receiving ward gets a NEW admission with a new linked movement; no bed is pulled first, so it never passes through Held"},{"from":"occupied","to":"occupied","action":"RECORD_AWAY_AT_EMERGENCY_DEPARTMENT","route":"self","offset":0,"label":"away at an ED — bed untouched"},{"from":"occupied","to":"occupied","action":"RECORD_RETURNED_FROM_EMERGENCY_DEPARTMENT","route":"self","offset":34,"label":"and back"},{"from":"pulled","to":"deleted","action":"RELEASE_PULL","route":"exit","offset":0,"kind":"exit"},{"from":"pulled","to":"deleted","action":"RELEASE_HELD_BED","route":"exit","offset":38,"kind":"exit"},{"from":"pulled","to":"deleted","action":"WITHDRAW_REFERRAL","route":"exit","offset":76,"kind":"exit"},{"from":"pulled","to":"deleted","action":"RECORD_ED_OUTCOME","route":"exit","offset":114,"kind":"exit"},{"from":"pulled","to":"deleted","action":"REFER_TO_COMMUNITY_TEAM","route":"exit","offset":152,"kind":"exit"},{"from":"pulled","to":"deleted","action":"RECORD_EXAMINATION","route":"exit","offset":190,"kind":"exit"}],"note":"Ending and deleting are deliberately different. A departed admission is kept as a record that somebody was here; a released pull is removed, because the claim that they would be here is being retracted."},{"id":"transport","name":"A transport job","subject":"Booked by phone and logged here. Collection is the line that changes what is possible.","width":2390,"height":436,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":170,"h":76,"label":"No job"},{"id":"booked","kind":"normal","x":432,"y":60,"w":190,"h":76,"label":"Booked"},{"id":"accepted","kind":"normal","x":864,"y":60,"w":190,"h":76,"label":"Crew accepted"},{"id":"enroute","kind":"normal","x":1296,"y":60,"w":190,"h":76,"label":"En route"},{"id":"collected","kind":"normal","x":1728,"y":60,"w":190,"h":76,"label":"Collected","sub":"After this, cancelling is impossible."},{"id":"arrived","kind":"terminal","x":2160,"y":60,"w":190,"h":76,"label":"Arrived"},{"id":"stopped","kind":"terminal","x":1683,"y":260,"w":280,"h":86,"label":"Stopped","sub":"Somebody must say where the patient now is."}],"transitions":[{"from":"none","to":"booked","action":"BOOK_TRANSPORT","route":"straight","guard":"five answers, none defaulted"},{"from":"booked","to":"accepted","action":"TRANSPORT_ACCEPTED","route":"straight"},{"from":"accepted","to":"enroute","action":"TRANSPORT_EN_ROUTE","route":"straight","guard":"Requires an open movement at handover-ready, an accepted job and no earlier en-route timestamp. Refused while a revoked/community-order examination retains a bed or awaits release; this handler itself does not rerun held-unit gender/legal checks."},{"from":"enroute","to":"collected","action":"PATIENT_COLLECTED","route":"straight","guard":"refused while restrictive practice is still recorded as in use for the patient at the sending ward"},{"from":"collected","to":"arrived","action":"PATIENT_ARRIVED","route":"straight"},{"from":"booked","to":"none","action":"CANCEL_TRANSPORT","route":"below","offset":0,"kind":"exit","label":"the job is deleted, not marked"},{"from":"accepted","to":"none","action":"CANCEL_TRANSPORT","route":"below","offset":20,"kind":"exit"},{"from":"enroute","to":"none","action":"CANCEL_TRANSPORT","route":"below","offset":40,"kind":"exit","guard":"The booking ward/team must match the supplied acting place; an ED claim is checked against the recorded booking place when both are present. Coordinator access remains subject to the authenticated access boundary."},{"from":"collected","to":"stopped","action":"STOP_TRANSPORT","route":"exit","offset":0,"kind":"exit"}],"note":"Cancel and stop are not two names for one thing. Cancel deletes a job before collection and leaves the bed held; stop ends a journey already underway, closes the movement, and also leaves the bed held — but only stop demands to know where the patient is."},{"id":"bedrelease","name":"A bed release","subject":"A ward's plan for a bed coming free. It names the stay it belongs to, and nothing else about the person leaving.","width":1709,"height":566,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":170,"h":76,"label":"Not flagged"},{"id":"expected","kind":"normal","x":463,"y":60,"w":210,"h":76,"label":"Expected","sub":"Carries what it is waiting on — one of seven."},{"id":"confirmed","kind":"normal","x":946,"y":60,"w":210,"h":76,"label":"Confirmed","sub":"Decided. Still not a free bed."},{"id":"discharged","kind":"terminal","x":1429,"y":60,"w":240,"h":76,"label":"Discharged","sub":"The only step here that moves a real bed count."},{"id":"blocked","kind":"flag","x":428,"y":420,"w":280,"h":86,"label":"Stuck — a flag, not a stage","sub":"One of nine reasons. Sits on top of expected or confirmed; either can be flagged."},{"id":"preparing","kind":"flag","x":1250,"y":420,"w":300,"h":86,"label":"Being made ready — a flag","sub":"Cleaning or repair is a separate flag. It can be set on an expected, confirmed or discharged release, and recording the departure (or a ward transfer arriving) sets it too. It does not rewrite the ward count, but a new pull refuses when every free bed is still being prepared."}],"transitions":[{"from":"none","to":"expected","action":"FLAG_BED_RELEASE","route":"straight"},{"from":"expected","to":"confirmed","action":"CONFIRM_BED_RELEASE","route":"straight"},{"from":"confirmed","to":"expected","action":"REVERT_BED_RELEASE","route":"below","offset":40,"kind":"back"},{"from":"confirmed","to":"discharged","action":"RECORD_LEAVING","route":"straight"},{"from":"expected","to":"discharged","action":"RECORD_LEAVING","route":"above","offset":30,"kind":"skip","label":"straight from expected"},{"from":"confirmed","to":"discharged","action":"RECORD_ADMISSION_CARE","route":"below","offset":0,"kind":"side","label":"the patient's ward transfer completes it"},{"from":"expected","to":"discharged","action":"RECORD_ADMISSION_CARE","route":"below","offset":60,"kind":"skip","label":"straight from expected, by ward transfer"},{"from":"expected","to":"blocked","action":"BLOCK_BED_RELEASE","route":"exit","offset":0,"kind":"side"},{"from":"confirmed","to":"blocked","action":"BLOCK_BED_RELEASE","route":"exit","offset":90,"kind":"side"},{"from":"blocked","to":"expected","action":"CLEAR_BED_RELEASE_BLOCK","route":"exit","offset":0,"kind":"side"},{"from":"expected","to":"preparing","action":"SET_BED_PREPARATION","route":"exit","offset":110,"kind":"side"},{"from":"confirmed","to":"preparing","action":"SET_BED_PREPARATION","route":"exit","offset":130,"kind":"side"},{"from":"discharged","to":"preparing","action":"SET_BED_PREPARATION","route":"exit","offset":150,"kind":"side","label":"made ready after the person leaves"},{"from":"expected","to":"preparing","action":"RECORD_LEAVING","route":"exit","offset":170,"kind":"side","label":"the departure also marks the bed"},{"from":"confirmed","to":"preparing","action":"RECORD_LEAVING","route":"exit","offset":190,"kind":"side","label":"the departure also marks the bed"},{"from":"expected","to":"preparing","action":"RECORD_ADMISSION_CARE","route":"exit","offset":210,"kind":"side","label":"a ward transfer arriving also marks the bed"},{"from":"confirmed","to":"preparing","action":"RECORD_ADMISSION_CARE","route":"exit","offset":230,"kind":"side","label":"a ward transfer arriving also marks the bed"}],"note":"Being stuck used to be a fourth stage and was deliberately removed on 28 August 2026, because each stage says only how certain the discharge is. Stuck-ness and cleaning are two separate flags sitting on top."},{"id":"expects","name":"The front door — an expect becomes a referral","subject":"A door the earlier drawing missed entirely. A referral that has been triaged but whose patient has not arrived sits on a separate list; marking them present is what moves it.","width":2011,"height":240,"states":[{"id":"raised","kind":"start","x":20,"y":60,"w":200,"h":70,"label":"Raised"},{"id":"expected","kind":"normal","x":537,"y":60,"w":260,"h":90,"label":"Expected to arrive","sub":"Triaged, and the patient is not here yet. It sits on the Expects list."},{"id":"present","kind":"normal","x":1114,"y":60,"w":260,"h":90,"label":"In the department","sub":"Marked present. It now reads as a referral rather than an expect."},{"id":"cleared","kind":"flag","x":1691,"y":60,"w":280,"h":90,"label":"Medically cleared — or not","sub":"Three answers, not two: unrecorded, cleared, and explicitly not cleared."}],"transitions":[{"from":"raised","to":"expected","action":"RECEIVE_REFERRAL","route":"straight"},{"from":"expected","to":"present","action":"RECORD_ARRIVED_IN_DEPARTMENT","route":"straight","guard":"stamped once; a repeat keeps the earliest time"},{"from":"present","to":"cleared","action":"RECORD_MEDICAL_CLEARANCE","route":"straight","kind":"side"},{"from":"expected","to":"cleared","action":"RECORD_MEDICAL_CLEARANCE","route":"below","offset":0,"kind":"side","label":"clearance can come first"}],"note":"The owner's own words for this, quoted in the model: “When expects arrive and are marked as arrived, they become referrals.” Being marked present is the only door between the two lists."},{"id":"legalstatus","name":"A patient's legal status","subject":"Four values on an open movement. CHANGE_LEGAL_STATUS records a change and history; it does not itself release a bed or advance the journey. Sending-desk kind and authenticated place scope still apply.","width":1683,"height":226,"states":[{"id":"voluntary","kind":"normal","x":20,"y":60,"w":240,"h":76,"label":"Voluntary"},{"id":"referred","kind":"normal","x":451,"y":60,"w":280,"h":76,"label":"Referred for psychiatric examination"},{"id":"detained","kind":"normal","x":922,"y":60,"w":280,"h":76,"label":"Detained awaiting examination"},{"id":"involuntary","kind":"normal","x":1393,"y":60,"w":250,"h":76,"label":"Involuntary inpatient"}],"transitions":[{"from":"voluntary","to":"referred","action":"CHANGE_LEGAL_STATUS","route":"straight"},{"from":"referred","to":"detained","action":"CHANGE_LEGAL_STATUS","route":"straight"},{"from":"detained","to":"involuntary","action":"CHANGE_LEGAL_STATUS","route":"straight"},{"from":"involuntary","to":"voluntary","action":"CHANGE_LEGAL_STATUS","route":"below","offset":20,"kind":"back","label":"any value to any other"}],"note":"Any value can be recorded as another; arrows illustrate examples rather than an enforced legal sequence. The handler requires a listed reason and an open movement. A newly unsuitable accepted ward is surfaced for a person; forward placement/transport steps recheck legal authority, so the change can block later progress."},{"id":"examination","name":"An examination","subject":"Four outcomes. Two of them end the bed search; one of them asks for another examination and is the only way a second one is allowed.","width":1757,"height":426,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":200,"h":70,"label":"Not examined"},{"id":"further","kind":"normal","x":449,"y":60,"w":260,"h":90,"label":"Further examination ordered","sub":"The only outcome that allows another examination."},{"id":"inpatient","kind":"terminal","x":938,"y":60,"w":250,"h":90,"label":"Inpatient order","sub":"Recorded. Nothing else changes."},{"id":"ended","kind":"terminal","x":1417,"y":60,"w":300,"h":90,"label":"Community order, or revoked","sub":"A community order or revocation is recorded. Closure/release depends on the held-bed and transport facts."},{"id":"superseded","kind":"flag","x":320,"y":250,"w":300,"h":86,"label":"Superseded","sub":"The previous examination is kept, not overwritten."}],"transitions":[{"from":"none","to":"further","action":"RECORD_EXAMINATION","route":"straight"},{"from":"none","to":"inpatient","action":"RECORD_EXAMINATION","route":"above","offset":26,"kind":"skip"},{"from":"none","to":"ended","action":"RECORD_EXAMINATION","route":"above","offset":60,"kind":"skip"},{"from":"further","to":"superseded","action":"RECORD_EXAMINATION","route":"exit","offset":0,"kind":"side","label":"a second examination","guard":"a second examination is refused unless the last one ordered a further one"}],"note":"A community order before transport commitment closes the search and releases its hold. Revocation with a held bed retains the bed and admission, keeps the movement open and flags a person to act. At handover-ready, moving or after collection either ending outcome also retains it. Acceptance, en-route and collection refuse an unresolved examination/hold; physical arrival remains recordable."},{"id":"notice","name":"A notice","subject":"Twenty-four kinds of message, addressed to one role at one place. Written once, never rewritten, never deleted and never expiring.","width":1442,"height":246,"states":[{"id":"none","kind":"start","x":20,"y":60,"w":200,"h":70,"label":"Nothing sent"},{"id":"unread","kind":"normal","x":531,"y":60,"w":280,"h":96,"label":"Raised, unread","sub":"Its wording is frozen at the moment it is written, even if the thing it describes later changes."},{"id":"read","kind":"terminal","x":1122,"y":60,"w":280,"h":96,"label":"Read","sub":"Only the addressee can mark it, only by clicking, and only once."}],"transitions":[{"from":"none","to":"unread","action":"ACCEPT_REFERRAL","route":"straight","label":"one of twenty-four kinds","guard":"raised as a side-effect of an action, never on its own"},{"from":"unread","to":"read","action":"MARK_NOTICE_READ","route":"straight","guard":"refused if you are not the addressee, and refused a second time"}],"note":"Opening the drawer does not mark a notice read. MARK_NOTICE_READ requires the addressed role/place and an unread notice. These are append-only authored messages, separate from derived action-inbox rows and from broadcast alerts. Referral-answer notices resolve the referring ED for ed_medical referrals; other source kinds currently have no safe referrer addressee."},{"id":"inbox","name":"A row in the coordinator's inbox","subject":"Derived fact rows come from movements, stays, planned bookings and bed-meeting actions. A separate daily nobody-missed check is a commitment with append-only completion history.","width":1640,"height":416,"states":[{"id":"absent","kind":"start","x":20,"y":60,"w":220,"h":70,"label":"Not showing"},{"id":"showing","kind":"normal","x":620,"y":60,"w":300,"h":96,"label":"Showing","sub":"A current fact category is true, or a commitment is due. The current categories live in INBOX_CATEGORIES rather than a fixed five-item list."},{"id":"acknowledged","kind":"normal","x":1300,"y":60,"w":300,"h":96,"label":"Acknowledged","sub":"Somebody has seen a fact row. The row stays exactly where it was. A commitment is never acknowledged."},{"id":"ticked","kind":"normal","x":1140,"y":230,"w":300,"h":96,"label":"Commitment completed","sub":"The daily check can be completed and reopened. Live fact categories cannot be ticked away; bed-meeting actions use their dedicated completion event."}],"transitions":[{"from":"absent","to":"showing","action":"ACKNOWLEDGE_INBOX_ITEM","route":"straight","label":"the situation becomes true","kind":"side","guard":"nothing raises a row — it is derived, and appears on its own"},{"from":"showing","to":"acknowledged","action":"ACKNOWLEDGE_INBOX_ITEM","route":"straight","guard":"hides nothing and removes nothing; a second person acknowledging is a second real fact"},{"from":"showing","to":"ticked","action":"COMPLETE_INBOX_ITEM","route":"exit","offset":0,"kind":"side","label":"commitments only","guard":"Only commitment IDs; daily-check IDs require the day-N shape, and an already-complete history refuses. A commitment is completed straight from Showing and is never acknowledged. Facts remain until their underlying situation changes."},{"from":"ticked","to":"showing","action":"REOPEN_INBOX_ITEM","route":"above","offset":0,"kind":"back","label":"back to showing"}],"note":"Acknowledgement, ownership, snoozing and completion are separate histories. Real fact rows are never completed by COMPLETE_INBOX_ITEM. The daily check uses a day-shaped identifier rather than a movement; bed-meeting actions use COMPLETE_BED_MEETING_ACTION. CANCEL_TRANSPORT appends a returned snooze and a released ownership entry to the job's awaiting-departure and booking-estimate-passed rows. Completion validates category and day syntax, not whether the day is the current day."},{"id":"legalform","name":"A legal form's receipt","subject":"Whether the paperwork has physically arrived. It can be undone, and then happen again.","width":1382,"height":240,"states":[{"id":"not","kind":"start","x":20,"y":60,"w":240,"h":76,"label":"Not recorded as received"},{"id":"received","kind":"normal","x":521,"y":60,"w":260,"h":90,"label":"Recorded as received","sub":"Any of the nine forms with a legal clock, not only 1A. A second receipt is refused. A typed received time is kept as typed and cannot be later than now."},{"id":"expiry","kind":"flag","x":1042,"y":60,"w":300,"h":90,"label":"An expiry, typed by a clinician","sub":"Expiry comes from checked paper facts. An extension must be later; a correction with matching prior form/time/expiry and a listed reason may move it earlier."}],"transitions":[{"from":"not","to":"received","action":"RECORD_LEGAL_FORM_RECEIVED","route":"straight"},{"from":"received","to":"not","action":"CORRECT_LEGAL_FORM_RECEIPT","route":"below","offset":20,"kind":"back","guard":"three reasons: recorded in error, recorded against the wrong movement, or the form had not physically arrived"},{"from":"received","to":"expiry","action":"RECORD_LEGAL_FORM_EXPIRY","route":"straight","kind":"side"},{"from":"not","to":"expiry","action":"RECORD_LEGAL_FORM_EXPIRY","route":"above","offset":0,"kind":"side","label":"before a receipt"}],"note":"Receipt correction appends its reason and clears the receipt without erasing history. Expiry entry need not wait for a receipt: it requires a recorded form. The admitted ward may record a typed expiry on an arrived/closed movement; a checked correction and a later extension are distinct paths."}],"resources":{"title":"A ward's two bed counts","blurb":"The illustrated routes below show the principal stored-count changes; the current event models also cover planned admissions, direct placement and undo. A normal departure completes the named live release and raises empty/allocatable once. A departure resolving an arrival-capacity conflict clears that conflict instead of inventing another bed. Ready capacity also excludes closed wards, individually closed beds and other journeys' pending numbered reservations.","counts":[{"name":"Allocatable","means":"Beds the ward will let a coordinator take.","moves":[{"action":"PULL_PATIENT","effect":"− 1"},{"action":"RELEASE_PULL","effect":"+ 1"},{"action":"RELEASE_HELD_BED","effect":"+ 1"},{"action":"WITHDRAW_REFERRAL","effect":"+ 1","note":"via the same release"},{"action":"RECORD_ED_OUTCOME","effect":"+ 1","note":"via the same release"},{"action":"REFER_TO_COMMUNITY_TEAM","effect":"+ 1","note":"via the same release"},{"action":"RECORD_EXAMINATION","effect":"+ 1","note":"Community order before commitment can release a hold; revocation with a held bed retains it for a person to release."},{"action":"RECORD_LEAVING","effect":"+ 1","note":"the named patient leaving, which also completes their bed release"},{"action":"RECORD_ADMISSION_CARE","effect":"+ 1 on the ward they leave, − 1 on the ward they arrive at","note":"only a transfer recorded as arrived; the source ward's live bed release is completed in the same write"},{"action":"CONFIRM_CAPACITY","effect":"set outright","note":"a ward's own self-report, which can put it above the empty count"}]},{"name":"Empty","means":"Beds with physically nobody in them.","moves":[{"action":"PATIENT_ARRIVED","effect":"Usually −1, floored at zero; a pre-counted seeded pull is not decremented twice. Arrival into no empty bed is recorded as a capacity conflict."},{"action":"RECORD_LEAVING","effect":"+ 1","note":"Normally +1, bounded by authored capacity; resolving an arrival conflict or already-counted release does not create an extra free bed."},{"action":"RECORD_ADMISSION_CARE","effect":"+ 1 on the ward they leave, − 1 on the ward they arrive at","note":"only a transfer recorded as arrived"}]}]},"gates":{"title":"Can this ward take this patient?","blurb":"Thirteen possible eligibility labels across two paths, not thirteen blocking checks at every step. Eight labels belong to the suitability-override list. Acuity and specialling rows are information only; their actual staffing checks occur at placement. Gender designation has no override; Ready-bed and other physical-record checks run separately.","overridable":"Overridable means a coordinator may proceed anyway by choosing one of five recorded reasons: the receiving team has agreed despite the mismatch; clinical urgency outweighs the mismatch; the bed information is known to be out of date; continuity with a previous admission at this unit; closer to the person's home or family.","rows":[{"gate":"Authorisation","override":true,"referral":false,"movement":true,"asks":"If this patient is not voluntary, is the ward authorised under the Mental Health Act?"},{"gate":"Legal status","override":true,"referral":true,"movement":false,"asks":"The same question, asked at the front door instead — is an authorised bed needed, and does this ward have one?"},{"gate":"Cohort","override":true,"referral":false,"movement":true,"asks":"Does the ward's cohort match the patient's — adult, older adult, or youth?"},{"gate":"Age","override":true,"referral":true,"movement":false,"asks":"The same question at the front door, asked against the age band on the referral."},{"gate":"Security","override":true,"referral":true,"movement":true,"differs":true,"asks":"Does the patient need a locked bed?","note":"THE SAME NAME, TWO DIFFERENT QUESTIONS. At the front door it asks whether a locked bed is free right now. On a movement it asks only whether the ward has locked beds at all. The gap is known and written down."},{"gate":"Sex mix","override":true,"referral":true,"movement":true,"differs":true,"asks":"Is there already an occupant of the same sex, or more than one free bed?","note":"Both current sex-mix paths use Ready availability, with recorded gender and the defined recorded-sex fallback for non-binary or absent gender. Do not repeat the former front-door-versus-movement capacity difference for this row."},{"gate":"Forensic","override":true,"referral":true,"movement":true,"asks":"Is this a forensic ward? If so it is never offered."},{"gate":"Capacity freshness","override":true,"referral":true,"movement":true,"asks":"How long ago did the ward last confirm its numbers? A stale figure fails."},{"gate":"Gender designation","override":false,"referral":true,"movement":true,"hard":true,"asks":"Does the ward's designation suit the gender recorded at referral?","note":"Gender designation is checked before suitability overrides. A binary gender conflicting with the ward cannot be overridden. Non-binary, Different term and unrecorded gender can use an explicit coordinator placement record, subject to the current ward-checked reason requirements."},{"gate":"Acuity","override":false,"referral":true,"movement":true,"hard":true,"asks":"Information only: what high-acuity staffing is authored for the ward? Current use is checked at placement.","note":"This eligibility row always passes with info:true. PULL_PATIENT separately checks remaining high-acuity staffing and requires a valid reason plus nurse unit manager consultation for its supported exception."},{"gate":"Specialling","override":false,"referral":true,"movement":true,"hard":true,"differs":true,"asks":"Information only: what observation staffing is authored, and what does the recorded level need?","note":"This row always passes with info:true. A referral does not record observation level. PULL_PATIENT checks actual remaining observation staff; the eligibility row is not itself a hard refusal."},{"gate":"Prior decline","override":false,"referral":false,"movement":true,"hard":true,"asks":"Has this ward previously declined this movement? This is historical context; the reducer does not enforce it as a suitability refusal."},{"gate":"A bed to allocate","override":false,"referral":true,"movement":true,"hard":true,"differs":true,"asks":"Is there a bed to give?","note":"Movement matching can accept in principle on allocatable capacity; immediate referral matching requires Ready availability. PULL_PATIENT requires a Ready bed. Physical arrival is still recorded at zero empty capacity and creates an arrival-capacity conflict rather than refusing a patient in transit."}],"outside":{"title":"Placement and held-destination checks outside the label table","blurb":"These checks answer physical reservations, staffing and record consistency at their actual handlers. They are not all evaluated on every path; an already-held restoration has its own checks and physical arrival has a separate record-first path.","items":["A new pull needs a Ready bed, including closed-ward and closed-bed adjustments and live pulled admissions; when beds are being made ready it needs more Ready beds than pending ones (planned arrivals likewise). An arrival into zero empty capacity is recorded as a capacity conflict.","Every free bed still being prepared prevents a new pull.","Current observation staff and high-acuity capacity are checked at placement; supported exceptions need their recorded facts and acuity also needs nurse unit manager consultation.","A Secure request using an open bed requires the supported recorded reason; naming an unavailable numbered reservation still refuses.","Coordinator gender-placement records are required for the cases defined by genderReviewNeeded, and a binary designation conflict has no suitability override.","A restored hold rechecks its matching admission, current staffing, legal authority and gender rather than consuming another bed.","A no-transport arrival rechecks gender/legal status before arrival; an already-moving patient is recorded without stranding them at the door."]}},"gaps":[{"title":"The stored Unit.held field is not the live operational count","body":"Operational held/closed/Ready figures are derived. Unit.held remains seed and storage-validation data, so saying it is read in zero places is false. Filling this stored field is not a way to change the live derived figure.","question":"Would retiring this legacy storage field improve the model? Any removal needs a separately scoped migration and compatibility review."},{"title":"A patient-shaped placement wrapper remains separate from the live matching path","body":"genderEligibility is called by validateGenderPlacement, while live referral and movement matching share genderDesignationResult. These are distinct API shapes; the old claim that genderEligibility is never called is false. The wrapper currently has no production caller found in this source scan.","question":"Should the unused wrapper be retained as a public contract or retired under a separately reviewed API change? Its existence does not mean current matching skips gender."},{"title":"Inbox completion is for commitments; fact rows need their source condition resolved","body":"The daily nobody-missed check is a completable commitment, while derived fact rows cannot be ticked away. Bed-meeting actions have a separate completion event. COMPLETE_INBOX_ITEM validates the daily-check identifier shape and appends history; it does not verify that the named day is today.","question":"Should the daily-check API allow retrospective/future day records? Keep that product decision separate from the rule that live facts cannot be silenced."}],"review":{"reviewedOn":"2026-11-05","basis":"Source comparison of eleven machines, route nodes, gates, resources and current gap notes; not runtime or clinical acceptance. 5 November follow-up: explicit handler, payload, authority and caller review reconciled the consolidated audit repairs. Accepted observation sequence and legacy-tie fallback, current place/Undo provenance, safe world reset/import identity, return retry, meeting occurrence metadata and UI draft/completion ownership qualify existing transitions; they add no clinical decision or new physical transport stage. See CURRENT-REVIEW.md for the source-by-source review scope and reused versus fresh evidence. Main29f61/domain1430 reconciliation: accepted observation order is max(retained history,0)+1 with positive-safe restore metadata and sequence preserved through arrival; legacy ties retain compatibility fallback. Import and archive Undo share normalized retained identity, excluding explicit missing/privacy sentinels. Complete inverses preserve occupied-stay/leave consistency. No transition geometry or clinical rule changed; see CURRENT-REVIEW.md. #1447 consolidation, 5 November: other journeys' pending numbered bed reservations come off Ready and the free locked/open counts in the pull and planned-arrival gates; a pull release clears its held bed number and refuses a release matching no reservation; a coordinator transfer recorded as arrived needs a Ready bed; restore refuses a save whose live absences, active stays or numbered beds have more than one owner and names the broken rule. No transition geometry or clinical rule changed.","sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":619,"sha256":"d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"},{"path":"src/components/ward-management/legal-forms/legal-forms-screen.tsx","line":1,"sha256":"6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"},{"path":"src/components/ward-management/legal-forms/legal-forms-sheets.tsx","line":325,"sha256":"2d9f381246fc35b7c04bfcd41c26e67d584e594d41f73d8ddf1f913b7036c2bc"},{"path":"src/components/ward-management/patients/add-patient.tsx","line":87,"sha256":"fc5752f90ad948491ad836c940e4eb1571aba082c71cee36e4e6083afdf78002"},{"path":"src/components/ward-management/patients/patient-now-screen.tsx","line":1,"sha256":"dfb17d155ac70a24ed4bb602838067ce4b93753a8cdba1d9a89b24092aba2e44"},{"path":"src/components/ward-management/shell/ward-broadcast-banner-body.tsx","line":1,"sha256":"a96ae00d184b52341105eb90f8a0438f5f5561f787c2522f97e0e7ea62e87178"},{"path":"src/components/ward-management/shell/ward-broadcast-banner.tsx","line":1,"sha256":"d34087fc1cfb2356065997d7942882cd1bc9791e3041e71ec0fb0d279fe429be"},{"path":"src/components/ward-management/shell/ward-facade.ts","line":32,"sha256":"1f67e3da9d32ff7085af624d524b3bcefe1c1c7790164963a98d21da4c830d6b"},{"path":"src/components/ward-management/ward-change-reasons.ts","line":1,"sha256":"b22acd93e5b480a06ecaa78e29979f31d274e4700187416623afd9e32553b2e4"},{"path":"src/components/ward-management/ward-configuration.ts","line":34,"sha256":"3e6cffc45878c910d85d900ae10360c06b6c647bbb4cf749875aaf5bb5640ca8"},{"path":"src/components/ward-management/ward-derivations-transport.ts","line":265,"sha256":"877a3c89501efb8f518b4bae3e30b51efd042e38b4b066f2db6ebbc81591ebba"},{"path":"src/components/ward-management/ward-derivations.ts","line":1,"sha256":"c254f1512e5602170a15419774de985744bf603ba81113e8ecd46f21d5adccfe"},{"path":"src/components/ward-management/ward-duplicate-bed-requests.ts","line":1,"sha256":"1bef25c3e6a549941d0753e095e0c7aa4bb26a1fc2dd12e8a526e1f8d2f9ddf6"},{"path":"src/components/ward-management/ward-eligibility.ts","line":49,"sha256":"5a876b1943bbfa47b1db277fb4a5b36b37d80de4c4ff9bb6b620366d7217800d"},{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":619,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":1,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":430,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":1,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-record-events.ts","line":601,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":52,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":376,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1169,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":392,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1219,"sha256":"644830b71eeb2fa2bbe44499954aab3ceb97f4ac99fc2f84f29619632e89e8ff"},{"path":"src/components/ward-management/ward-flow-storage-validation.ts","line":460,"sha256":"cd370f6848c32198af9d13d0f8d43a4b1c5af4f1b9c1e2e5f1a8c15aefc81769"},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":85,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":270,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":58,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-model-leave.ts","line":1,"sha256":"ef7c345e94d36c3ee2e7ee4c1eda650106340a856d29afdb1da1feadc38aea4e"},{"path":"src/components/ward-management/ward-model-notices.ts","line":1,"sha256":"9f4ca23254737cc5eec8353ee99d05265b4f9fe7bc04d17fe7c2abd954c08678"},{"path":"src/components/ward-management/ward-model-referral-parts.ts","line":1,"sha256":"a23ccdb01397d9807f0455c3baed92c6c8700422593ebcb89f5a51e990281fb6"},{"path":"src/components/ward-management/ward-model.ts","line":1,"sha256":"246b885c01dade4f48f7a46d323569f34ac206a306597ae60a761a2b5d6b2f2d"},{"path":"src/components/ward-management/ward-patient-registration-reducer.ts","line":77,"sha256":"9e0f9c39d6d4a7f8f406fd438e09cd9ea7b7c6631a7bdd5e059d1f38de3caac4"},{"path":"src/components/ward-management/ward-ready-beds.ts","line":1,"sha256":"489095566f42be24921c7ba289b59a13514c656bf4846cf9cf94fad5a5aeb13c"},{"path":"src/components/ward-management/ward-undo.ts","line":1,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-observation.ts","line":48,"sha256":"b714525f0d4c6d18d050f9a3600f38c8de4e9a013595a77844c5c492fbdc2e3c"},{"path":"src/components/ward-management/ward-retained-umrn.ts","line":13,"sha256":"7968243f077b9d5c9a6fe6a56385f48ff6a97aa39cfdeec8fe97f05919693d80"}]}},"coverage":{"total":98,"mapped":46,"refusalSitesInSelectedFiles":160,"sampledSourceFiles":["ward-flow-reducer.ts","ward-flow-record-events.ts","ward-flow-undo-events.ts"],"refusalsNamed":248,"rows":[{"name":"Raise a referral at the front door","event":"RECEIVE_REFERRAL","transitions":["A referral destination: raised → Waiting","The front door — an expect becomes a referral: Raised → Expected to arrive"],"writes":""},{"name":"Add a person who is not on file","event":"ADD_PATIENT","transitions":[],"writes":"Creates a patient record."},{"name":"Record whether they are medically cleared","event":"RECORD_MEDICAL_CLEARANCE","transitions":["The front door — an expect becomes a referral: In the department → Medically cleared — or not","The front door — an expect becomes a referral: Expected to arrive → Medically cleared — or not"],"writes":"Replaces the referral answer and the matching movements’ clearance. Positive re-clearance stamps resumedAt and restates their blocker; it does not restore a released bed or booking."},{"name":"Mark that an expected patient has turned up","event":"RECORD_ARRIVED_IN_DEPARTMENT","transitions":["The front door — an expect becomes a referral: Expected to arrive → In the department"],"writes":"The arrival time, on a referral. Stamped once; a repeat is harmless."},{"name":"Accept the referral","event":"ACCEPT_REFERRAL","transitions":["A referral destination: Waiting → Accepted","A referral destination: Declined → Accepted","A referral destination: Waiting → Cancelled","A notice: Nothing sent → Raised, unread"],"writes":""},{"name":"Decline the referral","event":"DECLINE_REFERRAL","transitions":["A referral destination: Waiting → Declined"],"writes":""},{"name":"The referrer takes the referral back","event":"RECORD_REFERRER_WITHDRAWAL","transitions":["A referral destination: Waiting → Withdrawn — a flag, not a state"],"writes":""},{"name":"Add a correction to a referral","event":"ADD_REFERRAL_CORRECTION","transitions":[],"writes":"Appends a correction note to a referral. Never overwrites."},{"name":"Record that a bed closer to home was looked for","event":"RECORD_LOCAL_BED_SOUGHT","transitions":[],"writes":"That a closer-to-home bed was looked for, on a referral."},{"name":"Start a bed search from a department","event":"RAISE_REFERRAL","transitions":["A movement: Movement created → Placement requested"],"writes":""},{"name":"Ask one or more wards","event":"REFER_TO_UNITS","transitions":["A movement: Placement requested → Destination review","A movement: Destination review → Destination review"],"writes":""},{"name":"A ward accepts in principle","event":"ACCEPT_IN_PRINCIPLE","transitions":["A movement: Destination review → Accepted, awaiting bed"],"writes":""},{"name":"A ward declines the bed search","event":"DECLINE","transitions":["A movement: Destination review → Destination review"],"writes":""},{"name":"Take back one ward's request","event":"WITHDRAW_WARD_REQUEST","transitions":["A movement: Destination review → Destination review"],"writes":""},{"name":"Undo a ward's acceptance","event":"WITHDRAW_ACCEPTANCE","transitions":["A movement: Accepted, awaiting bed → Destination review","A movement: Bed pulled → Destination review"],"writes":""},{"name":"Abandon the bed search","event":"WITHDRAW_REFERRAL","transitions":["A movement: Bed pulled → Closed — did not proceed","A movement: Destination review → Closed — did not proceed","A movement: Accepted, awaiting bed → Closed — did not proceed","A movement: Handover ready → Closed — did not proceed","An admission: Held → Removed — not a state"],"writes":""},{"name":"Send them to a community team instead","event":"REFER_TO_COMMUNITY_TEAM","transitions":["A movement: Bed pulled → Closed — did not proceed","An admission: Held → Removed — not a state"],"writes":""},{"name":"The department decides they need no bed","event":"RECORD_ED_OUTCOME","transitions":["A movement: Bed pulled → Closed — did not proceed","A movement: Placement requested → Closed — did not proceed","A movement: Destination review → Closed — did not proceed","A movement: Accepted, awaiting bed → Closed — did not proceed","A movement: Handover ready → Closed — did not proceed","An admission: Held → Removed — not a state"],"writes":""},{"name":"Record that nobody referred them","event":"RECORD_NO_REFERRAL","transitions":[],"writes":"That nobody referred this patient, on a movement."},{"name":"Record an escalation","event":"RECORD_ESCALATION","transitions":[],"writes":"The wards tried and who was contacted, on a movement."},{"name":"Correct the record backwards","event":"STEP_BACK_STAGE","transitions":["A movement: Moving → Placement requested","A movement: Destination review → Placement requested","A movement: Accepted, awaiting bed → Placement requested","A movement: Bed pulled → Placement requested","A movement: Handover ready → Placement requested"],"writes":""},{"name":"Take the bed","event":"PULL_PATIENT","transitions":["A movement: Accepted, awaiting bed → Bed pulled","An admission: No admission → Held"],"writes":""},{"name":"Give the held bed back","event":"RELEASE_PULL","transitions":["A movement: Bed pulled → Accepted, awaiting bed","An admission: Held → Removed — not a state"],"writes":""},{"name":"Release a bed left held by a stopped journey","event":"RELEASE_HELD_BED","transitions":["An admission: Held → Removed — not a state"],"writes":""},{"name":"Record whether transport is needed","event":"RECORD_TRANSPORT_NEED","transitions":[],"writes":"Whether transport is needed, on a movement. This is what allows arrival with no journey."},{"name":"Book the transport","event":"BOOK_TRANSPORT","transitions":["A transport job: No job → Booked"],"writes":""},{"name":"Confirm handover is ready","event":"HANDOVER_READY","transitions":["A movement: Bed pulled → Handover ready"],"writes":""},{"name":"The crew accepts the job","event":"TRANSPORT_ACCEPTED","transitions":["A transport job: Booked → Crew accepted"],"writes":""},{"name":"The crew sets off","event":"TRANSPORT_EN_ROUTE","transitions":["A transport job: Crew accepted → En route"],"writes":""},{"name":"The patient is picked up","event":"PATIENT_COLLECTED","transitions":["A movement: Handover ready → Moving","A transport job: En route → Collected"],"writes":""},{"name":"The ward says they have arrived","event":"PATIENT_ARRIVED","transitions":["A movement: Moving → Arrived","A movement: Bed pulled → Arrived","A movement: Arrived → Closed — did not proceed","An admission: Held → Occupied","A transport job: Collected → Arrived"],"writes":""},{"name":"Cancel the transport before collection","event":"CANCEL_TRANSPORT","transitions":["A transport job: Booked → No job","A transport job: Crew accepted → No job","A transport job: En route → No job"],"writes":""},{"name":"Stop the journey after collection","event":"STOP_TRANSPORT","transitions":["A movement: Moving → Closed — did not proceed","A transport job: Collected → Stopped"],"writes":""},{"name":"Record that they have left the department","event":"RECORD_LEFT_DEPARTMENT","transitions":[],"writes":"The time they physically left the department, on a movement."},{"name":"Record an examination outcome","event":"RECORD_EXAMINATION","transitions":["A movement: Bed pulled → Closed — did not proceed","A movement: Placement requested → Closed — did not proceed","A movement: Destination review → Closed — did not proceed","A movement: Accepted, awaiting bed → Closed — did not proceed","An admission: Held → Removed — not a state","An examination: Not examined → Further examination ordered","An examination: Not examined → Inpatient order","An examination: Not examined → Community order, or revoked","An examination: Further examination ordered → Superseded"],"writes":""},{"name":"Change the legal status","event":"CHANGE_LEGAL_STATUS","transitions":["A patient's legal status: Voluntary → Referred for psychiatric examination","A patient's legal status: Referred for psychiatric examination → Detained awaiting examination","A patient's legal status: Detained awaiting examination → Involuntary inpatient","A patient's legal status: Involuntary inpatient → Voluntary"],"writes":"The Mental Health Act status, on a movement, plus a log entry. Triggers nothing."},{"name":"Mark a form as physically received","event":"RECORD_LEGAL_FORM_RECEIVED","transitions":["A legal form's receipt: Not recorded as received → Recorded as received"],"writes":"That the Form 1A physically arrived, on a movement."},{"name":"Undo a form receipt","event":"CORRECT_LEGAL_FORM_RECEIPT","transitions":["A legal form's receipt: Recorded as received → Not recorded as received"],"writes":"Clears that receipt and appends the correction."},{"name":"Record or extend a form's expiry","event":"RECORD_LEGAL_FORM_EXPIRY","transitions":["A legal form's receipt: Recorded as received → An expiry, typed by a clinician","A legal form's receipt: Not recorded as received → An expiry, typed by a clinician"],"writes":"Stores the typed expiry, clears any calculated legacy clock, appends basis/author/time history and, for a correction, its previous facts and reason."},{"name":"Correct the recorded gender","event":"RECORD_MOVEMENT_GENDER","transitions":[],"writes":"The recorded gender on a movement, plus a notice if a bed is involved."},{"name":"Record that the patient has left","event":"RECORD_LEAVING","transitions":["An admission: Occupied → Departed","A bed release: Confirmed → Discharged","A bed release: Expected → Discharged","A bed release: Expected → Being made ready — a flag","A bed release: Confirmed → Being made ready — a flag"],"writes":""},{"name":"Record that they are away at an ED","event":"RECORD_AWAY_AT_EMERGENCY_DEPARTMENT","transitions":["An admission: Occupied → Occupied"],"writes":""},{"name":"Record that they are back","event":"RECORD_RETURNED_FROM_EMERGENCY_DEPARTMENT","transitions":["An admission: Occupied → Occupied"],"writes":""},{"name":"Record a bed as on leave","event":"RECORD_LEAVE_BED","transitions":[],"writes":"Creates a leave record against a ward's bed."},{"name":"End a bed's leave","event":"END_LEAVE_BED","transitions":[],"writes":"Removes that leave record."},{"name":"Flag a bed as coming free","event":"FLAG_BED_RELEASE","transitions":["A bed release: Not flagged → Expected"],"writes":""},{"name":"Confirm the discharge is going ahead","event":"CONFIRM_BED_RELEASE","transitions":["A bed release: Expected → Confirmed"],"writes":""},{"name":"Put a confirmed discharge back to expected","event":"REVERT_BED_RELEASE","transitions":["A bed release: Confirmed → Expected"],"writes":""},{"name":"Flag a discharge as stuck","event":"BLOCK_BED_RELEASE","transitions":["A bed release: Expected → Stuck — a flag, not a stage","A bed release: Confirmed → Stuck — a flag, not a stage"],"writes":""},{"name":"Clear the stuck flag","event":"CLEAR_BED_RELEASE_BLOCK","transitions":["A bed release: Stuck — a flag, not a stage → Expected"],"writes":""},{"name":"Mark a bed as being made ready","event":"SET_BED_PREPARATION","transitions":["A bed release: Expected → Being made ready — a flag","A bed release: Confirmed → Being made ready — a flag","A bed release: Discharged → Being made ready — a flag"],"writes":""},{"name":"Restate how many beds a ward has","event":"CONFIRM_CAPACITY","transitions":[],"writes":"Sets a ward's allocatable count outright — see the two bed counts."},{"name":"Record what is restricting a ward's intake","event":"RECORD_WARD_INTAKE_CONSTRAINTS","transitions":[],"writes":"Replaces a ward's list of intake restrictions."},{"name":"Ask a ward to refresh its numbers","event":"REQUEST_CAPACITY_REFRESH","transitions":[],"writes":"Logs that somebody asked a ward to refresh. Moves no count."},{"name":"Change how urgent it is","event":"CHANGE_URGENCY","transitions":[],"writes":"The urgency level on a movement, plus a log entry. Re-sorts nothing."},{"name":"Flag it urgent","event":"FLAG_MOVEMENT_URGENT","transitions":[],"writes":"The urgent flag on a movement, and opens a history entry."},{"name":"Clear the urgent flag","event":"CLEAR_MOVEMENT_URGENT_FLAG","transitions":[],"writes":"Clears that flag and closes the history entry."},{"name":"Say what is holding this up","event":"RECORD_MOVEMENT_BLOCKER","transitions":[],"writes":"Free text describing what is holding a movement up."},{"name":"Say nothing is holding it up","event":"CLEAR_MOVEMENT_BLOCKER","transitions":[],"writes":"Writes the sentinel meaning nothing is holding it up."},{"name":"Mark a notice read","event":"MARK_NOTICE_READ","transitions":["A notice: Raised, unread → Read"],"writes":"Who read a notice, and when."},{"name":"Acknowledge an inbox row","event":"ACKNOWLEDGE_INBOX_ITEM","transitions":["A row in the coordinator's inbox: Not showing → Showing","A row in the coordinator's inbox: Showing → Acknowledged"],"writes":"Logs that a coordinator has seen an inbox row."},{"name":"Tick off an inbox row","event":"COMPLETE_INBOX_ITEM","transitions":["A row in the coordinator's inbox: Showing → Commitment completed"],"writes":"Appends completed role/time history without mutating patient, movement or unit facts."},{"name":"Reopen a completed row","event":"REOPEN_INBOX_ITEM","transitions":["A row in the coordinator's inbox: Commitment completed → Showing"],"writes":"Logs an inbox row as reopened, keeping that it was once done."},{"name":"Move the demonstration clock","event":"ADVANCE_CLOCK","transitions":[],"writes":"Adds the simulation clock offset; the provider also follows wall time at visible minute ticks."},{"name":"Reset the board","event":"RESET_SCENARIO","transitions":[],"writes":"Re-seeds all board state around the current visible time and clears the simulation offset, preserving the visible clock rather than always selecting the standard scenario."},{"name":"Switch to a different simulated night","event":"SET_SCENARIO","transitions":[],"writes":"Replaces the whole board with a different simulated night."},{"name":"Change the coordinator's settings","event":"SET_CONFIGURATION","transitions":[],"writes":"Applies the validated configuration or field merge atomically. It does not silently overwrite a conflicting baseline."},{"name":"Record a patient’s physical departure","event":"RECORD_PATIENT_DISCHARGE","transitions":[],"writes":"Departs the stay through the shared departure helper, adjusts resources, retains audit and a bounded step-undo record. A stale or inaccessible request refuses."},{"name":"Open an authorised discharge record","event":"OPEN_DISCHARGE_RECORD","transitions":[],"writes":"Records an accepted read audit event; changes no admission or bed figure."},{"name":"Record a governance review","event":"REVIEW_AUDIT_EVENT","transitions":[],"writes":"Appends a uniquely sequenced review and its audit record. A later review changes the expected count; UNDO_AUDIT_REVIEW is a separate recorded action."},{"name":"Divert a journey already under way","event":"RECORD_DIVERSION","transitions":[],"writes":"That a journey already under way was diverted, with a reason and where the patient went instead."},{"name":"Give back the bed a diverted patient was holding","event":"RELEASE_DIVERTED_BED","transitions":[],"writes":"Gives back the bed a diverted movement was still holding. Refused unless it really was diverted."},{"name":"Record how and when they are expected","event":"SET_ARRIVAL_DETAILS","transitions":[],"writes":"Stores arrival mode, optional tracking and estimate, retaining first-record author/time and later update provenance. Keeps the pull-expiry timer. An already-late estimate can send one-time ED/ward notices; it reserves no bed and moves no stage."},{"name":"Work out whether an expected arrival is late","event":"EVALUATE_ARRIVAL_LATENESS","transitions":[],"writes":"When late, stamps the movement and sends ED and ward notices; changes no stage."},{"name":"Mark somebody as a step-down candidate","event":"SET_STEP_DOWN_CANDIDATE","transitions":[],"writes":"Whether this admission is a candidate to step down to a lower level of care."},{"name":"Record what is holding a discharge up","event":"SET_DISCHARGE_BARRIER","transitions":[],"writes":"Stores a listed discharge barrier or clears it; no seven-day reducer gate and no bed count change."},{"name":"Record clinically ready and why not gone","event":"SET_CLINICALLY_READY","transitions":[],"writes":"Stores the day an on-ward patient became clinically ready and one listed reason they have not gone, or clears both (Josh, 9 Nov 2026); no bed count change."},{"name":"Set or move the expected discharge date","event":"UPDATE_EXPECTED_DISCHARGE","transitions":[],"writes":"Sets the expected time, increments date-move count only when an existing date differs, and stamps when. A ward setter is Nurse in charge; coordinator setter is null. Pending linked bed-release dates follow; completed release dates stay historical."},{"name":"Record care journey fact","event":"RECORD_ADMISSION_CARE","transitions":["A movement: Movement created → Arrived","An admission: Occupied → Departed","An admission: No admission → Occupied","A bed release: Confirmed → Discharged","A bed release: Expected → Discharged","A bed release: Expected → Being made ready — a flag","A bed release: Confirmed → Being made ready — a flag"],"writes":""},{"name":"Record follow-up arrangement","event":"RECORD_ADMISSION_FOLLOW_UP","transitions":[],"writes":"Follow-up contact arrangements recorded against an admission on the discharge board."},{"name":"Record medical clearance against the movement","event":"RECORD_MOVEMENT_MEDICAL_CLEARANCE","transitions":[],"writes":"Replaces clearance on the movement, matching linked referral and matching sibling movements. Positive fresh clearance records resumedAt for satisfied pauses; it does not restore released resources."},{"name":"Attach a file to the movement","event":"UPLOAD_PATIENT_FORM","transitions":[],"writes":"Appends generated document id, formName, fileType, sizeBytes and role/time metadata; no file body or original filename is retained."},{"name":"Record that a legal form was written","event":"RECORD_LEGAL_FORM_WRITTEN","transitions":[],"writes":"Stores current paper facts and history, preserves matching same-form paper facts on a time edit, and clears a calculated legacy clock. A different form clears the old receipt."},{"name":"Record that a form was continued","event":"RECORD_LEGAL_FORM_CONTINUATION","transitions":[],"writes":"The continued form and clinician-typed times; clears the old legal clock."},{"name":"Record a typed country Form 1A extension","event":"RECORD_COUNTRY_EXTENSION","transitions":[],"writes":"For eligible country Form1A, records typed paper expiry through the ordinary expiry handler; computes no statutory deadline."},{"name":"Flag that the ward's authority does not match","event":"FLAG_LEGAL_MISMATCH","transitions":[],"writes":"That a ward's authority does not match this person's legal status, in one of two shapes."},{"name":"Start a forty-eight-hour or seven-day clock by hand","event":"RAISE_EXPECT_FLAG","transitions":[],"writes":"Records the current manually raised flag. Replacing a previously cleared flag keeps that prior record in expectFlagHistory; no automatic state transition is implied."},{"name":"Clear that hand-set clock","event":"CLEAR_EXPECT_FLAG","transitions":[],"writes":"Stamps clearedAt and clearedBy on the flag; it is retained rather than removed."},{"name":"Give the bed back and reopen the search, in one act","event":"RELEASE_AND_REOPEN_SEARCH","transitions":[],"writes":"Returns any matching held bed, clears acceptance/hold/requests/transport and moves to placement_requested. Logs pull release when held, otherwise acceptance withdrawal."},{"name":"Confirm the ward's morning count","event":"CONFIRM_MORNING_ROLLUP","transitions":[],"writes":"A ward confirming its own morning count of expected discharges."},{"name":"Send a message to a ward","event":"SEND_WARD_BUZZ","transitions":[],"writes":"Appends a refresh request with a listed message and optional urgency; blank messages refuse and nothing is sent externally."},{"name":"Sweep the beds held during leave","event":"EVALUATE_LEAVE_BED_WARNINGS","transitions":[],"writes":"For each leave bed over the open-warning threshold that has not been warned, records openWarningAt and sends a ward notice. It does not release the bed or move capacity."},{"name":"Log a repatriation arranged by phone","event":"RECORD_REPATRIATION","transitions":[],"writes":"Creates or updates the telephone plan. First agreement creates an open placement_requested return movement linked to the source stay; it does not itself book transport or transfer the patient."},{"name":"Sign off the shift handover","event":"RECORD_HANDOVER_SIGN_OFF","transitions":[],"writes":"Appends role/time plus the selected ward id or network flag. It records no personal name/note and makes no claim that a sheet was sent."},{"name":"Record that a team was contacted","event":"RECORD_CLINICAL_CONTACT","transitions":[],"writes":"Which community team was contacted, when, and by which role."},{"name":"Send a network-wide alert","event":"DISPATCH_BROADCAST_ALERT","transitions":[],"writes":"A network-wide alert, active, with nobody yet acknowledging it. Belongs to no patient."},{"name":"Acknowledge a network-wide alert","event":"ACKNOWLEDGE_BROADCAST_ALERT","transitions":[],"writes":"One more unit on the alert's acknowledged list."},{"name":"Stand down a network-wide alert","event":"STAND_DOWN_BROADCAST_ALERT","transitions":[],"writes":"The alert marked stood down, with the time and the role."}]},"catalogue":[{"event":"RECORD_ADMISSION_CARE","roles":["ward","coordinator","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":20},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":213},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1580}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ADMISSION_FOLLOW_UP","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":21},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":213},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1579}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_PATIENT_DISCHARGE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":22},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1578}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"UPDATE_EXPECTED_DISCHARGE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":23},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":226},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1772}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"OPEN_DISCHARGE_RECORD","roles":["coordinator","ward","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":25},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":178},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1575}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REVIEW_AUDIT_EVENT","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":26},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":131},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1576}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RAISE_REFERRAL","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":37},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1573},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":92}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_EXAMINATION","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":38},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":549},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1872}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_MEDICAL_CLEARANCE","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":39},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":167},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1863}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ARRIVED_IN_DEPARTMENT","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":43},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":216},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1864}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_TRANSPORT_NEED","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":52},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":229},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1865}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_RECEIVED","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":59},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":434},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1546}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CORRECT_LEGAL_FORM_RECEIPT","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":65},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1853},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":429}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_EXPIRY","roles":["ed","coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":75},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1358},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":52},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1869}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_MOVEMENT_GENDER","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":80},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":480},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1870}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_NO_REFERRAL","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":81},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":297},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1866}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ED_OUTCOME","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":84},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":328},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1867}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REFER_TO_UNITS","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":85},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1855},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":675}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ACCEPT_IN_PRINCIPLE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":86},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":890},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":108}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"PULL_PATIENT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":90},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":79},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":694}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"DECLINE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":91},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1903},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":240}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"HANDOVER_READY","roles":["ed","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":94},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1997},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":85}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"TRANSPORT_ACCEPTED","roles":["officer","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":95},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1998},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":128}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"TRANSPORT_EN_ROUTE","roles":["officer","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":96},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1999},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":178}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"PATIENT_COLLECTED","roles":["officer","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":97},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2000},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":229},{"path":"src/components/ward-management/ward-transport-collection-events.ts","line":11}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"PATIENT_ARRIVED","roles":["officer","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":98},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1603},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":315}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CONFIRM_CAPACITY","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":100},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":300},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1774}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_WARD_INTAKE_CONSTRAINTS","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":103},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":767},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1878}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ESCALATION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":104},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1065},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1885}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ADVANCE_CLOCK","roles":["demo"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":105},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1817}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RESET_SCENARIO","roles":["demo"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":106},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1595}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_SCENARIO","roles":["demo"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":107},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1595}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_CONFIGURATION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":109},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1828}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CHANGE_URGENCY","roles":["coordinator","ed","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":112},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1859},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1178}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CHANGE_LEGAL_STATUS","roles":["coordinator","ed","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":113},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1860},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1219}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RELEASE_PULL","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":114},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":493},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1990}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"EXTEND_PULL","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":116},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":454},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1989}],"status":"modelled","model":{"subject":"One open movement whose bed is pulled now","before":"A pulled bed with its Pull time limit","after":"The same pulled bed with a later Pull time limit and one more pullExtensions entry","payload":["movementId; minutes (60, 120 or 240 from PULL_HOLD_EXTENSION_MINUTES); actingUnitId for a ward caller; now; role."],"scope":"coordinator and ward in the role table; a ward acts only for the unit holding the bed (claim, not proof).","guards":["The movement exists, is not closed, is at stage pulled with a Pull time limit, and its patient has not been collected.","minutes is on the fixed list.","The new limit stays within PULL_HOLD_MAX_TOTAL_MINUTES (12 hours) of the pull; a lapsed limit is extended from now."],"effects":["Moves Movement.pullExpiresAt later and appends { at, by, minutes } to Movement.pullExtensions; no bed count, stage or notice changes. PULL_PATIENT clears the list on a new pull."],"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":454,"sha256":"d03d664cb1f66c71f417fab7848bfbb308127dcb374dea22ffdeb14223d5e948"},{"path":"src/components/ward-management/ward-bed-hold-extension.ts","line":48,"sha256":"668e77dbccc3fcaa5409abea768e539bb949659a919c68a81b0bfb4578cd04dc"}],"tests":["tests/ward-extend-pull.test.ts"]},"reason":"Reviewed command model (feature 11, 9 Nov 2026): the ward or coordinator adds a fixed amount to a pulled bed's Pull time limit."},{"event":"BOOK_TRANSPORT","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":153},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2002},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":654}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CANCEL_TRANSPORT","roles":["coordinator","ed","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":175},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2003},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":840}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"STOP_TRANSPORT","roles":["coordinator","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":185},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2004},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1018}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_TRANSPORT_CAD","roles":["ed","ward","community","coordinator","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":188},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2007},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1131},{"path":"src/components/ward-management/ward-transport-collection-events.ts","line":30}],"status":"modelled","model":{"subject":"A movement’s current transport job","before":"Live, unarrived, uncancelled transport with no nonblank CAD number","after":"Same job carrying a trimmed CAD number and cadAdded time/role","payload":["movementId; cadNumber is required text, trimmed after validation","actingUnitId required in practice for ward callers; role and now"],"scope":"ED, ward, community, coordinator or officer in EVENT_ROLE. Ward acts only for the sending stay/ward; shared scope also restricts ED to origin ED and community to the sending team. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Existing open movement and live job; no existing nonblank CAD number","Reject blank or placeholder CAD values; ward’s actingUnitId must identify the sending ward"],"effects":["Updates only movement.transport.cadNumber and cadAdded; does not dispatch, accept or advance the job"],"sources":[{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1126,"sha256":"573cd3b2155de245658d45a432a45fd526cd829402d6b9c6b77ad8dc63f904cc"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":188,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-transport-collection-events.ts","line":30,"sha256":"1ebf665a65645eb14f53647d07db90bef0a947b2a7e298f2b6f203b7c78d3496"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-transport-cad-to-follow.test.ts"]},"reason":"Source-reviewed command model: Same job carrying a trimmed CAD number and cadAdded time/role."},{"event":"RELEASE_HELD_BED","roles":["coordinator","ward","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":190},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":619},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1991}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_DIVERSION","roles":["officer","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":192},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1092},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1886}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RELEASE_DIVERTED_BED","roles":["coordinator","ward","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":194},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":687},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1992}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REFER_TO_COMMUNITY_TEAM","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":195},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1854},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":477}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEFT_DEPARTMENT","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":196},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":529},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1871}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"FLAG_BED_RELEASE","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":199},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":372},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1775}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CONFIRM_BED_RELEASE","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":200},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":466},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1776}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REVERT_BED_RELEASE","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":204},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":505},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1777}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"BLOCK_BED_RELEASE","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":205},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":544},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1778}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CLEAR_BED_RELEASE_BLOCK","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":206},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":584},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1779}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_BED_PREPARATION","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":207},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":621},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1780}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEAVE_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":208},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1347},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":317},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1879}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"END_LEAVE_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":209},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":656},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1781}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_ABSENT_WITHOUT_LEAVE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":213},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1348},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":372},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1880}],"status":"modelled","model":{"subject":"An occupied admission and its held leave-bed record","before":"Occupied stay, not away at ED, with no recorded absence","after":"Leave-bed record carries absentWithoutLeave {since,steps:[]}; stay remains occupied","payload":["admissionId; actingUnitId must match the stay’s ward; role and now"],"scope":"Ward or coordinator; every caller supplies the admission ward claim. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Stay must exist and be occupied","Reject another ward, existing absence, or a stay recorded away at an ED"],"effects":["Updates an existing leave-bed record or creates one with expectedReturn=now; preserves existing leave details","Keeps the admission and bed occupancy; return is recorded separately through END_LEAVE_BED"],"sources":[{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":372,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":213,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1380,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-absence-and-cto.test.ts","tests/ward-away-from-ward-exclusive.test.ts"]},"reason":"Source-reviewed command model: Leave-bed record carries absentWithoutLeave {since,steps:[]}; stay remains occupied."},{"event":"RECORD_ABSENCE_STEP","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":214},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1349},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":424},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1881}],"status":"modelled","model":{"subject":"An existing absence without leave","before":"Absence has no record of this listed missing-person step","after":"Same absence with one timed step appended","payload":["admissionId; actingUnitId; step from ABSENCE_STEPS; role and now"],"scope":"Ward or coordinator; actingUnitId must equal the absence record’s unit. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["An absence record must exist for the admission","Step must be listed, not already recorded, and not earlier than absence.since"],"effects":["Appends {step,at} to absentWithoutLeave.steps; does not end absence, release a bed or contact anyone"],"sources":[{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":424,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":214,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1389,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-absence-and-cto.test.ts"]},"reason":"Source-reviewed command model: Same absence with one timed step appended."},{"event":"RECORD_COMMUNITY_TREATMENT_ORDER","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":215},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1359},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":155},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1882}],"status":"modelled","model":{"subject":"A patient’s recorded community treatment order","before":"Patient exists with no current order, no occupied stay and no open non-arrived placement","after":"Form 5A recorded with time and desk label; any ended order retained in earlier history","payload":["patientId; role and now; no user-supplied lapse time"],"scope":"Community or coordinator. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Reject missing patient or a current order without endedAt","Reject an occupied admission or open movement whose stage is not arrived; waitlisted/pulled stays alone do not block"],"effects":["Writes patient.communityTreatmentOrder; moves prior ended order and its earlier history into earlier","No automatic expiry, placement, legal-status change or bed move","The step can be taken back by UNDO_PATIENT_RECORD within the Undo window, filed against the patient record."],"sources":[{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":155,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":215,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1398,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-absence-and-cto.test.ts"]},"reason":"Source-reviewed command model: Form 5A recorded with time and desk label; any ended order retained in earlier history."},{"event":"END_COMMUNITY_TREATMENT_ORDER","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":216},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":669},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1782}],"status":"modelled","model":{"subject":"A patient’s current community treatment order","before":"Order exists and has no endedAt","after":"Same order retained with endedAt=now","payload":["patientId; role and now"],"scope":"Community or coordinator. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient and an unended order must exist; repeat ending is refused"],"effects":["Adds endedAt; retains the order and earlier history; no timer or automatic end","The step can be taken back by UNDO_PATIENT_RECORD within the Undo window, filed against the patient record."],"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":667,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":216,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1405,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-absence-and-cto.test.ts"]},"reason":"Source-reviewed command model: Same order retained with endedAt=now."},{"event":"RECORD_LEAVING","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":220},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1343},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":122},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1601}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_AWAY_AT_EMERGENCY_DEPARTMENT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":232},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1344},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":208},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1875}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_RETURNED_FROM_EMERGENCY_DEPARTMENT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":233},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1345},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":244},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1876}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_STAY_DISCHARGE_BLOCKER","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":236},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1346},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":264},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1877}],"status":"modelled","model":{"subject":"An occupied admission and its pending bed releases","before":"Occupied stay with no blocker or another recorded blocker","after":"Stay blockReason and linked nondischarged releases carry the chosen blocker","payload":["admissionId; actingUnitId; blocker from BED_RELEASE_BLOCKERS; role and now"],"scope":"Ward, site bed manager or coordinator; actingUnitId must equal admission.unitId. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Admission must exist, be occupied and match actingUnitId","blocker must be a nonempty member of BED_RELEASE_BLOCKERS"],"effects":["Replaces admission.blockReason","For all linked releases not discharged, updates blocker, blockedBy, blockerRecordedAt and confirmedAt; moves no capacity figure or bed state"],"sources":[{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":264,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":236,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1838,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-stay-discharge-blocker.test.ts"]},"reason":"Source-reviewed command model: Stay blockReason and linked nondischarged releases carry the chosen blocker."},{"event":"CLEAR_STAY_DISCHARGE_BLOCKER","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":237},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":249},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1773}],"status":"modelled","model":{"subject":"An admission’s current discharge blocker","before":"Admission carries a non-null blockReason","after":"Admission blockReason=null; clearance retained on matching pending release or admission","payload":["admissionId; actingUnitId; optional reason from DISCHARGE_DELAY_CLEAR_REASONS; role and now"],"scope":"Ward, site bed manager or coordinator; actingUnitId must equal admission.unitId. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Admission and a current blocker must exist","If reason supplied it must be listed; no default reason is invented"],"effects":["Clears the stay blocker","If a same-ward nondischarged release has the same blocker, clears its blocker/blockedBy and appends clearance history there; otherwise appends stayBlockClearances","Does not release the bed or change admission state"],"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":247,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":237,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1855,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-stay-discharge-blocker.test.ts"]},"reason":"Source-reviewed command model: Admission blockReason=null; clearance retained on matching pending release or admission."},{"event":"RECORD_OBSERVATION_LEVEL","roles":["ed","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":240},"sources":[{"path":"src/components/ward-management/ward-flow-observation-events.ts","line":33},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1900}],"status":"modelled","model":{"subject":"An open movement or occupied admission and its agreeing live counterpart","before":"Target has its recorded observation and retained change-count token","after":"Named target and any agreeing linked open counterpart carry the new observation and append from/to history","payload":["target is {kind:movement,movementId,actingUnitId?} or {kind:admission,admissionId,actingUnitId}","observation is a valid Observation; expected editing token required once the target has prior changes; role and now"],"scope":"EVENT_ROLE applies. Ward movement updates require its accepted ward; admission target requires its ward claim and refuses ED callers. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Valid observation; target exists; movement open or admission bed occupied","New value must differ; token must match and linked records must agree; missing token refused after first recorded change","Seeded links without matching observations stay unlinked rather than silently overwriting the other record","Accepted edits require a safe retained sequence allocator below Number.MAX_SAFE_INTEGER; exhaustion refuses before writing.","Accepted observation sequence is reducer-generated from retained movement/admission history, independent of the audit counter; restore permits missing legacy metadata or positive safe integers and refuses zero, fractions and unsafe values."],"effects":["Updates observation and appends {at,sequence,from,to} on each linked record","No new placement or capacity allocation; staffing eligibility remains a separate pull check","Accepted observation history entries also carry sequence=max(all retained movement/admission observation sequences,0)+1; an agreeing linked counterpart receives that same edit sequence. PATIENT_ARRIVED uses retained accepted order before legacy minute timestamps. Genuinely unordered legacy ties retain the previous fallback; no historical order is invented.","An accepted edit marks its audit decision accepted with no reason code."],"sources":[{"path":"src/components/ward-management/ward-flow-observation-events.ts","line":33,"sha256":"7e10fb51b2f76135bdfacbcd7643473e686dd0eb797e9e7906e427cdf26563cd"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":240,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-observation-events.ts","line":33,"sha256":"7e10fb51b2f76135bdfacbcd7643473e686dd0eb797e9e7906e427cdf26563cd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-observation.ts","line":48,"sha256":"b714525f0d4c6d18d050f9a3600f38c8de4e9a013595a77844c5c492fbdc2e3c"}],"tests":["tests/ward-observation-levels.test.ts","tests/ward-observation-expected-token.test.ts","tests/ward-audit-s2-observation-join.test.ts","tests/ward-consolidated-domain-20261104.test.ts"]},"reason":"Source-reviewed command model: Named target and any agreeing linked open counterpart carry the new observation and append from/to history."},{"event":"RECORD_MOVEMENT_BLOCKER","roles":["ed","community","ward","coordinator","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":280},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":710},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1874}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CLEAR_MOVEMENT_BLOCKER","roles":["ed","community","ward","coordinator","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":287},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2140}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"FLAG_MOVEMENT_TURNAROUND_PRIORITY","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":308},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2027}],"status":"modelled","model":{"subject":"A waiting movement’s receiving-unit preference","before":"Waiting unplaced movement with an open suitable ward request and current turnaround source","after":"Same movement carries {unitId,flaggedAt,source}; no bed is promised","payload":["movementId; unitId; optional source cld or departure; finite now; role"],"scope":"Coordinator only, within its shared authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Unit and target must exist; current source must be CLD-ready occupied criteria with feature enabled, or confirmed unblocked departure on an occupied stay","Clinical/legal gates must pass (allocation/freshness and the helper’s locked-bed security exception are separate); open request must match selected unit","Movement must be open, not arrived and unaccepted","Same unit/source preference already recorded is refused"],"effects":["Sets turnaroundPriority only; does not hold capacity, discharge anybody, accept a request or advance stage","Selectors later hide a preference whose original readiness source no longer qualifies"],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2017,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":308,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":692,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-turnaround-priority.ts","line":65,"sha256":"f4a062f776b7e676eb045bd32daf9aac4a636392dab5599a571687cbf47db4b8"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-cld-turnaround-priority.test.ts"]},"reason":"Source-reviewed command model: Same movement carries {unitId,flaggedAt,source}; no bed is promised."},{"event":"FLAG_REFERRAL_TURNAROUND_PRIORITY","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":309},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2028}],"status":"modelled","model":{"subject":"A waiting referral’s receiving-unit preference","before":"Waiting unplaced referral with an open suitable ward request and current turnaround source","after":"Same referral carries {unitId,flaggedAt,source}; no bed is promised","payload":["referralId; unitId; optional source cld or departure; finite now; role"],"scope":"Coordinator only, within its shared authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Unit and target must exist; current source must be CLD-ready occupied criteria with feature enabled, or confirmed unblocked departure on an occupied stay","Clinical/legal gates must pass (allocation/freshness and the helper’s locked-bed security exception are separate); open request must match selected unit","Referral must still be queued with an unwithdrawn ward request; no linked movement may exist","Same unit/source preference already recorded is refused"],"effects":["Sets turnaroundPriority only; does not hold capacity, discharge anybody, accept a request or advance stage","Selectors later hide a preference whose original readiness source no longer qualifies"],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2018,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":309,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":701,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-turnaround-priority.ts","line":65,"sha256":"f4a062f776b7e676eb045bd32daf9aac4a636392dab5599a571687cbf47db4b8"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-cld-turnaround-priority.test.ts"]},"reason":"Source-reviewed command model: Same referral carries {unitId,flaggedAt,source}; no bed is promised."},{"event":"MARK_REFERRAL_OPENED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":312},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1910},{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":17}],"status":"modelled","model":{"subject":"One addressed ward’s copy of a referral","before":"Ward copy exists without openedAt","after":"Same copy has openedAt=now; answer state unchanged","payload":["referralId; unitId; actingUnitId; role and now"],"scope":"Ward or coordinator; actingUnitId must equal unitId even for the coordinator. Named copy preferred, otherwise an unnamed ward copy. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Referral and an applicable ward copy must exist","Reject mismatched actingUnitId and a copy already stamped opened"],"effects":["Stamps openedAt once; does not answer, stop the decision clock or alter decidedAt"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":102,"sha256":"a7980fe9e58a4d1fcc774d48dfeb4e2673b66d0624fef24d00fae7b1fcf32039"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":312,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":716,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-referral-followup.test.ts"]},"reason":"Source-reviewed command model: Same copy has openedAt=now; answer state unchanged."},{"event":"REQUEST_REFERRAL_INFORMATION","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":313},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1911},{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":118}],"status":"modelled","model":{"subject":"One awaiting ward copy’s information checklist","before":"Ward copy queued and unwithdrawn","after":"New listed needs appended; existing open needs retained without duplication","payload":["referralId; unitId; needs is a nonempty list from REFERRAL_INFORMATION_NEEDS","actingUnitId optional in type but required for ward’s own-unit check; role and now"],"scope":"Ward for its own copy or coordinator; named copy preferred over unnamed. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Applicable ward copy must still await answer","Every need must be listed; at least one deduplicated need must not already be open"],"effects":["Appends {need,at,by} to informationNeeds; met historical needs can be requested again","No referral decision or decision-clock change"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":118,"sha256":"a7980fe9e58a4d1fcc774d48dfeb4e2673b66d0624fef24d00fae7b1fcf32039"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":313,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":729,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-referral-followup.test.ts"]},"reason":"Source-reviewed command model: New listed needs appended; existing open needs retained without duplication."},{"event":"MARK_REFERRAL_INFORMATION_MET","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":315},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1912},{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":55}],"status":"modelled","model":{"subject":"One information category requested by one or all current requesting wards","before":"At least one requested listed need remains unmet on a queued, unwithdrawn ward copy","after":"Selected open request(s) stamped metAt and metBy; checklist history retained","payload":["referralId; need from REFERRAL_INFORMATION_NEED_IDS","Exactly one target shape: wardUnitId string, or allRequestingWards:true; role and now"],"scope":"Sending ED/community/ward desk or coordinator. Ward requires referral.source=psychiatric_ward; shared boundary verifies the stored sender rather than destination ward identity. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Reject invalid/ambiguous target or off-list need","Named target requires awaiting copy and an unmet need; all-target needs at least one current matching request"],"effects":["Named target stamps its first unmet matching entry; all-target stamps matching unmet entries on every awaiting ward copy","Does not answer any ward or stop its decision clock"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-followup-events.ts","line":148,"sha256":"a7980fe9e58a4d1fcc774d48dfeb4e2673b66d0624fef24d00fae7b1fcf32039"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":315,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":740,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-referral-followup.test.ts","tests/ward-sender-information-supplied.test.ts"]},"reason":"Source-reviewed command model: Selected open request(s) stamped metAt and metBy; checklist history retained."},{"event":"ASSIGN_REFERRAL","roles":["coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":318},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1918},{"path":"src/components/ward-management/ward-flow-referral-owner-events.ts","line":21}],"status":"modelled","model":{"subject":"The desk chasing a front-door referral","before":"Referral not accepted or fully withdrawn; owner desk differs or is absent","after":"ownerHistory appended; its last owner is the current chasing desk","payload":["referralId; owner from REFERRAL_OWNER_DESKS; role and finite now"],"scope":"Coordinator may assign any listed owner desk; ED/community may take only for their own role. Not a lock on other permitted actions. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Referral must exist and not be accepted or fully withdrawn; the follow-up helper does not require a queued arm","Owner must be listed; reject another desk’s self-assignment and same current owner"],"effects":["Appends {owner,at,by}; destinations, answers and decision clock unchanged"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-owner-events.ts","line":44,"sha256":"13b724abff93f6ec86c6b232d9ea7f00e66609f8297122508a7976198f8ce19e"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":318,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":764,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/referrals/referral-owner-and-calls-model.ts","line":28,"sha256":"783d84f0aa1cc62b1f388bfabaa637c851ef47570a4ebfefc94406d550e4bde3"}],"tests":["tests/ward-referral-owner-and-calls.test.ts","tests/ward-referral-owner-and-calls-scope.test.ts"]},"reason":"Source-reviewed command model: ownerHistory appended; its last owner is the current chasing desk."},{"event":"LOG_REFERRAL_CONTACT","roles":["coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":319},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1919},{"path":"src/components/ward-management/ward-flow-referral-owner-events.ts","line":67}],"status":"modelled","model":{"subject":"A front-door referral’s call log","before":"Referral not accepted or fully withdrawn, with prior contact history or none","after":"New checked contact/outcome entry appended","payload":["referralId; contact is psychiatric_ward/unitId, community_team/teamId, or referrer","outcome from REFERRAL_CONTACT_OUTCOMES; role and finite now"],"scope":"Coordinator, ED or community, subject to record/place scope; contact names the called place, not acting authority. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Referral must exist and not be accepted or fully withdrawn; the follow-up helper does not require a queued arm","Contact kind and outcome must be listed; named ward/team must exist"],"effects":["Appends checked {contact,outcome,at,by}; drops unrecognised contact fields","A logged call does not decide referral or pause its decision clock"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-owner-events.ts","line":67,"sha256":"13b724abff93f6ec86c6b232d9ea7f00e66609f8297122508a7976198f8ce19e"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":319,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":779,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/referrals/referral-owner-and-calls-model.ts","line":28,"sha256":"783d84f0aa1cc62b1f388bfabaa637c851ef47570a4ebfefc94406d550e4bde3"}],"tests":["tests/ward-referral-owner-and-calls.test.ts"]},"reason":"Source-reviewed command model: New checked contact/outcome entry appended."},{"event":"RECORD_REFERRAL_COMMITMENT","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":321},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1926},{"path":"src/components/ward-management/ward-flow-referral-commitment-events.ts","line":24}],"status":"modelled","model":{"subject":"One awaiting ward copy’s response commitment","before":"Open referral awaiting this ward, commitment absent or not resolved","after":"Checked step/promise/callback entry appended without answering referral","payload":["referralId; unitId; actingUnitId for ward; role and finite now","step and/or nextCallbackAt required; promisedFor required only with step=promised","promisedFor and nextCallbackAt must be finite and at or after now"],"scope":"Coordinator records any listed step/callback; ward only its own acknowledged/promised step. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward and addressed, queued, unwithdrawn copy on open referral","Listed steps move forward; repeated response_requested and promised allowed; resolved blocks further entries","Ward cannot make callback-only entry; promise time refused on other steps"],"effects":["Appends commitment with unitId, at and desk label; keeps earlier entries","Does not change state, decidedAt, clocks or automatically call anyone"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-commitment-events.ts","line":24,"sha256":"a304422664462b4413fa82c9ae19d0425aef260d8ccf65239ca708d722b08994"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":321,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":796,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/referrals/referral-owner-and-calls-model.ts","line":28,"sha256":"783d84f0aa1cc62b1f388bfabaa637c851ef47570a4ebfefc94406d550e4bde3"},{"path":"src/components/ward-management/referrals/referral-commitments-model.ts","line":73,"sha256":"b8ad888efb64576aa225df86d86b58d9e31306fda7791fe9815a00a4c6c82325"}],"tests":["tests/ward-referral-commitments.test.ts"]},"reason":"Source-reviewed command model: Checked step/promise/callback entry appended without answering referral."},{"event":"ASK_MORE_WARDS","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":322},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1932},{"path":"src/components/ward-management/ward-flow-referral-ask-events.ts","line":24}],"status":"modelled","model":{"subject":"An open community referral’s addressed wards","before":"Open community referral has named ward request(s) with reusable bed requirements","after":"Additional named wards queued, preserving existing destinations","payload":["referralId; nonempty distinct unitIds named by coordinator; role and now"],"scope":"Coordinator only; no automatic ranking or suggestion. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Referral must be community source and not closed/withdrawn","Existing ward request must name a ward; any unnamed ward arm blocks expansion","Each new unit must exist, not have been asked before, be open and currently eligible","Awaiting existing wards plus additions must stay within parallelReferralCap"],"effects":["Copies original ward bed requirements into each new queued arm; stamps referredAt and addedBy","Does not answer existing arms, create a movement or reserve a bed"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-ask-events.ts","line":24,"sha256":"d3c249774b280ef5c1b57d1f4c7575d2dce9ef721ec1f85ed2ac2c53e7874d08"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":322,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-referral-ask-events.ts","line":24,"sha256":"d3c249774b280ef5c1b57d1f4c7575d2dce9ef721ec1f85ed2ac2c53e7874d08"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/referrals/referral-owner-and-calls-model.ts","line":28,"sha256":"783d84f0aa1cc62b1f388bfabaa637c851ef47570a4ebfefc94406d550e4bde3"}],"tests":["tests/ward-referral-ask-more-wards.test.ts"]},"reason":"Source-reviewed command model: Additional named wards queued, preserving existing destinations."},{"event":"CLOSE_WARD_TO_ADMISSIONS","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":325},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1939},{"path":"src/components/ward-management/ward-flow-ward-closure-events.ts","line":17}],"status":"modelled","model":{"subject":"A ward’s admissions closure","before":"Known ward open to admissions","after":"isClosed=true with admissionsClosure reason/time/desk and optional expected reopening","payload":["unitId; reason from WARD_CLOSURE_REASONS; optional until","actingUnitId for ward; role and now"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Ward must exist and not already be closed","Listed reason; supplied until later than now and no farther than largest WARD_REOPEN_AFTER_HOURS choice"],"effects":["Writes closure record; existing holds/acceptances and bed figures remain","Eligibility/shortlists refuse new admissions; until is a prompt, never automatic reopening"],"sources":[{"path":"src/components/ward-management/ward-flow-ward-closure-events.ts","line":44,"sha256":"2fd18c518e21b86c1cda4b425c6cf5163251b409d3cddffd1f8a3b225f5142ef"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":325,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":815,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-closure.test.ts"]},"reason":"Source-reviewed command model: isClosed=true with admissionsClosure reason/time/desk and optional expected reopening."},{"event":"REOPEN_WARD_TO_ADMISSIONS","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":326},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1940},{"path":"src/components/ward-management/ward-flow-ward-closure-events.ts","line":72}],"status":"modelled","model":{"subject":"A ward’s admissions closure","before":"Known ward marked closed","after":"isClosed=false; admissionsClosure removed","payload":["unitId; actingUnitId for ward; role and now"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Ward must exist and be closed"],"effects":["Removes closure record rather than advancing any waiting move; changes no bed count","Reopening is a person’s action; old closure-linked review/transition records are no longer current"],"sources":[{"path":"src/components/ward-management/ward-flow-ward-closure-events.ts","line":72,"sha256":"2fd18c518e21b86c1cda4b425c6cf5163251b409d3cddffd1f8a3b225f5142ef"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":326,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":826,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-closure.test.ts","tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: isClosed=false; admissionsClosure removed."},{"event":"SET_BED_CLOSED","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":328},"sources":[{"path":"src/components/ward-management/ward-flow-bed-closure-events.ts","line":24},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1943}],"status":"modelled","model":{"subject":"One exact numbered bed’s closure mark","before":"Empty offerable bed is open, or numbered bed has active closed mark","after":"closed=true appends a mark; closed=false stamps active mark reopenedAt","payload":["unitId; actingUnitId; integer bedNumber within 1..unit.beds; closed boolean","Optional listed reason when closing; no reason when reopening; role and now"],"scope":"Ward, site bed manager or coordinator; actingUnitId must equal unitId. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Closing rejects already-closed, occupied/replayed seat, pulled/held bed, or no Ready capacity","Reopening requires an active mark and refuses any supplied reason"],"effects":["Records exact numbered mark and retains reopening history; does not rewrite allocatable confirmation","Derived Ready excludes active closed marks and recovers after reopen; existing stay seating retained"],"sources":[{"path":"src/components/ward-management/ward-flow-bed-closure-events.ts","line":56,"sha256":"e19afdf5df97f09582af829f62e2ff463cbf9ef8ba8e2b873e79ea7e7931497f"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":328,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":834,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-bed-closed-mark.test.ts","tests/ward-bed-closed-mark-kinds.test.ts"]},"reason":"Source-reviewed command model: closed=true appends a mark; closed=false stamps active mark reopenedAt."},{"event":"RECORD_BED_MEETING_ACTION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":333},"sources":[{"path":"src/components/ward-management/ward-flow-bed-meeting-events.ts","line":30},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1977}],"status":"modelled","model":{"subject":"A movement or admission’s agreed meeting task","before":"Subject exists and has no open action of this kind","after":"meetingActions appended with chosen task, owner and due time","payload":["subject {kind:movement|admission,id}; action from BED_MEETING_ACTION_KINDS","owner from BED_MEETING_ACTION_OWNERS; known unitId required for ward owner; dueAt later than now; role and now"],"scope":"Coordinator chair only; owner names a role, not a person. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Subject exists; action/owner listed; ward owner must name known ward","Reject dueAt not later than now or an existing open same-kind action"],"effects":["Appends task with recordedAt; does not change patient stage, occupancy or placement","No automatic execution when due","Before a new occurrence reuses its stable meeting inbox id, append returned snooze and released ownership boundaries where prior histories exist. Even a same-minute replacement starts without the preceding occurrence owner/snooze; histories are retained and the new occurrence may be claimed/snoozed again."],"sources":[{"path":"src/components/ward-management/ward-flow-bed-meeting-events.ts","line":61,"sha256":"b28604a0b11e841e1daf151279719831992a89765e8553a84974993d57ed5e2c"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":333,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":850,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-bed-meeting-actions.test.ts","tests/ward-consolidated-meeting-counts-20261104.test.ts"]},"reason":"Source-reviewed command model: meetingActions appended with chosen task, owner and due time."},{"event":"COMPLETE_BED_MEETING_ACTION","roles":["coordinator","ward","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":334},"sources":[{"path":"src/components/ward-management/ward-flow-bed-meeting-events.ts","line":105},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1978}],"status":"modelled","model":{"subject":"An open task on a movement or admission","before":"Chosen subject carries an open action of this kind","after":"Same action stamped doneAt and doneBy","payload":["subject {kind:movement|admission,id}; listed action; actingUnitId for ward owner; role and now"],"scope":"Coordinator or owning ward/ED/community role; ward must match ownerUnitId. Site bed manager denied by EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Subject and open listed action must exist","Caller must be coordinator or correct owning role/place"],"effects":["Retains task and stamps completion; does not enact the action or change subject’s stage"],"sources":[{"path":"src/components/ward-management/ward-flow-bed-meeting-events.ts","line":105,"sha256":"b28604a0b11e841e1daf151279719831992a89765e8553a84974993d57ed5e2c"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":334,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":865,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-bed-meeting-actions.test.ts","tests/ward-bed-manager-actions.test.ts","tests/ward-consolidated-meeting-counts-20261104.test.ts"]},"reason":"Source-reviewed command model: Same action stamped doneAt and doneBy."},{"event":"RECORD_RESTRICTIVE_PRACTICE_START","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":338},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1950},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":61}],"status":"modelled","model":{"subject":"A ward’s operational restrictive-practice episodes","before":"Occupied stay on this ward with no open same-practice episode","after":"New episode with typed start and recording metadata appended","payload":["unitId; admissionId; practice from RESTRICTIVE_PRACTICE_IDS; startedAt","actingUnitId for ward; role and now; typed time finite and within last 24h, not future"],"scope":"Ward for itself or coordinator; site bed manager cannot record episodes. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward, occupied admission belonging to it, listed practice","Reject invalid typed time and duplicate open practice for same stay"],"effects":["Appends Unit.restrictivePractice.episodes with generated id, startedAt, recordedAt and desk label","No legal limit or order computed; no occupancy change; separate departure guards require open episodes ended"],"sources":[{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":61,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":338,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/restrictive-practice/ward-restrictive-practice.ts","line":136,"sha256":"c605b305700a3df7cb0e8f7f1f923ac844971e33743d4227b677773e9ec056aa"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-restrictive-practice.test.ts","tests/ward-audit-s3-restrictive-practice-departure.test.ts"]},"reason":"Source-reviewed command model: New episode with typed start and recording metadata appended."},{"event":"RECORD_RESTRICTIVE_PRACTICE_END","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":339},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1951},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":95}],"status":"modelled","model":{"subject":"One ward’s open restrictive-practice episode","before":"Episode exists without endedAt","after":"Same episode stamped with typed endedAt","payload":["unitId; episodeId; endedAt; actingUnitId for ward; role and now","endedAt finite, within last 24h, not future or before startedAt"],"scope":"Ward for itself or coordinator; site bed manager cannot end episodes. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward and open episode","Reject invalid/before-start typed time or already-ended episode; current admission occupancy is not required"],"effects":["Sets endedAt on episode and retains its start/recording metadata","No patient transfer, bed move or legal decision performed"],"sources":[{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":95,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":339,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/restrictive-practice/ward-restrictive-practice.ts","line":147,"sha256":"c605b305700a3df7cb0e8f7f1f923ac844971e33743d4227b677773e9ec056aa"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-restrictive-practice.test.ts"]},"reason":"Source-reviewed command model: Same episode stamped with typed endedAt."},{"event":"RECORD_RESTRICTIVE_PRACTICE_FOLLOW_UP","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":341},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1952},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":109}],"status":"modelled","model":{"subject":"One restrictive-practice episode on a ward","before":"Episode ended, with its follow-up tasks marked so far","after":"The chosen follow-up task marked done or cleared","payload":["unitId; episodeId; task from RESTRICTIVE_PRACTICE_FOLLOW_UP_TASKS; done (boolean); now; role."],"scope":"ward or coordinator in the role table; authenticated reference scope applies.","guards":["The episode exists on the ward.","The episode has an end time recorded.","task is a listed follow-up task and done is a boolean."],"effects":["Sets or removes the task in the episode's followUp; an empty followUp is removed."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1942,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":109,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"}],"tests":["tests/ward-legal-form-gap-items.test.ts"]},"reason":"Reviewed command model: marks or clears one follow-up task on an ended restrictive-practice episode."},{"event":"RECORD_WARD_INCIDENT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":342},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1953},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":131}],"status":"modelled","model":{"subject":"A ward’s operational incident list","before":"Known ward with existing or empty incident history","after":"New category/time incident appended","payload":["unitId; category from WARD_INCIDENT_CATEGORY_IDS; at finite within last24h and not future","actingUnitId for ward; role and now; no patient id or narrative"],"scope":"Ward for itself or coordinator; site bed manager cannot record incidents. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward, listed category and valid typed time"],"effects":["Appends ward incident id/category/at/recordedAt/recordedBy","No patient, bed, stay or legal record changes; detailed incident report remains outside this app"],"sources":[{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":131,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":342,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/restrictive-practice/ward-restrictive-practice.ts","line":160,"sha256":"c605b305700a3df7cb0e8f7f1f923ac844971e33743d4227b677773e9ec056aa"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-restrictive-practice.test.ts"]},"reason":"Source-reviewed command model: New category/time incident appended."},{"event":"SET_SECLUSION_ROOM_STATUS","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":343},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1954},{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":152}],"status":"modelled","model":{"subject":"A ward’s recorded seclusion-room availability","before":"Room status absent or different","after":"seclusionRoom replaced with status, time and desk label","payload":["unitId; status from SECLUSION_ROOM_STATUS_IDS; actingUnitId for ward; role and now"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known ward; listed status; repeat identical status refused"],"effects":["Writes only Unit.restrictivePractice.seclusionRoom","Does not start/end an episode or alter beds; selectors show an open seclusion episode as in use over the recorded availability"],"sources":[{"path":"src/components/ward-management/ward-flow-restrictive-practice-events.ts","line":152,"sha256":"5e2f0d1e4b5e3a3415d5114400ba622bb5e83a84787491e7a93f4f5a3c7f935b"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":343,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/restrictive-practice/ward-restrictive-practice.ts","line":184,"sha256":"c605b305700a3df7cb0e8f7f1f923ac844971e33743d4227b677773e9ec056aa"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-restrictive-practice.test.ts"]},"reason":"Source-reviewed command model: seclusionRoom replaced with status, time and desk label."},{"event":"MARK_CANCELLED_MOVE_CHECK","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":347},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":58},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1965}],"status":"modelled","model":{"subject":"A cancelled move’s follow-up checklist","before":"Move is cancelled, with prior mark or no mark for selected item","after":"Selected item’s mark replaced with addressed/not_applicable and time/desk","payload":["movementId; item from CANCELLED_MOVE_CHECK_ITEMS; mark from CANCELLED_MOVE_CHECK_MARKS","actingUnitId for ward; role and now"],"scope":"Coordinator or ward that accepted this move. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Movement exists and is cancelled; item/mark listed","Cannot mark pulled_bed addressed while cancelled move still holds a bed"],"effects":["Keeps one current mark per item; does not release beds, cancel transport or change movement stage"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":58,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":347,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":225,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: Selected item’s mark replaced with addressed/not_applicable and time/desk."},{"event":"RECORD_ACCEPTANCE_CONDITION","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":348},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":79},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1966}],"status":"modelled","model":{"subject":"A standing acceptance’s operational conditions","before":"Open accepted move without this current condition","after":"New condition appended tied to acceptedUnitId and acceptedAt","payload":["movementId; condition from ACCEPTANCE_CONDITION_KINDS; agreedWith from its list","readyAt required only for bed_after_time: later than now and within largest ACCEPTANCE_BED_AFTER_HOURS choice","actingUnitId for ward; role and now"],"scope":"Coordinator or the accepting ward. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Movement must exist, be open and accepted","Reject duplicate current condition, off-list values, missing/out-of-range bed-after time or time on another condition"],"effects":["Appends condition and agreement provenance; does not hold a bed, change stage or modify eligibility","Times prompt review; no automatic condition completion"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":79,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":348,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":239,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: New condition appended tied to acceptedUnitId and acceptedAt."},{"event":"MARK_ACCEPTANCE_CONDITION_MET","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":349},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":80},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1967}],"status":"modelled","model":{"subject":"A current acceptance’s unmet condition","before":"Open accepted move has this current condition not met","after":"Condition retained with met {at,by}","payload":["movementId; listed condition; actingUnitId for ward; role and now"],"scope":"Coordinator or the accepting ward. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Movement open and accepted; selected current condition exists and is not already met"],"effects":["Stamps met on that exact condition; leaves stage, placement, capacity and acceptance unchanged"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":80,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":349,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":250,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: Condition retained with met {at,by}."},{"event":"RECORD_RESTRICTION_REVIEW","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":350},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":139},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1968}],"status":"modelled","model":{"subject":"A ward’s active restriction review reminder","before":"Restriction currently active, with prior review or none","after":"One current review for restriction recorded/replaced","payload":["unitId; restriction from WARD_RESTRICTION_KINDS; reviewer from RESTRICTION_REVIEWER_ROLES","expectedAt later than now and within largest RESTRICTION_REVIEW_AFTER_HOURS choice; actingUnitId for ward; role and now"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Ward exists and named restriction is currently active; listed restriction/reviewer","Review time must be later than now and bounded by listed choices"],"effects":["Replaces review for same restriction, preserving others; closure review captures closure.startedAt","Does not lift restriction or reopen ward when time passes"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":139,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":350,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":262,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: One current review for restriction recorded/replaced."},{"event":"MARK_CLOSURE_TRANSITION_ITEM","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":351},"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":169},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1969}],"status":"modelled","model":{"subject":"A closed ward’s current handover checklist","before":"Ward has admissionsClosure and selected still-pointing record is unmarked","after":"Closure transitionMarks appended with current derived item and recording metadata","payload":["unitId; item from CLOSURE_TRANSITION_ITEM_KINDS; actingUnitId for ward; role and now","Record id: referralId for referral, plannedAdmissionId for booked_arrival, movementId for other listed item kinds"],"scope":"Ward for itself, site bed manager or coordinator within authorised scope. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Ward must exist, be closed and carry admissionsClosure","Item must still point at the ward according to closureTransitionItems and must not already be marked"],"effects":["Appends derived item with at/by to current closure; does not move, cancel, reassign or release the underlying record"],"sources":[{"path":"src/components/ward-management/ward-flow-loop-check-events.ts","line":169,"sha256":"ff8c33075771176af7fe4b39fee199eb3da5c97591401997d25b0455b83f5868"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":351,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/loop-checks/ward-loop-checks.ts","line":276,"sha256":"67b1b35eaafcde31aa39f6d2f2e7a73aa9ae18859d17dd777426ba9a78404921"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-loop-checks.test.ts"]},"reason":"Source-reviewed command model: Closure transitionMarks appended with current derived item and recording metadata."},{"event":"FLAG_MOVEMENT_URGENT","roles":["coordinator","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":352},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2080}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CLEAR_MOVEMENT_URGENT_FLAG","roles":["coordinator","ed"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":353},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2104}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"WITHDRAW_REFERRAL","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":373},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1856},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":883}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REQUEST_CAPACITY_REFRESH","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":376},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":684},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1783}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECEIVE_REFERRAL","roles":["community","ed","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":391},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1904},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":362}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ADD_PATIENT","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":395},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1792},{"path":"src/components/ward-management/ward-patient-registration-reducer.ts","line":39}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ARCHIVE_PATIENT","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":397},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1794},{"path":"src/components/ward-management/ward-patient-archive-reducer.ts","line":10}],"status":"modelled","model":{"subject":"An erroneous standalone patient registration","before":"Patient has only registration fields and no care records/references elsewhere","after":"Patient removed from active patients list; audit event and sequence retained","payload":["patientId; reason from PATIENT_ARCHIVE_REASONS (duplicate, test, wrong_person); role and now"],"scope":"Coordinator only, with shared record scope applied. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; listed archive reason","Registration facts include the optional typed details (preferred name, address, GP, catchment team, interpreter language, Indigenous status, and the ADMIN_DETAIL_FIELDS administrative details); refuse any non-registration fact or any state/audit care reference; prior archive-attempt audit entries do not block"],"effects":["Filters patient from patients; keeps sequence so id is not reused","Reducer audit wrapper retains the archive event/reason; no care record is removed","The step can be taken back by UNDO_PATIENT_RECORD within the Undo window."],"sources":[{"path":"src/components/ward-management/ward-patient-archive-reducer.ts","line":10,"sha256":"bfd91bd2e7955ee0c776cf1c8e5fb3ecb1dd76d2cd0d2c9a71a9789270b95898"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":397,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-archive.ts","line":30,"sha256":"2738c8d1a80a5d8fc418865719058ee2603141bb9493d55954cae83742455eb3"},{"path":"src/components/ward-management/ward-patient-archive.ts","line":44,"sha256":"2738c8d1a80a5d8fc418865719058ee2603141bb9493d55954cae83742455eb3"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-patient-archive.test.ts"]},"reason":"Source-reviewed command model: Patient removed from active patients list; audit event and sequence retained."},{"event":"ACCEPT_REFERRAL","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":427},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":873},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":728}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"HOLD_REFERRAL_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":428},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1906},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":695}],"status":"modelled","model":{"subject":"An accepted ward arm’s exact numbered bed hold","before":"Current accepted, unwithdrawn ward arm without started bed journey; old numbered hold may exist","after":"Same arm carries chosen heldBedNumber","payload":["referralId; unitId; actingUnitId; bedNumber; role and now"],"scope":"Ward for its own beds or coordinator; shared place/record boundary also applies. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known referral and currently accepted arm for unit; no linked movement or pulled/occupied/departed referral stay","Ward open; numbered bed valid, free, unheld and of required kind","Recheck current suitability using only override already recorded at acceptance"],"effects":["Sets/reassigns arm.heldBedNumber; retains acceptance author/time and referral state","Does not mint movement/admission or overwrite allocatable confirmation; hold is considered by bed availability checks"],"sources":[{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":680,"sha256":"aa1c1e1bdf49c3e38ce3ca99d5e92e542e0d2956c43b9befa32e6915def5d7dc"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":428,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-flow-events.ts","line":1538,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-review-engine-regressions.test.ts","tests/ward-override-surfaces.test.ts"]},"reason":"Source-reviewed command model: Same arm carries chosen heldBedNumber."},{"event":"DECLINE_REFERRAL","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":439},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1907},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1148}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LOCAL_BED_SOUGHT","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":445},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1045},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1884}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_REFERRER_WITHDRAWAL","roles":["coordinator","community","ed","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":477},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":801},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1883}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ADD_REFERRAL_CORRECTION","roles":["community","ed","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":484},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1858},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1124}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"STEP_BACK_STAGE","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":491},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":751},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1993}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"WITHDRAW_ACCEPTANCE","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":492},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1908},{"path":"src/components/ward-management/ward-flow-referral-answer-events.ts","line":1308}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"WITHDRAW_WARD_REQUEST","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":495},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1857},{"path":"src/components/ward-management/ward-flow-referral-send-events.ts","line":1069}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"MARK_NOTICE_READ","roles":["coordinator","ed","ward","officer","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":505},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2189},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":290}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ACKNOWLEDGE_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":526},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2190},{"path":"src/components/ward-management/ward-inbox-events.ts","line":41},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":312}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"COMPLETE_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":527},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2191},{"path":"src/components/ward-management/ward-inbox-events.ts","line":71},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":349}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REOPEN_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":528},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2192},{"path":"src/components/ward-management/ward-inbox-events.ts","line":99},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":384}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"TAKE_INBOX_ITEM_OWNERSHIP","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":530},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2193},{"path":"src/components/ward-management/ward-inbox-events.ts","line":111},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":402}],"status":"modelled","model":{"subject":"A coordinator inbox row and its occurrence-specific history","before":"Real current inbox row not already owned by this desk","after":"Ownership history appended; current owner is acting role’s label","payload":["inboxItemId trimmed before lookup; role and now"],"scope":"Coordinator role only; shared authenticated scope must also permit the row’s subject. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. Scoped state projection retains this metadata for permitted meeting-action subjects by parsing the encoded subject id; metadata for other subjects stays excluded.","guards":["Row must exist; same current owner for this occurrence refused"],"effects":["Appends {at,by} to inboxOwnership; underlying row/fact and its visibility unchanged"],"sources":[{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":402,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":530,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-events.ts","line":111,"sha256":"c3c63fd47887f9bbabdefc8aa6b6742f72848bc9f744afa55b2aa7efd80f037c"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-inbox-snooze.ts","line":84,"sha256":"eda403a5e8fbf768036d873898501882422dad29ebc3c7362c7766a10daaf1dd"}],"tests":["tests/ward-inbox-snooze.test.ts","tests/ward-consolidated-census-20261104.test.ts"]},"reason":"Source-reviewed command model: Ownership history appended; current owner is acting role’s label."},{"event":"RELEASE_INBOX_ITEM_OWNERSHIP","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":531},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2194},{"path":"src/components/ward-management/ward-inbox-events.ts","line":121},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":422}],"status":"modelled","model":{"subject":"A coordinator inbox row and its occurrence-specific history","before":"Ownership history’s current entry belongs to acting role, applying a current-row start when available","after":"Ownership history appended with kind=released; ownership relinquished","payload":["inboxItemId trimmed before lookup; role and now"],"scope":"Coordinator role only; shared authenticated scope must also permit the row’s subject. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. Scoped state projection retains this metadata for permitted meeting-action subjects by parsing the encoded subject id; metadata for other subjects stays excluded.","guards":["Current owner must match acting role after filtering entries older than the row’s current occurrence, if a start is available; this branch does not independently require row existence"],"effects":["Appends released history entry; does not delete prior ownership, resolve fact or hide row"],"sources":[{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":422,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":531,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-events.ts","line":121,"sha256":"c3c63fd47887f9bbabdefc8aa6b6742f72848bc9f744afa55b2aa7efd80f037c"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-inbox-snooze.ts","line":84,"sha256":"eda403a5e8fbf768036d873898501882422dad29ebc3c7362c7766a10daaf1dd"}],"tests":["tests/ward-inbox-snooze.test.ts","tests/ward-alerts-release-ownership.dom.test.tsx","tests/ward-consolidated-census-20261104.test.ts"]},"reason":"Source-reviewed command model: Ownership history appended with kind=released; ownership relinquished."},{"event":"SNOOZE_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":532},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2195},{"path":"src/components/ward-management/ward-inbox-events.ts","line":133},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":435}],"status":"modelled","model":{"subject":"A coordinator inbox row and its occurrence-specific history","before":"Real current inbox row visible or previously snoozed","after":"Latest snoozed entry hides row until chosen return time while fact remains","payload":["inboxItemId; reason from SNOOZE_REASON_IDS; finite until after now; role and now"],"scope":"Coordinator role only; shared authenticated scope must also permit the row’s subject. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. Scoped state projection retains this metadata for permitted meeting-action subjects by parsing the encoded subject id; metadata for other subjects stays excluded.","guards":["Real row and listed reason","until within SNOOZE_MAX_MINUTES (currently24h); act-now row limited by RED_ROW_SNOOZE_CAP_MINUTES (currently60min)"],"effects":["Appends {kind:snoozed,at,by,until,reason}; no mutation of underlying patient/unit fact","Current-occurrence selectors return row when until passes or a newer occurrence starts"],"sources":[{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":435,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":532,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-events.ts","line":133,"sha256":"c3c63fd47887f9bbabdefc8aa6b6742f72848bc9f744afa55b2aa7efd80f037c"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-inbox-snooze.ts","line":84,"sha256":"eda403a5e8fbf768036d873898501882422dad29ebc3c7362c7766a10daaf1dd"}],"tests":["tests/ward-inbox-snooze.test.ts","tests/ward-consolidated-census-20261104.test.ts"]},"reason":"Source-reviewed command model: Latest snoozed entry hides row until chosen return time while fact remains."},{"event":"UNSNOOZE_INBOX_ITEM","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":533},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2196},{"path":"src/components/ward-management/ward-inbox-events.ts","line":142},{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":469}],"status":"modelled","model":{"subject":"A coordinator inbox row and its occurrence-specific history","before":"History has an active snooze, applying a current-row start when available","after":"Snooze history appended with kind=returned; active snooze ends now","payload":["inboxItemId trimmed before lookup; role and now"],"scope":"Coordinator role only; shared authenticated scope must also permit the row’s subject. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. Scoped state projection retains this metadata for permitted meeting-action subjects by parsing the encoded subject id; metadata for other subjects stays excluded.","guards":["Active snooze must exist after occurrence filtering; expired or older-occurrence entry refused; this branch does not independently require row existence"],"effects":["Appends returned entry, retaining earlier history; an underlying row, if still present, returns to the active list without resolving its fact"],"sources":[{"path":"src/components/ward-management/ward-inbox-reducer.ts","line":469,"sha256":"4a7dde821d15d7032a38cb18333ed34872d78fb28e4be6efb382ad5e9095c81d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":533,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-inbox-events.ts","line":142,"sha256":"c3c63fd47887f9bbabdefc8aa6b6742f72848bc9f744afa55b2aa7efd80f037c"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-inbox-snooze.ts","line":84,"sha256":"eda403a5e8fbf768036d873898501882422dad29ebc3c7362c7766a10daaf1dd"}],"tests":["tests/ward-inbox-snooze.test.ts","tests/ward-consolidated-census-20261104.test.ts"]},"reason":"Source-reviewed command model: Snooze history appended with kind=returned; active snooze ends now."},{"event":"SET_ARRIVAL_DETAILS","roles":["coordinator","ed","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":534},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2005},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1170}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_STEP_DOWN_CANDIDATE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":535},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":704},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1784}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_WARD_DIAGNOSIS","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":537},"sources":[{"path":"src/components/ward-management/ward-flow-diagnosis-events.ts","line":14},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2358}],"status":"modelled","model":{"subject":"One current admission","before":"No ward diagnosis, or a different ward diagnosis block","after":"Latest ward diagnosis block with recording time and desk","payload":["admissionId; block from TentativeDiagnosisBlock; now and role; actingUnitId when acting as ward."],"scope":"ward or coordinator. A ward must name the admission's own unit; authenticated scoped access must also permit the admission.","guards":["Admission exists and is not departed.","Block is listed and differs from the current ward block."],"effects":["Replaces admission.wardDiagnosis only; does not overwrite the referrer's tentativeDiagnosis or move a bed."],"sources":[{"path":"src/components/ward-management/ward-flow-diagnosis-events.ts","line":29,"sha256":"c0c3188726823be6157098eb593cf59300372f9328512b293328cd76d8a16e4a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":537,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-ward-diagnosis.test.ts"]},"reason":"Reviewed command model: Latest ward diagnosis block with recording time and desk."},{"event":"MARK_WEEKEND_DISCHARGE_REVIEWED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":539},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2360},{"path":"src/components/ward-management/ward-flow-weekend-review-events.ts","line":15}],"status":"modelled","model":{"subject":"One current inpatient admission","before":"No review tick for this weekend","after":"Weekend discharge review tick with weekend, time and desk","payload":["admissionId; weekendStart instant; now and role; actingUnitId when acting as ward."],"scope":"ward or coordinator. A ward must name the admission's own unit; authenticated scoped access must also permit the admission.","guards":["Admission exists and is pulled or occupied.","Weekend is within a week of now and not already ticked."],"effects":["Appends to admission.weekendDischargeReviews only; changes no date, bed or plan."],"sources":[{"path":"src/components/ward-management/ward-flow-weekend-review-events.ts","line":23,"sha256":"1360db583261541d85f5978b485e46777413053f2ab988012b22b8aac4280ab2"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":539,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-weekend-discharge-review.test.ts"]},"reason":"Reviewed command model: Weekend discharge review tick with weekend, time and desk."},{"event":"SET_DISCHARGE_BARRIER","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":540},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":727},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1785}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_CLINICALLY_READY","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":542},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":757},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1786}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SET_DISCHARGE_CRITERIA","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":543},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":800},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1787}],"status":"modelled","model":{"subject":"An occupied admission's criteria-led discharge record","before":"Unset, current, paused or lapsed criteria","after":"Criteria set/reviewed, cleared, or one stored criterion ticked/unticked","payload":["admissionId; criteria string[] or null; met string[]; setByTreatingPsychiatrist boolean; optional patientSpecific string[] or tick {criterion,met}; actingUnitId for ward; finite now."],"scope":"ward or coordinator, with ward actingUnitId equal to the stay's unit and authenticated admission scope.","guards":["Admission must be occupied and time finite.","For setting or ticking criteria, only recorded voluntary patients are eligible; involuntary, CTO and unknown legal status refuse. criteria:null clears before this eligibility check.","Setting/changing the list needs the treating-psychiatrist flag; an ordinary tick keeps the stored list and refuses a lapsed review. Clearing with criteria:null does not require that flag.","Listed criteria must be unique and valid; patient-specific items obey count/length/trim bounds; ticks must name stored criteria."],"effects":["Writes admission.dischargeCriteria; review resets its validity time and review-bound/lapsed ticks, while retained applicable ticks persist.","No departure, bed release or clinical eligibility decision is performed; typed patient-specific payloads follow the typed-text persistence boundary."],"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":753,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-discharge-criteria.ts","line":271,"sha256":"70e720fb09a6a8bd9ab6952b29e786e949b7c635b3eded6a97c9be8582648c5b"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2114,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-criteria-led-discharge.test.ts"]},"reason":"Reviewed command model: Criteria set/reviewed, cleared, or one stored criterion ticked/unticked."},{"event":"RECORD_ED_MEDICAL_DETERIORATION","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":544},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1165},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1887}],"status":"modelled","model":{"subject":"An accepted originating-ED movement before collection","before":"Accepted/pulled pre-transfer placement with optional live transport","after":"placement_requested, medically uncleared and explicitly paused; acceptance and reservation removed","payload":["movementId; actingPlaceId naming the originating ED; finite now not before movement.openedAt; role."],"scope":"ed or coordinator; actingPlaceId must equal movement.originEdId even for coordinator. A source-admission transfer cannot use this path; authenticated movement/place scope also applies.","guards":["Movement exists, has an accepted psychiatric destination and is not closed, moving or already collected.","An unrecovered deterioration already recorded refuses; any held admission must be a consistent pulled reservation."],"effects":["Releases pulled bed/admission and matching referral bed hold; clears acceptance, pull timer, admission linkage and ward request lists.","Cancels live transport, records withdrawal/release/cancellation unwind history, false medical clearance and deterioration stamp.","Copies negative clearance to the identity-matching referral and appends an acceptance-withdrawn notice to the former ward. A later re-clearance does not reallocate a bed."],"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1165,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2134,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-medical-deterioration-ui.dom.test.tsx","tests/ward-reservation-release-capacity.test.ts"]},"reason":"Reviewed command model: placement_requested, medically uncleared and explicitly paused; acceptance and reservation removed."},{"event":"RECORD_MOVEMENT_MEDICAL_CLEARANCE","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":545},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1271},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1888}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"UPLOAD_PATIENT_FORM","roles":["coordinator","ed","ward","community","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":546},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":818},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1788}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_WRITTEN","roles":["ed","coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":548},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1360},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":275},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1889}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_CODE","roles":["ed","coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":550},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1361},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":274},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1890}],"status":"modelled","model":{"subject":"A movement's current legal-form record","before":"Current form, or no form recorded","after":"Chosen form code without an invented written time","payload":["movementId; recognised formCode; now; role. No writtenAt, region, ageBand or paperExpiresAt is carried by this command."],"scope":"ed, coordinator or ward. Ward requires an admitted stay in its own scoped unit; ED cannot amend a closed movement. An admitted ward/coordinator may record a later form despite arrival closure.","guards":["Movement exists; ward has an admitted stay.","Form code is recognised, differs from the current code, and is not 3C after 3D.","A closed record refuses except admitted non-ED recording."],"effects":["Replaces legalForm code/kind with its retained form history, removes formedAt, prior paper expiry/receipt for a different form and legacy legalClock.","Does not calculate legal expiry or default the written time. Undo is part of UNDO_LEGAL_FORM_RECORD.","A new form code also clears the typed receipt mark and any paper details typed for the old form."],"sources":[{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":274,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2168,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":832,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-ed-handover-events.test.ts"]},"reason":"Reviewed command model: Chosen form code without an invented written time."},{"event":"RECORD_ED_PRESENTATION","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":552},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1362},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":205},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1891}],"status":"modelled","model":{"subject":"An open movement's ED presentation choices","before":"Recorded ED presentation list or none","after":"Canonical fixed-list choices, or field removed for an empty selection","payload":["movementId; presentations array of EdPresentation choices; now; role."],"scope":"ed or coordinator, additionally subject to authenticated movement/place scope.","guards":["Movement exists and has no closure.","presentations must be an array and every item must be in the fixed ED list."],"effects":["Filters choices into canonical list order, deduplicating them; empty choice removes edPresentations.","Does not change movement stage, diagnosis, legal status or capacity. Included in ED-step Undo."],"sources":[{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":205,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2194,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-undo.ts","line":92,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-ed-handover-events.test.ts"]},"reason":"Reviewed command model: Canonical fixed-list choices, or field removed for an empty selection."},{"event":"RECORD_LEGAL_FORM_DETAILS","roles":["ed","coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":554},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1363},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":222},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1892}],"status":"modelled","model":{"subject":"The current legal form on one movement","before":"Form recorded, details as last typed","after":"Form carries the typed maker, copy given, ending, consent and review-by values","payload":["movementId; formCode; optional madeBy, copyGiven, endedBy, consent, reviewBy (omitted keeps, null clears); now; role."],"scope":"ed, coordinator or ward in the role table; a ward only for a person admitted to its own bed.","guards":["The movement exists; a closed movement only when admitted and not ED.","formCode matches the movement's current form.","Each detail is from its list; reviewBy is a finite time; consent only for a Form 6B."],"effects":["Replaces the form's details with the merged values; other form fields are unchanged."],"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":96,"sha256":"901a830650fc830bfa41e4351b15fcea7e71bf475cc389ac2ece99fe698c4e06"},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":222,"sha256":"00105e89a350aa48ec39ce66907880bb7863bbc4cff2f4f31fc02ba659f1c6d9"}],"tests":["tests/ward-legal-form-gap-items.test.ts"]},"reason":"Reviewed command model: records the written legal form's typed details on the movement's current form."},{"event":"RECORD_COUNTRY_EXTENSION","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":555},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1364},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":382},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1893}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_LEGAL_FORM_CONTINUATION","roles":["ed","coordinator","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":556},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1365},{"path":"src/components/ward-management/ward-flow-record-legal-events.ts","line":415},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1894}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"EVALUATE_ARRIVAL_LATENESS","roles":["coordinator","ed","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":557},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2006},{"path":"src/components/ward-management/ward-flow-transport-events.ts","line":1260}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RELEASE_AND_REOPEN_SEARCH","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":558},"sources":[{"path":"src/components/ward-management/ward-flow-placement-events.ts","line":813},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1994}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CLEAR_EXPECT_FLAG","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":559},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2202}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"REQUEST_PSYCH_REVIEW","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":561},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2216},{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":16}],"status":"modelled","model":{"subject":"One open movement","before":"No psychReview recorded","after":"psychReview.requestedAt = now","payload":["movementId","role and now"],"scope":"ED or coordinator (EVENT_ROLE); shared command scope checks the movement as for other movement commands.","guards":["Movement must exist and not be closed","Refused when a review is already asked for"],"effects":["Writes psychReview.requestedAt only; the ED Awaiting review list keeps its order","Undone by UNDO_ED_STEP"],"sources":[{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":61,"sha256":"c8c07485713088517586cb0556d07e0a8ac812413934ba064f12d412b00936f4"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2213,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":561,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-psych-review-ready-next.test.ts","tests/ward-event-permissions.test.ts"]},"reason":"Reviewed command model (9 Nov 2026): the emergency department records that a psychiatric review was asked for; a time only, nothing ordered or scored."},{"event":"RECORD_PSYCH_REVIEW_SEEN","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":562},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2217},{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":23}],"status":"modelled","model":{"subject":"One open movement with a review asked for","before":"psychReview without the named grade seen","after":"psychReview.registrarSeenAt or consultantSeenAt = now","payload":["movementId; grade registrar or consultant","role and now"],"scope":"ED or coordinator (EVENT_ROLE); shared command scope checks the movement.","guards":["Movement must exist and not be closed","Grade from PSYCH_REVIEW_GRADES","A review must have been asked for; each grade recorded once"],"effects":["Writes the seen time only; no examination, placement or order follows","Undone by UNDO_ED_STEP"],"sources":[{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":69,"sha256":"c8c07485713088517586cb0556d07e0a8ac812413934ba064f12d412b00936f4"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2214,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":562,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-psych-review-ready-next.test.ts","tests/ward-event-permissions.test.ts"]},"reason":"Reviewed command model (9 Nov 2026): records that the registrar or consultant saw the person for the review asked for; a time only."},{"event":"MARK_WARD_READY_FOR_NEXT","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":563},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2218},{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":31}],"status":"modelled","model":{"subject":"One ward","before":"readyForNextAt absent (or present, for cancel)","after":"Unit.readyForNextAt = now, or removed on cancel","payload":["unitId; optional cancel","actingUnitId for ward; role and now"],"scope":"Ward for itself or coordinator (EVENT_ROLE); shared command scope checks the unit.","guards":["Ward acts only for itself","Unit must exist","Mark refused when closed to admissions or already marked; cancel refused when not marked"],"effects":["Coordinator Home shows the ward and the first on its wait list as a fact; nothing is pulled","A PULL_PATIENT into the ward clears the mark"],"sources":[{"path":"src/components/ward-management/ward-flow-review-ready-events.ts","line":84,"sha256":"c8c07485713088517586cb0556d07e0a8ac812413934ba064f12d412b00936f4"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2215,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":563,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-psych-review-ready-next.test.ts","tests/ward-event-permissions.test.ts"]},"reason":"Reviewed command model (9 Nov 2026): a ward says it is ready for its next patient, or cancels that; a fact for the coordinator, who still pulls by hand."},{"event":"RAISE_EXPECT_FLAG","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":564},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2227}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"FLAG_LEGAL_MISMATCH","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":565},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2249}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"EVALUATE_LEAVE_BED_WARNINGS","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":566},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":862},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1789}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"CONFIRM_MORNING_ROLLUP","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":567},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2272}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"SEND_WARD_BUZZ","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":568},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2303}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_REPATRIATION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":570},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1351},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":478},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1896}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_HOME_SERVICE_RETURN","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":572},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2365}],"status":"modelled","model":{"subject":"One current stay's home-service return discussion","before":"No request, a request without agreement, or an earlier recorded answer","after":"Fresh requested record, or request with agreed/not_yet_agreed/declined answer","payload":["admissionId; step requested|answered; homeHospital required for request; answer required for answered; optional prerequisites from RETURN_PREREQUISITES and finite nextReviewAt; now; role."],"scope":"coordinator only; authenticated scope must permit the admission. A valid home site need not itself be the current admission site.","guards":["Admission exists and is not departed; optional review date finite.","Request names a site in the current scenario. Answer requires an existing request and a listed answer.","Prerequisites are listed; a declined answer cannot carry agreed prerequisites."],"effects":["Latest record per stay; fresh request clears earlier answer/prerequisites. Answer retains request and appends answer time/desk, with prerequisites unique in listed order.","Records a discussion only: does not book transport or a bed, raise a return movement or change the stay."],"sources":[{"path":"src/components/ward-management/out-of-area/home-service-return.ts","line":122,"sha256":"2f3fbdc6ba3e36b6eb890a51a7707e8b26f71eba4a803181220c17c63d1249d7"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2351,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":570,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-home-service-return.test.ts"]},"reason":"Reviewed command model: Fresh requested record, or request with agreed/not_yet_agreed/declined answer."},{"event":"FLAG_RETURN_EARLY","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":574},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2370}],"status":"modelled","model":{"subject":"One current out-of-area stay","before":"No early-return flag on the stay","after":"An early-return flag naming the home hospital, time and role","payload":["admissionId; homeHospital (listed site code); now; role."],"scope":"coordinator in the role table.","guards":["The stay exists and has not departed.","homeHospital is a listed site.","The stay is not already flagged."],"effects":["Appends a returnEarlyFlags record; the home ward site, community and officer desks see an alert while the stay is current."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":410,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/out-of-area/return-early.ts","line":70,"sha256":"28c9ec25e8d1fc5808db7af91d11f76ce64b235c292fdddfa60d1423ac2eedb3"}],"tests":["tests/ward-return-early.test.ts"]},"reason":"Reviewed command model: the coordinator flags an out-of-area stay as ready to return early to a home hospital."},{"event":"RECORD_DIRECTORY_CHECK","roles":["coordinator","bed_manager","ward","ed","community","officer"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":576},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2367}],"status":"modelled","model":{"subject":"An on-call directory entry identifier","before":"Seeded check metadata or a previously recorded check","after":"Latest {entryId, at, by} check for that identifier","payload":["entryId matching the 1–80 character slug pattern; now; role."],"scope":"coordinator, bed_manager, ward, ed, community or officer. This reducer validates identifier shape, not membership in the seeded directory; authenticated access remains separate.","guards":["entryId must be a string matching the directory-entry slug grammar."],"effects":["Replaces the latest check for the same identifier while retaining checks for other identifiers; audit records successive checks.","Does not change the directory's phone/contact data or verify it against an external service."],"sources":[{"path":"src/components/ward-management/on-call/on-call-checks.ts","line":40,"sha256":"4c75385ac14339cbc7d98efc18af52257bb6ae185011b80e244fcf21f6d68e9d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":574,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2386,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"}],"tests":["tests/ward-on-call-checks.test.ts"]},"reason":"Reviewed command model: Latest {entryId, at, by} check for that identifier."},{"event":"RECORD_HANDOVER_SIGN_OFF","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":579},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1350},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":457},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1895}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"RECORD_SITE_HANDOVER_SIGN_OFF","roles":["bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":583},"sources":[{"path":"src/components/ward-management/site-sign-off/site-handover-sign-off-reducer.ts","line":28},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2373}],"status":"modelled","model":{"subject":"One site and upcoming shift handover","before":"No sign-off for this site/shift","after":"Site sign-off with a snapshot of unsigned wards and unanswered bed calls","payload":["siteCode; integer finite shiftAt at a configured shift start; now; role."],"scope":"bed_manager for its own site or whole-network coordinator. A service coordinator is refused by authenticated command scope; signing does not sign any ward's sheet.","guards":["Site has at least one ward.","shiftAt is the next handover in the one-shift sign-off window.","Site/shift has not already been signed. Open checks do not block signing."],"effects":["Appends siteHandoverSignOffs with at/by/siteCode/shiftAt and reducer-derived unsignedUnitIds/unansweredBedCallIds.","Leaves ward sign-offs and bed calls open and unchanged. Creates the site-specific step Undo."],"sources":[{"path":"src/components/ward-management/site-sign-off/site-handover-sign-off-reducer.ts","line":26,"sha256":"dc671972ed160a7492f79cde72ca6dab6dad70b59921bd378ecee4721b326db5"},{"path":"src/components/ward-management/site-sign-off/site-handover-sign-off.ts","line":80,"sha256":"abebadfb3e48655f6e362172ed644ae06615e26916f33334ce17419955567a33"},{"path":"src/components/ward-management/ward-access-state.ts","line":687,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":581,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-site-handover-sign-off.test.ts","tests/ward-handover-site-sign-off.dom.test.tsx"]},"reason":"Reviewed command model: Site sign-off with a snapshot of unsigned wards and unanswered bed calls."},{"event":"RECORD_TRIAGE_SIGNED","roles":["ed","community","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":587},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2379}],"status":"modelled","model":{"subject":"One person on this workspace","before":"No signed triage, or earlier signed triages, on the person","after":"One more signed triage record on the person: time, desk role and closed-list codes","payload":["patientId; now; role; urgency (A to G); outcome (listed); legal (listed code); review (listed code); flags (RAMP factor keys marked present); problems and actions (webPSOLIS list codes, in the order chosen); venue and referralType (webPSOLIS list code or null)."],"scope":"ed, community, ward and coordinator in the role table, the same desks as RAISE_REFERRAL; a shared desk is sent a record only with a person it is sent.","guards":["The person exists on this workspace.","Urgency is one of A to G.","Outcome, legal status and review are each from their fixed lists.","Every flag is a RAMP factor key; unknown fields are dropped.","Problems and actions are arrays of at most 60 codes from their webPSOLIS lists (kept once each, in the order chosen); venue and referral type are null or a code from their list. Typed text is refused."],"effects":["Appends a triages record (codes only); the patient record's Now tab lists it. No Undo: it is a signed record. Typed text (assessment, mental state, formulation, plan) stays in the form and is never in the event."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2378,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/triage/triage-signed-reducer.ts","line":46,"sha256":"88ebffb9dc86dd544d9bdac7f561fcf4998a3af62d9a19ffe4211c5325142666"},{"path":"src/components/ward-management/ward-access-state.ts","line":329,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-triage-signed.test.ts","tests/ward-event-permissions.test.ts"]},"reason":"Reviewed command model (7 Nov 2026): a clinician signs a mental health triage and risk assessment (SMHMR900 and SMHMR905) for one person; closed-list codes only, never typed text."},{"event":"REQUEST_WARD_STAFF","roles":["ward","coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":591},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2375}],"status":"modelled","model":{"subject":"A ward's staff request for this shift or next shift","before":"Known ward; no open request for that ward and shift, or one to update","after":"staffRequests holds one open request for the ward and shift with count and ordered reasons","payload":["unitId; shift this or next; count 1, 2, 3 or 4 or more","reasons: one or more distinct items from STAFF_REQUEST_REASONS; actingUnitId for ward callers; role and now"],"scope":"Ward, coordinator or site bed manager in EVENT_ROLE; a ward acts only for its own ward (actingUnitId must equal unitId). Executive changes nothing (D-80). Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Known unit; shift and count from their lists","Reject empty, duplicate or unlisted reasons, and a ward naming another ward"],"effects":["Appends a record, or updates count, reasons and updatedAt on the open one; never names a patient","Does not change beds, placement, movements or any patient stage"],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2375,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/staffing/staff-requests.ts","line":132,"sha256":"d3e51d13faedefa5314d5f128c59473110a61bae075bd5ddb362788d5ae479f3"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":591,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-staff-requests.test.ts"]},"reason":"Source-reviewed command model: one open staff request per ward per shift, added or updated in place."},{"event":"CLOSE_WARD_STAFF_REQUEST","roles":["ward","coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":592},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2376}],"status":"modelled","model":{"subject":"An open staff request on a ward","before":"Request exists on the named ward and is still open","after":"Request carries closedAt, closedBy and outcome","payload":["requestId and unitId; outcome from STAFF_REQUEST_OUTCOMES","actingUnitId for ward callers; role and now"],"scope":"Ward, coordinator or site bed manager in EVENT_ROLE; a ward acts only for its own ward (actingUnitId must equal unitId). Executive changes nothing (D-80). Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority. A ward may only withdraw; the coordinator or bed manager records any other outcome.","guards":["Request found on that ward and open; outcome listed","Reject a ward recording an outcome other than withdrawn"],"effects":["Closes the one record; open lists and alerts drop it","Does not change beds, placement, movements or any patient stage"],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2376,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/staffing/staff-requests.ts","line":171,"sha256":"d3e51d13faedefa5314d5f128c59473110a61bae075bd5ddb362788d5ae479f3"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":592,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-staff-requests.test.ts"]},"reason":"Source-reviewed command model: an open staff request closed as arranged, not available or withdrawn."},{"event":"RECORD_CLINICAL_CONTACT","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":596},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1352},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":664},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1897}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"DISPATCH_BROADCAST_ALERT","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":600},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":69},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2328}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"ACKNOWLEDGE_BROADCAST_ALERT","roles":["coordinator","ward","ed","officer","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":601},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":151},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2329}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"STAND_DOWN_BROADCAST_ALERT","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":602},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":198},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2330}],"status":"diagram-reviewed","reason":"Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance."},{"event":"EXTEND_BROADCAST_ALERT","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":603},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":228},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2331}],"status":"modelled","model":{"subject":"An active broadcast alert","before":"Active alert with current expiry/duration","after":"Same active alert with expiry and duration each extended by the fixed default","payload":["alertId; now; role. Added duration is DEFAULT_BROADCAST_EXTENSION_MINUTES, not client text or a client-selected number."],"scope":"coordinator or bed_manager. A scoped actor must control every recipient of the existing alert, not merely see one recipient.","guards":["Alert exists and is active at now; stood-down or expired alerts cannot be revived by extension."],"effects":["Adds 30 minutes (current default) to stored durationMinutes and to existing expiresAt; preserves recipients, replies and acknowledgements."],"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":228,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":461,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2395,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":708,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-top25-broadcast-extend.dom.test.tsx"]},"reason":"Reviewed command model: Same active alert with expiry and duration each extended by the fixed default."},{"event":"ADD_BROADCAST_ALERT_UNITS","roles":["coordinator","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":604},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":243},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2332}],"status":"modelled","model":{"subject":"An active directive or bed call's recipients","before":"Existing recipient scope/list","after":"Existing recipients plus new unique named desks","payload":["alertId; non-empty unitIds array naming real desks; now; role."],"scope":"coordinator or bed_manager. Authenticated scope must cover the existing alert's full recipient set and every newly added desk.","guards":["Alert exists and is active; Pull now cannot add recipients.","Bed calls accept real wards only; directives may also name real ED desks.","At least one named desk has not already been asked."],"effects":["Resolves previous scope into an explicit targetUnitIds list, appends only new ids and recomputes targetScopeLabel.","Does not reset expiry or clear previous replies/acknowledgements."],"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":243,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2394,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":708,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-broadcast-add-units.test.ts"]},"reason":"Reviewed command model: Existing recipients plus new unique named desks."},{"event":"RAISE_PULL_NOW","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":608},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":293},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2333}],"status":"modelled","model":{"subject":"A waiting movement and a new patient-specific broadcast","before":"Waiting open movement with wards considering/accepting it, no live Pull now","after":"Same movement plus active Pull now addressed to the relevant wards","payload":["movementId; now; role. Recipients, text, severity, deadlines and id are generated from state/constants."],"scope":"coordinator only; authenticated scope must permit the movement and every ward selected by pullNowWards.","guards":["Movement exists, is open and in PULL_NOW_LIVE_STAGES.","No currently live still-applicable Pull now exists for this movement.","At least one real relevant ward can be asked."],"effects":["Prepends an active critical pull_now alert, increments broadcastSequence and records answerBy/expiry and movement stage-change count at dispatch.","Recipients are accepting ward, else real referred wards. Does not itself pull a bed, move the patient or change movement stage."],"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":293,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/alerts/ward-broadcast-model.ts","line":317,"sha256":"b27896e799de72fbb71c7782bc2a571627809762c61a40dcecb86b07007ca647"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2416,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":729,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-global-alerts.test.ts"]},"reason":"Reviewed command model: Same movement plus active Pull now addressed to the relevant wards."},{"event":"REPLY_BROADCAST_ALERT","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":610},"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":348},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2334}],"status":"modelled","model":{"subject":"One desk's answer to a bed call or Pull now","before":"Active applicable alert with no answer or a different latest answer for this desk","after":"Reply appended; desk also acknowledged","payload":["alertId; real unitId; answer from this alert kind's fixed list; optional beds, readyAt or reason as required by answer; now; role."],"scope":"ward, bed_manager or coordinator, with authenticated place/record scope. A bed call accepts wards only; Pull now accepts only its target wards.","guards":["Alert exists and is active; Pull now's movement must still be waiting; directives use acknowledgement instead.","Unit is real and included when recipients are explicit; answer belongs to kind-specific list.","can_take needs whole beds in 1..BED_CALL_MAX_BEDS; after_discharge/bed_ready_at needs finite future readyAt within the configured horizon; Pull now cannot needs a listed decline reason.","An identical latest answer is refused."],"effects":["Appends reply {unitId,answer,at,role,...conditional detail}; adds desk to acknowledgedUnits once.","Answers are reported capacity statements, not bed allocation or automatic movement transitions."],"sources":[{"path":"src/components/ward-management/alerts/ward-broadcast-reducer.ts","line":348,"sha256":"cd46a2fc3599a4dbc092b05eda177f7da454de1cd8642597fa17bf3281a11907"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2415,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-global-alerts.test.ts","tests/ward-broadcast-audience-bed-call-wards.test.ts"]},"reason":"Reviewed command model: Reply appended; desk also acknowledged."},{"event":"BOOK_PLANNED_ADMISSION","roles":["coordinator","bed_manager","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":613},"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":78},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2340}],"status":"modelled","model":{"subject":"A future planned admission","before":"No booking for this linked patient, or an initials-only booking to create","after":"New PA-* record in booked state, holding no bed","payload":["Exactly one of patientId or initials; sex; ageBand; reason; unitId; expectedArrivalAt; expectedStayDays; legalStatus; now/role. Optional gender, overrideReason, actingUnitId. Linked patient requires calendarDate for age validation."],"scope":"coordinator, bed_manager or ward; ward may book its own ward only. Authenticated place/record scope additionally applies.","guards":["Finite now and arrival, listed reason/legal status/gender and bounded whole expectedStayDays; destination unit exists.","Arrival must fall within the configured booking window; a newly chosen arrival cannot be in the past.","Ward caller must name its actingUnitId and all affected wards must be that unit.","Admission authorisation gate needs a listed override reason when applicable; other placement gates are rechecked on conversion.","Ward must be open to new admissions. Sex and ageBand are listed.","Linked patient exists, has no occupied/pulled bed or existing booked planned admission; recorded birth date matches cohort on arrival date. Initials-only requires 1–3 letters; the panel names digits and more than three letters separately, while blank initials get the generic \"Initials are one to three letters.\" line; a direct event with neither patient nor initials is rejected by the patient-or-initials guard."],"effects":["Appends a booked plan and increments plannedAdmissionSequence; linked gender comes from patient record, never event.","Stores a required same-ward authorisation override. No bed count or admission changes until conversion; initials invoke the typed-text persistence boundary."],"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":334,"sha256":"d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"},{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":298,"sha256":"d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2431,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-planned-admissions.test.ts","tests/ward-audit24-1-planned-booking-authorised.test.ts"]},"reason":"Reviewed command model: New PA-* record in booked state, holding no bed."},{"event":"CHANGE_PLANNED_ADMISSION","roles":["coordinator","bed_manager","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":614},"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":423},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2345}],"status":"modelled","model":{"subject":"An existing booked planned admission","before":"booked plan with current ward/date/stay/reason/legal status/gender","after":"Still booked, with revised fields, changedAt and incremented changeCount","payload":["plannedAdmissionId; replacement reason/unitId/expectedArrivalAt/expectedStayDays/legalStatus; now/role. Optional gender, overrideReason, actingUnitId; calendarDate when a linked arrival changes calendar day."],"scope":"coordinator, bed_manager or ward; a ward may change neither from nor to another ward. Authenticated record and destination scope also applies.","guards":["Finite now and arrival, listed reason/legal status/gender and bounded whole expectedStayDays; destination unit exists.","Arrival must fall within the configured booking window; a newly chosen arrival cannot be in the past.","Ward caller must name its actingUnitId and all affected wards must be that unit.","Admission authorisation gate needs a listed override reason when applicable; other placement gates are rechecked on conversion.","Plan exists and remains booked.","Changing to a different closed ward refuses; an existing booking at a newly closed ward may remain there.","An overdue booking may retain its old arrival time while other fields change; moving a linked arrival date must still match its recorded cohort.","Authorisation override may persist for the same standing ward/gate; moving away drops an irrelevant override."],"effects":["Replaces planning fields, records changedAt/count and record-derived linked gender. No bed is held or released."],"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":418,"sha256":"d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"},{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":298,"sha256":"d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2488,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-planned-admissions.test.ts","tests/ward-audit24-1-planned-booking-authorised.test.ts"]},"reason":"Reviewed command model: Still booked, with revised fields, changedAt and incremented changeCount."},{"event":"CANCEL_PLANNED_ADMISSION","roles":["coordinator","bed_manager","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":615},"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":499},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2350}],"status":"modelled","model":{"subject":"One booked planned admission","before":"booked","after":"cancelled with cancel reason and time","payload":["plannedAdmissionId; unitId equal to booking's ward; listed cancellation reason; finite now; role; actingUnitId when ward."],"scope":"coordinator, bed_manager or ward, with own-ward identity for ward and authenticated booking scope.","guards":["Booking exists and state is booked.","Reason is listed; unitId matches booking; ward scope matches; now finite."],"effects":["Retains the booking record, changing state/cancelledAt/cancelReason.","No capacity refund occurs because booking held no bed. Cancelled plans no longer count as pending arrivals.","The step can be taken back by UNDO_RELEASE_STEP within the Undo window, filed against the booking."],"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":494,"sha256":"d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2488,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-planned-admissions.test.ts"]},"reason":"Reviewed command model: cancelled with cancel reason and time."},{"event":"CONVERT_PLANNED_ADMISSION","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":616},"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":523},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":743}],"status":"modelled","model":{"subject":"A booked plan and its receiving ward","before":"booked plan, no current linked bed/journey, ready eligible capacity","after":"Plan arrived and linked to a new occupied admission","payload":["plannedAdmissionId; unitId equal to booking's ward; finite now; role; actingUnitId for ward."],"scope":"ward or coordinator only; ward must name its own booked ward. Authenticated booking/ward scope additionally applies.","guards":["Plan exists and is booked; unit matches and is open. Linked patient has neither another held/occupied bed nor an open movement.","A Ready bed exists (pulledBedAvailability, counting live pulled admissions) and, when beds are pending preparation, more Ready beds than pending ones. Secure request requires a free locked bed. Other journeys' pending numbered reservations at the ward come off Ready and off the free locked and open counts first.","Current placement eligibility gates pass; only a recorded same-ward authorisation override waives that specific gate.","A gender-placement review requirement refuses this shortcut; use referral journey instead."],"effects":["Creates an occupied AD-ARR-* admission with recorded patient/sex/gender/planned legal status, without a movement/referral; increments admissionSequence.","Decrements ward empty and allocatable counts by one, locked count when used, and increments sex mix.","Marks plan arrived with convertedAt/admissionId; does not create a numbered bed assignment or admit merely because its date passed."],"sources":[{"path":"src/components/ward-management/capacity/planned-admissions-reducer.ts","line":518,"sha256":"d91a5be952e2110e25d304edcac7c17bede49897d9115701033cc8be1e0c61df"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2516,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-planned-admissions.test.ts","tests/ward-planned-arrival-closed-bed.test.ts"]},"reason":"Reviewed command model: Plan arrived and linked to a new occupied admission."},{"event":"RECORD_SUPPORT_NOTIFICATION","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":619},"sources":[{"path":"src/components/ward-management/ward-flow-record-events.ts","line":1353},{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":676},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1898}],"status":"modelled","model":{"subject":"One completed involuntary arrival/transfer or discharge, and one support party","before":"No or earlier checklist Tell record","after":"Another told/not_applicable record appended","payload":["occasion admission|transfer|discharge; party from checklist; outcome told|not_applicable; now/role. Arrival/transfer names movementId only; discharge admissionId only. told needs nonblank bounded who and optional contactedAt\u003c=now; not_applicable needs nonblank bounded reason and forbids who/contactedAt."],"scope":"ward or coordinator. Authenticated arriving movement must belong to its accepted ward scope; admission references and acting place are separately scoped.","guards":["now finite; occasion/party/outcome listed.","Named subject exists and meets completed involuntary arrival/transfer/discharge eligibility; arrival occasion matches recorded source.","Conditional text fields obey exclusive shape and length/time rules."],"effects":["Appends uniquely numbered SN-* record with subject/occasion/party/desk/time and outcome detail; creates step Undo.","Advisory recording only: neither calculates legal duties/deadlines nor blocks or advances the journey. Typed who/reason invokes typed-text persistence boundary."],"sources":[{"path":"src/components/ward-management/ward-flow-record-stay-events.ts","line":671,"sha256":"76f41e705f685062ecbfc8024544a4d50b5097cc1f9f68d9ad34976cbf9e4621"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2519,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":887,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-support-notifications.test.ts","tests/ward-discharge-support-notification.test.ts"]},"reason":"Reviewed command model: Another told/not_applicable record appended."},{"event":"SEND_RELEASE_SUPPORT_NOTICE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":620},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1956},{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":29}],"status":"modelled","model":{"subject":"One confirmed bed release and a support service","before":"confirmed release with no Sent record for chosen service","after":"confirmed release with service marked Sent","payload":["releaseId; service from SUPPORT_SERVICE_TYPES; actingUnitId required and equal to release.unitId; now; role."],"scope":"ward or coordinator; actingUnitId must equal the release's ward even for coordinator, and authenticated scope also applies.","guards":["Release exists and remains confirmed.","Service is listed and has not already been notified.","Acting unit is the release's own unit."],"effects":["Appends {service,at,by} to supportNoticesSent.","This prototype writes the record; no external pharmacy, transport or cleaning integration is invoked by this handler. No bed/stage change."],"sources":[{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":52,"sha256":"057ef764a841f671c0fac813c4f9485a121ca811c1228b7fec3b7abdbd94d5fd"},{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":28,"sha256":"057ef764a841f671c0fac813c4f9485a121ca811c1228b7fec3b7abdbd94d5fd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-release-notices.test.ts"]},"reason":"Reviewed command model: confirmed release with service marked Sent."},{"event":"RECORD_DISCHARGE_DEPENDENCY","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":622},"sources":[{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":34},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1959}],"status":"modelled","model":{"subject":"One non-discharged bed release and one logistics kind","before":"Missing or existing dependency for this kind","after":"Latest outstanding/done/not_needed state and owner recorded","payload":["releaseId; actingUnitId equal to release ward; kind/owner/state from closed lists; now; role."],"scope":"ward or coordinator, requiring release's own actingUnitId and authenticated release scope.","guards":["Release exists and is not discharged.","Kind, owner and state are listed.","Repeating the same already-outstanding owner/state refuses; done/not_needed can be reconfirmed."],"effects":["Adds or replaces the dependency by kind, recording time and desk label.","Does not alter release stage, blocker, bed counts, or call an external service."],"sources":[{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":60,"sha256":"dc256c1d387ba227491f407b6f56c3692ba3478fd4bd96dc95a5bb5b45e7e9dd"},{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":78,"sha256":"dc256c1d387ba227491f407b6f56c3692ba3478fd4bd96dc95a5bb5b45e7e9dd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-discharge-dependencies.test.ts"]},"reason":"Reviewed command model: Latest outstanding/done/not_needed state and owner recorded."},{"event":"RECORD_DISCHARGE_PLAN_CHANGE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":623},"sources":[{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":49},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1960}],"status":"modelled","model":{"subject":"One non-discharged bed release's logistics plan","before":"Current expected time or planned destination","after":"One changed fact, with recorded change history where applicable","payload":["releaseId; actingUnitId equal to release ward; exactly one of finite expectedAt or listed leavingDestination; now; role."],"scope":"ward or coordinator, requiring release's own actingUnitId and authenticated release scope.","guards":["Release exists and is not discharged.","Exactly one fact is carried and it differs from the current recorded fact.","Date is finite; destination is in LEAVING_DESTINATIONS."],"effects":["Date branch updates BedRelease.expectedAt and appends planChanges; destination branch writes plannedDestination and appends a change only if a prior destination existed.","Done dependencies relying on a changed fact can be shown as needing recheck by selectors. Handler does not itself cancel logistics, change release stage or bed counts.","A date change on a release linked to a stay that has not departed also updates that stay's expected discharge date, date-move count and set-by (updateExpectedDischargeDate), and the stay's other pending releases."],"sources":[{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":101,"sha256":"dc256c1d387ba227491f407b6f56c3692ba3478fd4bd96dc95a5bb5b45e7e9dd"},{"path":"src/components/ward-management/discharges/discharge-dependency-events.ts","line":49,"sha256":"dc256c1d387ba227491f407b6f56c3692ba3478fd4bd96dc95a5bb5b45e7e9dd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-discharge-dependencies.test.ts"]},"reason":"Reviewed command model: One changed fact, with recorded change history where applicable."},{"event":"RECORD_DISCHARGE_CHECK","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":625},"sources":[{"path":"src/components/ward-management/discharges/discharge-check-events.ts","line":37},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2361}],"status":"modelled","model":{"subject":"One stay with a bed (not waitlisted) and one checklist item","before":"Item not ticked, or ticked with a different state","after":"One discharge checklist item recorded as done, not needed or outstanding","payload":["admissionId; item and state from closed lists; now and role; actingUnitId when acting as ward."],"scope":"ward or coordinator. A ward must name the admission's own unit.","guards":["Admission exists and is not waitlisted.","Item and state are listed, and the state differs from the item's current ticked state."],"effects":["Sets admission.dischargeChecks[item] with time and desk role.","Advisory only: never blocks RECORD_LEAVING or RECORD_PATIENT_DISCHARGE and changes no release or bed figure."],"sources":[{"path":"src/components/ward-management/discharges/discharge-check-events.ts","line":60,"sha256":"584c52430b354fe68ebf1f0504c424400f28a32eb8f081f08ffb27a7016896d1"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":625,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-discharge-follow-through.test.ts"]},"reason":"Reviewed command model: One discharge checklist item recorded as done, not needed or outstanding."},{"event":"RECORD_FOLLOW_UP_REPLY","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":627},"sources":[{"path":"src/components/ward-management/discharges/discharge-check-events.ts","line":51},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":2362}],"status":"modelled","model":{"subject":"One stay with a bed (not waitlisted) referred to the acting community team","before":"No reply, or a different reply or decline reason","after":"The community team's follow-up reply recorded, with a listed reason when declined","payload":["admissionId; reply from awaiting/accepted/declined; declineReason from a closed list only with declined; now and role; actingTeamId when acting as a community team."],"scope":"community or coordinator. A community desk must name a known team the admission's referral named.","guards":["Admission exists and is not waitlisted.","A community desk names its team, and the stay belongs to that team.","Reply is listed; a decline carries a listed reason and nothing else does; the same reply is not recorded twice."],"effects":["Sets admission.followUpReply with time and desk role; the ward reads it on the discharge board and checklist.","Does not change the ward's followUp record, the care journey, any release or bed figure."],"sources":[{"path":"src/components/ward-management/discharges/discharge-check-events.ts","line":60,"sha256":"584c52430b354fe68ebf1f0504c424400f28a32eb8f081f08ffb27a7016896d1"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":627,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}],"tests":["tests/ward-discharge-follow-through.test.ts"]},"reason":"Reviewed command model: The community team's follow-up reply recorded, with a listed reason when declined."},{"event":"RECORD_ARRIVAL_CHECK","roles":["ed","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":628},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1962},{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":44}],"status":"modelled","model":{"subject":"An open movement's pre-transfer checklist flag","before":"Contraband-search or medication-chart flag false/unrecorded or true","after":"Chosen flag set to the opposite recorded boolean","payload":["movementId; check from ARRIVAL_CHECKS; done boolean; now; role."],"scope":"ed or coordinator; authenticated movement/place scope additionally applies.","guards":["Movement exists and has no closure.","Check is listed and done is boolean.","Unrecorded counts as false; trying to record the same effective value refuses."],"effects":["Writes contrabandSearchDone or medicationChartDone only. false takes a mistaken tick back.","Does not itself certify a clinical assessment, create a notice or advance stage."],"sources":[{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":91,"sha256":"057ef764a841f671c0fac813c4f9485a121ca811c1228b7fec3b7abdbd94d5fd"},{"path":"src/components/ward-management/ward-flow-release-notice-events.ts","line":43,"sha256":"057ef764a841f671c0fac813c4f9485a121ca811c1228b7fec3b7abdbd94d5fd"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-release-notices.test.ts","tests/ward-top25-admission-checklist.dom.test.tsx"]},"reason":"Reviewed command model: Chosen flag set to the opposite recorded boolean."},{"event":"UNDO_REFERRAL_DECISION","roles":["ward","coordinator","ed","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":632},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1752},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":98}],"status":"modelled","model":{"subject":"The latest accepted/declined decision snapshot on a referral","before":"Referral exactly as the latest undoable decision left it","after":"Referral restored to its pre-decision snapshot","payload":["referralId; now; role; optional recordSeq to bind the exact decision; actingUnitId when ward."],"scope":"ward, coordinator, ed or community in role table, then original acting role (and ward) or coordinator; authenticated reference scope applies.","guards":["Referral and its decision Undo record exist; supplied recordSeq matches newest record.","now is not before the decision and is within UNDO_WINDOW_MINUTES (currently five).","Current referral deeply equals saved after snapshot; original-role/ward check passes.","An undone ACCEPT_REFERRAL refuses while a movement for the referral is not closed as did_not_proceed, or a stay from it holds a bed."],"effects":["Restores full referral before snapshot, removes only notices created by that decision id/time, and consumes the Undo record.","Does not remove the audit evidence of the decision or Undo; a later reassessment can make this Undo inapplicable."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":98,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1465,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-undo.ts","line":491,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-and-bed-board.test.ts","tests/ward-undo-toast-record-seq.dom.test.tsx"]},"reason":"Reviewed command model: Referral restored to its pre-decision snapshot."},{"event":"UNDO_AUDIT_REVIEW","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":634},"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":104},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1577}],"status":"modelled","model":{"subject":"One captured-event review in the current world generation","before":"Latest review on its captured event","after":"That review removed while audit history remains","payload":["reviewId; expectedGeneration matching current worldGeneration; finite now; role."],"scope":"coordinator only, with authenticated review/record scope; role check occurs before protected payload handling.","guards":["expectedGeneration is a safe current counter; review exists uniquely in this generation.","No later review on that event remains; undo newest first.","Time is at or after review and within UNDO_WINDOW_MINUTES."],"effects":["Removes that review from auditReviews and appends audited Undo; audit review ids are not reused.","Does not erase the reviewed event or its original review/Undo audit entries."],"sources":[{"path":"src/components/ward-management/ward-flow-protected-record-events.ts","line":103,"sha256":"54c8451a1eab7a74e88ff65a617a8cd2440a3de08b73e42b7e5e93720531fc96"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2587,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-undo.ts","line":491,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-and-bed-board.test.ts","tests/ward-governance.dom.test.tsx"]},"reason":"Reviewed command model: That review removed while audit history remains."},{"event":"PLACE_IN_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":636},"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":99},{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1771}],"status":"modelled","model":{"subject":"A current occupied/pulled stay on one ward","before":"Stay in another numbered bed or with known kind but no number","after":"Same stay recorded in the selected numbered bed and matching bed kind","payload":["admissionId; integer bedNumber within unit.beds; now/role; actingUnitId for ward; optional listed overrideReason when moving a locked/secure/involuntary stay to an open bed."],"scope":"ward or coordinator; ward must name admission's own unit. Authenticated stay/ward scope applies.","guards":["Admission exists and bedIsOccupied; unit exists; new bed differs and is in range, unoccupied and not held by another journey.","Prior bed kind can be determined safely; resulting locked/free counts are supported.","Open-bed move that needs an override has a listed reason."],"effects":["Updates admission bedNumber/bedKind, adjusts allocatableLocked only for kind changes; total empty/allocatable counts stay unchanged.","For a linked pulled stay, keeps movement heldBedNumber and accepted referral arm heldBedNumber aligned.","Captures the exact bed-placement Undo snapshot including prior kind, capacity revision and linked holds."],"sources":[{"path":"src/components/ward-management/ward-flow-bed-events.ts","line":97,"sha256":"be57f071ee46dc50dc5c0ac2dd9474b8a75f474f65aa943661a8bd08d2ed8113"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2592,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-and-bed-board.test.ts","tests/ward-release-pull-undo-guard.test.ts"]},"reason":"Reviewed command model: Same stay recorded in the selected numbered bed and matching bed kind."},{"event":"UNDO_PLACE_IN_BED","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":637},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1753},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":134}],"status":"modelled","model":{"subject":"A stay's latest numbered-bed move","before":"Stay still in saved destination bed; any changed kind capacity/linked holds unchanged","after":"Prior bed number/kind and associated hold numbers restored","payload":["admissionId; now; role; optional recordSeq; actingUnitId when ward."],"scope":"ward or coordinator; original acting role/ward or coordinator, plus authenticated stay scope.","guards":["Latest move record exists; exact supplied recordSeq, time-window and acting-role checks pass.","Stay remains current on same unit/in afterBed; changed kind capacity revision/count and linked pulled movement/referral arm still match saved after values.","Every restored numbered bed remains valid, unoccupied and unheld by another journey."],"effects":["Restores bedNumber (or absence), bedKind (or absence), changed free-locked count and linked hold numbers without overwriting unrelated rows.","Consumes bed-placement Undo; same-kind moves do not overwrite or block on unrelated later capacity changes."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":134,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-flow-events.ts","line":2612,"sha256":"378044cce3b2c98c2c24f4e5bb6ab27f7c361f02a7fa8ab59fa36a77388c84bf"},{"path":"src/components/ward-management/ward-undo.ts","line":491,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-and-bed-board.test.ts","tests/ward-release-pull-undo-guard.test.ts"]},"reason":"Reviewed command model: Prior bed number/kind and associated hold numbers restored."},{"event":"UNDO_REFER_TO_UNITS","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":640},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1754},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261}],"status":"modelled","model":{"subject":"Latest undoable REFER_TO_UNITS on the named subject","before":"Saved step record and unchanged post-step state","after":"Movement offer/ward-referral changes reversed","payload":["movementId; now; role; optional recordSeq matching the exact newest step."],"scope":"coordinator only. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for REFER_TO_UNITS; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts"]},"reason":"Reviewed command model: Movement offer/ward-referral changes reversed."},{"event":"UNDO_ACCEPT_IN_PRINCIPLE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":641},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1755},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":262}],"status":"modelled","model":{"subject":"Latest undoable ACCEPT_IN_PRINCIPLE on the named subject","before":"Saved step record and unchanged post-step state","after":"Acceptance, held bed/admission and generated notices restored to pre-acceptance","payload":["movementId; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"ward or coordinator; original ward actingUnitId or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for ACCEPT_IN_PRINCIPLE; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts"]},"reason":"Reviewed command model: Acceptance, held bed/admission and generated notices restored to pre-acceptance."},{"event":"UNDO_LEGAL_FORM_RECORD","roles":["ed","coordinator","ward","community"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":642},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1756},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":263}],"status":"modelled","model":{"subject":"Latest undoable RECORD_LEGAL_FORM_WRITTEN, RECORD_LEGAL_FORM_CODE, RECORD_LEGAL_FORM_RECEIVED or RECORD_LEGAL_FORM_EXPIRY on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest recorded form/time/receipt/expiry and accompanying changed rows restored","payload":["movementId; now; role; optional recordSeq matching the exact newest step."],"scope":"ed, coordinator, ward or community; original acting role or coordinator (role eligibility is not authority over another place). Authenticated record/place scope remains required. A ward must match the original ward captured in the saved Undo record, not merely a ward eligible to view or act on the movement now. Missing legacy ward provenance refuses a ward caller; coordinator handling remains available.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The legitimate legal-form Undo payload omits actingUnitId: reducer role consistency falls back to the saved record.unitId, while shared authenticated scope independently compares that original ward with the caller's scope.","The original ward is recorded on the source legal-form step even when its legitimate caller omitted actingUnitId: receipt provenance uses the sending stay or ward referral, while other form entries use the receiving stay. Another eligible ward cannot substitute for that original ward; coordinator and original-role rules otherwise remain.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_LEGAL_FORM_WRITTEN, RECORD_LEGAL_FORM_CODE, RECORD_LEGAL_FORM_RECEIVED or RECORD_LEGAL_FORM_EXPIRY; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-audit-legal-group.test.ts","tests/ward-ed-handover-events.test.ts","tests/ward-consolidated-authority.test.ts"]},"reason":"Reviewed command model: Newest recorded form/time/receipt/expiry and accompanying changed rows restored."},{"event":"UNDO_SUPPORT_NOTIFICATION","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":643},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1757},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":264}],"status":"modelled","model":{"subject":"Latest undoable RECORD_SUPPORT_NOTIFICATION on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest Tell record removed from the subject's checklist","payload":["movementId or admissionId identifying the original Tell subject; now; role; optional recordSeq matching the exact newest step."],"scope":"ward or coordinator; original acting role or coordinator; arriving movement must remain inside accepted-ward scope. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_SUPPORT_NOTIFICATION; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts","tests/ward-support-notifications.test.ts"]},"reason":"Reviewed command model: Newest Tell record removed from the subject's checklist."},{"event":"UNDO_REPATRIATION","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":644},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1758},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":265}],"status":"modelled","model":{"subject":"Latest undoable RECORD_REPATRIATION on the named subject","before":"Saved step record and unchanged post-step state","after":"Return transport record and all generated journey/notice changes restored","payload":["admissionId; now; role; optional recordSeq matching the exact newest step."],"scope":"coordinator only. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_REPATRIATION; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-out-of-area-repatriation.test.ts"]},"reason":"Reviewed command model: Return transport record and all generated journey/notice changes restored."},{"event":"UNDO_FLAG_RETURN_EARLY","roles":["coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":645},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1759},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":266}],"status":"modelled","model":{"subject":"The newest FLAG_RETURN_EARLY on one stay","before":"Stay flagged early by that step","after":"Stay as it was before the flag","payload":["admissionId; now; role; optional recordSeq."],"scope":"coordinator in the role table.","guards":["A matching Undo record exists for this kind of step on this subject; a supplied recordSeq must match the newest record.","The undoing role is the role (and ward) that acted, or a coordinator; now is within UNDO_WINDOW_MINUTES.","The subject has not changed since the step, and restoring it would not put the patient in a second bed or clash with an occupied bed number.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Restores the saved snapshot of the step, removes notices that step raised and consumes the Undo record.","The audit evidence of the step and of the Undo stays."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1508,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":266,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"}],"tests":["tests/ward-return-early.test.ts"]},"reason":"Reviewed command model: takes back the newest early-return flag on a stay within the Undo window."},{"event":"UNDO_HANDOVER_SIGN_OFF","roles":["coordinator","ward"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":646},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1760},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":267}],"status":"modelled","model":{"subject":"Latest undoable RECORD_HANDOVER_SIGN_OFF on the named subject","before":"Saved step record and unchanged post-step state","after":"Latest sign-off for that ward or network removed","payload":["unitId for ward sign-off; omitted names network subject; now; role; optional recordSeq matching the exact newest step."],"scope":"coordinator or ward; original acting role/ward or coordinator; a ward must name its own ward. Authenticated record/place scope remains required. Only the statewide coordinator may omit unitId for a whole-network subject; a scoped coordinator must name a ward inside its scope.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","Shared scoped callers cannot resolve a missing unitId to the whole-network sign-off; an ordinary in-scope ward target remains allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_HANDOVER_SIGN_OFF; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts","tests/ward-consolidated-authority.test.ts"]},"reason":"Reviewed command model: Latest sign-off for that ward or network removed."},{"event":"UNDO_SITE_HANDOVER_SIGN_OFF","roles":["bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":649},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1761},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":268}],"status":"modelled","model":{"subject":"Latest undoable RECORD_SITE_HANDOVER_SIGN_OFF on the named subject","before":"Saved step record and unchanged post-step state","after":"Latest sign-off for that site removed; no ward sign-off changed","payload":["siteCode; now; role; optional recordSeq matching the exact newest step."],"scope":"bed_manager only for its own site; coordinator is not eligible even if it signed as cover. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_SITE_HANDOVER_SIGN_OFF; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":283,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"}],"tests":["tests/ward-undo-steps.test.ts","tests/ward-site-handover-sign-off.test.ts"]},"reason":"Reviewed command model: Latest sign-off for that site removed; no ward sign-off changed."},{"event":"UNDO_ED_STEP","roles":["ed","ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":650},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1762},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":269}],"status":"modelled","model":{"subject":"Latest undoable RECORD_ARRIVED_IN_DEPARTMENT, RECORD_EXAMINATION, RECORD_MEDICAL_CLEARANCE, RECORD_TRANSPORT_NEED, RECORD_ED_PRESENTATION, HANDOVER_READY, REQUEST_PSYCH_REVIEW or RECORD_PSYCH_REVIEW_SEEN on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest ED board step and all records it changed restored","payload":["movementId or referralId identifying original subject; now; role; optional recordSeq matching the exact newest step."],"scope":"ed, ward, community or coordinator; original acting role or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_ARRIVED_IN_DEPARTMENT, RECORD_EXAMINATION, RECORD_MEDICAL_CLEARANCE, RECORD_TRANSPORT_NEED, RECORD_ED_PRESENTATION, HANDOVER_READY, REQUEST_PSYCH_REVIEW or RECORD_PSYCH_REVIEW_SEEN; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-ed-examination-save.dom.test.tsx","tests/ward-ed-handover-events.test.ts"]},"reason":"Reviewed command model: Newest ED board step and all records it changed restored."},{"event":"UNDO_TRANSPORT_STEP","roles":["officer","ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":651},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1763},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":270}],"status":"modelled","model":{"subject":"Latest undoable TRANSPORT_ACCEPTED, TRANSPORT_EN_ROUTE, PATIENT_COLLECTED or PATIENT_ARRIVED on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest transport stage reversed, including arrival-created stay and affected bed/resource changes","payload":["movementId; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"officer, ward or coordinator; original acting role/ward or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for TRANSPORT_ACCEPTED, TRANSPORT_EN_ROUTE, PATIENT_COLLECTED or PATIENT_ARRIVED; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-undo-steps.test.ts","tests/ward-undo-dependent-records.test.ts"]},"reason":"Reviewed command model: Newest transport stage reversed, including arrival-created stay and affected bed/resource changes."},{"event":"UNDO_DEPARTURE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":652},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1764},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":271}],"status":"modelled","model":{"subject":"Latest undoable RECORD_LEAVING or RECORD_PATIENT_DISCHARGE on the named subject","before":"Saved step record and unchanged post-step state","after":"Departure reversed, stay and capacity restored if still safe","payload":["admissionId; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"ward or coordinator; original acting role/ward or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_LEAVING or RECORD_PATIENT_DISCHARGE; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-departure-undo-integrity.test.ts"]},"reason":"Reviewed command model: Departure reversed, stay and capacity restored if still safe."},{"event":"UNDO_ABSENT_WITHOUT_LEAVE","roles":["ward","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":653},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1765},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":272}],"status":"modelled","model":{"subject":"Latest undoable RECORD_ABSENT_WITHOUT_LEAVE on the named subject","before":"Saved step record and unchanged post-step state","after":"Newest absence record and related row changes reversed","payload":["admissionId; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"ward or coordinator; original acting role/ward or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for RECORD_ABSENT_WITHOUT_LEAVE; removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"}],"tests":["tests/ward-engine-safety.test.ts"]},"reason":"Reviewed command model: Newest absence record and related row changes reversed."},{"event":"UNDO_BED_MEETING_ACTION","roles":["coordinator","ward","ed","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":655},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1766},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":273}],"status":"modelled","model":{"subject":"Latest undoable COMPLETE_BED_MEETING_ACTION or RECORD_BED_MEETING_ACTION on the named subject","before":"Saved step record and unchanged post-step state","after":"One completed meeting action reopened to its exact prior state","payload":["subject {kind:movement|admission,id}; action BedMeetingActionKind; actingUnitId when ward; now; role; optional recordSeq matching the exact newest step."],"scope":"coordinator, ward, ed, community or bed_manager; original acting role/ward or coordinator. Authenticated record/place scope remains required.","guards":["A matching newest step Undo record exists for this exact subject/action family; a supplied recordSeq must match.","now is at/after the step and within UNDO_WINDOW_MINUTES (currently five).","Every affected row/whole-list patch still matches saved after values (a created notice may have been read); changed records refuse rather than overwrite newer work.","Any restored occupied/pulled bed is rechecked against current linked-patient, bed-number and hold conflicts; a sending-occupied/receiving-pulled transfer hold is allowed.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Applies only saved before/after patches for COMPLETE_BED_MEETING_ACTION or RECORD_BED_MEETING_ACTION (Chase Undo); removes newly created rows, restores removed/changed rows and removes appended entries.","Consumes that step Undo record; a removed stay loses its bed-placement Undo. Audit history remains; a unit allocatable revision advances instead of being rolled back."],"sources":[{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":261,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-undo.ts","line":74,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":138,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-undo.ts","line":393,"sha256":"22a192fa0c973fff7b2b9b13038f17020b3990a33a0588af76ab2a4f79d035db"},{"path":"src/components/ward-management/ward-access-state.ts","line":659,"sha256":"924e9e6ab48fddbf423e5cf988cc09b75df3ace0ce4f4465f379b143957e3d07"},{"path":"src/components/ward-management/ward-bed-meeting-undo-event-type.ts","line":10,"sha256":"a112bd8031c48d720a344b7a3fe9821b6f41db2d88956a2b001f8e5fca8fdb41"}],"tests":["tests/ward-bed-meeting-undo.test.ts"]},"reason":"Reviewed command model: One completed meeting action reopened to its exact prior state."},{"event":"UNDO_BED_STEP","roles":["ward","bed_manager","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":657},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1767},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":274}],"status":"modelled","model":{"subject":"One bed (unitId and bedNumber) or one leave bed record","before":"Bed as the SET_BED_CLOSED or END_LEAVE_BED step left it","after":"Bed or leave record restored to before that step","payload":["now; role; optional recordSeq; actingUnitId when ward; leaveBedId, or unitId and bedNumber."],"scope":"ward, bed_manager or coordinator in the role table.","guards":["A matching Undo record exists for this kind of step on this subject; a supplied recordSeq must match the newest record.","The undoing role is the role (and ward) that acted, or a coordinator; now is within UNDO_WINDOW_MINUTES.","The subject has not changed since the step, and restoring it would not put the patient in a second bed or clash with an occupied bed number.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Restores the saved snapshot of the step, removes notices that step raised and consumes the Undo record.","The audit evidence of the step and of the Undo stays."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1516,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":274,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"}],"tests":["tests/ward-tier1-undo.test.ts","tests/ward-undo-dependent-records.test.ts"]},"reason":"Reviewed command model: takes back a bed closed or reopened, or a return from leave, within the Undo window."},{"event":"UNDO_RELEASE_STEP","roles":["coordinator","ward","ed","community","bed_manager"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":658},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1768},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":275}],"status":"modelled","model":{"subject":"One movement, one bed release, or one planned admission","before":"As the release, confirm, cancel or withdraw step left it","after":"Restored to before that step","payload":["now; role; optional recordSeq; actingUnitId when ward; movementId, releaseId or plannedAdmissionId."],"scope":"coordinator, ward, ed, community or bed_manager in the role table.","guards":["A matching Undo record exists for this kind of step on this subject; a supplied recordSeq must match the newest record.","The undoing role is the role (and ward) that acted, or a coordinator; now is within UNDO_WINDOW_MINUTES.","The subject has not changed since the step, and restoring it would not put the patient in a second bed or clash with an occupied bed number.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Restores the saved snapshot of the step, removes notices that step raised and consumes the Undo record.","The audit evidence of the step and of the Undo stays."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1517,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":275,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"}],"tests":["tests/ward-tier1-undo.test.ts"]},"reason":"Reviewed command model: takes back a released bed, confirmed discharge sign-off, cancelled transport, withdrawn ward request or cancelled planned admission."},{"event":"UNDO_PATIENT_RECORD","roles":["community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":659},"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1769},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":276}],"status":"modelled","model":{"subject":"One patient record","before":"As the CTO or archive step left it","after":"Patient record restored to before that step","payload":["patientId; now; role; optional recordSeq."],"scope":"community or coordinator in the role table.","guards":["A matching Undo record exists for this kind of step on this subject; a supplied recordSeq must match the newest record.","The undoing role is the role (and ward) that acted, or a coordinator; now is within UNDO_WINDOW_MINUTES.","The subject has not changed since the step, and restoring it would not put the patient in a second bed or clash with an occupied bed number.","The complete proposed inverse must keep every leave attached to an occupied same-ward stay, with only one leave per stay; any restored or changed retained UMRN must have no other current owner. Blank, privacy-placeholder and UMRN not recorded values carry no retained identity claim."],"effects":["Restores the saved snapshot of the step, removes notices that step raised and consumes the Undo record.","The audit evidence of the step and of the Undo stays."],"sources":[{"path":"src/components/ward-management/ward-flow-reducer.ts","line":1518,"sha256":"edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a"},{"path":"src/components/ward-management/ward-flow-undo-events.ts","line":276,"sha256":"7344423b59a813fb2f73d630be0d158154dd5c64d718ec797aebe6de4c140b5e"},{"path":"src/components/ward-management/ward-retained-umrn.ts","line":25,"sha256":"7968243f077b9d5c9a6fe6a56385f48ff6a97aa39cfdeec8fe97f05919693d80"}],"tests":["tests/ward-tier1-undo.test.ts","tests/ward-retained-umrn.test.ts"]},"reason":"Reviewed command model: takes back a community treatment order recorded or ended, or a record archived in error."},{"event":"RECORD_CARE_PLAN","roles":["ward","ed","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":663},"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-events.ts","line":14},{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":44}],"status":"modelled","model":{"subject":"A patient record's care plans","before":"Patient exists, holding zero or more care plans (at most one Current)","after":"New Current plan appended; any earlier Current plan marked Superseded, never deleted","payload":["patientId; plan with type and what helps from fixed lists, agreed by (short text), typed dates, optional key contact and one short note","optional attachment as file type and size only (never the file or its name); role and now"],"scope":"Ward, ED, community or coordinator in EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; finite now; plan type and helps on their lists; agreed by and agreed date required","Short text over its limit refused, never shortened; attachment needs a listed type and a positive byte size; at most 20 plans per person"],"effects":["Replaces the patient's carePlans with the superseded list plus the new Current plan","Typed-text event: a session that sends it stops saving to browser storage"],"tests":["tests/ward-patient-care-plans.test.ts","tests/ward-event-permissions.test.ts"],"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":44,"sha256":"ebd947f4ec177d0acb998b35f3ebd66d0ac58b777c9a874e20ed3e67203caa1d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":663,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-care-plans.ts","line":98,"sha256":"20f25414be8b4ae5eb1b9cc9eee189ba1ba08b0466b00ee6f7139876b963752f"}]},"reason":"Source-reviewed command model: a new Current care plan on the patient; the previous Current plan becomes Superseded."},{"event":"RECORD_TRIBUNAL_HEARING","roles":["ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":664},"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-events.ts","line":22},{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":81}],"status":"modelled","model":{"subject":"A patient record's tribunal hearing","before":"Patient exists, with or without an earlier hearing date","after":"tribunalHearing holds the typed date, optional typed time, role and time recorded; any earlier hearing and outcome replaced","payload":["patientId; date as YYYY-MM-DD; optional time as HH:MM; role and now"],"scope":"Ward, community or coordinator in EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; finite now; a real calendar date; a 24-hour time when given"],"effects":["Shown as typed, never a countdown (D-93); a worded flag once the date has passed with no outcome"],"tests":["tests/ward-patient-care-plans.test.ts","tests/ward-event-permissions.test.ts"],"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":81,"sha256":"ebd947f4ec177d0acb998b35f3ebd66d0ac58b777c9a874e20ed3e67203caa1d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":664,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-care-plans.ts","line":149,"sha256":"20f25414be8b4ae5eb1b9cc9eee189ba1ba08b0466b00ee6f7139876b963752f"}]},"reason":"Source-reviewed command model: a Mental Health Tribunal hearing date held on the patient as typed."},{"event":"RECORD_TRIBUNAL_OUTCOME","roles":["ward","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":665},"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-events.ts","line":33},{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":95}],"status":"modelled","model":{"subject":"A patient record's tribunal hearing","before":"Patient exists with a recorded hearing date","after":"tribunalHearing.outcome holds Held, Adjourned or Cancelled with role and time recorded","payload":["patientId; outcome from TRIBUNAL_OUTCOMES; role and now"],"scope":"Ward, community or coordinator in EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; finite now; a hearing date must be recorded; outcome on the list"],"effects":["Clears the hearing-date-passed flag"],"tests":["tests/ward-patient-care-plans.test.ts","tests/ward-event-permissions.test.ts"],"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":95,"sha256":"ebd947f4ec177d0acb998b35f3ebd66d0ac58b777c9a874e20ed3e67203caa1d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":665,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"}]},"reason":"Source-reviewed command model: the outcome of the recorded tribunal hearing, held beside its date."},{"event":"SET_CULTURAL_SUPPORT_REQUEST","roles":["ward","ed","community","coordinator"],"permissionSource":{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":666},"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-events.ts","line":41},{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":107}],"status":"modelled","model":{"subject":"A patient record's cultural support request","before":"Patient exists, with or without a request","after":"culturalSupportRequested holds the listed request, or is removed when request is null","payload":["patientId; request from CULTURAL_SUPPORT_REQUESTS or null; role and now"],"scope":"Ward, ED, community or coordinator in EVENT_ROLE. Shared authenticated command scope additionally checks the permitted place and stored record; EVENT_ROLE alone is not place authority.","guards":["Patient must exist; finite now; request on the list or null"],"effects":["Never derived from the Aboriginal status field; set only by this event"],"tests":["tests/ward-patient-care-plans.test.ts","tests/ward-event-permissions.test.ts"],"sources":[{"path":"src/components/ward-management/ward-patient-care-plan-reducer.ts","line":107,"sha256":"ebd947f4ec177d0acb998b35f3ebd66d0ac58b777c9a874e20ed3e67203caa1d"},{"path":"src/components/ward-management/ward-flow-event-roles.ts","line":666,"sha256":"01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb"},{"path":"src/components/ward-management/ward-patient-care-plans.ts","line":168,"sha256":"20f25414be8b4ae5eb1b9cc9eee189ba1ba08b0466b00ee6f7139876b963752f"}]},"reason":"Source-reviewed command model: cultural support the person or family asked for, set or taken off."}],"contractSha256":"058aeabf4009259104c6d772f6126c1c9d7fb94286b54b256eda1dd711025423","made":{"builtAt":"2026-11-11T05:16:50.788Z","commit":"8ac30c40855b97f29a20c6cb34a68892bdf27ff8","branch":"claude/project-thread-e15xqk-clinical","dirty":true,"dirtyCount":6},"refusalCoverage":null};
 
       // Every lane a node or action can carry, and the colour it draws in.
       const LANE_COLOUR = {
diff --git a/script-budget.json b/script-budget.json
index 1dd84ed77..9faff200e 100644
--- a/script-budget.json
+++ b/script-budget.json
@@ -1,12 +1,12 @@
 {
   "$comment": "Phone first-load script budgets in KB gzipped, checked by scripts/check-script-budget.mjs after the production build. Set on 16 October 2026 at the measured size plus about 10 KB, and lowered the same day after the rail and search left a phone's first load. Lower a budget when a route shrinks. Raise one only with a reason in the PR. Raise and lowering history: docs/script-budget-history.md up to 4 November 2026, then one file per PR in docs/script-budget-history/ (see its README), not here.",
   "budgets": {
-    "/ward-flow": 575.4,
-    "/ward-flow/referrals": 583.6,
-    "/ward-flow/ed": 535.4,
-    "/ward-flow/ward/rph-adult-secure": 613.8,
+    "/ward-flow": 575.7,
+    "/ward-flow/referrals": 583.9,
+    "/ward-flow/ed": 535.7,
+    "/ward-flow/ward/rph-adult-secure": 614.1,
     "/ward-flow/movements/WF-001": 609.8,
-    "/ward-flow/capacity": 654.3,
+    "/ward-flow/capacity": 654.7,
     "/ward-flow/ed/arm-ed": 667.4,
     "/ward-flow/bed-meeting": 592.2,
     "/ward-flow/statistics": 632.6
diff --git a/src/components/ward-management/capacity/beds-forecast.ts b/src/components/ward-management/capacity/beds-forecast.ts
index 4671710bc..f8b968823 100644
--- a/src/components/ward-management/capacity/beds-forecast.ts
+++ b/src/components/ward-management/capacity/beds-forecast.ts
@@ -17,7 +17,7 @@ import { dayOf, MINUTES_PER_DAY, type Instant } from "@/components/ward-manageme
 import { isOpen } from "@/components/ward-management/ward-derivations";
 import type { BedRelease, Movement, MovementStage, Unit } from "@/components/ward-management/ward-model";
 import { bedsForecastSources, type BedsForecastSources } from "./beds-forecast-sources";
-import { plannedAdmissionsStillNeedingABed } from "./planned-admissions-reducer";
+import { patientsHoldingANamedBed, plannedAdmissionsStillNeedingABed } from "./planned-admissions-reducer";
 import { forecastReleaseAt } from "../forecast/forecast-release-date";
 
 /**
@@ -113,6 +113,8 @@ export function bedsForecast(
   const reservations = [...movements, ...referrals];
   const readyNow = openUnits.reduce((sum, unit) => sum + bedStates(unit, admissions, [], [], reservations).ready, 0);
   const openUnitIds = new Set(openUnits.map((unit) => unit.id));
+  // A booked person who already holds a named bed is out of Ready once; never count the booking too.
+  const namedBedHolders = patientsHoldingANamedBed(openUnits, admissions, reservations);
   const unitIds = new Set(units.map((unit) => unit.id));
   const admissionsById = new Map(admissions.map((admission) => [admission.id, admission]));
   const expectedAt = (release: BedRelease) => forecastReleaseAt(release, admissionsById.get(release.admissionId));
@@ -146,6 +148,7 @@ export function bedsForecast(
       until,
       waitingMovements,
       admissions,
+      namedBedHolders,
     ).length;
     const bedsNeeded = waitingForBed + planned;
     const low = readyNow + confirmed - bedsNeeded;
diff --git a/src/components/ward-management/capacity/expected-occupancy.ts b/src/components/ward-management/capacity/expected-occupancy.ts
index f9bc878bc..509b3c335 100644
--- a/src/components/ward-management/capacity/expected-occupancy.ts
+++ b/src/components/ward-management/capacity/expected-occupancy.ts
@@ -48,8 +48,10 @@ export function expectedOccupancy(
     .map((unit): OccupancyRow => {
       const states = bedStates(unit, admissions, [...releases], [], reservations);
       const takenNow = states.occupied + states.pulled;
-      // The forecast for this ward alone, with nobody waiting: waiting people have no ward yet.
-      const forecast = bedsForecast([unit], [...releases], [...admissions], [], now, planned);
+      // The forecast for this ward alone, with nobody waiting: waiting people have no ward yet. The
+      // named holds go in too, so a booking for someone already holding a bed here (in `takenNow`)
+      // is not added a second time.
+      const forecast = bedsForecast([unit], [...releases], [...admissions], [], now, planned, reservations);
       return {
         unitId: unit.id,
         name: unit.name,
diff --git a/src/components/ward-management/capacity/planned-admissions-reducer.ts b/src/components/ward-management/capacity/planned-admissions-reducer.ts
index e982e3431..4900fbfe5 100644
--- a/src/components/ward-management/capacity/planned-admissions-reducer.ts
+++ b/src/components/ward-management/capacity/planned-admissions-reducer.ts
@@ -9,7 +9,11 @@
 import { closedToAdmissionsRefusal } from "./ward-closure";
 import { bedsPendingPreparation } from "../ward-bed-availability";
 import { lockedBedsFree, openBedsFree } from "../ward-bed-designation";
-import { pendingNumberedReservations } from "../ward-movement-bed-hold";
+import {
+  numberedReservationBeds,
+  pendingNumberedReservations,
+  type ReservationReferral,
+} from "../ward-movement-bed-hold";
 import { pulledBedAvailability } from "../ward-ready-beds";
 import {
   isPlannedAdmissionCancelReason,
@@ -173,9 +177,37 @@ function onAnOpenJourney(state: WardFlowState, patientId: string): boolean {
   );
 }
 
+/**
+ * The people who already hold a numbered bed by name on one of `units`, by the same rule as
+ * `numberedReservationBeds`. Their bed is already out of Ready (and in a ward's Pulled count), so a
+ * booking for the same person must not be counted as fresh demand again (Josh, 11 Nov 2026).
+ */
+export function patientsHoldingANamedBed(
+  units: readonly Unit[],
+  admissions: readonly Admission[],
+  reservations: readonly (Movement | ReservationReferral)[],
+): Set<string> {
+  const holders = new Set<string>();
+  for (const row of reservations) {
+    if (!row.patientId || holders.has(row.patientId)) continue;
+    // Only a row carrying a bed number can hold one; the full rule then runs for that row alone.
+    const numbered =
+      "stage" in row
+        ? row.heldBedNumber !== undefined
+        : ("destinations" in row ? row.destinations : [row]).some((arm) => arm.heldBedNumber !== undefined);
+    if (!numbered) continue;
+    const asMovement = "stage" in row ? [row] : [];
+    const asReferral = "stage" in row ? [] : [row];
+    if (units.some((unit) => numberedReservationBeds(unit, admissions, asMovement, asReferral).size > 0))
+      holders.add(row.patientId);
+  }
+  return holders;
+}
+
 /**
  * The bookings still to count as beds needed: booked, on a known ward, due by `until`, and not a
- * linked patient already counted through a waiting movement or already holding a pulled/occupied bed.
+ * linked patient already counted through a waiting movement, already holding a pulled/occupied bed,
+ * or already holding a numbered bed by name.
  * Initials-only bookings are always counted: nothing links them to a movement.
  */
 export function plannedAdmissionsStillNeedingABed(
@@ -184,10 +216,13 @@ export function plannedAdmissionsStillNeedingABed(
   until: Instant,
   waitingMovements: readonly Movement[],
   admissions: readonly Admission[] = [],
+  /** People already holding a numbered bed by name (`patientsHoldingANamedBed`): their bed is out of Ready. */
+  namedBedHolders: Iterable<string> = [],
 ): PlannedAdmission[] {
-  const accountedPatientIds = new Set(
-    waitingMovements.map((movement) => movement.patientId).filter((id): id is NonNullable<typeof id> => Boolean(id)),
-  );
+  const accountedPatientIds = new Set<string>([
+    ...waitingMovements.map((movement) => movement.patientId).filter((id): id is NonNullable<typeof id> => Boolean(id)),
+    ...namedBedHolders,
+  ]);
   // The booking remains on the calendar after an ordinary movement is pulled or arrives.
   // Its bed has already left Ready; do not count that same person as fresh demand again.
   for (const admission of admissions) {
diff --git a/src/components/ward-management/ed/ed-screen-derivations.ts b/src/components/ward-management/ed/ed-screen-derivations.ts
index b2704f34d..3e6fc9271 100644
--- a/src/components/ward-management/ed/ed-screen-derivations.ts
+++ b/src/components/ward-management/ed/ed-screen-derivations.ts
@@ -18,6 +18,7 @@ import { edById } from "@/components/ward-management/ward-sites";
 import {
   ED_REFERRED_NOT_SEEN_MINUTES,
   ED_SEVERE_PRESSURE_WAIT_MINUTES,
+  isLongWait,
   LATE_ARRIVAL_GRACE_MINUTES,
   LONG_WAIT_MINUTES,
   LONG_WAIT_TEXT,
@@ -474,7 +475,7 @@ export function deriveEdScreen({
         onAction: () => setArrivalPlanOpenFor(m.id),
       });
     }
-    if (m.originEdId === thisEdId && isWaitingInEd(m) && now - m.openedAt > LONG_WAIT_MINUTES) {
+    if (m.originEdId === thisEdId && isWaitingInEd(m) && isLongWait(now - m.openedAt)) {
       priorityFlags.push({
         tone: "quiet",
         kind: `Waiting ${LONG_WAIT_TEXT}`,
diff --git a/src/components/ward-management/ed/ed-screen-timeline.tsx b/src/components/ward-management/ed/ed-screen-timeline.tsx
index faca91835..a94497210 100644
--- a/src/components/ward-management/ed/ed-screen-timeline.tsx
+++ b/src/components/ward-management/ed/ed-screen-timeline.tsx
@@ -6,7 +6,7 @@ import { isOpen } from "@/components/ward-management/ward-derivations";
 import type { WardFlowContextValue } from "@/components/ward-management/ward-flow-provider";
 import { WARD_FLOW_ROLE_LABELS } from "@/components/ward-management/ward-flow-roles";
 import { legalFormName } from "@/components/ward-management/ward-legal-forms";
-import { LONG_WAIT_MINUTES, LONG_WAIT_TEXT } from "@/components/ward-management/ward-operational-defaults";
+import { isLongWait, LONG_WAIT_TEXT } from "@/components/ward-management/ward-operational-defaults";
 import { DECLINE_REASON_LABELS } from "@/components/ward-management/ward-referrals";
 import { resolveSubjectPatient } from "@/components/ward-management/ward-patient-resolver";
 import { movementMedicalClearance } from "./ed-screen-model";
@@ -97,25 +97,25 @@ export function edDepartmentTimelineEvents({
       movements,
     });
     if (now - m.openedAt <= 24 * 60 || isMovementOpen) {
-      const isLongWait = now - m.openedAt > LONG_WAIT_MINUTES && isMovementOpen;
+      const longWait = isLongWait(now - m.openedAt) && isMovementOpen;
       timelineEvents.push({
         id: `arrival-${m.id}-${m.openedAt}`,
         min: m.openedAt,
-        tone: isLongWait ? "warn" : "quiet",
+        tone: longWait ? "warn" : "quiet",
         category: "arrivals",
         categoryLabel: "Arrivals & Departures",
         patientName: patientInfo.displayName,
         movementId: m.id,
         badgeText: "Arrived",
-        badgeTone: isLongWait ? "warn" : "quiet",
+        badgeTone: longWait ? "warn" : "quiet",
         primaryText: "Arrived at Emergency Department",
-        detailText: isLongWait ? `Waiting ${splitDuration(now - m.openedAt)} (${LONG_WAIT_TEXT})` : undefined,
+        detailText: longWait ? `Waiting ${splitDuration(now - m.openedAt)} (${LONG_WAIT_TEXT})` : undefined,
         by: null,
         isOpenMovement: isMovementOpen,
         what: (
           <>
             <b>{patientInfo.displayName}</b> arrived at the department
-            {isLongWait && (
+            {longWait && (
               <span>
                 {" "}
                 &mdash; waiting {LONG_WAIT_TEXT} ({splitDuration(now - m.openedAt)})
diff --git a/src/components/ward-management/forecast/forecast-by-kind.ts b/src/components/ward-management/forecast/forecast-by-kind.ts
index e5c7a3ef5..b89e7ab8f 100644
--- a/src/components/ward-management/forecast/forecast-by-kind.ts
+++ b/src/components/ward-management/forecast/forecast-by-kind.ts
@@ -10,7 +10,10 @@
 // planned admission is sorted by its booked age band and, for an adult, by its legal status:
 // detained under the Act needs a locked bed, anything else an open one. Nothing is predicted.
 import { bedKindGaps, type BedKindId } from "@/components/ward-management/capacity/capacity-derivations";
-import { plannedAdmissionsStillNeedingABed } from "@/components/ward-management/capacity/planned-admissions-reducer";
+import {
+  patientsHoldingANamedBed,
+  plannedAdmissionsStillNeedingABed,
+} from "@/components/ward-management/capacity/planned-admissions-reducer";
 import { isDetainedUnderTheAct } from "@/components/ward-management/ed/ed-home-derivations";
 import { bedIsOccupied, type Admission, type PlannedAdmission } from "@/components/ward-management/ward-admissions";
 import { dayOf, MINUTES_PER_DAY, type Instant } from "@/components/ward-management/ward-clock";
@@ -125,6 +128,7 @@ export function forecastByKind(
     until,
     waitingMovements,
     admissions,
+    patientsHoldingANamedBed([...openUnits.values()], admissions, [...movements, ...referrals]),
   );
 
   const kinds = KIND_ORDER.map((id): KindForecast => {
diff --git a/src/components/ward-management/legal-forms/legal-forms-derivations.ts b/src/components/ward-management/legal-forms/legal-forms-derivations.ts
index 1ce350f6d..f3858e2ed 100644
--- a/src/components/ward-management/legal-forms/legal-forms-derivations.ts
+++ b/src/components/ward-management/legal-forms/legal-forms-derivations.ts
@@ -13,7 +13,7 @@ import type { LegalForm, Movement } from "@/components/ward-management/ward-mode
 import type { WardRecordTone } from "@/components/ward-management/ward-record-row";
 import { currentLegalDueAt, formProgression, formProgressionPhrase } from "./legal-form-progression";
 export { currentLegalDueAt } from "./legal-form-progression";
-import { typedTimePhrase } from "./legal-time-as-typed";
+import { typedClock, typedTimePhrase } from "./legal-time-as-typed";
 
 /**
  * LEGAL FORMS AND DEADLINES — pure derivations for `LegalFormsScreen`.
@@ -181,6 +181,14 @@ export function legalDeadlineText(movement: Movement, now: Instant): string {
     throw new Error(`legalDeadlineText called on movement ${movement.id}, which carries no legal form`);
   }
   const progression = formProgression(movement);
+  if (progression?.ended) return `${formProgressionPhrase(progression)}; Form ${progression.nextCode} to record`;
+  // A form a person recorded as ended keeps its typed expiry as history only (Josh, 11 Nov 2026):
+  // never "Form expiry ends 15:42 as typed" under "Ended", which reads as a live expiry.
+  if (legalForm.endedBy !== undefined) {
+    return legalForm.dueAt === undefined
+      ? "Form ended"
+      : `Form ended; expiry as typed was ${typedClock(legalForm.dueAt, now)}`;
+  }
   if (progression) return `${formProgressionPhrase(progression)}; Form ${progression.nextCode} to record`;
   if (legalForm.dueAt !== undefined) {
     // Legal times only as typed (31 Oct 2026): "Form expiry ends 15:42 as typed", never a count.
diff --git a/src/components/ward-management/ward-operational-defaults.ts b/src/components/ward-management/ward-operational-defaults.ts
index 960420282..c8249eae6 100644
--- a/src/components/ward-management/ward-operational-defaults.ts
+++ b/src/components/ward-management/ward-operational-defaults.ts
@@ -97,6 +97,14 @@ export const ED_SEVERE_PRESSURE_WAIT_MINUTES = CLINICAL_VALUES.edSeverePressure.
 export const LONG_WAIT_MINUTES = CLINICAL_VALUES.longWait.value;
 /** The words screens use for it, built from the value: "past 24 hours". */
 export const LONG_WAIT_TEXT = `past ${LONG_WAIT_MINUTES / MINUTES_PER_HOUR} hours`;
+/**
+ * Whether a wait counts as long: at or past `LONG_WAIT_MINUTES`, so exactly 24 hours counts. One
+ * boundary for every screen (Josh, 11 Nov 2026): the ED screen used "past" (>) while Alerts, the
+ * TV, the bed meeting and Statistics used "at or past" (>=).
+ */
+export function isLongWait(waitMinutes: number): boolean {
+  return waitMinutes >= LONG_WAIT_MINUTES;
+}
 
 /**
  * M16 (signed by Josh 10 Nov 2026, D-130, as they were typed; synthetic prototype values, not legal
diff --git a/tests/ward-audit-m17-legal-as-recorded.test.ts b/tests/ward-audit-m17-legal-as-recorded.test.ts
index 3e5c9f36d..4196c27ba 100644
--- a/tests/ward-audit-m17-legal-as-recorded.test.ts
+++ b/tests/ward-audit-m17-legal-as-recorded.test.ts
@@ -247,6 +247,30 @@ describe("M17: one form, edited, replaced and lapsed, reads the same on every ou
     expect(outputs.downtimeEnded).toBe(true);
   });
 
+  // Fixed 11 Nov 2026 (Josh): the Legal forms card and row said "Ended" then "Form expiry ends 15:42
+  // as typed", which reads as a live expiry. The ended form's typed time is history, as typed.
+  it("on the Legal forms page, an ended form's line says it ended and gives the typed expiry as history", () => {
+    const { second } = journey();
+    const ended = apply(second, {
+      type: "RECORD_LEGAL_FORM_DETAILS",
+      role: "ed",
+      now: NOW + 3,
+      movementId: MOVEMENT_ID,
+      formCode: "3A",
+      endedBy: "revoked",
+    });
+    const movement = movementOf(ended);
+    const dueAt = movement.legalForm!.dueAt!;
+    for (const now of [NOW + 3, dueAt + 61]) {
+      const page = legalDeadlineText(movement, now);
+      expect(page).toBe(`Form ended; expiry as typed was ${typedClock(dueAt, now)}`);
+      expect(page).not.toContain(typedTimePhrase(dueAt, now));
+      expect(page).not.toMatch(COUNT);
+    }
+    const noTime = { ...movement, legalForm: { ...movement.legalForm!, dueAt: undefined } } as Movement;
+    expect(legalDeadlineText(noTime, NOW + 3)).toBe("Form ended");
+  });
+
   it("names the form on the TV wall by its full name (D-93), not the bare code", () => {
     const { second } = journey();
     const outputs = outputsAt(second, NOW + 2);
diff --git a/tests/ward-ed-long-wait-boundary.test.ts b/tests/ward-ed-long-wait-boundary.test.ts
new file mode 100644
index 000000000..4ef906319
--- /dev/null
+++ b/tests/ward-ed-long-wait-boundary.test.ts
@@ -0,0 +1,76 @@
+// C3 (Josh, 11 Nov 2026): one long-wait boundary. Exactly 24 hours counts as a long wait on the ED
+// screen, as it already did on Alerts, the TV, the bed meeting and Statistics (`>=`, not `>`).
+import { describe, expect, it } from "vitest";
+
+import { deriveEdScreen } from "@/components/ward-management/ed/ed-screen-derivations";
+import { isWaitingInEd } from "@/components/ward-management/ward-ed-presence";
+import { seedWardFlowState, type WardFlowState } from "@/components/ward-management/ward-flow-reducer";
+import { isLongWait, LONG_WAIT_MINUTES, LONG_WAIT_TEXT } from "@/components/ward-management/ward-operational-defaults";
+import { NOW_ANCHOR } from "@/components/ward-management/ward-sites";
+
+const NOW = NOW_ANCHOR;
+const noop = () => undefined;
+
+function board(state: WardFlowState, edId: string) {
+  return deriveEdScreen({
+    movements: state.movements,
+    units: state.units,
+    referrals: state.referrals,
+    registryPatients: state.patients,
+    configuration: state.configuration,
+    inboxSnoozes: state.inboxSnoozes,
+    admissions: state.admissions,
+    now: NOW,
+    accessTarget: state.configuration.edAccessTargetMinutes,
+    thisEdId: edId,
+    boardFilter: "all",
+    patientQuery: "",
+    patientSort: "current",
+    heroHighlight: null,
+    selectedPatientId: null,
+    arrivalPlanOpenFor: undefined,
+    setSelectedPatientId: noop,
+    setPhoneSheetFor: noop,
+    setArrivalPlanOpenFor: noop,
+    toggleBookTransport: noop,
+    recordEdStep: noop,
+  });
+}
+
+/** A seeded person waiting in an ED, opened `waited` minutes before now. */
+function waitingFor(waited: number) {
+  const seed = seedWardFlowState();
+  const journey = seed.movements.find((movement) => movement.originEdId !== undefined && isWaitingInEd(movement));
+  if (!journey?.originEdId) throw new Error("the seed has nobody waiting in an ED");
+  const state = {
+    ...seed,
+    movements: seed.movements.map((movement) =>
+      movement.id === journey.id ? { ...movement, openedAt: NOW - waited } : movement,
+    ),
+  };
+  const view = board(state, journey.originEdId);
+  return {
+    flagged: view.needsYouItems.some(
+      (item) => item.key.startsWith(`${journey.id}-`) && item.kind === `Waiting ${LONG_WAIT_TEXT}`,
+    ),
+    timelineTone: view.timelineEvents.find((event) => event.id === `arrival-${journey.id}-${NOW - waited}`)?.tone,
+  };
+}
+
+describe("long-wait boundary", () => {
+  it("counts exactly 24 hours as a long wait, and one minute less as not", () => {
+    expect(LONG_WAIT_MINUTES).toBe(24 * 60);
+    expect(isLongWait(LONG_WAIT_MINUTES)).toBe(true);
+    expect(isLongWait(LONG_WAIT_MINUTES - 1)).toBe(false);
+    expect(isLongWait(LONG_WAIT_MINUTES + 1)).toBe(true);
+  });
+
+  it("flags a person on the ED screen and its timeline at exactly 24 hours", () => {
+    const at = waitingFor(LONG_WAIT_MINUTES);
+    expect(at.flagged).toBe(true);
+    expect(at.timelineTone).toBe("warn");
+    const before = waitingFor(LONG_WAIT_MINUTES - 1);
+    expect(before.flagged).toBe(false);
+    expect(before.timelineTone).toBe("quiet");
+  });
+});
diff --git a/tests/ward-expected-occupancy.test.ts b/tests/ward-expected-occupancy.test.ts
index ccdceb5a2..aaf709c88 100644
--- a/tests/ward-expected-occupancy.test.ts
+++ b/tests/ward-expected-occupancy.test.ts
@@ -10,7 +10,7 @@ import { bedStates } from "@/components/ward-management/ward-bed-states";
 import { MINUTES_PER_DAY } from "@/components/ward-management/ward-clock";
 import { bedReleases } from "@/components/ward-management/ward-movements";
 import { NOW_ANCHOR, allUnits } from "@/components/ward-management/ward-sites";
-import type { BedRelease, Movement } from "@/components/ward-management/ward-model";
+import type { BedRelease, Movement, Referral } from "@/components/ward-management/ward-model";
 
 const NOW = NOW_ANCHOR;
 const unit = allUnits()[0]!;
@@ -98,6 +98,67 @@ describe("expectedOccupancy", () => {
     expect(withHold.rows[0]!.horizons[0]!.high).toBe(without.rows[0]!.horizons[0]!.high + 1);
   });
 
+  it("counts a booked person who already holds a named bed here once, not twice (Josh, 11 Nov 2026)", () => {
+    const booking = {
+      id: "PA-OC-HOLD",
+      unitId: unit.id,
+      patientId: "PT-OC-HOLD",
+      state: "booked",
+      expectedArrivalAt: NOW + 60,
+    } as unknown as PlannedAdmission;
+    const journey = {
+      id: "WF-OC-HOLD-BOOKED",
+      patientId: "PT-OC-HOLD",
+      stage: "accepted_awaiting_bed",
+      acceptedUnitId: unit.id,
+      heldBedNumber: 1,
+    } as unknown as Movement;
+    const referral = {
+      id: "RF-OC-HOLD-BOOKED",
+      patientId: "PT-OC-HOLD",
+      destinations: [
+        { state: "accepted", destination: { kind: "psychiatric_ward", unitId: unit.id }, heldBedNumber: 2 },
+      ],
+    } as unknown as Referral;
+    const empty = expectedOccupancy([unit], [], [] as Admission[], NOW);
+    for (const hold of [journey, referral]) {
+      const held = expectedOccupancy([unit], [], [] as Admission[], NOW, [booking], [hold]);
+      // The hold is in takenNow already; the booking for the same person adds nothing more.
+      expect(held.rows[0]!.takenNow).toBe(empty.rows[0]!.takenNow + 1);
+      for (const [index, horizon] of held.rows[0]!.horizons.entries()) {
+        expect(horizon.likely).toBe(empty.rows[0]!.horizons[index]!.likely + 1);
+        expect(horizon.high).toBe(empty.rows[0]!.horizons[index]!.high + 1);
+      }
+    }
+    // A booking for someone else still counts.
+    const other = { ...booking, id: "PA-OC-OTHER", patientId: "PT-OC-OTHER" } as PlannedAdmission;
+    const both = expectedOccupancy([unit], [], [] as Admission[], NOW, [booking, other], [journey]);
+    expect(both.rows[0]!.horizons[0]!.likely).toBe(empty.rows[0]!.horizons[0]!.likely + 2);
+  });
+
+  it("the network forecast does not count a named referral hold and its booking twice", () => {
+    const booking = {
+      id: "PA-NET-HOLD",
+      unitId: unit.id,
+      patientId: "PT-NET-HOLD",
+      state: "booked",
+      expectedArrivalAt: NOW + 60,
+    } as unknown as PlannedAdmission;
+    const referral = {
+      id: "RF-NET-HOLD",
+      patientId: "PT-NET-HOLD",
+      destinations: [
+        { state: "accepted", destination: { kind: "psychiatric_ward", unitId: unit.id }, heldBedNumber: 2 },
+      ],
+    } as unknown as Referral;
+    const without = bedsForecast([unit], [], [], [], NOW, [booking]);
+    const held = bedsForecast([unit], [], [], [], NOW, [booking], [referral]);
+    expect(without.horizons[0]!.plannedAdmissions).toBe(1);
+    expect(held.horizons[0]!.plannedAdmissions).toBe(0);
+    // One person, one bed: Ready drops by the hold, and the booking no longer takes another.
+    expect(held.horizons[0]!.readyNow).toBe(without.horizons[0]!.readyNow - 1);
+  });
+
   it("says a percentage, or Not recorded with no beds", () => {
     expect(occupancyPercent(18, 20)).toBe("90%");
     expect(occupancyPercent(21, 20)).toBe("105%");
diff --git a/tests/ward-patient-link-default-deny.test.ts b/tests/ward-patient-link-default-deny.test.ts
index 45d0ef145..53d578f9d 100644
--- a/tests/ward-patient-link-default-deny.test.ts
+++ b/tests/ward-patient-link-default-deny.test.ts
@@ -432,7 +432,8 @@ const ALLOWLIST: ReadonlyArray<{ file: string; reason: string }> = [
       "the Admission it creates. BOOK checks that patientId exists in state.patients and refuses a " +
       "second waiting booking or a person who holds a pulled or occupied stay; CONVERT refuses when " +
       "that person holds such a stay or is on an open movement; the forecast helper drops a linked " +
-      "booking already counted through a waiting movement. Each is a yes/no on ids: reads compare ids " +
+      "booking already counted through a waiting movement or through a bed that person already holds by number " +
+      "(Josh, 11 Nov 2026, D-145). Each is a yes/no on ids: reads compare ids " +
       "only, write state, render nothing and disclose no other stay, movement or referral.",
   },
   {