plexus.reports.action_items_utils module

Shared helpers for generating action items from FeedbackAlignment report output.

Used by both the ActionItems ReportBlock and the plexus report action-items CLI.

plexus.reports.action_items_utils.collect_action_items(output: dict, ac1_threshold: float, recency_days: int, scorecard_name_hint: str = None) → list

Walk the FeedbackAlignment output and return filtered, annotated action items.

Handles both all-scorecards mode (output has a ‘scorecards’ list) and single-scorecard mode (output has ‘scores’ and optionally ‘memories_file’ at root).

Each action item dict contains:

scorecard_name, score_name, score_ac1, topic_label, cause, keywords, member_count, days_inactive, is_new, is_trending, exemplars

plexus.reports.action_items_utils.fetch_block_output(block) → dict | None

Fetch and parse a ReportBlock’s output, following output_attachment if compacted.

plexus.reports.action_items_utils.fetch_memories(memories_file: str) → dict

Download a memories YAML file from S3 and return the parsed dict.