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

package/oclif.manifest.json

@@ -2086,6 +2086,97 @@
         "list.js"
       ]
     },
+    "auth:open": {
+      "aliases": [],
+      "args": {},
+      "description": "Open a verified UI session in a dedicated desktop browser using a stored SDK alias.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> -a bcbsscdev --cred-store",
+          "description": "Open the alias in Edge"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -a dev206299 --browser chrome",
+          "description": "Open in Chrome"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -a dev206299 --cdp http://127.0.0.1:9222",
+          "description": "Inject into an already-debuggable browser"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth": {
+          "char": "a",
+          "description": "Stored SDK credential alias.",
+          "name": "auth",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "browser": {
+          "description": "Desktop browser to launch. Ignored when --cdp is set.",
+          "name": "browser",
+          "default": "edge",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "edge",
+            "chrome",
+            "brave"
+          ],
+          "type": "option"
+        },
+        "cdp": {
+          "description": "Existing DevTools URL. Skips launching a browser.",
+          "name": "cdp",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cred-store": {
+          "description": "Use the headless credential store.",
+          "name": "cred-store",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Replace an existing regular output file.",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "description": "Optional owner-only Playwright storage-state file.",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:open",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "open.js"
+      ]
+    },
     "auth:use": {
       "aliases": [],
       "args": {
@@ -2128,16 +2219,24 @@
         "use.js"
       ]
     },
