docs: refresh docs/site command list

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: wavekat-eason

docs/site/index.md

@@ -14,18 +14,31 @@ order: 1
 |---------|---------------|
 | `wk login` / `wk logout`              | Sign in via your browser, or sign out |
 | `wk me`                               | Who you're signed in as |
-| `wk projects list`                    | Paginated table of projects you can see |
+| `wk projects list`                    | Projects you can see, with role, counts, and review progress |
 | `wk projects show <id>`               | Details for one project |
 | `wk annotations list <project-id>`    | Paginated annotations with inline ASR text |
+| `wk files list <project-id>`          | Files in a project, with per-label counts and reservation state |
+| `wk files reserve <id> [<id>…]`       | Reserve files for the test set |
+| `wk files unreserve <id> [<id>…]`     | Release a test-set reservation |
+| `wk files summary <project-id>`       | File / annotation / labelled-seconds totals |
 | `wk exports list <project-id>`        | Exports for a project |
 | `wk exports show <export-id>`         | Filter, split policy, counts for one export |
 | `wk exports create <project-id>`      | Snapshot the current label set into a frozen export |
 | `wk exports download <export-id>`     | Fetch manifest + every clip |
 | `wk exports delete <export-id>`       | Soft-delete an export |
 | `wk exports adapt smart-turn …`       | Convert a downloaded export into HF `datasets` Parquet shards |
+| `wk models list <project-id>`         | Models trained in a project (lineage, metrics, status) |
+| `wk models show <model-id>`           | Full model row including artifacts |
+| `wk models push …`                    | Register a trained model + upload its artifacts |
+| `wk models download <model-id>`       | Fetch a specific model artifact |
+| `wk version`                          | CLI + API versions, with `--json` |
+| `wk update`                           | Self-update to the latest release (or `--check`, `--version`) |
+| `wk agents`                           | Print the LLM-facing `AGENTS.md` guide |
 
 Every list command supports `--page` / `--page-size` and prints a ready-to-paste `Next:` line when more pages exist. Add `--json` to any command for machine-readable output.
 
+Don't see what you need above? `wk` is built on clap — every subcommand has self-describing help. Run `wk --help`, `wk <group> --help`, or `wk <group> <command> --help` to see every flag, type, and default for any command this binary supports.
+
 Supported on macOS (Apple Silicon + Intel) and Linux (x86_64 + aarch64).
 
 ## Where to go next

docs/site/reference.md

@@ -40,15 +40,38 @@ Each command maps to a single platform endpoint:
 | `wk login`                          | Loopback OAuth + `GET /api/me` |
 | `wk logout`                         | `POST /api/auth/cli/tokens/revoke-current` |
 | `wk me`                             | `GET /api/me` |
+| `wk version`                        | Local binary + `GET /api/health` |
+| `wk update`                         | `GET /repos/wavekat/wavekat-cli/releases/latest` (GitHub) + re-runs `install.sh` |
+| `wk agents`                         | Local-only; prints the bundled `AGENTS.md` |
 | `wk projects list`                  | `GET /api/projects` |
 | `wk projects show <id>`             | `GET /api/projects/{id}` |
 | `wk annotations list <project-id>`  | `GET /api/projects/{id}/annotations` |
+| `wk files list <project-id>`        | `GET /api/projects/{id}/files` |
+| `wk files reserve <id> [<id>…]`     | `POST /api/files/{id}/test-reservation` (one call per id) |
+| `wk files unreserve <id> [<id>…]`   | `DELETE /api/files/{id}/test-reservation` (one call per id) |
+| `wk files summary <project-id>`     | `GET /api/projects/{id}/files/summary` |
 | `wk exports list <project-id>`      | `GET /api/projects/{id}/exports` |
 | `wk exports show <export-id>`       | `GET /api/exports/{id}` |
 | `wk exports create <project-id>`    | `POST /api/projects/{id}/exports` |
 | `wk exports download <export-id>`   | `GET /api/exports/{id}/manifest` + per-clip `GET /api/exports/{id}/clips/{annotation-id}` |
 | `wk exports delete <export-id>`     | `DELETE /api/exports/{id}` |
 | `wk exports adapt smart-turn`       | Local-only; reads a downloaded snapshot |
+| `wk models list <project-id>`       | `GET /api/projects/{id}/models` |
+| `wk models show <model-id>`         | `GET /api/models/{id}` |
+| `wk models push …`                  | `POST /api/projects/{id}/models` + artifact upload |
+| `wk models download <model-id>`     | `GET /api/models/{id}/artifacts/{name}` |
+
+## Discovering commands
+
+This table is a snapshot; the binary itself is authoritative. Every subcommand has self-describing help via clap:
+
+```sh
+wk --help                   # top-level groups
+wk exports --help           # one group
+wk exports create --help    # all flags, types, defaults
+```
+
+When in doubt, run `--help` rather than guessing.
 
 ## Credentials file