docs(cli): document every flag from the contracts, add troubleshooting and a single-page reference

The command reference was structurally complete but said almost nothing: 223 of
377 flags rendered as "Set sort by" because the CLI only ever read flag help
from its own contract overrides, and fell back to restating the flag name.

The prose already existed. The v2 route contracts carry 931 `.describe()` calls
and the OpenAPI specs publish all of them — 327 parameters and 282 body
properties, 100% coverage — but the generated operation table dropped every one,
carrying only a per-operation summary. It now carries the field descriptions,
the path-parameter descriptions, and positional help, so `--help` and the docs
explain a flag the same way the API reference does. Placeholder descriptions are
now zero, and 147/147 commands, 377/377 flags and 130/130 arguments are
documented.

`check:cli-docs` fails on a request field with no `.describe()` rather than
letting it render as documentation that says nothing.

Also in this pass:

- Commands are root-level sidebar entries under a Commands heading rather than
  a folder, and headings are the command's description, so the table of
  contents distinguishes entries at the first word instead of repeating
  "sim knowledge documents …" fourteen times. A guard fails the build if two
  descriptions on a page collide, since they would share an anchor.
- A single-page `Complete reference` carrying all 147 commands, for in-page
  search and for agents fetching `/cli/reference.mdx`. It keys on exact command
  paths because descriptions are only unique within a group.
- A troubleshooting page, with every message copied from the source.
- Table columns are sized by a local component; the flag column was starved
  while descriptions kept most of the row empty.
- The prerelease install channels are dropped from the docs and the package
  README, which is what npm renders.

Author: waleedlatif1

apps/docs/components/ui/command-table.tsx

@@ -0,0 +1,34 @@
+import type { ReactNode } from 'react'
+
+interface CommandTableProps {
+  children: ReactNode
+}
+
+/**
+ * Column sizing for the generated CLI reference tables.
+ *
+ * Auto layout gives a column width in proportion to its content, which is
+ * backwards here: descriptions are sentences and flags are short, so the flag
+ * column collapsed until `--enabled-filter <value>` wrapped across three lines
+ * while the description beside it kept most of the row empty. A fixed layout
+ * with explicit widths reserves the space the flag actually needs.
+ *
+ * Cells align to the top because a wrapped four-line description would
+ * otherwise float its flag into the middle of the row, away from the line it
+ * belongs to.
+ */
+export function CommandTable({ children }: CommandTableProps) {
+  return (
+    <div
+      className={[
+        '[&_table]:w-full [&_table]:table-fixed',
+        '[&_th:nth-child(1)]:w-[30%] [&_th:nth-child(2)]:w-[5.5rem]',
+        '[&_td]:align-top [&_th]:align-bottom',
+        // Long flags and dotted paths have no spaces to break on.
+        '[&_td:nth-child(1)_code]:break-words',
+      ].join(' ')}
+    >
+      {children}
+    </div>
+  )
+}

apps/docs/content/docs/en/cli/audit-logs.mdx

