Macula Application Root Supervisor.

This is the top-level supervisor for the Macula application. It manages all Macula subsystems in an always-on architecture.

Supervision Hierarchy (v0.16.0+):

  macula_root (this module - application root)
  ├── macula_routing_server (core DHT infrastructure - always on)
  ├── macula_nat_system (NAT traversal - always on)
  │   ├── macula_nat_detector
  │   ├── macula_hole_punch
  │   ├── macula_relay_registry
  │   └── macula_connection_upgrade
  ├── macula_bootstrap_system (bootstrap services - always on)
  │   ├── macula_bootstrap_server
  │   ├── macula_bootstrap_registry
  │   └── macula_bootstrap_health
  ├── macula_gateway_system (gateway services - always on)
  │   ├── macula_gateway_health
  │   ├── macula_gateway_diagnostics
  │   ├── macula_gateway_quic_server
  │   ├── macula_gateway
  │   └── macula_gateway_workers_sup
  ├── macula_bridge_system (hierarchical mesh bridging - optional)
  │   ├── macula_bridge_node (parent mesh connection)
  │   ├── macula_bridge_mesh (peer bridge mesh)
  │   └── macula_bridge_cache (parent query results cache)
  ├── macula_peers_sup (dynamic peer connections - always on)
  ├── macula_peer_discovery (DHT-based P2P mesh - always on)
  ├── macula_platform_system (distributed coordination - always on)
  │   └── macula_crdt (LWW-Register, OR-Set, G-Counter, PN-Counter)
  └── macula_registry_system (package distribution - always on)
      ├── macula_registry_store (ETS + disk storage)
      ├── macula_registry_server (publish/fetch API)
      ├── macula_cluster_controller (app lifecycle)
      └── macula_app_monitor (runtime defense)
  

Architecture Philosophy (v0.8.5): - All nodes have ALL capabilities (no mode selection) - Zero configuration required (TLS auto-generated) - Simplified deployment (every node is bootstrap + gateway + peer) - True P2P mesh (nodes connect on-demand based on capability discovery)

Naming Convention (v0.7.10+): - _root: Application root supervisor (one per application) - _system: Subsystem root supervisors (gateway, peer, bootstrap, etc.) - _sup: Worker supervisors (workers_sup, peers_sup)