@factorialco/fcode-cli 2.3.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 (123) hide show
  1. package/README.md +334 -117
  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/dependencies/status.d.ts +11 -0
  15. package/dist/commands/dependencies/status.js +43 -0
  16. package/dist/commands/diff.d.ts +12 -0
  17. package/dist/commands/diff.js +48 -0
  18. package/dist/commands/http.d.ts +1 -1
  19. package/dist/commands/http.js +7 -7
  20. package/dist/commands/i18n/diff.d.ts +9 -0
  21. package/dist/commands/i18n/diff.js +15 -0
  22. package/dist/commands/i18n/status.d.ts +3 -0
  23. package/dist/commands/i18n/status.js +1 -0
  24. package/dist/commands/modules/diff.d.ts +9 -0
  25. package/dist/commands/modules/diff.js +15 -0
  26. package/dist/commands/modules/status.d.ts +3 -0
  27. package/dist/commands/modules/status.js +1 -0
  28. package/dist/commands/processes/diff.d.ts +9 -0
  29. package/dist/commands/processes/diff.js +15 -0
  30. package/dist/commands/processes/status.d.ts +3 -0
  31. package/dist/commands/processes/status.js +1 -0
  32. package/dist/commands/pull.js +3 -3
  33. package/dist/commands/push.js +2 -2
  34. package/dist/commands/{team → settings}/aliases/delete.d.ts +1 -1
  35. package/dist/commands/{team → settings}/aliases/delete.js +6 -6
  36. package/dist/commands/{team → settings}/aliases/list.d.ts +1 -1
  37. package/dist/commands/{team → settings}/aliases/list.js +8 -8
  38. package/dist/commands/{team → settings}/aliases/set.d.ts +1 -1
  39. package/dist/commands/{team → settings}/aliases/set.js +8 -8
  40. package/dist/commands/settings/diff.d.ts +8 -0
  41. package/dist/commands/settings/diff.js +39 -0
  42. package/dist/commands/{team/push.d.ts → settings/pull.d.ts} +3 -3
  43. package/dist/commands/settings/pull.js +41 -0
  44. package/dist/commands/settings/push.d.ts +13 -0
  45. package/dist/commands/settings/push.js +103 -0
  46. package/dist/commands/settings/status.d.ts +8 -0
  47. package/dist/commands/settings/status.js +46 -0
  48. package/dist/commands/{team → settings}/versions/create.d.ts +1 -2
  49. package/dist/commands/settings/versions/create.js +36 -0
  50. package/dist/commands/{team → settings}/versions/delete.d.ts +1 -1
  51. package/dist/commands/{team → settings}/versions/delete.js +10 -10
  52. package/dist/commands/{team → settings}/versions/list.d.ts +1 -1
  53. package/dist/commands/{team → settings}/versions/list.js +8 -8
  54. package/dist/commands/status.d.ts +3 -0
  55. package/dist/commands/status.js +10 -7
  56. package/dist/commands/team/clone.d.ts +14 -0
  57. package/dist/commands/team/clone.js +91 -0
  58. package/dist/commands/team/pull.d.ts +3 -4
  59. package/dist/commands/team/pull.js +25 -19
  60. package/dist/commands/team/status.d.ts +3 -4
  61. package/dist/commands/team/status.js +34 -27
  62. package/dist/commands/variables/diff.d.ts +9 -0
  63. package/dist/commands/variables/diff.js +15 -0
  64. package/dist/commands/variables/status.d.ts +3 -0
  65. package/dist/commands/variables/status.js +1 -0
  66. package/dist/config/dev-team.d.ts +48 -0
  67. package/dist/config/dev-team.js +62 -0
  68. package/dist/config/workspace.d.ts +2 -2
  69. package/dist/config/workspace.js +4 -2
  70. package/dist/core/commands/base-command.js +5 -0
  71. package/dist/core/commands/dependency-command.d.ts +2 -1
  72. package/dist/core/commands/dependency-command.js +3 -0
  73. package/dist/core/commands/i18n-command.js +2 -0
  74. package/dist/core/commands/modules-command.js +2 -0
  75. package/dist/core/commands/processes-command.js +2 -0
  76. package/dist/core/commands/resource-command.d.ts +26 -1
  77. package/dist/core/commands/resource-command.js +100 -3
  78. package/dist/core/commands/variables-command.d.ts +7 -0
  79. package/dist/core/commands/variables-command.js +13 -0
  80. package/dist/core/dependencies/env-dependencies-command.js +6 -3
  81. package/dist/core/executors/javascript-execution-task.js +36 -5
  82. package/dist/core/types.d.ts +59 -9
  83. package/dist/core/types.js +64 -10
  84. package/dist/core/utils/dependencies.js +4 -1
  85. package/dist/env.js +1 -1
  86. package/dist/repositories/process.d.ts +8 -2
  87. package/dist/repositories/process.js +29 -15
  88. package/dist/repositories/programming-language-manifest.d.ts +31 -1
  89. package/dist/repositories/programming-language-manifest.js +96 -2
  90. package/dist/repositories/settings.d.ts +52 -0
  91. package/dist/repositories/settings.js +214 -0
  92. package/dist/runtime/libs/python/fcode/context.py +42 -8
  93. package/dist/services/dashboard-client.d.ts +31 -0
  94. package/dist/services/dashboard-client.js +99 -0
  95. package/dist/services/dev-team-service.d.ts +41 -0
  96. package/dist/services/dev-team-service.js +162 -0
  97. package/dist/services/fcode-graphql-client.d.ts +17 -2
  98. package/dist/services/fcode-graphql-client.js +127 -15
  99. package/dist/services/locale-resolver.d.ts +17 -1
  100. package/dist/services/locale-resolver.js +62 -7
  101. package/dist/services/resource-differ.d.ts +60 -0
  102. package/dist/services/resource-differ.js +135 -0
  103. package/dist/services/skills-installer.d.ts +16 -0
  104. package/dist/services/skills-installer.js +77 -0
  105. package/dist/services/team-versioning.d.ts +16 -0
  106. package/dist/services/team-versioning.js +40 -0
  107. package/dist/services/webhook-auth.js +1 -1
  108. package/dist/services/workspace-cloner.d.ts +31 -0
  109. package/dist/services/workspace-cloner.js +95 -0
  110. package/dist/utils/dev-slug.d.ts +12 -0
  111. package/dist/utils/dev-slug.js +37 -0
  112. package/dist/utils/diff.d.ts +19 -0
  113. package/dist/utils/diff.js +58 -0
  114. package/dist/utils/gitignore.d.ts +3 -1
  115. package/dist/utils/gitignore.js +11 -2
  116. package/dist/utils/slugify.d.ts +17 -0
  117. package/dist/utils/slugify.js +41 -0
  118. package/oclif.manifest.json +433 -113
  119. package/package.json +12 -7
  120. package/dist/commands/team/push.js +0 -52
  121. package/dist/commands/team/versions/create.js +0 -42
  122. package/dist/repositories/team.d.ts +0 -31
  123. package/dist/repositories/team.js +0 -127
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.3.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,260 +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) 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
1182
+ $ fcode settings:versions:delete TAG [-f]
1183
+
1184
+ ARGUMENTS
1185
+ TAG version tag to delete
1186
+
1187
+ FLAGS
1188
+ -f, --force Force command
1006
1189
 
