Changelog

[0.4.1] - 2026-06-12

Repository moved to https://github.com/saschabrink/ecto_context — package metadata, docs links, and license now reflect the maintainer's real name.
CI tests against Elixir 1.19 and 1.20 via the Nix flake dev shells.
README badges for CI status and license, alongside the existing hex/hexdocs pair.

The precommit alias misspelled --warnings-as-errors, so compiler warnings were never treated as errors locally.

Repo inference is now strict: without an explicit repo: (declaration or config :ecto_context, :defaults), the repo is taken from the host app's :ecto_repos only when exactly one is configured. With several repos, ecto_context previously picked the first silently — it now raises at compile time with the candidate list and the config line to copy.

Generated functions no longer trigger Elixir 1.20 type warnings ("will always evaluate to dynamic(true)") in contexts with intentional always-true permission clauses, e.g. public reads (def permission(:get, _, _), do: true). Permission checks now go through EctoContext.permitted?/4, which keeps the callee opaque to the type checker's call-site specialization.
ecto_context no longer crashes with a CaseClauseError at compile time when the host app configures ecto_repos: [] — it raises a descriptive error instead.
Removed dead has_excluded_module?/2 base clause in NoUnscopedRepoInsideAppLib that Elixir 1.20 correctly identifies as unreachable (call site already guards against an empty exclusion list)

NoEctoQueryOutsideAppLib — new Credo check that bans alias Ecto.Query and import Ecto.Query in lib/ outside lib/[app]/. Keeps query composition out of the web layer. Supports :excluded_paths.

mix ecto_context.install — Igniter-powered installer that adds ecto_context to .formatter.exs automatically. Run via mix igniter.install ecto_context or directly with mix ecto_context.install.

NoRepoOutsideAppLib: new :excluded_paths option — list of path prefixes skipped entirely by the check. Use for directories where direct Repo access is intentional, e.g. excluded_paths: ["lib/mix/tasks"].

NoUnscopedRepoInsideAppLib: :allowed_schemas renamed to :excluded_schemas. Update your .credo.exs accordingly.

NoUnscopedRepoInsideAppLib: new :excluded_paths option — list of path prefixes (e.g. ["lib/mix/tasks"]) that are skipped entirely by the check.

EctoContext.Check.ForceScoped removed. Replace with two more focused checks:
- EctoContext.Check.Design.NoUnscopedRepoInsideAppLib — covers all of lib/[app]/ uniformly (ecto_context and non-ecto_context modules alike), with context-aware error messages. Supports excluded_schemas to suppress violations per-function when a schema is referenced in the function head or body.
- EctoContext.Check.Design.NoRepoOutsideAppLib — absolute Repo ban in lib/ outside lib/[app]/ (web layer, mix tasks, other support code).
EctoContext.Check.DeprecateRepoTransaction renamed to EctoContext.Check.Warning.DeprecateRepoTransaction (moved into the Warning namespace).

EctoContext.Check.ForceScoped — optional Credo check (requires {:credo, "~> 1.7"}) that enforces use of generated scoped functions in ecto_context modules. Bans direct Repo calls for operations ecto_context covers (all, get, get!, get_by, get_by!, insert, insert!, update, update!, delete, delete!, aggregate); allows everything else (transact, delete_all, insert_all, update_all, …). Repos are configured via repos: [MyApp.Repo] or auto-detected from :ecto_repos.
EctoContext.Check.DeprecateRepoTransaction — flags Repo.transaction/2 project-wide and points to Repo.transact/2, the official Ecto replacement.

get_by and get_by! now support :order_by and :limit options, enabling "fetch first matching by ordering" patterns without a custom :query function

README and usage-rules.md now correctly document get, get!, get_by, get_by! opts (:preload, :select, :query)
usage-rules.md clarifies that :query is always a 1-arity function; separates list-family opts from get-family opts

get, get!, get_by, get_by! now support :select and :query options
All four get-family functions now accept the same uniform option set: :preload, :select, :query

usage-rules.md — focused LLM-oriented rules file ships with the hex package. Covers return-value shapes, scope/2 vs permission/3, the :get unauthorized-collapses-to-nil trap, and common API pitfalls.
README section pointing AI agents at deps/ecto_context/usage-rules.md.

ecto_context/2 macro for generating scoped CRUD functions
16 generated functions: list, list_by, list_for, get, get!, get_by, get_by!, create, create_for, update, delete, change, count, paginate, subscribe, broadcast
EctoContext.Query — runtime query helpers
EctoContext.Validate — runtime validation helpers
EctoContext.Paginator — pagination struct