@sonisoft/now-sdk-ext-cli 5.1.0 → 5.3.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
@@ -505,6 +505,19 @@ nex flow cancel --context-id ctx-abc123 --reason "No longer needed" --auth dev
505
505
 
506
506
  # Send a message to a waiting flow (e.g., approval)
507
507
  nex flow message --context-id ctx-abc123 --message approved --payload '{"approver":"admin"}' --auth dev
508
+
509
+ # Read a flow's design-time definition (nothing is executed; no context is created)
510
+ nex flow definition --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev
511
+
512
+ # Read a subflow definition
513
+ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev
514
+
515
+ # Read a custom action definition with its ordered steps
516
+ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev
517
+
518
+ # Redirect the full JSON definition to a file, or pipe it into another tool
519
+ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json
520
+ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps
508
521
  ```
509
522
 
510
523
  **Features:**
@@ -512,6 +525,8 @@ nex flow message --context-id ctx-abc123 --message approved --payload '{"approve
512
525
  - Foreground (wait) or background execution modes
513
526
  - Query flow context status, outputs, and errors
514
527
  - Cancel running flows and send messages to paused flows
528
+ - Read design-time definitions of flows, subflows, and actions — read-only, and
529
+ distinct from `flow details`, which reports on one past execution
515
530
  - JSON output for automation and CI/CD
516
531
 
517
532
  ### Bulk Record Operations
@@ -591,6 +606,10 @@ nex bulk update --table incident --query "state=7" --data '{"active":"false"}' -
591
606
  * [Check for errors](#check-for-errors)
592
607
  * [Cancel a running flow](#cancel-a-running-flow)
593
608
  * [Send a message to a waiting flow (e.g., approval)](#send-a-message-to-a-waiting-flow-eg-approval)
609
+ * [Read a flow's design-time definition (nothing is executed; no context is created)](#read-a-flows-design-time-definition-nothing-is-executed-no-context-is-created)
610
+ * [Read a subflow definition](#read-a-subflow-definition)
611
+ * [Read a custom action definition with its ordered steps](#read-a-custom-action-definition-with-its-ordered-steps)
612
+ * [Redirect the full JSON definition to a file, or pipe it into another tool](#redirect-the-full-json-definition-to-a-file-or-pipe-it-into-another-tool)
594
613
  * [Dry-run: preview which records would be updated (safe default)](#dry-run-preview-which-records-would-be-updated-safe-default)
595
614
  * [Confirm bulk update (actually modifies records)](#confirm-bulk-update-actually-modifies-records)
596
615
  * [Dry-run: preview which records would be deleted](#dry-run-preview-which-records-would-be-deleted)
@@ -689,7 +708,7 @@ $ npm install -g @sonisoft/now-sdk-ext-cli
689
708
  $ nex COMMAND
690
709
  running command...
691
710
  $ nex (--version)
692
- @sonisoft/now-sdk-ext-cli/5.1.0 linux-x64 node-v26.5.0
711
+ @sonisoft/now-sdk-ext-cli/5.3.0 linux-x64 node-v26.5.0
693
712
  $ nex --help [COMMAND]
694
713
  USAGE
695
714
  $ nex COMMAND
@@ -697,6 +716,31 @@ USAGE
697
716
  ```
698
717
  <!-- usagestop -->
699
718
 
719
+
720
+ ## Restricting what can be changed
721
+
722
+ Changes to a ServiceNow instance are **permitted by default**. Two ways to take that
723
+ away, in priority order:
724
+
725
+ | | | Reachable by an agent? |
726
+ |---|---|---|
727
+ | `NEX_POLICY_DENY=write,execute` (or `all`) | environment | **No** |
728
+ | `--read-only`, `--deny-write`, `--deny-execute` | per invocation | Yes |
729
+
730
+ Reads are never gated. `nex policy status` prints what is permitted and which layer
731
+ decided — use it first when something is refused, since the fix differs completely
732
+ between an environment variable and a flag.
733
+
734
+ A malformed value **fails closed**: `NEX_POLICY_DENY=wrtie` denies everything and warns,
735
+ rather than silently denying nothing.
736
+
737
+ > `NEX_POLICY_DENY` holds only when set somewhere an agent cannot write — a shell
738
+ > profile, a systemd unit, or a container environment. **Not** a committed `.env` or a
739
+ > project-local config file, which anything with file access can edit.
740
+ >
741
+ > This is a guardrail, not a security boundary. Anything holding the credential can
742
+ > reach the instance directly.
743
+
700
744
  # Commands
701
745
  <!-- commands -->
702
746
  * [`nex aggregate count`](#nex-aggregate-count)
@@ -724,6 +768,7 @@ USAGE
724
768
  * [`nex flow action`](#nex-flow-action)
725
769
  * [`nex flow cancel`](#nex-flow-cancel)
726
770
  * [`nex flow copy`](#nex-flow-copy)
771
+ * [`nex flow definition`](#nex-flow-definition)
727
772
  * [`nex flow details`](#nex-flow-details)
728
773
  * [`nex flow error`](#nex-flow-error)
729
774
  * [`nex flow logs`](#nex-flow-logs)
@@ -746,6 +791,7 @@ USAGE
746
791
  * [`nex plugins uninstall [PLUGIN]`](#nex-plugins-uninstall-plugin)
747
792
  * [`nex plugins unlink [PLUGIN]`](#nex-plugins-unlink-plugin)
748
793
  * [`nex plugins update`](#nex-plugins-update)
794
+ * [`nex policy status`](#nex-policy-status)
749
795
  * [`nex query`](#nex-query)
750
796
  * [`nex query app`](#nex-query-app)
751
797
  * [`nex query columns`](#nex-query-columns)
@@ -789,8 +835,8 @@ Count records in a ServiceNow table.
789
835
 
790
836
  ```
791
837
  USAGE
792
- $ nex aggregate count -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
793
- debug|warn|error|info|trace] [-q <value>]
838
+ $ nex aggregate count -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
839
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>]
794
840
 
795
841
  FLAGS
796
842
  -a, --auth=<value> Auth alias to use.
@@ -801,12 +847,16 @@ FLAGS
801
847
  GLOBAL FLAGS
802
848
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
803
849
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
850
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
851
+ --deny-write Refuse any change to instance data for this invocation.
804
852
  --log-dir=<value> Directory to write log files to. Implies --log-file.
805
853
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
806
854
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
807
855
  stderr only.
808
856
  --log-level=<option> [default: info] Specify level for logging.
809
857
  <options: debug|warn|error|info|trace>
858
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
859
+ unaffected.
810
860
 
811
861
  DESCRIPTION
812
862
  Count records in a ServiceNow table.
@@ -832,7 +882,7 @@ EXAMPLES
832
882
  $ nex aggregate count --table incident --query "active=true" --json --auth dev
833
883
  ```
834
884
 
835
- _See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/aggregate/count.ts)_
885
+ _See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/aggregate/count.ts)_
836
886
 
837
887
  ## `nex aggregate group`
838
888
 
@@ -840,9 +890,9 @@ Run a grouped aggregate query on a ServiceNow table.
840
890
 
841
891
  ```
842
892
  USAGE
843
- $ nex aggregate group -t <value> -g <value>... [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
844
- [--log-level debug|warn|error|info|trace] [-q <value>] [-c] [--avg <value>...] [--min <value>...] [--max <value>...]
845
- [--sum <value>...] [--having <value>] [-d]
893
+ $ nex aggregate group -t <value> -g <value>... [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
894
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>] [-c] [--avg
895
+ <value>...] [--min <value>...] [--max <value>...] [--sum <value>...] [--having <value>] [-d]
846
896
 
847
897
  FLAGS
848
898
  -a, --auth=<value> Auth alias to use.
@@ -861,12 +911,16 @@ FLAGS
861
911
  GLOBAL FLAGS
862
912
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
863
913
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
914
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
915
+ --deny-write Refuse any change to instance data for this invocation.
864
916
  --log-dir=<value> Directory to write log files to. Implies --log-file.
865
917
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
866
918
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
867
919
  stderr only.
868
920
  --log-level=<option> [default: info] Specify level for logging.
869
921
  <options: debug|warn|error|info|trace>
922
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
923
+ unaffected.
870
924
 
871
925
  DESCRIPTION
872
926
  Run a grouped aggregate query on a ServiceNow table.
@@ -896,7 +950,7 @@ EXAMPLES
896
950
  $ nex aggregate group --table incident --group-by priority --count --having "count>10" --auth dev
897
951
  ```
898
952
 
899
- _See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/aggregate/group.ts)_
953
+ _See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/aggregate/group.ts)_
900
954
 
901
955
  ## `nex aggregate query`
902
956
 
@@ -904,9 +958,9 @@ Run aggregate statistics on a ServiceNow table.
904
958
 
905
959
  ```
906
960
  USAGE
907
- $ nex aggregate query -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
908
- debug|warn|error|info|trace] [-q <value>] [-c] [--avg <value>...] [--min <value>...] [--max <value>...] [--sum
909
- <value>...]
961
+ $ nex aggregate query -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
962
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>] [-c] [--avg <value>...]
963
+ [--min <value>...] [--max <value>...] [--sum <value>...]
910
964
 
911
965
  FLAGS
912
966
  -a, --auth=<value> Auth alias to use.
@@ -922,12 +976,16 @@ FLAGS
922
976
  GLOBAL FLAGS
923
977
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
924
978
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
979
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
980
+ --deny-write Refuse any change to instance data for this invocation.
925
981
  --log-dir=<value> Directory to write log files to. Implies --log-file.
926
982
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
927
983
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
928
984
  stderr only.
929
985
  --log-level=<option> [default: info] Specify level for logging.
930
986
  <options: debug|warn|error|info|trace>
987
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
988
+ unaffected.
931
989
 
932
990
  DESCRIPTION
933
991
  Run aggregate statistics on a ServiceNow table.
@@ -955,7 +1013,7 @@ EXAMPLES
955
1013
  $ nex aggregate query --table incident --sum reassignment_count --json --auth dev
956
1014
  ```
957
1015
 
958
- _See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/aggregate/query.ts)_
1016
+ _See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/aggregate/query.ts)_
959
1017
 
960
1018
  ## `nex app`
961
1019
 
@@ -963,8 +1021,8 @@ Manage ServiceNow applications: uninstall applications from your instance.
963
1021
 
964
1022
  ```
965
1023
  USAGE
966
- $ nex app [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
967
- debug|warn|error|info|trace] [-u] [-i <value>] [-s <value>]
1024
+ $ nex app [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
1025
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-u] [-i <value>] [-s <value>]
968
1026
 
969
1027
  FLAGS
970
1028
  -a, --auth=<value> Auth alias to use.
@@ -975,6 +1033,8 @@ FLAGS
975
1033
  GLOBAL FLAGS
976
1034
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
977
1035
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1036
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1037
+ --deny-write Refuse any change to instance data for this invocation.
978
1038
  --json Format output as json.
979
1039
  --log-dir=<value> Directory to write log files to. Implies --log-file.
980
1040
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -982,6 +1042,8 @@ GLOBAL FLAGS
982
1042
  stderr only.
983
1043
  --log-level=<option> [default: info] Specify level for logging.
984
1044
  <options: debug|warn|error|info|trace>
1045
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1046
+ unaffected.
985
1047
 
986
1048
  DESCRIPTION
987
1049
  Manage ServiceNow applications: uninstall applications from your instance.
@@ -1014,7 +1076,7 @@ EXAMPLES
1014
1076
  $ nex app -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
1015
1077
  ```
1016
1078
 
1017
- _See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/index.ts)_
1079
+ _See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/app/index.ts)_
1018
1080
 
1019
1081
  ## `nex app install`
1020
1082
 
@@ -1022,8 +1084,8 @@ Install or upgrade multiple ServiceNow applications from a batch definition file
1022
1084
 
1023
1085
  ```
1024
1086
  USAGE
1025
- $ nex app install [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
1026
- debug|warn|error|info|trace] [-b] [-d <value>]
1087
+ $ nex app install [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
1088
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-b] [-d <value>]
1027
1089
 
1028
1090
  FLAGS
1029
1091
  -a, --auth=<value> Auth alias to use.
@@ -1033,6 +1095,8 @@ FLAGS
1033
1095
  GLOBAL FLAGS
1034
1096
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1035
1097
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1098
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1099
+ --deny-write Refuse any change to instance data for this invocation.
1036
1100
  --json Format output as json.
1037
1101
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1038
1102
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1040,6 +1104,8 @@ GLOBAL FLAGS
1040
1104
  stderr only.
1041
1105
  --log-level=<option> [default: info] Specify level for logging.
1042
1106
  <options: debug|warn|error|info|trace>
1107
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1108
+ unaffected.
1043
1109
 
1044
1110
  DESCRIPTION
1045
1111
  Install or upgrade multiple ServiceNow applications from a batch definition file.
@@ -1078,7 +1144,7 @@ EXAMPLES
1078
1144
  $ nex app install -b -d ./apps.json -a dev-instance --log-level debug
1079
1145
  ```
1080
1146
 
1081
- _See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/install.ts)_
1147
+ _See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/app/install.ts)_
1082
1148
 
1083
1149
  ## `nex app repo-install`
1084
1150
 
@@ -1086,8 +1152,9 @@ Install an application from your ServiceNow company repository.
1086
1152
 
1087
1153
  ```
1088
1154
  USAGE
1089
- $ nex app repo-install -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
1090
- debug|warn|error|info|trace] [-w] [--poll-interval <value>] [-t <value>] [-v <value>]
1155
+ $ nex app repo-install -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1156
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-w] [--poll-interval <value>] [-t
1157
+ <value>] [-v <value>]
1091
1158
 
1092
1159
  FLAGS
1093
1160
  -a, --auth=<value> Auth alias to use.
@@ -1100,6 +1167,8 @@ FLAGS
1100
1167
  GLOBAL FLAGS
1101
1168
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1102
1169
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1170
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1171
+ --deny-write Refuse any change to instance data for this invocation.
1103
1172
  --json Format output as json.
1104
1173
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1105
1174
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1107,6 +1176,8 @@ GLOBAL FLAGS
1107
1176
  stderr only.
1108
1177
  --log-level=<option> [default: info] Specify level for logging.
1109
1178
  <options: debug|warn|error|info|trace>
1179
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1180
+ unaffected.
1110
1181
 
1111
1182
  DESCRIPTION
1112
1183
  Install an application from your ServiceNow company repository.
@@ -1158,7 +1229,7 @@ EXAMPLES
1158
1229
  $ nex app repo-install -s x_my_app -a dev-instance --log-level debug
1159
1230
  ```
1160
1231
 
1161
- _See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/repo-install.ts)_
1232
+ _See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/app/repo-install.ts)_
1162
1233
 
1163
1234
  ## `nex app repo-list`
1164
1235
 
@@ -1166,8 +1237,8 @@ List applications available in your ServiceNow company repository.
1166
1237
 
1167
1238
  ```
1168
1239
  USAGE
1169
- $ nex app repo-list [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
1170
- debug|warn|error|info|trace] [-n] [-i]
1240
+ $ nex app repo-list [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
1241
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-n] [-i]
1171
1242
 
1172
1243
  FLAGS
1173
1244
  -a, --auth=<value> Auth alias to use.
@@ -1178,12 +1249,16 @@ FLAGS
1178
1249
  GLOBAL FLAGS
1179
1250
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1180
1251
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1252
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1253
+ --deny-write Refuse any change to instance data for this invocation.
1181
1254
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1182
1255
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1183
1256
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1184
1257
  stderr only.
1185
1258
  --log-level=<option> [default: info] Specify level for logging.
1186
1259
  <options: debug|warn|error|info|trace>
1260
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1261
+ unaffected.
1187
1262
 
1188
1263
  DESCRIPTION
1189
1264
  List applications available in your ServiceNow company repository.
@@ -1229,7 +1304,7 @@ EXAMPLES
1229
1304
  $ nex app repo-list -a dev-instance
1230
1305
  ```
1231
1306
 
1232
- _See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/repo-list.ts)_
1307
+ _See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/app/repo-list.ts)_
1233
1308
 
1234
1309
  ## `nex app uninstall`
1235
1310
 
@@ -1237,8 +1312,8 @@ Uninstall a ServiceNow application from your instance.
1237
1312
 
1238
1313
  ```
1239
1314
  USAGE
1240
- $ nex app uninstall -i <value> -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
1241
- [--log-level debug|warn|error|info|trace]
1315
+ $ nex app uninstall -i <value> -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
1316
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
1242
1317
 
1243
1318
  FLAGS
1244
1319
  -a, --auth=<value> Auth alias to use.
@@ -1248,6 +1323,8 @@ FLAGS
1248
1323
  GLOBAL FLAGS
1249
1324
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1250
1325
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1326
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1327
+ --deny-write Refuse any change to instance data for this invocation.
1251
1328
  --json Format output as json.
1252
1329
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1253
1330
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1255,6 +1332,8 @@ GLOBAL FLAGS
1255
1332
  stderr only.
1256
1333
  --log-level=<option> [default: info] Specify level for logging.
1257
1334
  <options: debug|warn|error|info|trace>
1335
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1336
+ unaffected.
1258
1337
 
1259
1338
  DESCRIPTION
1260
1339
  Uninstall a ServiceNow application from your instance.
@@ -1287,7 +1366,7 @@ EXAMPLES
1287
1366
  $ nex app uninstall -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
1288
1367
  ```
1289
1368
 
1290
- _See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/app/uninstall.ts)_
1369
+ _See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/app/uninstall.ts)_
1291
1370
 
1292
1371
  ## `nex atf`
1293
1372
 
@@ -1295,9 +1374,10 @@ Execute ATF (Automated Test Framework) tests or test suites on a ServiceNow inst
1295
1374
 
1296
1375
  ```
1297
1376
  USAGE
1298
- $ nex atf [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
1299
- debug|warn|error|info|trace] [-t <value> | -s <value> | -n <value>] [-w] [-p <value>] [-b <value>]
1300
- [--browser-version <value>] [--os-name <value>] [--os-version <value>] [--performance] [--cloud]
1377
+ $ nex atf [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
1378
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-t <value> | -s <value> | -n <value>] [-w] [-p
1379
+ <value>] [-b <value>] [--browser-version <value>] [--os-name <value>] [--os-version <value>] [--performance]
1380
+ [--cloud]
1301
1381
 
1302
1382
  FLAGS
1303
1383
  -a, --auth=<value> Auth alias to use.
@@ -1317,12 +1397,16 @@ FLAGS
1317
1397
  GLOBAL FLAGS
1318
1398
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1319
1399
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1400
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1401
+ --deny-write Refuse any change to instance data for this invocation.
1320
1402
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1321
1403
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1322
1404
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1323
1405
  stderr only.
1324
1406
  --log-level=<option> [default: info] Specify level for logging.
1325
1407
  <options: debug|warn|error|info|trace>
1408
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1409
+ unaffected.
1326
1410
 
1327
1411
  DESCRIPTION
1328
1412
  Execute ATF (Automated Test Framework) tests or test suites on a ServiceNow instance.
@@ -1365,7 +1449,7 @@ EXAMPLES
1365
1449
  $ nex atf --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance
1366
1450
  ```
1367
1451
 
1368
- _See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/atf/index.ts)_
1452
+ _See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/atf/index.ts)_
1369
1453
 
1370
1454
  ## `nex attachment get`
1371
1455
 
@@ -1373,8 +1457,8 @@ Get metadata for a specific attachment.
1373
1457
 
1374
1458
  ```
1375
1459
  USAGE
1376
- $ nex attachment get -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
1377
- debug|warn|error|info|trace]
1460
+ $ nex attachment get -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1461
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
1378
1462
 
1379
1463
  FLAGS
1380
1464
  -a, --auth=<value> Auth alias to use.
@@ -1383,6 +1467,8 @@ FLAGS
1383
1467
  GLOBAL FLAGS
1384
1468
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1385
1469
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1470
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1471
+ --deny-write Refuse any change to instance data for this invocation.
1386
1472
  --json Format output as json.
1387
1473
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1388
1474
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1390,6 +1476,8 @@ GLOBAL FLAGS
1390
1476
  stderr only.
1391
1477
  --log-level=<option> [default: info] Specify level for logging.
1392
1478
  <options: debug|warn|error|info|trace>
1479
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1480
+ unaffected.
1393
1481
 
1394
1482
  DESCRIPTION
1395
1483
  Get metadata for a specific attachment.
@@ -1404,7 +1492,7 @@ EXAMPLES
1404
1492
  $ nex attachment get -s att123 --json --auth dev
1405
1493
  ```
1406
1494
 
1407
- _See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/attachment/get.ts)_
1495
+ _See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/attachment/get.ts)_
1408
1496
 
1409
1497
  ## `nex attachment list`
1410
1498
 
@@ -1412,8 +1500,8 @@ List attachments on a ServiceNow record.
1412
1500
 
1413
1501
  ```
1414
1502
  USAGE
1415
- $ nex attachment list -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
1416
- [--log-level debug|warn|error|info|trace] [--limit <value>]
1503
+ $ nex attachment list -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
1504
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--limit <value>]
1417
1505
 
1418
1506
  FLAGS
1419
1507
  -a, --auth=<value> Auth alias to use.
@@ -1424,6 +1512,8 @@ FLAGS
1424
1512
  GLOBAL FLAGS
1425
1513
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1426
1514
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1515
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1516
+ --deny-write Refuse any change to instance data for this invocation.
1427
1517
  --json Format output as json.
1428
1518
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1429
1519
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1431,6 +1521,8 @@ GLOBAL FLAGS
1431
1521
  stderr only.
1432
1522
  --log-level=<option> [default: info] Specify level for logging.
1433
1523
  <options: debug|warn|error|info|trace>
1524
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1525
+ unaffected.
1434
1526
 
1435
1527
  DESCRIPTION
1436
1528
  List attachments on a ServiceNow record.
@@ -1445,7 +1537,7 @@ EXAMPLES
1445
1537
  $ nex attachment list -t incident -r abc123 --limit 50 --json --auth dev
1446
1538
  ```
1447
1539
 
1448
- _See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/attachment/list.ts)_
1540
+ _See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/attachment/list.ts)_
1449
1541
 
1450
1542
  ## `nex attachment upload`
1451
1543
 
@@ -1453,8 +1545,9 @@ Upload a file as an attachment to a ServiceNow record.
1453
1545
 
1454
1546
  ```
1455
1547
  USAGE
1456
- $ nex attachment upload -f <value> -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>]
1457
- [--log-file] [--log-level debug|warn|error|info|trace] [--content-type <value>]
1548
+ $ nex attachment upload -f <value> -r <value> -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute]
1549
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
1550
+ [--content-type <value>]
1458
1551
 
1459
1552
  FLAGS
1460
1553
  -a, --auth=<value> Auth alias to use.
@@ -1466,6 +1559,8 @@ FLAGS
1466
1559
  GLOBAL FLAGS
1467
1560
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1468
1561
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1562
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1563
+ --deny-write Refuse any change to instance data for this invocation.
1469
1564
  --json Format output as json.
1470
1565
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1471
1566
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1473,6 +1568,8 @@ GLOBAL FLAGS
1473
1568
  stderr only.
1474
1569
  --log-level=<option> [default: info] Specify level for logging.
1475
1570
  <options: debug|warn|error|info|trace>
1571
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1572
+ unaffected.
1476
1573
 
1477
1574
  DESCRIPTION
1478
1575
  Upload a file as an attachment to a ServiceNow record.
@@ -1487,7 +1584,7 @@ EXAMPLES
1487
1584
  $ nex attachment upload -t incident -r abc123 -f ./data.csv --content-type text/csv --auth dev
1488
1585
  ```
1489
1586
 
1490
- _See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/attachment/upload.ts)_
1587
+ _See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/attachment/upload.ts)_
1491
1588
 
1492
1589
  ## `nex auth delete [ALIAS]`
1493
1590
 
@@ -1522,7 +1619,7 @@ EXAMPLES
1522
1619
  $ nex auth delete --all
1523
1620
  ```
1524
1621
 
1525
- _See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/auth/delete.ts)_
1622
+ _See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/auth/delete.ts)_
1526
1623
 
1527
1624
  ## `nex auth doctor`
1528
1625
 
@@ -1550,7 +1647,7 @@ EXAMPLES
1550
1647
  $ nex auth doctor --json
1551
1648
  ```
1552
1649
 
1553
- _See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/auth/doctor.ts)_
1650
+ _See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/auth/doctor.ts)_
1554
1651
 
1555
1652
  ## `nex auth list`
1556
1653
 
@@ -1583,7 +1680,7 @@ EXAMPLES
1583
1680
  $ nex auth list --json
1584
1681
  ```
1585
1682
 
1586
- _See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/auth/list.ts)_
1683
+ _See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/auth/list.ts)_
1587
1684
 
1588
1685
  ## `nex auth use ALIAS`
1589
1686
 
@@ -1611,7 +1708,7 @@ EXAMPLES
1611
1708
  $ nex auth use dev206299
1612
1709
  ```
1613
1710
 
1614
- _See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/auth/use.ts)_
1711
+ _See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/auth/use.ts)_
1615
1712
 
1616
1713
  ## `nex autocomplete [SHELL]`
1617
1714
 
@@ -1642,7 +1739,7 @@ EXAMPLES
1642
1739
  $ nex autocomplete --refresh-cache
1643
1740
  ```
1644
1741
 
1645
- _See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.54/src/commands/autocomplete/index.ts)_
1742
+ _See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.55/src/commands/autocomplete/index.ts)_
1646
1743
 
1647
1744
  ## `nex batch create`
1648
1745
 
@@ -1650,8 +1747,8 @@ Batch create records on a ServiceNow instance from a JSON file.
1650
1747
 
1651
1748
  ```
1652
1749
  USAGE
1653
- $ nex batch create -f <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
1654
- debug|warn|error|info|trace] [--transaction]
1750
+ $ nex batch create -f <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1751
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--transaction]
1655
1752
 
1656
1753
  FLAGS
1657
1754
  -a, --auth=<value> Auth alias to use.
@@ -1661,6 +1758,8 @@ FLAGS
1661
1758
  GLOBAL FLAGS
1662
1759
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1663
1760
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1761
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1762
+ --deny-write Refuse any change to instance data for this invocation.
1664
1763
  --json Format output as json.
1665
1764
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1666
1765
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1668,6 +1767,8 @@ GLOBAL FLAGS
1668
1767
  stderr only.
1669
1768
  --log-level=<option> [default: info] Specify level for logging.
1670
1769
  <options: debug|warn|error|info|trace>
1770
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1771
+ unaffected.
1671
1772
 
1672
1773
  DESCRIPTION
1673
1774
  Batch create records on a ServiceNow instance from a JSON file.
@@ -1682,7 +1783,7 @@ EXAMPLES
1682
1783
  $ nex batch create --file ./records.json --no-transaction --auth dev
1683
1784
  ```
1684
1785
 
1685
- _See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/batch/create.ts)_
1786
+ _See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/batch/create.ts)_
1686
1787
 
1687
1788
  ## `nex batch update`
1688
1789
 
@@ -1690,8 +1791,8 @@ Batch update records on a ServiceNow instance from a JSON file.
1690
1791
 
1691
1792
  ```
1692
1793
  USAGE
1693
- $ nex batch update -f <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
1694
- debug|warn|error|info|trace] [--stop-on-error]
1794
+ $ nex batch update -f <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1795
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--stop-on-error]
1695
1796
 
1696
1797
  FLAGS
1697
1798
  -a, --auth=<value> Auth alias to use.
@@ -1701,6 +1802,8 @@ FLAGS
1701
1802
  GLOBAL FLAGS
1702
1803
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1703
1804
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1805
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1806
+ --deny-write Refuse any change to instance data for this invocation.
1704
1807
  --json Format output as json.
1705
1808
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1706
1809
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1708,6 +1811,8 @@ GLOBAL FLAGS
1708
1811
  stderr only.
1709
1812
  --log-level=<option> [default: info] Specify level for logging.
1710
1813
  <options: debug|warn|error|info|trace>
1814
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1815
+ unaffected.
1711
1816
 
1712
1817
  DESCRIPTION
1713
1818
  Batch update records on a ServiceNow instance from a JSON file.
@@ -1722,7 +1827,7 @@ EXAMPLES
1722
1827
  $ nex batch update --file ./updates.json --stop-on-error --auth dev
1723
1828
  ```
1724
1829
 
1725
- _See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/batch/update.ts)_
1830
+ _See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/batch/update.ts)_
1726
1831
 
1727
1832
  ## `nex bulk delete`
1728
1833
 
@@ -1730,8 +1835,8 @@ Bulk delete records matching an encoded query.
1730
1835
 
1731
1836
  ```
1732
1837
  USAGE
1733
- $ nex bulk delete -t <value> -q <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
1734
- [--log-level debug|warn|error|info|trace] [--confirm] [-l <value>]
1838
+ $ nex bulk delete -t <value> -q <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
1839
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--confirm] [-l <value>]
1735
1840
 
1736
1841
  FLAGS
1737
1842
  -a, --auth=<value> Auth alias to use.
@@ -1744,12 +1849,16 @@ FLAGS
1744
1849
  GLOBAL FLAGS
1745
1850
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1746
1851
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1852
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1853
+ --deny-write Refuse any change to instance data for this invocation.
1747
1854
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1748
1855
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1749
1856
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1750
1857
  stderr only.
1751
1858
  --log-level=<option> [default: info] Specify level for logging.
1752
1859
  <options: debug|warn|error|info|trace>
1860
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1861
+ unaffected.
1753
1862
 
1754
1863
  DESCRIPTION
1755
1864
  Bulk delete records matching an encoded query.
@@ -1782,7 +1891,7 @@ EXAMPLES
1782
1891
  $ nex bulk delete --table u_staging --query "processed=true" --confirm --json --auth dev
1783
1892
  ```
1784
1893
 
1785
- _See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/bulk/delete.ts)_
1894
+ _See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/bulk/delete.ts)_
1786
1895
 
1787
1896
  ## `nex bulk update`
1788
1897
 
@@ -1790,8 +1899,9 @@ Bulk update records matching an encoded query.
1790
1899
 
1791
1900
  ```
1792
1901
  USAGE
1793
- $ nex bulk update -t <value> -q <value> -d <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>]
1794
- [--log-file] [--log-level debug|warn|error|info|trace] [--confirm] [-l <value>]
1902
+ $ nex bulk update -t <value> -q <value> -d <value> [-j] [-a <value>] [--cred-store] [--deny-execute]
1903
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--confirm]
1904
+ [-l <value>]
1795
1905
 
1796
1906
  FLAGS
1797
1907
  -a, --auth=<value> Auth alias to use.
@@ -1805,12 +1915,16 @@ FLAGS
1805
1915
  GLOBAL FLAGS
1806
1916
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1807
1917
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1918
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1919
+ --deny-write Refuse any change to instance data for this invocation.
1808
1920
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1809
1921
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1810
1922
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1811
1923
  stderr only.
1812
1924
  --log-level=<option> [default: info] Specify level for logging.
1813
1925
  <options: debug|warn|error|info|trace>
1926
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1927
+ unaffected.
1814
1928
 
1815
1929
  DESCRIPTION
1816
1930
  Bulk update records matching an encoded query.
@@ -1846,7 +1960,7 @@ EXAMPLES
1846
1960
  $ nex bulk update --table incident --query "active=true" --data '{"state":"6"}' --confirm --json --auth dev
1847
1961
  ```
1848
1962
 
1849
- _See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/bulk/update.ts)_
1963
+ _See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/bulk/update.ts)_
1850
1964
 
1851
1965
  ## `nex exec SCOPE [FILE]`
1852
1966
 
@@ -1854,8 +1968,8 @@ Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.
1854
1968
 
1855
1969
  ```
1856
1970
  USAGE
1857
- $ nex exec SCOPE [FILE] [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
1858
- [--log-level debug|warn|error|info|trace] [-p <value>]
1971
+ $ nex exec SCOPE [FILE] [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1972
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-p <value>]
1859
1973
 
1860
1974
  ARGUMENTS
1861
1975
  SCOPE Scope to execute script in. Use "global" for global scope.
@@ -1868,6 +1982,8 @@ FLAGS
1868
1982
  GLOBAL FLAGS
1869
1983
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1870
1984
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1985
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1986
+ --deny-write Refuse any change to instance data for this invocation.
1871
1987
  --json Format output as json.
1872
1988
  --log-dir=<value> Directory to write log files to. Implies --log-file.
1873
1989
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -1875,6 +1991,8 @@ GLOBAL FLAGS
1875
1991
  stderr only.
1876
1992
  --log-level=<option> [default: info] Specify level for logging.
1877
1993
  <options: debug|warn|error|info|trace>
1994
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1995
+ unaffected.
1878
1996
 
1879
1997
  DESCRIPTION
1880
1998
  Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.
@@ -1972,7 +2090,7 @@ EXAMPLES
1972
2090
  $ nex exec global ./script.js --auth dev-instance --params '{"token":"abc123","env":"dev"}'
1973
2091
  ```
1974
2092
 
1975
- _See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/exec/index.ts)_
2093
+ _See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/exec/index.ts)_
1976
2094
 
1977
2095
  ## `nex flow action`
1978
2096
 
@@ -1980,8 +2098,9 @@ Execute a Flow Designer action by scoped name.
1980
2098
 
1981
2099
  ```
1982
2100
  USAGE
1983
- $ nex flow action -n <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
1984
- debug|warn|error|info|trace] [-i <value>] [-m foreground|background] [--scope <value>] [--quick]
2101
+ $ nex flow action -n <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2102
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-i <value>] [-m
2103
+ foreground|background] [--scope <value>] [--quick]
1985
2104
 
1986
2105
  FLAGS
1987
2106
  -a, --auth=<value> Auth alias to use.
@@ -1996,12 +2115,16 @@ FLAGS
1996
2115
  GLOBAL FLAGS
1997
2116
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1998
2117
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2118
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2119
+ --deny-write Refuse any change to instance data for this invocation.
1999
2120
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2000
2121
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2001
2122
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2002
2123
  stderr only.
2003
2124
  --log-level=<option> [default: info] Specify level for logging.
2004
2125
  <options: debug|warn|error|info|trace>
2126
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2127
+ unaffected.
2005
2128
 
2006
2129
  DESCRIPTION
2007
2130
  Execute a Flow Designer action by scoped name.
@@ -2021,7 +2144,7 @@ EXAMPLES
2021
2144
  '{"table":"incident","values":{"short_description":"Test"}}' --auth dev
2022
2145
  ```
2023
2146
 
2024
- _See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/action.ts)_
2147
+ _See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/action.ts)_
2025
2148
 
2026
2149
  ## `nex flow cancel`
2027
2150
 
@@ -2029,8 +2152,8 @@ Cancel a running or paused flow execution.
2029
2152
 
2030
2153
  ```
2031
2154
  USAGE
2032
- $ nex flow cancel -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2033
- debug|warn|error|info|trace] [-r <value>] [--scope <value>]
2155
+ $ nex flow cancel -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2156
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-r <value>] [--scope <value>]
2034
2157
 
2035
2158
  FLAGS
2036
2159
  -a, --auth=<value> Auth alias to use.
@@ -2042,12 +2165,16 @@ FLAGS
2042
2165
  GLOBAL FLAGS
2043
2166
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2044
2167
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2168
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2169
+ --deny-write Refuse any change to instance data for this invocation.
2045
2170
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2046
2171
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2047
2172
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2048
2173
  stderr only.
2049
2174
  --log-level=<option> [default: info] Specify level for logging.
2050
2175
  <options: debug|warn|error|info|trace>
2176
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2177
+ unaffected.
2051
2178
 
2052
2179
  DESCRIPTION
2053
2180
  Cancel a running or paused flow execution.
@@ -2064,7 +2191,7 @@ EXAMPLES
2064
2191
  $ nex flow cancel --context-id abc123def456 --reason "No longer needed" --auth dev
2065
2192
  ```
2066
2193
 
2067
- _See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/cancel.ts)_
2194
+ _See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/cancel.ts)_
2068
2195
 
2069
2196
  ## `nex flow copy`
2070
2197
 
@@ -2072,8 +2199,8 @@ Copy an existing flow into a target scoped application.
2072
2199
 
2073
2200
  ```
2074
2201
  USAGE
2075
- $ nex flow copy -s <value> -n <value> -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>]
2076
- [--log-file] [--log-level debug|warn|error|info|trace]
2202
+ $ nex flow copy -s <value> -n <value> -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute]
2203
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
2077
2204
 
2078
2205
  FLAGS
2079
2206
  -a, --auth=<value> Auth alias to use.
@@ -2086,12 +2213,16 @@ FLAGS
2086
2213
  GLOBAL FLAGS
2087
2214
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2088
2215
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2216
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2217
+ --deny-write Refuse any change to instance data for this invocation.
2089
2218
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2090
2219
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2091
2220
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2092
2221
  stderr only.
2093
2222
  --log-level=<option> [default: info] Specify level for logging.
2094
2223
  <options: debug|warn|error|info|trace>
2224
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2225
+ unaffected.
2095
2226
 
2096
2227
  DESCRIPTION
2097
2228
  Copy an existing flow into a target scoped application.
@@ -2125,7 +2256,80 @@ EXAMPLES
2125
2256
  dev
2126
2257
  ```
2127
2258
 
2128
- _See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/copy.ts)_
2259
+ _See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/copy.ts)_
2260
+
2261
+ ## `nex flow definition`
2262
+
2263
+ Retrieve the read-only design-time definition of a flow, subflow, or action.
2264
+
2265
+ ```
2266
+ USAGE
2267
+ $ nex flow definition -i <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2268
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-t flow|subflow|action] [--scope
2269
+ <value>]
2270
+
2271
+ FLAGS
2272
+ -a, --auth=<value> Auth alias to use.
2273
+ -i, --sys-id=<value> (required) sys_id of the flow, subflow, or action to retrieve
2274
+ -j, --json Output the complete typed result as JSON
2275
+ -t, --type=<option> [default: flow] Artifact type to retrieve. Must match what the sys_id actually is.
2276
+ <options: flow|subflow|action>
2277
+ --scope=<value> Scope sys_id or name for the transaction scope parameter. Optional — ServiceNow resolves the
2278
+ artifact's own scope when omitted.
2279
+
2280
+ GLOBAL FLAGS
2281
+ --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2282
+ sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2283
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2284
+ --deny-write Refuse any change to instance data for this invocation.
2285
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2286
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2287
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2288
+ stderr only.
2289
+ --log-level=<option> [default: info] Specify level for logging.
2290
+ <options: debug|warn|error|info|trace>
2291
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2292
+ unaffected.
2293
+
2294
+ DESCRIPTION
2295
+ Retrieve the read-only design-time definition of a flow, subflow, or action.
2296
+
2297
+ Returns what the artifact IS, not what a run of it did: triggers, actions, nested subflows, flow logic, inputs and
2298
+ outputs as Workflow Studio stores them. Nothing is executed, published or modified, and no flow context is created or
2299
+ required.
2300
+
2301
+ This is the design-time counterpart to `flow details`, which describes one past execution and needs a context sys_id.
2302
+
2303
+ The type is never inferred from the sys_id: --type selects the artifact that is asked for, and a sys_id of a different
2304
+ type fails with a type_mismatch rather than being relabelled.
2305
+
2306
+ With --json, stdout carries exactly one JSON document — the complete typed result including the untouched ServiceNow
2307
+ payload — so it can be piped or redirected. Without it, a short summary is printed; definition bodies, step scripts
2308
+ and input values are never printed or logged.
2309
+
2310
+ EXAMPLES
2311
+ Summarise a flow definition
2312
+
2313
+ $ nex flow definition --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev
2314
+
2315
+ Retrieve a subflow definition
2316
+
2317
+ $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev
2318
+
2319
+ Retrieve a custom action definition with its ordered steps
2320
+
2321
+ $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev
2322
+
2323
+ Redirect the full JSON definition to a file
2324
+
2325
+ $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json
2326
+
2327
+ Pipe the JSON definition into another tool
2328
+
2329
+ $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps
2330
+ ```
2331
+
2332
+ _See code: [src/commands/flow/definition.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/definition.ts)_
2129
2333
 
2130
2334
  ## `nex flow details`
2131
2335
 
@@ -2133,8 +2337,8 @@ Get rich execution details for a flow context.
2133
2337
 
2134
2338
  ```
2135
2339
  USAGE
2136
- $ nex flow details -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2137
- debug|warn|error|info|trace] [--scope <value>] [-d]
2340
+ $ nex flow details -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2341
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>] [-d]
2138
2342
 
2139
2343
  FLAGS
2140
2344
  -a, --auth=<value> Auth alias to use.
@@ -2146,12 +2350,16 @@ FLAGS
2146
2350
  GLOBAL FLAGS
2147
2351
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2148
2352
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2353
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2354
+ --deny-write Refuse any change to instance data for this invocation.
2149
2355
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2150
2356
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2151
2357
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2152
2358
  stderr only.
2153
2359
  --log-level=<option> [default: info] Specify level for logging.
2154
2360
  <options: debug|warn|error|info|trace>
2361
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2362
+ unaffected.
2155
2363
 
2156
2364
  DESCRIPTION
2157
2365
  Get rich execution details for a flow context.
@@ -2182,7 +2390,7 @@ EXAMPLES
2182
2390
  $ nex flow details -c d4e5f6789012345678abcdef01234567 --json --auth dev
2183
2391
  ```
2184
2392
 
2185
- _See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/details.ts)_
2393
+ _See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/details.ts)_
2186
2394
 
2187
2395
  ## `nex flow error`
2188
2396
 
@@ -2190,8 +2398,8 @@ Retrieve error details from a failed flow execution.
2190
2398
 
2191
2399
  ```
