plexus.reports.blocks.scorecard_history module

class plexus.reports.blocks.scorecard_history.ScorecardHistory(config: Dict[str, Any], params: Dict[str, Any] | None, api_client: PlexusDashboardClient)

Bases: BaseReportBlock

Report block summarizing featured ScoreVersion changes over a date window.

Scope: - scorecard only: all scores on the scorecard - scorecard + score/score_id: a single score on the scorecard

DEFAULT_DAYS = 30

DEFAULT_DESCRIPTION: str | None = 'Featured score-version changes and champion promotion status'

DEFAULT_NAME: str | None = 'Scorecard History'

REQUIRED_SUMMARY_SECTION_HEADINGS = ('What changed', 'Guideline / rubric changes', 'Scoring behavior changes', 'Questions for SMEs / stakeholders', 'Rollout and evidence')

SUMMARY_DIFF_CHAR_LIMIT = 1500

async generate() → Tuple[Dict[str, Any] | None, str | None]

Generates the data for this report block asynchronously.

Access block configuration via self.config and report parameters via self.params. Use self.api_client for data fetching. Use self._log(“message”) to record log information.

Returns:

A tuple containing:

• A dictionary containing the generated data (JSON-serializable), or None on failure.

• A string containing concatenated log messages, or None if no logs.