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

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,155 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "dependency-depth": {
-          "description": "Expand one dependency level; requires --details dependencies",
-          "name": "dependency-depth",
-          "default": 0,
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file with create operations",
+          "name": "file",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "details": {
-          "description": "Include selected detail now; repeat for multiple kinds",
-          "name": "details",
+        "transaction": {
+          "description": "Stop on first error (transactional)",
+          "name": "transaction",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "batch:create",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "batch",
+        "create.js"
+      ]
+    },
+    "batch:update": {
+      "aliases": [],
+      "args": {},
+      "description": "Batch update records on a ServiceNow instance from a JSON file.",
+      "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"
+        }
+      ],
+      "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": true,
-          "options": [
-            "scripts",
-            "definitions",
-            "dependencies"
-          ],
+          "multiple": false,
           "type": "option"
         },
-        "max-bytes": {
-          "description": "Maximum JSON response bytes; omissions include retrieval references",
-          "name": "max-bytes",
-          "default": 65536,
+        "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"
         },
-        "scope": {
-          "description": "Transaction scope for flow definition reads",
-          "name": "scope",
+        "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"
         },
-        "reference": {
-          "description": "kind:source_table:sys_id; repeat for a batch",
-          "name": "reference",
+        "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"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file with update operations",
+          "name": "file",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "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": "behavior:details",
+      "id": "batch:update",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2272,17 +2473,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "behavior",
-        "details.js"
+        "batch",
+        "update.js"
       ]
     },
