@deepraxis/cli 0.2.2-dev.aed5777 → 0.2.2-dev.b4fa9b9

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/COMMANDS.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Generated by `bun run commands`. DO NOT EDIT.
4
4
 
5
- 619 HTTP operations; 621 commands including aliases.
5
+ 665 HTTP operations; 667 commands including aliases.
6
6
 
7
7
  Environment: `PRAXIS_ENV=develop|production` (dev package defaults to `develop`; stable package defaults to `production`). No `--env` option.
8
8
 
@@ -16,7 +16,7 @@ Other lists use global `--limit` only for client-side display truncation, even i
16
16
 
17
17
  Every generated command below is typed after `praxis api` (the `Command` column shows the full path); the word after `api` decides the form: an uppercase HTTP method is a raw request, anything else a generated command path.
18
18
 
19
- Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <organization_id>`, `app create <name> [--dir <path>] [--template <dir>] [--no-install]`, `app publish [--dir <path>] [--no-build]`, `app rollback [--dir <path>] [--to <version_id>]`, `devops deploy plan [--env <name>] [--since <commit>]`, `devops test run --remote [--project <dvp_…>] [--no-wait] [--repeat <n>] [--select <kind:value>]`, `skill [--install <dir>]`, `api <METHOD> <path> [--data …]`.
19
+ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <organization_id>`, `app create <name> [--dir <path>] [--template <dir>] [--no-install]`, `app publish [--dir <path>] [--no-build]`, `app rollback [--dir <path>] [--to <version_id>]`, `devops deploy plan [--env <name>] [--since <commit>]`, `devops test run --remote [--project <dvp_…>] [--no-wait] [--repeat <n>] [--select <kind:value>]`, `canvas import <file.pen> [--name <name>] [--canvas <cvs_…> --yes] [--frames <id,id>] [--image-root <dir>] [--dry-run]`, `skill [--install <dir>]`, `api <METHOD> <path> [--data …]`.
20
20
 
21
21
  | Command | SDK method | HTTP | Parameter options |
22
22
  |---|---|---|---|
@@ -326,7 +326,28 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
326
326
  | `praxis api database table list` | `database.databases.tables.list` | GET `/database/v1/databases/{database_id}/tables` | `--database` |
327
327
  | `praxis api database table update <table>` | `database.databases.tables.update` | PATCH `/database/v1/databases/{database_id}/tables/{table}` | `--database`, `--name`, `--description` |
328
328
  | `praxis api database update <database_id>` | `database.databases.update` | PATCH `/database/v1/databases/{database_id}` | `--name` |
329
+ | `praxis api devops environment checkpoint list` | `devops.environments.checkpoints.list` | GET `/devops/v1/environments/{id}/checkpoints` | `--environment` |
330
+ | `praxis api devops flag archive <id>` | `devops.flags.archive` | POST `/devops/v1/flags/{id}:archive` | |
331
+ | `praxis api devops flag conclude <id>` | `devops.flags.conclude` | POST `/devops/v1/flags/{id}:conclude` | `--action`, `--observe-until`, `--reason` |
332
+ | `praxis api devops flag environment update <environment>` | `devops.flags.environments.update` | PATCH `/devops/v1/flags/{id}/environments/{environment}` | `--flag`, `--param-version`, `--comment` |
333
+ | `praxis api devops flag get <id>` | `devops.flags.retrieve` | GET `/devops/v1/flags/{id}` | |
334
+ | `praxis api devops flag update <id>` | `devops.flags.update` | PATCH `/devops/v1/flags/{id}` | `--update-mask` |
335
+ | `praxis api devops progressive-rollout create` | `devops.progressiveRollouts.create` | POST `/devops/v1/progressive-rollouts` | `--flag`, `--environment`, `--variation`, `--bucket-by` |
336
+ | `praxis api devops progressive-rollout get <id>` | `devops.progressiveRollouts.retrieve` | GET `/devops/v1/progressive-rollouts/{id}` | |
337
+ | `praxis api devops progressive-rollout pause <id>` | `devops.progressiveRollouts.pause` | POST `/devops/v1/progressive-rollouts/{id}:pause` | `--reason` |
338
+ | `praxis api devops progressive-rollout resume <id>` | `devops.progressiveRollouts.resume` | POST `/devops/v1/progressive-rollouts/{id}:resume` | |
339
+ | `praxis api devops progressive-rollout rollback <id>` | `devops.progressiveRollouts.rollback` | POST `/devops/v1/progressive-rollouts/{id}:rollback` | `--reason` |
340
+ | `praxis api devops project environment list` | `devops.projects.environments.list` | GET `/devops/v1/projects/{project}/environments` | `--project` |
341
+ | `praxis api devops project flag create` | `devops.projects.flags.create` | POST `/devops/v1/projects/{project}/flags` | `--project`, `--key`, `--name`, `--description`, `--kind`, `--value-type`, `--observe-until`, `--removal-ticket`, `--pull-request`, `--request-id` |
342
+ | `praxis api devops project flag list` | `devops.projects.flags.list` | GET `/devops/v1/projects/{project}/flags` | `--project`, `--page-size`, `--page-token`, `--filter` |
343
+ | `praxis api devops project get <id>` | `devops.projects.retrieve` | GET `/devops/v1/projects/{id}` | |
329
344
  | `praxis api devops project get-test-catalog <project>` | `devops.projects.retrieveTestCatalog` | GET `/devops/v1/projects/{project}/test-catalog` | `--commit` |
