@sonisoft/now-sdk-ext-cli 5.2.0 → 5.4.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
@@ -95,6 +95,7 @@ Execute individual ATF tests or entire test suites with detailed results, perfec
95
95
  - [Query & Search](#query--search)
96
96
  - [Aggregate & Analytics](#aggregate--analytics)
97
97
  - [Instance Health Check](#instance-health-check)
98
+ - [Cluster Transactions](#cluster-transactions)
98
99
  - [Flow Designer](#flow-designer-operations)
99
100
  - [Bulk Operations](#bulk-record-operations)
100
101
  - [All Commands](#-commands)
@@ -474,6 +475,23 @@ nex health check --json --auth dev
474
475
  - Operational counts (open incidents, changes, problems)
475
476
  - Color-coded status indicators
476
477
 
478
+ ### Cluster Transactions
479
+
480
+ Discover active transactions from all responding ServiceNow cluster nodes, then submit a request for one exact transaction when necessary.
481
+
482
+ ```bash
483
+ # List active transactions
484
+ nex transaction list --auth dev
485
+
486
+ # Return complete, untruncated records as JSON
487
+ nex transaction list --json --auth dev
488
+
489
+ # Submit a kill request for one deliberately selected transaction
490
+ nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --auth dev
491
+ ```
492
+
493
+ > **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.
494
+
477
495
  ### Flow Designer Operations
478
496
 
479
497
  Execute and manage Flow Designer flows, subflows, and actions from the CLI.
@@ -505,6 +523,19 @@ nex flow cancel --context-id ctx-abc123 --reason "No longer needed" --auth dev
505
523
 
506
524
  # Send a message to a waiting flow (e.g., approval)
507
525
  nex flow message --context-id ctx-abc123 --message approved --payload '{"approver":"admin"}' --auth dev
526
+
527
+ # Read a flow's design-time definition (nothing is executed; no context is created)
528
+ nex flow definition --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev
529
+
530
+ # Read a subflow definition
531
+ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev
532
+
533
+ # Read a custom action definition with its ordered steps
534
+ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev
535
+
536
+ # Redirect the full JSON definition to a file, or pipe it into another tool
537
+ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json
538
+ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps
508
539
  ```
509
540
 
510
541
  **Features:**
@@ -512,6 +543,8 @@ nex flow message --context-id ctx-abc123 --message approved --payload '{"approve
512
543
  - Foreground (wait) or background execution modes
513
544
  - Query flow context status, outputs, and errors
514
545
  - Cancel running flows and send messages to paused flows
546
+ - Read design-time definitions of flows, subflows, and actions — read-only, and
547
+ distinct from `flow details`, which reports on one past execution
515
548
  - JSON output for automation and CI/CD
516
549
 
517
550
  ### Bulk Record Operations
@@ -582,6 +615,9 @@ nex bulk update --table incident --query "state=7" --data '{"active":"false"}' -
582
615
  * [Check only version and stuck jobs](#check-only-version-and-stuck-jobs)
583
616
  * [Health check with custom stuck job threshold (60 minutes)](#health-check-with-custom-stuck-job-threshold-60-minutes)
584
617
  * [JSON output for monitoring/alerting](#json-output-for-monitoringalerting)
618
+ * [List active transactions](#list-active-transactions)
619
+ * [Return complete, untruncated records as JSON](#return-complete-untruncated-records-as-json)
620
+ * [Submit a kill request for one deliberately selected transaction](#submit-a-kill-request-for-one-deliberately-selected-transaction)
585
621
  * [Execute a flow in foreground (waits for completion)](#execute-a-flow-in-foreground-waits-for-completion)
586
622
  * [Execute with inputs](#execute-with-inputs)
587
623
  * [Execute a subflow](#execute-a-subflow)
@@ -591,6 +627,10 @@ nex bulk update --table incident --query "state=7" --data '{"active":"false"}' -
591
627
  * [Check for errors](#check-for-errors)
592
628
  * [Cancel a running flow](#cancel-a-running-flow)
593
629
  * [Send a message to a waiting flow (e.g., approval)](#send-a-message-to-a-waiting-flow-eg-approval)
630
+ * [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)
631
+ * [Read a subflow definition](#read-a-subflow-definition)
632
+ * [Read a custom action definition with its ordered steps](#read-a-custom-action-definition-with-its-ordered-steps)
633
+ * [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
634
  * [Dry-run: preview which records would be updated (safe default)](#dry-run-preview-which-records-would-be-updated-safe-default)
595
635
  * [Confirm bulk update (actually modifies records)](#confirm-bulk-update-actually-modifies-records)
596
636
  * [Dry-run: preview which records would be deleted](#dry-run-preview-which-records-would-be-deleted)
@@ -689,7 +729,7 @@ $ npm install -g @sonisoft/now-sdk-ext-cli
689
729
  $ nex COMMAND
690
730
  running command...
691
731
  $ nex (--version)
692
- @sonisoft/now-sdk-ext-cli/5.2.0 linux-x64 node-v26.5.0
732
+ @sonisoft/now-sdk-ext-cli/5.4.0 linux-x64 node-v26.5.0
693
733
  $ nex --help [COMMAND]
694
734
  USAGE
695
735
  $ nex COMMAND
@@ -749,6 +789,7 @@ rather than silently denying nothing.
749
789
  * [`nex flow action`](#nex-flow-action)
750
790
  * [`nex flow cancel`](#nex-flow-cancel)
751
791
  * [`nex flow copy`](#nex-flow-copy)
792
+ * [`nex flow definition`](#nex-flow-definition)
752
793
  * [`nex flow details`](#nex-flow-details)
753
794
  * [`nex flow error`](#nex-flow-error)
754
795
  * [`nex flow logs`](#nex-flow-logs)
@@ -798,6 +839,8 @@ rather than silently denying nothing.
798
839
  * [`nex task comment`](#nex-task-comment)
799
840
  * [`nex task find`](#nex-task-find)
800
841
  * [`nex task resolve`](#nex-task-resolve)
842
+ * [`nex transaction kill`](#nex-transaction-kill)
843
+ * [`nex transaction list`](#nex-transaction-list)
801
844
  * [`nex update-set`](#nex-update-set)
802
845
  * [`nex update-set clone`](#nex-update-set-clone)
803
846
  * [`nex update-set create`](#nex-update-set-create)
@@ -862,7 +905,7 @@ EXAMPLES
862
905
  $ nex aggregate count --table incident --query "active=true" --json --auth dev
863
906
  ```
864
907
 
865
- _See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/aggregate/count.ts)_
908
+ _See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/aggregate/count.ts)_
866
909
 
867
910
  ## `nex aggregate group`
868
911
 
@@ -930,7 +973,7 @@ EXAMPLES
930
973
  $ nex aggregate group --table incident --group-by priority --count --having "count>10" --auth dev
931
974
  ```
932
975
 
933
- _See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/aggregate/group.ts)_
976
+ _See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/aggregate/group.ts)_
934
977
 
935
978
  ## `nex aggregate query`
936
979
 
@@ -993,7 +1036,7 @@ EXAMPLES
993
1036
  $ nex aggregate query --table incident --sum reassignment_count --json --auth dev
994
1037
  ```
995
1038
 
996
- _See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/aggregate/query.ts)_
1039
+ _See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/aggregate/query.ts)_
997
1040
 
998
1041
  ## `nex app`
999
1042
 
@@ -1056,7 +1099,7 @@ EXAMPLES
1056
1099
  $ nex app -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
1057
1100
  ```
1058
1101
 
1059
- _See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/index.ts)_
1102
+ _See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/index.ts)_
1060
1103
 
1061
1104
  ## `nex app install`
1062
1105
 
@@ -1124,7 +1167,7 @@ EXAMPLES
1124
1167
  $ nex app install -b -d ./apps.json -a dev-instance --log-level debug
1125
1168
  ```
1126
1169
 
1127
- _See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/install.ts)_
1170
+ _See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/install.ts)_
1128
1171
 
1129
1172
  ## `nex app repo-install`
1130
1173
 
@@ -1209,7 +1252,7 @@ EXAMPLES
1209
1252
  $ nex app repo-install -s x_my_app -a dev-instance --log-level debug
1210
1253
  ```
1211
1254
 
1212
- _See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/repo-install.ts)_
1255
+ _See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/repo-install.ts)_
1213
1256
 
1214
1257
  ## `nex app repo-list`
1215
1258
 
@@ -1284,7 +1327,7 @@ EXAMPLES
1284
1327
  $ nex app repo-list -a dev-instance
1285
1328
  ```
1286
1329
 
1287
- _See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/repo-list.ts)_
1330
+ _See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/repo-list.ts)_
1288
1331
 
