@jacebenson/jsn 0.0.9 → 0.1.0

package/src/commands/grouproles.js

@@ -1,4 +1,4 @@
-import { formatRecordForDisplay } from '../helpers.js';
+import { formatRecordForDisplay, getStringField } from '../helpers.js';
 
 export function groupRolesCmd(wrap) {
   return {
@@ -32,7 +32,120 @@ export function groupRolesCmd(wrap) {
             }, { summary: `${records.length} group role(s)` });
           }),
         })
+        .command({
+          command: 'add',
+          describe: 'Add a role to a group',
+          builder: (y) => y
+            .option('group', { alias: 'g', type: 'string', demandOption: true, describe: 'Group name or sys_id (required)' })
+            .option('role', { alias: 'r', type: 'string', demandOption: true, describe: 'Role name or sys_id (required)' }),
+          handler: wrap(async (argv, app) => {
+            const groupName = argv.group;
+            const roleName = argv.role;
+
+            // Resolve group sys_id
+            const isGroupSysID = groupName.length === 32 && /^[0-9a-fA-F]+$/.test(groupName);
+            const groupParams = new URLSearchParams();
+            groupParams.set('sysparm_query', isGroupSysID ? `sys_id=${groupName}` : `name=${groupName}`);
+            groupParams.set('sysparm_limit', '1');
+            groupParams.set('sysparm_fields', 'sys_id');
+            const groupRecords = await app.sdk.list('sys_user_group', groupParams);
+            if (groupRecords.length === 0) {
+              throw new Error(`Group not found: ${groupName}`);
+            }
+            const groupSysID = getStringField(groupRecords[0], 'sys_id');
+
+            // Resolve role sys_id
+            const isRoleSysID = roleName.length === 32 && /^[0-9a-fA-F]+$/.test(roleName);
+            const roleParams = new URLSearchParams();
+            roleParams.set('sysparm_query', isRoleSysID ? `sys_id=${roleName}` : `name=${roleName}`);
+            roleParams.set('sysparm_limit', '1');
+            roleParams.set('sysparm_fields', 'sys_id');
+            const roleRecords = await app.sdk.list('sys_user_role', roleParams);
+            if (roleRecords.length === 0) {
+              throw new Error(`Role not found: ${roleName}`);
+            }
+            const roleSysID = getStringField(roleRecords[0], 'sys_id');
+
+            // Check if role assignment already exists
+            const checkParams = new URLSearchParams();
+            checkParams.set('sysparm_query', `group=${groupSysID}^role=${roleSysID}`);
+            checkParams.set('sysparm_limit', '1');
+            checkParams.set('sysparm_fields', 'sys_id');
+            const existing = await app.sdk.list('sys_group_has_role', checkParams);
+            if (existing.length > 0) {
+              throw new Error(`Role ${roleName} is already assigned to group ${groupName}`);
+            }
+
+            // Create the role assignment
+            const record = await app.sdk.create('sys_group_has_role', {
+              group: groupSysID,
+              role: roleSysID,
+            });
+            app.ok(record, {
+              summary: `Added role ${roleName} to ${groupName}`,
+              breadcrumbs: [
+                { action: 'list', cmd: `jsn grouproles list --query "group.name=${groupName}"`, description: 'List group roles' },
+                { action: 'remove', cmd: `jsn grouproles remove --group "${groupName}" --role "${roleName}"`, description: 'Remove this role' },
+              ],
+            });
+          }),
+        })
+        .command({
+          command: 'remove',
+          describe: 'Remove a role from a group',
+          builder: (y) => y
+            .option('group', { alias: 'g', type: 'string', demandOption: true, describe: 'Group name or sys_id (required)' })
+            .option('role', { alias: 'r', type: 'string', demandOption: true, describe: 'Role name or sys_id (required)' }),
+          handler: wrap(async (argv, app) => {
+            const groupName = argv.group;
+            const roleName = argv.role;
 
+            // Resolve group sys_id
+            const isGroupSysID = groupName.length === 32 && /^[0-9a-fA-F]+$/.test(groupName);
+            const groupParams = new URLSearchParams();
+            groupParams.set('sysparm_query', isGroupSysID ? `sys_id=${groupName}` : `name=${groupName}`);
+            groupParams.set('sysparm_limit', '1');
+            groupParams.set('sysparm_fields', 'sys_id');
+            const groupRecords = await app.sdk.list('sys_user_group', groupParams);
+            if (groupRecords.length === 0) {
+              throw new Error(`Group not found: ${groupName}`);
+            }
+            const groupSysID = getStringField(groupRecords[0], 'sys_id');
+
+            // Resolve role sys_id
+            const isRoleSysID = roleName.length === 32 && /^[0-9a-fA-F]+$/.test(roleName);
+            const roleParams = new URLSearchParams();
+            roleParams.set('sysparm_query', isRoleSysID ? `sys_id=${roleName}` : `name=${roleName}`);
+            roleParams.set('sysparm_limit', '1');
+            roleParams.set('sysparm_fields', 'sys_id');
+            const roleRecords = await app.sdk.list('sys_user_role', roleParams);
+            if (roleRecords.length === 0) {
+              throw new Error(`Role not found: ${roleName}`);
+            }
+            const roleSysID = getStringField(roleRecords[0], 'sys_id');
+
+            // Find the role assignment record
+            const findParams = new URLSearchParams();
+            findParams.set('sysparm_query', `group=${groupSysID}^role=${roleSysID}`);
+            findParams.set('sysparm_limit', '1');
+            findParams.set('sysparm_fields', 'sys_id');
+            const assignmentRecords = await app.sdk.list('sys_group_has_role', findParams);
+            if (assignmentRecords.length === 0) {
+              throw new Error(`Role ${roleName} is not assigned to group ${groupName}`);
+            }
+            const assignmentSysID = getStringField(assignmentRecords[0], 'sys_id');
+
+            // Delete the role assignment
+            await app.sdk.delete('sys_group_has_role', assignmentSysID);
+            app.ok({ group: groupName, role: roleName }, {
+              summary: `Removed role ${roleName} from ${groupName}`,
+              breadcrumbs: [
+                { action: 'list', cmd: `jsn grouproles list --query "group.name=${groupName}"`, description: 'List group roles' },
+                { action: 'add', cmd: `jsn grouproles add --group "${groupName}" --role "${roleName}"`, description: 'Add role back to group' },
+              ],
+            });
+          }),
+        });
     },
     handler: () => {},
   };

package/src/commands/groups.js

@@ -1,10 +1,10 @@
-import { formatRecordForDisplay } from '../helpers.js';
+import { formatRecordForDisplay, getStringField, interactiveList } from '../helpers.js';
 
 export function groupsCmd(wrap) {
   return {
     command: 'groups [subcommand]',
     aliases: ['group'],
-    describe: 'Search and display groups',
+    describe: 'Manage ServiceNow groups',
     builder: (yargs) => {
       return yargs
         .command({
@@ -17,6 +17,17 @@ export function groupsCmd(wrap) {
             .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const columns = argv.columns ? argv.columns.split(',') : ['name', 'manager', 'email'];
+            const query = argv.query || '';
+
+            const picked = await interactiveList({
+              app, table: 'sys_user_group', singular: 'group', columns, limit: argv.limit, query, labelField: 'name',
+              formatLabel: r => `${getStringField(r, 'name')} ${getStringField(r, 'manager') ? '→ ' + getStringField(r, 'manager') : ''}`,
+            });
+            if (picked) {
+              picked._context = { instance_url: app.getEffectiveInstance(), table: 'sys_user_group' };
+              return app.ok(picked, { summary: `Group: ${getStringField(picked, 'name')}` });
+            }
+
             const params = new URLSearchParams();
             params.set('sysparm_limit', String(argv.limit));
             params.set('sysparm_display_value', 'all');
@@ -50,7 +61,80 @@ export function groupsCmd(wrap) {
             app.ok(records[0], { summary: `Group ${id}` });
           }),
         })
-
+        .command({
+          command: 'create',
+          describe: 'Create a new group',
+          builder: (y) => y
+            .option('name', { alias: 'n', type: 'string', describe: 'Group name' })
+            .option('manager', { type: 'string', describe: 'Manager name or sys_id' })
+            .option('data', { type: 'string', describe: 'JSON data for additional fields' }),
+          handler: wrap(async (argv, app) => {
+            const recordData = {};
+            if (argv.data) {
+              Object.assign(recordData, JSON.parse(argv.data));
+            }
+            if (argv.name) recordData.name = argv.name;
+            if (argv.manager) recordData.manager = argv.manager;
+            if (!recordData.name) {
+              throw new Error('name is required (use --name or --data)');
+            }
+            const record = await app.sdk.create('sys_user_group', recordData);
+            app.ok(record, {
+              summary: `Created group ${getStringField(record, 'name')}`,
+              breadcrumbs: [
+                { action: 'view', cmd: `jsn groups show ${getStringField(record, 'name')}`, description: `View the new group` },
+              ],
+            });
+          }),
+        })
+        .command({
+          command: 'update <name>',
+          describe: 'Update a group by name or sys_id',
+          builder: (y) => y
+            .option('data', { type: 'string', demandOption: true, describe: 'JSON data to update' }),
+          handler: wrap(async (argv, app) => {
+            const id = argv.name;
+            const recordData = JSON.parse(argv.data);
+            const isSysID = id.length === 32 && /^[0-9a-fA-F]+$/.test(id);
+            const params = new URLSearchParams();
+            params.set('sysparm_query', isSysID ? `sys_id=${id}` : `name=${id}`);
+            params.set('sysparm_limit', '1');
+            params.set('sysparm_fields', 'sys_id');
+            const records = await app.sdk.list('sys_user_group', params);
+            if (records.length === 0) {
+              throw new Error(`Group not found: ${id}`);
+            }
+            const sysID = getStringField(records[0], 'sys_id');
+            const updated = await app.sdk.update('sys_user_group', sysID, recordData);
+            app.ok(updated, {
+              summary: `Updated group ${id}`,
+              breadcrumbs: [
+                { action: 'view', cmd: `jsn groups show ${id}`, description: `View the updated group` },
+              ],
+            });
+          }),
+        })
+        .command({
+          command: 'delete <name>',
+          describe: 'Delete a group by name or sys_id',
+          handler: wrap(async (argv, app) => {
+            const id = argv.name;
+            const isSysID = id.length === 32 && /^[0-9a-fA-F]+$/.test(id);
+            const params = new URLSearchParams();
+            params.set('sysparm_query', isSysID ? `sys_id=${id}` : `name=${id}`);
+            params.set('sysparm_limit', '1');
+            params.set('sysparm_fields', 'sys_id');
+            const records = await app.sdk.list('sys_user_group', params);
+            if (records.length === 0) {
+              throw new Error(`Group not found: ${id}`);
+            }
+            const sysID = getStringField(records[0], 'sys_id');
+            await app.sdk.delete('sys_user_group', sysID);
+            app.ok({ identifier: id, message: 'Group deleted' }, {
+              summary: `Deleted group ${id}`,
+            });
+          }),
+        });
     },
     handler: () => {},
   };

package/src/commands/profiles.js

@@ -2,7 +2,7 @@ import { saveConfig } from '../config.js';
 
 export function profilesCmd(wrap) {
   return {
-    command: 'profiles <subcommand>',
+    command: 'profiles [subcommand]',
     aliases: ['profile'],
     describe: 'Manage configuration profiles',
     builder: (yargs) => {
@@ -74,6 +74,18 @@ export function profilesCmd(wrap) {
         })
 
     },
-    handler: () => {},
+    handler: (argv) => {
+      // When no subcommand is given, show help
+      if (!argv._[1]) {
+        console.log('Manage your ServiceNow instance profiles.\n');
+        console.log('Usage: jsn profiles <list|show|use|remove> [options]\n');
+        console.log('Commands:');
+        console.log('  list           List all profiles');
+        console.log('  show [name]    Show profile details');
+        console.log('  use  <name>    Switch to a different profile');
+        console.log('  remove <name>  Remove a profile');
+        console.log('\nRun "jsn profiles <command> --help" for more details.');
+      }
+    },
   };
 }

