@sonisoft/now-sdk-ext-cli 2.0.1 → 2.3.0

package/README.md

@@ -639,7 +639,7 @@ $ npm install -g @sonisoft/now-sdk-ext-cli
 $ nex COMMAND
 running command...
 $ nex (--version)
-@sonisoft/now-sdk-ext-cli/2.0.1 linux-x64 node-v22.22.0
+@sonisoft/now-sdk-ext-cli/2.3.0 linux-x64 node-v22.22.0
 $ nex --help [COMMAND]
 USAGE
   $ nex COMMAND
@@ -669,12 +669,16 @@ USAGE
 * [`nex exec SCOPE [FILE]`](#nex-exec-scope-file)
 * [`nex flow action`](#nex-flow-action)
 * [`nex flow cancel`](#nex-flow-cancel)
+* [`nex flow copy`](#nex-flow-copy)
+* [`nex flow details`](#nex-flow-details)
 * [`nex flow error`](#nex-flow-error)
+* [`nex flow logs`](#nex-flow-logs)
 * [`nex flow message`](#nex-flow-message)
 * [`nex flow outputs`](#nex-flow-outputs)
 * [`nex flow run`](#nex-flow-run)
 * [`nex flow status`](#nex-flow-status)
 * [`nex flow subflow`](#nex-flow-subflow)
+* [`nex flow test`](#nex-flow-test)
 * [`nex health check`](#nex-health-check)
 * [`nex help [COMMAND]`](#nex-help-command)
 * [`nex log`](#nex-log)
@@ -767,7 +771,7 @@ EXAMPLES
     $ nex aggregate count --table incident --query "active=true" --json --auth dev
 ```
 
-_See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/aggregate/count.ts)_
+_See code: [src/commands/aggregate/count.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/aggregate/count.ts)_
 
 ## `nex aggregate group`
 
@@ -824,7 +828,7 @@ EXAMPLES
     $ nex aggregate group --table incident --group-by priority --count --having "count>10" --auth dev
 ```
 
-_See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/aggregate/group.ts)_
+_See code: [src/commands/aggregate/group.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/aggregate/group.ts)_
 
 ## `nex aggregate query`
 
@@ -876,7 +880,7 @@ EXAMPLES
     $ nex aggregate query --table incident --sum reassignment_count --json --auth dev
 ```
 
-_See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/aggregate/query.ts)_
+_See code: [src/commands/aggregate/query.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/aggregate/query.ts)_
 
 ## `nex app`
 
@@ -928,7 +932,7 @@ EXAMPLES
     $ nex app -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
 ```
 
-_See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/app/index.ts)_
+_See code: [src/commands/app/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/app/index.ts)_
 
 ## `nex app install`
 
@@ -985,7 +989,7 @@ EXAMPLES
     $ nex app install -b -d ./apps.json -a dev-instance --log-level debug
 ```
 
-_See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/app/install.ts)_
+_See code: [src/commands/app/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/app/install.ts)_
 
 ## `nex app repo-install`
 
@@ -1059,7 +1063,7 @@ EXAMPLES
     $ nex app repo-install -s x_my_app -a dev-instance --log-level debug
 ```
 
-_See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/app/repo-install.ts)_
+_See code: [src/commands/app/repo-install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/app/repo-install.ts)_
 
 ## `nex app repo-list`
 
@@ -1123,7 +1127,7 @@ EXAMPLES
     $ nex app repo-list -a dev-instance
 ```
 
-_See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/app/repo-list.ts)_
+_See code: [src/commands/app/repo-list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/app/repo-list.ts)_
 
 ## `nex app uninstall`
 
@@ -1174,7 +1178,7 @@ EXAMPLES
     $ nex app uninstall -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance
 ```
 
-_See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/app/uninstall.ts)_
+_See code: [src/commands/app/uninstall.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/app/uninstall.ts)_
 
 ## `nex atf`
 
@@ -1246,7 +1250,7 @@ EXAMPLES
     $ nex atf --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance
 ```
 
-_See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/atf/index.ts)_
+_See code: [src/commands/atf/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/atf/index.ts)_
 
 ## `nex attachment get`
 
@@ -1278,7 +1282,7 @@ EXAMPLES
     $ nex attachment get -s att123 --json --auth dev
 ```
 
-_See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/attachment/get.ts)_
+_See code: [src/commands/attachment/get.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/attachment/get.ts)_
 
 ## `nex attachment list`
 
@@ -1313,7 +1317,7 @@ EXAMPLES
     $ nex attachment list -t incident -r abc123 --limit 50 --json --auth dev
 ```
 
-_See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/attachment/list.ts)_
+_See code: [src/commands/attachment/list.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/attachment/list.ts)_
 
 ## `nex attachment upload`
 
@@ -1349,7 +1353,7 @@ EXAMPLES
     $ nex attachment upload -t incident -r abc123 -f ./data.csv --content-type text/csv --auth dev
 ```
 
-_See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/attachment/upload.ts)_
+_See code: [src/commands/attachment/upload.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/attachment/upload.ts)_
 
 ## `nex autocomplete [SHELL]`
 
@@ -1413,7 +1417,7 @@ EXAMPLES
     $ nex batch create --file ./records.json --no-transaction --auth dev
 ```
 
-_See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/batch/create.ts)_
+_See code: [src/commands/batch/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/batch/create.ts)_
 
 ## `nex batch update`
 
@@ -1446,7 +1450,7 @@ EXAMPLES
     $ nex batch update --file ./updates.json --stop-on-error --auth dev
 ```
 
-_See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/batch/update.ts)_
+_See code: [src/commands/batch/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/batch/update.ts)_
 
 ## `nex bulk delete`
 
@@ -1500,7 +1504,7 @@ EXAMPLES
     $ nex bulk delete --table u_staging --query "processed=true" --confirm --json --auth dev
 ```
 
-_See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/bulk/delete.ts)_
+_See code: [src/commands/bulk/delete.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/bulk/delete.ts)_
 
 ## `nex bulk update`
 
@@ -1558,7 +1562,7 @@ EXAMPLES
     $ nex bulk update --table incident --query "active=true" --data '{"state":"6"}' --confirm --json --auth dev
 ```
 
-_See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/bulk/update.ts)_
+_See code: [src/commands/bulk/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/bulk/update.ts)_
 
 ## `nex exec SCOPE [FILE]`
 
@@ -1677,7 +1681,7 @@ EXAMPLES
     $ nex exec global ./script.js --auth dev-instance --params '{"token":"abc123","env":"dev"}'
 ```
 
-_See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/exec/index.ts)_
+_See code: [src/commands/exec/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/exec/index.ts)_
 
 ## `nex flow action`
 
@@ -1720,7 +1724,7 @@ EXAMPLES
       '{"table":"incident","values":{"short_description":"Test"}}' --auth dev
 ```
 
-_See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/flow/action.ts)_
+_See code: [src/commands/flow/action.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/action.ts)_
 
 ## `nex flow cancel`
 
@@ -1757,7 +1761,111 @@ EXAMPLES
     $ nex flow cancel --context-id abc123def456 --reason "No longer needed" --auth dev
 ```
 
-_See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/flow/cancel.ts)_
+_See code: [src/commands/flow/cancel.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/cancel.ts)_
+
+## `nex flow copy`
+
+Copy an existing flow into a target scoped application.
+
+```
+USAGE
+  $ nex flow copy -s <value> -n <value> -t <value> [-j] [-a <value>] [--log-level debug|warn|error|info|trace]
+
+FLAGS
+  -a, --auth=<value>            Auth alias to use.
+  -j, --json                    Output results as JSON
+  -n, --name=<value>            (required) Display name for the new copied flow
+  -s, --source-flow-id=<value>  (required) Source flow sys_id or scoped name (e.g. global.change__standard)
+  -t, --target-scope=<value>    (required) Scope sys_id of the target application (use `nex scope` to find scope
+                                sys_ids)
+
+GLOBAL FLAGS
+  --log-level=<option>  [default: info] Specify level for logging.
+                        <options: debug|warn|error|info|trace>
+
+DESCRIPTION
+  Copy an existing flow into a target scoped application.
+
+  This is the ServiceNow best practice before modifying any flow — OOB and shared flows must never be modified directly;
+  always copy first. The copied flow lands in draft/unpublished state in the target scope.
+
+  Enables the full CLI-driven flow development lifecycle:
+  copy → pull (now-sdk transform) → modify → push → test → publish
+
+  Features:
+  • Copy flows by sys_id or scoped name
+  • Specify a display name for the new copy
+  • Target any scoped application by sys_id
+  • Returns the new flow sys_id for use in subsequent commands
+
+EXAMPLES
+  Copy an OOB flow into your app scope
+
+    $ nex flow copy --source-flow-id e89e3ade731310108ef62d2b04f6a744 --name "Copy of Change - Standard" \
+      --target-scope 4a5a6115402946939ee48e3fe80f60f8 --auth dev
+
+  Copy by scoped name
+
+    $ nex flow copy -s global.change__standard -n "My Custom Change Flow" -t 4a5a6115402946939ee48e3fe80f60f8 --auth \
+      dev
+
+  Copy with JSON output for scripting
+
+    $ nex flow copy -s e89e3ade731310108ef62d2b04f6a744 -n "Copy" -t 4a5a6115402946939ee48e3fe80f60f8 --json --auth \
+      dev
+```
+
+_See code: [src/commands/flow/copy.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/copy.ts)_
+
+## `nex flow details`
+
+Get rich execution details for a flow context.
+
+```
+USAGE
+  $ nex flow details -c <value> [-j] [-a <value>] [--log-level debug|warn|error|info|trace] [--scope <value>] [-d]
+
+FLAGS
+  -a, --auth=<value>        Auth alias to use.
+  -c, --context-id=<value>  (required) Flow context sys_id returned by flow test, flow run, flow subflow, or flow action
+  -d, --include-definition  Include the full flow definition snapshot in the response
+  -j, --json                Output results as JSON
+      --scope=<value>       Scope sys_id for the ProcessFlow API transaction scope parameter
+
+GLOBAL FLAGS
+  --log-level=<option>  [default: info] Specify level for logging.
+                        <options: debug|warn|error|info|trace>
+
+DESCRIPTION
+  Get rich execution details for a flow context.
+
+  Returns per-action timing, inputs, outputs, and high-level metadata (state, runtime, who ran it, test vs production).
+  This is the primary diagnostic command after flow test or flow run.
+
+  Uses the ProcessFlow operations API (GET /api/now/processflow/operations/flow/context/{id}), the same endpoint Flow
+  Designer uses to display execution details.
+
+  NOTE: Requires flow operations logging to be enabled on the instance. If the execution report is unavailable, a notice
+  will explain why.
+
+  Typical workflow:
+  flow test → flow details → diagnose → modify flow → flow test again
+
+EXAMPLES
+  Get execution details after testing a flow
+
+    $ nex flow details --context-id d4e5f6789012345678abcdef01234567 --auth dev
+
+  Get details with explicit scope
+
+    $ nex flow details -c d4e5f6789012345678abcdef01234567 --scope x_myapp --auth dev
+
+  Get details with JSON output for scripting
+
+    $ nex flow details -c d4e5f6789012345678abcdef01234567 --json --auth dev
+```
+
+_See code: [src/commands/flow/details.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/details.ts)_
 
 ## `nex flow error`
 
@@ -1788,7 +1896,55 @@ EXAMPLES
     $ nex flow error --context-id abc123def456 --auth dev
 ```
 
-_See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/flow/error.ts)_
+_See code: [src/commands/flow/error.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/error.ts)_
+
+## `nex flow logs`
+
+Retrieve flow execution log entries for a given context.
+
+```
+USAGE
+  $ nex flow logs -c <value> [-j] [-a <value>] [--log-level debug|warn|error|info|trace] [-l <value>] [-o
+    asc|desc]
+
+FLAGS
+  -a, --auth=<value>        Auth alias to use.
+  -c, --context-id=<value>  (required) Flow context sys_id returned by flow test, flow run, flow subflow, or flow action
+  -j, --json                Output results as JSON
+  -l, --limit=<value>       [default: 100] Maximum number of log entries to return
+  -o, --order=<option>      [default: asc] Order direction: asc (oldest first) or desc (newest first)
+                            <options: asc|desc>
+
+GLOBAL FLAGS
+  --log-level=<option>  [default: info] Specify level for logging.
+                        <options: debug|warn|error|info|trace>
+
+DESCRIPTION
+  Retrieve flow execution log entries for a given context.
+
+  Log entries include error messages, step-level debug output, and cancellation reasons. Use this alongside flow details
+  to get the full picture of what happened during an execution.
+
+  Queries sys_flow_log entries and maps numeric log levels to human-readable names (ERROR, WARN, INFO, DEBUG).
+
+  NOTE: Log entries may be empty for simple successful executions, or if the flow reporting level is set to NONE. Errors
+  and warnings are always logged regardless of the reporting level setting.
+
+EXAMPLES
+  Get flow execution logs
+
+    $ nex flow logs --context-id d4e5f6789012345678abcdef01234567 --auth dev
+
+  Get latest 10 log entries in reverse order
+
+    $ nex flow logs -c d4e5f6789012345678abcdef01234567 --limit 10 --order desc --auth dev
+
+  Get logs with JSON output for scripting
+
+    $ nex flow logs -c d4e5f6789012345678abcdef01234567 --json --auth dev
+```
+
+_See code: [src/commands/flow/logs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/logs.ts)_
 
 ## `nex flow message`
 
@@ -1827,7 +1983,7 @@ EXAMPLES
     $ nex flow message --context-id abc123def456 --message "data_ready" --payload '{"status":"ok"}' --auth dev
 ```
 
-_See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/flow/message.ts)_
+_See code: [src/commands/flow/message.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/message.ts)_
 
 ## `nex flow outputs`
 
@@ -1862,11 +2018,11 @@ EXAMPLES
     $ nex flow outputs --context-id abc123def456 --json --auth dev
 ```
 
-_See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/flow/outputs.ts)_
+_See code: [src/commands/flow/outputs.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/outputs.ts)_
 
 ## `nex flow run`
 
-Execute a Flow Designer flow by scoped name.
+Execute a published Flow Designer flow by scoped name.
 
 ```
 USAGE
@@ -1888,11 +2044,14 @@ GLOBAL FLAGS
                         <options: debug|warn|error|info|trace>
 
 DESCRIPTION
-  Execute a Flow Designer flow by scoped name.
+  Execute a published Flow Designer flow by scoped name.
 
   Runs a flow using the sn_fd.FlowAPI ScriptableFlowRunner. Supports foreground (synchronous) and background
   (asynchronous) execution modes.
 
+  Note: This command requires the flow to be published. For testing flows that are not yet published (draft/saved
+  state), use `flow test` instead.
+
   Features:
   • Execute flows by scoped name (e.g. global.my_flow)
   • Pass input values as JSON
@@ -1914,7 +2073,7 @@ EXAMPLES
     $ nex flow run --name global.my_flow --mode background --auth dev
 ```
 
-_See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/flow/run.ts)_
+_See code: [src/commands/flow/run.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/run.ts)_
 
 ## `nex flow status`
 
@@ -1947,11 +2106,11 @@ EXAMPLES
     $ nex flow status --context-id abc123def456 --auth dev
 ```
 
-_See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/flow/status.ts)_
+_See code: [src/commands/flow/status.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/status.ts)_
 
 ## `nex flow subflow`
 
-Execute a Flow Designer subflow by scoped name.
+Execute a published Flow Designer subflow by scoped name.
 
 ```
 USAGE
@@ -1973,10 +2132,13 @@ GLOBAL FLAGS
                         <options: debug|warn|error|info|trace>
 
 DESCRIPTION
-  Execute a Flow Designer subflow by scoped name.
+  Execute a published Flow Designer subflow by scoped name.
 
   Runs a subflow using the sn_fd.FlowAPI ScriptableFlowRunner.
 
+  Note: This command requires the subflow to be published. For testing flows that are not yet published (draft/saved
+  state), use `flow test` instead.
+
   Features:
   • Execute subflows by scoped name
   • Pass input values as JSON
@@ -1993,7 +2155,59 @@ EXAMPLES
     $ nex flow subflow --name x_myapp.process_record --inputs '{"table":"incident","sys_id":"abc123"}' --auth dev
 ```
 
-_See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/flow/subflow.ts)_
+_See code: [src/commands/flow/subflow.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/subflow.ts)_
+
+## `nex flow test`
+
+Test a Flow Designer flow without requiring it to be published.
+
+```
+USAGE
+  $ nex flow test -f <value> -o <value> [-j] [-a <value>] [--log-level debug|warn|error|info|trace] [--scope
+    <value>] [--synchronous]
+
+FLAGS
+  -a, --auth=<value>        Auth alias to use.
+  -f, --flow-id=<value>     (required) Flow sys_id or scoped name (e.g. x_myapp.my_flow)
+  -j, --json                Output results as JSON
+  -o, --output-map=<value>  (required) JSON mapping of trigger output variable names to test values (e.g.
+                            '{"current":"<sys_id>","table_name":"change_request"}')
+      --scope=<value>       Scope sys_id for transaction scope (auto-resolved from flow definition if omitted)
+      --[no-]synchronous    Run test synchronously (default: true)
+
+GLOBAL FLAGS
+  --log-level=<option>  [default: info] Specify level for logging.
+                        <options: debug|warn|error|info|trace>
+
+DESCRIPTION
+  Test a Flow Designer flow without requiring it to be published.
+
+  Invokes the same API as the "Test" button in Flow Designer, running the flow in its current saved (draft) state.
+  Unlike `flow run` which requires a published flow and uses sn_fd.FlowAPI, `flow test` works on unpublished drafts via
+  the ProcessFlow REST API.
+
+  Features:
+  • Test flows by sys_id or scoped name
+  • Pass trigger output values as JSON via --output-map
+  • Auto-resolves scope from flow definition if not provided
+  • Synchronous or asynchronous execution
+
+EXAMPLES
+  Test a flow by sys_id
+
+    $ nex flow test --flow-id 887dda5583237210fdb8f7b6feaad32c --output-map \
+      '{"current":"0ecd7552db252200a6a2b31be0b8f5e6","table_name":"change_request"}' --auth dev
+
+  Test a flow by scoped name with explicit scope
+
+    $ nex flow test -f x_myapp.my_flow -o '{"current":"abc123","table_name":"incident"}' --scope x_myapp --auth dev
+
+  Test with JSON output
+
+    $ nex flow test -f 887dda5583237210fdb8f7b6feaad32c -o '{"current":"abc123"}' --json --auth dev
+```
+
+_See code: [src/commands/flow/test.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/flow/test.ts)_
 
 ## `nex health check`
 
@@ -2053,7 +2267,7 @@ EXAMPLES
     $ nex health check --json --auth dev
 ```
 
-_See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/health/check.ts)_
+_See code: [src/commands/health/check.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/health/check.ts)_
 
 ## `nex help [COMMAND]`
 
@@ -2178,7 +2392,7 @@ EXAMPLES
     $ nex log --no-color --auth dev-instance
 ```
 
-_See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/log/index.ts)_
+_See code: [src/commands/log/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/log/index.ts)_
 
 ## `nex plugins`
 
@@ -2520,7 +2734,7 @@ EXAMPLES
     $ nex query --table sys_user --query "active=true" --limit 5 --json --auth dev
 ```
 
-_See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/query/index.ts)_
+_See code: [src/commands/query/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/query/index.ts)_
 
 ## `nex query app`
 
@@ -2562,7 +2776,7 @@ EXAMPLES
     $ nex query app --search "HR" --active --auth dev
 ```
 
-_See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/query/app.ts)_
+_See code: [src/commands/query/app.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/query/app.ts)_
 
 ## `nex query columns`
 
@@ -2606,7 +2820,7 @@ EXAMPLES
     $ nex query columns --table incident --json --auth dev
 ```
 
-_See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/query/columns.ts)_
+_See code: [src/commands/query/columns.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/query/columns.ts)_
 
 ## `nex query syslog`
 
@@ -2652,7 +2866,7 @@ EXAMPLES
     $ nex query syslog --query "sourceLIKEincident" --json --auth dev
 ```
 
-_See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/query/syslog.ts)_
+_See code: [src/commands/query/syslog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/query/syslog.ts)_
 
 ## `nex schema`
 
@@ -2700,7 +2914,7 @@ EXAMPLES
     $ nex schema --table incident --include-choices --include-relationships --auth dev
 ```
 
-_See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/schema/index.ts)_
+_See code: [src/commands/schema/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/schema/index.ts)_
 
 ## `nex schema field`
 
