@sonisoft/now-sdk-ext-cli 5.2.0 → 5.3.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",
@@ -2817,20 +2817,186 @@
         "index.js"
       ]
     },
-    "flow:action": {
+    "health:check": {
       "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": "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 an action",
-          "command": "<%= config.bin %> <%= command.id %> --name global.create_record --inputs '{\"table\":\"incident\",\"values\":{\"short_description\":\"Test\"}}' --auth dev"
-        }
-      ],
-      "flags": {
-        "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "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",
+      "examples": [
+        {
+          "description": "Run an action",
+          "command": "<%= config.bin %> <%= command.id %> --name global.create_record --inputs '{\"table\":\"incident\",\"values\":{\"short_description\":\"Test\"}}' --auth dev"
+        }
+      ],
+      "flags": {
+        "json": {
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
           "required": false,
           "allowNo": false,
@@ -3259,28 +3425,36 @@
         "copy.js"
       ]
     },
-    "flow:details": {
+    "flow:definition": {
       "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": "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 execution details after testing a flow",
-          "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --auth dev"
+          "description": "Summarise a flow definition",
+          "command": "<%= config.bin %> <%= command.id %> --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev"
         },
         {
-          "description": "Get details with explicit scope",
-          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --scope x_myapp --auth dev"
+          "description": "Retrieve a subflow definition",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev"
         },
         {
-          "description": "Get details with JSON output for scripting",
-          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --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,
@@ -3360,35 +3534,42 @@
           "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",
+        "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"
         },
-        "scope": {
-          "description": "Scope sys_id for the ProcessFlow API transaction scope parameter",
-          "name": "scope",
+        "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"
         },
-        "include-definition": {
-          "char": "d",
-          "description": "Include the full flow definition snapshot in the response",
-          "name": "include-definition",
+        "scope": {
+          "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,
-          "allowNo": false,
-          "type": "boolean"
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:details",
+      "id": "flow:definition",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3399,17 +3580,25 @@
         "dist",
         "commands",
         "flow",
-        "details.js"
+        "definition.js"
       ]
     },
-    "flow:error": {
+    "flow:details": {
       "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": "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 error details",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
+          "description": "Get execution details after testing a flow",
+          "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --auth dev"
+        },
+        {
+          "description": "Get details with explicit scope",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --scope x_myapp --auth dev"
+        },
+        {
+          "description": "Get details with JSON output for scripting",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
         }
       ],
       "flags": {
@@ -3497,7 +3686,7 @@
         },
         "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,
@@ -3505,17 +3694,25 @@
           "type": "option"
         },
         "scope": {
-          "description": "Scope context for script execution",
+          "description": "Scope sys_id for the ProcessFlow API transaction scope parameter",
           "name": "scope",
           "required": false,
           "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:error",
+      "id": "flow:details",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3526,25 +3723,17 @@
         "dist",
         "commands",
         "flow",
-        "error.js"
+        "details.js"
       ]
     },
-    "flow:logs": {
+    "flow:error": {
       "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": "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": "Get flow execution logs",
-          "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 logs with JSON output for scripting",
-          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
+          "description": "Get flow error details",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
         }
       ],
       "flags": {
@@ -3632,41 +3821,25 @@
         },
         "context-id": {
           "char": "c",
-          "description": "Flow context sys_id returned by flow test, flow run, flow subflow, or flow action",
+          "description": "Flow execution context sys_id",
           "name": "context-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "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",
+        "scope": {
+          "description": "Scope context for script execution",
+          "name": "scope",
           "required": false,
-          "default": "asc",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "asc",
-            "desc"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:logs",
+      "id": "flow:error",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3677,21 +3850,25 @@
         "dist",
         "commands",
         "flow",
-        "logs.js"
+        "error.js"
       ]
     },