2192
2400
  USAGE
2193
- $ nex flow error -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2194
- debug|warn|error|info|trace] [--scope <value>]
2401
+ $ nex flow error -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2402
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>]
2195
2403
 
2196
2404
  FLAGS
2197
2405
  -a, --auth=<value> Auth alias to use.
@@ -2202,12 +2410,16 @@ FLAGS
2202
2410
  GLOBAL FLAGS
2203
2411
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2204
2412
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2413
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2414
+ --deny-write Refuse any change to instance data for this invocation.
2205
2415
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2206
2416
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2207
2417
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2208
2418
  stderr only.
2209
2419
  --log-level=<option> [default: info] Specify level for logging.
2210
2420
  <options: debug|warn|error|info|trace>
2421
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2422
+ unaffected.
2211
2423
 
2212
2424
  DESCRIPTION
2213
2425
  Retrieve error details from a failed flow execution.
@@ -2220,7 +2432,7 @@ EXAMPLES
2220
2432
  $ nex flow error --context-id abc123def456 --auth dev
2221
2433
  ```
2222
2434
 
2223
- _See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/error.ts)_
2435
+ _See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/error.ts)_
2224
2436
 
2225
2437
  ## `nex flow logs`
2226
2438
 
@@ -2228,8 +2440,8 @@ Retrieve flow execution log entries for a given context.
2228
2440
 
2229
2441
  ```
2230
2442
  USAGE
2231
- $ nex flow logs -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2232
- debug|warn|error|info|trace] [-l <value>] [-o asc|desc]
2443
+ $ nex flow logs -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2444
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l <value>] [-o asc|desc]
2233
2445
 
2234
2446
  FLAGS
2235
2447
  -a, --auth=<value> Auth alias to use.
@@ -2242,12 +2454,16 @@ FLAGS
2242
2454
  GLOBAL FLAGS
2243
2455
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2244
2456
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2457
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2458
+ --deny-write Refuse any change to instance data for this invocation.
2245
2459
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2246
2460
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2247
2461
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2248
2462
  stderr only.
2249
2463
  --log-level=<option> [default: info] Specify level for logging.
2250
2464
  <options: debug|warn|error|info|trace>
2465
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2466
+ unaffected.
2251
2467
 
2252
2468
  DESCRIPTION
2253
2469
  Retrieve flow execution log entries for a given context.
@@ -2274,7 +2490,7 @@ EXAMPLES
2274
2490
  $ nex flow logs -c d4e5f6789012345678abcdef01234567 --json --auth dev
2275
2491
  ```
2276
2492
 
2277
- _See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/logs.ts)_
2493
+ _See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/logs.ts)_
2278
2494
 
2279
2495
  ## `nex flow message`
2280
2496
 
@@ -2282,8 +2498,9 @@ Send a message to a paused flow execution.
2282
2498
 
2283
2499
  ```
2284
2500
  USAGE
2285
- $ nex flow message -c <value> -m <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
2286
- [--log-level debug|warn|error|info|trace] [-p <value>] [--scope <value>]
2501
+ $ nex flow message -c <value> -m <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
2502
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-p <value>] [--scope
2503
+ <value>]
2287
2504
 
2288
2505
  FLAGS
2289
2506
  -a, --auth=<value> Auth alias to use.
@@ -2296,12 +2513,16 @@ FLAGS
2296
2513
  GLOBAL FLAGS
2297
2514
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2298
2515
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2516
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2517
+ --deny-write Refuse any change to instance data for this invocation.
2299
2518
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2300
2519
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2301
2520
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2302
2521
  stderr only.
2303
2522
  --log-level=<option> [default: info] Specify level for logging.
2304
2523
  <options: debug|warn|error|info|trace>
2524
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2525
+ unaffected.
2305
2526
 
2306
2527
  DESCRIPTION
2307
2528
  Send a message to a paused flow execution.
@@ -2319,7 +2540,7 @@ EXAMPLES
2319
2540
  $ nex flow message --context-id abc123def456 --message "data_ready" --payload '{"status":"ok"}' --auth dev
2320
2541
  ```
2321
2542
 
2322
- _See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/message.ts)_
2543
+ _See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/message.ts)_
2323
2544
 
2324
2545
  ## `nex flow outputs`
2325
2546
 
@@ -2327,8 +2548,8 @@ Retrieve outputs from a completed flow execution.
2327
2548
 
2328
2549
  ```
2329
2550
  USAGE
2330
- $ nex flow outputs -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2331
- debug|warn|error|info|trace] [--scope <value>]
2551
+ $ nex flow outputs -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2552
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>]
2332
2553
 
2333
2554
  FLAGS
2334
2555
  -a, --auth=<value> Auth alias to use.
@@ -2339,12 +2560,16 @@ FLAGS
2339
2560
  GLOBAL FLAGS
2340
2561
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2341
2562
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2563
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2564
+ --deny-write Refuse any change to instance data for this invocation.
2342
2565
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2343
2566
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2344
2567
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2345
2568
  stderr only.
2346
2569
  --log-level=<option> [default: info] Specify level for logging.
2347
2570
  <options: debug|warn|error|info|trace>
2571
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2572
+ unaffected.
2348
2573
 
2349
2574
  DESCRIPTION
2350
2575
  Retrieve outputs from a completed flow execution.
@@ -2361,7 +2586,7 @@ EXAMPLES
2361
2586
  $ nex flow outputs --context-id abc123def456 --json --auth dev
2362
2587
  ```
2363
2588
 
2364
- _See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/outputs.ts)_
2589
+ _See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/outputs.ts)_
2365
2590
 
2366
2591
  ## `nex flow run`
2367
2592
 
@@ -2369,8 +2594,9 @@ Execute a published Flow Designer flow by scoped name.
2369
2594
 
2370
2595
  ```
2371
2596
  USAGE
2372
- $ nex flow run -n <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2373
- debug|warn|error|info|trace] [-i <value>] [-m foreground|background] [--scope <value>] [--quick]
2597
+ $ nex flow run -n <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2598
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-i <value>] [-m
2599
+ foreground|background] [--scope <value>] [--quick]
2374
2600
 
2375
2601
  FLAGS
2376
2602
  -a, --auth=<value> Auth alias to use.
@@ -2385,12 +2611,16 @@ FLAGS
2385
2611
  GLOBAL FLAGS
2386
2612
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2387
2613
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2614
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2615
+ --deny-write Refuse any change to instance data for this invocation.
2388
2616
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2389
2617
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2390
2618
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2391
2619
  stderr only.
2392
2620
  --log-level=<option> [default: info] Specify level for logging.
2393
2621
  <options: debug|warn|error|info|trace>
2622
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2623
+ unaffected.
2394
2624
 
2395
2625
  DESCRIPTION
2396
2626
  Execute a published Flow Designer flow by scoped name.
@@ -2422,7 +2652,7 @@ EXAMPLES
2422
2652
  $ nex flow run --name global.my_flow --mode background --auth dev
2423
2653
  ```
2424
2654
 
2425
- _See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/run.ts)_
2655
+ _See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/run.ts)_
2426
2656
 
2427
2657
  ## `nex flow status`
2428
2658
 
@@ -2430,8 +2660,8 @@ Get the status of a flow execution context.
2430
2660
 
2431
2661
  ```
2432
2662
  USAGE
2433
- $ nex flow status -c <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2434
- debug|warn|error|info|trace] [--scope <value>]
2663
+ $ nex flow status -c <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2664
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>]
2435
2665
 
2436
2666
  FLAGS
2437
2667
  -a, --auth=<value> Auth alias to use.
@@ -2442,12 +2672,16 @@ FLAGS
2442
2672
  GLOBAL FLAGS
2443
2673
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2444
2674
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2675
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2676
+ --deny-write Refuse any change to instance data for this invocation.
2445
2677
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2446
2678
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2447
2679
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2448
2680
  stderr only.
2449
2681
  --log-level=<option> [default: info] Specify level for logging.
2450
2682
  <options: debug|warn|error|info|trace>
2683
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2684
+ unaffected.
2451
2685
 
2452
2686
  DESCRIPTION
2453
2687
  Get the status of a flow execution context.
@@ -2462,7 +2696,7 @@ EXAMPLES
2462
2696
  $ nex flow status --context-id abc123def456 --auth dev
2463
2697
  ```
2464
2698
 
2465
- _See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/status.ts)_
2699
+ _See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/status.ts)_
2466
2700
 
2467
2701
  ## `nex flow subflow`
2468
2702
 
@@ -2470,8 +2704,9 @@ Execute a published Flow Designer subflow by scoped name.
2470
2704
 
2471
2705
  ```
2472
2706
  USAGE
2473
- $ nex flow subflow -n <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2474
- debug|warn|error|info|trace] [-i <value>] [-m foreground|background] [--scope <value>] [--quick]
2707
+ $ nex flow subflow -n <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2708
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-i <value>] [-m
2709
+ foreground|background] [--scope <value>] [--quick]
2475
2710
 
2476
2711
  FLAGS
2477
2712
  -a, --auth=<value> Auth alias to use.
@@ -2486,12 +2721,16 @@ FLAGS
2486
2721
  GLOBAL FLAGS
2487
2722
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2488
2723
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2724
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2725
+ --deny-write Refuse any change to instance data for this invocation.
2489
2726
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2490
2727
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2491
2728
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2492
2729
  stderr only.
2493
2730
  --log-level=<option> [default: info] Specify level for logging.
2494
2731
  <options: debug|warn|error|info|trace>
2732
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2733
+ unaffected.
2495
2734
 
2496
2735
  DESCRIPTION
2497
2736
  Execute a published Flow Designer subflow by scoped name.
@@ -2517,7 +2756,7 @@ EXAMPLES
2517
2756
  $ nex flow subflow --name x_myapp.process_record --inputs '{"table":"incident","sys_id":"abc123"}' --auth dev
2518
2757
  ```
2519
2758
 
2520
- _See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/subflow.ts)_
2759
+ _See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/subflow.ts)_
2521
2760
 
2522
2761
  ## `nex flow test`
2523
2762
 
@@ -2525,8 +2764,9 @@ Test a Flow Designer flow without requiring it to be published.
2525
2764
 
2526
2765
  ```
2527
2766
  USAGE
2528
- $ nex flow test -f <value> -o <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
2529
- [--log-level debug|warn|error|info|trace] [--scope <value>] [--synchronous]
2767
+ $ nex flow test -f <value> -o <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
2768
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--scope <value>]
2769
+ [--synchronous]
2530
2770
 
2531
2771
  FLAGS
2532
2772
  -a, --auth=<value> Auth alias to use.
@@ -2540,12 +2780,16 @@ FLAGS
2540
2780
  GLOBAL FLAGS
2541
2781
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2542
2782
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2783
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2784
+ --deny-write Refuse any change to instance data for this invocation.
2543
2785
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2544
2786
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2545
2787
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2546
2788
  stderr only.
2547
2789
  --log-level=<option> [default: info] Specify level for logging.
2548
2790
  <options: debug|warn|error|info|trace>
2791
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2792
+ unaffected.
2549
2793
 
2550
2794
  DESCRIPTION
2551
2795
  Test a Flow Designer flow without requiring it to be published.
@@ -2575,7 +2819,7 @@ EXAMPLES
2575
2819
  $ nex flow test -f 887dda5583237210fdb8f7b6feaad32c -o '{"current":"abc123"}' --json --auth dev
2576
2820
  ```
2577
2821
 
2578
- _See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/flow/test.ts)_
2822
+ _See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/flow/test.ts)_
2579
2823
 
2580
2824
  ## `nex health check`
2581
2825
 
@@ -2583,9 +2827,9 @@ Run a consolidated health check on a ServiceNow instance.
2583
2827
 
2584
2828
  ```
2585
2829
  USAGE
2586
- $ nex health check [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2587
- debug|warn|error|info|trace] [--include-version] [--include-cluster] [--include-stuck-jobs] [--include-semaphores]
2588
- [--include-operational-counts] [--stuck-job-threshold <value>]
2830
+ $ nex health check [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
2831
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--include-version] [--include-cluster]
2832
+ [--include-stuck-jobs] [--include-semaphores] [--include-operational-counts] [--stuck-job-threshold <value>]
2589
2833
 
2590
2834
  FLAGS
2591
2835
  -a, --auth=<value> Auth alias to use.
@@ -2600,12 +2844,16 @@ FLAGS
2600
2844
  GLOBAL FLAGS
2601
2845
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2602
2846
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2847
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2848
+ --deny-write Refuse any change to instance data for this invocation.
2603
2849
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2604
2850
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2605
2851
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2606
2852
  stderr only.
2607
2853
  --log-level=<option> [default: info] Specify level for logging.
2608
2854
  <options: debug|warn|error|info|trace>
2855
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2856
+ unaffected.
2609
2857
 
2610
2858
  DESCRIPTION
2611
2859
  Run a consolidated health check on a ServiceNow instance.
@@ -2641,7 +2889,7 @@ EXAMPLES
2641
2889
  $ nex health check --json --auth dev
2642
2890
  ```
2643
2891
 
2644
- _See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/health/check.ts)_
2892
+ _See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/health/check.ts)_
2645
2893
 
2646
2894
  ## `nex help [COMMAND]`
2647
2895
 
@@ -2661,7 +2909,7 @@ DESCRIPTION
2661
2909
  Display help for nex.
2662
2910
  ```
2663
2911
 
2664
- _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.55/src/commands/help.ts)_
2912
+ _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.56/src/commands/help.ts)_
2665
2913
 
2666
2914
  ## `nex log`
2667
2915
 
@@ -2669,8 +2917,9 @@ Tail and monitor ServiceNow system logs in real-time with beautiful formatting.
2669
2917
 
