c8ctl-plugin-nano 1.16.0 → 1.17.0

package/c8ctl-plugin.js

@@ -461,6 +461,19 @@ function webConsoleUrl(baseUrl) {
   return `${baseUrl}/console`;
 }
 
+/**
+ * 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 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. */
 async function probeHealthy(url) {
   const controller = new AbortController();
@@ -788,6 +801,7 @@ async function startCluster(req) {
     inMemory,
     historyMax: historyMax ?? null,
     basePort,
+    consoleProfile,
     nodes,
   };
   writeState(state);
@@ -834,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)}`);
+    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/)`);
   }
@@ -1052,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) {
@@ -4217,6 +4253,7 @@ export { resolveBinary, findBinary, launcherEnvMarkers };
 export { buildNpmInvocation };
 export {
   webConsoleUrl,
+  consoleLinkLabel,
   hireWorker,
 };
 export {

package/package.json

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