1007
1190
  DESCRIPTION
1008
- Fetch team settings (timezone, error handler, inheritance) 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
1009
1193
 
1010
1194
  EXAMPLES
1011
- $ fcode team:pull
1195
+ $ fcode settings:versions:delete v1.0.0
1012
1196
  ```
1013
1197
 
1014
- ## `fcode team:push`
1198
+ ## `fcode settings:versions:list`
1015
1199
 
1016
- Update cloud team settings (timezone, error handler, inheritance, webhook auth) from team.json
1200
+ List the workspace versions published on the active workspace
1017
1201
 
1018
1202
  ```
1019
1203
  USAGE
1020
- $ fcode team:push [-f]
1021
-
1022
- FLAGS
1023
- -f, --force Force command
1204
+ $ fcode settings:versions:list
1024
1205
 
1025
1206
  DESCRIPTION
1026
- Update cloud team settings (timezone, error handler, inheritance, webhook auth) from team.json
1207
+ List the workspace versions published on the active workspace
1027
1208
 
1028
1209
  EXAMPLES
1029
- $ fcode team:push
1210
+ $ fcode settings:versions:list
1030
1211
  ```
1031
1212
 
1032
- ## `fcode team:status`
1213
+ ## `fcode setup-debug`
1033
1214
 
1034
- Show whether team settings (timezone, error handler, inheritance) differ from the cloud
1215
+ Setup vscode debug configurations
1035
1216
 
1036
1217
  ```
1037
1218
  USAGE
1038
- $ fcode team:status
1219
+ $ fcode setup-debug
1039
1220
 
1040
1221
  DESCRIPTION
1041
- Show whether team settings (timezone, error handler, inheritance) differ from the cloud
1222
+ Setup vscode debug configurations
1042
1223
 
1043
1224
  EXAMPLES