2670
2918
  ```
2671
2919
  USAGE
2672
- $ nex log [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
2673
- debug|warn|error|info|trace] [-o <value>] [-i <value>] [--no-color] [-f <value>...]
2920
+ $ nex log [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
2921
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-o <value>] [-i <value>] [--no-color] [-f
2922
+ <value>...]
2674
2923
 
2675
2924
  FLAGS
2676
2925
  -a, --auth=<value> Auth alias to use.
@@ -2685,6 +2934,8 @@ FLAGS
2685
2934
  GLOBAL FLAGS
2686
2935
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2687
2936
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2937
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2938
+ --deny-write Refuse any change to instance data for this invocation.
2688
2939
  --json Format output as json.
2689
2940
  --log-dir=<value> Directory to write log files to. Implies --log-file.
2690
2941
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -2692,6 +2943,8 @@ GLOBAL FLAGS
2692
2943
  stderr only.
2693
2944
  --log-level=<option> [default: info] Specify level for logging.
2694
2945
  <options: debug|warn|error|info|trace>
2946
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2947
+ unaffected.
2695
2948
 
2696
2949
  DESCRIPTION
2697
2950
  Tail and monitor ServiceNow system logs in real-time with beautiful formatting.
@@ -2772,7 +3025,7 @@ EXAMPLES
2772
3025
  $ nex log --no-color --auth dev-instance
2773
3026
  ```
2774
3027
 
2775
- _See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/log/index.ts)_
3028
+ _See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/log/index.ts)_
2776
3029
 
2777
3030
  ## `nex plugins`
2778
3031
 
@@ -3064,14 +3317,47 @@ DESCRIPTION
3064
3317
 
3065
3318
  _See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.4.86/src/commands/plugins/update.ts)_
3066
3319
 
3320
+ ## `nex policy status`
3321
+
3322
+ Show what this invocation is permitted to change on the instance, and why.
3323
+
3324
+ ```
3325
+ USAGE
3326
+ $ nex policy status [--json] [--deny-execute] [--deny-write] [--read-only]
3327
+
3328
+ FLAGS
3329
+ --deny-execute Evaluate as if --deny-execute were passed.
3330
+ --deny-write Evaluate as if --deny-write were passed.
3331
+ --read-only Evaluate as if --read-only were passed.
3332
+
3333
+ GLOBAL FLAGS
3334
+ --json Format output as json.
3335
+
3336
+ DESCRIPTION
3337
+ Show what this invocation is permitted to change on the instance, and why.
3338
+
3339
+ Changes are permitted by default. NEX_POLICY_DENY, set in the environment, outranks every command-line flag — that is
3340
+ the only layer an agent driving this CLI cannot reach.
3341
+
3342
+ EXAMPLES
3343
+ $ nex policy status
3344
+
3345
+ $ nex policy status --read-only
3346
+
3347
+ NEX_POLICY_DENY=all nex policy status
3348
+ ```
3349
+
3350
+ _See code: [src/commands/policy/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/policy/status.ts)_
3351
+
3067
3352
  ## `nex query`
3068
3353
 
3069
3354
  Query any ServiceNow table using the Table API.
3070
3355
 
3071
3356
  ```
3072
3357
  USAGE
3073
- $ nex query -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3074
- debug|warn|error|info|trace] [-q <value>] [-f <value>] [-d] [-l <value>]
3358
+ $ nex query -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3359
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>] [-f <value>] [-d] [-l
3360
+ <value>]
3075
3361
 
3076
3362
  FLAGS
3077
3363
  -a, --auth=<value> Auth alias to use.
@@ -3085,12 +3371,16 @@ FLAGS
3085
3371
  GLOBAL FLAGS
3086
3372
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3087
3373
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3374
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3375
+ --deny-write Refuse any change to instance data for this invocation.
3088
3376
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3089
3377
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3090
3378
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3091
3379
  stderr only.
3092
3380
  --log-level=<option> [default: info] Specify level for logging.
3093
3381
  <options: debug|warn|error|info|trace>
3382
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3383
+ unaffected.
3094
3384
 
3095
3385
  DESCRIPTION
3096
3386
  Query any ServiceNow table using the Table API.
@@ -3120,7 +3410,7 @@ EXAMPLES
3120
3410
  $ nex query --table sys_user --query "active=true" --limit 5 --json --auth dev
3121
3411
  ```
3122
3412
 
3123
- _See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/query/index.ts)_
3413
+ _See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/query/index.ts)_
3124
3414
 
3125
3415
  ## `nex query app`
3126
3416
 
@@ -3128,8 +3418,8 @@ Search for applications by name across scoped apps and plugins.
3128
3418
 
3129
3419
  ```
3130
3420
  USAGE
3131
- $ nex query app -s <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3132
- debug|warn|error|info|trace] [-a] [-l <value>]
3421
+ $ nex query app -s <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3422
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-a] [-l <value>]
3133
3423
 
3134
3424
  FLAGS
3135
3425
  -a, --active Only show active applications
@@ -3141,12 +3431,16 @@ FLAGS
3141
3431
  GLOBAL FLAGS
3142
3432
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3143
3433
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3434
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3435
+ --deny-write Refuse any change to instance data for this invocation.
3144
3436
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3145
3437
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3146
3438
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3147
3439
  stderr only.
3148
3440
  --log-level=<option> [default: info] Specify level for logging.
3149
3441
  <options: debug|warn|error|info|trace>
3442
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3443
+ unaffected.
3150
3444
 
3151
3445
  DESCRIPTION
3152
3446
  Search for applications by name across scoped apps and plugins.
@@ -3169,7 +3463,7 @@ EXAMPLES
3169
3463
  $ nex query app --search "HR" --active --auth dev
3170
3464
  ```
3171
3465
 
3172
- _See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/query/app.ts)_
3466
+ _See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/query/app.ts)_
3173
3467
 
3174
3468
  ## `nex query columns`
3175
3469
 
@@ -3177,8 +3471,8 @@ List and search columns (fields) on a ServiceNow table.
3177
3471
 
3178
3472
  ```
3179
3473
  USAGE
3180
- $ nex query columns -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3181
- debug|warn|error|info|trace] [-s <value>]
3474
+ $ nex query columns -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3475
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-s <value>]
3182
3476
 
3183
3477
  FLAGS
3184
3478
  -a, --auth=<value> Auth alias to use.
@@ -3189,12 +3483,16 @@ FLAGS
3189
3483
  GLOBAL FLAGS
3190
3484
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3191
3485
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3486
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3487
+ --deny-write Refuse any change to instance data for this invocation.
3192
3488
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3193
3489
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3194
3490
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3195
3491
  stderr only.
3196
3492
  --log-level=<option> [default: info] Specify level for logging.
3197
3493
  <options: debug|warn|error|info|trace>
3494
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3495
+ unaffected.
3198
3496
 
3199
3497
  DESCRIPTION
3200
3498
  List and search columns (fields) on a ServiceNow table.
@@ -3220,7 +3518,7 @@ EXAMPLES
3220
3518
  $ nex query columns --table incident --json --auth dev
3221
3519
  ```
3222
3520
 
3223
- _See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/query/columns.ts)_
3521
+ _See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/query/columns.ts)_
3224
3522
 
3225
3523
  ## `nex query syslog`
3226
3524
 
@@ -3228,8 +3526,8 @@ Query ServiceNow system logs (one-shot, non-tailing).
3228
3526
 
3229
3527
  ```
3230
3528
  USAGE
3231
- $ nex query syslog [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3232
- debug|warn|error|info|trace] [-q <value>] [-l <value>]
3529
+ $ nex query syslog [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
3530
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-q <value>] [-l <value>]
3233
3531
 
3234
3532
  FLAGS
3235
3533
  -a, --auth=<value> Auth alias to use.
@@ -3240,12 +3538,16 @@ FLAGS
3240
3538
  GLOBAL FLAGS
3241
3539
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3242
3540
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3541
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3542
+ --deny-write Refuse any change to instance data for this invocation.
3243
3543
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3244
3544
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3245
3545
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3246
3546
  stderr only.
3247
3547
  --log-level=<option> [default: info] Specify level for logging.
3248
3548
  <options: debug|warn|error|info|trace>
3549
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3550
+ unaffected.
3249
3551
 
3250
3552
  DESCRIPTION
3251
3553
  Query ServiceNow system logs (one-shot, non-tailing).
@@ -3273,7 +3575,7 @@ EXAMPLES
3273
3575
  $ nex query syslog --query "sourceLIKEincident" --json --auth dev
3274
3576
  ```
3275
3577
 
3276
- _See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/query/syslog.ts)_
3578
+ _See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/query/syslog.ts)_
3277
3579
 
3278
3580
  ## `nex schema`
3279
3581
 
@@ -3281,9 +3583,9 @@ Discover and inspect a ServiceNow table schema including fields, types, and rela
3281
3583
 
3282
3584
  ```
3283
3585
  USAGE
3284
- $ nex schema -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3285
- debug|warn|error|info|trace] [--include-choices] [--include-relationships] [--include-ui-policies]
3286
- [--include-business-rules]
3586
+ $ nex schema -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3587
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--include-choices]
3588
+ [--include-relationships] [--include-ui-policies] [--include-business-rules]
3287
3589
 
3288
3590
  FLAGS
3289
3591
  -a, --auth=<value> Auth alias to use.
@@ -3297,12 +3599,16 @@ FLAGS
3297
3599
  GLOBAL FLAGS
3298
3600
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3299
3601
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3602
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3603
+ --deny-write Refuse any change to instance data for this invocation.
3300
3604
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3301
3605
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3302
3606
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3303
3607
  stderr only.
3304
3608
  --log-level=<option> [default: info] Specify level for logging.
3305
3609
  <options: debug|warn|error|info|trace>
3610
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3611
+ unaffected.
3306
3612
 
3307
3613
  DESCRIPTION
3308
3614
  Discover and inspect a ServiceNow table schema including fields, types, and relationships.
@@ -3328,7 +3634,7 @@ EXAMPLES
3328
3634
  $ nex schema --table incident --include-choices --include-relationships --auth dev
3329
3635
  ```
3330
3636
 
3331
- _See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/schema/index.ts)_
3637
+ _See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/schema/index.ts)_
3332
3638
 
3333
3639
  ## `nex schema field`
3334
3640
 
@@ -3336,8 +3642,8 @@ Get detailed information about a specific field on a ServiceNow table.
3336
3642
 
3337
3643
  ```
3338
3644
  USAGE
3339
- $ nex schema field -t <value> -f <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
3340
- [--log-level debug|warn|error|info|trace]
3645
+ $ nex schema field -t <value> -f <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
3646
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3341
3647
 
3342
3648
  FLAGS
3343
3649
  -a, --auth=<value> Auth alias to use.
@@ -3348,12 +3654,16 @@ FLAGS
3348
3654
  GLOBAL FLAGS
3349
3655
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3350
3656
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3657
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3658
+ --deny-write Refuse any change to instance data for this invocation.
3351
3659
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3352
3660
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3353
3661
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3354
3662
  stderr only.
3355
3663
  --log-level=<option> [default: info] Specify level for logging.
3356
3664
  <options: debug|warn|error|info|trace>
3665
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3666
+ unaffected.
3357
3667
 
3358
3668
  DESCRIPTION
3359
3669
  Get detailed information about a specific field on a ServiceNow table.
@@ -3371,7 +3681,7 @@ EXAMPLES
3371
3681
  $ nex schema field --table incident --field priority --json --auth dev
3372
3682
  ```
3373
3683
 
3374
- _See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/schema/field.ts)_
3684
+ _See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/schema/field.ts)_
3375
3685
 
3376
3686
  ## `nex schema validate-catalog`
3377
3687
 
@@ -3379,8 +3689,8 @@ Validate a ServiceNow catalog item configuration for common issues.
3379
3689
 
3380
3690
  ```
3381
3691
  USAGE
3382
- $ nex schema validate-catalog -s <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3383
- debug|warn|error|info|trace]
3692
+ $ nex schema validate-catalog -s <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3693
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3384
3694
 
3385
3695
  FLAGS
3386
3696
  -a, --auth=<value> Auth alias to use.
@@ -3390,12 +3700,16 @@ FLAGS
3390
3700
  GLOBAL FLAGS
3391
3701
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3392
3702
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3703
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3704
+ --deny-write Refuse any change to instance data for this invocation.
3393
3705
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3394
3706
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
3395
3707
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
3396
3708
  stderr only.
3397
3709
  --log-level=<option> [default: info] Specify level for logging.
3398
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.
3399
3713
 
3400
3714
  DESCRIPTION
3401
3715
  Validate a ServiceNow catalog item configuration for common issues.
@@ -3413,7 +3727,7 @@ EXAMPLES
3413
3727
  $ nex schema validate-catalog --sys-id a1b2c3d4e5f6 --json --auth dev
3414
3728
  ```
3415
3729
 
3416
- _See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/schema/validate-catalog.ts)_
3730
+ _See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/schema/validate-catalog.ts)_
3417
3731
 
3418
3732
  ## `nex scope`
3419
3733
 
@@ -3421,8 +3735,8 @@ Get the current application scope or list available applications.
3421
3735
 
3422
3736
  ```
3423
3737
  USAGE
3424
- $ nex scope [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3425
- debug|warn|error|info|trace] [-l]
3738
+ $ nex scope [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
3739
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l]
3426
3740
 
3427
3741
  FLAGS
3428
3742
  -a, --auth=<value> Auth alias to use.
@@ -3431,6 +3745,8 @@ FLAGS
3431
3745
  GLOBAL FLAGS
3432
3746
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3433
3747
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3748
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3749
+ --deny-write Refuse any change to instance data for this invocation.
3434
3750
  --json Format output as json.
3435
3751
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3436
3752
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3438,6 +3754,8 @@ GLOBAL FLAGS
3438
3754
  stderr only.
3439
3755
  --log-level=<option> [default: info] Specify level for logging.
3440
3756
  <options: debug|warn|error|info|trace>
3757
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3758
+ unaffected.
3441
3759
 
3442
3760
  DESCRIPTION
3443
3761
  Get the current application scope or list available applications.
@@ -3456,7 +3774,7 @@ EXAMPLES
3456
3774
  $ nex scope -l --json --auth dev
3457
3775
  ```
3458
3776
 
3459
- _See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/scope/index.ts)_
3777
+ _See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/scope/index.ts)_
3460
3778
 
3461
3779
  ## `nex scope set`
