> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Regulatory Changes

> Monitor and review detected regulatory content changes from watched sources, with status tabs and a detail view for approve or dismiss decisions.

The Regulatory Changes page displays a feed of regulatory content changes detected from monitored sources, organized by status tabs. It is located at route `/gr/compliance/regulatory-changes`.

## Overview

The page is rendered by `RegulatoryChangesPage` and uses `useRegulatoryChangeEvents` to fetch changes, with optional status filter. Tabs correspond to statuses: **All**, **New** (`detected`), **Under Review**, **Approved**, **Dismissed**. Each tab shows a badge count. Severity is displayed via `RegulatoryChangeSeverityBadge`; status via `RegulatoryChangeStatusBadge`. Selecting a row navigates to the regulatory change detail page. The route is protected by `GR_PERMISSIONS.REGULATORY_CHANGE_VIEW` (`gr.compliance.regulatory_change.view`).

## Who it's for

Requires permission: `gr.compliance.regulatory_change.view`

## Before you start

* Regulatory sources must be registered at `/gr/compliance/regulatory-sources` before changes will be detected.
* Sources are polled on their configured cadence; newly detected items appear under **New**.

## Finding a change

1. Go to **Governance & Compliance → Compliance → Regulatory Changes** at `/gr/compliance/regulatory-changes`.
2. Select a status tab (**New**, **Under Review**, etc.) to filter the feed.
3. Review severity badges to prioritize review.
4. Select a row to open the Regulatory Change Detail page.
5. Approved or dismissed changes are updated by users with the appropriate permission.

| Concept      | Description                                        |
| ------------ | -------------------------------------------------- |
| Detected     | A newly identified content change not yet reviewed |
| Under review | Change is being assessed by the compliance team    |
| Approved     | Change has been acknowledged and actioned          |
| Dismissed    | Change was reviewed and deemed non-material        |

## Viewing a change

The Change Details page (`/gr/compliance/regulatory-changes/:id`) displays the full detail of a single detected regulatory change event. Requires `gr.compliance.regulatory_change.view`. The Approve/Dismiss action is additionally gated by `gr.compliance.regulatory_change.approve`.

The page loads a single regulatory change event via `useRegulatoryChangeEvent`. The header shows the event title, detected timestamp, and a `Radar` icon. The page displays a severity badge (`RegulatoryChangeSeverityBadge`), a status badge (`RegulatoryChangeStatusBadge`), and an alert with classification rationale. A per-impact list is shown. When the event has status `detected` or `under_review`, users with `gr.compliance.regulatory_change.approve` see **Approve** and **Dismiss** buttons, which open `RegulatoryChangeReviewSheet` with the corresponding decision pre-set.

Before you start: the change event must exist and be in status `detected` or `under_review` for the approve/dismiss actions to appear.

1. From `/gr/compliance/regulatory-changes`, click a change event to navigate to its detail page.
2. Check the title, detection date, severity, and status.
3. Read the classification rationale and per-impact list.
4. If you have `gr.compliance.regulatory_change.approve` and the event is open, click **Approve** or **Dismiss** to open the review sheet and record your decision.

**Status `detected`** — newly identified change, not yet reviewed.

**Status `under_review`** — change is being evaluated.

**Approve** — decision value `'approved'` passed to `RegulatoryChangeReviewSheet`.

**Dismiss** — decision value `'dismissed'` passed to `RegulatoryChangeReviewSheet`.

## Related

<Columns cols={2}>
  <Card title="Governance & Compliance" icon="scale-balanced" href="/gr/overview">
    Governance & Compliance core overview.
  </Card>

  <Card title="Governance & parity" icon="clipboard-check" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/gr.tsx
  * src/cores/gr/pages/RegulatoryChangesPage.tsx
  * src/cores/gr/pages/RegulatoryChangeDetailPage.tsx
  * src/cores/gr/hooks/useRegulatoryChangeEvents.ts
  * src/platform/permissions/constants.ts
</Accordion>