@sonisoft/now-sdk-ext-cli 5.3.0 → 5.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +293 -74
  2. package/dist/commands/behavior/details.d.ts +16 -0
  3. package/dist/commands/behavior/details.d.ts.map +1 -0
  4. package/dist/commands/behavior/details.js +31 -0
  5. package/dist/commands/behavior/details.js.map +1 -0
  6. package/dist/commands/behavior/index.d.ts +23 -0
  7. package/dist/commands/behavior/index.d.ts.map +1 -0
  8. package/dist/commands/behavior/index.js +41 -0
  9. package/dist/commands/behavior/index.js.map +1 -0
  10. package/dist/commands/flow/definition.d.ts +1 -1
  11. package/dist/commands/transaction/kill.d.ts +12 -0
  12. package/dist/commands/transaction/kill.d.ts.map +1 -0
  13. package/dist/commands/transaction/kill.js +48 -0
  14. package/dist/commands/transaction/kill.js.map +1 -0
  15. package/dist/commands/transaction/list.d.ts +20 -0
  16. package/dist/commands/transaction/list.d.ts.map +1 -0
  17. package/dist/commands/transaction/list.js +64 -0
  18. package/dist/commands/transaction/list.js.map +1 -0
  19. package/dist/common/authenticated-command.d.ts.map +1 -1
  20. package/dist/common/authenticated-command.js +21 -1
  21. package/dist/common/authenticated-command.js.map +1 -1
  22. package/dist/common/behavior-flags.d.ts +17 -0
  23. package/dist/common/behavior-flags.d.ts.map +1 -0
  24. package/dist/common/behavior-flags.js +14 -0
  25. package/dist/common/behavior-flags.js.map +1 -0
  26. package/dist/services/behavior-display.service.d.ts +6 -0
  27. package/dist/services/behavior-display.service.d.ts.map +1 -0
  28. package/dist/services/behavior-display.service.js +50 -0
  29. package/dist/services/behavior-display.service.js.map +1 -0
  30. package/dist/services/flow-display.service.d.ts +9 -9
  31. package/dist/services/flow-display.service.d.ts.map +1 -1
  32. package/dist/services/flow-display.service.js +117 -117
  33. package/dist/services/flow-display.service.js.map +1 -1
  34. package/dist/services/transaction-display.service.d.ts +5 -0
  35. package/dist/services/transaction-display.service.d.ts.map +1 -0
  36. package/dist/services/transaction-display.service.js +33 -0
  37. package/dist/services/transaction-display.service.js.map +1 -0
  38. package/oclif.manifest.json +2074 -1457
  39. package/package.json +9 -3
package/README.md CHANGED
@@ -68,6 +68,7 @@ Execute individual ATF tests or entire test suites with detailed results, perfec
68
68
  - **Batch Operations**: Install multiple applications from JSON definitions or batch create/update records
69
69
  - **Progress Monitoring**: Real-time progress for long-running operations
70
70
  - **Schema Discovery**: Inspect table schemas and field definitions
71
+ - **[Table Behavior](docs/table-behavior.md)**: Inspect automation, field requirements, and related artifact details
71
72
  - **Script Sync**: Pull and push scripts between local files and ServiceNow
72
73
  - **Task Management**: Comment, assign, resolve, and close incidents and changes
73
74
  - **Update Sets**: Create, inspect, clone, and manage update sets
@@ -95,6 +96,7 @@ Execute individual ATF tests or entire test suites with detailed results, perfec
95
96
  - [Query & Search](#query--search)
96
97
  - [Aggregate & Analytics](#aggregate--analytics)
97
98
  - [Instance Health Check](#instance-health-check)
99
+ - [Cluster Transactions](#cluster-transactions)
98
100
  - [Flow Designer](#flow-designer-operations)
99
101
  - [Bulk Operations](#bulk-record-operations)
100
102
  - [All Commands](#-commands)
@@ -474,6 +476,23 @@ nex health check --json --auth dev
474
476
  - Operational counts (open incidents, changes, problems)
475
477
  - Color-coded status indicators
476
478
 
479
+ ### Cluster Transactions
480
+
481
+ Discover active transactions from all responding ServiceNow cluster nodes, then submit a request for one exact transaction when necessary.
482
+
483
+ ```bash
484
+ # List active transactions
485
+ nex transaction list --auth dev
486
+
487
+ # Return complete, untruncated records as JSON
488
+ nex transaction list --json --auth dev
489
+
490
+ # Submit a kill request for one deliberately selected transaction
491
+ nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --auth dev
492
+ ```
493
+
494
+ > **Warning:** A kill request aborts real work. Only pass an identifier you deliberately selected from a current `nex transaction list` result. Platform acceptance does not mean the transaction has cleared immediately; run a separate later list to confirm.
495
+
477
496
  ### Flow Designer Operations
478
497
 
479
498
  Execute and manage Flow Designer flows, subflows, and actions from the CLI.
@@ -597,6 +616,9 @@ nex bulk update --table incident --query "state=7" --data '{"active":"false"}' -
597
616
  * [Check only version and stuck jobs](#check-only-version-and-stuck-jobs)
598
617
  * [Health check with custom stuck job threshold (60 minutes)](#health-check-with-custom-stuck-job-threshold-60-minutes)
599
618
  * [JSON output for monitoring/alerting](#json-output-for-monitoringalerting)
619
+ * [List active transactions](#list-active-transactions)
620
+ * [Return complete, untruncated records as JSON](#return-complete-untruncated-records-as-json)
621
+ * [Submit a kill request for one deliberately selected transaction](#submit-a-kill-request-for-one-deliberately-selected-transaction)
600
622
  * [Execute a flow in foreground (waits for completion)](#execute-a-flow-in-foreground-waits-for-completion)
601
623
  * [Execute with inputs](#execute-with-inputs)
602
624
  * [Execute a subflow](#execute-a-subflow)
@@ -708,7 +730,7 @@ $ npm install -g @sonisoft/now-sdk-ext-cli
708
730
  $ nex COMMAND
709
731
  running command...
710
732
  $ nex (--version)
711
- @sonisoft/now-sdk-ext-cli/5.3.0 linux-x64 node-v26.5.0
733
+ @sonisoft/now-sdk-ext-cli/5.5.0 linux-x64 node-v26.5.0
712
734
  $ nex --help [COMMAND]
713
735
  USAGE
714
736
  $ nex COMMAND
@@ -762,6 +784,8 @@ rather than silently denying nothing.
762
784
  * [`nex autocomplete [SHELL]`](#nex-autocomplete-shell)
763
785
  * [`nex batch create`](#nex-batch-create)
764
786
  * [`nex batch update`](#nex-batch-update)
787
+ * [`nex behavior`](#nex-behavior)
788
+ * [`nex behavior details`](#nex-behavior-details)
765
789
  * [`nex bulk delete`](#nex-bulk-delete)
766
790
  * [`nex bulk update`](#nex-bulk-update)
767
791
  * [`nex exec SCOPE [FILE]`](#nex-exec-scope-file)
@@ -818,6 +842,8 @@ rather than silently denying nothing.
818
842
  * [`nex task comment`](#nex-task-comment)
819
843
  * [`nex task find`](#nex-task-find)
820
844
  * [`nex task resolve`](#nex-task-resolve)
845
+ * [`nex transaction kill`](#nex-transaction-kill)
846
+ * [`nex transaction list`](#nex-transaction-list)
821
847
  * [`nex update-set`](#nex-update-set)
822
848
  * [`nex update-set clone`](#nex-update-set-clone)
823
849
  * [`nex update-set create`](#nex-update-set-create)
@@ -882,7 +908,7 @@ EXAMPLES
882
908
  $ nex aggregate count --table incident --query "active=true" --json --auth dev
883
909
  ```
884
910
 
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)_
911
+ _See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/aggregate/count.ts)_
886
912
 
887
913
  ## `nex aggregate group`
888
914
 
@@ -950,7 +976,7 @@ EXAMPLES
950
976
  $ nex aggregate group --table incident --group-by priority --count --having "count>10" --auth dev
951
977
  ```
952
978
 
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)_
979
+ _See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/aggregate/group.ts)_
954
980
 
955
981
  ## `nex aggregate query`
956
982
 
@@ -1013,7 +1039,7 @@ EXAMPLES
1013
1039
  $ nex aggregate query --table incident --sum reassignment_count --json --auth dev
1014
1040
  ```
1015
1041
 
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)_
1042
+ _See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/aggregate/query.ts)_
1017
1043
 
1018
1044
  ## `nex app`
1019
1045
 
@@ -1076,7 +1102,7 @@ EXAMPLES
1076
1102
  $ nex app -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
1077
1103
  ```
1078
1104
 
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)_
1105
+ _See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/app/index.ts)_
1080
1106
 
1081
1107
  ## `nex app install`
1082
1108
 
@@ -1144,7 +1170,7 @@ EXAMPLES
1144
1170
  $ nex app install -b -d ./apps.json -a dev-instance --log-level debug
1145
1171
  ```
1146
1172
 
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)_
1173
+ _See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/app/install.ts)_
1148
1174
 
1149
1175
  ## `nex app repo-install`
1150
1176
 
@@ -1229,7 +1255,7 @@ EXAMPLES
1229
1255
  $ nex app repo-install -s x_my_app -a dev-instance --log-level debug
1230
1256
  ```
1231
1257
 
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)_
1258
+ _See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/app/repo-install.ts)_
1233
1259
 
1234
1260
  ## `nex app repo-list`
1235
1261
 
@@ -1304,7 +1330,7 @@ EXAMPLES
1304
1330
  $ nex app repo-list -a dev-instance
1305
1331
  ```
1306
1332
 
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)_
1333
+ _See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/app/repo-list.ts)_
1308
1334
 
1309
1335
  ## `nex app uninstall`
1310
1336
 
@@ -1366,7 +1392,7 @@ EXAMPLES
1366
1392
  $ nex app uninstall -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
1367
1393
  ```
1368
1394
 
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)_
1395
+ _See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/app/uninstall.ts)_
1370
1396
 
1371
1397
  ## `nex atf`
1372
1398
 
@@ -1449,7 +1475,7 @@ EXAMPLES
1449
1475
  $ nex atf --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance
1450
1476
  ```
1451
1477
 
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)_
1478
+ _See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/atf/index.ts)_
1453
1479
 
1454
1480
  ## `nex attachment get`
1455
1481
 
@@ -1492,7 +1518,7 @@ EXAMPLES
1492
1518
  $ nex attachment get -s att123 --json --auth dev
1493
1519
  ```
1494
1520
 
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)_
1521
+ _See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/attachment/get.ts)_
1496
1522
 
1497
1523
  ## `nex attachment list`
1498
1524
 
@@ -1537,7 +1563,7 @@ EXAMPLES
1537
1563
  $ nex attachment list -t incident -r abc123 --limit 50 --json --auth dev
1538
1564
  ```
1539
1565
 
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)_
1566
+ _See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/attachment/list.ts)_
1541
1567
 
1542
1568
  ## `nex attachment upload`
1543
1569
 
@@ -1584,7 +1610,7 @@ EXAMPLES
1584
1610
  $ nex attachment upload -t incident -r abc123 -f ./data.csv --content-type text/csv --auth dev
1585
1611
  ```
1586
1612
 
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)_
1613
+ _See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/attachment/upload.ts)_
1588
1614
 
1589
1615
  ## `nex auth delete [ALIAS]`
1590
1616
 
@@ -1619,7 +1645,7 @@ EXAMPLES
1619
1645
  $ nex auth delete --all
1620
1646
  ```
1621
1647
 
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)_
1648
+ _See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/auth/delete.ts)_
1623
1649
 
1624
1650
  ## `nex auth doctor`
1625
1651
 
@@ -1647,7 +1673,7 @@ EXAMPLES
1647
1673
  $ nex auth doctor --json
1648
1674
  ```
1649
1675
 
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)_
1676
+ _See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/auth/doctor.ts)_
1651
1677
 
1652
1678
  ## `nex auth list`
1653
1679
 
@@ -1680,7 +1706,7 @@ EXAMPLES
1680
1706
  $ nex auth list --json
1681
1707
  ```
1682
1708
 
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)_
1709
+ _See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/auth/list.ts)_
1684
1710
 
1685
1711
  ## `nex auth use ALIAS`
1686
1712
 
@@ -1708,7 +1734,7 @@ EXAMPLES
1708
1734
  $ nex auth use dev206299
1709
1735
  ```
1710
1736
 
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)_
1737
+ _See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/auth/use.ts)_
1712
1738
 
1713
1739
  ## `nex autocomplete [SHELL]`
1714
1740
 
@@ -1783,7 +1809,7 @@ EXAMPLES
1783
1809
  $ nex batch create --file ./records.json --no-transaction --auth dev
1784
1810
  ```
1785
1811
 
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)_
1812
+ _See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/batch/create.ts)_
1787
1813
 
1788
1814
  ## `nex batch update`
1789
1815
 
@@ -1827,7 +1853,110 @@ EXAMPLES
1827
1853
  $ nex batch update --file ./updates.json --stop-on-error --auth dev
1828
1854
  ```
1829
1855
 
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)_
1856
+ _See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/batch/update.ts)_
1857
+
1858
+ ## `nex behavior`
1859
+
1860
+ Discover table behavior: rules, UI actions/scripts, UI/data policies, workflows, flows and state models. Active and applicable inherited behavior is included by default. Conditions describe configuration, not a prediction of execution. Select categories and details to control output size.
1861
+
1862
+ ```
1863
+ USAGE
1864
+ $ nex behavior -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
1865
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--dependency-depth <value>]
1866
+ [--details scripts|definitions|dependencies...] [--max-bytes <value>] [--scope <value>] [--category
1867
+ business_rules|ui_actions|client_scripts|ui_policies|data_policies|workflows|flows|state_models...] [--cursor
1868
+ <value>] [--include-inactive] [--include-inherited] [--limit <value>] [--name <value>] [--sys-id <value>...]
1869
+
1870
+ FLAGS
1871
+ -a, --auth=<value> Auth alias to use.
1872
+ -t, --table=<value> (required) Target table name
1873
+ --category=<option>... Category to inspect; repeat to select several, default all
1874
+ <options: business_rules|ui_actions|client_scripts|ui_policies|data_policies|workflows
1875
+ |flows|state_models>
1876
+ --cursor=<value> Continuation token; requires exactly one --category and the same filters
1877
+ --dependency-depth=<value> Expand one dependency level; requires --details dependencies
1878
+ --details=<option>... Include selected detail now; repeat for multiple kinds
1879
+ <options: scripts|definitions|dependencies>
1880
+ --include-inactive Include inactive/published and draft candidates when discoverable
1881
+ --[no-]include-inherited Include applicable ancestor behavior
1882
+ --json Emit one JSON document
1883
+ --limit=<value> [default: 50] Maximum items per category
1884
+ --max-bytes=<value> [default: 65536] Maximum JSON response bytes; omissions include retrieval references
1885
+ --name=<value> Metadata name contains this text
1886
+ --scope=<value> Transaction scope for flow definition reads
1887
+ --sys-id=<value>... Metadata source sys_id to include; repeat for multiple records
1888
+
1889
+ GLOBAL FLAGS
1890
+ --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1891
+ sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1892
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1893
+ --deny-write Refuse any change to instance data for this invocation.
1894
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1895
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1896
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1897
+ stderr only.
1898
+ --log-level=<option> [default: info] Specify level for logging.
1899
+ <options: debug|warn|error|info|trace>
1900
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1901
+ unaffected.
1902
+
1903
+ DESCRIPTION
1904
+ Discover table behavior: rules, UI actions/scripts, UI/data policies, workflows, flows and state models. Active and
1905
+ applicable inherited behavior is included by default. Conditions describe configuration, not a prediction of
1906
+ execution. Select categories and details to control output size.
1907
+
1908
+ EXAMPLES
1909
+ $ nex behavior --table incident --auth dev --json
1910
+
1911
+ $ nex behavior --table change_request --category business_rules --details scripts --auth dev --json
1912
+ ```
1913
+
1914
+ _See code: [src/commands/behavior/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/behavior/index.ts)_
1915
+
1916
+ ## `nex behavior details`
1917
+
1918
+ Retrieve known behavior artifacts without rediscovery. Repeat --reference kind:source_table:sys_id for up to 50 records. Add --details scripts, --details definitions or --details dependencies to include bodies immediately. Source references are returned by behavior discovery; flows also accept flows:sys_hub_flow:<sys_id>.
1919
+
1920
+ ```
1921
+ USAGE
1922
+ $ nex behavior details --reference <value>... [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write]
1923
+ [--log-dir <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--dependency-depth
1924
+ <value>] [--details scripts|definitions|dependencies...] [--max-bytes <value>] [--scope <value>]
1925
+
1926
+ FLAGS
1927
+ -a, --auth=<value> Auth alias to use.
1928
+ --dependency-depth=<value> Expand one dependency level; requires --details dependencies
1929
+ --details=<option>... Include selected detail now; repeat for multiple kinds
1930
+ <options: scripts|definitions|dependencies>
1931
+ --json Emit one JSON document
1932
+ --max-bytes=<value> [default: 65536] Maximum JSON response bytes; omissions include retrieval references
1933
+ --reference=<value>... (required) kind:source_table:sys_id; repeat for a batch
1934
+ --scope=<value> Transaction scope for flow definition reads
1935
+
1936
+ GLOBAL FLAGS
1937
+ --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
1938
+ sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
1939
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
1940
+ --deny-write Refuse any change to instance data for this invocation.
1941
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
1942
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
1943
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
1944
+ stderr only.
1945
+ --log-level=<option> [default: info] Specify level for logging.
1946
+ <options: debug|warn|error|info|trace>
1947
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
1948
+ unaffected.
1949
+
1950
+ DESCRIPTION
1951
+ Retrieve known behavior artifacts without rediscovery. Repeat --reference kind:source_table:sys_id for up to 50
1952
+ records. Add --details scripts, --details definitions or --details dependencies to include bodies immediately. Source
1953
+ references are returned by behavior discovery; flows also accept flows:sys_hub_flow:<sys_id>.
1954
+
1955
+ EXAMPLES
1956
+ $ nex behavior details --reference business_rules:sys_script:0123456789abcdef0123456789abcdef --details scripts --auth dev --json
1957
+ ```
1958
+
1959
+ _See code: [src/commands/behavior/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/behavior/details.ts)_
1831
1960
 
1832
1961
  ## `nex bulk delete`
1833
1962
 
@@ -1891,7 +2020,7 @@ EXAMPLES
1891
2020
  $ nex bulk delete --table u_staging --query "processed=true" --confirm --json --auth dev
1892
2021
  ```
1893
2022
 
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)_
2023
+ _See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/bulk/delete.ts)_
1895
2024
 
1896
2025
  ## `nex bulk update`
1897
2026
 
@@ -1960,7 +2089,7 @@ EXAMPLES
1960
2089
  $ nex bulk update --table incident --query "active=true" --data '{"state":"6"}' --confirm --json --auth dev
1961
2090
  ```
1962
2091
 
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)_
2092
+ _See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/bulk/update.ts)_
1964
2093
 
1965
2094
  ## `nex exec SCOPE [FILE]`
1966
2095
 
@@ -2090,7 +2219,7 @@ EXAMPLES
2090
2219
  $ nex exec global ./script.js --auth dev-instance --params '{"token":"abc123","env":"dev"}'
2091
2220
  ```
2092
2221
 
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)_
2222
+ _See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/exec/index.ts)_
2094
2223
 
2095
2224
  ## `nex flow action`
2096
2225
 
@@ -2144,7 +2273,7 @@ EXAMPLES
2144
2273
  '{"table":"incident","values":{"short_description":"Test"}}' --auth dev
2145
2274
  ```
2146
2275
 
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)_
2276
+ _See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/action.ts)_
2148
2277
 
2149
2278
  ## `nex flow cancel`
2150
2279
 
@@ -2191,7 +2320,7 @@ EXAMPLES
2191
2320
  $ nex flow cancel --context-id abc123def456 --reason "No longer needed" --auth dev
2192
2321
  ```
2193
2322
 
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)_
2323
+ _See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/cancel.ts)_
2195
2324
 
2196
2325
  ## `nex flow copy`
2197
2326
 
@@ -2256,7 +2385,7 @@ EXAMPLES
2256
2385
  dev
2257
2386
  ```
2258
2387
 
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)_
2388
+ _See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/copy.ts)_
2260
2389
 
2261
2390
  ## `nex flow definition`
2262
2391
 
@@ -2329,7 +2458,7 @@ EXAMPLES
2329
2458
  $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps
2330
2459
  ```
2331
2460
 
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)_
2461
+ _See code: [src/commands/flow/definition.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/definition.ts)_
2333
2462
 
2334
2463
  ## `nex flow details`
2335
2464
 
@@ -2390,7 +2519,7 @@ EXAMPLES
2390
2519
  $ nex flow details -c d4e5f6789012345678abcdef01234567 --json --auth dev
2391
2520
  ```
2392
2521
 
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)_
2522
+ _See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/details.ts)_
2394
2523
 
2395
2524
  ## `nex flow error`
2396
2525
 
@@ -2432,7 +2561,7 @@ EXAMPLES
2432
2561
  $ nex flow error --context-id abc123def456 --auth dev
2433
2562
  ```
2434
2563
 
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)_
2564
+ _See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/error.ts)_
2436
2565
 
2437
2566
  ## `nex flow logs`
2438
2567
 
@@ -2490,7 +2619,7 @@ EXAMPLES
2490
2619
  $ nex flow logs -c d4e5f6789012345678abcdef01234567 --json --auth dev
2491
2620
  ```
2492
2621
 
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)_
2622
+ _See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/logs.ts)_
2494
2623
 
2495
2624
  ## `nex flow message`
2496
2625
 
@@ -2540,7 +2669,7 @@ EXAMPLES
2540
2669
  $ nex flow message --context-id abc123def456 --message "data_ready" --payload '{"status":"ok"}' --auth dev
2541
2670
  ```
2542
2671
 
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)_
2672
+ _See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/message.ts)_
2544
2673
 
2545
2674
  ## `nex flow outputs`
2546
2675
 
@@ -2586,7 +2715,7 @@ EXAMPLES
2586
2715
  $ nex flow outputs --context-id abc123def456 --json --auth dev
2587
2716
  ```
2588
2717
 
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)_
2718
+ _See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/outputs.ts)_
2590
2719
 
2591
2720
  ## `nex flow run`
2592
2721
 
@@ -2652,7 +2781,7 @@ EXAMPLES
2652
2781
  $ nex flow run --name global.my_flow --mode background --auth dev
2653
2782
  ```
2654
2783
 
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)_
2784
+ _See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/run.ts)_
2656
2785
 
2657
2786
  ## `nex flow status`
2658
2787
 
@@ -2696,7 +2825,7 @@ EXAMPLES
2696
2825
  $ nex flow status --context-id abc123def456 --auth dev
2697
2826
  ```
2698
2827
 
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)_
2828
+ _See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/status.ts)_
2700
2829
 
2701
2830
  ## `nex flow subflow`
2702
2831
 
@@ -2756,7 +2885,7 @@ EXAMPLES
2756
2885
  $ nex flow subflow --name x_myapp.process_record --inputs '{"table":"incident","sys_id":"abc123"}' --auth dev
2757
2886
  ```
2758
2887
 
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)_
2888
+ _See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/subflow.ts)_
2760
2889
 
2761
2890
  ## `nex flow test`
2762
2891
 
@@ -2819,7 +2948,7 @@ EXAMPLES
2819
2948
  $ nex flow test -f 887dda5583237210fdb8f7b6feaad32c -o '{"current":"abc123"}' --json --auth dev
2820
2949
  ```
2821
2950
 
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)_
2951
+ _See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/flow/test.ts)_
2823
2952
 
2824
2953
  ## `nex health check`
2825
2954
 
@@ -2889,7 +3018,7 @@ EXAMPLES
2889
3018
  $ nex health check --json --auth dev
2890
3019
  ```
2891
3020
 
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)_
3021
+ _See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/health/check.ts)_
2893
3022
 
2894
3023
  ## `nex help [COMMAND]`
2895
3024
 
@@ -3025,7 +3154,7 @@ EXAMPLES
3025
3154
  $ nex log --no-color --auth dev-instance
3026
3155
  ```
