c8ctl-plugin-nano 1.15.0 → 1.17.0

package/c8ctl-plugin.js

@@ -120,15 +120,6 @@ 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
@@ -459,27 +450,28 @@ function liveNodeCount(state) {
 }
 
 /**
- * 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.
+ * Compose a web-console URL for a node's base URL. Never hardcodes a port:
+ * `baseUrl` is the real address the node came up on.
+ *
+ * No longer carries a `?tour=<id>` deep link: onboarding is chosen in the
+ * console's own startup persona panel (nano-bpm #464), not sprayed across every
+ * command's output.
  */
-function webConsoleUrl(baseUrl, journey) {
-  const base = `${baseUrl}/console`;
-  return journey ? `${base}?tour=${encodeURIComponent(journey)}` : base;
+function webConsoleUrl(baseUrl) {
+  return `${baseUrl}/console`;
 }
 
 /**
- * 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.
+ * Human label for the console link, keyed on the runtime console profile.
+ * The default `studio` profile IS the full web IDE, so name it as such — users
+ * kept missing that Nano ships a browser IDE when it was labelled "Web console".
+ * `observe` is the read-only console. `off` serves no console, so the label is
+ * meaningless there; callers must guard `profile !== 'off'` before rendering it,
+ * and this helper returns null for `off` to enforce that contract.
  */
-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;
+function consoleLinkLabel(profile) {
+  if (profile === 'off') return null;
+  return profile === 'studio' ? 'Web IDE (Studio)' : `Web console (${profile})`;
 }
 
 /** Probe a node's always-on GET /v2/topology endpoint for reachability. */
@@ -809,6 +801,7 @@ async function startCluster(req) {
     inMemory,
     historyMax: historyMax ?? null,
     basePort,
+    consoleProfile,
     nodes,
   };
   writeState(state);
@@ -855,15 +848,22 @@ async function printSummary(state) {
   // The landing page (and the /docs user guide + /console) only exist in builds
   // compiled with the web console; probe so we advertise the right entry point.
   const hasConsole = await probePath(entry.url, '/');
-  if (hasConsole) {
-    console.log(`  Start here   ${entry.url}/          (landing: console, user guide & API docs)`);
+  const profile = state.consoleProfile ?? 'studio';
+  // Lead with the web IDE — it is Nano's headline surface and the thing users
+  // most often did not realise was there. Only advertise it when this build
+  // actually serves a console and the profile is not 'off'.
+  if (hasConsole && profile !== 'off') {
+    console.log(`  ${consoleLinkLabel(profile)}   ${webConsoleUrl(entry.url)}`);
+    const surface = profile === 'studio' ? 'the Nano web IDE' : 'the Nano web console';
+    console.log(`    ^ open this in your browser: ${surface}`);
+    console.log('');
   }
-  console.log(`  REST API     ${entry.url}/v2`);
-  console.log(`  Topology     ${entry.url}/v2/topology`);
   if (hasConsole) {
-    console.log(`  Web console  ${webConsoleUrl(entry.url, JOURNEY_LOCALDEV)}`);
+    console.log(`  Landing      ${entry.url}/          (console, user guide & API docs)`);
     console.log(`  User guide   ${entry.url}/docs`);
   }
+  console.log(`  REST API     ${entry.url}/v2`);
+  console.log(`  Topology     ${entry.url}/v2/topology`);
   if (state.workspaceDir) {
     console.log(`  Workspace    ${state.workspaceDir} (models/, workers/)`);
   }
@@ -1073,6 +1073,21 @@ async function statusCluster(req) {
   }
   console.log('');
 
+  // Surface the web IDE again here so it stays discoverable long after the
+  // initial `start` scrolled off — probe a healthy node so we only advertise a
+  // console that is actually served (API-only builds 404 `/`).
+  const profile = state.consoleProfile ?? 'studio';
+  if (overall !== 'stopped' && profile !== 'off') {
+    // Only probe a HEALTHY node: it already answered /v2/topology this run, so
+    // GET / returns fast. Falling back to a merely-alive (unreachable) node
+    // would add a full probe timeout to every `nano status` in a degraded state.
+    const consoleNode = checks.find((c) => c.healthy);
+    if (consoleNode && (await probePath(consoleNode.url, '/'))) {
+      console.log(`  ${consoleLinkLabel(profile)}   ${webConsoleUrl(consoleNode.url)}`);
+      console.log('');
+    }
+  }
+
   // Enrich with the live topology when reachable — the authoritative view of
   // partition leadership across the cluster.
   if (topo) {
@@ -1662,7 +1677,6 @@ 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)}`);
 }
 
 /**
@@ -2707,7 +2721,6 @@ async function workAgent(req, flags) {
   const extraNote = extraJobTypes.length > 0 ? ` (${extraJobTypes.length} via --job-type)` : '';
   logger.info(`  listening on ${jobTypes.length} job type(s)${extraNote}: ${jobTypes.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 = jobTypes.map((jobType) =>
@@ -4240,10 +4253,8 @@ export { resolveBinary, findBinary, launcherEnvMarkers };
 export { buildNpmInvocation };
 export {
   webConsoleUrl,
-  runningConsoleBaseUrl,
+  consoleLinkLabel,
   hireWorker,
-  JOURNEY_LOCALDEV,
-  JOURNEY_AGENTIC_AUTHOR,
 };
 export {
   normalizeTaskEnvelope,

package/package.json

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