@sonisoft/now-sdk-ext-cli 5.0.1 → 5.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -689,7 +689,7 @@ $ npm install -g @sonisoft/now-sdk-ext-cli
689
689
  $ nex COMMAND
690
690
  running command...
691
691
  $ nex (--version)
692
- @sonisoft/now-sdk-ext-cli/5.0.1 linux-x64 node-v26.5.0
692
+ @sonisoft/now-sdk-ext-cli/5.2.0 linux-x64 node-v26.5.0
693
693
  $ nex --help [COMMAND]
694
694
  USAGE
695
695
  $ nex COMMAND
@@ -697,6 +697,31 @@ USAGE
697
697
  ```
698
698
  <!-- usagestop -->
699
699
 
700
+
701
+ ## Restricting what can be changed
702
+
703
+ Changes to a ServiceNow instance are **permitted by default**. Two ways to take that
704
+ away, in priority order:
705
+
706
+ | | | Reachable by an agent? |
707
+ |---|---|---|
708
+ | `NEX_POLICY_DENY=write,execute` (or `all`) | environment | **No** |
709
+ | `--read-only`, `--deny-write`, `--deny-execute` | per invocation | Yes |
710
+
711
+ Reads are never gated. `nex policy status` prints what is permitted and which layer
712
+ decided — use it first when something is refused, since the fix differs completely
713
+ between an environment variable and a flag.
714
+
715
+ A malformed value **fails closed**: `NEX_POLICY_DENY=wrtie` denies everything and warns,
716
+ rather than silently denying nothing.
717
+
718
+ > `NEX_POLICY_DENY` holds only when set somewhere an agent cannot write — a shell
719
+ > profile, a systemd unit, or a container environment. **Not** a committed `.env` or a
720
+ > project-local config file, which anything with file access can edit.
721
+ >
722
+ > This is a guardrail, not a security boundary. Anything holding the credential can
723
+ > reach the instance directly.
724
+
700
725
  # Commands
701
726
  <!-- commands -->
702
727
  * [`nex aggregate count`](#nex-aggregate-count)
@@ -746,6 +771,7 @@ USAGE
746
771
  * [`nex plugins uninstall [PLUGIN]`](#nex-plugins-uninstall-plugin)
747
772
  * [`nex plugins unlink [PLUGIN]`](#nex-plugins-unlink-plugin)
748
773
  * [`nex plugins update`](#nex-plugins-update)
774
+ * [`nex policy status`](#nex-policy-status)
749
775
  * [`nex query`](#nex-query)
750
776
  * [`nex query app`](#nex-query-app)
751
777
  * [`nex query columns`](#nex-query-columns)
@@ -789,8 +815,8 @@ Count records in a ServiceNow table.
789
815
 
790
816
  ```
791
817
  USAGE
792
- $ nex aggregate count -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-q
793
- <value>]
818
+ $ nex aggregate count -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
819
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>]
794
820
 
795
821
  FLAGS
796
822
  -a, --auth=<value> Auth alias to use.
@@ -801,8 +827,16 @@ FLAGS
801
827
  GLOBAL FLAGS
802
828
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
803
829
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
830
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
831
+ --deny-write Refuse any change to instance data for this invocation.
832
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
833
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
834
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
835
+ stderr only.
804
836
  --log-level=<option> [default: info] Specify level for logging.
805
837
  <options: debug|warn|error|info|trace>
838
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
839
+ unaffected.
806
840
 
807
841
  DESCRIPTION
808
842
  Count records in a ServiceNow table.
@@ -828,7 +862,7 @@ EXAMPLES
828
862
  $ nex aggregate count --table incident --query "active=true" --json --auth dev
829
863
  ```
830
864
 
831
- _See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/aggregate/count.ts)_
865
+ _See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/aggregate/count.ts)_
832
866
 
833
867
  ## `nex aggregate group`
834
868
 
@@ -836,9 +870,9 @@ Run a grouped aggregate query on a ServiceNow table.
836
870
 
837
871
  ```
838
872
  USAGE
839
- $ nex aggregate group -t <value> -g <value>... [-j] [-a <value>] [--cred-store] [--log-level
840
- debug|warn|error|info|trace] [-q <value>] [-c] [--avg <value>...] [--min <value>...] [--max <value>...] [--sum
841
- <value>...] [--having <value>] [-d]
873
+ $ nex aggregate group -t <value> -g <value>... [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
874
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>] [-c] [--avg
875
+ <value>...] [--min <value>...] [--max <value>...] [--sum <value>...] [--having <value>] [-d]
842
876
 
843
877
  FLAGS
844
878
  -a, --auth=<value> Auth alias to use.
@@ -857,8 +891,16 @@ FLAGS
857
891
  GLOBAL FLAGS
858
892
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
859
893
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
894
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
895
+ --deny-write Refuse any change to instance data for this invocation.
896
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
897
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
898
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
899
+ stderr only.
860
900
  --log-level=<option> [default: info] Specify level for logging.
861
901
  <options: debug|warn|error|info|trace>
902
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
903
+ unaffected.
862
904
 
863
905
  DESCRIPTION
864
906
  Run a grouped aggregate query on a ServiceNow table.
@@ -888,7 +930,7 @@ EXAMPLES
888
930
  $ nex aggregate group --table incident --group-by priority --count --having "count>10" --auth dev
889
931
  ```
890
932
 
891
- _See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/aggregate/group.ts)_
933
+ _See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/aggregate/group.ts)_
892
934
 
893
935
  ## `nex aggregate query`
894
936
 
@@ -896,8 +938,9 @@ Run aggregate statistics on a ServiceNow table.
896
938
 
897
939
  ```
898
940
  USAGE
899
- $ nex aggregate query -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-q
900
- <value>] [-c] [--avg <value>...] [--min <value>...] [--max <value>...] [--sum <value>...]
941
+ $ nex aggregate query -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
942
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>] [-c] [--avg <value>...]
943
+ [--min <value>...] [--max <value>...] [--sum <value>...]
901
944
 
902
945
  FLAGS
903
946
  -a, --auth=<value> Auth alias to use.
@@ -913,8 +956,16 @@ FLAGS
913
956
  GLOBAL FLAGS
914
957
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
915
958
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
959
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
960
+ --deny-write Refuse any change to instance data for this invocation.
961
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
962
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
963
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
964
+ stderr only.
916
965
  --log-level=<option> [default: info] Specify level for logging.
917
966
  <options: debug|warn|error|info|trace>
967
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
968
+ unaffected.
918
969
 
919
970
  DESCRIPTION
920
971
  Run aggregate statistics on a ServiceNow table.
@@ -942,7 +993,7 @@ EXAMPLES
942
993
  $ nex aggregate query --table incident --sum reassignment_count --json --auth dev
943
994
  ```
944
995
 
945
- _See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/aggregate/query.ts)_
996
+ _See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/aggregate/query.ts)_
946
997
 
947
998
  ## `nex app`
948
999
 
@@ -950,8 +1001,8 @@ Manage ServiceNow applications: uninstall applications from your instance.
950
1001
 
951
1002
  ```
952
1003
  USAGE
953
- $ nex app [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-u] [-i
954
- <value>] [-s <value>]
1004
+ $ nex app [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
1005
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-u] [-i <value>] [-s <value>]
955
1006
 
956
1007
  FLAGS
957
1008
  -a, --auth=<value> Auth alias to use.
@@ -962,9 +1013,17 @@ FLAGS
962
1013
  GLOBAL FLAGS
963
1014
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
964
1015
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1016
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1017
+ --deny-write Refuse any change to instance data for this invocation.
965
1018
  --json Format output as json.
1019
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1020
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1021
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1022
+ stderr only.
966
1023
  --log-level=<option> [default: info] Specify level for logging.
967
1024
  <options: debug|warn|error|info|trace>
1025
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1026
+ unaffected.
968
1027
 
969
1028
  DESCRIPTION
970
1029
  Manage ServiceNow applications: uninstall applications from your instance.
@@ -997,7 +1056,7 @@ EXAMPLES
997
1056
  $ nex app -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
998
1057
  ```
999
1058
 
1000
- _See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/index.ts)_
1059
+ _See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/index.ts)_
1001
1060
 
1002
1061
  ## `nex app install`
1003
1062
 
@@ -1005,8 +1064,8 @@ Install or upgrade multiple ServiceNow applications from a batch definition file
1005
1064
 
1006
1065
  ```
1007
1066
  USAGE
1008
- $ nex app install [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-b] [-d
1009
- <value>]
1067
+ $ nex app install [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
1068
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-b] [-d <value>]
1010
1069
 
1011
1070
  FLAGS
1012
1071
  -a, --auth=<value> Auth alias to use.
@@ -1016,9 +1075,17 @@ FLAGS
1016
1075
  GLOBAL FLAGS
1017
1076
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1018
1077
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1078
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1079
+ --deny-write Refuse any change to instance data for this invocation.
1019
1080
  --json Format output as json.
1081
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1082
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1083
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1084
+ stderr only.
1020
1085
  --log-level=<option> [default: info] Specify level for logging.
1021
1086
  <options: debug|warn|error|info|trace>
1087
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1088
+ unaffected.
1022
1089
 
1023
1090
  DESCRIPTION
1024
1091
  Install or upgrade multiple ServiceNow applications from a batch definition file.
@@ -1057,7 +1124,7 @@ EXAMPLES
1057
1124
  $ nex app install -b -d ./apps.json -a dev-instance --log-level debug
1058
1125
  ```
1059
1126
 
1060
- _See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/install.ts)_
1127
+ _See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/install.ts)_
1061
1128
 
1062
1129
  ## `nex app repo-install`
1063
1130
 
@@ -1065,8 +1132,9 @@ Install an application from your ServiceNow company repository.
1065
1132
 
1066
1133
  ```
1067
1134
  USAGE
1068
- $ nex app repo-install -s <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
1069
- [-w] [--poll-interval <value>] [-t <value>] [-v <value>]
1135
+ $ nex app repo-install -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1136
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-w] [--poll-interval <value>] [-t
1137
+ <value>] [-v <value>]
1070
1138
 
1071
1139
  FLAGS
1072
1140
  -a, --auth=<value> Auth alias to use.
@@ -1079,9 +1147,17 @@ FLAGS
1079
1147
  GLOBAL FLAGS
1080
1148
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1081
1149
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1150
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1151
+ --deny-write Refuse any change to instance data for this invocation.
1082
1152
  --json Format output as json.
1153
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1154
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1155
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1156
+ stderr only.
1083
1157
  --log-level=<option> [default: info] Specify level for logging.
1084
1158
  <options: debug|warn|error|info|trace>
1159
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1160
+ unaffected.
1085
1161
 
1086
1162
  DESCRIPTION
1087
1163
  Install an application from your ServiceNow company repository.
@@ -1133,7 +1209,7 @@ EXAMPLES
1133
1209
  $ nex app repo-install -s x_my_app -a dev-instance --log-level debug
1134
1210
  ```
1135
1211
 
1136
- _See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/repo-install.ts)_
1212
+ _See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/repo-install.ts)_
1137
1213
 
1138
1214
  ## `nex app repo-list`
1139
1215
 
@@ -1141,7 +1217,8 @@ List applications available in your ServiceNow company repository.
1141
1217
 
1142
1218
  ```
1143
1219
  USAGE
1144
- $ nex app repo-list [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-n] [-i]
1220
+ $ nex app repo-list [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
1221
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-n] [-i]
1145
1222
 
1146
1223
  FLAGS
1147
1224
  -a, --auth=<value> Auth alias to use.
@@ -1152,8 +1229,16 @@ FLAGS
1152
1229
  GLOBAL FLAGS
1153
1230
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1154
1231
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1232
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1233
+ --deny-write Refuse any change to instance data for this invocation.
1234
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1235
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1236
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1237
+ stderr only.
1155
1238
  --log-level=<option> [default: info] Specify level for logging.
1156
1239
  <options: debug|warn|error|info|trace>
1240
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1241
+ unaffected.
1157
1242
 
1158
1243
  DESCRIPTION
1159
1244
  List applications available in your ServiceNow company repository.
@@ -1199,7 +1284,7 @@ EXAMPLES
1199
1284
  $ nex app repo-list -a dev-instance
1200
1285
  ```
1201
1286
 
1202
- _See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/repo-list.ts)_
1287
+ _See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/repo-list.ts)_
1203
1288
 
1204
1289
  ## `nex app uninstall`
1205
1290
 
@@ -1207,8 +1292,8 @@ Uninstall a ServiceNow application from your instance.
1207
1292
 
1208
1293
  ```
1209
1294
  USAGE
1210
- $ nex app uninstall -i <value> -s <value> [--json] [-a <value>] [--cred-store] [--log-level
1211
- debug|warn|error|info|trace]
1295
+ $ nex app uninstall -i <value> -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
1296
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
1212
1297
 
