@factorialco/fcode-cli 2.4.0 → 3.0.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.
Files changed (114) hide show
  1. package/README.md +331 -118
  2. package/dist/commands/clone.d.ts +0 -12
  3. package/dist/commands/clone.js +22 -135
  4. package/dist/commands/{settings → config}/get.d.ts +1 -1
  5. package/dist/commands/{settings → config}/get.js +7 -7
  6. package/dist/commands/{settings → config}/remove.d.ts +1 -1
  7. package/dist/commands/{settings → config}/remove.js +6 -6
  8. package/dist/commands/{settings → config}/set.d.ts +1 -1
  9. package/dist/commands/{settings → config}/set.js +8 -8
  10. package/dist/commands/dependencies/diff.d.ts +9 -0
  11. package/dist/commands/dependencies/diff.js +15 -0
  12. package/dist/commands/dependencies/pull.d.ts +9 -0
  13. package/dist/commands/dependencies/pull.js +44 -1
  14. package/dist/commands/diff.d.ts +12 -0
  15. package/dist/commands/diff.js +48 -0
  16. package/dist/commands/http.d.ts +1 -1
  17. package/dist/commands/http.js +7 -7
  18. package/dist/commands/i18n/diff.d.ts +9 -0
  19. package/dist/commands/i18n/diff.js +15 -0
  20. package/dist/commands/i18n/status.d.ts +3 -0
  21. package/dist/commands/i18n/status.js +1 -0
  22. package/dist/commands/modules/diff.d.ts +9 -0
  23. package/dist/commands/modules/diff.js +15 -0
  24. package/dist/commands/modules/status.d.ts +3 -0
  25. package/dist/commands/modules/status.js +1 -0
  26. package/dist/commands/processes/diff.d.ts +9 -0
  27. package/dist/commands/processes/diff.js +15 -0
  28. package/dist/commands/processes/status.d.ts +3 -0
  29. package/dist/commands/processes/status.js +1 -0
  30. package/dist/commands/pull.js +2 -2
  31. package/dist/commands/push.js +2 -2
  32. package/dist/commands/{team → settings}/aliases/delete.d.ts +1 -1
  33. package/dist/commands/{team → settings}/aliases/delete.js +6 -6
  34. package/dist/commands/{team → settings}/aliases/list.d.ts +1 -1
  35. package/dist/commands/{team → settings}/aliases/list.js +8 -8
  36. package/dist/commands/{team → settings}/aliases/set.d.ts +1 -1
  37. package/dist/commands/{team → settings}/aliases/set.js +8 -8
  38. package/dist/commands/settings/diff.d.ts +8 -0
  39. package/dist/commands/settings/diff.js +39 -0
  40. package/dist/commands/settings/pull.d.ts +11 -0
  41. package/dist/commands/settings/pull.js +41 -0
  42. package/dist/commands/{team → settings}/push.d.ts +4 -4
  43. package/dist/commands/{team → settings}/push.js +39 -39
  44. package/dist/commands/settings/status.d.ts +8 -0
  45. package/dist/commands/settings/status.js +46 -0
  46. package/dist/commands/{team → settings}/versions/create.d.ts +1 -1
  47. package/dist/commands/{team → settings}/versions/create.js +13 -10
  48. package/dist/commands/{team → settings}/versions/delete.d.ts +1 -1
  49. package/dist/commands/{team → settings}/versions/delete.js +10 -10
  50. package/dist/commands/{team → settings}/versions/list.d.ts +1 -1
  51. package/dist/commands/{team → settings}/versions/list.js +8 -8
  52. package/dist/commands/status.d.ts +3 -0
  53. package/dist/commands/status.js +10 -7
  54. package/dist/commands/team/clone.d.ts +14 -0
  55. package/dist/commands/team/clone.js +91 -0
  56. package/dist/commands/team/pull.d.ts +3 -7
  57. package/dist/commands/team/pull.js +25 -30
  58. package/dist/commands/team/status.d.ts +3 -4
  59. package/dist/commands/team/status.js +34 -33
  60. package/dist/commands/variables/diff.d.ts +9 -0
  61. package/dist/commands/variables/diff.js +15 -0
  62. package/dist/commands/variables/status.d.ts +3 -0
  63. package/dist/commands/variables/status.js +1 -0
  64. package/dist/config/dev-team.d.ts +48 -0
  65. package/dist/config/dev-team.js +62 -0
  66. package/dist/config/workspace.d.ts +2 -2
  67. package/dist/config/workspace.js +4 -2
  68. package/dist/core/commands/base-command.js +5 -0
  69. package/dist/core/commands/dependency-command.d.ts +2 -1
  70. package/dist/core/commands/dependency-command.js +3 -0
  71. package/dist/core/commands/i18n-command.js +2 -0
  72. package/dist/core/commands/modules-command.js +2 -0
  73. package/dist/core/commands/processes-command.js +2 -0
  74. package/dist/core/commands/resource-command.d.ts +26 -1
  75. package/dist/core/commands/resource-command.js +100 -3
  76. package/dist/core/commands/variables-command.d.ts +7 -0
  77. package/dist/core/commands/variables-command.js +13 -0
  78. package/dist/core/executors/javascript-execution-task.js +25 -3
  79. package/dist/core/types.d.ts +30 -7
  80. package/dist/core/types.js +38 -10
  81. package/dist/repositories/process.d.ts +8 -2
  82. package/dist/repositories/process.js +28 -18
  83. package/dist/repositories/programming-language-manifest.d.ts +15 -1
  84. package/dist/repositories/programming-language-manifest.js +45 -1
  85. package/dist/repositories/settings.d.ts +52 -0
  86. package/dist/repositories/settings.js +214 -0
  87. package/dist/runtime/libs/python/fcode/context.py +29 -2
  88. package/dist/services/dashboard-client.d.ts +31 -0
  89. package/dist/services/dashboard-client.js +99 -0
  90. package/dist/services/dev-team-service.d.ts +41 -0
  91. package/dist/services/dev-team-service.js +162 -0
  92. package/dist/services/fcode-graphql-client.d.ts +16 -2
  93. package/dist/services/fcode-graphql-client.js +56 -7
  94. package/dist/services/locale-resolver.d.ts +16 -5
  95. package/dist/services/locale-resolver.js +60 -12
  96. package/dist/services/resource-differ.d.ts +60 -0
  97. package/dist/services/resource-differ.js +135 -0
  98. package/dist/services/skills-installer.d.ts +16 -0
  99. package/dist/services/skills-installer.js +77 -0
  100. package/dist/services/team-versioning.d.ts +4 -4
  101. package/dist/services/team-versioning.js +4 -4
  102. package/dist/services/webhook-auth.js +1 -1
  103. package/dist/services/workspace-cloner.d.ts +31 -0
  104. package/dist/services/workspace-cloner.js +95 -0
  105. package/dist/utils/dev-slug.d.ts +12 -0
  106. package/dist/utils/dev-slug.js +37 -0
  107. package/dist/utils/diff.d.ts +19 -0
  108. package/dist/utils/diff.js +58 -0
  109. package/dist/utils/slugify.d.ts +17 -0
  110. package/dist/utils/slugify.js +41 -0
  111. package/oclif.manifest.json +428 -116
  112. package/package.json +12 -7
  113. package/dist/repositories/team.d.ts +0 -41
  114. package/dist/repositories/team.js +0 -170