@@ -2736,7 +2950,7 @@ EXAMPLES
     $ nex schema field --table incident --field priority --json --auth dev
 ```
 
-_See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/schema/field.ts)_
+_See code: [src/commands/schema/field.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/schema/field.ts)_
 
 ## `nex schema validate-catalog`
 
@@ -2771,7 +2985,7 @@ EXAMPLES
     $ nex schema validate-catalog --sys-id a1b2c3d4e5f6 --json --auth dev
 ```
 
-_See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/schema/validate-catalog.ts)_
+_See code: [src/commands/schema/validate-catalog.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/schema/validate-catalog.ts)_
 
 ## `nex scope`
 
@@ -2807,7 +3021,7 @@ EXAMPLES
     $ nex scope -l --json --auth dev
 ```
 
-_See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/scope/index.ts)_
+_See code: [src/commands/scope/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/scope/index.ts)_
 
 ## `nex scope set`
 
@@ -2839,7 +3053,7 @@ EXAMPLES
     $ nex scope set -a abc123def456ghi789jkl012mno345pq --json --auth dev
 ```
 
-_See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/scope/set.ts)_
+_See code: [src/commands/scope/set.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/scope/set.ts)_
 
 ## `nex script-sync pull`
 
@@ -2888,7 +3102,7 @@ EXAMPLES
     $ nex script-sync pull -n MyClientScript -t sys_script_client --json --auth dev-instance
 ```
 
-_See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/script-sync/pull.ts)_
+_See code: [src/commands/script-sync/pull.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/script-sync/pull.ts)_
 
 ## `nex script-sync push`
 
@@ -2938,7 +3152,7 @@ EXAMPLES
     $ nex script-sync push -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --auth dev-instance
 ```
 
