@solidactions/cli 3.3.0 → 3.5.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/README.md CHANGED
@@ -169,17 +169,42 @@ Use `solidactions <command> --help` for full flag details on any command.
169
169
  | Command | Key Flags | Description |
170
170
  |---------|-----------|-------------|
171
171
  | `project create <name>` | `-e` | Create an empty project (no source/build); `-e` defaults to `production` |
172
- | `project deploy <name> [path]` | `-e`, `--create`, `--config-only`, `--no-git-metadata` | Deploy or sync config only |
173
- | `project view <project>` | `-e` | View status and client-reported deployed revision |
172
+ | `project deploy <name> [path]` | `-e`, `--create`, `--config-only`, `--paused`, `--no-git-metadata` | Deploy or sync config only; optionally land YAML schedules paused |
173
+ | `project enable <project>` | `-e` (default `dev`) | Allow new starts through this project gate |
174
+ | `project disable <project>` | `-e` (default `dev`) | Block new root starts without cancelling existing roots |
175
+ | `project view <project>` | `-e` (default `dev`) | View status, `Enabled: on|off`, and client-reported deployed revision |
174
176
  | `project pull <name> [path]` | `-y` | Pull source (warns before overwriting) |
175
177
  | `project logs <name>` | | View build logs |
176
- | `project list` | | List all projects |
178
+ | `project list` | `--json` | List project families; environments render as `environment:on/off` |
177
179
 
178
- For `project view`, omitting `--env` treats `<project>` as an exact slug.
179
- Passing `--env production` uses the supplied production name/slug unchanged;
180
- `--env staging` and `--env dev` derive the same suffixed slug as deploy. This
181
- is deliberately different from historical commands such as `run start`,
182
- which default to dev.
180
+ For `project view`, `<project>` is a project family slug or name and omitting
181
+ `--env` targets dev (`billing` resolves to `billing-dev`). Use `--env production`
182
+ to pass the supplied production name/slug unchanged; `--env staging` and
183
+ `--env dev` derive the same suffixed slug as deploy.
184
+
185
+ This changes exact-suffixed positional input: `project view billing-dev` now
186
+ targets `billing-dev-dev`. Use `project view billing` for the dev target, or
187
+ pass `--env production` when `billing-dev` is the legitimate production slug.
188
+
189
+ Project enable/disable is an explicit, non-interactive operator action. It does
190
+ not cascade to workflows or schedules, and deploy does not undo the manual
191
+ state.
192
+
193
+ ### workflow
194
+
195
+ | Command | Key Flags | Description |
196
+ |---------|-----------|-------------|
197
+ | `workflow view <project> <workflow>` | `-e` (default `dev`), `--json` | Inspect stored workflow/project gates, retirement, enabled source, and effective state |
198
+ | `workflow enable <project> <workflow>` | `-e` (default `dev`) | Enable the workflow gate; direct starts still require the project, and scheduled starts also require the schedule |
199
+ | `workflow disable <project> <workflow>` | `-e` (default `dev`) | Block new root starts without cancelling existing roots |
200
+
201
+ Workflow view/enable/disable accepts an exact workflow slug or an exact name and
202
+ does not prompt. View defaults to dev like the mutation commands, and reports
203
+ `Enabled source: manual override (deploy will not change it)` or
204
+ `Enabled source: YAML declaration`; use `--json` for the unmodified
205
+ machine-queryable state.
206
+ The manual state is sticky across deploys; enabling a workflow does not enable
207
+ its project or schedule.
183
208
 
184
209
  ### run
185
210
 
@@ -205,19 +230,24 @@ which default to dev.
205
230
 
206
231
  | Command | Key Flags | Description |
207
232
  |---------|-----------|-------------|
