@spec app_name() :: atom()

Returns the application name from Mix config.

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

Checks if a module is a valid Ash domain.

Verifies the module is compiled and exports domain?/0 (added by use Ash.Domain), which distinguishes domains from plain modules.

@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 a module atom, if present.

Uses Module.concat/1 to produce a proper module reference (e.g. "MyApp.User" becomes MyApp.User, not :"MyApp.User").

@spec migration_glob(String.t()) :: String.t()

Returns the glob pattern used to discover generated migration files.

Migration files are written as .exs (matching Ecto's convention for non-compiled migration files). Keeping this in one place means the writer (AshScylla.MigrationGenerator) and every reader (AshScylla.SchemaLoader, Mix.Tasks.AshScylla.Migrate, ...) agree on the extension.

Examples

iex> AshScylla.MixHelpers.migration_glob("priv/repo/migrations")
"priv/repo/migrations/**/*.exs"

@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, ensures modules are compiled, and validates they are actual Ash domains (Spark DSL modules).

@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.