@sylphx/cli 0.15.1 → 0.17.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,5 +1,27 @@
1
1
  # @sylphx/cli
2
2
 
3
+ ## 0.17.0
4
+
5
+ ### Minor Changes
6
+
7
+ - [#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.
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [[`dfa9a75`](https://github.com/SylphxAI/platform/commit/dfa9a752323676e74225fe8903152a2375598618)]:
12
+ - @sylphx/sdk@0.19.3
13
+
14
+ ## 0.16.0
15
+
16
+ ### Minor Changes
17
+
18
+ - [#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.
19
+
20
+ ### Patch Changes
21
+
22
+ - Updated dependencies []:
23
+ - @sylphx/sdk@0.19.2
24
+
3
25
  ## 0.15.1
4
26
 
5
27
  ### Patch Changes
package/README.md CHANGED
@@ -188,6 +188,13 @@ The home config is private operator state only. It does not store per-directory
188
188
  | `sylphx logout` | Clear stored credentials |
189
189
  | `sylphx whoami` | Show current user + org + linked project |
190
190
 
191
+ ### Diagnostics & raw API
192
+
193
+ | Command | Purpose |
194
+ |---|---|
195
+ | `sylphx doctor` | Diagnose CLI install + auth + linked-project state, including read-only live auth validation |
196
+ | `sylphx api` | Generic authenticated Management API caller (`sylphx api GET /projects`) — like `gh api`; inherits OAuth refresh, idempotency keys, RFC 7807 errors |
197
+
191
198
  ### Project lifecycle
192
199
 
193
200
  | Command | Purpose |
@@ -197,7 +204,8 @@ The home config is private operator state only. It does not store per-directory
197
204
  | `sylphx unlink` | Remove the project link |
198
205
  | `sylphx open` | Open the linked project, or an explicit project with `--project/--org` |
199
206
  | `sylphx projects` | List / manage projects |
200
- | `sylphx orgs` | List / switch organizations |
207
+ | `sylphx orgs` | Manage organizations (members, invites, roles); `sylphx org` is an alias |
208
+ | `sylphx migrate` | ADR-driven codemods for the linked repo (health-checks wiring, fleet migration status) |
201
209
 
202
210
  ### Deployment
203
211
 
@@ -215,13 +223,55 @@ The home config is private operator state only. It does not store per-directory
215
223
  | `sylphx tail` | Follow runtime logs with structured formatting; accepts the same filters as `logs` |
216
224
  | `sylphx run-cmd` | Run a local command with remote env from a linked or explicit project |
217
225
 
226
+ When `sylphx.toml` exists in the working directory, `sylphx deploy` validates
227
+ and publishes that manifest before triggering the deployment. This is the path
228
+ that makes config-as-code fields such as `[database.migrations]` visible to the
229
+ management deploy pipeline. For explicit deploys, pass both project and org
230
+ scope, for example `sylphx deploy --project=proj_abc123 --org=my-org`; the CLI
231
+ uses the same resolved org scope for the manifest publish, deployment trigger,
232
+ log stream, and final deployment-state verification.
233
+
234
+ `--skip-manifest` is an operator recovery escape hatch only. It bypasses local
235
+ manifest publication, so any local `sylphx.toml` changes that have not already
236
+ been persisted, including migration command changes, are not part of that
237
+ deployment.
238
+
239
+ ### Preview capacity and service build context
240
+
241
+ Project preview capacity is a public project-level override. It controls how
242
+ many PR preview environments may be active for that project before platform
243
+ backpressure leaves new preview webhooks queued under `sylphx/preview`. Leave
244
+ the value unset to follow the organization plan.
245
+
246
+ ```bash
247
+ sylphx projects preview-capacity get proj_abc123 --output json
248
+ sylphx projects preview-capacity set proj_abc123 10
249
+ sylphx projects preview-capacity clear proj_abc123
250
+ ```
251
+
252
+ Service build source layout remains service-scoped. Use
253
+ `sylphx services update` when a service needs a Dockerfile path, build context,
254
+ or command override without changing the project-level manifest contract.
255
+
256
+ ```bash
257
+ sylphx services update web \
258
+ --project=proj_abc123 \
259
+ --org=my-org \
260
+ --dockerfile=apps/web/Dockerfile \
261
+ --build-context=. \
262
+ --build-command="bun run build"
263
+ ```
264
+
218
265
  ### Managed primitives
219
266
 
220
267
  | Command | Purpose |
221
268
  |---|---|
222
269
  | `sylphx db` | Manage PostgreSQL databases (CNPG-backed) |
270
+ | `sylphx preview` | Preview environment management (branch DB, keep-alive, …) |
271
+ | `sylphx previews` | Per-PR preview cost browser (ADR-137) |
223
272
  | `sylphx storage` | Manage object storage buckets for a linked or explicit project (Ceph S3) |
224
273
  | `sylphx volumes` | Manage persistent volumes for a linked or explicit project (Rook-Ceph RWO/RWX) |
274
+ | `sylphx workspaces` | Manage Platform workspace handles for a linked or explicit project |
225
275
  | `sylphx resources` | Bind / unbind shared resources for a linked or explicit project |
226
276
  | `sylphx services` | List + deploy service blueprints |
227
277
  | `sylphx config` | Per-environment app config for a linked or explicit project |
@@ -239,7 +289,6 @@ The home config is private operator state only. It does not store per-directory
239
289
  | `sylphx backup` | Managed data backup + restore |
240
290
  | `sylphx webhooks` | Outbound webhook endpoint CRUD |
241
291
  | `sylphx flags` | Feature flag admin |
242
- | `sylphx secrets` | Secret management (AES-256-GCM at rest) |
243
292
  | `sylphx realtime` | Realtime channel admin |
244
293
  | `sylphx saml` | SAML SSO configuration |
245
294
  | `sylphx ai` | AI model / completion admin |
@@ -265,6 +314,8 @@ The home config is private operator state only. It does not store per-directory
265
314
  | Command | Purpose |
266
315
  |---|---|
267
316
  | `sylphx monitoring` | Metric + alert admin |
317
+ | `sylphx insights` | Customer-facing latency dashboards — rolling 7-day merge-to-live rollups (ADR-136) |
318
+ | `sylphx health` | Audit + verification subcommands for service health, e.g. `health verify --file` for exported audit hash chains (ADR-144) |
268
319
  | `sylphx certs` | TLS certificate inspection |
269
320
  | `sylphx email` | Transactional email admin |
270
321
  | `sylphx notifications` | Push / in-app notification admin |
@@ -277,6 +328,16 @@ The home config is private operator state only. It does not store per-directory
277
328
  | `sylphx oidc` | OIDC federation (GitHub Actions, GitLab CI, …) |
278
329
  | `sylphx ci` | CI integration helpers (generates workflow snippets) |
279
330
 
331
+ ### Account & administration
332
+
333
+ | Command | Purpose |
334
+ |---|---|
335
+ | `sylphx account` | Account-level operations (verified email change, …) |
336
+ | `sylphx user` | Current-user self-service: profile, sessions, security posture, data export |
337
+ | `sylphx users` | Platform-admin user directory (list / get / role / verify-email / delete / revoke-sessions) |
338
+ | `sylphx admin` | Platform-admin operations (quotas, tenants, builds, reconcile, …) — requires platform-operator scopes |
339
+ | `sylphx rate-limits` | Inspect + tune BaaS rate-limit strategy overrides (ADR-089) |
340
+
280
341
  ## Architecture
281
342
 
282
343
  - Built on `@effect/cli` (ADR-073 Strategy A) — every command is an Effect value, tests can swap the Layer and assert on the Exit channel without subprocessing.
@@ -302,6 +363,12 @@ bun run build # Build production bundle via tsup
302
363
  bun test # Run test suite (bun test)
303
364
  ```
304
365
 
366
+ Shared table-formatting helpers under `packages/cli/src/utils/` are internal
367
+ presentation utilities. Moving identical helpers out of command modules must
368
+ preserve command names, flags, JSON fields, and human-readable output strings;
369
+ otherwise update this README, the public docs, and command tests in the same
370
+ change.
371
+
305
372
  ## Related packages
306
373
 
307
374
  - [`@sylphx/management`](https://www.npmjs.com/package/@sylphx/management) — Promise SDK the CLI is built on (bundled).