208
- | `schedule set <project> <cron>` | `--workflow`, `-i`, `-z`, `-y` | Set cron schedule and optional IANA timezone (warns if exists) |
209
- | `schedule list <project>` | | List schedules |
210
- | `schedule delete <project> <id>` | `-y` | Delete a schedule |
233
+ | `schedule set <project> <cron>` | `--workflow`, `-i`, `-z`, `-e`, `--paused`, `-y` | Set cron schedule and optional IANA timezone (warns if exists) |
234
+ | `schedule list <project>` | `-e` | List effective state and operator/YAML disagreement |
235
+ | `schedule enable <project> <id>` | `-e` | Enable a schedule with a sticky override |
236
+ | `schedule disable <project> <id>` | `-e` | Disable a schedule with a sticky override |
237
+ | `schedule reset <project> <id>` | `-e` | Return a schedule to its last declared YAML state |
238
+ | `schedule delete <project> <id>` | `-e`, `-y` | Delete a schedule |
211
239
 
212
240
  ```bash
213
241
  solidactions schedule set my-project '0 9 * * 1-5' --workflow daily-summary --timezone America/Chicago
242
+ solidactions project deploy my-project -e production --paused
243
+ solidactions schedule enable my-project 42 -e production
214
244
  ```
215
245
 
216
246
  ### webhook
217
247
 
218
248
  | Command | Key Flags | Description |
219
249
  |---------|-----------|-------------|
220
- | `webhook list <project>` | `-e`, `--show-secrets` | List webhook URLs |
250
+ | `webhook list <project>` | `-e`, `--format table|json`, `--show-secrets` | List webhook URLs and state: `retired`, `off`, `blocked (project off)`, or `on` |
221
251
 
222
252
  ### skill
223
253
 
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "cli_name": "solidactions",
4
- "cli_version": "3.3.0",
4
+ "cli_version": "3.5.0",
5
5
  "global_options": [
6
6
  {
7
7
  "flags": "-V, --version",
@@ -402,7 +402,7 @@
402
402
  "name": "project",
403
403
  "required": true,
404
404
  "variadic": false,
405
- "description": "Exact project slug (or project family/name when --env is explicit)"
405
+ "description": "Project family slug or name"
406
406
  }
407
407
  ],
408
408
  "options": [
@@ -410,13 +410,14 @@
410
410
  "flags": "-e, --env <environment>",
411
411
  "long": "--env",
412
412
  "short": "-e",
413
- "description": "Resolve an explicit environment (production/staging/dev)",
413
+ "description": "Target environment (production/staging/dev). Defaults to dev.",
414
414
  "required": false,
415
415
  "value_required": true,
416
416
  "value_optional": false,
417
417
  "variadic": false,
418
418
  "negated": false,
419
- "hidden": false
419
+ "hidden": false,
420
+ "default": "dev"
420
421
  },
421
422
  {
422
423
  "flags": "-h, --help",
@@ -536,6 +537,18 @@
536
537
  "negated": false,
537
538
  "hidden": false
538
539
  },