345
+ | `praxis api devops project list` | `devops.projects.list` | GET `/devops/v1/projects` | `--page-size`, `--page-token` |
346
+ | `praxis api devops project promotion list` | `devops.projects.promotions.list` | GET `/devops/v1/projects/{project}/promotions` | `--project`, `--page-size`, `--page-token` |
347
+ | `praxis api devops project release create` | `devops.projects.releases.create` | POST `/devops/v1/projects/{project}/releases` | `--project`, `--commit`, `--base`, `--picks`, `--validate-only`, `--request-id` |
348
+ | `praxis api devops project release list` | `devops.projects.releases.list` | GET `/devops/v1/projects/{project}/releases` | `--project`, `--page-size`, `--page-token` |
349
+ | `praxis api devops project target list` | `devops.projects.targets.list` | GET `/devops/v1/projects/{project}/targets` | `--project`, `--page-size`, `--page-token` |
350
+ | `praxis api devops project target refresh <project>` | `devops.projects.targets.refresh` | POST `/devops/v1/projects/{project}/targets:refresh` | `--commit` |
330
351
  | `praxis api devops project test-case list` | `devops.projects.testCases.list` | GET `/devops/v1/projects/{project}/test-cases` | `--project`, `--page-size`, `--page-token`, `--filter`, `--order-by` |
331
352
  | `praxis api devops project test-plan create` | `devops.projects.testPlans.create` | POST `/devops/v1/projects/{project}/test-plans` | `--project`, `--key`, `--title`, `--stage`, `--environment`, `--gate`, `--repeat`, `--timeout-minutes` |
332
353
  | `praxis api devops project test-plan list` | `devops.projects.testPlans.list` | GET `/devops/v1/projects/{project}/test-plans` | `--project`, `--page-size`, `--page-token`, `--order-by` |
@@ -334,6 +355,16 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
334
355
  | `praxis api devops project test-run create` | `devops.projects.testRuns.create` | POST `/devops/v1/projects/{project}/test-runs` | `--project`, `--plan`, `--environment`, `--repeat`, `--wait-until`, `--executor`, `--request-id` |
335
356
  | `praxis api devops project test-run list` | `devops.projects.testRuns.list` | GET `/devops/v1/projects/{project}/test-runs` | `--project`, `--page-size`, `--page-token`, `--filter`, `--order-by` |
336
357
  | `praxis api devops project test-suite list` | `devops.projects.testSuites.list` | GET `/devops/v1/projects/{project}/test-suites` | `--project`, `--page-size`, `--page-token`, `--order-by` |
