@callback accept_migration(migrating_substrate :: module(), state :: map()) ::
  :ok | {:error, reason :: any()}

@callback add_dependency(dependency :: module()) :: :ok | {:error, reason :: any()}

@callback authenticate(credentials :: map()) ::
  {:ok, permissions :: [atom()]} | {:error, reason :: any()}

@callback authorize(permission :: atom(), resource :: any()) :: boolean()

@callback begin_transaction() ::
  {:ok, transaction_id :: atom()} | {:error, reason :: any()}

@callback clear_failure_history() :: :ok

@callback commit_transaction(transaction_id :: atom()) :: :ok | {:error, reason :: any()}

@callback compose_with(other_substrate :: module(), config :: map()) ::
  {:ok, composed_module :: module()} | {:error, reason :: any()}

@callback connect_port(port_type :: :input | :output, port_id :: atom(), target :: any()) ::
  :ok | {:error, reason :: any()}

@callback create_backup() :: {:ok, backup_data :: map()} | {:error, reason :: any()}

@callback deserialize_state(serialized :: binary()) ::
  {:ok, state :: map()} | {:error, reason :: any()}

@callback disconnect_from(integration_id :: atom()) :: :ok | {:error, reason :: any()}

@callback disconnect_port(port_type :: :input | :output, port_id :: atom()) ::
  :ok | {:error, reason :: any()}

@callback discover_peers() :: [map()]

@callback emit_event(event :: atom(), data :: any()) :: :ok

@callback get_capabilities() :: [atom()]

@callback get_debug_info() :: map()

@callback get_dependencies() :: [module()]

@callback get_failure_history() :: [map()]

@callback get_health_status() :: map()

@callback get_input_ports() :: [map()]

@callback get_logs() :: [String.t()]

@callback get_metrics() :: map()

@callback get_output_ports() :: [map()]

@callback get_performance_stats() :: map()

@callback get_resource_limits() :: map()

@callback get_resource_usage() :: map()

@callback get_scaling_recommendations() :: [map()]

@callback get_state() :: map()

@callback get_time_constraints() :: [map()]

@callback get_version() :: String.t()

@callback handle_failure(failure :: map()) :: :ok | {:error, reason :: any()}

@callback has_capability(capability :: atom()) :: boolean()

@callback init_substrate(config :: map()) ::
  {:ok, state :: map()} | {:error, reason :: any()}

@callback integrate_with(external_system :: atom(), config :: map()) ::
  {:ok, integration_id :: atom()} | {:error, reason :: any()}

@callback is_compatible_with(other_version :: String.t()) :: boolean()

@callback is_within_time_constraints() :: boolean()

@callback migrate_to(target_node :: atom()) :: :ok | {:error, reason :: any()}

@callback optimize() :: {:ok, optimizations :: [map()]} | {:error, reason :: any()}

@callback record_metric(metric :: atom(), value :: any()) :: :ok

@callback register_with_registry(registry :: atom()) :: :ok | {:error, reason :: any()}

@callback remove_dependency(dependency :: module()) :: :ok | {:error, reason :: any()}

@callback reset_state() :: :ok | {:error, reason :: any()}

@callback restart_substrate() :: :ok | {:error, reason :: any()}

@callback restore_from_backup(backup_data :: map()) :: :ok | {:error, reason :: any()}

@callback rollback_transaction(transaction_id :: atom()) ::
  :ok | {:error, reason :: any()}

@callback scale_down(factor :: float()) :: :ok | {:error, reason :: any()}

@callback scale_up(factor :: float()) :: :ok | {:error, reason :: any()}

@callback send_message(message :: any(), target :: any()) ::
  {:ok, response :: any()} | {:error, reason :: any()}

@callback send_notification(notification_type :: atom(), data :: any()) :: :ok

@callback serialize_state() :: binary()

@callback set_debug_level(level :: atom()) :: :ok

@callback set_resource_limits(limits :: map()) :: :ok | {:error, reason :: any()}

@callback set_state(state :: map()) :: :ok | {:error, reason :: any()}

@callback set_time_constraints(constraints :: [map()]) :: :ok | {:error, reason :: any()}

@callback start_substrate() :: :ok | {:error, reason :: any()}

@callback stop_substrate() :: :ok | {:error, reason :: any()}

@callback subscribe_to_events(pid :: pid()) :: :ok | {:error, reason :: any()}

@callback subscribe_to_notifications(pid :: pid(), notification_types :: [atom()]) ::
  :ok | {:error, reason :: any()}

@callback unregister_from_registry(registry :: atom()) :: :ok | {:error, reason :: any()}

@callback unsubscribe_from_events(pid :: pid()) :: :ok | {:error, reason :: any()}

@callback unsubscribe_from_notifications(pid :: pid()) :: :ok | {:error, reason :: any()}

@callback update_config(config :: map()) :: :ok | {:error, reason :: any()}

@callback update_state(updates :: map()) :: :ok | {:error, reason :: any()}

@callback validate_config(config :: map()) ::
  {:ok, validated_config :: map()} | {:error, reason :: any()}

@callback validate_message(message :: any()) ::
  {:ok, validated_message :: any()} | {:error, reason :: any()}