1213
1298
  FLAGS
1214
1299
  -a, --auth=<value> Auth alias to use.
@@ -1218,9 +1303,17 @@ FLAGS
1218
1303
  GLOBAL FLAGS
1219
1304
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1220
1305
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1306
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1307
+ --deny-write Refuse any change to instance data for this invocation.
1221
1308
  --json Format output as json.
1309
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1310
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1311
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1312
+ stderr only.
1222
1313
  --log-level=<option> [default: info] Specify level for logging.
1223
1314
  <options: debug|warn|error|info|trace>
1315
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1316
+ unaffected.
1224
1317
 
1225
1318
  DESCRIPTION
1226
1319
  Uninstall a ServiceNow application from your instance.
@@ -1253,7 +1346,7 @@ EXAMPLES
1253
1346
  $ nex app uninstall -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
1254
1347
  ```
1255
1348
 
1256
- _See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/app/uninstall.ts)_
1349
+ _See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/uninstall.ts)_
1257
1350
 
1258
1351
  ## `nex atf`
1259
1352
 
@@ -1261,9 +1354,10 @@ Execute ATF (Automated Test Framework) tests or test suites on a ServiceNow inst
1261
1354
 
1262
1355
  ```
1263
1356
  USAGE
1264
- $ nex atf [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-t <value> | -s
1265
- <value> | -n <value>] [-w] [-p <value>] [-b <value>] [--browser-version <value>] [--os-name <value>] [--os-version
1266
- <value>] [--performance] [--cloud]
1357
+ $ nex atf [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
1358
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-t <value> | -s <value> | -n <value>] [-w] [-p
1359
+ <value>] [-b <value>] [--browser-version <value>] [--os-name <value>] [--os-version <value>] [--performance]
1360
+ [--cloud]
1267
1361
 
1268
1362
  FLAGS
1269
1363
  -a, --auth=<value> Auth alias to use.
@@ -1283,8 +1377,16 @@ FLAGS
1283
1377
  GLOBAL FLAGS
1284
1378
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1285
1379
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1380
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1381
+ --deny-write Refuse any change to instance data for this invocation.
1382
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1383
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1384
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1385
+ stderr only.
1286
1386
  --log-level=<option> [default: info] Specify level for logging.
1287
1387
  <options: debug|warn|error|info|trace>
1388
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1389
+ unaffected.
1288
1390
 
1289
1391
  DESCRIPTION
1290
1392
  Execute ATF (Automated Test Framework) tests or test suites on a ServiceNow instance.
@@ -1327,7 +1429,7 @@ EXAMPLES
1327
1429
  $ nex atf --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance
1328
1430
  ```
1329
1431
 
1330
- _See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/atf/index.ts)_
1432
+ _See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/atf/index.ts)_
1331
1433
 
1332
1434
  ## `nex attachment get`
1333
1435
 
@@ -1335,7 +1437,8 @@ Get metadata for a specific attachment.
1335
1437
 
1336
1438
  ```
1337
1439
  USAGE
1338
- $ nex attachment get -s <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
1440
+ $ nex attachment get -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1441
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
1339
1442
 
1340
1443
  FLAGS
1341
1444
  -a, --auth=<value> Auth alias to use.
@@ -1344,9 +1447,17 @@ FLAGS
1344
1447
  GLOBAL FLAGS
1345
1448
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1346
1449
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1450
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1451
+ --deny-write Refuse any change to instance data for this invocation.
1347
1452
  --json Format output as json.
1453
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1454
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1455
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1456
+ stderr only.
1348
1457
  --log-level=<option> [default: info] Specify level for logging.
1349
1458
  <options: debug|warn|error|info|trace>
1459
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1460
+ unaffected.
1350
1461
 
1351
1462
  DESCRIPTION
1352
1463
  Get metadata for a specific attachment.
@@ -1361,7 +1472,7 @@ EXAMPLES
1361
1472
  $ nex attachment get -s att123 --json --auth dev
1362
1473
  ```
1363
1474
 
1364
- _See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/attachment/get.ts)_
1475
+ _See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/attachment/get.ts)_
1365
1476
 
1366
1477
  ## `nex attachment list`
1367
1478
 
@@ -1369,8 +1480,8 @@ List attachments on a ServiceNow record.
1369
1480
 
1370
1481
  ```
1371
1482
  USAGE
1372
- $ nex attachment list -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-level
1373
- debug|warn|error|info|trace] [--limit <value>]
1483
+ $ nex attachment list -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
1484
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--limit <value>]
1374
1485
 
1375
1486
  FLAGS
1376
1487
  -a, --auth=<value> Auth alias to use.
@@ -1381,9 +1492,17 @@ FLAGS
1381
1492
  GLOBAL FLAGS
1382
1493
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1383
1494
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1495
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1496
+ --deny-write Refuse any change to instance data for this invocation.
1384
1497
  --json Format output as json.
1498
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1499
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1500
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1501
+ stderr only.
1385
1502
  --log-level=<option> [default: info] Specify level for logging.
1386
1503
  <options: debug|warn|error|info|trace>
1504
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1505
+ unaffected.
1387
1506
 
1388
1507
  DESCRIPTION
1389
1508
  List attachments on a ServiceNow record.
@@ -1398,7 +1517,7 @@ EXAMPLES
1398
1517
  $ nex attachment list -t incident -r abc123 --limit 50 --json --auth dev
1399
1518
  ```
1400
1519
 
1401
- _See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/attachment/list.ts)_
1520
+ _See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/attachment/list.ts)_
1402
1521
 
1403
1522
  ## `nex attachment upload`
1404
1523
 
@@ -1406,8 +1525,9 @@ Upload a file as an attachment to a ServiceNow record.
1406
1525
 
1407
1526
  ```
1408
1527
  USAGE
1409
- $ nex attachment upload -f <value> -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-level
1410
- debug|warn|error|info|trace] [--content-type <value>]
1528
+ $ nex attachment upload -f <value> -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute]
1529
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
1530
+ [--content-type <value>]
1411
1531
 
1412
1532
  FLAGS
1413
1533
  -a, --auth=<value> Auth alias to use.
@@ -1419,9 +1539,17 @@ FLAGS
1419
1539
  GLOBAL FLAGS
1420
1540
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1421
1541
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1542
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1543
+ --deny-write Refuse any change to instance data for this invocation.
1422
1544
  --json Format output as json.
1545
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1546
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1547
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1548
+ stderr only.
1423
1549
  --log-level=<option> [default: info] Specify level for logging.
1424
1550
  <options: debug|warn|error|info|trace>
1551
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1552
+ unaffected.
1425
1553
 
1426
1554
  DESCRIPTION
1427
1555
  Upload a file as an attachment to a ServiceNow record.
@@ -1436,7 +1564,7 @@ EXAMPLES
1436
1564
  $ nex attachment upload -t incident -r abc123 -f ./data.csv --content-type text/csv --auth dev
1437
1565
  ```
1438
1566
 
1439
- _See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/attachment/upload.ts)_
1567
+ _See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/attachment/upload.ts)_
1440
1568
 
1441
1569
  ## `nex auth delete [ALIAS]`
1442
1570
 
@@ -1471,7 +1599,7 @@ EXAMPLES
1471
1599
  $ nex auth delete --all
1472
1600
  ```
1473
1601
 
1474
- _See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/auth/delete.ts)_
1602
+ _See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/auth/delete.ts)_
1475
1603
 
1476
1604
  ## `nex auth doctor`
1477
1605
 
@@ -1499,7 +1627,7 @@ EXAMPLES
1499
1627
  $ nex auth doctor --json
1500
1628
  ```
1501
1629
 
1502
- _See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/auth/doctor.ts)_
1630
+ _See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/auth/doctor.ts)_
1503
1631
 
1504
1632
  ## `nex auth list`
1505
1633
 
@@ -1532,7 +1660,7 @@ EXAMPLES
1532
1660
  $ nex auth list --json
1533
1661
  ```
1534
1662
 
1535
- _See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/auth/list.ts)_
1663
+ _See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/auth/list.ts)_
1536
1664
 
1537
1665
  ## `nex auth use ALIAS`
1538
1666
 
@@ -1560,7 +1688,7 @@ EXAMPLES
1560
1688
  $ nex auth use dev206299
1561
1689
  ```
1562
1690
 
1563
- _See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/auth/use.ts)_
1691
+ _See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/auth/use.ts)_
1564
1692
 
1565
1693
  ## `nex autocomplete [SHELL]`
1566
1694
 
@@ -1591,7 +1719,7 @@ EXAMPLES
1591
1719
  $ nex autocomplete --refresh-cache
1592
1720
  ```
1593
1721
 
1594
- _See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.54/src/commands/autocomplete/index.ts)_
1722
+ _See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.55/src/commands/autocomplete/index.ts)_
1595
1723
 
1596
1724
  ## `nex batch create`
1597
1725
 
@@ -1599,8 +1727,8 @@ Batch create records on a ServiceNow instance from a JSON file.
1599
1727
 
1600
1728
  ```
1601
1729
  USAGE
1602
- $ nex batch create -f <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
1603
- [--transaction]
1730
+ $ nex batch create -f <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1731
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--transaction]
1604
1732
 
1605
1733
  FLAGS
1606
1734
  -a, --auth=<value> Auth alias to use.
@@ -1610,9 +1738,17 @@ FLAGS
1610
1738
  GLOBAL FLAGS
1611
1739
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1612
1740
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1741
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1742
+ --deny-write Refuse any change to instance data for this invocation.
1613
1743
  --json Format output as json.
1744
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1745
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1746
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1747
+ stderr only.
1614
1748
  --log-level=<option> [default: info] Specify level for logging.
1615
1749
  <options: debug|warn|error|info|trace>
1750
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1751
+ unaffected.
1616
1752
 
1617
1753
  DESCRIPTION
1618
1754
  Batch create records on a ServiceNow instance from a JSON file.
@@ -1627,7 +1763,7 @@ EXAMPLES
1627
1763
  $ nex batch create --file ./records.json --no-transaction --auth dev
1628
1764
  ```
1629
1765
 
1630
- _See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/batch/create.ts)_
1766
+ _See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/batch/create.ts)_
1631
1767
 
1632
1768
  ## `nex batch update`
1633
1769
 
@@ -1635,8 +1771,8 @@ Batch update records on a ServiceNow instance from a JSON file.
1635
1771
 
1636
1772
  ```
1637
1773
  USAGE
1638
- $ nex batch update -f <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
1639
- [--stop-on-error]
1774
+ $ nex batch update -f <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1775
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--stop-on-error]
1640
1776
 
1641
1777
  FLAGS
1642
1778
  -a, --auth=<value> Auth alias to use.
@@ -1646,9 +1782,17 @@ FLAGS
1646
1782
  GLOBAL FLAGS
1647
1783
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1648
1784
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1785
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1786
+ --deny-write Refuse any change to instance data for this invocation.
1649
1787
  --json Format output as json.
1788
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1789
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1790
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1791
+ stderr only.
1650
1792
  --log-level=<option> [default: info] Specify level for logging.
1651
1793
  <options: debug|warn|error|info|trace>
1794
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1795
+ unaffected.
1652
1796
 
1653
1797
  DESCRIPTION
1654
1798
  Batch update records on a ServiceNow instance from a JSON file.
@@ -1663,7 +1807,7 @@ EXAMPLES
1663
1807
  $ nex batch update --file ./updates.json --stop-on-error --auth dev
1664
1808
  ```
1665
1809
 
1666
- _See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/batch/update.ts)_
1810
+ _See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/batch/update.ts)_
1667
1811
 
1668
1812
  ## `nex bulk delete`
1669
1813
 
@@ -1671,8 +1815,8 @@ Bulk delete records matching an encoded query.
1671
1815
 
1672
1816
  ```
1673
1817
  USAGE
1674
- $ nex bulk delete -t <value> -q <value> [-j] [-a <value>] [--cred-store] [--log-level
1675
- debug|warn|error|info|trace] [--confirm] [-l <value>]
1818
+ $ nex bulk delete -t <value> -q <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
1819
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--confirm] [-l <value>]
1676
1820
 
1677
1821
  FLAGS
1678
1822
  -a, --auth=<value> Auth alias to use.
@@ -1685,8 +1829,16 @@ FLAGS
1685
1829
  GLOBAL FLAGS
1686
1830
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1687
1831
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1832
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1833
+ --deny-write Refuse any change to instance data for this invocation.
1834
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1835
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1836
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1837
+ stderr only.
1688
1838
  --log-level=<option> [default: info] Specify level for logging.
1689
1839
  <options: debug|warn|error|info|trace>
1840
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1841
+ unaffected.
1690
1842
 
1691
1843
  DESCRIPTION
1692
1844
  Bulk delete records matching an encoded query.
@@ -1719,7 +1871,7 @@ EXAMPLES
1719
1871
  $ nex bulk delete --table u_staging --query "processed=true" --confirm --json --auth dev
1720
1872
  ```
