@jacebenson/jsn 3.0.6 → 3.1.0

package/skills/servicenow/SKILL.md

@@ -18,7 +18,7 @@ compatibility: |
   the correct command path.
 metadata:
   author: jacebenson
-  version: "1.0.0"
+  version: "1.1.0"
   repository: https://github.com/jacebenson/jsn
 ---
 
@@ -31,9 +31,8 @@ Explore and manage ServiceNow instances. Works standalone or with AI agents.
 Commands are self-documenting. Use these to learn what's available:
 
 ```bash
-jsn --help                # Root help with all top-level commands
+jsn --help                # Root help with all top-level commands (grouped by category)
 jsn <command> --help        # Detailed usage, flags, and examples for any command
-jsn dev                     # Shows categorized dev subcommands
 ```
 
 ## Agent Rules
@@ -60,7 +59,7 @@ jsn dev                     # Shows categorized dev subcommands
 - `jsn records --table <name> create`
 - `jsn records --table <name> update <sys_id>`
 - `jsn records --table <name> delete <sys_id>`
-- `jsn dev updatesets set <name>`
+- `jsn updatesets set <name>`
 - `jsn profiles remove <name>`
 - Any `delete`, `update`, `create`, `set`, or `remove` subcommand
 
@@ -121,6 +120,44 @@ All commands support `--json`. The envelope structure:
 
 Breadcrumbs suggest next commands — follow them for navigation.
 