-    "flow:message": {
+    "flow:logs": {
       "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 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": "Send a message to resume a waiting flow",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --message \"approved\" --auth dev"
+          "description": "Get flow execution logs",
+          "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --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 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": {
@@ -3779,43 +3956,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"
         },
-        "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",
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of log entries to return",
+          "name": "limit",
           "required": false,
+          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "scope": {
-          "description": "Scope context for script execution",
-          "name": "scope",
+        "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:message",
+      "id": "flow:logs",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3826,21 +4001,21 @@
         "dist",
         "commands",
         "flow",
-        "message.js"
+        "logs.js"
       ]
     },
-    "flow:outputs": {
+    "flow:message": {
       "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": "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": "Get flow outputs",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
+          "description": "Send a message to resume a waiting flow",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --message \"approved\" --auth dev"
         },
         {
-          "description": "Get outputs as JSON",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --json --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": {
@@ -3935,183 +4110,36 @@
           "multiple": false,
           "type": "option"
         },
-        "scope": {
-          "description": "Scope context for script execution",
-          "name": "scope",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "flow:outputs",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "flow",
-        "outputs.js"
-      ]
-    },
-    "flow:run": {
-      "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",
-      "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": "Run in background mode",
-          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --mode background --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"
-        },
-        "name": {
-          "char": "n",
-          "description": "Scoped name of the flow (e.g. global.my_flow)",
-          "name": "name",
+        "message": {
+          "char": "m",
+          "description": "Message to send to the flow",
+          "name": "message",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "inputs": {
-          "char": "i",
-          "description": "JSON object of input name-value pairs",
-          "name": "inputs",
-          "required": false,
-          "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",
@@ -4122,17 +4150,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": {
@@ -4238,7 +4270,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:status",
+      "id": "flow:outputs",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4249,21 +4281,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": {
@@ -4351,7 +4387,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,
@@ -4382,7 +4418,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,
@@ -4399,7 +4435,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:subflow",
+      "id": "flow:run",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4410,25 +4446,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": {
@@ -4514,43 +4542,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",
@@ -4561,29 +4573,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": {
@@ -4669,54 +4673,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",
@@ -4725,54 +4732,35 @@
       "isESM": true,
       "relativePath": [
         "dist",
-        "commands",
-        "health",
-        "check.js"
+        "commands",
+        "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"
         },
@@ -4850,45 +4838,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",
@@ -4898,8 +4884,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "log",
-        "index.js"
+        "flow",
+        "test.js"
       ]
     },
     "policy:status": {
@@ -5938,22 +5924,42 @@
         "validate-catalog.js"
       ]
     },
-    "scope": {
+    "log": {
       "aliases": [],
       "args": {},
-      "description": "Get the current application scope or list available applications.",
+      "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": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --auth dev",
-          "description": "Get the current application scope"
+          "description": "Tail all logs in real-time",
+          "command": "<%= config.bin %> <%= command.id %> --auth dev-instance"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --list --auth dev",
-          "description": "List all available applications"
+          "description": "Tail logs and save to a file",
+          "command": "<%= config.bin %> <%= command.id %> --output ./logs/instance-logs.txt --auth dev-instance"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -l --json --auth dev",
-          "description": "List applications as JSON"
+          "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": {
@@ -6038,140 +6044,45 @@
           "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",
+        "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"
         },
-        "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",
+        "interval": {
+          "char": "i",
+          "description": "Polling interval in milliseconds",
+          "name": "interval",
           "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "log-level": {
-          "helpGroup": "GLOBAL",
-          "name": "log-level",
-          "summary": "Specify level for logging.",
-          "default": "info",
+          "default": 1000,
           "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",
+        "no-color": {
+          "description": "Disable colored output",
+          "name": "no-color",
           "required": false,
           "allowNo": false,
           "type": "boolean"
         },
-        "app-id": {
-          "char": "a",
-          "description": "32-char sys_id of application",
-          "name": "app-id",
-          "required": true,
+        "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": "scope:set",
+      "id": "log",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6181,8 +6092,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "scope",
-        "set.js"
+        "log",
+        "index.js"
       ]
     },
     "script-sync:pull": {
@@ -9940,7 +9851,254 @@
         "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.2.0"
+  "version": "5.3.0"
 }