# `Pixir.RecoveryCommands`
[🔗](https://github.com/Ranvier-Technologies/pixir/blob/main/lib/pixir/recovery_commands.ex#L1)

Copyable recovery command builders for failed or ambiguous Sessions.

These commands are operator-facing guidance, not execution. `Turn` records them as
durable failure evidence, while presenters such as `CLI` render the same templates
on stdout/stderr so downstream orchestrators and humans see one consistent recovery
contract.

# `commands`

```elixir
@spec commands(String.t()) ::
  {:ok, %{required(String.t()) => String.t()}} | {:error, map()}
```

Build the standard diagnose/resume commands for a Session id.

# `commands`

```elixir
@spec commands(
  String.t(),
  keyword()
) ::
  {:ok, %{required(String.t()) => String.t() | [String.t()]}} | {:error, map()}
```

Build strategy-aware recovery guidance without changing the standard commands.

---

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