@camunda8/cli 2.6.0-alpha.18 → 2.6.0-alpha.19

package/dist/commands/help.js

@@ -1,129 +1,544 @@
 /**
  * Help and version commands
  */
-import { readFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { getLogger } from "../logger.js";
-import { getPluginCommandsInfo } from "../plugin-loader.js";
+import { getPluginCommandsInfo, } from "../plugin-loader.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-/**
- * Build structured JSON help data for machine/agent consumption.
- * Returned by showHelp() and showCommandHelp() in JSON output mode.
- */
 function buildHelpJson(version, pluginCommandsInfo) {
     return {
         version,
-        usage: 'c8ctl <command> [resource] [options]',
+        usage: "c8ctl <command> [resource] [options]",
         commands: [
-            { verb: 'list', resource: '<resource>', resources: ['pi', 'pd', 'ut', 'inc', 'jobs', 'profiles', 'plugins', 'users', 'roles', 'groups', 'tenants', 'auth', 'mapping-rules'], description: 'List resources (process, identity)', mutating: false },
-            { verb: 'search', resource: '<resource>', resources: ['pi', 'pd', 'ut', 'inc', 'jobs', 'vars', 'users', 'roles', 'groups', 'tenants', 'auth', 'mapping-rules'], description: 'Search resources with filters', mutating: false },
-            { verb: 'get', resource: '<resource> <key>', resources: ['pi', 'pd', 'inc', 'topology', 'form', 'user', 'role', 'group', 'tenant', 'auth', 'mapping-rule'], description: 'Get resource by key', mutating: false },
-            { verb: 'create', resource: '<resource>', resources: ['pi', 'user', 'role', 'group', 'tenant', 'auth', 'mapping-rule'], description: 'Create resource', mutating: true },
-            { verb: 'delete', resource: '<resource> <key>', resources: ['user', 'role', 'group', 'tenant', 'auth', 'mapping-rule'], description: 'Delete resource', mutating: true },
-            { verb: 'assign', resource: '<resource> <id> --to-<target>=<id>', resources: ['role', 'user', 'group', 'mapping-rule'], description: 'Assign resource to target', mutating: true },
-            { verb: 'unassign', resource: '<resource> <id> --from-<target>=<id>', resources: ['role', 'user', 'group', 'mapping-rule'], description: 'Unassign resource from target', mutating: true },
-            { verb: 'cancel', resource: '<resource> <key>', resources: ['pi'], description: 'Cancel resource', mutating: true },
-            { verb: 'await', resource: '<resource>', resources: ['pi'], description: 'Create and await completion (alias for create --awaitCompletion)', mutating: true },
-            { verb: 'complete', resource: '<resource> <key>', resources: ['ut', 'job'], description: 'Complete resource', mutating: true },
-            { verb: 'fail', resource: 'job <key>', resources: ['job'], description: 'Fail a job', mutating: true },
-            { verb: 'activate', resource: 'jobs <type>', resources: ['jobs'], description: 'Activate jobs by type', mutating: true },
-            { verb: 'resolve', resource: 'inc <key>', resources: ['inc'], description: 'Resolve incident', mutating: true },
-            { verb: 'publish', resource: 'msg <name>', resources: ['msg'], description: 'Publish message', mutating: true },
-            { verb: 'correlate', resource: 'msg <name>', resources: ['msg'], description: 'Correlate message', mutating: true },
-            { verb: 'deploy', resource: '[path...]', resources: [], description: 'Deploy BPMN/DMN/forms', mutating: true },
-            { verb: 'run', resource: '<path>', resources: [], description: 'Deploy and start process', mutating: true },
-            { verb: 'watch', resource: '[path...]', resources: [], description: 'Watch files for changes and auto-deploy', mutating: false },
-            { verb: 'open', resource: '<app>', resources: ['operate', 'tasklist', 'modeler', 'optimize'], description: 'Open Camunda web application in browser', mutating: false },
-            { verb: 'add', resource: 'profile <name>', resources: ['profile'], description: 'Add a profile', mutating: false },
-            { verb: 'remove', resource: 'profile <name>', resources: ['profile'], description: 'Remove a profile (alias: rm)', mutating: false },
-            { verb: 'load', resource: 'plugin <name>', resources: ['plugin'], description: 'Load a c8ctl plugin', mutating: false },
-            { verb: 'unload', resource: 'plugin <name>', resources: ['plugin'], description: 'Unload a c8ctl plugin', mutating: false },
-            { verb: 'upgrade', resource: 'plugin <name>', resources: ['plugin'], description: 'Upgrade a plugin', mutating: false },
-            { verb: 'downgrade', resource: 'plugin <name> <version>', resources: ['plugin'], description: 'Downgrade a plugin to a specific version', mutating: false },
-            { verb: 'sync', resource: 'plugin', resources: ['plugin'], description: 'Synchronize plugins', mutating: false },
-            { verb: 'init', resource: 'plugin [name]', resources: ['plugin'], description: 'Create a new plugin from TypeScript template', mutating: false },
-            { verb: 'use', resource: 'profile|tenant', resources: ['profile', 'tenant'], description: 'Set active profile or tenant', mutating: false },
-            { verb: 'output', resource: '[json|text]', resources: ['json', 'text'], description: 'Show or set output format', mutating: false },
-            { verb: 'completion', resource: 'bash|zsh|fish', resources: ['bash', 'zsh', 'fish'], description: 'Generate shell completion script', mutating: false },
-            { verb: 'mcp-proxy', resource: '[mcp-path]', resources: [], description: 'Start a STDIO to remote HTTP MCP proxy server', mutating: false },
-            { verb: 'feedback', resource: '', resources: [], description: 'Open the feedback page to report issues or request features', mutating: false },
-            { verb: 'help', resource: '[command]', resources: [], description: 'Show help', mutating: false },
-            ...pluginCommandsInfo.map(cmd => ({
-                verb: cmd.commandName, resource: '', resources: [], description: cmd.description || '', mutating: false,
+            {
+                verb: "list",
+                resource: "<resource>",
+                resources: [
+                    "pi",
+                    "pd",
+                    "ut",
+                    "inc",
+                    "jobs",
+                    "profiles",
+                    "plugins",
+                    "users",
+                    "roles",
+                    "groups",
+                    "tenants",
+                    "auth",
+                    "mapping-rules",
+                ],
+                description: "List resources (process, identity)",
+                mutating: false,
+            },
+            {
+                verb: "search",
+                resource: "<resource>",
+                resources: [
+                    "pi",
+                    "pd",
+                    "ut",
+                    "inc",
+                    "jobs",
+                    "vars",
+                    "users",
+                    "roles",
+                    "groups",
+                    "tenants",
+                    "auth",
+                    "mapping-rules",
+                ],
+                description: "Search resources with filters",
+                mutating: false,
+            },
+            {
+                verb: "get",
+                resource: "<resource> <key>",
+                resources: [
+                    "pi",
+                    "pd",
+                    "inc",
+                    "topology",
+                    "form",
+                    "user",
+                    "role",
+                    "group",
+                    "tenant",
+                    "auth",
+                    "mapping-rule",
+                ],
+                description: "Get resource by key",
+                mutating: false,
+            },
+            {
+                verb: "create",
+                resource: "<resource>",
+                resources: [
+                    "pi",
+                    "user",
+                    "role",
+                    "group",
+                    "tenant",
+                    "auth",
+                    "mapping-rule",
+                ],
+                description: "Create resource",
+                mutating: true,
+            },
+            {
+                verb: "delete",
+                resource: "<resource> <key>",
+                resources: ["user", "role", "group", "tenant", "auth", "mapping-rule"],
+                description: "Delete resource",
+                mutating: true,
+            },
+            {
+                verb: "assign",
+                resource: "<resource> <id> --to-<target>=<id>",
+                resources: ["role", "user", "group", "mapping-rule"],
+                description: "Assign resource to target",
+                mutating: true,
+            },
+            {
+                verb: "unassign",
+                resource: "<resource> <id> --from-<target>=<id>",
+                resources: ["role", "user", "group", "mapping-rule"],
+                description: "Unassign resource from target",
+                mutating: true,
+            },
+            {
+                verb: "cancel",
+                resource: "<resource> <key>",
+                resources: ["pi"],
+                description: "Cancel resource",
+                mutating: true,
+            },
+            {
+                verb: "await",
+                resource: "<resource>",
+                resources: ["pi"],
+                description: "Create and await completion (alias for create --awaitCompletion)",
+                mutating: true,
+            },
+            {
+                verb: "complete",
+                resource: "<resource> <key>",
+                resources: ["ut", "job"],
+                description: "Complete resource",
+                mutating: true,
+            },
+            {
+                verb: "fail",
+                resource: "job <key>",
+                resources: ["job"],
+                description: "Fail a job",
+                mutating: true,
+            },
+            {
+                verb: "activate",
+                resource: "jobs <type>",
+                resources: ["jobs"],
+                description: "Activate jobs by type",
+                mutating: true,
+            },
+            {
+                verb: "resolve",
+                resource: "inc <key>",
+                resources: ["inc"],
+                description: "Resolve incident",
+                mutating: true,
+            },
+            {
+                verb: "publish",
+                resource: "msg <name>",
+                resources: ["msg"],
+                description: "Publish message",
+                mutating: true,
+            },
+            {
+                verb: "correlate",
+                resource: "msg <name>",
+                resources: ["msg"],
+                description: "Correlate message",
+                mutating: true,
+            },
+            {
+                verb: "deploy",
+                resource: "[path...]",
+                resources: [],
+                description: "Deploy BPMN/DMN/forms",
+                mutating: true,
+            },
+            {
+                verb: "run",
+                resource: "<path>",
+                resources: [],
+                description: "Deploy and start process",
+                mutating: true,
+            },
+            {
+                verb: "watch",
+                resource: "[path...]",
+                resources: [],
+                description: "Watch files for changes and auto-deploy",
+                mutating: false,
+            },
+            {
+                verb: "open",
+                resource: "<app>",
+                resources: ["operate", "tasklist", "modeler", "optimize"],
+                description: "Open Camunda web application in browser",
+                mutating: false,
+            },
+            {
+                verb: "add",
+                resource: "profile <name>",
+                resources: ["profile"],
+                description: "Add a profile",
+                mutating: false,
+            },
+            {
+                verb: "remove",
+                resource: "profile <name>",
+                resources: ["profile"],
+                description: "Remove a profile (alias: rm)",
+                mutating: false,
+            },
+            {
+                verb: "load",
+                resource: "plugin <name>",
+                resources: ["plugin"],
+                description: "Load a c8ctl plugin",
+                mutating: false,
+            },
+            {
+                verb: "unload",
+                resource: "plugin <name>",
+                resources: ["plugin"],
+                description: "Unload a c8ctl plugin",
+                mutating: false,
+            },
+            {
+                verb: "upgrade",
+                resource: "plugin <name>",
+                resources: ["plugin"],
+                description: "Upgrade a plugin",
+                mutating: false,
+            },
+            {
+                verb: "downgrade",
+                resource: "plugin <name> <version>",
+                resources: ["plugin"],
+                description: "Downgrade a plugin to a specific version",
+                mutating: false,
+            },
+            {
+                verb: "sync",
+                resource: "plugin",
+                resources: ["plugin"],
+                description: "Synchronize plugins",
+                mutating: false,
+            },
+            {
+                verb: "init",
+                resource: "plugin [name]",
+                resources: ["plugin"],
+                description: "Create a new plugin from TypeScript template",
+                mutating: false,
+            },
+            {
+                verb: "use",
+                resource: "profile|tenant",
+                resources: ["profile", "tenant"],
+                description: "Set active profile or tenant",
+                mutating: false,
+            },
+            {
+                verb: "output",
+                resource: "[json|text]",
+                resources: ["json", "text"],
+                description: "Show or set output format",
+                mutating: false,
+            },
+            {
+                verb: "completion",
+                resource: "bash|zsh|fish",
+                resources: ["bash", "zsh", "fish"],
+                description: "Generate shell completion script",
+                mutating: false,
+            },
+            {
+                verb: "mcp-proxy",
+                resource: "[mcp-path]",
+                resources: [],
+                description: "Start a STDIO to remote HTTP MCP proxy server",
+                mutating: false,
+            },
+            {
+                verb: "feedback",
+                resource: "",
+                resources: [],
+                description: "Open the feedback page to report issues or request features",
+                mutating: false,
+            },
+            {
+                verb: "help",
+                resource: "[command]",
+                resources: [],
+                description: "Show help",
+                mutating: false,
+            },
+            ...pluginCommandsInfo.map((cmd) => ({
+                verb: cmd.commandName,
+                resource: "",
+                resources: [],
+                description: cmd.description || "",
+                mutating: false,
                 examples: cmd.examples || [],
             })),
         ],
         resourceAliases: {
-            pi: 'process-instance(s)',
-            pd: 'process-definition(s)',
-            ut: 'user-task(s)',
-            inc: 'incident(s)',
-            msg: 'message',
-            vars: 'variable(s)',
-            auth: 'authorization(s)',
-            mr: 'mapping-rule(s)',
+            pi: "process-instance(s)",
+            pd: "process-definition(s)",
+            ut: "user-task(s)",
+            inc: "incident(s)",
+            msg: "message",
+            vars: "variable(s)",
+            auth: "authorization(s)",
+            mr: "mapping-rule(s)",
         },
         globalFlags: [
-            { flag: '--profile', type: 'string', description: 'Use specific profile for this command' },
-            { flag: '--sortBy', type: 'string', description: 'Sort list/search output by column name' },
-            { flag: '--asc', type: 'boolean', description: 'Sort in ascending order (default)' },
-            { flag: '--desc', type: 'boolean', description: 'Sort in descending order' },
-            { flag: '--limit', type: 'string', description: 'Maximum number of items to fetch (default: 1000000)' },
-            { flag: '--between', type: 'string', description: 'Filter by date range: <from>..<to> (YYYY-MM-DD or ISO 8601; open-ended: ..to or from..)' },
-            { flag: '--dateField', type: 'string', description: 'Date field to filter on with --between (default depends on resource)' },
-            { flag: '--state', type: 'string', description: 'Filter by state (ACTIVE, COMPLETED, etc.)' },
-            { flag: '--id', type: 'string', description: 'Process definition ID (alias for --bpmnProcessId)' },
-            { flag: '--verbose', type: 'boolean', description: 'Enable SDK trace logging and show full error details' },
-            { flag: '--version', type: 'string', short: '-v', description: 'Show version' },
-            { flag: '--help', type: 'boolean', short: '-h', description: 'Show help' },
+            {
+                flag: "--profile",
+                type: "string",
+                description: "Use specific profile for this command",
+            },
+            {
+                flag: "--sortBy",
+                type: "string",
+                description: "Sort list/search output by column name",
+            },
+            {
+                flag: "--asc",
+                type: "boolean",
+                description: "Sort in ascending order (default)",
+            },
+            {
+                flag: "--desc",
+                type: "boolean",
+                description: "Sort in descending order",
+            },
+            {
+                flag: "--limit",
+                type: "string",
+                description: "Maximum number of items to fetch (default: 1000000)",
+            },
+            {
+                flag: "--between",
+                type: "string",
+                description: "Filter by date range: <from>..<to> (YYYY-MM-DD or ISO 8601; open-ended: ..to or from..)",
+            },
+            {
+                flag: "--dateField",
+                type: "string",
+                description: "Date field to filter on with --between (default depends on resource)",
+            },
+            {
+                flag: "--state",
+                type: "string",
+                description: "Filter by state (ACTIVE, COMPLETED, etc.)",
+            },
+            {
+                flag: "--id",
+                type: "string",
+                description: "Process definition ID (alias for --bpmnProcessId)",
+            },
+            {
+                flag: "--verbose",
+                type: "boolean",
+                description: "Enable SDK trace logging and show full error details",
+            },
+            {
+                flag: "--version",
+                type: "string",
+                short: "-v",
+                description: "Show version",
+            },
+            {
+                flag: "--help",
+                type: "boolean",
+                short: "-h",
+                description: "Show help",
+            },
         ],
         searchFlags: [
-            { flag: '--bpmnProcessId', type: 'string', description: 'Filter by process definition ID' },
-            { flag: '--processDefinitionKey', type: 'string', description: 'Filter by process definition key' },
-            { flag: '--processInstanceKey', type: 'string', description: 'Filter by process instance key' },
-            { flag: '--parentProcessInstanceKey', type: 'string', description: 'Filter by parent process instance key' },
-            { flag: '--name', type: 'string', description: 'Filter by name (variables, process definitions); supports wildcards * and ?' },
-            { flag: '--key', type: 'string', description: 'Filter by key' },
-            { flag: '--assignee', type: 'string', description: 'Filter by assignee (user tasks)' },
-            { flag: '--elementId', type: 'string', description: 'Filter by element ID (user tasks)' },
-            { flag: '--errorType', type: 'string', description: 'Filter by error type (incidents)' },
-            { flag: '--errorMessage', type: 'string', description: 'Filter by error message (incidents); supports wildcards' },
-            { flag: '--type', type: 'string', description: 'Filter by type (jobs); supports wildcards' },
-            { flag: '--value', type: 'string', description: 'Filter by variable value' },
-            { flag: '--scopeKey', type: 'string', description: 'Filter by scope key (variables)' },
-            { flag: '--fullValue', type: 'boolean', description: 'Return full variable values (default: truncated)' },
-            { flag: '--iname', type: 'string', description: 'Case-insensitive --name filter (supports wildcards)' },
-            { flag: '--iid', type: 'string', description: 'Case-insensitive --bpmnProcessId filter' },
-            { flag: '--iassignee', type: 'string', description: 'Case-insensitive --assignee filter' },
-            { flag: '--ierrorMessage', type: 'string', description: 'Case-insensitive --errorMessage filter' },
-            { flag: '--itype', type: 'string', description: 'Case-insensitive --type filter' },
-            { flag: '--ivalue', type: 'string', description: 'Case-insensitive --value filter' },
-            { flag: '--username', type: 'string', description: 'Filter by username (users)' },
-            { flag: '--email', type: 'string', description: 'Filter by email (users)' },
-            { flag: '--roleId', type: 'string', description: 'Filter by role ID (roles)' },
-            { flag: '--groupId', type: 'string', description: 'Filter by group ID (groups)' },
-            { flag: '--ownerId', type: 'string', description: 'Filter by owner ID (authorizations)' },
-            { flag: '--ownerType', type: 'string', description: 'Filter by owner type (authorizations)' },
-            { flag: '--resourceType', type: 'string', description: 'Filter by resource type (authorizations)' },
-            { flag: '--resourceId', type: 'string', description: 'Filter by resource ID (authorizations)' },
-            { flag: '--claimName', type: 'string', description: 'Filter by claim name (mapping rules)' },
-            { flag: '--claimValue', type: 'string', description: 'Filter by claim value (mapping rules)' },
-            { flag: '--mappingRuleId', type: 'string', description: 'Filter by mapping rule ID (mapping rules)' },
+            {
+                flag: "--bpmnProcessId",
+                type: "string",
+                description: "Filter by process definition ID",
+            },
+            {
+                flag: "--processDefinitionKey",
+                type: "string",
+                description: "Filter by process definition key",
+            },
+            {
+                flag: "--processInstanceKey",
+                type: "string",
+                description: "Filter by process instance key",
+            },
+            {
+                flag: "--parentProcessInstanceKey",
+                type: "string",
+                description: "Filter by parent process instance key",
+            },
+            {
+                flag: "--name",
+                type: "string",
+                description: "Filter by name (variables, process definitions); supports wildcards * and ?",
+            },
+            { flag: "--key", type: "string", description: "Filter by key" },
+            {
+                flag: "--assignee",
+                type: "string",
+                description: "Filter by assignee (user tasks)",
+            },
+            {
+                flag: "--elementId",
+                type: "string",
+                description: "Filter by element ID (user tasks)",
+            },
+            {
+                flag: "--errorType",
+                type: "string",
+                description: "Filter by error type (incidents)",
+            },
+            {
+                flag: "--errorMessage",
+                type: "string",
+                description: "Filter by error message (incidents); supports wildcards",
+            },
+            {
+                flag: "--type",
+                type: "string",
+                description: "Filter by type (jobs); supports wildcards",
+            },
+            {
+                flag: "--value",
+                type: "string",
+                description: "Filter by variable value",
+            },
+            {
+                flag: "--scopeKey",
+                type: "string",
+                description: "Filter by scope key (variables)",
+            },
+            {
+                flag: "--fullValue",
+                type: "boolean",
+                description: "Return full variable values (default: truncated)",
+            },
+            {
+                flag: "--iname",
+                type: "string",
+                description: "Case-insensitive --name filter (supports wildcards)",
+            },
+            {
+                flag: "--iid",
+                type: "string",
+                description: "Case-insensitive --bpmnProcessId filter",
+            },
+            {
+                flag: "--iassignee",
+                type: "string",
+                description: "Case-insensitive --assignee filter",
+            },
+            {
+                flag: "--ierrorMessage",
+                type: "string",
+                description: "Case-insensitive --errorMessage filter",
+            },
+            {
+                flag: "--itype",
+                type: "string",
+                description: "Case-insensitive --type filter",
+            },
+            {
+                flag: "--ivalue",
+                type: "string",
+                description: "Case-insensitive --value filter",
+            },
+            {
+                flag: "--username",
+                type: "string",
+                description: "Filter by username (users)",
+            },
+            {
+                flag: "--email",
+                type: "string",
+                description: "Filter by email (users)",
+            },
+            {
+                flag: "--roleId",
+                type: "string",
+                description: "Filter by role ID (roles)",
+            },
+            {
+                flag: "--groupId",
+                type: "string",
+                description: "Filter by group ID (groups)",
+            },
+            {
+                flag: "--ownerId",
+                type: "string",
+                description: "Filter by owner ID (authorizations)",
+            },
+            {
+                flag: "--ownerType",
+                type: "string",
+                description: "Filter by owner type (authorizations)",
+            },
+            {
+                flag: "--resourceType",
+                type: "string",
+                description: "Filter by resource type (authorizations)",
+            },
+            {
+                flag: "--resourceId",
+                type: "string",
+                description: "Filter by resource ID (authorizations)",
+            },
+            {
+                flag: "--claimName",
+                type: "string",
+                description: "Filter by claim name (mapping rules)",
+            },
+            {
+                flag: "--claimValue",
+                type: "string",
+                description: "Filter by claim value (mapping rules)",
+            },
+            {
+                flag: "--mappingRuleId",
+                type: "string",
+                description: "Filter by mapping rule ID (mapping rules)",
+            },
         ],
         agentFlags: [
             {
-                flag: '--fields',
-                type: 'string',
-                description: 'Comma-separated list of output fields to include. Reduces context window size. Case-insensitive. Example: --fields Key,State,processDefinitionId',
-                appliesTo: 'all list/search/get commands',
+                flag: "--fields",
+                type: "string",
+                description: "Comma-separated list of output fields to include. Reduces context window size. Case-insensitive. Example: --fields Key,State,processDefinitionId",
+                appliesTo: "all list/search/get commands",
             },
             {
-                flag: '--dry-run',
-                type: 'boolean',
-                description: 'Preview the API request that would be sent without executing it. Emits { dryRun, command, method, url, body } as JSON. Always exits 0.',
-                appliesTo: 'mutating commands: create, cancel, deploy, complete, fail, activate, resolve, publish, correlate, delete, assign, unassign',
+                flag: "--dry-run",
+                type: "boolean",
+                description: "Preview the API request that would be sent without executing it. Emits { dryRun, command, method, url, body } as JSON. Always exits 0.",
+                appliesTo: "mutating commands: create, cancel, deploy, complete, fail, activate, resolve, publish, correlate, delete, assign, unassign",
             },
         ],
     };
@@ -132,8 +547,8 @@ function buildHelpJson(version, pluginCommandsInfo) {
  * Get package version
  */
 export function getVersion() {
-    const packagePath = join(__dirname, '../../package.json');
-    const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+    const packagePath = join(__dirname, "../../package.json");
+    const packageJson = JSON.parse(readFileSync(packagePath, "utf-8"));
     return packageJson.version;
 }
 /**
@@ -151,19 +566,19 @@ export function showHelp() {
     const version = getVersion();
     const pluginCommandsInfo = getPluginCommandsInfo();
     // JSON mode: emit structured command tree for machine consumption
-    if (logger.mode === 'json') {
+    if (logger.mode === "json") {
         logger.json(buildHelpJson(version, pluginCommandsInfo));
         return;
     }
-    let pluginSection = '';
+    let pluginSection = "";
     if (pluginCommandsInfo.length > 0) {
-        pluginSection = '\n\nPlugin Commands:';
+        pluginSection = "\n\nPlugin Commands:";
         for (const cmd of pluginCommandsInfo) {
-            const desc = cmd.description ? `  ${cmd.description}` : '';
+            const desc = cmd.description ? `  ${cmd.description}` : "";
             pluginSection += `\n  ${cmd.commandName.padEnd(20)}${desc}`;
         }
     }
-    let pluginExamples = '';
+    let pluginExamples = "";
     for (const cmd of pluginCommandsInfo) {
         for (const ex of cmd.examples ?? []) {
             pluginExamples += `\n  ${ex.command.padEnd(35)}${ex.description}`;
@@ -373,36 +788,36 @@ Feedback & Issues:
  */
 export function showVerbResources(verb) {
     const resources = {
-        list: 'process-instances (pi), process-definitions (pd), user-tasks (ut), incidents (inc), jobs, profiles, plugins, users, roles, groups, tenants, authorizations (auth), mapping-rules (mr)',
-        search: 'process-instances (pi), process-definitions (pd), user-tasks (ut), incidents (inc), jobs, variables (vars), users, roles, groups, tenants, authorizations (auth), mapping-rules (mr)',
-        get: 'process-instance (pi), process-definition (pd), incident (inc), topology, form, user, role, group, tenant, authorization (auth), mapping-rule (mr)',
-        create: 'process-instance (pi), user, role, group, tenant, authorization (auth), mapping-rule (mr)',
-        delete: 'user, role, group, tenant, authorization (auth), mapping-rule (mr)',
-        assign: 'role, user, group, mapping-rule',
-        unassign: 'role, user, group, mapping-rule',
-        complete: 'user-task (ut), job',
-        cancel: 'process-instance (pi)',
-        await: 'process-instance (pi)',
-        resolve: 'incident (inc)',
-        activate: 'jobs',
-        fail: 'job',
-        publish: 'message (msg)',
-        correlate: 'message (msg)',
-        add: 'profile',
-        remove: 'profile',
-        rm: 'profile',
-        load: 'plugin',
-        unload: 'plugin',
-        sync: 'plugin',
-        upgrade: 'plugin',
-        downgrade: 'plugin',
-        init: 'plugin',
-        use: 'profile, tenant',
-        which: 'profile',
-        output: 'json, text',
-        open: 'operate, tasklist, modeler, optimize',
-        completion: 'bash, zsh, fish',
-        help: 'list, get, create, complete, await, search, deploy, run, watch, open, cancel, resolve, fail, activate, publish, correlate, delete, assign, unassign, upgrade, downgrade, init, profiles, profile, plugin, plugins',
+        list: "process-instances (pi), process-definitions (pd), user-tasks (ut), incidents (inc), jobs, profiles, plugins, users, roles, groups, tenants, authorizations (auth), mapping-rules (mr)",
+        search: "process-instances (pi), process-definitions (pd), user-tasks (ut), incidents (inc), jobs, variables (vars), users, roles, groups, tenants, authorizations (auth), mapping-rules (mr)",
+        get: "process-instance (pi), process-definition (pd), incident (inc), topology, form, user, role, group, tenant, authorization (auth), mapping-rule (mr)",
+        create: "process-instance (pi), user, role, group, tenant, authorization (auth), mapping-rule (mr)",
+        delete: "user, role, group, tenant, authorization (auth), mapping-rule (mr)",
+        assign: "role, user, group, mapping-rule",
+        unassign: "role, user, group, mapping-rule",
+        complete: "user-task (ut), job",
+        cancel: "process-instance (pi)",
+        await: "process-instance (pi)",
+        resolve: "incident (inc)",
+        activate: "jobs",
+        fail: "job",
+        publish: "message (msg)",
+        correlate: "message (msg)",
+        add: "profile",
+        remove: "profile",
+        rm: "profile",
+        load: "plugin",
+        unload: "plugin",
+        sync: "plugin",
+        upgrade: "plugin",
+        downgrade: "plugin",
+        init: "plugin",
+        use: "profile, tenant",
+        which: "profile",
+        output: "json, text",
+        open: "operate, tasklist, modeler, optimize",
+        completion: "bash, zsh, fish",
+        help: "list, get, create, complete, await, search, deploy, run, watch, open, cancel, resolve, fail, activate, publish, correlate, delete, assign, unassign, upgrade, downgrade, init, profiles, profile, plugin, plugins",
     };
     const available = resources[verb];
     if (available) {
@@ -1556,14 +1971,17 @@ Examples:
 export function showCommandHelp(command) {
     const logger = getLogger();
     // JSON mode: emit structured help for machine/agent consumption
-    if (logger.mode === 'json') {
+    if (logger.mode === "json") {
         const version = getVersion();
         const pluginCommandsInfo = getPluginCommandsInfo();
         const allHelp = buildHelpJson(version, pluginCommandsInfo);
-        const commandEntry = allHelp.commands?.find((c) => c.verb === command);
+        const commandEntry = allHelp.commands.find((c) => c.verb === command);
         logger.json({
             command,
-            ...(commandEntry ?? { verb: command, description: `No detailed help available for: ${command}` }),
+            ...(commandEntry ?? {
+                verb: command,
+                description: `No detailed help available for: ${command}`,
+            }),
             globalFlags: allHelp.globalFlags,
             searchFlags: allHelp.searchFlags,
             agentFlags: allHelp.agentFlags,
@@ -1571,73 +1989,73 @@ export function showCommandHelp(command) {
         return;
     }
     switch (command) {
-        case 'list':
+        case "list":
             showListHelp();
             break;
-        case 'get':
+        case "get":
             showGetHelp();
             break;
-        case 'create':
+        case "create":
             showCreateHelp();
             break;
-        case 'complete':
+        case "complete":
             showCompleteHelp();
             break;
-        case 'await':
+        case "await":
             showAwaitHelp();
             break;
-        case 'mcp-proxy':
+        case "mcp-proxy":
             showMcpProxyHelp();
             break;
-        case 'search':
+        case "search":
             showSearchHelp();
             break;
-        case 'deploy':
+        case "deploy":
             showDeployHelp();
             break;
-        case 'run':
+        case "run":
             showRunHelp();
             break;
-        case 'watch':
-        case 'w':
+        case "watch":
+        case "w":
             showWatchHelp();
             break;
-        case 'open':
+        case "open":
             showOpenHelp();
             break;
-        case 'cancel':
+        case "cancel":
             showCancelHelp();
             break;
-        case 'resolve':
+        case "resolve":
             showResolveHelp();
             break;
-        case 'fail':
+        case "fail":
             showFailHelp();
             break;
-        case 'activate':
+        case "activate":
             showActivateHelp();
             break;
-        case 'publish':
+        case "publish":
             showPublishHelp();
             break;
-        case 'correlate':
+        case "correlate":
             showCorrelateHelp();
             break;
-        case 'delete':
+        case "delete":
             showDeleteHelp();
             break;
-        case 'assign':
+        case "assign":
             showAssignHelp();
             break;
-        case 'unassign':
+        case "unassign":
             showUnassignHelp();
             break;
-        case 'profiles':
-        case 'profile':
+        case "profiles":
+        case "profile":
             showProfilesHelp();
             break;
-        case 'plugin':
-        case 'plugins':
+        case "plugin":
+        case "plugins":
             showPluginHelp();
             break;
         default: