@jacebenson/jsn 4.3.8-dev.51 → 4.3.8-dev.53

package/package.json

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

package/src/commands/actions.js

@@ -9,6 +9,7 @@ import { cancelled, pickDesignerRecord, designerScope, guidedActionCreate, guide
 const ACTION_COMMANDS = [
   { name: 'list', description: 'List actions' },
   { name: 'show [identifier]', description: 'Show an action by name or sys_id' },
+  { name: 'help [identifier]', description: 'Show action input requirements and live usage examples' },
   { name: 'definition [identifier]', description: 'Read the full JSON definition including executable step_instances' },
   { name: 'step-types', description: 'Read step schema templates for a target scope' },
   { name: 'create', description: 'Create an action: guided in a terminal, full JSON definition in scripts' },
@@ -65,6 +66,26 @@ export const actionsCmd = wrap => {
           app.ok(result, { summary: `Created and verified action ${result.sys_id}` });
         }),
       })
+      .command({
+        command: 'help [identifier]', describe: 'Show action input requirements and examples from flows on this instance',
+        builder: scopeOption,
+        handler: run(async (argv, app) => {
+          const id = await actionID(argv, app);
+          if (id === undefined) return;
+          const scope = await actionScope(app.sdk, id, argv.scope);
+          const definition = await app.sdk.getProcessFlowAction(id, scope);
+          const inputs = (definition.inputs || []).map(input => ({
+            name: input.name,
+            type: input.type || input.parameter?.type || input.parameter?.inputType || input.valueType || 'unknown',
+            mandatory: input.mandatory ?? input.required ?? input.parameter?.mandatory ?? input.parameter?.required ?? false,
+            default: input.defaultValue ?? input.default ?? input.parameter?.defaultValue ?? '',
+            description: input.description || input.label || input.parameter?.label || '',
+          }));
+          app.ok({ action: { id, name: definition.name, scope }, inputs, examples: [], examples_status: 'unverified',
+            examples_note: 'Live examples are not shown yet because this instance’s action-instance to snapshot relationship has not been verified.' },
+          { summary: `Input help for action ${definition.name || id}` });
+        }),
+      })
       .command({
         command: 'definition [identifier]', describe: 'Read full JSON definition including executable step_instances',
         builder: scopeOption,

package/src/commands/catalog.js

@@ -63,8 +63,8 @@ export function catalogCmd(wrap) {
               for (const v of argv.variable) {
                 const parts = String(v).split(':');
                 if (parts.length >= 2) {
-                  const typeName = parts.length >= 2 ? parts[parts.length - 1] : '';
-                  const label = parts.length >= 3 ? parts[parts.length - 1] : parts[0];
+                  const typeName = parts[1];
+                  const label = parts.length >= 3 ? parts.slice(2).join(':') : parts[0];
                   const sysName = parts[0].replace(/[^a-zA-Z0-9_]/g, '_').toLowerCase();
                   try {
                     await app.sdk.create('item_option_new', {