3027
3156
 
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)_
3157
+ _See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/log/index.ts)_
3029
3158
 
3030
3159
  ## `nex plugins`
3031
3160
 
@@ -3347,7 +3476,7 @@ EXAMPLES
3347
3476
  NEX_POLICY_DENY=all nex policy status
3348
3477
  ```
3349
3478
 
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)_
3479
+ _See code: [src/commands/policy/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/policy/status.ts)_
3351
3480
 
3352
3481
  ## `nex query`
3353
3482
 
@@ -3410,7 +3539,7 @@ EXAMPLES
3410
3539
  $ nex query --table sys_user --query "active=true" --limit 5 --json --auth dev
3411
3540
  ```
3412
3541
 
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)_
3542
+ _See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/query/index.ts)_
3414
3543
 
3415
3544
  ## `nex query app`
3416
3545
 
@@ -3463,7 +3592,7 @@ EXAMPLES
3463
3592
  $ nex query app --search "HR" --active --auth dev
3464
3593
  ```
3465
3594
 
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)_
3595
+ _See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/query/app.ts)_
3467
3596
 
3468
3597
  ## `nex query columns`
3469
3598
 
@@ -3518,7 +3647,7 @@ EXAMPLES
3518
3647
  $ nex query columns --table incident --json --auth dev
3519
3648
  ```
