@sonisoft/now-sdk-ext-cli 2.1.0 → 2.3.0

package/oclif.manifest.json

@@ -1678,6 +1678,123 @@
         "update.js"
       ]
     },
+    "exec": {
+      "aliases": [],
+      "args": {
+        "scope": {
+          "description": "Scope to execute script in. Use \"global\" for global scope.",
+          "name": "scope",
+          "required": true
+        },
+        "file": {
+          "description": "File to execute in scripts background. If omitted, starts REPL mode.",
+          "name": "file",
+          "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",
+      "examples": [
+        {
+          "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": {
+          "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"
+        },
+        "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": {},
@@ -1877,6 +1994,196 @@
         "cancel.js"
       ]
     },
+    "flow:copy": {
+      "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",
+      "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": "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": {
+        "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"
+        },
+        "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"
+        },
+        "name": {
+          "char": "n",
+          "description": "Display name for the new copied flow",
+          "name": "name",
+          "required": true,
+          "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:copy",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "copy.js"
+      ]
+    },
+    "flow:details": {
+      "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",
+      "examples": [
+        {
+          "description": "Get execution details after testing a flow",
+          "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --auth dev"
+        },
+        {
+          "description": "Get details with explicit scope",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --scope x_myapp --auth dev"
+        },
+        {
+          "description": "Get details with JSON output for scripting",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
+        }
+      ],
+      "flags": {
+        "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"
+        },
+        "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"
+        },
+        "scope": {
+          "description": "Scope sys_id for the ProcessFlow API transaction scope parameter",
+          "name": "scope",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "include-definition": {
+          "char": "d",
+          "description": "Include the full flow definition snapshot in the response",
+          "name": "include-definition",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:details",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "details.js"
+      ]
+    },
     "flow:error": {
       "aliases": [],
       "args": {},
@@ -1955,6 +2262,108 @@
         "error.js"
       ]
     },
+    "flow:logs": {
+      "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.",
+      "examples": [
+        {
+          "description": "Get flow execution logs",
+          "command": "<%= config.bin %> <%= command.id %> --context-id d4e5f6789012345678abcdef01234567 --auth dev"
+        },
+        {
+          "description": "Get latest 10 log entries in reverse order",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --limit 10 --order desc --auth dev"
+        },
+        {
+          "description": "Get logs with JSON output for scripting",
+          "command": "<%= config.bin %> <%= command.id %> -c d4e5f6789012345678abcdef01234567 --json --auth dev"
+        }
+      ],
+      "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"
+        },
+        "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"
+        },
+        "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",
+          "required": false,
+          "default": "asc",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "asc",
+            "desc"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "flow:logs",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "flow",
+        "logs.js"
+      ]
+    },
     "flow:message": {
       "aliases": [],
       "args": {},
@@ -2545,123 +2954,6 @@
         "test.js"
       ]
     },
-    "exec": {
-      "aliases": [],
-      "args": {
-        "scope": {
-          "description": "Scope to execute script in. Use \"global\" for global scope.",
-          "name": "scope",
-          "required": true
-        },
-        "file": {
-          "description": "File to execute in scripts background. If omitted, starts REPL mode.",
-          "name": "file",
-          "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",
-      "examples": [
-        {
-          "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": {
-          "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"
-        },
-        "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"
-      ]
-    },
     "health:check": {
       "aliases": [],
       "args": {},
@@ -6126,5 +6418,5 @@
       ]
     }
   },
-  "version": "2.1.0"
+  "version": "2.3.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sonisoft/now-sdk-ext-cli",
   "description": "A CLI extending the functionality of the ServiceNow SDK.",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "author": "Chris Nanda",
   "bin": {
     "nex": "./bin/run.js"
@@ -17,7 +17,7 @@
     "@servicenow/sdk-cli": "4.3.0",
     "@servicenow/sdk-cli-core": "3.0.3",
     "@servicenow/sdk-core": "4.3.0",
-    "@sonisoft/now-sdk-ext-core": "^3.6.0",
+    "@sonisoft/now-sdk-ext-core": "^3.8.0",
     "@ts-morph/common": "^0.24.0",
     "chalk": "^4.1.2",
     "cometd": "^8.0.4",