src.core.board_health_analyzer module

Board Health Analyzer for detecting project-level deadlocks and bottlenecks.

This module analyzes the overall health of the project board by detecting: - Skill mismatches between available tasks and agent capabilities - Circular dependencies that create deadlocks - Bottleneck tasks that block many others - Chain blocks where sequential dependencies create long waits

class src.core.board_health_analyzer.HealthIssueType

Bases: Enum

Types of board health issues.

SKILL_MISMATCH = 'skill_mismatch'

CIRCULAR_DEPENDENCY = 'circular_dependency'

BOTTLENECK = 'bottleneck'

CHAIN_BLOCK = 'chain_block'

STALE_TASKS = 'stale_tasks'

OVERLOADED_AGENTS = 'overloaded_agents'

IDLE_AGENTS = 'idle_agents'

class src.core.board_health_analyzer.IssueSeverity

Bases: Enum

Severity levels for health issues.

LOW = 'low'

MEDIUM = 'medium'

HIGH = 'high'

CRITICAL = 'critical'

class src.core.board_health_analyzer.HealthIssue

Bases: object

Represents a board health issue.

type: HealthIssueType

severity: IssueSeverity

description: str

affected_tasks: List[str]

affected_agents: List[str]

recommendations: List[str]

details: Dict[str, Any]

__init__(type, severity, description, affected_tasks, affected_agents, recommendations, details)

Parameters:

• type (HealthIssueType)

• severity (IssueSeverity)

• description (str)

• affected_tasks (List[str])

• affected_agents (List[str])

• recommendations (List[str])

• details (Dict[str, Any])

Return type:

None

class src.core.board_health_analyzer.BoardHealth

Bases: object

Overall board health assessment.

health_score: float

issues: List[HealthIssue]

metrics: Dict[str, Any]

recommendations: List[str]

timestamp: datetime

__init__(health_score, issues, metrics, recommendations, timestamp)

Parameters:

• health_score (float)

• issues (List[HealthIssue])

• metrics (Dict[str, Any])

• recommendations (List[str])

• timestamp (datetime)

Return type:

None

class src.core.board_health_analyzer.BoardHealthAnalyzer

Bases: object

Analyzes board-level health and detects various types of deadlocks.

__init__(kanban_client, stale_task_days=7, max_tasks_per_agent=3)

Initialize the board health analyzer.

Parameters:

• kanban_client (KanbanInterface) – Interface to kanban board.

• stale_task_days (int) – Days before considering a task stale.

• max_tasks_per_agent (int) – Maximum recommended tasks per agent.

async analyze_board_health(agents, active_assignments)

Perform comprehensive board health analysis.

Parameters:

• agents (Dict[str, WorkerStatus]) – Dictionary of active agents.

• active_assignments (Dict[str, str]) – Current task assignments.

Return type:

BoardHealth

Returns:

BoardHealth object with analysis results