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

package/oclif.manifest.json

@@ -513,6 +513,240 @@
         "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": {},
@@ -1237,261 +1471,27 @@
         "uninstall.js"
       ]
     },
-    "atf": {
+    "attachment:get": {
       "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",
+      "description": "Get metadata for a specific attachment.",
       "examples": [
         {
-          "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 %> --sys-id att123 --auth dev",
+          "description": "Get attachment metadata by sys_id"
         },
         {
-          "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"
-      ]
-    },
-    "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"
+          "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",
@@ -2817,176 +2817,10 @@
         "index.js"
       ]
     },
-    "health:check": {
+    "flow:action": {
       "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",
-      "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": "Health check as JSON",
-          "command": "<%= config.bin %> <%= command.id %> --json --auth dev"
-        }
-      ],
-      "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"
-        },
-        "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"
-        },
-        "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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "health:check",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "health",
-        "check.js"
-      ]
-    },
-    "flow:action": {
-      "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": "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": "Run an action",
@@ -4723,7 +4557,324 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:subflow",
+      "id": "flow:subflow",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "subflow.js"
+      ]
+    },
+    "flow:test": {
+      "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",
+      "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"
+        }
+      ],
+      "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"
+        },
+        "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",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Scope sys_id for transaction scope (auto-resolved from flow definition if omitted)",
+          "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",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "test.js"
+      ]
+    },
+    "health:check": {
+      "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",
+      "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": "Health check as JSON",
+          "command": "<%= config.bin %> <%= command.id %> --json --auth dev"
+        }
+      ],
+      "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"
+        },
+        "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"
+        },
+        "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "health:check",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4733,34 +4884,53 @@
       "relativePath": [
         "dist",
         "commands",
-        "flow",
-        "subflow.js"
+        "health",
+        "check.js"
       ]
     },