3520
3649
 
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)_
3650
+ _See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/query/columns.ts)_
3522
3651
 
3523
3652
  ## `nex query syslog`
3524
3653
 
@@ -3575,7 +3704,7 @@ EXAMPLES
3575
3704
  $ nex query syslog --query "sourceLIKEincident" --json --auth dev
3576
3705
  ```
3577
3706
 
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)_
3707
+ _See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/query/syslog.ts)_
3579
3708
 
3580
3709
  ## `nex schema`
3581
3710
 
@@ -3634,7 +3763,7 @@ EXAMPLES
3634
3763
  $ nex schema --table incident --include-choices --include-relationships --auth dev
3635
3764
  ```
3636
3765
 
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)_
3766
+ _See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/schema/index.ts)_
3638
3767
 
3639
3768
  ## `nex schema field`
3640
3769
 
@@ -3681,7 +3810,7 @@ EXAMPLES
3681
3810
  $ nex schema field --table incident --field priority --json --auth dev
3682
3811
  ```
3683
3812
 
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)_
3813
+ _See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/schema/field.ts)_
3685
3814
 
3686
3815
  ## `nex schema validate-catalog`
3687
3816
 
@@ -3727,7 +3856,7 @@ EXAMPLES
3727
3856
  $ nex schema validate-catalog --sys-id a1b2c3d4e5f6 --json --auth dev
3728
3857
  ```
