add worai self-update command docs (#30)

Author: ziodave

TODO.md

@@ -5,4 +5,5 @@
 - [x] 2026-02-05 Make sidebar loading resilient to .js/.ts generation differences and add a test.
 - [x] 2026-02-05 Bump patch version to 3.12.1 for sidebar build fix.
 - [x] 2026-02-05 Add 34.52.203.209 to the IP whitelist.
+- [x] 2026-02-19 Add worai CLI self-update command docs and startup update-check configuration notes.
 - [x] 2026-02-19 Sync worai CLI docs with current command flags/defaults (`structured-data`, `google-search-console`, `configuration`, and command option tables).

docs/worai/commands/self.md

@@ -0,0 +1,26 @@
+---
+title: self
+---
+
+Manage worai CLI update workflows.
+
+## Usage
+- `worai self update [options]`
+
+## self update
+Check PyPI for a newer `worai` version and print (or run) the recommended upgrade command.
+
+### Options
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `--check-only` | bool | `false` | Only check for updates and print the suggested upgrade command. |
+| `--yes`, `-y` | bool | `false` | Run the upgrade command immediately. |
+
+### Examples
+- `worai self update --check-only`
+- `worai self update --yes`
+
+### Notes
+- Startup update checks are cached (24h) and non-blocking.
+- Disable startup update checks via `WORAI_DISABLE_UPDATE_CHECK=1` or config `updates.check = false`.

docs/worai/configuration.md

@@ -24,6 +24,7 @@ log_level = "info"
 api_key = "wl_..."
 
 [gsc]
+id = "sc-domain:example.com"
 client_secrets = "/path/to/client_secrets.json"
 
 [ga]
@@ -32,11 +33,16 @@ client_secrets = "/path/to/client_secrets.json"
 
 [oauth]
 token = "/path/to/oauth_token.json"
+
+[updates]
+check = true
 ```
 
 Notes:
+- `gsc.id` can be used as default `--site` for commands that support it.
 - `oauth.token` is the shared token file for GSC + GA4. If not set via config or env, the CLI defaults to `./oauth_token.json`.
 - Legacy keys `gsc.token` and `ga.token` are still read, but must point to the same file when used.
+- `updates.check = false` disables startup update checks.
 
 ## Environment variables
 
@@ -52,6 +58,7 @@ Notes:
 - `GA_ID` — GA4 property ID for Analytics sections.
 - `GA_CLIENT_SECRETS` — path to OAuth client secrets JSON for GA4.
 - `GSC_TOKEN` / `GA_TOKEN` — legacy aliases for `OAUTH_TOKEN` (must point to the same file if used).
+- `WORAI_DISABLE_UPDATE_CHECK` — set to `1|true|yes|on` to disable startup update checks.
 
 Example environment setup:
 ```

docs/worai/install.md

@@ -16,6 +16,7 @@ If you plan to run `seocheck`, install Playwright browsers:
 - `worai --help`
 - `worai seocheck https://example.com/sitemap.xml`
 - `worai google-search-console --site sc-domain:example.com --client-secrets ./client_secrets.json`
+- `worai self update --check-only`
 - `worai <command> --help`
 
 ## Autocompletion

sidebars.js

@@ -197,6 +197,7 @@ const sidebars = {
                 "worai/commands/graph",
                 "worai/commands/link-groups",
                 "worai/commands/patch",
+                "worai/commands/self",
                 "worai/commands/structured-data",
                 "worai/commands/list-entities-outside-dataset",
                 "worai/commands/validate",