1044
- $ fcode team:status
1225
+ $ fcode setup-debug
1045
1226
  ```
1046
1227
 
1047
- ## `fcode team:versions:create TAG`
1228
+ ## `fcode status`
1048
1229
 
1049
- 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
1050
1231
 
1051
1232
  ```
1052
1233
  USAGE
1053
- $ fcode team:versions:create TAG [-c <value>]
1054
-
1055
- ARGUMENTS
1056
- TAG version tag to publish (e.g. v1.0.0)
1234
+ $ fcode status [--showInherited]
1057
1235
 
1058
1236
  FLAGS
1059
- -c, --comment=<value> comment describing the version
1237
+ --showInherited Also list inherited resources that have no changes
1060
1238
 
1061
1239
  DESCRIPTION
1062
- Publish a team version: creates a version with the tag on every owned process and module (existing tags are skipped)
1063
- and pins bare module imports in the published snapshots
1240
+ Show team workspace status
1064
1241
 
1065
1242
  EXAMPLES
1066
- $ fcode team:versions:create v1.0.0
1243
+ $ fcode status
1067
1244
 
1068
- $ fcode team:versions:create v1.0.0 --comment "First stable release"
1245
+ $ fcode status --showInherited
1069
1246
  ```
1070
1247
 
1071
- ## `fcode team:versions:delete TAG`
1248
+ ## `fcode team:clone [TEAMID]`
1072
1249
 
1073
- 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
1074
1251
 
1075
1252
  ```
1076
1253
  USAGE
1077
- $ fcode team:versions:delete TAG [-f]
1254
+ $ fcode team:clone [TEAMID] [--skipSkillsSetup]
1078
1255
 
1079
1256
  ARGUMENTS
1080
- TAG version tag to delete
1257
+ [TEAMID] development team id (run without it to list the teams you belong to)
1081
1258
 
1082
1259
  FLAGS
1083
- -f, --force Force command
1260
+ --skipSkillsSetup Skip installation of the Factorial Code agent skills
1084
1261
 
1085
1262
  DESCRIPTION
1086
- Delete a team version. CASCADES: every owned process/module version with the tag is deleted, together with the
1087
- 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
1088
1264
 
1089
1265
  EXAMPLES
1090
- $ fcode team:versions:delete v1.0.0
1266
+ $ fcode team:clone
1267
+
1268
+ $ fcode team:clone 0f9c1a2b-3d4e-5f60-8a1b-2c3d4e5f6071
1091
1269
  ```
1092
1270
 
1093
- ## `fcode team:versions:list`
1271
+ ## `fcode team:pull`
1094
1272
 
1095
- List the team versions published on the active team workspace
1273
+ Pull every App of the development team folder: clones Apps added since the last run and pulls each App's workspace
1096
1274
 
1097
1275
  ```
1098
1276
  USAGE
1099
- $ fcode team:versions:list
1277
+ $ fcode team:pull
1100
1278
 
1101
1279
  DESCRIPTION
1102
- List the team versions published on the active team workspace
1280
+ Pull every App of the development team folder: clones Apps added since the last run and pulls each App's workspace
1103
1281
 
1104
1282
  EXAMPLES
1105
- $ fcode team:versions:list
1283
+ $ fcode team:pull
1284
+ ```
1285
+
1286
+ ## `fcode team:status`
1287
+
1288
+ Show what differs from the cloud in every App workspace of the development team folder
1289
+
1290
+ ```
1291
+ USAGE
1292
+ $ fcode team:status
1293
+
1294
+ DESCRIPTION
1295
+ Show what differs from the cloud in every App workspace of the development team folder
1296
+
1297
+ EXAMPLES
1298
+ $ fcode team:status
1106
1299
  ```
1107
1300
 
1108
1301
  ## `fcode test [SLUG]`
@@ -1171,6 +1364,27 @@ EXAMPLES
1171
1364
  $ fcode variables:add
1172
1365
  ```
1173
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
+
1174
1388
  ## `fcode variables:pull [RESOURCESLUG]`
1175
1389
 
1176
1390
  Fetch all variables from cloud and save them locally
@@ -1255,11 +1469,14 @@ List all variables status
1255
1469
 
1256
1470
  ```
1257
1471
  USAGE
1258
- $ fcode variables:status [RESOURCESLUG]
1472
+ $ fcode variables:status [RESOURCESLUG] [--showInherited]
1259
1473
 
1260
1474
  ARGUMENTS
1261
1475
  [RESOURCESLUG] Resource slug
1262
1476
 
1477
+ FLAGS
1478
+ --showInherited Also list inherited resources that have no changes
1479
+
1263
1480
  DESCRIPTION
1264
1481
  List all variables status
1265
1482