corvix.dashboarding

Dashboard query helpers shared across presentation layers.

Classes

DashboardItem	JSON-friendly notification item for UI rendering.
DashboardGroup	A dashboard group such as repository or reason.
DashboardData	Full dashboard payload for web and CLI presentation.
DashboardSummary	Snapshot metadata used by the dashboard shell.

Functions

build_dashboard_data(→ DashboardData)	Select, sort, group, and serialize records for a dashboard.
_included_by_dashboard(→ bool)
_group_records(→ dict[str, ...)
_build_summary(→ DashboardSummary)

Module Contents

class corvix.dashboarding.DashboardItem

JSON-friendly notification item for UI rendering.

account_id: str

account_label: str

thread_id: str

repository: str

reason: str

subject_type: str

subject_title: str

unread: bool

updated_at: str

score: float

web_url: str | None = None

matched_rules: list[str] = []

actions_taken: list[str] = []

classmethod from_record(record: corvix.domain.NotificationRecord) → DashboardItem

Create a UI item from a stored notification record.

class corvix.dashboarding.DashboardGroup

A dashboard group such as repository or reason.

name: str

items: list[DashboardItem]

class corvix.dashboarding.DashboardData

Full dashboard payload for web and CLI presentation.

name: str

include_read: bool

sort_by: str

descending: bool

generated_at: str | None

groups: list[DashboardGroup]

total_items: int

summary: DashboardSummary

class corvix.dashboarding.DashboardSummary

Snapshot metadata used by the dashboard shell.

unread_items: int

read_items: int

group_count: int

repository_count: int

reason_count: int

corvix.dashboarding.build_dashboard_data(records: list[corvix.domain.NotificationRecord], dashboard: corvix.config.DashboardSpec, generated_at: datetime.datetime | None = None, now: datetime.datetime | None = None) → DashboardData

Select, sort, group, and serialize records for a dashboard.

corvix.dashboarding._included_by_dashboard(record: corvix.domain.NotificationRecord, dashboard: corvix.config.DashboardSpec, now: datetime.datetime) → bool

corvix.dashboarding._group_records(records: list[corvix.domain.NotificationRecord], group_by: str) → dict[str, list[corvix.domain.NotificationRecord]]

corvix.dashboarding._build_summary(sorted_records: list[corvix.domain.NotificationRecord], groups: list[DashboardGroup]) → DashboardSummary