1721
1873
 
1722
- _See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/bulk/delete.ts)_
1874
+ _See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/bulk/delete.ts)_
1723
1875
 
1724
1876
  ## `nex bulk update`
1725
1877
 
@@ -1727,8 +1879,9 @@ Bulk update records matching an encoded query.
1727
1879
 
1728
1880
  ```
1729
1881
  USAGE
1730
- $ nex bulk update -t <value> -q <value> -d <value> [-j] [-a <value>] [--cred-store] [--log-level
1731
- debug|warn|error|info|trace] [--confirm] [-l <value>]
1882
+ $ nex bulk update -t <value> -q <value> -d <value> [-j] [-a <value>] [--cred-store] [--deny-execute]
1883
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--confirm]
1884
+ [-l <value>]
1732
1885
 
1733
1886
  FLAGS
1734
1887
  -a, --auth=<value> Auth alias to use.
@@ -1742,8 +1895,16 @@ FLAGS
1742
1895
  GLOBAL FLAGS
1743
1896
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1744
1897
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1898
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1899
+ --deny-write Refuse any change to instance data for this invocation.
1900
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1901
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1902
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1903
+ stderr only.
1745
1904
  --log-level=<option> [default: info] Specify level for logging.
1746
1905
  <options: debug|warn|error|info|trace>
1906
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1907
+ unaffected.
1747
1908
 
1748
1909
  DESCRIPTION
1749
1910
  Bulk update records matching an encoded query.
@@ -1779,7 +1940,7 @@ EXAMPLES
1779
1940
  $ nex bulk update --table incident --query "active=true" --data '{"state":"6"}' --confirm --json --auth dev
1780
1941
  ```
1781
1942
 
1782
- _See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/bulk/update.ts)_
1943
+ _See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/bulk/update.ts)_
1783
1944
 
1784
1945
  ## `nex exec SCOPE [FILE]`
1785
1946
 
@@ -1787,8 +1948,8 @@ Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.
1787
1948
 
1788
1949
  ```
1789
1950
  USAGE
1790
- $ nex exec SCOPE [FILE] [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
1791
- [-p <value>]
1951
+ $ nex exec SCOPE [FILE] [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1952
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-p <value>]
1792
1953
 
1793
1954
  ARGUMENTS
1794
1955
  SCOPE Scope to execute script in. Use "global" for global scope.
@@ -1801,9 +1962,17 @@ FLAGS
1801
1962
  GLOBAL FLAGS
1802
1963
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1803
1964
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1965
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1966
+ --deny-write Refuse any change to instance data for this invocation.
1804
1967
  --json Format output as json.
1968
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1969
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1970
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1971
+ stderr only.
1805
1972
  --log-level=<option> [default: info] Specify level for logging.
1806
1973
  <options: debug|warn|error|info|trace>
1974
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1975
+ unaffected.
1807
1976
 
1808
1977
  DESCRIPTION
1809
1978
  Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.
@@ -1901,7 +2070,7 @@ EXAMPLES
1901
2070
  $ nex exec global ./script.js --auth dev-instance --params '{"token":"abc123","env":"dev"}'
1902
2071
  ```
1903
2072
 
1904
- _See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/exec/index.ts)_
2073
+ _See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/exec/index.ts)_
1905
2074
 
1906
2075
  ## `nex flow action`
1907
2076
 
@@ -1909,8 +2078,9 @@ Execute a Flow Designer action by scoped name.
1909
2078
 
1910
2079
  ```
1911
2080
  USAGE
1912
- $ nex flow action -n <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-i
1913
- <value>] [-m foreground|background] [--scope <value>] [--quick]
2081
+ $ nex flow action -n <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2082
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-i <value>] [-m
2083
+ foreground|background] [--scope <value>] [--quick]
1914
2084
 
1915
2085
  FLAGS
1916
2086
  -a, --auth=<value> Auth alias to use.
@@ -1925,8 +2095,16 @@ FLAGS
1925
2095
  GLOBAL FLAGS
1926
2096
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1927
2097
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2098
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2099
+ --deny-write Refuse any change to instance data for this invocation.
2100
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2101
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2102
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2103
+ stderr only.
1928
2104
  --log-level=<option> [default: info] Specify level for logging.
1929
2105
  <options: debug|warn|error|info|trace>
2106
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2107
+ unaffected.
1930
2108
 
1931
2109
  DESCRIPTION
1932
2110
  Execute a Flow Designer action by scoped name.
@@ -1946,7 +2124,7 @@ EXAMPLES
1946
2124
  '{"table":"incident","values":{"short_description":"Test"}}' --auth dev
1947
2125
  ```
1948
2126
 
1949
- _See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/action.ts)_
2127
+ _See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/action.ts)_
1950
2128
 
1951
2129
  ## `nex flow cancel`
1952
2130
 
@@ -1954,8 +2132,8 @@ Cancel a running or paused flow execution.
1954
2132
 
1955
2133
  ```
1956
2134
  USAGE
1957
- $ nex flow cancel -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-r
1958
- <value>] [--scope <value>]
2135
+ $ nex flow cancel -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2136
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-r <value>] [--scope <value>]
1959
2137
 
1960
2138
  FLAGS
1961
2139
  -a, --auth=<value> Auth alias to use.
@@ -1967,8 +2145,16 @@ FLAGS
1967
2145
  GLOBAL FLAGS
1968
2146
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1969
2147
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2148
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2149
+ --deny-write Refuse any change to instance data for this invocation.
2150
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2151
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2152
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2153
+ stderr only.
1970
2154
  --log-level=<option> [default: info] Specify level for logging.
1971
2155
  <options: debug|warn|error|info|trace>
2156
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2157
+ unaffected.
1972
2158
 
1973
2159
  DESCRIPTION
1974
2160
  Cancel a running or paused flow execution.
@@ -1985,7 +2171,7 @@ EXAMPLES
1985
2171
  $ nex flow cancel --context-id abc123def456 --reason "No longer needed" --auth dev
1986
2172
  ```
1987
2173
 
1988
- _See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/cancel.ts)_
2174
+ _See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/cancel.ts)_
1989
2175
 
1990
2176
  ## `nex flow copy`
1991
2177
 
@@ -1993,8 +2179,8 @@ Copy an existing flow into a target scoped application.
1993
2179
 
1994
2180
  ```
1995
2181
  USAGE
1996
- $ nex flow copy -s <value> -n <value> -t <value> [-j] [-a <value>] [--cred-store] [--log-level
1997
- debug|warn|error|info|trace]
2182
+ $ nex flow copy -s <value> -n <value> -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute]
2183
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
1998
2184
 
1999
2185
  FLAGS
2000
2186
  -a, --auth=<value> Auth alias to use.
@@ -2007,8 +2193,16 @@ FLAGS
2007
2193
  GLOBAL FLAGS
2008
2194
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2009
2195
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2196
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2197
+ --deny-write Refuse any change to instance data for this invocation.
2198
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2199
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2200
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2201
+ stderr only.
2010
2202
  --log-level=<option> [default: info] Specify level for logging.
2011
2203
  <options: debug|warn|error|info|trace>
2204
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2205
+ unaffected.
2012
2206
 
2013
2207
  DESCRIPTION
2014
2208
  Copy an existing flow into a target scoped application.
@@ -2042,7 +2236,7 @@ EXAMPLES
2042
2236
  dev
2043
2237
  ```
2044
2238
 
2045
- _See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/copy.ts)_
2239
+ _See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/copy.ts)_
2046
2240
 
2047
2241
  ## `nex flow details`
2048
2242
 
@@ -2050,8 +2244,8 @@ Get rich execution details for a flow context.
2050
2244
 
2051
2245
  ```
2052
2246
  USAGE
2053
- $ nex flow details -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
2054
- [--scope <value>] [-d]
2247
+ $ nex flow details -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2248
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>] [-d]
2055
2249
 
2056
2250
  FLAGS
2057
2251
  -a, --auth=<value> Auth alias to use.
@@ -2063,8 +2257,16 @@ FLAGS
2063
2257
  GLOBAL FLAGS
2064
2258
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2065
2259
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2260
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2261
+ --deny-write Refuse any change to instance data for this invocation.
2262
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2263
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2264
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2265
+ stderr only.
2066
2266
  --log-level=<option> [default: info] Specify level for logging.
2067
2267
  <options: debug|warn|error|info|trace>
2268
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2269
+ unaffected.
2068
2270
 
2069
2271
  DESCRIPTION
2070
2272
  Get rich execution details for a flow context.
@@ -2095,7 +2297,7 @@ EXAMPLES
2095
2297
  $ nex flow details -c d4e5f6789012345678abcdef01234567 --json --auth dev
2096
2298
  ```
2097
2299
 
2098
- _See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/details.ts)_
2300
+ _See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/details.ts)_
2099
2301
 
2100
2302
  ## `nex flow error`
2101
2303
 
@@ -2103,8 +2305,8 @@ Retrieve error details from a failed flow execution.
2103
2305
 
2104
2306
  ```
2105
2307
  USAGE
2106
- $ nex flow error -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
2107
- [--scope <value>]
2308
+ $ nex flow error -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2309
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>]
2108
2310
 
2109
2311
  FLAGS
2110
2312
  -a, --auth=<value> Auth alias to use.
@@ -2115,8 +2317,16 @@ FLAGS
2115
2317
  GLOBAL FLAGS
2116
2318
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2117
2319
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2320
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2321
+ --deny-write Refuse any change to instance data for this invocation.
2322
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2323
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2324
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2325
+ stderr only.
2118
2326
  --log-level=<option> [default: info] Specify level for logging.
2119
2327
  <options: debug|warn|error|info|trace>
2328
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2329
+ unaffected.
2120
2330
 
2121
2331
  DESCRIPTION
2122
2332
  Retrieve error details from a failed flow execution.
@@ -2129,7 +2339,7 @@ EXAMPLES
2129
2339
  $ nex flow error --context-id abc123def456 --auth dev
2130
2340
  ```
2131
2341
 
2132
- _See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/error.ts)_
2342
+ _See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/error.ts)_
2133
2343
 
2134
2344
  ## `nex flow logs`
2135
2345
 
@@ -2137,8 +2347,8 @@ Retrieve flow execution log entries for a given context.
2137
2347
 
2138
2348
  ```
2139
2349
  USAGE
2140
- $ nex flow logs -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-l
2141
- <value>] [-o asc|desc]
2350
+ $ nex flow logs -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2351
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l <value>] [-o asc|desc]
2142
2352
 
2143
2353
  FLAGS
2144
2354
  -a, --auth=<value> Auth alias to use.
@@ -2151,8 +2361,16 @@ FLAGS
2151
2361
  GLOBAL FLAGS
2152
2362
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2153
2363
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2364
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2365
+ --deny-write Refuse any change to instance data for this invocation.
2366
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2367
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2368
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2369
+ stderr only.
2154
2370
  --log-level=<option> [default: info] Specify level for logging.
2155
2371
  <options: debug|warn|error|info|trace>
2372
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2373
+ unaffected.
2156
2374
 
2157
2375
  DESCRIPTION
2158
2376
  Retrieve flow execution log entries for a given context.
@@ -2179,7 +2397,7 @@ EXAMPLES
2179
2397
  $ nex flow logs -c d4e5f6789012345678abcdef01234567 --json --auth dev
2180
2398
  ```
2181
2399
 
2182
- _See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/logs.ts)_
2400
+ _See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/logs.ts)_
2183
2401
 
2184
2402
  ## `nex flow message`
2185
2403
 
@@ -2187,8 +2405,9 @@ Send a message to a paused flow execution.
2187
2405
 
2188
2406
  ```
2189
2407
  USAGE
2190
- $ nex flow message -c <value> -m <value> [-j] [-a <value>] [--cred-store] [--log-level
2191
- debug|warn|error|info|trace] [-p <value>] [--scope <value>]
2408
+ $ nex flow message -c <value> -m <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
2409
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-p <value>] [--scope
2410
+ <value>]
2192
2411
 
2193
2412
  FLAGS
2194
2413
  -a, --auth=<value> Auth alias to use.
@@ -2201,8 +2420,16 @@ FLAGS
2201
2420
  GLOBAL FLAGS
2202
2421
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2203
2422
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2423
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2424
+ --deny-write Refuse any change to instance data for this invocation.
2425
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2426
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2427
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2428
+ stderr only.
2204
2429
  --log-level=<option> [default: info] Specify level for logging.
2205
2430
  <options: debug|warn|error|info|trace>
2431
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2432
+ unaffected.
2206
2433
 
2207
2434
  DESCRIPTION
2208
2435
  Send a message to a paused flow execution.
@@ -2220,7 +2447,7 @@ EXAMPLES
2220
2447
  $ nex flow message --context-id abc123def456 --message "data_ready" --payload '{"status":"ok"}' --auth dev
2221
2448
  ```