1289
1332
  ## `nex app uninstall`
1290
1333
 
@@ -1346,7 +1389,7 @@ EXAMPLES
1346
1389
  $ nex app uninstall -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
1347
1390
  ```
1348
1391
 
1349
- _See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/app/uninstall.ts)_
1392
+ _See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/app/uninstall.ts)_
1350
1393
 
1351
1394
  ## `nex atf`
1352
1395
 
@@ -1429,7 +1472,7 @@ EXAMPLES
1429
1472
  $ nex atf --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance
1430
1473
  ```
1431
1474
 
1432
- _See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/atf/index.ts)_
1475
+ _See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/atf/index.ts)_
1433
1476
 
1434
1477
  ## `nex attachment get`
1435
1478
 
@@ -1472,7 +1515,7 @@ EXAMPLES
1472
1515
  $ nex attachment get -s att123 --json --auth dev
1473
1516
  ```
1474
1517
 
1475
- _See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/attachment/get.ts)_
1518
+ _See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/attachment/get.ts)_
1476
1519
 
1477
1520
  ## `nex attachment list`
1478
1521
 
@@ -1517,7 +1560,7 @@ EXAMPLES
1517
1560
  $ nex attachment list -t incident -r abc123 --limit 50 --json --auth dev
1518
1561
  ```
