@solidactions/cli 3.2.0 → 3.4.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.
@@ -0,0 +1,4546 @@
1
+ {
2
+ "schema_version": 1,
3
+ "cli_name": "solidactions",
4
+ "cli_version": "3.4.0",
5
+ "global_options": [
6
+ {
7
+ "flags": "-V, --version",
8
+ "long": "--version",
9
+ "short": "-V",
10
+ "description": "output the version number",
11
+ "required": false,
12
+ "value_required": false,
13
+ "value_optional": false,
14
+ "variadic": false,
15
+ "negated": false,
16
+ "hidden": false
17
+ },
18
+ {
19
+ "flags": "-w, --workspace-override <id-or-slug-or-name>",
20
+ "long": "--workspace-override",
21
+ "short": "-w",
22
+ "description": "Override active workspace for this command (short form: -w)",
23
+ "required": false,
24
+ "value_required": true,
25
+ "value_optional": false,
26
+ "variadic": false,
27
+ "negated": false,
28
+ "hidden": false
29
+ },
30
+ {
31
+ "flags": "-h, --help",
32
+ "long": "--help",
33
+ "short": "-h",
34
+ "description": "display help for command",
35
+ "required": false,
36
+ "value_required": false,
37
+ "value_optional": false,
38
+ "variadic": false,
39
+ "negated": false,
40
+ "hidden": false
41
+ }
42
+ ],
43
+ "commands": [
44
+ {
45
+ "path": [
46
+ "login"
47
+ ],
48
+ "name": "login",
49
+ "aliases": [],
50
+ "description": "Authenticate the CLI (prompts securely for your API key, or via --device for browser-based login)",
51
+ "hidden": false,
52
+ "arguments": [
53
+ {
54
+ "name": "api-key",
55
+ "required": false,
56
+ "variadic": false,
57
+ "description": "Legacy positional API key (prefer the masked prompt, --stdin, or --device)"
58
+ }
59
+ ],
60
+ "options": [
61
+ {
62
+ "flags": "--stdin",
63
+ "long": "--stdin",
64
+ "short": null,
65
+ "description": "Read the API key from stdin (for non-interactive automation)",
66
+ "required": false,
67
+ "value_required": false,
68
+ "value_optional": false,
69
+ "variadic": false,
70
+ "negated": false,
71
+ "hidden": false
72
+ },
73
+ {
74
+ "flags": "--device",
75
+ "long": "--device",
76
+ "short": null,
77
+ "description": "Authenticate via browser using OAuth device authorization",
78
+ "required": false,
79
+ "value_required": false,
80
+ "value_optional": false,
81
+ "variadic": false,
82
+ "negated": false,
83
+ "hidden": false
84
+ },
85
+ {
86
+ "flags": "--dev",
87
+ "long": "--dev",
88
+ "short": null,
89
+ "description": "Use local development server (http://localhost:8000)",
90
+ "required": false,
91
+ "value_required": false,
92
+ "value_optional": false,
93
+ "variadic": false,
94
+ "negated": false,
95
+ "hidden": true
96
+ },
97
+ {
98
+ "flags": "--host <url>",
99
+ "long": "--host",
100
+ "short": null,
101
+ "description": "Custom API host URL",
102
+ "required": false,
103
+ "value_required": true,
104
+ "value_optional": false,
105
+ "variadic": false,
106
+ "negated": false,
107
+ "hidden": true
108
+ },
109
+ {
110
+ "flags": "--workspace <name-or-id>",
111
+ "long": "--workspace",
112
+ "short": null,
113
+ "description": "Set workspace by name, slug, or ID. A sole workspace is auto-selected; use --workspace to choose among multiple workspaces.",
114
+ "required": false,
115
+ "value_required": true,
116
+ "value_optional": false,
117
+ "variadic": false,
118
+ "negated": false,
119
+ "hidden": false
120
+ },
121
+ {
122
+ "flags": "--local",
123
+ "long": "--local",
124
+ "short": null,
125
+ "description": "Save config to ./.solidactions/config.json in the current folder",
126
+ "required": false,
127
+ "value_required": false,
128
+ "value_optional": false,
129
+ "variadic": false,
130
+ "negated": false,
131
+ "hidden": false
132
+ },
133
+ {
134
+ "flags": "--global",
135
+ "long": "--global",
136
+ "short": null,
137
+ "description": "Save config to ~/.solidactions/config.json (default if prompted)",
138
+ "required": false,
139
+ "value_required": false,
140
+ "value_optional": false,
141
+ "variadic": false,
142
+ "negated": false,
143
+ "hidden": false
144
+ },
145
+ {
146
+ "flags": "--gitignore",
147
+ "long": "--gitignore",
148
+ "short": null,
149
+ "description": "With --local, add .solidactions/ to .gitignore without prompting",
150
+ "required": false,
151
+ "value_required": false,
152
+ "value_optional": false,
153
+ "variadic": false,
154
+ "negated": false,
155
+ "hidden": false
156
+ },
157
+ {
158
+ "flags": "-h, --help",
159
+ "long": "--help",
160
+ "short": "-h",
161
+ "description": "display help for command",
162
+ "required": false,
163
+ "value_required": false,
164
+ "value_optional": false,
165
+ "variadic": false,
166
+ "negated": false,
167
+ "hidden": false
168
+ }
169
+ ]
170
+ },
171
+ {
172
+ "path": [
173
+ "init"
174
+ ],
175
+ "name": "init",
176
+ "aliases": [],
177
+ "description": "Scaffold a new SolidActions project (files + AI skills)",
178
+ "hidden": false,
179
+ "arguments": [
180
+ {
181
+ "name": "directory",
182
+ "required": false,
183
+ "variadic": false,
184
+ "description": "Directory to create (omit to scaffold in the current empty directory)"
185
+ }
186
+ ],
187
+ "options": [
188
+ {
189
+ "flags": "--no-skills",
190
+ "long": "--no-skills",
191
+ "short": null,
192
+ "description": "Skip AI skills/SDK reference install (scaffold files only)",
193
+ "required": false,
194
+ "value_required": false,
195
+ "value_optional": false,
196
+ "variadic": false,
197
+ "negated": true,
198
+ "hidden": false,
199
+ "default": true
200
+ },
201
+ {
202
+ "flags": "--claude",
203
+ "long": "--claude",
204
+ "short": null,
205
+ "description": "Use CLAUDE.md for the AI helper file",
206
+ "required": false,
207
+ "value_required": false,
208
+ "value_optional": false,
209
+ "variadic": false,
210
+ "negated": false,
211
+ "hidden": false
212
+ },
213
+ {
214
+ "flags": "--agents",
215
+ "long": "--agents",
216
+ "short": null,
217
+ "description": "Use AGENTS.md for the AI helper file (Codex, Cursor, Gemini, Windsurf)",
218
+ "required": false,
219
+ "value_required": false,
220
+ "value_optional": false,
221
+ "variadic": false,
222
+ "negated": false,
223
+ "hidden": false
224
+ },
225
+ {
226
+ "flags": "-h, --help",
227
+ "long": "--help",
228
+ "short": "-h",
229
+ "description": "display help for command",
230
+ "required": false,
231
+ "value_required": false,
232
+ "value_optional": false,
233
+ "variadic": false,
234
+ "negated": false,
235
+ "hidden": false
236
+ }
237
+ ]
238
+ },
239
+ {
240
+ "path": [
241
+ "logout"
242
+ ],
243
+ "name": "logout",
244
+ "aliases": [],
245
+ "description": "Remove saved credentials",
246
+ "hidden": false,
247
+ "arguments": [],
248
+ "options": [
249
+ {
250
+ "flags": "--local",
251
+ "long": "--local",
252
+ "short": null,
253
+ "description": "Remove only the nearest local ./.solidactions/config.json",
254
+ "required": false,
255
+ "value_required": false,
256
+ "value_optional": false,
257
+ "variadic": false,
258
+ "negated": false,
259
+ "hidden": false
260
+ },
261
+ {
262
+ "flags": "--global",
263
+ "long": "--global",
264
+ "short": null,
265
+ "description": "Remove only ~/.solidactions/config.json",
266
+ "required": false,
267
+ "value_required": false,
268
+ "value_optional": false,
269
+ "variadic": false,
270
+ "negated": false,
271
+ "hidden": false
272
+ },
273
+ {
274
+ "flags": "-h, --help",
275
+ "long": "--help",
276
+ "short": "-h",
277
+ "description": "display help for command",
278
+ "required": false,
279
+ "value_required": false,
280
+ "value_optional": false,
281
+ "variadic": false,
282
+ "negated": false,
283
+ "hidden": false
284
+ }
285
+ ]
286
+ },
287
+ {
288
+ "path": [
289
+ "whoami"
290
+ ],
291
+ "name": "whoami",
292
+ "aliases": [],
293
+ "description": "Show current configuration",
294
+ "hidden": false,
295
+ "arguments": [],
296
+ "options": [
297
+ {
298
+ "flags": "-h, --help",
299
+ "long": "--help",
300
+ "short": "-h",
301
+ "description": "display help for command",
302
+ "required": false,
303
+ "value_required": false,
304
+ "value_optional": false,
305
+ "variadic": false,
306
+ "negated": false,
307
+ "hidden": false
308
+ }
309
+ ]
310
+ },
311
+ {
312
+ "path": [
313
+ "dev"
314
+ ],
315
+ "name": "dev",
316
+ "aliases": [],
317
+ "description": "Run a workflow locally using an in-memory mock server (no deploy needed)",
318
+ "hidden": false,
319
+ "arguments": [
320
+ {
321
+ "name": "file",
322
+ "required": true,
323
+ "variadic": false,
324
+ "description": "Workflow file to run (e.g., src/simple-steps.ts)"
325
+ }
326
+ ],
327
+ "options": [
328
+ {
329
+ "flags": "-i, --input <json>",
330
+ "long": "--input",
331
+ "short": "-i",
332
+ "description": "JSON input for the workflow",
333
+ "required": false,
334
+ "value_required": true,
335
+ "value_optional": false,
336
+ "variadic": false,
337
+ "negated": false,
338
+ "hidden": false,
339
+ "default": "{}"
340
+ },
341
+ {
342
+ "flags": "-e, --env <env>",
343
+ "long": "--env",
344
+ "short": "-e",
345
+ "description": "Pull platform variables for this environment (e.g. production, staging, dev)",
346
+ "required": false,
347
+ "value_required": true,
348
+ "value_optional": false,
349
+ "variadic": false,
350
+ "negated": false,
351
+ "hidden": false
352
+ },
353
+ {
354
+ "flags": "-h, --help",
355
+ "long": "--help",
356
+ "short": "-h",
357
+ "description": "display help for command",
358
+ "required": false,
359
+ "value_required": false,
360
+ "value_optional": false,
361
+ "variadic": false,
362
+ "negated": false,
363
+ "hidden": false
364
+ }
365
+ ]
366
+ },
367
+ {
368
+ "path": [
369
+ "project"
370
+ ],
371
+ "name": "project",
372
+ "aliases": [],
373
+ "description": "Manage projects",
374
+ "hidden": false,
375
+ "arguments": [],
376
+ "options": [
377
+ {
378
+ "flags": "-h, --help",
379
+ "long": "--help",
380
+ "short": "-h",
381
+ "description": "display help for command",
382
+ "required": false,
383
+ "value_required": false,
384
+ "value_optional": false,
385
+ "variadic": false,
386
+ "negated": false,
387
+ "hidden": false
388
+ }
389
+ ]
390
+ },
391
+ {
392
+ "path": [
393
+ "project",
394
+ "view"
395
+ ],
396
+ "name": "view",
397
+ "aliases": [],
398
+ "description": "View project status and the client-reported deployed revision",
399
+ "hidden": false,
400
+ "arguments": [
401
+ {
402
+ "name": "project",
403
+ "required": true,
404
+ "variadic": false,
405
+ "description": "Exact project slug (or project family/name when --env is explicit)"
406
+ }
407
+ ],
408
+ "options": [
409
+ {
410
+ "flags": "-e, --env <environment>",
411
+ "long": "--env",
412
+ "short": "-e",
413
+ "description": "Resolve an explicit environment (production/staging/dev)",
414
+ "required": false,
415
+ "value_required": true,
416
+ "value_optional": false,
417
+ "variadic": false,
418
+ "negated": false,
419
+ "hidden": false
420
+ },
421
+ {
422
+ "flags": "-h, --help",
423
+ "long": "--help",
424
+ "short": "-h",
425
+ "description": "display help for command",
426
+ "required": false,
427
+ "value_required": false,
428
+ "value_optional": false,
429
+ "variadic": false,
430
+ "negated": false,
431
+ "hidden": false
432
+ }
433
+ ]
434
+ },
435
+ {
436
+ "path": [
437
+ "project",
438
+ "create"
439
+ ],
440
+ "name": "create",
441
+ "aliases": [],
442
+ "description": "Create an empty project (and environment) without deploying source",
443
+ "hidden": false,
444
+ "arguments": [
445
+ {
446
+ "name": "name",
447
+ "required": true,
448
+ "variadic": false,
449
+ "description": "Project name"
450
+ }
451
+ ],
452
+ "options": [
453
+ {
454
+ "flags": "-e, --env <environment>",
455
+ "long": "--env",
456
+ "short": "-e",
457
+ "description": "Target environment (production/staging/dev). Defaults to production.",
458
+ "required": false,
459
+ "value_required": true,
460
+ "value_optional": false,
461
+ "variadic": false,
462
+ "negated": false,
463
+ "hidden": false
464
+ },
465
+ {
466
+ "flags": "-h, --help",
467
+ "long": "--help",
468
+ "short": "-h",
469
+ "description": "display help for command",
470
+ "required": false,
471
+ "value_required": false,
472
+ "value_optional": false,
473
+ "variadic": false,
474
+ "negated": false,
475
+ "hidden": false
476
+ }
477
+ ]
478
+ },
479
+ {
480
+ "path": [
481
+ "project",
482
+ "deploy"
483
+ ],
484
+ "name": "deploy",
485
+ "aliases": [],
486
+ "description": "Deploy a project to SolidActions",
487
+ "hidden": false,
488
+ "arguments": [
489
+ {
490
+ "name": "project-name",
491
+ "required": true,
492
+ "variadic": false,
493
+ "description": "Project name (will be created if it doesn't exist)"
494
+ },
495
+ {
496
+ "name": "path",
497
+ "required": false,
498
+ "variadic": false,
499
+ "description": "Source directory to deploy (defaults to current directory)"
500
+ }
501
+ ],
502
+ "options": [
503
+ {
504
+ "flags": "-e, --env <environment>",
505
+ "long": "--env",
506
+ "short": "-e",
507
+ "description": "Target environment (production/staging/dev). Required on first deploy of a new project.",
508
+ "required": false,
509
+ "value_required": true,
510
+ "value_optional": false,
511
+ "variadic": false,
512
+ "negated": false,
513
+ "hidden": false
514
+ },
515
+ {
516
+ "flags": "--create",
517
+ "long": "--create",
518
+ "short": null,
519
+ "description": "Create environment project if it doesn't exist",
520
+ "required": false,
521
+ "value_required": false,
522
+ "value_optional": false,
523
+ "variadic": false,
524
+ "negated": false,
525
+ "hidden": false
526
+ },
527
+ {
528
+ "flags": "--config-only",
529
+ "long": "--config-only",
530
+ "short": null,
531
+ "description": "Sync YAML env declarations without building/deploying",
532
+ "required": false,
533
+ "value_required": false,
534
+ "value_optional": false,
535
+ "variadic": false,
536
+ "negated": false,
537
+ "hidden": false
538
+ },
539
+ {
540
+ "flags": "--paused",
541
+ "long": "--paused",
542
+ "short": null,
543
+ "description": "Deploy with all YAML-declared schedules initially paused",
544
+ "required": false,
545
+ "value_required": false,
546
+ "value_optional": false,
547
+ "variadic": false,
548
+ "negated": false,
549
+ "hidden": false
550
+ },
551
+ {
552
+ "flags": "--no-cache",
553
+ "long": "--no-cache",
554
+ "short": null,
555
+ "description": "Force a fresh build, bypassing all build caches",
556
+ "required": false,
557
+ "value_required": false,
558
+ "value_optional": false,
559
+ "variadic": false,
560
+ "negated": true,
561
+ "hidden": false,
562
+ "default": true
563
+ },
564
+ {
565
+ "flags": "--force-rebuild",
566
+ "long": "--force-rebuild",
567
+ "short": null,
568
+ "description": "Force a fresh build, bypassing all build caches (alias for --no-cache)",
569
+ "required": false,
570
+ "value_required": false,
571
+ "value_optional": false,
572
+ "variadic": false,
573
+ "negated": false,
574
+ "hidden": false
575
+ },
576
+ {
577
+ "flags": "--no-git-metadata",
578
+ "long": "--no-git-metadata",
579
+ "short": null,
580
+ "description": "Do not transmit Git provenance (branch, commit subject, and sanitized remote repository URL; credentials are stripped); also available as SOLIDACTIONS_NO_GIT_METADATA=1",
581
+ "required": false,
582
+ "value_required": false,
583
+ "value_optional": false,
584
+ "variadic": false,
585
+ "negated": true,
586
+ "hidden": false,
587
+ "default": true
588
+ },
589
+ {
590
+ "flags": "-h, --help",
591
+ "long": "--help",
592
+ "short": "-h",
593
+ "description": "display help for command",
594
+ "required": false,
595
+ "value_required": false,
596
+ "value_optional": false,
597
+ "variadic": false,
598
+ "negated": false,
599
+ "hidden": false
600
+ }
601
+ ]
602
+ },
603
+ {
604
+ "path": [
605
+ "project",
606
+ "pull"
607
+ ],
608
+ "name": "pull",
609
+ "aliases": [],
610
+ "description": "Pull project source from SolidActions",
611
+ "hidden": false,
612
+ "arguments": [
613
+ {
614
+ "name": "project-name",
615
+ "required": true,
616
+ "variadic": false,
617
+ "description": "Project name"
618
+ },
619
+ {
620
+ "name": "path",
621
+ "required": false,
622
+ "variadic": false,
623
+ "description": "Destination directory (defaults to current directory)"
624
+ }
625
+ ],
626
+ "options": [
627
+ {
628
+ "flags": "-y, --yes",
629
+ "long": "--yes",
630
+ "short": "-y",
631
+ "description": "Skip overwrite confirmation",
632
+ "required": false,
633
+ "value_required": false,
634
+ "value_optional": false,
635
+ "variadic": false,
636
+ "negated": false,
637
+ "hidden": false
638
+ },
639
+ {
640
+ "flags": "-h, --help",
641
+ "long": "--help",
642
+ "short": "-h",
643
+ "description": "display help for command",
644
+ "required": false,
645
+ "value_required": false,
646
+ "value_optional": false,
647
+ "variadic": false,
648
+ "negated": false,
649
+ "hidden": false
650
+ }
651
+ ]
652
+ },
653
+ {
654
+ "path": [
655
+ "project",
656
+ "logs"
657
+ ],
658
+ "name": "logs",
659
+ "aliases": [],
660
+ "description": "View build/deployment logs for a project",
661
+ "hidden": false,
662
+ "arguments": [
663
+ {
664
+ "name": "project",
665
+ "required": true,
666
+ "variadic": false,
667
+ "description": "Project name (or family name with -e)"
668
+ }
669
+ ],
670
+ "options": [
671
+ {
672
+ "flags": "-e, --env <environment>",
673
+ "long": "--env",
674
+ "short": "-e",
675
+ "description": "Environment to resolve (production/staging/dev)",
676
+ "required": false,
677
+ "value_required": true,
678
+ "value_optional": false,
679
+ "variadic": false,
680
+ "negated": false,
681
+ "hidden": false
682
+ },
683
+ {
684
+ "flags": "--environment <environment>",
685
+ "long": "--environment",
686
+ "short": null,
687
+ "description": "Alias of --env",
688
+ "required": false,
689
+ "value_required": true,
690
+ "value_optional": false,
691
+ "variadic": false,
692
+ "negated": false,
693
+ "hidden": true
694
+ },
695
+ {
696
+ "flags": "-h, --help",
697
+ "long": "--help",
698
+ "short": "-h",
699
+ "description": "display help for command",
700
+ "required": false,
701
+ "value_required": false,
702
+ "value_optional": false,
703
+ "variadic": false,
704
+ "negated": false,
705
+ "hidden": false
706
+ }
707
+ ]
708
+ },
709
+ {
710
+ "path": [
711
+ "project",
712
+ "list"
713
+ ],
714
+ "name": "list",
715
+ "aliases": [],
716
+ "description": "List all projects",
717
+ "hidden": false,
718
+ "arguments": [],
719
+ "options": [
720
+ {
721
+ "flags": "--json",
722
+ "long": "--json",
723
+ "short": null,
724
+ "description": "Output as JSON",
725
+ "required": false,
726
+ "value_required": false,
727
+ "value_optional": false,
728
+ "variadic": false,
729
+ "negated": false,
730
+ "hidden": false
731
+ },
732
+ {
733
+ "flags": "-h, --help",
734
+ "long": "--help",
735
+ "short": "-h",
736
+ "description": "display help for command",
737
+ "required": false,
738
+ "value_required": false,
739
+ "value_optional": false,
740
+ "variadic": false,
741
+ "negated": false,
742
+ "hidden": false
743
+ }
744
+ ]
745
+ },
746
+ {
747
+ "path": [
748
+ "project",
749
+ "enable"
750
+ ],
751
+ "name": "enable",
752
+ "aliases": [],
753
+ "description": "Allow new workflow starts for a project environment",
754
+ "hidden": false,
755
+ "arguments": [
756
+ {
757
+ "name": "project",
758
+ "required": true,
759
+ "variadic": false,
760
+ "description": "Project name"
761
+ }
762
+ ],
763
+ "options": [
764
+ {
765
+ "flags": "-e, --env <environment>",
766
+ "long": "--env",
767
+ "short": "-e",
768
+ "description": "Environment (production/staging/dev). Defaults to dev.",
769
+ "required": false,
770
+ "value_required": true,
771
+ "value_optional": false,
772
+ "variadic": false,
773
+ "negated": false,
774
+ "hidden": false,
775
+ "default": "dev"
776
+ },
777
+ {
778
+ "flags": "-h, --help",
779
+ "long": "--help",
780
+ "short": "-h",
781
+ "description": "display help for command",
782
+ "required": false,
783
+ "value_required": false,
784
+ "value_optional": false,
785
+ "variadic": false,
786
+ "negated": false,
787
+ "hidden": false
788
+ }
789
+ ]
790
+ },
791
+ {
792
+ "path": [
793
+ "project",
794
+ "disable"
795
+ ],
796
+ "name": "disable",
797
+ "aliases": [],
798
+ "description": "Block new workflow starts for a project environment",
799
+ "hidden": false,
800
+ "arguments": [
801
+ {
802
+ "name": "project",
803
+ "required": true,
804
+ "variadic": false,
805
+ "description": "Project name"
806
+ }
807
+ ],
808
+ "options": [
809
+ {
810
+ "flags": "-e, --env <environment>",
811
+ "long": "--env",
812
+ "short": "-e",
813
+ "description": "Environment (production/staging/dev). Defaults to dev.",
814
+ "required": false,
815
+ "value_required": true,
816
+ "value_optional": false,
817
+ "variadic": false,
818
+ "negated": false,
819
+ "hidden": false,
820
+ "default": "dev"
821
+ },
822
+ {
823
+ "flags": "-h, --help",
824
+ "long": "--help",
825
+ "short": "-h",
826
+ "description": "display help for command",
827
+ "required": false,
828
+ "value_required": false,
829
+ "value_optional": false,
830
+ "variadic": false,
831
+ "negated": false,
832
+ "hidden": false
833
+ }
834
+ ]
835
+ },
836
+ {
837
+ "path": [
838
+ "project",
839
+ "help"
840
+ ],
841
+ "name": "help",
842
+ "aliases": [],
843
+ "description": "display help for command",
844
+ "hidden": false,
845
+ "arguments": [
846
+ {
847
+ "name": "command",
848
+ "required": false,
849
+ "variadic": false,
850
+ "description": ""
851
+ }
852
+ ],
853
+ "options": []
854
+ },
855
+ {
856
+ "path": [
857
+ "workflow"
858
+ ],
859
+ "name": "workflow",
860
+ "aliases": [],
861
+ "description": "Manage deployed workflows",
862
+ "hidden": false,
863
+ "arguments": [],
864
+ "options": [
865
+ {
866
+ "flags": "-h, --help",
867
+ "long": "--help",
868
+ "short": "-h",
869
+ "description": "display help for command",
870
+ "required": false,
871
+ "value_required": false,
872
+ "value_optional": false,
873
+ "variadic": false,
874
+ "negated": false,
875
+ "hidden": false
876
+ }
877
+ ]
878
+ },
879
+ {
880
+ "path": [
881
+ "workflow",
882
+ "enable"
883
+ ],
884
+ "name": "enable",
885
+ "aliases": [],
886
+ "description": "Allow new starts for a deployed workflow",
887
+ "hidden": false,
888
+ "arguments": [
889
+ {
890
+ "name": "project",
891
+ "required": true,
892
+ "variadic": false,
893
+ "description": "Project name"
894
+ },
895
+ {
896
+ "name": "workflow",
897
+ "required": true,
898
+ "variadic": false,
899
+ "description": "Workflow name or slug"
900
+ }
901
+ ],
902
+ "options": [
903
+ {
904
+ "flags": "-e, --env <environment>",
905
+ "long": "--env",
906
+ "short": "-e",
907
+ "description": "Environment (production/staging/dev). Defaults to dev.",
908
+ "required": false,
909
+ "value_required": true,
910
+ "value_optional": false,
911
+ "variadic": false,
912
+ "negated": false,
913
+ "hidden": false,
914
+ "default": "dev"
915
+ },
916
+ {
917
+ "flags": "-h, --help",
918
+ "long": "--help",
919
+ "short": "-h",
920
+ "description": "display help for command",
921
+ "required": false,
922
+ "value_required": false,
923
+ "value_optional": false,
924
+ "variadic": false,
925
+ "negated": false,
926
+ "hidden": false
927
+ }
928
+ ]
929
+ },
930
+ {
931
+ "path": [
932
+ "workflow",
933
+ "disable"
934
+ ],
935
+ "name": "disable",
936
+ "aliases": [],
937
+ "description": "Block new starts for a deployed workflow",
938
+ "hidden": false,
939
+ "arguments": [
940
+ {
941
+ "name": "project",
942
+ "required": true,
943
+ "variadic": false,
944
+ "description": "Project name"
945
+ },
946
+ {
947
+ "name": "workflow",
948
+ "required": true,
949
+ "variadic": false,
950
+ "description": "Workflow name or slug"
951
+ }
952
+ ],
953
+ "options": [
954
+ {
955
+ "flags": "-e, --env <environment>",
956
+ "long": "--env",
957
+ "short": "-e",
958
+ "description": "Environment (production/staging/dev). Defaults to dev.",
959
+ "required": false,
960
+ "value_required": true,
961
+ "value_optional": false,
962
+ "variadic": false,
963
+ "negated": false,
964
+ "hidden": false,
965
+ "default": "dev"
966
+ },
967
+ {
968
+ "flags": "-h, --help",
969
+ "long": "--help",
970
+ "short": "-h",
971
+ "description": "display help for command",
972
+ "required": false,
973
+ "value_required": false,
974
+ "value_optional": false,
975
+ "variadic": false,
976
+ "negated": false,
977
+ "hidden": false
978
+ }
979
+ ]
980
+ },
981
+ {
982
+ "path": [
983
+ "workflow",
984
+ "help"
985
+ ],
986
+ "name": "help",
987
+ "aliases": [],
988
+ "description": "display help for command",
989
+ "hidden": false,
990
+ "arguments": [
991
+ {
992
+ "name": "command",
993
+ "required": false,
994
+ "variadic": false,
995
+ "description": ""
996
+ }
997
+ ],
998
+ "options": []
999
+ },
1000
+ {
1001
+ "path": [
1002
+ "run"
1003
+ ],
1004
+ "name": "run",
1005
+ "aliases": [],
1006
+ "description": "Manage workflow runs",
1007
+ "hidden": false,
1008
+ "arguments": [],
1009
+ "options": [
1010
+ {
1011
+ "flags": "-h, --help",
1012
+ "long": "--help",
1013
+ "short": "-h",
1014
+ "description": "display help for command",
1015
+ "required": false,
1016
+ "value_required": false,
1017
+ "value_optional": false,
1018
+ "variadic": false,
1019
+ "negated": false,
1020
+ "hidden": false
1021
+ }
1022
+ ]
1023
+ },
1024
+ {
1025
+ "path": [
1026
+ "run",
1027
+ "start"
1028
+ ],
1029
+ "name": "start",
1030
+ "aliases": [],
1031
+ "description": "Trigger a workflow run",
1032
+ "hidden": false,
1033
+ "arguments": [
1034
+ {
1035
+ "name": "project",
1036
+ "required": true,
1037
+ "variadic": false,
1038
+ "description": "Project name"
1039
+ },
1040
+ {
1041
+ "name": "workflow",
1042
+ "required": true,
1043
+ "variadic": false,
1044
+ "description": "Workflow name"
1045
+ }
1046
+ ],
1047
+ "options": [
1048
+ {
1049
+ "flags": "-e, --env <environment>",
1050
+ "long": "--env",
1051
+ "short": "-e",
1052
+ "description": "Environment (production/staging/dev)",
1053
+ "required": false,
1054
+ "value_required": true,
1055
+ "value_optional": false,
1056
+ "variadic": false,
1057
+ "negated": false,
1058
+ "hidden": false,
1059
+ "default": "dev"
1060
+ },
1061
+ {
1062
+ "flags": "-i, --input <json>",
1063
+ "long": "--input",
1064
+ "short": "-i",
1065
+ "description": "JSON input for the workflow",
1066
+ "required": false,
1067
+ "value_required": true,
1068
+ "value_optional": false,
1069
+ "variadic": false,
1070
+ "negated": false,
1071
+ "hidden": false
1072
+ },
1073
+ {
1074
+ "flags": "--wait",
1075
+ "long": "--wait",
1076
+ "short": null,
1077
+ "description": "Wait for the workflow to complete",
1078
+ "required": false,
1079
+ "value_required": false,
1080
+ "value_optional": false,
1081
+ "variadic": false,
1082
+ "negated": false,
1083
+ "hidden": false
1084
+ },
1085
+ {
1086
+ "flags": "-h, --help",
1087
+ "long": "--help",
1088
+ "short": "-h",
1089
+ "description": "display help for command",
1090
+ "required": false,
1091
+ "value_required": false,
1092
+ "value_optional": false,
1093
+ "variadic": false,
1094
+ "negated": false,
1095
+ "hidden": false
1096
+ }
1097
+ ]
1098
+ },
1099
+ {
1100
+ "path": [
1101
+ "run",
1102
+ "list"
1103
+ ],
1104
+ "name": "list",
1105
+ "aliases": [],
1106
+ "description": "List recent workflow runs",
1107
+ "hidden": false,
1108
+ "arguments": [
1109
+ {
1110
+ "name": "project",
1111
+ "required": false,
1112
+ "variadic": false,
1113
+ "description": "Filter by project name"
1114
+ }
1115
+ ],
1116
+ "options": [
1117
+ {
1118
+ "flags": "-l, --limit <number>",
1119
+ "long": "--limit",
1120
+ "short": "-l",
1121
+ "description": "Number of runs to show",
1122
+ "required": false,
1123
+ "value_required": true,
1124
+ "value_optional": false,
1125
+ "variadic": false,
1126
+ "negated": false,
1127
+ "hidden": false
1128
+ },
1129
+ {
1130
+ "flags": "--offset <number>",
1131
+ "long": "--offset",
1132
+ "short": null,
1133
+ "description": "Skip first N runs (pagination)",
1134
+ "required": false,
1135
+ "value_required": true,
1136
+ "value_optional": false,
1137
+ "variadic": false,
1138
+ "negated": false,
1139
+ "hidden": false
1140
+ },
1141
+ {
1142
+ "flags": "--status <status>",
1143
+ "long": "--status",
1144
+ "short": null,
1145
+ "description": "Filter by status (completed, failed, queued, running)",
1146
+ "required": false,
1147
+ "value_required": true,
1148
+ "value_optional": false,
1149
+ "variadic": false,
1150
+ "negated": false,
1151
+ "hidden": false
1152
+ },
1153
+ {
1154
+ "flags": "--since <duration>",
1155
+ "long": "--since",
1156
+ "short": null,
1157
+ "description": "Filter to runs since (e.g., 1h, 30m, 2d, 1w)",
1158
+ "required": false,
1159
+ "value_required": true,
1160
+ "value_optional": false,
1161
+ "variadic": false,
1162
+ "negated": false,
1163
+ "hidden": false
1164
+ },
1165
+ {
1166
+ "flags": "--workflow <name>",
1167
+ "long": "--workflow",
1168
+ "short": null,
1169
+ "description": "Filter by workflow name",
1170
+ "required": false,
1171
+ "value_required": true,
1172
+ "value_optional": false,
1173
+ "variadic": false,
1174
+ "negated": false,
1175
+ "hidden": false
1176
+ },
1177
+ {
1178
+ "flags": "--detailed",
1179
+ "long": "--detailed",
1180
+ "short": null,
1181
+ "description": "Include timeline, steps, and logs per run (default limit: 5)",
1182
+ "required": false,
1183
+ "value_required": false,
1184
+ "value_optional": false,
1185
+ "variadic": false,
1186
+ "negated": false,
1187
+ "hidden": false
1188
+ },
1189
+ {
1190
+ "flags": "--has-errors",
1191
+ "long": "--has-errors",
1192
+ "short": null,
1193
+ "description": "Show only runs with errors (step errors, retries, or degraded results)",
1194
+ "required": false,
1195
+ "value_required": false,
1196
+ "value_optional": false,
1197
+ "variadic": false,
1198
+ "negated": false,
1199
+ "hidden": false
1200
+ },
1201
+ {
1202
+ "flags": "--json",
1203
+ "long": "--json",
1204
+ "short": null,
1205
+ "description": "Output as JSON",
1206
+ "required": false,
1207
+ "value_required": false,
1208
+ "value_optional": false,
1209
+ "variadic": false,
1210
+ "negated": false,
1211
+ "hidden": false
1212
+ },
1213
+ {
1214
+ "flags": "-e, --env <environment>",
1215
+ "long": "--env",
1216
+ "short": "-e",
1217
+ "description": "Environment to filter by (production/staging/dev)",
1218
+ "required": false,
1219
+ "value_required": true,
1220
+ "value_optional": false,
1221
+ "variadic": false,
1222
+ "negated": false,
1223
+ "hidden": false
1224
+ },
1225
+ {
1226
+ "flags": "--environment <environment>",
1227
+ "long": "--environment",
1228
+ "short": null,
1229
+ "description": "Alias of --env",
1230
+ "required": false,
1231
+ "value_required": true,
1232
+ "value_optional": false,
1233
+ "variadic": false,
1234
+ "negated": false,
1235
+ "hidden": true
1236
+ },
1237
+ {
1238
+ "flags": "-h, --help",
1239
+ "long": "--help",
1240
+ "short": "-h",
1241
+ "description": "display help for command",
1242
+ "required": false,
1243
+ "value_required": false,
1244
+ "value_optional": false,
1245
+ "variadic": false,
1246
+ "negated": false,
1247
+ "hidden": false
1248
+ }
1249
+ ]
1250
+ },
1251
+ {
1252
+ "path": [
1253
+ "run",
1254
+ "view"
1255
+ ],
1256
+ "name": "view",
1257
+ "aliases": [],
1258
+ "description": "View details, timeline, steps, or logs for a workflow run",
1259
+ "hidden": false,
1260
+ "arguments": [
1261
+ {
1262
+ "name": "run-id",
1263
+ "required": true,
1264
+ "variadic": false,
1265
+ "description": "Run ID"
1266
+ }
1267
+ ],
1268
+ "options": [
1269
+ {
1270
+ "flags": "--timeline",
1271
+ "long": "--timeline",
1272
+ "short": null,
1273
+ "description": "Show only timeline data",
1274
+ "required": false,
1275
+ "value_required": false,
1276
+ "value_optional": false,
1277
+ "variadic": false,
1278
+ "negated": false,
1279
+ "hidden": false
1280
+ },
1281
+ {
1282
+ "flags": "--steps",
1283
+ "long": "--steps",
1284
+ "short": null,
1285
+ "description": "Show only step data",
1286
+ "required": false,
1287
+ "value_required": false,
1288
+ "value_optional": false,
1289
+ "variadic": false,
1290
+ "negated": false,
1291
+ "hidden": false
1292
+ },
1293
+ {
1294
+ "flags": "--logs",
1295
+ "long": "--logs",
1296
+ "short": null,
1297
+ "description": "Show raw logs",
1298
+ "required": false,
1299
+ "value_required": false,
1300
+ "value_optional": false,
1301
+ "variadic": false,
1302
+ "negated": false,
1303
+ "hidden": false
1304
+ },
1305
+ {
1306
+ "flags": "--json",
1307
+ "long": "--json",
1308
+ "short": null,
1309
+ "description": "Output as JSON",
1310
+ "required": false,
1311
+ "value_required": false,
1312
+ "value_optional": false,
1313
+ "variadic": false,
1314
+ "negated": false,
1315
+ "hidden": false
1316
+ },
1317
+ {
1318
+ "flags": "-h, --help",
1319
+ "long": "--help",
1320
+ "short": "-h",
1321
+ "description": "display help for command",
1322
+ "required": false,
1323
+ "value_required": false,
1324
+ "value_optional": false,
1325
+ "variadic": false,
1326
+ "negated": false,
1327
+ "hidden": false
1328
+ }
1329
+ ]
1330
+ },
1331
+ {
1332
+ "path": [
1333
+ "run",
1334
+ "help"
1335
+ ],
1336
+ "name": "help",
1337
+ "aliases": [],
1338
+ "description": "display help for command",
1339
+ "hidden": false,
1340
+ "arguments": [
1341
+ {
1342
+ "name": "command",
1343
+ "required": false,
1344
+ "variadic": false,
1345
+ "description": ""
1346
+ }
1347
+ ],
1348
+ "options": []
1349
+ },
1350
+ {
1351
+ "path": [
1352
+ "env"
1353
+ ],
1354
+ "name": "env",
1355
+ "aliases": [],
1356
+ "description": "Manage variables",
1357
+ "hidden": false,
1358
+ "arguments": [],
1359
+ "options": [
1360
+ {
1361
+ "flags": "-h, --help",
1362
+ "long": "--help",
1363
+ "short": "-h",
1364
+ "description": "display help for command",
1365
+ "required": false,
1366
+ "value_required": false,
1367
+ "value_optional": false,
1368
+ "variadic": false,
1369
+ "negated": false,
1370
+ "hidden": false
1371
+ }
1372
+ ]
1373
+ },
1374
+ {
1375
+ "path": [
1376
+ "env",
1377
+ "set"
1378
+ ],
1379
+ "name": "set",
1380
+ "aliases": [],
1381
+ "description": "Set a variable (create or update, global or project)",
1382
+ "hidden": false,
1383
+ "arguments": [
1384
+ {
1385
+ "name": "key-or-project",
1386
+ "required": true,
1387
+ "variadic": false,
1388
+ "description": "Variable key (global) or project name"
1389
+ },
1390
+ {
1391
+ "name": "value-or-key",
1392
+ "required": true,
1393
+ "variadic": false,
1394
+ "description": "Variable value (global) or variable key (project)"
1395
+ },
1396
+ {
1397
+ "name": "value",
1398
+ "required": false,
1399
+ "variadic": false,
1400
+ "description": "Variable value (when first arg is project)"
1401
+ }
1402
+ ],
1403
+ "options": [
1404
+ {
1405
+ "flags": "-s, --secret",
1406
+ "long": "--secret",
1407
+ "short": "-s",
1408
+ "description": "Mark as encrypted secret",
1409
+ "required": false,
1410
+ "value_required": false,
1411
+ "value_optional": false,
1412
+ "variadic": false,
1413
+ "negated": false,
1414
+ "hidden": false
1415
+ },
1416
+ {
1417
+ "flags": "-e, --env <environment>",
1418
+ "long": "--env",
1419
+ "short": "-e",
1420
+ "description": "Target environment (production/staging/dev)",
1421
+ "required": false,
1422
+ "value_required": true,
1423
+ "value_optional": false,
1424
+ "variadic": false,
1425
+ "negated": false,
1426
+ "hidden": false,
1427
+ "default": "dev"
1428
+ },
1429
+ {
1430
+ "flags": "--oauth-connection <name>",
1431
+ "long": "--oauth-connection",
1432
+ "short": null,
1433
+ "description": "Bind the project key to an OAuth connection",
1434
+ "required": false,
1435
+ "value_required": true,
1436
+ "value_optional": false,
1437
+ "variadic": false,
1438
+ "negated": false,
1439
+ "hidden": false
1440
+ },
1441
+ {
1442
+ "flags": "--global",
1443
+ "long": "--global",
1444
+ "short": null,
1445
+ "description": "Set a global variable (no project) — required for the 2-arg form",
1446
+ "required": false,
1447
+ "value_required": false,
1448
+ "value_optional": false,
1449
+ "variadic": false,
1450
+ "negated": false,
1451
+ "hidden": false
1452
+ },
1453
+ {
1454
+ "flags": "--staging-value <value>",
1455
+ "long": "--staging-value",
1456
+ "short": null,
1457
+ "description": "Staging environment value (global only)",
1458
+ "required": false,
1459
+ "value_required": true,
1460
+ "value_optional": false,
1461
+ "variadic": false,
1462
+ "negated": false,
1463
+ "hidden": false
1464
+ },
1465
+ {
1466
+ "flags": "--dev-value <value>",
1467
+ "long": "--dev-value",
1468
+ "short": null,
1469
+ "description": "Dev environment value (global only)",
1470
+ "required": false,
1471
+ "value_required": true,
1472
+ "value_optional": false,
1473
+ "variadic": false,
1474
+ "negated": false,
1475
+ "hidden": false
1476
+ },
1477
+ {
1478
+ "flags": "--staging-inherit",
1479
+ "long": "--staging-inherit",
1480
+ "short": null,
1481
+ "description": "Staging inherits from production (global only)",
1482
+ "required": false,
1483
+ "value_required": false,
1484
+ "value_optional": false,
1485
+ "variadic": false,
1486
+ "negated": false,
1487
+ "hidden": false
1488
+ },
1489
+ {
1490
+ "flags": "--dev-inherit",
1491
+ "long": "--dev-inherit",
1492
+ "short": null,
1493
+ "description": "Dev inherits from production (global only)",
1494
+ "required": false,
1495
+ "value_required": false,
1496
+ "value_optional": false,
1497
+ "variadic": false,
1498
+ "negated": false,
1499
+ "hidden": false
1500
+ },
1501
+ {
1502
+ "flags": "--dev-inherit-staging",
1503
+ "long": "--dev-inherit-staging",
1504
+ "short": null,
1505
+ "description": "Dev inherits from staging (global only)",
1506
+ "required": false,
1507
+ "value_required": false,
1508
+ "value_optional": false,
1509
+ "variadic": false,
1510
+ "negated": false,
1511
+ "hidden": false
1512
+ },
1513
+ {
1514
+ "flags": "-y, --yes",
1515
+ "long": "--yes",
1516
+ "short": "-y",
1517
+ "description": "Skip overwrite confirmation",
1518
+ "required": false,
1519
+ "value_required": false,
1520
+ "value_optional": false,
1521
+ "variadic": false,
1522
+ "negated": false,
1523
+ "hidden": false
1524
+ },
1525
+ {
1526
+ "flags": "-h, --help",
1527
+ "long": "--help",
1528
+ "short": "-h",
1529
+ "description": "display help for command",
1530
+ "required": false,
1531
+ "value_required": false,
1532
+ "value_optional": false,
1533
+ "variadic": false,
1534
+ "negated": false,
1535
+ "hidden": false
1536
+ }
1537
+ ]
1538
+ },
1539
+ {
1540
+ "path": [
1541
+ "env",
1542
+ "list"
1543
+ ],
1544
+ "name": "list",
1545
+ "aliases": [],
1546
+ "description": "List variables",
1547
+ "hidden": false,
1548
+ "arguments": [
1549
+ {
1550
+ "name": "project",
1551
+ "required": false,
1552
+ "variadic": false,
1553
+ "description": "Project name (omit for global variables)"
1554
+ }
1555
+ ],
1556
+ "options": [
1557
+ {
1558
+ "flags": "-e, --env <environment>",
1559
+ "long": "--env",
1560
+ "short": "-e",
1561
+ "description": "Filter by environment (production/staging/dev)",
1562
+ "required": false,
1563
+ "value_required": true,
1564
+ "value_optional": false,
1565
+ "variadic": false,
1566
+ "negated": false,
1567
+ "hidden": false
1568
+ },
1569
+ {
1570
+ "flags": "--json",
1571
+ "long": "--json",
1572
+ "short": null,
1573
+ "description": "Output as JSON",
1574
+ "required": false,
1575
+ "value_required": false,
1576
+ "value_optional": false,
1577
+ "variadic": false,
1578
+ "negated": false,
1579
+ "hidden": false
1580
+ },
1581
+ {
1582
+ "flags": "-h, --help",
1583
+ "long": "--help",
1584
+ "short": "-h",
1585
+ "description": "display help for command",
1586
+ "required": false,
1587
+ "value_required": false,
1588
+ "value_optional": false,
1589
+ "variadic": false,
1590
+ "negated": false,
1591
+ "hidden": false
1592
+ }
1593
+ ]
1594
+ },
1595
+ {
1596
+ "path": [
1597
+ "env",
1598
+ "delete"
1599
+ ],
1600
+ "name": "delete",
1601
+ "aliases": [],
1602
+ "description": "Delete a variable",
1603
+ "hidden": false,
1604
+ "arguments": [
1605
+ {
1606
+ "name": "key-or-project",
1607
+ "required": true,
1608
+ "variadic": false,
1609
+ "description": "Variable key (global) or project name"
1610
+ },
1611
+ {
1612
+ "name": "key",
1613
+ "required": false,
1614
+ "variadic": false,
1615
+ "description": "Variable key (if first arg is project)"
1616
+ }
1617
+ ],
1618
+ "options": [
1619
+ {
1620
+ "flags": "-e, --env <environment>",
1621
+ "long": "--env",
1622
+ "short": "-e",
1623
+ "description": "Environment to delete from",
1624
+ "required": false,
1625
+ "value_required": true,
1626
+ "value_optional": false,
1627
+ "variadic": false,
1628
+ "negated": false,
1629
+ "hidden": false,
1630
+ "default": "dev"
1631
+ },
1632
+ {
1633
+ "flags": "-y, --yes",
1634
+ "long": "--yes",
1635
+ "short": "-y",
1636
+ "description": "Skip confirmation prompt",
1637
+ "required": false,
1638
+ "value_required": false,
1639
+ "value_optional": false,
1640
+ "variadic": false,
1641
+ "negated": false,
1642
+ "hidden": false
1643
+ },
1644
+ {
1645
+ "flags": "-h, --help",
1646
+ "long": "--help",
1647
+ "short": "-h",
1648
+ "description": "display help for command",
1649
+ "required": false,
1650
+ "value_required": false,
1651
+ "value_optional": false,
1652
+ "variadic": false,
1653
+ "negated": false,
1654
+ "hidden": false
1655
+ }
1656
+ ]
1657
+ },
1658
+ {
1659
+ "path": [
1660
+ "env",
1661
+ "reset"
1662
+ ],
1663
+ "name": "reset",
1664
+ "aliases": [],
1665
+ "description": "Reset a project variable mapping to its YAML-declared source",
1666
+ "hidden": false,
1667
+ "arguments": [
1668
+ {
1669
+ "name": "project",
1670
+ "required": true,
1671
+ "variadic": false,
1672
+ "description": "Project name"
1673
+ },
1674
+ {
1675
+ "name": "KEY",
1676
+ "required": true,
1677
+ "variadic": false,
1678
+ "description": "Variable key"
1679
+ }
1680
+ ],
1681
+ "options": [
1682
+ {
1683
+ "flags": "-e, --env <environment>",
1684
+ "long": "--env",
1685
+ "short": "-e",
1686
+ "description": "Environment to reset in",
1687
+ "required": false,
1688
+ "value_required": true,
1689
+ "value_optional": false,
1690
+ "variadic": false,
1691
+ "negated": false,
1692
+ "hidden": false,
1693
+ "default": "dev"
1694
+ },
1695
+ {
1696
+ "flags": "-h, --help",
1697
+ "long": "--help",
1698
+ "short": "-h",
1699
+ "description": "display help for command",
1700
+ "required": false,
1701
+ "value_required": false,
1702
+ "value_optional": false,
1703
+ "variadic": false,
1704
+ "negated": false,
1705
+ "hidden": false
1706
+ }
1707
+ ]
1708
+ },
1709
+ {
1710
+ "path": [
1711
+ "env",
1712
+ "map"
1713
+ ],
1714
+ "name": "map",
1715
+ "aliases": [],
1716
+ "description": "Map a global variable to a project-specific key",
1717
+ "hidden": false,
1718
+ "arguments": [
1719
+ {
1720
+ "name": "project",
1721
+ "required": true,
1722
+ "variadic": false,
1723
+ "description": "Project name"
1724
+ },
1725
+ {
1726
+ "name": "key",
1727
+ "required": true,
1728
+ "variadic": false,
1729
+ "description": "Project-specific variable name"
1730
+ },
1731
+ {
1732
+ "name": "global-key",
1733
+ "required": true,
1734
+ "variadic": false,
1735
+ "description": "Global variable name to map from"
1736
+ }
1737
+ ],
1738
+ "options": [
1739
+ {
1740
+ "flags": "-y, --yes",
1741
+ "long": "--yes",
1742
+ "short": "-y",
1743
+ "description": "Skip overwrite confirmation",
1744
+ "required": false,
1745
+ "value_required": false,
1746
+ "value_optional": false,
1747
+ "variadic": false,
1748
+ "negated": false,
1749
+ "hidden": false
1750
+ },
1751
+ {
1752
+ "flags": "-h, --help",
1753
+ "long": "--help",
1754
+ "short": "-h",
1755
+ "description": "display help for command",
1756
+ "required": false,
1757
+ "value_required": false,
1758
+ "value_optional": false,
1759
+ "variadic": false,
1760
+ "negated": false,
1761
+ "hidden": false
1762
+ }
1763
+ ]
1764
+ },
1765
+ {
1766
+ "path": [
1767
+ "env",
1768
+ "pull"
1769
+ ],
1770
+ "name": "pull",
1771
+ "aliases": [],
1772
+ "description": "Pull resolved variables to a local file",
1773
+ "hidden": false,
1774
+ "arguments": [
1775
+ {
1776
+ "name": "project",
1777
+ "required": true,
1778
+ "variadic": false,
1779
+ "description": "Project name"
1780
+ }
1781
+ ],
1782
+ "options": [
1783
+ {
1784
+ "flags": "-e, --env <environment>",
1785
+ "long": "--env",
1786
+ "short": "-e",
1787
+ "description": "Environment (production/staging/dev)",
1788
+ "required": false,
1789
+ "value_required": true,
1790
+ "value_optional": false,
1791
+ "variadic": false,
1792
+ "negated": false,
1793
+ "hidden": false,
1794
+ "default": "dev"
1795
+ },
1796
+ {
1797
+ "flags": "-o, --output <file>",
1798
+ "long": "--output",
1799
+ "short": "-o",
1800
+ "description": "Output file path (defaults to .env or .env.{environment})",
1801
+ "required": false,
1802
+ "value_required": true,
1803
+ "value_optional": false,
1804
+ "variadic": false,
1805
+ "negated": false,
1806
+ "hidden": false
1807
+ },
1808
+ {
1809
+ "flags": "-y, --yes",
1810
+ "long": "--yes",
1811
+ "short": "-y",
1812
+ "description": "Skip confirmation for secrets",
1813
+ "required": false,
1814
+ "value_required": false,
1815
+ "value_optional": false,
1816
+ "variadic": false,
1817
+ "negated": false,
1818
+ "hidden": false
1819
+ },
1820
+ {
1821
+ "flags": "--update-oauth",
1822
+ "long": "--update-oauth",
1823
+ "short": null,
1824
+ "description": "Only pull OAuth tokens and merge into existing .env file",
1825
+ "required": false,
1826
+ "value_required": false,
1827
+ "value_optional": false,
1828
+ "variadic": false,
1829
+ "negated": false,
1830
+ "hidden": false
1831
+ },
1832
+ {
1833
+ "flags": "-h, --help",
1834
+ "long": "--help",
1835
+ "short": "-h",
1836
+ "description": "display help for command",
1837
+ "required": false,
1838
+ "value_required": false,
1839
+ "value_optional": false,
1840
+ "variadic": false,
1841
+ "negated": false,
1842
+ "hidden": false
1843
+ }
1844
+ ]
1845
+ },
1846
+ {
1847
+ "path": [
1848
+ "env",
1849
+ "push"
1850
+ ],
1851
+ "name": "push",
1852
+ "aliases": [],
1853
+ "description": "Push variables from .env file to a project",
1854
+ "hidden": false,
1855
+ "arguments": [
1856
+ {
1857
+ "name": "project",
1858
+ "required": true,
1859
+ "variadic": false,
1860
+ "description": "Project name"
1861
+ },
1862
+ {
1863
+ "name": "path",
1864
+ "required": false,
1865
+ "variadic": false,
1866
+ "description": "Source directory with solidactions.yaml and .env file",
1867
+ "default": "."
1868
+ }
1869
+ ],
1870
+ "options": [
1871
+ {
1872
+ "flags": "-e, --env <environment>",
1873
+ "long": "--env",
1874
+ "short": "-e",
1875
+ "description": "Target environment (production/staging/dev)",
1876
+ "required": false,
1877
+ "value_required": true,
1878
+ "value_optional": false,
1879
+ "variadic": false,
1880
+ "negated": false,
1881
+ "hidden": false,
1882
+ "default": "dev"
1883
+ },
1884
+ {
1885
+ "flags": "--new-only",
1886
+ "long": "--new-only",
1887
+ "short": null,
1888
+ "description": "Only push new or empty variables (skip existing)",
1889
+ "required": false,
1890
+ "value_required": false,
1891
+ "value_optional": false,
1892
+ "variadic": false,
1893
+ "negated": false,
1894
+ "hidden": false
1895
+ },
1896
+ {
1897
+ "flags": "--include-undeclared",
1898
+ "long": "--include-undeclared",
1899
+ "short": null,
1900
+ "description": "Also push vars not declared in solidactions.yaml",
1901
+ "required": false,
1902
+ "value_required": false,
1903
+ "value_optional": false,
1904
+ "variadic": false,
1905
+ "negated": false,
1906
+ "hidden": false
1907
+ },
1908
+ {
1909
+ "flags": "-y, --yes",
1910
+ "long": "--yes",
1911
+ "short": "-y",
1912
+ "description": "Skip confirmation prompt",
1913
+ "required": false,
1914
+ "value_required": false,
1915
+ "value_optional": false,
1916
+ "variadic": false,
1917
+ "negated": false,
1918
+ "hidden": false
1919
+ },
1920
+ {
1921
+ "flags": "-h, --help",
1922
+ "long": "--help",
1923
+ "short": "-h",
1924
+ "description": "display help for command",
1925
+ "required": false,
1926
+ "value_required": false,
1927
+ "value_optional": false,
1928
+ "variadic": false,
1929
+ "negated": false,
1930
+ "hidden": false
1931
+ }
1932
+ ]
1933
+ },
1934
+ {
1935
+ "path": [
1936
+ "env",
1937
+ "help"
1938
+ ],
1939
+ "name": "help",
1940
+ "aliases": [],
1941
+ "description": "display help for command",
1942
+ "hidden": false,
1943
+ "arguments": [
1944
+ {
1945
+ "name": "command",
1946
+ "required": false,
1947
+ "variadic": false,
1948
+ "description": ""
1949
+ }
1950
+ ],
1951
+ "options": []
1952
+ },
1953
+ {
1954
+ "path": [
1955
+ "crew"
1956
+ ],
1957
+ "name": "crew",
1958
+ "aliases": [],
1959
+ "description": "Manage crews",
1960
+ "hidden": false,
1961
+ "arguments": [],
1962
+ "options": [
1963
+ {
1964
+ "flags": "-h, --help",
1965
+ "long": "--help",
1966
+ "short": "-h",
1967
+ "description": "display help for command",
1968
+ "required": false,
1969
+ "value_required": false,
1970
+ "value_optional": false,
1971
+ "variadic": false,
1972
+ "negated": false,
1973
+ "hidden": false
1974
+ }
1975
+ ]
1976
+ },
1977
+ {
1978
+ "path": [
1979
+ "crew",
1980
+ "env"
1981
+ ],
1982
+ "name": "env",
1983
+ "aliases": [],
1984
+ "description": "Manage crew variables",
1985
+ "hidden": false,
1986
+ "arguments": [],
1987
+ "options": [
1988
+ {
1989
+ "flags": "-h, --help",
1990
+ "long": "--help",
1991
+ "short": "-h",
1992
+ "description": "display help for command",
1993
+ "required": false,
1994
+ "value_required": false,
1995
+ "value_optional": false,
1996
+ "variadic": false,
1997
+ "negated": false,
1998
+ "hidden": false
1999
+ }
2000
+ ]
2001
+ },
2002
+ {
2003
+ "path": [
2004
+ "crew",
2005
+ "env",
2006
+ "set"
2007
+ ],
2008
+ "name": "set",
2009
+ "aliases": [],
2010
+ "description": "Set a crew variable (create or update)",
2011
+ "hidden": false,
2012
+ "arguments": [
2013
+ {
2014
+ "name": "crew",
2015
+ "required": true,
2016
+ "variadic": false,
2017
+ "description": "Crew name or id"
2018
+ },
2019
+ {
2020
+ "name": "key",
2021
+ "required": true,
2022
+ "variadic": false,
2023
+ "description": "Variable key"
2024
+ },
2025
+ {
2026
+ "name": "value",
2027
+ "required": true,
2028
+ "variadic": false,
2029
+ "description": "Variable value"
2030
+ }
2031
+ ],
2032
+ "options": [
2033
+ {
2034
+ "flags": "-e, --env <environment>",
2035
+ "long": "--env",
2036
+ "short": "-e",
2037
+ "description": "Target environment (production/staging/dev/all)",
2038
+ "required": false,
2039
+ "value_required": true,
2040
+ "value_optional": false,
2041
+ "variadic": false,
2042
+ "negated": false,
2043
+ "hidden": false,
2044
+ "default": "all"
2045
+ },
2046
+ {
2047
+ "flags": "--no-secret",
2048
+ "long": "--no-secret",
2049
+ "short": null,
2050
+ "description": "Do not mark as secret — crew variables are secret by default (unlike `env set`)",
2051
+ "required": false,
2052
+ "value_required": false,
2053
+ "value_optional": false,
2054
+ "variadic": false,
2055
+ "negated": true,
2056
+ "hidden": false,
2057
+ "default": true
2058
+ },
2059
+ {
2060
+ "flags": "-h, --help",
2061
+ "long": "--help",
2062
+ "short": "-h",
2063
+ "description": "display help for command",
2064
+ "required": false,
2065
+ "value_required": false,
2066
+ "value_optional": false,
2067
+ "variadic": false,
2068
+ "negated": false,
2069
+ "hidden": false
2070
+ }
2071
+ ]
2072
+ },
2073
+ {
2074
+ "path": [
2075
+ "crew",
2076
+ "env",
2077
+ "list"
2078
+ ],
2079
+ "name": "list",
2080
+ "aliases": [],
2081
+ "description": "List crew variables",
2082
+ "hidden": false,
2083
+ "arguments": [
2084
+ {
2085
+ "name": "crew",
2086
+ "required": true,
2087
+ "variadic": false,
2088
+ "description": "Crew name or id"
2089
+ }
2090
+ ],
2091
+ "options": [
2092
+ {
2093
+ "flags": "--json",
2094
+ "long": "--json",
2095
+ "short": null,
2096
+ "description": "Output as JSON",
2097
+ "required": false,
2098
+ "value_required": false,
2099
+ "value_optional": false,
2100
+ "variadic": false,
2101
+ "negated": false,
2102
+ "hidden": false
2103
+ },
2104
+ {
2105
+ "flags": "-h, --help",
2106
+ "long": "--help",
2107
+ "short": "-h",
2108
+ "description": "display help for command",
2109
+ "required": false,
2110
+ "value_required": false,
2111
+ "value_optional": false,
2112
+ "variadic": false,
2113
+ "negated": false,
2114
+ "hidden": false
2115
+ }
2116
+ ]
2117
+ },
2118
+ {
2119
+ "path": [
2120
+ "crew",
2121
+ "env",
2122
+ "delete"
2123
+ ],
2124
+ "name": "delete",
2125
+ "aliases": [],
2126
+ "description": "Delete a crew variable",
2127
+ "hidden": false,
2128
+ "arguments": [
2129
+ {
2130
+ "name": "crew",
2131
+ "required": true,
2132
+ "variadic": false,
2133
+ "description": "Crew name or id"
2134
+ },
2135
+ {
2136
+ "name": "key",
2137
+ "required": true,
2138
+ "variadic": false,
2139
+ "description": "Variable key"
2140
+ }
2141
+ ],
2142
+ "options": [
2143
+ {
2144
+ "flags": "-y, --yes",
2145
+ "long": "--yes",
2146
+ "short": "-y",
2147
+ "description": "Skip confirmation prompt",
2148
+ "required": false,
2149
+ "value_required": false,
2150
+ "value_optional": false,
2151
+ "variadic": false,
2152
+ "negated": false,
2153
+ "hidden": false
2154
+ },
2155
+ {
2156
+ "flags": "-h, --help",
2157
+ "long": "--help",
2158
+ "short": "-h",
2159
+ "description": "display help for command",
2160
+ "required": false,
2161
+ "value_required": false,
2162
+ "value_optional": false,
2163
+ "variadic": false,
2164
+ "negated": false,
2165
+ "hidden": false
2166
+ }
2167
+ ]
2168
+ },
2169
+ {
2170
+ "path": [
2171
+ "crew",
2172
+ "env",
2173
+ "push"
2174
+ ],
2175
+ "name": "push",
2176
+ "aliases": [],
2177
+ "description": "Push variables from a .env file to a crew",
2178
+ "hidden": false,
2179
+ "arguments": [
2180
+ {
2181
+ "name": "crew",
2182
+ "required": true,
2183
+ "variadic": false,
2184
+ "description": "Crew name or id"
2185
+ },
2186
+ {
2187
+ "name": "file",
2188
+ "required": false,
2189
+ "variadic": false,
2190
+ "description": "Source .env file",
2191
+ "default": ".env"
2192
+ }
2193
+ ],
2194
+ "options": [
2195
+ {
2196
+ "flags": "-e, --env <environment>",
2197
+ "long": "--env",
2198
+ "short": "-e",
2199
+ "description": "Target environment (production/staging/dev/all)",
2200
+ "required": false,
2201
+ "value_required": true,
2202
+ "value_optional": false,
2203
+ "variadic": false,
2204
+ "negated": false,
2205
+ "hidden": false,
2206
+ "default": "all"
2207
+ },
2208
+ {
2209
+ "flags": "--no-secret",
2210
+ "long": "--no-secret",
2211
+ "short": null,
2212
+ "description": "Do not mark pushed variables as secret — secret by default (unlike `env push`)",
2213
+ "required": false,
2214
+ "value_required": false,
2215
+ "value_optional": false,
2216
+ "variadic": false,
2217
+ "negated": true,
2218
+ "hidden": false,
2219
+ "default": true
2220
+ },
2221
+ {
2222
+ "flags": "-y, --yes",
2223
+ "long": "--yes",
2224
+ "short": "-y",
2225
+ "description": "Skip confirmation prompt",
2226
+ "required": false,
2227
+ "value_required": false,
2228
+ "value_optional": false,
2229
+ "variadic": false,
2230
+ "negated": false,
2231
+ "hidden": false
2232
+ },
2233
+ {
2234
+ "flags": "-h, --help",
2235
+ "long": "--help",
2236
+ "short": "-h",
2237
+ "description": "display help for command",
2238
+ "required": false,
2239
+ "value_required": false,
2240
+ "value_optional": false,
2241
+ "variadic": false,
2242
+ "negated": false,
2243
+ "hidden": false
2244
+ }
2245
+ ]
2246
+ },
2247
+ {
2248
+ "path": [
2249
+ "crew",
2250
+ "env",
2251
+ "help"
2252
+ ],
2253
+ "name": "help",
2254
+ "aliases": [],
2255
+ "description": "display help for command",
2256
+ "hidden": false,
2257
+ "arguments": [
2258
+ {
2259
+ "name": "command",
2260
+ "required": false,
2261
+ "variadic": false,
2262
+ "description": ""
2263
+ }
2264
+ ],
2265
+ "options": []
2266
+ },
2267
+ {
2268
+ "path": [
2269
+ "crew",
2270
+ "help"
2271
+ ],
2272
+ "name": "help",
2273
+ "aliases": [],
2274
+ "description": "display help for command",
2275
+ "hidden": false,
2276
+ "arguments": [
2277
+ {
2278
+ "name": "command",
2279
+ "required": false,
2280
+ "variadic": false,
2281
+ "description": ""
2282
+ }
2283
+ ],
2284
+ "options": []
2285
+ },
2286
+ {
2287
+ "path": [
2288
+ "schedule"
2289
+ ],
2290
+ "name": "schedule",
2291
+ "aliases": [],
2292
+ "description": "Manage cron schedules",
2293
+ "hidden": false,
2294
+ "arguments": [],
2295
+ "options": [
2296
+ {
2297
+ "flags": "-h, --help",
2298
+ "long": "--help",
2299
+ "short": "-h",
2300
+ "description": "display help for command",
2301
+ "required": false,
2302
+ "value_required": false,
2303
+ "value_optional": false,
2304
+ "variadic": false,
2305
+ "negated": false,
2306
+ "hidden": false
2307
+ }
2308
+ ]
2309
+ },
2310
+ {
2311
+ "path": [
2312
+ "schedule",
2313
+ "set"
2314
+ ],
2315
+ "name": "set",
2316
+ "aliases": [],
2317
+ "description": "Set a cron schedule for a workflow",
2318
+ "hidden": false,
2319
+ "arguments": [
2320
+ {
2321
+ "name": "project",
2322
+ "required": true,
2323
+ "variadic": false,
2324
+ "description": "Project name"
2325
+ },
2326
+ {
2327
+ "name": "cron",
2328
+ "required": true,
2329
+ "variadic": false,
2330
+ "description": "Cron expression (e.g., \"0 9 * * *\" for daily at 9am)"
2331
+ }
2332
+ ],
2333
+ "options": [
2334
+ {
2335
+ "flags": "--workflow <name>",
2336
+ "long": "--workflow",
2337
+ "short": null,
2338
+ "description": "Workflow name (if project has multiple)",
2339
+ "required": false,
2340
+ "value_required": true,
2341
+ "value_optional": false,
2342
+ "variadic": false,
2343
+ "negated": false,
2344
+ "hidden": false
2345
+ },
2346
+ {
2347
+ "flags": "-i, --input <json>",
2348
+ "long": "--input",
2349
+ "short": "-i",
2350
+ "description": "JSON input to pass to scheduled runs",
2351
+ "required": false,
2352
+ "value_required": true,
2353
+ "value_optional": false,
2354
+ "variadic": false,
2355
+ "negated": false,
2356
+ "hidden": false
2357
+ },
2358
+ {
2359
+ "flags": "-z, --timezone <iana>",
2360
+ "long": "--timezone",
2361
+ "short": "-z",
2362
+ "description": "IANA timezone the cron is evaluated in (e.g. America/Chicago); defaults to UTC",
2363
+ "required": false,
2364
+ "value_required": true,
2365
+ "value_optional": false,
2366
+ "variadic": false,
2367
+ "negated": false,
2368
+ "hidden": false
2369
+ },
2370
+ {
2371
+ "flags": "-e, --env <environment>",
2372
+ "long": "--env",
2373
+ "short": "-e",
2374
+ "description": "Resolve an explicit environment (production/staging/dev)",
2375
+ "required": false,
2376
+ "value_required": true,
2377
+ "value_optional": false,
2378
+ "variadic": false,
2379
+ "negated": false,
2380
+ "hidden": false
2381
+ },
2382
+ {
2383
+ "flags": "--paused",
2384
+ "long": "--paused",
2385
+ "short": null,
2386
+ "description": "Create or replace the schedule disabled",
2387
+ "required": false,
2388
+ "value_required": false,
2389
+ "value_optional": false,
2390
+ "variadic": false,
2391
+ "negated": false,
2392
+ "hidden": false
2393
+ },
2394
+ {
2395
+ "flags": "-y, --yes",
2396
+ "long": "--yes",
2397
+ "short": "-y",
2398
+ "description": "Skip confirmation if schedule already exists",
2399
+ "required": false,
2400
+ "value_required": false,
2401
+ "value_optional": false,
2402
+ "variadic": false,
2403
+ "negated": false,
2404
+ "hidden": false
2405
+ },
2406
+ {
2407
+ "flags": "-h, --help",
2408
+ "long": "--help",
2409
+ "short": "-h",
2410
+ "description": "display help for command",
2411
+ "required": false,
2412
+ "value_required": false,
2413
+ "value_optional": false,
2414
+ "variadic": false,
2415
+ "negated": false,
2416
+ "hidden": false
2417
+ }
2418
+ ]
2419
+ },
2420
+ {
2421
+ "path": [
2422
+ "schedule",
2423
+ "list"
2424
+ ],
2425
+ "name": "list",
2426
+ "aliases": [],
2427
+ "description": "List schedules for a project",
2428
+ "hidden": false,
2429
+ "arguments": [
2430
+ {
2431
+ "name": "project",
2432
+ "required": true,
2433
+ "variadic": false,
2434
+ "description": "Project name"
2435
+ }
2436
+ ],
2437
+ "options": [
2438
+ {
2439
+ "flags": "-e, --env <environment>",
2440
+ "long": "--env",
2441
+ "short": "-e",
2442
+ "description": "Resolve an explicit environment (production/staging/dev)",
2443
+ "required": false,
2444
+ "value_required": true,
2445
+ "value_optional": false,
2446
+ "variadic": false,
2447
+ "negated": false,
2448
+ "hidden": false
2449
+ },
2450
+ {
2451
+ "flags": "-h, --help",
2452
+ "long": "--help",
2453
+ "short": "-h",
2454
+ "description": "display help for command",
2455
+ "required": false,
2456
+ "value_required": false,
2457
+ "value_optional": false,
2458
+ "variadic": false,
2459
+ "negated": false,
2460
+ "hidden": false
2461
+ }
2462
+ ]
2463
+ },
2464
+ {
2465
+ "path": [
2466
+ "schedule",
2467
+ "enable"
2468
+ ],
2469
+ "name": "enable",
2470
+ "aliases": [],
2471
+ "description": "Enable a schedule with a sticky operator override",
2472
+ "hidden": false,
2473
+ "arguments": [
2474
+ {
2475
+ "name": "project",
2476
+ "required": true,
2477
+ "variadic": false,
2478
+ "description": "Project name"
2479
+ },
2480
+ {
2481
+ "name": "schedule-id",
2482
+ "required": true,
2483
+ "variadic": false,
2484
+ "description": "Schedule ID"
2485
+ }
2486
+ ],
2487
+ "options": [
2488
+ {
2489
+ "flags": "-e, --env <environment>",
2490
+ "long": "--env",
2491
+ "short": "-e",
2492
+ "description": "Resolve an explicit environment (production/staging/dev)",
2493
+ "required": false,
2494
+ "value_required": true,
2495
+ "value_optional": false,
2496
+ "variadic": false,
2497
+ "negated": false,
2498
+ "hidden": false
2499
+ },
2500
+ {
2501
+ "flags": "-h, --help",
2502
+ "long": "--help",
2503
+ "short": "-h",
2504
+ "description": "display help for command",
2505
+ "required": false,
2506
+ "value_required": false,
2507
+ "value_optional": false,
2508
+ "variadic": false,
2509
+ "negated": false,
2510
+ "hidden": false
2511
+ }
2512
+ ]
2513
+ },
2514
+ {
2515
+ "path": [
2516
+ "schedule",
2517
+ "disable"
2518
+ ],
2519
+ "name": "disable",
2520
+ "aliases": [],
2521
+ "description": "Disable a schedule with a sticky operator override",
2522
+ "hidden": false,
2523
+ "arguments": [
2524
+ {
2525
+ "name": "project",
2526
+ "required": true,
2527
+ "variadic": false,
2528
+ "description": "Project name"
2529
+ },
2530
+ {
2531
+ "name": "schedule-id",
2532
+ "required": true,
2533
+ "variadic": false,
2534
+ "description": "Schedule ID"
2535
+ }
2536
+ ],
2537
+ "options": [
2538
+ {
2539
+ "flags": "-e, --env <environment>",
2540
+ "long": "--env",
2541
+ "short": "-e",
2542
+ "description": "Resolve an explicit environment (production/staging/dev)",
2543
+ "required": false,
2544
+ "value_required": true,
2545
+ "value_optional": false,
2546
+ "variadic": false,
2547
+ "negated": false,
2548
+ "hidden": false
2549
+ },
2550
+ {
2551
+ "flags": "-h, --help",
2552
+ "long": "--help",
2553
+ "short": "-h",
2554
+ "description": "display help for command",
2555
+ "required": false,
2556
+ "value_required": false,
2557
+ "value_optional": false,
2558
+ "variadic": false,
2559
+ "negated": false,
2560
+ "hidden": false
2561
+ }
2562
+ ]
2563
+ },
2564
+ {
2565
+ "path": [
2566
+ "schedule",
2567
+ "reset"
2568
+ ],
2569
+ "name": "reset",
2570
+ "aliases": [],
2571
+ "description": "Return a schedule to its last declared YAML configuration",
2572
+ "hidden": false,
2573
+ "arguments": [
2574
+ {
2575
+ "name": "project",
2576
+ "required": true,
2577
+ "variadic": false,
2578
+ "description": "Project name"
2579
+ },
2580
+ {
2581
+ "name": "schedule-id",
2582
+ "required": true,
2583
+ "variadic": false,
2584
+ "description": "Schedule ID"
2585
+ }
2586
+ ],
2587
+ "options": [
2588
+ {
2589
+ "flags": "-e, --env <environment>",
2590
+ "long": "--env",
2591
+ "short": "-e",
2592
+ "description": "Resolve an explicit environment (production/staging/dev)",
2593
+ "required": false,
2594
+ "value_required": true,
2595
+ "value_optional": false,
2596
+ "variadic": false,
2597
+ "negated": false,
2598
+ "hidden": false
2599
+ },
2600
+ {
2601
+ "flags": "-h, --help",
2602
+ "long": "--help",
2603
+ "short": "-h",
2604
+ "description": "display help for command",
2605
+ "required": false,
2606
+ "value_required": false,
2607
+ "value_optional": false,
2608
+ "variadic": false,
2609
+ "negated": false,
2610
+ "hidden": false
2611
+ }
2612
+ ]
2613
+ },
2614
+ {
2615
+ "path": [
2616
+ "schedule",
2617
+ "delete"
2618
+ ],
2619
+ "name": "delete",
2620
+ "aliases": [],
2621
+ "description": "Delete a schedule",
2622
+ "hidden": false,
2623
+ "arguments": [
2624
+ {
2625
+ "name": "project",
2626
+ "required": true,
2627
+ "variadic": false,
2628
+ "description": "Project name"
2629
+ },
2630
+ {
2631
+ "name": "schedule-id",
2632
+ "required": true,
2633
+ "variadic": false,
2634
+ "description": "Schedule ID"
2635
+ }
2636
+ ],
2637
+ "options": [
2638
+ {
2639
+ "flags": "-e, --env <environment>",
2640
+ "long": "--env",
2641
+ "short": "-e",
2642
+ "description": "Resolve an explicit environment (production/staging/dev)",
2643
+ "required": false,
2644
+ "value_required": true,
2645
+ "value_optional": false,
2646
+ "variadic": false,
2647
+ "negated": false,
2648
+ "hidden": false
2649
+ },
2650
+ {
2651
+ "flags": "-y, --yes",
2652
+ "long": "--yes",
2653
+ "short": "-y",
2654
+ "description": "Skip confirmation prompt",
2655
+ "required": false,
2656
+ "value_required": false,
2657
+ "value_optional": false,
2658
+ "variadic": false,
2659
+ "negated": false,
2660
+ "hidden": false
2661
+ },
2662
+ {
2663
+ "flags": "-h, --help",
2664
+ "long": "--help",
2665
+ "short": "-h",
2666
+ "description": "display help for command",
2667
+ "required": false,
2668
+ "value_required": false,
2669
+ "value_optional": false,
2670
+ "variadic": false,
2671
+ "negated": false,
2672
+ "hidden": false
2673
+ }
2674
+ ]
2675
+ },
2676
+ {
2677
+ "path": [
2678
+ "schedule",
2679
+ "help"
2680
+ ],
2681
+ "name": "help",
2682
+ "aliases": [],
2683
+ "description": "display help for command",
2684
+ "hidden": false,
2685
+ "arguments": [
2686
+ {
2687
+ "name": "command",
2688
+ "required": false,
2689
+ "variadic": false,
2690
+ "description": ""
2691
+ }
2692
+ ],
2693
+ "options": []
2694
+ },
2695
+ {
2696
+ "path": [
2697
+ "webhook"
2698
+ ],
2699
+ "name": "webhook",
2700
+ "aliases": [],
2701
+ "description": "Manage webhooks",
2702
+ "hidden": false,
2703
+ "arguments": [],
2704
+ "options": [
2705
+ {
2706
+ "flags": "-h, --help",
2707
+ "long": "--help",
2708
+ "short": "-h",
2709
+ "description": "display help for command",
2710
+ "required": false,
2711
+ "value_required": false,
2712
+ "value_optional": false,
2713
+ "variadic": false,
2714
+ "negated": false,
2715
+ "hidden": false
2716
+ }
2717
+ ]
2718
+ },
2719
+ {
2720
+ "path": [
2721
+ "webhook",
2722
+ "list"
2723
+ ],
2724
+ "name": "list",
2725
+ "aliases": [],
2726
+ "description": "List webhook URLs for a project",
2727
+ "hidden": false,
2728
+ "arguments": [
2729
+ {
2730
+ "name": "project",
2731
+ "required": true,
2732
+ "variadic": false,
2733
+ "description": "Project name"
2734
+ }
2735
+ ],
2736
+ "options": [
2737
+ {
2738
+ "flags": "-e, --env <environment>",
2739
+ "long": "--env",
2740
+ "short": "-e",
2741
+ "description": "Environment (production/staging/dev)",
2742
+ "required": false,
2743
+ "value_required": true,
2744
+ "value_optional": false,
2745
+ "variadic": false,
2746
+ "negated": false,
2747
+ "hidden": false
2748
+ },
2749
+ {
2750
+ "flags": "--show-secrets",
2751
+ "long": "--show-secrets",
2752
+ "short": null,
2753
+ "description": "Show webhook secrets",
2754
+ "required": false,
2755
+ "value_required": false,
2756
+ "value_optional": false,
2757
+ "variadic": false,
2758
+ "negated": false,
2759
+ "hidden": false
2760
+ },
2761
+ {
2762
+ "flags": "--format <format>",
2763
+ "long": "--format",
2764
+ "short": null,
2765
+ "description": "Output format: table or json",
2766
+ "required": false,
2767
+ "value_required": true,
2768
+ "value_optional": false,
2769
+ "variadic": false,
2770
+ "negated": false,
2771
+ "hidden": false,
2772
+ "default": "table"
2773
+ },
2774
+ {
2775
+ "flags": "-h, --help",
2776
+ "long": "--help",
2777
+ "short": "-h",
2778
+ "description": "display help for command",
2779
+ "required": false,
2780
+ "value_required": false,
2781
+ "value_optional": false,
2782
+ "variadic": false,
2783
+ "negated": false,
2784
+ "hidden": false
2785
+ }
2786
+ ]
2787
+ },
2788
+ {
2789
+ "path": [
2790
+ "webhook",
2791
+ "secret"
2792
+ ],
2793
+ "name": "secret",
2794
+ "aliases": [],
2795
+ "description": "Print the webhook secret for a project (set this value in your sender)",
2796
+ "hidden": false,
2797
+ "arguments": [
2798
+ {
2799
+ "name": "project",
2800
+ "required": true,
2801
+ "variadic": false,
2802
+ "description": "Project name"
2803
+ }
2804
+ ],
2805
+ "options": [
2806
+ {
2807
+ "flags": "-e, --env <environment>",
2808
+ "long": "--env",
2809
+ "short": "-e",
2810
+ "description": "Environment (production/staging/dev)",
2811
+ "required": false,
2812
+ "value_required": true,
2813
+ "value_optional": false,
2814
+ "variadic": false,
2815
+ "negated": false,
2816
+ "hidden": false
2817
+ },
2818
+ {
2819
+ "flags": "--workflow <name>",
2820
+ "long": "--workflow",
2821
+ "short": null,
2822
+ "description": "Filter to a specific workflow by name",
2823
+ "required": false,
2824
+ "value_required": true,
2825
+ "value_optional": false,
2826
+ "variadic": false,
2827
+ "negated": false,
2828
+ "hidden": false
2829
+ },
2830
+ {
2831
+ "flags": "--format <format>",
2832
+ "long": "--format",
2833
+ "short": null,
2834
+ "description": "Output format: text or json",
2835
+ "required": false,
2836
+ "value_required": true,
2837
+ "value_optional": false,
2838
+ "variadic": false,
2839
+ "negated": false,
2840
+ "hidden": false,
2841
+ "default": "text"
2842
+ },
2843
+ {
2844
+ "flags": "-h, --help",
2845
+ "long": "--help",
2846
+ "short": "-h",
2847
+ "description": "display help for command",
2848
+ "required": false,
2849
+ "value_required": false,
2850
+ "value_optional": false,
2851
+ "variadic": false,
2852
+ "negated": false,
2853
+ "hidden": false
2854
+ }
2855
+ ]
2856
+ },
2857
+ {
2858
+ "path": [
2859
+ "webhook",
2860
+ "help"
2861
+ ],
2862
+ "name": "help",
2863
+ "aliases": [],
2864
+ "description": "display help for command",
2865
+ "hidden": false,
2866
+ "arguments": [
2867
+ {
2868
+ "name": "command",
2869
+ "required": false,
2870
+ "variadic": false,
2871
+ "description": ""
2872
+ }
2873
+ ],
2874
+ "options": []
2875
+ },
2876
+ {
2877
+ "path": [
2878
+ "workspace"
2879
+ ],
2880
+ "name": "workspace",
2881
+ "aliases": [],
2882
+ "description": "Manage workspaces",
2883
+ "hidden": false,
2884
+ "arguments": [],
2885
+ "options": [
2886
+ {
2887
+ "flags": "-h, --help",
2888
+ "long": "--help",
2889
+ "short": "-h",
2890
+ "description": "display help for command",
2891
+ "required": false,
2892
+ "value_required": false,
2893
+ "value_optional": false,
2894
+ "variadic": false,
2895
+ "negated": false,
2896
+ "hidden": false
2897
+ }
2898
+ ]
2899
+ },
2900
+ {
2901
+ "path": [
2902
+ "workspace",
2903
+ "list"
2904
+ ],
2905
+ "name": "list",
2906
+ "aliases": [],
2907
+ "description": "List your workspaces across all organizations",
2908
+ "hidden": false,
2909
+ "arguments": [],
2910
+ "options": [
2911
+ {
2912
+ "flags": "-h, --help",
2913
+ "long": "--help",
2914
+ "short": "-h",
2915
+ "description": "display help for command",
2916
+ "required": false,
2917
+ "value_required": false,
2918
+ "value_optional": false,
2919
+ "variadic": false,
2920
+ "negated": false,
2921
+ "hidden": false
2922
+ }
2923
+ ]
2924
+ },
2925
+ {
2926
+ "path": [
2927
+ "workspace",
2928
+ "set"
2929
+ ],
2930
+ "name": "set",
2931
+ "aliases": [],
2932
+ "description": "Set the active workspace and pin it",
2933
+ "hidden": false,
2934
+ "arguments": [
2935
+ {
2936
+ "name": "id-or-slug-or-name",
2937
+ "required": true,
2938
+ "variadic": false,
2939
+ "description": "Workspace ID, slug, or name"
2940
+ }
2941
+ ],
2942
+ "options": [
2943
+ {
2944
+ "flags": "--local",
2945
+ "long": "--local",
2946
+ "short": null,
2947
+ "description": "pin to ./.solidactions/config.json (this folder only)",
2948
+ "required": false,
2949
+ "value_required": false,
2950
+ "value_optional": false,
2951
+ "variadic": false,
2952
+ "negated": false,
2953
+ "hidden": false
2954
+ },
2955
+ {
2956
+ "flags": "--global",
2957
+ "long": "--global",
2958
+ "short": null,
2959
+ "description": "pin to ~/.solidactions/config.json (machine-wide)",
2960
+ "required": false,
2961
+ "value_required": false,
2962
+ "value_optional": false,
2963
+ "variadic": false,
2964
+ "negated": false,
2965
+ "hidden": false
2966
+ },
2967
+ {
2968
+ "flags": "--gitignore",
2969
+ "long": "--gitignore",
2970
+ "short": null,
2971
+ "description": "auto-add .solidactions/ to local .gitignore (skip prompt)",
2972
+ "required": false,
2973
+ "value_required": false,
2974
+ "value_optional": false,
2975
+ "variadic": false,
2976
+ "negated": false,
2977
+ "hidden": false
2978
+ },
2979
+ {
2980
+ "flags": "-h, --help",
2981
+ "long": "--help",
2982
+ "short": "-h",
2983
+ "description": "display help for command",
2984
+ "required": false,
2985
+ "value_required": false,
2986
+ "value_optional": false,
2987
+ "variadic": false,
2988
+ "negated": false,
2989
+ "hidden": false
2990
+ }
2991
+ ]
2992
+ },
2993
+ {
2994
+ "path": [
2995
+ "workspace",
2996
+ "help"
2997
+ ],
2998
+ "name": "help",
2999
+ "aliases": [],
3000
+ "description": "display help for command",
3001
+ "hidden": false,
3002
+ "arguments": [
3003
+ {
3004
+ "name": "command",
3005
+ "required": false,
3006
+ "variadic": false,
3007
+ "description": ""
3008
+ }
3009
+ ],
3010
+ "options": []
3011
+ },
3012
+ {
3013
+ "path": [
3014
+ "oauth-action"
3015
+ ],
3016
+ "name": "oauth-action",
3017
+ "aliases": [],
3018
+ "description": "Discover OAuth-backed API operations callable via the SA proxy",
3019
+ "hidden": false,
3020
+ "arguments": [],
3021
+ "options": [
3022
+ {
3023
+ "flags": "-h, --help",
3024
+ "long": "--help",
3025
+ "short": "-h",
3026
+ "description": "display help for command",
3027
+ "required": false,
3028
+ "value_required": false,
3029
+ "value_optional": false,
3030
+ "variadic": false,
3031
+ "negated": false,
3032
+ "hidden": false
3033
+ }
3034
+ ]
3035
+ },
3036
+ {
3037
+ "path": [
3038
+ "oauth-action",
3039
+ "search"
3040
+ ],
3041
+ "name": "search",
3042
+ "aliases": [],
3043
+ "description": "Search available actions for a connected platform",
3044
+ "hidden": false,
3045
+ "arguments": [
3046
+ {
3047
+ "name": "platform",
3048
+ "required": true,
3049
+ "variadic": false,
3050
+ "description": ""
3051
+ },
3052
+ {
3053
+ "name": "query",
3054
+ "required": false,
3055
+ "variadic": false,
3056
+ "description": ""
3057
+ }
3058
+ ],
3059
+ "options": [
3060
+ {
3061
+ "flags": "--method <method>",
3062
+ "long": "--method",
3063
+ "short": null,
3064
+ "description": "Filter by HTTP method (GET, POST, etc.)",
3065
+ "required": false,
3066
+ "value_required": true,
3067
+ "value_optional": false,
3068
+ "variadic": false,
3069
+ "negated": false,
3070
+ "hidden": false
3071
+ },
3072
+ {
3073
+ "flags": "--limit <n>",
3074
+ "long": "--limit",
3075
+ "short": null,
3076
+ "description": "Maximum results to return",
3077
+ "required": false,
3078
+ "value_required": true,
3079
+ "value_optional": false,
3080
+ "variadic": false,
3081
+ "negated": false,
3082
+ "hidden": false
3083
+ },
3084
+ {
3085
+ "flags": "--json",
3086
+ "long": "--json",
3087
+ "short": null,
3088
+ "description": "Emit raw JSON for AI/script consumption",
3089
+ "required": false,
3090
+ "value_required": false,
3091
+ "value_optional": false,
3092
+ "variadic": false,
3093
+ "negated": false,
3094
+ "hidden": false
3095
+ },
3096
+ {
3097
+ "flags": "-h, --help",
3098
+ "long": "--help",
3099
+ "short": "-h",
3100
+ "description": "display help for command",
3101
+ "required": false,
3102
+ "value_required": false,
3103
+ "value_optional": false,
3104
+ "variadic": false,
3105
+ "negated": false,
3106
+ "hidden": false
3107
+ }
3108
+ ]
3109
+ },
3110
+ {
3111
+ "path": [
3112
+ "oauth-action",
3113
+ "list"
3114
+ ],
3115
+ "name": "list",
3116
+ "aliases": [],
3117
+ "description": "List actions for a connected platform",
3118
+ "hidden": false,
3119
+ "arguments": [
3120
+ {
3121
+ "name": "platform",
3122
+ "required": true,
3123
+ "variadic": false,
3124
+ "description": ""
3125
+ }
3126
+ ],
3127
+ "options": [
3128
+ {
3129
+ "flags": "--limit <n>",
3130
+ "long": "--limit",
3131
+ "short": null,
3132
+ "description": "Maximum results to return",
3133
+ "required": false,
3134
+ "value_required": true,
3135
+ "value_optional": false,
3136
+ "variadic": false,
3137
+ "negated": false,
3138
+ "hidden": false
3139
+ },
3140
+ {
3141
+ "flags": "--json",
3142
+ "long": "--json",
3143
+ "short": null,
3144
+ "description": "Emit raw JSON for AI/script consumption",
3145
+ "required": false,
3146
+ "value_required": false,
3147
+ "value_optional": false,
3148
+ "variadic": false,
3149
+ "negated": false,
3150
+ "hidden": false
3151
+ },
3152
+ {
3153
+ "flags": "-h, --help",
3154
+ "long": "--help",
3155
+ "short": "-h",
3156
+ "description": "display help for command",
3157
+ "required": false,
3158
+ "value_required": false,
3159
+ "value_optional": false,
3160
+ "variadic": false,
3161
+ "negated": false,
3162
+ "hidden": false
3163
+ }
3164
+ ]
3165
+ },
3166
+ {
3167
+ "path": [
3168
+ "oauth-action",
3169
+ "view"
3170
+ ],
3171
+ "name": "view",
3172
+ "aliases": [],
3173
+ "description": "Show full schema, example body, and a paste-ready fetch snippet for one action",
3174
+ "hidden": false,
3175
+ "arguments": [
3176
+ {
3177
+ "name": "platform",
3178
+ "required": true,
3179
+ "variadic": false,
3180
+ "description": ""
3181
+ },
3182
+ {
3183
+ "name": "action-id",
3184
+ "required": true,
3185
+ "variadic": false,
3186
+ "description": ""
3187
+ }
3188
+ ],
3189
+ "options": [
3190
+ {
3191
+ "flags": "--json",
3192
+ "long": "--json",
3193
+ "short": null,
3194
+ "description": "Emit raw JSON for AI/script consumption",
3195
+ "required": false,
3196
+ "value_required": false,
3197
+ "value_optional": false,
3198
+ "variadic": false,
3199
+ "negated": false,
3200
+ "hidden": false
3201
+ },
3202
+ {
3203
+ "flags": "--var <NAME>",
3204
+ "long": "--var",
3205
+ "short": null,
3206
+ "description": "ctx.vars variable name for the connection (default: YOUR_CONNECTION)",
3207
+ "required": false,
3208
+ "value_required": true,
3209
+ "value_optional": false,
3210
+ "variadic": false,
3211
+ "negated": false,
3212
+ "hidden": false
3213
+ },
3214
+ {
3215
+ "flags": "--legacy-env",
3216
+ "long": "--legacy-env",
3217
+ "short": null,
3218
+ "description": "Emit the deprecated process.env-based snippet (will be removed in a future release)",
3219
+ "required": false,
3220
+ "value_required": false,
3221
+ "value_optional": false,
3222
+ "variadic": false,
3223
+ "negated": false,
3224
+ "hidden": false
3225
+ },
3226
+ {
3227
+ "flags": "-h, --help",
3228
+ "long": "--help",
3229
+ "short": "-h",
3230
+ "description": "display help for command",
3231
+ "required": false,
3232
+ "value_required": false,
3233
+ "value_optional": false,
3234
+ "variadic": false,
3235
+ "negated": false,
3236
+ "hidden": false
3237
+ }
3238
+ ]
3239
+ },
3240
+ {
3241
+ "path": [
3242
+ "oauth-action",
3243
+ "platforms"
3244
+ ],
3245
+ "name": "platforms",
3246
+ "aliases": [],
3247
+ "description": "List available OAuth-backed platforms",
3248
+ "hidden": false,
3249
+ "arguments": [],
3250
+ "options": [
3251
+ {
3252
+ "flags": "--json",
3253
+ "long": "--json",
3254
+ "short": null,
3255
+ "description": "Emit raw JSON for AI/script consumption",
3256
+ "required": false,
3257
+ "value_required": false,
3258
+ "value_optional": false,
3259
+ "variadic": false,
3260
+ "negated": false,
3261
+ "hidden": false
3262
+ },
3263
+ {
3264
+ "flags": "-h, --help",
3265
+ "long": "--help",
3266
+ "short": "-h",
3267
+ "description": "display help for command",
3268
+ "required": false,
3269
+ "value_required": false,
3270
+ "value_optional": false,
3271
+ "variadic": false,
3272
+ "negated": false,
3273
+ "hidden": false
3274
+ }
3275
+ ]
3276
+ },
3277
+ {
3278
+ "path": [
3279
+ "oauth-action",
3280
+ "help"
3281
+ ],
3282
+ "name": "help",
3283
+ "aliases": [],
3284
+ "description": "display help for command",
3285
+ "hidden": false,
3286
+ "arguments": [
3287
+ {
3288
+ "name": "command",
3289
+ "required": false,
3290
+ "variadic": false,
3291
+ "description": ""
3292
+ }
3293
+ ],
3294
+ "options": []
3295
+ },
3296
+ {
3297
+ "path": [
3298
+ "connection"
3299
+ ],
3300
+ "name": "connection",
3301
+ "aliases": [],
3302
+ "description": "Manage OAuth connections",
3303
+ "hidden": false,
3304
+ "arguments": [],
3305
+ "options": [
3306
+ {
3307
+ "flags": "-h, --help",
3308
+ "long": "--help",
3309
+ "short": "-h",
3310
+ "description": "display help for command",
3311
+ "required": false,
3312
+ "value_required": false,
3313
+ "value_optional": false,
3314
+ "variadic": false,
3315
+ "negated": false,
3316
+ "hidden": false
3317
+ }
3318
+ ]
3319
+ },
3320
+ {
3321
+ "path": [
3322
+ "connection",
3323
+ "list"
3324
+ ],
3325
+ "name": "list",
3326
+ "aliases": [],
3327
+ "description": "List OAuth connections in the active workspace",
3328
+ "hidden": false,
3329
+ "arguments": [],
3330
+ "options": [
3331
+ {
3332
+ "flags": "-h, --help",
3333
+ "long": "--help",
3334
+ "short": "-h",
3335
+ "description": "display help for command",
3336
+ "required": false,
3337
+ "value_required": false,
3338
+ "value_optional": false,
3339
+ "variadic": false,
3340
+ "negated": false,
3341
+ "hidden": false
3342
+ }
3343
+ ]
3344
+ },
3345
+ {
3346
+ "path": [
3347
+ "connection",
3348
+ "help"
3349
+ ],
3350
+ "name": "help",
3351
+ "aliases": [],
3352
+ "description": "display help for command",
3353
+ "hidden": false,
3354
+ "arguments": [
3355
+ {
3356
+ "name": "command",
3357
+ "required": false,
3358
+ "variadic": false,
3359
+ "description": ""
3360
+ }
3361
+ ],
3362
+ "options": []
3363
+ },
3364
+ {
3365
+ "path": [
3366
+ "ai"
3367
+ ],
3368
+ "name": "ai",
3369
+ "aliases": [],
3370
+ "description": "AI helper tools",
3371
+ "hidden": false,
3372
+ "arguments": [],
3373
+ "options": [
3374
+ {
3375
+ "flags": "-h, --help",
3376
+ "long": "--help",
3377
+ "short": "-h",
3378
+ "description": "display help for command",
3379
+ "required": false,
3380
+ "value_required": false,
3381
+ "value_optional": false,
3382
+ "variadic": false,
3383
+ "negated": false,
3384
+ "hidden": false
3385
+ }
3386
+ ]
3387
+ },
3388
+ {
3389
+ "path": [
3390
+ "ai",
3391
+ "init"
3392
+ ],
3393
+ "name": "init",
3394
+ "aliases": [],
3395
+ "description": "Install SolidActions AI skills and SDK reference for AI-assisted development",
3396
+ "hidden": false,
3397
+ "arguments": [],
3398
+ "options": [
3399
+ {
3400
+ "flags": "--claude",
3401
+ "long": "--claude",
3402
+ "short": null,
3403
+ "description": "Use CLAUDE.md (for Claude Code)",
3404
+ "required": false,
3405
+ "value_required": false,
3406
+ "value_optional": false,
3407
+ "variadic": false,
3408
+ "negated": false,
3409
+ "hidden": false
3410
+ },
3411
+ {
3412
+ "flags": "--agents",
3413
+ "long": "--agents",
3414
+ "short": null,
3415
+ "description": "Use AGENTS.md (for Codex, Cursor, Gemini, Windsurf, etc.)",
3416
+ "required": false,
3417
+ "value_required": false,
3418
+ "value_optional": false,
3419
+ "variadic": false,
3420
+ "negated": false,
3421
+ "hidden": false
3422
+ },
3423
+ {
3424
+ "flags": "-h, --help",
3425
+ "long": "--help",
3426
+ "short": "-h",
3427
+ "description": "display help for command",
3428
+ "required": false,
3429
+ "value_required": false,
3430
+ "value_optional": false,
3431
+ "variadic": false,
3432
+ "negated": false,
3433
+ "hidden": false
3434
+ }
3435
+ ]
3436
+ },
3437
+ {
3438
+ "path": [
3439
+ "ai",
3440
+ "examples"
3441
+ ],
3442
+ "name": "examples",
3443
+ "aliases": [],
3444
+ "description": "Install example workflows for AI reference",
3445
+ "hidden": false,
3446
+ "arguments": [
3447
+ {
3448
+ "name": "names",
3449
+ "required": false,
3450
+ "variadic": true,
3451
+ "description": "Example names to install (omit for interactive selector)"
3452
+ }
3453
+ ],
3454
+ "options": [
3455
+ {
3456
+ "flags": "--all",
3457
+ "long": "--all",
3458
+ "short": null,
3459
+ "description": "Install all available examples",
3460
+ "required": false,
3461
+ "value_required": false,
3462
+ "value_optional": false,
3463
+ "variadic": false,
3464
+ "negated": false,
3465
+ "hidden": false
3466
+ },
3467
+ {
3468
+ "flags": "--overwrite",
3469
+ "long": "--overwrite",
3470
+ "short": null,
3471
+ "description": "Overwrite existing examples without warning",
3472
+ "required": false,
3473
+ "value_required": false,
3474
+ "value_optional": false,
3475
+ "variadic": false,
3476
+ "negated": false,
3477
+ "hidden": false
3478
+ },
3479
+ {
3480
+ "flags": "-h, --help",
3481
+ "long": "--help",
3482
+ "short": "-h",
3483
+ "description": "display help for command",
3484
+ "required": false,
3485
+ "value_required": false,
3486
+ "value_optional": false,
3487
+ "variadic": false,
3488
+ "negated": false,
3489
+ "hidden": false
3490
+ }
3491
+ ]
3492
+ },
3493
+ {
3494
+ "path": [
3495
+ "ai",
3496
+ "help"
3497
+ ],
3498
+ "name": "help",
3499
+ "aliases": [],
3500
+ "description": "display help for command",
3501
+ "hidden": false,
3502
+ "arguments": [
3503
+ {
3504
+ "name": "command",
3505
+ "required": false,
3506
+ "variadic": false,
3507
+ "description": ""
3508
+ }
3509
+ ],
3510
+ "options": []
3511
+ },
3512
+ {
3513
+ "path": [
3514
+ "skill"
3515
+ ],
3516
+ "name": "skill",
3517
+ "aliases": [],
3518
+ "description": "Manage agent skills (crews SOP surface)",
3519
+ "hidden": false,
3520
+ "arguments": [],
3521
+ "options": [
3522
+ {
3523
+ "flags": "-h, --help",
3524
+ "long": "--help",
3525
+ "short": "-h",
3526
+ "description": "display help for command",
3527
+ "required": false,
3528
+ "value_required": false,
3529
+ "value_optional": false,
3530
+ "variadic": false,
3531
+ "negated": false,
3532
+ "hidden": false
3533
+ }
3534
+ ]
3535
+ },
3536
+ {
3537
+ "path": [
3538
+ "skill",
3539
+ "push"
3540
+ ],
3541
+ "name": "push",
3542
+ "aliases": [],
3543
+ "description": "Push a local skill folder into the library (create, or update if it already exists)",
3544
+ "hidden": false,
3545
+ "arguments": [
3546
+ {
3547
+ "name": "dir",
3548
+ "required": true,
3549
+ "variadic": false,
3550
+ "description": "Path to the skill directory (must contain SKILL.md)"
3551
+ }
3552
+ ],
3553
+ "options": [
3554
+ {
3555
+ "flags": "--role <name>",
3556
+ "long": "--role",
3557
+ "short": null,
3558
+ "description": "Scope the skill to a role instead of the shared library",
3559
+ "required": false,
3560
+ "value_required": true,
3561
+ "value_optional": false,
3562
+ "variadic": false,
3563
+ "negated": false,
3564
+ "hidden": false
3565
+ },
3566
+ {
3567
+ "flags": "--json",
3568
+ "long": "--json",
3569
+ "short": null,
3570
+ "description": "Output result as JSON",
3571
+ "required": false,
3572
+ "value_required": false,
3573
+ "value_optional": false,
3574
+ "variadic": false,
3575
+ "negated": false,
3576
+ "hidden": false
3577
+ },
3578
+ {
3579
+ "flags": "--dry-run",
3580
+ "long": "--dry-run",
3581
+ "short": null,
3582
+ "description": "Preview create vs update without writing",
3583
+ "required": false,
3584
+ "value_required": false,
3585
+ "value_optional": false,
3586
+ "variadic": false,
3587
+ "negated": false,
3588
+ "hidden": false
3589
+ },
3590
+ {
3591
+ "flags": "--publish",
3592
+ "long": "--publish",
3593
+ "short": null,
3594
+ "description": "Publish (snapshot) the skill after pushing, making it live for agents",
3595
+ "required": false,
3596
+ "value_required": false,
3597
+ "value_optional": false,
3598
+ "variadic": false,
3599
+ "negated": false,
3600
+ "hidden": false
3601
+ },
3602
+ {
3603
+ "flags": "--force",
3604
+ "long": "--force",
3605
+ "short": null,
3606
+ "description": "Skip the drift guard: push without checking the remote against your local sidecar revision",
3607
+ "required": false,
3608
+ "value_required": false,
3609
+ "value_optional": false,
3610
+ "variadic": false,
3611
+ "negated": false,
3612
+ "hidden": false
3613
+ },
3614
+ {
3615
+ "flags": "-h, --help",
3616
+ "long": "--help",
3617
+ "short": "-h",
3618
+ "description": "display help for command",
3619
+ "required": false,
3620
+ "value_required": false,
3621
+ "value_optional": false,
3622
+ "variadic": false,
3623
+ "negated": false,
3624
+ "hidden": false
3625
+ }
3626
+ ]
3627
+ },
3628
+ {
3629
+ "path": [
3630
+ "skill",
3631
+ "publish"
3632
+ ],
3633
+ "name": "publish",
3634
+ "aliases": [],
3635
+ "description": "Publish (snapshot) a skill so its latest pushed revision goes live for agents",
3636
+ "hidden": false,
3637
+ "arguments": [
3638
+ {
3639
+ "name": "name",
3640
+ "required": true,
3641
+ "variadic": false,
3642
+ "description": "Skill name/identifier (e.g. \"my-skill\" or \"shared/my-skill\")"
3643
+ }
3644
+ ],
3645
+ "options": [
3646
+ {
3647
+ "flags": "--json",
3648
+ "long": "--json",
3649
+ "short": null,
3650
+ "description": "Output result as JSON",
3651
+ "required": false,
3652
+ "value_required": false,
3653
+ "value_optional": false,
3654
+ "variadic": false,
3655
+ "negated": false,
3656
+ "hidden": false
3657
+ },
3658
+ {
3659
+ "flags": "-h, --help",
3660
+ "long": "--help",
3661
+ "short": "-h",
3662
+ "description": "display help for command",
3663
+ "required": false,
3664
+ "value_required": false,
3665
+ "value_optional": false,
3666
+ "variadic": false,
3667
+ "negated": false,
3668
+ "hidden": false
3669
+ }
3670
+ ]
3671
+ },
3672
+ {
3673
+ "path": [
3674
+ "skill",
3675
+ "pull"
3676
+ ],
3677
+ "name": "pull",
3678
+ "aliases": [],
3679
+ "description": "Fetch a skill from the library to a local folder for editing (inverse of push)",
3680
+ "hidden": false,
3681
+ "arguments": [
3682
+ {
3683
+ "name": "name",
3684
+ "required": true,
3685
+ "variadic": false,
3686
+ "description": "Skill name or identifier"
3687
+ },
3688
+ {
3689
+ "name": "dest",
3690
+ "required": false,
3691
+ "variadic": false,
3692
+ "description": "Destination directory (defaults to ./<name>/)"
3693
+ }
3694
+ ],
3695
+ "options": [
3696
+ {
3697
+ "flags": "--json",
3698
+ "long": "--json",
3699
+ "short": null,
3700
+ "description": "Output raw read result as JSON (no file writes)",
3701
+ "required": false,
3702
+ "value_required": false,
3703
+ "value_optional": false,
3704
+ "variadic": false,
3705
+ "negated": false,
3706
+ "hidden": false
3707
+ },
3708
+ {
3709
+ "flags": "-h, --help",
3710
+ "long": "--help",
3711
+ "short": "-h",
3712
+ "description": "display help for command",
3713
+ "required": false,
3714
+ "value_required": false,
3715
+ "value_optional": false,
3716
+ "variadic": false,
3717
+ "negated": false,
3718
+ "hidden": false
3719
+ }
3720
+ ]
3721
+ },
3722
+ {
3723
+ "path": [
3724
+ "skill",
3725
+ "list"
3726
+ ],
3727
+ "name": "list",
3728
+ "aliases": [],
3729
+ "description": "List skills in the library",
3730
+ "hidden": false,
3731
+ "arguments": [],
3732
+ "options": [
3733
+ {
3734
+ "flags": "--json",
3735
+ "long": "--json",
3736
+ "short": null,
3737
+ "description": "Output as JSON",
3738
+ "required": false,
3739
+ "value_required": false,
3740
+ "value_optional": false,
3741
+ "variadic": false,
3742
+ "negated": false,
3743
+ "hidden": false
3744
+ },
3745
+ {
3746
+ "flags": "--limit <n>",
3747
+ "long": "--limit",
3748
+ "short": null,
3749
+ "description": "Maximum number of skills to return",
3750
+ "required": false,
3751
+ "value_required": true,
3752
+ "value_optional": false,
3753
+ "variadic": false,
3754
+ "negated": false,
3755
+ "hidden": false
3756
+ },
3757
+ {
3758
+ "flags": "-h, --help",
3759
+ "long": "--help",
3760
+ "short": "-h",
3761
+ "description": "display help for command",
3762
+ "required": false,
3763
+ "value_required": false,
3764
+ "value_optional": false,
3765
+ "variadic": false,
3766
+ "negated": false,
3767
+ "hidden": false
3768
+ }
3769
+ ]
3770
+ },
3771
+ {
3772
+ "path": [
3773
+ "skill",
3774
+ "view"
3775
+ ],
3776
+ "name": "view",
3777
+ "aliases": [],
3778
+ "description": "Show one skill",
3779
+ "hidden": false,
3780
+ "arguments": [
3781
+ {
3782
+ "name": "name",
3783
+ "required": true,
3784
+ "variadic": false,
3785
+ "description": ""
3786
+ }
3787
+ ],
3788
+ "options": [
3789
+ {
3790
+ "flags": "--json",
3791
+ "long": "--json",
3792
+ "short": null,
3793
+ "description": "Output as JSON",
3794
+ "required": false,
3795
+ "value_required": false,
3796
+ "value_optional": false,
3797
+ "variadic": false,
3798
+ "negated": false,
3799
+ "hidden": false
3800
+ },
3801
+ {
3802
+ "flags": "-h, --help",
3803
+ "long": "--help",
3804
+ "short": "-h",
3805
+ "description": "display help for command",
3806
+ "required": false,
3807
+ "value_required": false,
3808
+ "value_optional": false,
3809
+ "variadic": false,
3810
+ "negated": false,
3811
+ "hidden": false
3812
+ }
3813
+ ]
3814
+ },
3815
+ {
3816
+ "path": [
3817
+ "skill",
3818
+ "delete"
3819
+ ],
3820
+ "name": "delete",
3821
+ "aliases": [],
3822
+ "description": "Delete a skill (Admin only)",
3823
+ "hidden": false,
3824
+ "arguments": [
3825
+ {
3826
+ "name": "name",
3827
+ "required": true,
3828
+ "variadic": false,
3829
+ "description": ""
3830
+ }
3831
+ ],
3832
+ "options": [
3833
+ {
3834
+ "flags": "--json",
3835
+ "long": "--json",
3836
+ "short": null,
3837
+ "description": "Output as JSON",
3838
+ "required": false,
3839
+ "value_required": false,
3840
+ "value_optional": false,
3841
+ "variadic": false,
3842
+ "negated": false,
3843
+ "hidden": false
3844
+ },
3845
+ {
3846
+ "flags": "-h, --help",
3847
+ "long": "--help",
3848
+ "short": "-h",
3849
+ "description": "display help for command",
3850
+ "required": false,
3851
+ "value_required": false,
3852
+ "value_optional": false,
3853
+ "variadic": false,
3854
+ "negated": false,
3855
+ "hidden": false
3856
+ }
3857
+ ]
3858
+ },
3859
+ {
3860
+ "path": [
3861
+ "skill",
3862
+ "dev"
3863
+ ],
3864
+ "name": "dev",
3865
+ "aliases": [],
3866
+ "description": "Run YOUR WORKING COPY of a skill locally with crew variables fetched from the platform (dev loop; default env dev; secrets need env:reveal). To execute the server-stored skill instead: skill exec <name> --target sandbox|host",
3867
+ "hidden": false,
3868
+ "arguments": [
3869
+ {
3870
+ "name": "dir",
3871
+ "required": true,
3872
+ "variadic": false,
3873
+ "description": "Local skill directory (must contain SKILL.md)"
3874
+ },
3875
+ {
3876
+ "name": "command",
3877
+ "required": true,
3878
+ "variadic": true,
3879
+ "description": "Command to run (after --), e.g. -- node scripts/q.js"
3880
+ }
3881
+ ],
3882
+ "options": [
3883
+ {
3884
+ "flags": "--crew <nameOrId>",
3885
+ "long": "--crew",
3886
+ "short": null,
3887
+ "description": "Crew whose variables to fetch (omit for shared skills)",
3888
+ "required": false,
3889
+ "value_required": true,
3890
+ "value_optional": false,
3891
+ "variadic": false,
3892
+ "negated": false,
3893
+ "hidden": false
3894
+ },
3895
+ {
3896
+ "flags": "--environment <env>",
3897
+ "long": "--environment",
3898
+ "short": null,
3899
+ "description": "Variable environment: production|staging|dev",
3900
+ "required": false,
3901
+ "value_required": true,
3902
+ "value_optional": false,
3903
+ "variadic": false,
3904
+ "negated": false,
3905
+ "hidden": false,
3906
+ "default": "dev"
3907
+ },
3908
+ {
3909
+ "flags": "--env-file <path>",
3910
+ "long": "--env-file",
3911
+ "short": null,
3912
+ "description": "Local KEY=VALUE overrides (reserved names ignored)",
3913
+ "required": false,
3914
+ "value_required": true,
3915
+ "value_optional": false,
3916
+ "variadic": false,
3917
+ "negated": false,
3918
+ "hidden": false
3919
+ },
3920
+ {
3921
+ "flags": "-h, --help",
3922
+ "long": "--help",
3923
+ "short": "-h",
3924
+ "description": "display help for command",
3925
+ "required": false,
3926
+ "value_required": false,
3927
+ "value_optional": false,
3928
+ "variadic": false,
3929
+ "negated": false,
3930
+ "hidden": false
3931
+ }
3932
+ ]
3933
+ },
3934
+ {
3935
+ "path": [
3936
+ "skill",
3937
+ "run"
3938
+ ],
3939
+ "name": "run",
3940
+ "aliases": [],
3941
+ "description": "[deprecated] alias of `skill dev` — removed in v2.0.0",
3942
+ "hidden": true,
3943
+ "arguments": [
3944
+ {
3945
+ "name": "dir",
3946
+ "required": true,
3947
+ "variadic": false,
3948
+ "description": "Local skill directory (must contain SKILL.md)"
3949
+ },
3950
+ {
3951
+ "name": "command",
3952
+ "required": true,
3953
+ "variadic": true,
3954
+ "description": "Command to run (after --)"
3955
+ }
3956
+ ],
3957
+ "options": [
3958
+ {
3959
+ "flags": "--crew <nameOrId>",
3960
+ "long": "--crew",
3961
+ "short": null,
3962
+ "description": "Crew whose variables to fetch (omit for shared skills)",
3963
+ "required": false,
3964
+ "value_required": true,
3965
+ "value_optional": false,
3966
+ "variadic": false,
3967
+ "negated": false,
3968
+ "hidden": false
3969
+ },
3970
+ {
3971
+ "flags": "--environment <env>",
3972
+ "long": "--environment",
3973
+ "short": null,
3974
+ "description": "Variable environment: production|staging|dev",
3975
+ "required": false,
3976
+ "value_required": true,
3977
+ "value_optional": false,
3978
+ "variadic": false,
3979
+ "negated": false,
3980
+ "hidden": false,
3981
+ "default": "dev"
3982
+ },
3983
+ {
3984
+ "flags": "--env-file <path>",
3985
+ "long": "--env-file",
3986
+ "short": null,
3987
+ "description": "Local KEY=VALUE overrides (reserved names ignored)",
3988
+ "required": false,
3989
+ "value_required": true,
3990
+ "value_optional": false,
3991
+ "variadic": false,
3992
+ "negated": false,
3993
+ "hidden": false
3994
+ },
3995
+ {
3996
+ "flags": "-h, --help",
3997
+ "long": "--help",
3998
+ "short": "-h",
3999
+ "description": "display help for command",
4000
+ "required": false,
4001
+ "value_required": false,
4002
+ "value_optional": false,
4003
+ "variadic": false,
4004
+ "negated": false,
4005
+ "hidden": false
4006
+ }
4007
+ ]
4008
+ },
4009
+ {
4010
+ "path": [
4011
+ "skill",
4012
+ "exec"
4013
+ ],
4014
+ "name": "exec",
4015
+ "aliases": [],
4016
+ "description": "Execute the SERVER-STORED skill (never local edits — see `skill dev`). --target picks where: sandbox (server) or host (this machine, transparent cache). Default env production for both targets; secrets on host need env:reveal",
4017
+ "hidden": false,
4018
+ "arguments": [
4019
+ {
4020
+ "name": "name",
4021
+ "required": true,
4022
+ "variadic": false,
4023
+ "description": "Skill name or identifier (names only — directories are rejected)"
4024
+ },
4025
+ {
4026
+ "name": "command",
4027
+ "required": true,
4028
+ "variadic": true,
4029
+ "description": "Command to run (after --), e.g. -- node scripts/q.js"
4030
+ }
4031
+ ],
4032
+ "options": [
4033
+ {
4034
+ "flags": "--target <target>",
4035
+ "long": "--target",
4036
+ "short": null,
4037
+ "description": "Where to execute: 'sandbox' or 'host'",
4038
+ "required": true,
4039
+ "value_required": true,
4040
+ "value_optional": false,
4041
+ "variadic": false,
4042
+ "negated": false,
4043
+ "hidden": false
4044
+ },
4045
+ {
4046
+ "flags": "--role <name>",
4047
+ "long": "--role",
4048
+ "short": null,
4049
+ "description": "Role-scoped skill (crew inferred from the role)",
4050
+ "required": false,
4051
+ "value_required": true,
4052
+ "value_optional": false,
4053
+ "variadic": false,
4054
+ "negated": false,
4055
+ "hidden": false
4056
+ },
4057
+ {
4058
+ "flags": "--in-crew <crew>",
4059
+ "long": "--in-crew",
4060
+ "short": null,
4061
+ "description": "Disambiguate when the role name exists in multiple crews",
4062
+ "required": false,
4063
+ "value_required": true,
4064
+ "value_optional": false,
4065
+ "variadic": false,
4066
+ "negated": false,
4067
+ "hidden": false
4068
+ },
4069
+ {
4070
+ "flags": "--crew <nameOrId>",
4071
+ "long": "--crew",
4072
+ "short": null,
4073
+ "description": "host+shared only: crew whose variables to fetch",
4074
+ "required": false,
4075
+ "value_required": true,
4076
+ "value_optional": false,
4077
+ "variadic": false,
4078
+ "negated": false,
4079
+ "hidden": false
4080
+ },
4081
+ {
4082
+ "flags": "--environment <env>",
4083
+ "long": "--environment",
4084
+ "short": null,
4085
+ "description": "Variable environment: production|staging|dev (default production)",
4086
+ "required": false,
4087
+ "value_required": true,
4088
+ "value_optional": false,
4089
+ "variadic": false,
4090
+ "negated": false,
4091
+ "hidden": false
4092
+ },
4093
+ {
4094
+ "flags": "--env-file <path>",
4095
+ "long": "--env-file",
4096
+ "short": null,
4097
+ "description": "host only: local KEY=VALUE overrides (reserved names ignored)",
4098
+ "required": false,
4099
+ "value_required": true,
4100
+ "value_optional": false,
4101
+ "variadic": false,
4102
+ "negated": false,
4103
+ "hidden": false
4104
+ },
4105
+ {
4106
+ "flags": "-h, --help",
4107
+ "long": "--help",
4108
+ "short": "-h",
4109
+ "description": "display help for command",
4110
+ "required": false,
4111
+ "value_required": false,
4112
+ "value_optional": false,
4113
+ "variadic": false,
4114
+ "negated": false,
4115
+ "hidden": false
4116
+ }
4117
+ ]
4118
+ },
4119
+ {
4120
+ "path": [
4121
+ "skill",
4122
+ "help"
4123
+ ],
4124
+ "name": "help",
4125
+ "aliases": [],
4126
+ "description": "display help for command",
4127
+ "hidden": false,
4128
+ "arguments": [
4129
+ {
4130
+ "name": "command",
4131
+ "required": false,
4132
+ "variadic": false,
4133
+ "description": ""
4134
+ }
4135
+ ],
4136
+ "options": []
4137
+ },
4138
+ {
4139
+ "path": [
4140
+ "role"
4141
+ ],
4142
+ "name": "role",
4143
+ "aliases": [],
4144
+ "description": "Manage roles (crews SOP surface)",
4145
+ "hidden": false,
4146
+ "arguments": [],
4147
+ "options": [
4148
+ {
4149
+ "flags": "-h, --help",
4150
+ "long": "--help",
4151
+ "short": "-h",
4152
+ "description": "display help for command",
4153
+ "required": false,
4154
+ "value_required": false,
4155
+ "value_optional": false,
4156
+ "variadic": false,
4157
+ "negated": false,
4158
+ "hidden": false
4159
+ }
4160
+ ]
4161
+ },
4162
+ {
4163
+ "path": [
4164
+ "role",
4165
+ "push"
4166
+ ],
4167
+ "name": "push",
4168
+ "aliases": [],
4169
+ "description": "Push a role definition (create or update)",
4170
+ "hidden": false,
4171
+ "arguments": [
4172
+ {
4173
+ "name": "dir",
4174
+ "required": true,
4175
+ "variadic": false,
4176
+ "description": ""
4177
+ }
4178
+ ],
4179
+ "options": [
4180
+ {
4181
+ "flags": "--dry-run",
4182
+ "long": "--dry-run",
4183
+ "short": null,
4184
+ "description": "Preview create vs update without writing",
4185
+ "required": false,
4186
+ "value_required": false,
4187
+ "value_optional": false,
4188
+ "variadic": false,
4189
+ "negated": false,
4190
+ "hidden": false
4191
+ },
4192
+ {
4193
+ "flags": "--json",
4194
+ "long": "--json",
4195
+ "short": null,
4196
+ "description": "Output result as JSON",
4197
+ "required": false,
4198
+ "value_required": false,
4199
+ "value_optional": false,
4200
+ "variadic": false,
4201
+ "negated": false,
4202
+ "hidden": false
4203
+ },
4204
+ {
4205
+ "flags": "-h, --help",
4206
+ "long": "--help",
4207
+ "short": "-h",
4208
+ "description": "display help for command",
4209
+ "required": false,
4210
+ "value_required": false,
4211
+ "value_optional": false,
4212
+ "variadic": false,
4213
+ "negated": false,
4214
+ "hidden": false
4215
+ }
4216
+ ]
4217
+ },
4218
+ {
4219
+ "path": [
4220
+ "role",
4221
+ "help"
4222
+ ],
4223
+ "name": "help",
4224
+ "aliases": [],
4225
+ "description": "display help for command",
4226
+ "hidden": false,
4227
+ "arguments": [
4228
+ {
4229
+ "name": "command",
4230
+ "required": false,
4231
+ "variadic": false,
4232
+ "description": ""
4233
+ }
4234
+ ],
4235
+ "options": []
4236
+ },
4237
+ {
4238
+ "path": [
4239
+ "doc"
4240
+ ],
4241
+ "name": "doc",
4242
+ "aliases": [],
4243
+ "description": "Manage docs in SA-Docs",
4244
+ "hidden": false,
4245
+ "arguments": [],
4246
+ "options": [
4247
+ {
4248
+ "flags": "-h, --help",
4249
+ "long": "--help",
4250
+ "short": "-h",
4251
+ "description": "display help for command",
4252
+ "required": false,
4253
+ "value_required": false,
4254
+ "value_optional": false,
4255
+ "variadic": false,
4256
+ "negated": false,
4257
+ "hidden": false
4258
+ }
4259
+ ]
4260
+ },
4261
+ {
4262
+ "path": [
4263
+ "doc",
4264
+ "push"
4265
+ ],
4266
+ "name": "push",
4267
+ "aliases": [],
4268
+ "description": "Recursively upload a local markdown tree into SA-Docs",
4269
+ "hidden": false,
4270
+ "arguments": [
4271
+ {
4272
+ "name": "dir",
4273
+ "required": true,
4274
+ "variadic": false,
4275
+ "description": "Path to the directory containing markdown files"
4276
+ }
4277
+ ],
4278
+ "options": [
4279
+ {
4280
+ "flags": "--on-conflict <mode>",
4281
+ "long": "--on-conflict",
4282
+ "short": null,
4283
+ "description": "Conflict resolution: skip|overwrite|rename (default: skip)",
4284
+ "required": false,
4285
+ "value_required": true,
4286
+ "value_optional": false,
4287
+ "variadic": false,
4288
+ "negated": false,
4289
+ "hidden": false,
4290
+ "default": "skip"
4291
+ },
4292
+ {
4293
+ "flags": "--type <slug>",
4294
+ "long": "--type",
4295
+ "short": null,
4296
+ "description": "Doc-type slug to apply to all uploaded docs",
4297
+ "required": false,
4298
+ "value_required": true,
4299
+ "value_optional": false,
4300
+ "variadic": false,
4301
+ "negated": false,
4302
+ "hidden": false
4303
+ },
4304
+ {
4305
+ "flags": "--folder <base>",
4306
+ "long": "--folder",
4307
+ "short": null,
4308
+ "description": "Nest the whole upload under this base folder path in SA-Docs",
4309
+ "required": false,
4310
+ "value_required": true,
4311
+ "value_optional": false,
4312
+ "variadic": false,
4313
+ "negated": false,
4314
+ "hidden": false
4315
+ },
4316
+ {
4317
+ "flags": "--dry-run",
4318
+ "long": "--dry-run",
4319
+ "short": null,
4320
+ "description": "Preview what would be created without writing",
4321
+ "required": false,
4322
+ "value_required": false,
4323
+ "value_optional": false,
4324
+ "variadic": false,
4325
+ "negated": false,
4326
+ "hidden": false
4327
+ },
4328
+ {
4329
+ "flags": "--force",
4330
+ "long": "--force",
4331
+ "short": null,
4332
+ "description": "Overwrite tracked docs (from a prior doc pull) without a base-revision drift guard",
4333
+ "required": false,
4334
+ "value_required": false,
4335
+ "value_optional": false,
4336
+ "variadic": false,
4337
+ "negated": false,
4338
+ "hidden": false
4339
+ },
4340
+ {
4341
+ "flags": "--json",
4342
+ "long": "--json",
4343
+ "short": null,
4344
+ "description": "Output result as JSON",
4345
+ "required": false,
4346
+ "value_required": false,
4347
+ "value_optional": false,
4348
+ "variadic": false,
4349
+ "negated": false,
4350
+ "hidden": false
4351
+ },
4352
+ {
4353
+ "flags": "-h, --help",
4354
+ "long": "--help",
4355
+ "short": "-h",
4356
+ "description": "display help for command",
4357
+ "required": false,
4358
+ "value_required": false,
4359
+ "value_optional": false,
4360
+ "variadic": false,
4361
+ "negated": false,
4362
+ "hidden": false
4363
+ }
4364
+ ]
4365
+ },
4366
+ {
4367
+ "path": [
4368
+ "doc",
4369
+ "pull"
4370
+ ],
4371
+ "name": "pull",
4372
+ "aliases": [],
4373
+ "description": "Download a Docs folder tree to a local directory for editing (inverse of push)",
4374
+ "hidden": false,
4375
+ "arguments": [
4376
+ {
4377
+ "name": "folder",
4378
+ "required": true,
4379
+ "variadic": false,
4380
+ "description": "Docs folder path (or a single doc path)"
4381
+ },
4382
+ {
4383
+ "name": "dest",
4384
+ "required": false,
4385
+ "variadic": false,
4386
+ "description": "Destination directory (defaults to ./<last-segment>/)"
4387
+ }
4388
+ ],
4389
+ "options": [
4390
+ {
4391
+ "flags": "-y, --yes",
4392
+ "long": "--yes",
4393
+ "short": "-y",
4394
+ "description": "Overwrite a non-empty destination without confirmation",
4395
+ "required": false,
4396
+ "value_required": false,
4397
+ "value_optional": false,
4398
+ "variadic": false,
4399
+ "negated": false,
4400
+ "hidden": false
4401
+ },
4402
+ {
4403
+ "flags": "--overwrite",
4404
+ "long": "--overwrite",
4405
+ "short": null,
4406
+ "description": "DESTRUCTIVE: discard unpushed local changes (tracked files whose content no longer matches the last pull) and overwrite them; implies --yes",
4407
+ "required": false,
4408
+ "value_required": false,
4409
+ "value_optional": false,
4410
+ "variadic": false,
4411
+ "negated": false,
4412
+ "hidden": false
4413
+ },
4414
+ {
4415
+ "flags": "--json",
4416
+ "long": "--json",
4417
+ "short": null,
4418
+ "description": "Machine-readable output",
4419
+ "required": false,
4420
+ "value_required": false,
4421
+ "value_optional": false,
4422
+ "variadic": false,
4423
+ "negated": false,
4424
+ "hidden": false
4425
+ },
4426
+ {
4427
+ "flags": "-h, --help",
4428
+ "long": "--help",
4429
+ "short": "-h",
4430
+ "description": "display help for command",
4431
+ "required": false,
4432
+ "value_required": false,
4433
+ "value_optional": false,
4434
+ "variadic": false,
4435
+ "negated": false,
4436
+ "hidden": false
4437
+ }
4438
+ ]
4439
+ },
4440
+ {
4441
+ "path": [
4442
+ "doc",
4443
+ "upload"
4444
+ ],
4445
+ "name": "upload",
4446
+ "aliases": [],
4447
+ "description": "Upload one or more media files to SA-Docs (requires a token with the \"docs\" ability)",
4448
+ "hidden": false,
4449
+ "arguments": [
4450
+ {
4451
+ "name": "files",
4452
+ "required": true,
4453
+ "variadic": true,
4454
+ "description": ""
4455
+ }
4456
+ ],
4457
+ "options": [
4458
+ {
4459
+ "flags": "--folder <path>",
4460
+ "long": "--folder",
4461
+ "short": null,
4462
+ "description": "Folder path to upload into (auto-created if missing)",
4463
+ "required": false,
4464
+ "value_required": true,
4465
+ "value_optional": false,
4466
+ "variadic": false,
4467
+ "negated": false,
4468
+ "hidden": false
4469
+ },
4470
+ {
4471
+ "flags": "--title <title>",
4472
+ "long": "--title",
4473
+ "short": null,
4474
+ "description": "Title for the uploaded doc (only valid with a single file)",
4475
+ "required": false,
4476
+ "value_required": true,
4477
+ "value_optional": false,
4478
+ "variadic": false,
4479
+ "negated": false,
4480
+ "hidden": false
4481
+ },
4482
+ {
4483
+ "flags": "--replace <doc-id-or-path>",
4484
+ "long": "--replace",
4485
+ "short": null,
4486
+ "description": "replace the bytes of an existing media doc (by id, or by docs path)",
4487
+ "required": false,
4488
+ "value_required": true,
4489
+ "value_optional": false,
4490
+ "variadic": false,
4491
+ "negated": false,
4492
+ "hidden": false
4493
+ },
4494
+ {
4495
+ "flags": "-h, --help",
4496
+ "long": "--help",
4497
+ "short": "-h",
4498
+ "description": "display help for command",
4499
+ "required": false,
4500
+ "value_required": false,
4501
+ "value_optional": false,
4502
+ "variadic": false,
4503
+ "negated": false,
4504
+ "hidden": false
4505
+ }
4506
+ ]
4507
+ },
4508
+ {
4509
+ "path": [
4510
+ "doc",
4511
+ "help"
4512
+ ],
4513
+ "name": "help",
4514
+ "aliases": [],
4515
+ "description": "display help for command",
4516
+ "hidden": false,
4517
+ "arguments": [
4518
+ {
4519
+ "name": "command",
4520
+ "required": false,
4521
+ "variadic": false,
4522
+ "description": ""
4523
+ }
4524
+ ],
4525
+ "options": []
4526
+ },
4527
+ {
4528
+ "path": [
4529
+ "help"
4530
+ ],
4531
+ "name": "help",
4532
+ "aliases": [],
4533
+ "description": "display help for command",
4534
+ "hidden": false,
4535
+ "arguments": [
4536
+ {
4537
+ "name": "command",
4538
+ "required": false,
4539
+ "variadic": false,
4540
+ "description": ""
4541
+ }
4542
+ ],
4543
+ "options": []
4544
+ }
4545
+ ]
4546
+ }