2222
2449
 
2223
- _See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/message.ts)_
2450
+ _See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/message.ts)_
2224
2451
 
2225
2452
  ## `nex flow outputs`
2226
2453
 
@@ -2228,8 +2455,8 @@ Retrieve outputs from a completed flow execution.
2228
2455
 
2229
2456
  ```
2230
2457
  USAGE
2231
- $ nex flow outputs -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
2232
- [--scope <value>]
2458
+ $ nex flow outputs -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2459
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>]
2233
2460
 
2234
2461
  FLAGS
2235
2462
  -a, --auth=<value> Auth alias to use.
@@ -2240,8 +2467,16 @@ FLAGS
2240
2467
  GLOBAL FLAGS
2241
2468
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2242
2469
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2470
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2471
+ --deny-write Refuse any change to instance data for this invocation.
2472
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2473
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2474
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2475
+ stderr only.
2243
2476
  --log-level=<option> [default: info] Specify level for logging.
2244
2477
  <options: debug|warn|error|info|trace>
2478
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2479
+ unaffected.
2245
2480
 
2246
2481
  DESCRIPTION
2247
2482
  Retrieve outputs from a completed flow execution.
@@ -2258,7 +2493,7 @@ EXAMPLES
2258
2493
  $ nex flow outputs --context-id abc123def456 --json --auth dev
2259
2494
  ```
2260
2495
 
2261
- _See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/outputs.ts)_
2496
+ _See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/outputs.ts)_
2262
2497
 
2263
2498
  ## `nex flow run`
2264
2499
 
@@ -2266,8 +2501,9 @@ Execute a published Flow Designer flow by scoped name.
2266
2501
 
2267
2502
  ```
2268
2503
  USAGE
2269
- $ nex flow run -n <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-i
2270
- <value>] [-m foreground|background] [--scope <value>] [--quick]
2504
+ $ nex flow run -n <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2505
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-i <value>] [-m
2506
+ foreground|background] [--scope <value>] [--quick]
2271
2507
 
2272
2508
  FLAGS
2273
2509
  -a, --auth=<value> Auth alias to use.
@@ -2282,8 +2518,16 @@ FLAGS
2282
2518
  GLOBAL FLAGS
2283
2519
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2284
2520
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2521
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2522
+ --deny-write Refuse any change to instance data for this invocation.
2523
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2524
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2525
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2526
+ stderr only.
2285
2527
  --log-level=<option> [default: info] Specify level for logging.
2286
2528
  <options: debug|warn|error|info|trace>
2529
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2530
+ unaffected.
2287
2531
 
2288
2532
  DESCRIPTION
2289
2533
  Execute a published Flow Designer flow by scoped name.
@@ -2315,7 +2559,7 @@ EXAMPLES
2315
2559
  $ nex flow run --name global.my_flow --mode background --auth dev
2316
2560
  ```
2317
2561
 
2318
- _See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/run.ts)_
2562
+ _See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/run.ts)_
2319
2563
 
2320
2564
  ## `nex flow status`
2321
2565
 
@@ -2323,8 +2567,8 @@ Get the status of a flow execution context.
2323
2567
 
2324
2568
  ```
2325
2569
  USAGE
2326
- $ nex flow status -c <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
2327
- [--scope <value>]
2570
+ $ nex flow status -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2571
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>]
2328
2572
 
2329
2573
  FLAGS
2330
2574
  -a, --auth=<value> Auth alias to use.
@@ -2335,8 +2579,16 @@ FLAGS
2335
2579
  GLOBAL FLAGS
2336
2580
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2337
2581
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2582
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2583
+ --deny-write Refuse any change to instance data for this invocation.
2584
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2585
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2586
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2587
+ stderr only.
2338
2588
  --log-level=<option> [default: info] Specify level for logging.
2339
2589
  <options: debug|warn|error|info|trace>
2590
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2591
+ unaffected.
2340
2592
 
2341
2593
  DESCRIPTION
2342
2594
  Get the status of a flow execution context.
@@ -2351,7 +2603,7 @@ EXAMPLES
2351
2603
  $ nex flow status --context-id abc123def456 --auth dev
2352
2604
  ```
2353
2605
 
2354
- _See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/status.ts)_
2606
+ _See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/status.ts)_
2355
2607
 
2356
2608
  ## `nex flow subflow`
2357
2609
 
@@ -2359,8 +2611,9 @@ Execute a published Flow Designer subflow by scoped name.
2359
2611
 
2360
2612
  ```
2361
2613
  USAGE
2362
- $ nex flow subflow -n <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-i
2363
- <value>] [-m foreground|background] [--scope <value>] [--quick]
2614
+ $ nex flow subflow -n <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2615
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-i <value>] [-m
2616
+ foreground|background] [--scope <value>] [--quick]
2364
2617
 
2365
2618
  FLAGS
2366
2619
  -a, --auth=<value> Auth alias to use.
@@ -2375,8 +2628,16 @@ FLAGS
2375
2628
  GLOBAL FLAGS
2376
2629
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2377
2630
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2631
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2632
+ --deny-write Refuse any change to instance data for this invocation.
2633
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2634
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2635
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2636
+ stderr only.
2378
2637
  --log-level=<option> [default: info] Specify level for logging.
2379
2638
  <options: debug|warn|error|info|trace>
2639
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2640
+ unaffected.
2380
2641
 
2381
2642
  DESCRIPTION
2382
2643
  Execute a published Flow Designer subflow by scoped name.
@@ -2402,7 +2663,7 @@ EXAMPLES
2402
2663
  $ nex flow subflow --name x_myapp.process_record --inputs '{"table":"incident","sys_id":"abc123"}' --auth dev
2403
2664
  ```
2404
2665
 
2405
- _See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/subflow.ts)_
2666
+ _See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/subflow.ts)_
2406
2667
 
2407
2668
  ## `nex flow test`
2408
2669
 
@@ -2410,8 +2671,9 @@ Test a Flow Designer flow without requiring it to be published.
2410
2671
 
2411
2672
  ```
2412
2673
  USAGE
2413
- $ nex flow test -f <value> -o <value> [-j] [-a <value>] [--cred-store] [--log-level
2414
- debug|warn|error|info|trace] [--scope <value>] [--synchronous]
2674
+ $ nex flow test -f <value> -o <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
2675
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>]
2676
+ [--synchronous]
2415
2677
 
2416
2678
  FLAGS
2417
2679
  -a, --auth=<value> Auth alias to use.
@@ -2425,8 +2687,16 @@ FLAGS
2425
2687
  GLOBAL FLAGS
2426
2688
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2427
2689
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2690
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2691
+ --deny-write Refuse any change to instance data for this invocation.
2692
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2693
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2694
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2695
+ stderr only.
2428
2696
  --log-level=<option> [default: info] Specify level for logging.
2429
2697
  <options: debug|warn|error|info|trace>
2698
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2699
+ unaffected.
2430
2700
 
2431
2701
  DESCRIPTION
2432
2702
  Test a Flow Designer flow without requiring it to be published.
@@ -2456,7 +2726,7 @@ EXAMPLES
2456
2726
  $ nex flow test -f 887dda5583237210fdb8f7b6feaad32c -o '{"current":"abc123"}' --json --auth dev
2457
2727
  ```
2458
2728
 
2459
- _See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/flow/test.ts)_
2729
+ _See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/test.ts)_
2460
2730
 
2461
2731
  ## `nex health check`
2462
2732
 
@@ -2464,9 +2734,9 @@ Run a consolidated health check on a ServiceNow instance.
2464
2734
 
2465
2735
  ```
2466
2736
  USAGE
2467
- $ nex health check [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
2468
- [--include-version] [--include-cluster] [--include-stuck-jobs] [--include-semaphores] [--include-operational-counts]
2469
- [--stuck-job-threshold <value>]
2737
+ $ nex health check [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
2738
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--include-version] [--include-cluster]
2739
+ [--include-stuck-jobs] [--include-semaphores] [--include-operational-counts] [--stuck-job-threshold <value>]
2470
2740
 
2471
2741
  FLAGS
2472
2742
  -a, --auth=<value> Auth alias to use.
@@ -2481,8 +2751,16 @@ FLAGS
2481
2751
  GLOBAL FLAGS
2482
2752
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2483
2753
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2754
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2755
+ --deny-write Refuse any change to instance data for this invocation.
2756
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2757
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2758
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2759
+ stderr only.
2484
2760
  --log-level=<option> [default: info] Specify level for logging.
2485
2761
  <options: debug|warn|error|info|trace>
2762
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2763
+ unaffected.
2486
2764
 
2487
2765
  DESCRIPTION
2488
2766
  Run a consolidated health check on a ServiceNow instance.
@@ -2518,7 +2796,7 @@ EXAMPLES
2518
2796
  $ nex health check --json --auth dev
2519
2797
  ```
2520
2798
 
2521
- _See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/health/check.ts)_
2799
+ _See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/health/check.ts)_
2522
2800
 
2523
2801
  ## `nex help [COMMAND]`
2524
2802
 
@@ -2538,7 +2816,7 @@ DESCRIPTION
2538
2816
  Display help for nex.
2539
2817
  ```
2540
2818
 
2541
- _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.55/src/commands/help.ts)_
2819
+ _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.56/src/commands/help.ts)_
2542
2820
 
2543
2821
  ## `nex log`
2544
2822
 
@@ -2546,8 +2824,9 @@ Tail and monitor ServiceNow system logs in real-time with beautiful formatting.
2546
2824
 
2547
2825
  ```
2548
2826
  USAGE
2549
- $ nex log [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-o <value>]
2550
- [-i <value>] [--no-color] [-f <value>...]
2827
+ $ nex log [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
2828
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-o <value>] [-i <value>] [--no-color] [-f
2829
+ <value>...]
2551
2830
 
2552
2831
  FLAGS
2553
2832
  -a, --auth=<value> Auth alias to use.
@@ -2562,9 +2841,17 @@ FLAGS
2562
2841
  GLOBAL FLAGS
2563
2842
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2564
2843
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2844
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2845
+ --deny-write Refuse any change to instance data for this invocation.
2565
2846
  --json Format output as json.
2847
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2848
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2849
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2850
+ stderr only.
2566
2851
  --log-level=<option> [default: info] Specify level for logging.
2567
2852
  <options: debug|warn|error|info|trace>
2853
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2854
+ unaffected.
2568
2855
 
2569
2856
  DESCRIPTION
2570
2857
  Tail and monitor ServiceNow system logs in real-time with beautiful formatting.
@@ -2645,7 +2932,7 @@ EXAMPLES
2645
2932
  $ nex log --no-color --auth dev-instance
2646
2933
  ```
2647
2934
 
2648
- _See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/log/index.ts)_
2935
+ _See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/log/index.ts)_
2649
2936
 
2650
2937
  ## `nex plugins`
2651
2938
 
@@ -2937,14 +3224,47 @@ DESCRIPTION
2937
3224
 
2938
3225
  _See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.86/src/commands/plugins/update.ts)_
2939
3226
 
3227
+ ## `nex policy status`
3228
+
3229
+ Show what this invocation is permitted to change on the instance, and why.
3230
+
3231
+ ```
3232
+ USAGE
3233
+ $ nex policy status [--json] [--deny-execute] [--deny-write] [--read-only]
3234
+
3235
+ FLAGS
3236
+ --deny-execute Evaluate as if --deny-execute were passed.
3237
+ --deny-write Evaluate as if --deny-write were passed.
3238
+ --read-only Evaluate as if --read-only were passed.
3239
+
3240
+ GLOBAL FLAGS
3241
+ --json Format output as json.
3242
+
3243
+ DESCRIPTION
3244
+ Show what this invocation is permitted to change on the instance, and why.
3245
+
3246
+ Changes are permitted by default. NEX_POLICY_DENY, set in the environment, outranks every command-line flag — that is
3247
+ the only layer an agent driving this CLI cannot reach.
3248
+
3249
+ EXAMPLES
3250
+ $ nex policy status
3251
+
3252
+ $ nex policy status --read-only
3253
+
3254
+ NEX_POLICY_DENY=all nex policy status
3255
+ ```
3256
+
3257
+ _See code: [src/commands/policy/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/policy/status.ts)_
3258
+
2940
3259
  ## `nex query`
2941
3260
 
2942
3261
  Query any ServiceNow table using the Table API.
2943
3262
 
2944
3263
  ```