-_See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/script-sync/push.ts)_
+_See code: [src/commands/script-sync/push.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/script-sync/push.ts)_
 
 ## `nex script-sync sync`
 
@@ -2986,7 +3200,7 @@ EXAMPLES
     $ nex script-sync sync -d ./scripts --json --auth dev-instance
 ```
 
-_See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/script-sync/sync.ts)_
+_See code: [src/commands/script-sync/sync.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/script-sync/sync.ts)_
 
 ## `nex search`
 
@@ -3042,7 +3256,7 @@ EXAMPLES
     $ nex search --term "GlideRecord" --limit 10 --json --auth dev-instance
 ```
 
-_See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/search/index.ts)_
+_See code: [src/commands/search/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/search/index.ts)_
 
 ## `nex search add-table`
 
@@ -3092,7 +3306,7 @@ EXAMPLES
       dev-instance
 ```
 
-_See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/search/add-table.ts)_
+_See code: [src/commands/search/add-table.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/search/add-table.ts)_
 
 ## `nex search groups`
 
@@ -3130,7 +3344,7 @@ EXAMPLES
     $ nex search groups --json --auth dev-instance
 ```
 
-_See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/search/groups.ts)_
+_See code: [src/commands/search/groups.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/search/groups.ts)_
 
 ## `nex search tables`
 
@@ -3170,7 +3384,7 @@ EXAMPLES
     $ nex search tables --search-group "Business Rules" --json --auth dev-instance
 ```
 
-_See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/search/tables.ts)_
+_See code: [src/commands/search/tables.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/search/tables.ts)_
 
 ## `nex store install`
 
@@ -3212,7 +3426,7 @@ EXAMPLES
     $ nex store install -a abc123 -v 1.0.0 --demo-data --auth dev
 ```
 
-_See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/store/install.ts)_
+_See code: [src/commands/store/install.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/store/install.ts)_
 
 ## `nex store search`
 
@@ -3252,7 +3466,7 @@ EXAMPLES
     $ nex store search --tab updates --limit 10 --auth dev
 ```
 
-_See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/store/search.ts)_
+_See code: [src/commands/store/search.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/store/search.ts)_
 
 ## `nex store update`
 
@@ -3293,7 +3507,7 @@ EXAMPLES
     $ nex store update -a abc123 -v 2.0.0 --timeout 3600000 --auth dev
 ```
 
-_See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/store/update.ts)_
+_See code: [src/commands/store/update.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/store/update.ts)_
 
 ## `nex store validate`
 
@@ -3321,7 +3535,7 @@ EXAMPLES
     $ nex store validate --file ./batch-definition.json --auth dev
 ```
 
-_See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/store/validate.ts)_
+_See code: [src/commands/store/validate.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/store/validate.ts)_
 
 ## `nex task approve`
 
@@ -3361,7 +3575,7 @@ EXAMPLES
     $ nex task approve -n CHG0010001 -c "Looks good, approved" --auth dev
 ```
 