3729
3858
 
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)_
3859
+ _See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/schema/validate-catalog.ts)_
3731
3860
 
3732
3861
  ## `nex scope`
3733
3862
 
@@ -3774,7 +3903,7 @@ EXAMPLES
3774
3903
  $ nex scope -l --json --auth dev
3775
3904
  ```
3776
3905
 
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)_
3906
+ _See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/scope/index.ts)_
3778
3907
 
3779
3908
  ## `nex scope set`
3780
3909
 
@@ -3817,7 +3946,7 @@ EXAMPLES
3817
3946
  $ nex scope set -a abc123def456ghi789jkl012mno345pq --json --auth dev
3818
3947
  ```
3819
3948
 
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)_
3949
+ _See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/scope/set.ts)_
3821
3950
 
3822
3951
  ## `nex script-sync pull`
3823
3952
 
@@ -3877,7 +4006,7 @@ EXAMPLES
3877
4006
  $ nex script-sync pull -n MyClientScript -t sys_script_client --json --auth dev-instance
3878
4007
  ```
3879
4008
 
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)_
4009
+ _See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/script-sync/pull.ts)_
3881
4010
 
3882
4011
  ## `nex script-sync push`
3883
4012
 
@@ -3938,7 +4067,7 @@ EXAMPLES
3938
4067
  $ nex script-sync push -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --auth dev-instance
3939
4068
  ```
3940
4069
 
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)_
4070
+ _See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/script-sync/push.ts)_
3942
4071
 
3943
4072
  ## `nex script-sync sync`
3944
4073
 
@@ -3997,7 +4126,7 @@ EXAMPLES
3997
4126
  $ nex script-sync sync -d ./scripts --json --auth dev-instance
3998
4127
  ```
3999
4128
 
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)_
4129
+ _See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/script-sync/sync.ts)_
4001
4130
 
4002
4131
  ## `nex search`
4003
4132
 
@@ -4064,7 +4193,7 @@ EXAMPLES
4064
4193
  $ nex search --term "GlideRecord" --limit 10 --json --auth dev-instance
4065
4194
  ```
4066
4195
 
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)_
4196
+ _See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/search/index.ts)_
4068
4197
 
4069
4198
  ## `nex search add-table`
4070
4199
 
@@ -4124,7 +4253,7 @@ EXAMPLES
4124
4253
  dev-instance
4125
4254
  ```
4126
4255
 
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)_
4256
+ _See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/search/add-table.ts)_
4128
4257
 
4129
4258
  ## `nex search groups`
4130
4259
 
@@ -4173,7 +4302,7 @@ EXAMPLES
4173
4302
  $ nex search groups --json --auth dev-instance
4174
4303
  ```
4175
4304
 
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)_
4305
+ _See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/search/groups.ts)_
4177
4306
 
4178
4307
  ## `nex search tables`
4179
4308
 
@@ -4224,7 +4353,7 @@ EXAMPLES
4224
4353
  $ nex search tables --search-group "Business Rules" --json --auth dev-instance
4225
4354
  ```
4226
4355
 
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)_
4356
+ _See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/search/tables.ts)_
4228
4357
 
4229
4358
  ## `nex store install`
4230
4359
 
@@ -4277,7 +4406,7 @@ EXAMPLES
4277
4406
  $ nex store install -a abc123 -v 1.0.0 --demo-data --auth dev
4278
4407
  ```
