@camunda8/cli 2.8.0-alpha.9 → 3.0.0

package/dist/default-plugins/element-template/AGENTS.md

@@ -0,0 +1,65 @@
+# AGENTS.md — `element-template` plugin
+
+Read [docs/design.md](./docs/design.md) before changing this plugin. It
+covers the **why**: vendor bundle, marketplace endpoint choice, cache
+strategy (`upstreamRef`-keyed dedup), lazy bootstrap, and semver-based
+version resolution.
+
+## Where things live
+
+| File | Purpose |
+| --- | --- |
+| `c8ctl-plugin.ts` | Plugin API (metadata + commands export), subcommand dispatch table |
+| `commands/<name>.ts` | One file per subcommand: `apply`, `get`, `get-properties`, `info`, `search`, `sync` |
+| `template-ref.ts` | `parseTemplateRef`, `readBpmnInput`, `getExecutionPlatformVersion`, `resolveOotbTemplate`, `loadTemplate` |
+| `marketplace.ts` | Cache I/O, `/ootb-connectors` fetch, sync, search, version resolution |
+| `helpers.ts` | `--set` parsing, file/URL fetch, glob → regex, multi-binding lookup, condition warnings |
+| `vendor-src/bundle-entry.js` | esbuild entry — re-exports `Modeler`, `CloudElementTemplatesCoreModule`, `ZeebeModdleExtension` |
+
+## Things to know before editing
+
+- **Touching anything bpmn-js related requires `npm run build:vendor`.**
+  The plugin loads `dist/vendor/bpmn-element-templates.cjs`, not the
+  source. `vendor-src/bundle-entry.js` is the only entry point that
+  esbuild bundles.
+- **Cache file shape mirrors Desktop Modeler's
+  `.camunda-connector-templates.json`.** Don't change the format
+  without reason — `metadata.upstreamRef` is the dedup key for
+  incremental sync.
+- **`get` deliberately does NOT auto-bootstrap.** Bootstrap progress
+  goes through `logger.info`, which writes to stdout in text mode —
+  that would corrupt `get <id> > template.json` redirects. Cache miss
+  surfaces as an explicit error pointing at `sync`. Don't add a
+  bootstrap call to `getSubcommand` without changing the logger story
+  first.
+- **Path/URL apply paths must not trigger the index bootstrap.**
+  Detection happens in `parseTemplateRef()` in `template-ref.ts`
+  before any cache call.
+- **JSON output uses element-templates schema field names verbatim.**
+  No invented derivations — `binding`, `optional`, `value`, `condition`,
+  `group` (id), `elementType: { value }`, `engines: { camunda }`. The
+  only c8ctl-internal extension is `metadata.upstreamRef`, which `get`
+  strips before serializing.
+- **Property dedup is by object reference, not by `binding.name|type`.**
+  Template authors sometimes attach two properties with the same binding
+  name + type but different `condition` clauses (operation-conditional
+  duplicates); the engine drops inactive ones at apply time. The
+  WeakMap-based `sourceByDetail` side table in `loadTemplate` preserves
+  this identity so `get-properties` doesn't collapse them and `--set`
+  writes to all matching duplicates.
+- **Marketplace endpoint URL is overridable via
+  `C8CTL_OOTB_ELEMENT_TEMPLATES_URL`** — useful for tests against a
+  local fixture server.
+
+## Testing
+
+```bash
+npm run build:vendor && node --experimental-strip-types --test tests/unit/element-template.test.ts
+```
+
+Smoke-test against the live marketplace (writes to a throwaway dir):
+
+```bash
+C8CTL_DATA_DIR=/tmp/c8ctl-smoke node --experimental-strip-types src/index.ts \
+  element-template search "AWS S3"
+```

package/dist/default-plugins/element-template/README.md