358
+ | `praxis api devops promotion approve <id>` | `devops.promotions.approve` | POST `/devops/v1/promotions/{id}:approve` | `--approved`, `--comment` |
359
+ | `praxis api devops promotion cancel <id>` | `devops.promotions.cancel` | POST `/devops/v1/promotions/{id}:cancel` | `--reason` |
360
+ | `praxis api devops promotion conclude <id>` | `devops.promotions.conclude` | POST `/devops/v1/promotions/{id}:conclude` | `--action`, `--reason` |
361
+ | `praxis api devops promotion create` | `devops.promotions.create` | POST `/devops/v1/promotions` | `--release`, `--environment`, `--path`, `--targets`, `--validate-only`, `--request-id` |
362
+ | `praxis api devops promotion get <id>` | `devops.promotions.retrieve` | GET `/devops/v1/promotions/{id}` | `--expand` |
363
+ | `praxis api devops promotion retry <id>` | `devops.promotions.retry` | POST `/devops/v1/promotions/{id}:retry` | |
364
+ | `praxis api devops promotion rollout list` | `devops.promotions.rollouts.list` | GET `/devops/v1/promotions/{promotion}/rollouts` | `--promotion`, `--page-size`, `--page-token` |
365
+ | `praxis api devops release abandon <id>` | `devops.releases.abandon` | POST `/devops/v1/releases/{id}:abandon` | `--reason` |
366
+ | `praxis api devops release get <id>` | `devops.releases.retrieve` | GET `/devops/v1/releases/{id}` | |
367
+ | `praxis api devops rollout get <id>` | `devops.rollouts.retrieve` | GET `/devops/v1/rollouts/{id}` | |
337
368
  | `praxis api devops test-case get <id>` | `devops.testCases.retrieve` | GET `/devops/v1/test-cases/{id}` | |
338
369
  | `praxis api devops test-plan delete <id>` | `devops.testPlans.delete` | DELETE `/devops/v1/test-plans/{id}` | |
339
370
  | `praxis api devops test-plan get <id>` | `devops.testPlans.retrieve` | GET `/devops/v1/test-plans/{id}` | |
@@ -380,14 +411,17 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
380
411
  | `praxis api knowledge vector-store search <vector_store_id>` | `knowledge.vectorStores.search.create` | POST `/knowledge/v1/vector_stores/{vector_store_id}/search` | `--max-num-results`, `--rewrite-query`, `--next-page` |
381
412
  | `praxis api knowledge vector-store segment get <chunk_id>` | `knowledge.vectorStores.segments.retrieve` | GET `/knowledge/v1/vector_stores/{vector_store_id}/segments/{chunk_id}` | `--vector-store` |
382
413
  | `praxis api knowledge vector-store update <vector_store_id>` | `knowledge.vectorStores.update` | POST `/knowledge/v1/vector_stores/{vector_store_id}` | `--name` |
414
+ | `praxis api media asset edit <asset_id>` | `media.assets.edit` | POST `/media/v1/libraries/{library_id}/assets/{asset_id}/edits` | `--library`, `--model`, `--asset-folder`, `--understanding`, `--idempotency-key` |
415
+ | `praxis api media asset lineage <asset_id>` | `media.assets.lineage` | GET `/media/v1/libraries/{library_id}/assets/{asset_id}/lineage` | `--library` |
383
416
  | `praxis api media generation capability list` | `media.generation.capabilities.list` | GET `/media/v1/generation/capabilities` | |
417
+ | `praxis api media image generate` | `media.images.generate` | POST `/media/v1/libraries/{library_id}/images/generations` | `--library`, `--prompt`, `--negative-prompt`, `--n`, `--size`, `--background`, `--output-format`, `--output`, `--seed`, `--model`, `--asset-folder`, `--understanding`, `--idempotency-key` |
384
418
  | `praxis api media library asset batch <library_id>` | `media.libraries.assets.batch` | POST `/media/v1/libraries/{library_id}/assets:batch` | `--reason` |
385
419
  | `praxis api media library asset create` | `media.libraries.assets.create` | POST `/media/v1/libraries/{library_id}/assets` | `--library`, `--file`, `--public-id`, `--public-id-prefix`, `--display-name`, `--asset-folder`, `--use-filename`, `--unique-filename`, `--use-filename-as-display-name`, `--filename-override`, `--overwrite`, `--auto-tagging`, `--resource-type`, `--type` |
386
420
  | `praxis api media library asset delete <asset_id>` | `media.libraries.assets.delete` | DELETE `/media/v1/libraries/{library_id}/assets/{asset_id}` | `--library` |
387
421
  | `praxis api media library asset frame create` | `media.libraries.assets.frames.create` | POST `/media/v1/libraries/{library_id}/assets/{asset_id}/frames` | `--library`, `--asset`, `--at-micros`, `--width` |
