feat(cli): add sim cli search and default output to JSON (#8426)

* feat(cli): add sim cli search and default output to JSON

- sim cli search ranks every command in the tree against a plain-language
  query, locally via minisearch, and returns the top 5
- root and group --help open with a discovery note when a coding agent runs
  the CLI, pointing it at sim cli search
- default output format is now json; table stays available via --output,
  SIM_OUTPUT, or sim configure --set-output
- reword command descriptions that lacked the words people search with

* fix(cli): describe billing status by what it reports, scope search privacy claim to the query

* chore(cli): release 2.2.0

Author: TheodoreSpeaks

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

@@ -7,13 +7,13 @@ import { CommandTable } from '@/components/ui/command-table'
 
 Every command below also accepts the [global options](/cli/commands#global-options).
 
-## Show billing status and current-period credit usage
+## Show billing status, credits spent this period, and storage used
 
 ```bash
 sim billing status [options]
 ```
 
-Show billing status and current-period credit usage (credits and storage require an OAuth login or personal API key)
+Show billing status, credits spent this period, and storage used (credits and storage require an OAuth login or personal API key)
 
 **Options**
 

apps/docs/content/docs/cli/cli.mdx

@@ -0,0 +1,24 @@
+---
+title: CLI
+description: Discover commands in this CLI — every subcommand, argument, and flag
+---
+
+import { CommandTable } from '@/components/ui/command-table'
+
+Every command below also accepts the [global options](/cli/commands#global-options).
+
+## Find the command for a task, described in plain words
+
+```bash
+sim cli search <query...>
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `query...` | Yes | What you want to do, e.g. "cancel a workflow run" |
+
+</CommandTable>

apps/docs/content/docs/cli/commands.mdx

@@ -32,6 +32,7 @@ These apply to every command, and may be written before or after it.
 | --- | --- |
 | [`sim profiles`](/cli/profiles) | List profiles or add a workspace profile that shares a stored login |
 | [`sim telemetry`](/cli/telemetry) | Control anonymous usage reporting |
+| [`sim cli`](/cli/cli) | Discover commands in this CLI |
 | [`sim audit-logs`](/cli/audit-logs) | Manage audit logs |
 | [`sim billing`](/cli/billing) | Manage billing |
 | [`sim blocks`](/cli/blocks) | Manage blocks |
@@ -56,7 +57,7 @@ These apply to every command, and may be written before or after it.
 | [`sim workflows`](/cli/workflows) | Manage workflows |
 | [`sim workspaces`](/cli/workspaces) | Manage workspaces |
 
-## Sign in through the browser and store the login for the profile
+## Log in through the browser and store the login for the profile
 
 ```bash
 sim login [options]
@@ -108,7 +109,7 @@ sim whoami [options]
 
 </CommandTable>
 
-## Set a profile's endpoint, default workspace, or output format
+## Switch a profile's default workspace, or set its endpoint or output format
 
 ```bash
 sim configure [options]

apps/docs/content/docs/cli/configuration.mdx

@@ -40,7 +40,7 @@ sim profile add acme --workspace 7e2d9c14-6b83-4a55-8f01-c4d3e9a76b28
 ```bash
 sim configure --set-endpoint http://localhost:3000 --profile dev
 sim configure --set-workspace 5c81f3a6-0e27-4b94-8d15-a7f60c39b2e8 --profile dev
-sim configure --set-output json
+sim configure --set-output table
 ```
 
 | Option | What it sets |
@@ -64,7 +64,7 @@ Each setting resolves independently, and the first match wins:
 | 1 | Command-line flag — `--endpoint`, `--workspace`, `--output` |
 | 2 | Environment — `SIM_ENDPOINT`, `SIM_API_KEY`, `SIM_WORKSPACE`, `SIM_OUTPUT` |
 | 3 | `~/.sim/config` for the selected profile and `~/.sim/credentials` for its `auth_profile`, when set |
-| 4 | Built-in default — `https://www.sim.ai` and `table` |
+| 4 | Built-in default — `https://www.sim.ai` and `json` |
 
 `sim whoami` prints the winning source for each setting:
 

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

@@ -646,7 +646,7 @@ sim files upload <path> [options]
 
 </CommandTable>
 
-## Get a file’s content
+## Download a file’s content to stdout or a local file
 
 ```bash
 sim files get <fileId> [options]

apps/docs/content/docs/cli/index.mdx

@@ -7,9 +7,10 @@ import { Step, Steps } from 'fumadocs-ui/components/steps'
 import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
 
 `sim` is the command line for Sim. Sign in once, then run workflows, query tables,
-move files, search knowledge bases, and read run logs from the terminal. Use
-`--output json` for structured results that pipe into `jq`, cron jobs, and CI
-pipelines. See [Output formats](/cli/output) for commands that emit raw content
+move files, search knowledge bases, and read run logs from the terminal. Results
+are JSON by default, so they pipe into `jq`, cron jobs, CI pipelines, and coding
+agents; use `--output table` to read them as tables. Don't know a command? Run
+`sim cli search "<what you want to do>"`. See [Output formats](/cli/output) for commands that emit raw content
 or local configuration.
 
 ## Install

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

@@ -455,7 +455,7 @@ Enable or disable every matching document (OAuth login or personal API key requi
 
 </CommandTable>
 
-## Delete document
+## Delete a document from a knowledge base
 
 ```bash
 sim knowledge documents delete <knowledgeBaseId> <documentId> [options]

apps/docs/content/docs/cli/logs.mdx

@@ -60,7 +60,7 @@ sim logs stats [options]
 
 </CommandTable>
 
-## List logs
+## List run logs, such as failed or errored runs, by workflow, trigger or time
 
 ```bash
 sim logs list [options]
@@ -100,7 +100,7 @@ sim logs list [options]
 
 </CommandTable>
 
-## Watch runs as they arrive, printing each new run once
+## Watch runs live as they arrive, printing each new run once
 
 ```bash
 sim logs follow [options]

apps/docs/content/docs/cli/meta.json

@@ -15,6 +15,7 @@
     "commands",
     "profiles",
     "telemetry",
+    "cli",
     "audit-logs",
     "billing",
     "blocks",

apps/docs/content/docs/cli/output.mdx

@@ -7,16 +7,16 @@ Commands that return structured API data support four output formats.
 
 | Format | For |
 | --- | --- |
-| `table` | reading (default) |
-| `json` | piping into `jq` |
+| `json` | agents, scripts, and piping into `jq` (default) |
+| `table` | reading |
 | `yaml` | piping into anything that reads YAML |
 | `text` | shell loops — tab-separated, no header, no colour |
 
 Select one per command, save it to the profile, or set it in the environment:
 
 ```bash
-sim tables get tbl_9f3c1a05d4b7426e8c2f0917ab35de64 --output json
-sim configure --set-output json
+sim tables get tbl_9f3c1a05d4b7426e8c2f0917ab35de64 --output table
+sim configure --set-output table
 SIM_OUTPUT=yaml sim logs list > logs.yaml
 ```