# `mix decree.verify.eventless`
[🔗](https://github.com/sparkle-space/decree/blob/v0.1.0/lib/mix/tasks/decree.verify.eventless.ex#L1)

Fails on any routed handler arm that can accept a command without appending an event.

    mix decree.verify.eventless --router MyApp.Router [--router MyApp.OtherRouter] [--no-compile]

An aggregate handler answering `[]`, `nil`, `:ok`, `{:ok, []}` or `{:ok, nil}` is
accepted with no events; this task reports every routed arm that can answer one, and a
decision's `decide/2` answering those or `{:streams, []}`. There is no allow-list and no
waiver. The walk, its shapes, what it follows, what it fails closed on and its stated
residuals are documented on `Decree.Verify.Eventless`.

## Population

Each `--router` (a `Decree.Commands.Router`, a `Decree.Commands.CompositeRouter` or a
`Decree.Application`, at least one, repeatable) is read through its registry:
`__registered_commands__/0` and, for each command, `__route__/1`. A decision route walks
the decision's `decide/2`; any other route walks the `handler:` module's `function:` (an
aggregate's `execute/2`, a `to: Handler, aggregate: Agg` route's `handle/2`, or the
route's `function:`). Routes sharing a module and function are walked once, as a
decision when any of them is one.

The sources are every `.ex` file under the project's `elixirc_paths`. A receiver the
walk cannot find there is claimed as internal, and reported unclassified, when it is
one of the project application's own modules (`Application.spec(app, :modules)`);
anything else, a dependency included, is external.

Unless `--no-compile` is given the task runs `mix compile` first. It starts no
application and reads no database.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