388
422
  | `praxis api media library asset get <asset_id>` | `media.libraries.assets.retrieve` | GET `/media/v1/libraries/{library_id}/assets/{asset_id}` | `--library` |
389
423
  | `praxis api media library asset import` | `media.libraries.assets.import.create` | POST `/media/v1/libraries/{library_id}/assets/import` | `--library`, `--file-id`, `--public-id`, `--public-id-prefix`, `--display-name`, `--asset-folder`, `--use-filename`, `--unique-filename`, `--use-filename-as-display-name`, `--filename-override`, `--overwrite`, `--auto-tagging`, `--resource-type`, `--type` |
390
- | `praxis api media library asset list` | `media.libraries.assets.list` | GET `/media/v1/libraries/{library_id}/assets` | `--library`, `--asset-folder`, `--resource-type`, `--param-cursor`, `--param-limit` |
424
+ | `praxis api media library asset list` | `media.libraries.assets.list` | GET `/media/v1/libraries/{library_id}/assets` | `--library`, `--asset-folder`, `--resource-type`, `--material-type`, `--param-cursor`, `--param-limit` |
391
425
  | `praxis api media library asset reprocess <asset_id>` | `media.libraries.assets.reprocess.create` | POST `/media/v1/libraries/{library_id}/assets/{asset_id}/reprocess` | `--library`, `--kinds` |
392
426
  | `praxis api media library asset understanding list` | `media.libraries.assets.understandings.list` | GET `/media/v1/libraries/{library_id}/assets/{asset_id}/understandings` | `--library`, `--asset`, `--include-superseded`, `--kind`, `--param-cursor`, `--param-limit` |
393
427
  | `praxis api media library asset update <asset_id>` | `media.libraries.assets.update` | PATCH `/media/v1/libraries/{library_id}/assets/{asset_id}` | `--library`, `--display-name`, `--asset-folder`, `--tags` |
@@ -400,6 +434,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
400
434
  | `praxis api media library folder list` | `media.libraries.folders.list` | GET `/media/v1/libraries/{library_id}/folders` | `--library`, `--parent` |
401
435
  | `praxis api media library generation create` | `media.libraries.generations.create` | POST `/media/v1/libraries/{library_id}/generations` | `--library`, `--intent`, `--prompt`, `--count`, `--duration-seconds`, `--aspect-ratio`, `--model`, `--save`, `--asset-folder`, `--tags`, `--understanding` |
402
436
  | `praxis api media library get <library_id>` | `media.libraries.retrieve` | GET `/media/v1/libraries/{library_id}` | |
437
+ | `praxis api media library get-default` | `media.libraries.retrieveDefault` | GET `/media/v1/libraries/default` | |
403
438
  | `praxis api media library job cancel <job_id>` | `media.libraries.jobs.cancel` | POST `/media/v1/libraries/{library_id}/jobs/{job_id}/cancel` | `--library` |
404
439
  | `praxis api media library job get <job_id>` | `media.libraries.jobs.retrieve` | GET `/media/v1/libraries/{library_id}/jobs/{job_id}` | `--library` |
405
440
  | `praxis api media library job list` | `media.libraries.jobs.list` | GET `/media/v1/libraries/{library_id}/jobs` | `--library`, `--status`, `--param-limit`, `--param-cursor` |
@@ -407,13 +442,15 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
407
442
  | `praxis api media library list` | `media.libraries.list` | GET `/media/v1/libraries` | `--param-cursor`, `--param-limit`, `--labels`, `--status` |
408
443
  | `praxis api media library purge <library_id>` | `media.libraries.purge.create` | POST `/media/v1/libraries/{library_id}/purge` | |
409
444
  | `praxis api media library restore <library_id>` | `media.libraries.restore` | POST `/media/v1/libraries/{library_id}/restore` | |
410
- | `praxis api media library search <library_id>` | `media.libraries.search.create` | POST `/media/v1/libraries/{library_id}/search` | `--query`, `--filter`, `--top-k`, `--mode` |
445
+ | `praxis api media library search <library_id>` | `media.libraries.search.create` | POST `/media/v1/libraries/{library_id}/search` | `--query`, `--filter`, `--top-k`, `--mode`, `--material-type` |
411
446
  | `praxis api media library search-expression` | `media.libraries.search.expression.create` | POST `/media/v1/libraries/{library_id}/search/expression` | `--library`, `--expression`, `--max-results`, `--next-cursor`, `--with-field`, `--aggregate` |
