@sonisoft/now-sdk-ext-cli 5.4.0 → 5.6.0

package/oclif.manifest.json

@@ -513,240 +513,6 @@
         "query.js"
       ]
     },
-    "atf": {
-      "aliases": [],
-      "args": {},
-      "description": "Execute ATF (Automated Test Framework) tests or test suites on a ServiceNow instance.\n\nThis command allows you to run automated tests and test suites remotely, making it perfect for CI/CD pipelines and automated testing workflows. You can execute individual tests, entire test suites, and configure execution parameters such as browser type, OS, and performance mode.\n\nFeatures:\n  • Execute individual tests or complete test suites\n  • Real-time progress monitoring\n  • JSON output for CI/CD integration\n  • Detailed test results and summaries\n  • Browser and environment configuration\n  • Performance testing mode support",
-      "examples": [
-        {
-          "description": "Execute a single ATF test by sys_id",
-          "command": "<%= config.bin %> <%= command.id %> --test-id f717a8c783103210621e78c6feaad396 --auth dev-instance"
-        },
-        {
-          "description": "Execute a test suite by sys_id and wait for completion",
-          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --auth dev-instance --wait"
-        },
-        {
-          "description": "Execute a test suite by name",
-          "command": "<%= config.bin %> <%= command.id %> --suite-name \"Smoke Tests\" --auth dev-instance"
-        },
-        {
-          "description": "Execute with specific browser configuration",
-          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --browser chrome --auth dev-instance"
-        },
-        {
-          "description": "Execute as performance test with JSON output for CI/CD",
-          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --performance --json --auth dev-instance"
-        },
-        {
-          "description": "Execute with custom poll interval (10 seconds)",
-          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance"
-        }
-      ],
-      "flags": {
-        "json": {
-          "char": "j",
-          "description": "Output results as JSON",
-          "name": "json",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "auth": {
-          "char": "a",
-          "description": "Auth alias to use.",
-          "name": "auth",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cred-store": {
-          "description": "Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.",
-          "helpGroup": "GLOBAL",
-          "name": "cred-store",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deny-execute": {
-          "description": "Refuse background scripts, flow runs and ATF runs for this invocation.",
-          "helpGroup": "GLOBAL",
-          "name": "deny-execute",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deny-write": {
-          "description": "Refuse any change to instance data for this invocation.",
-          "helpGroup": "GLOBAL",
-          "name": "deny-write",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "log-dir": {
-          "description": "Directory to write log files to. Implies --log-file.",
-          "helpGroup": "GLOBAL",
-          "name": "log-dir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "log-file": {
-          "description": "Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to stderr only.",
-          "helpGroup": "GLOBAL",
-          "name": "log-file",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "log-level": {
-          "helpGroup": "GLOBAL",
-          "name": "log-level",
-          "summary": "Specify level for logging.",
-          "default": "info",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "debug",
-            "warn",
-            "error",
-            "info",
-            "trace"
-          ],
-          "type": "option"
-        },
-        "read-only": {
-          "description": "Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are unaffected.",
-          "helpGroup": "GLOBAL",
-          "name": "read-only",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "test-id": {
-          "char": "t",
-          "description": "Test sys_id to execute",
-          "exclusive": [
-            "suite-id",
-            "suite-name"
-          ],
-          "name": "test-id",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "suite-id": {
-          "char": "s",
-          "description": "Test Suite sys_id to execute",
-          "exclusive": [
-            "test-id",
-            "suite-name"
-          ],
-          "name": "suite-id",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "suite-name": {
-          "char": "n",
-          "description": "Test Suite name to execute",
-          "exclusive": [
-            "test-id",
-            "suite-id"
-          ],
-          "name": "suite-name",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "char": "w",
-          "description": "Wait for test suite execution to complete and return results",
-          "name": "wait",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "poll-interval": {
-          "char": "p",
-          "description": "Polling interval in milliseconds when waiting for completion",
-          "name": "poll-interval",
-          "required": false,
-          "default": 5000,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "browser": {
-          "char": "b",
-          "description": "Browser name for test execution (e.g., chrome, firefox)",
-          "name": "browser",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "browser-version": {
-          "description": "Browser version for test execution",
-          "name": "browser-version",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "os-name": {
-          "description": "Operating system name for test execution",
-          "name": "os-name",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "os-version": {
-          "description": "Operating system version for test execution",
-          "name": "os-version",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "performance": {
-          "description": "Run as performance test",
-          "name": "performance",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "cloud": {
-          "description": "Run in cloud",
-          "name": "cloud",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "atf",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "atf",
-        "index.js"
-      ]
-    },
     "app": {
       "aliases": [],
       "args": {},
@@ -1471,29 +1237,263 @@
         "uninstall.js"
       ]
     },
-    "attachment:get": {
+    "atf": {
       "aliases": [],
       "args": {},
-      "description": "Get metadata for a specific attachment.",
+      "description": "Execute ATF (Automated Test Framework) tests or test suites on a ServiceNow instance.\n\nThis command allows you to run automated tests and test suites remotely, making it perfect for CI/CD pipelines and automated testing workflows. You can execute individual tests, entire test suites, and configure execution parameters such as browser type, OS, and performance mode.\n\nFeatures:\n  • Execute individual tests or complete test suites\n  • Real-time progress monitoring\n  • JSON output for CI/CD integration\n  • Detailed test results and summaries\n  • Browser and environment configuration\n  • Performance testing mode support",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --sys-id att123 --auth dev",
-          "description": "Get attachment metadata by sys_id"
+          "description": "Execute a single ATF test by sys_id",
+          "command": "<%= config.bin %> <%= command.id %> --test-id f717a8c783103210621e78c6feaad396 --auth dev-instance"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -s att123 --json --auth dev",
-          "description": "Get attachment metadata as JSON"
-        }
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+          "description": "Execute a test suite by sys_id and wait for completion",
+          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --auth dev-instance --wait"
         },
-        "auth": {
+        {
+          "description": "Execute a test suite by name",
+          "command": "<%= config.bin %> <%= command.id %> --suite-name \"Smoke Tests\" --auth dev-instance"
+        },
+        {
+          "description": "Execute with specific browser configuration",
+          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --browser chrome --auth dev-instance"
+        },
+        {
+          "description": "Execute as performance test with JSON output for CI/CD",
+          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --performance --json --auth dev-instance"
+        },
+        {
+          "description": "Execute with custom poll interval (10 seconds)",
+          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance"
+        }
+      ],
+      "flags": {
+        "json": {
+          "char": "j",
+          "description": "Output results as JSON",
+          "name": "json",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth": {
+          "char": "a",
+          "description": "Auth alias to use.",
+          "name": "auth",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cred-store": {
+          "description": "Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.",
+          "helpGroup": "GLOBAL",
+          "name": "cred-store",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deny-execute": {
+          "description": "Refuse background scripts, flow runs and ATF runs for this invocation.",
+          "helpGroup": "GLOBAL",
+          "name": "deny-execute",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deny-write": {
+          "description": "Refuse any change to instance data for this invocation.",
+          "helpGroup": "GLOBAL",
+          "name": "deny-write",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-dir": {
+          "description": "Directory to write log files to. Implies --log-file.",
+          "helpGroup": "GLOBAL",
+          "name": "log-dir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "log-file": {
+          "description": "Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to stderr only.",
+          "helpGroup": "GLOBAL",
+          "name": "log-file",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-level": {
+          "helpGroup": "GLOBAL",
+          "name": "log-level",
+          "summary": "Specify level for logging.",
+          "default": "info",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "debug",
+            "warn",
+            "error",
+            "info",
+            "trace"
+          ],
+          "type": "option"
+        },
+        "read-only": {
+          "description": "Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are unaffected.",
+          "helpGroup": "GLOBAL",
+          "name": "read-only",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "test-id": {
+          "char": "t",
+          "description": "Test sys_id to execute",
+          "exclusive": [
+            "suite-id",
+            "suite-name"
+          ],
+          "name": "test-id",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "suite-id": {
+          "char": "s",
+          "description": "Test Suite sys_id to execute",
+          "exclusive": [
+            "test-id",
+            "suite-name"
+          ],
+          "name": "suite-id",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "suite-name": {
+          "char": "n",
+          "description": "Test Suite name to execute",
+          "exclusive": [
+            "test-id",
+            "suite-id"
+          ],
+          "name": "suite-name",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "char": "w",
+          "description": "Wait for test suite execution to complete and return results",
+          "name": "wait",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "poll-interval": {
+          "char": "p",
+          "description": "Polling interval in milliseconds when waiting for completion",
+          "name": "poll-interval",
+          "required": false,
+          "default": 5000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "browser": {
+          "char": "b",
+          "description": "Browser name for test execution (e.g., chrome, firefox)",
+          "name": "browser",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "browser-version": {
+          "description": "Browser version for test execution",
+          "name": "browser-version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "os-name": {
+          "description": "Operating system name for test execution",
+          "name": "os-name",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "os-version": {
+          "description": "Operating system version for test execution",
+          "name": "os-version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "performance": {
+          "description": "Run as performance test",
+          "name": "performance",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cloud": {
+          "description": "Run in cloud",
+          "name": "cloud",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "atf",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "atf",
+        "index.js"
+      ]
+    },
+    "attachment:get": {
+      "aliases": [],
+      "args": {},
+      "description": "Get metadata for a specific attachment.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --sys-id att123 --auth dev",
+          "description": "Get attachment metadata by sys_id"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -s att123 --json --auth dev",
+          "description": "Get attachment metadata as JSON"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth": {
           "char": "a",
           "description": "Auth alias to use.",
           "name": "auth",
@@ -1881,19 +1881,77 @@
         "upload.js"
       ]
     },
-    "auth:delete": {
+    "auth:browser-session": {
       "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Alias to remove",
-          "name": "alias",
-          "required": false
-        }
-      },
-      "description": "Remove a credential from the store.\n\nThis does not touch the OS keyring — a copy stored there before migrating remains.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> dev206299",
+      "args": {},
+      "description": "Create a verified Playwright cookie session using a stored SDK alias.",
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth": {
+          "char": "a",
+          "description": "Stored SDK credential alias.",
+          "name": "auth",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cred-store": {
+          "description": "Use the headless credential store.",
+          "name": "cred-store",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Replace an existing regular output file.",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "description": "Owner-only Playwright storage-state file.",
+          "name": "output",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:browser-session",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "browser-session.js"
+      ]
+    },
+    "auth:delete": {
+      "aliases": [],
+      "args": {
+        "alias": {
+          "description": "Alias to remove",
+          "name": "alias",
+          "required": false
+        }
+      },
+      "description": "Remove a credential from the store.\n\nThis does not touch the OS keyring — a copy stored there before migrating remains.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> dev206299",
           "description": "Remove one alias"
         },
         {
@@ -2070,24 +2128,16 @@
         "use.js"
       ]
     },
-    "batch:create": {
+    "behavior:details": {
       "aliases": [],
       "args": {},
-      "description": "Batch create records on a ServiceNow instance from a JSON file.",
+      "description": "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>.",
       "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --auth dev",
-          "description": "Create records from a JSON file"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --no-transaction --auth dev",
-          "description": "Create records without transactional mode"
-        }
+        "<%= config.bin %> <%= command.id %> --reference business_rules:sys_script:0123456789abcdef0123456789abcdef --details scripts --auth dev --json"
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "description": "Emit one JSON document",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
@@ -2166,26 +2216,53 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file with create operations",
-          "name": "file",
-          "required": true,
+        "dependency-depth": {
+          "description": "Expand one dependency level; requires --details dependencies",
+          "name": "dependency-depth",
+          "default": 0,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "transaction": {
-          "description": "Stop on first error (transactional)",
-          "name": "transaction",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
+        "details": {
+          "description": "Include selected detail now; repeat for multiple kinds",
+          "name": "details",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "scripts",
+            "definitions",
+            "dependencies"
+          ],
+          "type": "option"
+        },
+        "max-bytes": {
+          "description": "Maximum JSON response bytes; omissions include retrieval references",
+          "name": "max-bytes",
+          "default": 65536,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Transaction scope for flow definition reads",
+          "name": "scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "reference": {
+          "description": "kind:source_table:sys_id; repeat for a batch",
+          "name": "reference",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "batch:create",
+      "id": "behavior:details",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2195,28 +2272,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "batch",
-        "create.js"
+        "behavior",
+        "details.js"
       ]
     },
-    "batch:update": {
+    "behavior": {
       "aliases": [],
       "args": {},
-      "description": "Batch update records on a ServiceNow instance from a JSON file.",
+      "description": "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.",
       "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --auth dev",
-          "description": "Update records from a JSON file"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --stop-on-error --auth dev",
-          "description": "Update records and stop on first error"
-        }
+        "<%= config.bin %> <%= command.id %> --table incident --auth dev --json",
+        "<%= config.bin %> <%= command.id %> --table change_request --category business_rules --details scripts --auth dev --json"
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "description": "Emit one JSON document",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
@@ -2295,26 +2365,112 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file with update operations",
-          "name": "file",
-          "required": true,
+        "dependency-depth": {
+          "description": "Expand one dependency level; requires --details dependencies",
+          "name": "dependency-depth",
+          "default": 0,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "stop-on-error": {
-          "description": "Stop processing on first error",
-          "name": "stop-on-error",
-          "required": false,
+        "details": {
+          "description": "Include selected detail now; repeat for multiple kinds",
+          "name": "details",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "scripts",
+            "definitions",
+            "dependencies"
+          ],
+          "type": "option"
+        },
+        "max-bytes": {
+          "description": "Maximum JSON response bytes; omissions include retrieval references",
+          "name": "max-bytes",
+          "default": 65536,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Transaction scope for flow definition reads",
+          "name": "scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "category": {
+          "description": "Category to inspect; repeat to select several, default all",
+          "name": "category",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "business_rules",
+            "ui_actions",
+            "client_scripts",
+            "ui_policies",
+            "data_policies",
+            "workflows",
+            "flows",
+            "state_models"
+          ],
+          "type": "option"
+        },
+        "cursor": {
+          "description": "Continuation token; requires exactly one --category and the same filters",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "include-inactive": {
+          "description": "Include inactive/published and draft candidates when discoverable",
+          "name": "include-inactive",
           "allowNo": false,
           "type": "boolean"
+        },
+        "include-inherited": {
+          "description": "Include applicable ancestor behavior",
+          "name": "include-inherited",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Maximum items per category",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Metadata name contains this text",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sys-id": {
+          "description": "Metadata source sys_id to include; repeat for multiple records",
+          "name": "sys-id",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "table": {
+          "char": "t",
+          "description": "Target table name",
+          "name": "table",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "batch:update",
+      "id": "behavior",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2324,38 +2480,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "batch",
-        "update.js"
+        "behavior",
+        "index.js"
       ]
     },
-    "bulk:delete": {
+    "batch:create": {
       "aliases": [],
       "args": {},
-      "description": "Bulk delete records matching an encoded query.\n\nFinds all records in a table matching the given query, then deletes each one. Defaults to dry-run mode — use --confirm to execute.\n\nFeatures:\n  • Safe dry-run by default (shows match count without deleting)\n  • Encoded query filtering\n  • Configurable record limit (default 200, max 10000)\n  • Progress reporting for large operations\n  • Error collection — operation continues even if individual records fail",
+      "description": "Batch create records on a ServiceNow instance from a JSON file.",
       "examples": [
         {
-          "description": "Dry run — see how many records would be deleted",
-          "command": "<%= config.bin %> <%= command.id %> --table u_temp_import --query \"sys_created_on<2024-01-01\" --auth dev"
-        },
-        {
-          "description": "Execute the delete (requires --confirm)",
-          "command": "<%= config.bin %> <%= command.id %> --table u_temp_import --query \"sys_created_on<2024-01-01\" --confirm --auth dev"
-        },
-        {
-          "description": "Delete with custom limit",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"active=false^closed_at<2023-01-01\" --limit 1000 --confirm --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --auth dev",
+          "description": "Create records from a JSON file"
         },
         {
-          "description": "Delete as JSON output",
-          "command": "<%= config.bin %> <%= command.id %> --table u_staging --query \"processed=true\" --confirm --json --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --no-transaction --auth dev",
+          "description": "Create records without transactional mode"
         }
       ],
       "flags": {
         "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
-          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -2433,45 +2580,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "table": {
-          "char": "t",
-          "description": "Table name to delete records from",
-          "name": "table",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "query": {
-          "char": "q",
-          "description": "Encoded query to match records for deletion",
-          "name": "query",
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file with create operations",
+          "name": "file",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "confirm": {
-          "description": "Execute the delete (without this flag, performs a dry run)",
-          "name": "confirm",
+        "transaction": {
+          "description": "Stop on first error (transactional)",
+          "name": "transaction",
           "required": false,
           "allowNo": false,
           "type": "boolean"
-        },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of records to delete (default 200, max 10000)",
-          "name": "limit",
-          "required": false,
-          "default": 200,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "bulk:delete",
+      "id": "batch:create",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2481,38 +2609,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "bulk",
-        "delete.js"
+        "batch",
+        "create.js"
       ]
     },
-    "bulk:update": {
+    "batch:update": {
       "aliases": [],
       "args": {},
-      "description": "Bulk update records matching an encoded query.\n\nFinds all records in a table matching the given query, then applies field updates to each one. Defaults to dry-run mode — use --confirm to execute.\n\nFeatures:\n  • Safe dry-run by default (shows match count without modifying data)\n  • Encoded query filtering\n  • JSON field=value pairs for update data\n  • Configurable record limit (default 200, max 10000)\n  • Progress reporting for large operations\n  • Error collection — operation continues even if individual records fail",
+      "description": "Batch update records on a ServiceNow instance from a JSON file.",
       "examples": [
         {
-          "description": "Dry run — see how many records would be updated",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"active=true^priority=5\" --data '{\"priority\":\"4\"}' --auth dev"
-        },
-        {
-          "description": "Execute the update (requires --confirm)",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"active=true^priority=5\" --data '{\"priority\":\"4\"}' --confirm --auth dev"
-        },
-        {
-          "description": "Update with custom limit",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"state=1\" --data '{\"assignment_group\":\"group-sys-id\"}' --limit 500 --confirm --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --auth dev",
+          "description": "Update records from a JSON file"
         },
         {
-          "description": "Update as JSON output",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"active=true\" --data '{\"state\":\"6\"}' --confirm --json --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --stop-on-error --auth dev",
+          "description": "Update records and stop on first error"
         }
       ],
       "flags": {
         "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
-          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -2590,54 +2709,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "table": {
-          "char": "t",
-          "description": "Table name to update records in",
-          "name": "table",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "query": {
-          "char": "q",
-          "description": "Encoded query to match records",
-          "name": "query",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "data": {
-          "char": "d",
-          "description": "JSON object of field=value pairs to apply (e.g. '{\"priority\":\"4\",\"state\":\"2\"}')",
-          "name": "data",
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file with update operations",
+          "name": "file",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "confirm": {
-          "description": "Execute the update (without this flag, performs a dry run)",
-          "name": "confirm",
+        "stop-on-error": {
+          "description": "Stop processing on first error",
+          "name": "stop-on-error",
           "required": false,
           "allowNo": false,
           "type": "boolean"
-        },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of records to update (default 200, max 10000)",
-          "name": "limit",
-          "required": false,
-          "default": 200,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "bulk:update",
+      "id": "batch:update",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2647,72 +2738,38 @@
       "relativePath": [
         "dist",
         "commands",
-        "bulk",
+        "batch",
         "update.js"
       ]
     },
-    "exec": {
+    "bulk:delete": {
       "aliases": [],
-      "args": {
-        "scope": {
-          "description": "Scope to execute script in. Use \"global\" for global scope.",
-          "name": "scope",
-          "required": true
-        },
-        "file": {
-          "description": "File to execute in scripts background. If omitted, starts REPL mode.",
-          "name": "file",
-          "required": false
-        }
-      },
-      "description": "Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.\n\nThis command allows you to run JavaScript either from files or interactively via REPL mode. It mimics the functionality of the Scripts - Background interface in ServiceNow, providing a way to execute scripts programmatically without manual interaction. The output is returned in real-time and can be piped to other commands or saved to files.\n\nModes:\n  • File Mode: Provide a file path to execute scripts from a file\n  • REPL Mode: Omit the file path to start an interactive session\n\nFeatures:\n  • Execute local JavaScript files remotely\n  • Interactive REPL for ad-hoc script execution\n  • Script parameterization with {placeholder} replacement\n  • Multi-line script support in REPL\n  • Scope-aware execution (global or custom scope)\n  • Real-time console output capture\n  • Pipe-able output for command chaining\n  • Debug logging support\n  • Useful for data migration, testing, and administrative tasks\n\nScript Parameterization:\n  Use {paramName} placeholders in your script files, then provide values via --params:\n  • Supports any JSON-serializable values (strings, numbers, booleans)\n  • Multiple parameters supported\n  • All occurrences of each placeholder are replaced\n  • Example: {token}, {username}, {environment}\n\nREPL Controls:\n  • Press Enter to add a new line\n  • Type .exec or press Ctrl+D to execute the script\n  • Type .clear to clear the current input\n  • Type .exit or press Ctrl+C twice to exit REPL\n\n⚠️  IMPORTANT SECURITY WARNING:\nThis command executes scripts with the same permissions and risks as using Scripts - Background directly\nin ServiceNow. Always:\n  • Review scripts before execution\n  • Test in non-production environments first\n  • Use appropriate scoping to limit access\n  • Be aware of data modification risks\n  • Follow your organization's security policies\n  • Never execute untrusted scripts\n\nScript Capabilities:\n  Scripts run with full GlideSystem API access and can:\n  • Query and modify database records\n  • Create, update, and delete data\n  • Execute business rules and workflows\n  • Access all APIs available in Scripts - Background\n  • Use gs, GlideRecord, GlideAggregate, and other server-side APIs",
+      "args": {},
+      "description": "Bulk delete records matching an encoded query.\n\nFinds all records in a table matching the given query, then deletes each one. Defaults to dry-run mode — use --confirm to execute.\n\nFeatures:\n  • Safe dry-run by default (shows match count without deleting)\n  • Encoded query filtering\n  • Configurable record limit (default 200, max 10000)\n  • Progress reporting for large operations\n  • Error collection — operation continues even if individual records fail",
       "examples": [
         {
-          "description": "Start REPL in global scope",
-          "command": "<%= config.bin %> <%= command.id %> global --auth dev-instance"
-        },
-        {
-          "description": "Start REPL in custom application scope",
-          "command": "<%= config.bin %> <%= command.id %> x_my_custom_app --auth dev-instance"
-        },
-        {
-          "description": "Execute a script file in global scope",
-          "command": "<%= config.bin %> <%= command.id %> global ./scripts/cleanup.js --auth dev-instance"
-        },
-        {
-          "description": "Execute a script file in a custom application scope",
-          "command": "<%= config.bin %> <%= command.id %> x_my_custom_app ./scripts/app-config.js --auth dev-instance"
-        },
-        {
-          "description": "Execute a parameterized script with single parameter",
-          "command": "<%= config.bin %> <%= command.id %> global ./scripts/query-user.js --auth dev-instance --params '{\"username\":\"admin\"}'"
-        },
-        {
-          "description": "Execute a parameterized script with multiple parameters",
-          "command": "<%= config.bin %> <%= command.id %> global ./scripts/update-record.js --auth dev-instance --params '{\"table\":\"incident\",\"field\":\"priority\",\"value\":\"1\"}'"
-        },
-        {
-          "description": "Execute and save output to a file",
-          "command": "<%= config.bin %> <%= command.id %> global ./scripts/report.js --auth dev-instance > report.txt"
+          "description": "Dry run — see how many records would be deleted",
+          "command": "<%= config.bin %> <%= command.id %> --table u_temp_import --query \"sys_created_on<2024-01-01\" --auth dev"
         },
         {
-          "description": "Execute and pipe output to grep for filtering",
-          "command": "<%= config.bin %> <%= command.id %> global ./scripts/list-users.js --auth dev-instance | grep \"admin\""
+          "description": "Execute the delete (requires --confirm)",
+          "command": "<%= config.bin %> <%= command.id %> --table u_temp_import --query \"sys_created_on<2024-01-01\" --confirm --auth dev"
         },
         {
-          "description": "Execute with debug logging to troubleshoot issues",
-          "command": "<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --log-level debug"
+          "description": "Delete with custom limit",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"active=false^closed_at<2023-01-01\" --limit 1000 --confirm --auth dev"
         },
         {
-          "description": "Execute with parameters for template replacement",
-          "command": "<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --params '{\"token\":\"abc123\",\"env\":\"dev\"}'"
+          "description": "Delete as JSON output",
+          "command": "<%= config.bin %> <%= command.id %> --table u_staging --query \"processed=true\" --confirm --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -2790,11 +2847,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "params": {
-          "char": "p",
-          "description": "JSON object of parameters to replace in script file. Use {paramName} syntax in your script.",
-          "name": "params",
+        "table": {
+          "char": "t",
+          "description": "Table name to delete records from",
+          "name": "table",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "query": {
+          "char": "q",
+          "description": "Encoded query to match records for deletion",
+          "name": "query",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "confirm": {
+          "description": "Execute the delete (without this flag, performs a dry run)",
+          "name": "confirm",
           "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of records to delete (default 200, max 10000)",
+          "name": "limit",
+          "required": false,
+          "default": 200,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2802,29 +2885,40 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "exec",
+      "id": "bulk:delete",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "autocomplete": {},
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "exec",
-        "index.js"
+        "bulk",
+        "delete.js"
       ]
     },
-    "flow:action": {
+    "bulk:update": {
       "aliases": [],
       "args": {},
-      "description": "Execute a Flow Designer action by scoped name.\n\nRuns an action using the sn_fd.FlowAPI ScriptableFlowRunner.\n\nFeatures:\n  • Execute actions by scoped name\n  • Pass input values as JSON\n  • Foreground or background execution mode\n  • Returns context ID, outputs, and debug information",
+      "description": "Bulk update records matching an encoded query.\n\nFinds all records in a table matching the given query, then applies field updates to each one. Defaults to dry-run mode — use --confirm to execute.\n\nFeatures:\n  • Safe dry-run by default (shows match count without modifying data)\n  • Encoded query filtering\n  • JSON field=value pairs for update data\n  • Configurable record limit (default 200, max 10000)\n  • Progress reporting for large operations\n  • Error collection — operation continues even if individual records fail",
       "examples": [
         {
-          "description": "Run an action",
-          "command": "<%= config.bin %> <%= command.id %> --name global.create_record --inputs '{\"table\":\"incident\",\"values\":{\"short_description\":\"Test\"}}' --auth dev"
+          "description": "Dry run — see how many records would be updated",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"active=true^priority=5\" --data '{\"priority\":\"4\"}' --auth dev"
+        },
+        {
+          "description": "Execute the update (requires --confirm)",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"active=true^priority=5\" --data '{\"priority\":\"4\"}' --confirm --auth dev"
+        },
+        {
+          "description": "Update with custom limit",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"state=1\" --data '{\"assignment_group\":\"group-sys-id\"}' --limit 500 --confirm --auth dev"
+        },
+        {
+          "description": "Update as JSON output",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --query \"active=true\" --data '{\"state\":\"6\"}' --confirm --json --auth dev"
         }
       ],
       "flags": {
@@ -2910,57 +3004,54 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "char": "n",
-          "description": "Scoped name of the action (e.g. global.create_record)",
-          "name": "name",
+        "table": {
+          "char": "t",
+          "description": "Table name to update records in",
+          "name": "table",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "inputs": {
-          "char": "i",
-          "description": "JSON object of input name-value pairs",
-          "name": "inputs",
-          "required": false,
+        "query": {
+          "char": "q",
+          "description": "Encoded query to match records",
+          "name": "query",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "mode": {
-          "char": "m",
-          "description": "Execution mode",
-          "name": "mode",
-          "required": false,
-          "default": "foreground",
+        "data": {
+          "char": "d",
+          "description": "JSON object of field=value pairs to apply (e.g. '{\"priority\":\"4\",\"state\":\"2\"}')",
+          "name": "data",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "foreground",
-            "background"
-          ],
           "type": "option"
         },
-        "scope": {
-          "description": "Scope context for script execution",
-          "name": "scope",
+        "confirm": {
+          "description": "Execute the update (without this flag, performs a dry run)",
+          "name": "confirm",
           "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of records to update (default 200, max 10000)",
+          "name": "limit",
+          "required": false,
+          "default": 200,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "quick": {
-          "description": "Skip execution detail records for better performance",
-          "name": "quick",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:action",
+      "id": "bulk:update",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2970,30 +3061,72 @@
       "relativePath": [
         "dist",
         "commands",
-        "flow",
-        "action.js"
+        "bulk",
+        "update.js"
       ]
     },
-    "flow:cancel": {
+    "exec": {
       "aliases": [],
-      "args": {},
-      "description": "Cancel a running or paused flow execution.\n\nCancels a flow context that is in QUEUED, IN_PROGRESS, or WAITING state.",
+      "args": {
+        "scope": {
+          "description": "Scope to execute script in. Use \"global\" for global scope.",
+          "name": "scope",
+          "required": true
+        },
+        "file": {
+          "description": "File to execute in scripts background. If omitted, starts REPL mode.",
+          "name": "file",
+          "required": false
+        }
+      },
+      "description": "Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.\n\nThis command allows you to run JavaScript either from files or interactively via REPL mode. It mimics the functionality of the Scripts - Background interface in ServiceNow, providing a way to execute scripts programmatically without manual interaction. The output is returned in real-time and can be piped to other commands or saved to files.\n\nModes:\n  • File Mode: Provide a file path to execute scripts from a file\n  • REPL Mode: Omit the file path to start an interactive session\n\nFeatures:\n  • Execute local JavaScript files remotely\n  • Interactive REPL for ad-hoc script execution\n  • Script parameterization with {placeholder} replacement\n  • Multi-line script support in REPL\n  • Scope-aware execution (global or custom scope)\n  • Real-time console output capture\n  • Pipe-able output for command chaining\n  • Debug logging support\n  • Useful for data migration, testing, and administrative tasks\n\nScript Parameterization:\n  Use {paramName} placeholders in your script files, then provide values via --params:\n  • Supports any JSON-serializable values (strings, numbers, booleans)\n  • Multiple parameters supported\n  • All occurrences of each placeholder are replaced\n  • Example: {token}, {username}, {environment}\n\nREPL Controls:\n  • Press Enter to add a new line\n  • Type .exec or press Ctrl+D to execute the script\n  • Type .clear to clear the current input\n  • Type .exit or press Ctrl+C twice to exit REPL\n\n⚠️  IMPORTANT SECURITY WARNING:\nThis command executes scripts with the same permissions and risks as using Scripts - Background directly\nin ServiceNow. Always:\n  • Review scripts before execution\n  • Test in non-production environments first\n  • Use appropriate scoping to limit access\n  • Be aware of data modification risks\n  • Follow your organization's security policies\n  • Never execute untrusted scripts\n\nScript Capabilities:\n  Scripts run with full GlideSystem API access and can:\n  • Query and modify database records\n  • Create, update, and delete data\n  • Execute business rules and workflows\n  • Access all APIs available in Scripts - Background\n  • Use gs, GlideRecord, GlideAggregate, and other server-side APIs",
       "examples": [
         {
-          "description": "Cancel a running flow",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
+          "description": "Start REPL in global scope",
+          "command": "<%= config.bin %> <%= command.id %> global --auth dev-instance"
         },
         {
-          "description": "Cancel with a reason",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --reason \"No longer needed\" --auth dev"
+          "description": "Start REPL in custom application scope",
+          "command": "<%= config.bin %> <%= command.id %> x_my_custom_app --auth dev-instance"
+        },
+        {
+          "description": "Execute a script file in global scope",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/cleanup.js --auth dev-instance"
+        },
+        {
+          "description": "Execute a script file in a custom application scope",
+          "command": "<%= config.bin %> <%= command.id %> x_my_custom_app ./scripts/app-config.js --auth dev-instance"
+        },
+        {
+          "description": "Execute a parameterized script with single parameter",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/query-user.js --auth dev-instance --params '{\"username\":\"admin\"}'"
+        },
+        {
+          "description": "Execute a parameterized script with multiple parameters",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/update-record.js --auth dev-instance --params '{\"table\":\"incident\",\"field\":\"priority\",\"value\":\"1\"}'"
+        },
+        {
+          "description": "Execute and save output to a file",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/report.js --auth dev-instance > report.txt"
+        },
+        {
+          "description": "Execute and pipe output to grep for filtering",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/list-users.js --auth dev-instance | grep \"admin\""
+        },
+        {
+          "description": "Execute with debug logging to troubleshoot issues",
+          "command": "<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --log-level debug"
+        },
+        {
+          "description": "Execute with parameters for template replacement",
+          "command": "<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --params '{\"token\":\"abc123\",\"env\":\"dev\"}'"
         }
       ],
       "flags": {
         "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
-          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -3071,27 +3204,10 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "context-id": {
-          "char": "c",
-          "description": "Flow execution context sys_id",
-          "name": "context-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "reason": {
-          "char": "r",
-          "description": "Cancellation reason",
-          "name": "reason",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "scope": {
-          "description": "Scope context for script execution",
-          "name": "scope",
+        "params": {
+          "char": "p",
+          "description": "JSON object of parameters to replace in script file. Use {paramName} syntax in your script.",
+          "name": "params",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3100,36 +3216,29 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:cancel",
+      "id": "exec",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "autocomplete": {},
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "flow",
-        "cancel.js"
+        "exec",
+        "index.js"
       ]
     },
-    "flow:copy": {
+    "flow:action": {
       "aliases": [],
       "args": {},
-      "description": "Copy an existing flow into a target scoped application.\n\nThis 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.\n\nEnables the full CLI-driven flow development lifecycle:\n  copy → pull (now-sdk transform) → modify → push → test → publish\n\nFeatures:\n  • Copy flows by sys_id or scoped name\n  • Specify a display name for the new copy\n  • Target any scoped application by sys_id\n  • Returns the new flow sys_id for use in subsequent commands",
+      "description": "Execute a Flow Designer action by scoped name.\n\nRuns an action using the sn_fd.FlowAPI ScriptableFlowRunner.\n\nFeatures:\n  • Execute actions by scoped name\n  • Pass input values as JSON\n  • Foreground or background execution mode\n  • Returns context ID, outputs, and debug information",
       "examples": [
         {
-          "description": "Copy an OOB flow into your app scope",
-          "command": "<%= config.bin %> <%= command.id %> --source-flow-id e89e3ade731310108ef62d2b04f6a744 --name \"Copy of Change - Standard\" --target-scope 4a5a6115402946939ee48e3fe80f60f8 --auth dev"
-        },
-        {
-          "description": "Copy by scoped name",
-          "command": "<%= config.bin %> <%= command.id %> -s global.change__standard -n \"My Custom Change Flow\" -t 4a5a6115402946939ee48e3fe80f60f8 --auth dev"
-        },
-        {
-          "description": "Copy with JSON output for scripting",
-          "command": "<%= config.bin %> <%= command.id %> -s e89e3ade731310108ef62d2b04f6a744 -n \"Copy\" -t 4a5a6115402946939ee48e3fe80f60f8 --json --auth dev"
+          "description": "Run an action",
+          "command": "<%= config.bin %> <%= command.id %> --name global.create_record --inputs '{\"table\":\"incident\",\"values\":{\"short_description\":\"Test\"}}' --auth dev"
         }
       ],
       "flags": {
@@ -3215,37 +3324,57 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "source-flow-id": {
-          "char": "s",
-          "description": "Source flow sys_id or scoped name (e.g. global.change__standard)",
-          "name": "source-flow-id",
+        "name": {
+          "char": "n",
+          "description": "Scoped name of the action (e.g. global.create_record)",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "Display name for the new copied flow",
-          "name": "name",
-          "required": true,
+        "inputs": {
+          "char": "i",
+          "description": "JSON object of input name-value pairs",
+          "name": "inputs",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "target-scope": {
-          "char": "t",
-          "description": "Scope sys_id of the target application (use `nex scope` to find scope sys_ids)",
-          "name": "target-scope",
-          "required": true,
+        "mode": {
+          "char": "m",
+          "description": "Execution mode",
+          "name": "mode",
+          "required": false,
+          "default": "foreground",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "foreground",
+            "background"
+          ],
+          "type": "option"
+        },
+        "scope": {
+          "description": "Scope context for script execution",
+          "name": "scope",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "quick": {
+          "description": "Skip execution detail records for better performance",
+          "name": "quick",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:copy",
+      "id": "flow:action",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3256,39 +3385,27 @@
         "dist",
         "commands",
         "flow",
-        "copy.js"
+        "action.js"
       ]
     },
-    "flow:definition": {
+    "flow:cancel": {
       "aliases": [],
       "args": {},
-      "description": "Retrieve the read-only design-time definition of a flow, subflow, or action.\n\nReturns what the artifact IS, not what a run of it did: triggers, actions, nested subflows, flow logic, inputs and outputs as Workflow Studio stores them. Nothing is executed, published or modified, and no flow context is created or required.\n\nThis is the design-time counterpart to `flow details`, which describes one past execution and needs a context sys_id.\n\nThe type is never inferred from the sys_id: --type selects the artifact that is asked for, and a sys_id of a different type fails with a type_mismatch rather than being relabelled.\n\nWith --json, stdout carries exactly one JSON document — the complete typed result including the untouched ServiceNow payload — so it can be piped or redirected. Without it, a short summary is printed; definition bodies, step scripts and input values are never printed or logged.",
+      "description": "Cancel a running or paused flow execution.\n\nCancels a flow context that is in QUEUED, IN_PROGRESS, or WAITING state.",
       "examples": [
         {
-          "description": "Summarise a flow definition",
-          "command": "<%= config.bin %> <%= command.id %> --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev"
-        },
-        {
-          "description": "Retrieve a subflow definition",
-          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev"
-        },
-        {
-          "description": "Retrieve a custom action definition with its ordered steps",
-          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev"
-        },
-        {
-          "description": "Redirect the full JSON definition to a file",
-          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json"
+          "description": "Cancel a running flow",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
         },
         {
-          "description": "Pipe the JSON definition into another tool",
-          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps"
+          "description": "Cancel with a reason",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --reason \"No longer needed\" --auth dev"
         }
       ],
       "flags": {
         "json": {
           "char": "j",
-          "description": "Output the complete typed result as JSON",
+          "description": "Output results as JSON",
           "name": "json",
           "required": false,
           "allowNo": false,
@@ -3368,32 +3485,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "sys-id": {
-          "char": "i",
-          "description": "sys_id of the flow, subflow, or action to retrieve",
-          "name": "sys-id",
+        "context-id": {
+          "char": "c",
+          "description": "Flow execution context sys_id",
+          "name": "context-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "type": {
-          "char": "t",
-          "description": "Artifact type to retrieve. Must match what the sys_id actually is.",
-          "name": "type",
+        "reason": {
+          "char": "r",
+          "description": "Cancellation reason",
+          "name": "reason",
           "required": false,
-          "default": "flow",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "flow",
-            "subflow",
-            "action"
-          ],
           "type": "option"
         },
         "scope": {
-          "description": "Scope sys_id or name for the transaction scope parameter. Optional — ServiceNow resolves the artifact's own scope when omitted.",
+          "description": "Scope context for script execution",
           "name": "scope",
           "required": false,
           "hasDynamicHelp": false,
@@ -3403,7 +3514,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:definition",
+      "id": "flow:cancel",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3414,25 +3525,25 @@
         "dist",
         "commands",
         "flow",
-        "definition.js"
+        "cancel.js"
       ]
     },
-    "flow:details": {
+    "flow:copy": {
       "aliases": [],
       "args": {},
-      "description": "Get rich execution details for a flow context.\n\nReturns 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.\n\nUses the ProcessFlow operations API (GET /api/now/processflow/operations/flow/context/{id}), the same endpoint Flow Designer uses to display execution details.\n\nNOTE: Requires flow operations logging to be enabled on the instance. If the execution report is unavailable, a notice will explain why.\n\nTypical workflow:\n  flow test → flow details → diagnose → modify flow → flow test again",
+      "description": "Copy an existing flow into a target scoped application.\n\nThis 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.\n\nEnables the full CLI-driven flow development lifecycle:\n  copy → pull (now-sdk transform) → modify → push → test → publish\n\nFeatures:\n  • Copy flows by sys_id or scoped name\n  • Specify a display name for the new copy\n  • Target any scoped application by sys_id\n  • Returns the new flow sys_id for use in subsequent commands",
       "examples": [
         {
-          "description": "Get execution details after testing a flow",
-          "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --auth dev"
+          "description": "Copy an OOB flow into your app scope",
+          "command": "<%= config.bin %> <%= command.id %> --source-flow-id e89e3ade731310108ef62d2b04f6a744 --name \"Copy of Change - Standard\" --target-scope 4a5a6115402946939ee48e3fe80f60f8 --auth dev"
         },
         {
-          "description": "Get details with explicit scope",
-          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --scope x_myapp --auth dev"
+          "description": "Copy by scoped name",
+          "command": "<%= config.bin %> <%= command.id %> -s global.change__standard -n \"My Custom Change Flow\" -t 4a5a6115402946939ee48e3fe80f60f8 --auth dev"
         },
         {
-          "description": "Get details with JSON output for scripting",
-          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
+          "description": "Copy with JSON output for scripting",
+          "command": "<%= config.bin %> <%= command.id %> -s e89e3ade731310108ef62d2b04f6a744 -n \"Copy\" -t 4a5a6115402946939ee48e3fe80f60f8 --json --auth dev"
         }
       ],
       "flags": {
@@ -3518,35 +3629,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "context-id": {
-          "char": "c",
-          "description": "Flow context sys_id returned by flow test, flow run, flow subflow, or flow action",
-          "name": "context-id",
+        "source-flow-id": {
+          "char": "s",
+          "description": "Source flow sys_id or scoped name (e.g. global.change__standard)",
+          "name": "source-flow-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "scope": {
-          "description": "Scope sys_id for the ProcessFlow API transaction scope parameter",
-          "name": "scope",
-          "required": false,
+        "name": {
+          "char": "n",
+          "description": "Display name for the new copied flow",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-scope": {
+          "char": "t",
+          "description": "Scope sys_id of the target application (use `nex scope` to find scope sys_ids)",
+          "name": "target-scope",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "include-definition": {
-          "char": "d",
-          "description": "Include the full flow definition snapshot in the response",
-          "name": "include-definition",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:details",
+      "id": "flow:copy",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3557,23 +3670,39 @@
         "dist",
         "commands",
         "flow",
-        "details.js"
+        "copy.js"
       ]
     },
-    "flow:error": {
+    "flow:definition": {
       "aliases": [],
       "args": {},
-      "description": "Retrieve error details from a failed flow execution.\n\nGets the error message from a flow context that ended in an error state.",
+      "description": "Retrieve the read-only design-time definition of a flow, subflow, or action.\n\nReturns what the artifact IS, not what a run of it did: triggers, actions, nested subflows, flow logic, inputs and outputs as Workflow Studio stores them. Nothing is executed, published or modified, and no flow context is created or required.\n\nThis is the design-time counterpart to `flow details`, which describes one past execution and needs a context sys_id.\n\nThe type is never inferred from the sys_id: --type selects the artifact that is asked for, and a sys_id of a different type fails with a type_mismatch rather than being relabelled.\n\nWith --json, stdout carries exactly one JSON document — the complete typed result including the untouched ServiceNow payload — so it can be piped or redirected. Without it, a short summary is printed; definition bodies, step scripts and input values are never printed or logged.",
       "examples": [
         {
-          "description": "Get flow error details",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
+          "description": "Summarise a flow definition",
+          "command": "<%= config.bin %> <%= command.id %> --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev"
+        },
+        {
+          "description": "Retrieve a subflow definition",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev"
+        },
+        {
+          "description": "Retrieve a custom action definition with its ordered steps",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev"
+        },
+        {
+          "description": "Redirect the full JSON definition to a file",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json"
+        },
+        {
+          "description": "Pipe the JSON definition into another tool",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps"
         }
       ],
       "flags": {
         "json": {
           "char": "j",
-          "description": "Output results as JSON",
+          "description": "Output the complete typed result as JSON",
           "name": "json",
           "required": false,
           "allowNo": false,
@@ -3653,17 +3782,32 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "context-id": {
-          "char": "c",
-          "description": "Flow execution context sys_id",
-          "name": "context-id",
+        "sys-id": {
+          "char": "i",
+          "description": "sys_id of the flow, subflow, or action to retrieve",
+          "name": "sys-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "type": {
+          "char": "t",
+          "description": "Artifact type to retrieve. Must match what the sys_id actually is.",
+          "name": "type",
+          "required": false,
+          "default": "flow",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "flow",
+            "subflow",
+            "action"
+          ],
+          "type": "option"
+        },
         "scope": {
-          "description": "Scope context for script execution",
+          "description": "Scope sys_id or name for the transaction scope parameter. Optional — ServiceNow resolves the artifact's own scope when omitted.",
           "name": "scope",
           "required": false,
           "hasDynamicHelp": false,
@@ -3673,7 +3817,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:error",
+      "id": "flow:definition",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3684,24 +3828,24 @@
         "dist",
         "commands",
         "flow",
-        "error.js"
+        "definition.js"
       ]
     },
-    "flow:logs": {
+    "flow:details": {
       "aliases": [],
       "args": {},
-      "description": "Retrieve flow execution log entries for a given context.\n\nLog 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.\n\nQueries sys_flow_log entries and maps numeric log levels to human-readable names (ERROR, WARN, INFO, DEBUG).\n\nNOTE: 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.",
+      "description": "Get rich execution details for a flow context.\n\nReturns 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.\n\nUses the ProcessFlow operations API (GET /api/now/processflow/operations/flow/context/{id}), the same endpoint Flow Designer uses to display execution details.\n\nNOTE: Requires flow operations logging to be enabled on the instance. If the execution report is unavailable, a notice will explain why.\n\nTypical workflow:\n  flow test → flow details → diagnose → modify flow → flow test again",
       "examples": [
         {
-          "description": "Get flow execution logs",
+          "description": "Get execution details after testing a flow",
           "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --auth dev"
         },
         {
-          "description": "Get latest 10 log entries in reverse order",
-          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --limit 10 --order desc --auth dev"
+          "description": "Get details with explicit scope",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --scope x_myapp --auth dev"
         },
         {
-          "description": "Get logs with JSON output for scripting",
+          "description": "Get details with JSON output for scripting",
           "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
         }
       ],
@@ -3797,34 +3941,26 @@
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "char": "l",
-          "description": "Maximum number of log entries to return",
-          "name": "limit",
+        "scope": {
+          "description": "Scope sys_id for the ProcessFlow API transaction scope parameter",
+          "name": "scope",
           "required": false,
-          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "order": {
-          "char": "o",
-          "description": "Order direction: asc (oldest first) or desc (newest first)",
-          "name": "order",
+        "include-definition": {
+          "char": "d",
+          "description": "Include the full flow definition snapshot in the response",
+          "name": "include-definition",
           "required": false,
-          "default": "asc",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "asc",
-            "desc"
-          ],
-          "type": "option"
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:logs",
+      "id": "flow:details",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3835,21 +3971,17 @@
         "dist",
         "commands",
         "flow",
-        "logs.js"
+        "details.js"
       ]
     },
-    "flow:message": {
+    "flow:error": {
       "aliases": [],
       "args": {},
-      "description": "Send a message to a paused flow execution.\n\nSends a message to a flow context that is in a WAITING state (e.g. waiting on a \"Wait for Message\" action). Supports an optional JSON payload.",
+      "description": "Retrieve error details from a failed flow execution.\n\nGets the error message from a flow context that ended in an error state.",
       "examples": [
         {
-          "description": "Send a message to resume a waiting flow",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --message \"approved\" --auth dev"
-        },
-        {
-          "description": "Send a message with a JSON payload",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --message \"data_ready\" --payload '{\"status\":\"ok\"}' --auth dev"
+          "description": "Get flow error details",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
         }
       ],
       "flags": {
@@ -3944,24 +4076,6 @@
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "Message to send to the flow",
-          "name": "message",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "payload": {
-          "char": "p",
-          "description": "Optional JSON payload to include with the message",
-          "name": "payload",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "scope": {
           "description": "Scope context for script execution",
           "name": "scope",
@@ -3973,7 +4087,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:message",
+      "id": "flow:error",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3984,21 +4098,25 @@
         "dist",
         "commands",
         "flow",
-        "message.js"
+        "error.js"
       ]
     },
-    "flow:outputs": {
+    "flow:logs": {
       "aliases": [],
       "args": {},
-      "description": "Retrieve outputs from a completed flow execution.\n\nGets the output name-value pairs from a flow, subflow, or action execution context.",
+      "description": "Retrieve flow execution log entries for a given context.\n\nLog 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.\n\nQueries sys_flow_log entries and maps numeric log levels to human-readable names (ERROR, WARN, INFO, DEBUG).\n\nNOTE: 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": [
         {
-          "description": "Get flow outputs",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
+          "description": "Get flow execution logs",
+          "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --auth dev"
         },
         {
-          "description": "Get outputs as JSON",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --json --auth dev"
+          "description": "Get latest 10 log entries in reverse order",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --limit 10 --order desc --auth dev"
+        },
+        {
+          "description": "Get logs with JSON output for scripting",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
         }
       ],
       "flags": {
@@ -4086,25 +4204,41 @@
         },
         "context-id": {
           "char": "c",
-          "description": "Flow execution context sys_id",
+          "description": "Flow context sys_id returned by flow test, flow run, flow subflow, or flow action",
           "name": "context-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "scope": {
-          "description": "Scope context for script execution",
-          "name": "scope",
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of log entries to return",
+          "name": "limit",
+          "required": false,
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "order": {
+          "char": "o",
+          "description": "Order direction: asc (oldest first) or desc (newest first)",
+          "name": "order",
           "required": false,
+          "default": "asc",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "asc",
+            "desc"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:outputs",
+      "id": "flow:logs",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4115,25 +4249,21 @@
         "dist",
         "commands",
         "flow",
-        "outputs.js"
+        "logs.js"
       ]
     },
-    "flow:run": {
+    "flow:message": {
       "aliases": [],
       "args": {},
-      "description": "Execute a published Flow Designer flow by scoped name.\n\nRuns a flow using the sn_fd.FlowAPI ScriptableFlowRunner. Supports foreground (synchronous) and background (asynchronous) execution modes.\n\nNote: This command requires the flow to be published. For testing flows that are not yet published (draft/saved state), use `flow test` instead.\n\nFeatures:\n  • Execute flows by scoped name (e.g. global.my_flow)\n  • Pass input values as JSON\n  • Foreground or background execution mode\n  • Quick mode to skip execution detail records\n  • Returns context ID, outputs, and debug information",
+      "description": "Send a message to a paused flow execution.\n\nSends a message to a flow context that is in a WAITING state (e.g. waiting on a \"Wait for Message\" action). Supports an optional JSON payload.",
       "examples": [
         {
-          "description": "Run a flow in foreground mode",
-          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --auth dev"
-        },
-        {
-          "description": "Run with inputs",
-          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --inputs '{\"record_sys_id\":\"abc123\"}' --auth dev"
+          "description": "Send a message to resume a waiting flow",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --message \"approved\" --auth dev"
         },
         {
-          "description": "Run in background mode",
-          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --mode background --auth dev"
+          "description": "Send a message with a JSON payload",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --message \"data_ready\" --payload '{\"status\":\"ok\"}' --auth dev"
         }
       ],
       "flags": {
@@ -4219,57 +4349,45 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "char": "n",
-          "description": "Scoped name of the flow (e.g. global.my_flow)",
-          "name": "name",
+        "context-id": {
+          "char": "c",
+          "description": "Flow execution context sys_id",
+          "name": "context-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "inputs": {
-          "char": "i",
-          "description": "JSON object of input name-value pairs",
-          "name": "inputs",
-          "required": false,
+        "message": {
+          "char": "m",
+          "description": "Message to send to the flow",
+          "name": "message",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "mode": {
-          "char": "m",
-          "description": "Execution mode",
-          "name": "mode",
+        "payload": {
+          "char": "p",
+          "description": "Optional JSON payload to include with the message",
+          "name": "payload",
           "required": false,
-          "default": "foreground",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "foreground",
-            "background"
-          ],
           "type": "option"
         },
         "scope": {
-          "description": "Scope context for script execution (e.g. global, x_myapp)",
+          "description": "Scope context for script execution",
           "name": "scope",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "quick": {
-          "description": "Skip execution detail records for better performance",
-          "name": "quick",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:run",
+      "id": "flow:message",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4280,17 +4398,21 @@
         "dist",
         "commands",
         "flow",
-        "run.js"
+        "message.js"
       ]
     },
-    "flow:status": {
+    "flow:outputs": {
       "aliases": [],
       "args": {},
-      "description": "Get the status of a flow execution context.\n\nQueries sys_flow_context to retrieve the current state of a flow execution.\n\nPossible states: QUEUED, IN_PROGRESS, WAITING, COMPLETE, CANCELLED, ERROR",
+      "description": "Retrieve outputs from a completed flow execution.\n\nGets the output name-value pairs from a flow, subflow, or action execution context.",
       "examples": [
         {
-          "description": "Check flow execution status",
+          "description": "Get flow outputs",
           "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
+        },
+        {
+          "description": "Get outputs as JSON",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --json --auth dev"
         }
       ],
       "flags": {
@@ -4396,7 +4518,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:status",
+      "id": "flow:outputs",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4407,21 +4529,25 @@
         "dist",
         "commands",
         "flow",
-        "status.js"
+        "outputs.js"
       ]
     },
-    "flow:subflow": {
+    "flow:run": {
       "aliases": [],
       "args": {},
-      "description": "Execute a published Flow Designer subflow by scoped name.\n\nRuns a subflow using the sn_fd.FlowAPI ScriptableFlowRunner.\n\nNote: This command requires the subflow to be published. For testing flows that are not yet published (draft/saved state), use `flow test` instead.\n\nFeatures:\n  • Execute subflows by scoped name\n  • Pass input values as JSON\n  • Foreground or background execution mode\n  • Returns context ID, outputs, and debug information",
+      "description": "Execute a published Flow Designer flow by scoped name.\n\nRuns a flow using the sn_fd.FlowAPI ScriptableFlowRunner. Supports foreground (synchronous) and background (asynchronous) execution modes.\n\nNote: This command requires the flow to be published. For testing flows that are not yet published (draft/saved state), use `flow test` instead.\n\nFeatures:\n  • Execute flows by scoped name (e.g. global.my_flow)\n  • Pass input values as JSON\n  • Foreground or background execution mode\n  • Quick mode to skip execution detail records\n  • Returns context ID, outputs, and debug information",
       "examples": [
         {
-          "description": "Run a subflow",
-          "command": "<%= config.bin %> <%= command.id %> --name global.my_subflow --auth dev"
+          "description": "Run a flow in foreground mode",
+          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --auth dev"
         },
         {
           "description": "Run with inputs",
-          "command": "<%= config.bin %> <%= command.id %> --name x_myapp.process_record --inputs '{\"table\":\"incident\",\"sys_id\":\"abc123\"}' --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --inputs '{\"record_sys_id\":\"abc123\"}' --auth dev"
+        },
+        {
+          "description": "Run in background mode",
+          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --mode background --auth dev"
         }
       ],
       "flags": {
@@ -4509,7 +4635,7 @@
         },
         "name": {
           "char": "n",
-          "description": "Scoped name of the subflow (e.g. global.my_subflow)",
+          "description": "Scoped name of the flow (e.g. global.my_flow)",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
@@ -4540,7 +4666,7 @@
           "type": "option"
         },
         "scope": {
-          "description": "Scope context for script execution",
+          "description": "Scope context for script execution (e.g. global, x_myapp)",
           "name": "scope",
           "required": false,
           "hasDynamicHelp": false,
@@ -4557,7 +4683,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:subflow",
+      "id": "flow:run",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4568,25 +4694,17 @@
         "dist",
         "commands",
         "flow",
-        "subflow.js"
+        "run.js"
       ]
     },
-    "flow:test": {
+    "flow:status": {
       "aliases": [],
       "args": {},
-      "description": "Test a Flow Designer flow without requiring it to be published.\n\nInvokes 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.\n\nFeatures:\n  • Test flows by sys_id or scoped name\n  • Pass trigger output values as JSON via --output-map\n  • Auto-resolves scope from flow definition if not provided\n  • Synchronous or asynchronous execution",
+      "description": "Get the status of a flow execution context.\n\nQueries sys_flow_context to retrieve the current state of a flow execution.\n\nPossible states: QUEUED, IN_PROGRESS, WAITING, COMPLETE, CANCELLED, ERROR",
       "examples": [
         {
-          "description": "Test a flow by sys_id",
-          "command": "<%= config.bin %> <%= command.id %> --flow-id 887dda5583237210fdb8f7b6feaad32c --output-map '{\"current\":\"0ecd7552db252200a6a2b31be0b8f5e6\",\"table_name\":\"change_request\"}' --auth dev"
-        },
-        {
-          "description": "Test a flow by scoped name with explicit scope",
-          "command": "<%= config.bin %> <%= command.id %> -f x_myapp.my_flow -o '{\"current\":\"abc123\",\"table_name\":\"incident\"}' --scope x_myapp --auth dev"
-        },
-        {
-          "description": "Test with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> -f 887dda5583237210fdb8f7b6feaad32c -o '{\"current\":\"abc123\"}' --json --auth dev"
+          "description": "Check flow execution status",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
         }
       ],
       "flags": {
@@ -4672,43 +4790,27 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "flow-id": {
-          "char": "f",
-          "description": "Flow sys_id or scoped name (e.g. x_myapp.my_flow)",
-          "name": "flow-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-map": {
-          "char": "o",
-          "description": "JSON mapping of trigger output variable names to test values (e.g. '{\"current\":\"<sys_id>\",\"table_name\":\"change_request\"}')",
-          "name": "output-map",
+        "context-id": {
+          "char": "c",
+          "description": "Flow execution context sys_id",
+          "name": "context-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "scope": {
-          "description": "Scope sys_id for transaction scope (auto-resolved from flow definition if omitted)",
+          "description": "Scope context for script execution",
           "name": "scope",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "synchronous": {
-          "description": "Run test synchronously (default: true)",
-          "name": "synchronous",
-          "required": false,
-          "allowNo": true,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:test",
+      "id": "flow:status",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4719,29 +4821,21 @@
         "dist",
         "commands",
         "flow",
-        "test.js"
+        "status.js"
       ]
     },
-    "health:check": {
+    "flow:subflow": {
       "aliases": [],
       "args": {},
-      "description": "Run a consolidated health check on a ServiceNow instance.\n\nPerforms comprehensive diagnostics including version info, cluster status, stuck job detection, semaphore counts, and operational record counts.\n\nFeatures:\n  • Instance version and build information\n  • Cluster node status\n  • Stuck job detection with configurable threshold\n  • Active semaphore count\n  • Operational counts (incidents, changes, problems)\n  • Color-coded status indicators\n  • JSON output for CI/CD monitoring",
+      "description": "Execute a published Flow Designer subflow by scoped name.\n\nRuns a subflow using the sn_fd.FlowAPI ScriptableFlowRunner.\n\nNote: This command requires the subflow to be published. For testing flows that are not yet published (draft/saved state), use `flow test` instead.\n\nFeatures:\n  • Execute subflows by scoped name\n  • Pass input values as JSON\n  • Foreground or background execution mode\n  • Returns context ID, outputs, and debug information",
       "examples": [
         {
-          "description": "Run full health check",
-          "command": "<%= config.bin %> <%= command.id %> --auth dev"
-        },
-        {
-          "description": "Check only version and stuck jobs",
-          "command": "<%= config.bin %> <%= command.id %> --include-version --include-stuck-jobs --no-include-cluster --no-include-semaphores --no-include-operational-counts --auth dev"
-        },
-        {
-          "description": "Health check with custom stuck job threshold",
-          "command": "<%= config.bin %> <%= command.id %> --stuck-job-threshold 60 --auth dev"
+          "description": "Run a subflow",
+          "command": "<%= config.bin %> <%= command.id %> --name global.my_subflow --auth dev"
         },
         {
-          "description": "Health check as JSON",
-          "command": "<%= config.bin %> <%= command.id %> --json --auth dev"
+          "description": "Run with inputs",
+          "command": "<%= config.bin %> <%= command.id %> --name x_myapp.process_record --inputs '{\"table\":\"incident\",\"sys_id\":\"abc123\"}' --auth dev"
         }
       ],
       "flags": {
@@ -4827,54 +4921,57 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "include-version": {
-          "description": "Include instance version information",
-          "name": "include-version",
-          "required": false,
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "include-cluster": {
-          "description": "Include cluster node status",
-          "name": "include-cluster",
-          "required": false,
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "include-stuck-jobs": {
-          "description": "Include stuck job detection",
-          "name": "include-stuck-jobs",
-          "required": false,
-          "allowNo": true,
-          "type": "boolean"
+        "name": {
+          "char": "n",
+          "description": "Scoped name of the subflow (e.g. global.my_subflow)",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "include-semaphores": {
-          "description": "Include active semaphore count",
-          "name": "include-semaphores",
+        "inputs": {
+          "char": "i",
+          "description": "JSON object of input name-value pairs",
+          "name": "inputs",
           "required": false,
-          "allowNo": true,
-          "type": "boolean"
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "include-operational-counts": {
-          "description": "Include operational record counts (incidents, changes, problems)",
-          "name": "include-operational-counts",
+        "mode": {
+          "char": "m",
+          "description": "Execution mode",
+          "name": "mode",
           "required": false,
-          "allowNo": true,
-          "type": "boolean"
+          "default": "foreground",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "foreground",
+            "background"
+          ],
+          "type": "option"
         },
-        "stuck-job-threshold": {
-          "description": "Minutes threshold for a job to be considered stuck",
-          "name": "stuck-job-threshold",
+        "scope": {
+          "description": "Scope context for script execution",
+          "name": "scope",
           "required": false,
-          "default": 30,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "quick": {
+          "description": "Skip execution detail records for better performance",
+          "name": "quick",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "health:check",
+      "id": "flow:subflow",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4884,53 +4981,34 @@
       "relativePath": [
         "dist",
         "commands",
-        "health",
-        "check.js"
+        "flow",
+        "subflow.js"
       ]
     },
-    "log": {
+    "flow:test": {
       "aliases": [],
       "args": {},
-      "description": "Tail and monitor ServiceNow system logs in real-time with beautiful formatting.\n\nThis command provides real-time log monitoring with enhanced visual formatting using color-coded output that makes logs easy to scan and understand at a glance. Automatically highlights errors, warnings, success messages, and important keywords.\n\nKey Features:\n  • Real-time log tailing (like Unix tail -f)\n  • Powerful filtering with multiple operators (CONTAINS, REGEX, EQUALS, etc.)\n  • Smart keyword highlighting (errors in red, warnings in yellow, etc.)\n  • Beautiful color-coded console output with chalk\n  • Export logs to file with automatic appending\n  • Fast 1-second default polling interval\n  • Timestamps and sequence numbers for each log\n  • Graceful shutdown with Ctrl+C\n  • Clean output without colors (--no-color flag)\n\nSmart Highlighting:\n  • Error terms (error, exception, failed) - highlighted in RED\n  • Warning terms (warn, warning, deprecated) - highlighted in YELLOW\n  • Success terms (success, completed, done) - highlighted in GREEN\n  • System terms (system, user, transaction) - highlighted in BLUE\n\nFiltering:\n  • Apply filters using --filter flag with syntax: \"field OPERATOR value\"\n  • Supports case-sensitive and case-insensitive operations\n  • Multiple filters are combined with AND logic\n  • Operators: CONTAINS, CONTAINS_CI, EQUALS, EQUALS_CI, STARTS_WITH, STARTS_WITH_CI,\n    ENDS_WITH, ENDS_WITH_CI, REGEX, NOT_CONTAINS, NOT_CONTAINS_CI, NOT_EQUALS, NOT_EQUALS_CI\n\nUse Cases:\n  • Monitor logs during application development\n  • Debug issues in real-time\n  • Track system events during deployments\n  • Filter logs for specific application or component\n  • Quickly spot errors and warnings\n  • Collect logs for analysis or audit trails\n\n⚠️  IMPORTANT NOTES:\n  • Press Ctrl+C to stop tailing and exit gracefully\n  • Log files are created/appended automatically\n  • Uses ChannelAjax when available for better performance\n  • Default poll interval is 1 second for real-time monitoring",
+      "description": "Test a Flow Designer flow without requiring it to be published.\n\nInvokes 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.\n\nFeatures:\n  • Test flows by sys_id or scoped name\n  • Pass trigger output values as JSON via --output-map\n  • Auto-resolves scope from flow definition if not provided\n  • Synchronous or asynchronous execution",
       "examples": [
         {
-          "description": "Tail all logs in real-time",
-          "command": "<%= config.bin %> <%= command.id %> --auth dev-instance"
-        },
-        {
-          "description": "Tail logs and save to a file",
-          "command": "<%= config.bin %> <%= command.id %> --output ./logs/instance-logs.txt --auth dev-instance"
-        },
-        {
-          "description": "Tail logs with custom polling interval (500ms for faster updates)",
-          "command": "<%= config.bin %> <%= command.id %> --interval 500 --auth dev-instance"
-        },
-        {
-          "description": "Filter logs containing specific text (case-insensitive)",
-          "command": "<%= config.bin %> <%= command.id %> --filter \"message CONTAINS_CI error\" --auth dev-instance"
-        },
-        {
-          "description": "Filter logs with multiple conditions (AND logic)",
-          "command": "<%= config.bin %> <%= command.id %> --filter \"message CONTAINS x_acme_app\" --filter \"message CONTAINS error\" --auth dev-instance"
-        },
-        {
-          "description": "Filter logs using regex pattern",
-          "command": "<%= config.bin %> <%= command.id %> --filter \"message REGEX .*exception.*\" --auth dev-instance"
+          "description": "Test a flow by sys_id",
+          "command": "<%= config.bin %> <%= command.id %> --flow-id 887dda5583237210fdb8f7b6feaad32c --output-map '{\"current\":\"0ecd7552db252200a6a2b31be0b8f5e6\",\"table_name\":\"change_request\"}' --auth dev"
         },
         {
-          "description": "Filter logs by message starting with a pattern",
-          "command": "<%= config.bin %> <%= command.id %> --filter \"message STARTS_WITH [ERROR]\" --auth dev-instance"
+          "description": "Test a flow by scoped name with explicit scope",
+          "command": "<%= config.bin %> <%= command.id %> -f x_myapp.my_flow -o '{\"current\":\"abc123\",\"table_name\":\"incident\"}' --scope x_myapp --auth dev"
         },
         {
-          "description": "Tail logs without colored output",
-          "command": "<%= config.bin %> <%= command.id %> --no-color --auth dev-instance"
+          "description": "Test with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> -f 887dda5583237210fdb8f7b6feaad32c -o '{\"current\":\"abc123\"}' --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -5008,45 +5086,43 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "output": {
+        "flow-id": {
+          "char": "f",
+          "description": "Flow sys_id or scoped name (e.g. x_myapp.my_flow)",
+          "name": "flow-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-map": {
           "char": "o",
-          "description": "Output file path to save logs. Creates parent directories if needed.",
-          "name": "output",
-          "required": false,
+          "description": "JSON mapping of trigger output variable names to test values (e.g. '{\"current\":\"<sys_id>\",\"table_name\":\"change_request\"}')",
+          "name": "output-map",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "interval": {
-          "char": "i",
-          "description": "Polling interval in milliseconds",
-          "name": "interval",
+        "scope": {
+          "description": "Scope sys_id for transaction scope (auto-resolved from flow definition if omitted)",
+          "name": "scope",
           "required": false,
-          "default": 1000,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-color": {
-          "description": "Disable colored output",
-          "name": "no-color",
+        "synchronous": {
+          "description": "Run test synchronously (default: true)",
+          "name": "synchronous",
           "required": false,
-          "allowNo": false,
+          "allowNo": true,
           "type": "boolean"
-        },
-        "filter": {
-          "char": "f",
-          "description": "Filter logs by field and value. Syntax: field OPERATOR value. Operators: CONTAINS, CONTAINS_CI (case-insensitive), EQUALS, EQUALS_CI, STARTS_WITH, STARTS_WITH_CI, ENDS_WITH, ENDS_WITH_CI, REGEX, NOT_CONTAINS, NOT_EQUALS. Field defaults to \"message\" if omitted. Multiple filters are combined with AND logic.",
-          "name": "filter",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "log",
+      "id": "flow:test",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -5056,8 +5132,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "log",
-        "index.js"
+        "flow",
+        "test.js"
       ]
     },
     "policy:status": {
@@ -9830,25 +9906,283 @@
         "move.js"
       ]
     },
-    "workflow:create": {
+    "workflow:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a complete workflow from a JSON specification file.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --spec ./workflow.json --auth dev",
+          "description": "Create a workflow from a JSON spec file"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -s ./workflow.json --json --auth dev",
+          "description": "Create a workflow and output result as JSON"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth": {
+          "char": "a",
+          "description": "Auth alias to use.",
+          "name": "auth",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cred-store": {
+          "description": "Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.",
+          "helpGroup": "GLOBAL",
+          "name": "cred-store",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deny-execute": {
+          "description": "Refuse background scripts, flow runs and ATF runs for this invocation.",
+          "helpGroup": "GLOBAL",
+          "name": "deny-execute",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deny-write": {
+          "description": "Refuse any change to instance data for this invocation.",
+          "helpGroup": "GLOBAL",
+          "name": "deny-write",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-dir": {
+          "description": "Directory to write log files to. Implies --log-file.",
+          "helpGroup": "GLOBAL",
+          "name": "log-dir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "log-file": {
+          "description": "Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to stderr only.",
+          "helpGroup": "GLOBAL",
+          "name": "log-file",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-level": {
+          "helpGroup": "GLOBAL",
+          "name": "log-level",
+          "summary": "Specify level for logging.",
+          "default": "info",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "debug",
+            "warn",
+            "error",
+            "info",
+            "trace"
+          ],
+          "type": "option"
+        },
+        "read-only": {
+          "description": "Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are unaffected.",
+          "helpGroup": "GLOBAL",
+          "name": "read-only",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "spec": {
+          "char": "s",
+          "description": "Path to workflow JSON specification file",
+          "name": "spec",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workflow:create",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workflow",
+        "create.js"
+      ]
+    },
+    "workflow:publish": {
+      "aliases": [],
+      "args": {},
+      "description": "Publish a workflow version.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --version-id wfv-001 --start-activity act-001 --auth dev",
+          "description": "Publish a workflow version"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -v wfv-001 -s act-001 --json --auth dev",
+          "description": "Publish a workflow version and output as JSON"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth": {
+          "char": "a",
+          "description": "Auth alias to use.",
+          "name": "auth",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cred-store": {
+          "description": "Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.",
+          "helpGroup": "GLOBAL",
+          "name": "cred-store",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deny-execute": {
+          "description": "Refuse background scripts, flow runs and ATF runs for this invocation.",
+          "helpGroup": "GLOBAL",
+          "name": "deny-execute",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deny-write": {
+          "description": "Refuse any change to instance data for this invocation.",
+          "helpGroup": "GLOBAL",
+          "name": "deny-write",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-dir": {
+          "description": "Directory to write log files to. Implies --log-file.",
+          "helpGroup": "GLOBAL",
+          "name": "log-dir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "log-file": {
+          "description": "Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to stderr only.",
+          "helpGroup": "GLOBAL",
+          "name": "log-file",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-level": {
+          "helpGroup": "GLOBAL",
+          "name": "log-level",
+          "summary": "Specify level for logging.",
+          "default": "info",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "debug",
+            "warn",
+            "error",
+            "info",
+            "trace"
+          ],
+          "type": "option"
+        },
+        "read-only": {
+          "description": "Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are unaffected.",
+          "helpGroup": "GLOBAL",
+          "name": "read-only",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "start-activity": {
+          "char": "s",
+          "description": "Sys ID of the start activity",
+          "name": "start-activity",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version-id": {
+          "char": "v",
+          "description": "Sys ID of the workflow version to publish",
+          "name": "version-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "workflow:publish",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "workflow",
+        "publish.js"
+      ]
+    },
+    "xml:export": {
       "aliases": [],
       "args": {},
-      "description": "Create a complete workflow from a JSON specification file.",
+      "description": "Export a single ServiceNow record as XML.\n\nDownloads the XML representation of a specific record from a ServiceNow table. Without --output, the XML is printed to stdout. With --output, the XML is written to the specified file path.\n\nFeatures:\n  • Export any record by table and sys_id\n  • Print XML to stdout for piping to other tools\n  • Save directly to a file with --output\n  • JSON output mode for CI/CD integration",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --spec ./workflow.json --auth dev",
-          "description": "Create a workflow from a JSON spec file"
+          "description": "Export a record to stdout",
+          "command": "<%= config.bin %> <%= command.id %> --table sys_script_include --sys-id abc123def456 --auth dev"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -s ./workflow.json --json --auth dev",
-          "description": "Create a workflow and output result as JSON"
+          "description": "Export and save to a file",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --sys-id abc123 --output ./export.xml --auth dev"
+        },
+        {
+          "description": "Export as JSON metadata",
+          "command": "<%= config.bin %> <%= command.id %> --table sys_script --sys-id abc123 --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -9926,19 +10260,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "spec": {
+        "table": {
+          "char": "t",
+          "description": "Table name of the record to export",
+          "name": "table",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sys-id": {
           "char": "s",
-          "description": "Path to workflow JSON specification file",
-          "name": "spec",
+          "description": "Sys ID of the record to export",
+          "name": "sys-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "File path to write the exported XML to. If omitted, XML is printed to stdout.",
+          "name": "output",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workflow:create",
+      "id": "xml:export",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -9948,29 +10300,30 @@
       "relativePath": [
         "dist",
         "commands",
-        "workflow",
-        "create.js"
+        "xml",
+        "export.js"
       ]
     },
-    "workflow:publish": {
+    "xml:import": {
       "aliases": [],
       "args": {},
-      "description": "Publish a workflow version.",
+      "description": "Import XML records into a ServiceNow instance.\n\nReads an XML file and imports its contents into the specified target table. The XML should be in ServiceNow unload format.\n\nFeatures:\n  • Import from local XML files\n  • Target a specific table\n  • JSON output mode for CI/CD integration",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --version-id wfv-001 --start-activity act-001 --auth dev",
-          "description": "Publish a workflow version"
+          "description": "Import records from an XML file",
+          "command": "<%= config.bin %> <%= command.id %> --file ./export.xml --table sys_script_include --auth dev"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -v wfv-001 -s act-001 --json --auth dev",
-          "description": "Publish a workflow version and output as JSON"
+          "description": "Import with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> --file ./records.xml --table incident --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -10048,19 +10401,19 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-activity": {
-          "char": "s",
-          "description": "Sys ID of the start activity",
-          "name": "start-activity",
+        "file": {
+          "char": "f",
+          "description": "Path to the XML file to import",
+          "name": "file",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "version-id": {
-          "char": "v",
-          "description": "Sys ID of the workflow version to publish",
-          "name": "version-id",
+        "table": {
+          "char": "t",
+          "description": "Target table to import records into",
+          "name": "table",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -10069,7 +10422,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workflow:publish",
+      "id": "xml:import",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -10079,34 +10432,53 @@
       "relativePath": [
         "dist",
         "commands",
-        "workflow",
-        "publish.js"
+        "xml",
+        "import.js"
       ]
     },
-    "xml:export": {
+    "log": {
       "aliases": [],
       "args": {},
-      "description": "Export a single ServiceNow record as XML.\n\nDownloads the XML representation of a specific record from a ServiceNow table. Without --output, the XML is printed to stdout. With --output, the XML is written to the specified file path.\n\nFeatures:\n  • Export any record by table and sys_id\n  • Print XML to stdout for piping to other tools\n  • Save directly to a file with --output\n  • JSON output mode for CI/CD integration",
+      "description": "Tail and monitor ServiceNow system logs in real-time with beautiful formatting.\n\nThis command provides real-time log monitoring with enhanced visual formatting using color-coded output that makes logs easy to scan and understand at a glance. Automatically highlights errors, warnings, success messages, and important keywords.\n\nKey Features:\n  • Real-time log tailing (like Unix tail -f)\n  • Powerful filtering with multiple operators (CONTAINS, REGEX, EQUALS, etc.)\n  • Smart keyword highlighting (errors in red, warnings in yellow, etc.)\n  • Beautiful color-coded console output with chalk\n  • Export logs to file with automatic appending\n  • Fast 1-second default polling interval\n  • Timestamps and sequence numbers for each log\n  • Graceful shutdown with Ctrl+C\n  • Clean output without colors (--no-color flag)\n\nSmart Highlighting:\n  • Error terms (error, exception, failed) - highlighted in RED\n  • Warning terms (warn, warning, deprecated) - highlighted in YELLOW\n  • Success terms (success, completed, done) - highlighted in GREEN\n  • System terms (system, user, transaction) - highlighted in BLUE\n\nFiltering:\n  • Apply filters using --filter flag with syntax: \"field OPERATOR value\"\n  • Supports case-sensitive and case-insensitive operations\n  • Multiple filters are combined with AND logic\n  • Operators: CONTAINS, CONTAINS_CI, EQUALS, EQUALS_CI, STARTS_WITH, STARTS_WITH_CI,\n    ENDS_WITH, ENDS_WITH_CI, REGEX, NOT_CONTAINS, NOT_CONTAINS_CI, NOT_EQUALS, NOT_EQUALS_CI\n\nUse Cases:\n  • Monitor logs during application development\n  • Debug issues in real-time\n  • Track system events during deployments\n  • Filter logs for specific application or component\n  • Quickly spot errors and warnings\n  • Collect logs for analysis or audit trails\n\n⚠️  IMPORTANT NOTES:\n  • Press Ctrl+C to stop tailing and exit gracefully\n  • Log files are created/appended automatically\n  • Uses ChannelAjax when available for better performance\n  • Default poll interval is 1 second for real-time monitoring",
       "examples": [
         {
-          "description": "Export a record to stdout",
-          "command": "<%= config.bin %> <%= command.id %> --table sys_script_include --sys-id abc123def456 --auth dev"
+          "description": "Tail all logs in real-time",
+          "command": "<%= config.bin %> <%= command.id %> --auth dev-instance"
         },
         {
-          "description": "Export and save to a file",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --sys-id abc123 --output ./export.xml --auth dev"
+          "description": "Tail logs and save to a file",
+          "command": "<%= config.bin %> <%= command.id %> --output ./logs/instance-logs.txt --auth dev-instance"
         },
         {
-          "description": "Export as JSON metadata",
-          "command": "<%= config.bin %> <%= command.id %> --table sys_script --sys-id abc123 --json --auth dev"
+          "description": "Tail logs with custom polling interval (500ms for faster updates)",
+          "command": "<%= config.bin %> <%= command.id %> --interval 500 --auth dev-instance"
+        },
+        {
+          "description": "Filter logs containing specific text (case-insensitive)",
+          "command": "<%= config.bin %> <%= command.id %> --filter \"message CONTAINS_CI error\" --auth dev-instance"
+        },
+        {
+          "description": "Filter logs with multiple conditions (AND logic)",
+          "command": "<%= config.bin %> <%= command.id %> --filter \"message CONTAINS x_acme_app\" --filter \"message CONTAINS error\" --auth dev-instance"
+        },
+        {
+          "description": "Filter logs using regex pattern",
+          "command": "<%= config.bin %> <%= command.id %> --filter \"message REGEX .*exception.*\" --auth dev-instance"
+        },
+        {
+          "description": "Filter logs by message starting with a pattern",
+          "command": "<%= config.bin %> <%= command.id %> --filter \"message STARTS_WITH [ERROR]\" --auth dev-instance"
+        },
+        {
+          "description": "Tail logs without colored output",
+          "command": "<%= config.bin %> <%= command.id %> --no-color --auth dev-instance"
         }
       ],
       "flags": {
         "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
-          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -10184,37 +10556,45 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "table": {
-          "char": "t",
-          "description": "Table name of the record to export",
-          "name": "table",
-          "required": true,
+        "output": {
+          "char": "o",
+          "description": "Output file path to save logs. Creates parent directories if needed.",
+          "name": "output",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "sys-id": {
-          "char": "s",
-          "description": "Sys ID of the record to export",
-          "name": "sys-id",
-          "required": true,
+        "interval": {
+          "char": "i",
+          "description": "Polling interval in milliseconds",
+          "name": "interval",
+          "required": false,
+          "default": 1000,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "File path to write the exported XML to. If omitted, XML is printed to stdout.",
-          "name": "output",
+        "no-color": {
+          "description": "Disable colored output",
+          "name": "no-color",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "filter": {
+          "char": "f",
+          "description": "Filter logs by field and value. Syntax: field OPERATOR value. Operators: CONTAINS, CONTAINS_CI (case-insensitive), EQUALS, EQUALS_CI, STARTS_WITH, STARTS_WITH_CI, ENDS_WITH, ENDS_WITH_CI, REGEX, NOT_CONTAINS, NOT_EQUALS. Field defaults to \"message\" if omitted. Multiple filters are combined with AND logic.",
+          "name": "filter",
           "required": false,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "xml:export",
+      "id": "log",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -10224,22 +10604,30 @@
       "relativePath": [
         "dist",
         "commands",
-        "xml",
-        "export.js"
+        "log",
+        "index.js"
       ]
     },
-    "xml:import": {
+    "health:check": {
       "aliases": [],
       "args": {},
-      "description": "Import XML records into a ServiceNow instance.\n\nReads an XML file and imports its contents into the specified target table. The XML should be in ServiceNow unload format.\n\nFeatures:\n  • Import from local XML files\n  • Target a specific table\n  • JSON output mode for CI/CD integration",
+      "description": "Run a consolidated health check on a ServiceNow instance.\n\nPerforms comprehensive diagnostics including version info, cluster status, stuck job detection, semaphore counts, and operational record counts.\n\nFeatures:\n  • Instance version and build information\n  • Cluster node status\n  • Stuck job detection with configurable threshold\n  • Active semaphore count\n  • Operational counts (incidents, changes, problems)\n  • Color-coded status indicators\n  • JSON output for CI/CD monitoring",
       "examples": [
         {
-          "description": "Import records from an XML file",
-          "command": "<%= config.bin %> <%= command.id %> --file ./export.xml --table sys_script_include --auth dev"
+          "description": "Run full health check",
+          "command": "<%= config.bin %> <%= command.id %> --auth dev"
         },
         {
-          "description": "Import with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.xml --table incident --json --auth dev"
+          "description": "Check only version and stuck jobs",
+          "command": "<%= config.bin %> <%= command.id %> --include-version --include-stuck-jobs --no-include-cluster --no-include-semaphores --no-include-operational-counts --auth dev"
+        },
+        {
+          "description": "Health check with custom stuck job threshold",
+          "command": "<%= config.bin %> <%= command.id %> --stuck-job-threshold 60 --auth dev"
+        },
+        {
+          "description": "Health check as JSON",
+          "command": "<%= config.bin %> <%= command.id %> --json --auth dev"
         }
       ],
       "flags": {
@@ -10325,20 +10713,46 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to the XML file to import",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "include-version": {
+          "description": "Include instance version information",
+          "name": "include-version",
+          "required": false,
+          "allowNo": true,
+          "type": "boolean"
         },
-        "table": {
-          "char": "t",
-          "description": "Target table to import records into",
-          "name": "table",
-          "required": true,
+        "include-cluster": {
+          "description": "Include cluster node status",
+          "name": "include-cluster",
+          "required": false,
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "include-stuck-jobs": {
+          "description": "Include stuck job detection",
+          "name": "include-stuck-jobs",
+          "required": false,
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "include-semaphores": {
+          "description": "Include active semaphore count",
+          "name": "include-semaphores",
+          "required": false,
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "include-operational-counts": {
+          "description": "Include operational record counts (incidents, changes, problems)",
+          "name": "include-operational-counts",
+          "required": false,
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "stuck-job-threshold": {
+          "description": "Minutes threshold for a job to be considered stuck",
+          "name": "stuck-job-threshold",
+          "required": false,
+          "default": 30,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10346,7 +10760,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "xml:import",
+      "id": "health:check",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -10356,10 +10770,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "xml",
-        "import.js"
+        "health",
+        "check.js"
       ]
     }
   },
-  "version": "5.4.0"
+  "version": "5.6.0"
 }