@sonisoft/now-sdk-ext-cli 5.0.0 → 5.1.0

package/oclif.manifest.json

@@ -44,6 +44,23 @@
           "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",
@@ -139,6 +156,23 @@
           "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",
@@ -299,6 +333,23 @@
           "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",
@@ -433,6 +484,23 @@
           "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",
@@ -535,6 +603,23 @@
           "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",
@@ -636,6 +721,23 @@
           "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",
@@ -766,6 +868,23 @@
           "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",
@@ -858,6 +977,23 @@
           "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",
@@ -965,6 +1101,23 @@
           "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",
@@ -1141,6 +1294,23 @@
           "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",
@@ -1222,6 +1392,23 @@
           "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",
@@ -1321,6 +1508,23 @@
           "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",
@@ -1389,73 +1593,38 @@
         "upload.js"
       ]
     },
-    "batch:create": {
+    "auth:delete": {
       "aliases": [],
-      "args": {},
-      "description": "Batch create records on a ServiceNow instance from a JSON file.",
+      "args": {
+        "alias": {
+          "description": "Alias to remove",
+          "name": "alias",
+          "required": false
+        }
+      },
+      "description": "Remove a credential from the store.\n\nThis does not touch the OS keyring — a copy stored there before migrating remains.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --auth dev",
-          "description": "Create records from a JSON file"
+          "command": "<%= config.bin %> <%= command.id %> dev206299",
+          "description": "Remove one alias"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.json --no-transaction --auth dev",
-          "description": "Create records without transactional mode"
+          "command": "<%= config.bin %> <%= command.id %> --all",
+          "description": "Remove every stored credential"
         }
       ],
       "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.",
+          "description": "Accepted for symmetry with other commands and ignored — the auth commands always use @sonisoft/sn-credstore.",
           "helpGroup": "GLOBAL",
           "name": "cred-store",
           "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"
-        },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file with create operations",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "transaction": {
-          "description": "Stop on first error (transactional)",
-          "name": "transaction",
+        "all": {
+          "description": "Remove every stored credential",
+          "name": "all",
           "required": false,
           "allowNo": false,
           "type": "boolean"
@@ -1463,32 +1632,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "batch:create",
+      "id": "auth:delete",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "batch",
-        "create.js"
+        "auth",
+        "delete.js"
       ]
     },
-    "batch:update": {
+    "auth:doctor": {
       "aliases": [],
       "args": {},
-      "description": "Batch update records on a ServiceNow instance from a JSON file.",
+      "description": "Diagnose credential storage: whether the SDK shim is active, which backend is in use, and what is stored.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --auth dev",
-          "description": "Update records from a JSON file"
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "Check credential storage health"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --file ./updates.json --stop-on-error --auth dev",
-          "description": "Update records and stop on first error"
+          "command": "<%= config.bin %> <%= command.id %> --json",
+          "description": "Machine-readable output for CI"
         }
       ],
       "flags": {
@@ -1499,46 +1668,304 @@
           "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.",
+          "description": "Accepted for symmetry with other commands and ignored — the auth commands always use @sonisoft/sn-credstore.",
           "helpGroup": "GLOBAL",
           "name": "cred-store",
           "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"
-        },
-        "file": {
-          "char": "f",
-          "description": "Path to JSON file with update operations",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:doctor",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "doctor.js"
+      ]
+    },
+    "auth:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List credentials in the headless-safe credential store.\n\nThese are the credentials the ServiceNow SDK reads via the sn-credstore shim, which works in non-interactive sessions where the OS keyring cannot be unlocked.\n\nSecrets are never printed.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "List stored credentials"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --json",
+          "description": "List as JSON for scripting"
+        }
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cred-store": {
+          "description": "Accepted for symmetry with other commands and ignored — the auth commands always use @sonisoft/sn-credstore.",
+          "helpGroup": "GLOBAL",
+          "name": "cred-store",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:list",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "list.js"
+      ]
+    },
+    "auth:use": {
+      "aliases": [],
+      "args": {
+        "alias": {
+          "description": "Alias to make the default",
+          "name": "alias",
+          "required": true
+        }
+      },
+      "description": "Set the default credential alias.\n\nCommands run without --auth use this alias.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> dev206299",
+          "description": "Make dev206299 the default"
+        }
+      ],
+      "flags": {
+        "cred-store": {
+          "description": "Accepted for symmetry with other commands and ignored — the auth commands always use @sonisoft/sn-credstore.",
+          "helpGroup": "GLOBAL",
+          "name": "cred-store",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:use",
+      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
+      "pluginName": "@sonisoft/now-sdk-ext-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "use.js"
+      ]
+    },
+    "batch:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Batch create records on a ServiceNow instance from a JSON file.",
+      "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"
+        }
+      ],
+      "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"
+        },
+        "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"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file with create operations",
+          "name": "file",
+          "required": true,
+          "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"
+        },
+        {
+          "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": 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"
+        },
+        "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"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to JSON file with update operations",
+          "name": "file",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
         "stop-on-error": {
@@ -1613,6 +2040,23 @@
           "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",
@@ -1729,6 +2173,23 @@
           "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",
@@ -1888,6 +2349,23 @@
           "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",
@@ -1911,213 +2389,24 @@
           "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"
-      ]
-    },
-    "auth:delete": {
-      "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Alias to remove",
-          "name": "alias",
-          "required": false
-        }
-      },
-      "description": "Remove a credential from the store.\n\nThis does not touch the OS keyring — a copy stored there before migrating remains.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> dev206299",
-          "description": "Remove one alias"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --all",
-          "description": "Remove every stored credential"
-        }
-      ],
-      "flags": {
-        "cred-store": {
-          "description": "Accepted for symmetry with other commands and ignored — the auth commands always use @sonisoft/sn-credstore.",
-          "helpGroup": "GLOBAL",
-          "name": "cred-store",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "description": "Remove every stored credential",
-          "name": "all",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "auth:delete",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "auth",
-        "delete.js"
-      ]
-    },
-    "auth:doctor": {
-      "aliases": [],
-      "args": {},
-      "description": "Diagnose credential storage: whether the SDK shim is active, which backend is in use, and what is stored.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Check credential storage health"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --json",
-          "description": "Machine-readable output for CI"
-        }
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "cred-store": {
-          "description": "Accepted for symmetry with other commands and ignored — the auth commands always use @sonisoft/sn-credstore.",
-          "helpGroup": "GLOBAL",
-          "name": "cred-store",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "auth:doctor",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "auth",
-        "doctor.js"
-      ]
-    },
-    "auth:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List credentials in the headless-safe credential store.\n\nThese are the credentials the ServiceNow SDK reads via the sn-credstore shim, which works in non-interactive sessions where the OS keyring cannot be unlocked.\n\nSecrets are never printed.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "List stored credentials"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --json",
-          "description": "List as JSON for scripting"
-        }
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "cred-store": {
-          "description": "Accepted for symmetry with other commands and ignored — the auth commands always use @sonisoft/sn-credstore.",
-          "helpGroup": "GLOBAL",
-          "name": "cred-store",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "auth:list",
-      "pluginAlias": "@sonisoft/now-sdk-ext-cli",
-      "pluginName": "@sonisoft/now-sdk-ext-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "auth",
-        "list.js"
-      ]
-    },
-    "auth:use": {
-      "aliases": [],
-      "args": {
-        "alias": {
-          "description": "Alias to make the default",
-          "name": "alias",
-          "required": true
-        }
-      },
-      "description": "Set the default credential alias.\n\nCommands run without --auth use this alias.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> dev206299",
-          "description": "Make dev206299 the default"
-        }
-      ],
-      "flags": {
-        "cred-store": {
-          "description": "Accepted for symmetry with other commands and ignored — the auth commands always use @sonisoft/sn-credstore.",
-          "helpGroup": "GLOBAL",
-          "name": "cred-store",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "auth:use",
+      "id": "exec",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
+      "autocomplete": {},
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "auth",
-        "use.js"
+        "exec",
+        "index.js"
       ]
     },
     "flow:action": {
@@ -2156,6 +2445,23 @@
           "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",
@@ -2276,6 +2582,23 @@
           "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",
@@ -2379,6 +2702,23 @@
           "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",
@@ -2483,6 +2823,23 @@
           "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",
@@ -2577,6 +2934,23 @@
           "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",
@@ -2671,6 +3045,23 @@
           "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",
@@ -2777,6 +3168,23 @@
           "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",
@@ -2885,6 +3293,23 @@
           "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",
@@ -2979,6 +3404,23 @@
           "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",
@@ -3095,6 +3537,23 @@
           "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",
@@ -3185,6 +3644,23 @@
           "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",
@@ -3309,6 +3785,23 @@
           "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",
@@ -3423,6 +3916,23 @@
           "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",
@@ -3563,6 +4073,23 @@
           "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",
@@ -3671,6 +4198,23 @@
           "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",
@@ -3775,6 +4319,23 @@
           "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",
@@ -3870,6 +4431,23 @@
           "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",
@@ -3993,6 +4571,23 @@
           "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",
@@ -4045,29 +4640,26 @@
         "syslog.js"
       ]
     },