-    "behavior:details": {
+    "batch:create": {
       "aliases": [],
       "args": {},
-      "description": "Retrieve known behavior artifacts without rediscovery. Repeat --reference kind:source_table:sys_id for up to 50 records. Add --details scripts, --details definitions or --details dependencies to include bodies immediately. Source references are returned by behavior discovery; flows also accept flows:sys_hub_flow:<sys_id>.",
+      "description": "Batch create records on a ServiceNow instance from a JSON file.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --reference business_rules:sys_script:0123456789abcdef0123456789abcdef --details scripts --auth dev --json"
+        {
+          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --auth dev",
+          "description": "Create records from a JSON file"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --no-transaction --auth dev",
+          "description": "Create records without transactional mode"
+        }
       ],
       "flags": {
         "json": {
-          "description": "Emit one JSON document",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
@@ -2216,53 +2315,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "dependency-depth": {
-          "description": "Expand one dependency level; requires --details dependencies",
-          "name": "dependency-depth",
-          "default": 0,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "details": {
-          "description": "Include selected detail now; repeat for multiple kinds",
-          "name": "details",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "scripts",
-            "definitions",
-            "dependencies"
-          ],
-          "type": "option"
-        },
-        "max-bytes": {
-          "description": "Maximum JSON response bytes; omissions include retrieval references",
-          "name": "max-bytes",
-          "default": 65536,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "scope": {
-          "description": "Transaction scope for flow definition reads",
-          "name": "scope",
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file with create operations",
+          "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "reference": {
-          "description": "kind:source_table:sys_id; repeat for a batch",
-          "name": "reference",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "transaction": {
+          "description": "Stop on first error (transactional)",
+          "name": "transaction",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "behavior:details",
+      "id": "batch:create",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2272,21 +2344,28 @@
       "relativePath": [
         "dist",
         "commands",
-        "behavior",
-        "details.js"
+        "batch",
+        "create.js"
       ]
     },
-    "behavior": {
+    "batch:update": {
       "aliases": [],
       "args": {},
-      "description": "Discover table behavior: rules, UI actions/scripts, UI/data policies, workflows, flows and state models. Active and applicable inherited behavior is included by default. Conditions describe configuration, not a prediction of execution. Select categories and details to control output size.",
+      "description": "Batch update records on a ServiceNow instance from a JSON file.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --table incident --auth dev --json",
-        "<%= config.bin %> <%= command.id %> --table change_request --category business_rules --details scripts --auth dev --json"
+        {
+          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --auth dev",
+          "description": "Update records from a JSON file"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --stop-on-error --auth dev",
+          "description": "Update records and stop on first error"
+        }
       ],
       "flags": {
         "json": {
-          "description": "Emit one JSON document",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
@@ -2365,112 +2444,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "dependency-depth": {
-          "description": "Expand one dependency level; requires --details dependencies",
-          "name": "dependency-depth",
-          "default": 0,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "details": {
-          "description": "Include selected detail now; repeat for multiple kinds",
-          "name": "details",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "scripts",
-            "definitions",
-            "dependencies"
-          ],
-          "type": "option"
-        },
-        "max-bytes": {
-          "description": "Maximum JSON response bytes; omissions include retrieval references",
-          "name": "max-bytes",
-          "default": 65536,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "scope": {
-          "description": "Transaction scope for flow definition reads",
-          "name": "scope",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "category": {
-          "description": "Category to inspect; repeat to select several, default all",
-          "name": "category",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "business_rules",
-            "ui_actions",
-            "client_scripts",
-            "ui_policies",
-            "data_policies",
-            "workflows",
-            "flows",
-            "state_models"
-          ],
-          "type": "option"
-        },
-        "cursor": {
-          "description": "Continuation token; requires exactly one --category and the same filters",
-          "name": "cursor",
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file with update operations",
+          "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "include-inactive": {
-          "description": "Include inactive/published and draft candidates when discoverable",
-          "name": "include-inactive",
+        "stop-on-error": {
+          "description": "Stop processing on first error",
+          "name": "stop-on-error",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
-        },
-        "include-inherited": {
-          "description": "Include applicable ancestor behavior",
-          "name": "include-inherited",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Maximum items per category",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Metadata name contains this text",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sys-id": {
-          "description": "Metadata source sys_id to include; repeat for multiple records",
-          "name": "sys-id",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "table": {
-          "char": "t",
-          "description": "Target table name",
-          "name": "table",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "behavior",
+      "id": "batch:update",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2480,28 +2473,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "behavior",
-        "index.js"
+        "batch",
+        "update.js"
       ]
     },
-    "batch:create": {
+    "behavior:details": {
       "aliases": [],
       "args": {},
-      "description": "Batch create records on a ServiceNow instance from a JSON file.",
+      "description": "Retrieve known behavior artifacts without rediscovery. Repeat --reference kind:source_table:sys_id for up to 50 records. Add --details scripts, --details definitions or --details dependencies to include bodies immediately. Source references are returned by behavior discovery; flows also accept flows:sys_hub_flow:<sys_id>.",
       "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --auth dev",
-          "description": "Create records from a JSON file"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --no-transaction --auth dev",
-          "description": "Create records without transactional mode"
-        }
+        "<%= config.bin %> <%= command.id %> --reference business_rules:sys_script:0123456789abcdef0123456789abcdef --details scripts --auth dev --json"
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "description": "Emit one JSON document",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
@@ -2580,26 +2565,53 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file with create operations",
-          "name": "file",
-          "required": true,
+        "dependency-depth": {
+          "description": "Expand one dependency level; requires --details dependencies",
+          "name": "dependency-depth",
+          "default": 0,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "transaction": {
-          "description": "Stop on first error (transactional)",
-          "name": "transaction",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
+        "details": {
+          "description": "Include selected detail now; repeat for multiple kinds",
+          "name": "details",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "scripts",
+            "definitions",
+            "dependencies"
+          ],
+          "type": "option"
+        },
+        "max-bytes": {
+          "description": "Maximum JSON response bytes; omissions include retrieval references",
+          "name": "max-bytes",
+          "default": 65536,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Transaction scope for flow definition reads",
+          "name": "scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "reference": {
+          "description": "kind:source_table:sys_id; repeat for a batch",
+          "name": "reference",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "batch:create",
+      "id": "behavior:details",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2609,28 +2621,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "batch",
-        "create.js"
+        "behavior",
+        "details.js"
       ]
     },
-    "batch:update": {
+    "behavior": {
       "aliases": [],
       "args": {},
-      "description": "Batch update records on a ServiceNow instance from a JSON file.",
+      "description": "Discover table behavior: rules, UI actions/scripts, UI/data policies, workflows, flows and state models. Active and applicable inherited behavior is included by default. Conditions describe configuration, not a prediction of execution. Select categories and details to control output size.",
       "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --auth dev",
-          "description": "Update records from a JSON file"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --stop-on-error --auth dev",
-          "description": "Update records and stop on first error"
-        }
+        "<%= config.bin %> <%= command.id %> --table incident --auth dev --json",
+        "<%= config.bin %> <%= command.id %> --table change_request --category business_rules --details scripts --auth dev --json"
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "description": "Emit one JSON document",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
@@ -2709,26 +2714,112 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file with update operations",
-          "name": "file",
+        "dependency-depth": {
+          "description": "Expand one dependency level; requires --details dependencies",
+          "name": "dependency-depth",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "details": {
+          "description": "Include selected detail now; repeat for multiple kinds",
+          "name": "details",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "scripts",
+            "definitions",
+            "dependencies"
+          ],
+          "type": "option"
+        },
+        "max-bytes": {
+          "description": "Maximum JSON response bytes; omissions include retrieval references",
+          "name": "max-bytes",
+          "default": 65536,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Transaction scope for flow definition reads",
+          "name": "scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "category": {
+          "description": "Category to inspect; repeat to select several, default all",
+          "name": "category",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "business_rules",
+            "ui_actions",
+            "client_scripts",
+            "ui_policies",
+            "data_policies",
+            "workflows",
+            "flows",
+            "state_models"
+          ],
+          "type": "option"
+        },
+        "cursor": {
+          "description": "Continuation token; requires exactly one --category and the same filters",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "include-inactive": {
+          "description": "Include inactive/published and draft candidates when discoverable",
+          "name": "include-inactive",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "include-inherited": {
+          "description": "Include applicable ancestor behavior",
+          "name": "include-inherited",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Maximum items per category",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Metadata name contains this text",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sys-id": {
+          "description": "Metadata source sys_id to include; repeat for multiple records",
+          "name": "sys-id",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "table": {
+          "char": "t",
+          "description": "Target table name",
+          "name": "table",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "stop-on-error": {
-          "description": "Stop processing on first error",
-          "name": "stop-on-error",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "batch:update",
+      "id": "behavior",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2738,8 +2829,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "batch",
-        "update.js"
+        "behavior",
+        "index.js"
       ]
     },
     "bulk:delete": {
@@ -3109,24 +3200,305 @@
           "description": "Execute and save output to a file",
           "command": "<%= config.bin %> <%= command.id %> global ./scripts/report.js --auth dev-instance > report.txt"
         },
-        {
-          "description": "Execute and pipe output to grep for filtering",
-          "command": "<%= config.bin %> <%= command.id %> global ./scripts/list-users.js --auth dev-instance | grep \"admin\""
+        {
+          "description": "Execute and pipe output to grep for filtering",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/list-users.js --auth dev-instance | grep \"admin\""
+        },
+        {
+          "description": "Execute with debug logging to troubleshoot issues",
+          "command": "<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --log-level debug"
+        },
+        {
+          "description": "Execute with parameters for template replacement",
+          "command": "<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --params '{\"token\":\"abc123\",\"env\":\"dev\"}'"
+        }
+      ],
+      "flags": {
+        "json": {
+          "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"
+        },
+        "params": {
+          "char": "p",
+          "description": "JSON object of parameters to replace in script file. Use {paramName} syntax in your script.",
+          "name": "params",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "exec",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "autocomplete": {},
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "exec",
+        "index.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,
+          "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 action (e.g. global.create_record)",
+          "name": "name",
+          "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",
+          "required": false,
+          "default": "foreground",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "foreground",
+            "background"
+          ],
+          "type": "option"
+        },
+        "scope": {
+          "description": "Scope context for script execution",
+          "name": "scope",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
+        "quick": {
+          "description": "Skip execution detail records for better performance",
+          "name": "quick",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:action",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "action.js"
+      ]
+    },
+    "flow:cancel": {
+      "aliases": [],
+      "args": {},
+      "description": "Cancel a running or paused flow execution.\n\nCancels a flow context that is in QUEUED, IN_PROGRESS, or WAITING state.",
+      "examples": [
         {
-          "description": "Execute with debug logging to troubleshoot issues",
-          "command": "<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --log-level debug"
+          "description": "Cancel a running flow",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
         },
         {
-          "description": "Execute with parameters for template replacement",
-          "command": "<%= config.bin %> <%= command.id %> global ./script.js --auth dev-instance --params '{\"token\":\"abc123\",\"env\":\"dev\"}'"
+          "description": "Cancel with a reason",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --reason \"No longer needed\" --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"
         },
@@ -3204,10 +3576,27 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "params": {
-          "char": "p",
-          "description": "JSON object of parameters to replace in script file. Use {paramName} syntax in your script.",
-          "name": "params",
+        "context-id": {
+          "char": "c",
+          "description": "Flow execution context sys_id",
+          "name": "context-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "reason": {
+          "char": "r",
+          "description": "Cancellation reason",
+          "name": "reason",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Scope context for script execution",
+          "name": "scope",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3216,29 +3605,36 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "exec",
+      "id": "flow:cancel",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "autocomplete": {},
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "exec",
-        "index.js"
+        "flow",
+        "cancel.js"
       ]
     },
-    "flow:action": {
+    "flow:copy": {
       "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": "Copy an existing flow into a target scoped application.\n\nThis is the ServiceNow best practice before modifying any flow — OOB and shared flows must never be modified directly; always copy first. The copied flow lands in draft/unpublished state in the target scope.\n\nEnables the full CLI-driven flow development lifecycle:\n  copy → pull (now-sdk transform) → modify → push → test → publish\n\nFeatures:\n  • Copy flows by sys_id or scoped name\n  • Specify a display name for the new copy\n  • Target any scoped application by sys_id\n  • Returns the new flow sys_id for use in subsequent commands",
       "examples": [
         {
-          "description": "Run an action",
-          "command": "<%= config.bin %> <%= command.id %> --name global.create_record --inputs '{\"table\":\"incident\",\"values\":{\"short_description\":\"Test\"}}' --auth dev"
+          "description": "Copy an OOB flow into your app scope",
+          "command": "<%= config.bin %> <%= command.id %> --source-flow-id e89e3ade731310108ef62d2b04f6a744 --name \"Copy of Change - Standard\" --target-scope 4a5a6115402946939ee48e3fe80f60f8 --auth dev"
+        },
+        {
+          "description": "Copy by scoped name",
+          "command": "<%= config.bin %> <%= command.id %> -s global.change__standard -n \"My Custom Change Flow\" -t 4a5a6115402946939ee48e3fe80f60f8 --auth dev"
+        },
+        {
+          "description": "Copy with JSON output for scripting",
+          "command": "<%= config.bin %> <%= command.id %> -s e89e3ade731310108ef62d2b04f6a744 -n \"Copy\" -t 4a5a6115402946939ee48e3fe80f60f8 --json --auth dev"
         }
       ],
       "flags": {
@@ -3324,57 +3720,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "char": "n",
-          "description": "Scoped name of the action (e.g. global.create_record)",
-          "name": "name",
+        "source-flow-id": {
+          "char": "s",
+          "description": "Source flow sys_id or scoped name (e.g. global.change__standard)",
+          "name": "source-flow-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "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",
-          "required": false,
-          "default": "foreground",
+        "name": {
+          "char": "n",
+          "description": "Display name for the new copied flow",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "foreground",
-            "background"
-          ],
           "type": "option"
         },
-        "scope": {
-          "description": "Scope context for script execution",
-          "name": "scope",
-          "required": false,
+        "target-scope": {
+          "char": "t",
+          "description": "Scope sys_id of the target application (use `nex scope` to find scope sys_ids)",
+          "name": "target-scope",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "quick": {
-          "description": "Skip execution detail records for better performance",
-          "name": "quick",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:action",
+      "id": "flow:copy",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3385,27 +3761,39 @@
         "dist",
         "commands",
         "flow",
-        "action.js"
+        "copy.js"
       ]
     },
-    "flow:cancel": {
+    "flow:definition": {
       "aliases": [],
       "args": {},
-      "description": "Cancel a running or paused flow execution.\n\nCancels a flow context that is in QUEUED, IN_PROGRESS, or WAITING state.",
+      "description": "Retrieve the read-only design-time definition of a flow, subflow, or action.\n\nReturns what the artifact IS, not what a run of it did: triggers, actions, nested subflows, flow logic, inputs and outputs as Workflow Studio stores them. Nothing is executed, published or modified, and no flow context is created or required.\n\nThis is the design-time counterpart to `flow details`, which describes one past execution and needs a context sys_id.\n\nThe type is never inferred from the sys_id: --type selects the artifact that is asked for, and a sys_id of a different type fails with a type_mismatch rather than being relabelled.\n\nWith --json, stdout carries exactly one JSON document — the complete typed result including the untouched ServiceNow payload — so it can be piped or redirected. Without it, a short summary is printed; definition bodies, step scripts and input values are never printed or logged.",
       "examples": [
         {
-          "description": "Cancel a running flow",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
+          "description": "Summarise a flow definition",
+          "command": "<%= config.bin %> <%= command.id %> --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev"
         },
         {
-          "description": "Cancel with a reason",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --reason \"No longer needed\" --auth dev"
+          "description": "Retrieve a subflow definition",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev"
+        },
+        {
+          "description": "Retrieve a custom action definition with its ordered steps",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev"
+        },
+        {
+          "description": "Redirect the full JSON definition to a file",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json"
+        },
+        {
+          "description": "Pipe the JSON definition into another tool",
+          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps"
         }
       ],
       "flags": {
         "json": {
           "char": "j",
-          "description": "Output results as JSON",
+          "description": "Output the complete typed result as JSON",
           "name": "json",
           "required": false,
           "allowNo": false,
@@ -3485,26 +3873,32 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "context-id": {
-          "char": "c",
-          "description": "Flow execution context sys_id",
-          "name": "context-id",
+        "sys-id": {
+          "char": "i",
+          "description": "sys_id of the flow, subflow, or action to retrieve",
+          "name": "sys-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "reason": {
-          "char": "r",
-          "description": "Cancellation reason",
-          "name": "reason",
+        "type": {
+          "char": "t",
+          "description": "Artifact type to retrieve. Must match what the sys_id actually is.",
+          "name": "type",
           "required": false,
+          "default": "flow",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "flow",
+            "subflow",
+            "action"
+          ],
           "type": "option"
         },
         "scope": {
-          "description": "Scope context for script execution",
+          "description": "Scope sys_id or name for the transaction scope parameter. Optional — ServiceNow resolves the artifact's own scope when omitted.",
           "name": "scope",
           "required": false,
           "hasDynamicHelp": false,
@@ -3514,7 +3908,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:cancel",
+      "id": "flow:definition",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3525,25 +3919,25 @@
         "dist",
         "commands",
         "flow",
-        "cancel.js"
+        "definition.js"
       ]
     },
-    "flow:copy": {
+    "flow:details": {
       "aliases": [],
       "args": {},
-      "description": "Copy an existing flow into a target scoped application.\n\nThis is the ServiceNow best practice before modifying any flow — OOB and shared flows must never be modified directly; always copy first. The copied flow lands in draft/unpublished state in the target scope.\n\nEnables the full CLI-driven flow development lifecycle:\n  copy → pull (now-sdk transform) → modify → push → test → publish\n\nFeatures:\n  • Copy flows by sys_id or scoped name\n  • Specify a display name for the new copy\n  • Target any scoped application by sys_id\n  • Returns the new flow sys_id for use in subsequent commands",
+      "description": "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": "Copy an OOB flow into your app scope",
-          "command": "<%= config.bin %> <%= command.id %> --source-flow-id e89e3ade731310108ef62d2b04f6a744 --name \"Copy of Change - Standard\" --target-scope 4a5a6115402946939ee48e3fe80f60f8 --auth dev"
+          "description": "Get execution details after testing a flow",
+          "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --auth dev"
         },
         {
-          "description": "Copy by scoped name",
-          "command": "<%= config.bin %> <%= command.id %> -s global.change__standard -n \"My Custom Change Flow\" -t 4a5a6115402946939ee48e3fe80f60f8 --auth dev"
+          "description": "Get details with explicit scope",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --scope x_myapp --auth dev"
         },
         {
-          "description": "Copy with JSON output for scripting",
-          "command": "<%= config.bin %> <%= command.id %> -s e89e3ade731310108ef62d2b04f6a744 -n \"Copy\" -t 4a5a6115402946939ee48e3fe80f60f8 --json --auth dev"
+          "description": "Get details with JSON output for scripting",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
         }
       ],
       "flags": {
@@ -3629,37 +4023,35 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "source-flow-id": {
-          "char": "s",
-          "description": "Source flow sys_id or scoped name (e.g. global.change__standard)",
-          "name": "source-flow-id",
+        "context-id": {
+          "char": "c",
+          "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"
         },
-        "name": {
-          "char": "n",
-          "description": "Display name for the new copied flow",
-          "name": "name",
-          "required": true,
+        "scope": {
+          "description": "Scope sys_id for the ProcessFlow API transaction scope parameter",
+          "name": "scope",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "target-scope": {
-          "char": "t",
-          "description": "Scope sys_id of the target application (use `nex scope` to find scope sys_ids)",
-          "name": "target-scope",
-          "required": true,
-          "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:copy",
+      "id": "flow:details",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3670,39 +4062,23 @@
         "dist",
         "commands",
         "flow",
-        "copy.js"
+        "details.js"
       ]
     },
-    "flow:definition": {
+    "flow:error": {
       "aliases": [],
       "args": {},
-      "description": "Retrieve the read-only design-time definition of a flow, subflow, or action.\n\nReturns what the artifact IS, not what a run of it did: triggers, actions, nested subflows, flow logic, inputs and outputs as Workflow Studio stores them. Nothing is executed, published or modified, and no flow context is created or required.\n\nThis is the design-time counterpart to `flow details`, which describes one past execution and needs a context sys_id.\n\nThe type is never inferred from the sys_id: --type selects the artifact that is asked for, and a sys_id of a different type fails with a type_mismatch rather than being relabelled.\n\nWith --json, stdout carries exactly one JSON document — the complete typed result including the untouched ServiceNow payload — so it can be piped or redirected. Without it, a short summary is printed; definition bodies, step scripts and input values are never printed or logged.",
+      "description": "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": "Summarise a flow definition",
-          "command": "<%= config.bin %> <%= command.id %> --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev"
-        },
-        {
-          "description": "Retrieve a subflow definition",
-          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev"
-        },
-        {
-          "description": "Retrieve a custom action definition with its ordered steps",
-          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev"
-        },
-        {
-          "description": "Redirect the full JSON definition to a file",
-          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json"
-        },
-        {
-          "description": "Pipe the JSON definition into another tool",
-          "command": "<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps"
+          "description": "Get flow error details",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
         }
       ],
       "flags": {
         "json": {
           "char": "j",
-          "description": "Output the complete typed result as JSON",
+          "description": "Output results as JSON",
           "name": "json",
           "required": false,
           "allowNo": false,
@@ -3782,32 +4158,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "sys-id": {
-          "char": "i",
-          "description": "sys_id of the flow, subflow, or action to retrieve",
-          "name": "sys-id",
+        "context-id": {
+          "char": "c",
+          "description": "Flow execution context sys_id",
+          "name": "context-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "type": {
-          "char": "t",
-          "description": "Artifact type to retrieve. Must match what the sys_id actually is.",
-          "name": "type",
-          "required": false,
-          "default": "flow",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "flow",
-            "subflow",
-            "action"
-          ],
-          "type": "option"
-        },
         "scope": {
-          "description": "Scope sys_id or name for the transaction scope parameter. Optional — ServiceNow resolves the artifact's own scope when omitted.",
+          "description": "Scope context for script execution",
           "name": "scope",
           "required": false,
           "hasDynamicHelp": false,
@@ -3817,7 +4178,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:definition",
+      "id": "flow:error",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3828,24 +4189,24 @@
         "dist",
         "commands",
         "flow",
-        "definition.js"
+        "error.js"
       ]
     },
-    "flow:details": {
+    "flow:logs": {
       "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 flow execution log entries for a given context.\n\nLog entries include error messages, step-level debug output, and cancellation reasons. Use this alongside flow details to get the full picture of what happened during an execution.\n\nQueries sys_flow_log entries and maps numeric log levels to human-readable names (ERROR, WARN, INFO, DEBUG).\n\nNOTE: Log entries may be empty for simple successful executions, or if the flow reporting level is set to NONE. Errors and warnings are always logged regardless of the reporting level setting.",
       "examples": [
         {
-          "description": "Get execution details after testing a flow",
+          "description": "Get flow execution logs",
           "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 latest 10 log entries in reverse order",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --limit 10 --order desc --auth dev"
         },
         {
-          "description": "Get details with JSON output for scripting",
+          "description": "Get logs with JSON output for scripting",
           "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
         }
       ],
@@ -3941,26 +4302,34 @@
           "multiple": false,
           "type": "option"
         },
-        "scope": {
-          "description": "Scope sys_id for the ProcessFlow API transaction scope parameter",
-          "name": "scope",
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of log entries to return",
+          "name": "limit",
           "required": false,
+          "default": 100,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "include-definition": {
-          "char": "d",
-          "description": "Include the full flow definition snapshot in the response",
-          "name": "include-definition",
+        "order": {
+          "char": "o",
+          "description": "Order direction: asc (oldest first) or desc (newest first)",
+          "name": "order",
           "required": false,
-          "allowNo": false,
-          "type": "boolean"
+          "default": "asc",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "asc",
+            "desc"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:details",
+      "id": "flow:logs",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -3971,17 +4340,21 @@
         "dist",
         "commands",
         "flow",
-        "details.js"
+        "logs.js"
       ]
     },
-    "flow:error": {
+    "flow:message": {
       "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": "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 error details",
-          "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": "Send a message with a JSON payload",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --message \"data_ready\" --payload '{\"status\":\"ok\"}' --auth dev"
         }
       ],
       "flags": {
@@ -4076,6 +4449,24 @@
           "multiple": false,
           "type": "option"
         },
+        "message": {
+          "char": "m",
+          "description": "Message to send to the flow",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "payload": {
+          "char": "p",
+          "description": "Optional JSON payload to include with the message",
+          "name": "payload",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "scope": {
           "description": "Scope context for script execution",
           "name": "scope",
@@ -4087,7 +4478,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:error",
+      "id": "flow:message",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4098,25 +4489,21 @@
         "dist",
         "commands",
         "flow",
-        "error.js"
+        "message.js"
       ]
     },
-    "flow:logs": {
+    "flow:outputs": {
       "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 outputs from a completed flow execution.\n\nGets the output name-value pairs from a flow, subflow, or action execution context.",
       "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 flow outputs",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
         },
         {
-          "description": "Get logs with JSON output for scripting",
-          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
+          "description": "Get outputs as JSON",
+          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --json --auth dev"
         }
       ],
       "flags": {
@@ -4204,41 +4591,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:outputs",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4249,21 +4620,25 @@
         "dist",
         "commands",
         "flow",
-        "logs.js"
+        "outputs.js"
       ]
     },
-    "flow:message": {
+    "flow:run": {
       "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": "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": "Send a message to resume a waiting flow",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --message \"approved\" --auth dev"
+          "description": "Run a flow in foreground mode",
+          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --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": "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": {
@@ -4349,45 +4724,57 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "context-id": {
-          "char": "c",
-          "description": "Flow execution context sys_id",
-          "name": "context-id",
+        "name": {
+          "char": "n",
+          "description": "Scoped name of the flow (e.g. global.my_flow)",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "char": "m",
-          "description": "Message to send to the flow",
-          "name": "message",
-          "required": true,
+        "inputs": {
+          "char": "i",
+          "description": "JSON object of input name-value pairs",
+          "name": "inputs",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "payload": {
-          "char": "p",
-          "description": "Optional JSON payload to include with the message",
-          "name": "payload",
+        "mode": {
+          "char": "m",
+          "description": "Execution mode",
+          "name": "mode",
           "required": false,
+          "default": "foreground",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "foreground",
+            "background"
+          ],
           "type": "option"
         },
         "scope": {
-          "description": "Scope context for script execution",
+          "description": "Scope context for script execution (e.g. global, x_myapp)",
           "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:message",
+      "id": "flow:run",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4398,21 +4785,17 @@
         "dist",
         "commands",
         "flow",
-        "message.js"
+        "run.js"
       ]
     },
-    "flow:outputs": {
+    "flow:status": {
       "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": "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": "Get flow outputs",
+          "description": "Check flow execution status",
           "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": {
@@ -4518,7 +4901,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:outputs",
+      "id": "flow:status",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4529,25 +4912,21 @@
         "dist",
         "commands",
         "flow",
-        "outputs.js"
+        "status.js"
       ]
     },
-    "flow:run": {
+    "flow:subflow": {
       "aliases": [],
       "args": {},
-      "description": "Execute a published Flow Designer flow by scoped name.\n\nRuns a flow using the sn_fd.FlowAPI ScriptableFlowRunner. Supports foreground (synchronous) and background (asynchronous) execution modes.\n\nNote: This command requires the flow to be published. For testing flows that are not yet published (draft/saved state), use `flow test` instead.\n\nFeatures:\n  • Execute flows by scoped name (e.g. global.my_flow)\n  • Pass input values as JSON\n  • Foreground or background execution mode\n  • Quick mode to skip execution detail records\n  • Returns context ID, outputs, and debug information",
+      "description": "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 a flow in foreground mode",
-          "command": "<%= config.bin %> <%= command.id %> --name global.my_flow --auth dev"
+          "description": "Run a subflow",
+          "command": "<%= config.bin %> <%= command.id %> --name global.my_subflow --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"
+          "command": "<%= config.bin %> <%= command.id %> --name x_myapp.process_record --inputs '{\"table\":\"incident\",\"sys_id\":\"abc123\"}' --auth dev"
         }
       ],
       "flags": {
@@ -4635,7 +5014,7 @@
         },
         "name": {
           "char": "n",
-          "description": "Scoped name of the flow (e.g. global.my_flow)",
+          "description": "Scoped name of the subflow (e.g. global.my_subflow)",
           "name": "name",
           "required": true,
           "hasDynamicHelp": false,
@@ -4666,7 +5045,7 @@
           "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,
@@ -4683,7 +5062,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "flow:run",
+      "id": "flow:subflow",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4694,17 +5073,25 @@
         "dist",
         "commands",
         "flow",
-        "run.js"
+        "subflow.js"
       ]
     },
-    "flow:status": {
+    "flow:test": {
       "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": "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": "Check flow execution status",
-          "command": "<%= config.bin %> <%= command.id %> --context-id abc123def456 --auth dev"
+          "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": {
@@ -4790,27 +5177,43 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "context-id": {
-          "char": "c",
-          "description": "Flow execution context sys_id",
-          "name": "context-id",
+        "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 context for script execution",
+          "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:status",
+      "id": "flow:test",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4821,21 +5224,29 @@
         "dist",
         "commands",
         "flow",
-        "status.js"
+        "test.js"
       ]
     },
-    "flow:subflow": {
+    "health:check": {
       "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": "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 a subflow",
-          "command": "<%= config.bin %> <%= command.id %> --name global.my_subflow --auth dev"
+          "description": "Run full health check",
+          "command": "<%= config.bin %> <%= command.id %> --auth dev"
         },
         {
-          "description": "Run with inputs",
-          "command": "<%= config.bin %> <%= command.id %> --name x_myapp.process_record --inputs '{\"table\":\"incident\",\"sys_id\":\"abc123\"}' --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": {
@@ -4921,57 +5332,54 @@
           "allowNo": false,
           "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-version": {
+          "description": "Include instance version information",
+          "name": "include-version",
+          "required": false,
+          "allowNo": true,
+          "type": "boolean"
         },
-        "inputs": {
-          "char": "i",
-          "description": "JSON object of input name-value pairs",
-          "name": "inputs",
+        "include-cluster": {
+          "description": "Include cluster node status",
+          "name": "include-cluster",
           "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "allowNo": true,
+          "type": "boolean"
         },
-        "mode": {
-          "char": "m",
-          "description": "Execution mode",
-          "name": "mode",
+        "include-stuck-jobs": {
+          "description": "Include stuck job detection",
+          "name": "include-stuck-jobs",
           "required": false,
-          "default": "foreground",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "foreground",
-            "background"
-          ],
-          "type": "option"
+          "allowNo": true,
+          "type": "boolean"
         },
-        "scope": {
-          "description": "Scope context for script execution",
-          "name": "scope",
+        "include-semaphores": {
+          "description": "Include active semaphore count",
+          "name": "include-semaphores",
           "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "allowNo": true,
+          "type": "boolean"
         },
-        "quick": {
-          "description": "Skip execution detail records for better performance",
-          "name": "quick",
+        "include-operational-counts": {
+          "description": "Include operational record counts (incidents, changes, problems)",
+          "name": "include-operational-counts",
           "required": false,
-          "allowNo": 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": "flow:subflow",
+      "id": "health:check",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4981,34 +5389,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"
         },
@@ -5086,43 +5513,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",
@@ -5132,8 +5561,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "flow",
-        "test.js"
+        "log",
+        "index.js"
       ]
     },
     "policy:status": {
@@ -9901,288 +10330,30 @@
       "isESM": true,
       "relativePath": [
         "dist",
-        "commands",
-        "update-set",
-        "move.js"
-      ]
-    },
-    "workflow:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a complete workflow from a JSON specification file.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --spec ./workflow.json --auth dev",
-          "description": "Create a workflow from a JSON spec file"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -s ./workflow.json --json --auth dev",
-          "description": "Create a workflow and output result as JSON"
-        }
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "auth": {
-          "char": "a",
-          "description": "Auth alias to use.",
-          "name": "auth",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cred-store": {
-          "description": "Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.",
-          "helpGroup": "GLOBAL",
-          "name": "cred-store",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deny-execute": {
-          "description": "Refuse background scripts, flow runs and ATF runs for this invocation.",
-          "helpGroup": "GLOBAL",
-          "name": "deny-execute",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deny-write": {
-          "description": "Refuse any change to instance data for this invocation.",
-          "helpGroup": "GLOBAL",
-          "name": "deny-write",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "log-dir": {
-          "description": "Directory to write log files to. Implies --log-file.",
-          "helpGroup": "GLOBAL",
-          "name": "log-dir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "log-file": {
-          "description": "Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to stderr only.",
-          "helpGroup": "GLOBAL",
-          "name": "log-file",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "log-level": {
-          "helpGroup": "GLOBAL",
-          "name": "log-level",
-          "summary": "Specify level for logging.",
-          "default": "info",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "debug",
-            "warn",
-            "error",
-            "info",
-            "trace"
-          ],
-          "type": "option"
-        },
-        "read-only": {
-          "description": "Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are unaffected.",
-          "helpGroup": "GLOBAL",
-          "name": "read-only",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "spec": {
-          "char": "s",
-          "description": "Path to workflow JSON specification file",
-          "name": "spec",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "workflow:create",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "workflow",
-        "create.js"
-      ]
-    },
-    "workflow:publish": {
-      "aliases": [],
-      "args": {},
-      "description": "Publish a workflow version.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --version-id wfv-001 --start-activity act-001 --auth dev",
-          "description": "Publish a workflow version"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -v wfv-001 -s act-001 --json --auth dev",
-          "description": "Publish a workflow version and output as JSON"
-        }
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "auth": {
-          "char": "a",
-          "description": "Auth alias to use.",
-          "name": "auth",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cred-store": {
-          "description": "Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.",
-          "helpGroup": "GLOBAL",
-          "name": "cred-store",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deny-execute": {
-          "description": "Refuse background scripts, flow runs and ATF runs for this invocation.",
-          "helpGroup": "GLOBAL",
-          "name": "deny-execute",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "deny-write": {
-          "description": "Refuse any change to instance data for this invocation.",
-          "helpGroup": "GLOBAL",
-          "name": "deny-write",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "log-dir": {
-          "description": "Directory to write log files to. Implies --log-file.",
-          "helpGroup": "GLOBAL",
-          "name": "log-dir",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "log-file": {
-          "description": "Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to stderr only.",
-          "helpGroup": "GLOBAL",
-          "name": "log-file",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "log-level": {
-          "helpGroup": "GLOBAL",
-          "name": "log-level",
-          "summary": "Specify level for logging.",
-          "default": "info",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "debug",
-            "warn",
-            "error",
-            "info",
-            "trace"
-          ],
-          "type": "option"
-        },
-        "read-only": {
-          "description": "Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are unaffected.",
-          "helpGroup": "GLOBAL",
-          "name": "read-only",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "start-activity": {
-          "char": "s",
-          "description": "Sys ID of the start activity",
-          "name": "start-activity",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "version-id": {
-          "char": "v",
-          "description": "Sys ID of the workflow version to publish",
-          "name": "version-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "workflow:publish",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "workflow",
-        "publish.js"
+        "commands",
+        "update-set",
+        "move.js"
       ]
     },
-    "xml:export": {
+    "workflow:create": {
       "aliases": [],
       "args": {},
-      "description": "Export a single ServiceNow record as XML.\n\nDownloads the XML representation of a specific record from a ServiceNow table. Without --output, the XML is printed to stdout. With --output, the XML is written to the specified file path.\n\nFeatures:\n  • Export any record by table and sys_id\n  • Print XML to stdout for piping to other tools\n  • Save directly to a file with --output\n  • JSON output mode for CI/CD integration",
+      "description": "Create a complete workflow from a JSON specification file.",
       "examples": [
         {
-          "description": "Export a record to stdout",
-          "command": "<%= config.bin %> <%= command.id %> --table sys_script_include --sys-id abc123def456 --auth dev"
-        },
-        {
-          "description": "Export and save to a file",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --sys-id abc123 --output ./export.xml --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --spec ./workflow.json --auth dev",
+          "description": "Create a workflow from a JSON spec file"
         },
         {
-          "description": "Export as JSON metadata",
-          "command": "<%= config.bin %> <%= command.id %> --table sys_script --sys-id abc123 --json --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> -s ./workflow.json --json --auth dev",
+          "description": "Create a workflow and output result as JSON"
         }
       ],
       "flags": {
         "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
-          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -10260,37 +10431,19 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "table": {
-          "char": "t",
-          "description": "Table name of the record to export",
-          "name": "table",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sys-id": {
+        "spec": {
           "char": "s",
-          "description": "Sys ID of the record to export",
-          "name": "sys-id",
+          "description": "Path to workflow JSON specification file",
+          "name": "spec",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "output": {
-          "char": "o",
-          "description": "File path to write the exported XML to. If omitted, XML is printed to stdout.",
-          "name": "output",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "xml:export",
+      "id": "workflow:create",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -10300,30 +10453,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "xml",
-        "export.js"
+        "workflow",
+        "create.js"
       ]
     },
-    "xml:import": {
+    "workflow:publish": {
       "aliases": [],
       "args": {},
-      "description": "Import XML records into a ServiceNow instance.\n\nReads an XML file and imports its contents into the specified target table. The XML should be in ServiceNow unload format.\n\nFeatures:\n  • Import from local XML files\n  • Target a specific table\n  • JSON output mode for CI/CD integration",
+      "description": "Publish a workflow version.",
       "examples": [
         {
-          "description": "Import records from an XML file",
-          "command": "<%= config.bin %> <%= command.id %> --file ./export.xml --table sys_script_include --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --version-id wfv-001 --start-activity act-001 --auth dev",
+          "description": "Publish a workflow version"
         },
         {
-          "description": "Import with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.xml --table incident --json --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> -v wfv-001 -s act-001 --json --auth dev",
+          "description": "Publish a workflow version and output as JSON"
         }
       ],
       "flags": {
         "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
-          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -10401,19 +10553,19 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to the XML file to import",
-          "name": "file",
+        "start-activity": {
+          "char": "s",
+          "description": "Sys ID of the start activity",
+          "name": "start-activity",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "table": {
-          "char": "t",
-          "description": "Target table to import records into",
-          "name": "table",
+        "version-id": {
+          "char": "v",
+          "description": "Sys ID of the workflow version to publish",
+          "name": "version-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -10422,7 +10574,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "xml:import",
+      "id": "workflow:publish",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -10432,53 +10584,34 @@
       "relativePath": [
         "dist",
         "commands",
-        "xml",
-        "import.js"
+        "workflow",
+        "publish.js"
       ]
     },
-    "log": {
+    "xml:export": {
       "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": "Export a single ServiceNow record as XML.\n\nDownloads the XML representation of a specific record from a ServiceNow table. Without --output, the XML is printed to stdout. With --output, the XML is written to the specified file path.\n\nFeatures:\n  • Export any record by table and sys_id\n  • Print XML to stdout for piping to other tools\n  • Save directly to a file with --output\n  • JSON output mode for CI/CD integration",
       "examples": [
         {
-          "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": "Export a record to stdout",
+          "command": "<%= config.bin %> <%= command.id %> --table sys_script_include --sys-id abc123def456 --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": "Export and save to a file",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --sys-id abc123 --output ./export.xml --auth dev"
         },
         {
-          "description": "Tail logs without colored output",
-          "command": "<%= config.bin %> <%= command.id %> --no-color --auth dev-instance"
+          "description": "Export as JSON metadata",
+          "command": "<%= config.bin %> <%= command.id %> --table sys_script --sys-id abc123 --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -10556,45 +10689,37 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "output": {
-          "char": "o",
-          "description": "Output file path to save logs. Creates parent directories if needed.",
-          "name": "output",
-          "required": false,
+        "table": {
+          "char": "t",
+          "description": "Table name of the record to export",
+          "name": "table",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "interval": {
-          "char": "i",
-          "description": "Polling interval in milliseconds",
-          "name": "interval",
-          "required": false,
-          "default": 1000,
+        "sys-id": {
+          "char": "s",
+          "description": "Sys ID of the record to export",
+          "name": "sys-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-color": {
-          "description": "Disable colored output",
-          "name": "no-color",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "filter": {
-          "char": "f",
-          "description": "Filter logs by field and value. Syntax: field OPERATOR value. Operators: CONTAINS, CONTAINS_CI (case-insensitive), EQUALS, EQUALS_CI, STARTS_WITH, STARTS_WITH_CI, ENDS_WITH, ENDS_WITH_CI, REGEX, NOT_CONTAINS, NOT_EQUALS. Field defaults to \"message\" if omitted. Multiple filters are combined with AND logic.",
-          "name": "filter",
+        "output": {
+          "char": "o",
+          "description": "File path to write the exported XML to. If omitted, XML is printed to stdout.",
+          "name": "output",
           "required": false,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "log",
+      "id": "xml:export",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -10604,30 +10729,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "log",
-        "index.js"
+        "xml",
+        "export.js"
       ]
     },
-    "health:check": {
+    "xml:import": {
       "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": "Import XML records into a ServiceNow instance.\n\nReads an XML file and imports its contents into the specified target table. The XML should be in ServiceNow unload format.\n\nFeatures:\n  • Import from local XML files\n  • Target a specific table\n  • JSON output mode for CI/CD integration",
       "examples": [
         {
-          "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": "Import records from an XML file",
+          "command": "<%= config.bin %> <%= command.id %> --file ./export.xml --table sys_script_include --auth dev"
         },
         {
-          "description": "Health check as JSON",
-          "command": "<%= config.bin %> <%= command.id %> --json --auth dev"
+          "description": "Import with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> --file ./records.xml --table incident --json --auth dev"
         }
       ],
       "flags": {
@@ -10713,46 +10830,20 @@
           "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"
+        "file": {
+          "char": "f",
+          "description": "Path to the XML file to import",
+          "name": "file",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "stuck-job-threshold": {
-          "description": "Minutes threshold for a job to be considered stuck",
-          "name": "stuck-job-threshold",
-          "required": false,
-          "default": 30,
+        "table": {
+          "char": "t",
+          "description": "Target table to import records into",
+          "name": "table",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -10760,7 +10851,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "health:check",
+      "id": "xml:import",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -10770,10 +10861,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "health",
-        "check.js"
+        "xml",
+        "import.js"
       ]
     }
   },
-  "version": "5.6.0"
+  "version": "5.7.0"
 }