1519
1562
 
1520
- _See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/attachment/list.ts)_
1563
+ _See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/attachment/list.ts)_
1521
1564
 
1522
1565
  ## `nex attachment upload`
1523
1566
 
@@ -1564,7 +1607,7 @@ EXAMPLES
1564
1607
  $ nex attachment upload -t incident -r abc123 -f ./data.csv --content-type text/csv --auth dev
1565
1608
  ```
1566
1609
 
1567
- _See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/attachment/upload.ts)_
1610
+ _See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/attachment/upload.ts)_
1568
1611
 
1569
1612
  ## `nex auth delete [ALIAS]`
1570
1613
 
@@ -1599,7 +1642,7 @@ EXAMPLES
1599
1642
  $ nex auth delete --all
1600
1643
  ```
1601
1644
 
1602
- _See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/auth/delete.ts)_
1645
+ _See code: [src/commands/auth/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/auth/delete.ts)_
1603
1646
 
1604
1647
  ## `nex auth doctor`
1605
1648
 
@@ -1627,7 +1670,7 @@ EXAMPLES
1627
1670
  $ nex auth doctor --json
1628
1671
  ```
1629
1672
 
1630
- _See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/auth/doctor.ts)_
1673
+ _See code: [src/commands/auth/doctor.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/auth/doctor.ts)_
1631
1674
 
1632
1675
  ## `nex auth list`
1633
1676
 
@@ -1660,7 +1703,7 @@ EXAMPLES
1660
1703
  $ nex auth list --json
1661
1704
  ```
1662
1705
 
1663
- _See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/auth/list.ts)_
1706
+ _See code: [src/commands/auth/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/auth/list.ts)_
1664
1707
 
1665
1708
  ## `nex auth use ALIAS`
1666
1709
 
@@ -1688,7 +1731,7 @@ EXAMPLES
1688
1731
  $ nex auth use dev206299
1689
1732
  ```
1690
1733
 
1691
- _See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/auth/use.ts)_
1734
+ _See code: [src/commands/auth/use.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/auth/use.ts)_
1692
1735
 
1693
1736
  ## `nex autocomplete [SHELL]`
1694
1737
 
@@ -1763,7 +1806,7 @@ EXAMPLES
1763
1806
  $ nex batch create --file ./records.json --no-transaction --auth dev
1764
1807
  ```
1765
1808
 
1766
- _See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/batch/create.ts)_
1809
+ _See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/batch/create.ts)_
1767
1810
 
1768
1811
  ## `nex batch update`
1769
1812
 
@@ -1807,7 +1850,7 @@ EXAMPLES
1807
1850
  $ nex batch update --file ./updates.json --stop-on-error --auth dev
1808
1851
  ```
1809
1852
 
1810
- _See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/batch/update.ts)_
1853
+ _See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/batch/update.ts)_
1811
1854
 
1812
1855
  ## `nex bulk delete`
1813
1856
 
@@ -1871,7 +1914,7 @@ EXAMPLES
1871
1914
  $ nex bulk delete --table u_staging --query "processed=true" --confirm --json --auth dev
1872
1915
  ```
1873
1916
 
1874
- _See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/bulk/delete.ts)_
1917
+ _See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/bulk/delete.ts)_
1875
1918
 
1876
1919
  ## `nex bulk update`
1877
1920
 
@@ -1940,7 +1983,7 @@ EXAMPLES
1940
1983
  $ nex bulk update --table incident --query "active=true" --data '{"state":"6"}' --confirm --json --auth dev
1941
1984
  ```
1942
1985
 
1943
- _See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/bulk/update.ts)_
1986
+ _See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/bulk/update.ts)_
1944
1987
 
1945
1988
  ## `nex exec SCOPE [FILE]`
1946
1989
 
@@ -2070,7 +2113,7 @@ EXAMPLES
2070
2113
  $ nex exec global ./script.js --auth dev-instance --params '{"token":"abc123","env":"dev"}'
2071
2114
  ```
2072
2115
 
2073
- _See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/exec/index.ts)_
2116
+ _See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/exec/index.ts)_
2074
2117
 
2075
2118
  ## `nex flow action`
2076
2119
 
@@ -2124,7 +2167,7 @@ EXAMPLES
2124
2167
  '{"table":"incident","values":{"short_description":"Test"}}' --auth dev
2125
2168
  ```
2126
2169
 
2127
- _See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/action.ts)_
2170
+ _See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/action.ts)_
2128
2171
 
2129
2172
  ## `nex flow cancel`
2130
2173
 
@@ -2171,7 +2214,7 @@ EXAMPLES
2171
2214
  $ nex flow cancel --context-id abc123def456 --reason "No longer needed" --auth dev
2172
2215
  ```
2173
2216
 
2174
- _See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/cancel.ts)_
2217
+ _See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/cancel.ts)_
2175
2218
 
2176
2219
  ## `nex flow copy`
2177
2220
 
@@ -2236,7 +2279,80 @@ EXAMPLES
2236
2279
  dev
2237
2280
  ```
2238
2281
 
2239
- _See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/copy.ts)_
2282
+ _See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/copy.ts)_
2283
+
2284
+ ## `nex flow definition`
2285
+
2286
+ Retrieve the read-only design-time definition of a flow, subflow, or action.
2287
+
2288
+ ```
2289
+ USAGE
2290
+ $ nex flow definition -i <value> [-j] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
2291
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-t flow|subflow|action] [--scope
2292
+ <value>]
2293
+
2294
+ FLAGS
2295
+ -a, --auth=<value> Auth alias to use.
2296
+ -i, --sys-id=<value> (required) sys_id of the flow, subflow, or action to retrieve
2297
+ -j, --json Output the complete typed result as JSON
2298
+ -t, --type=<option> [default: flow] Artifact type to retrieve. Must match what the sys_id actually is.
2299
+ <options: flow|subflow|action>
2300
+ --scope=<value> Scope sys_id or name for the transaction scope parameter. Optional — ServiceNow resolves the
2301
+ artifact's own scope when omitted.
2302
+
2303
+ GLOBAL FLAGS
2304
+ --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
2305
+ sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
2306
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
2307
+ --deny-write Refuse any change to instance data for this invocation.
2308
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
2309
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
2310
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
2311
+ stderr only.
2312
+ --log-level=<option> [default: info] Specify level for logging.
2313
+ <options: debug|warn|error|info|trace>
2314
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
2315
+ unaffected.
2316
+
2317
+ DESCRIPTION
2318
+ Retrieve the read-only design-time definition of a flow, subflow, or action.
2319
+
2320
+ Returns what the artifact IS, not what a run of it did: triggers, actions, nested subflows, flow logic, inputs and
2321
+ outputs as Workflow Studio stores them. Nothing is executed, published or modified, and no flow context is created or
2322
+ required.
2323
+
2324
+ This is the design-time counterpart to `flow details`, which describes one past execution and needs a context sys_id.
2325
+
2326
+ The type is never inferred from the sys_id: --type selects the artifact that is asked for, and a sys_id of a different
2327
+ type fails with a type_mismatch rather than being relabelled.
2328
+
2329
+ With --json, stdout carries exactly one JSON document — the complete typed result including the untouched ServiceNow
2330
+ payload — so it can be piped or redirected. Without it, a short summary is printed; definition bodies, step scripts
2331
+ and input values are never printed or logged.
2332
+
2333
+ EXAMPLES
2334
+ Summarise a flow definition
2335
+
2336
+ $ nex flow definition --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev
2337
+
2338
+ Retrieve a subflow definition
2339
+
2340
+ $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev
2341
+
2342
+ Retrieve a custom action definition with its ordered steps
2343
+
2344
+ $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev
2345
+
2346
+ Redirect the full JSON definition to a file
2347
+
2348
+ $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json
2349
+
2350
+ Pipe the JSON definition into another tool
2351
+
2352
+ $ nex flow definition -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps
2353
+ ```
2354
+
2355
+ _See code: [src/commands/flow/definition.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/definition.ts)_
2240
2356
 
2241
2357
  ## `nex flow details`
2242
2358
 
@@ -2297,7 +2413,7 @@ EXAMPLES
2297
2413
  $ nex flow details -c d4e5f6789012345678abcdef01234567 --json --auth dev
2298
2414
  ```
2299
2415
 
2300
- _See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/details.ts)_
2416
+ _See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/details.ts)_
2301
2417
 
2302
2418
  ## `nex flow error`
2303
2419
 
@@ -2339,7 +2455,7 @@ EXAMPLES
2339
2455
  $ nex flow error --context-id abc123def456 --auth dev
2340
2456
  ```
2341
2457
 
2342
- _See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/error.ts)_
2458
+ _See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/error.ts)_
2343
2459
 
2344
2460
  ## `nex flow logs`
2345
2461
 
@@ -2397,7 +2513,7 @@ EXAMPLES
2397
2513
  $ nex flow logs -c d4e5f6789012345678abcdef01234567 --json --auth dev
2398
2514
  ```
2399
2515
 
2400
- _See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/logs.ts)_
2516
+ _See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/logs.ts)_
2401
2517
 
2402
2518
  ## `nex flow message`
2403
2519
 
@@ -2447,7 +2563,7 @@ EXAMPLES
2447
2563
  $ nex flow message --context-id abc123def456 --message "data_ready" --payload '{"status":"ok"}' --auth dev
2448
2564
  ```
2449
2565
 
2450
- _See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/message.ts)_
2566
+ _See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/message.ts)_
2451
2567
 
2452
2568
  ## `nex flow outputs`
2453
2569
 
@@ -2493,7 +2609,7 @@ EXAMPLES
2493
2609
  $ nex flow outputs --context-id abc123def456 --json --auth dev
2494
2610
  ```
2495
2611
 
2496
- _See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/outputs.ts)_
2612
+ _See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/outputs.ts)_
2497
2613
 
2498
2614
  ## `nex flow run`
