# `SquidMesh.Plugins.Cron`
[🔗](https://github.com/ccarvalho-eng/squid_mesh/blob/main/lib/squid_mesh/plugins/cron.ex#L1)

Host-app opt-in plugin that activates cron workflow triggers through Oban.

The plugin groups cron workflows by timezone and starts one `Oban.Plugins.Cron`
child per timezone. Workflow runs are still created through Squid Mesh's
public API and dispatched through the configured execution queue.

# `option`

```elixir
@type option() :: Oban.Plugin.option() | {:workflows, [module()]}
```

# `child_spec`

```elixir
@spec child_spec(Keyword.t()) :: Supervisor.child_spec()
```

Returns a specification to start this module under a supervisor.

See `Supervisor`.

# `evaluate`

```elixir
@spec evaluate(Supervisor.supervisor()) :: :ok
```

Forces the wrapped Oban cron children to evaluate immediately.

This is useful in tests and smoke paths where the host app needs to exercise
cron activation without waiting for the next scheduler tick.

---

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