@jacebenson/jsn 0.1.0 → 0.1.2

package/README.md

@@ -32,7 +32,7 @@ jsn version --check
 
 ## What's New in v0.1.0
 
-Full feature parity with the original Go implementation — 128 tests, lint clean:
+Full feature parity — 128 tests, lint clean:
 
 | Feature | Status |
 |---------|--------|
@@ -44,7 +44,7 @@ Full feature parity with the original Go implementation — 128 tests, lint clea
 | Group management (CRUD) | ✅ |
 | Group memberships and roles | ✅ |
 | Generic Table API (`jsn records`) | ✅ |
-| OAuth PKCE with keychain (Go-compatible auth store) | ✅ |
+| OAuth PKCE with keychain (shared auth store) | ✅ |
 | Bot/CI/CD auth flags (`--code`, `--print-url`) | ✅ |
 | Dev commands: flows, actions, includes, rules, ACLs, etc. | ✅ |
 | Script execution (`jsn dev eval`) via OAuth session flow | ✅ |
@@ -211,7 +211,7 @@ jsn incidents -q | jq '.[].number'
 
 ## Authentication
 
-OAuth 2.0 with PKCE. Credentials stored in `~/.config/servicenow/credentials/` — shared with the legacy Go version.
+OAuth 2.0 with PKCE. Credentials stored in `~/.config/servicenow/credentials/`.
 
 ```bash
 jsn auth login https://dev12345.service-now.com
@@ -335,10 +335,6 @@ jsn version --check
 npm install -g @jacebenson/jsn
 ```
 
-## Historical Note
-
-JSN was originally implemented in Go (on the `main` branch) and migrated to Node.js for broader cross-platform support and simpler installation. As of v0.1.0, the Node.js version has full feature parity. The Go source remains available on the `main` branch for reference.
-
 ## License
 
 MIT License — see LICENSE file for details

package/package.json

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

package/src/commands/_ticket.js

