# okstra-usage AI Manual

## Purpose

Use `okstra-usage` for a project-wide historical resource snapshot. It is not a
single-task inspection (`okstra-inspect`) and not a cross-task status/report
digest (`okstra-rollup`).

## Call

Run preflight, resolve a positive day count (default 30), then call exactly once:

```bash
okstra usage-report --days 30 --project-root <projectRoot> --text
```

## Render contract

Render the numbered `By task type` rows and fixed totals without recomputing them.
Show Runs, returned collection rate as Coverage, Raw tokens, Billable, Cost, CPU, and Wall. Surface numbered
unavailable-reason and unmatched-model rows. Missing usage is excluded data, not
zero usage.

## Boundaries

- One task's elapsed/context detail: `okstra-inspect`.
- Task-group/project status and report digest: `okstra-rollup`.
- HTML dashboards, budgets, forecasts, and task/model/worker drill-downs are not
  part of this MVP.