@camunda8/cli 2.7.0-alpha.9 → 2.8.0-alpha.1

package/dist/command-registry.d.ts

@@ -5,7 +5,7 @@
  * Consumers (help, completion, validation, dispatch) derive their
  * data from this registry instead of maintaining separate copies.
  */
-import { AuthorizationKey, IncidentKey, JobKey, ProcessDefinitionId, ProcessDefinitionKey, ProcessInstanceKey, TenantId, Username, UserTaskKey } from "@camunda8/orchestration-cluster-api";
+import { AuthorizationKey, ElementInstanceKey, IncidentKey, JobKey, ProcessDefinitionId, ProcessDefinitionKey, ProcessInstanceKey, TenantId, Username, UserTaskKey } from "@camunda8/orchestration-cluster-api";
 export interface FlagDef {
     /** Value type: "string" expects an argument, "boolean" is a presence flag. */
     type: "string" | "boolean";
@@ -27,10 +27,6 @@ export interface FlagDef {
      * erased to unknown here since FlagDef holds heterogeneous validators.
      */
     validate?: (value: string) => any;
-    /** When true, this flag appears in the top-level `c8ctl help` Flags section. */
-    showInTopLevelHelp?: boolean;
-    /** Context hint shown in the top-level help (e.g. "use with 'get pd'"). */
-    helpHint?: string;
     /** Rich description for agent-facing help (AI/programmatic consumers). Shown in Agent Flags section. */
     agentDescription?: string;
     /** Scope hint for agent-facing help (e.g. "all commands", "all list/search/get commands"). */
@@ -165,8 +161,6 @@ export declare const GET_PD_FLAGS: {
     readonly xml: {
         readonly type: "boolean";
         readonly description: "Get BPMN XML (process definitions)";
-        readonly showInTopLevelHelp: true;
-        readonly helpHint: "use with 'get pd'";
     };
 };
 export declare const GET_PD_POSITIONALS: readonly [{
@@ -1078,14 +1072,10 @@ export declare const COMMAND_REGISTRY: {
             variables: {
                 readonly type: "boolean";
                 readonly description: "Include variables in output";
-                readonly showInTopLevelHelp: true;
-                readonly helpHint: "use with 'get pi'";
             };
             userTask: {
                 readonly type: "boolean";
                 readonly description: "Get form for user task";
-                readonly showInTopLevelHelp: true;
-                readonly helpHint: "use with 'get form'";
             };
             ut: {
                 readonly type: "boolean";
@@ -1094,8 +1084,6 @@ export declare const COMMAND_REGISTRY: {
             processDefinition: {
                 readonly type: "boolean";
                 readonly description: "Get form for process definition";
-                readonly showInTopLevelHelp: true;
-                readonly helpHint: "use with 'get form'";
             };
             pd: {
                 readonly type: "boolean";
@@ -1104,8 +1092,6 @@ export declare const COMMAND_REGISTRY: {
             xml: {
                 readonly type: "boolean";
                 readonly description: "Get BPMN XML (process definitions)";
-                readonly showInTopLevelHelp: true;
-                readonly helpHint: "use with 'get pd'";
             };
         };
         resourceFlags: {
@@ -1113,16 +1099,12 @@ export declare const COMMAND_REGISTRY: {
                 readonly xml: {
                     readonly type: "boolean";
                     readonly description: "Get BPMN XML (process definitions)";
-                    readonly showInTopLevelHelp: true;
-                    readonly helpHint: "use with 'get pd'";
                 };
             };
             form: {
                 readonly userTask: {
                     readonly type: "boolean";
                     readonly description: "Get form for user task";
-                    readonly showInTopLevelHelp: true;
-                    readonly helpHint: "use with 'get form'";
                 };
                 readonly ut: {
                     readonly type: "boolean";
@@ -1131,8 +1113,6 @@ export declare const COMMAND_REGISTRY: {
                 readonly processDefinition: {
                     readonly type: "boolean";
                     readonly description: "Get form for process definition";
-                    readonly showInTopLevelHelp: true;
-                    readonly helpHint: "use with 'get form'";
                 };
                 readonly pd: {
                     readonly type: "boolean";
@@ -1143,8 +1123,6 @@ export declare const COMMAND_REGISTRY: {
                 readonly variables: {
                     readonly type: "boolean";
                     readonly description: "Include variables in output";
-                    readonly showInTopLevelHelp: true;
-                    readonly helpHint: "use with 'get pi'";
                 };
             };
         };
@@ -1218,8 +1196,6 @@ export declare const COMMAND_REGISTRY: {
             id: {
                 type: "string";
                 description: string;
-                showInTopLevelHelp: true;
-                helpHint: string;
             };
             bpmnProcessId: {
                 type: "string";
@@ -1232,19 +1208,14 @@ export declare const COMMAND_REGISTRY: {
             awaitCompletion: {
                 type: "boolean";
                 description: string;
-                showInTopLevelHelp: true;
-                helpHint: string;
             };
             fetchVariables: {
                 type: "boolean";
                 description: string;
-                showInTopLevelHelp: true;
             };
             requestTimeout: {
                 type: "string";
                 description: string;
-                showInTopLevelHelp: true;
-                helpHint: string;
             };
             username: {
                 type: "string";
@@ -1276,32 +1247,6 @@ export declare const COMMAND_REGISTRY: {
                 description: string;
                 validate: typeof TenantId.assumeExists;
             };
-            ownerId: {
-                type: "string";
-                description: string;
-                required: true;
-            };
-            ownerType: {
-                type: "string";
-                description: string;
-                required: true;
-            };
-            resourceType: {
-                type: "string";
-                description: string;
-                required: true;
-            };
-            resourceId: {
-                type: "string";
-                description: string;
-                required: true;
-            };
-            permissions: {
-                type: "string";
-                description: string;
-                required: true;
-                csv: true;
-            };
             mappingRuleId: {
                 type: "string";
                 description: string;
@@ -1315,6 +1260,36 @@ export declare const COMMAND_REGISTRY: {
                 description: string;
             };
         };
+        resourceFlags: {
+            authorization: {
+                ownerId: {
+                    type: "string";
+                    description: string;
+                    required: true;
+                };
+                ownerType: {
+                    type: "string";
+                    description: string;
+                    required: true;
+                };
+                resourceType: {
+                    type: "string";
+                    description: string;
+                    required: true;
+                };
+                resourceId: {
+                    type: "string";
+                    description: string;
+                    required: true;
+                };
+                permissions: {
+                    type: "string";
+                    description: string;
+                    required: true;
+                    csv: true;
+                };
+            };
+        };
     };
     delete: {
         description: string;
@@ -1578,6 +1553,38 @@ export declare const COMMAND_REGISTRY: {
             }];
         };
     };
+    set: {
+        description: string;
+        helpDescription: string;
+        helpResource: string;
+        hasDetailedHelp: true;
+        helpFooterLabel: string;
+        mutating: true;
+        requiresResource: true;
+        helpExamples: {
+            command: string;
+            description: string;
+        }[];
+        resources: string[];
+        flags: {
+            variables: {
+                type: "string";
+                description: string;
+                required: true;
+            };
+            local: {
+                type: "boolean";
+                description: string;
+            };
+        };
+        resourcePositionals: {
+            variable: readonly [{
+                readonly name: "key";
+                readonly required: true;
+                readonly validate: typeof ElementInstanceKey.assumeExists;
+            }];
+        };
+    };
     deploy: {
         description: string;
         helpDescription: string;
@@ -1591,7 +1598,12 @@ export declare const COMMAND_REGISTRY: {
             description: string;
         }[];
         resources: never[];
-        flags: {};
+        flags: {
+            force: {
+                type: "boolean";
+                description: string;
+            };
+        };
     };
     run: {
         description: string;
@@ -1611,6 +1623,10 @@ export declare const COMMAND_REGISTRY: {
                 type: "string";
                 description: string;
             };
+            force: {
+                type: "boolean";
+                description: string;
+            };
         };
     };
     assign: {
@@ -1733,6 +1749,10 @@ export declare const COMMAND_REGISTRY: {
                 type: "boolean";
                 description: string;
             };
+            extensions: {
+                type: "string";
+                description: string;
+            };
         };
         aliases: string[];
     };
@@ -1845,8 +1865,6 @@ export declare const COMMAND_REGISTRY: {
             from: {
                 type: "string";
                 description: string;
-                showInTopLevelHelp: true;
-                helpHint: string;
             };
         };
         resourcePositionals: {
@@ -1994,7 +2012,12 @@ export declare const COMMAND_REGISTRY: {
             description: string;
         }[];
         resources: string[];
-        flags: {};
+        flags: {
+            shell: {
+                type: "string";
+                description: string;
+            };
+        };
         resourceFlags: {
             install: {
                 shell: {
@@ -2064,7 +2087,8 @@ export declare function resolveAlias(resource: string): string;
  */
 export declare function getCommandDef(verb: string): CommandDef | undefined;
 /**
- * Get all flags accepted for a given verb, including global flags.
+ * Get all flags accepted for a given verb, including global flags and any
+ * resource-scoped flags declared under `resourceFlags`.
  */
 export declare function getAcceptedFlags(verb: string): Record<string, FlagDef> | undefined;
 /**

package/dist/command-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+/BS,CAAC;AAEvC,yEAAyE;AACzE,MAAM,MAAM,IAAI,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAIjD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAe9C,CAAC;AAEL;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CASlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAIrC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAC/C,MAAM,EACN;IAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAC9C,CAwCA"}
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8jCS,CAAC;AAEvC,yEAAyE;AACzE,MAAM,MAAM,IAAI,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAIjD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAe9C,CAAC;AAEL;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CASlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAUrC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAC/C,MAAM,EACN;IAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAC9C,CAwCA"}

package/dist/command-registry.js

@@ -5,7 +5,7 @@
  * Consumers (help, completion, validation, dispatch) derive their
  * data from this registry instead of maintaining separate copies.
  */
-import { AuthorizationKey, IncidentKey, JobKey, ProcessDefinitionId, ProcessDefinitionKey, ProcessInstanceKey, TenantId, Username, UserTaskKey, } from "@camunda8/orchestration-cluster-api";
+import { AuthorizationKey, ElementInstanceKey, IncidentKey, JobKey, ProcessDefinitionId, ProcessDefinitionKey, ProcessInstanceKey, TenantId, Username, UserTaskKey, } from "@camunda8/orchestration-cluster-api";
 // ─── Resource Aliases ────────────────────────────────────────────────────────
 /**
  * Maps short/plural resource names to their canonical singular form.
@@ -23,6 +23,7 @@ export const RESOURCE_ALIASES = {
     msg: "message",
     vars: "variable",
     variables: "variable",
+    var: "variable",
     profile: "profile",
     profiles: "profile",
     plugin: "plugin",
@@ -306,16 +307,12 @@ export const GET_PD_FLAGS = {
     xml: {
         type: "boolean",
         description: "Get BPMN XML (process definitions)",
-        showInTopLevelHelp: true,
-        helpHint: "use with 'get pd'",
     },
 };
 const GET_FORM_FLAGS = {
     userTask: {
         type: "boolean",
         description: "Get form for user task",
-        showInTopLevelHelp: true,
-        helpHint: "use with 'get form'",
     },
     ut: {
         type: "boolean",
@@ -324,8 +321,6 @@ const GET_FORM_FLAGS = {
     processDefinition: {
         type: "boolean",
         description: "Get form for process definition",
-        showInTopLevelHelp: true,
-        helpHint: "use with 'get form'",
     },
     pd: {
         type: "boolean",
@@ -336,8 +331,6 @@ const GET_PI_FLAGS = {
     variables: {
         type: "boolean",
         description: "Include variables in output",
-        showInTopLevelHelp: true,
-        helpHint: "use with 'get pi'",
     },
 };
 // ─── Per-resource get positionals ────────────────────────────────────────────
@@ -669,8 +662,6 @@ export const COMMAND_REGISTRY = {
             id: {
                 type: "string",
                 description: "Process definition ID (alias for --processDefinitionId)",
-                showInTopLevelHelp: true,
-                helpHint: "alias for --bpmnProcessId",
             },
             bpmnProcessId: {
                 type: "string",
@@ -680,19 +671,14 @@ export const COMMAND_REGISTRY = {
             awaitCompletion: {
                 type: "boolean",
                 description: "Wait for process to complete",
-                showInTopLevelHelp: true,
-                helpHint: "use with 'create pi'",
             },
             fetchVariables: {
                 type: "boolean",
                 description: "Fetch result variables on completion",
-                showInTopLevelHelp: true,
             },
             requestTimeout: {
                 type: "string",
                 description: "Await timeout in milliseconds",
-                showInTopLevelHelp: true,
-                helpHint: "use with --awaitCompletion",
             },
             // Identity user
             username: {
@@ -713,33 +699,6 @@ export const COMMAND_REGISTRY = {
                 description: "Tenant ID",
                 validate: TenantId.assumeExists,
             },
-            // Identity authorization
-            ownerId: {
-                type: "string",
-                description: "Authorization owner ID",
-                required: true,
-            },
-            ownerType: {
-                type: "string",
-                description: "Authorization owner type",
-                required: true,
-            },
-            resourceType: {
-                type: "string",
-                description: "Authorization resource type",
-                required: true,
-            },
-            resourceId: {
-                type: "string",
-                description: "Authorization resource ID",
-                required: true,
-            },
-            permissions: {
-                type: "string",
-                description: "Comma-separated permissions",
-                required: true,
-                csv: true,
-            },
             // Identity mapping rule
             mappingRuleId: {
                 type: "string",
@@ -748,6 +707,40 @@ export const COMMAND_REGISTRY = {
             claimName: { type: "string", description: "Claim name" },
             claimValue: { type: "string", description: "Claim value" },
         },
+        // Resource-scoped flags: the authorization-specific flags below are
+        // only required when creating an authorization. Declaring them at the
+        // verb level would force every `create <resource>` invocation to
+        // supply them (see #308 — required-flag enforcement).
+        resourceFlags: {
+            authorization: {
+                ownerId: {
+                    type: "string",
+                    description: "Authorization owner ID",
+                    required: true,
+                },
+                ownerType: {
+                    type: "string",
+                    description: "Authorization owner type",
+                    required: true,
+                },
+                resourceType: {
+                    type: "string",
+                    description: "Authorization resource type",
+                    required: true,
+                },
+                resourceId: {
+                    type: "string",
+                    description: "Authorization resource ID",
+                    required: true,
+                },
+                permissions: {
+                    type: "string",
+                    description: "Comma-separated permissions",
+                    required: true,
+                    csv: true,
+                },
+            },
+        },
     },
     delete: {
         description: "Delete resource",
@@ -971,9 +964,49 @@ export const COMMAND_REGISTRY = {
             ],
         },
     },
+    set: {
+        description: "Set variables on an element instance",
+        helpDescription: "Set variables on an element instance (process instance or flow element scope). Variables are propagated to the outermost scope by default; use --local to restrict to the specified scope.",
+        helpResource: "variable <key>",
+        hasDetailedHelp: true,
+        helpFooterLabel: "Show set command with all flags",
+        mutating: true,
+        requiresResource: true,
+        helpExamples: [
+            {
+                command: 'c8ctl set variable 2251799813685249 --variables=\'{"status":"approved"}\'',
+                description: "Set variables on a process instance",
+            },
+            {
+                command: "c8ctl set variable 2251799813685249 --variables='{\"x\":1}' --local",
+                description: "Set variables in local scope only",
+            },
+        ],
+        resources: ["variable"],
+        flags: {
+            variables: {
+                type: "string",
+                description: "JSON object of variables to set (required)",
+                required: true,
+            },
+            local: {
+                type: "boolean",
+                description: "Set variables in local scope only (default: propagate to outermost scope)",
+            },
+        },
+        resourcePositionals: {
+            variable: [
+                {
+                    name: "key",
+                    required: true,
+                    validate: ElementInstanceKey.assumeExists,
+                },
+            ],
+        },
+    },
     deploy: {
-        description: "Deploy BPMN/DMN/forms",
-        helpDescription: "Deploy BPMN, DMN, and form files (auto-discovers deployable files)",
+        description: "Deploy resources",
+        helpDescription: "Deploy files to Camunda (auto-discovers deployable files in directories)",
         helpResource: "[path...]",
         hasDetailedHelp: true,
         helpFooterLabel: "Show deploy command with all flags",
@@ -986,7 +1019,12 @@ export const COMMAND_REGISTRY = {
             },
         ],
         resources: [],
-        flags: {},
+        flags: {
+            force: {
+                type: "boolean",
+                description: "Deploy any file type, ignoring the default extension allow-list",
+            },
+        },
     },
     run: {
         description: "Deploy and start process",
@@ -1005,6 +1043,10 @@ export const COMMAND_REGISTRY = {
         resources: [],
         flags: {
             variables: { type: "string", description: "JSON variables" },
+            force: {
+                type: "boolean",
+                description: "Deploy any file type, ignoring the default extension allow-list",
+            },
         },
     },
     // ── Assignment commands ────────────────────────────────────────────────
@@ -1057,7 +1099,7 @@ export const COMMAND_REGISTRY = {
     // ── Operational commands ───────────────────────────────────────────────
     watch: {
         description: "Watch files for changes and auto-deploy",
-        helpDescription: "Watch files for changes and auto-deploy (BPMN, DMN, forms)",
+        helpDescription: "Watch files for changes and auto-deploy",
         helpResource: "[path...]",
         hasDetailedHelp: true,
         helpFooterLabel: "Show watch command with all flags",
@@ -1075,6 +1117,10 @@ export const COMMAND_REGISTRY = {
                 type: "boolean",
                 description: "Continue watching after all deployment errors",
             },
+            extensions: {
+                type: "string",
+                description: "Comma-separated list of file extensions to watch (e.g. .bpmn,.dmn,.form)",
+            },
         },
         aliases: ["w"],
     },
@@ -1160,8 +1206,6 @@ export const COMMAND_REGISTRY = {
             from: {
                 type: "string",
                 description: "Load plugin from URL",
-                showInTopLevelHelp: true,
-                helpHint: "use with 'load plugin'",
             },
         },
         resourcePositionals: {
@@ -1315,7 +1359,12 @@ export const COMMAND_REGISTRY = {
             },
         ],
         resources: ["bash", "zsh", "fish", "install"],
-        flags: {},
+        flags: {
+            shell: {
+                type: "string",
+                description: "Shell to install completions for (bash, zsh, fish)",
+            },
+        },
         resourceFlags: {
             install: {
                 shell: {
@@ -1410,13 +1459,20 @@ export function getCommandDef(verb) {
         : undefined;
 }
 /**
- * Get all flags accepted for a given verb, including global flags.
+ * Get all flags accepted for a given verb, including global flags and any
+ * resource-scoped flags declared under `resourceFlags`.
  */
 export function getAcceptedFlags(verb) {
     const def = getCommandDef(verb);
     if (!def)
         return undefined;
-    return { ...GLOBAL_FLAGS, ...def.flags };
+    const merged = { ...GLOBAL_FLAGS, ...def.flags };
+    if (def.resourceFlags) {
+        for (const rFlags of Object.values(def.resourceFlags)) {
+            Object.assign(merged, rFlags);
+        }
+    }
+    return merged;
 }
 /**
  * Check whether a verb×resource combination is valid.