-    "scope": {
+    "schema:field": {
       "aliases": [],
       "args": {},
-      "description": "Get the current application scope or list available applications.",
+      "description": "Get detailed information about a specific field on a ServiceNow table.\n\nThis command retrieves comprehensive details about a single field, including its type, constraints, choices, and other metadata. Useful for understanding field definitions during development.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --auth dev",
-          "description": "Get the current application scope"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --list --auth dev",
-          "description": "List all available applications"
+          "description": "Explain the state field on incident table",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --field state --auth dev"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -l --json --auth dev",
-          "description": "List applications as JSON"
+          "description": "Explain the priority field on incident table with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --field priority --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -4088,6 +4680,23 @@
           "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",
@@ -4103,19 +4712,29 @@
             "trace"
           ],
           "type": "option"
-        },
-        "list": {
-          "char": "l",
-          "description": "List all available applications",
-          "name": "list",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
+        },
+        "table": {
+          "char": "t",
+          "description": "ServiceNow table name",
+          "name": "table",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "field": {
+          "char": "f",
+          "description": "Field name to explain",
+          "name": "field",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "scope",
+      "id": "schema:field",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4125,29 +4744,30 @@
       "relativePath": [
         "dist",
         "commands",
-        "scope",
-        "index.js"
+        "schema",
+        "field.js"
       ]
     },
-    "scope:set": {
+    "schema": {
       "aliases": [],
       "args": {},
-      "description": "Set the current application scope on a ServiceNow instance.",
+      "description": "Discover and inspect a ServiceNow table schema including fields, types, and relationships.\n\nThis command retrieves the full schema definition for a ServiceNow table, including all fields, their types, constraints, and optionally choices, relationships, UI policies, and business rules.\n\nFeatures:\n  • List all fields with types, lengths, and constraints\n  • Optionally include field choices\n  • Optionally include table relationships\n  • Optionally include UI policies\n  • Optionally include business rules\n  • JSON output for CI/CD integration",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --app-id abc123def456ghi789jkl012mno345pq --auth dev",
-          "description": "Set application scope by sys_id"
+          "description": "Discover incident table schema",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --auth dev"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -a abc123def456ghi789jkl012mno345pq --json --auth dev",
-          "description": "Set application scope and output as JSON"
+          "description": "Include choices and relationships",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --include-choices --include-relationships --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -4168,6 +4788,23 @@
           "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",
@@ -4184,19 +4821,47 @@
           ],
           "type": "option"
         },
-        "app-id": {
-          "char": "a",
-          "description": "32-char sys_id of application",
-          "name": "app-id",
+        "table": {
+          "char": "t",
+          "description": "ServiceNow table name to discover schema for",
+          "name": "table",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "include-choices": {
+          "description": "Include field choices in the schema output",
+          "name": "include-choices",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "include-relationships": {
+          "description": "Include table relationships in the schema output",
+          "name": "include-relationships",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "include-ui-policies": {
+          "description": "Include UI policies in the schema output",
+          "name": "include-ui-policies",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "include-business-rules": {
+          "description": "Include business rules in the schema output",
+          "name": "include-business-rules",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "scope:set",
+      "id": "schema",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4206,33 +4871,30 @@
       "relativePath": [
         "dist",
         "commands",
-        "scope",
-        "set.js"
+        "schema",
+        "index.js"
       ]
     },
-    "script-sync:pull": {
+    "schema:validate-catalog": {
       "aliases": [],
       "args": {},
-      "description": "Pull a script from a ServiceNow instance to a local file.\n\nThis command downloads a script record from your ServiceNow instance and saves it as a local file. Supports multiple script types including Script Includes, Business Rules, UI Scripts, UI Actions, and Client Scripts.\n\nFeatures:\n  • Download scripts by name and type\n  • Custom output file path support\n  • Auto-generated file names based on script name and type\n  • JSON output for CI/CD integration",
+      "description": "Validate a ServiceNow catalog item configuration for common issues.\n\nThis command checks a catalog item configuration and reports any validation issues, warnings, or errors found. Useful for ensuring catalog items are properly configured before deployment.",
       "examples": [
         {
-          "description": "Pull a Script Include to auto-generated file name",
-          "command": "<%= config.bin %> <%= command.id %> --name MyScriptInclude --type sys_script_include --auth dev-instance"
-        },
-        {
-          "description": "Pull a Business Rule to a specific file",
-          "command": "<%= config.bin %> <%= command.id %> --name MyBusinessRule --type sys_script --output ./scripts/my-rule.js --auth dev-instance"
+          "description": "Validate a catalog item by sys_id",
+          "command": "<%= config.bin %> <%= command.id %> --sys-id a1b2c3d4e5f6 --auth dev"
         },
         {
-          "description": "Pull a Client Script with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> -n MyClientScript -t sys_script_client --json --auth dev-instance"
+          "description": "Validate a catalog item with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> --sys-id a1b2c3d4e5f6 --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -4253,6 +4915,23 @@
           "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",
@@ -4269,44 +4948,19 @@
           ],
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "Name of the script to pull",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "char": "t",
-          "description": "Type of script to pull",
-          "name": "type",
+        "sys-id": {
+          "char": "s",
+          "description": "Catalog item sys_id to validate",
+          "name": "sys-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "sys_script_include",
-            "sys_script",
-            "sys_ui_script",
-            "sys_ui_action",
-            "sys_script_client"
-          ],
-          "type": "option"
-        },
-        "output": {
-          "char": "o",
-          "description": "Output file path. If not specified, a file name is auto-generated.",
-          "name": "output",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "script-sync:pull",
+      "id": "schema:validate-catalog",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4316,26 +4970,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "script-sync",
-        "pull.js"
+        "schema",
+        "validate-catalog.js"
       ]
     },
-    "script-sync:push": {
+    "scope": {
       "aliases": [],
       "args": {},
-      "description": "Push a local script file to a ServiceNow instance.\n\nThis command uploads a local script file to your ServiceNow instance, updating the corresponding script record. Supports multiple script types including Script Includes, Business Rules, UI Scripts, UI Actions, and Client Scripts.\n\nFeatures:\n  • Upload scripts by name and type\n  • Specify the local file to push\n  • JSON output for CI/CD integration\n  • Detailed push result reporting",
+      "description": "Get the current application scope or list available applications.",
       "examples": [
         {
-          "description": "Push a Script Include from a local file",
-          "command": "<%= config.bin %> <%= command.id %> --name MyScriptInclude --type sys_script_include --file ./scripts/MyScriptInclude.js --auth dev-instance"
+          "command": "<%= config.bin %> <%= command.id %> --auth dev",
+          "description": "Get the current application scope"
         },
         {
-          "description": "Push a Business Rule with short flags",
-          "command": "<%= config.bin %> <%= command.id %> -n MyBusinessRule -t sys_script -f ./scripts/my-rule.js -a dev-instance"
+          "command": "<%= config.bin %> <%= command.id %> --list --auth dev",
+          "description": "List all available applications"
         },
         {
-          "description": "Push a UI Script with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --auth dev-instance"
+          "command": "<%= config.bin %> <%= command.id %> -l --json --auth dev",
+          "description": "List applications as JSON"
         }
       ],
       "flags": {
@@ -4363,6 +5017,23 @@
           "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",
@@ -4379,44 +5050,18 @@
           ],
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "Name of the script to push",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "char": "t",
-          "description": "Type of script to push",
-          "name": "type",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "sys_script_include",
-            "sys_script",
-            "sys_ui_script",
-            "sys_ui_action",
-            "sys_script_client"
-          ],
-          "type": "option"
-        },
-        "file": {
-          "char": "f",
-          "description": "Path to the local script file to push",
-          "name": "file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "list": {
+          "char": "l",
+          "description": "List all available applications",
+          "name": "list",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "script-sync:push",
+      "id": "scope",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4426,26 +5071,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "script-sync",
-        "push.js"
+        "scope",
+        "index.js"
       ]
     },
-    "script-sync:sync": {
+    "scope:set": {
       "aliases": [],
       "args": {},
-      "description": "Synchronize all scripts in a directory with a ServiceNow instance.\n\nThis command scans a local directory for script files and synchronizes them with the corresponding records on your ServiceNow instance. You can optionally filter by script types to synchronize only specific kinds of scripts.\n\nFeatures:\n  • Batch synchronization of all scripts in a directory\n  • Filter by one or more script types\n  • Summary report with success/failure counts\n  • JSON output for CI/CD integration",
+      "description": "Set the current application scope on a ServiceNow instance.",
       "examples": [
         {
-          "description": "Sync all scripts in a directory",
-          "command": "<%= config.bin %> <%= command.id %> --directory ./scripts --auth dev-instance"
-        },
-        {
-          "description": "Sync only Script Includes and Business Rules",
-          "command": "<%= config.bin %> <%= command.id %> --directory ./scripts --types sys_script_include --types sys_script --auth dev-instance"
+          "command": "<%= config.bin %> <%= command.id %> --app-id abc123def456ghi789jkl012mno345pq --auth dev",
+          "description": "Set application scope by sys_id"
         },
         {
-          "description": "Sync with JSON output for CI/CD",
-          "command": "<%= config.bin %> <%= command.id %> -d ./scripts --json --auth dev-instance"
+          "command": "<%= config.bin %> <%= command.id %> -a abc123def456ghi789jkl012mno345pq --json --auth dev",
+          "description": "Set application scope and output as JSON"
         }
       ],
       "flags": {
@@ -4465,10 +5106,27 @@
           "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.",
+        "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"
+        },
+        "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": "cred-store",
+          "name": "log-file",
           "required": false,
           "allowNo": false,
           "type": "boolean"
@@ -4489,35 +5147,19 @@
           ],
           "type": "option"
         },
-        "directory": {
-          "char": "d",
-          "description": "Directory containing script files to synchronize",
-          "name": "directory",
+        "app-id": {
+          "char": "a",
+          "description": "32-char sys_id of application",
+          "name": "app-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "types": {
-          "char": "t",
-          "description": "Script types to synchronize. Can be specified multiple times to include multiple types.",
-          "name": "types",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "sys_script_include",
-            "sys_script",
-            "sys_ui_script",
-            "sys_ui_action",
-            "sys_script_client"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "script-sync:sync",
+      "id": "scope:set",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4527,30 +5169,33 @@
       "relativePath": [
         "dist",
         "commands",
-        "script-sync",
-        "sync.js"
+        "scope",
+        "set.js"
       ]
     },
-    "schema:field": {
+    "script-sync:pull": {
       "aliases": [],
       "args": {},
-      "description": "Get detailed information about a specific field on a ServiceNow table.\n\nThis command retrieves comprehensive details about a single field, including its type, constraints, choices, and other metadata. Useful for understanding field definitions during development.",
+      "description": "Pull a script from a ServiceNow instance to a local file.\n\nThis command downloads a script record from your ServiceNow instance and saves it as a local file. Supports multiple script types including Script Includes, Business Rules, UI Scripts, UI Actions, and Client Scripts.\n\nFeatures:\n  • Download scripts by name and type\n  • Custom output file path support\n  • Auto-generated file names based on script name and type\n  • JSON output for CI/CD integration",
       "examples": [
         {
-          "description": "Explain the state field on incident table",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --field state --auth dev"
+          "description": "Pull a Script Include to auto-generated file name",
+          "command": "<%= config.bin %> <%= command.id %> --name MyScriptInclude --type sys_script_include --auth dev-instance"
         },
         {
-          "description": "Explain the priority field on incident table with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --field priority --json --auth dev"
+          "description": "Pull a Business Rule to a specific file",
+          "command": "<%= config.bin %> <%= command.id %> --name MyBusinessRule --type sys_script --output ./scripts/my-rule.js --auth dev-instance"
+        },
+        {
+          "description": "Pull a Client Script with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> -n MyClientScript -t sys_script_client --json --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"
         },
@@ -4571,6 +5216,23 @@
           "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",
@@ -4587,28 +5249,44 @@
           ],
           "type": "option"
         },
-        "table": {
-          "char": "t",
-          "description": "ServiceNow table name",
-          "name": "table",
+        "name": {
+          "char": "n",
+          "description": "Name of the script to pull",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "field": {
-          "char": "f",
-          "description": "Field name to explain",
-          "name": "field",
+        "type": {
+          "char": "t",
+          "description": "Type of script to pull",
+          "name": "type",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "sys_script_include",
+            "sys_script",
+            "sys_ui_script",
+            "sys_ui_action",
+            "sys_script_client"
+          ],
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output file path. If not specified, a file name is auto-generated.",
+          "name": "output",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "schema:field",
+      "id": "script-sync:pull",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4618,30 +5296,33 @@
       "relativePath": [
         "dist",
         "commands",
-        "schema",
-        "field.js"
+        "script-sync",
+        "pull.js"
       ]
     },
-    "schema": {
+    "script-sync:push": {
       "aliases": [],
       "args": {},
-      "description": "Discover and inspect a ServiceNow table schema including fields, types, and relationships.\n\nThis command retrieves the full schema definition for a ServiceNow table, including all fields, their types, constraints, and optionally choices, relationships, UI policies, and business rules.\n\nFeatures:\n  • List all fields with types, lengths, and constraints\n  • Optionally include field choices\n  • Optionally include table relationships\n  • Optionally include UI policies\n  • Optionally include business rules\n  • JSON output for CI/CD integration",
+      "description": "Push a local script file to a ServiceNow instance.\n\nThis command uploads a local script file to your ServiceNow instance, updating the corresponding script record. Supports multiple script types including Script Includes, Business Rules, UI Scripts, UI Actions, and Client Scripts.\n\nFeatures:\n  • Upload scripts by name and type\n  • Specify the local file to push\n  • JSON output for CI/CD integration\n  • Detailed push result reporting",
       "examples": [
         {
-          "description": "Discover incident table schema",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --auth dev"
+          "description": "Push a Script Include from a local file",
+          "command": "<%= config.bin %> <%= command.id %> --name MyScriptInclude --type sys_script_include --file ./scripts/MyScriptInclude.js --auth dev-instance"
         },
         {
-          "description": "Include choices and relationships",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --include-choices --include-relationships --auth dev"
+          "description": "Push a Business Rule with short flags",
+          "command": "<%= config.bin %> <%= command.id %> -n MyBusinessRule -t sys_script -f ./scripts/my-rule.js -a dev-instance"
+        },
+        {
+          "description": "Push a UI Script with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> -n MyUIScript -t sys_ui_script -f ./scripts/ui-script.js --json --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"
         },
@@ -4662,6 +5343,23 @@
           "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",
@@ -4678,47 +5376,44 @@
           ],
           "type": "option"
         },
-        "table": {
-          "char": "t",
-          "description": "ServiceNow table name to discover schema for",
-          "name": "table",
+        "name": {
+          "char": "n",
+          "description": "Name of the script to push",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "include-choices": {
-          "description": "Include field choices in the schema output",
-          "name": "include-choices",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "include-relationships": {
-          "description": "Include table relationships in the schema output",
-          "name": "include-relationships",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "include-ui-policies": {
-          "description": "Include UI policies in the schema output",
-          "name": "include-ui-policies",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
+        "type": {
+          "char": "t",
+          "description": "Type of script to push",
+          "name": "type",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "sys_script_include",
+            "sys_script",
+            "sys_ui_script",
+            "sys_ui_action",
+            "sys_script_client"
+          ],
+          "type": "option"
         },
-        "include-business-rules": {
-          "description": "Include business rules in the schema output",
-          "name": "include-business-rules",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
+        "file": {
+          "char": "f",
+          "description": "Path to the local script file to push",
+          "name": "file",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "schema",
+      "id": "script-sync:push",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4728,30 +5423,33 @@
       "relativePath": [
         "dist",
         "commands",
-        "schema",
-        "index.js"
+        "script-sync",
+        "push.js"
       ]
     },
-    "schema:validate-catalog": {
+    "script-sync:sync": {
       "aliases": [],
       "args": {},
-      "description": "Validate a ServiceNow catalog item configuration for common issues.\n\nThis command checks a catalog item configuration and reports any validation issues, warnings, or errors found. Useful for ensuring catalog items are properly configured before deployment.",
+      "description": "Synchronize all scripts in a directory with a ServiceNow instance.\n\nThis command scans a local directory for script files and synchronizes them with the corresponding records on your ServiceNow instance. You can optionally filter by script types to synchronize only specific kinds of scripts.\n\nFeatures:\n  • Batch synchronization of all scripts in a directory\n  • Filter by one or more script types\n  • Summary report with success/failure counts\n  • JSON output for CI/CD integration",
       "examples": [
         {
-          "description": "Validate a catalog item by sys_id",
-          "command": "<%= config.bin %> <%= command.id %> --sys-id a1b2c3d4e5f6 --auth dev"
+          "description": "Sync all scripts in a directory",
+          "command": "<%= config.bin %> <%= command.id %> --directory ./scripts --auth dev-instance"
         },
         {
-          "description": "Validate a catalog item with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> --sys-id a1b2c3d4e5f6 --json --auth dev"
+          "description": "Sync only Script Includes and Business Rules",
+          "command": "<%= config.bin %> <%= command.id %> --directory ./scripts --types sys_script_include --types sys_script --auth dev-instance"
+        },
+        {
+          "description": "Sync with JSON output for CI/CD",
+          "command": "<%= config.bin %> <%= command.id %> -d ./scripts --json --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"
         },
@@ -4772,6 +5470,23 @@
           "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",
@@ -4788,19 +5503,35 @@
           ],
           "type": "option"
         },
-        "sys-id": {
-          "char": "s",
-          "description": "Catalog item sys_id to validate",
-          "name": "sys-id",
+        "directory": {
+          "char": "d",
+          "description": "Directory containing script files to synchronize",
+          "name": "directory",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "types": {
+          "char": "t",
+          "description": "Script types to synchronize. Can be specified multiple times to include multiple types.",
+          "name": "types",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "sys_script_include",
+            "sys_script",
+            "sys_ui_script",
+            "sys_ui_action",
+            "sys_script_client"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "schema:validate-catalog",
+      "id": "script-sync:sync",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -4810,8 +5541,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "schema",
-        "validate-catalog.js"
+        "script-sync",
+        "sync.js"
       ]
     },
     "search:add-table": {
@@ -4857,6 +5588,23 @@
           "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",
@@ -4956,6 +5704,23 @@
           "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",
@@ -5036,6 +5801,23 @@
           "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",
@@ -5152,6 +5934,23 @@
           "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",
@@ -5237,6 +6036,23 @@
           "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",
@@ -5363,6 +6179,23 @@
           "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",
@@ -5471,6 +6304,23 @@
           "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",
@@ -5582,6 +6432,23 @@
           "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",
@@ -5624,18 +6491,18 @@
         "validate.js"
       ]
     },
-    "update-set:clone": {
+    "task:approve": {
       "aliases": [],
       "args": {},
-      "description": "Clone an update set and its records.",
+      "description": "Approve a ServiceNow change request.\n\nThis command approves a change request identified by its number. You can optionally provide approval comments.\n\nFeatures:\n  - Approve change requests\n  - Optionally add approval comments\n  - Auto-resolves change request number to sys_id",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --source us-001 --name \"Cloned Set\" --auth dev-instance",
-          "description": "Clone an update set"
+          "command": "<%= config.bin %> <%= command.id %> --number CHG0010001 --auth dev",
+          "description": "Approve a change request"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --source us-001 --name \"Cloned Set\" --json --auth dev-instance",
-          "description": "Clone with JSON output"
+          "command": "<%= config.bin %> <%= command.id %> -n CHG0010001 -c \"Looks good, approved\" --auth dev",
+          "description": "Approve a change request with comments"
         }
       ],
       "flags": {
@@ -5663,6 +6530,23 @@
           "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",
@@ -5679,19 +6563,19 @@
           ],
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "Name for the cloned update set",
-          "name": "name",
-          "required": true,
+        "comments": {
+          "char": "c",
+          "description": "Approval comments",
+          "name": "comments",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "source": {
-          "char": "s",
-          "description": "Source update set sys_id",
-          "name": "source",
+        "number": {
+          "char": "n",
+          "description": "Change request number (e.g., CHG0010001)",
+          "name": "number",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -5700,7 +6584,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "update-set:clone",
+      "id": "task:approve",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -5710,26 +6594,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "update-set",
-        "clone.js"
+        "task",
+        "approve.js"
       ]
     },
-    "update-set:create": {
+    "task:assign": {
       "aliases": [],
       "args": {},
-      "description": "Create a new update set.",
+      "description": "Assign a ServiceNow task to a user or group.\n\nThis command assigns a task record identified by its number to a specified user and/or group. You can assign to a user, a group, or both simultaneously.\n\nFeatures:\n  - Assign tasks to individual users\n  - Assign tasks to assignment groups\n  - Assign to both user and group at once\n  - Supports any task-based table\n  - Auto-resolves task number to sys_id",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --name \"My Feature Set\" --auth dev-instance",
-          "description": "Create a new update set with a name"
+          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --user admin --auth dev",
+          "description": "Assign an incident to a user"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --name \"My Feature Set\" --description \"Update set for feature X\" --auth dev-instance",
-          "description": "Create with name and description"
+          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 -u admin -g \"Service Desk\" --auth dev",
+          "description": "Assign an incident to a user and group"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --name \"My Feature Set\" --application x_my_app --auth dev-instance",
-          "description": "Create within a specific application scope"
+          "command": "<%= config.bin %> <%= command.id %> --number CHG0010001 --table change_request --user admin --auth dev",
+          "description": "Assign a change request to a user"
         }
       ],
       "flags": {
@@ -5757,6 +6641,23 @@
           "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",
@@ -5773,27 +6674,37 @@
           ],
           "type": "option"
         },
-        "application": {
-          "description": "Application scope for the new update set",
-          "name": "application",
+        "group": {
+          "char": "g",
+          "description": "Assignment group",
+          "name": "group",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "char": "d",
-          "description": "Description for the new update set",
-          "name": "description",
+        "number": {
+          "char": "n",
+          "description": "Task number (e.g., INC0010001)",
+          "name": "number",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "table": {
+          "description": "ServiceNow table name",
+          "name": "table",
           "required": false,
+          "default": "task",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "Name for the new update set",
-          "name": "name",
+        "user": {
+          "char": "u",
+          "description": "User to assign the task to",
+          "name": "user",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -5802,7 +6713,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "update-set:create",
+      "id": "task:assign",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -5812,26 +6723,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "update-set",
-        "create.js"
+        "task",
+        "assign.js"
       ]
     },
-    "update-set:current": {
+    "task:close": {
       "aliases": [],
       "args": {},
-      "description": "Get or set the current update set.",
+      "description": "Close a ServiceNow incident.\n\nThis command closes an incident identified by its number, setting the close notes and optionally a close code. The incident must be in a state that allows closure.\n\nFeatures:\n  - Close incidents with close notes\n  - Optionally specify a close code\n  - Auto-resolves incident number to sys_id",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --auth dev-instance",
-          "description": "Get the current update set"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --set us-001 --auth dev-instance",
-          "description": "Set the current update set by sys_id"
+          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --notes \"Issue confirmed resolved by user\" --auth dev",
+          "description": "Close an incident with close notes"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --json --auth dev-instance",
-          "description": "Get the current update set as JSON"
+          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 --notes \"Closed\" --close-code \"Solved (Permanently)\" --auth dev",
+          "description": "Close with a specific close code"
         }
       ],
       "flags": {
@@ -5859,6 +6766,23 @@
           "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",
@@ -5866,20 +6790,36 @@
           "default": "info",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "debug",
-            "warn",
-            "error",
-            "info",
-            "trace"
-          ],
+          "options": [
+            "debug",
+            "warn",
+            "error",
+            "info",
+            "trace"
+          ],
+          "type": "option"
+        },
+        "close-code": {
+          "description": "Close code for the closure",
+          "name": "close-code",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "notes": {
+          "description": "Close notes",
+          "name": "notes",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
-        "set": {
-          "char": "s",
-          "description": "sys_id of update set to make current",
-          "name": "set",
-          "required": false,
+        "number": {
+          "char": "n",
+          "description": "Incident number (e.g., INC0010001)",
+          "name": "number",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -5887,7 +6827,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "update-set:current",
+      "id": "task:close",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -5897,26 +6837,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "update-set",
-        "current.js"
+        "task",
+        "close.js"
       ]
     },
-    "update-set": {
+    "task:comment": {
       "aliases": [],
       "args": {},
-      "description": "List update sets on a ServiceNow instance.",
+      "description": "Add a comment or work note to a ServiceNow task.\n\nThis command adds a comment or work note to a task record identified by its number. By default, comments are added as customer-visible comments. Use the --work-note flag to add an internal work note instead.\n\nFeatures:\n  - Add customer-visible comments to any task\n  - Add internal work notes visible only to fulfiller teams\n  - Supports any task-based table (incident, change_request, etc.)\n  - Auto-resolves task number to sys_id",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --auth dev-instance",
-          "description": "List update sets with default limit"
+          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --comment \"Investigating the issue\" --auth dev",
+          "description": "Add a comment to an incident"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --query \"state=in progress\" --limit 50 --auth dev-instance",
-          "description": "List update sets with a custom query filter"
+          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 -c \"Internal update\" --work-note --auth dev",
+          "description": "Add a work note to an incident"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --json --auth dev-instance",
-          "description": "List update sets with JSON output"
+          "command": "<%= config.bin %> <%= command.id %> --number CHG0010001 --table change_request --comment \"Approved\" --auth dev",
+          "description": "Add a comment to a change request"
         }
       ],
       "flags": {
@@ -5944,6 +6884,23 @@
           "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",
@@ -5960,28 +6917,44 @@
           ],
           "type": "option"
         },
-        "limit": {
-          "description": "Maximum number of update sets to return",
-          "name": "limit",
-          "required": false,
-          "default": 20,
+        "comment": {
+          "char": "c",
+          "description": "Comment text to add",
+          "name": "comment",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "query": {
-          "char": "q",
-          "description": "Encoded query filter",
-          "name": "query",
+        "number": {
+          "char": "n",
+          "description": "Task number (e.g., INC0010001)",
+          "name": "number",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "table": {
+          "description": "ServiceNow table name",
+          "name": "table",
           "required": false,
+          "default": "task",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "work-note": {
+          "description": "Add as work note instead of comment",
+          "name": "work-note",
+          "required": false,
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "update-set",
+      "id": "task:comment",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -5991,22 +6964,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "update-set",
-        "index.js"
+        "task",
+        "comment.js"
       ]
     },
-    "update-set:inspect": {
+    "task:find": {
       "aliases": [],
       "args": {},
-      "description": "Inspect the components of an update set.",
+      "description": "Find a ServiceNow task by its number.\n\nThis command looks up a task record by its number in the specified table. Returns the full task details including sys_id, description, state, and assignment information.\n\nFeatures:\n  - Look up any task by number\n  - Supports any task-based table\n  - JSON output for scripting and automation",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --sys-id us-001 --auth dev-instance",
-          "description": "Inspect an update set by sys_id"
+          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --auth dev",
+          "description": "Find an incident by number"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --sys-id us-001 --json --auth dev-instance",
-          "description": "Inspect with JSON output"
+          "command": "<%= config.bin %> <%= command.id %> -n CHG0010001 --table change_request --auth dev",
+          "description": "Find a change request by number"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 --json --auth dev",
+          "description": "Find an incident and output as JSON"
         }
       ],
       "flags": {
@@ -6034,6 +7011,23 @@
           "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",
@@ -6050,19 +7044,28 @@
           ],
           "type": "option"
         },
-        "sys-id": {
-          "char": "s",
-          "description": "sys_id of the update set to inspect",
-          "name": "sys-id",
+        "number": {
+          "char": "n",
+          "description": "Task number (e.g., INC0010001, CHG0010001)",
+          "name": "number",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "table": {
+          "description": "ServiceNow table name",
+          "name": "table",
+          "required": false,
+          "default": "task",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "update-set:inspect",
+      "id": "task:find",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6072,26 +7075,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "update-set",
-        "inspect.js"
+        "task",
+        "find.js"
       ]
     },
-    "update-set:move": {
+    "task:resolve": {
       "aliases": [],
       "args": {},
-      "description": "Move records between update sets.",
+      "description": "Resolve a ServiceNow incident with resolution notes.\n\nThis command resolves an incident identified by its number, setting the resolution notes and optionally a close code. The incident must be in a state that allows resolution.\n\nFeatures:\n  - Resolve incidents with resolution notes\n  - Optionally specify a close code\n  - Auto-resolves incident number to sys_id",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --target us-002 --source us-001 --auth dev-instance",
-          "description": "Move all records from one update set to another"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --target us-002 --records \"rec-001,rec-002,rec-003\" --auth dev-instance",
-          "description": "Move specific records to a target update set"
+          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --notes \"Issue resolved by restarting the service\" --auth dev",
+          "description": "Resolve an incident with resolution notes"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --target us-002 --source us-001 --json --auth dev-instance",
-          "description": "Move records with JSON output"
+          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 --notes \"Fixed\" --close-code \"Solved (Permanently)\" --auth dev",
+          "description": "Resolve with a specific close code"
         }
       ],
       "flags": {
@@ -6119,6 +7118,23 @@
           "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",
@@ -6135,25 +7151,26 @@
           ],
           "type": "option"
         },
-        "records": {
-          "description": "Comma-separated sys_ids of records to move",
-          "name": "records",
+        "close-code": {
+          "description": "Close code for the resolution",
+          "name": "close-code",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "source": {
-          "description": "Source update set sys_id",
-          "name": "source",
-          "required": false,
+        "notes": {
+          "description": "Resolution notes",
+          "name": "notes",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "target": {
-          "description": "Target update set sys_id",
-          "name": "target",
+        "number": {
+          "char": "n",
+          "description": "Incident number (e.g., INC0010001)",
+          "name": "number",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6162,7 +7179,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "update-set:move",
+      "id": "task:resolve",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6172,22 +7189,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "update-set",
-        "move.js"
+        "task",
+        "resolve.js"
       ]
     },
-    "workflow:create": {
+    "update-set:clone": {
       "aliases": [],
       "args": {},
-      "description": "Create a complete workflow from a JSON specification file.",
+      "description": "Clone an update set and its records.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --spec ./workflow.json --auth dev",
-          "description": "Create a workflow from a JSON spec file"
+          "command": "<%= config.bin %> <%= command.id %> --source us-001 --name \"Cloned Set\" --auth dev-instance",
+          "description": "Clone an update set"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -s ./workflow.json --json --auth dev",
-          "description": "Create a workflow and output result as JSON"
+          "command": "<%= config.bin %> <%= command.id %> --source us-001 --name \"Cloned Set\" --json --auth dev-instance",
+          "description": "Clone with JSON output"
         }
       ],
       "flags": {
@@ -6215,6 +7232,23 @@
           "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",
@@ -6231,10 +7265,19 @@
           ],
           "type": "option"
         },
-        "spec": {
+        "name": {
+          "char": "n",
+          "description": "Name for the cloned update set",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source": {
           "char": "s",
-          "description": "Path to workflow JSON specification file",
-          "name": "spec",
+          "description": "Source update set sys_id",
+          "name": "source",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6243,7 +7286,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workflow:create",
+      "id": "update-set:clone",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6253,22 +7296,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "workflow",
-        "create.js"
+        "update-set",
+        "clone.js"
       ]
     },
-    "workflow:publish": {
+    "update-set:create": {
       "aliases": [],
       "args": {},
-      "description": "Publish a workflow version.",
+      "description": "Create a new update set.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --version-id wfv-001 --start-activity act-001 --auth dev",
-          "description": "Publish a workflow version"
+          "command": "<%= config.bin %> <%= command.id %> --name \"My Feature Set\" --auth dev-instance",
+          "description": "Create a new update set with a name"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -v wfv-001 -s act-001 --json --auth dev",
-          "description": "Publish a workflow version and output as JSON"
+          "command": "<%= config.bin %> <%= command.id %> --name \"My Feature Set\" --description \"Update set for feature X\" --auth dev-instance",
+          "description": "Create with name and description"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --name \"My Feature Set\" --application x_my_app --auth dev-instance",
+          "description": "Create within a specific application scope"
         }
       ],
       "flags": {
@@ -6296,6 +7343,23 @@
           "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",
@@ -6312,19 +7376,27 @@
           ],
           "type": "option"
         },
-        "start-activity": {
-          "char": "s",
-          "description": "Sys ID of the start activity",
-          "name": "start-activity",
-          "required": true,
+        "application": {
+          "description": "Application scope for the new update set",
+          "name": "application",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "version-id": {
-          "char": "v",
-          "description": "Sys ID of the workflow version to publish",
-          "name": "version-id",
+        "description": {
+          "char": "d",
+          "description": "Description for the new update set",
+          "name": "description",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Name for the new update set",
+          "name": "name",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6333,7 +7405,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workflow:publish",
+      "id": "update-set:create",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6343,34 +7415,33 @@
       "relativePath": [
         "dist",
         "commands",
-        "workflow",
-        "publish.js"
+        "update-set",
+        "create.js"
       ]
     },
-    "xml:export": {
+    "update-set:current": {
       "aliases": [],
       "args": {},
-      "description": "Export a single ServiceNow record as XML.\n\nDownloads the XML representation of a specific record from a ServiceNow table. Without --output, the XML is printed to stdout. With --output, the XML is written to the specified file path.\n\nFeatures:\n  • Export any record by table and sys_id\n  • Print XML to stdout for piping to other tools\n  • Save directly to a file with --output\n  • JSON output mode for CI/CD integration",
+      "description": "Get or set the current update set.",
       "examples": [
         {
-          "description": "Export a record to stdout",
-          "command": "<%= config.bin %> <%= command.id %> --table sys_script_include --sys-id abc123def456 --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --auth dev-instance",
+          "description": "Get the current update set"
         },
         {
-          "description": "Export and save to a file",
-          "command": "<%= config.bin %> <%= command.id %> --table incident --sys-id abc123 --output ./export.xml --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --set us-001 --auth dev-instance",
+          "description": "Set the current update set by sys_id"
         },
         {
-          "description": "Export as JSON metadata",
-          "command": "<%= config.bin %> <%= command.id %> --table sys_script --sys-id abc123 --json --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --json --auth dev-instance",
+          "description": "Get the current update set as JSON"
         }
       ],
       "flags": {
         "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
-          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -6391,6 +7462,23 @@
           "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",
@@ -6407,28 +7495,10 @@
           ],
           "type": "option"
         },
-        "table": {
-          "char": "t",
-          "description": "Table name of the record to export",
-          "name": "table",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sys-id": {
+        "set": {
           "char": "s",
-          "description": "Sys ID of the record to export",
-          "name": "sys-id",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output": {
-          "char": "o",
-          "description": "File path to write the exported XML to. If omitted, XML is printed to stdout.",
-          "name": "output",
+          "description": "sys_id of update set to make current",
+          "name": "set",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6437,7 +7507,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "xml:export",
+      "id": "update-set:current",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6447,30 +7517,33 @@
       "relativePath": [
         "dist",
         "commands",
-        "xml",
-        "export.js"
+        "update-set",
+        "current.js"
       ]
     },
-    "xml:import": {
+    "update-set": {
       "aliases": [],
       "args": {},
-      "description": "Import XML records into a ServiceNow instance.\n\nReads an XML file and imports its contents into the specified target table. The XML should be in ServiceNow unload format.\n\nFeatures:\n  • Import from local XML files\n  • Target a specific table\n  • JSON output mode for CI/CD integration",
+      "description": "List update sets on a ServiceNow instance.",
       "examples": [
         {
-          "description": "Import records from an XML file",
-          "command": "<%= config.bin %> <%= command.id %> --file ./export.xml --table sys_script_include --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --auth dev-instance",
+          "description": "List update sets with default limit"
         },
         {
-          "description": "Import with JSON output",
-          "command": "<%= config.bin %> <%= command.id %> --file ./records.xml --table incident --json --auth dev"
+          "command": "<%= config.bin %> <%= command.id %> --query \"state=in progress\" --limit 50 --auth dev-instance",
+          "description": "List update sets with a custom query filter"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --json --auth dev-instance",
+          "description": "List update sets with JSON output"
         }
       ],
       "flags": {
         "json": {
-          "char": "j",
-          "description": "Output results as JSON",
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
           "name": "json",
-          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -6491,6 +7564,23 @@
           "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",
@@ -6507,20 +7597,20 @@
           ],
           "type": "option"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to the XML file to import",
-          "name": "file",
-          "required": true,
+        "limit": {
+          "description": "Maximum number of update sets to return",
+          "name": "limit",
+          "required": false,
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "table": {
-          "char": "t",
-          "description": "Target table to import records into",
-          "name": "table",
-          "required": true,
+        "query": {
+          "char": "q",
+          "description": "Encoded query filter",
+          "name": "query",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -6528,7 +7618,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "xml:import",
+      "id": "update-set",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6538,22 +7628,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "xml",
-        "import.js"
+        "update-set",
+        "index.js"
       ]
     },
-    "task:approve": {
+    "update-set:inspect": {
       "aliases": [],
       "args": {},
-      "description": "Approve a ServiceNow change request.\n\nThis command approves a change request identified by its number. You can optionally provide approval comments.\n\nFeatures:\n  - Approve change requests\n  - Optionally add approval comments\n  - Auto-resolves change request number to sys_id",
+      "description": "Inspect the components of an update set.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --number CHG0010001 --auth dev",
-          "description": "Approve a change request"
+          "command": "<%= config.bin %> <%= command.id %> --sys-id us-001 --auth dev-instance",
+          "description": "Inspect an update set by sys_id"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -n CHG0010001 -c \"Looks good, approved\" --auth dev",
-          "description": "Approve a change request with comments"
+          "command": "<%= config.bin %> <%= command.id %> --sys-id us-001 --json --auth dev-instance",
+          "description": "Inspect with JSON output"
         }
       ],
       "flags": {
@@ -6581,6 +7671,23 @@
           "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",
@@ -6597,19 +7704,10 @@
           ],
           "type": "option"
         },
-        "comments": {
-          "char": "c",
-          "description": "Approval comments",
-          "name": "comments",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "number": {
-          "char": "n",
-          "description": "Change request number (e.g., CHG0010001)",
-          "name": "number",
+        "sys-id": {
+          "char": "s",
+          "description": "sys_id of the update set to inspect",
+          "name": "sys-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6618,7 +7716,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "task:approve",
+      "id": "update-set:inspect",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6628,26 +7726,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "task",
-        "approve.js"
+        "update-set",
+        "inspect.js"
       ]
     },
-    "task:assign": {
+    "update-set:move": {
       "aliases": [],
       "args": {},
-      "description": "Assign a ServiceNow task to a user or group.\n\nThis command assigns a task record identified by its number to a specified user and/or group. You can assign to a user, a group, or both simultaneously.\n\nFeatures:\n  - Assign tasks to individual users\n  - Assign tasks to assignment groups\n  - Assign to both user and group at once\n  - Supports any task-based table\n  - Auto-resolves task number to sys_id",
+      "description": "Move records between update sets.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --user admin --auth dev",
-          "description": "Assign an incident to a user"
+          "command": "<%= config.bin %> <%= command.id %> --target us-002 --source us-001 --auth dev-instance",
+          "description": "Move all records from one update set to another"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 -u admin -g \"Service Desk\" --auth dev",
-          "description": "Assign an incident to a user and group"
+          "command": "<%= config.bin %> <%= command.id %> --target us-002 --records \"rec-001,rec-002,rec-003\" --auth dev-instance",
+          "description": "Move specific records to a target update set"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --number CHG0010001 --table change_request --user admin --auth dev",
-          "description": "Assign a change request to a user"
+          "command": "<%= config.bin %> <%= command.id %> --target us-002 --source us-001 --json --auth dev-instance",
+          "description": "Move records with JSON output"
         }
       ],
       "flags": {
@@ -6675,6 +7773,23 @@
           "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",
@@ -6691,37 +7806,25 @@
           ],
           "type": "option"
         },
-        "group": {
-          "char": "g",
-          "description": "Assignment group",
-          "name": "group",
+        "records": {
+          "description": "Comma-separated sys_ids of records to move",
+          "name": "records",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "number": {
-          "char": "n",
-          "description": "Task number (e.g., INC0010001)",
-          "name": "number",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "table": {
-          "description": "ServiceNow table name",
-          "name": "table",
+        },
+        "source": {
+          "description": "Source update set sys_id",
+          "name": "source",
           "required": false,
-          "default": "task",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "user": {
-          "char": "u",
-          "description": "User to assign the task to",
-          "name": "user",
+        "target": {
+          "description": "Target update set sys_id",
+          "name": "target",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6730,7 +7833,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "task:assign",
+      "id": "update-set:move",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6740,22 +7843,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "task",
-        "assign.js"
+        "update-set",
+        "move.js"
       ]
     },
-    "task:close": {
+    "workflow:create": {
       "aliases": [],
       "args": {},
-      "description": "Close a ServiceNow incident.\n\nThis command closes an incident identified by its number, setting the close notes and optionally a close code. The incident must be in a state that allows closure.\n\nFeatures:\n  - Close incidents with close notes\n  - Optionally specify a close code\n  - Auto-resolves incident number to sys_id",
+      "description": "Create a complete workflow from a JSON specification file.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --notes \"Issue confirmed resolved by user\" --auth dev",
-          "description": "Close an incident with close notes"
+          "command": "<%= config.bin %> <%= command.id %> --spec ./workflow.json --auth dev",
+          "description": "Create a workflow from a JSON spec file"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 --notes \"Closed\" --close-code \"Solved (Permanently)\" --auth dev",
-          "description": "Close with a specific close code"
+          "command": "<%= config.bin %> <%= command.id %> -s ./workflow.json --json --auth dev",
+          "description": "Create a workflow and output result as JSON"
         }
       ],
       "flags": {
@@ -6783,6 +7886,23 @@
           "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",
@@ -6799,26 +7919,10 @@
           ],
           "type": "option"
         },
-        "close-code": {
-          "description": "Close code for the closure",
-          "name": "close-code",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "notes": {
-          "description": "Close notes",
-          "name": "notes",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "number": {
-          "char": "n",
-          "description": "Incident number (e.g., INC0010001)",
-          "name": "number",
+        "spec": {
+          "char": "s",
+          "description": "Path to workflow JSON specification file",
+          "name": "spec",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -6827,7 +7931,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "task:close",
+      "id": "workflow:create",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6837,26 +7941,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "task",
-        "close.js"
+        "workflow",
+        "create.js"
       ]
     },
-    "task:comment": {
+    "workflow:publish": {
       "aliases": [],
       "args": {},
-      "description": "Add a comment or work note to a ServiceNow task.\n\nThis command adds a comment or work note to a task record identified by its number. By default, comments are added as customer-visible comments. Use the --work-note flag to add an internal work note instead.\n\nFeatures:\n  - Add customer-visible comments to any task\n  - Add internal work notes visible only to fulfiller teams\n  - Supports any task-based table (incident, change_request, etc.)\n  - Auto-resolves task number to sys_id",
+      "description": "Publish a workflow version.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --comment \"Investigating the issue\" --auth dev",
-          "description": "Add a comment to an incident"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 -c \"Internal update\" --work-note --auth dev",
-          "description": "Add a work note to an incident"
+          "command": "<%= config.bin %> <%= command.id %> --version-id wfv-001 --start-activity act-001 --auth dev",
+          "description": "Publish a workflow version"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --number CHG0010001 --table change_request --comment \"Approved\" --auth dev",
-          "description": "Add a comment to a change request"
+          "command": "<%= config.bin %> <%= command.id %> -v wfv-001 -s act-001 --json --auth dev",
+          "description": "Publish a workflow version and output as JSON"
         }
       ],
       "flags": {
@@ -6884,6 +7984,23 @@
           "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",
@@ -6900,44 +8017,28 @@
           ],
           "type": "option"
         },
-        "comment": {
-          "char": "c",
-          "description": "Comment text to add",
-          "name": "comment",
+        "start-activity": {
+          "char": "s",
+          "description": "Sys ID of the start activity",
+          "name": "start-activity",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "number": {
-          "char": "n",
-          "description": "Task number (e.g., INC0010001)",
-          "name": "number",
+        "version-id": {
+          "char": "v",
+          "description": "Sys ID of the workflow version to publish",
+          "name": "version-id",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "table": {
-          "description": "ServiceNow table name",
-          "name": "table",
-          "required": false,
-          "default": "task",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "work-note": {
-          "description": "Add as work note instead of comment",
-          "name": "work-note",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "task:comment",
+      "id": "workflow:publish",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -6947,33 +8048,34 @@
       "relativePath": [
         "dist",
         "commands",
-        "task",
-        "comment.js"
+        "workflow",
+        "publish.js"
       ]
     },
-    "task:find": {
+    "xml:export": {
       "aliases": [],
       "args": {},
-      "description": "Find a ServiceNow task by its number.\n\nThis command looks up a task record by its number in the specified table. Returns the full task details including sys_id, description, state, and assignment information.\n\nFeatures:\n  - Look up any task by number\n  - Supports any task-based table\n  - JSON output for scripting and automation",
+      "description": "Export a single ServiceNow record as XML.\n\nDownloads the XML representation of a specific record from a ServiceNow table. Without --output, the XML is printed to stdout. With --output, the XML is written to the specified file path.\n\nFeatures:\n  • Export any record by table and sys_id\n  • Print XML to stdout for piping to other tools\n  • Save directly to a file with --output\n  • JSON output mode for CI/CD integration",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --auth dev",
-          "description": "Find an incident by number"
+          "description": "Export a record to stdout",
+          "command": "<%= config.bin %> <%= command.id %> --table sys_script_include --sys-id abc123def456 --auth dev"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -n CHG0010001 --table change_request --auth dev",
-          "description": "Find a change request by number"
+          "description": "Export and save to a file",
+          "command": "<%= config.bin %> <%= command.id %> --table incident --sys-id abc123 --output ./export.xml --auth dev"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 --json --auth dev",
-          "description": "Find an incident and output as JSON"
+          "description": "Export as JSON metadata",
+          "command": "<%= config.bin %> <%= command.id %> --table sys_script --sys-id abc123 --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -6994,6 +8096,23 @@
           "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",
@@ -7010,20 +8129,29 @@
           ],
           "type": "option"
         },
-        "number": {
-          "char": "n",
-          "description": "Task number (e.g., INC0010001, CHG0010001)",
-          "name": "number",
+        "table": {
+          "char": "t",
+          "description": "Table name of the record to export",
+          "name": "table",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "table": {
-          "description": "ServiceNow table name",
-          "name": "table",
+        "sys-id": {
+          "char": "s",
+          "description": "Sys ID of the record to export",
+          "name": "sys-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "File path to write the exported XML to. If omitted, XML is printed to stdout.",
+          "name": "output",
           "required": false,
-          "default": "task",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -7031,7 +8159,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "task:find",
+      "id": "xml:export",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -7041,29 +8169,30 @@
       "relativePath": [
         "dist",
         "commands",
-        "task",
-        "find.js"
+        "xml",
+        "export.js"
       ]
     },
-    "task:resolve": {
+    "xml:import": {
       "aliases": [],
       "args": {},
-      "description": "Resolve a ServiceNow incident with resolution notes.\n\nThis command resolves an incident identified by its number, setting the resolution notes and optionally a close code. The incident must be in a state that allows resolution.\n\nFeatures:\n  - Resolve incidents with resolution notes\n  - Optionally specify a close code\n  - Auto-resolves incident number to sys_id",
+      "description": "Import XML records into a ServiceNow instance.\n\nReads an XML file and imports its contents into the specified target table. The XML should be in ServiceNow unload format.\n\nFeatures:\n  • Import from local XML files\n  • Target a specific table\n  • JSON output mode for CI/CD integration",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --number INC0010001 --notes \"Issue resolved by restarting the service\" --auth dev",
-          "description": "Resolve an incident with resolution notes"
+          "description": "Import records from an XML file",
+          "command": "<%= config.bin %> <%= command.id %> --file ./export.xml --table sys_script_include --auth dev"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> -n INC0010001 --notes \"Fixed\" --close-code \"Solved (Permanently)\" --auth dev",
-          "description": "Resolve with a specific close code"
+          "description": "Import with JSON output",
+          "command": "<%= config.bin %> <%= command.id %> --file ./records.xml --table incident --json --auth dev"
         }
       ],
       "flags": {
         "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
+          "char": "j",
+          "description": "Output results as JSON",
           "name": "json",
+          "required": false,
           "allowNo": false,
           "type": "boolean"
         },
@@ -7084,6 +8213,23 @@
           "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",
@@ -7100,26 +8246,19 @@
           ],
           "type": "option"
         },
-        "close-code": {
-          "description": "Close code for the resolution",
-          "name": "close-code",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "notes": {
-          "description": "Resolution notes",
-          "name": "notes",
+        "file": {
+          "char": "f",
+          "description": "Path to the XML file to import",
+          "name": "file",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "number": {
-          "char": "n",
-          "description": "Incident number (e.g., INC0010001)",
-          "name": "number",
+        "table": {
+          "char": "t",
+          "description": "Target table to import records into",
+          "name": "table",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -7128,7 +8267,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "task:resolve",
+      "id": "xml:import",
       "pluginAlias": "@sonisoft/now-sdk-ext-cli",
       "pluginName": "@sonisoft/now-sdk-ext-cli",
       "pluginType": "core",
@@ -7138,10 +8277,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "task",
-        "resolve.js"
+        "xml",
+        "import.js"
       ]
     }
   },
-  "version": "5.0.0"
+  "version": "5.1.0"
 }