412
- | `praxis api media library search-semantic` | `media.libraries.search.semantic.create` | POST `/media/v1/libraries/{library_id}/search/semantic` | `--library`, `--query`, `--filter`, `--top-k`, `--mode` |
447
+ | `praxis api media library search-semantic` | `media.libraries.search.semantic.create` | POST `/media/v1/libraries/{library_id}/search/semantic` | `--library`, `--query`, `--filter`, `--top-k`, `--mode`, `--material-type` |
413
448
  | `praxis api media library search-visual` | `media.libraries.search.visual.create` | POST `/media/v1/libraries/{library_id}/search/visual` | `--library`, `--asset-id`, `--top-k`, `--filter` |
449
+ | `praxis api media library set-default` | `media.libraries.setDefault` | PUT `/media/v1/libraries/default` | `--library-id` |
414
450
  | `praxis api media library understanding get-failure-summary` | `media.libraries.understandings.retrieveFailureSummary` | GET `/media/v1/libraries/{library_id}/understandings/failure_summary` | `--library` |
415
451
  | `praxis api media library understanding list` | `media.libraries.understandings.list` | GET `/media/v1/libraries/{library_id}/understandings` | `--library`, `--folder`, `--kinds`, `--param-cursor`, `--param-limit` |
416
452
  | `praxis api media library update <library_id>` | `media.libraries.update` | PATCH `/media/v1/libraries/{library_id}` | `--hotwords`, `--name` |
453
+ | `praxis api media video generate` | `media.videos.generate` | POST `/media/v1/libraries/{library_id}/videos/generations` | `--library`, `--prompt`, `--negative-prompt`, `--mode`, `--first-frame`, `--last-frame`, `--duration-seconds`, `--resolution`, `--aspect-ratio`, `--generate-audio`, `--output`, `--n`, `--seed`, `--model`, `--asset-folder`, `--understanding`, `--idempotency-key` |
417
454
  | `praxis api meta doc get <path>` | `meta.docs.retrieve` | GET `/meta/v1/docs/{path}` | `--lang` |
418
455
  | `praxis api meta doc search` | `meta.docs.search` | GET `/meta/v1/docs/search` | `--q`, `--param-limit`, `--lang` |
419
456
  | `praxis api meta health get` | `meta.health.retrieve` | GET `/meta/v1/health` | |
@@ -457,6 +494,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
457
494
  | `praxis api ontology changeset create` | `ontology.changesets.create` | POST `/ontology/v1/changesets` | `--at`, `--scope` |
458
495
  | `praxis api ontology node create` | `ontology.nodes.create` | POST `/ontology/v1/nodes` | `--type`, `--ref`, `--name`, `--aliases`, `--description`, `--owner` |
459
496
  | `praxis api ontology node get <node_id>` | `ontology.nodes.retrieve` | GET `/ontology/v1/nodes/{node_id}` | `--expand`, `--as-of` |
497
+ | `praxis api ontology node get-neighborhood <node_id>` | `ontology.nodes.retrieveNeighborhood` | GET `/ontology/v1/nodes/{node_id}/neighborhood` | `--depth`, `--param-limit`, `--direction`, `--as-of`, `--include-invalid` |
460
498
  | `praxis api ontology node list` | `ontology.nodes.list` | GET `/ontology/v1/nodes` | `--type`, `--q`, `--owner`, `--as-of`, `--param-limit`, `--param-cursor` |
461
499
  | `praxis api ontology node merge create` | `ontology.nodes.merge.create` | POST `/ontology/v1/nodes/{node_id}/merge` | `--node`, `--into` |
462
500
  | `praxis api ontology node update <node_id>` | `ontology.nodes.update` | PATCH `/ontology/v1/nodes/{node_id}` | `--name`, `--aliases`, `--description` |
@@ -559,6 +597,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
559
597
  | `praxis api studio work draft get-review <draft>` | `studio.works.drafts.retrieveReview` | GET `/studio/v1/works/{work}/drafts/{draft}/review` | `--work`, `--page-token` |
