How to Use the Display Integrity Tab (Roster Health)

Display Integrity Tab

The Display Integrity tab in the Roster Health modal scans the currently loaded grid and identifies assignments that are visible in one view but hidden in another. It runs entirely client-side — no extra data is loaded.

How to access

1. Go to The Living Roster (Sidebar → The Living Roster)
2. Click Roster Health to open the modal
3. Click the Display Integrity tab

Issue categories

Invalid UTC timestamp (admin-fixable, red badge) The assignment has a bare "HH:MM" value in its UTC time fields instead of a full ISO datetime. This causes the staff member's iCal subscription (Outlook, Apple Calendar, Google Calendar) to silently drop the shift — the shift won't appear in their external calendar even though it shows on the roster.

• To fix: Click the green Fix all N issues button. The system re-derives the correct UTC from the shift pattern's start/end times, the assignment date, and the organisation timezone. A toast confirms how many were repaired.
• These rows come from a legacy vacancy-request bug closed in May 2026. All new assignments are written correctly.

Override marker drift (developer escalation, red badge) The assignment has the OPEN_VACANCY_EXTENSION: override marker in its text field but the isCraftGroupOverride boolean is false. The Shift View filter reads the boolean, so the staff member may appear in Staff View but not in Shift View.

• To fix: Run the backfill script scripts/backfill-extension-isCraftGroupOverride.js (developer action). Click Copy developer report to send context to your developer.

Stream drift (developer escalation, red badge) The assignment's stream ID disagrees with its shift pattern's stream ID. Causes ghost behaviour — the assignment shows in stream-filtered admin views but not others.

• Click Copy developer report to escalate.

Staff View / Shift View mismatch (developer escalation, amber badge) An assignment is visible in the Staff View but not counted in the Shift View coverage bar for an unrecognised reason.

• Click Copy developer report to escalate.

L5 / My Shifts mismatch (developer escalation, amber badge) The admin's L5 grid shows a CONFIRMED assignment that the staff member would not see in their My Shifts page.

• Click Copy developer report to escalate.

Escalation badges

• Green "admin" badge — you can fix it with the one-click button
• Grey "developer" badge — requires a developer to run a script; use Copy developer report to send structured context

Tip: Zero issues = the three primary roster views are all in agreement. Aim to resolve any "Invalid UTC timestamp" issues before the next iCal sync window (usually nightly).