c8ctl-plugin-nano 1.13.0 → 1.13.2

package/README.md

@@ -79,12 +79,13 @@ c8ctl nano status
 # Inspect a cluster c8ctl did NOT start (queries /v2/topology on the given port)
 c8ctl nano status --port 8080
 
-# Tail a node's log (-f / --follow to stream)
-c8ctl nano logs 1 --follow
+# Tail a node's log (-f / --follow to stream). Node ids are 0-indexed,
+# so a single-node cluster is node 0.
+c8ctl nano logs 0 --follow
 
 # Simulate a node failing (freeze it) and recovering (resume it)
-c8ctl nano pause 1
-c8ctl nano resume 1
+c8ctl nano pause 0
+c8ctl nano resume 0
 
 # Stop the cluster (engine data is retained)
 c8ctl nano stop

package/c8ctl-plugin.js

@@ -1119,6 +1119,20 @@ function logsCluster(req) {
 
 function controlNode(req, { signal, verb, paused }) {
   const logger = getLogger();
+
+  // pause/resume rely on SIGSTOP/SIGCONT, which are POSIX-only. On Windows
+  // Node throws "Unknown signal: SIGSTOP" from process.kill, so fail fast with
+  // a clear message instead of a raw crash (see nano-bpm#390).
+  if (process.platform === 'win32') {
+    logger.error(
+      `"c8ctl nano ${verb}" isn't supported on Windows yet — it relies on ` +
+        `SIGSTOP/SIGCONT, which Windows doesn't have. To simulate a node ` +
+        `failing and recovering, use "c8ctl nano stop <id>" then ` +
+        `"c8ctl nano start" instead.`,
+    );
+    process.exit(1);
+  }
+
   const state = readState();
 
   if (!state || !Array.isArray(state.nodes) || state.nodes.length === 0) {
@@ -1127,16 +1141,17 @@ function controlNode(req, { signal, verb, paused }) {
   }
 
   const nodeIds = state.nodes.map((n) => n.id).join(', ');
+  const exampleId = state.nodes[0].id;
   const idArg = req.positional[0];
   if (idArg === undefined) {
-    logger.error(`Specify a node id, e.g. "c8ctl nano ${verb} 1". Nodes: ${nodeIds}`);
+    logger.error(`Specify a node id, e.g. "c8ctl nano ${verb} ${exampleId}". Running nodes: [${nodeIds}]`);
     process.exit(1);
   }
 
   const id = Number.parseInt(idArg, 10);
   const node = Number.isFinite(id) ? state.nodes.find((n) => n.id === id) : undefined;
   if (!node) {
-    logger.error(`No node "${idArg}" in the running cluster. Nodes: ${nodeIds}`);
+    logger.error(`No node "${idArg}" in the running cluster. Running nodes: [${nodeIds}]`);
     process.exit(1);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c8ctl-plugin-nano",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "type": "module",
   "description": "c8ctl plugin to start, inspect, and stop a local Nano BPM (nanobpmn) cluster",
   "main": "c8ctl-plugin.js",
@@ -49,12 +49,12 @@
     "semantic-release": "^25.0.3"
   },
   "optionalDependencies": {
-    "@nanobpm/c8ctl-plugin-nano-darwin-arm64": "1.13.0",
-    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.13.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.13.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.13.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.13.0",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.13.0",
-    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.13.0"
+    "@nanobpm/c8ctl-plugin-nano-darwin-arm64": "1.13.2",
+    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.13.2",
+    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.13.2",
+    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.13.2",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.13.2",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.13.2",
+    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.13.2"
   }
 }