560
598
  | `praxis api studio work draft list` | `studio.works.drafts.list` | GET `/studio/v1/works/{work}/drafts` | `--work` |
561
599
  | `praxis api studio work draft rebase <draft>` | `studio.works.drafts.rebase` | POST `/studio/v1/works/{work}/drafts/{draft}:rebase` | `--work`, `--expected-revision` |
600
+ | `praxis api studio work draft rendition create` | `studio.works.drafts.renditions.create` | POST `/studio/v1/works/{work}/drafts/{draft}/renditions` | `--work`, `--draft`, `--platform`, `--theme`, `--render`, `--request-id` |
562
601
  | `praxis api studio work draft status list` | `studio.works.drafts.status.list` | GET `/studio/v1/works/{work}/drafts/{draft}/status` | `--work`, `--draft` |
563
602
  | `praxis api studio work draft unit batch-create <draft>` | `studio.works.drafts.units.batchCreate` | POST `/studio/v1/works/{work}/drafts/{draft}/units:batchCreate` | `--work`, `--expected-revision`, `--parent` |
564
603
  | `praxis api studio work draft unit batch-update <draft>` | `studio.works.drafts.units.batchUpdate` | POST `/studio/v1/works/{work}/drafts/{draft}/units:batchUpdate` | `--work`, `--expected-revision` |
@@ -566,6 +605,13 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
566
605
  | `praxis api studio work draft update <draft>` | `studio.works.drafts.update` | PATCH `/studio/v1/works/{work}/drafts/{draft}` | `--work`, `--update-mask`, `--expected-revision`, `--title`, `--key`, `--style`, `--mode` |
567
606
  | `praxis api studio work get <work>` | `studio.works.retrieve` | GET `/studio/v1/works/{work}` | `--draft`, `--unit`, `--expand` |
568
607
  | `praxis api studio work list` | `studio.works.list` | GET `/studio/v1/works` | `--page-size`, `--page-token`, `--archived` |
608
+ | `praxis api studio work rendition delete <rendition>` | `studio.works.renditions.delete` | DELETE `/studio/v1/works/{work}/renditions/{rendition}` | `--work` |
609
+ | `praxis api studio work rendition get <rendition>` | `studio.works.renditions.retrieve` | GET `/studio/v1/works/{work}/renditions/{rendition}` | `--work` |
610
+ | `praxis api studio work rendition get-content <rendition>` | `studio.works.renditions.retrieveContent` | GET `/studio/v1/works/{work}/renditions/{rendition}/content` | `--work`, `--part` |
611
+ | `praxis api studio work rendition list` | `studio.works.renditions.list` | GET `/studio/v1/works/{work}/renditions` | `--work`, `--draft`, `--page-size`, `--page-token` |
612
+ | `praxis api studio work rendition publish <rendition>` | `studio.works.renditions.publish` | POST `/studio/v1/works/{work}/renditions/{rendition}:publish` | `--work` |
613
+ | `praxis api studio work rendition render <rendition>` | `studio.works.renditions.render` | POST `/studio/v1/works/{work}/renditions/{rendition}:render` | `--work` |
614
+ | `praxis api studio work rendition update <rendition>` | `studio.works.renditions.update` | PATCH `/studio/v1/works/{work}/renditions/{rendition}` | `--work`, `--update-mask`, `--theme` |
569
615
  | `praxis api studio work resolve` | `studio.works.resolve` | GET `/studio/v1/works:resolve` | `--ref` |
570
616
  | `praxis api studio work unit block patch <unit>` | `studio.works.units.blocks.patch` | POST `/studio/v1/works/{work}/units/{unit}/blocks:patch` | `--work`, `--expected-revision`, `--confirm-final-edit` |
571
617
  | `praxis api studio work unit get <unit>` | `studio.works.units.retrieve` | GET `/studio/v1/works/{work}/units/{unit}` | `--work`, `--view` |
@@ -573,7 +619,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
573
619
  | `praxis api studio work unit move <unit>` | `studio.works.units.move` | POST `/studio/v1/works/{work}/units/{unit}:move` | `--work`, `--expected-revision`, `--parent`, `--after` |
