A hierarchy of exceptions that can occur during component initialization.

Why sealed class?

• Provides exhaustive when expressions for error handling

• Ensures all possible failures are documented

• Prevents creation of unexpected error types

• Enables smart casting in error handlers

Design principles:

• Clear Error Categories: Each subclass represents a distinct failure mode

• Rich Context: Each exception carries relevant data for debugging

• Helpful Messages: Error descriptions guide users to solutions

• Clean Stack Traces: Original causes are preserved when wrapping errors

Example usage:

try {
    borg.assimilate(context)
} catch (e: BorgException) {
    when (e) {
        is CircularDependencyException -> {
            // Handle circular dependency detected
            Log.e("Borg", "Circular dependency in: ${e.cycle}")
        }
        is DroneNotFoundException -> {
            // Handle missing dependency
            Log.e("Borg", "Missing drone: ${e.requiredDrone}")
        }
        is AssimilationException -> {
            // Handle initialization failure
            Log.e("Borg", "Failed to initialize: ${e.drone}", e.cause)
        }
        is DroneNotAssimilatedException -> {
            // Handle attempt to access uninitialized drone
            Log.e("Borg", "Drone not ready: ${e.drone}")
        }
    }
}