c8ctl-plugin-nano 1.13.1 → 1.14.0

package/c8ctl-plugin.js

@@ -120,6 +120,15 @@ const PROCESSOS_STATE_FILE = 'processos.json';
 const PROCESSOS_DEFAULT_PORT = 8090;
 const DEFAULT_NANO_URL = 'http://localhost:8080';
 
+// Guided-journey deep links (ADR 0049 §2). The console renders a first-run tour
+// chosen by `…/console?tour=<journeyId>`, and the *command the user ran* already
+// encodes the persona — so the CLI bakes the journey into the console URL it
+// prints rather than making the console guess. These ids are a contract with the
+// console (`console/src/lib/tour`): an unknown id is silently ignored, so they
+// are asserted verbatim in the tests.
+const JOURNEY_LOCALDEV = 'localdev';
+const JOURNEY_AGENTIC_AUTHOR = 'agentic-author';
+
 // Passive update notifier (npm-style): refresh the latest published version
 // from the registry in a detached background process at most once per day, and
 // surface a one-line "update available" notice at most once per day. Never
@@ -449,6 +458,30 @@ function liveNodeCount(state) {
   return state.nodes.filter((n) => isPidAlive(n.pid)).length;
 }
 
+/**
+ * Compose a web-console URL for a node's base URL, optionally carrying a guided
+ * journey (`?tour=<id>`, ADR 0049 §2). Never hardcodes a port: `baseUrl` is the
+ * real address the node came up on.
+ */
+function webConsoleUrl(baseUrl, journey) {
+  const base = `${baseUrl}/console`;
+  return journey ? `${base}?tour=${encodeURIComponent(journey)}` : base;
+}
+
+/**
+ * Base URL of the running cluster the user would actually open: the first
+ * still-alive node, falling back to the first recorded node, then to the default
+ * gateway URL when no cluster has been started. Used by hire/work, which surface
+ * a console link for the agentic-SDLC journey.
+ */
+function runningConsoleBaseUrl(state = readState()) {
+  if (state && Array.isArray(state.nodes) && state.nodes.length > 0) {
+    const alive = state.nodes.find((n) => isPidAlive(n.pid));
+    return (alive || state.nodes[0]).url;
+  }
+  return DEFAULT_NANO_URL;
+}
+
 /** Probe a node's always-on GET /v2/topology endpoint for reachability. */
 async function probeHealthy(url) {
   const controller = new AbortController();
@@ -828,7 +861,7 @@ async function printSummary(state) {
   console.log(`  REST API     ${entry.url}/v2`);
   console.log(`  Topology     ${entry.url}/v2/topology`);
   if (hasConsole) {
-    console.log(`  Web console  ${entry.url}/console`);
+    console.log(`  Web console  ${webConsoleUrl(entry.url, JOURNEY_LOCALDEV)}`);
     console.log(`  User guide   ${entry.url}/docs`);
   }
   if (state.workspaceDir) {
@@ -1119,6 +1152,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) {
@@ -1586,6 +1633,7 @@ async function hireWorker(req, flags) {
   if (envKeys.length > 0) logger.info(`  env: ${envKeys.join(', ')}`);
   logger.info(`  job types (${matrix.length}): ${matrix.join('  ')}`);
   logger.info(`Put it to work with: c8ctl nano work ${name}`);
+  logger.info(`Open the console:    ${webConsoleUrl(runningConsoleBaseUrl(), JOURNEY_AGENTIC_AUTHOR)}`);
 }
 
 /**
@@ -2619,6 +2667,7 @@ async function workAgent(req, flags) {
   if (profileEnvKeys.length > 0) logger.info(`  harness env: ${profileEnvKeys.join(', ')}`);
   logger.info(`  listening on ${matrix.length} job type(s): ${matrix.join('  ')}`);
   logger.info(`  max parallel: ${maxParallelJobs}; job timeout: ${jobTimeoutMs}ms`);
+  logger.info(`  console: ${webConsoleUrl(runningConsoleBaseUrl(), JOURNEY_AGENTIC_AUTHOR)}`);
   logger.info('Polling for work — press Ctrl-C to stop.');
 
   const workers = matrix.map((jobType) =>
@@ -4149,6 +4198,13 @@ function parseProcessosRequest(args, flags) {
 // `metadata` and `commands`; these named exports are inert to it.
 export { resolveBinary, findBinary, launcherEnvMarkers };
 export { buildNpmInvocation };
+export {
+  webConsoleUrl,
+  runningConsoleBaseUrl,
+  hireWorker,
+  JOURNEY_LOCALDEV,
+  JOURNEY_AGENTIC_AUTHOR,
+};
 export {
   normalizeTaskEnvelope,
   collectEnvelopeFrom,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c8ctl-plugin-nano",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "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.1",
-    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.13.1",
-    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.13.1",
-    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.13.1",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.13.1",
-    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.13.1",
-    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.13.1"
+    "@nanobpm/c8ctl-plugin-nano-darwin-arm64": "1.14.0",
+    "@nanobpm/c8ctl-plugin-nano-darwin-x64": "1.14.0",
+    "@nanobpm/c8ctl-plugin-nano-linux-x64": "1.14.0",
+    "@nanobpm/c8ctl-plugin-nano-linux-arm64": "1.14.0",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv7": "1.14.0",
+    "@nanobpm/c8ctl-plugin-nano-linux-armv6": "1.14.0",
+    "@nanobpm/c8ctl-plugin-nano-win32-x64": "1.14.0"
   }
 }