2945
3264
  USAGE
2946
- $ nex query -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-q
2947
- <value>] [-f <value>] [-d] [-l <value>]
3265
+ $ nex query -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3266
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>] [-f <value>] [-d] [-l
3267
+ <value>]
2948
3268
 
2949
3269
  FLAGS
2950
3270
  -a, --auth=<value> Auth alias to use.
@@ -2958,8 +3278,16 @@ FLAGS
2958
3278
  GLOBAL FLAGS
2959
3279
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2960
3280
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3281
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3282
+ --deny-write Refuse any change to instance data for this invocation.
3283
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3284
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3285
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3286
+ stderr only.
2961
3287
  --log-level=<option> [default: info] Specify level for logging.
2962
3288
  <options: debug|warn|error|info|trace>
3289
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3290
+ unaffected.
2963
3291
 
2964
3292
  DESCRIPTION
2965
3293
  Query any ServiceNow table using the Table API.
@@ -2989,7 +3317,7 @@ EXAMPLES
2989
3317
  $ nex query --table sys_user --query "active=true" --limit 5 --json --auth dev
2990
3318
  ```
2991
3319
 
2992
- _See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/query/index.ts)_
3320
+ _See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/query/index.ts)_
2993
3321
 
2994
3322
  ## `nex query app`
2995
3323
 
@@ -2997,8 +3325,8 @@ Search for applications by name across scoped apps and plugins.
2997
3325
 
2998
3326
  ```
2999
3327
  USAGE
3000
- $ nex query app -s <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-a]
3001
- [-l <value>]
3328
+ $ nex query app -s <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3329
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-a] [-l <value>]
3002
3330
 
3003
3331
  FLAGS
3004
3332
  -a, --active Only show active applications
@@ -3010,8 +3338,16 @@ FLAGS
3010
3338
  GLOBAL FLAGS
3011
3339
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3012
3340
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3341
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3342
+ --deny-write Refuse any change to instance data for this invocation.
3343
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3344
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3345
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3346
+ stderr only.
3013
3347
  --log-level=<option> [default: info] Specify level for logging.
3014
3348
  <options: debug|warn|error|info|trace>
3349
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3350
+ unaffected.
3015
3351
 
3016
3352
  DESCRIPTION
3017
3353
  Search for applications by name across scoped apps and plugins.
@@ -3034,7 +3370,7 @@ EXAMPLES
3034
3370
  $ nex query app --search "HR" --active --auth dev
3035
3371
  ```
3036
3372
 
3037
- _See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/query/app.ts)_
3373
+ _See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/query/app.ts)_
3038
3374
 
3039
3375
  ## `nex query columns`
3040
3376
 
@@ -3042,8 +3378,8 @@ List and search columns (fields) on a ServiceNow table.
3042
3378
 
3043
3379
  ```
3044
3380
  USAGE
3045
- $ nex query columns -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-s
3046
- <value>]
3381
+ $ nex query columns -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3382
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-s <value>]
3047
3383
 
3048
3384
  FLAGS
3049
3385
  -a, --auth=<value> Auth alias to use.
@@ -3054,8 +3390,16 @@ FLAGS
3054
3390
  GLOBAL FLAGS
3055
3391
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3056
3392
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3393
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3394
+ --deny-write Refuse any change to instance data for this invocation.
3395
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3396
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3397
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3398
+ stderr only.
3057
3399
  --log-level=<option> [default: info] Specify level for logging.
3058
3400
  <options: debug|warn|error|info|trace>
3401
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3402
+ unaffected.
3059
3403
 
3060
3404
  DESCRIPTION
3061
3405
  List and search columns (fields) on a ServiceNow table.
@@ -3081,7 +3425,7 @@ EXAMPLES
3081
3425
  $ nex query columns --table incident --json --auth dev
3082
3426
  ```
3083
3427
 
3084
- _See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/query/columns.ts)_
3428
+ _See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/query/columns.ts)_
3085
3429
 
3086
3430
  ## `nex query syslog`
3087
3431
 
@@ -3089,8 +3433,8 @@ Query ServiceNow system logs (one-shot, non-tailing).
3089
3433
 
3090
3434
  ```
3091
3435
  USAGE
3092
- $ nex query syslog [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-q <value>] [-l
3093
- <value>]
3436
+ $ nex query syslog [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
3437
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>] [-l <value>]
3094
3438
 
3095
3439
  FLAGS
3096
3440
  -a, --auth=<value> Auth alias to use.
@@ -3101,8 +3445,16 @@ FLAGS
3101
3445
  GLOBAL FLAGS
3102
3446
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3103
3447
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3448
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3449
+ --deny-write Refuse any change to instance data for this invocation.
3450
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3451
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3452
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3453
+ stderr only.
3104
3454
  --log-level=<option> [default: info] Specify level for logging.
3105
3455
  <options: debug|warn|error|info|trace>
3456
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3457
+ unaffected.
3106
3458
 
3107
3459
  DESCRIPTION
3108
3460
  Query ServiceNow system logs (one-shot, non-tailing).
@@ -3130,7 +3482,7 @@ EXAMPLES
3130
3482
  $ nex query syslog --query "sourceLIKEincident" --json --auth dev
3131
3483
  ```
3132
3484
 
3133
- _See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/query/syslog.ts)_
3485
+ _See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/query/syslog.ts)_
3134
3486
 
3135
3487
  ## `nex schema`
3136
3488
 
@@ -3138,8 +3490,9 @@ Discover and inspect a ServiceNow table schema including fields, types, and rela
3138
3490
 
3139
3491
  ```
3140
3492
  USAGE
3141
- $ nex schema -t <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
3142
- [--include-choices] [--include-relationships] [--include-ui-policies] [--include-business-rules]
3493
+ $ nex schema -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3494
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--include-choices]
3495
+ [--include-relationships] [--include-ui-policies] [--include-business-rules]
3143
3496
 
3144
3497
  FLAGS
3145
3498
  -a, --auth=<value> Auth alias to use.
@@ -3153,8 +3506,16 @@ FLAGS
3153
3506
  GLOBAL FLAGS
3154
3507
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3155
3508
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3509
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3510
+ --deny-write Refuse any change to instance data for this invocation.
3511
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3512
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3513
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3514
+ stderr only.
3156
3515
  --log-level=<option> [default: info] Specify level for logging.
3157
3516
  <options: debug|warn|error|info|trace>
3517
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3518
+ unaffected.
3158
3519
 
3159
3520
  DESCRIPTION
3160
3521
  Discover and inspect a ServiceNow table schema including fields, types, and relationships.
@@ -3180,7 +3541,7 @@ EXAMPLES
3180
3541
  $ nex schema --table incident --include-choices --include-relationships --auth dev
3181
3542
  ```
3182
3543
 
3183
- _See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/schema/index.ts)_
3544
+ _See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/schema/index.ts)_
3184
3545
 
3185
3546
  ## `nex schema field`
3186
3547
 
@@ -3188,8 +3549,8 @@ Get detailed information about a specific field on a ServiceNow table.
3188
3549
 
3189
3550
  ```
3190
3551
  USAGE
3191
- $ nex schema field -t <value> -f <value> [-j] [-a <value>] [--cred-store] [--log-level
3192
- debug|warn|error|info|trace]
3552
+ $ nex schema field -t <value> -f <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
3553
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3193
3554
 
3194
3555
  FLAGS
3195
3556
  -a, --auth=<value> Auth alias to use.
@@ -3200,8 +3561,16 @@ FLAGS
3200
3561
  GLOBAL FLAGS
3201
3562
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3202
3563
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3564
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3565
+ --deny-write Refuse any change to instance data for this invocation.
3566
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3567
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3568
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3569
+ stderr only.
3203
3570
  --log-level=<option> [default: info] Specify level for logging.
3204
3571
  <options: debug|warn|error|info|trace>
3572
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3573
+ unaffected.
3205
3574
 
3206
3575
  DESCRIPTION
3207
3576
  Get detailed information about a specific field on a ServiceNow table.
@@ -3219,7 +3588,7 @@ EXAMPLES
3219
3588
  $ nex schema field --table incident --field priority --json --auth dev
3220
3589
  ```
3221
3590
 
3222
- _See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/schema/field.ts)_
3591
+ _See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/schema/field.ts)_
3223
3592
 
3224
3593
  ## `nex schema validate-catalog`
3225
3594
 
@@ -3227,7 +3596,8 @@ Validate a ServiceNow catalog item configuration for common issues.
3227
3596
 
3228
3597
  ```
3229
3598
  USAGE
3230
- $ nex schema validate-catalog -s <value> [-j] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
3599
+ $ nex schema validate-catalog -s <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3600
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3231
3601
 
3232
3602
  FLAGS
3233
3603
  -a, --auth=<value> Auth alias to use.
@@ -3237,8 +3607,16 @@ FLAGS
3237
3607
  GLOBAL FLAGS
3238
3608
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3239
3609
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3610
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3611
+ --deny-write Refuse any change to instance data for this invocation.
3612
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3613
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3614
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3615
+ stderr only.
3240
3616
  --log-level=<option> [default: info] Specify level for logging.
3241
3617
  <options: debug|warn|error|info|trace>
3618
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3619
+ unaffected.
3242
3620
 
3243
3621
  DESCRIPTION
3244
3622
  Validate a ServiceNow catalog item configuration for common issues.
@@ -3256,7 +3634,7 @@ EXAMPLES
3256
3634
  $ nex schema validate-catalog --sys-id a1b2c3d4e5f6 --json --auth dev
3257
3635
  ```
3258
3636
 
3259
- _See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/schema/validate-catalog.ts)_
3637
+ _See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/schema/validate-catalog.ts)_
3260
3638
 
3261
3639
  ## `nex scope`
3262
3640
 
@@ -3264,7 +3642,8 @@ Get the current application scope or list available applications.
3264
3642
 
3265
3643
  ```
3266
3644
  USAGE
3267
- $ nex scope [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-l]
3645
+ $ nex scope [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
3646
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l]
3268
3647
 
3269
3648
  FLAGS
3270
3649
  -a, --auth=<value> Auth alias to use.
@@ -3273,9 +3652,17 @@ FLAGS
3273
3652
  GLOBAL FLAGS
3274
3653
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3275
3654
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3655
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3656
+ --deny-write Refuse any change to instance data for this invocation.
3276
3657
  --json Format output as json.
3658
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3659
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3660
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3661
+ stderr only.
3277
3662
  --log-level=<option> [default: info] Specify level for logging.
3278
3663
  <options: debug|warn|error|info|trace>
3664
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3665
+ unaffected.
3279
3666
 
3280
3667
  DESCRIPTION
3281
3668
  Get the current application scope or list available applications.
@@ -3294,7 +3681,7 @@ EXAMPLES
3294
3681
  $ nex scope -l --json --auth dev
3295
3682
  ```
3296
3683
 
3297
- _See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/scope/index.ts)_
3684
+ _See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/scope/index.ts)_
3298
3685
 
3299
3686
  ## `nex scope set`
3300
3687
 
@@ -3302,7 +3689,8 @@ Set the current application scope on a ServiceNow instance.
3302
3689
 
3303
3690
  ```
3304
3691
  USAGE
3305
- $ nex scope set -a <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
3692
+ $ nex scope set -a <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3693
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3306
3694
 
3307
3695
  FLAGS
3308
3696
  -a, --app-id=<value> (required) 32-char sys_id of application
@@ -3311,9 +3699,17 @@ FLAGS
3311
3699
  GLOBAL FLAGS
3312
3700
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3313
3701
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3702
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3703
+ --deny-write Refuse any change to instance data for this invocation.
3314
3704
  --json Format output as json.
3705
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3706
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3707
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3708
+ stderr only.
3315
3709
  --log-level=<option> [default: info] Specify level for logging.
3316
3710
  <options: debug|warn|error|info|trace>
3711
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3712
+ unaffected.
3317
3713
 
3318
3714
  DESCRIPTION
3319
3715
  Set the current application scope on a ServiceNow instance.
@@ -3328,7 +3724,7 @@ EXAMPLES
3328
3724
  $ nex scope set -a abc123def456ghi789jkl012mno345pq --json --auth dev
3329
3725
  ```
3330
3726
 
3331
- _See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/scope/set.ts)_
3727
+ _See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/scope/set.ts)_
3332
3728
 
3333
3729
  ## `nex script-sync pull`
3334
3730
 
@@ -3337,7 +3733,8 @@ Pull a script from a ServiceNow instance to a local file.
3337
3733
  ```
3338
3734
  USAGE
3339
3735
  $ nex script-sync pull -n <value> -t sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client
