@sonisoft/now-sdk-ext-cli 1.1.0-alpha.2 → 2.0.0-alpha.0

package/oclif.manifest.json

@@ -3,9 +3,20 @@
     "app": {
       "aliases": [],
       "args": {},
-      "description": "",
+      "description": "Manage ServiceNow applications: uninstall applications from your instance.\n\nThis command provides programmatic control over ServiceNow applications, allowing you to uninstall applications remotely. This is useful for automated environment cleanup, testing workflows, and application lifecycle management.\n\nFeatures:\n  • Uninstall applications by sys_id and scope\n  • Automated application removal in CI/CD pipelines\n  • Proper cleanup and rollback handling\n  • Detailed logging and error reporting\n\nRequirements:\n  • User must have admin role\n  • Application must be in a removable state\n  • Both application sys_id and scope are required",
       "examples": [
-        "<%= config.bin %> <%= command.id %> exec global test.js --auth sn_alias\ntest\n"
+        {
+          "description": "Uninstall an application by sys_id and scope",
+          "command": "<%= config.bin %> <%= command.id %> --uninstall --applicationId a1b2c3d4e5f6 --scope x_my_custom_app --auth dev-instance"
+        },
+        {
+          "description": "Uninstall with enhanced debug logging",
+          "command": "<%= config.bin %> <%= command.id %> -u -i a1b2c3d4e5f6 -s x_my_custom_app --auth dev-instance --log-level debug"
+        },
+        {
+          "description": "Uninstall using short flags",
+          "command": "<%= config.bin %> <%= command.id %> -u -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance"
+        }
       ],
       "flags": {
         "json": {
@@ -86,9 +97,20 @@
     "app:install": {
       "aliases": [],
       "args": {},
-      "description": "Install or Upgrade application(s) from batch definition file",
+      "description": "Install or upgrade multiple ServiceNow applications from a batch definition file.\n\nThis command enables automated installation and upgrade of multiple applications using a JSON definition file. Perfect for setting up new environments, deploying application bundles, or managing application dependencies. The batch file can specify multiple applications with their versions, scopes, and installation options.\n\nFeatures:\n  • Install multiple applications in a single operation\n  • Upgrade existing applications to new versions\n  • Control demo data loading per application\n  • Detailed installation progress and results\n  • Automatic dependency resolution\n  • Rollback support on failures\n\nBatch Definition Format:\n  The JSON file should contain an \"applications\" array with objects defining:\n  • name: Application name\n  • scope: Application scope (e.g., x_my_app)\n  • version: Target version number\n  • load_demo_data: Whether to load demo data (optional)\n  • notes: Installation notes (optional)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> exec global test.js --auth sn_alias\ntest\n"
+        {
+          "command": "<%= config.bin %> <%= command.id %> --batch --definitionPath ./apps-to-install.json --auth dev-instance",
+          "description": "Install applications from a batch definition file"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -b -d ./batch-apps.json -a dev-instance",
+          "description": "Install with short flags"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -b -d ./apps.json -a dev-instance --log-level debug",
+          "description": "Install with debug logging to troubleshoot issues"
+        }
       ],
       "flags": {
         "json": {
@@ -125,7 +147,7 @@
         },
         "batch": {
           "char": "b",
-          "description": "Install from batch definition file",
+          "description": "Enable batch installation mode from definition file",
           "name": "batch",
           "required": false,
           "allowNo": false,
@@ -133,7 +155,7 @@
         },
         "definitionPath": {
           "char": "d",
-          "description": "Batch definition file",
+          "description": "Path to JSON batch definition file containing applications to install",
           "name": "definitionPath",
           "required": false,
           "hasDynamicHelp": false,
@@ -157,23 +179,547 @@
         "install.js"
       ]
     },
+    "app:repo-install": {
+      "aliases": [],
+      "args": {},
+      "description": "Install an application from your ServiceNow company repository.\n\nThis command installs an application from your company's internal application repository. You can specify the application by its scope name, and optionally specify a particular version. The command will automatically look up the application details and initiate the installation.\n\nFeatures:\n  • Install applications by scope name\n  • Automatic lookup of application sys_id\n  • Optional version specification (defaults to latest)\n  • Wait for installation completion with progress monitoring\n  • No-wait mode for background installations\n  • Configurable polling intervals and timeouts\n  • Detailed installation status and error reporting\n\nInstallation Process:\n  1. Looks up the application in the company repository by scope\n  2. Verifies the application is available and installable\n  3. Initiates the installation via CI/CD API\n  4. Monitors progress until completion (unless --no-wait specified)\n  5. Reports final status and any errors\n\nRequirements:\n  • User must have sn_cicd.sys_ci_automation role\n  • Application must exist in company repository\n  • Application must not be already installed (or use upgrade)",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --scope x_my_custom_app --auth dev-instance",
+          "description": "Install application by scope (latest version)"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --scope x_my_app --version 2.1.0 --auth dev-instance",
+          "description": "Install specific version of an application"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --scope x_my_app --no-wait --auth dev-instance",
+          "description": "Install without waiting for completion"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -s x_my_app -a dev-instance --timeout 3600000",
+          "description": "Install with custom timeout (1 hour)"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -s x_my_app -a dev-instance --log-level debug",
+          "description": "Install with debug logging"
+        }
+      ],
+      "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"
+        },
+        "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"
+        },
+        "no-wait": {
+          "char": "w",
+          "description": "Do not wait for installation to complete",
+          "name": "no-wait",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "poll-interval": {
+          "description": "Polling interval in milliseconds (default: 5000)",
+          "name": "poll-interval",
+          "required": false,
+          "default": 5000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "char": "s",
+          "description": "Application scope (e.g., x_my_custom_app)",
+          "name": "scope",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "timeout": {
+          "char": "t",
+          "description": "Installation timeout in milliseconds (default: 1800000 = 30 min)",
+          "name": "timeout",
+          "required": false,
+          "default": 1800000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "char": "v",
+          "description": "Specific version to install (defaults to latest)",
+          "name": "version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:repo-install",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "repo-install.js"
+      ]
+    },
+    "app:repo-list": {
+      "aliases": [],
+      "args": {},
+      "description": "List applications available in your ServiceNow company repository.\n\nThis command retrieves and displays all applications that are available in your company's internal application repository. These are applications that have been published internally and are available for installation across your ServiceNow instances.\n\nFeatures:\n  • List all available company repository applications\n  • Filter to show only installed applications\n  • Filter to show only installable (not yet installed) applications\n  • View application details including versions and dependencies\n  • JSON output support for automation and scripting\n  • Vendor-based filtering\n\nUse Cases:\n  • Discover available applications for installation\n  • Audit installed company applications\n  • Find applications that can be upgraded\n  • Integration with CI/CD pipelines\n  • Automated environment setup and configuration",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --auth dev-instance",
+          "description": "List all company repository applications"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --installed --auth dev-instance",
+          "description": "List only installed applications"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --installable --auth dev-instance",
+          "description": "List only installable (not installed) applications"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --json --auth dev-instance",
+          "description": "Get JSON output for scripting"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -a dev-instance",
+          "description": "List with short flags"
+        }
+      ],
+      "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"
+        },
+        "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"
+        },
+        "installable": {
+          "char": "n",
+          "description": "Show only applications that can be installed (not yet installed)",
+          "name": "installable",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "installed": {
+          "char": "i",
+          "description": "Show only installed applications",
+          "name": "installed",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:repo-list",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "repo-list.js"
+      ]
+    },
+    "app:uninstall": {
+      "aliases": [],
+      "args": {},
+      "description": "Uninstall a ServiceNow application from your instance.\n\nThis command provides programmatic control over ServiceNow application removal, allowing you to uninstall applications remotely. This is useful for automated environment cleanup, testing workflows, and application lifecycle management.\n\nFeatures:\n  • Uninstall applications by sys_id and scope\n  • Automated application removal in CI/CD pipelines\n  • Proper cleanup and rollback handling\n  • Detailed logging and error reporting\n\nRequirements:\n  • User must have admin role\n  • Application must be in a removable state\n  • Both application sys_id and scope are required",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --applicationId a1b2c3d4e5f6 --scope x_my_custom_app --auth dev-instance",
+          "description": "Uninstall an application by sys_id and scope"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -i a1b2c3d4e5f6 -s x_my_custom_app --auth dev-instance --log-level debug",
+          "description": "Uninstall with enhanced debug logging"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -i a1b2c3d4e5f6 -s x_my_custom_app -a dev-instance",
+          "description": "Uninstall using short flags"
+        }
+      ],
+      "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"
+        },
+        "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"
+        },
+        "applicationId": {
+          "char": "i",
+          "description": "Application sys_id",
+          "name": "applicationId",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "char": "s",
+          "description": "Scope of application",
+          "name": "scope",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:uninstall",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "uninstall.js"
+      ]
+    },
+    "atf": {
+      "aliases": [],
+      "args": {},
+      "description": "Execute ATF (Automated Test Framework) tests or test suites on a ServiceNow instance.\n\nThis command allows you to run automated tests and test suites remotely, making it perfect for CI/CD pipelines and automated testing workflows. You can execute individual tests, entire test suites, and configure execution parameters such as browser type, OS, and performance mode.\n\nFeatures:\n  • Execute individual tests or complete test suites\n  • Real-time progress monitoring\n  • JSON output for CI/CD integration\n  • Detailed test results and summaries\n  • Browser and environment configuration\n  • Performance testing mode support",
+      "examples": [
+        {
+          "description": "Execute a single ATF test by sys_id",
+          "command": "<%= config.bin %> <%= command.id %> --test-id f717a8c783103210621e78c6feaad396 --auth dev-instance"
+        },
+        {
+          "description": "Execute a test suite by sys_id and wait for completion",
+          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --auth dev-instance --wait"
+        },
+        {
+          "description": "Execute a test suite by name",
+          "command": "<%= config.bin %> <%= command.id %> --suite-name \"Smoke Tests\" --auth dev-instance"
+        },
+        {
+          "description": "Execute with specific browser configuration",
+          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --browser chrome --auth dev-instance"
+        },
+        {
+          "description": "Execute as performance test with JSON output for CI/CD",
+          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --performance --json --auth dev-instance"
+        },
+        {
+          "description": "Execute with custom poll interval (10 seconds)",
+          "command": "<%= config.bin %> <%= command.id %> --suite-id e077e00b83103210621e78c6feaad383 --poll-interval 10000 --auth dev-instance"
+        }
+      ],
+      "flags": {
+        "json": {
+          "char": "j",
+          "description": "Output results as JSON",
+          "name": "json",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auth": {
+          "char": "a",
+          "description": "Auth alias to use.",
+          "name": "auth",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "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"
+        },
+        "test-id": {
+          "char": "t",
+          "description": "Test sys_id to execute",
+          "exclusive": [
+            "suite-id",
+            "suite-name"
+          ],
+          "name": "test-id",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "suite-id": {
+          "char": "s",
+          "description": "Test Suite sys_id to execute",
+          "exclusive": [
+            "test-id",
+            "suite-name"
+          ],
+          "name": "suite-id",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "suite-name": {
+          "char": "n",
+          "description": "Test Suite name to execute",
+          "exclusive": [
+            "test-id",
+            "suite-id"
+          ],
+          "name": "suite-name",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "char": "w",
+          "description": "Wait for test suite execution to complete and return results",
+          "name": "wait",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "poll-interval": {
+          "char": "p",
+          "description": "Polling interval in milliseconds when waiting for completion",
+          "name": "poll-interval",
+          "required": false,
+          "default": 5000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "browser": {
+          "char": "b",
+          "description": "Browser name for test execution (e.g., chrome, firefox)",
+          "name": "browser",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "browser-version": {
+          "description": "Browser version for test execution",
+          "name": "browser-version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "os-name": {
+          "description": "Operating system name for test execution",
+          "name": "os-name",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "os-version": {
+          "description": "Operating system version for test execution",
+          "name": "os-version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "performance": {
+          "description": "Run as performance test",
+          "name": "performance",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cloud": {
+          "description": "Run in cloud",
+          "name": "cloud",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "atf",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "atf",
+        "index.js"
+      ]
+    },
     "exec": {
       "aliases": [],
       "args": {
         "scope": {
-          "description": "Scope to execute file in.",
+          "description": "Scope to execute script in. Use \"global\" for global scope.",
           "name": "scope",
           "required": true
         },
         "file": {
-          "description": "File to execute in scripts background.",
+          "description": "File to execute in scripts background. If omitted, starts REPL mode.",
           "name": "file",
-          "required": true
+          "required": false
         }
       },
-      "description": "Execute a local javascript file on a ServiceNow instance using Scripts - Background remotely. Returns the output/raw console output that Scripts - Background outputs to the browser in order to support the execution and result being piped to another command.",
+      "description": "Execute JavaScript on a ServiceNow instance remotely using Scripts - Background.\n\nThis command allows you to run JavaScript either from files or interactively via REPL mode. It mimics the functionality of the Scripts - Background interface in ServiceNow, providing a way to execute scripts programmatically without manual interaction. The output is returned in real-time and can be piped to other commands or saved to files.\n\nModes:\n  • File Mode: Provide a file path to execute scripts from a file\n  • REPL Mode: Omit the file path to start an interactive session\n\nFeatures:\n  • Execute local JavaScript files remotely\n  • Interactive REPL for ad-hoc script execution\n  • Script parameterization with {placeholder} replacement\n  • Multi-line script support in REPL\n  • Scope-aware execution (global or custom scope)\n  • Real-time console output capture\n  • Pipe-able output for command chaining\n  • Debug logging support\n  • Useful for data migration, testing, and administrative tasks\n\nScript Parameterization:\n  Use {paramName} placeholders in your script files, then provide values via --params:\n  • Supports any JSON-serializable values (strings, numbers, booleans)\n  • Multiple parameters supported\n  • All occurrences of each placeholder are replaced\n  • Example: {token}, {username}, {environment}\n\nREPL Controls:\n  • Press Enter to add a new line\n  • Type .exec or press Ctrl+D to execute the script\n  • Type .clear to clear the current input\n  • Type .exit or press Ctrl+C twice to exit REPL\n\n⚠️  IMPORTANT SECURITY WARNING:\nThis command executes scripts with the same permissions and risks as using Scripts - Background directly\nin ServiceNow. Always:\n  • Review scripts before execution\n  • Test in non-production environments first\n  • Use appropriate scoping to limit access\n  • Be aware of data modification risks\n  • Follow your organization's security policies\n  • Never execute untrusted scripts\n\nScript Capabilities:\n  Scripts run with full GlideSystem API access and can:\n  • Query and modify database records\n  • Create, update, and delete data\n  • Execute business rules and workflows\n  • Access all APIs available in Scripts - Background\n  • Use gs, GlideRecord, GlideAggregate, and other server-side APIs",
       "examples": [
-        "<%= config.bin %> <%= command.id %> exec global test.js --auth sn_alias\ntest\n"
+        {
+          "description": "Start REPL in global scope",
+          "command": "<%= config.bin %> <%= command.id %> global --auth dev-instance"
+        },
+        {
+          "description": "Start REPL in custom application scope",
+          "command": "<%= config.bin %> <%= command.id %> x_my_custom_app --auth dev-instance"
+        },
+        {
+          "description": "Execute a script file in global scope",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/cleanup.js --auth dev-instance"
+        },
+        {
+          "description": "Execute a script file in a custom application scope",
+          "command": "<%= config.bin %> <%= command.id %> x_my_custom_app ./scripts/app-config.js --auth dev-instance"
+        },
+        {
+          "description": "Execute a parameterized script with single parameter",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/query-user.js --auth dev-instance --params '{\"username\":\"admin\"}'"
+        },
+        {
+          "description": "Execute a parameterized script with multiple parameters",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/update-record.js --auth dev-instance --params '{\"table\":\"incident\",\"field\":\"priority\",\"value\":\"1\"}'"
+        },
+        {
+          "description": "Execute and save output to a file",
+          "command": "<%= config.bin %> <%= command.id %> global ./scripts/report.js --auth dev-instance > report.txt"
+        },
+        {
+          "description": "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": {
@@ -207,6 +753,15 @@
             "trace"
           ],
           "type": "option"
+        },
+        "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,
@@ -217,6 +772,7 @@
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
+      "autocomplete": {},
       "isESM": true,
       "relativePath": [
         "dist",
@@ -224,7 +780,130 @@
         "exec",
         "index.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_taniu_tan_core\" --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"
+        },
+        "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"
+        },
+        "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"
+      ]
     }
   },
-  "version": "1.1.0-alpha.2"
+  "version": "2.0.0-alpha.0"
 }