-    "flow:test": {
+    "log": {
       "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": "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": "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": "Tail all logs in real-time",
+          "command": "<%= config.bin %> <%= command.id %> --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 and save to a file",
+          "command": "<%= config.bin %> <%= command.id %> --output ./logs/instance-logs.txt --auth dev-instance"
         },
         {
-          "description": "Test with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> -f 887dda5583237210fdb8f7b6feaad32c -o '{\"current\":\"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"
         },
@@ -4838,43 +5008,45 @@
           "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": {
+        "output": {
           "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",
-          "required": true,
+          "description": "Output file path to save logs. Creates parent directories if needed.",
+          "name": "output",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "scope": {
-          "description": "Scope sys_id for transaction scope (auto-resolved from flow definition if omitted)",
-          "name": "scope",
+        "interval": {
+          "char": "i",
+          "description": "Polling interval in milliseconds",
+          "name": "interval",
           "required": false,
+          "default": 1000,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "synchronous": {
-          "description": "Run test synchronously (default: true)",
-          "name": "synchronous",
+        "no-color": {
+          "description": "Disable colored output",
+          "name": "no-color",
           "required": false,
-          "allowNo": true,
+          "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": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:test",
+      "id": "log",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4884,8 +5056,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "flow",
-        "test.js"
+        "log",
+        "index.js"
       ]
     },
     "policy:status": {
@@ -5924,42 +6096,22 @@
         "validate-catalog.js"
       ]
     },
-    "log": {
+    "scope": {
       "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": "Get the current application scope or list available applications.",
       "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"
+          "command": "<%= config.bin %> <%= command.id %> --auth dev",
+          "description": "Get the current application scope"
         },
         {
-          "description": "Filter logs by message starting with a pattern",
-          "command": "<%= config.bin %> <%= command.id %> --filter \"message STARTS_WITH [ERROR]\" --auth dev-instance"
+          "command": "<%= config.bin %> <%= command.id %> --list --auth dev",
+          "description": "List all available applications"
         },
         {
-          "description": "Tail logs without colored output",
-          "command": "<%= config.bin %> <%= command.id %> --no-color --auth dev-instance"
+          "command": "<%= config.bin %> <%= command.id %> -l --json --auth dev",
+          "description": "List applications as JSON"
         }
       ],
       "flags": {
@@ -6044,45 +6196,140 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "output": {
-          "char": "o",
-          "description": "Output file path to save logs. Creates parent directories if needed.",
-          "name": "output",
+        "list": {
+          "char": "l",
+          "description": "List all available applications",
+          "name": "list",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "scope",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "scope",
+        "index.js"
+      ]
+    },
+    "scope:set": {
+      "aliases": [],
+      "args": {},
+      "description": "Set the current application scope on a ServiceNow instance.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --app-id abc123def456ghi789jkl012mno345pq --auth dev",
+          "description": "Set application scope by sys_id"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -a abc123def456ghi789jkl012mno345pq --json --auth dev",
+          "description": "Set application scope 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"
         },
-        "interval": {
-          "char": "i",
-          "description": "Polling interval in milliseconds",
-          "name": "interval",
+        "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,
-          "default": 1000,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-color": {
-          "description": "Disable colored output",
-          "name": "no-color",
+        "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"
         },
-        "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",
+        "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"
+        },
+        "app-id": {
+          "char": "a",
+          "description": "32-char sys_id of application",
+          "name": "app-id",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "log",
+      "id": "scope:set",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6092,8 +6339,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "log",
-        "index.js"
+        "scope",
+        "set.js"
       ]
     },
     "script-sync:pull": {
@@ -8498,11 +8745,272 @@
           "multiple": false,
           "type": "option"
         },
-        "number": {
-          "char": "n",
-          "description": "Incident number (e.g., INC0010001)",
-          "name": "number",
-          "required": true,
+        "number": {
+          "char": "n",
+          "description": "Incident number (e.g., INC0010001)",
+          "name": "number",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "task:resolve",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "task",
+        "resolve.js"
+      ]
+    },
+    "transaction:kill": {
+      "aliases": [],
+      "args": {},
+      "description": "Submit a request to terminate one active transaction. Platform acceptance does not mean immediate removal.\n\nOnly pass an identifier you deliberately selected from `nex transaction list`. Killing another user's transaction aborts their work.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --auth dev",
+        "<%= config.bin %> <%= command.id %> --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --json --auth dev"
+      ],
+      "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"
+        },
+        "confirm": {
+          "description": "Confirm submission of the kill request.",
+          "name": "confirm",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "transaction-id": {
+          "char": "t",
+          "description": "Exact 32-character hexadecimal sys_id from `nex transaction list`.",
+          "name": "transaction-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "transaction:kill",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "transaction",
+        "kill.js"
+      ]
+    },
+    "transaction:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List active transactions from all responding ServiceNow cluster nodes.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --auth dev",
+        "<%= config.bin %> <%= command.id %> --json --auth dev",
+        "<%= config.bin %> <%= command.id %> --query \"user=admin\" --limit 50 --auth dev",
+        "<%= config.bin %> <%= command.id %> --timeout-ms 120000 --poll-interval-ms 2000 --auth dev"
+      ],
+      "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"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum transactions to return. Core default: 1000.",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "poll-interval-ms": {
+          "description": "Interval between collection status polls. Core default: 1000.",
+          "name": "poll-interval-ms",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "query": {
+          "char": "q",
+          "description": "Encoded query used to filter transactions. Core default: none.",
+          "name": "query",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout-ms": {
+          "description": "Collection timeout in milliseconds. Core default: 60000.",
+          "name": "timeout-ms",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -8510,7 +9018,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "task:resolve",
+      "id": "transaction:list",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -8520,8 +9028,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "task",
-        "resolve.js"
+        "transaction",
+        "list.js"
       ]
     },
     "update-set:clone": {
@@ -9851,254 +10359,7 @@
         "xml",
         "import.js"
       ]
-    },
-    "scope": {
-      "aliases": [],
-      "args": {},
-      "description": "Get the current application scope or list available applications.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --auth dev",
-          "description": "Get the current application scope"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --list --auth dev",
-          "description": "List all available applications"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -l --json --auth dev",
-          "description": "List applications 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"
-        },
-        "list": {
-          "char": "l",
-          "description": "List all available applications",
-          "name": "list",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "scope",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "scope",
-        "index.js"
-      ]
-    },
-    "scope:set": {
-      "aliases": [],
-      "args": {},
-      "description": "Set the current application scope on a ServiceNow instance.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --app-id abc123def456ghi789jkl012mno345pq --auth dev",
-          "description": "Set application scope by sys_id"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -a abc123def456ghi789jkl012mno345pq --json --auth dev",
-          "description": "Set application scope 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"
-        },
-        "app-id": {
-          "char": "a",
-          "description": "32-char sys_id of application",
-          "name": "app-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "scope:set",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "scope",
-        "set.js"
-      ]
     }
   },
-  "version": "5.3.0"
+  "version": "5.4.0"
 }