2499
2615
 
@@ -2559,7 +2675,7 @@ EXAMPLES
2559
2675
  $ nex flow run --name global.my_flow --mode background --auth dev
2560
2676
  ```
2561
2677
 
2562
- _See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/run.ts)_
2678
+ _See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/run.ts)_
2563
2679
 
2564
2680
  ## `nex flow status`
2565
2681
 
@@ -2603,7 +2719,7 @@ EXAMPLES
2603
2719
  $ nex flow status --context-id abc123def456 --auth dev
2604
2720
  ```
2605
2721
 
2606
- _See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/status.ts)_
2722
+ _See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/status.ts)_
2607
2723
 
2608
2724
  ## `nex flow subflow`
2609
2725
 
@@ -2663,7 +2779,7 @@ EXAMPLES
2663
2779
  $ nex flow subflow --name x_myapp.process_record --inputs '{"table":"incident","sys_id":"abc123"}' --auth dev
2664
2780
  ```
2665
2781
 
2666
- _See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/subflow.ts)_
2782
+ _See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/subflow.ts)_
2667
2783
 
2668
2784
  ## `nex flow test`
2669
2785
 
@@ -2726,7 +2842,7 @@ EXAMPLES
2726
2842
  $ nex flow test -f 887dda5583237210fdb8f7b6feaad32c -o '{"current":"abc123"}' --json --auth dev
2727
2843
  ```
2728
2844
 
2729
- _See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/flow/test.ts)_
2845
+ _See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/flow/test.ts)_
2730
2846
 
2731
2847
  ## `nex health check`
2732
2848
 
@@ -2796,7 +2912,7 @@ EXAMPLES
2796
2912
  $ nex health check --json --auth dev
2797
2913
  ```
2798
2914
 
2799
- _See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/health/check.ts)_
2915
+ _See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/health/check.ts)_
2800
2916
 
2801
2917
  ## `nex help [COMMAND]`
2802
2918
 
@@ -2932,7 +3048,7 @@ EXAMPLES
2932
3048
  $ nex log --no-color --auth dev-instance
2933
3049
  ```
2934
3050
 
2935
- _See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/log/index.ts)_
3051
+ _See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/log/index.ts)_
2936
3052
 
2937
3053
  ## `nex plugins`
2938
3054
 
@@ -3254,7 +3370,7 @@ EXAMPLES
3254
3370
  NEX_POLICY_DENY=all nex policy status
3255
3371
  ```
3256
3372
 
3257
- _See code: [src/commands/policy/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/policy/status.ts)_
3373
+ _See code: [src/commands/policy/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/policy/status.ts)_
3258
3374
 
3259
3375
  ## `nex query`
3260
3376
 
@@ -3317,7 +3433,7 @@ EXAMPLES
3317
3433
  $ nex query --table sys_user --query "active=true" --limit 5 --json --auth dev
3318
3434
  ```
3319
3435
 
3320
- _See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/query/index.ts)_
3436
+ _See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/query/index.ts)_
3321
3437
 
3322
3438
  ## `nex query app`
3323
3439
 
@@ -3370,7 +3486,7 @@ EXAMPLES
3370
3486
  $ nex query app --search "HR" --active --auth dev
3371
3487
  ```
3372
3488
 
3373
- _See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/query/app.ts)_
3489
+ _See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/query/app.ts)_
3374
3490
 
3375
3491
  ## `nex query columns`
3376
3492
 
@@ -3425,7 +3541,7 @@ EXAMPLES
3425
3541
  $ nex query columns --table incident --json --auth dev
3426
3542
  ```
3427
3543
 
3428
- _See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/query/columns.ts)_
3544
+ _See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/query/columns.ts)_
3429
3545
 
3430
3546
  ## `nex query syslog`
3431
3547
 
@@ -3482,7 +3598,7 @@ EXAMPLES
3482
3598
  $ nex query syslog --query "sourceLIKEincident" --json --auth dev
3483
3599
  ```
3484
3600
 
3485
- _See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/query/syslog.ts)_
3601
+ _See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/query/syslog.ts)_
3486
3602
 
3487
3603
  ## `nex schema`
3488
3604
 
@@ -3541,7 +3657,7 @@ EXAMPLES
3541
3657
  $ nex schema --table incident --include-choices --include-relationships --auth dev
3542
3658
  ```
3543
3659
 
3544
- _See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/schema/index.ts)_
3660
+ _See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/schema/index.ts)_
3545
3661
 
3546
3662
  ## `nex schema field`
3547
3663
 
@@ -3588,7 +3704,7 @@ EXAMPLES
3588
3704
  $ nex schema field --table incident --field priority --json --auth dev
3589
3705
  ```
3590
3706
 
3591
- _See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/schema/field.ts)_
3707
+ _See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/schema/field.ts)_
3592
3708
 
3593
3709
  ## `nex schema validate-catalog`
3594
3710
 
@@ -3634,7 +3750,7 @@ EXAMPLES
3634
3750
  $ nex schema validate-catalog --sys-id a1b2c3d4e5f6 --json --auth dev
3635
3751
  ```