@@ -18,7 +18,7 @@ export function buildTicketCommands(table, displayName, alias, defaultColumns, s
           describe: `List ${table}`,
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' })
             .option('offset', { alias: 'o', type: 'number', default: 0, describe: 'Offset for pagination' }),
           handler: wrap(async (argv, app) => {

package/src/commands/dev/_generic.js

@@ -81,7 +81,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
         describe: `List ${name}`,
         builder: (y) => y
           .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true^priority=1")' })
-          .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "name,label,super_class")' })
+          .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "name,label,super_class")' })
           .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
         handler: wrap(async (argv, app) => {
           const query = argv.query || '';
@@ -251,6 +251,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
             const findParams = new URLSearchParams();
             findParams.set('sysparm_query', `${queryField}=${id}`);
             findParams.set('sysparm_limit', '1');
+            findParams.set('sysparm_display_value', 'all');
             const records = await app.sdk.list(table, findParams);
             if (records.length === 0) {
               throw new Error(`${singular} not found: ${id}`);
@@ -280,6 +281,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
             const findParams = new URLSearchParams();
             findParams.set('sysparm_query', `${queryField}=${id}`);
             findParams.set('sysparm_limit', '1');
+            findParams.set('sysparm_display_value', 'all');
             const records = await app.sdk.list(table, findParams);
             if (records.length === 0) {
               throw new Error(`${singular} not found: ${id}`);

package/src/commands/dev/flows.js

@@ -13,7 +13,7 @@ export function flowsCmd(wrap) {
           describe: 'List flows',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const columns = argv.columns ? argv.columns.split(',') : ['name', 'active', 'description', 'sys_created_by', 'sys_updated_on'];

package/src/commands/dev/logs.js

@@ -13,7 +13,7 @@ export function logsCmd(wrap) {
           describe: 'List system logs',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const columns = argv.columns ? argv.columns.split(',') : ['level', 'message', 'source', 'created'];

package/src/commands/dev/scopes.js

@@ -13,7 +13,7 @@ export function scopesCmd(wrap) {
           describe: 'List application scopes',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const columns = argv.columns ? argv.columns.split(',') : ['name', 'scope', 'short_description', 'active'];

package/src/commands/dev/updatesets.js

@@ -13,7 +13,7 @@ export function updateSetsCmd(wrap) {
           describe: 'List update sets',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const columns = argv.columns ? argv.columns.split(',') : ['name', 'state', 'application'];

package/src/commands/groupmembers.js

@@ -13,7 +13,7 @@ export function groupMembersCmd(wrap) {
           describe: 'List group members',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .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', 'group.name'];

package/src/commands/grouproles.js

@@ -13,7 +13,7 @@ export function groupRolesCmd(wrap) {
           describe: 'List group roles',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const columns = argv.columns ? argv.columns.split(',') : ['group.name', 'role.name'];

package/src/commands/groups.js

@@ -13,7 +13,7 @@ export function groupsCmd(wrap) {
           describe: 'List groups',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .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'];

package/src/commands/records.js

@@ -30,35 +30,44 @@ export function recordsCmd(wrap) {
           describe: 'List records from a table',
           builder: (y) => y
             .option('table', { type: 'string', demandOption: true, describe: 'Table name' })
+            .option('sys-id', { type: 'string', describe: 'Record sys_id (filters to a single record)' })
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .option('limit', { type: 'number', default: 20, describe: 'Max records' })
             .option('offset', { type: 'number', default: 0, describe: 'Offset' }),
           handler: wrap(async (argv, app) => {
             const table = argv.table;
             const columns = argv.columns ? argv.columns.split(',') : getDefaultColumns(table);
-            const query = argv.query || '';
+            let 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}` });
+            // If --sys-id is provided, append it to the query
+            if (argv['sys-id']) {
+              if (query) query += '^';
+              query += `sys_id=${argv['sys-id']}`;
             }
 
-            // Text/table fallback
+            // Interactive picker (only when no --sys-id filter, otherwise go straight to results)
+            if (!argv['sys-id']) {
+              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 (or sys-id direct lookup)
             const params = new URLSearchParams();
-            params.set('sysparm_limit', String(argv.limit));
+            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(','));
-            if (argv.query) params.set('sysparm_query', argv.query);
+            if (query) params.set('sysparm_query', query);
             const records = await app.sdk.list(table, params);
             const displayRecords = records.map(r => formatRecordForDisplay(r, columns));
             const breadcrumbs = [
@@ -66,6 +75,13 @@ export function recordsCmd(wrap) {
               { action: 'filter', cmd: `jsn records list --table ${table} --query "priority=1"`, description: 'Filter: priority 1 only' },
               { action: 'columns', cmd: `jsn dev columns --table ${table}`, description: 'View available columns' },
             ];
+            if (argv['sys-id']) {
+              breadcrumbs.unshift({
+                action: 'get',
+                cmd: `jsn records get --table ${table} --sys-id ${argv['sys-id']}`,
+                description: 'Get full record details',
+              });
+            }
             if (records.length === argv.limit) {
               breadcrumbs.push({
                 action: 'next',
@@ -96,7 +112,7 @@ 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('columns', { type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' }),
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' }),
           handler: wrap(async (argv, app) => {
             const params = new URLSearchParams();
             params.set('sysparm_query', `sys_id=${argv['sys-id']}`);

package/src/commands/tickets.js

@@ -13,7 +13,7 @@ export function ticketsCmd(wrap) {
           describe: 'List tickets',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "active=true^priority=1")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description,priority")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description,priority")' })
             .option('limit', { alias: 'l', type: 'number', default: 20, describe: 'Max records' })
             .option('offset', { alias: 'o', type: 'number', default: 0, describe: 'Offset' }),
           handler: wrap(async (argv, app) => {

package/src/commands/users.js

@@ -13,7 +13,7 @@ export function usersCmd(wrap) {
           describe: 'List users',
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
-            .option('columns', { alias: 'c', type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
+            .option('columns', { alias: ['c', 'fields'], type: 'string', describe: 'Comma-separated columns (e.g. "number,short_description")' })
             .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'];