574
620
  | `praxis api studio work unit update <unit>` | `studio.works.units.update` | PATCH `/studio/v1/works/{work}/units/{unit}` | `--work`, `--expected-revision`, `--name`, `--heading`, `--synopsis`, `--points`, `--brief-points`, `--body`, `--synopsis-from-body`, `--status`, `--seconds`, `--confirm-final-edit` |
575
621
  | `praxis api studio work update <work>` | `studio.works.update` | PATCH `/studio/v1/works/{work}` | `--update-mask`, `--expected-revision`, `--title`, `--slug`, `--codexes`, `--style`, `--archived` |
576
- | `praxis api studio work update-brief <work>` | `studio.works.updateBrief` | PATCH `/studio/v1/works/{work}/brief` | `--expected-revision`, `--text`, `--attachments`, `--add-points`, `--remove-points` |
622
+ | `praxis api studio work update-brief <work>` | `studio.works.updateBrief` | PATCH `/studio/v1/works/{work}/brief` | `--expected-revision`, `--text`, `--attachments`, `--remove-points` |
577
623
  | `praxis api ticket activity get` | `ticket.activity.retrieve` | GET `/ticket/v1/activity` | `--repository`, `--page-size`, `--page-token`, `--filter` |
578
624
  | `praxis api ticket comment create` | `ticket.tickets.comments.create` | POST `/ticket/v1/tickets/{number}/comments` | `--ticket`, `--repository`, `--body`, `--in-reply-to` |
579
625
  | `praxis api ticket comment delete <id>` | `ticket.comments.delete` | DELETE `/ticket/v1/comments/{id}` | `--repository` |
package/README.md CHANGED
@@ -38,7 +38,7 @@ praxis app rollback # deploy the previous version again
38
38
 
39
39
  `praxis.jsonc` at the project root names the app and may declare `"secrets": {"SESSION_SECRET": "generate"}`
40
40
  (created once, kept by every later deploy) and `"healthcheck": "/api/health"` (a failing check fails the deploy).
41
- In computers and sandboxes the CLI signs in with `PRAXIS_API_TOKEN`; `PRAXIS_API_KEY` takes precedence when both are set.
41
+ In computers and sandboxes the CLI signs in with `PRAXIS_API_TOKEN`; an API key for the same environment takes precedence when both are set.
42
42
 
43
43
  ## Run the tests of a DevOps project
44
44
 
@@ -100,12 +100,17 @@ praxis api model list --org <organization_id> # just this call
100
100
 
101
101
  For CI and other headless environments, create an API key in the
102
102
  [Console](https://console.deepraxis.com/keys) and set it instead of logging in.
103
- `PRAXIS_API_KEY` always takes precedence over a stored login:
103
+ An API key belongs to one environment, so each environment reads its own variable, and that key
104
+ takes precedence over a stored login for the same environment:
104
105
 
105
106
  ```sh
106
- export PRAXIS_API_KEY=<your-api-key>
107
+ export PRAXIS_API_KEY=<your-api-key> # production
108
+ export PRAXIS_API_KEY_DEVELOP=<your-develop-api-key> # develop (PRAXIS_ENV=develop), Praxis team only
107
109
  ```
108
110
 
111
+ A production key in `PRAXIS_API_KEY` is never sent to develop: with `PRAXIS_ENV=develop` the CLI uses
112
+ `PRAXIS_API_KEY_DEVELOP`, or the develop login when it is unset.
113
+
109
114
  ## A tour
110
115
 
111
116
  ### Models
@@ -217,7 +222,8 @@ read results in its compact agent format.
217
222
 
218
223
  | Variable | Purpose |
219
224
  |---|---|
220
- | `PRAXIS_API_KEY` | Authenticate with an API key instead of `praxis login`. |
225
+ | `PRAXIS_API_KEY` | Authenticate to production with an API key instead of `praxis login`. |
226
+ | `PRAXIS_API_KEY_DEVELOP` | The same for develop (`PRAXIS_ENV=develop`); a production key is never used there. |
221
227
  | `PRAXIS_ENV` | `production` (default) or `develop`, for Praxis team members testing pre-release services. |
222
228
  | `PRAXIS_CREDENTIAL_STORE` | Set to `file` to keep logins out of the system keychain, for example in disposable test homes. |
223
229
  | `NO_COLOR` | Disable colors in human output. |