540
+ {
541
+ "flags": "--paused",
542
+ "long": "--paused",
543
+ "short": null,
544
+ "description": "Deploy with all YAML-declared schedules initially paused",
545
+ "required": false,
546
+ "value_required": false,
547
+ "value_optional": false,
548
+ "variadic": false,
549
+ "negated": false,
550
+ "hidden": false
551
+ },
539
552
  {
540
553
  "flags": "--no-cache",
541
554
  "long": "--no-cache",
@@ -734,6 +747,304 @@
734
747
  {
735
748
  "path": [
736
749
  "project",
750
+ "enable"
751
+ ],
752
+ "name": "enable",
753
+ "aliases": [],
754
+ "description": "Allow new workflow starts for a project environment",
755
+ "hidden": false,
756
+ "arguments": [
757
+ {
758
+ "name": "project",
759
+ "required": true,
760
+ "variadic": false,
761
+ "description": "Project name"
762
+ }
763
+ ],
764
+ "options": [
765
+ {
766
+ "flags": "-e, --env <environment>",
767
+ "long": "--env",
768
+ "short": "-e",
769
+ "description": "Environment (production/staging/dev). Defaults to dev.",
770
+ "required": false,
771
+ "value_required": true,
772
+ "value_optional": false,
773
+ "variadic": false,
774
+ "negated": false,
775
+ "hidden": false,
776
+ "default": "dev"
777
+ },
778
+ {
779
+ "flags": "-h, --help",
780
+ "long": "--help",
781
+ "short": "-h",
782
+ "description": "display help for command",
783
+ "required": false,
784
+ "value_required": false,
785
+ "value_optional": false,
786
+ "variadic": false,
787
+ "negated": false,
788
+ "hidden": false
789
+ }
790
+ ]
791
+ },
792
+ {
793
+ "path": [
794
+ "project",
795
+ "disable"
796
+ ],
797
+ "name": "disable",
798
+ "aliases": [],
799
+ "description": "Block new workflow starts for a project environment",
800
+ "hidden": false,
801
+ "arguments": [
802
+ {
803
+ "name": "project",
804
+ "required": true,
805
+ "variadic": false,
806
+ "description": "Project name"
807
+ }
808
+ ],
809
+ "options": [
810
+ {
811
+ "flags": "-e, --env <environment>",
812
+ "long": "--env",
813
+ "short": "-e",
814
+ "description": "Environment (production/staging/dev). Defaults to dev.",
815
+ "required": false,
816
+ "value_required": true,
817
+ "value_optional": false,
818
+ "variadic": false,
819
+ "negated": false,
820
+ "hidden": false,
821
+ "default": "dev"
822
+ },
823
+ {
824
+ "flags": "-h, --help",
825
+ "long": "--help",
826
+ "short": "-h",
827
+ "description": "display help for command",
828
+ "required": false,
829
+ "value_required": false,
830
+ "value_optional": false,
831
+ "variadic": false,
832
+ "negated": false,
833
+ "hidden": false
834
+ }
835
+ ]
836
+ },
837
+ {
838
+ "path": [
839
+ "project",
840
+ "help"
841
+ ],
842
+ "name": "help",
843
+ "aliases": [],
844
+ "description": "display help for command",
845
+ "hidden": false,
846
+ "arguments": [
847
+ {
848
+ "name": "command",
849
+ "required": false,
850
+ "variadic": false,
851
+ "description": ""
852
+ }
853
+ ],
854
+ "options": []
855
+ },
856
+ {
857
+ "path": [
858
+ "workflow"
859
+ ],
860
+ "name": "workflow",
861
+ "aliases": [],
862
+ "description": "Manage deployed workflows",
863
+ "hidden": false,
864
+ "arguments": [],
865
+ "options": [
866
+ {
867
+ "flags": "-h, --help",
868
+ "long": "--help",
869
+ "short": "-h",
870
+ "description": "display help for command",
871
+ "required": false,
872
+ "value_required": false,
873
+ "value_optional": false,
874
+ "variadic": false,
875
+ "negated": false,
876
+ "hidden": false
877
+ }
878
+ ]
879
+ },
880
+ {
881
+ "path": [
882
+ "workflow",
883
+ "view"
884
+ ],
885
+ "name": "view",
886
+ "aliases": [],
887
+ "description": "View a deployed workflow's enabled state",
888
+ "hidden": false,
889
+ "arguments": [
890
+ {
891
+ "name": "project",
892
+ "required": true,
893
+ "variadic": false,
894
+ "description": "Project name"
895
+ },
896
+ {
897
+ "name": "workflow",
898
+ "required": true,
899
+ "variadic": false,
900
+ "description": "Exact workflow slug or name"
901
+ }
902
+ ],
903
+ "options": [
904
+ {
905
+ "flags": "-e, --env <environment>",
906
+ "long": "--env",
907
+ "short": "-e",
908
+ "description": "Environment (production/staging/dev). Defaults to dev.",
909
+ "required": false,
910
+ "value_required": true,
911
+ "value_optional": false,
912
+ "variadic": false,
913
+ "negated": false,
914
+ "hidden": false,
915
+ "default": "dev"
916
+ },
917
+ {
918
+ "flags": "--json",
919
+ "long": "--json",
920
+ "short": null,
921
+ "description": "Output the server workflow state as JSON",
922
+ "required": false,
923
+ "value_required": false,
924
+ "value_optional": false,
925
+ "variadic": false,
926
+ "negated": false,
927
+ "hidden": false
928
+ },
929
+ {
930
+ "flags": "-h, --help",
931
+ "long": "--help",
932
+ "short": "-h",
933
+ "description": "display help for command",
934
+ "required": false,
935
+ "value_required": false,
936
+ "value_optional": false,
937
+ "variadic": false,
938
+ "negated": false,
939
+ "hidden": false
940
+ }
941
+ ]
942
+ },
943
+ {
944
+ "path": [
945
+ "workflow",
946
+ "enable"
947
+ ],
948
+ "name": "enable",
949
+ "aliases": [],
950
+ "description": "Allow new starts for a deployed workflow",
951
+ "hidden": false,
952
+ "arguments": [
953
+ {
954
+ "name": "project",
955
+ "required": true,
956
+ "variadic": false,
957
+ "description": "Project name"
958
+ },
959
+ {
960
+ "name": "workflow",
961
+ "required": true,
962
+ "variadic": false,
963
+ "description": "Workflow name or slug"
964
+ }
965
+ ],
966
+ "options": [
967
+ {
968
+ "flags": "-e, --env <environment>",
969
+ "long": "--env",
970
+ "short": "-e",
971
+ "description": "Environment (production/staging/dev). Defaults to dev.",
972
+ "required": false,
973
+ "value_required": true,
974
+ "value_optional": false,
975
+ "variadic": false,
976
+ "negated": false,
977
+ "hidden": false,
978
+ "default": "dev"
979
+ },
980
+ {
981
+ "flags": "-h, --help",
982
+ "long": "--help",
983
+ "short": "-h",
984
+ "description": "display help for command",
985
+ "required": false,
986
+ "value_required": false,
987
+ "value_optional": false,
988
+ "variadic": false,
989
+ "negated": false,
990
+ "hidden": false
991
+ }
992
+ ]
993
+ },
994
+ {
995
+ "path": [
996
+ "workflow",
997
+ "disable"
998
+ ],
999
+ "name": "disable",
1000
+ "aliases": [],
1001
+ "description": "Block new starts for a deployed workflow",
1002
+ "hidden": false,
1003
+ "arguments": [
1004
+ {
1005
+ "name": "project",
1006
+ "required": true,
1007
+ "variadic": false,
1008
+ "description": "Project name"
1009
+ },
1010
+ {
1011
+ "name": "workflow",
1012
+ "required": true,
1013
+ "variadic": false,
1014
+ "description": "Workflow name or slug"
1015
+ }
1016
+ ],
1017
+ "options": [
1018
+ {
1019
+ "flags": "-e, --env <environment>",
1020
+ "long": "--env",
1021
+ "short": "-e",
1022
+ "description": "Environment (production/staging/dev). Defaults to dev.",
1023
+ "required": false,
1024
+ "value_required": true,
1025
+ "value_optional": false,
1026
+ "variadic": false,
1027
+ "negated": false,
1028
+ "hidden": false,
1029
+ "default": "dev"
1030
+ },
1031
+ {
1032
+ "flags": "-h, --help",
1033
+ "long": "--help",
1034
+ "short": "-h",
1035
+ "description": "display help for command",
1036
+ "required": false,
1037
+ "value_required": false,
1038
+ "value_optional": false,
1039
+ "variadic": false,
1040
+ "negated": false,
1041
+ "hidden": false
1042
+ }
1043
+ ]
1044
+ },
1045
+ {
1046
+ "path": [
1047
+ "workflow",
737
1048
  "help"
738
1049
  ],
739
1050
  "name": "help",
@@ -2120,6 +2431,30 @@
2120
2431
  "negated": false,
2121
2432
  "hidden": false
2122
2433
  },
2434
+ {
2435
+ "flags": "-e, --env <environment>",
2436
+ "long": "--env",
2437
+ "short": "-e",
2438
+ "description": "Resolve an explicit environment (production/staging/dev)",
2439
+ "required": false,
2440
+ "value_required": true,
2441
+ "value_optional": false,
2442
+ "variadic": false,
2443
+ "negated": false,
2444
+ "hidden": false
2445
+ },
2446
+ {
2447
+ "flags": "--paused",
2448
+ "long": "--paused",
2449
+ "short": null,
2450
+ "description": "Create or replace the schedule disabled",
2451
+ "required": false,
2452
+ "value_required": false,
2453
+ "value_optional": false,
2454
+ "variadic": false,
2455
+ "negated": false,
2456
+ "hidden": false
2457
+ },
2123
2458
  {
2124
2459
  "flags": "-y, --yes",
2125
2460
  "long": "--yes",
@@ -2164,6 +2499,168 @@
2164
2499
  }
2165
2500
  ],