3462
3780
 
@@ -3464,8 +3782,8 @@ Set the current application scope on a ServiceNow instance.
3464
3782
 
3465
3783
  ```
3466
3784
  USAGE
3467
- $ nex scope set -a <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3468
- debug|warn|error|info|trace]
3785
+ $ nex scope set -a <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3786
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3469
3787
 
3470
3788
  FLAGS
3471
3789
  -a, --app-id=<value> (required) 32-char sys_id of application
@@ -3474,6 +3792,8 @@ FLAGS
3474
3792
  GLOBAL FLAGS
3475
3793
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3476
3794
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3795
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3796
+ --deny-write Refuse any change to instance data for this invocation.
3477
3797
  --json Format output as json.
3478
3798
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3479
3799
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3481,6 +3801,8 @@ GLOBAL FLAGS
3481
3801
  stderr only.
3482
3802
  --log-level=<option> [default: info] Specify level for logging.
3483
3803
  <options: debug|warn|error|info|trace>
3804
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3805
+ unaffected.
3484
3806
 
3485
3807
  DESCRIPTION
3486
3808
  Set the current application scope on a ServiceNow instance.
@@ -3495,7 +3817,7 @@ EXAMPLES
3495
3817
  $ nex scope set -a abc123def456ghi789jkl012mno345pq --json --auth dev
3496
3818
  ```
3497
3819
 
3498
- _See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/scope/set.ts)_
3820
+ _See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/scope/set.ts)_
3499
3821
 
3500
3822
  ## `nex script-sync pull`
3501
3823
 
@@ -3504,8 +3826,8 @@ Pull a script from a ServiceNow instance to a local file.
3504
3826
  ```
3505
3827
  USAGE
3506
3828
  $ nex script-sync pull -n <value> -t sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client
3507
- [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [-o
3508
- <value>]
3829
+ [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>] [--log-file] [--log-level
3830
+ debug|warn|error|info|trace] [--read-only] [-o <value>]
3509
3831
 
3510
3832
  FLAGS
3511
3833
  -a, --auth=<value> Auth alias to use.
@@ -3517,6 +3839,8 @@ FLAGS
3517
3839
  GLOBAL FLAGS
3518
3840
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3519
3841
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3842
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3843
+ --deny-write Refuse any change to instance data for this invocation.
3520
3844
  --json Format output as json.
3521
3845
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3522
3846
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3524,6 +3848,8 @@ GLOBAL FLAGS
3524
3848
  stderr only.
3525
3849
  --log-level=<option> [default: info] Specify level for logging.
3526
3850
  <options: debug|warn|error|info|trace>
3851
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3852
+ unaffected.
3527
3853
 
3528
3854
  DESCRIPTION
3529
3855
  Pull a script from a ServiceNow instance to a local file.
@@ -3551,7 +3877,7 @@ EXAMPLES
3551
3877
  $ nex script-sync pull -n MyClientScript -t sys_script_client --json --auth dev-instance
3552
3878
  ```
3553
3879
 
3554
- _See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/script-sync/pull.ts)_
3880
+ _See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/script-sync/pull.ts)_
3555
3881
 
3556
3882
  ## `nex script-sync push`
3557
3883
 
@@ -3560,8 +3886,8 @@ Push a local script file to a ServiceNow instance.
3560
3886
  ```
3561
3887
  USAGE
3562
3888
  $ nex script-sync push -n <value> -t sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client -f
3563
- <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3564
- debug|warn|error|info|trace]
3889
+ <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>] [--log-file]
3890
+ [--log-level debug|warn|error|info|trace] [--read-only]
3565
3891
 
3566
3892
  FLAGS
3567
3893
  -a, --auth=<value> Auth alias to use.
@@ -3573,6 +3899,8 @@ FLAGS
3573
3899
  GLOBAL FLAGS
3574
3900
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3575
3901
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3902
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3903
+ --deny-write Refuse any change to instance data for this invocation.
3576
3904
  --json Format output as json.
3577
3905
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3578
3906
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3580,6 +3908,8 @@ GLOBAL FLAGS
3580
3908
  stderr only.
3581
3909
  --log-level=<option> [default: info] Specify level for logging.
3582
3910
  <options: debug|warn|error|info|trace>
3911
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3912
+ unaffected.
3583
3913
 
3584
3914
  DESCRIPTION
3585
3915
  Push a local script file to a ServiceNow instance.
@@ -3608,7 +3938,7 @@ EXAMPLES
3608
3938
  $ nex script-sync push -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --auth dev-instance
3609
3939
  ```
3610
3940
 
3611
- _See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/script-sync/push.ts)_
3941
+ _See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/script-sync/push.ts)_
3612
3942
 
3613
3943
  ## `nex script-sync sync`
3614
3944
 
@@ -3616,8 +3946,9 @@ Synchronize all scripts in a directory with a ServiceNow instance.
3616
3946
 
3617
3947
  ```
3618
3948
  USAGE
3619
- $ nex script-sync sync -d <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3620
- debug|warn|error|info|trace] [-t sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client...]
3949
+ $ nex script-sync sync -d <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
3950
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-t
3951
+ sys_script_include|sys_script|sys_ui_script|sys_ui_action|sys_script_client...]
3621
3952
 
3622
3953
  FLAGS
3623
3954
  -a, --auth=<value> Auth alias to use.
@@ -3628,6 +3959,8 @@ FLAGS
3628
3959
  GLOBAL FLAGS
3629
3960
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3630
3961
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
3962
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
3963
+ --deny-write Refuse any change to instance data for this invocation.
3631
3964
  --json Format output as json.
3632
3965
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3633
3966
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3635,6 +3968,8 @@ GLOBAL FLAGS
3635
3968
  stderr only.
3636
3969
  --log-level=<option> [default: info] Specify level for logging.
3637
3970
  <options: debug|warn|error|info|trace>
3971
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
3972
+ unaffected.
3638
3973
 
3639
3974
  DESCRIPTION
3640
3975
  Synchronize all scripts in a directory with a ServiceNow instance.
@@ -3662,7 +3997,7 @@ EXAMPLES
3662
3997
  $ nex script-sync sync -d ./scripts --json --auth dev-instance
3663
3998
  ```
3664
3999
 
3665
- _See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/script-sync/sync.ts)_
4000
+ _See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/script-sync/sync.ts)_
3666
4001
 
3667
4002
  ## `nex search`
3668
4003
 
@@ -3670,8 +4005,9 @@ Search platform code across a ServiceNow instance.
3670
4005
 
3671
4006
  ```
3672
4007
  USAGE
3673
- $ nex search -t <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3674
- debug|warn|error|info|trace] [-l <value>] [-s <value>] [-g <value>] [--table <value>]
4008
+ $ nex search -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4009
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l <value>] [-s <value>] [-g <value>]
4010
+ [--table <value>]
3675
4011
 
3676
4012
  FLAGS
3677
4013
  -a, --auth=<value> Auth alias to use.
@@ -3684,6 +4020,8 @@ FLAGS
3684
4020
  GLOBAL FLAGS
3685
4021
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3686
4022
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4023
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4024
+ --deny-write Refuse any change to instance data for this invocation.
3687
4025
  --json Format output as json.
3688
4026
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3689
4027
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3691,6 +4029,8 @@ GLOBAL FLAGS
3691
4029
  stderr only.
3692
4030
  --log-level=<option> [default: info] Specify level for logging.
3693
4031
  <options: debug|warn|error|info|trace>
4032
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4033
+ unaffected.
3694
4034
 
3695
4035
  DESCRIPTION
3696
4036
  Search platform code across a ServiceNow instance.
@@ -3724,7 +4064,7 @@ EXAMPLES
3724
4064
  $ nex search --term "GlideRecord" --limit 10 --json --auth dev-instance
3725
4065
  ```
3726
4066
 
3727
- _See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/search/index.ts)_
4067
+ _See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/search/index.ts)_
3728
4068
 
3729
4069
  ## `nex search add-table`
3730
4070
 
@@ -3732,8 +4072,8 @@ Add a table to a code search group on a ServiceNow instance.
3732
4072
 
3733
4073
  ```
3734
4074
  USAGE
3735
- $ nex search add-table -f <value> -g <value> -t <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>]
3736
- [--log-file] [--log-level debug|warn|error|info|trace]
4075
+ $ nex search add-table -f <value> -g <value> -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute]
4076
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3737
4077
 
3738
4078
  FLAGS
3739
4079
  -a, --auth=<value> Auth alias to use.
@@ -3744,6 +4084,8 @@ FLAGS
3744
4084
  GLOBAL FLAGS
3745
4085
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3746
4086
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4087
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4088
+ --deny-write Refuse any change to instance data for this invocation.
3747
4089
  --json Format output as json.
3748
4090
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3749
4091
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3751,6 +4093,8 @@ GLOBAL FLAGS
3751
4093
  stderr only.
3752
4094
  --log-level=<option> [default: info] Specify level for logging.
3753
4095
  <options: debug|warn|error|info|trace>
4096
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4097
+ unaffected.
3754
4098
 
3755
4099
  DESCRIPTION
3756
4100
  Add a table to a code search group on a ServiceNow instance.
@@ -3780,7 +4124,7 @@ EXAMPLES
3780
4124
  dev-instance
3781
4125
  ```
3782
4126
 
3783
- _See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/search/add-table.ts)_
4127
+ _See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/search/add-table.ts)_
3784
4128
 
3785
4129
  ## `nex search groups`
3786
4130
 
@@ -3788,8 +4132,8 @@ List all available code search groups on a ServiceNow instance.
3788
4132
 
3789
4133
  ```
3790
4134
  USAGE
3791
- $ nex search groups [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3792
- debug|warn|error|info|trace]
4135
+ $ nex search groups [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4136
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3793
4137
 
3794
4138
  FLAGS
3795
4139
  -a, --auth=<value> Auth alias to use.
@@ -3797,6 +4141,8 @@ FLAGS
3797
4141
  GLOBAL FLAGS
3798
4142
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3799
4143
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4144
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4145
+ --deny-write Refuse any change to instance data for this invocation.
3800
4146
  --json Format output as json.
3801
4147
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3802
4148
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3804,6 +4150,8 @@ GLOBAL FLAGS
3804
4150
  stderr only.
3805
4151
  --log-level=<option> [default: info] Specify level for logging.
3806
4152
  <options: debug|warn|error|info|trace>
4153
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4154
+ unaffected.
3807
4155
 
3808
4156
  DESCRIPTION
3809
4157
  List all available code search groups on a ServiceNow instance.
@@ -3825,7 +4173,7 @@ EXAMPLES
3825
4173
  $ nex search groups --json --auth dev-instance
3826
4174
  ```
3827
4175
 
3828
- _See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/search/groups.ts)_
4176
+ _See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/search/groups.ts)_
3829
4177
 
3830
4178
  ## `nex search tables`
3831
4179
 
@@ -3833,8 +4181,8 @@ List tables configured for a specific code search group.
3833
4181
 
3834
4182
  ```
3835
4183
  USAGE
3836
- $ nex search tables -g <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3837
- debug|warn|error|info|trace]
4184
+ $ nex search tables -g <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4185
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
3838
4186
 
3839
4187
  FLAGS
3840
4188
  -a, --auth=<value> Auth alias to use.
@@ -3843,6 +4191,8 @@ FLAGS
3843
4191
  GLOBAL FLAGS
3844
4192
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3845
4193
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4194
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4195
+ --deny-write Refuse any change to instance data for this invocation.
3846
4196
  --json Format output as json.
3847
4197
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3848
4198
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3850,6 +4200,8 @@ GLOBAL FLAGS
3850
4200
  stderr only.
3851
4201
  --log-level=<option> [default: info] Specify level for logging.
3852
4202
  <options: debug|warn|error|info|trace>
4203
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4204
+ unaffected.
3853
4205
 
3854
4206
  DESCRIPTION
3855
4207
  List tables configured for a specific code search group.
@@ -3872,7 +4224,7 @@ EXAMPLES
3872
4224
  $ nex search tables --search-group "Business Rules" --json --auth dev-instance
3873
4225
  ```
3874
4226
 
3875
- _See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/search/tables.ts)_
4227
+ _See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/search/tables.ts)_
3876
4228
 
3877
4229
  ## `nex store install`
3878
4230
 
@@ -3880,8 +4232,9 @@ Install an application from the ServiceNow Store.
3880
4232
 
3881
4233
  ```
3882
4234
  USAGE
3883
- $ nex store install -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
3884
- [--log-level debug|warn|error|info|trace] [--demo-data] [--no-wait] [--poll-interval <value>] [--timeout <value>]
4235
+ $ nex store install -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4236
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--demo-data] [--no-wait]
4237
+ [--poll-interval <value>] [--timeout <value>]
3885
4238
 
3886
4239
  FLAGS
3887
4240
  -a, --app-id=<value> (required) Store application sys_id
@@ -3895,6 +4248,8 @@ FLAGS
3895
4248
  GLOBAL FLAGS
3896
4249
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3897
4250
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4251
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4252
+ --deny-write Refuse any change to instance data for this invocation.
3898
4253
  --json Format output as json.
3899
4254
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3900
4255
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3902,6 +4257,8 @@ GLOBAL FLAGS
3902
4257
  stderr only.
3903
4258
  --log-level=<option> [default: info] Specify level for logging.
3904
4259
  <options: debug|warn|error|info|trace>
4260
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4261
+ unaffected.
3905
4262
 
3906
4263
  DESCRIPTION
3907
4264
  Install an application from the ServiceNow Store.
@@ -3920,7 +4277,7 @@ EXAMPLES
3920
4277
  $ nex store install -a abc123 -v 1.0.0 --demo-data --auth dev
3921
4278
  ```
3922
4279
 
3923
- _See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/store/install.ts)_
4280
+ _See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/store/install.ts)_
3924
4281
 
3925
4282
  ## `nex store search`
3926
4283
 
@@ -3928,8 +4285,9 @@ Search for applications in the ServiceNow Store.
3928
4285
 