3636
3752
 
3637
- _See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/schema/validate-catalog.ts)_
3753
+ _See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/schema/validate-catalog.ts)_
3638
3754
 
3639
3755
  ## `nex scope`
3640
3756
 
@@ -3681,7 +3797,7 @@ EXAMPLES
3681
3797
  $ nex scope -l --json --auth dev
3682
3798
  ```
3683
3799
 
3684
- _See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/scope/index.ts)_
3800
+ _See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/scope/index.ts)_
3685
3801
 
3686
3802
  ## `nex scope set`
3687
3803
 
@@ -3724,7 +3840,7 @@ EXAMPLES
3724
3840
  $ nex scope set -a abc123def456ghi789jkl012mno345pq --json --auth dev
3725
3841
  ```
3726
3842
 
3727
- _See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/scope/set.ts)_
3843
+ _See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/scope/set.ts)_
3728
3844
 
3729
3845
  ## `nex script-sync pull`
3730
3846
 
@@ -3784,7 +3900,7 @@ EXAMPLES
3784
3900
  $ nex script-sync pull -n MyClientScript -t sys_script_client --json --auth dev-instance
3785
3901
  ```
3786
3902
 
3787
- _See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/script-sync/pull.ts)_
3903
+ _See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/script-sync/pull.ts)_
3788
3904
 
3789
3905
  ## `nex script-sync push`
3790
3906
 
@@ -3845,7 +3961,7 @@ EXAMPLES
3845
3961
  $ nex script-sync push -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --auth dev-instance
3846
3962
  ```
3847
3963
 
3848
- _See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/script-sync/push.ts)_
3964
+ _See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/script-sync/push.ts)_
3849
3965
 
3850
3966
  ## `nex script-sync sync`
3851
3967
 
@@ -3904,7 +4020,7 @@ EXAMPLES
3904
4020
  $ nex script-sync sync -d ./scripts --json --auth dev-instance
3905
4021
  ```
3906
4022
 
3907
- _See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/script-sync/sync.ts)_
4023
+ _See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/script-sync/sync.ts)_
3908
4024
 
3909
4025
  ## `nex search`
3910
4026
 
@@ -3971,7 +4087,7 @@ EXAMPLES
3971
4087
  $ nex search --term "GlideRecord" --limit 10 --json --auth dev-instance
3972
4088
  ```
3973
4089
 
3974
- _See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/search/index.ts)_
4090
+ _See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/search/index.ts)_
3975
4091
 
3976
4092
  ## `nex search add-table`
3977
4093
 
@@ -4031,7 +4147,7 @@ EXAMPLES
4031
4147
  dev-instance
4032
4148
  ```
4033
4149
 
4034
- _See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/search/add-table.ts)_
4150
+ _See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/search/add-table.ts)_
4035
4151
 
4036
4152
  ## `nex search groups`
4037
4153
 
@@ -4080,7 +4196,7 @@ EXAMPLES
4080
4196
  $ nex search groups --json --auth dev-instance
4081
4197
  ```
4082
4198
 
4083
- _See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/search/groups.ts)_
4199
+ _See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/search/groups.ts)_
4084
4200
 
4085
4201
  ## `nex search tables`
4086
4202
 
@@ -4131,7 +4247,7 @@ EXAMPLES
4131
4247
  $ nex search tables --search-group "Business Rules" --json --auth dev-instance
4132
4248
  ```
4133
4249
 
4134
- _See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/search/tables.ts)_
4250
+ _See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/search/tables.ts)_
4135
4251
 
4136
4252
  ## `nex store install`
4137
4253
 
@@ -4184,7 +4300,7 @@ EXAMPLES
4184
4300
  $ nex store install -a abc123 -v 1.0.0 --demo-data --auth dev
4185
4301
  ```
4186
4302
 
4187
- _See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/store/install.ts)_
4303
+ _See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/store/install.ts)_
4188
4304
 
4189
4305
  ## `nex store search`
4190
4306
 
@@ -4235,7 +4351,7 @@ EXAMPLES
4235
4351
  $ nex store search --tab updates --limit 10 --auth dev
4236
4352
  ```
4237
4353
 
4238
- _See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/store/search.ts)_
4354
+ _See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/store/search.ts)_
4239
4355
 
4240
4356
  ## `nex store update`
4241
4357
 
@@ -4287,7 +4403,7 @@ EXAMPLES
4287
4403
  $ nex store update -a abc123 -v 2.0.0 --timeout 3600000 --auth dev
4288
4404
  ```
4289
4405
 
4290
- _See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/store/update.ts)_
4406
+ _See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/store/update.ts)_
4291
4407
 
4292
4408
  ## `nex store validate`
4293
4409
 
@@ -4326,7 +4442,7 @@ EXAMPLES
4326
4442
  $ nex store validate --file ./batch-definition.json --auth dev
