@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 +22 -0
- package/README.md +69 -2
- package/dist/main.js +7818 -6763
- package/dist/main.js.map +1 -1
- package/package.json +2 -2
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` |
|
|
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).
|