-_See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/task/approve.ts)_
+_See code: [src/commands/task/approve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/task/approve.ts)_
 
 ## `nex task assign`
 
@@ -3411,7 +3625,7 @@ EXAMPLES
     $ nex task assign --number CHG0010001 --table change_request --user admin --auth dev
 ```
 
-_See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/task/assign.ts)_
+_See code: [src/commands/task/assign.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/task/assign.ts)_
 
 ## `nex task close`
 
@@ -3454,7 +3668,7 @@ EXAMPLES
     $ nex task close -n INC0010001 --notes "Closed" --close-code "Solved (Permanently)" --auth dev
 ```
 
-_See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/task/close.ts)_
+_See code: [src/commands/task/close.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/task/close.ts)_
 
 ## `nex task comment`
 
@@ -3503,7 +3717,7 @@ EXAMPLES
     $ nex task comment --number CHG0010001 --table change_request --comment "Approved" --auth dev
 ```
 
-_See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/task/comment.ts)_
+_See code: [src/commands/task/comment.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/task/comment.ts)_
 
 ## `nex task find`
 
@@ -3548,7 +3762,7 @@ EXAMPLES
     $ nex task find -n INC0010001 --json --auth dev
 ```
 
-_See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/task/find.ts)_
+_See code: [src/commands/task/find.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/task/find.ts)_
 
 ## `nex task resolve`
 