3929
4286
  ```
3930
4287
  USAGE
3931
- $ nex store search [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
3932
- debug|warn|error|info|trace] [--limit <value>] [--tab available_for_you|installed|updates] [-t <value>]
4288
+ $ nex store search [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4289
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--limit <value>] [--tab
4290
+ available_for_you|installed|updates] [-t <value>]
3933
4291
 
3934
4292
  FLAGS
3935
4293
  -a, --auth=<value> Auth alias to use.
@@ -3941,6 +4299,8 @@ FLAGS
3941
4299
  GLOBAL FLAGS
3942
4300
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3943
4301
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4302
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4303
+ --deny-write Refuse any change to instance data for this invocation.
3944
4304
  --json Format output as json.
3945
4305
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3946
4306
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3948,6 +4308,8 @@ GLOBAL FLAGS
3948
4308
  stderr only.
3949
4309
  --log-level=<option> [default: info] Specify level for logging.
3950
4310
  <options: debug|warn|error|info|trace>
4311
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4312
+ unaffected.
3951
4313
 
3952
4314
  DESCRIPTION
3953
4315
  Search for applications in the ServiceNow Store.
@@ -3966,7 +4328,7 @@ EXAMPLES
3966
4328
  $ nex store search --tab updates --limit 10 --auth dev
3967
4329
  ```
3968
4330
 
3969
- _See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/store/search.ts)_
4331
+ _See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/store/search.ts)_
3970
4332
 
3971
4333
  ## `nex store update`
3972
4334
 
@@ -3974,8 +4336,9 @@ Update a ServiceNow Store application to a new version.
3974
4336
 
3975
4337
  ```
3976
4338
  USAGE
3977
- $ nex store update -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
3978
- [--log-level debug|warn|error|info|trace] [--no-wait] [--poll-interval <value>] [--timeout <value>]
4339
+ $ nex store update -a <value> -v <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4340
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--no-wait]
4341
+ [--poll-interval <value>] [--timeout <value>]
3979
4342
 
3980
4343
  FLAGS
3981
4344
  -a, --app-id=<value> (required) Store application sys_id
@@ -3988,6 +4351,8 @@ FLAGS
3988
4351
  GLOBAL FLAGS
3989
4352
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
3990
4353
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4354
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4355
+ --deny-write Refuse any change to instance data for this invocation.
3991
4356
  --json Format output as json.
3992
4357
  --log-dir=<value> Directory to write log files to. Implies --log-file.
3993
4358
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -3995,6 +4360,8 @@ GLOBAL FLAGS
3995
4360
  stderr only.
3996
4361
  --log-level=<option> [default: info] Specify level for logging.
3997
4362
  <options: debug|warn|error|info|trace>
4363
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4364
+ unaffected.
3998
4365
 
3999
4366
  DESCRIPTION
4000
4367
  Update a ServiceNow Store application to a new version.
@@ -4013,7 +4380,7 @@ EXAMPLES
4013
4380
  $ nex store update -a abc123 -v 2.0.0 --timeout 3600000 --auth dev
4014
4381
  ```
4015
4382
 
4016
- _See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/store/update.ts)_
4383
+ _See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/store/update.ts)_
4017
4384
 
4018
4385
  ## `nex store validate`
4019
4386
 
@@ -4021,8 +4388,8 @@ Validate a batch installation definition file.
4021
4388
 
4022
4389
  ```
4023
4390
  USAGE
4024
- $ nex store validate -f <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
4025
- debug|warn|error|info|trace]
4391
+ $ nex store validate -f <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4392
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4026
4393
 
4027
4394
  FLAGS
4028
4395
  -a, --auth=<value> Auth alias to use.
@@ -4031,6 +4398,8 @@ FLAGS
4031
4398
  GLOBAL FLAGS
4032
4399
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4033
4400
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4401
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4402
+ --deny-write Refuse any change to instance data for this invocation.
4034
4403
  --json Format output as json.
4035
4404
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4036
4405
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4038,6 +4407,8 @@ GLOBAL FLAGS
4038
4407
  stderr only.
4039
4408
  --log-level=<option> [default: info] Specify level for logging.
4040
4409
  <options: debug|warn|error|info|trace>
4410
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4411
+ unaffected.
4041
4412
 
4042
4413
  DESCRIPTION
4043
4414
  Validate a batch installation definition file.
@@ -4048,7 +4419,7 @@ EXAMPLES
4048
4419
  $ nex store validate --file ./batch-definition.json --auth dev
4049
4420
  ```
4050
4421
 
4051
- _See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/store/validate.ts)_
4422
+ _See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/store/validate.ts)_
4052
4423
 
4053
4424
  ## `nex task approve`
4054
4425
 
@@ -4056,8 +4427,8 @@ Approve a ServiceNow change request.
4056
4427
 
4057
4428
  ```
4058
4429
  USAGE
4059
- $ nex task approve -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
4060
- debug|warn|error|info|trace] [-c <value>]
4430
+ $ nex task approve -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4431
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-c <value>]
4061
4432
 
4062
4433
  FLAGS
4063
4434
  -a, --auth=<value> Auth alias to use.
@@ -4067,6 +4438,8 @@ FLAGS
4067
4438
  GLOBAL FLAGS
4068
4439
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4069
4440
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4441
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4442
+ --deny-write Refuse any change to instance data for this invocation.
4070
4443
  --json Format output as json.
4071
4444
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4072
4445
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4074,6 +4447,8 @@ GLOBAL FLAGS
4074
4447
  stderr only.
4075
4448
  --log-level=<option> [default: info] Specify level for logging.
4076
4449
  <options: debug|warn|error|info|trace>
4450
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4451
+ unaffected.
4077
4452
 
4078
4453
  DESCRIPTION
4079
4454
  Approve a ServiceNow change request.
@@ -4095,7 +4470,7 @@ EXAMPLES
4095
4470
  $ nex task approve -n CHG0010001 -c "Looks good, approved" --auth dev
4096
4471
  ```
4097
4472
 
4098
- _See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/approve.ts)_
4473
+ _See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/task/approve.ts)_
4099
4474
 
4100
4475
  ## `nex task assign`
4101
4476
 
@@ -4103,8 +4478,9 @@ Assign a ServiceNow task to a user or group.
4103
4478
 
4104
4479
  ```
4105
4480
  USAGE
4106
- $ nex task assign -n <value> -u <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
4107
- [--log-level debug|warn|error|info|trace] [-g <value>] [--table <value>]
4481
+ $ nex task assign -n <value> -u <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4482
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-g <value>] [--table
4483
+ <value>]
4108
4484
 
4109
4485
  FLAGS
4110
4486
  -a, --auth=<value> Auth alias to use.
@@ -4116,6 +4492,8 @@ FLAGS
4116
4492
  GLOBAL FLAGS
4117
4493
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4118
4494
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4495
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4496
+ --deny-write Refuse any change to instance data for this invocation.
4119
4497
  --json Format output as json.
4120
4498
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4121
4499
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4123,6 +4501,8 @@ GLOBAL FLAGS
4123
4501
  stderr only.
4124
4502
  --log-level=<option> [default: info] Specify level for logging.
4125
4503
  <options: debug|warn|error|info|trace>
4504
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4505
+ unaffected.
4126
4506
 
4127
4507
  DESCRIPTION
4128
4508
  Assign a ServiceNow task to a user or group.
@@ -4151,7 +4531,7 @@ EXAMPLES
4151
4531
  $ nex task assign --number CHG0010001 --table change_request --user admin --auth dev
4152
4532
  ```
4153
4533
 
4154
- _See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/assign.ts)_
4534
+ _See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/task/assign.ts)_
4155
4535
 
4156
4536
  ## `nex task close`
4157
4537
 
@@ -4159,8 +4539,9 @@ Close a ServiceNow incident.
4159
4539
 
4160
4540
  ```
4161
4541
  USAGE
4162
- $ nex task close --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>]
4163
- [--log-file] [--log-level debug|warn|error|info|trace] [--close-code <value>]
4542
+ $ nex task close --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute]
4543
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4544
+ [--close-code <value>]
4164
4545
 
4165
4546
  FLAGS
4166
4547
  -a, --auth=<value> Auth alias to use.
@@ -4171,6 +4552,8 @@ FLAGS
4171
4552
  GLOBAL FLAGS
4172
4553
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4173
4554
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4555
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4556
+ --deny-write Refuse any change to instance data for this invocation.
4174
4557
  --json Format output as json.
4175
4558
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4176
4559
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4178,6 +4561,8 @@ GLOBAL FLAGS
4178
4561
  stderr only.
4179
4562
  --log-level=<option> [default: info] Specify level for logging.
4180
4563
  <options: debug|warn|error|info|trace>
4564
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4565
+ unaffected.
4181
4566
 
4182
4567
  DESCRIPTION
4183
4568
  Close a ServiceNow incident.
@@ -4200,7 +4585,7 @@ EXAMPLES
4200
4585
  $ nex task close -n INC0010001 --notes "Closed" --close-code "Solved (Permanently)" --auth dev
4201
4586
  ```
4202
4587
 
4203
- _See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/close.ts)_
4588
+ _See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/task/close.ts)_
4204
4589
 
4205
4590
  ## `nex task comment`
4206
4591
 
@@ -4208,8 +4593,9 @@ Add a comment or work note to a ServiceNow task.
4208
4593
 
4209
4594
  ```
4210
4595
  USAGE
4211
- $ nex task comment -c <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
4212
- [--log-level debug|warn|error|info|trace] [--table <value>] [--work-note]
4596
+ $ nex task comment -c <value> -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4597
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--table <value>]
4598
+ [--work-note]
4213
4599
 
4214
4600
  FLAGS
4215
4601
  -a, --auth=<value> Auth alias to use.
@@ -4221,6 +4607,8 @@ FLAGS
4221
4607
  GLOBAL FLAGS
4222
4608
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4223
4609
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4610
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4611
+ --deny-write Refuse any change to instance data for this invocation.
4224
4612
  --json Format output as json.
4225
4613
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4226
4614
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4228,6 +4616,8 @@ GLOBAL FLAGS
4228
4616
  stderr only.
4229
4617
  --log-level=<option> [default: info] Specify level for logging.
4230
4618
  <options: debug|warn|error|info|trace>
4619
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4620
+ unaffected.
4231
4621
 
4232
4622
  DESCRIPTION
4233
4623
  Add a comment or work note to a ServiceNow task.
@@ -4255,7 +4645,7 @@ EXAMPLES
4255
4645
  $ nex task comment --number CHG0010001 --table change_request --comment "Approved" --auth dev
4256
4646
  ```
4257
4647
 
4258
- _See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/comment.ts)_
4648
+ _See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/task/comment.ts)_
4259
4649
 
4260
4650
  ## `nex task find`
4261
4651
 
@@ -4263,8 +4653,8 @@ Find a ServiceNow task by its number.
4263
4653
 
4264
4654
  ```
4265
4655
  USAGE
4266
- $ nex task find -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
4267
- debug|warn|error|info|trace] [--table <value>]
4656
+ $ nex task find -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4657
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--table <value>]
4268
4658
 
4269
4659
  FLAGS
4270
4660
  -a, --auth=<value> Auth alias to use.
@@ -4274,6 +4664,8 @@ FLAGS
4274
4664
  GLOBAL FLAGS
4275
4665
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4276
4666
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4667
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4668
+ --deny-write Refuse any change to instance data for this invocation.
4277
4669
  --json Format output as json.
4278
4670
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4279
4671
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4281,6 +4673,8 @@ GLOBAL FLAGS
4281
4673
  stderr only.
4282
4674
  --log-level=<option> [default: info] Specify level for logging.
4283
4675
  <options: debug|warn|error|info|trace>
4676
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4677
+ unaffected.
4284
4678
 
4285
4679
  DESCRIPTION
4286
4680
  Find a ServiceNow task by its number.
@@ -4307,7 +4701,7 @@ EXAMPLES
4307
4701
  $ nex task find -n INC0010001 --json --auth dev
4308
4702
  ```
4309
4703
 
4310
- _See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/find.ts)_
4704
+ _See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/task/find.ts)_
4311
4705
 
4312
4706
  ## `nex task resolve`
4313
4707
 
@@ -4315,8 +4709,9 @@ Resolve a ServiceNow incident with resolution notes.
4315
4709
 
4316
4710
  ```
4317
4711
  USAGE
4318
- $ nex task resolve --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>]
4319
- [--log-file] [--log-level debug|warn|error|info|trace] [--close-code <value>]
4712
+ $ nex task resolve --notes <value> -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute]
4713
+ [--deny-write] [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4714
+ [--close-code <value>]
4320
4715
 
4321
4716
  FLAGS
4322
4717
  -a, --auth=<value> Auth alias to use.
@@ -4327,6 +4722,8 @@ FLAGS
4327
4722
  GLOBAL FLAGS
4328
4723
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4329
4724
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4725
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4726
+ --deny-write Refuse any change to instance data for this invocation.
4330
4727
  --json Format output as json.
4331
4728
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4332
4729
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4334,6 +4731,8 @@ GLOBAL FLAGS
4334
4731
  stderr only.
4335
4732
  --log-level=<option> [default: info] Specify level for logging.
4336
4733
  <options: debug|warn|error|info|trace>
4734
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4735
+ unaffected.
4337
4736
 
4338
4737
  DESCRIPTION
4339
4738
  Resolve a ServiceNow incident with resolution notes.
@@ -4356,7 +4755,7 @@ EXAMPLES
4356
4755
  $ nex task resolve -n INC0010001 --notes "Fixed" --close-code "Solved (Permanently)" --auth dev
4357
4756
  ```
4358
4757
 
4359
- _See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/task/resolve.ts)_
4758
+ _See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/task/resolve.ts)_
4360
4759
 
4361
4760
  ## `nex update-set`
4362
4761
 
@@ -4364,8 +4763,8 @@ List update sets on a ServiceNow instance.
4364
4763
 