package/src/commands/records.js

@@ -1,4 +1,4 @@
-import { formatRecordForDisplay, buildQuerySuffix } from '../helpers.js';
+import { formatRecordForDisplay, buildQuerySuffix, parseDataArg, getStringField, interactiveList } from '../helpers.js';
 
 const tableDefaultColumns = {
   incident: ['number', 'short_description', 'priority', 'state', 'assigned_to'],
@@ -22,7 +22,7 @@ function getDefaultColumns(table) {
 export function recordsCmd(wrap) {
   return {
     command: 'records <subcommand>',
-    describe: 'Query and manage records in any table',
+    describe: 'Query and manage records in any table (e.g. "records list --table incident --query priority=1")',
     builder: (yargs) => {
       return yargs
         .command({
@@ -37,6 +37,22 @@ export function recordsCmd(wrap) {
           handler: wrap(async (argv, app) => {
             const table = argv.table;
             const columns = argv.columns ? argv.columns.split(',') : getDefaultColumns(table);
+            const query = argv.query || '';
+
+            // Interactive picker
+            const picked = await interactiveList({
+              app, table, singular: 'record', columns, limit: argv.limit, query, labelField: 'sys_id',
+              formatLabel: r => {
+                const cols = getDefaultColumns(table);
+                return cols.map(c => `${c}: ${getStringField(r, c) || '-'}`).join(' | ');
+              },
+            });
+            if (picked) {
+              picked._context = { instance_url: app.getEffectiveInstance(), table };
+              return app.ok(picked, { summary: `Record from ${table}` });
+            }
+
+            // Text/table fallback
             const params = new URLSearchParams();
             params.set('sysparm_limit', String(argv.limit));
             params.set('sysparm_offset', String(argv.offset));
@@ -99,9 +115,10 @@ export function recordsCmd(wrap) {
           describe: 'Create a new record',
           builder: (y) => y
             .option('table', { type: 'string', demandOption: true, describe: 'Table name' })
-            .option('data', { type: 'string', demandOption: true, describe: 'JSON fields (e.g. \'{"state":"2"}\')' }),
+            .option('data', { type: 'string', describe: 'JSON fields (e.g. \'{"state":"2"}\')' })
+            .option('data-file', { type: 'string', describe: 'Read JSON payload from file' }),
           handler: wrap(async (argv, app) => {
-            const recordData = JSON.parse(argv.data);
+            const recordData = parseDataArg(argv);
             const record = await app.sdk.create(argv.table, recordData);
             app.ok(record, { summary: `Created record in ${argv.table}` });
           }),
@@ -112,9 +129,10 @@ export function recordsCmd(wrap) {
           builder: (y) => y
             .option('table', { type: 'string', demandOption: true, describe: 'Table name' })
             .option('sys-id', { type: 'string', demandOption: true, describe: 'Record sys_id' })
-            .option('data', { type: 'string', demandOption: true, describe: 'JSON fields (e.g. \'{"state":"2"}\')' }),
+            .option('data', { type: 'string', describe: 'JSON fields (e.g. \'{"state":"2"}\')' })
+            .option('data-file', { type: 'string', describe: 'Read JSON payload from file' }),
           handler: wrap(async (argv, app) => {
-            const recordData = JSON.parse(argv.data);
+            const recordData = parseDataArg(argv);
             const record = await app.sdk.update(argv.table, argv['sys-id'], recordData);
             app.ok(record, { summary: `Updated record in ${argv.table}` });
           }),

package/src/commands/requests.js

@@ -1,7 +1,59 @@
 import { buildTicketCommands } from './_ticket.js';
+import { getStringField } from '../helpers.js';
 
 const requestDefaultColumns = ['number', 'short_description', 'stage', 'assigned_to'];
 
 export function requestsCmd(wrap) {
-  return buildTicketCommands('sc_req_item', 'requests', 'req', requestDefaultColumns, {}, null, wrap);
+  // Get the base command definition from the shared ticket builder
+  const baseCmd = buildTicketCommands('sc_req_item', 'requests', 'req', requestDefaultColumns, {}, null, wrap);
+
+  // Override the builder to inject our enriched show handler.
+  // yargs allows re-registration — the last .command() call wins the slot.
+  const originalBuilder = baseCmd.builder;
+  baseCmd.builder = (yargs) => {
+    const y = originalBuilder(yargs);
+    return y.command({
+      command: 'show <number>',
+      aliases: ['get'],
+      describe: 'Show a specific request with attachments and catalog variables',
+      handler: wrap(enrichedShowHandler),
+    });
+  };
+
+  return baseCmd;
+}
+
+async function enrichedShowHandler(argv, app) {
+  const number = argv.number;
+  const params = new URLSearchParams();
+  params.set('sysparm_query', `number=${number}`);
+  params.set('sysparm_display_value', 'all');
+  params.set('sysparm_limit', '1');
+  const records = await app.sdk.list('sc_req_item', params);
+  if (records.length === 0) {
+    throw new Error(`Request not found: ${number}`);
+  }
+  const record = records[0];
+  const sysID = getStringField(record, 'sys_id');
+
+  // Fetch attachments and catalog variables in parallel
+  const [attachments, variables] = await Promise.all([
+    app.sdk.fetchAttachments('sc_req_item', sysID).catch(() => []),
+    app.sdk.fetchCatalogVariables(sysID).catch(() => []),
+  ]);
+
+  record._attachments = attachments;
+  record._variables = variables;
+  record._context = {
+    instance_url: app.getEffectiveInstance(),
+    table: 'sc_req_item',
+  };
+
+  app.ok(record, {
+    summary: `Request ${number}`,
+    breadcrumbs: [
+      { action: 'update', cmd: `jsn req update ${number} --data '{...}'`, description: 'Update this request' },
+      { action: 'list', cmd: `jsn req list`, description: 'Back to all requests' },
+    ],
+  });
 }

package/src/commands/skill.js

@@ -0,0 +1,109 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const SKILL_REPO_PATH = path.join(
+  path.dirname(fileURLToPath(import.meta.url)),
+  '..', '..', 'skills', 'servicenow', 'SKILL.md'
+);
+
+const SKILL_RAW_URL = 'https://raw.githubusercontent.com/jacebenson/jsn/nodejs/skills/servicenow/SKILL.md';
+
+function readBundledSkill() {
+  try {
+    return fs.readFileSync(SKILL_REPO_PATH, 'utf-8');
+  } catch {
+    return null;
+  }
+}
+
+export function skillCmd(wrap) {
+  return {
+    command: 'skill',
+    describe: 'Manage the jsn AI agent skill file (for Hermes, Claude Code, Cursor, etc.)',
+    builder: (y) => {
+      return y
+        .command({
+          command: 'show',
+          describe: 'Show the bundled skill file content',
+          handler: wrap(async (_argv, app) => {
+            const content = readBundledSkill();
+            if (!content) {
+              throw new Error('Skill file not found in package (expected at skills/servicenow/SKILL.md)');
+            }
+            app.ok({
+              content,
+              bundled: SKILL_REPO_PATH,
+            }, {
+              summary: 'jsn AI agent skill file (bundled)',
+            });
+          }),
+        })
+        .command({
+          command: 'fetch',
+          describe: 'Download the latest skill file from GitHub to stdout',
+          handler: wrap(async (_argv, _app) => {
+            const res = await fetch(SKILL_RAW_URL);
+            if (!res.ok) throw new Error(`Failed to fetch skill: ${res.status} ${res.statusText}`);
+            const content = await res.text();
+            // Print raw content to stdout for pipe/save usage
+            process.stdout.write(content);
+          }),
+        })
+        .command({
+          command: 'path',
+          describe: 'Show skill file locations and install targets',
+          handler: wrap(async (_argv, app) => {
+            const hermesDir = path.join(os.homedir(), '.hermes', 'skills', 'servicenow');
+            const hermesPath = path.join(hermesDir, 'SKILL.md');
+            app.ok({
+              bundled: SKILL_REPO_PATH,
+              hermes: hermesPath,
+              raw_url: SKILL_RAW_URL,
+            }, {
+              summary: 'Skill file locations',
+              breadcrumbs: [
+                { action: 'view', cmd: 'jsn skill show', description: 'Show bundled skill content' },
+                { action: 'fetch', cmd: 'jsn skill fetch', description: 'Download latest from GitHub' },
+                { action: 'install', cmd: 'jsn skill install', description: 'Download + save to Hermes' },
+              ],
+            });
+          }),
+        })
+        .command({
+          command: 'install [dir]',
+          describe: 'Download and save the latest skill file',
+          builder: (y) => y
+            .positional('dir', {
+              type: 'string',
+              describe: 'Target directory (default: ~/.hermes/skills/servicenow/)',
+            }),
+          handler: wrap(async (argv, app) => {
+            const targetDir = argv.dir || path.join(os.homedir(), '.hermes', 'skills', 'servicenow');
+            const targetPath = path.join(targetDir, 'SKILL.md');
+
+            fs.mkdirSync(targetDir, { recursive: true });
+
+            const res = await fetch(SKILL_RAW_URL);
+            if (!res.ok) throw new Error(`Failed to fetch skill: ${res.status} ${res.statusText}`);
+            const content = await res.text();
+
+            fs.writeFileSync(targetPath, content, 'utf-8');
+
+            app.ok({
+              installed: targetPath,
+              from: SKILL_RAW_URL,
+            }, {
+              summary: `Skill installed to ${targetPath}`,
+              breadcrumbs: [
+                { action: 'verify', cmd: `head -30 ${targetPath}`, description: 'Verify the installed skill' },
+                { action: 'reinstall', cmd: 'jsn skill install', description: 'Re-download and reinstall' },
+              ],
+            });
+          }),
+        });
+    },
+    handler: () => {}, // Handled by subcommands
+  };
+}

package/src/commands/tickets.js

@@ -4,7 +4,7 @@ export function ticketsCmd(wrap) {
   return {
     command: 'tickets [subcommand]',
     aliases: ['ticket'],
-    describe: 'Query generic tickets',
+    describe: 'Query generic tickets (e.g. "tickets list --query active=true")',
     builder: (yargs) => {
       return yargs
         .command({

package/src/commands/users.js

@@ -1,10 +1,10 @@
-import { formatRecordForDisplay } from '../helpers.js';
+import { formatRecordForDisplay, getStringField, interactiveList } from '../helpers.js';
 
 export function usersCmd(wrap) {
   return {
     command: 'users [subcommand]',
     aliases: ['user'],
-    describe: 'Search and display users',
+    describe: 'Manage ServiceNow users',
     builder: (yargs) => {
       return yargs
         .command({
@@ -17,6 +17,17 @@ export function usersCmd(wrap) {
             .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const columns = argv.columns ? argv.columns.split(',') : ['user_name', 'name', 'email', 'active'];
+            const query = argv.query || '';
+
+            const picked = await interactiveList({
+              app, table: 'sys_user', singular: 'user', columns, limit: argv.limit, query, labelField: 'user_name',
+              formatLabel: r => `${getStringField(r, 'user_name')} (${getStringField(r, 'name') || '-'})`,
+            });
+            if (picked) {
+              picked._context = { instance_url: app.getEffectiveInstance(), table: 'sys_user' };
+              return app.ok(picked, { summary: `User: ${getStringField(picked, 'user_name')}` });
+            }
+
             const params = new URLSearchParams();
             params.set('sysparm_limit', String(argv.limit));
             params.set('sysparm_display_value', 'all');
@@ -50,7 +61,83 @@ export function usersCmd(wrap) {
             app.ok(records[0], { summary: `User ${id}` });
           }),
         })
-
+        .command({
+          command: 'create',
+          describe: 'Create a new user',
+          builder: (y) => y
+            .option('username', { alias: 'u', type: 'string', describe: 'Username (e.g. john.doe)' })
+            .option('name', { alias: 'n', type: 'string', describe: 'Full name (e.g. John Doe)' })
+            .option('email', { alias: 'e', type: 'string', describe: 'Email address' })
+            .option('data', { type: 'string', describe: 'JSON data for additional fields' }),
+          handler: wrap(async (argv, app) => {
+            const recordData = {};
+            if (argv.data) {
+              Object.assign(recordData, JSON.parse(argv.data));
+            }
+            if (argv.username) recordData.user_name = argv.username;
+            if (argv.name) recordData.name = argv.name;
+            if (argv.email) recordData.email = argv.email;
+            if (!recordData.user_name) {
+              throw new Error('user_name is required (use --username or --data)');
+            }
+            const record = await app.sdk.create('sys_user', recordData);
+            app.ok(record, {
+              summary: `Created user ${getStringField(record, 'user_name')}`,
+              breadcrumbs: [
+                { action: 'view', cmd: `jsn users show ${getStringField(record, 'user_name')}`, description: `View the new user` },
+              ],
+            });
+          }),
+        })
+        .command({
+          command: 'update <identifier>',
+          describe: 'Update a user by user_name or sys_id',
+          builder: (y) => y
+            .option('data', { type: 'string', demandOption: true, describe: 'JSON data to update' }),
+          handler: wrap(async (argv, app) => {
+            const id = argv.identifier;
+            const recordData = JSON.parse(argv.data);
+            const isSysID = id.length === 32 && /^[0-9a-fA-F]+$/.test(id);
+            const params = new URLSearchParams();
+            params.set('sysparm_query', isSysID ? `sys_id=${id}` : `user_name=${id}`);
+            params.set('sysparm_limit', '1');
+            params.set('sysparm_display_value', 'all');
+            params.set('sysparm_fields', 'sys_id');
+            const records = await app.sdk.list('sys_user', params);
+            if (records.length === 0) {
+              throw new Error(`User not found: ${id}`);
+            }
+            const sysID = getStringField(records[0], 'sys_id');
+            const updated = await app.sdk.update('sys_user', sysID, recordData);
+            app.ok(updated, {
+              summary: `Updated user ${id}`,
+              breadcrumbs: [
+                { action: 'view', cmd: `jsn users show ${id}`, description: `View the updated user` },
+              ],
+            });
+          }),
+        })
+        .command({
+          command: 'delete <identifier>',
+          describe: 'Delete a user by user_name or sys_id',
+          handler: wrap(async (argv, app) => {
+            const id = argv.identifier;
+            const isSysID = id.length === 32 && /^[0-9a-fA-F]+$/.test(id);
+            const params = new URLSearchParams();
+            params.set('sysparm_query', isSysID ? `sys_id=${id}` : `user_name=${id}`);
+            params.set('sysparm_limit', '1');
+            params.set('sysparm_fields', 'sys_id');
+            const records = await app.sdk.list('sys_user', params);
+            if (records.length === 0) {
+              throw new Error(`User not found: ${id}`);
+            }
+            const sysID = getStringField(records[0], 'sys_id');
+            await app.sdk.delete('sys_user', sysID);
+            app.ok({ identifier: id, message: 'User deleted' }, {
+              summary: `Deleted user ${id}`,
+            });
+          }),
+        });
     },
     handler: () => {},
   };