From e6f2b816b10d5e79a1c448ee045400ba8364b841 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 03:59:42 +0000
Subject: [PATCH 01/40] Record D-144: repository review fixes, features and
 code health approved

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/decisions.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/ward-flow/decisions.md b/docs/ward-flow/decisions.md
index 015b6e31a..1ef6a739c 100644
--- a/docs/ward-flow/decisions.md
+++ b/docs/ward-flow/decisions.md
@@ -156,6 +156,7 @@ Checked 9 November 2026 (D-107 audit). "Partly replaced" means part of the entry
 | [D-131](#d-131-hard-case-demo-data-allowed-and-the-movement-diagram-follows-the-engine-10-november-2026)                                                | Hard-case demo data allowed, and the movement diagram follows the engine               | Active                                           |
 | [D-132](#d-132-audit-fixes-group-1-docs-and-ci-guards-10-november-2026)                                                                                 | Audit fixes group 1: docs and CI guards; Claude-authored sensitive changes warn        | Active                                           |
 | [D-138](#d-138-phone-alert-urgency-by-kind-10-november-2026)                                                                                            | Phone alert urgency by kind                                                            | Active                                           |
+| [D-144](#d-144-repository-review-fixes-features-and-code-health-approved-11-november-2026)                                                              | Repository review: fixes, features and code health approved                            | Active                                           |
 
 ---
 
@@ -1699,3 +1700,15 @@ is inferred.
 - **Date:** 10 November 2026 (`2026-11-10`). **Decided by:** Josh, picking item 23 of the audit fix build plan (Ward Flow project thread "Fix audit app and backend issues", audit fix group 2), which counts as his yes to audit decision 20. Numbered D-138 because D-132 to D-137 belong to other threads. D-133 is claimed by open PR #1606. D-134 is claimed by open PR #1608, and D-135 is claimed by open PR #1603, and D-136 is claimed by open PR #1605, and D-137 is claimed by open PR #1607. On 11 November 2026 Josh told every thread to go ahead with its recommendations, which approved the Settings line as drawn in the design review.
 - **Decision:** act-now phone alerts stay high urgency and buzz again when replaced. Jobs and team alerts go out at normal urgency and replace their earlier alert quietly. Settings shows when this device last received an alert, from the time only (never the alert's words).
 - **Boundary:** synthetic data only. Changes no signed clinical value or clinical rule, and approves no merge or release.
+
+## D-144. Repository review: fixes, features and code health approved (11 November 2026)
+
+- **Date:** 11 November 2026 (`2026-11-11`). **Decided by:** Josh, in the Ward Flow project thread "Review repository for issues and new features": "Go ahead with all these recommendations please" (03:55 UTC), answering the review doc "Ward Flow repository review, 11 November 2026". Numbered D-144 because D-133 to D-143 belong to other threads. D-139 is claimed by open PR #1600, D-140 is claimed by open PR #1606, D-141 is claimed by open PR #1606, D-142 is claimed by open PR #1603, and D-143 is claimed by open PR #1612.
+- **Decision:**
+  1. **Clinical display fixes, one held PR:** a ward's expected occupancy no longer counts a patient twice when they hold a named bed and also have a booked planned admission to that ward; an ended legal form says it ended and gives the expiry only as it was typed; the ED screen flags a long wait at 24 hours or more, like every other screen. The held PR is shared with the performance thread's triage date fix.
+  2. **Non-clinical fixes:** one lapse check for pull holds, staff requests keep the shift the person chose, one reader for typed times, one length-of-stay calculation, a demo code shorter than 12 characters counts as no code, and a demo pass stops working when the code changes. Two lines added to the real-data go/no-go list (record ids never built from UMRNs; a check of the push library).
+  3. **Features that finish existing screens** (not covered by the D-128 item 9 pause): Leave page links, print and entry point; Help for pages that had none; print and spreadsheet export on Legal forms and Movements. Triage risk reviews due waits until #1564 to #1577 close and needs its own clinical sign-off.
+  4. **Code health:** the file line cap counts code lines, not comments or blank lines; one shared CI setup step; shared helpers for the forked side rail; reasons or fixes for unexplained React hook rule switch-offs; patch-level dependency updates.
+  5. **Josh's own action:** turn off Supabase open sign-up before real data.
+- **Why:** findings from the 11 November review, each checked against source; the clinical items were display bugs, not changes to signed values.
+- **Boundary:** synthetic data only. Changes no signed clinical value; clinical items merge only after Josh checks the held PR. Approves no release.

From 7faea5d2f271ad76e1fe6c2359bfdc74e947a4f7 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:00:49 +0000
Subject: [PATCH 02/40] Count only code lines for the max-lines cap (D-144)

Blank lines and comment-only lines no longer count towards the file size
cap, so commits stop deleting spacing and safety comments to fit. The
per-file caps are re-set in code lines with the headroom each file already
had; five files are now under the default and come off the list. The
baseline test counts lines with ESLint's own rule, so it matches the lint.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 eslint-rules/max-lines-baseline.mjs | 25 ++++++++++--------
 eslint.config.mjs                   |  9 ++++---
 tests/max-lines-baseline.test.ts    | 40 ++++++++++++++++++++++++-----
 3 files changed, 53 insertions(+), 21 deletions(-)

diff --git a/eslint-rules/max-lines-baseline.mjs b/eslint-rules/max-lines-baseline.mjs
index 8e8dcc8a3..22b4deeaa 100644
--- a/eslint-rules/max-lines-baseline.mjs
+++ b/eslint-rules/max-lines-baseline.mjs
@@ -28,19 +28,22 @@
 // 10 Nov 2026 (Tier 7 audit A5-05): the cap now covers the backend's source files too. postgres.mjs
 // was split by area into workspace-*.mjs; its remaining core (the record cache, reads, saves,
 // archive and the command path) gets a cap of its size plus about 150 lines.
+// 11 Nov 2026 (D-144, Josh approved): the cap counts code lines only. Blank lines and comment-only
+// lines no longer count (MAX_LINES_COUNTING), so nobody deletes spacing or safety comments to fit.
+// The caps were in raw lines; each is now re-set to the file's code lines plus the same
+// headroom it had under raw counting, so no file gains room to grow. ward-model, ward-movements,
+// ward-flow-events, ward-patients-seed and postgres.mjs are under the default in code lines and
+// came off the list.
 export const MAX_LINES_DEFAULT = 1500;
 export const MAX_LINES_HEADROOM = 300;
+// ESLint max-lines options shared by eslint.config.mjs and tests/max-lines-baseline.test.ts.
+export const MAX_LINES_COUNTING = { skipBlankLines: true, skipComments: true };
 
 export const MAX_LINES_BASELINE = {
-  "src/components/ward-management/ward-flow-reducer.ts": 2560,
-  "src/components/ward-management/ward/ward-screen.tsx": 2580,
-  "src/components/ward-management/ward-model.ts": 1900,
-  "src/components/ward-management/ward-movements.ts": 2070,
-  "src/components/ward-management/ward-flow-events.ts": 2750,
-  "src/components/ward-management/coordinator/shortlist-panel.tsx": 2850,
-  "src/components/ward-management/movements/movement-workspace-cockpit.tsx": 2150,
-  "src/components/ward-management/ward/ward-home-tab.tsx": 2150,
-  "src/components/ward-management/ward-patients-seed.ts": 1800,
-  "src/components/ward-management/ward/ward-answer-view.tsx": 1750,
-  "backend/ward-flow/postgres.mjs": 1860,
+  "src/components/ward-management/ward-flow-reducer.ts": 1854,
+  "src/components/ward-management/ward/ward-screen.tsx": 2174,
+  "src/components/ward-management/coordinator/shortlist-panel.tsx": 2256,
+  "src/components/ward-management/movements/movement-workspace-cockpit.tsx": 2059,
+  "src/components/ward-management/ward/ward-home-tab.tsx": 1991,
+  "src/components/ward-management/ward/ward-answer-view.tsx": 1630,
 };
diff --git a/eslint.config.mjs b/eslint.config.mjs
index 458f55917..fb5c718ef 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -7,7 +7,7 @@ import requireButtonWiring from "./eslint-rules/require-button-wiring.mjs";
 import requireZIndexLadder from "./eslint-rules/require-z-index-ladder.mjs";
 import restrictSuppressHydrationWarning from "./eslint-rules/restrict-suppress-hydration-warning.mjs";
 import noHardcodedHex from "./eslint-rules/no-hardcoded-hex.mjs";
-import { MAX_LINES_BASELINE, MAX_LINES_DEFAULT } from "./eslint-rules/max-lines-baseline.mjs";
+import { MAX_LINES_BASELINE, MAX_LINES_COUNTING, MAX_LINES_DEFAULT } from "./eslint-rules/max-lines-baseline.mjs";
 
 // Shared `local` plugin object. ESLint flat config requires every config block
 // that references a plugin namespace to point at the *same* object, and the five
@@ -179,10 +179,11 @@ const eslintConfig = defineConfig([
   },
   // File size ratchet. New source files stay under MAX_LINES_DEFAULT lines, and the files that
   // were already larger cannot grow much past their baseline (eslint-rules/max-lines-baseline.mjs).
+  // Only code lines count: blank lines and comment-only lines are free (MAX_LINES_COUNTING, D-144).
   {
     files: ["src/**/*.{ts,tsx}"],
     rules: {
-      "max-lines": ["error", { max: MAX_LINES_DEFAULT }],
+      "max-lines": ["error", { ...MAX_LINES_COUNTING, max: MAX_LINES_DEFAULT }],
     },
   },
   // The backend's source files too (Tier 7 audit A5-05); its tests are left out, as src's are.
@@ -190,13 +191,13 @@ const eslintConfig = defineConfig([
     files: ["backend/ward-flow/*.mjs"],
     ignores: ["backend/ward-flow/*.test.mjs", "backend/ward-flow/*.test-support.mjs"],
     rules: {
-      "max-lines": ["error", { max: MAX_LINES_DEFAULT }],
+      "max-lines": ["error", { ...MAX_LINES_COUNTING, max: MAX_LINES_DEFAULT }],
     },
   },
   ...Object.entries(MAX_LINES_BASELINE).map(([file, max]) => ({
     files: [file],
     rules: {
-      "max-lines": ["error", { max }],
+      "max-lines": ["error", { ...MAX_LINES_COUNTING, max }],
     },
   })),
   // A lucide-react icon rendered as JSX must be decorative (aria-hidden) or
diff --git a/tests/max-lines-baseline.test.ts b/tests/max-lines-baseline.test.ts
index 63cd7016e..d99d1c37e 100644
--- a/tests/max-lines-baseline.test.ts
+++ b/tests/max-lines-baseline.test.ts
@@ -1,11 +1,39 @@
-import { readFileSync } from "node:fs";
-import { describe, expect, it } from "vitest";
-import { MAX_LINES_BASELINE, MAX_LINES_DEFAULT, MAX_LINES_HEADROOM } from "../eslint-rules/max-lines-baseline.mjs";
+import { ESLint } from "eslint";
+import { beforeAll, describe, expect, it } from "vitest";
+import {
+  MAX_LINES_BASELINE,
+  MAX_LINES_COUNTING,
+  MAX_LINES_DEFAULT,
+  MAX_LINES_HEADROOM,
+} from "../eslint-rules/max-lines-baseline.mjs";
 
-const lineCount = (file: string) => readFileSync(file, "utf8").split("\n").length;
+// Count lines the way the lint cap does (code lines only, D-144): run ESLint's own max-lines rule
+// with a cap of 0 on each listed file and read the line count from its message.
+async function codeLineCounts(files: string[]) {
+  const eslint = new ESLint({
+    cwd: process.cwd(),
+    cache: false,
+    ruleFilter: ({ ruleId }) => ruleId === "max-lines",
+    overrideConfig: { rules: { "max-lines": ["error", { ...MAX_LINES_COUNTING, max: 0 }] } },
+  });
+  const counts = new Map<string, number>();
+  for (const result of await eslint.lintFiles(files)) {
+    const message = result.messages.find((m) => m.ruleId === "max-lines");
+    const count = Number(message?.message.match(/\((\d+)\)/)?.[1]);
+    if (!Number.isInteger(count)) throw new Error(`no max-lines count for ${result.filePath}`);
+    counts.set(files.find((file) => result.filePath.endsWith(file)) ?? result.filePath, count);
+  }
+  return counts;
+}
 
 describe("file size caps follow the files down", () => {
   const entries = Object.entries(MAX_LINES_BASELINE) as [string, number][];
+  let lineCount: (file: string) => number;
+
+  beforeAll(async () => {
+    const counts = await codeLineCounts(entries.map(([file]) => file));
+    lineCount = (file) => counts.get(file) ?? Number.NaN;
+  }, 60_000);
 
   it("keeps an entry only for a file still over the default cap", () => {
     const backUnder = entries.filter(([file]) => lineCount(file) <= MAX_LINES_DEFAULT).map(([file]) => file);
@@ -14,8 +42,8 @@ describe("file size caps follow the files down", () => {
 
   it("keeps each cap within the headroom of its file", () => {
     const loose = entries
-      .filter(([file, cap]) => cap - lineCount(file) > MAX_LINES_HEADROOM)
-      .map(([file, cap]) => `${file}: cap ${cap}, file ${lineCount(file)} lines`);
+      .filter(([file, cap]) => !(cap - lineCount(file) <= MAX_LINES_HEADROOM))
+      .map(([file, cap]) => `${file}: cap ${cap}, file ${lineCount(file)} code lines`);
     expect(loose, "lower these caps in eslint-rules/max-lines-baseline.mjs").toEqual([]);
   });
 });

From c9361c3741d5c2dd1c314ea2ba33a24a183b7b15 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:01:09 +0000
Subject: [PATCH 03/40] D-144: drop the shared triage date note (already fixed
 on main by #1599)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/decisions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ward-flow/decisions.md b/docs/ward-flow/decisions.md
index 1ef6a739c..c1c659528 100644
--- a/docs/ward-flow/decisions.md
+++ b/docs/ward-flow/decisions.md
@@ -1705,7 +1705,7 @@ is inferred.
 
 - **Date:** 11 November 2026 (`2026-11-11`). **Decided by:** Josh, in the Ward Flow project thread "Review repository for issues and new features": "Go ahead with all these recommendations please" (03:55 UTC), answering the review doc "Ward Flow repository review, 11 November 2026". Numbered D-144 because D-133 to D-143 belong to other threads. D-139 is claimed by open PR #1600, D-140 is claimed by open PR #1606, D-141 is claimed by open PR #1606, D-142 is claimed by open PR #1603, and D-143 is claimed by open PR #1612.
 - **Decision:**
-  1. **Clinical display fixes, one held PR:** a ward's expected occupancy no longer counts a patient twice when they hold a named bed and also have a booked planned admission to that ward; an ended legal form says it ended and gives the expiry only as it was typed; the ED screen flags a long wait at 24 hours or more, like every other screen. The held PR is shared with the performance thread's triage date fix.
+  1. **Clinical display fixes, one held PR:** a ward's expected occupancy no longer counts a patient twice when they hold a named bed and also have a booked planned admission to that ward; an ended legal form says it ended and gives the expiry only as it was typed; the ED screen flags a long wait at 24 hours or more, like every other screen.
   2. **Non-clinical fixes:** one lapse check for pull holds, staff requests keep the shift the person chose, one reader for typed times, one length-of-stay calculation, a demo code shorter than 12 characters counts as no code, and a demo pass stops working when the code changes. Two lines added to the real-data go/no-go list (record ids never built from UMRNs; a check of the push library).
   3. **Features that finish existing screens** (not covered by the D-128 item 9 pause): Leave page links, print and entry point; Help for pages that had none; print and spreadsheet export on Legal forms and Movements. Triage risk reviews due waits until #1564 to #1577 close and needs its own clinical sign-off.
   4. **Code health:** the file line cap counts code lines, not comments or blank lines; one shared CI setup step; shared helpers for the forked side rail; reasons or fixes for unexplained React hook rule switch-offs; patch-level dependency updates.

From dd75187d213a7747b2e5d85d818425545e138789 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:02:17 +0000
Subject: [PATCH 04/40] Give every React hook rule switch-off its reason after
 "--" (M145)

The 13 react-hooks/exhaustive-deps switch-offs whose reason sat on the line
above now carry it on the directive, naming the dependencies left out. Each
effect is deliberately once-only or keyed on a token, so adding the missing
dependencies would change when it runs; none is removed. Comments only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../ward-management/ed/use-ed-screen-decline.ts          | 4 +---
 .../ward-management/front-door/use-front-door-auth.ts    | 3 +--
 src/components/ward-management/patients/add-patient.tsx  | 9 +++------
 .../ward-management/referrals/referral-draft-hooks.ts    | 3 +--
 .../referrals/referral-information-needs-lazy.tsx        | 3 +--
 .../restrictive-practice/seclusion-forms-view.tsx        | 3 +--
 src/components/ward-management/use-undoable-step.ts      | 3 +--
 src/components/ward-management/ward/ward-screen.tsx      | 9 +++------
 src/components/ward-management/ward/ward-walk-round.tsx  | 3 +--
 9 files changed, 13 insertions(+), 27 deletions(-)

diff --git a/src/components/ward-management/ed/use-ed-screen-decline.ts b/src/components/ward-management/ed/use-ed-screen-decline.ts
index 49876ca24..c7584ffc4 100644
--- a/src/components/ward-management/ed/use-ed-screen-decline.ts
+++ b/src/components/ward-management/ed/use-ed-screen-decline.ts
@@ -112,9 +112,7 @@ export function useEdInboxDecline({
     }
     pendingDeclineRef.current = undefined;
     priorRejectionCountRef.current = rejections.length;
-    // `offerStep` is read at the moment the check runs; the check itself is keyed
-    // on the dispatch token so it runs once per decline.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `offerStep` is read when the check runs; the check is keyed on the dispatch token so it runs once per decline.
   }, [rejections, declineCheckToken]);
 
   function toggleDecline(referralId: string) {
diff --git a/src/components/ward-management/front-door/use-front-door-auth.ts b/src/components/ward-management/front-door/use-front-door-auth.ts
index 532f3b2a3..de50c3172 100644
--- a/src/components/ward-management/front-door/use-front-door-auth.ts
+++ b/src/components/ward-management/front-door/use-front-door-auth.ts
@@ -128,8 +128,7 @@ export function useFrontDoorAuth(next: string): { phase: Phase; form: WardCreden
       auth.current?.dispose();
       auth.current = null;
     };
-    // `next` is fixed for the page's life: the server read it from the address.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- Once per page: `open` closes over `next`, which is fixed for the page's life (the server read it from the address).
   }, []);
 
   const run = async (step: (adapter: WardBrowserAuthAdapter) => Promise<void>) => {
diff --git a/src/components/ward-management/patients/add-patient.tsx b/src/components/ward-management/patients/add-patient.tsx
index 6f54c0a5c..fc6961d47 100644
--- a/src/components/ward-management/patients/add-patient.tsx
+++ b/src/components/ward-management/patients/add-patient.tsx
@@ -312,8 +312,7 @@ export function AddPatientForm() {
       return input instanceof HTMLInputElement && input.value === "";
     });
     if (first) document.getElementById(`ward-add-patient-${first}`)?.focus();
-    // Only once, on open: later renders never take the cursor away from where someone put it.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- Only once, on open (`isPhone` as first rendered): later renders never take the cursor away from where someone put it.
   }, []);
   const priorSubmissionRef = useRef<{
     patients: typeof patients;
@@ -525,8 +524,7 @@ export function AddPatientForm() {
       return;
     }
     router.push(patientHref(added.id));
-    // findAdded reads `patients`, which is listed.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `findAdded` reads `patients`, which is listed; `findAdded` and `formSnapshot` are new each render and read this render's form.
   }, [acceptedSubmission, patients, worldGeneration, router, toast, isDirty]);
 
   // Latest values for the outside-view timer, which must not restart on every snapshot.
@@ -561,8 +559,7 @@ export function AddPatientForm() {
       toast?.push({ tone: "success", title: saved, body: note });
     }, SHARED_REFRESH_MS);
     return () => window.clearTimeout(timer);
-    // clearForm and finishSubmission only set state; the timer starts once per accepted save.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `clearForm` and `finishSubmission` only set state; the timer starts once per accepted save.
   }, [acceptedSubmission, worldGeneration, toast]);
 
   function handleSubmit(event: FormEvent<HTMLFormElement>) {
diff --git a/src/components/ward-management/referrals/referral-draft-hooks.ts b/src/components/ward-management/referrals/referral-draft-hooks.ts
index a21a5559c..2c58d2d36 100644
--- a/src/components/ward-management/referrals/referral-draft-hooks.ts
+++ b/src/components/ward-management/referrals/referral-draft-hooks.ts
@@ -171,8 +171,7 @@ export function useReferralDraftAutosave<T>({
         keepReferralDraft(current.draft, ownerVersion, current.storageKey);
       }
     },
-    // `reopened` is fixed for the sheet's life.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- Unmount only: `reopened`, `ownerVersion` and `sessionOwner` are fixed for the sheet's life.
     [],
   );
 
diff --git a/src/components/ward-management/referrals/referral-information-needs-lazy.tsx b/src/components/ward-management/referrals/referral-information-needs-lazy.tsx
index cbc611935..14e1616c7 100644
--- a/src/components/ward-management/referrals/referral-information-needs-lazy.tsx
+++ b/src/components/ward-management/referrals/referral-information-needs-lazy.tsx
@@ -84,7 +84,6 @@ export function useMarkReferralsOpened(
         if (outcome && outcome.status !== "accepted") forget();
       }, forget);
     }
-    // `raise` carries the time a referral first appears; a clock tick alone does not re-run this.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `raise` carries the time a referral first appears; a clock tick alone does not re-run this.
   }, [enabled, routeRole, actingUnitId, unitId, unopened]);
 }
diff --git a/src/components/ward-management/restrictive-practice/seclusion-forms-view.tsx b/src/components/ward-management/restrictive-practice/seclusion-forms-view.tsx
index 535c1a986..56db2bb38 100644
--- a/src/components/ward-management/restrictive-practice/seclusion-forms-view.tsx
+++ b/src/components/ward-management/restrictive-practice/seclusion-forms-view.tsx
@@ -198,8 +198,7 @@ export function SeclusionFormsView({
     const list = roomsRef.current;
     list?.scrollIntoView?.({ block: "start", behavior: "smooth" });
     list?.querySelector<HTMLButtonElement>("button")?.focus({ preventScroll: true });
-    // Only a new ask moves focus; the rooms list changing under it does not.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- Only a new ask (`ask.n`) moves focus; the rooms list or `onAskSeen` changing under it does not.
   }, [ask?.n]);
   // Ward desks cannot open Governance, so the last day's incidents stay readable here.
   const seesGovernance = ROLE_SCREENS[access.role].governance !== undefined;
diff --git a/src/components/ward-management/use-undoable-step.ts b/src/components/ward-management/use-undoable-step.ts
index 5638f9251..c8ca9fb08 100644
--- a/src/components/ward-management/use-undoable-step.ts
+++ b/src/components/ward-management/use-undoable-step.ts
@@ -264,8 +264,7 @@ export function useUndoableStep({
             }),
       });
     }
-    // The token drives this; `sink`, `dispatch` and the callbacks are read as they are now.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- The token drives this; `sink`, `routeRole` and the callbacks are read as they are now.
   }, [token, rejections]);
 
   function submit(event: WardFlowEvent, pending: Pending, record?: () => ReturnType<WardCommandDispatch>) {
diff --git a/src/components/ward-management/ward/ward-screen.tsx b/src/components/ward-management/ward/ward-screen.tsx
index 171451b97..7725eb952 100644
--- a/src/components/ward-management/ward/ward-screen.tsx
+++ b/src/components/ward-management/ward/ward-screen.tsx
@@ -563,8 +563,7 @@ function WardOverviewScreen({ unitId, presentation = "overview", departurePlanni
             },
           }),
     });
-    // `toast`, `routeRole`, `dispatch` and `unitId` are stable for the screen's life; the token drives this.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `toast`, `routeRole`, `dispatch` and `unitId` are stable for the screen's life and the command helpers are read as they are now; the token drives this.
   }, [dischargeToken, rejections]);
 
   // Board feedback follows this command, including its Undo.
@@ -670,8 +669,7 @@ function WardOverviewScreen({ unitId, presentation = "overview", departurePlanni
             }),
       });
     }
-    // `toast`, `routeRole` and `dispatch` are stable for the screen's life; the token drives this.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `toast`, `routeRole` and `dispatch` are stable for the screen's life and the command helpers are read as they are now; the token drives this.
   }, [boardToken, rejections]);
 
   useEffect(() => {
@@ -936,8 +934,7 @@ function WardOverviewScreen({ unitId, presentation = "overview", departurePlanni
             }),
       });
     }
-    // Read the committed local fallback only after this command's completion.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- Runs once per command completion (the token); `movements` and the helpers are read as committed then, not on every change.
   }, [rejections, checkToken]);
 
   const { pendingBedReleases, unitLeaveBeds, incoming, accepted, heldAfterStop, recentAnswers, withdrawn } =
diff --git a/src/components/ward-management/ward/ward-walk-round.tsx b/src/components/ward-management/ward/ward-walk-round.tsx
index 4c4f28d40..0384aad52 100644
--- a/src/components/ward-management/ward/ward-walk-round.tsx
+++ b/src/components/ward-management/ward/ward-walk-round.tsx
@@ -261,8 +261,7 @@ export function WardWalkRound({
       }
       if (was !== undefined) headRef.current?.querySelector<HTMLButtonElement>("[data-walk-start]")?.focus();
     }
-    // Only a change of bed speaks; `allReviewed` is read as it is at that moment.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- Only a change of bed speaks; `allReviewed` is read as it is at that moment.
   }, [currentNumber]);
 
   // Integration QA (3 Nov 2026): Escape closes the card like the close button, and the effect

From 2f7fff63741014e872706256b7dd11adba672b93 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:06:24 +0000
Subject: [PATCH 05/40] Share the side rail's pure helpers across its three
 copies

sentenceStart, viewingDeskLine, formatMinuteOfDay, minutesFrom,
computeShiftProgress and the ShiftProgress shape were copied identically
into ward-rail.tsx, next-rail-body.tsx and preview-rail-body.tsx (only a
doc comment differed). They now live once in shell/ward-rail-helpers.ts.
No markup, styles or wording change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../shell-next/next-rail-body.tsx             | 131 +-----------------
 .../shell/ward-rail-helpers.ts                | 130 +++++++++++++++++
 .../ward-management/shell/ward-rail.tsx       | 131 +-----------------
 .../ward-redesign/shell/preview-rail-body.tsx | 131 +-----------------
 tests/ward-service-bed-alerts.test.ts         |   2 +-
 tests/ward-shell-third-edition.dom.test.tsx   |   2 +-
 tests/ward-shift-rule-agreement.test.ts       |   2 +-
 7 files changed, 148 insertions(+), 381 deletions(-)
 create mode 100644 src/components/ward-management/shell/ward-rail-helpers.ts

diff --git a/src/components/ward-management/shell-next/next-rail-body.tsx b/src/components/ward-management/shell-next/next-rail-body.tsx
index 2f4e894ac..0ba40a44b 100644
--- a/src/components/ward-management/shell-next/next-rail-body.tsx
+++ b/src/components/ward-management/shell-next/next-rail-body.tsx
@@ -24,14 +24,11 @@ import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from "
 import { Sheet } from "@/components/wf/sheet";
 import { Tooltip } from "@/components/wf/tooltip";
 import { OperatorSwitcherModal } from "@/components/ward-management/settings/operator-switcher-modal-lazy";
-import { communityTeamById } from "@/components/ward-management/community/community-derivations";
 import { useShellPersonaRole } from "@/components/ward-management/settings/persona-sync";
 import { useSettingsDeskProfile } from "@/components/ward-management/settings/settings-desk-profile";
-import { currentDeskId } from "@/components/ward-management/settings/workstation-desks";
 import { useNextNavCounts } from "@/components/ward-management/shell-next/next-nav-counts";
 import { formatInstant, minuteOfDay } from "@/components/ward-management/ward-clock";
 import { requestToolsTool } from "@/components/ward-management/tools/ward-tools-open";
-import { CHROME_ROLE_LABELS, wardChromeRole, type WardChromeRole } from "@/components/ward-management/ward-chrome-role";
 import {
   ACCESS_ADMIN_PERSONA,
   DESK_PERSONAS,
@@ -41,14 +38,14 @@ import {
 import { useDeskRoleLabel, useEffectiveWardAccess } from "@/components/ward-management/shell/ward-access-store";
 import { useWardFlowClock, useWardFlowSelect, useWardNetwork } from "@/components/ward-management/ward-flow-provider";
 import type { HealthService } from "@/components/ward-management/ward-model";
-import { edById } from "@/components/ward-management/ward-sites";
 import { WARD_CAPACITY_HREF, WARD_REFERRAL_INTAKE_HREF } from "@/components/ward-management/ward-nav";
 import { wardNavCountLabel } from "@/components/ward-management/ward-nav-counts";
+import { OPERATIONAL_DEFAULT_LABEL } from "@/components/ward-management/ward-operational-defaults";
 import {
-  HANDOVER_DUE_PROMPT_MINUTES,
-  OPERATIONAL_DEFAULT_LABEL,
-} from "@/components/ward-management/ward-operational-defaults";
-import { shiftAtMinute } from "@/components/ward-management/ward-board-time-features";
+  computeShiftProgress,
+  sentenceStart,
+  viewingDeskLine,
+} from "@/components/ward-management/shell/ward-rail-helpers";
 import { Dot, SrOnly, durMinutes, useIsPhone } from "@/components/wf";
 import { setGlarePreference, setThemePreference } from "@/lib/theme-client";
 import {
@@ -209,11 +206,6 @@ function getTabletLandscapeSnapshot() {
   );
 }
 
-/** "at a time limit…" → "At a time limit…", for the closed rail's hover card. */
-function sentenceStart(text: string): string {
-  return text.length === 0 ? text : text.charAt(0).toUpperCase() + text.slice(1);
-}
-
 // UX audit (21 Oct 2026): the same four themes as Settings, Display (settings-15 made Glare a fourth).
 const APPEARANCE_CHOICES = [
   { id: "auto", label: "Auto" },
@@ -236,34 +228,6 @@ function chooseAppearance(next: AppearanceChoice) {
   announceToWardShell(`Appearance set to ${next}.`);
 }
 
-/**
- * The desk a page belongs to, when it is not the person's own kind of desk: "Viewing RPH ED as Bed
- * coordinator". Null on the person's own kind of desk and on every network page. Place names only,
- * never a patient.
- */
-function viewingDeskLine(
-  pathname: string,
-  personaRole: WardChromeRole,
-  units: readonly { id: string; name: string }[],
-  personaLabel: string,
-): string | null {
-  const pageRole = wardChromeRole(pathname);
-  if (pageRole === "coordinator" || pageRole === personaRole) return null;
-  const deskId = currentDeskId(pathname);
-  const place =
-    pageRole === "ed"
-      ? `${(deskId ? edById(deskId)?.siteCode : undefined) ?? "this"} ED`
-      : pageRole === "ward"
-        ? (units.find((unit) => unit.id === deskId)?.name ?? "this ward")
-        : pageRole === "officer"
-          ? "the transport desk"
-          : pageRole === "community"
-            ? // PR #489 review: the team by name when its page names one; the index has none.
-              ((deskId ? communityTeamById(deskId)?.name : undefined) ?? "a community team")
-            : CHROME_ROLE_LABELS[pageRole];
-  return `Viewing ${place} as ${personaLabel}`;
-}
-
 /**
  * Retained for the layout's existing call shape. The reconciliation line this used to feed is no
  * longer mounted in the rail (Josh, 7 October 2026), so the rail takes no props today.
@@ -1413,88 +1377,3 @@ export function NextRailBody({ onOpenOperatorModal }: WardRailProps = {}) {
     </WardRailFrame>
   );
 }
-
-export interface ShiftProgress {
-  shiftTitle: string;
-  /** "Day shift": the pattern's name in sentence case. */
-  shiftName: string;
-  /** "07:00–15:00": clock times, so colons are right here. */
-  shiftHours: string;
-  elapsedHours: number;
-  elapsedMins: number;
-  percent: number;
-  /** Minutes until the shift ends. */
-  remainingMinutes: number;
-  /** True inside the last 15 minutes of the shift. */
-  handoverDue: boolean;
-  countdownStr: string;
-  dashOffset: number;
-}
-
-/** "07:00" from a minute-of-day figure — used only to word `SHIFT_PATTERN`'s own entries. */
-function formatMinuteOfDay(minute: number): string {
-  const hours = Math.floor(minute / 60);
-  const mins = minute % 60;
-  return `${String(hours).padStart(2, "0")}:${String(mins).padStart(2, "0")}`;
-}
-
-/** Minutes from `from` to `to`, wrapping through midnight when `to` is earlier in the day. */
-function minutesFrom(from: number, to: number): number {
-  return (((to - from) % 1440) + 1440) % 1440;
-}
-
-export function computeShiftProgress(nowInput?: number | Date): ShiftProgress {
-  const CIRCUMFERENCE = 81.68;
-
-  let currentMinute: number;
-  if (typeof nowInput === "number") {
-    // Normalise minute of day 0..1439
-    currentMinute = ((nowInput % 1440) + 1440) % 1440;
-  } else {
-    const d = nowInput instanceof Date ? nowInput : new Date();
-    // AWST is UTC+8
-    const awstHours = (d.getUTCHours() + 8) % 24;
-    const awstMins = d.getUTCMinutes();
-    currentMinute = awstHours * 60 + awstMins;
-  }
-
-  // The shift pattern itself (07:00/15:00/23:00) is a labelled default, not a legal roster rule —
-  // owner ruling 26 September 2026 (decisions.md D-22) — read from `SHIFT_PATTERN` through `shiftAtMinute` (the rule `currentShift` uses too), never
-  // hand-typed here, so the one figure and its three titles cannot drift apart.
-  const shift = shiftAtMinute(currentMinute);
-
-  const shiftHours = `${formatMinuteOfDay(shift.startMinute)}–${formatMinuteOfDay(shift.endMinute)}`;
-  const shiftTitle = `${shift.name} (${shiftHours})`;
-  const shiftName = shift.name.charAt(0) + shift.name.slice(1).toLowerCase();
-  const shiftDuration = minutesFrom(shift.startMinute, shift.endMinute);
-  const elapsedTotal = minutesFrom(shift.startMinute, currentMinute);
-  const remainingTotal = shiftDuration - elapsedTotal;
-
-  const elapsedHours = Math.floor(elapsedTotal / 60);
-  const elapsedMins = elapsedTotal % 60;
-  const percent = Math.min(100, Math.max(0, Math.round((elapsedTotal / shiftDuration) * 100)));
-  const dashOffset = Number((CIRCUMFERENCE * (1 - percent / 100)).toFixed(2));
-  const handoverDue = remainingTotal <= HANDOVER_DUE_PROMPT_MINUTES;
-
-  let countdownStr: string;
-  if (handoverDue) {
-    countdownStr = "Handover Due";
-  } else {
-    const remainingHours = Math.floor(remainingTotal / 60);
-    const remainingRemMins = remainingTotal % 60;
-    countdownStr = remainingHours > 0 ? `${remainingHours}h ${remainingRemMins}m` : `${remainingRemMins}m`;
-  }
-
-  return {
-    shiftTitle,
-    shiftName,
-    shiftHours,
-    elapsedHours,
-    elapsedMins,
-    percent,
-    remainingMinutes: remainingTotal,
-    handoverDue,
-    countdownStr,
-    dashOffset,
-  };
-}
diff --git a/src/components/ward-management/shell/ward-rail-helpers.ts b/src/components/ward-management/shell/ward-rail-helpers.ts
new file mode 100644
index 000000000..01af9609f
--- /dev/null
+++ b/src/components/ward-management/shell/ward-rail-helpers.ts
@@ -0,0 +1,130 @@
+/**
+ * Pure helpers shared by the side rail's three copies: the live rail (ward-rail.tsx), the next
+ * shell's rail (shell-next/next-rail-body.tsx) and the redesign preview's rail
+ * (ward-redesign/shell/preview-rail-body.tsx). They were copied identically into each; one home
+ * keeps the shift figures and the desk line from drifting apart.
+ */
+import { communityTeamById } from "@/components/ward-management/community/community-derivations";
+import { currentDeskId } from "@/components/ward-management/settings/workstation-desks";
+import { shiftAtMinute } from "@/components/ward-management/ward-board-time-features";
+import { CHROME_ROLE_LABELS, wardChromeRole, type WardChromeRole } from "@/components/ward-management/ward-chrome-role";
+import { HANDOVER_DUE_PROMPT_MINUTES } from "@/components/ward-management/ward-operational-defaults";
+import { edById } from "@/components/ward-management/ward-sites";
+
+/** "at a time limit…" → "At a time limit…", for the closed rail's hover card. */
+export function sentenceStart(text: string): string {
+  return text.length === 0 ? text : text.charAt(0).toUpperCase() + text.slice(1);
+}
+
+/**
+ * The desk a page belongs to, when it is not the person's own kind of desk: "Viewing RPH ED as Bed
+ * coordinator". Null on the person's own kind of desk and on every network page. Place names only,
+ * never a patient.
+ */
+export function viewingDeskLine(
+  pathname: string,
+  personaRole: WardChromeRole,
+  units: readonly { id: string; name: string }[],
+  personaLabel: string,
+): string | null {
+  const pageRole = wardChromeRole(pathname);
+  if (pageRole === "coordinator" || pageRole === personaRole) return null;
+  const deskId = currentDeskId(pathname);
+  const place =
+    pageRole === "ed"
+      ? `${(deskId ? edById(deskId)?.siteCode : undefined) ?? "this"} ED`
+      : pageRole === "ward"
+        ? (units.find((unit) => unit.id === deskId)?.name ?? "this ward")
+        : pageRole === "officer"
+          ? "the transport desk"
+          : pageRole === "community"
+            ? // PR #489 review: the team by name when its page names one; the index has none.
+              ((deskId ? communityTeamById(deskId)?.name : undefined) ?? "a community team")
+            : CHROME_ROLE_LABELS[pageRole];
+  return `Viewing ${place} as ${personaLabel}`;
+}
+
+export interface ShiftProgress {
+  shiftTitle: string;
+  /** "Day shift": the pattern's name in sentence case. */
+  shiftName: string;
+  /** "07:00–15:00": clock times, so colons are right here. */
+  shiftHours: string;
+  elapsedHours: number;
+  elapsedMins: number;
+  percent: number;
+  /** Minutes until the shift ends. */
+  remainingMinutes: number;
+  /** True inside the handover prompt window (`HANDOVER_DUE_PROMPT_MINUTES`) before the shift ends. */
+  handoverDue: boolean;
+  countdownStr: string;
+  dashOffset: number;
+}
+
+/** "07:00" from a minute-of-day figure — used only to word `SHIFT_PATTERN`'s own entries. */
+function formatMinuteOfDay(minute: number): string {
+  const hours = Math.floor(minute / 60);
+  const mins = minute % 60;
+  return `${String(hours).padStart(2, "0")}:${String(mins).padStart(2, "0")}`;
+}
+
+/** Minutes from `from` to `to`, wrapping through midnight when `to` is earlier in the day. */
+function minutesFrom(from: number, to: number): number {
+  return (((to - from) % 1440) + 1440) % 1440;
+}
+
+export function computeShiftProgress(nowInput?: number | Date): ShiftProgress {
+  const CIRCUMFERENCE = 81.68;
+
+  let currentMinute: number;
+  if (typeof nowInput === "number") {
+    // Normalise minute of day 0..1439
+    currentMinute = ((nowInput % 1440) + 1440) % 1440;
+  } else {
+    const d = nowInput instanceof Date ? nowInput : new Date();
+    // AWST is UTC+8
+    const awstHours = (d.getUTCHours() + 8) % 24;
+    const awstMins = d.getUTCMinutes();
+    currentMinute = awstHours * 60 + awstMins;
+  }
+
+  // The shift pattern itself (07:00/15:00/23:00) is a labelled default, not a legal roster rule —
+  // owner ruling 26 September 2026 (decisions.md D-22) — read from `SHIFT_PATTERN` through `shiftAtMinute` (the rule `currentShift` uses too), never
+  // hand-typed here, so the one figure and its three titles cannot drift apart.
+  const shift = shiftAtMinute(currentMinute);
+
+  const shiftHours = `${formatMinuteOfDay(shift.startMinute)}–${formatMinuteOfDay(shift.endMinute)}`;
+  const shiftTitle = `${shift.name} (${shiftHours})`;
+  const shiftName = shift.name.charAt(0) + shift.name.slice(1).toLowerCase();
+  const shiftDuration = minutesFrom(shift.startMinute, shift.endMinute);
+  const elapsedTotal = minutesFrom(shift.startMinute, currentMinute);
+  const remainingTotal = shiftDuration - elapsedTotal;
+
+  const elapsedHours = Math.floor(elapsedTotal / 60);
+  const elapsedMins = elapsedTotal % 60;
+  const percent = Math.min(100, Math.max(0, Math.round((elapsedTotal / shiftDuration) * 100)));
+  const dashOffset = Number((CIRCUMFERENCE * (1 - percent / 100)).toFixed(2));
+  const handoverDue = remainingTotal <= HANDOVER_DUE_PROMPT_MINUTES;
+
+  let countdownStr: string;
+  if (handoverDue) {
+    countdownStr = "Handover Due";
+  } else {
+    const remainingHours = Math.floor(remainingTotal / 60);
+    const remainingRemMins = remainingTotal % 60;
+    countdownStr = remainingHours > 0 ? `${remainingHours}h ${remainingRemMins}m` : `${remainingRemMins}m`;
+  }
+
+  return {
+    shiftTitle,
+    shiftName,
+    shiftHours,
+    elapsedHours,
+    elapsedMins,
+    percent,
+    remainingMinutes: remainingTotal,
+    handoverDue,
+    countdownStr,
+    dashOffset,
+  };
+}
diff --git a/src/components/ward-management/shell/ward-rail.tsx b/src/components/ward-management/shell/ward-rail.tsx
index e69183121..fc7783307 100644
--- a/src/components/ward-management/shell/ward-rail.tsx
+++ b/src/components/ward-management/shell/ward-rail.tsx
@@ -24,25 +24,22 @@ import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from "
 import { Sheet } from "@/components/wf/sheet";
 import { Tooltip } from "@/components/wf/tooltip";
 import { OperatorSwitcherModal } from "@/components/ward-management/settings/operator-switcher-modal-lazy";
-import { communityTeamById } from "@/components/ward-management/community/community-derivations";
 import { useShellPersonaRole } from "@/components/ward-management/settings/persona-sync";
-import { currentDeskId } from "@/components/ward-management/settings/workstation-desks";
 import { useWardNavCounts } from "@/components/ward-management/use-ward-nav-counts";
 import { formatInstant, minuteOfDay } from "@/components/ward-management/ward-clock";
 import { requestToolsTool } from "@/components/ward-management/tools/ward-tools-open";
-import { CHROME_ROLE_LABELS, wardChromeRole, type WardChromeRole } from "@/components/ward-management/ward-chrome-role";
 import { ACCESS_ADMIN_PERSONA, DESK_PERSONAS } from "@/components/ward-management/shell/ward-desk-personas";
 import { useDeskRoleLabel, useEffectiveWardAccess } from "@/components/ward-management/shell/ward-access-store";
 import { useWardFlowClock, useWardFlowSelect, useWardNetwork } from "@/components/ward-management/ward-flow-provider";
 import type { HealthService } from "@/components/ward-management/ward-model";
-import { edById } from "@/components/ward-management/ward-sites";
 import { WARD_CAPACITY_HREF, WARD_REFERRAL_INTAKE_HREF } from "@/components/ward-management/ward-nav";
 import { wardNavCountLabel } from "@/components/ward-management/ward-nav-counts";
+import { OPERATIONAL_DEFAULT_LABEL } from "@/components/ward-management/ward-operational-defaults";
 import {
-  HANDOVER_DUE_PROMPT_MINUTES,
-  OPERATIONAL_DEFAULT_LABEL,
-} from "@/components/ward-management/ward-operational-defaults";
-import { shiftAtMinute } from "@/components/ward-management/ward-board-time-features";
+  computeShiftProgress,
+  sentenceStart,
+  viewingDeskLine,
+} from "@/components/ward-management/shell/ward-rail-helpers";
 import { Dot, SrOnly, durMinutes, useIsPhone } from "@/components/wf";
 import { applyAppearance, applyGlare } from "./ward-bar";
 import { closeWardDrawer, isPhoneViewport, subscribeWardMenu } from "./ward-drawer-bus";
@@ -195,11 +192,6 @@ function getTabletLandscapeSnapshot() {
   );
 }
 
-/** "at a time limit…" → "At a time limit…", for the closed rail's hover card. */
-function sentenceStart(text: string): string {
-  return text.length === 0 ? text : text.charAt(0).toUpperCase() + text.slice(1);
-}
-
 // UX audit (21 Oct 2026): the same four themes as Settings, Display (settings-15 made Glare a fourth).
 const APPEARANCE_CHOICES = [
   { id: "auto", label: "Auto" },
@@ -221,34 +213,6 @@ function chooseAppearance(next: AppearanceChoice) {
   announceToWardShell(`Appearance set to ${next}.`);
 }
 
-/**
- * The desk a page belongs to, when it is not the person's own kind of desk: "Viewing RPH ED as Bed
- * coordinator". Null on the person's own kind of desk and on every network page. Place names only,
- * never a patient.
- */
-function viewingDeskLine(
-  pathname: string,
-  personaRole: WardChromeRole,
-  units: readonly { id: string; name: string }[],
-  personaLabel: string,
-): string | null {
-  const pageRole = wardChromeRole(pathname);
-  if (pageRole === "coordinator" || pageRole === personaRole) return null;
-  const deskId = currentDeskId(pathname);
-  const place =
-    pageRole === "ed"
-      ? `${(deskId ? edById(deskId)?.siteCode : undefined) ?? "this"} ED`
-      : pageRole === "ward"
-        ? (units.find((unit) => unit.id === deskId)?.name ?? "this ward")
-        : pageRole === "officer"
-          ? "the transport desk"
-          : pageRole === "community"
-            ? // PR #489 review: the team by name when its page names one; the index has none.
-              ((deskId ? communityTeamById(deskId)?.name : undefined) ?? "a community team")
-            : CHROME_ROLE_LABELS[pageRole];
-  return `Viewing ${place} as ${personaLabel}`;
-}
-
 /**
  * Retained for the layout's existing call shape. The reconciliation line this used to feed is no
  * longer mounted in the rail (Josh, 7 October 2026), so the rail takes no props today.
@@ -1394,88 +1358,3 @@ export function WardRail({ onOpenOperatorModal }: WardRailProps = {}) {
     </WardRailFrame>
   );
 }
-
-export interface ShiftProgress {
-  shiftTitle: string;
-  /** "Day shift": the pattern's name in sentence case. */
-  shiftName: string;
-  /** "07:00–15:00": clock times, so colons are right here. */
-  shiftHours: string;
-  elapsedHours: number;
-  elapsedMins: number;
-  percent: number;
-  /** Minutes until the shift ends. */
-  remainingMinutes: number;
-  /** True inside the handover prompt window (`HANDOVER_DUE_PROMPT_MINUTES`). */
-  handoverDue: boolean;
-  countdownStr: string;
-  dashOffset: number;
-}
-
-/** "07:00" from a minute-of-day figure — used only to word `SHIFT_PATTERN`'s own entries. */
-function formatMinuteOfDay(minute: number): string {
-  const hours = Math.floor(minute / 60);
-  const mins = minute % 60;
-  return `${String(hours).padStart(2, "0")}:${String(mins).padStart(2, "0")}`;
-}
-
-/** Minutes from `from` to `to`, wrapping through midnight when `to` is earlier in the day. */
-function minutesFrom(from: number, to: number): number {
-  return (((to - from) % 1440) + 1440) % 1440;
-}
-
-function computeShiftProgress(nowInput?: number | Date): ShiftProgress {
-  const CIRCUMFERENCE = 81.68;
-
-  let currentMinute: number;
-  if (typeof nowInput === "number") {
-    // Normalise minute of day 0..1439
-    currentMinute = ((nowInput % 1440) + 1440) % 1440;
-  } else {
-    const d = nowInput instanceof Date ? nowInput : new Date();
-    // AWST is UTC+8
-    const awstHours = (d.getUTCHours() + 8) % 24;
-    const awstMins = d.getUTCMinutes();
-    currentMinute = awstHours * 60 + awstMins;
-  }
-
-  // The shift pattern itself (07:00/15:00/23:00) is a labelled default, not a legal roster rule —
-  // owner ruling 26 September 2026 (decisions.md D-22) — read from `SHIFT_PATTERN` through `shiftAtMinute` (the rule `currentShift` uses too), never
-  // hand-typed here, so the one figure and its three titles cannot drift apart.
-  const shift = shiftAtMinute(currentMinute);
-
-  const shiftHours = `${formatMinuteOfDay(shift.startMinute)}–${formatMinuteOfDay(shift.endMinute)}`;
-  const shiftTitle = `${shift.name} (${shiftHours})`;
-  const shiftName = shift.name.charAt(0) + shift.name.slice(1).toLowerCase();
-  const shiftDuration = minutesFrom(shift.startMinute, shift.endMinute);
-  const elapsedTotal = minutesFrom(shift.startMinute, currentMinute);
-  const remainingTotal = shiftDuration - elapsedTotal;
-
-  const elapsedHours = Math.floor(elapsedTotal / 60);
-  const elapsedMins = elapsedTotal % 60;
-  const percent = Math.min(100, Math.max(0, Math.round((elapsedTotal / shiftDuration) * 100)));
-  const dashOffset = Number((CIRCUMFERENCE * (1 - percent / 100)).toFixed(2));
-  const handoverDue = remainingTotal <= HANDOVER_DUE_PROMPT_MINUTES;
-
-  let countdownStr: string;
-  if (handoverDue) {
-    countdownStr = "Handover Due";
-  } else {
-    const remainingHours = Math.floor(remainingTotal / 60);
-    const remainingRemMins = remainingTotal % 60;
-    countdownStr = remainingHours > 0 ? `${remainingHours}h ${remainingRemMins}m` : `${remainingRemMins}m`;
-  }
-
-  return {
-    shiftTitle,
-    shiftName,
-    shiftHours,
-    elapsedHours,
-    elapsedMins,
-    percent,
-    remainingMinutes: remainingTotal,
-    handoverDue,
-    countdownStr,
-    dashOffset,
-  };
-}
diff --git a/src/components/ward-redesign/shell/preview-rail-body.tsx b/src/components/ward-redesign/shell/preview-rail-body.tsx
index 389ab5706..5589619af 100644
--- a/src/components/ward-redesign/shell/preview-rail-body.tsx
+++ b/src/components/ward-redesign/shell/preview-rail-body.tsx
@@ -26,25 +26,22 @@ import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from "
 import { Sheet } from "@/components/wf/sheet";
 import { Tooltip } from "@/components/wf/tooltip";
 import { OperatorSwitcherModal } from "@/components/ward-management/settings/operator-switcher-modal-lazy";
-import { communityTeamById } from "@/components/ward-management/community/community-derivations";
 import { useShellPersonaRole } from "@/components/ward-management/settings/persona-sync";
-import { currentDeskId } from "@/components/ward-management/settings/workstation-desks";
 import { usePreviewNavCounts } from "@/components/ward-redesign/shell/preview-nav-counts";
 import { formatInstant, minuteOfDay } from "@/components/ward-management/ward-clock";
 import { requestToolsTool } from "@/components/ward-management/tools/ward-tools-open";
-import { CHROME_ROLE_LABELS, wardChromeRole, type WardChromeRole } from "@/components/ward-management/ward-chrome-role";
 import { ACCESS_ADMIN_PERSONA, DESK_PERSONAS } from "@/components/ward-management/shell/ward-desk-personas";
 import { useDeskRoleLabel, useEffectiveWardAccess } from "@/components/ward-management/shell/ward-access-store";
 import { useWardFlowClock, useWardFlowSelect, useWardNetwork } from "@/components/ward-management/ward-flow-provider";
 import type { HealthService } from "@/components/ward-management/ward-model";
-import { edById } from "@/components/ward-management/ward-sites";
 import { WARD_CAPACITY_HREF } from "@/components/ward-management/ward-nav";
 import { wardNavCountLabel } from "@/components/ward-management/ward-nav-counts";
+import { OPERATIONAL_DEFAULT_LABEL } from "@/components/ward-management/ward-operational-defaults";
 import {
-  HANDOVER_DUE_PROMPT_MINUTES,
-  OPERATIONAL_DEFAULT_LABEL,
-} from "@/components/ward-management/ward-operational-defaults";
-import { shiftAtMinute } from "@/components/ward-management/ward-board-time-features";
+  computeShiftProgress,
+  sentenceStart,
+  viewingDeskLine,
+} from "@/components/ward-management/shell/ward-rail-helpers";
 import { Dot, SrOnly, durMinutes, useIsPhone } from "@/components/wf";
 import { setGlarePreference, setThemePreference } from "@/lib/theme-client";
 import {
@@ -189,11 +186,6 @@ function getTabletLandscapeSnapshot() {
   );
 }
 
-/** "at a time limit…" → "At a time limit…", for the closed rail's hover card. */
-function sentenceStart(text: string): string {
-  return text.length === 0 ? text : text.charAt(0).toUpperCase() + text.slice(1);
-}
-
 // UX audit (21 Oct 2026): the same four themes as Settings, Display (settings-15 made Glare a fourth).
 const APPEARANCE_CHOICES = [
   { id: "auto", label: "Auto" },
@@ -216,34 +208,6 @@ function chooseAppearance(next: AppearanceChoice) {
   announceToWardShell(`Appearance set to ${next}.`);
 }
 
-/**
- * The desk a page belongs to, when it is not the person's own kind of desk: "Viewing RPH ED as Bed
- * coordinator". Null on the person's own kind of desk and on every network page. Place names only,
- * never a patient.
- */
-function viewingDeskLine(
-  pathname: string,
-  personaRole: WardChromeRole,
-  units: readonly { id: string; name: string }[],
-  personaLabel: string,
-): string | null {
-  const pageRole = wardChromeRole(pathname);
-  if (pageRole === "coordinator" || pageRole === personaRole) return null;
-  const deskId = currentDeskId(pathname);
-  const place =
-    pageRole === "ed"
-      ? `${(deskId ? edById(deskId)?.siteCode : undefined) ?? "this"} ED`
-      : pageRole === "ward"
-        ? (units.find((unit) => unit.id === deskId)?.name ?? "this ward")
-        : pageRole === "officer"
-          ? "the transport desk"
-          : pageRole === "community"
-            ? // PR #489 review: the team by name when its page names one; the index has none.
-              ((deskId ? communityTeamById(deskId)?.name : undefined) ?? "a community team")
-            : CHROME_ROLE_LABELS[pageRole];
-  return `Viewing ${place} as ${personaLabel}`;
-}
-
 /**
  * Retained for the layout's existing call shape. The reconciliation line this used to feed is no
  * longer mounted in the rail (Josh, 7 October 2026), so the rail takes no props today.
@@ -1322,88 +1286,3 @@ export function PreviewRailBody({ onOpenOperatorModal }: WardRailProps = {}) {
     </WardRailFrame>
   );
 }
-
-export interface ShiftProgress {
-  shiftTitle: string;
-  /** "Day shift": the pattern's name in sentence case. */
-  shiftName: string;
-  /** "07:00–15:00": clock times, so colons are right here. */
-  shiftHours: string;
-  elapsedHours: number;
-  elapsedMins: number;
-  percent: number;
-  /** Minutes until the shift ends. */
-  remainingMinutes: number;
-  /** True inside the handover prompt window (`HANDOVER_DUE_PROMPT_MINUTES`) before the shift ends. */
-  handoverDue: boolean;
-  countdownStr: string;
-  dashOffset: number;
-}
-
-/** "07:00" from a minute-of-day figure — used only to word `SHIFT_PATTERN`'s own entries. */
-function formatMinuteOfDay(minute: number): string {
-  const hours = Math.floor(minute / 60);
-  const mins = minute % 60;
-  return `${String(hours).padStart(2, "0")}:${String(mins).padStart(2, "0")}`;
-}
-
-/** Minutes from `from` to `to`, wrapping through midnight when `to` is earlier in the day. */
-function minutesFrom(from: number, to: number): number {
-  return (((to - from) % 1440) + 1440) % 1440;
-}
-
-export function computeShiftProgress(nowInput?: number | Date): ShiftProgress {
-  const CIRCUMFERENCE = 81.68;
-
-  let currentMinute: number;
-  if (typeof nowInput === "number") {
-    // Normalise minute of day 0..1439
-    currentMinute = ((nowInput % 1440) + 1440) % 1440;
-  } else {
-    const d = nowInput instanceof Date ? nowInput : new Date();
-    // AWST is UTC+8
-    const awstHours = (d.getUTCHours() + 8) % 24;
-    const awstMins = d.getUTCMinutes();
-    currentMinute = awstHours * 60 + awstMins;
-  }
-
-  // The shift pattern itself (07:00/15:00/23:00) is a labelled default, not a legal roster rule —
-  // owner ruling 26 September 2026 (decisions.md D-22) — read from `SHIFT_PATTERN` through `shiftAtMinute` (the rule `currentShift` uses too), never
-  // hand-typed here, so the one figure and its three titles cannot drift apart.
-  const shift = shiftAtMinute(currentMinute);
-
-  const shiftHours = `${formatMinuteOfDay(shift.startMinute)}–${formatMinuteOfDay(shift.endMinute)}`;
-  const shiftTitle = `${shift.name} (${shiftHours})`;
-  const shiftName = shift.name.charAt(0) + shift.name.slice(1).toLowerCase();
-  const shiftDuration = minutesFrom(shift.startMinute, shift.endMinute);
-  const elapsedTotal = minutesFrom(shift.startMinute, currentMinute);
-  const remainingTotal = shiftDuration - elapsedTotal;
-
-  const elapsedHours = Math.floor(elapsedTotal / 60);
-  const elapsedMins = elapsedTotal % 60;
-  const percent = Math.min(100, Math.max(0, Math.round((elapsedTotal / shiftDuration) * 100)));
-  const dashOffset = Number((CIRCUMFERENCE * (1 - percent / 100)).toFixed(2));
-  const handoverDue = remainingTotal <= HANDOVER_DUE_PROMPT_MINUTES;
-
-  let countdownStr: string;
-  if (handoverDue) {
-    countdownStr = "Handover Due";
-  } else {
-    const remainingHours = Math.floor(remainingTotal / 60);
-    const remainingRemMins = remainingTotal % 60;
-    countdownStr = remainingHours > 0 ? `${remainingHours}h ${remainingRemMins}m` : `${remainingRemMins}m`;
-  }
-
-  return {
-    shiftTitle,
-    shiftName,
-    shiftHours,
-    elapsedHours,
-    elapsedMins,
-    percent,
-    remainingMinutes: remainingTotal,
-    handoverDue,
-    countdownStr,
-    dashOffset,
-  };
-}
diff --git a/tests/ward-service-bed-alerts.test.ts b/tests/ward-service-bed-alerts.test.ts
index bd9cf23c7..8d0610488 100644
--- a/tests/ward-service-bed-alerts.test.ts
+++ b/tests/ward-service-bed-alerts.test.ts
@@ -5,7 +5,7 @@ import {
   METRO_HEALTH_SERVICES,
   occupancyTone,
 } from "@/components/ward-management/shell/ward-service-bed-alerts";
-import { computeShiftProgress } from "@/components/ward-management/shell-next/next-rail-body";
+import { computeShiftProgress } from "@/components/ward-management/shell/ward-rail-helpers";
 import type { BedRelease, Site, Unit } from "@/components/ward-management/ward-model";
 import { readyBedsNow } from "@/components/ward-management/ward-bed-states";
 import { unitCapacity } from "@/components/ward-management/ward-derivations";
diff --git a/tests/ward-shell-third-edition.dom.test.tsx b/tests/ward-shell-third-edition.dom.test.tsx
index 3f41f3ce5..0f1855105 100644
--- a/tests/ward-shell-third-edition.dom.test.tsx
+++ b/tests/ward-shell-third-edition.dom.test.tsx
@@ -42,7 +42,7 @@ vi.mock("next/navigation", () => ({
 import { applyAppearance } from "@/components/ward-management/shell/ward-bar";
 import { NextBar as WardBar } from "@/components/ward-management/shell-next/next-bar";
 import { WardLiveRegion, resetWardLiveRegionForTests } from "@/components/ward-management/shell/ward-live-region";
-import { computeShiftProgress } from "@/components/ward-management/shell-next/next-rail-body";
+import { computeShiftProgress } from "@/components/ward-management/shell/ward-rail-helpers";
 import { NextRailBody as WardRail } from "@/components/ward-management/shell-next/next-rail-body";
 // CB-1 (Josh, 6 Nov 2026): two cases stay on the retired shell until Josh decides, because the live
 // shell has no equivalent. Its Activity trigger reads "Activity" alone, with no "synthetic activity"
diff --git a/tests/ward-shift-rule-agreement.test.ts b/tests/ward-shift-rule-agreement.test.ts
index f357763c1..787bf9ee6 100644
--- a/tests/ward-shift-rule-agreement.test.ts
+++ b/tests/ward-shift-rule-agreement.test.ts
@@ -4,7 +4,7 @@
 import { describe, expect, it } from "vitest";
 
 import { defaultHandoverShift, handoverAt } from "@/components/ward-management/handover/handover-model";
-import { computeShiftProgress } from "@/components/ward-management/shell-next/next-rail-body";
+import { computeShiftProgress } from "@/components/ward-management/shell/ward-rail-helpers";
 import { currentShift, shiftAtMinute } from "@/components/ward-management/ward-board-time-features";
 import { NOW_ANCHOR } from "@/components/ward-management/ward-sites";
 

From a94c4340746b05c6d6b08423debe4cd879efef95 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:07:08 +0000
Subject: [PATCH 06/40] Align the backend's Node range with the root and drop a
 duplicate script

backend/ward-flow engines.node now matches the root (>=24.22.1 <25), with
the lockfile's root entry in step. Railway picks Node from
RAILPACK_NODE_VERSION, so hosting is unchanged. prune:postgres was an exact
copy of prune:receipts:postgres and nothing referred to it. prune:supabase
stays: OPERATIONS-RUNBOOK.md still names it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 backend/ward-flow/package-lock.json | 2 +-
 backend/ward-flow/package.json      | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/backend/ward-flow/package-lock.json b/backend/ward-flow/package-lock.json
index d19f5bdf3..bd253477e 100644
--- a/backend/ward-flow/package-lock.json
+++ b/backend/ward-flow/package-lock.json
@@ -16,7 +16,7 @@
         "esbuild": "0.28.2"
       },
       "engines": {
-        "node": ">=22"
+        "node": ">=24.22.1 <25"
       }
     },
     "node_modules/@esbuild/aix-ppc64": {
diff --git a/backend/ward-flow/package.json b/backend/ward-flow/package.json
index 5cdd3f51d..be1beb5a7 100644
--- a/backend/ward-flow/package.json
+++ b/backend/ward-flow/package.json
@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "engines": {
-    "node": ">=22"
+    "node": ">=24.22.1 <25"
   },
   "scripts": {
     "start": "node --env-file-if-exists=.env server.mjs",
@@ -13,7 +13,6 @@
     "typecheck": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json",
     "migrate:postgres": "node --env-file-if-exists=.env migrate-postgres.mjs",
     "migrate:supabase": "node --env-file-if-exists=.env migrate-supabase.mjs",
-    "prune:postgres": "node --env-file-if-exists=.env prune-receipts.mjs postgres",
     "prune:supabase": "node --env-file-if-exists=.env prune-receipts.mjs supabase",
     "prune:receipts:postgres": "node --env-file-if-exists=.env prune-receipts.mjs postgres",
     "prune:receipts:supabase": "node --env-file-if-exists=.env prune-receipts.mjs supabase",

From a47ac619846b58d2bf5c28285464224815f5be0d Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:07:08 +0000
Subject: [PATCH 07/40] Drop the missing playwright folder from lint:internal

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index d011075d0..4b26555cc 100644
--- a/package.json
+++ b/package.json
@@ -33,7 +33,7 @@
     "check:coverage-inventory": "node scripts/check-coverage-inventory.mjs",
     "start": "node scripts/dev-free-port.mjs start",
     "lint": "node scripts/run-heavy.mjs --npm-script lint:internal",
-    "lint:internal": "node --max-old-space-size=8192 ./node_modules/eslint/bin/eslint.js src tests scripts backend playwright eslint.config.mjs next.config.ts playwright.config.ts vitest.config.mts --max-warnings 0 --no-error-on-unmatched-pattern --cache --cache-location node_modules/.cache/eslint/",
+    "lint:internal": "node --max-old-space-size=8192 ./node_modules/eslint/bin/eslint.js src tests scripts backend eslint.config.mjs next.config.ts playwright.config.ts vitest.config.mts --max-warnings 0 --no-error-on-unmatched-pattern --cache --cache-location node_modules/.cache/eslint/",
     "lint:changed:internal": "node --max-old-space-size=8192 ./node_modules/eslint/bin/eslint.js",
     "typecheck": "node scripts/run-heavy.mjs --npm-script typecheck:internal",
     "typecheck:internal": "node --max-old-space-size=8192 ./node_modules/typescript/bin/tsc -p tsconfig.typecheck.json --noEmit",

From 2ecff09d6d51616d8b9aa850dff000f395a595c8 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:08:56 +0000
Subject: [PATCH 08/40] ci: share the Ward Flow install setup through a
 composite action

Seven ward-flow.yml jobs (backend, unit, browser-build, browser, release-gate,
build, coverage) repeated setup-node, the pinned npm provision, the exact
node_modules restore and the attested locked install. They now call
.github/actions/ward-setup after their checkout, with the step id `install`
so every steps.install.outcome condition is unchanged. The build job's
main-only save reads the action's cache-hit and cache-primary-key outputs.
Same action SHAs, cache key, inputs and permissions; plan and static keep
their own setup because they differ.

check-contracts.mjs holds the action to the contracts the inline copies
had (exact commands, exact key without restore-keys, pinned SHAs,
unconditional steps, shell bash) and adds mutation probes for it. The
bot-author policy and Dependabot now cover .github/actions/, and the M55
pin test scans local actions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .github/actions/ward-setup/action.yml        |  36 ++++
 .github/dependabot.yml                       |   3 +-
 .github/workflows/ward-flow.yml              | 144 +++-----------
 scripts/ward-ci-public/bot-author-policy.mjs |   8 +-
 scripts/ward-ci-public/check-contracts.mjs   | 198 +++++++++++++++++--
 tests/bot-author-policy.test.ts              |  11 ++
 tests/ci-cache-safety.test.ts                |   7 +-
 tests/ci-remediation-contracts.test.ts       |  26 ++-
 tests/ward-audit-m55-supply-chain.test.ts    |  19 +-
 tests/ward-backend-ci.test.ts                |   6 +-
 10 files changed, 321 insertions(+), 137 deletions(-)
 create mode 100644 .github/actions/ward-setup/action.yml

diff --git a/.github/actions/ward-setup/action.yml b/.github/actions/ward-setup/action.yml
new file mode 100644
index 000000000..c916ddb72
--- /dev/null
+++ b/.github/actions/ward-setup/action.yml
@@ -0,0 +1,36 @@
+# The shared Node setup for the Ward Flow CI jobs that need installed packages
+# (.github/workflows/ward-flow.yml). The job checks out the repository first, so this local action exists.
+# Contracts: scripts/ward-ci-public/check-contracts.mjs. Every step is unconditional and pinned by commit.
+name: Ward Flow setup
+description: Select the pinned Node, provision the pinned npm, then restore and attest the locked install.
+outputs:
+  cache-hit:
+    description: Whether the exact installed-packages key was restored.
+    value: ${{ steps.node-modules.outputs.cache-hit }}
+  cache-primary-key:
+    description: The exact installed-packages key, for the main-only save in the build job.
+    value: ${{ steps.node-modules.outputs.cache-primary-key }}
+runs:
+  using: composite
+  steps:
+    - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1
+      with:
+        node-version-file: .nvmrc
+        cache: npm
+    - name: Install and record the pinned npm toolchain
+      shell: bash
+      run: npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require('./package.json').packageManager")" && node --version && npm --version
+    # Installed packages come from a cache saved on main only (build job), straight after an attested
+    # install; install-locked-dependencies.mjs reuses an exact hit only when its post-install stamp matches.
+    - name: Restore installed packages
+      id: node-modules
+      uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
+      with:
+        path: node_modules
+        key: ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}
+    - name: Install locked dependencies
+      id: install
+      shell: bash
+      env:
+        WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}
+      run: node scripts/install-locked-dependencies.mjs
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 084d4692d..15fb2f180 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -35,8 +35,9 @@ updates:
         applies-to: security-updates
         patterns: ["*"]
 
+  # The local composite actions under .github/actions/ hold action pins too.
   - package-ecosystem: github-actions
-    directory: /
+    directories: ["/", "/.github/actions/*"]
     schedule:
       interval: weekly
       day: monday
diff --git a/.github/workflows/ward-flow.yml b/.github/workflows/ward-flow.yml
index 832bfa7e0..bff5a8c82 100644
--- a/.github/workflows/ward-flow.yml
+++ b/.github/workflows/ward-flow.yml
@@ -308,23 +308,11 @@ jobs:
         with:
           persist-credentials: false
           fetch-depth: 0
-      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1
-        with:
-          node-version-file: .nvmrc
-          cache: npm
-      - name: Install and record the pinned npm toolchain
-        run: npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require('./package.json').packageManager")" && node --version && npm --version
-      - name: Restore installed packages
-        id: node-modules
-        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
-        with:
-          path: node_modules
-          key: ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}
-      - name: Install locked dependencies
+      # Node, the pinned npm, the exact installed-packages restore and the attested install
+      # (.github/actions/ward-setup); the checkout above provides the local action.
+      - name: Set up Node and install locked dependencies
         id: install
-        env:
-          WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}
-        run: node scripts/install-locked-dependencies.mjs
+        uses: ./.github/actions/ward-setup
       - name: Install locked Ward backend dependencies
         id: backend-install
         if: ${{ !cancelled() && steps.install.outcome == 'success' }}
@@ -405,23 +393,11 @@ jobs:
         with:
           persist-credentials: false
           fetch-depth: 0
-      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1
-        with:
-          node-version-file: .nvmrc
-          cache: npm
-      - name: Install and record the pinned npm toolchain
-        run: npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require('./package.json').packageManager")" && node --version && npm --version
-      - name: Restore installed packages
-        id: node-modules
-        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
-        with:
-          path: node_modules
-          key: ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}
-      - name: Install locked dependencies
+      # Node, the pinned npm, the exact installed-packages restore and the attested install
+      # (.github/actions/ward-setup); the checkout above provides the local action.
+      - name: Set up Node and install locked dependencies
         id: install
-        env:
-          WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}
-        run: node scripts/install-locked-dependencies.mjs
+        uses: ./.github/actions/ward-setup
       - name: Select reproducible nightly fuzz window
         if: ${{ github.event_name == 'schedule' && steps.install.outcome == 'success' }}
         run: node scripts/ward-flow/engine-fuzz-window.mjs --output "$RUNNER_TEMP/ward-profile/fuzz-window.json" --github-env "$GITHUB_ENV"
@@ -503,23 +479,11 @@ jobs:
         with:
           persist-credentials: false
           fetch-depth: 0
-      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1
-        with:
-          node-version-file: .nvmrc
-          cache: npm
-      - name: Install and record the pinned npm toolchain
-        run: npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require('./package.json').packageManager")" && node --version && npm --version
-      - name: Restore installed packages
-        id: node-modules
-        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
-        with:
-          path: node_modules
-          key: ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}
-      - name: Install locked dependencies
+      # Node, the pinned npm, the exact installed-packages restore and the attested install
+      # (.github/actions/ward-setup); the checkout above provides the local action.
+      - name: Set up Node and install locked dependencies
         id: install
-        env:
-          WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}
-        run: node scripts/install-locked-dependencies.mjs
+        uses: ./.github/actions/ward-setup
       - name: Restore Next build cache
         id: next-cache
         if: ${{ !cancelled() && steps.install.outcome == 'success' }}
@@ -566,23 +530,11 @@ jobs:
         with:
           persist-credentials: false
           fetch-depth: 0
-      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1
-        with:
-          node-version-file: .nvmrc
-          cache: npm
-      - name: Install and record the pinned npm toolchain
-        run: npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require('./package.json').packageManager")" && node --version && npm --version
-      - name: Restore installed packages
-        id: node-modules
-        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
-        with:
-          path: node_modules
-          key: ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}
-      - name: Install locked dependencies
+      # Node, the pinned npm, the exact installed-packages restore and the attested install
+      # (.github/actions/ward-setup); the checkout above provides the local action.
+      - name: Set up Node and install locked dependencies
         id: install
-        env:
-          WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}
-        run: node scripts/install-locked-dependencies.mjs
+        uses: ./.github/actions/ward-setup
       - name: Download the verified browser build
         if: ${{ !cancelled() && needs.browser-build.result == 'success' && steps.install.outcome == 'success' }}
         uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333
@@ -693,23 +645,11 @@ jobs:
         with:
           persist-credentials: false
           fetch-depth: 0
-      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1
-        with:
-          node-version-file: .nvmrc
-          cache: npm
-      - name: Install and record the pinned npm toolchain
-        run: npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require('./package.json').packageManager")" && node --version && npm --version
-      - name: Restore installed packages
-        id: node-modules
-        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
-        with:
-          path: node_modules
-          key: ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}
-      - name: Install locked dependencies
+      # Node, the pinned npm, the exact installed-packages restore and the attested install
+      # (.github/actions/ward-setup); the checkout above provides the local action.
+      - name: Set up Node and install locked dependencies
         id: install
-        env:
-          WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}
-        run: node scripts/install-locked-dependencies.mjs
+        uses: ./.github/actions/ward-setup
       - name: Download the verified browser build
         if: ${{ !cancelled() && needs.browser-build.result == 'success' && steps.install.outcome == 'success' }}
         uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333
@@ -876,32 +816,20 @@ jobs:
       - name: Record the measured main
         if: ${{ github.event_name == 'pull_request' }}
         run: echo "::notice title=Ward budget main::$(git rev-parse refs/remotes/origin/main)"
-      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1
-        with:
-          node-version-file: .nvmrc
-          cache: npm
-      - name: Install and record the pinned npm toolchain
-        run: npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require('./package.json').packageManager")" && node --version && npm --version
-      - name: Restore installed packages
-        id: node-modules
-        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
-        with:
-          path: node_modules
-          key: ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}
-      - name: Install locked dependencies
+      # Node, the pinned npm, the exact installed-packages restore and the attested install
+      # (.github/actions/ward-setup); the checkout above provides the local action.
+      - name: Set up Node and install locked dependencies
         id: install
-        env:
-          WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}
-        run: node scripts/install-locked-dependencies.mjs
+        uses: ./.github/actions/ward-setup
       # The clean tree is saved straight after its attested install, from main only, before any step
       # writes into node_modules; pull requests restore it and install-locked-dependencies.mjs reuses
       # it only when its post-install stamp still matches the lock and the files.
       - name: Save installed packages on main
-        if: ${{ !cancelled() && github.ref == 'refs/heads/main' && github.event_name != 'pull_request' && steps.install.outcome == 'success' && steps.node-modules.outputs.cache-hit != 'true' }}
+        if: ${{ !cancelled() && github.ref == 'refs/heads/main' && github.event_name != 'pull_request' && steps.install.outcome == 'success' && steps.install.outputs.cache-hit != 'true' }}
         uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
         with:
           path: node_modules
-          key: ${{ steps.node-modules.outputs.cache-primary-key }}
+          key: ${{ steps.install.outputs.cache-primary-key }}
       - name: Restore Next build cache
         id: production-cache
         if: ${{ !cancelled() && steps.install.outcome == 'success' }}
@@ -952,23 +880,11 @@ jobs:
         with:
           persist-credentials: false
           fetch-depth: 0
-      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1
-        with:
-          node-version-file: .nvmrc
-          cache: npm
-      - name: Install and record the pinned npm toolchain
-        run: npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require('./package.json').packageManager")" && node --version && npm --version
-      - name: Restore installed packages
-        id: node-modules
-        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
-        with:
-          path: node_modules
-          key: ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}
-      - name: Install locked dependencies
+      # Node, the pinned npm, the exact installed-packages restore and the attested install
+      # (.github/actions/ward-setup); the checkout above provides the local action.
+      - name: Set up Node and install locked dependencies
         id: install
-        env:
-          WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}
-        run: node scripts/install-locked-dependencies.mjs
+        uses: ./.github/actions/ward-setup
       - name: Download shard coverage blobs
         if: ${{ !cancelled() && steps.install.outcome == 'success' }}
         uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333
diff --git a/scripts/ward-ci-public/bot-author-policy.mjs b/scripts/ward-ci-public/bot-author-policy.mjs
index 514500b76..8694cf604 100644
--- a/scripts/ward-ci-public/bot-author-policy.mjs
+++ b/scripts/ward-ci-public/bot-author-policy.mjs
@@ -93,8 +93,10 @@ export const sensitivePathPatterns = [
   /^data\/mha-[^/]*$/iu,
   /^docs\/ward-flow\/governance\//u,
   /^(?:src|data|docs|backend)\/(?:.*\/)?[^/]*clinic[^/]*(?:\/|$)/iu,
-  // CI itself: the workflows, the public CI scripts (this file included) and the protected-test list.
+  // CI itself: the workflows and their local actions, the public CI scripts (this file included) and
+  // the protected-test list.
   /^\.github\/workflows\//u,
+  /^\.github\/actions\//u,
   /^scripts\/ward-ci-public\//u,
   /^scripts\/ward-flow\/protected-safety-tests\.json$/u,
 ];
@@ -191,7 +193,9 @@ export function botSensitiveCommitViolations(commits) {
     }
     const pinOnly = isDependabotAuthor(commit.author) ? new Set(commit.actionPinOnlyFiles ?? []) : new Set();
     const sensitive = commit.files.filter(
-      (file) => isSensitivePath(file) && !(pinOnly.has(file) && /^\.github\/workflows\/[^/]+\.ya?ml$/u.test(file)),
+      (file) =>
+        isSensitivePath(file) &&
+        !(pinOnly.has(file) && /^\.github\/(?:workflows\/[^/]+|actions\/[^/]+\/action)\.ya?ml$/u.test(file)),
     );
     if (sensitive.length > 0) {
       violations.push(
diff --git a/scripts/ward-ci-public/check-contracts.mjs b/scripts/ward-ci-public/check-contracts.mjs
index c397733c7..64917a6dd 100644
--- a/scripts/ward-ci-public/check-contracts.mjs
+++ b/scripts/ward-ci-public/check-contracts.mjs
@@ -8,7 +8,90 @@ const workflow = readFileSync(new URL("../../.github/workflows/ward-flow.yml", i
   /\r\n/gu,
   "\n",
 );
-function requireWorkflow(source) {
+// The shared setup action the install jobs use (.github/actions/ward-setup).
+const setupAction = readFileSync(
+  new URL("../../.github/actions/ward-setup/action.yml", import.meta.url),
+  "utf8",
+).replace(/\r\n/gu, "\n");
+function requireWorkflow(source, action) {
+  // The shared setup the install jobs use: Node, the pinned npm, the exact installed-packages restore and
+  // the attested install. Its steps are held to the same contracts the inline copies were.
+  const SETUP_ACTION = "./.github/actions/ward-setup";
+  const SETUP_STEP = "Set up Node and install locked dependencies";
+  const SETUP_JOBS = ["backend", "unit", "browser-build", "browser", "release-gate", "build", "coverage"];
+  const NPM_PROVISION =
+    'npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require(\'./package.json\').packageManager")" && node --version && npm --version';
+  const CACHE_RESTORE = "actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9";
+  const NODE_MODULES_KEY =
+    "ward-node-modules-${{ runner.os }}-${{ hashFiles('.nvmrc', 'package.json', 'package-lock.json') }}";
+  function requireSetupAction(source, setupNode) {
+    source = source
+      .split("\n")
+      .filter((line) => !/^\s*#/u.test(line))
+      .join("\n");
+    assert.match(source, /^runs:\n {2}using: composite\n {2}steps:\n/mu);
+    // The build job's main-only save reads these outputs; anything else would save an unattested key.
+    assert.match(
+      source,
+      /^outputs:\n {2}cache-hit:\n {4}description: [^\n]+\n {4}value: \$\{\{ steps\.node-modules\.outputs\.cache-hit \}\}\n {2}cache-primary-key:\n {4}description: [^\n]+\n {4}value: \$\{\{ steps\.node-modules\.outputs\.cache-primary-key \}\}\n(?=\S)/mu,
+    );
+    for (const pattern of [
+      /continue-on-error:/u,
+      /secrets\./u,
+      /actions\/cache@/u,
+      /node-version: /u,
+      /restore-keys/u,
+      /^\s*if:/mu,
+      /working-directory:/u,
+      /^\s*(?:-\s+)?uses: \.\//mu,
+    ])
+      assert.doesNotMatch(source, pattern, `setup action: ${pattern}`);
+    for (const match of source.matchAll(/^\s*(?:- )?uses: ([^\n]+)/gmu))
+      assert.match(match[1], /^[\w./-]+@[0-9a-f]{40}$/u);
+    // A composite run step must name its shell; plain bash keeps -e and pipefail.
+    for (const match of source.matchAll(/^\s*shell: ([^\n]*)$/gmu)) assert.equal(match[1], "bash");
+    const entries = source
+      .split(/^ {4}- /mu)
+      .slice(1)
+      .map((text) => {
+        const fields = new Map();
+        for (const match of `      ${text}`.matchAll(/^ {6}([a-z][a-z0-9_-]*): ([^\n]*)(?:\n|$)/gmu)) {
+          assert.ok(!fields.has(match[1]), `setup action: duplicate step field ${match[1]}`);
+          fields.set(match[1], match[2]);
+        }
+        return { fields, text };
+      });
+    assert.deepEqual(
+      entries.map(({ fields }) => fields.get("name") ?? fields.get("uses")),
+      [
+        setupNode,
+        "Install and record the pinned npm toolchain",
+        "Restore installed packages",
+        "Install locked dependencies",
+      ],
+      "setup action: select Node, provision npm, restore, then install",
+    );
+    const [runtime, provision, restore, install] = entries;
+    assert.match(runtime.fields.get("uses"), /^actions\/setup-node@[0-9a-f]{40}$/u);
+    assert.match(runtime.text, /^ {8}node-version-file: \.nvmrc$/mu);
+    assert.match(runtime.text, /^ {8}cache: npm$/mu);
+    assert.equal(provision.fields.get("run"), NPM_PROVISION);
+    assert.equal(provision.fields.get("shell"), "bash");
+    assert.equal(restore.fields.get("uses"), CACHE_RESTORE);
+    assert.equal(restore.fields.get("id"), "node-modules");
+    assert.match(restore.text, /^ {8}path: node_modules$/mu);
+    assert.ok(
+      restore.text.includes(`        key: ${NODE_MODULES_KEY}\n`),
+      "setup action: exact installed-packages key",
+    );
+    assert.equal(install.fields.get("id"), "install");
+    assert.equal(install.fields.get("run"), "node scripts/install-locked-dependencies.mjs");
+    assert.equal(install.fields.get("shell"), "bash");
+    assert.deepEqual(
+      install.text.split("\n").filter((line) => line.startsWith("        WARD_")),
+      ["        WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}"],
+    );
+  }
   // Dependency-free, bounded YAML subset: duplicate fields and comments cannot
   // supply executable evidence. Exact commands prevent shell failure suppression.
   source = source
@@ -81,7 +164,7 @@ function requireWorkflow(source) {
   ])
     assert.doesNotMatch(source, pattern);
   for (const match of source.matchAll(/^\s*(?:- )?uses: ([^\n]+)/gmu))
-    assert.match(match[1], /^[\w./-]+@[0-9a-f]{40}$/u);
+    if (match[1] !== SETUP_ACTION) assert.match(match[1], /^[\w./-]+@[0-9a-f]{40}$/u);
   for (const match of source.matchAll(/persist-credentials: ([^\n]+)/gu)) assert.equal(match[1], "false");
   assert.equal([...source.matchAll(/run: node scripts\/ward-ci-public\/plan\.mjs/g)].length, 1);
   exact("plan", "Plan Ward scope", "node scripts/ward-ci-public/plan.mjs");
@@ -135,9 +218,47 @@ function requireWorkflow(source) {
     );
     assert.ok(jobs.get(job)?.includes(`    if: ${route}\n`), `${job} job scope`);
     assert.match(jobs.get(job), /^ {4}needs: (?:plan|\[[^\n]*\bplan\b[^\n]*\])$/mu);
-    exact(job, "Install locked dependencies", "node scripts/install-locked-dependencies.mjs");
-    assert.equal(step(job, "Install locked dependencies").fields.get("id"), "install");
   }
+  // These jobs install through the shared setup action, unconditionally, after their checkout.
+  assert.deepEqual(
+    [...jobs.keys()].filter((job) => jobs.get(job).includes(SETUP_ACTION)),
+    SETUP_JOBS,
+    "jobs using the shared setup action",
+  );
+  for (const job of SETUP_JOBS) {
+    const entries = steps(job);
+    const setup = step(job, SETUP_STEP);
+    assert.equal(setup.fields.get("uses"), SETUP_ACTION, `${job}: shared setup action`);
+    assert.equal(setup.fields.get("id"), "install", `${job}: setup outcome is steps.install`);
+    assert.deepEqual(
+      [...setup.fields.keys()].sort(),
+      ["id", "name", "uses"],
+      `${job}: setup takes no inputs or condition`,
+    );
+    assert.equal(
+      entries.filter(({ fields }) => fields.get("uses")?.startsWith("actions/checkout@")).length,
+      1,
+      `${job}: one checkout`,
+    );
+    assert.ok(
+      entries.findIndex(({ fields }) => fields.get("uses")?.startsWith("actions/checkout@")) <
+        entries.findIndex(({ fields }) => fields.get("name") === SETUP_STEP),
+      `${job}: checkout before the local setup action`,
+    );
+    assert.doesNotMatch(jobs.get(job), /actions\/setup-node@|Install locked dependencies|steps\.node-modules\./u);
+  }
+  // A job reading steps.install has exactly one installer: the shared action or the inline steps.
+  for (const [job, body] of jobs) {
+    if (!body.includes("steps.install.")) continue;
+    const inline = steps(job).filter(({ fields }) => fields.get("name") === "Install locked dependencies").length;
+    const shared = steps(job).filter(({ fields }) => fields.get("name") === SETUP_STEP).length;
+    assert.equal(inline + shared, 1, `${job}: one dependency install`);
+    if (!inline) assert.doesNotMatch(body, /steps\.node-modules\./u, `${job}: restore outputs come from the action`);
+  }
+  // The action selects Node with the same pinned setup-node the plan job uses.
+  const planSetupNode = steps("plan").find(({ fields }) => fields.get("uses")?.startsWith("actions/setup-node@"));
+  assert.ok(planSetupNode, "plan: selects Node");
+  requireSetupAction(action, planSetupNode.fields.get("uses"));
   assert.equal(step("static", "Install locked dependencies").fields.get("id"), "install");
   // Installed packages come from a cache saved on main only, straight after an attested install; the
   // installer reuses an exact hit only when its own post-install stamp still matches (see
@@ -173,9 +294,19 @@ function requireWorkflow(source) {
     const names = steps("build").map(({ fields }) => fields.get("name"));
     assert.equal(
       names.indexOf("Save installed packages on main"),
-      names.indexOf("Install locked dependencies") + 1,
+      names.indexOf(SETUP_STEP) + 1,
       "build: installed packages are saved straight after the attested install",
     );
+    const save = step("build", "Save installed packages on main");
+    assert.equal(save.fields.get("uses"), "actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9");
+    assert.equal(
+      save.fields.get("if"),
+      expression(
+        "!cancelled() && github.ref == 'refs/heads/main' && github.event_name != 'pull_request' && steps.install.outcome == 'success' && steps.install.outputs.cache-hit != 'true'",
+      ),
+    );
+    assert.match(save.text, /^ {10}path: node_modules$/mu);
+    assert.ok(save.text.includes(`          key: ${expression("steps.install.outputs.cache-primary-key")}\n`));
   }
   exact(
     "static",
@@ -651,11 +782,7 @@ function requireWorkflow(source) {
     }
     if (body.includes("actions/setup-node@")) {
       assert.match(body, /node-version-file: \.nvmrc/u);
-      exact(
-        job,
-        "Install and record the pinned npm toolchain",
-        'npm install --global --ignore-scripts --no-audit --no-fund "$(node -p "require(\'./package.json\').packageManager")" && node --version && npm --version',
-      );
+      exact(job, "Install and record the pinned npm toolchain", NPM_PROVISION);
       const entries = steps(job);
       const provision = entries.findIndex(
         (entry) => entry.fields.get("name") === "Install and record the pinned npm toolchain",
@@ -768,7 +895,7 @@ function requireWorkflow(source) {
           fi`,
   );
 }
-requireWorkflow(workflow);
+requireWorkflow(workflow, setupAction);
 // Exercise the actual aggregate shell across every scope combination and every
 // failure/cancellation/missing-result branch, including the trusted reuse route.
 const verdictShell = /^ {8}run: \|\n([\s\S]*)$/mu.exec(workflow.slice(workflow.indexOf("  required:\n")))?.[1];
@@ -969,7 +1096,54 @@ for (const [before, after] of [
 ]) {
   const changed = workflow.replace(before, after);
   assert.notEqual(changed, workflow, before);
-  assert.throws(() => requireWorkflow(changed), before);
+  assert.throws(() => requireWorkflow(changed, setupAction), before);
+}
+// The same probes against the shared setup action, plus its wiring in the workflow.
+for (const [before, after] of [
+  ["run: npm install --global --ignore-scripts --no-audit --no-fund", "run: echo npm installation omitted"],
+  [
+    "      run: node scripts/install-locked-dependencies.mjs",
+    "      run: node scripts/install-locked-dependencies.mjs || true",
+  ],
+  ["      id: node-modules\n", "      id: unused-node-modules\n"],
+  ["      id: install\n", "      id: unused-install\n"],
+  ["        WARD_INSTALL_RESTORED: ${{ steps.node-modules.outputs.cache-hit }}", "        WARD_INSTALL_RESTORED: true"],
+  [
+    "        path: node_modules\n        key: ward-node-modules-",
+    "        path: node_modules\n        restore-keys: ward-\n        key: ward-node-modules-",
+  ],
+  ["        key: ward-node-modules-${{ runner.os }}-", "        key: ward-node-modules-"],
+  ["        node-version-file: .nvmrc\n", "        node-version: 24\n"],
+  ["        cache: npm\n", ""],
+  ["      shell: bash\n      run: npm", "      shell: bash {0}\n      run: npm"],
+  ["    - name: Restore installed packages\n", "    - name: Restore installed packages\n      if: ${{ false }}\n"],
+  [
+    "      uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9",
+    "      uses: actions/cache/restore@v4",
+  ],
+  ["    value: ${{ steps.node-modules.outputs.cache-primary-key }}", "    value: ward-node-modules"],
+  ["    value: ${{ steps.node-modules.outputs.cache-hit }}", "    value: 'false'"],
+]) {
+  const changed = setupAction.replace(before, after);
+  assert.notEqual(changed, setupAction, before);
+  assert.throws(() => requireWorkflow(workflow, changed), before);
+}
+for (const [before, after] of [
+  [`        uses: ./.github/actions/ward-setup\n`, "        uses: ./.github/actions/other\n"],
+  [
+    "        id: install\n        uses: ./.github/actions/ward-setup\n",
+    "        id: setup\n        uses: ./.github/actions/ward-setup\n",
+  ],
+  [
+    `        uses: ./.github/actions/ward-setup\n`,
+    "        if: ${{ false }}\n        uses: ./.github/actions/ward-setup\n",
+  ],
+  ["steps.install.outputs.cache-hit != 'true'", "true"],
+  ["key: ${{ steps.install.outputs.cache-primary-key }}", "key: ward-node-modules"],
+]) {
+  const changed = workflow.replace(before, after);
+  assert.notEqual(changed, workflow, before);
+  assert.throws(() => requireWorkflow(changed, setupAction), before);
 }
 assert.deepEqual(parseNameStatus("M\tdocs/ward-flow/README.md\n"), [{ status: "M", file: "docs/ward-flow/README.md" }]);
 // A document no unit test reads; tests/ward-ci-scope.test.ts covers documents unit tests do read.
diff --git a/tests/bot-author-policy.test.ts b/tests/bot-author-policy.test.ts
index 9eef5520a..d7be7b2a7 100644
--- a/tests/bot-author-policy.test.ts
+++ b/tests/bot-author-policy.test.ts
@@ -99,6 +99,16 @@ describe("bot-author PR policy", () => {
     expect(botSensitiveCommitViolations([{ sha: "f".repeat(40), author: dependabot, files: [workflow] }])).toHaveLength(
       1,
     );
+    // The workflows' local composite actions carry pins too, and get the same exemption.
+    const setupAction = ".github/actions/ward-setup/action.yml";
+    expect(
+      botSensitiveCommitViolations([
+        { sha: "f".repeat(40), author: dependabot, files: [setupAction], actionPinOnlyFiles: [setupAction] },
+      ]),
+    ).toEqual([]);
+    expect(
+      botSensitiveCommitViolations([{ sha: "f".repeat(40), author: dependabot, files: [setupAction] }]),
+    ).toHaveLength(1);
     // Only Dependabot gets the exemption, and only for workflow files.
     expect(
       botSensitiveCommitViolations([
@@ -140,6 +150,7 @@ describe("bot-author PR policy: coding-agent warn tier (A6-F02)", () => {
   it("protects workflows, public CI scripts and the protected safety tests", () => {
     for (const file of [
       ".github/workflows/ward-flow.yml",
+      ".github/actions/ward-setup/action.yml",
       "scripts/ward-ci-public/plan.mjs",
       "scripts/ward-ci-public/bot-author-policy.mjs",
       "scripts/ward-flow/protected-safety-tests.json",
diff --git a/tests/ci-cache-safety.test.ts b/tests/ci-cache-safety.test.ts
index f534af3e3..d5736a72a 100644
--- a/tests/ci-cache-safety.test.ts
+++ b/tests/ci-cache-safety.test.ts
@@ -6,7 +6,8 @@ import { describe, expect, it } from "vitest";
 // baseline and Lighthouse routing) and the three unused composite actions under `.github/actions/`
 // were removed on 15 October 2026. `ci.yml` does not exist in this repository, so those suites had
 // been skipped on every run. Ward Flow CI is `.github/workflows/ward-flow.yml`, whose contracts live
-// in `scripts/ward-ci-public/check-contracts.mjs`.
+// in `scripts/ward-ci-public/check-contracts.mjs`. Its one local action, `.github/actions/ward-setup`,
+// was added on 11 November 2026 and is held to the same contracts there.
 
 describe("CI cache safety", () => {
   it("does not add a PR workflow that changes user-owned auto-merge state", () => {
@@ -18,5 +19,9 @@ describe("CI cache safety", () => {
     expect(existsSync(wardCiUrl)).toBe(true);
     const wardWorkflow = readFileSync(wardCiUrl, "utf8");
     expect(wardWorkflow).toContain("cache: npm");
+    // The install jobs select Node through the shared setup action, which keeps npm's cache too.
+    const setupAction = readFileSync(new URL("../.github/actions/ward-setup/action.yml", import.meta.url), "utf8");
+    expect(wardWorkflow).toContain("uses: ./.github/actions/ward-setup");
+    expect(setupAction).toMatch(/^ {8}cache: npm$/mu);
   });
 });
diff --git a/tests/ci-remediation-contracts.test.ts b/tests/ci-remediation-contracts.test.ts
index cc27bfccb..4fc137bbd 100644
--- a/tests/ci-remediation-contracts.test.ts
+++ b/tests/ci-remediation-contracts.test.ts
@@ -4,14 +4,21 @@ import vm from "node:vm";
 import { describe, expect, it } from "vitest";
 
 const workflow = readFileSync(".github/workflows/ward-flow.yml", "utf8");
+// The install jobs' shared setup action, checked together with the workflow.
+const setupAction = readFileSync(".github/actions/ward-setup/action.yml", "utf8");
 const checker = readFileSync("scripts/ward-ci-public/check-contracts.mjs", "utf8");
-const start = checker.indexOf("function requireWorkflow(source) {");
-const end = checker.indexOf("\nrequireWorkflow(workflow);", start);
-const verify = vm.runInNewContext(`(${checker.slice(start, end).trim()})`, { assert }) as (source: string) => void;
+const start = checker.indexOf("function requireWorkflow(source, action) {");
+const end = checker.indexOf("\nrequireWorkflow(workflow, setupAction);", start);
+const verify = vm.runInNewContext(`(${checker.slice(start, end).trim()})`, { assert }) as (
+  source: string,
+  action: string,
+) => void;
 
 describe("CI remediation wiring", () => {
   it("accepts the complete enforcing workflow", () => {
-    expect(() => verify(workflow)).not.toThrow();
+    expect(start).toBeGreaterThan(-1);
+    expect(end).toBeGreaterThan(start);
+    expect(() => verify(workflow, setupAction)).not.toThrow();
   });
 
   it("plans before allocating the unit and browser runner matrices", () => {
@@ -73,6 +80,15 @@ describe("CI remediation wiring", () => {
   ])("rejects silently disabling %s", (_label, mutate) => {
     const changed = mutate(workflow);
     expect(changed).not.toBe(workflow);
-    expect(() => verify(changed)).toThrow();
+    expect(() => verify(changed, setupAction)).toThrow();
+  });
+
+  it("rejects a shared setup action that stops attesting the install", () => {
+    const changed = setupAction.replace(
+      "run: node scripts/install-locked-dependencies.mjs",
+      "run: node scripts/install-locked-dependencies.mjs || true",
+    );
+    expect(changed).not.toBe(setupAction);
+    expect(() => verify(workflow, changed)).toThrow();
   });
 });
diff --git a/tests/ward-audit-m55-supply-chain.test.ts b/tests/ward-audit-m55-supply-chain.test.ts
index 0c1780c09..aef6a2ecc 100644
--- a/tests/ward-audit-m55-supply-chain.test.ts
+++ b/tests/ward-audit-m55-supply-chain.test.ts
@@ -10,6 +10,9 @@ const ROOT = path.resolve(__dirname, "..");
 const WORKFLOWS = path.join(ROOT, ".github/workflows");
 const workflowNames = readdirSync(WORKFLOWS).filter((name) => /\.ya?ml$/.test(name));
 const workflow = (name: string) => readFileSync(path.join(WORKFLOWS, name), "utf8");
+// Local composite actions the workflows call (`uses: ./.github/actions/...`) hold pins as well.
+const ACTIONS = path.join(ROOT, ".github/actions");
+const actionNames = readdirSync(ACTIONS).map((name) => `${name}/action.yml`);
 
 describe("M55 workflows pin actions and declare permissions", () => {
   it("reads every workflow", () => {
@@ -31,6 +34,20 @@ describe("M55 workflows pin actions and declare permissions", () => {
     expect(unpinned).toEqual([]);
   });
 
+  it("reads every local action", () => {
+    expect(actionNames).toContain("ward-setup/action.yml");
+  });
+
+  it.each(actionNames)("local action %s pins every action to a full commit", (name) => {
+    const refs = readFileSync(path.join(ACTIONS, name), "utf8")
+      .split("\n")
+      .map((line) => line.replace(/\s+#.*$/, ""))
+      .filter((line) => /^\s*(-\s+)?uses:/.test(line))
+      .map((line) => line.replace(/^\s*(-\s+)?uses:\s*/, "").trim());
+    expect(refs.length).toBeGreaterThan(0);
+    expect(refs.filter((ref) => !/^[\w.-]+\/[\w./-]+@[0-9a-f]{40}$/.test(ref))).toEqual([]);
+  });
+
   it.each(workflowNames)("%s declares its permissions at the top", (name) => {
     expect(workflow(name)).toMatch(/^permissions:/m);
     expect(workflow(name)).not.toMatch(/^\s*permissions:\s*write-all\b/m);
@@ -50,7 +67,7 @@ describe("M55 workflows pin actions and declare permissions", () => {
     const config = readFileSync(path.join(ROOT, ".github/dependabot.yml"), "utf8");
     expect(config).toMatch(/package-ecosystem: npm\s+directory: \/\n/);
     expect(config).toMatch(/package-ecosystem: npm\s+directory: \/backend\/ward-flow/);
-    expect(config).toMatch(/package-ecosystem: github-actions/);
+    expect(config).toMatch(/package-ecosystem: github-actions\s+directories: \["\/", "\/\.github\/actions\/\*"\]\n/);
   });
 });
 
diff --git a/tests/ward-backend-ci.test.ts b/tests/ward-backend-ci.test.ts
index 0fdebf139..5e11439b9 100644
--- a/tests/ward-backend-ci.test.ts
+++ b/tests/ward-backend-ci.test.ts
@@ -60,7 +60,11 @@ describe("Ward backend CI", () => {
       "needs.plan.outputs.backend == 'true' && needs.reuse.outputs.backend_verified != 'true'",
     );
     expect(backendJob?.text).toContain("needs.plan.result == 'success'");
-    expect(backendJob?.text).toMatch(/^\s*run: node scripts\/install-locked-dependencies\.mjs\s*$/mu);
+    // The root install runs inside the shared setup action, whose outcome is steps.install.
+    expect(backendJob?.text).toMatch(/^\s*id: install\n\s*uses: \.\/\.github\/actions\/ward-setup\s*$/mu);
+    expect(readFileSync(new URL("../.github/actions/ward-setup/action.yml", import.meta.url), "utf8")).toMatch(
+      /^\s*run: node scripts\/install-locked-dependencies\.mjs\s*$/mu,
+    );
     expect(backendJob?.text).toMatch(/^\s*image:\s*postgres:16@sha256:[0-9a-f]{64}\s*$/mu);
     expect(backendJob?.text).toMatch(/^\s*POSTGRES_DB:\s*wardflow_test\s*$/mu);
     expect(backendJob?.text).toMatch(/^\s*ports:\s*\[\s*"127\.0\.0\.1:5432:5432"\s*\]\s*$/mu);

From ac53e6b59c4d31a69145911b7aefe0b356c41177 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:10:53 +0000
Subject: [PATCH 09/40] Read pull-hold lapse through the one bed-hold rule

Movements and the fixed questions used pullExpiresAt < now, so a pull at its
limit read as held there and lapsed everywhere else. Both now call bedHoldLapsed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../movements/movements-screen-helpers.ts      |  3 ++-
 .../ward-management/reports/fixed-questions.ts |  3 ++-
 tests/ward-fixed-questions.test.ts             | 12 ++++++++++++
 tests/ward-pull-hold-boundary.test.ts          | 18 ++++++++++++++++++
 4 files changed, 34 insertions(+), 2 deletions(-)
 create mode 100644 tests/ward-pull-hold-boundary.test.ts

diff --git a/src/components/ward-management/movements/movements-screen-helpers.ts b/src/components/ward-management/movements/movements-screen-helpers.ts
index 00e4b261f..50a88f2bc 100644
--- a/src/components/ward-management/movements/movements-screen-helpers.ts
+++ b/src/components/ward-management/movements/movements-screen-helpers.ts
@@ -3,6 +3,7 @@
 // of movements-screen.tsx to keep that file under the line cap; movements-screen.tsx re-exports
 // causeOf and inServiceSuffix.
 import { type Instant } from "@/components/ward-management/ward-clock";
+import { bedHoldLapsed } from "@/components/ward-management/ward-bed-hold";
 import { isOpen, transportLeg, transportNeedState } from "@/components/ward-management/ward-derivations";
 import { type DelayCause } from "@/components/ward-management/delays/delays-derivations";
 import { edById } from "@/components/ward-management/ward-sites";
@@ -159,7 +160,7 @@ export function causeOf(
 
   if (noAccepted && hasReferred) return "awaiting_ward_answer";
 
-  if (movement.stage === "pulled" && movement.pullExpiresAt !== undefined && movement.pullExpiresAt < now) {
+  if (movement.stage === "pulled" && bedHoldLapsed(movement.pullExpiresAt, now)) {
     return "bed_pull_expired";
   }
 
diff --git a/src/components/ward-management/reports/fixed-questions.ts b/src/components/ward-management/reports/fixed-questions.ts
index 6852fd43b..d2a98c172 100644
--- a/src/components/ward-management/reports/fixed-questions.ts
+++ b/src/components/ward-management/reports/fixed-questions.ts
@@ -6,6 +6,7 @@
 // came from so the screen can link to it. Nothing here releases, books or changes anything.
 import type { Admission } from "@/components/ward-management/ward-admissions";
 import { formatInstantWithDay, type Instant } from "@/components/ward-management/ward-clock";
+import { bedHoldLapsed } from "@/components/ward-management/ward-bed-hold";
 import { transportNeedState } from "@/components/ward-management/ward-derivations-transport";
 import type { BedRelease, Movement, MovementStage, Unit } from "@/components/ward-management/ward-model";
 import { originName } from "@/components/ward-management/ward-movement-origin";
@@ -138,7 +139,7 @@ export function fixedQuestionAnswers(input: FixedQuestionInput): FixedAnswer[] {
 
   const pastLimit = movements
     .filter((movement) => open(movement) && movement.stage === "pulled")
-    .filter((movement) => movement.pullExpiresAt !== undefined && movement.pullExpiresAt < now)
+    .filter((movement) => bedHoldLapsed(movement.pullExpiresAt, now))
     .map((movement) =>
       movementRow(
         movement,
diff --git a/tests/ward-fixed-questions.test.ts b/tests/ward-fixed-questions.test.ts
index d2356caff..1ac38bfdf 100644
--- a/tests/ward-fixed-questions.test.ts
+++ b/tests/ward-fixed-questions.test.ts
@@ -54,6 +54,18 @@ describe("fixedQuestionAnswers", () => {
     expect(row?.detail).toContain("until a person releases it");
   });
 
+  it("counts a pull as past its limit at the limit itself, the same boundary as the bed-hold rule", () => {
+    const state = seedWardFlowState();
+    const pulled = state.movements.find((movement) => movement.stage === "pulled")!;
+    const at = (pullExpiresAt: number) =>
+      rowsOf(
+        "pulls_past_limit",
+        state.movements.map((movement) => (movement.id === pulled.id ? { ...movement, pullExpiresAt } : movement)),
+      ).map((row) => row.key);
+    expect(at(NOW_ANCHOR)).toContain(pulled.id);
+    expect(at(NOW_ANCHOR + 1)).not.toContain(pulled.id);
+  });
+
   it("lists open requests with no ward asked, in recorded order", () => {
     const state = seedWardFlowState();
     const keys = rowsOf("requests_no_ward_asked").map((row) => row.key);
diff --git a/tests/ward-pull-hold-boundary.test.ts b/tests/ward-pull-hold-boundary.test.ts
new file mode 100644
index 000000000..0604483e5
--- /dev/null
+++ b/tests/ward-pull-hold-boundary.test.ts
@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+
+import { causeOf } from "@/components/ward-management/movements/movements-screen-helpers";
+import { bedHoldLapsed } from "@/components/ward-management/ward-bed-hold";
+import { seedWardFlowState } from "@/components/ward-management/ward-flow-reducer";
+import { NOW_ANCHOR } from "@/components/ward-management/ward-sites";
+
+// One bed-hold boundary: Movements reads a pull as lapsed at its limit, exactly as `bedHold` does.
+describe("Movements pull-hold boundary", () => {
+  it("calls a pull expired at the limit itself, the same as the bed-hold rule", () => {
+    const state = seedWardFlowState();
+    const pulled = state.movements.find((movement) => movement.stage === "pulled")!;
+    const at = { ...pulled, pullExpiresAt: NOW_ANCHOR };
+    expect(bedHoldLapsed(NOW_ANCHOR, NOW_ANCHOR)).toBe(true);
+    expect(causeOf(at, NOW_ANCHOR, new Map())).toBe("bed_pull_expired");
+    expect(causeOf({ ...pulled, pullExpiresAt: NOW_ANCHOR + 1 }, NOW_ANCHOR, new Map())).not.toBe("bed_pull_expired");
+  });
+});

From 3fc32f77ae3c6c979b7b72f3a2be8bb25e486b1e Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:10:54 +0000
Subject: [PATCH 10/40] Keep the staff request shift the desk chose

The shared server stamps its own now, so This shift pressed at 14:59 and saved
after 15:00 landed on the next shift. The sheet now sends shiftStartAt; the
reducer keeps it only when it is the chosen shift's start within 5 minutes of
now, otherwise it reads the shift at now. The shared command schema types it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 backend/ward-flow/command-schemas.ts          |  2 +
 .../staffing/staff-needed-sheet.tsx           |  2 +
 .../staffing/staff-requests.ts                | 28 ++++++++++-
 tests/ward-staff-requests.test.ts             | 46 ++++++++++++++++++-
 4 files changed, 75 insertions(+), 3 deletions(-)

diff --git a/backend/ward-flow/command-schemas.ts b/backend/ward-flow/command-schemas.ts
index 35ca807d4..ba7881523 100644
--- a/backend/ward-flow/command-schemas.ts
+++ b/backend/ward-flow/command-schemas.ts
@@ -129,6 +129,8 @@ const SCHEMAS: Partial<Record<WardFlowEvent["type"], z.ZodType>> = {
   FLAG_RETURN_EARLY: z.looseObject({ admissionId: id, homeHospital: id }),
   RECORD_MEDICAL_CLEARANCE: z.looseObject({ referralId: id, cleared: z.boolean() }),
   REQUEST_CAPACITY_REFRESH: z.looseObject({ unitId: id }),
+  // Staff needed: the shift start the desk chose, when sent. The reducer checks it against now.
+  REQUEST_WARD_STAFF: z.looseObject({ shiftStartAt: instant.optional() }),
   // H-0978: one exact bed closed or reopened. The reducer checks the bed and the reason list.
   SET_BED_CLOSED: z.looseObject({ unitId: id, actingUnitId: id, bedNumber: count, closed: z.boolean() }),
   CONFIRM_CAPACITY: z.looseObject({
diff --git a/src/components/ward-management/staffing/staff-needed-sheet.tsx b/src/components/ward-management/staffing/staff-needed-sheet.tsx
index bf47c8e3c..fd37dcc95 100644
--- a/src/components/ward-management/staffing/staff-needed-sheet.tsx
+++ b/src/components/ward-management/staffing/staff-needed-sheet.tsx
@@ -15,6 +15,7 @@ import {
   STAFF_REQUEST_SHIFTS,
   openStaffRequests,
   staffCountLabel,
+  staffRequestShiftStart,
   staffRequestShiftWord,
   type StaffRequestCount,
   type StaffRequestReason,
@@ -119,6 +120,7 @@ export function StaffNeededSheet({
                     unitId,
                     ...(actingUnitId ? { actingUnitId } : {}),
                     shift,
+                    shiftStartAt: staffRequestShiftStart(shift, now),
                     count,
                     reasons,
                   }),
diff --git a/src/components/ward-management/staffing/staff-requests.ts b/src/components/ward-management/staffing/staff-requests.ts
index 5cccb540e..d1cd75543 100644
--- a/src/components/ward-management/staffing/staff-requests.ts
+++ b/src/components/ward-management/staffing/staff-requests.ts
@@ -72,6 +72,13 @@ export type StaffRequestEvent =
       /** Claim, not proof, as `SET_BED_CLOSED`: required of a ward desk, which asks for itself only. */
       actingUnitId?: string;
       shift: StaffRequestShift;
+      /**
+       * The start of the shift the desk chose, read on its own clock when it pressed save. The
+       * shared server stamps its own `now`, so without this a "This shift" pressed at 14:59 and
+       * saved at 15:00 would land on the 15:00 shift. The reducer keeps it only when it is the
+       * chosen shift's start within `STAFF_REQUEST_SHIFT_TOLERANCE_MINUTES` of `now`.
+       */
+      shiftStartAt?: number;
       count: StaffRequestCount;
       reasons: StaffRequestReason[];
     }
@@ -125,10 +132,27 @@ export function staffRequestTagText(record: StaffRequestRecord, now: Instant): s
   return `Staff requested ${formatInstantWithDay(record.updatedAt ?? record.requestedAt, now)} · ${record.count >= 4 ? "4+" : record.count} · ${staffRequestShiftWord(record, now)}`;
 }
 
-function shiftStartFor(shift: StaffRequestShift, now: Instant): Instant {
+/** The start of the shift a "This shift" or "Next shift" choice names at `now`. */
+export function staffRequestShiftStart(shift: StaffRequestShift, now: Instant): Instant {
   return shift === "this_shift" ? currentShiftStartInstant(now) : shiftEndInstant(now);
 }
 
+/** How long a save may take to reach the shared board and still keep the shift the desk chose. */
+export const STAFF_REQUEST_SHIFT_TOLERANCE_MINUTES = 5;
+
+/**
+ * The shift the request is for: the desk's own `shiftStartAt` when it is what the chosen word
+ * meant at some moment within the tolerance before `now`, otherwise the shift read at `now`.
+ * Shifts are hours long, so checking both ends of the window covers every moment in it.
+ */
+function chosenShiftStart(event: Extract<StaffRequestEvent, { type: "REQUEST_WARD_STAFF" }>): Instant {
+  const atNow = staffRequestShiftStart(event.shift, event.now);
+  const chosen = event.shiftStartAt;
+  if (typeof chosen !== "number" || !Number.isFinite(chosen)) return atNow;
+  const pressedAt = event.now - STAFF_REQUEST_SHIFT_TOLERANCE_MINUTES;
+  return chosen === atNow || chosen === staffRequestShiftStart(event.shift, pressedAt) ? chosen : atNow;
+}
+
 export function reduceStaffRequest(state: WardFlowState, event: StaffRequestEvent, reject: Reject): WardFlowState {
   const records = state.staffRequests ?? [];
   if (event.role === "ward" && event.actingUnitId !== event.unitId)
@@ -147,7 +171,7 @@ export function reduceStaffRequest(state: WardFlowState, event: StaffRequestEven
       !reasons.every((reason) => STAFF_REQUEST_REASONS.includes(reason))
     )
       return reject(state, event, "REQUEST_WARD_STAFF needs one or more reasons chosen from the list");
-    const shiftStartAt = shiftStartFor(event.shift, event.now);
+    const shiftStartAt = chosenShiftStart(event);
     const ordered = STAFF_REQUEST_REASONS.filter((reason) => reasons.includes(reason));
     // One open request per ward per shift: asking again updates it rather than adding a second.
     const existing = records.find(
diff --git a/tests/ward-staff-requests.test.ts b/tests/ward-staff-requests.test.ts
index f85576fc7..e331ed37a 100644
--- a/tests/ward-staff-requests.test.ts
+++ b/tests/ward-staff-requests.test.ts
@@ -5,10 +5,13 @@ import { describe, expect, it } from "vitest";
 import {
   openStaffRequestFor,
   openStaffRequests,
+  STAFF_REQUEST_SHIFT_TOLERANCE_MINUTES,
+  staffRequestShiftStart,
   staffRequestTagText,
   type StaffRequestEvent,
 } from "@/components/ward-management/staffing/staff-requests";
-import { shiftEndInstant } from "@/components/ward-management/ward-board-time-features";
+import { currentShiftStartInstant, shiftEndInstant } from "@/components/ward-management/ward-board-time-features";
+import { validSharedCommand } from "../backend/ward-flow/command-schemas";
 import { seedWardFlowState, wardFlowReducer, type WardFlowState } from "@/components/ward-management/ward-flow-reducer";
 import { isValidStoredWardFlowState } from "@/components/ward-management/ward-flow-storage-validation";
 import { NOW_ANCHOR } from "@/components/ward-management/ward-sites";
@@ -129,4 +132,45 @@ describe("staff needed requests", () => {
     expect(openStaffRequestFor(asked.staffRequests, UNIT, end - 1)).toBeDefined();
     expect(openStaffRequestFor(asked.staffRequests, UNIT, end)).toBeUndefined();
   });
+
+  it("keeps the shift the desk chose when the shared save lands just after the shift changes", () => {
+    const boundary = shiftEndInstant(NOW_ANCHOR);
+    const pressedAt = boundary - 1;
+    const savedAt = boundary + 1;
+    const startOf = (state: WardFlowState) =>
+      state.staffRequests!.filter((record) => record.unitId === UNIT).at(-1)!.shiftStartAt;
+    for (const shift of ["this_shift", "next_shift"] as const) {
+      const chosen = staffRequestShiftStart(shift, pressedAt);
+      const kept = wardFlowReducer(seed, ask({ shift, now: savedAt, shiftStartAt: chosen }));
+      expect(refused(seed, kept)).toBe(false);
+      expect(startOf(kept)).toBe(chosen);
+      // Without the desk's choice, the server's later clock reads the next shift (the old bug).
+      expect(startOf(wardFlowReducer(seed, ask({ shift, now: savedAt })))).toBe(staffRequestShiftStart(shift, savedAt));
+    }
+    expect(staffRequestShiftStart("this_shift", pressedAt)).toBe(currentShiftStartInstant(NOW_ANCHOR));
+  });
+
+  it("falls back to the shift at now when the sent shift start is not the chosen shift's", () => {
+    const boundary = shiftEndInstant(NOW_ANCHOR);
+    const savedAt = boundary + STAFF_REQUEST_SHIFT_TOLERANCE_MINUTES + 1;
+    const startOf = (state: WardFlowState) =>
+      state.staffRequests!.filter((record) => record.unitId === UNIT).at(-1)!.shiftStartAt;
+    const atNow = staffRequestShiftStart("this_shift", savedAt);
+    // Pressed too long before the save, a far-off time, the other shift's start and a bad number.
+    for (const shiftStartAt of [
+      staffRequestShiftStart("this_shift", boundary - 1),
+      NOW_ANCHOR + 10_000,
+      staffRequestShiftStart("next_shift", savedAt),
+      Number.NaN,
+    ]) {
+      expect(startOf(wardFlowReducer(seed, ask({ now: savedAt, shiftStartAt })))).toBe(atNow);
+    }
+  });
+
+  it("lets the shared command carry the chosen shift start as a number only", () => {
+    const command = { ...ask(), shiftStartAt: currentShiftStartInstant(NOW_ANCHOR) };
+    expect(validSharedCommand(command)).toBe(true);
+    expect(validSharedCommand(ask())).toBe(true);
+    expect(validSharedCommand({ ...command, shiftStartAt: "07:00" })).toBe(false);
+  });
 });

From 0bb1ee41629b7049f92dfb36008810b92dc7cd33 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:10:54 +0000
Subject: [PATCH 11/40] Parse typed times through minuteOfDayFromClockText

Planned admissions and release-day times accepted HH:MM only, while the clock
rule elsewhere takes 9:30 and 0930. Both now use the one rule.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../capacity/planned-admissions-draft.ts      | 13 +++++------
 .../ward-management/ward/release-day.ts       | 23 +++++++------------
 tests/ward-planned-admissions-draft.test.ts   |  8 +++++--
 tests/ward-release-day.test.ts                |  6 ++++-
 4 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/src/components/ward-management/capacity/planned-admissions-draft.ts b/src/components/ward-management/capacity/planned-admissions-draft.ts
index 705bb42c7..dd070ff0b 100644
--- a/src/components/ward-management/capacity/planned-admissions-draft.ts
+++ b/src/components/ward-management/capacity/planned-admissions-draft.ts
@@ -10,7 +10,7 @@ import {
   type PlannedAdmissionReason,
 } from "../ward-admissions";
 import type { OverrideReason } from "../ward-change-reasons";
-import { dayOf, MINUTES_PER_DAY, minuteOfDay, type Instant } from "../ward-clock";
+import { dayOf, MINUTES_PER_DAY, minuteOfDay, minuteOfDayFromClockText, type Instant } from "../ward-clock";
 import { requiresAuthorisedDestination } from "../ward-eligibility";
 import type { Cohort, LegalStatus, RecordedSex, ReferralGender, Unit } from "../ward-model";
 
@@ -65,13 +65,12 @@ export function clockInputValue(instant: Instant): string {
   return `${String(Math.floor(minute / 60)).padStart(2, "0")}:${String(minute % 60).padStart(2, "0")}`;
 }
 
-/** Minutes past midnight for a typed "hh:mm", or null when it is not a clock time. */
+/**
+ * Minutes past midnight for a typed time, or null when it is not a clock time. Reads the one
+ * clock-text rule (`minuteOfDayFromClockText`), so "9:05" and "0905" count here as everywhere else.
+ */
 export function parseClockInput(value: string): number | null {
-  const match = /^(\d{2}):(\d{2})$/.exec(value);
-  if (!match) return null;
-  const hours = Number(match[1]);
-  const minutes = Number(match[2]);
-  return hours < 24 && minutes < 60 ? hours * 60 + minutes : null;
+  return minuteOfDayFromClockText(value) ?? null;
 }
 
 /**
diff --git a/src/components/ward-management/ward/release-day.ts b/src/components/ward-management/ward/release-day.ts
index b7e1adef0..a66c835f4 100644
--- a/src/components/ward-management/ward/release-day.ts
+++ b/src/components/ward-management/ward/release-day.ts
@@ -1,4 +1,9 @@
-import { MINUTES_PER_DAY, dayOf, type Instant } from "@/components/ward-management/ward-clock";
+import {
+  MINUTES_PER_DAY,
+  dayOf,
+  minuteOfDayFromClockText,
+  type Instant,
+} from "@/components/ward-management/ward-clock";
 
 /**
  * Task F1 (owner answer 32): a bed-release or leave-bed time is typed with a Today/Tomorrow
@@ -10,19 +15,6 @@ export type ReleaseDay = "today" | "tomorrow";
 /** Rendered in this fixed order; the chooser is exactly these two options, never free text. */
 export const RELEASE_DAYS: readonly ReleaseDay[] = ["today", "tomorrow"];
 
-/**
- * Parses an `<input type="time">`'s `HH:MM` value into a minute-of-day, 0-1439. Malformed or
- * empty text refuses rather than guesses — same discipline the function this replaces used.
- */
-function parseTimeInputToMinuteOfDay(value: string): number | undefined {
-  const match = /^(\d{2}):(\d{2})$/.exec(value);
-  if (!match) return undefined;
-  const hours = Number(match[1]);
-  const minutes = Number(match[2]);
-  if (hours > 23 || minutes > 59) return undefined;
-  return hours * 60 + minutes;
-}
-
 /**
  * Resolves a typed `HH:MM` plus a Today/Tomorrow choice against the live clock into an `Instant`.
  *
@@ -43,7 +35,8 @@ function parseTimeInputToMinuteOfDay(value: string): number | undefined {
  * Returns `undefined` for an empty or malformed time, exactly like the function this replaces.
  */
 export function parseReleaseDayInstant(now: Instant, day: ReleaseDay, value: string): Instant | undefined {
-  const minuteOfDay = parseTimeInputToMinuteOfDay(value);
+  // The one clock-text rule: "14:00", "9:30" and "0930" all count; malformed or empty refuses.
+  const minuteOfDay = minuteOfDayFromClockText(value);
   if (minuteOfDay === undefined) return undefined;
   const targetDay = dayOf(now) + (day === "tomorrow" ? 1 : 0);
   return targetDay * MINUTES_PER_DAY + minuteOfDay;
diff --git a/tests/ward-planned-admissions-draft.test.ts b/tests/ward-planned-admissions-draft.test.ts
index a05d04157..e5cfc7f49 100644
--- a/tests/ward-planned-admissions-draft.test.ts
+++ b/tests/ward-planned-admissions-draft.test.ts
@@ -40,11 +40,15 @@ describe("applyDraftPatch", () => {
 });
 
 describe("clock input", () => {
-  it("round-trips an instant's time of day and refuses what is not hh:mm", () => {
+  it("round-trips an instant's time of day and refuses what is not a clock time", () => {
     expect(clockInputValue(MINUTES_PER_DAY + 9 * 60 + 5)).toBe("09:05");
     expect(parseClockInput("09:05")).toBe(9 * 60 + 5);
     expect(parseClockInput("24:00")).toBeNull();
-    expect(parseClockInput("9:05")).toBeNull();
+    // The one clock-text rule (minuteOfDayFromClockText): "9:05" and "0905" count as 09:05.
+    expect(parseClockInput("9:05")).toBe(9 * 60 + 5);
+    expect(parseClockInput("0905")).toBe(9 * 60 + 5);
+    expect(parseClockInput("9h05")).toBeNull();
+    expect(parseClockInput("905")).toBeNull();
     expect(parseClockInput("")).toBeNull();
   });
 });
diff --git a/tests/ward-release-day.test.ts b/tests/ward-release-day.test.ts
index aa1b07966..c28203cd2 100644
--- a/tests/ward-release-day.test.ts
+++ b/tests/ward-release-day.test.ts
@@ -25,6 +25,9 @@ describe("parseReleaseDayInstant", () => {
     // Naive day-zero parsing would give 840 (0 * 1440 + 840). The clock is on day 1, so a
     // same-day pick must land on day 1.
     expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "14:00")).toBe(1 * MINUTES_PER_DAY + 840);
+    // The one clock-text rule (minuteOfDayFromClockText): one-digit hours and four digits count too.
+    expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "9:30")).toBe(1 * MINUTES_PER_DAY + 570);
+    expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "1400")).toBe(1 * MINUTES_PER_DAY + 840);
   });
 
   it("resolves Tomorrow to the calendar day after the clock's own day", () => {
@@ -46,7 +49,8 @@ describe("parseReleaseDayInstant", () => {
 
   it("refuses malformed or empty input rather than guessing a value", () => {
     expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "")).toBeUndefined();
-    expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "9:00")).toBeUndefined();
+    expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "9h00")).toBeUndefined();
+    expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "143")).toBeUndefined();
     expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "24:00")).toBeUndefined();
     expect(parseReleaseDayInstant(NOW_DAY_1_AT_10, "today", "10:60")).toBeUndefined();
   });

From e8f5e1e17f857f6c68d5f169fc69acb5a8328e06 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:10:54 +0000
Subject: [PATCH 12/40] Use daysInBed for statistics length of stay

Two private stayDays copies dropped a future arrival that daysInBed (and the
stay bands) count as 0. Past-arrival figures are unchanged; statistics tests pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../statistics/executive-statistics-derivations.ts    |  8 ++------
 .../statistics/statistics-wards-index.tsx             | 11 ++---------
 2 files changed, 4 insertions(+), 15 deletions(-)

diff --git a/src/components/ward-management/statistics/executive-statistics-derivations.ts b/src/components/ward-management/statistics/executive-statistics-derivations.ts
index 0421d774f..956ff9d3d 100644
--- a/src/components/ward-management/statistics/executive-statistics-derivations.ts
+++ b/src/components/ward-management/statistics/executive-statistics-derivations.ts
@@ -1,6 +1,6 @@
 import type { WardFlowState } from "../ward-flow-reducer";
 import { wardStatistics } from "../ward-statistics";
-import { bedIsOccupied, endedInWardTransfer, STAY_BANDS, stayBand } from "../ward-admissions";
+import { bedIsOccupied, daysInBed, endedInWardTransfer, STAY_BANDS, stayBand } from "../ward-admissions";
 import { dayOf, MINUTES_PER_DAY, isClockBreached } from "../ward-clock";
 import { openBedsNow, bedsPendingPreparation } from "../ward-bed-availability";
 import { dischargeDateCoverage } from "./statistics-ward-discharge-dates";
@@ -42,10 +42,6 @@ import { isEdOriginJourney } from "../ward-ed-presence";
 import { readyBedsNow } from "../ward-bed-states";
 import { lockedBedsFree, openBedsFree } from "../ward-bed-designation";
 
-function stayDays(arrivedAt: number | null, now: number): number | null {
-  return arrivedAt === null || arrivedAt > now ? null : Math.floor((now - arrivedAt) / MINUTES_PER_DAY);
-}
-
 export type ExecutivePrivateInput = WeeklyReportInput &
   Pick<WardFlowState, "morningRollupConfirmations"> & {
     pullHoldMinutes: number;
@@ -148,7 +144,7 @@ export function executiveWardSummary(ward: PublicWard, input: ExecutivePrivateIn
   release.partition(dischargeDateOutcomes.consideredCount, [dischargeDateOutcomes.met, dischargeDateOutcomes.missed]);
   const stays = currentRows
     .filter(bedIsOccupied)
-    .map((row) => stayDays(row.arrivedAt, now))
+    .map((row) => daysInBed(row, now))
     .filter((value): value is number => value !== null);
   const longStays = c("longStays", statistics.longStays);
   const longStayBand = stayBands.find((band) => band.id === "over-3-months");
diff --git a/src/components/ward-management/statistics/statistics-wards-index.tsx b/src/components/ward-management/statistics/statistics-wards-index.tsx
index 35757c17a..8fb894d18 100644
--- a/src/components/ward-management/statistics/statistics-wards-index.tsx
+++ b/src/components/ward-management/statistics/statistics-wards-index.tsx
@@ -26,7 +26,7 @@ import {
 } from "@/components/wf";
 import { wardStatisticsHref } from "@/components/ward-management/shell/ward-facade";
 import { BED_ALERT_THRESHOLD_PERCENT } from "@/components/ward-management/shell/ward-service-bed-alerts";
-import { bedIsOccupied } from "@/components/ward-management/ward-admissions";
+import { bedIsOccupied, daysInBed } from "@/components/ward-management/ward-admissions";
 import { bedsPendingPreparation } from "@/components/ward-management/ward-bed-availability";
 import { BED_STATE_LABELS, bedStates } from "@/components/ward-management/ward-bed-states";
 import {
@@ -36,7 +36,6 @@ import {
   OCCUPIED_NOUN,
   wardBedsInUse,
 } from "@/components/ward-management/ward-occupancy";
-import { MINUTES_PER_DAY } from "@/components/ward-management/ward-clock";
 import { wardServiceOrder } from "@/components/ward-management/ward-derivations";
 import type { HealthService } from "@/components/ward-management/ward-model";
 import { siteByCode } from "@/components/ward-management/ward-sites";
@@ -101,12 +100,6 @@ export function SortTh<K extends string>({
 
 type WardChip = "over" | "none-ready" | "pending" | "pulled" | "blocked";
 
-/** Whole days in a bed so far, or null for someone not yet arrived (or a clock wound back). */
-function stayDays(arrivedAt: number | null, now: number): number | null {
-  if (arrivedAt === null || arrivedAt > now) return null;
-  return Math.floor((now - arrivedAt) / MINUTES_PER_DAY);
-}
-
 const plural = (count: StatisticsCount, one: string, many: string) => (count === 1 ? one : many);
 
 /** How much of the list shows before Show more. */
@@ -196,7 +189,7 @@ function OperationalWardsIndex() {
         );
         const stays = current
           .filter((admission) => bedIsOccupied(admission))
-          .map((admission) => stayDays(admission.arrivedAt, now))
+          .map((admission) => daysInBed(admission, now))
           .filter((days): days is number => days !== null);
         return {
           id: unit.id,

From 1334b3c3653e81d3994469f3a17a48b088934fee Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:10:54 +0000
Subject: [PATCH 13/40] End demo passes when WARD_DEMO_CODE changes

A demo pass now carries a keyed fingerprint of the code it was opened with,
and the proxy refuses one whose fingerprint no longer matches the code set.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/OPERATIONS-RUNBOOK.md       |  2 +-
 src/lib/front-door-pass.ts                 | 35 ++++++++++++--
 src/proxy.ts                               |  8 +++-
 tests/front-door-demo-pass-binding.test.ts | 56 ++++++++++++++++++++++
 4 files changed, 95 insertions(+), 6 deletions(-)
 create mode 100644 tests/front-door-demo-pass-binding.test.ts

diff --git a/docs/ward-flow/OPERATIONS-RUNBOOK.md b/docs/ward-flow/OPERATIONS-RUNBOOK.md
index 8939b2886..94293a289 100644
--- a/docs/ward-flow/OPERATIONS-RUNBOOK.md
+++ b/docs/ward-flow/OPERATIONS-RUNBOOK.md
@@ -60,7 +60,7 @@ so changing them needs a restart, not a rebuild:
 
 With it on, a page without a pass goes to `/sign-in` and an API call gets 401. On the signed-in
 site the pass lasts until the 12-hour sign-in limit and ends at sign-out. A demo code pass lasts 8
-hours. `/api/health`, the offline page and the alert worker stay open. To switch it off, set
+hours, and ends at once when `WARD_DEMO_CODE` changes. `/api/health`, the offline page and the alert worker stay open. To switch it off, set
 `WARD_FRONT_DOOR=off` and restart. Code: `src/lib/front-door-pass.ts`, `src/proxy.ts`,
 `src/app/api/session/route.ts`.
 
diff --git a/src/lib/front-door-pass.ts b/src/lib/front-door-pass.ts
index 3f07c7920..238319794 100644
--- a/src/lib/front-door-pass.ts
+++ b/src/lib/front-door-pass.ts
@@ -3,7 +3,8 @@
  * switch `WARD_FRONT_DOOR=required` is set, no Ward Flow page or API answers until this browser
  * holds a signed pass. The pass is an HttpOnly cookie that `POST /api/session` sets after it has
  * checked a Supabase sign-in with Supabase itself, or a demo code on the public demo. It ends with
- * the 12-hour sign-in limit (8 hours for a demo code) and on sign-out.
+ * the 12-hour sign-in limit (8 hours for a demo code) and on sign-out. A demo pass also ends as
+ * soon as `WARD_DEMO_CODE` changes.
  *
  * The pass only opens the door. It never stands in for the sign-in: the shared workspace still
  * checks the account's own token on every request, so a pass without a sign-in shows the sign-in
@@ -91,6 +92,11 @@ export type FrontDoorPass = {
   kind: "account" | "demo";
   /** The Supabase account id for an account pass. */
   subject?: string;
+  /**
+   * A demo pass's fingerprint of the demo code it was opened with (`demoCodeFingerprint`), so
+   * changing `WARD_DEMO_CODE` closes every demo pass at once rather than up to 8 hours later.
+   */
+  code?: string;
   issuedAt: number;
   expiresAt: number;
 };
@@ -128,16 +134,39 @@ function sameText(a: string, b: string): boolean {
   return difference === 0;
 }
 
-/** A signed pass value and its cookie lifetime in seconds. */
+/**
+ * A demo pass's tie to the demo code now set: a keyed hash of the normalised code, so the cookie
+ * never shows the code itself. Any change to `WARD_DEMO_CODE` changes it.
+ */
+export async function demoCodeFingerprint(secret: string, env: Env = process.env): Promise<string> {
+  return (await sign(secret, `demo-code:${normaliseDemoCode(env.WARD_DEMO_CODE ?? "")}`)).slice(0, 22);
+}
+
+/**
+ * Whether a verified pass still stands against the settings now: an account pass always, a demo
+ * pass only while `WARD_DEMO_CODE` is the code it was opened with.
+ */
+export async function passMatchesDemoCode(
+  secret: string,
+  pass: FrontDoorPass,
+  env: Env = process.env,
+): Promise<boolean> {
+  if (pass.kind !== "demo") return true;
+  return typeof pass.code === "string" && sameText(pass.code, await demoCodeFingerprint(secret, env));
+}
+
+/** A signed pass value and its cookie lifetime in seconds. A demo pass carries the code's fingerprint. */
 export async function issuePass(
   secret: string,
-  pass: Omit<FrontDoorPass, "issuedAt" | "expiresAt"> & { hours: number; endsBy?: number | null },
+  pass: Omit<FrontDoorPass, "issuedAt" | "expiresAt" | "code"> & { hours: number; endsBy?: number | null },
   now = Date.now(),
+  env: Env = process.env,
 ): Promise<{ value: string; maxAge: number }> {
   const limit = now + pass.hours * 3_600_000;
   const expiresAt = pass.endsBy && pass.endsBy < limit ? pass.endsBy : limit;
   const body: FrontDoorPass = { kind: pass.kind, issuedAt: now, expiresAt };
   if (pass.subject) body.subject = pass.subject;
+  if (pass.kind === "demo") body.code = await demoCodeFingerprint(secret, env);
   const payload = toBase64Url(encoder.encode(JSON.stringify(body)));
   return {
     value: `${payload}.${await sign(secret, payload)}`,
diff --git a/src/proxy.ts b/src/proxy.ts
index 5d9b3fa0c..67eee6390 100644
--- a/src/proxy.ts
+++ b/src/proxy.ts
@@ -8,6 +8,7 @@ import {
   frontDoorRequired,
   frontDoorSecret,
   isFrontDoorOpenPath,
+  passMatchesDemoCode,
   passOpensSite,
   safeNextPath,
   verifyPass,
@@ -208,13 +209,16 @@ export async function frontDoorVerdict(
 ): Promise<NextResponse | null> {
   const { pathname, search } = request.nextUrl;
   if (!frontDoorRequired(environment) || isFrontDoorOpenPath(pathname)) return null;
-  const pass = await verifyPass(frontDoorSecret(environment), request.cookies.get(FRONT_DOOR_PASS_COOKIE)?.value);
+  const secret = frontDoorSecret(environment);
+  const pass = await verifyPass(secret, request.cookies.get(FRONT_DOOR_PASS_COOKIE)?.value);
   // The literal read is inlined at build time, as in POST /api/session; the environment read covers
   // a runtime value and tests.
   const shared =
     (environment.NEXT_PUBLIC_WARD_SHARED_ENABLED ??
       (environment === process.env ? process.env.NEXT_PUBLIC_WARD_SHARED_ENABLED : undefined)) === "true";
-  if (pass && passOpensSite(pass, shared)) return null;
+  // A demo pass also ends as soon as WARD_DEMO_CODE changes (it carries the code's fingerprint).
+  if (secret && pass && passOpensSite(pass, shared) && (await passMatchesDemoCode(secret, pass, environment)))
+    return null;
   if (pathname === "/api" || pathname.startsWith("/api/"))
     return NextResponse.json({ error: "Sign in first.", code: "front_door" }, { status: 401 });
   const url = request.nextUrl.clone();
diff --git a/tests/front-door-demo-pass-binding.test.ts b/tests/front-door-demo-pass-binding.test.ts
new file mode 100644
index 000000000..dcbf9f24d
--- /dev/null
+++ b/tests/front-door-demo-pass-binding.test.ts
@@ -0,0 +1,56 @@
+import { NextRequest } from "next/server";
+import { describe, expect, it } from "vitest";
+
+import {
+  FRONT_DOOR_PASS_COOKIE,
+  demoCodeFingerprint,
+  issuePass,
+  passMatchesDemoCode,
+  verifyPass,
+} from "../src/lib/front-door-pass";
+import { frontDoorVerdict } from "../src/proxy";
+
+// Synthetic secrets and codes only: these values exist for this test file.
+const SECRET = "synthetic-binding-secret-0123456789abcdef"; // gitleaks:allow
+const CODE = "SYNTHETIC-DEMO-CODE-A";
+const ON = { WARD_FRONT_DOOR: "required", WARD_PASS_SECRET: SECRET, WARD_DEMO_CODE: CODE };
+
+function page(path: string, pass: string): NextRequest {
+  const request = new NextRequest(new URL(path, "https://ward.example.test"));
+  request.cookies.set(FRONT_DOOR_PASS_COOKIE, pass);
+  return request;
+}
+
+describe("demo pass bound to the demo code", () => {
+  it("carries a fingerprint of the code, never the code itself", async () => {
+    const { value } = await issuePass(SECRET, { kind: "demo", hours: 8 }, Date.now(), ON);
+    const pass = (await verifyPass(SECRET, value))!;
+    expect(pass.code).toBe(await demoCodeFingerprint(SECRET, ON));
+    expect(Buffer.from(value.split(".")[0]!, "base64url").toString("utf8")).not.toContain("SYNTHETIC");
+    // The same code in another form (case, spaces, dashes) is the same code.
+    expect(await demoCodeFingerprint(SECRET, { WARD_DEMO_CODE: "synthetic demo code a" })).toBe(pass.code);
+  });
+
+  it("opens the demo while the code stands and closes it as soon as the code changes", async () => {
+    const { value } = await issuePass(SECRET, { kind: "demo", hours: 8 }, Date.now(), ON);
+    expect(await frontDoorVerdict(page("/ward-flow/capacity", value), ON)).toBeNull();
+    const changed = { ...ON, WARD_DEMO_CODE: "SYNTHETIC-DEMO-CODE-B" };
+    const refused = await frontDoorVerdict(page("/ward-flow/capacity", value), changed);
+    expect(refused?.status).toBe(307);
+    expect(new URL(refused!.headers.get("location")!).pathname).toBe("/sign-in");
+    expect((await frontDoorVerdict(page("/api/workspace", value), changed))?.status).toBe(401);
+    const removed = { WARD_FRONT_DOOR: "required", WARD_PASS_SECRET: SECRET };
+    expect((await frontDoorVerdict(page("/api/workspace", value), removed))?.status).toBe(401);
+  });
+
+  it("refuses a demo pass with no fingerprint and leaves account passes alone", async () => {
+    const now = Date.now();
+    const bare = { kind: "demo" as const, issuedAt: now, expiresAt: now + 60_000 };
+    expect(await passMatchesDemoCode(SECRET, bare, ON)).toBe(false);
+    const account = (await issuePass(SECRET, { kind: "account", subject: "synthetic-id", hours: 12 }, now, ON)).value;
+    const checked = (await verifyPass(SECRET, account))!;
+    expect(checked.code).toBeUndefined();
+    expect(await passMatchesDemoCode(SECRET, checked, { ...ON, WARD_DEMO_CODE: "OTHER" })).toBe(true);
+    expect(await frontDoorVerdict(page("/ward-flow", account), { ...ON, WARD_DEMO_CODE: "OTHER" })).toBeNull();
+  });
+});

From a473c962ad3960cc6668090525252889f569fc81 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:10:54 +0000
Subject: [PATCH 14/40] Add record-id and web-push rows to the real-data
 checklist

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/governance/REAL-DATA-GO-NO-GO.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/ward-flow/governance/REAL-DATA-GO-NO-GO.md b/docs/ward-flow/governance/REAL-DATA-GO-NO-GO.md
index 7d87d08c8..72deba816 100644
--- a/docs/ward-flow/governance/REAL-DATA-GO-NO-GO.md
+++ b/docs/ward-flow/governance/REAL-DATA-GO-NO-GO.md
@@ -1,5 +1,7 @@
 # Real patient data: go/no-go checklist
 
+_Updated 2026-11-11 - section 1 adds C8 (record ids never from a medical record number) and C9 (web push library check); open sign-up off is already the Supabase row in section 4 (M49); Documentation owns._
+
 _Updated 2026-11-10 - audit M127: section 0 makes this page the one real-data gate tracker for D-87 and D-111 item 8, with owners and the File A to master-list crosswalk; Documentation owns._
 
 _Updated 2026-11-10 - section 4 rechecked against repository records and the Sentry row corrected (audit item M61); drafts linked under sections 2 and 3; Documentation owns._
@@ -57,6 +59,8 @@ list renumbered them. Use the M number in new work.
 | C5  | **Sign-in token storage.** The Supabase refresh token sits in sessionStorage, readable by page scripts, because the backend is on another site (H-0044).                                                                                                                                                                                                                                                                                                                                          | `ward-flow:auth:<project>:v1` in `ward-auth-session.ts`                                                                                             | Either the token moves to an HttpOnly cookie on a same-site backend, or the PIA accepts the risk with a session time limit and the strict content security policy kept.                                                                                           |
 | C6  | **Data-mode lock opened on purpose.** Migration 7 limits the database to `prototype`, and the backend refuses any other `WARD_DATA_MODE`.                                                                                                                                                                                                                                                                                                                                                         | `migrations/007-prototype-only.sql`, `backend/ward-flow/config.mjs`                                                                                 | A new decision and migration allow `live`, only after sections 2 to 5 are complete. Never by hand in the console.                                                                                                                                                 |
 | C7  | **Logs and error reports.** Sentry is server-side, off unless `SENTRY_DSN` is set, and scrubbed.                                                                                                                                                                                                                                                                                                                                                                                                  | `src/lib/sentry-server.ts` (`scrubSentryEvent`)                                                                                                     | A test sends an event containing synthetic names and free text and shows none of it leaves the server. Railway and Supabase logs checked for request bodies.                                                                                                      |
+| C8  | **Record ids never from a medical record number.** Record ids (`WF-`, `PT-`, `RF-`, `AD-`) are made up inside Ward Flow. The record-address code only hides an id in the address bar: it is a fixed XOR with a key in the source, so anyone can reverse it. An id built from a UMRN or other medical record number would put that number in every address.                                                                                                                                        | `encodeRecordAddress` in `src/components/ward-management/shell/ward-record-address.ts`                                                              | A written rule and a test show no record id is derived from a UMRN or medical record number, or addresses carry an opaque server-issued key instead.                                                                                                              |
+| C9  | **Web push library checked.** Alerts are sent with the `web-push` package on the backend. It has had no vendor or security review.                                                                                                                                                                                                                                                                                                                                                                | `web-push` in `backend/ward-flow/package.json`                                                                                                      | A vendor and security check of the package (maintenance, known issues, what it sends to push services) is recorded, or push is turned off for live workspaces.                                                                                                    |
 
 Already in place, checked 3 Nov 2026: sign-out, expiry and a refused session clear every Ward
 Flow key from browser storage (`ward-browser-data.ts`); the service worker caches static files

From f828b1e9545cada4bb51538ade3efefe8c702ac8 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:13:29 +0000
Subject: [PATCH 15/40] Point the runbook at prune:receipts:supabase and drop
 the duplicate prune:supabase script

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 backend/ward-flow/package.json       | 1 -
 docs/ward-flow/OPERATIONS-RUNBOOK.md | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/backend/ward-flow/package.json b/backend/ward-flow/package.json
index be1beb5a7..56488ad99 100644
--- a/backend/ward-flow/package.json
+++ b/backend/ward-flow/package.json
@@ -13,7 +13,6 @@
     "typecheck": "node ../../node_modules/typescript/bin/tsc -p tsconfig.json",
     "migrate:postgres": "node --env-file-if-exists=.env migrate-postgres.mjs",
     "migrate:supabase": "node --env-file-if-exists=.env migrate-supabase.mjs",
-    "prune:supabase": "node --env-file-if-exists=.env prune-receipts.mjs supabase",
     "prune:receipts:postgres": "node --env-file-if-exists=.env prune-receipts.mjs postgres",
     "prune:receipts:supabase": "node --env-file-if-exists=.env prune-receipts.mjs supabase",
     "prune:receipts:supabase-pruner": "node --env-file-if-exists=.env prune-receipts.mjs supabase-pruner",
diff --git a/docs/ward-flow/OPERATIONS-RUNBOOK.md b/docs/ward-flow/OPERATIONS-RUNBOOK.md
index 94293a289..5e9cd9e7b 100644
--- a/docs/ward-flow/OPERATIONS-RUNBOOK.md
+++ b/docs/ward-flow/OPERATIONS-RUNBOOK.md
@@ -106,7 +106,7 @@ Weekly, or before a demonstration. All read-only.
 5. **Receipts.** Command receipts older than 7 days are pruned every Monday at 03:00 Perth by
    `.github/workflows/prune-receipts.yml`. Until the owner adds the repository secret
    `WARD_SUPABASE_PRUNE_DATABASE_URL`, the weekly run fails on purpose; check it succeeded. To prune by hand, run
-   `npm --prefix backend/ward-flow run prune:supabase`. It needs the private administrator
+   `npm --prefix backend/ward-flow run prune:receipts:supabase`. It needs the private administrator
    environment, so it is a live change. The audit history is never pruned.
 6. **Quiet periods.** Two things stop by themselves when nobody is working on Ward Flow:
    - GitHub turns off every scheduled workflow after 60 days without repository activity:

From f5c0cfa4fec2b982bc0be4d293c8636186cdc580 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:13:59 +0000
Subject: [PATCH 16/40] Leave page: Open ward on overdue and absent rows,
 Print, and a search entry

Overdue and absent rows link to the ward's leave view (#ward-leave-bed-form),
where leave is ended. Print uses the browser's own print with a print-only
scope line. Leave is now found in Search as a screen, besides Tools.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../leave/leave-screen.module.css             | 46 +++++++++++++++++++
 .../ward-management/leave/leave-screen.tsx    | 40 ++++++++++++++--
 .../search/ward-smart-search.ts               |  8 ++++
 .../ward-list-print-button.tsx                | 34 ++++++++++++++
 4 files changed, 124 insertions(+), 4 deletions(-)
 create mode 100644 src/components/ward-management/ward-list-print-button.tsx

diff --git a/src/components/ward-management/leave/leave-screen.module.css b/src/components/ward-management/leave/leave-screen.module.css
index 76077392a..dd9b89382 100644
--- a/src/components/ward-management/leave/leave-screen.module.css
+++ b/src/components/ward-management/leave/leave-screen.module.css
@@ -7,6 +7,13 @@
   padding: var(--wf-s-4);
 }
 
+.head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--wf-s-3);
+}
+
 .title {
   margin: 0;
   font-size: var(--wf-fs-20);
@@ -87,6 +94,18 @@
   font-variant-numeric: tabular-nums;
 }
 
+/* Overdue or absent rows: the ward page where the leave is ended. */
+.wardLink {
+  display: block;
+  margin-top: 2px;
+  font-size: var(--wf-fs-12);
+  color: var(--wf-accent-ink);
+}
+
+.printScope {
+  display: none;
+}
+
 .status {
   display: inline-flex;
   align-items: center;
@@ -183,6 +202,15 @@
     content: " · ";
   }
 
+  .table td.ward .wardLink {
+    display: inline;
+  }
+
+  .table td.ward .wardLink::before {
+    content: " · ";
+    color: var(--wf-ink-2);
+  }
+
   .table td.kind,
   .table td.time {
     width: auto;
@@ -200,3 +228,21 @@
   font-family: var(--wf-font);
   color: var(--wf-ink-3);
 }
+
+/* Paper: the whole list in the page's flow, with what it holds and when. */
+@media print {
+  .main {
+    padding: 0;
+  }
+
+  .printScope {
+    display: block;
+    margin: 0;
+    color: CanvasText;
+    font-size: var(--wf-fs-12);
+  }
+
+  .scroll {
+    overflow: visible;
+  }
+}
diff --git a/src/components/ward-management/leave/leave-screen.tsx b/src/components/ward-management/leave/leave-screen.tsx
index 50faee7d3..fb21e709b 100644
--- a/src/components/ward-management/leave/leave-screen.tsx
+++ b/src/components/ward-management/leave/leave-screen.tsx
@@ -7,8 +7,11 @@ import { useWardFlowClock, useWardFlowSelect } from "@/components/ward-managemen
 import { useEffectiveWardAccess } from "@/components/ward-management/shell/ward-access-store";
 import { wardPlaceLookup } from "@/components/ward-management/ward-access-places";
 import { unitInScope } from "@/components/ward-management/ward-role-access";
-import { formatInstantWithDay, type Instant } from "@/components/ward-management/ward-clock";
+import { formatInstantWithDay, formatSheetMoment, type Instant } from "@/components/ward-management/ward-clock";
 import { patientHref } from "@/components/ward-management/shell/ward-patient-href";
+import { unitHref } from "@/components/ward-management/shell/ward-facade";
+import { useCanOpenHref } from "@/components/ward-management/shell/ward-access";
+import { ListPrintButton } from "@/components/ward-management/ward-list-print-button";
 import { WardPrototypeFooter } from "@/components/ward-management/shell/ward-prototype-footer";
 import { wardNames } from "@/components/ward-management/tools/ward-tool-remind-store";
 import { LEAVE_STATUS_LABEL, leaveTrackerRows, type LeaveStatus } from "./leave-tracker";
@@ -35,21 +38,30 @@ function LeaveTime({ instant, now }: { instant: Instant; now: Instant }) {
   );
 }
 
+/**
+ * The ward page's Leave monitoring, where leave is ended: `#ward-leave-bed-form` opens the ward's
+ * All discharges view (ward-screen.tsx reads the hash), the same address the ward's own links use.
+ */
+const leaveOnWardHref = (unitId: string) => `${unitHref(unitId)}#ward-leave-bed-form`;
+
 /**
  * Feature 23 (Josh, 9 Nov 2026): everyone on leave across the desk's wards, with where their bed is,
  * the kind of leave, when they left, when they are expected back and the status. Read only; leave is
- * recorded and ended from the ward's own page. Synthetic records only.
+ * recorded and ended from the ward's own page, which an overdue or absent row opens (Open ward).
+ * Print uses the browser's own print, as the other lists do. Synthetic records only.
  */
 export function LeaveScreen() {
-  const { leaveBeds, units, admissions, bedReleases, resolvePatientIdentity } = useWardFlowSelect(
+  const { leaveBeds, units, admissions, bedReleases, resolvePatientIdentity, dayZero } = useWardFlowSelect(
     "leaveBeds",
     "units",
     "admissions",
     "bedReleases",
     "resolvePatientIdentity",
+    "dayZero",
   );
   const now = useWardFlowClock();
   const access = useEffectiveWardAccess();
+  const canOpenHref = useCanOpenHref();
   const [needsActionOnly, setNeedsActionOnly] = useState(false);
   const rows = useMemo(() => {
     const places = wardPlaceLookup(units);
@@ -68,7 +80,15 @@ export function LeaveScreen() {
   const onLeave = rows.filter((row) => row.status !== "absent").length;
   return (
     <main id="main-content" className={styles.main} data-testid="ward-leave-screen">
-      <h1 className={styles.title}>Leave</h1>
+      <div className={styles.head}>
+        <h1 className={styles.title}>Leave</h1>
+        <ListPrintButton disabled={shown.length === 0} testId="ward-leave-print" />
+      </div>
+      {/* On paper only: what the list holds and when, as the other printed lists say. */}
+      <p className={styles.printScope} data-testid="ward-leave-print-scope">
+        {needsActionOnly ? "Overdue or absent only" : "Everyone on leave"} · As at{" "}
+        {formatSheetMoment(now, dayZero, { includeYearAndZone: true })} · Identifiers may be included
+      </p>
       <p className={styles.summary}>
         <span className={styles.figure}>{onLeave}</span> on leave · <span className={styles.figure}>{dueToday}</span>{" "}
         due back today · <span className={styles.figure}>{needsAction.length}</span> overdue or absent
@@ -120,6 +140,18 @@ export function LeaveScreen() {
                         <td className={styles.ward}>
                           {row.wardName}
                           <span className={styles.sub}>{row.bedLabel}</span>
+                          {(row.status === "absent" || row.status === "overdue") &&
+                          canOpenHref(unitHref(row.unitId)) ? (
+                            <Link
+                              href={leaveOnWardHref(row.unitId)}
+                              className={styles.wardLink}
+                              aria-label={`Open ward ${row.wardName}, where leave is ended`}
+                              data-print-hide
+                              data-testid={`ward-leave-open-ward-${row.id}`}
+                            >
+                              Open ward
+                            </Link>
+                          ) : null}
                         </td>
                         <td className={styles.kind}>{row.kind}</td>
                         <td className={styles.time}>
diff --git a/src/components/ward-management/search/ward-smart-search.ts b/src/components/ward-management/search/ward-smart-search.ts
index df8eb3f7a..2b0aeda8e 100644
--- a/src/components/ward-management/search/ward-smart-search.ts
+++ b/src/components/ward-management/search/ward-smart-search.ts
@@ -140,6 +140,14 @@ export const CORE_SEARCH_VIEWS: readonly CoreSearchView[] = [
     keywords: ["legal-forms", "legal forms", "forms", "mha", "mental health act", "mental health act forms"],
     description: "Recorded forms (demo)",
   },
+  {
+    // Feature 23: the Leave page, also reached from the Tools sheet's Leave due ("See all leave").
+    key: "leave",
+    title: "Leave",
+    href: "/ward-flow/leave",
+    keywords: ["leave", "on leave", "due back", "overdue", "absent", "absent without leave", "awol"],
+    description: "Everyone on leave and due back",
+  },
   {
     key: "referrals",
     title: "Referrals",
diff --git a/src/components/ward-management/ward-list-print-button.tsx b/src/components/ward-management/ward-list-print-button.tsx
new file mode 100644
index 000000000..0843798e6
--- /dev/null
+++ b/src/components/ward-management/ward-list-print-button.tsx
@@ -0,0 +1,34 @@
+"use client";
+
+import { Printer } from "lucide-react";
+import { Button } from "@/components/wf";
+
+/**
+ * A list's Print button: the browser's own print of the page as it shows, as Discharges, the call
+ * sheet and the chronology already do. The page's print styles drop the controls; names print in
+ * full, as on screen (D-102 keeps names out of downloaded files only).
+ */
+export function ListPrintButton({
+  variant = "sec",
+  disabled,
+  testId,
+}: {
+  variant?: "sec" | "ghost";
+  disabled?: boolean;
+  testId?: string;
+}) {
+  return (
+    <Button
+      variant={variant}
+      size="sm"
+      icon={Printer}
+      disabled={disabled}
+      aria-label="Print this list"
+      data-print-hide
+      data-testid={testId}
+      onClick={() => window.print()}
+    >
+      Print
+    </Button>
+  );
+}

From c77d43603efc4a652fd59aef9e4f3ee93be07402 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:13:59 +0000
Subject: [PATCH 17/40] Help pages for Leave, Today's review, Start a triage
 and the triage form

Kept in their own module so PAGE_HELP takes them in one line. The bed
meeting TV keeps none: Help cannot open there (HF-10).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../ward-management/help/ward-help-content.ts |  2 +
 .../help/ward-help-pages-more.ts              | 90 +++++++++++++++++++
 2 files changed, 92 insertions(+)
 create mode 100644 src/components/ward-management/help/ward-help-pages-more.ts

diff --git a/src/components/ward-management/help/ward-help-content.ts b/src/components/ward-management/help/ward-help-content.ts
index 4b934ff53..15d71d546 100644
--- a/src/components/ward-management/help/ward-help-content.ts
+++ b/src/components/ward-management/help/ward-help-content.ts
@@ -23,6 +23,7 @@ import { siteDirectory } from "@/components/ward-management/ward-sites";
 import type { SiteIdentity } from "@/components/ward-management/ward-sites";
 
 import type { WardTourRole } from "./ward-help-store";
+import { MORE_PAGE_HELP } from "./ward-help-pages-more";
 
 /** The Give button's own words, from the value it grants (D-122: help never types a threshold). */
 const GIVE_FOR = `Give for ${formatClinicalFigure(CLINICAL_VALUES.accessGrantDefault.value, CLINICAL_VALUES.accessGrantDefault.unit)}`;
@@ -604,6 +605,7 @@ type PageHelp = ScreenHelp & {
 
 /** Detail and stand-alone pages. Listed most specific first; the first match wins. */
 const PAGE_HELP: readonly PageHelp[] = [
+  ...MORE_PAGE_HELP,
   {
     id: "ward-answer",
     path: /^\/ward-flow\/ward\/[^/]+\/answer$/u,
diff --git a/src/components/ward-management/help/ward-help-pages-more.ts b/src/components/ward-management/help/ward-help-pages-more.ts
new file mode 100644
index 000000000..ca17cb75c
--- /dev/null
+++ b/src/components/ward-management/help/ward-help-pages-more.ts
@@ -0,0 +1,90 @@
+import type { ScreenHelp } from "./ward-help-content";
+
+/**
+ * Help for stand-alone pages that showed "no help page yet" (11 Nov 2026): Leave, Today's review,
+ * Start a triage and a person's triage form. Kept in its own module so `ward-help-content.ts`'s
+ * `PAGE_HELP` takes them in one line. Each entry describes the page as its source draws it.
+ *
+ * The bed meeting TV (`/ward-flow/bed-meeting`) has none on purpose: it hides the header, so Help
+ * cannot open there, and its help sits on the screens that open it (HF-10, `TV_QUESTION`).
+ */
+export const MORE_PAGE_HELP: readonly (ScreenHelp & { id: string; path: RegExp })[] = [
+  {
+    id: "leave",
+    path: /^\/ward-flow\/leave$/u,
+    title: "Leave",
+    purpose:
+      "Everyone on leave across your wards: their bed, the kind of leave, when they left, when they are expected back and their status.",
+    actions: [
+      "Overdue or absent shows only the people overdue back or absent without leave.",
+      "Open ward on an overdue or absent row opens that ward's page, where leave is ended.",
+      "Print makes a paper copy of the list as it shows.",
+    ],
+    questions: [
+      {
+        question: "How do I record or end leave?",
+        answer:
+          "This page is read only. Start leave from the patient's page with Record a change. End it on the ward's page, under Leave monitoring, with Ended.",
+      },
+      {
+        question: "When is someone overdue?",
+        answer:
+          "Once the expected return recorded with their leave has passed. Absent without leave shows while the ward's absence record stands.",
+      },
+    ],
+  },
+  {
+    id: "todays-review",
+    path: /^\/ward-flow\/review$/u,
+    title: "Today's review",
+    purpose:
+      "What to settle before you hand over, and every decline, override, open problem and action the app stopped today.",
+    actions: [
+      "Before you hand over lists overrides to review, a ward's repeated declines and problems still open.",
+      "Mark reviewed on an override records your role and the time with the governance record.",
+      "Show narrows Everything today to declines, overrides, problems or actions stopped by the app.",
+    ],
+    questions: [
+      {
+        question: "Who can mark an override reviewed?",
+        answer: "Any coordinator on shift, including the person who made the override.",
+      },
+      {
+        question: "Where is the full history?",
+        answer: "Today's review shows today only. Governance holds the full history.",
+      },
+    ],
+  },
+  {
+    id: "triage-start",
+    path: /^\/ward-flow\/triage\/new$/u,
+    title: "Start a triage",
+    purpose: "Choose who a mental health triage and risk assessment is for.",
+    actions: [
+      "Search by name, UMRN or date of birth, or choose a referral awaiting triage.",
+      "Filter the referrals by source, and sort them from the menu beside the tabs.",
+      "Not found? Add patient makes a new record first.",
+    ],
+  },
+  {
+    id: "triage",
+    path: /^\/ward-flow\/people\/[^/]+\/triage$/u,
+    title: "Triage and risk",
+    purpose: "One person's triage and risk assessment (SMHMR900 and SMHMR905). It opens blank.",
+    actions: [
+      "Work through the sections in order, from Review details to Formulation and plan.",
+      "Show what's left lists the answers still needed before signing.",
+      "Sign creates both records. How to explains the form.",
+    ],
+    questions: [
+      {
+        question: "Why can't I sign yet?",
+        answer: "Every needed answer must be in first. Sign says how many are left, and Show what's left lists them.",
+      },
+      {
+        question: "Does the form decide the urgency or the risk?",
+        answer: "No. You choose every clinical answer. Nothing clinical is filled in for you.",
+      },
+    ],
+  },
+];

From fe1855482694cb7c75c85dd4acf8960332fe9642 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:14:00 +0000
Subject: [PATCH 18/40] Print and spreadsheet export on Legal forms and
 Movements

Reuses ListExportButton and a shared Print button. Exports carry record
numbers and UMRNs, never names (D-102); a form's end is exactly as typed with
its date, never a countdown (D-93). Desktop only, as on Referrals.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../legal-forms/legal-forms-export.ts         | 102 ++++++++++++++
 .../legal-forms/legal-forms-screen.tsx        |  39 ++++-
 .../movements/movements-export.ts             | 100 +++++++++++++
 .../movements/movements-list-tools.tsx        |  26 ++++
 .../movements/movements-screen.tsx            |  28 ++--
 tests/ward-audit-m124-outbound-marker.test.ts |   2 +
 tests/ward-legal-movements-export.test.ts     |  81 +++++++++++
 .../ward-list-print-export-more.dom.test.tsx  | 133 ++++++++++++++++++
 8 files changed, 495 insertions(+), 16 deletions(-)
 create mode 100644 src/components/ward-management/legal-forms/legal-forms-export.ts
 create mode 100644 src/components/ward-management/movements/movements-export.ts
 create mode 100644 src/components/ward-management/movements/movements-list-tools.tsx
 create mode 100644 tests/ward-legal-movements-export.test.ts
 create mode 100644 tests/ward-list-print-export-more.dom.test.tsx

diff --git a/src/components/ward-management/legal-forms/legal-forms-export.ts b/src/components/ward-management/legal-forms/legal-forms-export.ts
new file mode 100644
index 000000000..9c95d2111
--- /dev/null
+++ b/src/components/ward-management/legal-forms/legal-forms-export.ts
@@ -0,0 +1,102 @@
+import { formatSheetMoment, isClockBreached, type Instant } from "@/components/ward-management/ward-clock";
+import { legalFormName } from "@/components/ward-management/ward-legal-forms";
+import { FORM_RECORDED_ENDED, formRecordedEnded } from "@/components/ward-management/ward-legal-form-ended";
+import type { Movement } from "@/components/ward-management/ward-model";
+import { downloadCsv } from "@/components/ward-management/statistics/statistics-csv";
+
+import { currentLegalDueAt, formProgression, formProgressionPhrase } from "./legal-form-progression";
+
+/** Where and when the file was taken, as `downloadCsv` writes it above the rows. */
+export type ListExportProvenance = NonNullable<Parameters<typeof downloadCsv>[2]>;
+
+/**
+ * Export (feature 44) for Legal forms and Movements: a form's end exactly as typed, with its date so
+ * the file reads the same tomorrow ("Ends Tue 11 Nov, 15:42 as typed"). Never a countdown or a time
+ * worked out from it (D-93, D-70). A form that ended at arrival or the examination, or that a person
+ * recorded as ended, says so in the words the screens, TV and printouts use (M17, D-125, D-127).
+ */
+export function legalEndAsTyped(
+  movement: Pick<Movement, "legalForm" | "legalStatus" | "examination" | "closure">,
+  now: Instant,
+  dayZero: Date,
+): string {
+  if (!movement.legalForm) return "No form recorded";
+  const progression = formProgression(movement as Movement);
+  if (progression) return formProgressionPhrase(progression);
+  if (formRecordedEnded(movement)) return FORM_RECORDED_ENDED;
+  const typed = currentLegalDueAt(movement as Movement);
+  if (typed === undefined) return "No expiry recorded from the form";
+  return `${isClockBreached(typed, now) ? "Ended" : "Ends"} ${formatSheetMoment(typed, dayZero)} as typed`;
+}
+
+/** The form by its full register name ("Form 4C (Transfer order)"), never a bare code alone. */
+export function legalFormWords(movement: Pick<Movement, "legalForm">): string {
+  return movement.legalForm ? legalFormName(movement.legalForm) : "No form recorded";
+}
+
+export type LegalFormsExportMovement = Pick<
+  Movement,
+  | "id"
+  | "legalForm"
+  | "legalStatus"
+  | "examination"
+  | "closure"
+  | "formedAt"
+  | "legalFormReceivedAt"
+  | "legalFormReceivedTyped"
+>;
+
+export type LegalFormsExportContext<M extends LegalFormsExportMovement = LegalFormsExportMovement> = {
+  readonly umrnOf: (movement: M) => string;
+  readonly edName: (movement: M) => string;
+  readonly wardName: (movement: M) => string | null;
+  readonly now: Instant;
+  readonly dayZero: Date;
+};
+
+export const LEGAL_FORMS_EXPORT_HEADER = [
+  "Record",
+  "UMRN",
+  "Form",
+  "ED",
+  "Receiving ward",
+  "Referral made",
+  "Ends, as typed",
+  "Form received",
+] as const;
+
+/**
+ * Everyone on a form, in the list's own order: record numbers, places, the form and its recorded
+ * times. Never a name, initials or a typed note (D-102).
+ */
+export function legalFormsExportLines<M extends LegalFormsExportMovement>(
+  movements: readonly M[],
+  ctx: LegalFormsExportContext<M>,
+): (string | number)[][] {
+  const at = (instant: Instant | undefined) =>
+    instant === undefined ? "Not recorded" : formatSheetMoment(instant, ctx.dayZero);
+  return [
+    [...LEGAL_FORMS_EXPORT_HEADER],
+    ...movements.map((movement) => [
+      movement.id,
+      ctx.umrnOf(movement),
+      legalFormWords(movement),
+      ctx.edName(movement),
+      ctx.wardName(movement) ?? "No receiving ward",
+      at(movement.formedAt),
+      legalEndAsTyped(movement, ctx.now, ctx.dayZero),
+      movement.legalFormReceivedAt === undefined
+        ? "Not recorded"
+        : `${at(movement.legalFormReceivedAt)}${movement.legalFormReceivedTyped ? " as typed" : ""}`,
+    ]),
+  ];
+}
+
+/** Builds the rows and hands the browser the file. */
+export function downloadLegalFormsList<M extends LegalFormsExportMovement>(
+  movements: readonly M[],
+  ctx: LegalFormsExportContext<M>,
+  provenance: ListExportProvenance,
+): void {
+  downloadCsv("ward-flow-synthetic-legal-forms.csv", legalFormsExportLines(movements, ctx), provenance);
+}
diff --git a/src/components/ward-management/legal-forms/legal-forms-screen.tsx b/src/components/ward-management/legal-forms/legal-forms-screen.tsx
index 2e8a9ef9a..c34019530 100644
--- a/src/components/ward-management/legal-forms/legal-forms-screen.tsx
+++ b/src/components/ward-management/legal-forms/legal-forms-screen.tsx
@@ -36,7 +36,14 @@ import {
   useIsPhone,
 } from "@/components/wf";
 import { movementOriginLabel } from "@/components/ward-management/ward-movement-origin";
-import { formatInstant, formatInstantWithDay, type Instant } from "@/components/ward-management/ward-clock";
+import {
+  formatInstant,
+  formatInstantWithDay,
+  formatSheetMoment,
+  type Instant,
+} from "@/components/ward-management/ward-clock";
+import { ListExportButton } from "@/components/ward-management/ward-list-export-button";
+import { ListPrintButton } from "@/components/ward-management/ward-list-print-button";
 import { isOpen } from "@/components/ward-management/ward-derivations";
 import {
   useDueSoonThresholds,
@@ -538,6 +545,16 @@ function LegalFormsWorkspace({ initialMovementId, recordOnOpen = false }: Worksp
     if (!formCode) return;
     return raise("RECORD_LEGAL_FORM_DETAILS", { movementId: target.id, formCode, ...details });
   };
+  // Export (feature 44): everyone on a form, never names; legal times exactly as typed (D-93, D-102).
+  const exportList = async () =>
+    (await import("./legal-forms-export")).downloadLegalFormsList(
+      rows,
+      { umrnOf, edName: edNameOf, wardName: wardNameOf, now, dayZero },
+      {
+        asAt: formatSheetMoment(now, dayZero, { includeYearAndZone: true }),
+        scope: "Legal forms; everyone on a form on the list, expiry typed first (highlights do not narrow it)",
+      },
+    );
   const addTimeTarget = rows.find((movement) => movement.id === addTimeId) ?? null;
   const addTimeRefusal = addTimeTarget
     ? rejections
@@ -1085,12 +1102,20 @@ function LegalFormsWorkspace({ initialMovementId, recordOnOpen = false }: Worksp
                   }
                   action={
                     // Page tops (Josh, 9 Nov 2026): Record a form, Record and tell and Copy for handover are
-                    // the top's chips; the list keeps its own Clear highlight.
-                    highlight ? (
-                      <Button variant="ghost" size="sm" onClick={() => setHighlight(null)}>
-                        Clear highlight
-                      </Button>
-                    ) : undefined
+                    // the top's chips; the list keeps its own Clear highlight, Print and Export.
+                    <>
+                      {highlight ? (
+                        <Button variant="ghost" size="sm" onClick={() => setHighlight(null)}>
+                          Clear highlight
+                        </Button>
+                      ) : null}
+                      {shownView === "history" ? null : (
+                        <>
+                          <ListPrintButton disabled={rows.length === 0} testId="ward-legal-print" />
+                          <ListExportButton load={exportList} disabled={rows.length === 0} testId="ward-legal-export" />
+                        </>
+                      )}
+                    </>
                   }
                 />
 
diff --git a/src/components/ward-management/movements/movements-export.ts b/src/components/ward-management/movements/movements-export.ts
new file mode 100644
index 000000000..ef488bea1
--- /dev/null
+++ b/src/components/ward-management/movements/movements-export.ts
@@ -0,0 +1,100 @@
+import { formatSheetMoment, type Instant } from "@/components/ward-management/ward-clock";
+import { legalEndAsTyped, legalFormWords } from "@/components/ward-management/legal-forms/legal-forms-export";
+import type { Movement, Unit } from "@/components/ward-management/ward-model";
+import type { Patient } from "@/components/ward-management/ward-patients";
+import { movementOriginLabel } from "@/components/ward-management/ward-movement-origin";
+import { resolveSubjectPatient } from "@/components/ward-management/ward-patient-resolver";
+import { edById, edShortName } from "@/components/ward-management/ward-sites";
+import { stageCopy } from "@/components/ward-management/ward-stage-copy";
+import { downloadCsv } from "@/components/ward-management/statistics/statistics-csv";
+
+/** Where and when the file was taken, as `downloadCsv` writes it above the rows. */
+export type ListExportProvenance = NonNullable<Parameters<typeof downloadCsv>[2]>;
+
+export type MovementsExportContext = {
+  readonly umrnOf: (movement: Movement) => string;
+  readonly edName: (movement: Movement) => string;
+  readonly wardName: (movement: Movement) => string;
+  readonly now: Instant;
+  readonly dayZero: Date;
+};
+
+export const MOVEMENTS_EXPORT_HEADER = [
+  "Record",
+  "UMRN",
+  "Stage",
+  "ED",
+  "Receiving ward",
+  "Opened",
+  "Urgency tier",
+  "Legal status",
+  "Form",
+  "Form ends, as typed",
+  "Outcome",
+  "Closed",
+] as const;
+
+const OUTCOME_WORDS: Record<NonNullable<Movement["closure"]>["outcome"], string> = {
+  arrived: "Arrived",
+  did_not_proceed: "Did not proceed",
+};
+
+/**
+ * Export (feature 44): the Movements worklist as a spreadsheet. Record numbers, places, stages,
+ * recorded times and labels only: never a name, initials or a typed note (D-102). A form's end is
+ * exactly as typed, never a countdown (D-93).
+ */
+export function movementsExportLines(
+  movements: readonly Movement[],
+  ctx: MovementsExportContext,
+): (string | number)[][] {
+  const at = (instant: Instant) => formatSheetMoment(instant, ctx.dayZero);
+  return [
+    [...MOVEMENTS_EXPORT_HEADER],
+    ...movements.map((movement) => [
+      movement.id,
+      ctx.umrnOf(movement),
+      stageCopy[movement.stage].label,
+      ctx.edName(movement),
+      ctx.wardName(movement),
+      at(movement.openedAt),
+      movement.urgency,
+      movement.legalStatus,
+      legalFormWords(movement),
+      movement.legalForm ? legalEndAsTyped(movement, ctx.now, ctx.dayZero) : "",
+      movement.closure ? OUTCOME_WORDS[movement.closure.outcome] : "Open",
+      movement.closure ? at(movement.closure.at) : "",
+    ]),
+  ];
+}
+
+/** The worklist's Export button: resolves the record numbers and places, then hands over the file. */
+export function exportMovementsList(o: {
+  readonly movements: readonly Movement[];
+  readonly resolved: boolean;
+  readonly patients: readonly Patient[];
+  readonly referrals: Parameters<typeof resolveSubjectPatient>[1]["referrals"];
+  readonly units: readonly Unit[];
+  readonly now: Instant;
+  readonly dayZero: Date;
+}): void {
+  const ctx: MovementsExportContext = {
+    umrnOf: (movement) => resolveSubjectPatient(movement, { patients: o.patients, referrals: o.referrals }).umrn,
+    edName: (movement) => {
+      const ed = edById(movement.originEdId);
+      return ed ? edShortName(ed) : movementOriginLabel(movement, undefined);
+    },
+    wardName: (movement) =>
+      movement.acceptedUnitId
+        ? (o.units.find((unit) => unit.id === movement.acceptedUnitId)?.name ?? movement.acceptedUnitId)
+        : "No receiving ward",
+    now: o.now,
+    dayZero: o.dayZero,
+  };
+  downloadCsv("ward-flow-synthetic-movements.csv", movementsExportLines(o.movements, ctx), {
+    asAt: formatSheetMoment(o.now, o.dayZero, { includeYearAndZone: true }),
+    scope: o.resolved
+      ? "Movements, Resolved today; every movement closed today in this view's service"
+      : "Movements; every movement on the worklist in this view's service (highlights and search do not narrow it)",
+  });
+}
diff --git a/src/components/ward-management/movements/movements-list-tools.tsx b/src/components/ward-management/movements/movements-list-tools.tsx
new file mode 100644
index 000000000..4e0b9d571
--- /dev/null
+++ b/src/components/ward-management/movements/movements-list-tools.tsx
@@ -0,0 +1,26 @@
+"use client";
+
+import type { ComponentProps } from "react";
+import { ListExportButton } from "@/components/ward-management/ward-list-export-button";
+import { ListPrintButton } from "@/components/ward-management/ward-list-print-button";
+import type { exportMovementsList } from "./movements-export";
+
+type ExportInput = Parameters<typeof exportMovementsList>[0];
+
+/**
+ * The worklist's Print and Export (feature 44), kept out of `movements-screen.tsx`, which is near its
+ * line cap. Export loads its builder on the click, so the screen carries none of it up front.
+ */
+export function MovementsListTools(props: ExportInput & Pick<ComponentProps<typeof ListPrintButton>, "disabled">) {
+  const { disabled, ...input } = props;
+  return (
+    <>
+      <ListPrintButton disabled={disabled} testId="ward-movements-print" />
+      <ListExportButton
+        load={async () => (await import("./movements-export")).exportMovementsList(input)}
+        disabled={disabled}
+        testId="ward-movements-export"
+      />
+    </>
+  );
+}
diff --git a/src/components/ward-management/movements/movements-screen.tsx b/src/components/ward-management/movements/movements-screen.tsx
index 9c93f31f1..2d76b6722 100644
--- a/src/components/ward-management/movements/movements-screen.tsx
+++ b/src/components/ward-management/movements/movements-screen.tsx
@@ -82,6 +82,7 @@ import flow from "./movement-flow.module.css";
 import styles from "./movements.module.css";
 import { WardPrototypeFooter } from "@/components/ward-management/shell/ward-prototype-footer";
 import { MovementsPhoneNav } from "./movements-phone-nav";
+import { MovementsListTools } from "./movements-list-tools";
 import { rememberReturnRow, rowWithAttribute, useReturnedView, useReturnToPlace } from "../use-return-to-place";
 import { ShapeOfTheDay } from "./movements-shape-of-day";
 import { MovementPeopleSheet, corridorPeople, type MovementPeopleList } from "./movement-people-sheet";
@@ -144,15 +145,17 @@ const worklistRow = (id: string) => rowWithAttribute("data-record-key", id, "li"
 export function MovementsScreen() {
   const returned = useReturnedView<MovementsPlace>(MOVEMENTS_ROUTE);
   const thresholds = useDueSoonThresholds();
-  const { movements, units, referrals, patients, dispatch, configuration, setFocusMovementId } = useWardFlowSelect(
-    "movements",
-    "units",
-    "referrals",
-    "patients",
-    "dispatch",
-    "configuration",
-    "setFocusMovementId",
-  );
+  const { movements, units, referrals, patients, dispatch, configuration, setFocusMovementId, dayZero } =
+    useWardFlowSelect(
+      "movements",
+      "units",
+      "referrals",
+      "patients",
+      "dispatch",
+      "configuration",
+      "setFocusMovementId",
+      "dayZero",
+    );
   const now = useWardFlowClock();
   // Task 6 of the audit-wiring plan, 2026-09-16: StageRow's wait-meter bar and its "of N hours"
   // caption are read against the coordinator-configured ED access target, not a bare 24h literal.
@@ -1225,6 +1228,13 @@ export function MovementsScreen() {
                   aria-label="Find movements by name, UMRN or ED"
                   boxClassName={flow.search}
                 />
+                {isPhone ? null : (
+                  <MovementsListTools
+                    {...{ patients, referrals, units, now, dayZero, resolved: boardTab === "resolved" }}
+                    movements={boardTab === "resolved" ? worklistClosedToday : worklistMovements}
+                    disabled={(boardTab === "resolved" ? worklistClosedToday : worklistMovements).length === 0}
+                  />
+                )}
               </div>
 
               {/* Column heads for the rows below. The rows are list items, so these are a visual
diff --git a/tests/ward-audit-m124-outbound-marker.test.ts b/tests/ward-audit-m124-outbound-marker.test.ts
index 73c22f698..2f6b1555c 100644
--- a/tests/ward-audit-m124-outbound-marker.test.ts
+++ b/tests/ward-audit-m124-outbound-marker.test.ts
@@ -182,6 +182,8 @@ describe("M124 word read-through on outbound builders (Manual, reviewed hits onl
     "src/components/ward-management/referrals/referral-export.ts",
     "src/components/ward-management/search/census-export.ts",
     "src/components/ward-management/delays/delays-export.ts",
+    "src/components/ward-management/legal-forms/legal-forms-export.ts",
+    "src/components/ward-management/movements/movements-export.ts",
     "src/components/ward-management/reports/patient-chronology.ts",
     "src/components/ward-management/reports/weekly-report.ts",
     "src/components/ward-management/ward-clipboard.ts",
diff --git a/tests/ward-legal-movements-export.test.ts b/tests/ward-legal-movements-export.test.ts
new file mode 100644
index 000000000..15aed74c8
--- /dev/null
+++ b/tests/ward-legal-movements-export.test.ts
@@ -0,0 +1,81 @@
+import { describe, expect, it } from "vitest";
+
+import { screenHelpFor } from "@/components/ward-management/help/ward-help-content";
+import {
+  LEGAL_FORMS_EXPORT_HEADER,
+  legalEndAsTyped,
+  legalFormsExportLines,
+} from "@/components/ward-management/legal-forms/legal-forms-export";
+import { currentLegalDueAt } from "@/components/ward-management/legal-forms/legal-form-progression";
+import { MOVEMENTS_EXPORT_HEADER, movementsExportLines } from "@/components/ward-management/movements/movements-export";
+import { searchCoreViews } from "@/components/ward-management/search/ward-smart-search";
+import { formatSheetMoment } from "@/components/ward-management/ward-clock";
+import { seedWardFlowState } from "@/components/ward-management/ward-flow-reducer";
+import type { Movement } from "@/components/ward-management/ward-model";
+import { NOW_ANCHOR } from "@/components/ward-management/ward-sites";
+
+// Feature 44 exports for Legal forms and Movements, the help added for four pages, and the Leave
+// page in search. Synthetic seed only.
+const state = seedWardFlowState();
+const dayZero = new Date(Date.UTC(2026, 10, 11));
+const NAME = { givenName: "Synthia", familyName: "Testperson" };
+const typed = state.movements.find(
+  (movement) => currentLegalDueAt(movement) !== undefined && movement.closure === undefined,
+)!;
+const ctx = { umrnOf: () => "UM000001", edName: () => "Synthetic ED", wardName: () => null, now: NOW_ANCHOR, dayZero };
+
+describe("legal end as typed (D-93)", () => {
+  const dueAt = currentLegalDueAt(typed)!;
+  it("gives the typed time with its date, never a count", () => {
+    expect(legalEndAsTyped(typed, dueAt - 75, dayZero)).toBe(`Ends ${formatSheetMoment(dueAt, dayZero)} as typed`);
+    expect(legalEndAsTyped(typed, dueAt + 75, dayZero)).toBe(`Ended ${formatSheetMoment(dueAt, dayZero)} as typed`);
+  });
+  it("says when nothing was typed or the form was recorded as ended", () => {
+    const blank = { ...typed, legalForm: { ...typed.legalForm!, dueAt: undefined } } as Movement;
+    expect(legalEndAsTyped(blank, NOW_ANCHOR, dayZero)).toBe("No expiry recorded from the form");
+    const ended = { ...typed, legalForm: { ...typed.legalForm!, endedBy: {} } } as unknown as Movement;
+    expect(legalEndAsTyped(ended, NOW_ANCHOR, dayZero)).toBe("Recorded as ended");
+  });
+});
+
+describe("Legal forms and Movements exports (D-102)", () => {
+  const named = { ...typed, ...NAME } as Movement;
+  it("has a header row and one row per form, without names", () => {
+    const lines = legalFormsExportLines([named], ctx);
+    expect(lines[0]).toEqual([...LEGAL_FORMS_EXPORT_HEADER]);
+    expect(lines[1]?.[0]).toBe(typed.id);
+    expect(lines[1]?.[4]).toBe("No receiving ward");
+    expect(String(lines[1]?.[2])).toMatch(/^Form /u);
+    expect(JSON.stringify(lines)).not.toMatch(/Synthia|Testperson/u);
+  });
+  it("lists each movement with its stage and outcome, without names", () => {
+    const lines = movementsExportLines([named], { ...ctx, wardName: () => "Synthetic ward" });
+    expect(lines[0]).toEqual([...MOVEMENTS_EXPORT_HEADER]);
+    expect(lines[1]?.[0]).toBe(typed.id);
+    expect(lines[1]?.[10]).toBe("Open");
+    expect(String(lines[1]?.[9])).toMatch(/ as typed$/u);
+    expect(JSON.stringify(lines)).not.toMatch(/Synthia|Testperson/u);
+  });
+});
+
+describe("help for pages that had none", () => {
+  it.each([
+    ["/ward-flow/leave", "leave"],
+    ["/ward-flow/review", "todays-review"],
+    ["/ward-flow/triage/new", "triage-start"],
+    ["/ward-flow/people/PT-001/triage", "triage"],
+  ])("%s has its own help", (path, id) => {
+    expect(screenHelpFor(path, [])?.id).toBe(id);
+  });
+  it("keeps the patient page's help on the patient page", () => {
+    expect(screenHelpFor("/ward-flow/people/PT-001", [])?.id).toBe("patient");
+  });
+  it("leaves the bed meeting TV without help, since Help cannot open there (HF-10)", () => {
+    expect(screenHelpFor("/ward-flow/bed-meeting", [])).toBeUndefined();
+  });
+});
+
+it("finds the Leave page in search", () => {
+  expect(searchCoreViews("leave").map((result) => result.href)).toContain("/ward-flow/leave");
+  expect(searchCoreViews("due back").map((result) => result.href)).toContain("/ward-flow/leave");
+});
diff --git a/tests/ward-list-print-export-more.dom.test.tsx b/tests/ward-list-print-export-more.dom.test.tsx
new file mode 100644
index 000000000..3e5a13a4b
--- /dev/null
+++ b/tests/ward-list-print-export-more.dom.test.tsx
@@ -0,0 +1,133 @@
+import { fireEvent, render, screen, waitFor, within } from "@testing-library/react";
+import type { ReactNode } from "react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+import { LeaveScreen } from "@/components/ward-management/leave/leave-screen";
+import { LegalFormsScreen } from "@/components/ward-management/legal-forms/legal-forms-screen";
+import { MovementsScreen } from "@/components/ward-management/movements/movements-screen";
+import { unitHref } from "@/components/ward-management/shell/ward-facade";
+import { WardFlowOverride, WardFlowProvider, useWardFlow } from "@/components/ward-management/ward-flow-provider";
+import { seedWardFlowState } from "@/components/ward-management/ward-flow-reducer";
+import type { LeaveBed } from "@/components/ward-management/ward-model";
+import { resolveSubjectPatient } from "@/components/ward-management/ward-patient-resolver";
+import { NOW_ANCHOR } from "@/components/ward-management/ward-sites";
+
+// Leave page (Open ward, Print) and Print and Export on Legal forms and Movements (feature 44).
+// Synthetic seed only. Exports carry record numbers and UMRNs, never names (D-102), and legal
+// times only as typed (D-93).
+const { createObjectURL, revokeObjectURL } = URL;
+afterEach(() => {
+  URL.createObjectURL = createObjectURL;
+  URL.revokeObjectURL = revokeObjectURL;
+  vi.restoreAllMocks();
+});
+
+function wrap(children: ReactNode) {
+  return render(<WardFlowProvider initialNow={NOW_ANCHOR}>{children}</WardFlowProvider>);
+}
+
+/** Clicks Export and returns the downloaded CSV's text. */
+async function exportedCsv(testId: string): Promise<string> {
+  let file: Blob | undefined;
+  URL.createObjectURL = (blob: Blob) => {
+    file = blob;
+    return "blob:synthetic-export";
+  };
+  URL.revokeObjectURL = vi.fn();
+  vi.spyOn(HTMLAnchorElement.prototype, "click").mockImplementation(() => {});
+  fireEvent.click(screen.getByTestId(testId));
+  await waitFor(() => expect(file).toBeDefined(), { timeout: 10_000 });
+  return file!.text();
+}
+
+function expectNoNames(csv: string) {
+  const state = seedWardFlowState();
+  const cells = new Set(csv.split("\r\n").flatMap((line) => line.split(",").map((c) => c.replace(/^"'?|"$/gu, ""))));
+  for (const movement of state.movements) {
+    const person = resolveSubjectPatient(movement, state);
+    if (person.patient) {
+      expect(csv).not.toContain(person.patient.familyName);
+      expect(cells).not.toContain(person.patient.givenName);
+    }
+    if (person.initials) expect(cells).not.toContain(person.initials);
+  }
+}
+
+/** A legal time column never carries a count ("2h 05m", "left", "ago", "overdue"). */
+const COUNT = /\b\d+\s*[dhm]\b|\bleft\b|\bago\b|\boverdue\b/u;
+
+describe("Leave page", () => {
+  const leave = (id: string, unitId: string, expectedReturn: number, extra: Partial<LeaveBed> = {}): LeaveBed => ({
+    id,
+    unitId,
+    admissionId: `adm-${id}`,
+    expectedReturn,
+    confirmedAt: 0,
+    confirmedBy: "Ward nurse",
+    ...extra,
+  });
+  function WithLeave() {
+    const flow = useWardFlow();
+    const [a, b] = [flow.units[0]!.id, flow.units[1]!.id];
+    const leaveBeds = [
+      leave("l-over", a, flow.now - 30),
+      leave("l-away", b, flow.now + 10, { absentWithoutLeave: { since: flow.now - 60, steps: [] } }),
+      leave("l-later", b, flow.now + 3 * 1440),
+    ];
+    return (
+      <WardFlowOverride value={{ ...flow, leaveBeds }}>
+        <LeaveScreen />
+      </WardFlowOverride>
+    );
+  }
+
+  it("offers Open ward on overdue and absent rows only, opening the ward's leave view", () => {
+    wrap(<WithLeave />);
+    const over = screen.getByTestId("ward-leave-row-l-over");
+    const link = within(over).getByRole("link", { name: /^Open ward/u });
+    const seed = seedWardFlowState();
+    expect(link.getAttribute("href")).toBe(`${unitHref(seed.units[0]!.id)}#ward-leave-bed-form`);
+    expect(within(screen.getByTestId("ward-leave-row-l-away")).getByRole("link", { name: /^Open ward/u })).toBeTruthy();
+    expect(
+      within(screen.getByTestId("ward-leave-row-l-later")).queryByRole("link", { name: /^Open ward/u }),
+    ).toBeNull();
+  });
+
+  it("prints with the browser's own print and says on paper what the list holds", () => {
+    const print = vi.spyOn(window, "print").mockImplementation(() => {});
+    wrap(<WithLeave />);
+    fireEvent.click(screen.getByRole("button", { name: "Print this list" }));
+    expect(print).toHaveBeenCalledTimes(1);
+    expect(screen.getByTestId("ward-leave-print-scope").textContent).toMatch(/^Everyone on leave · As at .+ AWST/u);
+  });
+});
+
+describe("Legal forms Print and Export", () => {
+  it("exports everyone on a form without names, each end exactly as typed", async () => {
+    wrap(<LegalFormsScreen />);
+    expect(screen.getByTestId("ward-legal-print")).toBeTruthy();
+    const csv = await exportedCsv("ward-legal-export");
+    const lines = csv.split("\r\n");
+    expect(lines[0]).toBe('"Data","Synthetic, not clinical records"');
+    const header = lines.findIndex((line) => line.startsWith('"Record","UMRN","Form"'));
+    expect(header).toBeGreaterThan(0);
+    const rows = lines.slice(header + 1);
+    expect(rows.length).toBeGreaterThan(0);
+    const ends = rows.map((line) => line.split('","')[6] ?? "");
+    expect(ends.some((cell) => / as typed$/u.test(cell))).toBe(true);
+    for (const cell of ends) expect(cell).not.toMatch(COUNT);
+    expectNoNames(csv);
+  });
+});
+
+describe("Movements Print and Export", () => {
+  it("exports the worklist without names", async () => {
+    wrap(<MovementsScreen />);
+    expect(screen.getByTestId("ward-movements-print")).toBeTruthy();
+    const csv = await exportedCsv("ward-movements-export");
+    const lines = csv.split("\r\n");
+    expect(lines.some((line) => line.startsWith('"Record","UMRN","Stage","ED"'))).toBe(true);
+    expect(lines.length).toBeGreaterThan(8);
+    expectNoNames(csv);
+  });
+});

From 5c90753593b0cbbd85aff402ef4f7a68267ffe31 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:15:48 +0000
Subject: [PATCH 19/40] Renumber the review ruling to D-145 (D-144 is claimed
 by PR #1617)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/decisions.md         | 6 +++---
 eslint-rules/max-lines-baseline.mjs | 2 +-
 eslint.config.mjs                   | 2 +-
 tests/max-lines-baseline.test.ts    | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/ward-flow/decisions.md b/docs/ward-flow/decisions.md
index c1c659528..cd347d86e 100644
--- a/docs/ward-flow/decisions.md
+++ b/docs/ward-flow/decisions.md
@@ -156,7 +156,7 @@ Checked 9 November 2026 (D-107 audit). "Partly replaced" means part of the entry
 | [D-131](#d-131-hard-case-demo-data-allowed-and-the-movement-diagram-follows-the-engine-10-november-2026)                                                | Hard-case demo data allowed, and the movement diagram follows the engine               | Active                                           |
 | [D-132](#d-132-audit-fixes-group-1-docs-and-ci-guards-10-november-2026)                                                                                 | Audit fixes group 1: docs and CI guards; Claude-authored sensitive changes warn        | Active                                           |
 | [D-138](#d-138-phone-alert-urgency-by-kind-10-november-2026)                                                                                            | Phone alert urgency by kind                                                            | Active                                           |
-| [D-144](#d-144-repository-review-fixes-features-and-code-health-approved-11-november-2026)                                                              | Repository review: fixes, features and code health approved                            | Active                                           |
+| [D-145](#d-145-repository-review-fixes-features-and-code-health-approved-11-november-2026)                                                              | Repository review: fixes, features and code health approved                            | Active                                           |
 
 ---
 
@@ -1701,9 +1701,9 @@ is inferred.
 - **Decision:** act-now phone alerts stay high urgency and buzz again when replaced. Jobs and team alerts go out at normal urgency and replace their earlier alert quietly. Settings shows when this device last received an alert, from the time only (never the alert's words).
 - **Boundary:** synthetic data only. Changes no signed clinical value or clinical rule, and approves no merge or release.
 
-## D-144. Repository review: fixes, features and code health approved (11 November 2026)
+## D-145. Repository review: fixes, features and code health approved (11 November 2026)
 
-- **Date:** 11 November 2026 (`2026-11-11`). **Decided by:** Josh, in the Ward Flow project thread "Review repository for issues and new features": "Go ahead with all these recommendations please" (03:55 UTC), answering the review doc "Ward Flow repository review, 11 November 2026". Numbered D-144 because D-133 to D-143 belong to other threads. D-139 is claimed by open PR #1600, D-140 is claimed by open PR #1606, D-141 is claimed by open PR #1606, D-142 is claimed by open PR #1603, and D-143 is claimed by open PR #1612.
+- **Date:** 11 November 2026 (`2026-11-11`). **Decided by:** Josh, in the Ward Flow project thread "Review repository for issues and new features": "Go ahead with all these recommendations please" (03:55 UTC), answering the review doc "Ward Flow repository review, 11 November 2026". Numbered D-145 because D-133 to D-144 belong to other threads. D-139 is claimed by open PR #1600, D-140 is claimed by open PR #1606, D-141 is claimed by open PR #1606, D-142 is claimed by open PR #1603, D-143 is claimed by open PR #1612, and D-144 is claimed by open PR #1617.
 - **Decision:**
   1. **Clinical display fixes, one held PR:** a ward's expected occupancy no longer counts a patient twice when they hold a named bed and also have a booked planned admission to that ward; an ended legal form says it ended and gives the expiry only as it was typed; the ED screen flags a long wait at 24 hours or more, like every other screen.
   2. **Non-clinical fixes:** one lapse check for pull holds, staff requests keep the shift the person chose, one reader for typed times, one length-of-stay calculation, a demo code shorter than 12 characters counts as no code, and a demo pass stops working when the code changes. Two lines added to the real-data go/no-go list (record ids never built from UMRNs; a check of the push library).
diff --git a/eslint-rules/max-lines-baseline.mjs b/eslint-rules/max-lines-baseline.mjs
index 22b4deeaa..e63a22824 100644
--- a/eslint-rules/max-lines-baseline.mjs
+++ b/eslint-rules/max-lines-baseline.mjs
@@ -28,7 +28,7 @@
 // 10 Nov 2026 (Tier 7 audit A5-05): the cap now covers the backend's source files too. postgres.mjs
 // was split by area into workspace-*.mjs; its remaining core (the record cache, reads, saves,
 // archive and the command path) gets a cap of its size plus about 150 lines.
-// 11 Nov 2026 (D-144, Josh approved): the cap counts code lines only. Blank lines and comment-only
+// 11 Nov 2026 (D-145, Josh approved): the cap counts code lines only. Blank lines and comment-only
 // lines no longer count (MAX_LINES_COUNTING), so nobody deletes spacing or safety comments to fit.
 // The caps were in raw lines; each is now re-set to the file's code lines plus the same
 // headroom it had under raw counting, so no file gains room to grow. ward-model, ward-movements,
diff --git a/eslint.config.mjs b/eslint.config.mjs
index fb5c718ef..0da104b10 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -179,7 +179,7 @@ const eslintConfig = defineConfig([
   },
   // File size ratchet. New source files stay under MAX_LINES_DEFAULT lines, and the files that
   // were already larger cannot grow much past their baseline (eslint-rules/max-lines-baseline.mjs).
-  // Only code lines count: blank lines and comment-only lines are free (MAX_LINES_COUNTING, D-144).
+  // Only code lines count: blank lines and comment-only lines are free (MAX_LINES_COUNTING, D-145).
   {
     files: ["src/**/*.{ts,tsx}"],
     rules: {
diff --git a/tests/max-lines-baseline.test.ts b/tests/max-lines-baseline.test.ts
index d99d1c37e..1ea903eda 100644
--- a/tests/max-lines-baseline.test.ts
+++ b/tests/max-lines-baseline.test.ts
@@ -7,7 +7,7 @@ import {
   MAX_LINES_HEADROOM,
 } from "../eslint-rules/max-lines-baseline.mjs";
 
-// Count lines the way the lint cap does (code lines only, D-144): run ESLint's own max-lines rule
+// Count lines the way the lint cap does (code lines only, D-145): run ESLint's own max-lines rule
 // with a cap of 0 on each listed file and read the line count from its message.
 async function codeLineCounts(files: string[]) {
   const eslint = new ESLint({

From 488a1da9aee64015862d0d5e69eec5e9e77a62ce Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:19:08 +0000
Subject: [PATCH 20/40] deps: Next 16.4.6, Vitest 5.1, lucide-react 1.71
 patch/minor updates

- next, @next/env, eslint-config-next 16.4.5 -> 16.4.6 (exact pins)
- @next/bundle-analyzer ^16.4.0 (locked 16.4.2) -> ^16.4.6
- vitest and @vitest/coverage-v8 ^5.0.4 (locked 5.0.5) -> ^5.1.0
- lucide-react ^1.56.0 (locked 1.58.0) -> ^1.71.0

knip stays at 6.41.0: 6.45.0 reports 15 new unused exports in src, which
needs source changes, not a version bump. Playwright, TypeScript 7,
jsdom 31 and @types/node 26 are deliberately not updated. Lockfile
regenerated with the pinned npm 11.17.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 package-lock.json | 376 +++++++++++++++++++++++++---------------------
 package.json      |  14 +-
 2 files changed, 210 insertions(+), 180 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 2bd1931ed..c8322f2bf 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -12,8 +12,8 @@
       "dependencies": {
         "@sentry/core": "^11.8.0",
         "html-to-image": "1.11.13",
-        "lucide-react": "^1.56.0",
-        "next": "16.4.5",
+        "lucide-react": "^1.71.0",
+        "next": "16.4.6",
         "postcss": "^8.5.26",
         "react": "19.3.1",
         "react-dom": "19.3.1",
@@ -23,8 +23,8 @@
       "devDependencies": {
         "@axe-core/playwright": "~4.14.0",
         "@babel/parser": "^8.0.7",
-        "@next/bundle-analyzer": "^16.4.0",
-        "@next/env": "16.4.5",
+        "@next/bundle-analyzer": "^16.4.6",
+        "@next/env": "16.4.6",
         "@tailwindcss/postcss": "^4.3.3",
         "@testing-library/dom": "^10.4.2",
         "@testing-library/jest-dom": "^7.0.1",
@@ -33,11 +33,11 @@
         "@types/node": "^24.19.2",
         "@types/react": "^19.3.0",
         "@types/react-dom": "^19.3.0",
-        "@vitest/coverage-v8": "^5.0.4",
+        "@vitest/coverage-v8": "^5.1.0",
         "babel-plugin-react-compiler": "1.0.0",
         "esbuild": "0.28.2",
         "eslint": "^10.13.0",
-        "eslint-config-next": "16.4.5",
+        "eslint-config-next": "16.4.6",
         "jsdom": "^30.1.2",
         "knip": "^6.41.0",
         "parse5": "8.0.1",
@@ -48,7 +48,7 @@
         "tailwindcss": "^4.3.1",
         "tsx": "^4.23.15",
         "typescript": "^6.0.0",
-        "vitest": "^5.0.4"
+        "vitest": "^5.1.0"
       },
       "engines": {
         "node": ">=24.22.1 <25",
@@ -2008,9 +2008,9 @@
       }
     },
     "node_modules/@next/bundle-analyzer": {
-      "version": "16.4.2",
-      "resolved": "https://registry.npmjs.org/@next/bundle-analyzer/-/bundle-analyzer-16.4.2.tgz",
-      "integrity": "sha512-tpNTC/WZYsmmixg3MZfx5JUuTh+Sgryu4eKhe7leQRcXHabztqtTkPCQM1Bk1VsE0trZ3w7NUCC3Zf7SeIBVzg==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/bundle-analyzer/-/bundle-analyzer-16.4.6.tgz",
+      "integrity": "sha512-Evp2ETZoDcqpg5LZPeJNG51o1Bc5vH+LPSP+BmSkdjeykMCh1fMB/shs3bJVbTOxYp7wC3Ed3HLo0jgX1BdxNA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -2018,15 +2018,15 @@
       }
     },
     "node_modules/@next/env": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/env/-/env-16.4.5.tgz",
-      "integrity": "sha512-JwSPwpdkZL5VMl2jA/q+JI8MZdweAL3xmw5/tb9y/TLtmS0YXZnmYDzSihwk8xTj1OL+WM53gTqaj96yuLp6Xw==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/env/-/env-16.4.6.tgz",
+      "integrity": "sha512-SunBjJ6t+oBtecS3dTjdVuMhUogP5wD/vrGL5EVuQYM1iS4O5ilL51HkiJ3sPjMzRHiCChvr4dbaSJbR7F3lxA==",
       "license": "MIT"
     },
     "node_modules/@next/eslint-plugin-next": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/eslint-plugin-next/-/eslint-plugin-next-16.4.5.tgz",
-      "integrity": "sha512-dNmc4y4En/34tWxaBFF2tG/R9GeiRwVPf7v8Az/Pqk8FcT4Uv0ePmrZKvWBL2nFy1QprPgJW+6XjfyV6jbRV3Q==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/eslint-plugin-next/-/eslint-plugin-next-16.4.6.tgz",
+      "integrity": "sha512-HdqERVOafOD8JaUSAkwf9aSu/1rsHlkN8C5GcXYBH3C/z1MxBhZFxB5rz/xqMMRiIj7r9tIv8OCLQ9JWUxCvWA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -2035,9 +2035,9 @@
       }
     },
     "node_modules/@next/swc-darwin-arm64": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-16.4.5.tgz",
-      "integrity": "sha512-W5TniBzWKASbNNwHZ/S/f1MxQUXU/LdjklVMWA0Ujbfl7SZnUzFls45hO0i/sF7Bx1jJBWp7WWmoQajXtX/O8A==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-16.4.6.tgz",
+      "integrity": "sha512-kJ4VVZkley17xKaJx72QN2IBqjrj7zenCQZaUF0l9ShS/1Mt2kW4+Z5KGG6vgr3L/J562xTOizVyM1iA/u5nlg==",
       "cpu": [
         "arm64"
       ],
@@ -2051,9 +2051,9 @@
       }
     },
     "node_modules/@next/swc-darwin-x64": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-16.4.5.tgz",
-      "integrity": "sha512-uWq4qkHapBDS1oFltWS4YxTb9pLHAtLNcpbuK6SmRsebLYZqpBML/j/C0op+50JYGTpZgVL/DWNt/6oWlamrrw==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-16.4.6.tgz",
+      "integrity": "sha512-eIPGZIqC+8JKaeZmvnCANJQF4xWkkHqSnAAajtFxgwDMAOnCgxNvP52SeWZ41PyVwoe+Le/NQuZSaQ8j7YshSA==",
       "cpu": [
         "x64"
       ],
@@ -2067,9 +2067,9 @@
       }
     },
     "node_modules/@next/swc-linux-arm64-gnu": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-16.4.5.tgz",
-      "integrity": "sha512-FdRcyOx5u5P51mlAqLB9EXdd8jZO5fsdHtk4BAQSkqOywCsbTNN/rmw+jO7pnmjNdAtu2AG46NzbCL2FPDrrgw==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-16.4.6.tgz",
+      "integrity": "sha512-9nI6O8vvczH2D9ZNdMGqb/3NuT15T9ksOZnAmx9/gjF2cOi74+xxyf1Hk96uIMfm14c9y6wHeBq6SH8g6udvcA==",
       "cpu": [
         "arm64"
       ],
@@ -2086,9 +2086,9 @@
       }
     },
     "node_modules/@next/swc-linux-arm64-musl": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-16.4.5.tgz",
-      "integrity": "sha512-cyvmmgtRXR8aGVT86wi9Py53IlfyCx7P2fZxuAXAoTummDnhKtUyjrMeXfapqp4qgD+gT5RqyGD/VfA16jEK7Q==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-16.4.6.tgz",
+      "integrity": "sha512-7/qPhTxDp2ScluOJOhLuhWmlA17o1yZ0SIgpISBCpBxXgtnK4+KGywBpFkfLPiU1rnSM1faFGzYkH6i7JdTrqA==",
       "cpu": [
         "arm64"
       ],
@@ -2105,9 +2105,9 @@
       }
     },
     "node_modules/@next/swc-linux-x64-gnu": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-16.4.5.tgz",
-      "integrity": "sha512-hPc+Fl+N22DAvqZHq559NmamXboOX5Lu8I5Wl0DezfrhTk1Zz21NQeYoZDmNI/NjTcrdsVxM72Fzn2lI+Q+vAw==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-16.4.6.tgz",
+      "integrity": "sha512-oOpbNa8XOW1qCGd9VvzC4fbkkRxEls7/WI6tz+YHC0xRA7KpV1U7DrAnCPjzVyOk/karzWEepCOcTIDmwK8FwQ==",
       "cpu": [
         "x64"
       ],
@@ -2124,9 +2124,9 @@
       }
     },
     "node_modules/@next/swc-linux-x64-musl": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-16.4.5.tgz",
-      "integrity": "sha512-gbACYE8IP/jlprNTpiWXHb8N9CofOzpnEwH2SrIz1dUbiJf1FbDssDupCAPeP1Taxe8mgG20sGZamJI7KFOdZw==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-16.4.6.tgz",
+      "integrity": "sha512-aM8CZ+OR2EwXaAYw7KGkW2GDmNDsLBIRe1MMRZCJPTdw/xhTD0IMUVO4sf3KqrzuRouGzwwLZn34+gFeVXiUQA==",
       "cpu": [
         "x64"
       ],
@@ -2143,9 +2143,9 @@
       }
     },
     "node_modules/@next/swc-win32-arm64-msvc": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-16.4.5.tgz",
-      "integrity": "sha512-+8gj++ZMo8H20Xh2ijjNqyFk5LPLw0AC4Fs4Tq/G94rjjQXhOjN4jgSWsWKPFsyY26hfIeemJIwKtMxOsp5GBA==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-16.4.6.tgz",
+      "integrity": "sha512-U0p7/tEtqvHX2crhd841CDwKtp5CFkKXVjOhmfccR3Pvp64sj8KBwRqsvltqLOwVBbj0NtkxwXSDpEHYGbxeXQ==",
       "cpu": [
         "arm64"
       ],
@@ -2159,9 +2159,9 @@
       }
     },
     "node_modules/@next/swc-win32-x64-msvc": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.4.5.tgz",
-      "integrity": "sha512-qNZj66pYXnaWLiF9R9GUbfBdrCv7kC6TaZfIwB2KH5WPc/8pEM3nVOj8hpQhWJU8S94rlH5MPDcX15+RrgUhiw==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.4.6.tgz",
+      "integrity": "sha512-3ZG15/5WIdlTQsIEvc9sPTTSL5XFrlLklIKmfF4fwsDnoAhu6NcBDXsk3mbGxNyo6aVLEGex+fHCv2MahY7a9g==",
       "cpu": [
         "x64"
       ],
@@ -2570,14 +2570,14 @@
       }
     },
     "node_modules/@oxc-project/types": {
-      "version": "0.147.0",
-      "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.147.0.tgz",
-      "integrity": "sha512-IJ3s6ltHLp45S0bh7phkX+gJO7A1Wuz2EaqpAhb8WjqDwbzMiWKHhyyT42tskaWjEYXtHtVCPpnBJVT9+dcRLg==",
+      "version": "0.156.0",
+      "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.156.0.tgz",
+      "integrity": "sha512-1Duyg48TdJNdyhEB8Xn1L36bT9Pv6GUtlKjHxOys8xkaF/rQq3XJE+bAurSK/AgIz5mGFsb77cn9Pb20+WCScw==",
       "dev": true,
       "license": "MIT",
       "peer": true,
       "funding": {
-        "url": "https://github.com/sponsors/Boshen"
+        "url": "https://github.com/sponsors/oxc-project"
       }
     },
     "node_modules/@oxc-resolver/binding-android-arm-eabi": {
@@ -2859,9 +2859,9 @@
       "license": "MIT"
     },
     "node_modules/@rolldown/binding-android-arm-eabi": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.6.tgz",
-      "integrity": "sha512-b+jTcARdTiFLI6jB4a5XjTm0RWd6KcRfQj/I2356fxUZemiho9zQLxo0RtCuMDAyKcLo6cEltkgbQp6d1+sjjQ==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.18.tgz",
+      "integrity": "sha512-ubTG+4KlidvioxjOFdsdEa2F6JVGZb8m2ByJUqQ7fYzUeT1cEn194POcsQ10PKH4p//q0YQn4SB3YpSuzcA1Yg==",
       "cpu": [
         "arm"
       ],
@@ -2877,9 +2877,9 @@
       }
     },
     "node_modules/@rolldown/binding-android-arm64": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.6.tgz",
-      "integrity": "sha512-lkWU8ZJaRk9q3CIEY1Tc7vIFALp3Xw5NfGJo2hQg5oIqNgxWi1zI+IiDEK3r70BF5Dzol1tcXsnzsRc8NLhG+Q==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.18.tgz",
+      "integrity": "sha512-2Xa1t/JeFGTZn5TbzgPppcCftF8sCVnTNvrIvoSdcZhoFzAuVy1L3xxQUQ4sfWDtwVzg1u6Yi1R3SlJugRNV2Q==",
       "cpu": [
         "arm64"
       ],
@@ -2895,9 +2895,9 @@
       }
     },
     "node_modules/@rolldown/binding-darwin-arm64": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.6.tgz",
-      "integrity": "sha512-dgR56NYnvAszm7Ob1B2/Vn0e8bUQYZH2UjVaMMtMVOCKFSfjhfLmuA/9+O+F+ajUdG6B/bSssrKW6JJYASa8jA==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.18.tgz",
+      "integrity": "sha512-iUzw9HshVvrWci9gVXjxWS7/M/IcLvNo67vu2c/w9zKBz4hIvPRixdUpIW/iCfhldLaq9ER2hecsI9UY5z0/yA==",
       "cpu": [
         "arm64"
       ],
@@ -2913,9 +2913,9 @@
       }
     },
     "node_modules/@rolldown/binding-darwin-x64": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.6.tgz",
-      "integrity": "sha512-vpVxFvUCFioJqug7OTvqptkc4yb8UX0AwfDmJpaR/0sWz+BUmqSVAf7c8JkUgnN8YLspb4a/N6NhTyMAmdyQ7Q==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.18.tgz",
+      "integrity": "sha512-XuDHFzbFEtZl0QGJi92+fmG67tfnp1iZ9VOeDkwasGyTq2VG3/5PnJnvAr+MTzFh/rNScJ3VhN+XpZyyGsN7Jw==",
       "cpu": [
         "x64"
       ],
@@ -2931,9 +2931,9 @@
       }
     },
     "node_modules/@rolldown/binding-freebsd-x64": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.6.tgz",
-      "integrity": "sha512-h1wG6Y6K3JlRswxsI64qQJqBAy4vrLuHgRbc8CZMGSWTOFRY6ghMApM1NKzB2I0n5xV1fjkE18SuVl2QpLeNpA==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.18.tgz",
+      "integrity": "sha512-MM8opLfsLK15oEXDz6iBc0t3ahu+ew9jsAmha+ovZ33hSwYgqo7YmpRITqFTfW7xA71BLEQ3jJdTsaCmhB1c9w==",
       "cpu": [
         "x64"
       ],
@@ -2949,9 +2949,9 @@
       }
     },
     "node_modules/@rolldown/binding-linux-arm-gnueabihf": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.6.tgz",
-      "integrity": "sha512-tbCiqub0q2MVWJKgF5PoAlNWCtQydiOYSLIkd8sByqK/6MMYLJRcSXSYodqYtd0O+Fw7QaVmKKlS4oL94YRZ0w==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.18.tgz",
+      "integrity": "sha512-J6EoCWiy5RnFQzHrKyHXXevZ9lukQfGpnchX/zG/k/WC2nc9O9XyS1JgA8kI9VxMFggMbCPjpv7LcikriXfehw==",
       "cpu": [
         "arm"
       ],
@@ -2967,13 +2967,16 @@
       }
     },
     "node_modules/@rolldown/binding-linux-arm64-gnu": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.6.tgz",
-      "integrity": "sha512-oxK9+baEBPhZG5HB4URY+uU04zJWeZlH6Tb9rB5DK4DF9XR1uXNLXt5Q5ZsugTKayNCNLhkcwz/ye74hRI98dg==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.18.tgz",
+      "integrity": "sha512-HIkFuLF7CdDeki+1aCZLLbLq0hk/PHntb+z4/YCTo47JbksTD6jJEELIz92tYROmDmvMrNqUMqBi71BkJLDR+A==",
       "cpu": [
         "arm64"
       ],
       "dev": true,
+      "libc": [
+        "glibc"
+      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2985,13 +2988,16 @@
       }
     },
     "node_modules/@rolldown/binding-linux-arm64-musl": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.6.tgz",
-      "integrity": "sha512-muWCk27FVBEZtv0MsK8gnfSmgczA8KQ0uRVJbTABKhkRfQc38aUrcb7fhi3BNiyseFmgcRsoMfQsSNJ+DbZdSw==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.18.tgz",
+      "integrity": "sha512-4oqWItLLYt7IceOnElCct8T2ek5p7PmD7LN04TRJRXGo5f3HtKTgGH6PhYRFK4C2ICkq/LMUU0BVPvvlAKhm8g==",
       "cpu": [
         "arm64"
       ],
       "dev": true,
+      "libc": [
+        "musl"
+      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3003,13 +3009,16 @@
       }
     },
     "node_modules/@rolldown/binding-linux-ppc64-gnu": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.6.tgz",
-      "integrity": "sha512-eWDoSfU7Co2qj3vgB3Dt4lj1mG6CoWbcJQkRMP3XJplyCMtuaq3LHvPFjS9QIPvMGWVadJC04Xiy0IdcVPtnwQ==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.18.tgz",
+      "integrity": "sha512-+AkRly5SrCEgnPhGRfub7pucASYEC2fTsxZg7VCcnozpA2+Wn/gCYy1t7LuJS67/xyJu/7noYBJncDUkbwgw2A==",
       "cpu": [
         "ppc64"
       ],
       "dev": true,
+      "libc": [
+        "glibc"
+      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3021,13 +3030,16 @@
       }
     },
     "node_modules/@rolldown/binding-linux-s390x-gnu": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.6.tgz",
-      "integrity": "sha512-2bWNjRSIayvupRKxXUY2tWG9fYdoUlTqWywHRvE8Eq3GvuQ+f2HeIkve697fIt+IQs/PV8yFsdWuhp1aJ1PdnA==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.18.tgz",
+      "integrity": "sha512-Ttg1r9vVykMnQrE/GwYO9icKtXiuiMfRe/w74xJkeoVuvhRG+WtT6LEMOf58Yl63yd77lhHzO8Y55R8CC3XALA==",
       "cpu": [
         "s390x"
       ],
       "dev": true,
+      "libc": [
+        "glibc"
+      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3039,13 +3051,16 @@
       }
     },
     "node_modules/@rolldown/binding-linux-x64-gnu": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.6.tgz",
-      "integrity": "sha512-KekI0gS0wLxe1UBSQSjenBVwou/JkcQPDzBPICGZjxUv9k3RteHDPBQaiOicZUFKRIH2wKEimGwVpnJsbPzu7w==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.18.tgz",
+      "integrity": "sha512-xX1Tt4o5jUMma0vJsXp5eRZA9nOuyigb2dKJMMzZRmzMxLYGE9PaKKSqHPzPvSQgM8ZOEacSTQwDQcwWfh0xmQ==",
       "cpu": [
         "x64"
       ],
       "dev": true,
+      "libc": [
+        "glibc"
+      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3057,13 +3072,16 @@
       }
     },
     "node_modules/@rolldown/binding-linux-x64-musl": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.6.tgz",
-      "integrity": "sha512-TvtPnfVr+HtyGiDmPK4VWmlNm7QhNNAcK5Q9A7aOXsI8545yCyaoMaicXrFZ72JzeYjaUVk7yT243zT0jzjFKQ==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.18.tgz",
+      "integrity": "sha512-4VVlGI5K2kociZlW3lSN8VjG3TW5yQIlAcfCdBXMgGjJxZll15Fa4ocRHXHvIVVnwlibCw/NQajJrNDiqqpiiw==",
       "cpu": [
         "x64"
       ],
       "dev": true,
+      "libc": [
+        "musl"
+      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3075,9 +3093,9 @@
       }
     },
     "node_modules/@rolldown/binding-openharmony-arm64": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.6.tgz",
-      "integrity": "sha512-iOo0VEay2XFhaCcH0sps5XIimkSuOnNaZrf6+ZkoSOQBJPKNU48RkmJv0/lSpipexu5P+ouFgafe5IGr/DiQfg==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.18.tgz",
+      "integrity": "sha512-PApTsgH1jLYuyy3tSCz9De82Gq5qXwi7vImVZhEzTgX1C4150Cp5M2ZfL3pLvbCvbEHL0oJeC6pd6podtv8Y5w==",
       "cpu": [
         "arm64"
       ],
@@ -3093,9 +3111,9 @@
       }
     },
     "node_modules/@rolldown/binding-win32-arm64-msvc": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.6.tgz",
-      "integrity": "sha512-y5NTmmasMS455JlOCO4ZM9krIchv3Mvm1crL1iUPGOPgEzSkves9n0SdC5Sjz6+qWDFhd8/JpfWMH8NSWNHe+A==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.18.tgz",
+      "integrity": "sha512-J2XjWjx/SP+4x0H4r6dz3Vzb5WVkg7re40Do9K7HJ3sK2/xcmZrWwakXlSwaMvOkvruLJCD4CL/3wqsIR/thgg==",
       "cpu": [
         "arm64"
       ],
@@ -3111,9 +3129,9 @@
       }
     },
     "node_modules/@rolldown/binding-win32-x64-msvc": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.6.tgz",
-      "integrity": "sha512-np8iZSLfXlAD4kWhiyq/u0Yt8oZDtRQ8lGhQaCXo2rl37KNjeU0GjJuwr4P3oeZ++ROfofsKNBqR5LTO8aXyWQ==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.18.tgz",
+      "integrity": "sha512-XwRJxRQvkuEtS0hIIt29QrqPJ+JzMJSNYHJw4ae/mc6uEarfRG1ceyg4HmmWiBdL/YCb6g7N5BLbSvmRJRYZHw==",
       "cpu": [
         "x64"
       ],
@@ -3129,9 +3147,9 @@
       }
     },
     "node_modules/@rolldown/pluginutils": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz",
-      "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==",
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.1.0.tgz",
+      "integrity": "sha512-K+NU2HDCEem4sClgHH4ZZXwdJeNFkJo+hRk479DIwdIviAPN2hFJH1KHHwg8CxHQXvi0M5XY4deTXINfIiSG6w==",
       "dev": true,
       "license": "MIT",
       "peer": true
@@ -4110,15 +4128,15 @@
       ]
     },
     "node_modules/@vitest/coverage-v8": {
-      "version": "5.0.5",
-      "resolved": "https://registry.npmjs.org/@vitest/coverage-v8/-/coverage-v8-5.0.5.tgz",
-      "integrity": "sha512-4KpkGdIrSqBihx/JyP/e+S+IKB98etg1XDQiLAxksLfcShnwi1VReGeOT9NI43hLHbknosKp/1CCLn9Zgcs8mg==",
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/coverage-v8/-/coverage-v8-5.1.0.tgz",
+      "integrity": "sha512-OY9aShBQG5KOIw2zCo9fDoCHI9RHliNHJ//nM7m6jGg41Hyke9JOGWmeMlK74xYErsxMoK8mIB3gAeEyFVA7LA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@bcoe/v8-coverage": "^1.0.2",
-        "@vitest/istanbul-lib-coverage": "^1.0.2",
-        "@vitest/istanbul-lib-report": "^1.0.2",
+        "@vitest/istanbul-lib-coverage": "^2.1.0",
+        "@vitest/istanbul-lib-report": "^2.1.0",
         "ast-v8-to-istanbul": "^1.0.7",
         "magicast": "^0.5.5",
         "obug": "^3.0.0",
@@ -4129,8 +4147,8 @@
         "url": "https://opencollective.com/vitest"
       },
       "peerDependencies": {
-        "@vitest/browser": "5.0.5",
-        "vitest": "5.0.5"
+        "@vitest/browser": "5.1.0",
+        "vitest": "5.1.0"
       },
       "peerDependenciesMeta": {
         "@vitest/browser": {
@@ -4139,9 +4157,9 @@
       }
     },
     "node_modules/@vitest/istanbul-lib-coverage": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/@vitest/istanbul-lib-coverage/-/istanbul-lib-coverage-1.0.2.tgz",
-      "integrity": "sha512-9J/JMwOf9AoJhAywhrn7ScKTL38hsWQP/qPG60OtaAFcQ5OXPwKsxZFlbnuCKmZ61m8/lGgHYnFpdyQZUvG/iA==",
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/istanbul-lib-coverage/-/istanbul-lib-coverage-2.1.0.tgz",
+      "integrity": "sha512-WOjuS+xcjSIy7ruYBQ+9BUcV7XZQ0FyVcbWbWxW9TRx/kLGx5SQaeFRIFDJxjNplb6YsT7SpKo2zuXXUo91OIQ==",
       "dev": true,
       "license": "MIT",
       "engines": {
@@ -4149,27 +4167,27 @@
       }
     },
     "node_modules/@vitest/istanbul-lib-report": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/@vitest/istanbul-lib-report/-/istanbul-lib-report-1.0.2.tgz",
-      "integrity": "sha512-gUsfXZJbzPamoIY5TvHFiMMoXESBrUMo+xqaj+rYrWI69+EnvRlYBlP96ZnHPY4vX8kyUpgAnFUCg5wZG/HkDQ==",
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/istanbul-lib-report/-/istanbul-lib-report-2.1.0.tgz",
+      "integrity": "sha512-+ZFta25nWtGCOBG9/IET8w1RO5Oawsd6H8Uf6AJ9EA/StFuKVtKAEJEJ6uRt84OH+T4YkI0ASmIHAhRA+0KVxw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@vitest/istanbul-lib-coverage": "1.0.2"
+        "@vitest/istanbul-lib-coverage": "2.1.0"
       },
       "engines": {
         "node": ">=22"
       }
     },
     "node_modules/@vitest/mocker": {
-      "version": "5.0.5",
-      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-5.0.5.tgz",
-      "integrity": "sha512-xLL3lkDegJZw+MGoGaCCsFayDZthGgpAtr3Vziyfc4p7xH89K7KRPcRBBh/kEYm0Aqkt5DtTmkYpBtRV/FrHZg==",
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-5.1.0.tgz",
+      "integrity": "sha512-5umB9/jlWcqVS6fsrFmv5Gdnpu6wAUio/lEOwAmvB7v+lFo/IW2B9FhAD0p19GCULTgMzLCdUmuCDCnAzWgppQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@jridgewell/trace-mapping": "0.3.31",
-        "@vitest/spy": "5.0.5",
+        "@vitest/spy": "5.1.0",
         "estree-walker": "^3.0.3",
         "magic-string": "^1.4.3"
       },
@@ -4190,9 +4208,9 @@
       }
     },
     "node_modules/@vitest/mocker/node_modules/magic-string": {
-      "version": "1.4.3",
-      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.4.3.tgz",
-      "integrity": "sha512-z12OxmaPGE0F4xlpGdjuAUckipLpQlTAuAmyGhNoD7ODpYUzvDfvtxUbjM/jwznyP178oju/KDdyi220wNJ0RQ==",
+      "version": "1.4.5",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.4.5.tgz",
+      "integrity": "sha512-oLLC2+YvQUfAa+vxoufE/yc1icb87M9iXIRqAoR/2EhE/8cb3SF/+Gi0c2By1B+5Vz2e2vQtUvHiu1+63Znh+w==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -4200,9 +4218,9 @@
       }
     },
     "node_modules/@vitest/spy": {
-      "version": "5.0.5",
-      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-5.0.5.tgz",
-      "integrity": "sha512-lwJRExuH417257Q5wv9QYugN9IMJkoxcrKrYxGPQkBzl7wlNpTUxD/5yNX4ESKVUIShKPgkGchYPFMWOOk0wzw==",
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-5.1.0.tgz",
+      "integrity": "sha512-2DPO5OMHWKrBngC+fCmTQqemNF0gidRhp3lxbBmRhW+M1XJrfgPpqNqWVevXtn2f2ufD5ZaR1B6B641aAlcX5A==",
       "dev": true,
       "license": "MIT",
       "funding": {
@@ -5350,13 +5368,13 @@
       }
     },
     "node_modules/eslint-config-next": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/eslint-config-next/-/eslint-config-next-16.4.5.tgz",
-      "integrity": "sha512-mvh39zYLoNjpT5tVmf8xZu7i5lEOb5jN5cW6qD9OpeCp4GEEOeYta0Z2XyKiD0pYdlvm5/Td6Bi890maPRlIjg==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/eslint-config-next/-/eslint-config-next-16.4.6.tgz",
+      "integrity": "sha512-IBGGrVf9E6pL0NGL0hmeicVGeSyv1VEzIWq6IecDqkw+YFByhEtDJS9u1r6s6a1VxK6rssh69KyNFQUgfaacqw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "@next/eslint-plugin-next": "16.4.5",
+        "@next/eslint-plugin-next": "16.4.6",
         "eslint-import-resolver-node": "^0.3.6",
         "eslint-import-resolver-typescript": "^3.5.2",
         "eslint-plugin-import": "^2.32.0",
@@ -7593,9 +7611,9 @@
       }
     },
     "node_modules/lucide-react": {
-      "version": "1.58.0",
-      "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-1.58.0.tgz",
-      "integrity": "sha512-hXaFNm6mk6QVtBnDGBn1YAs8j2tGUk0A4s/CpclIcczfxeXiW1rdOLVo6zCsoIih9XXsGvDODQerl749a2n7bA==",
+      "version": "1.71.0",
+      "resolved": "https://registry.npmjs.org/lucide-react/-/lucide-react-1.71.0.tgz",
+      "integrity": "sha512-8YtvF+bqT/EMqAXU7kWvYdRu+TV9j4kS1eIS7IbN1j1Z1DgupbrTL0nDIygdqgBDTD7AJPP607VdVgzDTar4zA==",
       "license": "ISC",
       "peerDependencies": {
         "@types/react": "*",
@@ -7801,12 +7819,12 @@
       "license": "MIT"
     },
     "node_modules/next": {
-      "version": "16.4.5",
-      "resolved": "https://registry.npmjs.org/next/-/next-16.4.5.tgz",
-      "integrity": "sha512-rmdfsWosjTUO+6R0S3KokoIk6Kj0sWDRTe86tZHdqaWH/oXq/udX3/4xb+YQi7aWbyEFoglDU54kaifLCdXbBw==",
+      "version": "16.4.6",
+      "resolved": "https://registry.npmjs.org/next/-/next-16.4.6.tgz",
+      "integrity": "sha512-QZJiYhaZLJMo2KpkQGQIwvmd79WVsAWeYIU554a8d7zArS3si/IRy3lBNV/rtYhE70oLwdLYhPAXLPx8HwcwtA==",
       "license": "MIT",
       "dependencies": {
-        "@next/env": "16.4.5",
+        "@next/env": "16.4.6",
         "@swc/helpers": "0.5.23",
         "baseline-browser-mapping": "^2.9.19",
         "caniuse-lite": "^1.0.30001579",
@@ -7820,14 +7838,14 @@
         "node": ">=20.9.0"
       },
       "optionalDependencies": {
-        "@next/swc-darwin-arm64": "16.4.5",
-        "@next/swc-darwin-x64": "16.4.5",
-        "@next/swc-linux-arm64-gnu": "16.4.5",
-        "@next/swc-linux-arm64-musl": "16.4.5",
-        "@next/swc-linux-x64-gnu": "16.4.5",
-        "@next/swc-linux-x64-musl": "16.4.5",
-        "@next/swc-win32-arm64-msvc": "16.4.5",
-        "@next/swc-win32-x64-msvc": "16.4.5",
+        "@next/swc-darwin-arm64": "16.4.6",
+        "@next/swc-darwin-x64": "16.4.6",
+        "@next/swc-linux-arm64-gnu": "16.4.6",
+        "@next/swc-linux-arm64-musl": "16.4.6",
+        "@next/swc-linux-x64-gnu": "16.4.6",
+        "@next/swc-linux-x64-musl": "16.4.6",
+        "@next/swc-win32-arm64-msvc": "16.4.6",
+        "@next/swc-win32-x64-msvc": "16.4.6",
         "sharp": "^0.35.5"
       },
       "peerDependencies": {
@@ -8587,14 +8605,14 @@
       }
     },
     "node_modules/rolldown": {
-      "version": "1.2.6",
-      "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.6.tgz",
-      "integrity": "sha512-vMM4q3aixf46GiF1Kok8jDPFsEpXgFWGjUHXNkNHNm+Y2adXAG2dbX91jkti3i0ZRsOlcmbuzAz1poObSHCmUA==",
+      "version": "1.2.18",
+      "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.18.tgz",
+      "integrity": "sha512-C1uuT3UR60SShuCaPQFAAZyefJCWZlAKB02BV3BuPE2Rs4fevRQltEKoFO2tV5W9/eJhU5RieV6vJj3euulfNQ==",
       "dev": true,
       "license": "MIT",
       "peer": true,
       "dependencies": {
-        "@oxc-project/types": "=0.147.0",
+        "@oxc-project/types": "=0.156.0",
         "@rolldown/pluginutils": "^1.0.0"
       },
       "bin": {
@@ -8604,21 +8622,21 @@
         "node": "^20.19.0 || >=22.12.0"
       },
       "optionalDependencies": {
-        "@rolldown/binding-android-arm-eabi": "1.2.6",
-        "@rolldown/binding-android-arm64": "1.2.6",
-        "@rolldown/binding-darwin-arm64": "1.2.6",
-        "@rolldown/binding-darwin-x64": "1.2.6",
-        "@rolldown/binding-freebsd-x64": "1.2.6",
-        "@rolldown/binding-linux-arm-gnueabihf": "1.2.6",
-        "@rolldown/binding-linux-arm64-gnu": "1.2.6",
-        "@rolldown/binding-linux-arm64-musl": "1.2.6",
-        "@rolldown/binding-linux-ppc64-gnu": "1.2.6",
-        "@rolldown/binding-linux-s390x-gnu": "1.2.6",
-        "@rolldown/binding-linux-x64-gnu": "1.2.6",
-        "@rolldown/binding-linux-x64-musl": "1.2.6",
-        "@rolldown/binding-openharmony-arm64": "1.2.6",
-        "@rolldown/binding-win32-arm64-msvc": "1.2.6",
-        "@rolldown/binding-win32-x64-msvc": "1.2.6"
+        "@rolldown/binding-android-arm-eabi": "1.2.18",
+        "@rolldown/binding-android-arm64": "1.2.18",
+        "@rolldown/binding-darwin-arm64": "1.2.18",
+        "@rolldown/binding-darwin-x64": "1.2.18",
+        "@rolldown/binding-freebsd-x64": "1.2.18",
+        "@rolldown/binding-linux-arm-gnueabihf": "1.2.18",
+        "@rolldown/binding-linux-arm64-gnu": "1.2.18",
+        "@rolldown/binding-linux-arm64-musl": "1.2.18",
+        "@rolldown/binding-linux-ppc64-gnu": "1.2.18",
+        "@rolldown/binding-linux-s390x-gnu": "1.2.18",
+        "@rolldown/binding-linux-x64-gnu": "1.2.18",
+        "@rolldown/binding-linux-x64-musl": "1.2.18",
+        "@rolldown/binding-openharmony-arm64": "1.2.18",
+        "@rolldown/binding-win32-arm64-msvc": "1.2.18",
+        "@rolldown/binding-win32-x64-msvc": "1.2.18"
       }
     },
     "node_modules/run-parallel": {
@@ -8943,9 +8961,9 @@
       }
     },
     "node_modules/smol-toml": {
-      "version": "1.9.0",
-      "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.9.0.tgz",
-      "integrity": "sha512-hpd+HLON7HdZXqYchMM/+LaTTbdK0AU3NngIJ4KVyWbY9bfQqdL9cD+4yf6dUoU2Ap4VsU0JkQi6FxAI1B2mXQ==",
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.9.1.tgz",
+      "integrity": "sha512-j7WyPdf0CJoutMzMoPLF/bVXHtKZIT9Rb4eGeEbWw8X2t5oirjPgpL+OpaENZrILYaXqYwnVH+qgUwVbl+pUJQ==",
       "dev": true,
       "license": "BSD-3-Clause",
       "engines": {
@@ -9624,17 +9642,17 @@
       }
     },
     "node_modules/vite": {
-      "version": "8.2.4",
-      "resolved": "https://registry.npmjs.org/vite/-/vite-8.2.4.tgz",
-      "integrity": "sha512-lfauXnrf2x0p+UoA+wXh0dgFWnUjCyG6Js95KBkgaCwUU9k0DAHI4W6Q0WCx+h+5g+Alce1y4Zi2QjjK0UvGBw==",
+      "version": "8.3.8",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-8.3.8.tgz",
+      "integrity": "sha512-LzOn3h9rG/0vhLdXrV4yJ4QFA9eEoqCl+Yx+kGJd7aB9w6nfNgVHKSYwLPZUHrz4ZGa+t+kXjV9itvcHDLQouA==",
       "dev": true,
       "license": "MIT",
       "peer": true,
       "dependencies": {
         "lightningcss": "^1.33.0",
-        "picomatch": "^4.0.5",
-        "postcss": "^8.5.26",
-        "rolldown": "~1.2.4",
+        "picomatch": "^4.0.7",
+        "postcss": "^8.5.32",
+        "rolldown": "~1.2.18",
         "tinyglobby": "^0.2.17"
       },
       "bin": {
@@ -9651,7 +9669,7 @@
       },
       "peerDependencies": {
         "@types/node": "^20.19.0 || >=22.12.0",
-        "@vitejs/devtools": "^0.4.0 || ^0.5.0",
+        "@vitejs/devtools": "^0.7.1 || ^0.8.0",
         "esbuild": "^0.27.0 || ^0.28.0",
         "jiti": ">=1.21.0",
         "less": "^4.0.0",
@@ -9851,6 +9869,9 @@
         "arm64"
       ],
       "dev": true,
+      "libc": [
+        "glibc"
+      ],
       "license": "MPL-2.0",
       "optional": true,
       "os": [
@@ -9873,6 +9894,9 @@
         "arm64"
       ],
       "dev": true,
+      "libc": [
+        "musl"
+      ],
       "license": "MPL-2.0",
       "optional": true,
       "os": [
@@ -9895,6 +9919,9 @@
         "x64"
       ],
       "dev": true,
+      "libc": [
+        "glibc"
+      ],
       "license": "MPL-2.0",
       "optional": true,
       "os": [
@@ -9917,6 +9944,9 @@
         "x64"
       ],
       "dev": true,
+      "libc": [
+        "musl"
+      ],
       "license": "MPL-2.0",
       "optional": true,
       "os": [
@@ -9976,14 +10006,14 @@
       }
     },
     "node_modules/vitest": {
-      "version": "5.0.5",
-      "resolved": "https://registry.npmjs.org/vitest/-/vitest-5.0.5.tgz",
-      "integrity": "sha512-cPODOMF8YnkiiYtDdHo6n4wWmBrOBBbOIYH2d33M4l3CdNn72h+qMmO6uXffUN6A5AZFXNND/d+krS9mgkXRfg==",
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/vitest/-/vitest-5.1.0.tgz",
+      "integrity": "sha512-MzmNFnrwa8v8lF1bLxw3UJ4EREwVOVb75VqJZmUDRjJ6EluK/x9th7qTbaeDk41WxE1GxWqmTXcdsfobfH5sOA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "@types/chai": "^5.2.2",
-        "@vitest/mocker": "5.0.5",
+        "@vitest/mocker": "5.1.0",
         "chai": "^6.3.0",
         "es-module-lexer": "^2.3.2",
         "expect-type": "^1.4.0",
@@ -10009,12 +10039,12 @@
         "@edge-runtime/vm": "*",
         "@opentelemetry/api": "^1.9.0",
         "@types/node": "^22.0.0 || >=24.0.0",
-        "@vitest/browser-playwright": "5.0.5",
-        "@vitest/browser-preview": "5.0.5",
+        "@vitest/browser-playwright": "5.1.0",
+        "@vitest/browser-preview": "5.1.0",
         "@vitest/browser-webdriverio": "^5.0.0-beta.5 || >=5.0.0",
-        "@vitest/coverage-istanbul": "5.0.5",
-        "@vitest/coverage-v8": "5.0.5",
-        "@vitest/ui": "5.0.5",
+        "@vitest/coverage-istanbul": "5.1.0",
+        "@vitest/coverage-v8": "5.1.0",
+        "@vitest/ui": "5.1.0",
         "happy-dom": "*",
         "jsdom": "*",
         "vite": "^6.4.0 || ^7.0.0 || ^8.0.0"
diff --git a/package.json b/package.json
index d011075d0..d4c4bafc0 100644
--- a/package.json
+++ b/package.json
@@ -105,8 +105,8 @@
   "dependencies": {
     "@sentry/core": "^11.8.0",
     "html-to-image": "1.11.13",
-    "lucide-react": "^1.56.0",
-    "next": "16.4.5",
+    "lucide-react": "^1.71.0",
+    "next": "16.4.6",
     "postcss": "^8.5.26",
     "react": "19.3.1",
     "react-dom": "19.3.1",
@@ -131,8 +131,8 @@
   "devDependencies": {
     "@axe-core/playwright": "~4.14.0",
     "@babel/parser": "^8.0.7",
-    "@next/bundle-analyzer": "^16.4.0",
-    "@next/env": "16.4.5",
+    "@next/bundle-analyzer": "^16.4.6",
+    "@next/env": "16.4.6",
     "@tailwindcss/postcss": "^4.3.3",
     "@testing-library/dom": "^10.4.2",
     "@testing-library/jest-dom": "^7.0.1",
@@ -141,11 +141,11 @@
     "@types/node": "^24.19.2",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
-    "@vitest/coverage-v8": "^5.0.4",
+    "@vitest/coverage-v8": "^5.1.0",
     "babel-plugin-react-compiler": "1.0.0",
     "esbuild": "0.28.2",
     "eslint": "^10.13.0",
-    "eslint-config-next": "16.4.5",
+    "eslint-config-next": "16.4.6",
     "jsdom": "^30.1.2",
     "knip": "^6.41.0",
     "parse5": "8.0.1",
@@ -156,7 +156,7 @@
     "tailwindcss": "^4.3.1",
     "tsx": "^4.23.15",
     "typescript": "^6.0.0",
-    "vitest": "^5.0.4"
+    "vitest": "^5.1.0"
   },
   "allowScripts": {
     "esbuild@0.28.2": true,

From 4b92bf13e6deb240adb663013956f39216c1fe33 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:39:14 +0000
Subject: [PATCH 21/40] Refresh journey source digests and note the staff
 request shift field

Dispatch is unchanged where only comments or helpers moved lines; the
staff request disposition now names the optional shiftStartAt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/journey/MAP-INVENTORY.md       |  5 +-
 docs/ward-flow/journey/actions.json           | 56 +++++++++----------
 .../ward-flow/journey/event-dispositions.json | 11 ++--
 docs/ward-flow/journey/machines.json          |  2 +-
 .../journey/ward-journey-explorer.html        |  2 +-
 5 files changed, 39 insertions(+), 37 deletions(-)

diff --git a/docs/ward-flow/journey/MAP-INVENTORY.md b/docs/ward-flow/journey/MAP-INVENTORY.md
index 5bf83b42e..c90a757c9 100644
--- a/docs/ward-flow/journey/MAP-INVENTORY.md
+++ b/docs/ward-flow/journey/MAP-INVENTORY.md
@@ -1566,13 +1566,14 @@ Source-contract SHA256: e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e186
   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.
   payload: unitId; shift this or next; count 1, 2, 3 or 4 or more
   payload: reasons: one or more distinct items from STAFF_REQUEST_REASONS; actingUnitId for ward callers; role and now
+  payload: optional shiftStartAt: the start of the shift the person chose; kept only when it is that shift's start at now or 5 minutes earlier, otherwise the shift at now is used
   guards: Known unit; shift and count from their lists
   guards: 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
   effects: Does not change beds, placement, movements or any patient stage
   tests: tests/ward-staff-requests.test.ts
   Reviewed source: src/components/ward-management/ward-flow-reducer.ts:2375; SHA256 edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a
-  Reviewed source: src/components/ward-management/staffing/staff-requests.ts:132; SHA256 d3e51d13faedefa5314d5f128c59473110a61bae075bd5ddb362788d5ae479f3
+  Reviewed source: src/components/ward-management/staffing/staff-requests.ts:156; SHA256 e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a
   Reviewed source: src/components/ward-management/ward-flow-event-roles.ts:591; SHA256 01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb
 - CLOSE_WARD_STAFF_REQUEST — modelled; event roles: ward, coordinator, bed_manager
   Source-reviewed command model: an open staff request closed as arranged, not available or withdrawn.
@@ -1590,7 +1591,7 @@ Source-contract SHA256: e73d1cd81542d3f2030a3f69d3b7b5dc096d8695d24f6ec6a605e186
   effects: Does not change beds, placement, movements or any patient stage
   tests: tests/ward-staff-requests.test.ts
   Reviewed source: src/components/ward-management/ward-flow-reducer.ts:2376; SHA256 edd08d18e7d96cad77b0a026b29f7acc6b9918b4818010e53b14e08d9c00eb2a
-  Reviewed source: src/components/ward-management/staffing/staff-requests.ts:171; SHA256 d3e51d13faedefa5314d5f128c59473110a61bae075bd5ddb362788d5ae479f3
+  Reviewed source: src/components/ward-management/staffing/staff-requests.ts:195; SHA256 e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a
   Reviewed source: src/components/ward-management/ward-flow-event-roles.ts:592; SHA256 01913e33459ff2e0c7dfce7de7e0e731cc155400a42b2537e1e6ad7a6c3c83eb
 - RECORD_CLINICAL_CONTACT — diagram-reviewed; event roles: community, coordinator
   Diagram action notes reviewed against the recorded source revision. Source digests detect subsequent edits; this is not runtime acceptance.
diff --git a/docs/ward-flow/journey/actions.json b/docs/ward-flow/journey/actions.json
index f0f5ca1e1..cd114df49 100644
--- a/docs/ward-flow/journey/actions.json
+++ b/docs/ward-flow/journey/actions.json
@@ -172,8 +172,8 @@
         },
         {
           "path": "src/components/ward-management/patients/add-patient.tsx",
-          "line": 614,
-          "sha256": "fc5752f90ad948491ad836c940e4eb1571aba082c71cee36e4e6083afdf78002"
+          "line": 611,
+          "sha256": "e4d277572fc48f16fc5a3746118fc7ab1758d274ed28ae459d9cd1821a2de4f0"
         },
         {
           "path": "src/components/ward-management/referrals/use-referral-command-completion.ts",
@@ -396,8 +396,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1351,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1348,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/referrals/referral-match.tsx",
@@ -498,8 +498,8 @@
         },
         {
           "path": "src/components/ward-management/ed/use-ed-screen-decline.ts",
-          "line": 135,
-          "sha256": "ff7e1679d14d0e040af8cfa6bf07805d7c1bffc9cf8cf7a0d055fedc5f4862fd"
+          "line": 133,
+          "sha256": "f32c28822c1a39a28697617ed37d1cada5fa8bbce0c6ec1d2d9454107f60d01f"
         },
         {
           "path": "src/components/ward-management/referrals/referral-match.tsx",
@@ -1039,8 +1039,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1313,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1310,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/ward/ward-answer-view.tsx",
@@ -1131,8 +1131,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1404,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1401,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/ward/ward-answer-view.tsx",
@@ -1853,8 +1853,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1449,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1446,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/ward/ward-answer-view.tsx",
@@ -1968,8 +1968,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1847,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1844,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/patients/patient-transit-operations.tsx",
@@ -3385,8 +3385,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1745,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1742,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/tools/ward-tool-feed.tsx",
@@ -3691,8 +3691,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1770,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1767,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/board/ward-board.tsx",
@@ -3824,8 +3824,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1683,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1680,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/ward-flow-bed-events.ts",
@@ -4037,8 +4037,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1702,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1699,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/discharges/discharge-board.tsx",
@@ -4170,8 +4170,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1591,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1588,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/ward/ward-answer-view.tsx",
@@ -4699,8 +4699,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1099,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1096,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/ward-inbox-reducer.ts",
@@ -6725,8 +6725,8 @@
         },
         {
           "path": "src/components/ward-management/ward/ward-screen.tsx",
-          "line": 1079,
-          "sha256": "5e374492e10a8cb8387133eb099251ef9e3734eddb7a25466839a627dd441612"
+          "line": 1076,
+          "sha256": "217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"
         },
         {
           "path": "src/components/ward-management/ward-flow-reducer.ts",
diff --git a/docs/ward-flow/journey/event-dispositions.json b/docs/ward-flow/journey/event-dispositions.json
index 4c76c503a..244c577b4 100644
--- a/docs/ward-flow/journey/event-dispositions.json
+++ b/docs/ward-flow/journey/event-dispositions.json
@@ -4027,7 +4027,8 @@
       "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"
+        "reasons: one or more distinct items from STAFF_REQUEST_REASONS; actingUnitId for ward callers; role and now",
+        "optional shiftStartAt: the start of the shift the person chose; kept only when it is that shift's start at now or 5 minutes earlier, otherwise the shift at now is used"
       ],
       "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": [
@@ -4046,8 +4047,8 @@
         },
         {
           "path": "src/components/ward-management/staffing/staff-requests.ts",
-          "line": 132,
-          "sha256": "d3e51d13faedefa5314d5f128c59473110a61bae075bd5ddb362788d5ae479f3"
+          "line": 156,
+          "sha256": "e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a"
         },
         {
           "path": "src/components/ward-management/ward-flow-event-roles.ts",
@@ -4088,8 +4089,8 @@
         },
         {
           "path": "src/components/ward-management/staffing/staff-requests.ts",
-          "line": 171,
-          "sha256": "d3e51d13faedefa5314d5f128c59473110a61bae075bd5ddb362788d5ae479f3"
+          "line": 195,
+          "sha256": "e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a"
         },
         {
           "path": "src/components/ward-management/ward-flow-event-roles.ts",
diff --git a/docs/ward-flow/journey/machines.json b/docs/ward-flow/journey/machines.json
index 2fcdf924c..f1f7cf43e 100644
--- a/docs/ward-flow/journey/machines.json
+++ b/docs/ward-flow/journey/machines.json
@@ -1754,7 +1754,7 @@
       {
         "path": "src/components/ward-management/patients/add-patient.tsx",
         "line": 87,
-        "sha256": "fc5752f90ad948491ad836c940e4eb1571aba082c71cee36e4e6083afdf78002"
+        "sha256": "e4d277572fc48f16fc5a3746118fc7ab1758d274ed28ae459d9cd1821a2de4f0"
       },
       {
         "path": "src/components/ward-management/patients/patient-now-screen.tsx",
diff --git a/docs/ward-flow/journey/ward-journey-explorer.html b/docs/ward-flow/journey/ward-journey-explorer.html
index 70659ed84..1ca9c357d 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":611,"sha256":"e4d277572fc48f16fc5a3746118fc7ab1758d274ed28ae459d9cd1821a2de4f0"},{"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":1348,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":133,"sha256":"f32c28822c1a39a28697617ed37d1cada5fa8bbce0c6ec1d2d9454107f60d01f"},{"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":1310,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1401,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1446,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1844,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1742,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1767,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1680,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1699,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1588,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1096,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1076,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":"e4d277572fc48f16fc5a3746118fc7ab1758d274ed28ae459d9cd1821a2de4f0"},{"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","optional shiftStartAt: the start of the shift the person chose; kept only when it is that shift's start at now or 5 minutes earlier, otherwise the shift at now is used"],"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":156,"sha256":"e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a"},{"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":195,"sha256":"e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a"},{"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-11T04:39:02.056Z","commit":"2dd1e4513afe4099f7fd9e276344122bd1b29b42","branch":"","dirty":true,"dirtyCount":3},"refusalCoverage":null};
 
       // Every lane a node or action can carry, and the colour it draws in.
       const LANE_COLOUR = {

From ee4584ce3b5af6e09f88638b49c3bb5c37f545b6 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 04:58:18 +0000
Subject: [PATCH 22/40] Polish Print and Export placement, the Open ward link
 and Leave's paper

- Open ward takes the kit's quiet link look (accent ink, underline), so it reads
  as a link in dark too; on the phone the separator is no longer underlined.
- Export's empty status note is visually hidden until it has words, so it no
  longer adds a gap: Print and Export now sit flush with the row's right edge on
  Movements, Legal forms and every other list that uses them.
- Legal forms: the colour key moves under the title as the card's meta, so the
  header is no longer crowded against Print and Export.
- Leave: Print moves into the list's card head beside the filter, as on Legal
  forms and Movements, so the page title keeps its line; on the phone it is the
  printer alone, named "Print this list". Paper uses A4 with 10 mm margins as
  Discharges does, and the list prints as a plain ruled table with no card edge
  or shadow to be cut at the page edge.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../leave/leave-screen.module.css             | 40 +++++++++++++++----
 .../ward-management/leave/leave-screen.tsx    | 30 +++++++++-----
 .../legal-forms/legal-forms-screen.tsx        |  3 +-
 .../ward-list-export-button.tsx               |  7 +++-
 .../ward-list-print-button.tsx                | 28 ++++++-------
 5 files changed, 74 insertions(+), 34 deletions(-)

diff --git a/src/components/ward-management/leave/leave-screen.module.css b/src/components/ward-management/leave/leave-screen.module.css
index dd9b89382..0f3000c3e 100644
--- a/src/components/ward-management/leave/leave-screen.module.css
+++ b/src/components/ward-management/leave/leave-screen.module.css
@@ -7,13 +7,6 @@
   padding: var(--wf-s-4);
 }
 
-.head {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: var(--wf-s-3);
-}
-
 .title {
   margin: 0;
   font-size: var(--wf-fs-20);
@@ -94,12 +87,26 @@
   font-variant-numeric: tabular-nums;
 }
 
-/* Overdue or absent rows: the ward page where the leave is ended. */
+/* Overdue or absent rows: the ward page where the leave is ended. The kit's quiet link look
+ * (figure.module.css `.link`): accent ink and an underline, so it reads as a link in dark too. */
 .wardLink {
   display: block;
   margin-top: 2px;
   font-size: var(--wf-fs-12);
   color: var(--wf-accent-ink);
+  text-decoration: underline;
+  text-decoration-thickness: 1px;
+  text-underline-offset: 2px;
+  border-radius: var(--wf-r-xs);
+}
+
+.wardLink:hover {
+  text-decoration-thickness: 2px;
+}
+
+.wardLink:focus-visible {
+  outline: 2px solid var(--wf-focus-ring);
+  outline-offset: 2px;
 }
 
 .printScope {
@@ -206,8 +213,11 @@
     display: inline;
   }
 
+  /* Inline-block, so the link's underline stops at the link and skips the separator. */
   .table td.ward .wardLink::before {
     content: " · ";
+    display: inline-block;
+    white-space: pre;
     color: var(--wf-ink-2);
   }
 
@@ -231,10 +241,24 @@
 
 /* Paper: the whole list in the page's flow, with what it holds and when. */
 @media print {
+  /* Same paper as Discharges and the bed-meeting sheet (P048). */
+  @page {
+    size: A4 portrait;
+    margin: 10mm;
+  }
+
   .main {
     padding: 0;
   }
 
+  /* Paper takes no card chrome: the list prints as a plain ruled table, so no shadow or rounded edge
+   * is cut at the page's content edge. */
+  .main .listCard {
+    border: 0;
+    border-radius: 0;
+    box-shadow: none;
+  }
+
   .printScope {
     display: block;
     margin: 0;
diff --git a/src/components/ward-management/leave/leave-screen.tsx b/src/components/ward-management/leave/leave-screen.tsx
index fb21e709b..f8693385c 100644
--- a/src/components/ward-management/leave/leave-screen.tsx
+++ b/src/components/ward-management/leave/leave-screen.tsx
@@ -2,7 +2,16 @@
 
 import { useMemo, useState } from "react";
 import Link from "next/link";
-import { Card, CardBody, CardHead, FilterChip, StatusGlyph, tableClasses, type WfTone } from "@/components/wf";
+import {
+  Card,
+  CardBody,
+  CardHead,
+  FilterChip,
+  StatusGlyph,
+  tableClasses,
+  useIsPhone,
+  type WfTone,
+} from "@/components/wf";
 import { useWardFlowClock, useWardFlowSelect } from "@/components/ward-management/ward-flow-provider";
 import { useEffectiveWardAccess } from "@/components/ward-management/shell/ward-access-store";
 import { wardPlaceLookup } from "@/components/ward-management/ward-access-places";
@@ -63,6 +72,7 @@ export function LeaveScreen() {
   const access = useEffectiveWardAccess();
   const canOpenHref = useCanOpenHref();
   const [needsActionOnly, setNeedsActionOnly] = useState(false);
+  const isPhone = useIsPhone();
   const rows = useMemo(() => {
     const places = wardPlaceLookup(units);
     const names = wardNames(units);
@@ -80,10 +90,7 @@ export function LeaveScreen() {
   const onLeave = rows.filter((row) => row.status !== "absent").length;
   return (
     <main id="main-content" className={styles.main} data-testid="ward-leave-screen">
-      <div className={styles.head}>
-        <h1 className={styles.title}>Leave</h1>
-        <ListPrintButton disabled={shown.length === 0} testId="ward-leave-print" />
-      </div>
+      <h1 className={styles.title}>Leave</h1>
       {/* On paper only: what the list holds and when, as the other printed lists say. */}
       <p className={styles.printScope} data-testid="ward-leave-print-scope">
         {needsActionOnly ? "Overdue or absent only" : "Everyone on leave"} · As at{" "}
@@ -93,14 +100,19 @@ export function LeaveScreen() {
         <span className={styles.figure}>{onLeave}</span> on leave · <span className={styles.figure}>{dueToday}</span>{" "}
         due back today · <span className={styles.figure}>{needsAction.length}</span> overdue or absent
       </p>
-      <Card aria-labelledby="ward-leave-list">
+      <Card aria-labelledby="ward-leave-list" className={styles.listCard}>
         <CardHead
           id="ward-leave-list"
           title="On leave"
           action={
-            <FilterChip pressed={needsActionOnly} onPressedChange={setNeedsActionOnly} count={needsAction.length}>
-              Overdue or absent
-            </FilterChip>
+            // Print sits with the list it prints, as on Legal forms and Movements, so the page title
+            // keeps its own line height. On a phone the printer alone keeps the head on one line.
+            <>
+              <FilterChip pressed={needsActionOnly} onPressedChange={setNeedsActionOnly} count={needsAction.length}>
+                Overdue or absent
+              </FilterChip>
+              <ListPrintButton iconOnly={isPhone} disabled={shown.length === 0} testId="ward-leave-print" />
+            </>
           }
         />
         <CardBody flush>
diff --git a/src/components/ward-management/legal-forms/legal-forms-screen.tsx b/src/components/ward-management/legal-forms/legal-forms-screen.tsx
index c34019530..ad5618900 100644
--- a/src/components/ward-management/legal-forms/legal-forms-screen.tsx
+++ b/src/components/ward-management/legal-forms/legal-forms-screen.tsx
@@ -1090,7 +1090,8 @@ function LegalFormsWorkspace({ initialMovementId, recordOnOpen = false }: Worksp
                 <CardHead
                   title={shownView === "history" ? "Closed moves with a form" : "Everyone on a form"}
                   level={2}
-                  aside={
+                  // The note sits under the title and wraps, so the list's tools keep the right edge.
+                  meta={
                     <span className={styles.meta}>
                       {highlight
                         ? `${highlightCount} of ${rows.length} highlighted, all rows stay`
diff --git a/src/components/ward-management/ward-list-export-button.tsx b/src/components/ward-management/ward-list-export-button.tsx
index 7d2e0f928..d7efe687a 100644
--- a/src/components/ward-management/ward-list-export-button.tsx
+++ b/src/components/ward-management/ward-list-export-button.tsx
@@ -55,8 +55,11 @@ export function ListExportButton({
       >
         Export
       </Button>
-      {/* Always present, so a screen reader announces the note when it arrives. */}
-      <span role="status">{note}</span>
+      {/* Always present, so a screen reader announces the note when it arrives. Visually hidden while
+          empty, so it takes no gap in a flex row and the button sits flush with the row's right edge. */}
+      <span role="status" className={note ? undefined : "sr-only"}>
+        {note}
+      </span>
     </>
   );
 }
diff --git a/src/components/ward-management/ward-list-print-button.tsx b/src/components/ward-management/ward-list-print-button.tsx
index 0843798e6..4b1d8d63f 100644
--- a/src/components/ward-management/ward-list-print-button.tsx
+++ b/src/components/ward-management/ward-list-print-button.tsx
@@ -10,25 +10,25 @@ import { Button } from "@/components/wf";
  */
 export function ListPrintButton({
   variant = "sec",
+  iconOnly = false,
   disabled,
   testId,
 }: {
   variant?: "sec" | "ghost";
+  /** The printer alone, named "Print this list", where a narrow card head has no room for the word. */
+  iconOnly?: boolean;
   disabled?: boolean;
   testId?: string;
 }) {
-  return (
-    <Button
-      variant={variant}
-      size="sm"
-      icon={Printer}
-      disabled={disabled}
-      aria-label="Print this list"
-      data-print-hide
-      data-testid={testId}
-      onClick={() => window.print()}
-    >
-      Print
-    </Button>
-  );
+  const shared = {
+    variant,
+    size: "sm",
+    icon: Printer,
+    disabled,
+    "aria-label": "Print this list",
+    "data-print-hide": true,
+    "data-testid": testId,
+    onClick: () => window.print(),
+  } as const;
+  return iconOnly ? <Button {...shared} iconOnly /> : <Button {...shared}>Print</Button>;
 }

From 95e22c48aa6a0e73f8a5c6b7615f7440dc933049 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 05:02:06 +0000
Subject: [PATCH 23/40] What's new line and journey digests for the screen
 additions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/journey/actions.json                  | 12 ++++++------
 docs/ward-flow/journey/machines.json                 |  2 +-
 docs/ward-flow/journey/ward-journey-explorer.html    |  2 +-
 .../2026-11-11-leave-print-and-exports.json          |  3 +++
 4 files changed, 11 insertions(+), 8 deletions(-)
 create mode 100644 src/components/ward-management/help/whats-new/2026-11-11-leave-print-and-exports.json

diff --git a/docs/ward-flow/journey/actions.json b/docs/ward-flow/journey/actions.json
index cd114df49..fb133f396 100644
--- a/docs/ward-flow/journey/actions.json
+++ b/docs/ward-flow/journey/actions.json
@@ -3093,8 +3093,8 @@
         },
         {
           "path": "src/components/ward-management/legal-forms/legal-forms-screen.tsx",
-          "line": 358,
-          "sha256": "6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"
+          "line": 365,
+          "sha256": "21e9f1961cac15e3deac106f62f32fd6f5b9dccd51020fd7827ebb52043b9d19"
         },
         {
           "path": "src/components/ward-management/ward-flow-record-events.ts",
@@ -3239,8 +3239,8 @@
         },
         {
           "path": "src/components/ward-management/legal-forms/legal-forms-screen.tsx",
-          "line": 1277,
-          "sha256": "6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"
+          "line": 1303,
+          "sha256": "21e9f1961cac15e3deac106f62f32fd6f5b9dccd51020fd7827ebb52043b9d19"
         },
         {
           "path": "src/components/ward-management/ward-flow-record-legal-events.ts",
@@ -6238,8 +6238,8 @@
         },
         {
           "path": "src/components/ward-management/legal-forms/legal-forms-screen.tsx",
-          "line": 524,
-          "sha256": "6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"
+          "line": 531,
+          "sha256": "21e9f1961cac15e3deac106f62f32fd6f5b9dccd51020fd7827ebb52043b9d19"
         },
         {
           "path": "src/components/ward-management/ward-flow-record-legal-events.ts",
diff --git a/docs/ward-flow/journey/machines.json b/docs/ward-flow/journey/machines.json
index f1f7cf43e..7a99e86a8 100644
--- a/docs/ward-flow/journey/machines.json
+++ b/docs/ward-flow/journey/machines.json
@@ -1744,7 +1744,7 @@
       {
         "path": "src/components/ward-management/legal-forms/legal-forms-screen.tsx",
         "line": 1,
-        "sha256": "6b9c32af15d569ddb7bcffdd4202bc0def13f74465b211163a1bd706293a4721"
+        "sha256": "21e9f1961cac15e3deac106f62f32fd6f5b9dccd51020fd7827ebb52043b9d19"
       },
       {
         "path": "src/components/ward-management/legal-forms/legal-forms-sheets.tsx",
diff --git a/docs/ward-flow/journey/ward-journey-explorer.html b/docs/ward-flow/journey/ward-journey-explorer.html
index 1ca9c357d..17854cfda 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":611,"sha256":"e4d277572fc48f16fc5a3746118fc7ab1758d274ed28ae459d9cd1821a2de4f0"},{"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":1348,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":133,"sha256":"f32c28822c1a39a28697617ed37d1cada5fa8bbce0c6ec1d2d9454107f60d01f"},{"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":1310,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1401,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1446,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1844,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1742,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1767,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1680,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1699,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1588,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1096,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1076,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":"e4d277572fc48f16fc5a3746118fc7ab1758d274ed28ae459d9cd1821a2de4f0"},{"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","optional shiftStartAt: the start of the shift the person chose; kept only when it is that shift's start at now or 5 minutes earlier, otherwise the shift at now is used"],"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":156,"sha256":"e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a"},{"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":195,"sha256":"e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a"},{"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-11T04:39:02.056Z","commit":"2dd1e4513afe4099f7fd9e276344122bd1b29b42","branch":"","dirty":true,"dirtyCount":3},"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":611,"sha256":"e4d277572fc48f16fc5a3746118fc7ab1758d274ed28ae459d9cd1821a2de4f0"},{"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":1348,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":133,"sha256":"f32c28822c1a39a28697617ed37d1cada5fa8bbce0c6ec1d2d9454107f60d01f"},{"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":1310,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1401,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1446,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1844,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":365,"sha256":"21e9f1961cac15e3deac106f62f32fd6f5b9dccd51020fd7827ebb52043b9d19"},{"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":1303,"sha256":"21e9f1961cac15e3deac106f62f32fd6f5b9dccd51020fd7827ebb52043b9d19"},{"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":1742,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1767,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1680,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1699,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1588,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":1096,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":531,"sha256":"21e9f1961cac15e3deac106f62f32fd6f5b9dccd51020fd7827ebb52043b9d19"},{"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":1076,"sha256":"217d4e23224a92d608df2fd5ee1581d323380bb7dae9e9b6ad7eaa6614628eb3"},{"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":"21e9f1961cac15e3deac106f62f32fd6f5b9dccd51020fd7827ebb52043b9d19"},{"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":"e4d277572fc48f16fc5a3746118fc7ab1758d274ed28ae459d9cd1821a2de4f0"},{"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","optional shiftStartAt: the start of the shift the person chose; kept only when it is that shift's start at now or 5 minutes earlier, otherwise the shift at now is used"],"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":156,"sha256":"e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a"},{"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":195,"sha256":"e47b9fadc1f70f84b56bd4e91eb36f5b95f85da6234e10f6251bea10c3f6237a"},{"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-11T05:01:40.453Z","commit":"e2646bc34076910ca148540a1a70fff360389f0e","branch":"claude/project-thread-e15xqk","dirty":true,"dirtyCount":2},"refusalCoverage":null};
 
       // Every lane a node or action can carry, and the colour it draws in.
       const LANE_COLOUR = {
diff --git a/src/components/ward-management/help/whats-new/2026-11-11-leave-print-and-exports.json b/src/components/ward-management/help/whats-new/2026-11-11-leave-print-and-exports.json
new file mode 100644
index 000000000..dcb024c5a
--- /dev/null
+++ b/src/components/ward-management/help/whats-new/2026-11-11-leave-print-and-exports.json
@@ -0,0 +1,3 @@
+{
+  "line": "Leave page: Open ward links, Print and a Search entry. New Help for Leave, Today's review and triage. Print and Export on Legal forms and Movements."
+}

From 8b3237bfde794c1aa616ca9c9155c8d57bc94ea6 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 05:04:19 +0000
Subject: [PATCH 24/40] Refresh FACTS.md for D-145

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/FACTS.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/FACTS.md b/docs/FACTS.md
index f503bc0c0..2c1a84836 100644
--- a/docs/FACTS.md
+++ b/docs/FACTS.md
@@ -13,8 +13,8 @@ green. Quote a fact instead of restating it, and it updates itself when the sour
 | `migration-count`   | 17                                          | Numbered database migrations                                                          | `backend/ward-flow/migrations/`                                    |
 | `ward-route-count`  | 60                                          | `page.tsx` routes under `/ward-flow`                                                  | `src/app/ward-flow/`                                               |
 | `app-route-count`   | 64                                          | Pages and route handlers: the Ward Flow routes plus sign-in and the `/mockups` digest | `src/app/ward-flow/, src/app/ward-flow-sign-in/, src/app/mockups/` |
-| `latest-decision`   | D-143                                       | Newest entry in the decision log                                                      | `docs/ward-flow/decisions.md`                                      |
-| `next-decision`     | D-144                                       | Number to use for the next decision                                                   | `docs/ward-flow/decisions.md`                                      |
+| `latest-decision`   | D-145                                       | Newest entry in the decision log                                                      | `docs/ward-flow/decisions.md`                                      |
+| `next-decision`     | D-146                                       | Number to use for the next decision                                                   | `docs/ward-flow/decisions.md`                                      |
 | `node-engine`       | >=24.22.1 <25                               | Supported Node.js range                                                               | `package.json`                                                     |
 | `backend-env-vars`  | 33 names, [listed below](#backend-env-vars) | Environment variables the shared backend reads                                        | `backend/ward-flow/*.mjs`                                          |
 

From 35db789ab4bc9210a256ff35000e663ac8140c7d Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 05:12:09 +0000
Subject: [PATCH 25/40] Refresh the owner rulings index for D-145

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/OWNER-RULINGS.md | 548 ++++++++++++++++----------------
 1 file changed, 275 insertions(+), 273 deletions(-)

diff --git a/docs/ward-flow/OWNER-RULINGS.md b/docs/ward-flow/OWNER-RULINGS.md
index 0a06b83b0..bb5a02942 100644
--- a/docs/ward-flow/OWNER-RULINGS.md
+++ b/docs/ward-flow/OWNER-RULINGS.md
@@ -9,7 +9,7 @@ Scanned `docs/ward-flow/decisions.md`, `docs/ward-flow/owner-*.md` and `docs/his
 One file matches `*owner*` but not `owner-*` and is deliberately excluded: `how-to-write-to-the-owner.md`
 — it is instructions for writing TO the owner, not a record of what he ruled.
 
-**696 rulings/items extracted, across 43 of 44 files.**
+**697 rulings/items extracted, across 43 of 44 files.**
 **0 file(s) UNPARSED** — no recognised ruling structure found; listed, not dropped. See below.
 **1 file(s) recorded as holding no ruling of their own**, each with its reason. See below.
 
@@ -32,7 +32,7 @@ line, in the order discovered — confirm which instance you mean before citing
 
 ---
 
-## ID index — 446 distinct IDs
+## ID index — 447 distinct IDs
 
 So an ID like `D-9` or `O-17.1` can be looked up directly, without knowing which file it lives in.
 Bare numbered rulings (files that number "1., 2., 3. …" with no owner-issued letter code) are
@@ -72,239 +72,240 @@ safe global key across 30 files.
 | `D-1` ⚠️ **3 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-four-answers.md`:16 | D-1 · Legal forms: split the list in two |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:85 | D-1 — 🔴 The screen is called **Patient**, not "Patient Now" |
-| ↳ | `decisions.md`:163 | D-1. Ward Flow is local only, with no linked repository (Replaced by D-27) |
+| ↳ | `decisions.md`:164 | D-1. Ward Flow is local only, with no linked repository (Replaced by D-27) |
 | `D-2` ⚠️ **3 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-four-answers.md`:57 | D-2 · Raise the three unbindable table thresholds |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:108 | D-2 — 🔴 Communication: BUILD IT. The system must be able to tell someone something. |
-| ↳ | `decisions.md`:173 | D-2. Railway is disconnected |
+| ↳ | `decisions.md`:174 | D-2. Railway is disconnected |
 | `D-3` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:215 | D-3 — 🔴 The 12px floor is ADOPTED. Screen by screen, not as a sweep. |
-| ↳ | `decisions.md`:184 | D-3. The PsychSift and Database code is being retired from Ward Flow |
+| ↳ | `decisions.md`:185 | D-3. The PsychSift and Database code is being retired from Ward Flow |
 | `D-3b` | `../history/archive/dated-notes/owner-decisions-2026-09-12-four-answers.md`:77 | D-3b · The data-conditional absence sweep is DEFERRED |
 | `D-4` ⚠️ **4 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-four-answers.md`:97 | D-4 · The deliberate sub-12px exception stands if its reasoning is sound |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:263 | D-4 · WARD LEAD RULING, not the owner's — the Access record's false assurance |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:390 | D-4 ADDENDUM, 2026-09-11 — 🔴 the OTHER half of that sentence, found by Lane C after the fix |
-| ↳ | `decisions.md`:192 | D-4. Synthetic patients only |
+| ↳ | `decisions.md`:193 | D-4. Synthetic patients only |
 | `D-5` ⚠️ **4 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-routing-and-nine-flags.md`:15 | D-5 · 🔴 A NEW STANDING RULE: PROTECTED-WORK DELETIONS COME TO WARD VERIFIER FIRST |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:340 | D-5 · WARD LEAD RULING, not the owner's — gender reaches BOTH bed gates or neither |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:431 | D-5 MEASUREMENT, 2026-09-11 — the wiring task handed back, and the arithmetic is starker than I expected |
-| ↳ | `decisions.md`:200 | D-5. Parallel threads in separate worktrees, folded one at a time |
+| ↳ | `decisions.md`:201 | D-5. Parallel threads in separate worktrees, folded one at a time |
 | `D-6` ⚠️ **3 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-routing-and-nine-flags.md`:52 | D-6 · 🟢 THE `--t-0` COLLISION — amend the brief in the same change |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:472 | D-6 · WARD LEAD RULING — "Not recorded" and "Not yet recorded" are BOTH used, deliberately |
-| ↳ | `decisions.md`:211 | D-6. Aboriginal cultural safety review deferred |
+| ↳ | `decisions.md`:212 | D-6. Aboriginal cultural safety review deferred |
 | `D-7` ⚠️ **3 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-routing-and-nine-flags.md`:72 | D-7 · 🟢 THE REMAINING SEVEN ARE FLAGGED TO WARD LEAD |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:499 | D-7 · WARD LEAD RULING — the Patient screen SHOWS gender, and the addition is logged as an addition |
-| ↳ | `decisions.md`:219 | D-7. The first four milestones, in this order |
+| ↳ | `decisions.md`:220 | D-7. The first four milestones, in this order |
 | `D-8` ⚠️ **3 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-fold-and-authorisation.md`:9 | D-8 · 🔴 "FOLD INTO MAIN" ALWAYS MEANS THE LOCAL WARD FLOW LINE |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:545 | D-8 · WARD LEAD RULING — the announced marker says "invented NAMES", never "invented people" |
-| ↳ | `decisions.md`:231 | D-8. Josh's standing rulings, numbered R1 to R16, for every session and tool |
+| ↳ | `decisions.md`:232 | D-8. Josh's standing rulings, numbered R1 to R16, for every session and tool |
 | `D-9` ⚠️ **3 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-fold-and-authorisation.md`:51 | D-9 · 🟢 THE MENTAL HEALTH ACT AUTHORISATION GATE IS OVERRIDABLE — with the owner's clinical reason |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:589 | D-9 · WARD LEAD RULING — the referral board's table MAY scroll sideways; the missing thing is the affordance |
-| ↳ | `decisions.md`:263 | D-9. Josh's rulings of 25 September, 11:43 to 12:00 (R17 to R21) |
+| ↳ | `decisions.md`:264 | D-9. Josh's rulings of 25 September, 11:43 to 12:00 (R17 to R21) |
 | `D-10` ⚠️ **3 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-fold-and-authorisation.md`:91 | D-10 · ⏸️ THE SMALL-TEXT RAISE IS DEFERRED — with the triggers written down, because a deferral without one is a drop |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:618 | D-10 · WARD LEAD RULING — the overflow affordance is a SENTENCE first and a measured border second, not the standard's shade |
-| ↳ | `decisions.md`:277 | D-10. Gate build type check (R22) |
+| ↳ | `decisions.md`:278 | D-10. Gate build type check (R22) |
 | `D-11` ⚠️ **3 occurrences in 3 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-12-fold-and-authorisation.md`:129 | D-11 · 🔴 TWO LEDGERS IS CORRECT AND INTENDED — WARD FLOW TASKS GO ON THE WARD FLOW LEDGER, AND THE MAIN PROJECT'S IS DISREGARDED FOR THIS PROJECT |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:685 | D-11 · A-1 — the half-written referral history WARNS, and is never stored |
-| ↳ | `decisions.md`:286 | D-11. Rulings of 25 September, 12:41 (R23 to R25) |
+| ↳ | `decisions.md`:287 | D-11. Rulings of 25 September, 12:41 (R23 to R25) |
 | `D-12` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:704 | D-12 · A-2 — the referrer is the RECORDED SOURCE, and a person only if the record carries one |
-| ↳ | `decisions.md`:302 | D-12. Rulings of 25 September, 12:43 (R26 to R31) |
+| ↳ | `decisions.md`:303 | D-12. Rulings of 25 September, 12:43 (R26 to R31) |
 | `D-13` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:720 | D-13 · A-3 and A-4 — both resolve FOR THE CODE; the drawings change |
-| ↳ | `decisions.md`:321 | D-13. Tooling tests in batch gates (R32) |
+| ↳ | `decisions.md`:322 | D-13. Tooling tests in batch gates (R32) |
 | `D-14` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:739 | D-14 · A-6 and A-8 — ADD THE LINK, AND MAKE THE GUARD ENFORCE IN THE SAME CHANGE. Never one without the other. |
-| ↳ | `decisions.md`:331 | D-14. Standing defaults: decide small things without asking |
+| ↳ | `decisions.md`:332 | D-14. Standing defaults: decide small things without asking |
 | `D-15` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:778 | D-15 · A-7 — the figure NAMES ITS OWN CLOCK, or it does not ship |
-| ↳ | `decisions.md`:343 | D-15. Rulings of 25 September, 13:26 (R33 to R35) |
+| ↳ | `decisions.md`:344 | D-15. Rulings of 25 September, 13:26 (R33 to R35) |
 | `D-16` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:799 | D-16 · WARD LEAD RULING — the unwired primary actions use §8.6's EXISTING sentence; nothing new is invented |
-| ↳ | `decisions.md`:356 | D-16. Legal overrides and form receipts, 25 September 13:51 UTC |
+| ↳ | `decisions.md`:357 | D-16. Legal overrides and form receipts, 25 September 13:51 UTC |
 | `D-17` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:843 | D-17 · WARD LEAD RULING — A-8: FD-23 wins. The Patient screen never shows where else a patient has been. |
-| ↳ | `decisions.md`:369 | D-17. Morning roll-up time is Josh's own default (25 September) |
+| ↳ | `decisions.md`:370 | D-17. Morning roll-up time is Josh's own default (25 September) |
 | `D-18` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:878 | D-18 · WARD LEAD RULING — the referral query contract carries MODEL values; and `gp` is a question for the owner, not a mapping for me |
-| ↳ | `decisions.md`:380 | D-18. The privacy lock stops saving only for typed text (25 September) |
+| ↳ | `decisions.md`:381 | D-18. The privacy lock stops saving only for typed text (25 September) |
 | `D-19` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:922 | D-19 · WARD LEAD RULING — "something is already open for this person" is PERMITTED; "where" never is |
-| ↳ | `decisions.md`:391 | D-19. Rulings of 25 September, evening (walkthrough, leave beds, PsychSift, gender display) |
+| ↳ | `decisions.md`:392 | D-19. Rulings of 25 September, evening (walkthrough, leave beds, PsychSift, gender display) |
 | `D-20` ⚠️ **3 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:967 | D-20 · WARD LEAD RULING — the drawing wins; the vocabulary anchor was never the heading |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1010 | D-20-REVISED · the drawing renames BOTH, so neither side is taken whole |
-| ↳ | `decisions.md`:421 | D-20. One high-contrast colour check retired (26 September) |
+| ↳ | `decisions.md`:422 | D-20. One high-contrast colour check retired (26 September) |
 | `D-21` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1058 | D-21 · WARD LEAD RULING — tasks 10 and 12 are CLOSED, not deferred, and not built as callerless modules |
-| ↳ | `decisions.md`:434 | D-21. Coordinator bed board: all nine recommended answers (26 September) |
+| ↳ | `decisions.md`:435 | D-21. Coordinator bed board: all nine recommended answers (26 September) |
 | `D-22` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1084 | D-22 · SHAPE 2 — the landmark label and the heading stop being two strings |
-| ↳ | `decisions.md`:446 | D-22. No legal limits in hour rules; the rest are labelled defaults (26 September) |
+| ↳ | `decisions.md`:447 | D-22. No legal limits in hour rules; the rest are labelled defaults (26 September) |
 | `D-23` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1121 | D-23 · The bed board passes an empty leave-bed list into three capacity figures, and says nothing |
-| ↳ | `decisions.md`:462 | D-23. Leave-bed fields kept; patient search stops matching by ward (26 September) |
+| ↳ | `decisions.md`:463 | D-23. Leave-bed fields kept; patient search stops matching by ward (26 September) |
 | `D-24` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1142 | D-24 · The raw `1.2` line-height — token it, and accept that community no longer matches |
-| ↳ | `decisions.md`:476 | D-24. Hour-rules morning list: all A (26 September) |
+| ↳ | `decisions.md`:477 | D-24. Hour-rules morning list: all A (26 September) |
 | `D-25` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1161 | D-25 · Command's `deadlineLine` sentence is not built — and this DEFERS the R-5 question rather than answering it |
-| ↳ | `decisions.md`:500 | D-25. The lone-patient check counts free beds on both matching paths (26 September) |
+| ↳ | `decisions.md`:501 | D-25. The lone-patient check counts free beds on both matching paths (26 September) |
 | `D-26` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1184 | D-26 · `edPressure` becomes a projection of `edHomeSummaries` — the two screens stop being able to disagree |
-| ↳ | `decisions.md`:508 | D-26. Select fold checks by changed risk (27 September) |
+| ↳ | `decisions.md`:509 | D-26. Select fold checks by changed risk (27 September) |
 | `D-27` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1213 | D-27 · The word for a free bed is READY — and the ruling is about the WORD, not the identifier |
-| ↳ | `decisions.md`:526 | D-27. Ward Flow uses its dedicated repository (28 September) |
-| `D-28` | `decisions.md`:539 | D-28. Design Modernization & Anti-Box Architecture (30 September 2026) |
-| `D-29` | `decisions.md`:553 | D-29. Act time limits shown as a labelled synthetic demo (4 October 2026) |
+| ↳ | `decisions.md`:527 | D-27. Ward Flow uses its dedicated repository (28 September) |
+| `D-28` | `decisions.md`:540 | D-28. Design Modernization & Anti-Box Architecture (30 September 2026) |
+| `D-29` | `decisions.md`:554 | D-29. Act time limits shown as a labelled synthetic demo (4 October 2026) |
 | `D-30` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1238 | D-30 · `Unit.forensic` is a WARD flag, and every rendered string says so |
-| ↳ | `decisions.md`:568 | D-30. Central Coordinator Approval for Inter-Ward Bed Transfers (6 October 2026) |
+| ↳ | `decisions.md`:569 | D-30. Central Coordinator Approval for Inter-Ward Bed Transfers (6 October 2026) |
 | `D-31` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1367 | D-31 · The plan's disposition — delete one half, re-derive the other |
-| ↳ | `decisions.md`:575 | D-31. Gender-Diverse Bed Placement Policy & Clinical Override Safety (6 October 2026) |
+| ↳ | `decisions.md`:576 | D-31. Gender-Diverse Bed Placement Policy & Clinical Override Safety (6 October 2026) |
 | `D-32` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1289 | D-32 · D-6 is restated: ONE WORDING PER STATE, and the states are named |
-| ↳ | `decisions.md`:582 | D-32. FIFO Waiting Time with Clinical Triage Badging vs Algorithmic Urgency Sorting (6 October 2026) |
+| ↳ | `decisions.md`:583 | D-32. FIFO Waiting Time with Clinical Triage Badging vs Algorithmic Urgency Sorting (6 October 2026) |
 | `D-33` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1322 | D-33 · "Nothing outstanding" does three jobs, and only one of them may keep the words |
-| ↳ | `decisions.md`:589 | D-33. Separation of Local Ward Shift Notes from Statewide Coordinator Telemetry (6 October 2026) |
+| ↳ | `decisions.md`:590 | D-33. Separation of Local Ward Shift Notes from Statewide Coordinator Telemetry (6 October 2026) |
 | `D-34` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1347 | D-34 · A hypothetical destination row may not use obligation vocabulary at all |
-| ↳ | `decisions.md`:596 | D-34. Acute Medical Deterioration Bed Release and Escalation Protocol (6 October 2026) |
+| ↳ | `decisions.md`:597 | D-34. Acute Medical Deterioration Bed Release and Escalation Protocol (6 October 2026) |
 | `D-35` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1388 | D-35 · The ED pressure strip does not narrow to the selected service, and #6 is CLOSED |
-| ↳ | `decisions.md`:603 | D-35. Deferral of Regional Multi-Leg Transport & RFDS Repatriation (6 October 2026) |
+| ↳ | `decisions.md`:604 | D-35. Deferral of Regional Multi-Leg Transport & RFDS Repatriation (6 October 2026) |
 | `D-36` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1405 | D-36 · _Referrals into this ward_ / _into the team_ — PRESENTATION, with a condition |
-| ↳ | `decisions.md`:610 | D-36. Affirmation of External Governance & Clinical Safety Hard Gates (6 October 2026) (Replaced by D-87) |
+| ↳ | `decisions.md`:611 | D-36. Affirmation of External Governance & Clinical Safety Hard Gates (6 October 2026) (Replaced by D-87) |
 | `D-37` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1411 | D-37 · _Clinically ready, not yet gone_ — PRESENTATION, and the heading must name its subject |
-| ↳ | `decisions.md`:625 | D-37. External Governance Hard Gate Operational Postures & Resolution Roadmap (6 October 2026) (Replaced by D-87) |
+| ↳ | `decisions.md`:626 | D-37. External Governance Hard Gate Operational Postures & Resolution Roadmap (6 October 2026) (Replaced by D-87) |
 | `D-38` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1417 | D-38 · _People currently in a hospital bed_ on community team statistics — an aggregate that identifies at small N |
-| ↳ | `decisions.md`:652 | D-38. Leave, absent without leave and CTO on the Patient page (9 October 2026) |
+| ↳ | `decisions.md`:653 | D-38. Leave, absent without leave and CTO on the Patient page (9 October 2026) |
 | `D-39` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1437 | D-39 · _Contacts_ and _Time to first contact_ — HELD, build neither |
-| ↳ | `decisions.md`:670 | D-39. Patients are identified by UMRN, never by a WF number (9 October 2026) |
+| ↳ | `decisions.md`:671 | D-39. Patients are identified by UMRN, never by a WF number (9 October 2026) |
 | `D-40` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1445 | D-40 · An empty check array never claims reconciliation — on either shell surface |
-| ↳ | `decisions.md`:714 | D-40. A second community treatment order keeps the first (9 October 2026) |
+| ↳ | `decisions.md`:715 | D-40. A second community treatment order keeps the first (9 October 2026) |
 | `D-41` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1478 | D-41 · `corridorCounts` is extended, and its POPULATION changes |
-| ↳ | `decisions.md`:725 | D-41. Delays board filters narrow the table and state the hidden count (9 October 2026) |
+| ↳ | `decisions.md`:726 | D-41. Delays board filters narrow the table and state the hidden count (9 October 2026) |
 | `D-42` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1490 | D-42 · _Referrals into this ward_ renders bare counts. No share. |
-| ↳ | `decisions.md`:738 | D-42. 12px typography floor with no uppercase exception reaffirmed in Design System v9 (9–10 October 2026) |
+| ↳ | `decisions.md`:739 | D-42. 12px typography floor with no uppercase exception reaffirmed in Design System v9 (9–10 October 2026) |
 | `D-43` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1724 | D-43 · Ward Lead ruling — the bed board's ordinal contradiction is a LANE TASK |
-| ↳ | `decisions.md`:744 | D-43. Colour lives in glyphs and the hero; red means act now with a thin 1px edge, never a fill (9 October 2026) |
+| ↳ | `decisions.md`:745 | D-43. Colour lives in glyphs and the hero; red means act now with a thin 1px edge, never a fill (9 October 2026) |
 | `D-44` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1791 | D-44 · The community scope note is reworded and the comparison panel stays |
-| ↳ | `decisions.md`:751 | D-44. Compact sizing, white cards and smaller text retained over expression-test card tints (9 October 2026) |
+| ↳ | `decisions.md`:752 | D-44. Compact sizing, white cards and smaller text retained over expression-test card tints (9 October 2026) |
 | `D-45` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1803 | D-45 · 🔴 THE SEED DECISION — the fixture gains BOTH, as ONE change, after the statistics screens |
-| ↳ | `decisions.md`:757 | D-45. Phone is its own 390×844 design, never a desktop reflow (9 October 2026) |
+| ↳ | `decisions.md`:758 | D-45. Phone is its own 390×844 design, never a desktop reflow (9 October 2026) |
 | `D-46` ⚠️ **2 occurrences in 2 files — not unique** | | |
 | ↳ | `../history/archive/dated-notes/owner-decisions-2026-09-1x.md`:1984 | D-46 · A guard that fails whenever the machine is busy |
-| ↳ | `decisions.md`:764 | D-46. Every page has a focal part, a part of its own, a page-specific hero and command-bar action rules (9 October 2026) |
-| `D-47` | `decisions.md`:770 | D-47. Glass stays about 80% opaque with the top sheen kept (10 October 2026) |
-| `D-48` | `decisions.md`:776 | D-48. Figures stay in Geist Mono with tabular digits while chart axes use Geist Sans (10 October 2026) |
-| `D-49` | `decisions.md`:782 | D-49. Ward Flow 44px default row target (dense 36px, touch 52px) vs retired 48px PsychSift tap knob (10 October 2026) |
-| `D-50` | `decisions.md`:788 | D-50. Neutral T1 urgency pill vs Form 1A amber statutory warning badge (10 October 2026) |
-| `D-51` | `decisions.md`:794 | D-51. Delays filters hide rows with a stated hidden count while other queues highlight by default (10 October 2026) |
-| `D-52` | `decisions.md`:801 | D-52. 10 October page review rulings: time-axis overdue zone, 15px/20px strip figures, 8px people pips and incremental shared parts (10 October 2026) |
-| `D-53` | `decisions.md`:807 | D-53. Elevate design language and Glare mode adopted for Design System v9 (10 October 2026) |
-| `D-54` | `decisions.md`:814 | D-54. Tier time thresholds remain synthetic demo values requiring clinical sign-off (10 October 2026) |
-| `D-55` | `decisions.md`:822 | D-55. Supabase is Ward Flow's database and sign-in provider, and Azure is retired (15 October 2026) |
-| `D-56` | `decisions.md`:828 | D-56. Josh signs the clinical values that have a recorded source, for the prototype (15 October 2026) |
-| `D-57` | `decisions.md`:834 | D-57. Twenty Top 25 items move from the showcase into the real screens, each behind its own flag (15 October 2026) |
-| `D-58` | `decisions.md`:861 | D-58. Josh signs three more clinical values that have a national source, for the prototype (15 October 2026) |
-| `D-59` | `decisions.md`:867 | D-59. Each role sees only what it needs, from one access table (15 October 2026) |
-| `D-60` | `decisions.md`:873 | D-60. Criteria led discharge, for voluntary patients only (15 October 2026) |
-| `D-61` | `decisions.md`:882 | D-61. Tasks and Alerts are one queue called Alerts (16 October 2026) |
-| `D-62` | `decisions.md`:888 | D-62. The one Alerts queue is signed off and its flag removed (16 October 2026) |
-| `D-63` | `decisions.md`:894 | D-63. Josh signs the remaining clinical values and the criteria list, for the prototype (16 October 2026) |
-| `D-64` | `decisions.md`:902 | D-64. Criteria led discharge shows on the boards and warns at departure (16 October 2026) |
-| `D-65` | `decisions.md`:909 | D-65. Criteria led discharge on in production, typed patient specific criteria, and the AWOL bed hold review paused (17 October 2026) |
-| `D-66` | `decisions.md`:925 | D-66. Granted roles work without a second approval (17 October 2026) |
-| `D-67` | `decisions.md`:933 | D-67. Recover synthetic form drafts within the browser session (17 October 2026) |
-| `D-68` | `decisions.md`:940 | D-68. Bed meeting TV content and access (19 October 2026) |
-| `D-69` | `decisions.md`:948 | D-69. A referral with no legal status: "Needs an involuntary-capable bed until status is set." (20 October 2026) |
-| `D-70` | `decisions.md`:955 | D-70. No computed Mental Health Act periods: show only the recorded due time (20 October 2026) |
-| `D-71` | `decisions.md`:961 | D-71. Audit 1 clinical safety fixes: no suggested wards, wait-order queues, recorded facts only (20 October 2026) |
-| `D-72` | `decisions.md`:974 | D-72. Seven product decisions for the 21 October fix plan (21 October 2026) |
-| `D-73` | `decisions.md`:990 | D-73. Batch merge safeguards (21 October 2026) |
-| `D-74` | `decisions.md`:1006 | D-74. Owner answers to the 21 October open questions (21 October 2026) |
-| `D-75` | `decisions.md`:1027 | D-75. UX audit follow-up, page caching, community gaps and the extra-travel bed hold (21 October 2026) |
-| `D-76` | `decisions.md`:1040 | D-76. Community referral gaps: the full move journey and asking more wards (21 October 2026) |
-| `D-77` | `decisions.md`:1049 | D-77. The ten bigger UX changes approved for build (22 October 2026) |
-| `D-78` | `decisions.md`:1069 | D-78. One decline list for wards and coordinators (22 October 2026) |
-| `D-79` | `decisions.md`:1080 | D-79. Wards see the full referral, with name and UMRN, before they answer (23 October 2026) |
-| `D-80` | `decisions.md`:1091 | D-80. Role access plan version 2: all 17 recommendations (23 October 2026) |
-| `D-81` | `decisions.md`:1106 | D-81. Pulled, with a pull time limit, for a bed kept for an incoming patient (24 October 2026) |
-| `D-82` | `decisions.md`:1113 | D-82. A PR may raise a phone size limit by up to 5 KB per screen without asking (26 October 2026) |
-| `D-83` | `decisions.md`:1121 | D-83. Patient names stay in full on every screen, copy and TV; privacy work must not make the app less useful (26 October 2026) |
-| `D-84` | `decisions.md`:1132 | D-84. The live app stays on Railway Singapore for now, and there is no server-side TV account yet (26 October 2026) |
-| `D-85` | `decisions.md`:1140 | D-85. "Held" only for a bed kept for its own patient; "pulled" for an incoming bed; "held up" for a delay (26 October 2026) |
-| `D-86` | `decisions.md`:1147 | D-86. No second approver for role grants, at pilot or otherwise (27 October 2026) |
-| `D-87` | `decisions.md`:1154 | D-87. D-36 and D-37 are replaced by the real-data gate (27 October 2026) |
-| `D-88` | `decisions.md`:1166 | D-88. The public demo opens with a demo code once the front door is on (27 October 2026) |
-| `D-89` | `decisions.md`:1173 | D-89. Redesign mock-up copies of large screens may pass the 1,500-line cap (30 October 2026) |
-| `D-90` | `decisions.md`:1181 | D-90. Help gets How do I…, Show me runs everywhere, and Help is built without a separate mock-up step (30 October 2026) |
-| `D-91` | `decisions.md`:1192 | D-91. One design home for the redesign, and Josh's answers on Help, Settings, search and notifications (31 October 2026) |
-| `D-92` | `decisions.md`:1227 | D-92. Help goes live before its mock-up review, one search box on Capacity, and referral rows on Home open the panel (31 October 2026) |
-| `D-93` | `decisions.md`:1237 | D-93. Legal form times show only as typed, never as a countdown (31 October 2026) |
-| `D-94` | `decisions.md`:1245 | D-94. Design rulings of 31 October 2026 |
-| `D-95` | `decisions.md`:1258 | D-95. One page scroll, and a click outside closes a drawer (3 November 2026) |
-| `D-96` | `decisions.md`:1268 | D-96. A named bed is pulled, and its patient is not also waiting (8 November 2026) |
-| `D-97` | `decisions.md`:1278 | D-97. Owner answers on seven open items: N21, N25, N26, N29, N40, N41 and WF-B008 (8 November 2026) |
-| `D-98` | `decisions.md`:1291 | D-98. Friction pass: Quick bar, Patient peek and Ward peek (8 November 2026) |
-| `D-99` | `decisions.md`:1300 | D-99. "Real details" in the referral drawer's sample patients (25 September 2026) |
-| `D-100` | `decisions.md`:1306 | D-100. "Under a form" means one rule everywhere (9 November 2026) |
-| `D-101` | `decisions.md`:1313 | D-101. Clinically ready for discharge, with one delay reason (9 November 2026) |
-| `D-102` | `decisions.md`:1322 | D-102. Report-a-problem screenshots are blurred, and patient-table exports carry no names (9 November 2026) |
-| `D-103` | `decisions.md`:1331 | D-103. Any coordinator on shift may mark a bed override reviewed (9 November 2026) |
-| `D-104` | `decisions.md`:1338 | D-104. Care plans and safety flags: five defaults (9 November 2026) |
-| `D-105` | `decisions.md`:1350 | D-105. Optional clerk details on the patient record (8 November 2026) |
-| `D-106` | `decisions.md`:1357 | D-106. Clinical values from the 9 November 2026 documentation audit (9 November 2026) |
-| `D-107` | `decisions.md`:1369 | D-107. Working rules and documentation from the 9 November 2026 audit (9 November 2026) |
-| `D-108` | `decisions.md`:1383 | D-108. Six bed-flow features: keep D-93 and D-72, ED long-wait next steps (9 November 2026) |
-| `D-109` | `decisions.md`:1392 | D-109. Home's bed alert line tests the whole number shown (9 November 2026) |
-| `D-110` | `decisions.md`:1399 | D-110. ED and referral flow: neutral fit line, clearance timing and alternatives to admission (9 November 2026) |
-| `D-111` | `decisions.md`:1409 | D-111. Review and audit plan: first guards and four open answers (9 November 2026) |
-| `D-112` | `decisions.md`:1423 | D-112. Phone bottom bar: the floating bar (9 November 2026) |
-| `D-113` | `decisions.md`:1432 | D-113. Second patient identifier on accept and Mark done; no initials search (9 November 2026) |
-| `D-114` | `decisions.md`:1442 | D-114. Allow pull_request_target for three workflows only (9 November 2026) |
-| `D-115` | `decisions.md`:1450 | D-115. One count on every screen, and a missing patient shown everywhere (9 November 2026) |
-| `D-116` | `decisions.md`:1464 | D-116. Page tops: the PR #1581 recommendations stand (9 November 2026) |
-| `D-117` | `decisions.md`:1481 | D-117. Care plans follow-up: frequent presenter count, tribunal date and ward flags (10 November 2026) |
-| `D-118` | `decisions.md`:1490 | D-118. Page tops: Referrals and Ward phone limits up to 8 KB above main (10 November 2026) |
-| `D-119` | `decisions.md`:1496 | D-119. Page tops: phone limits raised to measured sizes, trim after merge (10 November 2026) |
-| `D-120` | `decisions.md`:1503 | D-120. Discharge and capacity values: pull limit, transport delay and discharge date slip (9 November 2026) |
-| `D-121` | `decisions.md`:1512 | D-121. Working rules, guards and your PC from the 10 November 2026 audit (10 November 2026) |
-| `D-122` | `decisions.md`:1526 | D-122. Clinical and privacy answers from the 10 November 2026 audit (10 November 2026) |
-| `D-123` | `decisions.md`:1539 | D-123. Master audit list answers: two clinical fixes and five working rules (10 November 2026) |
-| `D-124` | `decisions.md`:1553 | D-124. Offline saves whose record changed are refused and shown (10 November 2026) |
-| `D-125` | `decisions.md`:1560 | D-125. Top 10 audit follow-ups approved (10 November 2026) |
-| `D-126` | `decisions.md`:1572 | D-126. Ranked lists: neutral orders approved (10 November 2026) |
-| `D-127` | `decisions.md`:1591 | D-127. Neutral wording for a community treatment order at arrival (10 November 2026) |
-| `D-128` | `decisions.md`:1598 | D-128. Final master audit: nine answers (10 November 2026) |
-| `D-129` | `decisions.md`:1613 | D-129. Master audit findings: every recommendation approved (10 November 2026) |
-| `D-130` | `decisions.md`:1663 | D-130. Audit follow-ups: every remaining recommendation approved (10 November 2026) |
-| `D-131` | `decisions.md`:1679 | D-131. Hard-case demo data allowed, and the movement diagram follows the engine (10 November 2026) |
-| `D-132` | `decisions.md`:1688 | D-132. Audit fixes group 1: docs and CI guards (10 November 2026) |
-| `D-138` | `decisions.md`:1698 | D-138. Phone alert urgency by kind (10 November 2026) |
-| `D-143` | `decisions.md`:1704 | D-143. MHERT is MHERL in the glossary; SMHMR deferred (11 November 2026) |
+| ↳ | `decisions.md`:765 | D-46. Every page has a focal part, a part of its own, a page-specific hero and command-bar action rules (9 October 2026) |
+| `D-47` | `decisions.md`:771 | D-47. Glass stays about 80% opaque with the top sheen kept (10 October 2026) |
+| `D-48` | `decisions.md`:777 | D-48. Figures stay in Geist Mono with tabular digits while chart axes use Geist Sans (10 October 2026) |
+| `D-49` | `decisions.md`:783 | D-49. Ward Flow 44px default row target (dense 36px, touch 52px) vs retired 48px PsychSift tap knob (10 October 2026) |
+| `D-50` | `decisions.md`:789 | D-50. Neutral T1 urgency pill vs Form 1A amber statutory warning badge (10 October 2026) |
+| `D-51` | `decisions.md`:795 | D-51. Delays filters hide rows with a stated hidden count while other queues highlight by default (10 October 2026) |
+| `D-52` | `decisions.md`:802 | D-52. 10 October page review rulings: time-axis overdue zone, 15px/20px strip figures, 8px people pips and incremental shared parts (10 October 2026) |
+| `D-53` | `decisions.md`:808 | D-53. Elevate design language and Glare mode adopted for Design System v9 (10 October 2026) |
+| `D-54` | `decisions.md`:815 | D-54. Tier time thresholds remain synthetic demo values requiring clinical sign-off (10 October 2026) |
+| `D-55` | `decisions.md`:823 | D-55. Supabase is Ward Flow's database and sign-in provider, and Azure is retired (15 October 2026) |
+| `D-56` | `decisions.md`:829 | D-56. Josh signs the clinical values that have a recorded source, for the prototype (15 October 2026) |
+| `D-57` | `decisions.md`:835 | D-57. Twenty Top 25 items move from the showcase into the real screens, each behind its own flag (15 October 2026) |
+| `D-58` | `decisions.md`:862 | D-58. Josh signs three more clinical values that have a national source, for the prototype (15 October 2026) |
+| `D-59` | `decisions.md`:868 | D-59. Each role sees only what it needs, from one access table (15 October 2026) |
+| `D-60` | `decisions.md`:874 | D-60. Criteria led discharge, for voluntary patients only (15 October 2026) |
+| `D-61` | `decisions.md`:883 | D-61. Tasks and Alerts are one queue called Alerts (16 October 2026) |
+| `D-62` | `decisions.md`:889 | D-62. The one Alerts queue is signed off and its flag removed (16 October 2026) |
+| `D-63` | `decisions.md`:895 | D-63. Josh signs the remaining clinical values and the criteria list, for the prototype (16 October 2026) |
+| `D-64` | `decisions.md`:903 | D-64. Criteria led discharge shows on the boards and warns at departure (16 October 2026) |
+| `D-65` | `decisions.md`:910 | D-65. Criteria led discharge on in production, typed patient specific criteria, and the AWOL bed hold review paused (17 October 2026) |
+| `D-66` | `decisions.md`:926 | D-66. Granted roles work without a second approval (17 October 2026) |
+| `D-67` | `decisions.md`:934 | D-67. Recover synthetic form drafts within the browser session (17 October 2026) |
+| `D-68` | `decisions.md`:941 | D-68. Bed meeting TV content and access (19 October 2026) |
+| `D-69` | `decisions.md`:949 | D-69. A referral with no legal status: "Needs an involuntary-capable bed until status is set." (20 October 2026) |
+| `D-70` | `decisions.md`:956 | D-70. No computed Mental Health Act periods: show only the recorded due time (20 October 2026) |
+| `D-71` | `decisions.md`:962 | D-71. Audit 1 clinical safety fixes: no suggested wards, wait-order queues, recorded facts only (20 October 2026) |
+| `D-72` | `decisions.md`:975 | D-72. Seven product decisions for the 21 October fix plan (21 October 2026) |
+| `D-73` | `decisions.md`:991 | D-73. Batch merge safeguards (21 October 2026) |
+| `D-74` | `decisions.md`:1007 | D-74. Owner answers to the 21 October open questions (21 October 2026) |
+| `D-75` | `decisions.md`:1028 | D-75. UX audit follow-up, page caching, community gaps and the extra-travel bed hold (21 October 2026) |
+| `D-76` | `decisions.md`:1041 | D-76. Community referral gaps: the full move journey and asking more wards (21 October 2026) |
+| `D-77` | `decisions.md`:1050 | D-77. The ten bigger UX changes approved for build (22 October 2026) |
+| `D-78` | `decisions.md`:1070 | D-78. One decline list for wards and coordinators (22 October 2026) |
+| `D-79` | `decisions.md`:1081 | D-79. Wards see the full referral, with name and UMRN, before they answer (23 October 2026) |
+| `D-80` | `decisions.md`:1092 | D-80. Role access plan version 2: all 17 recommendations (23 October 2026) |
+| `D-81` | `decisions.md`:1107 | D-81. Pulled, with a pull time limit, for a bed kept for an incoming patient (24 October 2026) |
+| `D-82` | `decisions.md`:1114 | D-82. A PR may raise a phone size limit by up to 5 KB per screen without asking (26 October 2026) |
+| `D-83` | `decisions.md`:1122 | D-83. Patient names stay in full on every screen, copy and TV; privacy work must not make the app less useful (26 October 2026) |
+| `D-84` | `decisions.md`:1133 | D-84. The live app stays on Railway Singapore for now, and there is no server-side TV account yet (26 October 2026) |
+| `D-85` | `decisions.md`:1141 | D-85. "Held" only for a bed kept for its own patient; "pulled" for an incoming bed; "held up" for a delay (26 October 2026) |
+| `D-86` | `decisions.md`:1148 | D-86. No second approver for role grants, at pilot or otherwise (27 October 2026) |
+| `D-87` | `decisions.md`:1155 | D-87. D-36 and D-37 are replaced by the real-data gate (27 October 2026) |
+| `D-88` | `decisions.md`:1167 | D-88. The public demo opens with a demo code once the front door is on (27 October 2026) |
+| `D-89` | `decisions.md`:1174 | D-89. Redesign mock-up copies of large screens may pass the 1,500-line cap (30 October 2026) |
+| `D-90` | `decisions.md`:1182 | D-90. Help gets How do I…, Show me runs everywhere, and Help is built without a separate mock-up step (30 October 2026) |
+| `D-91` | `decisions.md`:1193 | D-91. One design home for the redesign, and Josh's answers on Help, Settings, search and notifications (31 October 2026) |
+| `D-92` | `decisions.md`:1228 | D-92. Help goes live before its mock-up review, one search box on Capacity, and referral rows on Home open the panel (31 October 2026) |
+| `D-93` | `decisions.md`:1238 | D-93. Legal form times show only as typed, never as a countdown (31 October 2026) |
+| `D-94` | `decisions.md`:1246 | D-94. Design rulings of 31 October 2026 |
+| `D-95` | `decisions.md`:1259 | D-95. One page scroll, and a click outside closes a drawer (3 November 2026) |
+| `D-96` | `decisions.md`:1269 | D-96. A named bed is pulled, and its patient is not also waiting (8 November 2026) |
+| `D-97` | `decisions.md`:1279 | D-97. Owner answers on seven open items: N21, N25, N26, N29, N40, N41 and WF-B008 (8 November 2026) |
+| `D-98` | `decisions.md`:1292 | D-98. Friction pass: Quick bar, Patient peek and Ward peek (8 November 2026) |
+| `D-99` | `decisions.md`:1301 | D-99. "Real details" in the referral drawer's sample patients (25 September 2026) |
+| `D-100` | `decisions.md`:1307 | D-100. "Under a form" means one rule everywhere (9 November 2026) |
+| `D-101` | `decisions.md`:1314 | D-101. Clinically ready for discharge, with one delay reason (9 November 2026) |
+| `D-102` | `decisions.md`:1323 | D-102. Report-a-problem screenshots are blurred, and patient-table exports carry no names (9 November 2026) |
+| `D-103` | `decisions.md`:1332 | D-103. Any coordinator on shift may mark a bed override reviewed (9 November 2026) |
+| `D-104` | `decisions.md`:1339 | D-104. Care plans and safety flags: five defaults (9 November 2026) |
+| `D-105` | `decisions.md`:1351 | D-105. Optional clerk details on the patient record (8 November 2026) |
+| `D-106` | `decisions.md`:1358 | D-106. Clinical values from the 9 November 2026 documentation audit (9 November 2026) |
+| `D-107` | `decisions.md`:1370 | D-107. Working rules and documentation from the 9 November 2026 audit (9 November 2026) |
+| `D-108` | `decisions.md`:1384 | D-108. Six bed-flow features: keep D-93 and D-72, ED long-wait next steps (9 November 2026) |
+| `D-109` | `decisions.md`:1393 | D-109. Home's bed alert line tests the whole number shown (9 November 2026) |
+| `D-110` | `decisions.md`:1400 | D-110. ED and referral flow: neutral fit line, clearance timing and alternatives to admission (9 November 2026) |
+| `D-111` | `decisions.md`:1410 | D-111. Review and audit plan: first guards and four open answers (9 November 2026) |
+| `D-112` | `decisions.md`:1424 | D-112. Phone bottom bar: the floating bar (9 November 2026) |
+| `D-113` | `decisions.md`:1433 | D-113. Second patient identifier on accept and Mark done; no initials search (9 November 2026) |
+| `D-114` | `decisions.md`:1443 | D-114. Allow pull_request_target for three workflows only (9 November 2026) |
+| `D-115` | `decisions.md`:1451 | D-115. One count on every screen, and a missing patient shown everywhere (9 November 2026) |
+| `D-116` | `decisions.md`:1465 | D-116. Page tops: the PR #1581 recommendations stand (9 November 2026) |
+| `D-117` | `decisions.md`:1482 | D-117. Care plans follow-up: frequent presenter count, tribunal date and ward flags (10 November 2026) |
+| `D-118` | `decisions.md`:1491 | D-118. Page tops: Referrals and Ward phone limits up to 8 KB above main (10 November 2026) |
+| `D-119` | `decisions.md`:1497 | D-119. Page tops: phone limits raised to measured sizes, trim after merge (10 November 2026) |
+| `D-120` | `decisions.md`:1504 | D-120. Discharge and capacity values: pull limit, transport delay and discharge date slip (9 November 2026) |
+| `D-121` | `decisions.md`:1513 | D-121. Working rules, guards and your PC from the 10 November 2026 audit (10 November 2026) |
+| `D-122` | `decisions.md`:1527 | D-122. Clinical and privacy answers from the 10 November 2026 audit (10 November 2026) |
+| `D-123` | `decisions.md`:1540 | D-123. Master audit list answers: two clinical fixes and five working rules (10 November 2026) |
+| `D-124` | `decisions.md`:1554 | D-124. Offline saves whose record changed are refused and shown (10 November 2026) |
+| `D-125` | `decisions.md`:1561 | D-125. Top 10 audit follow-ups approved (10 November 2026) |
+| `D-126` | `decisions.md`:1573 | D-126. Ranked lists: neutral orders approved (10 November 2026) |
+| `D-127` | `decisions.md`:1592 | D-127. Neutral wording for a community treatment order at arrival (10 November 2026) |
+| `D-128` | `decisions.md`:1599 | D-128. Final master audit: nine answers (10 November 2026) |
+| `D-129` | `decisions.md`:1614 | D-129. Master audit findings: every recommendation approved (10 November 2026) |
+| `D-130` | `decisions.md`:1664 | D-130. Audit follow-ups: every remaining recommendation approved (10 November 2026) |
+| `D-131` | `decisions.md`:1680 | D-131. Hard-case demo data allowed, and the movement diagram follows the engine (10 November 2026) |
+| `D-132` | `decisions.md`:1689 | D-132. Audit fixes group 1: docs and CI guards (10 November 2026) |
+| `D-138` | `decisions.md`:1699 | D-138. Phone alert urgency by kind (10 November 2026) |
+| `D-143` | `decisions.md`:1705 | D-143. MHERT is MHERL in the glossary; SMHMR deferred (11 November 2026) |
+| `D-145` | `decisions.md`:1713 | D-145. Repository review: fixes, features and code health approved (11 November 2026) |
 | `D9-1` | `../history/archive/dated-notes/ward-flow-phase-9-decisions.md`:62 | D9-1 — The wait becomes prominent, and its ceiling is removed; it never outranks urgency (SESSION) |
 | `D9-2` | `../history/archive/dated-notes/ward-flow-phase-9-decisions.md`:102 | D9-2 — Declaring escalation records it and marks the screens, and changes nothing else (SESSION, and partly blocked) |
 | `D9-3` | `../history/archive/dated-notes/ward-flow-phase-9-decisions.md`:126 | D9-3 — The retrospective is one person's journey replayed, plus the ward prediction track record last (SESSION) |
@@ -607,148 +608,149 @@ safe global key across 30 files.
 
 ## By file, newest first — 43 files
 
-### `decisions.md` (2026-09-01 – 2026-11-10 (mixed, see file))
+### `decisions.md` (2026-09-01 – 2026-11-11 (mixed, see file))
 
 **Recorded decision log.** Read the source for supersession and current scope; indexing does not grant authority.
 
 **Title:** Ward Flow — decision log
 
-134 item(s):
-
-- `D-1` — line 163, heading: "D-1. Ward Flow is local only, with no linked repository (Replaced by D-27)"
-- `D-2` — line 173, heading: "D-2. Railway is disconnected"
-- `D-3` — line 184, heading: "D-3. The PsychSift and Database code is being retired from Ward Flow"
-- `D-4` — line 192, heading: "D-4. Synthetic patients only"
-- `D-5` — line 200, heading: "D-5. Parallel threads in separate worktrees, folded one at a time"
-- `D-6` — line 211, heading: "D-6. Aboriginal cultural safety review deferred"
-- `D-7` — line 219, heading: "D-7. The first four milestones, in this order"
-- `D-8` — line 231, heading: "D-8. Josh's standing rulings, numbered R1 to R16, for every session and tool"
-- `D-9` — line 263, heading: "D-9. Josh's rulings of 25 September, 11:43 to 12:00 (R17 to R21)"
-- `D-10` — line 277, heading: "D-10. Gate build type check (R22)"
-- `D-11` — line 286, heading: "D-11. Rulings of 25 September, 12:41 (R23 to R25)"
-- `D-12` — line 302, heading: "D-12. Rulings of 25 September, 12:43 (R26 to R31)"
-- `D-13` — line 321, heading: "D-13. Tooling tests in batch gates (R32)"
-- `D-14` — line 331, heading: "D-14. Standing defaults: decide small things without asking"
-- `D-15` — line 343, heading: "D-15. Rulings of 25 September, 13:26 (R33 to R35)"
-- `D-16` — line 356, heading: "D-16. Legal overrides and form receipts, 25 September 13:51 UTC"
-- `D-17` — line 369, heading: "D-17. Morning roll-up time is Josh's own default (25 September)"
-- `D-18` — line 380, heading: "D-18. The privacy lock stops saving only for typed text (25 September)"
-- `D-19` — line 391, heading: "D-19. Rulings of 25 September, evening (walkthrough, leave beds, PsychSift, gender display)"
-- `D-20` — line 421, heading: "D-20. One high-contrast colour check retired (26 September)"
-- `D-21` — line 434, heading: "D-21. Coordinator bed board: all nine recommended answers (26 September)"
-- `D-22` — line 446, heading: "D-22. No legal limits in hour rules; the rest are labelled defaults (26 September)"
-- `D-23` — line 462, heading: "D-23. Leave-bed fields kept; patient search stops matching by ward (26 September)"
-- `D-24` — line 476, heading: "D-24. Hour-rules morning list: all A (26 September)"
-- `D-25` — line 500, heading: "D-25. The lone-patient check counts free beds on both matching paths (26 September)"
-- `D-26` — line 508, heading: "D-26. Select fold checks by changed risk (27 September)"
-- `D-27` — line 526, heading: "D-27. Ward Flow uses its dedicated repository (28 September)"
-- `D-28` — line 539, heading: "D-28. Design Modernization & Anti-Box Architecture (30 September 2026)"
-- `D-29` — line 553, heading: "D-29. Act time limits shown as a labelled synthetic demo (4 October 2026)"
-- `D-30` — line 568, heading: "D-30. Central Coordinator Approval for Inter-Ward Bed Transfers (6 October 2026)"
-- `D-31` — line 575, heading: "D-31. Gender-Diverse Bed Placement Policy & Clinical Override Safety (6 October 2026)"
-- `D-32` — line 582, heading: "D-32. FIFO Waiting Time with Clinical Triage Badging vs Algorithmic Urgency Sorting (6 October 2026)"
-- `D-33` — line 589, heading: "D-33. Separation of Local Ward Shift Notes from Statewide Coordinator Telemetry (6 October 2026)"
-- `D-34` — line 596, heading: "D-34. Acute Medical Deterioration Bed Release and Escalation Protocol (6 October 2026)"
-- `D-35` — line 603, heading: "D-35. Deferral of Regional Multi-Leg Transport & RFDS Repatriation (6 October 2026)"
-- `D-36` — line 610, heading: "D-36. Affirmation of External Governance & Clinical Safety Hard Gates (6 October 2026) (Replaced by D-87)"
-- `D-37` — line 625, heading: "D-37. External Governance Hard Gate Operational Postures & Resolution Roadmap (6 October 2026) (Replaced by D-87)"
-- `D-38` — line 652, heading: "D-38. Leave, absent without leave and CTO on the Patient page (9 October 2026)"
-- `D-39` — line 670, heading: "D-39. Patients are identified by UMRN, never by a WF number (9 October 2026)"
-- `D-40` — line 714, heading: "D-40. A second community treatment order keeps the first (9 October 2026)"
-- `D-41` — line 725, heading: "D-41. Delays board filters narrow the table and state the hidden count (9 October 2026)"
-- `D-42` — line 738, heading: "D-42. 12px typography floor with no uppercase exception reaffirmed in Design System v9 (9–10 October 2026)"
-- `D-43` — line 744, heading: "D-43. Colour lives in glyphs and the hero; red means act now with a thin 1px edge, never a fill (9 October 2026)"
-- `D-44` — line 751, heading: "D-44. Compact sizing, white cards and smaller text retained over expression-test card tints (9 October 2026)"
-- `D-45` — line 757, heading: "D-45. Phone is its own 390×844 design, never a desktop reflow (9 October 2026)"
-- `D-46` — line 764, heading: "D-46. Every page has a focal part, a part of its own, a page-specific hero and command-bar action rules (9 October 2026)"
-- `D-47` — line 770, heading: "D-47. Glass stays about 80% opaque with the top sheen kept (10 October 2026)"
-- `D-48` — line 776, heading: "D-48. Figures stay in Geist Mono with tabular digits while chart axes use Geist Sans (10 October 2026)"
-- `D-49` — line 782, heading: "D-49. Ward Flow 44px default row target (dense 36px, touch 52px) vs retired 48px PsychSift tap knob (10 October 2026)"
-- `D-50` — line 788, heading: "D-50. Neutral T1 urgency pill vs Form 1A amber statutory warning badge (10 October 2026)"
-- `D-51` — line 794, heading: "D-51. Delays filters hide rows with a stated hidden count while other queues highlight by default (10 October 2026)"
-- `D-52` — line 801, heading: "D-52. 10 October page review rulings: time-axis overdue zone, 15px/20px strip figures, 8px people pips and incremental shared parts (10 October 2026)"
-- `D-53` — line 807, heading: "D-53. Elevate design language and Glare mode adopted for Design System v9 (10 October 2026)"
-- `D-54` — line 814, heading: "D-54. Tier time thresholds remain synthetic demo values requiring clinical sign-off (10 October 2026)"
-- `D-55` — line 822, heading: "D-55. Supabase is Ward Flow's database and sign-in provider, and Azure is retired (15 October 2026)"
-- `D-56` — line 828, heading: "D-56. Josh signs the clinical values that have a recorded source, for the prototype (15 October 2026)"
-- `D-57` — line 834, heading: "D-57. Twenty Top 25 items move from the showcase into the real screens, each behind its own flag (15 October 2026)"
-- `D-58` — line 861, heading: "D-58. Josh signs three more clinical values that have a national source, for the prototype (15 October 2026)"
-- `D-59` — line 867, heading: "D-59. Each role sees only what it needs, from one access table (15 October 2026)"
-- `D-60` — line 873, heading: "D-60. Criteria led discharge, for voluntary patients only (15 October 2026)"
-- `D-61` — line 882, heading: "D-61. Tasks and Alerts are one queue called Alerts (16 October 2026)"
-- `D-62` — line 888, heading: "D-62. The one Alerts queue is signed off and its flag removed (16 October 2026)"
-- `D-63` — line 894, heading: "D-63. Josh signs the remaining clinical values and the criteria list, for the prototype (16 October 2026)"
-- `D-64` — line 902, heading: "D-64. Criteria led discharge shows on the boards and warns at departure (16 October 2026)"
-- `D-65` — line 909, heading: "D-65. Criteria led discharge on in production, typed patient specific criteria, and the AWOL bed hold review paused (17 October 2026)"
-- `D-66` — line 925, heading: "D-66. Granted roles work without a second approval (17 October 2026)"
-- `D-67` — line 933, heading: "D-67. Recover synthetic form drafts within the browser session (17 October 2026)"
-- `D-68` — line 940, heading: "D-68. Bed meeting TV content and access (19 October 2026)"
-- `D-69` — line 948, heading: "D-69. A referral with no legal status: "Needs an involuntary-capable bed until status is set." (20 October 2026)"
-- `D-70` — line 955, heading: "D-70. No computed Mental Health Act periods: show only the recorded due time (20 October 2026)"
-- `D-71` — line 961, heading: "D-71. Audit 1 clinical safety fixes: no suggested wards, wait-order queues, recorded facts only (20 October 2026)"
-- `D-72` — line 974, heading: "D-72. Seven product decisions for the 21 October fix plan (21 October 2026)"
-- `D-73` — line 990, heading: "D-73. Batch merge safeguards (21 October 2026)"
-- `D-74` — line 1006, heading: "D-74. Owner answers to the 21 October open questions (21 October 2026)"
-- `D-75` — line 1027, heading: "D-75. UX audit follow-up, page caching, community gaps and the extra-travel bed hold (21 October 2026)"
-- `D-76` — line 1040, heading: "D-76. Community referral gaps: the full move journey and asking more wards (21 October 2026)"
-- `D-77` — line 1049, heading: "D-77. The ten bigger UX changes approved for build (22 October 2026)"
-- `D-78` — line 1069, heading: "D-78. One decline list for wards and coordinators (22 October 2026)"
-- `D-79` — line 1080, heading: "D-79. Wards see the full referral, with name and UMRN, before they answer (23 October 2026)"
-- `D-80` — line 1091, heading: "D-80. Role access plan version 2: all 17 recommendations (23 October 2026)"
-- `D-81` — line 1106, heading: "D-81. Pulled, with a pull time limit, for a bed kept for an incoming patient (24 October 2026)"
-- `D-82` — line 1113, heading: "D-82. A PR may raise a phone size limit by up to 5 KB per screen without asking (26 October 2026)"
-- `D-83` — line 1121, heading: "D-83. Patient names stay in full on every screen, copy and TV; privacy work must not make the app less useful (26 October 2026)"
-- `D-84` — line 1132, heading: "D-84. The live app stays on Railway Singapore for now, and there is no server-side TV account yet (26 October 2026)"
-- `D-85` — line 1140, heading: "D-85. "Held" only for a bed kept for its own patient; "pulled" for an incoming bed; "held up" for a delay (26 October 2026)"
-- `D-86` — line 1147, heading: "D-86. No second approver for role grants, at pilot or otherwise (27 October 2026)"
-- `D-87` — line 1154, heading: "D-87. D-36 and D-37 are replaced by the real-data gate (27 October 2026)"
-- `D-88` — line 1166, heading: "D-88. The public demo opens with a demo code once the front door is on (27 October 2026)"
-- `D-89` — line 1173, heading: "D-89. Redesign mock-up copies of large screens may pass the 1,500-line cap (30 October 2026)"
-- `D-90` — line 1181, heading: "D-90. Help gets How do I…, Show me runs everywhere, and Help is built without a separate mock-up step (30 October 2026)"
-- `D-91` — line 1192, heading: "D-91. One design home for the redesign, and Josh's answers on Help, Settings, search and notifications (31 October 2026)"
-- `D-92` — line 1227, heading: "D-92. Help goes live before its mock-up review, one search box on Capacity, and referral rows on Home open the panel (31 October 2026)"
-- `D-93` — line 1237, heading: "D-93. Legal form times show only as typed, never as a countdown (31 October 2026)"
-- `D-94` — line 1245, heading: "D-94. Design rulings of 31 October 2026"
-- `D-95` — line 1258, heading: "D-95. One page scroll, and a click outside closes a drawer (3 November 2026)"
-- `D-96` — line 1268, heading: "D-96. A named bed is pulled, and its patient is not also waiting (8 November 2026)"
-- `D-97` — line 1278, heading: "D-97. Owner answers on seven open items: N21, N25, N26, N29, N40, N41 and WF-B008 (8 November 2026)"
-- `D-98` — line 1291, heading: "D-98. Friction pass: Quick bar, Patient peek and Ward peek (8 November 2026)"
-- `D-99` — line 1300, heading: "D-99. "Real details" in the referral drawer's sample patients (25 September 2026)"
-- `D-100` — line 1306, heading: "D-100. "Under a form" means one rule everywhere (9 November 2026)"
-- `D-101` — line 1313, heading: "D-101. Clinically ready for discharge, with one delay reason (9 November 2026)"
-- `D-102` — line 1322, heading: "D-102. Report-a-problem screenshots are blurred, and patient-table exports carry no names (9 November 2026)"
-- `D-103` — line 1331, heading: "D-103. Any coordinator on shift may mark a bed override reviewed (9 November 2026)"
-- `D-104` — line 1338, heading: "D-104. Care plans and safety flags: five defaults (9 November 2026)"
-- `D-105` — line 1350, heading: "D-105. Optional clerk details on the patient record (8 November 2026)"
-- `D-106` — line 1357, heading: "D-106. Clinical values from the 9 November 2026 documentation audit (9 November 2026)"
-- `D-107` — line 1369, heading: "D-107. Working rules and documentation from the 9 November 2026 audit (9 November 2026)"
-- `D-108` — line 1383, heading: "D-108. Six bed-flow features: keep D-93 and D-72, ED long-wait next steps (9 November 2026)"
-- `D-109` — line 1392, heading: "D-109. Home's bed alert line tests the whole number shown (9 November 2026)"
-- `D-110` — line 1399, heading: "D-110. ED and referral flow: neutral fit line, clearance timing and alternatives to admission (9 November 2026)"
-- `D-111` — line 1409, heading: "D-111. Review and audit plan: first guards and four open answers (9 November 2026)"
-- `D-112` — line 1423, heading: "D-112. Phone bottom bar: the floating bar (9 November 2026)"
-- `D-113` — line 1432, heading: "D-113. Second patient identifier on accept and Mark done; no initials search (9 November 2026)"
-- `D-114` — line 1442, heading: "D-114. Allow pull_request_target for three workflows only (9 November 2026)"
-- `D-115` — line 1450, heading: "D-115. One count on every screen, and a missing patient shown everywhere (9 November 2026)"
-- `D-116` — line 1464, heading: "D-116. Page tops: the PR #1581 recommendations stand (9 November 2026)"
-- `D-117` — line 1481, heading: "D-117. Care plans follow-up: frequent presenter count, tribunal date and ward flags (10 November 2026)"
-- `D-118` — line 1490, heading: "D-118. Page tops: Referrals and Ward phone limits up to 8 KB above main (10 November 2026)"
-- `D-119` — line 1496, heading: "D-119. Page tops: phone limits raised to measured sizes, trim after merge (10 November 2026)"
-- `D-120` — line 1503, heading: "D-120. Discharge and capacity values: pull limit, transport delay and discharge date slip (9 November 2026)"
-- `D-121` — line 1512, heading: "D-121. Working rules, guards and your PC from the 10 November 2026 audit (10 November 2026)"
-- `D-122` — line 1526, heading: "D-122. Clinical and privacy answers from the 10 November 2026 audit (10 November 2026)"
-- `D-123` — line 1539, heading: "D-123. Master audit list answers: two clinical fixes and five working rules (10 November 2026)"
-- `D-124` — line 1553, heading: "D-124. Offline saves whose record changed are refused and shown (10 November 2026)"
-- `D-125` — line 1560, heading: "D-125. Top 10 audit follow-ups approved (10 November 2026)"
-- `D-126` — line 1572, heading: "D-126. Ranked lists: neutral orders approved (10 November 2026)"
-- `D-127` — line 1591, heading: "D-127. Neutral wording for a community treatment order at arrival (10 November 2026)"
-- `D-128` — line 1598, heading: "D-128. Final master audit: nine answers (10 November 2026)"
-- `D-129` — line 1613, heading: "D-129. Master audit findings: every recommendation approved (10 November 2026)"
-- `D-130` — line 1663, heading: "D-130. Audit follow-ups: every remaining recommendation approved (10 November 2026)"
-- `D-131` — line 1679, heading: "D-131. Hard-case demo data allowed, and the movement diagram follows the engine (10 November 2026)"
-- `D-132` — line 1688, heading: "D-132. Audit fixes group 1: docs and CI guards (10 November 2026)"
-- `D-138` — line 1698, heading: "D-138. Phone alert urgency by kind (10 November 2026)"
-- `D-143` — line 1704, heading: "D-143. MHERT is MHERL in the glossary; SMHMR deferred (11 November 2026)"
+135 item(s):
+
+- `D-1` — line 164, heading: "D-1. Ward Flow is local only, with no linked repository (Replaced by D-27)"
+- `D-2` — line 174, heading: "D-2. Railway is disconnected"
+- `D-3` — line 185, heading: "D-3. The PsychSift and Database code is being retired from Ward Flow"
+- `D-4` — line 193, heading: "D-4. Synthetic patients only"
+- `D-5` — line 201, heading: "D-5. Parallel threads in separate worktrees, folded one at a time"
+- `D-6` — line 212, heading: "D-6. Aboriginal cultural safety review deferred"
+- `D-7` — line 220, heading: "D-7. The first four milestones, in this order"
+- `D-8` — line 232, heading: "D-8. Josh's standing rulings, numbered R1 to R16, for every session and tool"
+- `D-9` — line 264, heading: "D-9. Josh's rulings of 25 September, 11:43 to 12:00 (R17 to R21)"
+- `D-10` — line 278, heading: "D-10. Gate build type check (R22)"
+- `D-11` — line 287, heading: "D-11. Rulings of 25 September, 12:41 (R23 to R25)"
+- `D-12` — line 303, heading: "D-12. Rulings of 25 September, 12:43 (R26 to R31)"
+- `D-13` — line 322, heading: "D-13. Tooling tests in batch gates (R32)"
+- `D-14` — line 332, heading: "D-14. Standing defaults: decide small things without asking"
+- `D-15` — line 344, heading: "D-15. Rulings of 25 September, 13:26 (R33 to R35)"
+- `D-16` — line 357, heading: "D-16. Legal overrides and form receipts, 25 September 13:51 UTC"
+- `D-17` — line 370, heading: "D-17. Morning roll-up time is Josh's own default (25 September)"
+- `D-18` — line 381, heading: "D-18. The privacy lock stops saving only for typed text (25 September)"
+- `D-19` — line 392, heading: "D-19. Rulings of 25 September, evening (walkthrough, leave beds, PsychSift, gender display)"
+- `D-20` — line 422, heading: "D-20. One high-contrast colour check retired (26 September)"
+- `D-21` — line 435, heading: "D-21. Coordinator bed board: all nine recommended answers (26 September)"
+- `D-22` — line 447, heading: "D-22. No legal limits in hour rules; the rest are labelled defaults (26 September)"
+- `D-23` — line 463, heading: "D-23. Leave-bed fields kept; patient search stops matching by ward (26 September)"
+- `D-24` — line 477, heading: "D-24. Hour-rules morning list: all A (26 September)"
+- `D-25` — line 501, heading: "D-25. The lone-patient check counts free beds on both matching paths (26 September)"
+- `D-26` — line 509, heading: "D-26. Select fold checks by changed risk (27 September)"
+- `D-27` — line 527, heading: "D-27. Ward Flow uses its dedicated repository (28 September)"
+- `D-28` — line 540, heading: "D-28. Design Modernization & Anti-Box Architecture (30 September 2026)"
+- `D-29` — line 554, heading: "D-29. Act time limits shown as a labelled synthetic demo (4 October 2026)"
+- `D-30` — line 569, heading: "D-30. Central Coordinator Approval for Inter-Ward Bed Transfers (6 October 2026)"
+- `D-31` — line 576, heading: "D-31. Gender-Diverse Bed Placement Policy & Clinical Override Safety (6 October 2026)"
+- `D-32` — line 583, heading: "D-32. FIFO Waiting Time with Clinical Triage Badging vs Algorithmic Urgency Sorting (6 October 2026)"
+- `D-33` — line 590, heading: "D-33. Separation of Local Ward Shift Notes from Statewide Coordinator Telemetry (6 October 2026)"
+- `D-34` — line 597, heading: "D-34. Acute Medical Deterioration Bed Release and Escalation Protocol (6 October 2026)"
+- `D-35` — line 604, heading: "D-35. Deferral of Regional Multi-Leg Transport & RFDS Repatriation (6 October 2026)"
+- `D-36` — line 611, heading: "D-36. Affirmation of External Governance & Clinical Safety Hard Gates (6 October 2026) (Replaced by D-87)"
+- `D-37` — line 626, heading: "D-37. External Governance Hard Gate Operational Postures & Resolution Roadmap (6 October 2026) (Replaced by D-87)"
+- `D-38` — line 653, heading: "D-38. Leave, absent without leave and CTO on the Patient page (9 October 2026)"
+- `D-39` — line 671, heading: "D-39. Patients are identified by UMRN, never by a WF number (9 October 2026)"
+- `D-40` — line 715, heading: "D-40. A second community treatment order keeps the first (9 October 2026)"
+- `D-41` — line 726, heading: "D-41. Delays board filters narrow the table and state the hidden count (9 October 2026)"
+- `D-42` — line 739, heading: "D-42. 12px typography floor with no uppercase exception reaffirmed in Design System v9 (9–10 October 2026)"
+- `D-43` — line 745, heading: "D-43. Colour lives in glyphs and the hero; red means act now with a thin 1px edge, never a fill (9 October 2026)"
+- `D-44` — line 752, heading: "D-44. Compact sizing, white cards and smaller text retained over expression-test card tints (9 October 2026)"
+- `D-45` — line 758, heading: "D-45. Phone is its own 390×844 design, never a desktop reflow (9 October 2026)"
+- `D-46` — line 765, heading: "D-46. Every page has a focal part, a part of its own, a page-specific hero and command-bar action rules (9 October 2026)"
+- `D-47` — line 771, heading: "D-47. Glass stays about 80% opaque with the top sheen kept (10 October 2026)"
+- `D-48` — line 777, heading: "D-48. Figures stay in Geist Mono with tabular digits while chart axes use Geist Sans (10 October 2026)"
+- `D-49` — line 783, heading: "D-49. Ward Flow 44px default row target (dense 36px, touch 52px) vs retired 48px PsychSift tap knob (10 October 2026)"
+- `D-50` — line 789, heading: "D-50. Neutral T1 urgency pill vs Form 1A amber statutory warning badge (10 October 2026)"
+- `D-51` — line 795, heading: "D-51. Delays filters hide rows with a stated hidden count while other queues highlight by default (10 October 2026)"
+- `D-52` — line 802, heading: "D-52. 10 October page review rulings: time-axis overdue zone, 15px/20px strip figures, 8px people pips and incremental shared parts (10 October 2026)"
+- `D-53` — line 808, heading: "D-53. Elevate design language and Glare mode adopted for Design System v9 (10 October 2026)"
+- `D-54` — line 815, heading: "D-54. Tier time thresholds remain synthetic demo values requiring clinical sign-off (10 October 2026)"
+- `D-55` — line 823, heading: "D-55. Supabase is Ward Flow's database and sign-in provider, and Azure is retired (15 October 2026)"
+- `D-56` — line 829, heading: "D-56. Josh signs the clinical values that have a recorded source, for the prototype (15 October 2026)"
+- `D-57` — line 835, heading: "D-57. Twenty Top 25 items move from the showcase into the real screens, each behind its own flag (15 October 2026)"
+- `D-58` — line 862, heading: "D-58. Josh signs three more clinical values that have a national source, for the prototype (15 October 2026)"
+- `D-59` — line 868, heading: "D-59. Each role sees only what it needs, from one access table (15 October 2026)"
+- `D-60` — line 874, heading: "D-60. Criteria led discharge, for voluntary patients only (15 October 2026)"
+- `D-61` — line 883, heading: "D-61. Tasks and Alerts are one queue called Alerts (16 October 2026)"
+- `D-62` — line 889, heading: "D-62. The one Alerts queue is signed off and its flag removed (16 October 2026)"
+- `D-63` — line 895, heading: "D-63. Josh signs the remaining clinical values and the criteria list, for the prototype (16 October 2026)"
+- `D-64` — line 903, heading: "D-64. Criteria led discharge shows on the boards and warns at departure (16 October 2026)"
+- `D-65` — line 910, heading: "D-65. Criteria led discharge on in production, typed patient specific criteria, and the AWOL bed hold review paused (17 October 2026)"
+- `D-66` — line 926, heading: "D-66. Granted roles work without a second approval (17 October 2026)"
+- `D-67` — line 934, heading: "D-67. Recover synthetic form drafts within the browser session (17 October 2026)"
+- `D-68` — line 941, heading: "D-68. Bed meeting TV content and access (19 October 2026)"
+- `D-69` — line 949, heading: "D-69. A referral with no legal status: "Needs an involuntary-capable bed until status is set." (20 October 2026)"
+- `D-70` — line 956, heading: "D-70. No computed Mental Health Act periods: show only the recorded due time (20 October 2026)"
+- `D-71` — line 962, heading: "D-71. Audit 1 clinical safety fixes: no suggested wards, wait-order queues, recorded facts only (20 October 2026)"
+- `D-72` — line 975, heading: "D-72. Seven product decisions for the 21 October fix plan (21 October 2026)"
+- `D-73` — line 991, heading: "D-73. Batch merge safeguards (21 October 2026)"
+- `D-74` — line 1007, heading: "D-74. Owner answers to the 21 October open questions (21 October 2026)"
+- `D-75` — line 1028, heading: "D-75. UX audit follow-up, page caching, community gaps and the extra-travel bed hold (21 October 2026)"
+- `D-76` — line 1041, heading: "D-76. Community referral gaps: the full move journey and asking more wards (21 October 2026)"
+- `D-77` — line 1050, heading: "D-77. The ten bigger UX changes approved for build (22 October 2026)"
+- `D-78` — line 1070, heading: "D-78. One decline list for wards and coordinators (22 October 2026)"
+- `D-79` — line 1081, heading: "D-79. Wards see the full referral, with name and UMRN, before they answer (23 October 2026)"
+- `D-80` — line 1092, heading: "D-80. Role access plan version 2: all 17 recommendations (23 October 2026)"
+- `D-81` — line 1107, heading: "D-81. Pulled, with a pull time limit, for a bed kept for an incoming patient (24 October 2026)"
+- `D-82` — line 1114, heading: "D-82. A PR may raise a phone size limit by up to 5 KB per screen without asking (26 October 2026)"
+- `D-83` — line 1122, heading: "D-83. Patient names stay in full on every screen, copy and TV; privacy work must not make the app less useful (26 October 2026)"
+- `D-84` — line 1133, heading: "D-84. The live app stays on Railway Singapore for now, and there is no server-side TV account yet (26 October 2026)"
+- `D-85` — line 1141, heading: "D-85. "Held" only for a bed kept for its own patient; "pulled" for an incoming bed; "held up" for a delay (26 October 2026)"
+- `D-86` — line 1148, heading: "D-86. No second approver for role grants, at pilot or otherwise (27 October 2026)"
+- `D-87` — line 1155, heading: "D-87. D-36 and D-37 are replaced by the real-data gate (27 October 2026)"
+- `D-88` — line 1167, heading: "D-88. The public demo opens with a demo code once the front door is on (27 October 2026)"
+- `D-89` — line 1174, heading: "D-89. Redesign mock-up copies of large screens may pass the 1,500-line cap (30 October 2026)"
+- `D-90` — line 1182, heading: "D-90. Help gets How do I…, Show me runs everywhere, and Help is built without a separate mock-up step (30 October 2026)"
+- `D-91` — line 1193, heading: "D-91. One design home for the redesign, and Josh's answers on Help, Settings, search and notifications (31 October 2026)"
+- `D-92` — line 1228, heading: "D-92. Help goes live before its mock-up review, one search box on Capacity, and referral rows on Home open the panel (31 October 2026)"
+- `D-93` — line 1238, heading: "D-93. Legal form times show only as typed, never as a countdown (31 October 2026)"
+- `D-94` — line 1246, heading: "D-94. Design rulings of 31 October 2026"
+- `D-95` — line 1259, heading: "D-95. One page scroll, and a click outside closes a drawer (3 November 2026)"
+- `D-96` — line 1269, heading: "D-96. A named bed is pulled, and its patient is not also waiting (8 November 2026)"
+- `D-97` — line 1279, heading: "D-97. Owner answers on seven open items: N21, N25, N26, N29, N40, N41 and WF-B008 (8 November 2026)"
+- `D-98` — line 1292, heading: "D-98. Friction pass: Quick bar, Patient peek and Ward peek (8 November 2026)"
+- `D-99` — line 1301, heading: "D-99. "Real details" in the referral drawer's sample patients (25 September 2026)"
+- `D-100` — line 1307, heading: "D-100. "Under a form" means one rule everywhere (9 November 2026)"
+- `D-101` — line 1314, heading: "D-101. Clinically ready for discharge, with one delay reason (9 November 2026)"
+- `D-102` — line 1323, heading: "D-102. Report-a-problem screenshots are blurred, and patient-table exports carry no names (9 November 2026)"
+- `D-103` — line 1332, heading: "D-103. Any coordinator on shift may mark a bed override reviewed (9 November 2026)"
+- `D-104` — line 1339, heading: "D-104. Care plans and safety flags: five defaults (9 November 2026)"
+- `D-105` — line 1351, heading: "D-105. Optional clerk details on the patient record (8 November 2026)"
+- `D-106` — line 1358, heading: "D-106. Clinical values from the 9 November 2026 documentation audit (9 November 2026)"
+- `D-107` — line 1370, heading: "D-107. Working rules and documentation from the 9 November 2026 audit (9 November 2026)"
+- `D-108` — line 1384, heading: "D-108. Six bed-flow features: keep D-93 and D-72, ED long-wait next steps (9 November 2026)"
+- `D-109` — line 1393, heading: "D-109. Home's bed alert line tests the whole number shown (9 November 2026)"
+- `D-110` — line 1400, heading: "D-110. ED and referral flow: neutral fit line, clearance timing and alternatives to admission (9 November 2026)"
+- `D-111` — line 1410, heading: "D-111. Review and audit plan: first guards and four open answers (9 November 2026)"
+- `D-112` — line 1424, heading: "D-112. Phone bottom bar: the floating bar (9 November 2026)"
+- `D-113` — line 1433, heading: "D-113. Second patient identifier on accept and Mark done; no initials search (9 November 2026)"
+- `D-114` — line 1443, heading: "D-114. Allow pull_request_target for three workflows only (9 November 2026)"
+- `D-115` — line 1451, heading: "D-115. One count on every screen, and a missing patient shown everywhere (9 November 2026)"
+- `D-116` — line 1465, heading: "D-116. Page tops: the PR #1581 recommendations stand (9 November 2026)"
+- `D-117` — line 1482, heading: "D-117. Care plans follow-up: frequent presenter count, tribunal date and ward flags (10 November 2026)"
+- `D-118` — line 1491, heading: "D-118. Page tops: Referrals and Ward phone limits up to 8 KB above main (10 November 2026)"
+- `D-119` — line 1497, heading: "D-119. Page tops: phone limits raised to measured sizes, trim after merge (10 November 2026)"
+- `D-120` — line 1504, heading: "D-120. Discharge and capacity values: pull limit, transport delay and discharge date slip (9 November 2026)"
+- `D-121` — line 1513, heading: "D-121. Working rules, guards and your PC from the 10 November 2026 audit (10 November 2026)"
+- `D-122` — line 1527, heading: "D-122. Clinical and privacy answers from the 10 November 2026 audit (10 November 2026)"
+- `D-123` — line 1540, heading: "D-123. Master audit list answers: two clinical fixes and five working rules (10 November 2026)"
+- `D-124` — line 1554, heading: "D-124. Offline saves whose record changed are refused and shown (10 November 2026)"
+- `D-125` — line 1561, heading: "D-125. Top 10 audit follow-ups approved (10 November 2026)"
+- `D-126` — line 1573, heading: "D-126. Ranked lists: neutral orders approved (10 November 2026)"
+- `D-127` — line 1592, heading: "D-127. Neutral wording for a community treatment order at arrival (10 November 2026)"
+- `D-128` — line 1599, heading: "D-128. Final master audit: nine answers (10 November 2026)"
+- `D-129` — line 1614, heading: "D-129. Master audit findings: every recommendation approved (10 November 2026)"
+- `D-130` — line 1664, heading: "D-130. Audit follow-ups: every remaining recommendation approved (10 November 2026)"
+- `D-131` — line 1680, heading: "D-131. Hard-case demo data allowed, and the movement diagram follows the engine (10 November 2026)"
+- `D-132` — line 1689, heading: "D-132. Audit fixes group 1: docs and CI guards (10 November 2026)"
+- `D-138` — line 1699, heading: "D-138. Phone alert urgency by kind (10 November 2026)"
+- `D-143` — line 1705, heading: "D-143. MHERT is MHERL in the glossary; SMHMR deferred (11 November 2026)"
+- `D-145` — line 1713, heading: "D-145. Repository review: fixes, features and code health approved (11 November 2026)"
 
 ### `../history/archive/dated-notes/ward-management-decisions.md` (2026-08-18 – 2026-10-24 (mixed, see file))
 

From 35e512925c2ef21d73ee1e070d0e86221e9c7053 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 05:33:19 +0000
Subject: [PATCH 26/40] List the staff request shift tolerance as not a
 clinical value

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 tests/ward-clinical-values.test.ts | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/tests/ward-clinical-values.test.ts b/tests/ward-clinical-values.test.ts
index 12cad6713..6eba90285 100644
--- a/tests/ward-clinical-values.test.ts
+++ b/tests/ward-clinical-values.test.ts
@@ -258,6 +258,11 @@ function typedThresholdsIn(file: string, source: string): string[] {
  * in `ward-clinical-values.ts` instead.
  */
 const NOT_CLINICAL: ReadonlyArray<{ file: string; name: string; why: string }> = [
+  {
+    file: "staffing/staff-requests.ts",
+    name: "STAFF_REQUEST_SHIFT_TOLERANCE_MINUTES",
+    why: "how many minutes a staff request may lag behind the shift start it names before the save is refused as already started (D-145); clock slack for a form, never a clinical limit",
+  },
   {
     file: "handover/handover-model.ts",
     name: "JUST_HELD_HANDOVER_MINUTES",

From 80a9617a7d8ed0e7eb83c2e28e36424c081cd911 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 05:46:34 +0000
Subject: [PATCH 27/40] D-145: record Josh's approval of the screen additions
 and two patterns

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/decisions.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/ward-flow/decisions.md b/docs/ward-flow/decisions.md
index e3b99e0bc..643eb7205 100644
--- a/docs/ward-flow/decisions.md
+++ b/docs/ward-flow/decisions.md
@@ -1719,5 +1719,6 @@ is inferred.
   3. **Features that finish existing screens** (not covered by the D-128 item 9 pause): Leave page links, print and entry point; Help for pages that had none; print and spreadsheet export on Legal forms and Movements. Triage risk reviews due waits until #1564 to #1577 close and needs its own clinical sign-off.
   4. **Code health:** the file line cap counts code lines, not comments or blank lines; one shared CI setup step; shared helpers for the forked side rail; reasons or fixes for unexplained React hook rule switch-offs; patch-level dependency updates.
   5. **Josh's own action:** turn off Supabase open sign-up before real data.
+- **Screens approved (11 November 2026, 05:46 UTC):** after the design review page "Leave and export review", Josh chose "Yes, add them" on the decision card. This approves the item 3 screens and two new patterns: an icon-only Print button on phones, and the Export status line hidden until it has something to say (this affects every list with Export).
 - **Why:** findings from the 11 November review, each checked against source; the clinical items were display bugs, not changes to signed values.
 - **Boundary:** synthetic data only. Changes no signed clinical value; clinical items merge only after Josh checks the held PR. Approves no release.

From 08f4e3fb326b8d0a4d1f10aaec46be27b405a08d Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 05:50:58 +0000
Subject: [PATCH 28/40] Shorten the What's new line to the 120-character limit

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../help/whats-new/2026-11-11-leave-print-and-exports.json      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/ward-management/help/whats-new/2026-11-11-leave-print-and-exports.json b/src/components/ward-management/help/whats-new/2026-11-11-leave-print-and-exports.json
index dcb024c5a..2466b294c 100644
--- a/src/components/ward-management/help/whats-new/2026-11-11-leave-print-and-exports.json
+++ b/src/components/ward-management/help/whats-new/2026-11-11-leave-print-and-exports.json
@@ -1,3 +1,3 @@
 {
-  "line": "Leave page: Open ward links, Print and a Search entry. New Help for Leave, Today's review and triage. Print and Export on Legal forms and Movements."
+  "line": "Leave page Open ward links and Print, more Help pages, and Print and Export on Legal forms and Movements."
 }

From d2dbc743efa4a56a4f4d70437f710a9b20b5b0fc Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 05:53:28 +0000
Subject: [PATCH 29/40] D-145: record Josh's clinical sign-off for PR #1621

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/decisions.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/ward-flow/decisions.md b/docs/ward-flow/decisions.md
index 2c3ac2c1a..4d887431b 100644
--- a/docs/ward-flow/decisions.md
+++ b/docs/ward-flow/decisions.md
@@ -1731,5 +1731,6 @@ is inferred.
   4. **Code health:** the file line cap counts code lines, not comments or blank lines; one shared CI setup step; shared helpers for the forked side rail; reasons or fixes for unexplained React hook rule switch-offs; patch-level dependency updates.
   5. **Josh's own action:** turn off Supabase open sign-up before real data.
 - **Screens approved (11 November 2026, 05:46 UTC):** after the design review page "Leave and export review", Josh chose "Yes, add them" on the decision card. This approves the item 3 screens and two new patterns: an icon-only Print button on phones, and the Export status line hidden until it has something to say (this affects every list with Export).
+- **Clinical sign-off (11 November 2026, 05:51 UTC):** Josh wrote "I approve all of them to remove labels" in the thread "Get all open PRs merged", approving the item 1 fixes in PR #1621 as built, including the Legal forms wording "Form ended; expiry as typed was HH:MM".
 - **Why:** findings from the 11 November review, each checked against source; the clinical items were display bugs, not changes to signed values.
 - **Boundary:** synthetic data only. Changes no signed clinical value; clinical items merge only after Josh checks the held PR. Approves no release.

From ea1b6ed6cdbd3f38ae4899e9276c427e9f465dfc Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 06:33:17 +0000
Subject: [PATCH 30/40] Move the rail percent allowance to the shared helper;
 list the staff request clock slack

The shared ward-rail-helpers.ts now holds the one inline percentage the three rails each had,
so the M121 baseline moves with it (net 2 fewer). The 5-minute staff request tolerance is
clock slack, not a screen figure.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 tests/ward-audit-m121-inline-percent-baseline.json | 4 +---
 tests/ward-no-invented-screen-figures.test.ts      | 6 ++++++
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/tests/ward-audit-m121-inline-percent-baseline.json b/tests/ward-audit-m121-inline-percent-baseline.json
index 0ac8955d8..ffb241014 100644
--- a/tests/ward-audit-m121-inline-percent-baseline.json
+++ b/tests/ward-audit-m121-inline-percent-baseline.json
@@ -45,8 +45,7 @@
   "src/components/ward-management/reports/pilot-measures.ts": 1,
   "src/components/ward-management/reports/weekly-report.ts": 1,
   "src/components/ward-management/shell-next/next-capacity-glance.tsx": 1,
-  "src/components/ward-management/shell-next/next-rail-body.tsx": 1,
-  "src/components/ward-management/shell/ward-rail.tsx": 1,
+  "src/components/ward-management/shell/ward-rail-helpers.ts": 1,
   "src/components/ward-management/shell/ward-service-bed-alerts.ts": 2,
   "src/components/ward-management/statistics/executive-statistics-derivations.ts": 2,
   "src/components/ward-management/statistics/redesign/statistics-redesign-weekly.tsx": 1,
@@ -74,7 +73,6 @@
   "src/components/ward-management/wards/ward-index.tsx": 12,
   "src/components/ward-redesign/pop-help/help-show-me.tsx": 1,
   "src/components/ward-redesign/pop-tour/tour.tsx": 1,
-  "src/components/ward-redesign/shell/preview-rail-body.tsx": 1,
   "src/components/wf/chart.tsx": 3,
   "src/components/wf/stat.tsx": 3,
   "src/components/wf/v10-pass2.tsx": 1,
diff --git a/tests/ward-no-invented-screen-figures.test.ts b/tests/ward-no-invented-screen-figures.test.ts
index cea5ec235..8e2d35ca5 100644
--- a/tests/ward-no-invented-screen-figures.test.ts
+++ b/tests/ward-no-invented-screen-figures.test.ts
@@ -138,6 +138,12 @@ const EXCLUSIONS: readonly Exclusion[] = [
 
 /** Rule 4 only: constants that are not limits. */
 const CONSTANT_EXCLUSIONS: ReadonlyArray<{ id: string; why: string; file?: RegExp; name?: RegExp }> = [
+  {
+    id: "staff-request-clock-slack",
+    why: "How many minutes a staff request may lag the shift start it names before the save falls back to the current shift (D-145); clock slack for a form, never shown, not a limit.",
+    file: /^staffing\/staff-requests\.ts$/,
+    name: /^STAFF_REQUEST_SHIFT_TOLERANCE_MINUTES$/,
+  },
   { id: "seed-data", why: "Seed files build made-up records; their times are data, not limits.", file: /-seed\.ts$/ },
   {
     id: "chart-and-day-part",

From d055891afe4a4f67ed6d2fcdb30e84a658e1c619 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 06:41:58 +0000
Subject: [PATCH 31/40] Move the CSV download helper to the ward root

The new Legal forms and Movements exports imported it from the statistics
screen, which raised the screen-to-screen import count past the guard.
Statistics keeps its ReleasedCount wrapper and re-uses the shared helper.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../legal-forms/legal-forms-export.ts         |  2 +-
 .../movements/movements-export.ts             |  2 +-
 .../statistics/statistics-csv.ts              | 31 ++-----------
 src/components/ward-management/ward-csv.ts    | 46 +++++++++++++++++++
 tests/ward-audit-m124-outbound-marker.test.ts |  5 +-
 5 files changed, 56 insertions(+), 30 deletions(-)
 create mode 100644 src/components/ward-management/ward-csv.ts

diff --git a/src/components/ward-management/legal-forms/legal-forms-export.ts b/src/components/ward-management/legal-forms/legal-forms-export.ts
index 9c95d2111..49e01ae66 100644
--- a/src/components/ward-management/legal-forms/legal-forms-export.ts
+++ b/src/components/ward-management/legal-forms/legal-forms-export.ts
@@ -2,7 +2,7 @@ import { formatSheetMoment, isClockBreached, type Instant } from "@/components/w
 import { legalFormName } from "@/components/ward-management/ward-legal-forms";
 import { FORM_RECORDED_ENDED, formRecordedEnded } from "@/components/ward-management/ward-legal-form-ended";
 import type { Movement } from "@/components/ward-management/ward-model";
-import { downloadCsv } from "@/components/ward-management/statistics/statistics-csv";
+import { downloadCsv } from "@/components/ward-management/ward-csv";
 
 import { currentLegalDueAt, formProgression, formProgressionPhrase } from "./legal-form-progression";
 
diff --git a/src/components/ward-management/movements/movements-export.ts b/src/components/ward-management/movements/movements-export.ts
index ef488bea1..ec5e8c2c8 100644
--- a/src/components/ward-management/movements/movements-export.ts
+++ b/src/components/ward-management/movements/movements-export.ts
@@ -6,7 +6,7 @@ import { movementOriginLabel } from "@/components/ward-management/ward-movement-
 import { resolveSubjectPatient } from "@/components/ward-management/ward-patient-resolver";
 import { edById, edShortName } from "@/components/ward-management/ward-sites";
 import { stageCopy } from "@/components/ward-management/ward-stage-copy";
-import { downloadCsv } from "@/components/ward-management/statistics/statistics-csv";
+import { downloadCsv } from "@/components/ward-management/ward-csv";
 
 /** Where and when the file was taken, as `downloadCsv` writes it above the rows. */
 export type ListExportProvenance = NonNullable<Parameters<typeof downloadCsv>[2]>;
diff --git a/src/components/ward-management/statistics/statistics-csv.ts b/src/components/ward-management/statistics/statistics-csv.ts
index 734a1ef0a..40a6fc615 100644
--- a/src/components/ward-management/statistics/statistics-csv.ts
+++ b/src/components/ward-management/statistics/statistics-csv.ts
@@ -1,4 +1,4 @@
-import { downloadBlob } from "@/components/ward-management/ward-download";
+import { type CsvProvenance, csvTextCell, downloadCsv as downloadWardCsv } from "@/components/ward-management/ward-csv";
 import type { ReleasedCount } from "./executive-statistics-contract";
 import { releasedCountText } from "./statistics-small-numbers";
 
@@ -9,28 +9,7 @@ type CsvValue = string | number | ReleasedCount;
  * spreadsheet reads it as text, not a formula; numbers are written as they are.
  */
 export function csvCell(value: CsvValue): string {
-  if (typeof value === "object") value = releasedCountText(value);
-  const text = String(value);
-  const safe = typeof value === "string" && /^[=+\-@\t\r]/u.test(text) ? `'${text}` : text;
-  return `"${safe.replaceAll('"', '""')}"`;
-}
-
-type CsvProvenance = {
-  /** The snapshot time, already formatted with its calendar year and time zone. */
-  readonly asAt: string;
-  readonly scope: string;
-  readonly period?: string;
-};
-
-/** Metadata is separate from the unchanged data-column header and rows. */
-function csvProvenanceLines(provenance: CsvProvenance): (string | number)[][] {
-  return [
-    ["Data", "Synthetic, not clinical records"],
-    ["As at", provenance.asAt],
-    ["Scope", provenance.scope],
-    ["Period", provenance.period ?? "Recorded state as at snapshot"],
-    [],
-  ];
+  return csvTextCell(typeof value === "object" ? releasedCountText(value) : value);
 }
 
 /** Writes rows as a CSV file and hands it to the browser as a download. */
@@ -39,10 +18,10 @@ export function downloadCsv(
   lines: readonly (readonly CsvValue[])[],
   provenance?: CsvProvenance,
 ): void {
-  const output = provenance ? [...csvProvenanceLines(provenance), ...lines] : lines;
-  downloadBlob(
-    new Blob([output.map((line) => line.map(csvCell).join(",")).join("\r\n")], { type: "text/csv;charset=utf-8" }),
+  downloadWardCsv(
     filename,
+    lines.map((line) => line.map((value) => (typeof value === "object" ? releasedCountText(value) : value))),
+    provenance,
   );
 }
 
diff --git a/src/components/ward-management/ward-csv.ts b/src/components/ward-management/ward-csv.ts
new file mode 100644
index 000000000..c1c612d91
--- /dev/null
+++ b/src/components/ward-management/ward-csv.ts
@@ -0,0 +1,46 @@
+import { downloadBlob } from "@/components/ward-management/ward-download";
+
+type CsvText = string | number;
+
+/**
+ * Quote one CSV cell. Text starting with = + - @ tab or CR is prefixed with an apostrophe so a
+ * spreadsheet reads it as text, not a formula; numbers are written as they are.
+ */
+export function csvTextCell(value: CsvText): string {
+  const text = String(value);
+  const safe = typeof value === "string" && /^[=+\-@\t\r]/u.test(text) ? `'${text}` : text;
+  return `"${safe.replaceAll('"', '""')}"`;
+}
+
+export type CsvProvenance = {
+  /** The snapshot time, already formatted with its calendar year and time zone. */
+  readonly asAt: string;
+  readonly scope: string;
+  readonly period?: string;
+};
+
+/** Metadata is separate from the unchanged data-column header and rows. */
+function csvProvenanceLines(provenance: CsvProvenance): CsvText[][] {
+  return [
+    ["Data", "Synthetic, not clinical records"],
+    ["As at", provenance.asAt],
+    ["Scope", provenance.scope],
+    ["Period", provenance.period ?? "Recorded state as at snapshot"],
+    [],
+  ];
+}
+
+/** Writes rows as a CSV file and hands it to the browser as a download. */
+export function downloadCsv(
+  filename: string,
+  lines: readonly (readonly CsvText[])[],
+  provenance?: CsvProvenance,
+): void {
+  const output = provenance ? [...csvProvenanceLines(provenance), ...lines] : lines;
+  downloadBlob(
+    new Blob([output.map((line) => line.map(csvTextCell).join(",")).join("\r\n")], {
+      type: "text/csv;charset=utf-8",
+    }),
+    filename,
+  );
+}
diff --git a/tests/ward-audit-m124-outbound-marker.test.ts b/tests/ward-audit-m124-outbound-marker.test.ts
index 2f6b1555c..e7429cacf 100644
--- a/tests/ward-audit-m124-outbound-marker.test.ts
+++ b/tests/ward-audit-m124-outbound-marker.test.ts
@@ -50,7 +50,7 @@ const SOURCES = sourceFiles(path.join(ROOT, "src"));
 
 describe("M124 downloads carry the marker", () => {
   it("every CSV download passes its provenance block, which opens with the synthetic line", () => {
-    const csv = readFileSync(path.join(ROOT, "src/components/ward-management/statistics/statistics-csv.ts"), "utf8");
+    const csv = readFileSync(path.join(ROOT, "src/components/ward-management/ward-csv.ts"), "utf8");
     expect(csv).toContain('["Data", "Synthetic, not clinical records"]');
     const missing: string[] = [];
     let seen = 0;
@@ -81,7 +81,7 @@ describe("M124 downloads carry the marker", () => {
       ["src/components/ward-management/tools/ward-demo-panel.tsx", "scenario file: its JSON carries the notice"],
       ["src/components/ward-redesign/pop-demo/demo-panel.tsx", "scenario file: its JSON carries the notice"],
       // The CSV helper itself: its callers name every file (checked above).
-      ["src/components/ward-management/statistics/statistics-csv.ts", "the CSV helper"],
+      ["src/components/ward-management/ward-csv.ts", "the CSV helper"],
     ]);
     const unmarked: string[] = [];
     for (const file of SOURCES) {
@@ -176,6 +176,7 @@ describe("M124 word read-through on outbound builders (Manual, reviewed hits onl
   // A new "cleared", "safe to", "should", "approved", "endorsed" or "recommended" in a quoted
   // string in these files fails until a person reads it and adds it here with a reason.
   const files = [
+    "src/components/ward-management/ward-csv.ts",
     "src/components/ward-management/statistics/statistics-csv.ts",
     "src/components/ward-management/ed/ed-export.ts",
     "src/components/ward-management/discharges/discharge-export.ts",

From d884f6df5aa1ce4c3461ac412a681cf787e4e1f3 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 07:10:17 +0000
Subject: [PATCH 32/40] Raise the Movements and Statistics phone limits by 0.5
 and 0.3 KB

Movements gained Print and Export; Statistics loads the CSV helper through
the new ward-root module. Reasons in docs/script-budget-history.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../2026-11-11-pr1623-repository-review.md               | 9 +++++++++
 script-budget.json                                       | 4 ++--
 2 files changed, 11 insertions(+), 2 deletions(-)
 create mode 100644 docs/script-budget-history/2026-11-11-pr1623-repository-review.md

diff --git a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
new file mode 100644
index 000000000..9f38f445e
--- /dev/null
+++ b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
@@ -0,0 +1,9 @@
+# 11 Nov 2026, Repository review fixes and features (PR #1623)
+
+Changed on top of `main` at `35c7ccd`: movements `/ward-flow/movements/WF-001` raised 609.8 to 610.3; statistics `/ward-flow/statistics` raised 632.6 to 632.9. 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 `883a3c1`, merged with main): movements 610.0 KB, statistics 632.6 KB, both over their limit after rounding. Main alone could not be measured because this PR updates patch-level dependencies. Each new limit is the measurement plus about 0.3.
+
+Why it changed: Movements gained Print and spreadsheet Export (D-145 item 3). The CSV download helper moved to the ward root (`ward-csv.ts`) so Legal forms and Movements can share it without importing from the Statistics screen; Statistics now loads it through a thin wrapper.
+
+Trim tried: the export code only runs on a tap but is small and shares the existing download helper; splitting it into a lazy chunk would add more than it saves. No other safe trim was found.
diff --git a/script-budget.json b/script-budget.json
index 9faff200e..3e180f0a8 100644
--- a/script-budget.json
+++ b/script-budget.json
@@ -5,10 +5,10 @@
     "/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/movements/WF-001": 610.3,
     "/ward-flow/capacity": 654.7,
     "/ward-flow/ed/arm-ed": 667.4,
     "/ward-flow/bed-meeting": 592.2,
-    "/ward-flow/statistics": 632.6
+    "/ward-flow/statistics": 632.9
   }
 }

From 39cf4631a732c1e5665af2e8ba78be8e9c33261f Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 08:57:06 +0000
Subject: [PATCH 33/40] Raise the ED phone limit by 0.3 KB after merging main

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../2026-11-11-pr1623-repository-review.md                      | 2 ++
 script-budget.json                                              | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
index 694b2e038..bf32c9b0f 100644
--- a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
+++ b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
@@ -9,3 +9,5 @@ Why it changed: Movements gained Print and spreadsheet Export (D-145 item 3). Th
 Trim tried: the export code only runs on a tap but is small and shares the existing download helper; splitting it into a lazy chunk would add more than it saves. No other safe trim was found.
 
 Later the same day (merged with main `c21e99a`, which had raised every route): the same two raises applied on top of main's values, so movements is 610.9 + 0.5 = 611.4 and statistics 633.6 + 0.3 = 633.9. Every other route takes main's value.
+
+Then (PR head `9c7302e`, merged with main `c21e99a`): ED `/ward-flow/ed` raised 536.3 to 536.6. Hosted CI measured 536.3 KB, level with the limit after rounding; main alone could not be measured because of the dependency updates. The growth is most likely the shared helpers from D-145 item 2 (typed-time reader, pull-hold lapse check) that the ED screen loads; this was not measured route by route. Same trim reasoning as above.
diff --git a/script-budget.json b/script-budget.json
index c9ca5f1ee..f1834c68b 100644
--- a/script-budget.json
+++ b/script-budget.json
@@ -3,7 +3,7 @@
   "budgets": {
     "/ward-flow": 576.9,
     "/ward-flow/referrals": 585.1,
-    "/ward-flow/ed": 536.3,
+    "/ward-flow/ed": 536.6,
     "/ward-flow/ward/rph-adult-secure": 615.0,
     "/ward-flow/movements/WF-001": 611.4,
     "/ward-flow/capacity": 655.9,

From 3180581ceee71eb7d40c62087ef5085d43c12a6a Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 09:43:15 +0000
Subject: [PATCH 34/40] Treat a demo code shorter than 12 characters as no code
 (D-145)

PR #1615 has merged, so its tests no longer rely on a short code. The
length is counted after spaces and dashes are removed. Tests use longer
synthetic codes and pin the 11/12 boundary; the runbook says so.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 docs/ward-flow/OPERATIONS-RUNBOOK.md |  3 ++-
 docs/ward-flow/decisions.md          |  2 +-
 src/lib/front-door-pass.ts           | 11 ++++++--
 tests/front-door-pass.test.ts        | 39 ++++++++++++++++------------
 4 files changed, 35 insertions(+), 20 deletions(-)

diff --git a/docs/ward-flow/OPERATIONS-RUNBOOK.md b/docs/ward-flow/OPERATIONS-RUNBOOK.md
index 5e9cd9e7b..f1d30e8a8 100644
--- a/docs/ward-flow/OPERATIONS-RUNBOOK.md
+++ b/docs/ward-flow/OPERATIONS-RUNBOOK.md
@@ -56,7 +56,8 @@ so changing them needs a restart, not a rebuild:
   stays shut and `/sign-in` says sign-in is not set up. Changing it signs everyone out.
 - `WARD_DEMO_CODE` (public demo only) is the code `/sign-in` asks for. Josh chose a demo code over
   the open demo of 28 September 2026 ([D-88](decisions.md)). Share it only with people meant to
-  see the demo.
+  see the demo. It must be at least 12 characters, not counting spaces and dashes; a shorter code
+  counts as no code and the demo stays shut (D-145).
 
 With it on, a page without a pass goes to `/sign-in` and an API call gets 401. On the signed-in
 site the pass lasts until the 12-hour sign-in limit and ends at sign-out. A demo code pass lasts 8
diff --git a/docs/ward-flow/decisions.md b/docs/ward-flow/decisions.md
index be204c918..59e985a98 100644
--- a/docs/ward-flow/decisions.md
+++ b/docs/ward-flow/decisions.md
@@ -1747,7 +1747,7 @@ is inferred.
 - **Date:** 11 November 2026 (`2026-11-11`). **Decided by:** Josh, in the Ward Flow project thread "Review repository for issues and new features": "Go ahead with all these recommendations please" (03:55 UTC), answering the review doc "Ward Flow repository review, 11 November 2026". Numbered D-145 because D-133 to D-144 belong to other threads. D-139 is claimed by open PR #1600, D-140 is claimed by open PR #1606, D-141 is claimed by open PR #1606, D-142 is claimed by open PR #1603, D-143 is claimed by open PR #1612, and D-144 is claimed by open PR #1617.
 - **Decision:**
   1. **Clinical display fixes, one held PR:** a ward's expected occupancy no longer counts a patient twice when they hold a named bed and also have a booked planned admission to that ward; an ended legal form says it ended and gives the expiry only as it was typed; the ED screen flags a long wait at 24 hours or more, like every other screen.
-  2. **Non-clinical fixes:** one lapse check for pull holds, staff requests keep the shift the person chose, one reader for typed times, one length-of-stay calculation, a demo code shorter than 12 characters counts as no code (follows once PR #1615 merges, because its tests use a shorter code), and a demo pass stops working when the code changes. Two lines added to the real-data go/no-go list (record ids never built from UMRNs; a check of the push library).
+  2. **Non-clinical fixes:** one lapse check for pull holds, staff requests keep the shift the person chose, one reader for typed times, one length-of-stay calculation, a demo code shorter than 12 characters counts as no code (added after PR #1615 merged; spaces and dashes not counted), and a demo pass stops working when the code changes. Two lines added to the real-data go/no-go list (record ids never built from UMRNs; a check of the push library).
   3. **Features that finish existing screens** (not covered by the D-128 item 9 pause): Leave page links, print and entry point; Help for pages that had none; print and spreadsheet export on Legal forms and Movements. Triage risk reviews due waits until #1564 to #1577 close and needs its own clinical sign-off.
   4. **Code health:** the file line cap counts code lines, not comments or blank lines; one shared CI setup step; shared helpers for the forked side rail; reasons or fixes for unexplained React hook rule switch-offs; patch-level dependency updates.
   5. **Josh's own action:** turn off Supabase open sign-up before real data.
diff --git a/src/lib/front-door-pass.ts b/src/lib/front-door-pass.ts
index 238319794..8dbdcbdb3 100644
--- a/src/lib/front-door-pass.ts
+++ b/src/lib/front-door-pass.ts
@@ -206,15 +206,22 @@ export function passOpensSite(pass: FrontDoorPass, sharedEnabled: boolean): bool
   return pass.kind === "account" || !sharedEnabled;
 }
 
+/** The shortest demo code that opens the site, counted after spaces and dashes are removed. */
+export const DEMO_CODE_MIN_LENGTH = 12;
+
 /** The demo code's own form: capitals, with spaces and dashes ignored, so "ward 7q4k" still opens. */
 function normaliseDemoCode(code: string): string {
   return code.toUpperCase().replace(/[\s-]+/g, "");
 }
 
-/** Whether an entered demo code matches `WARD_DEMO_CODE`. False when no code is set. */
+/**
+ * Whether an entered demo code matches `WARD_DEMO_CODE`. False when no code is set, or when the set
+ * code is shorter than 12 characters (spaces and dashes not counted), so a guessable code never
+ * opens the site (D-145).
+ */
 export async function demoCodeMatches(entered: string, env: Env = process.env): Promise<boolean> {
   const expected = normaliseDemoCode(env.WARD_DEMO_CODE ?? "");
-  if (expected.length < 4) return false;
+  if (expected.length < DEMO_CODE_MIN_LENGTH) return false;
   // Hash both sides, so the comparison takes the same time whatever was typed.
   const digest = async (text: string) =>
     toBase64Url(new Uint8Array(await crypto.subtle.digest("SHA-256", encoder.encode(text))));
diff --git a/tests/front-door-pass.test.ts b/tests/front-door-pass.test.ts
index 96c8d84bc..005740115 100644
--- a/tests/front-door-pass.test.ts
+++ b/tests/front-door-pass.test.ts
@@ -144,10 +144,17 @@ describe("the pass", () => {
 
 describe("demo code", () => {
   it("matches ignoring case, spaces and dashes, and never when no code is set", async () => {
-    expect(await demoCodeMatches("ward 7q4k", { WARD_DEMO_CODE: "WARD-7Q4K" })).toBe(true);
-    expect(await demoCodeMatches("WARD-7Q4J", { WARD_DEMO_CODE: "WARD-7Q4K" })).toBe(false);
+    expect(await demoCodeMatches("ward 7q4k synth", { WARD_DEMO_CODE: "WARD-7Q4K-SYNTH" })).toBe(true);
+    expect(await demoCodeMatches("WARD-7Q4J-SYNTH", { WARD_DEMO_CODE: "WARD-7Q4K-SYNTH" })).toBe(false);
     expect(await demoCodeMatches("", {})).toBe(false);
   });
+
+  it("treats a set code shorter than 12 characters as no code at all", async () => {
+    // Eleven characters once spaces and dashes are removed: too guessable to open the site.
+    expect(await demoCodeMatches("WARD-7Q4K-SYN", { WARD_DEMO_CODE: "WARD-7Q4K-SYN" })).toBe(false);
+    // Exactly twelve opens it.
+    expect(await demoCodeMatches("WARD-7Q4K-SYNT", { WARD_DEMO_CODE: "WARD-7Q4K-SYNT" })).toBe(true);
+  });
 });
 
 describe("proxy front door", () => {
@@ -432,17 +439,17 @@ describe("POST /api/session", () => {
   it("opens the public demo with the right code and pauses after too many wrong ones", async () => {
     vi.stubEnv("WARD_FRONT_DOOR", "required");
     vi.stubEnv("WARD_PASS_SECRET", SECRET);
-    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K");
+    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K-SYNTH");
     vi.stubEnv("NEXT_PUBLIC_WARD_SHARED_ENABLED", "false");
     vi.stubEnv("WARD_TRUSTED_PROXY_ADDRESSES", "*");
-    const right = await POST(post({ demoCode: "ward 7q4k" }, "192.0.2.20"));
+    const right = await POST(post({ demoCode: "ward 7q4k synth" }, "192.0.2.20"));
     expect(right.status).toBe(204);
     expect(right.headers.getSetCookie().find((line) => line.startsWith(FRONT_DOOR_PASS_COOKIE))).toContain(
       `Max-Age=${8 * 3600}`,
     );
     for (let attempt = 0; attempt < 10; attempt += 1)
       expect((await POST(post({ demoCode: "WRONG" }, "192.0.2.30"))).status).toBe(401);
-    expect((await POST(post({ demoCode: "ward 7q4k" }, "192.0.2.30"))).status).toBe(429);
+    expect((await POST(post({ demoCode: "ward 7q4k synth" }, "192.0.2.30"))).status).toBe(429);
   });
 
   it("counts wrong tries by a trusted hop's address, not a caller-written forwarded-for (A4-02)", async () => {
@@ -466,7 +473,7 @@ describe("POST /api/session", () => {
     expect(trustedProxyAddressesFromEnv({})).toEqual([]);
     vi.stubEnv("WARD_FRONT_DOOR", "required");
     vi.stubEnv("WARD_PASS_SECRET", SECRET);
-    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K");
+    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K-SYNTH");
     vi.stubEnv("NEXT_PUBLIC_WARD_SHARED_ENABLED", "false");
     vi.stubEnv("WARD_TRUSTED_PROXY_ADDRESSES", "*");
     for (let attempt = 0; attempt < 10; attempt += 1)
@@ -477,7 +484,7 @@ describe("POST /api/session", () => {
   it("keeps per-address keying while no trusted proxy is configured (D-147)", async () => {
     vi.stubEnv("WARD_FRONT_DOOR", "required");
     vi.stubEnv("WARD_PASS_SECRET", SECRET);
-    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K");
+    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K-SYNTH");
     vi.stubEnv("NEXT_PUBLIC_WARD_SHARED_ENABLED", "false");
     vi.stubEnv("WARD_TRUSTED_PROXY_ADDRESSES", "");
     for (let attempt = 0; attempt < 10; attempt += 1)
@@ -485,42 +492,42 @@ describe("POST /api/session", () => {
     expect((await POST(post({ demoCode: "WRONG" }, "192.0.2.70"))).status).toBe(429);
     // Another address keeps its own budget, so one guesser cannot refuse every presenter.
     expect((await POST(post({ demoCode: "WRONG" }, "192.0.2.71"))).status).toBe(401);
-    expect((await POST(post({ demoCode: "ward 7q4k" }, "192.0.2.72"))).status).toBe(204);
+    expect((await POST(post({ demoCode: "ward 7q4k synth" }, "192.0.2.72"))).status).toBe(204);
   });
 
   it("ignores a caller-sent address once a trusted proxy is configured but the socket is not it (A4-02)", async () => {
     vi.stubEnv("WARD_FRONT_DOOR", "required");
     vi.stubEnv("WARD_PASS_SECRET", SECRET);
-    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K");
+    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K-SYNTH");
     vi.stubEnv("NEXT_PUBLIC_WARD_SHARED_ENABLED", "false");
     vi.stubEnv("WARD_TRUSTED_PROXY_ADDRESSES", "10.0.0.2");
     for (let attempt = 0; attempt < 10; attempt += 1)
       expect((await POST(post({ demoCode: "WRONG" }, `198.51.100.${attempt}`))).status).toBe(401);
     // Rotating X-Real-IP does not open a new bucket: every request shares "unknown".
     expect((await POST(post({ demoCode: "WRONG" }, "192.0.2.99"))).status).toBe(429);
-    expect((await POST(post({ demoCode: "ward 7q4k" }, "192.0.2.98"))).status).toBe(429);
+    expect((await POST(post({ demoCode: "ward 7q4k synth" }, "192.0.2.98"))).status).toBe(429);
   });
 
   it("refuses wrong codes once tries across all addresses reach the cap, but still opens with the right code", async () => {
     vi.stubEnv("WARD_FRONT_DOOR", "required");
     vi.stubEnv("WARD_PASS_SECRET", SECRET);
-    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K");
+    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K-SYNTH");
     vi.stubEnv("NEXT_PUBLIC_WARD_SHARED_ENABLED", "false");
     vi.stubEnv("WARD_TRUSTED_PROXY_ADDRESSES", "*");
     for (let attempt = 0; attempt < 200; attempt += 1)
       expect((await POST(post({ demoCode: "WRONG" }, `10.0.${attempt >> 8}.${attempt & 255}`))).status).toBe(401);
     expect((await POST(post({ demoCode: "WRONG" }, "192.0.2.61"))).status).toBe(429);
-    expect((await POST(post({ demoCode: "ward 7q4k" }, "192.0.2.60"))).status).toBe(204);
+    expect((await POST(post({ demoCode: "ward 7q4k synth" }, "192.0.2.60"))).status).toBe(204);
     // The per-address limit still applies at the cap.
     for (let attempt = 0; attempt < 9; attempt += 1)
       expect((await POST(post({ demoCode: "WRONG" }, "192.0.2.61"))).status).toBe(429);
-    expect((await POST(post({ demoCode: "ward 7q4k" }, "192.0.2.61"))).status).toBe(429);
+    expect((await POST(post({ demoCode: "ward 7q4k synth" }, "192.0.2.61"))).status).toBe(429);
   });
 
   it("checks the code before a full address table refuses, so the right code from a new address opens (M53)", async () => {
     vi.stubEnv("WARD_FRONT_DOOR", "required");
     vi.stubEnv("WARD_PASS_SECRET", SECRET);
-    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K");
+    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K-SYNTH");
     vi.stubEnv("NEXT_PUBLIC_WARD_SHARED_ENABLED", "false");
     vi.stubEnv("WARD_TRUSTED_PROXY_ADDRESSES", "*");
     // Fill the 5,000-address table with wrong tries 9.5 minutes ago, so each is still counted while
@@ -532,7 +539,7 @@ describe("POST /api/session", () => {
       expect(reserveDemoTry(address(index), opened + 60_000)).not.toBeNull();
     first?.release();
     expect(reserveDemoTry(address(4_999), opened + 60_000)).not.toBeNull();
-    expect((await POST(post({ demoCode: "ward 7q4k" }, "192.0.2.70"))).status).toBe(204);
+    expect((await POST(post({ demoCode: "ward 7q4k synth" }, "192.0.2.70"))).status).toBe(204);
     // The table being full still pauses a wrong code from a new address, without forgetting anyone.
     expect((await POST(post({ demoCode: "WRONG" }, "192.0.2.71"))).status).toBe(429);
     expect(reserveDemoTry(address(0), Date.now())).toMatchObject({ overCap: false });
@@ -541,7 +548,7 @@ describe("POST /api/session", () => {
   it("never opens the signed-in site with a demo code", async () => {
     vi.stubEnv("WARD_FRONT_DOOR", "required");
     vi.stubEnv("WARD_PASS_SECRET", SECRET);
-    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K");
+    vi.stubEnv("WARD_DEMO_CODE", "WARD-7Q4K-SYNTH");
     vi.stubEnv("NEXT_PUBLIC_WARD_SHARED_ENABLED", "true");
     expect((await POST(post({ demoCode: "WARD-7Q4K" }))).status).toBe(400);
   });

From b86757ce71f1f93e42af90446b048482df3f4e27 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 09:49:01 +0000
Subject: [PATCH 35/40] Keep the demo code minimum private to the front door

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 src/lib/front-door-pass.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/front-door-pass.ts b/src/lib/front-door-pass.ts
index 8dbdcbdb3..6dade888e 100644
--- a/src/lib/front-door-pass.ts
+++ b/src/lib/front-door-pass.ts
@@ -207,7 +207,7 @@ export function passOpensSite(pass: FrontDoorPass, sharedEnabled: boolean): bool
 }
 
 /** The shortest demo code that opens the site, counted after spaces and dashes are removed. */
-export const DEMO_CODE_MIN_LENGTH = 12;
+const DEMO_CODE_MIN_LENGTH = 12;
 
 /** The demo code's own form: capitals, with spaces and dashes ignored, so "ward 7q4k" still opens. */
 function normaliseDemoCode(code: string): string {

From c0fa5ce31dc61f19d15a896f2d2905607561c3d4 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 10:35:00 +0000
Subject: [PATCH 36/40] Raise the Home phone limit by 0.6 KB after merging main

Hosted CI measured 580.8 KB against 580.5.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01J352nkwW4xTv5Ftznofb8N
---
 .../2026-11-11-pr1623-repository-review.md                      | 2 ++
 script-budget.json                                              | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
index 97e034bd1..17b70d86f 100644
--- a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
+++ b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
@@ -15,3 +15,5 @@ Then (PR head `9c7302e`, merged with main `c21e99a`): ED `/ward-flow/ed` raised
 Merged again with main `cc755fa`, which raised every route: the same three raises sit on main's values, so ED is 537.8 + 0.3 = 538.1, movements 612.6 + 0.5 = 613.1 and statistics 635.1 + 0.3 = 635.4.
 
 Merged again after #1607 and #1628 (main `daacf218e`): main's values taken, plus this PR's deltas, giving ED 538.8, Movements 613.6 and Statistics 636.0.
+
+Then Home `/ward-flow` raised 580.5 to 581.1: hosted CI measured 580.8 KB on this merge (head `1190d68`), 0.3 KB over main's value. Main alone could not be measured because this PR changes dependencies. The likely source is the same shared helpers plus the new "leave" search entry; this was not measured route by route. Well within the 5 KB allowance.
diff --git a/script-budget.json b/script-budget.json
index bcbe8d634..8f805acea 100644
--- a/script-budget.json
+++ b/script-budget.json
@@ -1,7 +1,7 @@
 {
   "$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": 580.5,
+    "/ward-flow": 581.1,
     "/ward-flow/referrals": 586.9,
     "/ward-flow/ed": 538.8,
     "/ward-flow/ward/rph-adult-secure": 616.8,

From cdfce262a3aa29144dc2e0405b0bb9bfe74fa4e3 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 17:50:59 +0000
Subject: [PATCH 37/40] Carry #1631's mirror-free browser setup so CI can run
 during the outage

Brings PR #1631's browser system-package change (a5dd0ff6b) into this
branch: Chromium and WebKit system packages install from the cached
archive, so the browser jobs no longer need the Ubuntu mirror, which is
down. The workflow hunk is applied by hand on top of this branch's
ward-setup action change; the script and its test match #1631 exactly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GxPPxn8xZAWHw5dJPGdUjY
---
 .github/workflows/ward-flow.yml             | 17 ++++--
 scripts/ward-ci-public/install-chromium.mjs | 59 ++++++++++++++++++++-
 tests/ward-browser-install.test.ts          | 48 +++++++++++++++++
 3 files changed, 119 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/ward-flow.yml b/.github/workflows/ward-flow.yml
index 47766dd58..4658c4695 100644
--- a/.github/workflows/ward-flow.yml
+++ b/.github/workflows/ward-flow.yml
@@ -365,15 +365,26 @@ jobs:
       - name: Seed release system packages
         if: ${{ !cancelled() && steps.install.outcome == 'success' && steps.backend-install.outcome == 'success' }}
         run: node scripts/ward-ci-public/apt-archive-cache.mjs seed "$HOME/.cache/ward-release-apt"
+      # WebKit's own packages too, so the offline install covers both engines when the mirror is down.
+      # Same path as the save step, because the path is part of the cache version.
+      - name: Restore release WebKit system packages
+        if: ${{ !cancelled() && steps.install.outcome == 'success' && steps.backend-install.outcome == 'success' }}
+        uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9
+        with:
+          path: ~/.cache/ward-release-apt
+          key: ward-release-apt-${{ runner.os }}-webkit-${{ steps.shared-version.outputs.version }}-${{ steps.shared-version.outputs.image }}
+          restore-keys: |
+            ward-release-apt-${{ runner.os }}-webkit-${{ steps.shared-version.outputs.version }}-
+      - name: Seed release WebKit system packages
+        if: ${{ !cancelled() && steps.install.outcome == 'success' && steps.backend-install.outcome == 'success' }}
+        run: node scripts/ward-ci-public/apt-archive-cache.mjs seed "$HOME/.cache/ward-release-apt"
       - name: Install Chromium and WebKit for the shared-mode journeys
         id: shared-chromium
         timeout-minutes: 10
         if: ${{ !cancelled() && steps.install.outcome == 'success' && steps.backend-install.outcome == 'success' }}
         env:
           PLAYWRIGHT_CACHE_HIT: ${{ steps.shared-cache.outputs.cache-hit }}
-        run: |
-          node scripts/ward-ci-public/install-chromium.mjs
-          node node_modules/playwright/cli.js install --with-deps webkit
+        run: node scripts/ward-ci-public/install-chromium.mjs chromium webkit
       - name: Run the shared-mode browser journey
         timeout-minutes: 20
         if: ${{ !cancelled() && steps.shared-chromium.outcome == 'success' }}
diff --git a/scripts/ward-ci-public/install-chromium.mjs b/scripts/ward-ci-public/install-chromium.mjs
index cdaa7da06..e88a3d9af 100644
--- a/scripts/ward-ci-public/install-chromium.mjs
+++ b/scripts/ward-ci-public/install-chromium.mjs
@@ -1,6 +1,8 @@
 import { spawnSync } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { resolve } from "node:path";
+import { join, resolve } from "node:path";
+import { APT_ARCHIVES } from "./apt-archive-cache.mjs";
 
 const root = fileURLToPath(new URL("../../", import.meta.url));
 const cli = resolve(root, "node_modules/playwright/cli.js");
@@ -21,7 +23,10 @@ export function waitForPackageManager(deadline, now = Date.now) {
 
 /**
  * Six-minute shared budget, two attempts per operation; the workflow adds an eight-minute outer bound.
- * @param {{ browsers?: string[], cacheHit?: boolean, execute?: (command: string, args: string[], timeoutMs: number) => { status: number | null, error?: { code?: string }, signal?: string | null }, now?: () => number, log?: (message: string) => void, waitForIdle?: (deadline: number) => void }} options
+ * When the seed step has left cached system packages in apt's archive folder, they are installed
+ * first with no network at all, then each browser must launch; only if that fails does the setup
+ * fall back to Playwright's own apt-get, which needs the runner's Ubuntu mirror.
+ * @param {{ browsers?: string[], cacheHit?: boolean, cachedDebs?: string[], execute?: (command: string, args: string[], timeoutMs: number) => { status: number | null, error?: { code?: string }, signal?: string | null }, now?: () => number, log?: (message: string) => void, waitForIdle?: (deadline: number) => void }} options
  */
 export function installBrowsers({
   browsers = ["chromium"],
@@ -30,6 +35,7 @@ export function installBrowsers({
   now = Date.now,
   log = console.log,
   waitForIdle = execute === runBounded ? (deadline) => waitForPackageManager(deadline, now) : () => {},
+  cachedDebs = execute === runBounded ? archiveDebs() : [],
 } = {}) {
   if (
     !browsers.length ||
@@ -39,6 +45,7 @@ export function installBrowsers({
     throw new Error("Invalid browser selection; name unique supported engines");
   const label = browsers.length === 1 && browsers[0] === "chromium" ? "Chromium" : "Playwright browser";
   const deadline = now() + 360_000;
+  if (cachedDebs.length && installOffline({ browsers, cachedDebs, execute, now, deadline, label, log }) === 0) return 0;
   const operations = cacheHit
     ? [
         ["install-deps", ...browsers],
@@ -67,6 +74,54 @@ export function installBrowsers({
   return 0;
 }
 
+/** The cached .deb files the seed step copied in; none when the cache missed. */
+export function archiveDebs(dir = APT_ARCHIVES) {
+  return existsSync(dir)
+    ? readdirSync(dir)
+        .filter((name) => name.endsWith(".deb"))
+        .sort()
+        .map((name) => join(dir, name))
+    : [];
+}
+
+/** A fixed script; the Playwright path and the engine names arrive as arguments, never as code. */
+const LAUNCH_PROBE = `const [playwright, ...names] = process.argv.slice(1);
+const pw = require(playwright);
+(async () => {
+  for (const name of names) {
+    const browser = await pw[name].launch();
+    await browser.close();
+  }
+})().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});`;
+
+/**
+ * The runner's Ubuntu mirror can be unreachable for hours (11 Nov 2026: "Temporary failure
+ * resolving 'azure.archive.ubuntu.com'"), and Playwright's install-deps always runs apt-get update
+ * first. Install the cached packages as local files with downloads switched off, fetch the browsers
+ * alone, and pass only if every browser launches. Any failure hands back to the online path.
+ */
+function installOffline({ browsers, cachedDebs, execute, now, deadline, label, log }) {
+  log(`${label} setup: installing ${cachedDebs.length} cached system packages without the network.`);
+  const steps = [
+    ["sudo", ["apt-get", "install", "-y", "--no-download", "--no-install-recommends", ...cachedDebs], 120_000],
+    [process.execPath, [cli, "install", ...browsers], 120_000],
+    [process.execPath, ["-e", LAUNCH_PROBE, resolve(root, "node_modules/playwright"), ...browsers], 60_000],
+  ];
+  for (const [command, args, limit] of steps) {
+    const remaining = deadline - now();
+    const result = remaining > 0 ? execute(command, args, Math.min(limit, remaining)) : undefined;
+    if (!result || result.error || result.status !== 0) {
+      log(`${label} setup: the offline install did not finish; trying the runner's apt mirror.`);
+      return 1;
+    }
+  }
+  log(`${label} setup: installed from cached system packages; every browser launches.`);
+  return 0;
+}
+
 // Existing consumers retain their default Chromium-only command and retry budget.
 /** Compatibility entry point for callers requesting Chromium only. @param {Parameters<typeof installBrowsers>[0]} [options] */
 export function installChromium(options) {
diff --git a/tests/ward-browser-install.test.ts b/tests/ward-browser-install.test.ts
index 7d5bbcb3b..58159bff7 100644
--- a/tests/ward-browser-install.test.ts
+++ b/tests/ward-browser-install.test.ts
@@ -34,6 +34,54 @@ describe("bounded release browser setup", () => {
     ]);
   });
 
+  it("installs cached system packages without the network and stops once every browser launches", () => {
+    const commands: string[][] = [];
+    expect(
+      installChromium({
+        browsers: ["chromium", "webkit"],
+        cacheHit: true,
+        cachedDebs: ["/var/cache/apt/archives/a.deb", "/var/cache/apt/archives/b.deb"],
+        log: () => {},
+        execute(command, args) {
+          commands.push([command, ...args]);
+          return { status: 0 };
+        },
+      }),
+    ).toBe(0);
+    expect(commands).toHaveLength(3);
+    expect(commands[0]).toEqual([
+      "sudo",
+      "apt-get",
+      "install",
+      "-y",
+      "--no-download",
+      "--no-install-recommends",
+      "/var/cache/apt/archives/a.deb",
+      "/var/cache/apt/archives/b.deb",
+    ]);
+    expect(commands[1].slice(2)).toEqual(["install", "chromium", "webkit"]);
+    expect(commands[2][1]).toBe("-e");
+    expect(commands[2].slice(-2)).toEqual(["chromium", "webkit"]);
+    expect(commands.flat()).not.toContain("install-deps");
+    expect(commands.flat()).not.toContain("--with-deps");
+  });
+
+  it("falls back to the apt mirror when a browser does not launch after the offline install", () => {
+    const commands: string[][] = [];
+    expect(
+      installChromium({
+        cachedDebs: ["/var/cache/apt/archives/a.deb"],
+        log: () => {},
+        execute(command, args) {
+          commands.push([command, ...args]);
+          return { status: args[0] === "-e" ? 1 : 0 };
+        },
+      }),
+    ).toBe(0);
+    expect(commands).toHaveLength(4);
+    expect(commands[3].slice(2)).toEqual(["install", "--with-deps", "chromium"]);
+  });
+
   it("refuses an unsupported or empty engine selection without invoking a command", () => {
     const execute = () => {
       throw new Error("must not start an installation");

From cd18d4af20f714fef56c7fe566feb658a7c66e3e Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 21:28:14 +0000
Subject: [PATCH 38/40] Raise the expected-reds file floor to 1300 after the
 suite passed 2,400 files

The merge took the ward test population to 2,402 files, so the 1200 floor fell
below half of it and the manifest's own headroom test failed in unit shard 1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GxPPxn8xZAWHw5dJPGdUjY
---
 scripts/check-ward-expected-reds.mjs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/scripts/check-ward-expected-reds.mjs b/scripts/check-ward-expected-reds.mjs
index a289cc544..43126ac81 100644
--- a/scripts/check-ward-expected-reds.mjs
+++ b/scripts/check-ward-expected-reds.mjs
@@ -74,7 +74,8 @@ const MIN_FILE_SECONDS = 0.1;
 // 1,530 files and 16,600 tests). The test floor stays lower than the file floor because a shard's
 // floors scale by its share of files, and shards differ in tests per file.
 // 4 Nov 2026: raised from 1000 when the population passed 2,000 files and 1000 fell below half of it.
-const FLOOR_FILES = 1200;
+// 11 Nov 2026: raised from 1200 when the population passed 2,400 files and 1200 fell below half of it.
+const FLOOR_FILES = 1300;
 const FLOOR_TESTS = 6000;
 
 /**

From a867ee3e7a1a846aa19495989254b0a60d143a4f Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 11 Nov 2026 21:43:34 +0000
Subject: [PATCH 39/40] Raise Referrals phone limit 0.4 KB after merging #1608

Hosted CI measured 593.5 KB against main's 593.4 KB limit. Reason recorded in
the PR's script-budget history file; well within the 5 KB allowance.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GxPPxn8xZAWHw5dJPGdUjY
---
 .../2026-11-11-pr1623-repository-review.md                      | 2 ++
 script-budget.json                                              | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
index 9214f62e1..cabf6f455 100644
--- a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
+++ b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
@@ -21,3 +21,5 @@ Then Home `/ward-flow` raised 580.5 to 581.1: hosted CI measured 580.8 KB on thi
 Merged again after #1603 (main `30abc7aee`): main's values taken, plus this PR's deltas, giving Home 584.1, ED 540.9, Movements 615.8 and Statistics 638.3.
 
 Merged again after #1624 and #1629 (main `51a474537`, which raised the ward route to 622.0): main's values taken, plus this PR's deltas, giving Home 584.1, ED 540.9, Movements 615.8 and Statistics 638.3. Main left those four routes unchanged since the last merge, so the totals are the same.
+
+Merged again after #1608 (main `0e2478133`): main's values taken, plus this PR's deltas, giving Home 586.6, ED 543.1, Movements 618.4 and Statistics 640.6. Then Referrals `/ward-flow/referrals` raised 593.4 to 593.8: hosted CI measured 593.5 KB on this merge (head `54dd212f6`), 0.1 KB over main's value. Main alone could not be measured because this PR changes dependencies. The likely source is the same shared helpers (typed-time reader, pull-hold lapse check) now also loaded by Referrals; this was not measured route by route. Same trim reasoning as above, and well within the 5 KB allowance.
diff --git a/script-budget.json b/script-budget.json
index f0c1b8922..591c88161 100644
--- a/script-budget.json
+++ b/script-budget.json
@@ -2,7 +2,7 @@
   "$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": 586.6,
-    "/ward-flow/referrals": 593.4,
+    "/ward-flow/referrals": 593.8,
     "/ward-flow/ed": 543.1,
     "/ward-flow/ward/rph-adult-secure": 625.4,
     "/ward-flow/movements/WF-001": 618.4,

From a66a1a3ac2f8a8947efa77ef56447d7562e8a8c0 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 12 Nov 2026 00:04:49 +0000
Subject: [PATCH 40/40] Raise three phone size limits to CI's measurement plus
 0.5 KB

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GxPPxn8xZAWHw5dJPGdUjY
---
 .../2026-11-11-pr1623-repository-review.md                  | 2 ++
 script-budget.json                                          | 6 +++---
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
index 079118c5f..4d449f14c 100644
--- a/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
+++ b/docs/script-budget-history/2026-11-11-pr1623-repository-review.md
@@ -27,3 +27,5 @@ Merged again after #1608 (main `0e2478133`): main's values taken, plus this PR's
 Merged again after #1606 (main `0b657ad3f`): main's values taken, plus this PR's deltas, giving Home 588.3, Referrals 594.7, ED 543.7, Movements 619.2 and Statistics 640.8.
 
 Merged again after #1632 (main `02817bbd6`, which raised six routes): main's values taken, plus this PR's deltas, giving Home 588.9, Referrals 594.7, ED 544.2, Movements 619.5 and Statistics 641.3.
+
+Hosted CI on that merge (head `986e9dfa9`) measured, in KB: Home 589.2, Movements 619.8 and Capacity 666.4, and `main` alone could not be built, so it could not be compared. Builds vary by a few tenths, so these three limits are now the measurement plus 0.5: Home 589.7 (+1.4 over `main`), Movements 620.3 (+1.3) and Capacity 666.9 (+1.0), each within the 5 KB allowance.
diff --git a/script-budget.json b/script-budget.json
index b03947774..0f196337f 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": 588.9,
+    "/ward-flow": 589.7,
     "/ward-flow/referrals": 594.7,
     "/ward-flow/ed": 544.2,
     "/ward-flow/ward/rph-adult-secure": 625.4,
-    "/ward-flow/movements/WF-001": 619.5,
-    "/ward-flow/capacity": 665.9,
+    "/ward-flow/movements/WF-001": 620.3,
+    "/ward-flow/capacity": 666.9,
     "/ward-flow/ed/arm-ed": 678.1,
     "/ward-flow/bed-meeting": 600.7,
     "/ward-flow/statistics": 641.3