-    "behavior": {
+    "behavior:details": {
       "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": "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": [
-        "<%= config.bin %> <%= command.id %> --table incident --auth dev --json",
-        "<%= config.bin %> <%= command.id %> --table change_request --category business_rules --details scripts --auth dev --json"
+        "<%= config.bin %> <%= command.id %> --reference business_rules:sys_script:0123456789abcdef0123456789abcdef --details scripts --auth dev --json"
       ],
       "flags": {
         "json": {
@@ -2400,77 +2600,18 @@
           "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",
+        "reference": {
+          "description": "kind:source_table:sys_id; repeat for a batch",
+          "name": "reference",
           "required": true,
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "behavior",
+      "id": "behavior:details",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -2481,27 +2622,20 @@
         "dist",
         "commands",
         "behavior",
-        "index.js"
+        "details.js"
       ]
     },
-    "batch:create": {
+    "behavior": {
       "aliases": [],
       "args": {},
-      "description": "Batch create 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 ./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 %> --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"
@@ -2580,155 +2714,112 @@
           "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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "batch:create",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "batch",
-        "create.js"
-      ]
-    },
-    "batch:update": {
-      "aliases": [],
-      "args": {},
-      "description": "Batch update records on a ServiceNow instance from a JSON file.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --auth dev",
-          "description": "Update records from a JSON file"
+        "details": {
+          "description": "Include selected detail now; repeat for multiple kinds",
+          "name": "details",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "scripts",
+            "definitions",
+            "dependencies"
+          ],
+          "type": "option"
         },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --stop-on-error --auth dev",
-          "description": "Update records and stop on first error"
-        }
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
+        "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"
         },
-        "auth": {
-          "char": "a",
-          "description": "Auth alias to use.",
-          "name": "auth",
-          "required": false,
+        "cursor": {
+          "description": "Continuation token; requires exactly one --category and the same filters",
+          "name": "cursor",
           "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,
+        "include-inactive": {
+          "description": "Include inactive/published and draft candidates when discoverable",
+          "name": "include-inactive",
           "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,
+        "include-inherited": {
+          "description": "Include applicable ancestor behavior",
+          "name": "include-inherited",
+          "allowNo": true,
           "type": "boolean"
         },
-        "log-dir": {
-          "description": "Directory to write log files to. Implies --log-file.",
-          "helpGroup": "GLOBAL",
-          "name": "log-dir",
-          "required": false,
+        "limit": {
+          "description": "Maximum items per category",
+          "name": "limit",
+          "default": 50,
           "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",
+        "name": {
+          "description": "Metadata name contains this text",
+          "name": "name",
           "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"
+        "sys-id": {
+          "description": "Metadata source sys_id to include; repeat for multiple records",
+          "name": "sys-id",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file with update operations",
-          "name": "file",
+        "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": {
@@ -3069,7 +3160,7 @@
       "aliases": [],
       "args": {
         "scope": {
-          "description": "Scope to execute script in. Use \"global\" for global scope.",
+          "description": "Scope to execute script in: \"global\", the scope of an application developed on the instance (sys_app), or a scope sys_id. Installed store apps cannot be used.",
           "name": "scope",
           "required": true
         },
@@ -3079,7 +3170,7 @@
           "required": false
         }
       },
-      "description": "Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.\n\nThis command allows you to run JavaScript either from files or interactively via REPL mode. It mimics the functionality of the Scripts - Background interface in ServiceNow, providing a way to execute scripts programmatically without manual interaction. The output is returned in real-time and can be piped to other commands or saved to files.\n\nModes:\n  • File Mode: Provide a file path to execute scripts from a file\n  • REPL Mode: Omit the file path to start an interactive session\n\nFeatures:\n  • Execute local JavaScript files remotely\n  • Interactive REPL for ad-hoc script execution\n  • Script parameterization with {placeholder} replacement\n  • Multi-line script support in REPL\n  • Scope-aware execution (global or custom scope)\n  • Real-time console output capture\n  • Pipe-able output for command chaining\n  • Debug logging support\n  • Useful for data migration, testing, and administrative tasks\n\nScript Parameterization:\n  Use {paramName} placeholders in your script files, then provide values via --params:\n  • Supports any JSON-serializable values (strings, numbers, booleans)\n  • Multiple parameters supported\n  • All occurrences of each placeholder are replaced\n  • Example: {token}, {username}, {environment}\n\nREPL Controls:\n  • Press Enter to add a new line\n  • Type .exec or press Ctrl+D to execute the script\n  • Type .clear to clear the current input\n  • Type .exit or press Ctrl+C twice to exit REPL\n\n⚠️  IMPORTANT SECURITY WARNING:\nThis command executes scripts with the same permissions and risks as using Scripts - Background directly\nin ServiceNow. Always:\n  • Review scripts before execution\n  • Test in non-production environments first\n  • Use appropriate scoping to limit access\n  • Be aware of data modification risks\n  • Follow your organization's security policies\n  • Never execute untrusted scripts\n\nScript Capabilities:\n  Scripts run with full GlideSystem API access and can:\n  • Query and modify database records\n  • Create, update, and delete data\n  • Execute business rules and workflows\n  • Access all APIs available in Scripts - Background\n  • Use gs, GlideRecord, GlideAggregate, and other server-side APIs",
+      "description": "Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.\n\nThis command allows you to run JavaScript either from files or interactively via REPL mode. It mimics the functionality of the Scripts - Background interface in ServiceNow, providing a way to execute scripts programmatically without manual interaction. The output is returned in real-time and can be piped to other commands or saved to files.\n\nModes:\n  • File Mode: Provide a file path to execute scripts from a file\n  • REPL Mode: Omit the file path to start an interactive session\n\nFeatures:\n  • Execute local JavaScript files remotely\n  • Interactive REPL for ad-hoc script execution\n  • Script parameterization with {placeholder} replacement\n  • Multi-line script support in REPL\n  • Scope-aware execution (global or custom scope)\n  • Real-time console output capture\n  • Pipe-able output for command chaining\n  • Debug logging support\n  • Useful for data migration, testing, and administrative tasks\n\nScript Parameterization:\n  Use {paramName} placeholders in your script files, then provide values via --params:\n  • Supports any JSON-serializable values (strings, numbers, booleans)\n  • Multiple parameters supported\n  • All occurrences of each placeholder are replaced\n  • Example: {token}, {username}, {environment}\n\nScopes:\n  Scripts - Background runs in \"global\" or in an application developed on the instance (sys_app).\n  Installed store/repository apps (sys_store_app) cannot be used: run in global and call their\n  APIs fully qualified (e.g. sn_app.Util). An unusable scope fails before the script is sent.\n\nREPL Controls:\n  • Press Enter to add a new line\n  • Type .exec or press Ctrl+D to execute the script\n  • Type .clear to clear the current input\n  • Type .exit or press Ctrl+C twice to exit REPL\n\n⚠️  IMPORTANT SECURITY WARNING:\nThis command executes scripts with the same permissions and risks as using Scripts - Background directly\nin ServiceNow. Always:\n  • Review scripts before execution\n  • Test in non-production environments first\n  • Use appropriate scoping to limit access\n  • Be aware of data modification risks\n  • Follow your organization's security policies\n  • Never execute untrusted scripts\n\nScript Capabilities:\n  Scripts run with full GlideSystem API access and can:\n  • Query and modify database records\n  • Create, update, and delete data\n  • Execute business rules and workflows\n  • Access all APIs available in Scripts - Background\n  • Use gs, GlideRecord, GlideAggregate, and other server-side APIs",
       "examples": [
         {
           "description": "Start REPL in global scope",
@@ -4991,24 +5082,194 @@
       "description": "Test a Flow Designer flow without requiring it to be published.\n\nInvokes the same API as the \"Test\" button in Flow Designer, running the flow in its current saved (draft) state. Unlike `flow run` which requires a published flow and uses sn_fd.FlowAPI, `flow test` works on unpublished drafts via the ProcessFlow REST API.\n\nFeatures:\n  • Test flows by sys_id or scoped name\n  • Pass trigger output values as JSON via --output-map\n  • Auto-resolves scope from flow definition if not provided\n  • Synchronous or asynchronous execution",
       "examples": [
         {
-          "description": "Test a flow by sys_id",
-          "command": "<%= config.bin %> <%= command.id %> --flow-id 887dda5583237210fdb8f7b6feaad32c --output-map '{\"current\":\"0ecd7552db252200a6a2b31be0b8f5e6\",\"table_name\":\"change_request\"}' --auth dev"
+          "description": "Test a flow by sys_id",
+          "command": "<%= config.bin %> <%= command.id %> --flow-id 887dda5583237210fdb8f7b6feaad32c --output-map '{\"current\":\"0ecd7552db252200a6a2b31be0b8f5e6\",\"table_name\":\"change_request\"}' --auth dev"
+        },
+        {
+          "description": "Test a flow by scoped name with explicit scope",
+          "command": "<%= config.bin %> <%= command.id %> -f x_myapp.my_flow -o '{\"current\":\"abc123\",\"table_name\":\"incident\"}' --scope x_myapp --auth dev"
+        },
+        {
+          "description": "Test with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> -f 887dda5583237210fdb8f7b6feaad32c -o '{\"current\":\"abc123\"}' --json --auth dev"
+        }
+      ],
+      "flags": {
+        "json": {
+          "char": "j",
+          "description": "Output results as JSON",
+          "name": "json",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth": {
+          "char": "a",
+          "description": "Auth alias to use.",
+          "name": "auth",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cred-store": {
+          "description": "Read credentials from @sonisoft/sn-credstore instead of the OS keyring. Use this in headless sessions (SSH, systemd, CI, agents) where the keyring cannot be unlocked.",
+          "helpGroup": "GLOBAL",
+          "name": "cred-store",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deny-execute": {
+          "description": "Refuse background scripts, flow runs and ATF runs for this invocation.",
+          "helpGroup": "GLOBAL",
+          "name": "deny-execute",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "deny-write": {
+          "description": "Refuse any change to instance data for this invocation.",
+          "helpGroup": "GLOBAL",
+          "name": "deny-write",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-dir": {
+          "description": "Directory to write log files to. Implies --log-file.",
+          "helpGroup": "GLOBAL",
+          "name": "log-dir",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "log-file": {
+          "description": "Write logs to a file. Defaults to $XDG_STATE_HOME/now-sdk-ext/logs (~/.local/state/now-sdk-ext/logs). Off by default; without this, nex logs warnings and errors to stderr only.",
+          "helpGroup": "GLOBAL",
+          "name": "log-file",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-level": {
+          "helpGroup": "GLOBAL",
+          "name": "log-level",
+          "summary": "Specify level for logging.",
+          "default": "info",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "debug",
+            "warn",
+            "error",
+            "info",
+            "trace"
+          ],
+          "type": "option"
+        },
+        "read-only": {
+          "description": "Refuse every change to the instance — equivalent to --deny-write --deny-execute. Reads are unaffected.",
+          "helpGroup": "GLOBAL",
+          "name": "read-only",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flow-id": {
+          "char": "f",
+          "description": "Flow sys_id or scoped name (e.g. x_myapp.my_flow)",
+          "name": "flow-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-map": {
+          "char": "o",
+          "description": "JSON mapping of trigger output variable names to test values (e.g. '{\"current\":\"<sys_id>\",\"table_name\":\"change_request\"}')",
+          "name": "output-map",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Scope sys_id for transaction scope (auto-resolved from flow definition if omitted)",
+          "name": "scope",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "synchronous": {
+          "description": "Run test synchronously (default: true)",
+          "name": "synchronous",
+          "required": false,
+          "allowNo": true,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:test",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "test.js"
+      ]
+    },
+    "log": {
+      "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",
+      "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": "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 with custom polling interval (500ms for faster updates)",
+          "command": "<%= config.bin %> <%= command.id %> --interval 500 --auth dev-instance"
         },
         {
-          "description": "Test with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> -f 887dda5583237210fdb8f7b6feaad32c -o '{\"current\":\"abc123\"}' --json --auth dev"
+          "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 +5347,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 +5395,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "flow",
-        "test.js"
+        "log",
+        "index.js"
       ]
     },
     "policy:status": {
@@ -10436,178 +10699,6 @@
         "import.js"
       ]
     },
-    "log": {
-      "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",
-      "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": "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": {
-          "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"
-        },
-        "output": {
-          "char": "o",
-          "description": "Output file path to save logs. Creates parent directories if needed.",
-          "name": "output",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "interval": {
-          "char": "i",
-          "description": "Polling interval in milliseconds",
-          "name": "interval",
-          "required": false,
-          "default": 1000,
-          "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",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "log",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "log",
-        "index.js"
-      ]
-    },
     "health:check": {
       "aliases": [],
       "args": {},
@@ -10775,5 +10866,5 @@
       ]
     }
   },
-  "version": "5.6.0"
+  "version": "5.7.1"
 }