4279
4408
 
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)_
4409
+ _See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/store/install.ts)_
4281
4410
 
4282
4411
  ## `nex store search`
4283
4412
 
@@ -4328,7 +4457,7 @@ EXAMPLES
4328
4457
  $ nex store search --tab updates --limit 10 --auth dev
4329
4458
  ```
4330
4459
 
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)_
4460
+ _See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/store/search.ts)_
4332
4461
 
4333
4462
  ## `nex store update`
4334
4463
 
@@ -4380,7 +4509,7 @@ EXAMPLES
4380
4509
  $ nex store update -a abc123 -v 2.0.0 --timeout 3600000 --auth dev
4381
4510
  ```
4382
4511
 
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)_
4512
+ _See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/store/update.ts)_
4384
4513
 
4385
4514
  ## `nex store validate`
4386
4515
 
@@ -4419,7 +4548,7 @@ EXAMPLES
4419
4548
  $ nex store validate --file ./batch-definition.json --auth dev
4420
4549
  ```
4421
4550
 
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)_
4551
+ _See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/store/validate.ts)_
4423
4552
 
4424
4553
  ## `nex task approve`
4425
4554
 
@@ -4470,7 +4599,7 @@ EXAMPLES
4470
4599
  $ nex task approve -n CHG0010001 -c "Looks good, approved" --auth dev
4471
4600
  ```
4472
4601
 
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)_
4602
+ _See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/task/approve.ts)_
4474
4603
 
4475
4604
  ## `nex task assign`
4476
4605
 
@@ -4531,7 +4660,7 @@ EXAMPLES
4531
4660
  $ nex task assign --number CHG0010001 --table change_request --user admin --auth dev
4532
4661
  ```
4533
4662
 
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)_
4663
+ _See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/task/assign.ts)_
4535
4664
 
4536
4665
  ## `nex task close`
4537
4666
 
@@ -4585,7 +4714,7 @@ EXAMPLES
4585
4714
  $ nex task close -n INC0010001 --notes "Closed" --close-code "Solved (Permanently)" --auth dev
4586
4715
  ```
4587
4716
 
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)_
4717
+ _See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/task/close.ts)_
4589
4718
 
4590
4719
  ## `nex task comment`
4591
4720
 
@@ -4645,7 +4774,7 @@ EXAMPLES
4645
4774
  $ nex task comment --number CHG0010001 --table change_request --comment "Approved" --auth dev
4646
4775
  ```
4647
4776
 
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)_
4777
+ _See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/task/comment.ts)_
4649
4778
 
4650
4779
  ## `nex task find`
4651
4780
 
@@ -4701,7 +4830,7 @@ EXAMPLES
4701
4830
  $ nex task find -n INC0010001 --json --auth dev
4702
4831
  ```
4703
4832
 
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)_
4833
+ _See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/task/find.ts)_
4705
4834
 
4706
4835
  ## `nex task resolve`
4707
4836
 
@@ -4755,7 +4884,97 @@ EXAMPLES
4755
4884
  $ nex task resolve -n INC0010001 --notes "Fixed" --close-code "Solved (Permanently)" --auth dev
4756
4885
  ```
4757
4886
 
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)_
4887
+ _See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/task/resolve.ts)_
4888
+
4889
+ ## `nex transaction kill`
4890
+
4891
+ Submit a request to terminate one active transaction. Platform acceptance does not mean immediate removal.
4892
+
4893
+ ```
4894
+ USAGE
4895
+ $ nex transaction kill -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4896
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--confirm]
4897
+
4898
+ FLAGS
4899
+ -a, --auth=<value> Auth alias to use.
4900
+ -t, --transaction-id=<value> (required) Exact 32-character hexadecimal sys_id from `nex transaction list`.
4901
+ --confirm Confirm submission of the kill request.
4902
+
4903
+ GLOBAL FLAGS
4904
+ --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4905
+ sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4906
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4907
+ --deny-write Refuse any change to instance data for this invocation.
4908
+ --json Format output as json.
4909
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4910
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4911
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4912
+ stderr only.
4913
+ --log-level=<option> [default: info] Specify level for logging.
4914
+ <options: debug|warn|error|info|trace>
4915
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4916
+ unaffected.
4917
+
4918
+ DESCRIPTION
4919
+ Submit a request to terminate one active transaction. Platform acceptance does not mean immediate removal.
4920
+
4921
+ Only pass an identifier you deliberately selected from `nex transaction list`. Killing another user's transaction
4922
+ aborts their work.
4923
+
4924
+ EXAMPLES
4925
+ $ nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --auth dev
4926
+
4927
+ $ nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --json --auth dev
4928
+ ```
4929
+
4930
+ _See code: [src/commands/transaction/kill.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/transaction/kill.ts)_
4931
+
4932
+ ## `nex transaction list`
4933
+
4934
+ List active transactions from all responding ServiceNow cluster nodes.
4935
+
4936
+ ```
4937
+ USAGE
4938
+ $ nex transaction list [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4939
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l <value>] [--poll-interval-ms <value>] [-q
4940
+ <value>] [--timeout-ms <value>]
4941
+
4942
+ FLAGS
4943
+ -a, --auth=<value> Auth alias to use.
4944
+ -l, --limit=<value> Maximum transactions to return. Core default: 1000.
4945
+ -q, --query=<value> Encoded query used to filter transactions. Core default: none.
4946
+ --poll-interval-ms=<value> Interval between collection status polls. Core default: 1000.
4947
+ --timeout-ms=<value> Collection timeout in milliseconds. Core default: 60000.
4948
+
4949
+ GLOBAL FLAGS
4950
+ --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4951
+ sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4952
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4953
+ --deny-write Refuse any change to instance data for this invocation.
4954
+ --json Format output as json.
4955
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4956
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4957
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4958
+ stderr only.
4959
+ --log-level=<option> [default: info] Specify level for logging.
4960
+ <options: debug|warn|error|info|trace>
4961
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4962
+ unaffected.
4963
+
4964
+ DESCRIPTION
4965
+ List active transactions from all responding ServiceNow cluster nodes.
4966
+
4967
+ EXAMPLES
4968
+ $ nex transaction list --auth dev
4969
+
4970
+ $ nex transaction list --json --auth dev
4971
+
4972
+ $ nex transaction list --query "user=admin" --limit 50 --auth dev
4973
+
4974
+ $ nex transaction list --timeout-ms 120000 --poll-interval-ms 2000 --auth dev
4975
+ ```
4976
+
4977
+ _See code: [src/commands/transaction/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/transaction/list.ts)_
4759
4978
 
4760
4979
  ## `nex update-set`
4761
4980
 
@@ -4803,7 +5022,7 @@ EXAMPLES
4803
5022
  $ nex update-set --json --auth dev-instance
4804
5023
  ```
