@jacebenson/jsn 3.0.0 → 3.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jacebenson/jsn",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "A command-line interface for ServiceNow that follows the Unix philosophy: simple, composable, and scriptable.",
   "type": "module",
   "bin": {

package/src/app.js

@@ -7,6 +7,7 @@ import { getEffectiveInstance } from './config.js';
 import { extractProfileName } from './helpers.js';
 import { getCurrentUser, getCurrentApplication, getCurrentUpdateSet } from './context.js';
 import { errUsage, errAuth } from './errors.js';
+import { isMutationCommand } from './mutations.js';
 import process from 'node:process';
 
 
@@ -57,7 +58,7 @@ export class App {
     return getEffectiveInstance(this.config);
   }
 
-  async printContextHeader() {
+  async printContextHeader(argv = {}) {
     if (!this.getEffectiveInstance() || !this.sdk) return;
     if (process.env.JSN_NO_HEADER) return;
     if (this.output.getFormat() === FormatJSON || this.output.getFormat() === FormatQuiet) return;
@@ -127,8 +128,10 @@ export class App {
 
     process.stderr.write(`${profileStr} ${userStr} ${scopeStr} ${updateSetStr}\n\n`);
 
-    // ⚠️  Warning if in the Default update set
-    if (updateSet && updateSet.toLowerCase().includes('default')) {
+    // ⚠️  Warning if in the Default update set (mutation commands only)
+    const profile = this.context.profileName ? this.config.profiles[this.context.profileName] : null;
+    const isYolo = profile?.yolo === true;
+    if (!isYolo && isMutationCommand(argv) && updateSet && updateSet.toLowerCase().includes('default')) {
       const isGlobal = scope === 'global';
       if (isGlobal) {
         // 🔴 HARD WARNING — Global + Default
@@ -146,7 +149,7 @@ export class App {
           '┃  Or switch to a scoped scope first:                    ┃\n' +
           '┃    jsn dev scopes list                                 ┃\n' +
           '┃                                                        ┃\n' +
-          '┃  (Run jsn updatesets yolo to silence this check)       ┃\n' +
+          '┃  (Run jsn dev updatesets yolo to silence this check)    ┃\n' +
           '┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛\x1b[0m\n'
         );
       } else {
@@ -157,7 +160,7 @@ export class App {
           '  ⚠  Default update set in scope [' + scope + ']\n' +
           '  Changes are contained to this scope, but a named\n' +
           '  update set is still recommended for tracking.\n' +
-          '  (Run \x1b[1mjsn updatesets yolo\x1b[22m to silence this warning)\n' +
+          '  (Run \x1b[1mjsn dev updatesets yolo\x1b[22m to silence this warning)\n' +
           '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n' +
           '\x1b[0m' // reset
         );

package/src/cli.js

@@ -156,7 +156,7 @@ export const cli = yargs(hideBin(process.argv))
 
     // Print context header for interactive terminals (at the TOP, before command output)
     if (!['help', 'version', 'completion', 'skill'].includes(cmd)) {
-      await argv.app.printContextHeader();
+      await argv.app.printContextHeader(argv);
     }
   })
   .command(setupCmd(wrap))
@@ -185,6 +185,25 @@ export const cli = yargs(hideBin(process.argv))
     if (err) throw err;
     // No command given → show custom grouped help instead of yargs error
     if (msg === 'You must specify a command') {
+      // Check if --profile/-p was used without a value — show profile info instead
+      const raw = process.argv.slice(2);
+      const hasLoneProfile = raw.some((a, i, arr) => {
+        if (a !== '--profile' && a !== '-p') return false;
+        const next = arr[i + 1];
+        return !next || next.startsWith('-');
+      });
+      if (hasLoneProfile) {
+        const cfg = loadConfig();
+        const activeName = cfg.activeProfile || cfg.defaultProfile;
+        process.stdout.write('Profiles:\n');
+        for (const [name, p] of Object.entries(cfg.profiles || {})) {
+          const marker = name === activeName ? ' *' : '  ';
+          process.stdout.write(`  ${marker} ${name.padEnd(20)} ${p.instance_url || ''}\n`);
+        }
+        process.stdout.write('\nUsage: jsn --profile <name> <command>\n');
+        process.stdout.write('       jsn profiles use <name>\n');
+        process.exit(0);
+      }
       process.stdout.write(renderHelp());
       process.exit(0);
     }

package/src/commands/_ticket.js

@@ -1,7 +1,7 @@
 // Generic command builder for CRUD operations on a ServiceNow table
 // Used by incidents, changes, requests, tasks, and most dev subcommands
 
-import { getStringField, formatRecordForDisplay, buildQuerySuffix } from '../helpers.js';
+import { getStringField, formatRecordForDisplay, buildQuerySuffix, resolveFieldsParam } from '../helpers.js';
 import search from '@inquirer/search';
 import { isTTY, FormatAuto } from '../output.js';
 
@@ -114,13 +114,13 @@ export function buildTicketCommands(table, displayName, alias, defaultColumns, s
             params.set('sysparm_limit', String(limit));
             params.set('sysparm_offset', String(offset));
             params.set('sysparm_display_value', 'all');
-            const fetchColumns = ['sys_id', ...columns];
-            params.set('sysparm_fields', fetchColumns.join(','));
+            const fields = resolveFieldsParam(columns);
+            if (fields) params.set('sysparm_fields', fields);
             const q = query ? query + '^ORDERBYDESCsys_updated_on' : 'ORDERBYDESCsys_updated_on';
             params.set('sysparm_query', q);
 
             const records = await app.sdk.list(table, params);
-            const displayRecords = records.map(r => formatRecordForDisplay(r, columns));
+            const displayRecords = fields ? records.map(r => formatRecordForDisplay(r, columns)) : records;
 
             const breadcrumbs = [
               { action: 'create', cmd: `jsn ${alias} create --description "..."`, description: `Create a new ${displayName}` },

package/src/commands/dev/eval.js

@@ -6,8 +6,8 @@ export function evalCmd(wrap) {
     describe: 'Execute background scripts on the instance',
     builder: (yargs) => {
       return yargs
-        .option('script', { alias: 's', type: 'string', describe: 'JavaScript code to execute' })
-        .option('file', { alias: 'f', type: 'string', describe: 'Read script from file' });
+        .option('script', { alias: 's', type: 'string', describe: "JavaScript code to execute (single-quote the script, double quotes inside: --script 'gs.log(\"Hello\")')" })
+        .option('file', { alias: 'f', type: 'string', describe: 'Read script from file (avoids shell quoting issues)' });
     },
     handler: wrap(async (argv, app) => {
       let script;

package/src/commands/dev/forms.js

@@ -54,6 +54,10 @@ export function formsCmd(wrap) {
           aliases: ['ls'],
           describe: 'List form views for a table',
           builder: (y) => y
+            .positional('table', {
+              describe: 'Table name (e.g. incident, change_request)',
+              type: 'string',
+            })
             .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const table = argv.table;

package/src/commands/dev/lists.js

@@ -45,6 +45,10 @@ export function listsCmd(wrap) {
           aliases: ['ls'],
           describe: 'List list views for a table',
           builder: (y) => y
+            .positional('table', {
+              describe: 'Table name (e.g. incident, change_request)',
+              type: 'string',
+            })
             .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const table = argv.table;

package/src/commands/dev/scopes.js

@@ -47,14 +47,24 @@ export function scopesCmd(wrap) {
         .command({
           command: 'show <scope>',
           aliases: ['get'],
-          describe: 'Show a scope',
+          describe: 'Show a scope by scope value or name',
+          builder: (y) => y
+            .positional('scope', {
+              describe: 'Scope value (e.g. x_417611_daves_o_0) or display name',
+              type: 'string',
+            }),
           handler: wrap(async (argv, app) => {
-            const params = new URLSearchParams();
-            params.set('sysparm_query', `scope=${argv.scope}`);
-            params.set('sysparm_limit', '1');
-            params.set('sysparm_display_value', 'all');
-            const records = await app.sdk.list('sys_scope', params);
-            if (records.length === 0) {
+            let records;
+            // Try by scope value first, then by name
+            for (const queryField of ['scope', 'name']) {
+              const params = new URLSearchParams();
+              params.set('sysparm_query', `${queryField}=${argv.scope}`);
+              params.set('sysparm_limit', '1');
+              params.set('sysparm_display_value', 'all');
+              records = await app.sdk.list('sys_scope', params);
+              if (records.length > 0) break;
+            }
+            if (!records || records.length === 0) {
               throw new Error(`Scope not found: ${argv.scope}`);
             }
             app.ok(records[0], { summary: `Scope ${argv.scope}` });

package/src/commands/dev/updatesets.js

@@ -162,6 +162,21 @@ export function updateSetsCmd(wrap) {
             });
           }),
         })
+        .command({
+          command: 'yolo',
+          aliases: ['silence'],
+          describe: 'Silence the "Default update set" warning for this profile',
+          handler: wrap(async (argv, app) => {
+            const name = app.context.profileName;
+            if (!name) {
+              throw new Error('No active profile to mark as yolo. Run jsn setup first.');
+            }
+            app.config.profiles[name].yolo = true;
+            const { saveConfig } = await import('../../config.js');
+            saveConfig(app.config);
+            app.ok({ profile: name, yolo: true }, { summary: 'Default update set warning silenced for this profile' });
+          }),
+        })
 
     },
     handler: (argv) => {

package/src/commands/groupmembers.js

@@ -1,4 +1,4 @@
-import { formatRecordForDisplay, getStringField } from '../helpers.js';
+import { formatRecordForDisplay, getStringField, resolveFieldsParam } from '../helpers.js';
 
 export function groupMembersCmd(wrap) {
   return {
@@ -20,14 +20,15 @@ export function groupMembersCmd(wrap) {
             const params = new URLSearchParams();
             params.set('sysparm_limit', String(argv.limit));
             params.set('sysparm_display_value', 'all');
-            params.set('sysparm_fields', ['sys_id', ...columns].join(','));
+            const fields = resolveFieldsParam(columns);
+            if (fields) params.set('sysparm_fields', fields);
             if (argv.query) params.set('sysparm_query', argv.query);
             const records = await app.sdk.list('sys_user_grmember', params);
             app.ok({
               table: 'sys_user_grmember',
               count: records.length,
               columns,
-              records: records.map(r => formatRecordForDisplay(r, columns)),
+              records: fields ? records.map(r => formatRecordForDisplay(r, columns)) : records,
               context: { instance_url: app.getEffectiveInstance() },
             }, { summary: `${records.length} group member(s)` });
           }),

package/src/commands/grouproles.js

@@ -1,4 +1,4 @@
-import { formatRecordForDisplay, getStringField } from '../helpers.js';
+import { formatRecordForDisplay, getStringField, resolveFieldsParam } from '../helpers.js';
 
 export function groupRolesCmd(wrap) {
   return {
@@ -20,14 +20,15 @@ export function groupRolesCmd(wrap) {
             const params = new URLSearchParams();
             params.set('sysparm_limit', String(argv.limit));
             params.set('sysparm_display_value', 'all');
-            params.set('sysparm_fields', ['sys_id', ...columns].join(','));
+            const fields = resolveFieldsParam(columns);
+            if (fields) params.set('sysparm_fields', fields);
             if (argv.query) params.set('sysparm_query', argv.query);
             const records = await app.sdk.list('sys_group_has_role', params);
             app.ok({
               table: 'sys_group_has_role',
               count: records.length,
               columns,
-              records: records.map(r => formatRecordForDisplay(r, columns)),
+              records: fields ? records.map(r => formatRecordForDisplay(r, columns)) : records,
               context: { instance_url: app.getEffectiveInstance() },
             }, { summary: `${records.length} group role(s)` });
           }),

package/src/commands/groups.js

@@ -1,4 +1,4 @@
-import { formatRecordForDisplay, getStringField, interactiveList } from '../helpers.js';
+import { formatRecordForDisplay, getStringField, interactiveList, resolveFieldsParam } from '../helpers.js';
 
 export function groupsCmd(wrap) {
   return {
@@ -31,14 +31,15 @@ export function groupsCmd(wrap) {
             const params = new URLSearchParams();
             params.set('sysparm_limit', String(argv.limit));
             params.set('sysparm_display_value', 'all');
-            params.set('sysparm_fields', ['sys_id', ...columns].join(','));
+            const fields = resolveFieldsParam(columns);
+            if (fields) params.set('sysparm_fields', fields);
             if (argv.query) params.set('sysparm_query', argv.query);
             const records = await app.sdk.list('sys_user_group', params);
             app.ok({
               table: 'sys_user_group',
               count: records.length,
               columns,
-              records: records.map(r => formatRecordForDisplay(r, columns)),
+              records: fields ? records.map(r => formatRecordForDisplay(r, columns)) : records,
               context: { instance_url: app.getEffectiveInstance() },
             }, { summary: `${records.length} group(s)` });
           }),

package/src/commands/profiles.js

@@ -181,6 +181,9 @@ export function profilesCmd(wrap) {
         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.');
+        console.log('\nNote: You can also create a profile by authenticating:');
+        console.log('  jsn auth login --profile <name> <instance-url>');
+        console.log('  jsn auth login --profile staging --password https://dev12345.service-now.com');
       }
     },
   };

package/src/commands/records.js

@@ -1,4 +1,4 @@
-import { formatRecordForDisplay, buildQuerySuffix, parseDataArg, getStringField, interactiveList } from '../helpers.js';
+import { formatRecordForDisplay, buildQuerySuffix, parseDataArg, getStringField, interactiveList, resolveFieldsParam } from '../helpers.js';
 
 const tableDefaultColumns = {
   incident: ['number', 'short_description', 'priority', 'state', 'assigned_to'],
@@ -66,10 +66,11 @@ export function recordsCmd(wrap) {
             params.set('sysparm_limit', argv['sys-id'] ? '1' : String(argv.limit));
             params.set('sysparm_offset', String(argv.offset));
             params.set('sysparm_display_value', 'all');
-            params.set('sysparm_fields', ['sys_id', ...columns].join(','));
+            const fields = resolveFieldsParam(columns);
+            if (fields) params.set('sysparm_fields', fields);
             if (query) params.set('sysparm_query', query);
             const records = await app.sdk.list(table, params);
-            const displayRecords = records.map(r => formatRecordForDisplay(r, columns));
+            const displayRecords = fields ? records.map(r => formatRecordForDisplay(r, columns)) : records;
             const breadcrumbs = [
               { action: 'create', cmd: `jsn records create --table ${table} --data '{...}'`, description: 'Create a new record' },
               { action: 'filter', cmd: `jsn records list --table ${table} --query "priority=1"`, description: 'Filter: priority 1 only' },
@@ -118,7 +119,7 @@ export function recordsCmd(wrap) {
             params.set('sysparm_query', `sys_id=${argv['sys-id']}`);
             params.set('sysparm_limit', '1');
             params.set('sysparm_display_value', 'true');
-            if (argv.columns) params.set('sysparm_fields', argv.columns);
+            if (argv.columns && argv.columns !== '*') params.set('sysparm_fields', argv.columns);
             const records = await app.sdk.list(argv.table, params);
             if (records.length === 0) {
               throw new Error(`Record not found: ${argv['sys-id']}`);

package/src/commands/tickets.js

@@ -1,4 +1,4 @@
-import { formatRecordForDisplay, getStringField, buildQuerySuffix } from '../helpers.js';
+import { formatRecordForDisplay, getStringField, buildQuerySuffix, resolveFieldsParam } from '../helpers.js';
 
 export function ticketsCmd(wrap) {
   return {
@@ -22,11 +22,12 @@ export function ticketsCmd(wrap) {
             params.set('sysparm_limit', String(argv.limit));
             params.set('sysparm_offset', String(argv.offset));
             params.set('sysparm_display_value', 'all');
-            params.set('sysparm_fields', ['sys_id', ...columns].join(','));
+            const fields = resolveFieldsParam(columns);
+            if (fields) params.set('sysparm_fields', fields);
             const q = argv.query ? argv.query + '^ORDERBYDESCsys_updated_on' : 'ORDERBYDESCsys_updated_on';
             params.set('sysparm_query', q);
-            const records = await app.sdk.list('ticket', params);
-            const displayRecords = records.map(r => formatRecordForDisplay(r, columns));
+            const records = await app.sdk.list('task', params);
+            const displayRecords = fields ? records.map(r => formatRecordForDisplay(r, columns)) : records;
             const breadcrumbs = [
               { action: 'create', cmd: 'jsn tickets create --data \'{...}\'', description: 'Create a new ticket' },
             ];
@@ -45,7 +46,7 @@ export function ticketsCmd(wrap) {
               });
             }
             app.ok({
-              table: 'ticket',
+              table: 'task',
               count: records.length,
               columns,
               records: displayRecords,
@@ -63,7 +64,7 @@ export function ticketsCmd(wrap) {
             params.set('sysparm_query', `number=${argv.number}`);
             params.set('sysparm_limit', '1');
             params.set('sysparm_display_value', 'all');
-            const records = await app.sdk.list('ticket', params);
+            const records = await app.sdk.list('task', params);
             if (records.length === 0) {
               throw new Error(`Ticket not found: ${argv.number}`);
             }
@@ -76,7 +77,7 @@ export function ticketsCmd(wrap) {
           builder: (y) => y.option('data', { type: 'string', demandOption: true, describe: 'JSON fields (e.g. \'{"state":"2","priority":"1"}\')' }),
           handler: wrap(async (argv, app) => {
             const recordData = JSON.parse(argv.data);
-            const record = await app.sdk.create('ticket', recordData);
+            const record = await app.sdk.create('task', recordData);
             app.ok(record, { summary: `Created ticket ${getStringField(record, 'number')}` });
           }),
         })
@@ -89,12 +90,12 @@ export function ticketsCmd(wrap) {
             const findParams = new URLSearchParams();
             findParams.set('sysparm_query', `number=${argv.number}`);
             findParams.set('sysparm_limit', '1');
-            const records = await app.sdk.list('ticket', findParams);
+            const records = await app.sdk.list('task', findParams);
             if (records.length === 0) {
               throw new Error(`Ticket not found: ${argv.number}`);
             }
             const sysID = getStringField(records[0], 'sys_id');
-            const updated = await app.sdk.update('ticket', sysID, recordData);
+            const updated = await app.sdk.update('task', sysID, recordData);
             app.ok(updated, { summary: `Updated ticket ${argv.number}` });
           }),
         })
@@ -105,12 +106,12 @@ export function ticketsCmd(wrap) {
             const findParams = new URLSearchParams();
             findParams.set('sysparm_query', `number=${argv.number}`);
             findParams.set('sysparm_limit', '1');
-            const records = await app.sdk.list('ticket', findParams);
+            const records = await app.sdk.list('task', findParams);
             if (records.length === 0) {
               throw new Error(`Ticket not found: ${argv.number}`);
             }
             const sysID = getStringField(records[0], 'sys_id');
-            await app.sdk.delete('ticket', sysID);
+            await app.sdk.delete('task', sysID);
             app.ok({ number: argv.number, message: 'Ticket deleted' }, { summary: `Deleted ticket ${argv.number}` });
           }),
         })

package/src/commands/users.js

@@ -1,4 +1,4 @@
-import { formatRecordForDisplay, getStringField, interactiveList } from '../helpers.js';
+import { formatRecordForDisplay, getStringField, interactiveList, resolveFieldsParam } from '../helpers.js';
 
 export function usersCmd(wrap) {
   return {
@@ -31,14 +31,15 @@ export function usersCmd(wrap) {
             const params = new URLSearchParams();
             params.set('sysparm_limit', String(argv.limit));
             params.set('sysparm_display_value', 'all');
-            params.set('sysparm_fields', ['sys_id', ...columns].join(','));
+            const fields = resolveFieldsParam(columns);
+            if (fields) params.set('sysparm_fields', fields);
             if (argv.query) params.set('sysparm_query', argv.query);
             const records = await app.sdk.list('sys_user', params);
             app.ok({
               table: 'sys_user',
               count: records.length,
               columns,
-              records: records.map(r => formatRecordForDisplay(r, columns)),
+              records: fields ? records.map(r => formatRecordForDisplay(r, columns)) : records,
               context: { instance_url: app.getEffectiveInstance() },
             }, { summary: `${records.length} user(s)` });
           }),

package/src/helpers.js

@@ -63,6 +63,17 @@ export function buildQuerySuffix(query) {
   return query ? ` --query "${query}"` : '';
 }
 
+/**
+ * Resolve sysparm_fields value from user-supplied columns.
+ * Returns null when columns includes '*' (signals "fetch all fields"),
+ * so callers should omit sysparm_fields and skip formatRecordForDisplay.
+ * Otherwise returns the fields string with sys_id prepended.
+ */
+export function resolveFieldsParam(columns) {
+  if (columns.includes('*')) return null;
+  return ['sys_id', ...columns].join(',');
+}
+
 /**
  * Shared interactive list helper with search-as-you-type.
  * All list commands that want an interactive TTY picker should use this.
@@ -84,11 +95,12 @@ export async function interactiveList({ app, table, singular, columns, limit = 2
     return null; // not interactive — caller should fall back to text/table
   }
 
-  const pickerColumns = ['sys_id', labelField, ...columns.filter(c => c !== labelField && c !== 'sys_id')];
+  const pickerColumns = ['sys_id', labelField, ...columns.filter(c => c !== labelField && c !== 'sys_id' && c !== '*')];
   const params = new URLSearchParams();
   params.set('sysparm_limit', String(limit));
   params.set('sysparm_display_value', 'all');
-  params.set('sysparm_fields', pickerColumns.join(','));
+  const pickerFields = pickerColumns.join(',');
+  if (pickerFields) params.set('sysparm_fields', pickerFields);
   params.set('sysparm_query', 'ORDERBYDESCsys_updated_on');
 
   const records = await app.sdk.list(table, params);

package/src/mutations.js

@@ -23,11 +23,32 @@ export const MUTATION_COMMANDS = [
   ['tasks', 'create'],
   ['tasks', 'update'],
   ['tasks', 'delete'],
-  // Dev
+  // Tickets
+  ['tickets', 'create'],
+  ['tickets', 'update'],
+  ['tickets', 'delete'],
+  // Users
+  ['users', 'create'],
+  ['users', 'update'],
+  ['users', 'delete'],
+  // Groups
+  ['groups', 'create'],
+  ['groups', 'update'],
+  ['groups', 'delete'],
+  // Catalog
+  ['catalog', 'create-item'],
+  // Dev flows
+  ['dev', 'flows', 'create'],
+  ['dev', 'flows', 'update'],
+  ['dev', 'flows', 'delete'],
+  // Dev scopes
+  ['dev', 'scopes', 'create'],
+  ['dev', 'scopes', 'set'],
+  // Dev eval
   ['dev', 'eval'],
+  // Dev updatesets
   ['dev', 'updatesets', 'set'],
   ['dev', 'updatesets', 'create'],
-  ['dev', 'scopes', 'set'],
 ];
 
 /**