4327
4443
  ```
4328
4444
 
4329
- _See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/store/validate.ts)_
4445
+ _See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/store/validate.ts)_
4330
4446
 
4331
4447
  ## `nex task approve`
4332
4448
 
@@ -4377,7 +4493,7 @@ EXAMPLES
4377
4493
  $ nex task approve -n CHG0010001 -c "Looks good, approved" --auth dev
4378
4494
  ```
4379
4495
 
4380
- _See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/approve.ts)_
4496
+ _See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/approve.ts)_
4381
4497
 
4382
4498
  ## `nex task assign`
4383
4499
 
@@ -4438,7 +4554,7 @@ EXAMPLES
4438
4554
  $ nex task assign --number CHG0010001 --table change_request --user admin --auth dev
4439
4555
  ```
4440
4556
 
4441
- _See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/assign.ts)_
4557
+ _See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/assign.ts)_
4442
4558
 
4443
4559
  ## `nex task close`
4444
4560
 
@@ -4492,7 +4608,7 @@ EXAMPLES
4492
4608
  $ nex task close -n INC0010001 --notes "Closed" --close-code "Solved (Permanently)" --auth dev
4493
4609
  ```
4494
4610
 
4495
- _See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/close.ts)_
4611
+ _See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/close.ts)_
4496
4612
 
4497
4613
  ## `nex task comment`
4498
4614
 
@@ -4552,7 +4668,7 @@ EXAMPLES
4552
4668
  $ nex task comment --number CHG0010001 --table change_request --comment "Approved" --auth dev
4553
4669
  ```
4554
4670
 
4555
- _See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/comment.ts)_
4671
+ _See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/comment.ts)_
4556
4672
 
4557
4673
  ## `nex task find`
4558
4674
 
@@ -4608,7 +4724,7 @@ EXAMPLES
4608
4724
  $ nex task find -n INC0010001 --json --auth dev
4609
4725
  ```
4610
4726
 
4611
- _See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/find.ts)_
4727
+ _See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/find.ts)_
4612
4728
 
4613
4729
  ## `nex task resolve`
4614
4730
 
@@ -4662,7 +4778,97 @@ EXAMPLES
4662
4778
  $ nex task resolve -n INC0010001 --notes "Fixed" --close-code "Solved (Permanently)" --auth dev
4663
4779
  ```
4664
4780
 
4665
- _See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/task/resolve.ts)_
4781
+ _See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/task/resolve.ts)_
4782
+
4783
+ ## `nex transaction kill`
4784
+
4785
+ Submit a request to terminate one active transaction. Platform acceptance does not mean immediate removal.
4786
+
4787
+ ```
4788
+ USAGE
4789
+ $ nex transaction kill -t <value> [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir
4790
+ <value>] [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [--confirm]
4791
+
4792
+ FLAGS
4793
+ -a, --auth=<value> Auth alias to use.
4794
+ -t, --transaction-id=<value> (required) Exact 32-character hexadecimal sys_id from `nex transaction list`.
4795
+ --confirm Confirm submission of the kill request.
4796
+
4797
+ GLOBAL FLAGS
4798
+ --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4799
+ sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4800
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4801
+ --deny-write Refuse any change to instance data for this invocation.
4802
+ --json Format output as json.
4803
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4804
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4805
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4806
+ stderr only.
4807
+ --log-level=<option> [default: info] Specify level for logging.
4808
+ <options: debug|warn|error|info|trace>
4809
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4810
+ unaffected.
4811
+
4812
+ DESCRIPTION
4813
+ Submit a request to terminate one active transaction. Platform acceptance does not mean immediate removal.
4814
+
4815
+ Only pass an identifier you deliberately selected from `nex transaction list`. Killing another user's transaction
4816
+ aborts their work.
4817
+
4818
+ EXAMPLES
4819
+ $ nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --auth dev
4820
+
4821
+ $ nex transaction kill --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --json --auth dev
4822
+ ```
4823
+
4824
+ _See code: [src/commands/transaction/kill.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/transaction/kill.ts)_
4825
+
4826
+ ## `nex transaction list`
4827
+
4828
+ List active transactions from all responding ServiceNow cluster nodes.
4829
+
4830
+ ```
4831
+ USAGE
4832
+ $ nex transaction list [--json] [-a <value>] [--cred-store] [--deny-execute] [--deny-write] [--log-dir <value>]
4833
+ [--log-file] [--log-level debug|warn|error|info|trace] [--read-only] [-l <value>] [--poll-interval-ms <value>] [-q
4834
+ <value>] [--timeout-ms <value>]
4835
+
4836
+ FLAGS
4837
+ -a, --auth=<value> Auth alias to use.
4838
+ -l, --limit=<value> Maximum transactions to return. Core default: 1000.
4839
+ -q, --query=<value> Encoded query used to filter transactions. Core default: none.
4840
+ --poll-interval-ms=<value> Interval between collection status polls. Core default: 1000.
4841
+ --timeout-ms=<value> Collection timeout in milliseconds. Core default: 60000.
4842
+
4843
+ GLOBAL FLAGS
4844
+ --cred-store Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless
4845
+ sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.
4846
+ --deny-execute Refuse background scripts, flow runs and ATF runs for this invocation.
4847
+ --deny-write Refuse any change to instance data for this invocation.
4848
+ --json Format output as json.
4849
+ --log-dir=<value> Directory to write log files to. Implies --log-file.
4850
+ --log-file Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs
4851
+ (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to
4852
+ stderr only.
4853
+ --log-level=<option> [default: info] Specify level for logging.
4854
+ <options: debug|warn|error|info|trace>
4855
+ --read-only Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are
4856
+ unaffected.
4857
+
4858
+ DESCRIPTION
4859
+ List active transactions from all responding ServiceNow cluster nodes.
4860
+
4861
+ EXAMPLES
4862
+ $ nex transaction list --auth dev
4863
+
4864
+ $ nex transaction list --json --auth dev
4865
+
4866
+ $ nex transaction list --query "user=admin" --limit 50 --auth dev
4867
+
4868
+ $ nex transaction list --timeout-ms 120000 --poll-interval-ms 2000 --auth dev
4869
+ ```
4870
+
4871
+ _See code: [src/commands/transaction/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/transaction/list.ts)_
4666
4872
 
4667
4873
  ## `nex update-set`
4668
4874
 
@@ -4710,7 +4916,7 @@ EXAMPLES
4710
4916
  $ nex update-set --json --auth dev-instance
4711
4917
  ```
4712
4918
 
4713
- _See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/index.ts)_
4919
+ _See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/index.ts)_
4714
4920
 