package/README.md CHANGED
@@ -20,7 +20,7 @@ $ npm install -g @factorialco/fcode-cli
20
20
  $ fcode COMMAND
21
21
  running command...
22
22
  $ fcode (--version)
23
- @factorialco/fcode-cli/2.4.0 linux-x64 node-v22.22.3
23
+ @factorialco/fcode-cli/3.0.0 linux-x64 node-v22.22.3
24
24
  $ fcode --help [COMMAND]
25
25
  USAGE
26
26
  $ fcode COMMAND
@@ -32,15 +32,21 @@ USAGE
32
32
  <!-- commands -->
33
33
  * [`fcode add`](#fcode-add)
34
34
  * [`fcode clone [TEAM]`](#fcode-clone-team)
35
+ * [`fcode config:get [KEY]`](#fcode-configget-key)
36
+ * [`fcode config:remove KEY`](#fcode-configremove-key)
37
+ * [`fcode config:set KEY VALUE`](#fcode-configset-key-value)
35
38
  * [`fcode dependencies:add [RESOURCESLUG]`](#fcode-dependenciesadd-resourceslug)
39
+ * [`fcode dependencies:diff [RESOURCESLUG]`](#fcode-dependenciesdiff-resourceslug)
36
40
  * [`fcode dependencies:install [PROGRAMMINGLANGUAGE]`](#fcode-dependenciesinstall-programminglanguage)
37
41
  * [`fcode dependencies:pull [RESOURCESLUG]`](#fcode-dependenciespull-resourceslug)
38
42
  * [`fcode dependencies:push [RESOURCESLUG]`](#fcode-dependenciespush-resourceslug)
39
43
  * [`fcode dependencies:reset [RESOURCESLUG]`](#fcode-dependenciesreset-resourceslug)
40
44
  * [`fcode dependencies:status [RESOURCESLUG]`](#fcode-dependenciesstatus-resourceslug)
45
+ * [`fcode diff`](#fcode-diff)
41
46
  * [`fcode help [COMMAND]`](#fcode-help-command)
42
47
  * [`fcode http`](#fcode-http)
43
48
  * [`fcode i18n:add [RESOURCESLUG]`](#fcode-i18nadd-resourceslug)
49
+ * [`fcode i18n:diff [RESOURCESLUG]`](#fcode-i18ndiff-resourceslug)
44
50
  * [`fcode i18n:pull [RESOURCESLUG]`](#fcode-i18npull-resourceslug)
45
51
  * [`fcode i18n:push [RESOURCESLUG]`](#fcode-i18npush-resourceslug)
46
52
  * [`fcode i18n:remove [RESOURCESLUG]`](#fcode-i18nremove-resourceslug)
@@ -49,12 +55,14 @@ USAGE
49
55
  * [`fcode login`](#fcode-login)
50
56
  * [`fcode logout`](#fcode-logout)
51
57
  * [`fcode modules:add [RESOURCESLUG]`](#fcode-modulesadd-resourceslug)
58
+ * [`fcode modules:diff [RESOURCESLUG]`](#fcode-modulesdiff-resourceslug)
52
59
  * [`fcode modules:pull [RESOURCESLUG]`](#fcode-modulespull-resourceslug)
53
60
  * [`fcode modules:push [RESOURCESLUG]`](#fcode-modulespush-resourceslug)
54
61
  * [`fcode modules:remove [RESOURCESLUG]`](#fcode-modulesremove-resourceslug)
55
62
  * [`fcode modules:reset [RESOURCESLUG]`](#fcode-modulesreset-resourceslug)
56
63
  * [`fcode modules:status [RESOURCESLUG]`](#fcode-modulesstatus-resourceslug)
57
64
  * [`fcode processes:add [RESOURCESLUG]`](#fcode-processesadd-resourceslug)
65
+ * [`fcode processes:diff [RESOURCESLUG]`](#fcode-processesdiff-resourceslug)
58
66
  * [`fcode processes:install-dependencies [RESOURCESLUG]`](#fcode-processesinstall-dependencies-resourceslug)
59
67
  * [`fcode processes:pull [RESOURCESLUG]`](#fcode-processespull-resourceslug)
60
68
  * [`fcode processes:push [RESOURCESLUG]`](#fcode-processespush-resourceslug)
@@ -68,23 +76,25 @@ USAGE
68
76
  * [`fcode remote:set [TEAM]`](#fcode-remoteset-team)
69
77
  * [`fcode reset`](#fcode-reset)
70
78
  * [`fcode run SLUG`](#fcode-run-slug)
71
- * [`fcode settings:get [KEY]`](#fcode-settingsget-key)
72
- * [`fcode settings:remove KEY`](#fcode-settingsremove-key)
73
- * [`fcode settings:set KEY VALUE`](#fcode-settingsset-key-value)
79
+ * [`fcode settings:aliases:delete NAME`](#fcode-settingsaliasesdelete-name)
80
+ * [`fcode settings:aliases:list`](#fcode-settingsaliaseslist)
81
+ * [`fcode settings:aliases:set NAME TAG`](#fcode-settingsaliasesset-name-tag)
82
+ * [`fcode settings:diff`](#fcode-settingsdiff)
83
+ * [`fcode settings:pull`](#fcode-settingspull)
84
+ * [`fcode settings:push`](#fcode-settingspush)
85
+ * [`fcode settings:status`](#fcode-settingsstatus)
86
+ * [`fcode settings:versions:create TAG`](#fcode-settingsversionscreate-tag)
87
+ * [`fcode settings:versions:delete TAG`](#fcode-settingsversionsdelete-tag)
88
+ * [`fcode settings:versions:list`](#fcode-settingsversionslist)
74
89
  * [`fcode setup-debug`](#fcode-setup-debug)
75
90
  * [`fcode status`](#fcode-status)
76
- * [`fcode team:aliases:delete NAME`](#fcode-teamaliasesdelete-name)
77
- * [`fcode team:aliases:list`](#fcode-teamaliaseslist)
78
- * [`fcode team:aliases:set NAME TAG`](#fcode-teamaliasesset-name-tag)
91
+ * [`fcode team:clone [TEAMID]`](#fcode-teamclone-teamid)
79
92
  * [`fcode team:pull`](#fcode-teampull)
80
- * [`fcode team:push`](#fcode-teampush)
81
93
  * [`fcode team:status`](#fcode-teamstatus)
82
- * [`fcode team:versions:create TAG`](#fcode-teamversionscreate-tag)
83
- * [`fcode team:versions:delete TAG`](#fcode-teamversionsdelete-tag)
84
- * [`fcode team:versions:list`](#fcode-teamversionslist)
85
94
  * [`fcode test [SLUG]`](#fcode-test-slug)
86
95
  * [`fcode test:scaffold SLUG`](#fcode-testscaffold-slug)
87
96
  * [`fcode variables:add [RESOURCESLUG]`](#fcode-variablesadd-resourceslug)
97
+ * [`fcode variables:diff [RESOURCESLUG]`](#fcode-variablesdiff-resourceslug)
88
98
  * [`fcode variables:pull [RESOURCESLUG]`](#fcode-variablespull-resourceslug)
89
99
  * [`fcode variables:push [RESOURCESLUG]`](#fcode-variablespush-resourceslug)
90
100
  * [`fcode variables:remove [RESOURCESLUG]`](#fcode-variablesremove-resourceslug)
@@ -129,6 +139,70 @@ EXAMPLES
129
139
  $ fcode clone [team]
130
140
  ```
131
141
 
142
+ ## `fcode config:get [KEY]`
143
+
144
+ Get a CLI setting value or all CLI settings
145
+
146
+ ```
147
+ USAGE
148
+ $ fcode config:get [KEY] [-a]
149
+
150
+ ARGUMENTS
151
+ [KEY] Setting key (optional, shows all settings if omitted)
152
+
153
+ FLAGS
154
+ -a, --all Show all settings including defaults
155
+
156
+ DESCRIPTION
157
+ Get a CLI setting value or all CLI settings
158
+
159
+ EXAMPLES
160
+ $ fcode config:get disableUpdateNotifier
161
+
162
+ $ fcode config:get
163
+
164
+ $ fcode config:get --all
165
+ ```
166
+
167
+ ## `fcode config:remove KEY`
168
+
169
+ Remove a CLI setting value
170
+
171
+ ```
172
+ USAGE
173
+ $ fcode config:remove KEY
174
+
175
+ ARGUMENTS
176
+ KEY Setting key
177
+
178
+ DESCRIPTION
179
+ Remove a CLI setting value
180
+
181
+ EXAMPLES
182
+ $ fcode config:remove disableUpdateNotifier
183
+ ```
184
+
185
+ ## `fcode config:set KEY VALUE`
186
+
187
+ Set a CLI setting value
188
+
189
+ ```
190
+ USAGE
191
+ $ fcode config:set KEY VALUE
192
+
193
+ ARGUMENTS
194
+ KEY Setting key
195
+ VALUE Setting value
196
+
197
+ DESCRIPTION
198
+ Set a CLI setting value
199
+
200
+ EXAMPLES
201
+ $ fcode config:set disableUpdateNotifier true
202
+
203
+ $ fcode config:set ignoreWorkspaceNotEmpty false
204
+ ```
205
+
132
206
  ## `fcode dependencies:add [RESOURCESLUG]`
133
207
 
134
208
  Keeps track of dependencies
@@ -147,6 +221,26 @@ EXAMPLES
147
221
  $ fcode dependencies:add
148
222
  ```
149
223
 
224
+ ## `fcode dependencies:diff [RESOURCESLUG]`
225
+
226
+ Show a unified diff between local dependency manifests and the cloud. Exits 1 when they differ
227
+
228
+ ```
229
+ USAGE
230
+ $ fcode dependencies:diff [RESOURCESLUG]
231
+
232
+ ARGUMENTS
233
+ [RESOURCESLUG] Resource slug
234
+
235
+ DESCRIPTION
236
+ Show a unified diff between local dependency manifests and the cloud. Exits 1 when they differ
237
+
238
+ EXAMPLES
239
+ $ fcode dependencies:diff
240
+
241
+ $ fcode dependencies:diff JAVASCRIPT
242
+ ```
243
+
150
244
  ## `fcode dependencies:install [PROGRAMMINGLANGUAGE]`
151
245
 
152
246
  Install Factorial Code dependencies
@@ -248,6 +342,21 @@ EXAMPLES
248
342
  $ fcode dependencies:status
249
343
  ```
250
344
 
345
+ ## `fcode diff`
346
+
347
+ Show a unified diff between the local workspace and the cloud. Exits 1 when they differ
348
+
349
+ ```
350
+ USAGE
351
+ $ fcode diff
352
+
353
+ DESCRIPTION
354
+ Show a unified diff between the local workspace and the cloud. Exits 1 when they differ
355
+
356
+ EXAMPLES
357
+ $ fcode diff
358
+ ```
359
+
251
360
  ## `fcode help [COMMAND]`
252
361
 
253
362
  Display help for fcode.
@@ -316,6 +425,26 @@ EXAMPLES
316
425
  $ fcode i18n:add pt-BR
317
426
  ```
318
427
 
428
+ ## `fcode i18n:diff [RESOURCESLUG]`
429
+
430
+ Show a unified diff between local locales and the cloud. Exits 1 when they differ
431
+
432
+ ```
433
+ USAGE
434
+ $ fcode i18n:diff [RESOURCESLUG]
435
+
436
+ ARGUMENTS
437
+ [RESOURCESLUG] Resource slug
438
+
439
+ DESCRIPTION
440
+ Show a unified diff between local locales and the cloud. Exits 1 when they differ
441
+
442
+ EXAMPLES
443
+ $ fcode i18n:diff
444
+
445
+ $ fcode i18n:diff en
446
+ ```
447
+
319
448
  ## `fcode i18n:pull [RESOURCESLUG]`
320
449
 
321
450
  Fetch all locales from cloud and save them locally
@@ -402,11 +531,14 @@ List all locales status
402
531
 
403
532
  ```
404
533
  USAGE
405
- $ fcode i18n:status [RESOURCESLUG]
534
+ $ fcode i18n:status [RESOURCESLUG] [--showInherited]
406
535
 
407
536
  ARGUMENTS
408
537
  [RESOURCESLUG] Resource slug
409
538
 
539
+ FLAGS
540
+ --showInherited Also list inherited resources that have no changes
541
+
410
542
  DESCRIPTION
411
543
  List all locales status
412
544
 
@@ -484,6 +616,26 @@ EXAMPLES
484
616
  $ fcode modules:add
485
617
  ```
486
618
 
619
+ ## `fcode modules:diff [RESOURCESLUG]`
620
+
621
+ Show a unified diff between local modules and the cloud. Exits 1 when they differ
622
+
623
+ ```
624
+ USAGE
625
+ $ fcode modules:diff [RESOURCESLUG]
626
+
627
+ ARGUMENTS
628
+ [RESOURCESLUG] Resource slug
629
+
630
+ DESCRIPTION
631
+ Show a unified diff between local modules and the cloud. Exits 1 when they differ
632
+
633
+ EXAMPLES
634
+ $ fcode modules:diff
635
+
636
+ $ fcode modules:diff my-module
637
+ ```
638
+
487
639
  ## `fcode modules:pull [RESOURCESLUG]`
488
640
 
489
641
  Fetch all modules from cloud and save them locally
@@ -568,11 +720,14 @@ List all modules status
568
720
 
569
721
  ```
570
722
  USAGE
571
- $ fcode modules:status [RESOURCESLUG]
723
+ $ fcode modules:status [RESOURCESLUG] [--showInherited]
572
724
 
573
725
  ARGUMENTS
574
726
  [RESOURCESLUG] Resource slug
575
727
 
728
+ FLAGS
729
+ --showInherited Also list inherited resources that have no changes
730
+
576
731
  DESCRIPTION
577
732
  List all modules status
578
733
 
@@ -598,6 +753,26 @@ EXAMPLES
598
753
  $ fcode processes:add
599
754
  ```
600
755
 
756
+ ## `fcode processes:diff [RESOURCESLUG]`
757
+
758
+ Show a unified diff between local processes and the cloud. Exits 1 when they differ
759
+
760
+ ```
761
+ USAGE
762
+ $ fcode processes:diff [RESOURCESLUG]
763
+
764
+ ARGUMENTS
765
+ [RESOURCESLUG] Resource slug
766
+
767
+ DESCRIPTION
768
+ Show a unified diff between local processes and the cloud. Exits 1 when they differ
769
+
770
+ EXAMPLES
771
+ $ fcode processes:diff
772
+
773
+ $ fcode processes:diff hello-world
774
+ ```
775
+
601
776
  ## `fcode processes:install-dependencies [RESOURCESLUG]`
602
777
 
603
778
  Install Factorial Code process dependencies
@@ -705,11 +880,14 @@ List all processes status
705
880
 
706
881
  ```
707
882
  USAGE
708
- $ fcode processes:status [RESOURCESLUG]
883
+ $ fcode processes:status [RESOURCESLUG] [--showInherited]
709
884
 
710
885
  ARGUMENTS
711
886
  [RESOURCESLUG] Resource slug
712
887
 
888
+ FLAGS
889
+ --showInherited Also list inherited resources that have no changes
890
+
713
891
  DESCRIPTION
714
892
  List all processes status
715
893
 
@@ -849,264 +1027,275 @@ EXAMPLES
849
1027
  $ fcode run --parameters ./parameters.json [process-slug]
850
1028
  ```
851
1029
 
852
- ## `fcode settings:get [KEY]`
1030
+ ## `fcode settings:aliases:delete NAME`
853
1031
 
854
- Get a setting value or all settings
1032
+ Delete a workspace version alias and the per-entity aliases carrying its name on every owned process and module
855
1033
 
856
1034
  ```
857
1035
  USAGE
858
- $ fcode settings:get [KEY] [-a]
1036
+ $ fcode settings:aliases:delete NAME
859
1037
 
860
1038
  ARGUMENTS
861
- [KEY] Setting key (optional, shows all settings if omitted)
862
-
863
- FLAGS
864
- -a, --all Show all settings including defaults
1039
+ NAME alias name to delete
865
1040
 
866
1041
  DESCRIPTION
867
- Get a setting value or all settings
1042
+ Delete a workspace version alias and the per-entity aliases carrying its name on every owned process and module
868
1043
 
869
1044
  EXAMPLES
870
- $ fcode settings:get disableUpdateNotifier
871
-
872
- $ fcode settings:get
873
-
874
- $ fcode settings:get --all
1045
+ $ fcode settings:aliases:delete production
875
1046
  ```
876
1047
 
877
- ## `fcode settings:remove KEY`
1048
+ ## `fcode settings:aliases:list`
878
1049
 
879
- Remove a setting value
1050
+ List the workspace version aliases of the active workspace
880
1051
 
881
1052
  ```
882
1053
  USAGE
883
- $ fcode settings:remove KEY
884
-
885
- ARGUMENTS
886
- KEY Setting key
1054
+ $ fcode settings:aliases:list
887
1055
 
888
1056
  DESCRIPTION
889
- Remove a setting value
1057
+ List the workspace version aliases of the active workspace
890
1058
 
891
1059
  EXAMPLES
892
- $ fcode settings:remove disableUpdateNotifier
1060
+ $ fcode settings:aliases:list
893
1061
  ```
894
1062
 
895
- ## `fcode settings:set KEY VALUE`
1063
+ ## `fcode settings:aliases:set NAME TAG`
896
1064
 
897
- Set a setting value
1065
+ Create or re-point a workspace version alias, upserting the per-entity alias on every owned process and module that has the target tag published
898
1066
 
899
1067
  ```
900
1068
  USAGE
901
- $ fcode settings:set KEY VALUE
1069
+ $ fcode settings:aliases:set NAME TAG
902
1070
 
903
1071
  ARGUMENTS
904
- KEY Setting key
905
- VALUE Setting value
1072
+ NAME alias name (e.g. production)
1073
+ TAG workspace version tag the alias points at
906
1074
 
907
1075
  DESCRIPTION
908
- Set a setting value
1076
+ Create or re-point a workspace version alias, upserting the per-entity alias on every owned process and module that
1077
+ has the target tag published
909
1078
 
910
1079
  EXAMPLES
911
- $ fcode settings:set disableUpdateNotifier true
912
-
913
- $ fcode settings:set ignoreWorkspaceNotEmpty false
1080
+ $ fcode settings:aliases:set production v1.0.0
914
1081
  ```
915
1082
 
916
- ## `fcode setup-debug`
1083
+ ## `fcode settings:diff`
917
1084
 
918
- Setup vscode debug configurations
1085
+ Show a unified diff between local workspace settings (settings.json) and the cloud. Exits 1 when they differ
919
1086
 
920
1087
  ```
921
1088
  USAGE
922
- $ fcode setup-debug
1089
+ $ fcode settings:diff
923
1090
 
924
1091
  DESCRIPTION
925
- Setup vscode debug configurations
1092
+ Show a unified diff between local workspace settings (settings.json) and the cloud. Exits 1 when they differ
926
1093
 
927
1094
  EXAMPLES
928
- $ fcode setup-debug
1095
+ $ fcode settings:diff
929
1096
  ```
930
1097
 
931
- ## `fcode status`
1098
+ ## `fcode settings:pull`
932
1099
 
933
- Show team workspace status
1100
+ Fetch workspace settings (timezone, error handler, inheritance) and workspace versions/aliases from cloud into settings.json
934
1101
 
935
1102
  ```
936
1103
  USAGE
937
- $ fcode status
1104
+ $ fcode settings:pull [-f]
1105
+
1106
+ FLAGS
1107
+ -f, --force Force command
938
1108
 
939
1109
  DESCRIPTION
940
- Show team workspace status
1110
+ Fetch workspace settings (timezone, error handler, inheritance) and workspace versions/aliases from cloud into
1111
+ settings.json
941
1112
 
942
1113
  EXAMPLES
943
- $ fcode status
1114
+ $ fcode settings:pull
944
1115
  ```
945
1116
 
946
- ## `fcode team:aliases:delete NAME`
1117
+ ## `fcode settings:push`
947
1118
 
948
- Delete a team version alias and the per-entity aliases carrying its name on every owned process and module
1119
+ Update cloud workspace settings (timezone, error handler, inheritance, webhook auth) and sync workspace versions/aliases from settings.json
949
1120
 
950
1121
  ```
951
1122
  USAGE
952
- $ fcode team:aliases:delete NAME
1123
+ $ fcode settings:push [-f]
953
1124
 
954
- ARGUMENTS
955
- NAME alias name to delete
1125
+ FLAGS
1126
+ -f, --force Force command
956
1127
 
957
1128
  DESCRIPTION
958
- Delete a team version alias and the per-entity aliases carrying its name on every owned process and module
1129
+ Update cloud workspace settings (timezone, error handler, inheritance, webhook auth) and sync workspace
1130
+ versions/aliases from settings.json
959
1131
 
960
1132
  EXAMPLES
961
- $ fcode team:aliases:delete production
1133
+ $ fcode settings:push
962
1134
  ```
963
1135
 
964
- ## `fcode team:aliases:list`
1136
+ ## `fcode settings:status`
965
1137
 
966
- List the team version aliases of the active team workspace
1138
+ Show whether workspace settings (timezone, error handler, inheritance) or workspace versions/aliases differ from the cloud
967
1139
 
968
1140
  ```
969
1141
  USAGE
970
- $ fcode team:aliases:list
1142
+ $ fcode settings:status
971
1143
 
972
1144
  DESCRIPTION
973
- List the team version aliases of the active team workspace
1145
+ Show whether workspace settings (timezone, error handler, inheritance) or workspace versions/aliases differ from the
1146
+ cloud
974
1147
 
975
1148
  EXAMPLES
976
- $ fcode team:aliases:list
1149
+ $ fcode settings:status
977
1150
  ```
978
1151
 
979
- ## `fcode team:aliases:set NAME TAG`
1152
+ ## `fcode settings:versions:create TAG`
980
1153
 
981
- Create or re-point a team version alias, upserting the per-entity alias on every owned process and module that has the target tag published
1154
+ Publish a workspace version: creates a version with the tag on every owned process and module (existing tags are skipped) and pins bare module imports in the published snapshots
982
1155
 
983
1156
  ```
984
1157
  USAGE
985
- $ fcode team:aliases:set NAME TAG
1158
+ $ fcode settings:versions:create TAG [-c <value>]
986
1159
 
987
1160
  ARGUMENTS
988
- NAME alias name (e.g. production)
989
- TAG team version tag the alias points at
1161
+ TAG version tag to publish (e.g. v1.0.0)
1162
+
1163
+ FLAGS
1164
+ -c, --comment=<value> comment describing the version
990
1165
 
991
1166
  DESCRIPTION
992
- Create or re-point a team version alias, upserting the per-entity alias on every owned process and module that has the
993
- target tag published
1167
+ Publish a workspace version: creates a version with the tag on every owned process and module (existing tags are
1168
+ skipped) and pins bare module imports in the published snapshots
994
1169
 
995
1170
  EXAMPLES
996
- $ fcode team:aliases:set production v1.0.0
1171
+ $ fcode settings:versions:create v1.0.0
1172
+
1173
+ $ fcode settings:versions:create v1.0.0 --comment "First stable release"
997
1174
  ```
998
1175
 
999
- ## `fcode team:pull`
1176
+ ## `fcode settings:versions:delete TAG`
1000
1177
 
1001
- Fetch team settings (timezone, error handler, inheritance) and team versions/aliases from cloud into team.json
1178
+ Delete a workspace version. CASCADES: every owned process/module version with the tag is deleted, together with the aliases, executions and schedules that reference them
1002
1179
 
1003
1180
  ```
1004
1181
  USAGE
1005
- $ fcode team:pull [-f]
1182
+ $ fcode settings:versions:delete TAG [-f]
1183
+
1184
+ ARGUMENTS
1185
+ TAG version tag to delete
1006
1186
 
1007
1187
  FLAGS
1008
1188
  -f, --force Force command
1009
1189
 
1010
1190
  DESCRIPTION
1011
- Fetch team settings (timezone, error handler, inheritance) and team versions/aliases from cloud into team.json
1191
+ Delete a workspace version. CASCADES: every owned process/module version with the tag is deleted, together with the
1192
+ aliases, executions and schedules that reference them
1012
1193
 
1013
1194
  EXAMPLES
1014
- $ fcode team:pull
1195
+ $ fcode settings:versions:delete v1.0.0
1015
1196
  ```
1016
1197
 
1017
- ## `fcode team:push`
1198
+ ## `fcode settings:versions:list`
1018
1199
 
1019
- Update cloud team settings (timezone, error handler, inheritance, webhook auth) and sync team versions/aliases from team.json
1200
+ List the workspace versions published on the active workspace
1020
1201
 
1021
1202
  ```
1022
1203
  USAGE
1023
- $ fcode team:push [-f]
1024
-
1025
- FLAGS
1026
- -f, --force Force command
1204
+ $ fcode settings:versions:list
1027
1205
 
1028
1206
  DESCRIPTION
1029
- Update cloud team settings (timezone, error handler, inheritance, webhook auth) and sync team versions/aliases from
1030
- team.json
1207
+ List the workspace versions published on the active workspace
1031
1208
 
1032
1209
  EXAMPLES
1033
- $ fcode team:push
1210
+ $ fcode settings:versions:list
1034
1211
  ```
1035
1212
 
1036
- ## `fcode team:status`
1213
+ ## `fcode setup-debug`
1037
1214
 
1038
- Show whether team settings (timezone, error handler, inheritance) or team versions/aliases differ from the cloud
1215
+ Setup vscode debug configurations
1039
1216
 
1040
1217
  ```
1041
1218
  USAGE
1042
- $ fcode team:status
1219
+ $ fcode setup-debug
1043
1220
 
1044
1221
  DESCRIPTION
1045
- Show whether team settings (timezone, error handler, inheritance) or team versions/aliases differ from the cloud
1222
+ Setup vscode debug configurations
1046
1223
 
1047
1224
  EXAMPLES
1048
- $ fcode team:status
1225
+ $ fcode setup-debug
1049
1226
  ```
1050
1227
 
1051
- ## `fcode team:versions:create TAG`
1228
+ ## `fcode status`
1052
1229
 
1053
- Publish a team version: creates a version with the tag on every owned process and module (existing tags are skipped) and pins bare module imports in the published snapshots
1230
+ Show team workspace status
1054
1231
 
1055
1232
  ```
1056
1233
  USAGE
1057
- $ fcode team:versions:create TAG [-c <value>]
1058
-
1059
- ARGUMENTS
1060
- TAG version tag to publish (e.g. v1.0.0)
1234
+ $ fcode status [--showInherited]
1061
1235
 
1062
1236
  FLAGS
1063
- -c, --comment=<value> comment describing the version
1237
+ --showInherited Also list inherited resources that have no changes
1064
1238
 
1065
1239
  DESCRIPTION
1066
- Publish a team version: creates a version with the tag on every owned process and module (existing tags are skipped)
1067
- and pins bare module imports in the published snapshots
1240
+ Show team workspace status
1068
1241
 
1069
1242
  EXAMPLES
1070
- $ fcode team:versions:create v1.0.0
1243
+ $ fcode status
1071
1244
 
1072
- $ fcode team:versions:create v1.0.0 --comment "First stable release"
1245
+ $ fcode status --showInherited
1073
1246
  ```
1074
1247
 
1075
- ## `fcode team:versions:delete TAG`
1248
+ ## `fcode team:clone [TEAMID]`
1076
1249
 
1077
- Delete a team version. CASCADES: every owned process/module version with the tag is deleted, together with the aliases, executions and schedules that reference them
1250
+ Clone every App of a development team into one folder — an App folder each, holding the App's development workspace
1078
1251
 
1079
1252
  ```
1080
1253
  USAGE
1081
- $ fcode team:versions:delete TAG [-f]
1254
+ $ fcode team:clone [TEAMID] [--skipSkillsSetup]
1082
1255
 
1083
1256
  ARGUMENTS
1084
- TAG version tag to delete
1257
+ [TEAMID] development team id (run without it to list the teams you belong to)
1085
1258
 
1086
1259
  FLAGS
1087
- -f, --force Force command
1260
+ --skipSkillsSetup Skip installation of the Factorial Code agent skills
1088
1261
 
1089
1262
  DESCRIPTION
1090
- Delete a team version. CASCADES: every owned process/module version with the tag is deleted, together with the
1091
- aliases, executions and schedules that reference them
1263
+ Clone every App of a development team into one folder — an App folder each, holding the App's development workspace
1264
+
1265
+ EXAMPLES
1266
+ $ fcode team:clone
1267
+
1268
+ $ fcode team:clone 0f9c1a2b-3d4e-5f60-8a1b-2c3d4e5f6071
1269
+ ```
1270
+
1271
+ ## `fcode team:pull`
1272
+
1273
+ Pull every App of the development team folder: clones Apps added since the last run and pulls each App's workspace
1274
+
1275
+ ```
1276
+ USAGE
1277
+ $ fcode team:pull
1278
+
1279
+ DESCRIPTION
1280
+ Pull every App of the development team folder: clones Apps added since the last run and pulls each App's workspace
1092
1281
 
1093
1282
  EXAMPLES
1094
- $ fcode team:versions:delete v1.0.0
1283
+ $ fcode team:pull
1095
1284
  ```
1096
1285
 
1097
- ## `fcode team:versions:list`
1286
+ ## `fcode team:status`
1098
1287
 
1099
- List the team versions published on the active team workspace
1288
+ Show what differs from the cloud in every App workspace of the development team folder
1100
1289
 
1101
1290
  ```
1102
1291
  USAGE
1103
- $ fcode team:versions:list
1292
+ $ fcode team:status
1104
1293
 
1105
1294
  DESCRIPTION
1106
- List the team versions published on the active team workspace
1295
+ Show what differs from the cloud in every App workspace of the development team folder
1107
1296
 
1108
1297
  EXAMPLES
1109
- $ fcode team:versions:list
1298
+ $ fcode team:status
1110
1299
  ```
1111
1300
 
1112
1301
  ## `fcode test [SLUG]`
@@ -1175,6 +1364,27 @@ EXAMPLES
1175
1364
  $ fcode variables:add
1176
1365
  ```
1177
1366
 
1367
+ ## `fcode variables:diff [RESOURCESLUG]`
1368
+
1369
+ Show a unified diff between local variables and the cloud. Sensitive values are never printed. Exits 1 when they differ
1370
+
1371
+ ```
1372
+ USAGE
1373
+ $ fcode variables:diff [RESOURCESLUG]
1374
+
1375
+ ARGUMENTS
1376
+ [RESOURCESLUG] Resource slug
1377
+
1378
+ DESCRIPTION
1379
+ Show a unified diff between local variables and the cloud. Sensitive values are never printed. Exits 1 when they
1380
+ differ
1381
+
1382
+ EXAMPLES
1383
+ $ fcode variables:diff
1384
+
1385
+ $ fcode variables:diff MY_VARIABLE
1386
+ ```
1387
+
1178
1388
  ## `fcode variables:pull [RESOURCESLUG]`
1179
1389
 
1180
1390
  Fetch all variables from cloud and save them locally
@@ -1259,11 +1469,14 @@ List all variables status
1259
1469
 
1260
1470
  ```
1261
1471
  USAGE
1262
- $ fcode variables:status [RESOURCESLUG]
1472
+ $ fcode variables:status [RESOURCESLUG] [--showInherited]
1263
1473
 
1264
1474
  ARGUMENTS
1265
1475
  [RESOURCESLUG] Resource slug
1266
1476
 
1477
+ FLAGS
1478
+ --showInherited Also list inherited resources that have no changes
1479
+
1267
1480
  DESCRIPTION
1268
1481
  List all variables status
1269
1482