3340
- [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-o <value>]
3736
+ [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>] [--log-file] [--log-level
3737
+ debug|warn|error|info|trace] [--read-only] [-o <value>]
3341
3738
 
3342
3739
  FLAGS
3343
3740
  -a, --auth=<value> Auth alias to use.
@@ -3349,9 +3746,17 @@ FLAGS
3349
3746
  GLOBAL FLAGS
3350
3747
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3351
3748
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3749
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3750
+ --deny-write Refuse any change to instance data for this invocation.
3352
3751
  --json Format output as json.
3752
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3753
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3754
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3755
+ stderr only.
3353
3756
  --log-level=<option> [default: info] Specify level for logging.
3354
3757
  <options: debug|warn|error|info|trace>
3758
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3759
+ unaffected.
3355
3760
 
3356
3761
  DESCRIPTION
3357
3762
  Pull a script from a ServiceNow instance to a local file.
@@ -3379,7 +3784,7 @@ EXAMPLES
3379
3784
  $ nex script-sync pull -n MyClientScript -t sys_script_client --json --auth dev-instance
3380
3785
  ```
3381
3786
 
3382
- _See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/script-sync/pull.ts)_
3787
+ _See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/script-sync/pull.ts)_
3383
3788
 
3384
3789
  ## `nex script-sync push`
3385
3790
 
@@ -3388,7 +3793,8 @@ Push a local script file to a ServiceNow instance.
3388
3793
  ```
3389
3794
  USAGE
3390
3795
  $ nex script-sync push -n <value> -t sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client -f
3391
- <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
3796
+ <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>] [--log-file]
3797
+ [--log-level debug|warn|error|info|trace] [--read-only]
3392
3798
 
3393
3799
  FLAGS
3394
3800
  -a, --auth=<value> Auth alias to use.
@@ -3400,9 +3806,17 @@ FLAGS
3400
3806
  GLOBAL FLAGS
3401
3807
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3402
3808
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3809
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3810
+ --deny-write Refuse any change to instance data for this invocation.
3403
3811
  --json Format output as json.
3812
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3813
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3814
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3815
+ stderr only.
3404
3816
  --log-level=<option> [default: info] Specify level for logging.
3405
3817
  <options: debug|warn|error|info|trace>
3818
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3819
+ unaffected.
3406
3820
 
3407
3821
  DESCRIPTION
3408
3822
  Push a local script file to a ServiceNow instance.
@@ -3431,7 +3845,7 @@ EXAMPLES
3431
3845
  $ nex script-sync push -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --auth dev-instance
3432
3846
  ```
3433
3847
 
3434
- _See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/script-sync/push.ts)_
3848
+ _See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/script-sync/push.ts)_
3435
3849
 
3436
3850
  ## `nex script-sync sync`
3437
3851
 
@@ -3439,7 +3853,8 @@ Synchronize all scripts in a directory with a ServiceNow instance.
3439
3853
 
3440
3854
  ```
3441
3855
  USAGE
3442
- $ nex script-sync sync -d <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-t
3856
+ $ nex script-sync sync -d <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3857
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-t
3443
3858
  sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client...]
3444
3859
 
3445
3860
  FLAGS
@@ -3451,9 +3866,17 @@ FLAGS
3451
3866
  GLOBAL FLAGS
3452
3867
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3453
3868
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3869
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3870
+ --deny-write Refuse any change to instance data for this invocation.
3454
3871
  --json Format output as json.
3872
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3873
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3874
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3875
+ stderr only.
3455
3876
  --log-level=<option> [default: info] Specify level for logging.
3456
3877
  <options: debug|warn|error|info|trace>
3878
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3879
+ unaffected.
3457
3880
 
3458
3881
  DESCRIPTION
3459
3882
  Synchronize all scripts in a directory with a ServiceNow instance.
@@ -3481,7 +3904,7 @@ EXAMPLES
3481
3904
  $ nex script-sync sync -d ./scripts --json --auth dev-instance
3482
3905
  ```
3483
3906
 
3484
- _See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/script-sync/sync.ts)_
3907
+ _See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/script-sync/sync.ts)_
3485
3908
 
3486
3909
  ## `nex search`
3487
3910
 
@@ -3489,8 +3912,9 @@ Search platform code across a ServiceNow instance.
3489
3912
 
3490
3913
  ```
3491
3914
  USAGE
3492
- $ nex search -t <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-l
3493
- <value>] [-s <value>] [-g <value>] [--table <value>]
3915
+ $ nex search -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3916
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l <value>] [-s <value>] [-g <value>]
3917
+ [--table <value>]
3494
3918
 
3495
3919
  FLAGS
3496
3920
  -a, --auth=<value> Auth alias to use.
@@ -3503,9 +3927,17 @@ FLAGS
3503
3927
  GLOBAL FLAGS
3504
3928
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3505
3929
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3930
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3931
+ --deny-write Refuse any change to instance data for this invocation.
3506
3932
  --json Format output as json.
3933
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3934
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3935
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3936
+ stderr only.
3507
3937
  --log-level=<option> [default: info] Specify level for logging.
3508
3938
  <options: debug|warn|error|info|trace>
3939
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3940
+ unaffected.
3509
3941
 
3510
3942
  DESCRIPTION
3511
3943
  Search platform code across a ServiceNow instance.
@@ -3539,7 +3971,7 @@ EXAMPLES
3539
3971
  $ nex search --term "GlideRecord" --limit 10 --json --auth dev-instance
3540
3972
  ```
3541
3973
 
3542
- _See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/search/index.ts)_
3974
+ _See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/search/index.ts)_
3543
3975
 
3544
3976
  ## `nex search add-table`
3545
3977
 
@@ -3547,8 +3979,8 @@ Add a table to a code search group on a ServiceNow instance.
3547
3979
 
3548
3980
  ```
3549
3981
  USAGE
3550
- $ nex search add-table -f <value> -g <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-level
3551
- debug|warn|error|info|trace]
3982
+ $ nex search add-table -f <value> -g <value> -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute]
3983
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3552
3984
 
3553
3985
  FLAGS
3554
3986
  -a, --auth=<value> Auth alias to use.
@@ -3559,9 +3991,17 @@ FLAGS
3559
3991
  GLOBAL FLAGS
3560
3992
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3561
3993
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3994
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3995
+ --deny-write Refuse any change to instance data for this invocation.
3562
3996
  --json Format output as json.
3997
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
3998
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3999
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4000
+ stderr only.
3563
4001
  --log-level=<option> [default: info] Specify level for logging.
3564
4002
  <options: debug|warn|error|info|trace>
4003
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4004
+ unaffected.
3565
4005
 
3566
4006
  DESCRIPTION
3567
4007
  Add a table to a code search group on a ServiceNow instance.
@@ -3591,7 +4031,7 @@ EXAMPLES
3591
4031
  dev-instance
3592
4032
  ```
3593
4033
 
3594
- _See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/search/add-table.ts)_
4034
+ _See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/search/add-table.ts)_
3595
4035
 
3596
4036
  ## `nex search groups`
3597
4037
 
@@ -3599,7 +4039,8 @@ List all available code search groups on a ServiceNow instance.
3599
4039
 
3600
4040
  ```
3601
4041
  USAGE
3602
- $ nex search groups [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
4042
+ $ nex search groups [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4043
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3603
4044
 
3604
4045
  FLAGS
3605
4046
  -a, --auth=<value> Auth alias to use.
@@ -3607,9 +4048,17 @@ FLAGS
3607
4048
  GLOBAL FLAGS
3608
4049
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3609
4050
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4051
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4052
+ --deny-write Refuse any change to instance data for this invocation.
3610
4053
  --json Format output as json.
4054
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4055
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4056
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4057
+ stderr only.
3611
4058
  --log-level=<option> [default: info] Specify level for logging.
3612
4059
  <options: debug|warn|error|info|trace>
4060
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4061
+ unaffected.
3613
4062
 
3614
4063
  DESCRIPTION
3615
4064
  List all available code search groups on a ServiceNow instance.
@@ -3631,7 +4080,7 @@ EXAMPLES
3631
4080
  $ nex search groups --json --auth dev-instance
3632
4081
  ```
3633
4082
 
3634
- _See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/search/groups.ts)_
4083
+ _See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/search/groups.ts)_
3635
4084
 
3636
4085
  ## `nex search tables`
3637
4086
 
@@ -3639,7 +4088,8 @@ List tables configured for a specific code search group.
3639
4088
 
3640
4089
  ```
3641
4090
  USAGE
3642
- $ nex search tables -g <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
4091
+ $ nex search tables -g <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4092
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3643
4093
 
3644
4094
  FLAGS
3645
4095
  -a, --auth=<value> Auth alias to use.
@@ -3648,9 +4098,17 @@ FLAGS
3648
4098
  GLOBAL FLAGS
3649
4099
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3650
4100
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4101
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4102
+ --deny-write Refuse any change to instance data for this invocation.
3651
4103
  --json Format output as json.
4104
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4105
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4106
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4107
+ stderr only.
3652
4108
  --log-level=<option> [default: info] Specify level for logging.
3653
4109
  <options: debug|warn|error|info|trace>
4110
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4111
+ unaffected.
3654
4112
 
3655
4113
  DESCRIPTION
3656
4114
  List tables configured for a specific code search group.
@@ -3673,7 +4131,7 @@ EXAMPLES
3673
4131
  $ nex search tables --search-group "Business Rules" --json --auth dev-instance
3674
4132
  ```
3675
4133
 
3676
- _See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/search/tables.ts)_
4134
+ _See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/search/tables.ts)_
3677
4135
 
3678
4136
  ## `nex store install`
3679
4137
 
@@ -3681,8 +4139,9 @@ Install an application from the ServiceNow Store.
3681
4139
 
3682
4140
  ```
3683
4141
  USAGE
3684
- $ nex store install -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-level
3685
- debug|warn|error|info|trace] [--demo-data] [--no-wait] [--poll-interval <value>] [--timeout <value>]
4142
+ $ nex store install -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4143
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--demo-data] [--no-wait]
4144
+ [--poll-interval <value>] [--timeout <value>]
3686
4145
 
3687
4146
  FLAGS
3688
4147
  -a, --app-id=<value> (required) Store application sys_id
@@ -3696,9 +4155,17 @@ FLAGS
3696
4155
  GLOBAL FLAGS
3697
4156
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3698
4157
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4158
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4159
+ --deny-write Refuse any change to instance data for this invocation.
3699
4160
  --json Format output as json.
4161
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4162
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4163
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4164
+ stderr only.
3700
4165
  --log-level=<option> [default: info] Specify level for logging.
3701
4166
  <options: debug|warn|error|info|trace>
4167
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4168
+ unaffected.
3702
4169
 
3703
4170
  DESCRIPTION
3704
4171
  Install an application from the ServiceNow Store.
@@ -3717,7 +4184,7 @@ EXAMPLES
3717
4184
  $ nex store install -a abc123 -v 1.0.0 --demo-data --auth dev
3718
4185
  ```
3719
4186
 
3720
- _See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/store/install.ts)_
4187
+ _See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/store/install.ts)_
3721
4188
 
3722
4189
  ## `nex store search`
3723
4190
 
@@ -3725,8 +4192,9 @@ Search for applications in the ServiceNow Store.
3725
4192
 
3726
4193
  ```
3727
4194
  USAGE
3728
- $ nex store search [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [--limit
3729
- <value>] [--tab available_for_you|installed|updates] [-t <value>]
4195
+ $ nex store search [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4196
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--limit <value>] [--tab
4197
+ available_for_you|installed|updates] [-t <value>]
3730
4198
 
3731
4199
  FLAGS
3732
4200
  -a, --auth=<value> Auth alias to use.
@@ -3738,9 +4206,17 @@ FLAGS
3738
4206
  GLOBAL FLAGS
3739
4207
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3740
4208
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4209
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4210
+ --deny-write Refuse any change to instance data for this invocation.
3741
4211
  --json Format output as json.
4212
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4213
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4214
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4215
+ stderr only.
3742
4216
  --log-level=<option> [default: info] Specify level for logging.
3743
4217
  <options: debug|warn|error|info|trace>
4218
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4219
+ unaffected.
3744
4220
 
3745
4221
  DESCRIPTION
3746
4222
  Search for applications in the ServiceNow Store.
@@ -3759,7 +4235,7 @@ EXAMPLES
3759
4235
  $ nex store search --tab updates --limit 10 --auth dev
3760
4236
  ```
3761
4237
 
3762
- _See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/store/search.ts)_
4238
+ _See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/store/search.ts)_
3763
4239
 
3764
4240
  ## `nex store update`
3765
4241
 
@@ -3767,8 +4243,9 @@ Update a ServiceNow Store application to a new version.
3767
4243
 
3768
4244
  ```
3769
4245
  USAGE
3770
- $ nex store update -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-level
3771
- debug|warn|error|info|trace] [--no-wait] [--poll-interval <value>] [--timeout <value>]
4246
+ $ nex store update -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4247
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--no-wait]
4248
+ [--poll-interval <value>] [--timeout <value>]
3772
4249
 