4715
4921
  ## `nex update-set clone`
4716
4922
 
@@ -4754,7 +4960,7 @@ EXAMPLES
4754
4960
  $ nex update-set clone --source us-001 --name "Cloned Set" --json --auth dev-instance
4755
4961
  ```
4756
4962
 
4757
- _See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/clone.ts)_
4963
+ _See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/clone.ts)_
4758
4964
 
4759
4965
  ## `nex update-set create`
4760
4966
 
@@ -4803,7 +5009,7 @@ EXAMPLES
4803
5009
  $ nex update-set create --name "My Feature Set" --application x_my_app --auth dev-instance
4804
5010
  ```
4805
5011
 
4806
- _See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/create.ts)_
5012
+ _See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/create.ts)_
4807
5013
 
4808
5014
  ## `nex update-set current`
4809
5015
 
@@ -4850,7 +5056,7 @@ EXAMPLES
4850
5056
  $ nex update-set current --json --auth dev-instance
4851
5057
  ```
4852
5058
 
4853
- _See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/current.ts)_
5059
+ _See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/current.ts)_
4854
5060
 
4855
5061
  ## `nex update-set inspect`
4856
5062
 
@@ -4893,7 +5099,7 @@ EXAMPLES
4893
5099
  $ nex update-set inspect --sys-id us-001 --json --auth dev-instance
4894
5100
  ```
4895
5101
 
4896
- _See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/inspect.ts)_
5102
+ _See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/inspect.ts)_
4897
5103
 
4898
5104
  ## `nex update-set move`
4899
5105
 
@@ -4943,7 +5149,7 @@ EXAMPLES
4943
5149
  $ nex update-set move --target us-002 --source us-001 --json --auth dev-instance
4944
5150
  ```
4945
5151
 
4946
- _See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/update-set/move.ts)_
5152
+ _See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/update-set/move.ts)_
4947
5153
 
4948
5154
  ## `nex workflow create`
4949
5155
 
@@ -4986,7 +5192,7 @@ EXAMPLES
4986
5192
  $ nex workflow create -s ./workflow.json --json --auth dev
4987
5193
  ```
4988
5194
 
4989
- _See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/workflow/create.ts)_
5195
+ _See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/workflow/create.ts)_
4990
5196
 
4991
5197
  ## `nex workflow publish`
4992
5198
 
@@ -5030,7 +5236,7 @@ EXAMPLES
5030
5236
  $ nex workflow publish -v wfv-001 -s act-001 --json --auth dev
5031
5237
  ```
5032
5238
 
5033
- _See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/workflow/publish.ts)_
5239
+ _See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/workflow/publish.ts)_
5034
5240
 
5035
5241
  ## `nex xml export`
5036
5242
 
@@ -5088,7 +5294,7 @@ EXAMPLES
5088
5294
  $ nex xml export --table sys_script --sys-id abc123 --json --auth dev
5089
5295
  ```
5090
5296
 
5091
- _See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/xml/export.ts)_
5297
+ _See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/xml/export.ts)_
5092
5298
 
5093
5299
  ## `nex xml import`
5094
5300
 
@@ -5140,7 +5346,7 @@ EXAMPLES
5140
5346
  $ nex xml import --file ./records.xml --table incident --json --auth dev
5141
5347
  ```
5142
5348
 
5143
- _See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.2.0/src/commands/xml/import.ts)_
5349
+ _See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v5.4.0/src/commands/xml/import.ts)_
5144
5350
  <!-- commandsstop -->
5145
5351
 
5146
5352
  ---