@@ -0,0 +1,331 @@
+# c8ctl-plugin-element-template
+
+A default [c8ctl](https://github.com/camunda/c8ctl) plugin for applying
+Camunda element templates to BPMN diagrams, inspecting their properties,
+and exporting raw template JSON. Supports out-of-the-box (OOTB)
+connector templates by id (downloaded on demand from the Camunda
+marketplace), plus arbitrary local paths and URLs.
+
+## Subcommands
+
+The verb is organized as a workflow: discover → inspect → act → export → maintain.
+
+| Subcommand | Purpose |
+|------------|---------|
+| `search <query>` | Find OOTB templates by keyword (deprecated entries hidden). |
+| `info <template>` | Show the template metadata card (id, version, applies-to, engines, docs). |
+| `get-properties <template> [<name>...]` | List settable properties — condensed by default, `--detailed` for full cards. |
+| `apply <template> <element-id> [<file.bpmn>]` | Apply a template to a BPMN element (in place, or to stdout). |
+| `get <template>` | Print the raw template JSON to stdout (pipe-friendly). |
+| `sync` | Refresh the local OOTB template cache. |
+
+`<template>` is a local path, an `https://` URL, or an OOTB template id
+(optionally pinned: `<id>@<version>`). GitHub blob URLs are
+auto-rewritten to raw content URLs — paste straight from the address bar.
+
+## Usage
+
+```bash
+# Search OOTB templates
+c8ctl element-template search "AWS S3"
+c8ctl element-template search "http"
+c8ctl element-template search "AWS" --limit 5      # cap results (default 20)
+
+# Show the template metadata card
+c8ctl element-template info io.camunda.connectors.HttpJson.v2
+
+# List every settable property as a condensed name + description row
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2
+
+# Filter by name (positional, supports shell-style globs — quote them)
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 url method
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 'authentication.*'
+
+# Filter by group id (repeatable; ids come from `get-properties` group headings)
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 \
+  --group authentication --group endpoint
+
+# Drill into specific properties as full detail cards
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 \
+  --detailed authentication.token url
+
+# Apply by OOTB id — version is auto-resolved against the BPMN's
+# modeler:executionPlatformVersion (highest compatible version wins)
+c8ctl element-template apply io.camunda.connectors.HttpJson.v2 \
+  ServiceTask_1 process.bpmn
+
+# Pin a specific version
+c8ctl element-template apply io.camunda.connectors.HttpJson.v2@13 \
+  ServiceTask_1 process.bpmn
+
+# Apply from a local file or URL
+c8ctl element-template apply ./templates/my-task.json ServiceTask_1 process.bpmn
+c8ctl element-template apply https://example.com/template.json ServiceTask_1 process.bpmn
+
+# GitHub blob URLs are auto-rewritten to the raw content URL
+c8ctl element-template apply \
+  https://github.com/camunda/connectors/blob/main/connectors/http/rest/element-templates/http-json-connector.json \
+  ServiceTask_1 process.bpmn
+
+# Modify the BPMN file in place (default writes the result to stdout)
+c8ctl element-template apply -i io.camunda.connectors.HttpJson.v2 \
+  ServiceTask_1 process.bpmn
+
+# Stream BPMN through stdin, get the modified BPMN on stdout. Works
+# with slow upstream producers (lint, apply chained together, etc.) —
+# stdin is consumed asynchronously and waits for the writer to finish.
+cat process.bpmn | c8ctl element-template apply io.camunda.connectors.HttpJson.v2 ServiceTask_1 \
+  > out.bpmn
+
+# Chain with bpmn lint
+c8ctl element-template apply io.camunda.connectors.HttpJson.v2 ServiceTask_1 process.bpmn \
+  | c8ctl bpmn lint
+
+# Save a template's raw JSON to a file (works for ids, URLs, and local paths)
+c8ctl element-template get io.camunda.connectors.HttpJson.v2 > template.json
+c8ctl element-template get https://example.com/template.json > template.json
+c8ctl element-template get ./template.json > copy.json    # passthrough — bytes preserved
+c8ctl element-template get io.camunda.connectors.HttpJson.v2 --no-icon  # drop the base64 icon blob
+
+# Refresh the local OOTB template cache
+c8ctl element-template sync
+c8ctl element-template sync --prune    # also drop entries no longer in the index
+```
+
+## Inspecting a template
+
+`info` and `get-properties` separate the two questions an agent or human
+typically asks of a template — *what is this thing?* (metadata) and
+*what knobs can I turn?* (properties).
+
+### `info` — metadata card
+
+```bash
+c8ctl element-template info io.camunda.connectors.HttpJson.v2
+```
+
+```
+REST Outbound Connector
+  ID           io.camunda.connectors.HttpJson.v2
+  Version      13  (latest; @<n> to pin)
+  Applies to   bpmn:Task → bpmn:ServiceTask
+  Engines      ^8.9
+  Description  Invoke REST API
+  Docs         https://docs.camunda.io/docs/components/connectors/protocol/rest/
+
+For settable properties, run:
+  c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2
+```
+
+When you give an OOTB id without `@<version>`, the auto-resolved version
+is annotated with a dim `(latest; @<n> to pin)` parenthetical so you
+know what was picked.
+
+### `get-properties` — condensed listing
+
+The default density is one row per property: name + description, grouped
+by template group. Group headings include the `id` for use with `--group`.
+
+```bash
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2
+```
+
+```
+Showing 28 of 28 properties.
+
+Authentication (authentication)
+  authentication.type                  Choose the authentication type. Select 'None' if no authentication is necessary
+  authentication.token                 Bearer token
+  ...
+
+HTTP endpoint (endpoint)
+  method                               Method
+  url                                  URL
+  ...
+
+Filter by name (supports globs):
+  c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 'auth*' url
+For full details on each property:
+  c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 --detailed
+```
+
+Positional names filter the listing — pass one or more names, with
+optional shell-style globs. `--group <id>` (repeatable) intersects with
+the name filter. Both filters error on no-match instead of silently
+empty so typos surface.
+
+### `get-properties --detailed` — full cards
+
+Same filter semantics, but every property is rendered as a keyed card
+with its full descriptor:
+
+```bash
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 \
+  --detailed authentication.token
+```
+
+```
+Showing 1 of 28 properties.
+
+authentication.token (Authentication)
+  Id           authentication.token
+  Type         String
+  Required     yes
+  FEEL         optional
+  Binding      zeebe:input
+  Description  Bearer token
+  Active when  authentication.type = "bearer"
+```
+
+Cards surface everything `--set` needs to pick a value — type, required,
+FEEL support, binding, full active-when expression, pattern + error
+message, and the choice list for dropdowns.
+
+### Machine-readable output
+
+Switch the session into JSON mode and the same commands emit shapes
+that mirror the text output (and use upstream
+[element-templates JSON schema](https://unpkg.com/@camunda/zeebe-element-templates-json-schema)
+field names verbatim — no invented names like `bindingType` or
+`required`):
+
+```bash
+c8ctl output json
+c8ctl element-template info io.camunda.connectors.HttpJson.v2
+# → {"name":"REST Outbound Connector","id":"io.camunda.connectors.HttpJson.v2",
+#    "version":13,"description":"Invoke REST API",
+#    "documentationRef":"https://docs.camunda.io/...",
+#    "appliesTo":["bpmn:Task"],"elementType":{"value":"bpmn:ServiceTask"},
+#    "engines":{"camunda":"^8.9"}}
+
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 url
+# → {"count":1,"total":28,"groups":[{"id":"authentication","label":"Authentication"}, ...],
+#    "properties":[{"id":"url","binding":{"name":"url","type":"zeebe:input"},
+#      "label":"URL","group":"endpoint"}]}
+
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 \
+  --detailed authentication.token
+# → {"count":1,"total":28,"groups":[...],
+#    "properties":[{"id":"authentication.token",
+#      "binding":{"name":"authentication.token","type":"zeebe:input"},
+#      "type":"String","optional":false,"feel":"optional","group":"authentication",
+#      "condition":{"property":"authentication.type","equals":"bearer","type":"simple"},
+#      "label":"Bearer token","constraints":{"notEmpty":true}}]}
+```
+
+`get-properties` JSON keeps the same `{ count, total, groups, properties }`
+envelope across both density modes — `count` is rendered properties,
+`total` is the unfiltered count, `groups` is the full group table so
+consumers can resolve any group id (not just those of rendered properties).
+
+## Setting input mappings with `--set`
+
+`apply` supports repeatable `--set key=value` flags to populate
+template properties at apply time — input mappings, output mappings,
+task headers, task definitions, and arbitrary template properties.
+Use it to wire up a connector in one shot from the CLI:
+
+```bash
+# Apply the HTTP JSON connector and configure the request inline
+c8ctl element-template apply -i io.camunda.connectors.HttpJson.v2 \
+  ServiceTask_1 process.bpmn \
+  --set authentication.type=noAuth \
+  --set method=POST \
+  --set url=https://api.example.com/v1/orders \
+  --set body='={ "orderId": orderId, "amount": 42 }' \
+  --set resultExpression='={ "status": response.statusCode }'
+```
+
+### How `--set` resolves a name
+
+`key` is matched against the template's settable property
+**binding names** (the field a template property writes to in the
+resulting BPMN). Discover them with `get-properties`, then pick a value
+using the badges on the detail card (Required, FEEL, Default, Active when).
+
+### Disambiguation prefixes
+
+When the same name lives on multiple binding types (e.g. an `input` and
+a `header` both called `correlationKey`), prefix the key with the
+binding type:
+
+| Prefix              | Binding type           |
+|---------------------|------------------------|
+| `input:`            | `zeebe:input`          |
+| `output:`           | `zeebe:output`         |
+| `header:`           | `zeebe:taskHeader`     |
+| `property:`         | `zeebe:property`       |
+| `taskDefinition:`   | `zeebe:taskDefinition` |
+
+```bash
+--set input:correlationKey='=order.id'
+--set header:correlationKey=staticHeaderValue
+```
+
+The plugin errors with the list of qualified names when a bare key is
+ambiguous, and with the list of available property names when the key
+is unknown.
+
+When two settable properties share the same binding name **and** binding
+type but differ by `condition` (template authors use this for
+operation-conditional duplicates), `--set` writes to all of them — the
+engine drops the inactive duplicates at runtime.
+
+### Conditional properties
+
+Templates often hide properties behind a "show this only when X" rule
+(e.g. `authentication.username` is conditional on
+`authentication.type=basic`). `--set` first sets the dependency, then
+follow-up properties:
+
+```bash
+c8ctl element-template apply io.camunda.connectors.HttpJson.v2 \
+  ServiceTask_1 process.bpmn \
+  --set authentication.type=basic \
+  --set authentication.username=alice \
+  --set authentication.password=secret \
+  --set method=GET \
+  --set url=https://api.example.com/me
+```
+
+If a `--set` targets a property whose condition is unmet, you'll get a
+warning at the end (the property won't be applied).
+
+## How OOTB templates are resolved
+
+1. **Index**: fetched from the Camunda marketplace
+   (`https://marketplace.cloud.camunda.io/api/v1/ootb-connectors`) — the
+   same source Desktop Modeler uses. Override via
+   `C8CTL_OOTB_ELEMENT_TEMPLATES_URL` for testing.
+2. **First use** of `search`, `info`, `get-properties`, `apply`, or
+   `sync`: a one-shot bootstrap downloads ~459 templates with visible
+   progress; per-template failures are logged but don't abort the run.
+3. **`get` does NOT auto-bootstrap.** It exits with a hint to run
+   `sync` first if the cache is missing — bootstrap progress would
+   otherwise corrupt redirected stdout (`get <id> > template.json`).
+4. **Local file or URL** template args (paths containing `/` or `\`,
+   starting with `.`, ending in `.json`, or starting with `http(s)://`)
+   skip the index entirely.
+5. **Version selection** uses `semver.satisfies` against the BPMN's
+   `modeler:executionPlatformVersion` and each template's
+   `engines.camunda` constraint. Without `@<version>`, the highest
+   compatible version wins.
+6. **Stale cache** (>7 days) prints a hint to run `sync`. No automatic
+   refresh — `sync` only fetches refs not already cached (commit-pinned
+   URLs make incremental sync free).
+
+### Cache locations
+
+| Platform | Path |
+|----------|------|
+| macOS    | `~/Library/Application Support/c8ctl/element-templates/` |
+| Linux    | `${XDG_CONFIG_HOME:-~/.config}/c8ctl/element-templates/` |
+| Windows  | `%APPDATA%\c8ctl\element-templates\` |
+
+Set `C8CTL_DATA_DIR` to override.
+
+## Design
+
+See [`docs/design.md`](./docs/design.md) for the full reasoning behind
+the marketplace endpoint choice, the vendor bundle, the cache strategy
+(mirrored from Desktop Modeler), and version resolution.

package/dist/default-plugins/element-template/c8ctl-plugin.js

@@ -0,0 +1,247 @@
+/**
+ * c8ctl-plugin-element-template
+ *
+ * Apply Camunda element templates to BPMN elements and inspect template properties.
+ *
+ * Usage:
+ *   c8ctl element-template apply <template> <element-id> [<file.bpmn>] [--in-place] [--set key=value]
+ *   c8ctl element-template info <template>
+ *   c8ctl element-template get-properties <template> [<name>...] [--group <id>] [--detailed]
+ *   c8ctl element-template get <template>
+ *   c8ctl element-template search <query>
+ *   c8ctl element-template sync [--prune]
+ *
+ * <template> can be a local path, an https:// URL, or an OOTB template id
+ * (optionally pinned, e.g. io.camunda.connectors.HttpJson.v2@13).
+ * GitHub blob URLs are auto-rewritten to raw.githubusercontent.com.
+ */
+import { applySubcommand } from "./commands/apply.js";
+import { getSubcommand } from "./commands/get.js";
+import { getPropertiesSubcommand } from "./commands/get-properties.js";
+import { infoSubcommand } from "./commands/info.js";
+import { searchSubcommand } from "./commands/search.js";
+import { syncSubcommand } from "./commands/sync.js";
+if (!globalThis.c8ctl)
+    throw new Error("c8ctl runtime not initialised");
+const c8ctl = globalThis.c8ctl;
+/**
+ * Reinject flags pre-parsed by the host (#366/#367) back into the args
+ * array as `--name value` / `--name` tokens, so the plugin's hand-rolled
+ * `parseArgs` still sees them. Repeated string flags arrive as arrays.
+ */
+function injectFlagsIntoArgs(args, flags) {
+    const out = [...args];
+    if (!flags) {
+        return out;
+    }
+    for (const [name, value] of Object.entries(flags)) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (typeof value === "boolean") {
+            if (value) {
+                out.push(`--${name}`);
+            }
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item !== undefined && item !== null) {
+                    out.push(`--${name}`, String(item));
+                }
+            }
+        }
+        else {
+            out.push(`--${name}`, String(value));
+        }
+    }
+    return out;
+}
+/**
+ * Exhaustive dispatch table. The `Record<Subcommand, ...>` constraint
+ * makes adding a metadata subcommand without a matching handler a type
+ * error.
+ */
+const subcommandHandlers = {
+    search: searchSubcommand,
+    info: infoSubcommand,
+    "get-properties": getPropertiesSubcommand,
+    apply: applySubcommand,
+    get: getSubcommand,
+    sync: syncSubcommand,
+};
+function isSubcommand(name) {
+    return Object.hasOwn(subcommandHandlers, name);
+}
+async function elementTemplateHandler(args, flags) {
+    const reinjected = injectFlagsIntoArgs(args ?? [], flags);
+    const subcommand = reinjected[0];
+    const subArgs = reinjected.slice(1);
+    if (!subcommand || !isSubcommand(subcommand)) {
+        const logger = c8ctl.getLogger();
+        const lead = subcommand
+            ? `Unknown subcommand '${subcommand}'.`
+            : "c8ctl element-template requires a subcommand.";
+        const validSubcommands = Object.keys(subcommandHandlers);
+        logger.info(`${lead} Available: ${validSubcommands.join(", ")}`);
+        logger.info("Run 'c8ctl element-template --help' for full usage.");
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        await subcommandHandlers[subcommand](subArgs);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const logger = c8ctl.getLogger();
+        logger.error(`Failed to element-template ${subcommand}: ${message}`);
+        process.exitCode = 1;
+    }
+}
+// ---------------------------------------------------------------------------
+// Plugin API
+// ---------------------------------------------------------------------------
+export const metadata = {
+    name: "element-template",
+    description: "Apply, inspect, and export Camunda element templates",
+    commands: {
+        "element-template": {
+            description: "Apply, inspect, and export Camunda element templates",
+            helpDescription: "Apply Camunda element templates to BPMN elements, inspect template metadata and properties, " +
+                "search the out-of-the-box template catalogue, export raw template JSON, " +
+                "and manage the local template cache.\n\n" +
+                "<template> is a local path, an https:// URL, or an OOTB template id (optionally @<version>).\n\n" +
+                "apply --set name=value targets a property by binding name (run `get-properties` to discover names). " +
+                "Pass --set multiple times to set multiple properties. " +
+                "Prefix with a binding type (input | output | header | property | taskDefinition) when the same name " +
+                "is bound across multiple types — e.g. --set input:correlationKey=order-42.",
+            subcommands: [
+                {
+                    name: "search",
+                    description: "Search out-of-the-box element templates",
+                },
+                {
+                    name: "info",
+                    description: "Show template metadata (id, version, applies-to, description) and a pointer to get-properties",
+                },
+                {
+                    name: "get-properties",
+                    description: "List settable properties (use --detailed for full detail cards)",
+                },
+                {
+                    name: "apply",
+                    description: "Apply a Camunda element template to a BPMN element",
+                },
+                {
+                    name: "get",
+                    description: "Print the raw template JSON to stdout (pipe-friendly)",
+                },
+                {
+                    name: "sync",
+                    description: "Refresh the local OOTB element template cache",
+                },
+            ],
+            examples: [
+                {
+                    command: 'c8ctl element-template search "AWS S3"',
+                    description: "Search OOTB templates by name",
+                },
+                {
+                    command: 'c8ctl element-template search "AWS" --limit 5',
+                    description: "Cap the number of results (default 20)",
+                },
+                {
+                    command: "c8ctl element-template info io.camunda.connectors.HttpJson.v2",
+                    description: "Show the template metadata card (id, version, applies-to, engines, docs)",
+                },
+                {
+                    command: "c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2",
+                    description: "List every settable property as a condensed name + description row",
+                },
+                {
+                    command: "c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 --detailed 'authentication.*'",
+                    description: "Drill into specific properties as full detail cards (quote globs to avoid shell expansion)",
+                },
+                {
+                    command: "c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 --group authentication --group endpoint",
+                    description: "Filter to one or more group ids (use the id, not the label — group ids appear as headings in `get-properties` output)",
+                },
+                {
+                    command: "c8ctl element-template apply io.camunda.connectors.HttpJson.v2 Task_1 process.bpmn",
+                    description: "Apply an OOTB template (latest compatible with the BPMN engine version)",
+                },
+                {
+                    command: "c8ctl element-template apply io.camunda.connectors.HttpJson.v2@13 Task_1 process.bpmn",
+                    description: "Apply a specific OOTB template version",
+                },
+                {
+                    command: "c8ctl element-template apply template.json Task_1 process.bpmn",
+                    description: "Apply a template from a local file or URL",
+                },
+                {
+                    command: "c8ctl element-template apply io.camunda.connectors.HttpJson.v2 Task_1 process.bpmn --set method=POST --set url=https://api.example.com",
+                    description: "Set property values via --set name=value (one per --set; discover names via get-properties)",
+                },
+                {
+                    command: "c8ctl element-template apply io.camunda.connectors.HttpJson.v2 Task_1 process.bpmn --set authentication.type=basic --set authentication.username=alice",
+                    description: "Conditional properties: child controls (e.g. authentication.username) apply only when the gating property is also set",
+                },
+                {
+                    command: "c8ctl element-template apply io.camunda.connectors.HttpJson.v2 Task_1 process.bpmn --set input:method=POST",
+                    description: "Qualify with <binding-type>:name=value when the same name is bound across multiple types",
+                },
+                {
+                    command: "c8ctl element-template get io.camunda.connectors.HttpJson.v2 > template.json",
+                    description: "Print the raw template JSON to stdout (redirect to save a copy)",
+                },
+                {
+                    command: "c8ctl element-template get io.camunda.connectors.HttpJson.v2 --no-icon",
+                    description: "Drop the icon field (large base64 blob) for pipe-friendly output",
+                },
+                {
+                    command: "c8ctl element-template sync",
+                    description: "Refresh the local OOTB element template cache",
+                },
+            ],
+        },
+    },
+};
+export const commands = {
+    "element-template": {
+        flags: {
+            "in-place": {
+                type: "boolean",
+                short: "i",
+                description: "Modify the BPMN file in place [apply]",
+            },
+            set: {
+                type: "string",
+                multiple: true,
+                description: "Set a property value: name=value (repeatable; binding name from get-properties) [apply]",
+            },
+            detailed: {
+                type: "boolean",
+                short: "d",
+                description: "Render full detail cards instead of the condensed list [get-properties]",
+            },
+            group: {
+                type: "string",
+                multiple: true,
+                description: "Filter to one or more group ids (repeatable) [get-properties]",
+            },
+            prune: {
+                type: "boolean",
+                description: "Drop cached entries no longer in the index [sync]",
+            },
+            "no-icon": {
+                type: "boolean",
+                description: "Drop the icon field (often a large base64 blob) from the output [get]",
+            },
+            limit: {
+                type: "string",
+                description: "Cap the number of matches (default 20) [search]",
+            },
+        },
+        handler: elementTemplateHandler,
+    },
+};
+//# sourceMappingURL=c8ctl-plugin.js.map

package/dist/default-plugins/element-template/c8ctl-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"c8ctl-plugin.js","sourceRoot":"","sources":["../../../default-plugins/element-template/c8ctl-plugin.ts"],"names":[],"mappings":"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"}