@@ -0,0 +1,62 @@
+---
+title: Audit Logs
+description: Manage audit logs — every subcommand, argument, and flag
+---
+
+import { CommandTable } from '@/components/ui/command-table'
+
+`sim audit-logs` is also spelled `sim audit-log`.
+
+Every command below also accepts the [global options](/cli/commands#global-options).
+
+## Get audit log
+
+```bash
+sim audit-logs get <id> [options]
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `id` | Yes | Audit-log entry identifier. |
+
+</CommandTable>
+
+**Options**
+
+<CommandTable>
+
+| Option | Required | Description |
+| --- | --- | --- |
+| `--organization <value>` | Yes | Organization ID (personal API key required). |
+
+</CommandTable>
+
+## List audit logs
+
+```bash
+sim audit-logs list [options]
+```
+
+**Options**
+
+<CommandTable>
+
+| Option | Required | Description |
+| --- | --- | --- |
+| `--action <value>` | No | Filter by exact action name. |
+| `--resource-type <value>` | No | Filter by resource type. Accepts a comma-separated set; members are trimmed and deduplicated, and member order affects neither the result nor the cursor. |
+| `--resource-id <value>` | No | Filter by exact resource identifier. |
+| `--start-date <value>` | No | Only include runs started at or after this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. |
+| `--end-date <value>` | No | Only include runs started at or before this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. |
+| `--include-departed` | No | Include actions by users who have left the organization. |
+| `--no-include-departed` | No | Send --include-departed as false. |
+| `--limit <n>` | No | Maximum items to return (0 for everything). Defaults to `100`. |
+| `--organization <value>` | Yes | Organization ID (personal API key required). |
+| `--actor-email <value>` | No | Filter by actor email address. |
+| `--all-workspaces` | No | Do not filter to the configured workspace (personal API key required for account-wide access). |
+
+</CommandTable>

…content/docs/en/cli/commands/billing.mdx apps/docs/content/docs/en/cli/billing.mdxapps/docs/content/docs/en/cli/commands/billing.mdx renamed to apps/docs/content/docs/en/cli/billing.mdx apps/docs/content/docs/en/cli/commands/billing.mdx renamed to apps/docs/content/docs/en/cli/billing.mdx

@@ -3,32 +3,36 @@ title: Billing
 description: Manage billing — every subcommand, argument, and flag
 ---
 
-Every command below also accepts the [global options](/cli/commands#global-options).
+import { CommandTable } from '@/components/ui/command-table'
 
-## sim billing status
+Every command below also accepts the [global options](/cli/commands#global-options).
 
-Show billing status and current-period credit usage
+## Show billing status and current-period credit usage
 
 ```bash
 sim billing status [options]
 ```
 
 **Options**
 
+<CommandTable>
+
 | Option | Required | Description |
 | --- | --- | --- |
 | `--all-workspaces` | No | Do not filter to the configured workspace (personal API key required for account-wide access). |
 
-## sim billing logs
+</CommandTable>
 
-List credit usage events
+## List credit usage events
 
 ```bash
 sim billing logs [options]
 ```
 
 **Options**
 
+<CommandTable>
+
 | Option | Required | Description |
 | --- | --- | --- |
 | `--source <value>` | No | Filter by usage source; sim-chat combines Copilot and workspace chat. Accepted values: `workflow`, `wand`, `sim-chat`, `mcp_copilot`, `mothership_block`, `knowledge-base`, `voice-input`, `enrichment`, `voice-output`. |
@@ -37,3 +41,5 @@ sim billing logs [options]
 | `--end-date <value>` | No | Custom period end (ISO 8601). |
 | `--limit <n>` | No | Maximum items to return (0 for everything). Defaults to `100`. |
 | `--all-workspaces` | No | Do not filter to the configured workspace (personal API key required for account-wide access). |
+
+</CommandTable>

…s/content/docs/en/cli/commands/index.mdx …ps/docs/content/docs/en/cli/commands.mdxapps/docs/content/docs/en/cli/commands/index.mdx renamed to apps/docs/content/docs/en/cli/commands.mdx apps/docs/content/docs/en/cli/commands/index.mdx renamed to apps/docs/content/docs/en/cli/commands.mdx

@@ -1,8 +1,10 @@
 ---
 title: Overview
-description: Every sim command, with its arguments and flags
+description: Global options, and every sim command group
 ---
 
+import { CommandTable } from '@/components/ui/command-table'
+
 Every `sim` command follows the same shape:
 
 ```bash
@@ -28,81 +30,83 @@ These apply to every command, and may be written before or after it.
 
 | Group | Description |
 | --- | --- |
-| [`sim audit-logs`](/cli/commands/audit-logs) | Manage audit logs |
-| [`sim billing`](/cli/commands/billing) | Manage billing |
-| [`sim credentials`](/cli/commands/credentials) | Manage credentials |
-| [`sim custom-tools`](/cli/commands/custom-tools) | Manage custom tools |
-| [`sim files`](/cli/commands/files) | Manage files |
-| [`sim knowledge`](/cli/commands/knowledge) | Manage knowledge |
-| [`sim logs`](/cli/commands/logs) | Manage logs |
-| [`sim mcp-servers`](/cli/commands/mcp-servers) | Manage mcp servers |
-| [`sim secrets`](/cli/commands/secrets) | Manage secrets |
-| [`sim skills`](/cli/commands/skills) | Manage skills |
-| [`sim tables`](/cli/commands/tables) | Manage tables |
-| [`sim workflows`](/cli/commands/workflows) | Manage workflows |
-| [`sim workspaces`](/cli/commands/workspaces) | Manage workspaces |
-
-## sim login
-
-Authorize this terminal and store an API key for the profile
+| [`sim audit-logs`](/cli/audit-logs) | Manage audit logs |
+| [`sim billing`](/cli/billing) | Manage billing |
+| [`sim credentials`](/cli/credentials) | Manage credentials |
+| [`sim custom-tools`](/cli/custom-tools) | Manage custom tools |
+| [`sim files`](/cli/files) | Manage files |
+| [`sim knowledge`](/cli/knowledge) | Manage knowledge |
+| [`sim logs`](/cli/logs) | Manage logs |
+| [`sim mcp-servers`](/cli/mcp-servers) | Manage mcp servers |
+| [`sim secrets`](/cli/secrets) | Manage secrets |
+| [`sim skills`](/cli/skills) | Manage skills |
+| [`sim tables`](/cli/tables) | Manage tables |
+| [`sim workflows`](/cli/workflows) | Manage workflows |
+| [`sim workspaces`](/cli/workspaces) | Manage workspaces |
+
+## Authorize this terminal and store an API key for the profile
 
 ```bash
 sim login [options]
 ```
 
 **Options**
 
+<CommandTable>
+
 | Option | Required | Description |
 | --- | --- | --- |
 | `--scope <scope>` | No | Key space to mint from: platform or copilot. Defaults to `platform`. |
 | `--no-browser` | No | Print the URL instead of opening a browser. |
 | `-y, --yes` | No | Overwrite an existing profile without prompting. |
 
-## sim logout
+</CommandTable>
 
-Remove the profile's stored API key
+## Remove the profile's stored API key
 
 ```bash
 sim logout [options]
 ```
 
 **Options**
 
+<CommandTable>
+
 | Option | Required | Description |
 | --- | --- | --- |
 | `--all` | No | Remove the profile entirely, including its settings. |
 
-## sim whoami
+</CommandTable>
 
-Show the resolved profile and where each setting came from
+## Show the resolved profile and where each setting came from
 
 ```bash
 sim whoami
 ```
 
-## sim profiles
-
-List the profiles defined in the config and credentials files
+## List the profiles defined in the config and credentials files
 
 ```bash
 sim profiles
 ```
 
 Also available as `sim profile`.
 
-## sim configure
-
-Set a profile's endpoint, default workspace, or output format
+## Set a profile's endpoint, default workspace, or output format
 
 ```bash
 sim configure [options]
 ```
 
 **Options**
 
+<CommandTable>
+
 | Option | Required | Description |
 | --- | --- | --- |
 | `--set-endpoint <url>` | No | Sim deployment to talk to. |
 | `--set-workspace <id>` | No | Default workspace for workspace-scoped commands. |
 | `--set-output <format>` | No | Default output format (table \| json \| yaml \| text). |
 | `--unset <key...>` | No | Remove settings (endpoint, workspace, output). |
+
+</CommandTable>