@rogatio/cli 6.14.3 → 6.16.0

package/README.md

@@ -9,7 +9,7 @@ optional local runtime used for response/request body rewriting.
 
 ## Install
 
-Requires Node.js 24 or newer. Install the CLI globally with your preferred
+Requires Node.js 26 or newer. Install the CLI globally with your preferred
 package manager:
 
 ```sh
@@ -38,12 +38,15 @@ rogatio <command> [options]
 | --- | --- |
 | `rogatio edit [path]` | Launch the browser editor. Any filename is accepted; the default is `.rogatio.json` in the current directory. `--port <n>` fixes the port; `--no-open` skips opening a browser. Edits save back to the file that was opened. |
 | `rogatio verify [path]` | Validate a project file (schema + compiler). Any filename is accepted; the default is `.rogatio.json` in the current directory. |
+| `rogatio doctor [path]` | Check Node, the project file, the native host, the device CA, a loopback PAC answer, and optional AI Assist. `--json` prints a stable report. `--check-updates` asks the npm registry about a newer CLI. Release users never pass `--extension-id`. |
 | `rogatio import requestly <export.json>` | Migrate a Requestly export into `.rogatio.json`. `--out <path>` chooses the file (default `.rogatio.json`); `--merge` appends onto an existing project; `--json` prints the report. |
 | `rogatio test [path] [url...]` | Run offline dry-run tests. Any filename is accepted; the default is `.rogatio.json` in the current directory. |
 | `rogatio ai <setup\|ls\|show\|delete\|test>` | AI provider configuration. `setup` interactive; `ls` list; `show` redacted; `delete` remove; `test` connection. |
 | `rogatio runtime <install\|uninstall\|verify>` | Register the native-messaging host with `install` and trust the device-local CA in one **transactional** call; it needs elevated privileges (Linux `sudo`, macOS keychain authorization, Windows Administrator) and rolls back with exit `1` and `trust unsupported: <reasons>` when a capability or elevation is missing. Release users never pass `--extension-id`. That flag is only for development (a local unpacked build without the release key) and for forks. `uninstall` removes the host manifest, the device-local CA files, and the CA trust installation (idempotent). `verify` reports whether manifest, `runtime-host` wrapper, allowed origins, and CA trust are all valid, and fails when `allowed_origins` omits the release ID. Release users never pass `--extension-id` on verify either. |
 | `rogatio runtime host [path]` | Run the consolidated native-messaging host for the project (pair/authorize/body transforms and mock responses over stdio). Normally launched by the browser; run manually only for debugging. `--root <dir>` overrides the confined mock file root. When omitted, a saved device-local root for that project file is used, otherwise the project directory. A stdin project that contains a file mock requires `--root`. |
 
+`rogatio edit` includes **Run checks**. It calls `POST /api/doctor` (CSRF-protected) and shows editor checks plus the same report as `rogatio doctor` for the open file. A provider configured after the page opened is picked up on the next `rogatio edit`.
+
 Global options: `--help, -h` and `--version, -v`. Run `rogatio <command> --help`
 for command-specific usage.
 
@@ -66,8 +69,8 @@ rogatio runtime host .rogatio.json
 ## Exit codes
 
 - `0` — success
-- `1` — invalid project (diagnostics present), test/validation errors, or a failed
-  `runtime install` / `runtime verify` check
+- `1` — invalid project (diagnostics present), test/validation errors, a failed
+  `runtime install` / `runtime verify` check, or a required `rogatio doctor` check
 - `2` — usage or IO error
 
 ## Local runtime