mix pixir.smoke.workflows_real (pixir v0.1.0)

Copy Markdown View Source

Runs small, bounded Pixir Workflows against the real Provider.

This task is intentionally separate from mix pixir.smoke.workflows, which is deterministic and no-network. Use this task only when you want live model-backed Subagents and durable local evidence under .pixir/.

Usage:

mix pixir.smoke.workflows_real --dry-run --json
mix pixir.smoke.workflows_real --scenario micro_parallel --json
mix pixir.smoke.workflows_real --scenario dependency --model gpt-5.3-codex-spark
mix pixir.smoke.workflows_real --scenario writer_controlled --output .pixir/smoke/workflows-real/manual
mix pixir.smoke.workflows_real --help

Scenarios:

  • micro_parallel - two read-only Subagents respond with exact constants.
  • dependency - two read-only Subagents feed a dependent summarizer.
  • writer_controlled - one writer mutates only the scratch workspace.

Options:

  • --scenario NAME - one of the scenarios above. Default: micro_parallel.
  • --model MODEL - optional Provider model override.
  • --timeout-ms N - whole-workflow timeout. Default: 90000.
  • --step-timeout-ms N - per-step timeout. Default: 30000.
  • --output DIR - durable evidence directory. Default: .pixir/smoke/workflows-real/<run_id>.
  • --dry-run - validate and print planned waves without auth, network, or writes.
  • --json - print machine-readable evidence or errors.
  • --help - print this help and exit.

Summary

Functions

run(args)

Entry point for the Mix task: parses CLI arguments, validates configuration, and either prints help/dry-run output or executes a real workflow run.

Functions

run(args)

@spec run([String.t()]) :: no_return() | :ok | {:ok, map()} | {:error, map()}

Entry point for the Mix task: parses CLI arguments, validates configuration, and either prints help/dry-run output or executes a real workflow run.

Parses provided args, handles --help and --dry-run flows, validates options, ensures authentication when performing a real run, and delegates execution to the live runner which produces durable evidence on success.