3773
4250
  FLAGS
3774
4251
  -a, --app-id=<value> (required) Store application sys_id
@@ -3781,9 +4258,17 @@ FLAGS
3781
4258
  GLOBAL FLAGS
3782
4259
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3783
4260
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4261
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4262
+ --deny-write Refuse any change to instance data for this invocation.
3784
4263
  --json Format output as json.
4264
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4265
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4266
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4267
+ stderr only.
3785
4268
  --log-level=<option> [default: info] Specify level for logging.
3786
4269
  <options: debug|warn|error|info|trace>
4270
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4271
+ unaffected.
3787
4272
 
3788
4273
  DESCRIPTION
3789
4274
  Update a ServiceNow Store application to a new version.
@@ -3802,7 +4287,7 @@ EXAMPLES
3802
4287
  $ nex store update -a abc123 -v 2.0.0 --timeout 3600000 --auth dev
3803
4288
  ```
3804
4289
 
3805
- _See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/store/update.ts)_
4290
+ _See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/store/update.ts)_
3806
4291
 
3807
4292
  ## `nex store validate`
3808
4293
 
@@ -3810,7 +4295,8 @@ Validate a batch installation definition file.
3810
4295
 
3811
4296
  ```
3812
4297
  USAGE
3813
- $ nex store validate -f <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
4298
+ $ nex store validate -f <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4299
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3814
4300
 
3815
4301
  FLAGS
3816
4302
  -a, --auth=<value> Auth alias to use.
@@ -3819,9 +4305,17 @@ FLAGS
3819
4305
  GLOBAL FLAGS
3820
4306
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3821
4307
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4308
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4309
+ --deny-write Refuse any change to instance data for this invocation.
3822
4310
  --json Format output as json.
4311
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4312
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4313
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4314
+ stderr only.
3823
4315
  --log-level=<option> [default: info] Specify level for logging.
3824
4316
  <options: debug|warn|error|info|trace>
4317
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4318
+ unaffected.
3825
4319
 
3826
4320
  DESCRIPTION
3827
4321
  Validate a batch installation definition file.
@@ -3832,7 +4326,7 @@ EXAMPLES
3832
4326
  $ nex store validate --file ./batch-definition.json --auth dev
3833
4327
  ```
3834
4328
 
3835
- _See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/store/validate.ts)_
4329
+ _See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/store/validate.ts)_
3836
4330
 
3837
4331
  ## `nex task approve`
3838
4332
 
@@ -3840,8 +4334,8 @@ Approve a ServiceNow change request.
3840
4334
 
3841
4335
  ```
3842
4336
  USAGE
3843
- $ nex task approve -n <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-c
3844
- <value>]
4337
+ $ nex task approve -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4338
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-c <value>]
3845
4339
 
3846
4340
  FLAGS
3847
4341
  -a, --auth=<value> Auth alias to use.
@@ -3851,9 +4345,17 @@ FLAGS
3851
4345
  GLOBAL FLAGS
3852
4346
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3853
4347
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4348
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4349
+ --deny-write Refuse any change to instance data for this invocation.
3854
4350
  --json Format output as json.
4351
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4352
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4353
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4354
+ stderr only.
3855
4355
  --log-level=<option> [default: info] Specify level for logging.
3856
4356
  <options: debug|warn|error|info|trace>
4357
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4358
+ unaffected.
3857
4359
 
3858
4360
  DESCRIPTION
3859
4361
  Approve a ServiceNow change request.
@@ -3875,7 +4377,7 @@ EXAMPLES
3875
4377
  $ nex task approve -n CHG0010001 -c "Looks good, approved" --auth dev
3876
4378
  ```
3877
4379
 
3878
- _See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/approve.ts)_
4380
+ _See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/approve.ts)_
3879
4381
 
3880
4382
  ## `nex task assign`
3881
4383
 
@@ -3883,8 +4385,9 @@ Assign a ServiceNow task to a user or group.
3883
4385
 
3884
4386
  ```
3885
4387
  USAGE
3886
- $ nex task assign -n <value> -u <value> [--json] [-a <value>] [--cred-store] [--log-level
3887
- debug|warn|error|info|trace] [-g <value>] [--table <value>]
4388
+ $ nex task assign -n <value> -u <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4389
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-g <value>] [--table
4390
+ <value>]
3888
4391
 
3889
4392
  FLAGS
3890
4393
  -a, --auth=<value> Auth alias to use.
@@ -3896,9 +4399,17 @@ FLAGS
3896
4399
  GLOBAL FLAGS
3897
4400
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3898
4401
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4402
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4403
+ --deny-write Refuse any change to instance data for this invocation.
3899
4404
  --json Format output as json.
4405
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4406
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4407
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4408
+ stderr only.
3900
4409
  --log-level=<option> [default: info] Specify level for logging.
3901
4410
  <options: debug|warn|error|info|trace>
4411
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4412
+ unaffected.
3902
4413
 
3903
4414
  DESCRIPTION
3904
4415
  Assign a ServiceNow task to a user or group.
@@ -3927,7 +4438,7 @@ EXAMPLES
3927
4438
  $ nex task assign --number CHG0010001 --table change_request --user admin --auth dev
3928
4439
  ```
3929
4440
 
3930
- _See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/assign.ts)_
4441
+ _See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/assign.ts)_
3931
4442
 
3932
4443
  ## `nex task close`
3933
4444
 
@@ -3935,8 +4446,9 @@ Close a ServiceNow incident.
3935
4446
 
3936
4447
  ```
3937
4448
  USAGE
3938
- $ nex task close --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-level
3939
- debug|warn|error|info|trace] [--close-code <value>]
4449
+ $ nex task close --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute]
4450
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4451
+ [--close-code <value>]
3940
4452
 
3941
4453
  FLAGS
3942
4454
  -a, --auth=<value> Auth alias to use.
@@ -3947,9 +4459,17 @@ FLAGS
3947
4459
  GLOBAL FLAGS
3948
4460
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3949
4461
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4462
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4463
+ --deny-write Refuse any change to instance data for this invocation.
3950
4464
  --json Format output as json.
4465
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4466
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4467
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4468
+ stderr only.
3951
4469
  --log-level=<option> [default: info] Specify level for logging.
3952
4470
  <options: debug|warn|error|info|trace>
4471
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4472
+ unaffected.
3953
4473
 
3954
4474
  DESCRIPTION
3955
4475
  Close a ServiceNow incident.
@@ -3972,7 +4492,7 @@ EXAMPLES
3972
4492
  $ nex task close -n INC0010001 --notes "Closed" --close-code "Solved (Permanently)" --auth dev
3973
4493
  ```
3974
4494
 
3975
- _See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/close.ts)_
4495
+ _See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/close.ts)_
3976
4496
 
3977
4497
  ## `nex task comment`
3978
4498
 
@@ -3980,8 +4500,9 @@ Add a comment or work note to a ServiceNow task.
3980
4500
 
3981
4501
  ```
3982
4502
  USAGE
3983
- $ nex task comment -c <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-level
3984
- debug|warn|error|info|trace] [--table <value>] [--work-note]
4503
+ $ nex task comment -c <value> -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4504
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--table <value>]
4505
+ [--work-note]
3985
4506
 
3986
4507
  FLAGS
3987
4508
  -a, --auth=<value> Auth alias to use.
@@ -3993,9 +4514,17 @@ FLAGS
3993
4514
  GLOBAL FLAGS
3994
4515
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3995
4516
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4517
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4518
+ --deny-write Refuse any change to instance data for this invocation.
3996
4519
  --json Format output as json.
4520
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4521
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4522
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4523
+ stderr only.
3997
4524
  --log-level=<option> [default: info] Specify level for logging.
3998
4525
  <options: debug|warn|error|info|trace>
4526
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4527
+ unaffected.
3999
4528
 
4000
4529
  DESCRIPTION
4001
4530
  Add a comment or work note to a ServiceNow task.
@@ -4023,7 +4552,7 @@ EXAMPLES
4023
4552
  $ nex task comment --number CHG0010001 --table change_request --comment "Approved" --auth dev
4024
4553
  ```
4025
4554
 
4026
- _See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/comment.ts)_
4555
+ _See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/comment.ts)_
4027
4556
 
4028
4557
  ## `nex task find`
4029
4558
 
@@ -4031,8 +4560,8 @@ Find a ServiceNow task by its number.
4031
4560
 
4032
4561
  ```
4033
4562
  USAGE
4034
- $ nex task find -n <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
4035
- [--table <value>]
4563
+ $ nex task find -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4564
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--table <value>]
4036
4565
 
4037
4566
  FLAGS
4038
4567
  -a, --auth=<value> Auth alias to use.
@@ -4042,9 +4571,17 @@ FLAGS
4042
4571
  GLOBAL FLAGS
4043
4572
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4044
4573
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4574
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4575
+ --deny-write Refuse any change to instance data for this invocation.
4045
4576
  --json Format output as json.
4577
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4578
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4579
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4580
+ stderr only.
4046
4581
  --log-level=<option> [default: info] Specify level for logging.
4047
4582
  <options: debug|warn|error|info|trace>
4583
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4584
+ unaffected.
4048
4585
 
4049
4586
  DESCRIPTION
4050
4587
  Find a ServiceNow task by its number.
@@ -4071,7 +4608,7 @@ EXAMPLES
4071
4608
  $ nex task find -n INC0010001 --json --auth dev
4072
4609
  ```
4073
4610
 
4074
- _See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/find.ts)_
4611
+ _See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/find.ts)_
4075
4612
 
4076
4613
  ## `nex task resolve`
4077
4614
 
@@ -4079,8 +4616,9 @@ Resolve a ServiceNow incident with resolution notes.
4079
4616
 
4080
4617
  ```
4081
4618
  USAGE
4082
- $ nex task resolve --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-level
4083
- debug|warn|error|info|trace] [--close-code <value>]
4619
+ $ nex task resolve --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute]
4620
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4621
+ [--close-code <value>]
4084
4622
 
4085
4623
  FLAGS
4086
4624
  -a, --auth=<value> Auth alias to use.
@@ -4091,9 +4629,17 @@ FLAGS
4091
4629
  GLOBAL FLAGS
4092
4630
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4093
4631
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4632
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4633
+ --deny-write Refuse any change to instance data for this invocation.
4094
4634
  --json Format output as json.
4635
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4636
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4637
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4638
+ stderr only.
4095
4639
  --log-level=<option> [default: info] Specify level for logging.
4096
4640
  <options: debug|warn|error|info|trace>
4641
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4642
+ unaffected.
4097
4643
 
4098
4644
  DESCRIPTION
4099
4645
  Resolve a ServiceNow incident with resolution notes.
@@ -4116,7 +4662,7 @@ EXAMPLES
4116
4662
  $ nex task resolve -n INC0010001 --notes "Fixed" --close-code "Solved (Permanently)" --auth dev
4117
4663
  ```
4118
4664
 
4119
- _See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/task/resolve.ts)_
4665
+ _See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/resolve.ts)_
4120
4666
 
4121
4667
  ## `nex update-set`
4122
4668
 
@@ -4124,8 +4670,8 @@ List update sets on a ServiceNow instance.
4124
4670
 
4125
4671
  ```
4126
4672
  USAGE
