# logion eval

6 commands in this group.

- [`logion eval export`](#logion-eval-export)
- [`logion eval inspect`](#logion-eval-inspect)
- [`logion eval run`](#logion-eval-run)
- [`logion eval scaffold`](#logion-eval-scaffold)
- [`logion eval validate`](#logion-eval-validate)
- [`logion eval verify`](#logion-eval-verify)

## logion eval export

```bash
logion eval export CONTRACT --subject SUBJECT --result RESULT --output OUTPUT [--force] [--json]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `CONTRACT` | string | — | Contract file (YAML or JSON) |
| `--subject` | string | — | Subject file path |
| `--result` | string | — | Normalized result file; pass at least twice |
| `--output` | string | — | Bundle ZIP path |
| `--force` | flag | — | Replace the output bundle |
| `--json` | flag | — | Emit JSON |

## logion eval inspect

```bash
logion eval inspect ARTIFACT [--json]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `ARTIFACT` | string | — | Result JSON/YAML or bundle ZIP |
| `--json` | flag | — | Emit JSON |

## logion eval run

```bash
logion eval run [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] CONTRACT --subject SUBJECT [--output OUTPUT] [--force] [--publish] [--runner-credentials RUNNER_CREDENTIALS]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `CONTRACT` | string | — | Contract file (YAML or JSON) |
| `--subject` | string | — | Subject file path |
| `--output` | string | — | Write the normalized result to FILE |
| `--force` | flag | — | Replace the output file |
| `--publish` | flag | — | Upload the contract and submit the normalized result |
| `--runner-credentials` | string | — | JSON file containing runner_id and runner_key |

## logion eval scaffold

```bash
logion eval scaffold DIRECTORY [--force] [--json]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `DIRECTORY` | string | — | Directory to create |
| `--force` | flag | — | Replace scaffold files |
| `--json` | flag | — | Emit JSON |

## logion eval validate

```bash
logion eval validate [--api-key API_KEY] [--base-url BASE_URL] [--json] [--timeout TIMEOUT] [--max-retries MAX_RETRIES] [--no-onboarding] CONTRACT
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `--api-key` | string | — |  |
| `--base-url` | string | — |  |
| `--json` | flag | — |  |
| `--timeout` | float | — |  |
| `--max-retries` | int | — |  |
| `--no-onboarding` | flag | — | Never run first-run onboarding for this invocation. |
| `CONTRACT` | string | — | Contract file (YAML or JSON) |

## logion eval verify

```bash
logion eval verify BUNDLE [--json]
```

| Option | Value | Default | Description |
| --- | --- | --- | --- |
| `BUNDLE` | string | — | Reproduction bundle ZIP |
| `--json` | flag | — | Emit JSON |