+## Troubleshooting Field Behavior
+
+When a user asks about field behavior (why a picker won't show inactive users, why a field is read-only, why a reference qualifier behaves unexpectedly), do NOT just check dictionary records or ACLs. Field behavior is often controlled by **before-query business rules**.
+
+**Check order (priority):**
+
+1. **Before-query business rules** — `sys_script` with `when=before`, `action=query`, matching `collection` (table)
+   ```bash
+   jsn records list --table sys_script --query "collection=sys_user^when=before^action=query^active=true" --json
+   ```
+   A common case: inactive user filters on `sys_user` are implemented as a before-query BR that adds `active=true` to the query condition.
+
+2. **ACLs** — `sys_security_acl` — read/write/delete permissions on tables and fields
+   ```bash
+   jsn acls list --query "name=incident" --json
+   ```
+
+3. **Dictionary overrides** — `sys_dictionary` — reference qualifiers, field attributes, default values
+   ```bash
+   jsn records list --table sys_dictionary --query "name=incident^element=caller_id" --json
+   ```
+
+4. **Client scripts** — `sys_script_client` — UI-side visibility, read-only, or value-change logic
+   ```bash
+   jsn records list --table sys_script_client --query "table=incident^active=true" --json
+   ```
+
+5. **UI policies** — `sys_ui_policy` — form-level field behavior (mandatory, read-only, visible)
+   ```bash
+   jsn records list --table sys_ui_policy --query "table=incident^active=true" --json
+   ```
+
+**Example:** "Why can't I pick an inactive user on the incident form?"
+- First guess: Dictionary reference qualifier on `caller_id`? → Check `sys_dictionary`
+- Most likely: Before-query BR on `sys_user` that filters `active=true` → Check `sys_script` first
+
+**Rule of thumb:** If a picker is silently filtering results (no error, just fewer options), it's a before-query BR. If it shows an error, it's an ACL or dictionary constraint.
+
 ## Configuration
 
 ```

package/src/app.js

@@ -118,7 +118,7 @@ export class App {
 
     const scopeFormatted = `[${scope}]`;
 
-    process.stderr.write('# Use `jsn dev scopes` to change scope, `jsn dev updatesets set` to change updateset\n');
+    process.stderr.write('# Use `jsn scopes` to change scope, `jsn updatesets set` to change updateset\n');
     process.stderr.write('PROFILE   USER      [SCOPE]           UPDATE SET\n');
 
     const profileStr = `]8;;${instanceLink}\x07${String(this.context.profileName).padEnd(9)}]8;;\x07`;
@@ -144,12 +144,12 @@ export class App {
           '┃  manual surgery, one change at a time. Avoid the mess. ┃\n' +
           '┃                                                        ┃\n' +
           '┃  Create a named update set now:                        ┃\n' +
-          '┃    jsn dev updatesets create --name "My Feature"       ┃\n' +
+          '┃    jsn updatesets create --name "My Feature"       ┃\n' +
           '┃                                                        ┃\n' +
           '┃  Or switch to a scoped scope first:                    ┃\n' +
-          '┃    jsn dev scopes list                                 ┃\n' +
+          '┃    jsn scopes list                                 ┃\n' +
           '┃                                                        ┃\n' +
-          '┃  (Run jsn dev updatesets yolo to silence this check)    ┃\n' +
+          '┃  (Run jsn updatesets yolo to silence this check)    ┃\n' +
           '┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛\x1b[0m\n'
         );
       } else {
@@ -160,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 dev updatesets yolo\x1b[22m to silence this warning)\n' +
+          '  (Run \x1b[1mjsn updatesets yolo\x1b[22m to silence this warning)\n' +
           '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n' +
           '\x1b[0m' // reset
         );

package/src/cli.js

@@ -27,6 +27,27 @@ import { versionCmd } from './commands/version.js';
 import { devCmd } from './commands/dev.js';
 import { skillCmd, checkSkill } from './commands/skill.js';
 
+// Dev subcommands promoted to root level for progressive disclosure
+import {
+  actionsCmd, includesCmd, rulesCmd,
+  clientScriptsCmd, uiActionsCmd, uiPoliciesCmd,
+  tablesCmd, columnsCmd, importCmd,
+  spPagesCmd, spWidgetsCmd, uiPagesCmd, appMenuCmd,
+  aclsCmd, rolesCmd, propertiesCmd,
+  relationshipsCmd, appmodulesCmd, listcontrolsCmd, viewsCmd,
+  privilegesCmd, securitytypesCmd, uxscriptsCmd, aliasesCmd,
+  catalogscriptsCmd, cataloguipoliciesCmd,
+} from './commands/dev/_simple.js';
+import { flowsCmd } from './commands/dev/flows.js';
+import { formsCmd } from './commands/dev/forms.js';
+import { listsCmd } from './commands/dev/lists.js';
+import { updateSetsCmd } from './commands/dev/updatesets.js';
+import { scopesCmd } from './commands/dev/scopes.js';
+import { evalCmd } from './commands/dev/eval.js';
+import { restCmd } from './commands/dev/rest.js';
+import { logsCmd } from './commands/dev/logs.js';
+import { scrapiCmd } from './commands/dev/scrapi.js';
+
 function wrap(handler) {
   return async (argv) => {
     try {
@@ -177,6 +198,45 @@ export const cli = yargs(hideBin(process.argv))
   .command(groupRolesCmd(wrap))
   .command(ticketsCmd(wrap))
   .command(devCmd(wrap))
+  // AUTOMATION — things that react, run, or transform
+  .command(flowsCmd(wrap))
+  .command(actionsCmd(wrap))
+  .command(rulesCmd(wrap))
+  .command(scrapiCmd(wrap))
+  .command(updateSetsCmd(wrap))
+  .command(evalCmd(wrap))
+  .command(restCmd(wrap))
+  // ACCESS — who can see/do what
+  .command(aclsCmd(wrap))
+  .command(rolesCmd(wrap))
+  .command(propertiesCmd(wrap))
+  .command(scopesCmd(wrap))
+  .command(privilegesCmd(wrap))
+  .command(securitytypesCmd(wrap))
+  .command(aliasesCmd(wrap))
+  // UX — what users see/interact with
+  .command(formsCmd(wrap))
+  .command(listsCmd(wrap))
+  .command(clientScriptsCmd(wrap))
+  .command(uiActionsCmd(wrap))
+  .command(uiPoliciesCmd(wrap))
+  .command(spPagesCmd(wrap))
+  .command(spWidgetsCmd(wrap))
+  .command(uiPagesCmd(wrap))
+  .command(appMenuCmd(wrap))
+  .command(listcontrolsCmd(wrap))
+  .command(viewsCmd(wrap))
+  .command(uxscriptsCmd(wrap))
+  .command(catalogscriptsCmd(wrap))
+  .command(cataloguipoliciesCmd(wrap))
+  // DATA — where data lives
+  .command(tablesCmd(wrap))
+  .command(columnsCmd(wrap))
+  .command(includesCmd(wrap))
+  .command(importCmd(wrap))
+  .command(logsCmd(wrap))
+  .command(relationshipsCmd(wrap))
+  .command(appmodulesCmd(wrap))
   .command(skillCmd(wrap))
   .command(versionCmd(wrap))
   .demandCommand(1, 'You must specify a command')

package/src/commands/_ticket.js

@@ -2,7 +2,7 @@
 // Used by incidents, changes, requests, tasks, and most dev subcommands
 
 import { getStringField, formatRecordForDisplay, buildQuerySuffix, resolveFieldsParam } from '../helpers.js';
-import search from '@inquirer/search';
+import { search } from '@inquirer/prompts';
 import { isTTY, FormatAuto } from '../output.js';
 
 export function buildTicketCommands(table, displayName, alias, defaultColumns, stateMap, iconFn, wrap) {

package/src/commands/dev/_generic.js

@@ -3,7 +3,7 @@
 import { formatRecordForDisplay, getStringField, isHexString, parseDataArg } from '../../helpers.js';
 import { getCurrentUser, getCurrentApplication } from '../../context.js';
 import readline from 'node:readline';
-import search from '@inquirer/search';
+import { search } from '@inquirer/prompts';
 import { isTTY, FormatAuto } from '../../output.js';
 
 function vowelArticle(word) {
@@ -16,13 +16,13 @@ function buildHints(name, singular, readOnly) {
   if (!readOnly) {
     crumbs.push({
       action: 'create',
-      cmd: `jsn dev ${name} create --name ... --label "..."`,
+      cmd: `jsn ${name} create --name ... --label "..."`,
       description: `Create ${vowelArticle(singular)} ${singular}`,
     });
   }
   crumbs.push({
     action: 'show',
-    cmd: `jsn dev ${name} show <name_or_sys_id>`,
+    cmd: `jsn ${name} show <name_or_sys_id>`,
     description: `Show ${singular} details`,
   });
   return crumbs;
@@ -84,12 +84,12 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
   const showSummary = opts.showSummary || ((record, id) => `${singular.charAt(0).toUpperCase() + singular.slice(1)}: ${getStringField(record, 'name') || id}`);
   const showBreadcrumbs = opts.showBreadcrumbs || ((record, id) => {
     const crumbs = [
-      { action: 'list', cmd: `jsn dev ${name} list`, description: `Back to all ${name}` },
+      { action: 'list', cmd: `jsn ${name} list`, description: `Back to all ${name}` },
     ];
     if (!readOnly) {
       crumbs.unshift(
-        { action: 'delete', cmd: `jsn dev ${name} delete ${id}`, description: `Delete this ${singular}` },
-        { action: 'update', cmd: `jsn dev ${name} update ${id} --data '{...}'`, description: `Update this ${singular}` }
+        { action: 'delete', cmd: `jsn ${name} delete ${id}`, description: `Delete this ${singular}` },
+        { action: 'update', cmd: `jsn ${name} update ${id} --data '{...}'`, description: `Update this ${singular}` }
       );
     }
     return crumbs;
@@ -104,7 +104,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
         builder: (y) => y
           .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true^priority=1")' })
           .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' }),
+          .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
         handler: wrap(async (argv, app) => {
           const query = argv.query || '';
           const columns = argv.columns ? argv.columns.split(',') : defaultColumns;
@@ -178,8 +178,8 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
               app.ok(record, {
                 summary: `${singular.charAt(0).toUpperCase() + singular.slice(1)}: ${selectedName}`,
                 breadcrumbs: [
-                  ...(readOnly ? [] : [{ action: 'update', cmd: `jsn dev ${name} update ${selectedName} --data '{...}'`, description: `Update this ${singular}` }]),
-                  { action: 'list', cmd: `jsn dev ${name} list`, description: `Back to all ${name}` },
+                  ...(readOnly ? [] : [{ action: 'update', cmd: `jsn ${name} update ${selectedName} --data '{...}'`, description: `Update this ${singular}` }]),
+                  { action: 'list', cmd: `jsn ${name} list`, description: `Back to all ${name}` },
                 ],
               });
             }
@@ -256,7 +256,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
             app.ok(record, {
               summary: `Created ${singular}`,
               breadcrumbs: [
-                { action: 'show', cmd: `jsn dev ${name} show ${getStringField(record, 'name') || getStringField(record, 'sys_id')}`, description: `View the new ${singular}` },
+                { action: 'show', cmd: `jsn ${name} show ${getStringField(record, 'name') || getStringField(record, 'sys_id')}`, description: `View the new ${singular}` },
               ],
             });
           }),
@@ -284,7 +284,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
             if (scopeValidation) {
               const scopeErr = await checkScope(app.sdk, recordScope);
               if (scopeErr) {
-                throw new Error(`record is in scope '${scopeErr.recordScope}', but your current scope is '${scopeErr.currentScope}'. Switch scope first: jsn dev scopes set ${scopeErr.recordScope}`);
+                throw new Error(`record is in scope '${scopeErr.recordScope}', but your current scope is '${scopeErr.currentScope}'. Switch scope first: jsn scopes set ${scopeErr.recordScope}`);
               }
             }
 
@@ -315,7 +315,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
             if (scopeValidation) {
               const scopeErr = await checkScope(app.sdk, recordScope);
               if (scopeErr) {
-                throw new Error(`record is in scope '${scopeErr.recordScope}', but your current scope is '${scopeErr.currentScope}'. Switch scope first: jsn dev scopes set ${scopeErr.recordScope}`);
+                throw new Error(`record is in scope '${scopeErr.recordScope}', but your current scope is '${scopeErr.currentScope}'. Switch scope first: jsn scopes set ${scopeErr.recordScope}`);
               }
             }
 
@@ -358,7 +358,7 @@ export function buildDevCmd(name, table, aliases, defaultColumns, wrap, opts = {
         console.log('  update      Update a record');
         console.log('  delete      Delete a record');
       }
-      console.log(`\nRun "jsn dev ${name} <command> --help" for details.`);
+      console.log(`\nRun "jsn ${name} <command> --help" for details.`);
     },
   };
 }

package/src/commands/dev/eval.js

@@ -45,7 +45,7 @@ export function evalCmd(wrap) {
         summary: 'Script executed' + warning,
         breadcrumbs: [{
           action: 'eval',
-          cmd: 'jsn dev eval --script \'...\'',
+          cmd: 'jsn eval --script \'...\'',
           description: 'Execute a background script on the ServiceNow instance',
         }],
       });

package/src/commands/dev/flows.js

@@ -14,22 +14,24 @@ export function flowsCmd(wrap) {
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
             .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('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
+            app.requireInstance();
             const columns = argv.columns ? argv.columns.split(',') : ['name', 'active', 'description', 'sys_created_by', 'sys_updated_on'];
             const query = argv.query || '';
 
             // Interactive picker
             const picked = await interactiveList({
               app, table: 'sys_hub_flow', singular: 'flow', columns, limit: argv.limit, query, labelField: 'name',
-              formatLabel: r => `${getStringField(r, 'name')} ${getStringField(r, 'active') === 'true' ? '' : '[inactive]'}`,
+              formatLabel: r => `${getStringField(r, 'active') === 'true' ? '🟢' : '🔴'} ${getStringField(r, 'name')}`,
             });
+            if (picked === undefined) return; // user cancelled
             if (picked) {
               const inspection = await app.sdk.inspectFlow(getStringField(picked, 'sys_id'));
               const formatted = formatFlowInspection(inspection, app.getEffectiveInstance());
               return app.ok({ ...inspection, _formatted: formatted }, {
                 summary: `Flow: ${inspection.flow.name}`,
-                breadcrumbs: [{ action: 'list', cmd: 'jsn dev flows list', description: 'Back to all flows' }],
+                breadcrumbs: [{ action: 'list', cmd: 'jsn flows list', description: 'Back to all flows' }],
               });
             }
 
@@ -61,7 +63,7 @@ export function flowsCmd(wrap) {
             app.ok(data, {
               summary: `Flow: ${inspection.flow.name}`,
               breadcrumbs: [
-                { action: 'list', cmd: 'jsn dev flows list', description: 'Back to all flows' },
+                { action: 'list', cmd: 'jsn flows list', description: 'Back to all flows' },
               ],
             });
           }),
@@ -73,7 +75,7 @@ export function flowsCmd(wrap) {
             .option('data', { type: 'string', describe: 'JSON data for the flow' }),
           handler: wrap(async (_argv, _app) => {
             throw new Error('Flow creation requires the Flow Designer GraphQL API - not yet implemented.\n'
-              + 'Use the ServiceNow web UI to create flows, then use "jsn dev flows list" to view them.');
+              + 'Use the ServiceNow web UI to create flows, then use "jsn flows list" to view them.');
           }),
         })
         .command({
@@ -83,7 +85,7 @@ export function flowsCmd(wrap) {
             .option('data', { type: 'string', describe: 'JSON data to update' }),
           handler: wrap(async (_argv, _app) => {
             throw new Error('Flow updates require the Flow Designer GraphQL API - not yet implemented.\n'
-              + 'Use the ServiceNow web UI to update flows, then use "jsn dev flows list" to view them.');
+              + 'Use the ServiceNow web UI to update flows, then use "jsn flows list" to view them.');
           }),
         })
         .command({
@@ -95,7 +97,22 @@ export function flowsCmd(wrap) {
           }),
         });
     },
-    handler: () => {},
+    handler: () => {
+      console.log('Manage Flow Designer flows from the sys_hub_flow table.');
+      console.log('');
+      console.log('Available subcommands:');
+      console.log('  list                  List flows');
+      console.log('  show <identifier>     Show flow details by name or sys_id');
+      console.log('  create                Create a new flow (not yet implemented)');
+      console.log('  update <identifier>   Update a flow (not yet implemented)');
+      console.log('  delete <identifier>   Delete a flow (not yet implemented)');
+      console.log('');
+      console.log('Run "jsn flows <command> --help" for details.');
+      console.log('');
+      console.log('Note: Flow inspection detail varies. V2 flows (with payload)');
+      console.log('show full action inputs and conditions. Subflows and V1 flows');
+      console.log('show step names only.');
+    },
   };
 }
 
@@ -168,7 +185,13 @@ function formatFlowInspection(inspection, instanceURL) {
   lines.push('');
   lines.push('⚡ FLOW STRUCTURE');
   lines.push('─'.repeat(50));
-  lines.push(...formatFlowStructure(inspection));
+  const structureLines = formatFlowStructure(inspection);
+  lines.push(...structureLines);
+  // Note limitation for V1/subflows without payload detail
+  if (!inspection.payload || Object.keys(inspection.payload).length === 0) {
+    lines.push('');
+    lines.push('  (step detail limited — this flow lacks a V2 payload)');
+  }
 
   lines.push('');
   return lines.join('\n') + '\n';

package/src/commands/dev/forms.js

@@ -60,6 +60,7 @@ export function formsCmd(wrap) {
             })
             .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
+            app.requireInstance();
             const table = argv.table;
             const limit = argv.limit || 50;
 
@@ -99,7 +100,7 @@ export function formsCmd(wrap) {
             }, {
               summary: `${views.length} views for ${table}`,
               breadcrumbs: [
-                { action: 'show', cmd: `jsn dev forms show ${table} --view "Default view"`, description: 'Show Default view layout' },
+                { action: 'show', cmd: `jsn forms show ${table} --view "Default view"`, description: 'Show Default view layout' },
               ],
             });
           }),
@@ -111,6 +112,7 @@ export function formsCmd(wrap) {
           builder: (y) => y
             .option('view', { type: 'string', default: 'Default view', describe: 'View name' }),
           handler: wrap(async (argv, app) => {
+            app.requireInstance();
             const table = argv.table;
             const viewName = argv.view;
 
@@ -256,8 +258,8 @@ export function formsCmd(wrap) {
             lines.push('─────');
             lines.push('');
             lines.push(chalk.bold(chalk.hex('#e8a217')('Hints:')));
-            lines.push(`  ${`jsn dev forms list ${table}`.padEnd(50)}  ${chalk.hex('#888888')('List all views')}`);
-            lines.push(`  ${`jsn dev columns --table ${table}`.padEnd(50)}  ${chalk.hex('#888888')('View table columns')}`);
+            lines.push(`  ${`jsn forms list ${table}`.padEnd(50)}  ${chalk.hex('#888888')('List all views')}`);
+            lines.push(`  ${`jsn columns --table ${table}`.padEnd(50)}  ${chalk.hex('#888888')('View table columns')}`);
             lines.push('');
 
             const formatted = lines.join('\n');
@@ -305,13 +307,21 @@ export function formsCmd(wrap) {
             }, {
               summary: `Form: ${table} (${viewName}) - ${sections.length} sections`,
               breadcrumbs: [
-                { action: 'list', cmd: `jsn dev forms list ${table}`, description: 'List all views' },
-                { action: 'columns', cmd: `jsn dev columns --table ${table}`, description: 'View table columns' },
+                { action: 'list', cmd: `jsn forms list ${table}`, description: 'List all views' },
+                { action: 'columns', cmd: `jsn columns --table ${table}`, description: 'View table columns' },
               ],
             });
           }),
         });
     },
-    handler: () => {},
+    handler: () => {
+      console.log('Manage form layouts from the sys_ui_form_section table.');
+      console.log('');
+      console.log('Available subcommands:');
+      console.log('  list <table>         List form views for a table');
+      console.log('  show <table>         Show form layout for a table');
+      console.log('');
+      console.log('Run "jsn forms <command> --help" for details.');
+    },
   };
 }

package/src/commands/dev/lists.js

@@ -51,6 +51,7 @@ export function listsCmd(wrap) {
             })
             .option('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
+            app.requireInstance();
             const table = argv.table;
             const limit = argv.limit || 50;
 
@@ -90,7 +91,7 @@ export function listsCmd(wrap) {
             }, {
               summary: `${views.length} list views for ${table}`,
               breadcrumbs: [
-                { action: 'show', cmd: `jsn dev lists show ${table} --view "Default view"`, description: 'Show Default view columns' },
+                { action: 'show', cmd: `jsn lists show ${table} --view "Default view"`, description: 'Show Default view columns' },
               ],
             });
           }),
@@ -102,6 +103,7 @@ export function listsCmd(wrap) {
           builder: (y) => y
             .option('view', { type: 'string', default: 'Default view', describe: 'View name' }),
           handler: wrap(async (argv, app) => {
+            app.requireInstance();
             const table = argv.table;
             const viewName = argv.view;
 
@@ -195,8 +197,8 @@ export function listsCmd(wrap) {
             lines.push('─────');
             lines.push('');
             lines.push(chalk.bold(chalk.hex('#e8a217')('Hints:')));
-            lines.push(`  ${`jsn dev lists list ${table}`.padEnd(50)}  ${chalk.hex('#888888')('List all views')}`);
-            lines.push(`  ${`jsn dev forms show ${table} --view "${viewName}"`.padEnd(50)}  ${chalk.hex('#888888')('Show form layout')}`);
+            lines.push(`  ${`jsn lists list ${table}`.padEnd(50)}  ${chalk.hex('#888888')('List all views')}`);
+            lines.push(`  ${`jsn forms show ${table} --view "${viewName}"`.padEnd(50)}  ${chalk.hex('#888888')('Show form layout')}`);
             lines.push('');
 
             const formatted = lines.join('\n');
@@ -225,13 +227,21 @@ export function listsCmd(wrap) {
             }, {
               summary: `List: ${table} (${viewName}) - ${elements.length} columns`,
               breadcrumbs: [
-                { action: 'list', cmd: `jsn dev lists list ${table}`, description: 'List all views' },
-                { action: 'form', cmd: `jsn dev forms show ${table} --view "${viewName}"`, description: 'Show form layout' },
+                { action: 'list', cmd: `jsn lists list ${table}`, description: 'List all views' },
+                { action: 'form', cmd: `jsn forms show ${table} --view "${viewName}"`, description: 'Show form layout' },
               ],
             });
           }),
         });
     },
-    handler: () => {},
+    handler: () => {
+      console.log('Manage list layouts from the sys_ui_list table.');
+      console.log('');
+      console.log('Available subcommands:');
+      console.log('  list <table>         List list views for a table');
+      console.log('  show <table>         Show list layout for a table');
+      console.log('');
+      console.log('Run "jsn lists <command> --help" for details.');
+    },
   };
 }

package/src/commands/dev/logs.js

@@ -16,6 +16,7 @@ export function logsCmd(wrap) {
             .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) => {
+            app.requireInstance();
             const columns = argv.columns ? argv.columns.split(',') : ['level', 'message', 'source', 'created'];
             const query = argv.query || '';
 
@@ -24,6 +25,7 @@ export function logsCmd(wrap) {
               app, table: 'syslog', singular: 'log entry', columns, limit: argv.limit, query, labelField: 'message',
               formatLabel: r => `[${getStringField(r, 'level') || '?'}] ${(getStringField(r, 'message') || '').substring(0, 80)}`,
             });
+            if (picked === undefined) return; // user cancelled
             if (picked) {
               picked._context = { instance_url: app.getEffectiveInstance(), table: 'syslog' };
               return app.ok(picked, { summary: `Log entry` });
@@ -59,6 +61,14 @@ export function logsCmd(wrap) {
           }),
         });
     },
-    handler: () => {},
+    handler: () => {
+      console.log('View system logs from the syslog table.');
+      console.log('');
+      console.log('Available subcommands:');
+      console.log('  list                List log entries');
+      console.log('  show <sys_id>       Show a log entry by sys_id');
+      console.log('');
+      console.log('Run "jsn logs <command> --help" for details.');
+    },
   };
 }

package/src/commands/dev/scopes.js

@@ -14,7 +14,7 @@ export function scopesCmd(wrap) {
           builder: (y) => y
             .option('query', { type: 'string', describe: 'Encoded query (e.g. "nameLIKEincident" or "active=true")' })
             .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('limit', { alias: 'l', type: 'number', default: 50, describe: 'Max records' }),
           handler: wrap(async (argv, app) => {
             const columns = argv.columns ? argv.columns.split(',') : ['name', 'scope', 'short_description', 'active'];
             const query = argv.query || '';
@@ -23,6 +23,7 @@ export function scopesCmd(wrap) {
               app, table: 'sys_scope', singular: 'scope', columns, limit: argv.limit, query, labelField: 'name',
               formatLabel: r => `${getStringField(r, 'name')} [${getStringField(r, 'scope') || '?'}]`,
             });
+            if (picked === undefined) return; // user cancelled
             if (picked) {
               picked._context = { instance_url: app.getEffectiveInstance(), table: 'sys_scope' };
               return app.ok(picked, { summary: `Scope: ${getStringField(picked, 'name')}` });
@@ -143,7 +144,7 @@ export function scopesCmd(wrap) {
               summary: `Created scope: ${scope}`,
               breadcrumbs: [{
                 action: 'show',
-                cmd: `jsn dev scopes show ${scope}`,
+                cmd: `jsn scopes show ${scope}`,
                 description: 'View the new scope',
               }],
             });
@@ -159,7 +160,7 @@ export function scopesCmd(wrap) {
         console.log('  show <scope>   Show a scope');
         console.log('  set  <scope>   Set the current application scope');
         console.log('  create         Create a new application scope');
-        console.log('\nRun "jsn dev scopes <command> --help" for details.');
+        console.log('\nRun "jsn scopes <command> --help" for details.');
       }
     },
   };