@supercheck/cli 0.1.0-beta.9 → 0.1.1-beta.2

package/README.md

@@ -26,13 +26,22 @@ Or run directly with `npx`:
 npx @supercheck/cli --help
 ```
 
+## Upgrade
+
+Upgrade the CLI to the latest release:
+
+```bash
+supercheck upgrade
+```
+
+
 ## Quick Start
 
 1. **Initialize a new project**:
    ```bash
    supercheck init
    ```
-   This creates a `supercheck.config.ts` and a `_supercheck_` directory with example tests.
+  This creates a `supercheck.config.ts` and a `_supercheck_` directory with example tests under `_supercheck_/playwright` and `_supercheck_/k6`.
 
 2. **Authenticate**:
    ```bash
@@ -51,6 +60,29 @@ npx @supercheck/cli --help
    supercheck deploy
    ```
 
+5. **Validate scripts**:
+  ```bash
+  supercheck validate
+  ```
+  Validation runs automatically during deploy and cannot be skipped.
+
+6. **Run tests locally (optional)**:
+  ```bash
+  supercheck test run --local --file _supercheck_/playwright/homepage-check.<id>.pw.ts
+  supercheck test run --local --all --type browser
+  supercheck test run --local --all --type performance
+  supercheck test run --local --all --type api
+  supercheck test run --local --all --type database
+  supercheck test run --local --all --type custom
+  ```
+
+  For remote execution with persisted run history, trigger a job:
+  ```bash
+  supercheck job run --id <job-id>
+  # or (CI/CD trigger key flow)
+  supercheck job trigger <job-id> --wait
+  ```
+
 ## Command Reference
 
 ### Authentication
@@ -69,29 +101,58 @@ npx @supercheck/cli --help
 | `supercheck pull` | Sync cloud resources to local config |
 | `supercheck diff` | Preview changes between local config and cloud |
 | `supercheck deploy` | Apply local config changes to the cloud |
+| `supercheck validate` | Validate local test scripts (same rules as Playground) |
 | `supercheck destroy --force` | Remove all managed resources from the cloud |
 | `supercheck config validate` | Validate your `supercheck.config.ts` |
+| `supercheck config print` | Print resolved `supercheck.config.ts` |
+
+> Note: In the current API, status pages are readable/deletable from CLI sync flows, but create/update endpoints are not available.
 
 ### Jobs & Runs
 
 | Command | Description |
 |---|---|
 | `supercheck job list` | List all jobs |
-| `supercheck job create` | Create a new job |
-| `supercheck job run` | Run a job immediately |
+| `supercheck job get <id>` | Get job details |
+| `supercheck job create --name <name> --tests <test-id...>` | Create a new job with tests |
+| `supercheck job update <id> --name ...` | Update job fields |
+| `supercheck job delete <id>` | Delete a job |
+| `supercheck job keys <jobId>` | List trigger keys for a job |
+| `supercheck job keys create <jobId> --name <name>` | Create a trigger key |
+| `supercheck job keys delete <jobId> <keyId>` | Revoke a trigger key |
+| `supercheck job run --id <job-id>` | Run a job immediately |
+| `supercheck job run --local` | Run a job locally using local test files |
 | `supercheck job trigger <id> --wait` | Trigger a job and wait for completion (CI/CD) |
 | `supercheck run list` | List recent execution runs |
+| `supercheck run get <id>` | Get run details |
+| `supercheck run status <id>` | Get run status |
+| `supercheck run permissions <id>` | Get run permissions |
 | `supercheck run stream <id>` | Stream live console output |
+| `supercheck run cancel <id>` | Cancel a running execution |
 
 ### Tests & Monitors
 
 | Command | Description |
 |---|---|
 | `supercheck test list` | List all tests |
-| `supercheck test create` | Create a new test |
-| `supercheck test validate` | Validate local test scripts |
+| `supercheck test get <id>` | Get test details |
+| `supercheck test create` | Create a new test (browser, performance, api, database, custom) |
+| `supercheck test update <id>` | Update a test |
+| `supercheck test delete <id>` | Delete a test |
+| `supercheck test validate` | Validate local test scripts (same rules as Playground) |
+| `supercheck test run` | Run tests locally |
+| `supercheck test tags <id>` | List tags for a test |
+| `supercheck test status <id>` | Stream live status events for a test |
 | `supercheck monitor list` | List all monitors |
-| `supercheck monitor status <id>` | Check real-time monitor status |
+| `supercheck monitor get <id>` | Get monitor details |
+| `supercheck monitor results <id>` | Get monitor check results |
+| `supercheck monitor stats <id>` | Get monitor statistics |
+| `supercheck monitor status <id>` | Get current monitor status |
+| `supercheck monitor create ...` | Create a monitor |
+| `supercheck monitor update <id> ...` | Update a monitor |
+| `supercheck monitor delete <id>` | Delete a monitor |
+
+`supercheck test run` is local-only. `--cloud`, `--id`, and `--location` are deprecated for direct test execution.
 
 ### Variables, Tags & Notifications
 
@@ -99,7 +160,7 @@ npx @supercheck/cli --help
 |---|---|
 | `supercheck var list / get / set / delete` | Manage project variables |
 | `supercheck tag list / create / delete` | Manage tags |
-| `supercheck notification list / delete` | Manage notification providers |
+| `supercheck notification list / get / create / update / delete / test` | Manage notification providers |
 | `supercheck alert history` | View alert history |
 | `supercheck audit` | View audit logs (admin) |
 
@@ -109,6 +170,8 @@ npx @supercheck/cli --help
 |---|---|
 | `supercheck health` | Check API health |
 | `supercheck locations` | List available execution locations |
+| `supercheck doctor` | Validate local CLI dependencies and config |
+| `supercheck upgrade` | Upgrade the CLI to the latest release |
 
 ## Configuration
 
@@ -125,10 +188,10 @@ export default defineConfig({
   },
   tests: {
     playwright: {
-      testMatch: '_supercheck_/tests/**/*.pw.ts',
+      testMatch: '_supercheck_/playwright/**/*.pw.ts',
     },
     k6: {
-      testMatch: '_supercheck_/tests/**/*.k6.ts',
+      testMatch: '_supercheck_/k6/**/*.k6.ts',
     },
   },
   monitors: [