@spec app_name() :: atom()

Returns the application name from Mix config.

@spec ash_scylla_resource?(module()) :: boolean()

Checks if a resource module uses AshScylla.DataLayer.

@spec file_to_module(String.t()) :: atom() | nil

Converts a file path to a module name.

Examples

iex> AshScylla.MixHelpers.file_to_module("lib/my_app/resources/user.ex")
:"Elixir.MyApp.Resources.User"

@spec find_all_resources() :: [module()]

Finds all AshScylla resources via domain config, with file-scan fallback.

1. Reads configured domains from app env
2. Gets each domain's resources via Ash.Domain.Info.resources/1
3. Filters to AshScylla resources
4. Falls back to scanning lib/**/*.ex files if no domains configured

@spec find_default_repo() :: module()

Finds and returns the default repo module from AshScylla resources.

Extracts the repo from each resource's DSL config and returns the first one.

@spec maybe_atomize(
  keyword(),
  atom()
) :: keyword()

Converts a string CLI option value to an atom, if present.

@spec project_apps() :: [atom()]

Returns the list of app atoms to scan: the current app + umbrella children.

@spec project_domains() :: [module()]

Discovers Ash domains from the project's app configuration.

Checks each app for :ash_domains config and ensures modules are compiled.

@spec project_lib_paths() :: [String.t()]

Returns the list of lib/ directories to scan (current app + umbrella children).

@spec scan_files_for_resources() :: [module()]

Scans all .ex files in project lib/ directories for AshScylla resources.