ENG-2812: Add agent briefing banner to dashboard

[kruulik]

Ticket ENG-2812

Description Of Changes

Add an agent briefing banner to the new dashboard that displays a severity-based alert with actionable quick links. The banner integrates with the agent briefing API endpoint, shows contextual alert styling (error/warning/info) based on the highest-severity quick action, and can be dismissed by the user.

Also refactors the QuickAction type to use label, action_type, action_data, and severity fields for better alignment with the API contract.

Code Changes

• clients/admin-ui/src/features/dashboard/types.ts - Export QuickAction interface and update field names (label, action_type, action_data, severity)
• clients/admin-ui/src/home/AgentBriefingBanner.module.scss - New styles for the alert banner and severity-colored quick action links
• clients/admin-ui/src/home/AgentBriefingBanner.tsx - New component: severity-based Ant Design Alert with quick action navigation links
• clients/admin-ui/src/home/HomeDashboard.tsx - Integrate AgentBriefingBanner with useGetAgentBriefingQuery and dismissible state
• clients/admin-ui/src/mocks/dashboard/data.ts - Add mock agent briefing response data
• clients/admin-ui/src/mocks/dashboard/handlers.ts - Add MSW handler for agent briefing endpoint

Steps to Confirm

1. Enable the alphaDashboard feature flag
2. Navigate to the home dashboard
3. Verify the agent briefing banner appears at the top with mock data
4. Verify the alert type matches the highest severity quick action (error for critical/high)
5. Click a quick action link and verify it navigates to the correct route
6. Close the banner and verify it is dismissed

Pre-Merge Checklist

• Issue requirements met
• All CI pipelines succeeded
• CHANGELOG.md updated
  • Add a db-migration This indicates that a change includes a database migration label to the entry if your change includes a DB migration
  • Add a high-risk This issue suggests changes that have a high-probability of breaking existing code label to the entry if your change includes a high-risk change (i.e. potential for performance impact or unexpected regression) that should be flagged
  • Updates unreleased work already in Changelog, no new entry necessary
• UX feedback:
  • All UX related changes have been reviewed by a designer
  • No UX review needed
• Followup issues:
  • Followup issues created
  • No followup issues
• Database migrations:
  • No migrations
• Documentation:
  • No documentation updates required

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
fides-plus-nightly	Ready	Preview, Comment	Mar 18, 2026 5:37am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
fides-privacy-center	Ignored		Mar 18, 2026 5:37am

[greptile-apps]

Greptile Summary

This PR adds an AgentBriefingBanner component to the new dashboard that displays a severity-driven Ant Design Alert with dismissable state persisted to sessionStorage and quick-action navigation links, backed by a new useGetAgentBriefingQuery RTK Query endpoint and MSW mock. The refactored QuickAction type aligns cleanly with the expected API contract.

Two issues need attention before merging:

• Runtime crash risk (AgentBriefingBanner.tsx): ACTION_CTA[action.action_type] is accessed unconditionally and cta.route(...) is called without any null guard. The TODO comment acknowledges the guard is missing, but an unknown action_type from the real API will throw TypeError and crash the component. A simple early return null when cta is undefined should be added now.
• SSR safety (HomeDashboard.tsx): sessionStorage is accessed synchronously inside the useState initializer, which will throw ReferenceError: sessionStorage is not defined during Next.js server-side rendering. The read should be moved into a useEffect to ensure it only runs client-side.

Confidence Score: 2/5

• Not safe to merge — contains a likely runtime crash and an SSR compatibility issue.
• The unchecked ACTION_CTA lookup in AgentBriefingBanner.tsx will throw at runtime when the real API returns any action type not currently in the map, crashing the component. The direct sessionStorage access in the useState initializer in HomeDashboard.tsx will also throw during SSR in Next.js. Both are straightforward fixes, but they need to land before this ships to production.
• clients/admin-ui/src/home/AgentBriefingBanner.tsx and clients/admin-ui/src/home/HomeDashboard.tsx

Important Files Changed

Filename	Overview
clients/admin-ui/src/home/AgentBriefingBanner.tsx	New component rendering an Alert with quick action links; contains a potential null-dereference crash when ACTION_CTA doesn't contain an entry for an action_type.
clients/admin-ui/src/home/HomeDashboard.tsx	Integrates AgentBriefingBanner with dismissal persisted to sessionStorage; direct sessionStorage access in useState initializer may throw in SSR environments.
clients/admin-ui/src/features/dashboard/types.ts	QuickAction interface refactored and exported with new field names aligned to API contract; straightforward and correct.
clients/admin-ui/src/home/AgentBriefingBanner.module.scss	New SCSS module providing alert size and severity-colored link styles; no issues found.
clients/admin-ui/src/mocks/dashboard/data.ts	Adds mock AgentBriefingResponse data with two quick actions; correctly uses the updated QuickAction shape.
clients/admin-ui/src/mocks/dashboard/handlers.ts	Adds MSW handler for the agent-briefing endpoint returning mock data; straightforward addition.
changelog/7675-dashboard-agent-briefing.yaml	Changelog entry for the new agent briefing banner feature; no issues.

_{Last reviewed commit: 9db6052}

[gilluminate]

LGTM