chore: regenerate the API reference, CLI surface, and CLI docs

The published reference still marked a secret value required and described
the delete parameter as one that also creates, the CLI surface still lacked
the marker that says which operations refuse a workspace key, and the
reference rendered an empty sentence for every repeatable filter whose
default is an empty list.

Author: waleedlatif1

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

@@ -15,6 +15,8 @@ Every command below also accepts the [global options](/cli/commands#global-optio
 sim audit-logs get <auditLogId> [options]
 ```
 
+Get Audit Log (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -41,6 +43,8 @@ sim audit-logs get <auditLogId> [options]
 sim audit-logs list [options]
 ```
 
+List Audit Logs (personal API key required)
+
 **Options**
 
 <CommandTable>

apps/docs/content/docs/en/cli/billing.mdx

@@ -31,6 +31,8 @@ Show billing status and current-period credit usage (credits and storage require
 sim billing logs [options]
 ```
 
+List credit usage events (a personal API key reports only your own events; a workspace API key reports every member's)
+
 **Options**
 
 <CommandTable>

apps/docs/content/docs/en/cli/credentials.mdx

@@ -15,6 +15,8 @@ Every command below also accepts the [global options](/cli/commands#global-optio
 sim credentials delete <credentialId> [options]
 ```
 
+Disconnect Credential (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -78,6 +80,8 @@ sim credentials list [options]
 sim credentials update <credentialId> [options]
 ```
 
+Update Credential (personal API key required)
+
 **Arguments**
 
 <CommandTable>

apps/docs/content/docs/en/cli/files.mdx

@@ -21,7 +21,7 @@ sim files batch-delete [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--file-ids <value...>` | Yes | File identifiers to update. (space-separated, or @path / @- with one value per line). |
+| `--file-ids <value...>` | Yes | File identifiers to update. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
 | `-y, --yes` | Yes | Confirm this destructive operation. |
 
 </CommandTable>
@@ -107,7 +107,7 @@ Also available as `sim files folders ls`.
 | `--search <value>` | No | Case-insensitive substring match against the folder name. |
 | `--sort-by <value>` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. |
 | `--sort-order <value>` | No | Sort direction. Accepted values: `asc`, `desc`. |
-| `--scope <value>` | No | Which lifecycle set to list: `active` (default) returns live folders only; `archived` returns folders a recursive `DELETE` soft-deleted, which is how a caller finds a path to hand to `POST /api/v2/files/folders/restore`. Authorization is identical for both. Accepted values: `active`, `archived`. |
+| `--scope <value>` | No | Which lifecycle set to list: `active` (default) returns live folders only; `archived` returns folders a recursive delete soft-deleted, which is how a caller finds a path to hand to the folder restore. Authorization is identical for both. Accepted values: `active`, `archived`. |
 
 </CommandTable>
 
@@ -194,7 +194,7 @@ sim files describe <fileId> [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--scope <value>` | No | Which lifecycle set to read from: `active` (default) resolves live files only and returns `404` for a file a `DELETE` soft-deleted; `archived` also resolves soft-deleted files, so metadata stays readable before `POST /files/&#123;fileId&#125;/restore`. Authorization is identical for both. Accepted values: `active`, `archived`. |
+| `--scope <value>` | No | Which lifecycle set to read from: `active` (default) resolves live files only and returns `404` for a file a delete soft-deleted; `archived` also resolves soft-deleted files, so metadata stays readable before the file is restored. Authorization is identical for both. Accepted values: `active`, `archived`. |
 
 </CommandTable>
 
@@ -220,6 +220,8 @@ sim files share get <fileId>
 sim files share set <fileId> [options]
 ```
 
+Enable or disable sharing for a file (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -239,7 +241,7 @@ sim files share set <fileId> [options]
 | `--is-active <true\|false>` | Yes | Whether the share should resolve. Disabling preserves the token and the whole access configuration, so re-enabling restores the share as it was; enabling rewrites the credentials the resulting mode does not use. Accepted values: `true`, `false`. |
 | `--auth-type <value>` | No | How access to the share is gated. The stored mode is kept when omitted. Enabling `public` clears the stored password and empties `allowedEmails`; `password` empties `allowedEmails`; `email` and `sso` clear the stored password. Accepted values: `public`, `password`, `email`, `sso`. |
 | `--password <value>` | No | Password for a password-gated share. Kept when omitted; enabling `password` with neither a supplied nor a stored password is a 400. |
-| `--allowed-emails <value...>` | No | Allowed addresses or `@domain` patterns for email and SSO shares. Kept when omitted; enabling `email` or `sso` with an empty resulting list is a 400. (space-separated, or @path / @- with one value per line). |
+| `--allowed-emails <value...>` | No | Allowed addresses or `@domain` patterns for email and SSO shares. Kept when omitted; enabling `email` or `sso` with an empty resulting list is a 400. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
 
 </CommandTable>
 
@@ -258,7 +260,7 @@ sim files list [options]
 | `--folder <value>` | No | Folder path as shown in the app; the leading / is optional. |
 | `--recursive` | No | Whether the folder filter includes files in subfolders. Defaults to true when a search is set, false otherwise, so listing a folder shows that folder while searching one looks through everything in it. Ignored when no folder filter is set, which already spans the workspace. |
 | `--no-recursive` | No | Send --recursive as false. |
-| `--scope <value>` | No | Which lifecycle set to list: `active` (default) for live files, `archived` for files a `DELETE` soft-deleted. `folderPath` resolves against active folders only, so pairing it with `scope=archived` returns an empty page when the containing folder was archived too. Accepted values: `active`, `archived`. |
+| `--scope <value>` | No | Which lifecycle set to list: `active` (default) for live files, `archived` for files a delete soft-deleted. `folderPath` resolves against active folders only, so pairing it with `scope=archived` returns an empty page when the containing folder was archived too. Accepted values: `active`, `archived`. |
 | `--search <value>` | No | Case-insensitive substring match against the file name. |
 | `--sort-by <value>` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `size`, `uploadedAt`, `updatedAt`. |
 | `--sort-order <value>` | No | Sort direction. Accepted values: `asc`, `desc`. |
@@ -280,7 +282,7 @@ Also available as `sim files mv`.
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--file-ids <value...>` | Yes | File identifiers to update. (space-separated, or @path / @- with one value per line). |
+| `--file-ids <value...>` | Yes | File identifiers to update. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
 | `--to <value>` | No | Destination folder path; omit for root. |
 
 </CommandTable>

apps/docs/content/docs/en/cli/knowledge.mdx

@@ -15,6 +15,8 @@ Every command below also accepts the [global options](/cli/commands#global-optio
 sim knowledge from-workspace-files create <knowledgeBaseId> [options]
 ```
 
+Index files the workspace already stores (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -31,7 +33,7 @@ sim knowledge from-workspace-files create <knowledgeBaseId> [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--file <value...>` | Yes | Workspace file ID or key (repeatable) (space-separated, or @path / @- with one value per line). |
+| `--file <value...>` | Yes | Workspace file ID or key (repeatable) (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
 
 </CommandTable>
 
@@ -41,6 +43,8 @@ sim knowledge from-workspace-files create <knowledgeBaseId> [options]
 sim knowledge tags save <knowledgeBaseId> [options]
 ```
 
+Declare the tag definitions a knowledge base needs (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -67,6 +71,8 @@ sim knowledge tags save <knowledgeBaseId> [options]
 sim knowledge tags create <knowledgeBaseId> [options]
 ```
 
+Create Tag (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -95,6 +101,8 @@ sim knowledge tags create <knowledgeBaseId> [options]
 sim knowledge tags delete <knowledgeBaseId> <tagId> [options]
 ```
 
+Delete Tag (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -122,6 +130,8 @@ sim knowledge tags delete <knowledgeBaseId> <tagId> [options]
 sim knowledge tags cleanup <knowledgeBaseId> [options]
 ```
 
+Remove tag definitions no document still uses (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -150,6 +160,8 @@ sim knowledge tags cleanup <knowledgeBaseId> [options]
 sim knowledge tags next-slot <knowledgeBaseId> [options]
 ```
 
+Show which tag slot a create would take for a field type (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -192,6 +204,8 @@ sim knowledge tags list <knowledgeBaseId>
 sim knowledge tags usage <knowledgeBaseId>
 ```
 
+Show how many documents and chunks carry each tag (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -208,6 +222,8 @@ sim knowledge tags usage <knowledgeBaseId>
 sim knowledge tags update <knowledgeBaseId> <tagId> [options]
 ```
 
+Update Tag (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -236,6 +252,8 @@ sim knowledge tags update <knowledgeBaseId> <tagId> [options]
 sim knowledge chunks batch-update <knowledgeBaseId> <documentId> [options]
 ```
 
+Enable, disable, or delete many chunks at once (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -254,7 +272,7 @@ sim knowledge chunks batch-update <knowledgeBaseId> <documentId> [options]
 | Option | Required | Description |
 | --- | --- | --- |
 | `--operation <value>` | Yes | What to do with the selected chunks. Accepted values: `enable`, `disable`, `delete`. |
-| `--chunk <value...>` | Yes | Chunks to operate on, by identifier. Ids outside the document are ignored. (space-separated, or @path / @- with one value per line). |
+| `--chunk <value...>` | Yes | Chunks to operate on, by identifier. An id naming no chunk in the document is reported in errors and does not fail the request. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
 | `-y, --yes` | Yes | Confirm this destructive operation. |
 
 </CommandTable>
@@ -265,6 +283,8 @@ sim knowledge chunks batch-update <knowledgeBaseId> <documentId> [options]
 sim knowledge chunks create <knowledgeBaseId> <documentId> [options]
 ```
 
+Create Chunk (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -294,6 +314,8 @@ sim knowledge chunks create <knowledgeBaseId> <documentId> [options]
 sim knowledge chunks delete <knowledgeBaseId> <documentId> <chunkId> [options]
 ```
 
+Delete Chunk (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -322,6 +344,8 @@ sim knowledge chunks delete <knowledgeBaseId> <documentId> <chunkId> [options]
 sim knowledge chunks get <knowledgeBaseId> <documentId> <chunkId>
 ```
 
+Get Chunk (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -340,6 +364,8 @@ sim knowledge chunks get <knowledgeBaseId> <documentId> <chunkId>
 sim knowledge chunks list <knowledgeBaseId> <documentId> [options]
 ```
 
+List Chunks (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -371,6 +397,8 @@ sim knowledge chunks list <knowledgeBaseId> <documentId> [options]
 sim knowledge chunks update <knowledgeBaseId> <documentId> <chunkId> [options]
 ```
 
+Update Chunk (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -401,6 +429,8 @@ sim knowledge chunks update <knowledgeBaseId> <documentId> <chunkId> [options]
 sim knowledge documents batch-update <knowledgeBaseId> [options]
 ```
 
+Enable or disable every matching document (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -418,7 +448,7 @@ sim knowledge documents batch-update <knowledgeBaseId> [options]
 | Option | Required | Description |
 | --- | --- | --- |
 | `--operation <value>` | Yes | Whether the selected documents become enabled or disabled for search. Accepted values: `enable`, `disable`. |
-| `--document <value...>` | No | Documents to update, by identifier. (space-separated, or @path / @- with one value per line). |
+| `--document <value...>` | No | Documents to update, by identifier. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
 | `--select-all` | No | Apply to every document in the knowledge base. |
 | `--enabled-filter <value>` | No | With `selectAll`, restrict the update to documents in this state. Accepted values: `all`, `enabled`, `disabled`. |
 
@@ -505,6 +535,8 @@ sim knowledge documents list <knowledgeBaseId> [options]
 sim knowledge documents update <knowledgeBaseId> <documentId> [options]
 ```
 
+Update Document (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -604,6 +636,8 @@ sim knowledge create [options]
 sim knowledge connectors create <knowledgeBaseId> [options]
 ```
 
+Create Knowledge Connector (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -634,6 +668,8 @@ sim knowledge connectors create <knowledgeBaseId> [options]
 sim knowledge connectors delete <knowledgeBaseId> <connectorId> [options]
 ```
 
+Delete Knowledge Connector (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -663,6 +699,8 @@ sim knowledge connectors delete <knowledgeBaseId> <connectorId> [options]
 sim knowledge connectors get <knowledgeBaseId> <connectorId>
 ```
 
+Get Knowledge Connector (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -680,6 +718,8 @@ sim knowledge connectors get <knowledgeBaseId> <connectorId>
 sim knowledge connectors documents list <knowledgeBaseId> <connectorId> [options]
 ```
 
+List Knowledge Connector Documents (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -709,6 +749,8 @@ sim knowledge connectors documents list <knowledgeBaseId> <connectorId> [options
 sim knowledge connectors documents update <knowledgeBaseId> <connectorId> [options]
 ```
 
+Update Knowledge Connector Documents (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -727,7 +769,7 @@ sim knowledge connectors documents update <knowledgeBaseId> <connectorId> [optio
 | Option | Required | Description |
 | --- | --- | --- |
 | `--operation <value>` | Yes | Whether to restore or exclude the selected documents. Accepted values: `restore`, `exclude`. |
-| `--document <value...>` | Yes | Connector document identifiers to update. (space-separated, or @path / @- with one value per line). |
+| `--document <value...>` | Yes | Connector document identifiers to update. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
 
 </CommandTable>
 
@@ -737,6 +779,8 @@ sim knowledge connectors documents update <knowledgeBaseId> <connectorId> [optio
 sim knowledge connectors list <knowledgeBaseId> [options]
 ```
 
+List Knowledge Connectors (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -765,6 +809,8 @@ sim knowledge connectors list <knowledgeBaseId> [options]
 sim knowledge connectors sync <knowledgeBaseId> <connectorId> [options]
 ```
 
+Queue a knowledge connector synchronization (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -793,6 +839,8 @@ sim knowledge connectors sync <knowledgeBaseId> <connectorId> [options]
 sim knowledge connectors update <knowledgeBaseId> <connectorId> [options]
 ```
 
+Update Knowledge Connector (personal API key required)
+
 **Arguments**
 
 <CommandTable>
@@ -990,7 +1038,7 @@ sim knowledge search [options]
 
 | Option | Required | Description |
 | --- | --- | --- |
-| `--kb <value...>` | Yes | Knowledge base ID (repeatable) (space-separated, or @path / @- with one value per line). |
+| `--kb <value...>` | Yes | Knowledge base ID (repeatable) (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
 | `--query <value>` | No | Text to search for. |
 | `--top-k <value>` | No | Maximum number of search results to return. Must be a whole number between 1 and 100; the boundary schema only bounds the range, so a fractional value is admitted here and then rejected with 400 during search. |
 | `--tag-filters <json\|@file>` | No | Tag filters as [&#123;"tagName":"...","operator":"...","value":"..."&#125;] (JSON, or @path / @- to read a file or stdin). |