@ted-galago/wave-cli 0.1.2 → 0.1.4

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.
package/README.md CHANGED
@@ -26,9 +26,18 @@ Or run locally:
26
26
  npm run dev -- tasks list --project-id 123 --organization-id 42 --base-url https://api.example.com --token token
27
27
  ```
28
28
 
29
+ Secure stdin auth/context examples:
30
+
31
+ ```bash
32
+ printf '%s' "token-value" | wave --token-stdin --base-url https://api.example.com --organization-id 42 tasks list --page 1 --per 10
33
+
34
+ printf '%s' '{"token":"token-value","baseUrl":"https://api.example.com","organizationId":"42","agentName":"atlas"}' \
35
+ | wave --auth-json-stdin tasks list --page 1 --per 10
36
+ ```
37
+
29
38
  ## Runtime Contract
30
39
 
31
- Required env:
40
+ Required (from flags, stdin, or env):
32
41
 
33
42
  - `WAVE_API_TOKEN`
34
43
  - `WAVE_API_BASE_URL`
@@ -45,11 +54,12 @@ Optional env:
45
54
  - `WAVE_OPENAPI_URL` (hosted contract file)
46
55
  - `WAVE_OPENAPI_VERSION` (pinned spec version/hash)
47
56
 
48
- Flag precedence:
57
+ Deterministic precedence:
49
58
 
50
- - auth: `WAVE_API_TOKEN`, then `WAVE_JWT` (legacy), then `--token`, then `--jwt` (legacy)
51
- - base URL: `--base-url`, then `WAVE_API_BASE_URL`, then `WAVE_API_URL` (legacy)
52
- - organization: `WAVE_ORGANIZATION_ID`, then `WAVE_ORG_ID` (legacy), then `--organization-id`
59
+ - explicit flags (`--token` / `--jwt`, `--base-url`, `--organization-id`, and tracing/runtime flags)
60
+ - stdin context (`--token-stdin` or `--auth-json-stdin`)
61
+ - env vars (`WAVE_*`)
62
+ - failure with structured JSON error
53
63
 
54
64
  ## Commands
55
65
 
@@ -78,6 +88,7 @@ wave pulse update --id 12 --data-json '{"status":"on_track"}'
78
88
  ```
79
89
 
80
90
  All commands require organization context via `--organization-id` or `WAVE_ORGANIZATION_ID`.
91
+ You can also provide `organizationId` via `--auth-json-stdin`.
81
92
 
82
93
  ## Parent-Child Create Rules
83
94