4127
- $ nex update-set [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [--limit
4128
- <value>] [-q <value>]
4673
+ $ nex update-set [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4674
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--limit <value>] [-q <value>]
4129
4675
 
4130
4676
  FLAGS
4131
4677
  -a, --auth=<value> Auth alias to use.
@@ -4135,9 +4681,17 @@ FLAGS
4135
4681
  GLOBAL FLAGS
4136
4682
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4137
4683
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4684
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4685
+ --deny-write Refuse any change to instance data for this invocation.
4138
4686
  --json Format output as json.
4687
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4688
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4689
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4690
+ stderr only.
4139
4691
  --log-level=<option> [default: info] Specify level for logging.
4140
4692
  <options: debug|warn|error|info|trace>
4693
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4694
+ unaffected.
4141
4695
 
4142
4696
  DESCRIPTION
4143
4697
  List update sets on a ServiceNow instance.
@@ -4156,7 +4710,7 @@ EXAMPLES
4156
4710
  $ nex update-set --json --auth dev-instance
4157
4711
  ```
4158
4712
 
4159
- _See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/index.ts)_
4713
+ _See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/index.ts)_
4160
4714
 
4161
4715
  ## `nex update-set clone`
4162
4716
 
@@ -4164,8 +4718,8 @@ Clone an update set and its records.
4164
4718
 
4165
4719
  ```
4166
4720
  USAGE
4167
- $ nex update-set clone -n <value> -s <value> [--json] [-a <value>] [--cred-store] [--log-level
4168
- debug|warn|error|info|trace]
4721
+ $ nex update-set clone -n <value> -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4722
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4169
4723
 
4170
4724
  FLAGS
4171
4725
  -a, --auth=<value> Auth alias to use.
@@ -4175,9 +4729,17 @@ FLAGS
4175
4729
  GLOBAL FLAGS
4176
4730
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4177
4731
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4732
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4733
+ --deny-write Refuse any change to instance data for this invocation.
4178
4734
  --json Format output as json.
4735
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4736
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4737
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4738
+ stderr only.
4179
4739
  --log-level=<option> [default: info] Specify level for logging.
4180
4740
  <options: debug|warn|error|info|trace>
4741
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4742
+ unaffected.
4181
4743
 
4182
4744
  DESCRIPTION
4183
4745
  Clone an update set and its records.
@@ -4192,7 +4754,7 @@ EXAMPLES
4192
4754
  $ nex update-set clone --source us-001 --name "Cloned Set" --json --auth dev-instance
4193
4755
  ```
4194
4756
 
4195
- _See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/clone.ts)_
4757
+ _See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/clone.ts)_
4196
4758
 
4197
4759
  ## `nex update-set create`
4198
4760
 
@@ -4200,8 +4762,8 @@ Create a new update set.
4200
4762
 
4201
4763
  ```
4202
4764
  USAGE
4203
- $ nex update-set create -n <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
4204
- [--application <value>] [-d <value>]
4765
+ $ nex update-set create -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4766
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--application <value>] [-d <value>]
4205
4767
 
4206
4768
  FLAGS
4207
4769
  -a, --auth=<value> Auth alias to use.
@@ -4212,9 +4774,17 @@ FLAGS
4212
4774
  GLOBAL FLAGS
4213
4775
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4214
4776
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4777
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4778
+ --deny-write Refuse any change to instance data for this invocation.
4215
4779
  --json Format output as json.
4780
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4781
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4782
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4783
+ stderr only.
4216
4784
  --log-level=<option> [default: info] Specify level for logging.
4217
4785
  <options: debug|warn|error|info|trace>
4786
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4787
+ unaffected.
4218
4788
 
4219
4789
  DESCRIPTION
4220
4790
  Create a new update set.
@@ -4233,7 +4803,7 @@ EXAMPLES
4233
4803
  $ nex update-set create --name "My Feature Set" --application x_my_app --auth dev-instance
4234
4804
  ```
4235
4805
 
4236
- _See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/create.ts)_
4806
+ _See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/create.ts)_
4237
4807
 
4238
4808
  ## `nex update-set current`
4239
4809
 
@@ -4241,7 +4811,8 @@ Get or set the current update set.
4241
4811
 
4242
4812
  ```
4243
4813
  USAGE
4244
- $ nex update-set current [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace] [-s <value>]
4814
+ $ nex update-set current [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4815
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-s <value>]
4245
4816
 
4246
4817
  FLAGS
4247
4818
  -a, --auth=<value> Auth alias to use.
@@ -4250,9 +4821,17 @@ FLAGS
4250
4821
  GLOBAL FLAGS
4251
4822
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4252
4823
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4824
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4825
+ --deny-write Refuse any change to instance data for this invocation.
4253
4826
  --json Format output as json.
4827
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4828
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4829
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4830
+ stderr only.
4254
4831
  --log-level=<option> [default: info] Specify level for logging.
4255
4832
  <options: debug|warn|error|info|trace>
4833
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4834
+ unaffected.
4256
4835
 
4257
4836
  DESCRIPTION
4258
4837
  Get or set the current update set.
@@ -4271,7 +4850,7 @@ EXAMPLES
4271
4850
  $ nex update-set current --json --auth dev-instance
4272
4851
  ```
4273
4852
 
4274
- _See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/current.ts)_
4853
+ _See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/current.ts)_
4275
4854
 
4276
4855
  ## `nex update-set inspect`
4277
4856
 
@@ -4279,7 +4858,8 @@ Inspect the components of an update set.
4279
4858
 
4280
4859
  ```
4281
4860
  USAGE
4282
- $ nex update-set inspect -s <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
4861
+ $ nex update-set inspect -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4862
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4283
4863
 
4284
4864
  FLAGS
4285
4865
  -a, --auth=<value> Auth alias to use.
@@ -4288,9 +4868,17 @@ FLAGS
4288
4868
  GLOBAL FLAGS
4289
4869
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4290
4870
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4871
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4872
+ --deny-write Refuse any change to instance data for this invocation.
4291
4873
  --json Format output as json.
4874
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4875
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4876
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4877
+ stderr only.
4292
4878
  --log-level=<option> [default: info] Specify level for logging.
4293
4879
  <options: debug|warn|error|info|trace>
4880
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4881
+ unaffected.
4294
4882
 
4295
4883
  DESCRIPTION
4296
4884
  Inspect the components of an update set.
@@ -4305,7 +4893,7 @@ EXAMPLES
4305
4893
  $ nex update-set inspect --sys-id us-001 --json --auth dev-instance
4306
4894
  ```
4307
4895
 
4308
- _See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/inspect.ts)_
4896
+ _See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/inspect.ts)_
4309
4897
 
4310
4898
  ## `nex update-set move`
4311
4899
 
@@ -4313,8 +4901,9 @@ Move records between update sets.
4313
4901
 
4314
4902
  ```
4315
4903
  USAGE
4316
- $ nex update-set move --target <value> [--json] [-a <value>] [--cred-store] [--log-level
4317
- debug|warn|error|info|trace] [--records <value>] [--source <value>]
4904
+ $ nex update-set move --target <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4905
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--records <value>]
4906
+ [--source <value>]
4318
4907
 
4319
4908
  FLAGS
4320
4909
  -a, --auth=<value> Auth alias to use.
@@ -4325,9 +4914,17 @@ FLAGS
4325
4914
  GLOBAL FLAGS
4326
4915
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4327
4916
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4917
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4918
+ --deny-write Refuse any change to instance data for this invocation.
4328
4919
  --json Format output as json.
4920
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4921
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4922
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4923
+ stderr only.
4329
4924
  --log-level=<option> [default: info] Specify level for logging.
4330
4925
  <options: debug|warn|error|info|trace>
4926
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4927
+ unaffected.
4331
4928
 
4332
4929
  DESCRIPTION
4333
4930
  Move records between update sets.
@@ -4346,7 +4943,7 @@ EXAMPLES
4346
4943
  $ nex update-set move --target us-002 --source us-001 --json --auth dev-instance
4347
4944
  ```
4348
4945
 
4349
- _See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/update-set/move.ts)_
4946
+ _See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/move.ts)_
4350
4947
 
4351
4948
  ## `nex workflow create`
4352
4949
 
@@ -4354,7 +4951,8 @@ Create a complete workflow from a JSON specification file.
4354
4951
 
4355
4952
  ```
4356
4953
  USAGE
4357
- $ nex workflow create -s <value> [--json] [-a <value>] [--cred-store] [--log-level debug|warn|error|info|trace]
4954
+ $ nex workflow create -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4955
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4358
4956
 
4359
4957
  FLAGS
4360
4958
  -a, --auth=<value> Auth alias to use.
@@ -4363,9 +4961,17 @@ FLAGS
4363
4961
  GLOBAL FLAGS
4364
4962
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4365
4963
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4964
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4965
+ --deny-write Refuse any change to instance data for this invocation.
4366
4966
  --json Format output as json.
4967
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4968
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4969
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4970
+ stderr only.
4367
4971
  --log-level=<option> [default: info] Specify level for logging.
4368
4972
  <options: debug|warn|error|info|trace>
4973
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4974
+ unaffected.
4369
4975
 
4370
4976
  DESCRIPTION
4371
4977
  Create a complete workflow from a JSON specification file.
@@ -4380,7 +4986,7 @@ EXAMPLES
4380
4986
  $ nex workflow create -s ./workflow.json --json --auth dev
4381
4987
  ```
4382
4988
 
4383
- _See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/workflow/create.ts)_
4989
+ _See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/workflow/create.ts)_
4384
4990
 
4385
4991
  ## `nex workflow publish`
4386
4992
 
@@ -4388,8 +4994,8 @@ Publish a workflow version.
4388
4994
 
4389
4995
  ```
4390
4996
  USAGE
4391
- $ nex workflow publish -s <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-level
4392
- debug|warn|error|info|trace]
4997
+ $ nex workflow publish -s <value> -v <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4998
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4393
4999
 
4394
5000
  FLAGS
4395
5001
  -a, --auth=<value> Auth alias to use.
@@ -4399,9 +5005,17 @@ FLAGS
4399
5005
  GLOBAL FLAGS
4400
5006
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4401
5007
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
5008
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
5009
+ --deny-write Refuse any change to instance data for this invocation.
4402
5010
  --json Format output as json.
5011
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
5012
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
5013
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
5014
+ stderr only.
4403
5015
  --log-level=<option> [default: info] Specify level for logging.
4404
5016
  <options: debug|warn|error|info|trace>
5017
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
5018
+ unaffected.
4405
5019
 
4406
5020
  DESCRIPTION
4407
5021
  Publish a workflow version.
@@ -4416,7 +5030,7 @@ EXAMPLES
4416
5030
  $ nex workflow publish -v wfv-001 -s act-001 --json --auth dev
4417
5031
  ```
4418
5032
 
4419
- _See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/workflow/publish.ts)_
5033
+ _See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/workflow/publish.ts)_
4420
5034
 
4421
5035
  ## `nex xml export`
4422
5036
 
@@ -4424,8 +5038,8 @@ Export a single ServiceNow record as XML.
4424
5038
 
4425
5039
  ```
4426
5040
  USAGE
4427
- $ nex xml export -t <value> -s <value> [-j] [-a <value>] [--cred-store] [--log-level
4428
- debug|warn|error|info|trace] [-o <value>]
5041
+ $ nex xml export -t <value> -s <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
5042
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-o <value>]
4429
5043
 
4430
5044
  FLAGS
4431
5045
  -a, --auth=<value> Auth alias to use.
@@ -4437,8 +5051,16 @@ FLAGS
4437
5051
  GLOBAL FLAGS
4438
5052
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4439
5053
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
5054
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
5055
+ --deny-write Refuse any change to instance data for this invocation.
5056
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
5057
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
5058
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
5059
+ stderr only.
4440
5060
  --log-level=<option> [default: info] Specify level for logging.
4441
5061
  <options: debug|warn|error|info|trace>
5062
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
5063
+ unaffected.
4442
5064
 
4443
5065
  DESCRIPTION
4444
5066
  Export a single ServiceNow record as XML.
@@ -4466,7 +5088,7 @@ EXAMPLES
4466
5088
  $ nex xml export --table sys_script --sys-id abc123 --json --auth dev
4467
5089
  ```
4468
5090
 
4469
- _See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/xml/export.ts)_
5091
+ _See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/xml/export.ts)_
4470
5092
 
4471
5093
  ## `nex xml import`
4472
5094
 
@@ -4474,8 +5096,8 @@ Import XML records into a ServiceNow instance.
4474
5096
 
4475
5097
  ```
4476
5098
  USAGE
4477
- $ nex xml import -f <value> -t <value> [-j] [-a <value>] [--cred-store] [--log-level
4478
- debug|warn|error|info|trace]
5099
+ $ nex xml import -f <value> -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
5100
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4479
5101
 
4480
5102
  FLAGS
4481
5103
  -a, --auth=<value> Auth alias to use.
@@ -4486,8 +5108,16 @@ FLAGS
4486
5108
  GLOBAL FLAGS
4487
5109
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4488
5110
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
5111
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
5112
+ --deny-write Refuse any change to instance data for this invocation.
5113
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
5114
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
5115
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
5116
+ stderr only.
4489
5117
  --log-level=<option> [default: info] Specify level for logging.
4490
5118
  <options: debug|warn|error|info|trace>
5119
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
5120
+ unaffected.
4491
5121
 
4492
5122
  DESCRIPTION
4493
5123
  Import XML records into a ServiceNow instance.
@@ -4510,7 +5140,7 @@ EXAMPLES
4510
5140
  $ nex xml import --file ./records.xml --table incident --json --auth dev
4511
5141
  ```
4512
5142
 
4513
- _See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.0.1/src/commands/xml/import.ts)_
5143
+ _See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/xml/import.ts)_
4514
5144
  <!-- commandsstop -->
4515
5145
 
4516
5146
  ---