Changelog

[0.3.0] - 2026-05-08

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