@sylphx/cli 0.19.2 → 0.20.0

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/CHANGELOG.md CHANGED
@@ -1,809 +1,22 @@
1
- # @sylphx/cli
1
+ # Changelog
2
2
 
3
- ## 0.19.2
3
+ ## 0.20.0
4
4
 
5
- ### Patch Changes
5
+ ### Breaking (product path)
6
6
 
7
- - 4b3f006: Add an authorized runtime env resolve surface for `sylphx run-cmd`.
8
- The management contract and SDK now expose `GET /projects/:id/env-vars/resolve`,
9
- which resolves plaintext runtime env only behind `project:secrets:manage`.
10
- The CLI consumes that resolved surface so child processes receive remote
11
- environment secrets instead of silently skipping key-only env-var rows.
12
- - Updated dependencies [7664dd1]
13
- - Updated dependencies [1e18165]
14
- - Updated dependencies [aa1f8d3]
15
- - Updated dependencies [87ec611]
16
- - Updated dependencies [bcc0847]
17
- - Updated dependencies [1e18165]
18
- - @sylphx/sdk@0.22.0
7
+ - Replaces the retired TypeScript Effect CLI with a **Rust native binary
8
+ install channel**.
9
+ - `npm install -g @sylphx/cli` now delivers the same `sylphx` binary as
10
+ `cargo install sylphx-cli` (crates.io).
11
+ - Platform packages: `@sylphx/cli-linux-x64` (and other os/cpu packages as
12
+ published). Missing platform packages fail closed with cargo fallback text.
19
13
 
20
- ## 0.19.1
14
+ ### Removed
21
15
 
22
- ### Patch Changes
16
+ - TypeScript reimplementation (~60 historical commands) is no longer shipped
17
+ via this package. Day-1 surface is the shipped Rust CLI cores (health,
18
+ whoami, orgs, projects, environments, deployments, api, version-info).
23
19
 
24
- - 11cdd87: Declare `typeid-js` as a runtime dependency of `@sylphx/contract` and republish the SDK/CLI graph so globally installed CLI packages can load contract schemas without missing dependency failures.
25
- - Updated dependencies [11cdd87]
26
- - @sylphx/sdk@0.21.1
20
+ ## 0.19.x and earlier
27
21
 
