orchestrata_ultimate.governance.escalation_handler

Reference › orchestrata_ultimate › governance › escalation_handler › init

The initialiser of the Advanced Escalation Handler subpackage (story US-005). It re-exports AdvancedEscalationHandler from handler, ConflictResolver from resolver, EscalationSLATracker from sla, the notification classes from notifications and the enums and dataclasses from models. The governance package root, the kernel's pam escalation module and orchestrator.graph_audit import from here.

At a glance

Class diagram

No classes; see Functions.

Dependency diagram

API

No public API: the module defines no classes, functions or constants.

Source

Permalink: https://gitlab.com/MSamy/orchestrata-ultimate-architecture/-/blob/a4cbc2bdf/src/orchestrata_ultimate/governance/escalation_handler/__init__.py

# mypy: ignore-errors
"""Advanced Escalation Handler for Orchestrata (US-005).

This package implements advanced multi-hop escalation, conflict resolution,
and SLA tracking for the governance system. It was decomposed from the
original ``escalation_handler`` module; the symbols are re-exported here so
that ``orchestrata_ultimate.governance.escalation_handler`` keeps its
original public API.

Requirements Implemented:
- REQ-001-US-005-001: Multi-hop escalation path execution
- REQ-001-US-005-002: Track escalation state at each hop
- REQ-001-US-005-003: Handle escalation timeouts per hop
- REQ-001-US-005-004: Emergency escalation path override
- REQ-001-US-005-005: Escalation hop logging
- REQ-001-US-005-006: Escalation metrics collection
- REQ-001-US-005-007: Escalation path branching
- REQ-001-US-005-008: Terminal authority detection
- REQ-001-US-005-009: Human escalation (ultimate authority)
- REQ-001-US-005-010: Escalation retry on hop failure
- REQ-001-US-005-011: Detect overlapping authority conflicts
- REQ-001-US-005-012: Detect boundary violation conflicts
- REQ-001-US-005-013: Create conflict resolution workflows
- REQ-001-US-005-014: Assign conflicts to resolution authority
- REQ-001-US-005-015: Track resolution status
- REQ-001-US-005-016: Apply vote resolution strategy
- REQ-001-US-005-017: Apply priority resolution strategy
- REQ-001-US-005-018: Apply delegation resolution strategy
- REQ-001-US-005-019: Log conflict resolution decisions
- REQ-001-US-005-020: Archive resolved conflicts to graph
- REQ-001-US-005-021: Start SLA timer on escalation
- REQ-001-US-005-022: Check SLA breach within threshold
- REQ-001-US-005-023: Check SLA breach after timeout
- REQ-001-US-005-024: SLA metrics collection
- REQ-001-US-005-025: SLA thresholds by component
- REQ-001-US-005-026: SLA breach notifications
- REQ-001-US-005-027: SLA tracking across hops
- REQ-001-US-005-028: SLA resolution time reporting
"""

from orchestrata_ultimate.governance.escalation_handler.handler import (
    AdvancedEscalationHandler,
)
from orchestrata_ultimate.governance.escalation_handler.models import (
    Conflict,
    ConflictType,
    EscalationHop,
    EscalationResult,
    EscalationStatus,
    Resolution,
    ResolutionStatus,
    ResolutionStrategy,
    _utc_now,
)
from orchestrata_ultimate.governance.escalation_handler.notifications import (
    LogNotificationChannel,
    NotificationChannel,
)
from orchestrata_ultimate.governance.escalation_handler.resolver import (
    ConflictResolver,
)
from orchestrata_ultimate.governance.escalation_handler.sla import (
    EscalationSLATracker,
)

__all__ = [
    "AdvancedEscalationHandler",
    "Conflict",
    "ConflictResolver",
    "ConflictType",
    "EscalationHop",
    "EscalationResult",
    "EscalationSLATracker",
    "EscalationStatus",
    "LogNotificationChannel",
    "NotificationChannel",
    "Resolution",
    "ResolutionStatus",
    "ResolutionStrategy",
    "_utc_now",
]