# V10 Rail CLI

`rail dogfood-report` reads the device-local Phase-A dogfood journal and
summarizes the seven days ending at the requested instant.

```bash
pnpm rail dogfood-report
pnpm rail dogfood-report --through 2026-07-17T12:00:00Z --time-zone America/New_York
pnpm rail dogfood-report --input ./rail-dogfood-journal.json --json
```

Without `--input`, the command resolves the same `app.oshun.v10.rail` app-data
directory used by Tauri: `$XDG_DATA_HOME` (or `~/.local/share`) on Linux,
`~/Library/Application Support` on macOS, and `%APPDATA%` on Windows. Set
`RAIL_DOGFOOD_JOURNAL` for an explicit device-local override. Browser-only
sessions use the Rail footer's **Export** action and pass that JSON file through
`--input`.

The human report includes docked hours by spectator/player face and channel,
micro-act outcomes, and granted/denied elevation decisions. `--json` emits the
stable `v10.rail-dogfood.1` report object. Inputs larger than 2 MiB, malformed
schemas, duplicate events, overlapping dock sessions, and invalid time zones
fail loudly. The command performs no network requests.