4365
4764
  ```
4366
4765
  USAGE
4367
- $ nex update-set [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
4368
- debug|warn|error|info|trace] [--limit <value>] [-q <value>]
4766
+ $ nex update-set [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4767
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--limit <value>] [-q <value>]
4369
4768
 
4370
4769
  FLAGS
4371
4770
  -a, --auth=<value> Auth alias to use.
@@ -4375,6 +4774,8 @@ FLAGS
4375
4774
  GLOBAL FLAGS
4376
4775
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4377
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.
4378
4779
  --json Format output as json.
4379
4780
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4380
4781
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4382,6 +4783,8 @@ GLOBAL FLAGS
4382
4783
  stderr only.
4383
4784
  --log-level=<option> [default: info] Specify level for logging.
4384
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.
4385
4788
 
4386
4789
  DESCRIPTION
4387
4790
  List update sets on a ServiceNow instance.
@@ -4400,7 +4803,7 @@ EXAMPLES
4400
4803
  $ nex update-set --json --auth dev-instance
4401
4804
  ```
4402
4805
 
4403
- _See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/index.ts)_
4806
+ _See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/update-set/index.ts)_
4404
4807
 
4405
4808
  ## `nex update-set clone`
4406
4809
 
@@ -4408,8 +4811,8 @@ Clone an update set and its records.
4408
4811
 
4409
4812
  ```
4410
4813
  USAGE
4411
- $ nex update-set clone -n <value> -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
4412
- [--log-level debug|warn|error|info|trace]
4814
+ $ nex update-set clone -n <value> -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
4815
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4413
4816
 
4414
4817
  FLAGS
4415
4818
  -a, --auth=<value> Auth alias to use.
@@ -4419,6 +4822,8 @@ FLAGS
4419
4822
  GLOBAL FLAGS
4420
4823
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4421
4824
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4825
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4826
+ --deny-write Refuse any change to instance data for this invocation.
4422
4827
  --json Format output as json.
4423
4828
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4424
4829
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4426,6 +4831,8 @@ GLOBAL FLAGS
4426
4831
  stderr only.
4427
4832
  --log-level=<option> [default: info] Specify level for logging.
4428
4833
  <options: debug|warn|error|info|trace>
4834
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4835
+ unaffected.
4429
4836
 
4430
4837
  DESCRIPTION
4431
4838
  Clone an update set and its records.
@@ -4440,7 +4847,7 @@ EXAMPLES
4440
4847
  $ nex update-set clone --source us-001 --name "Cloned Set" --json --auth dev-instance
4441
4848
  ```
4442
4849
 
4443
- _See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/clone.ts)_
4850
+ _See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/update-set/clone.ts)_
4444
4851
 
4445
4852
  ## `nex update-set create`
4446
4853
 
@@ -4448,8 +4855,8 @@ Create a new update set.
4448
4855
 
4449
4856
  ```
4450
4857
  USAGE
4451
- $ nex update-set create -n <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
4452
- debug|warn|error|info|trace] [--application <value>] [-d <value>]
4858
+ $ nex update-set create -n <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4859
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--application <value>] [-d <value>]
4453
4860
 
4454
4861
  FLAGS
4455
4862
  -a, --auth=<value> Auth alias to use.
@@ -4460,6 +4867,8 @@ FLAGS
4460
4867
  GLOBAL FLAGS
4461
4868
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4462
4869
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4870
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4871
+ --deny-write Refuse any change to instance data for this invocation.
4463
4872
  --json Format output as json.
4464
4873
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4465
4874
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4467,6 +4876,8 @@ GLOBAL FLAGS
4467
4876
  stderr only.
4468
4877
  --log-level=<option> [default: info] Specify level for logging.
4469
4878
  <options: debug|warn|error|info|trace>
4879
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4880
+ unaffected.
4470
4881
 
4471
4882
  DESCRIPTION
4472
4883
  Create a new update set.
@@ -4485,7 +4896,7 @@ EXAMPLES
4485
4896
  $ nex update-set create --name "My Feature Set" --application x_my_app --auth dev-instance
4486
4897
  ```
4487
4898
 
4488
- _See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/create.ts)_
4899
+ _See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/update-set/create.ts)_
4489
4900
 
4490
4901
  ## `nex update-set current`
4491
4902
 
@@ -4493,8 +4904,8 @@ Get or set the current update set.
4493
4904
 
4494
4905
  ```
4495
4906
  USAGE
4496
- $ nex update-set current [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
4497
- debug|warn|error|info|trace] [-s <value>]
4907
+ $ nex update-set current [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4908
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-s <value>]
4498
4909
 
4499
4910
  FLAGS
4500
4911
  -a, --auth=<value> Auth alias to use.
@@ -4503,6 +4914,8 @@ FLAGS
4503
4914
  GLOBAL FLAGS
4504
4915
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4505
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.
4506
4919
  --json Format output as json.
4507
4920
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4508
4921
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4510,6 +4923,8 @@ GLOBAL FLAGS
4510
4923
  stderr only.
4511
4924
  --log-level=<option> [default: info] Specify level for logging.
4512
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.
4513
4928
 
4514
4929
  DESCRIPTION
4515
4930
  Get or set the current update set.
@@ -4528,7 +4943,7 @@ EXAMPLES
4528
4943
  $ nex update-set current --json --auth dev-instance
4529
4944
  ```
4530
4945
 
4531
- _See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/current.ts)_
4946
+ _See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/update-set/current.ts)_
4532
4947
 
4533
4948
  ## `nex update-set inspect`
4534
4949
 
@@ -4536,8 +4951,8 @@ Inspect the components of an update set.
4536
4951
 
4537
4952
  ```
4538
4953
  USAGE
4539
- $ nex update-set inspect -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
4540
- debug|warn|error|info|trace]
4954
+ $ nex update-set inspect -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]
4541
4956
 
4542
4957
  FLAGS
4543
4958
  -a, --auth=<value> Auth alias to use.
@@ -4546,6 +4961,8 @@ FLAGS
4546
4961
  GLOBAL FLAGS
4547
4962
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4548
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.
4549
4966
  --json Format output as json.
4550
4967
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4551
4968
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4553,6 +4970,8 @@ GLOBAL FLAGS
4553
4970
  stderr only.
4554
4971
  --log-level=<option> [default: info] Specify level for logging.
4555
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.
4556
4975
 
4557
4976
  DESCRIPTION
4558
4977
  Inspect the components of an update set.
@@ -4567,7 +4986,7 @@ EXAMPLES
4567
4986
  $ nex update-set inspect --sys-id us-001 --json --auth dev-instance
4568
4987
  ```
4569
4988
 
4570
- _See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/inspect.ts)_
4989
+ _See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/update-set/inspect.ts)_
4571
4990
 
4572
4991
  ## `nex update-set move`
4573
4992
 
@@ -4575,8 +4994,9 @@ Move records between update sets.
4575
4994
 
4576
4995
  ```
4577
4996
  USAGE
4578
- $ nex update-set move --target <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
4579
- [--log-level debug|warn|error|info|trace] [--records <value>] [--source <value>]
4997
+ $ nex update-set move --target <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] [--records <value>]
4999
+ [--source <value>]
4580
5000
 
4581
5001
  FLAGS
4582
5002
  -a, --auth=<value> Auth alias to use.
@@ -4587,6 +5007,8 @@ FLAGS
4587
5007
  GLOBAL FLAGS
4588
5008
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4589
5009
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
5010
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
5011
+ --deny-write Refuse any change to instance data for this invocation.
4590
5012
  --json Format output as json.
4591
5013
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4592
5014
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4594,6 +5016,8 @@ GLOBAL FLAGS
4594
5016
  stderr only.
4595
5017
  --log-level=<option> [default: info] Specify level for logging.
4596
5018
  <options: debug|warn|error|info|trace>
5019
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
5020
+ unaffected.
4597
5021
 
4598
5022
  DESCRIPTION
4599
5023
  Move records between update sets.
@@ -4612,7 +5036,7 @@ EXAMPLES
4612
5036
  $ nex update-set move --target us-002 --source us-001 --json --auth dev-instance
4613
5037
  ```
4614
5038
 
4615
- _See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/update-set/move.ts)_
5039
+ _See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/update-set/move.ts)_
4616
5040
 
4617
5041
  ## `nex workflow create`
4618
5042
 
@@ -4620,8 +5044,8 @@ Create a complete workflow from a JSON specification file.
4620
5044
 
4621
5045
  ```
4622
5046
  USAGE
4623
- $ nex workflow create -s <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file] [--log-level
4624
- debug|warn|error|info|trace]
5047
+ $ nex workflow create -s <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
5048
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4625
5049
 
4626
5050
  FLAGS
4627
5051
  -a, --auth=<value> Auth alias to use.
@@ -4630,6 +5054,8 @@ FLAGS
4630
5054
  GLOBAL FLAGS
4631
5055
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4632
5056
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
5057
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
5058
+ --deny-write Refuse any change to instance data for this invocation.
4633
5059
  --json Format output as json.
4634
5060
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4635
5061
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4637,6 +5063,8 @@ GLOBAL FLAGS
4637
5063
  stderr only.
4638
5064
  --log-level=<option> [default: info] Specify level for logging.
4639
5065
  <options: debug|warn|error|info|trace>
5066
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
5067
+ unaffected.
4640
5068
 
4641
5069
  DESCRIPTION
4642
5070
  Create a complete workflow from a JSON specification file.
@@ -4651,7 +5079,7 @@ EXAMPLES
4651
5079
  $ nex workflow create -s ./workflow.json --json --auth dev
4652
5080
  ```
4653
5081
 
4654
- _See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/workflow/create.ts)_
5082
+ _See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/workflow/create.ts)_
4655
5083
 
4656
5084
  ## `nex workflow publish`
4657
5085
 
@@ -4659,8 +5087,8 @@ Publish a workflow version.
4659
5087
 
4660
5088
  ```
4661
5089
  USAGE
4662
- $ nex workflow publish -s <value> -v <value> [--json] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
4663
- [--log-level debug|warn|error|info|trace]
5090
+ $ nex workflow publish -s <value> -v <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
5091
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4664
5092
 
4665
5093
  FLAGS
4666
5094
  -a, --auth=<value> Auth alias to use.
@@ -4670,6 +5098,8 @@ FLAGS
4670
5098
  GLOBAL FLAGS
4671
5099
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4672
5100
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
5101
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
5102
+ --deny-write Refuse any change to instance data for this invocation.
4673
5103
  --json Format output as json.
4674
5104
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4675
5105
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
@@ -4677,6 +5107,8 @@ GLOBAL FLAGS
4677
5107
  stderr only.
4678
5108
  --log-level=<option> [default: info] Specify level for logging.
4679
5109
  <options: debug|warn|error|info|trace>
5110
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
5111
+ unaffected.
4680
5112
 
4681
5113
  DESCRIPTION
4682
5114
  Publish a workflow version.
@@ -4691,7 +5123,7 @@ EXAMPLES
4691
5123
  $ nex workflow publish -v wfv-001 -s act-001 --json --auth dev
4692
5124
  ```
4693
5125
 
4694
- _See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/workflow/publish.ts)_
5126
+ _See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/workflow/publish.ts)_
4695
5127
 
4696
5128
  ## `nex xml export`
4697
5129
 
@@ -4699,8 +5131,8 @@ Export a single ServiceNow record as XML.
4699
5131
 
4700
5132
  ```
4701
5133
  USAGE
4702
- $ nex xml export -t <value> -s <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
4703
- [--log-level debug|warn|error|info|trace] [-o <value>]
5134
+ $ nex xml export -t <value> -s <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
5135
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-o <value>]
4704
5136
 
4705
5137
  FLAGS
4706
5138
  -a, --auth=<value> Auth alias to use.
@@ -4712,12 +5144,16 @@ FLAGS
4712
5144
  GLOBAL FLAGS
4713
5145
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4714
5146
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
5147
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
5148
+ --deny-write Refuse any change to instance data for this invocation.
4715
5149
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4716
5150
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4717
5151
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4718
5152
  stderr only.
4719
5153
  --log-level=<option> [default: info] Specify level for logging.
4720
5154
  <options: debug|warn|error|info|trace>
5155
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
5156
+ unaffected.
4721
5157
 
4722
5158
  DESCRIPTION
4723
5159
  Export a single ServiceNow record as XML.
@@ -4745,7 +5181,7 @@ EXAMPLES
4745
5181
  $ nex xml export --table sys_script --sys-id abc123 --json --auth dev
4746
5182
  ```
4747
5183
 
4748
- _See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/xml/export.ts)_
5184
+ _See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/xml/export.ts)_
4749
5185
 
4750
5186
  ## `nex xml import`
4751
5187
 
@@ -4753,8 +5189,8 @@ Import XML records into a ServiceNow instance.
4753
5189
 
4754
5190
  ```
4755
5191
  USAGE
4756
- $ nex xml import -f <value> -t <value> [-j] [-a <value>] [--cred-store] [--log-dir <value>] [--log-file]
4757
- [--log-level debug|warn|error|info|trace]
5192
+ $ nex xml import -f <value> -t <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
5193
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only]
4758
5194
 
4759
5195
  FLAGS
4760
5196
  -a, --auth=<value> Auth alias to use.
@@ -4765,12 +5201,16 @@ FLAGS
4765
5201
  GLOBAL FLAGS
4766
5202
  --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4767
5203
  sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
5204
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
5205
+ --deny-write Refuse any change to instance data for this invocation.
4768
5206
  --log-dir=<value> Directory to write log files to. Implies --log-file.
4769
5207
  --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4770
5208
  (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4771
5209
  stderr only.
4772
5210
  --log-level=<option> [default: info] Specify level for logging.
4773
5211
  <options: debug|warn|error|info|trace>
5212
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
5213
+ unaffected.
4774
5214
 
4775
5215
  DESCRIPTION
4776
5216
  Import XML records into a ServiceNow instance.
@@ -4793,7 +5233,7 @@ EXAMPLES
4793
5233
  $ nex xml import --file ./records.xml --table incident --json --auth dev
4794
5234
  ```
4795
5235
 
4796
- _See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.1.0/src/commands/xml/import.ts)_
5236
+ _See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.3.0/src/commands/xml/import.ts)_
4797
5237
  <!-- commandsstop -->
4798
5238
 
4799
5239
  ---