@@ -3591,7 +3805,7 @@ EXAMPLES
     $ nex task resolve -n INC0010001 --notes "Fixed" --close-code "Solved (Permanently)" --auth dev
 ```
 
-_See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/task/resolve.ts)_
+_See code: [src/commands/task/resolve.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/task/resolve.ts)_
 
 ## `nex update-set`
 
@@ -3628,7 +3842,7 @@ EXAMPLES
     $ nex update-set --json --auth dev-instance
 ```
 
-_See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/update-set/index.ts)_
+_See code: [src/commands/update-set/index.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/update-set/index.ts)_
 
 ## `nex update-set clone`
 
@@ -3661,7 +3875,7 @@ EXAMPLES
     $ nex update-set clone --source us-001 --name "Cloned Set" --json --auth dev-instance
 ```
 
-_See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/update-set/clone.ts)_
+_See code: [src/commands/update-set/clone.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/update-set/clone.ts)_
 
 ## `nex update-set create`
 
@@ -3700,7 +3914,7 @@ EXAMPLES
     $ nex update-set create --name "My Feature Set" --application x_my_app --auth dev-instance
 ```
 
-_See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/update-set/create.ts)_
+_See code: [src/commands/update-set/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/update-set/create.ts)_
 
 ## `nex update-set current`
 
