@camunda8/cli 3.1.0 → 3.2.0-alpha.10

package/dist/default-plugins/bpmn/package.json

@@ -4,5 +4,12 @@
   "type": "module",
   "description": "c8ctl plugin to lint BPMN diagrams against recommended and Camunda rules",
   "keywords": ["c8ctl", "c8ctl-plugin", "bpmn", "lint"],
-  "main": "c8ctl-plugin.ts"
+  "main": "c8ctl-plugin.ts",
+  "dependencies": {
+    "@bpmn-io/moddle-utils": "^0.3.0",
+    "bpmn-moddle": "^9.0.1",
+    "bpmnlint": "^11.6.1",
+    "bpmnlint-plugin-camunda-compat": "^2.43.1",
+    "zeebe-bpmn-moddle": "^1.11.0"
+  }
 }

package/dist/default-plugins/cluster/c8ctl-plugin.js

@@ -57,6 +57,36 @@ export function isRollingVersion(versionSpec) {
   return isVersionAlias(versionSpec) || isMinorVersionPattern(versionSpec);
 }
 
+/**
+ * Extract the leading major.minor pair from a version string.
+ * Accepts minor patterns ("8.10") and concrete versions ("8.10.0-alpha1").
+ * Returns { major, minor } or null if the string has no major.minor prefix.
+ */
+export function majorMinorOf(version) {
+  const match = /^(\d+)\.(\d+)/.exec(version);
+  if (!match) return null;
+  return { major: Number(match[1]), minor: Number(match[2]) };
+}
+
+/**
+ * True when the remote alias target is a strictly newer minor line than the
+ * locally resolved version. The remote alias always resolves to a major.minor
+ * pattern (e.g. "8.10"), whereas the resolved version may be a concrete pin
+ * (e.g. "8.10.0-alpha1") within that same minor line. Comparing the raw
+ * strings produces false positives (#434): "8.10" !== "8.10.0-alpha1" even
+ * though no newer release exists. Compare at the major.minor level instead.
+ */
+export function isRemoteMinorNewer(remoteVersion, resolvedVersion) {
+  const remote = majorMinorOf(remoteVersion);
+  const resolved = majorMinorOf(resolvedVersion);
+  // If either side is unparseable, fall back to the previous behavior (string inequality).
+  if (!remote || !resolved) return remoteVersion !== resolvedVersion;
+  return (
+    remote.major > resolved.major ||
+    (remote.major === resolved.major && remote.minor > resolved.minor)
+  );
+}
+
 /**
  * Fetch the c8run download directory listing and discover the latest
  * stable and alpha minor versions.
@@ -172,7 +202,23 @@ function readLocalAliasMapping(cacheDir, alias) {
     const value = readFileSync(filePath, 'utf-8').trim();
     // Only use the cached mapping if the version is actually installed
     const config = { cacheDir, version: value };
-    return isC8RunInstalled(config) ? value : null;
+    if (isC8RunInstalled(config)) return value;
+
+    // For rolling versions (minor version patterns like "8.9"), check if any
+    // installed version matches the minor version prefix (e.g. "8.9" matches
+    // "8.9.5"). This prevents re-downloading a rolling alias when a compatible
+    // pinned version is already installed locally (#431).
+    if (isMinorVersionPattern(value)) {
+      const installedVersions = getInstalledVersionsList(cacheDir)
+        .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
+      const match = installedVersions
+        .filter((v) => v.startsWith(value + '.'))
+        .reverse()
+        .find((v) => isC8RunInstalled({ cacheDir, version: v }));
+      if (match) return match;
+    }
+
+    return null;
   } catch {
     return null;
   }
@@ -228,7 +274,7 @@ export function checkBackgroundAliasFreshness(versionSpec, resolvedVersion) {
         if (html) {
           const remote = parseVersionsFromHtml(html);
           const remoteVersion = remote?.[versionSpec];
-          if (remoteVersion && remoteVersion !== resolvedVersion) {
+          if (remoteVersion && isRemoteMinorNewer(remoteVersion, resolvedVersion)) {
             logger.info(
               `A newer "${versionSpec}" release is available (${remoteVersion}). ` +
               `Install it with: c8ctl cluster install ${versionSpec}`,
@@ -806,15 +852,26 @@ async function startC8Run(config, debug = false) {
   const versionFile = join(config.cacheDir, VERSION_MARKER_FILE);
 
   if (existsSync(markerFile)) {
-    logger.warn('A cluster appears to be running already.');
-    if (existsSync(versionFile)) {
-      const runningVersion = readFileSync(versionFile, 'utf-8').trim();
-      if (runningVersion) {
-        logger.info(`Detected running version marker: ${runningVersion}`);
+    // Check whether actual cluster processes are still alive.
+    // If they are, refuse to start a second instance.
+    // If not, the marker is stale (e.g. crash, WSL restart, force-kill)
+    // — clean it up automatically and proceed with the start.
+    if (hasRunningClusterPidfiles(config.cacheDir)) {
+      logger.warn('A cluster appears to be running already.');
+      if (existsSync(versionFile)) {
+        const runningVersion = readFileSync(versionFile, 'utf-8').trim();
+        if (runningVersion) {
+          logger.info(`Detected running version marker: ${runningVersion}`);
+        }
       }
+      logger.info('Use "c8ctl cluster stop" to stop it first.');
+      return;
     }
-    logger.info('Use "c8ctl cluster stop" to stop it first.');
-    return;
+
+    // Stale marker — no live processes found. Clean up and continue.
+    logger.warn('Found stale cluster marker (no running processes detected). Cleaning up.');
+    if (existsSync(markerFile)) rmSync(markerFile);
+    if (existsSync(versionFile)) rmSync(versionFile);
   }
 
   logger.info('Starting Camunda 8 local cluster...');

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

@@ -12,9 +12,9 @@ The verb is organized as a workflow: discover → inspect → act → export →
 
 | 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. |
+| `search <query>` | Find OOTB templates by keyword (deprecated entries hidden). `--engine-version` narrows to compatible versions. |
+| `info <template>` | Show the template metadata card (id, version, applies-to, engines, docs). `--engine-version` resolves the latest compatible version. |
+| `get-properties <template> [<name>...]` | List settable properties — condensed by default, `--detailed` for full cards. `--engine-version` resolves the latest compatible version. |
 | `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` | Populate / refresh the local OOTB template cache. **Run this once before any other OOTB subcommand.** |
@@ -36,12 +36,15 @@ auto-rewritten to raw content URLs — paste straight from the address bar.
 c8ctl element-template search "AWS S3"
 c8ctl element-template search "http"
 c8ctl element-template search "AWS" --limit 5      # cap results (default 20)
+c8ctl element-template search "http" --engine-version 8.8.0
 
 # Show the template metadata card
 c8ctl element-template info io.camunda.connectors.HttpJson.v2
+c8ctl element-template info io.camunda.connectors.HttpJson.v2 --engine-version 8.8
 
 # List every settable property as a condensed name + description row
 c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2
+c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 --engine-version 8.8.0
 
 # Filter by name (positional, supports shell-style globs — quote them)
 c8ctl element-template get-properties io.camunda.connectors.HttpJson.v2 url method