28
- ## 0.19.0
29
-
30
- ### Minor Changes
31
-
32
- - a558ae8: Add the Agent Resource Graph public surface: contract schemas and the
33
- Management-plane project graph endpoint, typed management client access, and the
34
- `sylphx agent-resources graph` CLI command for read-only resource awareness.
35
- - b25943a: Add `sylphx deploy --force` and a machine-readable deployment `skipReason` (#2941).
36
-
37
- A genuinely-new merged commit could be deduped to `status=skipped` (no build/rollout) with no override and no explanation. The deploy skip contract now skips only when every targeted service is already running the resolved commit; any other state builds and rolls out, `--force` always builds, and a skipped deployment carries a machine-readable `skipReason` surfaced via the management API + CLI.
38
-
39
- - ce8e00e: Add the `sylphx device-sessions` command group for driving interactive Android device sessions (ADR-2560): `create` (boots a session and, with `--wait`, polls to `ready`), `list`, `get`, `install <id> <apk-uri>`, `input <id> tap|swipe|key|text …`, `launch`, `screenshot` (saves the inline PNG or prints the hosted URL, `--open` to view), `logcat`, and `rm`. Every subcommand supports `--json`, `--project`/`--org` scoping, and RFC 7807 error rendering, mirroring the `sandbox` and `mobile-device-tests` groups. The control-plane endpoints are consumed through the `ApiService` `authedFetch` passthrough — the runtime/contract are unchanged.
40
- - 8655c00: Distributed Batch Compute — the public Distributed Run surface (PR #2822, ADR
41
- distributed-batch-compute, ADR-040 successor). Fan one logical job out to N
42
- indexed shards with a single call: the platform owns sharding, gang start
43
- (all shards admitted together or none), the per-org concurrent-shard budget,
44
- and the aggregate + per-shard rollup. `parallelism` defaults to `1`, so the
45
- existing single-shard `run()` path is the N=1 case and stays byte-identical on
46
- the wire (zero breaking change).
47
-
48
- - `@sylphx/contract`: the `DistributedRun` read model and create surface —
49
- `parallelism` (1..256), `completionMode` (`Indexed` / `NonIndexed`),
50
- gang-scheduling, per-shard status (`DistributedRunShard`), and the
51
- aggregate roll-up. The `GET /runs/:id?view=distributed` additive superset of
52
- the single-shard read model. Adds the larger `2xlarge` / `mem-2xlarge`
53
- machine tiers to `MachineSize`.
54
- - `@sylphx/sdk`: `RunsClient.runDistributed()` (a strict superset of
55
- `RunsClient.run()`), `runDistributedFromId()`, the `DistributedRunHandle`
56
- (`wait` / `status` / `shards` / `logs` / `cancel`), and the
57
- `CreateDistributedRunOptions` / `DistributedRun` / `DistributedRunShard`
58
- types. Replaces hand-rolled client-side `Promise.all` fan-out.
59
- - `@sylphx/cli`: `sylphx run --parallelism` submits a distributed run with a
60
- `--follow` aggregate + per-shard status table, and `sylphx runs`
61
- (`list` / `get` / `logs --shard` / `cancel`) drives the read model. The CLI
62
- dogfoods the public SDK `RunsClient` through `packages/cli/src/services/runs.ts`.
63
-
64
- - 38d1888: Add the operator-only `POST /operator/env-services/admit-built-artifact` contract, Management SDK method, `platform:envservicesbuiltartifacts:admit` scope, and `sylphx admin env-services admit-built-artifact` CLI command. The command admits a digest-pinned managed-registry image into the ADR-070 `builds -> artifacts -> deployments -> environment_services` pointer chain for audited control-plane bootstrap and disaster recovery.
65
- - 28b8da3: Add the audited managed-resource requeue operator surface: contract schemas and
66
- `POST /operator/resources/:id/requeue`, typed management SDK access, and the
67
- `sylphx admin resources requeue` CLI command. The operation accepts only rows
68
- parked at `reconcile_status='failed'`, clears failed-attempt metadata, bumps
69
- generation, wakes the controller, and preserves controller-only Kubernetes
70
- manifest ownership.
71
- - 266c3c2: Materialize manifest `[env]` into the runtime container (#2938).
72
-
73
- `sylphx deploy` now publishes the manifest and pins the exact published version into the deploy trigger (`manifestVersion`), so the server captures that version's effective `[env]` into each environment's desired state and the reconciler materializes it into the runtime container. Capture is env-scoped (never the project-global latest row) and fenced with the rollout side effect — atomic with the desired-pointer promotion on an image deploy, and before build dispatch on a build deploy. The contract exposes the manifest `[env]` value / `from_secret` / `from_resource` schema and the managed-key guard.
74
-
75
- - 978b924: Allow direct and distributed Runs to resolve their image from a same-environment
76
- service deployment via `imageFromService` / `--image-from-service`, so customers
77
- can submit batch jobs against their own built service images without scraping
78
- registry tags or using a privileged platform-only path.
79
- - 3508a03: Expose a bounded `backoffLimitPerIndex` retry budget for opportunistic distributed Runs. Customers can now submit `parallelism > 1`, `gangScheduling: false` workloads that tolerate low-priority shard preemptions without a private platform workaround; SDK and CLI helpers forward the public field.
80
- - 282b22b: Extend operator env-service built-artifact admission so same-service,
81
- same-digest built artifacts with existing build provenance can repair stale
82
- `sourceRef` pullspec drift. The management contract and SDK now return
83
- `sourceRefRepaired`, and the CLI surfaces the repair outcome.
84
- - 4aa3c84: Add Workspace Compute sandbox management schemas and endpoints to the public
85
- contract. The Management SDK now consumes those contract-backed sandbox paths
86
- and types, while the CLI adds safe structured `sandbox create/list/info` output
87
- that reports `tokenPresent` without printing runtime token material.
88
- The operator env desired-spec contract also gains audited `sandboxWarmPool`
89
- controls so warm-pool capacity can be enabled without raw database edits.
90
- - 9036d89: Add `sylphx dev` — a local BaaS emulator for minute-zero, zero-signup offline development (ADR-2753). The command prints the verified quickstart for standing up the real `apps/runtime` BaaS against a local Postgres + Valkey (`docker-compose.dev.yml`), applying the schema declaratively from the Drizzle SSOT, seeding a real dev project with `pk_dev_`/`sk_dev_` keys via the canonical credential helpers, and pointing the SDK at `http://localhost:<port>/v1` using the runtime's built-in `x-project-ref` local-routing header. `--print-connection` emits only the connection block for scripting an app's `.env`. Local-only and additive: it never requires `sylphx login` and changes no existing command. Surfaces the emulator cannot faithfully provide locally (storage, email delivery, cluster-backed sandboxes/runs) return labelled errors rather than silent fakes — the fidelity contract and the staged expand path (one-command supervisor, a published runtime-emulator image for zero-checkout `npx @sylphx/cli dev`) are recorded in the ADR.
91
-
92
- ### Patch Changes
93
-
94
- - d7a7864: Improve `sylphx link` and `sylphx tokens` UX: surface actionable recovery hints on the empty/no-result paths (point to `sylphx init` / the console URL / `sylphx tokens create`) instead of dead-ending.
95
- - ee1d5b8: Gate the remaining destructive CLI commands behind confirmation (burn-down of ADR-2692's KNOWN_UNGATED list): `consent delete`, `webhooks delete`, `session-replay delete`, `realtime channels delete`, `rate-limits strategies delete`, and `admin branch-databases destroy` now require confirmation (skip with `--yes`). Every destructive `delete`/`destroy` command in the CLI is now confirmation-gated; the CI guard's allowlist is empty.
96
- - 7ed8a8a: Gate destructive CLI commands behind a confirmation prompt. `sylphx secrets delete` and `sylphx oidc delete` previously issued an irreversible delete with no "are you sure?" — a typo could permanently destroy a secret (and all its versions) or a trust policy. Both now require confirmation (skip with `--yes` for CI/automation), matching the rest of the CLI. A CI guard pins the contract for every `delete`/`destroy` command.
97
- - e511c3b: Rebuild and publish the CLI with the manifest contract that accepts web-service
98
- `path_prefixes`, so deploy preflight validates canonical multi-service
99
- `sylphx.toml` files without requiring the operator recovery `--skip-manifest`
100
- escape hatch.
101
- - 98007d6: Annotate the in-memory `Blob.arrayBuffer()` read in `user export download` as
102
- `effect-promise-ok` and narrow the `ConfigService` import to a type-only import.
103
- No runtime behaviour change; satisfies the new Effect-promise-defect guard.
104
- - 0c963eb: Fix silent false-success on `sylphx projects create`/`delete`. The Management SDK mis-handled two response envelopes: `projects.create` returned the `CreateProjectResult` wrapper (`{ app: Project }`) instead of the project, so callers read `id`/`name`/`slug` off `undefined` (`✓ Created project undefined`, and `init`/`deploy` failed downstream); and `projects.delete` discarded its `DeleteProjectResult` (`{ deleted, queued, warnings }`) as `void`, so the CLI always printed `✓ Deleted` even when teardown was only queued (reconciler-managed, async). `create` now unwraps `.app` (mirroring `list`'s `.data` unwrap) and `delete` returns the result; the CLI reports deleted vs queued-for-teardown and surfaces warnings.
105
- - 26dbbfd: Fix `sylphx init --git` so it actually connects the repo and deploys from the
106
- right branch. The CLI now detects the repository's default branch (`origin/HEAD`,
107
- falling back to the checked-out branch) and forwards it as `gitBranch` on create,
108
- and the server persists `gitRepository`/`gitBranch` onto the new project's
109
- production environment. Previously `init --git` left the environment
110
- disconnected (`githubRepo` null, branch defaulted to `main`), so a `master`-default
111
- repo skipped its first deploy with `gitCommit: null`. Refs #2832 (Bug 3).
112
- - Updated dependencies [b69dce8]
113
- - Updated dependencies [52c0603]
114
- - Updated dependencies [7da22e1]
115
- - Updated dependencies [f341b4d]
116
- - Updated dependencies [4ad6c9b]
117
- - Updated dependencies [f4e9bba]
118
- - Updated dependencies [3e92be2]
119
- - Updated dependencies [f46ea60]
120
- - Updated dependencies [8655c00]
121
- - Updated dependencies [caadd02]
122
- - Updated dependencies [7d07023]
123
- - Updated dependencies [0ae1b77]
124
- - Updated dependencies [978b924]
125
- - Updated dependencies [3508a03]
126
- - Updated dependencies [2b3f711]
127
- - Updated dependencies [9207a0f]
128
- - Updated dependencies [986739d]
129
- - Updated dependencies [f317b83]
130
- - @sylphx/sdk@0.21.0
131
-
132
- ## 0.18.0
133
-
134
- ### Minor Changes
135
-
136
- - 873c8c8: Add provider-neutral managed mobile device-test runtime contracts and
137
- Management SDK helpers for project-scoped create/list plus handle-scoped
138
- poll/cancel flows.
139
-
140
- ### Patch Changes
141
-
142
- - @sylphx/sdk@0.20.1
143
-
144
- ## 0.17.1
145
-
146
- ### Patch Changes
147
-
148
- - Updated dependencies [[`8259c44`](https://github.com/SylphxAI/platform/commit/8259c4415fa6ec6aa640d78288b943bd43cc0afb), [`9a01f3f`](https://github.com/SylphxAI/platform/commit/9a01f3f23e08ca87e578a3e3f6134648568936ee), [`4eacc55`](https://github.com/SylphxAI/platform/commit/4eacc5562189afc100d8936c0a6272194c0d9999), [`61c97c6`](https://github.com/SylphxAI/platform/commit/61c97c65ad8653989ad90774bf092f1e621b59fc)]:
149
- - @sylphx/sdk@0.20.0
150
-
151
- ## 0.17.0
152
-
153
- ### Minor Changes
154
-
155
- - [#2290](https://github.com/SylphxAI/platform/pull/2290) [`b3f3a65`](https://github.com/SylphxAI/platform/commit/b3f3a653b26b966012aeacec2b46b5fda3db3217) Thanks [@shtse8](https://github.com/shtse8)! - Expose project preview capacity as a public contract, CLI, and management surface so operators can set per-project preview quotas without database or cluster mutations.
156
-
157
- ### Patch Changes
158
-
159
- - Updated dependencies [[`dfa9a75`](https://github.com/SylphxAI/platform/commit/dfa9a752323676e74225fe8903152a2375598618)]:
160
- - @sylphx/sdk@0.19.3
161
-
162
- ## 0.16.0
163
-
164
- ### Minor Changes
165
-
166
- - [#1988](https://github.com/SylphxAI/platform/pull/1988) [`9dbac37`](https://github.com/SylphxAI/platform/commit/9dbac3737f585d4070b96b0f6de13e6f817928c9) Thanks [@shtse8](https://github.com/shtse8)! - Add the ADR-229 workflow operator contract, Management SDK namespace, and `sylphx admin workflows` inspection/repair commands.
167
-
168
- ### Patch Changes
169
-
170
- - Updated dependencies []:
171
- - @sylphx/sdk@0.19.2
172
-
173
- ## 0.15.1
174
-
175
- ### Patch Changes
176
-
177
- - [#1901](https://github.com/SylphxAI/platform/pull/1901) [`5ad7c51`](https://github.com/SylphxAI/platform/commit/5ad7c51f09a629d54dbaab936dbc065baa5b546f) Thanks [@shtse8](https://github.com/shtse8)! - Fix org management CLI contract coverage and project-session data boundaries.
178
-
179
- - Updated dependencies []:
180
- - @sylphx/sdk@0.19.1
181
-
182
- ## 0.15.0
183
-
184
- ### Minor Changes
185
-
186
- - [#1862](https://github.com/SylphxAI/platform/pull/1862) [`8de54cd`](https://github.com/SylphxAI/platform/commit/8de54cdd9e5482b95180706ca21989ab207fb496) Thanks [@shtse8](https://github.com/shtse8)! - ADR-212 defaultResources ceiling guardrail: raw `desired_spec.defaultResources` requests are now bounded by the largest public machine size (derived `ENV_DEFAULT_RESOURCES_REQUEST_CEILING`), with a canonical Kubernetes quantity parser (`@sylphx/contract/k8s-quantity`), shared write-side validation in `AdminEnvsSpecPatchInput` (parse validity, requests ≤ limits, ceiling with explicit `overrideCeiling: true` break-glass), and a `--override-ceiling` CLI flag on `sylphx admin envs spec`.
187
-
188
- ### Patch Changes
189
-
190
- - Updated dependencies [[`cce0e6d`](https://github.com/SylphxAI/platform/commit/cce0e6dc83f52517bd8df81570020a40413f388d)]:
191
- - @sylphx/sdk@0.19.0
192
-
193
- ## 0.14.16
194
-
195
- ### Patch Changes
196
-
197
- - Updated dependencies [[`0ea1aef`](https://github.com/SylphxAI/platform/commit/0ea1aef44e92f53eb8a156b9cac9159db0c10c69)]:
198
- - @sylphx/sdk@0.18.0
199
-
200
- ## 0.14.15
201
-
202
- ### Patch Changes
203
-
204
- - Updated dependencies [[`b6deea0`](https://github.com/SylphxAI/platform/commit/b6deea0e14e4c75f65853bcc8ab0f1565a1ae0ad)]:
205
- - @sylphx/sdk@0.17.0
206
-
207
- ## 0.14.14
208
-
209
- ### Patch Changes
210
-
211
- - [#1807](https://github.com/SylphxAI/platform/pull/1807) [`e9e6190`](https://github.com/SylphxAI/platform/commit/e9e6190fec0ebfb9ff71999b57e0b9254bdd51ae) Thanks [@shtse8](https://github.com/shtse8)! - Publish project manifests before triggering `sylphx deploy`, so management
212
- deploys use the local `sylphx.toml` as the desired-state source of truth.
213
-
214
- ## 0.14.13
215
-
216
- ### Patch Changes
217
-
218
- - [#1798](https://github.com/SylphxAI/platform/pull/1798) [`9b52313`](https://github.com/SylphxAI/platform/commit/9b52313107975e133eb6cdf6028b349f228d075c) Thanks [@shtse8](https://github.com/shtse8)! - Treat `running` deployments as ready in `sylphx deployments wait`.
219
-
220
- ## 0.14.12
221
-
222
- ### Patch Changes
223
-
224
- - [#1684](https://github.com/SylphxAI/platform/pull/1684) [`cf70398`](https://github.com/SylphxAI/platform/commit/cf7039861ad6c3a36e96ff569f76bef80c45a6f1) Thanks [@shtse8](https://github.com/shtse8)! - Use the linked project's organization as the default scope for project-scoped commands, resolve slug/org manifests to canonical project TypeIDs, persist the linked default environment TypeID in `project.default_env_id`, accept `logs --limit` as an alias for `--tail`, keep project-resolution errors labeled with the caller command, make `env ls` and `resources list` show actionable IDs with structured output support, and keep `sylphx.toml` as the single repo manifest source for buildpack selection.
225
-
226
- Also make structured CLI output backpressure-safe so large `--output json|yaml` payloads remain complete when piped through slower consumers such as `jq`.
227
-
228
- Keep PR preview build contexts honest by posting per-service queued statuses only after the corresponding build dispatch has been accepted, so the aggregate preview status cannot pass while component build contexts remain stale/pending.
229
-
230
- Reduce sandbox heartbeat write pressure by skipping redundant running-state DB updates while both the heartbeat timestamp and expiry lease have safe margin; stale heartbeat timestamps and lease renewals still write and still fail loud on DB pressure.
231
-
232
- Reduce GitHub webhook intake DB pressure by removing the explicit transaction around the durable queue write; delivery idempotency remains owned by the unique delivery id and guarded settled-row requeue, while queue failures still return 503 for GitHub retry.
233
-
234
- Keep PR preview aggregate status pending while retryable build admission/orphan failures still have outstanding durable preview retry work, so GitHub merge gates do not surface a false deploy failure while the controller is actively retrying the same PR/SHA.
235
-
236
- Allow the deploy-status finalizer to repair stale `sylphx/preview=success` back to pending when the same PR/SHA still has durable preview dispatch work queued, preventing aggregate preview success from masking deferred service builds.
237
-
238
- Unify the dogfooded platform project display identity around `Sylphx Platform` and let platform bootstrap repair stale `Sylphx Console` project names/descriptions so CLI and Management API project output expose one canonical name.
239
-
240
- Keep PR preview pre-submit build rows pending while the same repo/PR/SHA still has an active durable preview lifecycle retry, so build watchdog recovery does not turn scheduler fairness backpressure into false terminal preview failures. Push-triggered preview lifecycle handoff rows now persist PR action and number metadata for queue coalescing and watchdog ownership checks.
241
-
242
- Keep CLI log NDJSON output backpressure-safe and keep SSE transport diagnostics on stderr, not stdout, so `sylphx logs --json`, `sylphx logs --follow --json`, and `sylphx tail --json` remain valid streams when piped through slower consumers such as `jq` and when the transport reconnects or fails loudly.
243
-
244
- Make deploy image-ref resolution fail closed when a completed build has an image digest but no parseable registry host/path, preventing mutable tag-form refs from being persisted as deployment identity.
245
-
246
- Make bare `sylphx deployments` behave as `sylphx deployments list`, including structured `--output` support, so the common "show recent deployments" workflow does not require a redundant subcommand.
247
-
248
- Keep BuildKit standard-lane fairness on one project/service SSOT by rejecting the removed app-level admission env alias and by counting fairness only from the explicit `sylphx.com/build-fairness-key` annotation. Batch admission now also fails closed when ResourceQuota job/PVC usage status is missing instead of inferring quota headroom from a secondary source.
249
-
250
- - [#1776](https://github.com/SylphxAI/platform/pull/1776) [`fb0f7fe`](https://github.com/SylphxAI/platform/commit/fb0f7fe6eeae812352da29707efc3ff3a8189cfc) Thanks [@shtse8](https://github.com/shtse8)! - Add structured `sylphx status --output json|yaml|table|pretty` output for agent and CI smoke checks.
251
-
252
- - Updated dependencies [[`5e219c8`](https://github.com/SylphxAI/platform/commit/5e219c86149c9487d644127e65069ea4e928d41f)]:
253
- - @sylphx/sdk@0.16.0
254
-
255
- ## 0.14.11
256
-
257
- ### Patch Changes
258
-
259
- - [#1676](https://github.com/SylphxAI/platform/pull/1676) [`5b5c27d`](https://github.com/SylphxAI/platform/commit/5b5c27d1508b4dcca01f064257555f33db162728) Thanks [@shtse8](https://github.com/shtse8)! - Use the linked project organization when listing deployments and logs without an explicit `--org`, so multi-organization accounts do not fall back to the configured default organization and receive `Project not found`.
260
-
261
- Keep `org` and `orgs` command help isolated so the alias does not render duplicated nested paths such as `org org members list`.
262
-
263
- ## 0.14.10
264
-
265
- ### Patch Changes
266
-
267
- - Updated dependencies [[`38d2c64`](https://github.com/SylphxAI/platform/commit/38d2c648a79294ff454cd003e4ca5e98027d8a2f)]:
268
- - @sylphx/sdk@0.15.4
269
-
270
- ## 0.14.9
271
-
272
- ### Patch Changes
273
-
274
- - [#1546](https://github.com/SylphxAI/platform/pull/1546) [`0412606`](https://github.com/SylphxAI/platform/commit/04126068505391fa9a7aee21681e18dc083bb0a1) Thanks [@shtse8](https://github.com/shtse8)! - Scope deploy log terminal status to the active build record and verify the deployment rollout separately before reporting success.
275
-
276
- ## 0.14.8
277
-
278
- ### Patch Changes
279
-
280
- - [#1523](https://github.com/SylphxAI/platform/pull/1523) [`c6297fa`](https://github.com/SylphxAI/platform/commit/c6297fa1fab2a8fa7fd4bb83705ffbea9f17b7d2) Thanks [@shtse8](https://github.com/shtse8)! - Keep deploy log streaming attached across transient SSE disconnects so native
281
- EventSource reconnect can recover without prematurely failing `sylphx deploy`.
282
-
283
- ## 0.14.7
284
-
285
- ### Patch Changes
286
-
287
- - [#1473](https://github.com/SylphxAI/platform/pull/1473) [`e282a6a`](https://github.com/SylphxAI/platform/commit/e282a6a00fa9149e5cd3a1dfd6b70c255d3101f0) Thanks [@shtse8](https://github.com/shtse8)! - Add service-name targeting to the canonical deploy contract and route service deploys through it so single-service deploys trigger the same build pipeline as project deploys.
288
-
289
- - Updated dependencies []:
290
- - @sylphx/sdk@0.15.3
291
-
292
- ## 0.14.6
293
-
294
- ### Patch Changes
295
-
296
- - [#1470](https://github.com/SylphxAI/platform/pull/1470) [`21730d6`](https://github.com/SylphxAI/platform/commit/21730d642b52f8975f8ecb6b726ee75f6887481f) Thanks [@shtse8](https://github.com/shtse8)! - Make `logs --service` truthful to the log contract by applying it as a strict runtime-log filter and rejecting service-scoped build logs until build log chunks carry service attribution.
297
-
298
- - [#1467](https://github.com/SylphxAI/platform/pull/1467) [`9362845`](https://github.com/SylphxAI/platform/commit/9362845a3756d5114d52233dca1a4f2b9f715e89) Thanks [@shtse8](https://github.com/shtse8)! - Give `sylphx deploy` a 20 minute authoritative fallback wait budget after build-log stream degradation and expose `--wait-timeout` for CI/operator overrides.
299
-
300
- ## 0.14.5
301
-
302
- ### Patch Changes
303
-
304
- - [#1424](https://github.com/SylphxAI/platform/pull/1424) [`48e9d25`](https://github.com/SylphxAI/platform/commit/48e9d2539e1efa03fec39431f9828c9cf21470c9) Thanks [@shtse8](https://github.com/shtse8)! - Add refreshable injected OAuth credentials for local agent fleets. The CLI now treats `SYLPHX_ACCESS_TOKEN` + `SYLPHX_REFRESH_TOKEN`, and OAuth pairs in `SYLPHX_TOKEN_FILE`, as managed sessions that use the existing refresh lock instead of stateless bearer tokens.
305
-
306
- ## 0.14.4
307
-
308
- ### Patch Changes
309
-
310
- - Updated dependencies [[`450ff8e`](https://github.com/SylphxAI/platform/commit/450ff8ebde3d2ef8072b67e4a2db368d2ada8cb9)]:
311
- - @sylphx/sdk@0.15.2
312
-
313
- ## 0.14.3
314
-
315
- ### Patch Changes
316
-
317
- - Updated dependencies [[`ef6be35`](https://github.com/SylphxAI/platform/commit/ef6be3596e18333c1a80bb4e21e26cb0590d6324)]:
318
- - @sylphx/sdk@0.15.1
319
-
320
- ## 0.14.2
321
-
322
- ### Patch Changes
323
-
324
- - Updated dependencies [[`feaef05`](https://github.com/SylphxAI/platform/commit/feaef05b33c83474006936e12d560b05d1ef474c), [`25e92f2`](https://github.com/SylphxAI/platform/commit/25e92f21823feab42e4e2b7b75438578ad78fb41)]:
325
- - @sylphx/sdk@0.15.0
326
-
327
- ## 0.14.1
328
-
329
- ### Patch Changes
330
-
331
- - [#1230](https://github.com/SylphxAI/platform/pull/1230) [`793ff13`](https://github.com/SylphxAI/platform/commit/793ff1302e87c3578e70ee5a9ebdc131a69dde82) Thanks [@shtse8](https://github.com/shtse8)! - Make `sylphx org` a first-class alias, prefer the linked project's organization before the stored default org, and suppress `[object Object]` for CLI parse errors.
332
-
333
- - [#1225](https://github.com/SylphxAI/platform/pull/1225) [`54efb0f`](https://github.com/SylphxAI/platform/commit/54efb0f69827ca9fa80e60506f456223cabaeb00) Thanks [@shtse8](https://github.com/shtse8)! - Revalidate cached positive update notices against npm latest before printing exact target versions.
334
-
335
- ## 0.14.0
336
-
337
- ### Minor Changes
338
-
339
- - [#1169](https://github.com/SylphxAI/platform/pull/1169) [`53a74bc`](https://github.com/SylphxAI/platform/commit/53a74bc5c612ca00e68d88296526c588bb2d3b04) Thanks [@shtse8](https://github.com/shtse8)! - Route CLI runtime/build log inspection through the environment-scoped Management logs API. `sylphx logs` now uses bounded runtime logs by default, keeps SSE behind `--follow`, and exposes build/deploy logs through `--type build`.
340
-
341
- ## 0.13.1
342
-
343
- ### Patch Changes
344
-
345
- - Updated dependencies [[`fa4fa78`](https://github.com/SylphxAI/platform/commit/fa4fa78996f94d2d8d6bc3e893d19cf1725e1268)]:
346
- - @sylphx/sdk@0.14.0
347
-
348
- ## 0.13.0
349
-
350
- ### Minor Changes
351
-
352
- - [#1197](https://github.com/SylphxAI/platform/pull/1197) [`a83aad4`](https://github.com/SylphxAI/platform/commit/a83aad43d9745e3e16ab557e3f95c3074c5a28f0) Thanks [@shtse8](https://github.com/shtse8)! - Publish the cleaned CLI project configuration boundary: repo project bindings now live only in `sylphx.toml`, private OAuth/default-org state stays in `~/.sylphx/config.json`, and the retired `sylphx.json`/app-link surfaces are removed.
353
-
354
- Also publish the Management SDK and Contract updates for canonical project manifest fields (`project.id`, `project.org_id`, `project.default_env`) and the removed legacy Management aliases.
355
-
356
- ### Patch Changes
357
-
358
- - Updated dependencies []:
359
- - @sylphx/sdk@0.13.9
360
-
361
- ## 0.12.1
362
-
363
- ### Patch Changes
364
-
365
- - [#1172](https://github.com/SylphxAI/platform/pull/1172) [`c14a894`](https://github.com/SylphxAI/platform/commit/c14a894e9a3792a4f491f3acff3517008355e35f) Thanks [@shtse8](https://github.com/shtse8)! - Harden OAuth refresh for local agent fleets: stale refresh-token rejection no longer clears a newer stored session, refresh outages now surface as transient failures instead of hidden logouts, and handled CLI auth errors no longer print Effect runtime stack noise.
366
-
367
- ## 0.12.0
368
-
369
- ### Minor Changes
370
-
371
- - [#1126](https://github.com/SylphxAI/platform/pull/1126) [`b5c6c14`](https://github.com/SylphxAI/platform/commit/b5c6c142ba89078edf460807282337dc315b77df) Thanks [@shtse8](https://github.com/shtse8)! - ADR-141..146 — health observability stack lands across the SDK, CLI, contract, and management surfaces.
372
-
373
- ## `@sylphx/sdk` (`@sylphx/sdk/health`) — new public surface
374
-
375
- - **`withHealth.{hono,express,fastify,fetch}`** — framework-agnostic Zero-Config `/healthz` middleware. Drop one line into your Hono / Express / Fastify / Next.js / Bun.serve app and you get a multi-signal continuous-score health endpoint, OTel emission, causality propagation, and audit-grade history out of the box.
376
- - **Seven built-in signals**: `eventLoopLagSignal`, `queueDepthSignal`, `errorRateSignal`, `memoryPressureSignal`, `pingSignal`, `databaseSignal`, `redisSignal`. Compose them via `sylphxHealth({ signals: [...] })`; the default scoring strategy is weighted geometric mean per ADR-111 §4.5.
377
- - **ADR-142 OTel-native emission** — `health.score`, `health.signal.factor`, `health.signal.value`, `health.signal.value_state`, `health.downstream_cause` metrics + `service.health.*` span attributes + `health.evaluated` event. Default-on; graceful no-op when `@opentelemetry/api` is not installed.
378
- - **ADR-143 causality propagation** — read/write OTel Baggage entries `sylphx.health.cause` + `sylphx.health.cause_chain`. A Postgres outage produces one paged alert at the root plus N silent downstream-impact rows, not 12 red dots. Default-on with a 0.5 score threshold.
379
- - **ADR-144 audit-grade history** — every `evaluate()` produces a SHA-256 prev-hash chained `HistoryEntry` (CloudTrail-style integrity), retrievable via `getHistory(query?)` / verifiable via `verifyHistory(query?)`. Pluggable `HistoryStore` interface; in-memory ring buffer is the reference implementation.
380
-
381
- ## `@sylphx/cli`
382
-
383
- - **`sylphx migrate health-checks`** — idempotent codemod that wires `withHealth.*` into your app's entry file (Hono / Express / Fastify / Next.js auto-detected) and removes hand-rolled `/health` + `/ready` routes. Supports `--dry-run` and `--check` (CI-grade exit-1-on-pending).
384
- - **`sylphx migrate status`** — per-service fleet visibility. Queries the Management API for every visible project and reports which services have `frameworkSignals.sdkHealthDetected = true`. The answer to "which of my services still need ADR-141?".
385
- - **`sylphx health verify --file <path>`** — offline verifier for an exported ADR-144 history chain. Walks the SHA-256 chain and reports the first break with a clear reason. Mirrors AWS CloudTrail `validate-logs`.
386
-
387
- ## `@sylphx/management` + `@sylphx/contract`
388
-
389
- - **`TriggerDeploymentInput.frameworkSignals`** — optional map of `service slug → { sdkHealthDetected?: boolean }`. The CLI now scans `package.json` at deploy time and forwards these signals; the Management API merges them into `project_services.machine_config.frameworkSignals` before the reconciler picks up the deploy. Used by the reconciler smart-default (HTTP `/healthz` probe when the SDK is detected) and by the new ADR-111 Phase B sidecar SDK-detection gate.
390
- - **`Service.frameworkSignals`** — new read-only field on the Service response so `sylphx migrate status` can render the fleet scorecard.
391
-
392
- ## Why upgrade
393
-
394
- Every Sylphx service gets the SOTA dataplane for free — continuous score in `[0, 1]`, multi-signal composition, OTel-native observability, causality-aware alert routing, audit-grade evidence, and (post-ADR-111 Phase B sidecar) automatic drain/kill enforcement. The legacy `/live` + `/ready` split-probe pattern is retired in a single migration.
395
-
396
- See `docs/how-to/health-checks.md`, `docs/explanation/health-check-ownership.md`, and the runbook `docs/runbooks/health-alert-routing-adr143.md` for the operator surface.
397
-
398
- ### Patch Changes
399
-
400
- - Updated dependencies [[`b5c6c14`](https://github.com/SylphxAI/platform/commit/b5c6c142ba89078edf460807282337dc315b77df)]:
401
- - @sylphx/sdk@0.13.0
402
-
403
- ## 0.11.0
404
-
405
- ### Minor Changes
406
-
407
- - [#1105](https://github.com/SylphxAI/platform/pull/1105) [`ab0491b`](https://github.com/SylphxAI/platform/commit/ab0491b892ecb9e96eb2843d2b6519f8eb52e3c9) Thanks [@shtse8](https://github.com/shtse8)! - ADR-137 §2.3 / §2.4 — per-PR cost browser, step 2 (API + SDK + CLI).
408
-
409
- - **API**: `GET /projects/:id/previews/:prNumber/cost` returns a per-PR cost envelope (build / preview env / BaaS breakdown + 30-day project monthly-average comparison). `GET /projects/:id/previews/cost` lists the most recent 50 PRs (cursor paginated by `(prNumber, windowOpenedAt)`). Both require `project:read`.
410
- - **SDK** (`@sylphx/management`): new `previews.cost(client, projectId, prNumber, opts?)` and `previews.listCosts(client, projectId, opts?)` capability namespace.
411
- - **CLI** (`@sylphx/cli`): new `sylphx previews cost <pr-number>` and `sylphx previews list-costs [--project <slug>]` subcommands. Headline cost is coloured by comparison ratio (green < 1×, yellow 1–2×, red ≥ 2×) per ADR-137 §2.5.
412
-
413
- No DB migration. Cost math reuses the aggregator landed in ADR-137 Step 1 (#1092).
414
-
415
- - [#1090](https://github.com/SylphxAI/platform/pull/1090) [`7493f41`](https://github.com/SylphxAI/platform/commit/7493f41af30f565428f0335c6c6c3a491065c89d) Thanks [@shtse8](https://github.com/shtse8)! - Fail loudly on SSE log-stream transport failures instead of silently switching `sylphx deploy` to deployment polling. Deployment state remains available through explicit `sylphx deployments get` and `sylphx deployments wait` commands.
416
-
417
- ### Patch Changes
418
-
419
- - [#1097](https://github.com/SylphxAI/platform/pull/1097) [`7065be6`](https://github.com/SylphxAI/platform/commit/7065be6ccf978f76e8e2e518bf57f7e144e3954e) Thanks [@shtse8](https://github.com/shtse8)! - Validate configured CLI credentials in `sylphx doctor` with a read-only Management API principal check so revoked or expired agent tokens fail loudly instead of appearing logged in.
420
-
421
- - Updated dependencies []:
422
- - @sylphx/sdk@0.12.3
423
-
424
- ## 0.10.0
425
-
426
- ### Minor Changes
427
-
428
- - [#1063](https://github.com/SylphxAI/platform/pull/1063) [`f7bce5d`](https://github.com/SylphxAI/platform/commit/f7bce5d4869cc3904fc21edb1c0e6cfcbcab0d9a) Thanks [@shtse8](https://github.com/shtse8)! - Add an agent-safe `SYLPHX_TOKEN_FILE` auth source for the CLI, preserve OAuth refresh-token expiry through the token endpoint contract, and surface refresh-expiry diagnostics in `sylphx doctor`.
429
-
430
- Agents and CI can now mount a raw token or `SYLPHX_TOKEN=...` secret file instead of sharing a human `sylphx login` OAuth refresh chain. The CLI resolves auth as `SYLPHX_TOKEN` → `SYLPHX_TOKEN_FILE` → stored OAuth, skips OAuth refresh for machine credentials, and fails closed when a configured token file is invalid.
431
-
432
- ### Patch Changes
433
-
434
- - [#1078](https://github.com/SylphxAI/platform/pull/1078) [`b1d0edf`](https://github.com/SylphxAI/platform/commit/b1d0edfbd8386ea2421d8f0ae769d21e86c0db3a) Thanks [@shtse8](https://github.com/shtse8)! - Increase deploy fallback wait budget for production rollouts and rely on corrected Management API deployment status projection after log-stream disconnects.
435
-
436
- - Updated dependencies [[`f7bce5d`](https://github.com/SylphxAI/platform/commit/f7bce5d4869cc3904fc21edb1c0e6cfcbcab0d9a)]:
437
- - @sylphx/sdk@0.12.2
438
-
439
- ## 0.9.2
440
-
441
- ### Patch Changes
442
-
443
- - [#1061](https://github.com/SylphxAI/platform/pull/1061) [`7d143ec`](https://github.com/SylphxAI/platform/commit/7d143ec5811b0a671aef428f3cc8794306e71940) Thanks [@shtse8](https://github.com/shtse8)! - Route deliberate CLI BaaS SDK dogfood calls through a single platform-baas adapter and add CI guards for the CLI SDK boundary, Core SDK boundary, and BaaS runtime `/v1` path SSOT.
444
-
445
- Make SDK platform detection edge-safe by removing top-level Node-only runtime probes from shared constants.
446
-
447
- - Updated dependencies [[`7d143ec`](https://github.com/SylphxAI/platform/commit/7d143ec5811b0a671aef428f3cc8794306e71940), [`adf814e`](https://github.com/SylphxAI/platform/commit/adf814ec0b402b0f3443caa3442cb256515a4ad6)]:
448
- - @sylphx/sdk@0.12.1
449
-
450
- ## 0.9.1
451
-
452
- ### Patch Changes
453
-
454
- - Updated dependencies [[`8c352c2`](https://github.com/SylphxAI/platform/commit/8c352c2a9cb5e4ccd51e49f4547adce35a7c6fb7)]:
455
- - @sylphx/sdk@0.12.0
456
-
457
- ## 0.9.0
458
-
459
- ### Minor Changes
460
-
461
- - [#1019](https://github.com/SylphxAI/platform/pull/1019) [`7978a14`](https://github.com/SylphxAI/platform/commit/7978a140c6eaf146456a458aa89b943cd3989659) Thanks [@shtse8](https://github.com/shtse8)! - Fail closed when environment targeting is ambiguous across platform management APIs.
462
-
463
- The contract, Management SDK, and CLI now preserve explicit `envId` targeting for env vars, domains, services, deployments, and logs instead of relying on `envType` defaults when a project has multiple matching environments.
464
-
465
- ### Patch Changes
466
-
467
- - Updated dependencies []:
468
- - @sylphx/sdk@0.11.2
469
-
470
- ## 0.8.0
471
-
472
- ### Minor Changes
473
-
474
- - [#1004](https://github.com/SylphxAI/platform/pull/1004) [`e51d39c`](https://github.com/SylphxAI/platform/commit/e51d39c47da0efd26c676f5908035e6c6b0fa3f7) Thanks [@shtse8](https://github.com/shtse8)! - Add `SYLPHX_TOKEN_FILE` as a non-interactive CLI auth source for local agent fleets, with explicit doctor/whoami reporting and hard-fail behavior when the configured token file is unreadable or empty.
475
-
476
- - [#759](https://github.com/SylphxAI/platform/pull/759) [`3257675`](https://github.com/SylphxAI/platform/commit/325767586a2fa5e53f00cd81e438d561d0e37c41) Thanks [@shtse8](https://github.com/shtse8)! - Align the Management SDK runners module with the contract-derived runner API surface.
477
-
478
- Runner management methods now derive request paths, HTTP methods, input types, and result types from `@sylphx/contract`. The create input no longer advertises unsupported `labels` or `maxJobs` fields; callers should pass the contract-owned `name`, `platform`, and `arch` fields.
479
-
480
- The `sylphx runners register` CLI command no longer exposes the unsupported `--labels` or `--max-jobs` flags and now submits only the contract-owned runner registration fields.
481
-
482
- ### Patch Changes
483
-
484
- - Updated dependencies []:
485
- - @sylphx/sdk@0.11.1
486
-
487
- ## 0.7.6
488
-
489
- ### Patch Changes
490
-
491
- - Updated dependencies [[`df3c86e`](https://github.com/SylphxAI/platform/commit/df3c86e210f165070ed1e2f715eeed11ece6f07b), [`af6c46f`](https://github.com/SylphxAI/platform/commit/af6c46fa785acf52da428d19db50da3d834ef873)]:
492
- - @sylphx/sdk@0.11.0
493
-
494
- ## 0.7.5
495
-
496
- ### Patch Changes
497
-
498
- - Updated dependencies [[`7106169`](https://github.com/SylphxAI/platform/commit/710616977c33872bf84b36991cc24e895df21db3)]:
499
- - @sylphx/sdk@0.10.7
500
-
501
- ## 0.7.4
502
-
503
- ### Patch Changes
504
-
505
- - Updated dependencies [[`90e15c8`](https://github.com/SylphxAI/platform/commit/90e15c8ae07469666fa6d4ed324f7a7473218004)]:
506
- - @sylphx/sdk@0.10.6
507
-
508
- ## 0.7.3
509
-
510
- ### Patch Changes
511
-
512
- - Updated dependencies [[`28257eb`](https://github.com/SylphxAI/platform/commit/28257ebc815864d4ce1246ca0d9a092eff5b8e52)]:
513
- - @sylphx/sdk@0.10.5
514
-
515
- ## 0.7.2
516
-
517
- ### Patch Changes
518
-
519
- - Updated dependencies [[`426bafb`](https://github.com/SylphxAI/platform/commit/426bafb35a96e525066cb43c05388a4cc44a8bc3), [`ae05dec`](https://github.com/SylphxAI/platform/commit/ae05decf486ea0fc13f0f8de174514cbdd02585b), [`b9bdefe`](https://github.com/SylphxAI/platform/commit/b9bdefe9e3acd03f1f6b42519c535dda491c20e9)]:
520
- - @sylphx/sdk@0.10.4
521
-
522
- ## 0.7.1
523
-
524
- ### Patch Changes
525
-
526
- - Updated dependencies [[`8a38f4b`](https://github.com/SylphxAI/platform/commit/8a38f4bca6dd06eb9947478dcfcdb765cc28ad10)]:
527
- - @sylphx/sdk@0.10.3
528
-
529
- ## 0.7.0
530
-
531
- ### Minor Changes
532
-
533
- - [#586](https://github.com/SylphxAI/platform/pull/586) [`2e55a61`](https://github.com/SylphxAI/platform/commit/2e55a6194628c5ca3ca78290cbf62610231ccee6) Thanks [@shtse8](https://github.com/shtse8)! - Expose authenticated build detail through the deployments contract, Management SDK, and `sylphx deployments build` so failed builds return structured, redacted diagnostics.
534
-
535
- ### Patch Changes
536
-
537
- - Updated dependencies []:
538
- - @sylphx/sdk@0.10.2
539
-
540
- ## 0.6.0
541
-
542
- ### Minor Changes
543
-
544
- - [#531](https://github.com/SylphxAI/platform/pull/531) [`2ff1de4`](https://github.com/SylphxAI/platform/commit/2ff1de40fd1e2a785a7daa764ddad4a56d7b48c8) Thanks [@shtse8](https://github.com/shtse8)! - Restore dogfooded deployment operations by allowing `sylphx deploy`, `sylphx status`, `sylphx logs`, `sylphx tail`, `sylphx open`, `sylphx env`, `sylphx config`, `sylphx secrets`, `sylphx storage`, `sylphx volumes`, `sylphx resources`, `sylphx domains`, `sylphx tasks`, `sylphx sandbox`, `sylphx plan`, `sylphx run-cmd`, `sylphx promote`, `sylphx releases`, `sylphx bisect`, and `sylphx rollback` to target explicit projects from unlinked directories, carrying org scoping through Management SDK calls and SSE log streams, and exposing scoped project/log/environment/service helpers in the Management SDK.
545
-
546
- Prune scaffold-only surfaces from the published CLI/Management SDK surface (`restart`, task `run`, direct `scale`, `functions`, `edge`, `regions`, and the no-op `deploy --region` flag) until their Management API or infra paths are real.
547
-
548
- ### Patch Changes
549
-
550
- - Updated dependencies [[`5697b98`](https://github.com/SylphxAI/platform/commit/5697b985237565e6ee3f6ef1469ff276db00e57c)]:
551
- - @sylphx/sdk@0.10.1
552
-
553
- ## 0.5.3
554
-
555
- ### Patch Changes
556
-
557
- - Updated dependencies [[`ba02c04`](https://github.com/SylphxAI/platform/commit/ba02c0412712dc8a5f19d17c16707eb5ae11ec47)]:
558
- - @sylphx/sdk@0.10.0
559
-
560
- ## 0.5.2
561
-
562
- ### Patch Changes
563
-
564
- - Updated dependencies [[`03dbd29`](https://github.com/SylphxAI/platform/commit/03dbd2986024fa650378e10958890d6ac063f516)]:
565
- - @sylphx/sdk@0.9.0
566
-
567
- ## 0.5.1
568
-
569
- ### Patch Changes
570
-
571
- - Updated dependencies [[`3972d17`](https://github.com/SylphxAI/platform/commit/3972d173c69bfbc52874852afc3aaf7a923b08d1)]:
572
- - @sylphx/sdk@0.8.0
573
-
574
- ## 0.5.0
575
-
576
- ### Minor Changes
577
-
578
- - [`c4471cf`](https://github.com/SylphxAI/platform/commit/c4471cf729a2a60865d0df5bbf04b87f55d57858) Thanks [@shtse8](https://github.com/shtse8)! - OAuth device flow migrated from platform bypass to BaaS plane (RFC 8628). New `sylphx logout` command (BaaS-dogfooded), automatic OAuth refresh, and `sylphx.toml` manifest workflow (`pull` / `push` / `validate` / `diff` / versioning). New top-level commands: `regions`, `branch-db`, `scale`, `secrets`, `realtime`, `saml`, `ai`, `session-replay`, `search`, `engagement`, `consent`, `privacy`, `referrals`, `newsletter`. ESM-only build, bundled `@sylphx/management`, install-to-run install path fixed.
579
-
580
- ## 0.4.1 (2026-04-24 — ADR-089 Phase 4c)
581
-
582
- ### Added
583
-
584
- - **`sylphx user`** — current-user self-service: `profile show|update`, `security`, `sessions list|revoke|purge`, `export` (GDPR), `delete` (GDPR erasure). Dogfoods `@sylphx/management.user.*`.
585
- - **`sylphx users`** — platform-admin user directory: `list`, `get <userId>`, `set-role <userId> <role>`. Dogfoods `@sylphx/management.admin.*` user-search endpoints.
586
- - **`sylphx admin`** — platform-admin ops grouped by surface: `quotas list|alerts|ack`, `audit logs`, `invitations list|create|revoke|resend`, `jwt-keys list|rotate|retire`, `project migrate`. Dogfoods `@sylphx/management.admin.*`.
587
-
588
- ### Coverage
589
-
590
- - `scripts/check-cli-coverage.ts` flipped from advisory to strict. 46/46 non-excluded `@sylphx/management` namespaces covered (100%); 9 namespaces excluded with per-entry rationale (`kv`, `authSettings`, `billingSettings`, `branchDatabases`, `envVars`, `github`, `management`, `refresh`, `serviceTokenRequests` — BaaS-plane / Console-only / internal-lifecycle). Kebab ↔ camelCase namespace normalisation matches the Phase 4b `check-paas-sdk-coverage.ts` pattern; an extended CLI-alias table covers non-trivial renames (e.g. `tokens` ↔ `serviceTokens`, `orgs` ↔ `organizations`, `session-replay` ↔ `sessionReplay`).
591
- - Completes ADR-089 Phase 4 (S6 + S7 + S8 all strict): `check-baas-sdk-coverage` + `check-paas-sdk-coverage` + `check-cli-coverage` all block CI on regression.
592
-
593
- ## 0.4.0 (wrongly labelled 1.0.0; reverted 2026-04-23 — still in beta)
594
-
595
- ### Changes
596
-
597
- - **Beta release (0.4.0).** The CLI's public surface is NOT yet frozen. 60 commands across auth, project lifecycle, deployment, managed primitives (db / storage / volumes / services / tasks / domains / functions / sandbox / runners), integrations (webhooks / flags / secrets / realtime / SAML / AI / session-replay / search / engagement / consent / privacy / referrals / newsletter / backup), billing (plan / billing / experiments / analytics), observability (monitoring / certs / email / notifications), and machine identity (tokens / OIDC / CI).
598
- - **`@effect/cli` migration complete** (ADR-073 Strategy A). Every command is a pure `Effect` value assembled under one root; `BunRuntime.runMain` is the single `runPromise`-like call site (ADR-058 Rule 21 compliant). Tests swap the Layer and assert on the Exit channel without subprocessing — 351+ passing tests.
599
- - **ESM-only**, Node ≥ 20 / Bun ≥ 1.3. Previous 0.x CJS output caused `Cannot find module './cjs/index.cjs'` crashes when Effect's package exports resolved to the wrong conditional branch; tsup now emits ESM exclusively.
600
- - **Self-contained global install.** `@sylphx/management` and `@sylphx/contract` are bundled via tsup `noExternal` — `bun add -g @sylphx/cli` has zero workspace peers to resolve, and consumers never see Effect as a transitive runtime dep through `@sylphx/management`.
601
- - **Correct `bin` wiring.** `bin.sylphx` points at `./dist/main.js`; the `#!/usr/bin/env bun` shebang is preserved by tsup. Global install + immediate run works with no post-install step.
602
-
603
- ### OAuth + service tokens (ADR-059)
604
-
605
- - **OAuth device flow** replaces legacy `slx_*` personal access tokens as the default login mode. Tokens are an atomic `{ accessToken, refreshToken, expiresAt }` triple stored at `~/.sylphx/config.json` with mode `0600`. The refresh interceptor transparently rotates the access token before expiry; a failed refresh prompts re-login.
606
- - **Service tokens** (`sk_*`) via `SYLPHX_API_TOKEN=...` for CI / CD and server-side automation. Per-project scope with per-token revocation.
607
- - **OIDC federation** (`sylphx oidc`) for passwordless CI — GitHub Actions / GitLab CI receive short-lived tokens via `id_token` exchange.
608
-
609
- ### Plane discipline (ADR-083)
610
-
611
- The CLI is **Management-plane-only**. There is no `sylphx kv get`, `sylphx email send`, or `sylphx flags evaluate` — runtime BaaS verbs live inside the deployed application via [`@sylphx/sdk`](https://www.npmjs.com/package/@sylphx/sdk). Attempting to use a `pk_*` / `sk_*` BaaS key against `api.sylphx.com/v1` returns `401 plane_mismatch`.
612
-
613
- ### Contract-first types (ADR-084)
614
-
615
- All wire types (request bodies, response envelopes, error shapes) derive from [`@sylphx/contract`](https://www.npmjs.com/package/@sylphx/contract). Hand-written type shims were removed; adding a new capability starts with a contract entry, not this package.
616
-
617
- ### Version compatibility
618
-
619
- | CLI | Management API | Contract |
620
- | ------------------------ | ------------------- | ------------------------------------- |
621
- | `@sylphx/cli@0.x` (beta) | `api.sylphx.com/v1` | `@sylphx/contract` (workspace / beta) |
622
-
623
- ---
624
-
625
- ## 0.3.3
626
-
627
- ### Patch Changes
628
-
629
- - Updated dependencies [[`b98b1c1`](https://github.com/SylphxAI/platform/commit/b98b1c1052b196bfa1440c4d7ed03c53ff549614)]:
630
- - @sylphx/management@0.1.0
631
-
632
- ## 0.3.2
633
-
634
- ### Patch Changes
635
-
636
- - Updated dependencies [[`a493b61`](https://github.com/SylphxAI/platform/commit/a493b61743ae6559a91ed056175304948ab6d43f)]:
637
- - @sylphx/management@1.0.1
638
-
639
- ## 0.3.1
640
-
641
- ### Patch Changes
642
-
643
- - [`1381a94`](https://github.com/SylphxAI/platform/commit/1381a94046043517841e9ed35f5d36afeb9c9cff) Thanks [@shtse8](https://github.com/shtse8)! - feat: extract Management SDK as standalone @sylphx/management package
644
-
645
- - New package @sylphx/management@1.0.0 — full Management API client
646
- - Resource-namespaced interface: mgmt.projects._, mgmt.deployments._, etc.
647
- - CLI now depends on @sylphx/management (dogfooding)
648
- - All types exported from @sylphx/management
649
-
650
- - Updated dependencies [[`1381a94`](https://github.com/SylphxAI/platform/commit/1381a94046043517841e9ed35f5d36afeb9c9cff)]:
651
- - @sylphx/management@1.0.0
652
-
653
- ## 0.3.0
654
-
655
- ### Minor Changes
656
-
657
- - [`0e1c4a9`](https://github.com/SylphxAI/platform/commit/0e1c4a9d15ddab0068d4863b2423c6c7e79ec77c) Thanks [@shtse8](https://github.com/shtse8)! - feat: full API parity, bug fixes, new commands (v0.2.0)
658
-
659
- **New commands:**
660
-
661
- - `sylphx tasks` — manage task definitions (list/get/create/update/rm), supports job/cron/service modes
662
- - `sylphx promote` — promote one environment into another
663
- - `sylphx config` — manage per-environment app config (list/get/set/delete)
664
- - `sylphx storage` — manage object storage buckets
665
- - `sylphx volumes` — manage persistent volumes
666
- - `sylphx services` — list and deploy service blueprints
667
- - `sylphx resources` — bind/unbind shared resources (databases, storage)
668
-
669
- **Bug fixes:**
670
-
671
- - `sylphx rollback` — was sending `{ envType }` but backend requires `{ envId | deploymentRecordId }`; now resolves correctly
672
- - `sylphx env rm` — backend was missing DELETE endpoint; added to server
673
- - `sylphx domains` — all domain commands were hitting `/domains/projects/...` (404); correct path is `/projects/.../domains/...`
674
- - `sylphx db create` — tier options now include all 5 tiers: starter | standard | performance | enterprise1 | enterprise2
675
- - Fixed 8 API response-shape mismatches (wrong wrapper fields causing silent empty results)
676
-
677
- **Type generation:**
678
-
679
- - `generate:types` URL fixed: was `sylphx.com/api/openapi.json` (404), now `docs.api.sylphx.com/v1/openapi.json`
680
- - `generate:types:local` fixed: was `localhost:3002`, now `localhost:3003` (sylphx-sdk dev server)
681
-
682
- ## 0.1.9
683
-
684
- ### Patch Changes
685
-
686
- - [`e611372`](https://github.com/SylphxAI/platform/commit/e611372008511be7c500622fd51a3cc5e629f4bf) Thanks [@shtse8](https://github.com/shtse8)! - fix(open): read URL from environments[] array instead of missing top-level field
687
-
688
- fix(status): show URL from environments[] — was always blank
689
-
690
- fix(db list): add missing DeploymentStatusEnv type; annotate environments field
691
-
692
- ## 0.1.8
693
-
694
- ### Patch Changes
695
-
696
- - [`aecec9b`](https://github.com/SylphxAI/platform/commit/aecec9be811aa94664c5ff1e96f8404dd8b8a236) Thanks [@shtse8](https://github.com/shtse8)! - fix(cli): add envType/isActive/publicKey to Project.environments type
697
-
698
- The server-side environments array includes envType (and more) which
699
- is required for the projects list display. Fixes TypeScript error
700
- TS2339 in projects.ts and link.ts.
701
-
702
- ## 0.1.7
703
-
704
- ### Patch Changes
705
-
706
- - [`87134cd`](https://github.com/SylphxAI/platform/commit/87134cd2781e200ba939ce35bd660bc8c77c1b6b) Thanks [@shtse8](https://github.com/shtse8)! - fix(cli): proper fixes — domains direct API, resolveEnvId removed
707
-
708
- - Domains API now uses `GET/POST/DELETE /domains/projects/{projectId}/domains?envType=`
709
- — no extra API call to resolve envId first (was 2 roundtrips, now 1)
710
- - `resolveEnvId` helper removed (no longer needed)
711
- - `listDomains` now correctly reads `customDomains` from response shape
712
- - `listDomains` + `addDomain` + `removeDomain` all updated to new route
713
- - 5 tests updated + 2 new tests (74 total)
714
-
715
- ## 0.1.6
716
-
717
- ### Patch Changes
718
-
719
- - [`6b79cd9`](https://github.com/SylphxAI/platform/commit/6b79cd956152bfb3387bab2aeab2edd9b21cff42) Thanks [@shtse8](https://github.com/shtse8)! - fix(logs): stream=true required, content field, formatLogEntry
720
-
721
- - `createLogStream` now includes `stream=true` query param — without it the
722
- backend returns JSON instead of SSE, causing EventSource to emit no events
723
- and the CLI to silently timeout
724
- - `stream` param renamed from legacy `tail` to `limit` (backend uses `limit`)
725
- - `formatLogEntry` now reads `content` field from build-log chunk payloads
726
- (backend sends `{ content, level, timestamp, sequence }`, not `message`)
727
- - Added `logs.test.ts` (8 tests) covering formatLogEntry for all field variants
728
- - Added 4 createLogStream URL tests in api.test.ts
729
- - Total: 73 tests passing (was 61)
730
-
731
- ## 0.1.5
732
-
733
- ### Patch Changes
734
-
735
- - [`2ea1157`](https://github.com/SylphxAI/platform/commit/2ea1157f178b4a8f7600fb3f9db1f26e0f2f9606) Thanks [@shtse8](https://github.com/shtse8)! - Fix remaining bugs found in 0.1.4 testing:
736
-
737
- - **env list crash**: `listEnvVars()` now unwraps `{ data: [...] }` API response (same pattern as projects/databases)
738
- - **projects list environments empty**: Use `e.name || e.envType` instead of `e.slug` (field doesn't exist in API response)
739
-
740
- ## 0.1.4
741
-
742
- ### Patch Changes
743
-
744
- - [`28cb620`](https://github.com/SylphxAI/platform/commit/28cb620e701bb0eaaac0680428aacf4efc38369b) Thanks [@shtse8](https://github.com/shtse8)! - Fix B1-B6 bugs from 0.1.3 testing:
745
-
746
- - **B1** (400 on status/deploy/env): Backend now accepts legacy `prefix_hex32` IDs alongside base58
747
- - **B2** (logs Unauthorized): `eventsource@2` uses `http/https`, not `fetch` — pass auth via `headers` option
748
- - **B3** (projects.map crash): Unwrap `{ object: 'list', data: [...] }` response from API
749
- - **B4** (domains 410): Route moved to `/domains/projects/{envId}/domains` — resolve envId first
750
- - **B5** (db 404): Databases now use unified Resources API at `/resources?kind=database`
751
- - **B6** (version 0.1.0): Read version from package.json instead of hardcoding
752
-
753
- ## 0.1.3
754
-
755
- ### Patch Changes
756
-
757
- - [`fbb8075`](https://github.com/SylphxAI/platform/commit/fbb80755b05048728c97cc0799dfd2636f8343ac) Thanks [@shtse8](https://github.com/shtse8)! - Fix `sylphx whoami` returning 404
758
-
759
- CLI was calling `GET /v1/users/me` (plural) but backend mounts user routes
760
- at `/user` (singular). Updated to call `GET /v1/user/me`.
761
-
762
- Backend adds a new `GET /user/me` endpoint that returns `{ user, orgs }`
763
- — the combined response the CLI expects for `sylphx whoami`.
764
-
765
- ## 0.1.2
766
-
767
- ### Patch Changes
768
-
769
- - [`ac5e3a3`](https://github.com/SylphxAI/platform/commit/ac5e3a36771e11f288d15391c90d610a2366aeb6) Thanks [@shtse8](https://github.com/shtse8)! - Fix `sylphx logs` crash in Node.js
770
-
771
- `eventsource@2` exports the class directly (`module.exports = EventSource`),
772
- not as a named export. Destructuring `const { EventSource } = require("eventsource")`
773
- returned `undefined`, causing `EventSource is not a constructor` at runtime.
774
-
775
- Fix: `const EventSource = require("eventsource")` — the module IS the constructor.
776
-
777
- ## 0.1.1
778
-
779
- ### Patch Changes
780
-
781
- - [`3aac758`](https://github.com/SylphxAI/platform/commit/3aac7582bd9b8e4a1a5c507bb4826330de267f40) Thanks [@shtse8](https://github.com/shtse8)! - Fix body-read crash on non-JSON API error responses
782
-
783
- `api.ts` was calling `res.json()` and catching the error to fall back to `res.text()`,
784
- but by that point the response body stream was already consumed, causing:
785
- `Body is unusable: Body has already been read`
786
-
787
- Fix: read body once with `res.text()`, then attempt `JSON.parse()`.
788
-
789
- Also adds 45 regression tests covering all api methods, URL construction,
790
- auth headers, error handling, and 204 No Content responses.
791
-
792
- ## 0.1.0
793
-
794
- ### Minor Changes
795
-
796
- - Initial release of Sylphx CLI
797
- - **`sylphx login`** — Authenticate with the Sylphx Platform (browser OAuth or `--token` for CI/CD)
798
- - **`sylphx logout`** — Clear stored credentials
799
- - **`sylphx whoami`** — Display current authenticated user and org
800
- - **`sylphx link`** — Link current directory to a Sylphx app
801
- - **`sylphx deploy`** — Deploy the linked app with real-time log streaming
802
- - **`sylphx rollback`** — Roll back to a previous deployment
803
- - **`sylphx logs`** — Stream live application logs
804
- - **`sylphx status`** — Show deployment and health status
805
- - **`sylphx env list`** — List environment variables
806
- - **`sylphx env set`** — Set an environment variable
807
- - **`sylphx env remove`** — Remove an environment variable
808
- - **`sylphx domains list`** — List custom domains
809
- - **`sylphx open`** — Open the app in the browser
22
+ Historical TypeScript CLI releases. Retired under ADR-3820; do not use.