@@ -3736,7 +3950,7 @@ EXAMPLES
     $ nex update-set current --json --auth dev-instance
 ```
 
-_See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/update-set/current.ts)_
+_See code: [src/commands/update-set/current.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/update-set/current.ts)_
 
 ## `nex update-set inspect`
 
@@ -3768,7 +3982,7 @@ EXAMPLES
     $ nex update-set inspect --sys-id us-001 --json --auth dev-instance
 ```
 
-_See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/update-set/inspect.ts)_
+_See code: [src/commands/update-set/inspect.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/update-set/inspect.ts)_
 
 ## `nex update-set move`
 
@@ -3807,7 +4021,7 @@ EXAMPLES
     $ nex update-set move --target us-002 --source us-001 --json --auth dev-instance
 ```
 
-_See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/update-set/move.ts)_
+_See code: [src/commands/update-set/move.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/update-set/move.ts)_
 
 ## `nex workflow create`
 
@@ -3839,7 +4053,7 @@ EXAMPLES
     $ nex workflow create -s ./workflow.json --json --auth dev
 ```
 
-_See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/workflow/create.ts)_
+_See code: [src/commands/workflow/create.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/workflow/create.ts)_
 
 ## `nex workflow publish`
 
@@ -3872,7 +4086,7 @@ EXAMPLES
     $ nex workflow publish -v wfv-001 -s act-001 --json --auth dev
 ```
 
-_See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/workflow/publish.ts)_
+_See code: [src/commands/workflow/publish.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/workflow/publish.ts)_
 
 ## `nex xml export`
 
@@ -3919,7 +4133,7 @@ EXAMPLES
     $ nex xml export --table sys_script --sys-id abc123 --json --auth dev
 ```
 
-_See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/xml/export.ts)_
+_See code: [src/commands/xml/export.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/xml/export.ts)_
 
 ## `nex xml import`
 
@@ -3960,7 +4174,7 @@ EXAMPLES
     $ nex xml import --file ./records.xml --table incident --json --auth dev
 ```
 
-_See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.0.1/src/commands/xml/import.ts)_
+_See code: [src/commands/xml/import.ts](https://github.com/sonisoft-cnanda/now-sdk-ext-cli/blob/v2.3.0/src/commands/xml/import.ts)_
 <!-- commandsstop -->
 
 ---