2166
2501
  "options": [
2502
+ {
2503
+ "flags": "-e, --env <environment>",
2504
+ "long": "--env",
2505
+ "short": "-e",
2506
+ "description": "Resolve an explicit environment (production/staging/dev)",
2507
+ "required": false,
2508
+ "value_required": true,
2509
+ "value_optional": false,
2510
+ "variadic": false,
2511
+ "negated": false,
2512
+ "hidden": false
2513
+ },
2514
+ {
2515
+ "flags": "-h, --help",
2516
+ "long": "--help",
2517
+ "short": "-h",
2518
+ "description": "display help for command",
2519
+ "required": false,
2520
+ "value_required": false,
2521
+ "value_optional": false,
2522
+ "variadic": false,
2523
+ "negated": false,
2524
+ "hidden": false
2525
+ }
2526
+ ]
2527
+ },
2528
+ {
2529
+ "path": [
2530
+ "schedule",
2531
+ "enable"
2532
+ ],
2533
+ "name": "enable",
2534
+ "aliases": [],
2535
+ "description": "Enable a schedule with a sticky operator override",
2536
+ "hidden": false,
2537
+ "arguments": [
2538
+ {
2539
+ "name": "project",
2540
+ "required": true,
2541
+ "variadic": false,
2542
+ "description": "Project name"
2543
+ },
2544
+ {
2545
+ "name": "schedule-id",
2546
+ "required": true,
2547
+ "variadic": false,
2548
+ "description": "Schedule ID"
2549
+ }
2550
+ ],
2551
+ "options": [
2552
+ {
2553
+ "flags": "-e, --env <environment>",
2554
+ "long": "--env",
2555
+ "short": "-e",
2556
+ "description": "Resolve an explicit environment (production/staging/dev)",
2557
+ "required": false,
2558
+ "value_required": true,
2559
+ "value_optional": false,
2560
+ "variadic": false,
2561
+ "negated": false,
2562
+ "hidden": false
2563
+ },
2564
+ {
2565
+ "flags": "-h, --help",
2566
+ "long": "--help",
2567
+ "short": "-h",
2568
+ "description": "display help for command",
2569
+ "required": false,
2570
+ "value_required": false,
2571
+ "value_optional": false,
2572
+ "variadic": false,
2573
+ "negated": false,
2574
+ "hidden": false
2575
+ }
2576
+ ]
2577
+ },
2578
+ {
2579
+ "path": [
2580
+ "schedule",
2581
+ "disable"
2582
+ ],
2583
+ "name": "disable",
2584
+ "aliases": [],
2585
+ "description": "Disable a schedule with a sticky operator override",
2586
+ "hidden": false,
2587
+ "arguments": [
2588
+ {
2589
+ "name": "project",
2590
+ "required": true,
2591
+ "variadic": false,
2592
+ "description": "Project name"
2593
+ },
2594
+ {
2595
+ "name": "schedule-id",
2596
+ "required": true,
2597
+ "variadic": false,
2598
+ "description": "Schedule ID"
2599
+ }
2600
+ ],
2601
+ "options": [
2602
+ {
2603
+ "flags": "-e, --env <environment>",
2604
+ "long": "--env",
2605
+ "short": "-e",
2606
+ "description": "Resolve an explicit environment (production/staging/dev)",
2607
+ "required": false,
2608
+ "value_required": true,
2609
+ "value_optional": false,
2610
+ "variadic": false,
2611
+ "negated": false,
2612
+ "hidden": false
2613
+ },
2614
+ {
2615
+ "flags": "-h, --help",
2616
+ "long": "--help",
2617
+ "short": "-h",
2618
+ "description": "display help for command",
2619
+ "required": false,
2620
+ "value_required": false,
2621
+ "value_optional": false,
2622
+ "variadic": false,
2623
+ "negated": false,
2624
+ "hidden": false
2625
+ }
2626
+ ]
2627
+ },
2628
+ {
2629
+ "path": [
2630
+ "schedule",
2631
+ "reset"
2632
+ ],
2633
+ "name": "reset",
2634
+ "aliases": [],
2635
+ "description": "Return a schedule to its last declared YAML configuration",
2636
+ "hidden": false,
2637
+ "arguments": [
2638
+ {
2639
+ "name": "project",
2640
+ "required": true,
2641
+ "variadic": false,
2642
+ "description": "Project name"
2643
+ },
2644
+ {
2645
+ "name": "schedule-id",
2646
+ "required": true,
2647
+ "variadic": false,
2648
+ "description": "Schedule ID"
2649
+ }
2650
+ ],
2651
+ "options": [
2652
+ {
2653
+ "flags": "-e, --env <environment>",
2654
+ "long": "--env",
2655
+ "short": "-e",
2656
+ "description": "Resolve an explicit environment (production/staging/dev)",
2657
+ "required": false,
2658
+ "value_required": true,
2659
+ "value_optional": false,
2660
+ "variadic": false,
2661
+ "negated": false,
2662
+ "hidden": false
2663
+ },
2167
2664
  {
2168
2665
  "flags": "-h, --help",
2169
2666
  "long": "--help",
@@ -2202,6 +2699,18 @@
2202
2699
  }
2203
2700
  ],
2204
2701
  "options": [
2702
+ {
2703
+ "flags": "-e, --env <environment>",
2704
+ "long": "--env",
2705
+ "short": "-e",
2706
+ "description": "Resolve an explicit environment (production/staging/dev)",
2707
+ "required": false,
2708
+ "value_required": true,
2709
+ "value_optional": false,
2710
+ "variadic": false,
2711
+ "negated": false,
2712
+ "hidden": false
2713
+ },
2205
2714
  {
2206
2715
  "flags": "-y, --yes",
2207
2716
  "long": "--yes",
@@ -540,6 +540,9 @@ async function deploy(projectName, sourcePath, options = {}) {
540
540
  console.log(chalk_1.default.gray(`Archived ${archive.pointer()} total bytes`));
541
541
  try {
542
542
  const form = (0, source_provenance_1.buildDeployForm)(archivePath, sourceMetadata);
543
+ if (options.paused) {
544
+ form.append('paused', '1');
545
+ }
543
546
  console.log(chalk_1.default.yellow('Uploading...'));
544
547
  if (process.env.SOLIDACTIONS_DEPLOY_DEBUG === '1') {
545
548
  process.stderr.write(`[deploy-debug] POST ${config.host}/api/v1/projects/${projectSlug}/deploy (workspace=${config.workspaceId ?? '(none)'})\n`);
@@ -611,6 +614,16 @@ async function deploy(projectName, sourcePath, options = {}) {
611
614
  console.log(chalk_1.default.blue(`ℹ Webhook secret: run \`solidactions webhook secret ${projectName}${envFlag}\` to retrieve the generated secret.`));
612
615
  console.log(chalk_1.default.gray(` Set the same value in your sender (e.g. Telegram setWebhook secret_token).`));
613
616
  }
617
+ if (options.paused) {
618
+ console.log('');
619
+ if (acceptedDeployment.schedulesPaused === true) {
620
+ console.log(chalk_1.default.green('Schedules deployed paused.'));
621
+ console.log(chalk_1.default.gray(`Enable one when ready with: solidactions schedule enable ${projectSlug} <schedule-id>`));
622
+ }
623
+ else {
624
+ console.log(chalk_1.default.yellow('Warning: server did not acknowledge paused schedules; verify schedules before relying on them being paused.'));
625
+ }
626
+ }
614
627
  cleanupArchive();
615
628
  process.exit(0);
616
629
  }