@hyperscale0/cli 1.0.246 → 1.0.248

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/AGENTS.md +12 -3
  2. package/hyperscale.js +45 -44
  3. package/package.json +2 -2
package/AGENTS.md CHANGED
@@ -21,14 +21,23 @@ help command tree
21
21
  Start with `hyperscale auth login --no-open --json`. The URL and code go to
22
22
  stderr. A person approves them in the browser. Rerun to resume a pending login.
23
23
  Verify with `hyperscale whoami --json`. Signup uses `auth signup --email <email>
24
- --name <name> --company <company>`. Logout removes the local token; `--revoke`
25
- revokes it too. Do not print or persist credentials in project files.
24
+ --name <name> --company <company>`. Do not print or persist credentials in
25
+ project files.
26
+
27
+ Browser login creates a named agent member with its own CLI grant. Access
28
+ tokens last ten minutes; the CLI rotates the refresh token and keeps both in
29
+ Keychain or a mode 0600 file. Logout removes them locally. Revoke the member or
30
+ grant in the browser; `--revoke` only revokes a human PAT. Sandbox work within
31
+ the grant runs directly. A live action exits 3 with `agent_approval_required`
32
+ and a browser link; a human approves it with their password. The CLI cannot
33
+ approve its own work.
26
34
 
27
35
  Every command accepts `--json`. Ordinary success is one JSON value on stdout;
28
36
  failure is an error object on stderr. Errors retain status, code, message,
29
37
  fix, details and available request, operation, receipt and trace IDs.
30
38
  JSON output has no ANSI codes, banners, spinners or prompts.
31
- Exit codes: 0 success, 1 failure, 2 HSX check or plan cannot proceed.
39
+ Exit codes: 0 success, 1 failure, 2 HSX check or plan cannot proceed,
40
+ 3 live action waiting for human approval.
32
41
 
33
42
  `hsx watch --json` emits one JSON object per line with `type` set to `check`,
34
43
  `plan` or `error`. Check and plan events contain `data`; errors contain `error`.