# `mix pixir.smoke.workflows`
[🔗](https://github.com/Ranvier-Technologies/pixir/blob/main/lib/mix/tasks/pixir.smoke.workflows.ex#L1)

Verifies Pixir Workflows end-to-end without hitting the network:

  * validates a structural dependency graph;
  * proves read-only explorer steps can run together;
  * proves overlapping writer write-sets are serialized;
  * runs the Workflow through supervised Subagents with a fake provider;
  * verifies terminal summaries and canonical Subagent lifecycle evidence;
  * diagnoses durable Workflow event/checkpoint evidence before cleanup.

Usage:

    mix pixir.smoke.workflows [--dry-run] [--json]

Options:

  * `--dry-run` - validate and print the planned waves without spawning Subagents.
  * `--json` - print machine-readable evidence.
  * `--help` - print this help.

# `run`

```elixir
@spec run([String.t()]) :: any()
```

Parses CLI options and either prints help or runs the smoke workflow.

Recognizes the switches `--dry-run`, `--json`, and `--help`. If `--help` is present, prints the module documentation to the Mix shell; otherwise starts the application and executes the smoke workflow using the parsed options.
## Parameters

  - args: list of command-line arguments passed to the Mix task.

---

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