4805
5024
 
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)_
5025
+ _See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/update-set/index.ts)_
4807
5026
 
4808
5027
  ## `nex update-set clone`
4809
5028
 
@@ -4847,7 +5066,7 @@ EXAMPLES
4847
5066
  $ nex update-set clone --source us-001 --name "Cloned Set" --json --auth dev-instance
4848
5067
  ```
4849
5068
 
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)_
5069
+ _See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/update-set/clone.ts)_
4851
5070
 
4852
5071
  ## `nex update-set create`
4853
5072
 
@@ -4896,7 +5115,7 @@ EXAMPLES
4896
5115
  $ nex update-set create --name "My Feature Set" --application x_my_app --auth dev-instance
4897
5116
  ```
4898
5117
 
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)_
5118
+ _See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/update-set/create.ts)_
4900
5119
 
4901
5120
  ## `nex update-set current`
4902
5121
 
@@ -4943,7 +5162,7 @@ EXAMPLES
4943
5162
  $ nex update-set current --json --auth dev-instance
4944
5163
  ```
4945
5164
 
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)_
5165
+ _See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/update-set/current.ts)_
4947
5166
 
4948
5167
  ## `nex update-set inspect`
4949
5168
 
@@ -4986,7 +5205,7 @@ EXAMPLES
4986
5205
  $ nex update-set inspect --sys-id us-001 --json --auth dev-instance
4987
5206
  ```
4988
5207
 
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)_
5208
+ _See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/update-set/inspect.ts)_
4990
5209
 
4991
5210
  ## `nex update-set move`
4992
5211
 
@@ -5036,7 +5255,7 @@ EXAMPLES
5036
5255
  $ nex update-set move --target us-002 --source us-001 --json --auth dev-instance
5037
5256
  ```
5038
5257
 
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)_
5258
+ _See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/update-set/move.ts)_
5040
5259
 
5041
5260
  ## `nex workflow create`
5042
5261
 
@@ -5079,7 +5298,7 @@ EXAMPLES
5079
5298
  $ nex workflow create -s ./workflow.json --json --auth dev
5080
5299
  ```
5081
5300
 
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)_
5301
+ _See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/workflow/create.ts)_
5083
5302
 
5084
5303
  ## `nex workflow publish`
5085
5304
 
@@ -5123,7 +5342,7 @@ EXAMPLES
5123
5342
  $ nex workflow publish -v wfv-001 -s act-001 --json --auth dev
5124
5343
  ```
5125
5344
 
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)_
5345
+ _See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/workflow/publish.ts)_
5127
5346
 
5128
5347
  ## `nex xml export`
5129
5348
 
@@ -5181,7 +5400,7 @@ EXAMPLES
5181
5400
  $ nex xml export --table sys_script --sys-id abc123 --json --auth dev
5182
5401
  ```
5183
5402
 
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)_
5403
+ _See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/xml/export.ts)_
5185
5404
 
5186
5405
  ## `nex xml import`
5187
5406
 
@@ -5233,7 +5452,7 @@ EXAMPLES
5233
5452
  $ nex xml import --file ./records.xml --table incident --json --auth dev
5234
5453
  ```
5235
5454
 
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)_
5455
+ _See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.5.0/src/commands/xml/import.ts)_
5237
5456
  <!-- commandsstop -->
5238
5457
 
5239
5458
  ---